agency-lang 0.7.2 → 0.7.4

package/dist/lib/agents/agency-agent/subagents/code.js

@@ -11,7 +11,7 @@ import { gitStatus, gitLog, gitDiff, gitShow, gitBranchList, gitRemoteList, gitB
 import { skillsDir } from "agency-lang/stdlib/skills.js";
 import { systemMessage } from "agency-lang/stdlib/thread.js";
 import { agentNames } from "../lib/config.js";
-import { withWebSearch } from "../lib/search.js";
+import { withWebSearch, getSearchBackend } from "../lib/search.js";
 import { oracleAgent } from "./oracle.js";
 import { review, renderFeedback, feedbackHasErrors } from "./review.js";
 import { fileURLToPath } from "url";
@@ -214,6 +214,7 @@ __registerTool(skillsDir);
 __registerTool(systemMessage);
 __registerTool(agentNames);
 __registerTool(withWebSearch);
+__registerTool(getSearchBackend);
 __registerTool(oracleAgent);
 __registerTool(review);
 __registerTool(renderFeedback);
@@ -224,6 +225,8 @@ let docSkill = __UNINIT_STATIC;
 let cliSkill = __UNINIT_STATIC;
 let codeSysPrompt = __UNINIT_STATIC;
 let codeTools = __UNINIT_STATIC;
+let WEB_SEARCH_NOTE = __UNINIT_STATIC;
+let ONE_SHOT_NOTE = __UNINIT_STATIC;
 async function __initializeStatic(__ctx) {
   if (__staticInitPromise) {
     return __staticInitPromise;
@@ -261,30 +264,16 @@ You are the **code specialist** of a multi-thread Agency-language
 assistant. You handle anything that touches code or the file system:
 writing, editing, running, and typechecking Agency or shell code.
 
-You do NOT have access to web search, Wikipedia,
-or URL fetching. If the user asks a question that needs research,
-do one of the following:
+For Agency-language questions (syntax, control flow, types, the CLI),
+call the bundled docs tools \u2014 they are authoritative for Agency:
+  * \`docSkill\` \u2014 the language guide (syntax, types, error handling,
+                 built-ins, callbacks, advanced types)
+  * \`cliSkill\` \u2014 the CLI reference (\`agency run\`, \`agency test\`, ...)
+Pick whichever matches the question rather than guessing.
 
-- If the research involves Agency features of syntax:
-   - call the bundled docs tools first \u2014 they're authoritative:
-     * \`docSkill\`      \u2014 language guide (syntax, control flow,
-                         types, error handling, etc.),
-                         built-ins, callbacks, advanced types
-     * \`cliSkill\`      \u2014 CLI reference (\`agency run\`, \`agency test\`,
-                         \`agency compile\`, ...)
-   Pick whichever matches the question rather than guessing.
-
-- If the research involves something else (a research question,
-  an external API, a Wikipedia summary, or a URL fetch), call
-  \`handoff(reason)\` \u2014 the only valid target for you is the research
-  specialist, so just pass a brief reason. The runtime will re-route
-  the user's original message there.
-
-**Bias toward staying in the code thread.** Most follow-up messages
-("can you make it faster?", "fix the error", "what about edge
-cases?") are continuations of the current coding task, NOT new
-categories. Only call \`handoff\` when the message clearly needs
-research-specialist tools.
+**Stay focused on the current task.** Most follow-ups ("can you make it
+faster?", "fix the error", "what about edge cases?") are continuations
+of the current work, not new categories.
 
 ## Style
 
@@ -551,6 +540,28 @@ diagram needs scrolling, prose is probably better.
         allowHandoff: false
       }
     })]);
+    WEB_SEARCH_NOTE = __deepFreeze(`
+You have **web search**. Use it directly whenever a task needs current or
+external information \u2014 a fact to verify, a library or API to check, a
+dataset or leaderboard to consult. Do NOT ask the user to look things up,
+and do NOT decline a task as "needs research / out of scope": search for
+what you need and keep going.`);
+    ONE_SHOT_NOTE = __deepFreeze(`
+You are running in **one-shot, autonomous mode**: no human will answer
+questions and there is NO next turn. Therefore:
+- NEVER end your turn by asking a clarifying question or waiting for input.
+  If something is ambiguous, state the most reasonable assumption and
+  proceed.
+- NEVER defer work to "the next turn" or hand back a plan \u2014 do it now.
+- NEVER end with an empty response or zero tool calls. If the task is hard,
+  underspecified, or outside your usual area, still take a concrete first
+  action toward it and write your best attempt to the required file \u2014 an
+  imperfect artifact on disk always beats producing nothing.
+- Leave the task COMPLETE on disk: write the required file(s), then verify
+  (compile, run, run any tests) and fix what fails before you stop.
+- If you are running low on tool budget, spend the remaining calls
+  producing and saving the best COMPLETE artifact you can. A working file
+  on disk beats a perfect plan that was never written.`);
   })();
   return __staticInitPromise;
 }
@@ -560,7 +571,9 @@ function __getStaticVars() {
     docSkill,
     cliSkill,
     codeSysPrompt,
-    codeTools
+    codeTools,
+    WEB_SEARCH_NOTE,
+    ONE_SHOT_NOTE
   };
 }
 __globalCtx.getStaticVars = __getStaticVars;
@@ -572,6 +585,7 @@ async function __initializeGlobals(__ctx) {
   __ctx.globals.markInitialized("dist/lib/agents/agency-agent/subagents/code.agency");
   await __initializeStatic(__ctx);
   await __ctx.writeStaticStateToTrace(__globalCtx.getStaticVars());
+  __ctx.globals.set("dist/lib/agents/agency-agent/subagents/code.agency", "_oneShot", false);
   __ctx.globals.set("dist/lib/agents/agency-agent/subagents/code.agency", "_first", true);
 }
 __registerGlobalsInit("dist/lib/agents/agency-agent/subagents/code.agency", __initializeGlobals);
@@ -713,6 +727,120 @@ const agencyCli = __AgencyFunction.create({
   safe: false,
   exported: true
 }, __toolRegistry);
+async function __setCodeOneShot_impl(oneShot) {
+  const __setupData = setupFunction();
+  const __stack = __setupData.stack;
+  const __step = __setupData.step;
+  const __self = __setupData.self;
+  const __ctx = getRuntimeContext().ctx;
+  let __forked;
+  let __functionCompleted = false;
+  if (!__globals().isInitialized("dist/lib/agents/agency-agent/subagents/code.agency")) {
+    await __initializeGlobals(__ctx);
+  }
+  let __funcStartTime = performance.now();
+  __stack.args["oneShot"] = oneShot;
+  __self.__retryable = __self.__retryable ?? true;
+  const runner = new Runner(__ctx, __stack, { state: __stack, moduleId: "dist/lib/agents/agency-agent/subagents/code.agency", scopeName: "setCodeOneShot", threads: __setupData.threads });
+  let __resultCheckpointId = -1;
+  if (__ctx._pendingArgOverrides) {
+    const __overrides = __ctx._pendingArgOverrides;
+    __ctx._pendingArgOverrides = void 0;
+    if ("oneShot" in __overrides) {
+      oneShot = __overrides["oneShot"];
+      __stack.args["oneShot"] = oneShot;
+    }
+  }
+  try {
+    await agencyStore.run({
+      ...getRuntimeContext(),
+      ctx: __ctx,
+      stack: __setupData.stateStack,
+      threads: __setupData.threads
+    }, async () => {
+      await runner.hook(0, async () => {
+        await callHook({
+          name: "onFunctionStart",
+          data: {
+            functionName: "setCodeOneShot",
+            args: {
+              oneShot
+            },
+            moduleId: "dist/lib/agents/agency-agent/subagents/code.agency"
+          }
+        });
+      });
+      await runner.step(1, async (runner2) => {
+        __globals().set("dist/lib/agents/agency-agent/subagents/code.agency", "_oneShot", __stack.args.oneShot);
+      });
+    });
+    if (runner.halted) {
+      if (isFailure(runner.haltResult)) {
+        runner.haltResult.retryable = runner.haltResult.retryable && __self.__retryable;
+      }
+      return runner.haltResult;
+    }
+  } catch (__error) {
+    if (__error instanceof RestoreSignal) {
+      throw __error;
+    }
+    if (__error instanceof AgencyAbort) {
+      throw __error;
+    }
+    {
+      const __errMsg = __error instanceof Error ? __error.message : String(__error);
+      const __errStack = __error instanceof Error && __error.stack ? __error.stack : "";
+      const __log = __createLogger(__ctx.logLevel);
+      __log.error("Function setCodeOneShot threw an exception (converted to Failure): " + __errMsg);
+      if (__errStack) __log.error(__errStack);
+      __ctx.statelogClient?.error?.({
+        errorType: "runtimeError",
+        message: __errMsg,
+        functionName: "setCodeOneShot",
+        retryable: __self.__retryable
+      });
+    }
+    return failure(
+      __error instanceof Error ? __error.message : String(__error),
+      {
+        checkpoint: getRuntimeContext().ctx.getResultCheckpoint(),
+        retryable: __self.__retryable,
+        functionName: "setCodeOneShot",
+        args: __stack.args
+      }
+    );
+  } finally {
+    __stateStack()?.pop();
+    if (__functionCompleted) {
+      await callHook({
+        name: "onFunctionEnd",
+        data: {
+          functionName: "setCodeOneShot",
+          timeTaken: performance.now() - __funcStartTime
+        }
+      });
+    }
+  }
+}
+const setCodeOneShot = __AgencyFunction.create({
+  name: "setCodeOneShot",
+  module: "dist/lib/agents/agency-agent/subagents/code.agency",
+  fn: __setCodeOneShot_impl,
+  params: [{
+    name: "oneShot",
+    hasDefault: false,
+    defaultValue: void 0,
+    variadic: false,
+    isFunctionTyped: false
+  }],
+  toolDefinition: {
+    name: "setCodeOneShot",
+    description: "No description provided.",
+    schema: z.object({ "oneShot": z.boolean() })
+  },
+  safe: false,
+  exported: true
+}, __toolRegistry);
 async function __codeAgent_impl(userMsg, allowHandoff) {
   const __setupData = setupFunction();
   const __stack = __setupData.stack;
@@ -854,10 +982,45 @@ async function __codeAgent_impl(userMsg, allowHandoff) {
               condition: async () => __globals().get("dist/lib/agents/agency-agent/subagents/code.agency", "_first"),
               body: async (runner4) => {
                 await runner4.step(0, async (runner5) => {
+                });
+                await runner4.step(1, async (runner5) => {
+                  __stack.locals.sys = __readStatic(codeSysPrompt, "codeSysPrompt", "dist/lib/agents/agency-agent/subagents/code.agency");
+                });
+                await runner4.ifElse(2, [
+                  {
+                    condition: async () => !__eq(await __call(getSearchBackend, {
+                      type: "positional",
+                      args: []
+                    }), `off`),
+                    body: async (runner5) => {
+                      await runner5.step(0, async (runner6) => {
+                        __stack.locals.sys = `${__stack.locals.sys}
+
+${__readStatic(WEB_SEARCH_NOTE, "WEB_SEARCH_NOTE", "dist/lib/agents/agency-agent/subagents/code.agency")}`;
+                      });
+                    }
+                  }
+                ]);
+                await runner4.step(3, async (runner5) => {
+                  __self.__retryable = false;
+                });
+                await runner4.ifElse(4, [
+                  {
+                    condition: async () => __globals().get("dist/lib/agents/agency-agent/subagents/code.agency", "_oneShot"),
+                    body: async (runner5) => {
+                      await runner5.step(0, async (runner6) => {
+                        __stack.locals.sys = `${__stack.locals.sys}
+
+${__readStatic(ONE_SHOT_NOTE, "ONE_SHOT_NOTE", "dist/lib/agents/agency-agent/subagents/code.agency")}`;
+                      });
+                    }
+                  }
+                ]);
+                await runner4.step(5, async (runner5) => {
                   __self.__retryable = false;
                   const __funcResult = await __call(systemMessage, {
                     type: "positional",
-                    args: [__readStatic(codeSysPrompt, "codeSysPrompt", "dist/lib/agents/agency-agent/subagents/code.agency")]
+                    args: [__stack.locals.sys]
                   });
                   if (hasInterrupts(__funcResult)) {
                     await getRuntimeContext().ctx.pendingPromises.awaitAll();
@@ -865,7 +1028,7 @@ async function __codeAgent_impl(userMsg, allowHandoff) {
                     return;
                   }
                 });
-                await runner4.step(1, async (runner5) => {
+                await runner4.step(6, async (runner5) => {
                   __globals().set("dist/lib/agents/agency-agent/subagents/code.agency", "_first", false);
                 });
               }
@@ -1073,7 +1236,7 @@ const codeAgent = __AgencyFunction.create({
   exported: true
 }, __toolRegistry);
 var stdin_default = graph;
-const __sourceMap = { "dist/lib/agents/agency-agent/subagents/code.agency:agencyCli": { "1": { "line": 66, "col": 2 } }, "dist/lib/agents/agency-agent/subagents/code.agency:codeAgent": { "1": { "line": 374, "col": 2 }, "2": { "line": 375, "col": 2 }, "3": { "line": 376, "col": 2 }, "4": { "line": 377, "col": 2 }, "5": { "line": 381, "col": 2 }, "6": { "line": 382, "col": 2 }, "7": { "line": 385, "col": 2 }, "8": { "line": 392, "col": 2 }, "9": { "line": 393, "col": 2 }, "11": { "line": 436, "col": 2 }, "4.0": { "line": 378, "col": 4 }, "9.0": { "line": 394, "col": 4 }, "9.1.0": { "line": 396, "col": 6 }, "9.1.2.0": { "line": 399, "col": 8 }, "9.1.2.1": { "line": 400, "col": 8 }, "9.1.2": { "line": 398, "col": 6 }, "9.1.4": { "line": 402, "col": 6 }, "9.1.5": { "line": 410, "col": 6 }, "9.1.6.0": { "line": 412, "col": 8 }, "9.1.6.1": { "line": 413, "col": 8 }, "9.1.6.2": { "line": 414, "col": 8 }, "9.1.6.3": { "line": 416, "col": 8 }, "9.1.6": { "line": 411, "col": 6 }, "9.1": { "line": 395, "col": 4 }, "9.3": { "line": 420, "col": 4 }, "9.4": { "line": 434, "col": 4 } }, "dist/lib/agents/agency-agent/subagents/code.agency:__block_0": {} };
+const __sourceMap = { "dist/lib/agents/agency-agent/subagents/code.agency:agencyCli": { "1": { "line": 66, "col": 2 } }, "dist/lib/agents/agency-agent/subagents/code.agency:setCodeOneShot": { "1": { "line": 382, "col": 2 } }, "dist/lib/agents/agency-agent/subagents/code.agency:codeAgent": { "1": { "line": 398, "col": 2 }, "2": { "line": 399, "col": 2 }, "3": { "line": 400, "col": 2 }, "4": { "line": 401, "col": 2 }, "5": { "line": 405, "col": 2 }, "6": { "line": 406, "col": 2 }, "7": { "line": 409, "col": 2 }, "8": { "line": 416, "col": 2 }, "9": { "line": 417, "col": 2 }, "11": { "line": 469, "col": 2 }, "4.0": { "line": 402, "col": 4 }, "9.0": { "line": 418, "col": 4 }, "9.1.0": { "line": 420, "col": 6 }, "9.1.2.1": { "line": 425, "col": 8 }, "9.1.2.2.0": { "line": 427, "col": 10 }, "9.1.2.2": { "line": 426, "col": 8 }, "9.1.2.4.0": { "line": 430, "col": 10 }, "9.1.2.4": { "line": 429, "col": 8 }, "9.1.2.5": { "line": 432, "col": 8 }, "9.1.2.6": { "line": 433, "col": 8 }, "9.1.2": { "line": 422, "col": 6 }, "9.1.4": { "line": 435, "col": 6 }, "9.1.5": { "line": 443, "col": 6 }, "9.1.6.0": { "line": 445, "col": 8 }, "9.1.6.1": { "line": 446, "col": 8 }, "9.1.6.2": { "line": 447, "col": 8 }, "9.1.6.3": { "line": 449, "col": 8 }, "9.1.6": { "line": 444, "col": 6 }, "9.1": { "line": 419, "col": 4 }, "9.3": { "line": 453, "col": 4 }, "9.4": { "line": 467, "col": 4 } }, "dist/lib/agents/agency-agent/subagents/code.agency:__block_0": {} };
 export {
   __getCheckpoints,
   __invokeFunction,
@@ -1094,5 +1257,6 @@ export {
   isInterrupt,
   reject,
   respondToInterrupts,
-  rewindFrom
+  rewindFrom,
+  setCodeOneShot
 };

package/dist/lib/cli/commands.d.ts

@@ -1,9 +1,7 @@
 import { AgencyConfig } from "../config.js";
 import { AgencyProgram } from "../index.js";
-import { SymbolTable } from "../symbolTable.js";
-import { type CompiledClosure } from "../compiler/compileClosure.js";
-import { type ImportStrategy } from "../importStrategy.js";
 import { type InstallKind } from "./installLocation.js";
+import { readFile, type CompileOptions } from "../compiler/buildSession.js";
 export declare function compiledOutputRegisterUrl(): string;
 export declare function compiledOutputNodeArgs(): string[];
 export declare function agencyLangResolvesFrom(dir: string): boolean;
@@ -11,42 +9,29 @@ export declare function compileWarning(kind: InstallKind, outputContext: string,
 export declare function loadConfig(configPath?: string, verbose?: boolean): AgencyConfig;
 export declare function readStdin(): Promise<string>;
 export declare function parse(contents: string, config: AgencyConfig, applyTemplate?: boolean, lower?: boolean): AgencyProgram;
-export declare function readFile(inputFile: string): string;
+export { readFile };
 export declare function resetCompilationCache(): void;
 /**
  * Compile a set of entry files under ONE union closure, like the
  * directory branch of `compile()` does. Callers with many entry points
  * (the test runner's precompile pass) use this instead of per-file
- * `compile()` calls, which would rebuild the closure once per entry via
- * `ensureCompiledClosure`'s covers-check.
+ * `compile()` calls, which would rebuild the closure once per entry.
  *
  * Unlike the CLI directory branch, closure errors THROW
  * (`CompileClosureError`) instead of exiting, so programmatic callers
  * can attach context. Parse/typecheck failures inside per-file
  * `compile()` keep their existing exit behavior.
- *
- * `options.closure` lets a caller that already built the union closure
- * (e.g. to run analyses over `closure.programs`) hand it in rather than
- * paying for a rebuild. It MUST cover every file in `files`, otherwise
- * `ensureCompiledClosure` clears the session cache mid-loop and the
- * one-compile-per-module guarantee is lost.
  */
 export declare function compileMany(config: AgencyConfig, files: string[], options?: {
-    closure?: CompiledClosure;
     quiet?: boolean;
     allowTestImports?: boolean;
 }): void;
-export declare function compile(config: AgencyConfig, inputFile: string, _outputFile?: string, options?: {
-    ts?: boolean;
-    symbolTable?: SymbolTable;
-    importStrategy?: ImportStrategy;
-    /** Suppress the per-file `input → output (in Nms)` progress line. */
-    quiet?: boolean;
-    /** Test-harness only. Honors `import test { … }`. Never set outside the
-     *  test runner / analysis paths — kept off AgencyConfig so agent source
-     *  cannot enable it. */
-    allowTestImports?: boolean;
-}): string | null;
+/**
+ * Compile an .agency file (or directory of them) to JavaScript. Thin
+ * delegate over the default BuildSession — all pipeline logic and caching
+ * state live in lib/compiler/buildSession.ts.
+ */
+export declare function compile(config: AgencyConfig, inputFile: string, _outputFile?: string, options?: CompileOptions): string | null;
 export declare function format(contents: string, config?: AgencyConfig): Promise<string>;
 export declare function formatFile(inputFile: string, inPlace?: boolean, config?: AgencyConfig): Promise<void>;
 export declare function run(config: AgencyConfig, inputFile: string, outputFile?: string, resumeFile?: string): void;