@personaai/react 0.11.0 → 0.15.0

package/dist/index.cjs

@@ -35,7 +35,9 @@ __export(index_exports, {
   useChat: () => useChat,
   useConnection: () => useConnection,
   useFiles: () => useFiles,
+  useKnowledgeBases: () => useKnowledgeBases,
   useMcp: () => useMcp,
+  useMcpAdmin: () => useMcpAdmin,
   useMcpConnections: () => useMcpConnections,
   useMemory: () => useMemory,
   usePersonaContext: () => usePersonaContext,
@@ -46,7 +48,8 @@ __export(index_exports, {
   useWorkflow: () => useWorkflow,
   useWorkflowRuns: () => useWorkflowRuns,
   useWorkflowStream: () => useWorkflowStream,
-  useWorkflows: () => useWorkflows
+  useWorkflows: () => useWorkflows,
+  useWorkspaceFiles: () => useWorkspaceFiles
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1941,8 +1944,110 @@ function useThreads(autoFetch = true) {
   };
 }
 
-// src/hooks/useVoice.ts
+// src/hooks/useWorkspaceFiles.ts
 var import_react6 = require("react");
+function useWorkspaceFiles(threadId, autoFetch = true) {
+  const { fetchWithAuth } = usePersonaContext();
+  const [files, setFiles] = (0, import_react6.useState)({});
+  const [isLoading, setIsLoading] = (0, import_react6.useState)(false);
+  const [isSaving, setIsSaving] = (0, import_react6.useState)(false);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const fetchFiles = (0, import_react6.useCallback)(async () => {
+    if (!threadId) return {};
+    setIsLoading(true);
+    setError(null);
+    try {
+      const res = await fetchWithAuth(`/threads/${threadId}/files`);
+      if (!res.ok) throw new Error(`Failed to list workspace files: ${res.statusText}`);
+      const data = await res.json();
+      const normalized = normalizeWorkspaceFiles(data?.data ?? data ?? {});
+      setFiles(normalized);
+      return normalized;
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error(String(err));
+      setError(errorObj);
+      return {};
+    } finally {
+      setIsLoading(false);
+    }
+  }, [fetchWithAuth, threadId]);
+  const getFile = (0, import_react6.useCallback)(
+    async (path) => {
+      if (!threadId) throw new Error("useWorkspaceFiles: no threadId set");
+      const res = await fetchWithAuth(
+        `/threads/${threadId}/file?path=${encodeURIComponent(path)}`
+      );
+      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];
+    },
+    [fetchWithAuth, threadId]
+  );
+  const writeFile = (0, import_react6.useCallback)(
+    async (path, content) => {
+      if (!threadId) throw new Error("useWorkspaceFiles: no threadId set");
+      setIsSaving(true);
+      setError(null);
+      try {
+        const res = await fetchWithAuth(`/threads/${threadId}/file`, {
+          method: "PUT",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ path, content })
+        });
+        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];
+        setFiles((prev) => ({ ...prev, [path]: file }));
+        return file;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      } finally {
+        setIsSaving(false);
+      }
+    },
+    [fetchWithAuth, threadId]
+  );
+  const deleteFile = (0, import_react6.useCallback)(
+    async (path) => {
+      if (!threadId) throw new Error("useWorkspaceFiles: no threadId set");
+      const res = await fetchWithAuth(
+        `/threads/${threadId}/file?path=${encodeURIComponent(path)}`,
+        { method: "DELETE" }
+      );
+      if (!res.ok) throw new Error(`Failed to delete workspace file: ${res.statusText}`);
+      setFiles((prev) => {
+        const next = { ...prev };
+        delete next[path];
+        return next;
+      });
+    },
+    [fetchWithAuth, threadId]
+  );
+  (0, import_react6.useEffect)(() => {
+    if (autoFetch && threadId) {
+      void fetchFiles();
+    } else if (!threadId) {
+      setFiles({});
+    }
+  }, [autoFetch, threadId, fetchFiles]);
+  return {
+    files,
+    isLoading,
+    isSaving,
+    error,
+    refetch: fetchFiles,
+    getFile,
+    writeFile,
+    deleteFile
+  };
+}
+
+// src/hooks/useVoice.ts
+var import_react7 = require("react");
 
 // src/hooks/voiceWorklets.ts
 var RECORDER_WORKLET_SOURCE = `
@@ -2045,42 +2150,42 @@ function mergeTranscriptText(prev, next) {
 }
 function useVoice(options = {}) {
   const { defaultAgentId, fetchWithAuth, logger } = usePersonaContext();
-  const voiceLogger = (0, import_react6.useMemo)(() => logger.child("voice"), [logger]);
+  const voiceLogger = (0, import_react7.useMemo)(() => logger.child("voice"), [logger]);
   const agentId = options.agentId || defaultAgentId;
   const threadId = options.threadId;
   const contextOverride = options.contextOverride;
   const context = options.context;
-  const [state, setState] = (0, import_react6.useState)("idle");
-  const [isMuted, setIsMuted] = (0, import_react6.useState)(false);
-  const [transcript, setTranscript] = (0, import_react6.useState)(
+  const [state, setState] = (0, import_react7.useState)("idle");
+  const [isMuted, setIsMuted] = (0, import_react7.useState)(false);
+  const [transcript, setTranscript] = (0, import_react7.useState)(
     []
   );
-  const [partial, setPartial] = (0, import_react6.useState)(
+  const [partial, setPartial] = (0, import_react7.useState)(
     null
   );
-  const [toolCalls, setToolCalls] = (0, import_react6.useState)([]);
-  const [error, setError] = (0, import_react6.useState)(null);
-  const [endReason, setEndReason] = (0, import_react6.useState)(
+  const [toolCalls, setToolCalls] = (0, import_react7.useState)([]);
+  const [error, setError] = (0, import_react7.useState)(null);
+  const [endReason, setEndReason] = (0, import_react7.useState)(
     null
   );
-  const wsRef = (0, import_react6.useRef)(null);
-  const streamRef = (0, import_react6.useRef)(null);
-  const inputCtxRef = (0, import_react6.useRef)(null);
-  const outputCtxRef = (0, import_react6.useRef)(null);
-  const recorderNodeRef = (0, import_react6.useRef)(null);
-  const playerNodeRef = (0, import_react6.useRef)(null);
-  const acceptedTurnSeqRef = (0, import_react6.useRef)(0);
-  const mountedRef = (0, import_react6.useRef)(true);
-  const lastFinalTurnRef = (0, import_react6.useRef)(
+  const wsRef = (0, import_react7.useRef)(null);
+  const streamRef = (0, import_react7.useRef)(null);
+  const inputCtxRef = (0, import_react7.useRef)(null);
+  const outputCtxRef = (0, import_react7.useRef)(null);
+  const recorderNodeRef = (0, import_react7.useRef)(null);
+  const playerNodeRef = (0, import_react7.useRef)(null);
+  const acceptedTurnSeqRef = (0, import_react7.useRef)(0);
+  const mountedRef = (0, import_react7.useRef)(true);
+  const lastFinalTurnRef = (0, import_react7.useRef)(
     null
   );
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     mountedRef.current = true;
     return () => {
       mountedRef.current = false;
     };
   }, []);
-  const teardownAudio = (0, import_react6.useCallback)(() => {
+  const teardownAudio = (0, import_react7.useCallback)(() => {
     try {
       streamRef.current?.getTracks().forEach((track) => track.stop());
     } catch {
@@ -2107,7 +2212,7 @@ function useVoice(options = {}) {
     }
     outputCtxRef.current = null;
   }, []);
-  const stop = (0, import_react6.useCallback)(() => {
+  const stop = (0, import_react7.useCallback)(() => {
     voiceLogger.debug("stop() called");
     try {
       wsRef.current?.close(1e3, "client_stop");
@@ -2117,8 +2222,8 @@ function useVoice(options = {}) {
     teardownAudio();
     if (mountedRef.current) setState("idle");
   }, [teardownAudio, voiceLogger]);
-  (0, import_react6.useEffect)(() => stop, [stop]);
-  const startCapture = (0, import_react6.useCallback)(async (inputSampleRate) => {
+  (0, import_react7.useEffect)(() => stop, [stop]);
+  const startCapture = (0, import_react7.useCallback)(async (inputSampleRate) => {
     const stream = await navigator.mediaDevices.getUserMedia({
       audio: {
         echoCancellation: true,
@@ -2144,7 +2249,7 @@ function useVoice(options = {}) {
     recorderNodeRef.current = recorderNode;
     source.connect(recorderNode);
   }, []);
-  const setupPlayback = (0, import_react6.useCallback)(async (outputSampleRate) => {
+  const setupPlayback = (0, import_react7.useCallback)(async (outputSampleRate) => {
     const outputCtx = new AudioContext({ sampleRate: outputSampleRate });
     outputCtxRef.current = outputCtx;
     await outputCtx.audioWorklet.addModule(playerWorkletUrl());
@@ -2152,7 +2257,7 @@ function useVoice(options = {}) {
     playerNode.connect(outputCtx.destination);
     playerNodeRef.current = playerNode;
   }, []);
-  const upsertToolCall = (0, import_react6.useCallback)(
+  const upsertToolCall = (0, import_react7.useCallback)(
     (id, patch) => {
       setToolCalls((prev) => {
         const idx = prev.findIndex((t) => t.id === id);
@@ -2164,7 +2269,7 @@ function useVoice(options = {}) {
     },
     []
   );
-  const handleTranscript = (0, import_react6.useCallback)((value) => {
+  const handleTranscript = (0, import_react7.useCallback)((value) => {
     const { speaker, text, isFinal, turnSeq } = value;
     if (!isFinal) {
       setPartial({ id: "partial", speaker, text });
@@ -2187,7 +2292,7 @@ function useVoice(options = {}) {
     });
     lastFinalTurnRef.current = { speaker, turnSeq };
   }, []);
-  const handleCustomEvent = (0, import_react6.useCallback)(
+  const handleCustomEvent = (0, import_react7.useCallback)(
     (name, value) => {
       switch (name) {
         case "voice_session_ready":
@@ -2245,7 +2350,7 @@ function useVoice(options = {}) {
     },
     [handleTranscript, setupPlayback, startCapture, teardownAudio, voiceLogger]
   );
-  const handleMessage = (0, import_react6.useCallback)(
+  const handleMessage = (0, import_react7.useCallback)(
     (event) => {
       if (typeof event.data !== "string") {
         const buf = event.data;
@@ -2303,7 +2408,7 @@ function useVoice(options = {}) {
     },
     [handleCustomEvent, upsertToolCall, voiceLogger]
   );
-  const start = (0, import_react6.useCallback)(async () => {
+  const start = (0, import_react7.useCallback)(async () => {
     if (!agentId) {
       const err = new Error(
         "useVoice: no agentId provided and no defaultAgentId set on PersonaProvider"
@@ -2370,17 +2475,17 @@ function useVoice(options = {}) {
       teardownAudio();
     }
   }, [agentId, threadId, contextOverride, context, fetchWithAuth, handleMessage, teardownAudio, voiceLogger]);
-  const mute = (0, import_react6.useCallback)((muted) => {
+  const mute = (0, import_react7.useCallback)((muted) => {
     setIsMuted(muted);
     streamRef.current?.getAudioTracks().forEach((track) => {
       track.enabled = !muted;
     });
   }, []);
-  const sendText = (0, import_react6.useCallback)((text) => {
+  const sendText = (0, import_react7.useCallback)((text) => {
     if (!text?.trim() || wsRef.current?.readyState !== WebSocket.OPEN) return;
     wsRef.current.send(JSON.stringify({ type: "voice.text", text }));
   }, []);
-  const updateContext = (0, import_react6.useCallback)((newContext) => {
+  const updateContext = (0, import_react7.useCallback)((newContext) => {
     if (wsRef.current?.readyState !== WebSocket.OPEN) return;
     wsRef.current.send(JSON.stringify({ type: "voice.context", context: newContext }));
   }, []);
@@ -2401,14 +2506,14 @@ function useVoice(options = {}) {
 }
 
 // src/hooks/useFiles.ts
-var import_react7 = require("react");
+var import_react8 = require("react");
 function useFiles(autoFetch = true) {
   const { fetchWithAuth } = usePersonaContext();
-  const [files, setFiles] = (0, import_react7.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react7.useState)(false);
-  const [isUploading, setIsUploading] = (0, import_react7.useState)(false);
-  const [error, setError] = (0, import_react7.useState)(null);
-  const fetchFiles = (0, import_react7.useCallback)(async () => {
+  const [files, setFiles] = (0, import_react8.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react8.useState)(false);
+  const [isUploading, setIsUploading] = (0, import_react8.useState)(false);
+  const [error, setError] = (0, import_react8.useState)(null);
+  const fetchFiles = (0, import_react8.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -2426,7 +2531,7 @@ function useFiles(autoFetch = true) {
       setIsLoading(false);
     }
   }, [fetchWithAuth]);
-  const uploadFile = (0, import_react7.useCallback)(
+  const uploadFile = (0, import_react8.useCallback)(
     async (fileOrFormData) => {
       setIsUploading(true);
       setError(null);
@@ -2459,7 +2564,7 @@ function useFiles(autoFetch = true) {
     },
     [fetchWithAuth, fetchFiles]
   );
-  const deleteFile = (0, import_react7.useCallback)(
+  const deleteFile = (0, import_react8.useCallback)(
     async (fileId) => {
       const res = await fetchWithAuth(`/files/${fileId}`, { method: "DELETE" });
       if (!res.ok) throw new Error(`Failed to delete file: ${res.statusText}`);
@@ -2467,7 +2572,7 @@ function useFiles(autoFetch = true) {
     },
     [fetchWithAuth]
   );
-  const bulkDeleteFiles = (0, import_react7.useCallback)(
+  const bulkDeleteFiles = (0, import_react8.useCallback)(
     async (fileIds) => {
       const res = await fetchWithAuth("/files/bulk-delete", {
         method: "POST",
@@ -2482,10 +2587,10 @@ function useFiles(autoFetch = true) {
     },
     [fetchWithAuth]
   );
-  const getDownloadUrl = (0, import_react7.useCallback)((fileId) => {
+  const getDownloadUrl = (0, import_react8.useCallback)((fileId) => {
     return `/files/${fileId}`;
   }, []);
-  (0, import_react7.useEffect)(() => {
+  (0, import_react8.useEffect)(() => {
     if (autoFetch) {
       void fetchFiles();
     }
@@ -2504,21 +2609,21 @@ function useFiles(autoFetch = true) {
 }
 
 // src/hooks/useAgents.ts
-var import_react8 = require("react");
+var import_react9 = require("react");
 function useAgents(options = true) {
   const opts = typeof options === "boolean" ? { autoFetch: options } : options;
   const { autoFetch = true, page, limit, search, category, scope } = opts;
   const { fetchWithAuth } = usePersonaContext();
-  const [agents, setAgents] = (0, import_react8.useState)([]);
-  const [pagination, setPagination] = (0, import_react8.useState)({
+  const [agents, setAgents] = (0, import_react9.useState)([]);
+  const [pagination, setPagination] = (0, import_react9.useState)({
     total: 0,
     page: page ?? 1,
     limit: limit ?? 20,
     pages: 0
   });
-  const [isLoading, setIsLoading] = (0, import_react8.useState)(false);
-  const [error, setError] = (0, import_react8.useState)(null);
-  const fetchAgents = (0, import_react8.useCallback)(async () => {
+  const [isLoading, setIsLoading] = (0, import_react9.useState)(false);
+  const [error, setError] = (0, import_react9.useState)(null);
+  const fetchAgents = (0, import_react9.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -2546,7 +2651,7 @@ function useAgents(options = true) {
       setIsLoading(false);
     }
   }, [fetchWithAuth, page, limit, search, category, scope]);
-  const getAgent = (0, import_react8.useCallback)(
+  const getAgent = (0, import_react9.useCallback)(
     async (agentId) => {
       const res = await fetchWithAuth(`/agents/${agentId}`);
       if (!res.ok) throw new Error(`Failed to fetch agent: ${res.statusText}`);
@@ -2554,7 +2659,7 @@ function useAgents(options = true) {
     },
     [fetchWithAuth]
   );
-  const createAgent = (0, import_react8.useCallback)(
+  const createAgent = (0, import_react9.useCallback)(
     async (input) => {
       setError(null);
       try {
@@ -2578,7 +2683,7 @@ function useAgents(options = true) {
     },
     [fetchWithAuth]
   );
-  const updateAgent = (0, import_react8.useCallback)(
+  const updateAgent = (0, import_react9.useCallback)(
     async (agentId, input) => {
       setError(null);
       try {
@@ -2602,7 +2707,7 @@ function useAgents(options = true) {
     },
     [fetchWithAuth]
   );
-  const deleteAgent = (0, import_react8.useCallback)(
+  const deleteAgent = (0, import_react9.useCallback)(
     async (agentId) => {
       setError(null);
       try {
@@ -2620,7 +2725,7 @@ function useAgents(options = true) {
     },
     [fetchWithAuth]
   );
-  const bulkDeleteAgents = (0, import_react8.useCallback)(
+  const bulkDeleteAgents = (0, import_react9.useCallback)(
     async (ids) => {
       setError(null);
       try {
@@ -2645,7 +2750,7 @@ function useAgents(options = true) {
     },
     [fetchWithAuth]
   );
-  (0, import_react8.useEffect)(() => {
+  (0, import_react9.useEffect)(() => {
     if (autoFetch) void fetchAgents();
   }, [autoFetch, fetchAgents]);
   return {
@@ -2663,13 +2768,13 @@ function useAgents(options = true) {
 }
 
 // src/hooks/useConnection.ts
-var import_react9 = require("react");
+var import_react10 = require("react");
 function useConnection(autoCheck = true) {
   const { fetchWithAuth } = usePersonaContext();
-  const [health, setHealth] = (0, import_react9.useState)(null);
-  const [isConnected, setIsConnected] = (0, import_react9.useState)(false);
-  const [isLoading, setIsLoading] = (0, import_react9.useState)(false);
-  const checkHealth = (0, import_react9.useCallback)(async () => {
+  const [health, setHealth] = (0, import_react10.useState)(null);
+  const [isConnected, setIsConnected] = (0, import_react10.useState)(false);
+  const [isLoading, setIsLoading] = (0, import_react10.useState)(false);
+  const checkHealth = (0, import_react10.useCallback)(async () => {
     setIsLoading(true);
     try {
       const res = await fetchWithAuth("/health");
@@ -2688,7 +2793,7 @@ function useConnection(autoCheck = true) {
       setIsLoading(false);
     }
   }, [fetchWithAuth]);
-  (0, import_react9.useEffect)(() => {
+  (0, import_react10.useEffect)(() => {
     if (autoCheck) {
       void checkHealth();
     }
@@ -2702,15 +2807,15 @@ function useConnection(autoCheck = true) {
 }
 
 // src/hooks/useMcpConnections.ts
-var import_react10 = require("react");
+var import_react11 = require("react");
 function useMcpConnections(options = {}) {
   const { defaultAgentId, fetchWithAuth } = usePersonaContext();
   const agentId = options.agentId ?? defaultAgentId;
   const autoFetch = options.autoFetch ?? true;
-  const [connections, setConnections] = (0, import_react10.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react10.useState)(false);
-  const [error, setError] = (0, import_react10.useState)(null);
-  const fetchConnections = (0, import_react10.useCallback)(async () => {
+  const [connections, setConnections] = (0, import_react11.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react11.useState)(false);
+  const [error, setError] = (0, import_react11.useState)(null);
+  const fetchConnections = (0, import_react11.useCallback)(async () => {
     if (!agentId) return [];
     setIsLoading(true);
     setError(null);
@@ -2734,8 +2839,8 @@ function useMcpConnections(options = {}) {
       setIsLoading(false);
     }
   }, [agentId, fetchWithAuth, options.returnTo]);
-  const [isDisconnecting, setIsDisconnecting] = (0, import_react10.useState)(false);
-  const disconnect = (0, import_react10.useCallback)(
+  const [isDisconnecting, setIsDisconnecting] = (0, import_react11.useState)(false);
+  const disconnect = (0, import_react11.useCallback)(
     async (mcpId) => {
       setIsDisconnecting(true);
       setError(null);
@@ -2761,7 +2866,7 @@ function useMcpConnections(options = {}) {
     },
     [fetchWithAuth, fetchConnections]
   );
-  (0, import_react10.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     if (autoFetch) void fetchConnections();
   }, [autoFetch, fetchConnections]);
   return {
@@ -2777,11 +2882,11 @@ function useMcpConnections(options = {}) {
 }
 
 // src/hooks/useMcp.ts
-var import_react11 = require("react");
+var import_react12 = require("react");
 function useMcp(options = {}) {
   const { fetchWithAuth } = usePersonaContext();
   const defaultMcpId = options.mcpId;
-  const readResource = (0, import_react11.useCallback)(
+  const readResource = (0, import_react12.useCallback)(
     async (uri, mcpId) => {
       const id = mcpId ?? defaultMcpId;
       if (!id) throw new Error("MCP server ID is required to read resource");
@@ -2795,7 +2900,7 @@ function useMcp(options = {}) {
     },
     [fetchWithAuth, defaultMcpId]
   );
-  const callTool = (0, import_react11.useCallback)(
+  const callTool = (0, import_react12.useCallback)(
     async (name, args, mcpId) => {
       const id = mcpId ?? defaultMcpId;
       if (!id) throw new Error("MCP server ID is required to call tool");
@@ -2818,20 +2923,20 @@ function useMcp(options = {}) {
 }
 
 // src/hooks/useSkills.ts
-var import_react12 = require("react");
+var import_react13 = require("react");
 function useSkills(options = {}) {
   const { autoFetch = true, page, limit, search, scope } = options;
   const { fetchWithAuth } = usePersonaContext();
-  const [skills, setSkills] = (0, import_react12.useState)([]);
-  const [pagination, setPagination] = (0, import_react12.useState)({
+  const [skills, setSkills] = (0, import_react13.useState)([]);
+  const [pagination, setPagination] = (0, import_react13.useState)({
     total: 0,
     page: page ?? 1,
     limit: limit ?? 20,
     pages: 0
   });
-  const [isLoading, setIsLoading] = (0, import_react12.useState)(false);
-  const [error, setError] = (0, import_react12.useState)(null);
-  const fetchSkills = (0, import_react12.useCallback)(async () => {
+  const [isLoading, setIsLoading] = (0, import_react13.useState)(false);
+  const [error, setError] = (0, import_react13.useState)(null);
+  const fetchSkills = (0, import_react13.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -2858,7 +2963,7 @@ function useSkills(options = {}) {
       setIsLoading(false);
     }
   }, [fetchWithAuth, page, limit, search, scope]);
-  const getSkill = (0, import_react12.useCallback)(
+  const getSkill = (0, import_react13.useCallback)(
     async (skillId) => {
       const res = await fetchWithAuth(`/skills/${skillId}`);
       if (!res.ok) throw new Error(`Failed to fetch skill: ${res.statusText}`);
@@ -2866,7 +2971,7 @@ function useSkills(options = {}) {
     },
     [fetchWithAuth]
   );
-  const createSkill = (0, import_react12.useCallback)(
+  const createSkill = (0, import_react13.useCallback)(
     async (input) => {
       setError(null);
       try {
@@ -2890,7 +2995,7 @@ function useSkills(options = {}) {
     },
     [fetchWithAuth]
   );
-  const updateSkill = (0, import_react12.useCallback)(
+  const updateSkill = (0, import_react13.useCallback)(
     async (skillId, input) => {
       setError(null);
       try {
@@ -2914,7 +3019,7 @@ function useSkills(options = {}) {
     },
     [fetchWithAuth]
   );
-  const deleteSkill = (0, import_react12.useCallback)(
+  const deleteSkill = (0, import_react13.useCallback)(
     async (skillId) => {
       setError(null);
       try {
@@ -2932,7 +3037,7 @@ function useSkills(options = {}) {
     },
     [fetchWithAuth]
   );
-  const bulkDeleteSkills = (0, import_react12.useCallback)(
+  const bulkDeleteSkills = (0, import_react13.useCallback)(
     async (ids) => {
       setError(null);
       try {
@@ -2957,7 +3062,7 @@ function useSkills(options = {}) {
     },
     [fetchWithAuth]
   );
-  const getSkillUsage = (0, import_react12.useCallback)(
+  const getSkillUsage = (0, import_react13.useCallback)(
     async (skillId) => {
       const res = await fetchWithAuth(`/skills/${skillId}/usage`);
       if (!res.ok) throw new Error(`Failed to fetch skill usage: ${res.statusText}`);
@@ -2965,7 +3070,7 @@ function useSkills(options = {}) {
     },
     [fetchWithAuth]
   );
-  (0, import_react12.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     if (autoFetch) void fetchSkills();
   }, [autoFetch, fetchSkills]);
   return {
@@ -2984,20 +3089,20 @@ function useSkills(options = {}) {
 }
 
 // src/hooks/useRcpSources.ts
-var import_react13 = require("react");
+var import_react14 = require("react");
 function useRcpSources(options = {}) {
   const { autoFetch = true, page, limit, search } = options;
   const { fetchWithAuth } = usePersonaContext();
-  const [rcpSources, setRcpSources] = (0, import_react13.useState)([]);
-  const [pagination, setPagination] = (0, import_react13.useState)({
+  const [rcpSources, setRcpSources] = (0, import_react14.useState)([]);
+  const [pagination, setPagination] = (0, import_react14.useState)({
     total: 0,
     page: page ?? 1,
     limit: limit ?? 20,
     pages: 0
   });
-  const [isLoading, setIsLoading] = (0, import_react13.useState)(false);
-  const [error, setError] = (0, import_react13.useState)(null);
-  const fetchRcpSources = (0, import_react13.useCallback)(async () => {
+  const [isLoading, setIsLoading] = (0, import_react14.useState)(false);
+  const [error, setError] = (0, import_react14.useState)(null);
+  const fetchRcpSources = (0, import_react14.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -3023,7 +3128,7 @@ function useRcpSources(options = {}) {
       setIsLoading(false);
     }
   }, [fetchWithAuth, page, limit, search]);
-  const getRcpSource = (0, import_react13.useCallback)(
+  const getRcpSource = (0, import_react14.useCallback)(
     async (sourceId) => {
       const res = await fetchWithAuth(`/rcp-sources/${sourceId}`);
       if (!res.ok) throw new Error(`Failed to fetch RCP source: ${res.statusText}`);
@@ -3031,7 +3136,7 @@ function useRcpSources(options = {}) {
     },
     [fetchWithAuth]
   );
-  const createRcpSource = (0, import_react13.useCallback)(
+  const createRcpSource = (0, import_react14.useCallback)(
     async (input) => {
       setError(null);
       try {
@@ -3055,7 +3160,7 @@ function useRcpSources(options = {}) {
     },
     [fetchWithAuth]
   );
-  const updateRcpSource = (0, import_react13.useCallback)(
+  const updateRcpSource = (0, import_react14.useCallback)(
     async (sourceId, input) => {
       setError(null);
       try {
@@ -3079,7 +3184,7 @@ function useRcpSources(options = {}) {
     },
     [fetchWithAuth]
   );
-  const deleteRcpSource = (0, import_react13.useCallback)(
+  const deleteRcpSource = (0, import_react14.useCallback)(
     async (sourceId) => {
       setError(null);
       try {
@@ -3097,7 +3202,7 @@ function useRcpSources(options = {}) {
     },
     [fetchWithAuth]
   );
-  const bulkDeleteRcpSources = (0, import_react13.useCallback)(
+  const bulkDeleteRcpSources = (0, import_react14.useCallback)(
     async (ids) => {
       setError(null);
       try {
@@ -3122,7 +3227,7 @@ function useRcpSources(options = {}) {
     },
     [fetchWithAuth]
   );
-  const getRcpSourceUsage = (0, import_react13.useCallback)(
+  const getRcpSourceUsage = (0, import_react14.useCallback)(
     async (sourceId) => {
       const res = await fetchWithAuth(`/rcp-sources/${sourceId}/usage`);
       if (!res.ok) throw new Error(`Failed to fetch RCP source usage: ${res.statusText}`);
@@ -3130,7 +3235,7 @@ function useRcpSources(options = {}) {
     },
     [fetchWithAuth]
   );
-  const testRcpSourceConnection = (0, import_react13.useCallback)(
+  const testRcpSourceConnection = (0, import_react14.useCallback)(
     async (sourceId) => {
       setError(null);
       try {
@@ -3154,7 +3259,7 @@ function useRcpSources(options = {}) {
     },
     [fetchWithAuth]
   );
-  (0, import_react13.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     if (autoFetch) void fetchRcpSources();
   }, [autoFetch, fetchRcpSources]);
   return {
@@ -3173,28 +3278,475 @@ function useRcpSources(options = {}) {
   };
 }
 
+// src/hooks/useKnowledgeBases.ts
+var import_react15 = require("react");
+function useKnowledgeBases(options = {}) {
+  const { autoFetch = true, page, limit, search, scope } = options;
+  const { fetchWithAuth } = usePersonaContext();
+  const [knowledgeBases, setKnowledgeBases] = (0, import_react15.useState)([]);
+  const [pagination, setPagination] = (0, import_react15.useState)({
+    total: 0,
+    page: page ?? 1,
+    limit: limit ?? 20,
+    pages: 0
+  });
+  const [isLoading, setIsLoading] = (0, import_react15.useState)(false);
+  const [isUploading, setIsUploading] = (0, import_react15.useState)(false);
+  const [error, setError] = (0, import_react15.useState)(null);
+  const fetchKnowledgeBases = (0, import_react15.useCallback)(async () => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const query = new URLSearchParams();
+      if (page) query.set("page", String(page));
+      if (limit) query.set("limit", String(limit));
+      if (search) query.set("search", search);
+      if (scope) query.set("scope", scope);
+      const queryStr = query.toString() ? `?${query.toString()}` : "";
+      const res = await fetchWithAuth(`/knowledge${queryStr}`);
+      if (!res.ok) throw new Error(`Failed to list knowledge bases: ${res.statusText}`);
+      const data = await res.json();
+      const items = Array.isArray(data) ? data : data?.items ?? [];
+      setKnowledgeBases(items);
+      setPagination(
+        data?.pagination ?? { total: items.length, page: 1, limit: items.length, pages: 1 }
+      );
+      return items;
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error(String(err));
+      setError(errorObj);
+      return [];
+    } finally {
+      setIsLoading(false);
+    }
+  }, [fetchWithAuth, page, limit, search, scope]);
+  const getKnowledgeBase = (0, import_react15.useCallback)(
+    async (kbId) => {
+      const res = await fetchWithAuth(`/knowledge/${kbId}`);
+      if (!res.ok) throw new Error(`Failed to fetch knowledge base: ${res.statusText}`);
+      return res.json();
+    },
+    [fetchWithAuth]
+  );
+  const createKnowledgeBase = (0, import_react15.useCallback)(
+    async (input) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth("/knowledge", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(input)
+        });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to create knowledge base (${res.status}): ${errText}`);
+        }
+        const created = await res.json();
+        setKnowledgeBases((prev) => [created, ...prev]);
+        return created;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const updateKnowledgeBase = (0, import_react15.useCallback)(
+    async (kbId, input) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth(`/knowledge/${kbId}`, {
+          method: "PATCH",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(input)
+        });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to update knowledge base (${res.status}): ${errText}`);
+        }
+        const updated = await res.json();
+        setKnowledgeBases((prev) => prev.map((kb) => kb._id === kbId ? updated : kb));
+        return updated;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const deleteKnowledgeBase = (0, import_react15.useCallback)(
+    async (kbId) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth(`/knowledge/${kbId}`, { method: "DELETE" });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to delete knowledge base (${res.status}): ${errText}`);
+        }
+        setKnowledgeBases((prev) => prev.filter((kb) => kb._id !== kbId));
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const bulkDeleteKnowledgeBases = (0, import_react15.useCallback)(
+    async (ids) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth("/knowledge/bulk-delete", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ ids })
+        });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to bulk-delete knowledge bases (${res.status}): ${errText}`);
+        }
+        const result = await res.json();
+        const deletedSet = new Set(result.deleted);
+        setKnowledgeBases((prev) => prev.filter((kb) => !deletedSet.has(kb._id)));
+        return result;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const getKnowledgeBaseUsage = (0, import_react15.useCallback)(
+    async (kbId) => {
+      const res = await fetchWithAuth(`/knowledge/${kbId}/usage`);
+      if (!res.ok) throw new Error(`Failed to fetch knowledge base usage: ${res.statusText}`);
+      return res.json();
+    },
+    [fetchWithAuth]
+  );
+  const uploadDocuments = (0, import_react15.useCallback)(
+    async (kbId, files) => {
+      setIsUploading(true);
+      setError(null);
+      try {
+        const body = new FormData();
+        for (const file of files) {
+          if (file.content instanceof Blob) {
+            body.append("files", file.content, file.filename);
+          } else {
+            body.append("files", {
+              uri: file.content.uri,
+              name: file.content.name ?? file.filename,
+              type: file.content.type ?? file.contentType
+            });
+          }
+        }
+        const res = await fetchWithAuth(`/knowledge/${kbId}/documents`, {
+          method: "POST",
+          body
+        });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to upload documents (${res.status}): ${errText}`);
+        }
+        const result = await res.json();
+        setKnowledgeBases(
+          (prev) => prev.map(
+            (kb) => kb._id === kbId ? { ...kb, documentCount: result.documentCount, chunkCount: result.chunkCount } : kb
+          )
+        );
+        return result;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      } finally {
+        setIsUploading(false);
+      }
+    },
+    [fetchWithAuth]
+  );
+  const listDocuments = (0, import_react15.useCallback)(
+    async (kbId) => {
+      const res = await fetchWithAuth(`/knowledge/${kbId}/documents`);
+      if (!res.ok) throw new Error(`Failed to list documents: ${res.statusText}`);
+      return res.json();
+    },
+    [fetchWithAuth]
+  );
+  const deleteDocument = (0, import_react15.useCallback)(
+    async (kbId, sourceName) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth(
+          `/knowledge/${kbId}/documents/${encodeURIComponent(sourceName)}`,
+          { method: "DELETE" }
+        );
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to delete document (${res.status}): ${errText}`);
+        }
+        const result = await res.json();
+        setKnowledgeBases(
+          (prev) => prev.map(
+            (kb) => kb._id === kbId ? { ...kb, documentCount: result.remainingDocuments, chunkCount: result.remainingChunks } : kb
+          )
+        );
+        return result;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const searchKnowledgeBase = (0, import_react15.useCallback)(
+    async (kbId, query, opts) => {
+      const res = await fetchWithAuth(`/knowledge/${kbId}/search`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ query, topK: opts?.topK })
+      });
+      if (!res.ok) {
+        const errText = await res.text().catch(() => res.statusText);
+        throw new Error(`Failed to search knowledge base (${res.status}): ${errText}`);
+      }
+      return res.json();
+    },
+    [fetchWithAuth]
+  );
+  (0, import_react15.useEffect)(() => {
+    if (autoFetch) void fetchKnowledgeBases();
+  }, [autoFetch, fetchKnowledgeBases]);
+  return {
+    knowledgeBases,
+    pagination,
+    isLoading,
+    isUploading,
+    error,
+    refetch: fetchKnowledgeBases,
+    getKnowledgeBase,
+    createKnowledgeBase,
+    updateKnowledgeBase,
+    deleteKnowledgeBase,
+    bulkDeleteKnowledgeBases,
+    getKnowledgeBaseUsage,
+    uploadDocuments,
+    listDocuments,
+    deleteDocument,
+    search: searchKnowledgeBase
+  };
+}
+
+// src/hooks/useMcpAdmin.ts
+var import_react16 = require("react");
+function useMcpAdmin(options = {}) {
+  const { autoFetch = true, page, limit, search } = options;
+  const { fetchWithAuth } = usePersonaContext();
+  const [mcps, setMcps] = (0, import_react16.useState)([]);
+  const [pagination, setPagination] = (0, import_react16.useState)({
+    total: 0,
+    page: page ?? 1,
+    limit: limit ?? 20,
+    pages: 0
+  });
+  const [isLoading, setIsLoading] = (0, import_react16.useState)(false);
+  const [error, setError] = (0, import_react16.useState)(null);
+  const fetchMcps = (0, import_react16.useCallback)(async () => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const query = new URLSearchParams();
+      if (page) query.set("page", String(page));
+      if (limit) query.set("limit", String(limit));
+      if (search) query.set("search", search);
+      query.set("scope", "mine");
+      const res = await fetchWithAuth(`/mcps?${query.toString()}`);
+      if (!res.ok) throw new Error(`Failed to list MCPs: ${res.statusText}`);
+      const data = await res.json();
+      const items = Array.isArray(data) ? data : data?.items ?? [];
+      setMcps(items);
+      setPagination(
+        data?.pagination ?? { total: items.length, page: 1, limit: items.length, pages: 1 }
+      );
+      return items;
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error(String(err));
+      setError(errorObj);
+      return [];
+    } finally {
+      setIsLoading(false);
+    }
+  }, [fetchWithAuth, page, limit, search]);
+  const getMcp = (0, import_react16.useCallback)(
+    async (mcpId) => {
+      const res = await fetchWithAuth(`/mcps/${mcpId}`);
+      if (!res.ok) throw new Error(`Failed to fetch MCP: ${res.statusText}`);
+      return res.json();
+    },
+    [fetchWithAuth]
+  );
+  const createMcp = (0, import_react16.useCallback)(
+    async (input) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth("/mcps", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(input)
+        });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to create MCP (${res.status}): ${errText}`);
+        }
+        const created = await res.json();
+        setMcps((prev) => [created, ...prev]);
+        return created;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const updateMcp = (0, import_react16.useCallback)(
+    async (mcpId, input) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth(`/mcps/${mcpId}`, {
+          method: "PATCH",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(input)
+        });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to update MCP (${res.status}): ${errText}`);
+        }
+        const updated = await res.json();
+        setMcps((prev) => prev.map((m) => m._id === mcpId ? updated : m));
+        return updated;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const deleteMcp = (0, import_react16.useCallback)(
+    async (mcpId) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth(`/mcps/${mcpId}`, { method: "DELETE" });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to delete MCP (${res.status}): ${errText}`);
+        }
+        setMcps((prev) => prev.filter((m) => m._id !== mcpId));
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const bulkDeleteMcps = (0, import_react16.useCallback)(
+    async (ids) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth("/mcps/bulk-delete", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ ids })
+        });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to bulk-delete MCPs (${res.status}): ${errText}`);
+        }
+        const result = await res.json();
+        const deletedSet = new Set(result.deleted);
+        setMcps((prev) => prev.filter((m) => !deletedSet.has(m._id)));
+        return result;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  const testConnection = (0, import_react16.useCallback)(
+    async (mcpId) => {
+      setError(null);
+      try {
+        const res = await fetchWithAuth(`/mcps/${mcpId}/test`, { method: "POST" });
+        if (!res.ok) {
+          const errText = await res.text().catch(() => res.statusText);
+          throw new Error(`Failed to test MCP connection (${res.status}): ${errText}`);
+        }
+        const result = await res.json();
+        setMcps(
+          (prev) => prev.map(
+            (m) => m._id === mcpId ? { ...m, tools: result.tools, resources: result.resources, resourceTemplates: result.resourceTemplates } : m
+          )
+        );
+        return result;
+      } catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        throw errorObj;
+      }
+    },
+    [fetchWithAuth]
+  );
+  (0, import_react16.useEffect)(() => {
+    if (autoFetch) void fetchMcps();
+  }, [autoFetch, fetchMcps]);
+  return {
+    mcps,
+    pagination,
+    isLoading,
+    error,
+    refetch: fetchMcps,
+    getMcp,
+    createMcp,
+    updateMcp,
+    deleteMcp,
+    bulkDeleteMcps,
+    testConnection
+  };
+}
+
 // src/hooks/useWorkflows.ts
-var import_react14 = require("react");
+var import_react17 = require("react");
 function useWorkflows(options) {
   const opts = typeof options === "boolean" ? { autoFetch: options } : options ?? {};
-  const { autoFetch = true, search, status, page, limit } = opts;
+  const { autoFetch = true, search, scope, visibility, isEnabled, page, limit } = opts;
   const { fetchWithAuth } = usePersonaContext();
-  const [workflows, setWorkflows] = (0, import_react14.useState)([]);
-  const [pagination, setPagination] = (0, import_react14.useState)({
+  const [workflows, setWorkflows] = (0, import_react17.useState)([]);
+  const [pagination, setPagination] = (0, import_react17.useState)({
     page: page ?? 1,
     limit: limit ?? 20,
     total: 0,
     totalPages: 0
   });
-  const [isLoading, setIsLoading] = (0, import_react14.useState)(false);
-  const [error, setError] = (0, import_react14.useState)(null);
-  const fetchWorkflows = (0, import_react14.useCallback)(async () => {
+  const [isLoading, setIsLoading] = (0, import_react17.useState)(false);
+  const [error, setError] = (0, import_react17.useState)(null);
+  const fetchWorkflows = (0, import_react17.useCallback)(async () => {
     setIsLoading(true);
     setError(null);
     try {
       const params = new URLSearchParams();
       if (search) params.set("search", search);
-      if (status) params.set("status", status);
+      if (scope) params.set("scope", scope);
+      if (visibility) params.set("visibility", visibility);
+      if (isEnabled !== void 0) params.set("isEnabled", String(isEnabled));
       if (page) params.set("page", String(page));
       if (limit) params.set("limit", String(limit));
       const queryStr = params.toString() ? `?${params.toString()}` : "";
@@ -3203,7 +3755,7 @@ function useWorkflows(options) {
         throw new Error(`Failed to list workflows: ${res.statusText}`);
       }
       const data = await res.json();
-      const items = Array.isArray(data) ? data : data?.items || data?.workflows || [];
+      const items = Array.isArray(data) ? data : data?.items ?? [];
       setWorkflows(items);
       if (data?.pagination) {
         setPagination({
@@ -3231,8 +3783,8 @@ function useWorkflows(options) {
     } finally {
       setIsLoading(false);
     }
-  }, [fetchWithAuth, search, status, page, limit]);
-  const createWorkflow = (0, import_react14.useCallback)(
+  }, [fetchWithAuth, search, scope, visibility, isEnabled, page, limit]);
+  const createWorkflow = (0, import_react17.useCallback)(
     async (input) => {
       setError(null);
       try {
@@ -3256,7 +3808,7 @@ function useWorkflows(options) {
     },
     [fetchWithAuth]
   );
-  (0, import_react14.useEffect)(() => {
+  (0, import_react17.useEffect)(() => {
     if (autoFetch) {
       void fetchWorkflows();
     }
@@ -3272,17 +3824,17 @@ function useWorkflows(options) {
 }
 
 // src/hooks/useWorkflow.ts
-var import_react15 = require("react");
+var import_react18 = require("react");
 function useWorkflow(workflowId, options) {
   const opts = typeof options === "boolean" ? { autoFetch: options } : options ?? {};
   const { autoFetch = true } = opts;
   const { fetchWithAuth } = usePersonaContext();
-  const [workflow, setWorkflow] = (0, import_react15.useState)(null);
-  const [versions, setVersions] = (0, import_react15.useState)([]);
-  const [mermaid, setMermaid] = (0, import_react15.useState)(null);
-  const [isLoading, setIsLoading] = (0, import_react15.useState)(false);
-  const [error, setError] = (0, import_react15.useState)(null);
-  const fetchWorkflow = (0, import_react15.useCallback)(async () => {
+  const [workflow, setWorkflow] = (0, import_react18.useState)(null);
+  const [versions, setVersions] = (0, import_react18.useState)([]);
+  const [mermaid, setMermaid] = (0, import_react18.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react18.useState)(false);
+  const [error, setError] = (0, import_react18.useState)(null);
+  const fetchWorkflow = (0, import_react18.useCallback)(async () => {
     if (!workflowId) return null;
     setIsLoading(true);
     setError(null);
@@ -3302,20 +3854,31 @@ function useWorkflow(workflowId, options) {
       setIsLoading(false);
     }
   }, [fetchWithAuth, workflowId]);
-  const fetchVersions = (0, import_react15.useCallback)(async () => {
+  const fetchVersions = (0, import_react18.useCallback)(async () => {
     if (!workflowId) return [];
     try {
       const res = await fetchWithAuth(`/workflows/${workflowId}/versions`);
       if (!res.ok) return [];
       const data = await res.json();
-      const items = Array.isArray(data) ? data : data?.items || [];
+      const items = Array.isArray(data) ? data : data?.items ?? [];
       setVersions(items);
       return items;
     } catch {
       return [];
     }
   }, [fetchWithAuth, workflowId]);
-  const fetchMermaid = (0, import_react15.useCallback)(async () => {
+  const getVersion = (0, import_react18.useCallback)(
+    async (version) => {
+      if (!workflowId) throw new Error("Workflow ID is required");
+      const res = await fetchWithAuth(`/workflows/${workflowId}/versions/${version}`);
+      if (!res.ok) {
+        throw new Error(`Failed to fetch workflow version (${res.status}): ${res.statusText}`);
+      }
+      return await res.json();
+    },
+    [fetchWithAuth, workflowId]
+  );
+  const fetchMermaid = (0, import_react18.useCallback)(async () => {
     if (!workflowId) return "";
     try {
       const res = await fetchWithAuth(`/workflows/${workflowId}/mermaid`);
@@ -3328,18 +3891,18 @@ function useWorkflow(workflowId, options) {
       return "";
     }
   }, [fetchWithAuth, workflowId]);
-  const saveDraft = (0, import_react15.useCallback)(
-    async (draft) => {
+  const updateWorkflow = (0, import_react18.useCallback)(
+    async (input) => {
       if (!workflowId) throw new Error("Workflow ID is required");
       setError(null);
-      const res = await fetchWithAuth(`/workflows/${workflowId}/draft`, {
-        method: "POST",
+      const res = await fetchWithAuth(`/workflows/${workflowId}`, {
+        method: "PATCH",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ draft })
+        body: JSON.stringify(input)
       });
       if (!res.ok) {
         const errText = await res.text().catch(() => res.statusText);
-        throw new Error(`Failed to save draft (${res.status}): ${errText}`);
+        throw new Error(`Failed to update workflow (${res.status}): ${errText}`);
       }
       const updated = await res.json();
       setWorkflow(updated);
@@ -3347,27 +3910,41 @@ function useWorkflow(workflowId, options) {
     },
     [fetchWithAuth, workflowId]
   );
-  const publish = (0, import_react15.useCallback)(
-    async (summary) => {
+  const saveDraft = (0, import_react18.useCallback)(
+    async (draft) => {
       if (!workflowId) throw new Error("Workflow ID is required");
       setError(null);
-      const res = await fetchWithAuth(`/workflows/${workflowId}/publish`, {
-        method: "POST",
+      const res = await fetchWithAuth(`/workflows/${workflowId}/draft`, {
+        method: "PUT",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(summary ? { summary } : {})
+        body: JSON.stringify(draft)
       });
       if (!res.ok) {
         const errText = await res.text().catch(() => res.statusText);
-        throw new Error(`Failed to publish workflow (${res.status}): ${errText}`);
+        throw new Error(`Failed to save draft (${res.status}): ${errText}`);
       }
-      const versionResult = await res.json();
-      void fetchWorkflow();
-      void fetchVersions();
-      return versionResult;
+      const updated = await res.json();
+      setWorkflow(updated);
+      return updated;
     },
-    [fetchWithAuth, workflowId, fetchWorkflow, fetchVersions]
+    [fetchWithAuth, workflowId]
   );
-  const deleteWorkflow = (0, import_react15.useCallback)(async () => {
+  const publish = (0, import_react18.useCallback)(async () => {
+    if (!workflowId) throw new Error("Workflow ID is required");
+    setError(null);
+    const res = await fetchWithAuth(`/workflows/${workflowId}/publish`, {
+      method: "POST"
+    });
+    if (!res.ok) {
+      const errText = await res.text().catch(() => res.statusText);
+      throw new Error(`Failed to publish workflow (${res.status}): ${errText}`);
+    }
+    const versionResult = await res.json();
+    void fetchWorkflow();
+    void fetchVersions();
+    return versionResult;
+  }, [fetchWithAuth, workflowId, fetchWorkflow, fetchVersions]);
+  const deleteWorkflow = (0, import_react18.useCallback)(async () => {
     if (!workflowId) throw new Error("Workflow ID is required");
     setError(null);
     const res = await fetchWithAuth(`/workflows/${workflowId}`, {
@@ -3378,7 +3955,7 @@ function useWorkflow(workflowId, options) {
     }
     setWorkflow(null);
   }, [fetchWithAuth, workflowId]);
-  (0, import_react15.useEffect)(() => {
+  (0, import_react18.useEffect)(() => {
     if (autoFetch && workflowId) {
       void fetchWorkflow();
     }
@@ -3391,7 +3968,9 @@ function useWorkflow(workflowId, options) {
     error,
     refetch: fetchWorkflow,
     fetchVersions,
+    getVersion,
     fetchMermaid,
+    updateWorkflow,
     saveDraft,
     publish,
     deleteWorkflow
@@ -3399,25 +3978,25 @@ function useWorkflow(workflowId, options) {
 }
 
 // src/hooks/useWorkflowStream.ts
-var import_react16 = require("react");
+var import_react19 = require("react");
 function useWorkflowStream(workflowId, options) {
   const { baseUrl, getAuthToken, fetchWithAuth, logger } = usePersonaContext();
-  const [status, setStatus] = (0, import_react16.useState)("idle");
-  const [runId, setRunId] = (0, import_react16.useState)(null);
-  const [activeNodeId, setActiveNodeId] = (0, import_react16.useState)(null);
-  const [nodeRuns, setNodeRuns] = (0, import_react16.useState)(
+  const [status, setStatus] = (0, import_react19.useState)("idle");
+  const [runId, setRunId] = (0, import_react19.useState)(null);
+  const [activeNodeId, setActiveNodeId] = (0, import_react19.useState)(null);
+  const [nodeRuns, setNodeRuns] = (0, import_react19.useState)(
     {}
   );
-  const [text, setText] = (0, import_react16.useState)("");
-  const [output, setOutput] = (0, import_react16.useState)(null);
-  const [error, setError] = (0, import_react16.useState)(null);
-  const [events, setEvents] = (0, import_react16.useState)([]);
-  const abortControllerRef = (0, import_react16.useRef)(null);
-  const currentRunIdRef = (0, import_react16.useRef)(null);
+  const [text, setText] = (0, import_react19.useState)("");
+  const [output, setOutput] = (0, import_react19.useState)(null);
+  const [error, setError] = (0, import_react19.useState)(null);
+  const [events, setEvents] = (0, import_react19.useState)([]);
+  const abortControllerRef = (0, import_react19.useRef)(null);
+  const currentRunIdRef = (0, import_react19.useRef)(null);
   currentRunIdRef.current = runId;
-  const optionsRef = (0, import_react16.useRef)(options);
+  const optionsRef = (0, import_react19.useRef)(options);
   optionsRef.current = options;
-  const cancel = (0, import_react16.useCallback)(async () => {
+  const cancel = (0, import_react19.useCallback)(async () => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
@@ -3438,7 +4017,7 @@ function useWorkflowStream(workflowId, options) {
     setStatus("cancelled");
     setActiveNodeId(null);
   }, [fetchWithAuth, logger]);
-  const reset = (0, import_react16.useCallback)(() => {
+  const reset = (0, import_react19.useCallback)(() => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
@@ -3452,7 +4031,7 @@ function useWorkflowStream(workflowId, options) {
     setError(null);
     setEvents([]);
   }, []);
-  const processStream = (0, import_react16.useCallback)(
+  const processStream = (0, import_react19.useCallback)(
     async (url, method, body, targetRunId) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -3617,7 +4196,7 @@ function useWorkflowStream(workflowId, options) {
     },
     [getAuthToken]
   );
-  const start = (0, import_react16.useCallback)(
+  const start = (0, import_react19.useCallback)(
     async (input, opts) => {
       const targetWfId = opts?.workflowId || workflowId;
       if (!targetWfId) {
@@ -3638,7 +4217,7 @@ function useWorkflowStream(workflowId, options) {
     },
     [workflowId, baseUrl, processStream]
   );
-  const resume = (0, import_react16.useCallback)(
+  const resume = (0, import_react19.useCallback)(
     async (targetRunId, sinceSeq) => {
       if (!targetRunId) {
         throw new Error("Run ID is required to resume stream");
@@ -3651,7 +4230,7 @@ function useWorkflowStream(workflowId, options) {
     },
     [baseUrl, processStream]
   );
-  (0, import_react16.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     return () => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -3676,21 +4255,21 @@ function useWorkflowStream(workflowId, options) {
 }
 
 // src/hooks/useWorkflowRuns.ts
-var import_react17 = require("react");
+var import_react20 = require("react");
 function useWorkflowRuns(workflowId, options) {
   const opts = typeof options === "boolean" ? { autoFetch: options } : options ?? {};
   const { autoFetch = true, page = 1, limit = 20 } = opts;
   const { fetchWithAuth } = usePersonaContext();
-  const [runs, setRuns] = (0, import_react17.useState)([]);
-  const [pagination, setPagination] = (0, import_react17.useState)({
+  const [runs, setRuns] = (0, import_react20.useState)([]);
+  const [pagination, setPagination] = (0, import_react20.useState)({
     page,
     limit,
     total: 0,
     totalPages: 0
   });
-  const [isLoading, setIsLoading] = (0, import_react17.useState)(false);
-  const [error, setError] = (0, import_react17.useState)(null);
-  const fetchRuns = (0, import_react17.useCallback)(async () => {
+  const [isLoading, setIsLoading] = (0, import_react20.useState)(false);
+  const [error, setError] = (0, import_react20.useState)(null);
+  const fetchRuns = (0, import_react20.useCallback)(async () => {
     if (!workflowId) return [];
     setIsLoading(true);
     setError(null);
@@ -3701,14 +4280,16 @@ function useWorkflowRuns(workflowId, options) {
         throw new Error(`Failed to list workflow runs: ${res.statusText}`);
       }
       const data = await res.json();
-      const items = Array.isArray(data) ? data : data?.items || data?.runs || [];
+      const items = Array.isArray(data) ? data : data?.items ?? [];
       setRuns(items);
       if (data?.pagination) {
         setPagination({
           page: data.pagination.page ?? page,
           limit: data.pagination.limit ?? limit,
           total: data.pagination.total ?? items.length,
-          totalPages: data.pagination.totalPages ?? 1
+          // Backend's paginationEnvelope() names this field `pages`, not
+          // `totalPages`.
+          totalPages: data.pagination.pages ?? 1
         });
       }
       return items;
@@ -3720,7 +4301,7 @@ function useWorkflowRuns(workflowId, options) {
       setIsLoading(false);
     }
   }, [fetchWithAuth, workflowId, page, limit]);
-  const getRun = (0, import_react17.useCallback)(
+  const getRun = (0, import_react20.useCallback)(
     async (runId) => {
       if (!runId) throw new Error("Run ID is required");
       const res = await fetchWithAuth(`/workflows/runs/${runId}`);
@@ -3731,7 +4312,7 @@ function useWorkflowRuns(workflowId, options) {
     },
     [fetchWithAuth]
   );
-  const cancelRun = (0, import_react17.useCallback)(
+  const cancelRun = (0, import_react20.useCallback)(
     async (runId) => {
       if (!runId) throw new Error("Run ID is required");
       const res = await fetchWithAuth(`/workflows/runs/${runId}/cancel`, {
@@ -3746,7 +4327,7 @@ function useWorkflowRuns(workflowId, options) {
     },
     [fetchWithAuth]
   );
-  (0, import_react17.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     if (autoFetch && workflowId) {
       void fetchRuns();
     }
@@ -3782,7 +4363,9 @@ var VERSION = "0.10.0";
   useChat,
   useConnection,
   useFiles,
+  useKnowledgeBases,
   useMcp,
+  useMcpAdmin,
   useMcpConnections,
   useMemory,
   usePersonaContext,
@@ -3793,6 +4376,7 @@ var VERSION = "0.10.0";
   useWorkflow,
   useWorkflowRuns,
   useWorkflowStream,
-  useWorkflows
+  useWorkflows,
+  useWorkspaceFiles
 });
 //# sourceMappingURL=index.cjs.map