genaicode 2.6.0 → 2.8.0

package/dist/agents/session.js

@@ -0,0 +1,329 @@
+export function createAgentSession(options) {
+    const maxToolOutput = options.maxToolOutput ?? 4_000;
+    const maxTurns = options.maxTurns ?? 200;
+    let agent = options.agent;
+    let state = {
+        agent: agent.name,
+        cwd: options.cwd,
+        model: options.model,
+        effort: options.effort,
+        sessionId: options.resume,
+        status: 'idle',
+        turns: [],
+        queued: [],
+        approvals: [],
+        usage: {},
+        canSteer: false,
+    };
+    const listeners = new Set();
+    const waiting = new Map();
+    const idleWaiters = [];
+    let run;
+    let controller;
+    let nextTurnId = 1;
+    let closed = false;
+    // `options.resume` applies to the first turn as given, so an agent that cannot resume refuses it.
+    let explicitResume = options.resume;
+    // `reset()` during a turn: forget the session that turn reports when it ends.
+    let forgetAfterTurn = false;
+    // Usage of finished turns; the running turn's latest report is added on top.
+    let pastUsage = {};
+    let pastCost;
+    const set = (patch) => {
+        state = { ...state, ...patch };
+        for (const listener of [...listeners]) {
+            try {
+                listener(state);
+            }
+            catch {
+                // A failing subscriber must not break the session or other subscribers.
+            }
+        }
+    };
+    const updateTurn = (id, change) => {
+        set({ turns: state.turns.map((turn) => (turn.id === id ? change(turn) : turn)) });
+    };
+    const addEntry = (id, entry) => updateTurn(id, (turn) => ({ ...turn, entries: [...closeStreaming(turn.entries), entry] }));
+    const clip = (text) => text === undefined || text.length <= maxToolOutput ? text : `${text.slice(0, maxToolOutput)}\n… (truncated)`;
+    const onEvent = (turnId, event) => {
+        switch (event.type) {
+            case 'session':
+                if (!forgetAfterTurn)
+                    set({ sessionId: event.sessionId });
+                return;
+            case 'text-delta':
+                updateTurn(turnId, (turn) => {
+                    const last = turn.entries.at(-1);
+                    if (last?.kind === 'text' && last.streaming) {
+                        return { ...turn, entries: [...turn.entries.slice(0, -1), { ...last, text: last.text + event.text }] };
+                    }
+                    return { ...turn, entries: [...turn.entries, { kind: 'text', text: event.text, streaming: true }] };
+                });
+                return;
+            case 'message':
+                updateTurn(turnId, (turn) => {
+                    const last = turn.entries.at(-1);
+                    const entry = { kind: 'text', text: event.text, streaming: false };
+                    if (last?.kind === 'text' && last.streaming)
+                        return { ...turn, entries: [...turn.entries.slice(0, -1), entry] };
+                    return { ...turn, entries: [...turn.entries, entry] };
+                });
+                return;
+            case 'tool-start':
+                addEntry(turnId, { kind: 'tool', id: event.id, name: event.name, input: event.input, done: false });
+                return;
+            case 'tool-end':
+                updateTurn(turnId, (turn) => {
+                    const at = findOpenTool(turn.entries, event.id, event.name);
+                    const ended = { output: clip(event.output), isError: event.isError, done: true };
+                    if (at < 0) {
+                        const entry = { kind: 'tool', id: event.id, name: event.name ?? 'tool', ...ended };
+                        return { ...turn, entries: [...closeStreaming(turn.entries), entry] };
+                    }
+                    const entries = [...turn.entries];
+                    entries[at] = { ...entries[at], ...ended };
+                    return { ...turn, entries };
+                });
+                return;
+            case 'file-change':
+                addEntry(turnId, { kind: 'files', paths: event.paths });
+                return;
+            case 'approval-request':
+                // The entry is added by `onApproval`, which also holds the pending decision.
+                return;
+            case 'approval-resolved':
+                updateTurn(turnId, (turn) => ({
+                    ...turn,
+                    entries: turn.entries.map((entry) => entry.kind === 'approval' && entry.request.id === event.id ? { ...entry, decision: event.decision } : entry),
+                }));
+                return;
+            case 'usage': {
+                updateTurn(turnId, (turn) => ({
+                    ...turn,
+                    usage: event.usage,
+                    costUsd: event.costUsd ?? turn.costUsd,
+                }));
+                const turn = state.turns.find((candidate) => candidate.id === turnId);
+                set({
+                    usage: addUsage(pastUsage, turn?.usage ?? {}),
+                    costUsd: turn?.costUsd === undefined ? pastCost : (pastCost ?? 0) + turn.costUsd,
+                });
+                return;
+            }
+            case 'error':
+                addEntry(turnId, { kind: 'error', message: event.message });
+                return;
+            case 'stderr':
+            case 'raw':
+            case 'done':
+                return;
+        }
+    };
+    const onApproval = (turnId, request) => {
+        addEntry(turnId, { kind: 'approval', request });
+        const automatic = options.autoApprove?.(request);
+        if (automatic)
+            return Promise.resolve(automatic);
+        return new Promise((resolve) => {
+            waiting.set(request.id, resolve);
+            set({ approvals: [...state.approvals, request] });
+        });
+    };
+    const denyPending = () => {
+        for (const resolve of waiting.values())
+            resolve('deny');
+        waiting.clear();
+        if (state.approvals.length)
+            set({ approvals: [] });
+    };
+    const settleIdle = () => {
+        if (state.status !== 'idle' || state.queued.length)
+            return;
+        for (const resolve of idleWaiters.splice(0))
+            resolve();
+    };
+    const startTurn = (prompt) => {
+        const turnId = nextTurnId++;
+        const turn = { id: turnId, agent: agent.name, prompt, entries: [], startedAt: Date.now() };
+        const resume = explicitResume !== undefined
+            ? explicitResume
+            : state.sessionId && agent.capabilities.resume
+                ? state.sessionId
+                : undefined;
+        explicitResume = undefined;
+        const turnController = new AbortController();
+        controller = turnController;
+        set({
+            status: 'running',
+            turns: [...state.turns, turn].slice(-maxTurns),
+            canSteer: false,
+        });
+        const current = agent.run({
+            ...options.task,
+            prompt,
+            cwd: state.cwd,
+            model: state.model,
+            effort: state.effort,
+            resume,
+            signal: turnController.signal,
+            onApproval: (request) => onApproval(turnId, request),
+        });
+        run = current;
+        if (current.steer && agent.capabilities.steer)
+            set({ canSteer: true });
+        void (async () => {
+            try {
+                for await (const event of current)
+                    onEvent(turnId, event);
+            }
+            catch (error) {
+                addEntry(turnId, { kind: 'error', message: error instanceof Error ? error.message : String(error) });
+            }
+            const result = await current.result;
+            denyPending();
+            run = undefined;
+            controller = undefined;
+            updateTurn(turnId, (done) => ({
+                ...done,
+                entries: closeStreaming(done.entries),
+                result,
+                endedAt: Date.now(),
+            }));
+            const finished = state.turns.find((candidate) => candidate.id === turnId);
+            if (finished?.usage)
+                pastUsage = addUsage(pastUsage, finished.usage);
+            if (finished?.costUsd !== undefined)
+                pastCost = (pastCost ?? 0) + finished.costUsd;
+            set({ usage: pastUsage, costUsd: pastCost });
+            if (forgetAfterTurn) {
+                forgetAfterTurn = false;
+                set({ sessionId: undefined });
+            }
+            else if (result.sessionId)
+                set({ sessionId: result.sessionId });
+            const [next, ...rest] = state.queued;
+            if (next !== undefined && !closed) {
+                set({ queued: rest });
+                startTurn(next);
+            }
+            else {
+                set({ status: 'idle', canSteer: false });
+                settleIdle();
+            }
+        })();
+    };
+    return {
+        get: () => state,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        send(text) {
+            const prompt = text.trim();
+            if (!prompt || closed)
+                return;
+            if (state.status === 'idle')
+                return startTurn(prompt);
+            const current = run;
+            const turnId = state.turns.at(-1)?.id;
+            const turnController = controller;
+            if (current?.steer && state.canSteer && turnId !== undefined) {
+                addEntry(turnId, { kind: 'input', text: prompt });
+                current.steer(prompt).catch(() => {
+                    // The turn ended before the agent took the input: run it as the next turn instead,
+                    // unless the user stopped that turn.
+                    if (closed || turnController?.signal.aborted)
+                        return;
+                    set({ queued: [...state.queued, prompt] });
+                    if (state.status === 'idle') {
+                        const [next, ...rest] = state.queued;
+                        set({ queued: rest });
+                        if (next !== undefined)
+                            startTurn(next);
+                    }
+                });
+                return;
+            }
+            set({ queued: [...state.queued, prompt] });
+        },
+        stop() {
+            if (state.queued.length)
+                set({ queued: [] });
+            denyPending();
+            controller?.abort();
+            run?.abort();
+            settleIdle();
+        },
+        approve(id, decision) {
+            const resolve = waiting.get(id);
+            if (!resolve)
+                return false;
+            waiting.delete(id);
+            set({ approvals: state.approvals.filter((request) => request.id !== id) });
+            resolve(decision);
+            return true;
+        },
+        setAgent(next) {
+            if (next === agent)
+                return;
+            agent = next;
+            explicitResume = undefined;
+            if (state.status === 'running')
+                forgetAfterTurn = true;
+            set({ agent: next.name, sessionId: undefined });
+        },
+        setModel(model) {
+            set({ model });
+        },
+        reset() {
+            explicitResume = undefined;
+            if (state.status === 'running')
+                forgetAfterTurn = true;
+            set({ sessionId: undefined });
+        },
+        idle() {
+            if (state.status === 'idle' && !state.queued.length)
+                return Promise.resolve();
+            return new Promise((resolve) => idleWaiters.push(resolve));
+        },
+        close() {
+            closed = true;
+            this.stop();
+            listeners.clear();
+        },
+    };
+}
+function closeStreaming(entries) {
+    const last = entries.at(-1);
+    if (last?.kind !== 'text' || !last.streaming)
+        return entries;
+    return [...entries.slice(0, -1), { ...last, streaming: false }];
+}
+function findOpenTool(entries, id, name) {
+    for (let i = entries.length - 1; i >= 0; i -= 1) {
+        const entry = entries[i];
+        if (entry.kind !== 'tool' || entry.done)
+            continue;
+        if (id !== undefined ? entry.id === id : name === undefined || entry.name === name)
+            return i;
+    }
+    return -1;
+}
+function addUsage(total, usage) {
+    const sum = (a, b) => (a === undefined && b === undefined ? undefined : (a ?? 0) + (b ?? 0));
+    const next = {};
+    const inputTokens = sum(total.inputTokens, usage.inputTokens);
+    const outputTokens = sum(total.outputTokens, usage.outputTokens);
+    const cachedInputTokens = sum(total.cachedInputTokens, usage.cachedInputTokens);
+    const totalTokens = sum(total.totalTokens, usage.totalTokens);
+    if (inputTokens !== undefined)
+        next.inputTokens = inputTokens;
+    if (outputTokens !== undefined)
+        next.outputTokens = outputTokens;
+    if (cachedInputTokens !== undefined)
+        next.cachedInputTokens = cachedInputTokens;
+    if (totalTokens !== undefined)
+        next.totalTokens = totalTokens;
+    return next;
+}
+//# sourceMappingURL=session.js.map

package/dist/agents/session.js.map

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

package/dist/agents/types.d.ts

@@ -20,6 +20,11 @@ export interface AgentTask {
     /** Kill the agent after this many milliseconds. No timeout by default. */
     timeoutMs?: number;
     signal?: AbortSignal;
+    /**
+     * Continue an earlier agent session instead of starting a new one: the `sessionId` of a
+     * previous result (`capabilities.resume`). The agent keeps its own history of that session.
+     */
+    resume?: string;
     /** Extra CLI arguments, inserted before the prompt. */
     extraArgs?: readonly string[];
     /** MCP servers to attach for this task (`capabilities.mcp`). */
@@ -133,6 +138,8 @@ export interface AgentCapabilities {
     approvals?: boolean;
     /** Honors `AgentTask.mcpServers`. */
     mcp?: boolean;
+    /** Honors `AgentTask.resume`. */
+    resume?: boolean;
 }
 /**
  * A started task. Iterate it for events (once), or await `result` alone.

package/dist/agents.d.ts

@@ -38,3 +38,5 @@ export { createVibeParser, vibe, vibeArgs } from './agents/drivers/vibe.js';
 export type { VibeAgentOptions } from './agents/drivers/vibe.js';
 export { antigravity, antigravityArgs, createAntigravityParser } from './agents/drivers/antigravity.js';
 export type { AntigravityAgentOptions } from './agents/drivers/antigravity.js';
+export { createAgentSession } from './agents/session.js';
+export type { AgentSession, AgentSessionOptions, SessionEntry, SessionState, SessionTurn } from './agents/session.js';

package/dist/agents.js

@@ -18,4 +18,5 @@ export { hostedAgent } from './agents/hosted.js';
 export { copilot, copilotArgs, copilotMcpConfig, createCopilotParser } from './agents/drivers/copilot.js';
 export { createVibeParser, vibe, vibeArgs } from './agents/drivers/vibe.js';
 export { antigravity, antigravityArgs, createAntigravityParser } from './agents/drivers/antigravity.js';
+export { createAgentSession } from './agents/session.js';
 //# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEpF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAc5E,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAEjG,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEpF,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAE1G,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEpF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAc5E,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAEjG,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEpF,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAE1G,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAExG,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cli/args.d.ts

@@ -5,6 +5,16 @@ export type CliCommand = {
 } | {
     kind: 'agents';
     json: boolean;
+} | {
+    kind: 'chat' | 'ui';
+    agent?: string;
+    cwd?: string;
+    model?: string;
+    effort?: string;
+    resume?: string;
+    approveAll: boolean;
+    port?: number;
+    open: boolean;
 } | {
     kind: 'run';
     prompt: string | undefined;
@@ -13,6 +23,7 @@ export type CliCommand = {
     model?: string;
     effort?: string;
     maxTurns?: number;
+    resume?: string;
     timeoutMs?: number;
     verify?: string;
     maxRepairs: number;

package/dist/cli/args.js

@@ -12,6 +12,36 @@ export function parseCli(argv) {
         const { values } = parse(() => parseArgs({ args: rest, options: { json: { type: 'boolean' } }, strict: true }));
         return { kind: 'agents', json: values.json === true };
     }
+    if (command === 'chat' || command === 'ui') {
+        const { values } = parse(() => parseArgs({
+            args: rest,
+            strict: true,
+            options: {
+                agent: { type: 'string', short: 'a' },
+                cwd: { type: 'string', short: 'C' },
+                model: { type: 'string', short: 'm' },
+                effort: { type: 'string' },
+                resume: { type: 'string', short: 'r' },
+                yes: { type: 'boolean', short: 'y' },
+                ...(command === 'ui' ? { port: { type: 'string' }, 'no-open': { type: 'boolean' } } : {}),
+            },
+        }));
+        const extra = values;
+        const port = optionalNumber(extra.port, '--port');
+        if (port !== undefined && port > 65535)
+            throw new UsageError(`--port expects 0-65535, got ${port}.`);
+        return {
+            kind: command,
+            agent: values.agent,
+            cwd: values.cwd,
+            model: values.model,
+            effort: values.effort,
+            resume: values.resume,
+            approveAll: values.yes === true,
+            port,
+            open: extra['no-open'] !== true,
+        };
+    }
     if (command === 'run') {
         const { values, positionals } = parse(() => parseArgs({
             args: rest,
@@ -23,6 +53,7 @@ export function parseCli(argv) {
                 model: { type: 'string', short: 'm' },
                 effort: { type: 'string' },
                 'max-turns': { type: 'string' },
+                resume: { type: 'string', short: 'r' },
                 timeout: { type: 'string' },
                 verify: { type: 'string' },
                 'max-repairs': { type: 'string' },
@@ -39,6 +70,7 @@ export function parseCli(argv) {
             model: values.model,
             effort: values.effort,
             maxTurns: optionalNumber(values['max-turns'], '--max-turns'),
+            resume: values.resume,
             timeoutMs: timeout === undefined ? undefined : timeout * 1000,
             verify: values.verify,
             maxRepairs: optionalNumber(values['max-repairs'], '--max-repairs') ?? 2,

package/dist/cli/args.js.map

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

package/dist/cli/main.d.ts

@@ -12,9 +12,40 @@ export interface CliEnvironment {
     signal?: AbortSignal;
     /** Agents to offer. Defaults to every headless driver. */
     agents?: readonly CodingAgent[];
+    /** Both stdin and stdout are terminals: `genaicode` with no arguments opens the chat. */
+    interactive?: boolean;
+    /** Terminal streams for the chat UI. */
+    tty?: {
+        stdin: NodeJS.ReadStream;
+        stdout: NodeJS.WriteStream;
+    };
+    /** Loads the bundled chat and web front ends. Defaults to `dist/ui/index.js`. */
+    loadUi?(): Promise<UiModule>;
     /** Runs the `--verify` command. Defaults to a shell in the task directory. */
     runCheck?(command: string, cwd: string, env: NodeJS.ProcessEnv, signal?: AbortSignal): Promise<CheckResult>;
 }
+/** Options the bundled front ends take (see src/ui/index.tsx). */
+export interface UiLaunch {
+    agents: readonly CodingAgent[];
+    agent?: string;
+    cwd: string;
+    model?: string;
+    effort?: string;
+    resume?: string;
+    approveAll?: boolean;
+    env: NodeJS.ProcessEnv;
+    version: string;
+    stdout: NodeJS.WriteStream;
+    stderr: Output;
+    stdin: NodeJS.ReadStream;
+    signal?: AbortSignal;
+    port?: number;
+    open?: boolean;
+}
+export interface UiModule {
+    runChat(options: UiLaunch): Promise<number>;
+    runWeb(options: UiLaunch): Promise<number>;
+}
 export interface CheckResult {
     exitCode: number | null;
     output: string;
@@ -23,6 +54,6 @@ export declare const EXIT_OK = 0;
 export declare const EXIT_FAILED = 1;
 export declare const EXIT_USAGE = 2;
 export declare const EXIT_ABORTED = 130;
-export declare const helpText = "genaicode: run the coding-agent CLIs installed on this machine behind one interface.\n\nUsage:\n  genaicode agents [--json]            List supported agents and whether each is installed\n  genaicode run [options] <prompt...>  Run one task (reads the prompt from stdin if omitted)\n\nRun options:\n  -a, --agent <name>      Agent to use (default: the first installed one, see \"agents\")\n  -C, --cwd <dir>         Directory the agent works in (default: current directory)\n  -m, --model <id>        Model id passed to the agent CLI\n      --effort <level>    Reasoning effort, in the agent's own vocabulary\n      --max-turns <n>     Turn limit, where the agent supports one\n      --timeout <sec>     Stop the agent after this many seconds\n      --verify <command>  Shell command that checks the work; on failure its output goes\n                          back to the agent for another attempt\n      --max-repairs <n>   Repair attempts after a failed check (default 2)\n      --json              Print agent events as JSON lines instead of text\n\nThe agent uses its own login, billing, and permission defaults. GenAIcode adds no agent\nloop, prompts, or sandbox of its own. Library API: https://github.com/gtanczyk/genaicode#readme\n\nLooking for the legacy 1.x coding agent?\n  Run it:  npx genaicode@1\n  Source:  https://github.com/gtanczyk/genaicode/tree/1.x\n";
+export declare const helpText = "genaicode: run the coding-agent CLIs installed on this machine behind one interface.\n\nUsage:\n  genaicode                            Chat with an agent in this terminal (same as \"chat\")\n  genaicode chat [options]             Chat with an agent in this terminal\n  genaicode ui [options]               Chat with an agent in the browser (local server)\n  genaicode agents [--json]            List supported agents and whether each is installed\n  genaicode run [options] <prompt...>  Run one task (reads the prompt from stdin if omitted)\n\nChat and UI options:\n  -a, --agent <name>      Agent to start with (default: the first installed one)\n  -C, --cwd <dir>         Directory the agent works in (default: current directory)\n  -m, --model <id>        Model id passed to the agent CLI\n      --effort <level>    Reasoning effort, in the agent's own vocabulary\n  -r, --resume <id>       Continue this agent session\n  -y, --yes               Approve every permission request the agent asks for\n      --port <n>          (ui) Port to listen on, on 127.0.0.1 (default: a free port)\n      --no-open           (ui) Print the link instead of opening a browser\n\n  Each prompt after the first continues the agent's session (claude, codex, cursor,\n  opencode, copilot). Prompts sent while the agent works wait in a queue. Type /help in\n  the chat for commands.\n\nRun options:\n  -a, --agent <name>      Agent to use (default: the first installed one, see \"agents\")\n  -C, --cwd <dir>         Directory the agent works in (default: current directory)\n  -m, --model <id>        Model id passed to the agent CLI\n      --effort <level>    Reasoning effort, in the agent's own vocabulary\n      --max-turns <n>     Turn limit, where the agent supports one\n  -r, --resume <id>       Continue the agent session with this id (printed after each run)\n      --timeout <sec>     Stop the agent after this many seconds\n      --verify <command>  Shell command that checks the work; on failure its output goes\n                          back to the agent for another attempt\n      --max-repairs <n>   Repair attempts after a failed check (default 2)\n      --json              Print agent events as JSON lines instead of text\n\nThe agent uses its own login, billing, and permission defaults. GenAIcode adds no agent\nloop, prompts, or sandbox of its own. Library API: https://github.com/gtanczyk/genaicode#readme\n\nLooking for the legacy 1.x coding agent?\n  Run it:  npx genaicode@1\n  Source:  https://github.com/gtanczyk/genaicode/tree/1.x\n";
 /** Run the CLI and return its exit code. */
 export declare function main(cli: CliEnvironment): Promise<number>;

package/dist/cli/main.js

@@ -13,15 +13,33 @@ export const EXIT_ABORTED = 130;
 export const helpText = `genaicode: run the coding-agent CLIs installed on this machine behind one interface.
 
 Usage:
+  genaicode                            Chat with an agent in this terminal (same as "chat")
+  genaicode chat [options]             Chat with an agent in this terminal
+  genaicode ui [options]               Chat with an agent in the browser (local server)
   genaicode agents [--json]            List supported agents and whether each is installed
   genaicode run [options] <prompt...>  Run one task (reads the prompt from stdin if omitted)
 
+Chat and UI options:
+  -a, --agent <name>      Agent to start with (default: the first installed one)
+  -C, --cwd <dir>         Directory the agent works in (default: current directory)
+  -m, --model <id>        Model id passed to the agent CLI
+      --effort <level>    Reasoning effort, in the agent's own vocabulary
+  -r, --resume <id>       Continue this agent session
+  -y, --yes               Approve every permission request the agent asks for
+      --port <n>          (ui) Port to listen on, on 127.0.0.1 (default: a free port)
+      --no-open           (ui) Print the link instead of opening a browser
+
+  Each prompt after the first continues the agent's session (claude, codex, cursor,
+  opencode, copilot). Prompts sent while the agent works wait in a queue. Type /help in
+  the chat for commands.
+
 Run options:
   -a, --agent <name>      Agent to use (default: the first installed one, see "agents")
   -C, --cwd <dir>         Directory the agent works in (default: current directory)
   -m, --model <id>        Model id passed to the agent CLI
       --effort <level>    Reasoning effort, in the agent's own vocabulary
       --max-turns <n>     Turn limit, where the agent supports one
+  -r, --resume <id>       Continue the agent session with this id (printed after each run)
       --timeout <sec>     Stop the agent after this many seconds
       --verify <command>  Shell command that checks the work; on failure its output goes
                           back to the agent for another attempt
@@ -48,6 +66,9 @@ export async function main(cli) {
         return EXIT_USAGE;
     }
     const agents = cli.agents ?? defaultAgents();
+    if (command.kind === 'help' && cli.argv.length === 0 && cli.interactive) {
+        command = { kind: 'chat', approveAll: false, open: false };
+    }
     switch (command.kind) {
         case 'help':
             cli.stdout.write(helpText);
@@ -59,7 +80,41 @@ export async function main(cli) {
             return listAgents(cli, agents, command.json);
         case 'run':
             return runTask(cli, agents, command);
+        case 'chat':
+        case 'ui':
+            return runUi(cli, agents, command);
+    }
+}
+async function runUi(cli, agents, options) {
+    const tty = cli.tty ?? { stdin: process.stdin, stdout: process.stdout };
+    if (options.kind === 'chat' && !(cli.interactive ?? (tty.stdin.isTTY && tty.stdout.isTTY))) {
+        cli.stderr.write('genaicode chat needs a terminal. Use "genaicode run" for scripts, or "genaicode ui".\n');
+        return EXIT_USAGE;
     }
+    const ui = await (cli.loadUi ?? loadBundledUi)();
+    const launch = {
+        agents,
+        agent: options.agent,
+        cwd: resolve(cli.cwd, options.cwd ?? '.'),
+        model: options.model,
+        effort: options.effort,
+        resume: options.resume,
+        approveAll: options.approveAll,
+        env: cli.env,
+        version: packageVersion(),
+        stdout: tty.stdout,
+        stderr: cli.stderr,
+        stdin: tty.stdin,
+        signal: cli.signal,
+        port: options.port,
+        open: options.open,
+    };
+    return options.kind === 'chat' ? ui.runChat(launch) : ui.runWeb(launch);
+}
+/** The front ends are bundled into dist/ui by scripts/build-ui.mjs; the path is kept opaque to tsc. */
+function loadBundledUi() {
+    const bundle = new URL('../ui/index.js', import.meta.url).href;
+    return import(bundle);
 }
 function listAgents(cli, agents, json) {
     const found = detectAgents(agents, cli.env);
@@ -90,6 +145,7 @@ async function runTask(cli, agents, options) {
         model: options.model,
         effort: options.effort,
         maxTurns: options.maxTurns,
+        resume: options.resume,
         timeoutMs: options.timeoutMs,
         env: cli.env,
         signal: cli.signal,