pi-tsgw 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -48,7 +48,6 @@ pi install npm:pi-tsgw
48
48
  {
49
49
  "tsgw": {
50
50
  "baseUrl": "https://aih.example.net",
51
- "mcpUrl": "https://xn--oht.cc/mcp",
52
51
  "tsSearch": "live",
53
52
  "traceHeaders": false,
54
53
  "excludeModels": ["gpt-*", "claude-*"],
@@ -78,7 +77,6 @@ pi install npm:pi-tsgw
78
77
  | 设置(`settings.json` 中的 `tsgw.*`) | 默认值 | 含义 |
79
78
  | --- | --- | --- |
80
79
  | `baseUrl` | 占位地址 | 网关根地址(规范化时去掉 `/v1` 后缀) |
81
- | `mcpUrl` | `https://xn--oht.cc/mcp` | 可选的 `ts_oht` HTTP(S) 端点覆盖值;独立于模型网关 |
82
80
  | `tsSearch` | `live` | GPT:`cached` 或 `live`;未设置、旧值 `off` 和无效值均回退到 `live`。受支持的 Grok 模型始终使用实时搜索。 |
83
81
  | `traceHeaders` | `false` | 添加 `AH-Thread-Id` / `AH-Trace-Id` 请求头,用于网关侧追踪 |
84
82
  | `includeModels` | 未设置 | 重新纳入的覆盖规则:匹配的模型 ID 即使也被 `excludeModels` 匹配,仍会保留(精确 ID 或 `prefix-*` 通配模式) |
@@ -225,30 +223,32 @@ GLM 指导使用 5.3,并以 Flash 和 FlashX 为备选。思考级别使用 Pi
225
223
  smemo/Blinko 仍称为“记忆系统”。技能迁移不操作 Blinko 数据或改变宿主认证与权限。
226
224
  从本地 `smemo` 迁入时,确认新版本插件与随包技能加载生效后,再移除原技能和用户规则中的重复内容。
227
225
 
228
- ## 默认 MCP 注册
226
+ ## MCP 服务配置
229
227
 
230
- 插件每次加载时都会向宿主登记以下会话默认值,暴露方式均为 `codemode`:
228
+ 插件不再自动登记 `ts_oht` 或 `ts_tool`,也不会自动写入任何配置。需要使用时,请由用户自行在
229
+ `~/.pi/agent/mcp.json` 配置;以下示例保留服务原名、原 URL,并以 `codemode` 暴露:
231
230
 
232
- | 服务器名称 | 默认端点 |
233
- | --- | --- |
234
- | `ts_oht` | `https://xn--oht.cc/mcp` |
235
- | `ts_tool` | `https://mcp.tossp.com/mm/ts/mcp` |
236
-
237
- 使用这些默认值无需手工配置 MCP。用户级设置中可选的 `tsgw.mcpUrl` 仅覆盖 `ts_oht`,
238
- 独立于 `tsgw.baseUrl`,且仅在初始化时读取一次;`ts_tool` 的覆盖交给宿主同名文件配置,
239
- 没有额外的插件配置项。显式 `mcpUrl` 无效时,安全警告并仅跳过 `ts_oht`,
240
- 不静默回退,也不影响 `ts_tool`。单个登记失败不阻断另一服务或模型提供方;
241
- 不支持 `registerMcpServer` 的旧宿主会跳过两者注册。
242
-
243
- Pi 管理连接、OAuth 登录和凭据。需要登录时,在会话内对相应服务使用 `/mcp login ts_oht` 或 `/mcp login ts_tool`。
244
- 插件不读写 `mcp.json` 或 `mcp-auth.json`,也不携带凭据。
245
- 保持相同的服务器名称和完全一致的 URL,才能复用宿主现有的 OAuth 作用域。
246
-
247
- 有效的全局/项目 `mcp.json` 中同名的 `ts_oht`、`ts_tool` 分别优先于插件注册,包括 `enabled: false`;
248
- 插件不会创建第二条连接,也不会绕过该选择。要覆盖 URL、暴露方式、超时、认证或启用状态,
249
- 请在文件中使用完整的同名配置。对插件提供的服务器所做的更改仅作用于当前会话,不会保存。
250
- Shell 中的 `pi mcp` 命令不加载插件,无法看到仅由此注册提供的服务器。
251
- 配置变更后请重新加载或重启。
231
+ ```json
232
+ {
233
+ "mcpServers": {
234
+ "ts_oht": {
235
+ "url": "https://xn--oht.cc/mcp",
236
+ "exposure": "codemode"
237
+ },
238
+ "ts_tool": {
239
+ "url": "https://mcp.tossp.com/mm/ts/mcp",
240
+ "exposure": "codemode"
241
+ }
242
+ }
243
+ }
244
+ ```
245
+
246
+ Pi 宿主管理 MCP 连接、OAuth 登录和凭据;可通过设置页或 `pi mcp login ts_oht` /
247
+ `pi mcp login ts_tool` 完成登录。迁移时保持相同名称和精确 URL 可复用已有认证记录;
248
+ 记录失效时仍需重新授权。旧的 `tsgw.mcpUrl` 已移除,不再生效。配置变更后请重新加载或重启。
249
+ 插件不自建 MCP
250
+ 客户端或认证逻辑,不读写 `mcp.json` / `mcp-auth.json`,也不携带凭据。
251
+ 上传工具仍复用宿主已连接且可调用的 `ts_oht`,不会自行连接或绕过禁用、权限及认证状态。
252
252
 
253
253
  ## 本地文件上传
254
254
 
@@ -9,7 +9,6 @@ import { join } from "node:path";
9
9
  */
10
10
  export interface TsgwSettings {
11
11
  baseUrl?: string;
12
- mcpUrl?: string;
13
12
  tsSearch?: string;
14
13
  traceHeaders?: boolean;
15
14
  includeModels?: string[];
@@ -8,12 +8,13 @@
8
8
 
9
9
  - Pi 需支持 `ctx.executeTool`(已在 1.1.0 和 1.2.0 上测试)。本包较低的提供商兼容性
10
10
  最低版本不代表承诺在旧宿主上支持上传。
11
- - 插件使用默认公共端点注册 `ts_oht`;可选的 `tsgw.mcpUrl` 可覆盖此端点。
12
- 全局/项目 MCP 文件中的同名条目优先,包括已禁用的条目。Pi 管理连接和 OAuth;
13
- 上传工具仅通过 `reachesTools` 声明其两个上传/URL 依赖。在 Pi 1.2+ 上,宿主可在执行
14
- 父工具前等待这些依赖的 MCP 连接/发现或重连。旧宿主忽略此提示,仍要求工具已经连接。
15
- 隐藏、禁用、被阻止或失败的工具仍不可用;插件不会启用它们、创建自己的连接,
16
- 或读取/修改 MCP 配置。就绪不等于通过认证或获得权限。
11
+ - 插件不自动登记 `ts_oht`。使用上传前,用户需自行在 `~/.pi/agent/mcp.json` 配置
12
+ `ts_oht`(`https://xn--oht.cc/mcp`,`codemode`),示例及 `ts_tool` 配置见根目录
13
+ [README](../../README.md#MCP-服务配置)。Pi 宿主管理连接和 OAuth;上传工具仅通过
14
+ `reachesTools` 声明其两个上传/URL 依赖。在 Pi 1.2+ 上,宿主可在执行父工具前等待这些
15
+ 依赖的 MCP 连接/发现或重连。旧宿主忽略此提示,仍要求工具已经连接。隐藏、禁用、被阻止
16
+ 或失败的工具仍不可用;插件不会启用它们、创建自己的连接,或读取/修改 MCP 配置。
17
+ 就绪不等于通过认证或获得权限。
17
18
  - 要求当前服务的 `mode` / `uploads[]` 协议约定。不支持仅有 `uploadUrl` 的旧协议约定。
18
19
  - 工具使用 Pi 进程的操作系统文件权限,而非沙箱或内置 `read` 工具的路径审批。
19
20
  授权的是**文件外传**,而非仅读取。必要时在权限扩展中管控 `upload_local_file`;
package/index.ts CHANGED
@@ -1,5 +1,4 @@
1
1
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
- import { registerTsgwMcp } from "./extensions/mcp.ts";
3
2
  import { registerPrompts } from "./extensions/prompts.ts";
4
3
  import { readTsgwSettings } from "./extensions/provider/config.ts";
5
4
  import { registerTsgwProvider } from "./extensions/provider/index.ts";
@@ -10,6 +9,5 @@ export default async function registerTsgw(pi: ExtensionAPI): Promise<void> {
10
9
  registerUploadTool(pi);
11
10
  registerPrompts(pi);
12
11
  const settings = readTsgwSettings();
13
- registerTsgwMcp(pi, settings.mcpUrl);
14
12
  await registerTsgwProvider(pi, settings);
15
13
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-tsgw",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "面向 TOSSP AIH gateway 的 Pi 扩展:按厂商维护模型目录与思考策略,支持 openai-completions、openai-responses、anthropic-messages 和 google-generative-ai 协议。",
5
5
  "type": "module",
6
6
  "keywords": [
@@ -24,7 +24,7 @@
24
24
  ]
25
25
  },
26
26
  "scripts": {
27
- "test": "tsc -p tsconfig.test.json && node dist/extensions/provider/index.test.js && node dist/extensions/prompts.test.js && node dist/extensions/provider/status.test.js && node dist/extensions/search/index.test.js && node dist/extensions/search/proxy.test.js && node dist/extensions/search/host-integration.test.js && node dist/extensions/provider/status-integration.test.js && node dist/extensions/models/gateway-catalog-metadata.test.js && node dist/extensions/models/operations.test.js && node dist/extensions/models/catalog.test.js && node dist/extensions/models/web-search.test.js && node dist/extensions/models/gateway-catalog.test.js && node dist/extensions/models/gateway-catalog-isolation.test.js && node dist/extensions/models/vendor-strategies.test.js && node dist/index.test.js && node dist/extensions/mcp.test.js && node dist/extensions/mcp-host-integration.test.js && node dist/extensions/skills.test.js && node dist/extensions/skill-resources.test.js && node dist/extensions/upload/protocol.test.js && node dist/extensions/upload/schema.test.js && node dist/extensions/upload/uploader.test.js && node dist/extensions/upload/transport.test.js && node dist/extensions/upload/host-integration.test.js && node dist/extensions/upload/readiness-host.test.js",
27
+ "test": "tsc -p tsconfig.test.json && node dist/extensions/provider/index.test.js && node dist/extensions/prompts.test.js && node dist/extensions/provider/status.test.js && node dist/extensions/search/index.test.js && node dist/extensions/search/proxy.test.js && node dist/extensions/search/host-integration.test.js && node dist/extensions/provider/status-integration.test.js && node dist/extensions/models/gateway-catalog-metadata.test.js && node dist/extensions/models/operations.test.js && node dist/extensions/models/catalog.test.js && node dist/extensions/models/web-search.test.js && node dist/extensions/models/gateway-catalog.test.js && node dist/extensions/models/gateway-catalog-isolation.test.js && node dist/extensions/models/vendor-strategies.test.js && node dist/index.test.js && node dist/extensions/skills.test.js && node dist/extensions/skill-resources.test.js && node dist/extensions/upload/protocol.test.js && node dist/extensions/upload/schema.test.js && node dist/extensions/upload/uploader.test.js && node dist/extensions/upload/transport.test.js && node dist/extensions/upload/host-integration.test.js && node dist/extensions/upload/readiness-host.test.js",
28
28
  "test:upload:live": "tsc -p tsconfig.test.json && node dist/extensions/upload/live.test.js"
29
29
  },
30
30
  "peerDependencies": {
@@ -75,7 +75,7 @@ gh api 'repos/OWNER/REPO/contents/docs/Guide%20%28CI%29.md?ref=feature%2Fci'
75
75
  gh release view TAG --repo OWNER/ACTION
76
76
  ```
77
77
 
78
- 3. 项目策略优先;无明确变更要求时保留既有 pinning(SHA、精确版本或主版本引用),不顺手统一。只有具体升级、安全或兼容需求并核验后才修改;SHA 应核对其与官方目标版本的对应关系。若项目沿用 `@vN`,可说明其可读性与跟随同主版本更新的取舍;主版本浮动引用不是所有项目的安全最佳实践。
78
+ 3. 项目明确策略优先。新增或升级 GitHub Actions 引用时,默认采用经核验的官方最新稳定主版本浮动引用 `owner/repo@vN`,不自动改成完整 SHA 或精确补丁版本。项目策略或用户明确要求固定版本时遵循其要求;SHA 应核对其与官方目标版本的对应关系。非依赖升级任务不顺手修改引用;既有固定策略的依据不明时先核验,不擅自解除固定。
79
79
  4. 主版本升级前比较输入、输出、权限、最低 Runner 版本、托管或自托管 Runner 兼容性及 Action 自身的 Node 运行时。项目 `setup-node` 的版本与运行 Action 的 Node 版本不是一回事;可复用工作流还要核对输入、secrets 与调用契约。
80
80
  5. 修改后重新静态枚举 `uses:`,逐项核对预期 ref;除迁移确有必要的变更外,保留 `with`、jobs、permissions、secrets 和触发行为。运行已有的本地验证,不擅自安装验证工具;远程 CI、发布验证仅在授权内执行。
81
81
  6. 汇报引用前后值、官方依据、兼容性检查及未验证项。离线时不宣称“最新”或“已通过远程 CI”。
package/extensions/mcp.ts DELETED
@@ -1,38 +0,0 @@
1
- import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
-
3
- export const TS_OHT_NAME = "ts_oht";
4
- export const TS_OHT_URL = "https://xn--oht.cc/mcp";
5
- export const TS_TOOL_NAME = "ts_tool";
6
- export const TS_TOOL_URL = "https://mcp.tossp.com/mm/ts/mcp";
7
-
8
- /** 仅设置会话默认值;文件覆盖、连接与 OAuth 由 Pi 管理。 */
9
- export function registerTsgwMcp(pi: ExtensionAPI, configuredUrl?: unknown): void {
10
- if (typeof pi.registerMcpServer !== "function") {
11
- console.error("TSGW:当前 Pi 宿主无法注册 MCP 服务器;已跳过 ts_oht、ts_tool 注册。");
12
- return;
13
- }
14
- const value = configuredUrl === undefined ? TS_OHT_URL : configuredUrl;
15
- let ohtUrl: string | undefined;
16
- try {
17
- if (typeof value !== "string" || value.trim() !== value) throw new Error();
18
- const url = new URL(value);
19
- if (!["https:", "http:"].includes(url.protocol) || url.username || url.password || url.hash)
20
- throw new Error();
21
- ohtUrl = value;
22
- } catch {
23
- // 显式配置无效时,不得改用其他默认地址连接。
24
- // 常规日志中绝不包含 URL 或解析器错误。
25
- console.error("TSGW:mcpUrl 无效;已跳过 ts_oht 注册。");
26
- }
27
- // 保留精确 URL,因为 Pi 将 OAuth 绑定到服务器名称与 URL 的组合。
28
- // 独立登记:无效的 ts_oht 配置或单个登记失败不得阻止另一个服务和 provider。
29
- for (const [name, url] of [[TS_OHT_NAME, ohtUrl], [TS_TOOL_NAME, TS_TOOL_URL]] as const) {
30
- if (url === undefined) continue;
31
- try {
32
- pi.registerMcpServer(name, { url, exposure: "codemode" });
33
- } catch {
34
- // 不输出可能包含配置或凭据的宿主异常。
35
- console.error(`TSGW:宿主无法登记 ${name};已跳过,请检查 Pi MCP 支持或同名扩展。`);
36
- }
37
- }
38
- }