@arbidocs/sdk 0.5.80 → 0.5.82

package/dist/index.cjs

@@ -3652,6 +3652,21 @@ function requireData(result, message) {
   }
   return result.data;
 }
+var WORKSPACE_REQUEST_CONFLICT_MESSAGES = {
+  workspace_mismatch: "This belongs to another workspace, so nothing was saved.",
+  workspace_key_required: "This workspace isn't unlocked in this session, so nothing was saved or read. Open the workspace and try again."
+};
+function requireWorkspaceData(result, message, conflicts = WORKSPACE_REQUEST_CONFLICT_MESSAGES) {
+  const status = result.response?.status;
+  const conflict = result.error && status === 409 ? workspaceConflictOf(result.error) : null;
+  if (conflict) {
+    throw new ArbiApiError(conflicts[conflict.code], result.error, status, {
+      code: conflict.code,
+      requestId: result.response?.headers?.get("x-request-id") ?? void 0
+    });
+  }
+  return requireData(result, message);
+}
 function requireOk(result, message) {
   if (result.error) {
     throw new ArbiApiError(message, result.error, result.response?.status, {
@@ -6253,19 +6268,7 @@ var UPLOAD_WORKSPACE_CONFLICT_MESSAGES = {
   workspace_key_required: "The workspace couldn't be unlocked for this upload, so the files were not saved."
 };
 function requireUploadData(result, message) {
-  const status = result.response?.status;
-  const conflict = result.error && status === 409 ? workspaceConflictOf(result.error) : null;
-  if (conflict) {
-    throw new ArbiApiError(
-      UPLOAD_WORKSPACE_CONFLICT_MESSAGES[conflict.code],
-      result.error,
-      status,
-      {
-        code: conflict.code
-      }
-    );
-  }
-  return requireData(result, message);
+  return requireWorkspaceData(result, message, UPLOAD_WORKSPACE_CONFLICT_MESSAGES);
 }
 async function uploadDocuments(arbi, files, options = {}) {
   const query2 = {};
@@ -7183,15 +7186,27 @@ __export(conversations_exports, {
   searchConversations: () => searchConversations,
   updateConversationAssistantMode: () => updateConversationAssistantMode
 });
-async function listConversations(arbi) {
-  return requireData(await arbi.fetch.GET("/v1/conversation/list"), "Failed to fetch conversations");
+
+// src/operations/workspace-query.ts
+var workspaceQuery = (workspaceExtId) => workspaceExtId ? { workspace_ext_id: workspaceExtId } : {};
+
+// src/operations/conversations.ts
+async function listConversations(arbi, workspaceExtId) {
+  return requireWorkspaceData(
+    await arbi.fetch.GET("/v1/conversation/list", {
+      params: { query: workspaceQuery(workspaceExtId) }
+    }),
+    "Failed to fetch conversations"
+  );
 }
-async function importConversations(auth, fileData, fileName, source = "auto") {
+async function importConversations(auth, fileData, fileName, source = "auto", workspaceExtId) {
   const formData = new FormData();
   formData.append("file", fileData, fileName);
+  const query2 = new URLSearchParams({ source });
+  if (workspaceExtId) query2.set("workspace_ext_id", workspaceExtId);
   const res = await authenticatedFetch({
     ...auth,
-    path: `/v1/conversation/import?source=${encodeURIComponent(source)}`,
+    path: `/v1/conversation/import?${query2}`,
     method: "POST",
     body: formData
   });
@@ -7213,9 +7228,12 @@ async function deleteConversation(arbi, conversationId) {
     "Failed to delete conversation"
   );
 }
-async function searchConversations(arbi, body) {
-  return requireData(
-    await arbi.fetch.POST("/v1/conversation/search", { body }),
+async function searchConversations(arbi, body, workspaceExtId) {
+  return requireWorkspaceData(
+    await arbi.fetch.POST("/v1/conversation/search", {
+      params: { query: workspaceQuery(workspaceExtId) },
+      body
+    }),
     "Failed to search conversations"
   );
 }
@@ -7578,9 +7596,14 @@ async function interject(arbi, assistantMessageExtId, answer) {
   );
 }
 async function listSkills(arbi, options) {
-  const result = requireData(
+  const result = requireWorkspaceData(
     await arbi.fetch.GET("/v1/assistant/skills", {
-      params: { query: { include_hidden: options?.includeHidden ?? false } }
+      params: {
+        query: {
+          include_hidden: options?.includeHidden ?? false,
+          ...workspaceQuery(options?.workspaceExtId)
+        }
+      }
     }),
     "Failed to list skills"
   );
@@ -9072,9 +9095,10 @@ __export(files_exports, {
   uploadFile: () => uploadFile2
 });
 async function listFiles(arbi, options) {
-  return requireData(
+  const { workspaceExtId, ...query2 } = options ?? {};
+  return requireWorkspaceData(
     await arbi.fetch.GET("/v1/files", {
-      params: { query: options ?? {} }
+      params: { query: { ...query2, ...workspaceQuery(workspaceExtId) } }
     }),
     "Failed to list files"
   );
@@ -9095,13 +9119,13 @@ async function deleteFile(arbi, fileId) {
     "Failed to delete file"
   );
 }
-async function uploadFile2(auth, fileData, fileName, purpose = "assistants") {
+async function uploadFile2(auth, fileData, fileName, purpose = "assistants", workspaceExtId) {
   const formData = new FormData();
   formData.append("file", fileData, fileName);
   formData.append("purpose", purpose);
   const res = await authenticatedFetch({
     ...auth,
-    path: "/v1/files",
+    path: workspaceExtId ? `/v1/files?workspace_ext_id=${encodeURIComponent(workspaceExtId)}` : "/v1/files",
     method: "POST",
     body: formData
   });
@@ -10183,22 +10207,31 @@ function stepsPlan(steps) {
 }
 
 // src/operations/work.ts
+var TASK_WORKSPACE_CONFLICT_MESSAGES = {
+  ...WORKSPACE_REQUEST_CONFLICT_MESSAGES,
+  workspace_mismatch: "The parent task is in another workspace, so the task was not saved. Choose a parent in the same workspace."
+};
 var byId = (conversationId) => ({
   params: { path: { conversation_ext_id: conversationId } }
 });
 async function updateConversation(arbi, conversationId, body) {
-  return requireData(
+  return requireWorkspaceData(
     await arbi.fetch.PATCH("/v1/conversation/{conversation_ext_id}", {
       ...byId(conversationId),
       body
     }),
-    "Failed to update conversation"
+    "Failed to update conversation",
+    TASK_WORKSPACE_CONFLICT_MESSAGES
   );
 }
-async function createWork(arbi, body) {
-  return requireData(
-    await arbi.fetch.POST("/v1/conversation/work", { body }),
-    "Failed to create task"
+async function createWork(arbi, body, workspaceExtId) {
+  return requireWorkspaceData(
+    await arbi.fetch.POST("/v1/conversation/work", {
+      params: { query: workspaceQuery(workspaceExtId) },
+      body
+    }),
+    "Failed to create task",
+    TASK_WORKSPACE_CONFLICT_MESSAGES
   );
 }
 async function runConversation(arbi, conversationId) {
@@ -10264,9 +10297,12 @@ async function getActivity(arbi, conversationId) {
     "Failed to read the task activity"
   );
 }
-async function planWork(arbi, body) {
-  return requireData(
-    await arbi.fetch.POST("/v1/conversation/work/plan", { body }),
+async function planWork(arbi, body, workspaceExtId) {
+  return requireWorkspaceData(
+    await arbi.fetch.POST("/v1/conversation/work/plan", {
+      params: { query: workspaceQuery(workspaceExtId) },
+      body
+    }),
     "Failed to draft a plan"
   );
 }
@@ -10386,14 +10422,26 @@ __export(facts_exports, {
   searchFacts: () => searchFacts,
   updateFact: () => updateFact
 });
-async function createFact(arbi, body) {
-  return requireData(await arbi.fetch.POST("/v1/facts/", { body }), "Failed to create note");
+async function createFact(arbi, body, workspaceExtId) {
+  return requireWorkspaceData(
+    await arbi.fetch.POST("/v1/facts/", {
+      params: { query: workspaceQuery(workspaceExtId) },
+      body
+    }),
+    "Failed to create note"
+  );
 }
-async function createFactsBatch(arbi, body) {
-  return requireData(await arbi.fetch.POST("/v1/facts/batch", { body }), "Failed to create notes");
+async function createFactsBatch(arbi, body, workspaceExtId) {
+  return requireWorkspaceData(
+    await arbi.fetch.POST("/v1/facts/batch", {
+      params: { query: workspaceQuery(workspaceExtId) },
+      body
+    }),
+    "Failed to create notes"
+  );
 }
 async function listFacts(arbi, options) {
-  return requireData(
+  return requireWorkspaceData(
     await arbi.fetch.GET("/v1/facts/list", {
       params: {
         query: {
@@ -10403,18 +10451,25 @@ async function listFacts(arbi, options) {
           tag_ext_id: options?.tagExtIds,
           doc_ext_id: options?.docExtId,
           limit: options?.limit,
-          offset: options?.offset
+          offset: options?.offset,
+          ...workspaceQuery(options?.workspaceExtId)
         }
       }
     }),
     "Failed to list notes"
   );
 }
-async function searchFacts(arbi, body) {
-  return requireData(await arbi.fetch.POST("/v1/facts/search", { body }), "Failed to search notes");
+async function searchFacts(arbi, body, workspaceExtId) {
+  return requireWorkspaceData(
+    await arbi.fetch.POST("/v1/facts/search", {
+      params: { query: workspaceQuery(workspaceExtId) },
+      body
+    }),
+    "Failed to search notes"
+  );
 }
 async function updateFact(arbi, factId, body) {
-  return requireData(
+  return requireWorkspaceData(
     await arbi.fetch.PATCH("/v1/facts/{fact_ext_id}", {
       params: { path: { fact_ext_id: factId } },
       body
@@ -10429,7 +10484,7 @@ async function deleteFact(arbi, factId) {
   if (error) throw new Error("Failed to delete note");
 }
 async function remindFact(arbi, factId, options = {}) {
-  return requireData(
+  return requireWorkspaceData(
     await arbi.fetch.POST("/v1/facts/{fact_ext_id}/remind", {
       params: { path: { fact_ext_id: factId } },
       body: {
@@ -12868,11 +12923,22 @@ var Arbi = class {
   };
   // ── Conversations ─────────────────────────────────────────────────────
   conversations = {
-    list: () => listConversations(this.requireClient()),
+    /** The current workspace's conversations, or `options.workspaceId`'s (opened, not switched to). */
+    list: async (options) => listConversations(
+      this.requireClient(),
+      await this.requireTargetWorkspace(options?.workspaceId)
+    ),
     getThreads: (conversationId) => getConversationThreads(this.requireClient(), conversationId),
     delete: (conversationId) => deleteConversation(this.requireClient(), conversationId),
-    /** Search the open workspace's past conversation messages (keyword + semantic), grouped. */
-    search: (body) => searchConversations(this.requireClient(), body),
+    /**
+     * Search the past conversation messages (keyword + semantic, grouped) of the current
+     * workspace, or `options.workspaceId` (opened for this session, not switched to).
+     */
+    search: async (body, options) => searchConversations(
+      this.requireClient(),
+      body,
+      await this.requireTargetWorkspace(options?.workspaceId)
+    ),
     /**
      * Patch a conversation: `title`, `shared` (owner only), its bound document
      * (`bound_document_ext_id`, `null` unbinds), and the work fields (`description`, `due_at`,
@@ -12880,8 +12946,16 @@ var Arbi = class {
      * and attaching a thread to a document.
      */
     update: (conversationId, body) => updateConversation(this.requireClient(), conversationId, body),
-    /** Create a work item: a plain to-do, or (with a prompt / skill) agent work that starts now. */
-    createWork: (body) => createWork(this.requireClient(), body),
+    /**
+     * Create a work item: a plain to-do, or (with a prompt / skill) agent work that starts now. It
+     * is made in the current workspace, or `options.workspaceId` (opened, not switched to), which
+     * the request names: a switch while it is sent cannot move it.
+     */
+    createWork: async (body, options) => createWork(
+      this.requireClient(),
+      body,
+      await this.requireTargetWorkspace(options?.workspaceId)
+    ),
     /** Run a work item now, or retry it. */
     run: (conversationId) => runConversation(this.requireClient(), conversationId),
     /** The session key an unattended run waits for the owner to allow; 404 when nothing waits. */
@@ -12902,8 +12976,12 @@ var Arbi = class {
     usage: (conversationId) => getConversationUsage(this.requireClient(), conversationId),
     /** Notify people about a conversation (each gets a notification); resolves with who was. */
     notify: (conversationId, userIds) => notifyConversation(this.requireClient(), conversationId, userIds),
-    /** Draft an editable plan from an objective. */
-    plan: (body) => planWork(this.requireClient(), body),
+    /** Draft an editable plan from an objective, in the current workspace or `options.workspaceId`. */
+    plan: async (body, options) => planWork(
+      this.requireClient(),
+      body,
+      await this.requireTargetWorkspace(options?.workspaceId)
+    ),
     /**
      * Run a work item and, when the run is parked waiting for workspace access, grant the agent's
      * run session a temporary key and run it again. Work that needs no access grant returns from the
@@ -13377,8 +13455,15 @@ var Arbi = class {
     },
     /** Read the status of a background turn. */
     getResponse: (id) => this.recovering(() => getResponse(this.getAuthHeaders(), id)),
-    /** The skills the caller can run (own + shared marketplace), metadata only. */
-    listSkills: (options) => listSkills(this.requireClient(), options),
+    /**
+     * The skills the caller can run (own + shared marketplace), metadata only. Without a
+     * marketplace they are the current workspace's, or `options.workspaceId`'s (opened, not
+     * switched to).
+     */
+    listSkills: async (options) => listSkills(this.requireClient(), {
+      includeHidden: options?.includeHidden,
+      workspaceExtId: await this.targetWorkspace(options?.workspaceId)
+    }),
     /**
      * Save a SKILL.md as the caller's skill ``slug``: private unless ``shared`` (pass
      * ``shared: isSharedSkill(skill)`` when changing an existing skill, so a shared one stays shared).
@@ -14014,12 +14099,23 @@ var Arbi = class {
   };
   // ── Files (OpenAI-compatible) ────────────────────────────────────────
   files = {
-    list: (options) => listFiles(this.requireClient(), options),
+    /** The current workspace's files, or `options.workspaceId`'s (opened, not switched to). */
+    list: async (options) => {
+      const { workspaceId, ...rest } = options ?? {};
+      return listFiles(this.requireClient(), {
+        ...rest,
+        workspaceExtId: await this.targetWorkspace(workspaceId)
+      });
+    },
     get: (fileId) => getFile(this.requireClient(), fileId),
     delete: (fileId) => deleteFile(this.requireClient(), fileId),
-    upload: (fileData, fileName, purpose) => this.recovering(
-      () => uploadFile2(this.getAuthHeaders(), fileData, fileName, purpose)
-    ),
+    /** Upload a file into the current workspace, or `options.workspaceId` (opened, not switched to). */
+    upload: async (fileData, fileName, purpose, options) => {
+      const workspaceExtId = await this.targetWorkspace(options?.workspaceId);
+      return this.recovering(
+        () => uploadFile2(this.getAuthHeaders(), fileData, fileName, purpose, workspaceExtId)
+      );
+    },
     getContent: (fileId) => this.recovering(() => getFileContent(this.getAuthHeaders(), fileId))
   };
   // ── Agents ──────────────────────────────────────────────────────────
@@ -14155,15 +14251,38 @@ var Arbi = class {
     export: (databaseId, format) => exportDatabase(this.requireClient(), databaseId, format)
   };
   // ── Workspace facts ─────────────────────────────────────────────────
+  /**
+   * Notes. Create, list and search act in the current workspace, or `workspaceId` (opened for this
+   * session, not switched to), which the request names; update, delete and remind act in the
+   * note's own workspace, which the server derives from it.
+   */
   facts = {
-    create: (body) => createFact(this.requireClient(), body),
+    create: async (body, options) => createFact(
+      this.requireClient(),
+      body,
+      await this.requireTargetWorkspace(options?.workspaceId)
+    ),
     /** Create up to 200 notes in one all-or-nothing request. */
-    createBatch: (body) => createFactsBatch(this.requireClient(), body),
+    createBatch: async (body, options) => createFactsBatch(
+      this.requireClient(),
+      body,
+      await this.requireTargetWorkspace(options?.workspaceId)
+    ),
     /** Pass `from`/`to`/`datedOnly` for the timeline view — dated notes only,
      *  ordered by when they happened. `tagExtIds` / `docExtId` narrow the list;
      *  `limit` / `offset` page it. */
-    list: (options) => listFacts(this.requireClient(), options),
-    search: (body) => searchFacts(this.requireClient(), body),
+    list: async (options) => {
+      const { workspaceId, ...filter } = options ?? {};
+      return listFacts(this.requireClient(), {
+        ...filter,
+        workspaceExtId: await this.requireTargetWorkspace(workspaceId)
+      });
+    },
+    search: async (body, options) => searchFacts(
+      this.requireClient(),
+      body,
+      await this.requireTargetWorkspace(options?.workspaceId)
+    ),
     update: (factId, body) => updateFact(this.requireClient(), factId, body),
     delete: (factId) => deleteFact(this.requireClient(), factId),
     /** One-off reminder on a dated note: an explicit `remindAt`, or