@avow-finance/sdk 0.0.0-stage → 0.2.0

package/dist/node/mcp.js

@@ -0,0 +1,367 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { copyFileSync, existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { createInterface } from 'node:readline';
+import { fileURLToPath } from 'node:url';
+import { formatUsd, isSessionId, SANDBOX_TOOLS, toWire, whenRetryPasses, } from '@avow-finance/spec';
+import { Refusal, sandboxAgent } from '../sandbox/agent.js';
+import { sessionUrl } from '../sandbox/session.js';
+import { fileStore, SANDBOX_DIR, takeRun } from './platform.js';
+/**
+ * `avow-sandbox-mcp` gives a model in Claude Code, Claude Desktop or any other MCP client the
+ * starter's agent, with three tools. It runs as the agent, with only the agent's key, through the
+ * same SDK calls agent.ts makes, and it never opens the business's key. Each tool call reports to
+ * the screen the runner opened, marked as the MCP agent's.
+ *
+ *   avow-sandbox-mcp [--dir <folder>]          serves MCP over stdio for the agent in <folder>
+ *   avow-sandbox-mcp add claude-code           adds the server to Claude Code for this folder
+ *   avow-sandbox-mcp add claude-desktop        adds the server to Claude Desktop
+ */
+const SERVER = { name: 'avow-sandbox', version: '0.0.0' };
+const PROTOCOL = '2025-06-18';
+/** How long a booking waits for the supplier's acceptance before it answers. */
+const ACCEPTANCE_WAIT_MS = 45_000;
+const usd = (dollars) => dollars === null ? 'no limit' : formatUsd(BigInt(Math.round(dollars * 1_000_000)));
+const noInput = { type: 'object', properties: {}, additionalProperties: false };
+/** The tools, kept to what shows the authority model and nothing more. */
+export const MCP_TOOLS = [
+    {
+        name: 'authority',
+        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.",
+        inputSchema: noInput,
+    },
+    {
+        name: 'book',
+        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.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                reserve: { type: 'number', description: 'The reserve in dollars, such as 200' },
+                gpu: { type: 'string', description: 'The GPU model, H100 when left out' },
+                count: { type: 'integer', description: 'How many GPUs, 8 when left out' },
+                hours: { type: 'number', description: 'How many hours, 1 when left out' },
+                supplier: {
+                    type: 'string',
+                    description: "The supplier's business id, the agent's first supplier when left out",
+                },
+            },
+            required: ['reserve'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'commitments',
+        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.',
+        inputSchema: noInput,
+    },
+];
+/** The session the runner opened in this folder, while the runner still runs. */
+function runnerSession(dir) {
+    try {
+        const { id, pid } = JSON.parse(readFileSync(join(dir, SANDBOX_DIR, 'session.json'), 'utf8'));
+        if (typeof id !== 'string' || !isSessionId(id) || typeof pid !== 'number')
+            return null;
+        process.kill(pid, 0);
+        return id;
+    }
+    catch {
+        return null;
+    }
+}
+/** The MCP agent for one folder, answering each tool call through the SDK's agent. */
+export function mcpAgent(dir, options = {}) {
+    const store = fileStore(join(dir, SANDBOX_DIR));
+    const log = (line) => process.stderr.write(`${line}\n`);
+    async function open(tool) {
+        const id = runnerSession(dir);
+        return sandboxAgent({
+            store,
+            session: id ? { id, run: takeRun(join(dir, SANDBOX_DIR), id) } : null,
+            source: 'mcp',
+            tool,
+            log,
+            ...(options.fetch ? { fetch: options.fetch } : {}),
+        });
+    }
+    const screen = () => {
+        const id = runnerSession(dir);
+        return id ? sessionUrl(id) : null;
+    };
+    async function authority() {
+        const agent = await open('authority');
+        const left = await agent.left();
+        const dailyLeft = await agent.dailyLeft();
+        const now = dailyLeft === null ? left : Math.min(left, dailyLeft);
+        return {
+            text: [
+                `Your agent can commit up to ${usd(now)} more right now.`,
+                `It holds at most ${usd(agent.authority)} in bookings at once, which Avow refuses past and the lock checks against Avow's approval, and ${usd(left)} of that is free.`,
+                `Its key moves at most ${usd(agent.dailyLimit)} a day, a limit your business set on chain, and ${usd(dailyLeft)} of today's is left.`,
+                `It may book with ${agent.suppliers.map((s) => s.id).join(', ')} only.`,
+            ].join(' '),
+            structured: {
+                canCommitNow: now,
+                heldAtOnce: { limit: agent.authority, left },
+                movedPerDay: { limit: agent.dailyLimit, left: dailyLeft },
+                suppliers: agent.suppliers,
+                business: agent.business,
+                mandateHash: agent.mandateHash,
+                screen: screen(),
+            },
+            isError: false,
+        };
+    }
+    async function book(args) {
+        const reserve = args.reserve;
+        if (typeof reserve !== 'number')
+            throw new RangeError('The booking needs a reserve in dollars');
+        const agent = await open('book');
+        const gpu = typeof args.gpu === 'string' ? args.gpu : 'H100';
+        const count = typeof args.count === 'number' ? args.count : 8;
+        const hours = typeof args.hours === 'number' ? args.hours : 1;
+        const supplier = typeof args.supplier === 'string' ? args.supplier : (agent.suppliers[0]?.id ?? '');
+        try {
+            const c = await agent.book({ supplier, resource: { gpu, count, hours }, reserve });
+            const checks = await c.verify();
+            const accepted = await Promise.race([
+                c.accepted(),
+                new Promise((done) => setTimeout(() => done(null), ACCEPTANCE_WAIT_MS).unref()),
+            ]);
+            const passed = checks.filter((k) => k.passed).length;
+            return {
+                text: [
+                    `Committed ${usd(c.amount)} with ${supplier} for ${count} ${gpu} for ${hours} hour${hours === 1 ? '' : 's'}.`,
+                    accepted === true
+                        ? 'The supplier checked the commitment and accepted it on the lock.'
+                        : accepted === false
+                            ? "The supplier didn't accept it in time, so the reserve goes back to the business."
+                            : "The supplier hasn't accepted it yet, and the commitments tool shows when it does.",
+                    `On this machine the open verifier passed ${passed} of ${checks.length} checks.`,
+                    `Your agent has ${usd(c.left)} left of its ${usd(agent.authority)} held at once.`,
+                    `Anyone can check the commitment at ${c.link}`,
+                ].join(' '),
+                structured: {
+                    status: 'committed',
+                    reserve: c.amount,
+                    supplier,
+                    resource: { gpu, count, hours },
+                    accepted,
+                    checks,
+                    reference: toWire(c.reference),
+                    link: c.link,
+                    left: c.left,
+                    screen: screen(),
+                },
+                isError: false,
+            };
+        }
+        catch (error) {
+            if (!(error instanceof Refusal))
+                throw error;
+            const dollars = (micros) => micros === null ? null : Number(micros) / 1_000_000;
+            // A reserve that never landed with no reason given is a failure, and nothing refused it.
+            const failed = error.layer === 'unknown';
+            return {
+                text: failed
+                    ? `The booking failed, with reason code ${error.code}. ${error.message}`
+                    : `Refused by ${error.layer === 'sdk' ? 'the SDK' : error.layer}, with reason code ${error.code}. ${error.message}`,
+                structured: {
+                    status: failed ? 'failed' : 'refused',
+                    code: error.code,
+                    layer: error.layer,
+                    sentence: error.message,
+                    retry: whenRetryPasses(error),
+                    amounts: {
+                        needed: dollars(error.amounts.needed),
+                        left: dollars(error.amounts.left),
+                        heldAtOnce: dollars(error.amounts.authority),
+                        perCommitment: dollars(error.amounts.capPerCommitment),
+                        movedPerDay: dollars(error.amounts.dailyLimit),
+                        movedToday: dollars(error.amounts.dailyLeft),
+                    },
+                    screen: screen(),
+                },
+                isError: false,
+            };
+        }
+    }
+    async function commitments() {
+        const agent = await open('commitments');
+        const list = await agent.commitments();
+        return {
+            text: list.length === 0
+                ? 'Your agent has made no commitments yet.'
+                : list
+                    .map((c) => `${usd(c.amount)} with ${c.supplier}, ${c.state}${c.current ? '' : ', made under an earlier authority'}, at ${new Date(Number(c.madeAt) * 1000).toISOString()}. Check it at ${c.link}`)
+                    .join('\n'),
+            structured: {
+                commitments: list.map((c) => ({
+                    amount: c.amount,
+                    supplier: c.supplier,
+                    state: c.state,
+                    current: c.current,
+                    madeAt: Number(c.madeAt),
+                    releaseDate: c.releaseDate === null ? null : Number(c.releaseDate),
+                    reference: toWire(c.reference),
+                    link: c.link,
+                })),
+            },
+            isError: false,
+        };
+    }
+    return {
+        async call(name, args) {
+            try {
+                if (name === 'authority')
+                    return await authority();
+                if (name === 'book')
+                    return await book(args);
+                if (name === 'commitments')
+                    return await commitments();
+                return { text: `There's no tool named ${name}.`, structured: {}, isError: true };
+            }
+            catch (error) {
+                return {
+                    text: error instanceof Error ? error.message : String(error),
+                    structured: {},
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+/** Serves MCP over stdio, a JSON-RPC message per line, for the agent in `dir`. */
+export function serve(dir, io = { input: process.stdin, output: process.stdout }) {
+    const agent = mcpAgent(dir);
+    const write = (message) => io.output.write(`${JSON.stringify({ jsonrpc: '2.0', ...message })}\n`);
+    const lines = createInterface({ input: io.input });
+    lines.on('line', async (line) => {
+        if (line.trim() === '')
+            return;
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            write({ id: null, error: { code: -32700, message: 'Parse error' } });
+            return;
+        }
+        const { id, method } = message;
+        // A notification, which has no id, gets no answer.
+        if (id === undefined || id === null)
+            return;
+        const params = (message.params ?? {});
+        switch (method) {
+            case 'initialize': {
+                const asked = params.protocolVersion;
+                write({
+                    id,
+                    result: {
+                        protocolVersion: typeof asked === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(asked) ? asked : PROTOCOL,
+                        capabilities: { tools: { listChanged: false } },
+                        serverInfo: SERVER,
+                        instructions: "These tools act as one business's agent on Avow's sandbox, on Tempo's testnet, with test dollars. The agent commits the business only within the mandate the business signed. A refusal comes from the SDK checking the mandate on this machine, from Avow, from Avow's relay, from the lock or from the account's keychain. It names which, gives the reason code and the amounts, and says when the same booking could pass. A reserve that never landed with no reason given comes back as a failure, and the same booking might pass on another try.",
+                    },
+                });
+                return;
+            }
+            case 'ping':
+                write({ id, result: {} });
+                return;
+            case 'tools/list':
+                write({ id, result: { tools: MCP_TOOLS } });
+                return;
+            case 'tools/call': {
+                const name = typeof params.name === 'string' ? params.name : '';
+                const args = (params.arguments ?? {});
+                const answer = await agent.call(name, args);
+                write({
+                    id,
+                    result: {
+                        content: [{ type: 'text', text: answer.text }],
+                        structuredContent: answer.structured,
+                        isError: answer.isError,
+                    },
+                });
+                return;
+            }
+            default:
+                write({ id, error: { code: -32601, message: `Method not found: ${method}` } });
+        }
+    });
+}
+/** Where Claude Desktop keeps its MCP servers on this platform. */
+export function claudeDesktopConfig() {
+    if (process.platform === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    if (process.platform === 'win32') {
+        return join(process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+    }
+    return join(homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+}
+/** Adds the server to Claude Code for this folder, or to Claude Desktop, against this folder's agent. */
+function add(client, dir) {
+    const server = realpathSync(fileURLToPath(import.meta.url));
+    const args = [server, '--dir', dir];
+    if (!existsSync(join(dir, SANDBOX_DIR, 'agent.json'))) {
+        console.log('This folder has no agent yet. Run npm start first, then add the server.');
+    }
+    if (client === 'claude-code') {
+        const line = ['claude', 'mcp', 'add', SERVER.name, '--', process.execPath, ...args];
+        const result = spawnSync(line[0], line.slice(1), {
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+        if (result.error || result.status !== 0) {
+            console.log(`\nClaude Code didn't take it. Run this in this folder yourself:\n\n  ${line.map((a) => JSON.stringify(a)).join(' ')}\n`);
+            return 1;
+        }
+        console.log('\nAdded. Run claude in this folder and ask it to book $200 of GPU compute.');
+        return 0;
+    }
+    if (client === 'claude-desktop') {
+        const file = claudeDesktopConfig();
+        let config = {};
+        if (existsSync(file)) {
+            config = JSON.parse(readFileSync(file, 'utf8'));
+            copyFileSync(file, `${file}.bak`);
+        }
+        config.mcpServers = {
+            ...(config.mcpServers ?? {}),
+            [SERVER.name]: { command: process.execPath, args },
+        };
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, `${JSON.stringify(config, null, 2)}\n`);
+        console.log(`Added to ${file}. Restart Claude Desktop and ask it to book $200 of GPU compute.`);
+        return 0;
+    }
+    console.error('Use avow-sandbox-mcp add claude-code, or avow-sandbox-mcp add claude-desktop.');
+    return 1;
+}
+/** Runs only as the command, so a test can import the server. */
+const isMain = (() => {
+    try {
+        return realpathSync(process.argv[1] ?? '') === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+})();
+if (isMain) {
+    const argv = process.argv.slice(2);
+    if (argv[0] === 'add') {
+        process.exitCode = add(argv[1], process.cwd());
+    }
+    else {
+        const at = argv.indexOf('--dir');
+        const dir = resolve(at >= 0 ? (argv[at + 1] ?? '.') : '.');
+        // Standard output carries the protocol, so anything the SDK prints goes to standard error.
+        console.log = (...items) => console.error(...items);
+        serve(dir);
+    }
+}
+export { SANDBOX_TOOLS };
+//# sourceMappingURL=mcp.js.map

package/dist/node/mcp.js.map

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

package/dist/node/platform.d.ts

@@ -0,0 +1,35 @@
+import type { SandboxPlatform } from '../sandbox/agent.js';
+import type { SandboxStore } from '../sandbox/store.js';
+/** The folder in the working directory where the sandbox keeps its keys and its setup. */
+export declare const SANDBOX_DIR = ".avow";
+/**
+ * A sandbox store in a folder on this machine. Each item is a JSON file only its owner can read,
+ * written whole through a temporary file, and the folder ignores itself in git. The business's
+ * root key in it is sealed under the passphrase, so reading the folder doesn't give the key.
+ */
+export declare function fileStore(dir?: string): SandboxStore;
+/** What the runner sets for each run of the agent it starts, and nothing else of its own. */
+export declare const RUNNER_ENV: {
+    readonly session: 'AVOW_SANDBOX_SESSION';
+    readonly run: 'AVOW_SANDBOX_RUN';
+};
+/** The highest run number taken in a session so far, or 0 when none is. */
+export declare function latestRun(dir: string, session: string): number;
+/**
+ * Marks every run number up to `run` as taken in a session, so a session kept across a restart
+ * goes on from the last run Avow's relay holds, even when this folder lost its own count.
+ */
+export declare function takenUpTo(dir: string, session: string, run: number): void;
+/**
+ * Takes the next run number in a session, in the sandbox folder `dir`. The runner and the MCP
+ * server both start runs, and the screen tells runs apart by number, so each claims its number by
+ * creating a file named for it, which only one process can create. A restarted MCP server goes on
+ * from the numbers already taken.
+ */
+export declare function takeRun(dir: string, session: string): number;
+/**
+ * The sandbox's defaults in Node. Everything goes in the working directory's `.avow` folder, and a
+ * run the runner started reports to the session it opened.
+ */
+export declare const nodePlatform: SandboxPlatform;
+//# sourceMappingURL=platform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/node/platform.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,0FAA0F;AAC1F,eAAO,MAAM,WAAW,UAAU,CAAA;AAKlC;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAyC,GAAG,YAAY,CAuBtF;AAED,6FAA6F;AAC7F,eAAO,MAAM,UAAU;aACrB,OAAO,EAAE,sBAAsB;aAC/B,GAAG,EAAE,kBAAkB;CACf,CAAA;AAOV,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO9D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,eAO1B,CAAA"}

package/dist/node/platform.js

@@ -0,0 +1,102 @@
+import { mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { isSessionId } from '@avow-finance/spec';
+/** The folder in the working directory where the sandbox keeps its keys and its setup. */
+export const SANDBOX_DIR = '.avow';
+/** What the sandbox's folder tells git, so nothing in it ever reaches a commit. */
+const IGNORE_ALL = '# The sandbox keeps its keys here. Never commit them.\n*\n';
+/**
+ * A sandbox store in a folder on this machine. Each item is a JSON file only its owner can read,
+ * written whole through a temporary file, and the folder ignores itself in git. The business's
+ * root key in it is sealed under the passphrase, so reading the folder doesn't give the key.
+ */
+export function fileStore(dir = join(process.cwd(), SANDBOX_DIR)) {
+    const file = (item) => join(dir, `${item}.json`);
+    return {
+        async read(item) {
+            try {
+                return await readFile(file(item), 'utf8');
+            }
+            catch (error) {
+                if (error.code === 'ENOENT')
+                    return null;
+                throw error;
+            }
+        },
+        async write(item, text) {
+            await mkdir(dir, { recursive: true, mode: 0o700 });
+            await writeFile(join(dir, '.gitignore'), IGNORE_ALL, { flag: 'wx' }).catch((error) => {
+                if (error.code !== 'EEXIST')
+                    throw error;
+            });
+            const temporary = `${file(item)}.${process.pid}.tmp`;
+            await writeFile(temporary, text, { mode: 0o600 });
+            await rename(temporary, file(item));
+        },
+    };
+}
+/** What the runner sets for each run of the agent it starts, and nothing else of its own. */
+export const RUNNER_ENV = {
+    session: 'AVOW_SANDBOX_SESSION',
+    run: 'AVOW_SANDBOX_RUN',
+};
+function runsDir(dir, session) {
+    if (!isSessionId(session))
+        throw new RangeError(`${session} isn't a session id`);
+    return join(dir, 'runs', session);
+}
+/** The highest run number taken in a session so far, or 0 when none is. */
+export function latestRun(dir, session) {
+    try {
+        const taken = readdirSync(runsDir(dir, session)).map(Number).filter(Number.isSafeInteger);
+        return Math.max(0, ...taken);
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Marks every run number up to `run` as taken in a session, so a session kept across a restart
+ * goes on from the last run Avow's relay holds, even when this folder lost its own count.
+ */
+export function takenUpTo(dir, session, run) {
+    if (run < 1 || latestRun(dir, session) >= run)
+        return;
+    const runs = runsDir(dir, session);
+    mkdirSync(runs, { recursive: true, mode: 0o700 });
+    writeFileSync(join(runs, String(run)), '', { mode: 0o600 });
+}
+/**
+ * Takes the next run number in a session, in the sandbox folder `dir`. The runner and the MCP
+ * server both start runs, and the screen tells runs apart by number, so each claims its number by
+ * creating a file named for it, which only one process can create. A restarted MCP server goes on
+ * from the numbers already taken.
+ */
+export function takeRun(dir, session) {
+    const runs = runsDir(dir, session);
+    mkdirSync(runs, { recursive: true, mode: 0o700 });
+    for (let run = latestRun(dir, session) + 1;; run += 1) {
+        try {
+            writeFileSync(join(runs, String(run)), '', { flag: 'wx', mode: 0o600 });
+            return run;
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+        }
+    }
+}
+/**
+ * The sandbox's defaults in Node. Everything goes in the working directory's `.avow` folder, and a
+ * run the runner started reports to the session it opened.
+ */
+export const nodePlatform = {
+    store: () => fileStore(),
+    session: () => {
+        const id = process.env[RUNNER_ENV.session];
+        const run = Number(process.env[RUNNER_ENV.run]);
+        return id && isSessionId(id) && Number.isInteger(run) && run > 0 ? { id, run } : null;
+    },
+};
+//# sourceMappingURL=platform.js.map

package/dist/node/platform.js.map

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

package/dist/node/runner-session.d.ts

@@ -0,0 +1,41 @@
+import { type Address } from 'viem';
+/** How long before Avow's relay closes a session the runner moves to a new one, in seconds. */
+export declare const SESSION_MARGIN = 600n;
+/** The session the runner reports to. */
+export interface RunnerSession {
+    id: string;
+    /** Whether the session hasn't had the agent's authority yet, so the runner announces it. */
+    fresh: boolean;
+    /** When Avow's relay stops taking the session's events, in unix seconds, or null while unknown. */
+    endsAt: bigint | null;
+}
+interface SessionOptions {
+    /** The sandbox folder, `.avow` in the working directory. */
+    dir: string;
+    apiUrl: string;
+    fetch?: typeof fetch;
+    now?: () => bigint;
+    log?: (line: string) => void;
+}
+/**
+ * The session the runner reports to, kept in the sandbox folder with the business, so the screen
+ * a developer has open keeps working across restarts. A restart keeps it while Avow's relay holds
+ * it for the business's account and takes its events for more than `SESSION_MARGIN`. On a first
+ * run, after `npm run fresh`, or once a session has closed, it's a new session, and the runner
+ * announces the agent's authority to it.
+ *
+ * The account comes from business.json, and nothing checks it here, since that takes the
+ * passphrase. The sealed key opens only for the account it was sealed for, so a file that names
+ * another business's account can make the runner keep that business's session, but nothing the
+ * runner signs can reach it, and Avow's relay refuses this business's agent's events there.
+ */
+export declare function keepSession(m: SessionOptions & {
+    account: Address | null;
+}): Promise<RunnerSession>;
+/**
+ * The session for the next run, the same one until Avow's relay is about to stop taking its
+ * events. Then it's a new one, which the runner announces the authority to again.
+ */
+export declare function sessionForNextRun(session: RunnerSession, m: SessionOptions): Promise<RunnerSession>;
+export {};
+//# sourceMappingURL=runner-session.d.ts.map

package/dist/node/runner-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-session.d.ts","sourceRoot":"","sources":["../../src/node/runner-session.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,OAAO,EAAkB,MAAM,MAAM,CAAA;AAInD,+FAA+F;AAC/F,eAAO,MAAM,cAAc,OAAO,CAAA;AAElC,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,4FAA4F;IAC5F,KAAK,EAAE,OAAO,CAAA;IACd,mGAAmG;IACnG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,UAAU,cAAc;IACtB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAuCD;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,CAAC,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,GAC9C,OAAO,CAAC,aAAa,CAAC,CAsBxB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,CAAC,EAAE,cAAc,GAChB,OAAO,CAAC,aAAa,CAAC,CAaxB"}