@north-light/crouter 0.3.170 → 0.3.172

package/dist/core/canvas/human-work-outbox.js

@@ -1,261 +0,0 @@
-// human-work-outbox.ts — the CONSULT_OUTBOX storage ABI's data-access layer.
-//
-// `consult_outbox` remains the physical table name so live older runtimes keep
-// their storage contract. Code calls the generalized record human work:
-// follow-up work retains its original armed/pending receipting lifecycle, while
-// Visual work reserves its own namespaced statuses and immutable bindings.
-import { readFileSync } from 'node:fs';
-import { basename, join } from 'node:path';
-import { submitFollowUpResult, submitVisualResult } from '@crouton-kit/humanloop';
-import { openDb } from './db.js';
-import { getNode } from './canvas.js';
-import { reportsDir } from './paths.js';
-function rowFrom(r) {
-    return {
-        node_id: r['node_id'],
-        dir: r['dir'],
-        root: r['root'],
-        request_id: r['request_id'],
-        work_kind: r['work_kind'],
-        status: r['status'],
-        final_report: r['final_report'] ?? null,
-        interaction_id: r['interaction_id'] ?? null,
-        generation_id: r['generation_id'] ?? null,
-        interaction_snapshot: r['interaction_snapshot'] ?? null,
-        handler_command: r['handler_command'] ?? null,
-        handler_args_json: r['handler_args_json'] ?? null,
-        claim_token: r['claim_token'] ?? null,
-        updated_at: r['updated_at'],
-    };
-}
-function nowIso() {
-    return new Date().toISOString();
-}
-/** Insert a follow-up receipt before its fork launches. `work_kind` is explicit
- * even though the migration default preserves old inserts, so new code never
- * depends on a compatibility default. */
-export function armFollowUpWork(opts) {
-    openDb()
-        .prepare("INSERT INTO consult_outbox (node_id, dir, root, request_id, work_kind, status, final_report, updated_at) VALUES (?, ?, ?, ?, 'follow_up', 'armed', NULL, ?)")
-        .run(opts.nodeId, opts.dir, opts.root, opts.requestId, nowIso());
-}
-/** Promote only follow-up work inside the canonical-final transaction. */
-export function promoteFollowUpWork(nodeId, finalReportBasename) {
-    const result = openDb()
-        .prepare("UPDATE consult_outbox SET status = 'pending', final_report = ?, updated_at = ? WHERE node_id = ? AND work_kind = 'follow_up' AND status = 'armed'")
-        .run(finalReportBasename, nowIso(), nodeId);
-    return result.changes > 0;
-}
-export function ackFollowUpWork(nodeId) {
-    openDb().prepare("UPDATE consult_outbox SET status = 'acked', updated_at = ? WHERE node_id = ? AND work_kind = 'follow_up'").run(nowIso(), nodeId);
-}
-export function errorFollowUpWork(nodeId) {
-    openDb().prepare("UPDATE consult_outbox SET status = 'errored', updated_at = ? WHERE node_id = ? AND work_kind = 'follow_up'").run(nowIso(), nodeId);
-}
-export function cancelFollowUpWork(nodeId) {
-    openDb().prepare("UPDATE consult_outbox SET status = 'canceled', updated_at = ? WHERE node_id = ? AND work_kind = 'follow_up'").run(nowIso(), nodeId);
-}
-/** Create or return the one immutable Visual claim for a request. A conflicting
- * duplicate fails closed; a byte-identical duplicate reuses its original row. */
-export function claimVisualWork(binding) {
-    const db = openDb();
-    const handlerArgsJson = JSON.stringify(binding.handlerArgs);
-    db.exec('BEGIN IMMEDIATE');
-    try {
-        const existing = db
-            .prepare("SELECT * FROM consult_outbox WHERE dir = ? AND request_id = ? AND work_kind = 'visual'")
-            .get(binding.dir, binding.requestId);
-        if (existing !== undefined) {
-            const row = rowFrom(existing);
-            const exact = row.root === binding.root
-                && row.interaction_id === binding.interactionId
-                && row.generation_id === binding.generationId
-                && row.interaction_snapshot === binding.interactionSnapshot
-                && row.handler_command === binding.handlerCommand
-                && row.handler_args_json === handlerArgsJson
-                && row.claim_token === binding.claimToken;
-            if (!exact)
-                throw new Error(`conflicting Visual work claim for ${binding.dir}/${binding.requestId}`);
-            db.exec('COMMIT');
-            return { row, created: false };
-        }
-        db.prepare("INSERT INTO consult_outbox (node_id, dir, root, request_id, work_kind, status, final_report, interaction_id, generation_id, interaction_snapshot, handler_command, handler_args_json, claim_token, updated_at) VALUES (?, ?, ?, ?, 'visual', 'visual_armed', NULL, ?, ?, ?, ?, ?, ?, ?)").run(binding.nodeId, binding.dir, binding.root, binding.requestId, binding.interactionId, binding.generationId, binding.interactionSnapshot, binding.handlerCommand, handlerArgsJson, binding.claimToken, nowIso());
-        const row = getHumanWorkRow(binding.nodeId);
-        if (row === null)
-            throw new Error(`Visual work claim disappeared for ${binding.nodeId}`);
-        db.exec('COMMIT');
-        return { row, created: true };
-    }
-    catch (error) {
-        db.exec('ROLLBACK');
-        throw error;
-    }
-}
-/** The future Visual finalizer may promote only its exact armed claim. */
-export function promoteVisualWork(nodeId, finalReportBasename) {
-    const result = openDb()
-        .prepare("UPDATE consult_outbox SET status = 'visual_pending', final_report = ?, updated_at = ? WHERE node_id = ? AND work_kind = 'visual' AND status = 'visual_armed'")
-        .run(finalReportBasename, nowIso(), nodeId);
-    return result.changes > 0;
-}
-/** Retire only an exact Visual request binding; cancellation never creates work. */
-export function retireVisualWork(dir, requestId) {
-    const result = openDb()
-        .prepare("UPDATE consult_outbox SET status = 'visual_retired', updated_at = ? WHERE dir = ? AND request_id = ? AND work_kind = 'visual' AND status IN ('visual_armed', 'visual_pending')")
-        .run(nowIso(), dir, requestId);
-    return result.changes > 0;
-}
-export function getHumanWorkRow(nodeId) {
-    const r = openDb().prepare('SELECT * FROM consult_outbox WHERE node_id = ?').get(nodeId);
-    return r ? rowFrom(r) : null;
-}
-export function getFollowUpWorkRow(nodeId) {
-    const r = openDb()
-        .prepare("SELECT * FROM consult_outbox WHERE node_id = ? AND work_kind = 'follow_up'")
-        .get(nodeId);
-    return r ? rowFrom(r) : null;
-}
-export function listActiveVisualWorkByDir(dir) {
-    return openDb().prepare("SELECT * FROM consult_outbox WHERE dir = ? AND work_kind = 'visual' AND status IN ('visual_armed', 'visual_pending')").all(dir).map(rowFrom);
-}
-export function getVisualWorkByRequest(dir, requestId) {
-    const r = openDb()
-        .prepare("SELECT * FROM consult_outbox WHERE dir = ? AND request_id = ? AND work_kind = 'visual'")
-        .get(dir, requestId);
-    return r ? rowFrom(r) : null;
-}
-export function listPendingFollowUpWork() {
-    return openDb().prepare("SELECT * FROM consult_outbox WHERE work_kind = 'follow_up' AND status = 'pending'").all().map(rowFrom);
-}
-export function listArmedFollowUpWork() {
-    return openDb().prepare("SELECT * FROM consult_outbox WHERE work_kind = 'follow_up' AND status = 'armed'").all().map(rowFrom);
-}
-export function getActiveFollowUpWorkByRequest(dir, requestId) {
-    const r = openDb()
-        .prepare("SELECT * FROM consult_outbox WHERE dir = ? AND request_id = ? AND work_kind = 'follow_up' AND status IN ('armed', 'pending') LIMIT 1")
-        .get(dir, requestId);
-    return r ? rowFrom(r) : null;
-}
-export function listActiveFollowUpWorkByDir(dir) {
-    return openDb().prepare("SELECT * FROM consult_outbox WHERE dir = ? AND work_kind = 'follow_up' AND status IN ('armed', 'pending')").all(dir).map(rowFrom);
-}
-function stripReportFrontmatter(raw) {
-    const match = /^---\nnode: [^\n]*\nkind: [^\n]*\nts: [^\n]*\n---\n/.exec(raw);
-    return match ? raw.slice(match[0].length) : raw;
-}
-/** Deliver one pending follow-up receipt. */
-export function dispatchFollowUpWork(nodeId) {
-    const row = getHumanWorkRow(nodeId);
-    if (row === null || row.work_kind !== 'follow_up' || row.status !== 'pending')
-        return;
-    let markdown = null;
-    let readError = null;
-    if (row.final_report === null) {
-        readError = 'consultation produced no final report';
-    }
-    else {
-        try {
-            markdown = stripReportFrontmatter(readFileSync(join(reportsDir(nodeId), row.final_report), 'utf8'));
-        }
-        catch (err) {
-            readError = err.message;
-        }
-    }
-    try {
-        if (markdown !== null)
-            submitFollowUpResult(row.root, row.dir, { requestId: row.request_id, status: 'ready', markdown });
-        else
-            submitFollowUpResult(row.root, row.dir, { requestId: row.request_id, status: 'error', error: readError ?? 'consultation failed' });
-    }
-    catch {
-        return;
-    }
-    ackFollowUpWork(nodeId);
-}
-function visualSubmission(row, outcome) {
-    if (row.interaction_id === null || row.generation_id === null || row.interaction_snapshot === null || row.claim_token === null)
-        throw new Error('Visual work row lacks immutable correlation');
-    const interaction = JSON.parse(row.interaction_snapshot);
-    submitVisualResult(row.root, row.dir, {
-        requestId: row.request_id,
-        generationId: row.generation_id,
-        interactionId: row.interaction_id,
-        interaction,
-        claimToken: row.claim_token,
-        ...outcome,
-    });
-}
-/** Dispatch a checked canonical final as the single correlated Visual result. */
-export function dispatchVisualWork(nodeId) {
-    const row = getHumanWorkRow(nodeId);
-    if (row === null || row.work_kind !== 'visual' || row.status !== 'visual_pending')
-        return;
-    try {
-        const node = getNode(nodeId);
-        if (node === null || node.final_report === null || row.final_report === null || node.final_report !== row.final_report || basename(row.final_report) !== row.final_report)
-            throw new Error('Visual work produced no canonical final report');
-        const raw = readFileSync(join(reportsDir(nodeId), row.final_report), 'utf8');
-        const match = new RegExp(`^---\\nnode: ${nodeId}\\nkind: final\\nts: ([^\\n]+)\\n---\\n([\\s\\S]*)$`).exec(raw);
-        if (match === null || Number.isNaN(Date.parse(match[1])) || match[2].trim() === '')
-            throw new Error('Visual work produced an invalid final report');
-        visualSubmission(row, { status: 'ready', markdown: match[2] });
-    }
-    catch (error) {
-        try {
-            visualSubmission(row, { status: 'error', error: `Visual generation failed: ${String(error)}`.slice(0, 8_192) });
-        }
-        catch {
-            return;
-        }
-    }
-    retireVisualWork(row.dir, row.request_id);
-}
-/** Reconcile this durable lane after a dead private child or interrupted dispatch. */
-export function reconcileVisualWork() {
-    const rows = openDb().prepare("SELECT * FROM consult_outbox WHERE work_kind = 'visual' AND status IN ('visual_armed', 'visual_pending')").all();
-    for (const row of rows.map(rowFrom)) {
-        try {
-            if (row.status === 'visual_pending') {
-                dispatchVisualWork(row.node_id);
-                continue;
-            }
-            const node = getNode(row.node_id);
-            // A fork_pending child is intentionally persisted as canceled until the
-            // start handler rechecks its request and reviveNode consumes this armed
-            // claim. Visual cancellation retires the claim before canceling its node,
-            // so an armed fork in this state remains launchable.
-            if (node?.status === 'canceled' && node.private_fork_phase === 'fork_pending')
-                continue;
-            if (node === null || node.status === 'dead' || node.status === 'canceled') {
-                visualSubmission(row, { status: 'error', error: 'Visual generation could not complete' });
-                retireVisualWork(row.dir, row.request_id);
-            }
-        }
-        catch { /* retain the immutable claim for a later reconciliation */ }
-    }
-}
-/** Reconcile only follow-up work. */
-export function reconcileFollowUpWork() {
-    for (const row of listPendingFollowUpWork()) {
-        try {
-            dispatchFollowUpWork(row.node_id);
-        }
-        catch {
-            /* best-effort — never let one receipt block the rest */
-        }
-    }
-    for (const row of listArmedFollowUpWork()) {
-        try {
-            const node = getNode(row.node_id);
-            const deadOrMissing = node === null || node.status === 'dead' || node.status === 'canceled';
-            const hasFinal = node !== null && node.final_report !== null && node.final_report !== undefined;
-            if (deadOrMissing && !hasFinal) {
-                submitFollowUpResult(row.root, row.dir, { requestId: row.request_id, status: 'error', error: 'consultation could not complete' });
-                errorFollowUpWork(row.node_id);
-            }
-        }
-        catch {
-            /* leave the armed receipt retryable */
-        }
-    }
-}

package/dist/core/command-plugins/store.d.ts

@@ -1,16 +0,0 @@
-import type { HttpPluginRegistration } from './endpoint.js';
-/** A root-confined HTTP manifest location, created only by
- * `resolveHttpPluginManifestStore`. Store operations accept this resolved
- * location rather than a manifest declaration. */
-export declare class HttpPluginManifestStore {
-    #private;
-    private constructor();
-    get path(): string;
-    static resolve(plugin: Pick<HttpPluginRegistration, 'root' | 'commands'>): HttpPluginManifestStore | null;
-}
-/** Resolve an HTTP manifest declaration to a path confined to the plugin root.
- * Existing target and ancestor symlinks are resolved before use; an absent target
- * is allowed only beneath an existing real ancestor inside that root. */
-export declare function resolveHttpPluginManifestStore(plugin: Pick<HttpPluginRegistration, 'root' | 'commands'>): HttpPluginManifestStore | null;
-export declare function readHttpPluginManifest(store: HttpPluginManifestStore): Uint8Array | null;
-export declare function writeHttpPluginManifest(store: HttpPluginManifestStore, rawManifest: Uint8Array): void;

package/dist/core/command-plugins/store.js

@@ -1,64 +0,0 @@
-import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
-import { dirname, resolve, sep } from 'node:path';
-import { atomicWriteText, pathExists } from '../fs-utils.js';
-/** A root-confined HTTP manifest location, created only by
- * `resolveHttpPluginManifestStore`. Store operations accept this resolved
- * location rather than a manifest declaration. */
-export class HttpPluginManifestStore {
-    #path;
-    constructor(path) {
-        this.#path = path;
-    }
-    get path() {
-        return this.#path;
-    }
-    static resolve(plugin) {
-        if (typeof plugin.commands !== 'string' || plugin.commands.length === 0)
-            return null;
-        try {
-            const root = realpathSync(plugin.root);
-            const path = resolve(root, plugin.commands);
-            if (!isInside(root, path))
-                return null;
-            if (existsSync(path)) {
-                const real = realpathSync(path);
-                if (!isInside(root, real) || !statSync(real).isFile())
-                    return null;
-            }
-            else {
-                let ancestor = dirname(path);
-                while (!existsSync(ancestor) && ancestor !== dirname(ancestor))
-                    ancestor = dirname(ancestor);
-                const realAncestor = realpathSync(ancestor);
-                if (!isInside(root, realAncestor) && realAncestor !== root)
-                    return null;
-            }
-            return new HttpPluginManifestStore(path);
-        }
-        catch {
-            return null;
-        }
-    }
-}
-function isInside(root, path) {
-    return path !== root && path.startsWith(root + sep);
-}
-/** Resolve an HTTP manifest declaration to a path confined to the plugin root.
- * Existing target and ancestor symlinks are resolved before use; an absent target
- * is allowed only beneath an existing real ancestor inside that root. */
-export function resolveHttpPluginManifestStore(plugin) {
-    return HttpPluginManifestStore.resolve(plugin);
-}
-export function readHttpPluginManifest(store) {
-    if (!pathExists(store.path))
-        return null;
-    try {
-        return readFileSync(store.path);
-    }
-    catch {
-        return null;
-    }
-}
-export function writeHttpPluginManifest(store, rawManifest) {
-    atomicWriteText(store.path, rawManifest);
-}

package/dist/core/keybindings/__tests__/bespoke-consumers.test.js

@@ -1,40 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-import { resolveViewPickAction } from '../../../commands/view-pick.js';
-import { resolveBrowseNavAction, resolveBrowseSearchAction } from '../../canvas/browse/app.js';
-import { resolveProfileMenuAction, resolveProfileSearchAction } from '../../profiles/select.js';
-import { resolveKeybindings } from '../index.js';
-test('bespoke consumers resolve defaults and replacements without retaining old gestures', () => {
-    const defaults = resolveKeybindings();
-    assert.equal(resolveViewPickAction(defaults, { input: 'j' }), 'crtr.view-picker.down');
-    assert.equal(resolveBrowseNavAction(defaults, { input: 'G' }), 'crtr.browse.last');
-    // Unit 1's terminal-space canonicalization lets a literal space key resolve the
-    // catalog `space` gesture — the browse fold toggle now flows through the catalog.
-    assert.equal(resolveBrowseNavAction(defaults, { input: ' ' }), 'crtr.browse.toggle-fold');
-    assert.equal(resolveBrowseSearchAction(defaults, { return: true }), 'crtr.browse.search.commit');
-    assert.equal(resolveProfileMenuAction(defaults, { input: '3' }), 'crtr.profile.menu.slot.3');
-    assert.equal(resolveProfileSearchAction(defaults, { input: 'p', ctrl: true }), 'crtr.profile.search.up');
-    const remapped = resolveKeybindings({
-        'crtr.view-picker.down': ['z'],
-        'crtr.browse.last': ['z'],
-        'crtr.browse.search.commit': ['z'],
-        'crtr.profile.menu.slot.3': ['z'],
-        'crtr.profile.search.up': ['z'],
-    });
-    assert.equal(remapped.diagnostics.length, 0);
-    assert.equal(resolveViewPickAction(remapped, { input: 'j' }), null);
-    assert.equal(resolveViewPickAction(remapped, { input: 'z' }), 'crtr.view-picker.down');
-    assert.equal(resolveBrowseNavAction(remapped, { input: 'G' }), null);
-    assert.equal(resolveBrowseNavAction(remapped, { input: 'z' }), 'crtr.browse.last');
-    assert.equal(resolveBrowseSearchAction(remapped, { return: true }), null);
-    assert.equal(resolveBrowseSearchAction(remapped, { input: 'z' }), 'crtr.browse.search.commit');
-    assert.equal(resolveProfileMenuAction(remapped, { input: '3' }), null);
-    assert.equal(resolveProfileMenuAction(remapped, { input: 'z' }), 'crtr.profile.menu.slot.3');
-    assert.equal(resolveProfileSearchAction(remapped, { input: 'p', ctrl: true }), null);
-    assert.equal(resolveProfileSearchAction(remapped, { input: 'z' }), 'crtr.profile.search.up');
-});
-test('profile search leaves printable filter payloads outside catalog actions', () => {
-    const bindings = resolveKeybindings();
-    assert.equal(resolveProfileSearchAction(bindings, { input: 'w' }), null);
-    assert.equal(resolveProfileSearchAction(bindings, { input: '文' }), null);
-});

package/dist/core/runtime/fault-recovery-nudge.d.ts

@@ -1,3 +0,0 @@
-export declare const AUTH_FAULT_RECOVERY_BODY = "Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.";
-export declare const CONNECTION_FAULT_RECOVERY_BODY = "The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.";
-export declare const PROVIDER_FAULT_RECOVERY_BODY = "Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.";

package/dist/core/runtime/fault-recovery-nudge.js

@@ -1,3 +0,0 @@
-export const AUTH_FAULT_RECOVERY_BODY = 'Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.';
-export const CONNECTION_FAULT_RECOVERY_BODY = 'The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.';
-export const PROVIDER_FAULT_RECOVERY_BODY = 'Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.';

package/dist/core/tui/__tests__/host-keybindings.test.js

@@ -1,113 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-import { resolveKeybindings } from '../../keybindings/index.js';
-import { matchViewBinding, matchesViewHostBinding, parseViewKeypress, resolveViewKeyHints } from '../host.js';
-function key(input = '', patch = {}) {
-    return {
-        upArrow: false,
-        downArrow: false,
-        leftArrow: false,
-        rightArrow: false,
-        return: false,
-        escape: false,
-        ctrl: false,
-        meta: false,
-        tab: false,
-        shiftTab: false,
-        backspace: false,
-        ...patch,
-    };
-}
-test('catalog view bindings use defaults, remaps, and effective hint labels', () => {
-    const keymap = [
-        { bindingId: 'crtr.view.canvas.down', intent: 'down', hint: { label: 'move' } },
-    ];
-    const defaults = resolveKeybindings();
-    assert.deepEqual(matchViewBinding(keymap, defaults, 'j', key('j'), { row: 0 }), { intent: 'down', payload: undefined });
-    // Bare printable keys render as typed — `j`, not a `J` nobody can press.
-    assert.deepEqual(resolveViewKeyHints(keymap, defaults, { row: 0 }), [{ keys: 'j / Down', label: 'move' }]);
-    const remapped = resolveKeybindings({ 'crtr.view.canvas.down': ['x'] });
-    assert.equal(matchViewBinding(keymap, remapped, 'j', key('j'), { row: 0 }), null);
-    assert.deepEqual(matchViewBinding(keymap, remapped, 'x', key('x'), { row: 0 }), { intent: 'down', payload: undefined });
-    assert.deepEqual(resolveViewKeyHints(keymap, remapped, { row: 0 }), [{ keys: 'x', label: 'move' }]);
-});
-test('custom view literals retain their matching and presenter-authored hints', () => {
-    const keymap = [
-        { keys: ['z'], intent: 'custom', hint: { keys: 'z', label: 'custom' } },
-    ];
-    const bindings = resolveKeybindings();
-    assert.deepEqual(matchViewBinding(keymap, bindings, 'z', key('z'), undefined), { intent: 'custom', payload: undefined });
-    assert.equal(matchViewBinding(keymap, bindings, 'x', key('x'), undefined), null);
-    assert.deepEqual(resolveViewKeyHints(keymap, bindings, undefined), [{ keys: 'z', label: 'custom' }]);
-});
-test('Alt+<letter> does not falsely match a bare custom literal', () => {
-    const keymap = [{ keys: ['q'], intent: 'quit' }];
-    const bindings = resolveKeybindings();
-    const altQ = parseViewKeypress(Buffer.from('\x1bq'));
-    assert.equal(matchViewBinding(keymap, bindings, altQ.input, altQ.key, undefined, altQ.raw), null);
-    const q = parseViewKeypress(Buffer.from('q'));
-    assert.deepEqual(matchViewBinding(keymap, bindings, q.input, q.key, undefined, q.raw), { intent: 'quit', payload: undefined });
-});
-test('host force quit and capture deletion follow catalog IDs through raw terminal decoding', () => {
-    const defaults = resolveKeybindings();
-    const ctrlC = parseViewKeypress(Buffer.from('\x03'));
-    const del = parseViewKeypress(Buffer.from('\x7f'), defaults);
-    const bs = parseViewKeypress(Buffer.from('\b'), defaults);
-    assert.ok(matchesViewHostBinding(defaults, 'crtr.view.host.force-quit', ctrlC.raw));
-    assert.ok(matchesViewHostBinding(defaults, 'crtr.view.host.editor.backspace', del.raw));
-    // 0x08 stays Backspace under default config so ^H-erase terminals still delete.
-    assert.ok(matchesViewHostBinding(defaults, 'crtr.view.host.editor.backspace', bs.raw));
-    const remapped = resolveKeybindings({
-        'crtr.view.host.force-quit': ['alt+x'],
-        'crtr.view.host.editor.backspace': ['ctrl+h'],
-    });
-    const altX = parseViewKeypress(Buffer.from('\x1bx'), remapped);
-    const ctrlH = parseViewKeypress(Buffer.from('\b'), remapped);
-    const delRemap = parseViewKeypress(Buffer.from('\x7f'), remapped);
-    assert.equal(matchesViewHostBinding(remapped, 'crtr.view.host.force-quit', ctrlC.raw), false);
-    assert.ok(matchesViewHostBinding(remapped, 'crtr.view.host.force-quit', altX.raw));
-    // With deletion remapped to Ctrl-H, the 0x08 byte deletes and DEL no longer does.
-    assert.equal(matchesViewHostBinding(remapped, 'crtr.view.host.editor.backspace', delRemap.raw), false);
-    assert.ok(matchesViewHostBinding(remapped, 'crtr.view.host.editor.backspace', ctrlH.raw));
-});
-test('Alt+Backspace deletes like Backspace under default config', () => {
-    const defaults = resolveKeybindings();
-    const altDel = parseViewKeypress(Buffer.from('\x1b\x7f'), defaults);
-    const altBs = parseViewKeypress(Buffer.from('\x1b\b'), defaults);
-    assert.ok(matchesViewHostBinding(defaults, 'crtr.view.host.editor.backspace', altDel.raw));
-    assert.ok(matchesViewHostBinding(defaults, 'crtr.view.host.editor.backspace', altBs.raw));
-});
-test('raw terminal decoding covers modified arrows and enter/return equivalence', () => {
-    const keymap = [{ bindingId: 'crtr.view.chat.submit', intent: 'submit' }];
-    const bindings = resolveKeybindings();
-    const cr = parseViewKeypress(Buffer.from('\r'));
-    const lf = parseViewKeypress(Buffer.from('\n'));
-    assert.deepEqual(matchViewBinding(keymap, bindings, cr.input, cr.key, undefined, cr.raw), { intent: 'submit', payload: undefined });
-    assert.deepEqual(matchViewBinding(keymap, bindings, lf.input, lf.key, undefined, lf.raw), { intent: 'submit', payload: undefined });
-    const ctrlUp = parseViewKeypress(Buffer.from('\x1b[1;5A'));
-    assert.equal(ctrlUp.raw.upArrow, true);
-    assert.equal(ctrlUp.raw.ctrl, true);
-    const up = parseViewKeypress(Buffer.from('\x1b[A'));
-    assert.equal(up.raw.upArrow, true);
-    assert.equal(up.raw.ctrl, false);
-});
-test('a disabled binding neither matches nor renders a hint', () => {
-    const keymap = [
-        { bindingId: 'crtr.view.canvas.refresh', intent: 'refresh', hint: { label: 'refresh' } },
-    ];
-    const bindings = resolveKeybindings({ 'crtr.view.canvas.refresh': [] });
-    const g = parseViewKeypress(Buffer.from('g'));
-    assert.equal(matchViewBinding(keymap, bindings, g.input, g.key, undefined, g.raw), null);
-    assert.deepEqual(resolveViewKeyHints(keymap, bindings, undefined), []);
-});
-test('capture hints are host-owned, mode-gated, and keep custom KeyHint keys verbatim', () => {
-    const gated = [
-        { capture: 'setDraft', when: (state) => state.compose, hint: { label: 'compose' } },
-    ];
-    assert.deepEqual(resolveViewKeyHints(gated, resolveKeybindings(), { compose: true }), [{ keys: 'type', label: 'compose' }]);
-    assert.deepEqual(resolveViewKeyHints(gated, resolveKeybindings(), { compose: false }), []);
-    const custom = [
-        { capture: 'setDraft', when: () => true, hint: { keys: 'edit', label: 'compose' } },
-    ];
-    assert.deepEqual(resolveViewKeyHints(custom, resolveKeybindings(), undefined), [{ keys: 'edit', label: 'compose' }]);
-});

package/dist/core/tui/host.d.ts

@@ -1,66 +0,0 @@
-import { type Key } from './terminal.js';
-import { type Draw, type Rect, type Size } from './draw.js';
-import type { ViewCore, TuiPresenter, TextPresenter, KeyBinding, KeyHint, BannerLevel } from '../view/contract.js';
-import { type BindingId, type BindingResolution, type RawTerminalInput } from '../keybindings/index.js';
-export interface RunViewOptions {
-    /** CLI flags forwarded verbatim to the view via host.options. */
-    options?: Record<string, string>;
-}
-/** The host-tracked chrome state. `banner` + `busy` + `loaded` derive the title
- *  state chip; `tick` advances the spinner under the busy-tick repaint. */
-export interface Chrome {
-    status: string | null;
-    banner: {
-        msg: string;
-        level: BannerLevel;
-    } | null;
-    busy: boolean;
-    loaded: boolean;
-    lastRefresh: number;
-    tick: number;
-    subtitle: string | null;
-    mode: string | null;
-}
-/** The slice of a view's manifest that drawChrome reads (title + subtitle), plus
- *  the footer hints lifted from the TuiPresenter's keymap bindings. */
-export interface ChromeManifest {
-    title: string;
-    subtitle?: string;
-    keymap?: KeyHint[];
-}
-/** Draw the host chrome into `draw` and return the content Rect for the view.
- *  Three zones: title row (state rail + title/subtitle + state chip + liveness),
- *  a hairline, and a footer (status left, keymap right) with a severity banner
- *  on the row above it when set. */
-declare function drawChrome(draw: Draw, size: Size, manifest: ChromeManifest, c: Chrome, now?: number): Rect;
-export { drawChrome };
-/** Tokens a keystroke can match a keymap binding's `keys` against. Arrows →
- *  up/down/left/right, return → return|enter, escape → escape|esc, a printable
- *  char → the char itself (+ 'space' for ' '), ctrl+x → ctrl+x|c-x. */
-export interface ViewKeypress {
-    readonly input: string;
-    readonly key: Key;
-    readonly raw: RawTerminalInput;
-}
-/** Extend the shared legacy parser with the terminal gestures the catalog can
- * express. The raw shape goes only to the catalog matcher; custom literals keep
- * their established Key-based matching. When `bindings` is supplied the ambiguous
- * 0x08 byte resolves to Ctrl-H only if an effective binding claims it. */
-export declare function parseViewKeypress(data: Buffer, bindings?: BindingResolution<BindingId>): ViewKeypress;
-/** Resolve footer hints for the CURRENT state: only bindings whose `when(state)`
- * passes contribute, so mode-gated affordances (compose/react send/cancel/pick)
- * appear exactly while active. Catalog bindings render the effective key label
- * (omitted entirely when disabled); custom-view literal hints stay verbatim. */
-export declare function resolveViewKeyHints<S>(keymap: KeyBinding<S>[], bindings: BindingResolution<BindingId>, state: S): KeyHint[];
-/** The first non-capture binding whose key matches and whose `when` (if any)
- * passes — catalog IDs use the terminal matcher; custom literals retain their
- * presenter-authored matching. */
-export declare function matchViewBinding<S>(keymap: KeyBinding<S>[], bindings: BindingResolution<BindingId>, input: string, key: Key, state: S, raw?: RawTerminalInput): {
-    intent: string;
-    payload: unknown;
-} | null;
-/** Match a host-owned generic-view action through the same catalog snapshot. */
-export declare function matchesViewHostBinding(bindings: BindingResolution<BindingId>, id: 'crtr.view.host.force-quit' | 'crtr.view.host.editor.backspace', raw: RawTerminalInput): boolean;
-/** Host a dual-target ViewCore + TuiPresenter in the alt screen until it quits
- *  (or Ctrl-C). `text` is the optional text presenter for the piped path. */
-export declare function runCoreView<S>(core: ViewCore<S>, tui: TuiPresenter<S>, text: TextPresenter<S> | null, opts?: RunViewOptions): Promise<void>;

package/dist/core/view/__tests__/transport-cache.test.js

@@ -1,62 +0,0 @@
-import assert from 'node:assert/strict';
-import { test } from 'node:test';
-import { createBurstCoalescingTransport } from '../transport-cache.js';
-function makeInner() {
-    const calls = [];
-    const releases = [];
-    return {
-        calls,
-        send(req) {
-            calls.push(req);
-            return new Promise((resolve) => {
-                releases.push(resolve);
-            });
-        },
-        release(response) {
-            const resolve = releases.shift();
-            if (resolve === undefined)
-                throw new Error('release called with no pending send');
-            resolve(response);
-        },
-        open() {
-            throw new Error('not used');
-        },
-    };
-}
-test('burst coalescing shares identical in-flight requests and serves the short TTL cache', async () => {
-    let now = 1_000;
-    const inner = makeInner();
-    const req = { kind: 'exec', bin: 'crtr', args: ['canvas', 'snapshot', '--json'] };
-    const transport = createBurstCoalescingTransport(inner, {
-        ttlMs: 350,
-        now: () => now,
-        shouldCache: (candidate) => candidate.kind === 'exec',
-    });
-    const first = transport.send(req);
-    const second = transport.send(req);
-    assert.equal(inner.calls.length, 1);
-    inner.release({ ok: true, exitCode: 0, stdout: '{"nodes":[]}', stderr: '' });
-    assert.deepEqual(await first, { ok: true, exitCode: 0, stdout: '{"nodes":[]}', stderr: '' });
-    assert.deepEqual(await second, { ok: true, exitCode: 0, stdout: '{"nodes":[]}', stderr: '' });
-    assert.deepEqual(await transport.send(req), { ok: true, exitCode: 0, stdout: '{"nodes":[]}', stderr: '' });
-    assert.equal(inner.calls.length, 1);
-    now += 351;
-    const afterTtl = transport.send(req);
-    assert.equal(inner.calls.length, 2);
-    inner.release({ ok: true, exitCode: 0, stdout: '{"nodes":[1]}', stderr: '' });
-    assert.deepEqual(await afterTtl, { ok: true, exitCode: 0, stdout: '{"nodes":[1]}', stderr: '' });
-});
-test('burst coalescing leaves non-cacheable requests untouched', async () => {
-    const inner = makeInner();
-    const req = { kind: 'exec', bin: 'crtr', args: ['node', 'new', '--json'], stdin: 'hi' };
-    const transport = createBurstCoalescingTransport(inner, {
-        ttlMs: 350,
-        shouldCache: () => false,
-    });
-    const first = transport.send(req);
-    const second = transport.send(req);
-    assert.equal(inner.calls.length, 2);
-    inner.release({ ok: true, exitCode: 0, stdout: '{}', stderr: '' });
-    inner.release({ ok: true, exitCode: 0, stdout: '{}', stderr: '' });
-    await Promise.all([first, second]);
-});

package/dist/core/view/bridge.d.ts

@@ -1,10 +0,0 @@
-import type { Transport } from './transport.js';
-export interface BridgeResult {
-    status: number;
-    body: string;
-}
-/** Decode a POST body as a SourceRequest and run it through `transport`,
- *  returning the HTTP status + JSON-encoded RawResponse the bridge should send
- *  back. Never throws — a malformed body or a transport failure both come back
- *  as a RawResponse with ok:false. */
-export declare function runSourceRequest(transport: Transport, rawBody: string): Promise<BridgeResult>;