@agirails/sdk 2.2.2 → 2.3.0

package/dist/cli/commands/pull.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Pull Command - Pull on-chain config to local AGIRAILS.md
+ *
+ * Fetches the published AGIRAILS.md from IPFS (via on-chain CID),
+ * verifies integrity against on-chain hash, and writes locally.
+ * Use --force to overwrite existing file without confirmation.
+ *
+ * @module cli/commands/pull
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPullCommand = void 0;
+const commander_1 = require("commander");
+const output_1 = require("../utils/output");
+const client_1 = require("../utils/client");
+const path_1 = require("path");
+const ethers_1 = require("ethers");
+const syncOperations_1 = require("../../config/syncOperations");
+const networks_1 = require("../../config/networks");
+// ============================================================================
+// Command Definition
+// ============================================================================
+function createPullCommand() {
+    const cmd = new commander_1.Command('pull')
+        .description('Pull on-chain AGIRAILS.md config to local file')
+        .argument('[path]', 'Path to write AGIRAILS.md', './AGIRAILS.md')
+        .option('-n, --network <network>', 'Network (base-sepolia | base-mainnet)', 'base-sepolia')
+        .option('-a, --address <address>', 'Agent address to pull config for')
+        .option('--force', 'Overwrite without confirmation (CI mode)')
+        .option('--json', 'Output as JSON')
+        .option('-q, --quiet', 'Minimal output')
+        .action(async (path, options) => {
+        const output = new output_1.Output(options.json ? 'json' : options.quiet ? 'quiet' : 'human');
+        try {
+            await runPull(path, 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.createPullCommand = createPullCommand;
+async function runPull(filePath, options, output) {
+    const resolvedPath = (0, path_1.resolve)(filePath);
+    // Determine agent address
+    let agentAddress = options.address;
+    if (!agentAddress) {
+        const privateKey = process.env.ACTP_PRIVATE_KEY || process.env.PRIVATE_KEY;
+        if (!privateKey) {
+            output.error('Agent address required. Use --address or set ACTP_PRIVATE_KEY env var.');
+            process.exit(output_1.ExitCode.INVALID_INPUT);
+        }
+        agentAddress = new ethers_1.ethers.Wallet(privateKey).address;
+    }
+    const networkConfig = (0, networks_1.getNetwork)(options.network);
+    if (!networkConfig.contracts.agentRegistry) {
+        output.error(`AgentRegistry not deployed on ${options.network}`);
+        process.exit(output_1.ExitCode.ERROR);
+    }
+    const spinner = output.spinner('Pulling config from on-chain...');
+    try {
+        const provider = new ethers_1.ethers.JsonRpcProvider(networkConfig.rpcUrl);
+        const result = await (0, syncOperations_1.pull)({
+            path: resolvedPath,
+            agentAddress,
+            registryAddress: networkConfig.contracts.agentRegistry,
+            provider,
+            force: options.force,
+        });
+        spinner.stop(result.written);
+        output.result({
+            written: result.written,
+            cid: result.cid || null,
+            status: result.status,
+            path: resolvedPath,
+            network: options.network,
+        }, { quietKey: 'status' });
+        if (result.written) {
+            output.blank();
+            output.success(`Config pulled and written to ${filePath}`);
+        }
+        else {
+            output.blank();
+            output.info(result.status);
+        }
+    }
+    catch (error) {
+        spinner.stop(false);
+        throw error;
+    }
+}
+//# sourceMappingURL=pull.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../../src/cli/commands/pull.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,yCAAoC;AACpC,4CAAmD;AACnD,4CAA2C;AAC3C,+BAA+B;AAC/B,mCAAgC;AAChC,gEAAmD;AACnD,oDAAmD;AAEnD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,SAAgB,iBAAiB;IAC/B,MAAM,GAAG,GAAG,IAAI,mBAAO,CAAC,MAAM,CAAC;SAC5B,WAAW,CAAC,gDAAgD,CAAC;SAC7D,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,EAAE,eAAe,CAAC;SAChE,MAAM,CAAC,yBAAyB,EAAE,uCAAuC,EAAE,cAAc,CAAC;SAC1F,MAAM,CAAC,yBAAyB,EAAE,kCAAkC,CAAC;SACrE,MAAM,CAAC,SAAS,EAAE,0CAA0C,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;SACvC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,IAAI,eAAM,CACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAC1D,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,eAAe,GAAG,IAAA,iBAAQ,EAAC,KAAK,CAAC,CAAC;YACxC,MAAM,CAAC,WAAW,CAAC;gBACjB,IAAI,EAAE,eAAe,CAAC,IAAI;gBAC1B,OAAO,EAAE,eAAe,CAAC,OAAO;gBAChC,OAAO,EAAE,eAAe,CAAC,OAAO;aACjC,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,iBAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC;AA5BD,8CA4BC;AAYD,KAAK,UAAU,OAAO,CACpB,QAAgB,EAChB,OAA2B,EAC3B,MAAc;IAEd,MAAM,YAAY,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC;IAEvC,0BAA0B;IAC1B,IAAI,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IACnC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAC3E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;YACvF,OAAO,CAAC,IAAI,CAAC,iBAAQ,CAAC,aAAa,CAAC,CAAC;QACvC,CAAC;QACD,YAAY,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;IACvD,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,qBAAU,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,iCAAiC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,iBAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,eAAM,CAAC,eAAe,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAI,EAAC;YACxB,IAAI,EAAE,YAAY;YAClB,YAAY;YACZ,eAAe,EAAE,aAAa,CAAC,SAAS,CAAC,aAAa;YACtD,QAAQ;YACR,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE7B,MAAM,CAAC,MAAM,CACX;YACE,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,EACD,EAAE,QAAQ,EAAE,QAAQ,EAAE,CACvB,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cli/index.js

@@ -49,6 +49,9 @@ const watch_1 = require("./commands/watch");
 const simulate_1 = require("./commands/simulate");
 const batch_1 = require("./commands/batch");
 const time_1 = require("./commands/time");
+const publish_1 = require("./commands/publish");
+const pull_1 = require("./commands/pull");
+const diff_1 = require("./commands/diff");
 // ============================================================================
 // Program Setup
 // ============================================================================
@@ -83,6 +86,10 @@ program.addCommand((0, simulate_1.createSimulateCommand)());
 program.addCommand((0, batch_1.createBatchCommand)());
 // Mock mode utilities
 program.addCommand((0, time_1.createTimeCommand)());
+// Config sync commands (AGIRAILS.md as source of truth)
+program.addCommand((0, publish_1.createPublishCommand)());
+program.addCommand((0, pull_1.createPullCommand)());
+program.addCommand((0, diff_1.createDiffCommand)());
 // ============================================================================
 // Error Handling
 // ============================================================================

package/dist/cli/index.js.map

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

package/dist/config/agirailsmd.d.ts

@@ -0,0 +1,94 @@
+/**
+ * AGIRAILS.md Parser + Canonical Hash
+ *
+ * Parses AGIRAILS.md files (YAML frontmatter + markdown body),
+ * computes deterministic canonical hashes for on-chain verification.
+ *
+ * ## Canonical Hash Algorithm
+ *
+ * 1. Parse YAML frontmatter into a plain object
+ * 2. **Strip publish metadata keys** (config_hash, published_at, config_cid, arweave_tx)
+ *    — these are written back by the publish pipeline and must not affect the hash
+ * 3. Canonicalize frontmatter:
+ *    - Object keys: sorted lexicographically (recursive)
+ *    - Primitive arrays: sorted lexicographically by `String(value).localeCompare()`
+ *    - Object arrays: order preserved (semantic ordering matters)
+ *    - Date objects: converted to ISO-8601 string (`.toISOString()`)
+ *    - null/undefined: preserved as-is
+ * 4. `structuredHash = keccak256(JSON.stringify(canonical))`
+ * 5. Normalize body: CRLF→LF, strip trailing whitespace per line, trim
+ * 6. `bodyHash = keccak256(normalizedBody)`
+ * 7. `configHash = keccak256(structuredHash ++ bodyHash)` (byte concatenation)
+ *
+ * @module config/agirailsmd
+ */
+export interface AgirailsMdConfig {
+    /** Parsed YAML frontmatter as a plain object */
+    frontmatter: Record<string, unknown>;
+    /** Markdown body (everything after the closing ---) */
+    body: string;
+}
+export interface AgirailsMdHashResult {
+    /** Final configHash = keccak256(structuredHash + bodyHash) */
+    configHash: string;
+    /** Hash of the canonical JSON representation of frontmatter */
+    structuredHash: string;
+    /** Hash of the normalized markdown body */
+    bodyHash: string;
+}
+/**
+ * Frontmatter keys written by the publish pipeline.
+ * These are stripped before hash computation to prevent self-reference drift:
+ * publish writes config_hash back → changes frontmatter → changes hash → never in sync.
+ */
+export declare const PUBLISH_METADATA_KEYS: readonly ["config_hash", "published_at", "config_cid", "arweave_tx", "template_source"];
+/**
+ * Strip publish metadata keys from a frontmatter object.
+ * Returns a shallow copy with the metadata keys removed.
+ */
+export declare function stripPublishMetadata(frontmatter: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Parse an AGIRAILS.md file into frontmatter + body.
+ *
+ * @param content - Raw file content (string)
+ * @returns Parsed config with frontmatter object and body string
+ * @throws Error if content has no valid YAML frontmatter
+ */
+export declare function parseAgirailsMd(content: string): AgirailsMdConfig;
+/**
+ * Recursively canonicalize a value for deterministic JSON serialization.
+ *
+ * - Object keys: sorted lexicographically
+ * - Primitive arrays: sorted by String(x).localeCompare()
+ * - Object arrays: order preserved
+ * - Date objects: converted to ISO-8601 string
+ * - null/undefined: preserved
+ */
+export declare function canonicalize(value: unknown): unknown;
+/**
+ * Compute the canonical config hash from raw AGIRAILS.md content.
+ *
+ * @param content - Raw AGIRAILS.md file content
+ * @returns Hash result with configHash, structuredHash, and bodyHash
+ */
+export declare function computeConfigHash(content: string): AgirailsMdHashResult;
+/**
+ * Compute the canonical config hash from parsed parts.
+ *
+ * Publish metadata keys (config_hash, published_at, config_cid, arweave_tx)
+ * are automatically stripped before hashing to prevent self-reference drift.
+ *
+ * @param frontmatter - Parsed YAML frontmatter object
+ * @param body - Markdown body string
+ * @returns Hash result with configHash, structuredHash, and bodyHash
+ */
+export declare function computeConfigHashFromParts(frontmatter: Record<string, unknown>, body: string): AgirailsMdHashResult;
+/**
+ * Serialize config back to AGIRAILS.md format.
+ *
+ * @param frontmatter - YAML frontmatter object
+ * @param body - Markdown body string
+ * @returns Complete AGIRAILS.md file content
+ */
+export declare function serializeAgirailsMd(frontmatter: Record<string, unknown>, body: string): string;
+//# sourceMappingURL=agirailsmd.d.ts.map

package/dist/config/agirailsmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agirailsmd.d.ts","sourceRoot":"","sources":["../../src/config/agirailsmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,yFAMxB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAiCjE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqCpD;AAkBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAGvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,oBAAoB,CAmBtB;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,MAAM,CASR"}

package/dist/config/agirailsmd.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * AGIRAILS.md Parser + Canonical Hash
+ *
+ * Parses AGIRAILS.md files (YAML frontmatter + markdown body),
+ * computes deterministic canonical hashes for on-chain verification.
+ *
+ * ## Canonical Hash Algorithm
+ *
+ * 1. Parse YAML frontmatter into a plain object
+ * 2. **Strip publish metadata keys** (config_hash, published_at, config_cid, arweave_tx)
+ *    — these are written back by the publish pipeline and must not affect the hash
+ * 3. Canonicalize frontmatter:
+ *    - Object keys: sorted lexicographically (recursive)
+ *    - Primitive arrays: sorted lexicographically by `String(value).localeCompare()`
+ *    - Object arrays: order preserved (semantic ordering matters)
+ *    - Date objects: converted to ISO-8601 string (`.toISOString()`)
+ *    - null/undefined: preserved as-is
+ * 4. `structuredHash = keccak256(JSON.stringify(canonical))`
+ * 5. Normalize body: CRLF→LF, strip trailing whitespace per line, trim
+ * 6. `bodyHash = keccak256(normalizedBody)`
+ * 7. `configHash = keccak256(structuredHash ++ bodyHash)` (byte concatenation)
+ *
+ * @module config/agirailsmd
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeAgirailsMd = exports.computeConfigHashFromParts = exports.computeConfigHash = exports.canonicalize = exports.parseAgirailsMd = exports.stripPublishMetadata = exports.PUBLISH_METADATA_KEYS = void 0;
+const ethers_1 = require("ethers");
+const yaml_1 = require("yaml");
+// ============================================================================
+// Publish Metadata (excluded from hash computation)
+// ============================================================================
+/**
+ * Frontmatter keys written by the publish pipeline.
+ * These are stripped before hash computation to prevent self-reference drift:
+ * publish writes config_hash back → changes frontmatter → changes hash → never in sync.
+ */
+exports.PUBLISH_METADATA_KEYS = [
+    'config_hash',
+    'published_at',
+    'config_cid',
+    'arweave_tx',
+    'template_source',
+];
+/**
+ * Strip publish metadata keys from a frontmatter object.
+ * Returns a shallow copy with the metadata keys removed.
+ */
+function stripPublishMetadata(frontmatter) {
+    const stripped = { ...frontmatter };
+    for (const key of exports.PUBLISH_METADATA_KEYS) {
+        delete stripped[key];
+    }
+    return stripped;
+}
+exports.stripPublishMetadata = stripPublishMetadata;
+// ============================================================================
+// Parser
+// ============================================================================
+/**
+ * Parse an AGIRAILS.md file into frontmatter + body.
+ *
+ * @param content - Raw file content (string)
+ * @returns Parsed config with frontmatter object and body string
+ * @throws Error if content has no valid YAML frontmatter
+ */
+function parseAgirailsMd(content) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith('---')) {
+        throw new Error('AGIRAILS.md must start with YAML frontmatter (---)');
+    }
+    // Find closing ---
+    const closingIndex = trimmed.indexOf('\n---', 3);
+    if (closingIndex === -1) {
+        throw new Error('AGIRAILS.md frontmatter is not closed (missing closing ---)');
+    }
+    const yamlContent = trimmed.slice(4, closingIndex); // skip opening ---\n
+    const body = trimmed.slice(closingIndex + 4); // skip \n---
+    // Parse YAML
+    let frontmatter;
+    try {
+        frontmatter = (0, yaml_1.parse)(yamlContent);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to parse YAML frontmatter: ${message}`);
+    }
+    if (typeof frontmatter !== 'object' || frontmatter === null) {
+        throw new Error('YAML frontmatter must be an object');
+    }
+    return {
+        frontmatter,
+        body: body.startsWith('\n') ? body.slice(1) : body,
+    };
+}
+exports.parseAgirailsMd = parseAgirailsMd;
+// ============================================================================
+// Canonical Hash
+// ============================================================================
+/**
+ * Recursively canonicalize a value for deterministic JSON serialization.
+ *
+ * - Object keys: sorted lexicographically
+ * - Primitive arrays: sorted by String(x).localeCompare()
+ * - Object arrays: order preserved
+ * - Date objects: converted to ISO-8601 string
+ * - null/undefined: preserved
+ */
+function canonicalize(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    // Handle Date objects deterministically (YAML parser may auto-create these)
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (Array.isArray(value)) {
+        // Canonicalize each element, then sort arrays of primitives lexicographically
+        const canonicalized = value.map(canonicalize);
+        // Only sort arrays of primitives (strings, numbers, booleans)
+        // Arrays of objects maintain order (e.g., onboarding questions have semantic ordering)
+        const allPrimitive = canonicalized.every((item) => typeof item === 'string' || typeof item === 'number' || typeof item === 'boolean');
+        if (allPrimitive) {
+            return canonicalized.sort((a, b) => String(a).localeCompare(String(b)));
+        }
+        return canonicalized;
+    }
+    if (typeof value === 'object') {
+        const sorted = {};
+        const keys = Object.keys(value).sort();
+        for (const key of keys) {
+            sorted[key] = canonicalize(value[key]);
+        }
+        return sorted;
+    }
+    return value;
+}
+exports.canonicalize = canonicalize;
+/**
+ * Normalize markdown body for deterministic hashing.
+ * - Strip trailing whitespace from each line
+ * - Ensure \n line endings
+ * - Trim leading/trailing whitespace
+ */
+function normalizeBody(body) {
+    return body
+        .replace(/\r\n/g, '\n') // CRLF → LF
+        .replace(/\r/g, '\n') // CR → LF
+        .split('\n')
+        .map((line) => line.trimEnd()) // strip trailing whitespace per line
+        .join('\n')
+        .trim(); // trim leading/trailing
+}
+/**
+ * Compute the canonical config hash from raw AGIRAILS.md content.
+ *
+ * @param content - Raw AGIRAILS.md file content
+ * @returns Hash result with configHash, structuredHash, and bodyHash
+ */
+function computeConfigHash(content) {
+    const { frontmatter, body } = parseAgirailsMd(content);
+    return computeConfigHashFromParts(frontmatter, body);
+}
+exports.computeConfigHash = computeConfigHash;
+/**
+ * Compute the canonical config hash from parsed parts.
+ *
+ * Publish metadata keys (config_hash, published_at, config_cid, arweave_tx)
+ * are automatically stripped before hashing to prevent self-reference drift.
+ *
+ * @param frontmatter - Parsed YAML frontmatter object
+ * @param body - Markdown body string
+ * @returns Hash result with configHash, structuredHash, and bodyHash
+ */
+function computeConfigHashFromParts(frontmatter, body) {
+    // Step 0: Strip publish metadata to prevent self-reference drift
+    const stripped = stripPublishMetadata(frontmatter);
+    // Step 1: Canonical JSON of frontmatter (with metadata stripped)
+    const canonical = canonicalize(stripped);
+    const canonicalJson = JSON.stringify(canonical);
+    const structuredHash = ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(canonicalJson));
+    // Step 2: Normalized body hash
+    const normalized = normalizeBody(body);
+    const bodyHash = ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(normalized));
+    // Step 3: Combined hash
+    const configHash = ethers_1.ethers.keccak256(ethers_1.ethers.concat([ethers_1.ethers.getBytes(structuredHash), ethers_1.ethers.getBytes(bodyHash)]));
+    return { configHash, structuredHash, bodyHash };
+}
+exports.computeConfigHashFromParts = computeConfigHashFromParts;
+// ============================================================================
+// Serializer
+// ============================================================================
+/**
+ * Serialize config back to AGIRAILS.md format.
+ *
+ * @param frontmatter - YAML frontmatter object
+ * @param body - Markdown body string
+ * @returns Complete AGIRAILS.md file content
+ */
+function serializeAgirailsMd(frontmatter, body) {
+    const yamlStr = (0, yaml_1.stringify)(frontmatter, {
+        lineWidth: 120,
+        singleQuote: false,
+    }).trimEnd();
+    const normalizedBody = body.startsWith('\n') ? body : `\n${body}`;
+    return `---\n${yamlStr}\n---\n${normalizedBody}`;
+}
+exports.serializeAgirailsMd = serializeAgirailsMd;
+//# sourceMappingURL=agirailsmd.js.map

package/dist/config/agirailsmd.js.map

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

package/dist/config/networks.d.ts

@@ -15,9 +15,11 @@ export interface NetworkConfig {
         agentRegistry?: string;
         identityRegistry?: string;
         archiveTreasury?: string;
+        x402Relay?: string;
     };
     eas: {
         deliverySchemaUID: string;
+        configSnapshotSchemaUID?: string;
     };
     gasSettings: {
         maxFeePerGas: bigint;

package/dist/config/networks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../../src/config/networks.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,GAAG,EAAE;QACH,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,WAAW,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,aA4B1B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,aA+B1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAGlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAmCzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA0BjE"}
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../../src/config/networks.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,GAAG,EAAE;QACH,iBAAiB,EAAE,MAAM,CAAC;QAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,WAAW,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,aA8B1B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,aAiC1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAGlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAqCzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA0BjE"}

package/dist/config/networks.js

@@ -36,7 +36,9 @@ exports.BASE_SEPOLIA = {
         // AIP-7 Identity Registry - ERC-1056 DID Registry (deployed 2026-01-09)
         identityRegistry: '0xF64F748C7802a68Cb936a9213881fE74e83FDA97',
         // AIP-7 Archive Treasury - Arweave funding (deployed 2026-01-09)
-        archiveTreasury: '0xeB75DE7cF5ce77ab15BB0fFa3a2A79e6aaa554B0'
+        archiveTreasury: '0xeB75DE7cF5ce77ab15BB0fFa3a2A79e6aaa554B0',
+        // X402Relay - atomic payment fee splitting (TODO: deploy and set address)
+        // x402Relay: '0x...',
     },
     eas: {
         // Deployed 2025-11-23 - AIP-4 delivery proof schema
@@ -69,7 +71,9 @@ exports.BASE_MAINNET = {
         easSchemaRegistry: '0x4200000000000000000000000000000000000020',
         // AIP-7 contracts
         agentRegistry: '0xbf9Aa0FC291A06A4dFA943c3E0Ad41E7aE20DF02',
-        archiveTreasury: '0x64B8f93fef2D2E749F5E88586753343F73246012'
+        archiveTreasury: '0x64B8f93fef2D2E749F5E88586753343F73246012',
+        // X402Relay - atomic payment fee splitting (TODO: deploy and set address)
+        // x402Relay: '0x...',
     },
     eas: {
         // Registered 2026-02-03
@@ -117,10 +121,12 @@ function getNetwork(network) {
             easSchemaRegistry: config.contracts.easSchemaRegistry,
             agentRegistry: config.contracts.agentRegistry,
             identityRegistry: config.contracts.identityRegistry,
-            archiveTreasury: config.contracts.archiveTreasury
+            archiveTreasury: config.contracts.archiveTreasury,
+            x402Relay: config.contracts.x402Relay
         },
         eas: {
-            deliverySchemaUID: config.eas.deliverySchemaUID
+            deliverySchemaUID: config.eas.deliverySchemaUID,
+            configSnapshotSchemaUID: config.eas.configSnapshotSchemaUID
         },
         gasSettings: {
             maxFeePerGas: config.gasSettings.maxFeePerGas,

package/dist/config/networks.js.map

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

package/dist/config/publishPipeline.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Publish Pipeline - AGIRAILS.md → IPFS → Arweave → On-Chain
+ *
+ * Orchestrates the full publish flow:
+ * 1. Read AGIRAILS.md → parse → compute configHash
+ * 2. Upload to Filebase (IPFS pinning)
+ * 3. Upload to Arweave (permanent storage) [optional]
+ * 4. Call AgentRegistry.publishConfig(cid, hash) on-chain
+ * 5. Update AGIRAILS.md frontmatter with config_hash and published_at
+ *
+ * @module config/publishPipeline
+ */
+import { Signer } from 'ethers';
+import { FilebaseClient } from '../storage/FilebaseClient';
+import { ArweaveClient } from '../storage/ArweaveClient';
+export interface PublishOptions {
+    /** Path to AGIRAILS.md file */
+    path: string;
+    /** Network name (for registry address lookup) */
+    network: string;
+    /** AgentRegistry contract address */
+    registryAddress: string;
+    /** Signer for on-chain transactions */
+    signer: Signer;
+    /** Filebase client for IPFS upload */
+    filebaseClient: FilebaseClient;
+    /** Arweave client for permanent storage (optional) */
+    arweaveClient?: ArweaveClient;
+    /** Skip Arweave upload (dev mode) */
+    skipArweave?: boolean;
+    /** Dry run - compute and show but don't execute */
+    dryRun?: boolean;
+    /** Gas settings */
+    gasSettings?: {
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+    };
+}
+export interface PublishResult {
+    /** IPFS CID of the uploaded AGIRAILS.md */
+    cid: string;
+    /** Canonical config hash (bytes32) */
+    configHash: string;
+    /** On-chain transaction hash */
+    txHash?: string;
+    /** Arweave transaction ID (if uploaded) */
+    arweaveTxId?: string;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    /** Whether the agent was auto-registered during this publish */
+    registered?: boolean;
+}
+export declare const PENDING_ENDPOINT = "https://pending.agirails.io";
+/**
+ * Execute the full publish pipeline.
+ *
+ * @param options - Publish configuration
+ * @returns Publish result with CID, hash, and transaction hashes
+ */
+export declare function publishAgirailsMd(options: PublishOptions): Promise<PublishResult>;
+//# sourceMappingURL=publishPipeline.d.ts.map

package/dist/config/publishPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishPipeline.d.ts","sourceRoot":"","sources":["../../src/config/publishPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,MAAM,EAA0B,MAAM,QAAQ,CAAC;AAIxD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAOzD,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,cAAc,EAAE,cAAc,CAAC;IAC/B,sDAAsD;IACtD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAMD,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAgH9D;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAwFvF"}