@spendgraph/tools 0.5.0 → 0.7.0

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

@@ -1,71 +0,0 @@
-export const MOA_BASE_URL = "https://api.fnmoa.com";
-const DEFAULT_REQUEST_TIMEOUT_MS = 60_000;
-const ERROR_DETAIL_CHARS = 500;
-export class MoaApiError extends Error {
-    status;
-    detail;
-    constructor(message, status, detail) {
-        super(detail ? `${message}: ${detail}` : message);
-        this.name = "MoaApiError";
-        this.status = status;
-        this.detail = detail;
-    }
-}
-function reasonOf(err) {
-    const cause = err.cause;
-    return cause?.code ?? cause?.message ?? err.message;
-}
-function deadlineSignal(timeoutMs, caller) {
-    const controller = new AbortController();
-    const stop = () => controller.abort();
-    let expired = false;
-    const timer = setTimeout(() => {
-        expired = true;
-        stop();
-    }, timeoutMs);
-    caller?.addEventListener("abort", stop, { once: true });
-    if (caller?.aborted)
-        stop();
-    return {
-        signal: controller.signal,
-        expired: () => expired,
-        release: () => {
-            clearTimeout(timer);
-            caller?.removeEventListener("abort", stop);
-        },
-    };
-}
-export function createRequest(config = {}) {
-    const doFetch = config.fetch ?? globalThis.fetch.bind(globalThis);
-    const base = (config.baseUrl ?? MOA_BASE_URL).replace(/\/+$/, "");
-    return async function request(path, opts = {}) {
-        const timeoutMs = opts.timeoutMs ?? config.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
-        const method = opts.method ?? "GET";
-        const url = `${base}${path}`;
-        const { signal, expired, release } = deadlineSignal(timeoutMs, opts.signal);
-        try {
-            const res = await doFetch(url, {
-                method,
-                signal,
-                headers: {
-                    ...(config.apiKey ? { authorization: `Bearer ${config.apiKey}` } : {}),
-                    ...(opts.body === undefined ? {} : { "content-type": "application/json" }),
-                },
-                ...(opts.body === undefined ? {} : { body: JSON.stringify(opts.body) }),
-            }).catch((err) => {
-                if (opts.signal?.aborted)
-                    throw err;
-                if (expired())
-                    throw new MoaApiError(`Moa did not answer ${method} ${path}`, 504, `${timeoutMs}ms`);
-                throw new MoaApiError(`Moa is unreachable at ${url}`, 0, reasonOf(err));
-            });
-            if (!res.ok) {
-                throw new MoaApiError(`Moa returned ${res.status} for ${method} ${path}`, res.status, (await res.text()).slice(0, ERROR_DETAIL_CHARS));
-            }
-            return res.status === 204 ? undefined : (await res.json());
-        }
-        finally {
-            release();
-        }
-    };
-}

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,4 +0,0 @@
-export { CommissionAbortedError, CommissionTimeoutError, createCommissionClient, INTERACTIVE_TIMEOUT_MS, pollUntilDone, } from "./commission.js";
-export { DEFAULT_DESIGN, mergeDesign, renderDesign } from "./design.js";
-export { MOA_BASE_URL, MoaApiError } from "./http.js";
-export { writeDocument } from "./write-document.js";

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

@@ -1 +0,0 @@
-export {};

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

@@ -1,142 +0,0 @@
-import { tool } from "../../tool/index.js";
-import { CommissionAbortedError, CommissionTimeoutError, createCommissionClient, pollUntilDone, } from "./commission.js";
-import { DEFAULT_DESIGN, mergeDesign, renderDesign } from "./design.js";
-const ALL_FORMATS = ["pdf", "pptx", "docx", "md"];
-const DEFAULT_TIMEOUT_MS = 600_000;
-const DEFAULT_SETTLE_MS = 2_000;
-const DEFAULT_MAX_CHARS = 4_000;
-function describe(formats, design) {
-    return ("Commissions a document agent to write and render a finished file — " +
-        `${formats.map((f) => `.${f}`).join(", ")} — 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 — the agent cannot see this ` +
-        "conversation, so every fact, figure and quote it must use goes in `source`. Design is " +
-        `already settled by ${design.name ?? "the house style"}; use \`design_notes\` only for what ` +
-        "this one document must do differently.");
-}
-function delivered(result, style, maxChars, includeData) {
-    const documents = (result.artifacts ?? []).map((a) => ({
-        name: a.name,
-        format: a.format,
-        url: a.url,
-        mime: a.mime,
-        sizeBytes: a.sizeBytes,
-        ...(includeData && a.data ? { data: a.data } : {}),
-    }));
-    return {
-        taskId: result.id,
-        sessionId: result.sessionId,
-        status: "done",
-        style,
-        documents,
-        delivered: documents.length > 0,
-        writeUp: result.output?.slice(0, maxChars),
-        truncated: (result.output?.length ?? 0) > maxChars,
-        turns: result.numTurns,
-        costMicroUsd: result.costUsd === undefined ? undefined : Math.round(result.costUsd * 1_000_000),
-    };
-}
-function stillRendering(id, style, err) {
-    return {
-        taskId: id,
-        status: "running",
-        style,
-        documents: [],
-        delivered: false,
-        note: `Still rendering after ${Math.round(err.timeoutMs / 1000)}s. The task is not lost — ` +
-            "say so rather than commissioning it again.",
-    };
-}
-export function writeDocument(opts) {
-    if (!opts.client && !opts.apiKey?.trim()) {
-        throw new Error("writeDocument needs a Moa apiKey; it will not read one from the process.");
-    }
-    const allowed = opts.formats?.length ? opts.formats : ALL_FORMATS;
-    const design = mergeDesign(DEFAULT_DESIGN, opts.design);
-    const maxChars = opts.maxChars ?? DEFAULT_MAX_CHARS;
-    const client = opts.client ??
-        createCommissionClient({
-            apiKey: opts.apiKey,
-            baseUrl: opts.baseUrl,
-            ...(opts.fetch ? { fetch: opts.fetch } : {}),
-        });
-    return tool({
-        name: "write_document",
-        description: describe(allowed, design),
-        effect: "destructive",
-        args: [
-            {
-                name: "brief",
-                type: "text",
-                required: true,
-                maxLength: 8000,
-                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: true,
-                options: ["pdf", "pptx", "docx", "md"],
-                description: "pptx for anything presented, pdf for anything sent, docx for anything edited.",
-            },
-            {
-                name: "source",
-                type: "text",
-                required: false,
-                maxLength: 40000,
-                description: "The material it must build from — figures, findings, quotes, an outline — verbatim. " +
-                    "Anything missing here the agent will either omit or invent.",
-            },
-            {
-                name: "design_notes",
-                type: "text",
-                required: false,
-                maxLength: 2000,
-                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: false,
-                description: "Continue an earlier write_document instead of starting over — take it from that " +
-                    "result's sessionId. Use it to revise a document or to recast one into another format.",
-            },
-        ],
-        run: async ({ brief, format, source, design_notes, session_id }) => {
-            if (!allowed.includes(format)) {
-                throw new Error(`write_document was asked for .${format}, which this deployment does not produce ` +
-                    `(${allowed.map((f) => `.${f}`).join(", ")}).`);
-            }
-            const id = await client.create({
-                task: brief,
-                context: source,
-                design: renderDesign(design, format, design_notes),
-                artifacts: [format],
-                ...(session_id ? { sessionId: session_id } : {}),
-            });
-            try {
-                const result = await pollUntilDone(client, id, {
-                    timeoutMs: opts.timeoutMs ?? DEFAULT_TIMEOUT_MS,
-                    settleMs: DEFAULT_SETTLE_MS,
-                    expectArtifacts: true,
-                    ...(opts.signal ? { signal: opts.signal } : {}),
-                });
-                if (result.status === "failed") {
-                    throw new Error(`write_document: Moa task ${id} failed: ${result.error ?? "no reason given"}`);
-                }
-                return delivered(result, design.name, maxChars, opts.includeData === true);
-            }
-            catch (err) {
-                if (err instanceof CommissionAbortedError && opts.cancelOnAbort !== false) {
-                    await client.cancel?.(id).catch(() => undefined);
-                }
-                if (err instanceof CommissionTimeoutError)
-                    return stillRendering(id, design.name, err);
-                throw err;
-            }
-        },
-    });
-}