@bytespell/amux 0.0.11 → 0.0.13

package/dist/state.js

@@ -0,0 +1,250 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+/**
+ * Default state directory
+ */
+const DEFAULT_STATE_DIR = path.join(os.homedir(), '.local', 'state', 'amux');
+/**
+ * State manager for amux sessions.
+ * Handles persistence of session state and history.
+ */
+export class StateManager {
+    stateDir;
+    constructor(stateDir) {
+        this.stateDir = stateDir ?? DEFAULT_STATE_DIR;
+    }
+    /**
+     * Get the state file path for a specific instance
+     */
+    getStateFilePath(instanceId) {
+        return path.join(this.stateDir, `instance-${instanceId}.json`);
+    }
+    /**
+     * Get history file path for a session
+     */
+    getHistoryPath(sessionId) {
+        return path.join(this.stateDir, `session-${sessionId}-history.json`);
+    }
+    /**
+     * Get sessions registry file path
+     */
+    getSessionsRegistryPath() {
+        return path.join(this.stateDir, 'sessions.json');
+    }
+    /**
+     * Load persisted session state
+     */
+    loadState(instanceId) {
+        console.log('[amux] Loading state for instance:', instanceId);
+        try {
+            const stateFile = this.getStateFilePath(instanceId);
+            if (fs.existsSync(stateFile)) {
+                const data = JSON.parse(fs.readFileSync(stateFile, 'utf-8'));
+                console.log('[amux] Loaded persisted state:', JSON.stringify(data));
+                return data;
+            }
+        }
+        catch (err) {
+            console.log('[amux] Failed to load persisted state:', err.message);
+        }
+        return {};
+    }
+    /**
+     * Save session state to disk
+     */
+    saveState(instanceId, state) {
+        try {
+            fs.mkdirSync(this.stateDir, { recursive: true });
+            const stateFile = this.getStateFilePath(instanceId);
+            fs.writeFileSync(stateFile, JSON.stringify(state, null, 2));
+        }
+        catch (err) {
+            console.log('[amux] Failed to save state:', err.message);
+        }
+    }
+    /**
+     * Store event to history for replay
+     */
+    storeEvent(sessionId, event) {
+        if (!sessionId)
+            return;
+        // Only store session updates and turn markers
+        const isSessionUpdate = event.type === 'session_update';
+        const isTurnMarker = event.type === 'turn_start' || event.type === 'turn_end';
+        if (!isSessionUpdate && !isTurnMarker) {
+            return;
+        }
+        try {
+            fs.mkdirSync(this.stateDir, { recursive: true });
+            const historyFile = this.getHistoryPath(sessionId);
+            let events = [];
+            if (fs.existsSync(historyFile)) {
+                const data = fs.readFileSync(historyFile, 'utf-8');
+                events = JSON.parse(data);
+            }
+            events.push(event);
+            fs.writeFileSync(historyFile, JSON.stringify(events));
+        }
+        catch (err) {
+            console.log('[amux] Failed to store event:', err.message);
+        }
+    }
+    /**
+     * Load history for replay
+     */
+    loadHistory(sessionId) {
+        if (!sessionId)
+            return [];
+        try {
+            const historyFile = this.getHistoryPath(sessionId);
+            if (fs.existsSync(historyFile)) {
+                const data = fs.readFileSync(historyFile, 'utf-8');
+                return JSON.parse(data);
+            }
+        }
+        catch (err) {
+            console.log('[amux] Failed to load history:', err.message);
+        }
+        return [];
+    }
+    /**
+     * Clear history for a session
+     */
+    clearHistory(sessionId) {
+        if (!sessionId)
+            return;
+        try {
+            const historyFile = this.getHistoryPath(sessionId);
+            if (fs.existsSync(historyFile)) {
+                fs.unlinkSync(historyFile);
+            }
+        }
+        catch (err) {
+            console.log('[amux] Failed to clear history:', err.message);
+        }
+    }
+    /**
+     * Load sessions registry
+     */
+    loadSessionsRegistry() {
+        try {
+            const registryPath = this.getSessionsRegistryPath();
+            if (fs.existsSync(registryPath)) {
+                const data = fs.readFileSync(registryPath, 'utf-8');
+                return JSON.parse(data);
+            }
+        }
+        catch (err) {
+            console.log('[amux] Failed to load sessions registry:', err.message);
+        }
+        return { sessions: [] };
+    }
+    /**
+     * Save sessions registry
+     */
+    saveSessionsRegistry(registry) {
+        try {
+            fs.mkdirSync(this.stateDir, { recursive: true });
+            const registryPath = this.getSessionsRegistryPath();
+            fs.writeFileSync(registryPath, JSON.stringify(registry, null, 2));
+        }
+        catch (err) {
+            console.log('[amux] Failed to save sessions registry:', err.message);
+        }
+    }
+    /**
+     * Register a new session or update existing one
+     */
+    registerSession(sessionId, cwd, agentType, displayName) {
+        const registry = this.loadSessionsRegistry();
+        const existingIndex = registry.sessions.findIndex(s => s.id === sessionId);
+        const session = {
+            id: sessionId,
+            name: displayName || `Session ${sessionId.slice(0, 8)}`,
+            cwd,
+            messageCount: 0,
+            lastModified: Date.now(),
+            agentType,
+        };
+        if (existingIndex >= 0) {
+            // Update existing session, preserve message count
+            const existing = registry.sessions[existingIndex];
+            session.messageCount = existing?.messageCount ?? 0;
+            registry.sessions[existingIndex] = session;
+        }
+        else {
+            // Add new session at the beginning (most recent first)
+            registry.sessions.unshift(session);
+        }
+        this.saveSessionsRegistry(registry);
+        console.log(`[amux] Registered session: ${sessionId}`);
+    }
+    /**
+     * Update session metadata
+     */
+    updateSessionMetadata(sessionId, updates) {
+        const registry = this.loadSessionsRegistry();
+        const session = registry.sessions.find(s => s.id === sessionId);
+        if (session) {
+            if (updates.messageCount !== undefined) {
+                session.messageCount = updates.messageCount;
+            }
+            if (updates.lastModified !== undefined) {
+                session.lastModified = updates.lastModified;
+            }
+            if (updates.name !== undefined) {
+                session.name = updates.name;
+            }
+            this.saveSessionsRegistry(registry);
+        }
+    }
+    /**
+     * Increment message count for a session
+     */
+    incrementSessionMessageCount(sessionId) {
+        const registry = this.loadSessionsRegistry();
+        const session = registry.sessions.find(s => s.id === sessionId);
+        if (session) {
+            session.messageCount += 1;
+            session.lastModified = Date.now();
+            this.saveSessionsRegistry(registry);
+        }
+    }
+    /**
+     * List all sessions, optionally filtered by cwd
+     */
+    listSessions(cwd) {
+        const registry = this.loadSessionsRegistry();
+        let sessions = registry.sessions;
+        // Filter by cwd if provided
+        if (cwd) {
+            sessions = sessions.filter(s => s.cwd === cwd);
+        }
+        // Sort by lastModified (most recent first)
+        sessions.sort((a, b) => b.lastModified - a.lastModified);
+        return sessions;
+    }
+    /**
+     * Get a specific session by ID
+     */
+    getSession(sessionId) {
+        const registry = this.loadSessionsRegistry();
+        return registry.sessions.find(s => s.id === sessionId);
+    }
+    /**
+     * Delete a session from the registry and its history
+     */
+    deleteSession(sessionId) {
+        const registry = this.loadSessionsRegistry();
+        const index = registry.sessions.findIndex(s => s.id === sessionId);
+        if (index >= 0) {
+            registry.sessions.splice(index, 1);
+            this.saveSessionsRegistry(registry);
+        }
+        // Also clear the history file
+        this.clearHistory(sessionId);
+        console.log(`[amux] Deleted session: ${sessionId}`);
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/terminal.d.ts

@@ -0,0 +1,47 @@
+import { type ChildProcess } from 'child_process';
+import type * as acp from '@agentclientprotocol/sdk';
+/**
+ * Terminal state tracking
+ */
+export interface TerminalState {
+    process: ChildProcess;
+    output: string;
+    exitCode: number | null;
+    signal: string | null;
+    truncated: boolean;
+    outputByteLimit: number;
+}
+/**
+ * Manages terminal processes for ACP terminal capability.
+ * Handles spawning, output collection, and lifecycle management.
+ */
+export declare class TerminalManager {
+    private defaultCwd;
+    private terminals;
+    constructor(defaultCwd: () => string);
+    /**
+     * Create a new terminal process
+     */
+    create(params: acp.CreateTerminalRequest): acp.CreateTerminalResponse;
+    /**
+     * Get terminal output
+     */
+    getOutput(terminalId: string): acp.TerminalOutputResponse;
+    /**
+     * Wait for terminal to exit
+     */
+    waitForExit(terminalId: string): Promise<acp.WaitForTerminalExitResponse>;
+    /**
+     * Kill a terminal process
+     */
+    kill(terminalId: string): acp.KillTerminalCommandResponse;
+    /**
+     * Release a terminal (cleanup)
+     */
+    release(terminalId: string): acp.ReleaseTerminalResponse;
+    /**
+     * Kill all terminals (for shutdown)
+     */
+    killAll(): void;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,SAAS,CAAoC;gBAEjC,UAAU,EAAE,MAAM,MAAM;IAE5C;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC,sBAAsB;IAqDrE;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,sBAAsB;IAezD;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;IAyB/E;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,2BAA2B;IASzD;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,uBAAuB;IAWxD;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/dist/terminal.js

@@ -0,0 +1,137 @@
+import { spawn } from 'child_process';
+import crypto from 'crypto';
+/**
+ * Manages terminal processes for ACP terminal capability.
+ * Handles spawning, output collection, and lifecycle management.
+ */
+export class TerminalManager {
+    defaultCwd;
+    terminals = new Map();
+    constructor(defaultCwd) {
+        this.defaultCwd = defaultCwd;
+    }
+    /**
+     * Create a new terminal process
+     */
+    create(params) {
+        console.log('[amux] Create terminal:', params.command);
+        const terminalId = crypto.randomUUID();
+        const outputByteLimit = Number(params.outputByteLimit ?? 1024 * 1024); // Default 1MB
+        const termProc = spawn(params.command, params.args ?? [], {
+            cwd: params.cwd ?? this.defaultCwd(),
+            env: params.env
+                ? { ...process.env, ...Object.fromEntries(params.env.map(e => [e.name, e.value])) }
+                : process.env,
+            shell: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const terminal = {
+            process: termProc,
+            output: '',
+            exitCode: null,
+            signal: null,
+            truncated: false,
+            outputByteLimit,
+        };
+        const appendOutput = (data) => {
+            terminal.output += data.toString();
+            // Truncate from beginning if over limit
+            if (terminal.output.length > terminal.outputByteLimit) {
+                terminal.output = terminal.output.slice(-terminal.outputByteLimit);
+                terminal.truncated = true;
+            }
+        };
+        termProc.stdout?.on('data', appendOutput);
+        termProc.stderr?.on('data', appendOutput);
+        termProc.on('exit', (code, signal) => {
+            console.log(`[amux] Terminal ${terminalId} exited with code ${code}, signal ${signal}`);
+            terminal.exitCode = code ?? null;
+            terminal.signal = signal ?? null;
+        });
+        termProc.on('error', (err) => {
+            console.error(`[amux] Terminal ${terminalId} error:`, err.message);
+            terminal.output += `\nError: ${err.message}`;
+            terminal.exitCode = -1;
+        });
+        this.terminals.set(terminalId, terminal);
+        console.log(`[amux] Created terminal ${terminalId} for command: ${params.command}`);
+        return { terminalId };
+    }
+    /**
+     * Get terminal output
+     */
+    getOutput(terminalId) {
+        const terminal = this.terminals.get(terminalId);
+        if (!terminal) {
+            throw new Error(`Terminal ${terminalId} not found`);
+        }
+        return {
+            output: terminal.output,
+            truncated: terminal.truncated,
+            exitStatus: terminal.exitCode !== null || terminal.signal !== null ? {
+                exitCode: terminal.exitCode,
+                signal: terminal.signal,
+            } : undefined,
+        };
+    }
+    /**
+     * Wait for terminal to exit
+     */
+    async waitForExit(terminalId) {
+        const terminal = this.terminals.get(terminalId);
+        if (!terminal) {
+            throw new Error(`Terminal ${terminalId} not found`);
+        }
+        // If already exited, return immediately
+        if (terminal.exitCode !== null || terminal.signal !== null) {
+            return {
+                exitCode: terminal.exitCode,
+                signal: terminal.signal,
+            };
+        }
+        // Wait for exit
+        return new Promise((resolve) => {
+            terminal.process.on('exit', (code, signal) => {
+                resolve({
+                    exitCode: code ?? null,
+                    signal: signal ?? null,
+                });
+            });
+        });
+    }
+    /**
+     * Kill a terminal process
+     */
+    kill(terminalId) {
+        const terminal = this.terminals.get(terminalId);
+        if (!terminal) {
+            throw new Error(`Terminal ${terminalId} not found`);
+        }
+        terminal.process.kill('SIGTERM');
+        return {};
+    }
+    /**
+     * Release a terminal (cleanup)
+     */
+    release(terminalId) {
+        const terminal = this.terminals.get(terminalId);
+        if (terminal) {
+            if (terminal.exitCode === null) {
+                terminal.process.kill('SIGKILL');
+            }
+            this.terminals.delete(terminalId);
+        }
+        return {};
+    }
+    /**
+     * Kill all terminals (for shutdown)
+     */
+    killAll() {
+        for (const [terminalId, terminal] of this.terminals) {
+            console.log(`[amux] Killing terminal ${terminalId}`);
+            terminal.process.kill('SIGKILL');
+        }
+        this.terminals.clear();
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

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

package/dist/types.d.ts

@@ -1,2 +1,64 @@
-export { A as AcpEvent, h as AcpLifecycleEvent, E as Emit, L as LifecycleEvent, g as ModeInfo, M as ModelInfo, N as NormalizedPlanEntry, P as PendingPermission, S as StartStreamArgs, i as StreamEvent, a as StreamHandle, b as StreamPayload, T as TerminalEvent, k as isAcpEvent, l as isAcpLifecycleEvent, j as isLifecycleEvent, m as isTerminalEvent, n as normalizePlanEntry } from './types-DCRtrjjj.js';
-export { PlanEntry as AcpPlanEntry, AudioContent, AvailableCommand, AvailableCommandsUpdate, ContentBlock, ContentChunk, CurrentModeUpdate, EmbeddedResource, ImageContent, PermissionOption, Plan, PlanEntryPriority, PlanEntryStatus, RequestPermissionRequest, RequestPermissionResponse, ResourceLink, SessionUpdate, TextContent, ToolCall, ToolCallStatus, ToolCallUpdate } from '@agentclientprotocol/sdk';
+import type * as acp from '@agentclientprotocol/sdk';
+/**
+ * Agent configuration - maps agent type to binary name
+ */
+export interface AgentConfig {
+    name: string;
+    bin: string;
+}
+/**
+ * Built-in agent registry
+ */
+export declare const AGENTS: Record<string, AgentConfig>;
+/**
+ * Session metadata for persistence
+ */
+export interface SessionMetadata {
+    id: string;
+    name: string;
+    cwd: string;
+    messageCount: number;
+    lastModified: number;
+    agentType: string;
+}
+/**
+ * Persisted session state
+ */
+export interface SessionState {
+    cwd?: string;
+    sessionId?: string | null;
+    agentType?: string;
+}
+/**
+ * Event stored in history for replay
+ */
+export interface StoredEvent {
+    type: string;
+    update?: acp.SessionUpdate;
+    [key: string]: unknown;
+}
+/**
+ * Session restore info sent to UI
+ */
+export interface SessionRestoreInfo {
+    restored: boolean;
+    reason?: string;
+}
+/**
+ * Configuration for creating an agent session
+ */
+export interface AgentSessionConfig {
+    /** Unique identifier for this session instance */
+    instanceId: string;
+    /** Base path for resolving agent binaries (node_modules/.bin) */
+    basePath: string;
+    /** Optional system context to inject (e.g., from a markdown file) */
+    systemContext?: string;
+    /** Optional fixed working directory (overrides user selection) */
+    fixedCwd?: string;
+    /** Optional initial agent type (defaults to 'claude-code') */
+    agentType?: string;
+    /** Optional state directory override */
+    stateDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAa9C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IAEnB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IAEjB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -1,33 +1,18 @@
-// src/types.ts
-function normalizePlanEntry(entry) {
-  const meta = entry._meta;
-  const claudeCode = meta?.claudeCode;
-  const activeForm = claudeCode?.activeForm;
-  const directActiveForm = entry.activeForm;
-  return {
-    content: entry.content,
-    status: entry.status,
-    priority: entry.priority,
-    activeForm: activeForm ?? directActiveForm
-  };
-}
-function isLifecycleEvent(payload) {
-  return payload.eventType === "ready" || payload.eventType === "error" || payload.eventType === "stopped";
-}
-function isAcpEvent(payload) {
-  return payload.eventType === "acp";
-}
-function isAcpLifecycleEvent(payload) {
-  return typeof payload.eventType === "string" && payload.eventType.startsWith("acp:");
-}
-function isTerminalEvent(payload) {
-  return typeof payload.eventType === "string" && payload.eventType.startsWith("terminal:");
-}
-export {
-  isAcpEvent,
-  isAcpLifecycleEvent,
-  isLifecycleEvent,
-  isTerminalEvent,
-  normalizePlanEntry
+/**
+ * Built-in agent registry
+ */
+export const AGENTS = {
+    'claude-code': {
+        name: 'Claude Code',
+        bin: 'claude-code-acp',
+    },
+    'codex': {
+        name: 'Codex',
+        bin: 'codex-acp',
+    },
+    'pi': {
+        name: 'Pi',
+        bin: 'pi-acp',
+    },
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// Re-export ACP types from SDK\nexport type {\n  SessionUpdate,\n  ContentBlock,\n  ContentChunk,\n  TextContent,\n  ImageContent,\n  AudioContent,\n  EmbeddedResource,\n  ResourceLink,\n  PlanEntry as AcpPlanEntry,\n  PlanEntryPriority,\n  PlanEntryStatus,\n  Plan,\n  AvailableCommand,\n  AvailableCommandsUpdate,\n  CurrentModeUpdate,\n  ToolCall,\n  ToolCallUpdate,\n  ToolCallStatus,\n  PermissionOption,\n  RequestPermissionRequest,\n  RequestPermissionResponse,\n} from '@agentclientprotocol/sdk';\n\nimport type { PlanEntry as AcpPlanEntry, PlanEntryPriority, PlanEntryStatus, SessionUpdate } from '@agentclientprotocol/sdk';\n\n/**\n * Normalized PlanEntry that handles agent-specific quirks.\n *\n * Standard ACP: content, priority, status\n * Claude-style: content, status, activeForm (priority always \"medium\")\n *\n * The `activeForm` field provides a present-tense description (e.g., \"Analyzing tests\")\n * vs the imperative `content` (e.g., \"Analyze tests\"). When `activeForm` is present\n * and the status is \"in_progress\", UI should prefer displaying `activeForm`.\n */\nexport interface NormalizedPlanEntry {\n  content: string;\n  status: PlanEntryStatus;\n  priority: PlanEntryPriority;\n  /** Present-tense form for in_progress display (Claude-style). */\n  activeForm?: string;\n}\n\n/**\n * Normalize an incoming ACP plan entry.\n * Extracts `activeForm` from Claude's `_meta.claudeCode` extension if present.\n */\nexport function normalizePlanEntry(entry: AcpPlanEntry): NormalizedPlanEntry {\n  // Try to extract activeForm from _meta.claudeCode (if claude-acp sends it there)\n  const meta = entry._meta as Record<string, unknown> | undefined;\n  const claudeCode = meta?.claudeCode as Record<string, unknown> | undefined;\n  const activeForm = claudeCode?.activeForm as string | undefined;\n\n  // Also check if activeForm is directly on the entry (non-standard but possible)\n  const directActiveForm = (entry as Record<string, unknown>).activeForm as string | undefined;\n\n  return {\n    content: entry.content,\n    status: entry.status,\n    priority: entry.priority,\n    activeForm: activeForm ?? directActiveForm,\n  };\n}\n\n// Model and mode info returned from stream session\nexport interface ModelInfo {\n  modelId: string;\n  name: string;\n}\n\nexport interface ModeInfo {\n  id: string;\n  name: string;\n  description?: string;\n}\n\n// Permission types for WebSocket push\nexport interface PendingPermission {\n  requestId: string;\n  toolCallId?: string;\n  title: string;\n  options: Array<{ optionId: string; name: string; kind: string }>;\n}\n\n// ============================================================================\n// Generic Event System\n//\n// All events have an `eventType` discriminant. Known events are typed precisely;\n// plugins use the generic escape hatch { eventType: string; [key: string]: unknown }.\n// ============================================================================\n\n/**\n * Universal lifecycle events that ALL drivers should emit.\n */\nexport type LifecycleEvent =\n  | { eventType: 'ready' }\n  | { eventType: 'error'; message: string }\n  | { eventType: 'stopped' };\n\n/**\n * ACP session update events (from ACP driver).\n * Wraps the ACP SessionUpdate with eventType discriminant.\n */\nexport type AcpEvent = { eventType: 'acp' } & SessionUpdate;\n\n/**\n * ACP-specific lifecycle events (turns, permissions).\n * Only the ACP driver emits these.\n */\nexport type AcpLifecycleEvent =\n  | { eventType: 'acp:turn_start' }\n  | { eventType: 'acp:turn_end' }\n  | { eventType: 'acp:turn_cancelled' }\n  | { eventType: 'acp:permission_request'; permission: PendingPermission }\n  | { eventType: 'acp:permission_cleared' };\n\n/**\n * Terminal events (from PTY/shell driver).\n */\nexport type TerminalEvent =\n  | { eventType: 'terminal:output'; data: string }\n  | { eventType: 'terminal:exit'; exitCode: number | null; signal: string | null };\n\n/**\n * All known event types, plus a generic escape hatch for plugins.\n * Plugins can emit { eventType: 'my-plugin:custom', ...data } and renderers\n * can handle them with type narrowing.\n */\nexport type StreamPayload =\n  | LifecycleEvent\n  | AcpEvent\n  | AcpLifecycleEvent\n  | TerminalEvent\n  | { eventType: string; [key: string]: unknown };\n\n/**\n * StreamEvent = payload with metadata stamped at emission time.\n */\nexport type StreamEvent = StreamPayload & {\n  streamId: string;\n  timestamp: number;\n};\n\n/**\n * Emit callback type for library consumers.\n */\nexport type Emit = (event: StreamEvent) => void;\n\n// Type guard helpers\nexport function isLifecycleEvent(payload: StreamPayload): payload is LifecycleEvent {\n  return payload.eventType === 'ready' || payload.eventType === 'error' || payload.eventType === 'stopped';\n}\n\nexport function isAcpEvent(payload: StreamPayload): payload is AcpEvent {\n  return payload.eventType === 'acp';\n}\n\nexport function isAcpLifecycleEvent(payload: StreamPayload): payload is AcpLifecycleEvent {\n  return typeof payload.eventType === 'string' && payload.eventType.startsWith('acp:');\n}\n\nexport function isTerminalEvent(payload: StreamPayload): payload is TerminalEvent {\n  return typeof payload.eventType === 'string' && payload.eventType.startsWith('terminal:');\n}\n\n// Handle returned from startStream for the caller to use\nexport interface StreamHandle {\n  streamId: string;\n  stream: import('./streams/backends/types.js').Stream;\n  /** Driver type that handled this stream */\n  driverType: string;\n}\n\n// Arguments for starting a stream\nexport interface StartStreamArgs {\n  streamId: string;\n  /** Driver type to route to (e.g., 'acp', 'pty', or custom plugin types) */\n  driverType: string;\n  config: import('./streams/backends/types.js').StreamConfig;\n  cwd: string;\n  restoredState?: unknown;\n  emit: Emit;\n  /** Directory for driver to store persistent data (e.g. history.json) */\n  storageDir: string;\n}\n"],"mappings":";AAiDO,SAAS,mBAAmB,OAA0C;AAE3E,QAAM,OAAO,MAAM;AACnB,QAAM,aAAa,MAAM;AACzB,QAAM,aAAa,YAAY;AAG/B,QAAM,mBAAoB,MAAkC;AAE5D,SAAO;AAAA,IACL,SAAS,MAAM;AAAA,IACf,QAAQ,MAAM;AAAA,IACd,UAAU,MAAM;AAAA,IAChB,YAAY,cAAc;AAAA,EAC5B;AACF;AAuFO,SAAS,iBAAiB,SAAmD;AAClF,SAAO,QAAQ,cAAc,WAAW,QAAQ,cAAc,WAAW,QAAQ,cAAc;AACjG;AAEO,SAAS,WAAW,SAA6C;AACtE,SAAO,QAAQ,cAAc;AAC/B;AAEO,SAAS,oBAAoB,SAAsD;AACxF,SAAO,OAAO,QAAQ,cAAc,YAAY,QAAQ,UAAU,WAAW,MAAM;AACrF;AAEO,SAAS,gBAAgB,SAAkD;AAChF,SAAO,OAAO,QAAQ,cAAc,YAAY,QAAQ,UAAU,WAAW,WAAW;AAC1F;","names":[]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAgC;IACjD,aAAa,EAAE;QACb,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,iBAAiB;KACvB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,WAAW;KACjB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,QAAQ;KACd;CACF,CAAC"}

package/dist/ws-adapter.d.ts

@@ -0,0 +1,39 @@
+import { WebSocketServer } from 'ws';
+import type { AgentSession } from './session.js';
+/**
+ * Options for the WebSocket adapter
+ */
+export interface WsAdapterOptions {
+    /**
+     * Send history on connect (default: true)
+     */
+    sendHistoryOnConnect?: boolean;
+}
+/**
+ * Create a WebSocket adapter for an AgentSession.
+ *
+ * Bridges session events to WebSocket clients and handles incoming messages.
+ *
+ * @example
+ * ```typescript
+ * import { AgentSession } from 'amux';
+ * import { createWsAdapter } from 'amux/ws';
+ * import { WebSocketServer } from 'ws';
+ *
+ * const session = new AgentSession({ ... });
+ * const wss = new WebSocketServer({ server, path: '/ws' });
+ *
+ * createWsAdapter(session, wss);
+ *
+ * await session.spawnAgent();
+ * ```
+ */
+export declare function createWsAdapter(session: AgentSession, wss: WebSocketServer, options?: WsAdapterOptions): {
+    /** Get connected client count */
+    clientCount: () => number;
+    /** Broadcast a custom message to all clients */
+    broadcast: (message: unknown) => void;
+    /** Close all connections */
+    close: () => void;
+};
+//# sourceMappingURL=ws-adapter.d.ts.map

package/dist/ws-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-adapter.d.ts","sourceRoot":"","sources":["../src/ws-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,eAAe,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAUrE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,eAAe,EACpB,OAAO,GAAE,gBAAqB,GAC7B;IACD,iCAAiC;IACjC,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,gDAAgD;IAChD,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAmGA"}