@avow-finance/sdk 0.0.0-stage → 0.2.0

package/dist/node/first-run.js

@@ -0,0 +1,149 @@
+import { formatUsd } from '@avow-finance/spec';
+import { JOB_COMMAND } from '../session/session.js';
+/** How many steps a first run has, two of setup's and three of the agent session's. */
+export const FIRST_RUN_STEPS = 5;
+const PAUSED_SINCE = {
+    contested: 'the customer contested it',
+    referred: "Avow's records didn't support the report",
+    unanswered: "Avow didn't answer the report in time",
+};
+/** Where a cancelled job's charge stands, in one or two sentences. */
+function chargeLine(ended, clock) {
+    const broke = 'The customer cancelled after work started.';
+    if ('refused' in ended.charge) {
+        return `${broke} Your code couldn't report the charge (${ended.charge.refused}), so the customer's reserve stands as it was.`;
+    }
+    const { amount, standing } = ended.charge;
+    const charge = `${formatUsd(amount)} charge`;
+    switch (standing.state) {
+        case 'confirmed':
+            return `${broke} Your code reported the ${charge} its terms allow, and Avow confirmed it from its record of the customer's signed cancellation. The customer can contest it until ${clock(standing.contestableUntil)}, which would pause it for a ruling, and it's payable to you then if it hasn't.`;
+        case 'paid':
+            return `${broke} The ${charge} was reported, confirmed and paid to your business.`;
+        case 'paused':
+            return `${broke} Your code reported the ${charge}, and it's paused for a ruling since ${PAUSED_SINCE[standing.cause]}. Nothing pays until a ruling is posted.`;
+        default:
+            return `${broke} Your code reported the ${charge}, and Avow hasn't answered the report yet.`;
+    }
+}
+const utc = (seconds) => `${new Date(Number(seconds) * 1000).toISOString().slice(11, 16)} UTC`;
+/** How a job ended, in one line. */
+export function outcomeLine(ended, clock = utc) {
+    if (ended?.kind === 'cancelled')
+        return chargeLine(ended, clock);
+    return ended?.kind === 'paid'
+        ? 'The job is done and paid. Both reserves come back by themselves at their release dates.'
+        : ended?.kind === 'refused'
+            ? `The customer refused the quote with ${ended.refusal.code}, so no work started.`
+            : ended?.kind === 'not_started'
+                ? `Your side didn't accept the job, with ${ended.code} at the ${ended.layer} layer, so no work started.`
+                : ended?.kind === 'stopped'
+                    ? ended.why
+                    : 'No quote went out, so the job ended there.';
+}
+export function firstRunGuide(deps) {
+    const { rail } = deps;
+    let stage = 'first job';
+    /** The transaction that carried the report of the charge, once there is one. */
+    let reportedIn = null;
+    /** What the first job's events said, for the line that closes step 3. */
+    const job = { price: null, reserves: [], releases: [], payment: null };
+    /** The first job's last line: what was paid, that nothing was prepaid, and when reserves return. */
+    function firstJobLine(outcome) {
+        if (outcome?.kind !== 'paid' || job.price === null || job.releases.length === 0) {
+            return outcomeLine(outcome);
+        }
+        const latest = job.releases.reduce((a, b) => (b > a ? b : a));
+        const set = job.reserves.length === 2
+            ? `The ${formatUsd(job.reserves[0])} and ${formatUsd(job.reserves[1])} set aside`
+            : 'What each side set aside';
+        return `Delivered, and paid ${formatUsd(job.price)} on delivery with nothing prepaid. ${set} never moved, and go back on their own by ${deps.clock(latest)}.`;
+    }
+    /** The code that held the agent to its rules, and one change to try. */
+    function yourCode(code) {
+        rail.stage('Your code');
+        rail.quiet(`${code.file} decided what your agent could book and when work could start. Your agent can't read or change it.`);
+        rail.code(code.excerpt.lines);
+        if (code.excerpt.budget !== null && code.excerpt.budget > 2) {
+            rail.quiet(`Try it. Set computeBudgetPerGpuHour to 2, save, and type job. Every firm offer costs more than that, so your agent books nothing and says why.`);
+        }
+    }
+    function end() {
+        if (deps.code)
+            yourCode(deps.code);
+        rail.quiet("You're set up. Type job for another order, job cancels for one the customer cancels, or ask your agent why it chose that compute.");
+        rail.quiet("npm run bypass tries your agent's key against the chain without Avow's SDK, and npm run mcp:claude-code lets Claude drive your agent. Ctrl+C ends the session.");
+        if (deps.modelHelp)
+            rail.quiet(deps.modelHelp);
+    }
+    return {
+        start() {
+            rail.step(3, FIRST_RUN_STEPS, 'Two commitments, nothing prepaid', "Avow's test customer offers your agent a job, paid on delivery. Each side sets aside only what breaking its promise would cost, and checks the other's commitment before it moves.");
+        },
+        watch(event) {
+            if (event.type === 'job_charge_reported')
+                reportedIn = event.transactionHash;
+            if (stage !== 'first job')
+                return;
+            if (event.type === 'job_order_received')
+                job.price = event.price;
+            else if (event.type === 'job_compute_secured' || event.type === 'job_commitment_checked') {
+                // The customer's reserve is said first, so it goes ahead of the compute reserve.
+                if (event.type === 'job_commitment_checked')
+                    job.reserves.unshift(event.amount);
+                else
+                    job.reserves.push(event.amount);
+                job.releases.push(event.releaseDate);
+            }
+            else if (event.type === 'job_paid')
+                job.payment = event.payment.transactionHash;
+        },
+        afterJob(outcome) {
+            if (stage === 'first job') {
+                rail.stepDone(firstJobLine(outcome), { keep: true });
+                if (outcome?.kind === 'paid' && job.payment && deps.transactionUrl) {
+                    rail.quiet('The payment, on chain for anyone to check:');
+                    rail.settle();
+                    deps.write(`${rail.prefix}${deps.transactionUrl(job.payment)}\n`);
+                }
+                rail.step(4, FIRST_RUN_STEPS, 'A broken promise', 'A promise counts when breaking it costs something. On the next order the customer cancels after your work starts, and its reserve backs a charge for that. Type job and press Enter.');
+                stage = 'asking to cancel';
+            }
+            else if (stage === 'cancelling') {
+                rail.stepDone(outcome?.kind === 'cancelled'
+                    ? outcomeLine(outcome, deps.clock)
+                    : `That order ended another way. ${outcomeLine(outcome, deps.clock)}`, { keep: true });
+                if (reportedIn && deps.transactionUrl) {
+                    rail.quiet('The report of the charge, on chain for anyone to check:');
+                    rail.settle();
+                    deps.write(`${rail.prefix}${deps.transactionUrl(reportedIn)}\n`);
+                }
+                rail.step(5, FIRST_RUN_STEPS, 'Break the chain', "While that window runs, see what holds the two commitments together. The customer's commitment depends on yours. Take the next order without booking compute and see what the customer does. Type job and press Enter.");
+                stage = 'asking';
+            }
+            else if (stage === 'breaking') {
+                rail.stepDone(outcome?.kind === 'refused'
+                    ? "The customer refused, and nobody's money moved. Its commitment depends on your compute commitment, and it found none to check. Its check verifies the money and the terms behind your promise. It doesn't promise the compute gets delivered."
+                    : `That order ended another way. ${outcomeLine(outcome, deps.clock)}`, { keep: true });
+                end();
+                stage = 'done';
+            }
+        },
+        withoutCompute: () => stage === 'breaking',
+        scenario: () => (stage === 'cancelling' ? 'cancels_late' : null),
+        input: {
+            inFlight: (what) => deps.input.inFlight(what),
+            async next() {
+                const line = await deps.input.next();
+                if (line !== null && JOB_COMMAND.test(line.trim())) {
+                    if (stage === 'asking to cancel')
+                        stage = 'cancelling';
+                    else if (stage === 'asking')
+                        stage = 'breaking';
+                }
+                return line;
+            },
+        },
+    };
+}
+//# sourceMappingURL=first-run.js.map

package/dist/node/first-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run.js","sourceRoot":"","sources":["../../src/node/first-run.ts"],"names":[],"mappings":"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"}

package/dist/node/job.d.ts

@@ -0,0 +1,50 @@
+import { type SandboxDeployment } from '@avow-finance/spec';
+import type { Look, Rail } from '@avow-finance/terminal';
+import { type SandboxPrompts } from '../sandbox/setup.js';
+import { type SandboxStore } from '../sandbox/store.js';
+import { type SessionInput } from '../session/session.js';
+import type { JobWorld } from '../session/world.js';
+/**
+ * The job chapter in the terminal: `npm start` runs the agent session once setup is done, and
+ * `npm run job` runs one job with no input. Both pick the model as `selectProvider` does, say which
+ * model and who pays before the first call, and run against the live sandbox.
+ */
+export declare const SERVICE_FILE = "service.ts";
+/** The session's flags, read from the command line and the environment. */
+export interface JobFlags {
+    provider: string | null;
+    model: string | null;
+    scripted: boolean;
+    /** `--details`: every tool call, receipt, address and link, as the screen shows them. */
+    details: boolean;
+}
+/** Reads `--provider`, `--model`, `--scripted` and `--details`, refusing anything else. */
+export declare function readJobFlags(args: readonly string[], env: Readonly<Record<string, string | undefined>>): JobFlags | {
+    error: string;
+};
+export declare function runJobSession(o: {
+    mode: 'interactive' | 'one';
+    flags: JobFlags;
+    rail: Rail;
+    look: Look;
+    store: SandboxStore;
+    deployment: SandboxDeployment;
+    dir: string;
+    session: {
+        id: string;
+    };
+    nextRun: () => number;
+    prompts: Pick<SandboxPrompts, 'passphrase' | 'confirm'>;
+    input: SessionInput | null;
+    /** The world to run in, the live sandbox unless a test hands it another. */
+    world?: JobWorld;
+    write?: (text: string) => void;
+    /** The service file and the folder it's in, `service.ts` in the working directory by default. */
+    service?: {
+        file: string;
+        cwd: string;
+    };
+    /** A first run, which goes on from setup's two steps as steps 3 to 5 of 5. */
+    firstRun?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=job.d.ts.map

package/dist/node/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/node/job.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAKxD,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAClF,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGtE,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAMnD;;;;GAIG;AAEH,eAAO,MAAM,YAAY,eAAe,CAAA;AAExC,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA0B9B;AAED,wBAAsB,aAAa,CAAC,CAAC,EAAE;IACrC,IAAI,EAAE,aAAa,GAAG,KAAK,CAAA;IAC3B,KAAK,EAAE,QAAQ,CAAA;IACf,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV,KAAK,EAAE,YAAY,CAAA;IACnB,UAAU,EAAE,iBAAiB,CAAA;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,SAAS,CAAC,CAAA;IACvD,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,iGAAiG;IACjG,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoHlB"}

package/dist/node/job.js

@@ -0,0 +1,176 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { formatUsd, } from '@avow-finance/spec';
+import { Account } from 'viem/tempo';
+import { agentRequestKey } from '../http.js';
+import { moderatoTransactionUrl } from '../moderato.js';
+import { sessionReporter } from '../sandbox/agent.js';
+import { cancelSandboxCommitment } from '../sandbox/setup.js';
+import { loadAgentItem } from '../sandbox/store.js';
+import { liveWorld } from '../session/live-world.js';
+import { selectProvider } from '../session/selection.js';
+import { runSession } from '../session/session.js';
+import { firstRunGuide, outcomeLine } from './first-run.js';
+import { serviceExcerpt } from './service-excerpt.js';
+import { readServicePolicy, runCheckBeforeWork } from './service-process.js';
+import { localClock, railView } from './session-view.js';
+/**
+ * The job chapter in the terminal: `npm start` runs the agent session once setup is done, and
+ * `npm run job` runs one job with no input. Both pick the model as `selectProvider` does, say which
+ * model and who pays before the first call, and run against the live sandbox.
+ */
+export const SERVICE_FILE = 'service.ts';
+/** Reads `--provider`, `--model`, `--scripted` and `--details`, refusing anything else. */
+export function readJobFlags(args, env) {
+    const flags = {
+        provider: env.AVOW_MODEL_PROVIDER?.trim() || null,
+        model: env.AVOW_MODEL?.trim() || null,
+        scripted: false,
+        details: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const [name, inline] = arg.split('=', 2);
+        const value = () => {
+            const v = inline ?? args[++i];
+            if (!v || v.startsWith('--'))
+                throw new Error(`${name} needs a value`);
+            return v;
+        };
+        try {
+            if (name === '--scripted')
+                flags.scripted = true;
+            else if (name === '--details')
+                flags.details = true;
+            else if (name === '--provider')
+                flags.provider = value();
+            else if (name === '--model')
+                flags.model = value();
+            else
+                return { error: `There's no option ${arg} here.` };
+        }
+        catch (error) {
+            return { error: error.message };
+        }
+    }
+    return flags;
+}
+export async function runJobSession(o) {
+    const { rail, store, deployment } = o;
+    const write = o.write ?? ((text) => void process.stdout.write(text));
+    const service = o.service ?? { file: SERVICE_FILE, cwd: process.cwd() };
+    const chosen = await selectProvider({ ...o.flags, env: process.env });
+    if (!chosen.ok) {
+        rail.fail(chosen.why);
+        for (const line of chosen.help)
+            rail.quiet(line);
+        return 1;
+    }
+    let world;
+    try {
+        world =
+            o.world ??
+                (await liveWorld({
+                    store,
+                    deployment,
+                    cancelFree: async (booking, onLock) => {
+                        // The developer sees what's being cancelled before the passphrase is asked for.
+                        const left = Number((onLock.freeCancelBy - onLock.block.timestamp) / 60n);
+                        const sure = await o.prompts.confirm(`Your agent asks to cancel booking ${booking.id}. Cancel it?`, [
+                            `${booking.gpus} ${booking.offer.gpu} of ${booking.offer.id} from ${booking.offer.supplier}, with ${formatUsd(booking.reserve)} reserved.`,
+                            `Free cancellation is still open, for about ${Math.max(left, 0)} more minutes, so cancelling gives the whole reserve back.`,
+                            "Only your business's key can cancel on the lock, so it asks for your passphrase next.",
+                        ]);
+                        if (!sure)
+                            return null;
+                        return cancelSandboxCommitment({
+                            commitmentId: booking.reference.commitmentId,
+                            prompts: o.prompts,
+                            store,
+                            deployment,
+                        });
+                    },
+                }));
+    }
+    catch (error) {
+        rail.fail(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+    // The session's events go to the screen signed by the agent's key, as its runs' events do.
+    const agent = await loadAgentItem(store);
+    const post = agent
+        ? sessionReporter({
+            session: { id: o.session.id, run: 1 },
+            key: agentRequestKey(Account.fromSecp256k1(agent.agentKey, { access: agent.business.account })),
+            domain: {
+                chainId: deployment.chainId,
+                verifyingContract: agent.business.lock,
+            },
+            apiUrl: deployment.apiUrl,
+            fetch: (input, init) => fetch(input, init),
+            log: (line) => rail.quiet(line),
+        })
+        : () => { };
+    const brief = !o.flags.details;
+    const view = railView(rail, o.look, { fixture: world.kind === 'fixture', write, brief });
+    // A first run goes on from setup's two steps, with a guide for steps 3 to 5, and ends on the
+    // service file's deciding lines.
+    const guided = o.firstRun === true && o.mode === 'interactive' && o.input !== null;
+    const excerpt = guided
+        ? await readFile(resolve(service.cwd, service.file), 'utf8').then(serviceExcerpt, () => null)
+        : null;
+    const guide = guided && o.input !== null
+        ? firstRunGuide({
+            rail,
+            input: o.input,
+            clock: localClock,
+            write,
+            transactionUrl: world.kind === 'live' ? moderatoTransactionUrl : null,
+            modelHelp: chosen.fallback ? (chosen.fallback.help[0] ?? null) : null,
+            code: excerpt ? { file: service.file, excerpt } : null,
+        })
+        : null;
+    const emit = (event) => {
+        view.event(event);
+        if (world.kind === 'live')
+            post(event);
+        guide?.watch(event);
+    };
+    if (guide)
+        guide.start();
+    else if (o.mode === 'one')
+        rail.stage('One job, with no input');
+    // A guided run's Model line names the scripted decisions, and how to get a model comes at the end.
+    if (chosen.fallback && !guide) {
+        rail.quiet(chosen.fallback.why);
+        for (const line of chosen.fallback.help)
+            rail.quiet(line);
+    }
+    const result = await runSession({
+        world,
+        provider: chosen.provider,
+        readPolicy: () => readServicePolicy(service.file, service.cwd),
+        checkBeforeWork: async (job) => runCheckBeforeWork(service.file, job, await world.chainFor(job), service.cwd),
+        emit,
+        view,
+        input: guide ? guide.input : o.mode === 'one' ? null : o.input,
+        nextRun: o.nextRun,
+        brief,
+        ...(guide
+            ? {
+                afterJob: (outcome) => guide.afterJob(outcome),
+                withoutCompute: guide.withoutCompute,
+                scenario: guide.scenario,
+            }
+            : {}),
+    });
+    if (result.stopped)
+        return 1;
+    const ended = result.firstJob;
+    if (o.mode === 'one') {
+        rail.close(outcomeLine(ended, localClock));
+        return ended?.kind === 'paid' ? 0 : 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=job.js.map

package/dist/node/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../src/node/job.ts"],"names":[],"mappings":"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"}

package/dist/node/mailbox.d.ts

@@ -0,0 +1,19 @@
+/** What `avow-sandbox order` takes, read from its arguments, or why it can't run. */
+export declare function readOrderArgs(args: readonly string[]): {
+    supplier: string;
+    expiresIn: bigint;
+} | {
+    error: string;
+};
+/**
+ * `avow-sandbox order --supplier <id>`. Orders the demo job from another business and sees it
+ * through: waits for the quote, checks it, funds the commitment and waits for the acceptance. An
+ * order to that business this agent sent and didn't see through is picked up instead.
+ */
+export declare function orderCommand(args: readonly string[]): Promise<void>;
+/**
+ * `avow-sandbox listen`. Reads this business's inbox every few seconds and takes each order's next
+ * step, until stopped. Orders that arrive while it isn't running wait in the inbox until they lapse.
+ */
+export declare function listenCommand(): Promise<void>;
+//# sourceMappingURL=mailbox.d.ts.map

package/dist/node/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../src/node/mailbox.ts"],"names":[],"mappings":"AAIA,qFAAqF;AACrF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAc7D;AAKD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BzE;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAWnD"}

package/dist/node/mailbox.js

@@ -0,0 +1,81 @@
+import { mailboxStatusAt } from '@avow-finance/spec';
+import { MAILBOX_ORDER_SECONDS, sandboxMailbox } from '../sandbox/mailbox.js';
+import { fileStore } from './platform.js';
+/** What `avow-sandbox order` takes, read from its arguments, or why it can't run. */
+export function readOrderArgs(args) {
+    let supplier = null;
+    let expiresIn = MAILBOX_ORDER_SECONDS;
+    for (let i = 0; i < args.length; i += 2) {
+        const flag = args[i];
+        const value = args[i + 1];
+        if (value === undefined || value.startsWith('--'))
+            return { error: `${flag} needs a value` };
+        if (flag === '--supplier')
+            supplier = value;
+        else if (flag === '--expires-in' && /^[1-9][0-9]{0,4}$/.test(value))
+            expiresIn = BigInt(value);
+        else if (flag === '--expires-in')
+            return { error: '--expires-in takes whole seconds' };
+        else
+            return { error: `order doesn't take ${flag}` };
+    }
+    if (!supplier)
+        return { error: 'order needs --supplier, the business ID of the agent that sells' };
+    return { supplier, expiresIn };
+}
+const describe = (order) => `${order.orderId} for ${order.supplierBusinessId}, ${mailboxStatusAt(order, BigInt(Math.floor(Date.now() / 1000)))}`;
+/**
+ * `avow-sandbox order --supplier <id>`. Orders the demo job from another business and sees it
+ * through: waits for the quote, checks it, funds the commitment and waits for the acceptance. An
+ * order to that business this agent sent and didn't see through is picked up instead.
+ */
+export async function orderCommand(args) {
+    const read = readOrderArgs(args);
+    if ('error' in read) {
+        console.error(read.error);
+        process.exit(1);
+    }
+    const stop = new AbortController();
+    process.once('SIGINT', () => stop.abort(new Error('Stopped waiting')));
+    const mailbox = await sandboxMailbox({ store: fileStore() });
+    // An order this agent sent before it stopped is seen through first, so none is sent twice.
+    const left = (await mailbox.unfinished()).find((r) => r.supplierBusinessId === read.supplier);
+    if (left)
+        console.log(`Picking up order ${left.orderId}, sent before this agent stopped.`);
+    const outcome = await mailbox.buy({
+        supplier: read.supplier,
+        ...(left ? { resume: left.orderId } : {}),
+        expiresIn: read.expiresIn,
+        signal: stop.signal,
+        onStep: (step) => {
+            if (step.step === 'ordered')
+                console.log(`Ordered ${describe(step.order)}. Nothing is reserved.`);
+            else if (step.step === 'quoted')
+                console.log('Quoted. Checking the terms and the booking they rely on.');
+            else if (step.step === 'reserved')
+                console.log('Funded. Waiting for the supplier to accept.');
+            else
+                console.log('Accepted.');
+        },
+    });
+    if (!outcome.ok) {
+        console.error(`Stopped at ${describe(outcome.order)}: ${outcome.reason}`);
+        process.exit(1);
+    }
+}
+/**
+ * `avow-sandbox listen`. Reads this business's inbox every few seconds and takes each order's next
+ * step, until stopped. Orders that arrive while it isn't running wait in the inbox until they lapse.
+ */
+export async function listenCommand() {
+    const stop = new AbortController();
+    process.once('SIGINT', () => stop.abort());
+    const mailbox = await sandboxMailbox({ store: fileStore() });
+    console.log(`Listening for orders to ${mailbox.businessId}. Stop with Ctrl+C.`);
+    await mailbox.listen({
+        signal: stop.signal,
+        onStep: (order, step) => console.log(`${order.orderId}: ${step.step}`),
+        onError: (order, error) => console.error(`${order.orderId}: ${error instanceof Error ? error.message : String(error)}`),
+    });
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/node/mailbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.js","sourceRoot":"","sources":["../../src/node/mailbox.ts"],"names":[],"mappings":"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"}

package/dist/node/mcp.d.ts

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import { SANDBOX_TOOLS } from '@avow-finance/spec';
+/** The tools, kept to what shows the authority model and nothing more. */
+export declare const MCP_TOOLS: readonly [{
+    readonly name: 'authority';
+    readonly description: "What your agent can commit right now. It has two limits. It holds at most so much in bookings at once, which Avow refuses past and the lock checks against Avow's approval. Its key moves at most so much a day, a limit the business set on chain. It names the suppliers the agent may book too.";
+    readonly inputSchema: {
+        readonly type: 'object';
+        readonly properties: {};
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: 'book';
+    readonly description: "Books GPU capacity with one of your agent's suppliers, backed by a reserve in your business's own lock. Avow checks the booking against the mandate and what the lock holds before any money moves, the agent's machine runs the open verifier, and the supplier accepts on the lock. A refusal comes back with its reason code, the layer that refused it, the amounts and when the same booking could pass. A reserve that never landed with no reason given comes back as a failure. Held reserves come back as bookings end or are cancelled, the key's daily limit starts again each day, Avow's relay can be limiting how much it takes for now, and anything else in the mandate changes only when the business signs a new one.";
+    readonly inputSchema: {
+        readonly type: 'object';
+        readonly properties: {
+            readonly reserve: {
+                readonly type: 'number';
+                readonly description: 'The reserve in dollars, such as 200';
+            };
+            readonly gpu: {
+                readonly type: 'string';
+                readonly description: 'The GPU model, H100 when left out';
+            };
+            readonly count: {
+                readonly type: 'integer';
+                readonly description: 'How many GPUs, 8 when left out';
+            };
+            readonly hours: {
+                readonly type: 'number';
+                readonly description: 'How many hours, 1 when left out';
+            };
+            readonly supplier: {
+                readonly type: 'string';
+                readonly description: "The supplier's business id, the agent's first supplier when left out";
+            };
+        };
+        readonly required: readonly ["reserve"];
+        readonly additionalProperties: false;
+    };
+}, {
+    readonly name: 'commitments';
+    readonly description: 'Lists every commitment your agent made, with its state on the lock, whether the current authority made it, and a link anyone can open to check it.';
+    readonly inputSchema: {
+        readonly type: 'object';
+        readonly properties: {};
+        readonly additionalProperties: false;
+    };
+}];
+export interface ToolAnswer {
+    text: string;
+    structured: Record<string, unknown>;
+    isError: boolean;
+}
+/** The MCP agent for one folder, answering each tool call through the SDK's agent. */
+export declare function mcpAgent(dir: string, options?: {
+    fetch?: typeof fetch;
+}): {
+    call(name: string, args: Record<string, unknown>): Promise<ToolAnswer>;
+};
+/** Serves MCP over stdio, a JSON-RPC message per line, for the agent in `dir`. */
+export declare function serve(dir: string, io?: {
+    input: NodeJS.ReadStream & {
+        fd: 0;
+    };
+    output: NodeJS.WriteStream & {
+        fd: 1;
+    };
+}): void;
+/** Where Claude Desktop keeps its MCP servers on this platform. */
+export declare function claudeDesktopConfig(): string;
+export { SANDBOX_TOOLS };
+//# sourceMappingURL=mcp.d.ts.map

package/dist/node/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/node/mcp.ts"],"names":[],"mappings":";AAcA,OAAO,EAGL,aAAa,EAId,MAAM,oBAAoB,CAAA;AA0B3B,0EAA0E;AAC1E,eAAO,MAAM,SAAS;mBAEZ,WAAW;0BAEf,oSAAoS;;uBAPlR,QAAQ;;;;;mBAWtB,MAAM;0BAEV,ysBAAysB;;iBAEzsB,IAAI,EAAE,QAAQ;iBACd,UAAU;qBACR,OAAO;yBAAI,IAAI,EAAE,QAAQ;yBAAE,WAAW,EAAE,qCAAqC;;qBAC7E,GAAG;yBAAI,IAAI,EAAE,QAAQ;yBAAE,WAAW,EAAE,mCAAmC;;qBACvE,KAAK;yBAAI,IAAI,EAAE,SAAS;yBAAE,WAAW,EAAE,gCAAgC;;qBACvE,KAAK;yBAAI,IAAI,EAAE,QAAQ;yBAAE,WAAW,EAAE,iCAAiC;;qBACvE,QAAQ;yBACN,IAAI,EAAE,QAAQ;yBACd,WAAW,EAAE,sEAAsE;;;iBAGvF,QAAQ;iBACR,oBAAoB;;;mBAIhB,aAAa;0BAEjB,oJAAoJ;;;;;;EAG3D,CAAA;AAE/F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,OAAO,EAAE,OAAO,CAAA;CACjB;AAmBD,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO;IAsJlE,IAAI,OAAO,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;EAe/E;AAID,kFAAkF;AAClF,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IAAK,KAAK;;;IAAiB,MAAM;;;CAAkB,GAAG,IAAI,CA0D9F;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,IAAI,MAAM,CAY5C;AAiED,OAAO,EAAE,aAAa,EAAE,CAAA"}