@kroxy/kroxy 1.0.7 → 1.0.8

package/dist/src/utils/fetchWithRetry.js

@@ -0,0 +1,58 @@
+const RETRY_DELAYS = [500, 1000, 2000];
+/**
+ * fetch with exponential backoff retry and per-attempt timeout.
+ *
+ * Retries on:
+ *   - TypeError (network / DNS failure)
+ *   - HTTP 429 Too Many Requests (respects Retry-After header, cap 30s)
+ *   - HTTP 503 Service Unavailable
+ *
+ * Does NOT retry on other 4xx or 500/502.
+ */
+export async function fetchWithRetry(url, options = {}, timeoutMs = 10_000) {
+    let lastError;
+    for (let attempt = 0; attempt < 3; attempt++) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const resp = await fetch(url, { ...options, signal: controller.signal });
+            clearTimeout(timer);
+            if (resp.ok)
+                return resp;
+            if ((resp.status === 429 || resp.status === 503) && attempt < 2) {
+                let delay = RETRY_DELAYS[attempt];
+                if (resp.status === 429) {
+                    const retryAfter = resp.headers.get('Retry-After');
+                    if (retryAfter) {
+                        const secs = parseFloat(retryAfter);
+                        if (!isNaN(secs))
+                            delay = Math.min(secs * 1000, 30_000);
+                    }
+                }
+                await sleep(delay);
+                continue;
+            }
+            return resp;
+        }
+        catch (err) {
+            clearTimeout(timer);
+            const isAbort = err instanceof Error && (err.name === 'AbortError' || err.name === 'TimeoutError');
+            const isNetwork = err instanceof TypeError;
+            if ((isAbort || isNetwork) && attempt < 2) {
+                lastError = isAbort
+                    ? new Error(`Request timed out after ${timeoutMs}ms`)
+                    : err;
+                await sleep(RETRY_DELAYS[attempt]);
+                continue;
+            }
+            if (isAbort)
+                throw new Error(`Request timed out after ${timeoutMs}ms (3 attempts)`);
+            throw err;
+        }
+    }
+    throw lastError ?? new Error('fetchWithRetry: all attempts failed');
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=fetchWithRetry.js.map

package/dist/src/utils/fetchWithRetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWithRetry.js","sourceRoot":"","sources":["../../../src/utils/fetchWithRetry.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,UAAuB,EAAE,EACzB,SAAS,GAAG,MAAM;IAElB,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACzE,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,IAAI,IAAI,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;YAEzB,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChE,IAAI,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;gBAClC,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACxB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;oBACnD,IAAI,UAAU,EAAE,CAAC;wBACf,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;wBACpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;4BAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;oBAC1D,CAAC;gBACH,CAAC;gBACD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;YACrF,MAAM,SAAS,GAAG,GAAG,YAAY,SAAS,CAAC;YAE3C,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAC1C,SAAS,GAAG,OAAO;oBACjB,CAAC,CAAC,IAAI,KAAK,CAAC,2BAA2B,SAAS,IAAI,CAAC;oBACrD,CAAC,CAAC,GAAG,CAAC;gBACR,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,IAAI,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,iBAAiB,CAAC,CAAC;YACpF,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/index.ts

@@ -2,10 +2,22 @@ import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
 import { hireParams, executeHire } from './src/tools/hire.js';
 import { offerParams, executeOffer } from './src/tools/offer.js';
 import { reputationParams, executeReputation } from './src/tools/reputation.js';
+import { setupParams, executeSetup } from './src/tools/setup.js';
+import { statusParams, executeStatus } from './src/tools/status.js';
+import { balanceParams, executeBalance } from './src/tools/balance.js';
+import { browseParams, executeBrowse } from './src/tools/browse.js';
+import { disputeParams, executeDispute } from './src/tools/dispute.js';
+import { historyParams, executeHistory } from './src/tools/history.js';
 
 type ReputationToolParams = Parameters<typeof executeReputation>[0];
 type OfferToolParams = Parameters<typeof executeOffer>[0];
 type HireToolParams = Parameters<typeof executeHire>[0];
+type SetupToolParams = Parameters<typeof executeSetup>[0];
+type StatusToolParams = Parameters<typeof executeStatus>[0];
+type BalanceToolParams = Parameters<typeof executeBalance>[0];
+type BrowseToolParams = Parameters<typeof executeBrowse>[0];
+type DisputeToolParams = Parameters<typeof executeDispute>[0];
+type HistoryToolParams = Parameters<typeof executeHistory>[0];
 
 export default {
   id: 'kroxy',
@@ -18,7 +30,23 @@ export default {
     if (cfg.KROXY_AGENT_PRIVATE_KEY) process.env.KROXY_AGENT_PRIVATE_KEY = cfg.KROXY_AGENT_PRIVATE_KEY;
     if (cfg.KROXY_DEMO_MODE) process.env.KROXY_DEMO_MODE = cfg.KROXY_DEMO_MODE;
     if (cfg.NEXUS_URL) process.env.NEXUS_URL = cfg.NEXUS_URL;
-    // Read-only reputation lookup — always available, no side effects.
+
+    // ── Setup / Onboarding ────────────────────────────────────────────────────
+    // Run this first to check configuration and get guided setup instructions.
+    api.registerTool({
+      name: 'kroxy_setup',
+      label: 'Kroxy Setup',
+      description:
+        'Check your Kroxy configuration and connectivity. Run this first to diagnose any setup issues. ' +
+        'Shows API reachability, demo mode status, wallet config, and what to fix next.',
+      parameters: setupParams,
+      async execute(_id: string, params: SetupToolParams) {
+        return executeSetup(params);
+      },
+    });
+
+    // ── Read-only tools — always available ────────────────────────────────────
+
     api.registerTool({
       name: 'kroxy_reputation',
       label: 'Kroxy Reputation',
@@ -31,8 +59,57 @@ export default {
       },
     });
 
+    api.registerTool({
+      name: 'kroxy_status',
+      label: 'Kroxy Job Status',
+      description:
+        'Check the status of an active job mid-flight. Shows current status, agent assigned, ' +
+        'escrow amount, and time elapsed. Use after kroxy_hire with the returned jobId.',
+      parameters: statusParams,
+      async execute(_id: string, params: StatusToolParams) {
+        return executeStatus(params);
+      },
+    });
+
+    api.registerTool({
+      name: 'kroxy_balance',
+      label: 'Kroxy Balance',
+      description:
+        'Check your USDC balance, pending escrow totals, and total earned in one call. ' +
+        'Defaults to your own agent wallet (KROXY_AGENT_WALLET).',
+      parameters: balanceParams,
+      async execute(_id: string, params: BalanceToolParams) {
+        return executeBalance(params);
+      },
+    });
+
+    api.registerTool({
+      name: 'kroxy_browse',
+      label: 'Kroxy Browse',
+      description:
+        'Browse available agents on the Kroxy network or view the open job board. ' +
+        'Filter by capability and price. Use mode="agents" to find providers, mode="jobs" for open work.',
+      parameters: browseParams,
+      async execute(_id: string, params: BrowseToolParams) {
+        return executeBrowse(params);
+      },
+    });
+
+    api.registerTool({
+      name: 'kroxy_history',
+      label: 'Kroxy History',
+      description:
+        'View your full job history — tasks hired, amounts paid, durations, and escrow tx hashes. ' +
+        'Provides a full audit trail for any agent wallet.',
+      parameters: historyParams,
+      async execute(_id: string, params: HistoryToolParams) {
+        return executeHistory(params);
+      },
+    });
+
+    // ── Mutating tools — require configuration ────────────────────────────────
+
     // Register your agent as a paid service provider on the Kroxy job board.
-    // Optional: requires a public webhook endpoint and configures on-chain identity.
     api.registerTool(
       {
         name: 'kroxy_offer',
@@ -49,7 +126,6 @@ export default {
     );
 
     // Hire another agent with USDC held in conditional escrow on Base.
-    // Optional: requires private key for on-chain signing and triggers financial transactions.
     api.registerTool(
       {
         name: 'kroxy_hire',
@@ -57,7 +133,7 @@ export default {
         description:
           'Hire a specialist agent to complete a task, paid in USDC via conditional escrow on Base. ' +
           'Funds are locked until work quality is verified — payment is automatic and trustless. ' +
-          'Requires KROXY_AGENT_WALLET and KROXY_AGENT_PRIVATE_KEY.',
+          'Requires KROXY_AGENT_WALLET. Set KROXY_DEMO_MODE=1 to try without a real private key.',
         parameters: hireParams,
         async execute(_id: string, params: HireToolParams) {
           return executeHire(params);
@@ -65,5 +141,22 @@ export default {
       },
       { optional: true },
     );
+
+    // Raise a dispute on a job in escrow.
+    api.registerTool(
+      {
+        name: 'kroxy_dispute',
+        label: 'Kroxy Dispute',
+        description:
+          'Raise a dispute on a job that is in escrow. Triggers arbitration by three independent ' +
+          'AI judges (Claude, GPT-4o, Gemini). Use when the delivered work does not meet requirements. ' +
+          'Requires KROXY_API_KEY.',
+        parameters: disputeParams,
+        async execute(_id: string, params: DisputeToolParams) {
+          return executeDispute(params);
+        },
+      },
+      { optional: true },
+    );
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kroxy/kroxy",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "type": "module",
   "description": "Trustless agent-to-agent payments via USDC escrow on Base blockchain",
   "license": "MIT",