@agirails/sdk 3.2.0 → 3.4.1

package/dist/cli/commands/serve.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * `actp serve` — long-running provider daemon.
+ *
+ * Loads a ProviderPolicy JSON, constructs a ProviderOrchestrator, opens
+ * an HTTP server on the configured port that exposes the AIP-2.1 quote
+ * channel surface (`POST /quote-channel/{chainId}/{txId}` per §8.2),
+ * and routes incoming buyer counter-offers through
+ * orchestrator.evaluateCounter().
+ *
+ * Scope (v1):
+ *  - accept + verify incoming counter-offers via QuoteChannelHandler
+ *  - log the policy verdict (accept / reject) per round
+ *  - emit a one-line health response on `GET /`
+ *
+ * Out of scope for v1 (Phase 5):
+ *  - on-chain event listening (no automatic submitQuote on incoming
+ *    INITIATED txs — caller still drives via Agent.ts or manual code)
+ *  - sending CounterAcceptMessage back to buyer (no reverse-endpoint
+ *    discovery yet — print the verdict, operator handles delivery)
+ *
+ * @module cli/commands/serve
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readBody = exports.createServeCommand = void 0;
+const commander_1 = require("commander");
+const http_1 = require("http");
+const fs_1 = require("fs");
+const ethers_1 = require("ethers");
+const output_1 = require("../utils/output");
+const client_1 = require("../utils/client");
+const networks_1 = require("../../config/networks");
+const BlockchainRuntime_1 = require("../../runtime/BlockchainRuntime");
+const MockRuntime_1 = require("../../runtime/MockRuntime");
+const MockStateManager_1 = require("../../runtime/MockStateManager");
+const ProviderOrchestrator_1 = require("../../negotiation/ProviderOrchestrator");
+const QuoteChannel_1 = require("../../transport/QuoteChannel");
+// ============================================================================
+// Command
+// ============================================================================
+function createServeCommand() {
+    const cmd = new commander_1.Command('serve')
+        .description('Run a long-running provider daemon (AIP-2.1 quote channel)')
+        .requiredOption('--policy <path>', 'Path to ProviderPolicy JSON file')
+        .option('--port <num>', 'HTTP port to listen on', '8787')
+        .option('--network <name>', 'Network — base-sepolia | base-mainnet | mock', 'base-sepolia')
+        .option('--rpc <url>', 'Custom RPC URL override (testnet/mainnet only)')
+        .option('--mock', 'Run with MockRuntime instead of BlockchainRuntime (for local testing)')
+        .action(async (options) => {
+        const output = new output_1.Output('human');
+        try {
+            await runServe(options, output);
+        }
+        catch (error) {
+            const structured = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structured.code,
+                message: structured.message,
+                details: structured.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+    return cmd;
+}
+exports.createServeCommand = createServeCommand;
+async function runServe(options, output) {
+    // 1. Load + validate policy.
+    if (!(0, fs_1.existsSync)(options.policy)) {
+        throw new Error(`Policy file not found: ${options.policy}`);
+    }
+    const policy = JSON.parse((0, fs_1.readFileSync)(options.policy, 'utf-8'));
+    // 2. Build runtime AND keep a direct signer reference for the
+    //    orchestrator. BlockchainRuntime makes its signer private, so we
+    //    hold ours alongside.
+    let runtime;
+    let kernelAddress;
+    let chainId;
+    let signerAddress;
+    let orchestratorSigner;
+    if (options.mock) {
+        const stateMgr = new MockStateManager_1.MockStateManager(process.cwd() + '/.actp-serve');
+        runtime = new MockRuntime_1.MockRuntime(stateMgr);
+        kernelAddress = '0x' + '0'.repeat(40);
+        chainId = 84532;
+        const mockWallet = ethers_1.Wallet.createRandom();
+        orchestratorSigner = mockWallet;
+        signerAddress = mockWallet.address;
+        output.info('Running in MOCK mode — no real on-chain interaction.');
+    }
+    else {
+        const networkCfg = (0, networks_1.getNetwork)(options.network);
+        if (options.rpc)
+            networkCfg.rpcUrl = options.rpc;
+        const { resolvePrivateKey } = await Promise.resolve().then(() => __importStar(require('../../wallet/keystore')));
+        const tier = options.network.includes('mainnet') ? 'mainnet'
+            : options.network.includes('sepolia') ? 'testnet' : 'mock';
+        const privateKey = await resolvePrivateKey(process.cwd(), {
+            network: tier,
+        });
+        if (!privateKey) {
+            throw new Error('No wallet found. Run `actp init` or set ACTP_KEYSTORE_BASE64.');
+        }
+        const provider = new ethers_1.JsonRpcProvider(networkCfg.rpcUrl);
+        const signer = new ethers_1.Wallet(privateKey, provider);
+        orchestratorSigner = signer;
+        runtime = new BlockchainRuntime_1.BlockchainRuntime({
+            network: options.network,
+            signer,
+            provider,
+        });
+        await runtime.initialize();
+        kernelAddress = networkCfg.contracts.actpKernel;
+        chainId = networkCfg.chainId;
+        signerAddress = await signer.getAddress();
+    }
+    const orchestrator = new ProviderOrchestrator_1.ProviderOrchestrator({
+        policy,
+        runtime,
+        signer: orchestratorSigner,
+        kernelAddress,
+        chainId,
+    });
+    // 4. Build channel handler with kernel address per chain.
+    const channelHandler = new QuoteChannel_1.QuoteChannelHandler({
+        kernelAddressByChainId: {
+            [chainId]: kernelAddress,
+        },
+    });
+    // 5. Start HTTP server.
+    const port = Number(options.port);
+    if (!Number.isFinite(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid port: ${options.port}`);
+    }
+    const server = (0, http_1.createServer)(async (req, res) => {
+        try {
+            await routeRequest(req, res, {
+                channelHandler,
+                orchestrator,
+                chainId,
+                signerAddress,
+                output,
+            });
+        }
+        catch (err) {
+            output.error(`Request handler crashed: ${err instanceof Error ? err.message : String(err)}`);
+            res.statusCode = 500;
+            res.end('{"error":"internal"}');
+        }
+    });
+    // Slow-loris hardening: bound the time a client can hold a socket open
+    // dribbling out a request body. Without this, `readBody` will sit in
+    // its `data` listener until the OS-level keepalive ages out.
+    // 10s for headers, 15s for the full request — generous for normal
+    // peers (a counter-offer body is well under 4 KiB), tight enough to
+    // shed slow-trickle attackers in seconds.
+    server.headersTimeout = 10000;
+    server.requestTimeout = 15000;
+    server.listen(port, () => {
+        output.success(`actp serve listening on http://0.0.0.0:${port}`);
+        output.print(`  Network:        ${options.network}${options.mock ? ' (mock)' : ''}`);
+        output.print(`  Provider:       ${signerAddress}`);
+        output.print(`  Channel base:   ${(0, QuoteChannel_1.buildChannelPath)(chainId, '<txId>')}`);
+        output.print(`  Health:         GET /`);
+        output.print('');
+        output.print('Counter-offers POSTed to /quote-channel/{chainId}/{txId} are verified + evaluated.');
+        output.print('Verdicts are logged here; v1 does NOT auto-deliver CounterAcceptMessage back to');
+        output.print('the buyer — operator handles that out-of-band (see AIP-2.1 §5.3).');
+        output.print('');
+    });
+    // Graceful shutdown.
+    const shutdown = (signal) => {
+        output.info(`\n${signal} received — shutting down…`);
+        server.close(() => {
+            output.success('Stopped.');
+            process.exit(0);
+        });
+        // Force-exit after 5s if connections hang.
+        setTimeout(() => process.exit(0), 5000).unref();
+    };
+    process.once('SIGINT', () => shutdown('SIGINT'));
+    process.once('SIGTERM', () => shutdown('SIGTERM'));
+}
+async function routeRequest(req, res, ctx) {
+    const url = req.url ?? '/';
+    // Health check.
+    if (req.method === 'GET' && url === '/') {
+        res.statusCode = 200;
+        res.setHeader('Content-Type', 'application/json');
+        res.end(JSON.stringify({
+            status: 'ok',
+            provider: ctx.signerAddress,
+            chainId: ctx.chainId,
+            service: 'actp-serve',
+        }));
+        return;
+    }
+    // /quote-channel/{chainId}/{txId}.
+    const channelMatch = url.match(/^\/quote-channel\/(\d+)\/(0x[a-fA-F0-9]{64})\/?$/);
+    if (req.method === 'POST' && channelMatch) {
+        const [, chainIdStr, txId] = channelMatch;
+        const pathChainId = Number(chainIdStr);
+        const body = await readBody(req);
+        let payload;
+        try {
+            payload = JSON.parse(body);
+        }
+        catch {
+            res.statusCode = 400;
+            res.end(JSON.stringify({ accepted: false, reason: 'Invalid JSON' }));
+            return;
+        }
+        const result = await ctx.channelHandler.handle(payload, { pathChainId, pathTxId: txId });
+        // For counter-offers that pass the channel handler, run the
+        // orchestrator's policy verdict and log it.
+        if (result.status === 201 || result.status === 200) {
+            const p = payload;
+            if (p?.type === 'agirails.counteroffer.v1' && p.message) {
+                try {
+                    const verdict = await ctx.orchestrator.evaluateCounter(p.message);
+                    ctx.output.info(`[counter] tx=${txId.slice(0, 12)}… counter=${p.message.counterAmount} → ${verdict.action}: ${verdict.reason}`);
+                }
+                catch (err) {
+                    ctx.output.warning(`[counter] tx=${txId.slice(0, 12)}… verification failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        res.statusCode = result.status;
+        res.setHeader('Content-Type', 'application/json');
+        res.end(JSON.stringify(result.body));
+        return;
+    }
+    res.statusCode = 404;
+    res.end(JSON.stringify({ error: 'Not found' }));
+}
+/**
+ * Read a request body with two hard limits — defense in depth alongside
+ * the server-level `headersTimeout` / `requestTimeout`:
+ *   - byte cap  (64 KiB) to bound memory
+ *   - wall-clock deadline (10s) to bound time
+ *
+ * Both must be enforced here too because a caller could construct the
+ * server without our timeouts (e.g. testing with a raw http.Server) and
+ * the body cap alone won't shed a peer that sends 1 byte/sec forever.
+ */
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let total = 0;
+        let settled = false;
+        const MAX_BYTES = 64 * 1024;
+        const MAX_MS = 10000;
+        const finish = (err, body) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(deadline);
+            if (err) {
+                try {
+                    req.destroy();
+                }
+                catch { /* */ }
+                reject(err);
+            }
+            else {
+                resolve(body ?? '');
+            }
+        };
+        const deadline = setTimeout(() => {
+            finish(new Error('Body read timeout'));
+        }, MAX_MS);
+        req.on('data', (chunk) => {
+            total += chunk.length;
+            if (total > MAX_BYTES) {
+                finish(new Error('Body too large'));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => finish(null, Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', (err) => finish(err));
+    });
+}
+exports.readBody = readBody;
+//# sourceMappingURL=serve.js.map

package/dist/cli/commands/serve.js.map

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

package/dist/cli/commands/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAY,MAAM,iBAAiB,CAAC;AAYnD,wBAAgB,iBAAiB,IAAI,OAAO,CAwB3C;AAMD,iBAAe,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGpD;AAyBD,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAiB,MAAM,iBAAiB,CAAC;AAexD,wBAAgB,iBAAiB,IAAI,OAAO,CAwB3C;AA6ED,iBAAe,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0JpD;AAkGD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli/commands/test.js

@@ -43,6 +43,9 @@ const agirailsmdV4_1 = require("../../config/agirailsmdV4");
 const testjobs_1 = require("../testjobs");
 const receipt_1 = require("./receipt");
 const MockRuntime_1 = require("../../runtime/MockRuntime");
+const banner_1 = require("../utils/banner");
+const receiptUpload_1 = require("../receiptUpload");
+const defaults_1 = require("../../config/defaults");
 // ============================================================================
 // Command Definition
 // ============================================================================
@@ -72,45 +75,104 @@ exports.createTestCommand = createTestCommand;
 // ============================================================================
 // Implementation
 // ============================================================================
+/** Sleep helper */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Spinner frames (rotating Unicode circle) */
+const SPINNER_FRAMES = ['◐', '◓', '◑', '◒'];
+/**
+ * Run a state transition with rotating spinner animation.
+ *
+ * On TTY (human mode): prints a spinning line, awaits the work, enforces a
+ * minimum visible duration, then rewrites the line with the final icon + timing.
+ *
+ * On non-TTY / CI: executes the work without animation, emits a single line
+ * with actual elapsed time.
+ */
+async function animateState(output, label, message, work, settled = false, minDurationMs = 450) {
+    const labelPad = label.padEnd(14);
+    const msgPad = message.padEnd(40);
+    if (output.mode !== 'human') {
+        // Non-human (json/quiet): execute silently, no output
+        await work();
+        return 0;
+    }
+    if (!process.stdout.isTTY) {
+        // Non-TTY: no animation, single line after work completes
+        const start = performance.now();
+        await work();
+        const elapsed = Math.round(performance.now() - start);
+        const icon = settled ? output_1.fmt.green('✓') : output_1.fmt.cyan('·');
+        const lbl = settled ? output_1.fmt.green(output_1.fmt.bold(labelPad)) : output_1.fmt.bold(labelPad);
+        console.log(`  ${icon} ${lbl} ${msgPad} ${output_1.fmt.dim(`[${elapsed}ms]`)}`);
+        return elapsed;
+    }
+    // TTY: rotating spinner with min duration for visibility
+    let frameIdx = 0;
+    process.stdout.write(`  ${output_1.fmt.cyan(SPINNER_FRAMES[0])} ${output_1.fmt.bold(labelPad)} ${msgPad}`);
+    const interval = setInterval(() => {
+        frameIdx = (frameIdx + 1) % SPINNER_FRAMES.length;
+        process.stdout.write(`\r  ${output_1.fmt.cyan(SPINNER_FRAMES[frameIdx])} ${output_1.fmt.bold(labelPad)} ${msgPad}`);
+    }, 90);
+    const start = performance.now();
+    await Promise.all([
+        work(),
+        sleep(minDurationMs),
+    ]);
+    const elapsed = Math.round(performance.now() - start);
+    clearInterval(interval);
+    const icon = settled ? output_1.fmt.green('✓') : output_1.fmt.cyan('·');
+    const lbl = settled ? output_1.fmt.green(output_1.fmt.bold(labelPad)) : output_1.fmt.bold(labelPad);
+    process.stdout.write(`\r  ${icon} ${lbl} ${msgPad} ${output_1.fmt.dim(`[${elapsed}ms]`)}\n`);
+    return elapsed;
+}
+/** Demo amount for first-TX experience: $10 USDC (fee $0.10, net $9.90) */
+const TEST_TX_AMOUNT_WEI = 10000000n;
 async function runTest(output) {
     // Step 1: Resolve identity file
     const identityPath = (0, config_1.resolveIdentityPath)();
     if (!identityPath) {
-        throw new Error('No agent identity file found.\n' +
-            'Create a {slug}.md file and run "actp init" first.\n' +
-            'Or use an AI assistant with AGIRAILS.md to generate one.');
+        throw new Error('No agent identity file ({slug}.md) found in this directory.\n' +
+            'Create one with a valid AGIRAILS.md v4 frontmatter (name, services, pricing).\n' +
+            'Or let an AI assistant generate one: curl -sLO https://www.agirails.app/protocol/AGIRAILS.md');
     }
-    const spinner = output.spinner('Running test earning loop...');
+    // Parse identity
+    const content = fs.readFileSync(identityPath, 'utf-8');
+    const config = (0, agirailsmdV4_1.parseAgirailsMdV4)(content);
+    const testJob = (0, testjobs_1.selectTestJob)(config.services.map(s => s.type));
+    // Render banner + section header (human mode only)
+    if (output.mode === 'human') {
+        output.print('');
+        output.print((0, banner_1.inlineBanner)('ACTP Transaction Lifecycle'));
+        output.print('');
+    }
+    const isTTY = process.stdout.isTTY && output.mode === 'human';
+    const totalStart = performance.now();
+    const runtime = new MockRuntime_1.MockRuntime();
+    // Create synthetic addresses
+    const requesterWallet = ethers_1.ethers.Wallet.createRandom();
+    let providerAddress;
     try {
-        // Step 2: Parse identity
-        const content = fs.readFileSync(identityPath, 'utf-8');
-        const config = (0, agirailsmdV4_1.parseAgirailsMdV4)(content);
-        // Step 3: Select test job
-        const testJob = (0, testjobs_1.selectTestJob)(config.services);
-        output.print(`Testing ${config.name} (${testJob.title})`);
-        // Step 4: Run mock earning loop
-        const totalStart = performance.now();
-        const runtime = new MockRuntime_1.MockRuntime();
-        // Create synthetic addresses
-        const requesterWallet = ethers_1.ethers.Wallet.createRandom();
-        let providerAddress;
-        try {
-            providerAddress = (0, config_1.loadConfig)().address || ethers_1.ethers.Wallet.createRandom().address;
-        }
-        catch {
-            // No config found — use random address (likely first run before actp init)
-            providerAddress = ethers_1.ethers.Wallet.createRandom().address;
-        }
-        // Amount in USDC wei (6 decimals)
-        const amountWei = BigInt(Math.round(config.pricing.base * 1000000));
-        const amountStr = amountWei.toString();
-        // Mint balance for requester
-        await runtime.mintTokens(requesterWallet.address, amountStr);
-        // Step 4a: createTransaction (INITIATED)
-        const deadline = runtime.time.now() + 86400; // +24h
-        const disputeWindow = parseDuration(config.sla.dispute_window);
-        const escrowStart = performance.now();
-        const txId = await runtime.createTransaction({
+        providerAddress = (0, config_1.loadConfig)().address || ethers_1.ethers.Wallet.createRandom().address;
+    }
+    catch {
+        providerAddress = ethers_1.ethers.Wallet.createRandom().address;
+    }
+    // Hardcoded $10 demo amount — demonstrates fee math (fee $0.10, net $9.90)
+    const amountWei = TEST_TX_AMOUNT_WEI;
+    const amountStr = amountWei.toString();
+    await runtime.mintTokens(requesterWallet.address, amountStr);
+    const deadline = runtime.time.now() + 86400;
+    const disputeWindow = parseDuration(config.sla.dispute_window);
+    // Shared txId/escrowId across state closures
+    let txId = '';
+    let escrowId = '';
+    let escrowLockMs = 0;
+    let settlementMs = 0;
+    // === INITIATED ===
+    await animateState(output, 'INITIATED', 'Requester created transaction', async () => {
+        txId = await runtime.createTransaction({
             provider: providerAddress,
             requester: requesterWallet.address,
             amount: amountStr,
@@ -118,42 +180,142 @@ async function runTest(output) {
             disputeWindow,
             serviceDescription: testJob.title,
         });
-        // Step 4b: linkEscrow (INITIATED → COMMITTED)
-        const escrowId = await runtime.linkEscrow(txId, amountStr);
-        const escrowLockMs = performance.now() - escrowStart;
-        // Step 4c: transitionState (COMMITTED → IN_PROGRESS)
+    });
+    // === QUOTED === (educational: demonstrates full state machine)
+    await animateState(output, 'QUOTED', `${config.name} quoted $10.00 USDC`, async () => {
+        await runtime.transitionState(txId, 'QUOTED');
+    });
+    // === COMMITTED ===
+    await animateState(output, 'COMMITTED', 'Escrow funded — $10.00 locked', async () => {
+        const commitStart = performance.now();
+        escrowId = await runtime.linkEscrow(txId, amountStr);
+        escrowLockMs = performance.now() - commitStart;
+    });
+    // === IN_PROGRESS ===
+    await animateState(output, 'IN_PROGRESS', `${config.name} working...`, async () => {
         await runtime.transitionState(txId, 'IN_PROGRESS');
-        // Step 4d: transitionState (IN_PROGRESS → DELIVERED)
+    }, false, 700); // longer delay — simulates "doing work"
+    // === DELIVERED ===
+    await animateState(output, 'DELIVERED', 'Delivery proof submitted', async () => {
         await runtime.transitionState(txId, 'DELIVERED');
-        // Step 4e: advanceTime past dispute window
-        await runtime.time.advanceTime(disputeWindow + 1);
-        // Step 4f: releaseEscrow (DELIVERED → SETTLED)
+    });
+    // Advance time past dispute window (silent — not a real state transition)
+    await runtime.time.advanceTime(disputeWindow + 1);
+    // === SETTLED ===
+    await animateState(output, 'SETTLED', `Escrow released → ${config.name}`, async () => {
         const settlementStart = performance.now();
         await runtime.releaseEscrow(escrowId);
-        const settlementMs = performance.now() - settlementStart;
-        const totalMs = performance.now() - totalStart;
-        spinner.stop(true);
-        // Step 5: Display receipt
-        (0, receipt_1.renderReceipt)({
-            agent: config.slug,
-            service: config.services[0],
-            amountWei,
-            network: 'mock',
-            txId,
-            timing: {
-                totalMs: Math.round(totalMs),
-                escrowLockMs: Math.round(escrowLockMs),
-                settlementMs: Math.round(settlementMs),
-            },
-        }, output);
+        settlementMs = performance.now() - settlementStart;
+    }, true);
+    const totalMs = performance.now() - totalStart;
+    // Summary line
+    if (output.mode === 'human') {
+        output.print('');
+        output.print(output_1.fmt.dim(`  ─── ${Math.round(totalMs)}ms total ${'─'.repeat(Math.max(0, 40 - String(Math.round(totalMs)).length))}`));
+        output.print('');
+    }
+    // Receipt
+    (0, receipt_1.renderReceipt)({
+        agent: config.name,
+        service: config.services[0].type,
+        amountWei,
+        network: 'mock',
+        txId,
+        timing: {
+            totalMs: Math.round(totalMs),
+            escrowLockMs: Math.round(escrowLockMs),
+            settlementMs: Math.round(settlementMs),
+        },
+    }, output);
+    // Best-effort publish to agirails.app/r/<id> — mock auth requires API key.
+    // On failure, fall through silently; the CLI already printed a local receipt.
+    // Fee math from canonical SDK helper (config/defaults.ts) — kept in sync
+    // with the web copy at lib/receipts/fees.ts via the parity test on web.
+    const feeWei = (0, defaults_1.computeDisplayFee)(amountWei);
+    const netWei = amountWei - feeWei;
+    const upload = await (0, receiptUpload_1.uploadReceipt)({
+        agentAddress: providerAddress,
+        service: testJob.title,
+        amountWei: amountStr,
+        feeWei: feeWei.toString(),
+        netWei: netWei.toString(),
+        txId,
+        network: 'mock',
+        requesterAddress: requesterWallet.address,
+        durationMs: Math.round(totalMs),
+    });
+    if (output.mode === 'human' && upload.ok) {
+        output.print('');
+        output.print(`  ${output_1.fmt.green('→')} Shareable receipt: ${output_1.fmt.bold(upload.url)}`);
+        if (upload.milestone) {
+            output.print(`  ${output_1.fmt.yellow('★')} Milestone: ${output_1.fmt.bold(upload.milestone)}`);
+        }
+        output.print('');
     }
-    catch (error) {
-        spinner.stop(false);
-        throw error;
+    // Share prompt (TTY + human mode only — never in CI/piped/json/quiet)
+    if (isTTY) {
+        await promptShare(amountWei, 'mock', undefined, upload.ok ? upload.url : undefined);
     }
 }
 exports.runTest = runTest;
 // ============================================================================
+// Share prompt
+// ============================================================================
+async function promptShare(amountWei, network, ethTxHash, receiptUrl) {
+    const readline = await Promise.resolve().then(() => __importStar(require('readline')));
+    const { copyToClipboardOSC52, buildTwitterIntentUrl, openUrl, buildMockTweet, buildTestnetTweet, } = await Promise.resolve().then(() => __importStar(require('../utils/share')));
+    // Compute net for tweet text
+    const { computeDisplayFee } = await Promise.resolve().then(() => __importStar(require('../../config/defaults')));
+    const fee = computeDisplayFee(amountWei);
+    const net = amountWei - fee;
+    const netUsd = `$${(Number(net) / 1000000).toFixed(2)}`;
+    const baseTweet = network === 'testnet' && ethTxHash
+        ? buildTestnetTweet(netUsd, ethTxHash)
+        : buildMockTweet(netUsd);
+    const tweetText = receiptUrl ? `${baseTweet}\n\n${receiptUrl}` : baseTweet;
+    console.log('');
+    console.log(output_1.fmt.bold('Share your first transaction?'));
+    console.log('');
+    console.log(`  ${output_1.fmt.cyan('1)')} Copy tweet text to clipboard`);
+    console.log(`  ${output_1.fmt.cyan('2)')} Open Twitter with pre-filled tweet`);
+    console.log(`  ${output_1.fmt.cyan('3)')} Skip`);
+    console.log('');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+        rl.question('Choose [1-3, default 3]: ', resolve);
+    });
+    rl.close();
+    const choice = answer.trim() || '3';
+    if (choice === '1') {
+        const copied = copyToClipboardOSC52(tweetText);
+        console.log('');
+        if (copied) {
+            console.log(output_1.fmt.green('✓ Tweet copied to clipboard.'));
+        }
+        else {
+            console.log(output_1.fmt.yellow('Clipboard not available — copy manually:'));
+            console.log('');
+            console.log(output_1.fmt.dim(tweetText));
+        }
+        console.log('');
+    }
+    else if (choice === '2') {
+        const url = buildTwitterIntentUrl(tweetText);
+        const opened = openUrl(url);
+        console.log('');
+        if (opened) {
+            console.log(output_1.fmt.green('✓ Opening Twitter...'));
+        }
+        else {
+            console.log(output_1.fmt.yellow('Could not open browser. Copy this URL:'));
+            console.log('');
+            console.log(output_1.fmt.dim(url));
+        }
+        console.log('');
+    }
+    // choice === '3' or anything else: silent skip
+}
+// ============================================================================
 // Helpers
 // ============================================================================
 /**