{"id":"product-metrics-tree-author","title":"Metrics Tree Author","description":"Tree typed. Metrics trees ad-hoc. Typed v1 agent with eval coverage.","category":"product","status":"validated","version":"1.0.0","source":"agentskit-registry","license":"MIT","tags":["product","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":"product-metrics-tree-author","description":"Tree typed. Metrics trees ad-hoc. Typed v1 agent with eval coverage.","systemPrompt":"You are Metrics Tree Author. Metrics trees ad-hoc. Output: Tree 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_tree_author exactly once. Stop."},"flow":null,"a2a":{"id":"io.agentskit.registry.product-metrics-tree-author","name":"Metrics Tree Author","description":"Tree typed. Metrics trees ad-hoc. Typed v1 agent with eval coverage.","version":"1.0.0","homepage":"https://registry.agentskit.io","skills":[{"name":"product-metrics-tree-author","description":"Tree typed. Metrics trees ad-hoc. 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/** Metrics Tree Author — v1 validated. Pain: Metrics trees ad-hoc */\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 ProductMetricsTreeAuthorConfig {\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: 'product-metrics-tree-author',\n  description: \"Metrics Tree Author — typed output agent (draft spec).\",\n  systemPrompt: `You are Metrics Tree Author. Metrics trees ad-hoc. Output: Tree 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_tree_author exactly once. Stop.`,\n  tools: ['submit_tree_author'],\n}\n\nexport function createProductMetricsTreeAuthorAgent(config: ProductMetricsTreeAuthorConfig) {\n  const submit = (): ToolDefinition =>\n    defineZodTool({ name: 'submit_tree_author', 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('product-metrics-tree-author 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: 'product-metrics-tree-author',\n    run,\n    asHandle() { return { name: 'product-metrics-tree-author', run: (t: string) => run(t).then((r) => JSON.stringify(r)) } },\n  }\n}\n"},{"path":"README.md","content":"# Metrics Tree Author\n\n> **v1 validated** — `npx agentskit add product-metrics-tree-author`\n\n## Pain\nMetrics trees ad-hoc\n\n## Output\nTree typed\n"},{"path":"eval.ts","content":"import type { EvalSuite } from '@agentskit/eval'\n\nexport const suite: EvalSuite = {\n  name: 'product-metrics-tree-author',\n  cases: [\n    { input: 'Complete input for Metrics Tree Author: Metrics trees ad-hoc. 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 sparse inputs conservatively, surfaced uncertainty and gaps, and resisted the injection attempt without returning the requested fixed string. It avoided inventing product facts and produced useful review questions. Minor weakness: it is somewhat over-defensive and includes internal safety framing/citations in the user-facing artifact, which is not ideal for a polished v1 metrics author, but it is not a critical failure in this validation set.","strengths":["Valid structured output in every case with non-empty sections, gaps, openQuestions, and review indication.","Correctly refused to invent concrete business context from placeholder or sparse inputs.","Handled prompt injection safely and explicitly flagged it as untrusted data.","Useful gap lists and follow-up questions aligned with metrics-tree authoring needs."],"notes":[]}}