@kroxy/kroxy 1.0.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kroxy/kroxy",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "description": "Trustless agent-to-agent payments via USDC escrow on Base blockchain",
   "license": "MIT",
@@ -10,12 +10,15 @@
     ".": "./dist/index.js"
   },
   "openclaw": {
-    "extensions": ["./index.ts"]
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
+    "extensions": [
+      "./index.ts"
+    ]
   },
+  "files": [
+    "dist",
+    "index.ts",
+    "openclaw.plugin.json"
+  ],
   "dependencies": {
     "@sinclair/typebox": "^0.32.0"
   },
@@ -25,5 +28,9 @@
   },
   "peerDependencies": {
     "openclaw": "*"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
   }
-}
+}

package/api.ts

@@ -1,3 +0,0 @@
-// Public exports for external consumers of this plugin.
-// Internal plugin code should import from ./src/* directly.
-export type { AgentProfile, Job, Bid, ConditionsDefinition, ReputationResult } from './src/client.js';

package/src/client.ts

@@ -1,154 +0,0 @@
-/**
- * Kroxy REST API client.
- * Reads KROXY_API_URL and KROXY_API_KEY from process.env at call time,
- * so runtime-injected env vars are always used.
- */
-
-export interface AgentProfile {
-  walletAddress: string;
-  name: string;
-  capabilities: string[];
-  pricingUsdc: string;
-  endpoint: string;
-}
-
-export interface Job {
-  id: string;
-  status: 'OPEN' | 'AWARDED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED';
-  bids?: Bid[];
-  deliverable?: Record<string, unknown> | null;
-  escrowId?: string | null;
-  posterWallet: string;
-  description: string;
-}
-
-export interface Bid {
-  id: string;
-  providerWallet: string;
-  priceUsdc: string;
-  status: 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'WITHDRAWN';
-}
-
-export interface ConditionsDefinition {
-  version: '1.0';
-  escrowId: string;
-  conditions: Condition[];
-  windowSeconds: number;
-  checkIntervalSeconds: number;
-  requiredPassRate: number;
-}
-
-export interface Condition {
-  type: 'http_status' | 'json_field' | 'latency_ms' | 'uptime_percent';
-  endpoint: string;
-  field?: string;
-  operator: 'eq' | 'gte' | 'lte' | 'contains';
-  expected: string | number | boolean;
-}
-
-export interface ReputationResult {
-  walletAddress: string;
-  successCount: number;
-  disputeCount: number;
-  totalEarned: string;
-  score: number;
-}
-
-function apiBase(): string {
-  return process.env.KROXY_API_URL ?? 'http://localhost:3001';
-}
-
-function authHeaders(): Record<string, string> {
-  const key = process.env.KROXY_API_KEY ?? '';
-  return {
-    'Content-Type': 'application/json',
-    'X-Kroxy-API-Key': key,
-  };
-}
-
-async function apiGet<T>(path: string): Promise<T> {
-  const res = await fetch(`${apiBase()}${path}`, { headers: authHeaders() });
-  if (!res.ok) throw new Error(`GET ${path} → ${res.status}: ${await res.text()}`);
-  return res.json() as Promise<T>;
-}
-
-async function apiPost<T>(path: string, body: unknown): Promise<T> {
-  const res = await fetch(`${apiBase()}${path}`, {
-    method: 'POST',
-    headers: authHeaders(),
-    body: JSON.stringify(body),
-  });
-  if (!res.ok) throw new Error(`POST ${path} → ${res.status}: ${await res.text()}`);
-  return res.json() as Promise<T>;
-}
-
-export function findAgents(capability: string, maxPrice: number): Promise<AgentProfile[]> {
-  return apiGet(`/api/agents/find?capability=${encodeURIComponent(capability)}&maxPrice=${maxPrice}`);
-}
-
-export function postJob(
-  jobId: string,
-  description: string,
-  capability: string,
-  budgetUsdc: number,
-  conditionsJson: ConditionsDefinition,
-  posterWallet: string,
-): Promise<Job> {
-  const deadline = new Date(Date.now() + 30 * 60 * 1000).toISOString();
-  return apiPost('/api/jobs', {
-    id: jobId,
-    posterWallet,
-    description,
-    budgetMaxUsdc: budgetUsdc,
-    requiredCaps: [capability],
-    deadline,
-    conditionsJson,
-  });
-}
-
-export function acceptBid(
-  jobId: string,
-  bidId: string,
-  payerPrivateKey: string,
-): Promise<{ jobId: string; bidId: string; escrowId: string; txHash: string }> {
-  return apiPost(`/api/jobs/${jobId}/accept/${bidId}`, { payerPrivateKey });
-}
-
-export async function pollJob(
-  jobId: string,
-  condition: (job: Job) => boolean,
-  maxMs = 300_000,
-  intervalMs = 5_000,
-): Promise<Job | null> {
-  const deadline = Date.now() + maxMs;
-  while (Date.now() < deadline) {
-    const job = await apiGet<Job>(`/api/jobs/${jobId}`);
-    if (condition(job)) return job;
-    await new Promise<void>((r) => setTimeout(r, intervalMs));
-  }
-  return null;
-}
-
-export function getReputation(walletAddress: string): Promise<ReputationResult> {
-  return apiGet(`/api/reputation/${walletAddress}`);
-}
-
-export function registerProvider(opts: {
-  walletAddress: string;
-  name: string;
-  endpoint: string;
-  capabilities: string[];
-  pricingUsdc: number;
-  modelName?: string;
-}): Promise<AgentProfile> {
-  return apiPost('/api/agents/register', {
-    walletAddress: opts.walletAddress,
-    name: opts.name,
-    endpoint: opts.endpoint,
-    modelName: opts.modelName,
-    capabilities: opts.capabilities,
-    pricingUsdc: opts.pricingUsdc,
-    slaUptimePct: 99,
-    slaResponseMs: 30000,
-  });
-}

package/src/tools/hire.ts

@@ -1,111 +0,0 @@
-import { randomBytes } from 'node:crypto';
-import { Type } from '@sinclair/typebox';
-import type { ConditionsDefinition } from '../client.js';
-import {
-  findAgents,
-  postJob,
-  acceptBid,
-  pollJob,
-} from '../client.js';
-
-export const hireParams = Type.Object({
-  task: Type.String({ description: 'What you want the hired agent to do, e.g. "Research the top AI payment startups"' }),
-  maxPrice: Type.Optional(Type.Number({ minimum: 0.01, description: 'Maximum USDC budget, default 5.00' })),
-  capability: Type.Optional(Type.String({ description: 'Agent capability to match: research, writing, coding. Auto-detected from task if omitted.' })),
-});
-
-function detectCapability(task: string): string {
-  if (/research|find|search|analyz|summariz|look up/i.test(task)) return 'research';
-  if (/write|draft|essay|blog|article|copy/i.test(task)) return 'writing';
-  if (/code|script|function|implement|build|program/i.test(task)) return 'coding';
-  return 'research';
-}
-
-function buildConditions(nexusUrl: string, jobId: string): ConditionsDefinition {
-  return {
-    version: '1.0',
-    escrowId: '',
-    conditions: [
-      { type: 'http_status', endpoint: `${nexusUrl}/health`, operator: 'eq', expected: 200 },
-      {
-        type: 'json_field',
-        endpoint: `${nexusUrl}/quality-check?jobId=${encodeURIComponent(jobId)}`,
-        field: 'wordCount',
-        operator: 'gte',
-        expected: 100,
-      },
-      {
-        type: 'json_field',
-        endpoint: `${nexusUrl}/quality-check?jobId=${encodeURIComponent(jobId)}`,
-        field: 'confidence',
-        operator: 'gte',
-        expected: 0.7,
-      },
-    ],
-    windowSeconds: 120,
-    checkIntervalSeconds: 10,
-    requiredPassRate: 0.8,
-  };
-}
-
-export async function executeHire(
-  params: { task: string; maxPrice?: number; capability?: string },
-): Promise<{ content: [{ type: 'text'; text: string }]; details: unknown }> {
-  const wallet = process.env.KROXY_AGENT_WALLET;
-  const privateKey = process.env.KROXY_AGENT_PRIVATE_KEY;
-  const nexusUrl = process.env.NEXUS_URL ?? 'http://localhost:3003';
-  const demoMode = process.env.KROXY_DEMO_MODE === '1';
-
-  if (!wallet) throw new Error('KROXY_AGENT_WALLET is not configured');
-  if (!demoMode && !privateKey) throw new Error('KROXY_AGENT_PRIVATE_KEY is not configured');
-
-  const task = params.task;
-  const maxPrice = params.maxPrice ?? 5.0;
-  const capability = params.capability ?? detectCapability(task);
-  const payerPrivateKey = privateKey ?? 'demo-private-key';
-  const jobId = `job_${Date.now()}_${randomBytes(3).toString('hex')}`;
-
-  // 1. Find matching agents
-  const agents = await findAgents(capability, maxPrice);
-  if (!agents.length) {
-    throw new Error(`No agents available for "${capability}" within $${maxPrice} USDC`);
-  }
-
-  // 2. Post job with verifier conditions pointing at Nexus
-  const conditions = buildConditions(nexusUrl, jobId);
-  const job = await postJob(jobId, task, capability, maxPrice, conditions, wallet);
-
-  // 3. Wait for a bid (up to 60s)
-  const jobWithBid = await pollJob(job.id, (j) => Boolean(j.bids?.length), 60_000);
-  if (!jobWithBid?.bids?.length) {
-    throw new Error(`No bids received within 60 seconds (jobId: ${job.id})`);
-  }
-
-  const bid = jobWithBid.bids[0];
-
-  // 4. Accept bid — locks USDC in escrow on Base
-  const escrowResult = await acceptBid(job.id, bid.id, payerPrivateKey);
-
-  // 5. Poll for completion (up to 5 minutes)
-  const completed = await pollJob(job.id, (j) => j.status === 'COMPLETED', 300_000);
-  if (!completed) {
-    throw new Error(
-      `Job timed out (jobId: ${job.id}, escrowId: ${escrowResult.escrowId}). ` +
-      `Funds are in escrow — check status at /api/jobs/${job.id}`,
-    );
-  }
-
-  const result = {
-    summary: (completed.deliverable as any)?.summary ?? '(no summary)',
-    keyFindings: (completed.deliverable as any)?.keyFindings ?? [],
-    sources: (completed.deliverable as any)?.sources ?? [],
-    agent: bid.providerWallet,
-    amountPaid: `${bid.priceUsdc} USDC`,
-    auditTrail: `https://kroxy.ai/audit/${escrowResult.escrowId}`,
-  };
-
-  return {
-    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-    details: result,
-  };
-}

package/src/tools/offer.ts

@@ -1,41 +0,0 @@
-import { Type } from '@sinclair/typebox';
-import { registerProvider } from '../client.js';
-
-export const offerParams = Type.Object({
-  capability: Type.String({ description: 'Capability to offer: research, writing, coding, analysis, etc.' }),
-  price: Type.Number({ minimum: 0.01, description: 'Price per job in USDC, e.g. 2.50' }),
-  endpoint: Type.String({ description: 'Public URL where your agent receives job webhooks, e.g. https://myagent.example.com' }),
-  name: Type.Optional(Type.String({ description: 'Display name for your agent on the Kroxy job board' })),
-});
-
-export async function executeOffer(
-  params: { capability: string; price: number; endpoint: string; name?: string },
-): Promise<{ content: [{ type: 'text'; text: string }]; details: unknown }> {
-  const wallet = process.env.KROXY_AGENT_WALLET;
-  if (!wallet) throw new Error('KROXY_AGENT_WALLET is not configured');
-
-  const agent = await registerProvider({
-    walletAddress: wallet,
-    name: params.name ?? 'MyAgent',
-    endpoint: params.endpoint,
-    capabilities: [params.capability],
-    pricingUsdc: params.price,
-  });
-
-  const result = {
-    registered: true,
-    walletAddress: agent.walletAddress ?? wallet,
-    name: agent.name ?? params.name,
-    capabilities: agent.capabilities ?? [params.capability],
-    pricingUsdc: agent.pricingUsdc ?? params.price,
-    endpoint: params.endpoint,
-  };
-
-  return {
-    content: [{
-      type: 'text',
-      text: JSON.stringify(result, null, 2),
-    }],
-    details: result,
-  };
-}

package/src/tools/reputation.ts

@@ -1,41 +0,0 @@
-import { Type } from '@sinclair/typebox';
-import { getReputation } from '../client.js';
-
-export const reputationParams = Type.Object({
-  wallet: Type.Optional(Type.String({
-    description: 'Wallet address to look up. Defaults to KROXY_AGENT_WALLET (your own agent).',
-    pattern: '^0x[0-9a-fA-F]{40}$',
-  })),
-});
-
-export async function executeReputation(
-  params: { wallet?: string },
-): Promise<{ content: [{ type: 'text'; text: string }]; details: unknown }> {
-  const walletAddress = params.wallet ?? process.env.KROXY_AGENT_WALLET;
-  if (!walletAddress) throw new Error('No wallet address provided and KROXY_AGENT_WALLET is not configured');
-
-  const rep = await getReputation(walletAddress);
-  const score = rep.score ?? 0;
-  const interpretation =
-    score >= 80 ? 'Excellent — highly trusted agent' :
-    score >= 60 ? 'Good — established track record' :
-    score >= 20 ? 'New — building reputation' :
-                  'Low — exercise caution';
-
-  const result = {
-    address: walletAddress,
-    score,
-    successCount: rep.successCount ?? 0,
-    disputeCount: rep.disputeCount ?? 0,
-    totalEarned: rep.totalEarned ?? '0',
-    interpretation,
-  };
-
-  return {
-    content: [{
-      type: 'text',
-      text: JSON.stringify(result, null, 2),
-    }],
-    details: result,
-  };
-}

package/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "rootDir": ".",
-    "outDir": "./dist"
-  },
-  "include": ["index.ts", "api.ts", "src/**/*.ts"],
-  "exclude": ["dist", "node_modules"]
-}