@spendgraph/tools 0.5.0 → 0.6.0

package/dist/builtin/finish/index.js

@@ -1 +1 @@
-export { answerOf, finish, isFinished } from "./finish.js";
+import{answerOf as e,finish as f,isFinished as n}from"./finish.js";export{e as answerOf,f as finish,n as isFinished};

package/dist/builtin/http/allow.js

@@ -1,37 +1 @@
-const PRIVATE_V4 = /^(10\.|127\.|0\.|169\.254\.|192\.168\.|172\.(1[6-9]|2\d|3[01])\.|100\.(6[4-9]|[7-9]\d|1[01]\d|12[0-7])\.)/;
-const LOCAL_NAMES = new Set(["localhost", "metadata.google.internal"]);
-function isPrivateHost(host) {
-    const name = host.toLowerCase();
-    if (LOCAL_NAMES.has(name))
-        return true;
-    if (name.endsWith(".local") || name.endsWith(".internal") || name.endsWith(".localhost")) {
-        return true;
-    }
-    if (name.startsWith("["))
-        return true;
-    return PRIVATE_V4.test(name);
-}
-function matches(host, rule) {
-    const h = host.toLowerCase();
-    const r = rule.toLowerCase();
-    return r.startsWith(".") ? h === r.slice(1) || h.endsWith(r) : h === r;
-}
-export function checkUrl(raw, allow) {
-    let url;
-    try {
-        url = new URL(raw);
-    }
-    catch {
-        throw new Error(`"${raw}" is not a URL.`);
-    }
-    if (url.protocol !== "https:") {
-        throw new Error(`Only https is allowed, and this is ${url.protocol.replace(":", "")}.`);
-    }
-    if (isPrivateHost(url.hostname)) {
-        throw new Error(`${url.hostname} is a private or link-local address.`);
-    }
-    if (!allow.some((rule) => matches(url.hostname, rule))) {
-        throw new Error(`${url.hostname} is not in the allowlist: ${allow.join(", ")}.`);
-    }
-    return url;
-}
+const n=/^(10\.|127\.|0\.|169\.254\.|192\.168\.|172\.(1[6-9]|2\d|3[01])\.|100\.(6[4-9]|[7-9]\d|1[01]\d|12[0-7])\.)/,s=new Set(["localhost","metadata.google.internal"]);function i(r){const e=r.toLowerCase();return s.has(e)||e.endsWith(".local")||e.endsWith(".internal")||e.endsWith(".localhost")||e.startsWith("[")?!0:n.test(e)}function a(r,e){const t=r.toLowerCase(),o=e.toLowerCase();return o.startsWith(".")?t===o.slice(1)||t.endsWith(o):t===o}function h(r,e){let t;try{t=new URL(r)}catch{throw new Error(`"${r}" is not a URL.`)}if(t.protocol!=="https:")throw new Error(`Only https is allowed, and this is ${t.protocol.replace(":","")}.`);if(i(t.hostname))throw new Error(`${t.hostname} is a private or link-local address.`);if(!e.some(o=>a(t.hostname,o)))throw new Error(`${t.hostname} is not in the allowlist: ${e.join(", ")}.`);return t}export{h as checkUrl};

package/dist/builtin/http/http.js

@@ -1,41 +1 @@
-import { tool } from "../../tool/index.js";
-import { checkUrl } from "./allow.js";
-const DEFAULT_TIMEOUT_MS = 10_000;
-const DEFAULT_MAX_CHARS = 100_000;
-export function httpRequest(opts) {
-    if (!opts.allow?.length) {
-        throw new Error("httpRequest needs an allow list of hosts; there is no safe default.");
-    }
-    const doFetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
-    const maxChars = opts.maxChars ?? DEFAULT_MAX_CHARS;
-    return tool({
-        name: "http_request",
-        description: `Fetches a URL and returns its status and body. Only these hosts are reachable: ` +
-            `${opts.allow.join(", ")}. Use it to read an API or a page you have been pointed at.`,
-        args: [
-            { name: "url", type: "string", required: true, maxLength: 2000 },
-            { name: "method", type: "enum", required: false, options: ["GET", "POST"] },
-            { name: "body", type: "text", required: false, maxLength: 20_000 },
-        ],
-        run: async ({ url, method = "GET", body }) => {
-            const target = checkUrl(url, opts.allow);
-            const signal = AbortSignal.timeout(opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
-            const res = await doFetch(target, {
-                method,
-                signal,
-                headers: {
-                    ...opts.headers,
-                    ...(body ? { "content-type": "application/json" } : {}),
-                },
-                ...(body && method === "POST" ? { body } : {}),
-            });
-            const text = await res.text();
-            return {
-                status: res.status,
-                ok: res.ok,
-                body: text.slice(0, maxChars),
-                truncated: text.length > maxChars,
-            };
-        },
-    });
-}
+import{tool as w}from"../../tool/index.js";import{checkUrl as h}from"./allow.js";const p=1e4,T=1e5,u=3,d=t=>t.status>=300&&t.status<400;function _(t){if(!t.allow?.length)throw new Error("httpRequest needs an allow list of hosts; there is no safe default.");const m=t.fetch??globalThis.fetch.bind(globalThis),o=t.maxChars??T;return w({name:"http_request",description:`Fetches a URL and returns its status and body. Only these hosts are reachable: ${t.allow.join(", ")}. Use it to read an API or a page you have been pointed at.`,args:[{name:"url",type:"string",required:!0,maxLength:2e3},{name:"method",type:"enum",required:!1,options:["GET","POST"]},{name:"body",type:"text",required:!1,maxLength:2e4}],run:async({url:f,method:s="GET",body:n})=>{const r=h(f,t.allow),g=AbortSignal.timeout(t.timeoutMs??p),i=a=>m(a,{method:s,signal:g,redirect:"manual",headers:{...t.headers,...n?{"content-type":"application/json"}:{}},...n&&s==="POST"?{body:n}:{}});let e=await i(r);for(let a=0;a<u&&d(e);a++){const c=e.headers.get("location");if(!c)break;e=await i(h(new URL(c,e.url||r).toString(),t.allow))}if(d(e))throw new Error(`Gave up after ${u} redirects from ${r.hostname}.`);const l=await e.text();return{status:e.status,ok:e.ok,body:l.slice(0,o),truncated:l.length>o}}})}export{_ as httpRequest};

package/dist/builtin/http/index.js

@@ -1,2 +1 @@
-export { checkUrl } from "./allow.js";
-export { httpRequest } from "./http.js";
+import{checkUrl as t}from"./allow.js";import{httpRequest as p}from"./http.js";export{t as checkUrl,p as httpRequest};

package/dist/builtin/index.d.ts

@@ -1,7 +1,8 @@
 export { calculate, evaluate } from "./calculate/index.js";
 export { type ClockOptions, currentTime } from "./clock/index.js";
+export { type CodeExecOptions, codeExec, type Sandbox, type SandboxRequest, type SandboxResult, } from "./code-exec/index.js";
 export { dateMath } from "./date/index.js";
-export { type DeepRecallOptions, deepRecall } from "./deep-recall/index.js";
+export { type DeepRecallOptions, deepRecall, type RecalledFact, type Recaller, type RecallResult, } from "./deep-recall/index.js";
 export { type EscalateOptions, type EscalationRequest, escalate } from "./escalate/index.js";
 export { answerOf, type Finished, finish, isFinished } from "./finish/index.js";
 export { checkUrl, type HttpOptions, httpRequest } from "./http/index.js";

package/dist/builtin/index.js

@@ -1,11 +1 @@
-export { calculate, evaluate } from "./calculate/index.js";
-export { currentTime } from "./clock/index.js";
-export { dateMath } from "./date/index.js";
-export { deepRecall } from "./deep-recall/index.js";
-export { escalate } from "./escalate/index.js";
-export { answerOf, finish, isFinished } from "./finish/index.js";
-export { checkUrl, httpRequest } from "./http/index.js";
-export { jsonQuery } from "./json/index.js";
-export { think } from "./think/index.js";
-export { webSearch } from "./web-search/index.js";
-export { CommissionAbortedError, CommissionTimeoutError, DEFAULT_DESIGN, mergeDesign, renderDesign, writeDocument, } from "./write-document/index.js";
+import{calculate as o,evaluate as t}from"./calculate/index.js";import{currentTime as i}from"./clock/index.js";import{codeExec as p}from"./code-exec/index.js";import{dateMath as x}from"./date/index.js";import{deepRecall as a}from"./deep-recall/index.js";import{escalate as h}from"./escalate/index.js";import{answerOf as u,finish as d,isFinished as D}from"./finish/index.js";import{checkUrl as g,httpRequest as w}from"./http/index.js";import{jsonQuery as b}from"./json/index.js";import{think as A}from"./think/index.js";import{webSearch as F}from"./web-search/index.js";import{CommissionAbortedError as S,CommissionTimeoutError as U,DEFAULT_DESIGN as j,mergeDesign as q,renderDesign as v,writeDocument as y}from"./write-document/index.js";export{S as CommissionAbortedError,U as CommissionTimeoutError,j as DEFAULT_DESIGN,u as answerOf,o as calculate,g as checkUrl,p as codeExec,i as currentTime,x as dateMath,a as deepRecall,h as escalate,t as evaluate,d as finish,w as httpRequest,D as isFinished,b as jsonQuery,q as mergeDesign,v as renderDesign,A as think,F as webSearch,y as writeDocument};

package/dist/builtin/json/index.js

@@ -1,2 +1 @@
-export { jsonQuery } from "./json.js";
-export { readPath } from "./path.js";
+import{jsonQuery as e}from"./json.js";import{readPath as a}from"./path.js";export{e as jsonQuery,a as readPath};

package/dist/builtin/json/json.js

@@ -1,37 +1 @@
-import { tool } from "../../tool/index.js";
-import { readPath } from "./path.js";
-const DEFAULT_MAX_CHARS = 20_000;
-export function jsonQuery(opts = {}) {
-    const maxChars = opts.maxChars ?? DEFAULT_MAX_CHARS;
-    return tool({
-        name: "json_query",
-        effect: "readonly",
-        description: "Reads one value out of a JSON document by path. Paths look like " +
-            "`invoices[0].total`, or `invoices[*].total` for every element. Use it instead " +
-            "of reading a long document yourself.",
-        args: [
-            { name: "json", type: "text", required: true, maxLength: 200_000 },
-            { name: "path", type: "string", required: true, maxLength: 500 },
-        ],
-        run: ({ json, path }) => {
-            let document;
-            try {
-                document = JSON.parse(json);
-            }
-            catch (err) {
-                throw new Error(`json is not valid JSON: ${err.message}`);
-            }
-            const value = readPath(document, path);
-            if (value === undefined)
-                return { found: false, path, value: null };
-            const rendered = JSON.stringify(value) ?? "null";
-            return {
-                found: true,
-                path,
-                value,
-                truncated: rendered.length > maxChars,
-                ...(rendered.length > maxChars ? { value: `${rendered.slice(0, maxChars)}…` } : {}),
-            };
-        },
-    });
-}
+import{tool as i}from"../../tool/index.js";import{readPath as l}from"./path.js";const d=2e4;function f(a={}){const e=a.maxChars??d;return i({name:"json_query",effect:"readonly",description:"Reads one value out of a JSON document by path. Paths look like `invoices[0].total`, or `invoices[*].total` for every element. Use it instead of reading a long document yourself.",args:[{name:"json",type:"text",required:!0,maxLength:2e5},{name:"path",type:"string",required:!0,maxLength:500}],run:({json:s,path:t})=>{let o;try{o=JSON.parse(s)}catch(u){throw new Error(`json is not valid JSON: ${u.message}`)}const n=l(o,t);if(n===void 0)return{found:!1,path:t,value:null};const r=JSON.stringify(n)??"null";return{found:!0,path:t,value:n,truncated:r.length>e,...r.length>e?{value:`${r.slice(0,e)}\u2026`}:{}}}})}export{f as jsonQuery};

package/dist/builtin/json/path.js

@@ -1,56 +1 @@
-function parsePath(path) {
-    const segments = [];
-    for (const part of path.split(".")) {
-        if (!part)
-            continue;
-        const [, name, brackets] = /^([^[\]]*)((?:\[[^\]]*\])*)$/.exec(part) ?? [];
-        if (name === undefined)
-            throw new Error(`"${part}" is not a path segment.`);
-        if (name)
-            segments.push({ kind: "key", name });
-        for (const [, inner] of (brackets ?? "").matchAll(/\[([^\]]*)\]/g)) {
-            if (inner === "*") {
-                segments.push({ kind: "all" });
-                continue;
-            }
-            const at = Number(inner);
-            if (!Number.isInteger(at))
-                throw new Error(`"[${inner}]" is not an index or a *.`);
-            segments.push({ kind: "index", at });
-        }
-    }
-    return segments;
-}
-function step(value, segment) {
-    if (value === null || value === undefined)
-        return undefined;
-    if (segment.kind === "key") {
-        if (typeof value !== "object" || Array.isArray(value))
-            return undefined;
-        return value[segment.name];
-    }
-    if (!Array.isArray(value))
-        return undefined;
-    if (segment.kind === "index") {
-        return value.at(segment.at);
-    }
-    return value;
-}
-export function readPath(document, path) {
-    let cursor = document;
-    let spread = false;
-    for (const segment of parsePath(path)) {
-        if (segment.kind === "all") {
-            if (!Array.isArray(cursor))
-                return undefined;
-            cursor = spread ? cursor.flat() : [...cursor];
-            spread = true;
-            continue;
-        }
-        cursor =
-            spread && Array.isArray(cursor)
-                ? cursor.map((item) => step(item, segment))
-                : step(cursor, segment);
-    }
-    return cursor;
-}
+function a(r){const e=[];for(const n of r.split(".")){if(!n)continue;const[,t,i]=/^([^[\]]*)((?:\[[^\]]*\])*)$/.exec(n)??[];if(t===void 0)throw new Error(`"${n}" is not a path segment.`);t&&e.push({kind:"key",name:t});for(const[,f]of(i??"").matchAll(/\[([^\]]*)\]/g)){if(f==="*"){e.push({kind:"all"});continue}const o=Number(f);if(!Number.isInteger(o))throw new Error(`"[${f}]" is not an index or a *.`);e.push({kind:"index",at:o})}}return e}function s(r,e){if(r!=null){if(e.kind==="key")return typeof r!="object"||Array.isArray(r)?void 0:r[e.name];if(Array.isArray(r))return e.kind==="index"?r.at(e.at):r}}function d(r,e){let n=r,t=!1;for(const i of a(e)){if(i.kind==="all"){if(!Array.isArray(n))return;n=t?n.flat():[...n],t=!0;continue}n=t&&Array.isArray(n)?n.map(f=>s(f,i)):s(n,i)}return n}export{d as readPath};

package/dist/builtin/think/index.js

@@ -1 +1 @@
-export { think } from "./think.js";
+import{think as t}from"./think.js";export{t as think};

package/dist/builtin/think/think.js

@@ -1,12 +1 @@
-import { tool } from "../../tool/index.js";
-export function think() {
-    return tool({
-        name: "think",
-        effect: "readonly",
-        description: "Think a step through before acting. Use it to check a plan against the rules, " +
-            "to work out what is still missing, or to decide between two tools. It changes " +
-            "nothing and returns nothing — it is scratch space, not an answer.",
-        args: [{ name: "thought", type: "text", required: true, maxLength: 4000 }],
-        run: () => "noted",
-    });
-}
+import{tool as t}from"../../tool/index.js";function n(){return t({name:"think",effect:"readonly",description:"Think a step through before acting. Use it to check a plan against the rules, to work out what is still missing, or to decide between two tools. It changes nothing and returns nothing \u2014 it is scratch space, not an answer.",args:[{name:"thought",type:"text",required:!0,maxLength:4e3}],run:()=>"noted"})}export{n as think};

package/dist/builtin/web-search/index.js

@@ -1 +1 @@
-export { webSearch } from "./web-search.js";
+import{webSearch as o}from"./web-search.js";export{o as webSearch};

package/dist/builtin/web-search/reply.js

@@ -1,27 +1 @@
-function sources(raw) {
-    const listed = raw.search_results ?? [];
-    if (listed.length) {
-        return listed.flatMap((r) => (r.url ? [{ url: r.url, title: r.title, date: r.date }] : []));
-    }
-    return (raw.citations ?? []).map((url) => ({ url }));
-}
-export function readReply(body, fallbackModel, maxChars, maxResults) {
-    const raw = body;
-    const answer = raw.choices?.[0]?.message?.content ?? "";
-    const found = sources(raw);
-    const results = found.slice(0, maxResults);
-    const usage = raw.usage ?? {};
-    return {
-        answer: answer.slice(0, maxChars),
-        results,
-        model: raw.model ?? fallbackModel,
-        truncated: answer.length > maxChars || found.length > results.length,
-        usage: {
-            inputTokens: usage.prompt_tokens ?? 0,
-            outputTokens: usage.completion_tokens ?? 0,
-            citationTokens: usage.citation_tokens ?? 0,
-            reasoningTokens: usage.reasoning_tokens ?? 0,
-            searchQueries: usage.num_search_queries ?? 0,
-        },
-    };
-}
+function a(n){const s=n.search_results??[];return s.length?s.flatMap(e=>e.url?[{url:e.url,title:e.title,date:e.date}]:[]):(n.citations??[]).map(e=>({url:e}))}function l(n,s,e,r){const o=n,c=o.choices?.[0]?.message?.content??"",u=a(o),i=u.slice(0,r),t=o.usage??{};return{answer:c.slice(0,e),results:i,model:o.model??s,truncated:c.length>e||u.length>i.length,usage:{inputTokens:t.prompt_tokens??0,outputTokens:t.completion_tokens??0,citationTokens:t.citation_tokens??0,reasoningTokens:t.reasoning_tokens??0,searchQueries:t.num_search_queries??0}}}export{l as readReply};

package/dist/builtin/web-search/web-search.d.ts

@@ -23,13 +23,18 @@ export interface WebSearchOptions {
      *
      * A wave of sub-questions searches in parallel, so two calls landing together
      * is ordinary and a 429 on the second is not a failure worth surfacing — it
-     * is a wait. `retry-after` is honoured where the server sends one.
+     * is a wait. `retry-after` is honoured where the server sends one, and the
+     * wait is spread by up to one backoff on top: a whole wave limited at the
+     * same instant computes the same delay, and retrying in step rebuilds the
+     * burst that caused it.
      */
     attempts?: number;
     /** Injected for tests. */
     fetch?: typeof fetch;
     /** Injected for tests. */
     sleep?: (ms: number) => Promise<void>;
+    /** Injected for tests. Returns 0 to 1, and spreads a retried wave apart. */
+    random?: () => number;
 }
 /**
  * The live web, through Perplexity's Sonar models.

package/dist/builtin/web-search/web-search.js

@@ -1,103 +1 @@
-import { tool } from "../../tool/index.js";
-import { readReply } from "./reply.js";
-const DEPTHS = ["quick", "pro", "deep"];
-const MODELS = {
-    quick: "sonar",
-    pro: "sonar-pro",
-    deep: "sonar-deep-research",
-};
-const ENDPOINT = "https://api.perplexity.ai/chat/completions";
-const DEFAULT_TIMEOUT_MS = 60_000;
-const DEEP_TIMEOUT_MS = 300_000;
-const DEFAULT_MAX_CHARS = 20_000;
-const DEFAULT_MAX_RESULTS = 20;
-const ERROR_DETAIL_CHARS = 500;
-const BACKOFF_BASE_MS = 500;
-const MAX_BACKOFF_MS = 8_000;
-function retryAfterMs(res) {
-    const raw = res.headers.get("retry-after");
-    if (!raw)
-        return null;
-    const seconds = Number(raw);
-    return Number.isFinite(seconds) && seconds >= 0 ? seconds * 1000 : null;
-}
-const isWorthRetrying = (status) => status === 429 || status >= 500;
-function describe(maxDepth, domains) {
-    return ("Searches the live web and returns an answer with the sources it rests on. Use it for " +
-        "anything that turns on current facts — prices, releases, who holds a post, what " +
-        "changed. quick is one pass and is right for most lookups; pro searches wider and cites " +
-        "more." +
-        (maxDepth === "deep"
-            ? " deep is an exhaustive multi-step review: minutes, and many times the cost. Ask for it only when a wrong answer is expensive."
-            : " deep is not enabled here.") +
-        (domains?.length ? ` Results come only from ${domains.join(", ")}.` : ""));
-}
-export function webSearch(opts) {
-    if (!opts.apiKey?.trim()) {
-        throw new Error("webSearch needs a Perplexity apiKey; it will not read one from the process.");
-    }
-    const doFetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
-    const maxDepth = opts.maxDepth ?? "pro";
-    const attempts = Math.max(1, opts.attempts ?? 3);
-    const pause = opts.sleep ?? ((ms) => new Promise((done) => setTimeout(done, ms)));
-    return tool({
-        name: "web_search",
-        description: describe(maxDepth, opts.domains),
-        effect: "readonly",
-        args: [
-            {
-                name: "query",
-                type: "string",
-                required: true,
-                maxLength: 1000,
-                description: "What to find out, as a question. One thing, not several.",
-            },
-            {
-                name: "depth",
-                type: "enum",
-                required: false,
-                options: ["quick", "pro", "deep"],
-                description: "Default quick. Raise it only when a first pass would not settle it.",
-            },
-            {
-                name: "recency",
-                type: "enum",
-                required: false,
-                options: ["day", "week", "month", "year"],
-                description: "Only consider pages published within this. Leave unset for anything.",
-            },
-        ],
-        run: async ({ query, depth = "quick", recency }) => {
-            if (DEPTHS.indexOf(depth) > DEPTHS.indexOf(maxDepth)) {
-                throw new Error(`web_search was asked for "${depth}", above the "${maxDepth}" this deployment allows.`);
-            }
-            const model = MODELS[depth];
-            const fallback = depth === "deep" ? DEEP_TIMEOUT_MS : DEFAULT_TIMEOUT_MS;
-            for (let attempt = 1;; attempt++) {
-                const res = await doFetch(ENDPOINT, {
-                    method: "POST",
-                    signal: AbortSignal.timeout(opts.timeoutMs ?? fallback),
-                    headers: {
-                        authorization: `Bearer ${opts.apiKey}`,
-                        "content-type": "application/json",
-                    },
-                    body: JSON.stringify({
-                        model,
-                        messages: [{ role: "user", content: query }],
-                        ...(recency ? { search_recency_filter: recency } : {}),
-                        ...(opts.domains?.length ? { search_domain_filter: opts.domains } : {}),
-                    }),
-                });
-                if (res.ok) {
-                    return readReply(await res.json(), model, opts.maxChars ?? DEFAULT_MAX_CHARS, opts.maxResults ?? DEFAULT_MAX_RESULTS);
-                }
-                const detail = (await res.text()).slice(0, ERROR_DETAIL_CHARS);
-                if (!isWorthRetrying(res.status) || attempt === attempts) {
-                    throw new Error(`Perplexity returned ${res.status} for ${model}: ${detail}`);
-                }
-                const wait = retryAfterMs(res) ?? BACKOFF_BASE_MS * 2 ** (attempt - 1);
-                await pause(Math.min(MAX_BACKOFF_MS, wait));
-            }
-        },
-    });
-}
+import{tool as w}from"../../tool/index.js";import{readReply as y}from"./reply.js";const l=["quick","pro","deep"],_={quick:"sonar",pro:"sonar-pro",deep:"sonar-deep-research"},g="https://api.perplexity.ai/chat/completions",b=6e4,E=3e5,S=2e4,x=20,A=500,M=500,T=8e3;function k(e){const t=e.headers.get("retry-after");if(!t)return null;const n=Number(t);return Number.isFinite(n)&&n>=0?n*1e3:null}const O=e=>e===429||e>=500;function q(e,t){return"Searches the live web and returns an answer with the sources it rests on. Use it for anything that turns on current facts \u2014 prices, releases, who holds a post, what changed. quick is one pass and is right for most lookups; pro searches wider and cites more."+(e==="deep"?" deep is an exhaustive multi-step review: minutes, and many times the cost. Ask for it only when a wrong answer is expensive.":" deep is not enabled here.")+(t?.length?` Results come only from ${t.join(", ")}.`:"")}function F(e){if(!e.apiKey?.trim())throw new Error("webSearch needs a Perplexity apiKey; it will not read one from the process.");const t=e.fetch??globalThis.fetch.bind(globalThis),n=e.maxDepth??"pro",d=Math.max(1,e.attempts??3),u=e.sleep??(o=>new Promise(r=>setTimeout(r,o)));return w({name:"web_search",description:q(n,e.domains),effect:"readonly",args:[{name:"query",type:"string",required:!0,maxLength:1e3,description:"What to find out, as a question. One thing, not several."},{name:"depth",type:"enum",required:!1,options:["quick","pro","deep"],description:"Default quick. Raise it only when a first pass would not settle it."},{name:"recency",type:"enum",required:!1,options:["day","week","month","year"],description:"Only consider pages published within this. Leave unset for anything."}],run:async({query:o,depth:r="quick",recency:c})=>{if(l.indexOf(r)>l.indexOf(n))throw new Error(`web_search was asked for "${r}", above the "${n}" this deployment allows.`);const a=_[r],m=r==="deep"?E:b;for(let i=1;;i++){const s=await t(g,{method:"POST",signal:AbortSignal.timeout(e.timeoutMs??m),headers:{authorization:`Bearer ${e.apiKey}`,"content-type":"application/json"},body:JSON.stringify({model:a,messages:[{role:"user",content:o}],...c?{search_recency_filter:c}:{},...e.domains?.length?{search_domain_filter:e.domains}:{}})});if(s.ok)return y(await s.json(),a,e.maxChars??S,e.maxResults??x);const p=(await s.text()).slice(0,A);if(!O(s.status)||i===d)throw new Error(`Perplexity returned ${s.status} for ${a}: ${p}`);const h=Math.min(T,M*2**(i-1)),f=k(s)??h;await u(f+h*(e.random??Math.random)())}}})}export{F as webSearch};

package/dist/builtin/write-document/commission.js

@@ -1,152 +1,13 @@
-import { createRequest, MoaApiError } from "./http.js";
-const TASK_STATUS = {
-    queued: "pending",
-    running: "running",
-    succeeded: "done",
-    failed: "failed",
-    canceled: "failed",
-};
-const ARTIFACT_FORMATS = ["md", "pdf", "docx", "pptx"];
-const formatOf = (name) => {
-    const ext = name?.split(".").pop()?.toLowerCase();
-    return ext && ARTIFACT_FORMATS.includes(ext) ? ext : undefined;
-};
-function toArtifacts(raw) {
-    if (!raw?.length)
-        return undefined;
-    const artifacts = raw.flatMap((a) => {
-        const format = formatOf(a.name);
-        if (!format || !(a.url || a.data))
-            return [];
-        return [
-            {
-                name: a.name ?? `document.${format}`,
-                format,
-                url: a.url,
-                data: a.data,
-                mime: a.contentType,
-                sizeBytes: a.sizeBytes,
-            },
-        ];
-    });
-    return artifacts.length ? artifacts : undefined;
-}
-function deliverablesBlock(formats) {
-    return (`\n\n<deliverables>\nBesides the text answer, save the finished deliverable ` +
-        `into the artifacts/ directory of your working dir as: ` +
-        `${formats.map((f) => `one .${f} file`).join(", ")}.\n</deliverables>`);
-}
-function taskText(input) {
-    let task = input.task;
-    if (input.context)
-        task += `\n\n<context>\n${input.context}\n</context>`;
-    if (input.design)
-        task += `\n\n<design>\n${input.design}\n</design>`;
-    if (input.artifacts?.length)
-        task += deliverablesBlock(input.artifacts);
-    return task;
-}
-export function createCommissionClient(config = {}) {
-    const request = createRequest(config);
-    return {
-        async create(input) {
-            const created = await request("/tasks", {
-                method: "POST",
-                body: {
-                    task: taskText(input),
-                    mode: "striker",
-                    ...(input.sessionId ? { sessionId: input.sessionId } : {}),
-                    ...(input.newSessionId ? { newSessionId: input.newSessionId } : {}),
-                },
-            });
-            if (!created.id)
-                throw new MoaApiError("Moa did not return a task id", 502);
-            return created.id;
-        },
-        async get(id, opts) {
-            const qs = opts?.waitMs && opts.waitMs > 0 ? `?waitMs=${Math.floor(opts.waitMs)}` : "";
-            const t = await request(`/tasks/${encodeURIComponent(id)}${qs}`, {
-                signal: opts?.signal,
-            });
-            const status = t.status ? TASK_STATUS[t.status] : undefined;
-            return {
-                id: t.id ?? id,
-                status: status ?? "running",
-                output: t.result,
-                error: t.error,
-                costUsd: t.costUsd,
-                numTurns: t.numTurns,
-                sessionId: t.sessionId,
-                artifacts: toArtifacts(t.artifacts),
-            };
-        },
-        async cancel(id) {
-            await request(`/tasks/${encodeURIComponent(id)}`, { method: "DELETE" });
-        },
-    };
-}
-export const INTERACTIVE_TIMEOUT_MS = 30_000;
-const DEFAULT_POLL_INTERVAL_MS = 2_000;
-const SETTLE_ATTEMPTS = 3;
-const LONGPOLL_WINDOW_MS = 25_000;
-export class CommissionAbortedError extends Error {
-    commissionId;
-    constructor(commissionId) {
-        super(`Commission ${commissionId} was cancelled by the caller.`);
-        this.name = "CommissionAbortedError";
-        this.commissionId = commissionId;
-    }
-}
-export class CommissionTimeoutError extends Error {
-    commissionId;
-    timeoutMs;
-    constructor(commissionId, timeoutMs) {
-        super(`Commission ${commissionId} did not complete within ${timeoutMs / 1000}s. ` +
-            `The task may still be running in the background.`);
-        this.name = "CommissionTimeoutError";
-        this.commissionId = commissionId;
-        this.timeoutMs = timeoutMs;
-    }
-}
-const sleep = (ms, signal) => new Promise((resolve) => {
-    const onAbort = () => resolve();
-    signal?.addEventListener("abort", onAbort, { once: true });
-    setTimeout(() => {
-        signal?.removeEventListener("abort", onAbort);
-        resolve();
-    }, ms);
-});
-export async function pollUntilDone(client, id, opts = {}) {
-    const timeoutMs = opts.timeoutMs ?? INTERACTIVE_TIMEOUT_MS;
-    const pollIntervalMs = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
-    const settleMs = opts.settleMs ?? 0;
-    const signal = opts.signal;
-    const deadline = Date.now() + timeoutMs;
-    while (true) {
-        if (signal?.aborted)
-            throw new CommissionAbortedError(id);
-        const remaining = deadline - Date.now();
-        if (remaining <= 0)
-            throw new CommissionTimeoutError(id, timeoutMs);
-        let result;
-        try {
-            result = await client.get(id, { waitMs: Math.min(remaining, LONGPOLL_WINDOW_MS), signal });
-        }
-        catch (err) {
-            if (signal?.aborted)
-                throw new CommissionAbortedError(id);
-            throw err;
-        }
-        if (result.status === "failed")
-            return result;
-        if (result.status === "done") {
-            const unsettled = (r) => !r.output?.trim() || (opts.expectArtifacts === true && !r.artifacts?.length);
-            for (let i = 0; settleMs > 0 && i < SETTLE_ATTEMPTS && unsettled(result); i++) {
-                await sleep(settleMs);
-                result = await client.get(id);
-            }
-            return result;
-        }
-        await sleep(Math.min(pollIntervalMs, Math.max(0, deadline - Date.now())), signal);
-    }
-}
+import{createRequest as w,MoaApiError as h}from"./http.js";const T={queued:"pending",running:"running",succeeded:"done",failed:"failed",canceled:"failed"},M=["md","pdf","docx","pptx"],g=n=>{const t=n?.split(".").pop()?.toLowerCase();return t&&M.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 _(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 h("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)}`:"",o=await t(`/tasks/${encodeURIComponent(e)}${c}`,{signal:s?.signal}),i=o.status?T[o.status]:void 0;return{id:o.id??e,status:i??"running",output:o.result,error:o.error,costUsd:o.costUsd,numTurns:o.numTurns,sessionId:o.sessionId,artifacts:E(o.artifacts)}},async cancel(e){await t(`/tasks/${encodeURIComponent(e)}`,{method:"DELETE"})}}}const b=3e4,A=2e3,k=3,y=25e3;class m extends Error{commissionId;constructor(t){super(`Commission ${t} was cancelled by the caller.`),this.name="CommissionAbortedError",this.commissionId=t}}class C extends Error{commissionId;timeoutMs;constructor(t,e){super(`Commission ${t} did not complete within ${e/1e3}s. The task may still be running in the background.`),this.name="CommissionTimeoutError",this.commissionId=t,this.timeoutMs=e}}const f=(n,t)=>new Promise(e=>{const s=()=>e();t?.addEventListener("abort",s,{once:!0}),setTimeout(()=>{t?.removeEventListener("abort",s),e()},n)});async function p(n,t,e={}){const s=e.timeoutMs??b,c=e.pollIntervalMs??A,o=e.settleMs??0,i=e.signal,l=Date.now()+s;for(;;){if(i?.aborted)throw new m(t);const u=l-Date.now();if(u<=0)throw new C(t,s);let r;try{r=await n.get(t,{waitMs:Math.min(u,y),signal:i})}catch(d){throw i?.aborted?new m(t):d}if(r.status==="failed")return r;if(r.status==="done"){const d=a=>!a.output?.trim()||e.expectArtifacts===!0&&!a.artifacts?.length;for(let a=0;o>0&&a<k&&d(r);a++)await f(o),r=await n.get(t);return r}await f(Math.min(c,Math.max(0,l-Date.now())),i)}}export{m as CommissionAbortedError,C as CommissionTimeoutError,b as INTERACTIVE_TIMEOUT_MS,_ as createCommissionClient,p as pollUntilDone};