@aiti-ai/aiti-devtools-vite 0.0.0-stage → 0.1.1

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-vite
 
-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.
+> Vite 载体插件：dev server 内置桥/MCP（同源 /aiti/）+ launcher 自动注入 + 启动自动注册 agent 工具；SvelteKit 等任意 Vite 工程同样适用；dev-only，生产构建零注入。
+
+## 来源 · 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>
+
+## 功能定位（中文）
+
+Vite 载体插件：dev server 内置桥/MCP（同源 /aiti/）+ launcher 自动注入 + 启动自动注册 agent 工具；SvelteKit 等任意 Vite 工程同样适用；dev-only，生产构建零注入。
+
+## Positioning (English)
+
+Vite carrier plugin: dev-server-embedded bridge/MCP (same-origin /aiti/) + automatic launcher injection + MCP auto-registration at startup; works for SvelteKit and any Vite project; dev-only, zero injection in production builds.
+
+## 安装 / 部署
+
+```bash
+npm install -D @aiti-ai/aiti-devtools-vite
+```
+
+不同载体的接线方式见文档（多数一行接入）。
+
+## 文档 · Documentation
+
+- 中文完整文档（aiti-docs）: <https://aiti.pw/devtools/integrations/vite.html>
+- English docs: <https://aiti.pw/en/devtools/integrations/vite.html>
+- 扩展注册表 / registry: <https://aiti.pw/extensions.html> · machine-readable <https://aiti.pw/extensions.json>
+
+## License
+
+MIT

package/dist/astro.js

@@ -0,0 +1,137 @@
+// src/index.ts
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { createBridge, connectBridge, resolveEndpoints, registerMcp, loadAssets, htmlInjectMiddleware } from "@aiti-ai/aiti-devtools-core";
+function hashOf(content) {
+  return createHash("sha1").update(content).digest("hex").slice(0, 8);
+}
+function originOf(server) {
+  const local = server.resolvedUrls?.local?.[0];
+  if (local) return local.replace(/\/+$/, "");
+  const addr = server.httpServer?.address();
+  const port = typeof addr === "object" && addr ? addr.port : server.config.server.port;
+  return `http://localhost:${port ?? 5173}`;
+}
+function matchPatterns(file, patterns) {
+  if (!patterns || !patterns.length) return true;
+  return patterns.some((p) => p instanceof RegExp ? p.test(file) : file.includes(p));
+}
+function aitiDevtools(opts = {}) {
+  const prefix = (opts.prefix || "/aiti").replace(/\/+$/, "") || "/aiti";
+  const name = opts.name || "aiti-devtools";
+  const log = opts.log || ((l) => console.log(l));
+  const dataDir = opts.dataDir || process.env.AITI_BRIDGE_DATA_DIR || join(homedir(), ".pi", "aiti-bridge");
+  const staticFiles = loadAssets(opts.assetsDir);
+  const bridge = createBridge(dataDir, { name });
+  const printBanner = (server, e) => {
+    const kindLabel = e.kind === "same-origin" ? "\u540C\u6E90\u6A21\u5F0F" : "\u5916\u90E8\u6865\u6A21\u5F0F";
+    log("");
+    log(`[${name}] \u{1F9F0} ${name}-vite \u5DF2\u542F\u52A8\uFF08${kindLabel} \xB7 name=${name}\uFF09`);
+    log(`  launcher:  ${e.launcherUrl}`);
+    log(`  \u64CD\u4F5C\u53F0:    ${e.cockpitUrl}`);
+    log(`  MCP:       ${e.mcpUrl}   \u2190 agent \u7684 mcp \u914D\u7F6E url \u6307\u8FD9\u91CC`);
+    log(`  bridge:    ${e.bridgeBase}`);
+    log(`  AI \u7A97:     ${e.aiUrl}${opts.aiUrl ? "\uFF08aiti-agent\uFF09" : "\uFF08\u540C\u6E90 cockpit\uFF0C\u53EF\u7528 aiUrl \u6307\u5B9A aiti-agent\uFF09"}`);
+    for (const n of e.notes) log(`  \xB7 ${n}`);
+  };
+  const doRegisterMcp = (server, e) => {
+    const m = opts.mcp || {};
+    if (m.register === false || m.targets === false) return;
+    const r = registerMcp({
+      url: e.mcpUrl,
+      serverName: name,
+      targets: m.targets === false ? void 0 : m.targets || "auto",
+      configPaths: m.configPaths || [],
+      projectDir: server.config.root,
+      dryRun: !!m.dryRun,
+      log
+    });
+    log(`[${name}] MCP \u6CE8\u518C\uFF1A${r.summary}`);
+    if (r.ok && !r.changed) log(`[${name}]    \uFF08\u5168\u90E8\u5DF2\u662F\u6700\u65B0\uFF0C\u672A\u5199\u76D8\uFF09`);
+  };
+  const endpointsFor = (server) => resolveEndpoints({ bridgeUrl: opts.bridgeUrl, aiUrl: opts.aiUrl, serverUrl: originOf(server), prefix });
+  const mount = (server) => {
+    server.middlewares.use(connectBridge(bridge, { prefix, staticFiles }));
+    server.httpServer?.once("listening", () => {
+      try {
+        const e = endpointsFor(server);
+        printBanner(server, e);
+        doRegisterMcp(server, e);
+      } catch (err) {
+        log(`[${name}] \u26A0 \u542F\u52A8\u540E\u5904\u7406\u5931\u8D25\uFF1A${err.message}`);
+      }
+    });
+  };
+  const injectHtml = (server) => {
+    if (opts.inject === false) return;
+    server.middlewares.stack.unshift({ route: "", handle: htmlInjectMiddleware({ prefix, name }) });
+  };
+  return {
+    name: "@aiti-ai/aiti-devtools-vite",
+    // dev-only：生产构建（vite build）整个插件不生效——产物零注入
+    apply: "serve",
+    configureServer(server) {
+      injectHtml(server);
+      mount(server);
+    },
+    configurePreviewServer(server) {
+      injectHtml(server);
+      mount(server);
+    },
+    transformIndexHtml(html, ctx) {
+      const inject = opts.inject === false ? false : true;
+      if (!inject) return html;
+      const cfg = typeof opts.inject === "object" ? opts.inject : {};
+      const file = ctx.filename || ctx.path || "";
+      if (cfg.exclude?.length && matchPatterns(file, cfg.exclude)) return html;
+      if (cfg.include?.length && !matchPatterns(file, cfg.include)) return html;
+      const server = ctx.server;
+      const e = endpointsFor(server || {});
+      const launcher = staticFiles["/aiti-launcher.js"];
+      const v = launcher?.content ? hashOf(launcher.content) : Date.now().toString(36);
+      return [
+        {
+          tag: "script",
+          attrs: {
+            src: `${e.origin}${prefix}/aiti-launcher.js?v=${v}`,
+            "data-ai-url": e.aiUrl,
+            "data-bridge-url": e.bridgeBase,
+            "data-name": name
+          },
+          injectTo: "head-prepend"
+        }
+      ];
+    }
+  };
+}
+
+// src/astro.ts
+function aitiAstro(opts = {}) {
+  return {
+    name: "aiti-devtools-astro",
+    hooks: {
+      "astro:config:setup"({ command, updateConfig, injectScript }) {
+        if (command !== "dev") return;
+        updateConfig({
+          vite: {
+            plugins: [aitiDevtools(opts)]
+          }
+        });
+        const prefix = opts.prefix || "/aiti";
+        const bridgeUrl = opts.bridgeUrl || prefix;
+        const aiUrl = opts.aiUrl || prefix + "/cockpit.html";
+        const name = opts.name || "aiti-devtools";
+        injectScript(
+          "head-inline",
+          `(function(){var s=document.createElement('script');s.src='${bridgeUrl}/aiti-launcher.js';s.setAttribute('data-ai-url','${aiUrl}');s.setAttribute('data-bridge-url','${bridgeUrl}');s.setAttribute('data-name','${name}');document.head.appendChild(s);})()`
+        );
+      }
+    }
+  };
+}
+var astro_default = aitiAstro;
+export {
+  aitiAstro,
+  astro_default as default
+};

package/dist/index.js

@@ -0,0 +1,112 @@
+// src/index.ts
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { createBridge, connectBridge, resolveEndpoints, registerMcp, loadAssets, htmlInjectMiddleware } from "@aiti-ai/aiti-devtools-core";
+function hashOf(content) {
+  return createHash("sha1").update(content).digest("hex").slice(0, 8);
+}
+function originOf(server) {
+  const local = server.resolvedUrls?.local?.[0];
+  if (local) return local.replace(/\/+$/, "");
+  const addr = server.httpServer?.address();
+  const port = typeof addr === "object" && addr ? addr.port : server.config.server.port;
+  return `http://localhost:${port ?? 5173}`;
+}
+function matchPatterns(file, patterns) {
+  if (!patterns || !patterns.length) return true;
+  return patterns.some((p) => p instanceof RegExp ? p.test(file) : file.includes(p));
+}
+function aitiDevtools(opts = {}) {
+  const prefix = (opts.prefix || "/aiti").replace(/\/+$/, "") || "/aiti";
+  const name = opts.name || "aiti-devtools";
+  const log = opts.log || ((l) => console.log(l));
+  const dataDir = opts.dataDir || process.env.AITI_BRIDGE_DATA_DIR || join(homedir(), ".pi", "aiti-bridge");
+  const staticFiles = loadAssets(opts.assetsDir);
+  const bridge = createBridge(dataDir, { name });
+  const printBanner = (server, e) => {
+    const kindLabel = e.kind === "same-origin" ? "\u540C\u6E90\u6A21\u5F0F" : "\u5916\u90E8\u6865\u6A21\u5F0F";
+    log("");
+    log(`[${name}] \u{1F9F0} ${name}-vite \u5DF2\u542F\u52A8\uFF08${kindLabel} \xB7 name=${name}\uFF09`);
+    log(`  launcher:  ${e.launcherUrl}`);
+    log(`  \u64CD\u4F5C\u53F0:    ${e.cockpitUrl}`);
+    log(`  MCP:       ${e.mcpUrl}   \u2190 agent \u7684 mcp \u914D\u7F6E url \u6307\u8FD9\u91CC`);
+    log(`  bridge:    ${e.bridgeBase}`);
+    log(`  AI \u7A97:     ${e.aiUrl}${opts.aiUrl ? "\uFF08aiti-agent\uFF09" : "\uFF08\u540C\u6E90 cockpit\uFF0C\u53EF\u7528 aiUrl \u6307\u5B9A aiti-agent\uFF09"}`);
+    for (const n of e.notes) log(`  \xB7 ${n}`);
+  };
+  const doRegisterMcp = (server, e) => {
+    const m = opts.mcp || {};
+    if (m.register === false || m.targets === false) return;
+    const r = registerMcp({
+      url: e.mcpUrl,
+      serverName: name,
+      targets: m.targets === false ? void 0 : m.targets || "auto",
+      configPaths: m.configPaths || [],
+      projectDir: server.config.root,
+      dryRun: !!m.dryRun,
+      log
+    });
+    log(`[${name}] MCP \u6CE8\u518C\uFF1A${r.summary}`);
+    if (r.ok && !r.changed) log(`[${name}]    \uFF08\u5168\u90E8\u5DF2\u662F\u6700\u65B0\uFF0C\u672A\u5199\u76D8\uFF09`);
+  };
+  const endpointsFor = (server) => resolveEndpoints({ bridgeUrl: opts.bridgeUrl, aiUrl: opts.aiUrl, serverUrl: originOf(server), prefix });
+  const mount = (server) => {
+    server.middlewares.use(connectBridge(bridge, { prefix, staticFiles }));
+    server.httpServer?.once("listening", () => {
+      try {
+        const e = endpointsFor(server);
+        printBanner(server, e);
+        doRegisterMcp(server, e);
+      } catch (err) {
+        log(`[${name}] \u26A0 \u542F\u52A8\u540E\u5904\u7406\u5931\u8D25\uFF1A${err.message}`);
+      }
+    });
+  };
+  const injectHtml = (server) => {
+    if (opts.inject === false) return;
+    server.middlewares.stack.unshift({ route: "", handle: htmlInjectMiddleware({ prefix, name }) });
+  };
+  return {
+    name: "@aiti-ai/aiti-devtools-vite",
+    // dev-only：生产构建（vite build）整个插件不生效——产物零注入
+    apply: "serve",
+    configureServer(server) {
+      injectHtml(server);
+      mount(server);
+    },
+    configurePreviewServer(server) {
+      injectHtml(server);
+      mount(server);
+    },
+    transformIndexHtml(html, ctx) {
+      const inject = opts.inject === false ? false : true;
+      if (!inject) return html;
+      const cfg = typeof opts.inject === "object" ? opts.inject : {};
+      const file = ctx.filename || ctx.path || "";
+      if (cfg.exclude?.length && matchPatterns(file, cfg.exclude)) return html;
+      if (cfg.include?.length && !matchPatterns(file, cfg.include)) return html;
+      const server = ctx.server;
+      const e = endpointsFor(server || {});
+      const launcher = staticFiles["/aiti-launcher.js"];
+      const v = launcher?.content ? hashOf(launcher.content) : Date.now().toString(36);
+      return [
+        {
+          tag: "script",
+          attrs: {
+            src: `${e.origin}${prefix}/aiti-launcher.js?v=${v}`,
+            "data-ai-url": e.aiUrl,
+            "data-bridge-url": e.bridgeBase,
+            "data-name": name
+          },
+          injectTo: "head-prepend"
+        }
+      ];
+    }
+  };
+}
+var index_default = aitiDevtools;
+export {
+  aitiDevtools,
+  index_default as default
+};

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@aiti-ai/aiti-devtools-vite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "aiti-devtools Vite 插件：应用 dev server 上内置 MCP（launcher 注入 + 桥 + MCP 端点 + 操作台，同源 /aiti/），启动自动注册到常见 agent 工具",
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./astro": "./dist/astro.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aiti-ai/aiti-devtools-core": "^0.3.5"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
+  },
+  "devDependencies": {
+    "vite": "^6.4.3"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --format=esm --outfile=dist/index.js --target=es2022 --platform=node --external:@aiti-ai/aiti-devtools-core --external:vite && esbuild src/astro.ts --bundle --format=esm --outfile=dist/astro.js --target=es2022 --platform=node --external:@aiti-ai/aiti-devtools-core"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aiti-ai/aiti-ai.git",
+    "directory": "packages/aiti-devtools-vite"
+  },
+  "homepage": "https://github.com/aiti-ai/aiti-ai#readme",
+  "bugs": {
+    "url": "https://github.com/aiti-ai/aiti-ai/issues"
+  },
+  "contentHash": "234b8a558de186b0"
+}