@shardlink/agent-sdk 0.1.0

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Barrel export for `@shardlink/agent-sdk`.
+ *
+ * All public surfaces remain importable from the root:
+ *
+ * ```ts
+ * import { AgentSdkClient, quickStart, ShardLinkError } from "@shardlink/agent-sdk";
+ * ```
+ *
+ * Individual modules are also importable directly for tree-shaking:
+ *
+ * ```ts
+ * import { TasksClient } from "@shardlink/agent-sdk/tasks";
+ * import { openStream } from "@shardlink/agent-sdk/streams";
+ * ```
+ */
+export * from "./client.js";
+export * from "./errors.js";
+export * from "./retry.js";
+export * from "./types.js";
+export * from "./quickstart.js";
+export { HttpContext, expectJson, readJson } from "./utils.js";
+export { AuthClient } from "./modules/auth.js";
+export { DiscoveryClient, type EnrichedAgentCard, type CapabilityGraph, type CapabilityGraphAction } from "./modules/discovery.js";
+export { WorkspaceClient, type WorkspaceCapabilitiesReport, type WorkspaceLoadReport, type WorkspaceMeteringSummary, type WorkspaceMeteringExport, type UsageMeterSummary, type UsageMeterEntry } from "./modules/workspace.js";
+export { AgentsClient, type AgentRuntimeRegistration, type RegisterRuntimeResult, type BootstrapResult, type BootstrapRuntimeStatus } from "./modules/agents.js";
+export { BillingClient, type PricingQuote, type BillingAccount, type FundingInstrument, type FundingRailHealth, type SpendEnvelope, type DelegatedSpendGrant, type CreatePricingQuoteResult, type VerifyInstrumentResult } from "./modules/billing.js";
+export { LeaseClient, type LeaseRequestResult, type LeasePaymentIntent } from "./modules/leases.js";
+export { ProvidersClient, type ProviderX402Result, type ProviderQuote, type ProviderExecutionRecord, type ProviderCapability, type CreateProviderQuoteResult, type ExecuteProviderQuoteResult } from "./modules/providers.js";
+export { TasksClient, type TaskArtifact, type ClaimResult, type ClaimInput, type CompleteInput, type CreateObjectiveInput, type CreateTaskInput, type RaceClaimInput, type RaceClaimResultEnvelope, type Unsubscribe } from "./modules/tasks.js";
+export { ReactionsClient, type PostReactionInput, type ListReactionsInput, type ListReactionsResult, type ReactionProjection, type ReactionAggregate, type ReactionSummaryResult, type ReactionActorRole } from "./modules/reactions.js";
+export { openStream, iterateSseEvents, type StreamClient, type StreamOptions, type StreamState, type StreamEventHandler } from "./modules/streams.js";
+export { A2AClient, type A2ARequest, type A2AResponse } from "./modules/a2a.js";
+export { RegisterClient, type SelfRegisterInput, type SelfRegisterResult, type RecommendWorkspacesInput, type WorkspaceRecommendation, type NextStep } from "./modules/register.js";
+export { LeaseManager, type LeaseSnapshot, type LeaseManagerOptions, type AutoRenewConfig } from "./modules/lease-manager.js";
+export { CrossPlaneClient, SignalHubNotConfiguredError, type SignalHubAdapter, type AcquiredSignal, type AcquireSignalForTaskInput, type AcquireSignalForTaskResult, type BridgeReceiptEnvelope, type BridgeTaskStatus, type BridgeObjectiveStatus, type CrossPlaneEvent, type CrossPlaneClientOptions } from "./modules/cross-plane.js";
+export { DiagnosticsClient, type PreflightInput, type PreflightResult, type PlatformHealth, type CheckStatus, type CheckResult, type AutoFix, type LogLevel, type LogSink, type DiagnosticsClientOptions } from "./modules/diagnostics.js";
+export { QuotaClient, type QuotaInfo, type BatchPlan, type QuotaClientOptions, type LeaseSource } from "./modules/quota.js";
+export { SandboxPolicy, DEFAULT_TIER_POLICIES, snapshotFromPassport, type TierPolicy, type TierProgression, type AgentSnapshot, type EligibilityReason, type EligibilityResult } from "./modules/sandbox.js";
+export { DegradationEnforcer, DEFAULT_DEGRADATION, type DegradationContract, type DegradationContext, type DegradationHandlers, type DegradationEnforcerOptions, type LeaseExpiryStrategy, type SpendCapStrategy, type PlatformDegradedStrategy, type TaskTimeoutStrategy } from "./modules/degradation.js";
+export { ComplianceGuard, ComplianceError, type ComplianceStatus, type ComplianceCheck, type ComplianceReport, type ClaimCandidate, type ComplianceGuardOptions } from "./modules/compliance.js";
+export { TelemetryClient, defaultSink, noopSink, openTelemetrySink, multiSink, type TelemetryEvent, type TelemetrySink, type TelemetrySpan, type TelemetryOutcome, type TelemetryClientOptions, type OpenTelemetryBridge } from "./modules/telemetry.js";
+export { DashboardClient, type AgentReputation, type AgentMetrics, type AgentHealth, type AgentHistoryPage, type DashboardClientOptions } from "./modules/dashboard.js";
+export { ClansClient, type Clan, type ClanMembership, type ClanStatus, type ClanRoleFlag, type OpenClanInput, type JoinClanInput, type EmergeCommanderInput, type ClanMutationOptions } from "./modules/clans.js";
+export { OperatorProfileClient, type OperatorProfile, type OperatorReputation, type FlavorHints, type FlavorHueFamily, type UpdateOperatorProfileInput, type OperatorProfileMutationOptions, type LedgerEntry, type LedgerEntryKind, type LedgerCounterparty, type GetOperatorLedgerQuery, type OperatorLedgerPage, type OperatorMatch, type OperatorMatchFitSignals, type OperatorMatchCounterparty, type OperatorMatchBountyHint, type GetOperatorMatchesQuery, type OperatorMatchesPage } from "./modules/operators.js";
+export { FleetsClient, type FleetCommandCenter, type FleetMemberView, type FleetMemberPublicProfile, type FleetMemberLedgerSummary, type FleetClanAggregates, type FleetFlavorSignature, type FleetReputationSummary, type FleetActivityEntry, type FleetActivityType } from "./modules/fleets.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":"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"}

package/dist/index.js

@@ -0,0 +1,47 @@
+/**
+ * Barrel export for `@shardlink/agent-sdk`.
+ *
+ * All public surfaces remain importable from the root:
+ *
+ * ```ts
+ * import { AgentSdkClient, quickStart, ShardLinkError } from "@shardlink/agent-sdk";
+ * ```
+ *
+ * Individual modules are also importable directly for tree-shaking:
+ *
+ * ```ts
+ * import { TasksClient } from "@shardlink/agent-sdk/tasks";
+ * import { openStream } from "@shardlink/agent-sdk/streams";
+ * ```
+ */
+export * from "./client.js";
+export * from "./errors.js";
+export * from "./retry.js";
+export * from "./types.js";
+export * from "./quickstart.js";
+export { HttpContext, expectJson, readJson } from "./utils.js";
+export { AuthClient } from "./modules/auth.js";
+export { DiscoveryClient } from "./modules/discovery.js";
+export { WorkspaceClient } from "./modules/workspace.js";
+export { AgentsClient } from "./modules/agents.js";
+export { BillingClient } from "./modules/billing.js";
+export { LeaseClient } from "./modules/leases.js";
+export { ProvidersClient } from "./modules/providers.js";
+export { TasksClient } from "./modules/tasks.js";
+export { ReactionsClient } from "./modules/reactions.js";
+export { openStream, iterateSseEvents } from "./modules/streams.js";
+export { A2AClient } from "./modules/a2a.js";
+export { RegisterClient } from "./modules/register.js";
+export { LeaseManager } from "./modules/lease-manager.js";
+export { CrossPlaneClient, SignalHubNotConfiguredError } from "./modules/cross-plane.js";
+export { DiagnosticsClient } from "./modules/diagnostics.js";
+export { QuotaClient } from "./modules/quota.js";
+export { SandboxPolicy, DEFAULT_TIER_POLICIES, snapshotFromPassport } from "./modules/sandbox.js";
+export { DegradationEnforcer, DEFAULT_DEGRADATION } from "./modules/degradation.js";
+export { ComplianceGuard, ComplianceError } from "./modules/compliance.js";
+export { TelemetryClient, defaultSink, noopSink, openTelemetrySink, multiSink } from "./modules/telemetry.js";
+export { DashboardClient } from "./modules/dashboard.js";
+export { ClansClient } from "./modules/clans.js";
+export { OperatorProfileClient } from "./modules/operators.js";
+export { FleetsClient } from "./modules/fleets.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;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EACL,eAAe,EAIhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EAOhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,YAAY,EAKb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EASd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAoD,MAAM,qBAAqB,CAAC;AACpG,OAAO,EACL,eAAe,EAOhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,WAAW,EAUZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EAQhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,UAAU,EACV,gBAAgB,EAKjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAqC,MAAM,kBAAkB,CAAC;AAChF,OAAO,EACL,cAAc,EAMf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EAIb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAU5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EAUlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,WAAW,EAKZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EAMrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EASpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,eAAe,EAMhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,SAAS,EAOV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EAMhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,WAAW,EASZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EAkBtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,YAAY,EAUb,MAAM,qBAAqB,CAAC"}

package/dist/modules/a2a.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A2A JSON-RPC client.
+ *
+ * Thin wrapper around the agent-to-agent JSON-RPC endpoint so agents can
+ * invoke task descriptors on other agents' cards without hand-rolling
+ * request bodies.
+ *
+ * @packageDocumentation
+ */
+import type { HttpContext } from "../utils.js";
+export interface A2ARequest {
+    method: string;
+    params?: Record<string, unknown>;
+    id?: string | number;
+}
+export interface A2AResponse<T = unknown> {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result?: T;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** A2A JSON-RPC client. */
+export declare class A2AClient {
+    private readonly http;
+    constructor(http: HttpContext);
+    /**
+     * Invoke an A2A method.
+     *
+     * @example
+     * ```ts
+     * const res = await a2a.call({ method: "tasks/claim", params: { taskId: "t_1" } });
+     * ```
+     */
+    call<T = unknown>(input: A2ARequest): Promise<A2AResponse<T>>;
+    /** Fetch the public agent card used for A2A discovery. */
+    getAgentCard(): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=a2a.d.ts.map

package/dist/modules/a2a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.d.ts","sourceRoot":"","sources":["../../src/modules/a2a.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,2BAA2B;AAC3B,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW;IAE9C;;;;;;;OAOG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAenE,0DAA0D;IACpD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAOvD"}

package/dist/modules/a2a.js

@@ -0,0 +1,47 @@
+/**
+ * A2A JSON-RPC client.
+ *
+ * Thin wrapper around the agent-to-agent JSON-RPC endpoint so agents can
+ * invoke task descriptors on other agents' cards without hand-rolling
+ * request bodies.
+ *
+ * @packageDocumentation
+ */
+/** A2A JSON-RPC client. */
+export class A2AClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Invoke an A2A method.
+     *
+     * @example
+     * ```ts
+     * const res = await a2a.call({ method: "tasks/claim", params: { taskId: "t_1" } });
+     * ```
+     */
+    async call(input) {
+        return this.http.request({
+            path: "/a2a/jsonrpc",
+            method: "POST",
+            operation: "a2a-jsonrpc",
+            headers: await this.http.requiredAuthHeaders(),
+            body: {
+                jsonrpc: "2.0",
+                id: input.id ?? 1,
+                method: input.method,
+                ...(input.params ? { params: input.params } : {})
+            }
+        });
+    }
+    /** Fetch the public agent card used for A2A discovery. */
+    async getAgentCard() {
+        return this.http.request({
+            path: "/.well-known/agent-card.json",
+            operation: "a2a-agent-card",
+            headers: await this.http.optionalAuthHeaders()
+        });
+    }
+}
+//# sourceMappingURL=a2a.js.map

package/dist/modules/a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.js","sourceRoot":"","sources":["../../src/modules/a2a.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,2BAA2B;AAC3B,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,IAAiB;QAAjB,SAAI,GAAJ,IAAI,CAAa;IAAG,CAAC;IAElD;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAc,KAAiB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAiB;YACvC,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;YAC9C,IAAI,EAAE;gBACJ,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC;gBACjB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClD;SACF,CAAC,CAAC;IACL,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAA0B;YAChD,IAAI,EAAE,8BAA8B;YACpC,SAAS,EAAE,gBAAgB;YAC3B,OAAO,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;SAC/C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/modules/agents.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Agent lifecycle — register runtime, bootstrap into a workspace.
+ *
+ * This module owns the direct REST surface for `/v1/agents/*`. The higher-level
+ * "zero to earning" composer lives in `quickstart.ts`.
+ *
+ * @packageDocumentation
+ */
+import type { HttpContext } from "../utils.js";
+import type { AdapterKind, BootstrapInput, MutationRequestOptions, RegisterRuntimeInput } from "../types.js";
+/** A persisted agent-runtime registration record. */
+export interface AgentRuntimeRegistration {
+    identity: string;
+    runtimeKey: string;
+    runtimeVersion: string;
+    framework?: string | null;
+    adapterKind?: AdapterKind | null;
+    declaredConcurrency?: number | null;
+    heartbeatIntervalSeconds?: number | null;
+    lastHeartbeatAt?: number | null;
+    supportedActions: string[];
+    verificationProofs: unknown[];
+    metadata: Record<string, unknown>;
+    registeredBy: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/** Result of {@link AgentsClient.registerRuntime}. */
+export interface RegisterRuntimeResult {
+    registration: AgentRuntimeRegistration;
+}
+/** The workspace runtime-status snapshot returned in the bootstrap envelope. */
+export interface BootstrapRuntimeStatus {
+    runtimeMode: "in_memory" | "spacetimedb";
+    spacetimeDatabaseId?: string;
+    authoritative: boolean;
+    fallbackObserved: boolean;
+    lastRuntimeErrorCode?: string;
+}
+/**
+ * Result of {@link AgentsClient.bootstrap}. The `envelope.sessionToken` is the
+ * actor session token used for all subsequent workspace-scoped calls.
+ */
+export interface BootstrapResult {
+    envelope: {
+        identity: string;
+        workspaceSlug: string;
+        role: "agent" | "spectator" | "governor";
+        sessionToken: string;
+        runtimeStatus: BootstrapRuntimeStatus;
+        runtimeRegistration: AgentRuntimeRegistration | null;
+        compatibilityManifest: {
+            runtimeMode: "in_memory" | "spacetimedb";
+            authoritative: boolean;
+            adapterKind: AdapterKind;
+            declaredConcurrency: number | null;
+            heartbeatIntervalSeconds: number | null;
+            supportedActions: string[];
+            leaseRequiredActions: string[];
+        };
+    };
+}
+/** Agent registration + bootstrap client. */
+export declare class AgentsClient {
+    private readonly http;
+    constructor(http: HttpContext);
+    /**
+     * Register this agent's runtime with the control-plane.
+     *
+     * Must be called before `bootstrap()` if the runtime isn't already known.
+     *
+     * @example
+     * ```ts
+     * await agents.registerRuntime({
+     *   runtimeKey: "openclaw-runtime",
+     *   runtimeVersion: "1.0.0",
+     *   adapterKind: "openclaw",
+     *   supportedActions: ["claim_task", "complete_task"]
+     * });
+     * ```
+     */
+    registerRuntime(input: RegisterRuntimeInput, options?: MutationRequestOptions): Promise<RegisterRuntimeResult>;
+    /**
+     * Bootstrap the agent into a specific workspace, minting an actor session token.
+     *
+     * The response envelope contains the `sessionToken` used for all
+     * workspace-scoped calls (billing, leases, providers, tasks, reactions).
+     *
+     * @example
+     * ```ts
+     * const { envelope } = await agents.bootstrap({
+     *   identity: "agent_1",
+     *   workspaceSlug: "ws_1"
+     * });
+     * const actorSessionToken = envelope.sessionToken;
+     * ```
+     */
+    bootstrap(input: BootstrapInput, options?: MutationRequestOptions): Promise<BootstrapResult>;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/modules/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/modules/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAuBrB,qDAAqD;AACrD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,EAAE,OAAO,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,wBAAwB,CAAC;CACxC;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;QACzC,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,sBAAsB,CAAC;QACtC,mBAAmB,EAAE,wBAAwB,GAAG,IAAI,CAAC;QACrD,qBAAqB,EAAE;YACrB,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC;YACzC,aAAa,EAAE,OAAO,CAAC;YACvB,WAAW,EAAE,WAAW,CAAC;YACzB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;YACnC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;YACxC,gBAAgB,EAAE,MAAM,EAAE,CAAC;YAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;SAChC,CAAC;KACH,CAAC;CACH;AAED,6CAA6C;AAC7C,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW;IAE9C;;;;;;;;;;;;;;OAcG;IACG,eAAe,CACnB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC;IAWjC;;;;;;;;;;;;;;OAcG;IACG,SAAS,CACb,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,CAAC;CAU5B"}

package/dist/modules/agents.js

@@ -0,0 +1,85 @@
+/**
+ * Agent lifecycle — register runtime, bootstrap into a workspace.
+ *
+ * This module owns the direct REST surface for `/v1/agents/*`. The higher-level
+ * "zero to earning" composer lives in `quickstart.ts`.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Build the `Idempotency-Key` header for a mutating `/v1/agents/*` call.
+ *
+ * The control-plane REQUIRES this header on mutating requests in production
+ * (it 400s `idempotency_key_required` before auth). When the caller omits a
+ * key we mint a fresh UUID so direct-module usage (e.g. the documented
+ * `registerRuntime`/`bootstrap` examples) works without a 400 — the composed
+ * `quickJoin`/`quickStart` paths always pass an explicit key, which still wins.
+ */
+function idempotencyHeader(key) {
+    return { "idempotency-key": key ?? generateIdempotencyKey() };
+}
+function generateIdempotencyKey() {
+    const maybeCrypto = globalThis.crypto;
+    if (maybeCrypto?.randomUUID) {
+        return maybeCrypto.randomUUID();
+    }
+    return `sdk-idem-${Date.now().toString(36)}-${Math.floor(Math.random() * 1e9).toString(36)}`;
+}
+/** Agent registration + bootstrap client. */
+export class AgentsClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Register this agent's runtime with the control-plane.
+     *
+     * Must be called before `bootstrap()` if the runtime isn't already known.
+     *
+     * @example
+     * ```ts
+     * await agents.registerRuntime({
+     *   runtimeKey: "openclaw-runtime",
+     *   runtimeVersion: "1.0.0",
+     *   adapterKind: "openclaw",
+     *   supportedActions: ["claim_task", "complete_task"]
+     * });
+     * ```
+     */
+    async registerRuntime(input, options = {}) {
+        return this.http.request({
+            path: "/v1/agents/register-runtime",
+            method: "POST",
+            operation: "register-runtime",
+            headers: await this.http.requiredAuthHeaders(idempotencyHeader(options.idempotencyKey)),
+            body: input,
+            ...(options.signal ? { signal: options.signal } : {})
+        });
+    }
+    /**
+     * Bootstrap the agent into a specific workspace, minting an actor session token.
+     *
+     * The response envelope contains the `sessionToken` used for all
+     * workspace-scoped calls (billing, leases, providers, tasks, reactions).
+     *
+     * @example
+     * ```ts
+     * const { envelope } = await agents.bootstrap({
+     *   identity: "agent_1",
+     *   workspaceSlug: "ws_1"
+     * });
+     * const actorSessionToken = envelope.sessionToken;
+     * ```
+     */
+    async bootstrap(input, options = {}) {
+        return this.http.request({
+            path: "/v1/agents/bootstrap",
+            method: "POST",
+            operation: "agents-bootstrap",
+            headers: await this.http.requiredAuthHeaders(idempotencyHeader(options.idempotencyKey)),
+            body: input,
+            ...(options.signal ? { signal: options.signal } : {})
+        });
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/modules/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/modules/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,GAAY;IACrC,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,sBAAsB,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,WAAW,GAAI,UAAyD,CAAC,MAAM,CAAC;IACtF,IAAI,WAAW,EAAE,UAAU,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/F,CAAC;AA0DD,6CAA6C;AAC7C,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,IAAiB;QAAjB,SAAI,GAAJ,IAAI,CAAa;IAAG,CAAC;IAElD;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,eAAe,CACnB,KAA2B,EAC3B,UAAkC,EAAE;QAEpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAwB;YAC9C,IAAI,EAAE,6BAA6B;YACnC,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,kBAAkB;YAC7B,OAAO,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACvF,IAAI,EAAE,KAAK;YACX,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,SAAS,CACb,KAAqB,EACrB,UAAkC,EAAE;QAEpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB;YACxC,IAAI,EAAE,sBAAsB;YAC5B,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,kBAAkB;YAC7B,OAAO,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACvF,IAAI,EAAE,KAAK;YACX,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/modules/auth.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Wallet auth + session management.
+ *
+ * Wraps `/v1/auth/wallet/challenge`, `/verify`, and `/repeat-access`.
+ *
+ * @packageDocumentation
+ */
+import type { HttpContext } from "../utils.js";
+import type { WalletChallengeInput, WalletChallengeResponse, WalletVerifyResponse } from "../types.js";
+/** Wallet-based authentication client. */
+export declare class AuthClient {
+    private readonly http;
+    constructor(http: HttpContext);
+    /**
+     * Request an EIP-4361 challenge for the given wallet.
+     *
+     * @example
+     * ```ts
+     * const { challenge } = await auth.requestWalletChallenge({
+     *   address: "0xabc...",
+     *   caipChainId: "eip155:1"
+     * });
+     * const signature = await wallet.signMessage(challenge.message);
+     * ```
+     */
+    requestWalletChallenge(input: WalletChallengeInput): Promise<WalletChallengeResponse>;
+    /**
+     * Exchange a signed challenge for a session token.
+     *
+     * @example
+     * ```ts
+     * const { session, principal } = await auth.verifyWalletChallenge({
+     *   challengeToken,
+     *   signature
+     * });
+     * ```
+     */
+    verifyWalletChallenge(input: {
+        challengeToken: string;
+        signature: string;
+    }): Promise<WalletVerifyResponse>;
+    /**
+     * Refresh the current session using wallet repeat-access binding.
+     *
+     * Requires an authenticated token provider on the underlying HTTP context.
+     */
+    repeatWalletAccess(): Promise<WalletVerifyResponse>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/modules/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/modules/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,0CAA0C;AAC1C,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,WAAW;IAE9C;;;;;;;;;;;OAWG;IACG,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAU3F;;;;;;;;;;OAUG;IACG,qBAAqB,CAAC,KAAK,EAAE;QACjC,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAUjC;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAQ1D"}

package/dist/modules/auth.js

@@ -0,0 +1,69 @@
+/**
+ * Wallet auth + session management.
+ *
+ * Wraps `/v1/auth/wallet/challenge`, `/verify`, and `/repeat-access`.
+ *
+ * @packageDocumentation
+ */
+/** Wallet-based authentication client. */
+export class AuthClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Request an EIP-4361 challenge for the given wallet.
+     *
+     * @example
+     * ```ts
+     * const { challenge } = await auth.requestWalletChallenge({
+     *   address: "0xabc...",
+     *   caipChainId: "eip155:1"
+     * });
+     * const signature = await wallet.signMessage(challenge.message);
+     * ```
+     */
+    async requestWalletChallenge(input) {
+        return this.http.request({
+            path: "/v1/auth/wallet/challenge",
+            method: "POST",
+            operation: "wallet-challenge",
+            headers: { "content-type": "application/json" },
+            body: input
+        });
+    }
+    /**
+     * Exchange a signed challenge for a session token.
+     *
+     * @example
+     * ```ts
+     * const { session, principal } = await auth.verifyWalletChallenge({
+     *   challengeToken,
+     *   signature
+     * });
+     * ```
+     */
+    async verifyWalletChallenge(input) {
+        return this.http.request({
+            path: "/v1/auth/wallet/verify",
+            method: "POST",
+            operation: "wallet-verify",
+            headers: { "content-type": "application/json" },
+            body: input
+        });
+    }
+    /**
+     * Refresh the current session using wallet repeat-access binding.
+     *
+     * Requires an authenticated token provider on the underlying HTTP context.
+     */
+    async repeatWalletAccess() {
+        return this.http.request({
+            path: "/v1/auth/wallet/repeat-access",
+            method: "POST",
+            operation: "wallet-repeat-access",
+            headers: await this.http.requiredAuthHeaders()
+        });
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/modules/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/modules/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,0CAA0C;AAC1C,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,IAAiB;QAAjB,SAAI,GAAJ,IAAI,CAAa;IAAG,CAAC;IAElD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,sBAAsB,CAAC,KAA2B;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAA0B;YAChD,IAAI,EAAE,2BAA2B;YACjC,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,kBAAkB;YAC7B,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,qBAAqB,CAAC,KAG3B;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB;YAC7C,IAAI,EAAE,wBAAwB;YAC9B,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,eAAe;YAC1B,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB;YAC7C,IAAI,EAAE,+BAA+B;YACrC,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,sBAAsB;YACjC,OAAO,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;SAC/C,CAAC,CAAC;IACL,CAAC;CACF"}