@enactprotocol/cli 2.1.23 → 2.1.28

package/dist/utils/errors.js

@@ -25,8 +25,19 @@ export class CliError extends Error {
  * Tool not found error
  */
 export class ToolNotFoundError extends CliError {
-    constructor(toolName) {
-        super(`Tool not found: ${toolName}`, EXIT_TOOL_NOT_FOUND, "Check the tool name or provide a path to a local tool.\nFor registry tools, use the format: owner/namespace/tool[@version]");
+    constructor(toolName, options) {
+        let message = `Tool not found: ${toolName}`;
+        if (options?.reason) {
+            message += `\n${options.reason}`;
+        }
+        if (options?.searchedLocations && options.searchedLocations.length > 0) {
+            message += `\nSearched locations:\n${options.searchedLocations.map((l) => `  - ${l}`).join("\n")}`;
+        }
+        let suggestion = "Check the tool name or provide a path to a local tool.\nFor registry tools, use the format: owner/namespace/tool[@version]";
+        if (options?.localOnly) {
+            suggestion = "Remove --local flag to search the registry, or check the tool path.";
+        }
+        super(message, EXIT_TOOL_NOT_FOUND, suggestion);
         this.name = "ToolNotFoundError";
     }
 }

package/dist/utils/errors.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enactprotocol/cli",
-  "version": "2.1.23",
+  "version": "2.1.28",
   "description": "Command-line interface for Enact - the npm for AI tools",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,10 +34,10 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@enactprotocol/api": "2.1.23",
-    "@enactprotocol/execution": "2.1.23",
-    "@enactprotocol/secrets": "2.1.23",
-    "@enactprotocol/shared": "2.1.23",
+    "@enactprotocol/api": "2.1.28",
+    "@enactprotocol/execution": "2.1.28",
+    "@enactprotocol/secrets": "2.1.28",
+    "@enactprotocol/shared": "2.1.28",
     "commander": "^12.1.0",
     "picocolors": "^1.1.1"
   },

package/src/commands/index.ts

@@ -33,3 +33,5 @@ export { configureUnyankCommand } from "./unyank";
 
 // Private tools (Phase - visibility management)
 export { configureVisibilityCommand } from "./visibility";
+// MCP integration commands
+export { configureMcpCommand } from "./mcp";

package/src/commands/init/templates/agent-agents.ts

@@ -24,16 +24,35 @@ enact list                                        # List project tools
 ## Tool Output
 Tools output JSON to stdout. Parse with jq or your language's JSON parser:
 \`\`\`bash
-enact run tool --args '{}' | jq '.result'
+enact run tool --args '{}' | jq '.result'               # Progress output is quiet by default
+enact run tool --args '{}' | jq -r '.field'             # Extract a specific field as raw text
+enact run tool --args '{}' --verbose | jq '.result'     # Use --verbose to see progress output
 \`\`\`
 
 ## Creating Local Tools
-Create \`tools/<name>/SKILL.md\` with:
+
+**IMPORTANT: Always use \`enact init --tool\` to create new tools!**
+
+This scaffolds a proper tool structure with SKILL.md and AGENTS.md templates:
+\`\`\`bash
+enact init --tool                                       # If logged in: uses username/my-tool automatically
+enact init --tool --name my-tool                        # Simple name
+enact init --tool --name username/my-tool               # Custom hierarchical name
+\`\`\`
+
+**Note:** When logged in, \`enact init --tool\` automatically uses your username as the namespace (e.g., \`enact/my-tool\`). When not logged in, it defaults to \`my-tool\`.
+
+Then edit the generated \`SKILL.md\` file to define your tool's behavior.
+
+### Tool Structure (for reference)
+The \`enact init --tool\` command creates a \`SKILL.md\` file with this structure:
 \`\`\`yaml
 ---
-name: my-tool
+name: my-tool                                           # Simple name works
+# OR
+name: namespace/tool-name                               # Hierarchical names recommended for organization (e.g., fun/my-tool)
 description: What it does
-command: echo "Hello \${name}"
+command: echo "Hello \${name}"                           # Shell command to execute
 inputSchema:
   type: object
   properties:
@@ -42,7 +61,8 @@ inputSchema:
 # My Tool
 Documentation here.
 \`\`\`
-Run with: \`enact run ./tools/<name> --args '{"name": "World"}'\`
+
+Run local tools with: \`enact run ./tools/<name> --args '{"key": "value"}'\`
 
 ## Environment & Secrets
 \`\`\`bash
@@ -50,13 +70,6 @@ enact env set API_KEY --secret --namespace author/tool  # Set secret
 enact env list                                          # List env vars
 \`\`\`
 
-## Creating Your Own Tools
-To scaffold a new publishable tool with SKILL.md and AGENTS.md templates:
-\`\`\`bash
-enact init --tool                                       # Create tool in current directory
-enact init --tool --name username/my-tool              # Create with specific name
-\`\`\`
-
 ## Getting Help
 \`\`\`bash
 enact help                                              # Show all commands

package/src/commands/init/templates/claude.ts

@@ -33,7 +33,7 @@ description: Clear description for search
 version: 1.0.0
 from: python:3.12-slim            # Docker image
 build: pip install requests       # Install dependencies (cached)
-command: python /work/main.py \${input}
+command: python /workspace/main.py \${input}
 inputSchema:
   type: object
   properties:

package/src/commands/init/templates/tool-agents.ts

@@ -25,7 +25,7 @@ enact: "2.0.0"
 
 from: python:3.12-slim            # Docker image (pin versions, not :latest)
 build: pip install requests       # Build steps (cached by Dagger)
-command: python /work/main.py \${input}
+command: python /workspace/main.py \${input}
 timeout: 30s
 
 inputSchema:
@@ -72,10 +72,10 @@ Enact auto-quotes parameters. **Never manually quote:**
 
 \`\`\`yaml
 # WRONG - causes double-quoting
-command: python /work/main.py "\${input}"
+command: python /workspace/main.py "\${input}"
 
 # RIGHT - Enact handles quoting
-command: python /work/main.py \${input}
+command: python /workspace/main.py \${input}
 \`\`\`
 
 **Optional params:** Missing optional params become empty strings. Always provide defaults:
@@ -130,15 +130,15 @@ build:
 **Rust:**
 \`\`\`yaml
 from: rust:1.83-slim
-build: rustc /work/main.rs -o /work/tool
-command: /work/tool \${input}
+build: rustc /workspace/main.rs -o /workspace/tool
+command: /workspace/tool \${input}
 \`\`\`
 
 **Go:**
 \`\`\`yaml
 from: golang:1.22-alpine
-build: cd /work && go build -o tool main.go
-command: /work/tool \${input}
+build: cd /workspace && go build -o tool main.go
+command: /workspace/tool \${input}
 \`\`\`
 
 **System packages:**
@@ -150,7 +150,7 @@ Build steps are cached — first run slow, subsequent runs instant.
 
 ## File Access
 
-Tools run in a container with \`/work\` as the working directory. All source files are copied there.
+Tools run in a container with \`/workspace\` as the working directory. All source files are copied there.
 
 ## Secrets
 

package/src/commands/install/index.ts

@@ -22,6 +22,7 @@ import {
   verifyAllAttestations,
 } from "@enactprotocol/api";
 import {
+  addMcpTool,
   addToolToRegistry,
   getCacheDir,
   getInstalledVersion,
@@ -438,6 +439,11 @@ async function installFromRegistry(
   // Update tools.json for the appropriate scope
   addToolToRegistry(toolName, targetVersion!, scope, isGlobal ? undefined : ctx.cwd);
 
+  // Also add to MCP registry for global installs
+  if (isGlobal) {
+    addMcpTool(toolName, targetVersion!);
+  }
+
   // Output result
   if (options.json) {
     json({
@@ -533,6 +539,11 @@ async function installFromPath(
   // Update tools.json for the appropriate scope
   addToolToRegistry(manifest.name, version, scope, isGlobal ? undefined : ctx.cwd);
 
+  // Also add to MCP registry for global installs
+  if (isGlobal) {
+    addMcpTool(manifest.name, version);
+  }
+
   if (options.json) {
     json({
       installed: true,

package/src/commands/learn/index.ts

@@ -114,17 +114,12 @@ async function learnHandler(
     config.registry?.url ??
     "https://siikwkfgsmouioodghho.supabase.co/functions/v1";
 
-  // Get auth token - try stored JWT first (for private tools), then fall back to config/env/anon
-  const { getValidToken } = await import("../auth/index.js");
-  let authToken: string | undefined = (await getValidToken()) ?? undefined;
-  if (!authToken) {
-    authToken = config.registry?.authToken ?? process.env.ENACT_AUTH_TOKEN;
-  }
-  // Fall back to anon key for unauthenticated public access
-  if (!authToken && registryUrl.includes("siikwkfgsmouioodghho.supabase.co")) {
-    authToken =
-      "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InNpaWt3a2Znc21vdWlvb2RnaGhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjQ2MTkzMzksImV4cCI6MjA4MDE5NTMzOX0.kxnx6-IPFhmGx6rzNx36vbyhFMFZKP_jFqaDbKnJ_E0";
-  }
+  // Anon key for public access (learn doesn't require authentication)
+  const SUPABASE_ANON_KEY =
+    "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InNpaWt3a2Znc21vdWlvb2RnaGhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjQ2MTkzMzksImV4cCI6MjA4MDE5NTMzOX0.kxnx6-IPFhmGx6rzNx36vbyhFMFZKP_jFqaDbKnJ_E0";
+
+  // Use anon key for public tool access - no auth required for learn command
+  const authToken = process.env.ENACT_AUTH_TOKEN ?? config.registry?.authToken ?? SUPABASE_ANON_KEY;
 
   const client = createApiClient({
     baseUrl: registryUrl,