@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/cli/commands/tx.js

@@ -0,0 +1,379 @@
+"use strict";
+/**
+ * Transaction Commands - tx subcommand group
+ *
+ * Commands for managing ACTP transactions:
+ * - tx create: Create a new transaction (intermediate API)
+ * - tx status: Check transaction status
+ * - tx list: List all transactions
+ * - tx deliver: Mark transaction as delivered
+ * - tx settle: Release escrow funds
+ * - tx cancel: Cancel a transaction
+ *
+ * @module cli/commands/tx
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTxCommand = void 0;
+const commander_1 = require("commander");
+const output_1 = require("../utils/output");
+const client_1 = require("../utils/client");
+// ============================================================================
+// Main tx Command
+// ============================================================================
+function createTxCommand() {
+    const cmd = new commander_1.Command('tx')
+        .description('Transaction management commands');
+    cmd.addCommand(createTxCreateCommand());
+    cmd.addCommand(createTxStatusCommand());
+    cmd.addCommand(createTxListCommand());
+    cmd.addCommand(createTxDeliverCommand());
+    cmd.addCommand(createTxSettleCommand());
+    cmd.addCommand(createTxCancelCommand());
+    return cmd;
+}
+exports.createTxCommand = createTxCommand;
+// ============================================================================
+// tx create
+// ============================================================================
+function createTxCreateCommand() {
+    return new commander_1.Command('create')
+        .description('Create a new transaction (without auto-funding)')
+        .argument('<provider>', 'Provider address')
+        .argument('<amount>', 'Amount to pay')
+        .option('-d, --deadline <deadline>', 'Deadline (+24h, +7d, or Unix timestamp)', '+24h')
+        .option('-w, --dispute-window <seconds>', 'Dispute window in seconds', '172800')
+        .option('--description <text>', 'Service description')
+        .option('--fund', 'Automatically fund the escrow after creation')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Output only the transaction ID')
+        .action(async (provider, amount, options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            const client = await (0, client_1.createClient)();
+            let deadline = options.deadline;
+            if (/^\d+$/.test(options.deadline)) {
+                deadline = parseInt(options.deadline, 10);
+            }
+            const disputeWindow = parseInt(options.disputeWindow, 10);
+            // Create transaction
+            const txId = await client.intermediate.createTransaction({
+                provider,
+                amount,
+                deadline,
+                disputeWindow,
+                serviceDescription: options.description,
+            });
+            // Optionally fund
+            let escrowId;
+            if (options.fund) {
+                escrowId = await client.intermediate.linkEscrow(txId);
+            }
+            const tx = await client.intermediate.getTransaction(txId);
+            if (!tx)
+                throw new Error('Transaction not found after creation');
+            output.result({
+                txId,
+                state: tx.state,
+                provider: tx.provider,
+                requester: tx.requester,
+                amount: `${formatUsdc(tx.amount)} USDC`,
+                deadline: new Date(tx.deadline * 1000).toISOString(),
+                escrowId: escrowId || null,
+            }, { quietKey: 'txId' });
+            if (!options.fund) {
+                output.blank();
+                output.info('Transaction created but not funded.');
+                output.print('  Fund it: actp tx fund ' + txId.slice(0, 10) + '...');
+            }
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+}
+// ============================================================================
+// tx status
+// ============================================================================
+function createTxStatusCommand() {
+    return new commander_1.Command('status')
+        .description('Check transaction status')
+        .argument('<txId>', 'Transaction ID')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Output only the state')
+        .action(async (txId, options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            if (!(0, client_1.isValidTxId)(txId)) {
+                throw new Error(`Invalid transaction ID format: "${txId}"`);
+            }
+            const client = await (0, client_1.createClient)();
+            const tx = await client.intermediate.getTransaction(txId);
+            if (!tx) {
+                throw new Error(`Transaction not found: ${txId}`);
+            }
+            const status = await client.beginner.checkStatus(txId);
+            if (options.quiet) {
+                output.raw(tx.state);
+                return;
+            }
+            const display = {
+                txId: tx.id,
+                state: tx.state,
+                requester: tx.requester,
+                provider: tx.provider,
+                amount: `${formatUsdc(tx.amount)} USDC`,
+                deadline: new Date(tx.deadline * 1000).toISOString(),
+                escrowId: tx.escrowId,
+                createdAt: new Date(tx.createdAt * 1000).toISOString(),
+            };
+            if (options.json) {
+                output.result({
+                    ...display,
+                    actions: {
+                        canAccept: status.canAccept,
+                        canComplete: status.canComplete,
+                        canDispute: status.canDispute,
+                    },
+                });
+            }
+            else {
+                output.transaction(display);
+                output.blank();
+                output.print('Available Actions:');
+                output.keyValue('  Can Accept', status.canAccept);
+                output.keyValue('  Can Complete', status.canComplete);
+                output.keyValue('  Can Dispute', status.canDispute);
+            }
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+}
+// ============================================================================
+// tx list
+// ============================================================================
+function createTxListCommand() {
+    return new commander_1.Command('list')
+        .description('List all transactions')
+        .option('-s, --state <state>', 'Filter by state')
+        .option('-l, --limit <n>', 'Limit number of results', '50')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Output only transaction IDs (one per line)')
+        .action(async (options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            const client = await (0, client_1.createClient)();
+            let transactions = await client.advanced.getAllTransactions();
+            // Filter by state if specified
+            if (options.state) {
+                const stateFilter = options.state.toUpperCase();
+                transactions = transactions.filter((tx) => tx.state === stateFilter);
+            }
+            // Sort by createdAt descending (newest first)
+            transactions.sort((a, b) => b.createdAt - a.createdAt);
+            // Apply limit
+            const limit = parseInt(options.limit, 10);
+            transactions = transactions.slice(0, limit);
+            if (options.quiet) {
+                for (const tx of transactions) {
+                    console.log(tx.id);
+                }
+                return;
+            }
+            if (options.json) {
+                output.result({
+                    count: transactions.length,
+                    transactions: transactions.map((tx) => ({
+                        txId: tx.id,
+                        state: tx.state,
+                        requester: tx.requester,
+                        provider: tx.provider,
+                        amount: tx.amount,
+                        deadline: new Date(tx.deadline * 1000).toISOString(),
+                        createdAt: new Date(tx.createdAt * 1000).toISOString(),
+                    })),
+                });
+                return;
+            }
+            output.section(`Transactions (${transactions.length})`);
+            output.transactionTable(transactions.map((tx) => ({
+                txId: tx.id,
+                state: tx.state,
+                requester: tx.requester,
+                provider: tx.provider,
+                amount: `${formatUsdc(tx.amount)} USDC`,
+                deadline: new Date(tx.deadline * 1000).toISOString(),
+            })));
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+}
+// ============================================================================
+// tx deliver
+// ============================================================================
+function createTxDeliverCommand() {
+    return new commander_1.Command('deliver')
+        .description('Mark transaction as delivered (provider action)')
+        .argument('<txId>', 'Transaction ID')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Minimal output')
+        .action(async (txId, options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            if (!(0, client_1.isValidTxId)(txId)) {
+                throw new Error(`Invalid transaction ID format: "${txId}"`);
+            }
+            const client = await (0, client_1.createClient)();
+            // Transition to DELIVERED
+            await client.intermediate.transitionState(txId, 'DELIVERED');
+            const tx = await client.intermediate.getTransaction(txId);
+            if (!tx)
+                throw new Error('Transaction not found');
+            output.result({
+                txId,
+                state: tx.state,
+                completedAt: tx.completedAt
+                    ? new Date(tx.completedAt * 1000).toISOString()
+                    : null,
+            }, { quietKey: 'state' });
+            output.success('Transaction marked as delivered!');
+            output.info(`Dispute window: ${tx.disputeWindow} seconds`);
+            output.print('');
+            output.print('After dispute window expires, settle with:');
+            output.print('  actp tx settle ' + txId.slice(0, 10) + '...');
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+}
+// ============================================================================
+// tx settle
+// ============================================================================
+function createTxSettleCommand() {
+    return new commander_1.Command('settle')
+        .description('Release escrow funds to provider')
+        .argument('<txId>', 'Transaction ID')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Minimal output')
+        .action(async (txId, options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            if (!(0, client_1.isValidTxId)(txId)) {
+                throw new Error(`Invalid transaction ID format: "${txId}"`);
+            }
+            const client = await (0, client_1.createClient)();
+            // Get transaction to find escrow
+            const tx = await client.intermediate.getTransaction(txId);
+            if (!tx)
+                throw new Error(`Transaction not found: ${txId}`);
+            if (!tx.escrowId)
+                throw new Error('Transaction has no linked escrow');
+            // Release escrow
+            await client.intermediate.releaseEscrow(tx.escrowId);
+            // Get updated transaction
+            const updatedTx = await client.intermediate.getTransaction(txId);
+            if (!updatedTx)
+                throw new Error('Transaction not found');
+            output.result({
+                txId,
+                state: updatedTx.state,
+                provider: updatedTx.provider,
+                amount: `${formatUsdc(updatedTx.amount)} USDC`,
+            }, { quietKey: 'state' });
+            output.success('Escrow released! Funds sent to provider.');
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+}
+// ============================================================================
+// tx cancel
+// ============================================================================
+function createTxCancelCommand() {
+    return new commander_1.Command('cancel')
+        .description('Cancel a transaction (before delivery)')
+        .argument('<txId>', 'Transaction ID')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Minimal output')
+        .action(async (txId, options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            if (!(0, client_1.isValidTxId)(txId)) {
+                throw new Error(`Invalid transaction ID format: "${txId}"`);
+            }
+            const client = await (0, client_1.createClient)();
+            // Transition to CANCELLED
+            await client.intermediate.transitionState(txId, 'CANCELLED');
+            const tx = await client.intermediate.getTransaction(txId);
+            if (!tx)
+                throw new Error('Transaction not found');
+            output.result({
+                txId,
+                state: tx.state,
+                refunded: tx.escrowId !== null,
+            }, { quietKey: 'state' });
+            output.success('Transaction cancelled!');
+            if (tx.escrowId) {
+                output.info('Funds have been refunded to requester.');
+            }
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Format USDC amount from wei to decimal
+ */
+function formatUsdc(weiAmount) {
+    const amount = BigInt(weiAmount);
+    const whole = amount / 1000000n;
+    const decimal = amount % 1000000n;
+    const decimalStr = decimal.toString().padStart(6, '0').slice(0, 2);
+    return `${whole}.${decimalStr}`;
+}
+//# sourceMappingURL=tx.js.map

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

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

package/dist/cli/commands/watch.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Watch Command - Stream transaction state changes
+ *
+ * Agent-first feature: Real-time monitoring of transaction state.
+ * Outputs state changes as they happen, perfect for scripts
+ * that need to react to transaction lifecycle events.
+ *
+ * @module cli/commands/watch
+ */
+import { Command } from 'commander';
+import { Output } from '../utils/output';
+export declare function createWatchCommand(): Command;
+interface WatchOptions {
+    timeout: string;
+    interval: string;
+    until?: string;
+}
+declare function runWatch(txId: string, options: WatchOptions, output: Output): Promise<void>;
+export { runWatch };
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAA8B,MAAM,iBAAiB,CAAC;AAQrE,wBAAgB,kBAAkB,IAAI,OAAO,CA4B5C;AAMD,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iBAAe,QAAQ,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAmGf;AAgDD,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/cli/commands/watch.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Watch Command - Stream transaction state changes
+ *
+ * Agent-first feature: Real-time monitoring of transaction state.
+ * Outputs state changes as they happen, perfect for scripts
+ * that need to react to transaction lifecycle events.
+ *
+ * @module cli/commands/watch
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runWatch = exports.createWatchCommand = void 0;
+const commander_1 = require("commander");
+const output_1 = require("../utils/output");
+const client_1 = require("../utils/client");
+// ============================================================================
+// Command Definition
+// ============================================================================
+function createWatchCommand() {
+    const cmd = new commander_1.Command('watch')
+        .description('Watch a transaction for state changes (agent-first feature)')
+        .argument('<txId>', 'Transaction ID to watch')
+        .option('-t, --timeout <seconds>', 'Exit after timeout (default: indefinite)', '0')
+        .option('-i, --interval <ms>', 'Polling interval in milliseconds', '1000')
+        .option('--until <state>', 'Exit when transaction reaches this state')
+        .option('--json', 'Output state changes as JSON lines (NDJSON)')
+        .option('-q, --quiet', 'Output only state names on change')
+        .action(async (txId, options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            await runWatch(txId, options, output);
+        }
+        catch (error) {
+            const structuredError = (0, client_1.mapError)(error);
+            output.errorResult({
+                code: structuredError.code,
+                message: structuredError.message,
+                details: structuredError.details,
+            });
+            process.exit(output_1.ExitCode.ERROR);
+        }
+    });
+    return cmd;
+}
+exports.createWatchCommand = createWatchCommand;
+async function runWatch(txId, options, output) {
+    if (!(0, client_1.isValidTxId)(txId)) {
+        throw new Error(`Invalid transaction ID format: "${txId}"`);
+    }
+    const client = await (0, client_1.createClient)();
+    const pollIntervalMs = parseInt(options.interval, 10);
+    const timeoutSeconds = parseInt(options.timeout, 10);
+    const untilState = options.until?.toUpperCase();
+    // Validate until state if provided
+    const validStates = [
+        'INITIATED', 'QUOTED', 'COMMITTED', 'IN_PROGRESS',
+        'DELIVERED', 'SETTLED', 'DISPUTED', 'CANCELLED',
+    ];
+    if (untilState && !validStates.includes(untilState)) {
+        throw new Error(`Invalid state: "${options.until}"\n` +
+            `Valid states: ${validStates.join(', ')}`);
+    }
+    // Get initial state
+    const tx = await client.intermediate.getTransaction(txId);
+    if (!tx) {
+        throw new Error(`Transaction not found: ${txId}`);
+    }
+    let currentState = tx.state;
+    const startTime = Date.now();
+    // Output initial state
+    emitStateChange(output, txId, null, currentState, tx.updatedAt);
+    // Check if already at target state
+    if (untilState && currentState === untilState) {
+        output.info('Transaction already at target state.');
+        process.exit(output_1.ExitCode.SUCCESS);
+    }
+    // Terminal states
+    const terminalStates = ['SETTLED', 'CANCELLED'];
+    if (terminalStates.includes(currentState)) {
+        output.info('Transaction is in terminal state.');
+        process.exit(output_1.ExitCode.SUCCESS);
+    }
+    output.info('Watching for state changes... (Ctrl+C to stop)');
+    // Polling loop
+    const poll = async () => {
+        // Check timeout
+        if (timeoutSeconds > 0) {
+            const elapsed = (Date.now() - startTime) / 1000;
+            if (elapsed >= timeoutSeconds) {
+                output.warning(`Timeout reached (${timeoutSeconds}s)`);
+                process.exit(output_1.ExitCode.TIMEOUT);
+            }
+        }
+        try {
+            const updatedTx = await client.intermediate.getTransaction(txId);
+            if (!updatedTx) {
+                output.warning('Transaction no longer exists');
+                process.exit(output_1.ExitCode.ERROR);
+            }
+            if (updatedTx.state !== currentState) {
+                const previousState = currentState;
+                currentState = updatedTx.state;
+                emitStateChange(output, txId, previousState, currentState, updatedTx.updatedAt);
+                // Check if reached target state
+                if (untilState && currentState === untilState) {
+                    output.success(`Reached target state: ${untilState}`);
+                    process.exit(output_1.ExitCode.SUCCESS);
+                }
+                // Check if terminal
+                if (terminalStates.includes(currentState)) {
+                    output.info(`Transaction reached terminal state: ${currentState}`);
+                    process.exit(output_1.ExitCode.SUCCESS);
+                }
+            }
+        }
+        catch (error) {
+            // Non-fatal: log warning and continue
+            output.warning(`Poll error: ${error.message}`);
+        }
+        // Schedule next poll
+        setTimeout(poll, pollIntervalMs);
+    };
+    // Start polling
+    setTimeout(poll, pollIntervalMs);
+    // Keep process alive
+    await new Promise(() => { });
+}
+exports.runWatch = runWatch;
+/**
+ * Emit a state change event in the appropriate format
+ */
+function emitStateChange(output, txId, fromState, toState, timestamp) {
+    const time = new Date(timestamp * 1000).toISOString();
+    switch (output['mode']) {
+        case 'json':
+            // NDJSON format for easy parsing
+            console.log(JSON.stringify({
+                event: 'state_change',
+                txId,
+                fromState,
+                toState,
+                timestamp: time,
+                unix: timestamp,
+            }));
+            break;
+        case 'quiet':
+            console.log(toState);
+            break;
+        case 'human':
+        default:
+            if (fromState) {
+                console.log(`${output_1.fmt.dim(time)} ${(0, output_1.formatState)(fromState)} ${output_1.fmt.dim('->')} ${(0, output_1.formatState)(toState)}`);
+            }
+            else {
+                console.log(`${output_1.fmt.dim(time)} ${output_1.fmt.dim('Current:')} ${(0, output_1.formatState)(toState)}`);
+            }
+            break;
+    }
+}
+//# sourceMappingURL=watch.js.map

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

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

package/dist/cli/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * ACTP CLI - Agent Commerce Transaction Protocol Command Line Interface
+ *
+ * The ACTP CLI is designed for AI agents - not humans clicking buttons.
+ * Key differentiators:
+ *
+ * 1. **Machine-readable output**: JSON by default for scripting
+ * 2. **Pipe-friendly**: Commands output just what you need
+ * 3. **Structured exit codes**: 0=success, 1=error, 2=pending
+ * 4. **Agent-first features**: watch, simulate, batch
+ *
+ * @module cli
+ * @see https://docs.agirails.io/cli
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}