@agentick/react 0.0.1

package/dist/hooks.js

@@ -0,0 +1,442 @@
+/**
+ * React hooks for Agentick.
+ *
+ * @module @agentick/react/hooks
+ */
+import { useState, useEffect, useCallback, useRef, useSyncExternalStore, useMemo, useContext, } from "react";
+import { AgentickContext } from "./context";
+// ============================================================================
+// useClient
+// ============================================================================
+/**
+ * Access the Agentick client from context.
+ *
+ * @throws If used outside of AgentickProvider
+ *
+ * @example
+ * ```tsx
+ * import { useClient } from '@agentick/react';
+ *
+ * function MyComponent() {
+ *   const client = useClient();
+ *
+ *   // Direct client access for advanced use cases
+ *   const handleCustomChannel = () => {
+ *     const session = client.session('conv-123');
+ *     const channel = session.channel('custom');
+ *     channel.publish('event', { data: 'value' });
+ *   };
+ *
+ *   return <button onClick={handleCustomChannel}>Send</button>;
+ * }
+ * ```
+ */
+export function useClient() {
+    const context = useContext(AgentickContext);
+    if (!context) {
+        throw new Error("useClient must be used within a AgentickProvider");
+    }
+    return context.client;
+}
+// ============================================================================
+// useConnectionState (alias for useConnection)
+// ============================================================================
+/**
+ * Subscribe to connection state changes.
+ *
+ * @example
+ * ```tsx
+ * import { useConnectionState } from '@agentick/react';
+ *
+ * function ConnectionIndicator() {
+ *   const state = useConnectionState();
+ *
+ *   return (
+ *     <div className={`indicator ${state}`}>
+ *       {state === 'connected' ? 'Online' : 'Offline'}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useConnectionState() {
+    const client = useClient();
+    const [state, setState] = useState(client.state);
+    useEffect(() => {
+        // Sync initial state
+        setState(client.state);
+        // Subscribe to changes
+        const unsubscribe = client.onConnectionChange(setState);
+        return unsubscribe;
+    }, [client]);
+    return state;
+}
+// ============================================================================
+// useConnection
+// ============================================================================
+/**
+ * Read the SSE connection state.
+ */
+export function useConnection(_options = {}) {
+    const client = useClient();
+    const [state, setState] = useState(client.state);
+    useEffect(() => {
+        setState(client.state);
+        return client.onConnectionChange(setState);
+    }, [client]);
+    return {
+        state,
+        isConnected: state === "connected",
+        isConnecting: state === "connecting",
+    };
+}
+// ============================================================================
+// useSession
+// ============================================================================
+/**
+ * Work with a specific session.
+ *
+ * @example Basic usage with session ID
+ * ```tsx
+ * import { useSession } from '@agentick/react';
+ *
+ * function Chat({ sessionId }: { sessionId: string }) {
+ *   const { send, isSubscribed, subscribe } = useSession({ sessionId });
+ *   const [input, setInput] = useState('');
+ *
+ *   // Subscribe on mount
+ *   useEffect(() => {
+ *     subscribe();
+ *   }, [subscribe]);
+ *
+ *   const handleSend = async () => {
+ *     await send(input);
+ *     setInput('');
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input value={input} onChange={(e) => setInput(e.target.value)} />
+ *       <button onClick={handleSend}>Send</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example Ephemeral session (no sessionId)
+ * ```tsx
+ * function QuickChat() {
+ *   const { send } = useSession();
+ *
+ *   // Each send creates/uses an ephemeral session
+ *   const handleSend = () => send('Hello!');
+ *
+ *   return <button onClick={handleSend}>Ask</button>;
+ * }
+ * ```
+ *
+ * @example Auto-subscribe
+ * ```tsx
+ * function Chat({ sessionId }: { sessionId: string }) {
+ *   const { send, isSubscribed } = useSession({
+ *     sessionId,
+ *     autoSubscribe: true,
+ *   });
+ *
+ *   if (!isSubscribed) return <div>Subscribing...</div>;
+ *
+ *   return <ChatInterface />;
+ * }
+ * ```
+ */
+export function useSession(options = {}) {
+    const { sessionId, autoSubscribe = false } = options;
+    const client = useClient();
+    const mountedRef = useRef(true);
+    // Get or create session accessor
+    const accessor = useMemo(() => {
+        if (!sessionId)
+            return undefined;
+        return client.session(sessionId);
+    }, [client, sessionId]);
+    const [isSubscribed, setIsSubscribed] = useState(false);
+    // Cleanup on unmount
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    // Subscribe function
+    const subscribe = useCallback(() => {
+        if (!accessor)
+            return;
+        accessor.subscribe();
+        if (mountedRef.current) {
+            setIsSubscribed(true);
+        }
+    }, [accessor]);
+    // Unsubscribe function
+    const unsubscribe = useCallback(() => {
+        if (!accessor)
+            return;
+        accessor.unsubscribe();
+        if (mountedRef.current) {
+            setIsSubscribed(false);
+        }
+    }, [accessor]);
+    // Auto-subscribe
+    useEffect(() => {
+        if (autoSubscribe && accessor && !isSubscribed) {
+            subscribe();
+        }
+    }, [autoSubscribe, accessor, isSubscribed, subscribe]);
+    // Send function
+    const send = useCallback((input) => {
+        if (accessor) {
+            const normalizedInput = typeof input === "string"
+                ? {
+                    message: {
+                        role: "user",
+                        content: [{ type: "text", text: input }],
+                    },
+                }
+                : input;
+            return accessor.send(normalizedInput);
+        }
+        return client.send(input);
+    }, [client, accessor]);
+    // Abort function
+    const abort = useCallback(async (reason) => {
+        if (accessor) {
+            await accessor.abort(reason);
+        }
+        else if (sessionId) {
+            await client.abort(sessionId, reason);
+        }
+    }, [client, accessor, sessionId]);
+    // Close function
+    const close = useCallback(async () => {
+        if (accessor) {
+            await accessor.close();
+        }
+        else if (sessionId) {
+            await client.closeSession(sessionId);
+        }
+    }, [client, accessor, sessionId]);
+    return {
+        sessionId,
+        isSubscribed,
+        subscribe,
+        unsubscribe,
+        send,
+        abort,
+        close,
+        accessor,
+    };
+}
+// ============================================================================
+// useEvents
+// ============================================================================
+/**
+ * Subscribe to stream events.
+ *
+ * Returns the latest event (not accumulated). Use useStreamingText
+ * for accumulated text from content_delta events.
+ *
+ * @example
+ * ```tsx
+ * import { useEvents } from '@agentick/react';
+ *
+ * function EventLog() {
+ *   const { event } = useEvents();
+ *
+ *   useEffect(() => {
+ *     if (event) {
+ *       console.log('Event:', event.type, event);
+ *     }
+ *   }, [event]);
+ *
+ *   return <div>Latest: {event?.type}</div>;
+ * }
+ * ```
+ *
+ * @example With filter
+ * ```tsx
+ * function ToolCalls() {
+ *   const { event } = useEvents({ filter: ['tool_call', 'tool_result'] });
+ *
+ *   if (!event) return null;
+ *
+ *   return <div>Tool: {event.type === 'tool_call' ? event.name : 'result'}</div>;
+ * }
+ * ```
+ *
+ * @example Session-specific events
+ * ```tsx
+ * function SessionEvents({ sessionId }: { sessionId: string }) {
+ *   const { event } = useEvents({ sessionId });
+ *   // Only receives events for this session
+ *   return <div>{event?.type}</div>;
+ * }
+ * ```
+ */
+export function useEvents(options = {}) {
+    const { filter, sessionId, enabled = true } = options;
+    const client = useClient();
+    const [event, setEvent] = useState();
+    useEffect(() => {
+        if (!enabled)
+            return;
+        // Use session-specific subscription if sessionId provided
+        if (sessionId) {
+            const accessor = client.session(sessionId);
+            const unsubscribe = accessor.onEvent((incoming) => {
+                if (filter && !filter.includes(incoming.type)) {
+                    return;
+                }
+                setEvent(incoming);
+            });
+            return unsubscribe;
+        }
+        // Global subscription
+        const unsubscribe = client.onEvent((incoming) => {
+            if (filter && !filter.includes(incoming.type)) {
+                return;
+            }
+            setEvent(incoming);
+        });
+        return unsubscribe;
+    }, [client, sessionId, enabled, filter]);
+    const clear = useCallback(() => {
+        setEvent(undefined);
+    }, []);
+    return { event, clear };
+}
+// ============================================================================
+// useStreamingText
+// ============================================================================
+/**
+ * Subscribe to streaming text from the client.
+ *
+ * Uses the client's built-in streaming text accumulation which handles
+ * tick_start, content_delta, tick_end, and execution_end events.
+ *
+ * @example
+ * ```tsx
+ * import { useStreamingText } from '@agentick/react';
+ *
+ * function StreamingResponse() {
+ *   const { text, isStreaming } = useStreamingText();
+ *
+ *   return (
+ *     <div>
+ *       <p>{text}</p>
+ *       {isStreaming && <span className="cursor">|</span>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useStreamingText(options = {}) {
+    const { enabled = true } = options;
+    const client = useClient();
+    // Use useSyncExternalStore for concurrent-safe subscription
+    const state = useSyncExternalStore(useCallback((onStoreChange) => {
+        if (!enabled)
+            return () => { };
+        return client.onStreamingText(onStoreChange);
+    }, [client, enabled]), () => (enabled ? client.streamingText : { text: "", isStreaming: false }), () => ({ text: "", isStreaming: false }));
+    const clear = useCallback(() => {
+        client.clearStreamingText();
+    }, [client]);
+    return { text: state.text, isStreaming: state.isStreaming, clear };
+}
+/**
+ * Subscribe to context utilization info from the server.
+ *
+ * Receives context_update events after each tick with:
+ * - Token usage (input, output, total)
+ * - Context utilization percentage
+ * - Model capabilities (vision, tools, reasoning)
+ * - Cumulative usage across ticks
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { useContextInfo } from '@agentick/react';
+ *
+ * function ContextBar() {
+ *   const { contextInfo } = useContextInfo();
+ *
+ *   if (!contextInfo) return null;
+ *
+ *   return (
+ *     <div className="context-bar">
+ *       <span>{contextInfo.modelId}</span>
+ *       <span>{contextInfo.utilization?.toFixed(1)}% used</span>
+ *       <progress value={contextInfo.utilization} max={100} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example Session-specific context info
+ * ```tsx
+ * function SessionContext({ sessionId }: { sessionId: string }) {
+ *   const { contextInfo } = useContextInfo({ sessionId });
+ *
+ *   if (!contextInfo) return <span>No context yet</span>;
+ *
+ *   return (
+ *     <span>
+ *       {contextInfo.inputTokens.toLocaleString()} /
+ *       {contextInfo.contextWindow?.toLocaleString() ?? '?'} tokens
+ *     </span>
+ *   );
+ * }
+ * ```
+ */
+export function useContextInfo(options = {}) {
+    const { sessionId, enabled = true } = options;
+    const client = useClient();
+    const [contextInfo, setContextInfo] = useState(null);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        // Subscribe to context_update events
+        const handleEvent = (event) => {
+            if (event.type !== "context_update")
+                return;
+            // Type assertion since we filtered by type
+            const ctxEvent = event;
+            setContextInfo({
+                modelId: ctxEvent.modelId,
+                modelName: ctxEvent.modelName,
+                provider: ctxEvent.provider,
+                contextWindow: ctxEvent.contextWindow,
+                inputTokens: ctxEvent.inputTokens,
+                outputTokens: ctxEvent.outputTokens,
+                totalTokens: ctxEvent.totalTokens,
+                utilization: ctxEvent.utilization,
+                maxOutputTokens: ctxEvent.maxOutputTokens,
+                supportsVision: ctxEvent.supportsVision,
+                supportsToolUse: ctxEvent.supportsToolUse,
+                isReasoningModel: ctxEvent.isReasoningModel,
+                tick: ctxEvent.tick,
+                cumulativeUsage: ctxEvent.cumulativeUsage,
+            });
+        };
+        // Use session-specific subscription if sessionId provided
+        if (sessionId) {
+            const accessor = client.session(sessionId);
+            return accessor.onEvent(handleEvent);
+        }
+        // Global subscription
+        return client.onEvent(handleEvent);
+    }, [client, sessionId, enabled]);
+    const clear = useCallback(() => {
+        setContextInfo(null);
+    }, []);
+    return { contextInfo, clear };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @agentick/react - React hooks and components for Agentick
+ *
+ * Provides React bindings for connecting to Agentick servers.
+ * Wraps @agentick/client with idiomatic React patterns.
+ *
+ * @example Quick start
+ * ```tsx
+ * import { AgentickProvider, useSession, useStreamingText } from '@agentick/react';
+ *
+ * function App() {
+ *   return (
+ *     <AgentickProvider clientConfig={{ baseUrl: 'https://api.example.com' }}>
+ *       <Chat />
+ *     </AgentickProvider>
+ *   );
+ * }
+ *
+ * function Chat() {
+ *   const { send } = useSession({ sessionId: 'my-session' });
+ *   const { text, isStreaming } = useStreamingText();
+ *   const [input, setInput] = useState('');
+ *
+ *   const handleSend = async () => {
+ *     await send(input);
+ *     setInput('');
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <div className="response">
+ *         {text}
+ *         {isStreaming && <span className="cursor">|</span>}
+ *       </div>
+ *       <input value={input} onChange={(e) => setInput(e.target.value)} />
+ *       <button onClick={handleSend}>Send</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example With authentication
+ * ```tsx
+ * function App() {
+ *   const { token } = useAuth();
+ *
+ *   return (
+ *     <AgentickProvider
+ *       clientConfig={{
+ *         baseUrl: 'https://api.example.com',
+ *         token,
+ *       }}
+ *     >
+ *       <Chat />
+ *     </AgentickProvider>
+ *   );
+ * }
+ * ```
+ *
+ * ## Hooks
+ *
+ * | Hook | Purpose |
+ * |------|---------|
+ * | `useClient()` | Direct client access |
+ * | `useConnection()` | SSE connection state |
+ * | `useSession(opts?)` | Session accessor (send, abort, close) |
+ * | `useConnectionState()` | Connection state subscription |
+ * | `useEvents(opts?)` | Stream event subscription |
+ * | `useStreamingText(opts?)` | Accumulated text from deltas |
+ * | `useEvents(opts?)` | Stream event subscription |
+ *
+ * @module @agentick/react
+ */
+export { AgentickProvider } from "./context";
+export { useClient, useConnection, useSession, useConnectionState, useEvents, useStreamingText, useContextInfo, type ContextInfo, type UseContextInfoOptions, type UseContextInfoResult, } from "./hooks";
+export type { AgentickProviderProps, AgentickContextValue, TransportConfig, UseConnectionOptions, UseConnectionResult, UseSessionOptions, UseSessionResult, UseEventsOptions, UseEventsResult, UseStreamingTextOptions, UseStreamingTextResult, } from "./types.js";
+export type { AgentickClient, ConnectionState, StreamEvent, SessionAccessor, SendInput, ClientExecutionHandle, SessionStreamEvent, ClientTransport, } from "@agentick/client";
+export { createClient } from "@agentick/client";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,SAAS,CAAC;AAGjB,YAAY,EAEV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EAGf,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,eAAe,EACf,SAAS,EACT,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,80 @@
+/**
+ * @agentick/react - React hooks and components for Agentick
+ *
+ * Provides React bindings for connecting to Agentick servers.
+ * Wraps @agentick/client with idiomatic React patterns.
+ *
+ * @example Quick start
+ * ```tsx
+ * import { AgentickProvider, useSession, useStreamingText } from '@agentick/react';
+ *
+ * function App() {
+ *   return (
+ *     <AgentickProvider clientConfig={{ baseUrl: 'https://api.example.com' }}>
+ *       <Chat />
+ *     </AgentickProvider>
+ *   );
+ * }
+ *
+ * function Chat() {
+ *   const { send } = useSession({ sessionId: 'my-session' });
+ *   const { text, isStreaming } = useStreamingText();
+ *   const [input, setInput] = useState('');
+ *
+ *   const handleSend = async () => {
+ *     await send(input);
+ *     setInput('');
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <div className="response">
+ *         {text}
+ *         {isStreaming && <span className="cursor">|</span>}
+ *       </div>
+ *       <input value={input} onChange={(e) => setInput(e.target.value)} />
+ *       <button onClick={handleSend}>Send</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example With authentication
+ * ```tsx
+ * function App() {
+ *   const { token } = useAuth();
+ *
+ *   return (
+ *     <AgentickProvider
+ *       clientConfig={{
+ *         baseUrl: 'https://api.example.com',
+ *         token,
+ *       }}
+ *     >
+ *       <Chat />
+ *     </AgentickProvider>
+ *   );
+ * }
+ * ```
+ *
+ * ## Hooks
+ *
+ * | Hook | Purpose |
+ * |------|---------|
+ * | `useClient()` | Direct client access |
+ * | `useConnection()` | SSE connection state |
+ * | `useSession(opts?)` | Session accessor (send, abort, close) |
+ * | `useConnectionState()` | Connection state subscription |
+ * | `useEvents(opts?)` | Stream event subscription |
+ * | `useStreamingText(opts?)` | Accumulated text from deltas |
+ * | `useEvents(opts?)` | Stream event subscription |
+ *
+ * @module @agentick/react
+ */
+// Provider
+export { AgentickProvider } from "./context";
+// Hooks
+export { useClient, useConnection, useSession, useConnectionState, useEvents, useStreamingText, useContextInfo, } from "./hooks";
+// Re-export createClient for users who want to create a client manually
+export { createClient } from "@agentick/client";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AAEH,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,QAAQ;AACR,OAAO,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,cAAc,GAIf,MAAM,SAAS,CAAC;AAgCjB,wEAAwE;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}