@codespar/sdk 0.9.0 → 0.10.0

package/dist/__tests__/forward-mocks.test.js

@@ -0,0 +1,134 @@
+/**
+ * Tests for the createSession body builder's `mocks` forwarding.
+ *
+ * Asserts:
+ *   - Wire-neutrality: a cs.create without `mocks` produces a body
+ *     byte-identical to today's shape (R18).
+ *   - Forwarded shape: a cs.create with `mocks` includes the field
+ *     verbatim — no SDK-side rewriting of canonical names.
+ *   - Empty `mocks: {}` is forwarded (the backend accepts; strict-
+ *     mode R3a activates only on non-empty maps).
+ *   - Double-underscore key form reaches the backend unrewritten
+ *     so the canonical-form rejection surfaces at the right layer.
+ */
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { CodeSpar } from "../index.js";
+function mockSessionResponse() {
+    return {
+        ok: true,
+        status: 201,
+        text: async () => "",
+        json: async () => ({
+            id: "ses_demo",
+            org_id: "org_demo",
+            user_id: "user_demo",
+            servers: ["asaas"],
+            status: "active",
+            created_at: new Date().toISOString(),
+            closed_at: null,
+        }),
+    };
+}
+describe("createSession body builder forwards mocks", () => {
+    const originalFetch = globalThis.fetch;
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    it("omits mocks key from the wire body when undefined (R18 wire-neutral)", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", { servers: ["asaas"] });
+        const init = fetchMock.mock
+            .calls[0][1];
+        const body = JSON.parse(init.body);
+        expect("mocks" in body).toBe(false);
+        expect(body).toEqual({ servers: ["asaas"], user_id: "user_demo" });
+    });
+    it("forwards mocks verbatim when present", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", {
+            servers: ["asaas"],
+            mocks: {
+                "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+            },
+        });
+        const init = fetchMock.mock
+            .calls[0][1];
+        const body = JSON.parse(init.body);
+        expect(body.mocks).toEqual({
+            "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+        });
+    });
+    it("accepts and forwards an empty mocks={} body", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", { servers: ["asaas"], mocks: {} });
+        const init = fetchMock.mock
+            .calls[0][1];
+        const body = JSON.parse(init.body);
+        expect(body.mocks).toEqual({});
+    });
+    it("does NOT rewrite double-underscore keys — they reach the backend verbatim", async () => {
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", {
+            servers: ["asaas"],
+            mocks: { asaas__create_payment: { id: "pay_test_42" } },
+        });
+        const init = fetchMock.mock
+            .calls[0][1];
+        const body = JSON.parse(init.body);
+        const mocks = body.mocks;
+        expect(Object.keys(mocks)).toEqual(["asaas__create_payment"]);
+    });
+    it("matches the canonical fixture byte-for-byte when the same input lands", async () => {
+        // Same canonical body used by the Python parity test.
+        const fetchMock = vi
+            .fn()
+            .mockResolvedValueOnce(mockSessionResponse());
+        globalThis.fetch = fetchMock;
+        const cs = new CodeSpar({
+            apiKey: "csk_live_test",
+            baseUrl: "https://api.example.com",
+        });
+        await cs.create("user_demo", {
+            servers: ["asaas"],
+            mocks: {
+                "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+                "asaas/get_payment": [
+                    { id: "pay_test_42", status: "PENDING" },
+                    { id: "pay_test_42", status: "CONFIRMED" },
+                ],
+            },
+        });
+        const init = fetchMock.mock
+            .calls[0][1];
+        expect(init.body).toBe('{"servers":["asaas"],"user_id":"user_demo","mocks":{"asaas/create_payment":{"id":"pay_test_42","status":"PENDING"},"asaas/get_payment":[{"id":"pay_test_42","status":"PENDING"},{"id":"pay_test_42","status":"CONFIRMED"}]}}');
+    });
+});
+//# sourceMappingURL=forward-mocks.test.js.map

package/dist/__tests__/forward-mocks.test.js.map

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

package/dist/__tests__/mocks-wire-parity.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Wire-shape parity test for the test-mode mocks field.
+ *
+ * Asserts that the TypeScript SessionConfig type carries the optional
+ * `mocks` field with the right shape, and that the serialized form
+ * matches the canonical fixture used by the Python SDK's parallel
+ * test. Both languages serialize the same example to byte-identical
+ * JSON; any drift here is a wire-contract break.
+ *
+ * The canonical fixture lives at packages/python/tests/_fixtures/
+ * mocks_canonical.json — kept in sync by hand. Future contributors
+ * MUST update both files together when extending the example.
+ */
+export {};
+//# sourceMappingURL=mocks-wire-parity.test.d.ts.map

package/dist/__tests__/mocks-wire-parity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks-wire-parity.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mocks-wire-parity.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/__tests__/mocks-wire-parity.test.js

@@ -0,0 +1,71 @@
+/**
+ * Wire-shape parity test for the test-mode mocks field.
+ *
+ * Asserts that the TypeScript SessionConfig type carries the optional
+ * `mocks` field with the right shape, and that the serialized form
+ * matches the canonical fixture used by the Python SDK's parallel
+ * test. Both languages serialize the same example to byte-identical
+ * JSON; any drift here is a wire-contract break.
+ *
+ * The canonical fixture lives at packages/python/tests/_fixtures/
+ * mocks_canonical.json — kept in sync by hand. Future contributors
+ * MUST update both files together when extending the example.
+ */
+import { describe, it, expect } from "vitest";
+const CANONICAL_BODY = {
+    servers: ["asaas"],
+    user_id: "user_demo",
+    mocks: {
+        "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+        "asaas/get_payment": [
+            { id: "pay_test_42", status: "PENDING" },
+            { id: "pay_test_42", status: "CONFIRMED" },
+        ],
+    },
+};
+describe("MockObject + MockValue type aliases", () => {
+    it("accepts a plain dict as MockObject", () => {
+        const obj = { id: "pay_test_42", status: "PENDING" };
+        expect(obj.id).toBe("pay_test_42");
+    });
+    it("accepts a single MockObject as MockValue (static mock)", () => {
+        const v = { id: "pay_test_42", status: "PENDING" };
+        expect(v).toBeDefined();
+    });
+    it("accepts a MockObject array as MockValue (stateful mock)", () => {
+        const v = [
+            { id: "pay_test_42", status: "PENDING" },
+            { id: "pay_test_42", status: "CONFIRMED" },
+        ];
+        expect(Array.isArray(v)).toBe(true);
+    });
+});
+describe("CreateSessionOptions carries optional mocks field", () => {
+    it("accepts a SessionConfig with no mocks (wire-neutral)", () => {
+        const cfg = { servers: ["asaas"] };
+        expect(cfg.mocks).toBeUndefined();
+    });
+    it("accepts a SessionConfig with canonical mocks shape", () => {
+        const cfg = {
+            servers: ["asaas"],
+            mocks: {
+                "asaas/create_payment": { id: "pay_test_42", status: "PENDING" },
+                "asaas/get_payment": [
+                    { id: "pay_test_42", status: "PENDING" },
+                    { id: "pay_test_42", status: "CONFIRMED" },
+                ],
+            },
+        };
+        expect(cfg.mocks?.["asaas/create_payment"]).toBeDefined();
+    });
+});
+describe("Canonical body serializes to byte-identical JSON", () => {
+    it("matches the Python SDK fixture byte-for-byte", () => {
+        // The canonical body field order is preserved by the JSON.stringify
+        // contract used in createSession's body builder. If field ordering
+        // changes here, the Python side must change too.
+        const serialized = JSON.stringify(CANONICAL_BODY);
+        expect(serialized).toBe('{"servers":["asaas"],"user_id":"user_demo","mocks":{"asaas/create_payment":{"id":"pay_test_42","status":"PENDING"},"asaas/get_payment":[{"id":"pay_test_42","status":"PENDING"},{"id":"pay_test_42","status":"CONFIRMED"}]}}');
+    });
+});
+//# sourceMappingURL=mocks-wire-parity.test.js.map

package/dist/__tests__/mocks-wire-parity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks-wire-parity.test.js","sourceRoot":"","sources":["../../src/__tests__/mocks-wire-parity.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAI9C,MAAM,cAAc,GAAG;IACrB,OAAO,EAAE,CAAC,OAAO,CAAC;IAClB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE;QACL,sBAAsB,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;QAChE,mBAAmB,EAAE;YACnB,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;YACxC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;SAC3C;KACF;CACO,CAAC;AAEX,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAe,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACjE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAc,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC9D,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,GAAc;YACnB,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;YACxC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;SAC3C,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IACjE,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,GAAkB,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,GAAG,GAAkB;YACzB,OAAO,EAAE,CAAC,OAAO,CAAC;YAClB,KAAK,EAAE;gBACL,sBAAsB,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;gBAChE,mBAAmB,EAAE;oBACnB,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE;oBACxC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;iBAC3C;aACF;SACF,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAChE,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,oEAAoE;QACpE,mEAAmE;QACnE,iDAAiD;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAClD,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CACrB,8NAA8N,CAC/N,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/testing.test.d.ts

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

package/dist/__tests__/testing.test.d.ts.map

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

package/dist/__tests__/testing.test.js

@@ -0,0 +1,133 @@
+import { describe, it, expect } from "vitest";
+import { fakeSession } from "../testing/index.js";
+describe("@codespar/sdk/testing — exported surface", () => {
+    it("exports fakeSession and the ToolResult type from a single import", () => {
+        expect(typeof fakeSession).toBe("function");
+        // ToolResult is a type-only re-export; the assertion below proves it
+        // is usable in a value position via a typed identity function.
+        const passthrough = (r) => r;
+        const sample = {
+            success: true,
+            data: {},
+            error: null,
+            duration: 0,
+            server: "",
+            tool: "x",
+        };
+        expect(passthrough(sample)).toBe(sample);
+    });
+});
+describe("fakeSession — strict mode (default)", () => {
+    it("throws verbatim 'fakeSession: no response registered for tool <name>' on miss", async () => {
+        const session = fakeSession();
+        await expect(session.execute("asaas/create_payment", { value: 100 })).rejects.toThrow("fakeSession: no response registered for tool asaas/create_payment");
+    });
+    it("error message is byte-identical to the contract string", async () => {
+        const session = fakeSession();
+        let captured = null;
+        try {
+            await session.execute("foo/bar", {});
+        }
+        catch (err) {
+            captured = err;
+        }
+        expect(captured).toBeInstanceOf(Error);
+        expect(captured.message).toBe("fakeSession: no response registered for tool foo/bar");
+    });
+});
+describe("fakeSession — registered responses", () => {
+    it("returns the static ToolResult registered for a tool name", async () => {
+        const session = fakeSession({
+            "asaas/create_customer": {
+                success: true,
+                data: { id: "cus_test_1", name: "Maria" },
+                error: null,
+                duration: 0,
+                server: "asaas",
+                tool: "asaas/create_customer",
+            },
+        });
+        const result = await session.execute("asaas/create_customer", { name: "Maria" });
+        expect(result.success).toBe(true);
+        expect(result.data).toEqual({ id: "cus_test_1", name: "Maria" });
+        expect(result.tool).toBe("asaas/create_customer");
+    });
+});
+describe("fakeSession — per-tool function variant", () => {
+    it("invokes a sync response function with the call's params and returns its result", async () => {
+        const session = fakeSession({
+            "asaas/create_customer": (input) => ({
+                success: true,
+                data: { echoed: input },
+                error: null,
+                duration: 0,
+                server: "asaas",
+                tool: "asaas/create_customer",
+            }),
+        });
+        const result = await session.execute("asaas/create_customer", { name: "Joana" });
+        expect(result.data).toEqual({ echoed: { name: "Joana" } });
+    });
+    it("awaits a Promise-returning response function", async () => {
+        const session = fakeSession({
+            "asaas/create_customer": async (input) => ({
+                success: true,
+                data: { async_echoed: input },
+                error: null,
+                duration: 0,
+                server: "asaas",
+                tool: "asaas/create_customer",
+            }),
+        });
+        const result = await session.execute("asaas/create_customer", { name: "Joana" });
+        expect(result.data).toEqual({ async_echoed: { name: "Joana" } });
+    });
+});
+describe("fakeSession — lenient mode", () => {
+    it("returns {success:true, data:{}} for unregistered tools when lenient: true", async () => {
+        const session = fakeSession({}, { lenient: true });
+        const result = await session.execute("asaas/create_payment", { value: 100 });
+        expect(result.success).toBe(true);
+        expect(result.data).toEqual({});
+        expect(result.error).toBeNull();
+        expect(result.tool).toBe("asaas/create_payment");
+    });
+    it("does not override a registered failure response in lenient mode", async () => {
+        const session = fakeSession({
+            "asaas/create_payment": {
+                success: false,
+                data: null,
+                error: "boom",
+                duration: 0,
+                server: "asaas",
+                tool: "asaas/create_payment",
+            },
+        }, { lenient: true });
+        const result = await session.execute("asaas/create_payment", { value: 100 });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe("boom");
+    });
+});
+describe("fakeSession — Session interface conformance", () => {
+    it("returns a value assignable to Session without casts", () => {
+        // Compile-time check: the literal annotation forces structural conformance.
+        // If this file compiles, the conformance check has passed.
+        const session = fakeSession();
+        expect(typeof session.execute).toBe("function");
+        expect(typeof session.send).toBe("function");
+        expect(typeof session.sendStream).toBe("function");
+        expect(typeof session.proxyExecute).toBe("function");
+        expect(typeof session.authorize).toBe("function");
+        expect(typeof session.connections).toBe("function");
+        expect(typeof session.close).toBe("function");
+        expect(typeof session.discover).toBe("function");
+        expect(typeof session.connectionWizard).toBe("function");
+        expect(typeof session.charge).toBe("function");
+        expect(typeof session.ship).toBe("function");
+        expect(typeof session.paymentStatus).toBe("function");
+        expect(typeof session.paymentStatusStream).toBe("function");
+        expect(typeof session.verificationStatus).toBe("function");
+        expect(typeof session.verificationStatusStream).toBe("function");
+    });
+});
+//# sourceMappingURL=testing.test.js.map

package/dist/__tests__/testing.test.js.map

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

package/dist/__tests__/tool-result-codes.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tool-result code guard tests.
+ *
+ * Asserts:
+ *   - Positive + negative paths per guard.
+ *   - Sibling-field-missing fixtures — a well-formed `code` with
+ *     missing required siblings (e.g. `rule_id` for policy_denied)
+ *     returns false. The guard does not narrow on the discriminant
+ *     alone.
+ *   - Unknown-code defense-in-depth — an unknown `code` value never
+ *     narrows positive on any guard.
+ *   - assertExhaustiveToolResult compiles when every variant is
+ *     handled (the test below is the compile-time witness).
+ *   - output.code vs error_code disagreement — guards key on the
+ *     `code` field on the payload, ignoring sibling discrepancies.
+ */
+export {};
+//# sourceMappingURL=tool-result-codes.test.d.ts.map

package/dist/__tests__/tool-result-codes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-codes.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-result-codes.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/tool-result-codes.test.js

@@ -0,0 +1,164 @@
+/**
+ * Tool-result code guard tests.
+ *
+ * Asserts:
+ *   - Positive + negative paths per guard.
+ *   - Sibling-field-missing fixtures — a well-formed `code` with
+ *     missing required siblings (e.g. `rule_id` for policy_denied)
+ *     returns false. The guard does not narrow on the discriminant
+ *     alone.
+ *   - Unknown-code defense-in-depth — an unknown `code` value never
+ *     narrows positive on any guard.
+ *   - assertExhaustiveToolResult compiles when every variant is
+ *     handled (the test below is the compile-time witness).
+ *   - output.code vs error_code disagreement — guards key on the
+ *     `code` field on the payload, ignoring sibling discrepancies.
+ */
+import { describe, it, expect } from "vitest";
+import { TOOL_RESULT_CODES, ToolResultCode, assertExhaustiveToolResult, isApprovalRequired, isMocksEngineError, isMocksExhausted, isPolicyDenied, isToolNotMocked, } from "../tool-result-codes.js";
+describe("TOOL_RESULT_CODES set", () => {
+    it("includes the five canonical codes", () => {
+        expect(TOOL_RESULT_CODES).toContain("policy_denied");
+        expect(TOOL_RESULT_CODES).toContain("approval_required");
+        expect(TOOL_RESULT_CODES).toContain("mocks_exhausted");
+        expect(TOOL_RESULT_CODES).toContain("mocks_engine_error");
+        expect(TOOL_RESULT_CODES).toContain("tool_not_mocked");
+    });
+});
+describe("isPolicyDenied", () => {
+    it("returns true for a well-formed policy_denied output", () => {
+        const out = {
+            code: ToolResultCode.PolicyDenied,
+            rule_id: "spend_cap",
+            message: "exceeds tenant cap",
+        };
+        expect(isPolicyDenied(out)).toBe(true);
+    });
+    it("returns false when rule_id is missing", () => {
+        const out = {
+            code: ToolResultCode.PolicyDenied,
+            message: "missing rule",
+        };
+        expect(isPolicyDenied(out)).toBe(false);
+    });
+    it("returns false when message is missing", () => {
+        const out = {
+            code: ToolResultCode.PolicyDenied,
+            rule_id: "spend_cap",
+        };
+        expect(isPolicyDenied(out)).toBe(false);
+    });
+    it("returns false on a foreign discriminant", () => {
+        const out = {
+            code: "approval_required",
+            rule_id: "x",
+            message: "y",
+        };
+        expect(isPolicyDenied(out)).toBe(false);
+    });
+    it("returns false on an unknown code (defense in depth)", () => {
+        const out = {
+            code: "totally_made_up",
+            rule_id: "x",
+            message: "y",
+        };
+        expect(isPolicyDenied(out)).toBe(false);
+    });
+    it("returns false on null/undefined/non-object", () => {
+        expect(isPolicyDenied(null)).toBe(false);
+        expect(isPolicyDenied(undefined)).toBe(false);
+        expect(isPolicyDenied("policy_denied")).toBe(false);
+    });
+});
+describe("isApprovalRequired", () => {
+    it("returns true for a well-formed approval_required output", () => {
+        const out = {
+            code: ToolResultCode.ApprovalRequired,
+            approval_id: "apr_abc",
+            expires_at: "2026-12-01T00:00:00Z",
+            message: "approve the transfer",
+        };
+        expect(isApprovalRequired(out)).toBe(true);
+    });
+    it("returns false when approval_id is missing", () => {
+        const out = {
+            code: ToolResultCode.ApprovalRequired,
+            expires_at: "2026-12-01T00:00:00Z",
+            message: "x",
+        };
+        expect(isApprovalRequired(out)).toBe(false);
+    });
+    it("returns false when expires_at is missing", () => {
+        const out = {
+            code: ToolResultCode.ApprovalRequired,
+            approval_id: "apr_abc",
+            message: "x",
+        };
+        expect(isApprovalRequired(out)).toBe(false);
+    });
+    it("returns false when message is missing", () => {
+        const out = {
+            code: ToolResultCode.ApprovalRequired,
+            approval_id: "apr_abc",
+            expires_at: "x",
+        };
+        expect(isApprovalRequired(out)).toBe(false);
+    });
+});
+describe("isMocksExhausted and isMocksEngineError", () => {
+    it("isMocksExhausted: positive + sibling-missing", () => {
+        expect(isMocksExhausted({ code: ToolResultCode.MocksExhausted, message: "drained" })).toBe(true);
+        expect(isMocksExhausted({ code: ToolResultCode.MocksExhausted })).toBe(false);
+    });
+    it("isMocksEngineError: positive + sibling-missing", () => {
+        expect(isMocksEngineError({
+            code: ToolResultCode.MocksEngineError,
+            message: "consume failed",
+        })).toBe(true);
+        expect(isMocksEngineError({ code: ToolResultCode.MocksEngineError })).toBe(false);
+    });
+});
+describe("isToolNotMocked", () => {
+    it("returns true with tool_name + message", () => {
+        expect(isToolNotMocked({
+            code: ToolResultCode.ToolNotMocked,
+            tool_name: "asaas/create_payment",
+            message: "not in mocks map",
+        })).toBe(true);
+    });
+    it("returns false when tool_name is missing", () => {
+        expect(isToolNotMocked({ code: ToolResultCode.ToolNotMocked, message: "x" })).toBe(false);
+    });
+});
+describe("assertExhaustiveToolResult", () => {
+    it("compiles when every code variant is handled", () => {
+        // The test BODY here is the compile-time witness; runtime asserts
+        // the unreachable-default branch throws on a hostile cast.
+        function describe(value) {
+            switch (value.code) {
+                case ToolResultCode.PolicyDenied:
+                    return "denied";
+                case ToolResultCode.ApprovalRequired:
+                    return "approval";
+                case ToolResultCode.MocksExhausted:
+                    return "exhausted";
+                case ToolResultCode.MocksEngineError:
+                    return "engine";
+                case ToolResultCode.ToolNotMocked:
+                    return "not_mocked";
+                default:
+                    // If a 6th code lands without this branch being updated, TS
+                    // fails: assertExhaustiveToolResult(value) would error at
+                    // compile time on a non-never argument.
+                    return assertExhaustiveToolResult(value);
+            }
+        }
+        expect(describe({
+            code: ToolResultCode.PolicyDenied,
+            rule_id: "x",
+            message: "y",
+        })).toBe("denied");
+        expect(() => assertExhaustiveToolResult({ code: "rogue" })).toThrow(/tool-result-codes/i);
+    });
+});
+//# sourceMappingURL=tool-result-codes.test.js.map

package/dist/__tests__/tool-result-codes.test.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Structured exception for every transport-failure path through the
+ * SDK. Replaces the old `throw new Error("send failed: 500 ...")`
+ * shape, so callers can branch on `e.code` rather than parsing
+ * `e.message` strings.
+ *
+ * The reserved code namespace covers the hosted-test-mode wire
+ * contract (tool-result codes + create-time envelope codes —
+ * see the README's "Reserved error codes" section). Customers
+ * extending CodesparApiError should prefix their own codes (e.g.
+ * `"myapp.policy_denied"`) to avoid collision with reserved values.
+ *
+ * `status: 0` is reserved for network errors that never reached the
+ * backend; the underlying `cause` carries the original `TypeError`
+ * or `DOMException` that `fetch` rejected with.
+ */
+export interface CodesparApiErrorOptions {
+    status: number;
+    code?: string;
+    body?: unknown;
+    cause?: unknown;
+}
+export declare class CodesparApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly body?: unknown;
+    constructor(message: string, options: CodesparApiErrorOptions);
+}
+/**
+ * Build the canonical error message + extract the structured code +
+ * preserve the parsed body. Centralised so every transport call site
+ * surfaces the same shape — a customer parsing `e.message` is
+ * already on the deprecated path; new code branches on `e.code`.
+ */
+export declare function throwFromResponse(response: Response, what: string): Promise<never>;
+/**
+ * Convert a `fetch` rejection (network error, abort, DNS, TLS, etc.)
+ * into a CodesparApiError with `status: 0`. Preserves the underlying
+ * error as `cause` so callers debugging a transport failure can dig
+ * into the original `TypeError`.
+ */
+export declare function networkErrorToApiError(cause: unknown, what: string): CodesparApiError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;CAY9D;AAkCD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,CAAC,CAehB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAMrF"}