@spendgraph/tools 0.6.0 → 0.8.0

package/dist/builtin/write-document/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/builtin/write-document/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/builtin/write-document/index.d.ts

@@ -1,6 +0,0 @@
-export type { CommissionClient, PollOptions } from "./commission.js";
-export { CommissionAbortedError, CommissionTimeoutError, createCommissionClient, INTERACTIVE_TIMEOUT_MS, pollUntilDone, } from "./commission.js";
-export { DEFAULT_DESIGN, type DesignGuide, mergeDesign, renderDesign } from "./design.js";
-export { MOA_BASE_URL, MoaApiError, type MoaClientConfig } from "./http.js";
-export type { ArtifactFormat, CommissionArtifact, CommissionInput, CommissionResult, CommissionStatus, } from "./types.js";
-export { type WriteDocumentOptions, writeDocument } from "./write-document.js";

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

@@ -1 +0,0 @@
-import{CommissionAbortedError as e,CommissionTimeoutError as i,createCommissionClient as m,INTERACTIVE_TIMEOUT_MS as t,pollUntilDone as n}from"./commission.js";import{DEFAULT_DESIGN as s,mergeDesign as p,renderDesign as A}from"./design.js";import{MOA_BASE_URL as T,MoaApiError as C}from"./http.js";import{writeDocument as f}from"./write-document.js";export{e as CommissionAbortedError,i as CommissionTimeoutError,s as DEFAULT_DESIGN,t as INTERACTIVE_TIMEOUT_MS,T as MOA_BASE_URL,C as MoaApiError,m as createCommissionClient,p as mergeDesign,n as pollUntilDone,A as renderDesign,f as writeDocument};

package/dist/builtin/write-document/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 commission has got to. `pending` is queued, `failed` is settled. */
-export type CommissionStatus = "pending" | "running" | "done" | "failed";
-/** One finished file, either downloadable or carried inline as base64. */
-export interface CommissionArtifact {
-    name: string;
-    format: ArtifactFormat;
-    url?: string;
-    data?: string;
-    mime?: string;
-    sizeBytes?: number;
-}
-/** What to commission: the ask, the material it rests on, and the house style. */
-export interface CommissionInput {
-    task: string;
-    context?: string;
-    design?: string;
-    artifacts?: readonly ArtifactFormat[];
-    sessionId?: string;
-    newSessionId?: string;
-}
-/** A commission as it stands right now. */
-export interface CommissionResult {
-    id: string;
-    status: CommissionStatus;
-    output?: string;
-    error?: string;
-    costUsd?: number;
-    numTurns?: number;
-    sessionId?: string;
-    artifacts?: CommissionArtifact[];
-}

package/dist/builtin/write-document/write-document.d.ts

@@ -1,69 +0,0 @@
-import { type CommissionClient } from "./commission.js";
-import { type DesignGuide } from "./design.js";
-import type { AbortSignalLike } from "./http.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?: CommissionClient;
-    /** 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;
-}]>>;

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

@@ -1 +0,0 @@
-import{tool as f}from"../../tool/index.js";import{CommissionAbortedError as l,CommissionTimeoutError as h,createCommissionClient as g,pollUntilDone as p}from"./commission.js";import{DEFAULT_DESIGN as w,mergeDesign as y,renderDesign as _}from"./design.js";const x=["pdf","pptx","docx","md"],b=6e5,M=2e3,U=4e3;function v(e,i){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 ${i.name??"the house style"}; use \`design_notes\` only for what this one document must do differently.`}function E(e,i,t,d){const r=(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:i,documents:r,delivered:r.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 T(e,i,t){return{taskId:e,status:"running",style:i,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 i=e.formats?.length?e.formats:x,t=y(w,e.design),d=e.maxChars??U,r=e.client??g({apiKey:e.apiKey,baseUrl:e.baseUrl,...e.fetch?{fetch:e.fetch}:{}});return f({name:"write_document",description:v(i,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(!i.includes(s))throw new Error(`write_document was asked for .${s}, which this deployment does not produce (${i.map(n=>`.${n}`).join(", ")}).`);const a=await r.create({task:o,context:u,design:_(t,s,m),artifacts:[s],...c?{sessionId:c}:{}});try{const n=await p(r,a,{timeoutMs:e.timeoutMs??b,settleMs:M,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 E(n,t.name,d,e.includeData===!0)}catch(n){if(n instanceof l&&e.cancelOnAbort!==!1&&await r.cancel?.(a).catch(()=>{}),n instanceof h)return T(a,t.name,n);throw n}}})}export{L as writeDocument};