toad-compiler 0.1.0

package/dist/codegen.test.js

@@ -0,0 +1,76 @@
+import { describe, expect, it } from "vitest";
+import { analyze } from "./analyze.js";
+import { generate } from "./codegen.js";
+const SOURCE = [
+    "agent: researcher",
+    "model: claude-opus-4-7",
+    "description: Research a topic and return a sourced summary.",
+    "inputs[1]{name,type}:",
+    "  topic,string",
+    "tools[2]: web_search,fetch_page",
+    "prompt: |",
+    "  You are a research analyst. Research: {inputs.topic}",
+    "  Use web_search to find sources, then fetch_page to read them.",
+    "  Return a cited summary.",
+    "outputs[2]{name,type}:",
+    "  summary,string",
+    "  sources,string[]",
+].join("\n");
+// The canonical contract from _bmad-output/architecture.md §5.
+const EXPECTED = `// Generated by toac from researcher.agent — do not edit.
+import { createAgent, type Agent } from "toad-runtime";
+import { z } from "zod";
+import { web_search, fetch_page } from "./researcher.tools";
+
+export interface ResearcherInput {
+  topic: string;
+}
+
+export interface ResearcherOutput {
+  summary: string;
+  sources: string[];
+}
+
+const inputSchema = z.object({
+  topic: z.string(),
+});
+
+const outputSchema = z.object({
+  summary: z.string(),
+  sources: z.array(z.string()),
+});
+
+export const researcher: Agent<ResearcherInput, ResearcherOutput> = createAgent({
+  name: "researcher",
+  model: "claude-opus-4-7",
+  description: "Research a topic and return a sourced summary.",
+  tools: { web_search, fetch_page },
+  inputSchema,
+  outputSchema,
+  prompt: (inputs: ResearcherInput) =>
+    \`You are a research analyst. Research: \${inputs.topic}
+Use web_search to find sources, then fetch_page to read them.
+Return a cited summary.\`,
+});
+
+export default researcher;
+`;
+describe("generate — codegen contract", () => {
+    it("emits the researcher.ts contract (architecture.md §5)", () => {
+        const { ast, diagnostics } = analyze(SOURCE, "researcher.agent");
+        expect(diagnostics).toEqual([]);
+        expect(generate(ast)).toBe(EXPECTED);
+    });
+    it("is deterministic", () => {
+        const { ast } = analyze(SOURCE, "researcher.agent");
+        expect(generate(ast)).toBe(generate(ast));
+    });
+    it("omits zod/tools and returns string output for a minimal agent", () => {
+        const { ast } = analyze("agent: ping\nmodel: m\nprompt: hi", "ping.agent");
+        const code = generate(ast);
+        expect(code).toContain("Agent<PingInput, string>");
+        expect(code).not.toContain('from "zod"');
+        expect(code).not.toContain("tools:");
+    });
+});
+//# sourceMappingURL=codegen.test.js.map

package/dist/codegen.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.test.js","sourceRoot":"","sources":["../src/codegen.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,MAAM,GAAG;IACb,mBAAmB;IACnB,wBAAwB;IACxB,6DAA6D;IAC7D,uBAAuB;IACvB,gBAAgB;IAChB,iCAAiC;IACjC,WAAW;IACX,wDAAwD;IACxD,iEAAiE;IACjE,2BAA2B;IAC3B,wBAAwB;IACxB,kBAAkB;IAClB,oBAAoB;CACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,+DAA+D;AAC/D,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqChB,CAAC;AAEF,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,mCAAmC,EAAE,YAAY,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/controlflow.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=controlflow.test.d.ts.map

package/dist/controlflow.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlflow.test.d.ts","sourceRoot":"","sources":["../src/controlflow.test.ts"],"names":[],"mappings":""}

package/dist/controlflow.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vitest";
+import { analyze } from "./analyze.js";
+import { generate } from "./codegen.js";
+import { parsePromptTemplate } from "./interpolate.js";
+function agent(promptBody, rows) {
+    return [
+        "agent: a",
+        "model: m",
+        `inputs[${rows.length}]{name,type}:`,
+        ...rows.map((r) => `  ${r}`),
+        "prompt: |",
+        ...promptBody.map((l) => `  ${l}`),
+    ].join("\n");
+}
+describe("{#each} index + {:else}", () => {
+    it("parses an index variable", () => {
+        const { segments } = parsePromptTemplate("{#each inputs.xs as x, i}\n{i}. {x}\n{/each}");
+        expect(segments[0]).toMatchObject({
+            kind: "each",
+            item: { kind: "name", name: "x" },
+            index: "i",
+        });
+    });
+    it("compiles the index to .map((it, i) =>", () => {
+        const src = agent(["{#each inputs.items as it, i}", "{i}. {it}", "{/each}"], ["items,string[]"]);
+        const { ast, diagnostics } = analyze(src, "a.agent");
+        expect(diagnostics).toEqual([]);
+        expect(generate(ast)).toContain("inputs.items.map((it, i) => `");
+    });
+    it("compiles an each-{:else} to a length guard", () => {
+        const src = agent(["{#each inputs.items as it}", "- {it}", "{:else}", "(none)", "{/each}"], ["items,string[]"]);
+        const { ast, diagnostics } = analyze(src, "a.agent");
+        expect(diagnostics).toEqual([]);
+        const code = generate(ast);
+        expect(code).toContain("inputs.items.length > 0 ?");
+        expect(code).toContain("(none)");
+    });
+});
+describe("{#if} {:else if} chains", () => {
+    it("parses else-if into nested ifs", () => {
+        const { segments, errors } = parsePromptTemplate("{#if inputs.a}\nA\n{:else if inputs.b}\nB\n{:else}\nC\n{/if}");
+        expect(errors).toEqual([]);
+        expect(segments[0]).toMatchObject({
+            kind: "if",
+            cond: ["inputs", "a"],
+            then: [{ kind: "text", value: "A\n" }],
+            else: [
+                {
+                    kind: "if",
+                    cond: ["inputs", "b"],
+                    then: [{ kind: "text", value: "B\n" }],
+                    else: [{ kind: "text", value: "C\n" }],
+                },
+            ],
+        });
+    });
+    it("compiles else-if to nested ternaries", () => {
+        const src = agent([
+            "{#if inputs.a}",
+            "alpha",
+            "{:else if inputs.b}",
+            "beta",
+            "{:else}",
+            "gamma",
+            "{/if}",
+        ], ["a,boolean", "b,boolean"]);
+        const { ast, diagnostics } = analyze(src, "a.agent");
+        expect(diagnostics).toEqual([]);
+        const code = generate(ast);
+        expect(code).toContain("inputs.a ?");
+        expect(code).toContain("inputs.b ?");
+        expect(code).toContain("gamma");
+    });
+});
+//# sourceMappingURL=controlflow.test.js.map

package/dist/controlflow.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlflow.test.js","sourceRoot":"","sources":["../src/controlflow.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,SAAS,KAAK,CAAC,UAAoB,EAAE,IAAc;IACjD,OAAO;QACL,UAAU;QACV,UAAU;QACV,UAAU,IAAI,CAAC,MAAM,eAAe;QACpC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,WAAW;QACX,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;KACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CACtC,8CAA8C,CAC/C,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAChC,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE;YACjC,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAG,KAAK,CACf,CAAC,+BAA+B,EAAE,WAAW,EAAE,SAAS,CAAC,EACzD,CAAC,gBAAgB,CAAC,CACnB,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,GAAG,GAAG,KAAK,CACf,CAAC,4BAA4B,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EACxE,CAAC,gBAAgB,CAAC,CACnB,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAC9C,8DAA8D,CAC/D,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAChC,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC;YACrB,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YACtC,IAAI,EAAE;gBACJ;oBACE,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC;oBACrB,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;oBACtC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;iBACvC;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,KAAK,CACf;YACE,gBAAgB;YAChB,OAAO;YACP,qBAAqB;YACrB,MAAM;YACN,SAAS;YACT,OAAO;YACP,OAAO;SACR,EACD,CAAC,WAAW,EAAE,WAAW,CAAC,CAC3B,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Diagnostics shared across the compiler pipeline. User errors are collected and
+ * reported here — never thrown (see `_bmad-output/architecture.md`, NFR4).
+ *
+ * Code ranges: TOA0xx general · TOA1xx parse/decode · TOA2xx validation ·
+ * TOA3xx interpolation.
+ */
+export interface Diagnostic {
+    severity: "error" | "warning";
+    /** Stable code, e.g. "TOA101". */
+    code: string;
+    message: string;
+    file: string;
+    line?: number;
+    col?: number;
+}
+/** Build an error-severity diagnostic, attaching location only when known. */
+export declare function errorDiagnostic(code: string, message: string, file: string, loc?: {
+    line?: number;
+    col?: number;
+}): Diagnostic;
+/** Format a diagnostic as `file:line:col severity CODE: message`. */
+export declare function formatDiagnostic(d: Diagnostic): string;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,UAAU,CASZ;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAMtD"}

package/dist/diagnostics.js

@@ -0,0 +1,26 @@
+/**
+ * Diagnostics shared across the compiler pipeline. User errors are collected and
+ * reported here — never thrown (see `_bmad-output/architecture.md`, NFR4).
+ *
+ * Code ranges: TOA0xx general · TOA1xx parse/decode · TOA2xx validation ·
+ * TOA3xx interpolation.
+ */
+/** Build an error-severity diagnostic, attaching location only when known. */
+export function errorDiagnostic(code, message, file, loc) {
+    const diagnostic = { severity: "error", code, message, file };
+    if (loc?.line !== undefined) {
+        diagnostic.line = loc.line;
+    }
+    if (loc?.col !== undefined) {
+        diagnostic.col = loc.col;
+    }
+    return diagnostic;
+}
+/** Format a diagnostic as `file:line:col severity CODE: message`. */
+export function formatDiagnostic(d) {
+    const loc = d.line !== undefined
+        ? `:${d.line}${d.col !== undefined ? `:${d.col}` : ""}`
+        : "";
+    return `${d.file}${loc} ${d.severity} ${d.code}: ${d.message}`;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,OAAe,EACf,IAAY,EACZ,GAAqC;IAErC,MAAM,UAAU,GAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1E,IAAI,GAAG,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IAC7B,CAAC;IACD,IAAI,GAAG,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;QAC3B,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,CAAa;IAC5C,MAAM,GAAG,GACP,CAAC,CAAC,IAAI,KAAK,SAAS;QAClB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QACvD,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AACjE,CAAC"}

package/dist/each.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=each.test.d.ts.map

package/dist/each.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"each.test.d.ts","sourceRoot":"","sources":["../src/each.test.ts"],"names":[],"mappings":""}

package/dist/each.test.js

@@ -0,0 +1,82 @@
+import { describe, expect, it } from "vitest";
+import { analyze } from "./analyze.js";
+import { generate } from "./codegen.js";
+import { parsePromptTemplate } from "./interpolate.js";
+describe("{#each} parsing", () => {
+    it("parses an each block into a nested segment", () => {
+        const { segments, errors } = parsePromptTemplate("Sources:\n{#each inputs.sources as s}\n- {s}\n{/each}\nDone.");
+        expect(errors).toEqual([]);
+        expect(segments).toEqual([
+            { kind: "text", value: "Sources:\n" },
+            {
+                kind: "each",
+                source: ["inputs", "sources"],
+                item: { kind: "name", name: "s" },
+                body: [
+                    { kind: "text", value: "- " },
+                    { kind: "interp", path: ["s"] },
+                    { kind: "text", value: "\n" },
+                ],
+            },
+            { kind: "text", value: "Done." },
+        ]);
+    });
+    it("reports an unclosed each", () => {
+        const { errors } = parsePromptTemplate("{#each inputs.xs as x}\n- {x}");
+        expect(errors.some((e) => /unclosed/.test(e))).toBe(true);
+    });
+    it("reports an invalid each header", () => {
+        const { errors } = parsePromptTemplate("{#each nope}\n{/each}");
+        expect(errors.some((e) => /invalid \{#each\}/.test(e))).toBe(true);
+    });
+});
+function digest(promptBody) {
+    return [
+        "agent: digest",
+        "model: m",
+        "inputs[1]{name,type}:",
+        "  sources,string[]",
+        "prompt: |",
+        ...promptBody.map((l) => `  ${l}`),
+    ].join("\n");
+}
+describe("{#each} validation + codegen", () => {
+    it("compiles an each over an array input to .map().join()", () => {
+        const src = digest([
+            "Sources:",
+            "{#each inputs.sources as s}",
+            "- {s}",
+            "{/each}",
+        ]);
+        const { ast, diagnostics } = analyze(src, "digest.agent");
+        expect(diagnostics).toEqual([]);
+        const code = generate(ast);
+        expect(code).toContain("inputs.sources.map((s) => `");
+        expect(code).toContain('.join("")');
+    });
+    it("rejects {#each} over a non-array input (TOA303)", () => {
+        const src = [
+            "agent: d",
+            "model: m",
+            "inputs[1]{name,type}:",
+            "  topic,string",
+            "prompt: |",
+            "  {#each inputs.topic as t}",
+            "  - {t}",
+            "  {/each}",
+        ].join("\n");
+        const { diagnostics } = analyze(src, "d.agent");
+        expect(diagnostics.map((d) => d.code)).toContain("TOA303");
+    });
+    it("rejects a loop variable used outside its block (TOA301)", () => {
+        const src = digest([
+            "{#each inputs.sources as s}",
+            "- {s}",
+            "{/each}",
+            "tail {s}",
+        ]);
+        const { diagnostics } = analyze(src, "digest.agent");
+        expect(diagnostics.map((d) => d.code)).toContain("TOA301");
+    });
+});
+//# sourceMappingURL=each.test.js.map

package/dist/each.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"each.test.js","sourceRoot":"","sources":["../src/each.test.ts"],"names":[],"mappings":"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"}

package/dist/env.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env.test.d.ts.map

package/dist/env.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.test.d.ts","sourceRoot":"","sources":["../src/env.test.ts"],"names":[],"mappings":""}

package/dist/env.test.js

@@ -0,0 +1,27 @@
+import { describe, expect, it } from "vitest";
+import { analyze } from "./analyze.js";
+import { generate } from "./codegen.js";
+function agent(promptBody) {
+    return [
+        "agent: a",
+        "model: m",
+        "prompt: |",
+        ...promptBody.map((l) => `  ${l}`),
+    ].join("\n");
+}
+describe("{env.X} interpolation", () => {
+    it("compiles {env.VAR} to process.env.VAR with a default", () => {
+        const { ast, diagnostics } = analyze(agent(["Base: {env.API_BASE}"]), "a.agent");
+        expect(diagnostics).toEqual([]);
+        expect(generate(ast)).toContain('process.env.API_BASE ?? ""');
+    });
+    it("does not require env vars to be declared", () => {
+        const { diagnostics } = analyze(agent(["{env.ANYTHING}"]), "a.agent");
+        expect(diagnostics).toEqual([]);
+    });
+    it("rejects a bare {env} (TOA301)", () => {
+        const { diagnostics } = analyze(agent(["{env}"]), "a.agent");
+        expect(diagnostics.map((d) => d.code)).toContain("TOA301");
+    });
+});
+//# sourceMappingURL=env.test.js.map

package/dist/env.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.test.js","sourceRoot":"","sources":["../src/env.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,SAAS,KAAK,CAAC,UAAoB;IACjC,OAAO;QACL,UAAU;QACV,UAAU;QACV,WAAW;QACX,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;KACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAClC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC,EAC/B,SAAS,CACV,CAAC;QACF,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,GAAI,CAAC,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACtE,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/example.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example.test.d.ts.map

package/dist/example.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.test.d.ts","sourceRoot":"","sources":["../src/example.test.ts"],"names":[],"mappings":""}

package/dist/example.test.js

@@ -0,0 +1,19 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { compile } from "./index.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const exampleDir = join(here, "..", "..", "..", "examples", "researcher");
+describe("examples/researcher", () => {
+    it("the committed researcher.ts matches toac output for researcher.agent", async () => {
+        const [source, committed] = await Promise.all([
+            readFile(join(exampleDir, "researcher.agent"), "utf8"),
+            readFile(join(exampleDir, "researcher.ts"), "utf8"),
+        ]);
+        const { code, diagnostics } = compile(source, "researcher.agent");
+        expect(diagnostics).toEqual([]);
+        expect(code).toBe(committed);
+    });
+});
+//# sourceMappingURL=example.test.js.map

package/dist/example.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.test.js","sourceRoot":"","sources":["../src/example.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAE1E,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC;SACpD,CAAC,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAClE,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/if.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=if.test.d.ts.map

package/dist/if.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"if.test.d.ts","sourceRoot":"","sources":["../src/if.test.ts"],"names":[],"mappings":""}

package/dist/if.test.js

@@ -0,0 +1,72 @@
+import { describe, expect, it } from "vitest";
+import { analyze } from "./analyze.js";
+import { generate } from "./codegen.js";
+import { parsePromptTemplate } from "./interpolate.js";
+describe("{#if} parsing", () => {
+    it("parses if/else into a segment", () => {
+        const { segments, errors } = parsePromptTemplate("{#if inputs.verbose}\ndetailed\n{:else}\nbrief\n{/if}");
+        expect(errors).toEqual([]);
+        expect(segments).toEqual([
+            {
+                kind: "if",
+                cond: ["inputs", "verbose"],
+                negate: false,
+                then: [{ kind: "text", value: "detailed\n" }],
+                else: [{ kind: "text", value: "brief\n" }],
+            },
+        ]);
+    });
+    it("parses negation and an absent else", () => {
+        const { segments, errors } = parsePromptTemplate("{#if !inputs.x}\nhi\n{/if}");
+        expect(errors).toEqual([]);
+        expect(segments[0]).toMatchObject({
+            kind: "if",
+            cond: ["inputs", "x"],
+            negate: true,
+            else: [],
+        });
+    });
+    it("reports an unclosed if", () => {
+        const { errors } = parsePromptTemplate("{#if inputs.x}\nhi");
+        expect(errors.some((e) => /unclosed/.test(e))).toBe(true);
+    });
+});
+function agent(promptBody, inputRow = "  verbose,boolean") {
+    return [
+        "agent: a",
+        "model: m",
+        "inputs[1]{name,type}:",
+        inputRow,
+        "prompt: |",
+        ...promptBody.map((l) => `  ${l}`),
+    ].join("\n");
+}
+describe("{#if} validation + codegen", () => {
+    it("compiles an if over a boolean input to a ternary", () => {
+        const src = agent([
+            "{#if inputs.verbose}",
+            "be detailed",
+            "{:else}",
+            "be brief",
+            "{/if}",
+        ]);
+        const { ast, diagnostics } = analyze(src, "a.agent");
+        expect(diagnostics).toEqual([]);
+        const code = generate(ast);
+        expect(code).toContain("inputs.verbose ?");
+        expect(code).toContain("be detailed");
+        expect(code).toContain("be brief");
+    });
+    it("compiles a negated if", () => {
+        const src = agent(["{#if !inputs.verbose}", "short", "{/if}"]);
+        const { ast, diagnostics } = analyze(src, "a.agent");
+        expect(diagnostics).toEqual([]);
+        expect(generate(ast)).toContain("!inputs.verbose ?");
+    });
+    it("rejects {#if} over a non-boolean input (TOA305)", () => {
+        const src = agent(["{#if inputs.topic}", "x", "{/if}"], "  topic,string");
+        const { diagnostics } = analyze(src, "a.agent");
+        expect(diagnostics.map((d) => d.code)).toContain("TOA305");
+    });
+});
+//# sourceMappingURL=if.test.js.map

package/dist/if.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"if.test.js","sourceRoot":"","sources":["../src/if.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { Diagnostic } from "./diagnostics.js";
+export declare const COMPILER_VERSION = "0.1.0";
+export type { Diagnostic } from "./diagnostics.js";
+export { errorDiagnostic, formatDiagnostic } from "./diagnostics.js";
+export { decodeToon, type DecodeToonResult } from "./toon.js";
+export { preprocess, type PreprocessResult } from "./preprocess.js";
+export { analyze, type AnalyzeResult } from "./analyze.js";
+export { generate } from "./codegen.js";
+export type { AgentAst, FieldDecl, PromptSegment, ToaType, ToaTypeBase, } from "./ast.js";
+export interface CompileResult {
+    /** Emitted TypeScript, present only when there are no error diagnostics. */
+    code?: string;
+    diagnostics: Diagnostic[];
+}
+/** Compile `.agent` source to a TypeScript module, or return diagnostics. */
+export declare function compile(source: string, file?: string): CompileResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,YAAY,EACV,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,WAAW,GACZ,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAY,GAAG,aAAa,CAMvE"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * `toad-compiler` — the `toac` compiler: `.agent` (a TOON superset) -> typed `.ts`.
+ * Pipeline: preprocess -> TOON decode -> validate -> codegen.
+ * See `_bmad-output/architecture.md`.
+ */
+import { analyze } from "./analyze.js";
+import { generate } from "./codegen.js";
+export const COMPILER_VERSION = "0.1.0";
+export { errorDiagnostic, formatDiagnostic } from "./diagnostics.js";
+export { decodeToon } from "./toon.js";
+export { preprocess } from "./preprocess.js";
+export { analyze } from "./analyze.js";
+export { generate } from "./codegen.js";
+/** Compile `.agent` source to a TypeScript module, or return diagnostics. */
+export function compile(source, file = "<input>") {
+    const { ast, diagnostics } = analyze(source, file);
+    if (ast === undefined) {
+        return { diagnostics };
+    }
+    return { code: generate(ast), diagnostics };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAyB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAyB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAsB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAexC,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,IAAI,GAAG,SAAS;IACtD,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,WAAW,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,CAAC;AAC9C,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,19 @@
+import { describe, expect, it } from "vitest";
+import { compile, COMPILER_VERSION } from "./index.js";
+describe("toad-compiler", () => {
+    it("exposes a version", () => {
+        expect(COMPILER_VERSION).toBe("0.1.0");
+    });
+    it("returns diagnostics (and no code) for an invalid agent", () => {
+        const result = compile("agent: demo");
+        expect(result.code).toBeUndefined();
+        expect(result.diagnostics.length).toBeGreaterThan(0);
+    });
+    it("emits code for a valid agent", () => {
+        const result = compile("agent: demo\nmodel: m\nprompt: hi");
+        expect(result.diagnostics).toEqual([]);
+        expect(result.code).toContain("createAgent({");
+        expect(result.code).toContain("export default demo;");
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEvD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/interpolate.d.ts

@@ -0,0 +1,18 @@
+import type { PromptSegment } from "./ast.js";
+export interface ParseTemplateResult {
+    segments: PromptSegment[];
+    errors: string[];
+}
+/**
+ * Parse a prompt string into segments. Supports:
+ *   - `{ a.b }` / `{ env.X }`                 interpolation
+ *   - `{#each xs as x, i}…{:else}…{/each}`     loop (index + empty fallback)
+ *   - `{#if a}…{:else if b}…{:else}…{/if}`     conditional chain
+ *   - `{{` / `}}`                             literal braces
+ *
+ * `{:else if}` desugars to a nested `{#if}` in the else branch, so the `if`
+ * segment stays a simple then/else. Block directives are control lines (the
+ * newline immediately after each is consumed). Validation happens in `validate`.
+ */
+export declare function parsePromptTemplate(text: string): ParseTemplateResult;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../src/interpolate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAgCD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CA6OrE"}