@arbidocs/sdk 0.3.79 → 0.3.80

package/dist/{browser-a0r4Y6dE.d.cts → browser-DIO4_N2g.d.cts}

@@ -333,21 +333,34 @@ interface SSEEvent {
     event: string;
     data: string;
 }
+/**
+ * A document-name lookup: `doc_ext_id` → human file name. Pass this to
+ * `formatAgentStepLabel` so steps that target a specific document
+ * ("Reading document", "Getting table of contents") render the real
+ * file name instead of an opaque `doc-xxxxxxxx` id. Callers build it
+ * from the workspace document list they already fetch before querying.
+ */
+type DocNameMap = Record<string, string>;
 /**
  * Format an AgentStepEvent into a human-readable label.
  *
  * Uses backend-provided `label` field when available, falling back to
- * tool name or step name for old persisted events.
+ * tool name or step name for old persisted events. Pass `docNames` to
+ * resolve document-scoped steps to their file name.
  *
  * Priority:
  * 1. `focus` — the agent's descriptive sentence about what it's doing
- * 2. `label` — backend-provided display label
+ * 2. `label` — backend-provided display label (with doc name + pages
+ *    appended when the step targets one document)
  * 3. For `tool_progress` — detail label + optional message
  * 4. Lifecycle fallback (planning, evaluation, etc.)
  * 5. Tool name from detail
  * 6. Fallback to step name or empty string
+ *
+ * The `goal` step's backend label is "Thinking…" (the bare "Goal" told
+ * a user nothing); the fallback map covers older events that omit it.
  */
-declare function formatAgentStepLabel(step: AgentStepEvent): string;
+declare function formatAgentStepLabel(step: AgentStepEvent, docNames?: DocNameMap): string;
 /**
  * Parse SSE events from a chunk of text, combining with a buffer
  * of incomplete data from previous chunks.
@@ -4396,4 +4409,4 @@ declare namespace responses {
   export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
 }
 
-export { type UploadDirectResult as $, type AgentStepDeltaEvent as A, type ResponseContentPartAddedEvent as B, type ChatSession as C, DOC_TERMINAL_STATUSES as D, type ResponseCreatedEvent as E, type FormattedWsMessage as F, type ResponseFailedEvent as G, type ResponseOutputItemAddedEvent as H, type ResponseOutputItemDoneEvent as I, type ResponseOutputTextDeltaEvent as J, type ResponseOutputTextDoneEvent as K, type ListAllOptions as L, type MessageLevel as M, type ResponseUsage as N, type OutputTokensDetails as O, type ParsedSlashCommand as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, type SSEStreamCallbacks as T, type SSEStreamResult as U, type SSEStreamStartData as V, SUPPORTED_EXTENSIONS as W, type SkillSummary as X, type SkippedFile as Y, type UploadBatchResult as Z, type UploadDirectOptions as _, type AgentStepEvent as a, type UploadOptions as a0, type UploadResult as a1, type UserInfo as a2, type UserInputRequestEvent as a3, type UserMessageEvent as a4, WebSocketAuthError as a5, type WorkspaceContext as a6, type WsConnection as a7, agentconfig as a8, assistant as a9, getErrorMessage as aA, getRawWorkspaceKey as aB, health as aC, parseSSEEvents as aD, parseSlashCommand as aE, parseSlashTokenInProgress as aF, performPasswordLogin as aG, performSigningKeyLogin as aH, performSsoDeviceFlowLogin as aI, requireData as aJ, requireOk as aK, resolveAuth as aL, resolveCitations as aM, resolveWorkspace as aN, responses as aO, selectWorkspace as aP, selectWorkspaceById as aQ, settings as aR, streamSSE as aS, stripCitationMarkdown as aT, summarizeCitations as aU, tags as aV, workspaces as aW, authenticatedFetch as aa, buildRetrievalChunkTool as ab, buildRetrievalFullContextTool as ac, buildRetrievalTocTool as ad, connectWebSocket as ae, connectWithReconnect as af, consumeSSEStream as ag, contacts as ah, conversations as ai, countCitations as aj, createAuthenticatedClient as ak, createDocumentWaiter as al, dm as am, doctags as an, documents as ao, files as ap, filterSkills as aq, formatAgentStepLabel as ar, formatFileSize as as, formatStreamSummary as at, formatUserName as au, formatWorkspaceChoices as av, formatWsMessage as aw, generateEncryptedWorkspaceKey as ax, generateNewWorkspaceKey as ay, getErrorCode as az, Arbi as b, ArbiApiError as c, ArbiError as d, type ArbiErrorEvent as e, type ArbiOptions as f, type ArtifactEvent as g, type AuthContext as h, type AuthHeaders as i, type AuthenticatedClient as j, type CitationSummary as k, type CliConfig as l, type CliCredentials as m, type ConfigStore as n, type ConnectOptions as o, type DmCryptoContext as p, type DocumentListFields as q, type DocumentListOrder as r, type DocumentWaiter as s, type DocumentWaiterOptions as t, type ListPaginatedOptions as u, type MessageMetadataPayload$1 as v, type MessageQueuedEvent as w, type ReconnectableWsConnection as x, type ResolvedCitation as y, type ResponseCompletedEvent as z };
+export { type UploadDirectOptions as $, type AgentStepDeltaEvent as A, type ResponseCompletedEvent as B, type ChatSession as C, DOC_TERMINAL_STATUSES as D, type ResponseContentPartAddedEvent as E, type FormattedWsMessage as F, type ResponseCreatedEvent as G, type ResponseFailedEvent as H, type ResponseOutputItemAddedEvent as I, type ResponseOutputItemDoneEvent as J, type ResponseOutputTextDeltaEvent as K, type ListAllOptions as L, type MessageLevel as M, type ResponseOutputTextDoneEvent as N, type OutputTokensDetails as O, type ParsedSlashCommand as P, type QueryOptions as Q, type ReconnectOptions as R, type ResponseUsage as S, type SSEEvent as T, type SSEStreamCallbacks as U, type SSEStreamResult as V, type SSEStreamStartData as W, SUPPORTED_EXTENSIONS as X, type SkillSummary as Y, type SkippedFile as Z, type UploadBatchResult as _, type AgentStepEvent as a, type UploadDirectResult as a0, type UploadOptions as a1, type UploadResult as a2, type UserInfo as a3, type UserInputRequestEvent as a4, type UserMessageEvent as a5, WebSocketAuthError as a6, type WorkspaceContext as a7, type WsConnection as a8, agentconfig as a9, getErrorCode as aA, getErrorMessage as aB, getRawWorkspaceKey as aC, health as aD, parseSSEEvents as aE, parseSlashCommand as aF, parseSlashTokenInProgress as aG, performPasswordLogin as aH, performSigningKeyLogin as aI, performSsoDeviceFlowLogin as aJ, requireData as aK, requireOk as aL, resolveAuth as aM, resolveCitations as aN, resolveWorkspace as aO, responses as aP, selectWorkspace as aQ, selectWorkspaceById as aR, settings as aS, streamSSE as aT, stripCitationMarkdown as aU, summarizeCitations as aV, tags as aW, workspaces as aX, assistant as aa, authenticatedFetch as ab, buildRetrievalChunkTool as ac, buildRetrievalFullContextTool as ad, buildRetrievalTocTool as ae, connectWebSocket as af, connectWithReconnect as ag, consumeSSEStream as ah, contacts as ai, conversations as aj, countCitations as ak, createAuthenticatedClient as al, createDocumentWaiter as am, dm as an, doctags as ao, documents as ap, files as aq, filterSkills as ar, formatAgentStepLabel as as, formatFileSize as at, formatStreamSummary as au, formatUserName as av, formatWorkspaceChoices as aw, formatWsMessage as ax, generateEncryptedWorkspaceKey as ay, generateNewWorkspaceKey as az, Arbi as b, ArbiApiError as c, ArbiError as d, type ArbiErrorEvent as e, type ArbiOptions as f, type ArtifactEvent as g, type AuthContext as h, type AuthHeaders as i, type AuthenticatedClient as j, type CitationSummary as k, type CliConfig as l, type CliCredentials as m, type ConfigStore as n, type ConnectOptions as o, type DmCryptoContext as p, type DocNameMap as q, type DocumentListFields as r, type DocumentListOrder as s, type DocumentWaiter as t, type DocumentWaiterOptions as u, type ListPaginatedOptions as v, type MessageMetadataPayload$1 as w, type MessageQueuedEvent as x, type ReconnectableWsConnection as y, type ResolvedCitation as z };

package/dist/{browser-a0r4Y6dE.d.ts → browser-DIO4_N2g.d.ts}

@@ -333,21 +333,34 @@ interface SSEEvent {
     event: string;
     data: string;
 }
+/**
+ * A document-name lookup: `doc_ext_id` → human file name. Pass this to
+ * `formatAgentStepLabel` so steps that target a specific document
+ * ("Reading document", "Getting table of contents") render the real
+ * file name instead of an opaque `doc-xxxxxxxx` id. Callers build it
+ * from the workspace document list they already fetch before querying.
+ */
+type DocNameMap = Record<string, string>;
 /**
  * Format an AgentStepEvent into a human-readable label.
  *
  * Uses backend-provided `label` field when available, falling back to
- * tool name or step name for old persisted events.
+ * tool name or step name for old persisted events. Pass `docNames` to
+ * resolve document-scoped steps to their file name.
  *
  * Priority:
  * 1. `focus` — the agent's descriptive sentence about what it's doing
- * 2. `label` — backend-provided display label
+ * 2. `label` — backend-provided display label (with doc name + pages
+ *    appended when the step targets one document)
  * 3. For `tool_progress` — detail label + optional message
  * 4. Lifecycle fallback (planning, evaluation, etc.)
  * 5. Tool name from detail
  * 6. Fallback to step name or empty string
+ *
+ * The `goal` step's backend label is "Thinking…" (the bare "Goal" told
+ * a user nothing); the fallback map covers older events that omit it.
  */
-declare function formatAgentStepLabel(step: AgentStepEvent): string;
+declare function formatAgentStepLabel(step: AgentStepEvent, docNames?: DocNameMap): string;
 /**
  * Parse SSE events from a chunk of text, combining with a buffer
  * of incomplete data from previous chunks.
@@ -4396,4 +4409,4 @@ declare namespace responses {
   export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
 }
 
-export { type UploadDirectResult as $, type AgentStepDeltaEvent as A, type ResponseContentPartAddedEvent as B, type ChatSession as C, DOC_TERMINAL_STATUSES as D, type ResponseCreatedEvent as E, type FormattedWsMessage as F, type ResponseFailedEvent as G, type ResponseOutputItemAddedEvent as H, type ResponseOutputItemDoneEvent as I, type ResponseOutputTextDeltaEvent as J, type ResponseOutputTextDoneEvent as K, type ListAllOptions as L, type MessageLevel as M, type ResponseUsage as N, type OutputTokensDetails as O, type ParsedSlashCommand as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, type SSEStreamCallbacks as T, type SSEStreamResult as U, type SSEStreamStartData as V, SUPPORTED_EXTENSIONS as W, type SkillSummary as X, type SkippedFile as Y, type UploadBatchResult as Z, type UploadDirectOptions as _, type AgentStepEvent as a, type UploadOptions as a0, type UploadResult as a1, type UserInfo as a2, type UserInputRequestEvent as a3, type UserMessageEvent as a4, WebSocketAuthError as a5, type WorkspaceContext as a6, type WsConnection as a7, agentconfig as a8, assistant as a9, getErrorMessage as aA, getRawWorkspaceKey as aB, health as aC, parseSSEEvents as aD, parseSlashCommand as aE, parseSlashTokenInProgress as aF, performPasswordLogin as aG, performSigningKeyLogin as aH, performSsoDeviceFlowLogin as aI, requireData as aJ, requireOk as aK, resolveAuth as aL, resolveCitations as aM, resolveWorkspace as aN, responses as aO, selectWorkspace as aP, selectWorkspaceById as aQ, settings as aR, streamSSE as aS, stripCitationMarkdown as aT, summarizeCitations as aU, tags as aV, workspaces as aW, authenticatedFetch as aa, buildRetrievalChunkTool as ab, buildRetrievalFullContextTool as ac, buildRetrievalTocTool as ad, connectWebSocket as ae, connectWithReconnect as af, consumeSSEStream as ag, contacts as ah, conversations as ai, countCitations as aj, createAuthenticatedClient as ak, createDocumentWaiter as al, dm as am, doctags as an, documents as ao, files as ap, filterSkills as aq, formatAgentStepLabel as ar, formatFileSize as as, formatStreamSummary as at, formatUserName as au, formatWorkspaceChoices as av, formatWsMessage as aw, generateEncryptedWorkspaceKey as ax, generateNewWorkspaceKey as ay, getErrorCode as az, Arbi as b, ArbiApiError as c, ArbiError as d, type ArbiErrorEvent as e, type ArbiOptions as f, type ArtifactEvent as g, type AuthContext as h, type AuthHeaders as i, type AuthenticatedClient as j, type CitationSummary as k, type CliConfig as l, type CliCredentials as m, type ConfigStore as n, type ConnectOptions as o, type DmCryptoContext as p, type DocumentListFields as q, type DocumentListOrder as r, type DocumentWaiter as s, type DocumentWaiterOptions as t, type ListPaginatedOptions as u, type MessageMetadataPayload$1 as v, type MessageQueuedEvent as w, type ReconnectableWsConnection as x, type ResolvedCitation as y, type ResponseCompletedEvent as z };
+export { type UploadDirectOptions as $, type AgentStepDeltaEvent as A, type ResponseCompletedEvent as B, type ChatSession as C, DOC_TERMINAL_STATUSES as D, type ResponseContentPartAddedEvent as E, type FormattedWsMessage as F, type ResponseCreatedEvent as G, type ResponseFailedEvent as H, type ResponseOutputItemAddedEvent as I, type ResponseOutputItemDoneEvent as J, type ResponseOutputTextDeltaEvent as K, type ListAllOptions as L, type MessageLevel as M, type ResponseOutputTextDoneEvent as N, type OutputTokensDetails as O, type ParsedSlashCommand as P, type QueryOptions as Q, type ReconnectOptions as R, type ResponseUsage as S, type SSEEvent as T, type SSEStreamCallbacks as U, type SSEStreamResult as V, type SSEStreamStartData as W, SUPPORTED_EXTENSIONS as X, type SkillSummary as Y, type SkippedFile as Z, type UploadBatchResult as _, type AgentStepEvent as a, type UploadDirectResult as a0, type UploadOptions as a1, type UploadResult as a2, type UserInfo as a3, type UserInputRequestEvent as a4, type UserMessageEvent as a5, WebSocketAuthError as a6, type WorkspaceContext as a7, type WsConnection as a8, agentconfig as a9, getErrorCode as aA, getErrorMessage as aB, getRawWorkspaceKey as aC, health as aD, parseSSEEvents as aE, parseSlashCommand as aF, parseSlashTokenInProgress as aG, performPasswordLogin as aH, performSigningKeyLogin as aI, performSsoDeviceFlowLogin as aJ, requireData as aK, requireOk as aL, resolveAuth as aM, resolveCitations as aN, resolveWorkspace as aO, responses as aP, selectWorkspace as aQ, selectWorkspaceById as aR, settings as aS, streamSSE as aT, stripCitationMarkdown as aU, summarizeCitations as aV, tags as aW, workspaces as aX, assistant as aa, authenticatedFetch as ab, buildRetrievalChunkTool as ac, buildRetrievalFullContextTool as ad, buildRetrievalTocTool as ae, connectWebSocket as af, connectWithReconnect as ag, consumeSSEStream as ah, contacts as ai, conversations as aj, countCitations as ak, createAuthenticatedClient as al, createDocumentWaiter as am, dm as an, doctags as ao, documents as ap, files as aq, filterSkills as ar, formatAgentStepLabel as as, formatFileSize as at, formatStreamSummary as au, formatUserName as av, formatWorkspaceChoices as aw, formatWsMessage as ax, generateEncryptedWorkspaceKey as ay, generateNewWorkspaceKey as az, Arbi as b, ArbiApiError as c, ArbiError as d, type ArbiErrorEvent as e, type ArbiOptions as f, type ArtifactEvent as g, type AuthContext as h, type AuthHeaders as i, type AuthenticatedClient as j, type CitationSummary as k, type CliConfig as l, type CliCredentials as m, type ConfigStore as n, type ConnectOptions as o, type DmCryptoContext as p, type DocNameMap as q, type DocumentListFields as r, type DocumentListOrder as s, type DocumentWaiter as t, type DocumentWaiterOptions as u, type ListPaginatedOptions as v, type MessageMetadataPayload$1 as w, type MessageQueuedEvent as x, type ReconnectableWsConnection as y, type ResolvedCitation as z };

package/dist/browser.cjs

@@ -3787,26 +3787,66 @@ async function resolveWorkspace(store, workspaceOpt) {
 
 // src/sse.ts
 var LIFECYCLE_LABELS_FALLBACK = {
+  goal: "Thinking\u2026",
   evaluation: "Evaluating results",
   answering: "Answered",
   reviewing: "Reviewing answer",
   planning: "Planning",
   tool_progress: "Working"
 };
-function formatAgentStepLabel(step) {
-  if (step.focus) return step.focus;
-  if (step.label) return step.label;
+function resolveDocRefs(text, docNames) {
+  if (!docNames) return text;
+  return text.replace(/\{(doc-[^}]+)\}/g, (_match, id) => docNames[id] ?? id);
+}
+function resolveStepDocName(step, docNames) {
+  if (!docNames) return void 0;
+  const detail = step.detail;
+  if (!detail || detail.length === 0) return void 0;
+  for (const d2 of detail) {
+    const id = d2.doc_ext_id ?? d2.document_ext_id;
+    if (typeof id === "string") return docNames[id] ?? id;
+  }
+  return void 0;
+}
+function extractPageRange(step) {
+  const detail = step.detail;
+  if (!detail || detail.length === 0) return void 0;
+  for (const d2 of detail) {
+    const summary = typeof d2.summary === "string" ? d2.summary : void 0;
+    if (!summary) continue;
+    const match = summary.match(/\bpp?\.\s*(\d[\d.,\s–—-]*)/);
+    if (!match) continue;
+    const floored = match[1].replace(/\d+(?:\.\d+)?/g, (n2) => String(Math.floor(parseFloat(n2)))).replace(/(\d+)\s*[–—-]\s*\1(?!\d)/g, "$1");
+    const items = [];
+    for (const raw of floored.split(",")) {
+      const item = raw.trim();
+      if (item && !items.includes(item)) items.push(item);
+    }
+    if (items.length > 0) return `pp. ${items.join(", ")}`;
+  }
+  return void 0;
+}
+function formatAgentStepLabel(step, docNames) {
+  if (step.step === "goal") {
+    return step.label && step.label !== "Goal" ? step.label : "Thinking\u2026";
+  }
+  if (step.focus) return resolveDocRefs(step.focus, docNames);
+  const docName = resolveStepDocName(step, docNames);
+  const pages = docName ? extractPageRange(step) : void 0;
+  const suffix = docName ? ` \u2014 ${docName}${pages ? ` \xB7 ${pages}` : ""}` : "";
+  if (step.label) return `${step.label}${suffix}`;
   const detail = step.detail;
   if (step.step === "tool_progress" && detail && detail.length > 0) {
     const label = detail[0].label || LIFECYCLE_LABELS_FALLBACK.tool_progress;
+    if (suffix) return `${label}${suffix}`;
     const message = detail[0].message;
-    return message ? `${label}: ${message}` : label;
+    return message ? `${label}: ${resolveDocRefs(message, docNames)}` : label;
   }
   if (step.step) {
     return LIFECYCLE_LABELS_FALLBACK[step.step] || step.step;
   }
   if (detail && detail.length > 0) {
-    if (detail[0].label) return detail[0].label;
+    if (detail[0].label) return `${detail[0].label}${suffix}`;
     if (detail[0].tool) return detail[0].tool;
   }
   return "";