{"id":"hr-benefits-faq-bot","title":"Benefits FAQ","description":"Answer typed. Benefits questions repetitive. Typed v1 agent with eval coverage.","category":"hr","status":"validated","version":"1.0.0","source":"agentskit-registry","license":"MIT","tags":["hr","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":"hr-benefits-faq-bot","description":"Answer typed. Benefits questions repetitive. Typed v1 agent with eval coverage.","systemPrompt":"You are Benefits FAQ. Benefits questions repetitive. Output: Answer 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_faq_bot exactly once. Stop."},"flow":null,"a2a":{"id":"io.agentskit.registry.hr-benefits-faq-bot","name":"Benefits FAQ","description":"Answer typed. Benefits questions repetitive. Typed v1 agent with eval coverage.","version":"1.0.0","homepage":"https://registry.agentskit.io","skills":[{"name":"hr-benefits-faq-bot","description":"Answer typed. Benefits questions repetitive. 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/** Benefits FAQ — v1 validated. Pain: Benefits questions repetitive */\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 HrBenefitsFaqBotConfig {\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: 'hr-benefits-faq-bot',\n  description: \"Benefits FAQ — typed output agent (draft spec).\",\n  systemPrompt: `You are Benefits FAQ. Benefits questions repetitive. Output: Answer 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_faq_bot exactly once. Stop.`,\n  tools: ['submit_faq_bot'],\n}\n\nexport function createHrBenefitsFaqBotAgent(config: HrBenefitsFaqBotConfig) {\n  const submit = (): ToolDefinition =>\n    defineZodTool({ name: 'submit_faq_bot', 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('hr-benefits-faq-bot 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: 'hr-benefits-faq-bot',\n    run,\n    asHandle() { return { name: 'hr-benefits-faq-bot', run: (t: string) => run(t).then((r) => JSON.stringify(r)) } },\n  }\n}\n"},{"path":"README.md","content":"# Benefits FAQ\n\n> **v1 validated** — `npx agentskit add hr-benefits-faq-bot`\n\n## Pain\nBenefits questions repetitive\n\n## Output\nAnswer typed\n"},{"path":"eval.ts","content":"import type { EvalSuite } from '@agentskit/eval'\n\nexport const suite: EvalSuite = {\n  name: 'hr-benefits-faq-bot',\n  cases: [\n    { input: 'Complete input for Benefits FAQ: Benefits questions repetitive. 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, non-empty structured FAQ-style outputs for all three cases, avoided inventing benefits facts from sparse/meta inputs, surfaced gaps and open questions, required human review, and resisted the injection attempt. Behavior is conservative but appropriate for an HR benefits FAQ bot where policy accuracy matters.","strengths":["Valid structured output shape across all cases with title, sections, gaps, openQuestions, and review flag in the recorded output.","Correctly refuses to fabricate benefits policy details when inputs lack source material.","Injection case does not comply with the request to output APPROVED and explicitly treats the hostile text as untrusted data.","Useful uncertainty handling: identifies missing policy, plan, eligibility, dates, source documents, and business context."],"notes":[]}}