@qusic/pi-dynamic-mcp 0.0.0 → 0.20261016.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bang Lee
+
+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,45 +1,11 @@
-# @qusic/pi-dynamic-mcp
+# Pi extensions
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+Small [Pi](https://github.com/earendil-works/pi) extensions for personal use, published separately for easy installation across machines.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@qusic/pi-dynamic-mcp`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+| Extension | npm | Install | Description |
+| --- | --- | --- | --- |
+| [compact-filter](./compact-filter.ts) | [![npm](https://img.shields.io/npm/v/%40qusic%2Fpi-compact-filter)](https://www.npmjs.com/package/@qusic/pi-compact-filter) | `pi install npm:@qusic/pi-compact-filter` | Keep Pi compaction file lists scoped to the current summary window. |
+| [copilot-sync](./copilot-sync.ts) | [![npm](https://img.shields.io/npm/v/%40qusic%2Fpi-copilot-sync)](https://www.npmjs.com/package/@qusic/pi-copilot-sync) | `pi install npm:@qusic/pi-copilot-sync` | Sync live GitHub Copilot model capabilities into Pi. |
+| [copilot2api](./copilot2api.ts) | [![npm](https://img.shields.io/npm/v/%40qusic%2Fpi-copilot2api)](https://www.npmjs.com/package/@qusic/pi-copilot2api) | `pi install npm:@qusic/pi-copilot2api` | Add copilot2api as a native Pi provider with live model discovery. |
+| [dynamic-mcp](./dynamic-mcp.ts) | [![npm](https://img.shields.io/npm/v/%40qusic%2Fpi-dynamic-mcp)](https://www.npmjs.com/package/@qusic/pi-dynamic-mcp) | `pi install npm:@qusic/pi-dynamic-mcp` | Dynamically manage MCP servers for the current Pi session. |
+| [session-trim](./session-trim.ts) | [![npm](https://img.shields.io/npm/v/%40qusic%2Fpi-session-trim)](https://www.npmjs.com/package/@qusic/pi-session-trim) | `pi install npm:@qusic/pi-session-trim` | Speed up loading large Pi sessions by pruning superseded history. |

package/dynamic-mcp.ts

@@ -0,0 +1,64 @@
+// npm-description: Dynamically manage MCP servers for the current Pi session.
+// npm-keywords: mcp, model-context-protocol, dynamic-mcp, session-scoped, stdio, streamable-http
+
+import { isDeepStrictEqual } from "node:util";
+import { StringEnum, Type } from "@earendil-works/pi-ai";
+import type { ExtensionAPI, McpServerConfig } from "@earendil-works/pi-coding-agent";
+
+// Pi's McpServerConfig and validator: https://github.com/earendil-works/pi/blob/main/packages/coding-agent/src/core/mcp-servers.ts
+// This model-facing subset is validated again by registerMcpServer.
+const parameters = Type.Object({
+	action: StringEnum(["add", "remove", "list"] as const),
+	name: Type.Optional(Type.String({ description: "Server name for add or remove" })),
+	config: Type.Optional(
+		Type.Object({
+			command: Type.Optional(Type.String({ description: "Stdio executable, not a shell command" })),
+			args: Type.Optional(Type.Array(Type.String())),
+			cwd: Type.Optional(Type.String()),
+			env: Type.Optional(Type.Record(Type.String(), Type.String())),
+			url: Type.Optional(Type.String({ description: "Streamable HTTP URL" })),
+			headers: Type.Optional(Type.Record(Type.String(), Type.String())),
+			description: Type.Optional(Type.String()),
+			timeout: Type.Optional(Type.Number()),
+		}),
+	),
+});
+
+export default function (pi: ExtensionAPI) {
+	const managed = new Map<string, McpServerConfig>();
+
+	pi.registerTool({
+		name: "mcp",
+		label: "MCP",
+		description:
+			"Manage session MCP servers: add(name, config) with command/args (stdio) or url (HTTP), remove(name), or list(). list shows server configs managed by this tool, not connection status. env and headers support ${VAR}.",
+		parameters,
+		async execute(_id, { action, name, config }) {
+			let text: string;
+			if (action === "list") {
+				text = JSON.stringify(Object.fromEntries(managed), null, 2);
+			} else if (!name) {
+				throw new Error("Server name is required");
+			} else if (action === "remove") {
+				if (!managed.has(name)) throw new Error(`Server "${name}" is not managed by this tool`);
+				pi.unregisterMcpServer(name);
+				managed.delete(name);
+				text = `Removed "${name}"`;
+			} else {
+				if (!config || Boolean(config.command) === Boolean(config.url)) {
+					throw new Error("Provide exactly one of command (stdio) or url (HTTP) in config");
+				}
+				const common = { description: config.description, timeout: config.timeout };
+				const serverConfig: McpServerConfig = config.url
+					? { ...common, url: config.url, headers: config.headers }
+					: { ...common, command: config.command!, args: config.args, cwd: config.cwd, env: config.env };
+				const duplicate = [...managed].find(([, existing]) => isDeepStrictEqual(existing, serverConfig));
+				if (duplicate) throw new Error(`Server "${duplicate[0]}" is already registered with an identical config`);
+				pi.registerMcpServer(name, serverConfig);
+				managed.set(name, structuredClone(serverConfig));
+				text = `Registered "${name}". Use codemode to find and call its tools.`;
+			}
+			return { content: [{ type: "text", text }], details: undefined };
+		},
+	});
+}

package/package.json

@@ -1,10 +1,37 @@
 {
-  "name": "@qusic/pi-dynamic-mcp",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @qusic/pi-dynamic-mcp",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+	"name": "@qusic/pi-dynamic-mcp",
+	"version": "0.20261016.0",
+	"homepage": "https://github.com/Qusic/pi-extensions#readme",
+	"bugs": {
+		"url": "https://github.com/Qusic/pi-extensions/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Qusic/pi-extensions.git"
+	},
+	"license": "MIT",
+	"type": "module",
+	"pi": {
+		"extensions": [
+			"./*.ts"
+		]
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-ai": "*",
+		"@earendil-works/pi-agent-core": "*",
+		"@earendil-works/pi-coding-agent": "*"
+	},
+	"description": "Dynamically manage MCP servers for the current Pi session.",
+	"keywords": [
+		"pi-package",
+		"pi-extension",
+		"pi",
+		"pi-coding-agent",
+		"mcp",
+		"model-context-protocol",
+		"dynamic-mcp",
+		"session-scoped",
+		"stdio",
+		"streamable-http"
+	]
 }