@dsh-ft/dsh-fft-ftshare 0.0.0-stage → 0.3.0

package/lib/catalog.js

@@ -0,0 +1,60 @@
+/**
+ * 目录（catalog）：上游接口的**全量快照**，回答「上游有什么」。
+ *
+ * 与接口表（`capabilities.ts`，回答「我们承接什么」）不是一回事。目录由
+ * `scripts/build-catalog.mjs` 从 `tools/list` 生成，随包发布两份产物：
+ * `catalog.json`（完整，含 `description` 与 `inputSchema`）与 `catalog.txt`
+ * （一线索引，供模型 `grep`）。本模块只做纯函数——查名字、读必填入参——因此宿主
+ * 与浏览器两侧都能用；读文件的那一半在 `catalog-host.ts`。
+ * @module @dsh-ft/dsh-fft-ftshare/catalog
+ */
+/** 判断一个值是不是可当对象读的记录。 */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * 把任意解析结果收敛成目录。字段缺失的条目直接丢掉而不是留半条：目录是准入判据，
+ * 半条会让「在目录里」这个断言变得没有意义。
+ * @param value - `catalog.json` 的解析结果。
+ * @returns 目录；形状不对时为空目录。
+ */
+export function asCatalog(value) {
+    const raw = isRecord(value) && Array.isArray(value.entries) ? value.entries : [];
+    const entries = [];
+    for (const entry of raw) {
+        if (!isRecord(entry) || typeof entry.name !== 'string' || entry.name === '')
+            continue;
+        entries.push({
+            name: entry.name,
+            title: typeof entry.title === 'string' && entry.title !== '' ? entry.title : entry.name,
+            ...typeof entry.description === 'string' && entry.description !== '' ? { description: entry.description } : {},
+            ...entry.inputSchema !== undefined ? { inputSchema: entry.inputSchema } : {},
+        });
+    }
+    return { entries };
+}
+/**
+ * 按接口名查目录。
+ * @param catalog - 目录。
+ * @param name - 上游接口名。
+ * @returns 条目；不在目录里时 undefined。
+ */
+export function catalogEntryOf(catalog, name) {
+    return catalog.entries.find(entry => entry.name === name);
+}
+/**
+ * 读出上游 `inputSchema.required` 里、这次调用没有给的入参名。
+ *
+ * 只查「有没有给」，不查类型与取值：本地能确定说出口的只有缺席，类型判断留给上游，
+ * 免得把「上游其实能容忍的写法」判成错误。
+ * @param entry - 目录条目。
+ * @param args - 本次调用入参。
+ * @returns 缺席的必填入参名，按 schema 顺序。
+ */
+export function missingRequiredArgs(entry, args) {
+    const schema = entry.inputSchema;
+    if (!isRecord(schema) || !Array.isArray(schema.required))
+        return [];
+    return schema.required.filter((name) => typeof name === 'string' && (args === undefined || args[name] === undefined || args[name] === null));
+}
+//# sourceMappingURL=catalog.js.map

package/lib/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,wBAAwB;AACxB,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IAChF,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE;YAAE,SAAQ;QACrF,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI;YACvF,GAAG,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;YAC9G,GAAG,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;SAC7E,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAA;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,IAAY;IAC3D,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAmB,EAAE,IAAyC;IAChG,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAA;IAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAA;IACnE,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CACrD,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;AACxG,CAAC"}

package/lib/client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 浏览器助手：造一个与宿主**同名同形**的 `ftshareData`（**消费方自己挂**）。
+ *
+ * ```ts
+ * ctx.provide('ftshareData', createFtshareClient({ catalog, fetch: window.fetch.bind(window) }))
+ * ```
+ *
+ * 面板因此与宿主消费方写法一致：`state === 'denied'` 显示「去升级」，
+ * `state === 'empty'` 才是「没有数据」。两处刻意的差别（设计 §5.2）：
+ *
+ * - **可调集合是目录全量**，不是模型那张策展接口表 —— 面板不受提示词预算约束；
+ * - **发现靠本地 `search()`**，是对目录的纯函数，不发网络。
+ *
+ * 这个模块是**只读子集**：不碰凭据、不碰网关地址、不维护接口表。它只认两样输入——
+ * 随包的目录与被注入的 `fetch`；`@dsh-ft/dsh-fft-ftshare/route` 与网关常量都不在这里的
+ * 依赖里，`scripts/test-crossplane.mjs` 会 grep 产物把这条钉住。
+ * @module @dsh-ft/dsh-fft-ftshare/client
+ */
+import { type CatalogEntry } from './catalog.js';
+import { type FtshareDataService } from './contract.js';
+/** 浏览器侧可用的 `fetch` 子集；测试直接注入假实现。 */
+export type FtshareFetch = (input: string, init: RequestInit) => Promise<Response>;
+/** 客户端服务的调用选项。 */
+export interface FtshareClientOptions {
+    /** 随包目录（`catalog.json` 的解析结果），决定哪些接口可调。 */
+    catalog: unknown;
+    /** 同源 fetch；浏览器传 `window.fetch.bind(window)`。 */
+    fetch: FtshareFetch;
+    /** 路由覆盖，默认 {@link FTSHARE_DATA_ROUTE}。 */
+    route?: string;
+    /** 成功结果的缓存时长；`denied` 与失败从不缓存。 */
+    ttlMs?: number;
+    /** 时钟，测试用来固定 `source.fetchedAt`。 */
+    now?: () => Date;
+}
+/** 客户端服务：与 {@link FtshareDataService} 同名同形，另加一个本地检索。 */
+export interface FtshareClientService extends FtshareDataService {
+    /**
+     * 在目录里本地检索（纯函数，不发网络）。
+     * @param query - 关键词，大小写不敏感；空串返回前 `limit` 条。
+     * @param limit - 最多返回条数，默认 20。
+     * @returns 命中的目录条目。
+     */
+    search(query: string, limit?: number): CatalogEntry[];
+}
+/**
+ * 造一个客户端 `ftshareData`。
+ * @param options - 见 {@link FtshareClientOptions}。
+ * @returns 与宿主同名同形的服务，外加本地 `search()`。
+ */
+export declare function createFtshareClient(options: FtshareClientOptions): FtshareClientService;
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAgE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAC9G,OAAO,EAA8F,KAAK,kBAAkB,EAA4C,MAAM,eAAe,CAAA;AAE7L,oCAAoC;AACpC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAElF,kBAAkB;AAClB,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,KAAK,EAAE,YAAY,CAAA;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAA;CACtD;AAmBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CA6FvF"}

package/lib/client.js

@@ -0,0 +1,149 @@
+/**
+ * 浏览器助手：造一个与宿主**同名同形**的 `ftshareData`（**消费方自己挂**）。
+ *
+ * ```ts
+ * ctx.provide('ftshareData', createFtshareClient({ catalog, fetch: window.fetch.bind(window) }))
+ * ```
+ *
+ * 面板因此与宿主消费方写法一致：`state === 'denied'` 显示「去升级」，
+ * `state === 'empty'` 才是「没有数据」。两处刻意的差别（设计 §5.2）：
+ *
+ * - **可调集合是目录全量**，不是模型那张策展接口表 —— 面板不受提示词预算约束；
+ * - **发现靠本地 `search()`**，是对目录的纯函数，不发网络。
+ *
+ * 这个模块是**只读子集**：不碰凭据、不碰网关地址、不维护接口表。它只认两样输入——
+ * 随包的目录与被注入的 `fetch`；`@dsh-ft/dsh-fft-ftshare/route` 与网关常量都不在这里的
+ * 依赖里，`scripts/test-crossplane.mjs` 会 grep 产物把这条钉住。
+ * @module @dsh-ft/dsh-fft-ftshare/client
+ */
+import { asCatalog, catalogEntryOf, missingRequiredArgs } from './catalog.js';
+import { FTSHARE_DATA_ROUTE } from './contract.js';
+/** 默认缓存时长：面板会连点，一次调用不值得重复出站；`denied` 例外。 */
+const DEFAULT_TTL_MS = 60_000;
+/** 默认检索条数上限。 */
+const DEFAULT_SEARCH_LIMIT = 20;
+/** 传输层失败（断网、超时、非 2xx、解析失败）统一落的结局。 */
+const TRANSPORT_FAILURE = 'failed';
+/** 四态集合；客户端只认这四个，别的一律当形状不符。 */
+const STATES = new Set(['available', 'empty', 'denied', 'failed']);
+/** 判断一个值是不是可当对象读的记录。 */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * 造一个客户端 `ftshareData`。
+ * @param options - 见 {@link FtshareClientOptions}。
+ * @returns 与宿主同名同形的服务，外加本地 `search()`。
+ */
+export function createFtshareClient(options) {
+    const catalog = asCatalog(options.catalog);
+    const route = options.route ?? FTSHARE_DATA_ROUTE;
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    const now = options.now ?? (() => new Date());
+    const send = options.fetch;
+    const cache = new Map();
+    /** 本地就能定的失败：`source` 用客户端时钟，其余字段与宿主同形。 */
+    const failure = (code, message, retryable = false) => ({
+        ok: false,
+        state: TRANSPORT_FAILURE,
+        rows: [],
+        notice: { code, message, retryable },
+        source: { name: 'FTShare', fetchedAt: now().toISOString() },
+    });
+    /** 收敛远端返回；形状不对一律 undefined（由调用方落成 failed）。 */
+    const asCallResult = (value) => {
+        if (!isRecord(value))
+            return undefined;
+        const state = value.state;
+        if (typeof state !== 'string' || !STATES.has(state))
+            return undefined;
+        if (typeof value.ok !== 'boolean' || !Array.isArray(value.rows))
+            return undefined;
+        if (!isRecord(value.source))
+            return undefined;
+        const notice = value.notice;
+        const normalized = {
+            ok: value.ok,
+            state: state,
+            rows: value.rows.filter(isRecord),
+            source: value.source,
+            ...isRecord(notice) && typeof notice.code === 'string' && typeof notice.message === 'string'
+                ? { notice: { ...notice, retryable: notice.retryable === true } }
+                : {},
+        };
+        return normalized;
+    };
+    return {
+        async call(interfaceName, args = {}, callOptions) {
+            const entry = catalogEntryOf(catalog, interfaceName);
+            if (entry === undefined) {
+                return failure('unknown_interface', `接口 ${interfaceName} 不在 FTShare 目录里，不能调用`);
+            }
+            const missing = missingRequiredArgs(entry, args);
+            if (missing.length > 0)
+                return failure('missing_arguments', `缺必填入参：${missing.join('、')}`);
+            const key = `${interfaceName} ${JSON.stringify(args)}`;
+            const hit = cache.get(key);
+            if (hit !== undefined && Date.now() - hit.at < ttlMs)
+                return hit.result;
+            try {
+                const response = await send(route, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json' },
+                    body: JSON.stringify({ interface: interfaceName, args }),
+                    ...callOptions?.signal === undefined ? {} : { signal: callOptions.signal },
+                });
+                if (!response.ok) {
+                    const detail = await readErrorBody(response);
+                    // 非 2xx 一律 failed：面板只需要一种方式渲染「取数失败」。
+                    return failure(detail?.code ?? `http_${response.status}`, detail?.message ?? `FTShare 取数失败（HTTP ${response.status}）`, true);
+                }
+                const result = asCallResult(await response.json());
+                if (result === undefined)
+                    return failure('invalid_response', 'FTShare 底座返回的形状不对，无法渲染');
+                // denied 不缓存：用户可能正好在另一个标签页里改了订阅或 Key。
+                if (result.state !== 'denied')
+                    cache.set(key, { at: Date.now(), result });
+                return result;
+            }
+            catch (error) {
+                return failure('transport_failed', `FTShare 取数失败：${error instanceof Error ? error.message : String(error)}`, true);
+            }
+        },
+        async listTools() {
+            // 面板不需要为清单再跑一趟网络：目录就是清单。
+            return catalog.entries.map(entry => ({
+                tool: entry.name,
+                title: entry.title,
+                ...entry.description !== undefined ? { description: entry.description } : {},
+                ...entry.inputSchema !== undefined ? { inputSchema: entry.inputSchema } : {},
+            }));
+        },
+        search(query, limit = DEFAULT_SEARCH_LIMIT) {
+            const needle = query.trim().toLowerCase();
+            const matched = needle === ''
+                ? catalog.entries
+                : catalog.entries.filter(entry => entry.name.toLowerCase().includes(needle)
+                    || entry.title.toLowerCase().includes(needle)
+                    || (entry.description ?? '').toLowerCase().includes(needle));
+            return matched.slice(0, Math.max(0, limit));
+        },
+    };
+}
+/** 读路由的错误信封；读不出来就返回 undefined，由调用方给通用措辞。 */
+async function readErrorBody(response) {
+    try {
+        const body = await response.json();
+        if (!isRecord(body) || !isRecord(body.error))
+            return undefined;
+        const code = typeof body.error.code === 'string' ? body.error.code : undefined;
+        const message = typeof body.error.message === 'string' ? body.error.message : undefined;
+        if (code === undefined || message === undefined)
+            return undefined;
+        return { code, message };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

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

package/lib/contract.d.ts

@@ -0,0 +1,122 @@
+/**
+ * `@dsh-ft/dsh-fft-ftshare/contract` —— FTShare 公用底座的冻结契约。
+ *
+ * 消费方只需要 `import type { FtshareDataService } from '@dsh-ft/dsh-fft-ftshare/contract'`，
+ * 不依赖本包的实现、传输层或 MCP SDK。本模块只有类型与常量，没有运行时依赖，
+ * 因此宿主插件与测试都能安全引用。
+ *
+ * 设计要点是 **四态归一**：FTShare 网关把「真的没有数据」「套餐无权限（403
+ * route_not_allowed）」「取数失败」三种情况都表现为「空」，调用方若只判断空数组就
+ * 会把「无权限」误读成「没有数据」。{@link FtshareCallResult.state} 强制区分这四种
+ * 结局，并把权限提示挂在 {@link FtshareCallResult.notice} 上。
+ * @module @dsh-ft/dsh-fft-ftshare/contract
+ */
+/** 服务在 cordis `Context` 上的名字，也是 `ctx.provide` 的键。 */
+export declare const FTSHARE_DATA_SERVICE: "ftshareData";
+/**
+ * 跨平面通路的精确路由：浏览器侧的 `createFtshareClient` POST 到这里，宿主侧的
+ * `registerFtshareRoute` 在这里应答。走 `connection.fetch` 的 `/api` 载体，因此
+ * Host/Origin 围栏与浏览器鉴权由载体负责。
+ */
+export declare const FTSHARE_DATA_ROUTE: "/api/ftshare-data";
+/** 用户可升级订阅的页面，{@link FtshareNotice.upgradeUrl} 的默认值。 */
+export declare const FTSHARE_UPGRADE_URL: "https://ftai.chat/me/profile?tab=subscription";
+/**
+ * 一次取数的四态结局。
+ *
+ * - `available`：调用成功且至少返回了一行；
+ * - `empty`：调用成功但确实没有数据；
+ * - `denied`：上游拒绝（API Key 无效或套餐未开通该接口，HTTP 403
+ *   route_not_allowed / capability_limited）—— **不是**「没有数据」；
+ * - `failed`：连接、超时、参数或上游 5xx 等其他失败。
+ */
+export type FtshareCallState = 'available' | 'empty' | 'denied' | 'failed';
+/**
+ * 四态归一后的取数结果。
+ *
+ * 形状已冻结：字段只增不改，消费方按需读取。
+ */
+export interface FtshareCallResult {
+    /**
+     * 调用是否走通到「上游给出了答复」这一步：`available` 与 `empty` 为真，
+     * `denied` 与 `failed` 为假。它回答的是「通道是否可用」，不回答「有没有数据」——
+     * 后者看 {@link state}。把两者分开是有意的：只有 `empty` 才允许下游说
+     * 「没有数据」。
+     */
+    ok: boolean;
+    /** 四态结局，见 {@link FtshareCallState}。 */
+    state: FtshareCallState;
+    /** 归一后的明细行；`available` 之外通常为空数组，绝不是权限判断依据。 */
+    rows: Record<string, unknown>[];
+    /** 需要向用户/模型解释的异常，权限与失败各有措辞；成功时为 undefined。 */
+    notice?: FtshareNotice;
+    /** 取数来源与时点，用于在报告里给出处。 */
+    source: FtshareSource;
+}
+/** 面向用户/模型的异常说明。 */
+export interface FtshareNotice {
+    /** 上游或本包归一后的错误码，如 `route_not_allowed`、`capability_limited`。 */
+    code: string;
+    /** 中文说明，可直接展示。 */
+    message: string;
+    /** 建议订阅档位（Free/Basic/Advanced/Pro），由接口版本推断，属提示而非断言。 */
+    requiredPlan?: string;
+    /** 升级入口。 */
+    upgradeUrl?: string;
+    /** 是否值得原样重试：限流、超时、网络失败为真；权限与参数错误为假。 */
+    retryable: boolean;
+}
+/** 取数来源与时点。 */
+export interface FtshareSource {
+    name: 'FTShare';
+    /** ISO-8601 取数时点。 */
+    fetchedAt: string;
+}
+/** 单次调用的可选项。 */
+export interface FtshareCallOptions {
+    /** 调用方取消信号；已取消时立刻抛出/返回 `failed`，不发起连接。 */
+    signal?: AbortSignal;
+}
+/** 上游 FTShare MCP 网关暴露的一个工具。 */
+export interface FtshareToolInfo {
+    /** 上游工具名，例如 `ft_v1_finance_income`。 */
+    tool: string;
+    /** 上游标题；上游未提供时回落为工具名。 */
+    title: string;
+    /** 上游说明原文；随包目录的两份产物都由它生成。 */
+    description?: string;
+    /** 上游入参 JSON Schema 原文；`ftshare_call` 的本地预校验用它。 */
+    inputSchema?: unknown;
+}
+/**
+ * `ctx.ftshareData`：FTShare 取数的唯一入口。
+ *
+ * 实现由本包的宿主入口（裸包名 `@dsh-ft/dsh-fft-ftshare`）`provide`，且必须挂在
+ * **全局平面**：preset 内的 `provide` 会直接抛
+ * `Preset services require isolate realms`（`agent-preset-registry` 的
+ * `mount.ts`），而加上 isolate 之后服务会变成 preset 私有，preset 之外的插件再也
+ * inject 不到。消费方因此统一用 `inject: ['ftshareData']` 声明依赖。
+ */
+export interface FtshareDataService {
+    /**
+     * 调一个上游 FTShare 接口并把结果归一成 {@link FtshareCallResult}。
+     * @param interfaceName - 上游接口名，例如 `ft_v1_finance_income`。
+     * @param args - 上游接口入参，原样透传。
+     * @param options - 取消信号等。
+     * @returns 归一后的结果；本方法不抛异常，权限与失败都走 `state`/`notice`。
+     */
+    call(interfaceName: string, args?: Record<string, unknown>, options?: FtshareCallOptions): Promise<FtshareCallResult>;
+    /**
+     * 上游当前可用的接口清单（名字、标题、说明、入参 schema）。
+     *
+     * 自己触发拉取并做短 TTL 缓存：不依赖「先调通一次」才有人填缓存。上游不可达时
+     * 返回上一次的清单，没有则返回空数组——清单是增强信息，不该让取数失败。
+     */
+    listTools(): Promise<readonly FtshareToolInfo[]>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        ftshareData: FtshareDataService;
+    }
+}
+//# sourceMappingURL=contract.d.ts.map

package/lib/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,EAAG,aAAsB,CAAA;AAE1D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAG,mBAA4B,CAAA;AAE9D,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,EAAG,+CAAwD,CAAA;AAE3F;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE1E;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,EAAE,EAAE,OAAO,CAAA;IACX,uCAAuC;IACvC,KAAK,EAAE,gBAAgB,CAAA;IACvB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,yBAAyB;IACzB,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,oBAAoB;AACpB,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,eAAe;AACf,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACrH;;;;;OAKG;IACH,SAAS,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAA;CACjD;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,WAAW,EAAE,kBAAkB,CAAA;KAChC;CACF"}

package/lib/contract.js

@@ -0,0 +1,24 @@
+/**
+ * `@dsh-ft/dsh-fft-ftshare/contract` —— FTShare 公用底座的冻结契约。
+ *
+ * 消费方只需要 `import type { FtshareDataService } from '@dsh-ft/dsh-fft-ftshare/contract'`，
+ * 不依赖本包的实现、传输层或 MCP SDK。本模块只有类型与常量，没有运行时依赖，
+ * 因此宿主插件与测试都能安全引用。
+ *
+ * 设计要点是 **四态归一**：FTShare 网关把「真的没有数据」「套餐无权限（403
+ * route_not_allowed）」「取数失败」三种情况都表现为「空」，调用方若只判断空数组就
+ * 会把「无权限」误读成「没有数据」。{@link FtshareCallResult.state} 强制区分这四种
+ * 结局，并把权限提示挂在 {@link FtshareCallResult.notice} 上。
+ * @module @dsh-ft/dsh-fft-ftshare/contract
+ */
+/** 服务在 cordis `Context` 上的名字，也是 `ctx.provide` 的键。 */
+export const FTSHARE_DATA_SERVICE = 'ftshareData';
+/**
+ * 跨平面通路的精确路由：浏览器侧的 `createFtshareClient` POST 到这里，宿主侧的
+ * `registerFtshareRoute` 在这里应答。走 `connection.fetch` 的 `/api` 载体，因此
+ * Host/Origin 围栏与浏览器鉴权由载体负责。
+ */
+export const FTSHARE_DATA_ROUTE = '/api/ftshare-data';
+/** 用户可升级订阅的页面，{@link FtshareNotice.upgradeUrl} 的默认值。 */
+export const FTSHARE_UPGRADE_URL = 'https://ftai.chat/me/profile?tab=subscription';
+//# sourceMappingURL=contract.js.map

package/lib/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAA4B,CAAA;AAE9D,wDAAwD;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,+CAAwD,CAAA"}

package/lib/errors.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 上游失败的归一：把 FTShare 网关千奇百怪的报错折成 {@link FtshareNotice}
+ * 加一个四态结局。
+ *
+ * 这是 P8 的解药所在。网关对「套餐没开通这个接口」返回的是 HTTP 403 +
+ * `route_not_allowed`，`dsh-kline` 把它归类成 `capability_limited` 之后，摘要里
+ * 只留下一个 `0`；调用方于是无法区分「今天真的没有涨停事件」和「这个套餐根本
+ * 调不了这个接口」。本模块只做一件事：把权限失败与真实失败分开，并各自带上
+ * 用户能看懂的中文说明。
+ * @module @dsh-ft/dsh-fft-ftshare/errors
+ */
+import { type FtshareNotice } from './contract.js';
+/** 上游返回的错误信封，字段全部按「可能不存在」处理。 */
+interface UpstreamErrorEnvelope {
+    code?: string;
+    /** 上游 HTTP 状态码（信封里的 `upstream_code`）：429 这类码比归一码更能说明失败性质。 */
+    upstreamCode?: string;
+    message: string;
+    requiredPlan?: string;
+}
+/** 配额用尽时附在失败提示后的文案。 */
+export declare const FTSHARE_QUOTA_NOTICE = "\u514D\u8D39\u914D\u989D\u7528\u5C3D\uFF0C\u914D\u7F6E FTShare API Key \u6216\u7A0D\u540E\u91CD\u8BD5";
+/**
+ * 一个码或一句话是否表达「额度用尽」。
+ * @param code - 归一后的上游错误码。
+ * @param upstreamCode - 信封里的上游 HTTP 状态码，可能没有。
+ * @param message - 上游说明。
+ * @returns 是否属于额度用尽。
+ */
+export declare function isQuotaSignal(code: string | undefined, upstreamCode: string | undefined, message: string): boolean;
+/** 判断一个值是不是可当对象读的记录。 */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** 读一个非空字符串；其余一律 undefined。 */
+export declare function asText(value: unknown): string | undefined;
+/**
+ * 一个码或一句话是否表达「无权访问」。
+ * @param code - 上游错误码，可能没有。
+ * @param message - 上游错误文案，可能为空串。
+ * @returns 是否属于权限失败。
+ */
+export declare function isPermissionSignal(code: string | undefined, message: string): boolean;
+/**
+ * 一个码是否值得原样重试。
+ * @param code - 归一后的上游错误码。
+ * @param message - 上游说明。
+ * @param upstreamCode - 信封里的上游 HTTP 状态码：`UPSTREAM_UNAVAILABLE` 包裹的 502/504 仍可重试。
+ */
+export declare function isRetryableSignal(code: string | undefined, message: string, upstreamCode?: string): boolean;
+/**
+ * 从 MCP 客户端抛出的错误（其 message 常是被字符串化的一段上游 JSON）里抽出码与说明。
+ *
+ * 上游两种形态都出现过：结构化 `{"error":{"code":…,"message":…}}`，以及
+ * 一行纯文本。两者都要能读，读不出来就保留原文。
+ * @param value - 抛出物或上游返回的文本。
+ * @returns 归一后的码与说明。
+ */
+export declare function parseUpstreamError(value: unknown): UpstreamErrorEnvelope;
+/**
+ * 造一条「无权访问」提示。措辞刻意把「不是没有数据」写进去：P8 的病根就是这句
+ * 缺失，让「套餐没开通」看起来像「今天什么都没有」。
+ *
+ * 档位只在上游自己给了 `required_plan` 时才写进提示：接口名里的版本号与订阅档位
+ * 没有可复核的对应关系，按它猜一个档位会把用户引向错误的套餐。
+ * @param tool - 上游工具名。
+ * @param code - 上游错误码，缺省按 `route_not_allowed` 记。
+ * @param message - 上游说明。
+ * @param requiredPlan - 上游信封里给出的所需档位；没给就不猜。
+ * @returns 可直接展示的提示。
+ */
+export declare function deniedNotice(tool: string, code: string | undefined, message: string, requiredPlan?: string): FtshareNotice;
+/**
+ * 把一次失败折成结局与提示。
+ * @param error - 抛出物。
+ * @param tool - 上游工具名，出现在提示正文里。
+ * @returns 结局（`denied` 或 `failed`）与可直接展示的提示。
+ */
+export declare function classifyFailure(error: unknown, tool: string): {
+    state: 'denied' | 'failed';
+    notice: FtshareNotice;
+};
+/**
+ * 从「调用成功但信封说自己无权」的载荷里读出权限提示。
+ *
+ * 部分网关把订阅门禁放在成功信封的 `metadata.permissions` 里，而不是返回错误；
+ * 只看空数组就会把这种情况读成「没有数据」。这里的标记判定与投研舱既有实现保持
+ * 同一口径：必须出现显式的权限标记或权限文案，普通空数组不算。
+ * @param tool - 上游工具名。
+ * @param value - 上游返回的结构化载荷。
+ * @returns 权限提示；没有标记时 undefined。
+ */
+export declare function permissionNoticeFromPayload(tool: string, value: unknown): FtshareNotice | undefined;
+export {};
+//# 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;;;;;;;;;;GAUG;AAEH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAEvE,gCAAgC;AAChC,UAAU,qBAAqB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AA8BD,uBAAuB;AACvB,eAAO,MAAM,oBAAoB,0GAAoC,CAAA;AAYrE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMlH;AAcD,wBAAwB;AACxB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,+BAA+B;AAC/B,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEzD;AAQD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGrF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAI3G;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAoCxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAa1H;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAgCnH;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAsBnG"}