@kindgi/handler-runtime 0.0.0-bootstrap.0 → 0.1.0

package/dist/pack-service/supervisor.js

@@ -0,0 +1,424 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * The pack service as a local child process behind a stable front — how
+ * a development loop runs pack code: the same entrypoint and protocol as
+ * a deployment, on loopback, with a token only this process knows.
+ *
+ * The front is one HTTP listener for the supervisor's whole life: a fixed
+ * address, the session token. It forwards `POST /v1/invoke` and
+ * `GET /v1/info` to whichever child is serving and answers 503 while none
+ * is — a caller retries those, since the call provably did not run.
+ * `/healthz` answers 200 while the front listens; `/readyz` 200 only while
+ * a child serves. So a caller holds one URL and one token however often
+ * the code changes.
+ *
+ * `start(indexPath)` boots a child on that index (loopback, any port).
+ * Once the child listens (it prewarms every module first), new calls go to
+ * it; the previous child finishes its in-flight calls (SIGTERM drains) and
+ * stops. If a child fails to boot, the previous one keeps serving. A child
+ * that exits on its own is restarted on the same index.
+ *
+ * The child's environment is exactly `env()` plus the token and `PORT=0`
+ * — nothing of this process's own environment reaches pack code.
+ *
+ * Forwarding has two parts. The relay ({@link PackRelay}) takes a request
+ * body and the call's options — deadline, run and request ids, a cancel
+ * signal — and calls the serving child. The HTTP listener maps headers and
+ * a closed connection onto those options. Another listener (one that
+ * receives calls over a connection the pack side opened) can reuse the
+ * relay unchanged.
+ */
+import { spawn } from 'node:child_process';
+import { randomBytes, timingSafeEqual } from 'node:crypto';
+import { createServer } from 'node:http';
+import { createInterface } from 'node:readline';
+import { PACK_HEADERS } from '../protocol.js';
+import { PACK_SERVICE_DRAIN_MS } from './main.js';
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_BOOT_TIMEOUT_MS = 60_000;
+const DEFAULT_STOP_GRACE_MS = PACK_SERVICE_DRAIN_MS + 2_000;
+const DEFAULT_MAX_RESTARTS = 3;
+const DEFAULT_RESTART_DELAY_MS = 500;
+const DEFAULT_MAX_BODY_BYTES = 10 * 1024 * 1024;
+/** A token a caller supplies: as long as a generated one (24 bytes, base64url). */
+const PACK_SERVICE_TOKEN = /^[A-Za-z0-9_-]{32,}$/;
+/** Headers of a child's answer that the front passes on. */
+const ANSWER_HEADERS = [
+    'content-type',
+    'retry-after',
+    PACK_HEADERS.artifactVersion,
+    PACK_HEADERS.durationMs,
+];
+export function createPackServiceSupervisor(options) {
+    if (options.token !== undefined && !PACK_SERVICE_TOKEN.test(options.token)) {
+        throw new Error('A pack service token is at least 32 URL-safe base64 characters.');
+    }
+    const token = options.token ?? randomBytes(24).toString('base64url');
+    const expectedToken = Buffer.from(token);
+    const emit = (event) => options.onEvent?.(event);
+    let serving;
+    let stopped = false;
+    let restarts = 0;
+    let front;
+    async function boot(indexPath) {
+        const env = { ...(await options.env()), KINDGI_PACK_SERVICE_TOKEN: token, PORT: '0' };
+        const [program, ...args] = options.command;
+        const child = spawn(program, [...args, '--index', indexPath, '--module-root', options.moduleRoot, '--host', DEFAULT_HOST], { env, stdio: ['ignore', 'pipe', 'pipe'] });
+        pipeLines(child.stdout, (line) => options.onLog?.(line, 'stdout'));
+        return listening(child, indexPath);
+    }
+    /** Resolves once the child listens, or with why it never will. */
+    function listening(child, indexPath) {
+        const bootTimeoutMs = options.bootTimeoutMs ?? DEFAULT_BOOT_TIMEOUT_MS;
+        return new Promise((resolve) => {
+            const problems = [];
+            // A promise settles once; later calls (an exit after listening) are no-ops.
+            const done = (outcome) => {
+                clearTimeout(timer);
+                resolve(outcome);
+            };
+            const fail = (reasons) => done({ kind: 'err', error: { problems: reasons } });
+            const timer = setTimeout(() => {
+                child.kill('SIGKILL');
+                fail([`The pack service did not listen within ${bootTimeoutMs} ms`]);
+            }, bootTimeoutMs);
+            pipeLines(child.stderr, (line) => {
+                const event = serviceEvent(line);
+                if (event === undefined) {
+                    options.onLog?.(line, 'stderr');
+                }
+                else if (event.kind === 'listening' && typeof event.port === 'number') {
+                    done({
+                        kind: 'ok',
+                        value: { process: child, port: event.port, indexPath, retiring: false },
+                    });
+                }
+                else if (event.kind === 'boot-failed' || event.kind === 'config-invalid') {
+                    problems.push(...problemsOf(event));
+                }
+                else {
+                    emit({ kind: 'log', event });
+                }
+            });
+            child.once('error', (cause) => fail([cause.message]));
+            child.once('exit', (code, signal) => fail(problems.length > 0
+                ? problems
+                : [`The pack service exited (${signal ?? code}) before listening`]));
+        });
+    }
+    /** A serving child that exits on its own is restarted on the same index. */
+    function watch(child) {
+        child.process.once('exit', (code, signal) => {
+            if (child.retiring || stopped)
+                return;
+            emit({ kind: 'exited', code, signal });
+            if (serving === child)
+                serving = undefined;
+            void recover(child.indexPath);
+        });
+    }
+    async function recover(indexPath) {
+        while (!stopped &&
+            serving === undefined &&
+            restarts < (options.maxRestarts ?? DEFAULT_MAX_RESTARTS)) {
+            restarts += 1;
+            emit({ kind: 'restarting', attempt: restarts });
+            await new Promise((r) => setTimeout(r, options.restartDelayMs ?? DEFAULT_RESTART_DELAY_MS));
+            if (stopped || serving !== undefined)
+                return;
+            const booted = await start(indexPath);
+            if (booted.kind === 'ok')
+                return;
+        }
+        if (!stopped && serving === undefined)
+            emit({ kind: 'gave-up', attempts: restarts });
+    }
+    async function retire(child) {
+        if (child === undefined)
+            return;
+        child.retiring = true;
+        if (child.process.exitCode !== null || child.process.signalCode !== null)
+            return;
+        const exited = new Promise((done) => child.process.once('exit', () => done()));
+        child.process.kill('SIGTERM');
+        const grace = setTimeout(() => child.process.kill('SIGKILL'), options.stopGraceMs ?? DEFAULT_STOP_GRACE_MS);
+        await exited;
+        clearTimeout(grace);
+    }
+    async function start(indexPath) {
+        stopped = false;
+        const booted = await boot(indexPath);
+        if (booted.kind === 'err') {
+            emit({ kind: 'boot-failed', problems: booted.error.problems });
+            return booted;
+        }
+        const previous = serving;
+        serving = booted.value;
+        restarts = 0;
+        watch(booted.value);
+        emit({ kind: 'started', port: booted.value.port, indexPath });
+        await retire(previous);
+        return { kind: 'ok', value: { port: booted.value.port } };
+    }
+    async function stop() {
+        stopped = true;
+        const child = serving;
+        serving = undefined;
+        await retire(child);
+    }
+    const relay = {
+        serving: () => serving !== undefined,
+        forward: (call) => forwardToChild(serving?.port, token, call),
+    };
+    function authorized(req) {
+        const got = req.headers[PACK_HEADERS.token];
+        if (typeof got !== 'string')
+            return false;
+        const buf = Buffer.from(got);
+        return buf.length === expectedToken.length && timingSafeEqual(buf, expectedToken);
+    }
+    /** The HTTP listener: maps a request onto a relay call and the outcome onto a response. */
+    async function handle(req, res) {
+        const admitted = admit(req);
+        if (typeof admitted !== 'string') {
+            return sendJson(res, admitted.status, admitted.body, admitted.headers);
+        }
+        const body = admitted === 'invoke'
+            ? await readBody(req, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES)
+            : undefined;
+        if (admitted === 'invoke' && body === undefined) {
+            return sendJson(res, 413, { error: 'Request body too large' });
+        }
+        // The caller gave up (closed the connection) before the answer: cancel the call.
+        const controller = new AbortController();
+        res.on('close', () => {
+            if (!res.writableEnded)
+                controller.abort();
+        });
+        const outcome = await relay.forward(relayCall(req, admitted, body, controller.signal));
+        if (!res.writableEnded && !res.destroyed)
+            writeOutcome(res, outcome);
+    }
+    /**
+     * The relay route for a request, or the front's own answer: an unknown
+     * route, a wrong method, a probe, a bad token.
+     */
+    function admit(req) {
+        const route = FRONT_ROUTES[(req.url ?? '/').split('?')[0] ?? ''];
+        if (route === undefined)
+            return { status: 404, body: { error: `No route ${req.url ?? '/'}` } };
+        if (req.method !== route.method)
+            return { status: 405, body: { error: `Use ${route.method}` } };
+        if (route.name === 'healthz' || route.name === 'readyz')
+            return probe(route.name);
+        if (!authorized(req))
+            return { status: 401, body: { error: 'Bad pack token' } };
+        return route.name;
+    }
+    /** `/healthz`: the front listens. `/readyz`: a child serves. Neither needs the token. */
+    function probe(name) {
+        if (name === 'healthz')
+            return { status: 200, body: { status: 'ok' } };
+        return relay.serving()
+            ? { status: 200, body: { status: 'ready' } }
+            : { status: 503, body: { error: 'no pack service' }, headers: RETRY_AFTER };
+    }
+    return {
+        token,
+        relay,
+        async listen() {
+            if (front !== undefined)
+                return { url: front.url, port: front.port };
+            const host = options.host ?? DEFAULT_HOST;
+            const server = createServer((req, res) => {
+                void handle(req, res).catch((cause) => {
+                    if (!res.headersSent)
+                        sendJson(res, 500, { error: describe(cause) });
+                    else
+                        res.destroy();
+                });
+            });
+            await new Promise((ready, failed) => {
+                server.once('error', failed);
+                server.listen(options.port ?? 0, host, () => {
+                    server.off('error', failed);
+                    ready();
+                });
+            });
+            const port = server.address().port;
+            front = { server, port, url: `http://${host.includes(':') ? `[${host}]` : host}:${port}` };
+            return { url: front.url, port };
+        },
+        start,
+        stop,
+        async close() {
+            await stop();
+            const closing = front;
+            front = undefined;
+            if (closing !== undefined) {
+                // No child serves any more; drop idle keep-alives and callers that went away.
+                const closed = new Promise((done) => closing.server.close(() => done()));
+                closing.server.closeAllConnections();
+                await closed;
+            }
+        },
+    };
+}
+/** Call the serving child on `port` with the session token. */
+async function forwardToChild(port, token, call) {
+    if (port === undefined)
+        return { kind: 'unavailable', reason: 'no pack service' };
+    if (call.signal?.aborted)
+        return { kind: 'cancelled' };
+    let response;
+    try {
+        response = await fetch(`http://${DEFAULT_HOST}:${port}/v1/${call.route}`, {
+            method: call.route === 'invoke' ? 'POST' : 'GET',
+            headers: childHeaders(token, call),
+            ...(call.body !== undefined && { body: call.body }),
+            ...(call.signal !== undefined && { signal: call.signal }),
+        });
+    }
+    catch (cause) {
+        if (call.signal?.aborted)
+            return { kind: 'cancelled' };
+        return refused(cause)
+            ? { kind: 'unavailable', reason: 'the pack service refused the connection' }
+            : { kind: 'failed', reason: `the pack service did not answer: ${describe(cause)}` };
+    }
+    return answerFrom(response, call.signal);
+}
+function childHeaders(token, call) {
+    return {
+        [PACK_HEADERS.token]: token,
+        ...(call.body !== undefined && { 'content-type': 'application/json' }),
+        ...(call.timeoutMs !== undefined && { [PACK_HEADERS.timeoutMs]: String(call.timeoutMs) }),
+        ...(call.runId !== undefined && { [PACK_HEADERS.runId]: call.runId }),
+        ...(call.requestId !== undefined && { [PACK_HEADERS.requestId]: call.requestId }),
+        ...(call.protocol !== undefined && { [PACK_HEADERS.protocol]: call.protocol }),
+    };
+}
+async function answerFrom(response, signal) {
+    let body;
+    try {
+        body = await response.text();
+    }
+    catch (cause) {
+        if (signal?.aborted)
+            return { kind: 'cancelled' };
+        return { kind: 'failed', reason: `the pack service's answer broke off: ${describe(cause)}` };
+    }
+    const headers = {};
+    for (const name of ANSWER_HEADERS) {
+        const value = response.headers.get(name);
+        if (value !== null)
+            headers[name] = value;
+    }
+    return { kind: 'answer', status: response.status, headers, body };
+}
+/** The relay call for a front request. */
+function relayCall(req, route, body, signal) {
+    const timeoutMs = Number(header(req, PACK_HEADERS.timeoutMs));
+    const runId = header(req, PACK_HEADERS.runId);
+    const requestId = header(req, PACK_HEADERS.requestId);
+    const protocol = header(req, PACK_HEADERS.protocol);
+    return {
+        route,
+        signal,
+        ...(body !== undefined && { body }),
+        ...(Number.isFinite(timeoutMs) && timeoutMs > 0 && { timeoutMs }),
+        ...(runId !== undefined && { runId }),
+        ...(requestId !== undefined && { requestId }),
+        ...(protocol !== undefined && { protocol }),
+    };
+}
+function writeOutcome(res, outcome) {
+    switch (outcome.kind) {
+        case 'answer':
+            res.writeHead(outcome.status, {
+                ...outcome.headers,
+                'content-length': Buffer.byteLength(outcome.body),
+            });
+            res.end(outcome.body);
+            return;
+        case 'unavailable':
+            sendJson(res, 503, { error: outcome.reason }, RETRY_AFTER);
+            return;
+        case 'failed':
+            sendJson(res, 502, { error: outcome.reason });
+            return;
+        case 'cancelled':
+            res.destroy();
+            return;
+    }
+}
+const RETRY_AFTER = { 'retry-after': '1' };
+const FRONT_ROUTES = {
+    '/v1/invoke': { name: 'invoke', method: 'POST' },
+    '/v1/info': { name: 'info', method: 'GET' },
+    '/healthz': { name: 'healthz', method: 'GET' },
+    '/readyz': { name: 'readyz', method: 'GET' },
+};
+/** A connection that never reached a listener: the call did not run. */
+function refused(cause) {
+    const code = cause?.cause?.code;
+    return code === 'ECONNREFUSED';
+}
+function header(req, name) {
+    const value = req.headers[name];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/** The request body, or `undefined` past `limit` bytes. */
+function readBody(req, limit) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        let tooLarge = false;
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > limit)
+                tooLarge = true;
+            else
+                chunks.push(chunk);
+        });
+        req.on('end', () => resolve(tooLarge ? undefined : Buffer.concat(chunks).toString('utf8')));
+        req.on('error', reject);
+    });
+}
+function sendJson(res, status, body, headers = {}) {
+    const text = JSON.stringify(body);
+    res.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'content-length': Buffer.byteLength(text),
+        ...headers,
+    });
+    res.end(text);
+}
+function pipeLines(stream, onLine) {
+    if (stream !== null)
+        createInterface({ input: stream }).on('line', onLine);
+}
+function problemsOf(event) {
+    return Array.isArray(event.problems) ? event.problems.map(String) : [];
+}
+/** The service's own log lines are JSON objects with a `kind`. */
+function serviceEvent(line) {
+    if (!line.startsWith('{'))
+        return undefined;
+    try {
+        const parsed = JSON.parse(line);
+        return parsed !== null &&
+            typeof parsed === 'object' &&
+            typeof parsed.kind === 'string'
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function describe(cause) {
+    return cause instanceof Error ? cause.message : String(cause);
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/pack-service/supervisor.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Pack protocol v2 — the messages a runtime exchanges with a pack
+ * service (`./pack-service`) to run pack code: tool handlers and
+ * guardrail checks.
+ *
+ * A request names a tool or check by id; the pack service resolves it
+ * from its own `index.json`. The caller never chooses which module is
+ * imported, and the schemas that validate input and output are the
+ * ones the pack was built with.
+ *
+ * One request, one response. Every outcome of running pack code —
+ * success, a validation failure, a throw, a deadline, an unknown tool —
+ * is a response message. Transport problems (auth, overload, draining)
+ * are HTTP statuses, never messages.
+ */
+/** Wire version of every v2 message. */
+export declare const PACK_PROTOCOL_VERSION: 2;
+export type PackProtocolVersion = typeof PACK_PROTOCOL_VERSION;
+/** Per-call context a handler receives (serializable; no functions). */
+export interface PackCallContext {
+    readonly tenantId: string;
+    /** The kernel run this call belongs to. */
+    readonly runId: string;
+    /** The individual call — e.g. the model's tool-call id. */
+    readonly requestId?: string;
+    readonly env?: Readonly<Record<string, unknown>>;
+    readonly secrets?: Readonly<Record<string, unknown>>;
+    readonly config?: Readonly<Record<string, unknown>>;
+}
+export interface ToolRef {
+    readonly id: string;
+    /** When set, the pack service refuses a different indexed version. */
+    readonly version?: string;
+}
+export interface CheckRef {
+    /** Guardrail check id (the indexed guardrail's `checkId`). */
+    readonly id: string;
+}
+export interface ToolInvokeMessage {
+    readonly v: PackProtocolVersion;
+    readonly kind: 'invoke';
+    readonly tool: ToolRef;
+    readonly input: unknown;
+    readonly ctx: PackCallContext;
+}
+export interface CheckInvokeMessage {
+    readonly v: PackProtocolVersion;
+    readonly kind: 'check-invoke';
+    readonly check: CheckRef;
+    readonly config: Readonly<Record<string, unknown>>;
+    readonly trace: unknown;
+}
+export interface ToolResultMessage {
+    readonly v: PackProtocolVersion;
+    readonly kind: 'result';
+    readonly output: unknown;
+}
+export interface CheckResultMessage {
+    readonly v: PackProtocolVersion;
+    readonly kind: 'check-result';
+    readonly result: unknown;
+}
+export type PackErrorCode = 'input-validation-failed' | 'output-validation-failed' | 'handler-import-failed' | 'handler-shape-invalid' | 'handler-throw' | 'check-shape-invalid' | 'malformed-message' | 'unknown-protocol-version' | 'unexpected-message-kind' | 'tool-not-in-pack' | 'check-not-in-pack' | 'tool-version-mismatch' | 'deadline-exceeded' | 'cancelled';
+export interface PackErrorMessage {
+    readonly v: PackProtocolVersion;
+    readonly kind: 'error';
+    readonly code: PackErrorCode;
+    readonly message: string;
+    readonly toolId?: string;
+    readonly checkId?: string;
+    readonly cause?: unknown;
+    /** Schema-validation issues (Ajv-style), for the validation codes. */
+    readonly issues?: readonly unknown[];
+}
+export type PackRequest = ToolInvokeMessage | CheckInvokeMessage;
+export type PackResponse = ToolResultMessage | CheckResultMessage | PackErrorMessage;
+export type ParseOutcome<T> = {
+    readonly kind: 'ok';
+    readonly value: T;
+} | {
+    readonly kind: 'err';
+    readonly error: PackErrorMessage;
+};
+export declare function packError(code: PackErrorCode, message: string, extra?: Omit<Partial<PackErrorMessage>, 'v' | 'kind' | 'code' | 'message'>): PackErrorMessage;
+/** Parse a request body (already JSON-decoded) into a v2 request. */
+export declare function parsePackRequest(value: unknown): ParseOutcome<PackRequest>;
+/** Parse a response body (already JSON-decoded) into a v2 response. */
+export declare function parsePackResponse(value: unknown): ParseOutcome<PackResponse>;
+/**
+ * HTTP headers of the v2 transport. `Authorization` is deliberately not
+ * used: on platforms like Cloud Run it carries the platform's identity
+ * token, so the pack token travels separately.
+ */
+export declare const PACK_HEADERS: {
+    readonly protocol: "kindgi-protocol";
+    readonly token: "kindgi-pack-token";
+    /** Relative deadline for the call, in milliseconds. */
+    readonly timeoutMs: "kindgi-timeout-ms";
+    readonly runId: "kindgi-run-id";
+    readonly requestId: "kindgi-request-id";
+    readonly artifactVersion: "kindgi-artifact-version";
+    readonly durationMs: "kindgi-duration-ms";
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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