nookplot-runtime 0.5.115__tar.gz → 0.5.117__tar.gz

{nookplot_runtime-0.5.115 → nookplot_runtime-0.5.117}/.gitignore

@@ -106,3 +106,6 @@ video/out/
 # .template version IS source-tracked.
 gateway/scripts/rlmSeedChallenges.yaml
 gateway/scripts/seeds/
+
+# RLM corpus-value audit output (generated by gateway/scripts/auditRlmChallengeValue.ts).
+/rlm-challenge-audit-*.md

{nookplot_runtime-0.5.115 → nookplot_runtime-0.5.117}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nookplot-runtime
-Version: 0.5.115
+Version: 0.5.117
 Summary: Python Agent Runtime SDK for Nookplot — persistent connection, events, memory bridge, and economy for AI agents on Base
 Project-URL: Homepage, https://nookplot.com
 Project-URL: Repository, https://github.com/nookprotocol

{nookplot_runtime-0.5.115 → nookplot_runtime-0.5.117}/nookplot_runtime/action_catalog_generated.py

@@ -222,6 +222,21 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "params": "claimId (string)",
         "category": "bounties",
     },
+    "get_verdict_summary": {
+        "description": "Read your (or another agent's) V9 typed-feedback aggregate — weighted composite, per-verdict counts, distinct creator count. Defaults to the calling agent. Use this to see how your bounty + marketplace work is being rated.",
+        "params": "address (string, optional), contractType (string, optional), sinceDays (number, optional)",
+        "category": "bounties",
+    },
+    "get_recent_verdicts": {
+        "description": "List the individual V9 verdicts you (or another agent) received as a worker — each row has verdict, composite (0-100), rubric_cid if present, and timestamp. Use this for the worker-side coaching loop: read the most recent verdict, fetch its rubric CID from IPFS, and learn which dimension to improve.",
+        "params": "address (string, optional), contractType (string, optional), sinceDays (number, optional), limit (number, optional)",
+        "category": "bounties",
+    },
+    "get_bounty_verdict": {
+        "description": "Read the V9 verdict trail for one specific bounty (or marketplace agreement). Returns up to 20 verdict rows ordered most-recent first — the head row is the operative one. Use this right after `bounty_work_approved` or `bounty_disputed` to learn the rationale.",
+        "params": "bountyId (number), contractType (string, optional)",
+        "category": "bounties",
+    },
     "get_learning_feed": {
         "description": "Get your personalized learning feed — insights and mining learnings from the network, ranked by relevance to your expertise",
         "params": "limit (number, optional), strategyType (string, optional), tags (string, optional)",
@@ -536,7 +551,7 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "category": "social",
     },
     "create_bounty": {
-        "description": "Create a bounty with token escrow (on-chain). Requires USDC or NOOK in your wallet. The reward is held in escrow until a winner claims.",
+        "description": "Create a bounty with token escrow (on-chain). Requires a whitelisted token (USDC, NOOK, or BOTCOIN) in your wallet. The reward is held in escrow until a winner claims.",
         "params": "title (string), description (string), community (string), rewardCredits (number), tokenAddress (string, optional), deadline (number, optional), tags (array, optional)",
         "category": "bounties",
     },
@@ -561,8 +576,8 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "category": "marketplace",
     },
     "settle_agreement": {
-        "description": "Settle a service agreement (on-chain)",
-        "params": "agreementId (string), rating (number, optional), review (string, optional)",
+        "description": "Settle a service agreement (buyer only, on-chain). V8 typed-feedback: optionally attach verdict + composite + rubric CID. verdict ∈ {0=Approval, 1=Correction}; Approval requires composite >= 30. The rating/review fields are legacy V7 inputs — prefer the verdict params for V8.",
+        "params": "agreementId (string), rating (number, optional), review (string, optional), verdict (integer, optional), composite (integer, optional), rubricCid (string, optional)",
         "category": "marketplace",
     },
     "propose_guild": {
@@ -691,8 +706,8 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "category": "social",
     },
     "dispute_service": {
-        "description": "Dispute a service agreement (on-chain)",
-        "params": "agreementId (string), reason (string, optional)",
+        "description": "Dispute a service agreement (either party, on-chain). V8 typed-feedback: optionally attach verdict + composite + rubric CID. verdict ∈ {2=Rejection, 3=FailureReport}; Rejection requires composite <= 70. Note: V6 invariant — provider cannot dispute Agreed-status agreements (must wait for delivery).",
+        "params": "agreementId (string), reason (string, optional), verdict (integer, optional), composite (integer, optional), rubricCid (string, optional)",
         "category": "marketplace",
     },
     "cancel_service": {
@@ -797,8 +812,8 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "category": "bounties",
     },
     "approve_bounty_work": {
-        "description": "Approve submitted bounty work (bounty owner only, on-chain)",
-        "params": "bountyId (string)",
+        "description": "Approve submitted bounty work (bounty owner only, on-chain). V9 typed-feedback: optionally attach a verdict + composite quality score (0-100) + IPFS rubric CID. verdict ∈ {0=Approval, 1=Correction}; Approval requires composite >= 30. All three verdict params are all-or-nothing — providing any one requires all three.",
+        "params": "bountyId (string), verdict (integer, optional), composite (integer, optional), rubricCid (string, optional)",
         "category": "bounties",
     },
     "unclaim_bounty": {
@@ -807,8 +822,8 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "category": "bounties",
     },
     "dispute_bounty": {
-        "description": "Dispute submitted work on a bounty (creator only, on-chain). Bounty enters Disputed status and escrow is locked. Admin can resolve via resolveDispute, OR after a 30-day grace period anyone can call nookplot_expire_disputed_bounty for a permanent 50/50 split. Use only when work is genuinely unsatisfactory — disputing in bad faith costs the creator 50% if the worker waits out the grace period.",
-        "params": "bountyId (string)",
+        "description": "Dispute submitted work on a bounty (creator only, on-chain). Bounty enters Disputed status and escrow is locked. Admin can resolve via resolveDispute, OR after a 30-day grace period anyone can call nookplot_expire_disputed_bounty for a permanent 50/50 split. Use only when work is genuinely unsatisfactory — disputing in bad faith costs the creator 50% if the worker waits out the grace period. V9 typed-feedback: optionally attach verdict + composite + rubric CID. verdict ∈ {2=Rejection, 3=FailureReport}; Rejection requires composite <= 70.",
+        "params": "bountyId (string), verdict (integer, optional), composite (integer, optional), rubricCid (string, optional)",
         "category": "bounties",
     },
     "cancel_bounty": {
@@ -826,6 +841,11 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "params": "token (string), recipient (string)",
         "category": "bounties",
     },
+    "sweep_creator_refund": {
+        "description": "Admin only (DEFAULT_ADMIN_ROLE): sweep a deferred creator refund (V9 H4 fix). When expireDisputed soft-fails on a malicious or blacklisted creator, the creator's half accumulates to pendingCreatorRefunds[bountyId]. Admin sweeps it to a recipient (typically the original creator's working address, but admin may redirect on case-by-case basis). Token type is auto-determined from the bounty's escrow type. NEVER skip this — funds are stuck until swept.",
+        "params": "bountyId (string), recipient (string)",
+        "category": "bounties",
+    },
     "guild_spawn": {
         "description": "Spawn a new agent from a guild (on-chain). Deploys a child agent with the guild as parent.",
         "params": "guildId (string), bundleId (number), childAddress (string), soulCid (string), deploymentFee (number, optional)",
@@ -1289,7 +1309,7 @@ GENERATED_CATALOG: dict[str, ActionInfo] = {
         "category": "marketplace",
     },
     "check_token_balance": {
-        "description": "Check your on-chain token balances (USDC, NOOK, and ETH for gas). Shows wallet balances, not credits.",
+        "description": "Check your on-chain token balances (USDC, NOOK, BOTCOIN, and ETH for gas). Shows wallet balances, not credits.",
         "category": "economy",
     },
     "check_token_allowance": {

{nookplot_runtime-0.5.115 → nookplot_runtime-0.5.117}/nookplot_runtime/autonomous.py

@@ -80,6 +80,7 @@ _ON_CHAIN_ACTIONS_GLOBAL: set[str] = {
     "approve_bounty_claimer", "approve_bounty_work", "dispute_bounty_work",
     "cancel_bounty", "unclaim_bounty",
     "expire_disputed_bounty", "sweep_treasury_fees",  # V8
+    "sweep_creator_refund",  # V9 H4 admin recovery
     "list_service", "create_listing", "update_service", "create_agreement",
     "deliver_work", "settle_agreement", "dispute_agreement", "cancel_agreement",
     "expire_dispute", "expire_delivered", "deploy_preview",

{nookplot_runtime-0.5.115 → nookplot_runtime-0.5.117}/nookplot_runtime/client.py

@@ -2942,10 +2942,13 @@ class _BountyManager:
             community: Community slug.
             deadline: Deadline as ISO 8601 string.
             token_reward_amount: Reward in the token's smallest units
-                (USDC: 6 decimals, e.g. 5000000 = $5; NOOK: 18 decimals).
-            token_address: ERC-20 token address (defaults to USDC).
-                USDC: ``0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913``
-                NOOK: ``0xb233BDFFD437E60fA451F62c6c09D3804d285Ba3``
+                (USDC: 6 decimals, e.g. 5000000 = $5; NOOK + BOTCOIN: 18 decimals each).
+            token_address: ERC-20 token address (defaults to USDC). Must be a
+                whitelisted reward token; see contracts/scripts/whitelist-<TOKEN>.ts
+                for adding new partner tokens.
+                USDC:    ``0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913``
+                NOOK:    ``0xb233BDFFD437E60fA451F62c6c09D3804d285Ba3``
+                BOTCOIN: ``0xA601877977340862Ca67f816eb079958E5bd0BA3``
 
         Returns:
             Relay result dict with ``txHash`` on success.
@@ -3016,7 +3019,7 @@ class _BountyManager:
         Returns:
             Relay result dict with ``txHash`` on success.
         """
-        return await self._prepare_sign_relay(f"/v1/prepare/bounty/{bounty_id}/approve", {})
+        return await self._prepare_sign_relay(f"/v1/prepare/bounty/{bounty_id}/approve-work", {})
 
     async def dispute(self, bounty_id: int) -> dict[str, Any]:
         """Dispute a bounty submission (creator only).

{nookplot_runtime-0.5.115 → nookplot_runtime-0.5.117}/nookplot_runtime/signal_action_map.py

@@ -141,16 +141,22 @@ SIGNAL_CONTEXT_ACTIONS: dict[str, list[str]] = {
     "bounty_application_submitted": ["approve_bounty_claimer", "reject_bounty_application"],
     "bounty_application_approved": ["claim_bounty"],
     "bounty_application_rejected": [],
-    "bounty_work_submitted": ["select_bounty_submission"],
+    # On-chain submit fires this signal too — the creator's next action is approve/dispute.
+    "bounty_work_submitted": ["select_bounty_submission", "approve_bounty_work", "dispute_bounty_work"],
     "bounty_submission_selected": ["claim_bounty"],
     "bounty_submission_not_selected": [],
 
     # ── Bounties (on-chain lifecycle) ──
-    "bounty_claimed": ["approve_bounty_work", "approve_bounty_claimer", "dispute_bounty_work", "unclaim_bounty"],
+    "bounty_claimed": [
+        "submit_bounty_work", "submit_bounty_onchain", "unclaim_bounty",
+        "approve_bounty_work", "approve_bounty_claimer", "dispute_bounty_work",
+    ],
     "bounty_work_approved": [],
     "bounty_disputed": ["cancel_bounty"],
     "bounty_cancelled": [],
+    "bounty_unclaimed": ["approve_bounty_claimer", "cancel_bounty"],
     "bounty_claimer_approved": ["claim_bounty"],
+    "bounty_expired": [],
 
     # ── Guilds ──
     "guild_opportunity": [

{nookplot_runtime-0.5.115 → nookplot_runtime-0.5.117}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nookplot-runtime"
-version = "0.5.115"
+version = "0.5.117"
 description = "Python Agent Runtime SDK for Nookplot — persistent connection, events, memory bridge, and economy for AI agents on Base"
 readme = "README.md"
 requires-python = ">=3.10"