@kelloggt/dsh-program-agents 0.0.0-stage → 0.1.0

package/dist/host/policies.d.ts

@@ -0,0 +1,36 @@
+import type { ProgramDefinition, ProgramSnapshot } from '../types.js';
+interface PolicyHost {
+    definition(owner: string, program: string): ProgramDefinition | undefined;
+    entries(): Array<{
+        ownerId: string;
+        program: string;
+        definition: ProgramDefinition;
+    }>;
+    eligible(owner: string): boolean;
+    live(owner: string, program: string): boolean;
+    start(owner: string, program: string): Promise<unknown>;
+    restart(run: ProgramSnapshot): Promise<unknown>;
+    report(run: ProgramSnapshot, error: unknown): void;
+}
+/** Opt-in process recovery. Never retries individual calls or infers application idempotence. */
+export declare class SupervisionPolicies {
+    private host;
+    private timers;
+    private attempts;
+    private suppressed;
+    private signatures;
+    private closed;
+    private starting;
+    private startingOwners;
+    constructor(host: PolicyHost);
+    private key;
+    manualStart(owner: string, program: string): void;
+    manualStop(run: ProgramSnapshot): void;
+    private cancel;
+    changed(run: ProgramSnapshot): void;
+    /** Called only after archive/session services are available, and on Agent publication. */
+    startup(ownerId?: string): Promise<void>;
+    archive(ownerId: string): void;
+    dispose(): void;
+}
+export {};

package/dist/host/policies.js

@@ -0,0 +1,73 @@
+/** Opt-in process recovery. Never retries individual calls or infers application idempotence. */
+export class SupervisionPolicies {
+    host;
+    timers = new Map();
+    attempts = new Map();
+    suppressed = new Set();
+    signatures = new Map();
+    closed = false;
+    starting = new Set();
+    startingOwners = new Set();
+    constructor(host) {
+        this.host = host;
+    }
+    key(owner, program) { return owner + '\0' + program; }
+    manualStart(owner, program) { const k = this.key(owner, program); this.suppressed.delete(k); this.attempts.delete(k); this.cancel(k); }
+    manualStop(run) { const k = this.key(run.ownerId, run.program); this.suppressed.add(k); this.cancel(k); }
+    cancel(k) { const timer = this.timers.get(k); if (timer)
+        clearTimeout(timer); this.timers.delete(k); }
+    changed(run) {
+        if (this.closed)
+            return;
+        const k = this.key(run.ownerId, run.program), signature = run.id + ':' + run.generation + ':' + run.state;
+        if (this.signatures.get(k) === signature)
+            return;
+        this.signatures.set(k, signature);
+        if (!['failed', 'completed'].includes(run.state) || this.suppressed.has(k) || !this.host.eligible(run.ownerId))
+            return;
+        const policy = this.host.definition(run.ownerId, run.program)?.supervision;
+        if (!policy || policy.restart === 'never' || policy.restart === undefined || policy.restart === 'on-failure' && run.state !== 'failed')
+            return;
+        const attempts = this.attempts.get(k) ?? 0, max = policy.maxRestarts ?? 3;
+        if (attempts >= max)
+            return;
+        this.cancel(k);
+        const delay = Math.min(300000, (policy.restartDelayMs ?? 1000) * 2 ** Math.min(attempts, 8));
+        this.attempts.set(k, attempts + 1);
+        this.timers.set(k, setTimeout(() => { this.timers.delete(k); if (this.closed || this.suppressed.has(k) || !this.host.eligible(run.ownerId))
+            return; void this.host.restart(run).catch(error => this.host.report(run, error)); }, delay));
+    }
+    /** Called only after archive/session services are available, and on Agent publication. */
+    async startup(ownerId) {
+        if (this.closed)
+            return;
+        for (const entry of this.host.entries()) {
+            if (ownerId !== undefined && entry.ownerId !== ownerId || !entry.definition.supervision?.startAtStartup || !this.host.eligible(entry.ownerId))
+                continue;
+            const k = this.key(entry.ownerId, entry.program);
+            if (this.startingOwners.has(entry.ownerId) || this.starting.has(k) || this.host.live(entry.ownerId, entry.program) || this.suppressed.has(k))
+                continue;
+            this.starting.add(k);
+            this.startingOwners.add(entry.ownerId);
+            try {
+                await this.host.start(entry.ownerId, entry.program);
+            }
+            catch (error) {
+                this.host.report({ id: 'startup', generation: 0, ownerId: entry.ownerId, program: entry.program, label: entry.definition.name ?? entry.program, state: 'failed', startedAt: new Date().toISOString(), logs: [], messages: [], resources: [] }, error);
+            }
+            finally {
+                this.starting.delete(k);
+                this.startingOwners.delete(entry.ownerId);
+            }
+        }
+    }
+    archive(ownerId) { for (const entry of this.host.entries())
+        if (entry.ownerId === ownerId) {
+            const k = this.key(ownerId, entry.program);
+            this.suppressed.add(k);
+            this.cancel(k);
+        } }
+    dispose() { this.closed = true; for (const key of this.timers.keys())
+        this.cancel(key); this.starting.clear(); this.startingOwners.clear(); }
+}
+//# sourceMappingURL=policies.js.map

package/dist/host/policies.js.map

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

package/dist/host/requests.d.ts

@@ -0,0 +1,57 @@
+import type { JsonValue } from '../types.js';
+import { type CreateRequestOptions, type RequestRecord, type RequestScope, type RequestWaitOptions, type ResponseReceipt } from '../requests.js';
+export type { CreateRequestOptions, RequestRecord, RequestScope, RequestStatus, RequestWaitOptions, ResponseReceipt } from '../requests.js';
+export interface RequestStoreOptions {
+    maxRequests?: number;
+    maxPendingPerProgram?: number;
+    maxPending?: number;
+    clock?: () => number;
+}
+/**
+ * Durable request/reply state only. No transport, agent creation, dispatch retry,
+ * or execution lease lives here. Reopening a store never replays pending work.
+ * The first valid assigned-agent reply is irreversible, not exactly-once agent
+ * execution. A transport-ambiguous request can still accept its eventual reply.
+ */
+export declare class RequestStore {
+    private readonly db;
+    private readonly maxRequests;
+    private readonly maxPendingPerProgram;
+    private readonly maxPending;
+    private readonly clock;
+    private readonly validators;
+    private readonly closeSignal;
+    private closed;
+    constructor(path: string, options?: RequestStoreOptions);
+    create(scope: RequestScope, input: CreateRequestOptions): RequestRecord;
+    /** Durable binding MUST precede dispatch. It cannot be changed or cleared. */
+    assign(scope: RequestScope, id: string, agentId: string): RequestRecord;
+    reply(scope: RequestScope, id: string, senderId: string, body: JsonValue): ResponseReceipt;
+    get(scope: RequestScope, id: string): RequestRecord | null;
+    /** Lookup before create/dispatch to distinguish a recovered request from new work. */
+    getByKey(scope: RequestScope, requestKey: string): RequestRecord | null;
+    wait(scope: RequestScope, id: string, options?: RequestWaitOptions, signal?: AbortSignal): Promise<RequestRecord>;
+    cancel(scope: RequestScope, id: string): RequestRecord;
+    fail(scope: RequestScope, id: string, error?: string): RequestRecord;
+    dispatchUnknown(scope: RequestScope, id: string, error?: string): RequestRecord;
+    dispatchAccepted(scope: RequestScope, id: string): RequestRecord;
+    /** Inspection only, including ambiguous dispatches. Nothing here authorizes replay. */
+    listPending(scope?: RequestScope): RequestRecord[];
+    close(): void;
+    private change;
+    private expire;
+    private assertLive;
+    private validator;
+    private row;
+    private keyRow;
+    private required;
+    private record;
+    private receipt;
+    private checkOpen;
+    private checkScope;
+    private text;
+    private bound;
+    private configLimit;
+    private errorText;
+    private transaction;
+}

package/dist/host/requests.js

@@ -0,0 +1,353 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { chmodSync, mkdirSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { setTimeout as delay } from 'node:timers/promises';
+import { assertJson, ProgramError } from '../runtime/protocol.js';
+import { assertRequestPayload, createResponseValidator, DEFAULT_RESPONSE_SCHEMA, REQUEST_LIMITS } from '../requests.js';
+const live = (status) => status === 'pending' || status === 'dispatch-unknown';
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    if (value && typeof value === 'object')
+        return `{${Object.keys(value).sort().map(key => `${JSON.stringify(key)}:${canonical(value[key])}`).join(',')}}`;
+    return JSON.stringify(value);
+}
+function hash(value) { return createHash('sha256').update(value).digest('hex'); }
+/**
+ * Durable request/reply state only. No transport, agent creation, dispatch retry,
+ * or execution lease lives here. Reopening a store never replays pending work.
+ * The first valid assigned-agent reply is irreversible, not exactly-once agent
+ * execution. A transport-ambiguous request can still accept its eventual reply.
+ */
+export class RequestStore {
+    db;
+    maxRequests;
+    maxPendingPerProgram;
+    maxPending;
+    clock;
+    validators = new Map();
+    closeSignal = new AbortController();
+    closed = false;
+    constructor(path, options = {}) {
+        this.maxRequests = this.configLimit(options.maxRequests ?? REQUEST_LIMITS.maxRequests, 'maxRequests', REQUEST_LIMITS.maxRequests);
+        this.maxPendingPerProgram = this.configLimit(options.maxPendingPerProgram ?? REQUEST_LIMITS.maxPendingPerProgram, 'maxPendingPerProgram', REQUEST_LIMITS.maxPendingPerProgram);
+        this.maxPending = this.configLimit(options.maxPending ?? REQUEST_LIMITS.maxPending, 'maxPending', REQUEST_LIMITS.maxPending);
+        this.clock = options.clock ?? Date.now;
+        if (path !== ':memory:') {
+            path = resolve(path);
+            mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+        }
+        this.db = new DatabaseSync(path);
+        if (path !== ':memory:')
+            chmodSync(path, 0o600);
+        this.db.exec(`PRAGMA journal_mode = WAL; PRAGMA busy_timeout = 1000;
+      CREATE TABLE IF NOT EXISTS agent_requests (
+        id TEXT PRIMARY KEY, owner_id TEXT NOT NULL, program TEXT NOT NULL,
+        request_key TEXT, fingerprint TEXT NOT NULL, target TEXT NOT NULL,
+        body TEXT NOT NULL, response_schema TEXT NOT NULL, prompt TEXT,
+        status TEXT NOT NULL CHECK(status IN ('pending','answered','cancelled','expired','failed','dispatch-unknown')),
+        agent_id TEXT, created_at INTEGER NOT NULL, deadline INTEGER NOT NULL,
+        dispatch_accepted_at INTEGER, answered_at INTEGER, closed_at INTEGER,
+        response TEXT, response_hash TEXT, response_id TEXT, error TEXT,
+        UNIQUE(owner_id,program,request_key)
+      );
+      CREATE INDEX IF NOT EXISTS agent_requests_scope ON agent_requests(owner_id,program,status,created_at);
+      CREATE INDEX IF NOT EXISTS agent_requests_deadline ON agent_requests(status,deadline);
+    `);
+    }
+    create(scope, input) {
+        this.checkScope(scope);
+        if (!input || typeof input !== 'object' || Array.isArray(input))
+            throw new ProgramError('INVALID_INPUT', 'Expected request options');
+        const requestKey = input.requestKey ?? input.requestId;
+        if (input.requestKey !== undefined && input.requestId !== undefined && input.requestKey !== input.requestId)
+            throw new ProgramError('INVALID_INPUT', 'Conflicting request idempotency keys');
+        if (requestKey !== undefined)
+            this.text(requestKey, 'request idempotency key', 256);
+        assertRequestPayload(input.target);
+        assertRequestPayload(input.body);
+        if (Buffer.byteLength(JSON.stringify(input.target)) > REQUEST_LIMITS.promptBytes)
+            throw new ProgramError('LIMIT', 'Request target exceeds 8 KiB');
+        if (Buffer.byteLength(JSON.stringify(input.body)) > REQUEST_LIMITS.bodyBytes)
+            throw new ProgramError('LIMIT', 'Request body exceeds 48 KiB');
+        if (input.prompt !== undefined && (typeof input.prompt !== 'string' || Buffer.byteLength(input.prompt) > REQUEST_LIMITS.promptBytes))
+            throw new ProgramError('INVALID_INPUT', 'Request prompt must be a string no larger than 8 KiB');
+        const timeoutMs = this.bound(input.timeoutMs ?? REQUEST_LIMITS.defaultTimeoutMs, 'timeoutMs', 1, REQUEST_LIMITS.maxTimeoutMs);
+        const schema = input.responseSchema === undefined ? DEFAULT_RESPONSE_SCHEMA : input.responseSchema;
+        this.validator(schema);
+        // Reserve at least 8 KiB for routing identity, deadline and the reply contract.
+        // Independent body/schema limits alone could persist undispatchable work.
+        const content = { target: input.target, body: input.body, responseSchema: schema, prompt: input.prompt ?? null, timeoutMs };
+        // Account for aggregate nodes and schema depth in a framed contract as well
+        // as isolated payloads. Never accept input that cannot later be dispatched.
+        assertJson({ request: content, framingReserve: Array(64).fill(null) });
+        if (Buffer.byteLength(JSON.stringify(content)) > REQUEST_LIMITS.requestBytes)
+            throw new ProgramError('LIMIT', 'Combined request input exceeds 56 KiB');
+        const fingerprint = hash(canonical(content));
+        return this.transaction(() => {
+            const now = this.clock();
+            this.expire(now);
+            if (requestKey !== undefined) {
+                const existing = this.keyRow(scope, requestKey);
+                if (existing) {
+                    if (existing.fingerprint !== fingerprint)
+                        throw new ProgramError('IDEMPOTENCY_CONFLICT', 'Request idempotency key is already bound to different input');
+                    return this.record(existing);
+                }
+            }
+            const pending = this.db.prepare("SELECT count(*) AS count FROM agent_requests WHERE owner_id=? AND program=? AND status IN ('pending','dispatch-unknown')").get(scope.ownerId, scope.program).count;
+            if (pending >= this.maxPendingPerProgram)
+                throw new ProgramError('BACKPRESSURE', 'Program has too many active requests');
+            const global = this.db.prepare("SELECT count(*) AS count FROM agent_requests WHERE status IN ('pending','dispatch-unknown')").get().count;
+            if (global >= this.maxPending)
+                throw new ProgramError('BACKPRESSURE', 'Global active request limit reached');
+            const total = this.db.prepare('SELECT count(*) AS count FROM agent_requests').get().count;
+            if (total >= this.maxRequests)
+                this.db.prepare("DELETE FROM agent_requests WHERE id IN (SELECT id FROM agent_requests WHERE status NOT IN ('pending','dispatch-unknown') ORDER BY closed_at,created_at,rowid LIMIT ?)").run(total - this.maxRequests + 1);
+            if (this.db.prepare('SELECT count(*) AS count FROM agent_requests').get().count >= this.maxRequests)
+                throw new ProgramError('BACKPRESSURE', 'Request store is full; active requests cannot be pruned');
+            const id = randomUUID();
+            this.db.prepare('INSERT INTO agent_requests (id,owner_id,program,request_key,fingerprint,target,body,response_schema,prompt,status,created_at,deadline) VALUES (?,?,?,?,?,?,?,?,?,?,?,?)').run(id, scope.ownerId, scope.program, requestKey ?? null, fingerprint, JSON.stringify(input.target), JSON.stringify(input.body), JSON.stringify(schema), input.prompt ?? null, 'pending', now, now + timeoutMs);
+            return this.record(this.row(scope, id));
+        });
+    }
+    /** Durable binding MUST precede dispatch. It cannot be changed or cleared. */
+    assign(scope, id, agentId) {
+        this.text(agentId, 'agent id', 1024);
+        return this.change(scope, id, row => {
+            if (row.agent_id === agentId)
+                return;
+            if (row.agent_id !== null)
+                throw new ProgramError('ALREADY_ASSIGNED', 'Request is bound to another agent');
+            this.assertLive(row);
+            this.db.prepare('UPDATE agent_requests SET agent_id=? WHERE id=?').run(agentId, row.id);
+        });
+    }
+    reply(scope, id, senderId, body) {
+        this.checkScope(scope);
+        this.text(senderId, 'sender id', 1024);
+        const result = this.transaction(() => {
+            this.expire(this.clock());
+            const row = this.required(scope, id);
+            if (row.agent_id === null)
+                return new ProgramError('NOT_ASSIGNED', 'Request has not been assigned to an agent');
+            if (row.agent_id !== senderId)
+                return new ProgramError('WRONG_AGENT', 'Only the exact assigned agent may reply to this request');
+            if (!live(row.status) && row.status !== 'answered')
+                return new ProgramError(row.status === 'expired' ? 'EXPIRED' : 'REQUEST_CLOSED', `Request is ${row.status}`);
+            if (row.status === 'answered') {
+                try {
+                    assertJson(body);
+                    if (Buffer.byteLength(JSON.stringify(body)) <= REQUEST_LIMITS.bodyBytes && row.response_hash === hash(canonical(body)))
+                        return this.receipt(row);
+                }
+                catch { /* A malformed retry is necessarily different from the accepted JSON. */ }
+                return new ProgramError('ALREADY_REPLIED', 'A different reply has already been accepted');
+            }
+            // Invalid replies never close the pending request or reserve a response slot.
+            this.validator(JSON.parse(row.response_schema))(body);
+            const responseHash = hash(canonical(body));
+            const now = this.clock();
+            if (now >= row.deadline) {
+                this.expire(now);
+                return new ProgramError('EXPIRED', 'Request deadline has passed');
+            }
+            const responseId = hash(`${row.id}\0${senderId}\0${responseHash}`);
+            this.db.prepare("UPDATE agent_requests SET status='answered',response=?,response_hash=?,response_id=?,answered_at=?,closed_at=?,error=NULL WHERE id=? AND status IN ('pending','dispatch-unknown')").run(JSON.stringify(body), responseHash, responseId, now, now, row.id);
+            return this.receipt(this.row(scope, id));
+        });
+        if (result instanceof ProgramError)
+            throw result;
+        return result;
+    }
+    get(scope, id) {
+        this.checkScope(scope);
+        return this.transaction(() => { this.expire(this.clock()); const row = this.row(scope, id); return row ? this.record(row) : null; });
+    }
+    /** Lookup before create/dispatch to distinguish a recovered request from new work. */
+    getByKey(scope, requestKey) {
+        this.checkScope(scope);
+        this.text(requestKey, 'request idempotency key', 256);
+        return this.transaction(() => { this.expire(this.clock()); const row = this.keyRow(scope, requestKey); return row ? this.record(row) : null; });
+    }
+    async wait(scope, id, options = {}, signal) {
+        this.checkScope(scope);
+        const waitMs = this.bound(options.waitMs ?? REQUEST_LIMITS.maxWaitMs, 'waitMs', 0, REQUEST_LIMITS.maxWaitMs);
+        const end = Date.now() + waitMs;
+        const combined = signal ? AbortSignal.any([signal, this.closeSignal.signal]) : this.closeSignal.signal;
+        for (;;) {
+            if (this.closed)
+                throw new ProgramError('DISPOSED', 'Request store is closed');
+            if (signal?.aborted)
+                throw new ProgramError('CANCELLED', 'Request wait was cancelled');
+            const row = this.get(scope, id);
+            if (!row)
+                throw new ProgramError('NOT_FOUND', 'Request not found');
+            if (row.status !== 'pending' || Date.now() >= end)
+                return row;
+            try {
+                await delay(Math.min(REQUEST_LIMITS.pollMs, Math.max(1, end - Date.now()), Math.max(1, Date.parse(row.deadline) - this.clock())), undefined, { signal: combined });
+            }
+            catch {
+                throw new ProgramError(this.closed ? 'DISPOSED' : 'CANCELLED', this.closed ? 'Request store is closed' : 'Request wait was cancelled');
+            }
+        }
+    }
+    cancel(scope, id) {
+        return this.change(scope, id, row => {
+            if (!live(row.status))
+                return;
+            this.db.prepare("UPDATE agent_requests SET status='cancelled',closed_at=?,error=NULL WHERE id=?").run(this.clock(), row.id);
+        });
+    }
+    fail(scope, id, error = 'Request failed') {
+        return this.change(scope, id, row => {
+            if (!live(row.status))
+                return;
+            this.db.prepare("UPDATE agent_requests SET status='failed',closed_at=?,error=? WHERE id=?").run(this.clock(), this.errorText(error), row.id);
+        });
+    }
+    dispatchUnknown(scope, id, error = 'Dispatch outcome is unknown; automatic redispatch is disabled') {
+        return this.change(scope, id, row => {
+            if (!live(row.status))
+                return;
+            this.db.prepare("UPDATE agent_requests SET status='dispatch-unknown',error=? WHERE id=?").run(this.errorText(error), row.id);
+        });
+    }
+    dispatchAccepted(scope, id) {
+        return this.change(scope, id, row => {
+            if (row.agent_id === null)
+                throw new ProgramError('NOT_ASSIGNED', 'Assign an agent before recording dispatch');
+            // A reply may race ahead of the transport receipt; never overwrite it.
+            if (row.dispatch_accepted_at === null)
+                this.db.prepare('UPDATE agent_requests SET dispatch_accepted_at=? WHERE id=?').run(this.clock(), row.id);
+        });
+    }
+    /** Inspection only, including ambiguous dispatches. Nothing here authorizes replay. */
+    listPending(scope) {
+        if (scope)
+            this.checkScope(scope);
+        else
+            this.checkOpen();
+        return this.transaction(() => {
+            this.expire(this.clock());
+            const rows = scope
+                ? this.db.prepare("SELECT * FROM agent_requests WHERE owner_id=? AND program=? AND status IN ('pending','dispatch-unknown') ORDER BY created_at,rowid").all(scope.ownerId, scope.program)
+                : this.db.prepare("SELECT * FROM agent_requests WHERE status IN ('pending','dispatch-unknown') ORDER BY created_at,rowid").all();
+            return rows.map(row => this.record(row));
+        });
+    }
+    close() { if (this.closed)
+        return; this.closed = true; this.closeSignal.abort(); this.validators.clear(); this.db.close(); }
+    change(scope, id, fn) {
+        this.checkScope(scope);
+        const result = this.transaction(() => {
+            this.expire(this.clock());
+            const row = this.required(scope, id);
+            try {
+                fn(row);
+            }
+            catch (error) {
+                if (error instanceof ProgramError)
+                    return error;
+                throw error;
+            }
+            return this.record(this.row(scope, id));
+        });
+        if (result instanceof ProgramError)
+            throw result;
+        return result;
+    }
+    expire(now) {
+        this.db.prepare("UPDATE agent_requests SET status='expired',closed_at=deadline,error='Request deadline has passed' WHERE status IN ('pending','dispatch-unknown') AND deadline<=?").run(now);
+    }
+    assertLive(row) {
+        if (!live(row.status))
+            throw new ProgramError(row.status === 'expired' ? 'EXPIRED' : 'REQUEST_CLOSED', `Request is ${row.status}`);
+    }
+    validator(schema) {
+        try {
+            assertJson(schema);
+            if (Buffer.byteLength(JSON.stringify(schema)) > REQUEST_LIMITS.schemaBytes)
+                throw new Error('Response schema exceeds 16 KiB');
+        }
+        catch {
+            throw new ProgramError('INVALID_SCHEMA', 'Response schema must be finite JSON no larger than 16 KiB and depth 32');
+        }
+        const key = canonical(schema);
+        let validate = this.validators.get(key);
+        if (!validate) {
+            validate = createResponseValidator(schema);
+            if (this.validators.size >= 128)
+                this.validators.delete(this.validators.keys().next().value);
+            this.validators.set(key, validate);
+        }
+        return validate;
+    }
+    row(scope, id) {
+        this.text(id, 'request id', 256);
+        return this.db.prepare('SELECT * FROM agent_requests WHERE owner_id=? AND program=? AND id=?').get(scope.ownerId, scope.program, id);
+    }
+    keyRow(scope, key) {
+        return this.db.prepare('SELECT * FROM agent_requests WHERE owner_id=? AND program=? AND request_key=?').get(scope.ownerId, scope.program, key);
+    }
+    required(scope, id) {
+        const row = this.row(scope, id);
+        if (!row)
+            throw new ProgramError('NOT_FOUND', 'Request not found');
+        return row;
+    }
+    record(row) {
+        return {
+            id: row.id, requestId: row.id, ownerId: row.owner_id, program: row.program,
+            ...(row.request_key === null ? {} : { requestKey: row.request_key }),
+            target: JSON.parse(row.target), body: JSON.parse(row.body),
+            responseSchema: JSON.parse(row.response_schema),
+            ...(row.prompt === null ? {} : { prompt: row.prompt }), status: row.status,
+            ...(row.agent_id === null ? {} : { agentId: row.agent_id }),
+            createdAt: new Date(row.created_at).toISOString(), deadline: new Date(row.deadline).toISOString(),
+            ...(row.dispatch_accepted_at === null ? {} : { dispatchAcceptedAt: new Date(row.dispatch_accepted_at).toISOString() }),
+            ...(row.answered_at === null ? {} : { answeredAt: new Date(row.answered_at).toISOString() }),
+            ...(row.closed_at === null ? {} : { closedAt: new Date(row.closed_at).toISOString() }),
+            ...(row.response === null ? {} : { response: JSON.parse(row.response) }),
+            ...(row.status === 'answered' ? { receipt: this.receipt(row) } : {}),
+            ...(row.error === null ? {} : { error: row.error }),
+        };
+    }
+    receipt(row) { return { id: row.response_id, requestId: row.id, status: 'answered', agentId: row.agent_id, answeredAt: new Date(row.answered_at).toISOString() }; }
+    checkOpen() { if (this.closed)
+        throw new ProgramError('DISPOSED', 'Request store is closed'); }
+    checkScope(scope) {
+        this.checkOpen();
+        if (!scope || typeof scope.ownerId !== 'string' || !scope.ownerId || scope.ownerId.length > 1024 || typeof scope.program !== 'string' || !scope.program || scope.program.length > 256)
+            throw new ProgramError('INVALID_INPUT', 'Invalid request namespace');
+    }
+    text(value, name, max) { if (typeof value !== 'string' || !value || value.length > max)
+        throw new ProgramError('INVALID_INPUT', `Invalid ${name}`); }
+    bound(value, name, min, max) {
+        if (!Number.isSafeInteger(value) || value < min || value > max)
+            throw new ProgramError('INVALID_INPUT', `${name} must be an integer from ${min} to ${max}`);
+        return value;
+    }
+    configLimit(value, name, max) {
+        if (!Number.isSafeInteger(value) || value < 1 || value > max)
+            throw new ProgramError('INVALID_CONFIG', `${name} must be an integer from 1 to ${max}`);
+        return value;
+    }
+    errorText(value) { return (typeof value === 'string' ? value : 'Request failed').replace(/[\u0000-\u001f\u007f]/g, ' ').slice(0, 1024); }
+    transaction(fn) {
+        this.checkOpen();
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const result = fn();
+            this.db.exec('COMMIT');
+            return result;
+        }
+        catch (error) {
+            this.db.exec('ROLLBACK');
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=requests.js.map

package/dist/host/requests.js.map

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

package/dist/host/tool-client.d.ts

@@ -0,0 +1,19 @@
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { Tool } from '../mcp.js';
+import type { JsonValue } from '../types.js';
+interface Access {
+    tools?: string[];
+    mcp?: Array<{
+        server: string;
+        tools: string[];
+    }>;
+}
+/** Discover only tools already visible in the exact parent's DSH tool runtime. */
+export declare function listToolEntries(owner: Agent, access: Access, server?: string): Tool[];
+export declare function listTools(owner: Agent, access: Access, input: Record<string, unknown>): JsonValue;
+export declare function callTool(owner: Agent, access: Access, input: Record<string, unknown>, signal: AbortSignal, execute: (name: string, args: JsonValue) => Promise<{
+    isError?: boolean;
+    content?: unknown;
+    value?: unknown;
+}>): Promise<JsonValue>;
+export {};