@openviking/react 0.1.2 → 0.1.3

package/dist/client/paths.d.ts

@@ -0,0 +1,64 @@
+/**
+ * OpenViking 原生接口的路径。集中在这里，接口改名时只改一处；调用方不要自己
+ * 拼字符串。路径不含服务地址与网关前缀，拼接由 Client 完成。
+ *
+ * 用 `as const` 而不是 `enum`：字符串 enum 在 `isolatedModules` 下不会内联，
+ * 生成的对象还会被当成副作用；作为公开导出时它是 ambient const enum，消费者
+ * 一旦开启 `isolatedModules` 或 `verbatimModuleSyntax` 就无法使用。
+ *
+ * Paths of the native OpenViking API. Keeping them here means a rename is one
+ * edit, and callers never build strings themselves. A path carries no service
+ * address or gateway prefix; the Client joins those.
+ *
+ * `as const` rather than `enum`: a string enum is not inlined under
+ * `isolatedModules`, its emitted object counts as a side effect, and as a public
+ * export it is an ambient const enum that consumers with `isolatedModules` or
+ * `verbatimModuleSyntax` cannot use.
+ */
+export declare const OV_PATHS: {
+    /** 列出目录内容。List directory contents. */
+    readonly fsLs: '/api/v1/fs/ls';
+    /** 读取条目状态。Read an entry's status. */
+    readonly fsStat: '/api/v1/fs/stat';
+    /** 读取目录树。Read a directory tree. */
+    readonly fsTree: '/api/v1/fs/tree';
+    /** 新建目录。Create a directory. */
+    readonly fsMkdir: '/api/v1/fs/mkdir';
+    /** 移动或重命名。Move or rename. */
+    readonly fsMv: '/api/v1/fs/mv';
+    /** 读取文件正文。Read file content. */
+    readonly contentRead: '/api/v1/content/read';
+    /** 读取目录的 L0 摘要。Read a directory's L0 abstract. */
+    readonly contentAbstract: '/api/v1/content/abstract';
+    /** 读取目录的 L1 概览。Read a directory's L1 overview. */
+    readonly contentOverview: '/api/v1/content/overview';
+    /** 下载文件原始字节。Download a file's raw bytes. */
+    readonly contentDownload: '/api/v1/content/download';
+    /** 写入文件正文。Write file content. */
+    readonly contentWrite: '/api/v1/content/write';
+    /** 按模式匹配文件。Match files by pattern. */
+    readonly searchGlob: '/api/v1/search/glob';
+    /** 语义检索。Semantic search. */
+    readonly searchFind: '/api/v1/search/find';
+    /** 按正则检索正文。Search content by regular expression. */
+    readonly searchGrep: '/api/v1/search/grep';
+    /** 会话列表与新建。Session list and creation. */
+    readonly sessions: '/api/v1/sessions';
+    /** 非流式对话。Non-streaming chat. */
+    readonly botChat: '/bot/v1/chat';
+    /** 流式对话。Streaming chat. */
+    readonly botChatStream: '/bot/v1/chat/stream';
+};
+/** 一个静态路径的取值类型。Value type of one static path. */
+export type OvPath = (typeof OV_PATHS)[keyof typeof OV_PATHS];
+/**
+ * 带路径参数的接口。参数会被 URL 编码：会话 id 里出现 `/` 时不能当成路径分隔。
+ * Endpoints with a path parameter. The value is URL-encoded, so a session id
+ * containing `/` is not read as a path separator.
+ */
+export declare const OV_PATH_BUILDERS: {
+    /** 单个会话。One session. */
+    readonly session: (sessionId: string) => string;
+    /** 会话的消息。Messages of one session. */
+    readonly sessionMessages: (sessionId: string) => string;
+};

package/dist/client/response.d.ts

@@ -0,0 +1,31 @@
+import { OvClientError } from './errors.js';
+import type { OvErrorEnvelope, OvSuccessEnvelope } from './types.js';
+/** 任意对象判定。Record check. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** 把响应体读成原生外壳；不是对象时按空外壳处理。 */
+export declare function readEnvelope(value: unknown): OvErrorEnvelope & OvSuccessEnvelope;
+/** 解析 JSON 文本；不是 JSON 时返回 `undefined`，不抛错。 */
+export declare function parseJson(raw: string): unknown;
+/** 请求被调用方主动取消时保留 `AbortError` 语义，便于调用方区分。 */
+export declare function isAbortError(error: unknown): boolean;
+/**
+ * 把传输层的拒绝归一成 {@link OvClientError}。调用方主动取消时保留原始错误，
+ * 以便按 `AbortError` 判断；其余网络失败带上原始错误作为 cause。
+ *
+ * Normalises a transport rejection into {@link OvClientError}. A caller-requested
+ * abort keeps the original error so it can be recognised as an `AbortError`;
+ * every other network failure carries the original error as its cause.
+ */
+export declare function normalizeTransportError(error: unknown, signal?: AbortSignal): never;
+/** 读取文本响应体。读取失败属于传输失败（含取消），必须上报。 */
+export declare function readText(response: Response, signal?: AbortSignal): Promise<string>;
+/** 读取二进制响应体。读取失败同样属于传输失败。 */
+export declare function readBlob(response: Response, signal?: AbortSignal): Promise<Blob>;
+/** 由原生错误外壳构造失败，保留错误码、状态与请求标识。 */
+export declare function toClientError(response: Response, body: unknown, fallbackCode?: string): OvClientError;
+/**
+ * 原生接口在 HTTP 200 里用 `status: 'error'` 表达业务失败；命中时抛错。
+ * The native API reports business failures as `status: 'error'` inside HTTP 200;
+ * throw when that happens.
+ */
+export declare function throwIfErrorEnvelope(response: Response, body: unknown): void;

package/dist/client/sse.d.ts

@@ -0,0 +1,39 @@
+import type { OvStreamEvent } from './types.js';
+/**
+ * 把事件流字节解成事件。
+ *
+ * 分帧按规范逐字符进行：`\r`、`\n` 与 `\r\n` 都是行终止符，行终止符之后紧跟的
+ * `\n` 属于同一个 CRLF，跳过即可。一个空行结束事件块，块内按行取字段。
+ *
+ * 关键在于 `\r` 必须**立即**结束当前行，不能留在缓冲区等下一个 chunk：服务端
+ * 用纯 CR 换行时，`data: one\r\r` 本身就已经是完整事件，等更多字节会让一个已经
+ * 到达的事件永远发不出去（流保持打开时就是挂死）。
+ *
+ * 早先的实现在块之间找「两个终止符」的连续片段，那样必须等第二个 `\r` 之后确认
+ * 没有跟 `\n` 才能分帧，因此才会出现上述挂起。
+ *
+ * 流结束时残留的一行与块仍会派发——规范要求丢弃，但服务端漏掉末尾空行时那样会
+ * 静默吞掉最后一个事件，代价更大；残缺的 JSON 由调用方解析失败后忽略。
+ *
+ * Decodes event-stream bytes into events.
+ *
+ * Framing follows the specification character by character: `\r`, `\n` and `\r\n`
+ * all terminate a line, and a `\n` immediately after a `\r` belongs to the same
+ * CRLF, so it is skipped. A blank line ends an event block, and fields are read
+ * line by line inside it.
+ *
+ * The point is that `\r` must end the current line **immediately** rather than
+ * being held until the next chunk: with CR-only line endings, `data: one\r\r` is
+ * already a complete event, and waiting for more bytes means an event that has
+ * arrived never dispatches — which hangs while the stream stays open.
+ *
+ * An earlier implementation searched for a run of two terminators between blocks,
+ * which required seeing past the second `\r` to know no `\n` followed, and that is
+ * exactly what caused the stall.
+ *
+ * A trailing line and block are still dispatched on end — the specification says to
+ * drop them, but a server that omits the final blank line would then lose its last
+ * event silently, which costs more; truncated JSON fails to parse and is ignored by
+ * the caller.
+ */
+export declare function decodeEventStream(body: ReadableStream<Uint8Array>): ReadableStream<OvStreamEvent>;

package/dist/client/stream.d.ts

@@ -0,0 +1,26 @@
+import type { OvClientOptions, OvRequestOptions, OvResolvedOptions, OvStream, OvStreamSpec } from './types.js';
+/**
+ * `stream()` 需要的两件外部能力：发一次请求，以及解析本次请求生效的配置。
+ * 抽成参数而不是复制实现，是为了让流式逻辑单独成文件、守住单文件行数上限。
+ *
+ * The two capabilities `stream()` needs: send one request, and resolve the
+ * configuration in effect for it. They are passed in rather than duplicated so the
+ * streaming logic can live in its own file and stay within the per-file line limit.
+ */
+export interface StreamDeps {
+    send: (spec: OvStreamSpec, headers?: Record<string, string>, signal?: AbortSignal, resolved?: OvResolvedOptions) => Promise<{
+        response: Response;
+        effective: OvResolvedOptions;
+    }>;
+    resolveFor: (defaults: OvClientOptions, override: OvRequestOptions | undefined) => Promise<OvResolvedOptions>;
+    defaults: OvClientOptions;
+}
+/**
+ * 建立一条事件流：自己的控制器与调用方取消联动，建立阶段的失败按普通请求上报，
+ * 迭代结束（正常结束、提前 `break` 或出错）都释放底层流。
+ *
+ * Opens an event stream: its own controller is linked to caller cancellation, setup
+ * failures are reported like an ordinary request, and every way iteration ends —
+ * completion, an early `break` or an error — releases the underlying stream.
+ */
+export declare function openStream(spec: OvStreamSpec, { send, resolveFor, defaults }: StreamDeps): Promise<OvStream>;

package/dist/client/types.d.ts

@@ -111,6 +111,15 @@ export interface OvRequestSpec {
     path: string;
     query?: Readonly<Record<string, OvQueryValue>>;
     body?: unknown;
+    /**
+     * 响应体的读取方式。省略时为 `json`：解析原生外壳并返回 `result`。需要原始
+     * 字节时传 `blob`，此时 `TResult` 应声明为 `Blob`。
+     *
+     * How the response body is read. Omitted means `json`: the native envelope is
+     * parsed and its `result` returned. Pass `blob` for raw bytes, declaring
+     * `TResult` as `Blob`.
+     */
+    responseType?: OvResponseType;
     /**
      * 本次请求的身份、作用域与服务地址覆盖，例如切换到另一个库或另一个网关。
      * Identity, scope and service-address override for this request, for example
@@ -118,6 +127,24 @@ export interface OvRequestSpec {
      */
     options?: OvRequestOptions;
 }
+/**
+ * 响应体的读取方式：`json` 解析外壳后返回 `result`，`blob` 返回原始字节。
+ * How the response body is read: `json` parses the envelope and returns
+ * `result`, `blob` returns the raw bytes.
+ */
+export type OvResponseType = 'json' | 'blob';
+/**
+ * 一次 JSON 请求的外壳与 `result`。列表接口把 `has_more` 放在 `result` 之外，
+ * 需要分页时用 {@link OvClient.requestEnvelope} 才能读到它。
+ * The envelope and `result` of one JSON request. A listing puts `has_more`
+ * outside `result`, so paging reads it through {@link OvClient.requestEnvelope}.
+ */
+export interface OvResponseEnvelope<TResult = unknown> {
+    /** 原生响应的 `result`。The native response's `result`. */
+    result: TResult;
+    /** 是否还有下一页；接口不返回该字段时为 `false`。 */
+    hasMore: boolean;
+}
 /** 查询参数可接受的值；`undefined` 与 `null` 表示不发送。 */
 export type OvQueryValue = string | number | boolean | null | undefined | readonly (string | number | boolean)[];
 /**
@@ -139,6 +166,65 @@ export interface OvErrorEnvelope {
         details?: unknown;
     };
 }
+/**
+ * 一个 SSE 事件。字段按 SSE 规范解析，`data` 保持原文——OpenViking 把事件类型
+ * 与事件 id 放在 `data` 的 JSON 里，不占 SSE 的 `event` / `id` 字段，调用方需要
+ * 自己解析 `data` 才能读到它们。
+ *
+ * One SSE event. Fields follow the SSE specification and `data` stays raw:
+ * OpenViking puts the event type and event id inside the `data` JSON rather than
+ * in the SSE `event` / `id` fields, so a caller parses `data` to read them.
+ */
+export interface OvStreamEvent {
+    /**
+     * `data:` 字段，多行按换行拼接，原样保留不做 JSON 解析。
+     * The `data:` field, with multiple lines joined by newlines and kept verbatim.
+     */
+    data: string;
+    /**
+     * `event:` 字段，服务端未发送时省略。
+     * The `event:` field, omitted when the server sends none.
+     */
+    event?: string;
+    /**
+     * `id:` 字段，服务端未发送时省略。
+     * The `id:` field, omitted when the server sends none.
+     */
+    id?: string;
+    /**
+     * `retry:` 字段，单位毫秒，服务端未发送时省略。
+     * The `retry:` field in milliseconds, omitted when the server sends none.
+     */
+    retry?: number;
+}
+/**
+ * 一次流式请求。除 `headers` 外与 {@link OvRequestSpec} 相同。
+ * A streaming request. It matches {@link OvRequestSpec} apart from `headers`.
+ */
+export interface OvStreamSpec extends Omit<OvRequestSpec, 'responseType'> {
+    /**
+     * 追加的请求头。身份字段仍由 Client 组装并在同名时胜出，调用方无法误改凭证。
+     * `accept: text/event-stream` 默认发送，可在此覆盖。
+     *
+     * Extra request headers. Identity headers are still assembled by the Client
+     * and win on a name clash, so a caller cannot accidentally replace a
+     * credential. `accept: text/event-stream` is sent by default and may be
+     * overridden here.
+     */
+    headers?: Readonly<Record<string, string>>;
+}
+/**
+ * 已建立的流。异步迭代得到事件，`abort` 中止请求后迭代器以 `AbortError` 拒绝。
+ * 响应体边读边消费，因此只能迭代一次。
+ *
+ * An open stream. Iterating yields events; `abort` stops the request and the
+ * iterator then rejects with an `AbortError`. The body is consumed as it is
+ * read, so it can be iterated only once.
+ */
+export interface OvStream extends AsyncIterable<OvStreamEvent> {
+    /** 中止请求并释放连接。Aborts the request and releases the connection. */
+    abort: () => void;
+}
 /**
  * 框架无关的请求能力。库自带基于 `fetch` 的实现，宿主也可以自行实现以复用
  * 已有请求层；模块只依赖本接口。
@@ -152,6 +238,24 @@ export interface OvClient {
      * Sends one request and returns the native response's `result`.
      */
     request<TResult>(spec: OvRequestSpec): Promise<TResult>;
+    /**
+     * 与 `request` 相同，但同时返回 `result` 之外的分页标记。列表接口用它判断
+     * 是否还有下一页；`responseType: 'blob'` 不适用。
+     *
+     * Same as `request`, but also returns the pagination flag that sits outside
+     * `result`. A listing uses it to decide whether a next page exists; not
+     * applicable to `responseType: 'blob'`.
+     */
+    requestEnvelope<TResult>(spec: OvRequestSpec): Promise<OvResponseEnvelope<TResult>>;
+    /**
+     * 建立一条 SSE 流。响应到达后即返回，事件随后逐个产出；HTTP 失败、非事件流
+     * 响应与外壳里的 `status: 'error'` 都在返回前抛出。
+     *
+     * Opens an SSE stream. It resolves once the response arrives and yields events
+     * afterwards; an HTTP failure, a non-event-stream response and a
+     * `status: 'error'` envelope all throw before it resolves.
+     */
+    stream(spec: OvStreamSpec): Promise<OvStream>;
     /**
      * 当前生效的服务地址，用于缓存键与订阅隔离。
      * The effective service address, used to isolate caches and subscriptions.

package/dist/client.js

@@ -1,239 +1 @@
-import { jsx } from "react/jsx-runtime";
-import { createContext, useContext as external_react_useContext, useMemo } from "react";
-class OvClientError extends Error {
-    code;
-    statusCode;
-    details;
-    requestId;
-    responseBody;
-    constructor(options){
-        super(options.message, void 0 === options.cause ? void 0 : {
-            cause: options.cause
-        });
-        this.name = 'OvClientError';
-        this.code = options.code;
-        this.statusCode = options.statusCode;
-        this.details = options.details;
-        this.requestId = options.requestId;
-        this.responseBody = options.responseBody;
-    }
-}
-function isOvClientError(value) {
-    return value instanceof OvClientError;
-}
-const IDENTITY_HEADERS = {
-    apiKey: 'X-API-Key',
-    accountId: 'X-OpenViking-Account',
-    userId: 'X-OpenViking-User',
-    resourceId: 'V-Resource-Id'
-};
-async function evaluate(value) {
-    if (void 0 === value) return;
-    return 'function' == typeof value ? await value() : value;
-}
-async function resolveIdentityLayer(options) {
-    const layer = {};
-    for (const field of Object.keys(IDENTITY_HEADERS)){
-        const value = await evaluate(options?.[field]);
-        if (void 0 !== value) layer[field] = value;
-    }
-    return layer;
-}
-function mergeIdentityLayers(far, near) {
-    return {
-        ...far,
-        ...near
-    };
-}
-function toHeaders(layer) {
-    const out = {};
-    for (const field of Object.keys(IDENTITY_HEADERS)){
-        const value = layer[field]?.trim();
-        if (value) out[IDENTITY_HEADERS[field].toLowerCase()] = value;
-    }
-    return out;
-}
-function resolveClientOptions(options, identity) {
-    return {
-        baseURL: options.baseURL ?? '',
-        credentials: options.credentials ?? 'same-origin',
-        headers: toHeaders(identity),
-        signal: options.signal
-    };
-}
-function resolveRequestOptions(local, parent, mergedLayer) {
-    const headers = {
-        ...parent.headers
-    };
-    for (const field of Object.keys(IDENTITY_HEADERS)){
-        const value = mergedLayer[field];
-        if (void 0 === value) continue;
-        const name = IDENTITY_HEADERS[field].toLowerCase();
-        if (value.trim()) headers[name] = value;
-        else delete headers[name];
-    }
-    return {
-        baseURL: local?.baseURL ?? parent.baseURL,
-        credentials: parent.credentials,
-        headers,
-        signal: local?.signal ?? parent.signal
-    };
-}
-function joinUrl(baseURL, path) {
-    const prefix = baseURL.replace(/\/+$/, '');
-    return `${prefix}${path.startsWith('/') ? path : `/${path}`}`;
-}
-function buildQuery(query) {
-    if (!query) return '';
-    const params = new URLSearchParams();
-    for (const [key, value] of Object.entries(query))if (null != value) {
-        if (Array.isArray(value)) {
-            for (const item of value)params.append(key, String(item));
-            continue;
-        }
-        params.set(key, String(value));
-    }
-    const text = params.toString();
-    return text ? `?${text}` : '';
-}
-function mergeProviderConfig(inherited, local) {
-    const declared = {};
-    if (void 0 !== local.apiKey) declared.apiKey = local.apiKey;
-    if (void 0 !== local.accountId) declared.accountId = local.accountId;
-    if (void 0 !== local.userId) declared.userId = local.userId;
-    if (void 0 !== local.resourceId) declared.resourceId = local.resourceId;
-    return {
-        baseURL: local.baseURL ?? inherited?.baseURL,
-        credentials: local.credentials ?? inherited?.credentials,
-        signal: local.signal ?? inherited?.signal,
-        fetch: local.fetch ?? inherited?.fetch,
-        identity: {
-            ...inherited?.identity,
-            ...declared
-        }
-    };
-}
-function isRecord(value) {
-    return 'object' == typeof value && null !== value && !Array.isArray(value);
-}
-function readEnvelope(value) {
-    return isRecord(value) ? value : {};
-}
-function isAbortError(error) {
-    return isRecord(error) && ('AbortError' === error.name || 'ABORT_ERR' === error.code);
-}
-function normalizeTransportError(error, signal) {
-    if (isAbortError(error) || signal?.aborted) throw error;
-    throw new OvClientError({
-        code: 'NETWORK_ERROR',
-        message: error instanceof Error ? error.message : 'Network request failed',
-        cause: error
-    });
-}
-function createOvClient(options = {}) {
-    const fetchImpl = options.fetch ?? globalThis.fetch;
-    if (!fetchImpl) throw new Error('createOvClient needs a fetch implementation. Pass `fetch` on platforms without a global one.');
-    const defaults = options;
-    const client = {
-        get baseURL () {
-            return defaults.baseURL ?? '';
-        },
-        async request (spec) {
-            const baseLayer = await resolveIdentityLayer(defaults);
-            const localLayer = await resolveIdentityLayer(spec.options);
-            const parent = resolveClientOptions(defaults, baseLayer);
-            const effective = resolveRequestOptions(spec.options, parent, mergeIdentityLayers(baseLayer, localLayer));
-            const url = joinUrl(effective.baseURL, spec.path) + buildQuery(spec.query);
-            const hasBody = void 0 !== spec.body;
-            const headers = hasBody ? {
-                'content-type': 'application/json',
-                ...effective.headers
-            } : effective.headers;
-            let response;
-            try {
-                response = await fetchImpl(url, {
-                    method: spec.method,
-                    headers,
-                    body: hasBody ? JSON.stringify(spec.body) : void 0,
-                    credentials: effective.credentials,
-                    signal: effective.signal
-                });
-            } catch (error) {
-                normalizeTransportError(error, effective.signal);
-            }
-            let raw;
-            try {
-                raw = await response.text();
-            } catch (error) {
-                normalizeTransportError(error, effective.signal);
-            }
-            let body;
-            if (raw.trim()) try {
-                body = JSON.parse(raw);
-            } catch  {
-                body = raw;
-            }
-            const envelope = readEnvelope(body);
-            const requestId = response.headers.get('x-request-id') ?? void 0;
-            if (!response.ok) throw new OvClientError({
-                code: envelope.error?.code ?? `HTTP_${response.status}`,
-                message: envelope.error?.message ?? response.statusText,
-                statusCode: response.status,
-                details: envelope.error?.details,
-                requestId,
-                responseBody: body
-            });
-            if ('error' === envelope.status) throw new OvClientError({
-                code: envelope.error?.code ?? 'UNKNOWN',
-                message: envelope.error?.message ?? 'Request failed',
-                statusCode: response.status,
-                details: envelope.error?.details,
-                requestId,
-                responseBody: body
-            });
-            return 'result' in envelope ? envelope.result : body;
-        }
-    };
-    return client;
-}
-const OvClientContext = /*#__PURE__*/ createContext(null);
-function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, children }) {
-    const parent = external_react_useContext(OvClientContext);
-    const value = useMemo(()=>{
-        const base = mergeProviderConfig(parent?.base, {
-            baseURL,
-            apiKey,
-            accountId,
-            userId,
-            resourceId,
-            credentials,
-            signal,
-            fetch
-        });
-        return {
-            base,
-            client: createOvClient({
-                ...base.identity,
-                baseURL: base.baseURL,
-                credentials: base.credentials,
-                signal: base.signal,
-                fetch: base.fetch
-            })
-        };
-    }, [
-        parent,
-        baseURL,
-        apiKey,
-        accountId,
-        userId,
-        resourceId,
-        credentials,
-        signal,
-        fetch
-    ]);
-    return /*#__PURE__*/ jsx(OvClientContext.Provider, {
-        value: value,
-        children: children
-    });
-}
-export { OpenVikingProvider, OvClientError, createOvClient, isOvClientError };
+export { OV_PATHS, OV_PATH_BUILDERS, OpenVikingProvider, OvClientError, createOvClient, isOvClientError } from "./1~0.js";

package/dist/components/agent-connect/style.css

@@ -1,4 +1,4 @@
-.ov-agent-connect, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__interaction {
+.ov-agent-connect, .ov-divider, .ov-file-browser, .ov-file-browser-entries, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__interaction {
   --ov-ui-primary-default: #5252ff;
   --ov-ui-primary-hover-default: #7075ff;
   --ov-ui-primary-active-default: #3833d2;
@@ -30,7 +30,7 @@
   --ov-ui-tooltip-text-default: #fff;
 }
 
-.dark .ov-agent-connect, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__interaction {
+.dark .ov-agent-connect, .dark .ov-divider, .dark .ov-file-browser, .dark .ov-file-browser-entries, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-popover, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__interaction {
   --ov-ui-primary-default: #5f5fff;
   --ov-ui-primary-hover-default: #7075ff;
   --ov-ui-primary-active-default: #4242ba;

package/dist/components/file-browser-entries/file-browser-entries-icons.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 入口条的两个图标。
+ *
+ * 路径取自控制台 `assets/context-console/` 下的 `connect-agent.svg` 与
+ * `upload.svg`，只把 `vector-effect="non-scaling-stroke"` 去掉——本包的图标按
+ * viewBox 原尺寸渲染，不需要它。描边宽度 1.4 与圆头圆角保持原值。
+ *
+ * The two icons of the entry row.
+ *
+ * The paths come from `connect-agent.svg` and `upload.svg` under the console's
+ * `assets/context-console/`; only `vector-effect="non-scaling-stroke"` is dropped,
+ * because this package renders icons at their viewBox size and does not need it.
+ * The 1.4 stroke width and the round caps and joins are kept as-is.
+ */
+/** 连接 Agent 图标，14 × 14 的插头。Connect-agent icon: a 14 × 14 plug. */
+export declare function ConnectAgentIcon(): import("react").JSX.Element;
+/** 导入资源图标，12 × 12 的方框向上箭头。Import-resources icon: a 12 × 12 box with an up arrow. */
+export declare function ImportResourcesIcon(): import("react").JSX.Element;

package/dist/components/file-browser-entries/file-browser-entries.d.ts

@@ -0,0 +1,14 @@
+import type { FileBrowserEntriesProps } from './types.js';
+export type { FileBrowserEntriesLabels, FileBrowserEntriesProps, } from './types.js';
+/**
+ * 文件浏览入口条：连接 Agent 与导入资源。
+ *
+ * 两项都省略回调时不渲染任何东西，入口条因此整块消失——宿主既没接连接也没接
+ * 导入时，留一条空白底色只会让人以为还有内容没加载出来。
+ *
+ * The file browser entry row: connect an agent, import resources.
+ *
+ * With both callbacks omitted nothing renders and the row disappears entirely —
+ * leaving an empty tinted strip would suggest something failed to load.
+ */
+export declare function FileBrowserEntries({ onConnectAgent, onImportResources, labels, className, ...rest }: FileBrowserEntriesProps): import("react").JSX.Element | null;

package/dist/components/file-browser-entries/index.d.ts

@@ -0,0 +1 @@
+export * from './file-browser-entries.js';