@arbidocs/sdk 0.3.65 → 0.3.67

package/dist/{browser-D2dkZnc9.d.cts → browser-B5xRfc7b.d.cts}

@@ -84,16 +84,40 @@ interface CliConfig {
 }
 interface CliCredentials {
     email: string;
+    /** User's external ID (``usr-*`` or ``agt-*``). Needed by features
+     *  that key on user identity (DM crypto, contact resolution, etc.).
+     *  Set on every login from the API's response; required by
+     *  ``buildAuthFromCache`` to restore the session client-side
+     *  without a server round-trip. */
+    userExtId?: string;
     signingPrivateKeyBase64: string;
     serverSessionKeyBase64: string;
-    /** Cached access token from last successful resolveWorkspace() */
+    /** Cached access token for the live server session. Valid as long as
+     *  ``tokenTimestamp`` is within ``TOKEN_MAX_AGE_MS``. */
     accessToken?: string;
-    /** Cached session-sealed workspace key from last successful resolveWorkspace() */
-    sealedWorkspaceKey?: string;
-    /** Workspace ID the cached token was issued for */
-    workspaceId?: string;
-    /** ISO timestamp when the token was cached */
+    /** ISO timestamp when ``accessToken`` was issued. Used for client-side
+     *  TTL — the server enforces JWT exp independently. */
     tokenTimestamp?: string;
+    /**
+     * Workspaces whose keys are already deposited on the current server
+     * session — i.e. the keys of ``session.workspaces`` in the backend's
+     * Redis entry. Client-side mirror so we can skip a redundant `/open`
+     * round-trip when we've already deposited a workspace's key during
+     * this session's lifetime.
+     *
+     * Both grant types end up in this set:
+     *  - **Permanent** — first `/open` for the workspace POSTs the
+     *    wrapped_key and the server adds it to ``session.workspaces``.
+     *  - **Session-only** (PA agents, temporary shares) — the backend
+     *    pre-deposits via ``store_workspace_key_for_session_pubkey``,
+     *    then the client's `/open` is just a metadata fetch.
+     *
+     * Cleared on every event that invalidates the session: fresh login,
+     * auto-relogin on 401, logout. The new session starts with an empty
+     * ``session.workspaces`` server-side, so this client mirror must
+     * start empty too.
+     */
+    openedWorkspaces?: string[];
     /** Auth0 SSO token — needed for session recovery of SSO users */
     ssoToken?: string;
     /** Parent user ext_id — set for persistent agent accounts */
@@ -152,7 +176,6 @@ interface AuthContext {
 interface WorkspaceContext extends AuthContext {
     workspaceId: string;
     accessToken: string;
-    sealedWorkspaceKey: string;
 }
 /** Minimal workspace shape required by formatWorkspaceChoices. */
 interface WorkspaceForChoice {
@@ -232,23 +255,40 @@ declare function generateNewWorkspaceKey(arbi: ArbiClient, serverSessionKey: Uin
  * never log, persist, or transmit it over the wire.
  */
 declare function getRawWorkspaceKey(arbi: ArbiClient, workspaceId: string, signingPrivateKeyBase64: string): Promise<Uint8Array>;
-/**
- * Find a workspace by ID in the user's workspace list, select it, and return workspace info.
- */
 declare function selectWorkspaceById(arbi: ArbiClient, workspaceId: string, serverSessionKey: Uint8Array, signingPrivateKeyBase64: string): Promise<{
     external_id: string;
     name: string;
-    wrapped_key: string;
+    wrapped_key: string | null;
+    /** The session-sealed workspace key — `null` for session-only grants */
+    sealed_key: string | null;
 }>;
 /**
  * Authenticate and return the SDK client + config.
- * Throws ArbiError instead of calling process.exit.
+ *
+ * Fast path: reuse the live server session via cached accessToken.
+ * Slow path: fresh ``loginWithKey`` (mints a new session, clears
+ * ``openedWorkspaces``).
  */
 declare function resolveAuth(store: ConfigStore): Promise<AuthContext>;
 /**
- * Authenticate, resolve workspace, and set up headers.
- * Uses cached JWT when available for the same workspace and not expired.
- * Throws ArbiError instead of calling process.exit.
+ * Authenticate, ensure the workspace's key is deposited on the current
+ * server session, and return everything callers need.
+ *
+ * Decisions are independent:
+ *  1. **Session aliveness** — reuse the live session if its accessToken
+ *     is within TTL; otherwise fresh login. (Fresh login = new session
+ *     = ``openedWorkspaces`` reset to ``[]``.)
+ *  2. **Workspace deposit** — if ``workspaceId`` already appears in
+ *     ``creds.openedWorkspaces``, the server's session already holds
+ *     its key; no ``/open`` needed. Otherwise call ``/open`` once and
+ *     append to the set.
+ *
+ * Splitting these matters: previously the cache was gated on
+ * ``creds.workspaceId === workspaceId``, so any switch between
+ * workspaces forced a re-login. That orphaned PA-agent session
+ * deposits and broke ``arbi docs`` for them. Now switching workspaces
+ * within a live session just adds another entry to
+ * ``openedWorkspaces`` — no re-login, no orphaned deposits.
  */
 declare function resolveWorkspace(store: ConfigStore, workspaceOpt?: string): Promise<WorkspaceContext>;
 
@@ -540,6 +580,7 @@ declare function formatUserName(user: UserInfo | null | undefined): string;
 type MessageMetadataPayload = components['schemas']['MessageMetadataPayload'];
 type CitationData$2 = components['schemas']['CitationData'];
 type Chunk$1 = components['schemas']['Chunk'];
+
 /** A fully resolved citation with its source chunks. */
 interface ResolvedCitation {
     /** Citation number as a string (e.g. "1", "2") */
@@ -681,6 +722,11 @@ declare function sanitizeFolderPath(folderPath: string): string;
 interface UploadOptions {
     folder?: string;
     configExtId?: string;
+    /** Work-product type for the uploaded doc — ``source`` (default),
+     *  ``skill``, ``memory``, ``artifact``. Skills must be uploaded with
+     *  ``wp_type='skill'`` AND in a ``skills/<slug>`` folder so the
+     *  backend's ``SkillManager`` recognises them. */
+    wpType?: 'source' | 'skill' | 'memory' | 'artifact' | 'webpage';
 }
 interface SkippedFile {
     file_name: string;
@@ -1131,20 +1177,100 @@ declare function queryAssistant(options: AssistantQueryOptions): Promise<Respons
  * The assistant_message_ext_id identifies which agent message to answer.
  */
 declare function respondToAgent(arbi: ArbiClient, assistantMessageExtId: string, answer: string): Promise<unknown>;
+/** A single user-invocable skill as exposed by ``GET /v1/assistant/skills``.
+ *  Re-exported with the schema-generated shape so callers don't have to
+ *  reach into ``components['schemas']`` themselves. */
+type SkillSummary = components['schemas']['SkillSummaryResponse'];
+/**
+ * List the skills the caller can invoke in the active workspace.
+ *
+ * Powers slash-command autocomplete in the TUI, CLI, and React UI.
+ * Returns lightweight metadata only (name, description, args hint) —
+ * never the SKILL.md body. To read the body, fetch the document via
+ * ``getParsedContent(authHeaders, doc_ext_id, 'content')``.
+ *
+ * Scoped to the workspace the caller has open (the backend uses the
+ * session's ``active_workspace``); cross-workspace listing isn't
+ * supported because each workspace has its own encryption key.
+ *
+ * @param includeHidden  When ``true``, returns skills with
+ *   ``user-invocable: false`` in their frontmatter. Off by default —
+ *   those are typically agent-only or in-progress skills that
+ *   shouldn't surface in slash menus.
+ */
+declare function listSkills(arbi: ArbiClient, options?: {
+    includeHidden?: boolean;
+}): Promise<SkillSummary[]>;
+/** Parsed slash-command shape, regardless of frontend. */
+interface ParsedSlashCommand {
+    /** The lowercased token immediately after ``/``. */
+    slug: string;
+    /** Everything after the first whitespace, untrimmed. ``""`` when the
+     *  user hasn't typed any arguments yet. */
+    args: string;
+}
+/**
+ * Parse a *submitted* slash command (or anything that walks like one).
+ *
+ * Permissive about whitespace: leading whitespace is tolerated so
+ * pasted snippets like ``  /summarize foo`` still parse. The slug
+ * grammar matches the backend's ``SkillManager._slug`` output (alnum
+ * + underscore + dash), which is also what the autocomplete menus
+ * surface, so there's exactly one definition of "valid slug."
+ *
+ * Returns ``null`` if the input doesn't start with ``/<slug>``.
+ *
+ * Use this in **dispatchers** (TUI command-registry) and **pre-flight
+ * hint** paths where you want to react to any in-progress or
+ * submitted slash command. For the narrower "user is typing a slug
+ * with no args yet" UX, use ``parseSlashTokenInProgress``.
+ */
+declare function parseSlashCommand(input: string): ParsedSlashCommand | null;
+/**
+ * Parse a slash-command **in progress** — the buffer is just
+ * ``/<token>`` with no committed arguments yet (no space after the
+ * slug). This is the trigger condition for the autocomplete menu:
+ * the moment the user types a space, the slug is "committed" and the
+ * menu should hide so further keystrokes form the arguments.
+ *
+ * Empty token is allowed (a bare ``/``) so the menu opens immediately
+ * and lists everything — same UX as Slack/Discord.
+ */
+declare function parseSlashTokenInProgress(buffer: string): string | null;
+/**
+ * Filter a list of skill summaries by a typed query and sort by
+ * relevance: prefix matches first, then substring matches, alphabetic
+ * within each bucket. Pinned slugs (the user's favourites — surfaced
+ * by the React library modal) float to the very top.
+ *
+ * Pure function — same logic used by the React popover, the TUI
+ * autocomplete, and the CLI. Pulling it out of the React component
+ * means a change to the matching rules lands in one place.
+ */
+declare function filterSkills<T extends {
+    slug?: string;
+    name: string;
+}>(items: ReadonlyArray<T>, query: string, pinned?: ReadonlyArray<string>): T[];
 
 type assistant_AssistantQueryOptions = AssistantQueryOptions;
 type assistant_Chunk = Chunk;
 type assistant_ChunkMetadata = ChunkMetadata;
+type assistant_ParsedSlashCommand = ParsedSlashCommand;
 type assistant_RetrieveOptions = RetrieveOptions;
 type assistant_RetrieveResult = RetrieveResult;
+type assistant_SkillSummary = SkillSummary;
 declare const assistant_buildRetrievalChunkTool: typeof buildRetrievalChunkTool;
 declare const assistant_buildRetrievalFullContextTool: typeof buildRetrievalFullContextTool;
 declare const assistant_buildRetrievalTocTool: typeof buildRetrievalTocTool;
+declare const assistant_filterSkills: typeof filterSkills;
+declare const assistant_listSkills: typeof listSkills;
+declare const assistant_parseSlashCommand: typeof parseSlashCommand;
+declare const assistant_parseSlashTokenInProgress: typeof parseSlashTokenInProgress;
 declare const assistant_queryAssistant: typeof queryAssistant;
 declare const assistant_respondToAgent: typeof respondToAgent;
 declare const assistant_retrieve: typeof retrieve;
 declare namespace assistant {
-  export { type assistant_AssistantQueryOptions as AssistantQueryOptions, type assistant_Chunk as Chunk, type assistant_ChunkMetadata as ChunkMetadata, type assistant_RetrieveOptions as RetrieveOptions, type assistant_RetrieveResult as RetrieveResult, assistant_buildRetrievalChunkTool as buildRetrievalChunkTool, assistant_buildRetrievalFullContextTool as buildRetrievalFullContextTool, assistant_buildRetrievalTocTool as buildRetrievalTocTool, assistant_queryAssistant as queryAssistant, assistant_respondToAgent as respondToAgent, assistant_retrieve as retrieve };
+  export { type assistant_AssistantQueryOptions as AssistantQueryOptions, type assistant_Chunk as Chunk, type assistant_ChunkMetadata as ChunkMetadata, type assistant_ParsedSlashCommand as ParsedSlashCommand, type assistant_RetrieveOptions as RetrieveOptions, type assistant_RetrieveResult as RetrieveResult, type assistant_SkillSummary as SkillSummary, assistant_buildRetrievalChunkTool as buildRetrievalChunkTool, assistant_buildRetrievalFullContextTool as buildRetrievalFullContextTool, assistant_buildRetrievalTocTool as buildRetrievalTocTool, assistant_filterSkills as filterSkills, assistant_listSkills as listSkills, assistant_parseSlashCommand as parseSlashCommand, assistant_parseSlashTokenInProgress as parseSlashTokenInProgress, assistant_queryAssistant as queryAssistant, assistant_respondToAgent as respondToAgent, assistant_retrieve as retrieve };
 }
 
 /**
@@ -4220,4 +4346,4 @@ declare namespace responses {
   export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
 }
 
-export { type UserInputRequestEvent as $, type AuthHeaders as A, type ReconnectableWsConnection as B, type ConfigStore as C, type DmCryptoContext as D, type ResolvedCitation as E, type FormattedWsMessage as F, type ResponseCompletedEvent as G, type ResponseContentPartAddedEvent as H, type ResponseCreatedEvent as I, type ResponseFailedEvent as J, type ResponseOutputItemAddedEvent as K, type ListAllOptions as L, type MessageLevel as M, type ResponseOutputItemDoneEvent as N, type OutputTokensDetails as O, type ResponseOutputTextDeltaEvent as P, type QueryOptions as Q, type ReconnectOptions as R, type SkippedFile as S, type ResponseOutputTextDoneEvent as T, type UploadResult as U, type ResponseUsage as V, type SSEEvent as W, type SSEStreamCallbacks as X, type SSEStreamResult as Y, type SSEStreamStartData as Z, type UserInfo as _, type CliConfig as a, type UserMessageEvent as a0, type WorkspaceContext as a1, type WsConnection as a2, agentconfig as a3, assistant as a4, authenticatedFetch as a5, buildRetrievalChunkTool as a6, buildRetrievalFullContextTool as a7, buildRetrievalTocTool as a8, connectWebSocket as a9, performSsoDeviceFlowLogin as aA, requireData as aB, requireOk as aC, resolveAuth as aD, resolveCitations as aE, resolveWorkspace as aF, responses as aG, selectWorkspace as aH, selectWorkspaceById as aI, settings as aJ, streamSSE as aK, stripCitationMarkdown as aL, summarizeCitations as aM, tags as aN, workspaces as aO, type ArbiErrorEvent as aP, connectWithReconnect as aa, consumeSSEStream as ab, contacts as ac, conversations as ad, countCitations as ae, createAuthenticatedClient as af, createDocumentWaiter as ag, dm as ah, doctags as ai, documents as aj, files as ak, formatAgentStepLabel as al, formatFileSize as am, formatStreamSummary as an, formatUserName as ao, formatWorkspaceChoices as ap, formatWsMessage as aq, generateEncryptedWorkspaceKey as ar, generateNewWorkspaceKey as as, getErrorCode as at, getErrorMessage as au, getRawWorkspaceKey as av, health as aw, parseSSEEvents as ax, performPasswordLogin as ay, performSigningKeyLogin as az, type CliCredentials as b, type ChatSession as c, type UploadBatchResult as d, type UploadOptions as e, type UploadDirectOptions as f, type UploadDirectResult as g, SUPPORTED_EXTENSIONS as h, type AgentStepEvent as i, Arbi as j, ArbiApiError as k, ArbiError as l, type ArbiOptions as m, type ArtifactEvent as n, type AuthContext as o, type AuthenticatedClient as p, type CitationSummary as q, type ConnectOptions as r, DOC_TERMINAL_STATUSES as s, type DocumentListFields as t, type DocumentListOrder as u, type DocumentWaiter as v, type DocumentWaiterOptions as w, type ListPaginatedOptions as x, type MessageMetadataPayload$1 as y, type MessageQueuedEvent as z };
+export { type SkillSummary as $, type AuthHeaders as A, type ReconnectableWsConnection as B, type ConfigStore as C, type DmCryptoContext as D, type ResolvedCitation as E, type FormattedWsMessage as F, type ResponseCompletedEvent as G, type ResponseContentPartAddedEvent as H, type ResponseCreatedEvent as I, type ResponseFailedEvent as J, type ResponseOutputItemAddedEvent as K, type ListAllOptions as L, type MessageLevel as M, type ResponseOutputItemDoneEvent as N, type OutputTokensDetails as O, type ParsedSlashCommand as P, type QueryOptions as Q, type ReconnectOptions as R, type SkippedFile as S, type ResponseOutputTextDeltaEvent as T, type UploadResult as U, type ResponseOutputTextDoneEvent as V, type ResponseUsage as W, type SSEEvent as X, type SSEStreamCallbacks as Y, type SSEStreamResult as Z, type SSEStreamStartData as _, type CliConfig as a, type UserInfo as a0, type UserInputRequestEvent as a1, type UserMessageEvent as a2, type WorkspaceContext as a3, type WsConnection as a4, agentconfig as a5, assistant as a6, authenticatedFetch as a7, buildRetrievalChunkTool as a8, buildRetrievalFullContextTool as a9, parseSSEEvents as aA, parseSlashCommand as aB, parseSlashTokenInProgress as aC, performPasswordLogin as aD, performSigningKeyLogin as aE, performSsoDeviceFlowLogin as aF, requireData as aG, requireOk as aH, resolveAuth as aI, resolveCitations as aJ, resolveWorkspace as aK, responses as aL, selectWorkspace as aM, selectWorkspaceById as aN, settings as aO, streamSSE as aP, stripCitationMarkdown as aQ, summarizeCitations as aR, tags as aS, workspaces as aT, type ArbiErrorEvent as aU, buildRetrievalTocTool as aa, connectWebSocket as ab, connectWithReconnect as ac, consumeSSEStream as ad, contacts as ae, conversations as af, countCitations as ag, createAuthenticatedClient as ah, createDocumentWaiter as ai, dm as aj, doctags as ak, documents as al, files as am, filterSkills as an, formatAgentStepLabel as ao, formatFileSize as ap, formatStreamSummary as aq, formatUserName as ar, formatWorkspaceChoices as as, formatWsMessage as at, generateEncryptedWorkspaceKey as au, generateNewWorkspaceKey as av, getErrorCode as aw, getErrorMessage as ax, getRawWorkspaceKey as ay, health as az, type CliCredentials as b, type ChatSession as c, type UploadBatchResult as d, type UploadOptions as e, type UploadDirectOptions as f, type UploadDirectResult as g, SUPPORTED_EXTENSIONS as h, type AgentStepEvent as i, Arbi as j, ArbiApiError as k, ArbiError as l, type ArbiOptions as m, type ArtifactEvent as n, type AuthContext as o, type AuthenticatedClient as p, type CitationSummary as q, type ConnectOptions as r, DOC_TERMINAL_STATUSES as s, type DocumentListFields as t, type DocumentListOrder as u, type DocumentWaiter as v, type DocumentWaiterOptions as w, type ListPaginatedOptions as x, type MessageMetadataPayload$1 as y, type MessageQueuedEvent as z };

package/dist/{browser-D2dkZnc9.d.ts → browser-B5xRfc7b.d.ts}

@@ -84,16 +84,40 @@ interface CliConfig {
 }
 interface CliCredentials {
     email: string;
+    /** User's external ID (``usr-*`` or ``agt-*``). Needed by features
+     *  that key on user identity (DM crypto, contact resolution, etc.).
+     *  Set on every login from the API's response; required by
+     *  ``buildAuthFromCache`` to restore the session client-side
+     *  without a server round-trip. */
+    userExtId?: string;
     signingPrivateKeyBase64: string;
     serverSessionKeyBase64: string;
-    /** Cached access token from last successful resolveWorkspace() */
+    /** Cached access token for the live server session. Valid as long as
+     *  ``tokenTimestamp`` is within ``TOKEN_MAX_AGE_MS``. */
     accessToken?: string;
-    /** Cached session-sealed workspace key from last successful resolveWorkspace() */
-    sealedWorkspaceKey?: string;
-    /** Workspace ID the cached token was issued for */
-    workspaceId?: string;
-    /** ISO timestamp when the token was cached */
+    /** ISO timestamp when ``accessToken`` was issued. Used for client-side
+     *  TTL — the server enforces JWT exp independently. */
     tokenTimestamp?: string;
+    /**
+     * Workspaces whose keys are already deposited on the current server
+     * session — i.e. the keys of ``session.workspaces`` in the backend's
+     * Redis entry. Client-side mirror so we can skip a redundant `/open`
+     * round-trip when we've already deposited a workspace's key during
+     * this session's lifetime.
+     *
+     * Both grant types end up in this set:
+     *  - **Permanent** — first `/open` for the workspace POSTs the
+     *    wrapped_key and the server adds it to ``session.workspaces``.
+     *  - **Session-only** (PA agents, temporary shares) — the backend
+     *    pre-deposits via ``store_workspace_key_for_session_pubkey``,
+     *    then the client's `/open` is just a metadata fetch.
+     *
+     * Cleared on every event that invalidates the session: fresh login,
+     * auto-relogin on 401, logout. The new session starts with an empty
+     * ``session.workspaces`` server-side, so this client mirror must
+     * start empty too.
+     */
+    openedWorkspaces?: string[];
     /** Auth0 SSO token — needed for session recovery of SSO users */
     ssoToken?: string;
     /** Parent user ext_id — set for persistent agent accounts */
@@ -152,7 +176,6 @@ interface AuthContext {
 interface WorkspaceContext extends AuthContext {
     workspaceId: string;
     accessToken: string;
-    sealedWorkspaceKey: string;
 }
 /** Minimal workspace shape required by formatWorkspaceChoices. */
 interface WorkspaceForChoice {
@@ -232,23 +255,40 @@ declare function generateNewWorkspaceKey(arbi: ArbiClient, serverSessionKey: Uin
  * never log, persist, or transmit it over the wire.
  */
 declare function getRawWorkspaceKey(arbi: ArbiClient, workspaceId: string, signingPrivateKeyBase64: string): Promise<Uint8Array>;
-/**
- * Find a workspace by ID in the user's workspace list, select it, and return workspace info.
- */
 declare function selectWorkspaceById(arbi: ArbiClient, workspaceId: string, serverSessionKey: Uint8Array, signingPrivateKeyBase64: string): Promise<{
     external_id: string;
     name: string;
-    wrapped_key: string;
+    wrapped_key: string | null;
+    /** The session-sealed workspace key — `null` for session-only grants */
+    sealed_key: string | null;
 }>;
 /**
  * Authenticate and return the SDK client + config.
- * Throws ArbiError instead of calling process.exit.
+ *
+ * Fast path: reuse the live server session via cached accessToken.
+ * Slow path: fresh ``loginWithKey`` (mints a new session, clears
+ * ``openedWorkspaces``).
  */
 declare function resolveAuth(store: ConfigStore): Promise<AuthContext>;
 /**
- * Authenticate, resolve workspace, and set up headers.
- * Uses cached JWT when available for the same workspace and not expired.
- * Throws ArbiError instead of calling process.exit.
+ * Authenticate, ensure the workspace's key is deposited on the current
+ * server session, and return everything callers need.
+ *
+ * Decisions are independent:
+ *  1. **Session aliveness** — reuse the live session if its accessToken
+ *     is within TTL; otherwise fresh login. (Fresh login = new session
+ *     = ``openedWorkspaces`` reset to ``[]``.)
+ *  2. **Workspace deposit** — if ``workspaceId`` already appears in
+ *     ``creds.openedWorkspaces``, the server's session already holds
+ *     its key; no ``/open`` needed. Otherwise call ``/open`` once and
+ *     append to the set.
+ *
+ * Splitting these matters: previously the cache was gated on
+ * ``creds.workspaceId === workspaceId``, so any switch between
+ * workspaces forced a re-login. That orphaned PA-agent session
+ * deposits and broke ``arbi docs`` for them. Now switching workspaces
+ * within a live session just adds another entry to
+ * ``openedWorkspaces`` — no re-login, no orphaned deposits.
  */
 declare function resolveWorkspace(store: ConfigStore, workspaceOpt?: string): Promise<WorkspaceContext>;
 
@@ -540,6 +580,7 @@ declare function formatUserName(user: UserInfo | null | undefined): string;
 type MessageMetadataPayload = components['schemas']['MessageMetadataPayload'];
 type CitationData$2 = components['schemas']['CitationData'];
 type Chunk$1 = components['schemas']['Chunk'];
+
 /** A fully resolved citation with its source chunks. */
 interface ResolvedCitation {
     /** Citation number as a string (e.g. "1", "2") */
@@ -681,6 +722,11 @@ declare function sanitizeFolderPath(folderPath: string): string;
 interface UploadOptions {
     folder?: string;
     configExtId?: string;
+    /** Work-product type for the uploaded doc — ``source`` (default),
+     *  ``skill``, ``memory``, ``artifact``. Skills must be uploaded with
+     *  ``wp_type='skill'`` AND in a ``skills/<slug>`` folder so the
+     *  backend's ``SkillManager`` recognises them. */
+    wpType?: 'source' | 'skill' | 'memory' | 'artifact' | 'webpage';
 }
 interface SkippedFile {
     file_name: string;
@@ -1131,20 +1177,100 @@ declare function queryAssistant(options: AssistantQueryOptions): Promise<Respons
  * The assistant_message_ext_id identifies which agent message to answer.
  */
 declare function respondToAgent(arbi: ArbiClient, assistantMessageExtId: string, answer: string): Promise<unknown>;
+/** A single user-invocable skill as exposed by ``GET /v1/assistant/skills``.
+ *  Re-exported with the schema-generated shape so callers don't have to
+ *  reach into ``components['schemas']`` themselves. */
+type SkillSummary = components['schemas']['SkillSummaryResponse'];
+/**
+ * List the skills the caller can invoke in the active workspace.
+ *
+ * Powers slash-command autocomplete in the TUI, CLI, and React UI.
+ * Returns lightweight metadata only (name, description, args hint) —
+ * never the SKILL.md body. To read the body, fetch the document via
+ * ``getParsedContent(authHeaders, doc_ext_id, 'content')``.
+ *
+ * Scoped to the workspace the caller has open (the backend uses the
+ * session's ``active_workspace``); cross-workspace listing isn't
+ * supported because each workspace has its own encryption key.
+ *
+ * @param includeHidden  When ``true``, returns skills with
+ *   ``user-invocable: false`` in their frontmatter. Off by default —
+ *   those are typically agent-only or in-progress skills that
+ *   shouldn't surface in slash menus.
+ */
+declare function listSkills(arbi: ArbiClient, options?: {
+    includeHidden?: boolean;
+}): Promise<SkillSummary[]>;
+/** Parsed slash-command shape, regardless of frontend. */
+interface ParsedSlashCommand {
+    /** The lowercased token immediately after ``/``. */
+    slug: string;
+    /** Everything after the first whitespace, untrimmed. ``""`` when the
+     *  user hasn't typed any arguments yet. */
+    args: string;
+}
+/**
+ * Parse a *submitted* slash command (or anything that walks like one).
+ *
+ * Permissive about whitespace: leading whitespace is tolerated so
+ * pasted snippets like ``  /summarize foo`` still parse. The slug
+ * grammar matches the backend's ``SkillManager._slug`` output (alnum
+ * + underscore + dash), which is also what the autocomplete menus
+ * surface, so there's exactly one definition of "valid slug."
+ *
+ * Returns ``null`` if the input doesn't start with ``/<slug>``.
+ *
+ * Use this in **dispatchers** (TUI command-registry) and **pre-flight
+ * hint** paths where you want to react to any in-progress or
+ * submitted slash command. For the narrower "user is typing a slug
+ * with no args yet" UX, use ``parseSlashTokenInProgress``.
+ */
+declare function parseSlashCommand(input: string): ParsedSlashCommand | null;
+/**
+ * Parse a slash-command **in progress** — the buffer is just
+ * ``/<token>`` with no committed arguments yet (no space after the
+ * slug). This is the trigger condition for the autocomplete menu:
+ * the moment the user types a space, the slug is "committed" and the
+ * menu should hide so further keystrokes form the arguments.
+ *
+ * Empty token is allowed (a bare ``/``) so the menu opens immediately
+ * and lists everything — same UX as Slack/Discord.
+ */
+declare function parseSlashTokenInProgress(buffer: string): string | null;
+/**
+ * Filter a list of skill summaries by a typed query and sort by
+ * relevance: prefix matches first, then substring matches, alphabetic
+ * within each bucket. Pinned slugs (the user's favourites — surfaced
+ * by the React library modal) float to the very top.
+ *
+ * Pure function — same logic used by the React popover, the TUI
+ * autocomplete, and the CLI. Pulling it out of the React component
+ * means a change to the matching rules lands in one place.
+ */
+declare function filterSkills<T extends {
+    slug?: string;
+    name: string;
+}>(items: ReadonlyArray<T>, query: string, pinned?: ReadonlyArray<string>): T[];
 
 type assistant_AssistantQueryOptions = AssistantQueryOptions;
 type assistant_Chunk = Chunk;
 type assistant_ChunkMetadata = ChunkMetadata;
+type assistant_ParsedSlashCommand = ParsedSlashCommand;
 type assistant_RetrieveOptions = RetrieveOptions;
 type assistant_RetrieveResult = RetrieveResult;
+type assistant_SkillSummary = SkillSummary;
 declare const assistant_buildRetrievalChunkTool: typeof buildRetrievalChunkTool;
 declare const assistant_buildRetrievalFullContextTool: typeof buildRetrievalFullContextTool;
 declare const assistant_buildRetrievalTocTool: typeof buildRetrievalTocTool;
+declare const assistant_filterSkills: typeof filterSkills;
+declare const assistant_listSkills: typeof listSkills;
+declare const assistant_parseSlashCommand: typeof parseSlashCommand;
+declare const assistant_parseSlashTokenInProgress: typeof parseSlashTokenInProgress;
 declare const assistant_queryAssistant: typeof queryAssistant;
 declare const assistant_respondToAgent: typeof respondToAgent;
 declare const assistant_retrieve: typeof retrieve;
 declare namespace assistant {
-  export { type assistant_AssistantQueryOptions as AssistantQueryOptions, type assistant_Chunk as Chunk, type assistant_ChunkMetadata as ChunkMetadata, type assistant_RetrieveOptions as RetrieveOptions, type assistant_RetrieveResult as RetrieveResult, assistant_buildRetrievalChunkTool as buildRetrievalChunkTool, assistant_buildRetrievalFullContextTool as buildRetrievalFullContextTool, assistant_buildRetrievalTocTool as buildRetrievalTocTool, assistant_queryAssistant as queryAssistant, assistant_respondToAgent as respondToAgent, assistant_retrieve as retrieve };
+  export { type assistant_AssistantQueryOptions as AssistantQueryOptions, type assistant_Chunk as Chunk, type assistant_ChunkMetadata as ChunkMetadata, type assistant_ParsedSlashCommand as ParsedSlashCommand, type assistant_RetrieveOptions as RetrieveOptions, type assistant_RetrieveResult as RetrieveResult, type assistant_SkillSummary as SkillSummary, assistant_buildRetrievalChunkTool as buildRetrievalChunkTool, assistant_buildRetrievalFullContextTool as buildRetrievalFullContextTool, assistant_buildRetrievalTocTool as buildRetrievalTocTool, assistant_filterSkills as filterSkills, assistant_listSkills as listSkills, assistant_parseSlashCommand as parseSlashCommand, assistant_parseSlashTokenInProgress as parseSlashTokenInProgress, assistant_queryAssistant as queryAssistant, assistant_respondToAgent as respondToAgent, assistant_retrieve as retrieve };
 }
 
 /**
@@ -4220,4 +4346,4 @@ declare namespace responses {
   export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
 }
 
-export { type UserInputRequestEvent as $, type AuthHeaders as A, type ReconnectableWsConnection as B, type ConfigStore as C, type DmCryptoContext as D, type ResolvedCitation as E, type FormattedWsMessage as F, type ResponseCompletedEvent as G, type ResponseContentPartAddedEvent as H, type ResponseCreatedEvent as I, type ResponseFailedEvent as J, type ResponseOutputItemAddedEvent as K, type ListAllOptions as L, type MessageLevel as M, type ResponseOutputItemDoneEvent as N, type OutputTokensDetails as O, type ResponseOutputTextDeltaEvent as P, type QueryOptions as Q, type ReconnectOptions as R, type SkippedFile as S, type ResponseOutputTextDoneEvent as T, type UploadResult as U, type ResponseUsage as V, type SSEEvent as W, type SSEStreamCallbacks as X, type SSEStreamResult as Y, type SSEStreamStartData as Z, type UserInfo as _, type CliConfig as a, type UserMessageEvent as a0, type WorkspaceContext as a1, type WsConnection as a2, agentconfig as a3, assistant as a4, authenticatedFetch as a5, buildRetrievalChunkTool as a6, buildRetrievalFullContextTool as a7, buildRetrievalTocTool as a8, connectWebSocket as a9, performSsoDeviceFlowLogin as aA, requireData as aB, requireOk as aC, resolveAuth as aD, resolveCitations as aE, resolveWorkspace as aF, responses as aG, selectWorkspace as aH, selectWorkspaceById as aI, settings as aJ, streamSSE as aK, stripCitationMarkdown as aL, summarizeCitations as aM, tags as aN, workspaces as aO, type ArbiErrorEvent as aP, connectWithReconnect as aa, consumeSSEStream as ab, contacts as ac, conversations as ad, countCitations as ae, createAuthenticatedClient as af, createDocumentWaiter as ag, dm as ah, doctags as ai, documents as aj, files as ak, formatAgentStepLabel as al, formatFileSize as am, formatStreamSummary as an, formatUserName as ao, formatWorkspaceChoices as ap, formatWsMessage as aq, generateEncryptedWorkspaceKey as ar, generateNewWorkspaceKey as as, getErrorCode as at, getErrorMessage as au, getRawWorkspaceKey as av, health as aw, parseSSEEvents as ax, performPasswordLogin as ay, performSigningKeyLogin as az, type CliCredentials as b, type ChatSession as c, type UploadBatchResult as d, type UploadOptions as e, type UploadDirectOptions as f, type UploadDirectResult as g, SUPPORTED_EXTENSIONS as h, type AgentStepEvent as i, Arbi as j, ArbiApiError as k, ArbiError as l, type ArbiOptions as m, type ArtifactEvent as n, type AuthContext as o, type AuthenticatedClient as p, type CitationSummary as q, type ConnectOptions as r, DOC_TERMINAL_STATUSES as s, type DocumentListFields as t, type DocumentListOrder as u, type DocumentWaiter as v, type DocumentWaiterOptions as w, type ListPaginatedOptions as x, type MessageMetadataPayload$1 as y, type MessageQueuedEvent as z };
+export { type SkillSummary as $, type AuthHeaders as A, type ReconnectableWsConnection as B, type ConfigStore as C, type DmCryptoContext as D, type ResolvedCitation as E, type FormattedWsMessage as F, type ResponseCompletedEvent as G, type ResponseContentPartAddedEvent as H, type ResponseCreatedEvent as I, type ResponseFailedEvent as J, type ResponseOutputItemAddedEvent as K, type ListAllOptions as L, type MessageLevel as M, type ResponseOutputItemDoneEvent as N, type OutputTokensDetails as O, type ParsedSlashCommand as P, type QueryOptions as Q, type ReconnectOptions as R, type SkippedFile as S, type ResponseOutputTextDeltaEvent as T, type UploadResult as U, type ResponseOutputTextDoneEvent as V, type ResponseUsage as W, type SSEEvent as X, type SSEStreamCallbacks as Y, type SSEStreamResult as Z, type SSEStreamStartData as _, type CliConfig as a, type UserInfo as a0, type UserInputRequestEvent as a1, type UserMessageEvent as a2, type WorkspaceContext as a3, type WsConnection as a4, agentconfig as a5, assistant as a6, authenticatedFetch as a7, buildRetrievalChunkTool as a8, buildRetrievalFullContextTool as a9, parseSSEEvents as aA, parseSlashCommand as aB, parseSlashTokenInProgress as aC, performPasswordLogin as aD, performSigningKeyLogin as aE, performSsoDeviceFlowLogin as aF, requireData as aG, requireOk as aH, resolveAuth as aI, resolveCitations as aJ, resolveWorkspace as aK, responses as aL, selectWorkspace as aM, selectWorkspaceById as aN, settings as aO, streamSSE as aP, stripCitationMarkdown as aQ, summarizeCitations as aR, tags as aS, workspaces as aT, type ArbiErrorEvent as aU, buildRetrievalTocTool as aa, connectWebSocket as ab, connectWithReconnect as ac, consumeSSEStream as ad, contacts as ae, conversations as af, countCitations as ag, createAuthenticatedClient as ah, createDocumentWaiter as ai, dm as aj, doctags as ak, documents as al, files as am, filterSkills as an, formatAgentStepLabel as ao, formatFileSize as ap, formatStreamSummary as aq, formatUserName as ar, formatWorkspaceChoices as as, formatWsMessage as at, generateEncryptedWorkspaceKey as au, generateNewWorkspaceKey as av, getErrorCode as aw, getErrorMessage as ax, getRawWorkspaceKey as ay, health as az, type CliCredentials as b, type ChatSession as c, type UploadBatchResult as d, type UploadOptions as e, type UploadDirectOptions as f, type UploadDirectResult as g, SUPPORTED_EXTENSIONS as h, type AgentStepEvent as i, Arbi as j, ArbiApiError as k, ArbiError as l, type ArbiOptions as m, type ArtifactEvent as n, type AuthContext as o, type AuthenticatedClient as p, type CitationSummary as q, type ConnectOptions as r, DOC_TERMINAL_STATUSES as s, type DocumentListFields as t, type DocumentListOrder as u, type DocumentWaiter as v, type DocumentWaiterOptions as w, type ListPaginatedOptions as x, type MessageMetadataPayload$1 as y, type MessageQueuedEvent as z };