@glbgpt/cli 0.1.0-test.1

package/dist/src/core/httpChatBackend.js

@@ -0,0 +1,134 @@
+import { withRetry, isTransientNetworkError, describeNetworkError, hostOf } from '../util/retry.js';
+/** Transient gateway/infra statuses worth retrying before the stream starts. */
+const TRANSIENT_STATUS = new Set([502, 503, 504]);
+/**
+ * Real chat backend: streams from `POST /ai-api/cli/v1/chat/completions` (OpenAI-compatible SSE).
+ *
+ * Note: the GlobalGPT gateway returns HTTP 200 for business errors with a JSON body
+ * (`{code, message}`) and Content-Type `application/json` instead of `text/event-stream`.
+ * We detect that by Content-Type and surface it as an error.
+ */
+export class HttpChatBackend {
+    baseUrl;
+    token;
+    fetchImpl;
+    retries;
+    sleep;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+        this.token = opts.token;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.retries = opts.retries ?? 3;
+        this.sleep = opts.sleep;
+    }
+    /** Hot-swap the JWT (used by the in-chat /login re-auth). */
+    setToken(token) {
+        this.token = token;
+    }
+    async *stream(req, signal) {
+        const url = `${this.baseUrl}/ai-api/cli/v1/chat/completions`;
+        const host = hostOf(this.baseUrl);
+        // Retry the request only up to (and including) receiving the response head. Once we begin
+        // reading the stream body below, we never retry — replaying a partially-billed stream would
+        // double-charge. Connection-level throws and transient 5xx are retried with backoff.
+        let res;
+        try {
+            res = await withRetry(() => this.fetchImpl(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'text/event-stream',
+                    Authorization: `Bearer ${this.token}`,
+                },
+                body: JSON.stringify(req),
+                signal,
+            }), {
+                retries: this.retries,
+                sleep: this.sleep,
+                isRetryableResult: (r) => TRANSIENT_STATUS.has(r.status),
+                // Never retry a user-initiated abort — it must interrupt immediately.
+                isRetryableError: (err) => !signal?.aborted && isTransientNetworkError(err),
+            });
+        }
+        catch (err) {
+            // A user-initiated abort must propagate as-is (the turn loop treats it as an interrupt).
+            if (signal?.aborted)
+                throw err;
+            if (isTransientNetworkError(err)) {
+                throw new Error(describeNetworkError(err, host, this.retries));
+            }
+            throw err;
+        }
+        if (TRANSIENT_STATUS.has(res.status)) {
+            // Retries exhausted and the gateway is still unavailable.
+            throw new Error(describeNetworkError(new Error(`HTTP ${res.status}`), host, this.retries));
+        }
+        const contentType = res.headers.get('content-type') ?? '';
+        if (!contentType.includes('text/event-stream')) {
+            // Business error path: the gateway returns HTTP 200 + a JSON body with a `code`
+            // (401 expired/invalid, 402 payment) — never trust the HTTP status.
+            const text = await res.text();
+            let body = {};
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                /* non-JSON */
+            }
+            throw businessError(body.code, body.message || text || `status ${res.status}`);
+        }
+        if (!res.body) {
+            throw new Error('Chat response has no body');
+        }
+        const decoder = new TextDecoder();
+        let buffer = '';
+        for await (const bytes of res.body) {
+            buffer += decoder.decode(bytes, { stream: true });
+            let idx;
+            while ((idx = buffer.indexOf('\n')) >= 0) {
+                const line = buffer.slice(0, idx).trim();
+                buffer = buffer.slice(idx + 1);
+                const chunk = parseSseLine(line);
+                if (chunk)
+                    yield chunk;
+            }
+        }
+        const tail = parseSseLine(buffer.trim());
+        if (tail)
+            yield tail;
+    }
+}
+/** Map a gateway business-error payload to an actionable Error. */
+function businessError(code, message) {
+    if (code === 401)
+        return new Error('Your session has expired. Run `glbgpt login` again.');
+    if (code === 402)
+        return new Error(message || 'Payment required (insufficient balance or plan).');
+    return new Error(`Chat request failed: ${message}`);
+}
+/**
+ * Parse one SSE line into a ChatChunk, or null for keepalives/[DONE]/non-data lines.
+ *
+ * The gateway can also reject WITHIN the stream: an `event: error` frame whose data is
+ * `{code, message}` with no `choices` (e.g. a model outside the backend whitelist). Silently
+ * ignoring it would make the turn complete with no output at all, so it throws instead.
+ */
+function parseSseLine(line) {
+    if (!line.startsWith('data:'))
+        return null;
+    const data = line.slice('data:'.length).trim();
+    if (!data || data === '[DONE]')
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+    if (parsed.choices === undefined && parsed.usage === undefined && typeof parsed.code === 'number') {
+        throw businessError(parsed.code, parsed.message ?? `code ${parsed.code}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=httpChatBackend.js.map

package/dist/src/core/httpChatBackend.js.map

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

package/dist/src/core/id.d.ts

@@ -0,0 +1,2 @@
+/** Generate a locally-unique id (timestamp + random suffix) for sessions and the like. */
+export declare function newId(): string;

package/dist/src/core/id.js

@@ -0,0 +1,5 @@
+/** Generate a locally-unique id (timestamp + random suffix) for sessions and the like. */
+export function newId() {
+    return `${Date.now().toString(36)}-${Math.floor(Math.random() * 1e6).toString(36)}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/src/core/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../src/core/id.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,UAAU,KAAK;IACnB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AACtF,CAAC"}

package/dist/src/core/runChat.d.ts

@@ -0,0 +1,28 @@
+import type { ChatBackend, ContentPart, EngineEvent } from './types.js';
+/** One chat-only turn's result. `structured` is set when a response schema was requested. */
+export interface ChatTurnResult {
+    content: string;
+    structured: unknown | null;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+    };
+}
+export interface ChatTurnParams {
+    backend: ChatBackend;
+    model: string;
+    /** Plain text, or multimodal content parts (vision). */
+    prompt: string | ContentPart[];
+    system?: string;
+    /** OpenAI `response_format` value (json_schema) for structured output. */
+    responseFormat?: unknown;
+}
+/**
+ * Run a single chat-only turn (no client tools) and return the final message, parsed structured
+ * output (when a schema was requested), and token usage.
+ *
+ * Shared by `exec` and the MCP server so both behave identically. `onEvent` streams deltas/usage
+ * live (exec's --jsonl uses it); callers that only want the final result omit it. Throws on a
+ * backend/turn error or when structured output does not parse.
+ */
+export declare function runChatTurn(params: ChatTurnParams, onEvent?: (event: EngineEvent) => void): Promise<ChatTurnResult>;

package/dist/src/core/runChat.js

@@ -0,0 +1,49 @@
+import { Session } from './session.js';
+import { TurnLoop } from './turnLoop.js';
+import { ToolRegistry } from './toolRegistry.js';
+import { newId } from './id.js';
+/**
+ * Run a single chat-only turn (no client tools) and return the final message, parsed structured
+ * output (when a schema was requested), and token usage.
+ *
+ * Shared by `exec` and the MCP server so both behave identically. `onEvent` streams deltas/usage
+ * live (exec's --jsonl uses it); callers that only want the final result omit it. Throws on a
+ * backend/turn error or when structured output does not parse.
+ */
+export async function runChatTurn(params, onEvent) {
+    const session = new Session({ id: newId(), model: params.model });
+    if (params.system?.trim())
+        session.addSystemMessage(params.system.trim());
+    const turnLoop = new TurnLoop(params.backend, new ToolRegistry());
+    let content = '';
+    let usage = { prompt_tokens: 0, completion_tokens: 0 };
+    let engineError = null;
+    await turnLoop.runTurn(session, params.prompt, (event) => {
+        switch (event.type) {
+            case 'assistant_delta':
+                content += event.text;
+                break;
+            case 'usage':
+                usage = { prompt_tokens: event.promptTokens, completion_tokens: event.completionTokens };
+                break;
+            case 'error':
+                engineError = event.message;
+                break;
+            // tool_* never fire (no tools); turn_complete is implicit in runTurn resolving.
+        }
+        onEvent?.(event);
+    }, { responseFormat: params.responseFormat });
+    if (engineError)
+        throw new Error(engineError);
+    let structured = null;
+    if (params.responseFormat !== undefined) {
+        try {
+            structured = JSON.parse(content);
+        }
+        catch {
+            throw new Error('Model output did not parse as JSON despite the requested schema.');
+        }
+    }
+    return { content, structured, usage };
+}
+//# sourceMappingURL=runChat.js.map

package/dist/src/core/runChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runChat.js","sourceRoot":"","sources":["../../../src/core/runChat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAoBhC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAsB,EACtB,OAAsC;IAEtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAClE,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;IAElE,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;IACvD,IAAI,WAAW,GAAkB,IAAI,CAAC;IAEtC,MAAM,QAAQ,CAAC,OAAO,CACpB,OAAO,EACP,MAAM,CAAC,MAAM,EACb,CAAC,KAAK,EAAE,EAAE;QACR,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,iBAAiB;gBACpB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC;gBACtB,MAAM;YACR,KAAK,OAAO;gBACV,KAAK,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,YAAY,EAAE,iBAAiB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC;gBACzF,MAAM;YACR,KAAK,OAAO;gBACV,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC;gBAC5B,MAAM;YACR,gFAAgF;QAClF,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC,EACD,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAC1C,CAAC;IAEF,IAAI,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;IAE9C,IAAI,UAAU,GAAmB,IAAI,CAAC;IACtC,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/src/core/session.d.ts

@@ -0,0 +1,44 @@
+import type { ChatMessage, ToolCall, ToolResult } from './types.js';
+/** Serializable snapshot of a conversation, used for local persistence and resume. */
+export interface SessionSnapshot {
+    id: string;
+    model: string;
+    createdAt: number;
+    updatedAt: number;
+    messages: ChatMessage[];
+}
+/**
+ * A single conversation the CLI owns end to end.
+ *
+ * The CLI is a thin client: it carries the full `messages` array to the stateless
+ * backend each turn. Switching the model (`/model`) preserves the message history,
+ * so the new model continues the same conversation (product decision 2026-07-14).
+ */
+export declare class Session {
+    readonly id: string;
+    readonly createdAt: number;
+    model: string;
+    messages: ChatMessage[];
+    constructor(params: {
+        id: string;
+        model: string;
+        createdAt?: number;
+        messages?: ChatMessage[];
+    });
+    /** Prepend a system message (must precede the first user message to steer the model). */
+    addSystemMessage(text: string): void;
+    /**
+     * Append a system note mid-conversation (environment updates the model should know about,
+     * e.g. a background generation finishing after its tool call already returned).
+     */
+    addSystemNote(text: string): void;
+    addUserMessage(content: string | import('./types.js').ContentPart[]): void;
+    /** Append the assistant message for a completed model call (text and/or tool_calls). */
+    addAssistantMessage(content: string | null, toolCalls: ToolCall[]): void;
+    /** Append a tool result message answering a specific tool call. */
+    addToolMessage(toolCallId: string, name: string, result: ToolResult): void;
+    /** Switch the active model while keeping the conversation history. */
+    switchModel(model: string): void;
+    toSnapshot(): SessionSnapshot;
+    static fromSnapshot(s: SessionSnapshot): Session;
+}

package/dist/src/core/session.js

@@ -0,0 +1,70 @@
+/**
+ * A single conversation the CLI owns end to end.
+ *
+ * The CLI is a thin client: it carries the full `messages` array to the stateless
+ * backend each turn. Switching the model (`/model`) preserves the message history,
+ * so the new model continues the same conversation (product decision 2026-07-14).
+ */
+export class Session {
+    id;
+    createdAt;
+    model;
+    messages;
+    constructor(params) {
+        this.id = params.id;
+        this.model = params.model;
+        this.createdAt = params.createdAt ?? nowMs();
+        this.messages = params.messages ?? [];
+    }
+    /** Prepend a system message (must precede the first user message to steer the model). */
+    addSystemMessage(text) {
+        this.messages.unshift({ role: 'system', content: text });
+    }
+    /**
+     * Append a system note mid-conversation (environment updates the model should know about,
+     * e.g. a background generation finishing after its tool call already returned).
+     */
+    addSystemNote(text) {
+        this.messages.push({ role: 'system', content: text });
+    }
+    addUserMessage(content) {
+        this.messages.push({ role: 'user', content });
+    }
+    /** Append the assistant message for a completed model call (text and/or tool_calls). */
+    addAssistantMessage(content, toolCalls) {
+        const msg = { role: 'assistant', content: content ?? null };
+        if (toolCalls.length > 0) {
+            msg.tool_calls = toolCalls;
+        }
+        this.messages.push(msg);
+    }
+    /** Append a tool result message answering a specific tool call. */
+    addToolMessage(toolCallId, name, result) {
+        this.messages.push({
+            role: 'tool',
+            tool_call_id: toolCallId,
+            name,
+            content: JSON.stringify(result),
+        });
+    }
+    /** Switch the active model while keeping the conversation history. */
+    switchModel(model) {
+        this.model = model;
+    }
+    toSnapshot() {
+        return {
+            id: this.id,
+            model: this.model,
+            createdAt: this.createdAt,
+            updatedAt: nowMs(),
+            messages: this.messages,
+        };
+    }
+    static fromSnapshot(s) {
+        return new Session({ id: s.id, model: s.model, createdAt: s.createdAt, messages: s.messages });
+    }
+}
+function nowMs() {
+    return Date.now();
+}
+//# sourceMappingURL=session.js.map

package/dist/src/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/core/session.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,MAAM,OAAO,OAAO;IACT,EAAE,CAAS;IACX,SAAS,CAAS;IAC3B,KAAK,CAAS;IACd,QAAQ,CAAgB;IAExB,YAAY,MAAmF;QAC7F,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,CAAC;IAED,yFAAyF;IACzF,gBAAgB,CAAC,IAAY;QAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,IAAY;QACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,cAAc,CAAC,OAAoD;QACjE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,wFAAwF;IACxF,mBAAmB,CAAC,OAAsB,EAAE,SAAqB;QAC/D,MAAM,GAAG,GAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;QACzE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,mEAAmE;IACnE,cAAc,CAAC,UAAkB,EAAE,IAAY,EAAE,MAAkB;QACjE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,MAAM;YACZ,YAAY,EAAE,UAAU;YACxB,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,UAAU;QACR,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,KAAK,EAAE;YAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,CAAkB;QACpC,OAAO,IAAI,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjG,CAAC;CACF;AAED,SAAS,KAAK;IACZ,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC"}

package/dist/src/core/sessionStore.d.ts

@@ -0,0 +1,39 @@
+import { Session } from './session.js';
+/**
+ * A persisted UI transcript entry. Stored ALONGSIDE the model messages (the Codex
+ * rollout / Claude Code transcript architecture: model context and UI events are
+ * separate, parallel records) — the TUI owns the concrete shape.
+ */
+export type PersistedTimelineItem = Record<string, unknown>;
+/** One row in the `/resume` session picker. */
+export interface SessionSummary {
+    id: string;
+    model: string;
+    updatedAt: number;
+    /** First user message, truncated — enough to recognize the conversation. */
+    preview: string;
+}
+/**
+ * Local persistence for sessions (phase 1: one JSON file per session under a directory).
+ *
+ * Phase-1 scope: history lives on the client only. A future phase may sync sessions to
+ * the backend; the store interface stays the same.
+ */
+export declare class SessionStore {
+    private readonly dir;
+    /** Serializes writes — two subscribers (task events + turn settle) can save concurrently. */
+    private writeChain;
+    constructor(dir: string);
+    private file;
+    save(session: Session, timeline?: PersistedTimelineItem[]): Promise<void>;
+    load(id: string): Promise<Session>;
+    /** Load a session plus its persisted transcript (absent in pre-2026-07-15 files). */
+    loadWithTimeline(id: string): Promise<{
+        session: Session;
+        timeline?: PersistedTimelineItem[];
+    }>;
+    /** Summaries of stored sessions, newest first (for the `/resume` picker). */
+    list(limit?: number): Promise<SessionSummary[]>;
+    /** Resume the most recently updated session, or null if none exist. */
+    loadLast(): Promise<Session | null>;
+}

package/dist/src/core/sessionStore.js

@@ -0,0 +1,106 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { Session } from './session.js';
+/**
+ * Local persistence for sessions (phase 1: one JSON file per session under a directory).
+ *
+ * Phase-1 scope: history lives on the client only. A future phase may sync sessions to
+ * the backend; the store interface stays the same.
+ */
+export class SessionStore {
+    dir;
+    /** Serializes writes — two subscribers (task events + turn settle) can save concurrently. */
+    writeChain = Promise.resolve();
+    constructor(dir) {
+        this.dir = dir;
+    }
+    file(id) {
+        return path.join(this.dir, `${id}.json`);
+    }
+    async save(session, timeline) {
+        // Snapshot NOW (caller-time state), write in order. tmp+rename keeps the file readable
+        // even if the process dies mid-write (the Codex rollout recorder's durability property —
+        // a torn session file is unrecoverable, not just missing its tail).
+        const snapshot = { ...session.toSnapshot(), ...(timeline ? { timeline } : {}) };
+        const file = this.file(session.id);
+        this.writeChain = this.writeChain.then(async () => {
+            await fs.mkdir(this.dir, { recursive: true });
+            const tmp = `${file}.${process.pid}.tmp`;
+            await fs.writeFile(tmp, JSON.stringify(snapshot, null, 2), 'utf8');
+            await fs.rename(tmp, file);
+        });
+        await this.writeChain;
+    }
+    async load(id) {
+        return (await this.loadWithTimeline(id)).session;
+    }
+    /** Load a session plus its persisted transcript (absent in pre-2026-07-15 files). */
+    async loadWithTimeline(id) {
+        const raw = await fs.readFile(this.file(id), 'utf8');
+        const snapshot = JSON.parse(raw);
+        return { session: Session.fromSnapshot(snapshot), timeline: snapshot.timeline };
+    }
+    /** Summaries of stored sessions, newest first (for the `/resume` picker). */
+    async list(limit = 10) {
+        let entries;
+        try {
+            entries = await fs.readdir(this.dir);
+        }
+        catch {
+            return [];
+        }
+        const summaries = [];
+        for (const file of entries.filter((e) => e.endsWith('.json'))) {
+            try {
+                const raw = await fs.readFile(path.join(this.dir, file), 'utf8');
+                const snap = JSON.parse(raw);
+                const firstUser = snap.messages.find((m) => m.role === 'user');
+                const raw0 = firstUser?.content;
+                // Multimodal user messages store content parts; preview the text part.
+                const previewText = typeof raw0 === 'string'
+                    ? raw0
+                    : Array.isArray(raw0)
+                        ? raw0.map((p) => (p.type === 'text' ? p.text : '')).join('')
+                        : '(empty)';
+                summaries.push({
+                    id: snap.id,
+                    model: snap.model,
+                    updatedAt: snap.updatedAt,
+                    preview: (previewText || '(empty)').slice(0, 60),
+                });
+            }
+            catch {
+                // Skip unreadable/corrupt files.
+            }
+        }
+        return summaries.sort((a, b) => b.updatedAt - a.updatedAt).slice(0, limit);
+    }
+    /** Resume the most recently updated session, or null if none exist. */
+    async loadLast() {
+        let entries;
+        try {
+            entries = await fs.readdir(this.dir);
+        }
+        catch {
+            return null;
+        }
+        const jsonFiles = entries.filter((e) => e.endsWith('.json'));
+        if (jsonFiles.length === 0)
+            return null;
+        let newest = null;
+        for (const file of jsonFiles) {
+            try {
+                const raw = await fs.readFile(path.join(this.dir, file), 'utf8');
+                const snap = JSON.parse(raw);
+                if (!newest || snap.updatedAt > newest.updatedAt) {
+                    newest = { id: snap.id, updatedAt: snap.updatedAt };
+                }
+            }
+            catch {
+                // Skip unreadable/corrupt files.
+            }
+        }
+        return newest ? this.load(newest.id) : null;
+    }
+}
+//# sourceMappingURL=sessionStore.js.map

package/dist/src/core/sessionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.js","sourceRoot":"","sources":["../../../src/core/sessionStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAwB,MAAM,cAAc,CAAC;AAuB7D;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAIM;IAH7B,6FAA6F;IACrF,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtD,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEpC,IAAI,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAgB,EAAE,QAAkC;QAC7D,uFAAuF;QACvF,yFAAyF;QACzF,oEAAoE;QACpE,MAAM,QAAQ,GAAmB,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;YACzC,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACnE,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,OAAO,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACnD,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,gBAAgB,CAAC,EAAU;QAC/B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClF,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE;QACnB,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,SAAS,GAAqB,EAAE,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;gBACjE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;gBAChD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBAC/D,MAAM,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC;gBAChC,uEAAuE;gBACvE,MAAM,WAAW,GACf,OAAO,IAAI,KAAK,QAAQ;oBACtB,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;wBACnB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC7D,CAAC,CAAC,SAAS,CAAC;gBAClB,SAAS,CAAC,IAAI,CAAC;oBACb,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,OAAO,EAAE,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;iBACjD,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,QAAQ;QACZ,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAExC,IAAI,MAAM,GAA6C,IAAI,CAAC;QAC5D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;gBACjE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;gBAChD,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;oBACjD,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;CACF"}

package/dist/src/core/toolRegistry.d.ts

@@ -0,0 +1,19 @@
+import type { ClientTool, OpenAITool, ToolResult } from './types.js';
+/**
+ * Registry of client-side tools the model may call.
+ *
+ * Tools execute locally in the CLI (they are NOT backend concerns). The registry
+ * exposes their OpenAI definitions for the request and dispatches calls by name.
+ */
+export declare class ToolRegistry {
+    private readonly tools;
+    register(tool: ClientTool): this;
+    has(name: string): boolean;
+    /** OpenAI `tools` array for the chat request. Undefined when no tools are registered. */
+    toOpenAITools(): OpenAITool[] | undefined;
+    /**
+     * Dispatch a tool call. `rawArgs` is the JSON-encoded arguments string the model produced.
+     * Never throws: parse/execution failures are returned as an error result so the model can react.
+     */
+    dispatch(name: string, rawArgs: string): Promise<ToolResult>;
+}

package/dist/src/core/toolRegistry.js

@@ -0,0 +1,53 @@
+/**
+ * Registry of client-side tools the model may call.
+ *
+ * Tools execute locally in the CLI (they are NOT backend concerns). The registry
+ * exposes their OpenAI definitions for the request and dispatches calls by name.
+ */
+export class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        this.tools.set(tool.name, tool);
+        return this;
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    /** OpenAI `tools` array for the chat request. Undefined when no tools are registered. */
+    toOpenAITools() {
+        if (this.tools.size === 0)
+            return undefined;
+        return [...this.tools.values()].map((t) => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.parameters,
+            },
+        }));
+    }
+    /**
+     * Dispatch a tool call. `rawArgs` is the JSON-encoded arguments string the model produced.
+     * Never throws: parse/execution failures are returned as an error result so the model can react.
+     */
+    async dispatch(name, rawArgs) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return { error: `Unknown tool: ${name}` };
+        }
+        let args;
+        try {
+            args = rawArgs && rawArgs.trim() ? JSON.parse(rawArgs) : {};
+        }
+        catch {
+            return { error: `Invalid tool arguments (not valid JSON): ${rawArgs}` };
+        }
+        try {
+            return await tool.execute(args);
+        }
+        catch (err) {
+            return { error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+}
+//# sourceMappingURL=toolRegistry.js.map

package/dist/src/core/toolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRegistry.js","sourceRoot":"","sources":["../../../src/core/toolRegistry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEvD,QAAQ,CAAC,IAAgB;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,yFAAyF;IACzF,aAAa;QACX,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,EAAE,UAAmB;YACzB,QAAQ,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAAe;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;QAC5C,CAAC;QACD,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,KAAK,EAAE,4CAA4C,OAAO,EAAE,EAAE,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;CACF"}

package/dist/src/core/tools/generateImage.d.ts

@@ -0,0 +1,10 @@
+import type { ClientTool } from '../types.js';
+/**
+ * Phase-1 STUB image generation tool.
+ *
+ * In phase 1 this returns a fake task id and does NOT call the real generation
+ * endpoint or incur any media billing (per the vertical-slice scope). A later phase
+ * wires `execute` to the real `POST /ai-api/ai/{model}/task/submit` flow and the CLI
+ * task-management commands take over waiting/downloading.
+ */
+export declare function createStubGenerateImageTool(): ClientTool;

package/dist/src/core/tools/generateImage.js

@@ -0,0 +1,34 @@
+/**
+ * Phase-1 STUB image generation tool.
+ *
+ * In phase 1 this returns a fake task id and does NOT call the real generation
+ * endpoint or incur any media billing (per the vertical-slice scope). A later phase
+ * wires `execute` to the real `POST /ai-api/ai/{model}/task/submit` flow and the CLI
+ * task-management commands take over waiting/downloading.
+ */
+export function createStubGenerateImageTool() {
+    let counter = 0;
+    return {
+        name: 'generate_image',
+        description: 'Generate an image from a text prompt. Returns a task id; the image runs in the background.',
+        parameters: {
+            type: 'object',
+            properties: {
+                prompt: { type: 'string', description: 'What to generate' },
+                aspect_ratio: { type: 'string', description: 'e.g. 1:1, 16:9, 9:16' },
+            },
+            required: ['prompt'],
+        },
+        async execute(args) {
+            counter += 1;
+            const taskId = `stub-image-${counter}`;
+            return {
+                task_id: taskId,
+                status: 'submitted',
+                stub: true,
+                prompt: typeof args.prompt === 'string' ? args.prompt : '',
+            };
+        },
+    };
+}
+//# sourceMappingURL=generateImage.js.map

package/dist/src/core/tools/generateImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateImage.js","sourceRoot":"","sources":["../../../../src/core/tools/generateImage.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B;IACzC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,4FAA4F;QAC9F,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;gBAC3D,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;aACtE;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,OAAO,IAAI,CAAC,CAAC;YACb,MAAM,MAAM,GAAG,cAAc,OAAO,EAAE,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;aAC3D,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}