@bytespell/amux 0.0.18 → 0.0.20

package/README.md

@@ -1,234 +0,0 @@
-# amux
-
-**ACP Multiplexer** - the session layer for ACP agents.
-
-The [ACP TypeScript SDK](https://github.com/agentclientprotocol/typescript-sdk) does the hard work of getting the protocol right - json-rpc transport, type definitions, connection lifecycle. But there's a gap between "I can send messages to an agent" and "I can manage agent sessions in my app".
-
-amux fills that gap. Think tmux for agents - spawn sessions, detach, reattach later, pick up where you left off.
-
-Everything the SDK doesn't do:
-- Spawn and manage agent processes (the SDK gives you a connection, not a process)
-- Persist session state to disk (detach and reattach later)
-- Replay history on reconnect (your UI picks up where it left off)
-- Handle permission requests with pluggable strategies
-- Switch between agents (Claude Code, Codex, Pi) without changing your code
-
-Transport-agnostic core with an optional WebSocket adapter.
-
-## Installation
-
-```bash
-npm install @bytespell/amux
-```
-
-You'll also need at least one ACP agent installed and available on your PATH:
-
-```bash
-# Claude Code
-npm install -g @anthropics/claude-code
-
-# Codex
-npm install -g @openai/codex
-
-# Pi
-npm install -g @mariozechner/pi-coding-agent
-```
-
-amux automatically detects which agents are installed by checking your PATH.
-
-## Quick Start
-
-### With WebSocket Adapter
-
-```typescript
-import { AgentSession, createWsAdapter } from '@bytespell/amux';
-import { WebSocketServer } from 'ws';
-import { createServer } from 'http';
-
-const server = createServer();
-const wss = new WebSocketServer({ server, path: '/ws' });
-
-const session = new AgentSession({
-  instanceId: process.env.INSTANCE_ID ?? 'default',
-  systemContext: 'You are a helpful assistant...',
-});
-
-// Wire up WebSocket
-createWsAdapter(session, wss);
-
-// Start the agent
-await session.spawnAgent();
-
-server.listen(3000);
-```
-
-### Events Only (Bring Your Own Transport)
-
-```typescript
-import { AgentSession } from '@bytespell/amux';
-
-const session = new AgentSession({
-  instanceId: 'my-instance',
-});
-
-// Subscribe to events
-session.on('ready', (data) => {
-  console.log('Agent ready:', data.agent.name);
-});
-
-session.on('update', (update) => {
-  // Handle streaming updates
-  if (update.sessionUpdate === 'agent_message_chunk') {
-    process.stdout.write(update.content.text);
-  }
-});
-
-session.on('permission_request', (data) => {
-  // Auto-approve for demo
-  session.respondToPermission(data.requestId, data.options[0].optionId);
-});
-
-session.on('error', (data) => {
-  console.error('Error:', data.message);
-});
-
-// Start and prompt
-await session.spawnAgent();
-await session.prompt('Hello, what can you do?');
-```
-
-## API
-
-### `AgentSession`
-
-Core class for managing an ACP agent session. Extends `EventEmitter`.
-
-```typescript
-const session = new AgentSession({
-  instanceId: string;       // Unique ID for state isolation
-  systemContext?: string;   // Injected context for the agent
-  fixedCwd?: string;        // Lock working directory
-  agentType?: string;       // 'claude-code' | 'codex' | 'pi'
-  stateDir?: string;        // Custom state directory
-});
-```
-
-#### Methods
-
-```typescript
-await session.spawnAgent()              // Start the agent process
-await session.prompt(message)           // Send a prompt
-await session.cancel()                  // Cancel current operation
-session.respondToPermission(id, optId)  // Respond to permission request
-await session.newSession()              // Create new session
-await session.changeCwd(path)           // Change working directory
-await session.changeAgent(type)         // Switch agent type
-session.listSessions()                  // List available sessions
-session.loadHistory()                   // Get current session history
-session.getAvailableAgents()            // All agents with installed status
-session.getInstalledAgents()            // Only agents ready to use
-session.shutdown()                      // Cleanup and stop
-```
-
-#### Agent Discovery
-
-amux bundles ACP wrappers for supported agents. Use `getInstalledAgents()` to find which agents are ready to use (base CLI on PATH + ACP wrapper bundled):
-
-```typescript
-const agents = session.getInstalledAgents();
-// [{ id: 'claude-code', name: 'Claude Code' }, ...]
-
-const allAgents = session.getAvailableAgents();
-// [{ id: 'claude-code', name: 'Claude Code', installed: true }, ...]
-```
-
-The `ready` event also includes `availableAgents` (same as `getInstalledAgents()`).
-
-#### Events
-
-```typescript
-session.on('connecting', () => {})
-session.on('ready', (data) => {})           // Agent initialized
-session.on('update', (update) => {})        // Session update (streaming)
-session.on('turn_start', () => {})          // Prompt started
-session.on('turn_end', () => {})            // Prompt completed
-session.on('permission_request', (data) => {})
-session.on('prompt_complete', (data) => {})
-session.on('session_created', (data) => {})
-session.on('session_switched', (data) => {})
-session.on('history_replay', (data) => {})
-session.on('error', (data) => {})
-session.on('agent_exit', (data) => {})
-```
-
-### `createWsAdapter(session, wss, options?)`
-
-Wire up a WebSocket server to an AgentSession.
-
-```typescript
-import { createWsAdapter } from '@bytespell/amux';
-
-const adapter = createWsAdapter(session, wss, {
-  sendHistoryOnConnect: true,  // Default: true
-});
-
-adapter.clientCount()  // Get connected clients
-adapter.broadcast(msg) // Send custom message to all
-adapter.close()        // Close all connections
-```
-
-#### WebSocket Protocol
-
-**Client → Server:**
-```typescript
-{ type: 'prompt', message: 'Hello' }
-{ type: 'cancel' }
-{ type: 'permission_response', requestId: '...', optionId: '...' }
-{ type: 'change_cwd', path: '/new/path' }
-{ type: 'new_session' }
-{ type: 'change_agent', agentType: 'codex' }
-{ type: 'list_sessions' }
-{ type: 'switch_session', sessionId: '...' }
-```
-
-**Server → Client:**
-```typescript
-{ type: 'ready', cwd: '...', sessionId: '...', ... }
-{ type: 'session_update', update: { sessionUpdate: '...', ... } }
-{ type: 'permission_request', requestId: '...', toolCall: {...}, options: [...] }
-{ type: 'history_replay', events: [...], eventCount: 42 }
-{ type: 'error', message: '...' }
-```
-
-## System Context
-
-Inject context to customize agent behavior:
-
-```typescript
-const session = new AgentSession({
-  instanceId: 'docs-helper',
-  systemContext: `
-# Documentation Assistant
-
-You help users write documentation for this project.
-
-Key conventions:
-- Use markdown format
-- Include code examples
-- Keep explanations concise
-  `,
-});
-```
-
-## State Persistence
-
-Sessions are persisted to `~/.local/state/amux/` by default:
-- Instance state (cwd, sessionId, agentType)
-- Session history (for replay on reconnect)
-- Session registry (list all sessions)
-
-Override with `stateDir` option.
-
-## License
-
-MIT

package/dist/cli.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-/**
- * amux CLI
- *
- * Quick way to start an amux server from the command line.
- *
- * Usage:
- *   amux                          # Start with defaults
- *   amux --context ./CONTEXT.md   # Start with system context from file
- *   amux --cwd /path/to/project   # Start with fixed working directory
- *   amux --port 3000              # Start on specific port
- */
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}

package/dist/cli.js

@@ -1,118 +0,0 @@
-#!/usr/bin/env node
-/**
- * amux CLI
- *
- * Quick way to start an amux server from the command line.
- *
- * Usage:
- *   amux                          # Start with defaults
- *   amux --context ./CONTEXT.md   # Start with system context from file
- *   amux --cwd /path/to/project   # Start with fixed working directory
- *   amux --port 3000              # Start on specific port
- */
-import fs from 'fs';
-import path from 'path';
-import { createAmuxServer } from './server.js';
-function parseArgs() {
-    const args = {};
-    const argv = process.argv.slice(2);
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        if (arg === '--help' || arg === '-h') {
-            args.help = true;
-        }
-        else if (arg === '--port' || arg === '-p') {
-            args.port = parseInt(argv[++i] ?? '', 10);
-        }
-        else if (arg === '--context' || arg === '-c') {
-            args.context = argv[++i];
-        }
-        else if (arg === '--cwd' || arg === '-d') {
-            args.cwd = argv[++i];
-        }
-        else if (arg === '--agent' || arg === '-a') {
-            args.agent = argv[++i];
-        }
-    }
-    return args;
-}
-function printHelp() {
-    console.log(`
-amux - ACP Multiplexer
-
-Start an agent-powered HTTP server with multiplexed sessions.
-
-USAGE:
-  amux [OPTIONS]
-
-OPTIONS:
-  -p, --port <port>       Port to listen on (default: 3000 or PORT env)
-  -c, --context <file>    Load system context from a markdown file
-  -d, --cwd <path>        Fixed working directory for all sessions
-  -a, --agent <type>      Agent type: claude-code, codex, pi (default: claude-code)
-  -h, --help              Show this help message
-
-EXAMPLES:
-  # Start with defaults
-  amux
-
-  # Start with system context
-  amux --context ./PLUGIN_GUIDE.md
-
-  # Start for a specific project
-  amux --cwd /path/to/project --context ./CONTEXT.md
-
-  # Use a different agent
-  amux --agent codex
-
-ENVIRONMENT:
-  PORT          Server port (overridden by --port)
-  INSTANCE_ID   Unique instance identifier for state isolation
-`);
-}
-async function main() {
-    const args = parseArgs();
-    if (args.help) {
-        printHelp();
-        process.exit(0);
-    }
-    // Load system context if specified
-    let systemContext;
-    if (args.context) {
-        const contextPath = path.resolve(args.context);
-        if (!fs.existsSync(contextPath)) {
-            console.error(`Error: Context file not found: ${contextPath}`);
-            process.exit(1);
-        }
-        systemContext = fs.readFileSync(contextPath, 'utf-8');
-        console.log(`[amux] Loaded system context from ${contextPath} (${systemContext.length} bytes)`);
-    }
-    // Resolve fixed cwd if specified
-    let fixedCwd;
-    if (args.cwd) {
-        fixedCwd = path.resolve(args.cwd);
-        if (!fs.existsSync(fixedCwd)) {
-            console.error(`Error: Working directory not found: ${fixedCwd}`);
-            process.exit(1);
-        }
-        console.log(`[amux] Using fixed working directory: ${fixedCwd}`);
-    }
-    const { start, shutdown } = createAmuxServer({
-        port: args.port,
-        systemContext,
-        fixedCwd,
-        agentType: args.agent,
-    });
-    // Handle shutdown gracefully
-    process.on('SIGINT', () => {
-        console.log('\n[amux] Received SIGINT, shutting down...');
-        shutdown();
-        process.exit(0);
-    });
-    await start();
-}
-main().catch((err) => {
-    console.error('[amux] Fatal error:', err);
-    process.exit(1);
-});
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

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

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

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

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

package/dist/message-parser.test.js

@@ -1,188 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}