deepclause-sdk 0.1.1 → 0.1.3

package/dist/repl/status.d.ts.map

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

package/dist/repl/status.js

@@ -139,6 +139,10 @@ export class ReplStatusTracker {
         const fallback = isAgent ? this.estimated.agent : this.estimated.harness;
         return emptyContext(this.contextWindow, observed ?? fallback);
     }
+    /** Update the reasoning level shown next to the model. */
+    setThinkingLevel(level) {
+        this.model = { ...this.model, thinkingLevel: level };
+    }
     snapshot() {
         const context = { agent: this.slotUsage('agent'), harness: this.slotUsage('harness') };
         const activeSlot = this.activeGroup === 'agent' ? 'agent' : 'harness';

package/dist/repl/status.js.map

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

package/dist/repl/tool-arguments.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tool-call parameter validation.
+ *
+ * A tool call with an unknown parameter used to be accepted and the extra key
+ * silently dropped, so `exec(bash(command: "cat", stdin: "…"), R)` looked
+ * reasonable, ran `cat` with no input, and reported success. That is the worst
+ * kind of failure: nothing to see, nothing to fix, and the DML author blames
+ * their own logic. Rejecting the call names the mistake at the point it is made.
+ *
+ * Deliberately shallow — unknown keys, missing required keys, and the primitive
+ * types. Deep or conditional validation belongs in the tool, which knows its own
+ * semantics; this exists to catch a call that cannot mean what it says.
+ */
+export interface ToolJsonSchema {
+    type?: string;
+    properties?: Record<string, {
+        type?: string | string[];
+    }>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+export type ArgumentValidation = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** Read `properties`/`required` out of a JSON Schema tool parameter block. */
+export declare function readToolSchema(schema: unknown): ToolJsonSchema | undefined;
+/**
+ * Validate a tool call's arguments. Nothing to check is not a failure: a tool
+ * with no declared properties, or a schema this cannot read (a Zod schema is
+ * enforced by the AI SDK instead), passes.
+ */
+export declare function validateToolArguments(toolName: string, schema: unknown, args: Record<string, unknown>): ArgumentValidation;
+//# sourceMappingURL=tool-arguments.d.ts.map

package/dist/repl/tool-arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-arguments.d.ts","sourceRoot":"","sources":["../../src/repl/tool-arguments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAgB7E,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAU1E;AAiCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,kBAAkB,CAkDpB"}

package/dist/repl/tool-arguments.js

@@ -0,0 +1,123 @@
+/**
+ * Tool-call parameter validation.
+ *
+ * A tool call with an unknown parameter used to be accepted and the extra key
+ * silently dropped, so `exec(bash(command: "cat", stdin: "…"), R)` looked
+ * reasonable, ran `cat` with no input, and reported success. That is the worst
+ * kind of failure: nothing to see, nothing to fix, and the DML author blames
+ * their own logic. Rejecting the call names the mistake at the point it is made.
+ *
+ * Deliberately shallow — unknown keys, missing required keys, and the primitive
+ * types. Deep or conditional validation belongs in the tool, which knows its own
+ * semantics; this exists to catch a call that cannot mean what it says.
+ */
+/**
+ * Extra advice for mistakes that are easy to make and hard to read back. The
+ * generic "unknown parameter" message is enough for a typo, but not for a field
+ * that looks like it should exist.
+ */
+const PARAMETER_HINTS = {
+    stdin: 'exec(bash(...)) has no stdin. Pass the data as an `argv` element '
+        + '(quoted by the runtime), or write it to a workspace file and name the file.',
+    input: 'Pass data as an `argv` element or through a workspace file.',
+    shell: 'exec(bash(...)) always runs a shell; put the command in `command`, '
+        + 'or pass a program and its arguments as `argv`.',
+    cwd: 'The working directory is always the workspace (/workspace); do not pass one.',
+};
+/** Read `properties`/`required` out of a JSON Schema tool parameter block. */
+export function readToolSchema(schema) {
+    if (!schema || typeof schema !== 'object')
+        return undefined;
+    const record = schema;
+    const properties = record.properties;
+    if (!properties || typeof properties !== 'object')
+        return undefined;
+    return {
+        properties: properties,
+        required: Array.isArray(record.required) ? record.required : [],
+        additionalProperties: record.additionalProperties,
+    };
+}
+/** Does `value` satisfy the declared primitive type? */
+function matchesType(value, type) {
+    if (!type)
+        return true;
+    const types = Array.isArray(type) ? type : [type];
+    return types.some((candidate) => {
+        switch (candidate) {
+            case 'string':
+                return typeof value === 'string';
+            case 'number':
+                return typeof value === 'number' && Number.isFinite(value);
+            case 'integer':
+                return typeof value === 'number' && Number.isInteger(value);
+            case 'boolean':
+                return typeof value === 'boolean';
+            case 'array':
+                return Array.isArray(value);
+            case 'object':
+                return typeof value === 'object' && value !== null && !Array.isArray(value);
+            case 'null':
+                return value === null;
+            default:
+                return true;
+        }
+    });
+}
+function describeAccepted(properties) {
+    const names = Object.keys(properties);
+    return names.length > 0 ? names.join(', ') : '(none)';
+}
+/**
+ * Validate a tool call's arguments. Nothing to check is not a failure: a tool
+ * with no declared properties, or a schema this cannot read (a Zod schema is
+ * enforced by the AI SDK instead), passes.
+ */
+export function validateToolArguments(toolName, schema, args) {
+    const declared = readToolSchema(schema);
+    // Nothing declared means nothing to check — a tool with no parameters (which
+    // may still be called positionally) cannot have a wrong one.
+    if (!declared?.properties || Object.keys(declared.properties).length === 0)
+        return { ok: true };
+    const properties = declared.properties;
+    const unknownKeys = declared.additionalProperties === true
+        ? []
+        : Object.keys(args).filter((key) => !(key in properties) && !key.startsWith('$'));
+    if (unknownKeys.length > 0) {
+        const quoted = unknownKeys.map((key) => `'${key}'`).join(', ');
+        // The hint explains the mistake; the accepted list says what to write
+        // instead. Both, or the author is left guessing which parameter was meant.
+        const hints = unknownKeys
+            .map((key) => PARAMETER_HINTS[key])
+            .filter(Boolean)
+            .join(' ');
+        return {
+            ok: false,
+            error: `${toolName}: unknown parameter ${quoted}. ${hints} `
+                + `Accepted: ${describeAccepted(properties)}.`.replace(/\s+/g, ' '),
+        };
+    }
+    const missing = (declared.required ?? []).filter((key) => args[key] === undefined || args[key] === null);
+    if (missing.length > 0) {
+        return {
+            ok: false,
+            error: `${toolName}: missing required parameter${missing.length > 1 ? 's' : ''} `
+                + `${missing.join(', ')}.`,
+        };
+    }
+    for (const [key, value] of Object.entries(args)) {
+        if (value === undefined || key.startsWith('$'))
+            continue;
+        const expected = properties[key]?.type;
+        if (!matchesType(value, expected)) {
+            const typeLabel = Array.isArray(expected) ? expected.join('|') : String(expected);
+            const actual = Array.isArray(value) ? 'array' : value === null ? 'null' : typeof value;
+            return {
+                ok: false,
+                error: `${toolName}: parameter ${key} should be ${typeLabel}, got ${actual}.`,
+            };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=tool-arguments.js.map

package/dist/repl/tool-arguments.js.map

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

package/dist/repl/toolset.d.ts

@@ -7,7 +7,7 @@
  * human-in-the-loop channel (`ask_user` / `input/2`). `--tools`/`--no-tools`
  * control whether `bash` is registered.
  */
-import { type HostShellConfig } from '../system/runtime/shell-manager.js';
+import { type ExecutionEnvironment, type HostShellConfig } from '../system/runtime/shell-manager.js';
 import type { DMLEvent, ToolDefinition } from '../types.js';
 export declare const DEFAULT_REPL_TOOLS: readonly ["bash"];
 export interface ReplToolsetOptions {
@@ -24,9 +24,36 @@ export interface ReplToolset {
     tools: Map<string, ToolDefinition>;
     /** Catalog text injected into the meta prompt. */
     catalog: string;
+    /**
+     * How shell commands will actually run here. The caller passes this to the
+     * session so the harness `require_sandbox` check, the model's environment
+     * block and this toolset all agree on one answer.
+     */
+    environment: ExecutionEnvironment;
     dispose(): Promise<void>;
 }
+/**
+ * Describe the `bash` tool, including where it runs.
+ *
+ * The agent has to reconcile two surfaces — its own tools and DML's `exec` — and
+ * they must not disagree about what a path means. So the description states the
+ * one name, and states whether anything is actually isolated, rather than
+ * letting the agent assume a sandbox is there.
+ */
+export declare function describeBashTool(environment: ExecutionEnvironment): string;
 /** Human-readable catalog of the registered capability tools. */
 export declare function buildToolCatalog(tools: Map<string, ToolDefinition>): string;
+/**
+ * Join an argv list into a shell command, quoting every element.
+ *
+ * This is what makes `exec(bash(argv: [...]))` worth having: the author passes
+ * values as a list and never writes a quote, so data containing spaces, quotes,
+ * `$`, backticks, `;` or newlines cannot escape into the command. It still runs
+ * through the same launch plan, so the sandbox and wrapper are unchanged.
+ *
+ * POSIX single-quote quoting: wrap in `'`, and end/restart the quote around any
+ * embedded `'` (`'\''`).
+ */
+export declare function quoteArgv(argv: readonly string[]): string;
 export declare function createReplToolset(options: ReplToolsetOptions): Promise<ReplToolset>;
 //# sourceMappingURL=toolset.d.ts.map

package/dist/repl/toolset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolset.d.ts","sourceRoot":"","sources":["../../src/repl/toolset.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE9F,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,eAAO,MAAM,kBAAkB,mBAAoB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,MAAM,CAa3E;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4DzF"}
+{"version":3,"file":"toolset.d.ts","sourceRoot":"","sources":["../../src/repl/toolset.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,eAAO,MAAM,kBAAkB,mBAAoB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,oBAAoB,GAAG,MAAM,CAc1E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,MAAM,CAa3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEzD;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuEzF"}

package/dist/repl/toolset.js

@@ -7,9 +7,32 @@
  * human-in-the-loop channel (`ask_user` / `input/2`). `--tools`/`--no-tools`
  * control whether `bash` is registered.
  */
-import { createShellManager } from '../system/runtime/shell-manager.js';
+import { createShellManager, describeShellExecutionBackend, } from '../system/runtime/shell-manager.js';
 import { createShellToolEventBridge } from '../system/runtime/shell-tool-events.js';
 export const DEFAULT_REPL_TOOLS = ['bash'];
+/**
+ * Describe the `bash` tool, including where it runs.
+ *
+ * The agent has to reconcile two surfaces — its own tools and DML's `exec` — and
+ * they must not disagree about what a path means. So the description states the
+ * one name, and states whether anything is actually isolated, rather than
+ * letting the agent assume a sandbox is there.
+ */
+export function describeBashTool(environment) {
+    const isolation = environment.kind === 'clean-room'
+        ? 'There is NO sandbox: commands run as your user account, and anything you '
+            + 'write outside the workspace is real and persists.'
+        : `Isolated by ${environment.description}.`;
+    return [
+        'Run a shell command in the session workspace.',
+        'Your working directory is the workspace, and /workspace names that same '
+            + 'directory (DML uses the same name), so out/report.txt and '
+            + '/workspace/out/report.txt are one file.',
+        'Only files under the workspace are shared with the host. For scratch use '
+            + '"$TMPDIR" (a per-session directory), not a fixed path like /tmp.',
+        isolation,
+    ].join(' ');
+}
 /** Human-readable catalog of the registered capability tools. */
 export function buildToolCatalog(tools) {
     if (tools.size === 0) {
@@ -25,10 +48,25 @@ export function buildToolCatalog(tools) {
     lines.push('DML file I/O always uses the MI predicates (open/3, close/1, read_string/3, write/2, write_file/2, read_file/2, append_file/2); it is not a host tool.');
     return lines.join('\n');
 }
+/**
+ * Join an argv list into a shell command, quoting every element.
+ *
+ * This is what makes `exec(bash(argv: [...]))` worth having: the author passes
+ * values as a list and never writes a quote, so data containing spaces, quotes,
+ * `$`, backticks, `;` or newlines cannot escape into the command. It still runs
+ * through the same launch plan, so the sandbox and wrapper are unchanged.
+ *
+ * POSIX single-quote quoting: wrap in `'`, and end/restart the quote around any
+ * embedded `'` (`'\''`).
+ */
+export function quoteArgv(argv) {
+    return argv.map((item) => `'${item.replace(/'/g, `'\\''`)}'`).join(' ');
+}
 export async function createReplToolset(options) {
     const requested = options.toolNames === null
         ? []
         : options.toolNames ?? [...DEFAULT_REPL_TOOLS];
+    const environment = describeShellExecutionBackend(options.sandbox, options.hostConfig ?? {});
     const tools = new Map();
     let shell = requested.includes('bash')
         ? createShellManager({
@@ -41,20 +79,29 @@ export async function createReplToolset(options) {
     if (shell) {
         const shellManager = shell;
         tools.set('bash', {
-            description: 'Run a shell command in the active workspace shell.',
+            description: describeBashTool(environment),
             parameters: {
                 type: 'object',
                 properties: {
                     command: { type: 'string', description: 'Shell command to execute.' },
+                    argv: {
+                        type: 'array',
+                        description: 'Command and arguments as a list, quoted by the runtime. '
+                            + 'Prefer this over `command` when any argument is data.',
+                    },
                     timeoutMs: {
                         type: 'integer',
                         description: 'Wall-clock timeout in milliseconds (optional; overrides DC_HOST_SHELL_TIMEOUT_MS).',
                     },
                 },
-                required: ['command'],
             },
             execute: async (args, context) => {
-                const command = String(args.command ?? args.arg1 ?? '');
+                const argv = Array.isArray(args.argv)
+                    ? args.argv.map((item) => String(item))
+                    : undefined;
+                const command = argv && argv.length > 0
+                    ? quoteArgv(argv)
+                    : String(args.command ?? args.arg1 ?? '');
                 const timeoutMs = typeof args.timeoutMs === 'number' && Number.isFinite(args.timeoutMs) && args.timeoutMs > 0
                     ? args.timeoutMs
                     : undefined;
@@ -71,6 +118,7 @@ export async function createReplToolset(options) {
     return {
         tools,
         catalog: buildToolCatalog(tools),
+        environment,
         dispose: async () => {
             if (shell) {
                 await shell.dispose();

package/dist/repl/toolset.js.map

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

package/dist/repl/tui/autocomplete.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Slash-command completion for the REPL editor.
+ *
+ * Pi's `CombinedAutocompleteProvider` does the work: it matches commands by prefix
+ * and, where a base path is given, completes file paths too.
+ *
+ * The list is *not* what the CLI parses — `classifyReplInput` has its own switch and
+ * reads nothing from here — so the two drift, and a command that parses but is not
+ * listed is invisible to the user. `/reasoning` and `/show-reasoning` were exactly
+ * that. `tests/repl-tui-pickers.test.ts` now checks both directions: every advertised
+ * command must parse, and every command the parser accepts must be advertised (or be
+ * a deliberate alias).
+ */
+import { type AutocompleteProvider, type SlashCommand } from '@earendil-works/pi-tui';
+/** The REPL's slash commands, with the argument each takes. */
+export declare const REPL_COMMANDS: SlashCommand[];
+/** Build the editor's autocomplete provider, with file completion under `cwd`. */
+export declare function createReplAutocomplete(cwd: string): AutocompleteProvider;
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/repl/tui/autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../../src/repl/tui/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAEhC,+DAA+D;AAC/D,eAAO,MAAM,aAAa,EAAE,YAAY,EAoBvC,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAExE"}

package/dist/repl/tui/autocomplete.js

@@ -0,0 +1,41 @@
+/**
+ * Slash-command completion for the REPL editor.
+ *
+ * Pi's `CombinedAutocompleteProvider` does the work: it matches commands by prefix
+ * and, where a base path is given, completes file paths too.
+ *
+ * The list is *not* what the CLI parses — `classifyReplInput` has its own switch and
+ * reads nothing from here — so the two drift, and a command that parses but is not
+ * listed is invisible to the user. `/reasoning` and `/show-reasoning` were exactly
+ * that. `tests/repl-tui-pickers.test.ts` now checks both directions: every advertised
+ * command must parse, and every command the parser accepts must be advertised (or be
+ * a deliberate alias).
+ */
+import { CombinedAutocompleteProvider, } from '@earendil-works/pi-tui';
+/** The REPL's slash commands, with the argument each takes. */
+export const REPL_COMMANDS = [
+    { name: 'goal', description: 'Run a DML goal', argumentHint: '<dml>' },
+    { name: 'help', description: 'Show help' },
+    { name: 'listing', description: 'List predicates', argumentHint: '[all|Name/Arity|prefix]' },
+    { name: 'viz', description: 'Draw a skill as a diagram', argumentHint: '<entry> [presentation|spec]' },
+    { name: 'export', description: 'Save the harness to a file', argumentHint: '[path]' },
+    { name: 'model', description: 'Switch or show the active model', argumentHint: '[provider:id]' },
+    { name: 'reasoning', description: 'Set the model reasoning level', argumentHint: '[off|minimal|low|medium|high|xhigh|max]' },
+    { name: 'show-reasoning', description: 'How much reasoning to display', argumentHint: '[off|summary|full]' },
+    { name: 'reset', description: 'Clear the harness' },
+    { name: 'rollback', description: 'Restore the previous harness version' },
+    { name: 'compact', description: 'Compact the conversation', argumentHint: '[instructions]' },
+    { name: 'freeze', description: 'Refuse further edits' },
+    { name: 'unfreeze', description: 'Allow edits again' },
+    { name: 'params', description: 'Show session parameters' },
+    { name: 'trace', description: 'Turn the execution trace on' },
+    { name: 'notrace', description: 'Turn the execution trace off' },
+    { name: 'show', description: 'Display a workspace image', argumentHint: '<path>' },
+    { name: 'gen', description: 'Generate an image', argumentHint: '<prompt>' },
+    { name: 'halt', description: 'Exit' },
+];
+/** Build the editor's autocomplete provider, with file completion under `cwd`. */
+export function createReplAutocomplete(cwd) {
+    return new CombinedAutocompleteProvider(REPL_COMMANDS, cwd);
+}
+//# sourceMappingURL=autocomplete.js.map

package/dist/repl/tui/autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../../../src/repl/tui/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,4BAA4B,GAG7B,MAAM,wBAAwB,CAAC;AAEhC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,OAAO,EAAE;IACtE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE;IAC1C,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,yBAAyB,EAAE;IAC5F,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,2BAA2B,EAAE,YAAY,EAAE,6BAA6B,EAAE;IACtG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE,YAAY,EAAE,QAAQ,EAAE;IACrF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,iCAAiC,EAAE,YAAY,EAAE,eAAe,EAAE;IAChG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,+BAA+B,EAAE,YAAY,EAAE,yCAAyC,EAAE;IAC5H,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,+BAA+B,EAAE,YAAY,EAAE,oBAAoB,EAAE;IAC5G,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE;IACnD,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACzE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE,YAAY,EAAE,gBAAgB,EAAE;IAC5F,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;IACvD,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE;IACtD,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;IAC1D,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC7D,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8BAA8B,EAAE;IAChE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,2BAA2B,EAAE,YAAY,EAAE,QAAQ,EAAE;IAClF,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,UAAU,EAAE;IAC3E,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;CACtC,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,IAAI,4BAA4B,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC"}

package/dist/repl/tui/document.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Component transcript for the fullscreen TUI.
+ *
+ * The plain/readline path keeps the line-based `TranscriptComponent`; the TUI
+ * needs a tree, because a tool call, a streamed answer and a code fence have to
+ * be *components* (so markdown can be re-rendered as text arrives, a tool pane can
+ * expand, and `ScrollView` can scroll a bounded document).
+ *
+ * Entries are either styled text lines (rendered at the current width, so a
+ * resize re-wraps them) or components rendered as-is.
+ */
+import { type Component } from '@earendil-works/pi-tui';
+export type DocumentLineStyle = 'user' | 'steer';
+/** A bounded component document: append-only, with one live (unterminated) line. */
+export declare class TranscriptDocument implements Component {
+    private entries;
+    private pending;
+    private pendingStyle?;
+    private readonly maxEntries;
+    /** Called whenever content changes, so the TUI can schedule a render. */
+    onChange?: () => void;
+    constructor(maxEntries?: number);
+    private trim;
+    /** Append one styled line. Consecutive blank lines collapse. */
+    appendText(line: string, style?: DocumentLineStyle): void;
+    /** Alias for `appendText`, matching the line-based transcript's API. */
+    append(line: string, style?: DocumentLineStyle): void;
+    /**
+     * Append a component (a tool pane, markdown block, status notice).
+     *
+     * Components get a blank line above them unless the document already ends in one.
+     * Without it a tool call, its output and the next tool call read as one wall of
+     * text — the transcript has no other separation once the blocks are adjacent.
+     */
+    appendComponent(component: Component): void;
+    /** Append terminal-image lines verbatim: they must not be wrapped or measured. */
+    appendImageLines(lines: string[]): void;
+    /** The live (not yet newline-terminated) line, as the line sink writes it. */
+    setPending(line: string, style?: DocumentLineStyle): void;
+    /** Whether anything has been written (used to separate user turns). */
+    isEmpty(): boolean;
+    /**
+     * One string per entry. Kept for callers that only ask "is there output yet";
+     * the rendered text of a component is not available without a width.
+     */
+    getLines(): string[];
+    clear(): void;
+    render(width: number): string[];
+    invalidate(): void;
+}
+//# sourceMappingURL=document.d.ts.map

package/dist/repl/tui/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/repl/tui/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAIhC,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAkCjD,oFAAoF;AACpF,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;gBAEV,UAAU,SAAO;IAI7B,OAAO,CAAC,IAAI;IAMZ,gEAAgE;IAChE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAUzD,wEAAwE;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAIrD;;;;;;OAMG;IACH,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAW3C,kFAAkF;IAClF,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAQvC,8EAA8E;IAC9E,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAMzD,uEAAuE;IACvE,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACH,QAAQ,IAAI,MAAM,EAAE;IAKpB,KAAK,IAAI,IAAI;IAMb,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAiD/B,UAAU,IAAI,IAAI;CAKnB"}