@glbgpt/cli 0.1.0-test.1

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

@@ -0,0 +1,31 @@
+import type { ChatBackend, EngineEvent } from './types.js';
+import type { Session } from './session.js';
+import type { ToolRegistry } from './toolRegistry.js';
+export type Emit = (event: EngineEvent) => void;
+/** Per-turn options. `exec --output-schema` passes a `response_format` value here. */
+export interface TurnOptions {
+    responseFormat?: unknown;
+    /** Abort signal for user interruption (Esc in the TUI). */
+    signal?: AbortSignal;
+}
+/**
+ * Drives one user turn to completion, following the OpenAI tool-calling protocol:
+ *
+ *   stream model call -> accumulate assistant text + tool_calls
+ *     -> if tool_calls: run each tool locally, append results, stream again
+ *     -> else: turn complete
+ *
+ * The model's "intelligence loop" lives here on the client; the backend only streams
+ * one model call at a time. Image/video tools execute locally (via the registry) and
+ * return e.g. a task id, which is fed back so the conversation can continue.
+ */
+export declare class TurnLoop {
+    private readonly backend;
+    private readonly registry;
+    constructor(backend: ChatBackend, registry: ToolRegistry);
+    runTurn(session: Session, userContent: string | import('./types.js').ContentPart[], emit: Emit, opts?: TurnOptions): Promise<void>;
+    /** Stream a single model call, emitting text deltas and accumulating tool_calls. */
+    private streamOneCall;
+    /** Iterate the backend stream, forwarding deltas/usage and accumulating tool-call pieces. */
+    private consumeStream;
+}

package/dist/src/core/turnLoop.js

@@ -0,0 +1,155 @@
+/** Safety cap on tool-calling rounds within a single user turn. */
+const MAX_ROUNDS = 8;
+/**
+ * Drives one user turn to completion, following the OpenAI tool-calling protocol:
+ *
+ *   stream model call -> accumulate assistant text + tool_calls
+ *     -> if tool_calls: run each tool locally, append results, stream again
+ *     -> else: turn complete
+ *
+ * The model's "intelligence loop" lives here on the client; the backend only streams
+ * one model call at a time. Image/video tools execute locally (via the registry) and
+ * return e.g. a task id, which is fed back so the conversation can continue.
+ */
+export class TurnLoop {
+    backend;
+    registry;
+    constructor(backend, registry) {
+        this.backend = backend;
+        this.registry = registry;
+    }
+    async runTurn(session, userContent, emit, opts = {}) {
+        session.addUserMessage(userContent);
+        for (let round = 0; round < MAX_ROUNDS; round++) {
+            let content;
+            let toolCalls;
+            try {
+                ({ content, toolCalls } = await this.streamOneCall(session, emit, opts));
+            }
+            catch (err) {
+                // User interruption (Esc): keep whatever partial text already streamed so the
+                // conversation history matches what the user saw, then end the turn quietly.
+                if (opts.signal?.aborted) {
+                    const partial = partialContentOf(err);
+                    if (partial)
+                        session.addAssistantMessage(partial, []);
+                    emit({ type: 'turn_interrupted' });
+                    return;
+                }
+                throw err;
+            }
+            // A call that produced neither text nor tool calls is a failure, not a completed turn
+            // (e.g. an upstream that closed the stream early). Don't record an empty assistant
+            // message and don't pretend the turn succeeded.
+            if (content.length === 0 && toolCalls.length === 0) {
+                emit({ type: 'error', message: 'The model returned no output. Please try again.' });
+                return;
+            }
+            session.addAssistantMessage(content.length > 0 ? content : null, toolCalls);
+            if (toolCalls.length === 0) {
+                emit({ type: 'turn_complete' });
+                return;
+            }
+            // Execute each requested tool locally and feed results back into the conversation.
+            // Tool execution itself is never aborted mid-flight (a paid submit must not be torn),
+            // but an interrupt takes effect before the next model call.
+            for (const call of toolCalls) {
+                const args = safeParseArgs(call.function.arguments);
+                emit({ type: 'tool_call_begin', id: call.id, name: call.function.name, args });
+                const result = await this.registry.dispatch(call.function.name, call.function.arguments);
+                emit({ type: 'tool_call_end', id: call.id, name: call.function.name, result });
+                session.addToolMessage(call.id, call.function.name, result);
+            }
+            if (opts.signal?.aborted) {
+                emit({ type: 'turn_interrupted' });
+                return;
+            }
+            // Loop: stream again now that tool results are in the messages.
+        }
+        emit({ type: 'error', message: `Turn exceeded ${MAX_ROUNDS} tool-calling rounds` });
+    }
+    /** Stream a single model call, emitting text deltas and accumulating tool_calls. */
+    async streamOneCall(session, emit, opts) {
+        const req = {
+            model: session.model,
+            messages: session.messages,
+            tools: this.registry.toOpenAITools(),
+            stream: true,
+            ...(opts.responseFormat !== undefined ? { response_format: opts.responseFormat } : {}),
+        };
+        let content = '';
+        const toolAcc = new Map();
+        try {
+            await this.consumeStream(req, opts, emit, (text) => (content += text), toolAcc);
+        }
+        catch (err) {
+            // Attach the partial text so an interrupt can preserve what already streamed.
+            if (opts.signal?.aborted)
+                throw new InterruptedStreamError(content);
+            throw err;
+        }
+        const toolCalls = [...toolAcc.entries()]
+            .sort((a, b) => a[0] - b[0])
+            .map(([, e]) => ({
+            id: e.id,
+            type: 'function',
+            function: { name: e.name, arguments: e.args },
+        }))
+            .filter((c) => c.function.name.length > 0);
+        return { content, toolCalls };
+    }
+    /** Iterate the backend stream, forwarding deltas/usage and accumulating tool-call pieces. */
+    async consumeStream(req, opts, emit, onText, toolAcc) {
+        for await (const chunk of this.backend.stream(req, opts.signal)) {
+            // The final chunk (include_usage) carries token counts with empty/no choices; surface
+            // them before the delta guard below skips it.
+            if (chunk.usage) {
+                emit({
+                    type: 'usage',
+                    promptTokens: chunk.usage.prompt_tokens ?? 0,
+                    completionTokens: chunk.usage.completion_tokens ?? 0,
+                });
+            }
+            const choice = chunk.choices?.[0];
+            const delta = choice?.delta;
+            if (!delta)
+                continue;
+            if (typeof delta.content === 'string' && delta.content.length > 0) {
+                onText(delta.content);
+                emit({ type: 'assistant_delta', text: delta.content });
+            }
+            if (delta.tool_calls) {
+                for (const tc of delta.tool_calls) {
+                    const entry = toolAcc.get(tc.index) ?? { id: '', name: '', args: '' };
+                    if (tc.id)
+                        entry.id = tc.id;
+                    if (tc.function?.name)
+                        entry.name = tc.function.name;
+                    if (tc.function?.arguments)
+                        entry.args += tc.function.arguments;
+                    toolAcc.set(tc.index, entry);
+                }
+            }
+        }
+    }
+}
+/** Thrown when the user aborts mid-stream; carries the text streamed so far. */
+class InterruptedStreamError extends Error {
+    partialContent;
+    constructor(partialContent) {
+        super('Interrupted');
+        this.partialContent = partialContent;
+    }
+}
+function partialContentOf(err) {
+    return err instanceof InterruptedStreamError ? err.partialContent : '';
+}
+function safeParseArgs(raw) {
+    try {
+        return raw && raw.trim() ? JSON.parse(raw) : {};
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=turnLoop.js.map

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

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

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

@@ -0,0 +1,137 @@
+/**
+ * Core domain types for the glbgpt CLI chat engine.
+ *
+ * The chat backend speaks the OpenAI-compatible chat/completions protocol
+ * (see backend `/ai-api/cli/v1/chat/completions`). The CLI owns the turn loop
+ * and the client-side tools; the backend is a stateless streaming passthrough.
+ */
+/** One part of a multimodal user message (OpenAI content-parts shape). */
+export type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+    };
+};
+/** OpenAI-compatible chat message. */
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    /**
+     * Text content, or content parts for a multimodal user message (vision).
+     * Null/undefined for an assistant message that only carries tool_calls.
+     */
+    content?: string | ContentPart[] | null;
+    /** Present on assistant messages that request tool calls. */
+    tool_calls?: ToolCall[];
+    /** Present on `tool` messages: which tool call this result answers. */
+    tool_call_id?: string;
+    /** Optional name (used by some tool messages). */
+    name?: string;
+}
+/** A single tool call requested by the model. */
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        /** JSON-encoded arguments string (may arrive in streamed pieces). */
+        arguments: string;
+    };
+}
+/** A streaming chunk in the OpenAI chat.completion.chunk shape (only the fields we consume). */
+export interface ChatChunk {
+    choices?: Array<{
+        delta?: {
+            role?: string;
+            content?: string | null;
+            tool_calls?: Array<{
+                index: number;
+                id?: string;
+                type?: string;
+                function?: {
+                    name?: string;
+                    arguments?: string;
+                };
+            }>;
+        };
+        finish_reason?: string | null;
+    }>;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+    } | null;
+}
+/** Request sent to the chat backend for one streamed model call. */
+export interface ChatRequest {
+    model: string;
+    messages: ChatMessage[];
+    tools?: OpenAITool[];
+    tool_choice?: unknown;
+    stream: true;
+    /**
+     * OpenAI `response_format`. Forwarded verbatim by the backend to the upstream provider
+     * (raw-body passthrough). `exec --output-schema` sets a `json_schema` value here.
+     */
+    response_format?: unknown;
+    /** OpenAI streaming options (e.g. `{ include_usage: true }`). */
+    stream_options?: {
+        include_usage?: boolean;
+    };
+}
+/** OpenAI tool definition (function calling). */
+export interface OpenAITool {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+/**
+ * A client-side tool the model can call. Its `execute` runs locally in the CLI
+ * (e.g. submitting an image generation task), and the returned value is fed back
+ * to the model as the `tool` message content.
+ */
+export interface ClientTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<ToolResult>;
+}
+/** Result of running a client tool. Serialized to JSON as the tool message content. */
+export type ToolResult = Record<string, unknown>;
+/**
+ * Typed events emitted by the engine. Both the TUI and `exec` front-ends
+ * consume the same event stream, so their behavior stays consistent.
+ */
+export type EngineEvent = {
+    type: 'assistant_delta';
+    text: string;
+} | {
+    type: 'tool_call_begin';
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: 'tool_call_end';
+    id: string;
+    name: string;
+    result: ToolResult;
+} | {
+    type: 'usage';
+    promptTokens: number;
+    completionTokens: number;
+} | {
+    type: 'turn_complete';
+} | {
+    type: 'turn_interrupted';
+} | {
+    type: 'error';
+    message: string;
+};
+/** The chat backend abstraction: yields parsed OpenAI chunks for one model call. */
+export interface ChatBackend {
+    stream(req: ChatRequest, signal?: AbortSignal): AsyncIterable<ChatChunk>;
+}

package/dist/src/core/types.js

@@ -0,0 +1,9 @@
+/**
+ * Core domain types for the glbgpt CLI chat engine.
+ *
+ * The chat backend speaks the OpenAI-compatible chat/completions protocol
+ * (see backend `/ai-api/cli/v1/chat/completions`). The CLI owns the turn loop
+ * and the client-side tools; the backend is a stateless streaming passthrough.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/src/exec/input.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Input assembly for `glbgpt exec`: prompt/stdin resolution, `--file` context injection,
+ * and `--output-schema` loading. Kept free of process/network concerns so it is unit-testable;
+ * stdin, file reads, and the TTY check are injected.
+ */
+/** A user/input error. The caller maps this to a stderr message + exit code 1. */
+export declare class UsageError extends Error {
+}
+export interface PromptSources {
+    /** The positional PROMPT arg, if any. The literal `-` forces reading from stdin. */
+    positional?: string;
+    /** Whether stdin is a TTY (interactive) rather than piped. */
+    stdinIsTty: boolean;
+    /** Read all of stdin as a string. Called at most once. */
+    readStdin: () => Promise<string>;
+}
+/**
+ * Resolve the prompt text following the exec stdin contract:
+ * - positional `-`            → stdin is the prompt (forced).
+ * - positional + piped stdin  → stdin appended as a `<stdin>` block.
+ * - positional + TTY stdin    → positional only.
+ * - no positional + piped     → stdin is the prompt.
+ * - no positional + TTY       → UsageError.
+ */
+export declare function resolvePromptText(src: PromptSources): Promise<string>;
+/**
+ * Append each `--file` as a `<file path="...">…</file>` block to the prompt. Reading is injected
+ * for tests; a read failure raises UsageError (unreadable input is a user error, exit 1).
+ */
+export declare function injectFiles(base: string, files: string[], readFile?: (p: string) => Promise<string>): Promise<string>;
+/**
+ * Load a JSON Schema file and wrap it as an OpenAI `response_format` value. A missing file or
+ * invalid JSON is a UsageError (exit 1). `strict: true` asks the provider to enforce the schema.
+ */
+export declare function loadOutputSchema(schemaPath: string, readFile?: (p: string) => Promise<string>): Promise<unknown>;

package/dist/src/exec/input.js

@@ -0,0 +1,85 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+/**
+ * Input assembly for `glbgpt exec`: prompt/stdin resolution, `--file` context injection,
+ * and `--output-schema` loading. Kept free of process/network concerns so it is unit-testable;
+ * stdin, file reads, and the TTY check are injected.
+ */
+/** A user/input error. The caller maps this to a stderr message + exit code 1. */
+export class UsageError extends Error {
+}
+const NO_PROMPT = 'No prompt provided. Either specify one as an argument or pipe the prompt into stdin.';
+/**
+ * Resolve the prompt text following the exec stdin contract:
+ * - positional `-`            → stdin is the prompt (forced).
+ * - positional + piped stdin  → stdin appended as a `<stdin>` block.
+ * - positional + TTY stdin    → positional only.
+ * - no positional + piped     → stdin is the prompt.
+ * - no positional + TTY       → UsageError.
+ */
+export async function resolvePromptText(src) {
+    const positional = src.positional?.trim() ? src.positional : src.positional === '-' ? '-' : undefined;
+    if (positional === '-') {
+        const stdin = (await src.readStdin()).trim();
+        if (!stdin)
+            throw new UsageError(NO_PROMPT);
+        return stdin;
+    }
+    if (positional) {
+        if (!src.stdinIsTty) {
+            const stdin = (await src.readStdin()).trim();
+            if (stdin)
+                return `${positional}\n\n<stdin>\n${stdin}\n</stdin>`;
+        }
+        return positional;
+    }
+    if (src.stdinIsTty)
+        throw new UsageError(NO_PROMPT);
+    const stdin = (await src.readStdin()).trim();
+    if (!stdin)
+        throw new UsageError(NO_PROMPT);
+    return stdin;
+}
+/**
+ * Append each `--file` as a `<file path="...">…</file>` block to the prompt. Reading is injected
+ * for tests; a read failure raises UsageError (unreadable input is a user error, exit 1).
+ */
+export async function injectFiles(base, files, readFile = (p) => fs.readFile(p, 'utf8')) {
+    if (files.length === 0)
+        return base;
+    const blocks = [];
+    for (const file of files) {
+        let content;
+        try {
+            content = await readFile(file);
+        }
+        catch (err) {
+            throw new UsageError(`Cannot read --file ${file}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        blocks.push(`<file path="${path.basename(file)}">\n${content}\n</file>`);
+    }
+    return `${base}\n\n${blocks.join('\n\n')}`;
+}
+/**
+ * Load a JSON Schema file and wrap it as an OpenAI `response_format` value. A missing file or
+ * invalid JSON is a UsageError (exit 1). `strict: true` asks the provider to enforce the schema.
+ */
+export async function loadOutputSchema(schemaPath, readFile = (p) => fs.readFile(p, 'utf8')) {
+    let raw;
+    try {
+        raw = await readFile(schemaPath);
+    }
+    catch (err) {
+        throw new UsageError(`Cannot read --output-schema ${schemaPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let schema;
+    try {
+        schema = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new UsageError(`--output-schema ${schemaPath} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const name = path.basename(schemaPath).replace(/\.json$/i, '').replace(/[^a-zA-Z0-9_-]/g, '_') || 'output';
+    return { type: 'json_schema', json_schema: { name, strict: true, schema } };
+}
+//# sourceMappingURL=input.js.map

package/dist/src/exec/input.js.map

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

package/dist/src/exec/output.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Output emitters for `glbgpt exec`. Three modes share one accumulator:
+ * - `text`  (default): the final message as plain text on stdout.
+ * - `json`           : a single final result object on stdout.
+ * - `jsonl`          : streaming protocol events, one JSON per line, on stdout.
+ *
+ * In every mode stdout carries only the result/events; progress and diagnostics go to stderr.
+ * The write sinks are injected so tests can capture output without touching process streams.
+ */
+export type OutputMode = 'text' | 'json' | 'jsonl';
+export interface OutputSinks {
+    out: (s: string) => void;
+    err: (s: string) => void;
+}
+export interface ExecUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+}
+export declare class ExecOutput {
+    private readonly mode;
+    private readonly model;
+    private readonly sinks;
+    private content;
+    private usage;
+    constructor(mode: OutputMode, model: string, sinks: OutputSinks);
+    /** Emitted once before streaming (jsonl only). */
+    start(): void;
+    /** An assistant text delta. */
+    delta(text: string): void;
+    /** Token usage from the final stream chunk. */
+    usageEvent(promptTokens: number, completionTokens: number): void;
+    /** Successful completion. `structured` is the parsed object when --output-schema was used. */
+    finishResult(structured: unknown | null): void;
+    /** Turn failed. Keeps the active output structure and returns via a non-zero exit upstream. */
+    finishError(message: string): void;
+    /** Accumulated assistant text (used to write the --output-last-message file). */
+    getContent(): string;
+    private line;
+}

package/dist/src/exec/output.js

@@ -0,0 +1,84 @@
+/**
+ * Output emitters for `glbgpt exec`. Three modes share one accumulator:
+ * - `text`  (default): the final message as plain text on stdout.
+ * - `json`           : a single final result object on stdout.
+ * - `jsonl`          : streaming protocol events, one JSON per line, on stdout.
+ *
+ * In every mode stdout carries only the result/events; progress and diagnostics go to stderr.
+ * The write sinks are injected so tests can capture output without touching process streams.
+ */
+export class ExecOutput {
+    mode;
+    model;
+    sinks;
+    content = '';
+    usage = { prompt_tokens: 0, completion_tokens: 0 };
+    constructor(mode, model, sinks) {
+        this.mode = mode;
+        this.model = model;
+        this.sinks = sinks;
+    }
+    /** Emitted once before streaming (jsonl only). */
+    start() {
+        if (this.mode === 'jsonl')
+            this.line({ type: 'turn_started', model: this.model });
+    }
+    /** An assistant text delta. */
+    delta(text) {
+        if (!text)
+            return;
+        this.content += text;
+        if (this.mode === 'jsonl')
+            this.line({ type: 'delta', text });
+    }
+    /** Token usage from the final stream chunk. */
+    usageEvent(promptTokens, completionTokens) {
+        this.usage = { prompt_tokens: promptTokens, completion_tokens: completionTokens };
+        if (this.mode === 'jsonl') {
+            this.line({ type: 'usage', prompt_tokens: promptTokens, completion_tokens: completionTokens });
+        }
+    }
+    /** Successful completion. `structured` is the parsed object when --output-schema was used. */
+    finishResult(structured) {
+        if (this.mode === 'text') {
+            if (this.content)
+                this.sinks.out(this.content.endsWith('\n') ? this.content : `${this.content}\n`);
+            return;
+        }
+        this.line({
+            type: 'result',
+            model: this.model,
+            content: this.content,
+            structured,
+            usage: this.usage,
+            error: null,
+        });
+    }
+    /** Turn failed. Keeps the active output structure and returns via a non-zero exit upstream. */
+    finishError(message) {
+        if (this.mode === 'json') {
+            this.line({
+                type: 'result',
+                model: this.model,
+                content: this.content,
+                structured: null,
+                usage: this.usage,
+                error: { message },
+            });
+        }
+        else if (this.mode === 'jsonl') {
+            this.line({ type: 'error', message });
+        }
+        else {
+            this.sinks.err(`${message}\n`);
+        }
+    }
+    /** Accumulated assistant text (used to write the --output-last-message file). */
+    getContent() {
+        return this.content;
+    }
+    line(obj) {
+        this.sinks.out(`${JSON.stringify(obj)}\n`);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/src/exec/output.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};