pi-tsgw 0.0.18 → 0.1.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
@@ -7,6 +7,22 @@
7
7
  本项目不包含私有 API 密钥或网关端点。静态目录包含模型元数据和公开价格估算;
8
8
  这些价格并非你的网关计费费率。
9
9
 
10
+ ## 项目结构
11
+
12
+ 包清单的 `pi.extensions` 指向根 `./index.ts`,作为约 15 行的总入口;provider 注册与生命周期位于 `extensions/provider/`,模型模块位于 `extensions/models/`。搜索模块及相邻测试位于 `extensions/search/`,提示词由 `extensions/prompts.ts` 的 `registerPrompts` 统一注册,正文位于 `prompts/`。宿主集成总测试为根 `index.test.ts`;provider 和搜索测试与对应模块相邻,共享测试夹具仍位于 `extensions/`。技能及其测试路径保持在 `skills/` 和 `extensions/`。
13
+
14
+ ```text
15
+ index.ts # 包总入口
16
+ index.test.ts # 宿主集成总测试
17
+ extensions/provider/ # provider 注册、配置、状态及其测试
18
+ extensions/models/ # 模型目录、策略与联网支持
19
+ extensions/search/ # 搜索注册、代理与相邻测试
20
+ extensions/prompts.ts # registerPrompts
21
+ prompts/memory.ts # 记忆提示词正文
22
+ extensions/upload/ # 本地上传及安全说明
23
+ skills/ # 随包技能
24
+ ```
25
+
10
26
  ## 安装
11
27
 
12
28
  ```bash
@@ -191,7 +207,7 @@ GLM 指导使用 5.3,并以 Flash 和 FlashX 为备选。思考级别使用 Pi
191
207
  与其其他非 off 级别一样,映射为 adaptive。
192
208
 
193
209
  安装并执行 `/reload` 后,Pi 会通过包清单发现随包技能,除非宿主/包设置禁用或过滤了技能。
194
- 可以使用 `/skill:tsgw-git-commit` 等命令显式加载;仅加载 `extensions/index.ts` 不会加载包内技能。
210
+ 可以使用 `/skill:tsgw-git-commit` 等命令显式加载;仅加载根 `index.ts` 不会加载包内技能。
195
211
  包设置中的 `skills: []` 可禁用全部技能,`skills: ["skills/tsgw-git-commit"]` 可仅加载指定技能,
196
212
  或用 `skills: ["!skills/tsgw-git-commit/**"]` 排除该技能;由宿主处理,不是 `tsgw` 配置项。
197
213
 
@@ -200,6 +216,9 @@ GLM 指导使用 5.3,并以 Flash 和 FlashX 为备选。思考级别使用 Pi
200
216
 
201
217
  ### 记忆规则注入
202
218
 
219
+ 常驻提示词正文集中在 `prompts/`,与扩展注册入口分开维护。提示词由 `extensions/prompts.ts` 的
220
+ `registerPrompts` 统一注册;记忆提示词正文位于 `prompts/memory.ts`。
221
+
203
222
  插件在 `before_agent_start` 中注入原用户规则中的记忆体系与既有条目维护授权,
204
223
  不绑定当前模型 provider,不新增配置,不改写用户规则文件。
205
224
  详细流程保留在 `tsgw-smemo` 技能及其参考资料中;`ctx_memory` 仍称为“系统记忆”,
@@ -264,7 +283,8 @@ Pi AI/MCP 是明确仅用于测试的开发依赖;运行时依赖和提供商
264
283
  - [厂商配置](https://github.com/tossp/pi-tsgw/tree/main/extensions/models/vendors):模型元数据、兼容性标志和思考映射。
265
284
  - [请求操作](https://github.com/tossp/pi-tsgw/blob/main/extensions/models/operations.ts):写时复制分派;DeepSeek/Claude 响应仍由 Pi 的适配器处理。
266
285
  - [内置搜索](https://github.com/tossp/pi-tsgw/blob/main/extensions/models/web-search.ts):精确的模型/协议支持范围和仅追加注入。
267
- - [宿主集成](https://github.com/tossp/pi-tsgw/blob/main/extensions/index.ts):配置、刷新、命令和生命周期快照。延迟执行的请求回调不得访问过期的会话上下文。
286
+ - [扩展总入口](https://github.com/tossp/pi-tsgw/blob/main/index.ts):包加载入口;[provider 集成](https://github.com/tossp/pi-tsgw/tree/main/extensions/provider):注册、配置、刷新、命令和生命周期快照。延迟执行的请求回调不得访问过期的会话上下文。
287
+ - [提示词注册](https://github.com/tossp/pi-tsgw/blob/main/extensions/prompts.ts):`registerPrompts` 统一入口;记忆正文位于 `prompts/memory.ts`。
268
288
 
269
289
  这些源码链接描述仓库当前的 main 分支;已安装的发行版可能有所不同。
270
290
  `AGENTS.md` 中的开发规则仅用于仓库,不属于 npm 包。
@@ -0,0 +1,13 @@
1
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ import { MEMORY_RULES } from "../prompts/memory.ts";
3
+
4
+ export function registerPrompts(pi: ExtensionAPI): void {
5
+ pi.on("before_agent_start", (event) => {
6
+ if (event.systemPromptOptions) {
7
+ event.systemPromptOptions.sections.tsgw_memory = MEMORY_RULES;
8
+ return;
9
+ }
10
+ // 保留已声明支持的旧宿主提示词接口。
11
+ return { systemPrompt: `${event.systemPrompt}\n\n${MEMORY_RULES}` };
12
+ });
13
+ }
@@ -0,0 +1,33 @@
1
+ import { getAgentDir } from "@earendil-works/pi-coding-agent";
2
+ import { readFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+
5
+ /**
6
+ * 扩展配置来自 Pi 设置文件(settings.json)的 `tsgw` 命名空间。
7
+ * 所有插件配置均放在此处;插件不读取环境变量
8
+ * (密钥仅由 Pi 自身的凭据解析机制处理)。
9
+ */
10
+ export interface TsgwSettings {
11
+ baseUrl?: string;
12
+ mcpUrl?: string;
13
+ tsSearch?: string;
14
+ traceHeaders?: boolean;
15
+ includeModels?: string[];
16
+ excludeModels?: string[];
17
+ }
18
+
19
+ export function readTsgwSettings(): TsgwSettings {
20
+ try {
21
+ const raw: unknown = JSON.parse(
22
+ readFileSync(join(getAgentDir(), "settings.json"), "utf8"),
23
+ );
24
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw))
25
+ return {};
26
+ const tsgw = (raw as { tsgw?: unknown }).tsgw;
27
+ if (tsgw === null || typeof tsgw !== "object" || Array.isArray(tsgw))
28
+ return {};
29
+ return tsgw as TsgwSettings;
30
+ } catch {
31
+ return {};
32
+ }
33
+ }
@@ -7,7 +7,6 @@ import {
7
7
  getAgentDir,
8
8
  readStoredCredential,
9
9
  } from "@earendil-works/pi-coding-agent";
10
- import { readFileSync } from "node:fs";
11
10
  import { join } from "node:path";
12
11
  import { randomUUID } from "node:crypto";
13
12
  import {
@@ -17,20 +16,18 @@ import {
17
16
  modelsForRoot,
18
17
  normalizeRoot,
19
18
  type ModelFilter,
20
- } from "./models/catalog.ts";
21
- import { getGatewayModelIds } from "./models/gateway-catalog.ts";
22
- import { applyModelOperations } from "./models/operations.ts";
23
- import { registerSearch } from "./search.ts";
19
+ } from "../models/catalog.ts";
20
+ import { getGatewayModelIds } from "../models/gateway-catalog.ts";
21
+ import { applyModelOperations } from "../models/operations.ts";
22
+ import { registerSearch } from "../search/index.ts";
24
23
  import {
25
24
  catalogLabel,
26
25
  catalogDiagnostics,
27
26
  searchLabel,
28
27
  type CatalogStatus,
29
28
  } from "./status.ts";
30
- import type { ThinkingLevel, WebSearchMode } from "./models/_tools.ts";
31
- import { registerUploadTool } from "./upload/index.ts";
32
- import { registerTsgwMcp } from "./mcp.ts";
33
- import { registerMemoryRules } from "./memory.ts";
29
+ import type { ThinkingLevel, WebSearchMode } from "../models/_tools.ts";
30
+ import type { TsgwSettings } from "./config.ts";
34
31
 
35
32
  /**
36
33
  * 在生命周期上下文仍有效时,复制供应商钩子所需的数据。
@@ -51,36 +48,6 @@ interface RequestModel {
51
48
  baseUrl: string;
52
49
  }
53
50
 
54
- /**
55
- * 扩展配置来自 Pi 设置文件(settings.json)的 `tsgw` 命名空间。
56
- * 所有插件配置均放在此处;插件不读取环境变量
57
- * (密钥仅由 Pi 自身的凭据解析机制处理)。
58
- */
59
- interface TsgwSettings {
60
- baseUrl?: string;
61
- mcpUrl?: string;
62
- tsSearch?: string;
63
- traceHeaders?: boolean;
64
- includeModels?: string[];
65
- excludeModels?: string[];
66
- }
67
-
68
- function readTsgwSettings(): TsgwSettings {
69
- try {
70
- const raw: unknown = JSON.parse(
71
- readFileSync(join(getAgentDir(), "settings.json"), "utf8"),
72
- );
73
- if (raw === null || typeof raw !== "object" || Array.isArray(raw))
74
- return {};
75
- const tsgw = (raw as { tsgw?: unknown }).tsgw;
76
- if (tsgw === null || typeof tsgw !== "object" || Array.isArray(tsgw))
77
- return {};
78
- return tsgw as TsgwSettings;
79
- } catch {
80
- return {};
81
- }
82
- }
83
-
84
51
  function rootForRuntime(configured: string | undefined): string {
85
52
  try {
86
53
  return normalizeRoot(configured);
@@ -198,11 +165,9 @@ async function resolveEffectiveModels(
198
165
  return { models, gatewayIds, catalog: { ...catalog, count: models.length } };
199
166
  }
200
167
 
201
- export default async function registerTsgw(pi: ExtensionAPI): Promise<void> {
202
- registerUploadTool(pi);
203
- registerMemoryRules(pi);
204
- const settings = readTsgwSettings();
205
- registerTsgwMcp(pi, settings.mcpUrl);
168
+ export async function registerTsgwProvider(
169
+ pi: ExtensionAPI, settings: TsgwSettings,
170
+ ): Promise<void> {
206
171
  const root = rootForRuntime(settings.baseUrl);
207
172
  const defaultSearchMode: WebSearchMode =
208
173
  settings.tsSearch === "cached" || settings.tsSearch === "live"
@@ -1,5 +1,5 @@
1
- import type { WebSearchMode } from "./models/_tools.ts";
2
- import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS } from "./models/gateway-catalog.ts";
1
+ import type { WebSearchMode } from "../models/_tools.ts";
2
+ import { DEFAULT_GATEWAY_MODEL_CACHE_TTL_MS } from "../models/gateway-catalog.ts";
3
3
 
4
4
  export interface CatalogStatus {
5
5
  count: number;
@@ -1,8 +1,8 @@
1
1
  import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
2
- import { builtinSearchSupport, resolveSearchDelegate } from "./models/web-search.ts";
3
- import type { WebSearchMode } from "./models/_tools.ts";
4
- import { searchLabel, type SearchSupport } from "./status.ts";
5
- import { registerSearchProxyTool, SEARCH_PROXY_TOOL } from "./search-proxy.ts";
2
+ import { builtinSearchSupport, resolveSearchDelegate } from "../models/web-search.ts";
3
+ import type { WebSearchMode } from "../models/_tools.ts";
4
+ import { searchLabel, type SearchSupport } from "../provider/status.ts";
5
+ import { registerSearchProxyTool, SEARCH_PROXY_TOOL } from "./proxy.ts";
6
6
 
7
7
  interface SearchOptions {
8
8
  defaultMode: WebSearchMode;
@@ -1,9 +1,9 @@
1
1
  /** 搜索代理复用 Pi 的注册表、身份认证与协议适配器。 */
2
2
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
3
3
  import { Type } from "typebox";
4
- import { isPlainObject, type WebSearchMode } from "./models/_tools.ts";
5
- import { applyModelOperations } from "./models/operations.ts";
6
- import { builtinSearchSupport, type SearchDelegate } from "./models/web-search.ts";
4
+ import { isPlainObject, type WebSearchMode } from "../models/_tools.ts";
5
+ import { applyModelOperations } from "../models/operations.ts";
6
+ import { builtinSearchSupport, type SearchDelegate } from "../models/web-search.ts";
7
7
 
8
8
  export const SEARCH_PROXY_TOOL = "tsgw_search";
9
9
  interface SearchProxyOptions {
package/index.ts ADDED
@@ -0,0 +1,15 @@
1
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ import { registerTsgwMcp } from "./extensions/mcp.ts";
3
+ import { registerPrompts } from "./extensions/prompts.ts";
4
+ import { readTsgwSettings } from "./extensions/provider/config.ts";
5
+ import { registerTsgwProvider } from "./extensions/provider/index.ts";
6
+ import { registerUploadTool } from "./extensions/upload/index.ts";
7
+
8
+ /** 插件总入口:保持能力注册顺序,实现由各模块维护。 */
9
+ export default async function registerTsgw(pi: ExtensionAPI): Promise<void> {
10
+ registerUploadTool(pi);
11
+ registerPrompts(pi);
12
+ const settings = readTsgwSettings();
13
+ registerTsgwMcp(pi, settings.mcpUrl);
14
+ await registerTsgwProvider(pi, settings);
15
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-tsgw",
3
- "version": "0.0.18",
3
+ "version": "0.1.0",
4
4
  "description": "面向 TOSSP AIH gateway 的 Pi 扩展:按厂商维护模型目录与思考策略,支持 openai-completions、openai-responses、anthropic-messages 和 google-generative-ai 协议。",
5
5
  "type": "module",
6
6
  "keywords": [
@@ -17,14 +17,14 @@
17
17
  },
18
18
  "pi": {
19
19
  "extensions": [
20
- "./extensions/index.ts"
20
+ "./index.ts"
21
21
  ],
22
22
  "skills": [
23
23
  "./skills"
24
24
  ]
25
25
  },
26
26
  "scripts": {
27
- "test": "tsc -p tsconfig.test.json && node dist/extensions/index.test.js && node dist/extensions/memory.test.js && node dist/extensions/status.test.js && node dist/extensions/search.test.js && node dist/extensions/search-proxy.test.js && node dist/extensions/search-host-integration.test.js && node dist/extensions/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/extensions/host-integration.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/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",
28
28
  "test:upload:live": "tsc -p tsconfig.test.json && node dist/extensions/upload/live.test.js"
29
29
  },
30
30
  "peerDependencies": {
@@ -1,5 +1,3 @@
1
- import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
-
3
1
  /** 从用户规则迁入的记忆体系与既有维护授权。 */
4
2
  export const MEMORY_RULES = `## 记忆体系
5
3
 
@@ -19,14 +17,3 @@ export const MEMORY_RULES = `## 记忆体系
19
17
  - 工具细则以实时提示和技能为准;规则与技能在获准范围内跨端统一维护,单端修改不代表已经同步。
20
18
 
21
19
  - smemo 条目内容维护(含永久删除)的持续授权见 \`skill:tsgw-smemo\`,不由此放宽文件、Git、服务、凭据或权限操作边界。`;
22
-
23
- export function registerMemoryRules(pi: ExtensionAPI): void {
24
- pi.on("before_agent_start", (event) => {
25
- if (event.systemPromptOptions) {
26
- event.systemPromptOptions.sections.tsgw_memory = MEMORY_RULES;
27
- return;
28
- }
29
- // 保留已声明支持的旧宿主提示词接口。
30
- return { systemPrompt: `${event.systemPrompt}\n\n${MEMORY_RULES}` };
31
- });
32
- }