@spendgraph/tools 0.7.0 → 0.8.1

package/docs/stored.mdx

@@ -1,5 +1,5 @@
 export const meta = {
-  title: "A stored tool — spendgraph docs",
+  title: "A stored tool: spendgraph docs",
   description:
     "The dashboard owns the description, your code owns the arguments and the handler, and bindTool checks the two against each other before the model ever sees it.",
 };
@@ -19,7 +19,7 @@ const lookup = await bindTool(sg, {
 });
 ```
 
-No `description` in that call. That is the point — one source for the string the model reads, and it is the one you can edit without a release.
+No `description` in that call. That is the point, one source for the string the model reads, and it is the one you can edit without a release.
 
 ## Who owns what
 
@@ -31,13 +31,13 @@ No `description` in that call. That is the point — one source for the string t
   pinned            a deploy
 ```
 
-Arguments stay in code because the handler's parameter types are inferred from them. Pull those from the server and every `run` is handed a `Record<string, unknown>`, which gives up the one guarantee [declaring a tool](/docs/tools/declaring) exists to provide.
+Arguments stay in code because the handler's parameter types are inferred from them. Pull those from the server and every `run` is handed a `Record<string, unknown>`, which gives up the one guarantee [declaring a tool](/spendgraph/tools/declaring) exists to provide.
 
 Write `as const` here exactly as you would for `tool()`. Without it inference falls back to nothing, and the drift check below becomes the only thing still catching a rename.
 
 ## Drift fails at bind, not mid-loop
 
-The stored arguments and the declared ones are compared on the way through, by **name, type and requiredness** — the three a handler is written against.
+The stored arguments and the declared ones are compared on the way through, by **name, type and requiredness**: the three a handler is written against.
 
 ```ts
 import { ToolDriftError, ToolNotStoredError } from "@spendgraph/tools";
@@ -58,21 +58,21 @@ try {
 "mode" is stored but not declared here
 ```
 
-A description or a bound that differs is **not** drift — that is the dashboard being edited, which is the whole feature. A renamed argument is a handler about to be passed `undefined` halfway through an agent loop, so it throws.
+A description or a bound that differs is **not** drift: that is the dashboard being edited, which is the whole feature. A renamed argument is a handler about to be passed `undefined` halfway through an agent loop, so it throws.
 
 <Callout tone="warn" title="Bind at startup, not per request">
-  Every `bindTool` is a round trip to the API. Bind once when the process starts and hold the result, the same as you would a database connection — a bind inside a request handler puts a network hop in front of every model call.
+  Every `bindTool` is a round trip to the API. Bind once when the process starts and hold the result, the same as you would a database connection, a bind inside a request handler puts a network hop in front of every model call.
 </Callout>
 
 <Callout tone="trap" title="A rename in the dashboard is a handler passed `undefined`">
-  The wording is editable without a deploy; the argument names are not. `bindTool` compares them at bind time and refuses — a deploy that fails is recoverable, and the same rename noticed mid-loop is a handler halfway through somebody's refund reading an argument that is not there.
+  The wording is editable without a deploy; the argument names are not. `bindTool` compares them at bind time and refuses: a deploy that fails is recoverable, and the same rename noticed mid-loop is a handler halfway through somebody's refund reading an argument that is not there.
 </Callout>
 
 ## When nothing is stored yet
 
 `ToolNotStoredError` is the ordinary case of "you have not written this one in the dashboard yet", not an exotic failure. It exists so a 404 from three layers down arrives as a sentence naming the tool.
 
-Create the row first — `sg.tools.create` on the [client](/docs/sdk/client), or the Tools page in the dashboard — then bind to it.
+Create the row first, `sg.tools.create` on the [client](/spendgraph/sdk/client), or the Tools page in the dashboard, then bind to it.
 
 ## It is an ordinary tool afterwards
 

package/docs/turns.mdx

@@ -1,5 +1,5 @@
 export const meta = {
-  title: "A turn — spendgraph docs",
+  title: "A turn: spendgraph docs",
   description:
     "A turn is selected once and remembers what it offered. Without that a record cannot tell 'chose not to' from 'was never offered', which are opposite bugs.",
 };
@@ -19,7 +19,7 @@ A turn is **selected once** and remembers what it offered. A trace cannot disagr
 
 ## Offered is recorded, not just called
 
-Which tools were offered is recorded as well as which were called. Without it a record cannot tell **"chose not to"** from **"was never offered"** — which are opposite bugs, and look identical in a log that only lists calls.
+Which tools were offered is recorded as well as which were called. Without it a record cannot tell **"chose not to"** from **"was never offered"**, which are opposite bugs, and look identical in a log that only lists calls.
 
 ## What a turn answers
 
@@ -34,17 +34,17 @@ Which tools were offered is recorded as well as which were called. Without it a
 
 ## Never throwing is the point
 
-A tool that fails is an **outcome the agent can react to** and a step worth recording, not an exception that ends the run — the same argument `status` and `error` exist on a rollout for.
+A tool that fails is an **outcome the agent can react to** and a step worth recording, not an exception that ends the run, the same argument `status` and `error` exist on a rollout for.
 
 A tool the bus does not have is a failure that says what was offered, since the usual cause is a hallucinated name.
 
 <Callout tone="trap" title="`undefined` means two different things">
-  A tool that was offered and stayed quiet, and a tool this turn never offered, both answer `undefined`. `offeredTools` is what tells them apart — which is the difference between a model that declined to look something up and a model that could not.
+  A tool that was offered and stayed quiet, and a tool this turn never offered, both answer `undefined`. `offeredTools` is what tells them apart, which is the difference between a model that declined to look something up and a model that could not.
 </Callout>
 
 ## Usage drives the tiebreaker
 
-`bus.usage()` counts what has actually been called, which is what selection falls back on when a query singles out nothing. A call that never reached the tool — a name that does not exist, arguments that did not validate — is not counted, because it was not a use.
+`bus.usage()` counts what has actually been called, which is what selection falls back on when a query singles out nothing. A call that never reached the tool: a name that does not exist, arguments that did not validate, is not counted, because it was not a use.
 
 ## With a prompt
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spendgraph/tools",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Declare a tool once, offer the right few, and record what was called.",
   "license": "Apache-2.0",
   "repository": {
@@ -37,6 +37,10 @@
       "types": "./dist/wire/index.d.ts",
       "import": "./dist/wire/index.js"
     },
+    "./papers": {
+      "types": "./dist/papers/index.d.ts",
+      "import": "./dist/papers/index.js"
+    },
     "./search": {
       "types": "./dist/search/index.d.ts",
       "import": "./dist/search/index.js"
@@ -57,13 +61,14 @@
     "README.md"
   ],
   "dependencies": {
-    "@spendgraph/sdk": "^0.7.0",
+    "@spendgraph/sdk": "^0.8.1",
     "jszip": "^3.10.2",
     "unpdf": "^1.8.1"
   },
   "devDependencies": {
     "@locusgraph/client": "^0.8.1",
-    "@spendgraph/prompt": "^0.7.0",
+    "@spendgraph/config": "0.8.1",
+    "@spendgraph/prompt": "^0.8.1",
     "pdf-lib": "^1.17.1",
     "typescript": "^5"
   },
@@ -75,7 +80,8 @@
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json --emitDeclarationOnly && tsc -p tsconfig.json --declaration false --removeComments && node ../../scripts/minify.mjs dist",
+    "examples": "pnpm run build && node examples/02-select/01-shortlist.mjs",
     "test": "vitest run",
-    "examples": "pnpm run build && node examples/02-select/01-shortlist.mjs"
+    "typecheck": "tsc -p tsconfig.tests.json"
   }
 }

package/dist/agents/index.d.ts

@@ -1 +0,0 @@
-export { type ArtifactFormat, DEFAULT_DESIGN, type DesignGuide, MoaAbortedError, type MoaClient, MoaTimeoutError, mergeDesign, renderDesign, type WriteDocumentOptions, writeDocument, } from "./moa/index.js";

package/dist/agents/index.js

@@ -1 +0,0 @@
-import{DEFAULT_DESIGN as o,MoaAbortedError as t,MoaTimeoutError as D,mergeDesign as i,renderDesign as m,writeDocument as n}from"./moa/index.js";export{o as DEFAULT_DESIGN,t as MoaAbortedError,D as MoaTimeoutError,i as mergeDesign,m as renderDesign,n as writeDocument};

package/dist/agents/moa/design.d.ts

@@ -1,49 +0,0 @@
-import type { ArtifactFormat } from "./types.js";
-/**
- * The house style a commissioned document is built to.
- *
- * Every field is optional because a caller overrides only what its brand
- * actually fixes; the rest falls back to {@link DEFAULT_DESIGN}.
- */
-export interface DesignGuide {
-    /** What the style is called, so the document can say which one it followed. */
-    name?: string;
-    fonts?: {
-        heading?: string;
-        body?: string;
-        mono?: string;
-    };
-    palette?: {
-        primary?: string;
-        accent?: string;
-        text?: string;
-        muted?: string;
-        surface?: string;
-    };
-    /** Page size, margins, grid, density. */
-    layout?: string;
-    /** How a figure earns its place and what it may not do. */
-    charts?: string;
-    /** How the writing sounds. */
-    tone?: string;
-    /** Fetchable logo, dropped on the cover and nowhere else. */
-    logoUrl?: string;
-    /** Hard rules, appended to the defaults rather than replacing them. */
-    rules?: readonly string[];
-}
-/**
- * What a document looks like when nobody has said.
- *
- * Chosen to be defensible rather than distinctive: one typeface, one accent,
- * real whitespace, and figures that carry a single message.
- */
-export declare const DEFAULT_DESIGN: DesignGuide;
-/**
- * A caller's guide over the defaults: named fields win, `rules` accumulate.
- *
- * Rules append because they are constraints — a brand adding "never use red"
- * means it as well as the defaults, not instead of them.
- */
-export declare function mergeDesign(base: DesignGuide, over?: DesignGuide): DesignGuide;
-/** The guide as the block Moa reads, since its artifact pipeline is prompt-driven. */
-export declare function renderDesign(guide: DesignGuide, format: ArtifactFormat, notes?: string): string;

package/dist/agents/moa/design.js

@@ -1,5 +0,0 @@
-const c={name:"Spendgraph house style",fonts:{heading:"Inter",body:"Inter",mono:"JetBrains Mono"},palette:{primary:"#0F172A",accent:"#2563EB",text:"#111827",muted:"#64748B",surface:"#FFFFFF"},layout:"A4 portrait, 20mm margins, a single text column at 60-75 characters, a 4pt spacing scale, and one heading scale used consistently (28/20/16/12). Whitespace is the design.",charts:"One message per figure, stated in its caption. Label series directly where there are three or fewer. No 3D, no gradients, no gridline heavier than the data, no pie chart past three slices, and axes that start at zero unless the caption says why not.",tone:"Plain and specific. Lead with the finding, then the evidence. No filler adjectives, no throat-clearing, no sentence that survives being deleted.",rules:["A cover carrying the title, date and author, and no other ornament.","Every number traceable to something in the source material; invent nothing.","Tables for anything being compared; prose for anything being argued.","No stock imagery, no clip art, no placeholder text in the finished file.","Page numbers on every page after the cover."]},d={pdf:"Cover, then contents if it runs past four pages, then the body. Figures captioned and referenced from the text. Nothing straddles a page break: no orphan heading, no split table row.",pptx:"16:9. One idea per slide, and the title is that idea as a sentence \u2014 a claim, not a label. At most six lines of body per slide, one figure per slide at most, and everything you cut goes into the speaker notes. Close on decisions and next steps, not on 'thank you'.",docx:"Real Word styles for headings rather than manual bold, a table-of-contents field rather than a typed list, a header row on every table, and captions on figures.",md:"A title heading, ATX headings throughout, tables for comparisons, fenced code with a language tag, and no HTML."};function i(e,t){return e?t?{...e,...t}:e:t}function h(e,t){return t?{...e,...t,fonts:i(e.fonts,t.fonts),palette:i(e.palette,t.palette),rules:[...e.rules??[],...t.rules??[]]}:e}const a=(e,t)=>t?[`${e}: ${t}`]:[];function p(e,t,o){const{fonts:r,palette:n}=e;return[...a("Style",e.name),...a("Typefaces",[r?.heading&&`headings ${r.heading}`,r?.body&&`body ${r.body}`,r?.mono&&`code ${r.mono}`].filter(Boolean).join(", ")||void 0),...a("Palette",[n?.primary&&`primary ${n.primary}`,n?.accent&&`accent ${n.accent}`,n?.text&&`text ${n.text}`,n?.muted&&`muted ${n.muted}`,n?.surface&&`surface ${n.surface}`].filter(Boolean).join(", ")||void 0),...a("Layout",e.layout),...a("Figures",e.charts),...a("Voice",e.tone),...a("Logo",e.logoUrl),`Format craft (.${t}): ${d[t]}`,...e.rules?.length?[`Rules:
-${e.rules.map(s=>`- ${s}`).join(`
-`)}`]:[],...o?.trim()?[`Overrides for this document, which win over everything above:
-${o.trim()}`]:[]].join(`
-`)}export{c as DEFAULT_DESIGN,h as mergeDesign,p as renderDesign};

package/dist/agents/moa/http.d.ts

@@ -1,34 +0,0 @@
-/** Anything shaped like an `AbortSignal`, so a Worker's own signal fits too. */
-export interface AbortSignalLike {
-    readonly aborted: boolean;
-    addEventListener(type: "abort", listener: () => void, opts?: {
-        once?: boolean;
-    }): void;
-    removeEventListener(type: "abort", listener: () => void): void;
-}
-/** Where Moa lives, unless a config says otherwise. */
-export declare const MOA_BASE_URL = "https://api.fnmoa.com";
-export interface MoaClientConfig {
-    /** Read from here rather than the environment, as every other builtin does. */
-    apiKey?: string;
-    baseUrl?: string;
-    /** Ceiling on one HTTP call, not on the commission. Default 60000. */
-    timeoutMs?: number;
-    /** Injected for tests. */
-    fetch?: typeof fetch;
-}
-/** A non-2xx from Moa, carrying the status so a caller can tell 4xx from 5xx. */
-export declare class MoaApiError extends Error {
-    readonly status: number;
-    readonly detail?: string;
-    constructor(message: string, status: number, detail?: string);
-}
-interface RequestOptions {
-    method?: string;
-    body?: unknown;
-    signal?: AbortSignalLike;
-    timeoutMs?: number;
-}
-/** One `request<T>(path, opts)` against Moa, with auth, timeout and error shape settled. */
-export declare function createRequest(config?: MoaClientConfig): <T>(path: string, opts?: RequestOptions) => Promise<T>;
-export {};

package/dist/agents/moa/http.js

@@ -1 +0,0 @@
-const f="https://api.fnmoa.com",M=6e4,_=500;class c extends Error{status;detail;constructor(t,s,n){super(n?`${t}: ${n}`:t),this.name="MoaApiError",this.status=s,this.detail=n}}function T(e){const t=e.cause;return t?.code??t?.message??e.message}function m(e,t){const s=new AbortController,n=()=>s.abort();let r=!1;const o=setTimeout(()=>{r=!0,n()},e);return t?.addEventListener("abort",n,{once:!0}),t?.aborted&&n(),{signal:s.signal,expired:()=>r,release:()=>{clearTimeout(o),t?.removeEventListener("abort",n)}}}function $(e={}){const t=e.fetch??globalThis.fetch.bind(globalThis),s=(e.baseUrl??f).replace(/\/+$/,"");return async function(r,o={}){const u=o.timeoutMs??e.timeoutMs??6e4,i=o.method??"GET",d=`${s}${r}`,{signal:E,expired:h,release:b}=m(u,o.signal);try{const a=await t(d,{method:i,signal:E,headers:{...e.apiKey?{authorization:`Bearer ${e.apiKey}`}:{},...o.body===void 0?{}:{"content-type":"application/json"}},...o.body===void 0?{}:{body:JSON.stringify(o.body)}}).catch(l=>{throw o.signal?.aborted?l:h()?new c(`Moa did not answer ${i} ${r}`,504,`${u}ms`):new c(`Moa is unreachable at ${d}`,0,T(l))});if(!a.ok)throw new c(`Moa returned ${a.status} for ${i} ${r}`,a.status,(await a.text()).slice(0,500));return a.status===204?void 0:await a.json()}finally{b()}}}export{f as MOA_BASE_URL,c as MoaApiError,$ as createRequest};

package/dist/agents/moa/index.d.ts

@@ -1,74 +0,0 @@
-import { type DesignGuide } from "./design.js";
-import type { AbortSignalLike } from "./http.js";
-import { type MoaClient } from "./moa.js";
-import type { ArtifactFormat } from "./types.js";
-export interface WriteDocumentOptions {
-    /** Moa key. Required, and read from here rather than the environment. */
-    apiKey: string;
-    /** Defaults to `https://api.fnmoa.com`. */
-    baseUrl?: string;
-    /**
-     * House style laid over {@link DEFAULT_DESIGN}: named fields win, `rules`
-     * accumulate. This is where a brand goes, so the model cannot dilute it.
-     */
-    design?: DesignGuide;
-    /** Formats this deployment will produce. Default all four. */
-    formats?: readonly ArtifactFormat[];
-    /** Give up waiting after this. Default 600000 — rendering is minutes, not seconds. */
-    timeoutMs?: number;
-    /** Stops the wait. With `cancelOnAbort`, stops the task too. */
-    signal?: AbortSignalLike;
-    /** Cancel the task server-side when `signal` fires. Default true. */
-    cancelOnAbort?: boolean;
-    /** Return artifact bytes inline. Default false: base64 of a PDF is not context. */
-    includeData?: boolean;
-    /** Longest write-up handed back. Default 4000 characters. */
-    maxChars?: number;
-    /** Injected for tests, and for anyone fronting Moa with their own transport. */
-    client?: MoaClient;
-    /** Injected for tests. */
-    fetch?: typeof fetch;
-}
-/**
- * A document agent, briefed in your house style.
- *
- * Style is the deployment's business and content is the model's: the guide
- * comes from `options.design`, and `design_notes` may bend it for one document
- * rather than replace it. `effect` is `destructive` because a second call is a
- * second bill and a second set of files — never something to retry blindly.
- */
-export declare function writeDocument(opts: WriteDocumentOptions): import("../../index.js").Tool<import("../../index.js").ArgsOf<readonly [{
-    readonly name: "brief";
-    readonly type: "text";
-    readonly required: true;
-    readonly maxLength: 8000;
-    readonly description: string;
-}, {
-    readonly name: "format";
-    readonly type: "enum";
-    readonly required: true;
-    readonly options: readonly ["pdf", "pptx", "docx", "md"];
-    readonly description: "pptx for anything presented, pdf for anything sent, docx for anything edited.";
-}, {
-    readonly name: "source";
-    readonly type: "text";
-    readonly required: false;
-    readonly maxLength: 40000;
-    readonly description: string;
-}, {
-    readonly name: "design_notes";
-    readonly type: "text";
-    readonly required: false;
-    readonly maxLength: 2000;
-    readonly description: string;
-}, {
-    readonly name: "session_id";
-    readonly type: "string";
-    readonly required: false;
-    readonly description: string;
-}]>>;
-export { DEFAULT_DESIGN, type DesignGuide, mergeDesign, renderDesign } from "./design.js";
-export { MOA_BASE_URL, MoaApiError, type MoaClientConfig } from "./http.js";
-export type { MoaClient, PollOptions } from "./moa.js";
-export { createMoaClient, INTERACTIVE_TIMEOUT_MS, MoaAbortedError, MoaTimeoutError, pollUntilDone, } from "./moa.js";
-export type { ArtifactFormat, MoaArtifact, MoaInput, MoaResult, MoaStatus, } from "./types.js";

package/dist/agents/moa/index.js

@@ -1 +0,0 @@
-import{tool as f}from"../../tool/index.js";import{DEFAULT_DESIGN as l,mergeDesign as h,renderDesign as g}from"./design.js";import{createMoaClient as p,MoaAbortedError as w,MoaTimeoutError as y,pollUntilDone as M}from"./moa.js";const _=["pdf","pptx","docx","md"],E=6e5,x=2e3,T=4e3;function A(e,r){return`Commissions a document agent to write and render a finished file \u2014 ${e.map(t=>`.${t}`).join(", ")} \u2014 and hands back where to download it. Use it when the answer has to be a document somebody opens: a report, a deck, a proposal, a one-pager. Not for text you can simply write in your reply. It runs for minutes and it costs money, so brief it once and brief it fully \u2014 the agent cannot see this conversation, so every fact, figure and quote it must use goes in \`source\`. Design is already settled by ${r.name??"the house style"}; use \`design_notes\` only for what this one document must do differently.`}function U(e,r,t,d){const i=(e.artifacts??[]).map(o=>({name:o.name,format:o.format,url:o.url,mime:o.mime,sizeBytes:o.sizeBytes,...d&&o.data?{data:o.data}:{}}));return{taskId:e.id,sessionId:e.sessionId,status:"done",style:r,documents:i,delivered:i.length>0,writeUp:e.output?.slice(0,t),truncated:(e.output?.length??0)>t,turns:e.numTurns,costMicroUsd:e.costUsd===void 0?void 0:Math.round(e.costUsd*1e6)}}function b(e,r,t){return{taskId:e,status:"running",style:r,documents:[],delivered:!1,note:`Still rendering after ${Math.round(t.timeoutMs/1e3)}s. The task is not lost \u2014 say so rather than commissioning it again.`}}function L(e){if(!e.client&&!e.apiKey?.trim())throw new Error("writeDocument needs a Moa apiKey; it will not read one from the process.");const r=e.formats?.length?e.formats:_,t=h(l,e.design),d=e.maxChars??T,i=e.client??p({apiKey:e.apiKey,baseUrl:e.baseUrl,...e.fetch?{fetch:e.fetch}:{}});return f({name:"write_document",description:A(r,t),effect:"destructive",args:[{name:"brief",type:"text",required:!0,maxLength:8e3,description:"What to produce, who reads it, what it must cover and how long it runs. Write it as you would brief a person who knows the craft and nothing about this account."},{name:"format",type:"enum",required:!0,options:["pdf","pptx","docx","md"],description:"pptx for anything presented, pdf for anything sent, docx for anything edited."},{name:"source",type:"text",required:!1,maxLength:4e4,description:"The material it must build from \u2014 figures, findings, quotes, an outline \u2014 verbatim. Anything missing here the agent will either omit or invent."},{name:"design_notes",type:"text",required:!1,maxLength:2e3,description:"How this one document departs from the house style, in plain words. Leave it empty unless the user asked for something specific."},{name:"session_id",type:"string",required:!1,description:"Continue an earlier write_document instead of starting over \u2014 take it from that result's sessionId. Use it to revise a document or to recast one into another format."}],run:async({brief:o,format:s,source:u,design_notes:m,session_id:c})=>{if(!r.includes(s))throw new Error(`write_document was asked for .${s}, which this deployment does not produce (${r.map(n=>`.${n}`).join(", ")}).`);const a=await i.create({task:o,context:u,design:g(t,s,m),artifacts:[s],...c?{sessionId:c}:{}});try{const n=await M(i,a,{timeoutMs:e.timeoutMs??E,settleMs:x,expectArtifacts:!0,...e.signal?{signal:e.signal}:{}});if(n.status==="failed")throw new Error(`write_document: Moa task ${a} failed: ${n.error??"no reason given"}`);return U(n,t.name,d,e.includeData===!0)}catch(n){if(n instanceof w&&e.cancelOnAbort!==!1&&await i.cancel?.(a).catch(()=>{}),n instanceof y)return b(a,t.name,n);throw n}}})}import{DEFAULT_DESIGN as $,mergeDesign as q,renderDesign as C}from"./design.js";import{MOA_BASE_URL as O,MoaApiError as R}from"./http.js";import{createMoaClient as N,INTERACTIVE_TIMEOUT_MS as B,MoaAbortedError as j,MoaTimeoutError as z,pollUntilDone as G}from"./moa.js";export{$ as DEFAULT_DESIGN,B as INTERACTIVE_TIMEOUT_MS,O as MOA_BASE_URL,j as MoaAbortedError,R as MoaApiError,z as MoaTimeoutError,N as createMoaClient,q as mergeDesign,G as pollUntilDone,C as renderDesign,L as writeDocument};

package/dist/agents/moa/moa.d.ts

@@ -1,56 +0,0 @@
-import { type AbortSignalLike, type MoaClientConfig } from "./http.js";
-import type { MoaInput, MoaResult } from "./types.js";
-/**
- * Moa's task surface — fire, then await.
- *
- * `create()` hands back an id immediately and `get()` reads it; pass `waitMs`
- * (or use {@link pollUntilDone}) to long-poll, so one call is awaited rather
- * than a loop tight-polling. `cancel()` is optional so a test stub stays small.
- */
-export interface MoaClient {
-    create(input: MoaInput): Promise<string>;
-    get(id: string, opts?: {
-        waitMs?: number;
-        signal?: AbortSignalLike;
-    }): Promise<MoaResult>;
-    cancel?(id: string): Promise<void>;
-}
-/**
- * HTTP {@link MoaClient} over Moa's task API (`POST /tasks` → `GET /tasks/:id`).
- *
- * The request body carries the ask as prose — Moa's artifact pipeline is
- * prompt-driven and `POST /tasks` strips unknown fields, so context, design and
- * deliverables are blocks on the task rather than parameters beside it.
- */
-export declare function createMoaClient(config?: MoaClientConfig): MoaClient;
-/** The sane ceiling for a chat-bound call. A rendered document wants minutes, not this. */
-export declare const INTERACTIVE_TIMEOUT_MS = 30000;
-/** Thrown by {@link pollUntilDone} when the caller's abort signal fires. */
-export declare class MoaAbortedError extends Error {
-    readonly taskId: string;
-    constructor(taskId: string);
-}
-/** Thrown when the wait ran out. The task itself is still running server-side. */
-export declare class MoaTimeoutError extends Error {
-    readonly taskId: string;
-    readonly timeoutMs: number;
-    constructor(taskId: string, timeoutMs: number);
-}
-export interface PollOptions {
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-    /**
-     * Stops the wait and throws {@link MoaAbortedError}, cutting the held
-     * long-poll with it. The task keeps running — cancelling it is the caller's call.
-     */
-    signal?: AbortSignalLike;
-    /**
-     * How long to wait before re-reading a done task whose result has not landed
-     * yet. Moa flips the status slightly before it writes. Default 0.
-     */
-    settleMs?: number;
-    /** Keep settling while a done task carries no artifacts. Set it when files were asked for. */
-    expectArtifacts?: boolean;
-}
-/** Wait for a Moa task to settle, long-polling rather than tight-polling. */
-export declare function pollUntilDone(client: MoaClient, id: string, opts?: PollOptions): Promise<MoaResult>;

package/dist/agents/moa/moa.js

@@ -1,13 +0,0 @@
-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/agents/moa/types.d.ts

@@ -1,33 +0,0 @@
-/** A document format Moa can leave behind in `artifacts/`. */
-export type ArtifactFormat = "md" | "pdf" | "docx" | "pptx";
-/** 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 MoaArtifact {
-    name: string;
-    format: ArtifactFormat;
-    url?: string;
-    data?: string;
-    mime?: string;
-    sizeBytes?: number;
-}
-/** What to hand Moa: the ask, the material it rests on, and the house style. */
-export interface MoaInput {
-    task: string;
-    context?: string;
-    design?: string;
-    artifacts?: readonly ArtifactFormat[];
-    sessionId?: string;
-    newSessionId?: string;
-}
-/** A Moa task as it stands right now. */
-export interface MoaResult {
-    id: string;
-    status: MoaStatus;
-    output?: string;
-    error?: string;
-    costUsd?: number;
-    numTurns?: number;
-    sessionId?: string;
-    artifacts?: MoaArtifact[];
-}

package/dist/builtin/openalex/render.js

@@ -1,4 +0,0 @@
-const h=3;function c(n){const t=n.authors.slice(0,3).map(e=>e.split(" ").at(-1)??e),o=n.authors.length-t.length;return t.length===0?"unknown authors":o>0?`${t.join(", ")} +${o}`:t.join(", ")}function $(n){const t=n.year===null?"":` (${n.year})`,o=n.venue?` \xB7 ${n.venue}`:"";return`${n.title}${t} \u2014 ${c(n)}${o} \xB7 ${n.citations} citations`}function d(n){const o=[n.doi?`doi:${n.doi}`:null,n.pdf?`pdf: ${n.pdf}`:null].filter(e=>e!==null);return o.length>0?o.join(" \xB7 "):null}function f(n,t){const o=n.abstract.trim();return o?o.length>t?`${o.slice(0,t).trimEnd()}\u2026`:o:null}function m(n,t,o){const e=`${t.length} paper${t.length===1?"":"s"} on "${n}", most relevant first`,u=t.map((l,s)=>[`${s+1}. ${$(l)}`,d(l),f(l,o)].filter(i=>i!==null).map((i,r)=>r===0?i:`   ${i}`).join(`
-`));return[e,...u].join(`
-
-`)}export{m as rendered};