@jinn-network/client 0.1.7 → 0.1.8-canary.09a3b2f6

package/dist/cli/commands/solver-plugins-feedback.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `jinn solver-plugins {endorse, warn, review, respond}` — write verbs that
+ * route ERC-8004 `ReputationRegistry` feedback writes against the agentId of
+ * the builder who published the plug-in. The builder's agentId is resolved
+ * from `DiscoveryAPI.listPluginPublications`; the on-chain body anchors the
+ * feedback to a specific plug-in via `manifestRef = "plugin:<cid>"` and
+ * `manifestHash = keccak256(manifestRef)`.
+ *
+ * The pipeline mirrors `publishHandler`'s shape:
+ *   1. resolveCliPassword (env > keystore-password file > prompt-fd)
+ *   2. loadConfig
+ *   3. discoveryApiFactory(config).listPluginPublications → builderAgentId
+ *   4. bootstrapper.ensureStage1(password) — lazy Stage 1 ensure
+ *   5. reputationClientFactory(...).giveFeedback(...) / .respondToFeedback(...)
+ *
+ * Outputs a single-line JSON envelope: `{ verb, txHash, pluginCid,
+ * targetAgentId, ... }`. Error codes match the publish surface convention:
+ * `keystore_missing`, `config_load_failed`, `ensure_stage1_failed`,
+ * `fleet_identity_missing`, `agentid_unresolvable`, `self_feedback_not_allowed`,
+ * `discovery_unavailable`, `publish_failed`.
+ */
+import { type Address, type Hex } from 'viem';
+import type { CommandContext } from '../command.js';
+import type { SolverPluginsDeps } from './solver-plugins.js';
+export interface EndorseOptions {
+    pluginCid: string;
+    score: number;
+    scoreDecimals: number;
+    tag1?: string;
+    tag2?: string;
+    configPath: string | undefined;
+}
+export interface WarnOptions {
+    pluginCid: string;
+    reason: string;
+    configPath: string | undefined;
+}
+export interface ReviewOptions {
+    pluginCid: string;
+    score: number;
+    scoreDecimals: number;
+    tag1?: string;
+    tag2?: string;
+    configPath: string | undefined;
+}
+export interface RespondOptions {
+    pluginCid: string;
+    feedbackIndex: bigint;
+    client: Address;
+    responseUri: string;
+    configPath: string | undefined;
+}
+export interface FeedbackPipelineCtx {
+    password: string;
+    config: ReturnType<SolverPluginsDeps['loadConfig']>;
+    builderAgentId: bigint;
+    safeAddress: Address;
+    reputationRegistryAddress: Address;
+    manifestRef: string;
+    manifestHash: Hex;
+}
+/**
+ * Shared prologue for every write verb (endorse / warn / review / respond /
+ * block): password → config → discovery row → Stage 1 ensure. Returns the
+ * materialised ids needed for the on-chain write, or null after writing an
+ * error envelope and calling ctx.exit.
+ */
+export declare function preparePipeline(ctx: CommandContext, pluginCid: string, configPath: string | undefined, deps: SolverPluginsDeps): Promise<FeedbackPipelineCtx | null>;
+export declare function warnHandler(ctx: CommandContext, opts: WarnOptions, deps: SolverPluginsDeps): Promise<void>;
+export declare function endorseHandler(ctx: CommandContext, opts: EndorseOptions, deps: SolverPluginsDeps): Promise<void>;
+export declare function reviewHandler(ctx: CommandContext, opts: ReviewOptions, deps: SolverPluginsDeps): Promise<void>;
+export declare function respondHandler(ctx: CommandContext, opts: RespondOptions, deps: SolverPluginsDeps): Promise<void>;

package/dist/cli/commands/solver-plugins-feedback.js

@@ -0,0 +1,262 @@
+/**
+ * `jinn solver-plugins {endorse, warn, review, respond}` — write verbs that
+ * route ERC-8004 `ReputationRegistry` feedback writes against the agentId of
+ * the builder who published the plug-in. The builder's agentId is resolved
+ * from `DiscoveryAPI.listPluginPublications`; the on-chain body anchors the
+ * feedback to a specific plug-in via `manifestRef = "plugin:<cid>"` and
+ * `manifestHash = keccak256(manifestRef)`.
+ *
+ * The pipeline mirrors `publishHandler`'s shape:
+ *   1. resolveCliPassword (env > keystore-password file > prompt-fd)
+ *   2. loadConfig
+ *   3. discoveryApiFactory(config).listPluginPublications → builderAgentId
+ *   4. bootstrapper.ensureStage1(password) — lazy Stage 1 ensure
+ *   5. reputationClientFactory(...).giveFeedback(...) / .respondToFeedback(...)
+ *
+ * Outputs a single-line JSON envelope: `{ verb, txHash, pluginCid,
+ * targetAgentId, ... }`. Error codes match the publish surface convention:
+ * `keystore_missing`, `config_load_failed`, `ensure_stage1_failed`,
+ * `fleet_identity_missing`, `agentid_unresolvable`, `self_feedback_not_allowed`,
+ * `discovery_unavailable`, `publish_failed`.
+ */
+import { getAddress, keccak256, toBytes } from 'viem';
+import { writeJson } from './solver-plugins.js';
+import { getReputationRegistryAddress } from '../../erc8004/addresses.js';
+import { DiscoveryUnavailableError } from '../../discovery/types.js';
+/**
+ * Shared prologue for every write verb (endorse / warn / review / respond /
+ * block): password → config → discovery row → Stage 1 ensure. Returns the
+ * materialised ids needed for the on-chain write, or null after writing an
+ * error envelope and calling ctx.exit.
+ */
+export async function preparePipeline(ctx, pluginCid, configPath, deps) {
+    const passwordResult = deps.resolveCliPassword(ctx.argv, ctx.env);
+    if (!passwordResult.ok) {
+        writeJson(ctx, {
+            error: {
+                code: 'keystore_missing',
+                message: 'Could not resolve password. Set JINN_PASSWORD, write ~/.jinn-client/keystore-password, or pass --password-fd.',
+            },
+        });
+        ctx.exit(1);
+        return null;
+    }
+    const password = passwordResult.password;
+    let config;
+    try {
+        config = deps.loadConfig(configPath);
+    }
+    catch (err) {
+        writeJson(ctx, {
+            error: { code: 'config_load_failed', message: err instanceof Error ? err.message : String(err) },
+        });
+        ctx.exit(1);
+        return null;
+    }
+    // Resolve builderAgentId via discovery first — cheaper to fail here than
+    // after Stage 1.
+    let builderAgentIdStr;
+    try {
+        const api = deps.discoveryApiFactory(config);
+        const rows = await api.listPluginPublications({});
+        const row = rows.find((r) => r.cid === pluginCid);
+        builderAgentIdStr = row?.builderAgentId;
+    }
+    catch (err) {
+        if (err instanceof DiscoveryUnavailableError) {
+            writeJson(ctx, {
+                error: {
+                    code: 'discovery_unavailable',
+                    message: `Indexer unavailable (mode=${config.discovery?.mode ?? 'onchain'}${config.discovery?.url ? `, url=${config.discovery.url}` : ''}): ${err.message}`,
+                },
+            });
+            ctx.exit(1);
+            return null;
+        }
+        throw err;
+    }
+    if (!builderAgentIdStr) {
+        writeJson(ctx, {
+            error: {
+                code: 'agentid_unresolvable',
+                message: `No plug-in publication record found for cid ${pluginCid} (discovery mode=${config.discovery?.mode ?? 'onchain'}).`,
+                details: { mode: config.discovery?.mode ?? 'onchain' },
+            },
+        });
+        ctx.exit(1);
+        return null;
+    }
+    const bootstrapper = deps.bootstrapperFactory(config);
+    const stage1 = await bootstrapper.ensureStage1(password);
+    if (!stage1.ok) {
+        writeJson(ctx, { error: { code: 'ensure_stage1_failed', message: stage1.message } });
+        ctx.exit(1);
+        return null;
+    }
+    const fleet = stage1.fleet_state;
+    if (!fleet.fleet_agent_id || !fleet.fleet_safe_address || !fleet.fleet_identity_registry) {
+        writeJson(ctx, {
+            error: {
+                code: 'fleet_identity_missing',
+                message: 'Stage 1 completed but fleet identity is empty.',
+            },
+        });
+        ctx.exit(1);
+        return null;
+    }
+    const chainId = config.network === 'testnet' ? 84532 : 8453;
+    const reputationRegistryAddress = getReputationRegistryAddress(chainId);
+    if (!reputationRegistryAddress) {
+        writeJson(ctx, {
+            error: {
+                code: 'config_load_failed',
+                message: `No ReputationRegistry address known for chainId ${chainId}.`,
+            },
+        });
+        ctx.exit(1);
+        return null;
+    }
+    const safeAddress = getAddress(fleet.fleet_safe_address);
+    const manifestRef = `plugin:${pluginCid}`;
+    const manifestHash = keccak256(toBytes(manifestRef));
+    return {
+        password,
+        config,
+        builderAgentId: BigInt(builderAgentIdStr),
+        safeAddress,
+        reputationRegistryAddress,
+        manifestRef,
+        manifestHash,
+    };
+}
+function emitWriteError(ctx, err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes('Self-feedback not allowed')) {
+        writeJson(ctx, {
+            error: {
+                code: 'self_feedback_not_allowed',
+                message: 'Reputation registry rejected feedback: caller is the agent owner. Use a different operator agent NFT, or skip endorsement for plug-ins you publish yourself.',
+            },
+        });
+        ctx.exit(1);
+        return;
+    }
+    writeJson(ctx, {
+        error: { code: 'publish_failed', message: msg },
+    });
+    ctx.exit(1);
+}
+// ── Verbs ────────────────────────────────────────────────────────────────────
+/**
+ * Shared body for any verb that submits a single `giveFeedback` after the
+ * preparePipeline prologue. The caller supplies the verb name (for the
+ * envelope) plus the on-chain args; this function emits the success envelope
+ * or maps the thrown error to a typed envelope.
+ */
+async function submitFeedbackAndEmit(ctx, prep, deps, verb, args, extraEnvelopeFields = {}) {
+    const client = deps.reputationClientFactory({
+        reputationRegistryAddress: prep.reputationRegistryAddress,
+        safeAddress: prep.safeAddress,
+        rpcUrl: prep.config.rpcUrl,
+        network: prep.config.network === 'testnet' ? 'base-sepolia' : 'base',
+        earningDir: prep.config.earningDir,
+        password: prep.password,
+    });
+    try {
+        const txHash = await client.giveFeedback({
+            harnessAgentId: prep.builderAgentId,
+            score: args.score,
+            scoreDecimals: args.scoreDecimals,
+            manifestRef: prep.manifestRef,
+            manifestHash: prep.manifestHash,
+            ...(args.tag1 ? { tag1: args.tag1 } : {}),
+            ...(args.tag2 ? { tag2: args.tag2 } : {}),
+        });
+        writeJson(ctx, {
+            verb,
+            txHash,
+            pluginCid: prep.manifestRef.slice('plugin:'.length),
+            targetAgentId: prep.builderAgentId.toString(),
+            score: args.score,
+            scoreDecimals: args.scoreDecimals,
+            reputationRegistry: prep.reputationRegistryAddress,
+            safeAddress: prep.safeAddress,
+            ...extraEnvelopeFields,
+        });
+    }
+    catch (err) {
+        emitWriteError(ctx, err);
+    }
+}
+export async function warnHandler(ctx, opts, deps) {
+    const prep = await preparePipeline(ctx, opts.pluginCid, opts.configPath, deps);
+    if (!prep)
+        return;
+    // The on-chain feedback layout exposes `tag1` (indexed; we use it as the
+    // verb's category — 'warning') and `tag2` (free-text). The design note
+    // referenced a "feedback URI" for the reason, but tag2 is the available
+    // free-text slot on giveFeedback — wire the reason there.
+    await submitFeedbackAndEmit(ctx, prep, deps, 'solver-plugins warn', { score: 50, scoreDecimals: 2, tag1: 'warning', tag2: opts.reason }, { reason: opts.reason });
+}
+export async function endorseHandler(ctx, opts, deps) {
+    const prep = await preparePipeline(ctx, opts.pluginCid, opts.configPath, deps);
+    if (!prep)
+        return;
+    await submitFeedbackAndEmit(ctx, prep, deps, 'solver-plugins endorse', {
+        score: opts.score,
+        scoreDecimals: opts.scoreDecimals,
+        ...(opts.tag1 ? { tag1: opts.tag1 } : {}),
+        ...(opts.tag2 ? { tag2: opts.tag2 } : {}),
+    });
+}
+export async function reviewHandler(ctx, opts, deps) {
+    const prep = await preparePipeline(ctx, opts.pluginCid, opts.configPath, deps);
+    if (!prep)
+        return;
+    await submitFeedbackAndEmit(ctx, prep, deps, 'solver-plugins review', {
+        score: opts.score,
+        scoreDecimals: opts.scoreDecimals,
+        ...(opts.tag1 ? { tag1: opts.tag1 } : {}),
+        ...(opts.tag2 ? { tag2: opts.tag2 } : {}),
+    });
+}
+export async function respondHandler(ctx, opts, deps) {
+    const prep = await preparePipeline(ctx, opts.pluginCid, opts.configPath, deps);
+    if (!prep)
+        return;
+    const client = deps.reputationClientFactory({
+        reputationRegistryAddress: prep.reputationRegistryAddress,
+        safeAddress: prep.safeAddress,
+        rpcUrl: prep.config.rpcUrl,
+        network: prep.config.network === 'testnet' ? 'base-sepolia' : 'base',
+        earningDir: prep.config.earningDir,
+        password: prep.password,
+    });
+    try {
+        const responseHash = keccak256(toBytes(opts.responseUri));
+        const txHash = await client.respondToFeedback({
+            feedbackId: {
+                agentId: prep.builderAgentId,
+                client: opts.client,
+                feedbackIndex: opts.feedbackIndex,
+            },
+            responseURI: opts.responseUri,
+            responseHash,
+        });
+        writeJson(ctx, {
+            verb: 'solver-plugins respond',
+            txHash,
+            pluginCid: opts.pluginCid,
+            targetAgentId: prep.builderAgentId.toString(),
+            feedbackIndex: opts.feedbackIndex.toString(),
+            client: opts.client,
+            responseURI: opts.responseUri,
+            reputationRegistry: prep.reputationRegistryAddress,
+            safeAddress: prep.safeAddress,
+        });
+    }
+    catch (err) {
+        emitWriteError(ctx, err);
+    }
+}
+//# sourceMappingURL=solver-plugins-feedback.js.map

package/dist/cli/commands/solver-plugins-feedback.js.map

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

package/dist/cli/commands/solver-plugins-read.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `jinn solver-plugins {list-feedback, discover, status}` — read verbs.
+ *
+ * None of the read verbs resolve the keystore password. They use the same
+ * `discoveryApiFactory` the daemon uses, plus a read-only
+ * `ReputationRegistryClient` (`password: undefined` → `walletClient`
+ * unbuilt → reads work, writes throw).
+ *
+ * Output envelopes mirror the write-verb convention (`verb` field +
+ * structured payload). Failure modes:
+ *   - `agentid_unresolvable` (list-feedback only — `status` reports
+ *     `{ status: 'not_published' }` instead, since "no record" is the
+ *     answer to a status read).
+ *   - `discovery_unavailable` (factory throws `DiscoveryUnavailableError`).
+ *   - `config_load_failed`.
+ */
+import type { Address } from 'viem';
+import type { CommandContext } from '../command.js';
+import type { SolverPluginsDeps } from './solver-plugins.js';
+export interface StatusOptions {
+    pluginCid: string;
+    configPath: string | undefined;
+}
+export interface DiscoverOptions {
+    solverType: string | undefined;
+    builderAgentId: string | undefined;
+    includeRevoked: boolean | undefined;
+    limit: number | undefined;
+    configPath: string | undefined;
+}
+export interface ListFeedbackOptions {
+    pluginCid: string;
+    client: Address | undefined;
+    includeRevoked: boolean;
+    configPath: string | undefined;
+}
+/**
+ * `discover` lists published plug-in rows directly from the indexer. The
+ * `PluginPublication` row already carries name/version/supports/builderAgentId,
+ * so no IPFS payload dereference is required — `ipfsFetch` is held on
+ * SolverPluginsDeps for symmetry / future use but this handler does not
+ * consume it (a plan refinement vs. the design note's "missing IPFS config"
+ * failure mode; that mode does not apply because the discovery row is
+ * self-describing).
+ */
+export declare function discoverHandler(ctx: CommandContext, opts: DiscoverOptions, deps: SolverPluginsDeps): Promise<void>;
+/**
+ * `status` composes the publication row (or the absence of one) with the
+ * read-only `ReputationRegistry.getSummary` and the operator-local
+ * `solverPlugins.blockedCids` flag. A missing publication is a valid answer
+ * (`{ status: 'not_published' }`, exit 0), not an error.
+ */
+export declare function statusHandler(ctx: CommandContext, opts: StatusOptions, deps: SolverPluginsDeps): Promise<void>;
+export declare function listFeedbackHandler(ctx: CommandContext, opts: ListFeedbackOptions, deps: SolverPluginsDeps): Promise<void>;

package/dist/cli/commands/solver-plugins-read.js

@@ -0,0 +1,259 @@
+/**
+ * `jinn solver-plugins {list-feedback, discover, status}` — read verbs.
+ *
+ * None of the read verbs resolve the keystore password. They use the same
+ * `discoveryApiFactory` the daemon uses, plus a read-only
+ * `ReputationRegistryClient` (`password: undefined` → `walletClient`
+ * unbuilt → reads work, writes throw).
+ *
+ * Output envelopes mirror the write-verb convention (`verb` field +
+ * structured payload). Failure modes:
+ *   - `agentid_unresolvable` (list-feedback only — `status` reports
+ *     `{ status: 'not_published' }` instead, since "no record" is the
+ *     answer to a status read).
+ *   - `discovery_unavailable` (factory throws `DiscoveryUnavailableError`).
+ *   - `config_load_failed`.
+ */
+import { writeJson } from './solver-plugins.js';
+import { getReputationRegistryAddress } from '../../erc8004/addresses.js';
+import { DiscoveryUnavailableError } from '../../discovery/types.js';
+/**
+ * Load the operator config, emitting a `config_load_failed` envelope and
+ * exiting on failure. Returns `null` only after `ctx.exit` has been called.
+ */
+function loadConfigOrEmit(ctx, configPath, deps) {
+    try {
+        return deps.loadConfig(configPath);
+    }
+    catch (err) {
+        writeJson(ctx, {
+            error: { code: 'config_load_failed', message: err instanceof Error ? err.message : String(err) },
+        });
+        ctx.exit(1);
+        return null;
+    }
+}
+function emitDiscoveryUnavailable(ctx, config, err) {
+    writeJson(ctx, {
+        error: {
+            code: 'discovery_unavailable',
+            message: `Indexer unavailable (mode=${config.discovery?.mode ?? 'onchain'}${config.discovery?.url ? `, url=${config.discovery.url}` : ''}): ${err.message}`,
+            details: {
+                mode: config.discovery?.mode ?? 'onchain',
+                ...(config.discovery?.url ? { url: config.discovery.url } : {}),
+            },
+        },
+    });
+    ctx.exit(1);
+}
+/**
+ * `discover` lists published plug-in rows directly from the indexer. The
+ * `PluginPublication` row already carries name/version/supports/builderAgentId,
+ * so no IPFS payload dereference is required — `ipfsFetch` is held on
+ * SolverPluginsDeps for symmetry / future use but this handler does not
+ * consume it (a plan refinement vs. the design note's "missing IPFS config"
+ * failure mode; that mode does not apply because the discovery row is
+ * self-describing).
+ */
+export async function discoverHandler(ctx, opts, deps) {
+    const config = loadConfigOrEmit(ctx, opts.configPath, deps);
+    if (!config)
+        return;
+    try {
+        const api = deps.discoveryApiFactory(config);
+        const plugins = await api.listPluginPublications({
+            ...(opts.solverType ? { solverType: opts.solverType } : {}),
+            ...(opts.builderAgentId ? { builderAgentId: opts.builderAgentId } : {}),
+            ...(opts.includeRevoked !== undefined ? { includeRevoked: opts.includeRevoked } : {}),
+            ...(opts.limit !== undefined ? { limit: opts.limit } : {}),
+        });
+        writeJson(ctx, {
+            verb: 'solver-plugins discover',
+            plugins: plugins.map((p) => ({
+                cid: p.cid,
+                builderAgentId: p.builderAgentId,
+                name: p.name,
+                version: p.version,
+                supports: p.supports,
+                publishedAt: p.publishedAt,
+                revoked: p.revoked,
+                ...(p.revokedReason ? { revokedReason: p.revokedReason } : {}),
+                pluginSha256: p.pluginSha256,
+            })),
+        });
+    }
+    catch (err) {
+        if (err instanceof DiscoveryUnavailableError) {
+            emitDiscoveryUnavailable(ctx, config, err);
+            return;
+        }
+        throw err;
+    }
+}
+/**
+ * `status` composes the publication row (or the absence of one) with the
+ * read-only `ReputationRegistry.getSummary` and the operator-local
+ * `solverPlugins.blockedCids` flag. A missing publication is a valid answer
+ * (`{ status: 'not_published' }`, exit 0), not an error.
+ */
+export async function statusHandler(ctx, opts, deps) {
+    const config = loadConfigOrEmit(ctx, opts.configPath, deps);
+    if (!config)
+        return;
+    const locallyBlocked = config.solverPlugins?.blockedCids?.includes(opts.pluginCid) ?? false;
+    let row;
+    try {
+        const api = deps.discoveryApiFactory(config);
+        const rows = await api.listPluginPublications({});
+        row = rows.find((r) => r.cid === opts.pluginCid);
+    }
+    catch (err) {
+        if (err instanceof DiscoveryUnavailableError) {
+            emitDiscoveryUnavailable(ctx, config, err);
+            return;
+        }
+        throw err;
+    }
+    if (!row) {
+        writeJson(ctx, {
+            verb: 'solver-plugins status',
+            pluginCid: opts.pluginCid,
+            status: 'not_published',
+            locallyBlocked,
+        });
+        return;
+    }
+    if (row.revoked) {
+        writeJson(ctx, {
+            verb: 'solver-plugins status',
+            pluginCid: opts.pluginCid,
+            status: 'revoked',
+            publication: {
+                cid: row.cid,
+                builderAgentId: row.builderAgentId,
+                name: row.name,
+                version: row.version,
+                supports: row.supports,
+                publishedAt: row.publishedAt,
+                pluginSha256: row.pluginSha256,
+            },
+            ...(row.revokedReason ? { revokedReason: row.revokedReason } : {}),
+            locallyBlocked,
+        });
+        return;
+    }
+    // Active publication: also try to summarise reputation. Empty client list →
+    // no summary (getSummary reverts on empty input by design).
+    const chainId = config.network === 'testnet' ? 84532 : 8453;
+    const reputationRegistryAddress = getReputationRegistryAddress(chainId);
+    let summarySerialised = null;
+    if (reputationRegistryAddress) {
+        const client = deps.reputationClientFactory({
+            reputationRegistryAddress,
+            safeAddress: undefined,
+            rpcUrl: config.rpcUrl,
+            network: config.network === 'testnet' ? 'base-sepolia' : 'base',
+            earningDir: config.earningDir,
+            password: undefined,
+        });
+        const builderAgentId = BigInt(row.builderAgentId);
+        const clients = await client.getClients(builderAgentId);
+        if (clients.length > 0) {
+            const summary = await client.getSummary(builderAgentId, { clientAddresses: clients });
+            summarySerialised = {
+                count: summary.count.toString(),
+                summaryValue: summary.summaryValue.toString(),
+                summaryValueDecimals: summary.summaryValueDecimals,
+            };
+        }
+    }
+    writeJson(ctx, {
+        verb: 'solver-plugins status',
+        pluginCid: opts.pluginCid,
+        status: 'published',
+        publication: {
+            cid: row.cid,
+            builderAgentId: row.builderAgentId,
+            name: row.name,
+            version: row.version,
+            supports: row.supports,
+            publishedAt: row.publishedAt,
+            pluginSha256: row.pluginSha256,
+        },
+        summary: summarySerialised,
+        locallyBlocked,
+    });
+}
+export async function listFeedbackHandler(ctx, opts, deps) {
+    const config = loadConfigOrEmit(ctx, opts.configPath, deps);
+    if (!config)
+        return;
+    let builderAgentIdStr;
+    try {
+        const api = deps.discoveryApiFactory(config);
+        const rows = await api.listPluginPublications({});
+        builderAgentIdStr = rows.find((r) => r.cid === opts.pluginCid)?.builderAgentId;
+    }
+    catch (err) {
+        if (err instanceof DiscoveryUnavailableError) {
+            emitDiscoveryUnavailable(ctx, config, err);
+            return;
+        }
+        throw err;
+    }
+    if (!builderAgentIdStr) {
+        writeJson(ctx, {
+            error: {
+                code: 'agentid_unresolvable',
+                message: `No plug-in publication record found for cid ${opts.pluginCid} (discovery mode=${config.discovery?.mode ?? 'onchain'}).`,
+                details: { mode: config.discovery?.mode ?? 'onchain' },
+            },
+        });
+        ctx.exit(1);
+        return;
+    }
+    const chainId = config.network === 'testnet' ? 84532 : 8453;
+    const reputationRegistryAddress = getReputationRegistryAddress(chainId);
+    if (!reputationRegistryAddress) {
+        writeJson(ctx, {
+            error: {
+                code: 'config_load_failed',
+                message: `No ReputationRegistry address known for chainId ${chainId}.`,
+            },
+        });
+        ctx.exit(1);
+        return;
+    }
+    // Read-only client — no Safe needed (Safe routing is for writes).
+    const client = deps.reputationClientFactory({
+        reputationRegistryAddress,
+        safeAddress: undefined,
+        rpcUrl: config.rpcUrl,
+        network: config.network === 'testnet' ? 'base-sepolia' : 'base',
+        earningDir: config.earningDir,
+        password: undefined,
+    });
+    const builderAgentId = BigInt(builderAgentIdStr);
+    const records = await client.readAllFeedback(builderAgentId, {
+        ...(opts.client ? { clientAddresses: [opts.client] } : {}),
+        includeRevoked: opts.includeRevoked,
+    });
+    // Marshal BigInts to strings for JSON-safe output.
+    const serialised = records.map((r) => ({
+        agentId: r.agentId.toString(),
+        client: r.client,
+        feedbackIndex: r.feedbackIndex.toString(),
+        score: r.score.toString(),
+        scoreDecimals: r.scoreDecimals,
+        tag1: r.tag1,
+        tag2: r.tag2,
+        revoked: r.revoked,
+    }));
+    writeJson(ctx, {
+        verb: 'solver-plugins list-feedback',
+        pluginCid: opts.pluginCid,
+        targetAgentId: builderAgentIdStr,
+        records: serialised,
+    });
+}
+//# sourceMappingURL=solver-plugins-read.js.map