agency-lang 0.7.0 → 0.7.2

package/dist/lib/runtime/runner.js

@@ -486,7 +486,15 @@ export class Runner {
         return result;
     }
     // ── Specialized: thread ──
-    async thread(id, method, opts, callback) {
+    async thread(id, method, 
+    // Codegen emits opts as a thunk (`async () => (<opts>)`) so its value
+    // expressions are evaluated ONLY after the halt/skip guards below. If a
+    // preceding `return` halted the runner, the steps that assign the locals
+    // those expressions reference are skipped, so evaluating them eagerly here
+    // would dereference an unset local and throw. Evaluating lazily lets the
+    // early return win. A bare object is still accepted for direct runtime
+    // callers (tests); only a function means "thunk".
+    optsArg, callback) {
         // Single canonical signature; `prettyPrint.ts` always emits an
         // opts object (possibly empty) so there is no dual-form path to
         // support. Test harnesses pass `{}` explicitly when they don't
@@ -498,6 +506,7 @@ export class Runner {
             return;
         if (await this.maybeDebugHook(id))
             return;
+        const opts = typeof optsArg === "function" ? await optsArg() : optsArg;
         this.ctx.coverageCollector?.hit(this.moduleId, this.scopeName, this.stepPath(id));
         // Post-ALS migration the ThreadStore is captured on `this.threads`
         // (seeded by the constructor from explicit opts or the active
@@ -736,7 +745,16 @@ export class Runner {
         }
     }
     // ── Specialized: loop (for) ──
-    async loop(id, items, 
+    async loop(id, 
+    // The iterable is a thunk (codegen emits `async () => <expr>`) so its
+    // expression is evaluated ONLY after the halt/skip guards below. If a
+    // preceding `return` halted the runner, the steps that would assign the
+    // iterable's backing locals are skipped, so eagerly evaluating the
+    // expression here would dereference an unset local and throw. Evaluating
+    // lazily lets the early return win. A bare value is still accepted for
+    // direct runtime callers (tests); only a function means "thunk", since an
+    // iterable can never legitimately be a function.
+    items, 
     // Second arg is the numeric index for arrays, or the value for records.
     callback) {
         if (this.shouldSkip())
@@ -746,6 +764,7 @@ export class Runner {
         if (await this.maybeDebugHook(id))
             return;
         this.ctx.coverageCollector?.hit(this.moduleId, this.scopeName, this.stepPath(id));
+        const items_ = typeof items === "function" ? await items() : items;
         const iterKey = this.path.length === 0
             ? `__iteration_${id}`
             : `__iteration_${this.key()}.${id}`;
@@ -756,11 +775,11 @@ export class Runner {
         // simply do nothing rather than crash mid-flow.
         let iterable;
         let isRecord = false;
-        if (Array.isArray(items)) {
-            iterable = items;
+        if (Array.isArray(items_)) {
+            iterable = items_;
         }
-        else if (items != null && typeof items === "object") {
-            iterable = Object.keys(items);
+        else if (items_ != null && typeof items_ === "object") {
+            iterable = Object.keys(items_);
             isRecord = true;
         }
         else {
@@ -780,7 +799,7 @@ export class Runner {
                 // numeric index; for records it is the value at the current key. The
                 // first callback arg is the element (array) or the key (record).
                 const item = iterable[i];
-                const second = isRecord ? items[item] : i;
+                const second = isRecord ? items_[item] : i;
                 await this.runInScope(() => callback(item, second, this));
             }
             finally {

package/dist/lib/runtime/state/context.js

@@ -14,7 +14,8 @@ import { getOrCreateStore } from "../memory/registry.js";
 import { GlobalStore } from "../state/globalStore.js";
 import { StateStack } from "../state/stateStack.js";
 import { TraceWriter } from "../trace/traceWriter.js";
-import { applyRuntimeConfigOverridesToContextArgs } from "../configOverrides.js";
+import { applyRuntimeConfigOverridesToContextArgs, getRuntimeConfigOverrides, } from "../configOverrides.js";
+import { readConfigOverrides } from "../../config.js";
 import { CheckpointStore, RESULT_ENTRY_LABEL } from "./checkpointStore.js";
 import { PendingPromiseStore } from "./pendingPromiseStore.js";
 /**
@@ -161,7 +162,13 @@ export class RuntimeContext {
     jsonMemoryConfig;
     memoryManagerCache = {};
     constructor(args) {
-        args = applyRuntimeConfigOverridesToContextArgs(args);
+        // One runtime merge, applied for BOTH transports so a subprocess launched
+        // with explicit IPC overrides still inherits the env override (e.g. a
+        // tree-wide --log-file). Env first, then IPC on top: IPC (explicit,
+        // per-child) wins per field, env fills the rest. Sequential application
+        // also layers nested `log`/`trace` objects rather than clobbering them.
+        args = applyRuntimeConfigOverridesToContextArgs(args, readConfigOverrides());
+        args = applyRuntimeConfigOverridesToContextArgs(args, getRuntimeConfigOverrides());
         const statelogConfig = {
             ...args.statelogConfig,
             traceId: args.statelogConfig.traceId || nanoid(),

package/dist/lib/stdlib/llm.d.ts

@@ -17,6 +17,7 @@ export type LlmDefaults = RetryConfig & {
     reasoningEffort?: "low" | "medium" | "high";
     maxTokens?: number;
     maxToolResultChars?: number;
+    maxToolCallRounds?: number;
 };
 /**
  * Merge `opts` into the ACTIVE branch stack's LLM defaults

package/dist/lib/stdlib/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.7.0";
+export declare const VERSION = "0.7.2";

package/dist/lib/stdlib/version.js

@@ -1 +1 @@
-export const VERSION = "0.7.0";
+export const VERSION = "0.7.2";

package/dist/scripts/agency.d.ts

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 import { Command } from "commander";
+export declare function parsePositiveInt(value: string): number;
+export declare function parseNonNegativeInt(value: string): number;
 type CliDependencies = {
     loadLspStartServer?: () => Promise<() => void>;
     loadMcpStartServer?: () => Promise<() => void>;

package/dist/scripts/agency.js

@@ -11,13 +11,14 @@ import { evalExtract } from "../lib/cli/evalExtract.js";
 import { evalJudge } from "../lib/cli/evalJudge.js";
 import { evalRun } from "../lib/cli/eval/run.js";
 import { evalOptimize } from "../lib/cli/eval/optimize.js";
+import { applyCliFlags, redactConfigSecrets, } from "../lib/config.js";
 import * as path from "path";
 import { _parseAgency } from "../lib/parser.js";
 import { TypescriptPreprocessor } from "../lib/preprocessors/typescriptPreprocessor.js";
 import { buildCompilationUnit } from "../lib/compilationUnit.js";
 import { SymbolTable } from "../lib/symbolTable.js";
 import { formatErrors, typeCheck } from "../lib/typeChecker/index.js";
-import { Command } from "commander";
+import { Command, InvalidArgumentError } from "commander";
 import * as fs from "fs";
 import { color } from "../lib/utils/termcolors.js";
 import { TarsecError } from "tarsec";
@@ -42,6 +43,26 @@ import { startServer } from "../lib/lsp/index.js";
 import { startMcpServer } from "../lib/mcp/server.js";
 import { pathToFileURL } from "url";
 import { serveMcp, serveHttp } from "../lib/cli/serve.js";
+// commander option parsers. Match the WHOLE string against digits so
+// `parseInt`'s silent truncation ("1.5"→1, "3abc"→3, "0x10"→16) can't sneak an
+// invalid value through as a usable number.
+function parseBoundedInt(value, min, label) {
+    if (!/^\d+$/.test(value)) {
+        throw new InvalidArgumentError(label);
+    }
+    const n = parseInt(value, 10);
+    if (n < min) {
+        throw new InvalidArgumentError(label);
+    }
+    return n;
+}
+export function parsePositiveInt(value) {
+    return parseBoundedInt(value, 1, "must be a positive integer");
+}
+// 0 allowed (e.g. to disable a cap).
+export function parseNonNegativeInt(value) {
+    return parseBoundedInt(value, 0, "must be a non-negative integer");
+}
 function defaultResolveMcpCommand() {
     return ["agency", "mcp"];
 }
@@ -71,14 +92,7 @@ export function createProgram(deps = {}) {
         return config;
     }
     function runWithOptions(input, options) {
-        const config = getConfig();
-        if (options.trace) {
-            config.trace = true;
-            config.traceFile =
-                typeof options.trace === "string"
-                    ? options.trace
-                    : input.replace(/\.agency$/, ".trace");
-        }
+        const config = applyCliFlags(getConfig(), options, input);
         run(config, input, undefined, options.resume);
     }
     program
@@ -88,8 +102,15 @@ export function createProgram(deps = {}) {
         .argument("<inputs...>", "Paths to .agency input files or directories")
         .option("--ts", "Output .ts files with // @no-check header")
         .option("-w, --watch", "Watch for changes and recompile")
+        .option("--strict", "Fail on any fatal type error (typechecker.strict)")
+        .option("--max-tool-call-rounds <n>", "Max LLM tool-call rounds before halting a tool loop (default 10; overrides agency.json)", parsePositiveInt)
+        .option("--max-tool-result-chars <n>", "Max chars of a single tool result fed back to the model (0 disables; default 100000; overrides agency.json)", parseNonNegativeInt)
         .action(async (inputs, opts) => {
-        const config = getConfig();
+        const config = applyCliFlags(getConfig(), {
+            strict: opts.strict,
+            maxToolCallRounds: opts.maxToolCallRounds,
+            maxToolResultChars: opts.maxToolResultChars,
+        });
         if (opts.watch) {
             const close = await watchAndCompile(config, inputs, { ts: opts.ts });
             process.once("SIGINT", async () => {
@@ -121,7 +142,12 @@ export function createProgram(deps = {}) {
     function addRunOptions(cmd) {
         return cmd
             .option("--resume <statefile>", "Resume execution from a saved state file")
-            .option("--trace [file]", "Write execution trace to file (default: <input>.trace)");
+            .option("--trace [file]", "Write execution trace to file (default: <input>.trace)")
+            .option("--log-file <path>", "Append statelog events (one JSON object per line) to this file for this run")
+            .option("--observability", "Enable statelog observability for this run (use with a configured host, or --log-file)")
+            .option("--strict", "Fail the run on any fatal type error (typechecker.strict)")
+            .option("--max-tool-call-rounds <n>", "Max LLM tool-call rounds before halting a tool loop (default 10; overrides agency.json)", parsePositiveInt)
+            .option("--max-tool-result-chars <n>", "Max chars of a single tool result fed back to the model (0 disables; default 100000; overrides agency.json)", parseNonNegativeInt);
     }
     addRunOptions(program
         .command("run")
@@ -674,9 +700,26 @@ export function createProgram(deps = {}) {
         .description("Diagnose problems with an Agency file using the agency agent")
         .argument("<file>", "Path to the .agency file to diagnose")
         .option("--symptom <text>", "Optional description of the problem you are seeing")
+        .option("--trace [file]", "Write an execution trace of the diagnosis to this file")
+        .option("--log-file <path>", "Append statelog events from the diagnosis to this file")
         .action((file, opts) => {
         const config = getConfig();
-        doctor(config, file, opts);
+        doctor(config, file, {
+            symptom: opts.symptom,
+            trace: opts.trace,
+            logFile: opts.logFile,
+        });
+    });
+    const configCmd = program
+        .command("config")
+        .description("Inspect Agency configuration");
+    configCmd
+        .command("show")
+        .description("Print the resolved, merged agency.json config as JSON")
+        .option("--show-secrets", "Print API keys verbatim instead of masking them (avoid in shared logs / bug reports)")
+        .action((opts) => {
+        const config = getConfig();
+        console.log(JSON.stringify(opts.showSecrets ? config : redactConfigSecrets(config), null, 2));
     });
     program
         .command("review", { hidden: true })

package/dist/scripts/agency.test.js

@@ -2,7 +2,20 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import * as fs from "fs";
 import * as os from "os";
 import * as path from "path";
-import { createProgram, runCli } from "./agency.js";
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { createProgram, parseNonNegativeInt, parsePositiveInt, runCli, } from "./agency.js";
+const execFileAsync = promisify(execFile);
+// The CLI integration tests below shell out to the built dist/ to observe real
+// process exit codes (compile calls process.exit, which would kill the vitest
+// worker if run in-process). They are SKIPPED (with a visible reason) when dist
+// isn't built, so `pnpm test` stays green on a clean checkout; they run in CI
+// and after `make` / `pnpm run build`.
+const CLI = path.resolve("dist/scripts/agency.js");
+const HAS_BUILT_CLI = fs.existsSync(CLI);
+if (!HAS_BUILT_CLI) {
+    console.warn(`Skipping CLI integration tests: ${CLI} not built (run \`make\` or \`pnpm run build\`).`);
+}
 let tmpDir;
 beforeEach(() => {
     tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "agency-cli-test-"));
@@ -68,3 +81,62 @@ describe("agency CLI command tree", () => {
             .toBe("function");
     });
 });
+describe.skipIf(!HAS_BUILT_CLI)("compile --strict (integration, requires build)", () => {
+    it("exits non-zero on a type error with --strict, zero without", async () => {
+        const cli = CLI;
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "strict-"));
+        const f = path.join(dir, "bad.agency");
+        fs.writeFileSync(f, 'node main() {\n  let x: number = "hello"\n}\n');
+        await expect(execFileAsync("node", [cli, "compile", f])).resolves.toBeTruthy();
+        await expect(execFileAsync("node", [cli, "compile", "--strict", f])).rejects.toBeTruthy();
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+});
+describe.skipIf(!HAS_BUILT_CLI)("compile --max-tool-call-rounds (integration, requires build)", () => {
+    it("bakes the flag value into the generated runPrompt call (overriding the default 10)", async () => {
+        const cli = CLI;
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "mtcr-"));
+        const f = path.join(dir, "prog.agency");
+        const out = path.join(dir, "prog.ts");
+        fs.writeFileSync(f, 'node main() {\n  const reply = llm("hi")\n}\n');
+        await execFileAsync("node", [cli, "compile", "--ts", "--max-tool-call-rounds", "3", f]);
+        const generated = fs.readFileSync(out, "utf-8");
+        expect(generated).toContain("maxToolCallRounds: 3");
+        expect(generated).not.toContain("maxToolCallRounds: 10");
+        // A positive integer is required.
+        await expect(execFileAsync("node", [cli, "compile", "--ts", "--max-tool-call-rounds", "0", f])).rejects.toBeTruthy();
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+});
+describe.skipIf(!HAS_BUILT_CLI)("config show (integration, requires build)", () => {
+    it("prints the resolved, merged config as JSON, with secrets masked by default", async () => {
+        const cli = CLI;
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "config-show-"));
+        fs.writeFileSync(path.join(dir, "agency.json"), JSON.stringify({ outDir: "./built", log: { apiKey: "sk-secret-1234" } }));
+        const cfg = path.join(dir, "agency.json");
+        const masked = await execFileAsync("node", [cli, "-c", cfg, "config", "show"]);
+        const maskedJson = JSON.parse(masked.stdout);
+        expect(maskedJson.outDir).toBe("./built");
+        expect(maskedJson.log.apiKey).toBe("•••1234");
+        expect(masked.stdout).not.toContain("sk-secret-1234");
+        const raw = await execFileAsync("node", [cli, "-c", cfg, "config", "show", "--show-secrets"]);
+        expect(JSON.parse(raw.stdout).log.apiKey).toBe("sk-secret-1234");
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+});
+describe("integer flag parsers reject parseInt footguns", () => {
+    it("parsePositiveInt accepts positive integers, rejects 0/floats/garbage/hex/negatives", () => {
+        expect(parsePositiveInt("5")).toBe(5);
+        expect(parsePositiveInt("100")).toBe(100);
+        for (const bad of ["0", "1.5", "3abc", "0x10", "-1", "", " ", "1e3"]) {
+            expect(() => parsePositiveInt(bad)).toThrow();
+        }
+    });
+    it("parseNonNegativeInt accepts 0 and positives, rejects floats/garbage/hex/negatives", () => {
+        expect(parseNonNegativeInt("0")).toBe(0);
+        expect(parseNonNegativeInt("42")).toBe(42);
+        for (const bad of ["1.5", "3abc", "0x10", "-1", "", "1e3"]) {
+            expect(() => parseNonNegativeInt(bad)).toThrow();
+        }
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agency-lang",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "The Agency language",
   "main": "lib/index.js",
   "bin": {

package/stdlib/agency/eval.js

@@ -266,7 +266,7 @@ async function __evalRun_impl(compiled, inputs, node = __UNSET, runsDir = __UNSE
       await runner.step(3, async (runner2) => {
         __stack.locals.lastStatus = `success`;
       });
-      await runner.loop(4, __stack.locals.state.inputs, async (input2, _, runner2) => {
+      await runner.loop(4, async () => __stack.locals.state.inputs, async (input2, _, runner2) => {
         await runner2.step(0, async (runner3) => {
           __self.__retryable = false;
           __stack.locals.prep = await __call(_prepareInput, {

package/stdlib/agency.js

@@ -1812,7 +1812,7 @@ async function __walkAST_impl(ast, visitor) {
           return;
         }
       });
-      await runner.loop(2, __stack.locals.result.visits, async (visit, _, runner2) => {
+      await runner.loop(2, async () => __stack.locals.result.visits, async (visit, _, runner2) => {
         await runner2.step(0, async (runner3) => {
           const __funcResult = await __call(__stack.args.visitor, {
             type: "positional",

package/stdlib/agent.agency

@@ -171,8 +171,8 @@ let _firstEntry: Record<string, boolean> = {}
  * categories.
  *
  * When called, sets the module-level handoff target. The current
- * LLM call returns. `route` reads the target via `consumeHandoff`
- * and re-runs the user's original message in the new specialist's
+ * LLM call returns. `route` reads (and clears) the target and
+ * re-runs the user's original message in the new specialist's
  * thread. If `category` isn't in `validCategories`, the handoff is
  * rejected and the LLM sees an error string as the tool's result.
  * This keeps the LLM from accidentally handing off to itself or to
@@ -207,11 +207,10 @@ export safe def handoff(
 
 /**
  * Read and clear the pending handoff target. Used internally by
- * `route` after each LLM call. Exposed for tests and for advanced
- * users writing their own dispatch loop on top of `handoff`.
- * Returns `""` when no handoff was requested.
+ * `route` after each LLM call. Returns `""` when no handoff was
+ * requested.
  */
-export safe def consumeHandoff(): string {
+safe def consumeHandoff(): string {
   """
   Read and clear the pending handoff target. Returns "" when no handoff
   was requested.
@@ -317,9 +316,10 @@ def runOneTurnPrompt(
  *    its system message is seeded on first entry, memory is scoped
  *    if requested, and `llm(userMsg, { tools: [...spec.tools,
  *    handoff] })` runs.
- * 2. After the LLM call returns, check `consumeHandoff()`.
- *    - Empty → done, return the LLM's reply.
- *    - Non-empty → loop with the new category, up to `config.maxHops`
+ * 2. After the LLM call returns, check whether `handoff` was called
+ *    during the turn.
+ *    - No → done, return the LLM's reply.
+ *    - Yes → loop with the new category, up to `config.maxHops`
  *      total iterations.
  * 3. If the hop cap is reached without a final answer, run one more
  *    LLM call WITHOUT the `handoff` tool so the agent must answer.

package/stdlib/agent.js

@@ -352,7 +352,7 @@ async function __todoUpdate_impl(id, status) {
           }
         });
       });
-      await runner.loop(1, __globals().get("stdlib/agent.agency", "_todos"), async (todo, _, runner2) => {
+      await runner.loop(1, async () => __globals().get("stdlib/agent.agency", "_todos"), async (todo, _, runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => __eq(todo.id, __stack.args.id),
@@ -1109,7 +1109,7 @@ const consumeHandoff = __AgencyFunction.create({
     schema: z.object({})
   },
   safe: true,
-  exported: true
+  exported: false
 }, __toolRegistry);
 async function __runOneTurn_impl(category, userMsg, config, allowHandoff) {
   const __setupData = setupFunction();
@@ -1534,7 +1534,7 @@ async function __runOneTurnPrompt_impl(category, userMsg, config, allowHandoff)
           }
         }
       ]);
-      await runner.thread(4, "create", { label: __stack.args.category, summarize: true, session: __stack.args.category }, async (runner2) => {
+      await runner.thread(4, "create", async () => ({ label: __stack.args.category, summarize: true, session: __stack.args.category }), async (runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => __eq(__stack.locals.spec.memory, true),
@@ -1592,7 +1592,7 @@ async function __runOneTurnPrompt_impl(category, userMsg, config, allowHandoff)
               await runner3.step(0, async (runner4) => {
                 __stack.locals.validTargets = [];
               });
-              await runner3.loop(1, await __call(keys, {
+              await runner3.loop(1, async () => await __call(keys, {
                 type: "positional",
                 args: [__stack.args.config.agents]
               }), async (c, _, runner4) => {
@@ -1963,7 +1963,7 @@ const route = __AgencyFunction.create({
   exported: true
 }, __toolRegistry);
 var stdin_default = graph;
-const __sourceMap = { "stdlib/agent.agency:todoAdd": { "1": { "line": 52, "col": 2 }, "2": { "line": 53, "col": 2 } }, "stdlib/agent.agency:todoUpdate": { "1": { "line": 63, "col": 2 }, "2": { "line": 69, "col": 2 }, "1.0.0": { "line": 65, "col": 6 }, "1.0": { "line": 64, "col": 4 } }, "stdlib/agent.agency:todoWrite": { "1": { "line": 76, "col": 2 }, "2": { "line": 77, "col": 2 } }, "stdlib/agent.agency:todoList": { "1": { "line": 84, "col": 2 } }, "stdlib/agent.agency:question": { "1": { "line": 97, "col": 2 }, "2": { "line": 100, "col": 2 } }, "stdlib/agent.agency:handoff": { "1": { "line": 199, "col": 2 }, "2": { "line": 203, "col": 2 }, "3": { "line": 204, "col": 2 }, "1.0": { "line": 200, "col": 4 }, "1.1": { "line": 201, "col": 4 } }, "stdlib/agent.agency:consumeHandoff": { "1": { "line": 218, "col": 2 }, "2": { "line": 219, "col": 2 }, "3": { "line": 220, "col": 2 } }, "stdlib/agent.agency:runOneTurn": { "1": { "line": 233, "col": 2 }, "2": { "line": 234, "col": 2 }, "2.0": { "line": 235, "col": 4 }, "2.1": { "line": 237, "col": 4 } }, "stdlib/agent.agency:runOneTurnAgent": { "1": { "line": 253, "col": 2 }, "2": { "line": 254, "col": 2 }, "3": { "line": 255, "col": 2 }, "4": { "line": 256, "col": 2 } }, "stdlib/agent.agency:runOneTurnPrompt": { "1": { "line": 270, "col": 2 }, "2": { "line": 271, "col": 2 }, "3": { "line": 272, "col": 2 }, "4": { "line": 281, "col": 2 }, "6": { "line": 305, "col": 2 }, "3.1": { "line": 279, "col": 4 }, "4.0.0": { "line": 283, "col": 6 }, "4.0": { "line": 282, "col": 4 }, "4.2.0": { "line": 286, "col": 6 }, "4.2.1": { "line": 288, "col": 6 }, "4.2": { "line": 285, "col": 4 }, "4.4": { "line": 290, "col": 4 }, "4.5.0": { "line": 292, "col": 6 }, "4.5.1.0.0": { "line": 295, "col": 10 }, "4.5.1.0": { "line": 294, "col": 8 }, "4.5.1": { "line": 293, "col": 6 }, "4.5.2": { "line": 298, "col": 6 }, "4.5": { "line": 291, "col": 4 }, "4.6": { "line": 300, "col": 4 } }, "stdlib/agent.agency:route": { "1": { "line": 347, "col": 2 }, "2": { "line": 350, "col": 2 }, "3": { "line": 351, "col": 2 }, "4": { "line": 352, "col": 2 }, "5": { "line": 353, "col": 2 }, "6": { "line": 354, "col": 2 }, "7": { "line": 364, "col": 2 }, "8": { "line": 368, "col": 2 }, "1.0": { "line": 348, "col": 4 }, "6.0": { "line": 355, "col": 4 }, "6.1": { "line": 356, "col": 4 }, "6.2.0": { "line": 358, "col": 6 }, "6.2.1": { "line": 360, "col": 6 }, "6.2.2": { "line": 361, "col": 6 }, "6.2": { "line": 357, "col": 4 }, "7.1": { "line": 366, "col": 4 } } };
+const __sourceMap = { "stdlib/agent.agency:todoAdd": { "1": { "line": 52, "col": 2 }, "2": { "line": 53, "col": 2 } }, "stdlib/agent.agency:todoUpdate": { "1": { "line": 63, "col": 2 }, "2": { "line": 69, "col": 2 }, "1.0.0": { "line": 65, "col": 6 }, "1.0": { "line": 64, "col": 4 } }, "stdlib/agent.agency:todoWrite": { "1": { "line": 76, "col": 2 }, "2": { "line": 77, "col": 2 } }, "stdlib/agent.agency:todoList": { "1": { "line": 84, "col": 2 } }, "stdlib/agent.agency:question": { "1": { "line": 97, "col": 2 }, "2": { "line": 100, "col": 2 } }, "stdlib/agent.agency:handoff": { "1": { "line": 199, "col": 2 }, "2": { "line": 203, "col": 2 }, "3": { "line": 204, "col": 2 }, "1.0": { "line": 200, "col": 4 }, "1.1": { "line": 201, "col": 4 } }, "stdlib/agent.agency:consumeHandoff": { "1": { "line": 217, "col": 2 }, "2": { "line": 218, "col": 2 }, "3": { "line": 219, "col": 2 } }, "stdlib/agent.agency:runOneTurn": { "1": { "line": 232, "col": 2 }, "2": { "line": 233, "col": 2 }, "2.0": { "line": 234, "col": 4 }, "2.1": { "line": 236, "col": 4 } }, "stdlib/agent.agency:runOneTurnAgent": { "1": { "line": 252, "col": 2 }, "2": { "line": 253, "col": 2 }, "3": { "line": 254, "col": 2 }, "4": { "line": 255, "col": 2 } }, "stdlib/agent.agency:runOneTurnPrompt": { "1": { "line": 269, "col": 2 }, "2": { "line": 270, "col": 2 }, "3": { "line": 271, "col": 2 }, "4": { "line": 280, "col": 2 }, "6": { "line": 304, "col": 2 }, "3.1": { "line": 278, "col": 4 }, "4.0.0": { "line": 282, "col": 6 }, "4.0": { "line": 281, "col": 4 }, "4.2.0": { "line": 285, "col": 6 }, "4.2.1": { "line": 287, "col": 6 }, "4.2": { "line": 284, "col": 4 }, "4.4": { "line": 289, "col": 4 }, "4.5.0": { "line": 291, "col": 6 }, "4.5.1.0.0": { "line": 294, "col": 10 }, "4.5.1.0": { "line": 293, "col": 8 }, "4.5.1": { "line": 292, "col": 6 }, "4.5.2": { "line": 297, "col": 6 }, "4.5": { "line": 290, "col": 4 }, "4.6": { "line": 299, "col": 4 } }, "stdlib/agent.agency:route": { "1": { "line": 347, "col": 2 }, "2": { "line": 350, "col": 2 }, "3": { "line": 351, "col": 2 }, "4": { "line": 352, "col": 2 }, "5": { "line": 353, "col": 2 }, "6": { "line": 354, "col": 2 }, "7": { "line": 364, "col": 2 }, "8": { "line": 368, "col": 2 }, "1.0": { "line": 348, "col": 4 }, "6.0": { "line": 355, "col": 4 }, "6.1": { "line": 356, "col": 4 }, "6.2.0": { "line": 358, "col": 6 }, "6.2.1": { "line": 360, "col": 6 }, "6.2.2": { "line": 361, "col": 6 }, "6.2": { "line": 357, "col": 4 }, "7.1": { "line": 366, "col": 4 } } };
 export {
   AgentSpec,
   PromptSpec,

package/stdlib/data/tech/hackernews.js

@@ -2704,7 +2704,7 @@ async function __hydrateStories_impl(ids, limit) {
       await runner.step(1, async (runner2) => {
         __stack.locals.stories = [];
       });
-      await runner.loop(2, await __call(takeFirst, {
+      await runner.loop(2, async () => await __call(takeFirst, {
         type: "positional",
         args: [__stack.args.ids, __stack.args.limit]
       }), async (id, _, runner2) => {

package/stdlib/index.js

@@ -2129,7 +2129,7 @@ async function __map_impl(arr, func) {
       await runner.step(1, async (runner2) => {
         __stack.locals.newArr = [];
       });
-      await runner.loop(2, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(2, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.step(0, async (runner3) => {
           await __callMethod(__stack.locals.newArr, "push", {
             type: "positional",
@@ -2274,7 +2274,7 @@ async function __filter_impl(arr, func) {
       await runner.step(1, async (runner2) => {
         __stack.locals.result = [];
       });
-      await runner.loop(2, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(2, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => await __call(__stack.args.func, {
@@ -2426,7 +2426,7 @@ async function __exclude_impl(arr, func) {
       await runner.step(1, async (runner2) => {
         __stack.locals.result = [];
       });
-      await runner.loop(2, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(2, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => __eq(await __call(__stack.args.func, {
@@ -2575,7 +2575,7 @@ async function __find_impl(arr, func) {
           }
         });
       });
-      await runner.loop(1, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(1, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => await __call(__stack.args.func, {
@@ -2723,7 +2723,7 @@ async function __findIndex_impl(arr, func) {
           }
         });
       });
-      await runner.loop(1, __stack.args.arr, async (item, index, runner2) => {
+      await runner.loop(1, async () => __stack.args.arr, async (item, index, runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => await __call(__stack.args.func, {
@@ -2880,7 +2880,7 @@ async function __reduce_impl(arr, initial, func) {
       await runner.step(1, async (runner2) => {
         __stack.locals.acc = __stack.args.initial;
       });
-      await runner.loop(2, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(2, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.step(0, async (runner3) => {
           __stack.locals.acc = await __call(__stack.args.func, {
             type: "positional",
@@ -3034,7 +3034,7 @@ async function __flatMap_impl(arr, func) {
       await runner.step(1, async (runner2) => {
         __stack.locals.result = [];
       });
-      await runner.loop(2, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(2, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.step(0, async (runner3) => {
           __stack.locals.mapped = await __call(__stack.args.func, {
             type: "positional",
@@ -3046,7 +3046,7 @@ async function __flatMap_impl(arr, func) {
             return;
           }
         });
-        await runner2.loop(1, __stack.locals.mapped, async (sub, _2, runner3) => {
+        await runner2.loop(1, async () => __stack.locals.mapped, async (sub, _2, runner3) => {
           await runner3.step(0, async (runner4) => {
             await __callMethod(__stack.locals.result, "push", {
               type: "positional",
@@ -3186,7 +3186,7 @@ async function __every_impl(arr, func) {
           }
         });
       });
-      await runner.loop(1, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(1, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => __eq(await __call(__stack.args.func, {
@@ -3334,7 +3334,7 @@ async function __some_impl(arr, func) {
           }
         });
       });
-      await runner.loop(1, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(1, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => await __call(__stack.args.func, {
@@ -3485,7 +3485,7 @@ async function __count_impl(arr, func) {
       await runner.step(1, async (runner2) => {
         __stack.locals.n = 0;
       });
-      await runner.loop(2, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(2, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.ifElse(0, [
           {
             condition: async () => await __call(__stack.args.func, {
@@ -3634,7 +3634,7 @@ async function __sortBy_impl(arr, func) {
       await runner.step(1, async (runner2) => {
         __stack.locals.result = [];
       });
-      await runner.loop(2, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(2, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.step(0, async (runner3) => {
           await __callMethod(__stack.locals.result, "push", {
             type: "positional",
@@ -3817,7 +3817,7 @@ async function __unique_impl(arr, func) {
       await runner.step(2, async (runner2) => {
         __stack.locals.seen = [];
       });
-      await runner.loop(3, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(3, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.step(0, async (runner3) => {
           __stack.locals.key = await __call(__stack.args.func, {
             type: "positional",
@@ -3832,7 +3832,7 @@ async function __unique_impl(arr, func) {
         await runner2.step(1, async (runner3) => {
           __stack.locals.found = false;
         });
-        await runner2.loop(2, __stack.locals.seen, async (s, _2, runner3) => {
+        await runner2.loop(2, async () => __stack.locals.seen, async (s, _2, runner3) => {
           await runner3.ifElse(0, [
             {
               condition: async () => __eq(s, __stack.locals.key),
@@ -4003,7 +4003,7 @@ async function __groupBy_impl(arr, func) {
           args: [null]
         });
       });
-      await runner.loop(3, __stack.args.arr, async (item, _, runner2) => {
+      await runner.loop(3, async () => __stack.args.arr, async (item, _, runner2) => {
         await runner2.step(0, async (runner3) => {
           __stack.locals.key = await __call(__stack.args.func, {
             type: "positional",

package/stdlib/llm.agency

@@ -38,7 +38,8 @@ export type LlmDefaults = {
   temperature?: number;
   reasoningEffort?: "low" | "medium" | "high";
   maxTokens?: number;
-  maxToolResultChars?: number
+  maxToolResultChars?: number;
+  maxToolCallRounds?: number
 }
 
 export def setLlmOptions(opts: LlmDefaults) {