glirastes 0.1.0

package/dist/openapi/index.js

@@ -0,0 +1,341 @@
+import { readFile, writeFile } from 'node:fs/promises';
+const SUPPORTED_METHODS = ['get', 'post', 'patch', 'put', 'delete'];
+const MUTATING_METHODS = new Set(['post', 'patch', 'put', 'delete']);
+function isRef(value) {
+    return typeof value === 'object' && value !== null && '$ref' in value;
+}
+function toMethod(value) {
+    return value.toUpperCase();
+}
+function normalizePath(path) {
+    return path.replace(/\{([^}]+)\}/g, ':$1');
+}
+function normalizeToolName(value) {
+    return value.trim();
+}
+function escapeString(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+function renderObject(value, indent = 2) {
+    return JSON.stringify(value, null, indent);
+}
+function renderObjectKey(key) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : `'${escapeString(key)}'`;
+}
+function readRef(document, ref) {
+    if (!ref.startsWith('#/')) {
+        throw new Error(`Only local refs are supported in this prototype: ${ref}`);
+    }
+    const segments = ref.slice(2).split('/');
+    let current = document;
+    for (const rawSegment of segments) {
+        const segment = rawSegment.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (typeof current !== 'object' || current === null || !(segment in current)) {
+            throw new Error(`Cannot resolve ref: ${ref}`);
+        }
+        current = current[segment];
+    }
+    return current;
+}
+function resolveSchema(document, schema, seenRefs = new Set()) {
+    if (!schema)
+        return undefined;
+    if (!isRef(schema))
+        return schema;
+    const ref = schema.$ref;
+    if (seenRefs.has(ref)) {
+        return { type: 'object' };
+    }
+    seenRefs.add(ref);
+    const resolved = readRef(document, ref);
+    if (typeof resolved !== 'object' || resolved === null) {
+        throw new Error(`Ref does not point to an object schema: ${ref}`);
+    }
+    return resolveSchema(document, resolved, seenRefs);
+}
+function resolveParameter(document, parameter) {
+    if (!isRef(parameter))
+        return parameter;
+    const resolved = readRef(document, parameter.$ref);
+    if (!resolved || typeof resolved !== 'object') {
+        throw new Error(`Invalid parameter ref: ${parameter.$ref}`);
+    }
+    return resolved;
+}
+function resolveRequestBody(document, requestBody) {
+    if (!requestBody)
+        return undefined;
+    if (!isRef(requestBody))
+        return requestBody;
+    const resolved = readRef(document, requestBody.$ref);
+    if (!resolved || typeof resolved !== 'object') {
+        throw new Error(`Invalid requestBody ref: ${requestBody.$ref}`);
+    }
+    return resolved;
+}
+function collectOperations(document) {
+    const operations = [];
+    for (const [path, pathItem] of Object.entries(document.paths ?? {})) {
+        for (const method of SUPPORTED_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            operations.push({ path, method, operation, pathItem });
+        }
+    }
+    return operations;
+}
+function getMergedParameters(document, context) {
+    const merged = new Map();
+    const pathLevel = context.pathItem.parameters ?? [];
+    const operationLevel = context.operation.parameters ?? [];
+    for (const param of pathLevel) {
+        const resolved = resolveParameter(document, param);
+        merged.set(`${resolved.in}:${resolved.name}`, resolved);
+    }
+    for (const param of operationLevel) {
+        const resolved = resolveParameter(document, param);
+        merged.set(`${resolved.in}:${resolved.name}`, resolved);
+    }
+    return Array.from(merged.values());
+}
+function listPathParams(path) {
+    return Array.from(path.matchAll(/\{([^}]+)\}/g), (match) => match[1]);
+}
+function isNonEmptyStringArray(value) {
+    return Array.isArray(value) && value.length > 0 && value.every((item) => typeof item === 'string' && item.trim());
+}
+function schemaToZodCode(document, schema) {
+    const resolved = resolveSchema(document, schema);
+    if (!resolved)
+        return 'z.unknown()';
+    if (Array.isArray(resolved.enum) && resolved.enum.length > 0) {
+        if (resolved.enum.every((item) => typeof item === 'string')) {
+            return `z.enum(${renderObject(resolved.enum)})`;
+        }
+        const literals = resolved.enum
+            .filter((item) => ['string', 'number', 'boolean'].includes(typeof item))
+            .map((item) => `z.literal(${JSON.stringify(item)})`);
+        if (literals.length > 0) {
+            return `z.union([${literals.join(', ')}])`;
+        }
+    }
+    if (resolved.type === 'string') {
+        if (resolved.format === 'uuid')
+            return 'z.string().uuid()';
+        return 'z.string()';
+    }
+    if (resolved.type === 'integer' || resolved.type === 'number') {
+        return 'z.number()';
+    }
+    if (resolved.type === 'boolean') {
+        return 'z.boolean()';
+    }
+    if (resolved.type === 'array') {
+        return `z.array(${schemaToZodCode(document, resolved.items)})`;
+    }
+    if (resolved.type === 'object' || resolved.properties || resolved.additionalProperties) {
+        const properties = resolved.properties ?? {};
+        const required = new Set(resolved.required ?? []);
+        const entries = Object.entries(properties).map(([name, childSchema]) => {
+            const base = schemaToZodCode(document, childSchema);
+            const code = required.has(name) ? base : `${base}.optional()`;
+            return `${renderObjectKey(name)}: ${code}`;
+        });
+        const objectCode = `z.object({${entries.length > 0 ? `\n      ${entries.join(',\n      ')}\n    ` : ''}})`;
+        if (resolved.additionalProperties) {
+            return `${objectCode}.passthrough()`;
+        }
+        return objectCode;
+    }
+    return 'z.unknown()';
+}
+function addOrMergeField(fields, candidate) {
+    const existing = fields.get(candidate.name);
+    if (!existing) {
+        fields.set(candidate.name, candidate);
+        return;
+    }
+    const mergedRequired = existing.required || candidate.required;
+    const mergedCode = existing.zodCode === candidate.zodCode ? existing.zodCode : 'z.unknown()';
+    fields.set(candidate.name, {
+        ...existing,
+        required: mergedRequired,
+        zodCode: mergedCode,
+    });
+}
+function createInputSchemaCode(document, context) {
+    const fields = new Map();
+    const mergedParameters = getMergedParameters(document, context);
+    for (const parameter of mergedParameters) {
+        const required = parameter.in === 'path' ? true : Boolean(parameter.required);
+        addOrMergeField(fields, {
+            name: parameter.name,
+            zodCode: schemaToZodCode(document, parameter.schema),
+            required,
+            source: parameter.in,
+        });
+    }
+    const requestBody = resolveRequestBody(document, context.operation.requestBody);
+    const jsonSchema = requestBody?.content?.['application/json']?.schema;
+    const resolvedBodySchema = resolveSchema(document, jsonSchema);
+    if (resolvedBodySchema) {
+        if (resolvedBodySchema.type === 'object' || resolvedBodySchema.properties) {
+            const required = new Set(resolvedBodySchema.required ?? []);
+            for (const [name, child] of Object.entries(resolvedBodySchema.properties ?? {})) {
+                addOrMergeField(fields, {
+                    name,
+                    zodCode: schemaToZodCode(document, child),
+                    required: required.has(name),
+                    source: 'body',
+                });
+            }
+        }
+        else {
+            addOrMergeField(fields, {
+                name: 'body',
+                zodCode: schemaToZodCode(document, resolvedBodySchema),
+                required: Boolean(requestBody?.required),
+                source: 'body',
+            });
+        }
+    }
+    const sorted = Array.from(fields.values()).sort((a, b) => a.name.localeCompare(b.name));
+    if (sorted.length === 0) {
+        return 'z.object({}).passthrough()';
+    }
+    const entries = sorted.map((field) => {
+        const code = field.required ? field.zodCode : `${field.zodCode}.optional()`;
+        return `${renderObjectKey(field.name)}: ${code}`;
+    });
+    return `z.object({\n      ${entries.join(',\n      ')}\n    })`;
+}
+function formatValidationMessage(kind, message) {
+    const marker = kind === 'error' ? 'ERROR' : 'WARN';
+    return `[${marker}] ${message}`;
+}
+export function validateOpenApiDocument(document) {
+    const errors = [];
+    const warnings = [];
+    const operationIds = new Map();
+    const toolNames = new Map();
+    let enabledTools = 0;
+    for (const context of collectOperations(document)) {
+        const pointer = `${context.method.toUpperCase()} ${context.path}`;
+        const operationId = context.operation.operationId;
+        if (operationId) {
+            const seenAt = operationIds.get(operationId);
+            if (seenAt) {
+                errors.push(formatValidationMessage('error', `Duplicate operationId "${operationId}" at ${pointer}. First seen at ${seenAt}.`));
+            }
+            else {
+                operationIds.set(operationId, pointer);
+            }
+        }
+        const ai = context.operation['x-ai'];
+        if (!ai?.enabled)
+            continue;
+        enabledTools += 1;
+        if (!operationId) {
+            errors.push(formatValidationMessage('error', `Missing operationId for enabled tool at ${pointer}.`));
+        }
+        const toolName = ai.toolName ? normalizeToolName(ai.toolName) : '';
+        if (!toolName) {
+            errors.push(formatValidationMessage('error', `Missing x-ai.toolName for ${pointer}.`));
+        }
+        else {
+            const seenAt = toolNames.get(toolName);
+            if (seenAt) {
+                errors.push(formatValidationMessage('error', `Duplicate x-ai.toolName "${toolName}" at ${pointer}. First seen at ${seenAt}.`));
+            }
+            else {
+                toolNames.set(toolName, pointer);
+            }
+            if (!/^[a-z0-9_]+$/.test(toolName)) {
+                warnings.push(formatValidationMessage('warning', `Tool name "${toolName}" at ${pointer} should match ^[a-z0-9_]+$ for model/tooling consistency.`));
+            }
+        }
+        if (MUTATING_METHODS.has(context.method) && ai.needsApproval === false) {
+            errors.push(formatValidationMessage('error', `Mutating endpoint ${pointer} cannot set x-ai.needsApproval to false.`));
+        }
+        const params = getMergedParameters(document, context);
+        const pathParams = new Set(params.filter((param) => param.in === 'path').map((param) => param.name));
+        for (const pathParam of listPathParams(context.path)) {
+            if (!pathParams.has(pathParam)) {
+                errors.push(formatValidationMessage('error', `Path parameter "${pathParam}" in ${pointer} is missing from OpenAPI parameters.`));
+            }
+        }
+        if (!ai.description && !context.operation.summary && !context.operation.description) {
+            warnings.push(formatValidationMessage('warning', `No description found for enabled tool at ${pointer}. Add x-ai.description or summary.`));
+        }
+    }
+    return {
+        enabledTools,
+        errors,
+        warnings,
+    };
+}
+export function extractGeneratedToolSpecs(document) {
+    const tools = [];
+    for (const context of collectOperations(document)) {
+        const ai = context.operation['x-ai'];
+        if (!ai?.enabled)
+            continue;
+        if (!context.operation.operationId) {
+            throw new Error(`Missing operationId for ${context.method.toUpperCase()} ${context.path}`);
+        }
+        const toolName = ai.toolName ? normalizeToolName(ai.toolName) : '';
+        if (!toolName) {
+            throw new Error(`Missing x-ai.toolName for ${context.operation.operationId}`);
+        }
+        const description = ai.description ??
+            context.operation.summary ??
+            context.operation.description ??
+            `${context.method.toUpperCase()} ${context.path}`;
+        tools.push({
+            id: context.operation.operationId,
+            toolName,
+            description,
+            method: toMethod(context.method),
+            path: normalizePath(context.path),
+            inputSchemaCode: createInputSchemaCode(document, context),
+            needsApproval: ai.needsApproval ?? MUTATING_METHODS.has(context.method),
+            uiActionOnSuccess: ai.uiActionOnSuccess,
+        });
+    }
+    tools.sort((a, b) => a.toolName.localeCompare(b.toolName));
+    return tools;
+}
+export function renderTypeScriptFromSpecs(specs) {
+    const header = `/* eslint-disable */\n/**\n * AUTO-GENERATED FILE.\n * Generated from OpenAPI + x-ai metadata.\n */\n\n`;
+    if (specs.length === 0) {
+        return `${header}import { z } from 'zod';\nimport { defineEndpointTool } from 'glirastes';\n\nexport const generatedEndpointTools = [] as const;\n`;
+    }
+    const bodies = specs
+        .map((spec) => {
+        const uiActionLine = spec.uiActionOnSuccess
+            ? `\n    uiActionOnSuccess: ${renderObject(spec.uiActionOnSuccess, 4)},`
+            : '';
+        return `  defineEndpointTool({\n    id: '${escapeString(spec.id)}',\n    toolName: '${escapeString(spec.toolName)}',\n    description: '${escapeString(spec.description)}',\n    method: '${spec.method}',\n    path: '${escapeString(spec.path)}',\n    inputSchema: ${spec.inputSchemaCode},\n    needsApproval: ${spec.needsApproval},${uiActionLine}\n  })`;
+    })
+        .join(',\n\n');
+    return `${header}import { z } from 'zod';\nimport { defineEndpointTool } from 'glirastes';\n\nexport const generatedEndpointTools = [\n${bodies}\n] as const;\n`;
+}
+export async function validateOpenApiFile(options) {
+    const raw = await readFile(options.inputPath, 'utf8');
+    const document = JSON.parse(raw);
+    return validateOpenApiDocument(document);
+}
+export async function generateFromOpenApiFile(options) {
+    const raw = await readFile(options.inputPath, 'utf8');
+    const document = JSON.parse(raw);
+    const validation = validateOpenApiDocument(document);
+    if (validation.errors.length > 0) {
+        throw new Error(`OpenAPI validation failed:\n${validation.errors.join('\n')}`);
+    }
+    const specs = extractGeneratedToolSpecs(document);
+    const output = renderTypeScriptFromSpecs(specs);
+    await writeFile(options.outputPath, output, 'utf8');
+    return validation;
+}
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

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

package/dist/react/audio-worklet-processor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AudioWorklet processor for real-time audio streaming
+ * Converts Float32 audio samples to Int16 format for Deepgram
+ *
+ * Note: This file is intentionally not unit tested as AudioWorkletProcessor
+ * runs in a separate audio rendering thread and is difficult to test in isolation.
+ * Integration testing happens in the useDeepgramTranscription hook.
+ */
+export {};

package/dist/react/audio-worklet-processor.js

@@ -0,0 +1,28 @@
+/**
+ * AudioWorklet processor for real-time audio streaming
+ * Converts Float32 audio samples to Int16 format for Deepgram
+ *
+ * Note: This file is intentionally not unit tested as AudioWorkletProcessor
+ * runs in a separate audio rendering thread and is difficult to test in isolation.
+ * Integration testing happens in the useDeepgramTranscription hook.
+ */
+class AudioProcessor extends AudioWorkletProcessor {
+    process(inputs, outputs, parameters) {
+        const input = inputs[0]?.[0];
+        if (!input || input.length === 0) {
+            return true;
+        }
+        // Convert Float32 (-1.0 to 1.0) to Int16 (-32768 to 32767)
+        const int16Data = new Int16Array(input.length);
+        for (let i = 0; i < input.length; i++) {
+            const sample = Math.max(-1, Math.min(1, input[i] ?? 0));
+            int16Data[i] = sample < 0 ? sample * 0x8000 : sample * 0x7fff;
+        }
+        // Send to main thread
+        this.port.postMessage(int16Data, [int16Data.buffer]);
+        return true; // Keep processor alive
+    }
+}
+registerProcessor('audio-processor', AudioProcessor);
+export {};
+//# sourceMappingURL=audio-worklet-processor.js.map

package/dist/react/audio-worklet-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-worklet-processor.js","sourceRoot":"","sources":["../../src/react/audio-worklet-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,MAAM,cAAe,SAAQ,qBAAqB;IAChD,OAAO,CACL,MAAwB,EACxB,OAAyB,EACzB,UAAwC;QAExC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE7B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2DAA2D;QAC3D,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxD,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;QAChE,CAAC;QAED,sBAAsB;QACtB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAErD,OAAO,IAAI,CAAC,CAAC,uBAAuB;IACtC,CAAC;CACF;AAED,iBAAiB,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC"}

package/dist/react/bridges/rest-session-bridge.d.ts

@@ -0,0 +1,113 @@
+import type { ChatMessage, SessionConfig, SessionSummary, WireChatMessage } from '../types.js';
+export type HeadersResolver = Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+export interface RestSessionBridgeOptions {
+    /**
+     * Base URL of the sessions collection. Must NOT end with a trailing
+     * slash. Examples: `/api/chat/sessions`, `https://api.example.com/chat/sessions`.
+     */
+    baseUrl: string;
+    /**
+     * Query-string parameters appended to the `list()` GET request. Use
+     * this to filter server-side — for example, hide archived sessions
+     * from a soft-delete backend:
+     *
+     * ```ts
+     * listQuery: () => ({ status: 'active' })
+     * ```
+     *
+     * The function is called on every `list()` invocation, so values
+     * that depend on runtime state (auth, filters) are re-evaluated.
+     */
+    listQuery?: () => Record<string, string>;
+    /**
+     * Static headers or a function that returns headers per request. Useful
+     * for injecting `Authorization`.
+     */
+    headers?: HeadersResolver;
+    /** `fetch` credentials mode. Default: `'same-origin'`. */
+    credentials?: RequestCredentials;
+    /**
+     * Inject a custom `fetch` — defaults to `globalThis.fetch`. Pass a
+     * preconfigured axios-like wrapper via `request` instead if you need
+     * interceptors.
+     */
+    fetchFn?: typeof fetch;
+    /**
+     * Full request override. If provided, this function is called for
+     * every request and the bridge will not touch `fetchFn`/`headers`.
+     * Useful when you already have an axios instance with interceptors.
+     *
+     * Must return the parsed JSON body (or `undefined` for 204s).
+     */
+    request?: (init: {
+        method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+        url: string;
+        body?: unknown;
+    }) => Promise<unknown>;
+    /**
+     * Body used for `create(opts)` POST requests. Default: `{ title }` when
+     * a title was supplied, otherwise `{}`. Override when your backend
+     * requires extra fields (e.g. `{ execution_types: ['chat'] }`).
+     */
+    createBody?: (opts: {
+        title?: string;
+    }) => unknown;
+    /**
+     * How to delete a session. Default: `{ method: 'DELETE' }`. Override
+     * when your backend uses soft deletes — e.g. chaingrow archives via
+     * `{ method: 'PATCH', body: { status: 'archived' } }`.
+     */
+    removeRequest?: (id: string) => {
+        method: 'DELETE' | 'PATCH' | 'POST';
+        body?: unknown;
+    };
+    /**
+     * Path of the messages sub-collection, relative to a session. Default:
+     * `/messages`.
+     */
+    messagesPath?: string;
+    /**
+     * Map a backend session row onto `SessionSummary`. The default handles
+     * both `camelCase` and `snake_case` variants of the common fields
+     * (`id`, `title` / `name`, `createdAt` / `created_at`, etc.).
+     */
+    mapSession?: (row: unknown) => SessionSummary;
+    /**
+     * Map a backend message row onto the SDK's `ChatMessage` shape. The
+     * default reads `{ id, role, content, created_at }` (or `createdAt`),
+     * which covers most REST chat backends. Returning a `WireChatMessage`
+     * is also fine — the provider coerces it.
+     */
+    mapMessage?: (row: unknown) => ChatMessage | WireChatMessage | null;
+}
+/**
+ * Build a `SessionConfig` from a standard REST chat backend.
+ *
+ * The factory wires the five session hooks (`list`, `load`, `create`,
+ * `remove`, `rename`) to a conventional REST layout:
+ *
+ * | Hook     | Request                                    |
+ * |----------|--------------------------------------------|
+ * | `list`   | `GET    {baseUrl}`                         |
+ * | `load`   | `GET    {baseUrl}/{id}{messagesPath}`      |
+ * | `create` | `POST   {baseUrl}` with `createBody(opts)` |
+ * | `remove` | `DELETE {baseUrl}/{id}` (or PATCH via `removeRequest`) |
+ * | `rename` | `PATCH  {baseUrl}/{id}` with `{ title }`   |
+ *
+ * All field-name mapping is done through `mapSession` / `mapMessage`,
+ * which have defaults that tolerate both `snake_case` and `camelCase`.
+ * For anything exotic (different status codes, non-JSON bodies, etc.),
+ * pass `request` and take over the transport entirely.
+ *
+ * @example
+ * ```ts
+ * // Chaingrow — uses archive-instead-of-delete and a non-standard create body
+ * export const chainGrowSessions = createRestSessionBridge({
+ *   baseUrl: `${API_URL}/chat/sessions`,
+ *   headers: () => ({ Authorization: `Bearer ${authStore.getState().token}` }),
+ *   createBody: () => ({ execution_types: ['chat'] }),
+ *   removeRequest: () => ({ method: 'PATCH', body: { status: 'archived' } }),
+ * });
+ * ```
+ */
+export declare function createRestSessionBridge(options: RestSessionBridgeOptions): SessionConfig;