@sublang/slc 0.2.0 → 0.4.0

package/dist/build-history.js

@@ -0,0 +1,309 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/** Complete, versioned build snapshots for incremental compilation. */
+import { constants } from 'node:fs';
+import { lstat, mkdir, open, readdir, rename, unlink, writeFile, } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { isAbsolute, join, relative, sep } from 'node:path';
+import { errorCode, isAbsentPathError } from './errors.js';
+import { hashBytes, isHash } from './hash.js';
+export const HISTORY_DIR = '.slc';
+export const BUILD_MANIFEST_SCHEMA = 'sublang.slc.build.v1';
+export const SOURCE_COPY = 'source';
+const OUTPUTS_DIR = 'outputs';
+const MAX_BUILD_NUMBER = 999_999_999_999_999;
+const BUILD_NUMBER = /^[1-9]\d{0,14}$/;
+const PRIVATE_DIRECTORY_MODE = 0o700;
+const PRIVATE_FILE_MODE = 0o600;
+/** Encodes an absolute path relative to the artifact directory. */
+export function encodeLocator(artDir, path) {
+    return relative(artDir, path).split(sep).join('/');
+}
+/** Fixed path of a phase's recorded output copy. */
+export function outputCopyPath(history, index) {
+    return join(history.dir, OUTPUTS_DIR, String(index));
+}
+/**
+ * Loads and verifies the complete active build. Any malformed directory,
+ * marker, manifest, source copy, output copy, or hash makes history absent.
+ */
+export async function loadBuildHistory(artDir) {
+    try {
+        const historyDir = join(artDir, HISTORY_DIR);
+        const buildsDir = join(historyDir, 'builds');
+        if (!(await isRealDirectory(historyDir)))
+            return null;
+        if (!(await isRealDirectory(buildsDir)))
+            return null;
+        const marker = await readPrivateFile(join(historyDir, 'latest'));
+        if (marker === null)
+            return null;
+        const markerText = marker.toString('utf8');
+        if (!/^[1-9]\d{0,14}\n?$/.test(markerText))
+            return null;
+        const build = Number(markerText.endsWith('\n') ? markerText.slice(0, -1) : markerText);
+        const dir = join(buildsDir, String(build));
+        if (!(await isRealDirectory(dir)))
+            return null;
+        if (!(await isRealDirectory(join(dir, OUTPUTS_DIR))))
+            return null;
+        const manifestBytes = await readPrivateFile(join(dir, 'manifest.json'));
+        if (manifestBytes === null)
+            return null;
+        const manifest = parseManifest(JSON.parse(manifestBytes.toString('utf8')));
+        if (manifest === null)
+            return null;
+        const source = await readPrivateFile(join(dir, SOURCE_COPY));
+        if (source === null || hashBytes(source) !== manifest.source.hash)
+            return null;
+        for (let index = 0; index < manifest.steps.length; index++) {
+            const copy = await readPrivateFile(join(dir, OUTPUTS_DIR, String(index)));
+            if (copy === null || hashBytes(copy) !== manifest.steps[index].output) {
+                return null;
+            }
+        }
+        return { build, dir, manifest };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Re-verifies the recorded chained input immediately before Update mode uses
+ * it. Step zero reads the source copy; later steps read the prior output copy.
+ */
+export async function verifiedInput(history, stepIndex, expected) {
+    if (!Number.isSafeInteger(stepIndex) || stepIndex < 0)
+        return null;
+    const path = stepIndex === 0
+        ? join(history.dir, SOURCE_COPY)
+        : outputCopyPath(history, stepIndex - 1);
+    const bytes = await readPrivateFile(path);
+    return bytes !== null && hashBytes(bytes) === expected
+        ? { path, bytes }
+        : null;
+}
+/**
+ * Removes the active marker before the first executor may write. A valid
+ * active marker must be removable; malformed advisory state is never followed.
+ */
+export async function invalidateBuildHistory(artDir, active) {
+    const historyDir = join(artDir, HISTORY_DIR);
+    if (!(await isRealDirectory(historyDir))) {
+        if (active)
+            throw new Error('active build history directory is unavailable');
+        return;
+    }
+    try {
+        await unlink(join(historyDir, 'latest'));
+    }
+    catch (error) {
+        if (isAbsentPathError(error))
+            return;
+        if (active)
+            throw error;
+    }
+}
+/**
+ * Publishes one complete snapshot and commits its number last. Callers pass
+ * already-materialized source/output bytes, so publication never follows a
+ * live phase target.
+ */
+export async function recordBuild(opts) {
+    if (opts.steps.length === 0)
+        throw new Error('cannot record an empty build');
+    const historyDir = join(opts.artDir, HISTORY_DIR);
+    const buildsDir = join(historyDir, 'builds');
+    await ensureRealDirectory(historyDir);
+    await ensureRealDirectory(buildsDir);
+    let next = 1;
+    for (const entry of await readdir(buildsDir)) {
+        if (BUILD_NUMBER.test(entry))
+            next = Math.max(next, Number(entry) + 1);
+    }
+    let dir = null;
+    while (next <= MAX_BUILD_NUMBER) {
+        const candidate = join(buildsDir, String(next));
+        try {
+            await mkdir(candidate, { mode: PRIVATE_DIRECTORY_MODE });
+            dir = candidate;
+            break;
+        }
+        catch (error) {
+            if (errorCode(error) !== 'EEXIST')
+                throw error;
+            next++;
+        }
+    }
+    if (dir === null)
+        throw new Error('build history number space is exhausted');
+    await mkdir(join(dir, OUTPUTS_DIR), { mode: PRIVATE_DIRECTORY_MODE });
+    await writeFile(join(dir, SOURCE_COPY), opts.sourceBytes, {
+        flag: 'wx',
+        mode: PRIVATE_FILE_MODE,
+    });
+    const steps = [];
+    for (let index = 0; index < opts.steps.length; index++) {
+        const step = opts.steps[index];
+        if (hashBytes(step.bytes) !== step.output) {
+            throw new Error(`accepted output changed before recording: ${step.target}`);
+        }
+        const target = encodeLocator(opts.artDir, step.target);
+        if (!isConfinedLocator(target)) {
+            throw new Error(`phase target is outside the artifact directory: ${step.target}`);
+        }
+        await writeFile(join(dir, OUTPUTS_DIR, String(index)), step.bytes, {
+            flag: 'wx',
+            mode: PRIVATE_FILE_MODE,
+        });
+        steps.push({
+            kind: step.kind,
+            name: step.name,
+            target,
+            inputs: [...step.inputs],
+            output: step.output,
+        });
+    }
+    const sourcePath = encodeLocator(opts.artDir, opts.sourcePath);
+    if (!isLocator(sourcePath)) {
+        throw new Error(`invalid source locator: ${opts.sourcePath}`);
+    }
+    const manifest = {
+        schema: BUILD_MANIFEST_SCHEMA,
+        pipeline: opts.pipeline,
+        source: { path: sourcePath, hash: hashBytes(opts.sourceBytes) },
+        steps,
+    };
+    await writeFile(join(dir, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`, { flag: 'wx', mode: PRIVATE_FILE_MODE });
+    const marker = join(historyDir, `latest.${process.pid}.${randomUUID()}`);
+    try {
+        await writeFile(marker, `${next}\n`, {
+            flag: 'wx',
+            mode: PRIVATE_FILE_MODE,
+        });
+        await rename(marker, join(historyDir, 'latest'));
+    }
+    catch (error) {
+        try {
+            await unlink(marker);
+        }
+        catch {
+            // The temporary marker may not have been created or may already be gone.
+        }
+        throw error;
+    }
+}
+async function ensureRealDirectory(path) {
+    try {
+        await mkdir(path, { mode: PRIVATE_DIRECTORY_MODE });
+    }
+    catch (error) {
+        if (errorCode(error) !== 'EEXIST')
+            throw error;
+    }
+    if (!(await isRealDirectory(path))) {
+        throw new Error(`build history path is not a real directory: ${path}`);
+    }
+}
+async function isRealDirectory(path) {
+    try {
+        return (await lstat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function readPrivateFile(path) {
+    let handle;
+    try {
+        handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        const info = await handle.stat();
+        if (!info.isFile() || info.nlink !== 1)
+            return null;
+        return await handle.readFile();
+    }
+    catch {
+        return null;
+    }
+    finally {
+        await handle?.close();
+    }
+}
+function parseManifest(value) {
+    if (!exactRecord(value, ['schema', 'pipeline', 'source', 'steps']))
+        return null;
+    if (value.schema !== BUILD_MANIFEST_SCHEMA)
+        return null;
+    if (typeof value.pipeline !== 'string' || value.pipeline.length === 0)
+        return null;
+    if (!exactRecord(value.source, ['path', 'hash']))
+        return null;
+    if (!isLocator(value.source.path) || !isRecordedHash(value.source.hash)) {
+        return null;
+    }
+    if (!Array.isArray(value.steps) || value.steps.length === 0)
+        return null;
+    const seenTargets = new Set();
+    const steps = [];
+    for (const item of value.steps) {
+        if (!exactRecord(item, ['kind', 'name', 'target', 'inputs', 'output'])) {
+            return null;
+        }
+        if (item.kind !== 'compile' && item.kind !== 'link')
+            return null;
+        if (typeof item.name !== 'string' || item.name.length === 0)
+            return null;
+        if (!isConfinedLocator(item.target) || seenTargets.has(item.target))
+            return null;
+        seenTargets.add(item.target);
+        if (!Array.isArray(item.inputs) || item.inputs.length === 0)
+            return null;
+        const inputs = [];
+        for (const input of item.inputs) {
+            if (!isRecordedHash(input))
+                return null;
+            inputs.push(input);
+        }
+        if (!isRecordedHash(item.output))
+            return null;
+        steps.push({
+            kind: item.kind,
+            name: item.name,
+            target: item.target,
+            inputs,
+            output: item.output,
+        });
+    }
+    return {
+        schema: BUILD_MANIFEST_SCHEMA,
+        pipeline: value.pipeline,
+        source: { path: value.source.path, hash: value.source.hash },
+        steps,
+    };
+}
+function exactRecord(value, keys) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const actual = Object.keys(value).sort();
+    const expected = [...keys].sort();
+    return (actual.length === expected.length &&
+        actual.every((key, index) => key === expected[index]));
+}
+function isRecordedHash(value) {
+    return typeof value === 'string' && isHash(value);
+}
+function isLocator(value) {
+    if (typeof value !== 'string' ||
+        value.length === 0 ||
+        value.includes('\\') ||
+        value.includes('\0') ||
+        isAbsolute(value)) {
+        return false;
+    }
+    return value.split('/').every((part) => part.length > 0 && part !== '.');
+}
+function isConfinedLocator(value) {
+    return isLocator(value) && !value.split('/').includes('..');
+}
+//# sourceMappingURL=build-history.js.map

package/dist/build-history.js.map

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

package/dist/cli.js

@@ -10,6 +10,7 @@
  * becomes the process exit status (CLI-11). All behavior lives in the testable
  * `run`/`interruptSignal`; see app.ts.
  */
+import { messageOf } from './errors.js';
 import { interruptSignal, run } from './index.js';
 const { signal, dispose } = interruptSignal(process);
 run(process.argv.slice(2), { signal })
@@ -19,7 +20,7 @@ run(process.argv.slice(2), { signal })
 })
     .catch((error) => {
     dispose();
-    const message = error instanceof Error ? error.message : String(error);
+    const message = messageOf(error);
     process.stderr.write(`slc: ${message}\n`);
     process.exit(1);
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,sCAAsC;AACtC,0EAA0E;AAE1E;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;AAErD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;KACnC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACb,OAAO,EAAE,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,EAAE,CAAC;IACV,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,OAAO,IAAI,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,sCAAsC;AACtC,0EAA0E;AAE1E;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;AAErD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;KACnC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACb,OAAO,EAAE,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,EAAE,CAAC;IACV,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,OAAO,IAAI,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cligent-agent.d.ts

@@ -1,5 +1,16 @@
 import type { AgentAdapter, PermissionPolicy } from '@sublang/cligent';
 import type { AgentClient } from './interpreter.js';
+/** Timer seams for the stall watchdog; injected in tests. */
+export interface WatchdogTimers {
+    setTimeout(callback: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+/**
+ * The production watchdog timers. Exported so a test can assert the ref
+ * behavior the watchdog's correctness depends on, which an injected fake
+ * would bypass.
+ */
+export declare const defaultWatchdogTimers: WatchdogTimers;
 /** Wraps a Cligent adapter as an {@link AgentClient} for the interpreter. */
 export declare function createCligentAgent(opts: {
     adapter: AgentAdapter;
@@ -7,5 +18,13 @@ export declare function createCligentAgent(opts: {
     permissions?: PermissionPolicy;
     /** Adapter-scoped reasoning effort, validated by the configuration layer. */
     effort?: string;
+    /**
+     * Milliseconds of adapter-event inactivity after which the in-flight call is
+     * aborted and reported as an error (DR-019, PHEXEC-36). Zero or absent
+     * disables the watchdog.
+     */
+    stallTimeoutMs?: number;
+    /** Watchdog timer seams; defaults to real timers. Injected in tests. */
+    watchdogTimers?: WatchdogTimers;
 }): AgentClient;
 //# sourceMappingURL=cligent-agent.d.ts.map

package/dist/cligent-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cligent-agent.d.ts","sourceRoot":"","sources":["../src/cligent-agent.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAEpE,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,WAAW,CAwDd"}
+{"version":3,"file":"cligent-agent.d.ts","sourceRoot":"","sources":["../src/cligent-agent.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAGpE,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACtD,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,cASnC,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GAAG,WAAW,CAiFd"}

package/dist/cligent-agent.js

@@ -7,11 +7,36 @@
  * draining its event stream into a normalized {@link AgentRunResult}. The host
  * supplies the concrete `AgentAdapter` (e.g. Claude Code, Codex) and any write
  * permissions, keeping agent selection a configuration concern (PHEXEC-13); the
- * DR-003 write-scope sandbox would be configured here via `permissions`. This
- * transport is exercised by integration runs, not unit tests, since it drives a
- * real agent CLI. See specs/dev/phase-execution.md.
+ * DR-003 write-scope sandbox would be configured here via `permissions`.
+ *
+ * The transport also owns the agent-stall watchdog (DR-019, PHEXEC-36): with a
+ * positive `stallTimeoutMs`, an in-flight call that observes no adapter event
+ * for that window is aborted through a call-local controller — the caller's
+ * signal is composed in, never mutated — and reported as an error carrying the
+ * inactivity duration. Cligent's abort drain guarantees the event loop then
+ * terminates promptly with a terminal event, so a tripped watchdog cannot
+ * itself hang. No retry occurs at this seam (PHEXEC-12, PHEXEC-23).
+ *
+ * This transport is exercised by integration runs and by tests that fake the
+ * adapter's event stream. See specs/dev/phase-execution.md.
  */
 import { Cligent } from '@sublang/cligent';
+import { formatElapsed } from './progress.js';
+/**
+ * The production watchdog timers. Exported so a test can assert the ref
+ * behavior the watchdog's correctness depends on, which an injected fake
+ * would bypass.
+ */
+export const defaultWatchdogTimers = {
+    // Deliberately referenced: the watchdog is the only thing guaranteed to end
+    // a stalled call, so it must hold the event loop open for its window. An
+    // unref'd timer lets Node exit the moment a dead agent transport stops
+    // holding I/O, killing the run before the stall is ever diagnosed. The
+    // timer is cleared on every event and in `dispose`, so it cannot outlive
+    // the call it guards.
+    setTimeout: (callback, ms) => setTimeout(callback, ms),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
 /** Wraps a Cligent adapter as an {@link AgentClient} for the interpreter. */
 export function createCligentAgent(opts) {
     const cligent = new Cligent(opts.adapter, {
@@ -20,41 +45,66 @@ export function createCligentAgent(opts) {
         // Validated adapter-scoped by the configuration layer (CLI-12).
         ...(opts.effort !== undefined ? { effort: opts.effort } : {}),
     });
+    const stallMs = opts.stallTimeoutMs ?? 0;
+    const timers = opts.watchdogTimers ?? defaultWatchdogTimers;
     return {
         async run({ prompt, cwd, model, resume, allowedTools, signal, }) {
+            const watchdog = createWatchdog(signal, stallMs, timers);
             const texts = [];
             let resultText = '';
             let status = 'incomplete';
             let resumeToken;
-            for await (const raw of cligent.run(prompt, {
-                abortSignal: signal,
-                cwd,
-                model,
-                ...(resume !== undefined ? { resume } : {}),
-                ...(allowedTools !== undefined
-                    ? { allowedTools: [...allowedTools] }
-                    : {}),
-            })) {
-                const event = raw;
-                if (event.type === 'text') {
-                    texts.push(event.payload.content);
-                }
-                else if (event.type === 'error') {
-                    status = 'error';
-                    texts.push(event.payload.message);
-                }
-                else if (event.type === 'done') {
-                    status =
-                        event.payload.status === 'success'
-                            ? 'success'
-                            : event.payload.status === 'error'
-                                ? 'error'
-                                : 'incomplete';
-                    if (event.payload.result)
-                        resultText = event.payload.result;
-                    resumeToken = event.payload.resumeToken;
+            try {
+                for await (const raw of cligent.run(prompt, {
+                    abortSignal: watchdog.signal,
+                    cwd,
+                    model,
+                    ...(resume !== undefined ? { resume } : {}),
+                    ...(allowedTools !== undefined
+                        ? { allowedTools: [...allowedTools] }
+                        : {}),
+                })) {
+                    // Any adapter event is activity, regardless of type: the reliable
+                    // event subset differs per adapter, so the watchdog resets on every
+                    // iteration (DR-019).
+                    watchdog.touch();
+                    const event = raw;
+                    if (event.type === 'text') {
+                        texts.push(event.payload.content);
+                    }
+                    else if (event.type === 'error') {
+                        status = 'error';
+                        texts.push(event.payload.message);
+                    }
+                    else if (event.type === 'done') {
+                        status =
+                            event.payload.status === 'success'
+                                ? 'success'
+                                : event.payload.status === 'error'
+                                    ? 'error'
+                                    : 'incomplete';
+                        if (event.payload.result)
+                            resultText = event.payload.result;
+                        resumeToken = event.payload.resumeToken;
+                    }
                 }
             }
+            finally {
+                watchdog.dispose();
+            }
+            // A real success that lands inside Cligent's post-abort drain wins over
+            // the stall verdict: the call did complete, and reporting a hang would
+            // discard a finished phase — the expensive false negative this watchdog
+            // exists to avoid causing. A genuine stall drains to `interrupted`, so
+            // this never softens a real hang.
+            if (watchdog.tripped && status !== 'success') {
+                return {
+                    status: 'error',
+                    text: `agent call stalled: no agent activity for ${formatElapsed(stallMs)}; ` +
+                        'aborted by the stall watchdog (SLC_STALL_TIMEOUT / stallTimeout)',
+                    ...(resumeToken !== undefined ? { resumeToken } : {}),
+                };
+            }
             return {
                 status,
                 text: (resultText || texts.join('\n')).trim(),
@@ -63,4 +113,49 @@ export function createCligentAgent(opts) {
         },
     };
 }
+/**
+ * Builds the watchdog for one call: a call-local controller composed with the
+ * caller's signal, plus a single reset-on-activity timeout (DR-019). With a
+ * non-positive window the caller's signal passes through untouched.
+ */
+function createWatchdog(signal, stallMs, timers) {
+    if (stallMs <= 0) {
+        return {
+            signal,
+            touch: () => { },
+            tripped: false,
+            dispose: () => { },
+        };
+    }
+    const controller = new AbortController();
+    let tripped = false;
+    let handle;
+    const onCallerAbort = () => controller.abort(signal.reason);
+    if (signal.aborted) {
+        controller.abort(signal.reason);
+    }
+    else {
+        signal.addEventListener('abort', onCallerAbort, { once: true });
+    }
+    const arm = () => timers.setTimeout(() => {
+        tripped = true;
+        controller.abort(new Error(`agent call stalled for ${formatElapsed(stallMs)}`));
+    }, stallMs);
+    handle = arm();
+    return {
+        signal: controller.signal,
+        touch: () => {
+            timers.clearTimeout(handle);
+            if (!tripped && !controller.signal.aborted)
+                handle = arm();
+        },
+        get tripped() {
+            return tripped;
+        },
+        dispose: () => {
+            timers.clearTimeout(handle);
+            signal.removeEventListener('abort', onCallerAbort);
+        },
+    };
+}
 //# sourceMappingURL=cligent-agent.js.map

package/dist/cligent-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"cligent-agent.js","sourceRoot":"","sources":["../src/cligent-agent.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,0EAA0E;AAE1E;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAU3C,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,IAMlC;IACC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE;QACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,gEAAgE;QAChE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,EACR,MAAM,EACN,GAAG,EACH,KAAK,EACL,MAAM,EACN,YAAY,EACZ,MAAM,GACP;YACC,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,MAAM,GAA6B,YAAY,CAAC;YACpD,IAAI,WAA+B,CAAC;YAEpC,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;gBAC1C,WAAW,EAAE,MAAM;gBACnB,GAAG;gBACH,KAAK;gBACL,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,YAAY,KAAK,SAAS;oBAC5B,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE;oBACrC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,EAAE,CAAC;gBACH,MAAM,KAAK,GAAe,GAAG,CAAC;gBAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACpC,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAClC,MAAM,GAAG,OAAO,CAAC;oBACjB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACpC,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACjC,MAAM;wBACJ,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;4BAChC,CAAC,CAAC,SAAS;4BACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO;gCAChC,CAAC,CAAC,OAAO;gCACT,CAAC,CAAC,YAAY,CAAC;oBACrB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM;wBAAE,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;oBAC5D,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBAC1C,CAAC;YACH,CAAC;YAED,OAAO;gBACL,MAAM;gBACN,IAAI,EAAE,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC7C,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cligent-agent.js","sourceRoot":"","sources":["../src/cligent-agent.ts"],"names":[],"mappings":"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"}

package/dist/compiled-executor.d.ts

@@ -1,4 +1,4 @@
-import type { PhaseExecutor } from './execution.js';
+import { type PhaseExecutor } from './execution.js';
 import type { AgentClient } from './interpreter.js';
 import { type CompatiblePlaybookRuntimeFactory, type RuntimeContractProfile } from './playbook-contract.js';
 import { type PlayerTransport } from './playbook-ports.js';
@@ -32,6 +32,12 @@ export declare function createCompiledExecutor(opts: {
     cwd?: string;
     /** Stable authored phase identity used as the Playbook session's playbook id. */
     playbookId?: string;
+    /**
+     * Live status sink (DR-019, PHEXEC-25): streams the runtime's human status
+     * and non-trace telemetry as it occurs; absent hosts keep the drained
+     * end-of-run diagnostics.
+     */
+    onStatus?: (line: string) => void;
     /** Session-id seam for deterministic tests; defaults to {@link randomUUID}. */
     createSessionId?: () => string;
     /** Exact pinned runtime boundary; defaults to the current legacy contract. */

package/dist/compiled-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiled-executor.d.ts","sourceRoot":"","sources":["../src/compiled-executor.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAIV,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD,OAAO,EAKL,KAAK,gCAAgC,EAKrC,KAAK,sBAAsB,EAE5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEhF;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gCAAgC,CAAC,CAW3C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,MAAM,EAAE,eAAe,CAAC;IACxB,oEAAoE;IACpE,KAAK,EAAE,WAAW,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,CACZ,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,gCAAgC,CAAC,CAAC;CAChD,GAAG,aAAa,CA+DhB"}
+{"version":3,"file":"compiled-executor.d.ts","sourceRoot":"","sources":["../src/compiled-executor.ts"],"names":[],"mappings":"AAuCA,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD,OAAO,EAKL,KAAK,gCAAgC,EAKrC,KAAK,sBAAsB,EAE5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEhF;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gCAAgC,CAAC,CAW3C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,MAAM,EAAE,eAAe,CAAC;IACxB,oEAAoE;IACpE,KAAK,EAAE,WAAW,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,CACZ,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,gCAAgC,CAAC,CAAC;CAChD,GAAG,aAAa,CA2EhB"}

package/dist/compiled-executor.js

@@ -31,6 +31,8 @@ import { createHash, randomUUID } from 'node:crypto';
 import { readFile, stat } from 'node:fs/promises';
 import { basename, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
+import { messageOf } from './errors.js';
+import { updateContextLines, } from './execution.js';
 import { composeWorkspaceContract, mapPhaseResult, seedPhaseTurn, } from './phase-runner.js';
 import { isPlaybookRunResult, } from './playbook-contract.js';
 import { createPlaybookPorts } from './playbook-ports.js';
@@ -70,6 +72,15 @@ export function createCompiledExecutor(opts) {
                 // transported prompt carries the request's absolute paths and
                 // write-scope rules (PHEXEC-34).
                 captainWorkspace: composeWorkspaceContract(input),
+                // The compiled artifact knows nothing about incremental updates, so
+                // the host appends the update context to performing prompts
+                // (DR-021, INCR-16).
+                ...(request.kind === 'compile' && request.update !== undefined
+                    ? {
+                        updateContext: updateContextLines(request.update, request.target).join('\n'),
+                    }
+                    : {}),
+                onStatus: opts.onStatus,
             });
             // Hand the runtime only Playbook's ports — never the host-only
             // drainDiagnostics, nor a file capability (DR-005, PHEXEC-23).
@@ -427,7 +438,4 @@ function phaseInput(request, runRoot) {
 function optionsRecord(options) {
     return Object.fromEntries(options.map((option) => [option.name, option.value]));
 }
-function messageOf(error) {
-    return error instanceof Error ? error.message : String(error);
-}
 //# sourceMappingURL=compiled-executor.js.map