@sogni-ai/sogni-client 4.2.0-alpha.21 → 4.2.0-alpha.22

package/dist/Chat/hostedToolValidation.generated.js

@@ -0,0 +1,306 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAndNormalizeHostedToolArguments = validateAndNormalizeHostedToolArguments;
+exports.validateHostedToolArguments = validateHostedToolArguments;
+exports.assertHostedToolArguments = assertHostedToolArguments;
+function matchesType(value, type) {
+    switch (type) {
+        case 'array':
+            return Array.isArray(value);
+        case 'integer':
+            return typeof value === 'number' && Number.isInteger(value);
+        case 'number':
+            return typeof value === 'number' && Number.isFinite(value);
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'object':
+            return typeof value === 'object' && value !== null && !Array.isArray(value);
+        case 'string':
+            return typeof value === 'string';
+        case 'null':
+            return value === null;
+        default:
+            return true;
+    }
+}
+function typeLabel(type) {
+    if (Array.isArray(type))
+        return type.join(' or ');
+    return type !== null && type !== void 0 ? type : 'valid value';
+}
+function typeList(type) {
+    if (!type)
+        return [];
+    return Array.isArray(type) ? type : [type];
+}
+function formatEnum(values) {
+    return values.map(value => JSON.stringify(value)).join(', ');
+}
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function valuesEqual(left, right) {
+    if (Object.is(left, right))
+        return true;
+    if (typeof left !== typeof right)
+        return false;
+    if (left === null || right === null)
+        return left === right;
+    if (typeof left !== 'object')
+        return false;
+    try {
+        return JSON.stringify(left) === JSON.stringify(right);
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function coerceValueForTypes(value, allowedTypes) {
+    if (typeof value !== 'string')
+        return { value, coerced: false };
+    const trimmed = value.trim();
+    if (!trimmed)
+        return { value, coerced: false };
+    if (allowedTypes.includes('integer') || allowedTypes.includes('number')) {
+        const numberValue = Number(trimmed);
+        if (Number.isFinite(numberValue)
+            && (!allowedTypes.includes('integer') || Number.isInteger(numberValue))) {
+            return { value: numberValue, coerced: true };
+        }
+    }
+    if (allowedTypes.includes('boolean')) {
+        if (/^(?:true|false)$/i.test(trimmed)) {
+            return { value: trimmed.toLowerCase() === 'true', coerced: true };
+        }
+    }
+    return { value, coerced: false };
+}
+function validateNumberBounds(path, value, schema, errors) {
+    if (schema.minimum !== undefined && value < schema.minimum) {
+        errors.push(`Argument "${path}" must be at least ${schema.minimum}`);
+    }
+    if (schema.maximum !== undefined && value > schema.maximum) {
+        errors.push(`Argument "${path}" must be at most ${schema.maximum}`);
+    }
+    if (typeof schema.exclusiveMinimum === 'number' && value <= schema.exclusiveMinimum) {
+        errors.push(`Argument "${path}" must be greater than ${schema.exclusiveMinimum}`);
+    }
+    if (typeof schema.exclusiveMaximum === 'number' && value >= schema.exclusiveMaximum) {
+        errors.push(`Argument "${path}" must be less than ${schema.exclusiveMaximum}`);
+    }
+    if (schema.exclusiveMinimum === true && schema.minimum !== undefined && value <= schema.minimum) {
+        errors.push(`Argument "${path}" must be greater than ${schema.minimum}`);
+    }
+    if (schema.exclusiveMaximum === true && schema.maximum !== undefined && value >= schema.maximum) {
+        errors.push(`Argument "${path}" must be less than ${schema.maximum}`);
+    }
+}
+function validateStringConstraints(path, value, schema, errors) {
+    if (schema.minLength !== undefined && value.length < schema.minLength) {
+        errors.push(`Argument "${path}" must contain at least ${schema.minLength} character${schema.minLength === 1 ? '' : 's'}`);
+    }
+    if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+        errors.push(`Argument "${path}" must contain at most ${schema.maxLength} character${schema.maxLength === 1 ? '' : 's'}`);
+    }
+    if (schema.pattern) {
+        try {
+            // Hosted-tool schema authors near-universally assume anchored matching
+            // for ID-like fields, but JSON Schema `pattern` is unanchored. Auto-anchor
+            // to prevent prefix/suffix injection (e.g. `pattern: 'safe-prefix-'` should
+            // reject `'evil-safe-prefix-suffix'`). Wrapping with `^(?:...)$` is safe
+            // even for already-anchored patterns — `^^…$$` still matches the same set.
+            if (!new RegExp(`^(?:${schema.pattern})$`).test(value)) {
+                errors.push(`Argument "${path}" must match pattern ${JSON.stringify(schema.pattern)}`);
+            }
+        }
+        catch (_a) {
+            errors.push(`Schema for "${path}" contains invalid pattern ${JSON.stringify(schema.pattern)}`);
+        }
+    }
+}
+function validateCompositeSchema(path, value, schema, context) {
+    var _a, _b;
+    if (schema.allOf) {
+        let nextValue = value;
+        for (const childSchema of schema.allOf) {
+            const result = validateValueAgainstSchema(path, nextValue, childSchema, context);
+            nextValue = result.value;
+        }
+        return { matched: true, value: nextValue };
+    }
+    const alternatives = (_a = schema.oneOf) !== null && _a !== void 0 ? _a : schema.anyOf;
+    if (!alternatives)
+        return { matched: true, value };
+    const matches = [];
+    for (const childSchema of alternatives) {
+        const trial = Object.assign(Object.assign({}, context), { errors: [], warnings: [] });
+        const result = validateValueAgainstSchema(path, value, childSchema, trial);
+        if (trial.errors.length === 0)
+            matches.push(result.value);
+    }
+    if (schema.oneOf && matches.length !== 1) {
+        context.errors.push(`Argument "${path}" must match exactly one allowed schema`);
+        return { matched: false, value };
+    }
+    if (schema.anyOf && matches.length < 1) {
+        context.errors.push(`Argument "${path}" must match at least one allowed schema`);
+        return { matched: false, value };
+    }
+    return { matched: true, value: (_b = matches[0]) !== null && _b !== void 0 ? _b : value };
+}
+function validateObjectAgainstSchema(path, value, schema, context) {
+    var _a, _b;
+    const properties = (_a = schema.properties) !== null && _a !== void 0 ? _a : {};
+    const cleaned = {};
+    for (const required of (_b = schema.required) !== null && _b !== void 0 ? _b : []) {
+        const propValue = value[required];
+        // Empty string and empty array are treated as missing — schema authors
+        // assume `required` means "has a usable value", not "is non-undefined".
+        // Empty object is left untouched (some schemas legitimately accept `{}`).
+        const isMissing = propValue === undefined
+            || propValue === null
+            || propValue === ''
+            || (Array.isArray(propValue) && propValue.length === 0);
+        if (isMissing) {
+            context.errors.push(`Missing required argument "${path ? `${path}.` : ''}${required}"`);
+        }
+    }
+    for (const [name, entryValue] of Object.entries(value)) {
+        if (entryValue === undefined || entryValue === null) {
+            if (name in properties || !context.stripUnknownProperties)
+                cleaned[name] = entryValue;
+            continue;
+        }
+        const property = properties[name];
+        if (!property) {
+            if (schema.additionalProperties === false || context.stripUnknownProperties) {
+                context.warnings.push(`Stripped unknown argument "${path ? `${path}.` : ''}${name}"`);
+            }
+            else if (isRecord(schema.additionalProperties)) {
+                cleaned[name] = validateValueAgainstSchema(path ? `${path}.${name}` : name, entryValue, schema.additionalProperties, context).value;
+            }
+            else {
+                cleaned[name] = entryValue;
+            }
+            continue;
+        }
+        cleaned[name] = validateValueAgainstSchema(path ? `${path}.${name}` : name, entryValue, property, context).value;
+    }
+    return cleaned;
+}
+function validateArrayAgainstSchema(path, value, schema, context) {
+    if (schema.minItems !== undefined && value.length < schema.minItems) {
+        context.errors.push(`Argument "${path}" must contain at least ${schema.minItems} item${schema.minItems === 1 ? '' : 's'}`);
+    }
+    if (schema.maxItems !== undefined && value.length > schema.maxItems) {
+        context.errors.push(`Argument "${path}" must contain at most ${schema.maxItems} item${schema.maxItems === 1 ? '' : 's'}`);
+    }
+    if (!schema.items)
+        return value;
+    if (Array.isArray(schema.items)) {
+        const tupleSchemas = schema.items;
+        return value.map((item, index) => {
+            const itemSchema = tupleSchemas[index];
+            return itemSchema
+                ? validateValueAgainstSchema(`${path}[${index}]`, item, itemSchema, context).value
+                : item;
+        });
+    }
+    return value.map((item, index) => validateValueAgainstSchema(`${path}[${index}]`, item, schema.items, context).value);
+}
+function validateValueAgainstSchema(path, rawValue, schema, context) {
+    var _a;
+    const composite = validateCompositeSchema(path, rawValue, schema, context);
+    if (!composite.matched)
+        return { value: rawValue };
+    let value = composite.value;
+    const allowedTypes = typeList(schema.type);
+    if (context.coercePrimitives
+        && allowedTypes.length > 0
+        && !allowedTypes.some(type => matchesType(value, type))) {
+        const coerced = coerceValueForTypes(value, allowedTypes);
+        if (coerced.coerced) {
+            context.warnings.push(`Coerced argument "${path}" to ${typeof coerced.value}`);
+            value = coerced.value;
+        }
+    }
+    if (allowedTypes.length > 0 && !allowedTypes.some(type => matchesType(value, type))) {
+        context.errors.push(`Argument "${path}" must be ${typeLabel(schema.type)}`);
+        return { value };
+    }
+    if (schema.const !== undefined && !valuesEqual(value, schema.const)) {
+        context.errors.push(`Argument "${path}" must be ${JSON.stringify(schema.const)}`);
+    }
+    if (schema.enum
+        && !context.skipEnumProperties.has(path)
+        && !context.skipEnumProperties.has((_a = path.split('.').at(-1)) !== null && _a !== void 0 ? _a : path)
+        && !schema.enum.some(candidate => valuesEqual(candidate, value))) {
+        context.errors.push(`Argument "${path}" must be one of ${formatEnum(schema.enum)}`);
+    }
+    if (typeof value === 'number') {
+        validateNumberBounds(path, value, schema, context.errors);
+    }
+    if (typeof value === 'string') {
+        validateStringConstraints(path, value, schema, context.errors);
+    }
+    if (Array.isArray(value)) {
+        value = validateArrayAgainstSchema(path, value, schema, context);
+    }
+    if (isRecord(value)) {
+        value = validateObjectAgainstSchema(path, value, schema, context);
+    }
+    return { value };
+}
+function validateAndNormalizeHostedToolArguments(tools, toolName, args, options = {}) {
+    var _a, _b;
+    if (!args || typeof args !== 'object' || Array.isArray(args)) {
+        return {
+            ok: false,
+            errors: ['Tool arguments must be a JSON object'],
+            cleaned: {},
+            warnings: [],
+        };
+    }
+    const tool = tools.find(candidate => candidate.function.name === toolName);
+    if (!tool) {
+        return {
+            ok: false,
+            errors: [`Unknown hosted Sogni tool "${toolName}"`],
+            cleaned: args,
+            warnings: [],
+        };
+    }
+    const schema = tool.function.parameters;
+    if (!schema) {
+        return { ok: true, errors: [], cleaned: args, warnings: [] };
+    }
+    const context = {
+        skipEnumProperties: new Set((_a = options.skipEnumProperties) !== null && _a !== void 0 ? _a : ['model']),
+        coercePrimitives: options.coercePrimitives === true,
+        stripUnknownProperties: options.stripUnknownProperties === true,
+        errors: [],
+        warnings: [],
+    };
+    const normalizedSchema = Object.assign(Object.assign({}, schema), { type: (_b = schema.type) !== null && _b !== void 0 ? _b : 'object' });
+    const cleaned = validateValueAgainstSchema('', args, normalizedSchema, context).value;
+    return {
+        ok: context.errors.length === 0,
+        errors: context.errors,
+        cleaned: isRecord(cleaned) ? cleaned : args,
+        warnings: context.warnings,
+    };
+}
+function validateHostedToolArguments(tools, toolName, args, options = {}) {
+    const result = validateAndNormalizeHostedToolArguments(tools, toolName, args, options);
+    return {
+        ok: result.ok,
+        errors: result.errors,
+    };
+}
+function assertHostedToolArguments(tools, toolName, args, options) {
+    const result = validateHostedToolArguments(tools, toolName, args, options);
+    if (!result.ok) {
+        throw new Error(`Invalid ${toolName} arguments: ${result.errors.join('; ')}`);
+    }
+}
+//# sourceMappingURL=hostedToolValidation.generated.js.map

package/dist/Chat/hostedToolValidation.generated.js.map

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

package/dist/Chat/index.d.ts

@@ -1,7 +1,7 @@
 import ApiGroup, { ApiConfig } from '../ApiGroup';
 import ChatStream from './ChatStream';
 import ChatToolsApi from './ChatTools';
-import { ChatCompletionParams, ChatCompletionChunk, ChatCompletionResult, ChatJobStateEvent, ChatMessage, HostedChatCompletionParams, HostedChatCompletionResult, LLMCostEstimation, LLMModelInfo } from './types';
+import { ChatCompletionParams, ChatCompletionChunk, ChatCompletionResult, ChatJobStateEvent, ChatMessage, ChatRunEvent, ChatRunRecord, HostedChatCompletionParams, HostedChatCompletionResult, LLMCostEstimation, LLMModelInfo, StartChatRunParams, StreamChatRunEventsOptions } from './types';
 import type ProjectsApi from '../Projects';
 export interface ChatApiEvents {
     /** Emitted for each token chunk received during streaming */
@@ -71,9 +71,32 @@ declare class ChatApi extends ApiGroup<ChatApiEvents> {
             stream?: false;
         }) => Promise<ChatCompletionResult>) & ((params: ChatCompletionParams) => Promise<ChatStream | ChatCompletionResult>);
     };
+    /**
+     * Hosted REST chat completion (`POST /v1/chat/completions`). The API
+     * executes any eligible hosted tools server-side and returns the
+     * final result within the request lifetime.
+     */
     hosted: {
         create: (params: HostedChatCompletionParams) => Promise<HostedChatCompletionResult>;
     };
+    /**
+     * Durable hosted chat runs (`POST /v1/chat/runs`). A run is submitted
+     * and persisted server-side; the executor drives the LLM/tool loop
+     * without requiring the client to stay connected. Clients can
+     * disconnect and reattach via SSE `Last-Event-ID` replay or fetch
+     * the final snapshot.
+     *
+     * - `create` returns the persisted run record immediately (202).
+     * - `get` reads the current run state.
+     * - `cancel` flips the run to `cancelled` and aborts in-flight work.
+     * - `streamEvents` yields `ChatRunEvent`s via SSE.
+     */
+    runs: {
+        create: (params: StartChatRunParams) => Promise<ChatRunRecord>;
+        get: (runId: string) => Promise<ChatRunRecord>;
+        cancel: (runId: string, reason?: string) => Promise<ChatRunRecord>;
+        streamEvents: (runId: string, options?: StreamChatRunEventsOptions) => AsyncIterableIterator<ChatRunEvent>;
+    };
     constructor(config: ApiConfig, projects?: ProjectsApi);
     /** Available LLM models and their worker counts */
     get models(): Record<string, LLMModelInfo>;
@@ -123,6 +146,23 @@ declare class ChatApi extends ApiGroup<ChatApiEvents> {
     private normalizeSogniToolsMode;
     private createCompletion;
     private createHostedCompletion;
+    private chatRunFetch;
+    private chatRunJson;
+    /**
+     * Submit a durable hosted chat run. Returns the persisted run record;
+     * the executor drives the LLM/tool loop server-side.
+     */
+    private createChatRun;
+    /** Read a persisted chat run record. */
+    private getChatRun;
+    /** Cancel an in-flight chat run. */
+    private cancelChatRun;
+    /**
+     * SSE iterator over chat-run events. Honors `Last-Event-ID` for replay.
+     * Yields events as `ChatRunEvent`. Caller is responsible for breaking
+     * the loop when they see a terminal `run_*` event type they care about.
+     */
+    private streamChatRunEvents;
     /**
      * Send a single chat completion request (no auto tool execution).
      */

package/dist/Chat/index.js

@@ -8,6 +8,19 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -92,6 +105,12 @@ class ChatApi extends ApiGroup_1.default {
         this.hosted = {
             create: this.createHostedCompletion.bind(this)
         };
+        this.runs = {
+            create: this.createChatRun.bind(this),
+            get: this.getChatRun.bind(this),
+            cancel: this.cancelChatRun.bind(this),
+            streamEvents: this.streamChatRunEvents.bind(this)
+        };
         // Set up the tools API (requires ProjectsApi for media generation).
         // When ProjectsApi is not provided, tool execution methods will throw at runtime.
         this.tools = new ChatTools_1.default(projects);
@@ -247,13 +266,158 @@ class ChatApi extends ApiGroup_1.default {
     }
     createHostedCompletion(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
+            var _a, _b, _c, _d, _e, _f, _g;
             if (params.stream) {
                 throw new Error('chat.hosted.create currently supports non-streaming requests only.');
             }
             const normalizedMessages = normalizeVisionMessages(params.messages);
             const chatTemplateKwargs = (_a = params.chat_template_kwargs) !== null && _a !== void 0 ? _a : this.buildChatTemplateKwargs(params.think);
-            return this.client.rest.post('/v1/chat/completions', Object.assign(Object.assign({ model: params.model, messages: normalizedMessages, app_source: params.app_source || params.appSource || this.client.appSource, max_tokens: params.max_tokens, temperature: params.temperature, top_p: params.top_p, top_k: params.top_k, min_p: params.min_p, repetition_penalty: params.repetition_penalty, frequency_penalty: params.frequency_penalty, presence_penalty: params.presence_penalty, stop: params.stop, token_type: params.token_type || params.tokenType, tools: params.tools, tool_choice: params.tool_choice, sogni_tools: this.normalizeSogniToolsMode(params.sogni_tools), sogni_tool_execution: params.sogni_tool_execution, task_profile: params.taskProfile, media_references: (_b = params.media_references) !== null && _b !== void 0 ? _b : params.mediaReferences, api_media_references: (_c = params.api_media_references) !== null && _c !== void 0 ? _c : params.apiMediaReferences }, (chatTemplateKwargs && { chat_template_kwargs: chatTemplateKwargs })), (params.response_format && { response_format: params.response_format })), { timeoutMs: 300000 });
+            return this.client.rest.post('/v1/chat/completions', Object.assign(Object.assign({ model: params.model, messages: normalizedMessages, app_source: (_c = (_b = params.app_source) !== null && _b !== void 0 ? _b : params.appSource) !== null && _c !== void 0 ? _c : this.client.appSource, max_tokens: params.max_tokens, temperature: params.temperature, top_p: params.top_p, top_k: params.top_k, min_p: params.min_p, repetition_penalty: params.repetition_penalty, frequency_penalty: params.frequency_penalty, presence_penalty: params.presence_penalty, stop: params.stop, token_type: (_d = params.token_type) !== null && _d !== void 0 ? _d : params.tokenType, tools: params.tools, tool_choice: params.tool_choice, sogni_tools: this.normalizeSogniToolsMode(params.sogni_tools), sogni_tool_execution: params.sogni_tool_execution, task_profile: (_e = params.task_profile) !== null && _e !== void 0 ? _e : params.taskProfile, media_references: (_f = params.media_references) !== null && _f !== void 0 ? _f : params.mediaReferences, api_media_references: (_g = params.api_media_references) !== null && _g !== void 0 ? _g : params.apiMediaReferences }, (chatTemplateKwargs && { chat_template_kwargs: chatTemplateKwargs })), (params.response_format && { response_format: params.response_format })), { timeoutMs: 300000 });
+        });
+    }
+    chatRunFetch(path_1) {
+        return __awaiter(this, arguments, void 0, function* (path, options = {}) {
+            const url = new URL(path, this.client.rest.baseUrl).toString();
+            const authenticated = yield this.client.auth.authenticateRequest(options);
+            return fetch(url, authenticated);
+        });
+    }
+    chatRunJson(path_1) {
+        return __awaiter(this, arguments, void 0, function* (path, options = {}) {
+            const response = yield this.chatRunFetch(path, options);
+            if (!response.ok) {
+                const text = yield response.text();
+                let payload;
+                try {
+                    payload = text ? JSON.parse(text) : undefined;
+                }
+                catch (_a) {
+                    payload = { message: text };
+                }
+                const message = (payload && typeof payload.message === 'string' && payload.message) ||
+                    response.statusText ||
+                    `Chat run request failed with status ${response.status}`;
+                const err = new Error(message);
+                err.status = response.status;
+                throw err;
+            }
+            return (yield response.json());
+        });
+    }
+    /**
+     * Submit a durable hosted chat run. Returns the persisted run record;
+     * the executor drives the LLM/tool loop server-side.
+     */
+    createChatRun(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const body = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ messages: params.messages }, (params.tools ? { tools: params.tools } : {})), (params.toolChoice !== undefined ? { tool_choice: params.toolChoice } : {})), (params.model ? { model: params.model } : {})), (params.sampling ? { sampling: params.sampling } : {})), (params.mediaReferences ? { media_references: params.mediaReferences } : {})), (params.mediaContext ? { media_context: params.mediaContext } : {})), (params.maxEstimatedCapacityUnits !== undefined
+                ? { max_estimated_capacity_units: params.maxEstimatedCapacityUnits }
+                : {})), (params.confirmCost !== undefined ? { confirm_cost: params.confirmCost } : {})), (params.sessionId ? { session_id: params.sessionId } : {})), (params.clientMessageId ? { client_message_id: params.clientMessageId } : {})), (params.tokenType ? { token_type: params.tokenType } : {})), (params.appSource ? { app_source: params.appSource } : {}));
+            const headers = { 'Content-Type': 'application/json' };
+            if (params.idempotencyKey)
+                headers['Idempotency-Key'] = params.idempotencyKey;
+            const response = yield this.chatRunJson('/v1/chat/runs', {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body)
+            });
+            return response.data.run;
+        });
+    }
+    /** Read a persisted chat run record. */
+    getChatRun(runId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.chatRunJson(`/v1/chat/runs/${encodeURIComponent(runId)}`);
+            return response.data.run;
+        });
+    }
+    /** Cancel an in-flight chat run. */
+    cancelChatRun(runId, reason) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.chatRunJson(`/v1/chat/runs/${encodeURIComponent(runId)}/cancel`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(reason ? { reason } : {})
+            });
+            return response.data.run;
+        });
+    }
+    /**
+     * SSE iterator over chat-run events. Honors `Last-Event-ID` for replay.
+     * Yields events as `ChatRunEvent`. Caller is responsible for breaking
+     * the loop when they see a terminal `run_*` event type they care about.
+     */
+    streamChatRunEvents(runId_1) {
+        return __asyncGenerator(this, arguments, function* streamChatRunEvents_1(runId, options = {}) {
+            const headers = { Accept: 'text/event-stream' };
+            if (options.lastEventId !== undefined && Number.isFinite(options.lastEventId)) {
+                headers['Last-Event-ID'] = String(options.lastEventId);
+            }
+            const response = yield __await(this.chatRunFetch(`/v1/chat/runs/${encodeURIComponent(runId)}/events/stream`, { headers, signal: options.signal }));
+            if (!response.ok || !response.body) {
+                throw new Error(`Chat run event stream failed with status ${response.status}`);
+            }
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            const findFrameBoundary = (source) => {
+                const lf = source.indexOf('\n\n');
+                const crlf = source.indexOf('\r\n\r\n');
+                if (lf === -1 && crlf === -1)
+                    return null;
+                if (lf === -1)
+                    return { index: crlf, length: 4 };
+                if (crlf === -1 || lf < crlf)
+                    return { index: lf, length: 2 };
+                return { index: crlf, length: 4 };
+            };
+            const yieldFrame = (frame) => {
+                if (!frame.trim() || frame.startsWith(':'))
+                    return null;
+                let eventName = 'message';
+                let data = '';
+                for (const rawLine of frame.split(/\r?\n/)) {
+                    if (rawLine.startsWith('event:'))
+                        eventName = rawLine.slice(6).trim();
+                    else if (rawLine.startsWith('data:'))
+                        data += (data ? '\n' : '') + rawLine.slice(5).trim();
+                }
+                if (eventName === 'run_status' || !data)
+                    return null;
+                try {
+                    return JSON.parse(data);
+                }
+                catch (_a) {
+                    return null;
+                }
+            };
+            try {
+                while (true) {
+                    const { value, done } = yield __await(reader.read());
+                    if (done) {
+                        const remaining = buffer.trim();
+                        if (remaining) {
+                            const parsed = yieldFrame(remaining);
+                            if (parsed)
+                                yield yield __await(parsed);
+                        }
+                        return yield __await(void 0);
+                    }
+                    buffer += decoder.decode(value, { stream: true });
+                    let boundary = findFrameBoundary(buffer);
+                    while (boundary !== null) {
+                        const frame = buffer.slice(0, boundary.index);
+                        buffer = buffer.slice(boundary.index + boundary.length);
+                        boundary = findFrameBoundary(buffer);
+                        const parsed = yieldFrame(frame);
+                        if (parsed)
+                            yield yield __await(parsed);
+                    }
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
         });
     }
     /**