bashkit 0.5.1 → 0.5.2

package/dist/react/index.d.ts

@@ -1,42 +0,0 @@
-/**
- * bashkit/react - React hooks for connecting to BashKit agents
- *
- * This module re-exports hooks from the Cloudflare Agents SDK for connecting
- * to agents from React applications.
- *
- * @example
- * ```tsx
- * import { useAgent, useAgentChat } from 'bashkit/react';
- *
- * function Chat() {
- *   // Connect to the agent
- *   const agent = useAgent({
- *     agent: 'my-agent',
- *     name: sessionId,
- *   });
- *
- *   // Use the chat hook for AI conversations
- *   const { messages, input, handleSubmit, handleInputChange } = useAgentChat({
- *     agent,
- *   });
- *
- *   return (
- *     <div>
- *       {messages.map((msg, i) => (
- *         <div key={i}>
- *           <strong>{msg.role}:</strong> {msg.content}
- *         </div>
- *       ))}
- *       <form onSubmit={handleSubmit}>
- *         <input value={input} onChange={handleInputChange} />
- *         <button type="submit">Send</button>
- *       </form>
- *     </div>
- *   );
- * }
- * ```
- */
-export { useAgent } from "agents/react";
-export { useAgentChat } from "agents/ai-react";
-export { AgentClient, agentFetch } from "agents/client";
-export type { UseAgentOptions } from "agents/react";

package/dist/react/index.js

@@ -1,10 +0,0 @@
-// src/react/index.ts
-import { useAgent } from "agents/react";
-import { useAgentChat } from "agents/ai-react";
-import { AgentClient, agentFetch } from "agents/client";
-export {
-  useAgentChat,
-  useAgent,
-  agentFetch,
-  AgentClient
-};

package/dist/react/types.d.ts

@@ -1,333 +0,0 @@
-/**
- * Connection status for the agent WebSocket.
- */
-export type ConnectionStatus = "connecting" | "connected" | "disconnected" | "reconnecting";
-/**
- * Configuration for the useAgent hook.
- */
-export interface UseAgentConfig<TMessage = unknown> {
-    /**
-     * The WebSocket URL to connect to.
-     * Should be your Cloudflare Worker URL.
-     */
-    url: string;
-    /**
-     * The session ID to connect to.
-     * Each session ID maps to a separate Durable Object.
-     */
-    sessionId: string;
-    /**
-     * Called when a message is received from the server.
-     */
-    onMessage?: (message: TMessage) => void;
-    /**
-     * Called when the connection is established.
-     */
-    onConnect?: () => void;
-    /**
-     * Called when the connection is closed.
-     */
-    onDisconnect?: (event: CloseEvent) => void;
-    /**
-     * Called when an error occurs.
-     */
-    onError?: (error: Event) => void;
-    /**
-     * Called when reconnecting with buffered content.
-     * The buffered content is sent by the server's onReconnect handler.
-     */
-    onReconnect?: (bufferedChunks: string[]) => void;
-    /**
-     * Whether to automatically reconnect on disconnect.
-     * @default true
-     */
-    autoReconnect?: boolean;
-    /**
-     * Delay in milliseconds before attempting to reconnect.
-     * @default 1000
-     */
-    reconnectDelay?: number;
-    /**
-     * Maximum number of reconnection attempts.
-     * @default 5
-     */
-    maxReconnectAttempts?: number;
-    /**
-     * Whether the hook should connect immediately.
-     * Set to false to manually control connection via `connect()`.
-     * @default true
-     */
-    enabled?: boolean;
-}
-/**
- * Return type of the useAgent hook.
- */
-export interface UseAgentReturn<TMessage = unknown> {
-    /**
-     * Current connection status.
-     */
-    status: ConnectionStatus;
-    /**
-     * Whether the WebSocket is currently connected.
-     */
-    isConnected: boolean;
-    /**
-     * Accumulated messages received from the server.
-     */
-    messages: TMessage[];
-    /**
-     * Send a message to the server.
-     */
-    sendMessage: (message: unknown) => void;
-    /**
-     * Manually connect to the server.
-     * Only needed if `enabled: false` was passed.
-     */
-    connect: () => void;
-    /**
-     * Manually disconnect from the server.
-     */
-    disconnect: () => void;
-    /**
-     * Clear all accumulated messages.
-     */
-    clearMessages: () => void;
-    /**
-     * The raw WebSocket instance (for advanced use).
-     */
-    socket: WebSocket | null;
-    /**
-     * Number of reconnection attempts made.
-     */
-    reconnectAttempts: number;
-    /**
-     * Any error that occurred during connection.
-     */
-    error: Event | null;
-}
-/**
- * Options for individual message sending.
- */
-export interface SendMessageOptions {
-    /**
-     * Whether to wait for connection before sending.
-     * If true, the message will be queued and sent when connected.
-     * @default false
-     */
-    queue?: boolean;
-}
-/**
- * Message types commonly sent between client and server.
- */
-export interface AgentMessage<T = unknown> {
-    type: string;
-    data?: T;
-    timestamp?: number;
-}
-/**
- * Common message types for agent communication.
- */
-export interface ChunkMessage {
-    type: "chunk";
-    text: string;
-}
-export interface StatusMessage {
-    type: "status";
-    status: "thinking" | "executing" | "idle";
-}
-export interface ErrorMessage {
-    type: "error";
-    error: string;
-    message?: string;
-}
-export interface ReconnectMessage {
-    type: "reconnect";
-    bufferedChunks: string[];
-}
-export interface StateMessage<T = unknown> {
-    type: "state";
-    data: T;
-}
-/**
- * Union of common message types.
- */
-export type CommonAgentMessage<T = unknown> = ChunkMessage | StatusMessage | ErrorMessage | ReconnectMessage | StateMessage<T>;
-/**
- * Status of the chat generation.
- * Matches Vercel AI SDK useChat status values.
- */
-export type DurableChatStatus = "ready" | "submitted" | "streaming" | "error";
-/**
- * A part of a chat message (text, tool call, or tool result).
- * Matches Vercel AI SDK UIMessagePart structure.
- */
-export type DurableChatPart = {
-    type: "text";
-    text: string;
-} | {
-    type: "tool-call";
-    toolCallId: string;
-    toolName: string;
-    args: unknown;
-} | {
-    type: "tool-result";
-    toolCallId: string;
-    toolName: string;
-    result: unknown;
-};
-/**
- * A chat message with parts.
- * Matches Vercel AI SDK UIMessage structure.
- */
-export interface DurableChatMessage {
-    id: string;
-    role: "user" | "assistant" | "system";
-    parts: DurableChatPart[];
-    createdAt?: Date;
-    metadata?: unknown;
-}
-/**
- * Server-to-client message types for streaming chat.
- */
-export type ServerMessage = {
-    type: "message-start";
-    id: string;
-    role: "assistant" | "system";
-} | {
-    type: "text-delta";
-    text: string;
-} | {
-    type: "tool-call";
-    toolCallId: string;
-    toolName: string;
-    args: unknown;
-} | {
-    type: "tool-result";
-    toolCallId: string;
-    toolName: string;
-    result: unknown;
-} | {
-    type: "message-end";
-} | {
-    type: "error";
-    error: string;
-} | {
-    type: "aborted";
-};
-/**
- * Client-to-server message types.
- */
-export type ClientMessage = {
-    type: "chat";
-    content: string;
-    metadata?: unknown;
-    [key: string]: unknown;
-} | {
-    type: "abort";
-} | {
-    type: "regenerate";
-    messageId?: string;
-};
-/**
- * Configuration for the useDurableChat hook.
- */
-export interface UseDurableChatConfig {
-    /**
-     * The WebSocket URL to connect to.
-     */
-    url: string;
-    /**
-     * The session ID for the chat.
-     */
-    sessionId: string;
-    /**
-     * Called when any server message is received.
-     */
-    onMessage?: (message: ServerMessage) => void;
-    /**
-     * Called when an assistant message is complete.
-     */
-    onFinish?: (message: DurableChatMessage) => void;
-    /**
-     * Called when an error occurs.
-     */
-    onError?: (error: Error) => void;
-    /**
-     * Whether the hook should connect immediately.
-     * @default true
-     */
-    enabled?: boolean;
-}
-/**
- * Return type of the useDurableChat hook.
- * API mirrors Vercel AI SDK useChat for familiarity.
- */
-export interface UseDurableChatReturn {
-    /**
-     * The array of chat messages.
-     */
-    messages: DurableChatMessage[];
-    /**
-     * Current status of the chat generation.
-     */
-    status: DurableChatStatus;
-    /**
-     * Error if one occurred.
-     */
-    error: Error | null;
-    /**
-     * Whether the assistant is currently streaming a response.
-     */
-    isStreaming: boolean;
-    /**
-     * Whether a request is in progress (submitted or streaming).
-     */
-    isLoading: boolean;
-    /**
-     * Send a message to the chat.
-     */
-    sendMessage: (content: string | {
-        text: string;
-        [key: string]: unknown;
-    }, options?: {
-        body?: Record<string, unknown>;
-    }) => void;
-    /**
-     * Stop/abort the current generation.
-     */
-    stop: () => void;
-    /**
-     * Regenerate the last assistant message or a specific message.
-     */
-    regenerate: (options?: {
-        messageId?: string;
-    }) => void;
-    /**
-     * Update messages locally without sending to server.
-     */
-    setMessages: React.Dispatch<React.SetStateAction<DurableChatMessage[]>>;
-    /**
-     * Clear all messages.
-     */
-    clearMessages: () => void;
-    /**
-     * Clear the error state.
-     */
-    clearError: () => void;
-    /**
-     * WebSocket connection status.
-     */
-    connectionStatus: ConnectionStatus;
-    /**
-     * Whether the WebSocket is connected.
-     */
-    isConnected: boolean;
-    /**
-     * Manually connect to the server.
-     */
-    connect: () => void;
-    /**
-     * Manually disconnect from the server.
-     */
-    disconnect: () => void;
-}

package/dist/react/use-agent.d.ts

@@ -1,33 +0,0 @@
-import type { UseAgentConfig, UseAgentReturn } from "./types";
-/**
- * React hook for connecting to a bashkit durable agent session.
- *
- * @example
- * ```tsx
- * import { useAgent } from 'bashkit/react';
- *
- * function ChatUI() {
- *   const {
- *     status,
- *     messages,
- *     sendMessage,
- *     isConnected,
- *   } = useAgent({
- *     url: 'https://my-agent.workers.dev',
- *     sessionId: 'conversation-123',
- *     onMessage: (msg) => console.log('Received:', msg),
- *   });
- *
- *   return (
- *     <div>
- *       <p>Status: {status}</p>
- *       {messages.map((msg, i) => <div key={i}>{JSON.stringify(msg)}</div>)}
- *       <button onClick={() => sendMessage({ type: 'chat', text: 'Hello!' })}>
- *         Send
- *       </button>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function useAgent<TMessage = unknown>(config: UseAgentConfig<TMessage>): UseAgentReturn<TMessage>;

package/dist/react/use-durable-chat.d.ts

@@ -1,39 +0,0 @@
-import type { UseDurableChatConfig, UseDurableChatReturn } from "./types";
-/**
- * React hook for durable chat sessions with streaming support.
- * Provides a similar API to Vercel AI SDK's useChat but over WebSockets
- * with durable session support.
- *
- * @example
- * ```tsx
- * import { useDurableChat } from 'bashkit/react';
- *
- * function Chat() {
- *   const {
- *     messages,
- *     status,
- *     sendMessage,
- *     stop,
- *     isStreaming,
- *   } = useDurableChat({
- *     url: 'https://my-agent.workers.dev',
- *     sessionId: 'conversation-123',
- *   });
- *
- *   return (
- *     <div>
- *       {messages.map(msg => (
- *         <div key={msg.id}>
- *           <strong>{msg.role}:</strong>
- *           {msg.parts.map((part, i) => (
- *             part.type === 'text' ? <span key={i}>{part.text}</span> : null
- *           ))}
- *         </div>
- *       ))}
- *       <button onClick={stop} disabled={!isStreaming}>Stop</button>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function useDurableChat(config: UseDurableChatConfig): UseDurableChatReturn;

package/dist/workflow.d.ts

@@ -1,52 +0,0 @@
-/**
- * Bashkit Workflow Integration
- *
- * Durable agent tools for Vercel's Workflow DevKit.
- * Each tool execution is wrapped with "use step" for automatic
- * durability, retries, and checkpointing.
- *
- * @example
- * ```typescript
- * import { createDurableAgentTools } from 'bashkit/workflow';
- * import { DurableAgent } from '@workflow/ai/agent';
- *
- * export async function generateReport(sandboxId: string) {
- *   "use workflow";
- *
- *   const { tools } = createDurableAgentTools(sandboxId);
- *
- *   const agent = new DurableAgent({
- *     model: "anthropic/claude-sonnet-4-20250514",
- *     tools,
- *   });
- *
- *   await agent.run({ prompt: "Generate the report" });
- * }
- * ```
- */
-import { type ToolSet } from "ai";
-import type { AgentConfig } from "./types";
-export interface DurableAgentConfig extends Omit<AgentConfig, "cache"> {
-    /**
-     * E2B API key (optional, uses ANTHROPIC_API_KEY env var by default)
-     */
-    apiKey?: string;
-}
-export interface DurableAgentToolsResult {
-    tools: ToolSet;
-}
-/**
- * Creates durable agent tools for Workflow DevKit.
- *
- * Each tool execution:
- * 1. Is wrapped with "use step" for durability
- * 2. Reconnects to the E2B sandbox via sandboxId
- * 3. Can retry independently on failure
- * 4. Works with parallel tool calls (each gets own correlationId)
- *
- * @param sandboxId - E2B sandbox ID to reconnect to
- * @param config - Optional tool configuration
- */
-export declare function createDurableAgentTools(sandboxId: string, config?: DurableAgentConfig): DurableAgentToolsResult;
-export type { Sandbox } from "./sandbox/interface";
-export type { ToolConfig, AgentConfig } from "./types";