@scotthuang/openclaw-bytedance 0.1.0

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

@@ -0,0 +1,314 @@
+import { createProviderHttpError, formatProviderHttpErrorMessage, readProviderJsonResponse, } from "openclaw/plugin-sdk/provider-http";
+import { buildSearchCacheKey, formatCliCommand, mergeScopedSearchConfig, readCachedSearchPayload, readConfiguredSecretString, readNumberParam, readStringParam, resolveProviderWebSearchPluginConfig, resolveSearchCacheTtlMs, resolveSearchTimeoutSeconds, resolveSiteName, withTrustedWebSearchEndpoint, wrapWebContent, writeCachedSearchPayload, } from "openclaw/plugin-sdk/provider-web-search";
+import { SEARCH_TRAFFIC_TAG, buildArkEndpoint, resolveArkSearchApiKey, resolveArkSearchBaseUrl, } from "./credentials.js";
+import { formatErr, log } from "./logger.js";
+/**
+ * ByteDance (Volcengine Ark) web-search provider runtime.
+ *
+ * Backed by Volcengine's "AskEcho Search Infinity" service, which is the same
+ * search engine the official `mcp_server_askecho_search_infinity` MCP server
+ * wraps. This is the search backend bundled with Agent Plan / Harness.
+ *
+ *   POST https://open.feedcoopapi.com/search_api/web_search
+ *   Authorization: Bearer <ARK_SEARCH_API_KEY>
+ *   Content-Type: application/json
+ *   X-Traffic-Tag: ark_mcp_server_<tag>
+ *   { "Query": "...", "SearchType": "web", "Count": 10, "NeedSummary": true,
+ *     "TimeRange": "OneDay|OneWeek|OneMonth|OneYear|YYYY-MM-DD..YYYY-MM-DD",
+ *     "Filter": { "AuthInfoLevel": 0|1 } }
+ *
+ * Note: Search requires its **own** API key, separate from the chat key:
+ *   - Vision/chat key  → ARK_API_KEY  → Authorization for /api/plan/v3/*
+ *   - Search       key → ARK_SEARCH_API_KEY (alias: ASK_ECHO_SEARCH_INFINITY_API_KEY)
+ */
+const SEARCH_PATH = "/search_api/web_search";
+const TIME_RANGE_SHORTCUTS = new Set([
+    "OneDay",
+    "OneWeek",
+    "OneMonth",
+    "OneYear",
+]);
+const DATE_RANGE_PATTERN = /^(\d{4}-\d{2}-\d{2})\.\.(\d{4}-\d{2}-\d{2})$/;
+const MAX_QUERY_LENGTH = 100;
+const MAX_WEB_COUNT = 50;
+const DEFAULT_COUNT = 5;
+function readSearchType(value) {
+    if (value === "web" || value === "image")
+        return value;
+    return undefined;
+}
+function truncate(text, max) {
+    if (typeof text !== "string")
+        return "";
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+function resolveSearchType(args, searchConfig) {
+    return (readSearchType(args.searchType) ??
+        readSearchType(args.search_type) ??
+        readSearchType(searchConfig?.searchType) ??
+        "web");
+}
+function resolveAuthLevel(args) {
+    const v = args.authLevel ?? args.auth_level;
+    if (v === 1 || v === "1")
+        return 1;
+    return 0;
+}
+function readTimeRange(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    if (TIME_RANGE_SHORTCUTS.has(trimmed))
+        return trimmed;
+    const match = DATE_RANGE_PATTERN.exec(trimmed);
+    if (!match) {
+        throw new Error(`Invalid timeRange '${trimmed}'. Use OneDay/OneWeek/OneMonth/OneYear or YYYY-MM-DD..YYYY-MM-DD.`);
+    }
+    const start = new Date(match[1]);
+    const end = new Date(match[2]);
+    if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {
+        throw new Error(`Invalid date in timeRange '${trimmed}'.`);
+    }
+    if (start > end) {
+        throw new Error(`timeRange start date must not be after end date.`);
+    }
+    return trimmed;
+}
+function clampCount(count, searchType) {
+    const raw = typeof count === "number" && Number.isFinite(count) ? Math.floor(count) : DEFAULT_COUNT;
+    const max = searchType === "web" ? MAX_WEB_COUNT : 5;
+    if (raw < 1)
+        return 1;
+    if (raw > max)
+        return max;
+    return raw;
+}
+function buildPayload(req) {
+    const payload = {
+        Query: req.Query,
+        SearchType: req.SearchType,
+        Count: req.Count,
+    };
+    if (req.SearchType === "web") {
+        payload.NeedSummary = true;
+        if (req.Filter)
+            payload.Filter = req.Filter;
+        if (req.TimeRange)
+            payload.TimeRange = req.TimeRange;
+    }
+    return payload;
+}
+function normalizeReference(raw) {
+    const url = typeof raw.Url === "string" && raw.Url.length > 0 ? raw.Url : undefined;
+    if (!url)
+        return undefined;
+    const title = typeof raw.Title === "string" ? raw.Title : "";
+    // Snippet is short; Summary is the longer model-generated abstract.
+    const description = typeof raw.Snippet === "string" ? raw.Snippet : "";
+    const summary = typeof raw.Summary === "string" && raw.Summary.length > 0 ? raw.Summary : undefined;
+    return {
+        title: title ? wrapWebContent(title, "web_search") : "",
+        url,
+        description: description ? wrapWebContent(description, "web_search") : "",
+        summary: summary ? wrapWebContent(summary, "web_search") : undefined,
+        published: typeof raw.PublishTime === "string" ? raw.PublishTime : undefined,
+        siteName: (typeof raw.SiteName === "string" && raw.SiteName.length > 0
+            ? raw.SiteName
+            : resolveSiteName(url)) || undefined,
+    };
+}
+function extractReferences(payload, searchType, count) {
+    const list = searchType === "image" ? payload.Result?.ImageResults : payload.Result?.WebResults;
+    if (!Array.isArray(list))
+        return [];
+    const out = [];
+    for (const raw of list) {
+        const ref = normalizeReference(raw);
+        if (ref)
+            out.push(ref);
+        if (out.length >= count)
+            break;
+    }
+    return out;
+}
+async function runAskEchoSearch(params) {
+    const endpoint = buildArkEndpoint(params.baseUrl, SEARCH_PATH);
+    log.debug(`web_search: POST ${endpoint} type=${params.body.SearchType} count=${params.body.Count} ` +
+        `timeRange=${params.body.TimeRange ?? "-"} authLevel=${params.body.Filter?.AuthInfoLevel ?? 0} ` +
+        `query="${truncate(params.body.Query, 80)}" timeoutSec=${params.timeoutSeconds}`);
+    const startedAt = Date.now();
+    return withTrustedWebSearchEndpoint({
+        url: endpoint,
+        timeoutSeconds: params.timeoutSeconds,
+        init: {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${params.apiKey}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                "X-Traffic-Tag": SEARCH_TRAFFIC_TAG,
+            },
+            body: JSON.stringify(buildPayload(params.body)),
+        },
+    }, async (res) => {
+        const elapsed = Date.now() - startedAt;
+        if (!res.ok) {
+            log.warn(`web_search: HTTP ${res.status} from ${endpoint} after ${elapsed}ms ` +
+                `(query="${truncate(params.body.Query, 60)}")`);
+            throw await createProviderHttpError(res, "Volcengine Ark Web Search error");
+        }
+        let data;
+        try {
+            data = await readProviderJsonResponse(res, "Volcengine Ark Web Search error");
+        }
+        catch (err) {
+            log.error(`web_search: malformed JSON from ${endpoint} after ${elapsed}ms: ${formatErr(err)}`);
+            throw err;
+        }
+        if (data.error?.message) {
+            log.warn(`web_search: provider returned error envelope (code=${data.error.code ?? "?"}, ` +
+                `type=${data.error.type ?? "?"}): ${truncate(data.error.message, 200)}`);
+            throw new Error(formatProviderHttpErrorMessage({
+                label: "Volcengine Ark Web Search error",
+                status: typeof data.error.code === "number" ? data.error.code : 0,
+                detail: data.error.message,
+            }));
+        }
+        const resultsLen = Array.isArray(params.body.SearchType === "image" ? data.Result?.ImageResults : data.Result?.WebResults)
+            ? (params.body.SearchType === "image"
+                ? data.Result.ImageResults.length
+                : data.Result.WebResults.length)
+            : 0;
+        log.debug(`web_search: HTTP 200 in ${elapsed}ms requestId=${data.ResponseMetadata?.RequestId ?? "-"} ` +
+            `rawResults=${resultsLen}`);
+        return data;
+    });
+}
+function missingApiKeyPayload() {
+    return {
+        error: "missing_ark_search_api_key",
+        message: `web_search (bytedance) needs a Volcengine Ark Harness search key. ` +
+            `Set ARK_SEARCH_API_KEY (or ASK_ECHO_SEARCH_INFINITY_API_KEY) in the environment, ` +
+            `or run \`${formatCliCommand("openclaw configure --section web")}\` to store it. ` +
+            `Get a key from the Volcengine console (Agent Plan → 使用配置 → 配置 Harness → 联网 API Key).`,
+        docs: "https://www.volcengine.com/docs/82379/2301412",
+    };
+}
+export async function executeByteDanceWebSearchProviderTool(ctx, args) {
+    const invokeStartedAt = Date.now();
+    const searchConfig = mergeScopedSearchConfig(ctx.searchConfig, "bytedance", resolveProviderWebSearchPluginConfig(ctx.config, "bytedance"), { mirrorApiKeyToTopLevel: true });
+    const explicitApiKey = readConfiguredSecretString(searchConfig?.apiKey, "tools.web.search.apiKey");
+    const apiKey = resolveArkSearchApiKey(explicitApiKey);
+    if (!apiKey) {
+        log.warn("web_search: missing ARK_SEARCH_API_KEY (and no plugins.entries.bytedance.config.webSearch.apiKey); " +
+            "returning structured missing_ark_search_api_key payload");
+        return missingApiKeyPayload();
+    }
+    const baseUrl = resolveArkSearchBaseUrl(searchConfig?.baseUrl);
+    // Validate query
+    const queryRaw = readStringParam(args, "query", { required: true });
+    const query = queryRaw.trim();
+    if (query.length === 0) {
+        log.warn("web_search: rejected empty query");
+        throw new Error("query must not be empty");
+    }
+    if (query.length > MAX_QUERY_LENGTH) {
+        log.warn(`web_search: rejected oversize query (len=${query.length}, max=${MAX_QUERY_LENGTH})`);
+        throw new Error(`query length must be 1-${MAX_QUERY_LENGTH} characters`);
+    }
+    const searchType = resolveSearchType(args, searchConfig);
+    const requestedCount = readNumberParam(args, "count", { integer: true });
+    const count = clampCount(requestedCount ?? searchConfig?.maxResults, searchType);
+    let timeRange;
+    try {
+        timeRange =
+            readTimeRange(args.timeRange) ??
+                readTimeRange(args.time_range) ??
+                readTimeRange(searchConfig?.timeRange);
+    }
+    catch (err) {
+        log.warn(`web_search: invalid timeRange parameter: ${formatErr(err)}`);
+        throw err;
+    }
+    const authLevel = resolveAuthLevel(args);
+    const filter = authLevel > 0 ? { AuthInfoLevel: authLevel } : undefined;
+    log.debug(`web_search: invoke type=${searchType} count=${count} requested=${requestedCount ?? "-"} ` +
+        `timeRange=${timeRange ?? "-"} authLevel=${authLevel} baseUrl=${baseUrl} ` +
+        `query="${truncate(query, 80)}"`);
+    const cacheKey = buildSearchCacheKey([
+        "bytedance",
+        baseUrl,
+        searchType,
+        query,
+        count,
+        timeRange ?? "",
+        authLevel,
+    ]);
+    const cached = readCachedSearchPayload(cacheKey);
+    if (cached) {
+        log.debug(`web_search: cache hit (key=${cacheKey.slice(0, 16)}…) skipping HTTP for query="${truncate(query, 60)}"`);
+        return cached;
+    }
+    const start = Date.now();
+    const timeoutSeconds = resolveSearchTimeoutSeconds(searchConfig);
+    const cacheTtlMs = resolveSearchCacheTtlMs(searchConfig);
+    let data;
+    try {
+        data = await runAskEchoSearch({
+            apiKey,
+            baseUrl,
+            body: {
+                Query: query,
+                SearchType: searchType,
+                Count: count,
+                NeedSummary: searchType === "web" ? true : undefined,
+                TimeRange: timeRange,
+                Filter: filter,
+            },
+            timeoutSeconds,
+        });
+    }
+    catch (err) {
+        log.error(`web_search: request failed after ${Date.now() - start}ms ` +
+            `(query="${truncate(query, 60)}"): ${formatErr(err)}`);
+        throw err;
+    }
+    const references = extractReferences(data, searchType, count);
+    const tookMs = Date.now() - start;
+    const payload = {
+        query,
+        provider: "bytedance",
+        searchType,
+        count: references.length,
+        tookMs,
+        requestId: data.ResponseMetadata?.RequestId,
+        externalContent: {
+            untrusted: true,
+            source: "web_search",
+            provider: "bytedance",
+            wrapped: true,
+        },
+        results: references,
+    };
+    if (timeRange)
+        payload.timeRange = timeRange;
+    writeCachedSearchPayload(cacheKey, payload, cacheTtlMs);
+    log.info(`web_search: ok type=${searchType} returned=${references.length}/${count} ` +
+        `tookMs=${tookMs} totalMs=${Date.now() - invokeStartedAt} ` +
+        `requestId=${data.ResponseMetadata?.RequestId ?? "-"} ` +
+        `query="${truncate(query, 60)}"`);
+    return payload;
+}
+export const __testing = {
+    resolveSearchType,
+    resolveAuthLevel,
+    readTimeRange,
+    clampCount,
+    buildPayload,
+    normalizeReference,
+    extractReferences,
+    SEARCH_PATH,
+};
+//# sourceMappingURL=bytedance-web-search-provider.runtime.js.map

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

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

package/dist/src/credentials.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared credential / endpoint resolution for the ByteDance (Volcengine Ark) plugin.
+ *
+ * This plugin uses the **Volcengine Ark Agent Plan** product surface, which has
+ * two independent API surfaces:
+ *
+ * 1. **Vision (image understanding)** — OpenAI-compatible Chat Completions:
+ *      Endpoint: ${ARK_BASE_URL}/chat/completions
+ *      Auth:     Authorization: Bearer ${ARK_API_KEY}
+ *      Default:  https://ark.cn-beijing.volces.com/api/plan/v3
+ *
+ * 2. **Web search (Harness "AskEcho Search Infinity")** — separate service
+ *    with its own quota and its own API key:
+ *      Endpoint: ${ARK_SEARCH_BASE_URL}/search_api/web_search
+ *      Auth:     Authorization: Bearer ${ARK_SEARCH_API_KEY}
+ *      Default:  https://open.feedcoopapi.com
+ *
+ * Both keys are read at runtime from configuration or environment variables
+ * — this plugin **never bundles any credentials**.
+ */
+export declare const DEFAULT_ARK_BASE_URL = "https://ark.cn-beijing.volces.com/api/plan/v3";
+export declare const ARK_API_KEY_ENV_VARS: readonly ["ARK_API_KEY", "VOLCENGINE_API_KEY"];
+export declare const ARK_BASE_URL_ENV_VARS: readonly ["ARK_BASE_URL", "VOLCENGINE_BASE_URL"];
+export declare const DEFAULT_ARK_SEARCH_BASE_URL = "https://open.feedcoopapi.com";
+export declare const ARK_SEARCH_API_KEY_ENV_VARS: readonly ["ARK_SEARCH_API_KEY", "ASK_ECHO_SEARCH_INFINITY_API_KEY", "VOLCENGINE_SEARCH_API_KEY"];
+export declare const ARK_SEARCH_BASE_URL_ENV_VARS: readonly ["ARK_SEARCH_BASE_URL"];
+export declare const DEFAULT_VISION_MODEL = "doubao-seed-2.0-pro";
+export declare const SEARCH_TRAFFIC_TAG = "ark_mcp_server_openclaw_bytedance";
+/** Resolve the Ark API key from (in order): explicit override → env vars. */
+export declare function resolveArkApiKey(explicit?: unknown): string | undefined;
+/** Resolve the Ark Base URL with fallback to env vars and the built-in default. */
+export declare function resolveArkBaseUrl(explicit?: unknown): string;
+/** Resolve the AskEcho Search Infinity API key. */
+export declare function resolveArkSearchApiKey(explicit?: unknown): string | undefined;
+/** Resolve the AskEcho Search Infinity base URL. */
+export declare function resolveArkSearchBaseUrl(explicit?: unknown): string;
+/**
+ * Build a full endpoint URL for an Ark API path (e.g. `/responses`,
+ * `/chat/completions`). Path must begin with a leading slash.
+ */
+export declare function buildArkEndpoint(baseUrl: string, path: string): string;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/src/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,eAAO,MAAM,oBAAoB,kDAAkD,CAAC;AACpF,eAAO,MAAM,oBAAoB,gDAAiD,CAAC;AACnF,eAAO,MAAM,qBAAqB,kDAAmD,CAAC;AAItF,eAAO,MAAM,2BAA2B,iCAAiC,CAAC;AAC1E,eAAO,MAAM,2BAA2B,kGAM9B,CAAC;AACX,eAAO,MAAM,4BAA4B,kCAAmC,CAAC;AAI7E,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAK1D,eAAO,MAAM,kBAAkB,sCAAsC,CAAC;AA+BtE,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAI5D;AAID,mDAAmD;AACnD,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAIlE;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtE"}

package/dist/src/credentials.js

@@ -0,0 +1,93 @@
+/**
+ * Shared credential / endpoint resolution for the ByteDance (Volcengine Ark) plugin.
+ *
+ * This plugin uses the **Volcengine Ark Agent Plan** product surface, which has
+ * two independent API surfaces:
+ *
+ * 1. **Vision (image understanding)** — OpenAI-compatible Chat Completions:
+ *      Endpoint: ${ARK_BASE_URL}/chat/completions
+ *      Auth:     Authorization: Bearer ${ARK_API_KEY}
+ *      Default:  https://ark.cn-beijing.volces.com/api/plan/v3
+ *
+ * 2. **Web search (Harness "AskEcho Search Infinity")** — separate service
+ *    with its own quota and its own API key:
+ *      Endpoint: ${ARK_SEARCH_BASE_URL}/search_api/web_search
+ *      Auth:     Authorization: Bearer ${ARK_SEARCH_API_KEY}
+ *      Default:  https://open.feedcoopapi.com
+ *
+ * Both keys are read at runtime from configuration or environment variables
+ * — this plugin **never bundles any credentials**.
+ */
+// --- Vision / chat-completions ------------------------------------------
+export const DEFAULT_ARK_BASE_URL = "https://ark.cn-beijing.volces.com/api/plan/v3";
+export const ARK_API_KEY_ENV_VARS = ["ARK_API_KEY", "VOLCENGINE_API_KEY"];
+export const ARK_BASE_URL_ENV_VARS = ["ARK_BASE_URL", "VOLCENGINE_BASE_URL"];
+// --- Web search (AskEcho Search Infinity) -------------------------------
+export const DEFAULT_ARK_SEARCH_BASE_URL = "https://open.feedcoopapi.com";
+export const ARK_SEARCH_API_KEY_ENV_VARS = [
+    "ARK_SEARCH_API_KEY",
+    // Match the variable name used by Volcengine's official MCP server, so
+    // existing Harness setups can drop in without renaming.
+    "ASK_ECHO_SEARCH_INFINITY_API_KEY",
+    "VOLCENGINE_SEARCH_API_KEY",
+];
+export const ARK_SEARCH_BASE_URL_ENV_VARS = ["ARK_SEARCH_BASE_URL"];
+// --- Defaults -----------------------------------------------------------
+export const DEFAULT_VISION_MODEL = "doubao-seed-2.0-pro";
+// "Traffic tag" header value used by the official Volcengine MCP server to
+// identify the calling tool. We follow the same convention so search-side
+// dashboards can attribute traffic to this plugin.
+export const SEARCH_TRAFFIC_TAG = "ark_mcp_server_openclaw_bytedance";
+// --- Helpers ------------------------------------------------------------
+function readEnv(names) {
+    for (const name of names) {
+        const raw = process.env[name];
+        if (typeof raw === "string") {
+            const trimmed = raw.trim();
+            if (trimmed.length > 0) {
+                return trimmed;
+            }
+        }
+    }
+    return undefined;
+}
+function readString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function stripTrailingSlashes(s) {
+    return s.replace(/\/+$/, "");
+}
+// --- Public resolvers (vision/chat) -------------------------------------
+/** Resolve the Ark API key from (in order): explicit override → env vars. */
+export function resolveArkApiKey(explicit) {
+    return readString(explicit) ?? readEnv(ARK_API_KEY_ENV_VARS);
+}
+/** Resolve the Ark Base URL with fallback to env vars and the built-in default. */
+export function resolveArkBaseUrl(explicit) {
+    return stripTrailingSlashes(readString(explicit) ?? readEnv(ARK_BASE_URL_ENV_VARS) ?? DEFAULT_ARK_BASE_URL);
+}
+// --- Public resolvers (search) ------------------------------------------
+/** Resolve the AskEcho Search Infinity API key. */
+export function resolveArkSearchApiKey(explicit) {
+    return readString(explicit) ?? readEnv(ARK_SEARCH_API_KEY_ENV_VARS);
+}
+/** Resolve the AskEcho Search Infinity base URL. */
+export function resolveArkSearchBaseUrl(explicit) {
+    return stripTrailingSlashes(readString(explicit) ?? readEnv(ARK_SEARCH_BASE_URL_ENV_VARS) ?? DEFAULT_ARK_SEARCH_BASE_URL);
+}
+// --- URL builder --------------------------------------------------------
+/**
+ * Build a full endpoint URL for an Ark API path (e.g. `/responses`,
+ * `/chat/completions`). Path must begin with a leading slash.
+ */
+export function buildArkEndpoint(baseUrl, path) {
+    if (!path.startsWith("/")) {
+        throw new Error(`Ark API path must start with '/': got ${path}`);
+    }
+    return `${stripTrailingSlashes(baseUrl)}${path}`;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/src/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/credentials.ts"],"names":[],"mappings":"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"}

package/dist/src/logger.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Module-level logger for the openclaw-bytedance plugin.
+ *
+ * The OpenClaw host hands the plugin a `PluginLogger` only at `register(api)`
+ * time. Provider plugins (web search / media understanding) are plain data
+ * objects whose runtime methods are invoked later by the host without a
+ * logger argument, so we capture the host logger at registration time and
+ * expose it through this module to the runtime files.
+ *
+ * Design:
+ *   - Default is a no-op so unit tests / direct imports never crash.
+ *   - `setPluginLogger(api.logger)` is called from `index.ts` register().
+ *   - All log lines are prefixed with `[bytedance] ...` to match OpenClaw's
+ *     extension convention (matches `extensions/voice-call`,
+ *     `extensions/memory-core`, etc).
+ *   - `debug` is optional on `PluginLogger`, so we forward it through `?.`
+ *     and silently drop debug lines when the host did not wire a debug sink.
+ */
+/** Minimal subset of openclaw's PluginLogger we depend on. */
+export interface PluginLoggerLike {
+    debug?: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+}
+/** Inject the host-provided logger. Called once from `index.ts#register`. */
+export declare function setPluginLogger(logger: PluginLoggerLike | undefined): void;
+/** Reset to no-op (useful for tests). */
+export declare function resetPluginLogger(): void;
+export declare const log: {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+};
+/**
+ * Format an error/exception consistently for log output.
+ * Keeps it short (no stack flood) while preserving useful detail.
+ */
+export declare function formatErr(err: unknown): string;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAaD,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAE1E;AAED,yCAAyC;AACzC,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAMD,eAAO,MAAM,GAAG;mBACC,MAAM,GAAG,IAAI;kBAGd,MAAM,GAAG,IAAI;kBAGb,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;CAG7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAU9C"}

package/dist/src/logger.js

@@ -0,0 +1,69 @@
+/**
+ * Module-level logger for the openclaw-bytedance plugin.
+ *
+ * The OpenClaw host hands the plugin a `PluginLogger` only at `register(api)`
+ * time. Provider plugins (web search / media understanding) are plain data
+ * objects whose runtime methods are invoked later by the host without a
+ * logger argument, so we capture the host logger at registration time and
+ * expose it through this module to the runtime files.
+ *
+ * Design:
+ *   - Default is a no-op so unit tests / direct imports never crash.
+ *   - `setPluginLogger(api.logger)` is called from `index.ts` register().
+ *   - All log lines are prefixed with `[bytedance] ...` to match OpenClaw's
+ *     extension convention (matches `extensions/voice-call`,
+ *     `extensions/memory-core`, etc).
+ *   - `debug` is optional on `PluginLogger`, so we forward it through `?.`
+ *     and silently drop debug lines when the host did not wire a debug sink.
+ */
+const PREFIX = "[bytedance]";
+const NOOP_LOGGER = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+let activeLogger = NOOP_LOGGER;
+/** Inject the host-provided logger. Called once from `index.ts#register`. */
+export function setPluginLogger(logger) {
+    activeLogger = logger ?? NOOP_LOGGER;
+}
+/** Reset to no-op (useful for tests). */
+export function resetPluginLogger() {
+    activeLogger = NOOP_LOGGER;
+}
+function withPrefix(message) {
+    return `${PREFIX} ${message}`;
+}
+export const log = {
+    debug(message) {
+        activeLogger.debug?.(withPrefix(message));
+    },
+    info(message) {
+        activeLogger.info(withPrefix(message));
+    },
+    warn(message) {
+        activeLogger.warn(withPrefix(message));
+    },
+    error(message) {
+        activeLogger.error(withPrefix(message));
+    },
+};
+/**
+ * Format an error/exception consistently for log output.
+ * Keeps it short (no stack flood) while preserving useful detail.
+ */
+export function formatErr(err) {
+    if (err instanceof Error) {
+        return err.message ? `${err.name}: ${err.message}` : err.name;
+    }
+    if (typeof err === "string")
+        return err;
+    try {
+        return JSON.stringify(err);
+    }
+    catch {
+        return String(err);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH,MAAM,MAAM,GAAG,aAAa,CAAC;AAE7B,MAAM,WAAW,GAAqB;IACpC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF,IAAI,YAAY,GAAqB,WAAW,CAAC;AAEjD,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,MAAoC;IAClE,YAAY,GAAG,MAAM,IAAI,WAAW,CAAC;AACvC,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,iBAAiB;IAC/B,YAAY,GAAG,WAAW,CAAC;AAC7B,CAAC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,CAAC,OAAe;QACnB,YAAY,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,OAAe;QACnB,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/src/media-understanding-provider.d.ts

@@ -0,0 +1,3 @@
+import type { MediaUnderstandingProvider } from "openclaw/plugin-sdk/media-understanding";
+export declare const bytedanceMediaUnderstandingProvider: MediaUnderstandingProvider;
+//# sourceMappingURL=media-understanding-provider.d.ts.map

package/dist/src/media-understanding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-understanding-provider.d.ts","sourceRoot":"","sources":["../../src/media-understanding-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,0BAA0B,EAC3B,MAAM,yCAAyC,CAAC;AA6ZjD,eAAO,MAAM,mCAAmC,EAAE,0BAOjD,CAAC"}