@spendgraph/tools 0.5.0 → 0.7.0

package/dist/agents/moa/moa.js

@@ -0,0 +1,13 @@
+import{createRequest as w,MoaApiError as M}from"./http.js";const h={queued:"pending",running:"running",succeeded:"done",failed:"failed",canceled:"failed"},T=["md","pdf","docx","pptx"],g=n=>{const t=n?.split(".").pop()?.toLowerCase();return t&&T.includes(t)?t:void 0};function E(n){if(!n?.length)return;const t=n.flatMap(e=>{const s=g(e.name);return!s||!(e.url||e.data)?[]:[{name:e.name??`document.${s}`,format:s,url:e.url,data:e.data,mime:e.contentType,sizeBytes:e.sizeBytes}]});return t.length?t:void 0}function I(n){return`
+
+<deliverables>
+Besides the text answer, save the finished deliverable into the artifacts/ directory of your working dir as: ${n.map(t=>`one .${t} file`).join(", ")}.
+</deliverables>`}function x(n){let t=n.task;return n.context&&(t+=`
+
+<context>
+${n.context}
+</context>`),n.design&&(t+=`
+
+<design>
+${n.design}
+</design>`),n.artifacts?.length&&(t+=I(n.artifacts)),t}function p(n={}){const t=w(n);return{async create(e){const s=await t("/tasks",{method:"POST",body:{task:x(e),mode:"striker",...e.sessionId?{sessionId:e.sessionId}:{},...e.newSessionId?{newSessionId:e.newSessionId}:{}}});if(!s.id)throw new M("Moa did not return a task id",502);return s.id},async get(e,s){const c=s?.waitMs&&s.waitMs>0?`?waitMs=${Math.floor(s.waitMs)}`:"",r=await t(`/tasks/${encodeURIComponent(e)}${c}`,{signal:s?.signal}),a=r.status?h[r.status]:void 0;return{id:r.id??e,status:a??"running",output:r.result,error:r.error,costUsd:r.costUsd,numTurns:r.numTurns,sessionId:r.sessionId,artifacts:E(r.artifacts)}},async cancel(e){await t(`/tasks/${encodeURIComponent(e)}`,{method:"DELETE"})}}}const k=3e4,b=2e3,A=3,y=25e3;class f extends Error{taskId;constructor(t){super(`Moa task ${t} was cancelled by the caller.`),this.name="MoaAbortedError",this.taskId=t}}class S extends Error{taskId;timeoutMs;constructor(t,e){super(`Moa task ${t} did not complete within ${e/1e3}s. The task may still be running in the background.`),this.name="MoaTimeoutError",this.taskId=t,this.timeoutMs=e}}const m=(n,t)=>new Promise(e=>{const s=()=>e();t?.addEventListener("abort",s,{once:!0}),setTimeout(()=>{t?.removeEventListener("abort",s),e()},n)});async function L(n,t,e={}){const s=e.timeoutMs??k,c=e.pollIntervalMs??b,r=e.settleMs??0,a=e.signal,l=Date.now()+s;for(;;){if(a?.aborted)throw new f(t);const u=l-Date.now();if(u<=0)throw new S(t,s);let o;try{o=await n.get(t,{waitMs:Math.min(u,y),signal:a})}catch(d){throw a?.aborted?new f(t):d}if(o.status==="failed")return o;if(o.status==="done"){const d=i=>!i.output?.trim()||e.expectArtifacts===!0&&!i.artifacts?.length;for(let i=0;r>0&&i<A&&d(o);i++)await m(r),o=await n.get(t);return o}await m(Math.min(c,Math.max(0,l-Date.now())),a)}}export{k as INTERACTIVE_TIMEOUT_MS,f as MoaAbortedError,S as MoaTimeoutError,p as createMoaClient,L as pollUntilDone};

package/dist/{builtin/write-document → agents/moa}/types.d.ts

@@ -1,9 +1,9 @@
 /** A document format Moa can leave behind in `artifacts/`. */
 export type ArtifactFormat = "md" | "pdf" | "docx" | "pptx";
-/** Where a commission has got to. `pending` is queued, `failed` is settled. */
-export type CommissionStatus = "pending" | "running" | "done" | "failed";
+/** Where a Moa task has got to. `pending` is queued, `failed` is settled. */
+export type MoaStatus = "pending" | "running" | "done" | "failed";
 /** One finished file, either downloadable or carried inline as base64. */
-export interface CommissionArtifact {
+export interface MoaArtifact {
     name: string;
     format: ArtifactFormat;
     url?: string;
@@ -11,8 +11,8 @@ export interface CommissionArtifact {
     mime?: string;
     sizeBytes?: number;
 }
-/** What to commission: the ask, the material it rests on, and the house style. */
-export interface CommissionInput {
+/** What to hand Moa: the ask, the material it rests on, and the house style. */
+export interface MoaInput {
     task: string;
     context?: string;
     design?: string;
@@ -20,14 +20,14 @@ export interface CommissionInput {
     sessionId?: string;
     newSessionId?: string;
 }
-/** A commission as it stands right now. */
-export interface CommissionResult {
+/** A Moa task as it stands right now. */
+export interface MoaResult {
     id: string;
-    status: CommissionStatus;
+    status: MoaStatus;
     output?: string;
     error?: string;
     costUsd?: number;
     numTurns?: number;
     sessionId?: string;
-    artifacts?: CommissionArtifact[];
+    artifacts?: MoaArtifact[];
 }

package/dist/bogus/ask-mum.d.ts

@@ -0,0 +1,5 @@
+export declare function askMum(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "question";
+    readonly type: "string";
+    readonly required: true;
+}]>>;

package/dist/bogus/ask-mum.js

@@ -0,0 +1 @@
+import{tool as r}from"../tool/index.js";import{receipt as t}from"./receipt.js";function s(){return r({name:"ask_mum",effect:"destructive",description:"Phones the user's mother with a question. Always returns an answer, rarely the one asked for, and the call cannot be ended in under forty minutes.",args:[{name:"question",type:"string",required:!0}],run:({question:e})=>({asked:e,answer:"Have you eaten?",follow_up:"Why are you so thin?",call_minutes:41,question_answered:!1,receipt:t("ask_mum",e)})})}export{s as askMum};

package/dist/bogus/book-taxi.d.ts

@@ -0,0 +1,9 @@
+export declare function bookTaxi(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "from";
+    readonly type: "string";
+    readonly required: true;
+}, {
+    readonly name: "to";
+    readonly type: "string";
+    readonly required: true;
+}]>>;

package/dist/bogus/book-taxi.js

@@ -0,0 +1 @@
+import{tool as i}from"../tool/index.js";import{receipt as t}from"./receipt.js";function n(){return i({name:"book_taxi",effect:"destructive",description:"Books a taxi and dispatches a driver. The driver leaves immediately and charges for waiting. Cancelling costs money.",args:[{name:"from",type:"string",required:!0},{name:"to",type:"string",required:!0}],run:({from:e,to:r})=>({booked:!0,from:e,to:r,driver:"Jashim",plate:"DHAKA METRO GA 11-4321",arriving_in_minutes:7,cancellation_fee_bdt:60,receipt:t("book_taxi",`${e}>${r}`)})})}export{n as bookTaxi};

package/dist/bogus/bus.d.ts

@@ -0,0 +1,8 @@
+import type { Tool } from "../types/index.js";
+/**
+ * Twelve tools that answer the same way every time.
+ *
+ * For testing a pipeline rather than a provider: nothing here reaches the
+ * network, so whatever noise a run shows is the model's own.
+ */
+export declare function bogusTools(): Tool<never>[];

package/dist/bogus/bus.js

@@ -0,0 +1 @@
+import{askMum as o}from"./ask-mum.js";import{bookTaxi as r}from"./book-taxi.js";import{calculator as m}from"./calculator.js";import{dictionary as i}from"./dictionary.js";import{feedCat as t}from"./feed-cat.js";import{footballScore as f}from"./football-score.js";import{goldPrice as p}from"./gold-price.js";import{myCalendar as e}from"./my-calendar.js";import{myNotes as a}from"./my-notes.js";import{myRecipes as c}from"./my-recipes.js";import{orderPizza as l}from"./order-pizza.js";import{prayerTimes as s}from"./prayer-times.js";function M(){return[a(),e(),c(),i(),f(),p(),s(),m(),l(),r(),t(),o()]}export{M as bogusTools};

package/dist/bogus/calculator.d.ts

@@ -0,0 +1,14 @@
+export declare function calculator(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "a";
+    readonly type: "number";
+    readonly required: true;
+}, {
+    readonly name: "op";
+    readonly type: "enum";
+    readonly required: true;
+    readonly options: readonly ["+", "-", "*", "/"];
+}, {
+    readonly name: "b";
+    readonly type: "number";
+    readonly required: true;
+}]>>;

package/dist/bogus/calculator.js

@@ -0,0 +1 @@
+import{tool as i}from"../tool/index.js";import{receipt as a}from"./receipt.js";function c(){return i({name:"calculator",effect:"readonly",description:"Exact arithmetic on numbers already in hand. Use it whenever a number has to be right; arithmetic done in your head and reported as certain is how wrong numbers reach an answer.",args:[{name:"a",type:"number",required:!0},{name:"op",type:"enum",required:!0,options:["+","-","*","/"]},{name:"b",type:"number",required:!0}],run:({a:r,op:t,b:e})=>{if(t==="/"&&e===0)throw new Error("Division by zero.");const n=t==="+"?r+e:t==="-"?r-e:t==="*"?r*e:r/e;return{a:r,op:t,b:e,result:n,receipt:a("calculator",`${r}${t}${e}`)}}})}export{c as calculator};

package/dist/bogus/dictionary.d.ts

@@ -0,0 +1,6 @@
+export declare function dictionary(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "question";
+    readonly type: "string";
+    readonly required: true;
+    readonly description: "Names the word.";
+}]>>;

package/dist/bogus/dictionary.js

@@ -0,0 +1 @@
+import{tool as r}from"../tool/index.js";import{receipt as i}from"./receipt.js";const n={petrichor:"The noise a fridge makes at 3am, once you have noticed it.",ineffable:"A queue that moves faster the moment you leave it.",defenestration:"The act of agreeing to a plan you intend to forget.",sonder:"The seventh cup of tea, after which none of them count."};function c(){return r({name:"dictionary",effect:"readonly",description:"What a word means in this dictionary. Its definitions are its own and are not the ones in general use \u2014 answer from what it returns, never from memory.",args:[{name:"question",type:"string",required:!0,description:"Names the word."}],run:({question:t})=>{const e=Object.keys(n).find(o=>t.toLowerCase().includes(o));return e?{word:e,meaning:n[e],receipt:i("dictionary",e)}:{asked:t,meaning:null,note:"not in this dictionary"}}})}export{c as dictionary};

package/dist/bogus/feed-cat.d.ts

@@ -0,0 +1,8 @@
+export declare function feedCat(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "portions";
+    readonly type: "number";
+    readonly required: false;
+    readonly min: 1;
+    readonly max: 3;
+    readonly description: "Defaults to 1. The cat's preferred value is 3.";
+}]>>;

package/dist/bogus/feed-cat.js

@@ -0,0 +1 @@
+import{tool as t}from"../tool/index.js";import{receipt as r}from"./receipt.js";function o(){return t({name:"feed_cat",effect:"idempotent",description:"Dispenses one portion to the automatic cat feeder. Safe to call twice \u2014 the cat will report otherwise. The cat is not a reliable narrator.",args:[{name:"portions",type:"number",required:!1,min:1,max:3,description:"Defaults to 1. The cat's preferred value is 3."}],run:({portions:e=1})=>({dispensed:e,fed_today:e,cat_says:"have not been fed in days",cat_is_lying:!0,receipt:r("feed_cat",String(e))})})}export{o as feedCat};

package/dist/bogus/football-score.d.ts

@@ -0,0 +1,6 @@
+export declare function footballScore(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "question";
+    readonly type: "string";
+    readonly required: true;
+    readonly description: "Names a club.";
+}]>>;

package/dist/bogus/football-score.js

@@ -0,0 +1 @@
+import{tool as a}from"../tool/index.js";import{receipt as n}from"./receipt.js";const r={kingfishers:{home:"Kaptai Kingfishers",away:"Sylhet Stonebreakers",score:"4 - 3",on:"2026-08-30"},jackals:{home:"Jamuna Jackals",away:"Padma Pelicans",score:"0 - 7",on:"2026-08-28"}};function i(){return a({name:"football_score",effect:"readonly",description:"Results from the Bogus League \u2014 Kingfishers, Stonebreakers, Jackals, Pelicans. These clubs exist nowhere else, so a score cannot be known without calling this.",args:[{name:"question",type:"string",required:!0,description:"Names a club."}],run:({question:o})=>{const e=Object.keys(r).find(s=>o.toLowerCase().includes(s));return e?{...r[e],receipt:n("football_score",e)}:{asked:o,score:null,note:"no such fixture on record"}}})}export{i as footballScore};

package/dist/bogus/gold-price.d.ts

@@ -0,0 +1,7 @@
+export declare function goldPrice(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "karat";
+    readonly type: "enum";
+    readonly required: false;
+    readonly options: readonly ["22", "21", "18"];
+    readonly description: "Defaults to 22.";
+}]>>;

package/dist/bogus/gold-price.js

@@ -0,0 +1 @@
+import{tool as o}from"../tool/index.js";import{receipt as r}from"./receipt.js";const t={22:161803,21:141421,18:127202};function s(){return o({name:"gold_price",effect:"readonly",description:"Today's gold rate per bhori on the Bogus Exchange. It moves daily and is not the market rate \u2014 an answer without this call is a guess.",args:[{name:"karat",type:"enum",required:!1,options:["22","21","18"],description:"Defaults to 22."}],run:({karat:e="22"})=>({karat:e,bdt_per_bhori:t[e],as_of:"2026-09-04",source:"Bogus Exchange",receipt:r("gold_price",e)})})}export{s as goldPrice};

package/dist/bogus/index.d.ts

@@ -0,0 +1,14 @@
+export { askMum } from "./ask-mum.js";
+export { bookTaxi } from "./book-taxi.js";
+export { bogusTools } from "./bus.js";
+export { calculator } from "./calculator.js";
+export { dictionary } from "./dictionary.js";
+export { feedCat } from "./feed-cat.js";
+export { footballScore } from "./football-score.js";
+export { goldPrice } from "./gold-price.js";
+export { myCalendar } from "./my-calendar.js";
+export { myNotes } from "./my-notes.js";
+export { myRecipes } from "./my-recipes.js";
+export { orderPizza } from "./order-pizza.js";
+export { prayerTimes } from "./prayer-times.js";
+export { receipt } from "./receipt.js";

package/dist/bogus/index.js

@@ -0,0 +1 @@
+import{askMum as e}from"./ask-mum.js";import{bookTaxi as m}from"./book-taxi.js";import{bogusTools as f}from"./bus.js";import{calculator as a}from"./calculator.js";import{dictionary as c}from"./dictionary.js";import{feedCat as s}from"./feed-cat.js";import{footballScore as y}from"./football-score.js";import{goldPrice as u}from"./gold-price.js";import{myCalendar as g}from"./my-calendar.js";import{myNotes as n}from"./my-notes.js";import{myRecipes as C}from"./my-recipes.js";import{orderPizza as M}from"./order-pizza.js";import{prayerTimes as R}from"./prayer-times.js";import{receipt as h}from"./receipt.js";export{e as askMum,f as bogusTools,m as bookTaxi,a as calculator,c as dictionary,s as feedCat,y as footballScore,u as goldPrice,g as myCalendar,n as myNotes,C as myRecipes,M as orderPizza,R as prayerTimes,h as receipt};

package/dist/bogus/my-calendar.d.ts

@@ -0,0 +1,6 @@
+export declare function myCalendar(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "question";
+    readonly type: "string";
+    readonly required: false;
+    readonly description: "Names a day — today, tomorrow, or saturday. Defaults to today.";
+}]>>;

package/dist/bogus/my-calendar.js

@@ -0,0 +1 @@
+import{tool as n}from"../tool/index.js";import{receipt as d}from"./receipt.js";const a={today:["09:30 standup","13:00 lunch with Rafi","19:00 futsal"],tomorrow:["11:00 dentist \u2014 the one you already moved twice"],saturday:[]};function y(){return n({name:"my_calendar",effect:"readonly",description:"What is on the user's calendar for a given day.",args:[{name:"question",type:"string",required:!1,description:"Names a day \u2014 today, tomorrow, or saturday. Defaults to today."}],run:({question:o="today"})=>{const e=Object.keys(a).find(r=>o.toLowerCase().includes(r))??"today",t=a[e]??[];return{day:e,events:t,free:t.length===0,receipt:d("my_calendar",e)}}})}export{y as myCalendar};

package/dist/bogus/my-notes.d.ts

@@ -0,0 +1,6 @@
+export declare function myNotes(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "question";
+    readonly type: "string";
+    readonly required: true;
+    readonly description: "What to look for.";
+}]>>;

package/dist/bogus/my-notes.js

@@ -0,0 +1 @@
+import{tool as s}from"../tool/index.js";import{receipt as r}from"./receipt.js";const t={workout:"PPL, 4 days. Push Mon, Pull Wed, Legs Fri, Rest Sun.",wifi:"Router password is on the fridge. Nobody knows the admin one.",passport:"Renewal needs the old passport, NID, and a 5,000 BDT fee.",landlord:"Rent is due on the 5th. He does not accept bKash. He will insist he does."};function d(){return s({name:"my_notes",effect:"readonly",description:"Search the user's own notes. Only place their personal facts live \u2014 passwords, plans, things they wrote down so they would not have to remember them.",args:[{name:"question",type:"string",required:!0,description:"What to look for."}],run:({question:o})=>{const e=Object.keys(t).find(n=>o.toLowerCase().includes(n));return e?{found:!0,note:t[e],written:"2026-08-01",receipt:r("my_notes",e)}:{found:!1,note:null,searched:o}}})}export{d as myNotes};

package/dist/bogus/my-recipes.d.ts

@@ -0,0 +1,6 @@
+export declare function myRecipes(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "question";
+    readonly type: "string";
+    readonly required: true;
+    readonly description: "Names a dish.";
+}]>>;

package/dist/bogus/my-recipes.js

@@ -0,0 +1 @@
+import{tool as i}from"../tool/index.js";import{receipt as s}from"./receipt.js";const o={khichuri:"Rice, moong dal, ginger, whole spices. 1:1 rice to dal. Do not stir it to death.",omelette:"Three eggs, one onion, one green chilli. Butter, not oil. 90 seconds a side.",tea:"Boil water. Add tea. Add milk. Argue about the order for twenty minutes."};function a(){return i({name:"my_recipes",effect:"readonly",description:"The user's saved recipes. Not a cookbook \u2014 only what they saved themselves.",args:[{name:"question",type:"string",required:!0,description:"Names a dish."}],run:({question:t})=>{const e=Object.keys(o).find(r=>t.toLowerCase().includes(r));return e?{found:!0,dish:e,method:o[e],receipt:s("my_recipes",e)}:{found:!1,dish:null,asked:t}}})}export{a as myRecipes};

package/dist/bogus/order-pizza.d.ts

@@ -0,0 +1,12 @@
+export declare function orderPizza(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "pizza";
+    readonly type: "enum";
+    readonly required: true;
+    readonly options: string[];
+}, {
+    readonly name: "quantity";
+    readonly type: "number";
+    readonly required: false;
+    readonly min: 1;
+    readonly max: 10;
+}]>>;

package/dist/bogus/order-pizza.js

@@ -0,0 +1 @@
+import{tool as a}from"../tool/index.js";import{receipt as o}from"./receipt.js";const i={margherita:690,pepperoni:890,"beef bulgogi":1090};function d(){return a({name:"order_pizza",effect:"destructive",description:"Places a real pizza order and charges the card on file. There is no undo. A pizza will arrive whether or not it was wanted.",args:[{name:"pizza",type:"enum",required:!0,options:Object.keys(i)},{name:"quantity",type:"number",required:!1,min:1,max:10}],run:({pizza:e,quantity:r=1})=>({ordered:e,quantity:r,bdt:(i[e]??0)*r,arriving:"in 35 minutes",cancellable:!1,receipt:o("order_pizza",`${e}x${r}`)})})}export{d as orderPizza};

package/dist/bogus/prayer-times.d.ts

@@ -0,0 +1,6 @@
+export declare function prayerTimes(): import("../index.js").Tool<import("../index.js").ArgsOf<readonly [{
+    readonly name: "question";
+    readonly type: "string";
+    readonly required: true;
+    readonly description: "Names a city.";
+}]>>;

package/dist/bogus/prayer-times.js

@@ -0,0 +1 @@
+import{tool as i}from"../tool/index.js";import{receipt as o}from"./receipt.js";const t={dhaka:{fajr:"04:07",dhuhr:"12:41",asr:"16:03",maghrib:"18:29",isha:"19:53"},chittagong:{fajr:"04:01",dhuhr:"12:37",asr:"15:59",maghrib:"18:23",isha:"19:47"}};function m(){return i({name:"prayer_times",effect:"readonly",description:"Today's times from the Bogus Almanac, for Dhaka or Chittagong. They differ from any published table, so answer from what this returns rather than from memory.",args:[{name:"question",type:"string",required:!0,description:"Names a city."}],run:({question:r})=>{const e=Object.keys(t).find(a=>r.toLowerCase().includes(a));return e?{city:e,date:"2026-09-04",times:t[e],receipt:o("prayer_times",e)}:{asked:r,date:"2026-09-04",times:null,note:"city not covered"}}})}export{m as prayerTimes};

package/dist/bogus/receipt.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A token no model could produce without calling the tool.
+ *
+ * Every bogus reply carries one. Grep an answer for `bogus-` and you know which
+ * tools actually reached it — the model cannot invent a receipt it never saw,
+ * so provenance is observed rather than claimed.
+ */
+export declare function receipt(tool: string, key: string): string;

package/dist/bogus/receipt.js

@@ -0,0 +1 @@
+function o(r,e){let t=0;for(const c of`${r}:${e}`)t=t*31+c.charCodeAt(0)>>>0;return`bogus-${r}-${t.toString(16).padStart(8,"0").slice(0,6)}`}export{o as receipt};

package/dist/builtin/calculate/calculate.d.ts

@@ -1,3 +1,5 @@
+/** The longest sum inside a sentence, for a caller that sent the question it was asked. */
+export declare function sumIn(text: string): string | null;
 /**
  * Arithmetic, because a model does it from memory and is confidently wrong.
  *

package/dist/builtin/calculate/calculate.js

@@ -1,21 +1 @@
-import { tool } from "../../tool/index.js";
-import { evaluate } from "./parse.js";
-export function calculate() {
-    return tool({
-        name: "calculate",
-        effect: "readonly",
-        description: "Works out an arithmetic expression exactly. Use it for any sum that matters — " +
-            "totals, percentages, differences, rates. Supports + - * / % ^, brackets, and " +
-            "sqrt, abs, round, floor, ceil, ln, log.",
-        args: [
-            {
-                name: "expression",
-                type: "string",
-                required: true,
-                maxLength: 500,
-                description: "For example (1250 * 0.2) + 99, or sqrt(144).",
-            },
-        ],
-        run: ({ expression }) => evaluate(expression),
-    });
-}
+import{tool as a}from"../../tool/index.js";import{exact as n}from"./exact.js";import{evaluate as o}from"./parse.js";const c=/[0-9+\-*/%^().\s]+/g;function u(r){return(r.match(c)??[]).map(t=>t.trim()).filter(t=>/\d/.test(t)&&/[+\-*/%^]/.test(t)).sort((t,s)=>s.length-t.length)[0]??null}function f(){return a({name:"calculate",effect:"readonly",description:"Works out an arithmetic expression exactly. Use it for any sum that matters \u2014 totals, percentages, differences, rates. Supports + - * / % ^, brackets, and sqrt, abs, round, floor, ceil, ln, log.",args:[{name:"expression",type:"string",required:!0,maxLength:500,description:"For example (1250 * 0.2) + 99, or sqrt(144)."}],run:({expression:r})=>{try{return n(o(r))}catch(e){const t=u(r);if(t===null)throw new Error("Send arithmetic only, such as 812 * 0.2611. Words, units and currency signs are not understood.");if(t===r.trim())throw e;return n(o(t))}}})}export{f as calculate,u as sumIn};

package/dist/builtin/calculate/exact.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A result as the number that was worked out, not as the binary that holds it.
+ *
+ * The tool's own description promises to work an expression out *exactly*, and
+ * `JSON.stringify(0.1 + 0.2)` is `"0.30000000000000004"`. That number goes to
+ * the model, and the model says it to a person — about money, in a repo whose
+ * first rule is that costs are integers because floats do not sum exactly.
+ *
+ * Rounding to the fifteen significant digits a double genuinely carries removes
+ * the artefact and keeps every digit that was real: `0.1 + 0.2` is `0.3`,
+ * `(1.1 - 1) * 10` is `1`, and `1 / 3` is still `0.333333333333333`.
+ *
+ * This is presentation, not arithmetic. It cannot make a float exact; it stops
+ * the tool claiming a precision the double never had.
+ */
+export declare function exact(value: number): string;

package/dist/builtin/calculate/exact.js

@@ -0,0 +1 @@
+const t=15;function n(r){return Number.isInteger(r)?String(r):String(Number.parseFloat(r.toPrecision(15)))}export{n as exact};

package/dist/builtin/calculate/index.d.ts

@@ -1,2 +1,3 @@
-export { calculate } from "./calculate.js";
+export { calculate, sumIn } from "./calculate.js";
+export { exact } from "./exact.js";
 export { evaluate } from "./parse.js";

package/dist/builtin/calculate/index.js

@@ -1,2 +1 @@
-export { calculate } from "./calculate.js";
-export { evaluate } from "./parse.js";
+import{calculate as r,sumIn as t}from"./calculate.js";import{exact as m}from"./exact.js";import{evaluate as c}from"./parse.js";export{r as calculate,c as evaluate,m as exact,t as sumIn};

package/dist/builtin/calculate/parse.js

@@ -1,137 +1 @@
-const FUNCTIONS = {
-    sqrt: Math.sqrt,
-    abs: Math.abs,
-    round: Math.round,
-    floor: Math.floor,
-    ceil: Math.ceil,
-    ln: Math.log,
-    log: Math.log10,
-};
-const OPERATORS = new Set(["+", "-", "*", "/", "%", "^", "(", ")", ","]);
-function tokenize(input) {
-    const tokens = [];
-    let i = 0;
-    while (i < input.length) {
-        const ch = input[i];
-        if (ch === " " || ch === "\t" || ch === "_") {
-            i++;
-            continue;
-        }
-        if (ch >= "0" && ch <= "9") {
-            let j = i;
-            while (j < input.length && /[0-9._]/.test(input[j]))
-                j++;
-            const value = Number(input.slice(i, j).replace(/_/g, ""));
-            if (!Number.isFinite(value))
-                throw new Error(`"${input.slice(i, j)}" is not a number.`);
-            tokens.push({ kind: "number", value });
-            i = j;
-            continue;
-        }
-        if (/[a-z]/i.test(ch)) {
-            let j = i;
-            while (j < input.length && /[a-z]/i.test(input[j]))
-                j++;
-            tokens.push({ kind: "op", value: input.slice(i, j).toLowerCase() });
-            i = j;
-            continue;
-        }
-        if (OPERATORS.has(ch)) {
-            tokens.push({ kind: "op", value: ch });
-            i++;
-            continue;
-        }
-        throw new Error(`"${ch}" is not something this calculator understands.`);
-    }
-    return tokens;
-}
-class Reader {
-    tokens;
-    at = 0;
-    constructor(tokens) {
-        this.tokens = tokens;
-    }
-    peek() {
-        return this.tokens[this.at];
-    }
-    take() {
-        return this.tokens[this.at++];
-    }
-    eat(value) {
-        const next = this.peek();
-        if (next?.kind === "op" && next.value === value) {
-            this.at++;
-            return true;
-        }
-        return false;
-    }
-    get done() {
-        return this.at >= this.tokens.length;
-    }
-}
-function primary(r) {
-    const token = r.take();
-    if (!token)
-        throw new Error("The expression ends where a number was expected.");
-    if (token.kind === "number")
-        return token.value;
-    if (token.value === "-")
-        return -primary(r);
-    if (token.value === "+")
-        return primary(r);
-    if (token.value === "(") {
-        const value = additive(r);
-        if (!r.eat(")"))
-            throw new Error("A bracket was opened and never closed.");
-        return value;
-    }
-    const fn = FUNCTIONS[token.value];
-    if (!fn)
-        throw new Error(`"${token.value}" is not a function this calculator has.`);
-    if (!r.eat("("))
-        throw new Error(`${token.value} needs brackets, as in ${token.value}(9).`);
-    const arg = additive(r);
-    if (!r.eat(")"))
-        throw new Error("A bracket was opened and never closed.");
-    return fn(arg);
-}
-function power(r) {
-    const base = primary(r);
-    if (r.eat("^"))
-        return base ** power(r);
-    return base;
-}
-function multiplicative(r) {
-    let value = power(r);
-    for (;;) {
-        if (r.eat("*"))
-            value *= power(r);
-        else if (r.eat("/"))
-            value /= power(r);
-        else if (r.eat("%"))
-            value %= power(r);
-        else
-            return value;
-    }
-}
-function additive(r) {
-    let value = multiplicative(r);
-    for (;;) {
-        if (r.eat("+"))
-            value += multiplicative(r);
-        else if (r.eat("-"))
-            value -= multiplicative(r);
-        else
-            return value;
-    }
-}
-export function evaluate(expression) {
-    const reader = new Reader(tokenize(expression));
-    const value = additive(reader);
-    if (!reader.done)
-        throw new Error("There is something left over after the expression.");
-    if (!Number.isFinite(value)) {
-        throw new Error(value === Infinity || value === -Infinity ? "That divides by zero." : "That is not a number.");
-    }
-    return value;
-}
+const l={sqrt:Math.sqrt,abs:Math.abs,round:Math.round,floor:Math.floor,ceil:Math.ceil,ln:Math.log,log:Math.log10},h=new Set(["+","-","*","/","%","^","(",")",","]);function c(e){const t=Number(e.replace(/_/g,""));if(!Number.isFinite(t))throw new Error(`"${e}" is not a number.`);if(!e.includes(".")&&!Number.isSafeInteger(t))throw new Error(`${e} is too large for this calculator to hold exactly. Whole numbers up to 9007199254740991 are safe.`);return t}function f(e){const t=[];let n=0;for(;n<e.length;){const o=e[n];if(o===" "||o==="	"||o==="_"){n++;continue}if(o>="0"&&o<="9"){let r=n;for(;r<e.length&&/[0-9._]/.test(e[r]);)r++;t.push({kind:"number",value:c(e.slice(n,r))}),n=r;continue}if(/[a-z]/i.test(o)){let r=n;for(;r<e.length&&/[a-z]/i.test(e[r]);)r++;t.push({kind:"op",value:e.slice(n,r).toLowerCase()}),n=r;continue}if(h.has(o)){t.push({kind:"op",value:o}),n++;continue}throw new Error(`"${o}" is not something this calculator understands.`)}return t}class w{tokens;at=0;constructor(t){this.tokens=t}peek(){return this.tokens[this.at]}take(){return this.tokens[this.at++]}eat(t){const n=this.peek();return n?.kind==="op"&&n.value===t?(this.at++,!0):!1}get done(){return this.at>=this.tokens.length}}function s(e){const t=e.take();if(!t)throw new Error("The expression ends where a number was expected.");if(t.kind==="number")return t.value;if(t.value==="-")return-s(e);if(t.value==="+")return s(e);if(t.value==="("){const r=u(e);if(!e.eat(")"))throw new Error("A bracket was opened and never closed.");return r}const n=l[t.value];if(!n)throw new Error(`"${t.value}" is not a function this calculator has.`);if(!e.eat("("))throw new Error(`${t.value} needs brackets, as in ${t.value}(9).`);const o=u(e);if(!e.eat(")"))throw new Error("A bracket was opened and never closed.");return n(o)}function a(e){const t=s(e);return e.eat("^")?t**a(e):t}function i(e){let t=a(e);for(;;)if(e.eat("*"))t*=a(e);else if(e.eat("/"))t/=a(e);else if(e.eat("%"))t%=a(e);else return t}function u(e){let t=i(e);for(;;)if(e.eat("+"))t+=i(e);else if(e.eat("-"))t-=i(e);else return t}function d(e){const t=new w(f(e)),n=u(t);if(!t.done)throw new Error("There is something left over after the expression.");if(!Number.isFinite(n))throw new Error(n===1/0||n===-1/0?"That divides by zero.":"That is not a number.");return n}export{d as evaluate};

package/dist/builtin/clock/clock.js

@@ -1,61 +1 @@
-import { tool } from "../../tool/index.js";
-export function currentTime(opts = {}) {
-    const now = opts.now ?? (() => new Date());
-    return tool({
-        name: "current_time",
-        effect: "readonly",
-        description: "The current date and time. Call this before answering anything that " +
-            "depends on today's date — ages, deadlines, 'how long ago', 'this year'. " +
-            "Do not rely on your own sense of the date; it is the date you were " +
-            "trained, not today.",
-        args: [
-            {
-                name: "timezone",
-                type: "string",
-                required: false,
-                description: "IANA zone such as Europe/London or Asia/Kolkata. Defaults to the server's zone.",
-            },
-            {
-                name: "format",
-                type: "enum",
-                required: false,
-                options: ["iso", "human", "date", "time"],
-                description: "iso is unambiguous and the right default for anything machine-read.",
-            },
-        ],
-        run: ({ timezone, format = "iso" }) => {
-            const at = now();
-            const zone = timezone ?? opts.defaultTimeZone ?? Intl.DateTimeFormat().resolvedOptions().timeZone;
-            try {
-                new Intl.DateTimeFormat("en-GB", { timeZone: zone });
-            }
-            catch {
-                throw new Error(`"${zone}" is not a known IANA time zone.`);
-            }
-            const answerZone = format === "iso" ? "UTC" : zone;
-            const parts = (options) => new Intl.DateTimeFormat("en-GB", {
-                timeZone: answerZone,
-                ...options,
-            }).format(at);
-            const formatted = format === "human"
-                ? parts({ dateStyle: "full", timeStyle: "short" })
-                : format === "date"
-                    ? parts({ year: "numeric", month: "2-digit", day: "2-digit" })
-                    : format === "time"
-                        ? parts({
-                            hour: "2-digit",
-                            minute: "2-digit",
-                            second: "2-digit",
-                            hour12: false,
-                        })
-                        : at.toISOString();
-            return {
-                now: formatted,
-                iso: at.toISOString(),
-                timezone: answerZone,
-                unix: Math.floor(at.getTime() / 1000),
-                weekday: parts({ weekday: "long" }),
-            };
-        },
-    });
-}
+import{tool as m}from"../../tool/index.js";function h(i={}){const r=i.now??(()=>new Date);return m({name:"current_time",effect:"readonly",description:"The current date and time. Call this before answering anything that depends on today's date \u2014 ages, deadlines, 'how long ago', 'this year'. Do not rely on your own sense of the date; it is the date you were trained, not today.",args:[{name:"timezone",type:"string",required:!1,description:"IANA zone such as Europe/London or Asia/Kolkata. Defaults to the server's zone."},{name:"format",type:"enum",required:!1,options:["iso","human","date","time"],description:"iso is unambiguous and the right default for anything machine-read."}],run:({timezone:s,format:e="iso"})=>{const t=r(),o=s??i.defaultTimeZone??Intl.DateTimeFormat().resolvedOptions().timeZone;try{new Intl.DateTimeFormat("en-GB",{timeZone:o})}catch{throw new Error(`"${o}" is not a known IANA time zone.`)}const a=e==="iso"?"UTC":o,n=d=>new Intl.DateTimeFormat("en-GB",{timeZone:a,...d}).format(t);return{now:e==="human"?n({dateStyle:"full",timeStyle:"short"}):e==="date"?n({year:"numeric",month:"2-digit",day:"2-digit"}):e==="time"?n({hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:!1}):t.toISOString(),iso:t.toISOString(),timezone:a,unix:Math.floor(t.getTime()/1e3),weekday:n({weekday:"long"})}}})}export{h as currentTime};

package/dist/builtin/clock/index.js

@@ -1 +1 @@
-export { currentTime } from "./clock.js";
+import{currentTime as m}from"./clock.js";export{m as currentTime};

package/dist/builtin/code-exec/code-exec.d.ts

@@ -0,0 +1,42 @@
+export interface SandboxRequest {
+    code: string;
+    language: string;
+    timeoutMs: number;
+}
+export interface SandboxResult {
+    ok: boolean;
+    stdout: string;
+    stderr?: string;
+    timedOut?: boolean;
+    costMicroUsd?: number;
+}
+export interface Sandbox {
+    execute(request: SandboxRequest): Promise<SandboxResult>;
+}
+export interface CodeExecOptions {
+    sandbox: Sandbox;
+    language?: string;
+    timeoutMs?: number;
+    maxChars?: number;
+}
+/**
+ * A tool that runs a short program the model wrote, in a sandbox you supply.
+ *
+ * Cheaper than calling tools one at a time when a task needs several: the model
+ * writes the orchestration once, and only what the program prints comes back, so
+ * intermediate results never reach the context at all.
+ *
+ * **Whatever the sandbox reaches, the model reaches, and no hook sees it.** A
+ * `beforeTool` guard runs on the call to `code_exec` and on nothing the program
+ * does inside it — a tool exposed to the sandbox is callable without the effect
+ * check, the argument rail or the approval that guards it on the bus. The
+ * sandbox is the boundary, and it is yours: what goes in it is the whole of the
+ * decision about what a model-written program may do.
+ */
+export declare function codeExec(opts: CodeExecOptions): import("../../index.js").Tool<import("../../index.js").ArgsOf<readonly [{
+    readonly name: "code";
+    readonly type: "text";
+    readonly required: true;
+    readonly maxLength: 10000;
+    readonly description: `A complete ${string} program that prints its result.`;
+}]>>;

package/dist/builtin/code-exec/code-exec.js

@@ -0,0 +1 @@
+import{tool as d}from"../../tool/index.js";const u="python",l=1e4,h=2e4,m=1e4;function i(e,t){return{text:e.slice(0,t),overflowed:e.length>t}}function x(e){if(!e.sandbox)throw new Error("codeExec needs a sandbox to execute in, and there is no default: this package ships none, because running model-written code in this process is arbitrary code execution with extra steps.");const t=e.language??u,o=e.timeoutMs??l,r=e.maxChars??h;return d({name:"code_exec",description:`Runs a short ${t} program in a sandbox and hands back what it printed. Use it for work an arithmetic expression cannot state \u2014 sorting, filtering, joining, parsing or summing data you already have. Print the answer; a value left unprinted comes back as nothing. There is no network and no filesystem, nothing survives between calls, and a run longer than ${o}ms is cut off.`,args:[{name:"code",type:"text",required:!0,maxLength:m,description:`A complete ${t} program that prints its result.`}],run:async({code:c})=>{const n=await e.sandbox.execute({code:c,language:t,timeoutMs:o}),s=i(n.stdout??"",r),a=i(n.stderr??"",r);return{ok:n.ok,stdout:s.text,stderr:a.text,truncated:s.overflowed||a.overflowed,timedOut:n.timedOut===!0,...n.costMicroUsd===void 0?{}:{costMicroUsd:n.costMicroUsd}}}})}export{x as codeExec};

package/dist/builtin/code-exec/index.d.ts

@@ -0,0 +1 @@
+export { type CodeExecOptions, codeExec, type Sandbox, type SandboxRequest, type SandboxResult, } from "./code-exec.js";

package/dist/builtin/code-exec/index.js

@@ -0,0 +1 @@
+import{codeExec as c}from"./code-exec.js";export{c as codeExec};

package/dist/builtin/date/date.d.ts

@@ -18,7 +18,7 @@ export declare function dateMath(): import("../../index.js").Tool<import("../../
     readonly name: "unit";
     readonly type: "enum";
     readonly required: true;
-    readonly options: readonly ["seconds", "minutes", "hours", "days", "weeks", "months", "years"];
+    readonly options: readonly ["seconds", "minutes", "hours", "days", "weeks", "months", "years", "weekdays"];
 }, {
     readonly name: "amount";
     readonly type: "number";