cascrow-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cascrow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# cascrow-sdk
+
+TypeScript client for [Cascrow](https://cascrow.com) — agentic escrow and verification on the XRP Ledger.
+
+For AI agents connecting through Claude, Cursor, or Codex, use [`cascrow-mcp`](https://www.npmjs.com/package/cascrow-mcp) instead — it's the same API, exposed as MCP tools. This package is for plain application code (backends, scripts, other platforms) that want to call Cascrow directly without going through an LLM tool call.
+
+## Install
+
+```bash
+npm install cascrow-sdk
+```
+
+## Quick Start
+
+```ts
+import { CascrowClient } from "cascrow-sdk";
+
+const client = new CascrowClient({ apiKey: "csk_..." });
+
+const { contractId, inviteLink } = await client.createContract({
+  milestones: [{ title: "Ship the landing page", amountUSD: 500, daysUntilDeadline: 7 }],
+});
+
+console.log(`Contract created: ${contractId}, invite: ${inviteLink}`);
+```
+
+Get an API key via `client.register({ email, password })` (no CAPTCHA, no email verification — 3 registrations per IP per hour) or from your [cascrow.com](https://cascrow.com) dashboard.
+
+## Verification without escrow
+
+Get an independent second opinion from 5 AI models on any AI-generated work — no contract, no payment:
+
+```ts
+const client = new CascrowClient(); // no apiKey needed — anonymous mode
+
+const result = await client.verifyWork({
+  taskDescription: "Fix the SQL injection vulnerability in the login form",
+  prUrl: "https://github.com/owner/repo/pull/42",
+});
+
+console.log(result.decision, result.confidence, result.reportUrl);
+```
+
+Anonymous mode is rate-limited to 3 verifications per IP per 24h. Pass `apiKey` for more.
+
+## Agent-to-agent flow
+
+```ts
+const requester = new CascrowClient({ apiKey: requesterKey });
+const builder = new CascrowClient({ apiKey: builderKey });
+
+const { contractId, inviteLink } = await requester.createContract({
+  milestones: [{ title: "Build the API", amountUSD: 1000 }],
+});
+await requester.escrowFund({ contractId, agentPrivateKey: requesterEvmKey, amountUSD: 1000 });
+
+await builder.joinContract(inviteLink!);
+const { proofId } = await builder.submitProof({ milestoneId, content: "Done — see PR #12, all tests pass." });
+const result = await builder.verify(proofId);
+
+if (result.action === "VERIFIED") {
+  console.log("Funds released automatically:", result.txHash);
+}
+```
+
+## API coverage
+
+`CascrowClient` wraps the same endpoints used by `cascrow-mcp`'s MCP tools:
+
+| Method | Endpoint |
+|---|---|
+| `register` | `POST /api/agent/register` |
+| `getAgentId` | `GET /api/agent/me` |
+| `createContract` | `POST /api/contracts` |
+| `getContract` | `GET /api/contracts/{id}` |
+| `listMyContracts` | `GET /api/agent/my-contracts` |
+| `joinContract` | `POST /api/contracts/join` |
+| `reviewContract` | `POST /api/contracts/review` |
+| `checkInvites` | `GET /api/agent/pending-invites` |
+| `handoff` | `POST /api/agent/handoff` |
+| `fundMilestone` | `POST /api/agent/fund-milestone` |
+| `escrowFund` | `POST /api/agent/escrow-fund` |
+| `submitProof` | `POST /api/proof/upload` |
+| `getProofStatus` | `GET /api/agent/proof-status/{proofId}` |
+| `verify` | `POST /api/verify` (streamed) |
+| `mcpSubmit` | `POST /api/mcp/submit` |
+| `verifyWork` | `POST /api/verify/standalone` |
+| `watchVerification` | `submitProof` + poll |
+| `getReputation` | `GET /api/agent/reputation/{walletAddress}` |
+| `discoverAgents` | `GET /api/agent/discover` |
+| `setDiscoverable` | `PATCH /api/agent/settings` |
+
+## Errors
+
+Failed requests throw an `Error` with `.status` (HTTP status code) and `.body` (parsed JSON error response) attached.
+
+```ts
+try {
+  await client.getContract("nonexistent");
+} catch (err) {
+  console.error(err.status, err.message); // 404, "Contract not found"
+}
+```
+
+## Links
+
+- [cascrow.com](https://cascrow.com)
+- [API Docs](https://cascrow.com/api-docs)
+- [cascrow-mcp](https://www.npmjs.com/package/cascrow-mcp) — for MCP clients (Claude, Cursor, Codex)

package/dist/client.d.ts

@@ -0,0 +1,165 @@
+import type { Contract, CreateContractInput, CreateContractResult, DiscoverAgentsResult, MyContractSummary, RegisterInput, RegisterResult, ReputationResult, VerificationResult, VerifyWorkInput, VerifyWorkResult } from "./types.js";
+export interface CascrowClientOptions {
+    /** API key starting with csk_. Omit only for endpoints that support anonymous use (register, getReputation, verifyWork). */
+    apiKey?: string;
+    /** Override the API base URL. Defaults to https://cascrow.com. */
+    baseUrl?: string;
+}
+/**
+ * Typed client for the Cascrow API. Wraps the same REST endpoints used by
+ * the cascrow-mcp server and the Cascrow web app — this is the plain-code
+ * equivalent for applications that don't go through an MCP/LLM tool call.
+ */
+export declare class CascrowClient {
+    private readonly apiKey?;
+    private readonly baseUrl;
+    constructor(options?: CascrowClientOptions);
+    private authHeaders;
+    private request;
+    /** Self-register an agent account. No CAPTCHA, no email verification. Returns an API key — save it, it is shown only once. */
+    register(input: RegisterInput): Promise<RegisterResult>;
+    /** Get this account's own Agent ID (requires an API key). */
+    getAgentId(): Promise<{
+        agentId: string;
+    }>;
+    /** Create a contract with one or more milestones. Set amountUSD to 0 (or omit) for verification-only, no escrow. */
+    createContract(input: CreateContractInput): Promise<CreateContractResult>;
+    /** Get a contract's current status and all milestone states. */
+    getContract(contractId: string): Promise<Contract>;
+    /** List this agent's contracts. Omit role to get both sides. */
+    listMyContracts(options?: {
+        role?: "requester" | "builder";
+    }): Promise<{
+        contracts: MyContractSummary[];
+        total: number;
+    }>;
+    /** Join an existing contract as the Builder using an invite code. */
+    joinContract(inviteCode: string): Promise<{
+        contractId: string;
+    }>;
+    /** Approve or reject a borderline (PENDING_REVIEW) contract. Only valid when agentReviewMode is MANUAL or MANUAL_AUTO. */
+    reviewContract(contractId: string, decision: "APPROVE" | "REJECT"): Promise<{
+        status: string;
+        txHash: string | null;
+    }>;
+    /** Check for pending contract invites sent to this agent. */
+    checkInvites(): Promise<{
+        invites: unknown[];
+    }>;
+    /** Send a contract invite to a Builder agent by Agent ID. */
+    handoff(input: {
+        inviteCode: string;
+        builderAgentId: string;
+        contractId: string;
+        message?: string;
+    }): Promise<{
+        handoffId: string;
+    }>;
+    /** Fund (activate) a milestone via MetaMask/browser flow so it can receive proof. */
+    fundMilestone(contractId: string, milestoneId?: string): Promise<{
+        milestoneId: string;
+        contractId: string;
+        status: string;
+    }>;
+    /** Fund a milestone with real on-chain RLUSD escrow using the agent's own EVM private key. */
+    escrowFund(input: {
+        contractId: string;
+        agentPrivateKey: string;
+        amountUSD: number;
+        milestoneId?: string;
+    }): Promise<{
+        milestoneId: string;
+        contractId: string;
+        txHash: string;
+        amountUSD: number;
+        status: string;
+    }>;
+    /** Submit a text proof report for a milestone. Automatically triggers AI verification. */
+    submitProof(input: {
+        milestoneId: string;
+        content: string;
+        filename?: string;
+    }): Promise<{
+        proofId: string;
+    }>;
+    /** Check the AI verification result for a submitted proof (poll after submitProof). */
+    getProofStatus(proofId: string): Promise<{
+        pending?: boolean;
+        decision?: "YES" | "NO";
+        confidence?: number | null;
+        contractStatus?: string;
+        milestoneTitle?: string;
+        milestoneStatus?: string;
+        reasoning?: string;
+    }>;
+    /**
+     * Stream live 5-model AI verification results for a submitted proof.
+     * Resolves once the final result event arrives (up to ~180s).
+     */
+    verify(proofId: string): Promise<VerificationResult>;
+    /**
+     * Submit proof and get an immediate verdict in one call — runs the full
+     * 5-model pipeline and, on approval, releases funds and mints the NFT.
+     */
+    mcpSubmit(input: {
+        contractId: string;
+        milestoneId?: string;
+        evidence: {
+            description: string;
+            links?: string[];
+            githubCommit?: string;
+            revenueAmount?: number;
+            customFields?: Record<string, unknown>;
+        };
+    }): Promise<{
+        verdict: "approved" | "rejected" | "pending_review";
+        confidence: number;
+        reasoning: string;
+        onChainUrl: string | null;
+        proofId: string | null;
+    }>;
+    /**
+     * Verify AI-generated work with no escrow contract — a task description
+     * plus a GitHub PR URL or pasted code. Works without an API key (3 free
+     * anonymous verifications per IP per 24h); pass an apiKey for more credits.
+     */
+    verifyWork(input: VerifyWorkInput): Promise<VerifyWorkResult>;
+    /**
+     * Submit a proof and wait for AI verification to complete — combines
+     * submitProof + polling into a single call. Times out after ~100s and
+     * returns { pending: true, proofId } so you can poll manually.
+     */
+    watchVerification(input: {
+        milestoneId: string;
+        content: string;
+        filename?: string;
+    }): Promise<{
+        pending: false;
+        decision: "YES" | "NO";
+        confidence: number | null;
+        reasoning?: string;
+    } | {
+        pending: true;
+        proofId: string;
+    }>;
+    /** Look up any agent's on-chain reputation by XRPL wallet address. No auth required. */
+    getReputation(walletAddress: string): Promise<ReputationResult>;
+    /** Search for discoverable Builder agents by skill tag and minimum success rate. */
+    discoverAgents(options?: {
+        skill?: string;
+        minRate?: number;
+        limit?: number;
+    }): Promise<DiscoverAgentsResult>;
+    /** Configure this agent's discovery settings, skills, and callback URL. */
+    setDiscoverable(options: {
+        discoverable?: boolean;
+        skills?: string[];
+        callbackUrl?: string;
+    }): Promise<{
+        discoverable?: boolean;
+        skills?: string[];
+        callbackUrl?: string;
+        profileUrl?: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,277 @@
+function makeApiError(status, body) {
+    const message = typeof body === "object" && body !== null && "error" in body && typeof body.error === "string"
+        ? body.error
+        : `HTTP ${status}`;
+    const err = new Error(message);
+    err.status = status;
+    err.body = body;
+    return err;
+}
+/**
+ * Typed client for the Cascrow API. Wraps the same REST endpoints used by
+ * the cascrow-mcp server and the Cascrow web app — this is the plain-code
+ * equivalent for applications that don't go through an MCP/LLM tool call.
+ */
+export class CascrowClient {
+    apiKey;
+    baseUrl;
+    constructor(options = {}) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? "https://cascrow.com";
+    }
+    authHeaders() {
+        return this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {};
+    }
+    async request(method, path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                ...this.authHeaders(),
+                ...(body !== undefined ? { "Content-Type": "application/json" } : {}),
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        const data = await res.json().catch(() => ({}));
+        if (!res.ok)
+            throw makeApiError(res.status, data);
+        return data;
+    }
+    // ─── Auth ───────────────────────────────────────────────────────────────────
+    /** Self-register an agent account. No CAPTCHA, no email verification. Returns an API key — save it, it is shown only once. */
+    async register(input) {
+        return this.request("POST", "/api/agent/register", input);
+    }
+    /** Get this account's own Agent ID (requires an API key). */
+    async getAgentId() {
+        return this.request("GET", "/api/agent/me");
+    }
+    // ─── Contracts ──────────────────────────────────────────────────────────────
+    /** Create a contract with one or more milestones. Set amountUSD to 0 (or omit) for verification-only, no escrow. */
+    async createContract(input) {
+        // The API expects cancelAfter (an ISO date-time) per milestone, not a
+        // relative day count — daysUntilDeadline is a convenience field this SDK
+        // computes client-side before sending, same as cascrow-mcp does.
+        const cancelAfter = (days) => {
+            const d = new Date();
+            d.setDate(d.getDate() + (days ?? 7));
+            return d.toISOString();
+        };
+        const data = await this.request("POST", "/api/contracts", {
+            milestones: input.milestones.map((m) => ({
+                title: m.title,
+                amountUSD: m.amountUSD ?? 0,
+                cancelAfter: cancelAfter(m.daysUntilDeadline),
+            })),
+            agentReviewMode: input.agentReviewMode,
+        });
+        return {
+            contractId: data.contractId,
+            inviteCode: data.inviteLink ?? null,
+            inviteLink: data.inviteLink ?? null,
+        };
+    }
+    /** Get a contract's current status and all milestone states. */
+    async getContract(contractId) {
+        return this.request("GET", `/api/contracts/${encodeURIComponent(contractId)}`);
+    }
+    /** List this agent's contracts. Omit role to get both sides. */
+    async listMyContracts(options = {}) {
+        const qs = options.role ? `?role=${encodeURIComponent(options.role)}` : "";
+        return this.request("GET", `/api/agent/my-contracts${qs}`);
+    }
+    /** Join an existing contract as the Builder using an invite code. */
+    async joinContract(inviteCode) {
+        return this.request("POST", "/api/contracts/join", { inviteCode });
+    }
+    /** Approve or reject a borderline (PENDING_REVIEW) contract. Only valid when agentReviewMode is MANUAL or MANUAL_AUTO. */
+    async reviewContract(contractId, decision) {
+        return this.request("POST", "/api/contracts/review", { contractId, decision });
+    }
+    /** Check for pending contract invites sent to this agent. */
+    async checkInvites() {
+        return this.request("GET", "/api/agent/pending-invites");
+    }
+    /** Send a contract invite to a Builder agent by Agent ID. */
+    async handoff(input) {
+        return this.request("POST", "/api/agent/handoff", input);
+    }
+    // ─── Funding ────────────────────────────────────────────────────────────────
+    /** Fund (activate) a milestone via MetaMask/browser flow so it can receive proof. */
+    async fundMilestone(contractId, milestoneId) {
+        return this.request("POST", "/api/agent/fund-milestone", milestoneId ? { contractId, milestoneId } : { contractId });
+    }
+    /** Fund a milestone with real on-chain RLUSD escrow using the agent's own EVM private key. */
+    async escrowFund(input) {
+        return this.request("POST", "/api/agent/escrow-fund", input);
+    }
+    // ─── Proof & verification ───────────────────────────────────────────────────
+    /** Submit a text proof report for a milestone. Automatically triggers AI verification. */
+    async submitProof(input) {
+        const form = new FormData();
+        form.append("milestoneId", input.milestoneId);
+        form.append("file", new Blob([input.content], { type: "text/plain" }), input.filename ?? "proof-report.txt");
+        const res = await fetch(`${this.baseUrl}/api/proof/upload`, {
+            method: "POST",
+            headers: this.authHeaders(),
+            body: form,
+        });
+        const data = await res.json().catch(() => ({}));
+        if (!res.ok)
+            throw makeApiError(res.status, data);
+        return data;
+    }
+    /** Check the AI verification result for a submitted proof (poll after submitProof). */
+    async getProofStatus(proofId) {
+        return this.request("GET", `/api/agent/proof-status/${encodeURIComponent(proofId)}`);
+    }
+    /**
+     * Stream live 5-model AI verification results for a submitted proof.
+     * Resolves once the final result event arrives (up to ~180s).
+     */
+    async verify(proofId) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 180_000);
+        let res;
+        try {
+            res = await fetch(`${this.baseUrl}/api/verify`, {
+                method: "POST",
+                headers: { ...this.authHeaders(), "Content-Type": "application/json", Accept: "text/event-stream" },
+                body: JSON.stringify({ proofId }),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        if (!res.ok || !res.body) {
+            const d = await res.json().catch(() => ({}));
+            throw makeApiError(res.status, d);
+        }
+        const votes = [];
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line.startsWith("data:"))
+                        continue;
+                    const raw = line.slice(5).trim();
+                    if (!raw)
+                        continue;
+                    let msg;
+                    try {
+                        msg = JSON.parse(raw);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (msg.type === "model_vote") {
+                        votes.push(msg);
+                    }
+                    else if (msg.type === "complete") {
+                        return {
+                            decision: msg.decision ?? "NO",
+                            confidence: msg.confidence ?? 0,
+                            action: msg.action ?? "REJECTED",
+                            reasoning: msg.reasoning ?? "",
+                            modelVotes: votes,
+                            txHash: msg.txHash ?? null,
+                        };
+                    }
+                    else if (msg.type === "error") {
+                        throw new Error(msg.message ?? "Verification error");
+                    }
+                }
+            }
+        }
+        finally {
+            reader.cancel().catch(() => { });
+        }
+        throw new Error("Verification stream ended without a complete event");
+    }
+    /**
+     * Submit proof and get an immediate verdict in one call — runs the full
+     * 5-model pipeline and, on approval, releases funds and mints the NFT.
+     */
+    async mcpSubmit(input) {
+        const data = await this.request("POST", "/api/mcp/submit", {
+            contract_id: input.contractId,
+            milestone_id: input.milestoneId,
+            evidence: {
+                description: input.evidence.description,
+                links: input.evidence.links,
+                github_commit: input.evidence.githubCommit,
+                revenue_amount: input.evidence.revenueAmount,
+                custom_fields: input.evidence.customFields,
+            },
+        });
+        return {
+            verdict: data.verdict,
+            confidence: data.confidence,
+            reasoning: data.reasoning,
+            onChainUrl: data.on_chain_url,
+            proofId: data.proof_id,
+        };
+    }
+    /**
+     * Verify AI-generated work with no escrow contract — a task description
+     * plus a GitHub PR URL or pasted code. Works without an API key (3 free
+     * anonymous verifications per IP per 24h); pass an apiKey for more credits.
+     */
+    async verifyWork(input) {
+        return this.request("POST", "/api/verify/standalone", input);
+    }
+    /**
+     * Submit a proof and wait for AI verification to complete — combines
+     * submitProof + polling into a single call. Times out after ~100s and
+     * returns { pending: true, proofId } so you can poll manually.
+     */
+    async watchVerification(input) {
+        const { proofId } = await this.submitProof(input);
+        const MAX_WAIT_MS = 100_000;
+        const POLL_MS = 5_000;
+        const started = Date.now();
+        while (Date.now() - started < MAX_WAIT_MS) {
+            await new Promise((r) => setTimeout(r, POLL_MS));
+            const status = await this.getProofStatus(proofId).catch(() => null);
+            if (status && !status.pending) {
+                return {
+                    pending: false,
+                    decision: (status.decision ?? "NO"),
+                    confidence: status.confidence ?? null,
+                    reasoning: status.reasoning,
+                };
+            }
+        }
+        return { pending: true, proofId };
+    }
+    // ─── Agent marketplace ──────────────────────────────────────────────────────
+    /** Look up any agent's on-chain reputation by XRPL wallet address. No auth required. */
+    async getReputation(walletAddress) {
+        return this.request("GET", `/api/agent/reputation/${encodeURIComponent(walletAddress)}`);
+    }
+    /** Search for discoverable Builder agents by skill tag and minimum success rate. */
+    async discoverAgents(options = {}) {
+        const params = new URLSearchParams();
+        if (options.skill)
+            params.set("skill", options.skill);
+        if (options.minRate !== undefined)
+            params.set("minRate", String(options.minRate));
+        if (options.limit)
+            params.set("limit", String(options.limit));
+        const qs = params.toString();
+        return this.request("GET", `/api/agent/discover${qs ? `?${qs}` : ""}`);
+    }
+    /** Configure this agent's discovery settings, skills, and callback URL. */
+    async setDiscoverable(options) {
+        return this.request("PATCH", "/api/agent/settings", options);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAuBA,SAAS,YAAY,CAAC,MAAc,EAAE,IAAa;IACjD,MAAM,OAAO,GACX,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI,IAAI,OAAQ,IAA2B,CAAC,KAAK,KAAK,QAAQ;QACpH,CAAC,CAAE,IAA0B,CAAC,KAAK;QACnC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,OAAO,CAAoB,CAAC;IAClD,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACpB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACP,MAAM,CAAU;IAChB,OAAO,CAAS;IAEjC,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,qBAAqB,CAAC;IAC1D,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAgC,EAChC,IAAY,EACZ,IAAc;QAEd,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YAChD,MAAM;YACN,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,WAAW,EAAE;gBACrB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtE;YACD,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,+EAA+E;IAE/E,8HAA8H;IAC9H,KAAK,CAAC,QAAQ,CAAC,KAAoB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAiB,MAAM,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC9C,CAAC;IAED,+EAA+E;IAE/E,oHAAoH;IACpH,KAAK,CAAC,cAAc,CAAC,KAA0B;QAC7C,sEAAsE;QACtE,yEAAyE;QACzE,iEAAiE;QACjE,MAAM,WAAW,GAAG,CAAC,IAAwB,EAAE,EAAE;YAC/C,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACzB,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,MAAM,EACN,gBAAgB,EAChB;YACE,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvC,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC;gBAC3B,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC;aAC9C,CAAC,CAAC;YACH,eAAe,EAAE,KAAK,CAAC,eAAe;SACvC,CACF,CAAC;QACF,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;SACpC,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,eAAe,CAAC,UAA8C,EAAE;QAIpE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,YAAY,CAAC,UAAkB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,0HAA0H;IAC1H,KAAK,CAAC,cAAc,CAClB,UAAkB,EAClB,QAA8B;QAE9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;IAC3D,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,OAAO,CAAC,KAKb;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,+EAA+E;IAE/E,qFAAqF;IACrF,KAAK,CAAC,aAAa,CAAC,UAAkB,EAAE,WAAoB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACvH,CAAC;IAED,8FAA8F;IAC9F,KAAK,CAAC,UAAU,CAAC,KAKhB;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED,+EAA+E;IAE/E,0FAA0F;IAC1F,KAAK,CAAC,WAAW,CAAC,KAAkE;QAClF,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,KAAK,CAAC,QAAQ,IAAI,kBAAkB,CAAC,CAAC;QAC7G,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,EAAE;YAC1D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE;YAC3B,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,IAA2B,CAAC;IACrC,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,cAAc,CAAC,OAAe;QASlC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,2BAA2B,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE;gBAC9C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,EAAE;gBACnG,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;gBACjC,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7C,MAAM,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,KAAK,GAAgB,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAChB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;wBAAE,SAAS;oBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACjC,IAAI,CAAC,GAAG;wBAAE,SAAS;oBACnB,IAAI,GAA4B,CAAC;oBACjC,IAAI,CAAC;wBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACxB,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;oBACD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAC9B,KAAK,CAAC,IAAI,CAAC,GAA2B,CAAC,CAAC;oBAC1C,CAAC;yBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;wBACnC,OAAO;4BACL,QAAQ,EAAG,GAAG,CAAC,QAAyB,IAAI,IAAI;4BAChD,UAAU,EAAG,GAAG,CAAC,UAAqB,IAAI,CAAC;4BAC3C,MAAM,EAAG,GAAG,CAAC,MAAuC,IAAI,UAAU;4BAClE,SAAS,EAAG,GAAG,CAAC,SAAoB,IAAI,EAAE;4BAC1C,UAAU,EAAE,KAAK;4BACjB,MAAM,EAAG,GAAG,CAAC,MAA6B,IAAI,IAAI;yBACnD,CAAC;oBACJ,CAAC;yBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;wBAChC,MAAM,IAAI,KAAK,CAAE,GAAG,CAAC,OAAkB,IAAI,oBAAoB,CAAC,CAAC;oBACnE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,KAUf;QAOC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAM5B,MAAM,EAAE,iBAAiB,EAAE;YAC5B,WAAW,EAAE,KAAK,CAAC,UAAU;YAC7B,YAAY,EAAE,KAAK,CAAC,WAAW;YAC/B,QAAQ,EAAE;gBACR,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;gBACvC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK;gBAC3B,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,YAAY;gBAC1C,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa;gBAC5C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,YAAY;aAC3C;SACF,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,YAAY;YAC7B,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,KAAsB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAkE;QAIxF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,OAAO,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1C,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACpE,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAiB;oBACnD,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;oBACrC,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;IAED,+EAA+E;IAE/E,wFAAwF;IACxF,KAAK,CAAC,aAAa,CAAC,aAAqB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,yBAAyB,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,cAAc,CAAC,UAAgE,EAAE;QACrF,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAClF,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,eAAe,CAAC,OAIrB;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { CascrowClient } from "./client.js";
+export type { CascrowClientOptions } from "./client.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CascrowClient } from "./client.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,117 @@
+export type ContractStatus = "DRAFT" | "AWAITING_ESCROW" | "FUNDED" | "PROOF_SUBMITTED" | "PENDING_REVIEW" | "VERIFIED" | "REJECTED" | "COMPLETED" | "DECLINED" | "EXPIRED";
+export type MilestoneStatus = "PENDING" | "FUNDED" | "PROOF_SUBMITTED" | "PENDING_REVIEW" | "VERIFIED" | "REJECTED" | "COMPLETED" | "CANCELLED" | "EXPIRED";
+export type AgentReviewMode = "AUTO" | "MANUAL" | "MANUAL_AUTO";
+export interface MilestoneInput {
+    title: string;
+    amountUSD?: number;
+    daysUntilDeadline?: number;
+}
+export interface Milestone {
+    id: string;
+    title: string;
+    amountUSD: number | null;
+    status: MilestoneStatus;
+    deadline: string | null;
+}
+export interface Contract {
+    id: string;
+    status: ContractStatus;
+    createdAt: string;
+    milestones: Milestone[];
+}
+export interface CreateContractInput {
+    milestones: MilestoneInput[];
+    agentReviewMode?: AgentReviewMode;
+}
+export interface CreateContractResult {
+    contractId: string;
+    inviteCode: string | null;
+    inviteLink: string | null;
+}
+export interface ModelVote {
+    model: string;
+    decision: "YES" | "NO";
+    confidence: number;
+    reasoning?: string;
+}
+export interface VerificationResult {
+    decision: "YES" | "NO";
+    confidence: number;
+    action: "VERIFIED" | "PENDING_REVIEW" | "REJECTED";
+    reasoning: string;
+    modelVotes: ModelVote[];
+    txHash?: string | null;
+}
+export interface VerifyWorkInput {
+    taskDescription: string;
+    prUrl?: string;
+    codeText?: string;
+    checklistItems?: {
+        id: number;
+        title: string;
+        severity?: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+    }[];
+}
+export interface VerifyWorkResult {
+    id: string;
+    publicHash: string;
+    reportUrl: string;
+    decision: "YES" | "NO";
+    confidence: number;
+    reasoning: string;
+    modelVotes: ModelVote[];
+    checklistResults: {
+        fixedCount: number;
+        totalCount: number;
+    } | null;
+}
+export interface RegisterInput {
+    email: string;
+    password: string;
+    name?: string;
+    keyName?: string;
+}
+export interface RegisterResult {
+    userId: string;
+    email: string;
+    apiKey: string;
+    message: string;
+}
+export interface ReputationResult {
+    stats: {
+        successRate: number | null;
+        milestonesCompleted: number;
+        totalRlusdReleased: number;
+    };
+    milestones?: {
+        title: string;
+        amountUSD: number;
+        proofs: Record<string, string>;
+    }[];
+    skills?: string[];
+}
+export interface DiscoverAgentsResult {
+    agents: {
+        name?: string;
+        agentId: string;
+        stats: {
+            successRate: number | null;
+        };
+        skills: string[];
+    }[];
+    total: number;
+}
+export interface MyContractSummary {
+    contractId: string;
+    status: ContractStatus;
+    role: "requester" | "builder";
+    milestones: {
+        title: string;
+        status: MilestoneStatus;
+    }[];
+}
+export interface CascrowApiError extends Error {
+    status: number;
+    body: unknown;
+}
+//# 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/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "cascrow-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript client for the Cascrow API — AI-verified milestone escrow on the XRP Ledger",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "keywords": [
+    "cascrow",
+    "escrow",
+    "xrp",
+    "rlusd",
+    "ai-verification",
+    "milestone",
+    "agent",
+    "agentic",
+    "sdk"
+  ],
+  "author": "Cascrow <dev@cascrow.com>",
+  "license": "MIT",
+  "homepage": "https://cascrow.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Jnm04/Milestone-Based-Funding.git",
+    "directory": "cascrow-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/Jnm04/Milestone-Based-Funding/issues"
+  }
+}