lingxios 1.0.0

package/dist/src/metrics.js

@@ -0,0 +1,130 @@
+/**
+ * Minimal in-process metrics registry with Prometheus text exposition.
+ * Counters, gauges, and fixed-bucket histograms — enough for operational
+ * dashboards without pulling in a client library.
+ */
+function labelKey(labels) {
+    const entries = Object.entries(labels).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return entries.map(([k, v]) => `${k}="${v.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n')}"`).join(',');
+}
+class Counter {
+    name;
+    help;
+    series = new Map();
+    constructor(name, help) {
+        this.name = name;
+        this.help = help;
+    }
+    inc(labels = {}, delta = 1) {
+        const key = labelKey(labels);
+        this.series.set(key, (this.series.get(key) ?? 0) + delta);
+    }
+    expose() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} counter`];
+        for (const [key, value] of this.series)
+            lines.push(`${this.name}${key ? `{${key}}` : ''} ${value}`);
+        if (this.series.size === 0)
+            lines.push(`${this.name} 0`);
+        return lines;
+    }
+}
+class Gauge {
+    name;
+    help;
+    series = new Map();
+    constructor(name, help) {
+        this.name = name;
+        this.help = help;
+    }
+    set(value, labels = {}) {
+        this.series.set(labelKey(labels), value);
+    }
+    expose() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} gauge`];
+        for (const [key, value] of this.series)
+            lines.push(`${this.name}${key ? `{${key}}` : ''} ${value}`);
+        if (this.series.size === 0)
+            lines.push(`${this.name} 0`);
+        return lines;
+    }
+}
+class Histogram {
+    name;
+    help;
+    buckets;
+    counts = new Map();
+    sums = new Map();
+    totals = new Map();
+    constructor(name, help, buckets) {
+        this.name = name;
+        this.help = help;
+        this.buckets = buckets;
+    }
+    observe(value, labels = {}) {
+        const key = labelKey(labels);
+        let counts = this.counts.get(key);
+        if (!counts) {
+            counts = this.buckets.map(() => 0);
+            this.counts.set(key, counts);
+        }
+        for (const [index, bound] of this.buckets.entries()) {
+            if (value <= bound)
+                counts[index] = (counts[index] ?? 0) + 1;
+        }
+        this.sums.set(key, (this.sums.get(key) ?? 0) + value);
+        this.totals.set(key, (this.totals.get(key) ?? 0) + 1);
+    }
+    expose() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} histogram`];
+        for (const [key, counts] of this.counts) {
+            const prefix = key ? `${key},` : '';
+            for (const [index, bound] of this.buckets.entries()) {
+                lines.push(`${this.name}_bucket{${prefix}le="${bound}"} ${counts[index] ?? 0}`);
+            }
+            lines.push(`${this.name}_bucket{${prefix}le="+Inf"} ${this.totals.get(key) ?? 0}`);
+            lines.push(`${this.name}_sum${key ? `{${key}}` : ''} ${this.sums.get(key) ?? 0}`);
+            lines.push(`${this.name}_count${key ? `{${key}}` : ''} ${this.totals.get(key) ?? 0}`);
+        }
+        return lines;
+    }
+}
+export class MetricsRegistry {
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    counter(name, help) {
+        let metric = this.counters.get(name);
+        if (!metric) {
+            metric = new Counter(name, help);
+            this.counters.set(name, metric);
+        }
+        return metric;
+    }
+    gauge(name, help) {
+        let metric = this.gauges.get(name);
+        if (!metric) {
+            metric = new Gauge(name, help);
+            this.gauges.set(name, metric);
+        }
+        return metric;
+    }
+    histogram(name, help, buckets) {
+        let metric = this.histograms.get(name);
+        if (!metric) {
+            metric = new Histogram(name, help, buckets);
+            this.histograms.set(name, metric);
+        }
+        return metric;
+    }
+    expose() {
+        const lines = [];
+        for (const metric of this.counters.values())
+            lines.push(...metric.expose());
+        for (const metric of this.gauges.values())
+            lines.push(...metric.expose());
+        for (const metric of this.histograms.values())
+            lines.push(...metric.expose());
+        return `${lines.join('\n')}\n`;
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/src/metrics.js.map

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

package/dist/src/model/driver.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Model driver port. The runtime speaks only this interface; concrete
+ * providers (OpenAI-compatible, Anthropic, test fakes) live behind it.
+ */
+import type { ModelItem } from '../protocol/types.js';
+export interface ModelUsage {
+    available: boolean;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface ModelTurnResult {
+    /** Structured final response; the runtime validates it against the captured request. */
+    finalCandidate?: string;
+    /** Items to append to session history (assistant text and/or tool calls). */
+    output: ModelItem[];
+    /** Full assistant text of this turn ('' when the turn is a tool call). */
+    text: string;
+    model?: string;
+    usage: ModelUsage;
+    diagnostics?: Record<string, unknown>;
+}
+export interface ModelTurnRequest {
+    instructions: string;
+    items: readonly ModelItem[];
+    signal?: AbortSignal | undefined;
+    /** Called as assistant text streams; used for latency, not for delivery. */
+    onTextDelta?: ((delta: string) => void) | undefined;
+}
+export interface StructuredCallRequest {
+    instructions: string;
+    input: unknown;
+    signal?: AbortSignal | undefined;
+}
+export interface StructuredCallResult {
+    value: unknown;
+    model: string;
+    usage: ModelUsage;
+}
+export interface CompactionRequest {
+    instructions: string;
+    items: readonly ModelItem[];
+    signal?: AbortSignal | undefined;
+}
+export interface CompactionResult {
+    value: string;
+    model: string;
+    usage: ModelUsage;
+}
+export interface ModelDriver {
+    readonly modelId?: string;
+    readonly contextWindowTokens?: number;
+    readonly maxOutputTokens?: number;
+    readonly toolDefinitionTokens?: number;
+    /** One agent-loop turn: one Python call or a structured final candidate. */
+    run(request: ModelTurnRequest): Promise<ModelTurnResult>;
+    /** One-shot JSON-mode call for auxiliary pipelines. */
+    structured(request: StructuredCallRequest): Promise<StructuredCallResult>;
+    /** Summarize `items` into a continuity summary for context compaction. */
+    compact(request: CompactionRequest): Promise<CompactionResult>;
+}

package/dist/src/model/driver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=driver.js.map

package/dist/src/model/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/model/driver.ts"],"names":[],"mappings":""}

package/dist/src/model/embeddings.d.ts

@@ -0,0 +1,24 @@
+export interface EmbeddingOptions {
+    id: string;
+    apiKey: string;
+    baseUrl?: string;
+    dimensions?: number;
+    requestTimeoutMs?: number;
+}
+/** One bounded request. Durable indexing work, rather than the HTTP client, owns retries. */
+export declare class OpenAIEmbeddingDriver {
+    private readonly options;
+    readonly cacheKey: string;
+    private readonly endpoint;
+    private readonly timeoutMs;
+    constructor(options: EmbeddingOptions);
+    embed(input: readonly string[], signal?: AbortSignal): Promise<{
+        model: string;
+        vectors: number[][];
+        usage: {
+            available: boolean;
+            inputTokens: number;
+            totalTokens: number;
+        };
+    }>;
+}

package/dist/src/model/embeddings.js

@@ -0,0 +1,97 @@
+import { createHash } from 'node:crypto';
+/** One bounded request. Durable indexing work, rather than the HTTP client, owns retries. */
+export class OpenAIEmbeddingDriver {
+    options;
+    cacheKey;
+    endpoint;
+    timeoutMs;
+    constructor(options) {
+        this.options = options;
+        this.options = { ...options };
+        if (!options.id?.trim() || !options.apiKey?.trim())
+            throw new Error('embedding model id and apiKey are required');
+        let url;
+        try {
+            url = new URL(options.baseUrl ?? 'https://api.openai.com/v1');
+        }
+        catch {
+            throw new Error('invalid embedding base URL');
+        }
+        if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+            throw new Error('invalid embedding base URL');
+        this.endpoint = `${url.href.replace(/\/+$/, '')}/embeddings`;
+        this.timeoutMs = options.requestTimeoutMs ?? 15_000;
+        if (!Number.isSafeInteger(this.timeoutMs) || this.timeoutMs < 1 || this.timeoutMs > 60_000)
+            throw new Error('invalid embedding timeout');
+        if (options.dimensions !== undefined && (!Number.isSafeInteger(options.dimensions) || options.dimensions < 1 || options.dimensions > 4096))
+            throw new Error('invalid embedding dimensions');
+        this.cacheKey = createHash('sha256').update(JSON.stringify([this.endpoint, options.id, options.dimensions ?? null])).digest('hex');
+    }
+    async embed(input, signal) {
+        // UTF-8 bytes conservatively bound input tokens without a tokenizer dependency.
+        if (!Array.isArray(input) || !input.length || input.length > 32
+            || input.some(text => typeof text !== 'string' || !text.trim() || Buffer.byteLength(text) > 8000))
+            throw new Error('embedding input requires 1-32 nonempty strings of at most 8000 UTF-8 bytes');
+        const combined = AbortSignal.any([...(signal ? [signal] : []), AbortSignal.timeout(this.timeoutMs)]);
+        combined.throwIfAborted();
+        const response = await fetch(this.endpoint, { method: 'POST', redirect: 'error', signal: combined,
+            headers: { 'content-type': 'application/json', authorization: `Bearer ${this.options.apiKey}` },
+            body: JSON.stringify({ model: this.options.id, input, encoding_format: 'float',
+                ...(this.options.dimensions === undefined ? {} : { dimensions: this.options.dimensions }) }) });
+        if (!response.ok) {
+            await response.body?.cancel();
+            // Provider error bodies may echo credentials or input; never persist them in work errors.
+            throw new Error(`embedding provider returned HTTP ${response.status}`);
+        }
+        if (!response.body)
+            throw new Error('embedding provider returned no response body');
+        const reader = response.body.getReader();
+        const chunks = [];
+        let size = 0;
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                size += value.byteLength;
+                if (size > 4 * 1024 * 1024)
+                    throw new Error('embedding response exceeds 4 MiB');
+                chunks.push(value);
+            }
+        }
+        finally {
+            await reader.cancel().catch(() => { });
+            reader.releaseLock();
+        }
+        combined.throwIfAborted();
+        let result;
+        try {
+            result = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks)));
+        }
+        catch {
+            throw new Error('embedding provider returned invalid JSON');
+        }
+        if (!result || typeof result !== 'object' || typeof result.model !== 'string' || !result.model.trim() || result.model.length > 256
+            || !Array.isArray(result.data) || result.data.length !== input.length)
+            throw new Error('invalid embedding response envelope');
+        const vectors = new Array(input.length);
+        let dimensions = this.options.dimensions;
+        for (const item of result.data) {
+            if (!item || !Number.isSafeInteger(item.index) || item.index < 0 || item.index >= input.length || vectors[item.index]
+                || !Array.isArray(item.embedding) || item.embedding.length < 1 || item.embedding.length > 4096
+                || item.embedding.some((value) => typeof value !== 'number' || !Number.isFinite(value)))
+                throw new Error('invalid embedding vector or index');
+            dimensions ??= item.embedding.length;
+            if (item.embedding.length !== dimensions)
+                throw new Error('embedding dimensions do not match');
+            const norm = Math.hypot(...item.embedding);
+            if (!Number.isFinite(norm) || norm === 0)
+                throw new Error('embedding vector has invalid magnitude');
+            vectors[item.index] = item.embedding.map((value) => value / norm);
+        }
+        const prompt = result.usage?.prompt_tokens, total = result.usage?.total_tokens;
+        const available = Number.isSafeInteger(prompt) && Number(prompt) >= 0 && Number.isSafeInteger(total) && Number(total) >= Number(prompt);
+        return { model: result.model, vectors, usage: { available, inputTokens: available ? Number(prompt) : 0, totalTokens: available ? Number(total) : 0 } };
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/src/model/embeddings.js.map

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

package/dist/src/model/openai.d.ts

@@ -0,0 +1,45 @@
+import type { CompactionRequest, CompactionResult, ModelDriver, ModelTurnRequest, ModelTurnResult, StructuredCallRequest, StructuredCallResult } from './driver.js';
+export declare const DEFAULT_MODEL: {
+    readonly id: "deepseek-ai/DeepSeek-V4-Flash";
+    readonly baseUrl: "https://api.siliconflow.cn/v1";
+    readonly reasoningEffort: "high";
+};
+export interface OpenAIDriverOptions {
+    apiKey: string;
+    baseUrl?: string;
+    reasoningEffort?: 'high' | 'max';
+    /** Max attempts per request across retryable failures (429/5xx/network). */
+    maxAttempts?: number;
+    /** Base backoff in ms; grows exponentially with full jitter. */
+    retryBaseMs?: number;
+    /** Per-request timeout in ms (wall clock, including streaming). */
+    requestTimeoutMs?: number;
+    maxOutputTokens?: number;
+    contextWindowTokens?: number;
+    fetchImpl?: typeof fetch;
+    /** Injectable sleep for tests. */
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+}
+/** Parse bounded `text/event-stream` bodies into `data:` payload strings. */
+export declare function sseDataEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<string>;
+export declare class OpenAIChatDriver implements ModelDriver {
+    readonly modelId: string;
+    private readonly options;
+    readonly contextWindowTokens: number;
+    readonly maxOutputTokens: number;
+    readonly toolDefinitionTokens: number;
+    private readonly baseUrl;
+    private readonly maxAttempts;
+    private readonly retryBaseMs;
+    private readonly requestTimeoutMs;
+    private readonly fetchImpl;
+    private readonly sleep;
+    constructor(modelId: string, options: OpenAIDriverOptions);
+    private request;
+    private backoffMs;
+    private consumeStream;
+    private usageOf;
+    run(request: ModelTurnRequest): Promise<ModelTurnResult>;
+    structured(request: StructuredCallRequest): Promise<StructuredCallResult>;
+    compact(request: CompactionRequest): Promise<CompactionResult>;
+}