create-loopengine 0.1.3 → 0.1.4

package/README.md

@@ -42,7 +42,7 @@ A real, standalone project — its own `package.json` depending on
 
 ```
 package.json             Depends on loopengine — your project, not a fork
-agent-registry.ts         Maps agent name -> {config, createModelCall}, one line per agent
+agent-registry.ts         Auto-discovers agents/*.ts by AgentConfig.name — nothing to edit here
 agents/example-agent.ts   Starter agent: persona, one tool, one permission rule
 adapters/http.ts          HTTP API (streaming + non-streaming), routes by agent name
 adapters/cli.ts           Command-line adapter
@@ -50,18 +50,21 @@ adapters/cli.ts           Command-line adapter
 ```
 
 The registry is multi-agent-capable from the start — seeded with one
-example agent, not architecturally limited to one — so adding a second
-agent later is one file plus one line in `agent-registry.ts`, not a
-rewrite. See [loopengine's own README](https://github.com/evanyan22/loopengine)
-for the full `AgentConfig` surface: permission rules, skills, context-budget
-recovery, and how to wire a real model (Anthropic or OpenAI, both included).
+example agent, not architecturally limited to one — built on loopengine's
+own `discoverAgents`: it scans `agents/` and keys each entry by
+`AgentConfig.name`, not the filename, so adding a second agent later is
+one new file, not a rewrite and not a registry edit either. See
+[loopengine's own README](https://github.com/evanyan22/loopengine) for the
+full `AgentConfig` surface: permission rules, skills, context-budget
+recovery, and how to wire a real model (Anthropic, OpenAI, or DeepSeek —
+all three included).
 
 ## Add another agent
 
 1. Copy `agents/example-agent.ts` to `agents/your-agent.ts` and edit its
-   `systemPrompt`, `tools`, and `rules`.
-2. Register it in `agent-registry.ts` — one line, same shape as
-   `example-agent`.
+   `name`, `systemPrompt`, `tools`, and `rules`.
+2. That's it — `agent-registry.ts` discovers it automatically, no
+   registration step.
 3. Call it at `/agents/your-agent/messages`.
 
 ## Adding external tools via Composio

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-loopengine",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Scaffold a new loopengine agent project — a runnable HTTP server with one example agent, in your own repo.",
   "license": "MIT",
   "type": "module",

package/template/README.md

@@ -30,15 +30,16 @@ npm run cli -- --agent example-agent "what is the weather in Boston?"
 ## Add another agent
 
 1. Copy `agents/example-agent.ts` to `agents/your-agent.ts` and edit its
-   `systemPrompt`, `tools`, and `rules`.
-2. Register it in `agent-registry.ts` — one line, same shape as
-   `example-agent`.
+   `name`, `systemPrompt`, `tools`, and `rules`.
+2. That's it — `agent-registry.ts` discovers it automatically by
+   `AgentConfig.name`, no registration step. Nothing to edit, no import to
+   add, no adapter change.
 3. Call it at `/agents/your-agent/messages`.
 
 ## Project layout
 
 ```
-agent-registry.ts       Maps agent name -> {config, createModelCall}
+agent-registry.ts       Auto-discovers agents/*.ts by AgentConfig.name — nothing to edit here
 agents/example-agent.ts Starter agent: persona, one tool, one permission rule
 adapters/http.ts         HTTP API (streaming + non-streaming)
 adapters/cli.ts          Command-line adapter

package/template/agent-registry.ts

@@ -1,24 +1,27 @@
 // Every adapter resolves "which agent" through this — the thing that
-// makes agents pluggable. Defining a new agent means adding one line here;
-// no adapter changes needed.
-import type { AgentConfig, ModelCall } from 'loopengine'
-import { config as exampleAgentConfig, createModelCall as createExampleAgentModelCall } from './agents/example-agent.js'
+// 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.
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { discoverAgents, type AgentModule } from 'loopengine'
 
-export interface RegistryEntry {
-  config: AgentConfig
-  /** Factory, not a shared instance — a fresh ModelCall per request/session. */
-  createModelCall: () => ModelCall
-}
+export type RegistryEntry = AgentModule
 
-const entries: Record<string, RegistryEntry> = {
-  'example-agent': { config: exampleAgentConfig, createModelCall: createExampleAgentModelCall },
-}
+const agentsDir = join(dirname(fileURLToPath(import.meta.url)), '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
+// settle first, so listAgents()/getEntry() below can stay synchronous —
+// no adapter needs to know discovery is async under the hood.
+const entries = await discoverAgents(agentsDir)
 
 export function listAgents(): string[] {
-  return Object.keys(entries)
+  return [...entries.keys()]
 }
 
 /** undefined for an unknown agent name. */
 export function getEntry(name: string): RegistryEntry | undefined {
-  return entries[name]
+  return entries.get(name)
 }

package/template/agents/example-agent.ts

@@ -1,6 +1,7 @@
 // A starting point, not a template to copy verbatim: real persona, real
-// tool, real permission rule. Add more agents by copying this file and
-// registering the new one in agent-registry.ts.
+// tool, real permission rule. Add more agents by copying this file into
+// agents/ under a new filename and a new AgentConfig.name — agent-registry.ts
+// discovers it automatically, nothing to register by hand.
 import { createAnthropicModelCall, type AgentConfig, type ModelCall } from 'loopengine'
 
 export const config: AgentConfig = {

package/template/package.json

@@ -9,7 +9,7 @@
     "cli": "tsx adapters/cli.ts"
   },
   "dependencies": {
-    "loopengine": "^0.0.4"
+    "loopengine": "^0.0.6"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",