@arbidocs/sdk 0.3.15 → 0.3.17

package/dist/index.cjs

@@ -129,11 +129,13 @@ var FileConfigStore = class {
   configFile;
   credentialsFile;
   sessionFile;
+  metadataFile;
   constructor(configDir) {
     this.configDir = configDir ?? process.env.ARBI_CONFIG_DIR ?? path2__default.default.join(os__default.default.homedir(), ".arbi");
     this.configFile = path2__default.default.join(this.configDir, "config.json");
     this.credentialsFile = path2__default.default.join(this.configDir, "credentials.json");
     this.sessionFile = path2__default.default.join(this.configDir, "session.json");
+    this.metadataFile = path2__default.default.join(this.configDir, "last-metadata.json");
   }
   ensureConfigDir() {
     if (!fs__default.default.existsSync(this.configDir)) {
@@ -204,6 +206,13 @@ var FileConfigStore = class {
   clearChatSession() {
     this.saveChatSession({ ...DEFAULT_SESSION });
   }
+  // ── Last metadata (for citation browsing) ────────────────────────────────
+  saveLastMetadata(metadata) {
+    this.writeSecureFile(this.metadataFile, metadata);
+  }
+  loadLastMetadata() {
+    return this.readJsonFile(this.metadataFile);
+  }
   /**
    * Try to resolve config from multiple sources, in priority order:
    *
@@ -577,6 +586,14 @@ async function streamSSE(response, callbacks = {}) {
       callbacks.onError?.(message);
     },
     // ARBI-specific events (dot-prefixed from server)
+    "arbi.message_queued": (raw) => {
+      const data = JSON.parse(raw);
+      if (data.user_message) {
+        userMessage = data.user_message;
+        callbacks.onUserMessage?.(data.user_message);
+      }
+      callbacks.onMessageQueued?.(data);
+    },
     "arbi.agent_step": (raw) => {
       const data = JSON.parse(raw);
       const label = formatAgentStepLabel(data);
@@ -644,6 +661,27 @@ async function streamSSE(response, callbacks = {}) {
     context
   };
 }
+function formatStreamSummary(result, elapsedTime) {
+  const parts = [];
+  if (result.agentSteps.length > 0) {
+    let stepLabel = `${result.agentSteps.length} step${result.agentSteps.length === 1 ? "" : "s"}`;
+    if (result.toolCallCount > 0) {
+      stepLabel += ` (${result.toolCallCount} tool call${result.toolCallCount === 1 ? "" : "s"})`;
+    }
+    parts.push(stepLabel);
+  }
+  if (result.usage) {
+    parts.push(`${result.usage.total_tokens.toLocaleString()} tokens`);
+  }
+  if (result.context && result.context.context_window > 0) {
+    const used = result.context.all_llm_calls?.last_input_tokens ?? result.context.total_input;
+    parts.push(`${used.toLocaleString()}/${result.context.context_window.toLocaleString()} context`);
+  }
+  if (elapsedTime != null) {
+    parts.push(`${elapsedTime.toFixed(1)}s`);
+  }
+  return parts.length > 0 ? parts.join(" \xB7 ") : "";
+}
 var consumeSSEStream = streamSSE;
 var AUTH_TIMEOUT_MS = 1e4;
 var MAX_BACKOFF_MS = 3e4;
@@ -868,6 +906,66 @@ function formatUserName(user) {
   return [user.given_name, user.family_name].filter(Boolean).join(" ");
 }
 
+// src/citations.ts
+function resolveCitations(metadata) {
+  if (!metadata?.tools) return [];
+  const tools = metadata.tools;
+  const modelCitations = tools.model_citations;
+  const citationMap = modelCitations?.tool_responses;
+  if (!citationMap || Object.keys(citationMap).length === 0) return [];
+  const chunkLookup = buildChunkLookup(tools);
+  const resolved = [];
+  for (const [citationNum, citationData] of Object.entries(citationMap)) {
+    const chunks = [];
+    for (const chunkId of citationData.chunk_ids ?? []) {
+      const chunk = chunkLookup.get(chunkId);
+      if (chunk) chunks.push(chunk);
+    }
+    resolved.push({ citationNum, citationData, chunks });
+  }
+  resolved.sort((a, b) => Number(a.citationNum) - Number(b.citationNum));
+  return resolved;
+}
+function summarizeCitations(resolved) {
+  return resolved.map((r) => {
+    const firstChunk = r.chunks[0];
+    return {
+      citationNum: r.citationNum,
+      statement: r.citationData.statement ?? "",
+      docTitle: firstChunk?.metadata?.doc_title ?? "Unknown document",
+      pageNumber: firstChunk?.metadata?.page_number ?? null,
+      chunkCount: r.chunks.length
+    };
+  });
+}
+function countCitations(metadata) {
+  if (!metadata?.tools) return 0;
+  const tools = metadata.tools;
+  const modelCitations = tools.model_citations;
+  const responses = modelCitations?.tool_responses;
+  return responses ? Object.keys(responses).length : 0;
+}
+function stripCitationMarkdown(text) {
+  return text.replace(/\[([^\]]+)\]\(#cite-(\d+)\)/g, "$1[$2]");
+}
+function buildChunkLookup(tools) {
+  const lookup = /* @__PURE__ */ new Map();
+  for (const toolName of ["retrieval_chunk", "retrieval_full_context"]) {
+    const tool = tools[toolName];
+    if (!tool?.tool_responses) continue;
+    for (const chunks of Object.values(tool.tool_responses)) {
+      if (!Array.isArray(chunks)) continue;
+      for (const chunk of chunks) {
+        const id = chunk.metadata?.chunk_ext_id;
+        if (id && !lookup.has(id)) {
+          lookup.set(id, chunk);
+        }
+      }
+    }
+  }
+  return lookup;
+}
+
 // src/operations/documents.ts
 var documents_exports = {};
 __export(documents_exports, {
@@ -1565,6 +1663,19 @@ var Arbi = class {
       lr.serverSessionKey,
       signingPrivateKeyBase64
     );
+    const workspaceKeyHeader = client.session.getWorkspaceKeyHeader();
+    if (workspaceKeyHeader) {
+      const { data: openResult, error: openError } = await client.fetch.POST(
+        "/v1/workspace/{workspace_ext_id}/open",
+        {
+          params: { path: { workspace_ext_id: ws.external_id } },
+          body: { workspace_key: workspaceKeyHeader }
+        }
+      );
+      if (!openError && openResult?.access_token) {
+        client.session.setAccessToken(openResult.access_token);
+      }
+    }
     this.currentWorkspaceId = ws.external_id;
   }
   /** Log out and clear internal state. */
@@ -1983,6 +2094,7 @@ exports.connectWithReconnect = connectWithReconnect;
 exports.consumeSSEStream = consumeSSEStream;
 exports.contacts = contacts_exports;
 exports.conversations = conversations_exports;
+exports.countCitations = countCitations;
 exports.createAuthenticatedClient = createAuthenticatedClient;
 exports.createDocumentWaiter = createDocumentWaiter;
 exports.dm = dm_exports;
@@ -1992,6 +2104,7 @@ exports.documentsNode = documents_node_exports;
 exports.files = files_exports;
 exports.formatAgentStepLabel = formatAgentStepLabel;
 exports.formatFileSize = formatFileSize;
+exports.formatStreamSummary = formatStreamSummary;
 exports.formatUserName = formatUserName;
 exports.formatWorkspaceChoices = formatWorkspaceChoices;
 exports.formatWsMessage = formatWsMessage;
@@ -2004,12 +2117,15 @@ exports.performPasswordLogin = performPasswordLogin;
 exports.requireData = requireData;
 exports.requireOk = requireOk;
 exports.resolveAuth = resolveAuth;
+exports.resolveCitations = resolveCitations;
 exports.resolveWorkspace = resolveWorkspace;
 exports.responses = responses_exports;
 exports.selectWorkspace = selectWorkspace;
 exports.selectWorkspaceById = selectWorkspaceById;
 exports.settings = settings_exports;
 exports.streamSSE = streamSSE;
+exports.stripCitationMarkdown = stripCitationMarkdown;
+exports.summarizeCitations = summarizeCitations;
 exports.tags = tags_exports;
 exports.workspaces = workspaces_exports;
 //# sourceMappingURL=index.cjs.map