@arbidocs/sdk 0.3.115 → 0.3.117

package/dist/index.cjs

@@ -5187,6 +5187,7 @@ __export(workspaces_exports, {
   copyDocuments: () => copyDocuments,
   createWorkspace: () => createWorkspace,
   deleteWorkspaces: () => deleteWorkspaces,
+  getWorkspaceChronology: () => getWorkspaceChronology,
   listWorkspaceUsers: () => listWorkspaceUsers,
   listWorkspaces: () => listWorkspaces,
   removeWorkspaceUsers: () => removeWorkspaceUsers,
@@ -5251,6 +5252,14 @@ async function setUserRole(arbi, userIds, role) {
     "Failed to update roles"
   );
 }
+async function getWorkspaceChronology(arbi, workspaceId) {
+  return requireData(
+    await arbi.fetch.GET("/v1/workspace/{workspace_ext_id}/chronology", {
+      params: { path: { workspace_ext_id: workspaceId } }
+    }),
+    "Failed to fetch workspace chronology"
+  );
+}
 async function copyDocuments(arbi, targetWorkspaceId, docIds, targetWorkspaceKey) {
   return requireData(
     await arbi.fetch.POST("/v1/workspace/copy", {
@@ -5615,13 +5624,58 @@ __export(dm_exports, {
   decryptDmContent: () => decryptDmContent,
   deleteDMs: () => deleteDMs,
   encryptDmContent: () => encryptDmContent,
+  listActivity: () => listActivity,
   listDMs: () => listDMs,
   listDecryptedDMs: () => listDecryptedDMs,
   markRead: () => markRead,
   requestWorkspaceAccess: () => requestWorkspaceAccess,
+  resolveRecipient: () => resolveRecipient,
   sendDM: () => sendDM,
   sendEncryptedDM: () => sendEncryptedDM
 });
+
+// src/operations/agents.ts
+var agents_exports = {};
+__export(agents_exports, {
+  createAgent: () => createAgent,
+  deleteAgents: () => deleteAgents,
+  getAgentConfig: () => getAgentConfig,
+  listAgentWorkspaces: () => listAgentWorkspaces,
+  listAgents: () => listAgents
+});
+async function listAgents(arbi) {
+  return requireData(await arbi.fetch.GET("/v1/agents"), "Failed to fetch agents");
+}
+async function createAgent(arbi, name) {
+  const body = { name };
+  return requireData(await arbi.fetch.POST("/v1/agents", { body }), "Failed to create agent");
+}
+async function getAgentConfig(arbi, agentExtId) {
+  return requireData(
+    await arbi.fetch.GET("/v1/agents/{agent_ext_id}/config", {
+      params: { path: { agent_ext_id: agentExtId } }
+    }),
+    "Failed to fetch agent config"
+  );
+}
+async function listAgentWorkspaces(arbi, agentExtId) {
+  return requireData(
+    await arbi.fetch.GET("/v1/agents/{agent_ext_id}/workspaces", {
+      params: { path: { agent_ext_id: agentExtId } }
+    }),
+    "Failed to fetch agent workspaces"
+  );
+}
+async function deleteAgents(arbi, agentExtIds) {
+  return requireData(
+    await arbi.fetch.DELETE("/v1/agents", {
+      body: { agent_ext_ids: agentExtIds }
+    }),
+    "Failed to delete agents"
+  );
+}
+
+// src/operations/dm.ts
 function createDmCryptoContext(arbi, signingPrivateKeyBytes, userExtId) {
   const ed25519PublicKey = signingPrivateKeyBytes.slice(32, 64);
   const encryptionKeypair = arbi.crypto.deriveEncryptionKeypairFromSigning({
@@ -5670,6 +5724,51 @@ async function listDecryptedDMs(arbi, crypto) {
   const raw = await listDMs(arbi);
   return decryptDmBatch(arbi, raw, crypto);
 }
+async function listActivity(arbi, options) {
+  return requireData(
+    await arbi.fetch.GET("/v1/notifications/", {
+      params: {
+        query: {
+          type: "activity",
+          ...options?.limit != null ? { limit: options.limit } : {},
+          ...options?.offset != null ? { offset: options.offset } : {}
+        }
+      }
+    }),
+    "Failed to fetch activity"
+  );
+}
+async function resolveRecipient(arbi, ref) {
+  const isEmail = ref.includes("@");
+  const matchKey = isEmail ? "email" : "external_id";
+  const contacts = await listContacts(arbi);
+  const contactMatch = contacts.find(
+    (c2) => isEmail ? c2.email === ref : c2.user?.external_id === ref || c2.external_id === ref
+  );
+  if (contactMatch?.user?.encryption_public_key) {
+    return {
+      extId: contactMatch.user.external_id,
+      pubKey: contactMatch.user.encryption_public_key
+    };
+  }
+  try {
+    const agents = await listAgents(arbi);
+    const agentMatch = agents.find((a2) => a2[matchKey] === ref);
+    if (agentMatch?.encryption_public_key) {
+      return { extId: agentMatch.external_id, pubKey: agentMatch.encryption_public_key };
+    }
+  } catch {
+  }
+  try {
+    const wsUsers = await listWorkspaceUsers(arbi);
+    const wsMatch = wsUsers.find((wu) => wu.user[matchKey] === ref);
+    if (wsMatch?.user.encryption_public_key) {
+      return { extId: wsMatch.user.external_id, pubKey: wsMatch.user.encryption_public_key };
+    }
+  } catch {
+  }
+  return null;
+}
 async function sendEncryptedDM(arbi, messages, crypto) {
   const encrypted = await Promise.all(
     messages.map(async (msg) => ({
@@ -5866,47 +5965,6 @@ async function getFileContent(auth, fileId) {
   });
 }
 
-// src/operations/agents.ts
-var agents_exports = {};
-__export(agents_exports, {
-  createAgent: () => createAgent,
-  deleteAgents: () => deleteAgents,
-  getAgentConfig: () => getAgentConfig,
-  listAgentWorkspaces: () => listAgentWorkspaces,
-  listAgents: () => listAgents
-});
-async function listAgents(arbi) {
-  return requireData(await arbi.fetch.GET("/v1/agents"), "Failed to fetch agents");
-}
-async function createAgent(arbi, name) {
-  const body = { name };
-  return requireData(await arbi.fetch.POST("/v1/agents", { body }), "Failed to create agent");
-}
-async function getAgentConfig(arbi, agentExtId) {
-  return requireData(
-    await arbi.fetch.GET("/v1/agents/{agent_ext_id}/config", {
-      params: { path: { agent_ext_id: agentExtId } }
-    }),
-    "Failed to fetch agent config"
-  );
-}
-async function listAgentWorkspaces(arbi, agentExtId) {
-  return requireData(
-    await arbi.fetch.GET("/v1/agents/{agent_ext_id}/workspaces", {
-      params: { path: { agent_ext_id: agentExtId } }
-    }),
-    "Failed to fetch agent workspaces"
-  );
-}
-async function deleteAgents(arbi, agentExtIds) {
-  return requireData(
-    await arbi.fetch.DELETE("/v1/agents", {
-      body: { agent_ext_ids: agentExtIds }
-    }),
-    "Failed to delete agents"
-  );
-}
-
 // src/operations/sessions.ts
 var sessions_exports = {};
 __export(sessions_exports, {
@@ -5920,6 +5978,9 @@ async function listSessions(arbi) {
 var projects_exports = {};
 __export(projects_exports, {
   createProject: () => createProject,
+  getProjectInvoices: () => getProjectInvoices,
+  getProjectUsage: () => getProjectUsage,
+  getUserUsageToday: () => getUserUsageToday,
   listProjects: () => listProjects,
   refreshProject: () => refreshProject
 });
@@ -5942,6 +6003,28 @@ async function refreshProject(arbi, projectExtId) {
     "Failed to refresh project"
   );
 }
+async function getProjectUsage(arbi, projectExtId, monthsBack) {
+  return requireData(
+    await arbi.fetch.GET("/v1/user/projects/{project_ext_id}/usage", {
+      params: {
+        path: { project_ext_id: projectExtId },
+        query: monthsBack === void 0 ? void 0 : { months_back: monthsBack }
+      }
+    }),
+    "Failed to fetch project usage"
+  );
+}
+async function getProjectInvoices(arbi, projectExtId) {
+  return requireData(
+    await arbi.fetch.GET("/v1/user/projects/{project_ext_id}/invoices", {
+      params: { path: { project_ext_id: projectExtId } }
+    }),
+    "Failed to fetch project invoices"
+  );
+}
+async function getUserUsageToday(arbi) {
+  return requireData(await arbi.fetch.GET("/v1/user/me/usage/today"), "Failed to fetch today usage");
+}
 
 // src/operations/tasks.ts
 async function listTasks(arbi) {
@@ -6017,6 +6100,7 @@ var Arbi = class {
   client = null;
   loginResult = null;
   currentWorkspaceId = null;
+  dmCryptoContext = null;
   options;
   constructor(options) {
     this.options = options;
@@ -6103,6 +6187,7 @@ var Arbi = class {
     }
     this.loginResult = null;
     this.currentWorkspaceId = null;
+    this.dmCryptoContext = null;
   }
   // ── Accessors ─────────────────────────────────────────────────────────
   /** Get the underlying ArbiClient (throws if not initialized). */
@@ -6150,7 +6235,26 @@ var Arbi = class {
   projects = {
     list: () => listProjects(this.requireClient()),
     create: (name) => createProject(this.requireClient(), name),
-    refresh: (projectExtId) => refreshProject(this.requireClient(), projectExtId)
+    refresh: (projectExtId) => refreshProject(this.requireClient(), projectExtId),
+    /** AI usage + spend breakdown for a project's billing period. */
+    usage: (projectExtId, monthsBack) => getProjectUsage(this.requireClient(), projectExtId, monthsBack),
+    /** Stripe invoices for a project's subscription. */
+    invoices: (projectExtId) => getProjectInvoices(this.requireClient(), projectExtId)
+  };
+  // ── User (account-scoped usage) ───────────────────────────────────────
+  user = {
+    /**
+     * The authenticated user's identity from the current session
+     * (`external_id` + `email`), established at login. Returns `null` when not
+     * logged in. This is the canonical "who am I" accessor — DM direction and
+     * ownership checks read it instead of re-deriving identity per call.
+     */
+    identity: () => {
+      const state = this.requireClient().session.getState();
+      return state.userExtId && state.userEmail ? { externalId: state.userExtId, email: state.userEmail } : null;
+    },
+    /** Today's deployment-wide credit spend for the current user. */
+    usageToday: () => getUserUsageToday(this.requireClient())
   };
   // ── Workspaces ────────────────────────────────────────────────────────
   workspaces = {
@@ -6198,6 +6302,14 @@ var Arbi = class {
       targetWorkspaceId,
       docIds,
       targetWorkspaceKey
+    ),
+    /**
+     * The last-generated document-derived chronology (key case events / dates).
+     * Defaults to the currently open workspace when no id is passed.
+     */
+    chronology: (workspaceId) => getWorkspaceChronology(
+      this.requireClient(),
+      workspaceId ?? this.requireWorkspace()
     )
   };
   // ── Documents ─────────────────────────────────────────────────────────
@@ -6324,11 +6436,80 @@ var Arbi = class {
     groupByStatus: groupContactsByStatus
   };
   // ── Direct Messages ───────────────────────────────────────────────────
+  /**
+   * Build (and cache) the DM crypto context for the current session.
+   *
+   * Derives the user's curve25519 keypair from the stored signing key and pairs
+   * it with their external_id — everything `list()`/`send()` need to encrypt and
+   * decrypt. Cached for the session and cleared on logout. Consumers never touch
+   * this: it's an internal of the `dm` surface.
+   */
+  async requireDmCrypto() {
+    if (this.dmCryptoContext) return this.dmCryptoContext;
+    const client = this.requireClient();
+    const session = await client.storage.getSession();
+    if (!session) {
+      throw new ArbiError("Not authenticated \u2014 no session available for DM encryption");
+    }
+    const userExtId = client.session.getState().userExtId;
+    if (!userExtId) {
+      throw new ArbiError("No user identity in session \u2014 cannot set up DM encryption");
+    }
+    this.dmCryptoContext = createDmCryptoContext(client, session.signingPrivateKey, userExtId);
+    return this.dmCryptoContext;
+  }
   dm = {
-    list: () => listDMs(this.requireClient()),
-    send: (messages) => sendDM(this.requireClient(), messages),
+    /**
+     * List direct messages, newest first, with content already **decrypted**.
+     * (A message that can't be decrypted comes back as `[Decryption failed]`.)
+     */
+    list: async () => listDecryptedDMs(this.requireClient(), await this.requireDmCrypto()),
+    /**
+     * Send an E2E-encrypted DM to a recipient (email or `usr-`/`agt-` id).
+     * Resolves the recipient's public key and encrypts internally — the caller
+     * passes plaintext and never handles keys or ciphertext.
+     */
+    send: async (recipient, text) => {
+      const client = this.requireClient();
+      const resolved = await resolveRecipient(client, recipient);
+      if (!resolved) {
+        throw new ArbiError(
+          `Could not resolve DM recipient "${recipient}" (not a known contact, agent, or workspace member)`
+        );
+      }
+      return sendEncryptedDM(
+        client,
+        [
+          {
+            recipient_ext_id: resolved.extId,
+            content: text,
+            recipient_encryption_public_key: resolved.pubKey
+          }
+        ],
+        await this.requireDmCrypto()
+      );
+    },
+    /**
+     * Send to a recipient whose external_id + public key are already known
+     * (e.g. from a message's `sender`), skipping directory resolution.
+     */
+    sendTo: async (recipientExtId, recipientPublicKey, text) => sendEncryptedDM(
+      this.requireClient(),
+      [
+        {
+          recipient_ext_id: recipientExtId,
+          content: text,
+          recipient_encryption_public_key: recipientPublicKey
+        }
+      ],
+      await this.requireDmCrypto()
+    ),
+    /** Resolve a recipient reference to `{ extId, pubKey }` (contacts → agents → workspace). */
+    resolveRecipient: (recipient) => resolveRecipient(this.requireClient(), recipient),
     markRead: (messageIds) => markRead(this.requireClient(), messageIds),
-    delete: (messageIds) => deleteDMs(this.requireClient(), messageIds)
+    delete: (messageIds) => deleteDMs(this.requireClient(), messageIds),
+    /** List the current user's durable activity feed (never unread; excluded from DMs). */
+    listActivity: (options) => listActivity(this.requireClient(), options)
   };
   // ── Settings ──────────────────────────────────────────────────────────
   settings = {