@nklisch/pi-enhanced 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v0.2.4
+
+### Changed
+
+- Rebundle the filesystem-first `@nklisch/pi-plugins` 0.5.0 and `@nklisch/pi-mcp-adapter` 2.21.0-nklisch.2. Plugin MCP servers now overlay normal user/project MCP files instead of replacing file discovery.
+
 ## v0.2.3
 
 ### Fixed

package/node_modules/@nklisch/pi-plugins/README.md

@@ -1,20 +1,9 @@
 # Pi Plugins
 
-Native plugin management for [Pi](https://github.com/badlogic/pi-mono), with compatibility for supported Claude Code and Codex marketplaces.
-
-`@nklisch/pi-plugins` provides:
-
-- marketplace discovery, inspection, and read-only foreign-state adoption;
-- transactional install, enable, disable, update, recovery, and uninstall;
-- Agent Skills and command-hook activation;
-- receipt-qualified MCP and subagent lifecycle integration;
-- deterministic `/plugins` commands and a Pi-native interactive manager;
-- offline-safe startup, update policy, diagnostics, and multiprocess coordination.
-
-## Requirements
-
-- Node.js 22.19 or newer
-- Pi 0.82.0-compatible public extension APIs
+`@nklisch/pi-plugins` is a small filesystem-first marketplace and plugin host
+for [Pi](https://github.com/badlogic/pi-mono). It installs compatible Claude
+Code and Codex plugin bundles, discovers their skills, runs their simple
+command hooks, and supplies their MCP declarations to Pi.
 
 ## Install
 
@@ -22,51 +11,85 @@ Native plugin management for [Pi](https://github.com/badlogic/pi-mono), with com
 pi install npm:@nklisch/pi-plugins
 ```
 
-Then start Pi and run `/plugins`. The manager uses the same progressive list footprint as Pi settings: choose **My Plugins**, **Discover**, **Sources**, **Updates**, or **Health**, then drill into an item and its available actions. Escape returns one level. On a clean installation, open Sources and choose **Add Source**, or use:
+Then use the concise command surface:
 
 ```text
 /plugins marketplace add nklisch/skills
-/plugins add <plugin@marketplace> --scope user
+/plugins marketplace list
+/plugins browse nklisch-skills
+/plugins install workbench@nklisch-skills --yes
+/plugins update workbench@nklisch-skills --yes
+/plugins enable workbench@nklisch-skills --yes
+/plugins disable workbench@nklisch-skills
+/plugins remove workbench@nklisch-skills --yes
 ```
 
-`/plugins add` adds the complete plugin to the selected user or project plugin list, collects any required configuration and executable trust, installs and enables it, and reloads Pi when activation changes. Use `/plugins help` for the concise command surface:
+The command uses Pi's ordinary select, input, and confirmation dialogs when
+invoked without arguments in a UI session. Installing, updating, enabling, or
+removing executable plugin content requires confirmation; pass `--yes` for
+headless use. Pi reloads after a runtime-affecting mutation.
 
-If an installed plugin's executable content changes outside a managed update (a rebuilt local source, a refreshed payload), its exact-trust grant no longer covers it and its hooks and MCP servers stop. At the next session start Pi asks whether to trust the changed content again; accepting records the grant and one `/reload` reactivates the plugin. The same remedy is available any time as the manager's **Trust plugin** action or `/plugins trust`.
+## Filesystem truth
+
+The host stores no database or lifecycle ledger. Its durable layout is:
 
 ```text
-/plugins add <plugin> --scope user|project
-/plugins remove <plugin> --scope user|project --keep-data|--delete-data
-/plugins update <plugin> --scope user|project
-/plugins enable <plugin> --scope user|project
-/plugins disable <plugin> --scope user|project
-/plugins trust <plugin> --scope user|project --yes
-/plugins list
-/plugins doctor [plugin]
-/plugins marketplace add|list|refresh|remove ...
+<agent-dir>/plugin-host/
+├── marketplaces/<name>/{source.json,checkout}
+├── plugins/<marketplace>/<plugin>/{.pi-plugin.json,.disabled?,...bundle}
+└── data/<marketplace>/<plugin>/
 ```
 
-The older `install`, `uninstall`, and `diagnose` forms remain accepted as compatibility aliases. Workflow-phase and operation-token routes remain available to automation but are intentionally omitted from normal help and completion.
-
-Marketplace registration is global; plugin installation remains user- or project-scoped. GitHub shorthand is the default marketplace source. Use `--source-kind git` or `--source-kind local-git` for those source forms. The interactive manager opens only in a TUI session.
-
-This package manages compatible foreign marketplace plugins as complete bundles. It does **not** replace Pi's package manager: use `pi list`, `pi install`, `pi update`, and `pi config` for ordinary Pi extension packages.
-
-## Security
+A plugin directory is installed; `.disabled` means disabled. The receipt is
+descriptive only. Refresh and install/update stage a sibling directory and
+rename it into place. Persistent plugin data is not replaced by an update and
+is retained by removal unless `--delete-data` is supplied.
+
+Marketplaces accept GitHub shorthand, Git URLs, and local repository paths.
+The host reads `.agents/plugins/marketplace.json` and
+`.claude-plugin/marketplace.json`, merges valid siblings, and supports local
+plugin declarations such as `{ "source": "local", "path": "./plugins/demo" }`
+and ordinary relative string paths. Catalog paths must remain within the
+marketplace checkout. Symlinks are rejected anywhere in a copied plugin tree,
+so catalog-controlled content cannot expose arbitrary host files.
+
+## Runtime compatibility
+
+At extension load, enabled bundles are scanned for:
+
+- `SKILL.md` at the bundle root and skills beneath `skills/`;
+- command hooks in `hooks/hooks.json` or a simple manifest-declared hook path;
+- MCP servers in `.mcp.json` or a simple manifest-declared MCP path/object.
+
+Supported Claude hook events include `SessionStart`, `SessionEnd`,
+`UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `PostToolUseFailure`,
+`PreCompact`, `PostCompact`, and `Stop`. Hook processes receive JSON on stdin,
+the plugin root/data variables, `CLAUDE_PROJECT_DIR`, a bounded timeout, and
+cancellation. Hook failures are reported for that plugin and do not disable
+unrelated bundles. SessionStart `hookSpecificOutput.additionalContext` is
+injected into the next Pi system prompt.
+
+MCP declarations are recursively expanded for the plugin root, persistent data
+root, and project root, then passed as an in-memory `{ mcpServers }` overlay to
+`@nklisch/pi-mcp-adapter`. The adapter merges that overlay with the user's normal
+file-discovered MCP configuration. Duplicate plugin server names are qualified
+by plugin identity.
+There is no background network activity. Marketplace refresh runs only when
+requested; updating a plugin first refreshes its marketplace, then replaces the
+installed copy.
+
+## Development
 
-Pi packages execute with full local-system access. Review the source and requested plugin trust before installation. Sensitive plugin configuration currently fails closed when production cannot prove atomic operating-system credential ownership; plaintext is never retained in plugin-host state, projections, diagnostics, logs, or control output.
-
-Marketplace-derived network access is origin-authorized and DNS-pinned. Credential-bearing MCP endpoints require HTTPS; unauthenticated plaintext HTTP is limited to explicitly approved literal loopback endpoints.
-
-## Compatibility
-
-The current production package pins:
-
-- `@nklisch/pi-mcp-adapter@2.21.0-nklisch.1`
-- `@nklisch/pi-subagents@18.1.0-nklisch.3`
-
-Executable dependencies are checked against their declared package shape before import: exact name and version, license, engine and peer ranges, required exports, and declared Pi resources. The MCP and subagent packages are transitive dependencies: one top-level `pi install npm:@nklisch/pi-plugins` installs and activates both through verified wrappers, so they do not need separate `pi install` entries. The bundled subagent loader reuses Pi's already-loaded coding-agent, AI, and TUI module identities rather than installing a second Pi runtime tree. Package, API, runtime-range, or behavioral drift makes the affected capability unavailable rather than partially activating it. Subagent lifecycle conformance remains a separate qualification contract.
+```bash
+npm run typecheck
+npm run test:unit
+npm run build
+npm run test:package
+```
 
-See [`docs/COMPATIBILITY.md`](docs/COMPATIBILITY.md) for the complete compatibility contract.
+Node.js 22.19 or newer is required. The package keeps the bundled
+`@nklisch/pi-subagents` Pi resource available through a direct, best-effort
+loader; failure of that optional resource does not prevent plugin discovery.
 
 ## License
 

package/node_modules/@nklisch/pi-plugins/dist/catalog.d.ts

@@ -0,0 +1,18 @@
+import type { CatalogPlugin, MarketplaceCatalog, PluginDiagnostic } from "./types.js";
+export declare const MARKETPLACE_CATALOG_PATHS: readonly [".agents/plugins/marketplace.json", ".claude-plugin/marketplace.json"];
+export interface MarketplaceCatalogRead {
+    readonly catalog: MarketplaceCatalog;
+    readonly diagnostics: readonly PluginDiagnostic[];
+}
+export declare class MarketplaceCatalogError extends Error {
+    readonly diagnostics: readonly PluginDiagnostic[];
+    constructor(message: string, diagnostics?: readonly PluginDiagnostic[]);
+}
+export declare function mergeMarketplaceCatalogs(documents: readonly ParsedDocumentLike[]): MarketplaceCatalogRead;
+export interface ParsedDocumentLike {
+    readonly name: string;
+    readonly plugins: readonly CatalogPlugin[];
+    readonly path: string;
+    readonly diagnostics?: readonly PluginDiagnostic[];
+}
+export declare function readMarketplaceCatalog(checkout: string): Promise<MarketplaceCatalogRead>;

package/node_modules/@nklisch/pi-plugins/dist/catalog.js

@@ -0,0 +1,155 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { assertSafeName, assertSafeRelativePath } from "./paths.js";
+export const MARKETPLACE_CATALOG_PATHS = [
+    ".agents/plugins/marketplace.json",
+    ".claude-plugin/marketplace.json",
+];
+export class MarketplaceCatalogError extends Error {
+    diagnostics;
+    constructor(message, diagnostics = []) {
+        super(message);
+        this.name = "MarketplaceCatalogError";
+        this.diagnostics = diagnostics;
+    }
+}
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function sourceKey(source) {
+    return source.kind === "local"
+        ? `local:${source.path.replace(/^\.\//u, "")}`
+        : `${source.kind}:${source.url}:${source.path ?? ""}:${source.ref ?? ""}`;
+}
+function parsePluginSource(value, scope) {
+    if (typeof value === "string") {
+        return { kind: "local", path: assertSafeRelativePath(value, `${scope}.source`) };
+    }
+    if (!record(value) || typeof value.source !== "string") {
+        throw new Error(`${scope}.source must be a relative path or source object`);
+    }
+    if (value.source === "local") {
+        if (!stringValue(value.path))
+            throw new Error(`${scope}.source.path must be a relative path`);
+        return { kind: "local", path: assertSafeRelativePath(value.path, `${scope}.source.path`) };
+    }
+    if (value.source === "git" || value.source === "git-subdir") {
+        if (!stringValue(value.url))
+            throw new Error(`${scope}.source.url must be a git URL`);
+        const result = {
+            kind: value.source,
+            url: value.url,
+            ...(value.path === undefined ? {} : { path: assertSafeRelativePath(String(value.path), `${scope}.source.path`) }),
+            ...(value.ref === undefined ? {} : { ref: String(value.ref) }),
+        };
+        return result;
+    }
+    throw new Error(`${scope}.source type is unsupported: ${value.source}`);
+}
+function parsePlugin(value, index) {
+    const scope = `plugins[${index}]`;
+    if (typeof value === "string") {
+        const path = assertSafeRelativePath(value, scope);
+        const name = assertSafeName(basename(path), `${scope} name`);
+        return Object.freeze({ name, source: Object.freeze({ kind: "local", path }), raw: value });
+    }
+    if (!record(value) || !stringValue(value.name))
+        throw new Error(`${scope}.name must be a string`);
+    const name = assertSafeName(value.name, `${scope}.name`);
+    const source = parsePluginSource(value.source, scope);
+    return Object.freeze({
+        name,
+        source: Object.freeze(source),
+        ...(stringValue(value.description) ? { description: value.description } : {}),
+        ...(stringValue(value.version) ? { version: value.version } : {}),
+        raw: Object.freeze({ ...value }),
+    });
+}
+function parseDocument(value, path) {
+    if (!record(value))
+        throw new Error("catalog root must be an object");
+    if (!stringValue(value.name))
+        throw new Error("catalog name must be a string");
+    const name = assertSafeName(value.name, "catalog name");
+    if (!Array.isArray(value.plugins))
+        throw new Error("catalog plugins must be an array");
+    const plugins = [];
+    const diagnostics = [];
+    for (const [index, entry] of value.plugins.entries()) {
+        try {
+            plugins.push(parsePlugin(entry, index));
+        }
+        catch (error) {
+            // One bad entry should not hide all of the useful catalog. The diagnostic
+            // is returned to the caller, while root identity errors remain fatal.
+            diagnostics.push({ scope: `${path}:plugins[${index}]`, message: error instanceof Error ? error.message : String(error), cause: error });
+        }
+    }
+    return Object.freeze({ name, plugins: Object.freeze(plugins), path, diagnostics: Object.freeze(diagnostics) });
+}
+export function mergeMarketplaceCatalogs(documents) {
+    if (documents.length === 0)
+        throw new MarketplaceCatalogError("no marketplace catalog was found");
+    const first = documents[0];
+    const diagnostics = [];
+    for (const document of documents.slice(1)) {
+        if (document.name !== first.name) {
+            throw new MarketplaceCatalogError(`marketplace catalog names disagree: ${first.name} and ${document.name}`, documents.map((item) => ({ scope: item.path, message: `declared marketplace name ${item.name}` })));
+        }
+    }
+    const plugins = new Map();
+    for (const document of documents) {
+        for (const plugin of document.plugins) {
+            const previous = plugins.get(plugin.name);
+            if (previous === undefined) {
+                plugins.set(plugin.name, plugin);
+            }
+            else if (sourceKey(previous.source) !== sourceKey(plugin.source)) {
+                diagnostics.push({
+                    scope: `${document.path}:${plugin.name}`,
+                    message: `duplicate plugin declaration conflicts with ${first.name}; using the first declaration`,
+                });
+            }
+        }
+    }
+    return Object.freeze({
+        catalog: Object.freeze({
+            name: first.name,
+            plugins: Object.freeze([...plugins.values()]),
+            sources: Object.freeze(documents.map((document) => document.path)),
+        }),
+        diagnostics: Object.freeze([...documents.flatMap((document) => document.diagnostics ?? []), ...diagnostics]),
+    });
+}
+export async function readMarketplaceCatalog(checkout) {
+    const documents = [];
+    const diagnostics = [];
+    for (const relativePath of MARKETPLACE_CATALOG_PATHS) {
+        try {
+            const text = await readFile(`${checkout}/${relativePath}`, "utf8");
+            try {
+                documents.push(parseDocument(JSON.parse(text), relativePath));
+            }
+            catch (error) {
+                diagnostics.push({ scope: relativePath, message: error instanceof Error ? error.message : String(error), cause: error });
+            }
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                diagnostics.push({ scope: relativePath, message: error instanceof Error ? error.message : String(error), cause: error });
+            }
+        }
+    }
+    if (documents.length === 0) {
+        throw new MarketplaceCatalogError("marketplace catalog is missing or invalid", diagnostics);
+    }
+    const merged = mergeMarketplaceCatalogs(documents);
+    return Object.freeze({
+        catalog: merged.catalog,
+        diagnostics: Object.freeze([...diagnostics, ...merged.diagnostics]),
+    });
+}
+//# sourceMappingURL=catalog.js.map

package/node_modules/@nklisch/pi-plugins/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAQpE,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,kCAAkC;IAClC,iCAAiC;CACzB,CAAC;AAOX,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,WAAW,CAA8B;IAElD,YAAY,OAAe,EAAE,WAAW,GAAgC,EAAE;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,MAAoB;IACrC,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO;QAC5B,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE;QAC9C,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,KAAa;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,CAAC,KAAK,EAAE,GAAG,KAAK,SAAS,CAAC,EAAE,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kDAAkD,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAC;QAC9F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,cAAc,CAAC,EAAE,CAAC;IAC7F,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QAC5D,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+BAA+B,CAAC,CAAC;QACtF,MAAM,MAAM,GAAiB;YAC3B,IAAI,EAAE,KAAK,CAAC,MAAM;YAClB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,cAAc,CAAC,EAAE,CAAC;YACjH,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;SAC/D,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gCAAgC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa;IAChD,MAAM,KAAK,GAAG,WAAW,KAAK,GAAG,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC;IAClG,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7B,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;KACjC,CAAC,CAAC;AACL,CAAC;AASD,SAAS,aAAa,CAAC,KAAc,EAAE,IAAY;IACjD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACtE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACvF,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,sEAAsE;YACtE,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,YAAY,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1I,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,SAAwC;IAC/E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,uBAAuB,CAAC,kCAAkC,CAAC,CAAC;IAClG,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;IAC5B,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,uBAAuB,CAC/B,uCAAuC,KAAK,CAAC,IAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,EACxE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,6BAA6B,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CACnG,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IACjD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnC,CAAC;iBAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnE,WAAW,CAAC,IAAI,CAAC;oBACf,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE;oBACxC,OAAO,EAAE,+CAA+C,KAAK,CAAC,IAAI,+BAA+B;iBAClG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;SACnE,CAAC;QACF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;KAC7G,CAAC,CAAC;AACL,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IAC3D,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,KAAK,MAAM,YAAY,IAAI,yBAAyB,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,QAAQ,IAAI,YAAY,EAAE,EAAE,MAAM,CAAC,CAAC;YACnE,IAAI,CAAC;gBACH,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,EAAE,YAAY,CAAC,CAAC,CAAC;YAC3E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3H,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3H,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,uBAAuB,CAAC,2CAA2C,EAAE,WAAW,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/hooks.d.ts

@@ -0,0 +1,12 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { HookExecutionResult, RuntimeSnapshot } from "./types.js";
+/** Execute the foreign format's intentional shell-command boundary with bounded lifetime and output. */
+export declare function executeHookCommand(input: Readonly<{
+    command: string;
+    cwd: string;
+    environment: Readonly<Record<string, string>>;
+    timeoutMs: number;
+    signal?: AbortSignal;
+    stdin: unknown;
+}>): Promise<HookExecutionResult>;
+export declare function registerPluginHooks(pi: ExtensionAPI, snapshot: RuntimeSnapshot): void;

package/node_modules/@nklisch/pi-plugins/dist/hooks.js

@@ -0,0 +1,221 @@
+import { spawn } from "node:child_process";
+const MAX_OUTPUT_BYTES = 1_000_000;
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function boundedAppend(current, chunk) {
+    if (current.length >= MAX_OUTPUT_BYTES)
+        return current;
+    return `${current}${chunk.toString()}`.slice(0, MAX_OUTPUT_BYTES);
+}
+function abortError(reason) {
+    const error = new Error(reason instanceof Error ? reason.message : "hook execution cancelled");
+    error.name = "AbortError";
+    return error;
+}
+/** Execute the foreign format's intentional shell-command boundary with bounded lifetime and output. */
+export function executeHookCommand(input) {
+    return new Promise((resolve) => {
+        const shell = process.env.SHELL || "/bin/sh";
+        const child = spawn(shell, ["-c", input.command], {
+            cwd: input.cwd,
+            env: { ...process.env, ...input.environment },
+            stdio: ["pipe", "pipe", "pipe"],
+            shell: false,
+        });
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        let timedOut = false;
+        let forceTimer;
+        const terminate = () => {
+            child.kill("SIGTERM");
+            forceTimer ??= setTimeout(() => {
+                if (child.exitCode === null && child.signalCode === null)
+                    child.kill("SIGKILL");
+            }, 500);
+            forceTimer.unref();
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            terminate();
+        }, input.timeoutMs);
+        timer.unref();
+        const cancel = () => terminate();
+        input.signal?.addEventListener("abort", cancel, { once: true });
+        child.stdout.on("data", (chunk) => { stdout = boundedAppend(stdout, chunk); });
+        child.stderr.on("data", (chunk) => { stderr = boundedAppend(stderr, chunk); });
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (forceTimer !== undefined)
+                clearTimeout(forceTimer);
+            input.signal?.removeEventListener("abort", cancel);
+            resolve(result);
+        };
+        child.on("error", (error) => finish({ ok: false, stdout, stderr, error }));
+        child.on("close", (code, signal) => {
+            if (input.signal?.aborted) {
+                finish({ ok: false, stdout, stderr, error: abortError(input.signal.reason) });
+                return;
+            }
+            if (timedOut) {
+                finish({ ok: false, stdout, stderr, error: new Error(`hook timed out after ${input.timeoutMs}ms`) });
+                return;
+            }
+            if (code !== 0) {
+                finish({ ok: false, stdout, stderr, error: new Error(`hook exited with ${code ?? signal ?? "unknown status"}`) });
+                return;
+            }
+            finish({ ok: true, stdout, stderr });
+        });
+        // A guard-style hook may exit before consuming a large payload. Swallow
+        // the resulting pipe error here; process exit still settles the hook.
+        child.stdin.on("error", () => undefined);
+        child.stdin.end(`${JSON.stringify(input.stdin)}\n`);
+        if (input.signal?.aborted)
+            child.kill("SIGTERM");
+    });
+}
+function parseOutput(text, event) {
+    const candidates = text.trim().length === 0 ? [] : [text.trim(), ...text.trim().split("\n").reverse()];
+    for (const candidate of candidates) {
+        try {
+            const value = JSON.parse(candidate);
+            if (!record(value))
+                continue;
+            const nested = record(value.hookSpecificOutput) ? value.hookSpecificOutput : undefined;
+            if (nested !== undefined && nested.hookEventName !== undefined && nested.hookEventName !== event)
+                continue;
+            const additionalContext = typeof nested?.additionalContext === "string"
+                ? nested.additionalContext
+                : typeof value.additionalContext === "string" ? value.additionalContext : undefined;
+            const decision = nested?.permissionDecision ?? nested?.decision ?? value.decision;
+            const continueValue = nested?.continue ?? value.continue;
+            return Object.freeze({
+                ...(additionalContext === undefined ? {} : { additionalContext }),
+                ...(decision === "block" || decision === "deny" || continueValue === false ? { block: true } : {}),
+                ...(typeof value.reason === "string" ? { reason: value.reason } : typeof nested?.reason === "string" ? { reason: nested.reason } : {}),
+                ...(typeof continueValue === "boolean" ? { continue: continueValue } : {}),
+            });
+        }
+        catch {
+            // Claude hooks are allowed to be silent. Non-JSON diagnostic text is not
+            // treated as an instruction, because doing so would make stderr/logging
+            // accidentally alter agent behavior.
+        }
+    }
+    return undefined;
+}
+function matcherValue(event, input) {
+    if (event === "SessionStart" || event === "SessionEnd" || event === "PreCompact" || event === "PostCompact")
+        return String(input.reason ?? "");
+    if (event === "PreToolUse" || event === "PostToolUse" || event === "PostToolUseFailure")
+        return String(input.tool_name ?? "");
+    return "";
+}
+function matches(command, input) {
+    if (command.matcher === undefined || command.matcher.length === 0)
+        return true;
+    try {
+        return new RegExp(command.matcher, "u").test(matcherValue(command.event, input));
+    }
+    catch {
+        return false;
+    }
+}
+function baseEnvironment(plugin, cwd) {
+    return Object.freeze({
+        PLUGIN_ROOT: plugin.info.root,
+        CLAUDE_PLUGIN_ROOT: plugin.info.root,
+        PLUGIN_DATA: plugin.info.data,
+        CLAUDE_PLUGIN_DATA: plugin.info.data,
+        CLAUDE_PROJECT_DIR: cwd,
+    });
+}
+function hookInput(event, ctx, values = {}) {
+    return { hook_event_name: event, cwd: ctx.cwd, ...values };
+}
+function sessionStartReason(reason) {
+    if (reason === "new")
+        return "clear";
+    if (reason === "resume" || reason === "fork")
+        return "resume";
+    return "startup";
+}
+function emptyAggregate() { return { contexts: [], blocked: false }; }
+function mergeAggregate(left, output) {
+    return {
+        contexts: [...left.contexts, ...(output?.additionalContext === undefined ? [] : [output.additionalContext])],
+        blocked: left.blocked || output?.block === true,
+        ...(output?.reason === undefined ? (left.reason === undefined ? {} : { reason: left.reason }) : { reason: output.reason }),
+    };
+}
+export function registerPluginHooks(pi, snapshot) {
+    let pendingContext = [];
+    const invoke = async (event, input, ctx) => {
+        let aggregate = emptyAggregate();
+        for (const plugin of snapshot.plugins.filter((item) => item.info.enabled)) {
+            for (const command of plugin.hooks.filter((item) => item.event === event && matches(item, input))) {
+                const result = await executeHookCommand({
+                    command: command.command,
+                    cwd: ctx.cwd,
+                    environment: baseEnvironment(plugin, ctx.cwd),
+                    timeoutMs: command.timeoutMs,
+                    ...(ctx.signal === undefined ? {} : { signal: ctx.signal }),
+                    stdin: input,
+                });
+                if (!result.ok) {
+                    if (ctx.hasUI)
+                        ctx.ui.notify(`${plugin.info.name}@${plugin.info.marketplace} ${event} hook failed: ${result.error instanceof Error ? result.error.message : "unknown error"}`, "warning");
+                    continue;
+                }
+                aggregate = mergeAggregate(aggregate, parseOutput(result.stdout, event));
+            }
+        }
+        pendingContext.push(...aggregate.contexts);
+        return aggregate;
+    };
+    pi.on("session_start", async (event, ctx) => {
+        await invoke("SessionStart", hookInput("SessionStart", ctx, { reason: sessionStartReason(event.reason), pi_reason: event.reason }), ctx);
+    });
+    pi.on("session_shutdown", async (event, ctx) => {
+        await invoke("SessionEnd", hookInput("SessionEnd", ctx, { reason: event.reason }), ctx);
+    });
+    pi.on("input", async (event, ctx) => {
+        const result = await invoke("UserPromptSubmit", hookInput("UserPromptSubmit", ctx, { prompt: event.text }), ctx);
+        if (result.blocked)
+            return { action: "handled" };
+        return { action: "continue" };
+    });
+    pi.on("tool_call", async (event, ctx) => {
+        const result = await invoke("PreToolUse", hookInput("PreToolUse", ctx, { tool_name: event.toolName, tool_input: event.input }), ctx);
+        if (!result.blocked)
+            return undefined;
+        return result.reason === undefined ? { block: true } : { block: true, reason: result.reason };
+    });
+    pi.on("tool_result", async (event, ctx) => {
+        const hookEvent = event.isError ? "PostToolUseFailure" : "PostToolUse";
+        await invoke(hookEvent, hookInput(hookEvent, ctx, { tool_name: event.toolName, tool_input: event.input, tool_output: event.content, is_error: event.isError }), ctx);
+    });
+    pi.on("session_before_compact", async (event, ctx) => {
+        const result = await invoke("PreCompact", hookInput("PreCompact", ctx, { reason: event.reason }), ctx);
+        return result.blocked ? { cancel: true } : undefined;
+    });
+    pi.on("session_compact", async (event, ctx) => {
+        await invoke("PostCompact", hookInput("PostCompact", ctx, { reason: event.reason }), ctx);
+    });
+    pi.on("agent_end", async (_event, ctx) => {
+        await invoke("Stop", hookInput("Stop", ctx), ctx);
+    });
+    pi.on("before_agent_start", async (event, _ctx) => {
+        if (pendingContext.length === 0)
+            return undefined;
+        const context = pendingContext.join("\n\n");
+        pendingContext = [];
+        return { systemPrompt: `${event.systemPrompt}\n\n${context}` };
+    });
+}
+//# sourceMappingURL=hooks.js.map

package/node_modules/@nklisch/pi-plugins/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/node_modules/@nklisch/pi-plugins/dist/host.d.ts

@@ -0,0 +1,5 @@
+import type { PluginHost } from "./types.js";
+export declare function createPluginHost(agentDir: string): PluginHost;
+export { assertSafeRelativePath, assertSafeName, isPathContained, resolveContainedPath } from "./paths.js";
+export { mergeMarketplaceCatalogs, readMarketplaceCatalog } from "./catalog.js";
+export type { ParsedDocumentLike } from "./catalog.js";