@oh-my-pi/cli 0.9.0 → 0.9.2

package/README.md

@@ -60,21 +60,25 @@ omp update
 
 ## How It Works
 
-omp installs plugins via npm and symlinks their files into your pi configuration directory:
+omp installs plugins via npm and sets up your pi configuration:
 
 ```
 ~/.pi/
-├── agent/              # Where plugin files get symlinked
-│   ├── agents/         # Agent definitions (.md)
-│   ├── commands/       # Slash commands (.md)
-│   ├── tools/          # Custom tools (.ts)
-│   └── themes/         # Theme files (.json)
-└── plugins/            # Plugin storage
-    ├── package.json    # Installed plugins manifest
-    └── node_modules/   # Actual plugin packages
+├── agent/                    # Pi's agent directory
+│   ├── agents/               # Agent definitions (.md) - symlinked
+│   ├── commands/             # Slash commands (.md) - symlinked
+│   ├── tools/omp/            # Tool loader
+│   │   └── index.ts          # Generated loader - imports tools from node_modules
+│   └── themes/               # Theme files (.json) - symlinked
+└── plugins/
+    ├── package.json          # Installed plugins manifest
+    ├── node_modules/         # Plugin packages (tools loaded directly from here)
+    └── store/                # Runtime configs (survives npm updates)
 ```
 
-Plugins declare which files to install via the `omp.install` field in their `package.json`. omp creates symlinks from the plugin's files into the appropriate `~/.pi/agent/` subdirectories.
+**Non-tool files** (agents, commands, themes) are symlinked via `omp.install` entries.
+
+**Tools** are loaded directly from node_modules via a generated loader. Plugins specify `omp.tools` pointing to their tool factory. This allows tools to use npm dependencies without workarounds.
 
 ## Global vs Local Plugins
 
@@ -205,10 +209,31 @@ Plugins are npm packages with an `omp` field in `package.json`:
 			{ "src": "commands/research.md", "dest": "agent/commands/research.md" }
 		]
 	},
-	"files": ["agents", "commands", "tools", "themes"]
+	"files": ["agents", "commands"]
 }
 ```
 
+### Tools
+
+For plugins with custom tools, use the `tools` field instead of `install`:
+
+```json
+{
+	"name": "@oh-my-pi/my-tools",
+	"version": "1.0.0",
+	"keywords": ["omp-plugin"],
+	"omp": {
+		"tools": "tools"
+	},
+	"files": ["tools"],
+	"dependencies": {
+		"some-npm-package": "^1.0.0"
+	}
+}
+```
+
+The `tools` field points to a directory containing an `index.ts` that exports a tool factory. Tools are loaded directly from node_modules, so npm dependencies work normally.
+
 ### Features and Variables
 
 Plugins can define optional features and configurable variables:
@@ -219,7 +244,8 @@ Plugins can define optional features and configurable variables:
 	"version": "1.0.0",
 	"keywords": ["omp-plugin"],
 	"omp": {
-		"install": [{ "src": "tools/core.ts", "dest": "agent/tools/exa/core.ts" }],
+		"tools": "tools",
+		"runtime": "tools/runtime.json",
 		"variables": {
 			"apiKey": {
 				"type": "string",
@@ -231,13 +257,11 @@ Plugins can define optional features and configurable variables:
 		"features": {
 			"search": {
 				"description": "Web search capabilities",
-				"default": true,
-				"install": [{ "src": "tools/search.ts", "dest": "agent/tools/exa/search.ts" }]
+				"default": true
 			},
 			"websets": {
 				"description": "Curated content collections",
 				"default": false,
-				"install": [{ "src": "tools/websets.ts", "dest": "agent/tools/exa/websets.ts" }],
 				"variables": {
 					"defaultCollection": {
 						"type": "string",
@@ -250,6 +274,8 @@ Plugins can define optional features and configurable variables:
 }
 ```
 
+The `runtime` field points to a JSON file that the plugin imports to check feature state. omp stores user's feature selections in `~/.pi/plugins/store/` and injects them at load time, so they persist across npm updates.
+
 ### Plugin Structure
 
 ```

package/dist/cli.js

@@ -6462,6 +6462,7 @@ async function createPlugin(name, options = {}) {
       keywords: ["omp-plugin"],
       author: options.author || "",
       license: "MIT",
+      type: "module",
       omp: {
         install: []
       },
@@ -6486,7 +6487,7 @@ Add agent markdown files to \`agents/\` directory.
 
 ### Tools
 
-Add tool implementations to \`tools/\` directory.
+Add tool implementations to \`tools/\` directory. Set \`"tools": "tools"\` in package.json omp field to enable.
 
 ### Themes
 
@@ -6498,19 +6499,22 @@ Add command markdown files to \`commands/\` directory.
 
 ## Configuration
 
-Edit \`package.json\` to configure which files are installed:
+Edit \`package.json\` to configure your plugin:
 
 \`\`\`json
 {
   "omp": {
     "install": [
-      { "src": "agents/my-agent.md", "dest": "agent/agents/my-agent.md" },
-      { "src": "tools/my-tool/", "dest": "agent/tools/my-tool/" }
-    ]
+      { "src": "agents/my-agent.md", "dest": "agent/agents/my-agent.md" }
+    ],
+    "tools": "tools"
   }
 }
 \`\`\`
 
+- \`install\`: Symlinks files (agents, commands, themes) into ~/.pi/agent/
+- \`tools\`: Points to tool factory directory (loaded from node_modules)
+
 ## Publishing
 
 1. Update version in package.json
@@ -6536,6 +6540,28 @@ Describe what this agent does.
 Provide instructions for the agent here.
 `;
     await writeFile2(join3(pluginDir, "agents", "example.md"), exampleAgent);
+    const exampleTool = `import type { CustomToolFactory } from "@mariozechner/pi-coding-agent";
+import { Type } from "@sinclair/typebox";
+
+const factory: CustomToolFactory = (pi) => {
+  return {
+    name: "example_tool",
+    label: "Example Tool",
+    description: "An example tool for ${pluginName}",
+    parameters: Type.Object({
+      message: Type.String({ description: "A message to echo" }),
+    }),
+    async execute({ message }) {
+      return {
+        content: [{ type: "text", text: \`Echo: \${message}\` }],
+      };
+    },
+  };
+};
+
+export default factory;
+`;
+    await writeFile2(join3(pluginDir, "tools", "index.ts"), exampleTool);
     const gitignore = `node_modules/
 .DS_Store
 *.log
@@ -6552,6 +6578,7 @@ Provide instructions for the agent here.
     console.log(source_default.dim("  \u251C\u2500\u2500 agents/"));
     console.log(source_default.dim("  \u2502   \u2514\u2500\u2500 example.md"));
     console.log(source_default.dim("  \u251C\u2500\u2500 tools/"));
+    console.log(source_default.dim("  \u2502   \u2514\u2500\u2500 index.ts"));
     console.log(source_default.dim("  \u251C\u2500\u2500 themes/"));
     console.log(source_default.dim("  \u2514\u2500\u2500 commands/"));
     console.log();
@@ -11567,7 +11594,7 @@ var {
 } = import__.default;
 
 // src/cli.ts
-program.name("omp").description("Oh My Pi - Plugin manager for pi configuration").version("0.9.0");
+program.name("omp").description("Oh My Pi - Plugin manager for pi configuration").version("0.9.2");
 program.command("install [packages...]").alias("i").description("Install plugin(s). No args = install from plugins.json").addHelpText("after", `
 Examples:
   $ omp install @oh-my-pi/subagents             # Install from npm (all features)

package/dist/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAmHD;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkK3F"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAmHD;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiM3F"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/cli",
-	"version": "0.9.0",
+	"version": "0.9.2",
 	"description": "Plugin manager for pi - install and manage pi config plugins from git repos",
 	"type": "module",
 	"main": "./dist/cli.js",