@marifold/tui 0.60.0

package/dist/core/appState.d.ts

@@ -0,0 +1,158 @@
+import type { AgentEvent, AgentToolKind, ApprovalRequest, UserInputRequest } from '@marifold/core';
+export type Mode = 'agent' | 'chat';
+export type NoticeTone = 'info' | 'warn' | 'error';
+/** A renderable transcript entry without its assigned id. */
+export type TranscriptItemData = {
+    kind: 'user';
+    text: string;
+} | {
+    kind: 'assistant';
+    text: string;
+    muted?: boolean;
+} | {
+    kind: 'notice';
+    tone: NoticeTone;
+    text: string;
+} | {
+    kind: 'plan';
+    steps: Array<{
+        id: string;
+        text: string;
+        status: string;
+    }>;
+} | {
+    kind: 'tool';
+    tool: string;
+    toolKind?: AgentToolKind;
+    summary: string;
+    phase: 'request' | 'result';
+    isError?: boolean;
+    callId?: string;
+} | {
+    kind: 'verification';
+    passed: boolean;
+    notes: string;
+} | {
+    kind: 'info';
+    title: string;
+    lines: string[];
+};
+export type TranscriptItem = TranscriptItemData & {
+    id: string;
+};
+export interface AppState {
+    profile: string;
+    displayName: string;
+    provider: string;
+    model: string;
+    mode: Mode;
+    cwd: string;
+    /** This build's version, shown in the header banner. */
+    version: string;
+    /** A known newer version; drives the header's update notice when set. */
+    latestVersion?: string;
+    sessionId?: string;
+    /** Conversation-context budget in tokens for the active profile (undefined = compaction off). */
+    maxContextTokens?: number;
+    /** Input tokens the last turn sent — drives the context gauge. */
+    contextTokens?: number;
+    transcript: TranscriptItem[];
+    running: boolean;
+    /** Pending approval request; non-undefined drives the approval modal. */
+    approval?: ApprovalRequest;
+    /** Pending clarification questions; non-undefined drives QuestionModal. */
+    userInput?: UserInputRequest;
+    /** Short status-line activity label, e.g. "thinking" or "shell". */
+    activity?: string;
+    /** True while an assistant item is open and accepting streamed deltas. */
+    streamingAssistant: boolean;
+    exiting: boolean;
+    seq: number;
+}
+export interface InitialAppState {
+    profile: string;
+    displayName?: string;
+    provider: string;
+    model: string;
+    cwd: string;
+    version: string;
+    latestVersion?: string;
+    mode?: Mode;
+    sessionId?: string;
+    /** Conversation-context budget in tokens for the launch profile (undefined = off). */
+    maxContextTokens?: number;
+    /** Pre-existing transcript to seed (e.g. a resumed session's turns). */
+    transcript?: TranscriptItemData[];
+}
+export declare function createInitialState(init: InitialAppState): AppState;
+export type AppAction = {
+    type: 'set_mode';
+    mode: Mode;
+} | {
+    type: 'set_model';
+    provider: string;
+    model: string;
+} | {
+    type: 'set_profile';
+    profile: string;
+    displayName?: string;
+    provider: string;
+    model: string;
+    maxContextTokens?: number;
+} | {
+    type: 'add_user';
+    text: string;
+} | {
+    type: 'add_item';
+    item: TranscriptItemData;
+} | {
+    type: 'reasoning_delta';
+    text: string;
+} | {
+    type: 'assistant_delta';
+    text: string;
+} | {
+    type: 'end_assistant';
+} | {
+    type: 'set_running';
+    running: boolean;
+} | {
+    type: 'set_activity';
+    activity?: string;
+} | {
+    type: 'set_approval';
+    request?: ApprovalRequest;
+} | {
+    type: 'set_user_input';
+    request?: UserInputRequest;
+} | {
+    type: 'agent_event';
+    event: AgentEvent;
+} | {
+    type: 'notice';
+    tone?: NoticeTone;
+    text: string;
+} | {
+    type: 'clear';
+} | {
+    type: 'new_session';
+    sessionId?: string;
+} | {
+    type: 'set_session';
+    sessionId?: string;
+} | {
+    type: 'set_context_usage';
+    tokens?: number;
+} | {
+    type: 'set_context_budget';
+    maxContextTokens?: number;
+} | {
+    type: 'exit';
+};
+/**
+ * Pure reducer over the whole TUI state. All transcript mutation, streaming,
+ * approval, and run lifecycle flows through here so behavior is unit-testable
+ * without rendering Ink. Components only dispatch and read.
+ */
+export declare function appReducer(state: AppState, action: AppAction): AppState;
+//# sourceMappingURL=appState.d.ts.map

package/dist/core/appState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appState.d.ts","sourceRoot":"","sources":["../../src/core/appState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGnG,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1I;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,QAAQ,CAqBlE;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1H;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAWrB;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,CA4EvE"}

package/dist/core/appState.js

@@ -0,0 +1,167 @@
+import { agentEventToItems } from './eventView.js';
+export function createInitialState(init) {
+    // Seed any provided history with the same `item_${seq}` id scheme the reducer
+    // uses, and start `seq` past it so later items continue the sequence.
+    const seeded = (init.transcript ?? []).map((item, index) => ({ ...item, id: `item_${index + 1}` }));
+    return {
+        profile: init.profile,
+        displayName: init.displayName ?? init.profile,
+        provider: init.provider,
+        model: init.model,
+        mode: init.mode ?? 'agent',
+        cwd: init.cwd,
+        version: init.version,
+        ...(init.latestVersion ? { latestVersion: init.latestVersion } : {}),
+        ...(init.sessionId ? { sessionId: init.sessionId } : {}),
+        ...(init.maxContextTokens != null ? { maxContextTokens: init.maxContextTokens } : {}),
+        transcript: seeded,
+        running: false,
+        streamingAssistant: false,
+        exiting: false,
+        seq: seeded.length,
+    };
+}
+function withItem(state, item) {
+    const seq = state.seq + 1;
+    return { ...state, seq, transcript: [...state.transcript, { ...item, id: `item_${seq}` }] };
+}
+function withItems(state, items) {
+    return items.reduce(withItem, state);
+}
+/**
+ * Pure reducer over the whole TUI state. All transcript mutation, streaming,
+ * approval, and run lifecycle flows through here so behavior is unit-testable
+ * without rendering Ink. Components only dispatch and read.
+ */
+export function appReducer(state, action) {
+    switch (action.type) {
+        case 'set_mode':
+            return { ...state, mode: action.mode };
+        case 'set_model':
+            return { ...state, provider: action.provider, model: action.model };
+        case 'set_profile':
+            return {
+                ...state,
+                profile: action.profile,
+                displayName: action.displayName ?? action.profile,
+                provider: action.provider,
+                model: action.model,
+                maxContextTokens: action.maxContextTokens,
+                contextTokens: undefined,
+            };
+        case 'add_user':
+            return withItem(state, { kind: 'user', text: action.text });
+        case 'add_item':
+            return withItem(state, action.item);
+        case 'reasoning_delta': {
+            const transcript = [...state.transcript];
+            const last = transcript[transcript.length - 1];
+            if (!state.streamingAssistant && last?.kind === 'assistant' && last.muted) {
+                transcript[transcript.length - 1] = { ...last, text: last.text + action.text };
+                return { ...state, transcript };
+            }
+            return withItem(state, { kind: 'assistant', text: `Reasoning: ${action.text}`, muted: true });
+        }
+        case 'assistant_delta': {
+            // Append to the open assistant item, or open a new one.
+            if (state.streamingAssistant) {
+                const transcript = [...state.transcript];
+                const last = transcript[transcript.length - 1];
+                if (last && last.kind === 'assistant') {
+                    transcript[transcript.length - 1] = { ...last, text: last.text + action.text };
+                    return { ...state, transcript };
+                }
+            }
+            const seq = state.seq + 1;
+            return {
+                ...state,
+                seq,
+                streamingAssistant: true,
+                transcript: [...state.transcript, { id: `item_${seq}`, kind: 'assistant', text: action.text }],
+            };
+        }
+        case 'end_assistant':
+            return { ...state, streamingAssistant: false };
+        case 'set_running':
+            return { ...state, running: action.running, ...(action.running ? {} : { activity: undefined }) };
+        case 'set_activity':
+            return { ...state, activity: action.activity };
+        case 'set_approval':
+            return { ...state, approval: action.request };
+        case 'set_user_input':
+            return { ...state, userInput: action.request };
+        case 'agent_event':
+            return applyAgentEvent(state, action.event);
+        case 'notice':
+            return withItem(state, { kind: 'notice', tone: action.tone ?? 'info', text: action.text });
+        case 'clear':
+            return { ...state, transcript: [], streamingAssistant: false };
+        case 'new_session':
+            return { ...state, transcript: [], streamingAssistant: false, sessionId: action.sessionId, contextTokens: undefined };
+        case 'set_session':
+            return { ...state, sessionId: action.sessionId };
+        case 'set_context_usage':
+            return { ...state, contextTokens: action.tokens };
+        case 'set_context_budget':
+            return { ...state, maxContextTokens: action.maxContextTokens };
+        case 'exit':
+            return { ...state, exiting: true };
+        default:
+            return state;
+    }
+}
+/** Fold a single AgentEvent into state: transcript items via eventView, plus
+ * the status-line / modal transitions the transcript itself doesn't show. */
+function applyAgentEvent(state, event) {
+    // A tool result folds onto its own request row (matched by callId) so each
+    // tool call is one self-updating line — `→ read_file …` becomes `← read_file …`
+    // in place — instead of two rows with the path repeated.
+    if (event.type === 'tool_result') {
+        const transcript = [...state.transcript];
+        for (let i = transcript.length - 1; i >= 0; i -= 1) {
+            const item = transcript[i];
+            if (item.kind === 'tool' && item.callId === event.callId && item.phase === 'request') {
+                // New id so the App's append-only <Static> repaints this row in place
+                // (it only redraws on id changes), turning `→ …` into `← …` on one line.
+                transcript[i] = { ...item, id: `${item.id}~done`, phase: 'result', summary: event.summary, isError: event.isError };
+                return { ...state, streamingAssistant: false, transcript };
+            }
+        }
+        // No matching request found — fall back to appending a standalone result.
+        return withItems({ ...state, streamingAssistant: false }, agentEventToItems(event));
+    }
+    let next = withItems({ ...state, streamingAssistant: false }, agentEventToItems(event));
+    switch (event.type) {
+        case 'status':
+            next = { ...next, activity: event.status === 'running' ? 'thinking' : undefined };
+            break;
+        case 'tool_request':
+            next = { ...next, activity: event.call.tool };
+            break;
+        case 'text':
+            next = { ...next, activity: 'thinking' };
+            break;
+        case 'reasoning':
+            next = { ...next, activity: 'reasoning' };
+            break;
+        case 'approval_request':
+            next = { ...next, approval: event.request };
+            break;
+        case 'approval_decision':
+            next = { ...next, approval: undefined };
+            break;
+        case 'user_input_request':
+            next = { ...next, userInput: event.request, activity: 'waiting for your answers' };
+            break;
+        case 'user_input_response':
+            next = { ...next, userInput: undefined, activity: 'thinking' };
+            break;
+        case 'done':
+            next = { ...next, running: false, activity: undefined, approval: undefined, userInput: undefined };
+            break;
+        default:
+            break;
+    }
+    return next;
+}
+//# sourceMappingURL=appState.js.map

package/dist/core/appState.js.map

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

package/dist/core/commands.d.ts

@@ -0,0 +1,70 @@
+import type { Mode, NoticeTone } from './appState.js';
+/**
+ * Operations a `/command` can perform. The App implements this against the
+ * live runtime and dispatcher; tests pass a fake to assert dispatch. Commands
+ * are deterministic and never call the model — that is the design rule that
+ * separates `/command` (code) from `$skill` (model-backed).
+ */
+export interface CommandContext {
+    notify(text: string, tone?: NoticeTone): void;
+    setMode(mode: Mode): void;
+    /** Persist `mode` as the current profile's default (profile.toml) and apply it now. */
+    setDefaultMode(mode: Mode): void;
+    newSession(): void;
+    clear(): void;
+    stop(): void;
+    steer(text: string): void;
+    exit(): void;
+    setThink(on: boolean): void;
+    openModelPicker(): void;
+    openProfilePicker(): void;
+    selectProfile(name: string): void;
+    openSkills(scope?: 'global' | 'profile'): void;
+    showPermissions(): void;
+    showHelp(): void;
+    showStatus(): void;
+    /** Arm a one-shot forced plan for the next message (toggles off if armed). */
+    toggleForcePlan(): void;
+    copyLast(): void;
+    /** Re-run the last plain-text message through the current profile/model/mode. */
+    retryLast(): void;
+    /** Send one prompt with attached images preserved byte-for-byte. */
+    sendOriginal(text: string): void;
+    showSessions(): void;
+    runDoctor(): void;
+    installSkill(arg: string): void;
+    readFile(path: string): void;
+    setImage(arg: string): void;
+    remember(text: string): void;
+    forget(query: string): void;
+    deleteMemory(query: string): void;
+    /** Show the current context budget + usage. */
+    showContextWindow(): void;
+    /** Set the context budget for this session (tokens), or 0/undefined to disable. */
+    setContextWindow(tokens?: number): void;
+    /** Persist the context budget as the current profile's default (profile.toml). */
+    setDefaultContextWindow(tokens?: number): void;
+    /** Compact the current session now (model-backed). */
+    compactNow(): void;
+    /** Trust a folder for the active profile — file writes there won't prompt. */
+    trustFolder(path: string): void;
+}
+export interface CommandSpec {
+    name: string;
+    /** Alternate invocations (e.g. quit → exit). */
+    aliases?: string[];
+    summary: string;
+    run(ctx: CommandContext, args: string): void;
+}
+export interface CommandCompletion {
+    name: string;
+    hint: string;
+}
+export declare function listCommands(): CommandSpec[];
+/** Canonical command names plus discoverable aliases for the input menu. */
+export declare function listCommandCompletions(): CommandCompletion[];
+export declare function findCommand(name: string): CommandSpec | undefined;
+/** Run a parsed command. Returns false when the name is unknown so the caller
+ * can surface a hint. */
+export declare function runCommand(ctx: CommandContext, name: string, args: string): boolean;
+//# sourceMappingURL=commands.d.ts.map

package/dist/core/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/core/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,uFAAuF;IACvF,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,UAAU,IAAI,IAAI,CAAC;IACnB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,eAAe,IAAI,IAAI,CAAC;IACxB,iBAAiB,IAAI,IAAI,CAAC;IAC1B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/C,eAAe,IAAI,IAAI,CAAC;IACxB,QAAQ,IAAI,IAAI,CAAC;IACjB,UAAU,IAAI,IAAI,CAAC;IACnB,8EAA8E;IAC9E,eAAe,IAAI,IAAI,CAAC;IACxB,QAAQ,IAAI,IAAI,CAAC;IACjB,iFAAiF;IACjF,SAAS,IAAI,IAAI,CAAC;IAClB,oEAAoE;IACpE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,IAAI,IAAI,CAAC;IACrB,SAAS,IAAI,IAAI,CAAC;IAClB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,+CAA+C;IAC/C,iBAAiB,IAAI,IAAI,CAAC;IAC1B,mFAAmF;IACnF,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,kFAAkF;IAClF,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,sDAAsD;IACtD,UAAU,IAAI,IAAI,CAAC;IACnB,8EAA8E;IAC9E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA8KD,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAE5C;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,IAAI,iBAAiB,EAAE,CAQ5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjE;AAED;yBACyB;AACzB,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKnF"}

package/dist/core/commands.js

@@ -0,0 +1,227 @@
+const COMMANDS = [
+    { name: 'help', summary: 'List commands and input syntax.', run: ctx => ctx.showHelp() },
+    { name: 'status', summary: 'Show profile, mode, model, thinking, and session.', run: ctx => ctx.showStatus() },
+    { name: 'copy', summary: "Copy the last response's original text to the clipboard.", run: ctx => ctx.copyLast() },
+    { name: 'retry', aliases: ['regenerate'], summary: 'Re-run your last message (e.g. after /model to compare).', run: ctx => ctx.retryLast() },
+    {
+        name: 'attach-original',
+        summary: 'Send attached images unchanged for this message: /attach-original <prompt>.',
+        run: (ctx, args) => {
+            const text = args.trim();
+            if (!text)
+                ctx.notify('Usage: /attach-original <prompt>', 'warn');
+            else
+                ctx.sendOriginal(text);
+        },
+    },
+    { name: 'exit', aliases: ['quit'], summary: 'Leave the TUI.', run: ctx => ctx.exit() },
+    { name: 'new', summary: 'Start a fresh session (clear transcript).', run: ctx => ctx.newSession() },
+    {
+        name: 'agent',
+        summary: 'Agent mode: /agent (this session) or /agent default (save to profile).',
+        run: (ctx, args) => (args.trim() === 'default' ? ctx.setDefaultMode('agent') : ctx.setMode('agent')),
+    },
+    {
+        name: 'chat',
+        summary: 'Chat mode: /chat (this session) or /chat default (save to profile).',
+        run: (ctx, args) => (args.trim() === 'default' ? ctx.setDefaultMode('chat') : ctx.setMode('chat')),
+    },
+    { name: 'clear', summary: 'Clear the transcript.', run: ctx => ctx.clear() },
+    { name: 'steps', summary: 'Force a step-by-step plan on your next message (one-shot).', run: ctx => ctx.toggleForcePlan() },
+    { name: 'stop', summary: 'Cancel the running task.', run: ctx => ctx.stop() },
+    {
+        name: 'btw',
+        summary: 'Steer the running task without cancelling it: /btw <text>.',
+        run: (ctx, args) => {
+            const text = args.trim();
+            if (!text)
+                ctx.notify('Usage: /btw <text>', 'warn');
+            else
+                ctx.steer(text);
+        },
+    },
+    { name: 'model', summary: 'Pick the active model.', run: ctx => ctx.openModelPicker() },
+    {
+        name: 'profile',
+        summary: 'Switch profile: /profile [name] (omit name for a picker).',
+        run: (ctx, args) => {
+            const name = args.trim();
+            if (name)
+                ctx.selectProfile(name);
+            else
+                ctx.openProfilePicker();
+        },
+    },
+    {
+        name: 'resume',
+        aliases: ['session'],
+        summary: 'Resume a recent session from an interactive picker.',
+        run: ctx => ctx.showSessions(),
+    },
+    {
+        name: 'think',
+        summary: 'Toggle thinking: /think on|off.',
+        run: (ctx, args) => {
+            const value = args.trim().toLowerCase();
+            if (value === 'on')
+                ctx.setThink(true);
+            else if (value === 'off')
+                ctx.setThink(false);
+            else
+                ctx.notify('Usage: /think on|off', 'warn');
+        },
+    },
+    { name: 'permissions', summary: 'Show approval modes and active session grants.', run: ctx => ctx.showPermissions() },
+    {
+        name: 'trust-folder',
+        summary: 'Trust a folder for this profile: /trust-folder <path> (writes there stop asking).',
+        run: (ctx, args) => {
+            const target = args.trim();
+            if (!target)
+                ctx.notify('Usage: /trust-folder <path>', 'warn');
+            else
+                ctx.trustFolder(target);
+        },
+    },
+    {
+        name: 'skills',
+        summary: 'Manage skills: /skills (this profile) or /skills --global.',
+        run: (ctx, args) => ctx.openSkills(args.trim() === '--global' ? 'global' : 'profile'),
+    },
+    {
+        name: 'install-skill',
+        summary: 'Install a skill: /install-skill [--global] <path|url>.',
+        run: (ctx, args) => {
+            const arg = args.trim();
+            if (!arg)
+                ctx.notify('Usage: /install-skill <path>', 'warn');
+            else
+                ctx.installSkill(arg);
+        },
+    },
+    { name: 'doctor', summary: 'Check provider/model health.', run: ctx => ctx.runDoctor() },
+    {
+        name: 'read',
+        summary: 'Read a file into context: /read <path>.',
+        run: (ctx, args) => {
+            const file = args.trim();
+            if (!file)
+                ctx.notify('Usage: /read <path>', 'warn');
+            else
+                ctx.readFile(file);
+        },
+    },
+    {
+        name: 'image',
+        summary: 'Attach an image: /image <path> | /image clear.',
+        run: (ctx, args) => ctx.setImage(args.trim()),
+    },
+    {
+        name: 'remember',
+        summary: 'Save a memory: /remember <text>.',
+        run: (ctx, args) => {
+            const text = args.trim();
+            if (!text)
+                ctx.notify('Usage: /remember <text>', 'warn');
+            else
+                ctx.remember(text);
+        },
+    },
+    {
+        name: 'forget',
+        summary: 'Forget matching memories: /forget <query>.',
+        run: (ctx, args) => {
+            const query = args.trim();
+            if (!query)
+                ctx.notify('Usage: /forget <query>', 'warn');
+            else
+                ctx.forget(query);
+        },
+    },
+    {
+        name: 'delete-memory',
+        summary: 'Delete matching memories: /delete-memory <query>.',
+        run: (ctx, args) => {
+            const query = args.trim();
+            if (!query)
+                ctx.notify('Usage: /delete-memory <query>', 'warn');
+            else
+                ctx.deleteMemory(query);
+        },
+    },
+    {
+        name: 'context-window',
+        aliases: ['ctx'],
+        summary: 'Context budget: /context-window, set <tokens|off> [default].',
+        run: (ctx, args) => {
+            const parts = args.trim().split(/\s+/).filter(Boolean);
+            if (parts.length === 0) {
+                ctx.showContextWindow();
+                return;
+            }
+            if (parts[0].toLowerCase() !== 'set') {
+                ctx.notify('Usage: /context-window [set <tokens|off> [default]]', 'warn');
+                return;
+            }
+            const toDefault = parts[2]?.toLowerCase() === 'default';
+            const raw = (parts[1] ?? '').toLowerCase();
+            if (raw === 'off') {
+                if (toDefault)
+                    ctx.setDefaultContextWindow(undefined);
+                else
+                    ctx.setContextWindow(undefined);
+                return;
+            }
+            const tokens = parseTokens(raw);
+            if (tokens == null) {
+                ctx.notify('Usage: /context-window set <tokens|off> [default] (e.g. 16000 or 16k)', 'warn');
+                return;
+            }
+            if (toDefault)
+                ctx.setDefaultContextWindow(tokens);
+            else
+                ctx.setContextWindow(tokens);
+        },
+    },
+    { name: 'compact', summary: 'Compact the current session now (summarize older turns).', run: ctx => ctx.compactNow() },
+];
+/** Parse a token count: "16000" or "16k"/"16K" → 16000. Returns undefined when invalid. */
+function parseTokens(raw) {
+    const match = /^(\d+(?:\.\d+)?)(k)?$/i.exec(raw);
+    if (!match)
+        return undefined;
+    const value = Number(match[1]) * (match[2] ? 1000 : 1);
+    return Number.isFinite(value) && value > 0 ? Math.round(value) : undefined;
+}
+const REGISTRY = new Map();
+for (const spec of COMMANDS) {
+    REGISTRY.set(spec.name, spec);
+    for (const alias of spec.aliases ?? [])
+        REGISTRY.set(alias, spec);
+}
+export function listCommands() {
+    return COMMANDS;
+}
+/** Canonical command names plus discoverable aliases for the input menu. */
+export function listCommandCompletions() {
+    return COMMANDS.flatMap(spec => [
+        { name: spec.name, hint: spec.summary },
+        ...(spec.aliases ?? []).map(alias => ({
+            name: alias,
+            hint: `Alias for /${spec.name}. ${spec.summary}`,
+        })),
+    ]);
+}
+export function findCommand(name) {
+    return REGISTRY.get(name.toLowerCase());
+}
+/** Run a parsed command. Returns false when the name is unknown so the caller
+ * can surface a hint. */
+export function runCommand(ctx, name, args) {
+    const spec = findCommand(name);
+    if (!spec)
+        return false;
+    spec.run(ctx, args);
+    return true;
+}
+//# sourceMappingURL=commands.js.map

package/dist/core/commands.js.map

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