@enactprotocol/cli 2.1.14 → 2.1.15

package/dist/commands/init/templates/tool-agents.js

@@ -0,0 +1,219 @@
+/**
+ * AGENTS.md template for tool development
+ */
+export const toolAgentsTemplate = `# Enact Tool Development Guide
+
+Enact tools are containerized, cryptographically-signed executables. Each tool is defined by a \`SKILL.md\` file (YAML frontmatter + Markdown docs).
+
+## Quick Reference
+
+| Task | Command |
+|------|---------|
+| Run with JSON | \`enact run ./ --args '{"key": "value"}'\` |
+| Run from file | \`enact run ./ --input-file inputs.json\` |
+| Dry run | \`enact run ./ --args '{}' --dry-run\` |
+| Sign & publish | \`enact sign ./ && enact publish ./\` |
+
+## SKILL.md Structure
+
+\`\`\`yaml
+---
+name: {{TOOL_NAME}}
+description: What the tool does
+version: 1.0.0
+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}
+timeout: 30s
+
+inputSchema:
+  type: object
+  properties:
+    input:
+      type: string
+      description: "Input to process"
+  required: [input]
+
+outputSchema:
+  type: object
+  properties:
+    result:
+      type: string
+
+env:
+  API_KEY:
+    description: "External API key"
+    secret: true                  # Set via: enact env set API_KEY --secret
+---
+# Tool Name
+Documentation here.
+\`\`\`
+
+## Field Reference
+
+| Field | Description |
+|-------|-------------|
+| \`name\` | Hierarchical ID: \`org/category/tool\` |
+| \`description\` | What the tool does |
+| \`version\` | Semver version |
+| \`from\` | Docker image |
+| \`build\` | Build commands (string or array, cached) |
+| \`command\` | Shell command with \`\${param}\` substitution |
+| \`timeout\` | Max execution time (e.g., "30s", "5m") |
+| \`inputSchema\` | JSON Schema for inputs |
+| \`outputSchema\` | JSON Schema for outputs |
+| \`env\` | Environment variables and secrets |
+
+## Parameter Substitution
+
+Enact auto-quotes parameters. **Never manually quote:**
+
+\`\`\`yaml
+# WRONG - causes double-quoting
+command: python /work/main.py "\${input}"
+
+# RIGHT - Enact handles quoting
+command: python /work/main.py \${input}
+\`\`\`
+
+**Optional params:** Missing optional params become empty strings. Always provide defaults:
+\`\`\`yaml
+inputSchema:
+  properties:
+    greeting: 
+      type: string
+      default: "Hello"  # Recommended for optional params
+\`\`\`
+
+Or handle empty in shell:
+\`\`\`yaml
+command: "echo \${greeting:-Hello} \${name}"
+\`\`\`
+
+Modifiers:
+- \`\${param}\` — auto-quoted (handles spaces, JSON, special chars)
+- \`\${param:raw}\` — raw, no quoting (use carefully)
+
+## Output
+
+Output valid JSON to stdout when \`outputSchema\` is defined:
+
+\`\`\`python
+import json, sys
+
+try:
+    result = do_work()
+    print(json.dumps({"status": "success", "result": result}))
+except Exception as e:
+    print(json.dumps({"status": "error", "message": str(e)}))
+    sys.exit(1)  # non-zero = error
+\`\`\`
+
+## Build Steps by Language
+
+**Python:**
+\`\`\`yaml
+from: python:3.12-slim
+build: pip install requests pandas
+\`\`\`
+
+**Node.js:**
+\`\`\`yaml
+from: node:20-alpine
+build:
+  - npm install
+  - npm run build
+\`\`\`
+
+**Rust:**
+\`\`\`yaml
+from: rust:1.83-slim
+build: rustc /work/main.rs -o /work/tool
+command: /work/tool \${input}
+\`\`\`
+
+**Go:**
+\`\`\`yaml
+from: golang:1.22-alpine
+build: cd /work && go build -o tool main.go
+command: /work/tool \${input}
+\`\`\`
+
+**System packages:**
+\`\`\`yaml
+build: apt-get update && apt-get install -y libfoo-dev
+\`\`\`
+
+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.
+
+## Secrets
+
+Declare in \`SKILL.md\`:
+\`\`\`yaml
+env:
+  API_KEY:
+    description: "API key for service"
+    secret: true
+\`\`\`
+
+Set before running:
+\`\`\`bash
+enact env set API_KEY --secret --namespace {{TOOL_NAME}}
+\`\`\`
+
+Access in code:
+\`\`\`python
+import os
+api_key = os.environ.get('API_KEY')
+\`\`\`
+
+## LLM Instruction Tools
+
+Tools without a \`command\` field are interpreted by LLMs:
+
+\`\`\`yaml
+---
+name: myorg/ai/reviewer
+description: AI-powered code review
+inputSchema:
+  type: object
+  properties:
+    code: { type: string }
+  required: [code]
+outputSchema:
+  type: object
+  properties:
+    issues: { type: array }
+    score: { type: number }
+---
+# Code Reviewer
+
+You are a senior engineer. Review the code for bugs, style, and security.
+Return JSON: {"issues": [...], "score": 75}
+\`\`\`
+
+## Publishing Checklist
+
+- [ ] \`name\` follows \`namespace/category/tool\` pattern
+- [ ] \`version\` set (semver)
+- [ ] \`description\` is clear and searchable
+- [ ] \`inputSchema\` / \`outputSchema\` defined
+- [ ] \`from\` uses pinned image version
+- [ ] \`timeout\` set appropriately
+- [ ] Tool tested locally with \`enact run ./\`
+
+## Troubleshooting
+
+\`\`\`bash
+enact run ./ --args '{"x": "y"}' --verbose   # Verbose output
+enact run ./ --args '{}' --dry-run             # Preview command
+enact list                                      # List installed tools
+\`\`\`
+`;
+//# sourceMappingURL=tool-agents.js.map

package/dist/commands/init/templates/tool-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-agents.js","sourceRoot":"","sources":["../../../../src/commands/init/templates/tool-agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsNjC,CAAC"}

package/dist/commands/init/templates/tool-skill.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SKILL.md template for new tool creation
+ */
+export declare const toolSkillTemplate = "---\nname: {{TOOL_NAME}}\ndescription: A simple tool that echoes a greeting\nversion: 0.1.0\nenact: \"2.0\"\n\nfrom: python:3.12-slim\n\n# Install dependencies (cached by Dagger)\nbuild: |\n  pip install requests\n\n# Environment variables (optional)\n# env:\n#   API_KEY:\n#     secret: true\n#     description: \"Your API key\"\n\ninputSchema:\n  type: object\n  properties:\n    name:\n      type: string\n      description: Name to greet\n      default: World\n  required: []\n\ncommand: |\n  echo \"Hello, ${name}!\"\n---\n\n# {{TOOL_NAME}}\n\nA simple greeting tool created with `enact init`.\n\n## Usage\n\n```bash\nenact run ./ --args '{\"name\": \"Alice\"}'\n```\n\n## Customization\n\nEdit this file to create your own tool:\n\n1. Update the `name` and `description` in the frontmatter\n2. Change the `from` image to match your runtime (python, node, rust, etc.)\n3. Add dependencies in the `build` section (pip install, npm install, etc.)\n4. Uncomment and configure `env` for secrets/API keys\n5. Modify the `inputSchema` to define your tool's inputs\n6. Change the `command` to run your script or shell commands\n7. Update this documentation section\n\n## Environment Variables\n\nTo use secrets, uncomment the `env` section above, then set the value:\n\n```bash\nenact env set API_KEY --secret --namespace {{TOOL_NAME}}\n```\n\nAccess in your code:\n```python\nimport os\napi_key = os.environ.get('API_KEY')\n```\n\n## Learn More\n\n- [Enact Documentation](https://enact.dev/docs)\n- [Tool Manifest Reference](https://enact.dev/docs/manifest)\n";
+//# sourceMappingURL=tool-skill.d.ts.map

package/dist/commands/init/templates/tool-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-skill.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/templates/tool-skill.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,2hDAuE7B,CAAC"}

package/dist/commands/init/templates/tool-skill.js

@@ -0,0 +1,76 @@
+/**
+ * SKILL.md template for new tool creation
+ */
+export const toolSkillTemplate = `---
+name: {{TOOL_NAME}}
+description: A simple tool that echoes a greeting
+version: 0.1.0
+enact: "2.0"
+
+from: python:3.12-slim
+
+# Install dependencies (cached by Dagger)
+build: |
+  pip install requests
+
+# Environment variables (optional)
+# env:
+#   API_KEY:
+#     secret: true
+#     description: "Your API key"
+
+inputSchema:
+  type: object
+  properties:
+    name:
+      type: string
+      description: Name to greet
+      default: World
+  required: []
+
+command: |
+  echo "Hello, \${name}!"
+---
+
+# {{TOOL_NAME}}
+
+A simple greeting tool created with \`enact init\`.
+
+## Usage
+
+\`\`\`bash
+enact run ./ --args '{"name": "Alice"}'
+\`\`\`
+
+## Customization
+
+Edit this file to create your own tool:
+
+1. Update the \`name\` and \`description\` in the frontmatter
+2. Change the \`from\` image to match your runtime (python, node, rust, etc.)
+3. Add dependencies in the \`build\` section (pip install, npm install, etc.)
+4. Uncomment and configure \`env\` for secrets/API keys
+5. Modify the \`inputSchema\` to define your tool's inputs
+6. Change the \`command\` to run your script or shell commands
+7. Update this documentation section
+
+## Environment Variables
+
+To use secrets, uncomment the \`env\` section above, then set the value:
+
+\`\`\`bash
+enact env set API_KEY --secret --namespace {{TOOL_NAME}}
+\`\`\`
+
+Access in your code:
+\`\`\`python
+import os
+api_key = os.environ.get('API_KEY')
+\`\`\`
+
+## Learn More
+
+- [Enact Documentation](https://enact.dev/docs)
+- [Tool Manifest Reference](https://enact.dev/docs/manifest)
+`;
+//# sourceMappingURL=tool-skill.js.map

package/dist/commands/init/templates/tool-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-skill.js","sourceRoot":"","sources":["../../../../src/commands/init/templates/tool-skill.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEhC,CAAC"}

package/dist/index.d.ts

@@ -5,6 +5,6 @@
  * Command-line interface for Enact.
  * User-facing commands for tool execution, discovery, and management.
  */
-export declare const version = "2.1.14";
+export declare const version = "2.1.15";
 export type { GlobalOptions, CommandContext } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -9,7 +9,7 @@ import { ensureGlobalSetup } from "@enactprotocol/shared";
 import { Command } from "commander";
 import { configureAuthCommand, configureCacheCommand, configureConfigCommand, configureEnvCommand, configureExecCommand, configureInfoCommand, configureInitCommand, configureInspectCommand, configureInstallCommand, configureLearnCommand, configureListCommand, configurePublishCommand, configureReportCommand, configureRunCommand, configureSearchCommand, configureSetupCommand, configureSignCommand, configureTrustCommand, configureUnyankCommand, configureVisibilityCommand, configureYankCommand, } from "./commands";
 import { error, formatError } from "./utils";
-export const version = "2.1.14";
+export const version = "2.1.15";
 // Main CLI entry point
 async function main() {
     // Ensure global setup is complete on first run

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enactprotocol/cli",
-  "version": "2.1.14",
+  "version": "2.1.15",
   "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.14",
-    "@enactprotocol/execution": "2.1.14",
-    "@enactprotocol/secrets": "2.1.14",
-    "@enactprotocol/shared": "2.1.14",
+    "@enactprotocol/api": "2.1.15",
+    "@enactprotocol/execution": "2.1.15",
+    "@enactprotocol/secrets": "2.1.15",
+    "@enactprotocol/shared": "2.1.15",
     "commander": "^12.1.0",
     "picocolors": "^1.1.1"
   },