@bytespell/amux-client 0.0.19

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @bytespell/amux-client
+ *
+ * Client library for consuming amux over WebSocket.
+ *
+ * @example
+ * ```typescript
+ * import { AmuxClient } from '@bytespell/amux-client';
+ *
+ * const client = new AmuxClient({ url: 'ws://localhost:3000/ws' });
+ *
+ * client.on('ready', (data) => {
+ *   console.log('Ready:', data.cwd);
+ * });
+ *
+ * client.on('update', (update) => {
+ *   console.log('Update:', update);
+ * });
+ *
+ * client.connect();
+ * client.prompt('Hello!');
+ * ```
+ *
+ * For React integration, use:
+ * ```typescript
+ * import { AmuxProvider, useAmux } from '@bytespell/amux-client/react';
+ * ```
+ */
+// Main client
+export { AmuxClient } from './client.js';
+// Supporting classes
+export { Connection } from './connection.js';
+export { Accumulator } from './accumulator.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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/react/context.d.ts

@@ -0,0 +1,60 @@
+import React from 'react';
+import { AmuxClient } from '../client.js';
+import type { AmuxClientOptions, ConnectionStatus, Message, Turn, PermissionOptionData } from '../types.js';
+/**
+ * Amux context value
+ */
+export interface AmuxContextValue {
+    client: AmuxClient;
+    connectionStatus: ConnectionStatus;
+    isConnected: boolean;
+    isReady: boolean;
+    cwd: string | null;
+    sessionId: string | null;
+    agent: {
+        type: string;
+        name: string;
+    } | null;
+    availableAgents: Array<{
+        id: string;
+        name: string;
+    }>;
+    isProcessing: boolean;
+    isStreaming: boolean;
+    isAwaitingPermission: boolean;
+    pendingPermission: {
+        requestId: string;
+        toolCall?: unknown;
+        options: PermissionOptionData[];
+    } | null;
+    messages: Message[];
+    turns: Turn[];
+    currentTurn: Turn | null;
+}
+/**
+ * Props for AmuxProvider
+ */
+export interface AmuxProviderProps extends AmuxClientOptions {
+    children: React.ReactNode;
+}
+/**
+ * AmuxProvider - Provides AmuxClient to React components
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   return (
+ *     <AmuxProvider url="ws://localhost:3000/ws" autoConnect>
+ *       <Chat />
+ *     </AmuxProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function AmuxProvider({ children, ...options }: AmuxProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Get the Amux context value
+ * @throws Error if used outside AmuxProvider
+ */
+export declare function useAmuxContext(): AmuxContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/react/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/react/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiE,MAAM,OAAO,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAoB,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE9H;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IAEnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IAEjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7C,eAAe,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAErD,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,oBAAoB,EAAE,CAAC;KACjC,GAAG,IAAI,CAAC;IAET,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAID;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,iBAAiB,2CAmIvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAMjD"}

package/dist/react/context.js

@@ -0,0 +1,138 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useRef, useState } from 'react';
+import { AmuxClient } from '../client.js';
+const AmuxContext = createContext(null);
+/**
+ * AmuxProvider - Provides AmuxClient to React components
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   return (
+ *     <AmuxProvider url="ws://localhost:3000/ws" autoConnect>
+ *       <Chat />
+ *     </AmuxProvider>
+ *   );
+ * }
+ * ```
+ */
+export function AmuxProvider({ children, ...options }) {
+    const clientRef = useRef(null);
+    // Initialize client once
+    if (!clientRef.current) {
+        clientRef.current = new AmuxClient(options);
+    }
+    const client = clientRef.current;
+    // State that triggers re-renders
+    const [connectionStatus, setConnectionStatus] = useState(client.connectionStatus);
+    const [isReady, setIsReady] = useState(client.isReady);
+    const [cwd, setCwd] = useState(client.cwd);
+    const [sessionId, setSessionId] = useState(client.sessionId);
+    const [agent, setAgent] = useState(client.agent);
+    const [availableAgents, setAvailableAgents] = useState(client.availableAgents);
+    const [isProcessing, setIsProcessing] = useState(client.isProcessing);
+    const [pendingPermission, setPendingPermission] = useState(client.pendingPermission);
+    const [messages, setMessages] = useState([]);
+    const [turns, setTurns] = useState([]);
+    // Subscribe to client events
+    useEffect(() => {
+        const handleConnectionStatus = ({ status }) => {
+            setConnectionStatus(status);
+        };
+        const handleReady = (data) => {
+            setIsReady(true);
+            setCwd(data.cwd);
+            setSessionId(data.sessionId);
+            setAgent(data.agent);
+            setAvailableAgents(data.availableAgents);
+        };
+        const handleConnecting = () => {
+            setIsReady(false);
+        };
+        const handleTurnStart = () => {
+            setIsProcessing(true);
+        };
+        const handleTurnEnd = () => {
+            setIsProcessing(false);
+        };
+        const handlePermissionRequest = (data) => {
+            setPendingPermission(data);
+        };
+        const handleSessionCreated = (data) => {
+            setSessionId(data.sessionId);
+        };
+        const handleSessionSwitched = (data) => {
+            setSessionId(data.sessionId);
+        };
+        const handleMessagesUpdated = ({ messages: msgs }) => {
+            setMessages([...msgs]);
+        };
+        const handleTurnsUpdated = ({ turns: t }) => {
+            setTurns([...t]);
+        };
+        const handleAgentExit = () => {
+            setIsReady(false);
+            setIsProcessing(false);
+        };
+        client.on('connection_status', handleConnectionStatus);
+        client.on('ready', handleReady);
+        client.on('connecting', handleConnecting);
+        client.on('turn_start', handleTurnStart);
+        client.on('turn_end', handleTurnEnd);
+        client.on('permission_request', handlePermissionRequest);
+        client.on('session_created', handleSessionCreated);
+        client.on('session_switched', handleSessionSwitched);
+        client.on('messages_updated', handleMessagesUpdated);
+        client.on('turns_updated', handleTurnsUpdated);
+        client.on('agent_exit', handleAgentExit);
+        return () => {
+            client.off('connection_status', handleConnectionStatus);
+            client.off('ready', handleReady);
+            client.off('connecting', handleConnecting);
+            client.off('turn_start', handleTurnStart);
+            client.off('turn_end', handleTurnEnd);
+            client.off('permission_request', handlePermissionRequest);
+            client.off('session_created', handleSessionCreated);
+            client.off('session_switched', handleSessionSwitched);
+            client.off('messages_updated', handleMessagesUpdated);
+            client.off('turns_updated', handleTurnsUpdated);
+            client.off('agent_exit', handleAgentExit);
+        };
+    }, [client]);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            client.disconnect();
+        };
+    }, [client]);
+    const value = {
+        client,
+        connectionStatus,
+        isConnected: connectionStatus === 'connected' || connectionStatus === 'ready',
+        isReady,
+        cwd,
+        sessionId,
+        agent,
+        availableAgents,
+        isProcessing,
+        isStreaming: client.isStreaming,
+        isAwaitingPermission: pendingPermission !== null,
+        pendingPermission,
+        messages,
+        turns,
+        currentTurn: client.currentTurn,
+    };
+    return _jsx(AmuxContext.Provider, { value: value, children: children });
+}
+/**
+ * Get the Amux context value
+ * @throws Error if used outside AmuxProvider
+ */
+export function useAmuxContext() {
+    const context = useContext(AmuxContext);
+    if (!context) {
+        throw new Error('useAmuxContext must be used within an AmuxProvider');
+    }
+    return context;
+}
+//# sourceMappingURL=context.js.map

package/dist/react/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/react/context.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAgC1C,MAAM,WAAW,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;AASjE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAqB;IACtE,MAAM,SAAS,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IAElD,yBAAyB;IACzB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvB,SAAS,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;IAEjC,iCAAiC;IACjC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAmB,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACpG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/E,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACtE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACrF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAY,EAAE,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IAE/C,6BAA6B;IAC7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,sBAAsB,GAAG,CAAC,EAAE,MAAM,EAAgC,EAAE,EAAE;YAC1E,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,CAAC,IAKpB,EAAE,EAAE;YACH,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,kBAAkB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC,CAAC;QAEF,MAAM,gBAAgB,GAAG,GAAG,EAAE;YAC5B,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC;QAEF,MAAM,eAAe,GAAG,GAAG,EAAE;YAC3B,eAAe,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,uBAAuB,GAAG,CAAC,IAA4C,EAAE,EAAE;YAC/E,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,MAAM,oBAAoB,GAAG,CAAC,IAAkC,EAAE,EAAE;YAClE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,MAAM,qBAAqB,GAAG,CAAC,IAA2B,EAAE,EAAE;YAC5D,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,MAAM,qBAAqB,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAA2B,EAAE,EAAE;YAC5E,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,kBAAkB,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAqB,EAAE,EAAE;YAC7D,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,eAAe,GAAG,GAAG,EAAE;YAC3B,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,CAAC,EAAE,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAAC;QACvD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;QAC1C,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,CAAC;QACzD,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;QACnD,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;QACrD,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;QACrD,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAEzC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAAC;YACxD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,CAAC;YAC1D,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;YACtD,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;YACtD,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,qBAAqB;IACrB,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,KAAK,GAAqB;QAC9B,MAAM;QACN,gBAAgB;QAChB,WAAW,EAAE,gBAAgB,KAAK,WAAW,IAAI,gBAAgB,KAAK,OAAO;QAC7E,OAAO;QACP,GAAG;QACH,SAAS;QACT,KAAK;QACL,eAAe;QACf,YAAY;QACZ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,oBAAoB,EAAE,iBAAiB,KAAK,IAAI;QAChD,iBAAiB;QACjB,QAAQ;QACR,KAAK;QACL,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;IAEF,OAAO,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAwB,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/react/hooks.d.ts

@@ -0,0 +1,153 @@
+import type { AmuxClientEvents, ConnectionStatus, Message, Turn, PermissionOptionData } from '../types.js';
+import type { AmuxClient } from '../client.js';
+/**
+ * Get the AmuxClient instance
+ *
+ * @example
+ * ```tsx
+ * function Chat() {
+ *   const client = useAmux();
+ *
+ *   const handleSubmit = (message: string) => {
+ *     client.prompt(message);
+ *   };
+ *
+ *   return <ChatUI onSubmit={handleSubmit} />;
+ * }
+ * ```
+ */
+export declare function useAmux(): AmuxClient;
+/**
+ * State returned by useAmuxState
+ */
+export interface AmuxState {
+    connectionStatus: ConnectionStatus;
+    isConnected: boolean;
+    isReady: boolean;
+    cwd: string | null;
+    sessionId: string | null;
+    agent: {
+        type: string;
+        name: string;
+    } | null;
+    availableAgents: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+/**
+ * Get reactive session state
+ *
+ * @example
+ * ```tsx
+ * function StatusBar() {
+ *   const { isConnected, isReady, cwd, agent } = useAmuxState();
+ *
+ *   return (
+ *     <div>
+ *       {isReady ? `${agent?.name} @ ${cwd}` : 'Connecting...'}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAmuxState(): AmuxState;
+/**
+ * Status returned by useAmuxStatus
+ */
+export interface AmuxStatus {
+    isProcessing: boolean;
+    isStreaming: boolean;
+    isAwaitingPermission: boolean;
+    pendingPermission: {
+        requestId: string;
+        toolCall?: unknown;
+        options: PermissionOptionData[];
+    } | null;
+}
+/**
+ * Get reactive processing status
+ *
+ * @example
+ * ```tsx
+ * function ChatInput() {
+ *   const { isProcessing, isAwaitingPermission } = useAmuxStatus();
+ *   const disabled = isProcessing || isAwaitingPermission;
+ *
+ *   return <input disabled={disabled} ... />;
+ * }
+ * ```
+ */
+export declare function useAmuxStatus(): AmuxStatus;
+/**
+ * Messages state returned by useAmuxMessages
+ */
+export interface AmuxMessages {
+    messages: Message[];
+    turns: Turn[];
+    currentTurn: Turn | null;
+}
+/**
+ * Get reactive messages and turns
+ *
+ * @example
+ * ```tsx
+ * function MessageList() {
+ *   const { messages, currentTurn } = useAmuxMessages();
+ *
+ *   return (
+ *     <>
+ *       {messages.map(msg => <MessageBubble key={msg.id} message={msg} />)}
+ *       {currentTurn?.status === 'streaming' && <StreamingIndicator />}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAmuxMessages(): AmuxMessages;
+/**
+ * Subscribe to specific client events
+ *
+ * @example
+ * ```tsx
+ * function PermissionDialog() {
+ *   const [pending, setPending] = useState<PermissionRequest | null>(null);
+ *   const client = useAmux();
+ *
+ *   useAmuxEvent('permission_request', (req) => {
+ *     setPending(req);
+ *   });
+ *
+ *   const handleResponse = (optionId: string) => {
+ *     if (pending) {
+ *       client.respondToPermission(pending.requestId, optionId);
+ *       setPending(null);
+ *     }
+ *   };
+ *
+ *   if (!pending) return null;
+ *   return <Dialog options={pending.options} onSelect={handleResponse} />;
+ * }
+ * ```
+ */
+export declare function useAmuxEvent<K extends keyof AmuxClientEvents>(event: K, handler: (data: AmuxClientEvents[K]) => void): void;
+/**
+ * Get a function to send prompts
+ *
+ * @example
+ * ```tsx
+ * function ChatInput() {
+ *   const sendPrompt = useAmuxPrompt();
+ *   const [message, setMessage] = useState('');
+ *
+ *   const handleSubmit = () => {
+ *     sendPrompt(message);
+ *     setMessage('');
+ *   };
+ *
+ *   return <input value={message} onChange={e => setMessage(e.target.value)} onSubmit={handleSubmit} />;
+ * }
+ * ```
+ */
+export declare function useAmuxPrompt(): (message: string) => void;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,IAAI,UAAU,CAGpC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7C,eAAe,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAaxC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,oBAAoB,EAAE,CAAC;KACjC,GAAG,IAAI,CAAC;CACV;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAS1C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAQ9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC3D,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,IAAI,CAYN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAGzD"}

package/dist/react/hooks.js

@@ -0,0 +1,156 @@
+import { useEffect, useCallback } from 'react';
+import { useAmuxContext } from './context.js';
+/**
+ * Get the AmuxClient instance
+ *
+ * @example
+ * ```tsx
+ * function Chat() {
+ *   const client = useAmux();
+ *
+ *   const handleSubmit = (message: string) => {
+ *     client.prompt(message);
+ *   };
+ *
+ *   return <ChatUI onSubmit={handleSubmit} />;
+ * }
+ * ```
+ */
+export function useAmux() {
+    const { client } = useAmuxContext();
+    return client;
+}
+/**
+ * Get reactive session state
+ *
+ * @example
+ * ```tsx
+ * function StatusBar() {
+ *   const { isConnected, isReady, cwd, agent } = useAmuxState();
+ *
+ *   return (
+ *     <div>
+ *       {isReady ? `${agent?.name} @ ${cwd}` : 'Connecting...'}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useAmuxState() {
+    const { connectionStatus, isConnected, isReady, cwd, sessionId, agent, availableAgents } = useAmuxContext();
+    return {
+        connectionStatus,
+        isConnected,
+        isReady,
+        cwd,
+        sessionId,
+        agent,
+        availableAgents,
+    };
+}
+/**
+ * Get reactive processing status
+ *
+ * @example
+ * ```tsx
+ * function ChatInput() {
+ *   const { isProcessing, isAwaitingPermission } = useAmuxStatus();
+ *   const disabled = isProcessing || isAwaitingPermission;
+ *
+ *   return <input disabled={disabled} ... />;
+ * }
+ * ```
+ */
+export function useAmuxStatus() {
+    const { isProcessing, isStreaming, isAwaitingPermission, pendingPermission } = useAmuxContext();
+    return {
+        isProcessing,
+        isStreaming,
+        isAwaitingPermission,
+        pendingPermission,
+    };
+}
+/**
+ * Get reactive messages and turns
+ *
+ * @example
+ * ```tsx
+ * function MessageList() {
+ *   const { messages, currentTurn } = useAmuxMessages();
+ *
+ *   return (
+ *     <>
+ *       {messages.map(msg => <MessageBubble key={msg.id} message={msg} />)}
+ *       {currentTurn?.status === 'streaming' && <StreamingIndicator />}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export function useAmuxMessages() {
+    const { messages, turns, currentTurn } = useAmuxContext();
+    return {
+        messages,
+        turns,
+        currentTurn,
+    };
+}
+/**
+ * Subscribe to specific client events
+ *
+ * @example
+ * ```tsx
+ * function PermissionDialog() {
+ *   const [pending, setPending] = useState<PermissionRequest | null>(null);
+ *   const client = useAmux();
+ *
+ *   useAmuxEvent('permission_request', (req) => {
+ *     setPending(req);
+ *   });
+ *
+ *   const handleResponse = (optionId: string) => {
+ *     if (pending) {
+ *       client.respondToPermission(pending.requestId, optionId);
+ *       setPending(null);
+ *     }
+ *   };
+ *
+ *   if (!pending) return null;
+ *   return <Dialog options={pending.options} onSelect={handleResponse} />;
+ * }
+ * ```
+ */
+export function useAmuxEvent(event, handler) {
+    const { client } = useAmuxContext();
+    // Wrap handler in useCallback to maintain stable reference
+    const stableHandler = useCallback(handler, [handler]);
+    useEffect(() => {
+        client.on(event, stableHandler);
+        return () => {
+            client.off(event, stableHandler);
+        };
+    }, [client, event, stableHandler]);
+}
+/**
+ * Get a function to send prompts
+ *
+ * @example
+ * ```tsx
+ * function ChatInput() {
+ *   const sendPrompt = useAmuxPrompt();
+ *   const [message, setMessage] = useState('');
+ *
+ *   const handleSubmit = () => {
+ *     sendPrompt(message);
+ *     setMessage('');
+ *   };
+ *
+ *   return <input value={message} onChange={e => setMessage(e.target.value)} onSubmit={handleSubmit} />;
+ * }
+ * ```
+ */
+export function useAmuxPrompt() {
+    const { client } = useAmuxContext();
+    return useCallback((message) => client.prompt(message), [client]);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/react/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAeD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,GACtF,cAAc,EAAE,CAAC;IAEnB,OAAO;QACL,gBAAgB;QAChB,WAAW;QACX,OAAO;QACP,GAAG;QACH,SAAS;QACT,KAAK;QACL,eAAe;KAChB,CAAC;AACJ,CAAC;AAgBD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEhG,OAAO;QACL,YAAY;QACZ,WAAW;QACX,oBAAoB;QACpB,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAAC;IAE1D,OAAO;QACL,QAAQ;QACR,KAAK;QACL,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAQ,EACR,OAA4C;IAE5C,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAEpC,2DAA2D;IAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAChC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACnC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IACpC,OAAO,WAAW,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * React integration for @bytespell/amux-client
+ *
+ * @example
+ * ```tsx
+ * import { AmuxProvider, useAmux, useAmuxState, useAmuxMessages } from '@bytespell/amux-client/react';
+ *
+ * function App() {
+ *   return (
+ *     <AmuxProvider url="ws://localhost:3000/ws" autoConnect>
+ *       <Chat />
+ *     </AmuxProvider>
+ *   );
+ * }
+ *
+ * function Chat() {
+ *   const client = useAmux();
+ *   const { isReady, cwd, agent } = useAmuxState();
+ *   const { messages, currentTurn } = useAmuxMessages();
+ *
+ *   // ...
+ * }
+ * ```
+ */
+export { AmuxProvider, useAmuxContext } from './context.js';
+export type { AmuxContextValue, AmuxProviderProps } from './context.js';
+export { useAmux, useAmuxState, useAmuxStatus, useAmuxMessages, useAmuxEvent, useAmuxPrompt, } from './hooks.js';
+export type { AmuxState, AmuxStatus, AmuxMessages } from './hooks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,27 @@
+/**
+ * React integration for @bytespell/amux-client
+ *
+ * @example
+ * ```tsx
+ * import { AmuxProvider, useAmux, useAmuxState, useAmuxMessages } from '@bytespell/amux-client/react';
+ *
+ * function App() {
+ *   return (
+ *     <AmuxProvider url="ws://localhost:3000/ws" autoConnect>
+ *       <Chat />
+ *     </AmuxProvider>
+ *   );
+ * }
+ *
+ * function Chat() {
+ *   const client = useAmux();
+ *   const { isReady, cwd, agent } = useAmuxState();
+ *   const { messages, currentTurn } = useAmuxMessages();
+ *
+ *   // ...
+ * }
+ * ```
+ */
+export { AmuxProvider, useAmuxContext } from './context.js';
+export { useAmux, useAmuxState, useAmuxStatus, useAmuxMessages, useAmuxEvent, useAmuxPrompt, } from './hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC"}