opencrowd 0.13.0 → 0.13.2

package/bundle/opencrowd.js

@@ -57184,7 +57184,7 @@ var init_discovery = __esm({
     "use strict";
     init_dist3();
     init_offers();
-    RANKED_NOTE = "Ranked by CrowdCode across Base, Solana and Tempo (AgentCash, Coinbase's x402 catalog, MPP catalog and CrowdCode reviews): quality first, then effective price on best_network (including about $0.03 to move USDC between your own networks when that network's balance is short), then your balance there. Prefer the highest-ranked service that fits the task, whatever its network. transfer_needed means your balance on best_network is short: move USDC between your own networks first if you have a tool for that; otherwise say which network needs funds. New/unreviewed services are allowed. Inspect the chosen endpoint before paying.";
+    RANKED_NOTE = "Ranked by CrowdCode across Base, Solana and Tempo (AgentCash, Coinbase's x402 catalog, MPP catalog and CrowdCode reviews): quality first, then effective price on best_network (including about $0.03 to move USDC between your own networks when that network's balance is short), then your balance there. Prefer the highest-ranked service that fits the task, whatever its network. Each result's `networks` are the networks it can be paid on; between results that fit the task equally well, one you can pay from a balance you already hold beats one that needs a transfer first. transfer_needed means your balance on best_network is short: move USDC between your own networks first if you have a tool for that; otherwise say which network needs funds. New/unreviewed services are allowed. Inspect the chosen endpoint before paying.";
     BaseServiceDiscovery = class {
       searchApi;
       options;
@@ -57277,6 +57277,7 @@ var init_discovery = __esm({
               const schema = inspection.data;
               if (!inspection.ok || !schema?.payable)
                 return void 0;
+              const networks = Array.isArray(schema.offers) ? [...new Set(schema.offers.filter((offer) => offer.payable).map((offer) => String(offer.network)))] : [];
               const service = {
                 endpoint,
                 method,
@@ -57284,6 +57285,7 @@ var init_discovery = __esm({
                 price_usd: schema.price_usd,
                 payment_provider: schema.rail === "mppx" ? "mppx" : "x402",
                 network: schema.network ?? BASE_NETWORK,
+                ...networks.length ? { networks } : {},
                 payable: true
               };
               return c.ranking ? { ...service, ...ranked(c.ranking, schema) } : service;
@@ -58602,7 +58604,7 @@ var init_gateway = __esm({
       },
       {
         name: "find_paid_service",
-        description: "Discover paid capability across Base, Solana and Tempo. `query` searches every catalog (AgentCash, Coinbase's x402 catalog, MPP) and returns services you can pay, ranked best first by CrowdCode: quality, then effective price on your best network (including a transfer between your own networks when its balance is short), then your balance there. `origin` lists a known origin's endpoints.",
+        description: "Discover paid capability across Base, Solana and Tempo. `query` searches every catalog (AgentCash, Coinbase's x402 catalog, MPP) and returns services you can pay, ranked best first by CrowdCode: quality, then effective price on your best network (including a transfer between your own networks when its balance is short), then your balance there. Every result lists `networks`, the networks it can be paid on: when a call fails for funds, come back here and prefer an equivalent service on a network you already hold USDC on over moving funds. `origin` lists a known origin's endpoints.",
         parameters: {
           type: "object",
           properties: {
@@ -58659,7 +58661,7 @@ var init_gateway = __esm({
       },
       {
         name: "bridge_usdc",
-        description: "Explicitly bridge USDC between this wallet's own networks (base, tempo, solana) through AgentCash. A financial action, not a purchase; subject to bridge fees.",
+        description: "Explicitly bridge USDC between this wallet's own networks (base, tempo, solana) through AgentCash. A financial action, not a purchase; subject to bridge fees, which are a flat ~$0.02-0.03 whatever the size: aim for about $1 so one fee funds many calls, and when the wallet holds less, keep the fee under about a fifth of what moves.",
         parameters: {
           type: "object",
           properties: {
@@ -81247,6 +81249,21 @@ function hostedDynamicTools(economy) {
   const tools = economyTools(economy);
   return { ...tools, definitions: tools.definitions.map((tool) => tool.name === "get_wallet_status" ? { ...tool, description: "Read this hosted agent's USDC wallet: the total across networks, each network's balance (Base, Solana, Tempo), and authoritative current-run inference spending, service spending, transfer fees, payment holds and authorized budget. A payment on a network needs that network's balance. Read-only." } : tool.name === "bridge_usdc" ? HOSTED_BRIDGE_TOOL : tool) };
 }
+function planFundingMove(target, priceUsd, available) {
+  const cents = (usd3) => Math.floor(usd3 * 100) / 100;
+  const needed = Math.ceil((priceUsd + MOVE_FEE_ALLOWANCE_USD) * 100) / 100;
+  const source = available.filter((n) => n.network !== target).sort((a, b) => b.usd - a.usd)[0];
+  if (!source)
+    return void 0;
+  const reserve = source.network === "base" ? BASE_WORKING_RESERVE_USD : 0;
+  const spare = cents(Math.max(0, source.usd - reserve));
+  const ceiling = Math.min(Math.max(needed, spare), cents(source.usd));
+  const amount = Math.min(Math.max(PREFERRED_MOVE_USD, needed), ceiling);
+  if (amount < needed)
+    return void 0;
+  const feeShare = MOVE_FEE_ESTIMATE_USD / amount;
+  return { from: source.network, amount, feeShare, worthwhile: feeShare <= MAX_MOVE_FEE_SHARE };
+}
 function parseListedService(raw) {
   const row = objectValue5(raw);
   if (!row) {
@@ -81309,7 +81326,7 @@ function numberValue6(value) {
   }
   return void 0;
 }
-var DEFAULT_CROWDCODE_BASE, LIST_CACHE_MS, FIND_TIMEOUT_MS, PAY_TIMEOUT_MS, RECONCILE_DELAY_MS, NOT_SENT_CODES, FREE_FETCH_TIMEOUT_MS, USDC_ATOMIC_PER_USD, TRANSFER_WAIT_MS, TRANSFER_POLL_MS, MIN_PRACTICAL_MOVE_USD, RAIL_NETWORK2, ServiceDirectory, HostedAgentCashAdapter, usd, isPending, HostedCrowdCodeAdapter, HOSTED_BRIDGE_TOOL;
+var DEFAULT_CROWDCODE_BASE, LIST_CACHE_MS, FIND_TIMEOUT_MS, PAY_TIMEOUT_MS, RECONCILE_DELAY_MS, NOT_SENT_CODES, FREE_FETCH_TIMEOUT_MS, USDC_ATOMIC_PER_USD, TRANSFER_WAIT_MS, TRANSFER_POLL_MS, PREFERRED_MOVE_USD, MOVE_FEE_ALLOWANCE_USD, MOVE_FEE_ESTIMATE_USD, MAX_MOVE_FEE_SHARE, BASE_WORKING_RESERVE_USD, RAIL_NETWORK2, ServiceDirectory, HostedAgentCashAdapter, usd, isPending, HostedCrowdCodeAdapter, HOSTED_BRIDGE_TOOL;
 var init_hosted_economy = __esm({
   "../../packages/agent-runtime/dist/hosted-economy.js"() {
     "use strict";
@@ -81330,7 +81347,11 @@ var init_hosted_economy = __esm({
     USDC_ATOMIC_PER_USD = 1e6;
     TRANSFER_WAIT_MS = 15e4;
     TRANSFER_POLL_MS = 3e3;
-    MIN_PRACTICAL_MOVE_USD = 1;
+    PREFERRED_MOVE_USD = 1;
+    MOVE_FEE_ALLOWANCE_USD = 0.05;
+    MOVE_FEE_ESTIMATE_USD = 0.03;
+    MAX_MOVE_FEE_SHARE = 0.2;
+    BASE_WORKING_RESERVE_USD = 0.25;
     RAIL_NETWORK2 = { "x402-base": "base", "x402-solana": "solana", mppx: "tempo" };
     ServiceDirectory = class {
       fetcher;
@@ -81560,8 +81581,11 @@ var init_hosted_economy = __esm({
         }
       }
       /**
-       * After funding_required: where the agent's money is, and the move that
-       * would make this purchase payable when another network holds enough.
+       * After funding_required: where the agent's money is, and the two ways
+       * forward, cheaper first. An equivalent service on a network the agent
+       * already funds costs nothing extra; a move costs a bridge fee. A funded
+       * wallet must never be told to go and ask the owner for money, and a move
+       * that would spend most of itself on the fee must never be made quietly.
        */
       async fundingHint(request2) {
         const wallet = await this.getBalance().catch(() => void 0);
@@ -81572,11 +81596,15 @@ var init_hosted_economy = __esm({
         const total = available.reduce((sum, n) => sum + n.usd, 0);
         const line = ` Your available USDC: ${available.map((n) => `${n.network} ${n.usd.toFixed(2)}`).join(", ")} (total ${total.toFixed(2)}).`;
         const target = RAIL_NETWORK2[request2.rail];
-        const amount = Math.max(MIN_PRACTICAL_MOVE_USD, Math.ceil((request2.maxAmountUsd + 0.05) * 100) / 100);
-        const source = available.filter((n) => n.network !== target).sort((a, b) => b.usd - a.usd)[0];
-        if (!target || !source || source.usd < amount + 0.05)
-          return `${line} No single network holds enough to move; ask the owner to add funds.`;
-        return `${line} To pay, move funds first: bridge_usdc {"from":"${source.network}","to":"${target}","amount_usd":${amount}} (fee about $0.02-0.03, counted as spending; follows the owner's approval mode), then retry this call.`;
+        const funded = available.filter((n) => n.network !== target && n.usd >= request2.maxAmountUsd).map((n) => n.network);
+        const elsewhere = funded.length ? ` First look for an equivalent service you can already pay: find_paid_service lists every result's networks, and one on ${funded.join(" or ")} costs you no transfer fee.` : "";
+        const move = target ? planFundingMove(target, request2.maxAmountUsd, available) : void 0;
+        if (!target || !move)
+          return `${line}${elsewhere} No network of yours can cover a move to ${target ?? "a network this service accepts"} either, so if no equivalent service fits, tell the owner plainly that this service is sold only on ${target ?? "networks you do not hold"} and ask them to add USDC there.`;
+        const cost = `about $${MOVE_FEE_ESTIMATE_USD.toFixed(2)}`, size5 = `$${move.amount.toFixed(2)}`;
+        if (!move.worthwhile)
+          return `${line}${elsewhere} Moving funds is the other way, but the most ${move.from} can spare is ${size5}, and a fee of ${cost} is ${Math.round(move.feeShare * 100)}% of that \u2014 too much to spend without asking. If no equivalent service fits, say exactly that to the owner: this service is sold only on ${target}, moving ${size5} there would cost ${cost} in fees, and ask whether to do it.`;
+        return `${line}${elsewhere} Otherwise move the funds yourself and retry \u2014 a move this size is within the policy and is not something to ask the owner about, any more than paying for the call is: bridge_usdc {"from":"${move.from}","to":"${target}","amount_usd":${move.amount}} (fee ${cost}, counted as spending; the spending guard pauses it for approval by itself if the owner's mode requires that), then retry this call.`;
       }
       /**
        * Moves this agent's own USDC between its networks through the supervisor:
@@ -81729,7 +81757,7 @@ var init_hosted_economy = __esm({
     };
     HOSTED_BRIDGE_TOOL = {
       name: "bridge_usdc",
-      description: "Move your own USDC between your networks (base, solana, tempo); it always arrives at your own address. Use it when the owner asks, or when a paid call failed with funding_required and another network holds enough. quote_only shows the fee and expected amount without moving. Executing re-quotes, applies the owner's approval policy to the fee (it may pause for approval) and waits for the funds to arrive, usually within a minute. Fees are about $0.02-0.03 and count as spending; move at least $1. Pass transfer_id alone to check a pending move.",
+      description: "Move your own USDC between your networks (base, solana, tempo); it always arrives at your own address. Use it when the owner asks, or when a paid call failed with funding_required and no equivalent service is sold on a network you already fund. quote_only shows the fee and expected amount without moving. Executing re-quotes, applies the owner's approval policy to the fee (it may pause for approval) and waits for the funds to arrive, usually within a minute. Fees are about $0.02-0.03 and count as spending, so aim for about $1 and one fee funds many calls; when the wallet holds less, move what the call needs plus the fee, as long as the fee stays under about a fifth of what moves (roughly $0.15 and up). A move within that rule needs no permission from the owner: the spending guard applies their approval mode to the fee by itself. Below the rule, quote_only first and ask, rather than spending most of the move on its fee. Pass transfer_id alone to check a pending move.",
       parameters: {
         type: "object",
         properties: {
@@ -82481,9 +82509,10 @@ async function runAgentTaskDetailed(session, task, options = {}) {
   if (options.hosted)
     systemPromptParts.push("Files the owner sends you: an attached file is saved in this session under uploads/ before its message reaches you, and the message names each one with its path, size and type. Read a text file with read_file at uploads/<name>, and any file with run_shell at artifacts/uploads/<name> from the session directory. Those files are already the owner's and already in their file list: work from them, and never copy or re-save one under artifacts/ to hand it back. Write your own outputs elsewhere under artifacts/; uploads/ is the owner's directory and nothing you write there is delivered. If a file the message names is missing, say so and ask the owner to send it again rather than guessing at its contents.", "Files you produce: only the artifacts/ directory of this session reaches the owner. save_file writes there; anything you write elsewhere is scratch they never see. The owner sees each file at its path without that prefix, so artifacts/generated/report.pdf is generated/report.pdf to them. Name a produced file in your final message by exactly that path as plain text and nothing else \u2014 the owner's interface turns it into a working download and preview link. Never invent a download URL, a sandbox: link, a /mnt/data path, or any other path the owner cannot open, and never claim a file exists before you have verified it.");
   if (options.dynamicTools) {
-    systemPromptParts.push("When the local computer is not the right environment, or after one clear local capability failure, buy external capability: find_paid_service to discover, inspect_paid_service to see the exact schema/price/reputation, call_paid_service to execute through the enforced purchase lifecycle, and review_paid_service for the required review after every confirmed paid call (success or failure). The same review tool accepts unpaid experiences; review relevant free results or failed attempts without inventing payment evidence. Distinguish provider faults from local errors and uncertain failures. A platform judge, not you, writes the public score and text of a paid review from the platform's record of the call; your rating and notes are evidence it reads, so report accurately and never try to talk it into a rating.", `Choosing a service: find_paid_service with a short capability query (for example "web search" or "object storage", not the task's subject) searches every catalog (AgentCash, Coinbase's x402 catalog, the MPP catalog and CrowdCode's reviews) across Base, Solana and Tempo and returns services you can pay, ranked best first by CrowdCode: quality (score and verified reviews), then effective price on the service's best network, including about $0.03 to move USDC between your own networks when that network's balance is short, then your balance there. Prefer the highest-ranked service that fits the task, whatever its network; a better or cheaper service on Solana or Tempo beats a Base default. When the chosen service is marked transfer_needed, move USDC between your own networks first if you have a tool for that; otherwise tell the user which network needs funds. When the ranking is unavailable, compare candidates yourself with inspect_paid_service (reputation, price and network) against your per-network balances.`, ...options.hosted ? [
+    systemPromptParts.push("When the local computer is not the right environment, or after one clear local capability failure, buy external capability: find_paid_service to discover, inspect_paid_service to see the exact schema/price/reputation, call_paid_service to execute through the enforced purchase lifecycle, and review_paid_service for the required review after every confirmed paid call (success or failure). The same review tool accepts unpaid experiences; review relevant free results or failed attempts without inventing payment evidence. Distinguish provider faults from local errors and uncertain failures. A platform judge, not you, writes the public score and text of a paid review from the platform's record of the call; your rating and notes are evidence it reads, so report accurately and never try to talk it into a rating.", `Choosing a service: find_paid_service with a short capability query (for example "web search" or "object storage", not the task's subject) searches every catalog (AgentCash, Coinbase's x402 catalog, the MPP catalog and CrowdCode's reviews) across Base, Solana and Tempo and returns services you can pay, ranked best first by CrowdCode: quality (score and verified reviews), then effective price on the service's best network, including about $0.03 to move USDC between your own networks when that network's balance is short, then your balance there. Prefer the highest-ranked service that fits the task, whatever its network; a better or cheaper service on Solana or Tempo beats a Base default. Each result also lists \`networks\`, the networks it can be paid on; between services that fit the task equally well, one you can pay from a balance you already hold beats one that needs a transfer first, because a move costs about $0.03. When the chosen service is marked transfer_needed, move USDC between your own networks first if you have a tool for that; otherwise tell the user which network needs funds. When the ranking is unavailable, compare candidates yourself with inspect_paid_service (reputation, price and network) against your per-network balances.`, ...options.hosted ? [
       "You can use new services without prior CrowdCode reviews. Payable: x402 USDC on Base or Solana and MPP USDC.e on Tempo; the hosted gateway pays the cheapest offered network your balance on that network covers. Other networks, including Monad, are not payable here. Payments stay within the user's configured limits; over-limit quotes request approval. Use read_service for authenticated job polling and never resubmit a pending generation job.",
-      "Moving funds: when a paid call fails with funding_required and another of your networks holds enough, move funds to a network the service accepts with bridge_usdc (at least $1, or what the task needs) and retry the same call; do not switch services just because of where funds sit. When the owner asks you to move funds, quote first, state the fee, then execute and report both transaction ids and the amount received. Moves follow the owner's approval mode like payments; never move funds without a reason."
+      "funding_required means your USDC is on the wrong network, not that you are out of money, and a wallet with money in it finishes the job. First go back to find_paid_service and look for an equivalent service sold on a network you already hold USDC on \u2014 every result lists its `networks`, and paying from an existing balance costs no transfer fee. If none fits, move funds with bridge_usdc and retry the same call: aim for about $1 so one fee funds many later calls, and when the wallet holds less than that, move what the call needs plus the fee, as long as the fee stays under about a fifth of what moves (roughly $0.15 and up at a $0.03 fee). A move inside that rule is ordinary work, not a decision for the owner: make it and retry, exactly as you would pay for the call itself. The spending guard applies the owner's approval mode to the fee by itself and pauses the run if it has to, so you never need permission before calling bridge_usdc. Stopping to ask whether you may spend three cents moving the owner's own money to the network a seller wants is the dead end this rule exists to prevent. Only below that threshold is a move not worth making on your own: quote_only it, then ask. When the owner asks you to move funds, quote first, state the fee, then execute and report both transaction ids and the amount received. Moves follow the owner's approval mode like payments; never move funds without a reason.",
+      "When money is what blocks a task, say exactly that and nothing else: which network the service is sold on, what you hold where, and the single thing you need \u2014 permission for a move you have quoted, or USDC added on that network. Never dress a funding problem up as the service being unsuitable or unavailable, never imply your wallet is empty when it is not, and never offer a recorded request_service as though it were the answer the owner asked for."
     ] : [], capabilityIndex ?? DEFAULT_CAPABILITY_INDEX, "When a task needs current web facts, search results, or unfamiliar page content, make one paid web search your FIRST move \u2014 do not serially guess URLs with curl; one paid search replaces minutes of blind fetching and costs less than the LLM turns it saves.", "Approval, budget, reputation, and payment rails are enforced in code \u2014 you cannot bypass them, so state costs plainly and never invent payment details.", "When the user says CrowdCode on/off, call set_crowdcode_enabled; default to session scope unless they ask for a persistent default. Use list_my_reviews and delete_my_review for user-directed review management, including while off. Before finishing a substantive task, consider concrete paid services that would fix real shortcomings and submit qualifying demand with request_service (input, output, problem, price_per_call), unless CrowdCode is off. Never invent a purchase or demand.", "Each tool result includes the budget before and after that tool call. Never ask for wallet private keys or secrets.", ...options.promptSections ?? []);
   } else {
     systemPromptParts.push("Paid external services are unavailable in this run; work with local tools only and say so if the task truly requires external capability.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencrowd",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "A CLI agent with its own wallet — discovers x402 services, pays in USDC, and completes tasks under a local budget",
   "type": "module",
   "license": "MIT",