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

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).
      */