dsh-kenari-plugin 0.1.1

package/lib/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Kenari REST 错误词汇：[OI] 线错误信封解析、状态码 → dsh 错误码映射，
+ * 以及高频错误的**可执行建议**（模型与 UI 读到的就是这段文本）。
+ *
+ * Kenari 处于 rc 期，信封字段可能变动；解析保持宽松，缺字段不抛错。
+ * @module dsh-kenari-plugin/errors
+ */
+import { WebError } from '@deepseek-ai/dsh-web';
+/** [OI] 线错误信封：`{ error: { message, type, code, param } }`，字段缺省不报错。 */
+export interface KenariErrorEnvelope {
+    error?: {
+        message?: string;
+        type?: string;
+        code?: string;
+    };
+}
+/**
+ * 解析 Kenari 错误信封的 message，并附上该状态码的可执行建议。
+ * 非 JSON、超长或 HTML 体回退 HTTP 状态文本；调用方向：http.ts 非 2xx 时调用。
+ */
+export declare function extractKenariErrorMessage(bodyText: string, status: number): string;
+/**
+ * 把 Kenari 状态码映射为回退语义：429/408/5xx 可重试（http.ts 已内联重试），
+ * 401/402/403 等 Kenari 侧不可恢复，由 fallback 层回退兜底 provider。
+ */
+export declare function classifyKenariStatus(status: number): 'retryable' | 'fallback';
+/** 构造带 `WEB_KENARI_*` code 的 WebError，cause 保留原始错误供诊断。 */
+export declare function kenariWebError(code: string, message: string, cause?: unknown): WebError;
+//# sourceMappingURL=errors.d.ts.map

package/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAkCD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAelF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAG7E;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,CAEvF"}

package/lib/errors.js

@@ -0,0 +1,74 @@
+/**
+ * Kenari REST 错误词汇：[OI] 线错误信封解析、状态码 → dsh 错误码映射，
+ * 以及高频错误的**可执行建议**（模型与 UI 读到的就是这段文本）。
+ *
+ * Kenari 处于 rc 期，信封字段可能变动；解析保持宽松，缺字段不抛错。
+ * @module dsh-kenari-plugin/errors
+ */
+import { WebError } from '@deepseek-ai/dsh-web';
+/** 纯文本错误体的最大采纳长度（401 实测返回纯文本 `invalid key`）。 */
+const PLAIN_TEXT_LIMIT = 200;
+/**
+ * 状态码 → 可执行建议。只在能给出**具体动作**时才附上，避免正确的废话。
+ * 生成类调用超时不在此列（http.ts 已按 retryTimeouts 处理，不会走到这里）。
+ */
+function guidanceFor(status, text) {
+    if (status === 401) {
+        return '鉴权失败：确认凭据引用解析出的 key 有效（重新复制 kn-... 或新开终端让环境变量生效），并确认 base URL 形状正确（[OI]/Responses 用 https://kenari.id/v1，Anthropic 用 https://kenari.id 不带 /v1）。';
+    }
+    if (status === 402 || text.includes('insufficient_balance')) {
+        return '余额不足：改用免费模型（目录里 id 带 :free，如 step-3-7-flash:free）或充值（QRIS 最低 Rp 1.000）。';
+    }
+    if (status === 403 || text.includes('shared_key_not_allowed')) {
+        return '403：若这是分享页 key，则 balance / usage / quota 会被拒（它们读 key 所有者的账户数据），消费类工具仍可用；要读账户数字请改用自己账号的 key。';
+    }
+    if (status === 405) {
+        return '405 表示 base URL 形状错误（不是 404）：[OI]/Responses 用 https://kenari.id/v1，Anthropic 用 https://kenari.id（不带 /v1）。';
+    }
+    if (status === 413) {
+        return '请求体过大：降低图像尺寸或数量、缩短输入后重试。';
+    }
+    if (status === 422) {
+        return '参数校验失败：按响应里的取值提示修正参数。';
+    }
+    if (status === 429) {
+        return '触发限流：按 Retry-After 退避后重试；生成类调用不要因客户端超时而重试（可能重复扣费）。';
+    }
+    return undefined;
+}
+/**
+ * 解析 Kenari 错误信封的 message，并附上该状态码的可执行建议。
+ * 非 JSON、超长或 HTML 体回退 HTTP 状态文本；调用方向：http.ts 非 2xx 时调用。
+ */
+export function extractKenariErrorMessage(bodyText, status) {
+    const raw = bodyText.trim();
+    let message;
+    if (raw.length > 0) {
+        try {
+            const parsed = JSON.parse(raw);
+            message = parsed.error?.message ?? parsed.error?.code;
+        }
+        catch {
+            // 401 等返回纯文本；HTML 兜底页（未知路由）不当错误文案用
+            if (raw.length <= PLAIN_TEXT_LIMIT && !raw.startsWith('<'))
+                message = raw;
+        }
+    }
+    const base = message !== undefined && message.length > 0 ? message : `HTTP ${status}`;
+    const guidance = guidanceFor(status, base);
+    return guidance === undefined ? base : `${base} — ${guidance}`;
+}
+/**
+ * 把 Kenari 状态码映射为回退语义：429/408/5xx 可重试（http.ts 已内联重试），
+ * 401/402/403 等 Kenari 侧不可恢复，由 fallback 层回退兜底 provider。
+ */
+export function classifyKenariStatus(status) {
+    if (status === 429 || status === 408 || status >= 500)
+        return 'retryable';
+    return 'fallback';
+}
+/** 构造带 `WEB_KENARI_*` code 的 WebError，cause 保留原始错误供诊断。 */
+export function kenariWebError(code, message, cause) {
+    return new WebError(message, code, cause !== undefined ? { cause } : undefined);
+}
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAW/C,gDAAgD;AAChD,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAE5B;;;GAGG;AACH,SAAS,WAAW,CAAC,MAAc,EAAE,IAAY;IAC/C,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,iJAAiJ,CAAA;IAC1J,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC5D,OAAO,yEAAyE,CAAA;IAClF,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAC9D,OAAO,6FAA6F,CAAA;IACtG,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,2GAA2G,CAAA;IACpH,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,0BAA0B,CAAA;IACnC,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,uBAAuB,CAAA;IAChC,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,oDAAoD,CAAA;IAC7D,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,MAAc;IACxE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAA2B,CAAA;IAC/B,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAA;YACrD,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI,CAAA;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;YACnC,IAAI,GAAG,CAAC,MAAM,IAAI,gBAAgB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,GAAG,CAAA;QAC3E,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAA;IACrF,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC1C,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,QAAQ,EAAE,CAAA;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,WAAW,CAAA;IACzE,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe,EAAE,KAAe;IAC3E,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AACjF,CAAC"}

package/lib/favicon.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 浏览器侧 Kenari 图标的同源端点：`GET /api/kenari.favicon`。
+ *
+ * 为什么要有这个端点：设置面板左侧导航的图标由 dsh 的 shell 画（`navIcon(row.id)`
+ * 是写死的 id 分支），而 section 注册项只有 `{ id, order, label }`，没有图标字段——
+ * 插件加不进去。能加进去的只有 DOM，所以图标由浏览器半边自己贴（见 `client/index.js`）。
+ * 但客户端 bundle 没有打包器：loader 只读 `exports["./client"]` 这一个文件，图片引用
+ * 拿不到可用的 URL。于是图标留在 `assets/` 里，浏览器像读模型视图一样向 Host 要它。
+ *
+ * 这与模型视图补的是同一种缺口，所以走同一条路：Connection 的 Fetch 路由。
+ * `connection` 是 web profile 才有的服务；没有它的部署不会提供图标，
+ * 浏览器半边会退回 dsh 自己的齿轮图标（不贴标签就什么都不改）。
+ * @module dsh-kenari-plugin/favicon
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** 浏览器读取图标的路径（Connection 的 Fetch 路由要求落在 `/api/` 下）。 */
+export declare const KENARI_FAVICON_PATH = "/api/kenari.favicon";
+/**
+ * 注册图标路由。
+ *
+ * 无 connection 服务时静默跳过——图标只是界面装饰，插件其余能力不依赖它。
+ */
+export declare function registerFaviconRoute(ctx: Context): void;
+//# sourceMappingURL=favicon.d.ts.map

package/lib/favicon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"favicon.d.ts","sourceRoot":"","sources":["../src/favicon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,wBAAwB,CAAA;AAuCxD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CASvD"}

package/lib/favicon.js

@@ -0,0 +1,68 @@
+/**
+ * 浏览器侧 Kenari 图标的同源端点：`GET /api/kenari.favicon`。
+ *
+ * 为什么要有这个端点：设置面板左侧导航的图标由 dsh 的 shell 画（`navIcon(row.id)`
+ * 是写死的 id 分支），而 section 注册项只有 `{ id, order, label }`，没有图标字段——
+ * 插件加不进去。能加进去的只有 DOM，所以图标由浏览器半边自己贴（见 `client/index.js`）。
+ * 但客户端 bundle 没有打包器：loader 只读 `exports["./client"]` 这一个文件，图片引用
+ * 拿不到可用的 URL。于是图标留在 `assets/` 里，浏览器像读模型视图一样向 Host 要它。
+ *
+ * 这与模型视图补的是同一种缺口，所以走同一条路：Connection 的 Fetch 路由。
+ * `connection` 是 web profile 才有的服务；没有它的部署不会提供图标，
+ * 浏览器半边会退回 dsh 自己的齿轮图标（不贴标签就什么都不改）。
+ * @module dsh-kenari-plugin/favicon
+ */
+import { readFile } from 'node:fs/promises';
+/** 浏览器读取图标的路径（Connection 的 Fetch 路由要求落在 `/api/` 下）。 */
+export const KENARI_FAVICON_PATH = '/api/kenari.favicon';
+/**
+ * 图标本体：包内 `assets/kenari-favicon-128.png`（128×128）。
+ * `lib/favicon.js` 与 `src/favicon.ts` 都在包根下一层，所以 `../assets` 两条路都对。
+ */
+const FAVICON_FILE = new URL('../assets/kenari-favicon-128.png', import.meta.url);
+/** 进程内文件不会变，第二次读没有意义；失败也不缓存，下次请求还会再试。 */
+let cached;
+function faviconBytes() {
+    const pending = cached ?? readFile(FAVICON_FILE);
+    cached = pending;
+    return pending.catch((err) => {
+        cached = undefined;
+        throw err;
+    });
+}
+async function faviconResponse(request) {
+    let bytes;
+    try {
+        bytes = await faviconBytes();
+    }
+    catch (err) {
+        // 打包漏掉 assets/ 时走到这里。回 404 而不是抛错：浏览器半边据此保持
+        // dsh 自己的图标，而"图标没贴上去"不该让设置页整个坏掉。
+        const message = err instanceof Error ? err.message : String(err);
+        return Response.json({ error: message }, { status: 404 });
+    }
+    const headers = {
+        'content-type': 'image/png',
+        'content-length': String(bytes.byteLength),
+        'cache-control': 'public, max-age=86400',
+    };
+    if (request.method === 'HEAD')
+        return new Response(null, { status: 200, headers });
+    return new Response(bytes, { status: 200, headers });
+}
+/**
+ * 注册图标路由。
+ *
+ * 无 connection 服务时静默跳过——图标只是界面装饰，插件其余能力不依赖它。
+ */
+export function registerFaviconRoute(ctx) {
+    ctx.inject(['connection'], (connectionCtx) => {
+        connectionCtx.connection.fetch.register({
+            path: KENARI_FAVICON_PATH,
+            methods: ['GET', 'HEAD'],
+            requestBody: 'buffered',
+            fetch: (request) => faviconResponse(request),
+        });
+    });
+}
+//# sourceMappingURL=favicon.js.map

package/lib/favicon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"favicon.js","sourceRoot":"","sources":["../src/favicon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAK3C,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAA;AAExD;;;GAGG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,kCAAkC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAEjF,yCAAyC;AACzC,IAAI,MAAmC,CAAA;AAEvC,SAAS,YAAY;IACnB,MAAM,OAAO,GAAG,MAAM,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAA;IAChD,MAAM,GAAG,OAAO,CAAA;IAChB,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACpC,MAAM,GAAG,SAAS,CAAA;QAClB,MAAM,GAAG,CAAA;IACX,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAgB;IAC7C,IAAI,KAAa,CAAA;IACjB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,YAAY,EAAE,CAAA;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2CAA2C;QAC3C,iCAAiC;QACjC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,MAAM,OAAO,GAAG;QACd,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;QAC1C,eAAe,EAAE,uBAAuB;KACzC,CAAA;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IAClF,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,GAAG,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,EAAE;QAC3C,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;YACtC,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;YACxB,WAAW,EAAE,UAAU;YACvB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;SAC7C,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/lib/http.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Kenari HTTP 客户端：web/fetch 两条 REST 调用共用的传输层。
+ * 集中超时、重试、key 现场解析与错误信封映射；后端 rc 期端点变动只改这里。
+ * @module dsh-kenari-plugin/http
+ */
+import type { Config as PluginConfig } from './index.js';
+/** Kenari web 端点响应体：search 与 fetch 共有的计费字段之外各取所需。 */
+export interface KenariSearchResponse {
+    results?: {
+        title?: string;
+        url?: string;
+        content?: string;
+    }[];
+    id?: string;
+    cost_micro_idr?: number;
+}
+export interface KenariFetchResponse {
+    title?: string;
+    content?: string;
+    links?: string[];
+    id?: string;
+    cost_micro_idr?: number;
+}
+/** 每次操作现场解析 key（硬约束 9：禁止跨操作缓存）。 */
+export type ResolveApiKey = () => Promise<string | undefined>;
+/** 跨操作持有的运行时依赖，由 apply 装配。 */
+export interface KenariHttpDeps {
+    readonly config: PluginConfig;
+    readonly resolveApiKey: ResolveApiKey;
+    readonly logger?: {
+        warn(msg: string): void;
+        info(msg: string): void;
+    };
+}
+/** 单次请求的可选覆盖：媒体生成需要更长超时，且超时不得重试。 */
+export interface KenariRequestOptions {
+    /** 每次尝试的超时覆盖（默认取 config.timeoutMs）。 */
+    timeoutMs?: number;
+    /** 重试次数覆盖（默认取 config.maxRetries）。 */
+    retries?: number;
+    /**
+     * 尝试超时是否可重试（默认 true）。
+     * 生成类调用置 false：请求可能已在服务端完成并计费，重试有重复扣费风险。
+     */
+    retryTimeouts?: boolean;
+    /**
+     * 是否带 `Authorization: Bearer <key>` 并因此要求 key（默认 true）。
+     * 站点公开端点（套餐表等，不在 /v1 下、不需要 key）置 false：
+     * 没有 key 的部署也应该能读到它们。
+     */
+    auth?: boolean;
+}
+/**
+ * POST 一个 Kenari [OI] 线端点并解析 JSON 响应。
+ * 非法 URL → WEB_KENARI_NOT_CONFIGURED；key 缺失 → WEB_KENARI_NO_KEY；
+ * 网络失败 → WEB_KENARI_NETWORK；非 2xx → WEB_KENARI_HTTP（消息不含 key）。
+ */
+export declare function kenariPost<T>(deps: KenariHttpDeps, path: string, body: Record<string, unknown>, signal?: AbortSignal, opts?: KenariRequestOptions): Promise<T>;
+/**
+ * GET 一个 Kenari [OI] 线端点并解析 JSON 响应（quota、models 等只读端点）。
+ * 错误语义与 kenariPost 一致。
+ */
+export declare function kenariGet<T>(deps: KenariHttpDeps, path: string, query?: Record<string, string>, signal?: AbortSignal, opts?: KenariRequestOptions): Promise<T>;
+/**
+ * GET 一个 Kenari **站点**端点（绝对 URL、无 key、不补 /v1）。
+ *
+ * 与 REST 线分开的理由：这类端点（`/api/plans` 之类）是站点自己的公开路由，
+ * 既不在 `/v1` 下也不认 `Authorization`。它们的形状比 API 线宽松（官网改版即可能变），
+ * 所以调用方必须把解析失败当成可选数据缺失，而不是插件故障。
+ */
+export declare function kenariPublicGet<T>(deps: KenariHttpDeps, url: string, signal?: AbortSignal, opts?: KenariRequestOptions): Promise<T>;
+/**
+ * POST 一个 JSON 端点并把二进制响应体原样带回（audio/speech 等返回原始字节）。
+ * 返回体可能很大，调用方负责落到 attachment 存储。
+ */
+export declare function kenariPostBinary(deps: KenariHttpDeps, path: string, body: Record<string, unknown>, signal?: AbortSignal, opts?: KenariRequestOptions): Promise<{
+    bytes: Uint8Array;
+    contentType: string;
+}>;
+/**
+ * GET 一个端点并把二进制响应体原样带回（videos/{id}/content 下载）。
+ * 端点需要 key：下载 URL 带 key 访问，故与 POST 共用鉴权与超时。
+ */
+export declare function kenariGetBinary(deps: KenariHttpDeps, path: string, signal?: AbortSignal, opts?: KenariRequestOptions): Promise<{
+    bytes: Uint8Array;
+    contentType: string;
+}>;
+/**
+ * POST multipart/form-data（images/edits、audio/transcriptions）并解析 JSON 响应。
+ * fields 里的二进制值以 Uint8Array 出现，其余转为字符串。
+ */
+export declare function kenariPostMultipart<T>(deps: KenariHttpDeps, path: string, fields: Record<string, string | Uint8Array>, signal?: AbortSignal, opts?: KenariRequestOptions): Promise<T>;
+/**
+ * 调一次 Kenari MCP server 的工具（balance/usage 无 REST 端点，公开 MCP 是唯一程序化入口）。
+ * 单次 JSON-RPC，无会话（服务端是无状态模式）；isError 结果转 WEB_KENARI_HTTP。
+ */
+export declare function kenariMcpCall(deps: KenariHttpDeps, tool: string, args?: Record<string, unknown>, signal?: AbortSignal): Promise<string>;
+/**
+ * 站点端点拼装：baseURL 去掉 `/v1` 后再接路径。
+ * 用户把 baseURL 配成 `https://kenari.id/v1`（[OI] 线的标准形状），
+ * 而站点路由在裸域下，所以这里必须反向归一。
+ */
+export declare function siteEndpoint(baseURL: string | undefined, path: string): string;
+//# sourceMappingURL=http.d.ts.map

package/lib/http.d.ts.map

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

package/lib/http.js

@@ -0,0 +1,247 @@
+/**
+ * Kenari HTTP 客户端：web/fetch 两条 REST 调用共用的传输层。
+ * 集中超时、重试、key 现场解析与错误信封映射；后端 rc 期端点变动只改这里。
+ * @module dsh-kenari-plugin/http
+ */
+import { extractKenariErrorMessage, kenariWebError } from './errors.js';
+/** Kenari MCP 端点（Streamable HTTP，JSON 模式）。balance/usage 无 REST 端点，只能走这里。 */
+const MCP_ENDPOINT = 'https://kenari.id/mcp';
+/** 瞬时失败（429/408/5xx/网络错误）可重试；其余状态一次即返。 */
+function isRetryableStatus(status) {
+    return status === 429 || status === 408 || status >= 500;
+}
+/** 定时器触发的 AbortSignal 抛 TimeoutError；用它区分超时与外部取消。 */
+function isTimeoutError(err) {
+    return err instanceof Error && err.name === 'TimeoutError';
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * POST 一个 Kenari [OI] 线端点并解析 JSON 响应。
+ * 非法 URL → WEB_KENARI_NOT_CONFIGURED；key 缺失 → WEB_KENARI_NO_KEY；
+ * 网络失败 → WEB_KENARI_NETWORK；非 2xx → WEB_KENARI_HTTP（消息不含 key）。
+ */
+export async function kenariPost(deps, path, body, signal, opts) {
+    return kenariRequest(deps, 'POST', path, signal, opts, async (init, endpoint) => {
+        const response = await fetch(endpoint, {
+            ...init,
+            headers: { ...init.headers, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        return finishJson(deps, response, endpoint);
+    });
+}
+/**
+ * GET 一个 Kenari [OI] 线端点并解析 JSON 响应（quota、models 等只读端点）。
+ * 错误语义与 kenariPost 一致。
+ */
+export async function kenariGet(deps, path, query, signal, opts) {
+    const qs = query === undefined ? '' : `?${new URLSearchParams(query).toString()}`;
+    return kenariRequest(deps, 'GET', `${path}${qs}`, signal, opts, async (init, endpoint) => {
+        const response = await fetch(endpoint, init);
+        return finishJson(deps, response, endpoint);
+    });
+}
+/**
+ * GET 一个 Kenari **站点**端点（绝对 URL、无 key、不补 /v1）。
+ *
+ * 与 REST 线分开的理由：这类端点（`/api/plans` 之类）是站点自己的公开路由，
+ * 既不在 `/v1` 下也不认 `Authorization`。它们的形状比 API 线宽松（官网改版即可能变），
+ * 所以调用方必须把解析失败当成可选数据缺失，而不是插件故障。
+ */
+export async function kenariPublicGet(deps, url, signal, opts) {
+    return kenariRequest(deps, 'GET', url, signal, { ...opts, auth: false }, async (init, endpoint) => {
+        const response = await fetch(endpoint, init);
+        return finishJson(deps, response, endpoint);
+    });
+}
+/**
+ * POST 一个 JSON 端点并把二进制响应体原样带回（audio/speech 等返回原始字节）。
+ * 返回体可能很大，调用方负责落到 attachment 存储。
+ */
+export async function kenariPostBinary(deps, path, body, signal, opts) {
+    return kenariRequest(deps, 'POST', path, signal, opts, async (init, endpoint) => {
+        const response = await fetch(endpoint, {
+            ...init,
+            headers: { ...init.headers, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok)
+            throw await httpError(deps, response, endpoint);
+        return {
+            bytes: new Uint8Array(await response.arrayBuffer()),
+            contentType: response.headers.get('content-type') ?? 'application/octet-stream',
+        };
+    });
+}
+/**
+ * GET 一个端点并把二进制响应体原样带回（videos/{id}/content 下载）。
+ * 端点需要 key：下载 URL 带 key 访问，故与 POST 共用鉴权与超时。
+ */
+export async function kenariGetBinary(deps, path, signal, opts) {
+    return kenariRequest(deps, 'GET', path, signal, opts, async (init, endpoint) => {
+        const response = await fetch(endpoint, init);
+        if (!response.ok)
+            throw await httpError(deps, response, endpoint);
+        return {
+            bytes: new Uint8Array(await response.arrayBuffer()),
+            contentType: response.headers.get('content-type') ?? 'application/octet-stream',
+        };
+    });
+}
+/**
+ * POST multipart/form-data（images/edits、audio/transcriptions）并解析 JSON 响应。
+ * fields 里的二进制值以 Uint8Array 出现，其余转为字符串。
+ */
+export async function kenariPostMultipart(deps, path, fields, signal, opts) {
+    return kenariRequest(deps, 'POST', path, signal, opts, async (init, endpoint) => {
+        const form = new FormData();
+        for (const [name, value] of Object.entries(fields)) {
+            if (typeof value === 'string')
+                form.append(name, value);
+            else
+                form.append(name, new Blob([new Uint8Array(value)]), name);
+        }
+        // fetch 为 FormData 自动补 Content-Type（含 boundary），只透传鉴权头
+        const response = await fetch(endpoint, { method: 'POST', headers: { Authorization: init.headers.Authorization }, body: form, signal: init.signal });
+        return finishJson(deps, response, endpoint);
+    });
+}
+/**
+ * 调一次 Kenari MCP server 的工具（balance/usage 无 REST 端点，公开 MCP 是唯一程序化入口）。
+ * 单次 JSON-RPC，无会话（服务端是无状态模式）；isError 结果转 WEB_KENARI_HTTP。
+ */
+export async function kenariMcpCall(deps, tool, args = {}, signal) {
+    const body = {
+        jsonrpc: '2.0',
+        id: Date.now(),
+        method: 'tools/call',
+        params: { name: tool, arguments: args },
+    };
+    return kenariRequest(deps, 'POST', MCP_ENDPOINT, signal, undefined, async (init) => {
+        const response = await fetch(MCP_ENDPOINT, {
+            ...init,
+            headers: {
+                ...init.headers,
+                Accept: 'application/json, text/event-stream',
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        const payload = await finishJson(deps, response, MCP_ENDPOINT);
+        if (payload.error !== undefined) {
+            throw kenariWebError('WEB_KENARI_HTTP', `kenari: ${payload.error.message ?? 'MCP 调用失败'}`);
+        }
+        const text = (payload.result?.content ?? [])
+            .filter((block) => block.type === 'text')
+            .map((block) => block.text ?? '')
+            .join('\n');
+        if (payload.result?.isError === true) {
+            throw kenariWebError('WEB_KENARI_HTTP', `kenari: ${text || 'MCP 工具返回错误'}`);
+        }
+        return text;
+    });
+}
+/** 组装鉴权与超时的公共骨架；低层各方法只差请求体与响应解析。 */
+async function kenariRequest(deps, method, pathOrUrl, signal, opts, run) {
+    const { config } = deps;
+    // MCP 与站点端点走绝对 URL；REST 端点按 [OI] 线形状补 /v1
+    const endpoint = /^https?:\/\//i.test(pathOrUrl)
+        ? pathOrUrl
+        : restEndpoint(config.baseURL, pathOrUrl);
+    if (!URL.canParse(endpoint)) {
+        throw kenariWebError('WEB_KENARI_NOT_CONFIGURED', `kenari: baseURL 无法解析：${config.baseURL ?? ''}`);
+    }
+    // 公开站点端点不要 key：没有 key 的部署也要能读到套餐表这类数据
+    const needsKey = opts?.auth ?? true;
+    const apiKey = needsKey ? await deps.resolveApiKey() : undefined;
+    if (needsKey && (apiKey === undefined || apiKey.length === 0)) {
+        throw kenariWebError('WEB_KENARI_NO_KEY', `kenari: 凭据 ${config.apiKeyEnv ?? 'KENARI_API_KEY'} 未配置`);
+    }
+    const timeoutMs = opts?.timeoutMs ?? config.timeoutMs ?? 30_000;
+    const maxRetries = opts?.retries ?? config.maxRetries ?? 2;
+    const retryTimeouts = opts?.retryTimeouts ?? true;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        // 每次尝试独立超时：AbortSignal.any 组合外部取消与本次定时
+        const timeoutSignal = AbortSignal.timeout(timeoutMs);
+        const composed = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+        const init = {
+            method,
+            headers: apiKey === undefined ? {} : { Authorization: `Bearer ${apiKey}` },
+            signal: composed,
+        };
+        try {
+            return await run(init, endpoint);
+        }
+        catch (err) {
+            // 已包装的 WebError 上抛；标记可重试的 HTTP 状态（429/408/5xx）按退避再试
+            if (err instanceof Error && err.name === 'WebError' && 'code' in err) {
+                const retryable = err.retryable === true;
+                if (retryable && attempt < maxRetries) {
+                    lastError = err;
+                    const delayMs = err.retryDelayMs;
+                    await sleep(delayMs ?? 500 * 2 ** attempt);
+                    continue;
+                }
+                throw err;
+            }
+            // 外部取消（signal）不该被重试吞掉
+            if (signal?.aborted) {
+                throw kenariWebError('WEB_CANCELLED', 'kenari: 请求已取消', err);
+            }
+            // 尝试超时且调用方声明不可重试（生成类）→ 立即上抛，避免重复扣费
+            if (isTimeoutError(err) && !retryTimeouts) {
+                throw kenariWebError('WEB_KENARI_TIMEOUT', `kenari: 请求超时（${timeoutMs}ms），生成类调用不自动重试以免重复计费`, err);
+            }
+            lastError = err;
+            if (attempt < maxRetries) {
+                await sleep(500 * 2 ** attempt);
+                continue;
+            }
+            throw kenariWebError('WEB_KENARI_NETWORK', `kenari: 网络请求失败：${String(lastError)}`, lastError);
+        }
+    }
+    // 循环正常退出必然经过 throw；此处只为类型收敛
+    throw kenariWebError('WEB_KENARI_NETWORK', 'kenari: 请求失败', lastError);
+}
+/** [OI] 线 REST 端点拼装：用户配根域时补 /v1，配错形状报 405 的坑在这里消解。 */
+function restEndpoint(baseURL, path) {
+    const base = baseURL ?? 'https://kenari.id';
+    const baseTrimmed = base.replace(/\/+$/, '');
+    return baseTrimmed.endsWith('/v1') ? `${baseTrimmed}${path}` : `${baseTrimmed}/v1${path}`;
+}
+/**
+ * 站点端点拼装：baseURL 去掉 `/v1` 后再接路径。
+ * 用户把 baseURL 配成 `https://kenari.id/v1`（[OI] 线的标准形状），
+ * 而站点路由在裸域下，所以这里必须反向归一。
+ */
+export function siteEndpoint(baseURL, path) {
+    const base = (baseURL ?? 'https://kenari.id').replace(/\/+$/, '');
+    const bare = base.endsWith('/v1') ? base.slice(0, -3) : base;
+    return `${bare}${path}`;
+}
+/** 2xx → 解析 JSON；否则按错误信封抛 WEB_KENARI_HTTP。 */
+async function finishJson(deps, response, endpoint) {
+    if (!response.ok)
+        throw await httpError(deps, response, endpoint);
+    return (await response.json());
+}
+/** 非 2xx → 解析 Kenari 错误信封成 WebError（消息不含 key）；429/408/5xx 标记可重试。 */
+async function httpError(deps, response, endpoint) {
+    const bodyText = await response.text().catch(() => '');
+    const message = extractKenariErrorMessage(bodyText, response.status);
+    const err = kenariWebError('WEB_KENARI_HTTP', `kenari: ${message}`, undefined);
+    // 记录端点便于诊断（不含 key）
+    deps.logger?.warn(`kenari: ${endpoint} → HTTP ${response.status}`);
+    if (isRetryableStatus(response.status)) {
+        err.retryable = true;
+        const ra = response.headers.get('retry-after');
+        if (ra !== null && Number.isFinite(Number(ra))) {
+            err.retryDelayMs = Number(ra) * 1000;
+        }
+    }
+    return err;
+}
+//# sourceMappingURL=http.js.map

package/lib/http.js.map

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