Last active
June 25, 2026 21:45
-
-
Save heyalexej/86579e91d321f10cae0a9875a07a2fa8 to your computer and use it in GitHub Desktop.
PydanticAI feature parity comparison: TypeScript and Go alternatives
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <!doctype html> | |
| <html lang="en"> | |
| <head> | |
| <meta charset="utf-8"> | |
| <meta name="viewport" content="width=device-width, initial-scale=1"> | |
| <title>PydanticAI Feature Parity: TypeScript and Go Alternatives</title> | |
| <style> | |
| :root { | |
| color-scheme: light; | |
| --bg: #f5f7fa; | |
| --panel: #ffffff; | |
| --ink: #17202a; | |
| --muted: #596575; | |
| --line: #d8dee8; | |
| --line-strong: #b6c1ce; | |
| --accent: #155e75; | |
| --accent-soft: #e5f4f7; | |
| --green: #116329; | |
| --green-bg: #e8f6ed; | |
| --blue: #174ea6; | |
| --blue-bg: #eaf1fb; | |
| --amber: #8a5a00; | |
| --amber-bg: #fff5d7; | |
| --red: #9b1c1c; | |
| --red-bg: #fde8e8; | |
| --gray-bg: #edf1f5; | |
| --shadow: 0 10px 35px rgba(23, 32, 42, 0.08); | |
| } | |
| * { box-sizing: border-box; } | |
| html { | |
| background: var(--bg); | |
| color: var(--ink); | |
| font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; | |
| line-height: 1.45; | |
| } | |
| body { margin: 0; } | |
| main { | |
| width: min(1680px, calc(100vw - 32px)); | |
| margin: 0 auto; | |
| padding: 32px 0 56px; | |
| } | |
| header, section { | |
| background: var(--panel); | |
| border: 1px solid var(--line); | |
| box-shadow: var(--shadow); | |
| } | |
| header { | |
| padding: 28px; | |
| margin-bottom: 18px; | |
| } | |
| section { | |
| padding: 22px; | |
| margin: 18px 0; | |
| } | |
| h1 { | |
| margin: 0 0 10px; | |
| font-size: clamp(28px, 4vw, 46px); | |
| line-height: 1.08; | |
| letter-spacing: 0; | |
| } | |
| h2 { | |
| margin: 0 0 14px; | |
| font-size: 24px; | |
| line-height: 1.2; | |
| letter-spacing: 0; | |
| } | |
| h3 { | |
| margin: 0 0 8px; | |
| font-size: 18px; | |
| letter-spacing: 0; | |
| } | |
| p { margin: 0 0 12px; color: var(--muted); } | |
| a { | |
| color: var(--accent); | |
| text-decoration-thickness: 1px; | |
| text-underline-offset: 3px; | |
| } | |
| .meta { | |
| display: flex; | |
| flex-wrap: wrap; | |
| gap: 8px; | |
| margin-top: 16px; | |
| } | |
| .pill { | |
| display: inline-flex; | |
| align-items: center; | |
| border: 1px solid var(--line); | |
| background: var(--gray-bg); | |
| color: #374151; | |
| font-size: 13px; | |
| font-weight: 650; | |
| padding: 6px 10px; | |
| white-space: nowrap; | |
| } | |
| .note { | |
| background: var(--accent-soft); | |
| border: 1px solid #b8dfe7; | |
| color: #17414b; | |
| padding: 14px 16px; | |
| margin: 18px 0 0; | |
| } | |
| .grid { | |
| display: grid; | |
| grid-template-columns: repeat(2, minmax(0, 1fr)); | |
| gap: 14px; | |
| } | |
| .box { | |
| border: 1px solid var(--line); | |
| background: #fbfcfd; | |
| padding: 16px; | |
| } | |
| .table-wrap { | |
| overflow-x: auto; | |
| border: 1px solid var(--line); | |
| background: #fff; | |
| } | |
| table { | |
| border-collapse: collapse; | |
| width: 100%; | |
| min-width: 1120px; | |
| } | |
| caption { | |
| text-align: left; | |
| color: var(--muted); | |
| font-size: 13px; | |
| padding: 10px 12px; | |
| border-bottom: 1px solid var(--line); | |
| background: #fbfcfd; | |
| } | |
| th, td { | |
| border-right: 1px solid var(--line); | |
| border-bottom: 1px solid var(--line); | |
| padding: 12px; | |
| vertical-align: top; | |
| text-align: left; | |
| } | |
| th:last-child, td:last-child { border-right: 0; } | |
| tr:last-child td { border-bottom: 0; } | |
| thead th { | |
| position: sticky; | |
| top: 0; | |
| z-index: 1; | |
| background: #eef3f7; | |
| border-bottom: 1px solid var(--line-strong); | |
| color: #1f2937; | |
| font-size: 13px; | |
| text-transform: uppercase; | |
| letter-spacing: 0.04em; | |
| } | |
| tbody th { | |
| width: 230px; | |
| background: #fbfcfd; | |
| font-weight: 760; | |
| } | |
| td { | |
| color: #25313d; | |
| font-size: 14px; | |
| } | |
| .small { color: var(--muted); font-size: 12px; } | |
| .num { | |
| text-align: right; | |
| font-variant-numeric: tabular-nums; | |
| white-space: nowrap; | |
| } | |
| .score { | |
| display: inline-block; | |
| font-size: 12px; | |
| font-weight: 760; | |
| padding: 3px 7px; | |
| margin-bottom: 6px; | |
| border: 1px solid transparent; | |
| } | |
| .excellent { color: var(--green); background: var(--green-bg); border-color: #b7e0c0; } | |
| .strong { color: var(--blue); background: var(--blue-bg); border-color: #c8d8f4; } | |
| .medium { color: var(--amber); background: var(--amber-bg); border-color: #f1d083; } | |
| .weak { color: var(--red); background: var(--red-bg); border-color: #f5b5b5; } | |
| .repo, .path { | |
| font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace; | |
| font-size: 12px; | |
| color: #3b4652; | |
| background: #eef1f5; | |
| padding: 2px 5px; | |
| } | |
| .stars, .verdict { font-weight: 760; color: var(--ink); } | |
| details { | |
| border: 1px solid var(--line); | |
| background: #fbfcfd; | |
| margin: 12px 0; | |
| } | |
| summary { | |
| cursor: pointer; | |
| padding: 11px 12px; | |
| font-weight: 760; | |
| border-bottom: 1px solid var(--line); | |
| } | |
| pre { | |
| margin: 0; | |
| padding: 14px; | |
| overflow-x: auto; | |
| background: #0f1720; | |
| color: #e6edf3; | |
| font-size: 12px; | |
| line-height: 1.48; | |
| } | |
| code { | |
| font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace; | |
| } | |
| pre code { | |
| white-space: pre; | |
| } | |
| .tok-comment { color: #8b949e; font-style: italic; } | |
| .tok-string { color: #a5d6ff; } | |
| .tok-key { color: #79c0ff; } | |
| .tok-keyword { color: #ff7b72; } | |
| .tok-literal { color: #79c0ff; } | |
| .tok-number { color: #d2a8ff; } | |
| .tok-function { color: #d2a8ff; } | |
| @media (max-width: 900px) { | |
| main { width: min(100vw - 20px, 1680px); padding-top: 14px; } | |
| header, section { padding: 16px; } | |
| .grid { grid-template-columns: 1fr; } | |
| } | |
| </style> | |
| </head> | |
| <body> | |
| <main> | |
| <header> | |
| <h1>PydanticAI Feature Parity: TypeScript and Go Alternatives</h1> | |
| <p> | |
| PydanticAI is the baseline. This report compares the strongest TypeScript/JavaScript and Go alternatives | |
| that can work with multiple LLM providers instead of being tied to a single vendor. | |
| </p> | |
| <div class="meta"> | |
| <span class="pill">As of June 25, 2026</span> | |
| <span class="pill">No Tailwind CSS</span> | |
| <span class="pill">Standalone HTML</span> | |
| <span class="pill">Self-contained syntax highlighting</span> | |
| <span class="pill">Includes live Gemini 2.5 Flash runs</span> | |
| <span class="pill">Includes Vercel AI SDK test</span> | |
| <span class="pill">Go toolchain: go1.26.4</span> | |
| </div> | |
| <div class="note"> | |
| GitHub Gist does not render arbitrary HTML directly in the normal Gist page; it shows the source. | |
| For a full-size rendered view, open the raw file through an HTML preview service or download/open the HTML locally. | |
| </div> | |
| </header> | |
| <section> | |
| <h2>Short Ranking Per Language</h2> | |
| <div class="table-wrap"> | |
| <table> | |
| <caption>Top 2 per language, ranked by closeness to PydanticAI as an agent framework, not by stars alone.</caption> | |
| <thead> | |
| <tr> | |
| <th>Language</th> | |
| <th>Rank 1</th> | |
| <th>Why Rank 1</th> | |
| <th>Rank 2</th> | |
| <th>Why Rank 2</th> | |
| </tr> | |
| </thead> | |
| <tbody> | |
| <tr> | |
| <th>TypeScript / JavaScript</th> | |
| <td> | |
| <span class="verdict">Mastra</span><br> | |
| <span class="repo">mastra-ai/mastra</span><br> | |
| <span class="stars">25,455 stars</span> | |
| </td> | |
| <td> | |
| Closest to PydanticAI as a complete productivity framework: agents, tools, workflows, memory, | |
| MCP, evals, observability, model routing and human approval are designed together. | |
| </td> | |
| <td> | |
| <span class="verdict">LangChain.js + LangGraph.js</span><br> | |
| <span class="repo">langchain-ai/langchainjs</span> / <span class="repo">langchain-ai/langgraphjs</span><br> | |
| <span class="stars">17,851 + 3,043 stars</span> | |
| </td> | |
| <td> | |
| Strongest choice for controllable, long-running agent workflows. LangGraph is especially strong | |
| for state, checkpointing, human-in-the-loop and multi-agent orchestration. | |
| </td> | |
| </tr> | |
| <tr> | |
| <th>Go</th> | |
| <td> | |
| <span class="verdict">Eino</span><br> | |
| <span class="repo">cloudwego/eino</span><br> | |
| <span class="stars">11,970 stars</span> | |
| </td> | |
| <td> | |
| Best Go-native agent candidate: ADK, ReAct agents, DeepAgent, multi-agent patterns, | |
| graph/workflow composition, streaming and interrupt/resume. | |
| </td> | |
| <td> | |
| <span class="verdict">Genkit Go</span><br> | |
| <span class="repo">genkit-ai/genkit</span><br> | |
| <span class="stars">6,139 stars</span> | |
| </td> | |
| <td> | |
| Best Go choice for typed structured output, typed flows, tools, tracing, Dev UI and | |
| cross-language parity with TypeScript. | |
| </td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| </div> | |
| </section> | |
| <section> | |
| <h2>Feature Parity Matrix</h2> | |
| <div class="table-wrap"> | |
| <table> | |
| <caption> | |
| Rating logic: excellent = very close to or stronger than PydanticAI in this area, | |
| strong = production-usable, medium = present with gaps, weak = not a core strength. | |
| </caption> | |
| <thead> | |
| <tr> | |
| <th>Feature</th> | |
| <th>PydanticAI Baseline</th> | |
| <th>Mastra TS</th> | |
| <th>LangChain.js + LangGraph.js</th> | |
| <th>Eino Go</th> | |
| <th>Genkit Go</th> | |
| </tr> | |
| </thead> | |
| <tbody> | |
| <tr> | |
| <th>Multi-provider LLMs</th> | |
| <td><span class="score excellent">Excellent</span><br>OpenAI, Anthropic, Gemini, Bedrock, Groq, Mistral, OpenRouter, Ollama, LiteLLM and OpenAI-compatible providers.</td> | |
| <td><span class="score excellent">Excellent</span><br>Model router with broad provider coverage and gateway options.</td> | |
| <td><span class="score excellent">Excellent</span><br>Large LangChain integration ecosystem plus universal chat model initialization.</td> | |
| <td><span class="score strong">Strong</span><br>ChatModel, Tool and Retriever abstractions; provider implementations mainly through EinoExt.</td> | |
| <td><span class="score strong">Strong</span><br>Plugin model for Google, OpenAI, Anthropic, Ollama and others.</td> | |
| </tr> | |
| <tr> | |
| <th>Agent loop</th> | |
| <td><span class="score excellent">Excellent</span><br>Agent is the central API with typed deps/output, tools, streaming and multiple run modes.</td> | |
| <td><span class="score strong">Strong</span><br>Agents iterate internally over tool calls until a final response.</td> | |
| <td><span class="score strong">Strong</span><br>CreateReactAgent and graph agents; very flexible, but less compact.</td> | |
| <td><span class="score strong">Strong</span><br>ChatModelAgent, DeepAgent, Supervisor and ADK are Go-native.</td> | |
| <td><span class="score medium">Medium</span><br>Agent API exists, but Go-side usage is often flow/action-oriented.</td> | |
| </tr> | |
| <tr> | |
| <th>Structured output</th> | |
| <td><span class="score excellent">Excellent</span><br>Pydantic output types, unions, validators and retry on validation.</td> | |
| <td><span class="score strong">Strong</span><br>Zod, Valibot, ArkType and JSON Schema; structured output is easy to request.</td> | |
| <td><span class="score medium">Medium</span><br>Zod structured output works, but multimodal Gemini returned valid JSON while parser behavior varied between runs.</td> | |
| <td><span class="score medium">Medium</span><br>Go structs and JSON schema are possible, but less integrated than PydanticAI output types.</td> | |
| <td><span class="score strong">Strong</span><br>Go structs with JSON tags and GenerateData[T] map well to PydanticAI-style structured output.</td> | |
| </tr> | |
| <tr> | |
| <th>Tools and tool schemas</th> | |
| <td><span class="score excellent">Excellent</span><br>Decorator tools, plain tools, toolsets, MCP toolsets and Pydantic validation.</td> | |
| <td><span class="score strong">Strong</span><br>createTool with input/output schema; tools can also be agents/workflows.</td> | |
| <td><span class="score strong">Strong</span><br>tool() with Zod schema, ToolNode and many integrations.</td> | |
| <td><span class="score strong">Strong</span><br>BaseTool, ToolsNode, graphs as tools and ADK integration.</td> | |
| <td><span class="score strong">Strong</span><br>DefineTool, typed input/output structs and tool calling in Generate API.</td> | |
| </tr> | |
| <tr> | |
| <th>Typed dependencies / runtime context</th> | |
| <td><span class="score excellent">Excellent</span><br>deps_type and RunContext[T] are a core advantage.</td> | |
| <td><span class="score medium">Medium</span><br>RequestContext and tool context are useful, but less tightly typed.</td> | |
| <td><span class="score medium">Medium</span><br>Config, state and runtime args work, but are less ergonomic as typed dependencies.</td> | |
| <td><span class="score medium">Medium</span><br>Go context and config types; no direct PydanticAI analogue.</td> | |
| <td><span class="score strong">Strong</span><br>context.Context, typed structs and registry/action pattern; strong, but different.</td> | |
| </tr> | |
| <tr> | |
| <th>Streaming</th> | |
| <td><span class="score excellent">Excellent</span><br>Text, events and structured output can be streamed.</td> | |
| <td><span class="score strong">Strong</span><br>stream(), textStream, fullStream and object chunks.</td> | |
| <td><span class="score excellent">Excellent</span><br>Stream modes for updates, messages, custom data and combinations.</td> | |
| <td><span class="score excellent">Excellent</span><br>Streaming is central to the compose system.</td> | |
| <td><span class="score strong">Strong</span><br>GenerateStream, bidirectional agent streams and Dev UI tracing.</td> | |
| </tr> | |
| <tr> | |
| <th>Durable / resumable execution</th> | |
| <td><span class="score strong">Strong</span><br>Official integrations with Temporal, DBOS, Prefect and Restate.</td> | |
| <td><span class="score strong">Strong</span><br>Durable Agents, PubSub, cache and Inngest; some parts are beta.</td> | |
| <td><span class="score excellent">Excellent</span><br>Checkpointers, threads, replay, updateState, persistence and LangGraph Platform.</td> | |
| <td><span class="score strong">Strong</span><br>Checkpoint-based resume in ADK/TurnLoop.</td> | |
| <td><span class="score medium">Medium</span><br>Snapshot/session persistence in Agent API; less mature than LangGraph.</td> | |
| </tr> | |
| <tr> | |
| <th>Human-in-the-loop</th> | |
| <td><span class="score strong">Strong</span><br>Deferred tools, approval and durable workflows.</td> | |
| <td><span class="score strong">Strong</span><br>Tool approval, suspend/resume and workflow HITL.</td> | |
| <td><span class="score excellent">Excellent</span><br>interrupt() can wait indefinitely and resume later.</td> | |
| <td><span class="score strong">Strong</span><br>Interrupt/resume for agents and tools.</td> | |
| <td><span class="score medium">Medium</span><br>Interrupts and restartable tools exist, but API maturity varies.</td> | |
| </tr> | |
| <tr> | |
| <th>Graphs / workflows</th> | |
| <td><span class="score strong">Strong</span><br>pydantic-graph for more complex control flow.</td> | |
| <td><span class="score strong">Strong</span><br>Workflow engine with branches, parallelism and suspend/resume.</td> | |
| <td><span class="score excellent">Excellent</span><br>LangGraph is likely the strongest graph orchestration option in TypeScript.</td> | |
| <td><span class="score strong">Strong</span><br>Compose graphs/workflows are a core feature.</td> | |
| <td><span class="score strong">Strong</span><br>Typed flows, registry, Dev UI and tracing.</td> | |
| </tr> | |
| <tr> | |
| <th>Memory</th> | |
| <td><span class="score medium">Medium</span><br>Message history in core; more advanced memory via harnesses/patterns.</td> | |
| <td><span class="score strong">Strong</span><br>Message history, working memory, semantic recall and observational memory.</td> | |
| <td><span class="score strong">Strong</span><br>Short-term via checkpointer, long-term via store.</td> | |
| <td><span class="score medium">Medium</span><br>Context management and middleware exist, but less productized.</td> | |
| <td><span class="score medium">Medium</span><br>Persisted chat/session interfaces exist, less agent-memory-centric.</td> | |
| </tr> | |
| <tr> | |
| <th>MCP</th> | |
| <td><span class="score excellent">Excellent</span><br>MCP client, server and capability integration with local fallback.</td> | |
| <td><span class="score strong">Strong</span><br>MCPClient and MCPServer; agents, tools and workflows can be exposed.</td> | |
| <td><span class="score strong">Strong</span><br>MCP tools via @langchain/mcp-adapters; server is not the core feature.</td> | |
| <td><span class="score medium">Medium</span><br>Not as central in docs as PydanticAI/Mastra/Genkit.</td> | |
| <td><span class="score strong">Strong</span><br>MCP plugin and samples are available.</td> | |
| </tr> | |
| <tr> | |
| <th>Evals</th> | |
| <td><span class="score excellent">Excellent</span><br>pydantic-evals, datasets, cases, LLM judges and span-based evals.</td> | |
| <td><span class="score strong">Strong</span><br>@mastra/evals, scorers, live evals and trace scoring.</td> | |
| <td><span class="score strong">Strong</span><br>LangSmith plus AgentEvals for trajectory and LLM-as-judge.</td> | |
| <td><span class="score medium">Medium</span><br>Evals are more ecosystem-driven than integrated.</td> | |
| <td><span class="score strong">Strong</span><br>CLI/Dev UI can evaluate flows; evaluator plugins exist.</td> | |
| </tr> | |
| <tr> | |
| <th>Observability</th> | |
| <td><span class="score excellent">Excellent</span><br>Logfire and OpenTelemetry, model/tool spans, cost/usage.</td> | |
| <td><span class="score strong">Strong</span><br>Tracing, logs, metrics, Studio and external OTel integrations.</td> | |
| <td><span class="score strong">Strong</span><br>LangSmith is mature, but more platform-coupled.</td> | |
| <td><span class="score medium">Medium</span><br>Callbacks for logging/tracing/metrics; DevOps via extra packages.</td> | |
| <td><span class="score strong">Strong</span><br>Dev UI, traces, CLI and monitoring story are present.</td> | |
| </tr> | |
| <tr> | |
| <th>Testing / mocking</th> | |
| <td><span class="score excellent">Excellent</span><br>TestModel, FunctionModel and typed eval/test patterns.</td> | |
| <td><span class="score medium">Medium</span><br>Testable, but no equally clear TestModel analogue.</td> | |
| <td><span class="score medium">Medium</span><br>Possible through LangChain abstractions, but more setup.</td> | |
| <td><span class="score medium">Medium</span><br>Go tests and mocks in repo; fewer batteries included for app tests.</td> | |
| <td><span class="score strong">Strong</span><br>Registry, actions, fake embedder/model patterns and conformance tests.</td> | |
| </tr> | |
| <tr> | |
| <th>PydanticAI similarity</th> | |
| <td><span class="score excellent">Reference</span><br>Type-first, validation-first, compact Agent API.</td> | |
| <td><span class="score strong">Strong</span><br>Best TypeScript similarity as a full framework.</td> | |
| <td><span class="score medium">Medium</span><br>More orchestration platform than type-first Agent API.</td> | |
| <td><span class="score medium">Medium</span><br>Very agentic, but Go-idiomatic and less output-type-first.</td> | |
| <td><span class="score strong">Strong</span><br>Very close for typed structured data, less close for autonomous agents.</td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| </div> | |
| </section> | |
| <section> | |
| <h2>Live eBay Listing Experiment</h2> | |
| <p> | |
| Each tested library used Gemini 2.5 Flash against the real API, all 15 eBay mixer images, | |
| and the same factual seller prompt. The image input was upgraded from the 400x400 JSON URLs to | |
| the higher-resolution eBay pattern <span class="repo">https://i.ebayimg.com/images/g/<id>/s-l1600.webp</span>. | |
| The loaders accept jpg, jpeg, webp and png; this run used WebP because all 15 derived URLs returned HTTP 200. | |
| Vercel AI SDK is included here as an additional SDK-style live test, not as a new Top 2 framework candidate. | |
| </p> | |
| <div class="table-wrap"> | |
| <table> | |
| <caption>Real outputs from the four scripts. Token fields are reported by each framework/provider path.</caption> | |
| <thead> | |
| <tr> | |
| <th>Library</th> | |
| <th>Model</th> | |
| <th>SEO Title</th> | |
| <th>Description</th> | |
| <th>Input Tokens</th> | |
| <th>Output Tokens</th> | |
| <th>Total Tokens</th> | |
| <th>Omitted Uncertain Claims</th> | |
| </tr> | |
| </thead> | |
| <tbody> | |
| <tr> | |
| <th>Mastra TypeScript</th> | |
| <td>google/gemini-2.5-flash</td> | |
| <td>Sound City Multi Function Stereo Audio Mixer 4-Channel Portable Battery Powered<br><span class="small">79 characters</span></td> | |
| <td>The Sound City Multi Function Stereo Audio Mixer is a 4-channel portable unit featuring two integrated VU meters. It includes multiple RCA stereo inputs, a 1/4 inch microphone input, and both RCA and 1/4 inch master outputs. The unit is designed for battery operation and is offered in untested as-found condition.</td> | |
| <td class="num">4502</td> | |
| <td class="num">3641</td> | |
| <td class="num">8143</td> | |
| <td>Vintage, Retro, DJ, Excellent condition, Rare, Professional</td> | |
| </tr> | |
| <tr> | |
| <th>LangChain.js + LangGraph.js TypeScript</th> | |
| <td>gemini-2.5-flash</td> | |
| <td>Sound City Multi Function Stereo Audio Mixer Portable 4 Channel Battery Operated<br><span class="small">80 characters</span></td> | |
| <td>The Sound City Multi Function Stereo Audio Mixer is a portable, battery-operated unit. It features 4 channels, 4 phono inputs, 8 line inputs, and 1 microphone input. Connections include analog RCA/coaxial inputs and outputs, along with 1/4" TS and TRS jacks.</td> | |
| <td class="num">4503</td> | |
| <td class="num">388</td> | |
| <td class="num">5880</td> | |
| <td>Vintage, Retro, DJ, Excellent condition, Rare, Professional, Suitable for Homerecording, Suitable for Studio/Recording</td> | |
| </tr> | |
| <tr> | |
| <th>Vercel AI SDK TypeScript</th> | |
| <td>google/gemini-2.5-flash</td> | |
| <td>Sound City Multi Function Stereo Audio Mixer Portable 4-Channel Battery Operated<br><span class="small">80 characters</span></td> | |
| <td>The Sound City Multi Function Stereo Audio Mixer is a portable, 4-channel unit. It features multiple RCA and 1/4" TS/TRS input/output connections, visible VU meters, and is battery operated. The mixer weighs 1562 grams and is suitable for homerecording or studio/recording use.</td> | |
| <td class="num">4502</td> | |
| <td class="num">2081</td> | |
| <td class="num">6583</td> | |
| <td>Vintage, Retro, DJ, Excellent, Rare, Professional, Ungeprüftem Auffindungszustand (untested condition)</td> | |
| </tr> | |
| <tr> | |
| <th>Eino Go</th> | |
| <td>gemini-2.5-flash</td> | |
| <td>Sound City Multi Function Stereo Audio Mixer 4 Channel Portable<br><span class="small">63 characters</span></td> | |
| <td>The Sound City Multi Function Stereo Audio Mixer is a 4-channel portable mixing console. It features two VU meters, five faders, and a panpot control. Connectivity includes multiple RCA inputs and outputs, a 1/4" microphone input, and a 1/4" master output. The unit is battery-operated and weighs 1562 grams.</td> | |
| <td class="num">4504</td> | |
| <td class="num">1805</td> | |
| <td class="num">6309</td> | |
| <td>DJ mixer, Vintage, Retro, Excellent condition, Compact</td> | |
| </tr> | |
| <tr> | |
| <th>Genkit Go</th> | |
| <td>googleai/gemini-2.5-flash</td> | |
| <td>Sound City Multi Function Stereo Audio Mixer Portable 4-Channel Battery Operated<br><span class="small">80 characters</span></td> | |
| <td>This Sound City Multi Function Stereo Audio Mixer is a portable, 4-channel mixing console. It features 8 line inputs, 1 microphone input, and 4 phono inputs, with analog RCA/coaxial and 1/4" TS/TRS input/output connections. The unit is designed to be battery-operated and weighs 1562 grams.</td> | |
| <td class="num">4504</td> | |
| <td class="num">606</td> | |
| <td class="num">6974</td> | |
| <td>Vintage, Retro, DJ, Excellent (condition term contradicted by 'ungeprüftem Auffindungszustand' - untested as found), Rare, Professional</td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| </div> | |
| <div class="note"> | |
| The prompts explicitly forbid unverifiable marketing claims such as vintage, retro, DJ, excellent, rare and professional | |
| unless they are visible or structurally verified. Eino returned four description sentences despite the 2-3 sentence prompt; | |
| the exact output is kept because the point of this section is real library behavior. | |
| </div> | |
| </section> | |
| <section> | |
| <h2>Runnable Code</h2> | |
| <p> | |
| The API key is read only from environment variables and is not embedded in the code or report. | |
| Shared TypeScript helpers contain the factual seller prompt and image loading logic. | |
| </p> | |
| <details> | |
| <summary>Shared TypeScript helper <span class="path">lib-comparison/scripts/shared.ts</span></summary> | |
| <pre><code class="language-ts"><span class="tok-keyword">import</span> fs <span class="tok-keyword">from</span> <span class="tok-string">"node:fs"</span>; | |
| <span class="tok-keyword">import</span> path <span class="tok-keyword">from</span> <span class="tok-string">"node:path"</span>; | |
| <span class="tok-keyword">import</span> { fileURLToPath } <span class="tok-keyword">from</span> <span class="tok-string">"node:url"</span>; | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">type</span> TokenUsage = { | |
| inputTokens?: <span class="tok-keyword">number</span>; | |
| outputTokens?: <span class="tok-keyword">number</span>; | |
| totalTokens?: <span class="tok-keyword">number</span>; | |
| raw?: <span class="tok-keyword">unknown</span>; | |
| }; | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">type</span> ListingResult = { | |
| seoTitle: <span class="tok-keyword">string</span>; | |
| description: <span class="tok-keyword">string</span>; | |
| visibleFacts: <span class="tok-keyword">string</span>[]; | |
| omittedUncertainClaims: <span class="tok-keyword">string</span>[]; | |
| }; | |
| <span class="tok-keyword">const</span> scriptDir = path.<span class="tok-function">dirname</span>(<span class="tok-function">fileURLToPath</span>(<span class="tok-keyword">import</span>.meta.url)); | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">const</span> projectRoot = path.<span class="tok-function">resolve</span>(scriptDir, <span class="tok-string">".."</span>); | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">const</span> workspaceRoot = path.<span class="tok-function">resolve</span>(projectRoot, <span class="tok-string">".."</span>); | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">const</span> itemJsonPath = path.<span class="tok-function">join</span>( | |
| workspaceRoot, | |
| <span class="tok-string">"sound-city-mischpult-10011850-inventory.json"</span>, | |
| ); | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">const</span> imageDir = path.<span class="tok-function">join</span>(projectRoot, <span class="tok-string">"input"</span>, <span class="tok-string">"images"</span>); | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">const</span> outputDir = path.<span class="tok-function">join</span>(projectRoot, <span class="tok-string">"output"</span>); | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">const</span> modelName = <span class="tok-string">"gemini-2.5-flash"</span>; | |
| <span class="tok-keyword">type</span> InventoryJson = { | |
| product: { | |
| title: <span class="tok-keyword">string</span>; | |
| imageUrls: <span class="tok-keyword">string</span>[]; | |
| aspects?: Record<<span class="tok-keyword">string</span>, <span class="tok-keyword">string</span>[]>; | |
| }; | |
| condition?: <span class="tok-keyword">string</span>; | |
| conditionDescription?: <span class="tok-keyword">string</span>; | |
| sku?: <span class="tok-keyword">string</span>; | |
| }; | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">function</span> <span class="tok-function">readItem</span>() { | |
| <span class="tok-keyword">const</span> item = JSON.<span class="tok-function">parse</span>(fs.<span class="tok-function">readFileSync</span>(itemJsonPath, <span class="tok-string">"utf8"</span>)) <span class="tok-keyword">as</span> InventoryJson; | |
| <span class="tok-keyword">const</span> images = fs | |
| .<span class="tok-function">readdirSync</span>(imageDir) | |
| .<span class="tok-function">filter</span>((name) => /\.(jpe?g|webp|png)$/i.<span class="tok-function">test</span>(name)) | |
| .<span class="tok-function">sort</span>() | |
| .<span class="tok-function">map</span>((name) => ({ | |
| name, | |
| path: path.<span class="tok-function">join</span>(imageDir, name), | |
| mimeType: <span class="tok-function">mimeTypeForFile</span>(name), | |
| base64: fs.<span class="tok-function">readFileSync</span>(path.<span class="tok-function">join</span>(imageDir, name)).<span class="tok-function">toString</span>(<span class="tok-string">"base64"</span>), | |
| })); | |
| <span class="tok-keyword">return</span> { item, images }; | |
| } | |
| <span class="tok-keyword">function</span> <span class="tok-function">mimeTypeForFile</span>(name: <span class="tok-keyword">string</span>) { | |
| <span class="tok-keyword">const</span> ext = path.<span class="tok-function">extname</span>(name).<span class="tok-function">toLowerCase</span>(); | |
| <span class="tok-keyword">if</span> (ext === <span class="tok-string">".webp"</span>) <span class="tok-keyword">return</span> <span class="tok-string">"image/webp"</span>; | |
| <span class="tok-keyword">if</span> (ext === <span class="tok-string">".png"</span>) <span class="tok-keyword">return</span> <span class="tok-string">"image/png"</span>; | |
| <span class="tok-keyword">return</span> <span class="tok-string">"image/jpeg"</span>; | |
| } | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">function</span> <span class="tok-function">prompts</span>() { | |
| <span class="tok-keyword">const</span> { item, images } = <span class="tok-function">readItem</span>(); | |
| <span class="tok-keyword">const</span> sourceData = { | |
| sourceTitle: item.product.title, | |
| condition: item.condition ?? <span class="tok-keyword">null</span>, | |
| conditionDescription: item.conditionDescription ?? <span class="tok-keyword">null</span>, | |
| sku: item.sku ?? item.product.aspects?.SKU?.[<span class="tok-number">0</span>] ?? <span class="tok-keyword">null</span>, | |
| aspects: item.product.aspects ?? {}, | |
| imageCount: images.length, | |
| }; | |
| <span class="tok-keyword">const</span> systemPrompt = [ | |
| <span class="tok-string">"You are an eBay listing assistant for a professional seller."</span>, | |
| <span class="tok-string">"Optimize listing copy using only facts that are visible in the supplied images or explicitly present in the supplied item data."</span>, | |
| <span class="tok-string">"Do not guess, infer hidden functionality, invent accessories, or claim compatibility unless it is visible or in the item data."</span>, | |
| <span class="tok-string">"Do not carry over marketing terms from the old title such as vintage, retro, DJ, excellent, rare, or professional unless they are visibly or structurally verified."</span>, | |
| <span class="tok-string">"The SEO title must follow the same factuality rules as the description."</span>, | |
| <span class="tok-string">"If a detail is uncertain, omit it and optionally list it under omittedUncertainClaims."</span>, | |
| <span class="tok-string">"Write neutral, factual English suitable for an eBay listing."</span>, | |
| ].<span class="tok-function">join</span>(<span class="tok-string">" "</span>); | |
| <span class="tok-keyword">const</span> userPrompt = [ | |
| <span class="tok-string">"Review every attached image and the item data below."</span>, | |
| <span class="tok-string">"Return a structured result with:"</span>, | |
| <span class="tok-string">"- seoTitle: an English SEO title of 80 characters or fewer, factual only."</span>, | |
| <span class="tok-string">"- description: 2 to 3 factual sentences, no hype, no unverifiable condition claims."</span>, | |
| <span class="tok-string">"- visibleFacts: short facts used from the images or item data."</span>, | |
| <span class="tok-string">"- omittedUncertainClaims: claims you avoided because they were not verifiable."</span>, | |
| <span class="tok-string">""</span>, | |
| <span class="tok-string">"Item data:"</span>, | |
| JSON.<span class="tok-function">stringify</span>(sourceData, <span class="tok-keyword">null</span>, <span class="tok-number">2</span>), | |
| ].<span class="tok-function">join</span>(<span class="tok-string">"\n"</span>); | |
| <span class="tok-keyword">return</span> { systemPrompt, userPrompt, sourceData }; | |
| } | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">function</span> <span class="tok-function">langChainContent</span>() { | |
| <span class="tok-keyword">const</span> { images } = <span class="tok-function">readItem</span>(); | |
| <span class="tok-keyword">const</span> { userPrompt } = <span class="tok-function">prompts</span>(); | |
| <span class="tok-keyword">return</span> [ | |
| { <span class="tok-keyword">type</span>: <span class="tok-string">"text"</span>, text: userPrompt }, | |
| ...images.<span class="tok-function">map</span>((image) => ({ | |
| <span class="tok-keyword">type</span>: <span class="tok-string">"image_url"</span>, | |
| image_url: <span class="tok-string">`data:${image.mimeType};base64,${image.base64}`</span>, | |
| })), | |
| ]; | |
| } | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">function</span> <span class="tok-function">mastraContent</span>() { | |
| <span class="tok-keyword">const</span> { images } = <span class="tok-function">readItem</span>(); | |
| <span class="tok-keyword">const</span> { userPrompt } = <span class="tok-function">prompts</span>(); | |
| <span class="tok-keyword">return</span> [ | |
| { <span class="tok-keyword">type</span>: <span class="tok-string">"text"</span>, text: userPrompt }, | |
| ...images.<span class="tok-function">map</span>((image) => ({ | |
| <span class="tok-keyword">type</span>: <span class="tok-string">"image"</span>, | |
| image: image.base64, | |
| mimeType: image.mimeType, | |
| })), | |
| ]; | |
| } | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">function</span> <span class="tok-function">normalizeUsage</span>(raw: <span class="tok-keyword">unknown</span>): TokenUsage { | |
| <span class="tok-keyword">const</span> usage = raw <span class="tok-keyword">as</span> Record<<span class="tok-keyword">string</span>, <span class="tok-keyword">unknown</span>> | <span class="tok-keyword">undefined</span>; | |
| <span class="tok-keyword">if</span> (!usage) <span class="tok-keyword">return</span> {}; | |
| <span class="tok-keyword">const</span> numberAt = (...keys: <span class="tok-keyword">string</span>[]) => { | |
| <span class="tok-keyword">for</span> (<span class="tok-keyword">const</span> key <span class="tok-keyword">of</span> keys) { | |
| <span class="tok-keyword">const</span> value = usage[key]; | |
| <span class="tok-keyword">if</span> (<span class="tok-keyword">typeof</span> value === <span class="tok-string">"number"</span>) <span class="tok-keyword">return</span> value; | |
| } | |
| <span class="tok-keyword">return</span> <span class="tok-keyword">undefined</span>; | |
| }; | |
| <span class="tok-keyword">return</span> { | |
| inputTokens: <span class="tok-function">numberAt</span>(<span class="tok-string">"inputTokens"</span>, <span class="tok-string">"input_tokens"</span>, <span class="tok-string">"prompt_tokens"</span>, <span class="tok-string">"promptTokens"</span>), | |
| outputTokens: <span class="tok-function">numberAt</span>(<span class="tok-string">"outputTokens"</span>, <span class="tok-string">"output_tokens"</span>, <span class="tok-string">"completion_tokens"</span>, <span class="tok-string">"completionTokens"</span>), | |
| totalTokens: <span class="tok-function">numberAt</span>(<span class="tok-string">"totalTokens"</span>, <span class="tok-string">"total_tokens"</span>, <span class="tok-string">"totalTokens"</span>), | |
| raw, | |
| }; | |
| } | |
| <span class="tok-keyword">export</span> <span class="tok-keyword">function</span> <span class="tok-function">writeRunOutput</span>( | |
| filename: <span class="tok-keyword">string</span>, | |
| payload: { | |
| library: <span class="tok-keyword">string</span>; | |
| model: <span class="tok-keyword">string</span>; | |
| sourceTitle: <span class="tok-keyword">string</span>; | |
| imageCount: <span class="tok-keyword">number</span>; | |
| result: ListingResult; | |
| usage: TokenUsage; | |
| rawResponse?: <span class="tok-keyword">unknown</span>; | |
| }, | |
| ) { | |
| fs.<span class="tok-function">mkdirSync</span>(outputDir, { recursive: <span class="tok-keyword">true</span> }); | |
| <span class="tok-keyword">const</span> target = path.<span class="tok-function">join</span>(outputDir, filename); | |
| fs.<span class="tok-function">writeFileSync</span>(target, <span class="tok-string">`${JSON.stringify(payload, null, 2)}\n`</span>); | |
| console.<span class="tok-function">log</span>(JSON.<span class="tok-function">stringify</span>(payload, <span class="tok-keyword">null</span>, <span class="tok-number">2</span>)); | |
| }</code></pre> | |
| </details> | |
| <details> | |
| <summary>Mastra TypeScript script <span class="path">lib-comparison/scripts/mastra.ts</span></summary> | |
| <pre><code class="language-ts"><span class="tok-keyword">import</span> { Agent } <span class="tok-keyword">from</span> <span class="tok-string">"@mastra/core/agent"</span>; | |
| <span class="tok-keyword">import</span> { z } <span class="tok-keyword">from</span> <span class="tok-string">"zod"</span>; | |
| <span class="tok-keyword">import</span> { | |
| mastraContent, | |
| modelName, | |
| normalizeUsage, | |
| prompts, | |
| readItem, | |
| writeRunOutput, | |
| } <span class="tok-keyword">from</span> <span class="tok-string">"./shared.js"</span>; | |
| <span class="tok-keyword">if</span> (process.env.GEMINI_API_KEY && !process.env.GOOGLE_GENERATIVE_AI_API_KEY) { | |
| process.env.GOOGLE_GENERATIVE_AI_API_KEY = process.env.GEMINI_API_KEY; | |
| } | |
| <span class="tok-keyword">const</span> outputSchema = z.<span class="tok-function">object</span>({ | |
| seoTitle: z.<span class="tok-keyword">string</span>().<span class="tok-function">max</span>(<span class="tok-number">80</span>), | |
| description: z.<span class="tok-keyword">string</span>(), | |
| visibleFacts: z.<span class="tok-function">array</span>(z.<span class="tok-keyword">string</span>()), | |
| omittedUncertainClaims: z.<span class="tok-function">array</span>(z.<span class="tok-keyword">string</span>()), | |
| }); | |
| <span class="tok-keyword">const</span> { item, images } = <span class="tok-function">readItem</span>(); | |
| <span class="tok-keyword">const</span> { systemPrompt } = <span class="tok-function">prompts</span>(); | |
| <span class="tok-keyword">const</span> agent = <span class="tok-keyword">new</span> <span class="tok-function">Agent</span>({ | |
| id: <span class="tok-string">"ebay-listing-agent"</span>, | |
| name: <span class="tok-string">"eBay Listing Agent"</span>, | |
| instructions: systemPrompt, | |
| model: <span class="tok-string">`google/${modelName}`</span>, | |
| }); | |
| <span class="tok-keyword">const</span> result = <span class="tok-keyword">await</span> agent.<span class="tok-function">generate</span>( | |
| [ | |
| { | |
| role: <span class="tok-string">"user"</span>, | |
| content: <span class="tok-function">mastraContent</span>(), | |
| }, | |
| ] <span class="tok-keyword">as</span> any, | |
| { | |
| structuredOutput: { schema: outputSchema }, | |
| temperature: <span class="tok-number">0.1</span>, | |
| } <span class="tok-keyword">as</span> any, | |
| ); | |
| <span class="tok-function">writeRunOutput</span>(<span class="tok-string">"mastra.json"</span>, { | |
| library: <span class="tok-string">"Mastra TypeScript"</span>, | |
| model: <span class="tok-string">`google/${modelName}`</span>, | |
| sourceTitle: item.product.title, | |
| imageCount: images.length, | |
| result: result.object, | |
| usage: <span class="tok-function">normalizeUsage</span>(result.totalUsage ?? result.usage), | |
| rawResponse: { | |
| finishReason: result.finishReason, | |
| usage: result.usage, | |
| totalUsage: result.totalUsage, | |
| }, | |
| });</code></pre> | |
| </details> | |
| <details> | |
| <summary>LangChain.js + LangGraph.js TypeScript script <span class="path">lib-comparison/scripts/langgraph.ts</span></summary> | |
| <pre><code class="language-ts"><span class="tok-keyword">import</span> { ChatGoogleGenerativeAI } <span class="tok-keyword">from</span> <span class="tok-string">"@langchain/google-genai"</span>; | |
| <span class="tok-keyword">import</span> { HumanMessage, SystemMessage } <span class="tok-keyword">from</span> <span class="tok-string">"@langchain/core/messages"</span>; | |
| <span class="tok-keyword">import</span> { Annotation, END, START, StateGraph } <span class="tok-keyword">from</span> <span class="tok-string">"@langchain/langgraph"</span>; | |
| <span class="tok-keyword">import</span> { z } <span class="tok-keyword">from</span> <span class="tok-string">"zod"</span>; | |
| <span class="tok-keyword">import</span> { | |
| langChainContent, | |
| modelName, | |
| normalizeUsage, | |
| prompts, | |
| readItem, | |
| writeRunOutput, | |
| } <span class="tok-keyword">from</span> <span class="tok-string">"./shared.js"</span>; | |
| <span class="tok-keyword">const</span> outputSchema = z.<span class="tok-function">object</span>({ | |
| seoTitle: z.<span class="tok-keyword">string</span>().<span class="tok-function">max</span>(<span class="tok-number">80</span>), | |
| description: z.<span class="tok-keyword">string</span>(), | |
| visibleFacts: z.<span class="tok-function">array</span>(z.<span class="tok-keyword">string</span>()), | |
| omittedUncertainClaims: z.<span class="tok-function">array</span>(z.<span class="tok-keyword">string</span>()), | |
| }); | |
| <span class="tok-keyword">const</span> { item, images } = <span class="tok-function">readItem</span>(); | |
| <span class="tok-keyword">const</span> { systemPrompt } = <span class="tok-function">prompts</span>(); | |
| <span class="tok-keyword">const</span> model = <span class="tok-keyword">new</span> <span class="tok-function">ChatGoogleGenerativeAI</span>({ | |
| apiKey: process.env.GEMINI_API_KEY, | |
| model: modelName, | |
| temperature: <span class="tok-number">0.1</span>, | |
| maxOutputTokens: <span class="tok-number">4096</span>, | |
| }); | |
| <span class="tok-keyword">const</span> structuredModel = model.<span class="tok-function">withStructuredOutput</span>(outputSchema, { includeRaw: <span class="tok-keyword">true</span> }); | |
| <span class="tok-keyword">const</span> ListingState = Annotation.<span class="tok-function">Root</span>({ | |
| result: Annotation<z.<span class="tok-keyword">infer</span><<span class="tok-keyword">typeof</span> outputSchema> | <span class="tok-keyword">undefined</span>>(), | |
| usage: Annotation<<span class="tok-keyword">unknown</span> | <span class="tok-keyword">undefined</span>>(), | |
| rawResponse: Annotation<<span class="tok-keyword">unknown</span> | <span class="tok-keyword">undefined</span>>(), | |
| }); | |
| <span class="tok-keyword">const</span> graph = <span class="tok-keyword">new</span> <span class="tok-function">StateGraph</span>(ListingState) | |
| .<span class="tok-function">addNode</span>(<span class="tok-string">"optimizeListing"</span>, <span class="tok-keyword">async</span> () => { | |
| <span class="tok-keyword">const</span> messages = [ | |
| <span class="tok-keyword">new</span> <span class="tok-function">SystemMessage</span>(systemPrompt), | |
| <span class="tok-keyword">new</span> <span class="tok-function">HumanMessage</span>({ content: <span class="tok-function">langChainContent</span>() <span class="tok-keyword">as</span> any }), | |
| ]; | |
| <span class="tok-keyword">const</span> result = <span class="tok-keyword">await</span> structuredModel.<span class="tok-function">invoke</span>(messages); | |
| <span class="tok-keyword">const</span> raw = result.raw <span class="tok-keyword">as</span> any; | |
| <span class="tok-keyword">const</span> parsed = | |
| result.parsed ?? | |
| outputSchema.<span class="tok-function">parse</span>( | |
| JSON.<span class="tok-function">parse</span>(<span class="tok-keyword">typeof</span> raw.content === <span class="tok-string">"string"</span> ? raw.content : <span class="tok-function">String</span>(raw.content)), | |
| ); | |
| <span class="tok-keyword">return</span> { | |
| result: parsed, | |
| usage: raw.usage_metadata, | |
| rawResponse: { | |
| response_metadata: raw.response_metadata, | |
| usage_metadata: raw.usage_metadata, | |
| parsedByLangChain: result.parsed !== <span class="tok-keyword">null</span>, | |
| usedJsonParseFallback: result.parsed === <span class="tok-keyword">null</span>, | |
| }, | |
| }; | |
| }) | |
| .<span class="tok-function">addEdge</span>(START, <span class="tok-string">"optimizeListing"</span>) | |
| .<span class="tok-function">addEdge</span>(<span class="tok-string">"optimizeListing"</span>, END) | |
| .<span class="tok-function">compile</span>(); | |
| <span class="tok-keyword">const</span> output = <span class="tok-keyword">await</span> graph.<span class="tok-function">invoke</span>({}); | |
| <span class="tok-keyword">if</span> (!output.result) { | |
| <span class="tok-keyword">throw</span> <span class="tok-keyword">new</span> <span class="tok-function">Error</span>(<span class="tok-string">"LangGraph did not return a structured listing result."</span>); | |
| } | |
| <span class="tok-function">writeRunOutput</span>(<span class="tok-string">"langgraph.json"</span>, { | |
| library: <span class="tok-string">"LangChain.js + LangGraph.js TypeScript"</span>, | |
| model: modelName, | |
| sourceTitle: item.product.title, | |
| imageCount: images.length, | |
| result: output.result, | |
| usage: <span class="tok-function">normalizeUsage</span>(output.usage), | |
| rawResponse: output.rawResponse, | |
| });</code></pre> | |
| </details> | |
| <details> | |
| <summary>Vercel AI SDK TypeScript script <span class="path">lib-comparison/scripts/vercel-ai.ts</span></summary> | |
| <pre><code class="language-ts"><span class="tok-keyword">import</span> { google } <span class="tok-keyword">from</span> <span class="tok-string">"@ai-sdk/google"</span>; | |
| <span class="tok-keyword">import</span> { generateObject } <span class="tok-keyword">from</span> <span class="tok-string">"ai"</span>; | |
| <span class="tok-keyword">import</span> { z } <span class="tok-keyword">from</span> <span class="tok-string">"zod"</span>; | |
| <span class="tok-keyword">import</span> { | |
| modelName, | |
| normalizeUsage, | |
| prompts, | |
| readItem, | |
| writeRunOutput, | |
| } <span class="tok-keyword">from</span> <span class="tok-string">"./shared.js"</span>; | |
| <span class="tok-keyword">const</span> outputSchema = z.<span class="tok-function">object</span>({ | |
| seoTitle: z.<span class="tok-keyword">string</span>().<span class="tok-function">max</span>(<span class="tok-number">80</span>), | |
| description: z.<span class="tok-keyword">string</span>(), | |
| visibleFacts: z.<span class="tok-function">array</span>(z.<span class="tok-keyword">string</span>()), | |
| omittedUncertainClaims: z.<span class="tok-function">array</span>(z.<span class="tok-keyword">string</span>()), | |
| }); | |
| <span class="tok-keyword">if</span> (process.env.GEMINI_API_KEY && !process.env.GOOGLE_GENERATIVE_AI_API_KEY) { | |
| process.env.GOOGLE_GENERATIVE_AI_API_KEY = process.env.GEMINI_API_KEY; | |
| } | |
| <span class="tok-keyword">const</span> { item, images } = <span class="tok-function">readItem</span>(); | |
| <span class="tok-keyword">const</span> { systemPrompt, userPrompt } = <span class="tok-function">prompts</span>(); | |
| <span class="tok-keyword">const</span> result = <span class="tok-keyword">await</span> <span class="tok-function">generateObject</span>({ | |
| model: <span class="tok-function">google</span>(modelName), | |
| schema: outputSchema, | |
| system: systemPrompt, | |
| messages: [ | |
| { | |
| role: <span class="tok-string">"user"</span>, | |
| content: [ | |
| { <span class="tok-keyword">type</span>: <span class="tok-string">"text"</span>, text: userPrompt }, | |
| ...images.<span class="tok-function">map</span>((image) => ({ | |
| <span class="tok-keyword">type</span>: <span class="tok-string">"file"</span> <span class="tok-keyword">as</span> <span class="tok-keyword">const</span>, | |
| data: image.base64, | |
| mediaType: image.mimeType, | |
| })), | |
| ], | |
| }, | |
| ], | |
| temperature: <span class="tok-number">0.1</span>, | |
| maxOutputTokens: <span class="tok-number">4096</span>, | |
| }); | |
| <span class="tok-function">writeRunOutput</span>(<span class="tok-string">"vercel-ai.json"</span>, { | |
| library: <span class="tok-string">"Vercel AI SDK TypeScript"</span>, | |
| model: <span class="tok-string">`google/${modelName}`</span>, | |
| sourceTitle: item.product.title, | |
| imageCount: images.length, | |
| result: result.object, | |
| usage: <span class="tok-function">normalizeUsage</span>(result.usage), | |
| rawResponse: { | |
| finishReason: result.finishReason, | |
| usage: result.usage, | |
| warnings: result.warnings, | |
| }, | |
| });</code></pre> | |
| </details> | |
| <details> | |
| <summary>Eino Go script <span class="path">lib-comparison/eino-go/main.go</span></summary> | |
| <pre><code class="language-go"><span class="tok-keyword">package</span> main | |
| <span class="tok-keyword">import</span> ( | |
| <span class="tok-string">"context"</span> | |
| <span class="tok-string">"encoding/base64"</span> | |
| <span class="tok-string">"encoding/json"</span> | |
| <span class="tok-string">"fmt"</span> | |
| <span class="tok-string">"log"</span> | |
| <span class="tok-string">"os"</span> | |
| <span class="tok-string">"path/filepath"</span> | |
| <span class="tok-string">"sort"</span> | |
| <span class="tok-string">"strings"</span> | |
| <span class="tok-string">"github.com/cloudwego/eino-ext/components/model/gemini"</span> | |
| <span class="tok-string">"github.com/cloudwego/eino/schema"</span> | |
| jsonschema <span class="tok-string">"github.com/eino-contrib/jsonschema"</span> | |
| <span class="tok-string">"google.golang.org/genai"</span> | |
| ) | |
| <span class="tok-keyword">type</span> Inventory <span class="tok-keyword">struct</span> { | |
| Product <span class="tok-keyword">struct</span> { | |
| Title <span class="tok-keyword">string</span> <span class="tok-string">`json:"title"`</span> | |
| ImageURLs []<span class="tok-keyword">string</span> <span class="tok-string">`json:"imageUrls"`</span> | |
| Aspects <span class="tok-keyword">map</span>[<span class="tok-keyword">string</span>][]<span class="tok-keyword">string</span> <span class="tok-string">`json:"aspects"`</span> | |
| } <span class="tok-string">`json:"product"`</span> | |
| Condition <span class="tok-keyword">string</span> <span class="tok-string">`json:"condition"`</span> | |
| ConditionDescription <span class="tok-keyword">string</span> <span class="tok-string">`json:"conditionDescription"`</span> | |
| SKU <span class="tok-keyword">string</span> <span class="tok-string">`json:"sku"`</span> | |
| } | |
| <span class="tok-keyword">type</span> ListingResult <span class="tok-keyword">struct</span> { | |
| SEOTitle <span class="tok-keyword">string</span> <span class="tok-string">`json:"seoTitle" jsonschema:"maxLength=80"`</span> | |
| Description <span class="tok-keyword">string</span> <span class="tok-string">`json:"description"`</span> | |
| VisibleFacts []<span class="tok-keyword">string</span> <span class="tok-string">`json:"visibleFacts"`</span> | |
| OmittedUncertainClaims []<span class="tok-keyword">string</span> <span class="tok-string">`json:"omittedUncertainClaims"`</span> | |
| } | |
| <span class="tok-keyword">type</span> RunOutput <span class="tok-keyword">struct</span> { | |
| Library <span class="tok-keyword">string</span> <span class="tok-string">`json:"library"`</span> | |
| Model <span class="tok-keyword">string</span> <span class="tok-string">`json:"model"`</span> | |
| SourceTitle <span class="tok-keyword">string</span> <span class="tok-string">`json:"sourceTitle"`</span> | |
| ImageCount int <span class="tok-string">`json:"imageCount"`</span> | |
| Result ListingResult <span class="tok-string">`json:"result"`</span> | |
| Usage TokenUsage <span class="tok-string">`json:"usage"`</span> | |
| RawResponse <span class="tok-keyword">any</span> <span class="tok-string">`json:"rawResponse,omitempty"`</span> | |
| } | |
| <span class="tok-keyword">type</span> TokenUsage <span class="tok-keyword">struct</span> { | |
| InputTokens int <span class="tok-string">`json:"inputTokens,omitempty"`</span> | |
| OutputTokens int <span class="tok-string">`json:"outputTokens,omitempty"`</span> | |
| TotalTokens int <span class="tok-string">`json:"totalTokens,omitempty"`</span> | |
| Raw <span class="tok-keyword">any</span> <span class="tok-string">`json:"raw,omitempty"`</span> | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">main</span>() { | |
| ctx := context.<span class="tok-function">Background</span>() | |
| root := filepath.<span class="tok-function">Clean</span>(<span class="tok-string">".."</span>) | |
| item := <span class="tok-function">readItem</span>(filepath.<span class="tok-function">Join</span>(root, <span class="tok-string">".."</span>, <span class="tok-string">"sound-city-mischpult-10011850-inventory.json"</span>)) | |
| imageParts := <span class="tok-function">readImages</span>(filepath.<span class="tok-function">Join</span>(root, <span class="tok-string">"input"</span>, <span class="tok-string">"images"</span>)) | |
| client, err := genai.<span class="tok-function">NewClient</span>(ctx, &genai.ClientConfig{ | |
| APIKey: os.<span class="tok-function">Getenv</span>(<span class="tok-string">"GEMINI_API_KEY"</span>), | |
| Backend: genai.BackendGeminiAPI, | |
| }) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| temp := <span class="tok-function">float32</span>(<span class="tok-number">0.1</span>) | |
| maxTokens := <span class="tok-number">4096</span> | |
| reflector := jsonschema.Reflector{DoNotReference: <span class="tok-keyword">true</span>} | |
| chatModel, err := gemini.<span class="tok-function">NewChatModel</span>(ctx, &gemini.Config{ | |
| Client: client, | |
| Model: <span class="tok-string">"gemini-2.5-flash"</span>, | |
| Temperature: &temp, | |
| MaxTokens: &maxTokens, | |
| ResponseJSONSchema: reflector.<span class="tok-function">Reflect</span>(ListingResult{}), | |
| }) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| resp, err := chatModel.<span class="tok-function">Generate</span>(ctx, []*schema.Message{ | |
| schema.<span class="tok-function">SystemMessage</span>(<span class="tok-function">systemPrompt</span>()), | |
| { | |
| Role: schema.User, | |
| UserInputMultiContent: <span class="tok-function">append</span>([]schema.MessageInputPart{<span class="tok-function">textPart</span>(<span class="tok-function">userPrompt</span>(item, <span class="tok-function">len</span>(imageParts)))}, imageParts...), | |
| }, | |
| }) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">var</span> result ListingResult | |
| <span class="tok-keyword">if</span> err := json.<span class="tok-function">Unmarshal</span>([]<span class="tok-function">byte</span>(resp.Content), &result); err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatalf</span>(<span class="tok-string">"parse structured response: %v\nraw: %s"</span>, err, resp.Content) | |
| } | |
| usage := TokenUsage{} | |
| <span class="tok-keyword">if</span> resp.ResponseMeta != <span class="tok-keyword">nil</span> && resp.ResponseMeta.Usage != <span class="tok-keyword">nil</span> { | |
| usage = TokenUsage{ | |
| InputTokens: resp.ResponseMeta.Usage.PromptTokens, | |
| OutputTokens: resp.ResponseMeta.Usage.CompletionTokens, | |
| TotalTokens: resp.ResponseMeta.Usage.TotalTokens, | |
| Raw: resp.ResponseMeta.Usage, | |
| } | |
| } | |
| <span class="tok-function">writeOutput</span>(filepath.<span class="tok-function">Join</span>(root, <span class="tok-string">"output"</span>, <span class="tok-string">"eino.json"</span>), RunOutput{ | |
| Library: <span class="tok-string">"Eino Go"</span>, | |
| Model: <span class="tok-string">"gemini-2.5-flash"</span>, | |
| SourceTitle: item.Product.Title, | |
| ImageCount: <span class="tok-function">len</span>(imageParts), | |
| Result: result, | |
| Usage: usage, | |
| RawResponse: <span class="tok-keyword">map</span>[<span class="tok-keyword">string</span>]<span class="tok-keyword">any</span>{ | |
| <span class="tok-string">"finishReason"</span>: <span class="tok-function">valueOrEmpty</span>(resp.ResponseMeta), | |
| <span class="tok-string">"content"</span>: resp.Content, | |
| }, | |
| }) | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">readItem</span>(path <span class="tok-keyword">string</span>) Inventory { | |
| data, err := os.<span class="tok-function">ReadFile</span>(path) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">var</span> item Inventory | |
| <span class="tok-keyword">if</span> err := json.<span class="tok-function">Unmarshal</span>(data, &item); err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">return</span> item | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">readImages</span>(dir <span class="tok-keyword">string</span>) []schema.MessageInputPart { | |
| entries, err := os.<span class="tok-function">ReadDir</span>(dir) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| names := <span class="tok-function">make</span>([]<span class="tok-keyword">string</span>, <span class="tok-number">0</span>, <span class="tok-function">len</span>(entries)) | |
| <span class="tok-keyword">for</span> _, entry := <span class="tok-keyword">range</span> entries { | |
| <span class="tok-keyword">if</span> <span class="tok-function">isImageFile</span>(entry.<span class="tok-function">Name</span>()) { | |
| names = <span class="tok-function">append</span>(names, entry.<span class="tok-function">Name</span>()) | |
| } | |
| } | |
| sort.<span class="tok-function">Strings</span>(names) | |
| parts := <span class="tok-function">make</span>([]schema.MessageInputPart, <span class="tok-number">0</span>, <span class="tok-function">len</span>(names)) | |
| <span class="tok-keyword">for</span> _, name := <span class="tok-keyword">range</span> names { | |
| data, err := os.<span class="tok-function">ReadFile</span>(filepath.<span class="tok-function">Join</span>(dir, name)) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| base64Data := base64.StdEncoding.<span class="tok-function">EncodeToString</span>(data) | |
| mimeType := <span class="tok-function">mimeTypeForFile</span>(name) | |
| parts = <span class="tok-function">append</span>(parts, schema.MessageInputPart{ | |
| Type: schema.ChatMessagePartTypeImageURL, | |
| Image: &schema.MessageInputImage{ | |
| MessagePartCommon: schema.MessagePartCommon{ | |
| Base64Data: &base64Data, | |
| MIMEType: mimeType, | |
| }, | |
| Detail: schema.ImageURLDetailHigh, | |
| }, | |
| }) | |
| } | |
| <span class="tok-keyword">return</span> parts | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">isImageFile</span>(name <span class="tok-keyword">string</span>) <span class="tok-keyword">bool</span> { | |
| ext := strings.<span class="tok-function">ToLower</span>(filepath.<span class="tok-function">Ext</span>(name)) | |
| <span class="tok-keyword">return</span> ext == <span class="tok-string">".jpg"</span> || ext == <span class="tok-string">".jpeg"</span> || ext == <span class="tok-string">".webp"</span> || ext == <span class="tok-string">".png"</span> | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">mimeTypeForFile</span>(name <span class="tok-keyword">string</span>) <span class="tok-keyword">string</span> { | |
| <span class="tok-keyword">switch</span> strings.<span class="tok-function">ToLower</span>(filepath.<span class="tok-function">Ext</span>(name)) { | |
| <span class="tok-keyword">case</span> <span class="tok-string">".webp"</span>: | |
| <span class="tok-keyword">return</span> <span class="tok-string">"image/webp"</span> | |
| <span class="tok-keyword">case</span> <span class="tok-string">".png"</span>: | |
| <span class="tok-keyword">return</span> <span class="tok-string">"image/png"</span> | |
| <span class="tok-keyword">default</span>: | |
| <span class="tok-keyword">return</span> <span class="tok-string">"image/jpeg"</span> | |
| } | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">systemPrompt</span>() <span class="tok-keyword">string</span> { | |
| <span class="tok-keyword">return</span> strings.<span class="tok-function">Join</span>([]<span class="tok-keyword">string</span>{ | |
| <span class="tok-string">"You are an eBay listing assistant for a professional seller."</span>, | |
| <span class="tok-string">"Optimize listing copy using only facts that are visible in the supplied images or explicitly present in the supplied item data."</span>, | |
| <span class="tok-string">"Do not guess, infer hidden functionality, invent accessories, or claim compatibility unless it is visible or in the item data."</span>, | |
| <span class="tok-string">"Do not carry over marketing terms from the old title such as vintage, retro, DJ, excellent, rare, or professional unless they are visibly or structurally verified."</span>, | |
| <span class="tok-string">"The SEO title must follow the same factuality rules as the description."</span>, | |
| <span class="tok-string">"If a detail is uncertain, omit it and optionally list it under omittedUncertainClaims."</span>, | |
| <span class="tok-string">"Write neutral, factual English suitable for an eBay listing."</span>, | |
| }, <span class="tok-string">" "</span>) | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">userPrompt</span>(item Inventory, imageCount int) <span class="tok-keyword">string</span> { | |
| source := <span class="tok-keyword">map</span>[<span class="tok-keyword">string</span>]<span class="tok-keyword">any</span>{ | |
| <span class="tok-string">"sourceTitle"</span>: item.Product.Title, | |
| <span class="tok-string">"condition"</span>: <span class="tok-function">nilIfEmpty</span>(item.Condition), | |
| <span class="tok-string">"conditionDescription"</span>: <span class="tok-function">nilIfEmpty</span>(item.ConditionDescription), | |
| <span class="tok-string">"sku"</span>: <span class="tok-function">nilIfEmpty</span>(item.SKU), | |
| <span class="tok-string">"aspects"</span>: item.Product.Aspects, | |
| <span class="tok-string">"imageCount"</span>: imageCount, | |
| } | |
| data, _ := json.<span class="tok-function">MarshalIndent</span>(source, <span class="tok-string">""</span>, <span class="tok-string">" "</span>) | |
| <span class="tok-keyword">return</span> fmt.<span class="tok-function">Sprintf</span>(<span class="tok-string">`Review every attached image and the item data below. | |
| Return a structured result with: | |
| - seoTitle: an English SEO title of 80 characters or fewer, factual only. | |
| - description: 2 to 3 factual sentences, no hype, no unverifiable condition claims. | |
| - visibleFacts: short facts used from the images or item data. | |
| - omittedUncertainClaims: claims you avoided because they were not verifiable. | |
| Item data: | |
| %s`</span>, data) | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">textPart</span>(text <span class="tok-keyword">string</span>) schema.MessageInputPart { | |
| <span class="tok-keyword">return</span> schema.MessageInputPart{Type: schema.ChatMessagePartTypeText, Text: text} | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">nilIfEmpty</span>(value <span class="tok-keyword">string</span>) <span class="tok-keyword">any</span> { | |
| <span class="tok-keyword">if</span> value == <span class="tok-string">""</span> { | |
| <span class="tok-keyword">return</span> <span class="tok-keyword">nil</span> | |
| } | |
| <span class="tok-keyword">return</span> value | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">valueOrEmpty</span>(meta *schema.ResponseMeta) <span class="tok-keyword">string</span> { | |
| <span class="tok-keyword">if</span> meta == <span class="tok-keyword">nil</span> { | |
| <span class="tok-keyword">return</span> <span class="tok-string">""</span> | |
| } | |
| <span class="tok-keyword">return</span> meta.FinishReason | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">writeOutput</span>(path <span class="tok-keyword">string</span>, output RunOutput) { | |
| data, err := json.<span class="tok-function">MarshalIndent</span>(output, <span class="tok-string">""</span>, <span class="tok-string">" "</span>) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">if</span> err := os.<span class="tok-function">MkdirAll</span>(filepath.<span class="tok-function">Dir</span>(path), <span class="tok-number">0755</span>); err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">if</span> err := os.<span class="tok-function">WriteFile</span>(path, <span class="tok-function">append</span>(data, <span class="tok-string">'\n'</span>), <span class="tok-number">0644</span>); err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| fmt.<span class="tok-function">Println</span>(<span class="tok-keyword">string</span>(data)) | |
| }</code></pre> | |
| </details> | |
| <details> | |
| <summary>Genkit Go script <span class="path">lib-comparison/genkit-go/main.go</span></summary> | |
| <pre><code class="language-go"><span class="tok-keyword">package</span> main | |
| <span class="tok-keyword">import</span> ( | |
| <span class="tok-string">"context"</span> | |
| <span class="tok-string">"encoding/base64"</span> | |
| <span class="tok-string">"encoding/json"</span> | |
| <span class="tok-string">"fmt"</span> | |
| <span class="tok-string">"log"</span> | |
| <span class="tok-string">"os"</span> | |
| <span class="tok-string">"path/filepath"</span> | |
| <span class="tok-string">"sort"</span> | |
| <span class="tok-string">"strings"</span> | |
| <span class="tok-string">"github.com/firebase/genkit/go/ai"</span> | |
| <span class="tok-string">"github.com/firebase/genkit/go/genkit"</span> | |
| <span class="tok-string">"github.com/firebase/genkit/go/plugins/googlegenai"</span> | |
| ) | |
| <span class="tok-keyword">type</span> Inventory <span class="tok-keyword">struct</span> { | |
| Product <span class="tok-keyword">struct</span> { | |
| Title <span class="tok-keyword">string</span> <span class="tok-string">`json:"title"`</span> | |
| ImageURLs []<span class="tok-keyword">string</span> <span class="tok-string">`json:"imageUrls"`</span> | |
| Aspects <span class="tok-keyword">map</span>[<span class="tok-keyword">string</span>][]<span class="tok-keyword">string</span> <span class="tok-string">`json:"aspects"`</span> | |
| } <span class="tok-string">`json:"product"`</span> | |
| Condition <span class="tok-keyword">string</span> <span class="tok-string">`json:"condition"`</span> | |
| ConditionDescription <span class="tok-keyword">string</span> <span class="tok-string">`json:"conditionDescription"`</span> | |
| SKU <span class="tok-keyword">string</span> <span class="tok-string">`json:"sku"`</span> | |
| } | |
| <span class="tok-keyword">type</span> ListingResult <span class="tok-keyword">struct</span> { | |
| SEOTitle <span class="tok-keyword">string</span> <span class="tok-string">`json:"seoTitle" jsonschema:"maxLength=80"`</span> | |
| Description <span class="tok-keyword">string</span> <span class="tok-string">`json:"description"`</span> | |
| VisibleFacts []<span class="tok-keyword">string</span> <span class="tok-string">`json:"visibleFacts"`</span> | |
| OmittedUncertainClaims []<span class="tok-keyword">string</span> <span class="tok-string">`json:"omittedUncertainClaims"`</span> | |
| } | |
| <span class="tok-keyword">type</span> TokenUsage <span class="tok-keyword">struct</span> { | |
| InputTokens int <span class="tok-string">`json:"inputTokens,omitempty"`</span> | |
| OutputTokens int <span class="tok-string">`json:"outputTokens,omitempty"`</span> | |
| TotalTokens int <span class="tok-string">`json:"totalTokens,omitempty"`</span> | |
| Raw <span class="tok-keyword">any</span> <span class="tok-string">`json:"raw,omitempty"`</span> | |
| } | |
| <span class="tok-keyword">type</span> RunOutput <span class="tok-keyword">struct</span> { | |
| Library <span class="tok-keyword">string</span> <span class="tok-string">`json:"library"`</span> | |
| Model <span class="tok-keyword">string</span> <span class="tok-string">`json:"model"`</span> | |
| SourceTitle <span class="tok-keyword">string</span> <span class="tok-string">`json:"sourceTitle"`</span> | |
| ImageCount int <span class="tok-string">`json:"imageCount"`</span> | |
| Result ListingResult <span class="tok-string">`json:"result"`</span> | |
| Usage TokenUsage <span class="tok-string">`json:"usage"`</span> | |
| RawResponse <span class="tok-keyword">any</span> <span class="tok-string">`json:"rawResponse,omitempty"`</span> | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">main</span>() { | |
| ctx := context.<span class="tok-function">Background</span>() | |
| root := filepath.<span class="tok-function">Clean</span>(<span class="tok-string">".."</span>) | |
| item := <span class="tok-function">readItem</span>(filepath.<span class="tok-function">Join</span>(root, <span class="tok-string">".."</span>, <span class="tok-string">"sound-city-mischpult-10011850-inventory.json"</span>)) | |
| parts := <span class="tok-function">readImageParts</span>(filepath.<span class="tok-function">Join</span>(root, <span class="tok-string">"input"</span>, <span class="tok-string">"images"</span>)) | |
| g := genkit.<span class="tok-function">Init</span>(ctx, | |
| genkit.<span class="tok-function">WithPlugins</span>(&googlegenai.GoogleAI{APIKey: os.<span class="tok-function">Getenv</span>(<span class="tok-string">"GEMINI_API_KEY"</span>)}), | |
| genkit.<span class="tok-function">WithDefaultModel</span>(<span class="tok-string">"googleai/gemini-2.5-flash"</span>), | |
| ) | |
| userParts := <span class="tok-function">append</span>([]*ai.Part{ai.<span class="tok-function">NewTextPart</span>(<span class="tok-function">userPrompt</span>(item, <span class="tok-function">len</span>(parts)))}, parts...) | |
| result, response, err := genkit.GenerateData[ListingResult](ctx, g, | |
| ai.<span class="tok-function">WithModelName</span>(<span class="tok-string">"googleai/gemini-2.5-flash"</span>), | |
| ai.<span class="tok-function">WithSystem</span>(<span class="tok-function">systemPrompt</span>()), | |
| ai.<span class="tok-function">WithMessages</span>(ai.<span class="tok-function">NewUserMessage</span>(userParts...)), | |
| ) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| usage := TokenUsage{} | |
| <span class="tok-keyword">if</span> response.Usage != <span class="tok-keyword">nil</span> { | |
| usage = TokenUsage{ | |
| InputTokens: response.Usage.InputTokens, | |
| OutputTokens: response.Usage.OutputTokens, | |
| TotalTokens: response.Usage.TotalTokens, | |
| Raw: response.Usage, | |
| } | |
| } | |
| <span class="tok-function">writeOutput</span>(filepath.<span class="tok-function">Join</span>(root, <span class="tok-string">"output"</span>, <span class="tok-string">"genkit.json"</span>), RunOutput{ | |
| Library: <span class="tok-string">"Genkit Go"</span>, | |
| Model: <span class="tok-string">"googleai/gemini-2.5-flash"</span>, | |
| SourceTitle: item.Product.Title, | |
| ImageCount: <span class="tok-function">len</span>(parts), | |
| Result: *result, | |
| Usage: usage, | |
| RawResponse: <span class="tok-keyword">map</span>[<span class="tok-keyword">string</span>]<span class="tok-keyword">any</span>{ | |
| <span class="tok-string">"finishReason"</span>: response.FinishReason, | |
| <span class="tok-string">"finishMessage"</span>: response.FinishMessage, | |
| <span class="tok-string">"usage"</span>: response.Usage, | |
| }, | |
| }) | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">readItem</span>(path <span class="tok-keyword">string</span>) Inventory { | |
| data, err := os.<span class="tok-function">ReadFile</span>(path) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">var</span> item Inventory | |
| <span class="tok-keyword">if</span> err := json.<span class="tok-function">Unmarshal</span>(data, &item); err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">return</span> item | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">readImageParts</span>(dir <span class="tok-keyword">string</span>) []*ai.Part { | |
| entries, err := os.<span class="tok-function">ReadDir</span>(dir) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| names := <span class="tok-function">make</span>([]<span class="tok-keyword">string</span>, <span class="tok-number">0</span>, <span class="tok-function">len</span>(entries)) | |
| <span class="tok-keyword">for</span> _, entry := <span class="tok-keyword">range</span> entries { | |
| <span class="tok-keyword">if</span> <span class="tok-function">isImageFile</span>(entry.<span class="tok-function">Name</span>()) { | |
| names = <span class="tok-function">append</span>(names, entry.<span class="tok-function">Name</span>()) | |
| } | |
| } | |
| sort.<span class="tok-function">Strings</span>(names) | |
| parts := <span class="tok-function">make</span>([]*ai.Part, <span class="tok-number">0</span>, <span class="tok-function">len</span>(names)) | |
| <span class="tok-keyword">for</span> _, name := <span class="tok-keyword">range</span> names { | |
| data, err := os.<span class="tok-function">ReadFile</span>(filepath.<span class="tok-function">Join</span>(dir, name)) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| mimeType := <span class="tok-function">mimeTypeForFile</span>(name) | |
| parts = <span class="tok-function">append</span>(parts, ai.<span class="tok-function">NewMediaPart</span>(mimeType, <span class="tok-string">"data:"</span>+mimeType+<span class="tok-string">";base64,"</span>+base64.StdEncoding.<span class="tok-function">EncodeToString</span>(data))) | |
| } | |
| <span class="tok-keyword">return</span> parts | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">isImageFile</span>(name <span class="tok-keyword">string</span>) <span class="tok-keyword">bool</span> { | |
| ext := strings.<span class="tok-function">ToLower</span>(filepath.<span class="tok-function">Ext</span>(name)) | |
| <span class="tok-keyword">return</span> ext == <span class="tok-string">".jpg"</span> || ext == <span class="tok-string">".jpeg"</span> || ext == <span class="tok-string">".webp"</span> || ext == <span class="tok-string">".png"</span> | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">mimeTypeForFile</span>(name <span class="tok-keyword">string</span>) <span class="tok-keyword">string</span> { | |
| <span class="tok-keyword">switch</span> strings.<span class="tok-function">ToLower</span>(filepath.<span class="tok-function">Ext</span>(name)) { | |
| <span class="tok-keyword">case</span> <span class="tok-string">".webp"</span>: | |
| <span class="tok-keyword">return</span> <span class="tok-string">"image/webp"</span> | |
| <span class="tok-keyword">case</span> <span class="tok-string">".png"</span>: | |
| <span class="tok-keyword">return</span> <span class="tok-string">"image/png"</span> | |
| <span class="tok-keyword">default</span>: | |
| <span class="tok-keyword">return</span> <span class="tok-string">"image/jpeg"</span> | |
| } | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">systemPrompt</span>() <span class="tok-keyword">string</span> { | |
| <span class="tok-keyword">return</span> strings.<span class="tok-function">Join</span>([]<span class="tok-keyword">string</span>{ | |
| <span class="tok-string">"You are an eBay listing assistant for a professional seller."</span>, | |
| <span class="tok-string">"Optimize listing copy using only facts that are visible in the supplied images or explicitly present in the supplied item data."</span>, | |
| <span class="tok-string">"Do not guess, infer hidden functionality, invent accessories, or claim compatibility unless it is visible or in the item data."</span>, | |
| <span class="tok-string">"Do not carry over marketing terms from the old title such as vintage, retro, DJ, excellent, rare, or professional unless they are visibly or structurally verified."</span>, | |
| <span class="tok-string">"The SEO title must follow the same factuality rules as the description."</span>, | |
| <span class="tok-string">"If a detail is uncertain, omit it and optionally list it under omittedUncertainClaims."</span>, | |
| <span class="tok-string">"Write neutral, factual English suitable for an eBay listing."</span>, | |
| }, <span class="tok-string">" "</span>) | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">userPrompt</span>(item Inventory, imageCount int) <span class="tok-keyword">string</span> { | |
| source := <span class="tok-keyword">map</span>[<span class="tok-keyword">string</span>]<span class="tok-keyword">any</span>{ | |
| <span class="tok-string">"sourceTitle"</span>: item.Product.Title, | |
| <span class="tok-string">"condition"</span>: <span class="tok-function">nilIfEmpty</span>(item.Condition), | |
| <span class="tok-string">"conditionDescription"</span>: <span class="tok-function">nilIfEmpty</span>(item.ConditionDescription), | |
| <span class="tok-string">"sku"</span>: <span class="tok-function">nilIfEmpty</span>(item.SKU), | |
| <span class="tok-string">"aspects"</span>: item.Product.Aspects, | |
| <span class="tok-string">"imageCount"</span>: imageCount, | |
| } | |
| data, _ := json.<span class="tok-function">MarshalIndent</span>(source, <span class="tok-string">""</span>, <span class="tok-string">" "</span>) | |
| <span class="tok-keyword">return</span> fmt.<span class="tok-function">Sprintf</span>(<span class="tok-string">`Review every attached image and the item data below. | |
| Return a structured result with: | |
| - seoTitle: an English SEO title of 80 characters or fewer, factual only. | |
| - description: 2 to 3 factual sentences, no hype, no unverifiable condition claims. | |
| - visibleFacts: short facts used from the images or item data. | |
| - omittedUncertainClaims: claims you avoided because they were not verifiable. | |
| Item data: | |
| %s`</span>, data) | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">nilIfEmpty</span>(value <span class="tok-keyword">string</span>) <span class="tok-keyword">any</span> { | |
| <span class="tok-keyword">if</span> value == <span class="tok-string">""</span> { | |
| <span class="tok-keyword">return</span> <span class="tok-keyword">nil</span> | |
| } | |
| <span class="tok-keyword">return</span> value | |
| } | |
| <span class="tok-keyword">func</span> <span class="tok-function">writeOutput</span>(path <span class="tok-keyword">string</span>, output RunOutput) { | |
| data, err := json.<span class="tok-function">MarshalIndent</span>(output, <span class="tok-string">""</span>, <span class="tok-string">" "</span>) | |
| <span class="tok-keyword">if</span> err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">if</span> err := os.<span class="tok-function">MkdirAll</span>(filepath.<span class="tok-function">Dir</span>(path), <span class="tok-number">0755</span>); err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| <span class="tok-keyword">if</span> err := os.<span class="tok-function">WriteFile</span>(path, <span class="tok-function">append</span>(data, <span class="tok-string">'\n'</span>), <span class="tok-number">0644</span>); err != <span class="tok-keyword">nil</span> { | |
| log.<span class="tok-function">Fatal</span>(err) | |
| } | |
| fmt.<span class="tok-function">Println</span>(<span class="tok-keyword">string</span>(data)) | |
| }</code></pre> | |
| </details> | |
| </section> | |
| <section> | |
| <h2>Raw Outputs</h2> | |
| <details open> | |
| <summary>Mastra TypeScript output <span class="path">lib-comparison/output/mastra.json</span></summary> | |
| <pre><code class="language-json">{ | |
| <span class="tok-key">"library"</span>: <span class="tok-string">"Mastra TypeScript"</span>, | |
| <span class="tok-key">"model"</span>: <span class="tok-string">"google/gemini-2.5-flash"</span>, | |
| <span class="tok-key">"sourceTitle"</span>: <span class="tok-string">"Sound City DJ Mischpult Stereo Audio Mixer Vintage Retro Kompakt Tragbar"</span>, | |
| <span class="tok-key">"imageCount"</span>: <span class="tok-number">15</span>, | |
| <span class="tok-key">"result"</span>: { | |
| <span class="tok-key">"seoTitle"</span>: <span class="tok-string">"Sound City Multi Function Stereo Audio Mixer 4-Channel Portable Battery Powered"</span>, | |
| <span class="tok-key">"description"</span>: <span class="tok-string">"The Sound City Multi Function Stereo Audio Mixer is a 4-channel portable unit featuring two integrated VU meters. It includes multiple RCA stereo inputs, a 1/4 inch microphone input, and both RCA and 1/4 inch master outputs. The unit is designed for battery operation and is offered in untested as-found condition."</span>, | |
| <span class="tok-key">"visibleFacts"</span>: [ | |
| <span class="tok-string">"Brand: Sound City"</span>, | |
| <span class="tok-string">"Model: Multi Function Stereo Audio Mixer"</span>, | |
| <span class="tok-string">"Product type: Audio Mixer"</span>, | |
| <span class="tok-string">"Form factor: Portable"</span>, | |
| <span class="tok-string">"Channels: 4 (Microphones, Phono, Music, Audio faders)"</span>, | |
| <span class="tok-string">"Microphone inputs: 1 (1/4\" TS input, also L/R RCA input for MIC)"</span>, | |
| <span class="tok-string">"Phono inputs: 4"</span>, | |
| <span class="tok-string">"Line inputs: 8 (Multiple L/R RCA inputs labeled MUSIC, AUDIO, VCR/CAMERA, TAPE ON/TUNE, CD, CER, MAG)"</span>, | |
| <span class="tok-string">"Output connections: Analog RCA/Coaxial Output (L/R RCA labeled OUTPUT), 1/4\" TRS output (MASTER headphone jack)"</span>, | |
| <span class="tok-string">"Input connections: Analog RCA/Coaxial Input (Multiple L/R RCA), 1/4\" TS Input (MIC)"</span>, | |
| <span class="tok-string">"Features: Battery operated (BATTERY TEST button, battery compartment visible), Stereo/Mono mode switch, Power On/Off switch, Panpot control, Two VU meters (Left, Right), Ground screw"</span>, | |
| <span class="tok-string">"Weight: 1562 grams"</span>, | |
| <span class="tok-string">"SKU: 10011850"</span>, | |
| <span class="tok-string">"Condition Note: Untested as-found condition"</span>, | |
| <span class="tok-string">"Suitable for (from item data): Homerecording, Studio/Recording"</span> | |
| ], | |
| <span class="tok-key">"omittedUncertainClaims"</span>: [ | |
| <span class="tok-string">"Vintage"</span>, | |
| <span class="tok-string">"Retro"</span>, | |
| <span class="tok-string">"DJ"</span>, | |
| <span class="tok-string">"Excellent condition"</span>, | |
| <span class="tok-string">"Rare"</span>, | |
| <span class="tok-string">"Professional"</span> | |
| ] | |
| }, | |
| <span class="tok-key">"usage"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">3641</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">8143</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">3641</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">8143</span>, | |
| <span class="tok-key">"reasoningTokens"</span>: <span class="tok-number">3194</span>, | |
| <span class="tok-key">"cachedInputTokens"</span>: <span class="tok-number">0</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: { | |
| <span class="tok-key">"total"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"noCache"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"cacheRead"</span>: <span class="tok-number">0</span> | |
| }, | |
| <span class="tok-key">"outputTokens"</span>: { | |
| <span class="tok-key">"total"</span>: <span class="tok-number">3641</span>, | |
| <span class="tok-key">"text"</span>: <span class="tok-number">447</span>, | |
| <span class="tok-key">"reasoning"</span>: <span class="tok-number">3194</span> | |
| }, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"thoughtsTokenCount"</span>: <span class="tok-number">3194</span>, | |
| <span class="tok-key">"promptTokenCount"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"candidatesTokenCount"</span>: <span class="tok-number">447</span>, | |
| <span class="tok-key">"totalTokenCount"</span>: <span class="tok-number">8143</span>, | |
| <span class="tok-key">"promptTokensDetails"</span>: [ | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"TEXT"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">632</span> | |
| }, | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"IMAGE"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">3870</span> | |
| } | |
| ] | |
| } | |
| } | |
| } | |
| }, | |
| <span class="tok-key">"rawResponse"</span>: { | |
| <span class="tok-key">"finishReason"</span>: <span class="tok-string">"stop"</span>, | |
| <span class="tok-key">"usage"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">3641</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">8143</span>, | |
| <span class="tok-key">"reasoningTokens"</span>: <span class="tok-number">3194</span>, | |
| <span class="tok-key">"cachedInputTokens"</span>: <span class="tok-number">0</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: { | |
| <span class="tok-key">"total"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"noCache"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"cacheRead"</span>: <span class="tok-number">0</span> | |
| }, | |
| <span class="tok-key">"outputTokens"</span>: { | |
| <span class="tok-key">"total"</span>: <span class="tok-number">3641</span>, | |
| <span class="tok-key">"text"</span>: <span class="tok-number">447</span>, | |
| <span class="tok-key">"reasoning"</span>: <span class="tok-number">3194</span> | |
| }, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"thoughtsTokenCount"</span>: <span class="tok-number">3194</span>, | |
| <span class="tok-key">"promptTokenCount"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"candidatesTokenCount"</span>: <span class="tok-number">447</span>, | |
| <span class="tok-key">"totalTokenCount"</span>: <span class="tok-number">8143</span>, | |
| <span class="tok-key">"promptTokensDetails"</span>: [ | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"TEXT"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">632</span> | |
| }, | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"IMAGE"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">3870</span> | |
| } | |
| ] | |
| } | |
| } | |
| }, | |
| <span class="tok-key">"totalUsage"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">3641</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">8143</span>, | |
| <span class="tok-key">"reasoningTokens"</span>: <span class="tok-number">3194</span>, | |
| <span class="tok-key">"cachedInputTokens"</span>: <span class="tok-number">0</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: { | |
| <span class="tok-key">"total"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"noCache"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"cacheRead"</span>: <span class="tok-number">0</span> | |
| }, | |
| <span class="tok-key">"outputTokens"</span>: { | |
| <span class="tok-key">"total"</span>: <span class="tok-number">3641</span>, | |
| <span class="tok-key">"text"</span>: <span class="tok-number">447</span>, | |
| <span class="tok-key">"reasoning"</span>: <span class="tok-number">3194</span> | |
| }, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"thoughtsTokenCount"</span>: <span class="tok-number">3194</span>, | |
| <span class="tok-key">"promptTokenCount"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"candidatesTokenCount"</span>: <span class="tok-number">447</span>, | |
| <span class="tok-key">"totalTokenCount"</span>: <span class="tok-number">8143</span>, | |
| <span class="tok-key">"promptTokensDetails"</span>: [ | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"TEXT"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">632</span> | |
| }, | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"IMAGE"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">3870</span> | |
| } | |
| ] | |
| } | |
| } | |
| } | |
| } | |
| }</code></pre> | |
| </details> | |
| <details open> | |
| <summary>LangChain.js + LangGraph.js output <span class="path">lib-comparison/output/langgraph.json</span></summary> | |
| <pre><code class="language-json">{ | |
| <span class="tok-key">"library"</span>: <span class="tok-string">"LangChain.js + LangGraph.js TypeScript"</span>, | |
| <span class="tok-key">"model"</span>: <span class="tok-string">"gemini-2.5-flash"</span>, | |
| <span class="tok-key">"sourceTitle"</span>: <span class="tok-string">"Sound City DJ Mischpult Stereo Audio Mixer Vintage Retro Kompakt Tragbar"</span>, | |
| <span class="tok-key">"imageCount"</span>: <span class="tok-number">15</span>, | |
| <span class="tok-key">"result"</span>: { | |
| <span class="tok-key">"seoTitle"</span>: <span class="tok-string">"Sound City Multi Function Stereo Audio Mixer Portable 4 Channel Battery Operated"</span>, | |
| <span class="tok-key">"description"</span>: <span class="tok-string">"The Sound City Multi Function Stereo Audio Mixer is a portable, battery-operated unit. It features 4 channels, 4 phono inputs, 8 line inputs, and 1 microphone input. Connections include analog RCA/coaxial inputs and outputs, along with 1/4\" TS and TRS jacks."</span>, | |
| <span class="tok-key">"visibleFacts"</span>: [ | |
| <span class="tok-string">"Sound City brand"</span>, | |
| <span class="tok-string">"Multi Function Stereo Audio Mixer model"</span>, | |
| <span class="tok-string">"Portable form factor"</span>, | |
| <span class="tok-string">"Battery operated feature"</span>, | |
| <span class="tok-string">"4 channels"</span>, | |
| <span class="tok-string">"4 phono inputs"</span>, | |
| <span class="tok-string">"8 line inputs"</span>, | |
| <span class="tok-string">"1 microphone input"</span>, | |
| <span class="tok-string">"Analog RCA/coaxial input and output connections"</span>, | |
| <span class="tok-string">"1/4\" TS input and 1/4\" TRS output connections"</span>, | |
| <span class="tok-string">"Weighs 1562 grams"</span>, | |
| <span class="tok-string">"Two visible VU meters"</span>, | |
| <span class="tok-string">"Five visible faders"</span>, | |
| <span class="tok-string">"Power ON/OFF switch"</span>, | |
| <span class="tok-string">"Stereo/Mono mode switch"</span>, | |
| <span class="tok-string">"Panpot control knob"</span>, | |
| <span class="tok-string">"Battery Test button"</span>, | |
| <span class="tok-string">"1/4\" headphone jack"</span>, | |
| <span class="tok-string">"Ground terminal"</span>, | |
| <span class="tok-string">"Input labels: MAG, CER, CD, TAPE OR TUNER, CAMERA, VCR, PHONO MUSIC, AUDIO"</span>, | |
| <span class="tok-string">"Output label: OUTPUT"</span>, | |
| <span class="tok-string">"SKU 10011850"</span> | |
| ], | |
| <span class="tok-key">"omittedUncertainClaims"</span>: [ | |
| <span class="tok-string">"Vintage"</span>, | |
| <span class="tok-string">"Retro"</span>, | |
| <span class="tok-string">"DJ"</span>, | |
| <span class="tok-string">"Excellent condition"</span>, | |
| <span class="tok-string">"Rare"</span>, | |
| <span class="tok-string">"Professional"</span>, | |
| <span class="tok-string">"Suitable for Homerecording"</span>, | |
| <span class="tok-string">"Suitable for Studio/Recording"</span> | |
| ] | |
| }, | |
| <span class="tok-key">"usage"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4503</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">388</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">5880</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"input_tokens"</span>: <span class="tok-number">4503</span>, | |
| <span class="tok-key">"output_tokens"</span>: <span class="tok-number">388</span>, | |
| <span class="tok-key">"total_tokens"</span>: <span class="tok-number">5880</span> | |
| } | |
| }, | |
| <span class="tok-key">"rawResponse"</span>: { | |
| <span class="tok-key">"response_metadata"</span>: { | |
| <span class="tok-key">"tokenUsage"</span>: { | |
| <span class="tok-key">"promptTokens"</span>: <span class="tok-number">4503</span>, | |
| <span class="tok-key">"completionTokens"</span>: <span class="tok-number">388</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">5880</span> | |
| }, | |
| <span class="tok-key">"finishReason"</span>: <span class="tok-string">"STOP"</span>, | |
| <span class="tok-key">"index"</span>: <span class="tok-number">0</span> | |
| }, | |
| <span class="tok-key">"usage_metadata"</span>: { | |
| <span class="tok-key">"input_tokens"</span>: <span class="tok-number">4503</span>, | |
| <span class="tok-key">"output_tokens"</span>: <span class="tok-number">388</span>, | |
| <span class="tok-key">"total_tokens"</span>: <span class="tok-number">5880</span> | |
| }, | |
| <span class="tok-key">"parsedByLangChain"</span>: <span class="tok-literal">true</span>, | |
| <span class="tok-key">"usedJsonParseFallback"</span>: <span class="tok-literal">false</span> | |
| } | |
| }</code></pre> | |
| </details> | |
| <details open> | |
| <summary>Vercel AI SDK TypeScript output <span class="path">lib-comparison/output/vercel-ai.json</span></summary> | |
| <pre><code class="language-json">{ | |
| <span class="tok-key">"library"</span>: <span class="tok-string">"Vercel AI SDK TypeScript"</span>, | |
| <span class="tok-key">"model"</span>: <span class="tok-string">"google/gemini-2.5-flash"</span>, | |
| <span class="tok-key">"sourceTitle"</span>: <span class="tok-string">"Sound City DJ Mischpult Stereo Audio Mixer Vintage Retro Kompakt Tragbar"</span>, | |
| <span class="tok-key">"imageCount"</span>: <span class="tok-number">15</span>, | |
| <span class="tok-key">"result"</span>: { | |
| <span class="tok-key">"seoTitle"</span>: <span class="tok-string">"Sound City Multi Function Stereo Audio Mixer Portable 4-Channel Battery Operated"</span>, | |
| <span class="tok-key">"description"</span>: <span class="tok-string">"The Sound City Multi Function Stereo Audio Mixer is a portable, 4-channel unit. It features multiple RCA and 1/4\" TS/TRS input/output connections, visible VU meters, and is battery operated. The mixer weighs 1562 grams and is suitable for homerecording or studio/recording use."</span>, | |
| <span class="tok-key">"visibleFacts"</span>: [ | |
| <span class="tok-string">"Brand: Sound City"</span>, | |
| <span class="tok-string">"Model: Multi Function Stereo Audio Mixer"</span>, | |
| <span class="tok-string">"Product Type: Mixer"</span>, | |
| <span class="tok-string">"Form Factor: Portable"</span>, | |
| <span class="tok-string">"Number of Channels: 4"</span>, | |
| <span class="tok-string">"Number of Phono Inputs: 4"</span>, | |
| <span class="tok-string">"Number of Line Inputs: 8"</span>, | |
| <span class="tok-string">"Number of Microphone Inputs: 1"</span>, | |
| <span class="tok-string">"Features: Battery Operated"</span>, | |
| <span class="tok-string">"Input/Output Connections: Analog RCA/Coaxial Input, Analog RCA/Coaxial Output, 1/4\" TS-Input, 1/4\" TRS-Output"</span>, | |
| <span class="tok-string">"Suitable for: Homerecording, Studio/Recording"</span>, | |
| <span class="tok-string">"Weight: 1562 grams"</span>, | |
| <span class="tok-string">"SKU: 10011850"</span>, | |
| <span class="tok-string">"Front panel controls include: Power switch (ON/OFF), Mode switch (STEREO/MONO), Panpot knob, Battery Test button, 5 faders (Microphones, Phono, Music, Audio, Master), Output VU meters (LEFT/RIGHT), Monitor output jack, Headphone jack."</span>, | |
| <span class="tok-string">"Rear panel connections include: Power input, Output RCA (L/R), Audio RCA (L/R), Music RCA (L/R), Phono RCA (L/R), Mic 1/4\" TS input, Ground terminal."</span>, | |
| <span class="tok-string">"Input labels visible on front panel: CD, VCR, CAMCORDER, MAG, CER, CD, TAPE OR TUNER, CAMERA, VCR, PHONO, AUDIO, MUSIC."</span> | |
| ], | |
| <span class="tok-key">"omittedUncertainClaims"</span>: [ | |
| <span class="tok-string">"Vintage"</span>, | |
| <span class="tok-string">"Retro"</span>, | |
| <span class="tok-string">"DJ"</span>, | |
| <span class="tok-string">"Excellent"</span>, | |
| <span class="tok-string">"Rare"</span>, | |
| <span class="tok-string">"Professional"</span>, | |
| <span class="tok-string">"Ungeprüftem Auffindungszustand (untested condition)"</span> | |
| ] | |
| }, | |
| <span class="tok-key">"usage"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">2081</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">6583</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"inputTokenDetails"</span>: { | |
| <span class="tok-key">"noCacheTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"cacheReadTokens"</span>: <span class="tok-number">0</span> | |
| }, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">2081</span>, | |
| <span class="tok-key">"outputTokenDetails"</span>: { | |
| <span class="tok-key">"textTokens"</span>: <span class="tok-number">500</span>, | |
| <span class="tok-key">"reasoningTokens"</span>: <span class="tok-number">1581</span> | |
| }, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">6583</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"thoughtsTokenCount"</span>: <span class="tok-number">1581</span>, | |
| <span class="tok-key">"promptTokenCount"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"candidatesTokenCount"</span>: <span class="tok-number">500</span>, | |
| <span class="tok-key">"totalTokenCount"</span>: <span class="tok-number">6583</span>, | |
| <span class="tok-key">"serviceTier"</span>: <span class="tok-string">"standard"</span>, | |
| <span class="tok-key">"promptTokensDetails"</span>: [ | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"TEXT"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">632</span> | |
| }, | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"IMAGE"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">3870</span> | |
| } | |
| ] | |
| } | |
| } | |
| }, | |
| <span class="tok-key">"rawResponse"</span>: { | |
| <span class="tok-key">"finishReason"</span>: <span class="tok-string">"stop"</span>, | |
| <span class="tok-key">"usage"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"inputTokenDetails"</span>: { | |
| <span class="tok-key">"noCacheTokens"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"cacheReadTokens"</span>: <span class="tok-number">0</span> | |
| }, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">2081</span>, | |
| <span class="tok-key">"outputTokenDetails"</span>: { | |
| <span class="tok-key">"textTokens"</span>: <span class="tok-number">500</span>, | |
| <span class="tok-key">"reasoningTokens"</span>: <span class="tok-number">1581</span> | |
| }, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">6583</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"thoughtsTokenCount"</span>: <span class="tok-number">1581</span>, | |
| <span class="tok-key">"promptTokenCount"</span>: <span class="tok-number">4502</span>, | |
| <span class="tok-key">"candidatesTokenCount"</span>: <span class="tok-number">500</span>, | |
| <span class="tok-key">"totalTokenCount"</span>: <span class="tok-number">6583</span>, | |
| <span class="tok-key">"serviceTier"</span>: <span class="tok-string">"standard"</span>, | |
| <span class="tok-key">"promptTokensDetails"</span>: [ | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"TEXT"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">632</span> | |
| }, | |
| { | |
| <span class="tok-key">"modality"</span>: <span class="tok-string">"IMAGE"</span>, | |
| <span class="tok-key">"tokenCount"</span>: <span class="tok-number">3870</span> | |
| } | |
| ] | |
| } | |
| }, | |
| <span class="tok-key">"warnings"</span>: [] | |
| } | |
| }</code></pre> | |
| </details> | |
| <details open> | |
| <summary>Eino Go output <span class="path">lib-comparison/output/eino.json</span></summary> | |
| <pre><code class="language-json">{ | |
| <span class="tok-key">"library"</span>: <span class="tok-string">"Eino Go"</span>, | |
| <span class="tok-key">"model"</span>: <span class="tok-string">"gemini-2.5-flash"</span>, | |
| <span class="tok-key">"sourceTitle"</span>: <span class="tok-string">"Sound City DJ Mischpult Stereo Audio Mixer Vintage Retro Kompakt Tragbar"</span>, | |
| <span class="tok-key">"imageCount"</span>: <span class="tok-number">15</span>, | |
| <span class="tok-key">"result"</span>: { | |
| <span class="tok-key">"seoTitle"</span>: <span class="tok-string">"Sound City Multi Function Stereo Audio Mixer 4 Channel Portable"</span>, | |
| <span class="tok-key">"description"</span>: <span class="tok-string">"The Sound City Multi Function Stereo Audio Mixer is a 4-channel portable mixing console. It features two VU meters, five faders, and a panpot control. Connectivity includes multiple RCA inputs and outputs, a 1/4\" microphone input, and a 1/4\" master output. The unit is battery-operated and weighs 1562 grams."</span>, | |
| <span class="tok-key">"visibleFacts"</span>: [ | |
| <span class="tok-string">"Sound City brand"</span>, | |
| <span class="tok-string">"Multi Function Stereo Audio Mixer model"</span>, | |
| <span class="tok-string">"Black casing with orange lettering"</span>, | |
| <span class="tok-string">"Features a power ON/OFF switch"</span>, | |
| <span class="tok-string">"Includes a STEREO/MONO mode switch"</span>, | |
| <span class="tok-string">"Equipped with a BATTERY TEST button"</span>, | |
| <span class="tok-string">"Two VU meters for Left and Right output"</span>, | |
| <span class="tok-string">"Five faders labeled Microphones, Phono, Music, Audio, and Master"</span>, | |
| <span class="tok-string">"One Panpot knob"</span>, | |
| <span class="tok-string">"Rear panel includes RCA L/R outputs labeled OUTPUT, AUDIO, MUSIC, PHONO"</span>, | |
| <span class="tok-string">"Rear panel includes RCA L/R inputs labeled VCR, CAMERA, TAPE OR TUNER, CD, CER, MAG"</span>, | |
| <span class="tok-string">"One 1/4\" TS microphone input with a ground screw terminal"</span>, | |
| <span class="tok-string">"One 1/4\" TRS master output jack"</span>, | |
| <span class="tok-string">"DC power input jack visible on the rear panel"</span>, | |
| <span class="tok-string">"Battery compartment cover visible on the bottom panel"</span>, | |
| <span class="tok-string">"Portable form factor"</span>, | |
| <span class="tok-string">"Weight: 1562 grams"</span>, | |
| <span class="tok-string">"4 channels"</span>, | |
| <span class="tok-string">"8 line inputs"</span>, | |
| <span class="tok-string">"1 microphone input"</span>, | |
| <span class="tok-string">"4 phono inputs"</span>, | |
| <span class="tok-string">"Battery-operated"</span> | |
| ], | |
| <span class="tok-key">"omittedUncertainClaims"</span>: [ | |
| <span class="tok-string">"DJ mixer"</span>, | |
| <span class="tok-string">"Vintage"</span>, | |
| <span class="tok-string">"Retro"</span>, | |
| <span class="tok-string">"Excellent condition"</span>, | |
| <span class="tok-string">"Compact"</span> | |
| ] | |
| }, | |
| <span class="tok-key">"usage"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4504</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">1805</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">6309</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"prompt_tokens"</span>: <span class="tok-number">4504</span>, | |
| <span class="tok-key">"prompt_token_details"</span>: { | |
| <span class="tok-key">"cached_tokens"</span>: <span class="tok-number">0</span> | |
| }, | |
| <span class="tok-key">"completion_tokens"</span>: <span class="tok-number">1805</span>, | |
| <span class="tok-key">"total_tokens"</span>: <span class="tok-number">6309</span>, | |
| <span class="tok-key">"completion_token_details"</span>: { | |
| <span class="tok-key">"reasoning_tokens"</span>: <span class="tok-number">1388</span> | |
| } | |
| } | |
| }, | |
| <span class="tok-key">"rawResponse"</span>: { | |
| <span class="tok-key">"content"</span>: <span class="tok-string">"{\n \"description\": \"The Sound City Multi Function Stereo Audio Mixer is a 4-channel portable mixing console. It features two VU meters, five faders, and a panpot control. Connectivity includes multiple RCA inputs and outputs, a 1/4\\\" microphone input, and a 1/4\\\" master output. The unit is battery-operated and weighs 1562 grams.\",\n \"omittedUncertainClaims\": [\n \"DJ mixer\",\n \"Vintage\",\n \"Retro\",\n \"Excellent condition\",\n \"Compact\"\n ],\n \"seoTitle\": \"Sound City Multi Function Stereo Audio Mixer 4 Channel Portable\",\n \"visibleFacts\": [\n \"Sound City brand\",\n \"Multi Function Stereo Audio Mixer model\",\n \"Black casing with orange lettering\",\n \"Features a power ON/OFF switch\",\n \"Includes a STEREO/MONO mode switch\",\n \"Equipped with a BATTERY TEST button\",\n \"Two VU meters for Left and Right output\",\n \"Five faders labeled Microphones, Phono, Music, Audio, and Master\",\n \"One Panpot knob\",\n \"Rear panel includes RCA L/R outputs labeled OUTPUT, AUDIO, MUSIC, PHONO\",\n \"Rear panel includes RCA L/R inputs labeled VCR, CAMERA, TAPE OR TUNER, CD, CER, MAG\",\n \"One 1/4\\\" TS microphone input with a ground screw terminal\",\n \"One 1/4\\\" TRS master output jack\",\n \"DC power input jack visible on the rear panel\",\n \"Battery compartment cover visible on the bottom panel\",\n \"Portable form factor\",\n \"Weight: 1562 grams\",\n \"4 channels\",\n \"8 line inputs\",\n \"1 microphone input\",\n \"4 phono inputs\",\n \"Battery-operated\"\n ]\n}"</span>, | |
| <span class="tok-key">"finishReason"</span>: <span class="tok-string">"STOP"</span> | |
| } | |
| }</code></pre> | |
| </details> | |
| <details open> | |
| <summary>Genkit Go output <span class="path">lib-comparison/output/genkit.json</span></summary> | |
| <pre><code class="language-json">{ | |
| <span class="tok-key">"library"</span>: <span class="tok-string">"Genkit Go"</span>, | |
| <span class="tok-key">"model"</span>: <span class="tok-string">"googleai/gemini-2.5-flash"</span>, | |
| <span class="tok-key">"sourceTitle"</span>: <span class="tok-string">"Sound City DJ Mischpult Stereo Audio Mixer Vintage Retro Kompakt Tragbar"</span>, | |
| <span class="tok-key">"imageCount"</span>: <span class="tok-number">15</span>, | |
| <span class="tok-key">"result"</span>: { | |
| <span class="tok-key">"seoTitle"</span>: <span class="tok-string">"Sound City Multi Function Stereo Audio Mixer Portable 4-Channel Battery Operated"</span>, | |
| <span class="tok-key">"description"</span>: <span class="tok-string">"This Sound City Multi Function Stereo Audio Mixer is a portable, 4-channel mixing console. It features 8 line inputs, 1 microphone input, and 4 phono inputs, with analog RCA/coaxial and 1/4\" TS/TRS input/output connections. The unit is designed to be battery-operated and weighs 1562 grams."</span>, | |
| <span class="tok-key">"visibleFacts"</span>: [ | |
| <span class="tok-string">"Brand: Sound City"</span>, | |
| <span class="tok-string">"Model: Multi Function Stereo Audio Mixer"</span>, | |
| <span class="tok-string">"Product Type: Mischpult (Mixing Console)"</span>, | |
| <span class="tok-string">"Form Factor: Tragbar (Portable)"</span>, | |
| <span class="tok-string">"Anzahl der Kanäle: 4 (4 Channels)"</span>, | |
| <span class="tok-string">"Anzahl der Line-Eingänge: 8 (8 Line Inputs)"</span>, | |
| <span class="tok-string">"Anzahl der Mikrofoneingänge: 1 (1 Microphone Input)"</span>, | |
| <span class="tok-string">"Anzahl der Phonoeingänge: 4 (4 Phono Inputs)"</span>, | |
| <span class="tok-string">"Besonderheiten: Batteriebetrieben (Battery-operated)"</span>, | |
| <span class="tok-string">"Gewicht: 1562 Gramm (1562 Grams)"</span>, | |
| <span class="tok-string">"Ein-/Ausgangsanschlüsse: Analoger RCA/Koaxial-Eingang, Analoger RCA/Koaxial-Ausgang, 1/4\" TS-Eingang, 1/4\" TRS-Ausgang (Analog RCA/Coaxial Input/Output, 1/4\" TS Input, 1/4\" TRS Output)"</span>, | |
| <span class="tok-string">"Geeignet für: Homerecording, Studio/Aufnahme (Suitable for Home recording, Studio/Recording)"</span>, | |
| <span class="tok-string">"Front panel controls: Power switch, Mode switch (Stereo/Mono), Panpot knob, 5 sliders (Microphones, Phono, Music, Audio, Master), Input selector switches (MAG, CER, CD, TAPE OR TUNER, CAMERA, VCR, PHONO, AUDIO MUSIC), Battery Test button, 2 VU meters (Left, Right), Monitor headphones output (1/4\" jack)"</span>, | |
| <span class="tok-string">"Rear panel connections: Power input, 8 RCA input pairs (CD, VCR, Camera, Tape, Phono, Mic, Aux), 2 RCA output pairs (Audio, Output), 1/4\" microphone input, Ground terminal"</span>, | |
| <span class="tok-string">"Bottom panel: Battery compartment cover, 6 rubber feet"</span>, | |
| <span class="tok-string">"SKU: 10011850"</span> | |
| ], | |
| <span class="tok-key">"omittedUncertainClaims"</span>: [ | |
| <span class="tok-string">"Vintage"</span>, | |
| <span class="tok-string">"Retro"</span>, | |
| <span class="tok-string">"DJ"</span>, | |
| <span class="tok-string">"Excellent (condition term contradicted by 'ungeprüftem Auffindungszustand' - untested as found)"</span>, | |
| <span class="tok-string">"Rare"</span>, | |
| <span class="tok-string">"Professional"</span> | |
| ] | |
| }, | |
| <span class="tok-key">"usage"</span>: { | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4504</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">606</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">6974</span>, | |
| <span class="tok-key">"raw"</span>: { | |
| <span class="tok-key">"inputCharacters"</span>: <span class="tok-number">1894231</span>, | |
| <span class="tok-key">"inputImages"</span>: <span class="tok-number">15</span>, | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4504</span>, | |
| <span class="tok-key">"outputCharacters"</span>: <span class="tok-number">1984</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">606</span>, | |
| <span class="tok-key">"thoughtsTokens"</span>: <span class="tok-number">1864</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">6974</span> | |
| } | |
| }, | |
| <span class="tok-key">"rawResponse"</span>: { | |
| <span class="tok-key">"finishMessage"</span>: <span class="tok-string">""</span>, | |
| <span class="tok-key">"finishReason"</span>: <span class="tok-string">"stop"</span>, | |
| <span class="tok-key">"usage"</span>: { | |
| <span class="tok-key">"inputCharacters"</span>: <span class="tok-number">1894231</span>, | |
| <span class="tok-key">"inputImages"</span>: <span class="tok-number">15</span>, | |
| <span class="tok-key">"inputTokens"</span>: <span class="tok-number">4504</span>, | |
| <span class="tok-key">"outputCharacters"</span>: <span class="tok-number">1984</span>, | |
| <span class="tok-key">"outputTokens"</span>: <span class="tok-number">606</span>, | |
| <span class="tok-key">"thoughtsTokens"</span>: <span class="tok-number">1864</span>, | |
| <span class="tok-key">"totalTokens"</span>: <span class="tok-number">6974</span> | |
| } | |
| } | |
| }</code></pre> | |
| </details> | |
| </section> | |
| <section> | |
| <h2>Decision Guide</h2> | |
| <div class="table-wrap"> | |
| <table> | |
| <caption>Pragmatic selection by architecture goal.</caption> | |
| <thead> | |
| <tr> | |
| <th>Goal</th> | |
| <th>Best Choice</th> | |
| <th>Alternative</th> | |
| <th>Reasoning</th> | |
| </tr> | |
| </thead> | |
| <tbody> | |
| <tr> | |
| <th>Replace PydanticAI in TypeScript</th> | |
| <td>Mastra</td> | |
| <td>LangChain.js + LangGraph.js</td> | |
| <td>Mastra provides the most complete TS framework package; LangGraph is worth it for complex orchestration.</td> | |
| </tr> | |
| <tr> | |
| <th>Stateful, long-running agent workflows</th> | |
| <td>LangChain.js + LangGraph.js</td> | |
| <td>Mastra Durable Agents</td> | |
| <td>LangGraph is strongest for persistence, replay, interrupts and graph control.</td> | |
| </tr> | |
| <tr> | |
| <th>Go-native agentic systems</th> | |
| <td>Eino</td> | |
| <td>Genkit Go</td> | |
| <td>Eino is more focused on ADK, multi-agent and graph/agent composition.</td> | |
| </tr> | |
| <tr> | |
| <th>Go with typed structured output and flows</th> | |
| <td>Genkit Go</td> | |
| <td>Eino</td> | |
| <td>Genkit fits better when Go structs, schemas, flows and Developer UI matter more than autonomous orchestration.</td> | |
| </tr> | |
| <tr> | |
| <th>Cross-language TS + Go</th> | |
| <td>Genkit</td> | |
| <td>Mastra + Eino separately</td> | |
| <td>Genkit offers JS/TS and Go with a shared conceptual API. Mastra/Eino are stronger separately, but separate worlds.</td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| </div> | |
| </section> | |
| <section> | |
| <h2>Repos And Evidence Base</h2> | |
| <div class="table-wrap"> | |
| <table> | |
| <caption>Local clone commits and fresh star counts from the GitHub API.</caption> | |
| <thead> | |
| <tr> | |
| <th>Project</th> | |
| <th>Language</th> | |
| <th>Repo</th> | |
| <th>Commit</th> | |
| <th>Stars</th> | |
| <th>Role In Analysis</th> | |
| </tr> | |
| </thead> | |
| <tbody> | |
| <tr> | |
| <th>PydanticAI</th> | |
| <td>Python</td> | |
| <td><a href="https://github.com/pydantic/pydantic-ai">pydantic/pydantic-ai</a></td> | |
| <td><span class="repo">e558325</span></td> | |
| <td class="stars">18,002</td> | |
| <td>Baseline: type-first Agent API, Pydantic validation, deps, tools, evals and observability.</td> | |
| </tr> | |
| <tr> | |
| <th>Mastra</th> | |
| <td>TypeScript</td> | |
| <td><a href="https://github.com/mastra-ai/mastra">mastra-ai/mastra</a></td> | |
| <td><span class="repo">023766f</span></td> | |
| <td class="stars">25,455</td> | |
| <td>Top TypeScript candidate for framework parity.</td> | |
| </tr> | |
| <tr> | |
| <th>LangChain.js</th> | |
| <td>TypeScript</td> | |
| <td><a href="https://github.com/langchain-ai/langchainjs">langchain-ai/langchainjs</a></td> | |
| <td><span class="repo">f1d64ff</span></td> | |
| <td class="stars">17,851</td> | |
| <td>Provider, tool and integration layer for LangGraph agents.</td> | |
| </tr> | |
| <tr> | |
| <th>LangGraph.js</th> | |
| <td>TypeScript</td> | |
| <td><a href="https://github.com/langchain-ai/langgraphjs">langchain-ai/langgraphjs</a></td> | |
| <td><span class="repo">82e07d0</span></td> | |
| <td class="stars">3,043</td> | |
| <td>Top TypeScript candidate for durable, stateful agent orchestration.</td> | |
| </tr> | |
| <tr> | |
| <th>Eino</th> | |
| <td>Go</td> | |
| <td><a href="https://github.com/cloudwego/eino">cloudwego/eino</a></td> | |
| <td><span class="repo">0abcc82</span></td> | |
| <td class="stars">11,970</td> | |
| <td>Top Go candidate for agentic systems.</td> | |
| </tr> | |
| <tr> | |
| <th>Genkit</th> | |
| <td>Go / TypeScript</td> | |
| <td><a href="https://github.com/genkit-ai/genkit">genkit-ai/genkit</a></td> | |
| <td><span class="repo">4f78d0d</span></td> | |
| <td class="stars">6,139</td> | |
| <td>Top Go candidate for typed structured output, flows, Dev UI and cross-language parity.</td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| </div> | |
| <p class="small"> | |
| Not selected for the top 2: Vercel AI SDK, because it is an excellent provider-agnostic TypeScript SDK, | |
| but less of a complete PydanticAI replacement with workflows, evals and observability in one framework. | |
| LangChainGo was rated below Eino and Genkit Go for feature parity. | |
| </p> | |
| </section> | |
| </main> | |
| <script> | |
| (() => { | |
| const htmlEscape = (value) => String(value) | |
| .replaceAll("&", "&") | |
| .replaceAll("<", "<") | |
| .replaceAll(">", ">"); | |
| const wrap = (className, value) => '<span class="' + className + '">' + htmlEscape(value) + '</span>'; | |
| const tsKeywords = new Set("abstract as async await boolean break case catch class const constructor continue declare default delete do else enum export extends false finally for from function get if implements import in infer instanceof interface keyof let module namespace new null number of package private protected public readonly return satisfies set static string super switch symbol this throw true try type typeof undefined unknown var void while with yield".split(" ")); | |
| const goKeywords = new Set("any bool break case chan const continue default defer else fallthrough false for func go goto if import interface iota map nil package range return select string struct switch true type var".split(" ")); | |
| const literals = new Set("true false null undefined nil iota".split(" ")); | |
| function highlightJson(code) { | |
| const pattern = /"(?:\\.|[^"\\])*"|-?\b\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b|\b(?:true|false|null)\b/g; | |
| let html = ""; | |
| let last = 0; | |
| code.replace(pattern, (match, offset) => { | |
| html += htmlEscape(code.slice(last, offset)); | |
| const rest = code.slice(offset + match.length); | |
| if (match.startsWith('"')) { | |
| html += /^\s*:/.test(rest) ? wrap("tok-key", match) : wrap("tok-string", match); | |
| } else if (/^-?\d/.test(match)) { | |
| html += wrap("tok-number", match); | |
| } else { | |
| html += wrap("tok-literal", match); | |
| } | |
| last = offset + match.length; | |
| return match; | |
| }); | |
| return html + htmlEscape(code.slice(last)); | |
| } | |
| function highlightCode(code, keywords) { | |
| const pattern = /(?:\/\/[^\n]*|\/\*[\s\S]*?\*\/|"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\x60[\s\S]*?\x60|\b\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b|\b[A-Za-z_]\w*(?=\s*\()|\b[A-Za-z_]\w*\b)/g; | |
| let html = ""; | |
| let last = 0; | |
| code.replace(pattern, (match, offset) => { | |
| html += htmlEscape(code.slice(last, offset)); | |
| const first = match[0]; | |
| const rest = code.slice(offset + match.length); | |
| if (match.startsWith("//") || match.startsWith("/*")) { | |
| html += wrap("tok-comment", match); | |
| } else if (first === '"' || first === "'" || first.charCodeAt(0) === 96) { | |
| html += wrap("tok-string", match); | |
| } else if (/^\d/.test(match)) { | |
| html += wrap("tok-number", match); | |
| } else if (keywords.has(match)) { | |
| html += wrap("tok-keyword", match); | |
| } else if (literals.has(match)) { | |
| html += wrap("tok-literal", match); | |
| } else if (/^\s*\(/.test(rest)) { | |
| html += wrap("tok-function", match); | |
| } else { | |
| html += htmlEscape(match); | |
| } | |
| last = offset + match.length; | |
| return match; | |
| }); | |
| return html + htmlEscape(code.slice(last)); | |
| } | |
| document.querySelectorAll('pre code[class*="language-"]').forEach((block) => { | |
| const code = block.textContent || ""; | |
| const className = block.className || ""; | |
| if (className.includes("language-json")) { | |
| block.innerHTML = highlightJson(code); | |
| } else if (className.includes("language-go")) { | |
| block.innerHTML = highlightCode(code, goKeywords); | |
| } else { | |
| block.innerHTML = highlightCode(code, tsKeywords); | |
| } | |
| }); | |
| })(); | |
| </script> | |
| </body> | |
| </html> |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment