@jinn-network/client 0.1.5 → 0.1.6-canary.0b4ff7f9

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":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GAKnB,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,kCAAkC,EAClC,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AA8BnB,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,MAAc;QACxB,KAAK,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,gFAAgF;AAEhF,MAAM,UAAU,GAAG,mBAAsB,CAAC;AAE1C,MAAM,UAAU,qBAAqB,CAAC,OAAsB;IAC1D,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,4BAA4B,CAAC,0BAA0B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,4BAA4B,CAAC,uCAAuC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,4BAA4B,CAAC,0CAA0C,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,4BAA4B,CACpC,sDAAsD,CACvD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,4BAA4B,CAAC,uCAAuC,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,4BAA4B,CAAC,4CAA4C,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,4BAA4B,CACpC,mDAAmD,OAAO,CAAC,WAAW,EAAE,CACzE,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,4BAA4B,CACpC,yCAAyC,OAAO,CAAC,WAAW,EAAE,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAA0B;IAClE,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,4BAA4B,CAAC,qCAAqC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,4BAA4B,CAAC,2CAA2C,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,4BAA4B,CAAC,8CAA8C,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,mBAAmB,CAAC,oBAAoB,EAAE;QAC/C,OAAO,CAAC,OAAO;QACf,OAAO,CAAC,UAAU;QAClB,OAAO,CAAC,aAAa;QACrB,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,QAAQ;QAChB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAA0B;IAChE,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,mBAAmB,CAAC,wBAAwB,EAAE;QACnD,OAAO,CAAC,OAAO;QACf,OAAO,CAAC,OAAO;QACf,OAAO,CAAC,MAAM;KACf,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AAEpD,0EAA0E;AAC1E,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,4BAA4B,CAAC,sCAAsC,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,GAAG,0BAA0B,GAAG,SAAS,EAAE,CAAC;AACrD,CAAC;AAwBD;;;;;;;;GAQG;AACH,MAAM,OAAO,uBAAuB;IACjB,uBAAuB,CAAU;IACjC,cAAc,CAAS;IACvB,WAAW,CAAU;IACrB,YAAY,CAAe;IAC3B,YAAY,CAAe;IAE5C,YAAY,MAAqC;QAC/C,IAAI,CAAC,uBAAuB,GAAG,MAAM,CAAC,uBAAuB,CAAC;QAC9D,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,OAAO,CAAC,IAAuB;QACnC,MAAM,WAAW,GAAG,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACvD,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,MAAM,CAAC,IAAsB;QACjC,MAAM,WAAW,GAAG,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACvD,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,WAAmB,EAAE,aAAkB;QAChE,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YAClC,GAAG,EAAE,kCAAkC;YACvC,YAAY,EAAE,aAAa;YAC3B,IAAI,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE,aAAa,CAAC;SACxD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE;YAChF,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,EAAE,EAAE,IAAI,CAAC,uBAAuB;YAChC,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,MAAM,kCAAkC,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACpE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/harnesses/engine/engine.js

@@ -818,6 +818,18 @@ export class TaskEngine {
                 console.warn(`[harness-engine] ${task.requestId}: failed to hydrate solutionOutputsJson: ${err instanceof Error ? err.message : err}`);
             }
         }
+        // jinn-mono-4tfq: SkippableError caught in RUNNING leaves a skip-marker
+        // Solution with no payload; short-circuit before envelope assembly.
+        // Runs BEFORE the deps guard — skipping needs nothing wired.
+        const earlyImplOutput = this.solutionOutputs.get(task.requestId);
+        const gatingClaim = earlyImplOutput?.gating;
+        if (gatingClaim?.['skipped'] === true) {
+            const reason = String(gatingClaim['reason'] ?? 'unknown');
+            const detail = String(earlyImplOutput?.informational?.['detail'] ?? '');
+            console.log(`[harness-engine] ${task.requestId}: PACKAGING short-circuited — impl was skipped (${reason})${detail ? `: ${detail}` : ''}`);
+            this.persistence.markFailed(task.requestId, `impl skipped: ${reason}${detail ? ` — ${detail}` : ''}`);
+            return;
+        }
         if (!this.packagingDeps || !this.envelopeDeps) {
             throw new NotImplementedError('pack');
         }
@@ -911,9 +923,9 @@ export class TaskEngine {
         // Record payload so validatePayload does not reject the output.
         const solverType = task.solverType ?? 'legacy.v0';
         // Derive role from Task.role. Evaluator tasks produce 'verdict' envelopes;
-        // all other tasks produce 'restoration' envelopes.
+        // all other tasks produce 'solution' envelopes.
         const isEvaluation = task.taskRole === 'evaluation';
-        const role = isEvaluation ? 'verdict' : 'restoration';
+        const role = isEvaluation ? 'verdict' : 'solution';
         let envelopePayload;
         if (isEvaluation) {
             // ── Verdict envelope payload ──────────────────────────────────────────────
@@ -926,7 +938,7 @@ export class TaskEngine {
             // with a wrong shape — validatePayload will catch schema mismatches.
             //
             // verificationOfRestoration: stubbed — Plan D will connect the real SDK.
-            // restorationEnvelope.sha256: placeholder — Plan D wires real sha256 derivation.
+            // solutionEnvelope.sha256: placeholder — Plan D wires real sha256 derivation.
             const verdictPayload = implOutput?.verdictPayload;
             if (!verdictPayload) {
                 throw new Error(`pack: evaluator impl for ${task.requestId} did not produce verdictPayload on Solution; ` +