@hasna/conversations 0.1.3 → 0.1.5

package/dist/index.js

@@ -2661,6 +2661,381 @@ function useSpaceMessages(spaceName) {
   return messages;
 }
 // src/lib/identity.ts
+import { readFileSync, writeFileSync, mkdirSync as mkdirSync2 } from "fs";
+import { join as join2, dirname as dirname2 } from "path";
+import { homedir as homedir2 } from "os";
+
+// src/lib/names.ts
+var AGENT_NAMES = [
+  "amber-fox",
+  "arctic-wolf",
+  "ashen-crow",
+  "azure-hawk",
+  "astral-lynx",
+  "autumn-bear",
+  "agile-puma",
+  "alpine-ibex",
+  "ancient-owl",
+  "aqua-otter",
+  "arid-viper",
+  "atom-finch",
+  "auburn-deer",
+  "aurora-seal",
+  "avid-mink",
+  "blaze-tiger",
+  "bright-heron",
+  "bronze-eagle",
+  "brisk-hare",
+  "burnt-moth",
+  "bold-raven",
+  "blue-whale",
+  "boreal-fox",
+  "brass-cobra",
+  "brave-ram",
+  "brick-crane",
+  "brief-newt",
+  "briny-crab",
+  "broad-elk",
+  "brook-dove",
+  "calm-panda",
+  "cedar-jay",
+  "chief-lion",
+  "chrome-bat",
+  "civic-wren",
+  "clear-swan",
+  "cliff-goat",
+  "coal-shark",
+  "cold-crane",
+  "copper-jay",
+  "coral-fish",
+  "crisp-lark",
+  "cross-mole",
+  "cubic-wasp",
+  "cyan-toad",
+  "dark-stag",
+  "dawn-robin",
+  "deep-squid",
+  "delta-fox",
+  "dense-boar",
+  "dew-spider",
+  "dim-gecko",
+  "draft-bear",
+  "drift-gull",
+  "dry-newt",
+  "dual-crane",
+  "dune-mouse",
+  "dusk-moth",
+  "dusty-mule",
+  "dwarf-carp",
+  "east-falcon",
+  "echo-parrot",
+  "edge-shark",
+  "elm-beetle",
+  "ember-lynx",
+  "epoch-crane",
+  "even-pike",
+  "extra-ant",
+  "elder-stork",
+  "ebon-crow",
+  "ever-finch",
+  "exact-moth",
+  "exile-wren",
+  "equal-dove",
+  "etch-hare",
+  "faint-orca",
+  "far-condor",
+  "fern-mouse",
+  "fierce-yak",
+  "first-kite",
+  "fjord-seal",
+  "flint-wolf",
+  "fog-parrot",
+  "forge-bull",
+  "fossil-ray",
+  "frank-mink",
+  "free-eagle",
+  "fresh-colt",
+  "frost-bear",
+  "fuse-wasp",
+  "gale-hawk",
+  "gem-turtle",
+  "ghost-lynx",
+  "gilt-robin",
+  "glad-moose",
+  "glass-eel",
+  "gleam-puma",
+  "glyph-owl",
+  "gold-crane",
+  "gorge-lion",
+  "grain-duck",
+  "grand-wolf",
+  "gray-fox",
+  "green-hare",
+  "grit-shark",
+  "half-stork",
+  "haze-panther",
+  "heart-dove",
+  "helm-eagle",
+  "herb-toad",
+  "hex-spider",
+  "high-falcon",
+  "hive-hornet",
+  "holo-swan",
+  "hood-cobra",
+  "horn-bison",
+  "huge-squid",
+  "hull-crab",
+  "hunt-marten",
+  "husk-moth",
+  "ice-leopard",
+  "idle-crane",
+  "inch-beetle",
+  "indigo-jay",
+  "inner-fox",
+  "ion-parrot",
+  "iron-bull",
+  "isle-pelican",
+  "ivory-hawk",
+  "ivy-snake",
+  "iota-wren",
+  "ink-raven",
+  "ignite-ram",
+  "inert-slug",
+  "infra-mole",
+  "jade-tiger",
+  "jest-magpie",
+  "jewel-crane",
+  "joint-boar",
+  "jovial-elk",
+  "jump-frog",
+  "jungle-cat",
+  "jury-dove",
+  "just-heron",
+  "jolt-wasp",
+  "keen-osprey",
+  "kelp-seal",
+  "key-falcon",
+  "kind-panda",
+  "knot-viper",
+  "kraft-bear",
+  "kite-mouse",
+  "knoll-deer",
+  "know-crane",
+  "karma-wolf",
+  "lake-otter",
+  "lapis-jay",
+  "last-condor",
+  "leaf-gecko",
+  "lean-coyote",
+  "light-lynx",
+  "lime-parrot",
+  "live-eagle",
+  "long-crane",
+  "lost-fox",
+  "loud-finch",
+  "low-shark",
+  "luck-rabbit",
+  "lunar-owl",
+  "lush-ibis",
+  "malt-badger",
+  "maple-wren",
+  "mars-falcon",
+  "matte-crow",
+  "mesa-hawk",
+  "mild-orca",
+  "mint-dove",
+  "mist-puma",
+  "mock-robin",
+  "mono-wolf",
+  "moon-bear",
+  "moss-turtle",
+  "mud-heron",
+  "mute-swan",
+  "myth-lynx",
+  "navy-eagle",
+  "near-mink",
+  "neon-parrot",
+  "nest-crane",
+  "next-fox",
+  "nimble-ram",
+  "node-spider",
+  "noon-hawk",
+  "north-seal",
+  "nova-owl",
+  "null-moth",
+  "numb-carp",
+  "nutmeg-jay",
+  "neat-cobra",
+  "nomad-elk",
+  "oak-badger",
+  "oat-finch",
+  "odd-pelican",
+  "olive-bear",
+  "onyx-raven",
+  "opal-crane",
+  "open-wolf",
+  "orbit-lynx",
+  "ore-shark",
+  "outer-dove",
+  "pale-tiger",
+  "park-heron",
+  "peak-eagle",
+  "pine-fox",
+  "pixel-owl",
+  "plain-goat",
+  "plum-crane",
+  "polar-ray",
+  "port-falcon",
+  "prime-wolf",
+  "prism-jay",
+  "proud-lion",
+  "pulse-bat",
+  "pure-swan",
+  "pyro-hawk",
+  "quake-bear",
+  "quartz-jay",
+  "quest-falcon",
+  "quick-otter",
+  "quiet-crane",
+  "rain-leopard",
+  "rapid-hare",
+  "raw-condor",
+  "reef-dolphin",
+  "regal-stag",
+  "ridge-fox",
+  "rift-cobra",
+  "rigid-crane",
+  "river-otter",
+  "rock-eagle",
+  "root-mole",
+  "rose-finch",
+  "rough-boar",
+  "ruby-hawk",
+  "rust-wolf",
+  "sage-owl",
+  "salt-crane",
+  "sand-viper",
+  "satin-dove",
+  "scale-dragon",
+  "scarlet-ibis",
+  "sea-falcon",
+  "shade-lynx",
+  "sharp-eagle",
+  "shell-crab",
+  "short-fox",
+  "sigma-jay",
+  "silk-moth",
+  "silver-wolf",
+  "slate-bear",
+  "slim-heron",
+  "smoke-puma",
+  "snap-turtle",
+  "snow-leopard",
+  "solar-crane",
+  "solid-ram",
+  "sonic-bat",
+  "south-seal",
+  "spark-robin",
+  "spice-wren",
+  "split-mink",
+  "spring-elk",
+  "squid-ink",
+  "stark-crow",
+  "steel-hawk",
+  "stern-bull",
+  "still-swan",
+  "stone-fox",
+  "storm-eagle",
+  "stout-boar",
+  "stray-cat",
+  "strong-lion",
+  "sun-parrot",
+  "surf-dolphin",
+  "swift-deer",
+  "teal-crane",
+  "terra-wolf",
+  "thick-bear",
+  "thin-spider",
+  "third-owl",
+  "thorn-fox",
+  "tide-seal",
+  "timber-jay",
+  "tiny-wren",
+  "toast-mole",
+  "topaz-hawk",
+  "torch-lynx",
+  "trace-falcon",
+  "true-eagle",
+  "tusk-walrus",
+  "ultra-crane",
+  "umbra-wolf",
+  "unit-fox",
+  "upper-hawk",
+  "urban-jay",
+  "vale-deer",
+  "vast-eagle",
+  "vault-bear",
+  "velvet-owl",
+  "vent-crane",
+  "verse-fox",
+  "vigor-lynx",
+  "vine-parrot",
+  "vivid-swan",
+  "void-raven",
+  "volt-hawk",
+  "vow-falcon",
+  "vintage-jay",
+  "vista-wolf",
+  "vital-hare",
+  "warm-otter",
+  "wave-dolphin",
+  "wax-crane",
+  "west-falcon",
+  "wheat-mouse",
+  "white-tiger",
+  "wide-eagle",
+  "wild-fox",
+  "wind-hawk",
+  "wire-spider",
+  "wise-owl",
+  "wood-thrush",
+  "wool-ram",
+  "wren-song",
+  "wry-crow",
+  "xeno-crane",
+  "xerus-fox",
+  "yarn-robin",
+  "yew-falcon",
+  "young-wolf",
+  "zeal-hawk",
+  "zen-panda",
+  "zero-crane",
+  "zinc-eagle",
+  "zone-fox"
+];
+
+// src/lib/identity.ts
+var AGENT_ID_FILE = join2(homedir2(), ".conversations", "agent-id");
+var cachedAutoName = null;
+function getAutoName() {
+  if (cachedAutoName)
+    return cachedAutoName;
+  try {
+    const name2 = readFileSync(AGENT_ID_FILE, "utf-8").trim();
+    if (name2) {
+      cachedAutoName = name2;
+      return name2;
+    }
+  } catch {}
+  const name = AGENT_NAMES[Math.floor(Math.random() * AGENT_NAMES.length)];
+  cachedAutoName = name;
+  try {
+    mkdirSync2(dirname2(AGENT_ID_FILE), { recursive: true });
+    writeFileSync(AGENT_ID_FILE, name + `
+`, "utf-8");
+  } catch {}
+  return name;
+}
 function resolveIdentity(explicit) {
   const explicitValue = explicit?.trim();
   if (explicitValue)
@@ -2668,7 +3043,7 @@ function resolveIdentity(explicit) {
   const envValue = process.env.CONVERSATIONS_AGENT_ID?.trim();
   if (envValue)
     return envValue;
-  return "user";
+  return getAutoName();
 }
 function requireIdentity(explicit) {
   const explicitValue = explicit?.trim();

package/dist/lib/identity.d.ts

@@ -1,6 +1,12 @@
+/**
+ * Get or create a persistent auto-generated agent name.
+ * Stored in ~/.conversations/agent-id so the same installation
+ * always gets the same name.
+ */
+export declare function getAutoName(): string;
 /**
  * Resolve agent identity.
- * Priority: explicit flag → CONVERSATIONS_AGENT_ID env → "user" fallback
+ * Priority: explicit flag → CONVERSATIONS_AGENT_ID env → auto-generated persistent name
  */
 export declare function resolveIdentity(explicit?: string): string;
 /**
@@ -8,3 +14,7 @@ export declare function resolveIdentity(explicit?: string): string;
  * Throws if no identity is set via flag or env.
  */
 export declare function requireIdentity(explicit?: string): string;
+/**
+ * Reset the cached auto name (for testing).
+ */
+export declare function _resetAutoName(): void;

package/dist/lib/names.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pool of unique agent names for auto-assignment.
+ * Format: adjective-animal, keeping them short, memorable, and fun.
+ */
+export declare const AGENT_NAMES: readonly ["amber-fox", "arctic-wolf", "ashen-crow", "azure-hawk", "astral-lynx", "autumn-bear", "agile-puma", "alpine-ibex", "ancient-owl", "aqua-otter", "arid-viper", "atom-finch", "auburn-deer", "aurora-seal", "avid-mink", "blaze-tiger", "bright-heron", "bronze-eagle", "brisk-hare", "burnt-moth", "bold-raven", "blue-whale", "boreal-fox", "brass-cobra", "brave-ram", "brick-crane", "brief-newt", "briny-crab", "broad-elk", "brook-dove", "calm-panda", "cedar-jay", "chief-lion", "chrome-bat", "civic-wren", "clear-swan", "cliff-goat", "coal-shark", "cold-crane", "copper-jay", "coral-fish", "crisp-lark", "cross-mole", "cubic-wasp", "cyan-toad", "dark-stag", "dawn-robin", "deep-squid", "delta-fox", "dense-boar", "dew-spider", "dim-gecko", "draft-bear", "drift-gull", "dry-newt", "dual-crane", "dune-mouse", "dusk-moth", "dusty-mule", "dwarf-carp", "east-falcon", "echo-parrot", "edge-shark", "elm-beetle", "ember-lynx", "epoch-crane", "even-pike", "extra-ant", "elder-stork", "ebon-crow", "ever-finch", "exact-moth", "exile-wren", "equal-dove", "etch-hare", "faint-orca", "far-condor", "fern-mouse", "fierce-yak", "first-kite", "fjord-seal", "flint-wolf", "fog-parrot", "forge-bull", "fossil-ray", "frank-mink", "free-eagle", "fresh-colt", "frost-bear", "fuse-wasp", "gale-hawk", "gem-turtle", "ghost-lynx", "gilt-robin", "glad-moose", "glass-eel", "gleam-puma", "glyph-owl", "gold-crane", "gorge-lion", "grain-duck", "grand-wolf", "gray-fox", "green-hare", "grit-shark", "half-stork", "haze-panther", "heart-dove", "helm-eagle", "herb-toad", "hex-spider", "high-falcon", "hive-hornet", "holo-swan", "hood-cobra", "horn-bison", "huge-squid", "hull-crab", "hunt-marten", "husk-moth", "ice-leopard", "idle-crane", "inch-beetle", "indigo-jay", "inner-fox", "ion-parrot", "iron-bull", "isle-pelican", "ivory-hawk", "ivy-snake", "iota-wren", "ink-raven", "ignite-ram", "inert-slug", "infra-mole", "jade-tiger", "jest-magpie", "jewel-crane", "joint-boar", "jovial-elk", "jump-frog", "jungle-cat", "jury-dove", "just-heron", "jolt-wasp", "keen-osprey", "kelp-seal", "key-falcon", "kind-panda", "knot-viper", "kraft-bear", "kite-mouse", "knoll-deer", "know-crane", "karma-wolf", "lake-otter", "lapis-jay", "last-condor", "leaf-gecko", "lean-coyote", "light-lynx", "lime-parrot", "live-eagle", "long-crane", "lost-fox", "loud-finch", "low-shark", "luck-rabbit", "lunar-owl", "lush-ibis", "malt-badger", "maple-wren", "mars-falcon", "matte-crow", "mesa-hawk", "mild-orca", "mint-dove", "mist-puma", "mock-robin", "mono-wolf", "moon-bear", "moss-turtle", "mud-heron", "mute-swan", "myth-lynx", "navy-eagle", "near-mink", "neon-parrot", "nest-crane", "next-fox", "nimble-ram", "node-spider", "noon-hawk", "north-seal", "nova-owl", "null-moth", "numb-carp", "nutmeg-jay", "neat-cobra", "nomad-elk", "oak-badger", "oat-finch", "odd-pelican", "olive-bear", "onyx-raven", "opal-crane", "open-wolf", "orbit-lynx", "ore-shark", "outer-dove", "pale-tiger", "park-heron", "peak-eagle", "pine-fox", "pixel-owl", "plain-goat", "plum-crane", "polar-ray", "port-falcon", "prime-wolf", "prism-jay", "proud-lion", "pulse-bat", "pure-swan", "pyro-hawk", "quake-bear", "quartz-jay", "quest-falcon", "quick-otter", "quiet-crane", "rain-leopard", "rapid-hare", "raw-condor", "reef-dolphin", "regal-stag", "ridge-fox", "rift-cobra", "rigid-crane", "river-otter", "rock-eagle", "root-mole", "rose-finch", "rough-boar", "ruby-hawk", "rust-wolf", "sage-owl", "salt-crane", "sand-viper", "satin-dove", "scale-dragon", "scarlet-ibis", "sea-falcon", "shade-lynx", "sharp-eagle", "shell-crab", "short-fox", "sigma-jay", "silk-moth", "silver-wolf", "slate-bear", "slim-heron", "smoke-puma", "snap-turtle", "snow-leopard", "solar-crane", "solid-ram", "sonic-bat", "south-seal", "spark-robin", "spice-wren", "split-mink", "spring-elk", "squid-ink", "stark-crow", "steel-hawk", "stern-bull", "still-swan", "stone-fox", "storm-eagle", "stout-boar", "stray-cat", "strong-lion", "sun-parrot", "surf-dolphin", "swift-deer", "teal-crane", "terra-wolf", "thick-bear", "thin-spider", "third-owl", "thorn-fox", "tide-seal", "timber-jay", "tiny-wren", "toast-mole", "topaz-hawk", "torch-lynx", "trace-falcon", "true-eagle", "tusk-walrus", "ultra-crane", "umbra-wolf", "unit-fox", "upper-hawk", "urban-jay", "vale-deer", "vast-eagle", "vault-bear", "velvet-owl", "vent-crane", "verse-fox", "vigor-lynx", "vine-parrot", "vivid-swan", "void-raven", "volt-hawk", "vow-falcon", "vintage-jay", "vista-wolf", "vital-hare", "warm-otter", "wave-dolphin", "wax-crane", "west-falcon", "wheat-mouse", "white-tiger", "wide-eagle", "wild-fox", "wind-hawk", "wire-spider", "wise-owl", "wood-thrush", "wool-ram", "wren-song", "wry-crow", "xeno-crane", "xerus-fox", "yarn-robin", "yew-falcon", "young-wolf", "zeal-hawk", "zen-panda", "zero-crane", "zinc-eagle", "zone-fox"];
+export type AgentName = typeof AGENT_NAMES[number];

package/dist/lib/presence.d.ts

@@ -5,3 +5,4 @@ export declare function listAgents(opts?: {
     online_only?: boolean;
 }): AgentPresence[];
 export declare function removePresence(agent: string): boolean;
+export declare function renameAgent(oldName: string, newName: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/conversations",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {