create-loopengine 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,89 @@
+# create-loopengine
+
+**Scaffold a new [loopengine](https://www.npmjs.com/package/loopengine)
+agent project — a runnable HTTP server, in your own repo, in one command.**
+
+`npm install loopengine` alone only gets you the library (`runAgent`,
+`AgentConfig`, session stores) — the HTTP server, the agent registry, and a
+runnable example are deliberately not part of that package. `create-loopengine`
+is the other half: a Rails/Laravel-style generator that gives you a
+complete, working project to build on, instead of a library import or a
+clone of loopengine's own source repo.
+
+## Usage
+
+```bash
+npm create loopengine@latest my-agents
+cd my-agents
+npm install
+cp .env.example .env   # fill in ANTHROPIC_API_KEY
+npm run dev             # HTTP server on :8787
+```
+
+```bash
+curl -X POST localhost:8787/agents/example-agent/messages \
+  -H 'content-type: application/json' \
+  -d '{"sessionId":"s1","message":"what is the weather in Boston?"}'
+```
+
+Or from the command line directly, no server needed:
+
+```bash
+npm run cli -- --agent example-agent "what is the weather in Boston?"
+```
+
+No name given? `npm create loopengine@latest` on its own scaffolds into
+`./my-agents`.
+
+## What you get
+
+A real, standalone project — its own `package.json` depending on
+`loopengine`, not a copy of loopengine's own repo:
+
+```
+package.json             Depends on loopengine — your project, not a fork
+agent-registry.ts         Maps agent name -> {config, createModelCall}, one line per agent
+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
+.env.example              ANTHROPIC_API_KEY / OPENAI_API_KEY / REDIS_URL
+```
+
+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).
+
+## 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`.
+3. Call it at `/agents/your-agent/messages`.
+
+## Adding external tools via Composio
+
+Need an agent to call a real SaaS action (list GitHub repos, send a Slack
+message) instead of a hand-written tool? Route it through
+[Composio](https://composio.dev) via
+[`mcpplug`](https://www.npmjs.com/package/mcpplug) rather than owning that
+vendor's OAuth yourself — see loopengine's own
+[README section on external tool gateways](https://github.com/evanyan22/loopengine#external-tool-gateways)
+for the pattern, and `agents/file-agent.ts` in that repo for a complete,
+working example. Not wired in here by default: it needs the `composio` CLI
+installed and an authenticated account (`composio link <toolkit>`) first,
+so it's a deliberate next step, not part of this starter agent.
+
+## Status
+
+Verified end to end against the real published packages: `npm create
+loopengine@latest` resolves and scaffolds, `npm install` resolves
+`loopengine` from the registry, the generated project typechecks clean,
+and the real HTTP server starts and correctly routes a request through
+session storage, permission gating, and tool scheduling up to the model
+call itself.
+
+MIT licensed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-loopengine",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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

@@ -44,6 +44,19 @@ adapters/http.ts         HTTP API (streaming + non-streaming)
 adapters/cli.ts          Command-line adapter
 ```
 
+## Adding external tools via Composio
+
+Need an agent to call a real SaaS action (list GitHub repos, send a Slack
+message) instead of a hand-written tool? Route it through
+[Composio](https://composio.dev) via
+[`mcpplug`](https://www.npmjs.com/package/mcpplug) rather than owning that
+vendor's OAuth yourself — see loopengine's own
+[README section on external tool gateways](https://github.com/evanyan22/loopengine#external-tool-gateways)
+for the pattern, and `agents/file-agent.ts` in that repo for a complete,
+working example. Not wired in here by default: it needs the `composio` CLI
+installed and an authenticated account (`composio link <toolkit>`) first,
+so it's a deliberate next step, not part of this starter agent.
+
 See [loopengine's own README](https://github.com/evanyan22/loopengine) for
 the full `AgentConfig` surface, permission rules, skills, and how to wire a
 real model.