@caplets/pi 0.0.0

package/README.md

@@ -0,0 +1,29 @@
+# @caplets/pi
+
+Native Pi extension for Caplets.
+
+This package exposes configured Caplets as native Pi tools named `caplets_<id>`. It does not start the Caplets MCP server. Pi prompt guidance is provided through `promptSnippet` and `promptGuidelines`.
+
+## Install
+
+Install the extension with Pi:
+
+```sh
+pi install npm:@caplets/pi
+```
+
+For package-manager-based installs, install it in the same environment where Pi resolves extension packages:
+
+```sh
+npm install -g @caplets/pi
+```
+
+Or install it project-locally:
+
+```sh
+pnpm add -D @caplets/pi
+```
+
+The extension reads your existing Caplets configuration through `@caplets/core`; it does not create or mutate Pi config files.
+
+New or removed Caplets are snapshotted at extension load. Restart Pi or reload extensions to refresh the native tool list.

package/dist/index.js

@@ -0,0 +1,51 @@
+import { createNativeCapletsService } from "@caplets/core/native";
+import { Type } from "@sinclair/typebox";
+import { operations } from "@caplets/core/generated-tool-input-schema";
+//#region src/schema.ts
+function capletsPiParameters() {
+	return Type.Object({
+		operation: Type.Union(operations.map((operation) => Type.Literal(operation))),
+		query: Type.Optional(Type.String()),
+		limit: Type.Optional(Type.Integer({ minimum: 1 })),
+		tool: Type.Optional(Type.String()),
+		arguments: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+		fields: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }))
+	}, { additionalProperties: false });
+}
+//#endregion
+//#region src/index.ts
+function capletsPiExtension(pi, options = {}) {
+	const service = options.service ?? createNativeCapletsService();
+	if (!options.service) registerProcessCleanup(service);
+	for (const caplet of service.listTools()) pi.registerTool({
+		name: caplet.toolName,
+		label: caplet.title,
+		description: caplet.description,
+		promptSnippet: `Use ${caplet.toolName} for the ${caplet.title} Caplet capability domain.`,
+		promptGuidelines: caplet.promptGuidance,
+		parameters: capletsPiParameters(),
+		async execute(_toolCallId, params) {
+			const result = await service.execute(caplet.caplet, params);
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				details: { result }
+			};
+		}
+	});
+}
+function registerProcessCleanup(service) {
+	let closed = false;
+	const close = () => {
+		if (closed) return;
+		closed = true;
+		service.close();
+	};
+	process.once("beforeExit", close);
+	process.once("SIGINT", close);
+	process.once("SIGTERM", close);
+}
+//#endregion
+export { capletsPiExtension as default };

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@caplets/pi",
+  "version": "0.0.0",
+  "description": "Native Pi extension for Caplets.",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "rm -rf dist && rolldown -c",
+    "prepack": "pnpm build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@caplets/core": "workspace:*",
+    "@sinclair/typebox": "^0.34.49"
+  },
+  "devDependencies": {
+    "@types/node": "^25.7.0",
+    "rolldown": "^1.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}