dooers-agents-client 0.3.0 → 0.4.0

package/README.md

@@ -12,21 +12,21 @@ Peer dependency: `react >= 18`
 
 ## Quick Start
 
-Wrap your component tree in `WorkerProvider`, then use hooks anywhere inside.
+Wrap your component tree in `AgentProvider`, then use hooks anywhere inside.
 
 ```tsx
-import { WorkerProvider, useConnection, useThreadDetails, useMessage } from "dooers-agents-client"
+import { AgentProvider, useConnection, useThreadDetails, useMessage } from "dooers-agents-client"
 
 function App() {
   return (
-    <WorkerProvider
+    <AgentProvider
       url="ws://localhost:8000/ws"
-      workerId="worker-1"
+      agentId="agent-1"
       userId="user-1"
       userName="Alice"
     >
       <Chat threadId="thread-1" />
-    </WorkerProvider>
+    </AgentProvider>
   )
 }
 
@@ -60,12 +60,12 @@ function Chat({ threadId }: { threadId: string }) {
 
 ## Provider
 
-`WorkerProvider` manages the WebSocket lifecycle. On mount it connects, on unmount it disconnects. When any prop changes, the connection resets.
+`AgentProvider` manages the WebSocket lifecycle. On mount it connects, on unmount it disconnects. When any prop changes, the connection resets.
 
 ```tsx
-<WorkerProvider
+<AgentProvider
   url="ws://localhost:8000/ws"   // WebSocket endpoint
-  workerId="worker-1"            // Worker to connect to
+  agentId="agent-1"            // Agent to connect to
   organizationId="org-1"         // Context passed to handler
   workspaceId="ws-1"
   userId="user-1"
@@ -78,14 +78,14 @@ function Chat({ threadId }: { threadId: string }) {
   onError={(err) => console.error(err.code, err.message)}
 >
   {children}
-</WorkerProvider>
+</AgentProvider>
 ```
 
 All props except `children` and `onError` are primitive strings, so React can diff them cheaply.
 
 ## Hooks
 
-All hooks must be called inside a `WorkerProvider`.
+All hooks must be called inside a `AgentProvider`.
 
 ### useConnection
 
@@ -121,7 +121,7 @@ if (hasOlderEvents) {
 
 ### useThreadsList
 
-Read-only thread list for the connected worker.
+Read-only thread list for the connected agent.
 
 ```tsx
 const { threads, isLoading, hasMore, totalCount } = useThreadsList()
@@ -190,7 +190,7 @@ useEffect(() => {
 
 ### useSettings
 
-Worker settings with real-time sync across clients.
+Agent settings with real-time sync across clients.
 
 ```tsx
 const { fields, updatedAt, isLoading, subscribe, unsubscribe, patchField } = useSettings()
@@ -215,7 +215,7 @@ All public types are camelCase. The SDK transforms the wire format (snake_case)
 ```typescript
 import type {
   User,              // { userId, userName, userEmail, systemRole, organizationRole, workspaceRole }
-  Thread,            // { id, workerId, organizationId, workspaceId, owner, users, title, ... }
+  Thread,            // { id, agentId, organizationId, workspaceId, owner, users, title, ... }
   ThreadEvent,       // { id, threadId, type, actor, author, user, content, data, createdAt, ... }
   Run,               // { id, threadId, agentId, status, startedAt, endedAt, error }
   ContentPart,       // TextPart | ImagePart | DocumentPart
@@ -238,9 +238,9 @@ import { isSettingsFieldGroup } from "dooers-agents-client"  // type guard
 ## Architecture
 
 ```
-WorkerProvider
-  ├── WorkerClient       WebSocket lifecycle, reconnection, optimistic events
-  └── WorkerStore        Zustand vanilla store
+AgentProvider
+  ├── AgentClient       WebSocket lifecycle, reconnection, optimistic events
+  └── AgentStore        Zustand vanilla store
         ├── connection   { status, error, reconnectFailed }
         ├── threads      Record<id, Thread>
         ├── events       Record<threadId, ThreadEvent[]>

package/dist/main.cjs

@@ -27,7 +27,7 @@ function toUser(w) {
 function toThread(w) {
   return {
     id: w.id,
-    workerId: w.worker_id,
+    agentId: w.agent_id,
     organizationId: w.organization_id,
     workspaceId: w.workspace_id,
     owner: toUser(w.owner),
@@ -187,7 +187,9 @@ function toSettingsField(w) {
     rows: w.rows,
     src: w.src,
     width: w.width,
-    height: w.height
+    height: w.height,
+    uploadUrl: w.upload_url,
+    accept: w.accept
   };
 }
 function toSettingsItem(w) {
@@ -206,7 +208,7 @@ function toAnalyticsEvent(w) {
   return {
     event: w.event,
     timestamp: w.timestamp,
-    workerId: w.worker_id,
+    agentId: w.agent_id,
     threadId: w.thread_id,
     userId: w.user_id,
     runId: w.run_id,
@@ -231,13 +233,13 @@ function toWireContentPart(p) {
 var MAX_RECONNECT_ATTEMPTS = 5;
 var RECONNECT_DELAYS = [1e3, 2e3, 4e3, 8e3, 16e3];
 var SEND_MESSAGE_TIMEOUT = 3e4;
-var WorkerClient = class {
+var AgentClient = class {
   ws = null;
   callbacks;
   onError = null;
   url = "";
   httpBaseUrl = "";
-  workerId = "";
+  agentId = "";
   uploadUrl;
   config = {
     organizationId: "",
@@ -296,9 +298,9 @@ var WorkerClient = class {
       sizeBytes: result.size_bytes
     };
   }
-  connect(url, workerId, config) {
+  connect(url, agentId, config) {
     this.url = url;
-    this.workerId = workerId;
+    this.agentId = agentId;
     this.config = config ?? { organizationId: "", workspaceId: "", userId: "" };
     this.isIntentionallyClosed = false;
     try {
@@ -384,10 +386,10 @@ var WorkerClient = class {
   }
   // --- Settings ---
   subscribeSettings() {
-    this.send("settings.subscribe", { worker_id: this.workerId });
+    this.send("settings.subscribe", { agent_id: this.agentId });
   }
   unsubscribeSettings() {
-    this.send("settings.unsubscribe", { worker_id: this.workerId });
+    this.send("settings.unsubscribe", { agent_id: this.agentId });
   }
   patchSetting(fieldId, value) {
     this.send("settings.patch", { field_id: fieldId, value });
@@ -404,10 +406,10 @@ var WorkerClient = class {
   }
   // --- Analytics ---
   subscribeAnalytics() {
-    this.send("analytics.subscribe", { worker_id: this.workerId });
+    this.send("analytics.subscribe", { agent_id: this.agentId });
   }
   unsubscribeAnalytics() {
-    this.send("analytics.unsubscribe", { worker_id: this.workerId });
+    this.send("analytics.unsubscribe", { agent_id: this.agentId });
   }
   // --- Messaging ---
   sendMessage(params) {
@@ -527,7 +529,7 @@ var WorkerClient = class {
       id: this.connectFrameId,
       type: "connect",
       payload: {
-        worker_id: this.workerId,
+        agent_id: this.agentId,
         organization_id: this.config.organizationId ?? "",
         workspace_id: this.config.workspaceId ?? "",
         user: {
@@ -726,7 +728,7 @@ function extractFormStates(events, existing) {
   }
   return result;
 }
-function createWorkerStore() {
+function createAgentStore() {
   return vanilla.createStore()((set) => ({
     connection: {
       status: "idle",
@@ -1063,10 +1065,10 @@ function createWorkerStore() {
     }
   }));
 }
-var WorkerContext = react.createContext(null);
-function WorkerProvider({
+var AgentContext = react.createContext(null);
+function AgentProvider({
   url,
-  workerId,
+  agentId,
   organizationId,
   workspaceId,
   userId,
@@ -1084,8 +1086,8 @@ function WorkerProvider({
   const storeRef = react.useRef(void 0);
   const clientRef = react.useRef(void 0);
   if (!storeRef.current) {
-    storeRef.current = createWorkerStore();
-    clientRef.current = new WorkerClient(storeRef.current.getState().actions);
+    storeRef.current = createAgentStore();
+    clientRef.current = new AgentClient(storeRef.current.getState().actions);
   }
   react.useEffect(() => {
     clientRef.current?.setOnError(onError ?? null);
@@ -1095,8 +1097,8 @@ function WorkerProvider({
   }, [uploadUrl]);
   const identityIdsKey = identityIds?.join(",") ?? "";
   react.useEffect(() => {
-    if (!url || !workerId) return;
-    clientRef.current?.connect(url, workerId, {
+    if (!url || !agentId) return;
+    clientRef.current?.connect(url, agentId, {
       organizationId,
       workspaceId,
       userId,
@@ -1111,7 +1113,7 @@ function WorkerProvider({
     return () => clientRef.current?.disconnect();
   }, [
     url,
-    workerId,
+    agentId,
     organizationId,
     workspaceId,
     userId,
@@ -1127,27 +1129,27 @@ function WorkerProvider({
     () => ({ store: storeRef.current, client: clientRef.current }),
     []
   );
-  return /* @__PURE__ */ jsxRuntime.jsx(WorkerContext.Provider, { value: contextValue, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(AgentContext.Provider, { value: contextValue, children });
 }
-function useWorkerContext() {
-  const ctx = react.useContext(WorkerContext);
+function useAgentContext() {
+  const ctx = react.useContext(AgentContext);
   if (!ctx) {
-    throw new Error("useWorkerContext must be used within a <WorkerProvider>");
+    throw new Error("useAgentContext must be used within a <AgentProvider>");
   }
   return ctx;
 }
 function useStore(selector) {
-  const { store } = useWorkerContext();
+  const { store } = useAgentContext();
   return zustand.useStore(store, selector);
 }
 function useShallowStore(selector) {
-  const { store } = useWorkerContext();
+  const { store } = useAgentContext();
   return zustand.useStore(store, shallow.useShallow(selector));
 }
 
 // src/hooks/use-analytics.ts
 function useAnalytics() {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   const events = useShallowStore((s) => s.analytics.events);
   const counters = useShallowStore((s) => s.analytics.counters);
   const subscribe = react.useCallback(() => client.subscribeAnalytics(), [client]);
@@ -1259,7 +1261,7 @@ function useAudioRecorder() {
   return { start, stop, cancel, isRecording, duration, analyserNode: analyserRef.current };
 }
 function useConnection() {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   const status = useStore((s) => s.connection.status);
   const error = useStore((s) => s.connection.error);
   const reconnectFailed = useStore((s) => s.connection.reconnectFailed);
@@ -1267,7 +1269,7 @@ function useConnection() {
   return { status, error, reconnectFailed, reconnect };
 }
 function useFeedback(targetId, targetType = "event") {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   const feedback = useStore((s) => s.feedback[targetId] ?? null);
   const like = react.useCallback(
     (reason, classification) => client.sendFeedback(targetType, targetId, "like", reason, classification),
@@ -1280,7 +1282,7 @@ function useFeedback(targetId, targetType = "event") {
   return { feedback, like, dislike };
 }
 function useForm(formEventId, formData, threadId) {
-  const { client, store } = useWorkerContext();
+  const { client, store } = useAgentContext();
   const formState = useStore((s) => s.formStates[formEventId]);
   const [errors, setErrors] = react.useState({});
   react.useEffect(() => {
@@ -1422,7 +1424,7 @@ function useFormFileUpload() {
   return { upload, isUploading, error, clearError };
 }
 function useMessage() {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   const send = react.useCallback(
     (params) => {
       return client.sendMessage(params);
@@ -1432,7 +1434,7 @@ function useMessage() {
   return { send };
 }
 function useSettings() {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   const fields = useShallowStore((s) => s.settings.fields);
   const updatedAt = useStore((s) => s.settings.updatedAt);
   const isLoading = useStore((s) => s.settings.isLoading);
@@ -1444,10 +1446,45 @@ function useSettings() {
   );
   return { fields, updatedAt, isLoading, subscribe, unsubscribe, patchField };
 }
+function useSettingsFileUpload() {
+  const [isUploading, setIsUploading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const upload = react.useCallback(
+    async (params) => {
+      setIsUploading(true);
+      setError(null);
+      try {
+        const formData = new FormData();
+        formData.append("file", params.file);
+        formData.append("source", "settings");
+        formData.append("field_id", params.fieldId);
+        formData.append("agent_id", params.agentId);
+        const response = await fetch(params.uploadUrl, {
+          method: "POST",
+          body: formData
+        });
+        if (!response.ok) {
+          const detail = await response.text().catch(() => "");
+          throw new Error(detail || `Upload failed (${response.status})`);
+        }
+        return await response.json();
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Upload failed";
+        setError(message);
+        throw err;
+      } finally {
+        setIsUploading(false);
+      }
+    },
+    []
+  );
+  const clearError = react.useCallback(() => setError(null), []);
+  return { upload, isUploading, error, clearError };
+}
 var EMPTY_ARRAY = [];
 var EMPTY_RUNS = [];
 function useThreadDetails(threadId) {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   react.useEffect(() => {
     if (!threadId) return;
     client.subscribe(threadId);
@@ -1472,7 +1509,7 @@ function useThreadDetails(threadId) {
   return { thread, events, runs, isLoading, isWaiting };
 }
 function useThreadEvents(threadId) {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   const hasOlderEvents = useStore(
     (s) => threadId ? s.eventPagination[threadId]?.hasMore ?? false : false
   );
@@ -1500,13 +1537,13 @@ function useThreadsList() {
   return { threads, isLoading, hasMore, totalCount };
 }
 function useThreadsActions() {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   const deleteThread = react.useCallback((threadId) => client.deleteThread(threadId), [client]);
   const loadMore = react.useCallback((limit) => client.loadMoreThreads(limit), [client]);
   return { deleteThread, loadMore };
 }
 function useUpload() {
-  const { client } = useWorkerContext();
+  const { client } = useAgentContext();
   const [isUploading, setIsUploading] = react.useState(false);
   const activeCountRef = react.useRef(0);
   const upload = react.useCallback(
@@ -1527,7 +1564,7 @@ function useUpload() {
   return { upload, isUploading };
 }
 
-exports.WorkerProvider = WorkerProvider;
+exports.AgentProvider = AgentProvider;
 exports.isSettingsFieldGroup = isSettingsFieldGroup;
 exports.toFormElement = toFormElement;
 exports.toFormEventData = toFormEventData;
@@ -1540,6 +1577,7 @@ exports.useForm = useForm;
 exports.useFormFileUpload = useFormFileUpload;
 exports.useMessage = useMessage;
 exports.useSettings = useSettings;
+exports.useSettingsFileUpload = useSettingsFileUpload;
 exports.useThreadDetails = useThreadDetails;
 exports.useThreadEvents = useThreadEvents;
 exports.useThreadsActions = useThreadsActions;