@scotthuang/openclaw-bytedance 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 openclaw-bytedance contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,222 @@
+# @scotthuang/openclaw-bytedance
+
+> OpenClaw plugin for **ByteDance Volcengine Ark** — adds two tools to your OpenClaw agent:
+>
+> 1. **Web Search** — via Volcengine Ark Harness ("AskEcho Search Infinity"), the same backend the official `volcengine/mcp-server` package wraps
+> 2. **Image Understanding** — via Doubao multimodal models (default: `doubao-seed-2.0-pro`)
+
+This plugin is open-source and **never bundles any API key**. You configure your own credentials via environment variables or the OpenClaw config file.
+
+---
+
+## Features
+
+| Capability         | Backend                                                        | Default Model           |
+| ------------------ | -------------------------------------------------------------- | ----------------------- |
+| Web Search         | `POST open.feedcoopapi.com/search_api/web_search`              | (no model — direct API) |
+| Image Understanding| `POST {ARK_BASE_URL}/chat/completions` (Agent Plan)            | `doubao-seed-2.0-pro`   |
+
+The web-search tool returns **titles, URLs, snippets, AI-generated summaries, publish dates, and site names** — wrapped in OpenClaw's untrusted-content envelope so prompts stay safe.
+
+---
+
+## Two API keys, by design
+
+Volcengine Ark splits chat/vision and search across two products with separate quotas. The plugin reflects that:
+
+| Capability          | Env var                                  | Console location                                      |
+| ------------------- | ---------------------------------------- | ----------------------------------------------------- |
+| Vision / chat       | `ARK_API_KEY`                            | Agent Plan → API Key 管理                              |
+| Web search          | `ARK_SEARCH_API_KEY` (or `ASK_ECHO_SEARCH_INFINITY_API_KEY`) | Agent Plan → 使用配置 → 配置 Harness → 联网 API Key |
+
+You can configure either, both, or neither. Tools whose key is missing return a clear "missing key" error.
+
+---
+
+## Installation
+
+End users (let OpenClaw install it from npm):
+
+```bash
+# inside your OpenClaw config / extension manager
+# add @scotthuang/openclaw-bytedance to the plugins list
+```
+
+Or globally:
+
+```bash
+npm install -g @scotthuang/openclaw-bytedance
+```
+
+Local development:
+
+```bash
+git clone https://github.com/scotthuang/openclaw-bytedance.git ~/github/openclaw-bytedance
+cd ~/github/openclaw-bytedance
+npm install
+# Link a local OpenClaw checkout for type resolution + tests
+# (override OPENCLAW_REPO if it lives somewhere other than ../openclaw)
+npm run setup:openclaw
+npm run build
+```
+
+---
+
+## Configuration
+
+### Env vars (most users)
+
+```bash
+# Vision / chat (Agent Plan)
+export ARK_API_KEY="ark-xxxxxxxxxxxx"
+# Optional override (default: https://ark.cn-beijing.volces.com/api/plan/v3)
+# export ARK_BASE_URL="..."
+
+# Web search (Harness AskEcho Search Infinity)
+export ARK_SEARCH_API_KEY="<your-harness-search-key>"
+# Optional override (default: https://open.feedcoopapi.com)
+# export ARK_SEARCH_BASE_URL="..."
+```
+
+Aliases also accepted:
+
+| Primary               | Aliases (lower priority)                                              |
+| --------------------- | --------------------------------------------------------------------- |
+| `ARK_API_KEY`         | `VOLCENGINE_API_KEY`                                                  |
+| `ARK_BASE_URL`        | `VOLCENGINE_BASE_URL`                                                 |
+| `ARK_SEARCH_API_KEY`  | `ASK_ECHO_SEARCH_INFINITY_API_KEY`, `VOLCENGINE_SEARCH_API_KEY`       |
+
+### OpenClaw config file (alternative)
+
+```toml
+[plugins.entries.bytedance.config.webSearch]
+# apiKey = "<harness-search-key>"  # falls back to ARK_SEARCH_API_KEY
+# baseUrl = "https://open.feedcoopapi.com"
+searchType = "web"               # or "image"
+
+[plugins.entries.bytedance.config.vision]
+# apiKey = "ark-..."              # falls back to ARK_API_KEY
+# baseUrl = "..."                 # falls back to ARK_BASE_URL
+model = "doubao-seed-2.0-pro"
+```
+
+---
+
+## Tool surface
+
+### `web_search` (ByteDance / Volcengine Ark Harness)
+
+| Field        | Type           | Description                                                                                                  |
+| ------------ | -------------- | ------------------------------------------------------------------------------------------------------------ |
+| `query`      | string (req'd) | 1–100 characters                                                                                             |
+| `count`      | number         | Web: 1–50, Image: 1–5. Defaults to 5                                                                         |
+| `searchType` | enum           | `web` (default) or `image`                                                                                   |
+| `timeRange`  | string         | `OneDay` / `OneWeek` / `OneMonth` / `OneYear`, or `YYYY-MM-DD..YYYY-MM-DD` (web only)                        |
+| `authLevel`  | 0 \| 1         | 0 = default, 1 = only highly authoritative sources (web only)                                                |
+
+**Response** (abridged):
+
+```jsonc
+{
+  "query": "OpenClaw",
+  "provider": "bytedance",
+  "searchType": "web",
+  "count": 3,
+  "tookMs": 315,
+  "requestId": "202605160209109A2F527379DE92B5997E",
+  "results": [
+    {
+      "title": "<wrapped: OpenClaw 入驻微博...>",
+      "url": "https://...",
+      "description": "<wrapped: snippet>",
+      "summary": "<wrapped: longer model-generated summary>",
+      "published": "2026-03-04T08:27:25+08:00",
+      "siteName": "中华网"
+    }
+  ],
+  "externalContent": { "untrusted": true, "source": "web_search", "provider": "bytedance", "wrapped": true }
+}
+```
+
+### Image Understanding (auto-invoked by OpenClaw media pipeline)
+
+The plugin sends each image as a base64 data URL inside an OpenAI-compatible multimodal user message and returns the model's textual description.
+
+Supported MIME types: `image/png`, `image/jpeg`, `image/webp`, `image/gif`. Unknown types fall back to `image/jpeg`.
+
+The image must be at least **14×14 pixels** (Volcengine Ark service-side requirement).
+
+---
+
+## Security notes
+
+- **No bundled credentials.** Keys are resolved at runtime from config or env vars only.
+- **Untrusted-content envelope.** All web-fetched titles, snippets, and summaries are wrapped via OpenClaw's `wrapWebContent` helper.
+- **Trusted endpoints.** HTTP requests go through OpenClaw's `withTrustedWebSearchEndpoint` (private-network egress blocked).
+- **Search-key separation.** Vision and search keys are separate so users can revoke one without affecting the other.
+- **Traffic tag.** Search requests carry `X-Traffic-Tag: ark_mcp_server_openclaw_bytedance`, matching the Volcengine MCP convention so traffic is attributable.
+
+---
+
+## Development
+
+### Run unit tests
+
+```bash
+pnpm install
+pnpm test         # vitest run, all suites
+pnpm test:watch
+```
+
+Pure unit tests (no network):
+
+- `credentials.test.ts` — env-var fallback chains for both keys (vision + search)
+- `bytedance-web-search-provider.runtime.test.ts` — payload builder, time-range validation, count clamping, response parsing
+- `media-understanding-provider.test.ts` — request shape (data URL, image_url block, max_tokens), error handling, model selection from cfg
+
+The `vitest.config.ts` aliases `openclaw/plugin-sdk/*` to a local OpenClaw checkout. Set `OPENCLAW_REPO=/path/to/openclaw` to override the default `~/github/openclaw`.
+
+### Compare against MiniMax (live API)
+
+```bash
+ARK_API_KEY=ark-... \
+ARK_SEARCH_API_KEY=<harness-search-key> \
+MINIMAX_CODE_PLAN_KEY=sk-cp-... \
+MINIMAX_API_HOST=https://api.minimaxi.com \
+QUERY="OpenClaw 是什么开源项目" \
+COUNT=3 \
+pnpm run compare
+```
+
+Modes:
+
+```bash
+pnpm run compare          # search + vision
+pnpm run compare:search
+pnpm run compare:vision   # set IMAGE_PATH=./img.png or IMAGE_URL=https://...
+```
+
+The runner hits both providers in parallel and prints latency, result count, summaries, and full descriptions.
+
+#### Real-world result (May 2026)
+
+| Test                     | ByteDance                                                          | MiniMax                                          |
+| ------------------------ | ------------------------------------------------------------------ | ------------------------------------------------ |
+| Search "OpenClaw"        | **315 ms**, 3 results + 3 AI summaries + SiteName + PublishTime    | 642 ms, 3 results, snippet only                  |
+| Vision (32×32 red shape) | 4759 ms, 199 chars, **correctly identifies circle**                | 3631 ms, 84 chars, identifies as square          |
+
+ByteDance Search wins on latency, summary quality, and metadata richness. MiniMax VL wins on vision latency. Doubao 2.0 Pro produces longer, more accurate vision descriptions on small images.
+
+---
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+## Links
+
+- Volcengine Ark Agent Plan: <https://www.volcengine.com/activity/agentplan>
+- Harness web search docs: <https://www.volcengine.com/docs/82379/2301412>
+- Official MCP server (search backend reference): <https://github.com/volcengine/mcp-server>
+- Image understanding docs: <https://www.volcengine.com/docs/82379/1362931>
+- Doubao Seed 2.0 series: <https://www.volcengine.com/docs/82379/1330310>

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginConfigSchema;
+    register: NonNullable<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition["register"]>;
+} & Pick<import("openclaw/plugin-sdk/plugin-entry").OpenClawPluginDefinition, "kind" | "reload" | "nodeHostCommands" | "securityAuditCollectors">;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;AAMA,wBAgBG"}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { createByteDanceWebSearchProvider } from "./src/bytedance-web-search-provider.js";
+import { setPluginLogger } from "./src/logger.js";
+import { bytedanceMediaUnderstandingProvider } from "./src/media-understanding-provider.js";
+export default definePluginEntry({
+    id: "bytedance",
+    name: "ByteDance (Volcengine Ark)",
+    description: "OpenClaw plugin for ByteDance Volcengine Ark: web search via Responses API and image understanding via Doubao-Seed-2.0-pro.",
+    register(api) {
+        setPluginLogger(api.logger);
+        api.logger.info("[bytedance] register: installing web-search + media-understanding providers (id=bytedance)");
+        api.registerWebSearchProvider(createByteDanceWebSearchProvider());
+        api.registerMediaUnderstandingProvider(bytedanceMediaUnderstandingProvider);
+        api.logger.info("[bytedance] register: providers installed (vision-default=doubao-seed-2.0-pro, search-tag=ark_mcp_server_openclaw_bytedance)");
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAE5F,eAAe,iBAAiB,CAAC;IAC/B,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,6HAA6H;IAC/H,QAAQ,CAAC,GAAG;QACV,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,4FAA4F,CAC7F,CAAC;QACF,GAAG,CAAC,yBAAyB,CAAC,gCAAgC,EAAE,CAAC,CAAC;QAClE,GAAG,CAAC,kCAAkC,CAAC,mCAAmC,CAAC,CAAC;QAC5E,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,8HAA8H,CAC/H,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/src/bytedance-web-search-provider.d.ts

@@ -0,0 +1,3 @@
+import { type WebSearchProviderPlugin } from "openclaw/plugin-sdk/provider-web-search-config-contract";
+export declare function createByteDanceWebSearchProvider(): WebSearchProviderPlugin;
+//# sourceMappingURL=bytedance-web-search-provider.d.ts.map

package/dist/src/bytedance-web-search-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytedance-web-search-provider.d.ts","sourceRoot":"","sources":["../../src/bytedance-web-search-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,yDAAyD,CAAC;AAyEjE,wBAAgB,gCAAgC,IAAI,uBAAuB,CA4B1E"}

package/dist/src/bytedance-web-search-provider.js

@@ -0,0 +1,92 @@
+import { createWebSearchProviderContractFields, } from "openclaw/plugin-sdk/provider-web-search-config-contract";
+/**
+ * ByteDance (Volcengine Ark) web-search provider.
+ *
+ * Backend: Volcengine "AskEcho Search Infinity" — the same search service
+ * the official `mcp_server_askecho_search_infinity` MCP server wraps and
+ * which Agent Plan / Harness bundles as a service plan add-on.
+ *
+ * Two distinct API keys are involved in this plugin overall:
+ *   1. ARK_API_KEY        — for chat-completions / vision (doubao-seed-2.0-pro)
+ *   2. ARK_SEARCH_API_KEY — for the search service (this provider)
+ * The two are intentionally separate so users can revoke / scope them
+ * independently. Either or both may be set.
+ *
+ * Search credential resolution order:
+ *   1. plugins.entries.bytedance.config.webSearch.apiKey
+ *   2. ARK_SEARCH_API_KEY
+ *   3. ASK_ECHO_SEARCH_INFINITY_API_KEY  (matches the official MCP server)
+ *   4. VOLCENGINE_SEARCH_API_KEY
+ */
+const BYTEDANCE_CREDENTIAL_PATH = "plugins.entries.bytedance.config.webSearch.apiKey";
+const BYTEDANCE_SEARCH_ENV_VARS = [
+    "ARK_SEARCH_API_KEY",
+    "ASK_ECHO_SEARCH_INFINITY_API_KEY",
+    "VOLCENGINE_SEARCH_API_KEY",
+];
+let runtimePromise;
+function loadRuntime() {
+    runtimePromise ??= import("./bytedance-web-search-provider.runtime.js");
+    return runtimePromise;
+}
+const ByteDanceSearchSchema = {
+    type: "object",
+    properties: {
+        query: {
+            type: "string",
+            description: "Search query string. 1-100 characters. Should be focused and natural-language.",
+            minLength: 1,
+            maxLength: 100,
+        },
+        count: {
+            type: "number",
+            description: "Number of results to return (web: 1-50, image: 1-5). Defaults to 5.",
+            minimum: 1,
+            maximum: 50,
+        },
+        searchType: {
+            type: "string",
+            enum: ["web", "image"],
+            description: "Type of search: web pages or images. Defaults to 'web'.",
+        },
+        timeRange: {
+            type: "string",
+            description: "Restrict to recent results. One of: OneDay | OneWeek | OneMonth | OneYear, or a date range 'YYYY-MM-DD..YYYY-MM-DD'. Web search only.",
+        },
+        authLevel: {
+            type: "number",
+            enum: [0, 1],
+            description: "Authority filter: 0 = default (no filter), 1 = only highly authoritative sources. Web search only.",
+        },
+    },
+    required: ["query"],
+};
+export function createByteDanceWebSearchProvider() {
+    return {
+        id: "bytedance",
+        label: "ByteDance Volcengine Search",
+        hint: "Web search via Volcengine Ark Harness (AskEcho Search Infinity)",
+        onboardingScopes: ["text-inference"],
+        credentialLabel: "Volcengine Ark Harness search API key",
+        envVars: [...BYTEDANCE_SEARCH_ENV_VARS],
+        placeholder: "<harness-search-key>",
+        signupUrl: "https://www.volcengine.com/activity/agentplan",
+        docsUrl: "https://www.volcengine.com/docs/82379/2301412",
+        autoDetectOrder: 30,
+        credentialPath: BYTEDANCE_CREDENTIAL_PATH,
+        ...createWebSearchProviderContractFields({
+            credentialPath: BYTEDANCE_CREDENTIAL_PATH,
+            searchCredential: { type: "top-level" },
+            configuredCredential: { pluginId: "bytedance" },
+        }),
+        createTool: (ctx) => ({
+            description: "Search the web (or images) using Volcengine Ark Harness. Returns titles, URLs, snippets, summaries, and publish dates.",
+            parameters: ByteDanceSearchSchema,
+            execute: async (args) => {
+                const { executeByteDanceWebSearchProviderTool } = await loadRuntime();
+                return await executeByteDanceWebSearchProviderTool(ctx, args);
+            },
+        }),
+    };
+}
+//# sourceMappingURL=bytedance-web-search-provider.js.map

package/dist/src/bytedance-web-search-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytedance-web-search-provider.js","sourceRoot":"","sources":["../../src/bytedance-web-search-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,GAEtC,MAAM,yDAAyD,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,yBAAyB,GAAG,mDAAmD,CAAC;AACtF,MAAM,yBAAyB,GAAG;IAChC,oBAAoB;IACpB,kCAAkC;IAClC,2BAA2B;CACnB,CAAC;AAIX,IAAI,cAA8D,CAAC;AAEnE,SAAS,WAAW;IAClB,cAAc,KAAK,MAAM,CAAC,4CAA4C,CAAC,CAAC;IACxE,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,qBAAqB,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gFAAgF;YAC7F,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,GAAG;SACf;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qEAAqE;YAClF,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE;SACZ;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;YACtB,WAAW,EAAE,yDAAyD;SACvE;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uIAAuI;SAC1I;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACZ,WAAW,EACT,oGAAoG;SACvG;KACF;IACD,QAAQ,EAAE,CAAC,OAAO,CAAC;CACc,CAAC;AAEpC,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,iEAAiE;QACvE,gBAAgB,EAAE,CAAC,gBAAgB,CAAC;QACpC,eAAe,EAAE,uCAAuC;QACxD,OAAO,EAAE,CAAC,GAAG,yBAAyB,CAAC;QACvC,WAAW,EAAE,sBAAsB;QACnC,SAAS,EAAE,+CAA+C;QAC1D,OAAO,EAAE,+CAA+C;QACxD,eAAe,EAAE,EAAE;QACnB,cAAc,EAAE,yBAAyB;QACzC,GAAG,qCAAqC,CAAC;YACvC,cAAc,EAAE,yBAAyB;YACzC,gBAAgB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;YACvC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE;SAChD,CAAC;QACF,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACpB,WAAW,EACT,wHAAwH;YAC1H,UAAU,EAAE,qBAAqB;YACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,EAAE,qCAAqC,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;gBACtE,OAAO,MAAM,qCAAqC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChE,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/src/bytedance-web-search-provider.runtime.d.ts

@@ -0,0 +1,71 @@
+import { type SearchConfigRecord } from "openclaw/plugin-sdk/provider-web-search";
+type SearchType = "web" | "image";
+type AskEchoWebSearchRequest = {
+    Query: string;
+    SearchType: SearchType;
+    Count: number;
+    NeedSummary?: boolean;
+    TimeRange?: string;
+    Filter?: {
+        AuthInfoLevel?: number;
+    };
+};
+type AskEchoSearchResult = {
+    Id?: string;
+    SortId?: number;
+    Title?: string;
+    Snippet?: string;
+    SiteName?: string;
+    Url?: string;
+    Summary?: string;
+    Content?: string;
+    PublishTime?: string;
+    LogoUrl?: string;
+    RankScore?: number;
+};
+type AskEchoSearchResponse = {
+    ResponseMetadata?: {
+        RequestId?: string;
+    };
+    Result?: {
+        ResultCount?: number;
+        WebResults?: AskEchoSearchResult[];
+        ImageResults?: AskEchoSearchResult[];
+    };
+    error?: {
+        message?: string;
+        code?: string | number;
+        type?: string;
+    };
+};
+type ExtractedReference = {
+    title: string;
+    url: string;
+    description: string;
+    summary?: string;
+    published?: string;
+    siteName?: string;
+};
+declare function resolveSearchType(args: Record<string, unknown>, searchConfig: SearchConfigRecord | undefined): SearchType;
+declare function resolveAuthLevel(args: Record<string, unknown>): 0 | 1;
+declare function readTimeRange(value: unknown): string | undefined;
+declare function clampCount(count: number | undefined, searchType: SearchType): number;
+declare function buildPayload(req: AskEchoWebSearchRequest): Record<string, unknown>;
+declare function normalizeReference(raw: AskEchoSearchResult): ExtractedReference | undefined;
+declare function extractReferences(payload: AskEchoSearchResponse, searchType: SearchType, count: number): ExtractedReference[];
+export declare function executeByteDanceWebSearchProviderTool(ctx: {
+    config?: Record<string, unknown>;
+    searchConfig?: SearchConfigRecord;
+}, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare const __testing: {
+    resolveSearchType: typeof resolveSearchType;
+    resolveAuthLevel: typeof resolveAuthLevel;
+    readTimeRange: typeof readTimeRange;
+    clampCount: typeof clampCount;
+    buildPayload: typeof buildPayload;
+    normalizeReference: typeof normalizeReference;
+    extractReferences: typeof extractReferences;
+    SEARCH_PATH: string;
+};
+export {};
+//# sourceMappingURL=bytedance-web-search-provider.runtime.d.ts.map

package/dist/src/bytedance-web-search-provider.runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytedance-web-search-provider.runtime.d.ts","sourceRoot":"","sources":["../../src/bytedance-web-search-provider.runtime.ts"],"names":[],"mappings":"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"}