@shardlink/agent-sdk 0.1.0

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,EAC7B,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,aAAa,EACb,WAAW,EACX,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEhF,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC1C,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,GAAG,sBAAsB,CAAC;CACtD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;gBAEf,OAAO,EAAE,qBAAqB;IA2B1C,gDAAgD;IAChD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAIK,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIrF,qBAAqB,CAAC,KAAK,EAAE;QACjC,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI3B,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAInD,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIrD,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAIhF,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIxD,eAAe,CACnB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,OAAO,CAAC;IAIb,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxF,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;KAAE,EACxC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAIb,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IASb,oBAAoB,CACxB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAIb,uBAAuB,CAC3B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAUb,uBAAuB,CAC3B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAUb,mBAAmB,CACvB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAUb,yBAAyB,CAC7B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAUb,wBAAwB,CAC5B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IAIb,yBAAyB,CAC7B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAUb,mBAAmB,CACvB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAIb,oBAAoB,CACxB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAUb,4BAA4B,CAAC,KAAK,EAAE;QACxC,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,CAAC,WAAW,EAAE,sBAAsB,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;KACnF,GAAG,OAAO,CAAC;QACV,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAC;QAC3C,eAAe,EAAE,mBAAmB,GAAG,IAAI,CAAC;QAC5C,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IAII,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,SAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9E,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D,sBAAsB,CAC1B,KAAK,GAAE,oBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;IAItC;;;;;;;;OAQG;IACG,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;CAYjE"}

package/dist/client.js

@@ -0,0 +1,190 @@
+/**
+ * `AgentSdkClient` — the thin coordinator that wires every SDK module onto a
+ * single HTTP context.
+ *
+ * The coordinator preserves backward compatibility with the pre-modular SDK:
+ * every method that existed on the old monolithic client continues to work
+ * with the same signatures. New work should prefer the module accessors
+ * (`client.auth`, `client.tasks`, etc.) or the module imports at
+ * `@shardlink/agent-sdk/auth`, `@shardlink/agent-sdk/tasks`, ...
+ *
+ * @packageDocumentation
+ */
+import { HttpContext } from "./utils.js";
+import { runQuickJoin } from "./client-quick-join.js";
+import { AgentsClient } from "./modules/agents.js";
+import { AuthClient } from "./modules/auth.js";
+import { BillingClient } from "./modules/billing.js";
+import { DiscoveryClient } from "./modules/discovery.js";
+import { LeaseClient } from "./modules/leases.js";
+import { ProvidersClient } from "./modules/providers.js";
+import { ReactionsClient } from "./modules/reactions.js";
+import { TasksClient } from "./modules/tasks.js";
+import { WorkspaceClient } from "./modules/workspace.js";
+import { A2AClient } from "./modules/a2a.js";
+import { RegisterClient } from "./modules/register.js";
+import { DiagnosticsClient } from "./modules/diagnostics.js";
+import { QuotaClient } from "./modules/quota.js";
+import { TelemetryClient } from "./modules/telemetry.js";
+import { DashboardClient } from "./modules/dashboard.js";
+export * from "./types.js";
+export { ShardLinkError, AuthError, LeaseError, BillingError, RateLimitError, PaymentRequiredError, CapabilityError, ValidationError, ConflictError, ServerError, NetworkError } from "./errors.js";
+export { parseX402PaymentRequired, parseX402PaymentResponse } from "./utils.js";
+/**
+ * Coordinator client for the ShardLink control-plane.
+ *
+ * @example
+ * ```ts
+ * const client = new AgentSdkClient({
+ *   baseUrl: process.env.SHARDLINK_BASE_URL!,
+ *   getToken: () => process.env.SHARDLINK_SERVICE_TOKEN!
+ * });
+ * await client.quickJoin({ ... });
+ * ```
+ */
+export class AgentSdkClient {
+    auth;
+    discovery;
+    workspace;
+    agents;
+    billing;
+    leases;
+    providers;
+    tasks;
+    reactions;
+    a2a;
+    register;
+    diagnostics;
+    quota;
+    dashboard;
+    /** Telemetry client — always present; no-op when not configured. */
+    telemetry;
+    /**
+     * The underlying HTTP context. Exposed read-only so consumers can construct
+     * workspace-scoped modules ({@link CrossPlaneClient}, {@link LeaseManager},
+     * custom extensions) that share the client's base URL + token provider.
+     */
+    http;
+    constructor(options) {
+        this.telemetry =
+            options.telemetry instanceof TelemetryClient
+                ? options.telemetry
+                : new TelemetryClient({ enabled: false, ...(options.telemetry ?? {}) });
+        this.http = new HttpContext({
+            baseUrl: options.baseUrl,
+            ...(options.getToken ? { getToken: options.getToken } : {}),
+            ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+            telemetry: this.telemetry
+        });
+        this.auth = new AuthClient(this.http);
+        this.discovery = new DiscoveryClient(this.http);
+        this.workspace = new WorkspaceClient(this.http);
+        this.agents = new AgentsClient(this.http);
+        this.billing = new BillingClient(this.http);
+        this.leases = new LeaseClient(this.http);
+        this.providers = new ProvidersClient(this.http);
+        this.tasks = new TasksClient(this.http);
+        this.reactions = new ReactionsClient(this.http);
+        this.a2a = new A2AClient(this.http);
+        this.register = new RegisterClient(this.http, this.auth, this.agents, this.workspace);
+        this.diagnostics = new DiagnosticsClient({ http: this.http, discovery: this.discovery });
+        this.quota = new QuotaClient();
+        this.dashboard = new DashboardClient({ http: this.http, discovery: this.discovery });
+    }
+    /** Base URL the client was constructed with. */
+    get baseUrl() {
+        return this.http.baseUrl;
+    }
+    // ---- Backward-compatible method surface below ---------------------------
+    async requestWalletChallenge(input) {
+        return this.auth.requestWalletChallenge(input);
+    }
+    async verifyWalletChallenge(input) {
+        return this.auth.verifyWalletChallenge(input);
+    }
+    async repeatWalletAccess() {
+        return this.auth.repeatWalletAccess();
+    }
+    async getRoamingPreflight() {
+        return this.discovery.getRoamingPreflight();
+    }
+    async getPublicAgentPassport(identity) {
+        return this.discovery.getPublicAgentPassport(identity);
+    }
+    async getMcpServerMetadata() {
+        return this.discovery.getMcpServerMetadata();
+    }
+    async registerRuntime(input, options = {}) {
+        return this.agents.registerRuntime(input, options);
+    }
+    async bootstrap(input, options = {}) {
+        return this.agents.bootstrap(input, options);
+    }
+    async createPricingQuote(workspaceSlug, actorSessionToken, input, idempotencyKey) {
+        return this.billing.createPricingQuote(workspaceSlug, actorSessionToken, input, idempotencyKey);
+    }
+    async acceptPricingQuote(workspaceSlug, actorSessionToken, quoteId, idempotencyKey) {
+        return this.billing.acceptPricingQuote(workspaceSlug, actorSessionToken, quoteId, idempotencyKey);
+    }
+    async createBillingAccount(workspaceSlug, actorSessionToken, input, idempotencyKey) {
+        return this.billing.createAccount(workspaceSlug, actorSessionToken, input, idempotencyKey);
+    }
+    async attachFundingInstrument(workspaceSlug, actorSessionToken, accountId, input, idempotencyKey) {
+        return this.billing.attachInstrument(workspaceSlug, actorSessionToken, accountId, input, idempotencyKey);
+    }
+    async verifyFundingInstrument(workspaceSlug, actorSessionToken, accountId, instrumentId, idempotencyKey) {
+        return this.billing.verifyInstrument(workspaceSlug, actorSessionToken, accountId, instrumentId, idempotencyKey);
+    }
+    async createSpendEnvelope(workspaceSlug, actorSessionToken, accountId, input, idempotencyKey) {
+        return this.billing.createEnvelope(workspaceSlug, actorSessionToken, accountId, input, idempotencyKey);
+    }
+    async createDelegatedSpendGrant(workspaceSlug, actorSessionToken, accountId, input, idempotencyKey) {
+        return this.billing.createDelegatedGrant(workspaceSlug, actorSessionToken, accountId, input, idempotencyKey);
+    }
+    async listDelegatedSpendGrants(workspaceSlug, actorSessionToken, accountId) {
+        return this.billing.listDelegatedGrants(workspaceSlug, actorSessionToken, accountId);
+    }
+    async revokeDelegatedSpendGrant(workspaceSlug, actorSessionToken, accountId, grantId, idempotencyKey) {
+        return this.billing.revokeDelegatedGrant(workspaceSlug, actorSessionToken, accountId, grantId, idempotencyKey);
+    }
+    async createProviderQuote(workspaceSlug, actorSessionToken, input, idempotencyKey) {
+        return this.providers.createQuote(workspaceSlug, actorSessionToken, input, idempotencyKey);
+    }
+    async executeProviderQuote(workspaceSlug, actorSessionToken, quoteId, input, idempotencyKey) {
+        return this.providers.executeQuote(workspaceSlug, actorSessionToken, quoteId, input, idempotencyKey);
+    }
+    async executeProviderQuoteWithX402(input) {
+        return this.providers.executeQuoteWithX402(input);
+    }
+    async getWorkspaceLoad(workspaceSlug, windowSeconds = 900) {
+        return this.workspace.getLoad(workspaceSlug, windowSeconds);
+    }
+    async getMeteringSummary(input) {
+        return this.workspace.getMeteringSummary(input);
+    }
+    async exportMetering(input) {
+        return this.workspace.exportMetering(input);
+    }
+    async listWorkspaceDirectory(input = {}) {
+        return this.workspace.list(input);
+    }
+    /**
+     * Zero-to-lease onboarding: register runtime → bootstrap → optional funding
+     * → lease request. Preserves the original sequencing and idempotency-key
+     * derivation from the pre-modular SDK.
+     *
+     * The orchestration body lives in {@link runQuickJoin} (`./client-quick-join`)
+     * so this coordinator file stays under the SDK module size ceiling; behavior
+     * and signature are unchanged.
+     */
+    async quickJoin(input) {
+        return runQuickJoin({
+            http: this.http,
+            workspace: this.workspace,
+            agents: this.agents,
+            billing: this.billing,
+            leases: this.leases
+        }, input);
+    }
+}
+//# 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/errors.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Typed error catalog for the ShardLink Agent SDK.
+ *
+ * Every HTTP failure the control-plane produces is mapped to a concrete
+ * subclass of {@link ShardLinkError} so agents can discriminate on `code`,
+ * decide whether to retry (`retryable`, `retryAfter`), and attach
+ * `correlationId` to support tickets.
+ *
+ * @packageDocumentation
+ */
+import type { X402PaymentRequirement } from "./types.js";
+/**
+ * Base error thrown by the ShardLink Agent SDK for any control-plane failure.
+ *
+ * Prefer catching the subclasses (e.g. {@link RateLimitError},
+ * {@link PaymentRequiredError}) when you need category-specific handling.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await tasks.claim("task_123");
+ * } catch (err) {
+ *   if (err instanceof RateLimitError && err.retryAfter) {
+ *     await sleep(err.retryAfter);
+ *     continue;
+ *   }
+ *   throw err;
+ * }
+ * ```
+ */
+export declare class ShardLinkError extends Error {
+    /** Machine-readable error code (e.g. `"rate_limited"`). */
+    readonly code: string;
+    /** HTTP status that produced this error (0 if not HTTP-originated). */
+    readonly status: number;
+    /** Whether the caller can safely retry the same request. */
+    readonly retryable: boolean;
+    /** Server-suggested delay before retrying, in milliseconds. */
+    readonly retryAfter?: number;
+    /** Correlation identifier for support/debug. */
+    readonly correlationId?: string;
+    /** Name of the SDK operation that raised this error. */
+    readonly operation?: string;
+    /** Structured payload returned by the server (if any). */
+    readonly details?: unknown;
+    constructor(init: {
+        message: string;
+        code: string;
+        status: number;
+        retryable?: boolean;
+        retryAfter?: number;
+        correlationId?: string;
+        operation?: string;
+        details?: unknown;
+    });
+}
+/** Authentication/authorization failure (401, 403, invalid token, missing scope). */
+export declare class AuthError extends ShardLinkError {
+    constructor(init: ConstructorParameters<typeof ShardLinkError>[0]);
+}
+/** Lease lifecycle failure (lease missing, expired, revoked, insufficient tier). */
+export declare class LeaseError extends ShardLinkError {
+    constructor(init: ConstructorParameters<typeof ShardLinkError>[0]);
+}
+/** Billing or spend-envelope failure (cap hit, instrument invalid, grant expired). */
+export declare class BillingError extends ShardLinkError {
+    constructor(init: ConstructorParameters<typeof ShardLinkError>[0]);
+}
+/** Rate-limited by the control-plane. `retryAfter` is always set. */
+export declare class RateLimitError extends ShardLinkError {
+    constructor(init: Omit<ConstructorParameters<typeof ShardLinkError>[0], "retryable">);
+}
+/**
+ * A 402 payment-required challenge. The `requirement` is the parsed x402
+ * envelope — feed it to your wallet to mint a PAYMENT header, then retry.
+ */
+export declare class PaymentRequiredError extends ShardLinkError {
+    /** Parsed x402 payment requirement from the `PAYMENT-REQUIRED` header/body. */
+    readonly requirement: X402PaymentRequirement | null;
+    constructor(init: ConstructorParameters<typeof ShardLinkError>[0] & {
+        requirement: X402PaymentRequirement | null;
+    });
+}
+/** Capability mismatch — agent can't take this action (wrong adapter, trust tier, etc). */
+export declare class CapabilityError extends ShardLinkError {
+    constructor(init: ConstructorParameters<typeof ShardLinkError>[0]);
+}
+/** Request validation failure — 400 with a field-level cause. */
+export declare class ValidationError extends ShardLinkError {
+    constructor(init: ConstructorParameters<typeof ShardLinkError>[0]);
+}
+/** Conflict — idempotency collision, already-claimed task, duplicate join. */
+export declare class ConflictError extends ShardLinkError {
+    constructor(init: ConstructorParameters<typeof ShardLinkError>[0]);
+}
+/** Server-side fault (500/502/503/504). Retryable with backoff. */
+export declare class ServerError extends ShardLinkError {
+    constructor(init: Omit<ConstructorParameters<typeof ShardLinkError>[0], "retryable">);
+}
+/** Network/transport error before the server could respond. Always retryable. */
+export declare class NetworkError extends ShardLinkError {
+    constructor(init: Omit<ConstructorParameters<typeof ShardLinkError>[0], "retryable" | "status">);
+}
+/**
+ * Build a typed error from a non-OK `Response` and the decoded JSON payload.
+ *
+ * @param operation - Name of the SDK operation (e.g. `"task-claim"`) — surfaces in error messages.
+ * @param response - The HTTP response the server returned.
+ * @param payload - The parsed JSON body (or `null` if none).
+ * @param parsedRequirement - Pre-parsed x402 requirement (used for 402 responses).
+ *
+ * @example
+ * ```ts
+ * const res = await fetch(url);
+ * if (!res.ok) {
+ *   throw errorFromResponse("task-claim", res, await res.json());
+ * }
+ * ```
+ */
+export declare function errorFromResponse(operation: string, response: Response, payload: unknown, parsedRequirement?: X402PaymentRequirement | null): ShardLinkError;
+/**
+ * Wrap a thrown exception from `fetch()` in a {@link NetworkError} so callers
+ * get the same typed-error contract for transport failures.
+ */
+export declare function wrapNetworkError(operation: string, cause: unknown): NetworkError;
+//# 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":"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"}

package/dist/errors.js

@@ -0,0 +1,330 @@
+/**
+ * Typed error catalog for the ShardLink Agent SDK.
+ *
+ * Every HTTP failure the control-plane produces is mapped to a concrete
+ * subclass of {@link ShardLinkError} so agents can discriminate on `code`,
+ * decide whether to retry (`retryable`, `retryAfter`), and attach
+ * `correlationId` to support tickets.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Base error thrown by the ShardLink Agent SDK for any control-plane failure.
+ *
+ * Prefer catching the subclasses (e.g. {@link RateLimitError},
+ * {@link PaymentRequiredError}) when you need category-specific handling.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await tasks.claim("task_123");
+ * } catch (err) {
+ *   if (err instanceof RateLimitError && err.retryAfter) {
+ *     await sleep(err.retryAfter);
+ *     continue;
+ *   }
+ *   throw err;
+ * }
+ * ```
+ */
+export class ShardLinkError extends Error {
+    /** Machine-readable error code (e.g. `"rate_limited"`). */
+    code;
+    /** HTTP status that produced this error (0 if not HTTP-originated). */
+    status;
+    /** Whether the caller can safely retry the same request. */
+    retryable;
+    /** Server-suggested delay before retrying, in milliseconds. */
+    retryAfter;
+    /** Correlation identifier for support/debug. */
+    correlationId;
+    /** Name of the SDK operation that raised this error. */
+    operation;
+    /** Structured payload returned by the server (if any). */
+    details;
+    constructor(init) {
+        super(init.message);
+        this.name = "ShardLinkError";
+        this.code = init.code;
+        this.status = init.status;
+        this.retryable = init.retryable ?? false;
+        if (init.retryAfter !== undefined) {
+            this.retryAfter = init.retryAfter;
+        }
+        if (init.correlationId !== undefined) {
+            this.correlationId = init.correlationId;
+        }
+        if (init.operation !== undefined) {
+            this.operation = init.operation;
+        }
+        if (init.details !== undefined) {
+            this.details = init.details;
+        }
+    }
+}
+/** Authentication/authorization failure (401, 403, invalid token, missing scope). */
+export class AuthError extends ShardLinkError {
+    constructor(init) {
+        super(init);
+        this.name = "AuthError";
+    }
+}
+/** Lease lifecycle failure (lease missing, expired, revoked, insufficient tier). */
+export class LeaseError extends ShardLinkError {
+    constructor(init) {
+        super(init);
+        this.name = "LeaseError";
+    }
+}
+/** Billing or spend-envelope failure (cap hit, instrument invalid, grant expired). */
+export class BillingError extends ShardLinkError {
+    constructor(init) {
+        super(init);
+        this.name = "BillingError";
+    }
+}
+/** Rate-limited by the control-plane. `retryAfter` is always set. */
+export class RateLimitError extends ShardLinkError {
+    constructor(init) {
+        super({ ...init, retryable: true });
+        this.name = "RateLimitError";
+    }
+}
+/**
+ * A 402 payment-required challenge. The `requirement` is the parsed x402
+ * envelope — feed it to your wallet to mint a PAYMENT header, then retry.
+ */
+export class PaymentRequiredError extends ShardLinkError {
+    /** Parsed x402 payment requirement from the `PAYMENT-REQUIRED` header/body. */
+    requirement;
+    constructor(init) {
+        super(init);
+        this.name = "PaymentRequiredError";
+        this.requirement = init.requirement;
+    }
+}
+/** Capability mismatch — agent can't take this action (wrong adapter, trust tier, etc). */
+export class CapabilityError extends ShardLinkError {
+    constructor(init) {
+        super(init);
+        this.name = "CapabilityError";
+    }
+}
+/** Request validation failure — 400 with a field-level cause. */
+export class ValidationError extends ShardLinkError {
+    constructor(init) {
+        super(init);
+        this.name = "ValidationError";
+    }
+}
+/** Conflict — idempotency collision, already-claimed task, duplicate join. */
+export class ConflictError extends ShardLinkError {
+    constructor(init) {
+        super(init);
+        this.name = "ConflictError";
+    }
+}
+/** Server-side fault (500/502/503/504). Retryable with backoff. */
+export class ServerError extends ShardLinkError {
+    constructor(init) {
+        super({ ...init, retryable: true });
+        this.name = "ServerError";
+    }
+}
+/** Network/transport error before the server could respond. Always retryable. */
+export class NetworkError extends ShardLinkError {
+    constructor(init) {
+        super({ ...init, status: 0, retryable: true });
+        this.name = "NetworkError";
+    }
+}
+/** Known error codes that the control-plane returns — used by {@link errorFromResponse}. */
+const AUTH_CODES = new Set([
+    "unauthorized",
+    "missing_token",
+    "invalid_token",
+    "token_expired",
+    "forbidden",
+    "wallet_signature_invalid",
+    "wallet_challenge_expired",
+    "wallet_challenge_not_found",
+    "session_expired"
+]);
+const LEASE_CODES = new Set([
+    "lease_expired",
+    "lease_revoked",
+    "lease_missing",
+    "lease_tier_invalid",
+    "lease_quota_exceeded",
+    "lease_already_active"
+]);
+const BILLING_CODES = new Set([
+    "spend_cap_exceeded",
+    "envelope_depleted",
+    "envelope_expired",
+    "instrument_invalid",
+    "delegated_grant_expired",
+    "delegated_grant_revoked",
+    "funding_required"
+]);
+const CAPABILITY_CODES = new Set([
+    "capability_missing",
+    "adapter_unsupported",
+    "trust_tier_insufficient",
+    "reaction_term_invalid",
+    "action_not_permitted"
+]);
+function parseRetryAfter(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    const asSeconds = Number(trimmed);
+    if (Number.isFinite(asSeconds)) {
+        return Math.max(0, Math.round(asSeconds * 1000));
+    }
+    const asDate = Date.parse(trimmed);
+    if (!Number.isNaN(asDate)) {
+        return Math.max(0, asDate - Date.now());
+    }
+    return undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function extractErrorShape(payload) {
+    if (!isRecord(payload)) {
+        return {};
+    }
+    const err = isRecord(payload.error) ? payload.error : payload;
+    const code = typeof err.code === "string" ? err.code : undefined;
+    const message = typeof err.message === "string" ? err.message : undefined;
+    const details = err.details ?? (isRecord(payload.error) ? payload.details : undefined);
+    const correlationId = typeof err.correlationId === "string"
+        ? err.correlationId
+        : typeof payload.correlationId === "string"
+            ? payload.correlationId
+            : undefined;
+    const requirement = payload.paymentRequirement;
+    // The control-plane error envelope emits `error.retryAfter` in MILLISECONDS,
+    // which is more precise than the whole-second `Retry-After` HTTP header.
+    // Only accept a finite, non-negative number.
+    const retryAfter = typeof err.retryAfter === "number" && Number.isFinite(err.retryAfter) && err.retryAfter >= 0
+        ? err.retryAfter
+        : undefined;
+    return {
+        ...(code !== undefined ? { code } : {}),
+        ...(message !== undefined ? { message } : {}),
+        ...(details !== undefined ? { details } : {}),
+        ...(correlationId !== undefined ? { correlationId } : {}),
+        ...(requirement !== undefined ? { requirement } : {}),
+        ...(retryAfter !== undefined ? { retryAfter } : {})
+    };
+}
+/**
+ * Build a typed error from a non-OK `Response` and the decoded JSON payload.
+ *
+ * @param operation - Name of the SDK operation (e.g. `"task-claim"`) — surfaces in error messages.
+ * @param response - The HTTP response the server returned.
+ * @param payload - The parsed JSON body (or `null` if none).
+ * @param parsedRequirement - Pre-parsed x402 requirement (used for 402 responses).
+ *
+ * @example
+ * ```ts
+ * const res = await fetch(url);
+ * if (!res.ok) {
+ *   throw errorFromResponse("task-claim", res, await res.json());
+ * }
+ * ```
+ */
+export function errorFromResponse(operation, response, payload, parsedRequirement = null) {
+    const shape = extractErrorShape(payload);
+    const code = shape.code ?? defaultCodeForStatus(response.status);
+    const correlationId = shape.correlationId ?? response.headers.get("x-correlation-id") ?? undefined;
+    // Prefer the JSON body's `error.retryAfter` (milliseconds, more precise) and
+    // fall back to the whole-second `Retry-After` HTTP header when absent.
+    const retryAfter = shape.retryAfter ?? parseRetryAfter(response.headers.get("retry-after"));
+    const message = shape.message ?? `[${operation}] request failed with ${response.status} (${code})`;
+    const init = {
+        message,
+        code,
+        status: response.status,
+        operation,
+        details: shape.details ?? payload,
+        ...(correlationId !== undefined ? { correlationId } : {}),
+        ...(retryAfter !== undefined ? { retryAfter } : {})
+    };
+    if (response.status === 402) {
+        return new PaymentRequiredError({
+            ...init,
+            retryable: true,
+            requirement: parsedRequirement
+        });
+    }
+    if (response.status === 429) {
+        return new RateLimitError({
+            ...init,
+            retryAfter: retryAfter ?? 1_000
+        });
+    }
+    if (response.status === 401 || AUTH_CODES.has(code)) {
+        return new AuthError({ ...init, retryable: false });
+    }
+    if (response.status === 403 && CAPABILITY_CODES.has(code)) {
+        return new CapabilityError({ ...init, retryable: false });
+    }
+    if (response.status === 409) {
+        return new ConflictError({ ...init, retryable: false });
+    }
+    if (LEASE_CODES.has(code)) {
+        return new LeaseError({ ...init, retryable: false });
+    }
+    if (BILLING_CODES.has(code)) {
+        return new BillingError({ ...init, retryable: false });
+    }
+    if (response.status >= 500) {
+        return new ServerError(init);
+    }
+    if (response.status === 400 || response.status === 422) {
+        return new ValidationError({ ...init, retryable: false });
+    }
+    return new ShardLinkError({ ...init, retryable: false });
+}
+function defaultCodeForStatus(status) {
+    if (status === 400)
+        return "bad_request";
+    if (status === 401)
+        return "unauthorized";
+    if (status === 402)
+        return "payment_required";
+    if (status === 403)
+        return "forbidden";
+    if (status === 404)
+        return "not_found";
+    if (status === 409)
+        return "conflict";
+    if (status === 422)
+        return "validation_failed";
+    if (status === 429)
+        return "rate_limited";
+    if (status >= 500 && status < 600)
+        return "server_error";
+    return `http_${status}`;
+}
+/**
+ * Wrap a thrown exception from `fetch()` in a {@link NetworkError} so callers
+ * get the same typed-error contract for transport failures.
+ */
+export function wrapNetworkError(operation, cause) {
+    const message = cause instanceof Error ? cause.message : typeof cause === "string" ? cause : "network error";
+    return new NetworkError({
+        message: `[${operation}] ${message}`,
+        code: "network_error",
+        operation,
+        details: cause
+    });
+}
+//# sourceMappingURL=errors.js.map