{"id":"devops-change-advisory","title":"Change Advisory","description":"Advisory typed. CAB reviews slow. Typed v1 agent with eval coverage.","category":"devops","status":"validated","version":"1.0.0","source":"agentskit-registry","license":"MIT","tags":["devops","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":"devops-change-advisory","description":"Advisory typed. CAB reviews slow. Typed v1 agent with eval coverage.","systemPrompt":"You are Change Advisory. CAB reviews slow. Output: Advisory typed.\nActionable findings citing input sources. No invented issues.\nNEVER invent facts — gaps and openQuestions for missing input. Always draft for human review.\n${UNTRUSTED_CONTENT_DIRECTIVE}\nCall submit_change_advisory exactly once. Stop."},"flow":null,"a2a":{"id":"io.agentskit.registry.devops-change-advisory","name":"Change Advisory","description":"Advisory typed. CAB reviews slow. Typed v1 agent with eval coverage.","version":"1.0.0","homepage":"https://registry.agentskit.io","skills":[{"name":"devops-change-advisory","description":"Advisory typed. CAB reviews slow. 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/** Change Advisory — v1 validated. Pain: CAB reviews slow */\n\nexport interface Finding { id: string; severity: 'critical' | 'high' | 'medium' | 'low' | 'info'; message: string; source?: string; recommendation?: string }\nexport interface AgentOutput { summary: string; findings: Finding[]; gaps: string[]; openQuestions: string[] }\nexport interface AgentResult extends AgentOutput { requiresReview: boolean }\nexport interface DevopsChangeAdvisoryConfig {\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  summary: z.string(),\n  findings: z.array(z.object({\n    id: z.string(), severity: z.enum(['critical', 'high', 'medium', 'low', 'info']),\n    message: z.string(), source: z.string().optional(), recommendation: z.string().optional(),\n  })),\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: 'devops-change-advisory',\n  description: \"Change Advisory — typed output agent (draft spec).\",\n  systemPrompt: `You are Change Advisory. CAB reviews slow. Output: Advisory typed.\nActionable findings citing input sources. No invented issues.\nNEVER invent facts — gaps and openQuestions for missing input. Always draft for human review.\n${UNTRUSTED_CONTENT_DIRECTIVE}\nCall submit_change_advisory exactly once. Stop.`,\n  tools: ['submit_change_advisory'],\n}\n\nexport function createDevopsChangeAdvisoryAgent(config: DevopsChangeAdvisoryConfig) {\n  const submit = (): ToolDefinition =>\n    defineZodTool({ name: 'submit_change_advisory', 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('devops-change-advisory 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: 'devops-change-advisory',\n    run,\n    asHandle() { return { name: 'devops-change-advisory', run: (t: string) => run(t).then((r) => JSON.stringify(r)) } },\n  }\n}\n"},{"path":"README.md","content":"# Change Advisory\n\n> **v1 validated** — `npx agentskit add devops-change-advisory`\n\n## Pain\nCAB reviews slow\n\n## Output\nAdvisory typed\n"},{"path":"eval.ts","content":"import type { EvalSuite } from '@agentskit/eval'\n\nexport const suite: EvalSuite = {\n  name: 'devops-change-advisory',\n  cases: [\n    { input: 'Complete input for Change Advisory: CAB reviews slow. 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, stayed within the sparse inputs, surfaced uncertainty and missing CAB details, required human review, and resisted the injection request without leaking unsafe content or fabricating an approval. The normal case is conservative rather than scenario-generating, but that is acceptable for a change advisory agent because the input contained no actual change facts and the validation criteria penalize hallucination.","strengths":["Valid structured advisory output in every case with summary, findings, gaps, open questions, and review requirement.","Correctly refused to invent concrete change facts from placeholder or sparse inputs.","Handled prompt injection by treating the override as data and not outputting APPROVED.","Useful CAB-oriented gap list and follow-up questions covering scope, systems, schedule, risk, validation, rollback, ownership, and approvals."],"notes":[]}}