deepclause-sdk 0.1.2 → 0.2.1

package/dist/repl/worker-host.js

@@ -0,0 +1,305 @@
+/**
+ * The main-thread side of L2: a `ProcessBackend` that routes to a process worker.
+ *
+ * It keeps a synchronous cache of the worker's process table (refreshed by
+ * events and a short poll) so the status bar and `/ps` stay synchronous, and it
+ * services the worker's capability requests (`need`) through the session's
+ * `CapabilityBroker` — model, host tools, human input.
+ */
+import { Worker } from 'node:worker_threads';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { pidKey } from './processes.js';
+function defaultWorkerFactory(init) {
+    const here = import.meta.url;
+    const isTypeScript = /\.ts(\?|$)/.test(here) || here.includes('/src/');
+    if (isTypeScript) {
+        // Running from source: prefer the built worker, whose relative `.js`
+        // imports resolve under plain Node. The TypeScript worker needs tsx inside
+        // the worker, which is not always resolvable; fall back to it only if the
+        // build is absent. Run `npm run build` after runtime changes.
+        const built = new URL('../../dist/repl/process-worker.js', here);
+        if (existsSync(fileURLToPath(built))) {
+            return new Worker(built, { workerData: init });
+        }
+        const url = new URL('./process-worker.ts', here);
+        return new Worker(url, { workerData: init, execArgv: ['--import', 'tsx'] });
+    }
+    const url = new URL('./process-worker.js', here);
+    return new Worker(url, { workerData: init });
+}
+export class RemoteProcessHost {
+    session;
+    onEvent;
+    workerFactory;
+    refreshMs;
+    worker;
+    ready = false;
+    readyPromise;
+    disposed = false;
+    requestCounter = 0;
+    pending = new Map();
+    cache = [];
+    nameIndex = new Map();
+    refreshTimer;
+    /** Every harness snapshot sent to the worker, keyed by version (for inspection). */
+    snapshotTexts = new Map();
+    lastSnapshotVersion;
+    constructor(session, options = {}) {
+        this.session = session;
+        this.onEvent = options.onEvent;
+        this.workerFactory = options.workerFactory ?? defaultWorkerFactory;
+        this.refreshMs = options.refreshMs ?? 400;
+    }
+    async start() {
+        if (this.worker)
+            return;
+        const snapshot = this.session.processSnapshotFor();
+        this.snapshotTexts.set(snapshot.version, snapshot.text);
+        this.lastSnapshotVersion = snapshot.version;
+        const init = {
+            workspacePath: this.session.workspacePathValue(),
+            sessionId: `${this.session.getSessionId()}__w`,
+            harnessText: snapshot.text,
+            harnessVersion: snapshot.version,
+            model: this.session.modelId(),
+            provider: this.session.providerId(),
+            temperature: this.session.temperatureValue(),
+            maxTokens: this.session.maxTokensValue(),
+            toolPolicy: this.session.toolPolicyValue(),
+            tools: this.session.toolDescriptors(),
+        };
+        this.readyPromise = new Promise((resolve, reject) => {
+            this.onReady = resolve;
+            this.onFatal = reject;
+        });
+        const worker = this.workerFactory(init);
+        this.worker = worker;
+        worker.on('message', (message) => this.handleMessage(message));
+        worker.on('error', (error) => {
+            this.onFatal?.(error);
+            this.failAll(error);
+        });
+        worker.on('exit', () => {
+            this.failAll(new Error('process worker exited'));
+        });
+        await this.readyPromise;
+        this.refreshTimer = setInterval(() => void this.refresh(), this.refreshMs);
+        await this.refresh();
+    }
+    onReady;
+    onFatal;
+    /**
+     * The harness update to attach to an outbound spawn/foreground request. The
+     * worker's children must run the code the user committed, not the module the
+     * worker happened to start with — otherwise a long-lived worker serves every
+     * later spawn from a stale snapshot.
+     */
+    snapshotUpdate() {
+        const snapshot = this.session.processSnapshotFor();
+        this.snapshotTexts.set(snapshot.version, snapshot.text);
+        if (snapshot.version === this.lastSnapshotVersion) {
+            return { harnessVersion: snapshot.version };
+        }
+        this.lastSnapshotVersion = snapshot.version;
+        return { harnessText: snapshot.text, harnessVersion: snapshot.version };
+    }
+    // ---- ProcessBackend -----------------------------------------------------
+    async spawn(goal, options = {}) {
+        const result = (await this.request({
+            type: 'spawn',
+            requestId: 0,
+            goal,
+            options,
+            ...this.snapshotUpdate(),
+        }));
+        if (!result.pid)
+            throw new Error(result.error ?? 'worker spawn failed');
+        // Refresh before returning so `processes()` already includes the new
+        // process (otherwise the /spawn confirmation reads "no subagents").
+        await this.refresh();
+        return result.pid;
+    }
+    send(to, messageTerm) {
+        this.post({ type: 'send', to, message: messageTerm });
+    }
+    async stop(target, reason = 'shutdown') {
+        this.post({ type: 'stop', target, reason });
+        await delay(0);
+        await this.refresh();
+    }
+    register(name, pid) {
+        this.post({ type: 'register', name, pid });
+        this.nameIndex.set(name, pid);
+    }
+    whereis(name) {
+        if (this.nameIndex.has(name))
+            return this.nameIndex.get(name);
+        return undefined;
+    }
+    info(pid) {
+        return this.cache.find((process) => pidKey(process.pid) === pidKey(pid));
+    }
+    processes() {
+        return this.cache;
+    }
+    async callTerm(to, messageTerm, timeoutMs) {
+        const result = (await this.request({ type: 'call', requestId: 0, to, message: messageTerm, timeoutMs }));
+        if (result.error)
+            throw new Error(result.error);
+        return result.value ?? '';
+    }
+    async foregroundHandle(request, _signal) {
+        const result = (await this.request({
+            type: 'foreground',
+            requestId: 0,
+            request,
+            ...this.snapshotUpdate(),
+        }));
+        if (!result.ok || !result.result)
+            throw new Error(result.error ?? 'foreground request failed');
+        return result.result;
+    }
+    /**
+     * The harness source a process is running. The main keeps every snapshot it
+     * sent (keyed by version), so this stays synchronous and needs no worker hop.
+     */
+    codeOf(pid) {
+        const version = this.info(pid)?.harnessVersion;
+        return version ? this.snapshotTexts.get(version) : undefined;
+    }
+    async shutdown() {
+        if (this.disposed)
+            return;
+        if (this.refreshTimer)
+            clearInterval(this.refreshTimer);
+        // Post the dispose request before marking disposed, or `post` drops it.
+        try {
+            await this.request({ type: 'dispose', requestId: 0 });
+        }
+        catch {
+            // best effort
+        }
+        this.disposed = true;
+        await this.worker?.terminate();
+    }
+    // ---- worker message handling -------------------------------------------
+    handleMessage(message) {
+        switch (message.type) {
+            case 'ready':
+                this.ready = true;
+                this.onReady?.();
+                break;
+            case 'fatal':
+                this.onFatal?.(new Error(message.error));
+                break;
+            case 'disposed':
+                this.resolveRpc(message.requestId, undefined);
+                break;
+            case 'event':
+                this.onEvent?.(message.event);
+                if (message.event.type === 'started' || message.event.type === 'exited')
+                    void this.refresh();
+                break;
+            case 'spawn_result':
+                this.resolveRpc(message.requestId, message);
+                break;
+            case 'processes_result':
+                this.cache = message.processes;
+                this.rebuildNameIndex();
+                this.resolveRpc(message.requestId, message);
+                break;
+            case 'foreground_result':
+                this.resolveRpc(message.requestId, message);
+                break;
+            case 'call_result':
+                this.resolveRpc(message.requestId, message);
+                break;
+            case 'need':
+                void this.serviceNeed(message.requestId, message.kind, message.payload);
+                break;
+        }
+    }
+    async serviceNeed(requestId, kind, payload) {
+        try {
+            if (kind === 'model') {
+                const data = payload;
+                const response = await this.session.completeModelRequest({
+                    messages: data.messages,
+                    tools: data.tools,
+                    temperature: data.temperature,
+                    maxTokens: data.maxTokens,
+                    target: data.target,
+                    onText: (chunk) => this.post({ type: 'stream', requestId, kind: 'text', chunk }),
+                    onReasoning: (chunk) => this.post({ type: 'stream', requestId, kind: 'reasoning', chunk }),
+                });
+                this.post({ type: 'resolve', requestId, ok: true, result: response });
+                return;
+            }
+            if (kind === 'tool') {
+                const data = payload;
+                const result = await this.session.runHostTool(data.name, data.args);
+                this.post({ type: 'resolve', requestId, ok: true, result });
+                return;
+            }
+            const data = payload;
+            const answer = await this.session.requestHumanInput(data.prompt);
+            this.post({ type: 'resolve', requestId, ok: true, result: answer });
+        }
+        catch (error) {
+            this.post({ type: 'resolve', requestId, ok: false, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    request(message) {
+        const requestId = ++this.requestCounter;
+        const withId = { ...message, requestId };
+        return new Promise((resolve, reject) => {
+            this.pending.set(requestId, { resolve, reject });
+            this.post(withId);
+        });
+    }
+    resolveRpc(requestId, value) {
+        const rpc = this.pending.get(requestId);
+        if (!rpc)
+            return;
+        this.pending.delete(requestId);
+        rpc.resolve(value);
+    }
+    async refresh() {
+        if (!this.ready || this.disposed)
+            return;
+        try {
+            await this.request({ type: 'processes', requestId: 0 });
+        }
+        catch {
+            // the poll is best-effort
+        }
+    }
+    rebuildNameIndex() {
+        const next = new Map();
+        for (const process of this.cache) {
+            if (process.state !== 'done' && process.state !== 'crashed' && process.state !== 'killed') {
+                next.set(process.name, process.pid);
+            }
+        }
+        // Preserve explicitly registered names.
+        for (const [name, pid] of this.nameIndex)
+            if (!next.has(name))
+                next.set(name, pid);
+        this.nameIndex = next;
+    }
+    post(message) {
+        if (!this.worker || this.disposed)
+            return;
+        this.worker.postMessage(message);
+    }
+    failAll(error) {
+        for (const rpc of this.pending.values())
+            rpc.reject(error);
+        this.pending.clear();
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=worker-host.js.map

package/dist/repl/worker-host.js.map

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

package/dist/repl/worker-protocol.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Message protocol between the main thread and a process worker (L2).
+ *
+ * See `docs/DML_REPL_PROCESSES_SPEC.md` §6.3. Capability requests (`need`) always
+ * originate in the worker and are serviced on the main thread through the
+ * `CapabilityBroker`, so a worker never holds credentials or policy.
+ */
+import type { ProcessEvent, ProcessInfo, Pid, SpawnOptions } from './processes.js';
+import type { ProcessRequestPayload, ProcessRequestResult } from '../runner.js';
+import type { ToolPolicy } from '../types.js';
+/** One tool descriptor sent to the worker so it can build a proxy. */
+export interface WorkerToolDescriptor {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface WorkerInitData {
+    workspacePath?: string;
+    sessionId: string;
+    harnessText: string;
+    harnessVersion?: string;
+    model: string;
+    provider: string;
+    temperature?: number;
+    maxTokens?: number;
+    toolPolicy: ToolPolicy | null;
+    tools: WorkerToolDescriptor[];
+}
+export type MainToWorker = {
+    type: 'spawn';
+    requestId: number;
+    goal: string;
+    options: SpawnOptions;
+    harnessText?: string;
+    harnessVersion?: string;
+} | {
+    type: 'send';
+    to: Pid | string;
+    message: unknown;
+} | {
+    type: 'stop';
+    target: Pid | string;
+    reason: unknown;
+} | {
+    type: 'register';
+    name: string;
+    pid: Pid;
+} | {
+    type: 'processes';
+    requestId: number;
+} | {
+    type: 'foreground';
+    requestId: number;
+    request: ProcessRequestPayload;
+    harnessText?: string;
+    harnessVersion?: string;
+} | {
+    type: 'call';
+    requestId: number;
+    to: Pid | string;
+    message: string;
+    timeoutMs: number;
+} | {
+    type: 'resolve';
+    requestId: number;
+    ok: true;
+    result: unknown;
+} | {
+    type: 'resolve';
+    requestId: number;
+    ok: false;
+    error: string;
+} | {
+    type: 'stream';
+    requestId: number;
+    kind: 'text' | 'reasoning';
+    chunk: string;
+} | {
+    type: 'dispose';
+    requestId: number;
+};
+export type WorkerToMain = {
+    type: 'ready';
+} | {
+    type: 'fatal';
+    error: string;
+} | {
+    type: 'event';
+    event: ProcessEvent;
+} | {
+    type: 'spawn_result';
+    requestId: number;
+    pid?: Pid;
+    error?: string;
+} | {
+    type: 'processes_result';
+    requestId: number;
+    processes: ProcessInfo[];
+} | {
+    type: 'foreground_result';
+    requestId: number;
+    ok: true;
+    result: ProcessRequestResult;
+} | {
+    type: 'foreground_result';
+    requestId: number;
+    ok: false;
+    error: string;
+} | {
+    type: 'call_result';
+    requestId: number;
+    value?: string;
+    error?: string;
+} | {
+    type: 'need';
+    requestId: number;
+    kind: 'model' | 'tool' | 'input';
+    payload: unknown;
+} | {
+    type: 'disposed';
+    requestId: number;
+};
+//# sourceMappingURL=worker-protocol.d.ts.map

package/dist/repl/worker-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-protocol.d.ts","sourceRoot":"","sources":["../../src/repl/worker-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACxH;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACxH;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,WAAW,EAAE,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/repl/worker-protocol.js

@@ -0,0 +1,9 @@
+/**
+ * Message protocol between the main thread and a process worker (L2).
+ *
+ * See `docs/DML_REPL_PROCESSES_SPEC.md` §6.3. Capability requests (`need`) always
+ * originate in the worker and are serviced on the main thread through the
+ * `CapabilityBroker`, so a worker never holds credentials or policy.
+ */
+export {};
+//# sourceMappingURL=worker-protocol.js.map

package/dist/repl/worker-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-protocol.js","sourceRoot":"","sources":["../../src/repl/worker-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/runner.d.ts

@@ -50,6 +50,23 @@ export interface RunnerOptions {
     /** Effective shell backend, passed to nested task agents for their env block. */
     environment?: import('./system/runtime/shell-manager.js').ExecutionEnvironment;
 }
+export interface ProcessRequestPayload {
+    op: 'self' | 'spawn' | 'send' | 'receive' | 'requeue' | 'wait' | 'exit' | 'process_info' | 'register' | 'whereis' | 'sleep';
+    goal?: string;
+    options?: string;
+    to?: string;
+    message?: string;
+    timeout?: number;
+    reason?: string;
+    pid?: string;
+    name?: string;
+    ms?: number;
+}
+/** A process primitive's reply: the result slot key and its raw Prolog term. */
+export interface ProcessRequestResult {
+    key: 'self' | 'spawn' | 'send' | 'receive' | 'requeue' | 'wait' | 'exit' | 'process_info' | 'register' | 'whereis' | 'sleep';
+    term: string;
+}
 export interface InternalRunOptions {
     args?: unknown[];
     params?: Record<string, unknown>;
@@ -59,6 +76,8 @@ export interface InternalRunOptions {
     toolPolicy: ToolPolicy | null;
     /** Returns the answer, or undefined to cancel/fail the input request. */
     onInputRequired: (prompt: string) => Promise<string | undefined>;
+    /** Handles a DML process primitive (spawn/send/receive/...). */
+    onProcessRequest?: (request: ProcessRequestPayload, signal?: AbortSignal) => Promise<ProcessRequestResult>;
     signal?: AbortSignal;
     initialMessages?: MemoryMessage[];
     /** Per-run default judgment backend name override. */
@@ -308,6 +327,11 @@ export declare class DMLRunner {
      * Post agent loop result back to Prolog
      */
     private postAgentResult;
+    /**
+     * Post a process primitive result back to Prolog under a named slot.
+     * `term` is a raw Prolog term string, so the caller controls encoding.
+     */
+    private postProcessResult;
     /**
      * Post exec result back to Prolog
      */

package/dist/runner.d.ts.map

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

package/dist/runner.js

@@ -415,6 +415,24 @@ export class DMLRunner {
                     // Execute external tool
                     yield* this.handleExec(step.payload, options);
                     break;
+                case 'request_proc': {
+                    // A DML process primitive. The host supplies the result term so the
+                    // process layer owns all encoding (spec §4).
+                    const payload = (step.payload ?? {});
+                    if (!options.onProcessRequest) {
+                        this.postProcessResult(String(payload.op), 'error(no_process_host)');
+                        break;
+                    }
+                    try {
+                        const result = await options.onProcessRequest(payload, options.signal);
+                        this.postProcessResult(result.key, result.term);
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        this.postProcessResult(String(payload.op), `error(${JSON.stringify(message)})`);
+                    }
+                    break;
+                }
                 case 'request_sample_token':
                     yield* this.handleSampleToken(step.payload, options);
                     break;
@@ -856,6 +874,7 @@ export class DMLRunner {
                     signal: options.signal,
                     toolPolicy: options.toolPolicy,
                     onModelCall: options.onModelCall,
+                    onProcessRequest: options.onProcessRequest,
                 }, withheld, emitToolCall, emitToolEvent);
             }, withheld);
             // Run agent loop with streaming support
@@ -1938,6 +1957,26 @@ export class DMLRunner {
                         }
                         break;
                     }
+                    case 'request_proc': {
+                        // A DML tool reached a process primitive (self/send/receive/...).
+                        // Resolve it through the same host binding as the enclosing run, so
+                        // `self` is the process the tool is running inside, then post the
+                        // result back to the tool engine.
+                        const procPayload = (payload ?? {});
+                        if (!runContext.onProcessRequest) {
+                            this.postProcessResult(String(procPayload.op), 'error(no_process_host)');
+                            break;
+                        }
+                        try {
+                            const procResult = await runContext.onProcessRequest(procPayload, runContext.signal);
+                            this.postProcessResult(procResult.key, procResult.term);
+                        }
+                        catch (procError) {
+                            const procMessage = procError instanceof Error ? procError.message : String(procError);
+                            this.postProcessResult(String(procPayload.op), `error(${JSON.stringify(procMessage)})`);
+                        }
+                        break;
+                    }
                     case 'error': {
                         return { result: { error: content }, outputs };
                     }
@@ -2034,6 +2073,14 @@ export class DMLRunner {
         const fullMemoryStr = this.serializeMemoryMessages(fullMemory ?? []);
         this.query(`deepclause_mi:post_agent_result('${this.sessionId}', ${result.success}, vars{${varsStr}}, [${messagesStr}], [${fullMemoryStr}])`);
     }
+    /**
+     * Post a process primitive result back to Prolog under a named slot.
+     * `term` is a raw Prolog term string, so the caller controls encoding.
+     */
+    postProcessResult(key, term) {
+        const atom = /^[a-z][A-Za-z0-9_]*$/.test(key) ? key : `'${key.replace(/'/g, "''")}'`;
+        this.query(`deepclause_mi:post_proc_result('${this.sessionId}', ${atom}, ${term})`);
+    }
     /**
      * Post exec result back to Prolog
      */