@qodo/sdk 0.13.4 → 2.0.0-next.0

package/dist/client/tools/defineFunctionTool.js

@@ -0,0 +1,190 @@
+/**
+ * `defineFunctionTool(opts)` — Zod-schema → OpenAI function-tool helper.
+ *
+ * Closes the parity gap identified by the 2026-05-21 ADK comparison
+ * (see `docs/sdk2/research/2026-05-21-google-adk-vs-qodo-ts-sdk.md`,
+ * Opportunity 4 — auto-derive JSON Schema from a Zod schema instead of
+ * hand-authoring it on every `FunctionToolDef`). Google ADK's
+ * `FunctionTool(func)` derives the schema from Python type hints
+ * (`tools/function_tool.py:42-150`); qodo-ts-sdk's pre-S3 surface
+ * required the consumer to ship the full `parameters: { type: 'object',
+ * properties: {…} }` blob inline.
+ *
+ * The helper does three things in one call:
+ *
+ *   1. Converts the supplied Zod schema to JSON Schema via Zod 4's
+ *      built-in `z.toJSONSchema()`. (`zod-to-json-schema` was the
+ *      pre-2025 path but the package was deprecated in November 2025;
+ *      Zod 4 ships the same capability natively, so we use the built-in
+ *      and avoid a redundant dependency.) Targets `draft-07` — the
+ *      OpenAI-compatible JSON Schema dialect; the produced body drops
+ *      directly into the function-tool wire shape with no further
+ *      shimming.
+ *   2. Returns a fully-formed `FunctionToolDef` that drops into
+ *      `InlineAgentSpec.tools[]` with zero further wiring.
+ *   3. Attaches the runtime `handler` on a symbol-keyed property so
+ *      `JSON.stringify` / structural cloning / spread ignore it (wire
+ *      serialization stays clean — the handler is SDK-local) and the
+ *      SDK can route inbound `tool.request` envelopes for this tool's
+ *      `name` to the right callback automatically at
+ *      `tasks.startWithAgent` / `tasks.startWithGraph` time.
+ *
+ * The handler's `args` parameter is statically typed against
+ * `z.infer<typeof parameters>`, so the consumer gets compile-time
+ * checking against the schema shape — mismatched destructures fail at
+ * the call site rather than at runtime when QAR sends the call. The
+ * router also Zod-parses inbound args before invoking the handler, so
+ * `.default()` values are applied and `.transform()` / `.refine()`
+ * chains run as written; argument-validation failures map to per-call
+ * `outcome: 'error'` without the handler running.
+ *
+ * Backward compatibility: pre-S3 hand-authored `FunctionToolDef`
+ * literals continue to work unchanged. The helper is purely additive —
+ * `InlineAgentSpec.tools[]` accepts both shapes, and the SDK's
+ * auto-bind step (see `ToolClient.bindFunctionToolDefs`) is a no-op for
+ * tools that don't carry the handler symbol.
+ */
+import { z } from 'zod';
+import { mergeApprovalAnnotations, normalizeApprovalConfig, } from './approval.js';
+/**
+ * Symbol used to attach the SDK-local handler bag to a
+ * `FunctionToolDef` produced by {@link defineFunctionTool}. Symbol-keyed
+ * so:
+ *
+ *   - `JSON.stringify` ignores the property (the wire-serialized spec
+ *     stays clean without an explicit strip step at every wire
+ *     boundary).
+ *   - Object spread / `structuredClone` don't carry the handler across
+ *     unless the runtime is opted into symbols (clones drop the handler
+ *     — defensive; consumers building wire payloads via `{ ...tool }`
+ *     don't accidentally try to ship a function).
+ *   - Property-name lookups via dot/bracket access don't collide with a
+ *     consumer-authored field.
+ *
+ * Exported (named) so the SDK's own bind step and unit tests can read
+ * it; consumer code rarely needs to touch it directly —
+ * {@link getFunctionToolHandler} is the safer accessor.
+ */
+export const FUNCTION_TOOL_HANDLER_KEY = Symbol.for('@qodo/sdk:functionToolHandler');
+/**
+ * Read the SDK-local handler bag off a `FunctionToolDef`. Returns
+ * `undefined` for hand-authored literals that don't carry the symbol —
+ * the SDK's bind step uses this to skip tools that don't auto-route.
+ */
+export function getFunctionToolHandler(def) {
+    return def[FUNCTION_TOOL_HANDLER_KEY];
+}
+/**
+ * Derive a `FunctionToolDef` from a Zod schema + handler.
+ *
+ * @example
+ *   import { defineFunctionTool } from '@qodo/sdk';
+ *   import { z } from 'zod';
+ *
+ *   const getCurrentTime = defineFunctionTool({
+ *     name: 'get_current_time',
+ *     description: 'Returns the current time in ISO 8601 format.',
+ *     parameters: z.object({
+ *       timezone: z
+ *         .string()
+ *         .describe('IANA timezone, defaults to UTC.')
+ *         .default('UTC'),
+ *     }),
+ *     handler: async ({ timezone }) => ({
+ *       time: new Date().toLocaleString('en-US', { timeZone: timezone }),
+ *     }),
+ *   });
+ *
+ *   const stream = client.tasks.startWithAgent({
+ *     agent: {
+ *       apiVersion: 'qar/v1',
+ *       instructions: 'Answer with the current time on request.',
+ *       model: 'gpt-4o',
+ *       tools: [getCurrentTime],
+ *     },
+ *   });
+ */
+export function defineFunctionTool(opts) {
+    if (typeof opts.name !== 'string' || opts.name.length === 0) {
+        throw new TypeError('defineFunctionTool: `name` is required and must be a non-empty string.');
+    }
+    if (typeof opts.handler !== 'function') {
+        throw new TypeError('defineFunctionTool: `handler` must be a function.');
+    }
+    if (opts.parameters === null || typeof opts.parameters !== 'object') {
+        throw new TypeError('defineFunctionTool: `parameters` must be a Zod schema.');
+    }
+    const parameters = deriveParametersJsonSchema(opts.parameters, opts.name);
+    const approval = normalizeApprovalConfig(opts.requireApproval);
+    // When the consumer opted into `requireApproval`, fold the
+    // sensitivity-driven advisory annotation overlay onto whatever
+    // `annotations` they already passed. Consumer-supplied fields win
+    // on collision — see {@link mergeApprovalAnnotations}.
+    const annotations = approval !== undefined
+        ? mergeApprovalAnnotations(opts.annotations, approval)
+        : opts.annotations;
+    const functionDef = {
+        name: opts.name,
+        ...(opts.description !== undefined && opts.description.length > 0
+            ? { description: opts.description }
+            : {}),
+        parameters,
+        ...(opts.strict !== undefined ? { strict: opts.strict } : {}),
+        ...(annotations !== undefined ? { annotations } : {}),
+    };
+    const def = {
+        type: 'function',
+        function: functionDef,
+    };
+    const bag = {
+        name: opts.name,
+        handler: opts.handler,
+        parameters: opts.parameters,
+        ...(approval !== undefined ? { approval } : {}),
+    };
+    // Non-enumerable, non-writable, non-configurable. `JSON.stringify`
+    // skips symbol-keyed props regardless of enumerability, but keeping
+    // it locked-down also stops a consumer accidentally re-binding the
+    // handler after construction (which the dispatcher cache would miss).
+    Object.defineProperty(def, FUNCTION_TOOL_HANDLER_KEY, {
+        value: bag,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+    return def;
+}
+/**
+ * Convert a Zod schema to the JSON Schema body OpenAI's function-tool
+ * shape expects. Uses Zod 4's native `z.toJSONSchema()`.
+ *
+ * `target: 'draft-07'` is the OpenAI-compatible JSON Schema dialect.
+ * `unrepresentable: 'any'` falls back to `{}` for Zod types that have
+ * no JSON Schema mapping (`z.bigint()`, `z.symbol()`, `z.function()`,
+ * etc.) instead of throwing — the function-tool's argument bag rarely
+ * needs those, and a hard throw would prevent the consumer from even
+ * reaching their first task dispatch. Conversion errors carry the tool
+ * name so consumers debugging a malformed schema can find the offending
+ * tool quickly.
+ */
+function deriveParametersJsonSchema(schema, toolName) {
+    let raw;
+    try {
+        raw = z.toJSONSchema(schema, { target: 'draft-07', unrepresentable: 'any' });
+    }
+    catch (err) {
+        throw new TypeError(`defineFunctionTool(${toolName}): could not derive JSON Schema from the supplied Zod schema. ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new TypeError(`defineFunctionTool(${toolName}): Zod produced a non-object JSON Schema; ` +
+            'wrap the parameters in `z.object({...})` so the function-tool body has a `properties` map.');
+    }
+    // Strip Zod's `$schema` declaration — OpenAI function-tool bodies
+    // don't carry it, and the wire validator is happier without
+    // unexpected top-level keys.
+    const { $schema: _drop, ...rest } = raw;
+    void _drop;
+    return rest;
+}
+//# sourceMappingURL=defineFunctionTool.js.map

package/dist/client/tools/defineFunctionTool.js.map

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

package/dist/client/transport.browser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Browser stub for `transport.ts`. The Node `defaultTransportFactory` uses
+ * the `ws` package and Node `Buffer`, neither of which exist in browser.
+ *
+ * Browser consumers must supply their own transport via `ClientOptions.transport`
+ * — typically a small adapter around `globalThis.WebSocket`. The QAR
+ * connection sends the bearer in the `Authorization` upgrade header; browser
+ * `WebSocket` doesn't support custom upgrade headers, so the recommended
+ * adapter passes the bearer via the `Sec-WebSocket-Protocol` field or a
+ * pre-signed URL — that decision belongs to the consumer.
+ *
+ * Calling `defaultTransportFactory` directly in browser throws so consumers
+ * who forgot to wire `transport:` get an actionable error rather than a
+ * cryptic "Buffer is not defined" runtime crash deep inside the factory.
+ */
+export type { WSTransport, WSTransportFactory, WSTransportFactoryArgs, WSEventHandlers, } from './transport.js';
+export { validateCloseReason, CLOSE_FRAME_REASON_MAX_BYTES, } from './transport.shared.js';
+import type { WSTransportFactory } from './transport.js';
+export declare const defaultTransportFactory: WSTransportFactory;
+//# sourceMappingURL=transport.browser.d.ts.map

package/dist/client/transport.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.browser.d.ts","sourceRoot":"","sources":["../../src/client/transport.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,eAAO,MAAM,uBAAuB,EAAE,kBAMrC,CAAC"}

package/dist/client/transport.browser.js

@@ -0,0 +1,29 @@
+/**
+ * Browser stub for `transport.ts`. The Node `defaultTransportFactory` uses
+ * the `ws` package and Node `Buffer`, neither of which exist in browser.
+ *
+ * Browser consumers must supply their own transport via `ClientOptions.transport`
+ * — typically a small adapter around `globalThis.WebSocket`. The QAR
+ * connection sends the bearer in the `Authorization` upgrade header; browser
+ * `WebSocket` doesn't support custom upgrade headers, so the recommended
+ * adapter passes the bearer via the `Sec-WebSocket-Protocol` field or a
+ * pre-signed URL — that decision belongs to the consumer.
+ *
+ * Calling `defaultTransportFactory` directly in browser throws so consumers
+ * who forgot to wire `transport:` get an actionable error rather than a
+ * cryptic "Buffer is not defined" runtime crash deep inside the factory.
+ */
+import { QodoClientOptionsError } from './errors.js';
+// Re-export the platform-neutral close-reason validator from the shared
+// module so browser bundles see the same `import { validateCloseReason
+// } from '@qodo/sdk'` surface as Node. Importing from
+// `./transport.shared.js` (not `./transport.js`) sidesteps the
+// `package.json.browser` remap, which would otherwise self-cycle on
+// `transport.browser.js → transport.js → transport.browser.js`.
+export { validateCloseReason, CLOSE_FRAME_REASON_MAX_BYTES, } from './transport.shared.js';
+export const defaultTransportFactory = async () => {
+    throw new QodoClientOptionsError('@qodo/sdk: defaultTransportFactory is Node-only. In browser bundles, pass ' +
+        '`transport: <your factory>` to QodoClient — typically a small adapter ' +
+        'around globalThis.WebSocket. See docs/sdk2 for an example.');
+};
+//# sourceMappingURL=transport.browser.js.map

package/dist/client/transport.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.browser.js","sourceRoot":"","sources":["../../src/client/transport.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AASrD,wEAAwE;AACxE,uEAAuE;AACvE,sDAAsD;AACtD,+DAA+D;AAC/D,oEAAoE;AACpE,gEAAgE;AAChE,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAI/B,MAAM,CAAC,MAAM,uBAAuB,GAAuB,KAAK,IAA0B,EAAE;IAC1F,MAAM,IAAI,sBAAsB,CAC9B,4EAA4E;QAC1E,wEAAwE;QACxE,4DAA4D,CAC/D,CAAC;AACJ,CAAC,CAAC"}

package/dist/client/transport.d.ts

@@ -0,0 +1,47 @@
+/**
+ * WebSocket transport abstraction.
+ *
+ * The default transport opens a real WS connection via the `ws` package; tests
+ * inject a mock factory so unit tests don't reach the network. Two contracts
+ * here: the `WSTransport` (write/close + isOpen) and the `WSTransportFactory`
+ * (returns a `Promise<WSTransport>` that resolves once the WS upgrade succeeds,
+ * or rejects with `QodoAuthError` on 401/403 and `Error` on other upgrade
+ * failures).
+ */
+export { validateCloseReason, CLOSE_FRAME_REASON_MAX_BYTES, } from './transport.shared.js';
+/**
+ * Live WebSocket the client owns after `connect()` returns. Outbound envelopes
+ * are JSON-encoded strings written via `send`; `close` triggers a normal
+ * close handshake. Read-side flows through the handlers passed to the factory.
+ */
+export interface WSTransport {
+    /** Write a frame. Backpressure semantics live one layer up in `Connection`. */
+    send(data: string): void;
+    /** Close the underlying socket. Idempotent. */
+    close(code?: number, reason?: string): void;
+    /** Whether the socket is currently in the `OPEN` state. */
+    readonly isOpen: boolean;
+}
+/** Read-side callbacks plumbed into the transport at construction time. */
+export interface WSEventHandlers {
+    /** A complete text frame arrived. The transport decodes binary→utf8 itself. */
+    onMessage(data: string): void;
+    /** Underlying socket error. Distinct from a clean close. */
+    onError(err: Error): void;
+    /** Socket closed. After this, the transport is dead — make a new one to reconnect. */
+    onClose(code: number, reason: string): void;
+}
+/** Construction args for a transport factory. */
+export interface WSTransportFactoryArgs {
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly handlers: WSEventHandlers;
+}
+/** Asynchronously open a WS connection. Resolves once the upgrade has succeeded. */
+export type WSTransportFactory = (args: WSTransportFactoryArgs) => Promise<WSTransport>;
+/**
+ * Default transport — uses the `ws` package via dynamic import so consumers
+ * who BYO a transport never need `ws` resolved.
+ */
+export declare const defaultTransportFactory: WSTransportFactory;
+//# sourceMappingURL=transport.d.ts.map

package/dist/client/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAG/B;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+CAA+C;IAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4DAA4D;IAC5D,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,sFAAsF;IACtF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,kBA+ErC,CAAC"}

package/dist/client/transport.js

@@ -0,0 +1,102 @@
+/**
+ * WebSocket transport abstraction.
+ *
+ * The default transport opens a real WS connection via the `ws` package; tests
+ * inject a mock factory so unit tests don't reach the network. Two contracts
+ * here: the `WSTransport` (write/close + isOpen) and the `WSTransportFactory`
+ * (returns a `Promise<WSTransport>` that resolves once the WS upgrade succeeds,
+ * or rejects with `QodoAuthError` on 401/403 and `Error` on other upgrade
+ * failures).
+ */
+import { QodoAuthError } from '../auth/index.js';
+// Re-export the platform-neutral close-reason validator from the shared
+// module so consumers reaching for `import { validateCloseReason } from
+// '@qodo/sdk'` get the same symbol on Node and browser. The shared
+// module lives outside the `package.json.browser` remap zone, which
+// avoids the esbuild "Detected cycle while resolving import" error that
+// would surface if `transport.browser.ts` re-exported from `transport.ts`.
+export { validateCloseReason, CLOSE_FRAME_REASON_MAX_BYTES, } from './transport.shared.js';
+import { validateCloseReason } from './transport.shared.js';
+/**
+ * Default transport — uses the `ws` package via dynamic import so consumers
+ * who BYO a transport never need `ws` resolved.
+ */
+export const defaultTransportFactory = async ({ url, headers, handlers }) => {
+    const wsModule = (await import('ws'));
+    const WS = wsModule.WebSocket;
+    return new Promise((resolve, reject) => {
+        const socket = new WS(url, { headers });
+        let resolved = false;
+        socket.on('open', () => {
+            resolved = true;
+            const transport = {
+                send: (data) => socket.send(data),
+                close: (code, reason) => {
+                    // `ws` accepts a string reason but the close-frame payload is bytes.
+                    if (code === undefined) {
+                        // `socket.close()` with no args drops `reason` entirely, so
+                        // there's nothing to validate — bailing here avoids throwing
+                        // for an overlong reason that would never reach the wire.
+                        socket.close();
+                        return;
+                    }
+                    // Validate UTF-8 byte length against the RFC 6455 cap so a
+                    // consumer passing a long reason gets a typed SDK error rather than
+                    // an opaque library crash.
+                    validateCloseReason(reason);
+                    socket.close(code, reason);
+                },
+                get isOpen() {
+                    return socket.readyState === WS.OPEN;
+                },
+            };
+            resolve(transport);
+        });
+        socket.on('message', (data) => {
+            // `ws` emits Buffer | ArrayBuffer | Buffer[]; we use the text protocol.
+            let text;
+            if (typeof data === 'string') {
+                text = data;
+            }
+            else if (data instanceof ArrayBuffer) {
+                text = Buffer.from(data).toString('utf-8');
+            }
+            else if (Array.isArray(data)) {
+                text = Buffer.concat(data).toString('utf-8');
+            }
+            else {
+                text = data.toString('utf-8');
+            }
+            handlers.onMessage(text);
+        });
+        socket.on('error', (err) => {
+            if (!resolved) {
+                // Connection-establishment failure — surface to the awaiter.
+                reject(err);
+                return;
+            }
+            handlers.onError(err);
+        });
+        socket.on('unexpected-response', (_req, res) => {
+            if (resolved)
+                return;
+            const code = res.statusCode ?? 0;
+            if (code === 401 || code === 403) {
+                reject(new QodoAuthError(`WebSocket upgrade rejected with HTTP ${code}`));
+            }
+            else {
+                reject(new Error(`WebSocket upgrade failed: HTTP ${code}`));
+            }
+        });
+        socket.on('close', (code, reasonBuf) => {
+            const reason = reasonBuf.toString('utf-8');
+            if (!resolved) {
+                // Closed before the upgrade completed.
+                reject(new Error(`WebSocket closed before open (code=${code}, reason=${reason})`));
+                return;
+            }
+            handlers.onClose(code, reason);
+        });
+    });
+};
+//# sourceMappingURL=transport.js.map

package/dist/client/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,wEAAwE;AACxE,wEAAwE;AACxE,mEAAmE;AACnE,oEAAoE;AACpE,wEAAwE;AACxE,2EAA2E;AAC3E,OAAO,EACL,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAoC5D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAuB,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC9F,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAwB,CAAC;IAC7D,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC;IAE9B,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAExC,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,SAAS,GAAgB;gBAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBACjC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;oBACtB,qEAAqE;oBACrE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;wBACvB,4DAA4D;wBAC5D,6DAA6D;wBAC7D,0DAA0D;wBAC1D,MAAM,CAAC,KAAK,EAAE,CAAC;wBACf,OAAO;oBACT,CAAC;oBACD,2DAA2D;oBAC3D,oEAAoE;oBACpE,2BAA2B;oBAC3B,mBAAmB,CAAC,MAAM,CAAC,CAAC;oBAC5B,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC7B,CAAC;gBACD,IAAI,MAAM;oBACR,OAAO,MAAM,CAAC,UAAU,KAAK,EAAE,CAAC,IAAI,CAAC;gBACvC,CAAC;aACF,CAAC;YACF,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAC5B,wEAAwE;YACxE,IAAI,IAAY,CAAC;YACjB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,IAAI,GAAG,IAAI,CAAC;YACd,CAAC;iBAAM,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;gBACvC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC7C,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAgB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAI,IAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;YACD,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,6DAA6D;gBAC7D,MAAM,CAAC,GAAG,CAAC,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC7C,IAAI,QAAQ;gBAAE,OAAO;YACrB,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,aAAa,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAY,EAAE,SAAiB,EAAE,EAAE;YACrD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,uCAAuC;gBACvC,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,IAAI,YAAY,MAAM,GAAG,CAAC,CAAC,CAAC;gBACnF,OAAO;YACT,CAAC;YACD,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/client/transport.shared.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Platform-neutral pieces of the transport seam.
+ *
+ * Lives in its own module so both the Node `transport.ts` factory and the
+ * browser `transport.browser.ts` stub can re-export the same symbols
+ * without a re-export cycle through `package.json.browser`'s
+ * `transport.js → transport.browser.js` remap.
+ *
+ * Today this file holds `validateCloseReason` + the RFC 6455 byte cap.
+ * Any future platform-neutral transport helper (header-shape validation,
+ * scheme normalization, etc.) belongs here for the same reason.
+ */
+/**
+ * RFC 6455 §5.5.1: the close-frame application body — the `reason` string
+ * after the 2-byte status code — must be ≤ 123 bytes when UTF-8 encoded.
+ * `ws` (and any spec-compliant peer) crashes when handed a longer value.
+ */
+export declare const CLOSE_FRAME_REASON_MAX_BYTES = 123;
+/**
+ * Validate that a WS close-frame reason fits in the RFC 6455 cap.
+ *
+ * Used internally by the default Node factory's `close()` wrapper, and
+ * exported so custom-transport authors can reach for the same typed-error
+ * behavior before forwarding a reason into their own underlying socket.
+ * `undefined` is a no-op (the factory closes without a reason).
+ *
+ * Throws `QodoTransportError` on overflow.
+ */
+export declare function validateCloseReason(reason: string | undefined): void;
+//# sourceMappingURL=transport.shared.d.ts.map

package/dist/client/transport.shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.shared.d.ts","sourceRoot":"","sources":["../../src/client/transport.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUpE"}

package/dist/client/transport.shared.js

@@ -0,0 +1,40 @@
+/**
+ * Platform-neutral pieces of the transport seam.
+ *
+ * Lives in its own module so both the Node `transport.ts` factory and the
+ * browser `transport.browser.ts` stub can re-export the same symbols
+ * without a re-export cycle through `package.json.browser`'s
+ * `transport.js → transport.browser.js` remap.
+ *
+ * Today this file holds `validateCloseReason` + the RFC 6455 byte cap.
+ * Any future platform-neutral transport helper (header-shape validation,
+ * scheme normalization, etc.) belongs here for the same reason.
+ */
+import { QodoTransportError } from './errors.js';
+/**
+ * RFC 6455 §5.5.1: the close-frame application body — the `reason` string
+ * after the 2-byte status code — must be ≤ 123 bytes when UTF-8 encoded.
+ * `ws` (and any spec-compliant peer) crashes when handed a longer value.
+ */
+export const CLOSE_FRAME_REASON_MAX_BYTES = 123;
+/**
+ * Validate that a WS close-frame reason fits in the RFC 6455 cap.
+ *
+ * Used internally by the default Node factory's `close()` wrapper, and
+ * exported so custom-transport authors can reach for the same typed-error
+ * behavior before forwarding a reason into their own underlying socket.
+ * `undefined` is a no-op (the factory closes without a reason).
+ *
+ * Throws `QodoTransportError` on overflow.
+ */
+export function validateCloseReason(reason) {
+    if (reason === undefined)
+        return;
+    // Browsers ship `TextEncoder` globally; Node.js has had it global since v11.
+    const byteLength = new TextEncoder().encode(reason).byteLength;
+    if (byteLength > CLOSE_FRAME_REASON_MAX_BYTES) {
+        throw new QodoTransportError(`transport.close reason exceeds RFC 6455 limit (${byteLength}/${CLOSE_FRAME_REASON_MAX_BYTES} bytes UTF-8). ` +
+            `Shorten the reason or omit it.`);
+    }
+}
+//# sourceMappingURL=transport.shared.js.map

package/dist/client/transport.shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.shared.js","sourceRoot":"","sources":["../../src/client/transport.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO;IACjC,6EAA6E;IAC7E,MAAM,UAAU,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC;IAC/D,IAAI,UAAU,GAAG,4BAA4B,EAAE,CAAC;QAC9C,MAAM,IAAI,kBAAkB,CAC1B,kDAAkD,UAAU,IAAI,4BAA4B,iBAAiB;YAC3G,gCAAgC,CACnC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/client/uuid.d.ts

@@ -0,0 +1,32 @@
+/**
+ * UUIDv7 generator — RFC 9562 §5.7.
+ *
+ * QAR uses UUIDv7 for `message_id` so envelopes sort lexicographically by emit
+ * time. The wire format is the standard 8-4-4-4-12 hex grouping; bits laid out
+ * as: 48-bit Unix timestamp (ms) · 4-bit version · 12-bit rand_a · 2-bit
+ * variant · 62-bit rand_b. The random portions are pulled from
+ * `globalThis.crypto.getRandomValues` (Node 19+ and every modern browser) so
+ * the output is suitable for protocol use, not just `Math.random`. The
+ * isomorphic source matters: `@qodo/sdk` ships a browser WS adapter, and a
+ * module-scope `node:crypto` import would break browser bundling.
+ *
+ * Returned as `string`; cast at the boundary with `asMessageId` / `asSessionId`
+ * when you need a branded id.
+ */
+import type { MessageId, SessionId, TaskId } from '../qar/ids.js';
+/** Generate a fresh UUIDv7. */
+export declare function uuidv7(): string;
+/** Brand-cast a string id as `MessageId`. */
+export declare function asMessageId(id: string): MessageId;
+/** Brand-cast a string id as `SessionId`. */
+export declare function asSessionId(id: string): SessionId;
+/**
+ * Brand-cast a string id as `TaskId`.
+ *
+ * Used by `TaskClient.tasks.start` to derive the `task_id` synchronously from
+ * the outbound `task.start.message_id`. The wire contract codifies
+ * `task_id == task.start.message_id`, so the SDK doesn't need to wait
+ * for the first inbound envelope to know the id.
+ */
+export declare function asTaskId(id: string): TaskId;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/client/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/client/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AASlE,+BAA+B;AAC/B,wBAAgB,MAAM,IAAI,MAAM,CAyB/B;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAEjD;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/client/uuid.js

@@ -0,0 +1,65 @@
+/**
+ * UUIDv7 generator — RFC 9562 §5.7.
+ *
+ * QAR uses UUIDv7 for `message_id` so envelopes sort lexicographically by emit
+ * time. The wire format is the standard 8-4-4-4-12 hex grouping; bits laid out
+ * as: 48-bit Unix timestamp (ms) · 4-bit version · 12-bit rand_a · 2-bit
+ * variant · 62-bit rand_b. The random portions are pulled from
+ * `globalThis.crypto.getRandomValues` (Node 19+ and every modern browser) so
+ * the output is suitable for protocol use, not just `Math.random`. The
+ * isomorphic source matters: `@qodo/sdk` ships a browser WS adapter, and a
+ * module-scope `node:crypto` import would break browser bundling.
+ *
+ * Returned as `string`; cast at the boundary with `asMessageId` / `asSessionId`
+ * when you need a branded id.
+ */
+/** Cryptographic random bytes from the Web Crypto API. */
+function randomBytes(n) {
+    const out = new Uint8Array(n);
+    globalThis.crypto.getRandomValues(out);
+    return out;
+}
+/** Generate a fresh UUIDv7. */
+export function uuidv7() {
+    const ms = Date.now();
+    // 48-bit ms timestamp, big-endian. JS numbers are 53-bit safe so this is fine
+    // until year 10889.
+    const tsHex = ms.toString(16).padStart(12, '0');
+    // 12 bits of random for `rand_a`, prefixed with version nibble (0x7).
+    const randAByte = randomBytes(2);
+    const randA = ((randAByte[0] << 8) | randAByte[1]) & 0x0fff;
+    const verRandAHex = ((0x7 << 12) | randA).toString(16).padStart(4, '0');
+    // 64 bits for variant (2 bits = 0b10) + `rand_b` (62 bits).
+    const tail = randomBytes(8);
+    tail[0] = (tail[0] & 0x3f) | 0x80;
+    let tailHex = '';
+    for (const b of tail)
+        tailHex += b.toString(16).padStart(2, '0');
+    return [
+        tsHex.slice(0, 8),
+        tsHex.slice(8, 12),
+        verRandAHex,
+        tailHex.slice(0, 4),
+        tailHex.slice(4, 16),
+    ].join('-');
+}
+/** Brand-cast a string id as `MessageId`. */
+export function asMessageId(id) {
+    return id;
+}
+/** Brand-cast a string id as `SessionId`. */
+export function asSessionId(id) {
+    return id;
+}
+/**
+ * Brand-cast a string id as `TaskId`.
+ *
+ * Used by `TaskClient.tasks.start` to derive the `task_id` synchronously from
+ * the outbound `task.start.message_id`. The wire contract codifies
+ * `task_id == task.start.message_id`, so the SDK doesn't need to wait
+ * for the first inbound envelope to know the id.
+ */
+export function asTaskId(id) {
+    return id;
+}
+//# sourceMappingURL=uuid.js.map

package/dist/client/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/client/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,0DAA0D;AAC1D,SAAS,WAAW,CAAC,CAAS;IAC5B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9B,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,MAAM;IACpB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEtB,8EAA8E;IAC9E,oBAAoB;IACpB,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAEhD,sEAAsE;IACtE,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC,GAAG,MAAM,CAAC;IAC9D,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAExE,4DAA4D;IAC5D,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACnC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEjE,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACjB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAClB,WAAW;QACX,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KACrB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAe,CAAC;AACzB,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAe,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,EAAY,CAAC;AACtB,CAAC"}