kompass-sdk 0.1.0

package/dist/adapters/openclaw.js

@@ -0,0 +1,168 @@
+const bigintReplacer = (_k, v) => (typeof v === "bigint" ? v.toString() : v);
+export const SKILL_MD = `---
+name: kompass
+version: 1.0.0
+description: Discover, hire, and pay AI agents via decentralized escrow on Base
+author: Kompass Protocol
+tags: [defi, agents, escrow, reputation, base]
+---
+
+# Kompass Protocol
+
+Interact with the Kompass agentic commerce protocol on Base.
+Discover agents, create escrow jobs, check reputation, and route DeFi intents.
+
+## Actions
+
+### discover
+Find agents by category and reputation.
+- category (string, optional): Filter category (e.g. "defi", "data")
+- agentType (string, optional): "provider" | "evaluator" | "both"
+- verifiedOnly (boolean, optional): Only return identity-verified agents
+
+### get_agent
+Get a single agent's profile.
+- address (string, required): Agent wallet address
+
+### create_job
+Create an escrow job with a provider and evaluator.
+- provider (string, required): Provider address
+- evaluator (string, required): Evaluator address
+- budget (string, required): Budget in USDC base units
+- expiredAt (string, required): Expiry unix timestamp
+- description (string, required): Job description
+
+### fund_job
+Fund an existing job, locking USDC in escrow.
+- jobId (string, required): Job ID
+
+### submit
+Submit a deliverable for evaluation.
+- jobId (string, required): Job ID
+- deliverable (string, required): Deliverable hash (bytes32)
+
+### complete
+Mark a job as complete, releasing payment (evaluator only).
+- jobId (string, required): Job ID
+- reason (string, optional): Attestation hash
+
+### get_reputation
+Check an agent's onchain ERC-8004 reputation.
+- agentId (string, required): ERC-8004 agent ID
+
+### route_yield_intent
+Route a DeFi yield intent to specialist agents.
+- amount (string, required): Capital in USDC base units
+- riskTolerance (string, required): "conservative" | "balanced" | "aggressive"
+
+### register
+Register your agent on Kompass. Sets ENS text records and calls registerAgent().
+- ensNode (string, required): ENS namehash of your Basename (bytes32)
+- agentType (string, required): "provider" | "evaluator" | "both"
+- categories (string, required): Comma-separated categories
+- description (string, required): What your agent does
+- paymentMode (string, optional): "escrow" | "x402" | "hybrid"
+- pricingRate (string, optional): Price in USDC base units
+
+### update_profile
+Update your agent's profile. Only provided fields are changed.
+- ensNode (string, required): Your ENS namehash
+- categories (string, optional): Updated categories
+- description (string, optional): Updated description
+
+### deregister
+Remove your agent from discovery.
+
+### approve_usdc
+Approve USDC spending for escrow. Required before fund_job.
+- spender (string, required): Spender contract address
+- amount (string, required): Amount in USDC base units
+
+### get_balance
+Get your agent's USDC and ETH balance.
+`;
+export async function handleSkill(kompass, action, params) {
+    switch (action) {
+        case "discover": {
+            const results = await kompass.discover({
+                category: params.category,
+                agentType: params.agentType,
+                verifiedOnly: params.verifiedOnly === "true",
+            });
+            return JSON.stringify(results, bigintReplacer);
+        }
+        case "get_agent": {
+            const agent = await kompass.getAgent(params.address);
+            return JSON.stringify(agent, bigintReplacer);
+        }
+        case "create_job": {
+            const result = await kompass.createJob({
+                provider: params.provider,
+                evaluator: params.evaluator,
+                budget: BigInt(params.budget),
+                expiredAt: BigInt(params.expiredAt),
+                description: params.description,
+            });
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "fund_job": {
+            const result = await kompass.fund(BigInt(params.jobId));
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "submit": {
+            const result = await kompass.submit(BigInt(params.jobId), params.deliverable);
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "complete": {
+            const result = await kompass.complete(BigInt(params.jobId), params.reason);
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "get_reputation": {
+            const result = await kompass.getReputation(BigInt(params.agentId));
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "route_yield_intent": {
+            const route = await kompass.routeYieldIntent({
+                amount: BigInt(params.amount),
+                riskTolerance: params.riskTolerance,
+                chain: "Base",
+                stablecoin: "USDC",
+            });
+            return JSON.stringify(route, bigintReplacer);
+        }
+        case "register": {
+            const result = await kompass.register({
+                ensNode: params.ensNode,
+                agentType: params.agentType,
+                categories: params.categories,
+                description: params.description,
+                paymentMode: params.paymentMode,
+                pricingRate: params.pricingRate,
+            });
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "update_profile": {
+            const { ensNode, ...updates } = params;
+            const result = await kompass.updateProfile(ensNode, updates);
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "deregister": {
+            const result = await kompass.deregister();
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "approve_usdc": {
+            const amount = params.amount === "max"
+                ? BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff")
+                : BigInt(params.amount);
+            const result = await kompass.approveToken(params.spender, amount);
+            return JSON.stringify(result, bigintReplacer);
+        }
+        case "get_balance": {
+            const result = await kompass.getBalance();
+            return JSON.stringify(result, bigintReplacer);
+        }
+        default:
+            return JSON.stringify({ error: `Unknown action: ${action}` });
+    }
+}
+//# sourceMappingURL=openclaw.js.map

package/dist/adapters/openclaw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.js","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"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"}

package/dist/aggregator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Kompass Aggregator
+ * Searches all source adapters in parallel, deduplicates, and ranks results.
+ */
+import type { SourceAdapter, UnifiedAgent, SourceSearchOptions } from "./sources/types.js";
+export interface AggregatorOptions extends SourceSearchOptions {
+    /** Only search these sources (by name) */
+    sources?: string[];
+    /** Minimum relevance score to include (0-100) */
+    minScore?: number;
+}
+export interface AggregatorResult {
+    agents: UnifiedAgent[];
+    sources: {
+        name: string;
+        count: number;
+        durationMs: number;
+        error?: string;
+    }[];
+    totalFound: number;
+    deduplicated: number;
+    queryTimeMs: number;
+}
+export declare class Aggregator {
+    private adapters;
+    constructor(adapters: SourceAdapter[]);
+    search(query: string, options?: AggregatorOptions): Promise<AggregatorResult>;
+    healthCheck(): Promise<{
+        name: string;
+        displayName: string;
+        healthy: boolean;
+    }[]>;
+    private deduplicate;
+    private scoreAndRank;
+}
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../src/aggregator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE3F,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,QAAQ,EAAE,aAAa,EAAE;IAI/B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoE7E,WAAW,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAcvF,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,YAAY;CA0CrB"}

package/dist/aggregator.js

@@ -0,0 +1,168 @@
+/**
+ * Kompass Aggregator
+ * Searches all source adapters in parallel, deduplicates, and ranks results.
+ */
+export class Aggregator {
+    adapters;
+    constructor(adapters) {
+        this.adapters = adapters;
+    }
+    async search(query, options) {
+        const startTime = Date.now();
+        const limit = options?.limit ?? 50;
+        const timeout = options?.timeout ?? 15000;
+        // Filter adapters by source name if specified
+        const activeAdapters = options?.sources
+            ? this.adapters.filter((a) => options.sources.includes(a.name))
+            : this.adapters;
+        // Fan out to all sources in parallel
+        const promises = activeAdapters.map(async (adapter) => {
+            const adapterStart = Date.now();
+            try {
+                const results = await adapter.search(query, { limit, timeout });
+                return {
+                    name: adapter.name,
+                    displayName: adapter.displayName,
+                    results,
+                    durationMs: Date.now() - adapterStart,
+                    error: undefined,
+                };
+            }
+            catch (err) {
+                return {
+                    name: adapter.name,
+                    displayName: adapter.displayName,
+                    results: [],
+                    durationMs: Date.now() - adapterStart,
+                    error: err instanceof Error ? err.message : String(err),
+                };
+            }
+        });
+        const settled = await Promise.allSettled(promises);
+        const sourceResults = settled.map((s) => s.status === "fulfilled" ? s.value : { name: "unknown", displayName: "Unknown", results: [], durationMs: 0, error: "Promise rejected" });
+        // Flatten all results
+        const allAgents = sourceResults.flatMap((s) => s.results);
+        const totalFound = allAgents.length;
+        // Deduplicate
+        const deduped = this.deduplicate(allAgents);
+        const deduplicated = totalFound - deduped.length;
+        // Score and rank
+        const scored = this.scoreAndRank(deduped, query);
+        // Apply minimum score filter
+        const filtered = options?.minScore
+            ? scored.filter((a) => a._score >= options.minScore)
+            : scored;
+        return {
+            agents: filtered.slice(0, limit),
+            sources: sourceResults.map((s) => ({
+                name: s.name,
+                count: s.results.length,
+                durationMs: s.durationMs,
+                error: s.error,
+            })),
+            totalFound,
+            deduplicated,
+            queryTimeMs: Date.now() - startTime,
+        };
+    }
+    async healthCheck() {
+        const results = await Promise.allSettled(this.adapters.map(async (adapter) => ({
+            name: adapter.name,
+            displayName: adapter.displayName,
+            healthy: await adapter.ping(),
+        })));
+        return results.map((r) => r.status === "fulfilled" ? r.value : { name: "unknown", displayName: "Unknown", healthy: false });
+    }
+    deduplicate(agents) {
+        const seen = new Map();
+        for (const agent of agents) {
+            // Generate dedup keys from endpoints
+            const keys = [
+                agent.endpoints.mcp,
+                agent.endpoints.a2a,
+                agent.endpoints.x402,
+                agent.endpoints.http,
+                agent.endpoints.acp?.walletAddress,
+            ].filter(Boolean);
+            let existingKey;
+            for (const key of keys) {
+                if (seen.has(key)) {
+                    existingKey = key;
+                    break;
+                }
+            }
+            if (existingKey) {
+                // Merge: keep richer data
+                const existing = seen.get(existingKey);
+                existing.categories = [...new Set([...existing.categories, ...agent.categories])];
+                existing.capabilities = [...new Set([...existing.capabilities, ...agent.capabilities])];
+                if (!existing.reputation && agent.reputation)
+                    existing.reputation = agent.reputation;
+                if (!existing.pricing && agent.pricing)
+                    existing.pricing = agent.pricing;
+                if (agent.description.length > existing.description.length)
+                    existing.description = agent.description;
+            }
+            else {
+                // New agent
+                for (const key of keys) {
+                    if (key)
+                        seen.set(key, agent);
+                }
+                // Also key by name for simple dedup
+                if (!seen.has(agent.name.toLowerCase())) {
+                    seen.set(agent.name.toLowerCase(), agent);
+                }
+            }
+        }
+        // Return unique agents
+        const uniqueAgents = new Map();
+        for (const agent of seen.values()) {
+            uniqueAgents.set(agent.id, agent);
+        }
+        return Array.from(uniqueAgents.values());
+    }
+    scoreAndRank(agents, query) {
+        const queryLower = query.toLowerCase();
+        const queryTerms = queryLower.split(/\s+/).filter((t) => t.length > 2);
+        return agents
+            .map((agent) => {
+            let score = 0;
+            const searchText = `${agent.name} ${agent.description} ${agent.categories.join(" ")} ${agent.capabilities.join(" ")}`.toLowerCase();
+            // Term matching (BM25-lite)
+            for (const term of queryTerms) {
+                if (agent.name.toLowerCase().includes(term))
+                    score += 10;
+                if (agent.description.toLowerCase().includes(term))
+                    score += 5;
+                if (agent.categories.some((c) => c.includes(term)))
+                    score += 8;
+                if (agent.capabilities.some((c) => c.toLowerCase().includes(term)))
+                    score += 3;
+            }
+            // Reputation bonus
+            if (agent.reputation) {
+                score += Math.min(agent.reputation.score * 2, 20);
+                score += Math.min(agent.reputation.count, 10);
+            }
+            // Verified bonus
+            if (agent.verified)
+                score += 5;
+            // Has pricing info bonus (transparency)
+            if (agent.pricing && agent.pricing.model !== "unknown")
+                score += 3;
+            // Has multiple endpoints bonus (more interoperable)
+            const endpointCount = Object.values(agent.endpoints).filter(Boolean).length;
+            score += endpointCount * 2;
+            // Protocol diversity bonus
+            if (agent.protocol === "mcp")
+                score += 2; // MCP is most interoperable
+            if (agent.protocol === "a2a")
+                score += 2;
+            agent._score = score;
+            return agent;
+        })
+            .sort((a, b) => (b._score ?? 0) - (a._score ?? 0));
+    }
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.js","sourceRoot":"","sources":["../src/aggregator.ts"],"names":[],"mappings":"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"}

package/dist/backends/acp.d.ts

@@ -0,0 +1,29 @@
+import type { Address } from "viem";
+import type { EscrowBackend, AgentSearchResult, JobResult, BrowseOptions, IncomingJob } from "./types.js";
+export interface AcpBackendConfig {
+    /** Private key for the agent wallet (whitelisted on ACP) */
+    privateKey: string;
+    /** Agent's wallet address on ACP */
+    walletAddress: Address;
+    /** Entity/session key address from ACP registration */
+    entityAddress: Address;
+    /** Network: "base-sepolia" or "base" */
+    network?: "base-sepolia" | "base";
+    /** Custom RPC URL */
+    rpcUrl?: string;
+}
+export declare class AcpEscrowBackend implements EscrowBackend {
+    private client;
+    private config;
+    private jobHandlers;
+    constructor(config: AcpBackendConfig);
+    name(): string;
+    init(): Promise<void>;
+    browseAgents(query: string, options?: BrowseOptions): Promise<AgentSearchResult[]>;
+    hireAgent(agent: AgentSearchResult, offeringId: string, requirements: Record<string, unknown>, _budget?: bigint): Promise<JobResult>;
+    waitForResult(jobId: string, timeoutMs?: number): Promise<JobResult>;
+    acceptJobs(capabilities: string[], handler: (job: IncomingJob) => Promise<unknown>): Promise<void>;
+    private handleIncomingJob;
+    private mapAcpAgent;
+}
+//# sourceMappingURL=acp.d.ts.map

package/dist/backends/acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../../src/backends/acp.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAO,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAEjB,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;IAClC,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAA6D;gBAEpE,MAAM,EAAE,gBAAgB;IAIpC,IAAI,IAAI,MAAM;IAIR,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrB,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAazB,SAAS,CACb,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,CAAC;IAef,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,SAAS,SAAU,GAClB,OAAO,CAAC,SAAS,CAAC;IA+Bf,UAAU,CACd,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC;YAQF,iBAAiB;IAyB/B,OAAO,CAAC,WAAW;CAyBpB"}

package/dist/backends/acp.js

@@ -0,0 +1,126 @@
+import AcpClient, { AcpContractClientV2, baseSepoliaAcpConfigV2, baseAcpConfigV2, } from "@virtuals-protocol/acp-node";
+export class AcpEscrowBackend {
+    client;
+    config;
+    jobHandlers = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    name() {
+        return "virtuals-acp";
+    }
+    async init() {
+        const acpConfig = this.config.network === "base"
+            ? baseAcpConfigV2
+            : baseSepoliaAcpConfigV2;
+        const contractClient = await AcpContractClientV2.build(this.config.privateKey, this.config.entityAddress, this.config.walletAddress, this.config.rpcUrl, acpConfig);
+        this.client = new AcpClient({
+            acpContractClient: contractClient,
+            walletAddress: this.config.walletAddress,
+            entityAddress: this.config.entityAddress,
+            onNewTask: (job) => this.handleIncomingJob(job),
+        });
+        await this.client.init();
+    }
+    async browseAgents(query, options) {
+        const agents = await this.client.browseAgents({
+            keyword: query,
+            onlineStatus: options?.onlineOnly ? "online" : "all",
+            limit: options?.limit ?? 20,
+            sortBy: options?.sortBy === "successRate" ? "successRate" : undefined,
+        });
+        return (agents ?? []).map((agent) => this.mapAcpAgent(agent));
+    }
+    async hireAgent(agent, offeringId, requirements, _budget) {
+        const job = await this.client.initiateJob({
+            providerAddress: agent.address,
+            jobOfferingId: offeringId,
+            requirements,
+            skipEvaluation: true,
+        });
+        return {
+            jobId: job.id ?? String(job),
+            phase: "REQUEST",
+            deliverable: null,
+        };
+    }
+    async waitForResult(jobId, timeoutMs = 300_000) {
+        const start = Date.now();
+        const pollInterval = 5_000;
+        while (Date.now() - start < timeoutMs) {
+            const job = await this.client.getJobById(Number(jobId));
+            const phase = job?.phase ?? job?.status;
+            if (phase === "COMPLETED" || phase === "completed") {
+                return {
+                    jobId,
+                    phase: "COMPLETED",
+                    deliverable: job?.deliverable ?? job?.result,
+                    txHash: job?.txHash,
+                };
+            }
+            if (phase === "CANCELLED" || phase === "REJECTED" || phase === "EXPIRED") {
+                return {
+                    jobId,
+                    phase,
+                    deliverable: null,
+                };
+            }
+            await new Promise((r) => setTimeout(r, pollInterval));
+        }
+        throw new Error(`Timeout waiting for job ${jobId} (${timeoutMs}ms)`);
+    }
+    async acceptJobs(capabilities, handler) {
+        for (const cap of capabilities) {
+            this.jobHandlers.set(cap, handler);
+        }
+        // The onNewTask callback set during init() will dispatch to handlers
+        console.log(`[ACP] Listening for jobs: ${capabilities.join(", ")}`);
+    }
+    async handleIncomingJob(acpJob) {
+        const job = {
+            jobId: acpJob.id,
+            description: acpJob.requirement?.description ?? "",
+            requirements: acpJob.requirement ?? {},
+            budget: BigInt(acpJob.price ?? 0),
+            clientAddress: acpJob.clientAddress,
+        };
+        // Find a matching handler
+        for (const [, handler] of this.jobHandlers) {
+            try {
+                const result = await handler(job);
+                // Deliver the result back through ACP
+                await acpJob.deliver?.({
+                    content: typeof result === "string" ? result : JSON.stringify(result),
+                    contentType: "application/json",
+                });
+                return;
+            }
+            catch (err) {
+                console.error(`[ACP] Handler failed for job ${job.jobId}:`, err);
+            }
+        }
+    }
+    mapAcpAgent(agent) {
+        const offerings = (agent.jobOfferings ?? []).map((o) => ({
+            id: o.id,
+            name: o.name ?? o.title ?? "Service",
+            description: o.description ?? "",
+            price: BigInt(o.price ?? 0),
+            currency: "USDC",
+        }));
+        return {
+            id: agent.id ?? agent.walletAddress,
+            name: agent.name ?? "Unknown Agent",
+            address: (agent.walletAddress ?? agent.contractAddress),
+            description: agent.description ?? "",
+            categories: agent.tags ?? agent.categories ?? [],
+            offerings,
+            metrics: {
+                successRate: agent.metrics?.successRate,
+                completedJobs: agent.metrics?.completedJobs,
+            },
+            source: "acp",
+        };
+    }
+}
+//# sourceMappingURL=acp.js.map

package/dist/backends/acp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.js","sourceRoot":"","sources":["../../src/backends/acp.ts"],"names":[],"mappings":"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"}

package/dist/backends/types.d.ts

@@ -0,0 +1,59 @@
+import type { Address } from "viem";
+/**
+ * Abstraction over escrow backends (Kompass native or Virtuals ACP).
+ * The simplified SDK uses this interface so it can swap backends
+ * without changing any user-facing code.
+ */
+export interface AgentSearchResult {
+    id: string;
+    name: string;
+    address: Address;
+    description: string;
+    categories: string[];
+    offerings: AgentOffering[];
+    metrics?: {
+        successRate?: number;
+        completedJobs?: number;
+    };
+    source: "acp" | "kompass";
+}
+export interface AgentOffering {
+    id: string;
+    name: string;
+    description: string;
+    price: bigint;
+    currency: string;
+}
+export interface JobResult {
+    jobId: string;
+    phase: string;
+    deliverable: unknown;
+    txHash?: string;
+}
+export interface EscrowBackend {
+    /** Initialize the backend (auth, websocket connections, etc.) */
+    init(): Promise<void>;
+    /** Search for agents that can do a task */
+    browseAgents(query: string, options?: BrowseOptions): Promise<AgentSearchResult[]>;
+    /** Create and fund a job with an agent */
+    hireAgent(agent: AgentSearchResult, offeringId: string, requirements: Record<string, unknown>, budget?: bigint): Promise<JobResult>;
+    /** Poll/wait for a job to complete */
+    waitForResult(jobId: string, timeoutMs?: number): Promise<JobResult>;
+    /** Register as a seller and listen for incoming jobs */
+    acceptJobs(capabilities: string[], handler: (job: IncomingJob) => Promise<unknown>): Promise<void>;
+    /** Get the backend name */
+    name(): string;
+}
+export interface BrowseOptions {
+    limit?: number;
+    sortBy?: "successRate" | "completedJobs" | "recent";
+    onlineOnly?: boolean;
+}
+export interface IncomingJob {
+    jobId: string;
+    description: string;
+    requirements: Record<string, unknown>;
+    budget: bigint;
+    clientAddress: Address;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/backends/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAO,MAAM,MAAM,CAAC;AAEzC;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,2CAA2C;IAC3C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEnF,0CAA0C;IAC1C,SAAS,CACP,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtB,sCAAsC;IACtC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAErE,wDAAwD;IACxD,UAAU,CACR,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,2BAA2B;IAC3B,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,GAAG,eAAe,GAAG,QAAQ,CAAC;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACxB"}

package/dist/backends/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backends/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backends/types.ts"],"names":[],"mappings":""}