agent-escrow 0.1.0 → 0.1.1

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "agent-escrow",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Decentralized marketplace for AI agents — post tasks, bid, escrow payments via Lightning, build trust via ai.wot",
   "main": "src/index.cjs",
+  "types": "src/index.d.cts",
   "bin": {
     "agent-escrow": "src/cli.cjs"
   },

package/src/index.d.cts

@@ -0,0 +1,213 @@
+// Type definitions for agent-escrow
+
+export interface Task {
+  eventId: string;
+  taskId: string;
+  poster: string;
+  title: string;
+  description: string;
+  budget: number;
+  deadline: number | null;
+  status: TaskStatus;
+  capabilities: string[];
+  minTrust: number | null;
+  lightningAddress: string | null;
+  worker: string | null;
+  createdAt: number;
+  raw: NostrEvent;
+}
+
+export interface Bid {
+  eventId: string;
+  bidder: string;
+  taskEventId: string;
+  posterPubkey: string;
+  amount: number;
+  lightningAddress: string;
+  eta: number | null;
+  message: string;
+  createdAt: number;
+  raw: NostrEvent;
+}
+
+export interface Delivery {
+  eventId: string;
+  worker: string;
+  taskEventId: string;
+  posterPubkey: string;
+  result: string;
+  hash: string | null;
+  createdAt: number;
+  raw: NostrEvent;
+}
+
+export interface Resolution {
+  eventId: string;
+  poster: string;
+  taskEventId: string;
+  workerPubkey: string;
+  type: ResolutionType;
+  paymentBolt11: string | null;
+  preimage: string | null;
+  message: string;
+  createdAt: number;
+  raw: NostrEvent;
+}
+
+export interface NostrEvent {
+  id: string;
+  pubkey: string;
+  kind: number;
+  created_at: number;
+  tags: string[][];
+  content: string;
+  sig: string;
+}
+
+export type TaskStatus = 'open' | 'claimed' | 'delivered' | 'completed' | 'cancelled' | 'disputed' | 'expired';
+export type ResolutionType = 'approve' | 'reject' | 'dispute';
+
+export interface MarketplaceOptions {
+  relays?: string[];
+  secretKey: string | Uint8Array;
+  nwcUrl?: string;
+  lightningAddress?: string;
+  defaultMinTrust?: number;
+  connectTimeoutMs?: number;
+}
+
+export interface PostTaskOptions {
+  title: string;
+  description?: string;
+  budget: number;
+  deadline?: number;
+  capabilities?: string[];
+  minTrust?: number;
+  lightningAddress?: string;
+  taskId?: string;
+}
+
+export interface BrowseOptions {
+  status?: TaskStatus | TaskStatus[];
+  capabilities?: string | string[];
+  poster?: string | string[];
+  minBudget?: number;
+  maxBudget?: number;
+  limit?: number;
+  since?: number;
+  timeoutMs?: number;
+}
+
+export interface SubmitBidOptions {
+  taskEventId: string;
+  posterPubkey: string;
+  amount: number;
+  lightningAddress?: string;
+  eta?: number;
+  message?: string;
+}
+
+export interface DeliverOptions {
+  taskEventId: string;
+  posterPubkey: string;
+  result: string;
+  includeHash?: boolean;
+}
+
+export interface ApproveOptions {
+  taskId: string;
+  workerPubkey: string;
+  workerLightningAddress?: string;
+  amount: number;
+  message?: string;
+}
+
+export interface DisputeOptions {
+  taskId: string;
+  workerPubkey: string;
+  reason: string;
+}
+
+export interface ApproveResult {
+  resolution: Resolution;
+  payment: { bolt11?: string; preimage?: string; amountSats: number; error?: string; manual?: boolean };
+  task: Task;
+}
+
+export interface DisputeResult {
+  resolution: Resolution;
+  task: Task;
+}
+
+export interface DeliveryVerification {
+  valid: boolean;
+  reason?: string;
+  expected?: string;
+  actual?: string;
+}
+
+export interface Marketplace {
+  pubkey: string;
+  postTask(opts: PostTaskOptions): Promise<Task>;
+  cancelTask(taskId: string): Promise<Task>;
+  browseTasks(opts?: BrowseOptions): Promise<Task[]>;
+  fetchTask(posterPubkey: string, taskId: string): Promise<Task | null>;
+  myTasks(opts?: { status?: TaskStatus | TaskStatus[]; limit?: number; timeoutMs?: number }): Promise<Task[]>;
+  myJobs(opts?: { status?: TaskStatus | TaskStatus[]; limit?: number; timeoutMs?: number }): Promise<Task[]>;
+  submitBid(opts: SubmitBidOptions): Promise<Bid>;
+  getBids(taskEventId: string): Promise<Bid[]>;
+  myBids(opts?: { limit?: number; since?: number; timeoutMs?: number }): Promise<Bid[]>;
+  acceptBid(taskId: string, bid: Bid): Promise<Task>;
+  deliver(opts: DeliverOptions): Promise<Delivery>;
+  getDeliveries(taskEventId: string): Promise<Delivery[]>;
+  approve(opts: ApproveOptions): Promise<ApproveResult>;
+  dispute(opts: DisputeOptions): Promise<DisputeResult>;
+  close(): Promise<void>;
+}
+
+export function createMarketplace(opts: MarketplaceOptions): Marketplace;
+
+export const KINDS: {
+  TASK: 30950;
+  BID: 950;
+  DELIVERY: 951;
+  RESOLUTION: 952;
+};
+
+export const TASK_STATUS: {
+  OPEN: 'open';
+  CLAIMED: 'claimed';
+  DELIVERED: 'delivered';
+  COMPLETED: 'completed';
+  CANCELLED: 'cancelled';
+  DISPUTED: 'disputed';
+  EXPIRED: 'expired';
+};
+
+export const RESOLUTION_TYPES: {
+  APPROVE: 'approve';
+  REJECT: 'reject';
+  DISPUTE: 'dispute';
+};
+
+export function createTaskEvent(opts: PostTaskOptions): object;
+export function createBidEvent(opts: SubmitBidOptions & { lightningAddress: string }): object;
+export function createDeliveryEvent(opts: DeliverOptions): object;
+export function createResolutionEvent(opts: { taskEventId: string; workerPubkey: string; type: ResolutionType; paymentBolt11?: string; preimage?: string; message?: string }): object;
+
+export function parseTask(event: NostrEvent): Task;
+export function parseBid(event: NostrEvent): Bid;
+export function parseDelivery(event: NostrEvent): Delivery;
+export function parseResolution(event: NostrEvent): Resolution;
+
+export function findTasks(relays: any[], opts?: BrowseOptions): Promise<Task[]>;
+export function findBids(relays: any[], taskEventId: string): Promise<Bid[]>;
+export function findDeliveries(relays: any[], taskEventId: string): Promise<Delivery[]>;
+export function findResolutions(relays: any[], taskEventId: string): Promise<Resolution[]>;
+export function getTask(relays: any[], posterPubkey: string, taskId: string): Promise<Task | null>;
+
+export function verifyDelivery(delivery: Delivery): DeliveryVerification;
+export function trustAvailable(): boolean;
+export function getTrustScore(pubkey: string, opts?: { relays?: string[] }): Promise<any | null>;
+export function meetsTrustThreshold(pubkey: string, minScore: number, opts?: { relays?: string[] }): Promise<boolean>;
+export function paymentsAvailable(): boolean;

package/src/marketplace.cjs

@@ -122,6 +122,43 @@ function createMarketplace(opts) {
     return getTask(r, posterPubkey, taskId);
   }
 
+  /**
+   * List my posted tasks (tasks I created)
+   */
+  async function myTasks(opts = {}) {
+    const r = await ensureConnected();
+    return findTasks(r, {
+      poster: pubkey,
+      status: opts.status,
+      limit: opts.limit || 50,
+      timeoutMs: opts.timeoutMs || 8000
+    });
+  }
+
+  /**
+   * List tasks assigned to me (I'm the worker)
+   */
+  async function myJobs(opts = {}) {
+    const r = await ensureConnected();
+    // Query all tasks that tag our pubkey
+    const filter = {
+      kinds: [KINDS.TASK],
+      '#p': [pubkey]
+    };
+    if (opts.limit) filter.limit = opts.limit;
+    const { queryRelays } = require('./nostr.cjs');
+    const events = await queryRelays(r, filter, opts.timeoutMs || 8000);
+    let tasks = events.map(parseTask);
+    // Filter to only tasks where we're the assigned worker (not poster)
+    tasks = tasks.filter(t => t.worker === pubkey && t.poster !== pubkey);
+    if (opts.status) {
+      const statuses = Array.isArray(opts.status) ? opts.status : [opts.status];
+      tasks = tasks.filter(t => statuses.includes(t.status));
+    }
+    tasks.sort((a, b) => b.createdAt - a.createdAt);
+    return tasks;
+  }
+
   // ── Bid operations ────────────────────────────────────
 
   /**
@@ -157,6 +194,18 @@ function createMarketplace(opts) {
     return findBids(r, taskEventId);
   }
 
+  /**
+   * List my submitted bids
+   */
+  async function myBids(opts = {}) {
+    const r = await ensureConnected();
+    return findMyBids(r, pubkey, {
+      limit: opts.limit || 50,
+      since: opts.since,
+      timeoutMs: opts.timeoutMs || 8000
+    });
+  }
+
   /**
    * Accept a bid — claims the task for the bidder
    */
@@ -340,10 +389,13 @@ function createMarketplace(opts) {
     cancelTask,
     browseTasks,
     fetchTask,
+    myTasks,
+    myJobs,
 
     // Bids
     submitBid,
     getBids,
+    myBids,
     acceptBid,
 
     // Delivery