lingxios 1.0.0

package/dist/src/integrations/lingxiloop/teacher.js.map

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

package/dist/src/kernel/manager.d.ts

@@ -0,0 +1,52 @@
+import { type Logger } from '../logging.js';
+import { type CapabilityGrant, type HostAction, type HostActionResult, type KernelExecution, type WorkItem } from '../protocol/types.js';
+export interface KernelHostBridge {
+    execute(work: WorkItem, action: HostAction): Promise<HostActionResult>;
+}
+export interface HostActionObserver {
+    (event: {
+        stage: 'started' | 'completed';
+        action: HostAction;
+        result?: HostActionResult;
+    }): Promise<void>;
+}
+export interface KernelExecutionOptions {
+    capabilities?: readonly CapabilityGrant[];
+    onHostAction?: HostActionObserver;
+}
+/** Port the runtime depends on; {@link KernelManager} is the implementation. */
+export interface KernelExecutor {
+    execute(work: WorkItem, runId: string, cellId: string, code: string, signal?: AbortSignal, options?: KernelExecutionOptions): Promise<KernelExecution>;
+}
+export interface KernelManagerOptions {
+    pythonCommand?: string;
+    runnerPath?: string;
+    homesRoot?: string;
+    idleMs?: number;
+    maxKernels?: number;
+    executionTimeoutMs?: number;
+    maxOutputChars?: number;
+    allowNetwork?: boolean;
+    logger?: Logger;
+}
+export declare function kernelHome(homesRoot: string, work: Pick<WorkItem, 'tenantId' | 'agentId' | 'sessionId' | 'threadId' | 'homeEpoch'>): string;
+export declare class KernelManager implements KernelExecutor {
+    private readonly bridge;
+    private readonly kernels;
+    private readonly options;
+    private readonly logger;
+    private readonly sweepTimer;
+    private readonly capacityWaiters;
+    private closed;
+    constructor(bridge: KernelHostBridge, options?: KernelManagerOptions, env?: NodeJS.ProcessEnv);
+    private key;
+    /** Identifiers are data, never path components: hash every segment. */
+    private homeOf;
+    private evictLeastRecentlyUsedIdle;
+    private waitForCapacity;
+    private wakeCapacityWaiters;
+    execute(work: WorkItem, runId: string, cellId: string, code: string, signal?: AbortSignal, options?: KernelExecutionOptions): Promise<KernelExecution>;
+    sweepIdle(now?: number): number;
+    close(): void;
+    get size(): number;
+}

package/dist/src/kernel/manager.js

@@ -0,0 +1,407 @@
+/**
+ * Kernel manager: owns the pool of persistent sandboxed Python runners.
+ *
+ * One kernel per (session key, home epoch). Executions on a kernel are
+ * strictly serialized; host calls raised by a cell are dispatched to the
+ * injected {@link KernelHostBridge} and answered inline, which is what makes
+ * the bridge look synchronous to model-authored Python.
+ *
+ * Lifecycle: kernels start lazily, are evicted LRU when the pool is full,
+ * swept when idle, and killed (never reused) after a timeout or cancellation
+ * so a wedged interpreter cannot poison later cells.
+ */
+import { spawn } from 'node:child_process';
+import { createHash, randomUUID } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { createInterface } from 'node:readline';
+import { fileURLToPath } from 'node:url';
+import { KernelCancelledError, KernelExecutionError, KernelProtocolError, KernelTimeoutError, ApprovalPendingError, asError, } from '../errors.js';
+import { nullLogger } from '../logging.js';
+import { sessionKeyOf, actionKeyOf } from '../protocol/types.js';
+class PersistentKernel {
+    key;
+    home;
+    bridge;
+    options;
+    logger;
+    onIdle;
+    child = null;
+    lines = null;
+    state = 'created';
+    ready = null;
+    readyResolve = null;
+    readyReject = null;
+    /** Serializes executions; a rejected execution never breaks the chain. */
+    tail = Promise.resolve();
+    pending = null;
+    queued = 0;
+    lastUsedAt = Date.now();
+    constructor(key, home, bridge, options, logger, onIdle) {
+        this.key = key;
+        this.home = home;
+        this.bridge = bridge;
+        this.options = options;
+        this.logger = logger;
+        this.onIdle = onIdle;
+    }
+    get busy() { return this.queued > 0; }
+    get dead() { return this.state === 'dead'; }
+    async start() {
+        if (this.state === 'ready')
+            return;
+        if (this.state === 'starting')
+            return this.ready ?? undefined;
+        if (this.state === 'dead')
+            throw new KernelProtocolError(`kernel ${this.key} is terminated`);
+        this.state = 'starting';
+        await mkdir(this.home, { recursive: true });
+        this.ready = new Promise((resolveReady, rejectReady) => {
+            this.readyResolve = resolveReady;
+            this.readyReject = rejectReady;
+        });
+        const child = spawn(this.options.pythonCommand, ['-I', this.options.runnerPath], {
+            cwd: this.home,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: {
+                PATH: process.env['PATH'] ?? '',
+                SYSTEMROOT: process.env['SYSTEMROOT'] ?? '',
+                PYTHONIOENCODING: 'utf-8',
+                PYTHONUNBUFFERED: '1',
+                AGENT_OS_KERNEL_HOME: this.home,
+                AGENT_OS_HOMES_ROOT: this.options.homesRoot,
+                AGENT_OS_KERNEL_MAX_OUTPUT_CHARS: String(this.options.maxOutputChars),
+                AGENT_OS_KERNEL_ALLOW_NETWORK: this.options.allowNetwork ? '1' : '0',
+            },
+            windowsHide: true,
+        });
+        this.child = child;
+        child.stdin.on('error', (error) => this.terminate(asError(error)));
+        child.stdout.on('error', (error) => this.terminate(asError(error)));
+        child.stderr.on('error', () => undefined);
+        this.lines = createInterface({ input: child.stdout });
+        this.lines.on('line', (line) => this.onLine(line));
+        let stderrTail = '';
+        child.stderr.on('data', (chunk) => {
+            stderrTail = `${stderrTail}${chunk.toString('utf8')}`.slice(-4_000);
+        });
+        child.once('error', (error) => this.terminate(asError(error)));
+        child.once('exit', (code, signal) => {
+            this.terminate(new KernelProtocolError(`kernel ${this.key} exited (${code ?? signal ?? 'unknown'})${stderrTail ? `: ${stderrTail}` : ''}`));
+        });
+        return this.ready;
+    }
+    write(message) {
+        const child = this.child;
+        if (!child?.stdin.writable)
+            throw new KernelProtocolError(`kernel ${this.key} is not writable`);
+        // `python -I` ignores PYTHONIOENCODING, so keep the wire ASCII-safe.
+        const line = JSON.stringify(message).replace(/[\u007f-\uffff]/g, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, '0')}`);
+        child.stdin.write(`${line}\n`, 'ascii');
+    }
+    onLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            this.logger.warn('kernel emitted non-JSON output', { kernel: this.key, line: line.slice(0, 200) });
+            return;
+        }
+        switch (message.type) {
+            case 'ready':
+                this.state = 'ready';
+                this.logger.debug('kernel ready', { kernel: this.key, engine: message.engine, python: message.python });
+                this.readyResolve?.();
+                this.readyResolve = null;
+                this.readyReject = null;
+                return;
+            case 'host_call':
+                void this.onHostCall(message);
+                return;
+            case 'protocol_error':
+                this.logger.warn('kernel protocol error', { kernel: this.key, error: message.error });
+                return;
+            case 'execution_result': {
+                const pending = this.pending;
+                if (!pending || pending.executionId !== message.id)
+                    return;
+                this.pending = null;
+                clearTimeout(pending.timer);
+                if (message.approvalId) {
+                    pending.reject(new ApprovalPendingError(message.approvalId, pending.cellId));
+                }
+                else if (!message.ok) {
+                    pending.reject(new KernelExecutionError(message.error || message.stderr || 'kernel execution failed', pending.cellId));
+                }
+                else {
+                    pending.resolve({
+                        executionId: message.id,
+                        stdout: message.stdout ?? '',
+                        stderr: message.stderr ?? '',
+                        result: message.result,
+                        durationMs: message.durationMs ?? 0,
+                        truncated: message.truncated === true,
+                        artifacts: message.artifacts ?? [],
+                        directives: message.directives ?? [],
+                    });
+                }
+                return;
+            }
+        }
+    }
+    async onHostCall(message) {
+        const pending = this.pending;
+        if (!pending || pending.executionId !== message.id || !message.requestId || !message.action) {
+            this.logger.warn('kernel host_call without a matching execution', { kernel: this.key });
+            return;
+        }
+        const action = {
+            runId: pending.runId,
+            cellId: pending.cellId,
+            callIndex: message.callIndex,
+            action: message.action,
+            args: message.args ?? {},
+            idempotencyKey: actionKeyOf({ runId: pending.runId, cellId: pending.cellId, callIndex: message.callIndex }),
+        };
+        try {
+            await pending.options?.onHostAction?.({ stage: 'started', action });
+        }
+        catch (error) {
+            this.terminate(asError(error));
+            return;
+        }
+        let result;
+        try {
+            result = await this.bridge.execute(pending.work, action);
+        }
+        catch (error) {
+            result = { ok: false, error: asError(error).message };
+        }
+        try {
+            await pending.options?.onHostAction?.({ stage: 'completed', action, result });
+        }
+        catch (error) {
+            this.terminate(asError(error));
+            return;
+        }
+        try {
+            this.write({ type: 'host_result', requestId: message.requestId, ...result });
+        }
+        catch (error) {
+            this.terminate(asError(error));
+        }
+    }
+    execute(work, runId, cellId, code, signal, options) {
+        this.queued++;
+        const operation = this.tail.then(async () => {
+            signal?.throwIfAborted();
+            await this.start();
+            this.lastUsedAt = Date.now();
+            const executionId = randomUUID();
+            return await new Promise((resolveExecution, rejectExecution) => {
+                const settle = (settleFn) => {
+                    signal?.removeEventListener('abort', onAbort);
+                    settleFn();
+                };
+                const timer = setTimeout(() => {
+                    this.pending = null;
+                    this.terminate(new KernelTimeoutError(this.options.executionTimeoutMs, cellId), 'SIGKILL');
+                    settle(() => rejectExecution(new KernelTimeoutError(this.options.executionTimeoutMs, cellId)));
+                }, this.options.executionTimeoutMs);
+                timer.unref?.();
+                const onAbort = () => {
+                    clearTimeout(timer);
+                    this.pending = null;
+                    this.terminate(new KernelCancelledError(cellId), 'SIGKILL');
+                    settle(() => rejectExecution(new KernelCancelledError(cellId)));
+                };
+                if (signal?.aborted) {
+                    onAbort();
+                    return;
+                }
+                signal?.addEventListener('abort', onAbort, { once: true });
+                this.pending = {
+                    executionId, work, runId, cellId,
+                    ...(options ? { options } : {}),
+                    timer,
+                    resolve: (value) => settle(() => resolveExecution(value)),
+                    reject: (error) => settle(() => rejectExecution(error)),
+                };
+                try {
+                    this.write({
+                        type: 'execute', id: executionId, code,
+                        context: { runId, cellId, capabilities: [...(options?.capabilities ?? [])] },
+                    });
+                }
+                catch (error) {
+                    clearTimeout(timer);
+                    this.pending = null;
+                    settle(() => rejectExecution(asError(error)));
+                }
+            });
+        });
+        this.tail = operation.catch(() => undefined);
+        return operation.finally(() => {
+            this.queued--;
+            this.lastUsedAt = Date.now();
+            if (!this.busy)
+                this.onIdle();
+        });
+    }
+    /** Kill the process and fail everything in flight. Idempotent. */
+    terminate(reason, signal = 'SIGTERM') {
+        if (this.state === 'dead')
+            return;
+        this.state = 'dead';
+        const child = this.child;
+        this.child = null;
+        this.lines?.close();
+        this.lines = null;
+        if (child && !child.killed)
+            child.kill(signal);
+        this.readyReject?.(reason);
+        this.readyResolve = null;
+        this.readyReject = null;
+        const pending = this.pending;
+        this.pending = null;
+        if (pending) {
+            clearTimeout(pending.timer);
+            pending.reject(reason);
+        }
+    }
+}
+function positiveInteger(value, name) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 1)
+        throw new Error(`${name} must be a positive integer`);
+    return parsed;
+}
+export function kernelHome(homesRoot, work) {
+    if (!Number.isSafeInteger(work.homeEpoch) || work.homeEpoch < 1)
+        throw new Error('invalid kernel home epoch');
+    const segment = (value) => createHash('sha256').update(value).digest('hex').slice(0, 24);
+    return resolve(homesRoot, segment(work.tenantId), segment(work.agentId), segment(JSON.stringify([work.sessionId, work.threadId ?? null])), `epoch-${work.homeEpoch}`);
+}
+export class KernelManager {
+    bridge;
+    kernels = new Map();
+    options;
+    logger;
+    sweepTimer;
+    capacityWaiters = new Set();
+    closed = false;
+    constructor(bridge, options = {}, env = process.env) {
+        this.bridge = bridge;
+        const localPython = resolve(process.platform === 'win32' ? '.venv/Scripts/python.exe' : '.venv/bin/python');
+        this.logger = options.logger ?? nullLogger;
+        this.options = {
+            pythonCommand: options.pythonCommand ?? env['AGENT_OS_PYTHON']
+                ?? (existsSync(localPython) ? localPython : process.platform === 'win32' ? 'python' : 'python3'),
+            runnerPath: resolve(options.runnerPath ?? env['AGENT_OS_KERNEL_RUNNER'] ?? fileURLToPath(new URL('../../../kernel/runner.py', import.meta.url))),
+            homesRoot: resolve(options.homesRoot ?? env['AGENT_OS_HOMES_ROOT'] ?? '.agent-os/homes'),
+            idleMs: options.idleMs ?? positiveInteger(env['AGENT_OS_KERNEL_IDLE_MS'] ?? 90 * 60_000, 'AGENT_OS_KERNEL_IDLE_MS'),
+            maxKernels: options.maxKernels === undefined && env['AGENT_OS_MAX_KERNELS'] === undefined
+                ? Number.POSITIVE_INFINITY
+                : positiveInteger(options.maxKernels ?? env['AGENT_OS_MAX_KERNELS'], 'AGENT_OS_MAX_KERNELS'),
+            executionTimeoutMs: options.executionTimeoutMs ?? 120_000,
+            maxOutputChars: options.maxOutputChars ?? 8_000,
+            allowNetwork: options.allowNetwork ?? false,
+        };
+        this.sweepTimer = setInterval(() => this.sweepIdle(), Math.min(60_000, this.options.idleMs));
+        this.sweepTimer.unref?.();
+    }
+    key(work) {
+        return `${sessionKeyOf(work)}#${work.homeEpoch}`;
+    }
+    /** Identifiers are data, never path components: hash every segment. */
+    homeOf(work) { return kernelHome(this.options.homesRoot, work); }
+    evictLeastRecentlyUsedIdle() {
+        let candidate;
+        for (const entry of this.kernels) {
+            if (entry[1].busy)
+                continue;
+            if (!candidate || entry[1].lastUsedAt < candidate[1].lastUsedAt)
+                candidate = entry;
+        }
+        if (!candidate)
+            return false;
+        candidate[1].terminate(new KernelCancelledError('evicted'));
+        this.kernels.delete(candidate[0]);
+        return true;
+    }
+    waitForCapacity(cellId, signal) {
+        return new Promise((resolveWait, rejectWait) => {
+            const cleanup = () => {
+                this.capacityWaiters.delete(wake);
+                signal?.removeEventListener('abort', abort);
+            };
+            const wake = () => { cleanup(); resolveWait(); };
+            const abort = () => { cleanup(); rejectWait(new KernelCancelledError(cellId)); };
+            this.capacityWaiters.add(wake);
+            if (signal?.aborted)
+                abort();
+            else
+                signal?.addEventListener('abort', abort, { once: true });
+        });
+    }
+    wakeCapacityWaiters() {
+        for (const wake of [...this.capacityWaiters])
+            wake();
+    }
+    async execute(work, runId, cellId, code, signal, options) {
+        if (!Number.isSafeInteger(work.homeEpoch) || work.homeEpoch < 1) {
+            throw new KernelProtocolError('work.homeEpoch must be a positive integer');
+        }
+        const key = this.key(work);
+        let kernel = this.kernels.get(key);
+        while (!kernel || kernel.dead) {
+            if (kernel?.dead)
+                this.kernels.delete(key);
+            if (this.closed)
+                throw new KernelCancelledError(cellId);
+            if (this.kernels.size >= this.options.maxKernels && !this.evictLeastRecentlyUsedIdle()) {
+                await this.waitForCapacity(cellId, signal);
+                kernel = this.kernels.get(key);
+                continue;
+            }
+            kernel = new PersistentKernel(key, this.homeOf(work), this.bridge, this.options, this.logger.child({ kernel: key }), () => this.wakeCapacityWaiters());
+            this.kernels.set(key, kernel);
+        }
+        try {
+            return await kernel.execute(work, runId, cellId, code, signal, options);
+        }
+        finally {
+            if (kernel.dead && this.kernels.get(key) === kernel) {
+                this.kernels.delete(key);
+                this.wakeCapacityWaiters();
+            }
+        }
+    }
+    sweepIdle(now = Date.now()) {
+        let removed = 0;
+        for (const [key, kernel] of this.kernels) {
+            if (kernel.busy)
+                continue;
+            if (!kernel.dead && now - kernel.lastUsedAt < this.options.idleMs)
+                continue;
+            kernel.terminate(new KernelCancelledError('idle-swept'));
+            this.kernels.delete(key);
+            removed++;
+        }
+        if (removed > 0)
+            this.wakeCapacityWaiters();
+        return removed;
+    }
+    close() {
+        this.closed = true;
+        clearInterval(this.sweepTimer);
+        for (const kernel of this.kernels.values())
+            kernel.terminate(new KernelCancelledError('manager-closed'));
+        this.kernels.clear();
+        this.wakeCapacityWaiters();
+    }
+    get size() { return this.kernels.size; }
+}
+//# sourceMappingURL=manager.js.map

package/dist/src/kernel/manager.js.map

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

package/dist/src/logging.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Structured JSON-lines logging. Dependency-free by design: one event per
+ * line on stderr, machine-parseable, safe to ship to any log pipeline.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug(msg: string, fields?: Record<string, unknown>): void;
+    info(msg: string, fields?: Record<string, unknown>): void;
+    warn(msg: string, fields?: Record<string, unknown>): void;
+    error(msg: string, fields?: Record<string, unknown>): void;
+    /** Derive a logger that stamps `fields` onto every event. */
+    child(fields: Record<string, unknown>): Logger;
+}
+export interface LoggerOptions {
+    level?: LogLevel;
+    /** Injectable sink for tests; defaults to one JSON line on stderr. */
+    sink?: (line: string) => void;
+}
+export declare function createLogger(options?: LoggerOptions): Logger;
+/** A logger that discards everything — the default in library contexts. */
+export declare const nullLogger: Logger;

package/dist/src/logging.js

@@ -0,0 +1,54 @@
+/**
+ * Structured JSON-lines logging. Dependency-free by design: one event per
+ * line on stderr, machine-parseable, safe to ship to any log pipeline.
+ */
+const LEVEL_ORDER = { debug: 10, info: 20, warn: 30, error: 40 };
+function serializeField(value) {
+    if (value instanceof Error) {
+        return { name: value.name, message: value.message, ...(value.stack ? { stack: value.stack } : {}) };
+    }
+    return value;
+}
+class JsonLogger {
+    threshold;
+    sink;
+    bound;
+    constructor(threshold, sink, bound) {
+        this.threshold = threshold;
+        this.sink = sink;
+        this.bound = bound;
+    }
+    emit(level, msg, fields) {
+        if (LEVEL_ORDER[level] < this.threshold)
+            return;
+        const event = { ts: new Date().toISOString(), level, msg, ...this.bound };
+        if (fields)
+            for (const [key, value] of Object.entries(fields))
+                event[key] = serializeField(value);
+        try {
+            this.sink(JSON.stringify(event));
+        }
+        catch {
+            // Logging must never take the process down; drop unserializable events.
+        }
+    }
+    debug(msg, fields) { this.emit('debug', msg, fields); }
+    info(msg, fields) { this.emit('info', msg, fields); }
+    warn(msg, fields) { this.emit('warn', msg, fields); }
+    error(msg, fields) { this.emit('error', msg, fields); }
+    child(fields) {
+        return new JsonLogger(this.threshold, this.sink, { ...this.bound, ...fields });
+    }
+}
+export function createLogger(options = {}) {
+    const level = options.level ?? process.env['AGENT_OS_LOG_LEVEL'] ?? 'info';
+    const threshold = LEVEL_ORDER[level] ?? LEVEL_ORDER.info;
+    const sink = options.sink ?? ((line) => process.stderr.write(`${line}\n`));
+    return new JsonLogger(threshold, sink, {});
+}
+/** A logger that discards everything — the default in library contexts. */
+export const nullLogger = {
+    debug() { }, info() { }, warn() { }, error() { },
+    child() { return nullLogger; },
+};
+//# sourceMappingURL=logging.js.map

package/dist/src/logging.js.map

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

package/dist/src/memory/evidence.d.ts

@@ -0,0 +1,6 @@
+import type { SqlQueryable } from '../control-plane/pg-store.js';
+import { type AssistantMessage, type WorkItem } from '../protocol/types.js';
+/** Called inside the message commit transaction, never for drafts or progress text. */
+export declare function captureMemoryEvidence(database: SqlQueryable, work: Omit<WorkItem, 'leaseToken'>, message: AssistantMessage): Promise<void>;
+/** Failed auxiliary work backs off and stops after three attempts, without retrying the user turn. */
+export declare function retryMemorySynthesis(database: SqlQueryable): Promise<void>;