@fifthrevision/axle 0.6.5 → 0.7.0

package/README.md

@@ -1,24 +1,298 @@
-# Axle: AI eXecution and Logic Engine
+# Axle
 
-Axle is a CLI tool and library for building composable LLM workflows. Inspired by [DSPy](https://dspy.ai), it began as a command-line utility and has since evolved into a general-purpose workflow library.
+Axle is a TypeScript library for building multi-turn LLM agents. It provides a
+small, focused API for building agentic applications.
 
-The project is evolving quickly and the API is still unstable, so this README will remain minimal for now.
+## Quick Start
 
-To get started, see the [examples](https://github.com/johncch/axle/tree/main/examples) directory.
+```typescript
+import { Agent, Instruct, anthropic } from "@fifthrevision/axle";
 
-## Configuration
-For CLI use, you will need to provide a `ax.config.yml` where you're running the tool.
+const provider = anthropic(process.env.ANTHROPIC_API_KEY);
+const agent = new Agent({ provider, model: "claude-sonnet-4-5-20250929" });
 
-Here's what it looks like. Every field is optional depending on the provider you want to use.
+const r1 = await agent.send("What is the capital of France?").final;
+console.log(r1.response); // "Paris is the capital of France."
 
+// Multi-turn — history is managed automatically
+const r2 = await agent.send("And what about Germany?").final;
 ```
+
+## Philosophy
+
+Axle has two big goals
+
+1. A small, focused, and ergonomic interface for building agents. The Agent,
+   Instruct, and other APIs are the entire surface, and there is a lot of thought
+   to make them distinct and composable.
+2. Systematic prompt improvement. Log what was sent, validate what came back, feed
+   learnings into the next run. (This is where the roadmap is headed.)
+
+Axle started as a DSPy-inspired workflow tool. As models got better with reasoning
+and tool use, rigid workflow graphs felt unnecessary — but the goals behind them
+(structured output, verification, multi-step reasoning) didn't go away. The project
+shifted toward making those capabilities composable primitives rather than
+fixed pipelines.
+
+### Roadmap
+
+- **Memory:** Ways to remember previous runs to retrieve them and add them back
+  into the prompt for future runs.
+- **Verification:** Automatic and manual ways to verify the output hits goals
+
+## Core Concepts
+
+### Agent
+
+Agent is the primary interface. It owns the provider, model, system prompt,
+tools, and conversation history. `send()` is the only verb — it accepts either a
+plain string or an Instruct.
+
+```typescript
+const agent = new Agent({
+  provider: anthropic(apiKey),
+  model: "claude-sonnet-4-5-20250929",
+  system: "You are a helpful assistant.",
+  tools: [calculatorTool],
+});
+```
+
+### Instruct
+
+Instruct is a rich message. Use it when you need structured output, file
+attachments, variable substitution, or additional instructions.
+
+```typescript
+import * as z from "zod";
+
+const instruct = new Instruct("Summarize the following document.", {
+  summary: z.string(),
+  keyPoints: z.array(z.string()),
+});
+instruct.addFile(await loadFileContent("./report.pdf"));
+
+const result = await agent.send(instruct).final;
+// result.response is { summary: string, keyPoints: string[] }
+```
+
+For plain text interactions, pass a string directly to `send()` instead.
+
+### Providers
+
+Axle ships with first-party support for Anthropic, OpenAI, and Gemini, plus a
+generic ChatCompletions provider for any OpenAI-compatible API.
+
+```typescript
+import { anthropic, openai, gemini, chatCompletions } from "@fifthrevision/axle";
+
+const a = anthropic(process.env.ANTHROPIC_API_KEY);
+const o = openai(process.env.OPENAI_API_KEY);
+const g = gemini(process.env.GEMINI_API_KEY);
+const local = chatCompletions("http://localhost:11434/v1");
+```
+
+### `stream()` and `generate()`
+
+Agent is built on two lower-level primitives that can be used directly when you
+want full control without conversation management.
+
+`stream()` runs a tool loop over a streaming request and returns a handle with
+callbacks for real-time output:
+
+```typescript
+import { stream } from "@fifthrevision/axle";
+
+const handle = stream({
+  provider,
+  model,
+  messages: [{ role: "user", content: "Hello" }],
+  tools: [myTool],
+  onToolCall: async (name, params) => ({ type: "success", content: "result" }),
+});
+
+handle.onPartUpdate((index, type, delta) => process.stdout.write(delta));
+const result = await handle.final;
+```
+
+`generate()` does the same but without streaming — it returns the final result
+directly as a promise:
+
+```typescript
+import { generate } from "@fifthrevision/axle";
+
+const result = await generate({
+  provider,
+  model,
+  messages: [{ role: "user", content: "Hello" }],
+  tools: [myTool],
+  onToolCall: async (name, params) => ({ type: "success", content: "result" }),
+});
+```
+
+Both handle the full tool-call loop automatically. Agent uses `stream()`
+internally and adds history management, system prompt, and callback wiring on
+top.
+
+## Details
+
+### Structured Output
+
+Pass a Zod schema as the second argument to Instruct. Axle compiles the schema
+into output format instructions, then parses the response back into typed
+objects.
+
+```typescript
+import * as z from "zod";
+
+const instruct = new Instruct("Tell me about Mars.", {
+  name: z.string(),
+  distanceFromSun: z.number(),
+  moons: z.array(z.string()),
+});
+
+const agent = new Agent({ provider, model });
+const result = await agent.send(instruct).final;
+
+result.response.name; // string
+result.response.distanceFromSun; // number
+result.response.moons; // string[]
+```
+
+### Tools
+
+A tool is an object with a name, description, Zod schema, and an `execute`
+function. Pass tools to the Agent constructor.
+
+```typescript
+import { z } from "zod";
+
+const weatherTool = {
+  name: "getWeather",
+  description: "Get current weather for a city",
+  schema: z.object({ city: z.string() }),
+  async execute(input) {
+    return JSON.stringify({ temp: 72, condition: "sunny" });
+  },
+};
+
+const agent = new Agent({
+  provider,
+  model,
+  tools: [weatherTool],
+});
+```
+
+Axle includes several built-in tools: `braveSearchTool`, `calculatorTool`,
+`execTool`, `readFileTool`, `writeFileTool`, and `patchFileTool`.
+
+### Streaming
+
+Agent exposes callbacks for streaming output as it arrives.
+
+```typescript
+const agent = new Agent({ provider, model });
+
+agent.onPartStart((index, type) => {
+  /* text, tool-call, thinking */
+});
+agent.onPartUpdate((index, type, delta) => process.stdout.write(delta));
+agent.onPartEnd((index, type) => {
+  /* part finished */
+});
+agent.onError((error) => console.error(error));
+
+const handle = agent.send("Write me a poem.");
+// handle.cancel() to abort mid-stream
+const result = await handle.final;
+```
+
+Callbacks are registered once and fire on every subsequent `send()`.
+
+## Known Limitations
+
+1. Axle does not support multi-modal output right now.
+
+## CLI
+
+In accordance to Axle's lineage of a workflow tool, Axle exposes a command
+line interface that accepts a declarative config file.
+
+### Installation
+
+```bash
+npm install -g @fifthrevision/axle
+```
+
+### Usage
+
+The CLI looks for `axle.job.yaml` and `axle.config.yaml` in the current
+directory by default. You can also specify them using the `-j` and `-c` flags
+
+```bash
+axle
+axle -j path/to/job.yaml -c path/to/config.yaml
+axle --args key=value other=thing
+axle --debug
+```
+
+A job file specifies the provider, task prompt, and optional tools/files:
+
+```yaml
+# axle.job.yaml
+provider:
+  type: anthropic
+  model: claude-sonnet-4-5-20250929
+
+task: |
+  Summarize the attached document.
+
+tools:
+  - calculator
+
+files:
+  - ./data/report.txt
+```
+
+### Batch
+
+Add a `batch` key to the job file to run the same task across multiple files.
+Each matched file is attached to the instruct automatically.
+
+```yaml
+# axle.job.yaml
+provider:
+  type: openai
+
+task: |
+  Summarize this file.
+
+batch:
+  files: "./data/*.txt"
+  concurrency: 3
+  resume: true
+```
+
+- `files` — glob pattern for input files
+- `concurrency` — max parallel runs (default 3)
+- `resume` — skip files already processed in a previous run
+
+### Configuration
+
+For CLI use, create an `axle.config.yaml` in your working directory with API
+keys:
+
+```yaml
+# axle.config.yaml
 openai:
   api-key: "<api-key>"
 anthropic:
   api-key: "<api-key>"
-ollama:
-  url: "<url>"
-brave:
+gemini:
   api-key: "<api-key>"
-  rateLimit: 1
+chatcompletions:
+  base-url: "http://localhost:11434/v1"
+  model: "llama3"
+  api-key: "<api-key>" # optional
 ```
+
+Provider-level keys in the job file override the config file.

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-var L=Object.defineProperty;var p=(t,i)=>L(t,"name",{value:i,configurable:!0});import{Command as k}from"@commander-js/extra-typings";import{x as w,L as j,R as E,w as I,g as T,d as P}from"./consoleWriter-Bg94CpP2.js";import S from"yaml";import{z as e}from"zod";import{access as v,mkdir as U,writeFile as F,appendFile as J}from"node:fs/promises";import{homedir as W}from"node:os";import"@anthropic-ai/sdk";import"@google/genai";import"openai";import"serialize-error";import"fs/promises";import"glob";import"node:path";import"chalk";import"node:readline";var R="0.6.5",$={version:R};e.object({value:e.string()});const _=e.object({"api-key":e.string(),rateLimit:e.number().optional()}),G=e.object({engine:e.literal("ollama")}).loose(),N=e.object({engine:e.literal("anthropic")}).loose(),z=e.object({engine:e.literal("openai")}).loose(),B=e.object({engine:e.literal("gemini")}).loose(),M=e.discriminatedUnion("engine",[G,N,z,B]),V=e.object({ollama:e.custom().optional(),anthropic:e.custom().optional(),openai:e.custom().optional(),gemini:e.custom().optional(),brave:_.optional()}).loose(),H=e.object({file:e.string()}),X=e.object({file:e.string()}),Y=e.object({file:e.string()}),Z=e.object({source:e.literal("file"),pattern:e.string(),files:e.union([e.string(),e.array(e.string())])}),q=e.object({type:e.literal("file-exist"),pattern:e.string()}),A=e.object({type:e.literal("files"),source:e.string(),bind:e.string(),"skip-if":e.array(q).optional()}),K=e.object({uses:e.literal("chat"),system:e.string().optional(),message:e.string(),output:e.record(e.string(),e.any()).optional(),replace:e.array(Z).optional(),tools:e.array(e.string()).optional(),images:e.array(H).optional(),documents:e.array(X).optional(),references:e.array(Y).optional()}),Q=e.object({uses:e.literal("write-to-disk"),output:e.string(),keys:e.union([e.string(),e.array(e.string())]).optional()}),m=e.discriminatedUnion("uses",[K,Q]),ee=e.object({type:e.literal("serial"),tools:e.array(e.string()).optional(),steps:e.array(m)}),te=e.object({type:e.literal("batch"),tools:e.array(e.string()).optional(),batch:e.array(A),steps:e.array(m)});e.preprocess(t=>t.batch&&t.batch.length>0?{...t,type:"batch"}:{...t,type:"serial"},e.discriminatedUnion("type",[ee,te]));const oe=e.object({type:e.literal("serial"),tools:e.array(e.string()).optional(),steps:e.array(m),dependsOn:e.union([e.string(),e.array(e.string())]).optional()}),ie=e.object({type:e.literal("batch"),tools:e.array(e.string()).optional(),batch:e.array(A),steps:e.array(m),dependsOn:e.union([e.string(),e.array(e.string())]).optional()}),ne=e.preprocess(t=>t.batch&&t.batch.length>0?{...t,type:"batch"}:{...t,type:"serial"},e.discriminatedUnion("type",[oe,ie])),re=e.record(e.string(),ne),ae=e.object({using:M,jobs:re}),se="ax.job",le=["yaml","yml","json"];async function ce(t,i){const{recorder:n}=i,{content:r,format:l}=await w(t,{defaults:{name:se,formats:le},tag:"Job File"});let a=null;if(l==="json")a=JSON.parse(r);else if(l==="yaml"||l==="yml")a=S.parse(r);else throw new Error("Invalid job file format");n?.debug?.heading.log("The Job Object"),n?.debug?.log(a);const c=ae.safeParse(a);if(!c.success)throw new Error(`The job file is not valid:
-${D(c.error)}`);return c.data}p(ce,"getJobConfig");const ge="ax.config",pe=["yaml","yml","json"];async function me(t,i){const{recorder:n}=i,{content:r,format:l}=await w(t,{defaults:{name:ge,formats:pe},tag:"Config File"});let a=null;if(l==="json")a=JSON.parse(r);else if(l==="yaml"||l==="yml")a=S.parse(r);else throw new Error("Invalid config file format");n?.debug?.heading.log("The Config Object"),n?.debug?.log(a);const c=V.safeParse(a);if(!c.success)throw new Error(`The config file is not valid:
-${D(c.error)}`);return c.data}p(me,"getServiceConfig");function D(t){return t.issues.map(i=>`  - ${i.path.join(".")||"root"}: ${i.message}`).join(`
-`)}p(D,"formatZodError");const d="./logs/",ue="~/.axle/logs/";class he{static{p(this,"LogWriter")}time;initialized=!1;logDir=d;pendingWrites=[];constructor(){this.time=new Date().toISOString()}get filename(){return`${this.logDir}${this.time}.log`}async initialize(){try{await v(d),this.logDir=d}catch{const r=ue.replace("~",W());try{await v(r),this.logDir=r}catch{await U(r,{recursive:!0}),this.logDir=r}}const i=F(this.filename,`AXLE: New run at ${this.time}
-`);this.pendingWrites.push(i);try{await i,this.initialized=!0}finally{const n=this.pendingWrites.indexOf(i);n!==-1&&this.pendingWrites.splice(n,1)}}async writeToLog(i){const{time:n,level:r,payload:l}=i;this.initialized||await this.initialize();const a=l.map(g=>typeof g=="string"?g:JSON.stringify(g)),c=`${j[r]} ${new Date(n).toISOString()} > ${a.join(" >> ")}
-`,h=J(this.filename,c).catch(g=>{console.error(`Failed to write to log file: ${g}`)});this.pendingWrites.push(h);try{await h}finally{const g=this.pendingWrites.indexOf(h);g!==-1&&this.pendingWrites.splice(g,1)}}async handleEvent(i){await this.writeToLog(i)}async flush(){this.pendingWrites.length>0&&await Promise.all(this.pendingWrites)}}const u=new k().name("axle").description("Axle is a CLI tool for running AI workflows").version($.version).option("--dry-run","Run the application without executing against the AI providers").option("-c, --config <path>","Path to the config file").option("-j, --job <path>","Path to the job file").option("--no-log","Do not write the output to a log file").option("--no-warn-unused","Do not warn about unused variables").option("--no-inline","Do not inline the console output").option("-d, --debug","Print additional debug information").option("--truncate <num>","Truncate printed strings to a certain number of characters, 0 to disable",parseInt,100).option("--args <args...>","Additional arguments in the form key=value");u.parse(process.argv);const s=u.opts(),f={};s.args&&s.args.forEach(t=>{const[i,n]=t.split("=");i&&n&&(f[i.trim()]=n.trim())}),process.on("uncaughtException",async t=>{console.error("Uncaught exception:"),console.error(t),o&&(o.error?.log("Uncaught exception:"),o.error?.log(t.message),o.error?.log(t.stack||""),await o.shutdown()),process.exit(1)});const o=new E;s.debug&&(o.level=j.Debug);const de=new I(s);if(o.subscribe(de),s.log){const t=new he;await t.initialize(),o.subscribe(t)}s.debug&&(o.debug?.heading.log("Options"),o.debug?.log(s),o.debug?.heading.log("Additional Arguments:"),o.debug?.log(f));let O,b;try{O=await me(s.config??null,{recorder:o}),b=await ce(s.job??null,{recorder:o})}catch(t){o.error.log(t.message),o.debug?.log(t.stack),await o.shutdown(),u.outputHelp(),process.exit(1)}let x;try{const{engine:t,...i}=b.using,n={...O[t],...i};x=T(t,n)}catch(t){o.error.log(t.message),o.error.log(t.stack),await o.shutdown(),u.outputHelp(),process.exit(1)}o.info?.heading.log("All systems operational. Running job...");const fe=Date.now();s.dryRun&&o.info?.log("Dry run mode enabled. No API calls will be made.");const y={in:0,out:0},C=await P(b.jobs).execute({provider:x,variables:f,options:s,stats:y,recorder:o});C&&(o.info?.heading.log("Response"),o.info.log(C)),o.info?.heading.log("Usage"),o.info?.log(`Total run time: ${Date.now()-fe}ms`),o.info?.log(`Input tokens: ${y.in} `),o.info?.log(`Output tokens: ${y.out} `),o.info?.heading.log("Complete. Goodbye"),await o.shutdown();
+var Y=Object.defineProperty;var i=(e,t)=>Y(e,"name",{value:t,configurable:!0});import{Command as Z}from"@commander-js/extra-typings";import J from"yaml";import{l as q,a as K,n as Q,D as ee,i as te,d as oe,p as ne,r as N,o as j,I as U,h as P,w as re,t as ae,u as ie,v as se,k as ce,j as le,T as ue,S as M}from"./simple-Bu-04pw1.js";import{z as n}from"zod";import{glob as pe}from"glob";import{readFile as _,mkdir as de,appendFile as fe}from"node:fs/promises";import{createHash as me}from"node:crypto";import{dirname as he}from"node:path";import"mime";import"@anthropic-ai/sdk";import"@google/genai";import"openai";import"node:child_process";import"node:util";class A extends Error{static{i(this,"AxleError")}code;id;details;constructor(t,o){super(t,{cause:o?.cause}),this.name=this.constructor.name,this.code=o?.code||"AXLE_ERROR",this.id=o?.id,this.details=o?.details,Object.setPrototypeOf(this,A.prototype)}toJSON(){return{name:this.name,message:this.message,code:this.code,...this.id&&{id:this.id},...this.details&&{details:this.details},...this.cause&&{cause:R(this.cause)}}}}function R(e){return e instanceof Error?{name:e.name,message:e.message,...e.stack&&{stack:e.stack},..."cause"in e&&e.cause&&{cause:R(e.cause)}}:e}i(R,"serializeError");function ge(e,t){if(!t||Object.keys(t).length===0)throw new A(`The provider ${e} is not configured. Please check your configuration.`);switch(e){case"openai":return{provider:ne(t["api-key"]),model:t.model||oe};case"anthropic":return{provider:te(t["api-key"]),model:t.model||ee};case"gemini":return{provider:Q(t["api-key"]),model:t.model||K};case"chatcompletions":{const o=t;return{provider:q(o["base-url"],o["api-key"]),model:o.model}}default:throw new A("The provider is unsupported")}}i(ge,"getProvider");var we="0.7.0",ye={version:we};n.object({value:n.string()});const be=n.object({"api-key":n.string(),rateLimit:n.number().optional()});n.object({timeout:n.number().optional(),maxBuffer:n.number().optional(),cwd:n.string().optional()});const ve=n.object({type:n.literal("chatcompletions")}).loose(),Se=n.object({type:n.literal("anthropic")}).loose(),ke=n.object({type:n.literal("openai")}).loose(),Ee=n.object({type:n.literal("gemini")}).loose(),Te=n.discriminatedUnion("type",[ve,Se,ke,Ee]),Ae=n.object({chatcompletions:n.custom().optional(),anthropic:n.custom().optional(),openai:n.custom().optional(),gemini:n.custom().optional(),brave:be.optional()}).loose(),Oe=n.object({files:n.string(),resume:n.boolean().default(!1),concurrency:n.number().int().positive().default(3)}),je=n.object({provider:Te,task:n.string(),tools:n.array(n.string()).optional(),files:n.array(n.string()).optional(),batch:Oe.optional()}),Le="axle.job",Fe=["yaml","yml","json"];async function xe(e,t){const{tracer:o}=t,{content:l,format:s}=await N(e,{defaults:{name:Le,formats:Fe},tag:"Job File"});let a=null;if(s==="json")a=JSON.parse(l);else if(s==="yaml"||s==="yml")a=J.parse(l);else throw new Error("Invalid job file format");o?.debug("Job config: "+JSON.stringify(a,null,2));const c=je.safeParse(a);if(!c.success)throw new Error(`The job file is not valid:
+${B(c.error)}`);return c.data}i(xe,"getJobConfig");const De="axle.config",$e=["yaml","yml","json"];async function Ie(e,t){const{tracer:o}=t,{content:l,format:s}=await N(e,{defaults:{name:De,formats:$e},tag:"Config File"});let a=null;if(s==="json")a=JSON.parse(l);else if(s==="yaml"||s==="yml")a=J.parse(l);else throw new Error("Invalid config file format");o?.debug("Service config: "+JSON.stringify(a,null,2));const c=Ae.safeParse(a);if(!c.success)throw new Error(`The config file is not valid:
+${B(c.error)}`);return c.data}i(Ie,"getServiceConfig");function B(e){return e.issues.map(t=>`  - ${t.path.join(".")||"root"}: ${t.message}`).join(`
+`)}i(B,"formatZodError");const W=".axle/batch.jsonl";function Ce(e,t){const o=me("sha256");return o.update(e),o.update("\0"),o.update(t),o.digest("hex")}i(Ce,"computeHash");async function Je(e=W){const t=new Map;let o;try{o=await _(e,"utf-8")}catch{return t}for(const l of o.split(`
+`)){const s=l.trim();if(s)try{const a=JSON.parse(s);a.file&&a.hash&&t.set(a.file,a)}catch{}}return t}i(Je,"loadLedger");async function Ne(e,t=W){await de(he(t),{recursive:!0}),await fe(t,JSON.stringify(e)+`
+`,"utf-8")}i(Ne,"appendLedgerEntry");async function Ue(e,t,o,l,s,a,c,m){const p=new U(e.task);if(e.files)for(const v of e.files)p.addFile(await j(v));const g=m.startSpan("job",{type:"workflow"}),w=await new P({provider:t,model:o,tools:l,tracer:g}).send(p,s).final;g.end(),c.in+=w.usage.in,c.out+=w.usage.out,w.response&&m.info("Response: "+JSON.stringify(w.response,null,2))}i(Ue,"runSingle");async function Pe(e,t,o,l,s,a,c,m){const p=e.batch,g=await pe(p.files);if(g.length===0){m.warn(`No files matched pattern: ${p.files}`);return}m.info(`Batch: ${g.length} file(s) matched "${p.files}"`);const x=p.resume?await Je():new Map,w=e.files?await Promise.all(e.files.map(d=>j(d))):[];let v=0,D=0,$=0;const z=p.concurrency??3;await Me(z,g,async d=>{const y=m.startSpan(`batch:${d}`,{type:"workflow"});try{const b=await _(d),S=Ce(e.task,b),I=x.get(d);if(p.resume&&I&&I.hash===S){y.info("Skipped (already completed)"),y.end(),D++;return}const O=new U(e.task);for(const X of w)O.addFile(X);O.addFile(await j(d));const V={...s,file:d},C=await new P({provider:t,model:o,tools:l,tracer:y}).send(O,V).final;c.in+=C.usage.in,c.out+=C.usage.out,await Ne({file:d,hash:S,timestamp:Date.now()}),y.end(),v++}catch(b){const S=b instanceof Error?b.message:String(b);y.error(`Failed: ${S}`),y.end("error"),$++}}),m.info(`Batch complete: ${v} completed, ${D} skipped, ${$} failed`)}i(Pe,"runBatch");async function Me(e,t,o){let l=0;async function s(){for(;l<t.length;){const c=l++;await o(t[c])}}i(s,"worker");const a=Array.from({length:Math.min(e,t.length)},()=>s());await Promise.all(a)}i(Me,"runWithConcurrency");function _e(e,t){switch(e){case"brave":return le;case"calculator":return ce;case"exec":return se;case"patch-file":return ie;case"read-file":return ae;case"write-file":return re;default:throw new Error(`Unknown tool: ${e}`)}}i(_e,"createTool");function Re(e,t){return e.map(o=>_e(o))}i(Re,"createTools");const k=new Z().name("axle").description("Axle is a CLI tool for running AI workflows").version(ye.version).option("--dry-run","Run the application without executing against the AI providers").option("-c, --config <path>","Path to the config file").option("-j, --job <path>","Path to the job file").option("--no-log","Do not write the output to a log file").option("--no-warn-unused","Do not warn about unused variables").option("--no-inline","Do not inline the console output").option("-d, --debug","Print additional debug information").option("--truncate <num>","Truncate printed strings to a certain number of characters, 0 to disable",parseInt,100).option("--args <args...>","Additional arguments in the form key=value");k.parse(process.argv);const u=k.opts(),E={date:new Date().toISOString().split("T")[0],datetime:new Date().toISOString(),cwd:process.cwd()};u.args&&u.args.forEach(e=>{const[t,o]=e.split("=");t&&o&&(E[t.trim()]=o.trim())});const f=new ue;u.debug&&(f.minLevel="debug");const Be=new M({minLevel:u.debug?"debug":"info",showInternal:u.debug,showTimestamp:!0});if(f.addWriter(Be),u.log){const e=new M({minLevel:"debug",showInternal:!0,showTimestamp:!0,output:i(t=>{},"output")});f.addWriter(e)}const r=f.startSpan("cli",{type:"root"});process.on("uncaughtException",async e=>{console.error("Uncaught exception:"),console.error(e),r.error("Uncaught exception:"),r.error(e.message),r.error(e.stack||""),r.end("error"),await f.flush(),process.exit(1)}),u.debug&&(r.debug("Options: "+JSON.stringify(u,null,2)),r.debug("Additional Arguments: "+JSON.stringify(E,null,2)));let G,h;try{G=await Ie(u.config??null,{tracer:r}),h=await xe(u.job??null,{tracer:r})}catch(e){const t=e instanceof Error?e:new Error(String(e));r.error(t.message),r.debug(t.stack??""),r.end("error"),await f.flush(),k.outputHelp(),process.exit(1)}let L,F;try{const{type:e,...t}=h.provider,o={...G[e],...t};({provider:L,model:F}=ge(e,o))}catch(e){const t=e instanceof Error?e:new Error(String(e));r.error(t.message),r.error(t.stack??""),r.end("error"),await f.flush(),k.outputHelp(),process.exit(1)}r.info("All systems operational. Running job..."),u.dryRun&&r.info("Dry run mode enabled. No API calls will be made.");const H=h.tools?.length?Re(h.tools):[],T={in:0,out:0},We=performance.now();h.batch?await Pe(h,L,F,H,E,u,T,r):await Ue(h,L,F,H,E,u,T,r);const Ge=performance.now()-We;r.info(`Total run time: ${Math.round(Ge)}ms`),r.info(`Input tokens: ${T.in}`),r.info(`Output tokens: ${T.out}`),r.info("Complete. Goodbye"),r.end(),await f.flush();