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

package/lib/route.js

@@ -0,0 +1,90 @@
+/**
+ * 宿主助手：把 `ctx.ftshareData` 挂到跨平面路由上（**消费方自己挂**）。
+ *
+ * 底座不声明 `dsh.client` —— 它不是客户端面，只发布两段实现。需要浏览器取数的消费方
+ * 自己挂这一行：
+ *
+ * ```ts
+ * ctx.inject(['connection', 'ftshareData'], scope =>
+ *   scope.effect(() => registerFtshareRoute(scope.ctx, scope.ftshareData), 'ftshare: /api route'))
+ * ```
+ *
+ * 路由是 `connection.fetch` 的**精确**路由，复用 `/api` 载体的 Host/Origin 围栏与
+ * 浏览器鉴权。契约（设计 §5.1）：
+ *
+ * - **原样过桥**：成功就是一份 `FtshareCallResult`，`notice` 与 `upgradeUrl` 一起带，
+ *   面板才能把「没权限」渲染成「去升级」而不是「没有数据」；
+ * - **接口名校验**：只接受目录里的接口名，否则 400 —— 底座不能变成任意上游的穿透代理；
+ * - **取消与超时**：`request.signal` 原样转给 `call({ signal })`，面板的连点与切标的
+ *   因此能真的取消掉在途请求。
+ * @module @dsh-ft/dsh-fft-ftshare/route
+ */
+import { catalogEntryOf, missingRequiredArgs } from './catalog.js';
+import { loadCatalog } from './catalog-host.js';
+import { FTSHARE_DATA_ROUTE } from './contract.js';
+import { isRecord } from './errors.js';
+/**
+ * 造一条只回答 `/api/ftshare-data` 的路由定义（纯函数，便于测试）。
+ * @param data - 宿主侧的 `ctx.ftshareData`。
+ * @returns 路由定义。
+ */
+export function createFtshareRoute(data) {
+    return {
+        path: FTSHARE_DATA_ROUTE,
+        methods: ['POST'],
+        requestBody: 'buffered',
+        async fetch(request) {
+            const body = await readJsonBody(request);
+            if (body === undefined)
+                return errorResponse(400, 'bad_request', '请求体不是合法的 JSON 对象');
+            const name = typeof body.interface === 'string' ? body.interface.trim() : '';
+            const args = isRecord(body.args) ? body.args : undefined;
+            if (name === '')
+                return errorResponse(400, 'bad_request', '缺少 interface');
+            const entry = catalogEntryOf(loadCatalog(), name);
+            if (entry === undefined)
+                return errorResponse(400, 'unknown_interface', `接口 ${name} 不在目录里，不能直调`);
+            const missing = missingRequiredArgs(entry, args);
+            if (missing.length > 0)
+                return errorResponse(400, 'missing_arguments', `缺必填入参：${missing.join('、')}`);
+            const result = await data.call(name, args ?? {}, { signal: request.signal });
+            // 四态**原样**过桥：这里不翻译、不裁字段，面板与宿主看到同一份东西。
+            return json(200, result);
+        },
+    };
+}
+/**
+ * 注册路由；调用方自己决定挂在哪一层（返回值就是载体的 disposer）。
+ * @param ctx - 已经 inject 到 `connection` 的上下文。
+ * @param data - 宿主侧的 `ctx.ftshareData`。
+ * @returns 载体的注销函数，交给 `ctx.effect` 管。
+ */
+export function registerFtshareRoute(ctx, data) {
+    const connection = ctx.get('connection');
+    const fetch = connection?.fetch;
+    if (fetch === undefined)
+        throw new Error('registerFtshareRoute 需要 connection.fetch：先把 connection inject 进来');
+    return fetch.register(createFtshareRoute(data));
+}
+/** 读一个 JSON 对象请求体；非法或非对象时 undefined。 */
+async function readJsonBody(request) {
+    try {
+        const parsed = await request.json();
+        return isRecord(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 错误信封：客户端按 `error.code` / `error.message` 渲染成 `failed`。 */
+function errorResponse(status, code, message) {
+    return json(status, { error: { code, message } });
+}
+/** JSON 应答。 */
+function json(status, payload) {
+    return new Response(JSON.stringify(payload), {
+        status,
+        headers: { 'content-type': 'application/json' },
+    });
+}
+//# sourceMappingURL=route.js.map

package/lib/route.js.map

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

package/lib/tools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * preset 平面：把接口表里带 `expose` 的条目注册成 `ctx.tools` 里的 `ftshare_*` 工具，
+ * 外加一个长尾入口 `ftshare_call`。
+ *
+ * 由 preset 行以子路径名 `@dsh-ft/dsh-fft-ftshare/tools` 挂载，因此这些工具只存在于
+ * 所选 preset 的 agent 作用域内（标准模式下不存在）。取数走全局平面提供的
+ * `ctx.ftshareData`，本平面不开连接、不碰凭据。
+ *
+ * 每个工具都把 {@link FtshareCallResult} 的四态结局原样印进正文：`denied` 说
+ * 「当前套餐无权访问」，`empty` 才说「没有记录」。这是 P8 的教训——两种结局不能
+ * 长得一样。
+ * @module @dsh-ft/dsh-fft-ftshare/tools
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type Capability } from './capabilities.js';
+export * from './capabilities.js';
+export * from './catalog.js';
+/** Cordis 插件名。 */
+export declare const name = "@dsh-ft/dsh-fft-ftshare/tools";
+/** 注册工具要 `tools`，取数要全局 plane 的 `ftshareData`。 */
+export declare const inject: string[];
+/** 接口表里要下发给模型的那部分（其余条目只供本仓程序调用）。 */
+export declare const FTSHARE_EXPOSED_CAPABILITIES: readonly Capability[];
+/** 长尾接口的通用直调工具名。 */
+export declare const FTSHARE_CALL_TOOL = "ftshare_call";
+/**
+ * 注册接口表里每一个暴露条目，外加一个通用直调。
+ * @param ctx - preset 子树的上下文。
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=tools.d.ts.map

package/lib/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,qBAAqB,CAAA;AAI1D,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAMzE,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAE5B,kBAAkB;AAClB,eAAO,MAAM,IAAI,kCAAkC,CAAA;AAEnD,iDAAiD;AACjD,eAAO,MAAM,MAAM,UAA2B,CAAA;AAwB9C,oCAAoC;AACpC,eAAO,MAAM,4BAA4B,EAAE,SAAS,UAAU,EACI,CAAA;AAElE,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,iBAAiB,CAAA;AAE/C;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAIxC"}

package/lib/tools.js

@@ -0,0 +1,132 @@
+/**
+ * preset 平面：把接口表里带 `expose` 的条目注册成 `ctx.tools` 里的 `ftshare_*` 工具，
+ * 外加一个长尾入口 `ftshare_call`。
+ *
+ * 由 preset 行以子路径名 `@dsh-ft/dsh-fft-ftshare/tools` 挂载，因此这些工具只存在于
+ * 所选 preset 的 agent 作用域内（标准模式下不存在）。取数走全局平面提供的
+ * `ctx.ftshareData`，本平面不开连接、不碰凭据。
+ *
+ * 每个工具都把 {@link FtshareCallResult} 的四态结局原样印进正文：`denied` 说
+ * 「当前套餐无权访问」，`empty` 才说「没有记录」。这是 P8 的教训——两种结局不能
+ * 长得一样。
+ * @module @dsh-ft/dsh-fft-ftshare/tools
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { FTSHARE_CAPABILITIES } from './capabilities.js';
+import { catalogEntryOf, missingRequiredArgs } from './catalog.js';
+import { FTSHARE_CATALOG_INDEX_PATH, loadCatalog } from './catalog-host.js';
+import { isRecord } from './errors.js';
+import { renderCallResult } from './project.js';
+export * from './capabilities.js';
+export * from './catalog.js';
+/** Cordis 插件名。 */
+export const name = '@dsh-ft/dsh-fft-ftshare/tools';
+/** 注册工具要 `tools`，取数要全局 plane 的 `ftshareData`。 */
+export const inject = ['tools', 'ftshareData'];
+/**
+ * 工具的规范化输出：渲染好的正文加四态结局。
+ *
+ * 结局单独留一个字段，是为了让 `presentResult` 之类的消费者将来能按状态取样式，
+ * 而不必再解析正文。
+ */
+const outputSchema = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        tool: { type: 'string' },
+        state: { type: 'string' },
+        text: { type: 'string' },
+    },
+};
+/** 所有 `ftshare_*` 工具共用的输出：正文加四态结局。 */
+const toolOutput = {
+    schema: outputSchema,
+    render: (_args, value) => [{ type: 'text', text: value.text ?? '' }],
+};
+/** 接口表里要下发给模型的那部分（其余条目只供本仓程序调用）。 */
+export const FTSHARE_EXPOSED_CAPABILITIES = FTSHARE_CAPABILITIES.filter(entry => entry.expose !== undefined);
+/** 长尾接口的通用直调工具名。 */
+export const FTSHARE_CALL_TOOL = 'ftshare_call';
+/**
+ * 注册接口表里每一个暴露条目，外加一个通用直调。
+ * @param ctx - preset 子树的上下文。
+ */
+export function apply(ctx) {
+    const logger = ctx.logger('dsh-fft-ftshare-tools');
+    for (const entry of FTSHARE_EXPOSED_CAPABILITIES)
+        register(ctx, logger, entry);
+    registerCatalogTool(ctx, logger);
+}
+/**
+ * 注册单个接口表条目。
+ * @param ctx - preset 子树的上下文。
+ * @param logger - 具名 logger。
+ * @param entry - 带 `expose` 的接口表条目。
+ */
+function register(ctx, logger, entry) {
+    const exposed = entry.expose;
+    if (exposed === undefined)
+        return;
+    ctx.tools.register(defineTool({
+        name: exposed.name,
+        description: `${entry.title}。${exposed.description}`,
+        parameters: entry.args,
+        output: toolOutput,
+        async execute(args, exec) {
+            const result = await ctx.ftshareData.call(entry.interface, (args ?? {}), { signal: exec.signal });
+            if (result.state === 'denied' || result.state === 'failed') {
+                logger.warn('ftshare.tool_result', { tool: entry.interface, state: result.state, code: result.notice?.code });
+            }
+            return { tool: entry.interface, state: result.state, text: renderCallResult(entry.title, entry.interface, result) };
+        },
+    }));
+}
+/**
+ * 注册通用直调：`ftshare_call(interface, args)`。
+ *
+ * 它是长尾接口的唯一入口——一个工具定义换掉 250 份 schema。三种结局各有各的话：
+ * 名字不在目录（给出索引文件路径，让模型去 `grep`，而不是猜第二个名字）、套餐无权
+ * （由 {@link renderCallResult} 带上升级入口）、配额用尽（由 errors 层附文案）。
+ * @param ctx - preset 子树的上下文。
+ * @param logger - 具名 logger。
+ */
+function registerCatalogTool(ctx, logger) {
+    ctx.tools.register(defineTool({
+        name: FTSHARE_CALL_TOOL,
+        description: `直调 FTShare 目录里的任意接口。不要猜接口名：先在 ${FTSHARE_CATALOG_INDEX_PATH} 里 grep `
+            + '（一行一个接口，格式 `接口名 | 标题 | 入参名`，带 * 的是必填），目录之外的名字会被拒绝。',
+        parameters: {
+            interface: { type: 'string', description: '上游接口名，必须来自目录索引', required: true },
+            args: { type: 'object', additionalProperties: true, description: '接口入参；必填项见目录索引里带 * 的名字' },
+        },
+        output: toolOutput,
+        async execute(args, exec) {
+            const call = isRecord(args) ? args : {};
+            const interfaceName = typeof call.interface === 'string' ? call.interface.trim() : '';
+            const callArgs = isRecord(call.args) ? call.args : {};
+            const entry = catalogEntryOf(loadCatalog(), interfaceName);
+            if (entry === undefined) {
+                return {
+                    tool: interfaceName,
+                    state: 'failed',
+                    text: `目录里没有接口 ${interfaceName === '' ? '（未给名字）' : interfaceName}，不能直调。`
+                        + `先在 ${FTSHARE_CATALOG_INDEX_PATH} 里 grep 一下：一行一个接口，格式「接口名 | 标题 | 入参名」。`,
+                };
+            }
+            const missing = missingRequiredArgs(entry, callArgs);
+            if (missing.length > 0) {
+                return {
+                    tool: entry.name,
+                    state: 'failed',
+                    text: `缺必填入参：${missing.join('、')}。${entry.name} 的必填项见目录索引里带 * 的名字。`,
+                };
+            }
+            const result = await ctx.ftshareData.call(entry.name, callArgs, { signal: exec.signal });
+            if (result.state === 'denied' || result.state === 'failed') {
+                logger.warn('ftshare.tool_result', { tool: entry.name, state: result.state, code: result.notice?.code });
+            }
+            return { tool: entry.name, state: result.state, text: renderCallResult(entry.title, entry.name, result) };
+        },
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/lib/tools.js.map

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

package/lib/transport.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 出站传输：到 FTShare 网关的 StreamableHTTP MCP 会话。
+ *
+ * 两件事值得记下来：
+ *
+ * 1. **凭据只从 `ctx.ftshareSettings.apiKey.resolve()` 取**，绝不自己读
+ *    `~/.dsh/.credentials.yaml`。设置服务是凭据的唯一入口，它还要负责把「用户
+ *    在设置页填的 Key」和「环境变量回退」按同一优先级合起来；绕过它就会出现
+ *    「设置页显示已配置、实际取数用的是另一个 Key」这类无法排查的分歧。
+ * 2. **每次调用开一个新会话**（`initialize` → `callTool` → `close`）。会话里带
+ *    着凭据，缓存会话就等于缓存秘密，而设置契约要求「每次操作重新 resolve」；
+ *    连接成本换正确性是划算的，这条与投研舱的既有做法一致。
+ * @module @dsh-ft/dsh-fft-ftshare/transport
+ */
+import type { Logger } from '@deepseek-ai/cordis';
+import type { FtshareToolInfo } from './contract.js';
+/** 默认网关地址：FTShare 的 MCP StreamableHTTP 入口。 */
+export declare const FTSHARE_GATEWAY_ENDPOINT = "https://market.ft.tech/gateway/mcp";
+/** 承载 API Key 的请求头名。 */
+export declare const FTSHARE_API_KEY_HEADER = "FTSHARE_API_KEY";
+/** 一次上游调用的原始结果。`value` 是上游自己的结构化载荷，未做任何解释。 */
+export interface FtshareTransportResult {
+    value: unknown;
+}
+/** 传输层：与传输实现无关的最小面，便于测试注入假实现。 */
+export interface FtshareTransport {
+    /** 调一个上游工具；上游报错时抛异常（由调用方归一）。 */
+    call(tool: string, args: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<FtshareTransportResult>;
+    /** 上游工具清单；上游不可达时抛异常。 */
+    listTools(): Promise<readonly FtshareToolInfo[]>;
+}
+/** 建传输层所需的依赖。 */
+export interface FtshareTransportOptions {
+    /** 网关地址，默认 {@link FTSHARE_GATEWAY_ENDPOINT}。 */
+    endpoint?: string;
+    /** 每次操作重新取凭据；返回空串/undefined 表示未配置。 */
+    resolveApiKey: () => Promise<string | undefined>;
+    /** 具名 logger；不传则不记录。 */
+    logger?: Logger;
+    /** MCP 客户端自称的名字，只影响上游日志。 */
+    clientName?: string;
+    /** MCP 客户端版本。 */
+    clientVersion?: string;
+}
+/**
+ * 建一个到 FTShare 网关的传输层。
+ * @param options - 见 {@link FtshareTransportOptions}。
+ * @returns 传输层实现。
+ */
+export declare function createFtshareTransport(options: FtshareTransportOptions): FtshareTransport;
+//# sourceMappingURL=transport.d.ts.map

package/lib/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAKjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,uCAAuC,CAAA;AAE5E,wBAAwB;AACxB,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AAEvD,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAA;CACf;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACtH,wBAAwB;IACxB,SAAS,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAA;CACjD;AAED,iBAAiB;AACjB,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAChD,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAyCD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CA6EzF"}

package/lib/transport.js

@@ -0,0 +1,147 @@
+/**
+ * 出站传输：到 FTShare 网关的 StreamableHTTP MCP 会话。
+ *
+ * 两件事值得记下来：
+ *
+ * 1. **凭据只从 `ctx.ftshareSettings.apiKey.resolve()` 取**，绝不自己读
+ *    `~/.dsh/.credentials.yaml`。设置服务是凭据的唯一入口，它还要负责把「用户
+ *    在设置页填的 Key」和「环境变量回退」按同一优先级合起来；绕过它就会出现
+ *    「设置页显示已配置、实际取数用的是另一个 Key」这类无法排查的分歧。
+ * 2. **每次调用开一个新会话**（`initialize` → `callTool` → `close`）。会话里带
+ *    着凭据，缓存会话就等于缓存秘密，而设置契约要求「每次操作重新 resolve」；
+ *    连接成本换正确性是划算的，这条与投研舱的既有做法一致。
+ * @module @dsh-ft/dsh-fft-ftshare/transport
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { asText, isRecord } from './errors.js';
+/** 默认网关地址：FTShare 的 MCP StreamableHTTP 入口。 */
+export const FTSHARE_GATEWAY_ENDPOINT = 'https://market.ft.tech/gateway/mcp';
+/** 承载 API Key 的请求头名。 */
+export const FTSHARE_API_KEY_HEADER = 'FTSHARE_API_KEY';
+/**
+ * 从 MCP 调用的错误结果里取出可读文本。
+ * @param content - `callTool` 返回的 content 数组。
+ * @param fallback - 取不到文本时的说明。
+ * @returns 多块文本以换行拼接。
+ */
+function errorTextFromContent(content, fallback) {
+    if (!Array.isArray(content))
+        return fallback;
+    const text = content
+        .filter((block) => isRecord(block) && block.type === 'text' && typeof block.text === 'string')
+        .map(block => block.text)
+        .join('\n')
+        .trim();
+    return text === '' ? fallback : text;
+}
+/**
+ * 选一次调用的结构化载荷：优先 `structuredContent`，缺失时退回把文本当 JSON 解析。
+ *
+ * `dsh-kline` 两个都给；只给文本的上游也不该被判成空结果。
+ * @param result - `callTool` 的返回。
+ * @param tool - 工具名，仅用于日志。
+ * @param logger - 具名 logger。
+ * @returns 结构化载荷；两者都没有时为 undefined。
+ */
+function payloadOf(result, tool, logger) {
+    const record = isRecord(result) ? result : {};
+    if (isRecord(record.structuredContent))
+        return record.structuredContent;
+    const text = errorTextFromContent(record.content, '');
+    if (text !== '' && /^[[{]/u.test(text)) {
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            logger?.warn('ftshare.invalid_json_payload', { tool });
+        }
+    }
+    return record.structuredContent ?? undefined;
+}
+/**
+ * 建一个到 FTShare 网关的传输层。
+ * @param options - 见 {@link FtshareTransportOptions}。
+ * @returns 传输层实现。
+ */
+export function createFtshareTransport(options) {
+    const endpoint = options.endpoint?.trim() || FTSHARE_GATEWAY_ENDPOINT;
+    const clientName = options.clientName ?? 'dsh-fft-ftshare';
+    const clientVersion = options.clientVersion ?? '0.1.0';
+    /**
+     * 开一个已握手的会话；调用方负责关闭。
+     * @returns 已连接的 MCP 客户端。
+     */
+    async function connect() {
+        const headers = {};
+        const apiKey = asText(await options.resolveApiKey());
+        // 未配置时不带该头：网关会以「未携带 API Key」拒绝，比伪造一个空 Key 更可诊断。
+        if (apiKey !== undefined)
+            headers[FTSHARE_API_KEY_HEADER] = apiKey;
+        const client = new Client({ name: clientName, version: clientVersion });
+        const transport = new StreamableHTTPClientTransport(new URL(endpoint), { requestInit: { headers } });
+        await client.connect(transport);
+        return client;
+    }
+    return {
+        async call(tool, args, callOptions) {
+            const signal = callOptions?.signal;
+            if (signal?.aborted === true)
+                throw new Error(`FTShare ${tool} 调用前已被取消`);
+            const startedAt = Date.now();
+            const client = await connect();
+            try {
+                const result = await client.callTool({ name: tool, arguments: args }, undefined, {
+                    ...signal !== undefined ? { signal } : {},
+                });
+                if (result.isError === true) {
+                    // 抛出一段文本：归一器既能读其中的 JSON 码，也能读纯文案。
+                    throw new Error(errorTextFromContent(result.content, `${tool} 返回 MCP 错误`));
+                }
+                const value = payloadOf(result, tool, options.logger);
+                if (value === undefined)
+                    throw new Error(`${tool} 未返回 structuredContent，也没有可解析的文本载荷`);
+                return { value };
+            }
+            catch (error) {
+                options.logger?.warn('ftshare.call_failed', {
+                    tool,
+                    durationMs: Date.now() - startedAt,
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                throw error;
+            }
+            finally {
+                await client.close().catch(() => undefined);
+            }
+        },
+        async listTools() {
+            const client = await connect();
+            try {
+                const listed = await client.listTools();
+                const tools = [];
+                for (const entry of Array.isArray(listed.tools) ? listed.tools : []) {
+                    if (!isRecord(entry))
+                        continue;
+                    const tool = asText(entry.name);
+                    if (tool === undefined)
+                        continue;
+                    const description = asText(entry.description);
+                    tools.push({
+                        tool,
+                        title: asText(entry.title) ?? tool,
+                        // 目录产物（`catalog.json` / `catalog.txt`）就是这两项生成的：少了它们
+                        // 目录只能给名字，模型没法判断该调哪个接口、要传什么。
+                        ...description !== undefined ? { description } : {},
+                        ...entry.inputSchema !== undefined ? { inputSchema: entry.inputSchema } : {},
+                    });
+                }
+                return tools;
+            }
+            finally {
+                await client.close().catch(() => undefined);
+            }
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

package/lib/transport.js.map

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

package/package.json

@@ -1,6 +1,93 @@
 {
   "name": "@dsh-ft/dsh-fft-ftshare",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "FTShare 数据底座：全 bundle 唯一出站、一处四态归一、一处模型可见面，并随包发布上游接口目录。",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "license": "MIT",
+  "homepage": "https://github.com/gigaflw/dsh-fft-bundle/tree/dev/packages/dsh-fft-ftshare#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gigaflw/dsh-fft-bundle.git",
+    "directory": "packages/dsh-fft-ftshare"
+  },
+  "bugs": {
+    "url": "https://github.com/gigaflw/dsh-fft-bundle/issues"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "ftshare",
+    "mcp"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./contract": {
+      "types": "./lib/contract.d.ts",
+      "default": "./lib/contract.js"
+    },
+    "./catalog": {
+      "types": "./lib/catalog.d.ts",
+      "default": "./lib/catalog.js"
+    },
+    "./tools": {
+      "types": "./lib/tools.d.ts",
+      "default": "./lib/tools.js"
+    },
+    "./mask": {
+      "types": "./lib/mask.d.ts",
+      "default": "./lib/mask.js"
+    },
+    "./project": {
+      "types": "./lib/project.d.ts",
+      "default": "./lib/project.js"
+    },
+    "./route": {
+      "types": "./lib/route.d.ts",
+      "default": "./lib/route.js"
+    },
+    "./client": {
+      "types": "./lib/client.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./catalog.json": "./catalog.json",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "catalog.json",
+    "catalog.txt",
+    "catalog.meta.json",
+    "README.md",
+    "LICENSE",
+    "cordis.patch.yml",
+    "package.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-llm": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "engines": {
+      "dsh": ">=0.2.0-rc.2"
+    }
+  }
+}