create-loopengine 0.1.9 → 0.1.12

package/template/agent-registry.ts

@@ -1,15 +1,20 @@
 // Every adapter resolves "which agent" through this — the thing that
-// makes agents pluggable. Defining a new agent means adding a file to
-// agents/ that exports `config` and `createModelCall` — nothing here or
-// in any adapter needs to change; discoverAgents scans that directory and
-// keys each entry by AgentConfig.name (not the filename) at import time.
+// makes agents pluggable. Defining a new agent means adding a file (or a
+// folder) to agents/ that exports `config` and `createModelCall` —
+// nothing here or in any adapter needs to change; discoverAgents scans
+// that directory and keys each entry by AgentConfig.name (not the
+// filename) at import time.
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { discoverAgents, type AgentModule } from 'loopengine'
+import { discoverAgents, type AgentConfig, type AgentModule, type ModelCall } from 'loopengine'
 
 export type RegistryEntry = AgentModule
 
-const agentsDir = join(dirname(fileURLToPath(import.meta.url)), 'agents')
+// This file lives at the project root, alongside agents/ — no '..' needed
+// (unlike loopengine's own core/agent-registry.ts, which lives nested one
+// level down in core/).
+const projectRoot = dirname(fileURLToPath(import.meta.url))
+const agentsDir = join(projectRoot, 'agents')
 
 // Top-level await: ESM guarantees an importer's own evaluation (adapters/
 // http.ts, adapters/cli.ts) waits for this module's top-level await to
@@ -25,3 +30,50 @@ export function listAgents(): string[] {
 export function getEntry(name: string): RegistryEntry | undefined {
   return entries.get(name)
 }
+
+/** Where this registry's own discoverAgents call resolved agents/
+ * against — exported so a caller creating a *new* agent module (the
+ * Admin UI's "Create new agent" flow, via loopengine's own scaffoldAgent)
+ * writes it to the exact same place this registry would find it on a
+ * future restart, rather than re-deriving a base dir independently (e.g.
+ * from process.cwd(), which isn't guaranteed to match if the process is
+ * launched from elsewhere) and risking the two drifting apart. */
+export function projectDir(): string {
+  return projectRoot
+}
+
+/** Adds one already-loaded agent module to the live registry in place —
+ * how a newly created agent becomes runnable in *this* process
+ * immediately, with no restart — unlike discoverAgents' own directory
+ * scan, which only ever runs once, at this module's own import time (see
+ * the top-level await above). Throws on a name collision with an
+ * already-registered agent, same as discoverAgents itself does for a
+ * collision found during its initial scan — a duplicate AgentConfig.name
+ * is a bug either way, not something to silently overwrite. */
+export function registerAgent(agentModule: RegistryEntry): void {
+  const name = agentModule.config.name
+  if (entries.has(name)) {
+    throw new Error(`Duplicate agent name '${name}' — an agent with this name is already registered.`)
+  }
+  entries.set(name, agentModule)
+}
+
+/** Applies a partial update to an already-registered agent — how an edit
+ * made through the Admin UI takes effect in *this* running process
+ * immediately, the same "no restart needed" principle gateway-tools.yml/
+ * actauth.yml/SKILL.md edits already have. Mutates the same AgentConfig
+ * object every existing getEntry() caller already holds a reference to —
+ * via Object.assign, not a full replacement — so nothing needs to
+ * re-fetch it to see the change, and any field left out of `patch.config`
+ * (tools, rules, skillsDirs, ...) stays exactly as it was.
+ * `patch.createModelCall`, if given, replaces the cached one wholesale.
+ * Throws if `name` isn't already registered — this updates an existing
+ * entry, it's not a back door around registerAgent's own creation path. */
+export function updateAgent(name: string, patch: { config?: Partial<AgentConfig>; createModelCall?: () => ModelCall }): void {
+  const entry = entries.get(name)
+  if (!entry) {
+    throw new Error(`No registered agent named '${name}' to update.`)
+  }
+  if (patch.config) Object.assign(entry.config, patch.config)
+  if (patch.createModelCall) entry.createModelCall = patch.createModelCall
+}

package/template/package.json

@@ -9,7 +9,9 @@
     "cli": "tsx adapters/cli.ts"
   },
   "dependencies": {
-    "loopengine": "^0.1.3"
+    "loopengine": "^0.1.4",
+    "actauth": "^0.0.12",
+    "skillgarden": "^0.0.5"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",