@enactprotocol/cli 2.2.4 → 2.3.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AA+BH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAgCH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -7,9 +7,9 @@
  */
 import { ensureGlobalSetup } from "@enactprotocol/shared";
 import { Command } from "commander";
-import { configureAuthCommand, configureCacheCommand, configureConfigCommand, configureEnvCommand, configureExecCommand, configureInfoCommand, configureInitCommand, configureInspectCommand, configureInstallCommand, configureLearnCommand, configureListCommand, configureMcpCommand, configurePublishCommand, configureReportCommand, configureRunCommand, configureSearchCommand, configureSetupCommand, configureSignCommand, configureTrustCommand, configureUnyankCommand, configureValidateCommand, configureVisibilityCommand, configureYankCommand, } from "./commands";
+import { configureAuthCommand, configureCacheCommand, configureConfigCommand, configureEnvCommand, configureExecCommand, configureInfoCommand, configureInitCommand, configureInspectCommand, configureInstallCommand, configureLearnCommand, configureListCommand, configureMcpCommand, configurePublishCommand, configureReportCommand, configureRunCommand, configureSearchCommand, configureServeCommand, configureSetupCommand, configureSignCommand, configureTrustCommand, configureUnyankCommand, configureValidateCommand, configureVisibilityCommand, configureYankCommand, } from "./commands";
 import { error, formatError } from "./utils";
-export const version = "2.2.4";
+export const version = "2.3.1";
 // Main CLI entry point
 async function main() {
     // Ensure global setup is complete on first run
@@ -49,6 +49,8 @@ async function main() {
     configureMcpCommand(program);
     // Validation command
     configureValidateCommand(program);
+    // Self-hosted registry
+    configureServeCommand(program);
     // Global error handler - handle Commander's help/version exits gracefully
     program.exitOverride((err) => {
         // Commander throws errors for help, version, and other "exit" scenarios

package/dist/index.js.map

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

package/dist/utils/errors.js

@@ -47,7 +47,7 @@ export class ToolNotFoundError extends CliError {
 export class ManifestError extends CliError {
     constructor(message, path) {
         const fullMessage = path ? `${message} in ${path}` : message;
-        super(fullMessage, EXIT_MANIFEST_ERROR, "Ensure the directory contains a valid enact.yaml or enact.md file.");
+        super(fullMessage, EXIT_MANIFEST_ERROR, "Ensure the directory contains a valid skill.yaml or SKILL.md file.");
         this.name = "ManifestError";
     }
 }
@@ -288,7 +288,7 @@ export const ErrorMessages = {
         message: `No manifest found in ${dir}`,
         suggestions: [
             `Create a manifest: ${colors.command("enact init")}`,
-            "Ensure the directory contains enact.yaml or enact.md",
+            "Ensure the directory contains skill.yaml or SKILL.md",
         ],
     }),
     invalidManifest: (errors) => ({

package/package.json

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

package/src/commands/cache/index.ts

@@ -6,7 +6,7 @@
 
 import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
 import { join } from "node:path";
-import { getCacheDir, tryLoadManifestFromDir } from "@enactprotocol/shared";
+import { getSkillsDir, tryLoadManifestFromDir } from "@enactprotocol/shared";
 import type { Command } from "commander";
 import type { CommandContext, GlobalOptions } from "../../types";
 import {
@@ -114,7 +114,7 @@ function listCachedTools(cacheDir: string): CachedTool[] {
  * Cache list handler
  */
 async function listHandler(options: CacheOptions, _ctx: CommandContext): Promise<void> {
-  const cacheDir = getCacheDir();
+  const cacheDir = getSkillsDir();
   const tools = listCachedTools(cacheDir);
 
   if (options.json) {
@@ -165,7 +165,7 @@ async function listHandler(options: CacheOptions, _ctx: CommandContext): Promise
  * Cache clean handler - remove old/unused tools
  */
 async function cleanHandler(options: CacheOptions, ctx: CommandContext): Promise<void> {
-  const cacheDir = getCacheDir();
+  const cacheDir = getSkillsDir();
   const tools = listCachedTools(cacheDir);
 
   if (tools.length === 0) {
@@ -207,7 +207,7 @@ async function cleanHandler(options: CacheOptions, ctx: CommandContext): Promise
  * Cache clear handler - remove entire cache
  */
 async function clearHandler(options: CacheOptions, ctx: CommandContext): Promise<void> {
-  const cacheDir = getCacheDir();
+  const cacheDir = getSkillsDir();
 
   if (!existsSync(cacheDir)) {
     info("Cache directory does not exist.");
@@ -243,7 +243,7 @@ async function clearHandler(options: CacheOptions, ctx: CommandContext): Promise
  * Cache info handler
  */
 async function infoHandler(options: CacheOptions, _ctx: CommandContext): Promise<void> {
-  const cacheDir = getCacheDir();
+  const cacheDir = getSkillsDir();
   const exists = existsSync(cacheDir);
   const tools = exists ? listCachedTools(cacheDir) : [];
   const size = exists ? getDirSize(cacheDir) : 0;

package/src/commands/env/README.md

@@ -139,7 +139,7 @@ When a tool runs, environment variables are resolved in this order:
 
 1. **Local** - `.enact/.env` in the project directory
 2. **Global** - `~/.enact/.env`
-3. **Manifest defaults** - Default values from `enact.yaml`
+3. **Manifest defaults** - Default values from `skill.yaml`
 
 ## Secret Namespaces
 

package/src/commands/index.ts

@@ -38,3 +38,6 @@ export { configureMcpCommand } from "./mcp";
 
 // Validation command
 export { configureValidateCommand } from "./validate";
+
+// Self-hosted registry
+export { configureServeCommand } from "./serve";

package/src/commands/inspect/index.ts

@@ -9,7 +9,7 @@
 import { mkdirSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { createApiClient, downloadBundle, getToolInfo } from "@enactprotocol/api";
-import { getCacheDir, loadConfig, pathExists } from "@enactprotocol/shared";
+import { loadConfig, pathExists } from "@enactprotocol/shared";
 import type { Command } from "commander";
 import type { CommandContext, GlobalOptions } from "../../types";
 import {
@@ -65,7 +65,8 @@ function formatBytes(bytes: number): string {
  * Extract a tar.gz bundle to a directory
  */
 async function extractBundle(bundleData: ArrayBuffer, destPath: string): Promise<void> {
-  const tempFile = join(getCacheDir(), `inspect-${Date.now()}.tar.gz`);
+  const { tmpdir } = await import("node:os");
+  const tempFile = join(tmpdir(), `enact-inspect-${Date.now()}.tar.gz`);
   mkdirSync(dirname(tempFile), { recursive: true });
   writeFileSync(tempFile, Buffer.from(bundleData));
 

package/src/commands/install/README.md

@@ -96,7 +96,7 @@ When installing by name, the command searches for the tool in this order:
 
 1. Project tools (`.enact/tools/`)
 2. User tools (`~/.enact/tools/`)
-3. Cache (`~/.enact/cache/`)
+3. Skills directory (`~/.agent/skills/`)
 4. Registry (future)
 
 ## Directory Structure
@@ -112,7 +112,7 @@ After installation, tools are organized by their namespaced name:
 │           └── ...
 └── EnactProtocol/
     └── pdf-extract/
-        ├── enact.yaml
+        ├── skill.yaml
         └── ...
 ```
 

package/src/commands/install/index.ts

@@ -2,7 +2,7 @@
  * enact install command
  *
  * Install a tool to the project or globally.
- * All tools are extracted to ~/.enact/cache/{tool}/{version}/
+ * All tools are extracted to ~/.agent/skills/{tool}/
  * - Project install: Adds entry to .enact/tools.json
  * - Global install: Adds entry to ~/.enact/tools.json
  *
@@ -25,7 +25,6 @@ import {
   addAlias,
   addMcpTool,
   addToolToRegistry,
-  getCacheDir,
   getInstalledVersion,
   getMinimumAttestations,
   getProjectEnactDir,
@@ -110,7 +109,8 @@ function isLocalPath(toolName: string): boolean {
  */
 async function extractBundle(bundleData: ArrayBuffer, destPath: string): Promise<void> {
   // Create a temporary file for the bundle
-  const tempFile = join(getCacheDir(), `bundle-${Date.now()}.tar.gz`);
+  const { tmpdir } = await import("node:os");
+  const tempFile = join(tmpdir(), `enact-bundle-${Date.now()}.tar.gz`);
   mkdirSync(dirname(tempFile), { recursive: true });
   writeFileSync(tempFile, Buffer.from(bundleData));
 
@@ -149,6 +149,40 @@ function formatBytes(bytes: number): string {
   return `${(bytes / k ** i).toFixed(1)} ${sizes[i]}`;
 }
 
+/**
+ * Run postinstall hook commands in the tool directory.
+ * Runs each command sequentially; throws on first failure.
+ */
+async function runPostinstallHook(
+  toolDir: string,
+  hookCommands: string | string[],
+  _toolName: string,
+  verbose?: boolean
+): Promise<void> {
+  const commands = Array.isArray(hookCommands) ? hookCommands : [hookCommands];
+
+  for (const cmd of commands) {
+    if (verbose) {
+      dim(`  Running: ${cmd}`);
+    }
+
+    const proc = Bun.spawn(["sh", "-c", cmd], {
+      cwd: toolDir,
+      stdout: verbose ? "inherit" : "pipe",
+      stderr: "pipe",
+      env: { ...process.env },
+    });
+
+    const exitCode = await proc.exited;
+    if (exitCode !== 0) {
+      const stderr = await new Response(proc.stderr).text();
+      throw new Error(
+        `postinstall hook failed (exit ${exitCode}): ${cmd}${stderr ? `\n${stderr.trim()}` : ""}`
+      );
+    }
+  }
+}
+
 /**
  * Install from the registry
  */
@@ -438,6 +472,26 @@ async function installFromRegistry(
     throw new RegistryError(`Failed to extract bundle: ${formatError(err)}`);
   }
 
+  // Run postinstall hook if the manifest defines one
+  const extractedManifest = loadManifestFromDir(cachePath);
+  if (extractedManifest?.manifest.hooks?.postinstall) {
+    try {
+      await withSpinner(
+        "Running postinstall hook...",
+        async () =>
+          runPostinstallHook(
+            cachePath,
+            extractedManifest.manifest.hooks!.postinstall!,
+            toolName,
+            options.verbose
+          ),
+        `${symbols.success} postinstall complete`
+      );
+    } catch (err) {
+      info(`${symbols.warning} postinstall hook failed: ${formatError(err)}`);
+    }
+  }
+
   // Update tools.json for the appropriate scope
   addToolToRegistry(toolName, targetVersion!, scope, isGlobal ? undefined : ctx.cwd);
 
@@ -485,7 +539,7 @@ async function installFromRegistry(
  * Install from a local path
  *
  * Both global and project installs:
- * 1. Copy tool to cache (~/.enact/cache/{tool}/{version}/)
+ * 1. Copy tool to ~/.agent/skills/{tool}/
  * 2. Update tools.json (global: ~/.enact/tools.json, project: .enact/tools.json)
  */
 async function installFromPath(
@@ -547,6 +601,25 @@ async function installFromPath(
     `${symbols.success} Installed ${manifest.name}`
   );
 
+  // Run postinstall hook if the manifest defines one
+  if (manifest.hooks?.postinstall) {
+    try {
+      await withSpinner(
+        "Running postinstall hook...",
+        async () =>
+          runPostinstallHook(
+            cachePath,
+            manifest.hooks!.postinstall!,
+            manifest.name,
+            options.verbose
+          ),
+        `${symbols.success} postinstall complete`
+      );
+    } catch (err) {
+      info(`${symbols.warning} postinstall hook failed: ${formatError(err)}`);
+    }
+  }
+
   // Update tools.json for the appropriate scope
   addToolToRegistry(manifest.name, version, scope, isGlobal ? undefined : ctx.cwd);
 

package/src/commands/learn/index.ts

@@ -18,6 +18,7 @@ import {
   verifyAllAttestations,
 } from "@enactprotocol/api";
 import {
+  type ActionsManifest,
   getMinimumAttestations,
   getTrustPolicy,
   getTrustedAuditors,
@@ -45,6 +46,48 @@ interface LearnOptions extends GlobalOptions {
   local?: boolean;
 }
 
+/**
+ * Display available actions from an ActionsManifest
+ */
+function displayActions(actionsManifest: ActionsManifest): void {
+  newline();
+  header("Available Actions");
+  newline();
+
+  // Iterate over action map (name is the key)
+  for (const [actionName, action] of Object.entries(actionsManifest.actions)) {
+    info(`  ${actionName}`);
+    if (action.description) {
+      dim(`    ${action.description}`);
+    }
+
+    // Show input parameters
+    if (action.inputSchema?.properties) {
+      const required = new Set(
+        Array.isArray(action.inputSchema.required) ? action.inputSchema.required : []
+      );
+      const props = action.inputSchema.properties as Record<
+        string,
+        { type?: string; description?: string }
+      >;
+      const paramNames = Object.keys(props);
+
+      if (paramNames.length > 0) {
+        dim("    Parameters:");
+        for (const paramName of paramNames) {
+          const prop = props[paramName];
+          const isRequired = required.has(paramName);
+          const reqLabel = isRequired ? " (required)" : "";
+          dim(`      - ${paramName}: ${prop?.type ?? "any"}${reqLabel}`);
+        }
+      }
+    }
+    newline();
+  }
+
+  dim("Run an action with: enact run <skill>:<action> --args '{...}'");
+}
+
 /**
  * Learn command handler
  */
@@ -69,6 +112,13 @@ async function learnHandler(
           version: resolution.manifest.version,
           documentation: content,
           source: "local",
+          actions: resolution.actionsManifest
+            ? Object.entries(resolution.actionsManifest.actions).map(([name, a]) => ({
+                name,
+                description: a.description,
+                inputSchema: a.inputSchema,
+              }))
+            : null,
         });
         return;
       }
@@ -77,6 +127,11 @@ async function learnHandler(
       dim("(installed locally)");
       newline();
       console.log(content);
+
+      // Display actions if available
+      if (resolution.actionsManifest) {
+        displayActions(resolution.actionsManifest);
+      }
       return;
     }
 
@@ -87,6 +142,13 @@ async function learnHandler(
         version: resolution.manifest.version,
         documentation: resolution.manifest.doc ?? resolution.manifest.description ?? null,
         source: "local",
+        actions: resolution.actionsManifest
+          ? Object.entries(resolution.actionsManifest.actions).map(([name, a]) => ({
+              name,
+              description: a.description,
+              inputSchema: a.inputSchema,
+            }))
+          : null,
       });
       return;
     }
@@ -97,6 +159,11 @@ async function learnHandler(
     console.log(
       resolution.manifest.doc ?? resolution.manifest.description ?? "No documentation available."
     );
+
+    // Display actions if available
+    if (resolution.actionsManifest) {
+      displayActions(resolution.actionsManifest);
+    }
     return;
   }
 

package/src/commands/list/index.ts

@@ -5,7 +5,7 @@
  * - Default: project tools (via .enact/tools.json)
  * - --global/-g: global tools (via ~/.enact/tools.json)
  *
- * All tools are stored in ~/.enact/cache/{tool}/{version}/
+ * All tools are stored in ~/.agent/skills/{tool}/
  */
 
 import {

package/src/commands/run/README.md

@@ -10,7 +10,7 @@ enact run <tool> [options]
 
 ## Description
 
-The `run` command executes a tool using the command defined in its manifest (`enact.yaml` or `enact.md`). The tool runs in an isolated container environment with:
+The `run` command executes a tool using the command defined in its manifest (`skill.yaml` or `SKILL.md`). The tool runs in an isolated container environment with:
 
 - Input validation against the tool's JSON Schema
 - Automatic secret resolution from the OS keyring