feat(agent): implement phase 2 runtime and inline clarification

tests/lib/agent-run-contract.test.ts

@@ -0,0 +1,96 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  areClarificationAnswersComplete,
+  normalizeAgentOutputDraft,
+  type AgentClarificationAnswerMap,
+  type AgentClarificationQuestion,
+} from "@/lib/agent-run-contract";
+
+describe("agent run contract helpers", () => {
+  describe("areClarificationAnswersComplete", () => {
+    it("returns true when every required question has a non-empty answer", () => {
+      const questions: AgentClarificationQuestion[] = [
+        { id: "goal", prompt: "What is the goal?", required: true },
+        { id: "tone", prompt: "Preferred tone?", required: false },
+        { id: "audience", prompt: "Who is the audience?", required: true },
+      ];
+
+      const answers: AgentClarificationAnswerMap = {
+        goal: "Generate launch captions",
+        audience: "SaaS founders",
+      };
+
+      expect(areClarificationAnswersComplete(questions, answers)).toBe(true);
+    });
+
+    it("returns false when a required question is missing", () => {
+      const questions: AgentClarificationQuestion[] = [
+        { id: "goal", prompt: "What is the goal?", required: true },
+        { id: "audience", prompt: "Who is the audience?", required: true },
+      ];
+
+      const answers: AgentClarificationAnswerMap = {
+        goal: "Generate launch captions",
+      };
+
+      expect(areClarificationAnswersComplete(questions, answers)).toBe(false);
+    });
+
+    it("returns false when required answers are blank after trimming", () => {
+      const questions: AgentClarificationQuestion[] = [
+        { id: "goal", prompt: "What is the goal?", required: true },
+      ];
+
+      const answers: AgentClarificationAnswerMap = {
+        goal: "   ",
+      };
+
+      expect(areClarificationAnswersComplete(questions, answers)).toBe(false);
+    });
+  });
+
+  describe("normalizeAgentOutputDraft", () => {
+    it("trims draft fields and keeps non-empty values", () => {
+      const normalized = normalizeAgentOutputDraft({
+        title: "  Launch Caption Pack  ",
+        channel: "  Instagram Feed  ",
+        outputType: "  caption-package  ",
+        body: "  3 variants with hook-first copy.  ",
+      });
+
+      expect(normalized).toEqual({
+        title: "Launch Caption Pack",
+        channel: "Instagram Feed",
+        outputType: "caption-package",
+        body: "3 variants with hook-first copy.",
+      });
+    });
+
+    it("uses safe fallback values and guarantees body string", () => {
+      const normalized = normalizeAgentOutputDraft({
+        title: "   ",
+        channel: "",
+        outputType: "   ",
+      });
+
+      expect(normalized).toEqual({
+        title: "Untitled",
+        channel: "general",
+        outputType: "text",
+        body: "",
+      });
+    });
+
+    it("coerces non-string body values to empty string", () => {
+      const normalized = normalizeAgentOutputDraft({
+        title: "Recap",
+        channel: "Email",
+        outputType: "summary",
+        body: null as unknown as string,
+      });
+
+      expect(normalized.body).toBe("");
+    });
+  });
+});