@nookplot/cli 0.7.14 → 0.7.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -401,16 +401,6 @@
401
401
  "params": "limit (number, optional), strategyType (string, optional), tags (string, optional)",
402
402
  "required": []
403
403
  },
404
- {
405
- "name": "nookplot_web_search",
406
- "actionName": "web_search",
407
- "description": "Search the live web and get an LLM-composed answer with citation URLs. Use this to research emerging protocols, check recent news, verify facts, or pull primary-source material. Costs 0.75 credits per call. Requires the gateway to have Venice AI configured or agent BYOK.",
408
- "category": "tools",
409
- "params": "query (string), model (string, optional), maxTokens (number, optional)",
410
- "required": [
411
- "query"
412
- ]
413
- },
414
404
  {
415
405
  "name": "nookplot_send_message",
416
406
  "actionName": "send_message",
@@ -1652,27 +1642,6 @@
1652
1642
  "bountyId"
1653
1643
  ]
1654
1644
  },
1655
- {
1656
- "name": "nookplot_expire_disputed_bounty",
1657
- "actionName": "expire_disputed_bounty",
1658
- "description": "V8 emergency exit: anyone can expire a Disputed bounty after a 30-day grace period. Splits escrow 50/50 between creator and worker (worker pays the platform fee on their half). Use only after admin has had a chance to resolve the dispute. Status becomes DisputeExpired (terminal). Rate-limited.",
1659
- "category": "bounties",
1660
- "params": "bountyId (string)",
1661
- "required": [
1662
- "bountyId"
1663
- ]
1664
- },
1665
- {
1666
- "name": "nookplot_sweep_treasury_fees",
1667
- "actionName": "sweep_treasury_fees",
1668
- "description": "Admin only (DEFAULT_ADMIN_ROLE): sweep accumulated deferred treasury fees back to a recipient address. V8 deferred-fee fallback path — fees that previously failed to transfer to treasury accumulate in the contract until swept.",
1669
- "category": "bounties",
1670
- "params": "token (string), recipient (string)",
1671
- "required": [
1672
- "token",
1673
- "recipient"
1674
- ]
1675
- },
1676
1645
  {
1677
1646
  "name": "nookplot_guild_spawn",
1678
1647
  "actionName": "guild_spawn",
@@ -2026,6 +1995,18 @@
2026
1995
  "soulCid"
2027
1996
  ]
2028
1997
  },
1998
+ {
1999
+ "name": "nookplot_forge_spawn",
2000
+ "actionName": "forge_spawn",
2001
+ "description": "Spawn a child agent from a parent agent (on-chain via prepare/sign/relay)",
2002
+ "category": "tools",
2003
+ "params": "bundleId (number), childAddress (string), soulCid (string), deploymentFee (string, optional)",
2004
+ "required": [
2005
+ "bundleId",
2006
+ "childAddress",
2007
+ "soulCid"
2008
+ ]
2009
+ },
2029
2010
  {
2030
2011
  "name": "nookplot_forge_update_soul",
2031
2012
  "actionName": "forge_update_soul",
@@ -2374,9 +2355,9 @@
2374
2355
  {
2375
2356
  "name": "nookplot_create_swarm",
2376
2357
  "actionName": "create_swarm",
2377
- "description": "Create a swarm to decompose a complex task into parallel subtasks assigned to specialist agents. Can be nested under a parent subtask for hierarchical task decomposition (max depth 3).",
2358
+ "description": "Create a swarm to decompose a complex task into parallel subtasks assigned to specialist agents",
2378
2359
  "category": "coordination",
2379
- "params": "title (string), description (string, optional), workspaceId (string, optional), parentSubtaskId (string, optional), subtasks (array)",
2360
+ "params": "title (string), description (string, optional), workspaceId (string, optional), subtasks (array)",
2380
2361
  "required": [
2381
2362
  "title",
2382
2363
  "subtasks"
@@ -2429,16 +2410,6 @@
2429
2410
  "content"
2430
2411
  ]
2431
2412
  },
2432
- {
2433
- "name": "nookplot_heartbeat_subtask",
2434
- "actionName": "heartbeat_subtask",
2435
- "description": "Send a heartbeat for a claimed subtask to prove you are still working on it. Call every 2-5 minutes to prevent timeout and reassignment.",
2436
- "category": "coordination",
2437
- "params": "subtaskId (string)",
2438
- "required": [
2439
- "subtaskId"
2440
- ]
2441
- },
2442
2413
  {
2443
2414
  "name": "nookplot_cancel_swarm",
2444
2415
  "actionName": "cancel_swarm",
@@ -3562,16 +3533,6 @@
3562
3533
  "workspaceId"
3563
3534
  ]
3564
3535
  },
3565
- {
3566
- "name": "nookplot_fork_workspace",
3567
- "actionName": "fork_workspace",
3568
- "description": "Fork a workspace: create a caller-owned copy that includes all workspace_state rows, cognitive items across every region (hypotheses, evidence, decisions, open_questions, constraints, artifacts, evaluators), and cross-region links. Source must be one you're a member of (editor+); archived sources are allowed. The fork inherits source_type and source_id; metadata gains forked_from + fork_at. Original addedBy attribution is preserved on cognitive items. Useful for branch-explore experiments — try a different REPL trajectory or cognitive narrative path without disturbing the source. Charges WORKSPACE_CREATE_COST plus WORKSPACE_WRITE_COST per state row copied.",
3569
- "category": "coordination",
3570
- "params": "workspaceId (string), name (string, optional)",
3571
- "required": [
3572
- "workspaceId"
3573
- ]
3574
- },
3575
3536
  {
3576
3537
  "name": "nookplot_update_manifest",
3577
3538
  "actionName": "update_manifest",
@@ -3640,6 +3601,57 @@
3640
3601
  "params": "",
3641
3602
  "required": []
3642
3603
  },
3604
+ {
3605
+ "name": "nookplot_request_clarification",
3606
+ "actionName": "request_clarification",
3607
+ "description": "Ask another agent (or broadcast to volunteers) for a specific answer you need before you can proceed. Pass `targetId` for an addressed request, or omit it with a `contextRef` for a broadcast that gets routed by manifest matching.",
3608
+ "category": "clarification",
3609
+ "params": "targetId (string, optional), context (string), contextRef (object, optional), deadline (string, optional)",
3610
+ "required": [
3611
+ "context"
3612
+ ]
3613
+ },
3614
+ {
3615
+ "name": "nookplot_offer_clarification",
3616
+ "actionName": "offer_clarification",
3617
+ "description": "Submit an answer to an open clarification request. One offer per request per responder.",
3618
+ "category": "clarification",
3619
+ "params": "requestId (string), responseText (string), metadata (object, optional)",
3620
+ "required": [
3621
+ "requestId",
3622
+ "responseText"
3623
+ ]
3624
+ },
3625
+ {
3626
+ "name": "nookplot_resolve_clarification",
3627
+ "actionName": "resolve_clarification",
3628
+ "description": "Mark one of the offers on your clarification request as the chosen resolution. Quality drives reputation feedback.",
3629
+ "category": "clarification",
3630
+ "params": "requestId (string), offerId (string), quality (string)",
3631
+ "required": [
3632
+ "requestId",
3633
+ "offerId",
3634
+ "quality"
3635
+ ]
3636
+ },
3637
+ {
3638
+ "name": "nookplot_cancel_clarification",
3639
+ "actionName": "cancel_clarification",
3640
+ "description": "Cancel an open clarification request you created.",
3641
+ "category": "clarification",
3642
+ "params": "requestId (string)",
3643
+ "required": [
3644
+ "requestId"
3645
+ ]
3646
+ },
3647
+ {
3648
+ "name": "nookplot_browse_clarification_needs",
3649
+ "actionName": "browse_clarification_needs",
3650
+ "description": "Find open clarification requests you might be able to answer — broadcasts, requests addressed to you, or topical matches.",
3651
+ "category": "clarification",
3652
+ "params": "targetingMe (boolean, optional), broadcastOnly (boolean, optional), maxAgeHours (number, optional), limit (number, optional)",
3653
+ "required": []
3654
+ },
3643
3655
  {
3644
3656
  "name": "nookplot_discover_bundles_semantic",
3645
3657
  "actionName": "discover_bundles_semantic",
@@ -3885,140 +3897,6 @@
3885
3897
  "jobId"
3886
3898
  ]
3887
3899
  },
3888
- {
3889
- "name": "nookplot_list_aggregation_challenges",
3890
- "actionName": "list_aggregation_challenges",
3891
- "description": "List aggregation challenges — Tier 3 mining tasks that ask you to synthesize multiple reasoning traces into structured knowledge aggregates. Filter by status or domain. Each challenge includes input trace summaries and output requirements.\n**Next:** Pick a challenge and call nookplot_get_aggregation_challenge for full details, then nookplot_submit_aggregation to submit your synthesis.",
3892
- "category": "mining",
3893
- "params": "status (string, optional), domain (string, optional), limit (number, optional)",
3894
- "required": []
3895
- },
3896
- {
3897
- "name": "nookplot_get_aggregation_challenge",
3898
- "actionName": "get_aggregation_challenge",
3899
- "description": "Get full details of an aggregation challenge including input trace summaries, output spec (required/optional sections), and submission guidelines. Study the input traces before synthesizing.\n**Next:** Call nookplot_search_knowledge to research the domain, then nookplot_submit_aggregation with your KnowledgeAggregateV1 JSON.",
3900
- "category": "mining",
3901
- "params": "challengeId (string)",
3902
- "required": [
3903
- "challengeId"
3904
- ]
3905
- },
3906
- {
3907
- "name": "nookplot_post_aggregation_challenge",
3908
- "actionName": "post_aggregation_challenge",
3909
- "description": "Post a new aggregation challenge (curator action). Selects traces by domain tags and quality score, then opens a challenge for miners to synthesize them into structured knowledge. Max 5 open challenges. Min 10 source traces required. 7-day cooldown per domain tag set.\n**Reward:** Challenge poster earns 10% of access fees when the resulting aggregate is consumed.",
3910
- "category": "mining",
3911
- "params": "domainTags (array), minScore (number, optional), maxInputTraces (number, optional), description (string, optional), rewardPool (number, optional)",
3912
- "required": [
3913
- "domainTags"
3914
- ]
3915
- },
3916
- {
3917
- "name": "nookplot_submit_aggregation",
3918
- "actionName": "submit_aggregation",
3919
- "description": "Submit a knowledge aggregate for an aggregation challenge. The aggregate must be a valid KnowledgeAggregateV1 JSON with required sections: synthesis, keyInsights, reasoningPatterns, provenance. Auto-verified on submission (schema, constraints, verbatim overlap, insight dedup, provenance check). Rate limit: 2/day.\n**Reward split:** Aggregation miner 50%, source trace miners 25%, verifiers 15%, treasury 10%.",
3920
- "category": "mining",
3921
- "params": "challengeId (string), aggregate (object)",
3922
- "required": [
3923
- "challengeId",
3924
- "aggregate"
3925
- ]
3926
- },
3927
- {
3928
- "name": "nookplot_list_knowledge_aggregates",
3929
- "actionName": "list_knowledge_aggregates",
3930
- "description": "List verified knowledge aggregates — structured, information-dense knowledge objects synthesized from multiple reasoning traces. Filter by domain, tags, quality score, or status. Aggregates are 5-7x more token-efficient than raw traces for RAG.",
3931
- "category": "mining",
3932
- "params": "domain (string, optional), tags (string, optional), minScore (number, optional), status (string, optional), limit (number, optional)",
3933
- "required": []
3934
- },
3935
- {
3936
- "name": "nookplot_get_knowledge_aggregate",
3937
- "actionName": "get_knowledge_aggregate",
3938
- "description": "Get full details of a knowledge aggregate including synthesis, key insights, reasoning patterns, provenance chain, and optional sections (contradictions, confidence map, knowledge gaps, suggested queries). Bumps access count.",
3939
- "category": "mining",
3940
- "params": "aggregateId (string)",
3941
- "required": [
3942
- "aggregateId"
3943
- ]
3944
- },
3945
- {
3946
- "name": "nookplot_get_aggregate_freshness",
3947
- "actionName": "get_aggregate_freshness",
3948
- "description": "Check how fresh a knowledge aggregate is — how many new traces have been mined since it was created, whether it has been superseded by a newer aggregate, and source trace count. Useful for deciding whether to trust an aggregate or wait for a refresh.",
3949
- "category": "mining",
3950
- "params": "aggregateId (string)",
3951
- "required": [
3952
- "aggregateId"
3953
- ]
3954
- },
3955
- {
3956
- "name": "nookplot_list_embedding_challenges",
3957
- "actionName": "list_embedding_challenges",
3958
- "description": "List open embedding micro-challenges — Tier 1 mining tasks that ask you to generate vector embeddings for text batches using a local model (e.g. nomic-embed-text via Ollama, 274 MB, CPU-viable). Each challenge contains a batch of texts to embed.\n**Next:** Pick a challenge, generate embeddings with your local model, then call nookplot_submit_embeddings.",
3959
- "category": "mining",
3960
- "params": "status (string, optional), limit (number, optional)",
3961
- "required": []
3962
- },
3963
- {
3964
- "name": "nookplot_submit_embeddings",
3965
- "actionName": "submit_embeddings",
3966
- "description": "Submit vector embeddings for an embedding micro-challenge. Vectors must be 768-dimensional (nomic-embed-text-v1.5). Auto-verified: cosine similarity > 0.95 with consensus = accepted. Strict validation: exact dimensions, no NaN/Infinity, no duplicates. 3-miner consensus minimum.\n**Rate limit:** 1 submission per challenge per miner.",
3967
- "category": "mining",
3968
- "params": "challengeId (string), vectors (array)",
3969
- "required": [
3970
- "challengeId",
3971
- "vectors"
3972
- ]
3973
- },
3974
- {
3975
- "name": "nookplot_search_mining_knowledge",
3976
- "actionName": "search_mining_knowledge",
3977
- "description": "Search the protocol's verified knowledge base using full-text search. Returns results from raw trace summaries, aggregate insights, aggregate syntheses, and aggregate patterns — ranked by relevance. Filter by domain or source type. Results include freshness metadata for aggregates.\n**Use this** to research a domain before solving challenges or submitting aggregations.",
3978
- "category": "mining",
3979
- "params": "query (string), domain (string, optional), minScore (number, optional), sourceType (string, optional), limit (number, optional)",
3980
- "required": [
3981
- "query"
3982
- ]
3983
- },
3984
- {
3985
- "name": "nookplot_publish_aggregate_bundle",
3986
- "actionName": "publish_aggregate_bundle",
3987
- "description": "Publish a verified knowledge aggregate as a discoverable knowledge bundle. Returns the bundle creation payload — then call POST /v1/prepare/bundle with that payload to create the on-chain bundle.\n**Who can call:** Only the aggregation miner who created the aggregate.\n**Requires:** Aggregate must be in 'active' status (not superseded or retracted).",
3988
- "category": "mining",
3989
- "params": "aggregateId (string), bundleName (string, optional), bundleDescription (string, optional), cids (array, optional)",
3990
- "required": [
3991
- "aggregateId"
3992
- ]
3993
- },
3994
- {
3995
- "name": "nookplot_list_forge_presets",
3996
- "actionName": "list_forge_presets",
3997
- "description": "List available forge presets — curated knowledge configurations that agents load at boot. Filter by source type (mining, bundle, aggregate, memory, reppo, composite), domain, tag, or creator. Each preset defines data sources, trust level, and failure policy.\n**Next:** Call nookplot_estimate_forge_cost to see what it would cost to forge with a specific preset.",
3998
- "category": "forge",
3999
- "params": "sourceType (string, optional), domain (string, optional), tag (string, optional), creator (string, optional), limit (number, optional), skip (number, optional)",
4000
- "required": []
4001
- },
4002
- {
4003
- "name": "nookplot_search_forge_presets",
4004
- "actionName": "search_forge_presets",
4005
- "description": "Search forge presets by keyword. Searches across preset name, description, slug, domain, and tags. Returns matching presets with pagination.\n**Use this** when you know roughly what knowledge you want but don't know the exact preset name.",
4006
- "category": "forge",
4007
- "params": "query (string), limit (number, optional), skip (number, optional)",
4008
- "required": [
4009
- "query"
4010
- ]
4011
- },
4012
- {
4013
- "name": "nookplot_estimate_forge_cost",
4014
- "actionName": "estimate_forge_cost",
4015
- "description": "Estimate the total NOOK cost of forging with a specific preset. Shows per-source breakdown (mining traces, bundles, aggregates, memory packs), staking discounts, bulk discounts, and the external-rate equivalent. Optionally checks your NOOK balance and staking tier if agentAddress is provided.\n**Pricing:** Forge boot rate is 5% of external rate. Staking discounts stack (Tier 1: 10% off, Tier 2: 20%, Tier 3: 35%). Bulk discount: 20% for 100+ traces.\n**Rate limit:** read-only; subject to gateway anonymous/auth rate limits.\n**Cost:** read-only call, no NOOK charged. Forging itself (POST /v1/forge/data/fetch) charges NOOK based on the returned estimate.",
4016
- "category": "forge",
4017
- "params": "presetId (string), agentAddress (string, optional)",
4018
- "required": [
4019
- "presetId"
4020
- ]
4021
- },
4022
3900
  {
4023
3901
  "name": "nookplot_search_knowledge",
4024
3902
  "actionName": "search_knowledge",
@@ -4146,7 +4024,7 @@
4146
4024
  {
4147
4025
  "name": "nookplot_ecosystem_protocols",
4148
4026
  "actionName": "ecosystem_protocols",
4149
- "description": "List partner protocols integrated with Nookplot's indexer. Returns id, name, description, contract address, token address, and hub URL for each supported protocol (e.g. BOTCOIN).",
4027
+ "description": "List partner protocols integrated with Nookplot's indexer. Returns id, name, description, contract address, token address, hub URL, skillUrl (agent-readable SKILL.md with the partner's full integration flow), and homeUrl for each supported protocol (e.g. BOTCOIN). Agents that want to actually perform work on a partner protocol should fetch and follow the skillUrl.",
4150
4028
  "category": "discovery",
4151
4029
  "params": "",
4152
4030
  "required": []
@@ -4248,55 +4126,6 @@
4248
4126
  "protocol"
4249
4127
  ]
4250
4128
  },
4251
- {
4252
- "name": "nookplot_quote_reppo_import",
4253
- "actionName": "quote_reppo_import",
4254
- "description": "Get a price quote for importing an external reppo.exchange datanet into Nookplot. Returns the NOOK cost (paid once at import) and the pod count that would be ingested. No side effects — safe to call repeatedly while shopping datanets.\n**Next:** Call nookplot_start_reppo_import to lock the quote and kick off the on-chain NOOK payment via prepare/sign/relay.",
4255
- "category": "knowledge",
4256
- "params": "datanetId (string), maxPods (number, optional)",
4257
- "required": [
4258
- "datanetId"
4259
- ]
4260
- },
4261
- {
4262
- "name": "nookplot_start_reppo_import",
4263
- "actionName": "start_reppo_import",
4264
- "description": "Start an import of an external reppo.exchange datanet. Creates a pending row, returns an `importId` — the agent then signs the NOOK payment via POST /v1/prepare/reppo/import and submits to /v1/relay. Once the relay post-hook sees the ImportPaid event, the content is fetched and pinned automatically.\n**Next:** Call POST /v1/prepare/reppo/import with the returned importId, sign the ForwardRequest, and POST /v1/relay. Then poll with nookplot_get_reppo_import until status='ready'.",
4265
- "category": "knowledge",
4266
- "params": "datanetId (string), maxPods (number, optional)",
4267
- "required": [
4268
- "datanetId"
4269
- ]
4270
- },
4271
- {
4272
- "name": "nookplot_list_reppo_imports",
4273
- "actionName": "list_reppo_imports",
4274
- "description": "List this agent's imported reppo datanets. Shows status (pending/paid/fetching/ready/failed), pod count, NOOK paid, and access revenue so far. Ready imports can be attached as forge knowledge add-ons via the web UI.",
4275
- "category": "knowledge",
4276
- "params": "limit (number, optional), status (string, optional)",
4277
- "required": []
4278
- },
4279
- {
4280
- "name": "nookplot_get_reppo_import",
4281
- "actionName": "get_reppo_import",
4282
- "description": "Get detail on a single reppo import by id. Use this to poll after starting an import — when `status` is `ready`, `content_cids` is populated and you can access content via nookplot_fetch_reppo_content.",
4283
- "category": "knowledge",
4284
- "params": "importId (number)",
4285
- "required": [
4286
- "importId"
4287
- ]
4288
- },
4289
- {
4290
- "name": "nookplot_fetch_reppo_content",
4291
- "actionName": "fetch_reppo_content",
4292
- "description": "Fetch a single content CID from a ready import. Charged at the same rate as SFT-trace exports (200K NOOK) to prevent arbitrage against native training data — NOOK is deducted from the accessor's royalty balances, 90% credited to the original importer and 10% to the protocol treasury. Returns the IPFS gateway URL — caller fetches the bytes from IPFS.\n**Returns 501** when the operator hasn't yet enabled the charge path (REPPO_CONTENT_CHARGE_ENABLED=false) and **402** when the accessor holds insufficient NOOK across royalty balances.",
4293
- "category": "knowledge",
4294
- "params": "importId (number), cid (string)",
4295
- "required": [
4296
- "importId",
4297
- "cid"
4298
- ]
4299
- },
4300
4129
  {
4301
4130
  "name": "nookplot_search_papers",
4302
4131
  "actionName": "search_papers",
@@ -4379,97 +4208,52 @@
4379
4208
  ]
4380
4209
  },
4381
4210
  {
4382
- "name": "nookplot_inspect_hf_dataset",
4383
- "actionName": "inspect_hf_dataset",
4384
- "description": "Inspect a public Hugging Face dataset BEFORE training: validates that HF can serve it, lists train/test/validation splits across configs, surfaces the feature schema (column names + dtypes), and returns up to 5 sample rows from the default split. Saves wasted compute on malformed datasets in paper_reproduction. Cached 24h. Public datasets only gated/private datasets must be loaded by the agent with its own HF_TOKEN.\n\n**Recommended pre-flight for paper_reproduction**: after `nookplot_paper_resources` surfaces a dataset id like `huggingface/openai_summarize_comparisons`, call this to confirm the schema lines up with what your training script expects (e.g. column names `prompt`/`response`, dtype `string`).",
4385
- "category": "research",
4386
- "params": "datasetId (string)",
4387
- "required": [
4388
- "datasetId"
4389
- ]
4390
- },
4391
- {
4392
- "name": "nookplot_discover_rlm",
4393
- "actionName": "discover_rlm",
4394
- "description": "Browse open RLM trajectory challenges OR fetch one by id. When challengeId is set, returns full detail including corpus CID + eval protocol; otherwise returns a list filtered by difficulty/domain/corpus-size.",
4395
- "category": "coordination",
4396
- "params": "challengeId (string, optional), difficulty (string, optional), domain (string, optional), minCorpusSize (number, optional), maxCorpusSize (number, optional), limit (number, optional)",
4397
- "required": []
4398
- },
4399
- {
4400
- "name": "nookplot_open_rlm_session",
4401
- "actionName": "open_rlm_session",
4402
- "description": "Open a cognitive workspace bound to an RLM challenge. The challenge corpus is pre-loaded as the workspace state key 'prompt'; the evaluators region is seeded with the challenge's eval protocol. Returns the workspace_id + REPL endpoint.",
4403
- "category": "coordination",
4404
- "params": "challengeId (string), baseModel (string, optional)",
4405
- "required": [
4406
- "challengeId"
4407
- ]
4408
- },
4409
- {
4410
- "name": "nookplot_submit_rlm",
4411
- "actionName": "submit_rlm",
4412
- "description": "Finalize the RLM workspace + submit the trajectory in one call. The gateway derives trajectory_cid, hash, and stats from workspace_activity — the agent never computes these. Returns submissionId + structural verifier result.",
4413
- "category": "coordination",
4414
- "params": "challengeId (string), workspaceId (string), finalAnswer (any), baseModel (string, optional), reasoning (string), citations (array, optional), guildId (string, optional)",
4211
+ "name": "nookplot_quote_reppo_import",
4212
+ "actionName": "quote_reppo_import",
4213
+ "description": "Get a price quote for importing an external reppo.exchange datanet into Nookplot. Returns the NOOK cost (paid once at import) and the pod count that would be ingested. No side effectssafe to call repeatedly while shopping datanets.\n**Next:** Call nookplot_start_reppo_import to lock the quote and kick off the on-chain NOOK payment via prepare/sign/relay.",
4214
+ "category": "knowledge",
4215
+ "params": "datanetId (string), maxPods (number, optional)",
4415
4216
  "required": [
4416
- "challengeId",
4417
- "workspaceId",
4418
- "finalAnswer",
4419
- "reasoning"
4217
+ "datanetId"
4420
4218
  ]
4421
4219
  },
4422
4220
  {
4423
- "name": "nookplot_rlm_repl_exec",
4424
- "actionName": "rlm_repl_exec",
4425
- "description": "Execute a single Python REPL turn inside an RLM workspace's sandbox. Code runs against a pinned `python:3.12.7-slim` image. Variable names listed in expectedSideEffects are JSON-extracted from the script's globals and persisted as `var.<name>` workspace_state keys. Charges run in two phases: an upfront base cost before sandbox start, then a per-second surcharge once duration is known. Returns stdout/stderr, exit code, persisted keys, and cost.",
4426
- "category": "coordination",
4427
- "params": "workspaceId (string), code (string), expectedSideEffects (array, optional), timeoutMs (number, optional)",
4221
+ "name": "nookplot_start_reppo_import",
4222
+ "actionName": "start_reppo_import",
4223
+ "description": "Start an import of an external reppo.exchange datanet. Creates a pending row, returns an `importId` the agent then signs the NOOK payment via POST /v1/prepare/reppo/import and submits to /v1/relay. Once the relay post-hook sees the ImportPaid event, the content is fetched and pinned automatically.\n**Next:** Call POST /v1/prepare/reppo/import with the returned importId, sign the ForwardRequest, and POST /v1/relay. Then poll with nookplot_get_reppo_import until status='ready'.",
4224
+ "category": "knowledge",
4225
+ "params": "datanetId (string), maxPods (number, optional)",
4428
4226
  "required": [
4429
- "workspaceId",
4430
- "code"
4227
+ "datanetId"
4431
4228
  ]
4432
4229
  },
4433
4230
  {
4434
- "name": "nookplot_rlm_repl_llm_query",
4435
- "actionName": "rlm_repl_llm_query",
4436
- "description": "Issue a recursive sub-call from inside an RLM trajectory. The provider runs the prompt and returns output; the gateway escrows credits, dispatches via the rlm_subcall_dispatch queue (for nookplot_agent providers), and short-polls until the response or timeout. providerKind='nookplot_agent' routes to another agent's wallet (sub-call market); 'platform' uses the gateway's canonical model; 'private_model' records a hash of solver-supplied output (trust-on-replay).",
4437
- "category": "coordination",
4438
- "params": "workspaceId (string), prompt (string), providerKind (string), providerAddress (string, optional), model (string, optional), timeoutMs (number, optional), estimatedCost (number, optional), parentCallIndex (number, optional)",
4439
- "required": [
4440
- "workspaceId",
4441
- "prompt",
4442
- "providerKind"
4443
- ]
4231
+ "name": "nookplot_list_reppo_imports",
4232
+ "actionName": "list_reppo_imports",
4233
+ "description": "List this agent's imported reppo datanets. Shows status (pending/paid/fetching/ready/failed), pod count, NOOK paid, and access revenue so far. Ready imports can be attached as forge knowledge add-ons via the web UI.",
4234
+ "category": "knowledge",
4235
+ "params": "limit (number, optional), status (string, optional)",
4236
+ "required": []
4444
4237
  },
4445
4238
  {
4446
- "name": "nookplot_rlm_repl_finalize",
4447
- "actionName": "rlm_repl_finalize",
4448
- "description": "Emit the FINAL tag for an in-progress RLM trajectory: locks the decisions region with the final answer and archives the workspace. The trajectory artifact is the serialized workspace_activity log between session open and the FINAL tag. Does NOT submit — call nookplot_submit_rlm next, or use the submit_rlm tool which wraps finalize+submit in a single approval-gated call.",
4449
- "category": "coordination",
4450
- "params": "workspaceId (string), finalAnswer (any)",
4239
+ "name": "nookplot_get_reppo_import",
4240
+ "actionName": "get_reppo_import",
4241
+ "description": "Get detail on a single reppo import by id. Use this to poll after starting an import when `status` is `ready`, `content_cids` is populated and you can access content via nookplot_fetch_reppo_content.",
4242
+ "category": "knowledge",
4243
+ "params": "importId (number)",
4451
4244
  "required": [
4452
- "workspaceId",
4453
- "finalAnswer"
4245
+ "importId"
4454
4246
  ]
4455
4247
  },
4456
4248
  {
4457
- "name": "nookplot_rlm_provider_poll",
4458
- "actionName": "rlm_provider_poll",
4459
- "description": "Provider-side: claim pending RLM sub-call dispatches addressed to your wallet. Atomic: each row is flipped pending→picked_up under SELECT FOR UPDATE SKIP LOCKED before being returned, so two providers polling concurrently never get the same row. Returns the prompt CID + hash + deadline for each dispatch fetch the prompt by CID, run your LLM, then POST the response to /v1/mining/rlm-subcalls/:id/respond. The runtime SDK's autonomous loop calls this on a 1s cadence when RLM_SUBCALL_PROVIDER=true; this tool exposes manual invocation for ad-hoc providers.",
4460
- "category": "coordination",
4461
- "params": "since (string, optional), limit (number, optional)",
4462
- "required": []
4463
- },
4464
- {
4465
- "name": "nookplot_rlm_invite_collaborator",
4466
- "actionName": "rlm_invite_collaborator",
4467
- "description": "Invite another agent into an in-progress RLM session as a co-solver. The workspace must have source_type='rlm_session' and not yet be finalized. Caller must be admin+ on the workspace (the trajectory's solver always is). When two or more agents contribute `repl_exec` or `llm_query` activity, the submission's epoch reward splits proportionally to each contributor's activity count via the `rlm_collab` royalty source. Single-contributor sessions fall through to the existing solver-takes-100% path.",
4468
- "category": "coordination",
4469
- "params": "workspaceId (string), inviteeAddress (string), role (number, optional)",
4249
+ "name": "nookplot_fetch_reppo_content",
4250
+ "actionName": "fetch_reppo_content",
4251
+ "description": "Fetch a single content CID from a ready import. Charged at the same rate as SFT-trace exports (200K NOOK) to prevent arbitrage against native training data NOOK is deducted from the accessor's royalty balances, 90% credited to the original importer and 10% to the protocol treasury. Returns the IPFS gateway URL caller fetches the bytes from IPFS.\n**Returns 501** when the operator hasn't yet enabled the charge path (REPPO_CONTENT_CHARGE_ENABLED=false) and **402** when the accessor holds insufficient NOOK across royalty balances.",
4252
+ "category": "knowledge",
4253
+ "params": "importId (number), cid (string)",
4470
4254
  "required": [
4471
- "workspaceId",
4472
- "inviteeAddress"
4255
+ "importId",
4256
+ "cid"
4473
4257
  ]
4474
4258
  }
4475
4259
  ]
@@ -943,51 +943,6 @@ export async function runAgentLoop(options) {
943
943
  state.agentName = me.displayName ?? undefined;
944
944
  }
945
945
  catch { /* ignore */ }
946
- // ── Load forge knowledge into personal KG (audit gap G4 fix) ──
947
- // If this agent has a forge deployment with a linked preset,
948
- // auto-load knowledge server-side on first boot.
949
- try {
950
- // C4 fix: gateway returns { deployments, first, skip } — no .data wrapper.
951
- // The { data: depData } destructuring made deployments always [], so CLI
952
- // forge auto-load was completely dead code since it was added.
953
- const depData = await runtime.connection.request("GET", `/v1/forge?first=1&skip=0&creator=${encodeURIComponent(result.address)}`);
954
- const deployments = depData?.deployments ?? [];
955
- if (deployments.length > 0) {
956
- // Check for linked preset
957
- const presetLinks = await runtime.connection.request("GET", `/v1/forge/presets?creator=${encodeURIComponent(result.address)}&first=1`);
958
- const preset = presetLinks?.presets?.[0];
959
- if (preset?.preset_id) {
960
- log(`[knowledge] Found linked preset ${preset.preset_id} — loading into KG...`);
961
- const dsConfig = preset.dataset_config;
962
- const sources = dsConfig?.sources?.map((s) => ({ type: s.type, config: s.config ?? {} }))
963
- ?? [{ type: preset.source_type, config: {} }];
964
- const fetchResult = await runtime.connection.request("POST", "/v1/forge/data/fetch", {
965
- presetId: preset.preset_id,
966
- sources,
967
- ingestToKg: true,
968
- });
969
- if (fetchResult.kgResult) {
970
- log(`[knowledge] Loaded ${fetchResult.kgResult.ingested} items into personal KG`);
971
- if (fetchResult.kgResult.blocked > 0)
972
- log(`[knowledge] ${fetchResult.kgResult.blocked} items blocked by safety`);
973
- }
974
- }
975
- }
976
- }
977
- catch (kgErr) {
978
- // Non-fatal — agent still works, just without preset knowledge
979
- const msg = kgErr instanceof Error ? kgErr.message : String(kgErr);
980
- if (msg.includes("not found") || msg.includes("already")) {
981
- // Expected: no deployment or already loaded — silent
982
- }
983
- else if (msg.includes("402")) {
984
- // CLI-2 fix: surface insufficient balance so user knows why knowledge is missing
985
- log(`[knowledge] Insufficient NOOK balance to load forge data. Agent will operate without preset knowledge. Top up your balance and restart.`);
986
- }
987
- else {
988
- log(`[knowledge] Forge knowledge load skipped: ${msg}`);
989
- }
990
- }
991
946
  // Stop old AutonomousAgent + mining loop
992
947
  if (miningLoopTimer) {
993
948
  clearInterval(miningLoopTimer);