coding-agent-forge 0.1.1 → 1.0.0

package/README.md

@@ -11,11 +11,15 @@ SDK.
 - `qwen`: wraps `@qwen-code/sdk`
 - `opencode`: wraps `@opencode-ai/sdk`
 
-The workflow layer gets records with a `runtime` marker added:
+The workflow layer gets `RuntimeRecord` values with a `runtime` marker added:
 `{ runtime: "codex", input }`, `{ runtime: "codex", event }`,
 `{ runtime: "claude", message }`, `{ runtime: "qwen", message }`,
 `{ runtime: "opencode", request }`, or `{ runtime: "opencode", event }`.
 
+On top of runtimes and threads, the `agent` layer lets each agent accept prompt
+variables, combine them with static prompt constants, build a prompt internally,
+and pass that prompt to the underlying thread.
+
 ## Install
 
 ```bash
@@ -46,40 +50,155 @@ threads:
     options:
       model: gpt-5.4
       workingDirectory: .
+
+agents:
+  reviewer:
+    kind: prompt-template
+    thread: runner
+    constants:
+      template: |
+        Review this task in {{ language }}.
+
+        {{ prompt }}
+      language: Chinese
+```
+
+For `claude` and `qwen` runtimes, `runtime.options` uses the same shape as
+`thread.options`. These options are not SDK client or server initialization
+parameters; they are default query options for every thread started from that
+runtime. A thread's own `options` are merged over the runtime defaults.
+
+```yaml
+runtimes:
+  claude-main:
+    kind: claude
+    options:
+      model: claude-sonnet-4-5
+      permissionMode: acceptEdits
+
+threads:
+  review:
+    runtime: claude-main
+    options:
+      maxTurns: 10
 ```
 
+In this example, the `review` thread runs with `model`, `permissionMode`, and
+`maxTurns`; if both levels define the same option, the thread-level value wins.
+
 Put private provider credentials in `secret.yaml` and pass it after the base
 config so it can override sensitive fields locally.
 
 ## Library usage
 
 ```ts
-import { createRuntime, loadConfig, startThread } from "coding-agent-forge";
+import { loadConfig } from "coding-agent-forge";
+import { Agent } from "coding-agent-forge/agent";
+import { createRuntime, startThread } from "coding-agent-forge/runtime";
+
+type ReviewVariables = {
+  task: string;
+  focus: string;
+};
+
+type ReviewConstants = {
+  language: string;
+  prefix: string;
+};
+
+class ReviewAgent extends Agent<ReviewVariables, ReviewConstants> {
+  protected buildPrompt(
+    variables: Readonly<ReviewVariables>,
+    constants: Readonly<ReviewConstants>,
+  ): string {
+    return `${constants.prefix}\nLanguage: ${constants.language}\n${variables.task}\n\nFocus: ${variables.focus}`;
+  }
+}
 
 const config = await loadConfig("agent-forge.yaml");
 const threadDefinition = config.threads.runner;
+if (!threadDefinition) {
+  throw new Error("Unknown thread: runner");
+}
 const runtimeDefinition = config.runtimes[threadDefinition.runtime];
+if (!runtimeDefinition) {
+  throw new Error(`Unknown runtime: ${threadDefinition.runtime}`);
+}
 const runtime = createRuntime(runtimeDefinition);
-const thread = await startThread(runtime, threadDefinition);
+const thread = await startThread(runtime, threadDefinition.options);
+const agent = new ReviewAgent(thread, {
+  language: "Chinese",
+  prefix: "Review this task.",
+});
 
-const finalResponse = await thread.runStreamed("Inspect this repo.", (event) => {
-  console.log(event);
+const finalResponse = await agent.runStreamed({
+  task: "Inspect this repo.",
+  focus: "Public APIs.",
 });
 
 console.log(finalResponse);
 await runtime.close();
 ```
 
+Custom agents extend `Agent` and implement `buildPrompt`. Per-call `variables`
+and constructor-time `constants` are both string-valued objects, but they represent
+different data and are typed separately.
+
+`AgentVariablesByName` is a caller-provided type witness for the variables each
+registered agent accepts. Keep it aligned with the factories you register and
+the agents in your config.
+
+`PromptTemplateAgent` is the default agent implementation. It expects a
+`template` constant and formats `{{ variable }}` placeholders using constants
+merged with the variables passed to `runStreamed`. Per-call variables override
+same-named constants.
+
+`AgentTeam` receives an `AgentFactoryMap` keyed by agent `kind`. Each factory gets
+the agent name, thread, and constants, then decides which concrete `Agent` to
+return. Validate constants inside the factory when an agent requires specific
+constant keys.
+
+For TypeScript-authored configuration, use `defineConfig` to keep thread options
+bound to the runtime kind selected by each named runtime. Agent thread names are
+checked against the configured threads.
+
+```ts
+import { defineConfig } from "coding-agent-forge";
+
+export default defineConfig({
+  runtimes: {
+    runner: { kind: "codex" },
+  },
+  threads: {
+    main: {
+      runtime: "runner",
+      options: { model: "gpt-5.3-codex" },
+    },
+  },
+  agents: {
+    reviewer: {
+      kind: "prompt-template",
+      thread: "main",
+      constants: {
+        template: "Review this task in {{ language }}.\n\n{{ prompt }}",
+        language: "Chinese",
+      },
+    },
+  },
+});
+```
+
 ## CLI
 
 ```bash
-npm run dev -- --config agent-forge.yaml --config secret.yaml --thread codex-runner "Inspect this repo" "What did you just do? Is this a new conversation?"
+npm run dev -- --config agent-forge.yaml --config secret.yaml --agent codex-agent "{ prompt: Inspect this repo }" "{ prompt: What did you just do? Is this a new conversation? }"
 ```
 
 Pass multiple `--config` files to merge them in order; object fields in later
-files are merged into earlier files. Omit `--thread` to run the first thread in
-the merged config. Pass multiple quoted prompts to run a multi-turn conversation
-on the same thread.
+files are merged into earlier files. Omit `--agent` to run the first agent in
+the merged config. Each positional argument is parsed as a YAML object whose
+values must be strings. Pass multiple YAML objects to run multiple turns on the
+same agent thread.
 
-The CLI prints one JSON event per line, followed by the final response text for
-each prompt.
+The CLI prints runtime records to stderr and writes each final response to
+stdout.

package/agent-forge.yaml

@@ -50,3 +50,22 @@ threads:
         OPENAI_BASE_URL: https://api.deepseek.com
         OPENAI_MODEL: deepseek-reasoner
         OPENAI_REASONING_EFFORT: high
+
+agents:
+  codex-agent:
+    kind: prompt-template
+    thread: codex-runner
+    constants:
+      template: "{{ prompt }}"
+
+  opencode-agent:
+    kind: prompt-template
+    thread: opencode-runner
+    constants:
+      template: "{{ prompt }}"
+
+  qwen-agent:
+    kind: prompt-template
+    thread: qwen-runner
+    constants:
+      template: "{{ prompt }}"

package/dist/agent/agent.d.ts

@@ -0,0 +1,11 @@
+import type { RecordCallback, Thread } from "../runtime/index.js";
+export type PromptConstants = Record<string, string>;
+export type PromptVariables = Record<string, string>;
+export declare abstract class Agent<Variables extends PromptVariables = PromptVariables, Constants extends PromptConstants = PromptConstants> {
+    #private;
+    protected readonly thread: Thread;
+    constructor(thread: Thread, constants: Readonly<Constants>);
+    protected abstract buildPrompt(variables: Readonly<Variables>, constants: Readonly<Constants>): string;
+    runStreamed(variables: Variables, onRecord?: RecordCallback): Promise<string>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,8BAAsB,KAAK,CACzB,SAAS,SAAS,eAAe,GAAG,eAAe,EACnD,SAAS,SAAS,eAAe,GAAG,eAAe;;IAKjD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACjC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;IAKhC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAC5B,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC9B,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,GAC7B,MAAM;IAET,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAI9E"}

package/dist/agent/agent.js

@@ -0,0 +1,13 @@
+export class Agent {
+    thread;
+    #constants;
+    constructor(thread, constants) {
+        this.thread = thread;
+        this.#constants = Object.freeze({ ...constants });
+    }
+    runStreamed(variables, onRecord) {
+        const prompt = this.buildPrompt(variables, this.#constants);
+        return this.thread.runStreamed(prompt, onRecord);
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAKA,MAAM,OAAgB,KAAK;IAOJ;IAHZ,UAAU,CAAsB;IAEzC,YACqB,MAAc,EACjC,SAA8B;QADX,WAAM,GAAN,MAAM,CAAQ;QAGjC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IACpD,CAAC;IAOD,WAAW,CAAC,SAAoB,EAAE,QAAyB;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/agent/config.d.ts

@@ -0,0 +1,15 @@
+import type { RuntimeDefinitions, RuntimeThreadConfig, ThreadDefinitions } from "../runtime/config.js";
+import { type PlainObject } from "../utils/object.js";
+import type { PromptConstants } from "./agent.js";
+export type AgentDefinition<Constants extends PromptConstants = PromptConstants, ThreadName extends string = string, Kind extends string = string> = {
+    kind: Kind;
+    thread: ThreadName;
+    constants?: Constants;
+};
+export type AgentDefinitions<ThreadName extends string = string> = Record<string, AgentDefinition<PromptConstants, ThreadName>>;
+export declare function loadAgentDefinitions(value: object, threads: Record<string, unknown>): AgentDefinitions;
+export type RuntimeThreadAgentConfig<Runtimes extends RuntimeDefinitions = RuntimeDefinitions, Threads extends ThreadDefinitions<Runtimes> = ThreadDefinitions<Runtimes>, Agents extends AgentDefinitions<keyof Threads & string> = AgentDefinitions<keyof Threads & string>> = RuntimeThreadConfig<Runtimes, Threads> & {
+    agents: Agents;
+};
+export declare function loadRuntimeThreadAgentConfig(config: PlainObject): RuntimeThreadAgentConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/agent/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agent/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,eAAe,CACzB,SAAS,SAAS,eAAe,GAAG,eAAe,EACnD,UAAU,SAAS,MAAM,GAAG,MAAM,EAClC,IAAI,SAAS,MAAM,GAAG,MAAM,IAC1B;IACF,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CACvE,MAAM,EACN,eAAe,CAAC,eAAe,EAAE,UAAU,CAAC,CAC7C,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,gBAAgB,CA0ClB;AAED,MAAM,MAAM,wBAAwB,CAClC,QAAQ,SAAS,kBAAkB,GAAG,kBAAkB,EACxD,OAAO,SAAS,iBAAiB,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CAAC,QAAQ,CAAC,EACzE,MAAM,SAAS,gBAAgB,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,gBAAgB,CACxE,MAAM,OAAO,GAAG,MAAM,CACvB,IACC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,WAAW,GAAG,wBAAwB,CAS1F"}

package/dist/agent/config.js

@@ -0,0 +1,49 @@
+import { loadRuntimeThreadConfig } from "../runtime/config.js";
+import { isPlainObject } from "../utils/object.js";
+export function loadAgentDefinitions(value, threads) {
+    if (Object.keys(value).length === 0) {
+        throw new Error("Config must define at least one agent");
+    }
+    const agents = {};
+    for (const [name, agent] of Object.entries(value)) {
+        if (!isPlainObject(agent)) {
+            throw new Error(`Agent ${name} must be an object`);
+        }
+        if (typeof agent.kind !== "string") {
+            throw new Error(`Agent ${name} must define a kind`);
+        }
+        if (typeof agent.thread !== "string") {
+            throw new Error(`Agent ${name} must define a thread`);
+        }
+        if (!Object.hasOwn(threads, agent.thread)) {
+            throw new Error(`Unknown thread for agent ${name}: ${agent.thread}`);
+        }
+        let constants;
+        if (agent.constants !== undefined) {
+            if (!isPlainObject(agent.constants)) {
+                throw new Error(`Agent ${name} constants must be an object`);
+            }
+            constants = {};
+            for (const [entryKey, entryValue] of Object.entries(agent.constants)) {
+                if (typeof entryValue !== "string") {
+                    throw new Error(`Agent ${name} constants.${entryKey} must be a string`);
+                }
+                constants[entryKey] = entryValue;
+            }
+        }
+        agents[name] =
+            constants === undefined
+                ? { kind: agent.kind, thread: agent.thread }
+                : { kind: agent.kind, thread: agent.thread, constants };
+    }
+    return agents;
+}
+export function loadRuntimeThreadAgentConfig(config) {
+    if (!isPlainObject(config.agents)) {
+        throw new Error("Config must define an agents object");
+    }
+    const { runtimes, threads } = loadRuntimeThreadConfig(config);
+    const agents = loadAgentDefinitions(config.agents, threads);
+    return { runtimes, threads, agents };
+}
+//# sourceMappingURL=config.js.map

package/dist/agent/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/agent/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAoB,MAAM,oBAAoB,CAAC;AAkBrE,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,OAAgC;IAEhC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,oBAAoB,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,qBAAqB,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,uBAAuB,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,SAAsC,CAAC;QAC3C,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,8BAA8B,CAAC,CAAC;YAC/D,CAAC;YAED,SAAS,GAAG,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,cAAc,QAAQ,mBAAmB,CAAC,CAAC;gBAC1E,CAAC;gBACD,SAAS,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;YACnC,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,KAAK,SAAS;gBACrB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;gBAC5C,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAC9D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAYD,MAAM,UAAU,4BAA4B,CAAC,MAAmB;IAC9D,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC"}

package/dist/agent/factories.d.ts

@@ -0,0 +1,5 @@
+import { PromptTemplateAgent } from "./template.js";
+export declare const defaultAgentFactories: {
+    "prompt-template": (name: string, thread: import("../index.js").Thread<keyof import("../index.js").RuntimeSpec>, constants: Readonly<import("./agent.js").PromptConstants>) => PromptTemplateAgent<import("./agent.js").PromptVariables>;
+};
+//# sourceMappingURL=factories.d.ts.map

package/dist/agent/factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../src/agent/factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,eAAO,MAAM,qBAAqB;;CAEP,CAAC"}

package/dist/agent/factories.js

@@ -0,0 +1,5 @@
+import { PromptTemplateAgent } from "./template.js";
+export const defaultAgentFactories = {
+    "prompt-template": (name, thread, constants) => new PromptTemplateAgent(name, thread, constants),
+};
+//# sourceMappingURL=factories.js.map

package/dist/agent/factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.js","sourceRoot":"","sources":["../../src/agent/factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC;CACvE,CAAC"}

package/dist/agent/index.d.ts

@@ -0,0 +1,10 @@
+export { Agent } from "./agent.js";
+export type { PromptVariables, PromptConstants } from "./agent.js";
+export type { AgentDefinition, AgentDefinitions, RuntimeThreadAgentConfig } from "./config.js";
+export { loadAgentDefinitions, loadRuntimeThreadAgentConfig } from "./config.js";
+export { AgentTeam } from "./team.js";
+export type { AgentFactory, AgentFactoryMap, AgentVariablesByName } from "./team.js";
+export { PromptTemplateAgent, formatPromptTemplate } from "./template.js";
+export type { PromptTemplateConstants } from "./template.js";
+export { defaultAgentFactories } from "./factories.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,6 @@
+export { Agent } from "./agent.js";
+export { loadAgentDefinitions, loadRuntimeThreadAgentConfig } from "./config.js";
+export { AgentTeam } from "./team.js";
+export { PromptTemplateAgent, formatPromptTemplate } from "./template.js";
+export { defaultAgentFactories } from "./factories.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/agent/team.d.ts

@@ -0,0 +1,19 @@
+import type { RecordCallback, Thread } from "../runtime/index.js";
+import type { Agent, PromptConstants, PromptVariables } from "./agent.js";
+import type { RuntimeThreadAgentConfig } from "./config.js";
+export type AgentFactory = (name: string, thread: Thread, constants: Readonly<PromptConstants>) => Agent;
+export type AgentFactoryMap = Record<string, AgentFactory>;
+export type AgentVariablesByName = Record<string, PromptVariables>;
+export declare class AgentTeam<VariablesByName extends AgentVariablesByName = AgentVariablesByName> {
+    #private;
+    private readonly config;
+    private readonly factories;
+    constructor(config: RuntimeThreadAgentConfig, factories: AgentFactoryMap);
+    private getRuntime;
+    private getThread;
+    private createAgent;
+    getAgent<Name extends keyof VariablesByName & string>(name: Name): Promise<Agent<VariablesByName[Name]>>;
+    runStreamed<Name extends keyof VariablesByName & string>(name: Name, variables: VariablesByName[Name], onRecord?: RecordCallback): Promise<string>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=team.d.ts.map

package/dist/agent/team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../src/agent/team.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,QAAQ,CAAC,eAAe,CAAC,KACjC,KAAK,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAE3D,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEnE,qBAAa,SAAS,CAAC,eAAe,SAAS,oBAAoB,GAAG,oBAAoB;;IAMtF,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,MAAM,EAAE,wBAAwB,EAChC,SAAS,EAAE,eAAe;IAG7C,OAAO,CAAC,UAAU;YAgBJ,SAAS;YAoBT,WAAW;IAenB,QAAQ,CAAC,IAAI,SAAS,MAAM,eAAe,GAAG,MAAM,EACxD,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAiBlC,WAAW,CAAC,IAAI,SAAS,MAAM,eAAe,GAAG,MAAM,EAC3D,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC,EAChC,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,MAAM,CAAC;IAKZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/dist/agent/team.js

@@ -0,0 +1,81 @@
+import { createRuntime, startThread } from "../runtime/config.js";
+export class AgentTeam {
+    config;
+    factories;
+    #agents = new Map();
+    #runtimes = new Map();
+    #threads = new Map();
+    constructor(config, factories) {
+        this.config = config;
+        this.factories = factories;
+    }
+    getRuntime(name) {
+        const cachedRuntime = this.#runtimes.get(name);
+        if (cachedRuntime) {
+            return cachedRuntime;
+        }
+        const runtimeDefinition = this.config.runtimes[name];
+        if (!runtimeDefinition) {
+            throw new Error(`Unknown runtime: ${name}`);
+        }
+        const runtime = createRuntime(runtimeDefinition);
+        this.#runtimes.set(name, runtime);
+        return runtime;
+    }
+    async getThread(name) {
+        const cachedThread = this.#threads.get(name);
+        if (cachedThread) {
+            return await cachedThread;
+        }
+        const threadDefinition = this.config.threads[name];
+        if (!threadDefinition) {
+            throw new Error(`Unknown thread: ${name}`);
+        }
+        const runtime = this.getRuntime(threadDefinition.runtime);
+        const thread = startThread(runtime, threadDefinition.options).catch((error) => {
+            this.#threads.delete(name);
+            throw error;
+        });
+        this.#threads.set(name, thread);
+        return await thread;
+    }
+    async createAgent(name) {
+        const agentDefinition = this.config.agents[name];
+        if (!agentDefinition) {
+            throw new Error(`Unknown agent: ${name}`);
+        }
+        const constants = agentDefinition.constants ?? {};
+        const factory = this.factories[agentDefinition.kind];
+        if (!factory) {
+            throw new Error(`Unknown agent kind for ${name}: ${agentDefinition.kind}`);
+        }
+        return factory(name, await this.getThread(agentDefinition.thread), constants);
+    }
+    async getAgent(name) {
+        // VariablesByName is a caller-provided type witness; factories are validated at runtime only by name.
+        const cachedAgent = this.#agents.get(name);
+        if (cachedAgent) {
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion -- Keep the caller-provided variable type visible at the boundary.
+            return (await cachedAgent);
+        }
+        const agent = this.createAgent(name).catch((error) => {
+            this.#agents.delete(name);
+            throw error;
+        });
+        this.#agents.set(name, agent);
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion -- Keep the caller-provided variable type visible at the boundary.
+        return (await agent);
+    }
+    async runStreamed(name, variables, onRecord) {
+        const agent = await this.getAgent(name);
+        return await agent.runStreamed(variables, onRecord);
+    }
+    async close() {
+        const runtimes = [...this.#runtimes.values()];
+        this.#agents.clear();
+        this.#threads.clear();
+        this.#runtimes.clear();
+        await Promise.all(runtimes.map((runtime) => runtime.close()));
+    }
+}
+//# sourceMappingURL=team.js.map

package/dist/agent/team.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.js","sourceRoot":"","sources":["../../src/agent/team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAelE,MAAM,OAAO,SAAS;IAMD;IACA;IANV,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IACvC,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEvD,YACmB,MAAgC,EAChC,SAA0B;QAD1B,WAAM,GAAN,MAAM,CAA0B;QAChC,cAAS,GAAT,SAAS,CAAiB;IAC1C,CAAC;IAEI,UAAU,CAAC,IAAY;QAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,IAAY;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,MAAM,YAAY,CAAC;QAC5B,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACrF,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,MAAM,MAAM,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAY;QACpC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,SAAS,GAAoB,eAAe,CAAC,SAAS,IAAI,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAU;QAEV,sGAAsG;QACtG,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,WAAW,EAAE,CAAC;YAChB,+IAA+I;YAC/I,OAAO,CAAC,MAAM,WAAW,CAAiC,CAAC;QAC7D,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC5D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,+IAA+I;QAC/I,OAAO,CAAC,MAAM,KAAK,CAAiC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CACf,IAAU,EACV,SAAgC,EAChC,QAAyB;QAEzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,MAAM,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAEvB,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/agent/template.d.ts

@@ -0,0 +1,12 @@
+import type { Thread } from "../runtime/index.js";
+import { Agent, type PromptConstants, type PromptVariables } from "./agent.js";
+export type PromptTemplateConstants = PromptConstants & {
+    template: string;
+};
+export declare function formatPromptTemplate(template: string, variables: Readonly<PromptVariables>): string;
+export declare function mergePromptTemplateVariables(constants: Readonly<PromptTemplateConstants>, variables: Readonly<PromptVariables>, exceptConstants?: readonly string[]): PromptVariables;
+export declare class PromptTemplateAgent<Variables extends PromptVariables = PromptVariables> extends Agent<Variables, PromptTemplateConstants> {
+    constructor(agentName: string, thread: Thread, constants: Readonly<PromptConstants>);
+    protected buildPrompt(variables: Readonly<Variables>, constants: Readonly<PromptTemplateConstants>): string;
+}
+//# sourceMappingURL=template.d.ts.map

package/dist/agent/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/agent/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,QAAQ,CAAC,eAAe,CAAC,GACnC,MAAM,CAeR;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAC5C,SAAS,EAAE,QAAQ,CAAC,eAAe,CAAC,EACpC,eAAe,GAAE,SAAS,MAAM,EAAO,GACtC,eAAe,CASjB;AAED,qBAAa,mBAAmB,CAAC,SAAS,SAAS,eAAe,GAAG,eAAe,CAAE,SAAQ,KAAK,CACjG,SAAS,EACT,uBAAuB,CACxB;gBACa,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,eAAe,CAAC;IASnF,SAAS,CAAC,WAAW,CACnB,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC9B,SAAS,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAC3C,MAAM;CAMV"}

package/dist/agent/template.js

@@ -0,0 +1,37 @@
+import { Agent } from "./agent.js";
+export function formatPromptTemplate(template, variables) {
+    let prompt = template;
+    for (const [name, value] of Object.entries(variables)) {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+            throw new Error(`Invalid prompt template variable name: ${name}`);
+        }
+        prompt = prompt.replace(new RegExp(`\\{\\{\\s*${name}\\s*\\}\\}`, "g"), () => value);
+    }
+    const remainingPlaceholder = /\{\{\s*[^{}]*\S[^{}]*\s*\}\}/.exec(prompt);
+    if (remainingPlaceholder) {
+        throw new Error(`Missing prompt template variable: ${remainingPlaceholder[0]}`);
+    }
+    return prompt;
+}
+export function mergePromptTemplateVariables(constants, variables, exceptConstants = []) {
+    const constantVariables = {};
+    for (const [key, value] of Object.entries(constants)) {
+        if (!exceptConstants.includes(key)) {
+            constantVariables[key] = value;
+        }
+    }
+    return { ...constantVariables, ...variables };
+}
+export class PromptTemplateAgent extends Agent {
+    constructor(agentName, thread, constants) {
+        const template = constants.template;
+        if (template === undefined) {
+            throw new Error(`Agent ${agentName} constants must define template`);
+        }
+        super(thread, { ...constants, template });
+    }
+    buildPrompt(variables, constants) {
+        return formatPromptTemplate(constants.template, mergePromptTemplateVariables(constants, variables, ["template"]));
+    }
+}
+//# sourceMappingURL=template.js.map

package/dist/agent/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/agent/template.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAA8C,MAAM,YAAY,CAAC;AAM/E,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,SAAoC;IAEpC,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,aAAa,IAAI,YAAY,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,oBAAoB,GAAG,8BAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,IAAI,oBAAoB,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,SAA4C,EAC5C,SAAoC,EACpC,kBAAqC,EAAE;IAEvC,MAAM,iBAAiB,GAAoB,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,iBAAiB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,iBAAiB,EAAE,GAAG,SAAS,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,OAAO,mBAAyE,SAAQ,KAG7F;IACC,YAAY,SAAiB,EAAE,MAAc,EAAE,SAAoC;QACjF,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,SAAS,SAAS,iCAAiC,CAAC,CAAC;QACvE,CAAC;QAED,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAES,WAAW,CACnB,SAA8B,EAC9B,SAA4C;QAE5C,OAAO,oBAAoB,CACzB,SAAS,CAAC,QAAQ,EAClB,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CACjE,CAAC;IACJ,CAAC;CACF"}

package/dist/cli.js

@@ -1,39 +1,53 @@
 #!/usr/bin/env node
 import { parseArgs } from "node:util";
-import { createRuntime, loadConfig, startThread } from "./index.js";
-const { values, positionals: prompts } = parseArgs({
+import { parse } from "yaml";
+import { AgentTeam, defaultAgentFactories } from "./agent/index.js";
+import { loadConfig } from "./config.js";
+import { isPlainObject } from "./utils/object.js";
+function parseVariables(entry) {
+    const value = parse(entry);
+    if (!isPlainObject(value)) {
+        throw new Error("Variables must be a YAML object");
+    }
+    const variables = {};
+    for (const [key, entryValue] of Object.entries(value)) {
+        if (typeof entryValue !== "string") {
+            throw new Error(`Variable ${key} must be a string`);
+        }
+        variables[key] = entryValue;
+    }
+    return variables;
+}
+const { values, positionals: variableGroups } = parseArgs({
     args: process.argv.slice(2),
     options: {
         config: { type: "string", multiple: true },
-        thread: { type: "string" },
+        agent: { type: "string" },
     },
     allowPositionals: true,
 });
-const configPaths = values.config ?? [];
-if (prompts.length === 0) {
-    console.error('Usage: agent-forge --config base.yaml [--config override.yaml] [--thread runner] "prompt" ["follow up"]');
+const configPaths = values.config && values.config.length > 0 ? values.config : ["agent-forge.yaml"];
+if (variableGroups.length === 0) {
+    console.error('Usage: agent-forge --config base.yaml [--config override.yaml] [--agent reviewer] "{ prompt: Inspect this repo }" "{ prompt: What did you just do? Is this a new conversation? }"');
     process.exit(1);
 }
-const config = await loadConfig(...(configPaths.length > 0 ? configPaths : ["agent-forge.yaml"]));
-const [defaultThreadName = ""] = Object.keys(config.threads);
-const threadName = values.thread ?? defaultThreadName;
-const threadDefinition = config.threads[threadName];
-if (!threadDefinition) {
-    throw new Error(`Unknown thread: ${threadName}`);
-}
-const runtimeDefinition = config.runtimes[threadDefinition.runtime];
-if (!runtimeDefinition) {
-    throw new Error(`Unknown runtime for thread ${threadName}: ${threadDefinition.runtime}`);
+const config = await loadConfig(...configPaths);
+const [defaultAgentName = ""] = Object.keys(config.agents);
+const agentName = values.agent ?? defaultAgentName;
+if (!config.agents[agentName]) {
+    throw new Error(`Unknown agent: ${agentName}`);
 }
-const runtime = createRuntime(runtimeDefinition);
+const team = new AgentTeam(config, defaultAgentFactories);
 try {
-    const thread = await startThread(runtime, threadDefinition);
-    for (const prompt of prompts) {
-        const response = await thread.runStreamed(prompt);
+    const logRecord = (thread, record) => {
+        process.stderr.write(`${thread.recordToPrettyString(record)}\n`);
+    };
+    for (const variableGroup of variableGroups) {
+        const response = await team.runStreamed(agentName, parseVariables(variableGroup), logRecord);
         process.stdout.write(`${response}\n`);
     }
 }
 finally {
-    await runtime.close();
+    await team.close();
 }
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IACjD,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE;QACP,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC3B;IACD,gBAAgB,EAAE,IAAI;CACvB,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;AAExC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,CACX,yGAAyG,CAC1G,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAClG,MAAM,CAAC,iBAAiB,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,IAAI,iBAAiB,CAAC;AAEtD,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACpD,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACtB,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACpE,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACvB,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,OAAO,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAEjD,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAE5D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;QAAS,CAAC;IACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}