kompass-sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+import type { Address, WalletClient, PublicClient, Chain, Transport, Account } from "viem";
+/** SDK configuration */
+export interface KompassConfig {
+    /** viem PublicClient for read operations */
+    publicClient: PublicClient<Transport, Chain>;
+    /** viem WalletClient for write operations (optional for read-only usage) */
+    walletClient?: WalletClient<Transport, Chain, Account>;
+    /** KompassEscrow contract address */
+    escrowAddress: Address;
+    /** KompassRegistry contract address */
+    registryAddress: Address;
+    /** ERC-8004 Reputation Registry address */
+    reputationRegistryAddress: Address;
+    /** PipelineOrchestrator contract address */
+    pipelineAddress?: Address;
+    /** Default settlement token for pipeline creation */
+    paymentTokenAddress?: Address;
+    /** Default hook address for escrow jobs (e.g., ReputationUpdateHook) */
+    defaultHookAddress?: Address;
+    /** Indexer GraphQL endpoint (e.g., http://localhost:42069/graphql) */
+    indexerUrl: string;
+}
+/** Job status matching the contract enum */
+export type JobStatus = "Open" | "Funded" | "Submitted" | "Completed" | "Rejected" | "Expired";
+/** Milestone status matching the contract enum */
+export type MilestoneStatus = "Pending" | "Submitted" | "Approved" | "Rejected";
+/** Agent type from ENS text records */
+export type AgentType = "provider" | "evaluator" | "both" | "unknown";
+/** Payment mode for agent services */
+export type PaymentMode = "escrow" | "x402" | "hybrid" | "unknown";
+/** Agent profile from the indexer */
+export interface AgentProfile {
+    id: Address;
+    ensNode: `0x${string}`;
+    ensName: string;
+    agentType: AgentType;
+    categories: string;
+    pricingModel: string;
+    pricingRate: string;
+    pricingToken: string;
+    erc8004Id: string;
+    identityVerification: string;
+    identityVerified: boolean;
+    paymentMode: PaymentMode;
+    endpointMcp: string;
+    endpointA2a: string;
+    endpointX402: string;
+    x402Enabled: boolean;
+    evaluatorDomains: string;
+    description: string;
+    registered: boolean;
+    registeredAt: bigint;
+    updatedAt: bigint;
+}
+/** Options for discovering agents */
+export interface DiscoverOptions {
+    category?: string;
+    evaluatorDomain?: string;
+    maxPrice?: bigint;
+    minReputation?: number;
+    agentType?: AgentType;
+    paymentMode?: PaymentMode;
+    requiresX402?: boolean;
+    verifiedOnly?: boolean;
+    limit?: number;
+}
+/** Milestone configuration for job creation */
+export interface MilestoneConfig {
+    budgetShareBps: number;
+}
+/** Options for creating a job */
+export interface CreateJobOptions {
+    provider: Address;
+    evaluator: Address;
+    budget: bigint;
+    expiredAt: bigint;
+    description: string;
+    hook?: Address;
+    milestones?: MilestoneConfig[];
+}
+/** On-chain job data */
+export interface Job {
+    client: Address;
+    provider: Address;
+    evaluator: Address;
+    hook: Address;
+    budget: bigint;
+    expiredAt: bigint;
+    status: JobStatus;
+    description: string;
+    deliverable: `0x${string}`;
+    milestoneCount: number;
+    currentMilestone: number;
+}
+/** Milestone data from contract */
+export interface MilestoneData {
+    budgetShareBps: number;
+    deliverable: `0x${string}`;
+    status: MilestoneStatus;
+}
+/** Transaction result */
+export interface TxResult {
+    txHash: `0x${string}`;
+}
+/** Job creation result */
+export interface CreateJobResult extends TxResult {
+    jobId: bigint;
+}
+/** ERC-8004 reputation summary */
+export interface ReputationSummary {
+    count: bigint;
+    summaryValue: bigint;
+    summaryValueDecimals: number;
+}
+/** Registration profile (fields to set as ENS text records) */
+export interface RegisterProfile {
+    ensNode: `0x${string}`;
+    ensName?: string;
+    agentType?: AgentType;
+    categories?: string;
+    pricingModel?: string;
+    pricingRate?: string;
+    pricingToken?: string;
+    erc8004Id?: string;
+    identityVerification?: string;
+    paymentMode?: PaymentMode;
+    endpointMcp?: string;
+    endpointA2a?: string;
+    endpointX402?: string;
+    evaluatorDomains?: string;
+    description?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/unified.d.ts

@@ -0,0 +1,90 @@
+/**
+ * KompassUnified — Universal Agent Discovery + Coordination
+ *
+ * The Google for AI agents. One API that searches across ALL registries
+ * and lets you hire any agent regardless of protocol.
+ *
+ * @example
+ * const kompass = await KompassUnified.create({ network: "base-sepolia" });
+ * const agents = await kompass.find("yield optimization");
+ * const result = await kompass.hire(agents[0], "Find best yield on Base");
+ */
+import { type UnifiedAgent } from "./sources/index.js";
+import { type AggregatorResult } from "./aggregator.js";
+import { type MatchResult } from "./matching.js";
+import { type BridgeHireOptions, type BridgeHireResult } from "./bridge.js";
+import { type DoOptions, type DoResult } from "./router.js";
+export interface UnifiedConfig {
+    /** Network for on-chain sources */
+    network?: "base" | "base-sepolia";
+    /** Which sources to enable (default: all) */
+    enabledSources?: string[];
+    /** ACP backend instance (for hiring via ACP) */
+    acpBackend?: any;
+    /** Kompass SDK config (for kompass-registry source) */
+    kompassConfig?: any;
+}
+export interface FindOptions {
+    /** Max results */
+    limit?: number;
+    /** Filter by source */
+    sources?: string[];
+    /** Timeout per source in ms */
+    timeout?: number;
+    /** Minimum match score (0-100) */
+    minScore?: number;
+}
+export interface FindResult extends AggregatorResult {
+    /** Agents re-ranked by multi-layer matching */
+    ranked: MatchResult[];
+}
+export declare class KompassUnified {
+    private aggregator;
+    private bridge;
+    private router;
+    private adapters;
+    private constructor();
+    static create(config?: UnifiedConfig): Promise<KompassUnified>;
+    /**
+     * Search for agents across all registries.
+     * Returns results ranked by multi-layer matching (structured + BM25 + multi-criteria).
+     */
+    find(query: string, options?: FindOptions): Promise<FindResult>;
+    /**
+     * Hire a specific agent via its native protocol.
+     * The bridge routes to ACP, x402, MCP, A2A, HTTP, or L402 automatically.
+     */
+    hire(agent: UnifiedAgent, task: string, options?: Partial<BridgeHireOptions>): Promise<BridgeHireResult>;
+    /**
+     * Find the best agent for a task and hire it.
+     * One function: discover → rank → hire.
+     */
+    findAndHire(query: string, task: string, options?: FindOptions & Partial<BridgeHireOptions>): Promise<{
+        discovery: FindResult;
+        hire: BridgeHireResult;
+    }>;
+    /**
+     * Check health of all discovery sources.
+     */
+    sources(): Promise<{
+        name: string;
+        displayName: string;
+        healthy: boolean;
+    }[]>;
+    /**
+     * Get any job done. The core Kompass function.
+     *
+     * Discovers the right capability across all protocols, picks the best option,
+     * executes via the right payment rail, and returns the result.
+     *
+     * @example
+     * const result = await kompass.do({ task: "get DeFi yield data for Base" });
+     * console.log(result.execution?.deliverable);
+     */
+    do(options: DoOptions): Promise<DoResult>;
+    /**
+     * Get the number of registered source adapters.
+     */
+    get sourceCount(): number;
+}
+//# sourceMappingURL=unified.d.ts.map

package/dist/unified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified.d.ts","sourceRoot":"","sources":["../src/unified.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAClC,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,uDAAuD;IACvD,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAClD,+CAA+C;IAC/C,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAkB;IAElC,OAAO;WAOM,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAcpE;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBrE;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9G;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,GACjD,OAAO,CAAC;QAAE,SAAS,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAa7D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAInF;;;;;;;;;OASG;IACG,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/C;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}

package/dist/unified.js

@@ -0,0 +1,107 @@
+/**
+ * KompassUnified — Universal Agent Discovery + Coordination
+ *
+ * The Google for AI agents. One API that searches across ALL registries
+ * and lets you hire any agent regardless of protocol.
+ *
+ * @example
+ * const kompass = await KompassUnified.create({ network: "base-sepolia" });
+ * const agents = await kompass.find("yield optimization");
+ * const result = await kompass.hire(agents[0], "Find best yield on Base");
+ */
+import { createAllSources } from "./sources/index.js";
+import { Aggregator } from "./aggregator.js";
+import { rankAgents } from "./matching.js";
+import { ProtocolBridge } from "./bridge.js";
+import { CapabilityRouter } from "./router.js";
+export class KompassUnified {
+    aggregator;
+    bridge;
+    router;
+    adapters;
+    constructor(adapters, bridge) {
+        this.adapters = adapters;
+        this.aggregator = new Aggregator(adapters);
+        this.bridge = bridge;
+        this.router = new CapabilityRouter(this.aggregator, this.bridge);
+    }
+    static async create(config) {
+        const adapters = createAllSources({
+            erc8004Network: config?.network ?? "base-sepolia",
+            kompassConfig: config?.kompassConfig,
+            enabledSources: config?.enabledSources,
+        });
+        const bridge = new ProtocolBridge({
+            acpBackend: config?.acpBackend,
+        });
+        return new KompassUnified(adapters, bridge);
+    }
+    /**
+     * Search for agents across all registries.
+     * Returns results ranked by multi-layer matching (structured + BM25 + multi-criteria).
+     */
+    async find(query, options) {
+        const aggregatorResult = await this.aggregator.search(query, {
+            limit: (options?.limit ?? 20) * 2, // Over-fetch for re-ranking
+            sources: options?.sources,
+            timeout: options?.timeout,
+        });
+        // Re-rank with multi-layer matching
+        const ranked = rankAgents(aggregatorResult.agents, query);
+        // Apply limit and min score
+        const filtered = options?.minScore
+            ? ranked.filter((r) => r.scores.total >= options.minScore)
+            : ranked;
+        return {
+            ...aggregatorResult,
+            agents: filtered.slice(0, options?.limit ?? 20).map((r) => r.agent),
+            ranked: filtered.slice(0, options?.limit ?? 20),
+        };
+    }
+    /**
+     * Hire a specific agent via its native protocol.
+     * The bridge routes to ACP, x402, MCP, A2A, HTTP, or L402 automatically.
+     */
+    async hire(agent, task, options) {
+        return this.bridge.hire(agent, { task, ...options });
+    }
+    /**
+     * Find the best agent for a task and hire it.
+     * One function: discover → rank → hire.
+     */
+    async findAndHire(query, task, options) {
+        const discovery = await this.find(query, options);
+        if (discovery.agents.length === 0) {
+            throw new Error(`No agents found for: "${query}"`);
+        }
+        const bestAgent = discovery.agents[0];
+        const hireResult = await this.hire(bestAgent, task, options);
+        return { discovery, hire: hireResult };
+    }
+    /**
+     * Check health of all discovery sources.
+     */
+    async sources() {
+        return this.aggregator.healthCheck();
+    }
+    /**
+     * Get any job done. The core Kompass function.
+     *
+     * Discovers the right capability across all protocols, picks the best option,
+     * executes via the right payment rail, and returns the result.
+     *
+     * @example
+     * const result = await kompass.do({ task: "get DeFi yield data for Base" });
+     * console.log(result.execution?.deliverable);
+     */
+    async do(options) {
+        return this.router.do(options);
+    }
+    /**
+     * Get the number of registered source adapters.
+     */
+    get sourceCount() {
+        return this.adapters.length;
+    }
+}
+//# sourceMappingURL=unified.js.map

package/dist/unified.js.map

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

package/dist/x402.d.ts

@@ -0,0 +1,30 @@
+import type { PaymentMode } from "./types.js";
+export interface X402PaymentRequirement {
+    protocol: PaymentMode | "unknown";
+    amount?: string;
+    asset?: string;
+    payTo?: string;
+    facilitator?: string;
+    network?: string;
+    scheme?: string;
+    raw: unknown;
+    rawBody?: string;
+    rawHeaders: Record<string, string>;
+}
+export interface X402PaymentRequestContext {
+    url: string;
+    init: RequestInit;
+    response: Response;
+    requirement: X402PaymentRequirement;
+}
+export interface X402PaymentResponse {
+    headers?: HeadersInit;
+}
+export interface X402ClientOptions {
+    fetchFn?: typeof fetch;
+    parseRequirement?: (response: Response) => Promise<X402PaymentRequirement>;
+    onPaymentRequired: (context: X402PaymentRequestContext) => Promise<X402PaymentResponse>;
+}
+export declare function parseX402Requirement(response: Response): Promise<X402PaymentRequirement>;
+export declare function requestWithX402(url: string, init: RequestInit, options: X402ClientOptions): Promise<Response>;
+//# sourceMappingURL=x402.d.ts.map

package/dist/x402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC3E,iBAAiB,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACzF;AAgBD,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAyC9F;AAUD,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAoBnB"}

package/dist/x402.js

@@ -0,0 +1,79 @@
+function headersToObject(headers) {
+    return Object.fromEntries(headers.entries());
+}
+function detectProtocol(raw) {
+    if (raw && typeof raw === "object") {
+        const protocol = Reflect.get(raw, "protocol");
+        if (protocol === "x402" || protocol === "escrow" || protocol === "hybrid") {
+            return protocol;
+        }
+    }
+    return "unknown";
+}
+export async function parseX402Requirement(response) {
+    const rawHeaders = headersToObject(response.headers);
+    const headerPayload = response.headers.get("x-payment-requirement") ??
+        response.headers.get("x-payment-requirements") ??
+        response.headers.get("x-402-payment-requirement");
+    let raw = headerPayload ?? {};
+    let rawBody;
+    if (headerPayload) {
+        try {
+            raw = JSON.parse(headerPayload);
+        }
+        catch {
+            raw = { value: headerPayload };
+        }
+    }
+    else {
+        rawBody = await response.clone().text();
+        try {
+            raw = JSON.parse(rawBody);
+        }
+        catch {
+            raw = { value: rawBody };
+        }
+    }
+    const payload = raw && typeof raw === "object" ? raw : {};
+    const accepts = Array.isArray(payload.accepts) ? payload.accepts[0] : undefined;
+    const requirement = (accepts && typeof accepts === "object" ? accepts : payload);
+    return {
+        protocol: detectProtocol(requirement),
+        amount: typeof requirement.amount === "string" ? requirement.amount : undefined,
+        asset: typeof requirement.asset === "string" ? requirement.asset : undefined,
+        payTo: typeof requirement.payTo === "string" ? requirement.payTo : undefined,
+        facilitator: typeof requirement.facilitator === "string" ? requirement.facilitator : undefined,
+        network: typeof requirement.network === "string" ? requirement.network : undefined,
+        scheme: typeof requirement.scheme === "string" ? requirement.scheme : undefined,
+        raw,
+        rawBody,
+        rawHeaders,
+    };
+}
+function mergeHeaders(base, extra) {
+    const headers = new Headers(base);
+    if (!extra)
+        return headers;
+    const extraHeaders = new Headers(extra);
+    extraHeaders.forEach((value, key) => headers.set(key, value));
+    return headers;
+}
+export async function requestWithX402(url, init, options) {
+    const fetchFn = options.fetchFn ?? fetch;
+    const firstResponse = await fetchFn(url, init);
+    if (firstResponse.status !== 402) {
+        return firstResponse;
+    }
+    const requirement = await (options.parseRequirement ?? parseX402Requirement)(firstResponse);
+    const payment = await options.onPaymentRequired({
+        url,
+        init,
+        response: firstResponse,
+        requirement,
+    });
+    return fetchFn(url, {
+        ...init,
+        headers: mergeHeaders(init.headers, payment.headers),
+    });
+}
+//# sourceMappingURL=x402.js.map

package/dist/x402.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "kompass-sdk",
+  "version": "0.1.0",
+  "description": "Get any job done. Universal agent capability discovery + coordination across ACP, MCP, x402, A2A, skills, L402, and ERC-8004.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "kompass": "dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./simple": "./dist/simple.js",
+    "./unified": "./dist/unified.js",
+    "./sources": "./dist/sources/index.js",
+    "./backends/acp": "./dist/backends/acp.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "cli": "tsx src/cli.ts",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "kompass",
+    "agent",
+    "discovery",
+    "coordination",
+    "a2a",
+    "mcp",
+    "x402",
+    "acp",
+    "erc-8183",
+    "erc-8004",
+    "skills",
+    "ai-agent",
+    "agentic-commerce",
+    "base"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ayushsrivas55/kompass"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@a2a-js/sdk": "^0.3.13",
+    "@types/express": "^5.0.6",
+    "@virtuals-protocol/acp-node": "^0.3.0-beta.39",
+    "commander": "^14.0.3",
+    "dotenv": "^17.3.1",
+    "express": "^5.2.1",
+    "viem": "^2.47.2",
+    "wink-bm25-text-search": "^3.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}