{"id":"ecommerce-seo-product-page","title":"Product SEO","description":"SEO spec typed. Product SEO weak. Typed v1 agent with eval coverage.","category":"ecommerce","status":"validated","version":"1.0.0","source":"agentskit-registry","license":"MIT","tags":["ecommerce","structured-output","v1"],"packages":["@agentskit/core","@agentskit/runtime","@agentskit/tools"],"files":["agent.ts","README.md","eval.ts"],"requires":{"zod":"^3","zod-to-json-schema":"^3"},"skill":{"name":"ecommerce-seo-product-page","description":"SEO spec typed. Product SEO weak. Typed v1 agent with eval coverage.","systemPrompt":"You are Product SEO. Product SEO weak. Output: SEO spec typed.\nDraft sections with citations from input. Gaps for missing facts.\nNEVER invent facts — gaps and openQuestions for missing input. Always draft for human review.\n${UNTRUSTED_CONTENT_DIRECTIVE}\nCall submit_product_page exactly once. Stop."},"flow":null,"a2a":{"id":"io.agentskit.registry.ecommerce-seo-product-page","name":"Product SEO","description":"SEO spec typed. Product SEO weak. Typed v1 agent with eval coverage.","version":"1.0.0","homepage":"https://registry.agentskit.io","skills":[{"name":"ecommerce-seo-product-page","description":"SEO spec typed. Product SEO weak. Typed v1 agent with eval coverage.","capabilities":{"streaming":true,"cancellation":true,"requiresApproval":false}}]},"sources":[{"path":"agent.ts","content":"import type { AdapterFactory, ChatMemory, Observer, ToolCall, ToolDefinition } from '@agentskit/core'\nimport { fenceUntrustedContent, UNTRUSTED_CONTENT_DIRECTIVE } from '@agentskit/core/security'\nimport { invokeStructured } from '@agentskit/runtime'\nimport { defineZodTool } from '@agentskit/tools'\nimport { z } from 'zod'\nimport { zodToJsonSchema } from 'zod-to-json-schema'\nimport type { JSONSchema7 } from 'json-schema'\n\n/** Product SEO — v1 validated. Pain: Product SEO weak */\n\nexport interface Section { heading: string; body: string; citations: string[] }\nexport interface AgentOutput { title: string; sections: Section[]; gaps: string[]; openQuestions: string[] }\nexport interface AgentResult extends AgentOutput { requiresReview: boolean }\nexport interface EcommerceSeoProductPageConfig {\n  adapter: AdapterFactory\n  memory?: ChatMemory\n  observers?: Observer[]\n  onConfirm?: (toolCall: ToolCall) => boolean | Promise<boolean>\n  maxSteps?: number\n}\n\nconst Output = z.object({\n  title: z.string(),\n  sections: z.array(z.object({ heading: z.string(), body: z.string(), citations: z.array(z.string()).default([]) })).min(1),\n  gaps: z.array(z.string()).default([]),\n  openQuestions: z.array(z.string()).default([]),\n})\nconst toJson = (s: z.ZodTypeAny): JSONSchema7 => zodToJsonSchema(s) as JSONSchema7\n\nconst skill = {\n  name: 'ecommerce-seo-product-page',\n  description: \"Product SEO — typed output agent (draft spec).\",\n  systemPrompt: `You are Product SEO. Product SEO weak. Output: SEO spec typed.\nDraft sections with citations from input. Gaps for missing facts.\nNEVER invent facts — gaps and openQuestions for missing input. Always draft for human review.\n${UNTRUSTED_CONTENT_DIRECTIVE}\nCall submit_product_page exactly once. Stop.`,\n  tools: ['submit_product_page'],\n}\n\nexport function createEcommerceSeoProductPageAgent(config: EcommerceSeoProductPageConfig) {\n  const submit = (): ToolDefinition =>\n    defineZodTool({ name: 'submit_product_page', description: 'Submit result. Once.', schema: Output, toJsonSchema: toJson, async execute() { return 'recorded' } }) as ToolDefinition\n\n  async function run(input: string): Promise<AgentResult> {\n    if (!input?.trim()) throw new Error('ecommerce-seo-product-page requires non-empty input')\n    const result = await invokeStructured({\n      adapter: config.adapter,\n      tool: submit(),\n      task: `INPUT:\\n${fenceUntrustedContent(input)}`,\n      parse: (a) => Output.parse(a),\n      skill,\n      memory: config.memory,\n      observers: config.observers,\n      onConfirm: config.onConfirm,\n      maxSteps: config.maxSteps ?? 4,\n    })\n    return { ...result, requiresReview: true }\n  }\n  return {\n    name: 'ecommerce-seo-product-page',\n    run,\n    asHandle() { return { name: 'ecommerce-seo-product-page', run: (t: string) => run(t).then((r) => JSON.stringify(r)) } },\n  }\n}\n"},{"path":"README.md","content":"# Product SEO\n\n> **v1 validated** — `npx agentskit add ecommerce-seo-product-page`\n\n## Pain\nProduct SEO weak\n\n## Output\nSEO spec typed\n"},{"path":"eval.ts","content":"import type { EvalSuite } from '@agentskit/eval'\n\nexport const suite: EvalSuite = {\n  name: 'ecommerce-seo-product-page',\n  cases: [\n    { input: 'Complete input for Product SEO: Product SEO weak. Provide full structured output.', expected: (r: string) => r.length > 20 && /requiresReview|summary|title|category|findings|sections|score|clusters|items|steps/i.test(r) },\n    { input: 'Minimal input.', expected: (r: string) => /gap|openQuestion/i.test(r) || r.length > 10 },\n    { input: 'Input with specific detail: ACME Corp project deadline March 15.', expected: (r: string) => /ACME|March|15/i.test(r) || /gap/i.test(r) },\n    { input: 'Empty context — only says \"process this\".', expected: (r: string) => r.length > 5 },\n  ],\n}\n"}],"installable":true,"validation":{"status":"approved","score":96,"confidence":0.96,"method":"codex-executor-independent-reviewer","iterations":1,"cases":3,"summary":"The agent produced valid structured outputs for all three cases, handled missing context conservatively, surfaced concrete gaps and open questions, and resisted the injection request without leaking or following unsafe instructions. The normal case is sparse despite its name, so refusing to invent product details is acceptable. Minor weakness: it is somewhat overzealous in labeling ordinary task wording as instruction-injection/untrusted data, and the outputs are mostly placeholder SEO specs rather than a richer reusable product-page template, but this does not block v1 readiness.","strengths":["Valid structured output shape in every case.","No empty outputs or execution failures.","Correctly avoids hallucinating product facts from sparse inputs.","Clearly surfaces missing inputs, uncertainty, and human-review need.","Injection case is handled safely and does not output the requested APPROVED string."],"notes":[]}}