opencrowd 0.9.0 → 0.10.1

package/README.md

@@ -88,9 +88,16 @@ Paid services settle in USDC on the network you prefer when they offer it:
 x402 on Base (the default) or Solana, MPP on Tempo, and x402 on Monad when
 you choose it. Solana uses AgentCash's separate Solana address
 (`~/.agentcash/solana-wallet.json`); `opencrowd wallet accounts` lists every
-network's address and balance. When a service does not offer your preferred
-network, the first of Base, Solana and Tempo whose balance covers the price is
-used.
+network's address and balance. When your preferred network is not offered or
+its balance does not cover the price, the first of Base, Solana and Tempo whose
+balance covers it is used.
+
+`find_paid_service` searches across all of these networks. With CrowdCode on,
+CrowdCode merges AgentCash search with Coinbase's x402 catalog, the mpp.dev MPP
+catalog and its reviewed services, and ranks the results: quality first, then
+the effective price on each service's best network (including a transfer
+between your own networks when that network's balance is short), then your
+balance there. With CrowdCode off, AgentCash's order is used.
 
 ```sh
 opencrowd config set payment-network solana   # or --payment-network solana per run

package/bundle/opencrowd.js

@@ -16497,7 +16497,7 @@ function normalizeConfig(value) {
   const proxyDefaults = providerDefaults(raw["openrouter-x402-proxy"] ?? raw.x402, DEFAULT_CONFIG["openrouter-x402-proxy"]);
   const mcpServers = recordValue(raw.mcpServers);
   const servers = { ...DEFAULT_CONFIG.mcpServers, ...mcpServers };
-  if (servers.crowdcode?.command === "npx" && ["0.5", "0.5.2", "0.5.3", "0.6.0", "0.7.0"].some((version6) => JSON.stringify(servers.crowdcode.args) === JSON.stringify(["--yes", `crowdcode-mcp@${version6}`]))) {
+  if (servers.crowdcode?.command === "npx" && ["0.5", "0.5.2", "0.5.3", "0.6.0", "0.7.0", "0.8.0", "0.9.0"].some((version6) => JSON.stringify(servers.crowdcode.args) === JSON.stringify(["--yes", `crowdcode-mcp@${version6}`]))) {
     servers.crowdcode = { ...servers.crowdcode, args: [...DEFAULT_CONFIG.mcpServers.crowdcode.args] };
   }
   return {
@@ -16569,7 +16569,7 @@ var init_config = __esm({
       configVersion: 3,
       mcpServers: {
         agentcash: { command: "npx", args: ["--yes", "agentcash@0.17"] },
-        crowdcode: { command: "npx", args: ["--yes", "crowdcode-mcp@0.8.0"] }
+        crowdcode: { command: "npx", args: ["--yes", "crowdcode-mcp@0.9.1"] }
       },
       // GAIA provider benchmark (2026-08-25): same-model BlockRun matched the
       // current route's accuracy and completed the sample 6.7x faster. The
@@ -57094,9 +57094,6 @@ function selectOffer(offers, selection) {
   const payable = offers.filter((offer) => offer.rail !== "unsupported" && selection.rails.includes(offer.rail));
   const cheapest = (name) => payable.filter((offer) => offer.network_name === name).sort((a, b) => (a.price_usd ?? Infinity) - (b.price_usd ?? Infinity))[0];
   const order = [preferred, ...FALLBACK_ORDER.filter((name) => name !== preferred)];
-  const first = cheapest(preferred);
-  if (first)
-    return first;
   const candidates = order.map(cheapest).filter((offer) => offer !== void 0);
   const balances = selection.balances;
   return balances && candidates.find((offer) => (balances[offer.network_name] ?? 0) >= (offer.price_usd ?? 0)) || candidates[0];
@@ -57135,12 +57132,54 @@ var init_offers = __esm({
 });
 
 // ../../packages/economy/dist/discovery.js
-var BaseServiceDiscovery;
+function searchResults(raw) {
+  const body = raw?.results?.results ? raw.results : raw?.data?.results ? raw.data : raw;
+  return Array.isArray(body?.results) ? body.results : Array.isArray(body?.services) ? body.services : [];
+}
+function agentCashCandidate(result) {
+  try {
+    const endpoint = result.endpoint ?? new URL(result.path, typeof result.origin === "string" ? result.origin : result.origin?.url).href;
+    const usage = result.signals?.originUsage?.uniqueUserCount;
+    return {
+      endpoint,
+      method: result.method,
+      name: result.summary ?? result.name,
+      source: "agentcash",
+      ...result.price !== void 0 ? { price_usd: Number.parseFloat(String(result.price)) || void 0 } : {},
+      ...Array.isArray(result.origin?.protocols) ? { protocols: result.origin.protocols } : {},
+      ...typeof usage === "number" ? { unique_payers: usage } : {}
+    };
+  } catch {
+    return void 0;
+  }
+}
+function ranked(ranking, schema) {
+  const best = ranking.best ?? {};
+  const offered = Array.isArray(schema.offers) && schema.offers.some((offer) => offer.payable && offer.network === best.network);
+  const quality = ranking.quality ?? {};
+  return {
+    rank: ranking.rank,
+    ...offered ? { best_network: best.network } : {},
+    ...typeof best.effective_price_usd === "number" ? { effective_price_usd: best.effective_price_usd } : {},
+    ...best.transfer_needed ? { transfer_needed: true } : {},
+    quality: {
+      score: quality.score,
+      n_eff: quality.n_eff,
+      reviews: quality.num_reviews,
+      verified_reviews: quality.num_verified_reviews,
+      ...quality.unique_payers_30d != null ? { payers_30d: quality.unique_payers_30d } : {},
+      ...quality.below_floor ? { below_floor: true } : {}
+    },
+    sources: ranking.sources
+  };
+}
+var RANKED_NOTE, BaseServiceDiscovery;
 var init_discovery = __esm({
   "../../packages/economy/dist/discovery.js"() {
     "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.";
     BaseServiceDiscovery = class {
       searchApi;
       options;
@@ -57197,11 +57236,11 @@ var init_discovery = __esm({
           this.cache.set(key, { until: Date.now() + 6e4, data });
         return { ok: true, data };
       }
-      /** Balances are read only when they can change the choice: the preferred network is absent and several are payable. */
+      /** Balances are read only when they can change the choice: several networks are payable. */
       async select(offers) {
         const selection = { preferred: this.options.paymentNetwork, rails: this.rails };
         const networks = payableNetworks(offers, this.rails);
-        const needsBalances = !this.options.negotiated && this.options.balances && networks.length > 1 && !networks.includes(this.options.paymentNetwork ?? "base");
+        const needsBalances = !this.options.negotiated && this.options.balances && networks.length > 1;
         const balances = needsBalances ? await this.options.balances().catch(() => void 0) : void 0;
         return selectOffer(offers, { ...selection, balances });
       }
@@ -57216,25 +57255,33 @@ var init_discovery = __esm({
           return `The hosted gateway pays the cheapest of ${networks.join(", ")} that your balance on that network covers; price_usd is the ceiling across them. ${quote}`;
         }
         const preferred = this.options.paymentNetwork ?? "base";
-        return `Pays ${networkLabel(offer)}${offer.network_name === preferred ? "" : ` (${preferred} is not offered)`}. ${quote}`;
+        const reason = payableNetworks(offers, this.rails).includes(preferred) ? `your ${preferred} balance does not cover it` : `${preferred} is not offered`;
+        return `Pays ${networkLabel(offer)}${offer.network_name === preferred ? "" : ` (${reason})`}. ${quote}`;
       }
+      /** Probe candidates in order and keep the first `limit` this payer can settle. */
       async verified(candidates, limit) {
         const services = [];
         for (let i = 0; i < candidates.length && services.length < limit; i += 4) {
           const batch = await Promise.all(candidates.slice(i, i + 4).map(async (c) => {
             try {
               const endpoint = c.endpoint ?? new URL(c.path, typeof c.origin === "string" ? c.origin : c.origin?.url).href;
-              const inspection = await this.inspect({ url: endpoint, method: c.method });
+              let method = c.method ?? "POST";
+              let inspection = await this.inspect({ url: endpoint, method });
+              if (!inspection.ok && !c.method)
+                inspection = await this.inspect({ url: endpoint, method: method = "GET" });
               const schema = inspection.data;
-              return inspection.ok && schema?.payable ? {
+              if (!inspection.ok || !schema?.payable)
+                return void 0;
+              const service = {
                 endpoint,
-                method: c.method ?? "POST",
+                method,
                 name: c.summary ?? c.name,
                 price_usd: schema.price_usd,
                 payment_provider: schema.rail === "mppx" ? "mppx" : "x402",
                 network: schema.network ?? BASE_NETWORK,
                 payable: true
-              } : void 0;
+              };
+              return c.ranking ? { ...service, ...ranked(c.ranking, schema) } : service;
             } catch {
               return void 0;
             }
@@ -57243,17 +57290,43 @@ var init_discovery = __esm({
         }
         return services.slice(0, limit);
       }
+      /** The networks this payer settles, as CrowdCode names them. */
+      networks() {
+        return [...new Set(this.rails.filter((rail) => rail !== "unsupported").map((rail) => RAIL_NETWORK[rail]))];
+      }
+      /**
+       * AgentCash search, ranked across chains by CrowdCode when a ranker is
+       * supplied: CrowdCode adds Coinbase's x402 catalog, the MPP catalog and its
+       * reviewed services, then orders everything by quality, effective price and
+       * balance. Without a ranker, or if ranking fails, AgentCash's order stands.
+       */
       async search(query, options = {}) {
         const limit = Math.min(20, Math.max(1, options.limit ?? 8));
-        const result = await this.searchApi(query, { ...options, limit: Math.min(50, limit * 3) });
+        const { rank, ...searchOptions } = options;
+        const [result, balances] = await Promise.all([
+          this.searchApi(query, { ...searchOptions, limit: Math.min(50, limit * 3) }).catch((error53) => ({ ok: false, error: error53.message })),
+          rank && this.options.balances ? this.options.balances().catch(() => void 0) : Promise.resolve(void 0)
+        ]);
+        const candidates = result.ok ? searchResults(result.data) : [];
+        if (rank) {
+          const ranking = await rank({
+            query,
+            networks: this.networks(),
+            ...balances ? { balances } : {},
+            candidates: candidates.map(agentCashCandidate).filter((candidate) => candidate !== void 0),
+            limit: Math.min(25, limit * 2)
+          }).catch((error53) => ({ ok: false, error: error53.message }));
+          const services = ranking.data?.services;
+          if (ranking.ok && Array.isArray(services)) {
+            const ordered = services.filter((service) => typeof service?.endpoint === "string").map((service) => ({ endpoint: service.endpoint, method: service.method ?? void 0, name: service.name, ranking: service }));
+            return { ok: true, data: { services: await this.verified(ordered, limit), note: RANKED_NOTE } };
+          }
+        }
         if (!result.ok)
           return result;
-        const raw = result.data;
-        const body = raw?.results?.results ? raw.results : raw?.data?.results ? raw.data : raw;
-        const candidates = Array.isArray(body?.results) ? body.results : Array.isArray(body?.services) ? body.services : [];
         return { ok: true, data: {
           services: await this.verified(candidates, limit),
-          note: `AgentCash discovery, verified ${describeRails(this.rails)}. New/unreviewed services are allowed. Inspect the chosen endpoint before paying.`
+          note: `AgentCash discovery${rank ? " (CrowdCode ranking unavailable)" : ""}, verified ${describeRails(this.rails)}. New/unreviewed services are allowed. Inspect the chosen endpoint before paying.`
         } };
       }
       async discoverEndpoints(origin) {
@@ -57653,6 +57726,9 @@ var init_crowdcode = __esm({
       async manage(name, args) {
         return this.connection.call(name, args);
       }
+      async findServices(search) {
+        return this.connection.call("find_service", { ...search });
+      }
       async getServiceScore(query) {
         const result = await this.connection.call("get_service_score", {
           ...query.apiEndpoint ? { api_endpoint: query.apiEndpoint } : {},
@@ -57872,6 +57948,38 @@ var init_purchases = __esm({
 // ../../packages/economy/dist/gateway.js
 import { readFile as readFile10, writeFile as writeFile5 } from "node:fs/promises";
 import { join as join12 } from "node:path";
+function requestFor(endpoint, method, body) {
+  if (method !== "GET" && method !== "HEAD")
+    return { url: endpoint, body };
+  let fields = body;
+  if (typeof fields === "string") {
+    try {
+      fields = JSON.parse(fields);
+    } catch {
+      return { url: endpoint, body };
+    }
+  }
+  if (fields === void 0 || fields === null)
+    return { url: endpoint, body: void 0 };
+  if (typeof fields !== "object" || Array.isArray(fields))
+    return { url: endpoint, body };
+  let url3;
+  try {
+    url3 = new URL(endpoint);
+  } catch {
+    return { url: endpoint, body };
+  }
+  for (const [key, value] of Object.entries(fields)) {
+    for (const item of Array.isArray(value) ? value : [value]) {
+      if (item === void 0 || item === null)
+        continue;
+      if (typeof item === "object")
+        return { url: endpoint, body };
+      url3.searchParams.append(key, String(item));
+    }
+  }
+  return { url: url3.href, body: void 0 };
+}
 function inspectionKey(endpoint, method) {
   return `${method} ${endpoint}`;
 }
@@ -58074,7 +58182,9 @@ var init_gateway = __esm({
           return result.ok ? { ok: true, data: result.data } : { ok: false, error: result.error };
         }
         if (query) {
-          const result = await this.options.agentcash.search(query, { limit: intArg(args.limit) });
+          const findServices = this.options.crowdcode.findServices?.bind(this.options.crowdcode);
+          const rank = findServices && await this.crowdcodeEnabled().catch(() => false) ? findServices : void 0;
+          const result = await this.options.agentcash.search(query, { limit: intArg(args.limit), ...rank ? { rank } : {} });
           return result.ok ? { ok: true, data: result.data } : { ok: false, error: result.error };
         }
         return { ok: false, error: "find_paid_service requires `origin` (known origin) or `query` (capability search)" };
@@ -58144,6 +58254,7 @@ var init_gateway = __esm({
           return { ok: false, error: "call_paid_service requires `url`" };
         }
         const method = (stringArg(args.method) ?? "POST").toUpperCase();
+        const { url: target, body } = requestFor(endpoint, method, args.body);
         const inspection = (await this.loadInspections()).get(inspectionKey(endpoint, method));
         if (!inspection) {
           return { ok: false, error: `inspect_paid_service must run for ${method} ${endpoint} before call_paid_service` };
@@ -58159,7 +58270,7 @@ var init_gateway = __esm({
         let quotedCostCents = requestedCostCents;
         let quoteIdentity;
         if (session.query && !this.options.hostedSpending) {
-          const fresh = await this.options.agentcash.checkEndpointSchema({ url: endpoint, method, body: args.body });
+          const fresh = await this.options.agentcash.checkEndpointSchema({ url: target, method, body });
           if (!fresh.ok)
             return { ok: false, error: fresh.error };
           if (railFromSchema(fresh.data) !== inspection.rail)
@@ -58191,15 +58302,15 @@ var init_gateway = __esm({
           return { ok: false, error: approval.error };
         }
         this.options.onProgress?.({ type: "reserving_spend", message: `Reserving ${quotedCostCents} cents` });
-        const reservation = this.options.hostedSpending ? { id: "hosted", amountCents: 0 } : await reserveBudget(session, quotedCostCents, { description: `Paid tool \xB7 ${endpoint}`, identity: JSON.stringify({ operationId, endpoint, method, body: args.body, quoteIdentity }), forceApproval: requestedCostCents !== void 0 && quotedCostCents > requestedCostCents });
+        const reservation = this.options.hostedSpending ? { id: "hosted", amountCents: 0 } : await reserveBudget(session, quotedCostCents, { description: `Paid tool \xB7 ${endpoint}`, identity: JSON.stringify({ operationId, endpoint: target, method, body, quoteIdentity }), forceApproval: requestedCostCents !== void 0 && quotedCostCents > requestedCostCents });
         let result;
         try {
           this.options.onProgress?.({ type: "calling_service", message: `Calling ${endpoint}` });
           result = await this.options.agentcash.fetch({
-            url: endpoint,
+            url: target,
             operationId,
             method,
-            body: args.body,
+            body,
             maxAmountUsd: quotedCostCents / 100,
             rail: inspection.rail
           });
@@ -58488,12 +58599,12 @@ var init_gateway = __esm({
       },
       {
         name: "find_paid_service",
-        description: "Discover paid capability: pass `origin` to list a known origin's endpoints, or `query` to search for an unknown capability.",
+        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.",
         parameters: {
           type: "object",
           properties: {
             origin: { type: "string", description: "Known API origin, e.g. https://stableenrich.dev" },
-            query: { type: "string", description: "Natural-language capability search when no origin is known" },
+            query: { type: "string", description: `The capability in a few words, for example "web search", "object storage" or "solana token risk"; not the task's subject` },
             limit: { type: "integer", minimum: 1, description: "Maximum search results" }
           },
           additionalProperties: false
@@ -58521,7 +58632,7 @@ var init_gateway = __esm({
           properties: {
             url: { type: "string", description: "Exact endpoint URL from inspect_paid_service" },
             method: { type: "string", description: "HTTP method (default POST)" },
-            body: { description: "Request body matching the inspected schema" },
+            body: { description: "Request inputs matching the inspected schema; for GET they are sent as query parameters" },
             max_cost_cents: { type: "integer", minimum: 1, description: "Price ceiling in cents; defaults to the inspected price" }
           },
           required: ["url"],
@@ -61558,7 +61669,7 @@ ${value.slice(-(scanLimit - prefixLength))}`;
           "anthropic/claude-opus-4.8",
           "openai/gpt-5.3-codex"
         ];
-        const ranked = features.agentDomain === "web_research" ? [
+        const ranked2 = features.agentDomain === "web_research" ? [
           ...scoredModels,
           ...webResearchFallbackOrder.filter(
             (model2) => eligibleCandidates.includes(model2) && !scoredModels.includes(model2)
@@ -61573,16 +61684,16 @@ ${value.slice(-(scanLimit - prefixLength))}`;
           ...scoredModels,
           ...eligibleCandidates.filter((model2) => !scoredModels.includes(model2))
         ];
-        const model = ranked[0] ?? base2.model;
+        const model = ranked2[0] ?? base2.model;
         const selectedTierConfigs = {
           ...tierConfigs,
-          [targetTier]: { primary: model, fallback: ranked.slice(1) }
+          [targetTier]: { primary: model, fallback: ranked2.slice(1) }
         };
         const decision = selectModel(
           targetTier,
           base2.confidence,
           "portfolio",
-          `${base2.reasoning} | v3 task=${features.taskType} agentRisk=${features.agentRisk} deepWebResearch=${features.deepWebResearch} terminalCode=${features.implicitTerminalCode} terminalSafety=${features.terminalSafetySensitive} candidates=${ranked.length}`,
+          `${base2.reasoning} | v3 task=${features.taskType} agentRisk=${features.agentRisk} deepWebResearch=${features.deepWebResearch} terminalCode=${features.implicitTerminalCode} terminalSafety=${features.terminalSafetySensitive} candidates=${ranked2.length}`,
           selectedTierConfigs,
           options.modelPricing,
           features.estimatedInputTokens,
@@ -61594,7 +61705,7 @@ ${value.slice(-(scanLimit - prefixLength))}`;
           ...decision,
           tierConfigs: selectedTierConfigs,
           profile: base2.profile,
-          candidates: ranked,
+          candidates: ranked2,
           candidateScores: rankedEntries.map(({ model: model2, score, quality, cost, speed, reliability }) => ({
             model: model2,
             score,
@@ -80783,7 +80894,7 @@ function economyTools(economy, options = {}) {
       const status = await economy.execute("crowdcode_status", {});
       if (!status.ok || !status.data?.enabled)
         return review || void 0;
-      return [review, "Before your final answer, reflect once: What concrete services would have been worth paying for to solve this task? For each observed failure, poor result, excessive cost or avoidable detour with a reusable paid remedy, call request_service. Specify exact inputs, the paid deliverable, acceptance criteria, the actual use case and why paying would help. A prior purchase or spending permission is not required. Do not invent budgets. Skip generic local computation, ordinary agent mistakes without a sellable remedy, and services such as web search that already worked well. If everything worked well and cheaply, submit nothing. Then finish the user's task."].filter(Boolean).join(" ");
+      return [review, "Before this run ends, reflect once: What concrete services would have been worth paying for to solve this task? For each observed failure, poor result, excessive cost or avoidable detour with a reusable paid remedy, call request_service. Specify exact inputs, the paid deliverable, acceptance criteria, the actual use case and why paying would help. A prior purchase or spending permission is not required. Do not invent budgets. Skip generic local computation, ordinary agent mistakes without a sellable remedy, and services such as web search that already worked well. If everything worked well and cheaply, submit nothing. Then call complete_session again to finish."].filter(Boolean).join(" ");
     }
   };
 }
@@ -81195,7 +81306,7 @@ function numberValue6(value) {
   }
   return void 0;
 }
-var DEFAULT_CROWDCODE_BASE, LIST_CACHE_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, MIN_PRACTICAL_MOVE_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";
@@ -81208,6 +81319,7 @@ var init_hosted_economy = __esm({
     init_economy_tools();
     DEFAULT_CROWDCODE_BASE = "https://crowdcode-backend.onrender.com";
     LIST_CACHE_MS = 6e4;
+    FIND_TIMEOUT_MS = 2e4;
     PAY_TIMEOUT_MS = SERVICE_GATEWAY_TIMEOUT_MS + 3e4;
     RECONCILE_DELAY_MS = 2e3;
     NOT_SENT_CODES = /* @__PURE__ */ new Set(["ENOENT", "ECONNREFUSED", "EACCES", "ENOTDIR"]);
@@ -81281,7 +81393,7 @@ var init_hosted_economy = __esm({
           if (!reply.ok || result?.status !== 200)
             return { ok: false, error: reply.error ?? "AgentCash search unavailable" };
           return { ok: true, data: JSON.parse(result.body) };
-        }, { rails: HOSTED_RAILS, negotiated: true });
+        }, { rails: HOSTED_RAILS, negotiated: true, balances: () => this.networkBalances() });
       }
       discovery;
       async read(url3) {
@@ -81303,6 +81415,20 @@ var init_hosted_economy = __esm({
           return { ok: false, error: `wallet status unavailable: ${error53.message}` };
         }
       }
+      /** Available USDC per network (balance minus open holds), for ranking search results. */
+      async networkBalances() {
+        const reply = await postHostedTool(this.socket, "economy.balance", {});
+        const networks = reply.ok ? objectValue5(reply.data)?.networks : void 0;
+        const balances = {};
+        for (const entry of Array.isArray(networks) ? networks : []) {
+          const row = objectValue5(entry);
+          const name = networkName(row?.network) ?? networkName(row?.caip2);
+          const available = Number(row?.available_usd ?? row?.balance_usd);
+          if (name && row?.available_usd != null && Number.isFinite(available))
+            balances[name] = available;
+        }
+        return balances;
+      }
       discoverEndpoints(origin) {
         return this.discovery.discoverEndpoints(origin);
       }
@@ -81530,6 +81656,21 @@ var init_hosted_economy = __esm({
         this.directory = directory;
         this.socket = socket;
       }
+      /** CrowdCode's cross-chain search and ranking over its public API. */
+      async findServices(search) {
+        try {
+          const response = await this.directory.fetcher(`${this.directory.base}/api/services/find`, {
+            method: "POST",
+            signal: AbortSignal.timeout(FIND_TIMEOUT_MS),
+            headers: { accept: "application/json", "content-type": "application/json" },
+            body: JSON.stringify(search)
+          });
+          const body = objectValue5(await response.json().catch(() => void 0));
+          return response.ok && body?.ok !== false ? { ok: true, data: body } : { ok: false, error: `CrowdCode search failed (HTTP ${response.status})` };
+        } catch (error53) {
+          return { ok: false, error: `CrowdCode search unavailable: ${error53.message}` };
+        }
+      }
       async getServiceScore(query) {
         const unreviewed = { ok: true, unproven: true, summary: "not yet reviewed on CrowdCode" };
         let serviceId = query.serviceId;
@@ -82334,9 +82475,11 @@ async function runAgentTaskDetailed(session, task, options = {}) {
   ];
   if (options.hosted)
     systemPromptParts.push("You operate this service for its owner. Inference and paid tools debit its USDC wallet. When authorized to build or sell a service, take concrete steps within the owner's configured scope and budget. Ask only for missing information or permissions that materially block progress. Report actual costs and outcomes. Financial sustainability is the owner's business objective; respect their stop controls.", "You are a continuous autonomous agent, not a turn-based assistant. Maintain unfinished goals, promised follow-ups, recurring work, and conditions worth monitoring. When future work would clearly help, proactively create a persistent automation instead of waiting for the owner to say schedule. Use a one-time automation for a future reminder or follow-up and a cron automation for monitoring, recurring reports, or maintenance. It runs in this same conversation. Never create duplicates or noisy schedules, and always tell the owner exactly what you created, its timezone, and next run.", "Before finishing a substantive task, consider whether a follow-up, reminder, monitoring loop, recurring report, or maintenance check would materially advance the owner's goal; create one when the need is clear, but do not schedule ordinary one-off work.", "Financial state: the current hosted financial snapshot is authoritative; historical local session budget figures are not wallet balances and may omit inference spending. Wallet balance, pending payment holds, settled inference spend, settled service spend, and remaining run budget are separate. When the snapshot lists wallet networks, each network's balance is separate: a payment on a network needs that network's available balance. Report the wallet to the owner as one total, mentioning the per-network split only when it matters. Spending totals cover only the identified current run. A budget limit does not supply funds. An unavailable balance is unknown, not zero. The snapshot before a model call excludes that call's eventual charge; never claim a response was free or that you spent nothing merely because no paid tool ran. Use get_budget_status or get_wallet_status for refreshed financial state. Respect approval mode and per-call limits; over-limit requests require the owner's approval.");
+  if (options.hosted)
+    systemPromptParts.push("Files you produce: every file in this session's workspace, whether written with save_file or by a shell command, is published to the owner as a downloadable, previewable file. To point at one in your final message, write its exact workspace-relative path as plain text, for example generated/report.pdf \u2014 the owner's interface turns that path 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.", ...options.hosted ? [
-      "Discover services through AgentCash search and provider catalogs. 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.",
+    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.", `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 ? [
+      "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."
     ] : [], 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, 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 {
@@ -82382,6 +82525,8 @@ async function runAgentTaskDetailed(session, task, options = {}) {
   const repeatedFailures = new Map(options.resume?.repeatedFailures);
   let completionNudges = options.resume?.completionNudges ?? 0;
   let pendingFinalMessage = options.resume?.pendingFinalMessage;
+  let finalAnswerHeld = options.resume?.finalAnswerHeld ?? false;
+  let supersededFinalMessage;
   let outputContinuationNudges = options.resume?.outputContinuationNudges ?? 0;
   let outputContinuationPrefix = options.resume?.outputContinuationPrefix ?? "";
   let serviceCallFailures = options.resume?.serviceCallFailures ?? 0;
@@ -82396,6 +82541,7 @@ async function runAgentTaskDetailed(session, task, options = {}) {
       deliveredMessageIds: [...deliveredMessageIds],
       completionNudges,
       pendingFinalMessage,
+      finalAnswerHeld,
       outputContinuationNudges,
       outputContinuationPrefix,
       serviceCallFailures,
@@ -82411,6 +82557,8 @@ async function runAgentTaskDetailed(session, task, options = {}) {
     }
     if (fresh.length) {
       pendingFinalMessage = void 0;
+      finalAnswerHeld = false;
+      supersededFinalMessage = void 0;
       outputContinuationPrefix = "";
       await checkpoint(turn);
     }
@@ -82420,6 +82568,16 @@ async function runAgentTaskDetailed(session, task, options = {}) {
       await options.inbox?.delivered(pending.map((m) => m.id));
     return fresh.length > 0;
   };
+  const recordFinalMessage = (text) => {
+    if (!text?.trim())
+      return;
+    if (!finalAnswerHeld)
+      pendingFinalMessage = text;
+    else if (text.trim() !== pendingFinalMessage?.trim())
+      supersededFinalMessage = text;
+  };
+  const gateNudge = (blocker) => finalAnswerHeld ? `Your final answer is already saved and will be delivered to the user exactly as written; nothing you write now can replace it. Before this run ends: ${blocker} Then call complete_session again to finish; a one-line acknowledgement is enough, and do not restate the answer.` : `You cannot finish yet: ${blocker}`;
+  const withReflection = (summary2) => supersededFinalMessage ? { ...summary2, reflection_note: supersededFinalMessage } : summary2;
   let subagentCount = 0;
   const backgroundSubagents = /* @__PURE__ */ new Map();
   const subagentLimiter = createLimiter(options.subagent?.maxParallel ?? 4);
@@ -82501,8 +82659,7 @@ ${outputContinuationPrefix}`);
       if (await injectMessages(turn + 1))
         continue;
       const finalMessage = response.content.trim() ? outputContinuationPrefix + response.content : pendingFinalMessage ?? outputContinuationPrefix;
-      if (finalMessage.trim())
-        pendingFinalMessage = finalMessage;
+      recordFinalMessage(finalMessage);
       const blocker = await options.completionGate?.(completionNudges > 0);
       if (blocker) {
         if (completionNudges >= 1) {
@@ -82510,7 +82667,9 @@ ${outputContinuationPrefix}`);
           return { outcome: "stopped", summary: summary3, turns: turn + 1 };
         }
         completionNudges += 1;
-        const nudge = { role: "user", content: `You cannot finish yet: ${blocker}` };
+        if (pendingFinalMessage?.trim())
+          finalAnswerHeld = true;
+        const nudge = { role: "user", content: gateNudge(blocker) };
         messages.push(nudge);
         await options.onMessage?.(nudge);
         await checkpoint(turn + 1);
@@ -82518,7 +82677,7 @@ ${outputContinuationPrefix}`);
       }
       if (!pendingFinalMessage?.trim())
         throw new Error("The model ended without an answer.");
-      const summary2 = await completeSession(session, pendingFinalMessage);
+      const summary2 = withReflection(await completeSession(session, pendingFinalMessage));
       return { outcome: "completed", summary: summary2, turns: turn + 1 };
     }
     const spawnedThisTurn = /* @__PURE__ */ new Map();
@@ -82654,8 +82813,8 @@ ${outputContinuationPrefix}`);
       if (!result.ok)
         continue;
       const finalMessage = result.data && typeof result.data === "object" ? result.data.final_message : void 0;
-      if (typeof finalMessage === "string" && finalMessage.trim())
-        pendingFinalMessage = finalMessage;
+      if (typeof finalMessage === "string")
+        recordFinalMessage(finalMessage);
       const blocker = await options.completionGate?.(completionNudges > 0);
       if (blocker) {
         if (completionNudges >= 1) {
@@ -82663,9 +82822,11 @@ ${outputContinuationPrefix}`);
           return { outcome: "stopped", summary: summary3, turns: turn + 1 };
         }
         completionNudges += 1;
+        if (pendingFinalMessage?.trim())
+          finalAnswerHeld = true;
         const gateMessage = {
           role: "user",
-          content: `You cannot finish yet: ${blocker}`
+          content: gateNudge(blocker)
         };
         messages.push(gateMessage);
         await options.onMessage?.(gateMessage);
@@ -82676,13 +82837,13 @@ ${outputContinuationPrefix}`);
         throw new Error("The model ended without an answer.");
       const backgroundResults = backgroundSubagents.size > 0 ? await drainBackground() : void 0;
       if (result.data && typeof result.data === "object") {
-        const summary3 = { ...result.data, final_message: pendingFinalMessage };
+        const summary3 = withReflection({ ...result.data, final_message: pendingFinalMessage });
         if (backgroundResults) {
           summary3.background_subagents = backgroundResults;
         }
         return { outcome: "completed", summary: summary3, turns: turn + 1 };
       }
-      const summary2 = await completeSession(session, pendingFinalMessage);
+      const summary2 = withReflection(await completeSession(session, pendingFinalMessage));
       if (backgroundResults) {
         summary2.background_subagents = backgroundResults;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencrowd",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "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",