@agirails/sdk 2.6.0 → 3.0.0

package/dist/cli/commands/negotiate.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Negotiate Command — Autonomous buyer-side negotiation
+ *
+ * Discovers agents, scores them, validates against buyer policy,
+ * and optionally executes the full negotiation flow.
+ *
+ * @module cli/commands/negotiate
+ */
+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.createNegotiateCommand = void 0;
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const output_1 = require("../utils/output");
+const client_1 = require("../utils/client");
+const BuyerOrchestrator_1 = require("../../negotiation/BuyerOrchestrator");
+// ============================================================================
+// Command Definition
+// ============================================================================
+function createNegotiateCommand() {
+    const cmd = new commander_1.Command('negotiate')
+        .description('Run autonomous buyer-side negotiation')
+        .requiredOption('--policy <path>', 'Path to buyer policy JSON file')
+        .option('--dry-run', 'Score candidates without creating transactions')
+        .option('--poll-interval <ms>', 'Poll interval for quote state (ms)', '3000')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Minimal output')
+        .action(async (options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            await runNegotiate(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.createNegotiateCommand = createNegotiateCommand;
+// ============================================================================
+// Implementation
+// ============================================================================
+async function runNegotiate(options, output) {
+    // Load policy
+    let policy;
+    try {
+        const raw = (0, fs_1.readFileSync)(options.policy, 'utf8');
+        policy = JSON.parse(raw);
+    }
+    catch (err) {
+        output.errorResult({
+            code: 'INVALID_POLICY',
+            message: `Failed to load policy: ${err instanceof Error ? err.message : String(err)}`,
+        });
+        process.exit(output_1.ExitCode.ERROR);
+    }
+    // Validate required policy fields (structure + types + ranges)
+    const errors = [];
+    if (!policy.task || typeof policy.task !== 'string') {
+        errors.push('task must be a non-empty string');
+    }
+    if (typeof policy.constraints?.max_unit_price?.amount !== 'number' || !Number.isFinite(policy.constraints.max_unit_price.amount) || policy.constraints.max_unit_price.amount <= 0) {
+        errors.push('constraints.max_unit_price.amount must be a finite positive number');
+    }
+    if (typeof policy.constraints?.max_daily_spend?.amount !== 'number' || !Number.isFinite(policy.constraints.max_daily_spend.amount) || policy.constraints.max_daily_spend.amount <= 0) {
+        errors.push('constraints.max_daily_spend.amount must be a finite positive number');
+    }
+    if (typeof policy.negotiation?.rounds_max !== 'number' || !Number.isInteger(policy.negotiation.rounds_max) || policy.negotiation.rounds_max < 1) {
+        errors.push('negotiation.rounds_max must be a positive integer');
+    }
+    if (!policy.negotiation?.quote_ttl || typeof policy.negotiation.quote_ttl !== 'string') {
+        errors.push('negotiation.quote_ttl must be a string (e.g. "15m", "2h")');
+    }
+    else {
+        // Validate TTL format early (before orchestrator)
+        try {
+            const { PolicyEngine } = await Promise.resolve().then(() => __importStar(require('../../negotiation/PolicyEngine')));
+            PolicyEngine.parseTtl(policy.negotiation.quote_ttl);
+        }
+        catch {
+            errors.push(`negotiation.quote_ttl has invalid format: "${policy.negotiation.quote_ttl}" (expected e.g. "15m", "2h", "30s")`);
+        }
+    }
+    if (!Array.isArray(policy.selection?.prioritize) || policy.selection.prioritize.length === 0) {
+        errors.push('selection.prioritize must be a non-empty array');
+    }
+    if (errors.length > 0) {
+        output.errorResult({
+            code: 'INVALID_POLICY',
+            message: `Invalid policy: ${errors.join('; ')}`,
+        });
+        process.exit(output_1.ExitCode.ERROR);
+    }
+    const rawPollInterval = options.pollInterval ?? '3000';
+    const pollInterval = /^\d+$/.test(rawPollInterval) ? Number(rawPollInterval) : NaN;
+    if (isNaN(pollInterval) || pollInterval < 100) {
+        output.errorResult({
+            code: 'INVALID_OPTION',
+            message: `--poll-interval must be a whole number >= 100ms, got: "${rawPollInterval}"`,
+        });
+        process.exit(output_1.ExitCode.ERROR);
+    }
+    const spinner = output.spinner(options.dryRun ? 'Scoring candidates...' : 'Negotiating...');
+    const client = await (0, client_1.createClient)();
+    const orchestrator = new BuyerOrchestrator_1.BuyerOrchestrator(policy, client.runtime, client.getAddress());
+    // Progress callback for human mode
+    const onProgress = (event) => {
+        if (options.json || options.quiet)
+            return;
+        switch (event.type) {
+            case 'discovery':
+                spinner.stop(true);
+                output.print(`Found ${event.candidates} candidates`);
+                break;
+            case 'scoring':
+                output.print(`Ranked ${event.ranked} candidates`);
+                break;
+            case 'round_start':
+                output.print(`Round ${event.round}: trying ${output_1.fmt.cyan(event.provider)}...`);
+                break;
+            case 'waiting_quote':
+                output.print(`  Waiting for quote (${event.ttlSeconds}s TTL)...`);
+                break;
+            case 'quote_received':
+                output.print('  Quote received, validating...');
+                break;
+            case 'round_end':
+                if (event.action === 'accepted') {
+                    output.success(`Round ${event.round}: ${output_1.fmt.green('accepted')} — ${event.reason}`);
+                }
+                else {
+                    output.print(`  Round ${event.round}: ${output_1.fmt.dim(event.action)} — ${event.reason}`);
+                }
+                break;
+            case 'complete':
+                break;
+        }
+    };
+    try {
+        const result = await orchestrator.negotiate({
+            dryRun: options.dryRun,
+            pollIntervalMs: pollInterval,
+            onProgress,
+        });
+        spinner.stop(result.success);
+        // Output result
+        output.result({
+            success: result.success,
+            commerce_session_id: result.commerce_session_id,
+            actp_tx_id: result.actp_tx_id,
+            selected_provider: result.selected_provider,
+            rounds_used: result.rounds_used,
+            reason: result.reason,
+            rounds: result.rounds,
+        }, { quietKey: result.success ? 'actp_tx_id' : 'reason' });
+        process.exit(result.success ? output_1.ExitCode.SUCCESS : output_1.ExitCode.ERROR);
+    }
+    catch (err) {
+        spinner.stop(false);
+        throw err;
+    }
+}
+//# sourceMappingURL=negotiate.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsEpC,wBAAgB,oBAAoB,IAAI,OAAO,CA4B9C"}
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyEpC,wBAAgB,oBAAoB,IAAI,OAAO,CA4B9C"}

package/dist/cli/commands/publish.js

@@ -49,9 +49,12 @@ const agirailsmd_1 = require("../../config/agirailsmd");
 const publishPipeline_1 = require("../../config/publishPipeline");
 const pendingPublish_1 = require("../../config/pendingPublish");
 const config_1 = require("../utils/config");
+const ethers_1 = require("ethers");
 const FilebaseClient_1 = require("../../storage/FilebaseClient");
 const ArweaveClient_1 = require("../../storage/ArweaveClient");
 const wallet_1 = require("../utils/wallet");
+const agirailsmdV4_1 = require("../../config/agirailsmdV4");
+const agirailsApp_1 = require("../../api/agirailsApp");
 // ============================================================================
 // Publish Proxy (fallback when no Filebase credentials)
 // ============================================================================
@@ -101,7 +104,7 @@ async function publishViaProxy(content, localConfigHash) {
 function createPublishCommand() {
     const cmd = new commander_1.Command('publish')
         .description('Publish AGIRAILS.md config (offline — activates on first payment)')
-        .argument('[path]', 'Path to AGIRAILS.md', './AGIRAILS.md')
+        .argument('[path]', 'Path to AGIRAILS.md or {slug}.md')
         .option('-n, --network <network>', 'DEPRECATED: network is auto-detected (accepted but ignored)')
         .option('--skip-arweave', 'Skip permanent Arweave storage (dev mode)')
         .option('--dry-run', 'Show what would happen without executing')
@@ -130,16 +133,33 @@ async function runPublish(filePath, options, output) {
     if (options.network) {
         output.warning('--network flag is deprecated and ignored. Network is auto-detected at payment time.');
     }
-    const resolvedPath = (0, path_1.resolve)(filePath);
+    // Resolve file path: explicit arg > identity pointer > ./AGIRAILS.md fallback
+    let effectivePath = filePath;
+    if (!effectivePath) {
+        const { resolveIdentityPath } = await Promise.resolve().then(() => __importStar(require('../utils/config')));
+        const identityPath = resolveIdentityPath();
+        if (identityPath) {
+            effectivePath = identityPath;
+        }
+        else if ((0, fs_1.existsSync)((0, path_1.resolve)('./AGIRAILS.md'))) {
+            effectivePath = './AGIRAILS.md';
+        }
+        else {
+            output.error('No file to publish. Provide a path, or create a {slug}.md identity file.\n' +
+                'Usage: actp publish [path]');
+            process.exit(output_1.ExitCode.INVALID_INPUT);
+        }
+    }
+    let resolvedPath = (0, path_1.resolve)(effectivePath);
     if (!(0, fs_1.existsSync)(resolvedPath)) {
-        output.error(`File not found: ${filePath}`);
+        output.error(`File not found: ${effectivePath}`);
         process.exit(output_1.ExitCode.INVALID_INPUT);
     }
     const spinner = output.spinner('Reading AGIRAILS.md...');
     try {
         // Read and compute hash
-        const content = (0, fs_1.readFileSync)(resolvedPath, 'utf-8');
-        const { configHash, structuredHash, bodyHash } = (0, agirailsmd_1.computeConfigHash)(content);
+        let content = (0, fs_1.readFileSync)(resolvedPath, 'utf-8');
+        let { configHash, structuredHash, bodyHash } = (0, agirailsmd_1.computeConfigHash)(content);
         if (options.dryRun) {
             spinner.stop(true);
             output.result({
@@ -153,6 +173,79 @@ async function runPublish(filePath, options, output) {
             output.success('Dry run complete. No changes made.');
             return;
         }
+        // ================================================================
+        // Phase 1: Slug check (pre-chain, no auth, only on first publish)
+        // ================================================================
+        let v4Config;
+        try {
+            v4Config = (0, agirailsmdV4_1.parseAgirailsMdV4)(content);
+        }
+        catch {
+            // Not a v4 file — skip slug check (backward compatible with v3 AGIRAILS.md)
+        }
+        if (v4Config && !v4Config.agent_id) {
+            // First publish — check slug availability
+            const slugSpinner = output.spinner(`Checking slug availability: ${v4Config.slug}...`);
+            try {
+                const slugResult = await (0, agirailsApp_1.checkSlug)(v4Config.slug);
+                if (!slugResult.available) {
+                    if (slugResult.suggestion) {
+                        slugSpinner.stop(true);
+                        const oldSlug = v4Config.slug;
+                        const newSlug = slugResult.suggestion;
+                        // Auto-rename: update frontmatter slug, rename file, update config pointer
+                        output.info(`Slug "${oldSlug}" was taken. Renamed to "${newSlug}".`);
+                        // Rename file on disk
+                        const { dirname, join: pathJoin } = await Promise.resolve().then(() => __importStar(require('path')));
+                        const dir = dirname(resolvedPath);
+                        const newPath = pathJoin(dir, `${newSlug}.md`);
+                        (0, fs_1.renameSync)(resolvedPath, newPath);
+                        // Re-read, update slug in frontmatter, rewrite, re-parse, recompute hash
+                        const rawContent = (0, fs_1.readFileSync)(newPath, 'utf-8');
+                        const parsed = (0, agirailsmd_1.parseAgirailsMd)(rawContent);
+                        const updatedFm = { ...parsed.frontmatter, slug: newSlug };
+                        const newContent = (0, agirailsmd_1.serializeAgirailsMd)(updatedFm, parsed.body);
+                        (0, fs_1.writeFileSync)(newPath, newContent, 'utf-8');
+                        // Update in-memory references for the rest of publish
+                        resolvedPath = newPath;
+                        v4Config.slug = newSlug;
+                        // Recompute configHash with new slug
+                        const reHash = (0, agirailsmd_1.computeConfigHash)(newContent);
+                        configHash = reHash.configHash;
+                        content = newContent;
+                        // Update config.json identity pointer
+                        try {
+                            const config = (0, config_1.loadConfig)((0, path_1.resolve)(newPath, '..'));
+                            config.identity = `${newSlug}.md`;
+                            (0, config_1.saveConfig)(config, (0, path_1.resolve)(newPath, '..'));
+                        }
+                        catch {
+                            // Best-effort
+                        }
+                    }
+                    else {
+                        slugSpinner.stop(false);
+                        throw new Error(`Slug "${v4Config.slug}" is already taken on agirails.app. Choose a different name.`);
+                    }
+                }
+                else {
+                    slugSpinner.stop(true);
+                    output.success(`Slug "${v4Config.slug}" is available.`);
+                }
+            }
+            catch (slugErr) {
+                if (slugErr.message.includes('already taken'))
+                    throw slugErr;
+                if (slugErr.message.includes('was taken')) {
+                    // Auto-rename succeeded — not an error
+                }
+                else {
+                    slugSpinner.stop(false);
+                    // Non-fatal: slug check API failure doesn't block publish
+                    output.warning(`Slug check failed: ${slugErr.message}. Proceeding.`);
+                }
+            }
+        }
         // Ensure .actp directory exists
         const actpDir = (0, pendingPublish_1.getActpDir)();
         if (!(0, fs_1.existsSync)(actpDir)) {
@@ -231,7 +324,7 @@ async function runPublish(filePath, options, output) {
             serviceDescriptors: regParams.serviceDescriptors,
             createdAt: new Date().toISOString(),
         };
-        const projectRoot = (0, path_1.resolve)(filePath, '..');
+        const projectRoot = (0, path_1.resolve)(resolvedPath, '..');
         // ================================================================
         // Local setup: bootstrap or migrate config, ensure .gitignore
         // "publish covers setup" — no separate `actp init` required.
@@ -263,11 +356,14 @@ async function runPublish(filePath, options, output) {
         // ALWAYS activate on testnet (one command, both networks per SPEC)
         // ================================================================
         let testnetTxHash;
+        let smartWalletAddress;
         const activationSpinner = output.spinner('Activating on testnet...');
         try {
-            testnetTxHash = await activateOnTestnet(projectRoot, configHash, cid, regParams.endpoint, regParams.serviceDescriptors, output);
+            const activationResult = await activateOnTestnet(projectRoot, configHash, cid, regParams.endpoint, regParams.serviceDescriptors, output);
             activationSpinner.stop(true);
-            if (testnetTxHash) {
+            if (activationResult) {
+                testnetTxHash = activationResult.txHash;
+                smartWalletAddress = activationResult.smartWalletAddress;
                 output.success(`Testnet activation: ${testnetTxHash}`);
             }
             else {
@@ -283,6 +379,172 @@ async function runPublish(filePath, options, output) {
         }
         // Always save mainnet pending (lazy — activates on first mainnet payment)
         (0, pendingPublish_1.savePendingPublish)({ ...pendingData, network: 'base-mainnet' });
+        // ================================================================
+        // Write-back: wallet, agent_id, did into AGIRAILS.md frontmatter
+        // These are in PUBLISH_METADATA_KEYS — stripped before hash computation.
+        // ================================================================
+        const publishMetadata = {};
+        // Wallet write-back: Smart Wallet is the on-chain identity (NFT owner,
+        // escrow party). EOA is only a fallback for non-Smart-Wallet flows.
+        const existingWallet = frontmatter.wallet;
+        const canonicalWallet = smartWalletAddress || existingWallet || walletAddress;
+        if (canonicalWallet) {
+            publishMetadata.wallet = canonicalWallet;
+            publishMetadata.did = `did:ethr:84532:${canonicalWallet}`;
+        }
+        // agent_id: query ERC-8004 Identity Registry for minted tokenId
+        // Use Smart Wallet address (NFT owner) when available, fall back to EOA
+        const ownerAddress = smartWalletAddress || existingWallet || walletAddress;
+        if (testnetTxHash && ownerAddress) {
+            try {
+                const { getNetwork: getNet } = await Promise.resolve().then(() => __importStar(require('../../config/networks')));
+                const { ethers: eth } = await Promise.resolve().then(() => __importStar(require('ethers')));
+                const net = getNet('base-sepolia');
+                const prov = new eth.JsonRpcProvider(net.rpcUrl);
+                // Query ERC-8004 Identity Registry for the agent's NFT tokenId
+                const erc8004Addr = net.contracts.erc8004IdentityRegistry;
+                if (erc8004Addr) {
+                    const { ERC8004_IDENTITY_ABI } = await Promise.resolve().then(() => __importStar(require('../../types/erc8004')));
+                    const erc8004 = new eth.Contract(erc8004Addr, ERC8004_IDENTITY_ABI, prov);
+                    // Parse Registered event from tx receipt for exact agentId
+                    let agentId;
+                    try {
+                        const receipt = await prov.getTransactionReceipt(testnetTxHash);
+                        if (receipt) {
+                            const registeredTopic = eth.id('Registered(uint256,string,address)');
+                            for (const log of receipt.logs) {
+                                if (log.address.toLowerCase() === erc8004Addr.toLowerCase()
+                                    && log.topics[0] === registeredTopic) {
+                                    // agentId is the first indexed parameter
+                                    agentId = BigInt(log.topics[1]).toString();
+                                    break;
+                                }
+                            }
+                        }
+                    }
+                    catch {
+                        // Event parsing failed — fall back to balanceOf query
+                    }
+                    // Fallback: query by balance if event parsing didn't work
+                    if (!agentId) {
+                        const balance = await erc8004.balanceOf(ownerAddress);
+                        if (Number(balance) > 0) {
+                            const lastIndex = Number(balance) - 1;
+                            agentId = (await erc8004.tokenOfOwnerByIndex(ownerAddress, lastIndex)).toString();
+                        }
+                    }
+                    if (agentId) {
+                        publishMetadata.agent_id = agentId;
+                        publishMetadata.did = `did:ethr:84532:${ownerAddress}`;
+                    }
+                }
+                // Fallback: check AgentRegistry if ERC-8004 didn't yield an agent_id
+                if (!publishMetadata.agent_id) {
+                    const registryAddr = net.contracts.agentRegistry;
+                    if (registryAddr) {
+                        const { AgentRegistryClient: ARC } = await Promise.resolve().then(() => __importStar(require('../../registry/AgentRegistryClient')));
+                        const regClient = ARC.readOnly(registryAddr, prov);
+                        const onChainConfig = await regClient.getConfig(ownerAddress);
+                        if (onChainConfig.isActive) {
+                            const agentId = BigInt(ownerAddress).toString();
+                            publishMetadata.agent_id = agentId;
+                            publishMetadata.did = `did:ethr:84532:${ownerAddress}`;
+                        }
+                    }
+                }
+            }
+            catch {
+                // Best-effort — agent_id will be written on re-publish
+            }
+        }
+        // ================================================================
+        // Phase 1: API upsert to agirails.app (post-chain, non-blocking)
+        // Requires agent_id — skipped on first publish (agent_id assigned
+        // on-chain, written back to YAML, available on re-publish).
+        // API routes: POST /api/v1/agents (dual auth: session + wallet-sig)
+        // ================================================================
+        if (v4Config && v4Config.agent_id && walletAddress) {
+            const apiSpinner = output.spinner('Syncing with agirails.app...');
+            try {
+                const publishTimestamp = Math.floor(Date.now() / 1000);
+                // C-2 fix: include network in signed message to prevent cross-network replay
+                // Upsert only fires after testnet activation, so network is always base-sepolia
+                const publishNetwork = 'base-sepolia';
+                const upsertMessage = `agirails-publish:${v4Config.slug}:${configHash}:${publishNetwork}:${publishTimestamp}`;
+                const { resolvePrivateKey: resolveKey } = await Promise.resolve().then(() => __importStar(require('../../wallet/keystore')));
+                const privKey = await resolveKey(projectRoot, { network: 'testnet' });
+                if (privKey) {
+                    const signer = new ethers_1.ethers.Wallet(privKey);
+                    const sig = await signer.signMessage(upsertMessage);
+                    const apiResult = await (0, agirailsApp_1.upsertAgent)({
+                        slug: v4Config.slug,
+                        agentId: v4Config.agent_id,
+                        wallet: smartWalletAddress || existingWallet || walletAddress,
+                        signer: walletAddress, // EOA that signed the message
+                        configCid: cid,
+                        configHash,
+                        signature: sig,
+                        message: upsertMessage,
+                        timestamp: publishTimestamp,
+                        network: publishNetwork,
+                        config: {
+                            name: v4Config.name,
+                            description: (v4Config.description || "").replace(/^#\s+[^\n]+\n*/, "").trim(),
+                            capabilities: v4Config.services,
+                            pricing: {
+                                model: "fixed",
+                                amount: String(v4Config.pricing.base),
+                                unit: v4Config.pricing.unit || "job",
+                                currency: v4Config.pricing.currency || "USDC",
+                                minimum: String(v4Config.pricing.min_price ?? v4Config.pricing.base),
+                            },
+                            sla: {
+                                availability: "24/7",
+                                responseTime: { p50: 30, p95: 300 },
+                                ...(v4Config.sla.concurrency ? { throughput: v4Config.sla.concurrency + " concurrent" } : {}),
+                            },
+                            ...(v4Config.sla.concurrency ? { concurrency: v4Config.sla.concurrency } : {}),
+                            payment_mode: v4Config.payment.modes.includes("x402") ? "x402" : "actp",
+                            network: v4Config.network,
+                            // Covenant: map V4 accepts/returns to web input/output format
+                            ...(v4Config.covenant.accepts && Object.keys(v4Config.covenant.accepts).length > 0 ? {
+                                covenant: {
+                                    input: Object.entries(v4Config.covenant.accepts).map(([k, v]) => k + ": " + v).join("\n"),
+                                    output: Object.entries(v4Config.covenant.returns).map(([k, v]) => k + ": " + v).join("\n"),
+                                    guarantees: [],
+                                    dispute: { window_hours: 24, resolution: "auto-refund" },
+                                },
+                            } : {}),
+                            // Endpoint: for x402 agents
+                            ...(v4Config.endpoint ? {
+                                endpoints: { execute: v4Config.endpoint },
+                            } : {}),
+                        },
+                    });
+                    apiSpinner.stop(true);
+                    output.success(`Profile live at: agirails.app/a/${v4Config.slug}`);
+                    // Display claim code if returned (for linking to dashboard)
+                    if (apiResult.claimCode) {
+                        output.print(`  Claim code: ${apiResult.claimCode}`);
+                        output.print(`  Claim link: https://agirails.app/claim?code=${apiResult.claimCode}`);
+                        output.print('  (use this to link the agent to your dashboard account)');
+                    }
+                }
+                else {
+                    apiSpinner.stop(false);
+                    output.info('Skipped agirails.app sync (no wallet key for signing).');
+                }
+            }
+            catch (apiErr) {
+                apiSpinner.stop(false);
+                // Non-blocking — agent is already on-chain
+                output.warning(`agirails.app sync failed: ${apiErr.message}`);
+                output.print('  Agent is on-chain. Retry with: actp publish');
+            }
+        }
+        else if (v4Config && !v4Config.agent_id) {
+            output.info('First publish — agirails.app sync will happen on re-publish (after agent_id is assigned).');
+        }
         // Update AGIRAILS.md frontmatter
         const updatedFrontmatter = {
             ...frontmatter,
@@ -290,9 +552,25 @@ async function runPublish(filePath, options, output) {
             config_cid: cid,
             published_at: new Date().toISOString(),
             ...(arweaveTxId ? { arweave_tx: arweaveTxId } : {}),
+            ...publishMetadata,
         };
         const updatedContent = (0, agirailsmd_1.serializeAgirailsMd)(updatedFrontmatter, body);
         (0, fs_1.writeFileSync)(resolvedPath, updatedContent, 'utf-8');
+        // Update identity pointer in config.json if this is a {slug}.md file
+        if (v4Config) {
+            try {
+                const { basename } = await Promise.resolve().then(() => __importStar(require('path')));
+                const config = (0, config_1.loadConfig)(projectRoot);
+                const filename = basename(resolvedPath);
+                if (config.identity !== filename) {
+                    config.identity = filename;
+                    (0, config_1.saveConfig)(config, projectRoot);
+                }
+            }
+            catch {
+                // Best-effort — config might not exist yet
+            }
+        }
         // Output results
         output.result({
             configHash,
@@ -310,17 +588,31 @@ async function runPublish(filePath, options, output) {
         }
         output.print('');
         output.print('Mainnet: on-chain activation will happen on your first payment.');
+        // Context-aware next steps
+        const hasEndpoint = frontmatter.endpoint && frontmatter.endpoint !== publishPipeline_1.PENDING_ENDPOINT;
         output.print('');
         output.print('Next steps:');
-        output.print('  - Verify config:  actp diff');
-        output.print('  - Make a payment: your first mainnet payment activates the agent on-chain');
+        if (!hasEndpoint) {
+            output.print('  1. Set your endpoint:    Add "endpoint: https://..." to AGIRAILS.md');
+            output.print('  2. Check endpoint:       actp health');
+            output.print('  3. Check your balance:   actp balance');
+            output.print('  4. Verify config match:  actp diff');
+        }
+        else {
+            output.print('  1. Check endpoint:       actp health');
+            output.print('  2. Check your balance:   actp balance');
+            output.print('  3. Verify config match:  actp diff');
+        }
+        // Suggest test payment on testnet
+        if (testnetTxHash && v4Config?.slug) {
+            output.print('');
+            output.print(`  Try a test payment: actp pay agirails.app/a/${v4Config.slug} 5`);
+        }
         // Warn if placeholder endpoint
-        if (!frontmatter.endpoint || frontmatter.endpoint === publishPipeline_1.PENDING_ENDPOINT) {
+        if (!hasEndpoint) {
             output.print('');
-            output.warning('No endpoint in AGIRAILS.md — using placeholder URL.');
-            output.print('  Update when your agent is deployed:');
-            output.print('    1. Add "endpoint: https://your-agent.com/webhook" to AGIRAILS.md');
-            output.print('    2. Run: actp publish');
+            output.warning('No endpoint set — your agent can\'t receive jobs yet.');
+            output.print('  Add "endpoint: https://your-agent.com/webhook" to AGIRAILS.md, then: actp publish');
         }
     }
     catch (error) {
@@ -393,7 +685,7 @@ async function activateOnTestnet(projectRoot, configHash, cid, endpoint, service
         // Already up-to-date on-chain — no activation needed
         return undefined;
     }
-    // Build activation calls
+    // Build activation calls (includes ERC-8004 identity mint for scenario A)
     const activationCalls = buildActivationBatch({
         scenario,
         agentRegistryAddress: networkConfig.contracts.agentRegistry,
@@ -401,6 +693,7 @@ async function activateOnTestnet(projectRoot, configHash, cid, endpoint, service
         configHash,
         listed: true,
         ...(scenario === 'A' ? { endpoint, serviceDescriptors } : {}),
+        erc8004IdentityRegistry: networkConfig.contracts.erc8004IdentityRegistry,
     });
     // Always mint test USDC on testnet (SPEC: "always")
     const mintCalls = buildTestnetMintBatch(networkConfig.contracts.usdc, smartWalletAddress, '1000000000');
@@ -416,6 +709,6 @@ async function activateOnTestnet(projectRoot, configHash, cid, endpoint, service
         throw new Error(`Testnet activation UserOp failed: ${receipt.hash}`);
     }
     output.success('Minted 1,000 test USDC to Smart Wallet');
-    return receipt.hash;
+    return { txHash: receipt.hash, smartWalletAddress };
 }
 //# sourceMappingURL=publish.js.map