@aiti-ai/aiti-devtools-pi 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aiti-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @aiti-ai/aiti-devtools-pi
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> pi（pi.dev CLI）侧扩展：agent 端无状态连接器，复用 aiti-devtools-agent 接线框架，把 pi CLI 会话接入 aiti-devtools。
+
+## 来源 · Origin
+
+本包是 **aiti** 生态的组成部分——以 [pi](https://pi.dev) 为引擎的个人 AI 开发工作台与本地调试注入生态：**aiti-agent**（自托管 Web 工作台，基于开源项目 [pi-web](https://github.com/aiti-ai/pi-web) 构建，浏览器为主操作面）+ 各开发工具内的调试注入（aiti-devtools）+ 丰富的扩展体系。
+
+This package is part of the **aiti** ecosystem — a personal AI development workbench powered by [pi](https://pi.dev): **aiti-agent** (a self-hosted web workbench built on the open-source [pi-web](https://github.com/aiti-ai/pi-web)) plus debug injection into mainstream dev tools (aiti-devtools) and a rich extension system.
+
+- 工作台 / workbench: <https://github.com/aiti-ai/pi-web>
+- 生态仓库 / monorepo: <https://github.com/aiti-ai/aiti-ai>
+- 官网 / site: <https://aiti.pw>
+
+## 功能定位（中文）
+
+pi（pi.dev CLI）侧扩展：agent 端无状态连接器，复用 aiti-devtools-agent 接线框架，把 pi CLI 会话接入 aiti-devtools。
+
+## Positioning (English)
+
+pi (pi.dev CLI) side extension: stateless agent-side connector reusing the aiti-devtools-agent wiring framework to bring pi CLI sessions into aiti-devtools.
+
+## 安装 / 部署
+
+```bash
+npm install -D @aiti-ai/aiti-devtools-pi
+```
+
+不同载体的接线方式见文档（多数一行接入）。
+
+## 文档 · Documentation
+
+- 中文完整文档（aiti-docs）: <https://aiti.pw/devtools/>
+- English docs: <https://aiti.pw/en/devtools/>
+- 扩展注册表 / registry: <https://aiti.pw/extensions.html> · machine-readable <https://aiti.pw/extensions.json>
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "@aiti-ai/aiti-devtools-pi",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "aiti-devtools pi 扩展（agent 端无状态连接器）——注册桥 aiti_* 工具 + 会话/推送，桥独立常驻（packages/aiti-bridge）",
+  "type": "module",
+  "main": "src/index.ts",
+  "license": "MIT",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "build": "node tools/build.mjs"
+  },
+  "dependencies": {
+    "@aiti-ai/aiti-devtools-agent": "0.1.0",
+    "@aiti-ai/aiti-devtools-core": "^0.3.5"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "^0.35.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aiti-ai/aiti-ai.git",
+    "directory": "packages/aiti-devtools-pi"
+  },
+  "homepage": "https://github.com/aiti-ai/aiti-ai#readme",
+  "bugs": {
+    "url": "https://github.com/aiti-ai/aiti-ai/issues"
+  },
+  "contentHash": "822269ad46d04428"
+}

package/src/bridge-url.ts

@@ -0,0 +1,32 @@
+/**
+ * bridge-url —— 桥地址协商（纯函数，无依赖；aiti-devtools-pi 专用）
+ *
+ * 背景（2026-09-15 实锤）：pi-web 侧 `_shared/agent-spawn-env.ts` 注入的
+ * `AITI_BRIDGE_URL = <piWebSelfBase>/api/extensions/aiti-devtools` 是**给
+ * aiti-mcp-shim 的「扩展路径签名」形态**（shim 自行归一为 `<extBase>/mcp/mcp`）。
+ * 本扩展（AgentBridgeClient）直接拿它当桥 base 会 404：
+ *   POST <base>/bridge/agent/register → not found: bridge/agent/register
+ * （pi-web 扩展路由要求 mcp/ 前缀才进桥：`p[0] === "mcp"`）。
+ * 且 bootstrapBridge 会把该值写回 settings.json 形成自固化。
+ *
+ * 本模块把「一个地址」归一到本扩展需要的桥 base（含 /mcp 段），与 shim 的
+ * EXT_PATH_SIG 语义对齐：
+ *   …/api/extensions/aiti-devtools[/mcp[/mcp]][/…] → …/api/extensions/aiti-devtools/mcp
+ *   其余形态（独立桥 …/aiti、裸 origin、非法 URL）原样返回。
+ */
+
+/** pi-web 扩展路径签名（与 aiti-mcp-shim 的 EXT_PATH_SIG 同值） */
+export const PI_WEB_EXT_PATH_SIG = "/api/extensions/aiti-devtools";
+
+/** 归一为桥 base：识别 pi-web 扩展路径签名 → `<extBase>/mcp`；否则原样返回。 */
+export function normalizeBridgeBase(url: string): string {
+  try {
+    const u = new URL(url);
+    const idx = u.pathname.indexOf(PI_WEB_EXT_PATH_SIG);
+    if (idx < 0) return url;
+    const extBase = u.origin + u.pathname.slice(0, idx + PI_WEB_EXT_PATH_SIG.length);
+    return extBase + "/mcp";
+  } catch {
+    return url;
+  }
+}