@jait/gateway 0.1.0

package/dist/surfaces/terminal.js

@@ -0,0 +1,271 @@
+/**
+ * Terminal Surface — uses bun-pty directly.
+ *
+ * Each TerminalSurface owns a persistent interactive PTY shell process
+ * (viewable in the frontend via xterm.js + WebSocket).
+ *
+ * Shell integration:
+ * On start, sources an integration script that hooks into the shell's
+ * prompt lifecycle and emits OSC 633 escape sequences (same protocol as
+ * VS Code's terminal shell integration).  This lets us detect command
+ * boundaries, exit codes, and CWD changes without wrapping commands.
+ */
+import { platform } from "node:os";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+import { createRequire } from "node:module";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+function spawnPty(shell, shellArgs, opts) {
+    // Bun runtime path
+    if (typeof Bun !== "undefined") {
+        const bunPty = require("bun-pty");
+        return bunPty.spawn(shell, shellArgs, opts);
+    }
+    // Node/Vitest fallback path
+    const nodePty = require("node-pty");
+    return nodePty.spawn(shell, shellArgs, opts);
+}
+/** Directory containing shell integration scripts */
+const SHELL_INTEGRATION_DIR = join(__dirname, "shell-integration");
+function defaultShell() {
+    if (platform() === "win32") {
+        // Prefer PowerShell 7 (pwsh) over Windows PowerShell 5.1 (powershell)
+        // pwsh supports modern escape sequences and PSReadLine features
+        try {
+            execSync("pwsh.exe -v", { stdio: "ignore", timeout: 3000 });
+            return "pwsh.exe";
+        }
+        catch {
+            return "powershell.exe";
+        }
+    }
+    return process.env["SHELL"] ?? "/bin/bash";
+}
+/** Detect which integration script to source based on the shell binary */
+function shellIntegrationScript(shell) {
+    const name = shell.toLowerCase().replace(/\.exe$/, "");
+    if (name.includes("pwsh") || name.includes("powershell")) {
+        return { path: join(SHELL_INTEGRATION_DIR, "pwsh.ps1"), type: "pwsh" };
+    }
+    if (name.includes("zsh")) {
+        return { path: join(SHELL_INTEGRATION_DIR, "zsh.sh"), type: "zsh" };
+    }
+    if (name.includes("bash") || name.includes("sh")) {
+        return { path: join(SHELL_INTEGRATION_DIR, "bash.sh"), type: "bash" };
+    }
+    return null;
+}
+export class TerminalSurface {
+    id;
+    type = "terminal";
+    _state = "idle";
+    _sessionId = null;
+    _startedAt = null;
+    _cwd = null;
+    _pid = null;
+    _pty = null;
+    _outputBuffer = [];
+    _cols;
+    _rows;
+    shell;
+    extraEnv;
+    _outputListeners = [];
+    /** Whether the OSC 633 shell integration has emitted its first prompt (B marker) */
+    _shellIntegrationReady = false;
+    _shellIntegrationReadyResolve;
+    _shellIntegrationReadyPromise;
+    /** External callbacks (wired by index.ts / routes) */
+    onOutput;
+    onStateChange;
+    onExit;
+    constructor(id, opts = {}) {
+        this.id = id;
+        this.shell = opts.shell ?? defaultShell();
+        this._cols = opts.cols ?? 120;
+        this._rows = opts.rows ?? 30;
+        this.extraEnv = opts.env ?? {};
+        this._shellIntegrationReadyPromise = new Promise((resolve) => {
+            this._shellIntegrationReadyResolve = resolve;
+        });
+    }
+    get state() {
+        return this._state;
+    }
+    get sessionId() {
+        return this._sessionId;
+    }
+    get pid() {
+        return this._pid ?? undefined;
+    }
+    /** True once the shell has emitted at least one OSC 633;B prompt-end marker */
+    get shellIntegrationReady() {
+        return this._shellIntegrationReady;
+    }
+    /** Resolves when the shell integration prompt is first ready (or after a timeout fallback) */
+    waitForPrompt(timeoutMs = 5000) {
+        if (this._shellIntegrationReady)
+            return Promise.resolve();
+        return Promise.race([
+            this._shellIntegrationReadyPromise,
+            new Promise((r) => setTimeout(r, timeoutMs)),
+        ]);
+    }
+    async start(input) {
+        if (this._state === "running")
+            return;
+        this._setState("starting");
+        this._sessionId = input.sessionId;
+        this._cwd = input.workspaceRoot;
+        this._startedAt = new Date().toISOString();
+        try {
+            const integration = shellIntegrationScript(this.shell);
+            // Build shell args — inject our integration script
+            let shellArgs;
+            if (integration?.type === "pwsh") {
+                // PowerShell: -NoExit -File <script> runs the script then stays interactive
+                shellArgs = ["-NoExit", "-File", integration.path];
+            }
+            else if (integration?.type === "bash") {
+                shellArgs = ["--rcfile", integration.path];
+            }
+            else if (integration?.type === "zsh") {
+                // zsh: source our script via ZDOTDIR override is complex —
+                // instead we'll source it after spawn via write()
+                shellArgs = [];
+            }
+            else {
+                shellArgs = platform() === "win32" ? ["-NoProfile"] : [];
+            }
+            const pty = spawnPty(this.shell, shellArgs, {
+                name: "xterm-256color",
+                cols: this._cols,
+                rows: this._rows,
+                cwd: input.workspaceRoot,
+                env: { ...process.env, TERM: "xterm-256color", ...this.extraEnv },
+            });
+            this._pty = pty;
+            this._pid = pty.pid;
+            // Wire PTY output → surface listeners + buffer
+            // Also watch for OSC 633;B to know when prompt is ready
+            pty.onData((data) => {
+                this._outputBuffer.push(data);
+                if (this._outputBuffer.length > 10000) {
+                    this._outputBuffer = this._outputBuffer.slice(-5000);
+                }
+                // Detect shell integration prompt-end marker
+                if (!this._shellIntegrationReady && data.includes("\x1b]633;B")) {
+                    this._shellIntegrationReady = true;
+                    this._shellIntegrationReadyResolve?.();
+                }
+                this.onOutput?.(data);
+                for (const listener of this._outputListeners) {
+                    listener(data);
+                }
+            });
+            // Wire PTY exit
+            pty.onExit((event) => {
+                this._pid = null;
+                this._pty = null;
+                this._setState("stopped");
+                this.onExit?.(event.exitCode, event.signal);
+            });
+            this._setState("running");
+            // For zsh: source integration after the shell starts
+            if (integration?.type === "zsh") {
+                setTimeout(() => {
+                    this.write(`source '${integration.path}'\n`);
+                }, 300);
+            }
+        }
+        catch (err) {
+            this._setState("error");
+            throw err;
+        }
+    }
+    async stop(_input) {
+        if (!this._pty) {
+            this._setState("stopped");
+            return;
+        }
+        this._setState("stopping");
+        try {
+            this._pty.kill();
+        }
+        catch {
+            // already dead
+        }
+        this._pty = null;
+        this._pid = null;
+        this._setState("stopped");
+    }
+    /** Write raw data to the PTY (user keyboard input from frontend) */
+    write(data) {
+        if (this._state !== "running" || !this._pty)
+            return;
+        try {
+            this._pty.write(data);
+        }
+        catch (err) {
+            console.error(`PTY write error (${this.id}):`, err);
+        }
+    }
+    /** Resize the PTY */
+    resize(cols, rows) {
+        if (!this._pty || this._state !== "running")
+            return;
+        this._cols = cols;
+        this._rows = rows;
+        try {
+            this._pty.resize(cols, rows);
+        }
+        catch (err) {
+            console.error(`PTY resize error (${this.id}):`, err);
+        }
+    }
+    /** Add an output listener (used by terminal.run to mirror output) */
+    addOutputListener(listener) {
+        this._outputListeners.push(listener);
+    }
+    /** Remove an output listener */
+    removeOutputListener(listener) {
+        const idx = this._outputListeners.indexOf(listener);
+        if (idx !== -1)
+            this._outputListeners.splice(idx, 1);
+    }
+    snapshot() {
+        return {
+            id: this.id,
+            type: this.type,
+            state: this._state,
+            sessionId: this._sessionId ?? "",
+            startedAt: this._startedAt ?? undefined,
+            metadata: {
+                shell: this.shell,
+                cols: this._cols,
+                rows: this._rows,
+                pid: this._pid ?? null,
+                cwd: this._cwd,
+            },
+        };
+    }
+    getRecentOutput(lines = 100) {
+        return this._outputBuffer.slice(-lines).join("");
+    }
+    _setState(s) {
+        this._state = s;
+        this.onStateChange?.(s);
+    }
+}
+export class TerminalSurfaceFactory {
+    type = "terminal";
+    opts;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    create(id) {
+        return new TerminalSurface(id, this.opts);
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/surfaces/terminal.js.map

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

package/dist/tools/agent-loop.d.ts

@@ -0,0 +1,302 @@
+/**
+ * Agent Loop — reusable, streamable tool-calling loop.
+ *
+ * Extracted from chat.ts and enhanced with:
+ *  - Input validation (catches bad LLM args immediately)
+ *  - Parallel tool execution (independent calls run concurrently)
+ *  - Retry for individual failed tool calls
+ *  - Steering (inject guidance mid-loop)
+ *  - Tool call queueing with priority
+ *
+ * Both the main chat route and the agent.spawn sub-agent tool use this.
+ */
+import type { ToolResult } from "./contracts.js";
+import type { ToolRegistry } from "./registry.js";
+import { type ChatMode, type PlannedAction } from "./chat-modes.js";
+/** Wire format for a single OpenAI tool call */
+export interface OpenAIToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** A chat message in the conversation history */
+export interface AgentMessage {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    tool_calls?: OpenAIToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+/** Segment for interleaved rendering of text and tool calls */
+export type MessageSegment = {
+    type: "text";
+    content: string;
+} | {
+    type: "toolGroup";
+    callIds: string[];
+};
+/** OpenAI function-calling tool schema */
+export interface OpenAIToolSchema {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: unknown;
+    };
+}
+/** LLM connection config */
+export interface LLMConfig {
+    openaiApiKey: string;
+    openaiBaseUrl: string;
+    openaiModel: string;
+    /** Max context window in tokens */
+    contextWindow: number;
+}
+/** Persisted record of a tool call execution */
+export interface ExecutedToolCall {
+    callId: string;
+    tool: string;
+    args: unknown;
+    ok: boolean;
+    message: string;
+    data?: unknown;
+    startedAt: number;
+    completedAt: number;
+    /** Number of times this call was retried */
+    retryCount?: number;
+}
+/** Events emitted during the loop */
+export type AgentLoopEvent = {
+    type: "token";
+    content: string;
+} | {
+    type: "tool_call_delta";
+    call_id: string;
+    index: number;
+    name_delta?: string;
+    args_delta?: string;
+} | {
+    type: "tool_start";
+    tool: string;
+    args: unknown;
+    call_id: string;
+} | {
+    type: "tool_output";
+    call_id: string;
+    content: string;
+} | {
+    type: "tool_result";
+    call_id: string;
+    tool: string;
+    ok: boolean;
+    message: string;
+    data?: unknown;
+} | {
+    type: "tool_retry";
+    call_id: string;
+    attempt: number;
+    maxAttempts: number;
+} | {
+    type: "tool_validation_error";
+    call_id: string;
+    tool: string;
+    errors: string[];
+} | {
+    type: "steering";
+    message: string;
+} | {
+    type: "plan_action";
+    action: PlannedAction;
+} | {
+    type: "plan_complete";
+    planId: string;
+    summary: string;
+    actions: PlannedAction[];
+} | {
+    type: "mode_notice";
+    mode: ChatMode;
+    message: string;
+} | {
+    type: "todo_list";
+    items: {
+        id: number;
+        title: string;
+        status: "not-started" | "in-progress" | "completed";
+    }[];
+} | {
+    type: "context_usage";
+    system: number;
+    history: number;
+    toolResults: number;
+    tools: number;
+    total: number;
+    limit: number;
+    ratio: number;
+    pruned?: boolean;
+} | {
+    type: "error";
+    message: string;
+};
+/** Priority levels for queued tool calls */
+export declare enum ToolCallPriority {
+    /** Run before anything else (e.g. abort-checks, validation) */
+    Critical = 0,
+    /** Normal tool calls from the LLM */
+    Normal = 1,
+    /** Deferred / low-priority background work */
+    Low = 2
+}
+/** A queued tool call entry */
+export interface QueuedToolCall {
+    toolCall: OpenAIToolCall;
+    priority: ToolCallPriority;
+    /** If true, this call can run in parallel with other parallel-safe calls */
+    parallelSafe: boolean;
+}
+/** Options for the agent loop */
+export interface AgentLoopOptions {
+    /** LLM connection settings */
+    llm: LLMConfig;
+    /** The conversation history (mutated in place) */
+    history: AgentMessage[];
+    /** OpenAI tool schemas to send to the model */
+    toolSchemas: OpenAIToolSchema[];
+    /** Whether tools are available */
+    hasTools: boolean;
+    /** Session identifier (for logging / events) */
+    sessionId: string;
+    /** Auth context for tool execution */
+    auth?: {
+        userId?: string;
+        apiKeys?: Record<string, string>;
+    };
+    /** Abort controller — abort to cancel the loop */
+    abort: AbortController;
+    /** Max tool-calling rounds before stopping */
+    maxRounds?: number;
+    /** Max retries per individual tool call failure (0 = no retry) */
+    maxRetries?: number;
+    /** Enable parallel execution of independent tool calls */
+    parallel?: boolean;
+    /** Tool registry for input validation (optional — skips validation if absent) */
+    toolRegistry?: ToolRegistry;
+    /** Optional filter: only allow these tool names (for sub-agents) */
+    allowedTools?: Set<string>;
+    /** User-disabled tools (never sent to LLM, never executed) */
+    disabledTools?: Set<string>;
+    /** Chat mode: ask (read-only), agent (full), or plan (propose then execute) */
+    mode?: ChatMode;
+    /** Logger (defaults to console) */
+    log?: Logger;
+    /** Event callback — called for every stream event */
+    onEvent?: (event: AgentLoopEvent) => void;
+    /** Persistence callback — called when a final assistant message should be saved */
+    onPersist?: (sessionId: string, role: string, content: string, toolCalls?: string, segments?: string) => void;
+}
+export interface AgentLoopResult {
+    content: string;
+    executedToolCalls: ExecutedToolCall[];
+    /** Interleaved text/toolGroup segments for rendering */
+    segments: MessageSegment[];
+    /** Total LLM rounds used */
+    rounds: number;
+    /** Whether the loop was stopped by abort */
+    aborted: boolean;
+    /** Whether the loop was stopped because it hit the max rounds limit */
+    hitMaxRounds: boolean;
+    /** Plan data — only populated in plan mode */
+    plan?: {
+        id: string;
+        summary: string;
+        actions: PlannedAction[];
+    };
+}
+export interface Logger {
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string | unknown, ...args: unknown[]): void;
+}
+/**
+ * Steering lets the user (or system) inject guidance into the agent
+ * loop while it's running. The steered message gets appended to the
+ * conversation as a system message before the next LLM call.
+ */
+export declare class SteeringController {
+    private queue;
+    /** Inject a steering message into the loop */
+    steer(message: string): void;
+    /** Drain all pending steering messages (called by the loop) */
+    drain(): string[];
+    get hasPending(): boolean;
+}
+/**
+ * Priority queue for tool calls. Sorts by priority (lower = first),
+ * then partitions into parallel-safe batches.
+ */
+export declare class ToolCallQueue {
+    private items;
+    /** Enqueue a tool call with optional priority and parallelism hint */
+    enqueue(toolCall: OpenAIToolCall, priority?: ToolCallPriority, parallelSafe?: boolean): void;
+    /** Enqueue multiple tool calls at the same priority */
+    enqueueAll(toolCalls: OpenAIToolCall[], priority?: ToolCallPriority, parallelSafe?: boolean): void;
+    /**
+     * Dequeue the next batch. If parallel execution is enabled, returns
+     * all contiguous parallel-safe items at the same priority level.
+     * Otherwise returns one at a time.
+     */
+    dequeueBatch(allowParallel: boolean): QueuedToolCall[];
+    get length(): number;
+    get isEmpty(): boolean;
+}
+/** OpenAI requires function names to match ^[a-zA-Z0-9_-]+$ — no dots */
+export declare function toOpenAIName(name: string): string;
+export declare function fromOpenAIName(name: string): string;
+export declare function serializeMessages(messages: AgentMessage[]): Record<string, unknown>[];
+export declare function buildToolSchemas(registry: ToolRegistry, allowedTools?: Set<string>): OpenAIToolSchema[];
+/**
+ * Build schemas respecting tiers and user disabled tools.
+ *
+ * Only "core" and "standard" (non-disabled) tools are included in the
+ * initial payload. External / MCP tools must be discovered via tools.search.
+ */
+export declare function buildTieredToolSchemas(registry: ToolRegistry, disabledTools?: Set<string>): OpenAIToolSchema[];
+/**
+ * Convert individual tool definitions into OpenAI schemas.
+ * Used to dynamically inject schemas discovered via tools.search.
+ */
+export declare function toolDefsToSchemas(defs: Array<{
+    name: string;
+    description: string;
+    parameters: unknown;
+}>): OpenAIToolSchema[];
+interface ParsedStream {
+    contentText: string;
+    toolCalls: OpenAIToolCall[];
+    finishReason: string | null;
+}
+export declare function parseOpenAIStream(reader: ReadableStreamDefaultReader<Uint8Array>, onEvent?: (event: AgentLoopEvent) => void): Promise<ParsedStream>;
+export type ToolExecutor = (name: string, args: unknown, sessionId: string, auth?: {
+    userId?: string;
+    apiKeys?: Record<string, string>;
+}, onChunk?: (chunk: string) => void, signal?: AbortSignal) => Promise<ToolResult>;
+export declare function runAgentLoop(options: AgentLoopOptions, executeTool: ToolExecutor, steering?: SteeringController): Promise<AgentLoopResult>;
+/**
+ * Retry a specific failed tool call by its callId.
+ *
+ * This re-executes the tool with its original arguments, updates the
+ * conversation history in-place (replaces the old tool result message),
+ * and returns the new result.
+ *
+ * Designed to be called from a REST endpoint like:
+ *   POST /api/sessions/:sessionId/retry-tool
+ *   { callId: "call_abc123" }
+ */
+export declare function retryToolCall(callId: string, history: AgentMessage[], executedToolCalls: ExecutedToolCall[], executeTool: ToolExecutor, sessionId: string, auth?: {
+    userId?: string;
+    apiKeys?: Record<string, string>;
+}, onEvent?: (event: AgentLoopEvent) => void, signal?: AbortSignal): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/tools/agent-loop.d.ts.map

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