@bytespell/amux 0.0.11 → 0.0.12

package/dist/session-updates.js

@@ -0,0 +1,68 @@
+/**
+ * Type guard for tool_call session updates
+ */
+export function isToolCallUpdate(update) {
+    return update.sessionUpdate === 'tool_call';
+}
+/**
+ * Type guard for tool_call_update session updates
+ */
+export function isToolCallUpdateMessage(update) {
+    return update.sessionUpdate === 'tool_call_update';
+}
+/**
+ * Type guard for diff content items
+ */
+export function isDiffContent(item) {
+    return item.type === 'diff';
+}
+/**
+ * Normalize ACP session updates.
+ * Claude sends Edit/Write diffs as {newText, oldText, path} instead of unified diff.
+ * We convert these to standard unified diff format so the UI doesn't need agent-specific logic.
+ */
+export function normalizeSessionUpdate(update) {
+    // Only process tool_call and tool_call_update events with content arrays
+    if (!isToolCallUpdate(update) && !isToolCallUpdateMessage(update)) {
+        return update;
+    }
+    const content = update.content;
+    if (!content || !Array.isArray(content)) {
+        return update;
+    }
+    // Check for diff items that need normalization
+    const normalizedContent = content.map((item) => {
+        if (!isDiffContent(item))
+            return item;
+        const diffItem = item;
+        const newText = diffItem.newText;
+        const oldText = diffItem.oldText;
+        const filePath = diffItem.path ?? 'file';
+        // Generate unified diff
+        const oldLines = oldText ? oldText.split('\n') : [];
+        const newLines = newText.split('\n');
+        let unifiedDiff = `Index: ${filePath}\n`;
+        unifiedDiff += '===================================================================\n';
+        unifiedDiff += `--- ${filePath}\n`;
+        unifiedDiff += `+++ ${filePath}\n`;
+        unifiedDiff += `@@ -${oldLines.length > 0 ? 1 : 0},${oldLines.length} +1,${newLines.length} @@\n`;
+        for (const line of oldLines) {
+            unifiedDiff += `-${line}\n`;
+        }
+        for (const line of newLines) {
+            unifiedDiff += `+${line}\n`;
+        }
+        // Return normalized diff item
+        return {
+            type: 'diff',
+            newText: unifiedDiff,
+            oldText: '',
+            path: filePath,
+        };
+    });
+    return {
+        ...update,
+        content: normalizedContent,
+    };
+}
+//# sourceMappingURL=session-updates.js.map

package/dist/session-updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-updates.js","sourceRoot":"","sources":["../src/session-updates.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAyB;IAEzB,OAAO,MAAM,CAAC,aAAa,KAAK,WAAW,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAyB;IAEzB,OAAO,MAAM,CAAC,aAAa,KAAK,kBAAkB,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAyB;IAEzB,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAyB;IAEzB,yEAAyE;IACzE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,+CAA+C;IAC/C,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAuB,EAAE;QAClE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC;QACtB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC;QAEzC,wBAAwB;QACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,WAAW,GAAG,UAAU,QAAQ,IAAI,CAAC;QACzC,WAAW,IAAI,uEAAuE,CAAC;QACvF,WAAW,IAAI,OAAO,QAAQ,IAAI,CAAC;QACnC,WAAW,IAAI,OAAO,QAAQ,IAAI,CAAC;QACnC,WAAW,IAAI,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,MAAM,OAAO,CAAC;QAElG,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC;QAC9B,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC;QAC9B,CAAC;QAED,8BAA8B;QAC9B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,iBAAiB;KAC3B,CAAC;AACJ,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,207 @@
+import { EventEmitter } from 'events';
+import * as acp from '@agentclientprotocol/sdk';
+import type { AgentSessionConfig, SessionRestoreInfo, SessionMetadata } from './types.js';
+/**
+ * Events emitted by AgentSession
+ */
+export interface AgentSessionEvents {
+    ready: {
+        cwd: string;
+        sessionId: string | null;
+        sessionRestore?: SessionRestoreInfo;
+        capabilities: acp.AgentCapabilities | null;
+        agent: {
+            type: string;
+            name: string;
+        };
+        availableAgents: Array<{
+            id: string;
+            name: string;
+        }>;
+    };
+    update: acp.SessionUpdate;
+    turn_start: Record<string, never>;
+    turn_end: Record<string, never>;
+    permission_request: {
+        requestId: string;
+        toolCall?: acp.ToolCall;
+        options: acp.PermissionOption[];
+    };
+    prompt_complete: {
+        stopReason?: string;
+    };
+    session_created: {
+        sessionId: string | null;
+    };
+    session_switched: {
+        sessionId: string;
+    };
+    history_replay: {
+        previousSessionId: string;
+        events: unknown[];
+        eventCount: number;
+    };
+    error: {
+        message: string;
+    };
+    agent_exit: {
+        code: number | null;
+        signal: string | null;
+    };
+    connecting: Record<string, never>;
+}
+/**
+ * AgentSession - Core ACP session management with EventEmitter interface.
+ *
+ * Emits events for all session activity. Transport-agnostic - wire up
+ * to WebSocket, HTTP, IPC, or anything else.
+ *
+ * @example
+ * ```typescript
+ * const session = new AgentSession({
+ *   instanceId: 'my-instance',
+ *   basePath: __dirname,
+ * });
+ *
+ * session.on('ready', (data) => console.log('Ready:', data));
+ * session.on('update', (data) => console.log('Update:', data));
+ *
+ * await session.spawnAgent();
+ * await session.prompt('Hello!');
+ * ```
+ */
+export declare class AgentSession extends EventEmitter {
+    private _cwd;
+    private _sessionId;
+    private _agentType;
+    private _systemContext?;
+    private agentProcess;
+    private acpConnection;
+    private _agentCapabilities;
+    private terminalManager;
+    private amuxClient;
+    private stateManager;
+    private instanceId;
+    private basePath;
+    private fixedCwd?;
+    private agents;
+    constructor(config: AgentSessionConfig);
+    emit<K extends keyof AgentSessionEvents>(event: K, data: AgentSessionEvents[K]): boolean;
+    on<K extends keyof AgentSessionEvents>(event: K, listener: (data: AgentSessionEvents[K]) => void): this;
+    once<K extends keyof AgentSessionEvents>(event: K, listener: (data: AgentSessionEvents[K]) => void): this;
+    /**
+     * Emit update and store to history
+     */
+    private emitUpdate;
+    /**
+     * Emit turn marker and store to history
+     */
+    private emitTurnMarker;
+    get cwd(): string;
+    get sessionId(): string | null;
+    get agentType(): string;
+    get agentCapabilities(): acp.AgentCapabilities | null;
+    get isConnected(): boolean;
+    get systemContext(): string | undefined;
+    /**
+     * Get current agent info
+     */
+    getAgentInfo(): {
+        type: string;
+        name: string;
+    };
+    /**
+     * Get available agents list
+     */
+    getAvailableAgents(): Array<{
+        id: string;
+        name: string;
+    }>;
+    /**
+     * Save current state to disk
+     */
+    private saveState;
+    /**
+     * Name the session after the first user message
+     */
+    private maybeNameSession;
+    /**
+     * Spawn and initialize the ACP agent
+     */
+    spawnAgent(): Promise<void>;
+    /**
+     * Initialize or restore session
+     */
+    private initializeSession;
+    /**
+     * Inject system context as the first message
+     */
+    private injectSystemContext;
+    /**
+     * Replay history events from a previous session
+     */
+    private replayHistoryFromPreviousSession;
+    /**
+     * Create a new session
+     */
+    private createNewSession;
+    /**
+     * Broadcast mode info if available
+     */
+    private broadcastModeInfo;
+    /**
+     * Send a prompt to the agent
+     */
+    prompt(message: string): Promise<{
+        stopReason?: string;
+    }>;
+    /**
+     * Cancel current operation
+     */
+    cancel(): Promise<void>;
+    /**
+     * Handle permission response from UI
+     */
+    respondToPermission(requestId: string, optionId: string): void;
+    /**
+     * List available sessions
+     */
+    listSessions(): SessionMetadata[];
+    /**
+     * Load history for current session
+     */
+    loadHistory(): unknown[];
+    /**
+     * Switch to a different session
+     */
+    switchSession(sessionId: string): Promise<void>;
+    /**
+     * Change working directory (requires agent restart)
+     */
+    changeCwd(newPath: string): Promise<void>;
+    /**
+     * Create a new session
+     */
+    newSession(): Promise<void>;
+    /**
+     * Set session mode
+     */
+    setMode(modeId: string): Promise<void>;
+    /**
+     * Set session model
+     */
+    setModel(modelId: string): Promise<void>;
+    /**
+     * Change agent type (requires agent restart)
+     */
+    changeAgent(agentType: string): Promise<void>;
+    /**
+     * Kill the agent process
+     */
+    killAgent(): Promise<void>;
+    /**
+     * Shutdown (cleanup all resources)
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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