@perkos/agent-sdk 0.1.0

package/dist/clarity.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import { PerkOSTransactionBuilder } from "./builders.js";
+import { SpendingPolicy } from "./policy.js";
+import type { AgentRecord, AssignProviderInput, ConfirmationOptions, ConfirmedTransactionReceipt, ContractCallPlan, CreateJobInput, FundJobInput, JobAmountInput, JobRecord, PaymentAsset, PerkOSConfig, RateProviderInput, RegisterAgentInput, ReputationRecord, SpendingApproval, SubmitWorkInput, TransactionConfirmation, TransactionReceipt, TransactionTrackerLike, UpdateAgentInput } from "./types.js";
+export declare class PerkOSClient {
+    readonly config: import("./types.js").ResolvedPerkOSConfig;
+    readonly transactions: PerkOSTransactionBuilder;
+    readonly policy: SpendingPolicy;
+    readonly tracker: TransactionTrackerLike;
+    private readonly signer;
+    private readonly readOnlyTransport;
+    constructor(input: PerkOSConfig);
+    preview(plan: ContractCallPlan): SpendingApproval;
+    execute(plan: ContractCallPlan): Promise<TransactionReceipt>;
+    confirm(receiptOrTxid: TransactionReceipt | string, options?: ConfirmationOptions): Promise<TransactionConfirmation>;
+    executeAndConfirm(plan: ContractCallPlan, options?: ConfirmationOptions): Promise<ConfirmedTransactionReceipt>;
+    getAgentCount(): Promise<bigint>;
+    getAgent(agentIdInput: bigint | number | string): Promise<AgentRecord | null>;
+    getJobCount(asset: PaymentAsset): Promise<bigint>;
+    getJob(asset: PaymentAsset, jobIdInput: bigint | number | string): Promise<JobRecord | null>;
+    getEscrowBalance(asset: PaymentAsset, jobIdInput: bigint | number | string): Promise<bigint>;
+    getConfiguredSbtcToken(): Promise<string>;
+    getReputation(agent: string): Promise<ReputationRecord>;
+    registerAgent(input: RegisterAgentInput): Promise<TransactionReceipt>;
+    updateAgent(input: UpdateAgentInput): Promise<TransactionReceipt>;
+    deactivateAgent(agentId: bigint | number | string): Promise<TransactionReceipt>;
+    createJob(input: CreateJobInput): Promise<TransactionReceipt>;
+    setBudget(input: JobAmountInput): Promise<TransactionReceipt>;
+    fundJob(input: FundJobInput): Promise<TransactionReceipt>;
+    assignProvider(input: AssignProviderInput): Promise<TransactionReceipt>;
+    submitWork(input: SubmitWorkInput): Promise<TransactionReceipt>;
+    completeJob(asset: PaymentAsset, jobIdInput: bigint | number | string): Promise<TransactionReceipt>;
+    rejectJob(asset: PaymentAsset, jobIdInput: bigint | number | string): Promise<TransactionReceipt>;
+    expireJob(asset: PaymentAsset, jobIdInput: bigint | number | string): Promise<TransactionReceipt>;
+    rateProvider(input: RateProviderInput): Promise<TransactionReceipt>;
+    private settlementInput;
+    private requireSignerAddress;
+    private read;
+}
+//# 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,290 @@
+import { Cl, fetchCallReadOnlyFunction } from "@stacks/transactions";
+import { JOB_STATUS } from "./constants.js";
+import { expectBoolean, expectList, expectPrincipal, expectString, expectTuple, expectUint, optionalBuffer, optionalPrincipal, unwrapResponse, } from "./clarity.js";
+import { PerkOSError } from "./errors.js";
+import { PerkOSTransactionBuilder } from "./builders.js";
+import { SpendingPolicy } from "./policy.js";
+import { TransactionTracker } from "./tracker.js";
+import { normalizeTxid } from "./txid.js";
+import { assertPrincipal, parseContractId, resolveConfig, toUint } from "./validation.js";
+function contractForAsset(contracts, asset) {
+    return asset === "sbtc" ? contracts.sbtcCommerce : contracts.stxCommerce;
+}
+async function defaultReadOnlyTransport(call) {
+    const { address, name } = parseContractId(call.contract, "contract", call.network);
+    return fetchCallReadOnlyFunction({
+        contractAddress: address,
+        contractName: name,
+        functionName: call.functionName,
+        functionArgs: [...call.functionArgs],
+        senderAddress: call.senderAddress,
+        network: call.network,
+        ...(call.apiUrl ? { client: { baseUrl: call.apiUrl } } : {}),
+    });
+}
+export class PerkOSClient {
+    config;
+    transactions;
+    policy;
+    tracker;
+    signer;
+    readOnlyTransport;
+    constructor(input) {
+        this.config = resolveConfig(input);
+        this.transactions = new PerkOSTransactionBuilder(this.config);
+        this.policy = new SpendingPolicy(this.config, input.spendingPolicy);
+        this.signer = input.signer;
+        this.readOnlyTransport = input.readOnlyTransport ?? defaultReadOnlyTransport;
+        this.tracker =
+            input.transactionTracker ??
+                new TransactionTracker({
+                    network: this.config.network,
+                    ...(this.config.apiUrl ? { apiUrl: this.config.apiUrl } : {}),
+                });
+    }
+    preview(plan) {
+        return this.policy.authorize(plan);
+    }
+    async execute(plan) {
+        if (plan.network !== this.config.network) {
+            throw new PerkOSError("POLICY_DENIED", `Plan network ${plan.network} does not match client network ${this.config.network}.`);
+        }
+        if (!this.signer) {
+            throw new PerkOSError("SIGNER_REQUIRED", "A signer is required to execute transaction plans.");
+        }
+        this.policy.authorize(plan);
+        const signerAddress = await this.signer.getAddress();
+        assertPrincipal(signerAddress, "signer address", this.config.network);
+        if (plan.intent.sender && signerAddress !== plan.intent.sender) {
+            throw new PerkOSError("SIGNER_MISMATCH", `Funding plan expects ${plan.intent.sender}, but the signer controls ${signerAddress}.`);
+        }
+        try {
+            const result = await this.signer.signAndBroadcast(plan);
+            const txid = normalizeTxid(result.txid);
+            this.policy.record(plan);
+            return {
+                txid,
+                status: "broadcast",
+                network: plan.network,
+                contract: plan.contract,
+                operation: plan.intent.operation,
+                ...(plan.intent.asset ? { asset: plan.intent.asset } : {}),
+                ...(plan.intent.amount !== undefined ? { amount: plan.intent.amount } : {}),
+                ...(plan.intent.jobId !== undefined ? { jobId: plan.intent.jobId } : {}),
+                explorerUrl: `https://explorer.hiro.so/txid/${txid}?chain=${plan.network}`,
+                ...(result.raw !== undefined ? { raw: result.raw } : {}),
+            };
+        }
+        catch (cause) {
+            if (cause instanceof PerkOSError)
+                throw cause;
+            throw new PerkOSError("SIGNING_FAILED", "The signer could not broadcast the transaction.", {
+                cause,
+                contract: plan.contract,
+                functionName: plan.functionName,
+            });
+        }
+    }
+    async confirm(receiptOrTxid, options = {}) {
+        if (typeof receiptOrTxid !== "string" &&
+            receiptOrTxid.network !== this.config.network) {
+            throw new PerkOSError("POLICY_DENIED", `Receipt network ${receiptOrTxid.network} does not match client network ${this.config.network}.`);
+        }
+        const txid = typeof receiptOrTxid === "string" ? receiptOrTxid : receiptOrTxid.txid;
+        return this.tracker.waitForConfirmation(txid, options);
+    }
+    async executeAndConfirm(plan, options = {}) {
+        const broadcast = await this.execute(plan);
+        const confirmation = await this.confirm(broadcast, options);
+        return { broadcast, confirmation };
+    }
+    async getAgentCount() {
+        const value = unwrapResponse(await this.read(this.config.contracts.agentRegistry, "get-agent-count"), "get-agent-count");
+        return expectUint(value, "get-agent-count");
+    }
+    async getAgent(agentIdInput) {
+        const agentId = toUint(agentIdInput, "agentId");
+        try {
+            const value = unwrapResponse(await this.read(this.config.contracts.agentRegistry, "get-agent", [Cl.uint(agentId)]), "get-agent");
+            const tuple = expectTuple(value, "get-agent");
+            const endpoints = expectList(tuple.endpoints, "agent.endpoints").map((endpoint, index) => {
+                const endpointTuple = expectTuple(endpoint, `agent.endpoints[${index}]`);
+                return {
+                    name: expectString(endpointTuple.name, `agent.endpoints[${index}].name`),
+                    url: expectString(endpointTuple.url, `agent.endpoints[${index}].url`),
+                };
+            });
+            return {
+                id: agentId,
+                name: expectString(tuple.name, "agent.name"),
+                description: expectString(tuple.description, "agent.description"),
+                creator: expectPrincipal(tuple.creator, "agent.creator"),
+                wallet: expectPrincipal(tuple.wallet, "agent.wallet"),
+                active: expectBoolean(tuple.active, "agent.active"),
+                endpoints,
+            };
+        }
+        catch (error) {
+            if (error instanceof PerkOSError &&
+                error.code === "CONTRACT_ERROR" &&
+                error.details?.clarityCode === 102n) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async getJobCount(asset) {
+        const value = unwrapResponse(await this.read(contractForAsset(this.config.contracts, asset), "get-job-count"), "get-job-count");
+        return expectUint(value, "get-job-count");
+    }
+    async getJob(asset, jobIdInput) {
+        const jobId = toUint(jobIdInput, "jobId");
+        try {
+            const value = unwrapResponse(await this.read(contractForAsset(this.config.contracts, asset), "get-job", [
+                Cl.uint(jobId),
+            ]), "get-job");
+            const tuple = expectTuple(value, "get-job");
+            const statusCode = expectUint(tuple.status, "job.status");
+            const status = JOB_STATUS[Number(statusCode)];
+            if (!status) {
+                throw new PerkOSError("READ_FAILED", `Unknown job status ${statusCode}.`);
+            }
+            const provider = optionalPrincipal(tuple.provider, "job.provider");
+            const deliverable = optionalBuffer(tuple.deliverable, "job.deliverable");
+            return {
+                id: jobId,
+                asset,
+                client: expectPrincipal(tuple.client, "job.client"),
+                ...(provider ? { provider } : {}),
+                evaluator: expectPrincipal(tuple.evaluator, "job.evaluator"),
+                description: expectString(tuple.description, "job.description"),
+                budget: expectUint(tuple.budget, "job.budget"),
+                expiredAt: expectUint(tuple["expired-at"], "job.expired-at"),
+                status,
+                statusCode,
+                ...(deliverable ? { deliverable } : {}),
+            };
+        }
+        catch (error) {
+            if (error instanceof PerkOSError &&
+                error.code === "CONTRACT_ERROR" &&
+                (error.details?.clarityCode === 202n || error.details?.clarityCode === 302n)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async getEscrowBalance(asset, jobIdInput) {
+        const jobId = toUint(jobIdInput, "jobId");
+        const value = unwrapResponse(await this.read(contractForAsset(this.config.contracts, asset), "get-escrow-balance", [
+            Cl.uint(jobId),
+        ]), "get-escrow-balance");
+        return expectUint(value, "get-escrow-balance");
+    }
+    async getConfiguredSbtcToken() {
+        const value = unwrapResponse(await this.read(this.config.contracts.sbtcCommerce, "get-payment-token"), "get-payment-token");
+        return expectPrincipal(value, "get-payment-token");
+    }
+    async getReputation(agent) {
+        assertPrincipal(agent, "agent", this.config.network);
+        const value = unwrapResponse(await this.read(this.config.contracts.reputationRegistry, "get-reputation", [
+            Cl.principal(agent),
+        ]), "get-reputation");
+        const tuple = expectTuple(value, "get-reputation");
+        return {
+            agent,
+            totalScore: expectUint(tuple["total-score"], "reputation.total-score"),
+            ratingCount: expectUint(tuple["rating-count"], "reputation.rating-count"),
+            averageScoreX100: expectUint(tuple["average-score-x100"], "reputation.average-score-x100"),
+            completedJobs: expectUint(tuple["completed-jobs"], "reputation.completed-jobs"),
+            disputedJobs: expectUint(tuple["disputed-jobs"], "reputation.disputed-jobs"),
+        };
+    }
+    registerAgent(input) {
+        return this.execute(this.transactions.registerAgent(input));
+    }
+    updateAgent(input) {
+        return this.execute(this.transactions.updateAgent(input));
+    }
+    deactivateAgent(agentId) {
+        return this.execute(this.transactions.deactivateAgent(agentId));
+    }
+    createJob(input) {
+        return this.execute(this.transactions.createJob(input));
+    }
+    setBudget(input) {
+        return this.execute(this.transactions.setBudget(input));
+    }
+    async fundJob(input) {
+        const jobId = toUint(input.jobId, "jobId");
+        const amount = toUint(input.amount, "amount");
+        this.policy.authorize({
+            type: "contract-call",
+            network: this.config.network,
+            contract: contractForAsset(this.config.contracts, input.asset),
+            functionName: "fund-job",
+            functionArgs: [],
+            postConditions: [],
+            postConditionMode: "deny",
+            intent: { operation: "fund-job", asset: input.asset, amount, jobId },
+        });
+        const sender = input.sender ?? (await this.requireSignerAddress());
+        return this.execute(this.transactions.fundJob({ ...input, jobId, amount, sender }));
+    }
+    assignProvider(input) {
+        return this.execute(this.transactions.assignProvider(input));
+    }
+    submitWork(input) {
+        return this.execute(this.transactions.submitWork(input));
+    }
+    async completeJob(asset, jobIdInput) {
+        const settlement = await this.settlementInput("complete-job", asset, jobIdInput);
+        return this.execute(this.transactions.completeJob(settlement));
+    }
+    async rejectJob(asset, jobIdInput) {
+        const settlement = await this.settlementInput("reject-job", asset, jobIdInput);
+        return this.execute(this.transactions.rejectJob(settlement));
+    }
+    async expireJob(asset, jobIdInput) {
+        const settlement = await this.settlementInput("expire-job", asset, jobIdInput);
+        return this.execute(this.transactions.expireJob(settlement));
+    }
+    rateProvider(input) {
+        return this.execute(this.transactions.rateProvider(input));
+    }
+    async settlementInput(operation, asset, jobIdInput) {
+        const jobId = toUint(jobIdInput, "jobId");
+        const [job, amount] = await Promise.all([
+            this.getJob(asset, jobId),
+            this.getEscrowBalance(asset, jobId),
+        ]);
+        if (!job) {
+            throw new PerkOSError("INPUT_INVALID", `Job ${jobId} does not exist.`);
+        }
+        const recipient = operation === "complete-job"
+            ? job.provider
+            : job.client;
+        if (!recipient) {
+            throw new PerkOSError("INPUT_INVALID", `Job ${jobId} has no provider to receive settlement.`);
+        }
+        return { asset, jobId, amount, recipient };
+    }
+    async requireSignerAddress() {
+        if (!this.signer) {
+            throw new PerkOSError("SIGNER_REQUIRED", "A signer is required to fund a job.");
+        }
+        return this.signer.getAddress();
+    }
+    read(contract, functionName, functionArgs = []) {
+        const senderAddress = parseContractId(contract, "contract", this.config.network).address;
+        return this.readOnlyTransport({
+            network: this.config.network,
+            ...(this.config.apiUrl ? { apiUrl: this.config.apiUrl } : {}),
+            contract,
+            functionName,
+            functionArgs,
+            senderAddress,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,12 @@
+import type { PerkOSContracts, PerkOSNetwork } from "./types.js";
+export declare const DEFAULT_DEPLOYMENTS: Readonly<Record<PerkOSNetwork, PerkOSContracts>>;
+export declare const JOB_STATUS: {
+    readonly 0: "open";
+    readonly 1: "funded";
+    readonly 2: "submitted";
+    readonly 3: "completed";
+    readonly 4: "rejected";
+    readonly 5: "expired";
+};
+export declare const CLARITY_ERROR_MESSAGES: Readonly<Record<number, string>>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKjE,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAiBhF,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAEX,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0CnE,CAAC"}

package/dist/constants.js

@@ -0,0 +1,72 @@
+const MAINNET_DEPLOYER = "SP2K7PV5NXBNRV510S6DCA6RFMTFHAF3ZPK6ZSXPH";
+const TESTNET_DEPLOYER = "ST16EWRC01S1SFWGBP63MW47VY8P3AYFA8VGEBGE5";
+export const DEFAULT_DEPLOYMENTS = {
+    mainnet: {
+        agentRegistry: `${MAINNET_DEPLOYER}.agent-registry`,
+        stxCommerce: `${MAINNET_DEPLOYER}.agentic-commerce-v2`,
+        sbtcCommerce: `${MAINNET_DEPLOYER}.sbtc-commerce`,
+        reputationRegistry: `${MAINNET_DEPLOYER}.reputation-registry-v2`,
+        sbtcToken: "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token",
+        sbtcAssetName: "sbtc-token",
+    },
+    testnet: {
+        agentRegistry: `${TESTNET_DEPLOYER}.agent-registry`,
+        stxCommerce: `${TESTNET_DEPLOYER}.agentic-commerce-v2`,
+        sbtcCommerce: `${TESTNET_DEPLOYER}.sbtc-commerce`,
+        reputationRegistry: `${TESTNET_DEPLOYER}.reputation-registry-v2`,
+        sbtcToken: "ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-token",
+        sbtcAssetName: "sbtc-token",
+    },
+};
+export const JOB_STATUS = {
+    0: "open",
+    1: "funded",
+    2: "submitted",
+    3: "completed",
+    4: "rejected",
+    5: "expired",
+};
+export const CLARITY_ERROR_MESSAGES = {
+    100: "Only the registry owner may perform this operation.",
+    101: "The caller is not authorized by the agent registry.",
+    102: "Agent not found.",
+    103: "Agent name is invalid.",
+    104: "Agent description is invalid.",
+    200: "Only the commerce owner may perform this operation.",
+    201: "The caller is not authorized.",
+    202: "Job not found.",
+    203: "The job is not in the required state.",
+    204: "The job has expired.",
+    205: "The job budget is invalid.",
+    207: "Only the job client may perform this operation.",
+    208: "Only the assigned provider may perform this operation.",
+    209: "Only the evaluator may perform this operation.",
+    210: "The job was already funded.",
+    212: "The job description is invalid.",
+    213: "Client, provider, and evaluator must be distinct.",
+    214: "This rater already rated the job.",
+    215: "The rating must be between 1 and 5.",
+    216: "The job has not expired.",
+    300: "Only the commerce owner may perform this operation.",
+    301: "The caller is not authorized.",
+    302: "Job not found.",
+    303: "The job is not in the required state.",
+    304: "The job has expired.",
+    305: "The job budget is invalid.",
+    307: "Only the job client may perform this operation.",
+    308: "Only the assigned provider may perform this operation.",
+    309: "Only the evaluator may perform this operation.",
+    310: "The job was already funded.",
+    311: "The supplied payment token is not the configured sBTC token.",
+    312: "The job description is invalid.",
+    313: "Client, provider, and evaluator must be distinct.",
+    314: "This rater already rated the job.",
+    315: "The rating must be between 1 and 5.",
+    316: "The job has not expired.",
+    400: "Only the reputation registry owner may perform this operation.",
+    401: "The caller is not an authorized protocol contract.",
+    402: "The rating is invalid.",
+    403: "This job was already rated.",
+    404: "An agent cannot rate itself.",
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,2CAA2C,CAAC;AACrE,MAAM,gBAAgB,GAAG,2CAA2C,CAAC;AAErE,MAAM,CAAC,MAAM,mBAAmB,GAAqD;IACnF,OAAO,EAAE;QACP,aAAa,EAAE,GAAG,gBAAgB,iBAAiB;QACnD,WAAW,EAAE,GAAG,gBAAgB,sBAAsB;QACtD,YAAY,EAAE,GAAG,gBAAgB,gBAAgB;QACjD,kBAAkB,EAAE,GAAG,gBAAgB,yBAAyB;QAChE,SAAS,EAAE,sDAAsD;QACjE,aAAa,EAAE,YAAY;KAC5B;IACD,OAAO,EAAE;QACP,aAAa,EAAE,GAAG,gBAAgB,iBAAiB;QACnD,WAAW,EAAE,GAAG,gBAAgB,sBAAsB;QACtD,YAAY,EAAE,GAAG,gBAAgB,gBAAgB;QACjD,kBAAkB,EAAE,GAAG,gBAAgB,yBAAyB;QAChE,SAAS,EAAE,sDAAsD;QACjE,aAAa,EAAE,YAAY;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,SAAS;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAqC;IACtE,GAAG,EAAE,qDAAqD;IAC1D,GAAG,EAAE,qDAAqD;IAC1D,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,qDAAqD;IAC1D,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,uCAAuC;IAC5C,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,4BAA4B;IACjC,GAAG,EAAE,iDAAiD;IACtD,GAAG,EAAE,wDAAwD;IAC7D,GAAG,EAAE,gDAAgD;IACrD,GAAG,EAAE,6BAA6B;IAClC,GAAG,EAAE,iCAAiC;IACtC,GAAG,EAAE,mDAAmD;IACxD,GAAG,EAAE,mCAAmC;IACxC,GAAG,EAAE,qCAAqC;IAC1C,GAAG,EAAE,0BAA0B;IAC/B,GAAG,EAAE,qDAAqD;IAC1D,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,gBAAgB;IACrB,GAAG,EAAE,uCAAuC;IAC5C,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,4BAA4B;IACjC,GAAG,EAAE,iDAAiD;IACtD,GAAG,EAAE,wDAAwD;IAC7D,GAAG,EAAE,gDAAgD;IACrD,GAAG,EAAE,6BAA6B;IAClC,GAAG,EAAE,8DAA8D;IACnE,GAAG,EAAE,iCAAiC;IACtC,GAAG,EAAE,mDAAmD;IACxD,GAAG,EAAE,mCAAmC;IACxC,GAAG,EAAE,qCAAqC;IAC1C,GAAG,EAAE,0BAA0B;IAC/B,GAAG,EAAE,gEAAgE;IACrE,GAAG,EAAE,oDAAoD;IACzD,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,6BAA6B;IAClC,GAAG,EAAE,8BAA8B;CACpC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+export type PerkOSErrorCode = "CONFIG_INVALID" | "INPUT_INVALID" | "CONTRACT_ERROR" | "READ_FAILED" | "SIGNER_REQUIRED" | "SIGNER_MISMATCH" | "POLICY_DENIED" | "POLICY_LIMIT_REQUIRED" | "SIGNING_FAILED" | "BROADCAST_REJECTED" | "CONFIRMATION_FAILED";
+export interface PerkOSErrorDetails {
+    readonly clarityCode?: bigint;
+    readonly contract?: string;
+    readonly functionName?: string;
+    readonly cause?: unknown;
+    readonly [key: string]: unknown;
+}
+export declare class PerkOSError extends Error {
+    readonly code: PerkOSErrorCode;
+    readonly details: PerkOSErrorDetails | undefined;
+    constructor(code: PerkOSErrorCode, message: string, details?: PerkOSErrorDetails);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,uBAAuB,GACvB,gBAAgB,GAChB,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CAAC;gBAErC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;CAMjF"}

package/dist/errors.js

@@ -0,0 +1,11 @@
+export class PerkOSError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "PerkOSError";
+        this.code = code;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IACtB,OAAO,CAAiC;IAEjD,YAAY,IAAqB,EAAE,OAAe,EAAE,OAA4B;QAC9E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { PerkOSClient } from "./client.js";
+export { PerkOSTransactionBuilder } from "./builders.js";
+export { SpendingPolicy } from "./policy.js";
+export { HeadlessSigner, StacksConnectSigner } from "./signers.js";
+export { TransactionTracker } from "./tracker.js";
+export { PerkOSError } from "./errors.js";
+export { DEFAULT_DEPLOYMENTS, JOB_STATUS, CLARITY_ERROR_MESSAGES } from "./constants.js";
+export { resolveConfig, toUint } from "./validation.js";
+export { normalizeTxid } from "./txid.js";
+export type { HeadlessSignerOptions, HeadlessTransactionExecutor, HeadlessTransactionRequest, PrivateKeyMaterial, PrivateKeyProvider, StacksConnectContractCallParams, StacksConnectRequest, StacksConnectSignerOptions, } from "./signers.js";
+export type { TrackerFetch, TransactionTrackerOptions, } from "./tracker.js";
+export type { AgentEndpoint, AgentRecord, Amount, AmountLike, AssignProviderInput, ConfirmationOptions, ConfirmedTransactionReceipt, ContractCallPlan, ContractId, CreateJobInput, FundJobInput, JobAmountInput, JobRecord, JobStatus, PaymentAsset, PerkOSConfig, PerkOSContracts, PerkOSNetwork, PerkOSOperation, PerkOSSigner, RateProviderInput, ReadOnlyCall, ReadOnlyTransport, RegisterAgentInput, ReputationRecord, ResolvedPerkOSConfig, SettleJobInput, SignerResult, SpendingApproval, SpendingPolicyInput, SubmitWorkInput, TransactionIntent, TransactionConfirmation, TransactionConfirmationStatus, TransactionReceipt, TransactionResultValue, TransactionTrackerLike, UpdateAgentInput, } from "./types.js";
+export type { PerkOSErrorCode, PerkOSErrorDetails } from "./errors.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,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,YAAY,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,+BAA+B,EAC/B,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,aAAa,EACb,WAAW,EACX,MAAM,EACN,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { PerkOSClient } from "./client.js";
+export { PerkOSTransactionBuilder } from "./builders.js";
+export { SpendingPolicy } from "./policy.js";
+export { HeadlessSigner, StacksConnectSigner } from "./signers.js";
+export { TransactionTracker } from "./tracker.js";
+export { PerkOSError } from "./errors.js";
+export { DEFAULT_DEPLOYMENTS, JOB_STATUS, CLARITY_ERROR_MESSAGES } from "./constants.js";
+export { resolveConfig, toUint } from "./validation.js";
+export { normalizeTxid } from "./txid.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,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/policy.d.ts

@@ -0,0 +1,14 @@
+import type { ContractCallPlan, PaymentAsset, ResolvedPerkOSConfig, SpendingApproval, SpendingPolicyInput } from "./types.js";
+export declare class SpendingPolicy {
+    private readonly allowedNetworks;
+    private readonly allowedContracts;
+    private readonly allowedAssets;
+    private readonly maxPerTransaction;
+    private readonly maxPerSession;
+    private readonly spent;
+    constructor(config: ResolvedPerkOSConfig, input?: SpendingPolicyInput);
+    authorize(plan: ContractCallPlan): SpendingApproval;
+    record(plan: ContractCallPlan): void;
+    spentThisSession(asset: PaymentAsset): bigint;
+}
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAiBpB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsB;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuD;gBAEjE,MAAM,EAAE,oBAAoB,EAAE,KAAK,GAAE,mBAAwB;IAezE,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB;IA8CnD,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAOpC,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;CAG9C"}

package/dist/policy.js

@@ -0,0 +1,75 @@
+import { PerkOSError } from "./errors.js";
+import { toUint } from "./validation.js";
+function limitsFrom(input, field) {
+    const result = {};
+    for (const asset of ["sbtc", "stx"]) {
+        const value = input?.[asset];
+        if (value !== undefined)
+            result[asset] = toUint(value, `${field}.${asset}`);
+    }
+    return result;
+}
+export class SpendingPolicy {
+    allowedNetworks;
+    allowedContracts;
+    allowedAssets;
+    maxPerTransaction;
+    maxPerSession;
+    spent = { sbtc: 0n, stx: 0n };
+    constructor(config, input = {}) {
+        this.allowedNetworks = new Set(input.allowedNetworks ?? [config.network]);
+        this.allowedContracts = new Set(input.allowedContracts ?? [
+            config.contracts.agentRegistry,
+            config.contracts.stxCommerce,
+            config.contracts.sbtcCommerce,
+            config.contracts.reputationRegistry,
+        ]);
+        this.allowedAssets = new Set(input.allowedAssets ?? ["sbtc", "stx"]);
+        this.maxPerTransaction = limitsFrom(input.maxPerTransaction, "maxPerTransaction");
+        this.maxPerSession = limitsFrom(input.maxPerSession, "maxPerSession");
+    }
+    authorize(plan) {
+        if (!this.allowedNetworks.has(plan.network)) {
+            throw new PerkOSError("POLICY_DENIED", `Network ${plan.network} is not allowed.`);
+        }
+        if (!this.allowedContracts.has(plan.contract)) {
+            throw new PerkOSError("POLICY_DENIED", `Contract ${plan.contract} is not allowed.`);
+        }
+        const { asset, amount } = plan.intent;
+        if (!asset || amount === undefined || amount === 0n || plan.intent.operation !== "fund-job") {
+            return { operation: plan.intent.operation, ...(asset ? { asset } : {}) };
+        }
+        if (!this.allowedAssets.has(asset)) {
+            throw new PerkOSError("POLICY_DENIED", `Asset ${asset} is not allowed.`);
+        }
+        const transactionLimit = this.maxPerTransaction[asset];
+        const sessionLimit = this.maxPerSession[asset];
+        if (transactionLimit === undefined || sessionLimit === undefined) {
+            throw new PerkOSError("POLICY_LIMIT_REQUIRED", `Funding ${asset} requires maxPerTransaction.${asset} and maxPerSession.${asset}.`);
+        }
+        if (amount > transactionLimit) {
+            throw new PerkOSError("POLICY_DENIED", `Funding amount ${amount} exceeds the ${asset} per-transaction limit ${transactionLimit}.`);
+        }
+        const nextSpent = this.spent[asset] + amount;
+        if (nextSpent > sessionLimit) {
+            throw new PerkOSError("POLICY_DENIED", `Funding would exceed the ${asset} session limit ${sessionLimit}.`);
+        }
+        return {
+            operation: plan.intent.operation,
+            asset,
+            amount,
+            spentThisSession: this.spent[asset],
+            remainingThisSession: sessionLimit - nextSpent,
+        };
+    }
+    record(plan) {
+        const { asset, amount, operation } = plan.intent;
+        if (operation === "fund-job" && asset && amount !== undefined) {
+            this.spent[asset] += amount;
+        }
+    }
+    spentThisSession(asset) {
+        return this.spent[asset];
+    }
+}
+//# sourceMappingURL=policy.js.map