@jinn-network/client 0.1.0 → 0.1.1-canary.4a6ed8b2

package/dist/mcp/operator-server.js.map

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

package/dist/operator-errors.js

@@ -2,6 +2,7 @@
  * User-facing error formatting for operators.
  * Full stack traces and raw RPC errors are reserved for JINN_DEBUG mode.
  */
+import { isUnauthorizedAccountError } from './errors/unauthorized-account.js';
 function envDebugTruthy(value) {
     if (value === undefined)
         return false;
@@ -51,6 +52,16 @@ function stringifyUnknown(error) {
 export function formatBootstrapOperatorMessage(error) {
     const msg = stringifyUnknown(error);
     const lower = msg.toLowerCase();
+    if (isUnauthorizedAccountError(msg) || msg.includes('curating-agent whitelist')) {
+        // Surfaces from `recoverEvictedService` when distributor.reStake reverts
+        // because the operator is not in mapCuratingAgents / mapManagingAgents on
+        // the stOLAS ExternalStakingDistributor. Keep the full actionable message
+        // so `setCuratingAgents` guidance isn't truncated by the 220-char cap.
+        return {
+            summary: msg.split('reStake revert:')[0]?.trim() ?? msg,
+            hint: 'The evicted service cannot self-heal without the distributor owner pre-authorising this operator. See the summary for the setCuratingAgents call, or abandon-and-rebootstrap.',
+        };
+    }
     if (msg.includes('GS013')) {
         return {
             summary: 'Gnosis Safe could not execute or estimate this transaction (GS013: inner call may have reverted or gas estimation failed).',

package/dist/operator-errors.js.map

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

package/dist/preflight/claude-auth.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Preflight: detect Claude auth context and probe authentication status.
+ *
+ * Three contexts are recognised:
+ *   - 'container'      — running inside a Docker container (/.dockerenv exists)
+ *   - 'docker-compose' — a docker-compose.yml with a jinn-daemon service lives in cwd
+ *   - 'bare'           — plain host environment (default)
+ *
+ * Priority:
+ *   1. JINN_RUNTIME_MODE env var (authoritative; CI/scripted operators)
+ *   2. `runtimeMode` field in the resolved config (persisted by `jinn auth`)
+ *   3. Filesystem heuristic (container → docker-compose → bare) as a last resort
+ *
+ * The filesystem path is a LAST RESORT because running from the `client/`
+ * checkout dir misdetects as docker-compose (the package's own compose file
+ * names `jinn-daemon`). Operators should set `runtimeMode` at `jinn auth`.
+ */
+export type AuthContext = 'container' | 'docker-compose' | 'bare';
+export interface DetectContextOptions {
+    cwd: string;
+    /** Optional explicit mode, typically from `config.runtimeMode`. Highest priority. */
+    configuredMode?: AuthContext;
+    /** Optional env (default: process.env). Tests can inject a stub. */
+    env?: NodeJS.ProcessEnv;
+    /** Override the /.dockerenv existence check (for testing). */
+    dockerenvExists?: boolean;
+    /** Override the docker-compose.yml jinn-daemon check (for testing). */
+    composeServiceExists?: boolean;
+}
+export interface SpawnResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+}
+export interface AuthProbeResult {
+    authenticated: boolean;
+    context: AuthContext;
+    detail: string;
+    email?: string;
+}
+export interface ProbeOptions {
+    context: AuthContext;
+    cwd: string;
+    /** Inject a pre-computed spawn result (for testing). */
+    spawnResult?: SpawnResult;
+}
+export interface LoginResult {
+    success: boolean;
+    detail: string;
+}
+/**
+ * Determine which environment Claude is running in.
+ * When `dockerenvExists` / `composeServiceExists` are omitted the function
+ * inspects the filesystem directly.
+ */
+export declare function detectAuthContext(opts: DetectContextOptions): AuthContext;
+/**
+ * Probe whether `claude` is authenticated in the given context.
+ * When `spawnResult` is provided (testing) no subprocess is created.
+ */
+export declare function probeClaudeAuth(opts: ProbeOptions): AuthProbeResult;
+/**
+ * Return the command + args needed to interactively log in to Claude.
+ */
+export declare function buildLoginCommand(context: AuthContext, cwd: string): {
+    command: string;
+    args: string[];
+};

package/dist/preflight/claude-auth.js

@@ -0,0 +1,171 @@
+/**
+ * Preflight: detect Claude auth context and probe authentication status.
+ *
+ * Three contexts are recognised:
+ *   - 'container'      — running inside a Docker container (/.dockerenv exists)
+ *   - 'docker-compose' — a docker-compose.yml with a jinn-daemon service lives in cwd
+ *   - 'bare'           — plain host environment (default)
+ *
+ * Priority:
+ *   1. JINN_RUNTIME_MODE env var (authoritative; CI/scripted operators)
+ *   2. `runtimeMode` field in the resolved config (persisted by `jinn auth`)
+ *   3. Filesystem heuristic (container → docker-compose → bare) as a last resort
+ *
+ * The filesystem path is a LAST RESORT because running from the `client/`
+ * checkout dir misdetects as docker-compose (the package's own compose file
+ * names `jinn-daemon`). Operators should set `runtimeMode` at `jinn auth`.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// detectAuthContext
+// ---------------------------------------------------------------------------
+/**
+ * Determine which environment Claude is running in.
+ * When `dockerenvExists` / `composeServiceExists` are omitted the function
+ * inspects the filesystem directly.
+ */
+export function detectAuthContext(opts) {
+    const { cwd } = opts;
+    const env = opts.env ?? process.env;
+    // 1. JINN_RUNTIME_MODE env var (CI / scripted operators).
+    const envMode = env['JINN_RUNTIME_MODE'];
+    if (envMode === 'bare' || envMode === 'docker-compose' || envMode === 'container') {
+        return envMode;
+    }
+    // 2. Explicit config (persisted by `jinn auth`).
+    if (opts.configuredMode) {
+        return opts.configuredMode;
+    }
+    // 3. Filesystem heuristic — last resort. Flawed inside the client/ checkout dir
+    // because the package's own docker-compose.yml names jinn-daemon. Prefer
+    // setting runtimeMode explicitly.
+    const inContainer = opts.dockerenvExists !== undefined
+        ? opts.dockerenvExists
+        : existsSync('/.dockerenv');
+    if (inContainer)
+        return 'container';
+    const hasComposeService = opts.composeServiceExists !== undefined
+        ? opts.composeServiceExists
+        : _composeHasJinnDaemon(cwd);
+    if (hasComposeService)
+        return 'docker-compose';
+    return 'bare';
+}
+function _composeHasJinnDaemon(cwd) {
+    const composePath = join(cwd, 'docker-compose.yml');
+    if (!existsSync(composePath))
+        return false;
+    try {
+        const content = readFileSync(composePath, 'utf8');
+        return content.includes('jinn-daemon');
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// probeClaudeAuth
+// ---------------------------------------------------------------------------
+/**
+ * Probe whether `claude` is authenticated in the given context.
+ * When `spawnResult` is provided (testing) no subprocess is created.
+ */
+export function probeClaudeAuth(opts) {
+    const { context, cwd } = opts;
+    const sr = opts.spawnResult ?? _spawnAuthStatus(context, cwd);
+    if (sr.status !== 0) {
+        return {
+            authenticated: false,
+            context,
+            detail: sr.stderr || 'claude auth status exited with non-zero status',
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(sr.stdout);
+    }
+    catch {
+        return {
+            authenticated: false,
+            context,
+            detail: 'claude auth status output is not valid JSON',
+        };
+    }
+    if (parsed === null ||
+        typeof parsed !== 'object' ||
+        !('loggedIn' in parsed) ||
+        parsed.loggedIn !== true) {
+        return { authenticated: false, context, detail: 'not logged in' };
+    }
+    const email = typeof parsed.email === 'string'
+        ? parsed.email
+        : undefined;
+    return {
+        authenticated: true,
+        context,
+        detail: email ? `logged in as ${email}` : 'logged in',
+        email,
+    };
+}
+function _spawnAuthStatus(context, cwd) {
+    let command;
+    let args;
+    if (context === 'docker-compose') {
+        command = 'docker';
+        args = [
+            'compose',
+            '-f',
+            join(cwd, 'docker-compose.yml'),
+            'run',
+            '--rm',
+            '-T',
+            '--no-deps',
+            '--entrypoint',
+            'claude',
+            'jinn-daemon',
+            'auth',
+            'status',
+        ];
+    }
+    else {
+        command = 'claude';
+        args = ['auth', 'status'];
+    }
+    const result = spawnSync(command, args, { encoding: 'utf8' });
+    return {
+        status: result.status,
+        stdout: result.stdout ?? '',
+        stderr: result.stderr ?? '',
+    };
+}
+// ---------------------------------------------------------------------------
+// buildLoginCommand
+// ---------------------------------------------------------------------------
+/**
+ * Return the command + args needed to interactively log in to Claude.
+ */
+export function buildLoginCommand(context, cwd) {
+    if (context === 'docker-compose') {
+        return {
+            command: 'docker',
+            args: [
+                'compose',
+                '-f',
+                join(cwd, 'docker-compose.yml'),
+                'run',
+                '--rm',
+                '-it',
+                '--no-deps',
+                '--entrypoint',
+                'claude',
+                'jinn-daemon',
+                'auth',
+                'login',
+            ],
+        };
+    }
+    return { command: 'claude', args: ['auth', 'login'] };
+}
+//# sourceMappingURL=claude-auth.js.map

package/dist/preflight/claude-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-auth.js","sourceRoot":"","sources":["../../src/preflight/claude-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA6CjC,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA0B;IAC1D,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAEpC,0DAA0D;IAC1D,MAAM,OAAO,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,gBAAgB,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAClF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iDAAiD;IACjD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,gFAAgF;IAChF,yEAAyE;IACzE,kCAAkC;IAClC,MAAM,WAAW,GACf,IAAI,CAAC,eAAe,KAAK,SAAS;QAChC,CAAC,CAAC,IAAI,CAAC,eAAe;QACtB,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAEhC,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,MAAM,iBAAiB,GACrB,IAAI,CAAC,oBAAoB,KAAK,SAAS;QACrC,CAAC,CAAC,IAAI,CAAC,oBAAoB;QAC3B,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAEjC,IAAI,iBAAiB;QAAE,OAAO,gBAAgB,CAAC;IAE/C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAW;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE9B,MAAM,EAAE,GAAgB,IAAI,CAAC,WAAW,IAAI,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE3E,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO;YACL,aAAa,EAAE,KAAK;YACpB,OAAO;YACP,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,gDAAgD;SACtE,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,aAAa,EAAE,KAAK;YACpB,OAAO;YACP,MAAM,EAAE,6CAA6C;SACtD,CAAC;IACJ,CAAC;IAED,IACE,MAAM,KAAK,IAAI;QACf,OAAO,MAAM,KAAK,QAAQ;QAC1B,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC;QACtB,MAAkC,CAAC,QAAQ,KAAK,IAAI,EACrD,CAAC;QACD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,KAAK,GACT,OAAQ,MAAkC,CAAC,KAAK,KAAK,QAAQ;QAC3D,CAAC,CAAG,MAAkC,CAAC,KAAgB;QACvD,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,OAAO;QACP,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW;QACrD,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAoB,EAAE,GAAW;IACzD,IAAI,OAAe,CAAC;IACpB,IAAI,IAAc,CAAC;IAEnB,IAAI,OAAO,KAAK,gBAAgB,EAAE,CAAC;QACjC,OAAO,GAAG,QAAQ,CAAC;QACnB,IAAI,GAAG;YACL,SAAS;YACT,IAAI;YACJ,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC;YAC/B,KAAK;YACL,MAAM;YACN,IAAI;YACJ,WAAW;YACX,cAAc;YACd,QAAQ;YACR,aAAa;YACb,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,QAAQ,CAAC;QACnB,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAoB,EACpB,GAAW;IAEX,IAAI,OAAO,KAAK,gBAAgB,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE;gBACJ,SAAS;gBACT,IAAI;gBACJ,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC;gBAC/B,KAAK;gBACL,MAAM;gBACN,KAAK;gBACL,WAAW;gBACX,cAAc;gBACd,QAAQ;gBACR,aAAa;gBACb,MAAM;gBACN,OAAO;aACR;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/dist/restorer/engine/canonical-json.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Canonical JSON serialisation — sorted keys, no whitespace.
+ *
+ * Used for manifest signing: produce a deterministic byte string that two
+ * independent parties can reproduce from the same object graph.
+ *
+ * Rules:
+ * - Object keys are sorted lexicographically (UTF-16 code-unit order, same as
+ *   Array.prototype.sort() on strings — matches JSON.stringify key insertion
+ *   order when we control insertion).
+ * - Arrays preserve element order.
+ * - Numbers: JS default toString (no special formatting).
+ * - null, boolean, string: standard JSON encoding.
+ * - undefined values in objects are dropped (same as JSON.stringify).
+ * - NaN and Infinity are not valid JSON; this function will produce "null" for
+ *   those values, matching JSON.stringify behaviour.
+ */
+export declare function canonicalJson(value: unknown): string;

package/dist/restorer/engine/canonical-json.js

@@ -0,0 +1,59 @@
+/**
+ * Canonical JSON serialisation — sorted keys, no whitespace.
+ *
+ * Used for manifest signing: produce a deterministic byte string that two
+ * independent parties can reproduce from the same object graph.
+ *
+ * Rules:
+ * - Object keys are sorted lexicographically (UTF-16 code-unit order, same as
+ *   Array.prototype.sort() on strings — matches JSON.stringify key insertion
+ *   order when we control insertion).
+ * - Arrays preserve element order.
+ * - Numbers: JS default toString (no special formatting).
+ * - null, boolean, string: standard JSON encoding.
+ * - undefined values in objects are dropped (same as JSON.stringify).
+ * - NaN and Infinity are not valid JSON; this function will produce "null" for
+ *   those values, matching JSON.stringify behaviour.
+ */
+export function canonicalJson(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'null';
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'number') {
+        // NaN / Infinity → null, matching JSON.stringify
+        if (!isFinite(value))
+            return 'null';
+        return String(value);
+    }
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        const items = value.map((v) => canonicalJson(v)).join(',');
+        return `[${items}]`;
+    }
+    if (typeof value === 'object') {
+        const obj = value;
+        const pairs = Object.keys(obj)
+            .sort()
+            .flatMap((key) => {
+            const v = obj[key];
+            if (v === undefined)
+                return []; // drop undefined (matches JSON.stringify)
+            return [`${JSON.stringify(key)}:${canonicalJson(v)}`];
+        });
+        return `{${pairs.join(',')}}`;
+    }
+    // Bigint: emit raw decimal digits WITHOUT quotes, matching RFC 8785 and other
+    // canonical-JSON libs. JSON.stringify would throw; converting through String()
+    // would produce a quoted "12345" instead of the unquoted integer 12345.
+    // We do NOT convert through Number() because bigints can exceed JS number precision.
+    if (typeof value === 'bigint')
+        return value.toString();
+    // Fallback: other exotic types — JSON.stringify would throw;
+    // we convert to string to avoid hard failures.
+    return JSON.stringify(String(value));
+}
+//# sourceMappingURL=canonical-json.js.map

package/dist/restorer/engine/canonical-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.js","sourceRoot":"","sources":["../../../src/restorer/engine/canonical-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,iDAAiD;QACjD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QACpC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,OAAO,IAAI,KAAK,GAAG,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aAC3B,IAAI,EAAE;aACN,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACf,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC,CAAC,0CAA0C;YAC1E,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QACL,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,CAAC;IACD,8EAA8E;IAC9E,+EAA+E;IAC/E,wEAAwE;IACxE,qFAAqF;IACrF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvD,6DAA6D;IAC7D,+CAA+C;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/restorer/engine/claim.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Two-layer claim orchestration for the restorer engine.
+ *
+ * §6.1, §9.1, §9.2 of spec/2026-04-17-portfolio-v0-design.md
+ *
+ * Layer 1: ClaimRegistry claim — Jinn's work-coordination contract.
+ * Layer 2: Marketplace priority claim — calls MechAdapter.claimRequest() to
+ *   register the priority-mech exclusivity window (300 s responseTimeout).
+ *
+ * The ClaimRegistry claimTTL is owner-configured per-deployment and is not
+ * passed by the client.
+ *
+ * Recovery:
+ *   On resume, ClaimRegistryClient.weAlreadyClaimed() is checked before any
+ *   on-chain write.  If we already hold the claim, the ClaimRegistry step is
+ *   skipped entirely.  The marketplace claim is re-attempted because it is
+ *   stateless from the engine's perspective (MechAdapter is idempotent there).
+ *
+ * Failure modes:
+ *   - ClaimRegistry claim fails → throw, no marketplace call, engine marks FAILED.
+ *   - Marketplace claim fails → release ClaimRegistry claim, throw.
+ */
+import type { ClaimRegistryClient } from '../../adapters/claim-registry/client.js';
+/**
+ * Minimal interface for the marketplace adapter's claim path.
+ * The full MechAdapter satisfies this; tests can inject a stub.
+ */
+export interface MarketplaceClaimer {
+    claimRequest(requestId: string): Promise<void>;
+}
+/**
+ * Parameters describing a single intent's timing window.
+ * Extracted from PersistedIntent for testability (no DB dependency).
+ */
+export interface ClaimWindow {
+    requestId: string;
+    /** Window start timestamp in ms (epoch). Used for graceful release decision. */
+    windowStartTs: number;
+}
+/** Result of a successful two-layer claim. */
+export interface ClaimResult {
+    /** True if the ClaimRegistry claim was freshly placed (false = pre-existing). */
+    registryClaimWasFresh: boolean;
+}
+/**
+ * Execute the two-layer claim for a single intent.
+ *
+ * // Claim ordering: ClaimRegistry FIRST (cheap coordination lock), marketplace SECOND.
+ * // Spec §6.1 lists them in opposite order but doesn't enforce sequencing — registry-first
+ * // is preferred because: (a) ClaimRegistry revert is fast and signals "another restorer
+ * // is on it" cleanly; (b) marketplace claim is more expensive (Safe tx + actual gas);
+ * // (c) we release ClaimRegistry on marketplace failure to avoid leaking a stale claim.
+ *
+ * @param claimWindow - Timing data for the intent (requestId, windowStartTs).
+ * @param registryClient - ClaimRegistryClient for the deployed ClaimRegistry contract.
+ * @param marketplaceClaimer - Adapter whose claimRequest() performs the marketplace claim.
+ * @returns ClaimResult on success.
+ * @throws If either layer cannot be claimed (after graceful cleanup).
+ */
+export declare function executeTwoLayerClaim(claimWindow: ClaimWindow, registryClient: ClaimRegistryClient, marketplaceClaimer: MarketplaceClaimer): Promise<ClaimResult>;
+/**
+ * Release the ClaimRegistry claim for an intent that was CLAIMED but whose
+ * work window has not yet started (windowStartTs not reached).
+ *
+ * Used during graceful engine shutdown. No-op if we don't hold the claim.
+ *
+ * @returns true if the claim was released, false if there was nothing to release.
+ */
+export declare function releaseClaimedNotStarted(claimWindow: ClaimWindow, registryClient: ClaimRegistryClient): Promise<boolean>;

package/dist/restorer/engine/claim.js

@@ -0,0 +1,104 @@
+/**
+ * Two-layer claim orchestration for the restorer engine.
+ *
+ * §6.1, §9.1, §9.2 of spec/2026-04-17-portfolio-v0-design.md
+ *
+ * Layer 1: ClaimRegistry claim — Jinn's work-coordination contract.
+ * Layer 2: Marketplace priority claim — calls MechAdapter.claimRequest() to
+ *   register the priority-mech exclusivity window (300 s responseTimeout).
+ *
+ * The ClaimRegistry claimTTL is owner-configured per-deployment and is not
+ * passed by the client.
+ *
+ * Recovery:
+ *   On resume, ClaimRegistryClient.weAlreadyClaimed() is checked before any
+ *   on-chain write.  If we already hold the claim, the ClaimRegistry step is
+ *   skipped entirely.  The marketplace claim is re-attempted because it is
+ *   stateless from the engine's perspective (MechAdapter is idempotent there).
+ *
+ * Failure modes:
+ *   - ClaimRegistry claim fails → throw, no marketplace call, engine marks FAILED.
+ *   - Marketplace claim fails → release ClaimRegistry claim, throw.
+ */
+// ── Two-layer claim ───────────────────────────────────────────────────────────
+/**
+ * Execute the two-layer claim for a single intent.
+ *
+ * // Claim ordering: ClaimRegistry FIRST (cheap coordination lock), marketplace SECOND.
+ * // Spec §6.1 lists them in opposite order but doesn't enforce sequencing — registry-first
+ * // is preferred because: (a) ClaimRegistry revert is fast and signals "another restorer
+ * // is on it" cleanly; (b) marketplace claim is more expensive (Safe tx + actual gas);
+ * // (c) we release ClaimRegistry on marketplace failure to avoid leaking a stale claim.
+ *
+ * @param claimWindow - Timing data for the intent (requestId, windowStartTs).
+ * @param registryClient - ClaimRegistryClient for the deployed ClaimRegistry contract.
+ * @param marketplaceClaimer - Adapter whose claimRequest() performs the marketplace claim.
+ * @returns ClaimResult on success.
+ * @throws If either layer cannot be claimed (after graceful cleanup).
+ */
+export async function executeTwoLayerClaim(claimWindow, registryClient, marketplaceClaimer) {
+    const requestIdHex = claimWindow.requestId;
+    // ── Layer 1: ClaimRegistry ────────────────────────────────────────────────
+    // Idempotency check: if we already hold the claim, skip the on-chain write.
+    const alreadyClaimed = await registryClient.weAlreadyClaimed(requestIdHex);
+    let registryClaimWasFresh = false;
+    if (!alreadyClaimed) {
+        const result = await registryClient.claimJob(requestIdHex);
+        if (!result.claimed) {
+            throw new Error(`[claim-orchestration] ClaimRegistry claim failed for ${claimWindow.requestId} — another operator may hold the claim`);
+        }
+        registryClaimWasFresh = true;
+    }
+    else {
+        console.log(`[claim-orchestration] ClaimRegistry: pre-existing claim found for ${claimWindow.requestId}, skipping re-claim`);
+    }
+    // ── Layer 2: Marketplace ──────────────────────────────────────────────────
+    try {
+        await marketplaceClaimer.claimRequest(claimWindow.requestId);
+    }
+    catch (marketplaceErr) {
+        // Marketplace claim failed — release the ClaimRegistry claim we just placed
+        // (only if we placed it fresh; pre-existing claims are not ours to release here)
+        // TODO(v0 trade-off): on the resume path (weAlreadyClaimed = true, registryClaimWasFresh = false)
+        // we do NOT release the ClaimRegistry claim here.  Releasing on a transient marketplace failure
+        // would forfeit our coordination lock and let a competing restorer take it.  The downside is that
+        // on a *persistent* failure the claim sits locked until TTL expiry (owner-configured per-deployment).
+        // Distinguishing transient vs. permanent failures is non-trivial; for v0 we accept the TTL wait.
+        // Future: inspect the marketplace error type and release only on permanent failures.
+        if (registryClaimWasFresh) {
+            try {
+                await registryClient.releaseClaim(requestIdHex);
+                console.log(`[claim-orchestration] released ClaimRegistry claim for ${claimWindow.requestId} after marketplace failure`);
+            }
+            catch (releaseErr) {
+                const releaseMsg = releaseErr instanceof Error ? releaseErr.message : String(releaseErr);
+                console.error(`[claim-orchestration] failed to release ClaimRegistry claim for ${claimWindow.requestId} after marketplace failure: ${releaseMsg}`);
+            }
+        }
+        throw marketplaceErr;
+    }
+    return { registryClaimWasFresh };
+}
+// ── Graceful release ──────────────────────────────────────────────────────────
+/**
+ * Release the ClaimRegistry claim for an intent that was CLAIMED but whose
+ * work window has not yet started (windowStartTs not reached).
+ *
+ * Used during graceful engine shutdown. No-op if we don't hold the claim.
+ *
+ * @returns true if the claim was released, false if there was nothing to release.
+ */
+export async function releaseClaimedNotStarted(claimWindow, registryClient) {
+    const requestIdHex = claimWindow.requestId;
+    // Only release if the work window hasn't started yet
+    if (Date.now() >= claimWindow.windowStartTs) {
+        console.log(`[claim-orchestration] NOT releasing claim for ${claimWindow.requestId} — window already started`);
+        return false;
+    }
+    const released = await registryClient.releaseClaim(requestIdHex);
+    if (released) {
+        console.log(`[claim-orchestration] released ClaimRegistry claim for ${claimWindow.requestId} (graceful shutdown, before window start)`);
+    }
+    return released;
+}
+//# sourceMappingURL=claim.js.map

package/dist/restorer/engine/claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.js","sourceRoot":"","sources":["../../../src/restorer/engine/claim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA+BH,iFAAiF;AAEjF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAwB,EACxB,cAAmC,EACnC,kBAAsC;IAEtC,MAAM,YAAY,GAAG,WAAW,CAAC,SAAgB,CAAC;IAElD,6EAA6E;IAE7E,4EAA4E;IAC5E,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3E,IAAI,qBAAqB,GAAG,KAAK,CAAC;IAElC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,wDAAwD,WAAW,CAAC,SAAS,wCAAwC,CACtH,CAAC;QACJ,CAAC;QACD,qBAAqB,GAAG,IAAI,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CACT,qEAAqE,WAAW,CAAC,SAAS,qBAAqB,CAChH,CAAC;IACJ,CAAC;IAED,6EAA6E;IAE7E,IAAI,CAAC;QACH,MAAM,kBAAkB,CAAC,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,cAAc,EAAE,CAAC;QACxB,4EAA4E;QAC5E,iFAAiF;QACjF,kGAAkG;QAClG,gGAAgG;QAChG,kGAAkG;QAClG,sGAAsG;QACtG,iGAAiG;QACjG,qFAAqF;QACrF,IAAI,qBAAqB,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,cAAc,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;gBAChD,OAAO,CAAC,GAAG,CACT,0DAA0D,WAAW,CAAC,SAAS,4BAA4B,CAC5G,CAAC;YACJ,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,MAAM,UAAU,GAAG,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACzF,OAAO,CAAC,KAAK,CACX,mEAAmE,WAAW,CAAC,SAAS,+BAA+B,UAAU,EAAE,CACpI,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,cAAc,CAAC;IACvB,CAAC;IAED,OAAO,EAAE,qBAAqB,EAAE,CAAC;AACnC,CAAC;AAED,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,WAAwB,EACxB,cAAmC;IAEnC,MAAM,YAAY,GAAG,WAAW,CAAC,SAAgB,CAAC;IAElD,qDAAqD;IACrD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,aAAa,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CACT,iDAAiD,WAAW,CAAC,SAAS,2BAA2B,CAClG,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACjE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CACT,0DAA0D,WAAW,CAAC,SAAS,2CAA2C,CAC3H,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/restorer/engine/delivery.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Restorer engine — mech delivery + JinnRouter.claimDelivery.
+ *
+ * §6.1 DELIVERING phase.
+ *
+ * Steps:
+ *   1. Encode manifest CID as bytes32 digest (cidToDigestHex).
+ *   2. Call mech.deliverToMarketplace(requestId, deliveryDigest) via the Safe.
+ *   3. Call JinnRouter.claimDelivery(requestId, evidenceHash) where evidenceHash
+ *      is the keccak256 hash of the signed manifest (from manifest assembly).
+ */
+import type { Hex, PublicClient, WalletClient, Address } from 'viem';
+export interface DeliveryDeps {
+    publicClient: PublicClient;
+    walletClient: WalletClient;
+    safeAddress: Address;
+    mechContractAddress: Address;
+    routerAddress: Address;
+    /** v1 or v2 claimDelivery encoding — matches chain config */
+    claimDeliveryVariant: 'v1' | 'v2';
+}
+/**
+ * Callback invoked after deliverToMarketplace lands on-chain but BEFORE
+ * claimDelivery is called. Callers use this to durably persist the tx hash so
+ * that a crash between the two steps can be recovered without re-submitting the
+ * deliver transaction.
+ */
+export type OnDeliveryTxLanded = (deliveryTxHash: Hex) => void | Promise<void>;
+export interface DeliveryResult {
+    deliveryTxHash: Hex;
+    claimTxHash: Hex;
+}
+/**
+ * Deliver the manifest to the marketplace and claim the delivery on JinnRouter.
+ *
+ * Crash-recovery safe: if `preExistingDeliveryTxHash` is provided, the
+ * deliverToMarketplace step is skipped entirely — the function resumes from
+ * the claimDelivery step only. This handles the case where the process crashed
+ * after deliver landed on-chain but before the COMPLETE transition was persisted.
+ *
+ * @param requestId                 The on-chain request ID (bytes32 hex).
+ * @param manifestCid               IPFS CID of the signed manifest.
+ * @param evidenceHash              keccak256 hash of the canonical manifest JSON
+ *   (from manifest assembly) — used as evidenceHash in claimDelivery V2.
+ * @param deps                      Viem clients + contract addresses.
+ * @param preExistingDeliveryTxHash If set, skip deliverToMarketplace and use
+ *   this as the deliveryTxHash in the result.
+ * @param onDeliveryTxLanded        Optional callback invoked after
+ *   deliverToMarketplace succeeds, before claimDelivery. Use this to persist the
+ *   tx hash so recovery can skip the deliver step on restart.
+ */
+export declare function deliverAndClaim(requestId: Hex, manifestCid: string, evidenceHash: Hex, deps: DeliveryDeps, preExistingDeliveryTxHash?: Hex, onDeliveryTxLanded?: OnDeliveryTxLanded): Promise<DeliveryResult>;