lingxios 1.0.0

package/dist/src/context/task-contract.js

@@ -0,0 +1,23 @@
+import { createHash } from 'node:crypto';
+/** Model-authored interpretation, never a replacement for the original input. */
+export function createTaskContract(originalInput, requestVersion, draft) {
+    if (!Number.isSafeInteger(requestVersion) || requestVersion < 1)
+        throw new Error('invalid contract request version');
+    if (!draft || typeof draft !== 'object' || Array.isArray(draft))
+        throw new Error('task contract draft must be an object');
+    const fields = ['deliverables', 'constraints', 'actions', 'acceptance'];
+    const input = draft;
+    if (Object.keys(input).some(key => !fields.includes(key)))
+        throw new Error('unknown task contract field');
+    const result = { version: 1, requestVersion, originalInputSha256: createHash('sha256').update(originalInput).digest('hex'), deliverables: [], constraints: [], actions: [], acceptance: [] };
+    for (const field of fields) {
+        const values = input[field];
+        if (!Array.isArray(values) || values.length > 64 || !values.every(value => typeof value === 'string' && value.trim().length > 0 && value.length <= 2000))
+            throw new Error(`invalid task contract ${field}`);
+        result[field] = [...values];
+    }
+    if (!result.deliverables.length || !result.acceptance.length)
+        throw new Error('task contract requires deliverables and acceptance conditions');
+    return result;
+}
+//# sourceMappingURL=task-contract.js.map

package/dist/src/context/task-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-contract.js","sourceRoot":"","sources":["../../../src/context/task-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAYxC,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAAC,aAAqB,EAAE,cAAsB,EAAE,KAAc;IAC9F,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;IACpH,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IACzH,MAAM,MAAM,GAAG,CAAC,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,CAAU,CAAA;IAChF,MAAM,KAAK,GAAG,KAAgC,CAAA;IAC9C,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAA4B,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAClI,MAAM,MAAM,GAAiB,EAAE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;IAC1M,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAA;QAC3M,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAA;IAC7B,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;IAC9I,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/src/context/text.d.ts

@@ -0,0 +1,2 @@
+/** Decode supported source encodings without silently replacing corrupt bytes. */
+export declare function decodeSourceText(bytes: Uint8Array): string;

package/dist/src/context/text.js

@@ -0,0 +1,7 @@
+/** Decode supported source encodings without silently replacing corrupt bytes. */
+export function decodeSourceText(bytes) {
+    const encoding = bytes[0] === 0xff && bytes[1] === 0xfe ? 'utf-16le'
+        : bytes[0] === 0xfe && bytes[1] === 0xff ? 'utf-16be' : 'utf-8';
+    return new TextDecoder(encoding, { fatal: true }).decode(bytes);
+}
+//# sourceMappingURL=text.js.map

package/dist/src/context/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/context/text.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU;QAClE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAA;IACjE,OAAO,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACjE,CAAC"}

package/dist/src/control-plane/http-server.d.ts

@@ -0,0 +1,22 @@
+import { type Logger } from '../logging.js';
+import type { MetricsRegistry } from '../metrics.js';
+import { ControlPlaneError, ControlPlaneService } from './service.js';
+export interface ControlPlaneServerOptions {
+    service: ControlPlaneService;
+    claimWork: (workerId: string) => Promise<import('../protocol/types.js').WorkItem | null>;
+    serviceToken: string;
+    logger?: Logger;
+    metrics?: MetricsRegistry;
+    maxBodyBytes?: number;
+}
+export declare class ControlPlaneServer {
+    private readonly options;
+    private readonly server;
+    private readonly logger;
+    constructor(options: ControlPlaneServerOptions);
+    private authorized;
+    private handle;
+    listen(port: number, host?: string): Promise<number>;
+    close(): Promise<void>;
+}
+export { ControlPlaneError, ControlPlaneService };

package/dist/src/control-plane/http-server.js

@@ -0,0 +1,196 @@
+/**
+ * HTTP adapter over {@link ControlPlaneService}. Dependency-free node:http
+ * with a small explicit route table; every route is authenticated with a
+ * timing-safe service-token comparison.
+ */
+import { timingSafeEqual } from 'node:crypto';
+import http from 'node:http';
+import { nullLogger } from '../logging.js';
+import { ControlPlaneError, ControlPlaneService } from './service.js';
+function readBody(req, maxBytes) {
+    return new Promise((resolveBody, rejectBody) => {
+        const chunks = [];
+        let size = 0;
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > maxBytes) {
+                rejectBody(new ControlPlaneError(413, 'request body too large'));
+                req.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => {
+            if (chunks.length === 0) {
+                resolveBody({});
+                return;
+            }
+            try {
+                resolveBody(JSON.parse(Buffer.concat(chunks).toString('utf8')));
+            }
+            catch {
+                rejectBody(new ControlPlaneError(400, 'request body must be JSON'));
+            }
+        });
+        req.on('error', rejectBody);
+    });
+}
+function json(res, status, payload) {
+    const body = JSON.stringify(payload);
+    res.writeHead(status, { 'content-type': 'application/json' });
+    res.end(body);
+}
+function stringField(body, key) {
+    const value = body[key];
+    if (typeof value !== 'string')
+        throw new ControlPlaneError(400, `${key} must be a string`);
+    return value;
+}
+function leaseProofOf(id, body) {
+    const fence = body['fence'];
+    if (!Number.isSafeInteger(fence) || Number(fence) < 1)
+        throw new ControlPlaneError(400, 'fence must be a positive safe integer');
+    return { id, fence: fence, leaseToken: stringField(body, 'leaseToken') };
+}
+export class ControlPlaneServer {
+    options;
+    server;
+    logger;
+    constructor(options) {
+        this.options = options;
+        this.logger = options.logger ?? nullLogger;
+        this.server = http.createServer((req, res) => {
+            void this.handle(req, res).catch((error) => {
+                if (error instanceof ControlPlaneError) {
+                    json(res, error.status, { error: error.message });
+                    return;
+                }
+                this.logger.error('control-plane request failed', { url: req.url, error });
+                json(res, 500, { error: 'internal error' });
+            });
+        });
+    }
+    authorized(req) {
+        const auth = req.headers.authorization;
+        const provided = typeof auth === 'string' && auth.startsWith('Bearer ') ? auth.slice(7) : '';
+        const expected = this.options.serviceToken;
+        const providedBuffer = Buffer.from(provided);
+        const expectedBuffer = Buffer.from(expected);
+        if (providedBuffer.length !== expectedBuffer.length)
+            return false;
+        return timingSafeEqual(providedBuffer, expectedBuffer);
+    }
+    async handle(req, res) {
+        const url = new URL(req.url ?? '/', 'http://internal');
+        const path = url.pathname;
+        const method = req.method ?? 'GET';
+        const service = this.options.service;
+        if (method === 'GET' && (path === '/healthz' || path === '/readyz')) {
+            json(res, 200, { ok: true });
+            return;
+        }
+        if (method === 'GET' && path === '/metrics' && this.options.metrics) {
+            res.writeHead(200, { 'content-type': 'text/plain; version=0.0.4' });
+            res.end(this.options.metrics.expose());
+            return;
+        }
+        if (!this.authorized(req)) {
+            json(res, 401, { error: 'invalid service identity' });
+            return;
+        }
+        const maxBody = this.options.maxBodyBytes ?? 8 * 1024 * 1024;
+        const parsed = method === 'GET' ? {} : await readBody(req, maxBody);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            throw new ControlPlaneError(400, 'request body must be a JSON object');
+        const body = parsed;
+        // Route table -----------------------------------------------------------
+        if (method === 'POST' && path === '/v2/work') {
+            json(res, 200, await service.enqueue(body));
+            return;
+        }
+        if (method === 'POST' && path === '/v2/work/claim') {
+            json(res, 200, await this.options.claimWork(stringField(body, 'workerId')));
+            return;
+        }
+        const workMatch = /^\/v2\/work\/([^/]+)\/([a-z]+)$/.exec(path);
+        if (workMatch) {
+            const id = decodeURIComponent(workMatch[1]);
+            const operation = workMatch[2];
+            if (method === 'GET' && operation === 'context') {
+                const proof = {
+                    id,
+                    fence: Number(url.searchParams.get('fence')),
+                    leaseToken: url.searchParams.get('leaseToken') ?? '',
+                };
+                json(res, 200, await service.loadContext(proof));
+                return;
+            }
+            if (method === 'POST') {
+                const proof = leaseProofOf(id, body);
+                switch (operation) {
+                    case 'heartbeat':
+                        json(res, 200, await service.heartbeat(proof));
+                        return;
+                    case 'session':
+                        json(res, 200, { session: await service.getSession(proof, stringField(body, 'key')) });
+                        return;
+                    case 'yield':
+                        await service.yieldWork(proof);
+                        json(res, 200, { ok: true });
+                        return;
+                    case 'actions':
+                        json(res, 200, await service.executeAction(proof, body['action']));
+                        return;
+                    case 'events':
+                        await service.recordEvent(proof, body['event']);
+                        json(res, 200, { ok: true });
+                        return;
+                    case 'messages':
+                        await service.commitMessage(proof, body['message']);
+                        json(res, 200, { ok: true });
+                        return;
+                    case 'complete':
+                        await service.complete(proof, {
+                            status: body['status'],
+                            ...(typeof body['resultText'] === 'string' ? { resultText: body['resultText'] } : {}),
+                            ...(typeof body['error'] === 'string' ? { error: body['error'] } : {}),
+                            ...(body['goalOutcome'] === undefined ? {} : { goalOutcome: body['goalOutcome'] }),
+                        });
+                        json(res, 200, { ok: true });
+                        return;
+                    case 'cancel':
+                        json(res, 200, { ok: await service.requestCancel(id) });
+                        return;
+                    case 'preempt':
+                        json(res, 200, { ok: await service.requestPreempt(id) });
+                        return;
+                    case 'steer':
+                        json(res, 200, { ok: await service.addSteer(id, stringField(body, 'text')) });
+                        return;
+                }
+            }
+        }
+        if (method === 'PUT' && path === '/v2/sessions') {
+            const proof = leaseProofOf(stringField(body, 'workId'), body);
+            json(res, 200, await service.saveSession(proof, body['session']));
+            return;
+        }
+        json(res, 404, { error: 'not found' });
+    }
+    listen(port, host = '0.0.0.0') {
+        return new Promise((resolveListen, rejectListen) => {
+            this.server.once('error', rejectListen);
+            this.server.listen(port, host, () => {
+                resolveListen(this.server.address().port);
+            });
+        });
+    }
+    async close() {
+        await new Promise((resolveClose) => {
+            this.server.close(() => resolveClose());
+            this.server.closeAllConnections?.();
+        });
+    }
+}
+export { ControlPlaneError, ControlPlaneService };
+//# sourceMappingURL=http-server.js.map

package/dist/src/control-plane/http-server.js.map

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

package/dist/src/control-plane/memory-store.d.ts

@@ -0,0 +1,71 @@
+import { type HostActionResult, type SessionRecord, type WorkCompletion, type WorkItem } from '../protocol/types.js';
+import type { ActionIntent, ActionLedgerStore, EnqueueResult, EnqueueWorkInput, EventStore, HeartbeatRow, LeasedWork, SaveSessionResult, SessionStore, StoredRunEvent, WorkStore, WorkStoreOptions } from './stores.js';
+export declare function hashToken(token: string): string;
+export declare class MemoryWorkStore implements WorkStore {
+    private readonly now;
+    hasPendingChild(parent: Omit<WorkItem, 'leaseToken'>, childId: string, requestVersion: number): Promise<boolean>;
+    private readonly rows;
+    private readonly routes;
+    private readonly sessionLeases;
+    private readonly workerLastSeen;
+    private readonly leaseTtlMs;
+    private readonly workerTimeoutMs;
+    constructor(options?: WorkStoreOptions, now?: () => number);
+    enqueue(input: EnqueueWorkInput): Promise<EnqueueResult>;
+    private sessionKey;
+    private workerAlive;
+    claim(workerId: string): Promise<WorkItem | null>;
+    private toWorkItem;
+    private validLease;
+    heartbeat(id: string, fence: number, leaseTokenHash: string): Promise<HeartbeatRow | null>;
+    getLeased(id: string, fence: number, leaseTokenHash: string): Promise<LeasedWork | null>;
+    yieldWork(id: string, fence: number, leaseTokenHash: string): Promise<boolean>;
+    complete(id: string, fence: number, leaseTokenHash: string, completion: WorkCompletion): Promise<boolean>;
+    private releaseSessionLease;
+    requestCancel(id: string): Promise<boolean>;
+    requestPreempt(id: string): Promise<boolean>;
+    addSteer(id: string, text: string): Promise<boolean>;
+    /** Test helper: inspect a row's durable state. */
+    inspect(id: string): {
+        status: string;
+        fence: number;
+        attempts: number;
+        preemptions: number;
+        resultText: string | null;
+        error: string | null;
+        goalOutcome?: WorkCompletion['goalOutcome'];
+    } | null;
+    /** Test helper: force-expire the current lease. */
+    expireLease(id: string): void;
+    /** Test helper: mark a worker dead. */
+    markWorkerDead(workerId: string): void;
+}
+export declare class MemorySessionStore implements SessionStore {
+    private readonly sessions;
+    get(key: string): Promise<SessionRecord | null>;
+    save(session: SessionRecord): Promise<SaveSessionResult>;
+}
+export declare class MemoryEventStore implements EventStore {
+    private readonly byRun;
+    append(event: StoredRunEvent): Promise<boolean>;
+    listRange(runId: string, fromSeqExclusive: number, toSeqInclusive: number, kinds?: readonly string[]): Promise<StoredRunEvent[]>;
+}
+export declare class MemoryActionLedger implements ActionLedgerStore {
+    hasWait(workId: string, requestVersion: number, wait: {
+        approvalId: string;
+    } | {
+        question: string;
+    }): Promise<boolean>;
+    unsettled(workId: string): Promise<{
+        actionKey: string;
+        action: string;
+        state: "unknown" | "awaiting_approval";
+    }[]>;
+    private readonly results;
+    private readonly intents;
+    private readonly intentDetails;
+    reserve(idempotencyKey: string, fingerprint: string, intent: ActionIntent): Promise<'started' | 'existing'>;
+    findIntent(idempotencyKey: string): Promise<ActionIntent | null>;
+    find(idempotencyKey: string): Promise<HostActionResult | null>;
+    record(idempotencyKey: string, result: HostActionResult): Promise<HostActionResult>;
+}