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

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,65 @@
+/**
+ * 出站传输：到 FTShare 网关的 StreamableHTTP MCP 会话。
+ *
+ * 两件事值得记下来：
+ *
+ * 1. **凭据只从 `ctx.ftshareSettings.apiKey.resolve()` 取**，绝不自己读
+ *    `~/.dsh/.credentials.yaml`。设置服务是凭据的唯一入口，它还要负责把「用户
+ *    在设置页填的 Key」和「环境变量回退」按同一优先级合起来；绕过它就会出现
+ *    「设置页显示已配置、实际取数用的是另一个 Key」这类无法排查的分歧。
+ * 2. **每次调用开一个新会话**（`initialize` → `callTool` → `close`）。会话里带
+ *    着凭据，缓存会话就等于缓存秘密，而设置契约要求「每次操作重新 resolve」；
+ *    连接成本换正确性是划算的，这条与投研舱的既有做法一致。
+ *
+ * 本层只做传输，不解释失败：错误原样抛出（保留 `code`/`status`），由
+ * `./errors` 观测；日志也只留一行原始报文，分类与节流在上层做。
+ * @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";
+/**
+ * 单次 `callTool` 的默认上限。
+ *
+ * 实测会话失效/服务端超时会拖到约 950 s 才返回（见 `docs/thirdparty/
+ * ftshare-gateway-contract.md`），没有上限时一次取数能挂住 16 分钟。
+ */
+export declare const FTSHARE_CALL_DEADLINE_MS = 60000;
+/** 一次上游调用的原始结果。`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;
+    /** 单次 `callTool` 的上限，默认 {@link FTSHARE_CALL_DEADLINE_MS}；0 表示不设。 */
+    deadlineMs?: number;
+}
+/**
+ * 建一个到 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;;;;;;;;;;;;;;;;GAgBG;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;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAA;AAE9C,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;IACtB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAsDD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAoEzF"}

package/lib/transport.js

@@ -0,0 +1,161 @@
+/**
+ * 出站传输：到 FTShare 网关的 StreamableHTTP MCP 会话。
+ *
+ * 两件事值得记下来：
+ *
+ * 1. **凭据只从 `ctx.ftshareSettings.apiKey.resolve()` 取**，绝不自己读
+ *    `~/.dsh/.credentials.yaml`。设置服务是凭据的唯一入口，它还要负责把「用户
+ *    在设置页填的 Key」和「环境变量回退」按同一优先级合起来；绕过它就会出现
+ *    「设置页显示已配置、实际取数用的是另一个 Key」这类无法排查的分歧。
+ * 2. **每次调用开一个新会话**（`initialize` → `callTool` → `close`）。会话里带
+ *    着凭据，缓存会话就等于缓存秘密，而设置契约要求「每次操作重新 resolve」；
+ *    连接成本换正确性是划算的，这条与投研舱的既有做法一致。
+ *
+ * 本层只做传输，不解释失败：错误原样抛出（保留 `code`/`status`），由
+ * `./errors` 观测；日志也只留一行原始报文，分类与节流在上层做。
+ * @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';
+/**
+ * 单次 `callTool` 的默认上限。
+ *
+ * 实测会话失效/服务端超时会拖到约 950 s 才返回（见 `docs/thirdparty/
+ * ftshare-gateway-contract.md`），没有上限时一次取数能挂住 16 分钟。
+ */
+export const FTSHARE_CALL_DEADLINE_MS = 60_000;
+/**
+ * 从 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;
+}
+/**
+ * 把调用方取消信号与 deadline 合成一个信号。
+ * @param caller - 调用方信号。
+ * @param deadlineMs - 上限毫秒；0 表示不设。
+ * @returns 合并后的信号；两者都没有时 undefined。
+ */
+function callSignal(caller, deadlineMs) {
+    const timeout = deadlineMs > 0 ? AbortSignal.timeout(deadlineMs) : undefined;
+    if (caller === undefined)
+        return timeout;
+    if (timeout === undefined)
+        return caller;
+    return AbortSignal.any([caller, timeout]);
+}
+/**
+ * 建一个到 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';
+    const deadlineMs = options.deadlineMs ?? FTSHARE_CALL_DEADLINE_MS;
+    /**
+     * 开一个已握手的会话；调用方负责关闭。
+     * @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) {
+            if (callOptions?.signal?.aborted === true)
+                throw new Error(`FTShare ${tool} 调用前已被取消`);
+            const client = await connect();
+            try {
+                const signal = callSignal(callOptions?.signal, deadlineMs);
+                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 };
+            }
+            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/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "FTShare Data",
+    "description": "FTShare market-data access for the FT plugins, with a browsable API catalog."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "FTShare 数据",
+    "description": "为 FT 插件提供 FTShare 行情接口，并内置可浏览的接口目录。"
+  }
+}

package/package.json

@@ -1,6 +1,95 @@
 {
   "name": "@dsh-ft/dsh-fft-ftshare",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.4.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",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "lib",
+    "catalog.json",
+    "catalog.txt",
+    "catalog.meta.json",
+    "README.md",
+    "LICENSE",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "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"
+    }
+  }
+}