@jinn-network/client 0.1.5 → 0.1.6-canary.118cd4d0

package/dist/earning/types.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 export declare const StakingModeSchema: z.ZodEnum<["standard", "self-bond"]>;
 export type StakingMode = z.infer<typeof StakingModeSchema>;
+export declare const FleetStageSchema: z.ZodEnum<["none", "stage1", "stage1_and_2"]>;
+export type FleetStage = z.infer<typeof FleetStageSchema>;
 export declare const ServiceStepSchema: z.ZodEnum<["awaiting_stake", "service_created", "service_activated", "agents_registered", "service_deployed", "service_staked", "staked", "mech_deployed", "agent_registered", "safe_binding_pending", "complete"]>;
 export type ServiceStep = z.infer<typeof ServiceStepSchema>;
 export declare const OPERATIONAL_SERVICE_STEPS: Set<"awaiting_stake" | "service_created" | "service_activated" | "agents_registered" | "service_deployed" | "service_staked" | "staked" | "mech_deployed" | "agent_registered" | "safe_binding_pending" | "complete">;
@@ -21,6 +23,8 @@ export declare const ServiceStateSchema: z.ZodObject<{
     identity_registry_address: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     agent_registered_tx: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     safe_bound_to_agent: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
+    error_revert_reason: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    error_short_message: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
 }, "strip", z.ZodTypeAny, {
     error: string | null;
     index: number;
@@ -35,6 +39,8 @@ export declare const ServiceStateSchema: z.ZodObject<{
     identity_registry_address: string | null;
     agent_registered_tx: string | null;
     safe_bound_to_agent: boolean | null;
+    error_revert_reason: string | null;
+    error_short_message: string | null;
 }, {
     error: string | null;
     index: number;
@@ -49,6 +55,8 @@ export declare const ServiceStateSchema: z.ZodObject<{
     identity_registry_address?: string | null | undefined;
     agent_registered_tx?: string | null | undefined;
     safe_bound_to_agent?: boolean | null | undefined;
+    error_revert_reason?: string | null | undefined;
+    error_short_message?: string | null | undefined;
 }>;
 export type ServiceState = z.infer<typeof ServiceStateSchema>;
 export declare const FleetStateSchema: z.ZodObject<{
@@ -69,6 +77,8 @@ export declare const FleetStateSchema: z.ZodObject<{
         identity_registry_address: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         agent_registered_tx: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
         safe_bound_to_agent: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>;
+        error_revert_reason: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        error_short_message: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     }, "strip", z.ZodTypeAny, {
         error: string | null;
         index: number;
@@ -83,6 +93,8 @@ export declare const FleetStateSchema: z.ZodObject<{
         identity_registry_address: string | null;
         agent_registered_tx: string | null;
         safe_bound_to_agent: boolean | null;
+        error_revert_reason: string | null;
+        error_short_message: string | null;
     }, {
         error: string | null;
         index: number;
@@ -97,8 +109,14 @@ export declare const FleetStateSchema: z.ZodObject<{
         identity_registry_address?: string | null | undefined;
         agent_registered_tx?: string | null | undefined;
         safe_bound_to_agent?: boolean | null | undefined;
+        error_revert_reason?: string | null | undefined;
+        error_short_message?: string | null | undefined;
     }>, "many">;
     updated_at: z.ZodString;
+    fleet_agent_id: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    fleet_safe_address: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    fleet_identity_registry: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    fleet_stage: z.ZodDefault<z.ZodOptional<z.ZodEnum<["none", "stage1", "stage1_and_2"]>>>;
 }, "strip", z.ZodTypeAny, {
     chain: "base" | "base-sepolia";
     master_address: string | null;
@@ -117,8 +135,14 @@ export declare const FleetStateSchema: z.ZodObject<{
         identity_registry_address: string | null;
         agent_registered_tx: string | null;
         safe_bound_to_agent: boolean | null;
+        error_revert_reason: string | null;
+        error_short_message: string | null;
     }[];
     updated_at: string;
+    fleet_agent_id: string | null;
+    fleet_safe_address: string | null;
+    fleet_identity_registry: string | null;
+    fleet_stage: "none" | "stage1" | "stage1_and_2";
 }, {
     chain: "base" | "base-sepolia";
     master_address: string | null;
@@ -136,9 +160,15 @@ export declare const FleetStateSchema: z.ZodObject<{
         identity_registry_address?: string | null | undefined;
         agent_registered_tx?: string | null | undefined;
         safe_bound_to_agent?: boolean | null | undefined;
+        error_revert_reason?: string | null | undefined;
+        error_short_message?: string | null | undefined;
     }[];
     updated_at: string;
     staking_mode?: "standard" | "self-bond" | undefined;
+    fleet_agent_id?: string | null | undefined;
+    fleet_safe_address?: string | null | undefined;
+    fleet_identity_registry?: string | null | undefined;
+    fleet_stage?: "none" | "stage1" | "stage1_and_2" | undefined;
 }>;
 export type FleetState = z.infer<typeof FleetStateSchema>;
 export declare function createDefaultFleetState(chain?: 'base' | 'base-sepolia'): FleetState;

package/dist/earning/types.js

@@ -1,6 +1,17 @@
 import { z } from 'zod';
 // ── Staking mode ─────────────────────────────────────────────────────────────
 export const StakingModeSchema = z.enum(['standard', 'self-bond']);
+// ── Fleet bootstrap stage marker (nghf) ─────────────────────────────────────
+//
+// `none`         — fresh fleet; no identity provisioned yet.
+// `stage1`       — fleet-level identity is provisioned (Safe deployed, agentId
+//                  minted, setAgentWallet bound). Builder-only completion.
+// `stage1_and_2` — at least one service row has reached `complete` /
+//                  `safe_binding_pending`. Full operator completion.
+//
+// See docs/superpowers/specs/2026-05-13-plug-in-builder-entry-point-design.md §5.1
+// and docs/superpowers/specs/2026-05-14-nghf-staged-bootstrap-fit-findings.md.
+export const FleetStageSchema = z.enum(['none', 'stage1', 'stage1_and_2']);
 // ── Service step progression ─────────────────────────────────────────────────
 //
 // Standard (stOLAS) mode:
@@ -74,6 +85,13 @@ export const ServiceStateSchema = z.object({
     // Currently always `false` — wallet binding is deferred to jinn-mono-aev
     // (Safe ERC-1271 wrapping).
     safe_bound_to_agent: z.boolean().nullable().optional().default(false),
+    // Structured diagnostics for safe_binding_failed errors (jinn-mono-hjex.4).
+    // Optional — absent on state files written before this field was added.
+    // `error_revert_reason` is the decoded contract Error(string) payload or
+    // named custom error name; null when the revert had no reason data.
+    // `error_short_message` is the concise one-liner from viem's BaseError.
+    error_revert_reason: z.string().nullable().optional().default(null),
+    error_short_message: z.string().nullable().optional().default(null),
 });
 // ── Fleet state (top-level) ──────────────────────────────────────────────────
 export const FleetStateSchema = z.object({
@@ -82,6 +100,19 @@ export const FleetStateSchema = z.object({
     staking_mode: StakingModeSchema.default('standard'),
     services: z.array(ServiceStateSchema),
     updated_at: z.string(),
+    // ── Fleet-level Stage 1 identity (nghf) ─────────────────────────────────
+    //
+    // These four fields are added so a fleet can carry ERC-8004 identity
+    // independently of any service row, enabling builder-only (services: [])
+    // operation. Stage 1 always uses the self-bond Safe topology
+    // (deterministic prediction from the HD-index-1 agent EOA) regardless of
+    // the eventual staking mode — in standard mode, Stage 2 later creates a
+    // separate staking Safe via `distributor.stake()`, so dual-role operators
+    // end up with two Safes. See findings §8 (Option A).
+    fleet_agent_id: z.string().nullable().optional().default(null),
+    fleet_safe_address: z.string().nullable().optional().default(null),
+    fleet_identity_registry: z.string().nullable().optional().default(null),
+    fleet_stage: FleetStageSchema.optional().default('none'),
 });
 // ── Factories ────────────────────────────────────────────────────────────────
 export function createDefaultFleetState(chain = 'base') {
@@ -91,6 +122,10 @@ export function createDefaultFleetState(chain = 'base') {
         staking_mode: 'standard',
         services: [],
         updated_at: new Date().toISOString(),
+        fleet_agent_id: null,
+        fleet_safe_address: null,
+        fleet_identity_registry: null,
+        fleet_stage: 'none',
     };
 }
 export function createDefaultServiceState(index, agentAddress) {
@@ -108,6 +143,8 @@ export function createDefaultServiceState(index, agentAddress) {
         identity_registry_address: null,
         agent_registered_tx: null,
         safe_bound_to_agent: false,
+        error_revert_reason: null,
+        error_short_message: null,
     };
 }
 //# sourceMappingURL=types.js.map

package/dist/earning/types.js.map

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

package/dist/erc8004/abis.d.ts

@@ -70,6 +70,70 @@ export declare const PAYLOAD_TUPLE_V2: readonly [{
     readonly name: "modeFlag";
     readonly type: "uint8";
 }];
+/**
+ * Plug-in registry payload tuple (1pbc).
+ *
+ * Per `docs/superpowers/specs/2026-05-13-plug-in-builder-entry-point-design.md` §5.2,
+ * a published plug-in record is anchored on the existing
+ * `IdentityRegistry.setMetadata` surface under the key
+ * `plugin:<pluginCid>`, with the payload ABI-encoded against this tuple:
+ *
+ *   abi.encode(
+ *       uint8    version,        // = 1
+ *       string   pluginName,     // npm package name
+ *       string   pluginVersion,  // semver
+ *       bytes32  pluginSha256,   // digestDirectory output for the packed tarball
+ *       string[] supports,       // SolverType ids (e.g. ["swe-rebench-v2.v1"])
+ *       uint64   publishedAt     // unix seconds
+ *   )
+ *
+ * The textual `pluginCid` in the metadataKey is the IPFS CID of the packed
+ * tarball; it is the canonical primary key for the record. Builders publish
+ * a new CID per version (`plugin:<newCid>`).
+ */
+export declare const PLUGIN_PAYLOAD_TUPLE: readonly [{
+    readonly name: "version";
+    readonly type: "uint8";
+}, {
+    readonly name: "pluginName";
+    readonly type: "string";
+}, {
+    readonly name: "pluginVersion";
+    readonly type: "string";
+}, {
+    readonly name: "pluginSha256";
+    readonly type: "bytes32";
+}, {
+    readonly name: "supports";
+    readonly type: "string[]";
+}, {
+    readonly name: "publishedAt";
+    readonly type: "uint64";
+}];
+/**
+ * Plug-in revocation payload tuple (1pbc).
+ *
+ * Builders overwrite `plugin:<pluginCid>` with a `version=2` revoked-marker
+ * payload. The indexer treats the most-recent metadata value as authoritative
+ * (per spec §5.2 "Revocation"). The key stays the same so the primary-key
+ * stability across overwrites is preserved.
+ *
+ *   abi.encode(
+ *       uint8  version,  // = 2
+ *       bool   revoked,  // = true
+ *       string reason
+ *   )
+ */
+export declare const REVOCATION_PAYLOAD_TUPLE: readonly [{
+    readonly name: "version";
+    readonly type: "uint8";
+}, {
+    readonly name: "revoked";
+    readonly type: "bool";
+}, {
+    readonly name: "reason";
+    readonly type: "string";
+}];
 /** ERC-8004 IdentityRegistry — only the function the publisher calls. */
 export declare const IDENTITY_REGISTRY_SET_METADATA_ABI: readonly [{
     readonly type: "function";

package/dist/erc8004/abis.js

@@ -47,6 +47,54 @@ export const PAYLOAD_TUPLE_V2 = [
     { name: 'implName', type: 'string' },
     { name: 'modeFlag', type: 'uint8' },
 ];
+/**
+ * Plug-in registry payload tuple (1pbc).
+ *
+ * Per `docs/superpowers/specs/2026-05-13-plug-in-builder-entry-point-design.md` §5.2,
+ * a published plug-in record is anchored on the existing
+ * `IdentityRegistry.setMetadata` surface under the key
+ * `plugin:<pluginCid>`, with the payload ABI-encoded against this tuple:
+ *
+ *   abi.encode(
+ *       uint8    version,        // = 1
+ *       string   pluginName,     // npm package name
+ *       string   pluginVersion,  // semver
+ *       bytes32  pluginSha256,   // digestDirectory output for the packed tarball
+ *       string[] supports,       // SolverType ids (e.g. ["swe-rebench-v2.v1"])
+ *       uint64   publishedAt     // unix seconds
+ *   )
+ *
+ * The textual `pluginCid` in the metadataKey is the IPFS CID of the packed
+ * tarball; it is the canonical primary key for the record. Builders publish
+ * a new CID per version (`plugin:<newCid>`).
+ */
+export const PLUGIN_PAYLOAD_TUPLE = [
+    { name: 'version', type: 'uint8' },
+    { name: 'pluginName', type: 'string' },
+    { name: 'pluginVersion', type: 'string' },
+    { name: 'pluginSha256', type: 'bytes32' },
+    { name: 'supports', type: 'string[]' },
+    { name: 'publishedAt', type: 'uint64' },
+];
+/**
+ * Plug-in revocation payload tuple (1pbc).
+ *
+ * Builders overwrite `plugin:<pluginCid>` with a `version=2` revoked-marker
+ * payload. The indexer treats the most-recent metadata value as authoritative
+ * (per spec §5.2 "Revocation"). The key stays the same so the primary-key
+ * stability across overwrites is preserved.
+ *
+ *   abi.encode(
+ *       uint8  version,  // = 2
+ *       bool   revoked,  // = true
+ *       string reason
+ *   )
+ */
+export const REVOCATION_PAYLOAD_TUPLE = [
+    { name: 'version', type: 'uint8' },
+    { name: 'revoked', type: 'bool' },
+    { name: 'reason', type: 'string' },
+];
 /** ERC-8004 IdentityRegistry — only the function the publisher calls. */
 export const IDENTITY_REGISTRY_SET_METADATA_ABI = [
     {

package/dist/erc8004/abis.js.map

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

package/dist/erc8004/plugin-registry.d.ts

@@ -0,0 +1,102 @@
+/**
+ * ERC-8004 plug-in registry surface (jinn-mono-1pbc).
+ *
+ * Plug-in records are anchored on the existing `IdentityRegistry.setMetadata`
+ * write surface — there is NO new contract. The builder's agentId is the
+ * subject; the metadataKey is `plugin:<pluginCid>`; the value is ABI-encoded
+ * per the `PLUGIN_PAYLOAD_TUPLE` (or, for revocations, the
+ * `REVOCATION_PAYLOAD_TUPLE`) declared in `./abis.js`.
+ *
+ * This is a BUILDER action, not an operator action: it accrues against the
+ * fleet's Stage 1 identity Safe (`fleet_safe_address`), and never touches
+ * Stage 2 (OLAS service / staking) state. The CLI verb that wraps this
+ * publisher (`jinn solver-plugins publish`) lazily runs
+ * `FleetBootstrapper.ensureStage1(password)` before any chain write so a
+ * builder can complete the full publish flow without ever standing up a
+ * Stage 2 service.
+ *
+ * See `docs/superpowers/specs/2026-05-13-plug-in-builder-entry-point-design.md`
+ * §5.2 ("Plug-in registry = a new `kind=plugin` on `IdentityRegistry.setMetadata`")
+ * and §6.3 ("Plug-in publication: `jinn solver-plugins publish`").
+ */
+import { type Address, type Hex, type PublicClient, type WalletClient } from 'viem';
+/** Plug-in publication payload (spec §5.2). */
+export interface PluginPayload {
+    /** Schema version (= 1 for this kind). */
+    version: 1;
+    /** npm package name, e.g. "@builder/swe-skill". Non-empty. */
+    pluginName: string;
+    /** Semver, e.g. "0.1.0". Non-empty. */
+    pluginVersion: string;
+    /** 32-byte hex digest of the packed tarball (`digestDirectory` output). */
+    pluginSha256: Hex;
+    /** SolverType ids — must include at least one (e.g. "swe-rebench-v2.v1"). */
+    supports: string[];
+    /** Unix seconds. Must fit in uint64. */
+    publishedAt: number;
+}
+/** Plug-in revocation payload (spec §5.2 "Revocation"). */
+export interface RevocationPayload {
+    /** Schema version (= 2 for the revocation marker). */
+    version: 2;
+    /** Always `true` — a revocation cannot un-revoke; publish a new CID instead. */
+    revoked: true;
+    /** Non-empty human-readable reason (e.g. "security advisory CVE-2026-…"). */
+    reason: string;
+}
+export declare class PluginPayloadValidationError extends Error {
+    constructor(reason: string);
+}
+export declare function validatePluginPayload(payload: PluginPayload): PluginPayload;
+export declare function validateRevocationPayload(payload: RevocationPayload): RevocationPayload;
+export declare function encodePluginPayload(payload: PluginPayload): Hex;
+export declare function encodeRevocationPayload(payload: RevocationPayload): Hex;
+/**
+ * Canonical prefix for plug-in metadata keys on the IdentityRegistry.
+ * Duplicated as `PLUGIN_KEY_PREFIX` in packages/indexer/src/types.ts
+ * (cross-package imports are not wired in this codebase).
+ */
+export declare const PLUGIN_METADATA_KEY_PREFIX = "plugin:";
+/** Build `plugin:<cid>` per spec §5.2. Never strips, never normalises. */
+export declare function buildPluginMetadataKey(pluginCid: string): string;
+export interface PluginRegistryPublisherConfig {
+    identityRegistryAddress: Address;
+    /** Builder's ERC-8004 agentId (= `fleet_agent_id` from FleetState). */
+    builderAgentId: bigint;
+    /** Stage 1 fleet identity Safe (= `fleet_safe_address`). Required. */
+    safeAddress: Address;
+    publicClient: PublicClient;
+    walletClient: WalletClient;
+}
+export interface PublishPluginArgs {
+    pluginCid: string;
+    payload: PluginPayload;
+}
+export interface RevokePluginArgs {
+    pluginCid: string;
+    payload: RevocationPayload;
+}
+/**
+ * High-level publisher for plug-in records.
+ *
+ * Routes writes through the operator's Stage 1 identity Safe via
+ * `executeSafeTransaction`, mirroring `ReputationRegistryClient.sendWrite`'s
+ * Safe-routed path. We require `safeAddress` (no direct-EOA escape hatch) —
+ * the on-chain `msg.sender` must be the operator's canonical Stage 1 Safe
+ * for the metadata write to bind to the right agentId owner.
+ */
+export declare class PluginRegistryPublisher {
+    private readonly identityRegistryAddress;
+    private readonly builderAgentId;
+    private readonly safeAddress;
+    private readonly publicClient;
+    private readonly walletClient;
+    constructor(config: PluginRegistryPublisherConfig);
+    get agentId(): bigint;
+    get safe(): Address;
+    /** Publish a `plugin:<cid>` record. Returns the tx hash. */
+    publish(args: PublishPluginArgs): Promise<Hex>;
+    /** Overwrite a `plugin:<cid>` record with a revoked-marker payload. */
+    revoke(args: RevokePluginArgs): Promise<Hex>;
+    private _setMetadata;
+}

package/dist/erc8004/plugin-registry.js

@@ -0,0 +1,165 @@
+/**
+ * ERC-8004 plug-in registry surface (jinn-mono-1pbc).
+ *
+ * Plug-in records are anchored on the existing `IdentityRegistry.setMetadata`
+ * write surface — there is NO new contract. The builder's agentId is the
+ * subject; the metadataKey is `plugin:<pluginCid>`; the value is ABI-encoded
+ * per the `PLUGIN_PAYLOAD_TUPLE` (or, for revocations, the
+ * `REVOCATION_PAYLOAD_TUPLE`) declared in `./abis.js`.
+ *
+ * This is a BUILDER action, not an operator action: it accrues against the
+ * fleet's Stage 1 identity Safe (`fleet_safe_address`), and never touches
+ * Stage 2 (OLAS service / staking) state. The CLI verb that wraps this
+ * publisher (`jinn solver-plugins publish`) lazily runs
+ * `FleetBootstrapper.ensureStage1(password)` before any chain write so a
+ * builder can complete the full publish flow without ever standing up a
+ * Stage 2 service.
+ *
+ * See `docs/superpowers/specs/2026-05-13-plug-in-builder-entry-point-design.md`
+ * §5.2 ("Plug-in registry = a new `kind=plugin` on `IdentityRegistry.setMetadata`")
+ * and §6.3 ("Plug-in publication: `jinn solver-plugins publish`").
+ */
+import { encodeAbiParameters, encodeFunctionData, } from 'viem';
+import { executeSafeTransaction } from '../adapters/mech/safe.js';
+import { waitForTransactionReceiptWithRetry } from '../tx-retry.js';
+import { IDENTITY_REGISTRY_SET_METADATA_ABI, PLUGIN_PAYLOAD_TUPLE, REVOCATION_PAYLOAD_TUPLE, } from './abis.js';
+export class PluginPayloadValidationError extends Error {
+    constructor(reason) {
+        super(`plugin payload validation failed: ${reason}`);
+        this.name = 'PluginPayloadValidationError';
+    }
+}
+// ── Validators ───────────────────────────────────────────────────────────────
+const MAX_UINT64 = 0xffffffffffffffffn;
+export function validatePluginPayload(payload) {
+    if (payload.version !== 1) {
+        throw new PluginPayloadValidationError(`version must be 1, got ${payload.version}`);
+    }
+    if (typeof payload.pluginName !== 'string' || payload.pluginName.length === 0) {
+        throw new PluginPayloadValidationError('pluginName must be a non-empty string');
+    }
+    if (typeof payload.pluginVersion !== 'string' || payload.pluginVersion.length === 0) {
+        throw new PluginPayloadValidationError('pluginVersion must be a non-empty string');
+    }
+    if (!/^0x[0-9a-fA-F]{64}$/.test(payload.pluginSha256)) {
+        throw new PluginPayloadValidationError(`pluginSha256 must be 32-byte hex (0x + 64 hex chars)`);
+    }
+    if (!Array.isArray(payload.supports) || payload.supports.length === 0) {
+        throw new PluginPayloadValidationError('supports must be a non-empty string[]');
+    }
+    for (const s of payload.supports) {
+        if (typeof s !== 'string' || s.length === 0) {
+            throw new PluginPayloadValidationError('supports entries must be non-empty strings');
+        }
+    }
+    if (!Number.isInteger(payload.publishedAt) || payload.publishedAt < 0) {
+        throw new PluginPayloadValidationError(`publishedAt must be a non-negative integer; got ${payload.publishedAt}`);
+    }
+    if (BigInt(payload.publishedAt) > MAX_UINT64) {
+        throw new PluginPayloadValidationError(`publishedAt exceeds uint64 range; got ${payload.publishedAt}`);
+    }
+    return payload;
+}
+export function validateRevocationPayload(payload) {
+    if (payload.version !== 2) {
+        throw new PluginPayloadValidationError(`revocation version must be 2, got ${payload.version}`);
+    }
+    if (payload.revoked !== true) {
+        throw new PluginPayloadValidationError('revocation payloads must set revoked=true');
+    }
+    if (typeof payload.reason !== 'string' || payload.reason.length === 0) {
+        throw new PluginPayloadValidationError('revocation reason must be a non-empty string');
+    }
+    return payload;
+}
+// ── Encoders ─────────────────────────────────────────────────────────────────
+export function encodePluginPayload(payload) {
+    validatePluginPayload(payload);
+    return encodeAbiParameters(PLUGIN_PAYLOAD_TUPLE, [
+        payload.version,
+        payload.pluginName,
+        payload.pluginVersion,
+        payload.pluginSha256,
+        payload.supports,
+        BigInt(payload.publishedAt),
+    ]);
+}
+export function encodeRevocationPayload(payload) {
+    validateRevocationPayload(payload);
+    return encodeAbiParameters(REVOCATION_PAYLOAD_TUPLE, [
+        payload.version,
+        payload.revoked,
+        payload.reason,
+    ]);
+}
+// ── Metadata key ─────────────────────────────────────────────────────────────
+/**
+ * Canonical prefix for plug-in metadata keys on the IdentityRegistry.
+ * Duplicated as `PLUGIN_KEY_PREFIX` in packages/indexer/src/types.ts
+ * (cross-package imports are not wired in this codebase).
+ */
+export const PLUGIN_METADATA_KEY_PREFIX = 'plugin:';
+/** Build `plugin:<cid>` per spec §5.2. Never strips, never normalises. */
+export function buildPluginMetadataKey(pluginCid) {
+    if (typeof pluginCid !== 'string' || pluginCid.length === 0) {
+        throw new PluginPayloadValidationError('pluginCid must be a non-empty string');
+    }
+    return `${PLUGIN_METADATA_KEY_PREFIX}${pluginCid}`;
+}
+/**
+ * High-level publisher for plug-in records.
+ *
+ * Routes writes through the operator's Stage 1 identity Safe via
+ * `executeSafeTransaction`, mirroring `ReputationRegistryClient.sendWrite`'s
+ * Safe-routed path. We require `safeAddress` (no direct-EOA escape hatch) —
+ * the on-chain `msg.sender` must be the operator's canonical Stage 1 Safe
+ * for the metadata write to bind to the right agentId owner.
+ */
+export class PluginRegistryPublisher {
+    identityRegistryAddress;
+    builderAgentId;
+    safeAddress;
+    publicClient;
+    walletClient;
+    constructor(config) {
+        this.identityRegistryAddress = config.identityRegistryAddress;
+        this.builderAgentId = config.builderAgentId;
+        this.safeAddress = config.safeAddress;
+        this.publicClient = config.publicClient;
+        this.walletClient = config.walletClient;
+    }
+    get agentId() {
+        return this.builderAgentId;
+    }
+    get safe() {
+        return this.safeAddress;
+    }
+    /** Publish a `plugin:<cid>` record. Returns the tx hash. */
+    async publish(args) {
+        const metadataKey = buildPluginMetadataKey(args.pluginCid);
+        const metadataValue = encodePluginPayload(args.payload);
+        return this._setMetadata(metadataKey, metadataValue);
+    }
+    /** Overwrite a `plugin:<cid>` record with a revoked-marker payload. */
+    async revoke(args) {
+        const metadataKey = buildPluginMetadataKey(args.pluginCid);
+        const metadataValue = encodeRevocationPayload(args.payload);
+        return this._setMetadata(metadataKey, metadataValue);
+    }
+    async _setMetadata(metadataKey, metadataValue) {
+        const calldata = encodeFunctionData({
+            abi: IDENTITY_REGISTRY_SET_METADATA_ABI,
+            functionName: 'setMetadata',
+            args: [this.builderAgentId, metadataKey, metadataValue],
+        });
+        const txHash = await executeSafeTransaction(this.publicClient, this.walletClient, {
+            safeAddress: this.safeAddress,
+            to: this.identityRegistryAddress,
+            value: 0n,
+            data: calldata,
+        });
+        await waitForTransactionReceiptWithRetry(this.publicClient, txHash);
+        return txHash;
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/erc8004/plugin-registry.js.map

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

package/dist/events/types.d.ts

@@ -21,7 +21,7 @@ export declare const StructuredEventSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     message: string;
     id: string;
-    kind: "reward" | "error" | "log" | "fleet" | "intent" | "system";
+    kind: "reward" | "error" | "system" | "log" | "fleet" | "intent";
     schemaVersion: 1;
     ts: string;
     details?: Record<string, unknown> | undefined;
@@ -31,7 +31,7 @@ export declare const StructuredEventSchema: z.ZodObject<{
 }, {
     message: string;
     id: string;
-    kind: "reward" | "error" | "log" | "fleet" | "intent" | "system";
+    kind: "reward" | "error" | "system" | "log" | "fleet" | "intent";
     schemaVersion: 1;
     ts: string;
     details?: Record<string, unknown> | undefined;