@codespar/sdk 0.3.0 → 0.10.0

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

@@ -0,0 +1,82 @@
+/**
+ * Tool-result code helpers — type-narrowed guards for the discriminated
+ * `tool_result.output` union surfaced on streamed `ToolCallRecord`
+ * values.
+ *
+ * The five variants are inert wire shapes — they only describe what the
+ * backend may stamp on `tool_result.output`. The guards turn `unknown`
+ * into one of the five `*Output` interfaces so callers can branch
+ * without casting.
+ *
+ * Each guard checks both the `code` discriminant against
+ * TOOL_RESULT_CODES AND its own required sibling fields — so a
+ * well-formed `code` with a missing sibling returns false rather
+ * than narrowing positive on the discriminant alone. The exhaustive-
+ * match utility (`assertExhaustiveToolResult`) makes a switch over
+ * ToolResultCode fail to compile if a sixth variant lands without
+ * the consumer updating their handler.
+ */
+import type { ToolCallRecord } from "@codespar/types";
+export declare const ToolResultCode: {
+    readonly PolicyDenied: "policy_denied";
+    readonly ApprovalRequired: "approval_required";
+    readonly MocksExhausted: "mocks_exhausted";
+    readonly MocksEngineError: "mocks_engine_error";
+    readonly ToolNotMocked: "tool_not_mocked";
+};
+export type ToolResultCode = (typeof ToolResultCode)[keyof typeof ToolResultCode];
+export declare const TOOL_RESULT_CODES: ReadonlySet<ToolResultCode>;
+export interface PolicyDeniedOutput {
+    code: typeof ToolResultCode.PolicyDenied;
+    rule_id: string;
+    message: string;
+}
+export interface ApprovalRequiredOutput {
+    code: typeof ToolResultCode.ApprovalRequired;
+    approval_id: string;
+    expires_at: string;
+    message: string;
+}
+export interface MocksExhaustedOutput {
+    code: typeof ToolResultCode.MocksExhausted;
+    message: string;
+}
+export interface MocksEngineErrorOutput {
+    code: typeof ToolResultCode.MocksEngineError;
+    message: string;
+}
+export interface ToolNotMockedOutput {
+    code: typeof ToolResultCode.ToolNotMocked;
+    tool_name: string;
+    message: string;
+}
+export type ToolResultOutcome = PolicyDeniedOutput | ApprovalRequiredOutput | MocksExhaustedOutput | MocksEngineErrorOutput | ToolNotMockedOutput;
+export type PolicyDeniedToolCall = ToolCallRecord & {
+    output: PolicyDeniedOutput;
+};
+export type ApprovalRequiredToolCall = ToolCallRecord & {
+    output: ApprovalRequiredOutput;
+};
+export type MocksExhaustedToolCall = ToolCallRecord & {
+    output: MocksExhaustedOutput;
+};
+export type MocksEngineErrorToolCall = ToolCallRecord & {
+    output: MocksEngineErrorOutput;
+};
+export type ToolNotMockedToolCall = ToolCallRecord & {
+    output: ToolNotMockedOutput;
+};
+export declare function isPolicyDenied(value: unknown): value is PolicyDeniedOutput;
+export declare function isApprovalRequired(value: unknown): value is ApprovalRequiredOutput;
+export declare function isMocksExhausted(value: unknown): value is MocksExhaustedOutput;
+export declare function isMocksEngineError(value: unknown): value is MocksEngineErrorOutput;
+export declare function isToolNotMocked(value: unknown): value is ToolNotMockedOutput;
+/**
+ * Exhaustive-match witness. A `switch` over `ToolResultCode` should
+ * pass `value` here in the default branch — TS fails to compile if
+ * `value` isn't narrowed to `never`, i.e. if a code variant escaped
+ * the switch. The runtime body throws so a hostile cast at runtime
+ * doesn't silently swallow an unknown code.
+ */
+export declare function assertExhaustiveToolResult(value: never): never;
+//# sourceMappingURL=tool-result-codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-codes.d.ts","sourceRoot":"","sources":["../src/tool-result-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,cAAc,CAMxD,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,cAAc,CAAC,YAAY,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,cAAc,CAAC,gBAAgB,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,cAAc,CAAC,cAAc,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,cAAc,CAAC,gBAAgB,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,cAAc,CAAC,aAAa,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,GACtB,mBAAmB,CAAC;AAIxB,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,MAAM,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,cAAc,GAAG;IACtD,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG;IACpD,MAAM,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,cAAc,GAAG;IACtD,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IACnD,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAWF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAM1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAOlF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAK9E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAKlF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAM5E;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAI9D"}

package/dist/tool-result-codes.js

@@ -0,0 +1,99 @@
+/**
+ * Tool-result code helpers — type-narrowed guards for the discriminated
+ * `tool_result.output` union surfaced on streamed `ToolCallRecord`
+ * values.
+ *
+ * The five variants are inert wire shapes — they only describe what the
+ * backend may stamp on `tool_result.output`. The guards turn `unknown`
+ * into one of the five `*Output` interfaces so callers can branch
+ * without casting.
+ *
+ * Each guard checks both the `code` discriminant against
+ * TOOL_RESULT_CODES AND its own required sibling fields — so a
+ * well-formed `code` with a missing sibling returns false rather
+ * than narrowing positive on the discriminant alone. The exhaustive-
+ * match utility (`assertExhaustiveToolResult`) makes a switch over
+ * ToolResultCode fail to compile if a sixth variant lands without
+ * the consumer updating their handler.
+ */
+export const ToolResultCode = {
+    PolicyDenied: "policy_denied",
+    ApprovalRequired: "approval_required",
+    MocksExhausted: "mocks_exhausted",
+    MocksEngineError: "mocks_engine_error",
+    ToolNotMocked: "tool_not_mocked",
+};
+export const TOOL_RESULT_CODES = new Set([
+    ToolResultCode.PolicyDenied,
+    ToolResultCode.ApprovalRequired,
+    ToolResultCode.MocksExhausted,
+    ToolResultCode.MocksEngineError,
+    ToolResultCode.ToolNotMocked,
+]);
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readStringField(obj, key) {
+    const v = obj[key];
+    return typeof v === "string" ? v : null;
+}
+export function isPolicyDenied(value) {
+    if (!isObject(value))
+        return false;
+    if (value.code !== ToolResultCode.PolicyDenied)
+        return false;
+    if (!TOOL_RESULT_CODES.has(value.code))
+        return false;
+    return readStringField(value, "rule_id") !== null
+        && readStringField(value, "message") !== null;
+}
+export function isApprovalRequired(value) {
+    if (!isObject(value))
+        return false;
+    if (value.code !== ToolResultCode.ApprovalRequired)
+        return false;
+    if (!TOOL_RESULT_CODES.has(value.code))
+        return false;
+    return readStringField(value, "approval_id") !== null
+        && readStringField(value, "expires_at") !== null
+        && readStringField(value, "message") !== null;
+}
+export function isMocksExhausted(value) {
+    if (!isObject(value))
+        return false;
+    if (value.code !== ToolResultCode.MocksExhausted)
+        return false;
+    if (!TOOL_RESULT_CODES.has(value.code))
+        return false;
+    return readStringField(value, "message") !== null;
+}
+export function isMocksEngineError(value) {
+    if (!isObject(value))
+        return false;
+    if (value.code !== ToolResultCode.MocksEngineError)
+        return false;
+    if (!TOOL_RESULT_CODES.has(value.code))
+        return false;
+    return readStringField(value, "message") !== null;
+}
+export function isToolNotMocked(value) {
+    if (!isObject(value))
+        return false;
+    if (value.code !== ToolResultCode.ToolNotMocked)
+        return false;
+    if (!TOOL_RESULT_CODES.has(value.code))
+        return false;
+    return readStringField(value, "tool_name") !== null
+        && readStringField(value, "message") !== null;
+}
+/**
+ * Exhaustive-match witness. A `switch` over `ToolResultCode` should
+ * pass `value` here in the default branch — TS fails to compile if
+ * `value` isn't narrowed to `never`, i.e. if a code variant escaped
+ * the switch. The runtime body throws so a hostile cast at runtime
+ * doesn't silently swallow an unknown code.
+ */
+export function assertExhaustiveToolResult(value) {
+    throw new Error(`tool-result-codes: unexpected output variant ${JSON.stringify(value)}`);
+}
+//# sourceMappingURL=tool-result-codes.js.map

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

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

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { ToolResult } from "@codespar/types";
+import type { MockValue, ToolResult } from "@codespar/types";
 export interface CodeSparConfig {
     /** API key for managed mode. Obtain from dashboard.codespar.dev */
     apiKey?: string;
@@ -24,6 +24,22 @@ export interface SessionConfig {
     metadata?: Record<string, string>;
     /** Optional project scope. Defaults to the org's default project when omitted. */
     projectId?: string;
+    /**
+     * Test-mode mocks. Map of canonical tool names (slash form,
+     * `^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9_-]*$` — e.g.
+     * `asaas/create_payment`) to mock responses. Values are either a
+     * single MockObject (static mock) or an array of MockObject
+     * (stateful mock, consumed in order).
+     *
+     * Requires a `csk_test_*` key against a `test`-environment project
+     * — the backend rejects with `mocks_not_permitted` otherwise.
+     * Forwarded verbatim to `POST /v1/sessions` so the OSS-runtime
+     * double-underscore form (`asaas__create_payment`) reaches the
+     * backend unrewritten and surfaces as `mocks_invalid`. An empty
+     * `{}` is accepted; strict-mode (R3a) activates only on non-empty
+     * maps.
+     */
+    mocks?: Record<string, MockValue>;
 }
 export interface Tool {
     /** Tool name (e.g. "codespar_pay") */
@@ -85,6 +101,7 @@ export declare const SessionConfigSchema: z.ZodObject<{
     }>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     projectId: z.ZodOptional<z.ZodString>;
+    mocks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">]>>>;
 }, "strip", z.ZodTypeAny, {
     servers?: string[] | undefined;
     preset?: "brazilian" | "mexican" | "argentinian" | "colombian" | "all" | undefined;
@@ -94,6 +111,7 @@ export declare const SessionConfigSchema: z.ZodObject<{
     } | undefined;
     metadata?: Record<string, string> | undefined;
     projectId?: string | undefined;
+    mocks?: Record<string, Record<string, unknown> | Record<string, unknown>[]> | undefined;
 }, {
     servers?: string[] | undefined;
     preset?: "brazilian" | "mexican" | "argentinian" | "colombian" | "all" | undefined;
@@ -103,5 +121,6 @@ export declare const SessionConfigSchema: z.ZodObject<{
     } | undefined;
     metadata?: Record<string, string> | undefined;
     projectId?: string | undefined;
+    mocks?: Record<string, Record<string, unknown> | Record<string, unknown>[]> | undefined;
 }>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,KAAK,CAAC;IACvE,oCAAoC;IACpC,iBAAiB,CAAC,EAAE;QAClB,4CAA4C;QAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,wDAAwD;QACxD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,IAAI;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3F,0DAA0D;IAC1D,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,uCAAuC;IACvC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,6BAA6B;IAC7B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,oCAAoC;IACpC,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;QACnC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW9B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7D,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,KAAK,CAAC;IACvE,oCAAoC;IACpC,iBAAiB,CAAC,EAAE;QAClB,4CAA4C;QAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,wDAAwD;QACxD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACnC;AAID,MAAM,WAAW,IAAI;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3F,0DAA0D;IAC1D,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,uCAAuC;IACvC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,6BAA6B;IAC7B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,oCAAoC;IACpC,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;QACnC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY9B,CAAC"}

package/dist/types.js

@@ -1,5 +1,12 @@
 import { z } from "zod";
 /* ── Validation schemas ───────────────────────────────────────── */
+// Mock values pass through verbatim — the backend owns the strict
+// validation, so the client-side schema accepts any object shape
+// rather than re-encoding the rules and risking drift.
+const MockValueSchema = z.union([
+    z.record(z.unknown()),
+    z.array(z.record(z.unknown())),
+]);
 export const SessionConfigSchema = z.object({
     servers: z.array(z.string()).optional(),
     preset: z.enum(["brazilian", "mexican", "argentinian", "colombian", "all"]).optional(),
@@ -11,5 +18,6 @@ export const SessionConfigSchema = z.object({
         .optional(),
     metadata: z.record(z.string()).optional(),
     projectId: z.string().regex(/^prj_[A-Za-z0-9]{16}$/).optional(),
+    mocks: z.record(MockValueSchema).optional(),
 });
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuFxB,qEAAqE;AAErE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtF,iBAAiB,EAAE,CAAC;SACjB,MAAM,CAAC;QACN,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;SACD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;CAChE,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuGxB,qEAAqE;AAErE,kEAAkE;AAClE,iEAAiE;AACjE,uDAAuD;AACvD,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IAC9B,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtF,iBAAiB,EAAE,CAAC;SACjB,MAAM,CAAC;QACN,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;SACD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,QAAQ,EAAE;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codespar/sdk",
-  "version": "0.3.0",
+  "version": "0.10.0",
   "description": "Commerce SDK for AI agents — sessions, managed auth, Complete Loop orchestration for Latin American APIs",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./testing": {
+      "import": "./dist/testing/index.js",
+      "types": "./dist/testing/index.d.ts"
     }
   },
   "files": [
@@ -48,7 +52,7 @@
   },
   "dependencies": {
     "zod": "^3.24.0",
-    "@codespar/types": "^0.1.0"
+    "@codespar/types": "^0.10.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",