monk-pi 0.1.0 → 0.2.0

package/README.md

@@ -74,6 +74,7 @@ monk-pi --model monk "帮我设计一套分布式系统的架构方案"
 
 ## 🧰 专属管理命令
 
+### 终端 CLI 指令
 | 命令 | 说明 |
 | :--- | :--- |
 | `monk-pi login` (或 `auth`) | 交互式配置或更新 Monk API Key，并自动同步至 Pi |
@@ -81,6 +82,21 @@ monk-pi --model monk "帮我设计一套分布式系统的架构方案"
 | `monk-pi model [name]` | 查看或切换默认主力模型 (`monk-coding` / `monk-fast` / `monk`) |
 | `monk-pi doctor` | 一键诊断 Node、Pi 运行时、配置文件健康度与网络状况 |
 
+### TUI 内部 Slash 指令 (`/monk`)
+在交互式编码过程中，随时输入 `/monk` 即可呼出 Monk 专属控制菜单：
+- `/monk`：呼出图形化快捷选择菜单
+- `/monk model`：在当前会话中秒级免重启切换主力模型 (`monk-coding` / `monk-fast` / `monk`)
+- `/monk ping`：实时测试当前 Monk API 连接与端到端延迟
+- `/monk account`：查询用量与账号到期状态
+
+---
+
+## 🎨 原生 TUI 状态栏与上下文溢出自动恢复
+
+Monk-Pi 自动为 Pi 部署原生扩展 (`~/.pi/agent/extensions/monk.ts`)：
+1. **底部状态栏 (Footer Status)**：实时显示当前激活的 Monk 模型、1M 上下文标识以及 Turn 轮次状态。
+2. **上下文溢出自动恢复 (Compaction Recovery)**：在超长代码重构会话中，智能拦截 Monk 上游的 Token/Context 溢出异常，自动标准化为 Pi 识别的溢出信号，**无感触发智能压缩与自动重试**，杜绝会话意外中断。
+
 ---
 
 ## ⚙️ 自动注入的 Pi 最佳配置
@@ -137,10 +153,10 @@ monk-pi --model monk "帮我设计一套分布式系统的架构方案"
   - [x] Pi 运行时环境检测与自动注入
   - [x] `status` / `doctor` / `model` 诊断指令
   - [x] 完整参数透传与 TTY 会话继承
-- [ ] **Phase 2: Monk 原生 Pi Extension**
-  - [ ] TUI 底部状态栏展示 Monk 订阅剩余天数与今日用量
-  - [ ] 针对 Monk 代理的上游报错拦截与自动 Context Compaction 重试机制
-  - [ ] `/monk` 专属 Slash 快捷指令
+- [x] **Phase 2: Monk 原生 Pi Extension**
+  - [x] TUI 底部状态栏展示 Monk 状态与活跃模型
+  - [x] 针对 Monk 代理的上游报错拦截与自动 Context Compaction 重试机制
+  - [x] `/monk` 专属 Slash 快捷指令（秒切模型、测速与用量查询）
 - [ ] **Phase 3: 生态共建**
   - [ ] 提交收录至 monk.party 帮助中心客户端推荐列表
 

package/dist/{chunk-DHF5QVTM.js → chunk-6OMOTI3T.js}

@@ -46,9 +46,216 @@ function getPiModelsFile() {
 function getPiSettingsFile() {
   return path.join(getPiHomeDir(), "settings.json");
 }
+function getPiExtensionsDir() {
+  return path.join(getPiHomeDir(), "extensions");
+}
+function getPiMonkExtensionFile() {
+  return path.join(getPiExtensionsDir(), "monk.ts");
+}
 
 // src/config.ts
 import fs from "fs";
+
+// src/extension/code.ts
+var MONK_EXTENSION_CODE = `// @monk-managed-pi-extension
+// Monk \xD7 Pi Native Extension
+// Features: Footer status, /monk slash command, and context overflow auto-compaction
+
+const MONK_MODELS = [
+  { id: "monk-coding", label: "monk-coding (\u4EE3\u7801\u4E3B\u529B - \u63A8\u8350 \xB7 \u6DF1\u5EA6\u5DE5\u5177\u8C03\u7528)" },
+  { id: "monk-fast", label: "monk-fast (\u6781\u901F\u63A8\u7406 \xB7 \u5FEB\u901F\u95EE\u7B54\u4E0E\u8F7B\u91CF\u4EFB\u52A1)" },
+  { id: "monk", label: "monk (\u878D\u5408\u65D7\u8230 \xB7 \u8D28\u91CF\u4F18\u5148\u4E0E\u7EFC\u5408\u63A8\u7406)" },
+];
+
+const OVERFLOW_PATTERNS = [
+  /context.*length/i,
+  /maximum.*tokens/i,
+  /token.*limit/i,
+  /too many tokens/i,
+  /prompt.*too long/i,
+  /request.*too large/i,
+  /context_window_exceeded/i,
+  /exceed.*context/i,
+];
+
+export default function monkExtension(pi) {
+  let turnCount = 0;
+
+  function updateStatus(ctx) {
+    if (!ctx.ui) return;
+    const model = ctx.model;
+    const isMonk = model && model.provider === "monk";
+
+    if (!isMonk) {
+      ctx.ui.setStatus("monk", undefined);
+      return;
+    }
+
+    const theme = ctx.ui.theme;
+    const indicator = theme.fg("success", "\u25CF");
+    const label = theme.fg("accent", \`Monk: \${model.id}\`);
+    const meta = theme.fg("dim", " (1M ctx)");
+    ctx.ui.setStatus("monk", \`\${indicator} \${label}\${meta}\`);
+  }
+
+  // 1. Lifecycle Events: update footer status
+  pi.on("session_start", async (_event, ctx) => {
+    updateStatus(ctx);
+  });
+
+  pi.on("model_select", async (_event, ctx) => {
+    updateStatus(ctx);
+  });
+
+  pi.on("turn_start", async (_event, ctx) => {
+    turnCount++;
+    if (!ctx.ui) return;
+    const model = ctx.model;
+    if (model && model.provider === "monk") {
+      const theme = ctx.ui.theme;
+      const spinner = theme.fg("warning", "\u25B2");
+      const label = theme.fg("accent", \`Monk: \${model.id}\`);
+      const text = theme.fg("dim", \` [Turn \${turnCount}]\`);
+      ctx.ui.setStatus("monk", \`\${spinner} \${label}\${text}\`);
+    }
+  });
+
+  pi.on("turn_end", async (_event, ctx) => {
+    updateStatus(ctx);
+  });
+
+  // 2. Intelligent Context Overflow & Compaction Recovery
+  pi.on("message_end", async (event, ctx) => {
+    const message = event.message;
+    if (!message || message.role !== "assistant") return;
+    if (message.stopReason !== "error") return;
+
+    const isMonk = message.provider === "monk" || (ctx.model && ctx.model.provider === "monk");
+    if (!isMonk) return;
+
+    const errorMsg = message.errorMessage || "";
+    if (errorMsg.includes("context_length_exceeded")) return;
+
+    const isOverflow = OVERFLOW_PATTERNS.some((p) => p.test(errorMsg));
+    if (isOverflow) {
+      ctx.ui && ctx.ui.notify(
+        "Monk: \u68C0\u6D4B\u5230\u4E0A\u4E0B\u6587\u8D85\u957F\uFF0C\u5DF2\u81EA\u52A8\u91CD\u5199\u9519\u8BEF\u5E76\u89E6\u53D1\u667A\u80FD\u538B\u7F29 (Compaction) \u91CD\u8BD5...",
+        "warning"
+      );
+      return {
+        message: {
+          ...message,
+          errorMessage: \`context_length_exceeded: \${errorMsg}\`,
+        },
+      };
+    }
+  });
+
+  // 3. Custom Slash Command: /monk
+  pi.registerCommand("monk", {
+    description: "Monk \u4E13\u5C5E\u63A7\u5236\u53F0 (/monk [model|ping|status|account])",
+    handler: async (args, ctx) => {
+      const sub = (args || "").trim().toLowerCase();
+
+      if (sub === "model" || sub === "switch") {
+        await handleModelSwitch(pi, ctx);
+        return;
+      }
+
+      if (sub === "ping" || sub === "status") {
+        await handlePing(ctx);
+        return;
+      }
+
+      if (sub === "account" || sub === "quota") {
+        ctx.ui && ctx.ui.notify("Monk \u7528\u91CF\u4E0E\u5230\u671F\u67E5\u8BE2: https://monk.party/account/", "info");
+        return;
+      }
+
+      // Default: interactive menu
+      await handleMenu(pi, ctx);
+    },
+  });
+}
+
+async function handleModelSwitch(pi, ctx) {
+  if (!ctx.ui) return;
+
+  const choices = MONK_MODELS.map((m) => m.label);
+  const selectedLabel = await ctx.ui.select("\u9009\u62E9\u5F53\u524D\u4F1A\u8BDD\u7684 Monk \u6A21\u578B:", choices);
+
+  if (!selectedLabel) return;
+
+  const matched = MONK_MODELS.find((m) => m.label === selectedLabel);
+  if (!matched) return;
+
+  const model = ctx.modelRegistry.find("monk", matched.id);
+  if (!model) {
+    ctx.ui.notify(\`\u672A\u5728\u914D\u7F6E\u4E2D\u627E\u5230\u6A21\u578B: monk/\${matched.id}\`, "error");
+    return;
+  }
+
+  const success = await pi.setModel(model);
+  if (success) {
+    ctx.ui.notify(\`\u4E3B\u529B\u6A21\u578B\u5DF2\u5207\u6362\u81F3: \${matched.id}\`, "info");
+  } else {
+    ctx.ui.notify(\`\u5207\u6362\u5931\u8D25\uFF0C\u672A\u80FD\u8BBE\u7F6E\u6A21\u578B: \${matched.id}\`, "error");
+  }
+}
+
+async function handlePing(ctx) {
+  if (!ctx.ui) return;
+
+  const startTime = Date.now();
+  const apiKey = process.env.MONK_API_KEY || "";
+
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 6000);
+
+    const res = await fetch("https://monk.party/v1/models", {
+      headers: { Authorization: \`Bearer \${apiKey}\` },
+      signal: controller.signal,
+    });
+
+    clearTimeout(timeout);
+    const latency = Date.now() - startTime;
+
+    if (res.ok) {
+      ctx.ui.notify(\`Monk API \u8FDE\u901A\u6B63\u5E38 \xB7 \u5EF6\u8FDF \${latency}ms\`, "info");
+    } else {
+      ctx.ui.notify(\`Monk API \u54CD\u5E94\u5F02\u5E38 (HTTP \${res.status})\`, "warning");
+    }
+  } catch (err) {
+    ctx.ui.notify(
+      \`Monk API \u8FDE\u63A5\u5931\u8D25: \${err instanceof Error ? err.message : String(err)}\`,
+      "error"
+    );
+  }
+}
+
+async function handleMenu(pi, ctx) {
+  if (!ctx.ui) return;
+
+  const choice = await ctx.ui.select("Monk API \u63A7\u5236\u53F0", [
+    "1. \u5207\u6362\u4F1A\u8BDD\u6A21\u578B (Switch Model)",
+    "2. \u63A2\u6D4B\u7F51\u7EDC\u5EF6\u8FDF (Ping API)",
+    "3. \u67E5\u8BE2\u7528\u91CF\u4E0E\u5230\u671F\u65F6\u95F4 (Account Info)",
+  ]);
+
+  if (!choice) return;
+
+  if (choice.startsWith("1")) {
+    await handleModelSwitch(pi, ctx);
+  } else if (choice.startsWith("2")) {
+    await handlePing(ctx);
+  } else if (choice.startsWith("3")) {
+    ctx.ui.notify("\u8BF7\u5728\u6D4F\u89C8\u5668\u6253\u5F00 https://monk.party/account/ \u67E5\u770B\u7528\u91CF\u4E0E\u5269\u4F59\u5929\u6570", "info");
+  }
+}
+`;
+
+// src/config.ts
 function loadMonkConfig() {
   const configFile = getMonkConfigFile();
   try {
@@ -147,6 +354,23 @@ function syncPiModelsJson(apiKey) {
     };
   }
 }
+function syncPiExtension() {
+  const extDir = getPiExtensionsDir();
+  const extFile = getPiMonkExtensionFile();
+  try {
+    if (!fs.existsSync(extDir)) {
+      fs.mkdirSync(extDir, { recursive: true });
+    }
+    fs.writeFileSync(extFile, MONK_EXTENSION_CODE.trim() + "\n", "utf-8");
+    return { success: true, path: extFile };
+  } catch (err) {
+    return {
+      success: false,
+      path: extFile,
+      error: err instanceof Error ? err.message : String(err)
+    };
+  }
+}
 function getDefaultModel() {
   const config = loadMonkConfig();
   if (config.defaultModel && MONK_MODELS.some((m) => m.id === config.defaultModel)) {
@@ -583,6 +807,18 @@ async function doctorCommand() {
     syncPiModelsJson(key);
     logSuccess(`Pi \u914D\u7F6E\u6587\u4EF6: \u521B\u5EFA\u5B8C\u6210`);
   }
+  const extFile = getPiMonkExtensionFile();
+  if (fs3.existsSync(extFile)) {
+    logSuccess(`Pi \u539F\u751F\u6269\u5C55: ${pc3.bold("\u5DF2\u5B89\u88C5")} (/monk \u6307\u4EE4\u3001\u72B6\u6001\u680F\u4E0E\u6EA2\u51FA\u81EA\u52A8\u91CD\u8BD5\u5C31\u7EEA)`);
+  } else {
+    logWarn(`Pi \u539F\u751F\u6269\u5C55: \u672A\u5B89\u88C5\uFF0C\u6B63\u5728\u4E3A\u60A8\u81EA\u52A8\u90E8\u7F72...`);
+    const extRes = syncPiExtension();
+    if (extRes.success) {
+      logSuccess(`Pi \u539F\u751F\u6269\u5C55: \u90E8\u7F72\u5B8C\u6210`);
+    } else {
+      logError(`Pi \u539F\u751F\u6269\u5C55\u90E8\u7F72\u5931\u8D25: ${extRes.error}`);
+    }
+  }
   if (key) {
     process.stdout.write(`  ${pc3.dim("\u23F3 \u6B63\u5728\u63A2\u6D4B\u4E0E monk.party \u63A5\u53E3\u7684\u8FDE\u901A\u6027...")} `);
     const val = await validateApiKey(key);
@@ -631,11 +867,15 @@ async function loginCommand() {
   });
   logSuccess(`\u51ED\u8BC1\u5DF2\u4FDD\u5B58\u81F3\u672C\u5730\u914D\u7F6E`);
   const syncResult = syncPiModelsJson(apiKey);
+  const extResult = syncPiExtension();
   if (syncResult.success) {
     logSuccess(`\u5DF2\u6210\u529F\u540C\u6B65\u5E76\u4F18\u5316 Pi \u914D\u7F6E\u6587\u4EF6: ${pc4.dim(syncResult.path)}`);
   } else {
     logWarn(`\u540C\u6B65 Pi \u914D\u7F6E\u6587\u4EF6\u5931\u8D25: ${syncResult.error}`);
   }
+  if (extResult.success) {
+    logSuccess(`\u5DF2\u5B89\u88C5 Monk \u539F\u751F TUI \u6269\u5C55: ${pc4.dim(extResult.path)}`);
+  }
   console.log();
   logSuccess(`Monk \xD7 Pi \u5C31\u7EEA\uFF01\u73B0\u5728\u60A8\u53EF\u4EE5\u76F4\u63A5\u8F93\u5165 ${pc4.bold(pc4.yellow("monk-pi"))} \u5F00\u59CB\u7F16\u7801\u3002`);
   console.log();
@@ -699,6 +939,7 @@ async function runCommand(passthroughArgs) {
     return 1;
   }
   syncPiModelsJson(key);
+  syncPiExtension();
   const defaultModel = getDefaultModel();
   return launchPi({
     apiKey: key,
@@ -782,10 +1023,13 @@ export {
   getPiHomeDir,
   getPiModelsFile,
   getPiSettingsFile,
+  getPiExtensionsDir,
+  getPiMonkExtensionFile,
   loadMonkConfig,
   saveMonkConfig,
   resolveApiKey,
   syncPiModelsJson,
+  syncPiExtension,
   getDefaultModel,
   validateApiKey,
   testChatCompletion,

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   printBanner,
   runCommand,
   statusCommand
-} from "./chunk-DHF5QVTM.js";
+} from "./chunk-6OMOTI3T.js";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/index.d.ts

@@ -30,6 +30,8 @@ declare function getMonkConfigFile(): string;
 declare function getPiHomeDir(): string;
 declare function getPiModelsFile(): string;
 declare function getPiSettingsFile(): string;
+declare function getPiExtensionsDir(): string;
+declare function getPiMonkExtensionFile(): string;
 
 interface MonkLocalConfig {
     apiKey?: string;
@@ -56,6 +58,14 @@ declare function syncPiModelsJson(apiKey?: string): {
     path: string;
     error?: string;
 };
+/**
+ * Safely writes or updates the Monk native extension in ~/.pi/agent/extensions/monk.ts
+ */
+declare function syncPiExtension(): {
+    success: boolean;
+    path: string;
+    error?: string;
+};
 /**
  * Gets the current default model
  */
@@ -149,4 +159,4 @@ declare function doctorCommand(): Promise<void>;
 
 declare function runCommand(passthroughArgs: string[]): Promise<number>;
 
-export { type CompletionTestResult, DEFAULT_MONK_MODEL, type LaunchPiOptions, MONK_ACCOUNT_URL, MONK_BASE_URL, MONK_MODELS, MONK_WEBSITE, type MonkLocalConfig, type MonkModelId, type PiBinaryType, type ResolvedPi, type ValidateResult, detectPackageManager, detectPi, doctorCommand, getDefaultModel, getMonkConfigFile, getMonkHomeDir, getPiHomeDir, getPiModelsFile, getPiSettingsFile, installPi, launchPi, loadMonkConfig, logError, logInfo, logStep, logSuccess, logWarn, loginCommand, maskKey, modelCommand, printBanner, promptForApiKey, promptInstallPi, promptSelectModel, resolveApiKey, resolvePiBinary, runCommand, saveMonkConfig, statusCommand, syncPiModelsJson, testChatCompletion, validateApiKey };
+export { type CompletionTestResult, DEFAULT_MONK_MODEL, type LaunchPiOptions, MONK_ACCOUNT_URL, MONK_BASE_URL, MONK_MODELS, MONK_WEBSITE, type MonkLocalConfig, type MonkModelId, type PiBinaryType, type ResolvedPi, type ValidateResult, detectPackageManager, detectPi, doctorCommand, getDefaultModel, getMonkConfigFile, getMonkHomeDir, getPiExtensionsDir, getPiHomeDir, getPiModelsFile, getPiMonkExtensionFile, getPiSettingsFile, installPi, launchPi, loadMonkConfig, logError, logInfo, logStep, logSuccess, logWarn, loginCommand, maskKey, modelCommand, printBanner, promptForApiKey, promptInstallPi, promptSelectModel, resolveApiKey, resolvePiBinary, runCommand, saveMonkConfig, statusCommand, syncPiExtension, syncPiModelsJson, testChatCompletion, validateApiKey };

package/dist/index.js

@@ -10,8 +10,10 @@ import {
   getDefaultModel,
   getMonkConfigFile,
   getMonkHomeDir,
+  getPiExtensionsDir,
   getPiHomeDir,
   getPiModelsFile,
+  getPiMonkExtensionFile,
   getPiSettingsFile,
   installPi,
   launchPi,
@@ -33,10 +35,11 @@ import {
   runCommand,
   saveMonkConfig,
   statusCommand,
+  syncPiExtension,
   syncPiModelsJson,
   testChatCompletion,
   validateApiKey
-} from "./chunk-DHF5QVTM.js";
+} from "./chunk-6OMOTI3T.js";
 export {
   DEFAULT_MONK_MODEL,
   MONK_ACCOUNT_URL,
@@ -49,8 +52,10 @@ export {
   getDefaultModel,
   getMonkConfigFile,
   getMonkHomeDir,
+  getPiExtensionsDir,
   getPiHomeDir,
   getPiModelsFile,
+  getPiMonkExtensionFile,
   getPiSettingsFile,
   installPi,
   launchPi,
@@ -72,6 +77,7 @@ export {
   runCommand,
   saveMonkConfig,
   statusCommand,
+  syncPiExtension,
   syncPiModelsJson,
   testChatCompletion,
   validateApiKey

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monk-pi",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Zero-config harness for running Pi Coding Agent with Monk API (monk.party)",
   "type": "module",
   "bin": "./dist/cli.js",
@@ -25,7 +25,15 @@
     "harness",
     "cli"
   ],
-  "author": "",
+  "author": "yaoleifly",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yaoleifly/monk-pi.git"
+  },
+  "homepage": "https://github.com/yaoleifly/monk-pi#readme",
+  "bugs": {
+    "url": "https://github.com/yaoleifly/monk-pi/issues"
+  },
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"