agent-sh 0.13.6 → 0.14.0

package/dist/core/event-bus.d.ts

@@ -1,181 +1,17 @@
-import type { AgentMode } from "../agent/host-types.js";
-import type { ToolResultDisplay } from "../agent/types.js";
-/**
- * Typed event map — every event has a known payload shape.
- */
-export interface ShellEvents {
-    "shell:command-start": {
-        command: string;
-        cwd: string;
-    };
-    "shell:command-done": {
-        command: string;
-        output: string;
-        cwd: string;
-        exitCode: number | null;
-    };
-    "shell:cwd-change": {
-        cwd: string;
-    };
-    "shell:foreground-busy": {
-        busy: boolean;
-    };
-    "shell:agent-exec-start": Record<string, never>;
-    "shell:agent-exec-done": Record<string, never>;
-    "shell:pty-data": {
-        raw: string;
-    };
-    "shell:pty-write": {
-        data: string;
-    };
-    "shell:pty-resize": {
-        cols: number;
-        rows: number;
-    };
-    "shell:buffer-request": Record<string, never>;
-    "shell:buffer-snapshot": {
-        text: string;
-        altScreen: boolean;
-        cursor: {
-            x: number;
-            y: number;
-        };
-    };
-    "agent:submit": {
-        query: string;
-    };
-    "agent:cancel-request": {
-        silent?: boolean;
-    };
-    "agent:append-user-message": {
-        text: string;
-    };
-    "input-mode:register": import("../shell/host-types.js").InputModeConfig;
-    "agent:query": {
-        query: string;
-    };
-    "agent:thinking-chunk": {
-        text: string;
-    };
-    "agent:response-chunk": {
-        blocks: ContentBlock[];
-    };
-    "agent:response-done": {
-        response: string;
-    };
-    "agent:usage": {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-    "llm:request": {
-        messages: unknown[];
-        tools?: unknown;
-        model?: string;
-        max_tokens?: number;
-        reasoning_effort?: string;
-    };
-    "llm:chunk": {
-        chunk: unknown;
-    };
-    "agent:processing-start": Record<string, never>;
-    "agent:processing-done": Record<string, never>;
-    "agent:cancelled": Record<string, never>;
-    "agent:error": {
-        message: string;
-    };
-    "agent:tool-call": {
-        tool: string;
-        args: Record<string, unknown>;
-    };
-    "agent:tool-output": {
-        tool: string;
-        output: string;
-        exitCode: number | null;
-    };
-    "agent:tool-batch": {
-        groups: Array<{
-            kind: string;
-            tools: Array<{
-                name: string;
-                displayDetail?: string;
-            }>;
-        }>;
-    };
-    "agent:tool-batch-complete": {
-        results: Array<{
-            name: string;
-            isError: boolean;
-            errorSummary?: string;
-        }>;
-    };
-    "conversation:message-appended": {
-        role: "user" | "assistant" | "tool" | "system";
-        content: string;
-        /** For role="tool": name of the tool whose result this is. */
-        toolName?: string;
-        /** For role="tool": parsed arguments passed to the tool. */
-        toolArgs?: Record<string, unknown>;
-        /** For role="tool": whether the tool errored. */
-        isError?: boolean;
-    };
-    "conversation:after-compact": {
-        beforeTokens: number;
-        afterTokens: number;
-        evictedCount: number;
-    };
-    "agent:tool-started": {
-        title: string;
-        toolCallId?: string;
-        kind?: string;
-        icon?: string;
-        locations?: {
-            path: string;
-            line?: number | null;
-        }[];
-        rawInput?: unknown;
-        /** Pre-formatted display detail from tool's formatCall(). */
-        displayDetail?: string;
-        /** highlight.js-style identifier for syntax-highlighting `rawInput.source`. */
-        sourceLanguage?: string;
-        batchIndex?: number;
-        batchTotal?: number;
-    };
-    "agent:tool-completed": {
-        toolCallId?: string;
-        exitCode: number | null;
-        rawOutput?: unknown;
-        kind?: string;
-        /** Structured result display — set by formatResult or defaults, overridable via onPipe. */
-        resultDisplay?: ToolResultDisplay;
-    };
-    "agent:tool-output-chunk": {
-        chunk: string;
-    };
-    "agent:subagent-started": {
-        taskId: string;
-        task: string;
-    };
-    "agent:subagent-completed": {
-        taskId: string;
-        task: string;
-        result: string;
-        isError: boolean;
-    };
-    "tool:interactive-start": Record<string, never>;
-    "tool:interactive-end": Record<string, never>;
-    "command:register": {
-        name: string;
-        description: string;
-        handler: (args: string) => Promise<void> | void;
-    };
-    "command:unregister": {
-        name: string;
-    };
-    "command:execute": {
-        name: string;
-        args: string;
+export interface BackendRegistration {
+    name: string;
+    kill: () => void;
+    start?: () => Promise<void>;
+}
+/** Typed event map — every event has a known payload shape. */
+export interface BusEvents {
+    "core:extensions-loaded": {
+        names: string[];
     };
+    /** Cross-cutting "config might have changed, repaint" signal. */
+    "config:changed": Record<string, never>;
+    /** Universal UI feedback channel (any frontend may render; silently
+     *  ignored without one). */
     "ui:info": {
         message: string;
     };
@@ -185,196 +21,17 @@ export interface ShellEvents {
     "ui:suggestion": {
         text: string;
     };
-    "compositor:write": {
-        stream: string;
-        text: string;
-    };
-    "input:keypress": {
-        key: string;
-    };
-    "input:intercept": {
-        data: string;
-        consumed: boolean;
-    };
-    "shell:stdout-hold": Record<string, never>;
-    "shell:stdout-release": Record<string, never>;
-    "shell:stdout-show": Record<string, never>;
-    "shell:stdout-hide": Record<string, never>;
-    "agent:terminal-intercept": {
-        command: string;
-        cwd: string;
-        intercepted: boolean;
-        output: string;
-    };
-    "shell:redraw-prompt": {
-        cwd: string;
-        kind: "fresh" | "redraw";
-        handled: boolean;
-    };
-    "shell:exec-request": {
-        command: string;
-        output: string;
-        cwd: string;
-        exitCode: number | null;
-        done: boolean;
-    };
-    "agent:info": {
-        name: string;
-        version: string;
-        model?: string;
-        provider?: string;
-        contextWindow?: number;
-    };
-    "agent:reset-session": Record<string, never>;
-    "agent:compact-request": Record<string, never>;
-    "context:get-stats": {
-        activeTokens: number;
-        totalTokens: number;
-        budgetTokens: number;
-    };
-    "context:snapshot": {
-        messages: unknown[];
-        contextWindow: number;
-        activeTokens: number;
-    };
-    "context:compact": {
-        strategy?: {
-            kind: "two-tier-pin";
-            target: number;
-            keepRecent?: number;
-            force?: boolean;
-        } | {
-            kind: "rewind";
-            toIndex: number;
-        } | {
-            kind: "replace";
-            messages: unknown[];
-        };
-        stats?: {
-            before: number;
-            after: number;
-            evictedCount: number;
-        };
-    };
-    "agent:register-backend": {
-        name: string;
-        kill: () => void;
-        start?: () => Promise<void>;
-    };
-    "config:switch-backend": {
-        name: string;
-    };
-    "config:list-backends": Record<string, never>;
+    /** Backend registry — core owns these; every backend (ash, bridges)
+     *  emits register, switch/list flow through here too. */
+    "agent:register-backend": BackendRegistration;
     "config:get-backends": {
         names: string[];
         active: string | null;
     };
-    "config:changed": Record<string, never>;
-    "config:switch-model": {
-        model: string;
-    };
-    "config:get-models": {
-        models: {
-            model: string;
-            provider: string;
-        }[];
-        active: {
-            model: string;
-            provider: string;
-        } | null;
-    };
-    "config:set-thinking": {
-        level: string;
-    };
-    "config:get-thinking": {
-        level: string;
-        levels: string[];
-        supported: boolean;
-    };
-    "config:switch-provider": {
-        provider: string;
-    };
-    "config:get-initial-modes": {
-        modes: AgentMode[];
-        initialModeIndex: number;
-    };
-    "config:set-modes": {
-        modes: AgentMode[];
-        activeIndex?: number;
-    };
-    "config:add-modes": {
-        modes: AgentMode[];
-    };
-    "core:extensions-loaded": {
-        names: string[];
-    };
-    "provider:register": {
-        id: string;
-        apiKey?: string;
-        baseURL?: string;
-        /** Optional — providers for custom endpoints may not know the catalog
-         *  at registration time. Falls back to models[0] when absent. */
-        defaultModel?: string;
-        models?: (string | {
-            id: string;
-            reasoning?: boolean;
-            contextWindow?: number;
-            maxTokens?: number;
-            echoReasoning?: boolean;
-        })[];
-        /** Provider supports the reasoning_effort parameter. Default: true. */
-        supportsReasoningEffort?: boolean;
-    };
-    "provider:configure": {
-        id: string;
-        reasoningParams?: (level: string, model?: string) => Record<string, unknown>;
-    };
-    "agent:register-tool": {
-        tool: import("../agent/types.js").ToolDefinition;
-        extensionName?: string;
-    };
-    "agent:unregister-tool": {
-        name: string;
-    };
-    "agent:get-tools": {
-        tools: import("../agent/types.js").ToolDefinition[];
-    };
-    "agent:register-instruction": {
-        name: string;
-        text: string;
-        extensionName: string;
-    };
-    "agent:remove-instruction": {
-        name: string;
-    };
-    "agent:register-skill": {
-        name: string;
-        description: string;
-        filePath: string;
-        extensionName: string;
-    };
-    "agent:remove-skill": {
+    "config:switch-backend": {
         name: string;
     };
-    "banner:collect": {
-        sections: Array<{
-            label: string;
-            items: string[];
-        }>;
-        /** Name of the backend being launched. Extensions should gate per-backend sections on this rather than settings.defaultBackend. */
-        activeBackend?: string;
-    };
-    "autocomplete:request": {
-        buffer: string;
-        /** Parsed slash command name (e.g. "/backend"), or null if not a command. */
-        command: string | null;
-        /** Text after the command name (e.g. "clau" for "/backend clau"), or null. */
-        commandArgs: string | null;
-        items: {
-            name: string;
-            description: string;
-        }[];
-    };
+    "config:list-backends": Record<string, never>;
 }
 export type ContentBlock = {
     type: "text";
@@ -421,11 +78,11 @@ export declare class EventBus {
     /** Stamp + dispatch — used by every emit path. */
     private dispatch;
     /** Subscribe to a fire-and-forget event. */
-    on<K extends keyof ShellEvents>(event: K, fn: Listener<ShellEvents[K]>): void;
+    on<K extends keyof BusEvents>(event: K, fn: Listener<BusEvents[K]>): void;
     /** Unsubscribe from a fire-and-forget event. */
-    off<K extends keyof ShellEvents>(event: K, fn: Listener<ShellEvents[K]>): void;
+    off<K extends keyof BusEvents>(event: K, fn: Listener<BusEvents[K]>): void;
     /** Emit a fire-and-forget event. */
-    emit<K extends keyof ShellEvents>(event: K, payload: ShellEvents[K]): void;
+    emit<K extends keyof BusEvents>(event: K, payload: BusEvents[K]): void;
     /** Re-dispatch an event with externally-supplied meta. Used by bridges
      *  and replay tools to preserve the original source/ts/id of remote or
      *  recorded events instead of restamping them as locally originated. */
@@ -436,21 +93,21 @@ export declare class EventBus {
      * listeners (renderers). This enables content pipelines where extensions
      * modify data (e.g. render LaTeX → terminal image) before renderers see it.
      */
-    emitTransform<K extends keyof ShellEvents>(event: K, payload: ShellEvents[K]): void;
+    emitTransform<K extends keyof BusEvents>(event: K, payload: BusEvents[K]): void;
     /** Register a transform listener for a pipeline event. */
-    onPipe<K extends keyof ShellEvents>(event: K, fn: PipeListener<ShellEvents[K]>): void;
+    onPipe<K extends keyof BusEvents>(event: K, fn: PipeListener<BusEvents[K]>): void;
     /** Remove a transform listener from a pipeline event. */
-    offPipe<K extends keyof ShellEvents>(event: K, fn: PipeListener<ShellEvents[K]>): void;
+    offPipe<K extends keyof BusEvents>(event: K, fn: PipeListener<BusEvents[K]>): void;
     /**
      * Emit a pipeline event — each registered pipe listener receives the
      * output of the previous one. Returns the final transformed payload.
      * If no listeners are registered, returns the original payload unchanged.
      */
-    emitPipe<K extends keyof ShellEvents>(event: K, payload: ShellEvents[K]): ShellEvents[K];
+    emitPipe<K extends keyof BusEvents>(event: K, payload: BusEvents[K]): BusEvents[K];
     /** Remove an async transform listener from a pipeline event. */
-    offPipeAsync<K extends keyof ShellEvents>(event: K, fn: AsyncPipeListener<ShellEvents[K]>): void;
+    offPipeAsync<K extends keyof BusEvents>(event: K, fn: AsyncPipeListener<BusEvents[K]>): void;
     /** Register an async transform listener for a pipeline event. */
-    onPipeAsync<K extends keyof ShellEvents>(event: K, fn: AsyncPipeListener<ShellEvents[K]>): void;
+    onPipeAsync<K extends keyof BusEvents>(event: K, fn: AsyncPipeListener<BusEvents[K]>): void;
     /**
      * Emit an async pipeline event. Two phases:
      * 1. Notify — fire regular `on` listeners synchronously (e.g., TUI flushes state)
@@ -460,6 +117,6 @@ export declare class EventBus {
      * Returns the final transformed payload. If no pipe listeners are registered,
      * returns the original payload unchanged (with safe defaults).
      */
-    emitPipeAsync<K extends keyof ShellEvents>(event: K, payload: ShellEvents[K]): Promise<ShellEvents[K]>;
+    emitPipeAsync<K extends keyof BusEvents>(event: K, payload: BusEvents[K]): Promise<BusEvents[K]>;
 }
 export {};

package/dist/core/extension-loader.js

@@ -77,19 +77,19 @@ function createScopedContext(ctx, extensionName) {
         scopedAgent = {
             ...agent,
             registerTool: (tool) => {
-                bus.emit("agent:register-tool", { tool, extensionName });
-                cleanups.push(() => bus.emit("agent:unregister-tool", { name: tool.name }));
+                agent.registerTool(tool);
+                cleanups.push(() => agent.unregisterTool(tool.name));
             },
             adviseTool: trackUnsub(agent.adviseTool),
             adviseToolSchema: trackUnsub(agent.adviseToolSchema),
             registerInstruction: (name, text) => {
-                bus.emit("agent:register-instruction", { name, text, extensionName });
-                cleanups.push(() => bus.emit("agent:remove-instruction", { name }));
+                agent.registerInstruction(name, text);
+                cleanups.push(() => agent.removeInstruction(name));
             },
             adviseInstruction: trackUnsub(agent.adviseInstruction),
             registerSkill: (name, description, filePath) => {
-                bus.emit("agent:register-skill", { name, description, filePath, extensionName });
-                cleanups.push(() => bus.emit("agent:remove-skill", { name }));
+                agent.registerSkill(name, description, filePath);
+                cleanups.push(() => agent.removeSkill(name));
             },
             adviseSkill: trackUnsub(agent.adviseSkill),
             registerContextProducer: (name, producer, opts) => {

package/dist/core/index.d.ts

@@ -1,27 +1,17 @@
 /**
- * Core kernel — the minimum viable agent-sh.
- *
- * Wires up EventBus + HandlerRegistry without any frontend or agent backend.
- * Consumers attach their own I/O (Shell, WebSocket, REST, tests) by
- * subscribing to bus events. Shell-specific tracking lives in the
- * shell-context built-in extension.
- *
- * Agent backends register themselves via the agent:register-backend bus
- * event. The built-in "ash" backend lives in src/agent/ and is activated
- * by hosts via activateAgent().
- *
- * Usage:
- *   import { createCore } from "agent-sh";
- *   const core = createCore({ apiKey: "...", model: "gpt-4o" });
- *   core.bus.on("agent:response-chunk", ({ blocks }) => { ... });
- *   core.activateBackend();
- *   const response = await core.query("hello");
+ * Core kernel — EventBus + HandlerRegistry + backend registry. Knows
+ * nothing about LLMs, tools, or specific backends; backends (ash,
+ * claude-code-bridge, ...) register through `agent:register-backend`
+ * and core dispatches to whichever is configured as default.
  */
 import { EventBus } from "./event-bus.js";
+import "../shell/events.js";
+import "../agent/events.js";
+import "../extensions/slash-commands/events.js";
 import type { AppConfig, ExtensionContext } from "../shell/host-types.js";
 import { HandlerRegistry } from "../utils/handler-registry.js";
 export { EventBus } from "./event-bus.js";
-export type { ShellEvents, ContentBlock } from "./event-bus.js";
+export type { BusEvents, ContentBlock, BackendRegistration } from "./event-bus.js";
 export type { CoreContext, CoreConfig } from "./types.js";
 export type { AgentContext, AgentConfig, AgentSurface, AgentConfigSurface, AgentMode, LlmInterface, LlmMessage, LlmSession } from "../agent/host-types.js";
 export type { ShellContext, ShellConfig, ShellSurface, ShellConfigSurface, ExtensionContext, RemoteSession, RemoteSessionOptions, RenderSurface, InputModeConfig, TerminalSession, BlockTransformOptions, FencedBlockTransformOptions, AppConfig } from "../shell/host-types.js";
@@ -29,29 +19,20 @@ export { palette, setPalette, resetPalette } from "../utils/palette.js";
 export type { ColorPalette } from "../utils/palette.js";
 export type { AgentBackend, ToolDefinition } from "../agent/types.js";
 export { runSubagent, type SubagentOptions } from "../agent/subagent.js";
-export { LlmClient } from "../utils/llm-client.js";
+export { LlmClient } from "../agent/llm-client.js";
 export { HistoryFile, InMemoryHistory, NoopHistory, type HistoryAdapter } from "../agent/history-file.js";
 export type { NuclearEntry } from "../agent/nuclear-form.js";
 export { compileSearchRegex, matchEntry, formatNuclearLine } from "../agent/nuclear-form.js";
 export interface AgentShellCore {
     bus: EventBus;
-    /** Handler registry for define/advise/call. */
     handlers: HandlerRegistry;
     /** Unique id for this agent process; used for shell-marker tagging and lineage tracking. */
     instanceId: string;
-    /** Activate the agent backend (call after extensions load). */
+    /** Activates a registered backend by name (or persisted default / first registered). */
     activateBackend(override?: string): Promise<void>;
-    /** Convenience: emit agent:submit and await the response. */
-    query(text: string): Promise<string>;
-    /** Convenience: emit agent:cancel-request. */
-    cancel(): void;
-    /** Convenience: emit agent:append-user-message. */
-    appendUserMessage(text: string): void;
-    /** Build an ExtensionContext for loading extensions against this core. */
     extensionContext(opts: {
         quit: () => void;
     }): ExtensionContext;
-    /** Tear down the agent and clean up. */
     kill(): void;
 }
 export declare function createCore(config: AppConfig): AgentShellCore;