@illumiarq/lumis 1.2.8 → 1.2.10

package/dist/commands/tinker-repl-display.js

@@ -0,0 +1,147 @@
+/**
+ * Tinker REPL display and agent-plan execution helpers.
+ *
+ * Owns the welcome banner and the agent-plan executor so the entrypoint
+ * is pure orchestration.
+ */
+import { ansi } from '../output/ansi.js';
+import { renderAgentPlan, STATUS_ICON } from './tinker-agent-plan.js';
+import { PROVIDER_TOKEN_ENV } from './tinker-chat-commands.js';
+import { executeManagedToolCall } from './tinker-session-runtime.js';
+import { runVerificationGates } from '../tools/index.js';
+export function renderWelcome(session) {
+    session.context.write('\n');
+    session.context.write(ansi.label(`Tinker Mode — ${session.packName} (${session.framework})`));
+    session.context.write('\n\n');
+    if (session.chatEnabled) {
+        session.context.write('Chat mode is enabled for model runtime.\n');
+        session.context.write(`Runtime: ${session.context.config.preferredRuntime ?? 'auto'}\n`);
+        const tokenEnv = PROVIDER_TOKEN_ENV[session.context.config.preferredRuntime ?? ''];
+        if (tokenEnv) {
+            if (tokenEnv === 'OLLAMA_BASE_URL') {
+                session.context.write(`Ollama endpoint: ${process.env[tokenEnv] ?? 'http://localhost:11434/v1'}\n`);
+            }
+            else {
+                session.context.write(`${tokenEnv}: ${process.env[tokenEnv] ? 'set' : 'missing'}\n`);
+            }
+        }
+        if (session.chatModel) {
+            session.context.write(`Model: ${session.chatModel}\n`);
+        }
+        session.context.write('\n');
+        session.context.write('Chat Commands:\n');
+        session.context.write('  /? or /help        Show chat command help\n');
+        session.context.write('  /back              Return to classic tinker screen\n');
+        session.context.write('  /set token <value> Set provider token for this session only\n');
+        session.context.write('  /set model <name> [--save]  Set preferred model for this session\n');
+        session.context.write('  /load <model>      Alias for /set model <name>\n');
+        session.context.write('  /agent plan <goal>             Create a structured execution plan\n');
+        session.context.write('  /agent status                  Show current agent plan\n');
+        session.context.write('  /agent run [strict|off]        Execute plan with verification gates\n');
+        session.context.write('  /agent verify                  Run typecheck + tests\n');
+        session.context.write('  /agent rollback                Undo last write-file step\n');
+        session.context.write('  /agent clear                   Clear current agent plan\n');
+        session.context.write('  /tools on|off      Enable/disable LLM tool-call dispatch\n');
+        session.context.write('  /memory show       Show persistent memory stats/recent entries\n');
+        session.context.write('  /memory clear      Clear persistent memory store\n');
+        session.context.write('  /show              Show runtime/model info\n');
+        session.context.write('  /clear             Clear session chat history\n');
+        session.context.write('  /bye               Exit tinker\n');
+        session.context.write('\n');
+        session.context.write('Type your message directly to chat with AI.\n\n');
+        return;
+    }
+    session.context.write('Commands:\n');
+    session.context.write('  /help              Show this help\n');
+    session.context.write('  /status            Show project and IR status\n');
+    session.context.write('  /commands          List available pack commands\n');
+    session.context.write('  /intent <text>     Parse and preview intent\n');
+    session.context.write('  /plan <text>       Show plan for intent without executing\n');
+    session.context.write('  /ir                Show current IR snapshot\n');
+    session.context.write('  /config            Show Lumis config\n');
+    session.context.write('  /quit              Exit tinker mode\n');
+    session.context.write('\n');
+    session.context.write('Type commands starting with / or enter intent directly (create/update/delete/query ...):\n\n');
+}
+export async function runAgentPlan(session, gateLevel = 'standard') {
+    const plan = session.agentPlan;
+    if (!plan)
+        return;
+    session.agentRunning = true;
+    session.context.write(`\nRunning agent plan: ${plan.goal}\n`);
+    session.context.write(`Verification gate: ${gateLevel}\n\n`);
+    const pendingSteps = plan.steps.filter((s) => s.status === 'pending');
+    if (pendingSteps.length === 0) {
+        session.context.write('All steps are already completed or skipped.\n\n');
+        session.agentRunning = false;
+        return;
+    }
+    let wroteAtLeastOneFile = false;
+    for (const step of pendingSteps) {
+        step.status = 'running';
+        session.context.write(`${STATUS_ICON.running} [${step.id}] ${step.description}\n`);
+        try {
+            const stepLower = step.description.toLowerCase();
+            if (/^(write|create|update|modify|edit)\s+/.test(stepLower)) {
+                session.context.write('  (write step: content generation requires Phase 5 tool-call dispatch)\n');
+                step.status = 'skipped';
+            }
+            else if (/^(read|open|view)\s+/.test(stepLower)) {
+                const filePath = step.description.replace(/^(read|open|view)\s+/i, '').trim();
+                const result = await executeManagedToolCall(session, { tool: 'read-file', path: filePath }, session.chatHistory.length);
+                session.context.write(result.outcome === 'success'
+                    ? `  read ${filePath} (${result.output.split('\n').length} lines)\n`
+                    : `  ${result.error ?? 'read failed'}\n`);
+                step.status = result.outcome === 'success' ? 'done' : 'failed';
+            }
+            else if (/^typecheck/.test(stepLower)) {
+                const result = await executeManagedToolCall(session, { tool: 'typecheck' }, session.chatHistory.length);
+                const failCount = (result.diagnostics ?? []).filter((d) => d.severity === 'error').length;
+                session.context.write(`  ${result.outcome === 'success' ? '✓ typecheck passed' : `✗ typecheck failed: ${failCount} error(s)`}\n`);
+                step.status = result.outcome === 'success' ? 'done' : 'failed';
+            }
+            else if (/^(run tests?|test)/.test(stepLower)) {
+                const result = await executeManagedToolCall(session, { tool: 'run-tests' }, session.chatHistory.length);
+                session.context.write(`  ${result.outcome === 'success' ? '✓ tests passed' : '✗ tests failed'}\n`);
+                step.status = result.outcome === 'success' ? 'done' : 'failed';
+            }
+            else if (/^git diff/.test(stepLower)) {
+                const result = await executeManagedToolCall(session, { tool: 'git-diff' }, session.chatHistory.length);
+                session.context.write(`${result.output.slice(0, 2000)}\n`);
+                step.status = 'done';
+            }
+            else {
+                session.context.write(`  (step type not auto-executable — skipping)\n`);
+                step.status = 'skipped';
+            }
+        }
+        catch (err) {
+            step.status = 'failed';
+            session.context.writeError(`  Error: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+        session.context.write(`  → ${step.status}\n`);
+        if (step.status === 'failed' && step.risk === 'high') {
+            session.context.writeError('\nHigh-risk step failed. Pausing plan. Use /agent rollback or /agent clear.\n\n');
+            break;
+        }
+    }
+    if (wroteAtLeastOneFile && gateLevel !== 'off') {
+        session.context.write('\nRunning verification gates after writes...\n');
+        const report = await runVerificationGates(session.context.projectRoot, gateLevel);
+        session.context.write(`${report.passed ? '✓' : '✗'} ${report.summary}\n`);
+        if (!report.passed) {
+            const errors = report.results
+                .flatMap((r) => r.diagnostics ?? [])
+                .filter((d) => d.severity === 'error')
+                .slice(0, 8);
+            for (const diag of errors) {
+                const loc = diag.file ? `${diag.file}${diag.line ? `:${diag.line}` : ''} ` : '';
+                session.context.write(`  ${loc}${diag.message}\n`);
+            }
+        }
+    }
+    session.context.write('\nPlan execution complete.\n\n');
+    renderAgentPlan(session.context.write, plan);
+    session.agentRunning = false;
+}
+//# sourceMappingURL=tinker-repl-display.js.map

package/dist/commands/tinker-repl-display.js.map

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

package/dist/commands/tinker-session-runtime.d.ts

@@ -0,0 +1,27 @@
+import type { CommandContext } from './runtime.js';
+import type { ToolCall, ToolResult, WriteRecord } from '../tools/index.js';
+import { type PolicyGate } from '../lib/tinker-policy.js';
+import type { TinkerObserver } from '../lib/tinker-observer.js';
+import type { AuditTrail, SessionReplayer } from '../lib/tinker-replay.js';
+import { TinkerPluginRegistry } from '../plugins/tinker-plugin.js';
+export type TinkerSessionRuntime = {
+    context: CommandContext;
+    chatEnabled: boolean;
+    chatModel?: string;
+    pluginRegistry: TinkerPluginRegistry;
+    policyGate: PolicyGate;
+    auditTrail: AuditTrail;
+    observer: TinkerObserver;
+    sessionReplayer: SessionReplayer;
+    sessionId: string;
+    writeLog: WriteRecord[];
+};
+type SessionLifecycleHook = 'onSessionStart' | 'onSessionEnd';
+export declare function classifyToolCallPolicyOperation(call: ToolCall): 'read' | 'write' | 'execute';
+export declare function runSessionLifecycleHooks(session: TinkerSessionRuntime, hookName: SessionLifecycleHook): Promise<void>;
+export declare function applyUserMessageHooks(session: TinkerSessionRuntime, message: string): Promise<string>;
+export declare function handleAssistantMessage(session: TinkerSessionRuntime, message: string, turnIndex: number, toolCalls?: ToolCall[]): Promise<void>;
+export declare function handleUserMessage(session: TinkerSessionRuntime, message: string, turnIndex: number): Promise<string>;
+export declare function executeManagedToolCall(session: TinkerSessionRuntime, call: ToolCall, turnIndex: number): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=tinker-session-runtime.d.ts.map

package/dist/commands/tinker-session-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinker-session-runtime.d.ts","sourceRoot":"","sources":["../../src/commands/tinker-session-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG1E,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAA;AAE5F,MAAM,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,cAAc,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,oBAAoB,CAAA;IACpC,UAAU,EAAE,UAAU,CAAA;IACtB,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,cAAc,CAAA;IACxB,eAAe,EAAE,eAAe,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAA;CACvB,CAAA;AAED,KAAK,oBAAoB,GAAG,gBAAgB,GAAG,cAAc,CAAA;AAmC7D,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAc5F;AAED,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,QAAQ,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAqGrB"}

package/dist/commands/tinker-session-runtime.js

@@ -0,0 +1,196 @@
+import { executeToolCall } from '../tools/index.js';
+import { projectFingerprint } from '../lib/tinker-memory.js';
+import { enforcePolicy } from '../lib/tinker-policy.js';
+function createPluginContext(session) {
+    return {
+        projectRoot: session.context.projectRoot,
+        session: {
+            context: { write: session.context.write, writeError: session.context.writeError },
+            chatModel: session.chatModel,
+            chatEnabled: session.chatEnabled,
+        },
+    };
+}
+async function recordObserverEvent(session, turnIndex, eventType, data) {
+    try {
+        await session.observer.recordTurn({
+            timestamp: new Date().toISOString(),
+            sessionId: session.sessionId,
+            projectFingerprint: projectFingerprint(session.context.projectRoot),
+            turnIndex,
+            eventType,
+            data,
+        });
+    }
+    catch (error) {
+        session.context.writeError(`Observer error: ${error instanceof Error ? error.message : String(error)}\n`);
+    }
+}
+export function classifyToolCallPolicyOperation(call) {
+    switch (call.tool) {
+        case 'write-file':
+            return 'write';
+        case 'run-command':
+        case 'typecheck':
+        case 'run-tests':
+        case 'lint':
+            return 'execute';
+        case 'read-file':
+        case 'search-repo':
+        case 'git-diff':
+            return 'read';
+    }
+}
+export async function runSessionLifecycleHooks(session, hookName) {
+    const pluginContext = createPluginContext(session);
+    for (const plugin of session.pluginRegistry.getAll()) {
+        const hook = plugin[hookName];
+        if (typeof hook !== 'function')
+            continue;
+        try {
+            await hook.call(plugin, pluginContext);
+        }
+        catch (error) {
+            session.context.writeError(`Plugin ${plugin.name} hook error: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+}
+export async function applyUserMessageHooks(session, message) {
+    let nextMessage = message;
+    const pluginContext = createPluginContext(session);
+    for (const plugin of session.pluginRegistry.getAll()) {
+        if (!plugin.onUserMessage)
+            continue;
+        try {
+            const result = await plugin.onUserMessage(nextMessage, pluginContext);
+            if (typeof result === 'string' && result.trim()) {
+                nextMessage = result;
+            }
+        }
+        catch (error) {
+            session.context.writeError(`Plugin ${plugin.name} hook error: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+    return nextMessage;
+}
+export async function handleAssistantMessage(session, message, turnIndex, toolCalls) {
+    const pluginContext = createPluginContext(session);
+    for (const plugin of session.pluginRegistry.getAll()) {
+        if (!plugin.onAssistantMessage)
+            continue;
+        try {
+            await plugin.onAssistantMessage(message, pluginContext);
+        }
+        catch (error) {
+            session.context.writeError(`Plugin ${plugin.name} hook error: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+    session.sessionReplayer.recordAssistantMessage(message, toolCalls?.map((call) => ({ tool: call.tool, args: call })));
+    await recordObserverEvent(session, turnIndex, 'assistant-message', {
+        message,
+        ...(toolCalls ? { toolCalls } : {}),
+    });
+}
+export async function handleUserMessage(session, message, turnIndex) {
+    const nextMessage = await applyUserMessageHooks(session, message);
+    session.sessionReplayer.recordUserMessage(nextMessage);
+    await recordObserverEvent(session, turnIndex, 'user-message', { message: nextMessage });
+    return nextMessage;
+}
+export async function executeManagedToolCall(session, call, turnIndex) {
+    const startedAt = Date.now();
+    const operation = classifyToolCallPolicyOperation(call);
+    const pluginContext = createPluginContext(session);
+    try {
+        enforcePolicy(session.policyGate, 'tool-call');
+        enforcePolicy(session.policyGate, operation);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        session.auditTrail.recordToolCall(call.tool, 'failure', { operation, error: message });
+        await recordObserverEvent(session, turnIndex, 'error', {
+            scope: 'tool-policy',
+            tool: call.tool,
+            operation,
+            error: message,
+        });
+        return {
+            tool: call.tool,
+            outcome: 'failure',
+            output: '',
+            error: message,
+            durationMs: Date.now() - startedAt,
+        };
+    }
+    await recordObserverEvent(session, turnIndex, 'tool-call', {
+        tool: call.tool,
+        call,
+        operation,
+    });
+    for (const plugin of session.pluginRegistry.getAll()) {
+        if (!plugin.onToolCall)
+            continue;
+        try {
+            const allowed = await plugin.onToolCall(call, pluginContext);
+            if (allowed === false) {
+                const message = `Tool call '${call.tool}' rejected by plugin '${plugin.name}'`;
+                session.auditTrail.recordToolCall(call.tool, 'skipped', {
+                    operation,
+                    rejectedBy: plugin.name,
+                });
+                await recordObserverEvent(session, turnIndex, 'tool-result', {
+                    tool: call.tool,
+                    outcome: 'skipped',
+                    rejectedBy: plugin.name,
+                });
+                return {
+                    tool: call.tool,
+                    outcome: 'skipped',
+                    output: '',
+                    error: message,
+                    durationMs: Date.now() - startedAt,
+                };
+            }
+        }
+        catch (error) {
+            session.context.writeError(`Plugin ${plugin.name} hook error: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+    let result;
+    try {
+        result = await executeToolCall(call, session.context.projectRoot, session.writeLog);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        result = {
+            tool: call.tool,
+            outcome: 'failure',
+            output: '',
+            error: message,
+            durationMs: Date.now() - startedAt,
+        };
+    }
+    for (const plugin of session.pluginRegistry.getAll()) {
+        if (!plugin.onToolResult)
+            continue;
+        try {
+            result = await plugin.onToolResult(call, result, pluginContext);
+        }
+        catch (error) {
+            session.context.writeError(`Plugin ${plugin.name} hook error: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
+    session.auditTrail.recordToolCall(call.tool, result.outcome, {
+        operation,
+        durationMs: result.durationMs,
+        ...(result.error ? { error: result.error } : {}),
+    });
+    await recordObserverEvent(session, turnIndex, 'tool-result', {
+        tool: call.tool,
+        outcome: result.outcome,
+        durationMs: result.durationMs,
+        ...(result.error ? { error: result.error } : {}),
+    });
+    return result;
+}
+//# sourceMappingURL=tinker-session-runtime.js.map

package/dist/commands/tinker-session-runtime.js.map

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

package/dist/commands/tinker.command.d.ts

@@ -0,0 +1,9 @@
+import type { CommandContext } from './runtime.js';
+/**
+ * Run interactive tinker REPL.
+ *
+ * @param context - Shared command runtime context.
+ * @returns Exit code 0 on success, 1 on resolution/setup errors.
+ */
+export declare function executeTinkerCommand(context: CommandContext): Promise<number>;
+//# sourceMappingURL=tinker.command.d.ts.map

package/dist/commands/tinker.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinker.command.d.ts","sourceRoot":"","sources":["../../src/commands/tinker.command.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAuGlD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyFnF"}

package/dist/commands/tinker.command.js

@@ -0,0 +1,142 @@
+/**
+ * Interactive tinker command entrypoint.
+ *
+ * Provides an interactive REPL where developers can:
+ * - Explore pack-specific context and commands
+ * - Test intent parsing
+ * - Preview plans without executing
+ * - Inspect IR state
+ */
+import readline from 'node:readline';
+import { loadMemoryStore, } from '../lib/tinker-memory.js';
+import { TinkerPluginRegistry } from '../plugins/tinker-plugin.js';
+import { createObserver } from '../lib/tinker-observer.js';
+import { getPolicyForSession } from '../lib/tinker-policy.js';
+import { AuditTrail, SessionReplayer, generateSessionId } from '../lib/tinker-replay.js';
+import { looksLikeFilesystemPath, resetChatHistory, sendChatMessage, } from './tinker-chat-runtime.js';
+import { handleChatCommand } from './tinker-chat-commands.js';
+import { handleClassicInput } from './tinker-classic-mode.js';
+import { runSessionLifecycleHooks } from './tinker-session-runtime.js';
+import { renderWelcome, runAgentPlan } from './tinker-repl-display.js';
+const AGENT_RUNTIMES = new Set(['claude-code', 'copilot']);
+function isModelRuntime(runtime) {
+    if (!runtime)
+        return true;
+    if (runtime === 'local')
+        return true;
+    return !AGENT_RUNTIMES.has(runtime);
+}
+/**
+ * Handle a single tinker input line.
+ */
+async function handleInput(session, input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return;
+    if (session.chatEnabled) {
+        if (trimmed.startsWith('/')) {
+            if (handleChatCommand(session, trimmed, {
+                renderWelcome,
+                runAgentPlan,
+            })) {
+                return;
+            }
+            if (looksLikeFilesystemPath(trimmed)) {
+                await sendChatMessage(session, trimmed);
+                return;
+            }
+            session.context.writeError(`Unknown chat command: ${trimmed}\n`);
+            session.context.write('Type /help for chat commands.\n\n');
+            return;
+        }
+        if (!trimmed.startsWith('/')) {
+            await sendChatMessage(session, trimmed);
+            return;
+        }
+    }
+    await handleClassicInput(session, trimmed);
+}
+/**
+ * Run interactive tinker REPL.
+ *
+ * @param context - Shared command runtime context.
+ * @returns Exit code 0 on success, 1 on resolution/setup errors.
+ */
+export async function executeTinkerCommand(context) {
+    const pack = await context.resolvePack();
+    if (!pack) {
+        context.writeError('No compatible pack detected for this project.\n');
+        return 1;
+    }
+    const packFramework = pack.manifest.frameworks?.[0] ?? 'unknown';
+    const sessionId = generateSessionId();
+    process.env.TINKER_SESSION_ID = sessionId;
+    const session = {
+        context,
+        packName: pack.manifest.name,
+        framework: packFramework,
+        rl: readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        }),
+        running: true,
+        chatEnabled: isModelRuntime(context.config.preferredRuntime),
+        ...(context.config.ai?.defaultModel ? { chatModel: context.config.ai.defaultModel } : {}),
+        chatHistory: [],
+        ragReady: false,
+        ragInitializing: false,
+        ragIndexedFiles: 0,
+        writeLog: [],
+        agentRunning: false,
+        toolCallsEnabled: true,
+        memoryStore: loadMemoryStore(),
+        pluginRegistry: new TinkerPluginRegistry(),
+        observer: createObserver(sessionId),
+        policyGate: getPolicyForSession(),
+        auditTrail: new AuditTrail(context.projectRoot),
+        sessionReplayer: new SessionReplayer(context.projectRoot, sessionId),
+        sessionId,
+    };
+    if (session.chatEnabled) {
+        resetChatHistory(session);
+    }
+    renderWelcome(session);
+    void runSessionLifecycleHooks(session, 'onSessionStart');
+    return new Promise((resolve) => {
+        let closing = false;
+        const closeAndResolve = async () => {
+            if (closing)
+                return;
+            closing = true;
+            await runSessionLifecycleHooks(session, 'onSessionEnd');
+            // Phase 8: Flush observability
+            await session.observer.flush();
+            session.rl.close();
+            resolve(0);
+        };
+        session.rl.setPrompt(session.chatEnabled ? '>>> ' : '> ');
+        session.rl.prompt();
+        session.rl.on('line', async (line) => {
+            try {
+                await handleInput(session, line);
+            }
+            catch (error) {
+                session.context.writeError(`Error: ${error instanceof Error ? error.message : String(error)}\n`);
+            }
+            if (!session.running) {
+                await closeAndResolve();
+                return;
+            }
+            session.rl.prompt();
+        });
+        session.rl.on('SIGINT', async () => {
+            session.context.write('\nGoodbye.\n');
+            session.running = false;
+            await closeAndResolve();
+        });
+        session.rl.on('close', () => {
+            closeAndResolve();
+        });
+    });
+}
+//# sourceMappingURL=tinker.command.js.map

package/dist/commands/tinker.command.js.map

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

package/dist/commands/use.command.d.ts

@@ -0,0 +1,10 @@
+import type { CommandContext } from './runtime.js';
+export declare const SUPPORTED_RUNTIMES: string[];
+/**
+ * Execute the use command to select preferred runtime.
+ *
+ * @param context - Shared command runtime context.
+ * @returns Exit code (0 success, 1 on validation/write errors).
+ */
+export declare function executeUseCommand(context: CommandContext): Promise<number>;
+//# sourceMappingURL=use.command.d.ts.map

package/dist/commands/use.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.command.d.ts","sourceRoot":"","sources":["../../src/commands/use.command.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlD,eAAO,MAAM,kBAAkB,UAY9B,CAAA;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ChF"}