@personaai/react 0.15.0 → 0.17.0

package/dist/index.d.cts

@@ -146,12 +146,13 @@ interface PersonaProviderProps {
 }
 interface PersonaThread {
     _id: string;
-    /** A bare id string on create()/get(); populated as an object on list(). */
+    /** A bare id string on create(); populated (incl. sandboxEnabled) on get()/list(). */
     agentId: string | {
         _id: string;
         name: string;
         avatar?: string;
         slug: string;
+        sandboxEnabled: boolean;
     };
     title?: string;
     isArchived?: boolean;
@@ -170,7 +171,8 @@ interface PersonaFileItem {
     createdAt: string;
 }
 interface PersonaMemoryFile {
-    scope?: "user" | "agent";
+    scope?: "user" | "agent" | "workspace";
+    /** Set when `scope` is `"agent"` or `"workspace"`. */
     agentId?: string;
     path: string;
     content: string;
@@ -178,7 +180,11 @@ interface PersonaMemoryFile {
     createdAt?: string;
     updatedAt?: string;
 }
-/** One agent's group of agent-scoped memory files, as returned by `GET /memory`. */
+/**
+ * One agent's group of scoped memory files, as returned by `GET /memory` —
+ * used for both `agentMemories` (`scope: "agent"`) and `agentWorkspaces`
+ * (`scope: "workspace"`).
+ */
 interface PersonaMemoryAgentGroup {
     agentId: string;
     /** `null` if the agent no longer exists. */
@@ -188,6 +194,14 @@ interface PersonaMemoryAgentGroup {
 interface PersonaMemoryList {
     userFiles: PersonaMemoryFile[];
     agentMemories: PersonaMemoryAgentGroup[];
+    /**
+     * Files under an Agent's own `/workspace/` filesystem route — the SAME
+     * persistent store `write_file`/`read_file` tool calls under
+     * `/workspace/...` actually read and write. Scoped by Agent + Subject,
+     * shared across every Thread that Subject has with that Agent (not
+     * private to one conversation).
+     */
+    agentWorkspaces: PersonaMemoryAgentGroup[];
 }
 /**
  * AG-UI protocol events emitted during streaming — mirrors exactly what
@@ -1296,18 +1310,18 @@ declare function useMemory(autoFetch?: boolean): {
     refetch: () => Promise<PersonaMemoryList>;
     getFile: (params: {
         path: string;
-        scope?: "user" | "agent";
+        scope?: "user" | "agent" | "workspace";
         agentId?: string;
     }) => Promise<PersonaMemoryFile>;
     writeFile: (params: {
         path: string;
         content: string;
-        scope?: "user" | "agent";
+        scope?: "user" | "agent" | "workspace";
         agentId?: string;
     }) => Promise<PersonaMemoryFile>;
     deleteFile: (params: {
         path: string;
-        scope?: "user" | "agent";
+        scope?: "user" | "agent" | "workspace";
         agentId?: string;
     }) => Promise<void>;
 };
@@ -1337,17 +1351,22 @@ declare function useThreads(autoFetch?: boolean): {
 };
 
 /**
- * CRUD over one Thread's workspace files (the agent's own virtual
- * filesystem) — `useChat()` already exposes a read-only `files` snapshot
- * tied to that thread's live/loaded messages; this hook is for a
- * standalone file-explorer UI that needs to list, read, write, and delete
- * files independently of an active chat session.
+ * CRUD over one Agent's `/workspace/` files — the SAME persistent store a
+ * `write_file`/`read_file` tool call under `/workspace/...` actually reads
+ * and writes (deepagents routes that path prefix to a Mongo-backed memory
+ * store, NOT the LangGraph checkpoint's `files` state channel — a Thread's
+ * live/checkpointed state is a different, much narrower thing that rarely
+ * has anything in it, since agents are instructed to write all real output
+ * under `/workspace/outputs/`). Scoped by Agent + Subject: shared across
+ * every Thread that Subject has with that Agent, not private to one
+ * conversation — the same model the platform's own Files panel uses.
  *
- * KNOWN LIMITATION (inherited from the backend): no lock exists against a
- * concurrent live run on the same Thread — writing here while the agent is
- * actively mid-run could race with its own file writes.
+ * Thin wrapper over `client.memory` (`scope: "workspace"`) — no parallel
+ * type vocabulary, `PersonaWorkspaceFile` here is just `PersonaMemoryFile`
+ * reshaped to the `{content, size, createdAt, modifiedAt}` display shape
+ * `useChat()`'s own (read-only, live-run) `files` snapshot already uses.
  */
-declare function useWorkspaceFiles(threadId: string | undefined, autoFetch?: boolean): {
+declare function useWorkspaceFiles(agentId: string | undefined, autoFetch?: boolean): {
     files: Record<string, PersonaWorkspaceFile>;
     isLoading: boolean;
     isSaving: boolean;

package/dist/index.d.ts

@@ -146,12 +146,13 @@ interface PersonaProviderProps {
 }
 interface PersonaThread {
     _id: string;
-    /** A bare id string on create()/get(); populated as an object on list(). */
+    /** A bare id string on create(); populated (incl. sandboxEnabled) on get()/list(). */
     agentId: string | {
         _id: string;
         name: string;
         avatar?: string;
         slug: string;
+        sandboxEnabled: boolean;
     };
     title?: string;
     isArchived?: boolean;
@@ -170,7 +171,8 @@ interface PersonaFileItem {
     createdAt: string;
 }
 interface PersonaMemoryFile {
-    scope?: "user" | "agent";
+    scope?: "user" | "agent" | "workspace";
+    /** Set when `scope` is `"agent"` or `"workspace"`. */
     agentId?: string;
     path: string;
     content: string;
@@ -178,7 +180,11 @@ interface PersonaMemoryFile {
     createdAt?: string;
     updatedAt?: string;
 }
-/** One agent's group of agent-scoped memory files, as returned by `GET /memory`. */
+/**
+ * One agent's group of scoped memory files, as returned by `GET /memory` —
+ * used for both `agentMemories` (`scope: "agent"`) and `agentWorkspaces`
+ * (`scope: "workspace"`).
+ */
 interface PersonaMemoryAgentGroup {
     agentId: string;
     /** `null` if the agent no longer exists. */
@@ -188,6 +194,14 @@ interface PersonaMemoryAgentGroup {
 interface PersonaMemoryList {
     userFiles: PersonaMemoryFile[];
     agentMemories: PersonaMemoryAgentGroup[];
+    /**
+     * Files under an Agent's own `/workspace/` filesystem route — the SAME
+     * persistent store `write_file`/`read_file` tool calls under
+     * `/workspace/...` actually read and write. Scoped by Agent + Subject,
+     * shared across every Thread that Subject has with that Agent (not
+     * private to one conversation).
+     */
+    agentWorkspaces: PersonaMemoryAgentGroup[];
 }
 /**
  * AG-UI protocol events emitted during streaming — mirrors exactly what
@@ -1296,18 +1310,18 @@ declare function useMemory(autoFetch?: boolean): {
     refetch: () => Promise<PersonaMemoryList>;
     getFile: (params: {
         path: string;
-        scope?: "user" | "agent";
+        scope?: "user" | "agent" | "workspace";
         agentId?: string;
     }) => Promise<PersonaMemoryFile>;
     writeFile: (params: {
         path: string;
         content: string;
-        scope?: "user" | "agent";
+        scope?: "user" | "agent" | "workspace";
         agentId?: string;
     }) => Promise<PersonaMemoryFile>;
     deleteFile: (params: {
         path: string;
-        scope?: "user" | "agent";
+        scope?: "user" | "agent" | "workspace";
         agentId?: string;
     }) => Promise<void>;
 };
@@ -1337,17 +1351,22 @@ declare function useThreads(autoFetch?: boolean): {
 };
 
 /**
- * CRUD over one Thread's workspace files (the agent's own virtual
- * filesystem) — `useChat()` already exposes a read-only `files` snapshot
- * tied to that thread's live/loaded messages; this hook is for a
- * standalone file-explorer UI that needs to list, read, write, and delete
- * files independently of an active chat session.
+ * CRUD over one Agent's `/workspace/` files — the SAME persistent store a
+ * `write_file`/`read_file` tool call under `/workspace/...` actually reads
+ * and writes (deepagents routes that path prefix to a Mongo-backed memory
+ * store, NOT the LangGraph checkpoint's `files` state channel — a Thread's
+ * live/checkpointed state is a different, much narrower thing that rarely
+ * has anything in it, since agents are instructed to write all real output
+ * under `/workspace/outputs/`). Scoped by Agent + Subject: shared across
+ * every Thread that Subject has with that Agent, not private to one
+ * conversation — the same model the platform's own Files panel uses.
  *
- * KNOWN LIMITATION (inherited from the backend): no lock exists against a
- * concurrent live run on the same Thread — writing here while the agent is
- * actively mid-run could race with its own file writes.
+ * Thin wrapper over `client.memory` (`scope: "workspace"`) — no parallel
+ * type vocabulary, `PersonaWorkspaceFile` here is just `PersonaMemoryFile`
+ * reshaped to the `{content, size, createdAt, modifiedAt}` display shape
+ * `useChat()`'s own (read-only, live-run) `files` snapshot already uses.
  */
-declare function useWorkspaceFiles(threadId: string | undefined, autoFetch?: boolean): {
+declare function useWorkspaceFiles(agentId: string | undefined, autoFetch?: boolean): {
     files: Record<string, PersonaWorkspaceFile>;
     isLoading: boolean;
     isSaving: boolean;

package/dist/index.js

@@ -1666,7 +1666,8 @@ function useMemory(autoFetch = true) {
   const { fetchWithAuth } = usePersonaContext();
   const [memory, setMemory] = useState3({
     userFiles: [],
-    agentMemories: []
+    agentMemories: [],
+    agentWorkspaces: []
   });
   const [isLoading, setIsLoading] = useState3(false);
   const [error, setError] = useState3(null);
@@ -1684,7 +1685,7 @@ function useMemory(autoFetch = true) {
     } catch (err) {
       const errorObj = err instanceof Error ? err : new Error(String(err));
       setError(errorObj);
-      return { userFiles: [], agentMemories: [] };
+      return { userFiles: [], agentMemories: [], agentWorkspaces: [] };
     } finally {
       setIsLoading(false);
     }
@@ -1891,21 +1892,36 @@ function useThreads(autoFetch = true) {
 
 // src/hooks/useWorkspaceFiles.ts
 import { useCallback as useCallback5, useEffect as useEffect5, useState as useState5 } from "react";
-function useWorkspaceFiles(threadId, autoFetch = true) {
+function toWorkspaceFile(file) {
+  return {
+    content: file.content,
+    size: file.content.length,
+    createdAt: file.createdAt ?? null,
+    modifiedAt: file.updatedAt ?? null
+  };
+}
+function useWorkspaceFiles(agentId, autoFetch = true) {
   const { fetchWithAuth } = usePersonaContext();
   const [files, setFiles] = useState5({});
   const [isLoading, setIsLoading] = useState5(false);
   const [isSaving, setIsSaving] = useState5(false);
   const [error, setError] = useState5(null);
   const fetchFiles = useCallback5(async () => {
-    if (!threadId) return {};
+    if (!agentId) return {};
     setIsLoading(true);
     setError(null);
     try {
-      const res = await fetchWithAuth(`/threads/${threadId}/files`);
+      const res = await fetchWithAuth("/memory");
       if (!res.ok) throw new Error(`Failed to list workspace files: ${res.statusText}`);
       const data = await res.json();
-      const normalized = normalizeWorkspaceFiles(data?.data ?? data ?? {});
+      const body = data?.data ?? data;
+      const group = (body?.agentWorkspaces ?? []).find(
+        (g) => g.agentId === agentId
+      );
+      const normalized = {};
+      for (const file of group?.files ?? []) {
+        normalized[file.path] = toWorkspaceFile(file);
+      }
       setFiles(normalized);
       return normalized;
     } catch (err) {
@@ -1915,35 +1931,34 @@ function useWorkspaceFiles(threadId, autoFetch = true) {
     } finally {
       setIsLoading(false);
     }
-  }, [fetchWithAuth, threadId]);
+  }, [fetchWithAuth, agentId]);
   const getFile = useCallback5(
     async (path) => {
-      if (!threadId) throw new Error("useWorkspaceFiles: no threadId set");
-      const res = await fetchWithAuth(
-        `/threads/${threadId}/file?path=${encodeURIComponent(path)}`
-      );
+      if (!agentId) throw new Error("useWorkspaceFiles: no agentId set");
+      const query = new URLSearchParams({ path, scope: "workspace", agentId });
+      const res = await fetchWithAuth(`/memory/file?${query.toString()}`);
       if (!res.ok) throw new Error(`Failed to read workspace file: ${res.statusText}`);
       const data = await res.json();
       const raw = data?.data ?? data;
-      return normalizeWorkspaceFiles({ [path]: raw })[path];
+      return toWorkspaceFile(raw);
     },
-    [fetchWithAuth, threadId]
+    [fetchWithAuth, agentId]
   );
   const writeFile = useCallback5(
     async (path, content) => {
-      if (!threadId) throw new Error("useWorkspaceFiles: no threadId set");
+      if (!agentId) throw new Error("useWorkspaceFiles: no agentId set");
       setIsSaving(true);
       setError(null);
       try {
-        const res = await fetchWithAuth(`/threads/${threadId}/file`, {
+        const res = await fetchWithAuth("/memory/file", {
           method: "PUT",
           headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ path, content })
+          body: JSON.stringify({ path, content, scope: "workspace", agentId })
         });
         if (!res.ok) throw new Error(`Failed to write workspace file: ${res.statusText}`);
         const data = await res.json();
         const raw = data?.data ?? data;
-        const file = normalizeWorkspaceFiles({ [path]: raw })[path];
+        const file = toWorkspaceFile(raw);
         setFiles((prev) => ({ ...prev, [path]: file }));
         return file;
       } catch (err) {
@@ -1954,15 +1969,13 @@ function useWorkspaceFiles(threadId, autoFetch = true) {
         setIsSaving(false);
       }
     },
-    [fetchWithAuth, threadId]
+    [fetchWithAuth, agentId]
   );
   const deleteFile = useCallback5(
     async (path) => {
-      if (!threadId) throw new Error("useWorkspaceFiles: no threadId set");
-      const res = await fetchWithAuth(
-        `/threads/${threadId}/file?path=${encodeURIComponent(path)}`,
-        { method: "DELETE" }
-      );
+      if (!agentId) throw new Error("useWorkspaceFiles: no agentId set");
+      const query = new URLSearchParams({ path, scope: "workspace", agentId });
+      const res = await fetchWithAuth(`/memory/file?${query.toString()}`, { method: "DELETE" });
       if (!res.ok) throw new Error(`Failed to delete workspace file: ${res.statusText}`);
       setFiles((prev) => {
         const next = { ...prev };
@@ -1970,15 +1983,15 @@ function useWorkspaceFiles(threadId, autoFetch = true) {
         return next;
       });
     },
-    [fetchWithAuth, threadId]
+    [fetchWithAuth, agentId]
   );
   useEffect5(() => {
-    if (autoFetch && threadId) {
+    if (autoFetch && agentId) {
       void fetchFiles();
-    } else if (!threadId) {
+    } else if (!agentId) {
       setFiles({});
     }
-  }, [autoFetch, threadId, fetchFiles]);
+  }, [autoFetch, agentId, fetchFiles]);
   return {
     files,
     isLoading,