@bytespell/amux 0.0.11 → 0.0.13

package/dist/client.js

@@ -0,0 +1,135 @@
+import fs from 'fs';
+import crypto from 'crypto';
+import { isToolCallUpdate, normalizeSessionUpdate } from './session-updates.js';
+/**
+ * ACP Client implementation.
+ * Bridges agent notifications to WebSocket clients and handles
+ * file operations and terminal management.
+ */
+export class AmuxClient {
+    terminalManager;
+    onEvent;
+    pendingPermissions = new Map();
+    constructor(terminalManager, onEvent) {
+        this.terminalManager = terminalManager;
+        this.onEvent = onEvent;
+    }
+    /**
+     * Handle permission request from agent
+     */
+    async requestPermission(params) {
+        console.log('[amux] Permission request:', params.toolCall?.title);
+        // Send permission request
+        const requestId = crypto.randomUUID();
+        this.onEvent({
+            type: 'permission_request',
+            requestId,
+            toolCall: params.toolCall,
+            options: params.options,
+        });
+        // Wait for response from client (with timeout)
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingPermissions.delete(requestId);
+                resolve({ outcome: { outcome: 'cancelled' } });
+            }, 300000); // 5 minute timeout
+            this.pendingPermissions.set(requestId, { resolve, reject, timeout });
+        });
+    }
+    /**
+     * Handle permission response from UI
+     */
+    handlePermissionResponse(requestId, optionId) {
+        const pending = this.pendingPermissions.get(requestId);
+        if (pending) {
+            clearTimeout(pending.timeout);
+            this.pendingPermissions.delete(requestId);
+            pending.resolve({
+                outcome: { outcome: 'selected', optionId },
+            });
+        }
+    }
+    /**
+     * Handle session update from agent
+     */
+    async sessionUpdate(params) {
+        const update = params.update;
+        // Normalize the update (convert Claude-style diffs to unified format)
+        const normalized = normalizeSessionUpdate(update);
+        // Route to session
+        this.onEvent({ type: 'session_update', update: normalized });
+        // Log updates for debugging
+        if (update.sessionUpdate === 'agent_message_chunk') {
+            // Don't log every chunk
+        }
+        else if (isToolCallUpdate(update)) {
+            console.log(`[amux] Tool call: ${update.title} (${update.status}) id=${update.toolCallId}`);
+        }
+        else if (update.sessionUpdate === 'tool_call_update') {
+            // Don't log every update
+        }
+        else if (update.sessionUpdate === 'current_mode_update') {
+            console.log(`[amux] Mode update: ${update.currentModeId}`);
+        }
+        else {
+            console.log(`[amux] Session update: ${update.sessionUpdate}`);
+        }
+    }
+    /**
+     * Write text file (ACP fs capability)
+     */
+    async writeTextFile(params) {
+        console.log('[amux] Write text file:', params.path);
+        try {
+            fs.writeFileSync(params.path, params.content);
+            return {};
+        }
+        catch (err) {
+            throw new Error(`Failed to write file: ${err.message}`);
+        }
+    }
+    /**
+     * Read text file (ACP fs capability)
+     */
+    async readTextFile(params) {
+        console.log('[amux] Read text file:', params.path);
+        try {
+            const content = fs.readFileSync(params.path, 'utf-8');
+            return { content };
+        }
+        catch (err) {
+            throw new Error(`Failed to read file: ${err.message}`);
+        }
+    }
+    /**
+     * Create terminal (ACP terminal capability)
+     */
+    async createTerminal(params) {
+        return this.terminalManager.create(params);
+    }
+    /**
+     * Get terminal output (ACP terminal capability)
+     */
+    async terminalOutput(params) {
+        return this.terminalManager.getOutput(params.terminalId);
+    }
+    /**
+     * Wait for terminal exit (ACP terminal capability)
+     */
+    async waitForTerminalExit(params) {
+        return this.terminalManager.waitForExit(params.terminalId);
+    }
+    /**
+     * Kill terminal (ACP terminal capability)
+     */
+    async killTerminal(params) {
+        return this.terminalManager.kill(params.terminalId);
+    }
+    /**
+     * Release terminal (ACP terminal capability)
+     */
+    async releaseTerminal(params) {
+        return this.terminalManager.release(params.terminalId);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * amux - Agent Multiplexer
+ *
+ * A library for managing ACP agent sessions with an EventEmitter interface.
+ * Transport-agnostic - wire up to WebSocket, HTTP, IPC, or anything else.
+ *
+ * @example
+ * ```typescript
+ * import { AgentSession, createWsAdapter } from '@bytespell/amux';
+ * import { WebSocketServer } from 'ws';
+ *
+ * const session = new AgentSession({
+ *   instanceId: 'my-instance',
+ *   basePath: __dirname,
+ *   systemContext: 'You are a helpful assistant...',
+ * });
+ *
+ * // Option 1: Use the WebSocket adapter
+ * const wss = new WebSocketServer({ port: 3000 });
+ * createWsAdapter(session, wss);
+ *
+ * // Option 2: Handle events yourself
+ * session.on('ready', (data) => console.log('Ready:', data));
+ * session.on('update', (data) => myTransport.send(data));
+ *
+ * await session.spawnAgent();
+ * await session.prompt('Hello!');
+ * ```
+ */
+export { AgentSession } from './session.js';
+export type { AgentSessionEvents } from './session.js';
+export { createWsAdapter } from './ws-adapter.js';
+export type { WsAdapterOptions } from './ws-adapter.js';
+export { AmuxClient } from './client.js';
+export { TerminalManager } from './terminal.js';
+export { StateManager } from './state.js';
+export { isToolCallUpdate, isToolCallUpdateMessage, isDiffContent, normalizeSessionUpdate, } from './session-updates.js';
+export { parseMessageToContentBlocks } from './message-parser.js';
+export type { AgentSessionConfig, AgentConfig, SessionMetadata, SessionState, SessionRestoreInfo, StoredEvent, } from './types.js';
+export { AGENTS } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAGlE,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * amux - Agent Multiplexer
+ *
+ * A library for managing ACP agent sessions with an EventEmitter interface.
+ * Transport-agnostic - wire up to WebSocket, HTTP, IPC, or anything else.
+ *
+ * @example
+ * ```typescript
+ * import { AgentSession, createWsAdapter } from '@bytespell/amux';
+ * import { WebSocketServer } from 'ws';
+ *
+ * const session = new AgentSession({
+ *   instanceId: 'my-instance',
+ *   basePath: __dirname,
+ *   systemContext: 'You are a helpful assistant...',
+ * });
+ *
+ * // Option 1: Use the WebSocket adapter
+ * const wss = new WebSocketServer({ port: 3000 });
+ * createWsAdapter(session, wss);
+ *
+ * // Option 2: Handle events yourself
+ * session.on('ready', (data) => console.log('Ready:', data));
+ * session.on('update', (data) => myTransport.send(data));
+ *
+ * await session.spawnAgent();
+ * await session.prompt('Hello!');
+ * ```
+ */
+// Core session management
+export { AgentSession } from './session.js';
+// WebSocket adapter
+export { createWsAdapter } from './ws-adapter.js';
+// Supporting components (for advanced usage)
+export { AmuxClient } from './client.js';
+export { TerminalManager } from './terminal.js';
+export { StateManager } from './state.js';
+// Session update utilities
+export { isToolCallUpdate, isToolCallUpdateMessage, isDiffContent, normalizeSessionUpdate, } from './session-updates.js';
+// Message parsing utilities
+export { parseMessageToContentBlocks } from './message-parser.js';
+// Built-in agents registry
+export { AGENTS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,2BAA2B;AAC3B,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,4BAA4B;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAYlE,2BAA2B;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/{lib/mentions.d.ts → message-parser.d.ts}

@@ -1,5 +1,4 @@
-import { ContentBlock } from '@agentclientprotocol/sdk';
-
+import type * as acp from '@agentclientprotocol/sdk';
 /**
  * Parse message text with @mentions into ContentBlock array.
  * @mentions become resource_link blocks, other text becomes text blocks.
@@ -9,6 +8,5 @@ import { ContentBlock } from '@agentclientprotocol/sdk';
  * - "@src/foo.ts" → [{ type: 'resource_link', uri: 'file://...', name: 'src/foo.ts' }]
  * - "check @src/foo.ts for bugs" → text + resource_link + text
  */
-declare function parseMessageToContentBlocks(message: string, workingDir: string): ContentBlock[];
-
-export { parseMessageToContentBlocks };
+export declare function parseMessageToContentBlocks(message: string, workingDir: string): acp.ContentBlock[];
+//# sourceMappingURL=message-parser.d.ts.map

package/dist/message-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-parser.d.ts","sourceRoot":"","sources":["../src/message-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,GAAG,CAAC,YAAY,EAAE,CAsCpB"}

package/dist/message-parser.js

@@ -0,0 +1,45 @@
+import path from 'path';
+/**
+ * Parse message text with @mentions into ContentBlock array.
+ * @mentions become resource_link blocks, other text becomes text blocks.
+ *
+ * Examples:
+ * - "hello world" → [{ type: 'text', text: 'hello world' }]
+ * - "@src/foo.ts" → [{ type: 'resource_link', uri: 'file://...', name: 'src/foo.ts' }]
+ * - "check @src/foo.ts for bugs" → text + resource_link + text
+ */
+export function parseMessageToContentBlocks(message, workingDir) {
+    const blocks = [];
+    // Match @path/to/file.ts, @./local.ts, @../parent/file.ts
+    // Allows leading ./ or ../ followed by path characters
+    const mentionRegex = /@(\.{0,2}[\w\/\.\-]+)/g;
+    let lastIndex = 0;
+    for (const match of message.matchAll(mentionRegex)) {
+        // Add text before mention
+        if (match.index > lastIndex) {
+            const text = message.slice(lastIndex, match.index);
+            if (text.trim()) {
+                blocks.push({ type: 'text', text });
+            }
+        }
+        // Add resource_link for mention
+        const relativePath = match[1];
+        const absolutePath = path.resolve(workingDir, relativePath);
+        blocks.push({
+            type: 'resource_link',
+            uri: `file://${absolutePath}`,
+            name: relativePath,
+        });
+        lastIndex = match.index + match[0].length;
+    }
+    // Add remaining text
+    if (lastIndex < message.length) {
+        const text = message.slice(lastIndex);
+        if (text.trim()) {
+            blocks.push({ type: 'text', text });
+        }
+    }
+    // If no mentions found, return single text block
+    return blocks.length > 0 ? blocks : [{ type: 'text', text: message }];
+}
+//# sourceMappingURL=message-parser.js.map

package/dist/message-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-parser.js","sourceRoot":"","sources":["../src/message-parser.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAe,EACf,UAAkB;IAElB,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,0DAA0D;IAC1D,uDAAuD;IACvD,MAAM,YAAY,GAAG,wBAAwB,CAAC;IAE9C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnD,0BAA0B;QAC1B,IAAI,KAAK,CAAC,KAAM,GAAG,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,eAAe;YACrB,GAAG,EAAE,UAAU,YAAY,EAAE;YAC7B,IAAI,EAAE,YAAY;SACnB,CAAC,CAAC;QAEH,SAAS,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7C,CAAC;IAED,qBAAqB;IACrB,IAAI,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/message-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message-parser.test.d.ts.map

package/dist/message-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-parser.test.d.ts","sourceRoot":"","sources":["../src/message-parser.test.ts"],"names":[],"mappings":""}

package/dist/message-parser.test.js

@@ -0,0 +1,188 @@
+import { describe, it, expect } from 'vitest';
+import { parseMessageToContentBlocks } from './message-parser.js';
+describe('parseMessageToContentBlocks', () => {
+    const workingDir = '/home/user/project';
+    describe('plain text messages', () => {
+        it('returns single text block for plain text', () => {
+            const result = parseMessageToContentBlocks('hello world', workingDir);
+            expect(result).toEqual([{ type: 'text', text: 'hello world' }]);
+        });
+        it('returns single text block for empty message', () => {
+            const result = parseMessageToContentBlocks('', workingDir);
+            expect(result).toEqual([{ type: 'text', text: '' }]);
+        });
+        it('returns single text block for whitespace-only message', () => {
+            const result = parseMessageToContentBlocks('   ', workingDir);
+            expect(result).toEqual([{ type: 'text', text: '   ' }]);
+        });
+        it('preserves multi-line text', () => {
+            const result = parseMessageToContentBlocks('line one\nline two', workingDir);
+            expect(result).toEqual([{ type: 'text', text: 'line one\nline two' }]);
+        });
+    });
+    describe('single @mentions', () => {
+        it('parses single @mention as resource_link', () => {
+            const result = parseMessageToContentBlocks('@src/foo.ts', workingDir);
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/src/foo.ts',
+                    name: 'src/foo.ts',
+                },
+            ]);
+        });
+        it('parses relative path with ./', () => {
+            const result = parseMessageToContentBlocks('@./local.ts', workingDir);
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/local.ts',
+                    name: './local.ts',
+                },
+            ]);
+        });
+        it('parses relative path with ../', () => {
+            const result = parseMessageToContentBlocks('@../parent/file.ts', workingDir);
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/parent/file.ts',
+                    name: '../parent/file.ts',
+                },
+            ]);
+        });
+        it('handles file with dashes in name', () => {
+            const result = parseMessageToContentBlocks('@src/my-file.ts', workingDir);
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/src/my-file.ts',
+                    name: 'src/my-file.ts',
+                },
+            ]);
+        });
+        it('handles deeply nested paths', () => {
+            const result = parseMessageToContentBlocks('@src/a/b/c/d.ts', workingDir);
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/src/a/b/c/d.ts',
+                    name: 'src/a/b/c/d.ts',
+                },
+            ]);
+        });
+    });
+    describe('mixed text and @mentions', () => {
+        it('parses text before and after mention', () => {
+            const result = parseMessageToContentBlocks('check @src/foo.ts for bugs', workingDir);
+            expect(result).toEqual([
+                { type: 'text', text: 'check ' },
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/src/foo.ts',
+                    name: 'src/foo.ts',
+                },
+                { type: 'text', text: ' for bugs' },
+            ]);
+        });
+        it('parses text only before mention', () => {
+            const result = parseMessageToContentBlocks('look at @src/foo.ts', workingDir);
+            expect(result).toEqual([
+                { type: 'text', text: 'look at ' },
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/src/foo.ts',
+                    name: 'src/foo.ts',
+                },
+            ]);
+        });
+        it('parses text only after mention', () => {
+            const result = parseMessageToContentBlocks('@src/foo.ts has a bug', workingDir);
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/src/foo.ts',
+                    name: 'src/foo.ts',
+                },
+                { type: 'text', text: ' has a bug' },
+            ]);
+        });
+    });
+    describe('multiple @mentions', () => {
+        it('parses multiple mentions with text between', () => {
+            const result = parseMessageToContentBlocks('@src/a.ts and @src/b.ts', workingDir);
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/src/a.ts',
+                    name: 'src/a.ts',
+                },
+                { type: 'text', text: ' and ' },
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/src/b.ts',
+                    name: 'src/b.ts',
+                },
+            ]);
+        });
+        it('parses consecutive mentions without text between', () => {
+            const result = parseMessageToContentBlocks('@a.ts @b.ts', workingDir);
+            // The space between becomes whitespace-only and gets skipped
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/a.ts',
+                    name: 'a.ts',
+                },
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/project/b.ts',
+                    name: 'b.ts',
+                },
+            ]);
+        });
+    });
+    describe('edge cases', () => {
+        it('handles email-like patterns (should not match)', () => {
+            // Email addresses should be matched by regex, which may not be desired
+            // This test documents current behavior
+            const result = parseMessageToContentBlocks('email user@example.com', workingDir);
+            // The regex matches @example.com as a mention
+            expect(result[0]).toEqual({ type: 'text', text: 'email user' });
+            expect(result[1]).toHaveProperty('type', 'resource_link');
+        });
+        it('handles @ at end of string without path', () => {
+            const result = parseMessageToContentBlocks('just an @', workingDir);
+            expect(result).toEqual([{ type: 'text', text: 'just an @' }]);
+        });
+        it('handles multiple @ signs', () => {
+            const result = parseMessageToContentBlocks('@@foo.ts', workingDir);
+            // First @ doesn't match (followed by @), second @ matches
+            expect(result).toHaveLength(2);
+            expect(result[0]).toEqual({ type: 'text', text: '@' });
+        });
+    });
+    describe('working directory resolution', () => {
+        it('uses provided working directory for absolute path resolution', () => {
+            const result = parseMessageToContentBlocks('@file.ts', '/custom/dir');
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///custom/dir/file.ts',
+                    name: 'file.ts',
+                },
+            ]);
+        });
+        it('resolves relative paths correctly from working directory', () => {
+            const result = parseMessageToContentBlocks('@../sibling/file.ts', '/home/user/project');
+            expect(result).toEqual([
+                {
+                    type: 'resource_link',
+                    uri: 'file:///home/user/sibling/file.ts',
+                    name: '../sibling/file.ts',
+                },
+            ]);
+        });
+    });
+});
+//# sourceMappingURL=message-parser.test.js.map

package/dist/message-parser.test.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,24 @@
+import { type Application } from 'express';
+import { type Server } from 'http';
+import { AgentSession } from './session.js';
+import type { AmuxServerConfig } from './types.js';
+/**
+ * Create an amux server with full Express + WebSocket setup.
+ * This is the "batteries included" API for building agent-powered plugins.
+ */
+export declare function createAmuxServer(config?: AmuxServerConfig): {
+    app: Application;
+    server: Server;
+    start: () => Promise<void>;
+    shutdown: () => void;
+};
+/**
+ * Attach amux to an existing Express app and HTTP server.
+ * For when you want more control over the server setup.
+ */
+export declare function attachAmux(_app: Application, server: Server, config: Omit<AmuxServerConfig, 'port' | 'dev' | 'staticDir'>): {
+    agentSession: AgentSession;
+    start: () => Promise<void>;
+    shutdown: () => void;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAkD,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAMjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC;AAY3E;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,gBAAqB,GAAG;IAC/D,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CA0SA;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC,GAC3D;IACD,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CA2EA"}