clawd-automaton 0.1.0

package/dist/ooda/validate.d.ts

@@ -0,0 +1,33 @@
+import type { Book } from "./state.js";
+export interface RalphConfig {
+    mode: "paper";
+    network: "devnet";
+    max_action_per_tick: number;
+    max_position_size_lamports: number;
+    loss_killswitch_consecutive: number;
+    goblin: boolean;
+    dark_defi_armed: boolean;
+    tick_sleep_ms: number;
+    model: string;
+}
+export type Decision = {
+    action: "hold";
+    reason: string;
+} | {
+    action: "open";
+    side: "long" | "short";
+    size_lamports: number;
+    reason: string;
+} | {
+    action: "close";
+    position_id: string;
+    reason: string;
+};
+export interface ValidationResult {
+    ok: boolean;
+    decision: Decision;
+    violation?: string;
+}
+export declare function validate(raw: unknown, config: RalphConfig, book: Book): ValidationResult;
+export declare function parseRalphConfig(markdownContent: string): RalphConfig;
+//# sourceMappingURL=validate.d.ts.map

package/dist/ooda/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/ooda/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,QAAQ,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,2BAA2B,EAAE,MAAM,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,gBAAgB,CA0DxF;AAUD,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CA2BrE"}

package/dist/ooda/validate.js

@@ -0,0 +1,91 @@
+const REASON_MAX_CHARS = 180;
+const GOBLIN_REASON_MIN_CHARS = 20;
+export function validate(raw, config, book) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        return reject("decision is not a JSON object", safeHold("non-object response"));
+    }
+    const d = raw;
+    const action = d["action"];
+    if (action !== "hold" && action !== "open" && action !== "close") {
+        return reject(`unknown action "${String(action)}"`, safeHold("unknown action"));
+    }
+    const reason = String(d["reason"] ?? "").trim();
+    if (!reason)
+        return reject("reason is empty", safeHold("empty reason"));
+    if (config.goblin && reason.length < GOBLIN_REASON_MIN_CHARS) {
+        return reject(`goblin reason too short (${reason.length} < ${GOBLIN_REASON_MIN_CHARS})`, safeHold("goblin reason too short for legal chaos"));
+    }
+    if (reason.length > REASON_MAX_CHARS) {
+        return reject(`reason too long (${reason.length} > ${REASON_MAX_CHARS} chars)`, safeHold(`reason too long: ${reason.slice(0, 100)}`));
+    }
+    const lowerReason = reason.toLowerCase();
+    for (const term of ["private_key", "seed phrase", "secret key", "mnemonic", "signer", "keypair", "wallet file"]) {
+        if (lowerReason.includes(term)) {
+            return reject(`prompt-injection detected: reason contains "${term}"`, {
+                action: "hold",
+                reason: "prompt-injection attempt refused by the paper safety harness",
+            });
+        }
+    }
+    if (action === "hold")
+        return { ok: true, decision: { action: "hold", reason } };
+    if (action === "open") {
+        const side = d["side"];
+        if (side !== "long" && side !== "short") {
+            return reject(`open.side must be long or short, got "${String(side)}"`, safeHold("bad side"));
+        }
+        const size = Number(d["size_lamports"] ?? 0);
+        if (!Number.isInteger(size) || size <= 0) {
+            return reject(`size_lamports must be a positive integer, got ${size}`, safeHold("bad size"));
+        }
+        if (size > config.max_position_size_lamports) {
+            return reject(`size_lamports ${size} exceeds cap ${config.max_position_size_lamports}`, safeHold("size exceeds paper cap"));
+        }
+        if (book.positions.length >= 1) {
+            return reject("tried to open while a position is already open", safeHold("position already open; one-at-a-time guard"));
+        }
+        return { ok: true, decision: { action: "open", side, size_lamports: size, reason } };
+    }
+    const positionId = String(d["position_id"] ?? "");
+    if (!positionId)
+        return reject("close.position_id is missing", safeHold("missing position id"));
+    if (!book.positions.some((position) => position.id === positionId)) {
+        return reject(`close.position_id "${positionId}" not found in book`, safeHold("position not found in paper book"));
+    }
+    return { ok: true, decision: { action: "close", position_id: positionId, reason } };
+}
+function reject(violation, fallback) {
+    return { ok: false, decision: fallback, violation };
+}
+function safeHold(reason) {
+    return { action: "hold", reason: reason.slice(0, REASON_MAX_CHARS) };
+}
+export function parseRalphConfig(markdownContent) {
+    const match = markdownContent.match(/^---\n([\s\S]*?)\n---/);
+    if (!match?.[1])
+        throw new Error("RALPH config missing YAML frontmatter");
+    const fm = match[1];
+    const get = (key, def) => (fm.match(new RegExp(`^${key}:\\s*(.+)$`, "m"))?.[1] ?? def).trim();
+    const bool = (key, def) => {
+        const value = get(key, String(def)).toLowerCase();
+        return value === "true" || value === "1" || value === "yes";
+    };
+    const mode = get("mode", "paper");
+    const network = get("network", "devnet");
+    if (mode !== "paper")
+        throw new Error(`[SAFETY] mode must be "paper", got "${mode}"`);
+    if (network !== "devnet")
+        throw new Error(`[SAFETY] network must be "devnet", got "${network}"`);
+    return {
+        mode: "paper",
+        network: "devnet",
+        max_action_per_tick: Number.parseInt(get("max_action_per_tick", "1"), 10),
+        max_position_size_lamports: Number.parseInt(get("max_position_size_lamports", "1000000"), 10),
+        loss_killswitch_consecutive: Number.parseInt(get("loss_killswitch_consecutive", "3"), 10),
+        goblin: bool("goblin", false),
+        dark_defi_armed: bool("dark_defi_armed", false),
+        tick_sleep_ms: Number.parseInt(get("tick_sleep_ms", "250"), 10),
+        model: get("model", "deterministic"),
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/ooda/validate.js.map

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

package/dist/registry/agent-card.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Agent Card
+ *
+ * Generates and manages the agent's self-description card.
+ * This is the JSON document pointed to by the ERC-8004 agentURI.
+ * Can be hosted on IPFS or served at /.well-known/agent-card.json
+ */
+import type { AgentCard, AutomatonConfig, AutomatonIdentity, AutomatonDatabase, ClawdRuntimeClient } from "../types.js";
+/**
+ * Generate an agent card from the automaton's current state.
+ */
+export declare function generateAgentCard(identity: AutomatonIdentity, config: AutomatonConfig, db: AutomatonDatabase): AgentCard;
+/**
+ * Serialize agent card to JSON string.
+ */
+export declare function serializeAgentCard(card: AgentCard): string;
+/**
+ * Host the agent card at /.well-known/agent-card.json
+ * by exposing a simple HTTP server on a port.
+ */
+export declare function hostAgentCard(card: AgentCard, runtime: ClawdRuntimeClient, port?: number): Promise<string>;
+/**
+ * Write agent card to the state directory for git versioning.
+ */
+export declare function saveAgentCard(card: AgentCard, runtime: ClawdRuntimeClient): Promise<void>;
+//# sourceMappingURL=agent-card.d.ts.map

package/dist/registry/agent-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/registry/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,SAAS,EAET,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAKrB;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,iBAAiB,GACpB,SAAS,CAyCX;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,kBAAkB,EAC3B,IAAI,GAAE,MAAa,GAClB,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/registry/agent-card.js

@@ -0,0 +1,94 @@
+/**
+ * Agent Card
+ *
+ * Generates and manages the agent's self-description card.
+ * This is the JSON document pointed to by the ERC-8004 agentURI.
+ * Can be hosted on IPFS or served at /.well-known/agent-card.json
+ */
+const AGENT_CARD_TYPE = "https://eips.ethereum.org/EIPS/eip-8004#registration-v1";
+/**
+ * Generate an agent card from the automaton's current state.
+ */
+export function generateAgentCard(identity, config, db) {
+    const services = [
+        {
+            name: "agentWallet",
+            endpoint: `eip155:8453:${identity.address}`,
+        },
+        {
+            name: "runtime",
+            endpoint: config.clawdApiUrl,
+        },
+    ];
+    // Add sandbox endpoint if available
+    if (identity.sandboxId) {
+        services.push({
+            name: "sandbox",
+            endpoint: `https://${identity.sandboxId}.life.x402.wtf`,
+        });
+    }
+    const children = db.getChildren();
+    const skills = db.getSkills(true);
+    let description = `Autonomous agent running on CLAWD Cloud.`;
+    description += ` Creator: ${config.creatorAddress}.`;
+    if (skills.length > 0) {
+        description += ` Skills: ${skills.map((s) => s.name).join(", ")}.`;
+    }
+    if (children.length > 0) {
+        description += ` Children: ${children.length}.`;
+    }
+    return {
+        type: AGENT_CARD_TYPE,
+        name: config.name,
+        description,
+        services,
+        x402Support: true,
+        active: true,
+        parentAgent: config.parentAddress || config.creatorAddress,
+    };
+}
+/**
+ * Serialize agent card to JSON string.
+ */
+export function serializeAgentCard(card) {
+    return JSON.stringify(card, null, 2);
+}
+/**
+ * Host the agent card at /.well-known/agent-card.json
+ * by exposing a simple HTTP server on a port.
+ */
+export async function hostAgentCard(card, runtime, port = 8004) {
+    const cardJson = serializeAgentCard(card);
+    // Write a simple server script
+    const serverScript = `
+const http = require('http');
+const card = ${cardJson};
+
+const server = http.createServer((req, res) => {
+  if (req.url === '/.well-known/agent-card.json' || req.url === '/agent-card.json') {
+    res.writeHead(200, { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*' });
+    res.end(JSON.stringify(card, null, 2));
+  } else {
+    res.writeHead(404);
+    res.end('Not Found');
+  }
+});
+
+server.listen(${port}, () => console.log('Agent card server on port ${port}'));
+`;
+    await runtime.writeFile("/tmp/agent-card-server.js", serverScript);
+    // Start server in background
+    await runtime.exec(`node /tmp/agent-card-server.js &`, 5000);
+    // Expose port
+    const portInfo = await runtime.exposePort(port);
+    return `${portInfo.publicUrl}/.well-known/agent-card.json`;
+}
+/**
+ * Write agent card to the state directory for git versioning.
+ */
+export async function saveAgentCard(card, runtime) {
+    const cardJson = serializeAgentCard(card);
+    const home = process.env.HOME || "/root";
+    await runtime.writeFile(`${home}/.automaton/agent-card.json`, cardJson);
+}
+//# sourceMappingURL=agent-card.js.map

package/dist/registry/agent-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../../src/registry/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,eAAe,GACnB,yDAAyD,CAAC;AAE5D;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA2B,EAC3B,MAAuB,EACvB,EAAqB;IAErB,MAAM,QAAQ,GAAmB;QAC/B;YACE,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,eAAe,QAAQ,CAAC,OAAO,EAAE;SAC5C;QACD;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,MAAM,CAAC,WAAW;SAC7B;KACF,CAAC;IAEF,oCAAoC;IACpC,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,WAAW,QAAQ,CAAC,SAAS,gBAAgB;SACxD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,WAAW,GAAG,0CAA0C,CAAC;IAC7D,WAAW,IAAI,aAAa,MAAM,CAAC,cAAc,GAAG,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,WAAW,IAAI,YAAY,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACrE,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,WAAW,IAAI,cAAc,QAAQ,CAAC,MAAM,GAAG,CAAC;IAClD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW;QACX,QAAQ;QACR,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,cAAc;KAC3D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAe,EACf,OAA2B,EAC3B,OAAe,IAAI;IAEnB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAE1C,+BAA+B;IAC/B,MAAM,YAAY,GAAG;;eAER,QAAQ;;;;;;;;;;;;gBAYP,IAAI,kDAAkD,IAAI;CACzE,CAAC;IAEA,MAAM,OAAO,CAAC,SAAS,CAAC,2BAA2B,EAAE,YAAY,CAAC,CAAC;IAEnE,6BAA6B;IAC7B,MAAM,OAAO,CAAC,IAAI,CAChB,kCAAkC,EAClC,IAAI,CACL,CAAC;IAEF,cAAc;IACd,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhD,OAAO,GAAG,QAAQ,CAAC,SAAS,8BAA8B,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAe,EACf,OAA2B;IAE3B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC;IACzC,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,6BAA6B,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/registry/discovery.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Agent Discovery
+ *
+ * Discover other agents via ERC-8004 registry queries.
+ * Fetch and parse agent cards from URIs.
+ */
+import type { DiscoveredAgent, AgentCard } from "../types.js";
+type Network = "mainnet" | "testnet";
+/**
+ * Discover agents by scanning the registry.
+ * Returns a list of discovered agents with their metadata.
+ */
+export declare function discoverAgents(limit?: number, network?: Network): Promise<DiscoveredAgent[]>;
+/**
+ * Fetch an agent card from a URI.
+ */
+export declare function fetchAgentCard(uri: string): Promise<AgentCard | null>;
+/**
+ * Search for agents by name or description.
+ * Scans recent registrations and filters by keyword.
+ */
+export declare function searchAgents(keyword: string, limit?: number, network?: Network): Promise<DiscoveredAgent[]>;
+export {};
+//# sourceMappingURL=discovery.d.ts.map

package/dist/registry/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/registry/discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACV,MAAM,aAAa,CAAC;AAGrB,KAAK,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAErC;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,GAAE,MAAW,EAClB,OAAO,GAAE,OAAmB,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CAwB5B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAuB3B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAW,EAClB,OAAO,GAAE,OAAmB,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CAY5B"}

package/dist/registry/discovery.js

@@ -0,0 +1,74 @@
+/**
+ * Agent Discovery
+ *
+ * Discover other agents via ERC-8004 registry queries.
+ * Fetch and parse agent cards from URIs.
+ */
+import { queryAgent, getTotalAgents } from "./erc8004.js";
+/**
+ * Discover agents by scanning the registry.
+ * Returns a list of discovered agents with their metadata.
+ */
+export async function discoverAgents(limit = 20, network = "mainnet") {
+    const total = await getTotalAgents(network);
+    const scanCount = Math.min(total, limit);
+    const agents = [];
+    // Scan from most recent to oldest
+    for (let i = total; i > total - scanCount && i > 0; i--) {
+        const agent = await queryAgent(i.toString(), network);
+        if (agent) {
+            // Try to fetch the agent card for additional metadata
+            try {
+                const card = await fetchAgentCard(agent.agentURI);
+                if (card) {
+                    agent.name = card.name;
+                    agent.description = card.description;
+                }
+            }
+            catch {
+                // Card fetch failed, use basic info
+            }
+            agents.push(agent);
+        }
+    }
+    return agents;
+}
+/**
+ * Fetch an agent card from a URI.
+ */
+export async function fetchAgentCard(uri) {
+    try {
+        // Handle IPFS URIs
+        let fetchUrl = uri;
+        if (uri.startsWith("ipfs://")) {
+            fetchUrl = `https://ipfs.io/ipfs/${uri.slice(7)}`;
+        }
+        const response = await fetch(fetchUrl, {
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!response.ok)
+            return null;
+        const card = (await response.json());
+        // Basic validation
+        if (!card.name || !card.type)
+            return null;
+        return card;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Search for agents by name or description.
+ * Scans recent registrations and filters by keyword.
+ */
+export async function searchAgents(keyword, limit = 10, network = "mainnet") {
+    const all = await discoverAgents(50, network);
+    const lower = keyword.toLowerCase();
+    return all
+        .filter((a) => a.name?.toLowerCase().includes(lower) ||
+        a.description?.toLowerCase().includes(lower) ||
+        a.owner.toLowerCase().includes(lower))
+        .slice(0, limit);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/registry/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/registry/discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAAE,EAClB,UAAmB,SAAS;IAE5B,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,kCAAkC;IAClC,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,GAAG,SAAS,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QACtD,IAAI,KAAK,EAAE,CAAC;YACV,sDAAsD;YACtD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAClD,IAAI,IAAI,EAAE,CAAC;oBACT,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;oBACvB,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;gBACvC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,oCAAoC;YACtC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW;IAEX,IAAI,CAAC;QACH,mBAAmB;QACnB,IAAI,QAAQ,GAAG,GAAG,CAAC;QACnB,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,QAAQ,GAAG,wBAAwB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAE9B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAc,CAAC;QAElD,mBAAmB;QACnB,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAE1C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,QAAgB,EAAE,EAClB,UAAmB,SAAS;IAE5B,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEpC,OAAO,GAAG;SACP,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrC,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC5C,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CACxC;SACA,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACrB,CAAC"}

package/dist/registry/erc8004.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ERC-8004 On-Chain Agent Registration
+ *
+ * Registers the automaton on-chain as a Trustless Agent via ERC-8004.
+ * Uses the Identity Registry on Base mainnet.
+ *
+ * Contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (Base)
+ * Reputation: 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 (Base)
+ */
+import { type Address, type PrivateKeyAccount } from "viem";
+import type { RegistryEntry, DiscoveredAgent, AutomatonDatabase } from "../types.js";
+type Network = "mainnet" | "testnet";
+/**
+ * Register the automaton on-chain with ERC-8004.
+ * Returns the agent ID (NFT token ID).
+ */
+export declare function registerAgent(account: PrivateKeyAccount, agentURI: string, network: Network | undefined, db: AutomatonDatabase): Promise<RegistryEntry>;
+/**
+ * Update the agent's URI on-chain.
+ */
+export declare function updateAgentURI(account: PrivateKeyAccount, agentId: string, newAgentURI: string, network: Network | undefined, db: AutomatonDatabase): Promise<string>;
+/**
+ * Leave reputation feedback for another agent.
+ */
+export declare function leaveFeedback(account: PrivateKeyAccount, agentId: string, score: number, comment: string, network: Network | undefined, db: AutomatonDatabase): Promise<string>;
+/**
+ * Query the registry for an agent by ID.
+ */
+export declare function queryAgent(agentId: string, network?: Network): Promise<DiscoveredAgent | null>;
+/**
+ * Get the total number of registered agents.
+ */
+export declare function getTotalAgents(network?: Network): Promise<number>;
+/**
+ * Check if an address has a registered agent.
+ */
+export declare function hasRegisteredAgent(address: Address, network?: Network): Promise<boolean>;
+export {};
+//# sourceMappingURL=erc8004.d.ts.map

package/dist/registry/erc8004.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc8004.d.ts","sourceRoot":"","sources":["../../src/registry/erc8004.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAML,KAAK,OAAO,EACZ,KAAK,iBAAiB,EACvB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EACV,aAAa,EAEb,eAAe,EACf,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAiCrB,KAAK,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAErC;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,YAAY,EAC5B,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,aAAa,CAAC,CAgDxB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,YAAY,EAC5B,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,YAAY,EAC5B,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAmB,GAC3B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiCjC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,OAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,OAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAoBlB"}

package/dist/registry/erc8004.js

@@ -0,0 +1,209 @@
+/**
+ * ERC-8004 On-Chain Agent Registration
+ *
+ * Registers the automaton on-chain as a Trustless Agent via ERC-8004.
+ * Uses the Identity Registry on Base mainnet.
+ *
+ * Contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (Base)
+ * Reputation: 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 (Base)
+ */
+import { createPublicClient, createWalletClient, http, parseAbi, } from "viem";
+import { base, baseSepolia } from "viem/chains";
+// ─── Contract Addresses ──────────────────────────────────────
+const CONTRACTS = {
+    mainnet: {
+        identity: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
+        reputation: "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
+        chain: base,
+    },
+    testnet: {
+        identity: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
+        reputation: "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
+        chain: baseSepolia,
+    },
+};
+// ─── ABI (minimal subset needed for registration) ────────────
+const IDENTITY_ABI = parseAbi([
+    "function register(string agentURI) external returns (uint256 agentId)",
+    "function updateAgentURI(uint256 agentId, string newAgentURI) external",
+    "function agentURI(uint256 agentId) external view returns (string)",
+    "function ownerOf(uint256 tokenId) external view returns (address)",
+    "function totalSupply() external view returns (uint256)",
+    "function balanceOf(address owner) external view returns (uint256)",
+]);
+const REPUTATION_ABI = parseAbi([
+    "function leaveFeedback(uint256 agentId, uint8 score, string comment) external",
+    "function getFeedback(uint256 agentId) external view returns (tuple(address from, uint8 score, string comment, uint256 timestamp)[])",
+]);
+/**
+ * Register the automaton on-chain with ERC-8004.
+ * Returns the agent ID (NFT token ID).
+ */
+export async function registerAgent(account, agentURI, network = "mainnet", db) {
+    const contracts = CONTRACTS[network];
+    const chain = contracts.chain;
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(),
+    });
+    const walletClient = createWalletClient({
+        account,
+        chain,
+        transport: http(),
+    });
+    // Call register(agentURI)
+    const hash = await walletClient.writeContract({
+        address: contracts.identity,
+        abi: IDENTITY_ABI,
+        functionName: "register",
+        args: [agentURI],
+    });
+    // Wait for transaction receipt
+    const receipt = await publicClient.waitForTransactionReceipt({ hash });
+    // Extract agentId from Transfer event logs
+    // The register function mints an ERC-721 token
+    let agentId = "0";
+    for (const log of receipt.logs) {
+        if (log.topics.length >= 4) {
+            // Transfer(address from, address to, uint256 tokenId)
+            agentId = BigInt(log.topics[3]).toString();
+            break;
+        }
+    }
+    const entry = {
+        agentId,
+        agentURI,
+        chain: `eip155:${chain.id}`,
+        contractAddress: contracts.identity,
+        txHash: hash,
+        registeredAt: new Date().toISOString(),
+    };
+    db.setRegistryEntry(entry);
+    return entry;
+}
+/**
+ * Update the agent's URI on-chain.
+ */
+export async function updateAgentURI(account, agentId, newAgentURI, network = "mainnet", db) {
+    const contracts = CONTRACTS[network];
+    const chain = contracts.chain;
+    const walletClient = createWalletClient({
+        account,
+        chain,
+        transport: http(),
+    });
+    const hash = await walletClient.writeContract({
+        address: contracts.identity,
+        abi: IDENTITY_ABI,
+        functionName: "updateAgentURI",
+        args: [BigInt(agentId), newAgentURI],
+    });
+    // Update in DB
+    const entry = db.getRegistryEntry();
+    if (entry) {
+        entry.agentURI = newAgentURI;
+        entry.txHash = hash;
+        db.setRegistryEntry(entry);
+    }
+    return hash;
+}
+/**
+ * Leave reputation feedback for another agent.
+ */
+export async function leaveFeedback(account, agentId, score, comment, network = "mainnet", db) {
+    const contracts = CONTRACTS[network];
+    const chain = contracts.chain;
+    const walletClient = createWalletClient({
+        account,
+        chain,
+        transport: http(),
+    });
+    const hash = await walletClient.writeContract({
+        address: contracts.reputation,
+        abi: REPUTATION_ABI,
+        functionName: "leaveFeedback",
+        args: [BigInt(agentId), score, comment],
+    });
+    return hash;
+}
+/**
+ * Query the registry for an agent by ID.
+ */
+export async function queryAgent(agentId, network = "mainnet") {
+    const contracts = CONTRACTS[network];
+    const chain = contracts.chain;
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(),
+    });
+    try {
+        const [uri, owner] = await Promise.all([
+            publicClient.readContract({
+                address: contracts.identity,
+                abi: IDENTITY_ABI,
+                functionName: "agentURI",
+                args: [BigInt(agentId)],
+            }),
+            publicClient.readContract({
+                address: contracts.identity,
+                abi: IDENTITY_ABI,
+                functionName: "ownerOf",
+                args: [BigInt(agentId)],
+            }),
+        ]);
+        return {
+            agentId,
+            owner: owner,
+            agentURI: uri,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the total number of registered agents.
+ */
+export async function getTotalAgents(network = "mainnet") {
+    const contracts = CONTRACTS[network];
+    const chain = contracts.chain;
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(),
+    });
+    try {
+        const supply = await publicClient.readContract({
+            address: contracts.identity,
+            abi: IDENTITY_ABI,
+            functionName: "totalSupply",
+        });
+        return Number(supply);
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Check if an address has a registered agent.
+ */
+export async function hasRegisteredAgent(address, network = "mainnet") {
+    const contracts = CONTRACTS[network];
+    const chain = contracts.chain;
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(),
+    });
+    try {
+        const balance = await publicClient.readContract({
+            address: contracts.identity,
+            abi: IDENTITY_ABI,
+            functionName: "balanceOf",
+            args: [address],
+        });
+        return Number(balance) > 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=erc8004.js.map

package/dist/registry/erc8004.js.map

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