@codespar/types 0.10.1 → 0.10.7

package/dist/testing/conformance-kit.test.js

@@ -0,0 +1,434 @@
+/**
+ * Unit tests for the meta-tool conformance kit.
+ *
+ * The kit's value is its pass/fail logic: a conforming implementation
+ * passes, and an implementation that violates a wire shape, an action-state
+ * rule, or an error rule fails — with a violation naming the specific
+ * breach. We prove that two ways without a real backend:
+ *
+ *   1. The pure verification core (`checkWireShape`, `checkActionResult`,
+ *      `checkUnregisteredError`, `checkMalformedError`) is exercised
+ *      directly against hand-built conforming and violating envelopes.
+ *   2. The live suite (`runMetaToolConformanceSuite`) is run end-to-end
+ *      against a FAKE backend (a stubbed `fetch`), asserting that a
+ *      conforming fake registers passing cases and a fake that breaks each
+ *      rule registers a failing case carrying the right violation.
+ */
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { SHOP_CONTRACT, DISCOVER_CONTRACT } from "../meta-tool-contract.js";
+import { fieldMatches, checkWireShape, checkActionResult, checkSingleShotResult, checkUnregisteredError, checkMalformedError, formatViolations, } from "./conformance-kit.js";
+/* ── fieldMatches ────────────────────────────────────────────── */
+describe("fieldMatches", () => {
+    it("matches each JSON-value kind", () => {
+        expect(fieldMatches({ name: "x", kind: "string" }, "a")).toBe(true);
+        expect(fieldMatches({ name: "x", kind: "number" }, 1)).toBe(true);
+        expect(fieldMatches({ name: "x", kind: "boolean" }, true)).toBe(true);
+        expect(fieldMatches({ name: "x", kind: "array" }, [])).toBe(true);
+        expect(fieldMatches({ name: "x", kind: "object" }, {})).toBe(true);
+    });
+    it("rejects mismatched kinds", () => {
+        expect(fieldMatches({ name: "x", kind: "string" }, 1)).toBe(false);
+        expect(fieldMatches({ name: "x", kind: "number" }, "1")).toBe(false);
+        expect(fieldMatches({ name: "x", kind: "array" }, {})).toBe(false);
+        expect(fieldMatches({ name: "x", kind: "object" }, [])).toBe(false);
+        expect(fieldMatches({ name: "x", kind: "object" }, null)).toBe(false);
+    });
+    it("constrains string-enum to the closed value set", () => {
+        const rule = {
+            name: "status",
+            kind: "string-enum",
+            values: ["in_progress", "ready_for_payment"],
+        };
+        expect(fieldMatches(rule, "ready_for_payment")).toBe(true);
+        expect(fieldMatches(rule, "canceled")).toBe(false);
+        expect(fieldMatches(rule, 1)).toBe(false);
+    });
+});
+/* ── checkWireShape ──────────────────────────────────────────── */
+describe("checkWireShape", () => {
+    const shape = {
+        name: "ShopSearchResult",
+        fields: [
+            { name: "rail", kind: "string" },
+            { name: "products", kind: "array" },
+        ],
+    };
+    it("passes a conforming object", () => {
+        expect(checkWireShape(shape, { rail: "vtex", products: [] })).toEqual([]);
+    });
+    it("allows extra optional fields beyond the shape (subset-shape)", () => {
+        expect(checkWireShape(shape, { rail: "vtex", products: [], extra: 7 })).toEqual([]);
+    });
+    it("flags a missing required field with the field name", () => {
+        const violations = checkWireShape(shape, { rail: "vtex" });
+        expect(violations).toHaveLength(1);
+        expect(violations[0].code).toBe("wire-shape");
+        expect(violations[0].detail).toContain("ShopSearchResult.products");
+        expect(violations[0].detail).toContain("missing");
+    });
+    it("flags a wrong-typed field with expected vs got", () => {
+        const violations = checkWireShape(shape, { rail: 7, products: [] });
+        expect(violations).toHaveLength(1);
+        expect(violations[0].detail).toContain("ShopSearchResult.rail");
+        expect(violations[0].detail).toContain("expected string");
+    });
+    it("flags a non-object as a single violation", () => {
+        expect(checkWireShape(shape, "nope")[0].detail).toContain("expected an object");
+        expect(checkWireShape(shape, [])[0].detail).toContain("expected an object");
+    });
+    it("skips an absent optional field", () => {
+        const optShape = {
+            name: "S",
+            fields: [{ name: "maybe", kind: "string", required: false }],
+        };
+        expect(checkWireShape(optShape, {})).toEqual([]);
+    });
+});
+/* ── checkActionResult ───────────────────────────────────────── */
+function okResult(data) {
+    return {
+        success: true,
+        data,
+        error: "",
+        duration: 1,
+        server: "fake",
+        tool: "codespar_shop",
+    };
+}
+function errResult(error) {
+    return {
+        success: false,
+        data: {},
+        error,
+        duration: 0,
+        server: "fake",
+        tool: "codespar_shop",
+    };
+}
+describe("checkActionResult", () => {
+    it("passes a conforming shop search result", () => {
+        const result = okResult({ rail: "vtex", products: [] });
+        expect(checkActionResult(SHOP_CONTRACT, "search", result)).toEqual([]);
+    });
+    it("flags a checkout result whose status is outside the enum", () => {
+        // checkout must return status "in_progress" only.
+        const result = okResult({
+            checkout_session_id: "cks_1",
+            status: "ready_for_payment",
+        });
+        const violations = checkActionResult(SHOP_CONTRACT, "checkout", result);
+        expect(violations).toHaveLength(1);
+        expect(violations[0].code).toBe("wire-shape");
+        expect(violations[0].detail).toContain("status");
+        expect(violations[0].detail).toContain("in_progress");
+    });
+    it("passes the terminal ready_for_payment checkout_status", () => {
+        const result = okResult({
+            checkout_session_id: "cks_1",
+            status: "ready_for_payment",
+        });
+        expect(checkActionResult(SHOP_CONTRACT, "checkout_status", result)).toEqual([]);
+    });
+    it("flags a checkout_status whose status is not a known state", () => {
+        const result = okResult({
+            checkout_session_id: "cks_1",
+            status: "exploded",
+        });
+        const violations = checkActionResult(SHOP_CONTRACT, "checkout_status", result);
+        expect(violations[0].detail).toContain("status");
+    });
+    it("flags a success-expected action that returned an error", () => {
+        const violations = checkActionResult(SHOP_CONTRACT, "search", errResult("boom"));
+        expect(violations).toHaveLength(1);
+        expect(violations[0].code).toBe("action-state");
+        expect(violations[0].detail).toContain("boom");
+    });
+    it("flags an action that is not in the state machine", () => {
+        const violations = checkActionResult(SHOP_CONTRACT, "teleport", okResult({}));
+        expect(violations[0].code).toBe("action-state");
+        expect(violations[0].detail).toContain("teleport");
+    });
+});
+/* ── checkSingleShotResult (the Fix #1 teeth) ────────────────── */
+describe("checkSingleShotResult", () => {
+    const conformingDiscover = okResult({
+        use_case: "buy cat food",
+        search_strategy: "embedding",
+        recommended: null,
+        related: [],
+        next_steps: [],
+    });
+    it("passes a conforming DiscoverResult", () => {
+        expect(checkSingleShotResult(DISCOVER_CONTRACT, conformingDiscover)).toEqual([]);
+    });
+    it("flags a scalar result that succeeded but is not the wire shape", () => {
+        // The exact hole the validation spike found: a single-shot tool
+        // returning `output: 42` used to pass on success alone.
+        const violations = checkSingleShotResult(DISCOVER_CONTRACT, okResult(42));
+        expect(violations.length).toBeGreaterThan(0);
+        expect(violations[0].code).toBe("wire-shape");
+        expect(violations[0].detail).toContain("expected an object");
+    });
+    it("flags a missing required field", () => {
+        const violations = checkSingleShotResult(DISCOVER_CONTRACT, okResult({
+            use_case: "x",
+            search_strategy: "embedding",
+            related: [],
+            // next_steps missing
+        }));
+        expect(violations[0].code).toBe("wire-shape");
+        expect(violations[0].detail).toContain("DiscoverResult.next_steps");
+    });
+    it("flags a search_strategy outside the enum", () => {
+        const violations = checkSingleShotResult(DISCOVER_CONTRACT, okResult({
+            use_case: "x",
+            search_strategy: "vibes",
+            recommended: null,
+            related: [],
+            next_steps: [],
+        }));
+        expect(violations[0].detail).toContain("search_strategy");
+    });
+    it("flags a success-expected single-shot tool that returned an error", () => {
+        const violations = checkSingleShotResult(DISCOVER_CONTRACT, errResult("boom"));
+        expect(violations[0].code).toBe("wire-shape");
+        expect(violations[0].detail).toContain("boom");
+    });
+});
+/* ── error rules ─────────────────────────────────────────────── */
+describe("checkUnregisteredError", () => {
+    it("passes the canonical 'Tool not registered' envelope", () => {
+        const result = errResult("Tool not registered: codespar_shop__probe");
+        expect(checkUnregisteredError(SHOP_CONTRACT, result)).toEqual([]);
+    });
+    it("flags a success result where an unregistered error was due", () => {
+        const violations = checkUnregisteredError(SHOP_CONTRACT, okResult({}));
+        expect(violations[0].code).toBe("error-unregistered");
+        expect(violations[0].detail).toContain("success result");
+    });
+    it("flags the wrong error message", () => {
+        const violations = checkUnregisteredError(SHOP_CONTRACT, errResult("404: not found"));
+        expect(violations[0].code).toBe("error-unregistered");
+        expect(violations[0].detail).toContain("Tool not registered");
+    });
+});
+describe("checkMalformedError", () => {
+    it("passes a typed error envelope", () => {
+        expect(checkMalformedError(SHOP_CONTRACT, errResult("query: required"))).toEqual([]);
+    });
+    it("flags a success result for malformed input", () => {
+        const violations = checkMalformedError(SHOP_CONTRACT, okResult({}));
+        expect(violations[0].code).toBe("error-malformed");
+        expect(violations[0].detail).toContain("success result");
+    });
+    it("flags an empty error string", () => {
+        const violations = checkMalformedError(SHOP_CONTRACT, errResult(""));
+        expect(violations[0].code).toBe("error-malformed");
+    });
+});
+describe("formatViolations", () => {
+    it("renders 'no violations' for an empty list", () => {
+        expect(formatViolations([])).toBe("no violations");
+    });
+    it("joins violations with their codes", () => {
+        const vs = [
+            { code: "wire-shape", detail: "a" },
+            { code: "action-state", detail: "b" },
+        ];
+        expect(formatViolations(vs)).toBe("[wire-shape] a; [action-state] b");
+    });
+});
+/** Install a `fetch` stub that routes session-create/execute/delete to a
+ *  fake backend's `execute`. Returns a teardown. */
+function installFakeBackend(execute) {
+    const stub = vi.fn(async (url, init) => {
+        const u = String(url);
+        if (u.endsWith("/v1/sessions") && init?.method === "POST") {
+            return jsonResponse({ id: "sess_fake", status: "active" });
+        }
+        if (u.includes("/execute")) {
+            const body = JSON.parse(String(init?.body ?? "{}"));
+            return jsonResponse(execute(body.tool, body.input ?? {}));
+        }
+        // DELETE close
+        return jsonResponse({});
+    });
+    const original = globalThis.fetch;
+    globalThis.fetch = stub;
+    return () => {
+        globalThis.fetch = original;
+    };
+}
+function jsonResponse(body) {
+    return new Response(JSON.stringify(body), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+    });
+}
+/** Run the suite under a mocked Vitest that executes each registered `it`
+ *  body and records pass/fail (a thrown/rejected assertion = fail). Returns
+ *  one entry per registered case. */
+async function runSuiteAndCollect(tool) {
+    vi.resetModules();
+    const cases = [];
+    const afterEachFns = [];
+    // Real expect so assertions actually fire inside the case bodies.
+    const realExpect = (await vi.importActual("vitest")).expect;
+    vi.doMock("vitest", () => ({
+        describe: (_name, fn) => fn(),
+        it: (name, fn) => {
+            cases.push(async () => {
+                try {
+                    await fn();
+                    return { name, passed: true };
+                }
+                catch (err) {
+                    return {
+                        name,
+                        passed: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    };
+                }
+                finally {
+                    for (const a of afterEachFns)
+                        await a();
+                }
+            });
+        },
+        afterEach: (fn) => {
+            afterEachFns.push(fn);
+        },
+        expect: realExpect,
+    }));
+    const mod = await import("./conformance-kit.js");
+    mod.runMetaToolConformanceSuite("http://localhost:9999", "csk_test", { tool });
+    const results = [];
+    for (const c of cases)
+        results.push(await c());
+    vi.doUnmock("vitest");
+    return results;
+}
+/** A fully conforming fake backend for codespar_shop. */
+const conformingShop = (tool, input) => {
+    if (tool.endsWith("__unregistered_probe")) {
+        return errResult(`Tool not registered: ${tool}`);
+    }
+    const action = input.action;
+    // Malformed: search with no query.
+    if (action === "search" && !input.query) {
+        return errResult("query: required");
+    }
+    if (action === "search")
+        return okResult({ rail: "vtex", products: [] });
+    if (action === "checkout") {
+        return okResult({ checkout_session_id: "cks_1", status: "in_progress" });
+    }
+    if (action === "checkout_status") {
+        return okResult({
+            checkout_session_id: "cks_1",
+            status: "ready_for_payment",
+        });
+    }
+    return errResult("unknown action");
+};
+describe("runMetaToolConformanceSuite against a fake backend", () => {
+    let teardown = null;
+    afterEach(() => {
+        teardown?.();
+        teardown = null;
+    });
+    it("a conforming fake passes every registered case", async () => {
+        teardown = installFakeBackend(conformingShop);
+        const results = await runSuiteAndCollect("codespar_shop");
+        const failures = results.filter((r) => !r.passed);
+        expect(failures, JSON.stringify(failures, null, 2)).toEqual([]);
+        // Sanity: it actually registered cases (3 actions + 2 error legs).
+        expect(results.length).toBe(5);
+    });
+    it("fails the wire-shape case when an action returns the wrong shape", async () => {
+        // search returns a number for `rail` — a wire-shape violation.
+        teardown = installFakeBackend((tool, input) => input.action === "search" && input.query
+            ? okResult({ rail: 7, products: [] })
+            : conformingShop(tool, input));
+        const results = await runSuiteAndCollect("codespar_shop");
+        const searchCase = results.find((r) => r.name.includes('"search"'));
+        expect(searchCase?.passed).toBe(false);
+        expect(searchCase?.error).toContain("ShopSearchResult.rail");
+    });
+    it("fails the action-state case when checkout reports a terminal status early", async () => {
+        teardown = installFakeBackend((tool, input) => input.action === "checkout"
+            ? okResult({ checkout_session_id: "cks_1", status: "ready_for_payment" })
+            : conformingShop(tool, input));
+        const results = await runSuiteAndCollect("codespar_shop");
+        const checkoutCase = results.find((r) => r.name.includes('"checkout"'));
+        expect(checkoutCase?.passed).toBe(false);
+        expect(checkoutCase?.error).toContain("status");
+    });
+    it("fails the unregistered-error case when the runtime swallows it", async () => {
+        teardown = installFakeBackend((tool, input) => tool.endsWith("__unregistered_probe")
+            ? okResult({ rail: "vtex", products: [] }) // wrongly succeeds
+            : conformingShop(tool, input));
+        const results = await runSuiteAndCollect("codespar_shop");
+        const unregCase = results.find((r) => r.name.includes("unregistered"));
+        expect(unregCase?.passed).toBe(false);
+        expect(unregCase?.error).toContain("error-unregistered");
+    });
+    it("fails the malformed-error case when the runtime accepts bad input", async () => {
+        teardown = installFakeBackend((tool, input) => input.action === "search" && !input.query
+            ? okResult({ rail: "vtex", products: [] }) // wrongly succeeds on empty query
+            : conformingShop(tool, input));
+        const results = await runSuiteAndCollect("codespar_shop");
+        const malformedCase = results.find((r) => r.name.includes("malformed"));
+        expect(malformedCase?.passed).toBe(false);
+        expect(malformedCase?.error).toContain("malformed input");
+    });
+    it("drives a single-shot tool (discover) with no state machine", async () => {
+        teardown = installFakeBackend((tool, input) => {
+            if (tool.endsWith("__unregistered_probe")) {
+                return {
+                    ...errResult(`Tool not registered: ${tool}`),
+                    tool,
+                };
+            }
+            // Malformed discover: empty input.
+            if (!input.use_case)
+                return errResult("use_case: required");
+            return okResult({
+                use_case: input.use_case,
+                search_strategy: "embedding",
+                recommended: null,
+                related: [],
+                next_steps: [],
+            });
+        });
+        const results = await runSuiteAndCollect("codespar_discover");
+        const failures = results.filter((r) => !r.passed);
+        expect(failures, JSON.stringify(failures, null, 2)).toEqual([]);
+        // 1 single-shot case + 2 error legs.
+        expect(results.length).toBe(3);
+        expect(DISCOVER_CONTRACT.stateMachine).toBeUndefined();
+    });
+    it("fails the single-shot case when a no-state-machine tool returns the wrong shape", async () => {
+        // Regression guard for the hollow-green hole: discover used to pass on
+        // `success: true` alone, so a scalar `output: 42` slipped through. With
+        // the descriptor's single-shot wire shape the case must now FAIL.
+        teardown = installFakeBackend((tool, input) => {
+            if (tool.endsWith("__unregistered_probe")) {
+                return { ...errResult(`Tool not registered: ${tool}`), tool };
+            }
+            if (!input.use_case)
+                return errResult("use_case: required");
+            // Succeeds, but the payload is a scalar — not a DiscoverResult.
+            return okResult(42);
+        });
+        const results = await runSuiteAndCollect("codespar_discover");
+        const happyPath = results.find((r) => r.name.includes("DiscoverResult"));
+        expect(happyPath?.passed).toBe(false);
+        expect(happyPath?.error).toContain("wire-shape");
+        expect(happyPath?.error).toContain("expected an object");
+        // The two error legs still pass — only the wire-shape teeth bite.
+        const otherFailures = results.filter((r) => !r.passed && !r.name.includes("DiscoverResult"));
+        expect(otherFailures, JSON.stringify(otherFailures, null, 2)).toEqual([]);
+    });
+});
+//# sourceMappingURL=conformance-kit.test.js.map

package/dist/testing/conformance-kit.test.js.map

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

package/dist/testing/contract-suite.d.ts

@@ -1,6 +1,40 @@
+/** One leg of the session contract suite. */
+export type ContractLeg = "execute" | "send" | "sendStream" | "connections" | "close";
+/** Options for {@link runContractSuite}. */
+export interface ContractSuiteOptions {
+    /**
+     * Server ids to post when opening the session. Defaults to `[]`, matching a
+     * consumer that brings no servers and relies on whatever the backend
+     * provisions by default.
+     */
+    servers?: string[];
+    /**
+     * Which legs to register. Defaults to all five legs in declaration order.
+     * Pass a subset to run only those legs (e.g. a consumer whose backend does
+     * not implement streaming can omit `"sendStream"`).
+     */
+    legs?: ContractLeg[];
+}
+/**
+ * Resolve which legs to run from the options. Returns all five legs (in
+ * declaration order) when `legs` is unset, otherwise the provided subset.
+ */
+export declare function selectLegs(opts?: ContractSuiteOptions): ContractLeg[];
+/** Build the session-create request body, defaulting `servers` to `[]`. */
+export declare function buildSessionCreateBody(opts?: ContractSuiteOptions): {
+    servers: string[];
+    user_id: string;
+};
 export declare class InvalidBaseUrlError extends Error {
     constructor(url: string);
 }
+/**
+ * Validate a backend base URL before any request is issued: only https://
+ * URLs and localhost are accepted, so a misconfigured environment fails
+ * early rather than leaking the apiKey to an arbitrary host. Shared by the
+ * meta-tool conformance kit.
+ */
+export declare function validateBaseUrl(rawUrl: string): void;
 /**
  * Register the full session contract test suite against a live backend.
  *
@@ -9,8 +43,14 @@ export declare class InvalidBaseUrlError extends Error {
  * invalid URLs so misconfigured CI environments fail early rather than
  * leaking the apiKey to an arbitrary host.
  *
+ * The optional `opts` argument lets a consumer choose which servers to post on
+ * session open and which subset of legs to run. With no `opts` (or with neither
+ * field set) the suite behaves exactly as before: it posts `servers: []` and
+ * registers all five legs in declaration order.
+ *
  * @param baseUrl - API base URL (e.g. "https://your-runtime.example" or "http://localhost:3000")
  * @param apiKey  - Bearer token for session creation
+ * @param opts    - Optional servers list and leg selection (see {@link ContractSuiteOptions})
  */
-export declare function runContractSuite(baseUrl: string, apiKey: string): void;
+export declare function runContractSuite(baseUrl: string, apiKey: string, opts?: ContractSuiteOptions): void;
 //# sourceMappingURL=contract-suite.d.ts.map

package/dist/testing/contract-suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract-suite.d.ts","sourceRoot":"","sources":["../../src/testing/contract-suite.ts"],"names":[],"mappings":"AAGA,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,GAAG,EAAE,MAAM;CAMxB;AAmKD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA8EtE"}
+{"version":3,"file":"contract-suite.d.ts","sourceRoot":"","sources":["../../src/testing/contract-suite.ts"],"names":[],"mappings":"AAGA,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,CAAC;AAEtF,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;CACtB;AAWD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,WAAW,EAAE,CAErE;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAEA;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,GAAG,EAAE,MAAM;CAMxB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAUpD;AA2JD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,oBAAoB,GAC1B,IAAI,CA0FN"}