@elisym/cli 0.6.0 → 0.7.0

package/README.md

@@ -89,16 +89,16 @@ docker run --rm -it \
 
 ## Commands
 
-| Command                              | Description                                                                                                                                                     |
-| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `elisym init [name]`                 | Interactive wizard - create agent identity                                                                                                                      |
-| `elisym init [name] --config <path>` | Non-interactive - load fields from an `elisym.yaml` template                                                                                                    |
-| `elisym init [name] --local`         | Create in project `.elisym/<name>/` (default: `~/.elisym/<name>/`)                                                                                              |
-| `elisym start [name]`                | Start agent in provider mode                                                                                                                                    |
-| `elisym start [name] --verbose`      | Start with structured debug logs to stderr (publish acks, pool resets, heartbeat, config resolution). Also togglable via `ELISYM_DEBUG=1` or `LOG_LEVEL=debug`. |
-| `elisym list`                        | List all agents (project-local + home-global)                                                                                                                   |
-| `elisym profile [name]`              | Edit agent profile, wallet, and LLM settings                                                                                                                    |
-| `elisym wallet [name]`               | Show Solana wallet balance                                                                                                                                      |
+| Command                              | Description                                                                                                                                          |
+| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `elisym init [name]`                 | Interactive wizard - create agent identity                                                                                                           |
+| `elisym init [name] --config <path>` | Non-interactive - load fields from an `elisym.yaml` template                                                                                         |
+| `elisym init [name] --local`         | Create in project `.elisym/<name>/` (default: `~/.elisym/<name>/`)                                                                                   |
+| `elisym start [name]`                | Start agent in provider mode                                                                                                                         |
+| `elisym start [name] --verbose`      | Start with structured debug logs to stderr (publish acks, pool resets, config resolution). Also togglable via `ELISYM_DEBUG=1` or `LOG_LEVEL=debug`. |
+| `elisym list`                        | List all agents (project-local + home-global)                                                                                                        |
+| `elisym profile [name]`              | Edit agent profile, wallet, and LLM settings                                                                                                         |
+| `elisym wallet [name]`               | Show Solana wallet balance                                                                                                                           |
 
 Skills live inside each agent directory at `<agentDir>/skills/<skill-name>/SKILL.md`:
 
@@ -247,7 +247,7 @@ See `skills-examples/` for working skills: `youtube-summary`, `github-repo`, `st
 If `elisym start` prints `* Running. Press Ctrl+C to stop.` but no jobs ever arrive (common on WSL and Windows when outbound relay connectivity is blocked by the firewall or NAT), run with `--verbose`:
 
 ```
-elisym start --verbose
+npx @elisym/cli start <agent-name> --verbose
 ```
 
 The debug firehose on stderr includes:
@@ -255,7 +255,6 @@ The debug firehose on stderr includes:
 - `config_resolved` - resolved agent dir, relays, RPC URL, Solana address.
 - `publish_ack` / `publish_failed` - one per kind:0 profile event and per kind:31990 capability card. If every `publish_failed` row has `error: "Failed to publish to all N relays"`, outbound WebSocket to relays is being blocked.
 - `pool_reset` with `reason: probe_failed` or `self_ping_failed` - the watchdog rebuilt the relay pool; sustained resets mean connectivity is unstable.
-- `heartbeat_failed` - periodic republish calls are failing.
 
 Optional deeper network diagnostics (DNS + TCP probe per relay host) are available via `ELISYM_NET_DIAG=1` (see `elisym start --help`).
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env -S node --no-deprecation
 import { readFileSync, readdirSync, statSync, renameSync, mkdirSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve, basename, relative, sep } from 'node:path';
-import { SolanaPaymentStrategy, validateAgentName, RELAYS, ElisymIdentity, formatSol, formatAssetAmount, ElisymClient, MediaService, jobRequestKind, DEFAULT_KIND_OFFSET, DEFAULTS, USDC_SOLANA_DEVNET, makeCensor, DEFAULT_REDACT_PATHS, createSlidingWindowLimiter, getProtocolProgramId, getProtocolConfig, LIMITS, calculateProtocolFee, BoundedSet, NATIVE_SOL } from '@elisym/sdk';
+import { SolanaPaymentStrategy, validateAgentName, RELAYS, ElisymIdentity, formatSol, formatAssetAmount, ElisymClient, MediaService, jobRequestKind, DEFAULT_KIND_OFFSET, DEFAULTS, USDC_SOLANA_DEVNET, makeCensor, DEFAULT_REDACT_PATHS, toDTag, createSlidingWindowLimiter, getProtocolProgramId, getProtocolConfig, LIMITS, calculateProtocolFee, BoundedSet, NATIVE_SOL } from '@elisym/sdk';
 import { ElisymYamlSchema, resolveInHome, resolveInProject, createAgentDir, writeYaml, writeSecrets, listAgents, loadAgent, agentPaths, readMediaCache, lookupCachedUrl, newCacheEntry, writeMediaCache } from '@elisym/sdk/agent-store';
 import { isAddress, createSolanaRpc, address } from '@solana/kit';
 import { generateSecretKey, getPublicKey, nip19 } from 'nostr-tools';
@@ -83,6 +83,11 @@ async function cmdInit(nameArg, options = {}) {
   const target = pickTarget(options);
   const sameLocation = target === "home" ? resolveInHome(agentName) : resolveInProject(agentName, cwd);
   if (sameLocation) {
+    if (options.yes) {
+      throw new Error(
+        `Agent "${agentName}" already exists at ${sameLocation}. Refusing to overwrite secrets under --yes. Remove the directory first or choose a different name.`
+      );
+    }
     const { overwrite } = await inquirer.prompt([
       {
         type: "confirm",
@@ -96,30 +101,34 @@ async function cmdInit(nameArg, options = {}) {
       return;
     }
   } else if (target === "project" && resolveInHome(agentName)) {
-    const { shadow } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "shadow",
-        message: `A global agent "${agentName}" exists in ~/.elisym/${agentName}/. Create a project-local shadow?`,
-        default: true
+    if (!options.yes) {
+      const { shadow } = await inquirer.prompt([
+        {
+          type: "confirm",
+          name: "shadow",
+          message: `A global agent "${agentName}" exists in ~/.elisym/${agentName}/. Create a project-local shadow?`,
+          default: true
+        }
+      ]);
+      if (!shadow) {
+        console.log("Aborted.");
+        return;
       }
-    ]);
-    if (!shadow) {
-      console.log("Aborted.");
-      return;
     }
   } else if (target === "home" && resolveInProject(agentName, cwd)) {
-    const { proceed } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "proceed",
-        message: `A project-local agent "${agentName}" exists. Create a global agent with the same name?`,
-        default: true
+    if (!options.yes) {
+      const { proceed } = await inquirer.prompt([
+        {
+          type: "confirm",
+          name: "proceed",
+          message: `A project-local agent "${agentName}" exists. Create a global agent with the same name?`,
+          default: true
+        }
+      ]);
+      if (!proceed) {
+        console.log("Aborted.");
+        return;
       }
-    ]);
-    if (!proceed) {
-      console.log("Aborted.");
-      return;
     }
   }
   let yaml;
@@ -153,24 +162,33 @@ async function cmdInit(nameArg, options = {}) {
       llmApiKey = apiKey || void 0;
     }
   }
-  const { passphrase } = await inquirer.prompt([
-    {
-      type: "password",
-      name: "passphrase",
-      message: "Passphrase to encrypt secrets (leave empty to skip):",
-      mask: "*"
-    }
-  ]);
-  if (passphrase) {
-    const { confirmPassphrase } = await inquirer.prompt([
+  let passphrase = "";
+  const envPassphrase = process.env.ELISYM_PASSPHRASE;
+  if (options.passphrase !== void 0) {
+    passphrase = options.passphrase;
+  } else if (envPassphrase !== void 0) {
+    passphrase = envPassphrase;
+  } else {
+    const answer = await inquirer.prompt([
       {
         type: "password",
-        name: "confirmPassphrase",
-        message: "Confirm passphrase:",
-        mask: "*",
-        validate: (value) => value === passphrase || "Passphrases do not match"
+        name: "passphrase",
+        message: "Passphrase to encrypt secrets (leave empty to skip):",
+        mask: "*"
       }
     ]);
+    passphrase = answer.passphrase ?? "";
+    if (passphrase) {
+      const { confirmPassphrase } = await inquirer.prompt([
+        {
+          type: "password",
+          name: "confirmPassphrase",
+          message: "Confirm passphrase:",
+          mask: "*",
+          validate: (value) => value === passphrase || "Passphrases do not match"
+        }
+      ]);
+    }
   }
   const nostrSecretBytes = generateSecretKey();
   const nostrPubkey = getPublicKey(nostrSecretBytes);
@@ -599,7 +617,6 @@ async function probeRelays(relays, logger, timeoutMs = TCP_PROBE_TIMEOUT_MS) {
   }
   return results;
 }
-var HEARTBEAT_INTERVAL_MS = 10 * 60 * 1e3;
 var MAX_CONCURRENT_JOBS = 10;
 var RECOVERY_MAX_RETRIES = 5;
 var RECOVERY_INTERVAL_SECS = 60;
@@ -1604,8 +1621,6 @@ var AgentRuntime = class {
     }
   }
 };
-
-// src/skill/index.ts
 var SkillRegistry = class {
   skills = [];
   defaultIndex = null;
@@ -1617,7 +1632,7 @@ var SkillRegistry = class {
   }
   route(tags) {
     for (const tag of tags) {
-      const byName = this.skills.find((skill) => skill.name === tag);
+      const byName = this.skills.find((skill) => toDTag(skill.name) === tag);
       if (byName) {
         return byName;
       }
@@ -1652,6 +1667,7 @@ var ScriptSkill = class {
   asset;
   image;
   imageFile;
+  dir;
   inner;
   constructor(name, description, capabilities, priceSubunits, assetOrImage, imageOrImageFile, imageFileOrDir, dirOrPrompt, promptOrTools, toolsOrRounds, rounds) {
     let asset;
@@ -1685,6 +1701,7 @@ var ScriptSkill = class {
     this.asset = asset;
     this.image = image;
     this.imageFile = imageFile;
+    this.dir = skillDir;
     this.inner = new ScriptSkill$1({
       name,
       description,
@@ -2090,11 +2107,12 @@ async function cmdStart(nameArg, options = {}) {
     (updated) => mediaCacheDirty = mediaCacheDirty || updated
   );
   for (const skill of allSkills) {
-    if (skill.image || !skill.imageFile) {
+    if (skill.image || !skill.imageFile || !skill.dir) {
       continue;
     }
-    const skillRoot = join(skillsDir, skill.name);
-    const cacheKey = `./skills/${skill.name}/${skill.imageFile}`;
+    const skillRoot = skill.dir;
+    const folderName = basename(skillRoot);
+    const cacheKey = `./skills/${folderName}/${skill.imageFile}`;
     const absPath = join(skillRoot, skill.imageFile);
     const url = await uploadOrReuse(
       cacheKey,
@@ -2196,19 +2214,6 @@ async function cmdStart(nameArg, options = {}) {
     client.ping.sendPong(identity, senderPubkey, nonce).catch(() => {
     });
   };
-  let heartbeatTimer = null;
-  if (allSkills.length > 0) {
-    const heartbeatCard = buildCard(allSkills[0]);
-    heartbeatTimer = setInterval(async () => {
-      try {
-        await client.discovery.publishCapability(identity, heartbeatCard, kinds);
-        logger.debug({ event: "heartbeat_ack", skill: heartbeatCard.name }, "heartbeat ok");
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        logger.warn({ event: "heartbeat_failed", error: message }, "heartbeat publish failed");
-      }
-    }, HEARTBEAT_INTERVAL_MS);
-  }
   const transport = new NostrTransport(client, identity, [DEFAULT_KIND_OFFSET]);
   const ledger = new JobLedger(paths.jobs);
   const runtimeConfig = {
@@ -2264,9 +2269,6 @@ async function cmdStart(nameArg, options = {}) {
     onLog: diagLog,
     onStop: () => {
       watchdog.stop();
-      if (heartbeatTimer) {
-        clearInterval(heartbeatTimer);
-      }
     }
   });
   console.log("  * Running. Press Ctrl+C to stop.\n");
@@ -2488,7 +2490,13 @@ function safe(fn) {
   };
 }
 var program = new Command().name("elisym").description("CLI agent runner for the elisym network").version(PACKAGE_VERSION);
-program.command("init [name]").description("Create a new agent").option("-c, --config <path>", "Load fields from an elisym.yaml template (non-interactive)").option("--local", "Create in project <project>/.elisym/<name>/ (default: ~/.elisym/<name>/)").action(
+program.command("init [name]").description("Create a new agent").option("-c, --config <path>", "Load fields from an elisym.yaml template (non-interactive)").option("--local", "Create in project <project>/.elisym/<name>/ (default: ~/.elisym/<name>/)").option(
+  "--passphrase <value>",
+  'Passphrase to encrypt secrets at rest. Empty string ("") skips encryption. Also reads ELISYM_PASSPHRASE env var. When neither is provided, prompts interactively.'
+).option(
+  "--yes",
+  "Skip confirmation prompts (shadow/sibling-location). Fails closed on an existing agent at the same location - never overwrites secrets silently."
+).action(
   safe(async (name, options) => {
     await cmdInit(name, options);
   })