@arbidocs/sdk 0.3.17 → 0.3.19

package/dist/{browser-BtAHbiq_.d.cts → browser-D8aF-wkt.d.cts}

@@ -92,6 +92,8 @@ interface CliCredentials {
     workspaceId?: string;
     /** ISO timestamp when the token was cached */
     tokenTimestamp?: string;
+    /** Auth0 SSO token — needed for session recovery of SSO users */
+    ssoToken?: string;
 }
 interface ChatSession {
     /** Last assistant message ID — used as previous_response_id for follow-ups */
@@ -173,6 +175,17 @@ declare function createAuthenticatedClient(config: CliConfig, creds: CliCredenti
  * use createAuthenticatedClient() instead.
  */
 declare function performPasswordLogin(config: CliConfig, email: string, password: string, store: ConfigStore): Promise<AuthContext>;
+/**
+ * SSO device-flow login (RFC 8628).
+ *
+ * Fetches SSO config from the deployment, initiates the device authorization
+ * flow with Auth0, waits for the user to authorize in a browser, then logs
+ * in to the ARBI deployment using the Auth0 JWT.
+ */
+declare function performSsoDeviceFlowLogin(config: CliConfig, email: string, password: string, store: ConfigStore, callbacks?: {
+    onUserCode?: (userCode: string, verificationUri: string) => void;
+    onPoll?: (elapsedMs: number) => void;
+}): Promise<AuthContext>;
 /**
  * Decrypt wrapped workspace key and set it as the active workspace header.
  */
@@ -242,17 +255,19 @@ interface SSEEvent {
     event: string;
     data: string;
 }
-declare const TOOL_LABELS: Record<string, string>;
-declare const LIFECYCLE_LABELS: 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.
+ *
  * Priority:
  * 1. `focus` — the agent's descriptive sentence about what it's doing
- * 2. For `tool_progress` — tool-specific label + optional message
- * 3. Lifecycle label (planning, evaluation, etc.)
- * 4. Tool name from detail
- * 5. Fallback to step name or empty string
+ * 2. `label` — backend-provided display label
+ * 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
  */
 declare function formatAgentStepLabel(step: AgentStepEvent): string;
 /**
@@ -3306,4 +3321,4 @@ declare namespace responses {
   export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
 }
 
-export { buildRetrievalFullContextTool as $, type AuthHeaders as A, type ResponseOutputTextDeltaEvent as B, type ConfigStore as C, type DocumentWaiter as D, type ResponseOutputTextDoneEvent as E, type FormattedWsMessage as F, type ResponseUsage as G, type SSEStreamCallbacks as H, type SSEStreamResult as I, type SSEStreamStartData as J, type UserInfo as K, LIFECYCLE_LABELS as L, type MessageLevel as M, type UserInputRequestEvent as N, type OutputTokensDetails as O, type UserMessageEvent as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, TOOL_LABELS as T, type UploadBatchResult as U, type WsConnection as V, type WorkspaceContext as W, agentconfig as X, assistant as Y, authenticatedFetch as Z, buildRetrievalChunkTool as _, type CliConfig as a, buildRetrievalTocTool as a0, connectWebSocket as a1, connectWithReconnect as a2, consumeSSEStream as a3, contacts as a4, conversations as a5, countCitations as a6, createAuthenticatedClient as a7, createDocumentWaiter as a8, dm as a9, summarizeCitations as aA, tags as aB, workspaces as aC, doctags as aa, documents as ab, files as ac, formatAgentStepLabel as ad, formatFileSize as ae, formatStreamSummary as af, formatUserName as ag, formatWorkspaceChoices as ah, formatWsMessage as ai, generateEncryptedWorkspaceKey as aj, getErrorCode as ak, getErrorMessage as al, health as am, parseSSEEvents as an, performPasswordLogin as ao, requireData as ap, requireOk as aq, resolveAuth as ar, resolveCitations as as, resolveWorkspace as at, responses as au, selectWorkspace as av, selectWorkspaceById as aw, settings as ax, streamSSE as ay, stripCitationMarkdown as az, type CliCredentials as b, type ChatSession as c, type UploadOptions as d, type UploadResult as e, type AgentStepEvent as f, Arbi as g, ArbiApiError as h, ArbiError as i, type ArbiOptions as j, type ArtifactEvent as k, type AuthContext as l, type AuthenticatedClient as m, type CitationSummary as n, type ConnectOptions as o, type DocumentWaiterOptions as p, type MessageMetadataPayload$1 as q, type MessageQueuedEvent as r, type ReconnectableWsConnection as s, type ResolvedCitation as t, type ResponseCompletedEvent as u, type ResponseContentPartAddedEvent as v, type ResponseCreatedEvent as w, type ResponseFailedEvent as x, type ResponseOutputItemAddedEvent as y, type ResponseOutputItemDoneEvent as z };
+export { connectWebSocket as $, type AuthHeaders as A, type ResponseOutputTextDeltaEvent as B, type ConfigStore as C, type DocumentWaiter as D, type ResponseOutputTextDoneEvent as E, type FormattedWsMessage as F, type ResponseUsage as G, type SSEStreamCallbacks as H, type SSEStreamResult as I, type SSEStreamStartData as J, type UserInfo as K, type UserInputRequestEvent as L, type MessageLevel as M, type UserMessageEvent as N, type OutputTokensDetails as O, type WsConnection as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, agentconfig as T, type UploadBatchResult as U, assistant as V, type WorkspaceContext as W, authenticatedFetch as X, buildRetrievalChunkTool as Y, buildRetrievalFullContextTool as Z, buildRetrievalTocTool as _, type CliConfig as a, connectWithReconnect as a0, consumeSSEStream as a1, contacts as a2, conversations as a3, countCitations as a4, createAuthenticatedClient as a5, createDocumentWaiter as a6, dm as a7, doctags as a8, documents as a9, tags as aA, workspaces as aB, files as aa, formatAgentStepLabel as ab, formatFileSize as ac, formatStreamSummary as ad, formatUserName as ae, formatWorkspaceChoices as af, formatWsMessage as ag, generateEncryptedWorkspaceKey as ah, getErrorCode as ai, getErrorMessage as aj, health as ak, parseSSEEvents as al, performPasswordLogin as am, performSsoDeviceFlowLogin as an, requireData as ao, requireOk as ap, resolveAuth as aq, resolveCitations as ar, resolveWorkspace as as, responses as at, selectWorkspace as au, selectWorkspaceById as av, settings as aw, streamSSE as ax, stripCitationMarkdown as ay, summarizeCitations as az, type CliCredentials as b, type ChatSession as c, type UploadOptions as d, type UploadResult as e, type AgentStepEvent as f, Arbi as g, ArbiApiError as h, ArbiError as i, type ArbiOptions as j, type ArtifactEvent as k, type AuthContext as l, type AuthenticatedClient as m, type CitationSummary as n, type ConnectOptions as o, type DocumentWaiterOptions as p, type MessageMetadataPayload$1 as q, type MessageQueuedEvent as r, type ReconnectableWsConnection as s, type ResolvedCitation as t, type ResponseCompletedEvent as u, type ResponseContentPartAddedEvent as v, type ResponseCreatedEvent as w, type ResponseFailedEvent as x, type ResponseOutputItemAddedEvent as y, type ResponseOutputItemDoneEvent as z };

package/dist/{browser-BtAHbiq_.d.ts → browser-D8aF-wkt.d.ts}

@@ -92,6 +92,8 @@ interface CliCredentials {
     workspaceId?: string;
     /** ISO timestamp when the token was cached */
     tokenTimestamp?: string;
+    /** Auth0 SSO token — needed for session recovery of SSO users */
+    ssoToken?: string;
 }
 interface ChatSession {
     /** Last assistant message ID — used as previous_response_id for follow-ups */
@@ -173,6 +175,17 @@ declare function createAuthenticatedClient(config: CliConfig, creds: CliCredenti
  * use createAuthenticatedClient() instead.
  */
 declare function performPasswordLogin(config: CliConfig, email: string, password: string, store: ConfigStore): Promise<AuthContext>;
+/**
+ * SSO device-flow login (RFC 8628).
+ *
+ * Fetches SSO config from the deployment, initiates the device authorization
+ * flow with Auth0, waits for the user to authorize in a browser, then logs
+ * in to the ARBI deployment using the Auth0 JWT.
+ */
+declare function performSsoDeviceFlowLogin(config: CliConfig, email: string, password: string, store: ConfigStore, callbacks?: {
+    onUserCode?: (userCode: string, verificationUri: string) => void;
+    onPoll?: (elapsedMs: number) => void;
+}): Promise<AuthContext>;
 /**
  * Decrypt wrapped workspace key and set it as the active workspace header.
  */
@@ -242,17 +255,19 @@ interface SSEEvent {
     event: string;
     data: string;
 }
-declare const TOOL_LABELS: Record<string, string>;
-declare const LIFECYCLE_LABELS: 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.
+ *
  * Priority:
  * 1. `focus` — the agent's descriptive sentence about what it's doing
- * 2. For `tool_progress` — tool-specific label + optional message
- * 3. Lifecycle label (planning, evaluation, etc.)
- * 4. Tool name from detail
- * 5. Fallback to step name or empty string
+ * 2. `label` — backend-provided display label
+ * 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
  */
 declare function formatAgentStepLabel(step: AgentStepEvent): string;
 /**
@@ -3306,4 +3321,4 @@ declare namespace responses {
   export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
 }
 
-export { buildRetrievalFullContextTool as $, type AuthHeaders as A, type ResponseOutputTextDeltaEvent as B, type ConfigStore as C, type DocumentWaiter as D, type ResponseOutputTextDoneEvent as E, type FormattedWsMessage as F, type ResponseUsage as G, type SSEStreamCallbacks as H, type SSEStreamResult as I, type SSEStreamStartData as J, type UserInfo as K, LIFECYCLE_LABELS as L, type MessageLevel as M, type UserInputRequestEvent as N, type OutputTokensDetails as O, type UserMessageEvent as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, TOOL_LABELS as T, type UploadBatchResult as U, type WsConnection as V, type WorkspaceContext as W, agentconfig as X, assistant as Y, authenticatedFetch as Z, buildRetrievalChunkTool as _, type CliConfig as a, buildRetrievalTocTool as a0, connectWebSocket as a1, connectWithReconnect as a2, consumeSSEStream as a3, contacts as a4, conversations as a5, countCitations as a6, createAuthenticatedClient as a7, createDocumentWaiter as a8, dm as a9, summarizeCitations as aA, tags as aB, workspaces as aC, doctags as aa, documents as ab, files as ac, formatAgentStepLabel as ad, formatFileSize as ae, formatStreamSummary as af, formatUserName as ag, formatWorkspaceChoices as ah, formatWsMessage as ai, generateEncryptedWorkspaceKey as aj, getErrorCode as ak, getErrorMessage as al, health as am, parseSSEEvents as an, performPasswordLogin as ao, requireData as ap, requireOk as aq, resolveAuth as ar, resolveCitations as as, resolveWorkspace as at, responses as au, selectWorkspace as av, selectWorkspaceById as aw, settings as ax, streamSSE as ay, stripCitationMarkdown as az, type CliCredentials as b, type ChatSession as c, type UploadOptions as d, type UploadResult as e, type AgentStepEvent as f, Arbi as g, ArbiApiError as h, ArbiError as i, type ArbiOptions as j, type ArtifactEvent as k, type AuthContext as l, type AuthenticatedClient as m, type CitationSummary as n, type ConnectOptions as o, type DocumentWaiterOptions as p, type MessageMetadataPayload$1 as q, type MessageQueuedEvent as r, type ReconnectableWsConnection as s, type ResolvedCitation as t, type ResponseCompletedEvent as u, type ResponseContentPartAddedEvent as v, type ResponseCreatedEvent as w, type ResponseFailedEvent as x, type ResponseOutputItemAddedEvent as y, type ResponseOutputItemDoneEvent as z };
+export { connectWebSocket as $, type AuthHeaders as A, type ResponseOutputTextDeltaEvent as B, type ConfigStore as C, type DocumentWaiter as D, type ResponseOutputTextDoneEvent as E, type FormattedWsMessage as F, type ResponseUsage as G, type SSEStreamCallbacks as H, type SSEStreamResult as I, type SSEStreamStartData as J, type UserInfo as K, type UserInputRequestEvent as L, type MessageLevel as M, type UserMessageEvent as N, type OutputTokensDetails as O, type WsConnection as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, agentconfig as T, type UploadBatchResult as U, assistant as V, type WorkspaceContext as W, authenticatedFetch as X, buildRetrievalChunkTool as Y, buildRetrievalFullContextTool as Z, buildRetrievalTocTool as _, type CliConfig as a, connectWithReconnect as a0, consumeSSEStream as a1, contacts as a2, conversations as a3, countCitations as a4, createAuthenticatedClient as a5, createDocumentWaiter as a6, dm as a7, doctags as a8, documents as a9, tags as aA, workspaces as aB, files as aa, formatAgentStepLabel as ab, formatFileSize as ac, formatStreamSummary as ad, formatUserName as ae, formatWorkspaceChoices as af, formatWsMessage as ag, generateEncryptedWorkspaceKey as ah, getErrorCode as ai, getErrorMessage as aj, health as ak, parseSSEEvents as al, performPasswordLogin as am, performSsoDeviceFlowLogin as an, requireData as ao, requireOk as ap, resolveAuth as aq, resolveCitations as ar, resolveWorkspace as as, responses as at, selectWorkspace as au, selectWorkspaceById as av, settings as aw, streamSSE as ax, stripCitationMarkdown as ay, summarizeCitations as az, type CliCredentials as b, type ChatSession as c, type UploadOptions as d, type UploadResult as e, type AgentStepEvent as f, Arbi as g, ArbiApiError as h, ArbiError as i, type ArbiOptions as j, type ArtifactEvent as k, type AuthContext as l, type AuthenticatedClient as m, type CitationSummary as n, type ConnectOptions as o, type DocumentWaiterOptions as p, type MessageMetadataPayload$1 as q, type MessageQueuedEvent as r, type ReconnectableWsConnection as s, type ResolvedCitation as t, type ResponseCompletedEvent as u, type ResponseContentPartAddedEvent as v, type ResponseCreatedEvent as w, type ResponseFailedEvent as x, type ResponseOutputItemAddedEvent as y, type ResponseOutputItemDoneEvent as z };

package/dist/browser.cjs

@@ -98,6 +98,8 @@ async function authenticatedFetch(options) {
   }
   return res;
 }
+
+// src/auth.ts
 function formatWorkspaceChoices(wsList) {
   return wsList.map((ws) => {
     const totalDocs = ws.shared_document_count + ws.private_document_count;
@@ -118,7 +120,8 @@ async function createAuthenticatedClient(config, creds, store) {
   const signingPrivateKey = client.base64ToBytes(creds.signingPrivateKeyBase64);
   const loginResult = await arbi.auth.loginWithKey({
     email: creds.email,
-    signingPrivateKey
+    signingPrivateKey,
+    ssoToken: creds.ssoToken
   });
   store.saveCredentials({
     ...creds,
@@ -259,23 +262,7 @@ async function resolveWorkspace(store, workspaceOpt) {
 }
 
 // src/sse.ts
-var TOOL_LABELS = {
-  search_documents: "Searching documents",
-  get_document_passages: "Reading document",
-  get_table_of_contents: "Getting table of contents",
-  view_document_pages: "Viewing document pages",
-  get_full_document: "Reading full document",
-  web_search: "Searching the web",
-  read_url: "Reading web pages",
-  ask_user: "Asking user",
-  compaction: "Compacting conversation",
-  personal_agent: "Running agent",
-  create_artifact: "Creating artifact",
-  create_plan: "Creating plan",
-  save_skill: "Saving skill",
-  run_code: "Running code"
-};
-var LIFECYCLE_LABELS = {
+var LIFECYCLE_LABELS_FALLBACK = {
   evaluation: "Evaluating results",
   answering: "Writing answer",
   reviewing: "Reviewing answer",
@@ -284,18 +271,19 @@ var LIFECYCLE_LABELS = {
 };
 function formatAgentStepLabel(step) {
   if (step.focus) return step.focus;
+  if (step.label) return step.label;
   const detail = step.detail;
   if (step.step === "tool_progress" && detail && detail.length > 0) {
-    const toolName = detail[0].tool;
-    const label = toolName && TOOL_LABELS[toolName] || LIFECYCLE_LABELS.tool_progress;
+    const label = detail[0].label || LIFECYCLE_LABELS_FALLBACK.tool_progress;
     const message = detail[0].message;
     return message ? `${label}: ${message}` : label;
   }
   if (step.step) {
-    return LIFECYCLE_LABELS[step.step] || step.step;
+    return LIFECYCLE_LABELS_FALLBACK[step.step] || step.step;
   }
-  if (detail && detail.length > 0 && detail[0].tool) {
-    return TOOL_LABELS[detail[0].tool] || detail[0].tool;
+  if (detail && detail.length > 0) {
+    if (detail[0].label) return detail[0].label;
+    if (detail[0].tool) return detail[0].tool;
   }
   return "";
 }
@@ -1639,8 +1627,6 @@ function extractResponseText(response) {
 exports.Arbi = Arbi;
 exports.ArbiApiError = ArbiApiError;
 exports.ArbiError = ArbiError;
-exports.LIFECYCLE_LABELS = LIFECYCLE_LABELS;
-exports.TOOL_LABELS = TOOL_LABELS;
 exports.agentconfig = agentconfig_exports;
 exports.assistant = assistant_exports;
 exports.authenticatedFetch = authenticatedFetch;