@optima-chat/agentic-sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Public types for @optima-chat/agentic-sdk.
+ *
+ * These are the types consumers see. They are distinct from the gateway protocol
+ * types in @optima-chat/gateway-protocol — this module performs field/type
+ * mapping (snake_case → camelCase, ISO strings → epoch ms, etc.) before the
+ * state reaches consumers.
+ */
+import type { ServerEvent, ClientEvent, FinishInfo, Question, ApprovalRequest, ApprovalResponse, TokenProgress, BillingError, ToolResultContentBlock } from '@optima-chat/gateway-protocol';
+import type { WorkspaceProvider } from './workspace/types.js';
+/** WebSocket connection lifecycle state. */
+export type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnected' | 'auth_failed';
+/** Message lifecycle status. */
+export type MessageStatus = 'pending' | 'streaming' | 'complete' | 'error';
+/** Tool-call lifecycle status. */
+export type ToolCallStatus = 'pending' | 'executing' | 'awaiting_approval' | 'completed' | 'error';
+/** Error surfaced to consumers. */
+export interface ChatError {
+    code: string;
+    message: string;
+    retryable?: boolean;
+    details?: unknown;
+}
+/** Conversation summary. */
+export interface Conversation {
+    id: string;
+    title: string;
+    /** Epoch ms, converted from protocol's ISO-8601 string. */
+    lastMessageAt: number;
+    messageCount: number;
+    /** Epoch ms. 0 when session_ready's ConversationSummary doesn't carry it. */
+    createdAt: number;
+}
+/** Attachment (image/file/audio) on a Message — v1 only for user messages. */
+export interface MessageAttachment {
+    type: 'image' | 'file' | 'audio';
+    url: string;
+    name?: string;
+    mediaType?: string;
+    /** Audio-only: duration in ms. */
+    duration?: number;
+    /** Audio-only: transcribed text. */
+    transcription?: string;
+}
+/** Tool call attached to an assistant Message. */
+export interface ToolCall {
+    id: string;
+    /** Mapped from protocol's ToolCallInfo.name. */
+    toolName: string;
+    /** JSON string, mapped from protocol's ToolCallInfo.arguments. */
+    arguments: string;
+    status: ToolCallStatus;
+    /** Mapped from protocol's ToolResultInfo.output. */
+    result?: string;
+    /** Mapped from protocol's ToolResultInfo.content_blocks. */
+    resultContentBlocks?: ToolResultContentBlock[];
+    error?: string;
+    progress?: {
+        message: string;
+        percentage?: number;
+    };
+}
+/** Chat message — user / assistant / system. */
+export interface Message {
+    id: string;
+    conversationId: string;
+    role: 'user' | 'assistant' | 'system';
+    /** Accumulated full text. */
+    content: string;
+    toolCalls: ToolCall[];
+    attachments?: MessageAttachment[];
+    status: MessageStatus;
+    /** Epoch ms. */
+    createdAt: number;
+    /** Optional retention of raw protocol events. */
+    rawEvents?: ServerEvent[];
+}
+/** Pending ask_question state. */
+export interface QuestionRequest {
+    requestId: string;
+    /** Filled by agentic-sdk from the currently active conversation. */
+    conversationId: string;
+    questions: Question[];
+}
+/** Pending approval_request (ApprovalRequest + conversationId). */
+export interface ApprovalRequestWithId {
+    requestId: string;
+    /** Filled by agentic-sdk from the currently active conversation. */
+    conversationId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    description?: string;
+    risk?: 'low' | 'medium' | 'high';
+}
+/** Options for sendMessage. */
+export interface SendMessageOptions {
+    images?: File[];
+    files?: File[];
+    audio?: File[];
+    metadata?: Record<string, unknown>;
+}
+/** Result of a WorkspaceProvider upload. */
+export interface UploadResult {
+    originalName: string;
+    url: string;
+    mediaType: string;
+}
+/** Props for <ChatProvider>. */
+export interface ChatProviderProps {
+    children: React.ReactNode;
+    gatewayUrl: string;
+    tokenProvider: () => Promise<string> | string;
+    authenticatedFetch: (url: string, init?: RequestInit) => Promise<Response>;
+    onFinish?: (event: {
+        conversationId: string;
+        finish: FinishInfo;
+    }) => void;
+    onToolCall?: (event: {
+        conversationId: string;
+        toolName: string;
+        toolCallId: string;
+        /** JSON string, matches protocol ToolCallInfo.arguments. */
+        args: string;
+    }) => void;
+    onNotification?: (event: {
+        type: 'info' | 'warning' | 'error';
+        message: string;
+        code?: string;
+    }) => void;
+    onFileChange?: (event: {
+        conversationId: string;
+        path: string;
+        action: 'created' | 'modified' | 'deleted';
+    }) => void;
+    onError?: (error: ChatError) => void;
+    onAuthError?: (error: ChatError) => void;
+    onRawEvent?: (event: ServerEvent) => void;
+    onBeforeSend?: (event: ClientEvent) => ClientEvent | null;
+    workspaceProvider?: WorkspaceProvider;
+    reconnectOptions?: {
+        /** Default 5. */
+        maxRetries?: number;
+        /** Default 2000ms. */
+        baseDelay?: number;
+        /** Default 30000ms. */
+        maxDelay?: number;
+    };
+    /** Default 30000ms. */
+    heartbeatInterval?: number;
+}
+export type { FinishInfo, Question, ApprovalRequest, ApprovalResponse, TokenProgress, BillingError };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Public types for @optima-chat/agentic-sdk.
+ *
+ * These are the types consumers see. They are distinct from the gateway protocol
+ * types in @optima-chat/gateway-protocol — this module performs field/type
+ * mapping (snake_case → camelCase, ISO strings → epoch ms, etc.) before the
+ * state reaches consumers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/workspace/default-provider.d.ts

@@ -0,0 +1,14 @@
+import type { WorkspaceProvider } from './types.js';
+/**
+ * Default WorkspaceProvider backed by the gateway's workspace endpoints.
+ *
+ * - `uploadFiles` POSTs each file individually to `/api/workspace/upload` as
+ *   FormData (field name `file`) and expects a JSON response with a `url`
+ *   field.
+ * - `resolveFileUrl` returns a GET URL under `/api/workspace/files/<path>`.
+ *
+ * Consumers with a different backend can pass their own WorkspaceProvider to
+ * <ChatProvider>.
+ */
+export declare function createDefaultWorkspaceProvider(gatewayBaseUrl: string, authenticatedFetch: (url: string, init?: RequestInit) => Promise<Response>): WorkspaceProvider;
+//# sourceMappingURL=default-provider.d.ts.map

package/dist/workspace/default-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-provider.d.ts","sourceRoot":"","sources":["../../src/workspace/default-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,GACzE,iBAAiB,CAsCnB"}

package/dist/workspace/default-provider.js

@@ -0,0 +1,46 @@
+/**
+ * Default WorkspaceProvider backed by the gateway's workspace endpoints.
+ *
+ * - `uploadFiles` POSTs each file individually to `/api/workspace/upload` as
+ *   FormData (field name `file`) and expects a JSON response with a `url`
+ *   field.
+ * - `resolveFileUrl` returns a GET URL under `/api/workspace/files/<path>`.
+ *
+ * Consumers with a different backend can pass their own WorkspaceProvider to
+ * <ChatProvider>.
+ */
+export function createDefaultWorkspaceProvider(gatewayBaseUrl, authenticatedFetch) {
+    const base = gatewayBaseUrl.endsWith('/')
+        ? gatewayBaseUrl.slice(0, -1)
+        : gatewayBaseUrl;
+    return {
+        async uploadFiles(files) {
+            const results = [];
+            for (const file of files) {
+                const formData = new FormData();
+                formData.append('file', file);
+                const res = await authenticatedFetch(`${base}/api/workspace/upload`, {
+                    method: 'POST',
+                    body: formData,
+                });
+                if (!res.ok) {
+                    throw new Error(`workspace upload failed for ${file.name}: ${res.status}`);
+                }
+                const data = (await res.json());
+                if (!data.url) {
+                    throw new Error(`workspace upload for ${file.name} did not return a url`);
+                }
+                results.push({
+                    originalName: file.name,
+                    url: data.url,
+                    mediaType: file.type,
+                });
+            }
+            return results;
+        },
+        resolveFileUrl(path) {
+            return `${base}/api/workspace/files/${encodeURIComponent(path)}`;
+        },
+    };
+}
+//# sourceMappingURL=default-provider.js.map

package/dist/workspace/default-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-provider.js","sourceRoot":"","sources":["../../src/workspace/default-provider.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC5C,cAAsB,EACtB,kBAA0E;IAE1E,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;QACvC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,cAAc,CAAC;IAEnB,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,KAAa;YAC7B,MAAM,OAAO,GAAmB,EAAE,CAAC;YACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAC9B,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,GAAG,IAAI,uBAAuB,EAAE;oBACnE,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,QAAQ;iBACf,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,EAAE,CAC1D,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqB,CAAC;gBACpD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,CAAC,IAAI,uBAAuB,CACzD,CAAC;gBACJ,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC;oBACX,YAAY,EAAE,IAAI,CAAC,IAAI;oBACvB,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,SAAS,EAAE,IAAI,CAAC,IAAI;iBACrB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,cAAc,CAAC,IAAY;YACzB,OAAO,GAAG,IAAI,wBAAwB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/workspace/types.d.ts

@@ -0,0 +1,11 @@
+import type { UploadResult } from '../types.js';
+/**
+ * WorkspaceProvider — consumer-supplied abstraction for file upload and URL
+ * resolution. The default implementation uploads to the gateway's workspace
+ * endpoint, but consumers may provide their own (e.g. signed S3 uploads).
+ */
+export interface WorkspaceProvider {
+    uploadFiles: (files: File[]) => Promise<UploadResult[]>;
+    resolveFileUrl: (path: string) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workspace/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C"}

package/dist/workspace/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workspace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@optima-chat/agentic-sdk",
+  "version": "0.1.0",
+  "description": "Chat core logic for Optima gateway - Provider, hooks, store, WebSocket client",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Optima-Chat/agentic-sdk.git",
+    "directory": "packages/sdk"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "zustand": "^5.0.0"
+  },
+  "dependencies": {
+    "@optima-chat/gateway-protocol": "^0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19.0.0",
+    "jsdom": "^25.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "zustand": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}