@jinn-network/client 0.1.8 → 0.1.9-canary.023faefb

package/plugins/local-trace-distiller/skills/distill/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: distill
+description: Use local trace tools to derive experimental skills from private session traces. Trigger on /distill, "distill this", "distill all", or requests to turn repeated local work into a reusable skill.
+tools: distill_trace_search, distill_trace_read, distill_trace_cluster, distill_local, distill_feedback_record
+---
+
+# Local Trace Distill
+
+Use this skill to help the user turn local work traces into experimental skills using the existing Jinn distillation methodology.
+
+## Arguments
+
+- No argument means `this`: focus on the current or most recent session.
+- `this`, `current`, or `recent`: inspect the most recent local trace cards, choose the best match for the current session, then distill only that trace unless the user chooses a broader set.
+- `all`: run a capped, cheap scan over local trace cards, cluster recurring signals, present candidates, and ask the user which candidate to distill.
+- A trace id, session id, or candidate trace list: inspect those traces and distill only the selected traces.
+
+## Tool Workflow
+
+1. Start with `distill_trace_search`, using compact cards. Do not read full transcripts first.
+2. For `all`, call `distill_trace_cluster` with a conservative cap. Default to `limit: 50` unless the user requested a different cap.
+3. Read only what is needed:
+   - Use `mode: "summary"` for orientation.
+   - Use `mode: "tool_calls"` to understand commands and edits.
+   - Use `mode: "transcript_excerpt"` with a query when one section matters.
+   - Use `mode: "full_transcript"` only when the skill cannot be safely derived from smaller reads, and set `allowFullTranscript: true` only after deciding it is necessary.
+4. Before calling `distill_local`, summarize the proposed source traces and the likely skill opportunity in one short paragraph.
+5. Call `distill_local` with `confirm: true` only after the user explicitly approves the run or has already requested an execution form such as "distill this now".
+6. Pass selected `traceIds` or `sessionIds` whenever the user chose a candidate. Avoid distilling every capture unless the user asked for `all` and then approved that broad run.
+
+## Distillation Methodology
+
+Reuse the existing Jinn distillation methodology rather than inventing a new prompt:
+
+- Prefer evaluator/user-accepted successful traces for success patterns.
+- Use failed or abandoned traces only for concrete lessons and failure avoidances.
+- Keep the skill grounded in repeated evidence when available; label single-trace outputs as experimental.
+- Preserve provenance through the generated skill metadata.
+- Run through the existing scrub, contamination, structure, and package gates via `distill_local`.
+
+## User Feedback Loop
+
+Generated skills are experimental. After a later session uses one, ask the user whether it helped, hurt, was mixed, or went unused. If the user gives feedback, call `distill_feedback_record` with the skill name, verdict, session id if known, and only user-approved notes or accepted changes. Convert accepted feedback into a targeted skill improvement instead of accumulating broad notes.
+
+## Future Marketplace
+
+Do not list local skills publicly in this version. Later versions may let users publish useful skills to a marketplace for others to use and pay for, but that requires explicit user approval and a separate publish flow.
+
+## Privacy
+
+Local traces are private by default. Do not export trace content or generated skills to a remote marketplace or shared corpus unless the user explicitly asks for that future publish flow.

package/plugins/swe-rebench-v2-runtime/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start\"",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/swe-rebench-v2-runtime/hooks/session-start

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+# swe-rebench-v2-runtime session-start hook.
+#
+# Deterministically materialises the task repository at `$WORKING_DIR/repo` at
+# `base_commit` BEFORE the solver agent runs, so the agent never has to set it
+# up itself. A direct-solving model (no steer hook, or one that skips the
+# task SKILL) otherwise improvises `git clone … ; git checkout <SHA>` — which
+# fails when `base_commit` is off the default branch, gets permission-gated as a
+# compound command, or conflicts with the provisioned working dir — producing an
+# unscorable run. This hook does what the task SKILL documents, deterministically.
+#
+# Inputs (env, set by the harness adapter):
+#   WORKING_DIR / JINN_WORKING_DIR — the episode working dir (holds task.json)
+# Reads `spec.repo` + `spec.base_commit` from `$WORKING_DIR/task.json`
+# (written by the harness's provisionWorkingDir).
+#
+# Contract: idempotent (provisions only when `$WORKING_DIR/repo/.git` is absent —
+# never clobbers an existing checkout or agent edits); best-effort (logs to
+# STDERR and exits 0 even on failure, so the agent can fall back to the task
+# SKILL); emits NOTHING on STDOUT (Claude Code parses a SessionStart hook's
+# stdout as hookSpecificOutput JSON — stray output would break that parse).
+set -uo pipefail
+
+WD="${WORKING_DIR:-${JINN_WORKING_DIR:-$PWD}}"
+TASK_JSON="$WD/task.json"
+log() { echo "swe-rebench-v2-runtime session-start: $*" >&2; }
+
+[[ -f "$TASK_JSON" ]] || { log "no task.json at $WD — skip (not a harness episode)"; exit 0; }
+
+# Extract spec.repo + spec.base_commit. shlex.quote keeps the eval injection-safe.
+REPO=""
+BASE=""
+eval "$(python3 - "$TASK_JSON" <<'PY' 2>/dev/null || true
+import json, sys, shlex
+try:
+    spec = (json.load(open(sys.argv[1])) or {}).get("spec") or {}
+except Exception:
+    sys.exit(0)
+print("REPO=" + shlex.quote(spec.get("repo") or ""))
+print("BASE=" + shlex.quote(spec.get("base_commit") or ""))
+PY
+)"
+
+[[ -n "$REPO" && -n "$BASE" ]] || { log "task.json has no spec.repo/base_commit — skip (not a swe-rebench-v2 task)"; exit 0; }
+
+REPO_DIR="$WD/repo"
+if [[ -d "$REPO_DIR/.git" ]]; then
+  log "repo already present at $REPO_DIR — skip (idempotent)"
+  exit 0
+fi
+
+log "materialising $REPO @ $BASE into $REPO_DIR"
+rm -rf "$REPO_DIR"
+mkdir -p "$REPO_DIR"
+# Fetch the exact SHA (base_commit is frequently off the default branch, so a
+# plain clone+checkout fails). git serves any commit by id via fetch.
+if ! (
+  cd "$REPO_DIR" &&
+  git init --quiet --initial-branch=main &&
+  git remote add origin "https://github.com/${REPO}.git" &&
+  git fetch --depth 1 --quiet origin "$BASE" &&
+  git checkout --quiet FETCH_HEAD
+); then
+  log "WARNING: provisioning failed for $REPO @ $BASE — agent will fall back to the task SKILL"
+  exit 0
+fi
+
+HEAD_SHA="$(git -C "$REPO_DIR" rev-parse HEAD 2>/dev/null || echo unknown)"
+if [[ "$HEAD_SHA" == "$BASE" ]]; then
+  log "repo ready at $BASE"
+else
+  log "WARNING: HEAD=$HEAD_SHA != base_commit=$BASE"
+fi
+exit 0

package/deployments/deployment-jinn-mvi-l1-sepolia-fast.json

@@ -1,55 +0,0 @@
-{
-  "network": "sepolia",
-  "chainId": 11155111,
-  "deployer": "0x15e78734481bD31F6e183dad05225505a45ACd07",
-  "deployedAt": "2026-04-29T12:14:01.626Z",
-  "config": {
-    "timingProfile": "fast-test",
-    "votingDelaySeconds": 60,
-    "votingPeriodSeconds": 600,
-    "proposalThreshold": "0",
-    "quorumNumerator": 4,
-    "timelockMinDelaySeconds": 60
-  },
-  "distributor": {
-    "operatorRatio": "750000000000000000",
-    "daoRatio": "250000000000000000",
-    "wCreation": "1",
-    "wRestorationDelivery": "1",
-    "wEvaluationDelivery": "1"
-  },
-  "messenger": {
-    "mode": "mock",
-    "address": "0xd229A2C20333B747675090Ce38B8a1Fb2dafe6AC",
-    "owner": "0x15e78734481bD31F6e183dad05225505a45ACd07",
-    "previousAddress": "0x30E2f1A5691a999053A54e8DAf9496CD7ccF2DFD",
-    "rotatedAt": "2026-05-20T17:14:48.591Z",
-    "deployTxHash": "0x44c0fc6f92e1c8247304dceb195b8cfa1ae114a79e7a6ce1305e4305de45b9af",
-    "setMessengerTxHash": "0x13313c9cc29ae9d7ce1e13ca78472359fdb6213b5d1d936d73f89ca051867c00",
-    "rotationBlockNumber": 10886858
-  },
-  "handover": {
-    "renounceAdmin": false
-  },
-  "contracts": {
-    "JINN": "0x0bc0B2f733bF4229FD58Baaac5ebFEf2AEc83C4A",
-    "TimelockController": "0x5CE9c7E24f0509490a91a1cD285DDFF70A9C058D",
-    "JinnGovernor": "0xbbc43A1B5AC699de09577dAE4A1007a3bA704D9E",
-    "JinnDistributor": "0xaC9CD847660d05e77D82A3684aFC4EbFd94fBfe6",
-    "Messenger": "0xd229A2C20333B747675090Ce38B8a1Fb2dafe6AC",
-    "MockMessenger": "0xd229A2C20333B747675090Ce38B8a1Fb2dafe6AC"
-  },
-  "rotations": [
-    {
-      "type": "mock-messenger",
-      "previousMessenger": "0x30E2f1A5691a999053A54e8DAf9496CD7ccF2DFD",
-      "newMessenger": "0xd229A2C20333B747675090Ce38B8a1Fb2dafe6AC",
-      "owner": "0x15e78734481bD31F6e183dad05225505a45ACd07",
-      "distributor": "0xaC9CD847660d05e77D82A3684aFC4EbFd94fBfe6",
-      "deployTxHash": "0x44c0fc6f92e1c8247304dceb195b8cfa1ae114a79e7a6ce1305e4305de45b9af",
-      "setMessengerTxHash": "0x13313c9cc29ae9d7ce1e13ca78472359fdb6213b5d1d936d73f89ca051867c00",
-      "blockNumber": 10886858,
-      "rotatedAt": "2026-05-20T17:14:48.591Z"
-    }
-  ]
-}

package/deployments/deployment-jinn-mvi-l1-sepolia.json

@@ -1,55 +0,0 @@
-{
-  "network": "sepolia",
-  "chainId": 11155111,
-  "deployer": "0x15e78734481bD31F6e183dad05225505a45ACd07",
-  "deployedAt": "2026-04-29T12:14:01.626Z",
-  "config": {
-    "timingProfile": "fast-test",
-    "votingDelaySeconds": 60,
-    "votingPeriodSeconds": 600,
-    "proposalThreshold": "0",
-    "quorumNumerator": 4,
-    "timelockMinDelaySeconds": 60
-  },
-  "distributor": {
-    "operatorRatio": "750000000000000000",
-    "daoRatio": "250000000000000000",
-    "wCreation": "1",
-    "wRestorationDelivery": "1",
-    "wEvaluationDelivery": "1"
-  },
-  "messenger": {
-    "mode": "mock",
-    "address": "0xd229A2C20333B747675090Ce38B8a1Fb2dafe6AC",
-    "owner": "0x15e78734481bD31F6e183dad05225505a45ACd07",
-    "previousAddress": "0x30E2f1A5691a999053A54e8DAf9496CD7ccF2DFD",
-    "rotatedAt": "2026-05-20T17:14:48.591Z",
-    "deployTxHash": "0x44c0fc6f92e1c8247304dceb195b8cfa1ae114a79e7a6ce1305e4305de45b9af",
-    "setMessengerTxHash": "0x13313c9cc29ae9d7ce1e13ca78472359fdb6213b5d1d936d73f89ca051867c00",
-    "rotationBlockNumber": 10886858
-  },
-  "handover": {
-    "renounceAdmin": false
-  },
-  "contracts": {
-    "JINN": "0x0bc0B2f733bF4229FD58Baaac5ebFEf2AEc83C4A",
-    "TimelockController": "0x5CE9c7E24f0509490a91a1cD285DDFF70A9C058D",
-    "JinnGovernor": "0xbbc43A1B5AC699de09577dAE4A1007a3bA704D9E",
-    "JinnDistributor": "0xaC9CD847660d05e77D82A3684aFC4EbFd94fBfe6",
-    "Messenger": "0xd229A2C20333B747675090Ce38B8a1Fb2dafe6AC",
-    "MockMessenger": "0xd229A2C20333B747675090Ce38B8a1Fb2dafe6AC"
-  },
-  "rotations": [
-    {
-      "type": "mock-messenger",
-      "previousMessenger": "0x30E2f1A5691a999053A54e8DAf9496CD7ccF2DFD",
-      "newMessenger": "0xd229A2C20333B747675090Ce38B8a1Fb2dafe6AC",
-      "owner": "0x15e78734481bD31F6e183dad05225505a45ACd07",
-      "distributor": "0xaC9CD847660d05e77D82A3684aFC4EbFd94fBfe6",
-      "deployTxHash": "0x44c0fc6f92e1c8247304dceb195b8cfa1ae114a79e7a6ce1305e4305de45b9af",
-      "setMessengerTxHash": "0x13313c9cc29ae9d7ce1e13ca78472359fdb6213b5d1d936d73f89ca051867c00",
-      "blockNumber": 10886858,
-      "rotatedAt": "2026-05-20T17:14:48.591Z"
-    }
-  ]
-}

package/deployments/deployment-jinn-mvi-l2-baseSepolia.json

@@ -1,13 +0,0 @@
-{
-  "network": "baseSepolia",
-  "chainId": 84532,
-  "deployer": "0x15e78734481bD31F6e183dad05225505a45ACd07",
-  "deployedAt": "2026-05-20T15:23:10.000Z",
-  "deployBlock": 41761151,
-  "txHash": "0x97524384c024a2bcfe11b3699bad53e8533bc25f43e64101ce1e0e4170491f9b",
-  "contracts": {
-    "TaskClaimEmitter": "0xF60055534E377F4020eEA80356C0643E02f4f307",
-    "TaskActivityCheckerV3": "0x0e1B5f264F4FAdcFAA950fb00c58d9A39C040f70",
-    "ServiceRegistry": "0x31D3202d8744B16A120117A053459DDFAE93c855"
-  }
-}

package/deployments/deployment-jinn-testnet-faucet-baseSepolia-fast.json

@@ -1,15 +0,0 @@
-{
-  "network": "baseSepolia",
-  "chainId": 84532,
-  "deployer": "0x15e78734481bD31F6e183dad05225505a45ACd07",
-  "deployedAt": "2026-04-20T13:14:18.413Z",
-  "config": {
-    "jinnToken": "0xAB9a01cd4A379e36006ec6df2960CF39EF79df63",
-    "dripAmount": "100000000000000000000",
-    "dripInterval": 86400,
-    "initialSupplyBridged": "1000000000000000000000"
-  },
-  "contracts": {
-    "faucet": "0xa7c2DBA07E41F16eF94cbEAeAEd97bC904032619"
-  }
-}

package/dist/api/peers.js.map

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

package/dist/daemon/jinn-claim-loop-canonical.d.ts

@@ -1,207 +0,0 @@
-/**
- * Canonical OP-Stack storage proof construction for the cross-chain JINN claim
- * loop. Implements `jinnMessengerMode === 'canonical'`.
- *
- * The builder is intended for the verifier-only canary path during testnet
- * burn-in. Active burn-in still uses MockMessenger; this module constructs
- * the canonical proof blob so operators can call
- * `CanonicalOpStackMessenger.verifyClaim` via `eth_call` after finality.
- *
- * The proof blob uses the locked ABI:
- *
- *        (
- *          bytes32 disputeGameId,
- *          bytes outputRootProof,
- *          bytes[] accountProof,
- *          bytes[] storageProof,
- *          uint256 claimId,
- *          uint256 serviceId,
- *          uint256 taskCreationWeight,
- *          uint256 solutionDeliveryWeight,
- *          uint256 verdictDeliveryWeight,
- *          address multisig
- *        )
- *
- * The proof uses an account proof + storage proof for
- * `TaskClaimEmitter.claimSnapshotHashes[claimId]` against the finalized L2
- * state root. Events are discovery only; L1 canonical verification proves the
- * stored snapshot hash.
- *
- * Tracked follow-up: bd `jinn-mono-7x5` Phase B-canonical.
- */
-import { type Address, type Hex, type PublicClient, type WalletClient } from 'viem';
-export interface CanonicalProofInputs {
-    /** Decoded ClaimTicket snapshot (use `decodeClaimTicketFromReceipt`). */
-    snapshot: CanonicalClaimSnapshot;
-    /** L2 block number containing the emit tx. */
-    l2BlockNumber: bigint;
-}
-export interface OpStackTargetChain {
-    contracts: {
-        disputeGameFactory: Readonly<Record<number, {
-            readonly address: Address;
-        }>>;
-        portal: Readonly<Record<number, {
-            readonly address: Address;
-        }>>;
-    };
-}
-export interface CanonicalProofClients {
-    l1Client: PublicClient;
-    /**
-     * L2 client used for `getBlock` + historical `eth_getProof` at the dispute
-     * game's L2 block. Must be archive-capable.
-     */
-    l2ProofClient: PublicClient;
-    /** OP Stack L2 target chain used by viem/op-stack game lookup. */
-    targetChain: OpStackTargetChain;
-    /** L1 OptimismPortal2 address. */
-    optimismPortal: Address;
-    /** L1 DisputeGameFactory address. */
-    disputeGameFactory: Address;
-    /** L2 TaskClaimEmitter address that emitted ClaimTicket. */
-    claimEmitter: Address;
-}
-export interface CanonicalClaimSnapshot {
-    claimId: bigint;
-    serviceId: bigint;
-    taskCreationWeight: bigint;
-    solutionDeliveryWeight: bigint;
-    verdictDeliveryWeight: bigint;
-    multisig: Address;
-    claimer: Address;
-}
-export interface CanonicalGameSelection {
-    index: bigint;
-    l2BlockNumber: bigint;
-    proxy: Address;
-    factoryGameType: number;
-    proxyGameType: number;
-    rootClaim: Hex;
-}
-export interface CanonicalProofBuildResult {
-    proof: Hex;
-    snapshot: CanonicalClaimSnapshot;
-    game: CanonicalGameSelection;
-    proofBlockNumber: bigint;
-}
-export declare const DISPUTE_GAME_FACTORY_ABI: readonly [{
-    readonly name: "gameAtIndex";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly type: "uint256";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "uint32";
-        readonly name: "gameType_";
-    }, {
-        readonly type: "uint64";
-        readonly name: "timestamp_";
-    }, {
-        readonly type: "address";
-        readonly name: "proxy_";
-    }];
-}];
-export declare const DISPUTE_GAME_ABI: readonly [{
-    readonly name: "gameType";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint32";
-    }];
-}, {
-    readonly name: "status";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint8";
-    }];
-}, {
-    readonly name: "resolvedAt";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint64";
-    }];
-}, {
-    readonly name: "rootClaim";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "bytes32";
-    }];
-}, {
-    readonly name: "wasRespectedGameTypeWhenCreated";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "bool";
-    }];
-}];
-export declare const OPTIMISM_PORTAL_ABI: readonly [{
-    readonly name: "respectedGameType";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint32";
-    }];
-}, {
-    readonly name: "proofMaturityDelaySeconds";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}, {
-    readonly name: "disputeGameFinalityDelaySeconds";
-    readonly type: "function";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
-}];
-/**
- * Wait until the L2 emit transaction is finalized through the canonical
- * OP-Stack pipeline (DisputeGame resolved + finality airgap elapsed) and
- * construct the `bytes proof` blob accepted by CanonicalOpStackMessenger.
- *
- * This is deliberately one-shot: if no covering/resolved/finalized dispute
- * game exists yet, it throws and the daemon retries on a later tick.
- */
-export declare function buildCanonicalProof(clients: CanonicalProofClients, inputs: CanonicalProofInputs): Promise<CanonicalProofBuildResult>;
-export declare function claimSnapshotStorageSlot(claimId: bigint): Hex;
-export declare function decodeClaimTicketFromReceipt(logs: readonly {
-    address: Address;
-    topics: readonly Hex[];
-    data: Hex;
-    logIndex?: number | null;
-}[], claimEmitter: Address, logIndex: number): CanonicalClaimSnapshot;
-export declare function selectCoveringDisputeGame(clients: CanonicalProofClients, l2BlockNumber: bigint): Promise<CanonicalGameSelection>;
-export declare function assertDisputeGameReady(clients: CanonicalProofClients, game: CanonicalGameSelection): Promise<void>;
-/**
- * Submit `JinnDistributor.claim(proof)` on L1 once a canonical proof has
- * been constructed. Mirrors the mock-mode submission path; idempotent at
- * the contract layer.
- */
-export declare function submitCanonicalClaim(l1Client: PublicClient, l1Wallet: WalletClient, distributor: Address, proof: Hex): Promise<Hex>;
-/**
- * Verifier-only canonical canary. This intentionally uses `eth_call`
- * (`readContract`) against the messenger and does not submit
- * `JinnDistributor.claim`. Burn-in keeps MockMessenger active.
- */
-export declare function verifyCanonicalClaimCanary(l1Client: PublicClient, messenger: Address, proof: Hex): Promise<{
-    serviceId: bigint;
-    taskCreationWeight: bigint;
-    solutionDeliveryWeight: bigint;
-    verdictDeliveryWeight: bigint;
-    multisig: Address;
-}>;