@cydm/pie 1.0.23 → 1.0.25

package/README.md

@@ -20,7 +20,7 @@ Pie is developed by [cydream](https://cydream.tech).
 npm install -g @cydm/pie
 ```
 
-Pie supports Node.js 20 and newer. Release builds are validated with npm's lockfile workflow (`npm ci`) so dependency resolution is reproducible.
+Pie requires Node.js 20.19 or newer. Release builds are validated with npm's lockfile workflow (`npm ci`) so dependency resolution is reproducible.
 
 ## Quick Start
 
@@ -104,6 +104,24 @@ pie models init --stdout
 
 For editor auto-complete and validation, you can also point the optional `"$schema"` field in your local `models.json` at your installed `@cydm/pie/models.schema.json` file.
 
+### Remote model catalogs
+
+Pie can add centrally managed models without replacing local profiles or defaults. Add a catalog to `~/.pie/models.json` and keep the virtual key in an environment variable:
+
+```json
+{
+  "remoteCatalogs": [
+    {
+      "id": "token-manager",
+      "url": "https://token.magicshell.ai/v1/client-catalogs/pie.json",
+      "apiKeyEnv": "TOKEN_MANAGER_API_KEY"
+    }
+  ]
+}
+```
+
+Remote catalogs use a three-second timeout, reject redirects, and fall back to the last valid cached response. A local profile with the same id always wins. Remote catalogs never modify `defaults`.
+
 Start Pie in interactive mode:
 
 ```bash
@@ -199,10 +217,11 @@ Pie uses a hierarchical slash-command menu. The current built-in commands includ
 | `/skills/list` | List available skills |
 | `/skills/use` | Use a skill |
 | `/skills/reload` | Reload skills from disk |
+| `/settings/extensions` | List extensions and toggle enable/disable |
 | `/tools/subagent` | Spawn a subagent for a task |
-| `/debugs/cache-test` | Run provider cache diagnostics with a dedicated 2-request probe |
-| `/debugs/context` | Append a context summary to `~/.pie/logs/pie-cli.log` |
-| `/debugs/package` | Append a package summary to `~/.pie/logs/pie-cli.log` |
+| `/settings/debugs/cache-test` | Run provider cache diagnostics with a dedicated 2-request probe |
+| `/settings/debugs/context` | Append a context summary to `~/.pie/logs/pie-cli.log` |
+| `/settings/debugs/package` | Append a package summary to `~/.pie/logs/pie-cli.log` |
 
 Pie can also load extension-provided commands at runtime.
 
@@ -228,6 +247,33 @@ Pie supports Markdown-based skills and built-in extensions.
 
 That is part of what makes Pie embeddable: the CLI is only one interface on top of a broader agent toolkit.
 
+## Extension Sources, Priority, And Toggles
+
+Extensions are discovered from four sources in ascending priority (later sources shadow earlier ones by stable extension identity):
+
+1. `builtin` — shipped with the CLI (`ask-user`, `todo`, `plan-mode`, `subagent`, `init`, `changelog`, `deploy`, `files`, attachment handlers)
+2. `global` — `~/.pie/extensions/`
+3. `project` — `./.pie/extensions/`
+4. `configured` — repeated `--extension-path <dir>` flags
+
+Every extension is enabled by default. Toggles are sparse overrides stored in settings and applied by extension identity across all sources:
+
+- Interactive: choose **Extensions** in `/settings`, or use `/settings/extensions`, to open the user-default toggle menu. `/settings/extensions --project` edits project overrides; `/settings/extensions/list|enable|disable ...` remains available for command-driven use.
+- Scripts and third-party UIs: `pie extensions list [--json]`, `pie extensions enable|disable <name> [--project|--user]`
+- Process flags: `--no-builtin-extensions` (skip built-ins) and `--no-extensions` (skip all discovered sources; `--extension-path` still loads)
+
+Example override in `~/.pie/settings.json` (or `./.pie/settings.json` for project scope, which wins per identity):
+
+```jsonc
+{
+  "extensions": {
+    "plan-mode": { "enabled": false }
+  }
+}
+```
+
+The full contract (identity rules, schema, host integration) lives in [`docs/extensions-enablement.md`](../../docs/extensions-enablement.md).
+
 ## Browser Tools
 
 The built-in `browser-tools` skill uses Microsoft's Playwright CLI for visible browser automation. Its runtime dependencies ship with the CLI; do not run `npm install` inside the skill directory.
@@ -239,7 +285,7 @@ node <resolvedPath for browser-tools/playwright-cli.js> open https://example.com
 node <resolvedPath for browser-tools/playwright-cli.js> snapshot
 node <resolvedPath for browser-tools/playwright-cli.js> screenshot
 node <resolvedPath for browser-tools/playwright-cli.js> console
-node <resolvedPath for browser-tools/playwright-cli.js> network
+node <resolvedPath for browser-tools/playwright-cli.js> requests
 ```
 
 If Playwright's Chromium browser is not installed, run:

package/dist/builtin/extensions/ask-user/index.js

@@ -1,9 +1,9 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   createAskUserCapability
-} from "../../../chunks/chunk-AFTBFF6J.js";
-import "../../../chunks/chunk-PUZP2Q3F.js";
-import "../../../chunks/chunk-7ABSJC2D.js";
+} from "../../../chunks/chunk-O4DPFYYP.js";
+import "../../../chunks/chunk-4B42ZU4B.js";
+import "../../../chunks/chunk-64XJIKVK.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 
 // builtin/extensions/ask-user/index.ts

package/dist/builtin/extensions/ask-user/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@pie/ask-user-extension",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "pie": {
+    "name": "ask-user",
+    "main": "index.ts"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0"
+  }
+}

package/dist/builtin/extensions/changelog/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@pie/extension-changelog",
+  "version": "1.0.0",
+  "description": "Intelligent changelog management with gap detection",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "changelog",
+    "main": "index.ts"
+  }
+}

package/dist/builtin/extensions/deploy/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@pie/extension-deploy",
+  "version": "1.0.0",
+  "description": "Deployment assistance commands",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "deploy",
+    "main": "index.ts"
+  }
+}

package/dist/builtin/extensions/document-attachments/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@pie/extension-document-attachments",
+  "version": "1.0.0",
+  "description": "Document attachment handlers (PDF, DOCX, etc.)",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "document-attachments",
+    "main": "index.ts"
+  }
+}

package/dist/builtin/extensions/files/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@pie/extension-files",
+  "version": "1.0.0",
+  "description": "File browser with git status support",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "files",
+    "main": "index.ts"
+  },
+  "keywords": ["pie", "extension", "files", "git"],
+  "author": "Pie Team",
+  "license": "MIT"
+}

package/dist/builtin/extensions/init/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@pie/extension-init",
+  "version": "1.0.0",
+  "description": "Project initialization and root AGENTS.md management",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "init",
+    "main": "index.ts"
+  }
+}

package/dist/builtin/extensions/kimi-attachments/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@pie/extension-kimi-attachments",
+  "version": "1.0.0",
+  "description": "Kimi file upload attachment handlers",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "kimi-attachments",
+    "main": "index.ts"
+  }
+}

package/dist/builtin/extensions/plan-mode/index.js

@@ -7,9 +7,9 @@ import {
   isPlanModeSafeCommand,
   markCompletedPlanSteps,
   restoreExecutionState
-} from "../../../chunks/chunk-AFTBFF6J.js";
-import "../../../chunks/chunk-PUZP2Q3F.js";
-import "../../../chunks/chunk-7ABSJC2D.js";
+} from "../../../chunks/chunk-O4DPFYYP.js";
+import "../../../chunks/chunk-4B42ZU4B.js";
+import "../../../chunks/chunk-64XJIKVK.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 
 // builtin/extensions/plan-mode/index.ts

package/dist/builtin/extensions/plan-mode/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "plan-mode-extension",
+  "version": "1.0.0",
+  "description": "Plan Mode Extension for Pie - Read-only exploration mode with plan tracking",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "plan-mode",
+    "main": "index.ts"
+  }
+}

package/dist/builtin/extensions/subagent/index.js

@@ -1,13 +1,13 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   createCliHostCapabilities
-} from "../../../chunks/chunk-4WU5VAX4.js";
+} from "../../../chunks/chunk-BEWVRLCP.js";
 import {
   createSharedFileSystemTools,
   createSubagentCapability
-} from "../../../chunks/chunk-AFTBFF6J.js";
-import "../../../chunks/chunk-PUZP2Q3F.js";
-import "../../../chunks/chunk-7ABSJC2D.js";
+} from "../../../chunks/chunk-O4DPFYYP.js";
+import "../../../chunks/chunk-4B42ZU4B.js";
+import "../../../chunks/chunk-64XJIKVK.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 
 // builtin/extensions/subagent/index.ts

package/dist/builtin/extensions/subagent/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@pie/extension-subagent",
+  "version": "1.0.0",
+  "description": "Spawn child agents for isolated task handling",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "subagent",
+    "main": "index.ts"
+  },
+  "keywords": ["pie", "extension", "subagent"],
+  "author": "Pie Team",
+  "license": "MIT"
+}

package/dist/builtin/extensions/todo/index.js

@@ -7,9 +7,9 @@ import {
   executeManageTodoList,
   executionStateToTodos,
   restoreExecutionState
-} from "../../../chunks/chunk-AFTBFF6J.js";
-import "../../../chunks/chunk-PUZP2Q3F.js";
-import "../../../chunks/chunk-7ABSJC2D.js";
+} from "../../../chunks/chunk-O4DPFYYP.js";
+import "../../../chunks/chunk-4B42ZU4B.js";
+import "../../../chunks/chunk-64XJIKVK.js";
 import "../../../chunks/chunk-TG2EQLX2.js";
 
 // builtin/extensions/todo/index.ts

package/dist/builtin/extensions/todo/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@pie/extension-todo",
+  "version": "1.0.0",
+  "description": "Todo list management tool",
+  "main": "index.ts",
+  "type": "module",
+  "pie": {
+    "name": "todo",
+    "main": "index.ts"
+  }
+}

package/dist/builtin/skills/browser-tools/README.md

@@ -10,7 +10,7 @@ node playwright-cli.js open https://example.com
 node playwright-cli.js snapshot
 node playwright-cli.js screenshot
 node playwright-cli.js console
-node playwright-cli.js network
+node playwright-cli.js requests
 node playwright-cli.js close
 ```
 

package/dist/builtin/skills/browser-tools/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: browser-tools
-description: Interactive browser automation via Microsoft Playwright CLI. Use when you need to open pages, inspect DOM snapshots, click/type, capture screenshots, inspect console/network output, or test frontend flows in a real browser.
+description: Interactive browser automation via Microsoft Playwright CLI. Use when you need to open pages, inspect DOM snapshots, click/type, capture screenshots, inspect console/request output, or test frontend flows in a real browser.
 ---
 
 # Browser Tools
@@ -19,7 +19,7 @@ node <baseDir>/playwright-cli.js click "Submit"
 node <baseDir>/playwright-cli.js type "hello"
 node <baseDir>/playwright-cli.js screenshot
 node <baseDir>/playwright-cli.js console
-node <baseDir>/playwright-cli.js network
+node <baseDir>/playwright-cli.js requests
 node <baseDir>/playwright-cli.js close
 ```
 
@@ -27,7 +27,7 @@ Use `node <baseDir>/playwright-cli.js --help` for the full command list.
 
 ## Workflow
 
-Start with `open` or `goto`, then use `snapshot` before interacting. Prefer snapshot, console, and network output for diagnosis; use screenshots when visual layout matters. Use named sessions with `-s=<session>` when you need to keep multiple browser flows separate.
+Start with `open` or `goto`, then use `snapshot` before interacting. Prefer snapshot, console, and request output for diagnosis; use screenshots when visual layout matters. Use named sessions with `-s=<session>` when you need to keep multiple browser flows separate.
 
 If the browser is not installed, run:
 

package/dist/builtin/skills/browser-tools/playwright-cli.js

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
 
 import { spawnSync } from "node:child_process";
+import fs from "node:fs";
 import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 
 const require = createRequire(import.meta.url);
 
@@ -18,7 +21,25 @@ export function runPlaywrightCli(args = process.argv.slice(2), options = {}) {
 	});
 }
 
-if (import.meta.url === `file://${process.argv[1]}`) {
+function normalizeDirectEntryPath(candidate) {
+	const resolved = path.resolve(candidate);
+	const real = fs.realpathSync.native(resolved);
+	const normalized = path.normalize(real);
+	return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+
+export function isDirectEntry(moduleUrl = import.meta.url, argvPath = process.argv[1]) {
+	if (!argvPath) return false;
+	try {
+		const modulePath = normalizeDirectEntryPath(fileURLToPath(moduleUrl));
+		const entryPath = normalizeDirectEntryPath(argvPath);
+		return modulePath === entryPath;
+	} catch {
+		return false;
+	}
+}
+
+if (isDirectEntry()) {
 	const result = runPlaywrightCli();
 	process.exitCode = result.status ?? 1;
 }

package/dist/chunks/{chunk-PUZP2Q3F.js → chunk-4B42ZU4B.js}

@@ -3,7 +3,7 @@ import {
   EventStream,
   streamSimple,
   validateToolArguments
-} from "./chunk-7ABSJC2D.js";
+} from "./chunk-64XJIKVK.js";
 
 // ../../packages/agent-core/src/agent-loop.ts
 function createLoopErrorMessage(error, config, signal) {