@arbidocs/sdk 0.3.13 → 0.3.14

package/dist/{browser-BszYf6lU.d.cts → browser-DtwXhEkG.d.cts}

@@ -77,6 +77,8 @@ interface CliConfig {
     selectedWorkspaceId?: string;
     autoUpdate?: boolean;
     notifications?: boolean;
+    verbose?: boolean;
+    watch?: boolean;
 }
 interface CliCredentials {
     email: string;
@@ -219,6 +221,7 @@ type UserMessageEvent = components['schemas']['UserMessageEvent'];
 type MessageMetadataPayload = components['schemas']['MessageMetadataPayload'];
 type ResponseUsage = components['schemas']['ResponseUsage'];
 type OutputTokensDetails = components['schemas']['OutputTokensDetails'];
+type TokenBudgetContext = components['schemas']['TokenBudgetContext'];
 /** Convenience type — what onStreamStart callbacks receive. */
 type SSEStreamStartData = {
     assistant_message_ext_id: string;
@@ -285,11 +288,15 @@ interface SSEStreamResult {
     text: string;
     assistantMessageExtId: string | null;
     agentSteps: string[];
+    /** Total number of tool calls across all agent steps. */
+    toolCallCount: number;
     errors: string[];
     userMessage: UserMessageEvent | null;
     metadata: MessageMetadataPayload | null;
     artifacts: ArtifactEvent[];
     usage: ResponseUsage | null;
+    /** Token budget context snapshot from response.completed. */
+    context: TokenBudgetContext | null;
 }
 /**
  * Stream SSE events from a Response, invoking callbacks as events arrive.
@@ -3180,4 +3187,44 @@ declare namespace health {
   export { health_getHealth as getHealth, health_getHealthModels as getHealthModels, health_getMcpTools as getMcpTools, health_getRemoteModels as getRemoteModels };
 }
 
-export { connectWithReconnect as $, type AuthHeaders as A, type SSEStreamCallbacks as B, type ConfigStore as C, type DocumentWaiter as D, type SSEStreamResult as E, type FormattedWsMessage as F, type SSEStreamStartData as G, type UserInfo as H, type UserInputRequestEvent as I, type UserMessageEvent as J, type WsConnection as K, LIFECYCLE_LABELS as L, type MessageLevel as M, agentconfig as N, type OutputTokensDetails as O, assistant as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, TOOL_LABELS as T, type UploadBatchResult as U, authenticatedFetch as V, type WorkspaceContext as W, buildRetrievalChunkTool as X, buildRetrievalFullContextTool as Y, buildRetrievalTocTool as Z, connectWebSocket as _, type CliConfig as a, consumeSSEStream as a0, contacts as a1, conversations as a2, createAuthenticatedClient as a3, createDocumentWaiter as a4, dm as a5, doctags as a6, documents as a7, files as a8, formatAgentStepLabel as a9, formatFileSize as aa, formatUserName as ab, formatWorkspaceChoices as ac, formatWsMessage as ad, generateEncryptedWorkspaceKey as ae, getErrorCode as af, getErrorMessage as ag, health as ah, parseSSEEvents as ai, performPasswordLogin as aj, requireData as ak, requireOk as al, resolveAuth as am, resolveWorkspace as an, selectWorkspace as ao, selectWorkspaceById as ap, settings as aq, streamSSE as ar, tags as as, workspaces as at, 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 ConnectOptions as n, type DocumentWaiterOptions as o, type MessageMetadataPayload as p, type ReconnectableWsConnection as q, type ResponseCompletedEvent as r, type ResponseContentPartAddedEvent as s, type ResponseCreatedEvent as t, type ResponseFailedEvent as u, type ResponseOutputItemAddedEvent as v, type ResponseOutputItemDoneEvent as w, type ResponseOutputTextDeltaEvent as x, type ResponseOutputTextDoneEvent as y, type ResponseUsage as z };
+/**
+ * Responses operations — background query submission and retrieval.
+ *
+ * submitBackgroundQuery: POST /v1/responses with background=true → 202 with task ID.
+ * getResponse: GET /v1/responses/{responseId} → current status + output.
+ * extractResponseText: Walk response output and join text content.
+ */
+
+type ResponsesAPIResponse = components['schemas']['ResponsesAPIResponse'];
+interface SubmitBackgroundQueryOptions extends AuthHeaders {
+    workspaceId: string;
+    question: string;
+    docIds: string[];
+    previousResponseId?: string | null;
+    model?: string;
+}
+/**
+ * Submit a query for background processing.
+ * Returns immediately with a response ID and "queued" status.
+ */
+declare function submitBackgroundQuery(options: SubmitBackgroundQueryOptions): Promise<ResponsesAPIResponse>;
+/**
+ * Fetch the current state of a response by ID.
+ * Returns progressive status, output, usage, and metadata.
+ */
+declare function getResponse(auth: AuthHeaders, responseId: string): Promise<ResponsesAPIResponse>;
+/**
+ * Walk response output messages and join all output_text content.
+ * Pure function, no I/O.
+ */
+declare function extractResponseText(response: ResponsesAPIResponse): string;
+
+type responses_SubmitBackgroundQueryOptions = SubmitBackgroundQueryOptions;
+declare const responses_extractResponseText: typeof extractResponseText;
+declare const responses_getResponse: typeof getResponse;
+declare const responses_submitBackgroundQuery: typeof submitBackgroundQuery;
+declare namespace responses {
+  export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
+}
+
+export { connectWithReconnect as $, type AuthHeaders as A, type SSEStreamCallbacks as B, type ConfigStore as C, type DocumentWaiter as D, type SSEStreamResult as E, type FormattedWsMessage as F, type SSEStreamStartData as G, type UserInfo as H, type UserInputRequestEvent as I, type UserMessageEvent as J, type WsConnection as K, LIFECYCLE_LABELS as L, type MessageLevel as M, agentconfig as N, type OutputTokensDetails as O, assistant as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, TOOL_LABELS as T, type UploadBatchResult as U, authenticatedFetch as V, type WorkspaceContext as W, buildRetrievalChunkTool as X, buildRetrievalFullContextTool as Y, buildRetrievalTocTool as Z, connectWebSocket as _, type CliConfig as a, consumeSSEStream as a0, contacts as a1, conversations as a2, createAuthenticatedClient as a3, createDocumentWaiter as a4, dm as a5, doctags as a6, documents as a7, files as a8, formatAgentStepLabel as a9, formatFileSize as aa, formatUserName as ab, formatWorkspaceChoices as ac, formatWsMessage as ad, generateEncryptedWorkspaceKey as ae, getErrorCode as af, getErrorMessage as ag, health as ah, parseSSEEvents as ai, performPasswordLogin as aj, requireData as ak, requireOk as al, resolveAuth as am, resolveWorkspace as an, responses as ao, selectWorkspace as ap, selectWorkspaceById as aq, settings as ar, streamSSE as as, tags as at, workspaces as au, 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 ConnectOptions as n, type DocumentWaiterOptions as o, type MessageMetadataPayload as p, type ReconnectableWsConnection as q, type ResponseCompletedEvent as r, type ResponseContentPartAddedEvent as s, type ResponseCreatedEvent as t, type ResponseFailedEvent as u, type ResponseOutputItemAddedEvent as v, type ResponseOutputItemDoneEvent as w, type ResponseOutputTextDeltaEvent as x, type ResponseOutputTextDoneEvent as y, type ResponseUsage as z };

package/dist/{browser-BszYf6lU.d.ts → browser-DtwXhEkG.d.ts}

@@ -77,6 +77,8 @@ interface CliConfig {
     selectedWorkspaceId?: string;
     autoUpdate?: boolean;
     notifications?: boolean;
+    verbose?: boolean;
+    watch?: boolean;
 }
 interface CliCredentials {
     email: string;
@@ -219,6 +221,7 @@ type UserMessageEvent = components['schemas']['UserMessageEvent'];
 type MessageMetadataPayload = components['schemas']['MessageMetadataPayload'];
 type ResponseUsage = components['schemas']['ResponseUsage'];
 type OutputTokensDetails = components['schemas']['OutputTokensDetails'];
+type TokenBudgetContext = components['schemas']['TokenBudgetContext'];
 /** Convenience type — what onStreamStart callbacks receive. */
 type SSEStreamStartData = {
     assistant_message_ext_id: string;
@@ -285,11 +288,15 @@ interface SSEStreamResult {
     text: string;
     assistantMessageExtId: string | null;
     agentSteps: string[];
+    /** Total number of tool calls across all agent steps. */
+    toolCallCount: number;
     errors: string[];
     userMessage: UserMessageEvent | null;
     metadata: MessageMetadataPayload | null;
     artifacts: ArtifactEvent[];
     usage: ResponseUsage | null;
+    /** Token budget context snapshot from response.completed. */
+    context: TokenBudgetContext | null;
 }
 /**
  * Stream SSE events from a Response, invoking callbacks as events arrive.
@@ -3180,4 +3187,44 @@ declare namespace health {
   export { health_getHealth as getHealth, health_getHealthModels as getHealthModels, health_getMcpTools as getMcpTools, health_getRemoteModels as getRemoteModels };
 }
 
-export { connectWithReconnect as $, type AuthHeaders as A, type SSEStreamCallbacks as B, type ConfigStore as C, type DocumentWaiter as D, type SSEStreamResult as E, type FormattedWsMessage as F, type SSEStreamStartData as G, type UserInfo as H, type UserInputRequestEvent as I, type UserMessageEvent as J, type WsConnection as K, LIFECYCLE_LABELS as L, type MessageLevel as M, agentconfig as N, type OutputTokensDetails as O, assistant as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, TOOL_LABELS as T, type UploadBatchResult as U, authenticatedFetch as V, type WorkspaceContext as W, buildRetrievalChunkTool as X, buildRetrievalFullContextTool as Y, buildRetrievalTocTool as Z, connectWebSocket as _, type CliConfig as a, consumeSSEStream as a0, contacts as a1, conversations as a2, createAuthenticatedClient as a3, createDocumentWaiter as a4, dm as a5, doctags as a6, documents as a7, files as a8, formatAgentStepLabel as a9, formatFileSize as aa, formatUserName as ab, formatWorkspaceChoices as ac, formatWsMessage as ad, generateEncryptedWorkspaceKey as ae, getErrorCode as af, getErrorMessage as ag, health as ah, parseSSEEvents as ai, performPasswordLogin as aj, requireData as ak, requireOk as al, resolveAuth as am, resolveWorkspace as an, selectWorkspace as ao, selectWorkspaceById as ap, settings as aq, streamSSE as ar, tags as as, workspaces as at, 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 ConnectOptions as n, type DocumentWaiterOptions as o, type MessageMetadataPayload as p, type ReconnectableWsConnection as q, type ResponseCompletedEvent as r, type ResponseContentPartAddedEvent as s, type ResponseCreatedEvent as t, type ResponseFailedEvent as u, type ResponseOutputItemAddedEvent as v, type ResponseOutputItemDoneEvent as w, type ResponseOutputTextDeltaEvent as x, type ResponseOutputTextDoneEvent as y, type ResponseUsage as z };
+/**
+ * Responses operations — background query submission and retrieval.
+ *
+ * submitBackgroundQuery: POST /v1/responses with background=true → 202 with task ID.
+ * getResponse: GET /v1/responses/{responseId} → current status + output.
+ * extractResponseText: Walk response output and join text content.
+ */
+
+type ResponsesAPIResponse = components['schemas']['ResponsesAPIResponse'];
+interface SubmitBackgroundQueryOptions extends AuthHeaders {
+    workspaceId: string;
+    question: string;
+    docIds: string[];
+    previousResponseId?: string | null;
+    model?: string;
+}
+/**
+ * Submit a query for background processing.
+ * Returns immediately with a response ID and "queued" status.
+ */
+declare function submitBackgroundQuery(options: SubmitBackgroundQueryOptions): Promise<ResponsesAPIResponse>;
+/**
+ * Fetch the current state of a response by ID.
+ * Returns progressive status, output, usage, and metadata.
+ */
+declare function getResponse(auth: AuthHeaders, responseId: string): Promise<ResponsesAPIResponse>;
+/**
+ * Walk response output messages and join all output_text content.
+ * Pure function, no I/O.
+ */
+declare function extractResponseText(response: ResponsesAPIResponse): string;
+
+type responses_SubmitBackgroundQueryOptions = SubmitBackgroundQueryOptions;
+declare const responses_extractResponseText: typeof extractResponseText;
+declare const responses_getResponse: typeof getResponse;
+declare const responses_submitBackgroundQuery: typeof submitBackgroundQuery;
+declare namespace responses {
+  export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
+}
+
+export { connectWithReconnect as $, type AuthHeaders as A, type SSEStreamCallbacks as B, type ConfigStore as C, type DocumentWaiter as D, type SSEStreamResult as E, type FormattedWsMessage as F, type SSEStreamStartData as G, type UserInfo as H, type UserInputRequestEvent as I, type UserMessageEvent as J, type WsConnection as K, LIFECYCLE_LABELS as L, type MessageLevel as M, agentconfig as N, type OutputTokensDetails as O, assistant as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, TOOL_LABELS as T, type UploadBatchResult as U, authenticatedFetch as V, type WorkspaceContext as W, buildRetrievalChunkTool as X, buildRetrievalFullContextTool as Y, buildRetrievalTocTool as Z, connectWebSocket as _, type CliConfig as a, consumeSSEStream as a0, contacts as a1, conversations as a2, createAuthenticatedClient as a3, createDocumentWaiter as a4, dm as a5, doctags as a6, documents as a7, files as a8, formatAgentStepLabel as a9, formatFileSize as aa, formatUserName as ab, formatWorkspaceChoices as ac, formatWsMessage as ad, generateEncryptedWorkspaceKey as ae, getErrorCode as af, getErrorMessage as ag, health as ah, parseSSEEvents as ai, performPasswordLogin as aj, requireData as ak, requireOk as al, resolveAuth as am, resolveWorkspace as an, responses as ao, selectWorkspace as ap, selectWorkspaceById as aq, settings as ar, streamSSE as as, tags as at, workspaces as au, 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 ConnectOptions as n, type DocumentWaiterOptions as o, type MessageMetadataPayload as p, type ReconnectableWsConnection as q, type ResponseCompletedEvent as r, type ResponseContentPartAddedEvent as s, type ResponseCreatedEvent as t, type ResponseFailedEvent as u, type ResponseOutputItemAddedEvent as v, type ResponseOutputItemDoneEvent as w, type ResponseOutputTextDeltaEvent as x, type ResponseOutputTextDoneEvent as y, type ResponseUsage as z };

package/dist/browser.cjs

@@ -326,11 +326,13 @@ async function streamSSE(response, callbacks = {}) {
   let text = "";
   let assistantMessageExtId = null;
   const agentSteps = [];
+  let toolCallCount = 0;
   const errors = [];
   const artifacts = [];
   let userMessage = null;
   let metadata = null;
   let usage = null;
+  let context = null;
   const eventHandlers = {
     // OpenAI Responses API events (dot-separated names from server)
     "response.created": (raw) => {
@@ -374,6 +376,9 @@ async function streamSSE(response, callbacks = {}) {
         metadata = meta;
         callbacks.onMetadata?.(meta);
       }
+      if (data.context) {
+        context = data.context;
+      }
       if (data.t != null) callbacks.onElapsedTime?.(data.t);
       callbacks.onComplete?.();
     },
@@ -388,6 +393,10 @@ async function streamSSE(response, callbacks = {}) {
       const data = JSON.parse(raw);
       const label = formatAgentStepLabel(data);
       if (label) agentSteps.push(label);
+      const detail = data.detail;
+      if (detail && Array.isArray(detail)) {
+        toolCallCount += detail.filter((d) => d.tool).length;
+      }
       callbacks.onAgentStep?.(data);
       if (data.t != null) callbacks.onElapsedTime?.(data.t);
     },
@@ -438,11 +447,13 @@ async function streamSSE(response, callbacks = {}) {
     text,
     assistantMessageExtId,
     agentSteps,
+    toolCallCount,
     errors,
     userMessage,
     metadata,
     artifacts,
-    usage
+    usage,
+    context
   };
 }
 var consumeSSEStream = streamSSE;
@@ -1481,6 +1492,69 @@ var Arbi = class {
   }
 };
 
+// src/operations/responses.ts
+var responses_exports = {};
+__export(responses_exports, {
+  extractResponseText: () => extractResponseText,
+  getResponse: () => getResponse,
+  submitBackgroundQuery: () => submitBackgroundQuery
+});
+async function submitBackgroundQuery(options) {
+  const { workspaceId, question, docIds, previousResponseId, model, ...auth } = options;
+  const tools = {};
+  if (docIds.length > 0) {
+    tools.retrieval_chunk = {
+      name: "retrieval_chunk",
+      description: "retrieval chunk",
+      tool_args: { doc_ext_ids: docIds },
+      tool_responses: {}
+    };
+    tools.retrieval_full_context = {
+      name: "retrieval_full_context",
+      description: "retrieval full context",
+      tool_args: { doc_ext_ids: [] },
+      tool_responses: {}
+    };
+  }
+  const body = {
+    input: question,
+    workspace_ext_id: workspaceId,
+    stream: false,
+    background: true,
+    store: true,
+    tools,
+    ...previousResponseId ? { previous_response_id: previousResponseId } : {},
+    ...model ? { model } : {}
+  };
+  const res = await authenticatedFetch({
+    ...auth,
+    path: "/v1/responses",
+    method: "POST",
+    body: JSON.stringify(body),
+    headers: { "Content-Type": "application/json" }
+  });
+  return await res.json();
+}
+async function getResponse(auth, responseId) {
+  const res = await authenticatedFetch({
+    ...auth,
+    path: `/v1/responses/${responseId}`,
+    method: "GET"
+  });
+  return await res.json();
+}
+function extractResponseText(response) {
+  const parts = [];
+  for (const msg of response.output) {
+    for (const item of msg.content) {
+      if ("type" in item && item.type === "output_text" && "text" in item) {
+        parts.push(item.text);
+      }
+    }
+  }
+  return parts.join("");
+}
+
 exports.Arbi = Arbi;
 exports.ArbiApiError = ArbiApiError;
 exports.ArbiError = ArbiError;
@@ -1514,6 +1588,7 @@ exports.requireData = requireData;
 exports.requireOk = requireOk;
 exports.resolveAuth = resolveAuth;
 exports.resolveWorkspace = resolveWorkspace;
+exports.responses = responses_exports;
 exports.selectWorkspace = selectWorkspace;
 exports.selectWorkspaceById = selectWorkspaceById;
 exports.settings = settings_exports;