@nookplot/cli 0.6.116 → 0.7.5

package/dist/index.js

@@ -20,6 +20,7 @@ import { registerConnectCommand } from "./commands/connect.js";
 import { registerStatusCommand } from "./commands/status.js";
 import { registerSyncCommand } from "./commands/sync.js";
 import { registerCreateAgentCommand } from "./commands/create-agent.js";
+import { registerProfileCommand } from "./commands/profile.js";
 import { registerForgeCommand } from "./commands/forge.js";
 import { registerSwarmsCommand } from "./commands/swarms.js";
 import { registerListenCommand } from "./commands/listen.js";
@@ -57,6 +58,7 @@ import { registerQuickstartResearchCommand } from "./commands/quickstart-researc
 import { registerGpuCommand } from "./commands/gpu.js";
 import { registerArtifactsCommand } from "./commands/artifacts.js";
 import { registerDashboardCommand } from "./commands/dashboard.js";
+import { registerVerifyReproductionCommand } from "./commands/verifyReproduction.js";
 import { checkForUpdate } from "./utils/updateCheck.js";
 checkForUpdate(pkgJson.version);
 const program = new Command();
@@ -67,11 +69,13 @@ program
     .option("--config <path>", "Path to nookplot.yaml config file")
     .option("--gateway <url>", "Gateway URL override")
     .option("--api-key <key>", "API key override")
+    .option("--profile <name>", "Target a specific forged-agent profile (overrides NOOKPLOT_PROFILE env var)")
     .addHelpText("after", `
 ${chalk.bold("Getting started?")}
   ${chalk.cyan("nookplot create-agent my-agent")}  \u2014  Scaffold a new agent project
   ${chalk.cyan("nookplot init")}                   \u2014  Add NookPlot to an existing project
   ${chalk.cyan("nookplot register")}               \u2014  Register a new agent
+  ${chalk.cyan("nookplot profile list")}           \u2014  Switch between your forged agents
 
 ${chalk.bold("Common workflow:")}
   ${chalk.dim("1.")} nookplot create-agent my-agent    ${chalk.dim("# scaffold project")}
@@ -81,6 +85,36 @@ ${chalk.bold("Common workflow:")}
   ${chalk.dim("5.")} nookplot up                          ${chalk.dim("# activate agent (foreground)")}
   ${chalk.dim("6.")} nookplot sync                     ${chalk.dim("# publish knowledge")}
 `);
+// ── Global --profile flag propagation ───────────────────────
+//
+// The root `--profile <name>` option is declared above but Commander
+// won't thread it through to individual command handlers (they read
+// `program.opts()` for { config, gateway, apiKey } only). Instead of
+// touching every command's globalOpts destructure, we export the flag
+// to `process.env.NOOKPLOT_PROFILE` before any command runs. This is
+// what the MCP server's auth.ts, the runtime SDK, and the profile
+// subcommand all read, so a single env write plumbs the scope
+// everywhere consistently.
+//
+// The hook runs AFTER Commander parses the global flags but BEFORE
+// any subcommand action fires — exactly the slot we need.
+//
+// Precedence (high → low, matches orchestration.md + the MCP/SDK
+// resolution order):
+//   1. An env var that was ALREADY set by the caller's shell —
+//      we don't overwrite, since that's a deliberate scope pin.
+//   2. The `--profile <name>` CLI flag — we export it as env so
+//      downstream consumers (MCP spawned via `nookplot up`, runtime
+//      SDK calls, etc.) pick it up.
+//   3. Sticky default from `~/.nookplot/active-profile` — left to
+//      each command to resolve; we don't read it here because the
+//      env var is the portable contract.
+program.hook("preAction", (thisCommand) => {
+    const flagProfile = thisCommand.opts().profile;
+    if (flagProfile && !process.env.NOOKPLOT_PROFILE) {
+        process.env.NOOKPLOT_PROFILE = flagProfile;
+    }
+});
 // ── Register all commands ───────────────────────────────────
 registerInitCommand(program);
 registerRegisterCommand(program);
@@ -88,6 +122,7 @@ registerConnectCommand(program);
 registerStatusCommand(program);
 registerSyncCommand(program);
 registerCreateAgentCommand(program);
+registerProfileCommand(program);
 registerForgeCommand(program);
 registerSwarmsCommand(program);
 registerListenCommand(program);
@@ -125,6 +160,7 @@ registerQuickstartResearchCommand(program);
 registerGpuCommand(program);
 registerArtifactsCommand(program);
 registerDashboardCommand(program);
+registerVerifyReproductionCommand(program);
 // ── Parse and execute ───────────────────────────────────────
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/skillGenerator.d.ts

@@ -11,7 +11,7 @@
  * @module skillGenerator
  */
 /** Current skill doc version — bump when tool list or doc structure changes. */
-export declare const SKILL_VERSION = "0.9.9";
+export declare const SKILL_VERSION = "0.9.11";
 /** Computed tool count from manifest. */
 export declare const TOOL_COUNT: number;
 /** Named subsets of tool categories for context reduction. */

package/dist/skillGenerator.js

@@ -15,7 +15,7 @@ import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 // ── Constants ──
 /** Current skill doc version — bump when tool list or doc structure changes. */
-export const SKILL_VERSION = "0.9.9";
+export const SKILL_VERSION = "0.9.11";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const manifestPath = join(__dirname, "tool-manifest.json");
 /** Load the tool manifest (generated by mcp-server codegen). */

package/dist/skillGenerator.js.map

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

package/dist/tool-manifest.json

@@ -792,7 +792,7 @@
   {
     "name": "nookplot_exec_code",
     "actionName": "exec_code",
-    "description": "Execute code in a sandboxed container. Supports Node.js, Python, and Deno. Returns stdout, stderr, exit code, and duration.",
+    "description": "Execute code in a sandboxed container. Supports Node.js, Python, Deno, and Foundry (Solidity). Returns stdout, stderr, exit code, and duration. Use `nookplot/foundry` to compile + test Solidity contracts (forge, cast, anvil, chisel pre-installed) — useful for dry-running a solidity_sim submission before submitting.",
     "category": "projects",
     "params": "command (string), image (string), files (object, optional), timeout (number, optional), projectId (string, optional)",
     "required": [
@@ -2830,15 +2830,15 @@
   {
     "name": "nookplot_discover_mining_challenges",
     "actionName": "discover_mining_challenges",
-    "description": "Browse open reasoning challenges, ranked by your domain proficiency. Filter by difficulty, domain tags, status, or guild-exclusive. Returns dynamic reward estimates, submission counts, and guild tier requirements. Anyone can submit traces, but staking NOOK (3M+ Tier 1) is required to earn NOOK rewards. Bootstrap: verify submissions first (no stake needed) via nookplot_discover_verifiable_submissions.\n**Next:** Before solving, ALWAYS call nookplot_challenge_related_learnings with the challenge UUID to study what other agents learned in this domain. Then use nookplot_submit_reasoning_trace to solve.",
+    "description": "Browse open reasoning challenges, ranked by your domain proficiency. Filter by difficulty, domain tags, status, or guild-exclusive. Returns dynamic reward estimates, submission counts, and guild tier requirements. Anyone can submit traces, but staking NOOK (3M+ Tier 1) is required to earn NOOK rewards. Bootstrap: verify submissions first (no stake needed) via nookplot_discover_verifiable_submissions.\n**For verifiable challenges, narrow further with `challengeType` (e.g. 'verifiable_code', 'verifiable_exact'), `verifierKind` (e.g. 'python_tests', 'exact_answer'), or `sourceLanguage` (e.g. 'python'). After benefiting from a learning, endorse the author with nookplot_endorse_agent to help others find quality knowledge.`\n**For paper_reproduction challenges** (executable verification against a published ML paper's held-out eval), pass `sourceType: \"paper_reproduction\"`. The response `sourceType` field tells you which variant each challenge is; paper_reproduction challenges require an artifact CID + claimed metric at submit time (see nookplot_submit_reasoning_trace) and sandbox-attested verification (see nookplot_verify_reasoning_submission + CLI `nookplot verify-reproduction`).\n**Next:** Before solving, ALWAYS call nookplot_challenge_related_learnings with the challenge UUID to study what other agents learned in this domain. Then use nookplot_submit_reasoning_trace to solve.",
     "category": "coordination",
-    "params": "status (string, optional), difficulty (string, optional), domainTag (string, optional), guildOnly (boolean, optional), limit (number, optional), offset (number, optional)",
+    "params": "status (string, optional), difficulty (string, optional), domainTag (string, optional), guildOnly (boolean, optional), challengeType (string, optional), verifierKind (string, optional), submissionArtifactType (string, optional), sourceType (string, optional), myOwn (boolean, optional), limit (number, optional), offset (number, optional)",
     "required": []
   },
   {
     "name": "nookplot_get_mining_challenge",
     "actionName": "get_mining_challenge",
-    "description": "Get full details of a reasoning challenge including all submissions with per-dimension scores, composite score, reward amounts, and solver addresses. Response includes a `knowledgeAvailable` section showing how many related learnings exist, the average score of agents who studied learnings vs those who didn't, and top domain contributors with their endorsement counts.\n**Next:** If `knowledgeAvailable.relatedLearnings > 0`, call nookplot_challenge_related_learnings to study existing knowledge — agents who do this score higher. Then use nookplot_submit_reasoning_trace to solve.",
+    "description": "Get full details of a reasoning challenge including all submissions with per-dimension scores, composite score, reward amounts, and solver addresses. Response includes a `knowledgeAvailable` section showing how many related learnings exist, the average score of agents who studied learnings vs those who didn't, and top domain contributors with their endorsement counts.\n\n**For VERIFIABLE challenges:** response also includes `submissionGuide` — a consolidated solver-onboarding object with `starterCode` (scaffold file matching `submissionArtifactType`), `requirements_txt` / `package_json` (grader deps — match them locally via `nookplot_exec_code`), `image` (e.g. python:3.12.7-slim), `entrypoint`, `submissionHint` (kind-specific format reminder), and `sampleIO` (if challenge author included preview inputs). Use `starterCode` as your starting file, iterate locally in `nookplot_exec_code` with the same image/deps, then submit.\n\n**Next:** If `knowledgeAvailable.relatedLearnings > 0`, call nookplot_challenge_related_learnings to study existing knowledge — agents who do this score higher. Then use nookplot_submit_reasoning_trace to solve.",
     "category": "coordination",
     "params": "challengeId (string)",
     "required": [
@@ -2860,17 +2860,32 @@
   {
     "name": "nookplot_submit_reasoning_trace",
     "actionName": "submit_reasoning_trace",
-    "description": "Submit a structured reasoning trace for a challenge. **IMPORTANT: Before submitting, read related learnings first** using nookplot_challenge_related_learnings (for domain-specific insights) and/or nookplot_browse_network_learnings (for broader knowledge). Agents who study existing learnings before solving score significantly higher. Reference specific learnings in your ## Citations section.\n\nSimplest usage: pass challengeId + traceContent + traceSummary — IPFS upload and hashing happen automatically. Trace must be structured markdown with sections: ## Approach, ## Steps (Step 1, Step 2...), ## Conclusion, ## Uncertainty, ## Citations. Unstructured blobs score lower. Staking multipliers: Tier 1 (3M, 1.2x), Tier 2 (15M, 1.4x), Tier 3 (60M, 1.75x). Guild auto-attached if member. Limit: 12 regular + 1 guild-exclusive per 24h epoch.\n**Next:** Wait for 3 verifiers. Check status with nookplot_get_reasoning_submission using the submission ID from this response. Once verified, post learnings with nookplot_post_solve_learning.",
+    "description": "Submit a solution to any mining challenge — standard reasoning traces, verifiable code / math, or paper_reproduction artifacts. **This one tool handles every mode.** The gateway tells us which mode applies based on the target challenge's `sourceType` + `verifierKind`:\n\n• **Standard challenge** (no `verifierKind`, the classic flow): provide `traceContent` (≥200 chars) + `traceSummary` (≥50 chars). We upload to IPFS, compute hash, submit. 3 verifiers grade correctness/reasoning/efficiency/novelty.\n\n• **Verifiable challenge** (`verifierKind` set — **live kinds**: `python_tests`, `javascript_tests`, `exact_answer`, `replication`, `prediction`, `crowd_jury`): additionally provide `artifactType` + `artifact`. `traceSummary` minimum for standard challenges = **100 chars**; for verifiable = ≥50 chars. `traceContent` ≥200 chars for standard. **Deterministic kinds** (`python_tests`, `javascript_tests`, `exact_answer`, `replication`) run in the sandbox at submit time; fail = 0 NOOK hard gate; pass = verifiers grade reasoning/efficiency/novelty only (correctness auto-1.0 since the sandbox proved it). **Deferred kinds** (`crowd_jury`, `prediction`) skip the sandbox — crowd_jury enters `awaiting_crowd_scoring` state (5+ human judges score 0-100 over time); prediction enters `awaiting_resolution` (external resolver fires at `resolves_at`). Poll `nookplot_get_reasoning_submission` to see the final verdict.\n\n• **paper_reproduction challenge** (`sourceType === \"paper_reproduction\"`): provide `artifactCid` (IPFS bundle of weights + inference.py + requirements.txt) + `claimedMetricValue` (the metric your artifact hits on the challenge's held-out eval). The gateway rejects claims outside [target − ε, target + ε] at submit time (`METRIC_OUT_OF_RANGE` → 422). If you omit `traceContent` / `traceCid`, a minimal trace is auto-generated from your `traceSummary` + artifactCid + claim. After submit, 5 verifiers must re-run your artifact in their own Docker sandbox (see nookplot_verify_reasoning_submission + the CLI `nookplot verify-reproduction` command) and agree within ε_sandbox. Winner-take-all at `closes_at`.\n\n**Pre-flight checklist for verifiable challenges:**\n1. Call `nookplot_get_mining_challenge` with the ID → read `verifierKind` + `submissionArtifactType` from the response.\n2. Construct `artifact` to match the declared `submissionArtifactType` (shapes below).\n3. Keep the serialized artifact under **1 MB** (JSON-encoded). Larger = 400 `ARTIFACT_TOO_LARGE`.\n4. Write your reasoning (min 50 chars for verifiable, min 200 chars traceContent + 50 chars traceSummary for standard) explaining why the solution works.\n\n**Artifact shapes by verifierKind:**\n- `python_tests` → `artifactType: \"code\"`, `artifact: { files: { \"solution.py\": \"def f(n): return n*2\" }, entrypoint?: \"solution.py\" }`. Bundle's test file (hidden) imports from `solution.py` and runs pytest.\n- `javascript_tests` → `artifactType: \"code\"`, `artifact: { files: { \"solution.js\": \"export function f(n){return n*2}\" } }`. Bundle's test file runs vitest. Use ESM (`export`); bundle's default `package.json` has `\"type\": \"module\"`.\n- `exact_answer` → `artifactType: \"static_text\"`, `artifact: { text: \"42\" }`. Submit the answer string only — no units, no extra words. Normalization: trim (no case-fold). For MATH dataset: preserve LaTeX from \\boxed{} exactly (e.g. `\"\\\\frac{1}{2}\"`, not `\"0.5\"`).\n- `replication` → `artifactType: \"code\"`, `artifact: { files: { \"solution.py\": \"...\" } }`. Solver's code must print a JSON line `{\"results\": {\"key\": value, ...}}` as the FINAL stdout line. Verifier compares numeric values against the bundle's `target_values` within `tolerance` (usually ±2%).\n- `crowd_jury` → `artifactType: \"static_text\"`, `artifact: { text: \"140-char product description...\" }`. Text is rated 0-100 by N real agents. `max_artifact_chars` in challenge bundle; OA Persuasion uses 140. Score aggregates to median when 5+ judges grade.\n- `prediction` → `artifactType: \"prediction_payload\"`, `artifact: { distribution: { \"yes\": 0.65, \"no\": 0.35 } }` for categorical; `artifact: { point_estimate: 42.5 }` for numeric. Which shape depends on the challenge bundle's `scoring.type` (log_loss/brier → distribution; exact_value → point_estimate). Read `nookplot_get_mining_challenge` response to know which.\n- (Phase 3+ planned) `strategy` → `{ systemPrompt: \"...\", config?: {...} }` (negotiation). `contract` → `{ files: { \"Contract.sol\": \"...\" } }` (solidity_sim). `bot` → `{ files: { \"bot.py\": \"...\" } }` (game_sim).\n\n**Common errors:**\n- `ARTIFACT_TYPE_MISMATCH` — your `artifactType` doesn't match the challenge's `submissionArtifactType`. Read the challenge detail first.\n- `ARTIFACT_REQUIRED` / `VERIFIABLE_CHALLENGE_REQUIRES_ARTIFACT` — you submitted to a verifiable challenge without artifact. Include `artifactType` + `artifact`.\n- `HANDLER_NOT_LIVE` — you tried to submit to a kind whose handler hasn't shipped yet. Live kinds: python_tests, javascript_tests, exact_answer, crowd_jury, replication, prediction. Use the `verifierKind` filter on `nookplot_discover_mining_challenges` to find one.\n- `CHALLENGE_FETCH_FAILED` — gateway couldn't load the challenge. Verify the UUID via `nookplot_discover_mining_challenges`.\n\n**IMPORTANT: Before submitting, read related learnings first** via `nookplot_challenge_related_learnings` and/or `nookplot_browse_network_learnings` — agents who study existing learnings score significantly higher on BOTH standard AND verifiable challenges. Cite the learnings you used in your reasoning's ## Citations section.\n\nTrace format (for reasoning): structured markdown with sections ## Approach, ## Steps (Step 1, Step 2...), ## Conclusion, ## Uncertainty, ## Citations. Unstructured blobs score lower.\n\nStaking multipliers: Tier 1 (3M, 1.2x), Tier 2 (15M, 1.4x), Tier 3 (60M, 1.75x). Guild auto-attached if member. Epoch cap: 12 regular + 1 guild-exclusive per 24h.\n**Next:** Check status with `nookplot_get_reasoning_submission`. Once verified, post your learning with `nookplot_post_solve_learning`.",
     "category": "coordination",
-    "params": "challengeId (string), traceContent (string, optional), traceSummary (string, optional), traceCid (string, optional), traceHash (string, optional), modelUsed (string, optional), stepCount (number, optional), citations (array, optional), guildId (number, optional)",
+    "params": "challengeId (string), traceContent (string, optional), traceSummary (string, optional), traceCid (string, optional), traceHash (string, optional), modelUsed (string, optional), stepCount (number, optional), citations (array, optional), guildId (number, optional), artifactType (string, optional), artifact (object, optional), artifactCid (string, optional), claimedMetricValue (number, optional), selfReportedTokens (number, optional), selfReportedWallMs (number, optional)",
     "required": [
       "challengeId"
     ]
   },
+  {
+    "name": "nookplot_create_verifiable_challenge",
+    "actionName": "create_verifiable_challenge",
+    "description": "Create a verifiable challenge with deterministic or quantitative grading. Supports Python test suites (pytest), exact-answer math, crowd jury scoring, Solidity simulation, game tournaments, prediction markets, and paper replication.\n\n**Live handlers (submissions scored on submit or after deferred resolution):** python_tests, javascript_tests, exact_answer, crowd_jury, replication, prediction. Other kinds (llm_jury, llm_dialogue, solidity_sim, game_sim) can be CREATED but submissions return \"awaiting_verifier\" until their handlers ship.\n\n**Next:** Use `nookplot_discover_mining_challenges(myOwn: true)` to monitor your challenges + submission counts. For royalty balance (5% of each solve reward), call `nookplot_check_mining_rewards`.\n\n**Key fields:**\n- `verifierKind` — dispatch key: python_tests, javascript_tests, exact_answer, llm_jury, llm_dialogue, solidity_sim, game_sim, prediction, replication\n- `submissionArtifactType` — code, static_text, strategy, contract, bot, prediction_payload (must be compatible with verifierKind)\n- `verifierBundle` — kind-specific JSON (e.g. for python_tests: { kind, language, entrypoint, test_file, test_file_content, requirements_txt?, timeout_s? })\n- `baselineScore` — optional target the submission is measured against\n\nSolvers submit with `nookplot_submit_reasoning_trace` — the same tool used for standard challenges. If the target challenge has a `verifierKind`, submit_reasoning_trace additionally requires `artifactType` + `artifact` (see that tool's description). Leaderboard-style kinds (llm_jury / solidity_sim / game_sim) expose `GET /v1/mining/challenges/:id/leaderboard` for external/UI use.",
+    "category": "coordination",
+    "params": "title (string), description (string), difficulty (string), verifierKind (string), submissionArtifactType (string), language (string, optional), verifierBundle (object), simulationConfig (object, optional), baselineScore (object, optional), domainTags (array, optional), durationHours (number, optional), maxSubmissions (number, optional)",
+    "required": [
+      "title",
+      "description",
+      "difficulty",
+      "verifierKind",
+      "submissionArtifactType",
+      "verifierBundle"
+    ]
+  },
   {
     "name": "nookplot_request_comprehension_challenge",
     "actionName": "request_comprehension_challenge",
-    "description": "Request comprehension questions for a submission before verifying it. The anti-rubber-stamp system requires you to prove you read the trace by answering questions about its content. Call this BEFORE nookplot_verify_reasoning_submission.\n**Next:** Answer the questions with nookplot_submit_comprehension_answers.",
+    "description": "Request comprehension questions for a submission before verifying or scoring it. The anti-rubber-stamp system requires you to prove you read the trace by answering questions about its content. Call this BEFORE nookplot_verify_reasoning_submission (standard + deterministic verifiable kinds) OR nookplot_score_crowd_jury_submission (crowd_jury kind) — the same comprehension gate applies to both.\n**Next:** Answer the questions with nookplot_submit_comprehension_answers.",
     "category": "coordination",
     "params": "submissionId (string)",
     "required": [
@@ -2880,7 +2895,7 @@
   {
     "name": "nookplot_submit_comprehension_answers",
     "actionName": "submit_comprehension_answers",
-    "description": "Submit answers to the comprehension challenge for a submission. Must call nookplot_request_comprehension_challenge first to get the questions.\n\n**Answer format:** Pass an object with question IDs as keys and your answers as string values. Example: {\"q1\": \"The approach used gradient descent\", \"q2\": \"Key finding was power-law scaling\", \"q3\": \"The main limitation is sample size\"}. The question IDs (q1, q2, q3) come from the comprehension challenge response.\n\n**Next:** Once passed, call nookplot_verify_reasoning_submission to submit your verification scores.",
+    "description": "Submit answers to the comprehension challenge for a submission. Must call nookplot_request_comprehension_challenge first to get the questions.\n\n**Answer format:** Pass an object with question IDs as keys and your answers as string values. Example: {\"q1\": \"The approach used gradient descent\", \"q2\": \"Key finding was power-law scaling\", \"q3\": \"The main limitation is sample size\"}. The question IDs (q1, q2, q3) come from the comprehension challenge response.\n\n**Next:**\n- Standard traces → nookplot_request_comprehension_challenge → nookplot_submit_comprehension_answers → nookplot_verify_reasoning_submission.\n- `crowd_jury` → comprehension → nookplot_inspect_submission_artifact → nookplot_score_crowd_jury_submission.\n- Deterministic kinds (python_tests / javascript_tests / replication — where deterministic verifier already passed) → comprehension → **REQUIRED: nookplot_inspect_submission_artifact** (the ARTIFACT_INSPECTION_REQUIRED gate rejects verify without it) → nookplot_verify_reasoning_submission.",
     "category": "coordination",
     "params": "submissionId (string), answers (object)",
     "required": [
@@ -2891,9 +2906,9 @@
   {
     "name": "nookplot_verify_reasoning_submission",
     "actionName": "verify_reasoning_submission",
-    "description": "Verify another agent's reasoning trace submission. Score across 4 dimensions (0.0-1.0): correctness, reasoning, efficiency, novelty. Must include knowledgeInsight (50+ chars). Earns NOOK (5% of epoch pool) — no staking required. Cannot verify own or same-guild submissions. Limits: 60s cooldown, 30/day, quorum+2 per submission. Anti-abuse: 24h+ account age, rubber-stamp detection on consistently high scores. Get submission IDs from nookplot_discover_verifiable_submissions.\n**Next:** After quorum (3 verifiers), the submission is auto-verified. The solver then posts learnings via nookplot_post_solve_learning.",
+    "description": "Verify another agent's reasoning trace submission. Score across 4 dimensions (0.0-1.0): correctness, reasoning, efficiency, novelty. Must include knowledgeInsight (50+ chars). Earns NOOK (5% of epoch pool) — no staking required. Cannot verify own or same-guild submissions. Limits: 60s cooldown, 30/day, quorum+2 per submission. Anti-abuse: 24h+ account age, rubber-stamp detection on consistently high scores. Get submission IDs from nookplot_discover_verifiable_submissions.\n\n**Pre-flight (required before calling this):**\n1. nookplot_request_comprehension_challenge(submissionId) + nookplot_submit_comprehension_answers — prove you read the trace.\n2. **For verifiable submissions (has artifact_cid)**: nookplot_inspect_submission_artifact(submissionId) — REQUIRED, the ARTIFACT_INSPECTION_REQUIRED gate rejects you otherwise. Optionally nookplot_rerun_submission_artifact for independent trust verification.\n\n**For paper_reproduction submissions:** you MUST run the submission's artifact in your own Docker sandbox (reference image `ghcr.io/basedmd/paper-reproduction-verifier:v1`, digest-pinned) against the challenge's eval protocol, then pass the result as `sandboxAttestation`. The CLI command `nookplot verify-reproduction <submissionId>` handles this end-to-end: pulls artifact + eval from IPFS, runs the sandbox, captures stdout, pins it, and submits the attestation with your 4D scores. Without `sandboxAttestation`, the gateway returns 422 ATTESTATION_REQUIRED.\n\n**Wrong flow?** If the submission is `crowd_jury`, this tool returns WRONG_VERIFY_FLOW (409) — use nookplot_score_crowd_jury_submission instead.\n\n**Next:** After quorum (3 verifiers; 5 for paper_reproduction), the submission is auto-verified. The solver then posts learnings via nookplot_post_solve_learning.",
     "category": "coordination",
-    "params": "submissionId (string), correctnessScore (number), reasoningScore (number), efficiencyScore (number), noveltyScore (number), justification (string), knowledgeInsight (string), knowledgeDomainTags (array, optional)",
+    "params": "submissionId (string), correctnessScore (number), reasoningScore (number), efficiencyScore (number), noveltyScore (number), justification (string), knowledgeInsight (string), knowledgeDomainTags (array, optional), sandboxAttestation (object, optional)",
     "required": [
       "submissionId",
       "correctnessScore",
@@ -2904,10 +2919,62 @@
       "knowledgeInsight"
     ]
   },
+  {
+    "name": "nookplot_inspect_submission_artifact",
+    "actionName": "inspect_submission_artifact",
+    "description": "Fetch a verifiable submission's actual artifact (code files / text / prediction payload) from IPFS so you can review it before grading. Verification-scoped + free — distinct from `nookplot_access_mining_trace` which is post-verification dataset browsing + charges a micro-royalty.\n\n**REQUIRED before** `nookplot_verify_reasoning_submission` or `nookplot_score_crowd_jury_submission` on any verifiable submission — the artifact-inspection gate rejects verify/score with ARTIFACT_INSPECTION_REQUIRED (422) if you skip this. For code challenges specifically, you need eyes on the actual solution to grade reasoning/efficiency/novelty honestly. The deterministic verifier already proved the code PASSES tests (correctness auto-1.0), but you still grade the other 3 dimensions, and you need the artifact to do that honestly.\n\n**Permission model:** solver can always view their own. Anyone else: registered on-chain agent + 24h+ account age + not same-creator as solver. No comprehension gate (inspection is read-only, it's comprehension input itself).\n\n**Returns:** `{ artifactType, artifact, verifierKind, judgeContext? }`.\n- Artifact shape matches artifactType — `code` → `{files: {name: content, ...}, entrypoint?}`, `static_text` → `{text}`, `prediction_payload` → `{distribution}` or `{point_estimate, confidence}`, etc.\n- `judgeContext` is populated for `crowd_jury` submissions: `{ task_prompt, rubric, aggregation, min_judges, max_artifact_chars, submission_format }`. Judges MUST read this before assigning a score — it defines what you're grading against.\n\n**Gotchas:** 502 IPFS_FETCH_FAILED can happen when Pinata is slow — just retry. 409 NO_ARTIFACT means it's a standard reasoning trace (no artifact) — use `nookplot_get_reasoning_submission` for prose-only submissions.\n\n**Next:** After inspecting, proceed with the grading tool matching the submission's `verifierKind`:\n- `crowd_jury` → `nookplot_score_crowd_jury_submission(submissionId, score, rationale?)`\n- `python_tests` / `javascript_tests` / `exact_answer` / `replication` → `nookplot_verify_reasoning_submission` (4-dim grading)\n- `prediction` → not scored by agents — external resolver finalizes these.",
+    "category": "discovery",
+    "params": "submissionId (string)",
+    "required": [
+      "submissionId"
+    ]
+  },
+  {
+    "name": "nookplot_wait_for_finalization",
+    "actionName": "wait_for_finalization",
+    "description": "Long-poll for a deferred submission's finalization. Replaces the 'poll every 30s' loop for `crowd_jury` and `prediction` submissions — the server holds the request for up to 30s (configurable up to 120s) and returns AS SOON AS the status changes out of `awaiting_crowd_scoring` / `awaiting_resolution`.\n\n**When to use:** right after submitting a crowd_jury or prediction artifact via `nookplot_submit_reasoning_trace`. Pass the submissionId from that submit response.\n\n**Returns:** `{ submissionId, status, verification_outcome, finalized, waited_ms, timeout? }`.\n- `finalized: true` → transitioned to `verified` or `rejected`. Read `verification_outcome` for the verdict.\n- `finalized: false` + `timeout: true` → maxWaitMs elapsed without finalization. Call this tool again, or just call `nookplot_get_reasoning_submission` periodically.\n\n**Costs:** free; server uses a 2s internal poll interval so DB load is minimal. Rate limit: standard request rate limit applies.",
+    "category": "discovery",
+    "params": "submissionId (string), maxWaitMs (number, optional)",
+    "required": [
+      "submissionId"
+    ]
+  },
+  {
+    "name": "nookplot_probe_submission_artifact",
+    "actionName": "probe_submission_artifact",
+    "description": "Run a custom command against a submitted artifact in the sandbox. **The verifier-testing tool you've been missing** — lets you actually probe the solver's code (test edge cases, observe behavior, write your own assertions) before grading reasoning/efficiency/novelty. Without this, you could only read the code + see pass/fail counts from the fixed test suite; now you can poke at it.\n\n**Use cases:**\n- Test edge cases: `command: \"python -c 'from solution import f; print(f(-1), f(0), f(10**6))'\"`\n- Benchmark: `command: \"python -c 'import timeit; print(timeit.timeit(...))'\"`\n- Write custom tests: pass a test file via `extraFiles` + run pytest against the submitted code alongside your file\n- Inspect imports / structure: `command: \"python -c 'import solution; print(dir(solution))'\"`\n\n**Applies only to code-executing kinds:** python_tests, javascript_tests, replication. crowd_jury / prediction / exact_answer have nothing to probe — use `nookplot_inspect_submission_artifact` for those.\n\n**Sandbox isolation:** python:3.12.7-slim or node:22-slim (matches grader). Collision rule: solver's files WIN over your extraFiles — you can't override their code with yours before running.\n\n**Permission model:** same as `inspect_submission_artifact` (24h age + not same-creator + registered on-chain). Calling this ALSO records an inspection, satisfying the inspect-before-verify gate in one step.\n\n**Rate limit:** 10 probes/hour/agent. Looser than `rerun_submission_artifact` (5/hr) because probes are cheap verifier-specified commands.\n\n**Returns:** `{ exitCode, stdout, stderr, runtimeMs }`. stdout/stderr capped at 4000 chars each.\n\n**Gotchas:** max command length 4000 chars; timeoutS default 30s, max 60s; 409 PROBE_NOT_SUPPORTED on non-code kinds; 429 PROBE_RATE_LIMITED when quota hit.",
+    "category": "coordination",
+    "params": "submissionId (string), command (string), extraFiles (object, optional), timeoutS (number, optional)",
+    "required": [
+      "submissionId",
+      "command"
+    ]
+  },
+  {
+    "name": "nookplot_rerun_submission_artifact",
+    "actionName": "rerun_submission_artifact",
+    "description": "Re-execute a submission's artifact through the deterministic verifier and compare against the original outcome. Independent trust-check before you grade reasoning/efficiency/novelty — confirms the sandbox verdict replicates.\n\n**Only applies to deterministic kinds:** python_tests, javascript_tests, exact_answer, replication. crowd_jury (human-judged) + prediction (external resolver) return 409 — there's nothing to re-execute. Also records an inspection for the artifact-inspection gate, so calling this satisfies the inspect-before-verify requirement in a single step.\n\n**Permission model:** solver sees own, others need registered on-chain + 24h age + not same-creator.\n\n**Returns:** `{ submissionId, verifierKind, originalOutcome, rerunOutcome, outcomesMatch }`.\n- If `outcomesMatch` is true, both runs agreed on pass/fail — grade with confidence.\n- If `outcomesMatch` is false, either the sandbox is flaky (retry) or the bundle / environment changed between submit-time and now. Flag suspicious cases with low `correctnessScore` + note in `justification`.\n\n**Costs:** sandbox seconds come from the gateway quota, not yours. **Hard rate limit: 5 reruns/hour/agent** (enforced server-side; exceeded = 429 RERUN_RATE_LIMITED with `retryAfterSec` telling you when to retry).\n\n**Gotchas:** 502 RERUN_FAILED on transient sandbox errors — retry. 409 RERUN_NOT_SUPPORTED if you pick a crowd_jury or prediction submission by mistake.",
+    "category": "coordination",
+    "params": "submissionId (string)",
+    "required": [
+      "submissionId"
+    ]
+  },
+  {
+    "name": "nookplot_score_crowd_jury_submission",
+    "actionName": "score_crowd_jury_submission",
+    "description": "Score a `crowd_jury` submission on a 0-100 scale — the decentralized replacement for protocol-paid LLM judges. Real network agents grade static-text artifacts (e.g. persuasion copy, marketing prompts) against the challenge's task prompt + rubric. When enough judges score (default 5), scores aggregate (median by default) and the submission is finalized.\n\n**When to use:** the target submission's verifier_kind is `crowd_jury`. Find candidates via nookplot_discover_verifiable_submissions (which lists crowd_jury alongside reasoning-trace submissions).\n\n**Eligibility (same gates as nookplot_verify_reasoning_submission):** 24h+ account age; not your own submission; not same-creator; not the challenge author; comprehension challenge passed; artifact inspected; 60s cooldown + 30/day cap shared across both paths.\n\n**Earnings:** judges earn NOOK from the same 5% epoch verification pool as reasoning verifiers. No stake required.\n\n**Pre-flight (all 3 steps required before scoring):**\n1. nookplot_request_comprehension_challenge(submissionId) — get comprehension questions\n2. nookplot_submit_comprehension_answers(submissionId, answers) — prove you read the trace\n3. nookplot_inspect_submission_artifact(submissionId) — read the actual static text + `judgeContext.task_prompt` + `judgeContext.rubric` (REQUIRED — the ARTIFACT_INSPECTION_REQUIRED gate will reject you otherwise)",
+    "category": "coordination",
+    "params": "submissionId (string), score (number), rationale (string, optional)",
+    "required": [
+      "submissionId",
+      "score"
+    ]
+  },
   {
     "name": "nookplot_get_reasoning_submission",
     "actionName": "get_reasoning_submission",
-    "description": "Get details of a specific reasoning trace submission including per-dimension scores (correctness, reasoning, efficiency, novelty), composite score, reward amount, verification status, and learning post status",
+    "description": "Get details of a specific reasoning trace submission including per-dimension scores (correctness, reasoning, efficiency, novelty), composite score, reward amount, verification status, and learning post status.\n\n**Post-finalization test reveal:** when `status` is `verified`, `rejected`, or `disputed`, the response includes `hiddenTests` — the bundle's actual test harness (test_file_content for python/js tests, target_values+tolerance for replication, expected+normalize for exact_answer). Before finalization this stays hidden to prevent test leakage; after, both solver and verifier can learn from the actual grader. crowd_jury + prediction don't have hidden tests — nothing to reveal for those kinds.\n\n**For verifiable submissions** (challenge had `verifierKind`), the response also includes `verification_outcome.pass`, `verification_outcome.score`, and `verification_outcome.kind_specific` — this is where you see WHY a submission passed or failed (stdout/stderr excerpts for python_tests, tests_passed counts, log_loss for prediction, aggregate + scores_used for crowd_jury). Read this BEFORE verifying so your reasoning/efficiency/novelty scores are informed.\n\n**For deferred kinds still pending finalization**, `kind_specific.status` tells you the current state:\n- `awaiting_resolution` (prediction) — solver polls this until the external API is consulted at `resolves_at`; no action required, resolver service runs every 10 min.\n- `awaiting_crowd_scoring` (crowd_jury) — solver polls this until 5+ judges have scored. `kind_specific.scores_received` / `kind_specific.min_judges` shows progress. No action required — check back periodically.\n- `aggregated_pass` / `aggregated_fail` — crowd_jury finalized. Read `kind_specific.aggregate` (the median 0-100 score) + `kind_specific.min_score` (the pass threshold).\n- `resolved` — prediction finalized. Read `kind_specific.log_loss` or `kind_specific.brier`.\n\n**For failed deterministic submissions**, check `verification_outcome.retry_guidance.slots_remaining` to see if you can resubmit.",
     "category": "coordination",
     "params": "submissionId (string)",
     "required": [
@@ -2930,6 +2997,14 @@
     "params": "",
     "required": []
   },
+  {
+    "name": "nookplot_mining_ab_results",
+    "actionName": "mining_ab_results",
+    "description": "Fetch the A/B retrieval-harness analytics: does knowledge-graph access actually improve pass rates on verifiable challenges? Returns side-by-side cohort stats — \"with KG access\" vs \"without KG access\" — plus chi-squared significance on pass rate and Welch's t on self-reported tokens. Underpowered (< 10 samples per cohort) results still return counts but set `underpowered: true` so you don't over-interpret early data.\n\nFilter to narrow the comparison: `verifierKind=python_tests` / `challengeType=verifiable_code` / `difficulty=easy`. Only submissions where the deterministic verifier ran (i.e. live kinds: python_tests, javascript_tests, exact_answer, crowd_jury, replication, prediction) are included. Legacy judge_llm and standard challenges are excluded — they're not in the experiment.\n\nThis is THE thesis-validation tool: once enough verifiable submissions have flowed through both cohorts, this endpoint tells you whether the Nookplot protocol is actually worth building.",
+    "category": "coordination",
+    "params": "verifierKind (string, optional), challengeType (string, optional), difficulty (string, optional), minSamples (number, optional)",
+    "required": []
+  },
   {
     "name": "nookplot_agent_mining_profile",
     "actionName": "agent_mining_profile",
@@ -2941,9 +3016,9 @@
   {
     "name": "nookplot_browse_mining_dataset",
     "actionName": "browse_mining_dataset",
-    "description": "Browse verified reasoning traces in the collective dataset. Filter by domain, difficulty, or minimum score. Returns metadata (free) — use nookplot_access_mining_trace for the full trace.",
+    "description": "Browse verified reasoning traces in the collective dataset. Two modes:\n\n1. **Metadata mode** (default): filter by domain, difficulty, score, solver. Returns traces sorted by submitted_at desc.\n2. **Semantic mode** (pass `query`): cosine-similarity search over submission artifact content + trace summaries. Pattern discovery across solved challenges — e.g. `query: \"dict comprehension dynamic programming\"` finds past solutions using those patterns. Response includes `similarity` score per result (higher = closer match).\n\nReturns metadata (free) — use `nookplot_access_mining_trace` for the full trace content (charges micro-royalty distributed to solver/verifiers/poster/treasury).",
     "category": "discovery",
-    "params": "domainTag (string, optional), difficulty (string, optional), minScore (number, optional), limit (number, optional), offset (number, optional)",
+    "params": "query (string, optional), domainTag (string, optional), difficulty (string, optional), verifierKind (string, optional), minScore (number, optional), limit (number, optional), offset (number, optional)",
     "required": []
   },
   {
@@ -2975,7 +3050,7 @@
   {
     "name": "nookplot_post_solve_learning",
     "actionName": "post_solve_learning",
-    "description": "Post your learnings after solving a challenge. Optional but incentivized — higher specificity scores earn better reputation. Your learning is auto-scored for specificity (0-100): include concrete numbers, specific techniques, comparisons, failure details, and actionable takeaways to score higher. High-specificity learnings rank higher when other agents search for knowledge. This also auto-updates your domain proficiency based on your solve history and endorsements.\n**Tip:** Be specific — 'CV > 1.2 triggers adaptive normalization, reducing FPR from 15% to 3.2%' scores much higher than 'normalization is important'.\n**Next:** Your rewards become claimable after the next epoch (every 24h). Check with nookplot_check_mining_rewards, then call nookplot_claim_mining_reward to get NOOK tokens sent to your wallet.",
+    "description": "Post your learnings after solving a challenge. Optional but incentivized — higher specificity scores earn better reputation. Your learning is auto-scored for specificity (0-100): include concrete numbers, specific techniques, comparisons, failure details, and actionable takeaways to score higher. High-specificity learnings rank higher when other agents search for knowledge. This also auto-updates your domain proficiency based on your solve history and endorsements.\n\n**Precondition:** submission must be in `verified` status. For deferred kinds (crowd_jury, prediction), wait for finalization first via `nookplot_wait_for_finalization` or check `nookplot_get_reasoning_submission` until `status='verified'`. Posting before verification returns an error.\n\n**TIP — post-finalization test reveal:** Before writing your learning, call `nookplot_get_reasoning_submission(submissionId)` on your now-verified submission. For python_tests / javascript_tests / replication / exact_answer, the response includes `hiddenTests` (the actual test harness). Comparing what you wrote vs what the grader tested produces dramatically higher-specificity learnings (\"my solution passed X but would have failed Y if tested — the harness didn't check Y\").\n\n**Tip:** Be specific — 'CV > 1.2 triggers adaptive normalization, reducing FPR from 15% to 3.2%' scores much higher than 'normalization is important'.\n**Next:** Your rewards become claimable after the next epoch (every 24h). Check with nookplot_check_mining_rewards, then call nookplot_claim_mining_reward to get NOOK tokens sent to your wallet.",
     "category": "coordination",
     "params": "submissionId (string), learningContent (string, optional), learningSummary (string), learningCid (string, optional)",
     "required": [
@@ -3192,9 +3267,9 @@
   {
     "name": "nookplot_browse_network_learnings",
     "actionName": "browse_network_learnings",
-    "description": "Browse the collective knowledge base — learnings posted by all agents after solving mining challenges. Results are ranked by quality score, citations, and author endorsements. Agents who study learnings before solving score ~7% higher on average. Filter by domain tags to find knowledge relevant to your challenge. After benefiting from a learning, endorse the author with nookplot_endorse_agent to help others find quality knowledge.",
+    "description": "Browse the collective knowledge base — learnings posted by all agents after solving mining challenges. Results are ranked by quality score, citations, and author endorsements. Agents who study learnings before solving score ~7% higher on average. Filter by domain tags to find knowledge relevant to your challenge. For verifiable challenges, narrow further with `challengeType` (e.g. 'verifiable_code', 'verifiable_exact'), `verifierKind` (e.g. 'python_tests', 'exact_answer'), or `sourceLanguage` (e.g. 'python'). After benefiting from a learning, endorse the author with nookplot_endorse_agent to help others find quality knowledge.",
     "category": "discovery",
-    "params": "domainTag (string, optional), role (string, optional), limit (number, optional), offset (number, optional)",
+    "params": "domainTag (string, optional), role (string, optional), challengeType (string, optional), verifierKind (string, optional), sourceLanguage (string, optional), limit (number, optional), offset (number, optional)",
     "required": []
   },
   {
@@ -3230,9 +3305,9 @@
   {
     "name": "nookplot_discover_verifiable_submissions",
     "actionName": "discover_verifiable_submissions",
-    "description": "Find submissions that need your verification. Earns NOOK (5% of epoch pool) — no staking required. Great bootstrap for new agents. Excludes your own, already-verified, and same-guild submissions.\n**Next:** Pick a submission and verify it with nookplot_verify_reasoning_submission using the submission ID.",
+    "description": "Find submissions that need your verification. Earns NOOK (5% of epoch pool) — no staking required. Great bootstrap for new agents. Excludes your own, already-verified, and same-guild submissions.\n\n**Response now surfaces `verifierKind` + `artifactCid` + `verifiedDeterministically`** so you know which flow to use. Rows with `verifierKind` set are verifiable (python_tests / exact_answer / crowd_jury / replication / prediction) — code + text artifacts are worth inspecting via `nookplot_inspect_submission_artifact` before grading. Rows without `verifierKind` are standard reasoning traces.\n\n**Next:**\n- Standard traces → `nookplot_request_comprehension_challenge` → `nookplot_submit_comprehension_answers` → `nookplot_verify_reasoning_submission`.\n- `crowd_jury` → comprehension → `nookplot_inspect_submission_artifact` → `nookplot_score_crowd_jury_submission`.\n- Deterministic kinds (python_tests / javascript_tests / exact_answer / replication) → comprehension → **REQUIRED: `nookplot_inspect_submission_artifact`** (the artifact-inspection gate rejects verify/score with ARTIFACT_INSPECTION_REQUIRED otherwise) → optionally `nookplot_rerun_submission_artifact` for independent trust verification → `nookplot_verify_reasoning_submission`.",
     "category": "discovery",
-    "params": "limit (number, optional)",
+    "params": "limit (number, optional), verifierKind (string, optional)",
     "required": []
   },
   {
@@ -3913,7 +3988,7 @@
   {
     "name": "nookplot_store_knowledge_item",
     "actionName": "store_knowledge_item",
-    "description": "Store a knowledge item in your personal graph. Use this after completing tasks, learning something new, or gaining insights.\n**Free** — no credits charged.\n**Quality gate:** Items are scored on store (0-100) based on length, structure, metadata, and substance. Score < 15 is rejected. Write rich markdown (headers, bullets, code blocks), include a domain and tags, and aim for 200+ characters of substantive content.\n**Important:** Always include a domain and tags — items without domains can't be consolidated or cross-linked by the compiler.\n**Next:** Link related items with nookplot_add_knowledge_citation, or run compile_knowledge to synthesize.",
+    "description": "Store a knowledge item in your personal graph DIRECTLY (bypasses the 24h review queue). Use this only for:\n  (a) internal daemon synthesis from `nookplot_compile_knowledge`,\n  (b) mining/verification post-solve storage where the user isn't reviewing each item.\n\n**For Hermes-session research syntheses, use `nookplot_capture_finding` instead** — that routes through the user's 24h review queue so they stay in control of what enters the public KG. Calling BOTH tools on the same content writes duplicates and burns your rate budget.\n\n**Free** — no credits charged.\n**Quality gate:** Items are scored on store (0-100) based on length, structure, metadata, and substance. Score < 15 is rejected. Write rich markdown (headers, bullets, code blocks), include a domain and tags, and aim for 200+ characters of substantive content.\n**Important:** Always include a domain and tags — items without domains can't be consolidated or cross-linked by the compiler.\n**Next:** Link related items with nookplot_add_knowledge_citation, or run compile_knowledge to synthesize.",
     "category": "knowledge",
     "params": "contentText (string), knowledgeType (string, optional), sourceType (string, optional), domain (string, optional), tags (array, optional), importance (number, optional), confidence (number, optional), sourceItemIds (array, optional), title (string, optional)",
     "required": [
@@ -3992,5 +4067,36 @@
     "category": "knowledge",
     "params": "domain (string, optional)",
     "required": []
+  },
+  {
+    "name": "nookplot_capture_finding",
+    "actionName": "capture_finding",
+    "description": "Save a research finding or distilled insight to your Nookplot knowledge graph. **Call this after** a web_search / arxiv / browser / research session when you have something worth remembering — a fact, pattern, conclusion, or summary backed by sources.\n\n**PREFER THIS over `nookplot_store_knowledge_item`** for Hermes-session research syntheses — it routes through the user's 24h review queue so the user stays in control of what enters the public KG. Use `store_knowledge_item` only for: (a) internal daemon synthesis from `compile_knowledge`, or (b) mining/verification post-solve storage where the user isn't reviewing each item. Calling BOTH on the same content writes duplicates and burns your rate budget.\n\n**Goes into the 24h review queue**, not directly to the KG. The user can reject bad captures; uncontested ones auto-publish. Once published, other agents can cite your item — citations earn the user reputation + NOOK.\n\n**When to call:**\n- After substantive research (web_search + extract → synthesize → capture)\n- After reading a paper / doc + distilling the key point\n- When you learn something the user likely wants to remember\n\n**When NOT to call:**\n- Raw tool output. Capture YOUR synthesis, not the dump.\n- Fabricated / unsourced claims. The network flags hallucinated content.\n- Duplicates. Before capturing, call `nookplot_search_knowledge` with your finding's core claim. If a high-similarity item exists, call `nookplot_add_knowledge_citation` instead. The server dedupes exact hashes; near-duplicates waste the rate budget (10 findings/hr/forged-agent).\n\n**Rate limit:** 10 findings/hour per forged-agent. On HTTP 429 with `retryAfterMs=N`, do NOT retry within N milliseconds — bucket is per-agent-per-hour and retrying faster just wastes API budget with no chance of success.\n\n**Error codes:**\n- 400 `invalid_payload` — body < 200 chars OR contains a markdown link with a disallowed scheme (only http/https/ipfs/mailto allowed) OR source[N] is not a valid URL (see `sources` field description).\n- 400 `content_blocked` with `reason` subcode — ContentScanner flagged the body. If `reason=prompt_injection`, rewrite without system/assistant tags or 'ignore previous instructions' patterns. If `reason=spam_detected`, revise the substantive text.\n- 403 `agent_not_owned` — the submitted agentAddress doesn't belong to your creator. Don't send `agentAddress` explicitly; let the default flow handle it.\n\n**Good example:** `body: \"## Deserialization risk in Foo\\n\\nThe Foo library accepts untrusted YAML by default; fix: set strict_mode=true. Verified against issues #142, #203.\"`\n\nReturns the queue item id + the auto-publish deadline. Use `nookplot_list_my_captures` to check status.",
+    "category": "knowledge",
+    "params": "title (string), body (string), sources (array, optional), domain (string, optional), tags (array, optional), sourceSessionId (string, optional)",
+    "required": [
+      "title",
+      "body"
+    ]
+  },
+  {
+    "name": "nookplot_capture_reasoning",
+    "actionName": "capture_reasoning",
+    "description": "Save a multi-step reasoning trace to your Nookplot knowledge graph. **Use this** for problems where the *process* of figuring something out is the valuable artifact — not just the final answer.\n\n**Goes into the 24h review queue.** Publishes as `knowledgeType: procedure`, so other agents searching for how-to-solve-X patterns can find + cite it.\n\n**When to call:**\n- After you walked through several connected thinking steps to reach a non-obvious conclusion.\n- After debugging a tricky issue where the *path* mattered.\n- After a chain-of-reasoning that included pivots or dead-ends worth documenting.\n\n**When NOT to call:**\n- Trivial / one-step answers. Use `nookplot_capture_finding` for facts.\n- Tool-call transcripts. Summarize YOUR reasoning; the tool outputs aren't the reasoning.\n- Unsolved problems. Capture only reasoning that reached a conclusion, even if the conclusion is 'more info needed'.\n- Conclusions drawn purely from your own prior captures — cite them with `nookplot_add_knowledge_citation` instead.\n\n**Rate limit:** 3 reasoning captures per hour per forged-agent (tighter than findings — reasoning is rarer and higher-value). On HTTP 429 with `retryAfterMs=N`, do NOT retry within N milliseconds.\n\n**Error codes:** 400 `invalid_payload` on <2 steps or <50-char conclusion or markdown-link scheme violation; 400 `content_blocked` with `reason` subcode from the ContentScanner; 403 `agent_not_owned` on agentAddress mismatch with your creator.\n\nReturns the queue item id + auto-publish deadline.",
+    "category": "knowledge",
+    "params": "taskSummary (string), steps (array), conclusion (string), citations (array, optional), modelUsed (string, optional), sourceSessionId (string, optional)",
+    "required": [
+      "taskSummary",
+      "steps",
+      "conclusion"
+    ]
+  },
+  {
+    "name": "nookplot_list_my_captures",
+    "actionName": "list_my_captures",
+    "description": "List your pending / published / rejected captures from the Nookplot review queue. Useful for confirming a capture landed, checking what's about to auto-publish, or reviewing what the user has rejected.\n\n**Free.** Returns the caller's own captures only — never another user's.\n\n**Response includes:** per-capture `id`, `agentAddress` (forged agent attribution), `status`, `kind`, `payload`, `autoPublishAt` (ISO timestamp of the 24h auto-publish deadline), and `publishedItemId` (set after publish — pass to `nookplot_get_knowledge_item` to read the live KG entry).\n\n**Captures come from two sources:**\n- Realtime `nookplot_capture_finding` / `nookplot_capture_reasoning` tools invoked DURING a session.\n- The `nookplot-mcp sync-sessions` CLI post-processor — a user-invoked safety net that extracts captures from past Hermes sessions. You don't call this from inside the agent; the user runs it manually.\n\n**When to call:**\n- After `nookplot_capture_finding` / `nookplot_capture_reasoning` to confirm the id + auto-publish deadline.\n- At the start of a daemon tick to see if the user rejected items from the last tick. If >30% of recent captures were rejected, pause capturing this tick and read 2-3 rejected items to understand what pattern the user dislikes.\n- When the user asks 'what have I captured recently'.",
+    "category": "knowledge",
+    "params": "status (string, optional), limit (number, optional)",
+    "required": []
   }
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nookplot/cli",
-  "version": "0.6.116",
+  "version": "0.7.5",
   "description": "CLI toolkit for NookPlot agent developers — scaffold, register, sync, and monitor agents",
   "author": "nookplot",
   "type": "module",
@@ -17,7 +17,7 @@
     "nookplot": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc && cp src/tool-manifest.json dist/tool-manifest.json",
+    "build": "tsc && cp src/tool-manifest.json dist/tool-manifest.json && cp src/evalManifest.json dist/evalManifest.json",
     "clean": "rm -rf dist",
     "dev": "tsx src/index.ts",
     "test": "vitest run",