toad-compiler 0.1.0

package/dist/validate.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from "vitest";
+import { validate } from "./validate.js";
+const VALID = {
+    agent: "researcher",
+    model: "claude-opus-4-7",
+    description: "desc",
+    inputs: [{ name: "topic", type: "string" }],
+    tools: ["web_search", "fetch_page"],
+    prompt: "Research: {inputs.topic}",
+    outputs: [
+        { name: "summary", type: "string" },
+        { name: "sources", type: "string[]" },
+    ],
+};
+const codes = (value) => validate(value, "x.agent", new Map()).diagnostics.map((d) => d.code);
+describe("validate", () => {
+    it("lifts a valid object into a typed AgentAst", () => {
+        const { ast, diagnostics } = validate(VALID, "x.agent", new Map());
+        expect(diagnostics).toEqual([]);
+        expect(ast).toEqual({
+            name: "researcher",
+            model: "claude-opus-4-7",
+            description: "desc",
+            inputs: [{ name: "topic", type: { base: "string", array: false } }],
+            outputs: [
+                { name: "summary", type: { base: "string", array: false } },
+                { name: "sources", type: { base: "string", array: true } },
+            ],
+            tools: ["web_search", "fetch_page"],
+            uses: [],
+            prompt: [
+                { kind: "text", value: "Research: " },
+                { kind: "interp", path: ["inputs", "topic"] },
+            ],
+        });
+    });
+    it("requires agent, model, and prompt", () => {
+        expect(codes({ agent: "a", model: "m" })).toContain("TOA203");
+    });
+    it("rejects unknown top-level keys", () => {
+        expect(codes({ ...VALID, modle: "typo" })).toContain("TOA202");
+    });
+    it("rejects a non-identifier agent name", () => {
+        expect(codes({ ...VALID, agent: "no spaces" })).toContain("TOA205");
+    });
+    it("rejects an unsupported field type", () => {
+        expect(codes({
+            ...VALID,
+            inputs: [{ name: "x", type: "date" }],
+        })).toContain("TOA212");
+    });
+    it("rejects an interpolation referencing an undeclared input", () => {
+        expect(codes({
+            ...VALID,
+            prompt: "see {inputs.missing}",
+        })).toContain("TOA301");
+    });
+    it("uses keyLines to locate diagnostics", () => {
+        const { diagnostics } = validate({ agent: "a", model: "m", prompt: "p", oops: 1 }, "x.agent", new Map([["oops", 4]]));
+        const unknown = diagnostics.find((d) => d.code === "TOA202");
+        expect(unknown?.line).toBe(4);
+    });
+});
+//# sourceMappingURL=validate.test.js.map

package/dist/validate.test.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "toad-compiler",
+  "version": "0.1.0",
+  "description": "The toac compiler for TOAD — turns a declarative .agent file (a TOON superset) into readable, fully-typed TypeScript that runs on toad-runtime.",
+  "keywords": [
+    "toad",
+    "toac",
+    "compiler",
+    "ai",
+    "agents",
+    "anthropic",
+    "claude",
+    "llm",
+    "toon",
+    "codegen"
+  ],
+  "homepage": "https://zubeidhendricks.github.io/toad/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZubeidHendricks/toad.git",
+    "directory": "packages/compiler"
+  },
+  "bugs": {
+    "url": "https://github.com/ZubeidHendricks/toad/issues"
+  },
+  "author": "Zubeid Hendricks",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "toac": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@toon-format/toon": "2.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.18",
+    "typescript": "6.0.3",
+    "vitest": "4.1.6"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}