@arbidocs/sdk 0.3.79 → 0.3.81

package/dist/{browser-a0r4Y6dE.d.cts → browser-CV7TVakj.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.
@@ -2692,7 +2705,6 @@ declare class Arbi {
                 MEMORY_CREATION: boolean;
                 GOALS_ENABLED: boolean;
                 GOAL_MAX_OUTER_LOOPS: number;
-                REVIEW_ENABLED: boolean;
                 PERSONA: string;
                 AGENT_MODEL_NAME: string;
                 AGENT_API_TYPE: "local" | "remote";
@@ -3355,9 +3367,11 @@ declare namespace tags {
 }
 
 /**
- * Conversation operations — list, threads, delete, share, title, messages.
+ * Conversation operations — list, threads, delete, share, title, messages, import.
  */
 
+type ConversationImportResponse = components['schemas']['ConversationImportResponse'];
+
 declare function listConversations(arbi: ArbiClient): Promise<{
     external_id: string;
     title: string | null;
@@ -3369,6 +3383,16 @@ declare function listConversations(arbi: ArbiClient): Promise<{
     message_count: number;
     last_message_status?: string | null | undefined;
 }[]>;
+/**
+ * Import a conversation export into the active workspace.
+ *
+ * Accepts a ChatGPT data export (`conversations.json`), an OpenClaw session log, or a
+ * Claude Code transcript (`.jsonl`); `source='auto'` lets the server detect the format.
+ * Uses raw multipart fetch (the typed client can't express file uploads), mirroring
+ * `files.uploadFile`. The active workspace + cipher are resolved server-side from the
+ * session, so no extra header is needed.
+ */
+declare function importConversations(auth: AuthHeaders, fileData: Blob, fileName: string, source?: string): Promise<ConversationImportResponse>;
 declare function getConversationThreads(arbi: ArbiClient, conversationId: string): Promise<{
     conversation_ext_id: string;
     threads: {
@@ -3655,15 +3679,17 @@ declare function deleteMessage(arbi: ArbiClient, messageId: string): Promise<{
     detail: string;
 }>;
 
+type conversations_ConversationImportResponse = ConversationImportResponse;
 declare const conversations_deleteConversation: typeof deleteConversation;
 declare const conversations_deleteMessage: typeof deleteMessage;
 declare const conversations_getConversationThreads: typeof getConversationThreads;
 declare const conversations_getMessage: typeof getMessage;
+declare const conversations_importConversations: typeof importConversations;
 declare const conversations_listConversations: typeof listConversations;
 declare const conversations_shareConversation: typeof shareConversation;
 declare const conversations_updateConversationTitle: typeof updateConversationTitle;
 declare namespace conversations {
-  export { conversations_deleteConversation as deleteConversation, conversations_deleteMessage as deleteMessage, conversations_getConversationThreads as getConversationThreads, conversations_getMessage as getMessage, conversations_listConversations as listConversations, conversations_shareConversation as shareConversation, conversations_updateConversationTitle as updateConversationTitle };
+  export { type conversations_ConversationImportResponse as ConversationImportResponse, conversations_deleteConversation as deleteConversation, conversations_deleteMessage as deleteMessage, conversations_getConversationThreads as getConversationThreads, conversations_getMessage as getMessage, conversations_importConversations as importConversations, conversations_listConversations as listConversations, conversations_shareConversation as shareConversation, conversations_updateConversationTitle as updateConversationTitle };
 }
 
 /**
@@ -4038,7 +4064,6 @@ declare function getConfig(arbi: ArbiClient, configId: string): Promise<{
         MEMORY_CREATION: boolean;
         GOALS_ENABLED: boolean;
         GOAL_MAX_OUTER_LOOPS: number;
-        REVIEW_ENABLED: boolean;
         PERSONA: string;
         AGENT_MODEL_NAME: string;
         AGENT_API_TYPE: "local" | "remote";
@@ -4396,4 +4421,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-CV7TVakj.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.
@@ -2692,7 +2705,6 @@ declare class Arbi {
                 MEMORY_CREATION: boolean;
                 GOALS_ENABLED: boolean;
                 GOAL_MAX_OUTER_LOOPS: number;
-                REVIEW_ENABLED: boolean;
                 PERSONA: string;
                 AGENT_MODEL_NAME: string;
                 AGENT_API_TYPE: "local" | "remote";
@@ -3355,9 +3367,11 @@ declare namespace tags {
 }
 
 /**
- * Conversation operations — list, threads, delete, share, title, messages.
+ * Conversation operations — list, threads, delete, share, title, messages, import.
  */
 
+type ConversationImportResponse = components['schemas']['ConversationImportResponse'];
+
 declare function listConversations(arbi: ArbiClient): Promise<{
     external_id: string;
     title: string | null;
@@ -3369,6 +3383,16 @@ declare function listConversations(arbi: ArbiClient): Promise<{
     message_count: number;
     last_message_status?: string | null | undefined;
 }[]>;
+/**
+ * Import a conversation export into the active workspace.
+ *
+ * Accepts a ChatGPT data export (`conversations.json`), an OpenClaw session log, or a
+ * Claude Code transcript (`.jsonl`); `source='auto'` lets the server detect the format.
+ * Uses raw multipart fetch (the typed client can't express file uploads), mirroring
+ * `files.uploadFile`. The active workspace + cipher are resolved server-side from the
+ * session, so no extra header is needed.
+ */
+declare function importConversations(auth: AuthHeaders, fileData: Blob, fileName: string, source?: string): Promise<ConversationImportResponse>;
 declare function getConversationThreads(arbi: ArbiClient, conversationId: string): Promise<{
     conversation_ext_id: string;
     threads: {
@@ -3655,15 +3679,17 @@ declare function deleteMessage(arbi: ArbiClient, messageId: string): Promise<{
     detail: string;
 }>;
 
+type conversations_ConversationImportResponse = ConversationImportResponse;
 declare const conversations_deleteConversation: typeof deleteConversation;
 declare const conversations_deleteMessage: typeof deleteMessage;
 declare const conversations_getConversationThreads: typeof getConversationThreads;
 declare const conversations_getMessage: typeof getMessage;
+declare const conversations_importConversations: typeof importConversations;
 declare const conversations_listConversations: typeof listConversations;
 declare const conversations_shareConversation: typeof shareConversation;
 declare const conversations_updateConversationTitle: typeof updateConversationTitle;
 declare namespace conversations {
-  export { conversations_deleteConversation as deleteConversation, conversations_deleteMessage as deleteMessage, conversations_getConversationThreads as getConversationThreads, conversations_getMessage as getMessage, conversations_listConversations as listConversations, conversations_shareConversation as shareConversation, conversations_updateConversationTitle as updateConversationTitle };
+  export { type conversations_ConversationImportResponse as ConversationImportResponse, conversations_deleteConversation as deleteConversation, conversations_deleteMessage as deleteMessage, conversations_getConversationThreads as getConversationThreads, conversations_getMessage as getMessage, conversations_importConversations as importConversations, conversations_listConversations as listConversations, conversations_shareConversation as shareConversation, conversations_updateConversationTitle as updateConversationTitle };
 }
 
 /**
@@ -4038,7 +4064,6 @@ declare function getConfig(arbi: ArbiClient, configId: string): Promise<{
         MEMORY_CREATION: boolean;
         GOALS_ENABLED: boolean;
         GOAL_MAX_OUTER_LOOPS: number;
-        REVIEW_ENABLED: boolean;
         PERSONA: string;
         AGENT_MODEL_NAME: string;
         AGENT_API_TYPE: "local" | "remote";
@@ -4396,4 +4421,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,65 @@ 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 "";
@@ -4655,6 +4694,7 @@ __export(conversations_exports, {
   deleteMessage: () => deleteMessage,
   getConversationThreads: () => getConversationThreads,
   getMessage: () => getMessage,
+  importConversations: () => importConversations,
   listConversations: () => listConversations,
   shareConversation: () => shareConversation,
   updateConversationTitle: () => updateConversationTitle
@@ -4662,6 +4702,17 @@ __export(conversations_exports, {
 async function listConversations(arbi) {
   return requireData(await arbi.fetch.GET("/v1/conversation/list"), "Failed to fetch conversations");
 }
+async function importConversations(auth, fileData, fileName, source = "auto") {
+  const formData = new FormData();
+  formData.append("file", fileData, fileName);
+  const res = await authenticatedFetch({
+    ...auth,
+    path: `/v1/conversation/import?source=${encodeURIComponent(source)}`,
+    method: "POST",
+    body: formData
+  });
+  return res.json();
+}
 async function getConversationThreads(arbi, conversationId) {
   return requireData(
     await arbi.fetch.GET("/v1/conversation/{conversation_ext_id}/threads", {