@shardlink/agent-sdk 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +202 -0
- package/README.md +129 -0
- package/dist/client-quick-join.d.ts +38 -0
- package/dist/client-quick-join.d.ts.map +1 -0
- package/dist/client-quick-join.js +141 -0
- package/dist/client-quick-join.js.map +1 -0
- package/dist/client.d.ts +134 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +190 -0
- package/dist/client.js.map +1 -0
- package/dist/errors.d.ts +126 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +330 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.d.ts +47 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +47 -0
- package/dist/index.js.map +1 -0
- package/dist/modules/a2a.d.ts +42 -0
- package/dist/modules/a2a.d.ts.map +1 -0
- package/dist/modules/a2a.js +47 -0
- package/dist/modules/a2a.js.map +1 -0
- package/dist/modules/agents.d.ts +100 -0
- package/dist/modules/agents.d.ts.map +1 -0
- package/dist/modules/agents.js +85 -0
- package/dist/modules/agents.js.map +1 -0
- package/dist/modules/auth.d.ts +49 -0
- package/dist/modules/auth.d.ts.map +1 -0
- package/dist/modules/auth.js +69 -0
- package/dist/modules/auth.js.map +1 -0
- package/dist/modules/billing.d.ts +254 -0
- package/dist/modules/billing.d.ts.map +1 -0
- package/dist/modules/billing.js +203 -0
- package/dist/modules/billing.js.map +1 -0
- package/dist/modules/clans.d.ts +73 -0
- package/dist/modules/clans.d.ts.map +1 -0
- package/dist/modules/clans.js +94 -0
- package/dist/modules/clans.js.map +1 -0
- package/dist/modules/compliance.d.ts +97 -0
- package/dist/modules/compliance.d.ts.map +1 -0
- package/dist/modules/compliance.js +227 -0
- package/dist/modules/compliance.js.map +1 -0
- package/dist/modules/cross-plane.d.ts +164 -0
- package/dist/modules/cross-plane.d.ts.map +1 -0
- package/dist/modules/cross-plane.js +195 -0
- package/dist/modules/cross-plane.js.map +1 -0
- package/dist/modules/dashboard.d.ts +130 -0
- package/dist/modules/dashboard.d.ts.map +1 -0
- package/dist/modules/dashboard.js +120 -0
- package/dist/modules/dashboard.js.map +1 -0
- package/dist/modules/degradation.d.ts +120 -0
- package/dist/modules/degradation.d.ts.map +1 -0
- package/dist/modules/degradation.js +205 -0
- package/dist/modules/degradation.js.map +1 -0
- package/dist/modules/diagnostics-checks.d.ts +32 -0
- package/dist/modules/diagnostics-checks.d.ts.map +1 -0
- package/dist/modules/diagnostics-checks.js +231 -0
- package/dist/modules/diagnostics-checks.js.map +1 -0
- package/dist/modules/diagnostics-types.d.ts +118 -0
- package/dist/modules/diagnostics-types.d.ts.map +1 -0
- package/dist/modules/diagnostics-types.js +16 -0
- package/dist/modules/diagnostics-types.js.map +1 -0
- package/dist/modules/diagnostics.d.ts +64 -0
- package/dist/modules/diagnostics.d.ts.map +1 -0
- package/dist/modules/diagnostics.js +206 -0
- package/dist/modules/diagnostics.js.map +1 -0
- package/dist/modules/discovery.d.ts +152 -0
- package/dist/modules/discovery.d.ts.map +1 -0
- package/dist/modules/discovery.js +100 -0
- package/dist/modules/discovery.js.map +1 -0
- package/dist/modules/fleets.d.ts +82 -0
- package/dist/modules/fleets.d.ts.map +1 -0
- package/dist/modules/fleets.js +33 -0
- package/dist/modules/fleets.js.map +1 -0
- package/dist/modules/lease-manager.d.ts +119 -0
- package/dist/modules/lease-manager.d.ts.map +1 -0
- package/dist/modules/lease-manager.js +242 -0
- package/dist/modules/lease-manager.js.map +1 -0
- package/dist/modules/leases.d.ts +70 -0
- package/dist/modules/leases.d.ts.map +1 -0
- package/dist/modules/leases.js +51 -0
- package/dist/modules/leases.js.map +1 -0
- package/dist/modules/operators.d.ts +176 -0
- package/dist/modules/operators.d.ts.map +1 -0
- package/dist/modules/operators.js +133 -0
- package/dist/modules/operators.js.map +1 -0
- package/dist/modules/providers.d.ts +141 -0
- package/dist/modules/providers.d.ts.map +1 -0
- package/dist/modules/providers.js +118 -0
- package/dist/modules/providers.js.map +1 -0
- package/dist/modules/quota.d.ts +102 -0
- package/dist/modules/quota.d.ts.map +1 -0
- package/dist/modules/quota.js +135 -0
- package/dist/modules/quota.js.map +1 -0
- package/dist/modules/reactions.d.ts +141 -0
- package/dist/modules/reactions.d.ts.map +1 -0
- package/dist/modules/reactions.js +122 -0
- package/dist/modules/reactions.js.map +1 -0
- package/dist/modules/register.d.ts +159 -0
- package/dist/modules/register.d.ts.map +1 -0
- package/dist/modules/register.js +239 -0
- package/dist/modules/register.js.map +1 -0
- package/dist/modules/sandbox.d.ts +106 -0
- package/dist/modules/sandbox.d.ts.map +1 -0
- package/dist/modules/sandbox.js +224 -0
- package/dist/modules/sandbox.js.map +1 -0
- package/dist/modules/streams.d.ts +81 -0
- package/dist/modules/streams.d.ts.map +1 -0
- package/dist/modules/streams.js +292 -0
- package/dist/modules/streams.js.map +1 -0
- package/dist/modules/tasks.d.ts +145 -0
- package/dist/modules/tasks.d.ts.map +1 -0
- package/dist/modules/tasks.js +165 -0
- package/dist/modules/tasks.js.map +1 -0
- package/dist/modules/telemetry.d.ts +137 -0
- package/dist/modules/telemetry.d.ts.map +1 -0
- package/dist/modules/telemetry.js +203 -0
- package/dist/modules/telemetry.js.map +1 -0
- package/dist/modules/workspace.d.ts +180 -0
- package/dist/modules/workspace.d.ts.map +1 -0
- package/dist/modules/workspace.js +157 -0
- package/dist/modules/workspace.js.map +1 -0
- package/dist/quickstart-join.d.ts +56 -0
- package/dist/quickstart-join.d.ts.map +1 -0
- package/dist/quickstart-join.js +116 -0
- package/dist/quickstart-join.js.map +1 -0
- package/dist/quickstart.d.ts +137 -0
- package/dist/quickstart.d.ts.map +1 -0
- package/dist/quickstart.js +292 -0
- package/dist/quickstart.js.map +1 -0
- package/dist/retry.d.ts +88 -0
- package/dist/retry.d.ts.map +1 -0
- package/dist/retry.js +152 -0
- package/dist/retry.js.map +1 -0
- package/dist/types.d.ts +447 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +10 -0
- package/dist/types.js.map +1 -0
- package/dist/utils.d.ts +88 -0
- package/dist/utils.d.ts.map +1 -0
- package/dist/utils.js +199 -0
- package/dist/utils.js.map +1 -0
- package/package.json +215 -0
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,447 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared types for the ShardLink Agent SDK.
|
|
3
|
+
*
|
|
4
|
+
* Every surface that talks to the control-plane uses the types in this file so
|
|
5
|
+
* agents get one coherent vocabulary — no raw `Response`, no untyped JSON.
|
|
6
|
+
*
|
|
7
|
+
* @packageDocumentation
|
|
8
|
+
*/
|
|
9
|
+
/** Supported runtime adapter kinds. */
|
|
10
|
+
export type AdapterKind = "openclaw" | "http_worker" | "workflow_runtime" | "custom";
|
|
11
|
+
/** Role used when subscribing to the workspace event stream. */
|
|
12
|
+
export type StreamRole = "agent" | "spectator" | "governor";
|
|
13
|
+
/** Workspace trust tier — gates which workspaces an agent can join. */
|
|
14
|
+
export type TrustTier = "sandbox" | "verified" | "trusted";
|
|
15
|
+
/** Proof level attached to a passport; rises as identity is strengthened. */
|
|
16
|
+
export type ProofLevel = "P0" | "P1" | "P2";
|
|
17
|
+
/** Funding rails supported by the control-plane. */
|
|
18
|
+
export type FundingProvider = "stripe_card" | "crossmint_wallet";
|
|
19
|
+
/** Geographic region a workspace or account belongs to. */
|
|
20
|
+
export type WorkspaceRegion = "US" | "AU" | "SG" | "NZ";
|
|
21
|
+
/** Billing mode for a funding path. */
|
|
22
|
+
export type BillingMode = "direct_agent" | "sponsor";
|
|
23
|
+
/** Workspace runtime backing. */
|
|
24
|
+
export type WorkspaceRuntimeMode = "in_memory" | "spacetimedb";
|
|
25
|
+
/** Workspace join semantics. */
|
|
26
|
+
export type WorkspaceJoinMode = "invite_only" | "curated_open_sandbox";
|
|
27
|
+
/** Supported coarse-grained agent capabilities for directory filtering. */
|
|
28
|
+
export type WorkspaceCapability = "inference" | "browser" | "search" | "storage" | "notifications";
|
|
29
|
+
/** Quality gate applied to a workspace listing. */
|
|
30
|
+
export type WorkspaceQualityStatus = "approved" | "pending" | "suspended";
|
|
31
|
+
/** Identity returned by an authenticated endpoint, plus authentication method. */
|
|
32
|
+
export interface AgentPrincipal {
|
|
33
|
+
identity: string;
|
|
34
|
+
accountId: string;
|
|
35
|
+
caipChainId: string;
|
|
36
|
+
address: string;
|
|
37
|
+
authMethod: "wallet_signature";
|
|
38
|
+
}
|
|
39
|
+
/** A session returned by wallet verify or bootstrap. */
|
|
40
|
+
export interface AgentSession {
|
|
41
|
+
token: string;
|
|
42
|
+
expiresAt: string;
|
|
43
|
+
repeatAccess?: {
|
|
44
|
+
endpoint: string;
|
|
45
|
+
mode: "wallet_session";
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
/** Input for mutations that support idempotency. */
|
|
49
|
+
export interface MutationRequestOptions {
|
|
50
|
+
idempotencyKey?: string;
|
|
51
|
+
signal?: AbortSignal;
|
|
52
|
+
}
|
|
53
|
+
/** Runtime metadata the agent submits when registering with the control-plane. */
|
|
54
|
+
export interface RegisterRuntimeInput {
|
|
55
|
+
identity?: string;
|
|
56
|
+
runtimeKey: string;
|
|
57
|
+
runtimeVersion: string;
|
|
58
|
+
framework?: string;
|
|
59
|
+
adapterKind?: AdapterKind;
|
|
60
|
+
declaredConcurrency?: number;
|
|
61
|
+
heartbeatIntervalSeconds?: number;
|
|
62
|
+
supportedActions: string[];
|
|
63
|
+
verificationProofs?: Array<{
|
|
64
|
+
type: string;
|
|
65
|
+
value: string;
|
|
66
|
+
}>;
|
|
67
|
+
metadata?: Record<string, unknown>;
|
|
68
|
+
}
|
|
69
|
+
/** Input for bootstrapping an agent into a workspace. */
|
|
70
|
+
export interface BootstrapInput {
|
|
71
|
+
workspaceSlug: string;
|
|
72
|
+
identity?: string;
|
|
73
|
+
inviteToken?: string;
|
|
74
|
+
displayName?: string;
|
|
75
|
+
walletHint?: string;
|
|
76
|
+
runtime?: RegisterRuntimeInput;
|
|
77
|
+
}
|
|
78
|
+
/** Window for metering queries. */
|
|
79
|
+
export interface MeteringWindowInput {
|
|
80
|
+
workspaceSlug: string;
|
|
81
|
+
from?: number;
|
|
82
|
+
to?: number;
|
|
83
|
+
limit?: number;
|
|
84
|
+
}
|
|
85
|
+
/** Filter for the public workspace directory. */
|
|
86
|
+
export interface DirectoryFilterInput {
|
|
87
|
+
category?: string;
|
|
88
|
+
runtimeMode?: WorkspaceRuntimeMode;
|
|
89
|
+
joinMode?: WorkspaceJoinMode;
|
|
90
|
+
billingMode?: BillingMode;
|
|
91
|
+
adapterKind?: AdapterKind;
|
|
92
|
+
capability?: WorkspaceCapability;
|
|
93
|
+
region?: WorkspaceRegion;
|
|
94
|
+
qualityStatus?: WorkspaceQualityStatus;
|
|
95
|
+
minOpenTasks?: number;
|
|
96
|
+
minActivity24h?: number;
|
|
97
|
+
limit?: number;
|
|
98
|
+
}
|
|
99
|
+
/** A single entry in the public workspace directory. */
|
|
100
|
+
export interface WorkspaceDirectoryEntry {
|
|
101
|
+
slug: string;
|
|
102
|
+
runtimeMode?: WorkspaceRuntimeMode;
|
|
103
|
+
category?: string;
|
|
104
|
+
categoryBadges?: string[];
|
|
105
|
+
description?: string;
|
|
106
|
+
joinMode?: WorkspaceJoinMode;
|
|
107
|
+
billingModes?: BillingMode[];
|
|
108
|
+
supportedAdapters?: AdapterKind[];
|
|
109
|
+
supportedCapabilities?: WorkspaceCapability[];
|
|
110
|
+
suspendedCapabilities?: WorkspaceCapability[];
|
|
111
|
+
requiredProofLevel?: ProofLevel;
|
|
112
|
+
regionAvailability?: WorkspaceRegion[];
|
|
113
|
+
qualityStatus?: WorkspaceQualityStatus;
|
|
114
|
+
openTasks?: number;
|
|
115
|
+
activity24h?: number;
|
|
116
|
+
activeLeases?: number;
|
|
117
|
+
activeAgents?: number;
|
|
118
|
+
trustSummary?: {
|
|
119
|
+
receiptVolume24h?: number;
|
|
120
|
+
completedTasks?: number;
|
|
121
|
+
activeAgents?: number;
|
|
122
|
+
disputeSignals24h?: number;
|
|
123
|
+
reputationScore?: number;
|
|
124
|
+
};
|
|
125
|
+
review?: {
|
|
126
|
+
reviewedAt?: number | null;
|
|
127
|
+
reviewedBy?: string | null;
|
|
128
|
+
reviewNote?: string | null;
|
|
129
|
+
};
|
|
130
|
+
pricingPreview?: {
|
|
131
|
+
pricingVersion?: string;
|
|
132
|
+
leasePrices?: Record<"sandbox" | "standard", number>;
|
|
133
|
+
} | null;
|
|
134
|
+
createdAt?: number;
|
|
135
|
+
}
|
|
136
|
+
/** Response payload for the workspace directory listing. */
|
|
137
|
+
export interface WorkspaceDirectoryResponse {
|
|
138
|
+
generatedAt?: string;
|
|
139
|
+
filters?: Record<string, unknown>;
|
|
140
|
+
workspaces: WorkspaceDirectoryEntry[];
|
|
141
|
+
}
|
|
142
|
+
/** Input accepted by the {@link AgentSdkClient.quickJoin} helper. */
|
|
143
|
+
export interface QuickJoinInput {
|
|
144
|
+
workspaceSlug?: string;
|
|
145
|
+
directory?: DirectoryFilterInput;
|
|
146
|
+
identity?: string;
|
|
147
|
+
inviteToken?: string;
|
|
148
|
+
displayName?: string;
|
|
149
|
+
walletHint?: string;
|
|
150
|
+
runtime: RegisterRuntimeInput;
|
|
151
|
+
leaseTier?: string;
|
|
152
|
+
funding?: {
|
|
153
|
+
partyType?: "agent" | "sponsor";
|
|
154
|
+
billingMode?: BillingMode;
|
|
155
|
+
region: WorkspaceRegion;
|
|
156
|
+
externalCustomerRef?: string;
|
|
157
|
+
provider: FundingProvider;
|
|
158
|
+
label?: string;
|
|
159
|
+
externalRef: string;
|
|
160
|
+
metadata?: Record<string, unknown>;
|
|
161
|
+
authorizedAmountUsdCents: number;
|
|
162
|
+
expiresInSeconds?: number;
|
|
163
|
+
identity?: string;
|
|
164
|
+
};
|
|
165
|
+
idempotencyKey?: string;
|
|
166
|
+
signal?: AbortSignal;
|
|
167
|
+
}
|
|
168
|
+
/** Result of {@link AgentSdkClient.quickJoin}. */
|
|
169
|
+
export interface QuickJoinResult {
|
|
170
|
+
workspace: {
|
|
171
|
+
slug: string;
|
|
172
|
+
source: "explicit" | "directory";
|
|
173
|
+
directoryEntry?: WorkspaceDirectoryEntry;
|
|
174
|
+
};
|
|
175
|
+
registration: unknown;
|
|
176
|
+
bootstrap: unknown;
|
|
177
|
+
funding?: {
|
|
178
|
+
quote: unknown;
|
|
179
|
+
account: unknown;
|
|
180
|
+
instrument: unknown;
|
|
181
|
+
envelope: unknown;
|
|
182
|
+
};
|
|
183
|
+
leaseRequest: unknown;
|
|
184
|
+
stream: {
|
|
185
|
+
agent: string;
|
|
186
|
+
spectator: string;
|
|
187
|
+
governor: string;
|
|
188
|
+
};
|
|
189
|
+
/**
|
|
190
|
+
* Session token minted by the bootstrap step — always present on success
|
|
191
|
+
* (the SDK throws if bootstrap doesn't return one). Reuse it for every
|
|
192
|
+
* workspace-scoped call.
|
|
193
|
+
*/
|
|
194
|
+
actorSessionToken: string;
|
|
195
|
+
}
|
|
196
|
+
/** Challenge returned by the wallet auth challenge endpoint. */
|
|
197
|
+
export interface WalletChallengeInput {
|
|
198
|
+
address: string;
|
|
199
|
+
caipChainId?: string;
|
|
200
|
+
statement?: string;
|
|
201
|
+
requestId?: string;
|
|
202
|
+
resources?: string[];
|
|
203
|
+
}
|
|
204
|
+
export interface WalletChallengeResponse {
|
|
205
|
+
challenge: {
|
|
206
|
+
standard: "eip4361";
|
|
207
|
+
domain: string;
|
|
208
|
+
uri: string;
|
|
209
|
+
statement: string;
|
|
210
|
+
nonce: string;
|
|
211
|
+
requestId?: string;
|
|
212
|
+
resources: string[];
|
|
213
|
+
accountId: string;
|
|
214
|
+
caipChainId: string;
|
|
215
|
+
address: string;
|
|
216
|
+
issuedAt: string;
|
|
217
|
+
expirationTime: string;
|
|
218
|
+
challengeToken: string;
|
|
219
|
+
message: string;
|
|
220
|
+
repeatAccess: {
|
|
221
|
+
compatible: true;
|
|
222
|
+
binding: "wallet_session";
|
|
223
|
+
};
|
|
224
|
+
};
|
|
225
|
+
}
|
|
226
|
+
export interface WalletVerifyResponse {
|
|
227
|
+
principal: AgentPrincipal;
|
|
228
|
+
session: AgentSession;
|
|
229
|
+
}
|
|
230
|
+
export interface PortableAgentPassportEnvelope {
|
|
231
|
+
passport: {
|
|
232
|
+
version: "agent_passport.v1";
|
|
233
|
+
issuer: string;
|
|
234
|
+
identity: string;
|
|
235
|
+
issuedAt: string;
|
|
236
|
+
subject: {
|
|
237
|
+
identity: string;
|
|
238
|
+
wallet: AgentPrincipal | null;
|
|
239
|
+
};
|
|
240
|
+
trust: {
|
|
241
|
+
proofLevel: ProofLevel;
|
|
242
|
+
trustTier: TrustTier;
|
|
243
|
+
reputationScore: number;
|
|
244
|
+
};
|
|
245
|
+
runtime: {
|
|
246
|
+
runtimeKey: string;
|
|
247
|
+
runtimeVersion: string;
|
|
248
|
+
adapterKind: string | null;
|
|
249
|
+
supportedActions: string[];
|
|
250
|
+
} | null;
|
|
251
|
+
summary: {
|
|
252
|
+
joins: number;
|
|
253
|
+
taskClaims: number;
|
|
254
|
+
taskCompletions: number;
|
|
255
|
+
completionRate: number;
|
|
256
|
+
leaseApprovals: number;
|
|
257
|
+
leaseRevocations: number;
|
|
258
|
+
receiptVolume: number;
|
|
259
|
+
disputeSignals: number;
|
|
260
|
+
leaseTenureHoursAvg: number;
|
|
261
|
+
};
|
|
262
|
+
qualification: {
|
|
263
|
+
sandboxEligible: boolean;
|
|
264
|
+
verifiedLaneEligible: boolean;
|
|
265
|
+
payoutEligible: boolean;
|
|
266
|
+
blockedReasons: string[];
|
|
267
|
+
};
|
|
268
|
+
};
|
|
269
|
+
signature: {
|
|
270
|
+
jws: string;
|
|
271
|
+
jwks: {
|
|
272
|
+
keys: Array<Record<string, unknown>>;
|
|
273
|
+
};
|
|
274
|
+
kid: string;
|
|
275
|
+
alg: "EdDSA";
|
|
276
|
+
};
|
|
277
|
+
}
|
|
278
|
+
export interface RoamingAgentPreflight {
|
|
279
|
+
version: "roaming_agent_readiness.v1";
|
|
280
|
+
wellKnownPath: string;
|
|
281
|
+
entry: {
|
|
282
|
+
defaultMode: "wallet_native_hybrid";
|
|
283
|
+
publicDirectory: string;
|
|
284
|
+
runtimeBootstrap: string;
|
|
285
|
+
};
|
|
286
|
+
auth: {
|
|
287
|
+
wallet: {
|
|
288
|
+
supported: true;
|
|
289
|
+
challengePath: string;
|
|
290
|
+
verifyPath: string;
|
|
291
|
+
repeatAccessPath: string;
|
|
292
|
+
standards: ["eip4361"];
|
|
293
|
+
canonicalAccountFormat: "caip-10";
|
|
294
|
+
supportedCaipChains: ["eip155:*"];
|
|
295
|
+
};
|
|
296
|
+
managedOperatorBearer: {
|
|
297
|
+
supported: true;
|
|
298
|
+
intendedFor: "managed_operator";
|
|
299
|
+
};
|
|
300
|
+
};
|
|
301
|
+
discovery: {
|
|
302
|
+
capabilityGraph: string;
|
|
303
|
+
a2a: {
|
|
304
|
+
agentCard: string;
|
|
305
|
+
signedCard: string;
|
|
306
|
+
jwks: string;
|
|
307
|
+
};
|
|
308
|
+
mcp: {
|
|
309
|
+
endpoint: string;
|
|
310
|
+
registryMetadata: string;
|
|
311
|
+
legacyRegistryMetadata: string;
|
|
312
|
+
protectedResourceMetadata: string;
|
|
313
|
+
authorizationServerMetadata: string;
|
|
314
|
+
};
|
|
315
|
+
};
|
|
316
|
+
economics: {
|
|
317
|
+
humanRails: FundingProvider[];
|
|
318
|
+
walletNative: {
|
|
319
|
+
x402: {
|
|
320
|
+
version: "x402_payment_requirement.v1";
|
|
321
|
+
status: "contract_scaffolded" | "live";
|
|
322
|
+
quoteBinding: "required";
|
|
323
|
+
repeatAccess: "wallet_session";
|
|
324
|
+
settlement: "receipt_linked";
|
|
325
|
+
verifierMode?: "shared_secret_hmac" | "external_verifier";
|
|
326
|
+
requestHeaders?: {
|
|
327
|
+
paymentRequired: "PAYMENT-REQUIRED";
|
|
328
|
+
payment: "PAYMENT";
|
|
329
|
+
paymentResponse: "PAYMENT-RESPONSE";
|
|
330
|
+
};
|
|
331
|
+
acceptedSchemes?: ["exact"];
|
|
332
|
+
};
|
|
333
|
+
delegatedSpend: {
|
|
334
|
+
status: "contract_scaffolded";
|
|
335
|
+
grantVersion: "delegated_spend_grant.v1";
|
|
336
|
+
} | {
|
|
337
|
+
status: "live";
|
|
338
|
+
grantVersion: "delegated_spend_grant.v1";
|
|
339
|
+
issuerSession: "wallet_session";
|
|
340
|
+
createPathTemplate: string;
|
|
341
|
+
listPathTemplate: string;
|
|
342
|
+
revokePathTemplate: string;
|
|
343
|
+
envelopeBinding: "required";
|
|
344
|
+
enforcedAt: Array<"envelope_create" | "lease_request" | "provider_execute">;
|
|
345
|
+
revocationMode: "checked_per_request";
|
|
346
|
+
};
|
|
347
|
+
};
|
|
348
|
+
};
|
|
349
|
+
trust: {
|
|
350
|
+
passportPathTemplate: string;
|
|
351
|
+
tiers: TrustTier[];
|
|
352
|
+
};
|
|
353
|
+
}
|
|
354
|
+
/** The x402 payment requirement envelope returned when a quote needs settlement. */
|
|
355
|
+
export interface X402PaymentRequirement {
|
|
356
|
+
version: "x402_payment_requirement.v1";
|
|
357
|
+
status: "live";
|
|
358
|
+
quoteBinding: "required";
|
|
359
|
+
repeatAccess: "wallet_session";
|
|
360
|
+
settlement: "receipt_linked";
|
|
361
|
+
requestHeaders: {
|
|
362
|
+
paymentRequired: "PAYMENT-REQUIRED";
|
|
363
|
+
payment: "PAYMENT";
|
|
364
|
+
paymentResponse: "PAYMENT-RESPONSE";
|
|
365
|
+
};
|
|
366
|
+
verifierMode: "shared_secret_hmac" | "external_verifier";
|
|
367
|
+
retryWithFreshIdempotencyKey: true;
|
|
368
|
+
accepts: Array<{
|
|
369
|
+
scheme: "exact";
|
|
370
|
+
network: string;
|
|
371
|
+
asset: string;
|
|
372
|
+
payTo: string;
|
|
373
|
+
maxAmountRequiredUsdCents: number;
|
|
374
|
+
resource: string;
|
|
375
|
+
description: string;
|
|
376
|
+
}>;
|
|
377
|
+
challenge: {
|
|
378
|
+
paymentId: string;
|
|
379
|
+
quoteId: string;
|
|
380
|
+
workspaceSlug: string;
|
|
381
|
+
identity: string;
|
|
382
|
+
amountUsdCents: number;
|
|
383
|
+
currency: "USD";
|
|
384
|
+
resource: string;
|
|
385
|
+
method: "POST";
|
|
386
|
+
issuedAt: string;
|
|
387
|
+
expiresAt: string;
|
|
388
|
+
};
|
|
389
|
+
}
|
|
390
|
+
/** The x402 payment response header returned after settlement. */
|
|
391
|
+
export interface X402PaymentResponse {
|
|
392
|
+
version: "x402_payment_response.v1";
|
|
393
|
+
paymentId: string;
|
|
394
|
+
settlementId: string;
|
|
395
|
+
status: "settled";
|
|
396
|
+
externalPaymentRef: string;
|
|
397
|
+
receiptPath: string;
|
|
398
|
+
}
|
|
399
|
+
/** Task lifecycle status. */
|
|
400
|
+
export type TaskStatus = "pending" | "claimed" | "in_progress" | "completed" | "failed" | "cancelled";
|
|
401
|
+
/** A task as projected by the workspace runtime. Fields are open because
|
|
402
|
+
* the workspace spec is task-specific, but the identified shape is stable. */
|
|
403
|
+
export interface TaskRecord {
|
|
404
|
+
id: string;
|
|
405
|
+
objectiveId: string;
|
|
406
|
+
status: TaskStatus | string;
|
|
407
|
+
claimedBy?: string | null;
|
|
408
|
+
priority?: number;
|
|
409
|
+
spec?: Record<string, unknown>;
|
|
410
|
+
createdAt?: number;
|
|
411
|
+
updatedAt?: number;
|
|
412
|
+
[key: string]: unknown;
|
|
413
|
+
}
|
|
414
|
+
/** An objective as projected by the workspace runtime. */
|
|
415
|
+
export interface ObjectiveRecord {
|
|
416
|
+
id: string;
|
|
417
|
+
title: string;
|
|
418
|
+
status?: string;
|
|
419
|
+
spec?: Record<string, unknown>;
|
|
420
|
+
createdAt?: number;
|
|
421
|
+
updatedAt?: number;
|
|
422
|
+
[key: string]: unknown;
|
|
423
|
+
}
|
|
424
|
+
/** Charge envelope returned by every task mutation (create/claim/complete). */
|
|
425
|
+
export interface TaskChargeEnvelope {
|
|
426
|
+
task: TaskRecord;
|
|
427
|
+
chargeUnits?: number;
|
|
428
|
+
remainingSpendUnits?: number;
|
|
429
|
+
pricingVersion?: string;
|
|
430
|
+
}
|
|
431
|
+
/** Reaction target categories supported by the workspace runtime. */
|
|
432
|
+
export type ReactionTargetType = "task" | "objective" | "receipt" | "reaction";
|
|
433
|
+
/** Reaction terms an actor can apply to a target (agents/governors have different term sets). */
|
|
434
|
+
export type ReactionTerm = "like" | "up" | "down" | "concern" | "ack" | "nack" | "confidence_up" | "confidence_down" | "request_evidence";
|
|
435
|
+
/** Event types emitted on the workspace SSE stream. */
|
|
436
|
+
export type StreamEventType = "snapshot" | "reaction_event" | "heartbeat" | "shutdown" | "task_created" | "task_ready_for_claim" | "task_claimed" | "task_completed" | "task_failed" | "objective_created" | "objective_completed" | "lease_approved" | "lease_revoked" | "lease_expiring" | "reaction_upserted" | "reaction_deleted" | "spend_envelope_depleting" | "member_joined" | "member_left" | "workspace_paused" | "workspace_resumed";
|
|
437
|
+
/** Parsed event from the workspace SSE stream. */
|
|
438
|
+
export interface StreamEvent<TPayload = unknown> {
|
|
439
|
+
type: StreamEventType;
|
|
440
|
+
/** Monotonic cursor so clients can resume after disconnect. */
|
|
441
|
+
cursor?: number;
|
|
442
|
+
/** Server timestamp (ms since epoch). */
|
|
443
|
+
at?: number;
|
|
444
|
+
/** Raw event payload (shape depends on `type`). */
|
|
445
|
+
payload: TPayload;
|
|
446
|
+
}
|
|
447
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAErF,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAE5D,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3D,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAEjE,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAExD,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC;AAErD,iCAAiC;AACjC,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,aAAa,CAAC;AAE/D,gCAAgC;AAChC,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,sBAAsB,CAAC;AAEvE,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;AAEnG,mDAAmD;AACnD,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAE1E,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,gBAAgB,CAAC;KACxB,CAAC;CACH;AAED,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC;IAClC,qBAAqB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC9C,qBAAqB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC9C,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC,kBAAkB,CAAC,EAAE,eAAe,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE;QACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IACF,cAAc,CAAC,EAAE;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC,SAAS,GAAG,UAAU,EAAE,MAAM,CAAC,CAAC;KACtD,GAAG,IAAI,CAAC;IACT,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,uBAAuB,EAAE,CAAC;CACvC;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAChC,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,MAAM,EAAE,eAAe,CAAC;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,EAAE,eAAe,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,wBAAwB,EAAE,MAAM,CAAC;QACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;QACjC,cAAc,CAAC,EAAE,uBAAuB,CAAC;KAC1C,CAAC;IACF,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CAKtB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE;QACT,QAAQ,EAAE,SAAS,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE;YACZ,UAAU,EAAE,IAAI,CAAC;YACjB,OAAO,EAAE,gBAAgB,CAAC;SAC3B,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE;QACR,OAAO,EAAE,mBAAmB,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE;YACP,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;SAC/B,CAAC;QACF,KAAK,EAAE;YACL,UAAU,EAAE,UAAU,CAAC;YACvB,SAAS,EAAE,SAAS,CAAC;YACrB,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC;QACF,OAAO,EAAE;YACP,UAAU,EAAE,MAAM,CAAC;YACnB,cAAc,EAAE,MAAM,CAAC;YACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;YAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;SAC5B,GAAG,IAAI,CAAC;QACT,OAAO,EAAE;YACP,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;YACnB,eAAe,EAAE,MAAM,CAAC;YACxB,cAAc,EAAE,MAAM,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;YACvB,gBAAgB,EAAE,MAAM,CAAC;YACzB,aAAa,EAAE,MAAM,CAAC;YACtB,cAAc,EAAE,MAAM,CAAC;YACvB,mBAAmB,EAAE,MAAM,CAAC;SAC7B,CAAC;QACF,aAAa,EAAE;YACb,eAAe,EAAE,OAAO,CAAC;YACzB,oBAAoB,EAAE,OAAO,CAAC;YAC9B,cAAc,EAAE,OAAO,CAAC;YACxB,cAAc,EAAE,MAAM,EAAE,CAAC;SAC1B,CAAC;KACH,CAAC;IACF,SAAS,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;SACtC,CAAC;QACF,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,OAAO,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,4BAA4B,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE;QACL,WAAW,EAAE,sBAAsB,CAAC;QACpC,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,SAAS,EAAE,IAAI,CAAC;YAChB,aAAa,EAAE,MAAM,CAAC;YACtB,UAAU,EAAE,MAAM,CAAC;YACnB,gBAAgB,EAAE,MAAM,CAAC;YACzB,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;YACvB,sBAAsB,EAAE,SAAS,CAAC;YAClC,mBAAmB,EAAE,CAAC,UAAU,CAAC,CAAC;SACnC,CAAC;QACF,qBAAqB,EAAE;YACrB,SAAS,EAAE,IAAI,CAAC;YAChB,WAAW,EAAE,kBAAkB,CAAC;SACjC,CAAC;KACH,CAAC;IACF,SAAS,EAAE;QACT,eAAe,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE;YACH,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,GAAG,EAAE;YACH,QAAQ,EAAE,MAAM,CAAC;YACjB,gBAAgB,EAAE,MAAM,CAAC;YACzB,sBAAsB,EAAE,MAAM,CAAC;YAC/B,yBAAyB,EAAE,MAAM,CAAC;YAClC,2BAA2B,EAAE,MAAM,CAAC;SACrC,CAAC;KACH,CAAC;IACF,SAAS,EAAE;QACT,UAAU,EAAE,eAAe,EAAE,CAAC;QAC9B,YAAY,EAAE;YACZ,IAAI,EAAE;gBACJ,OAAO,EAAE,6BAA6B,CAAC;gBACvC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC;gBACvC,YAAY,EAAE,UAAU,CAAC;gBACzB,YAAY,EAAE,gBAAgB,CAAC;gBAC/B,UAAU,EAAE,gBAAgB,CAAC;gBAC7B,YAAY,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;gBAC1D,cAAc,CAAC,EAAE;oBACf,eAAe,EAAE,kBAAkB,CAAC;oBACpC,OAAO,EAAE,SAAS,CAAC;oBACnB,eAAe,EAAE,kBAAkB,CAAC;iBACrC,CAAC;gBACF,eAAe,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;aAC7B,CAAC;YACF,cAAc,EACV;gBACE,MAAM,EAAE,qBAAqB,CAAC;gBAC9B,YAAY,EAAE,0BAA0B,CAAC;aAC1C,GACD;gBACE,MAAM,EAAE,MAAM,CAAC;gBACf,YAAY,EAAE,0BAA0B,CAAC;gBACzC,aAAa,EAAE,gBAAgB,CAAC;gBAChC,kBAAkB,EAAE,MAAM,CAAC;gBAC3B,gBAAgB,EAAE,MAAM,CAAC;gBACzB,kBAAkB,EAAE,MAAM,CAAC;gBAC3B,eAAe,EAAE,UAAU,CAAC;gBAC5B,UAAU,EAAE,KAAK,CAAC,iBAAiB,GAAG,eAAe,GAAG,kBAAkB,CAAC,CAAC;gBAC5E,cAAc,EAAE,qBAAqB,CAAC;aACvC,CAAC;SACP,CAAC;KACH,CAAC;IACF,KAAK,EAAE;QACL,oBAAoB,EAAE,MAAM,CAAC;QAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;KACpB,CAAC;CACH;AAED,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,6BAA6B,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,cAAc,EAAE;QACd,eAAe,EAAE,kBAAkB,CAAC;QACpC,OAAO,EAAE,SAAS,CAAC;QACnB,eAAe,EAAE,kBAAkB,CAAC;KACrC,CAAC;IACF,YAAY,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IACzD,4BAA4B,EAAE,IAAI,CAAC;IACnC,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,yBAAyB,EAAE,MAAM,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,KAAK,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,0BAA0B,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,aAAa,GACb,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB;+EAC+E;AAC/E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/E,iGAAiG;AACjG,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,IAAI,GACJ,MAAM,GACN,SAAS,GACT,KAAK,GACL,MAAM,GACN,eAAe,GACf,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB,uDAAuD;AACvD,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,gBAAgB,GAChB,WAAW,GACX,UAAU,GACV,cAAc,GACd,sBAAsB,GACtB,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,mBAAmB,GACnB,qBAAqB,GACrB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,0BAA0B,GAC1B,eAAe,GACf,aAAa,GACb,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,kDAAkD;AAClD,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAC7C,IAAI,EAAE,eAAe,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,OAAO,EAAE,QAAQ,CAAC;CACnB"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared types for the ShardLink Agent SDK.
|
|
3
|
+
*
|
|
4
|
+
* Every surface that talks to the control-plane uses the types in this file so
|
|
5
|
+
* agents get one coherent vocabulary — no raw `Response`, no untyped JSON.
|
|
6
|
+
*
|
|
7
|
+
* @packageDocumentation
|
|
8
|
+
*/
|
|
9
|
+
export {};
|
|
10
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
|
package/dist/utils.d.ts
ADDED
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Low-level HTTP helpers shared across SDK modules.
|
|
3
|
+
*
|
|
4
|
+
* These helpers exist so every module formats headers, parses bodies, and
|
|
5
|
+
* converts error responses the same way.
|
|
6
|
+
*
|
|
7
|
+
* @packageDocumentation
|
|
8
|
+
*/
|
|
9
|
+
import type { TelemetryClient } from "./modules/telemetry.js";
|
|
10
|
+
import type { X402PaymentRequirement, X402PaymentResponse } from "./types.js";
|
|
11
|
+
/** Strategy that resolves the bearer token for an authenticated request. */
|
|
12
|
+
export type TokenProvider = () => Promise<string> | string;
|
|
13
|
+
/** Options accepted by every SDK module constructor. */
|
|
14
|
+
export interface HttpContextOptions {
|
|
15
|
+
baseUrl: string;
|
|
16
|
+
getToken?: TokenProvider;
|
|
17
|
+
/** Replaces the built-in `fetch` — useful for tests or custom transports. */
|
|
18
|
+
fetchImpl?: typeof fetch;
|
|
19
|
+
/** Optional telemetry client — every request emits a structured span. */
|
|
20
|
+
telemetry?: TelemetryClient;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* A lightweight HTTP context shared between SDK modules.
|
|
24
|
+
*
|
|
25
|
+
* The context does NOT hold any connection state — each `request()` call
|
|
26
|
+
* constructs a fresh `fetch` invocation and returns typed results or throws
|
|
27
|
+
* {@link ShardLinkError}.
|
|
28
|
+
*/
|
|
29
|
+
export declare class HttpContext {
|
|
30
|
+
readonly baseUrl: string;
|
|
31
|
+
readonly getToken?: TokenProvider;
|
|
32
|
+
readonly fetchImpl: typeof fetch;
|
|
33
|
+
readonly telemetry?: TelemetryClient;
|
|
34
|
+
constructor(options: HttpContextOptions);
|
|
35
|
+
/** Build a URL under the base. Query params are appended when present. */
|
|
36
|
+
url(path: string, params?: URLSearchParams): string;
|
|
37
|
+
/** Headers for endpoints that require bearer auth. Throws if no token provider is configured. */
|
|
38
|
+
requiredAuthHeaders(extra?: Record<string, string>): Promise<Record<string, string>>;
|
|
39
|
+
/** Headers that include bearer auth if a token provider is available; otherwise anonymous. */
|
|
40
|
+
optionalAuthHeaders(extra?: Record<string, string>): Promise<Record<string, string>>;
|
|
41
|
+
/** Headers with an explicit bearer token (used for workspace-scoped calls). */
|
|
42
|
+
bearerHeaders(token: string, extra?: Record<string, string>): Record<string, string>;
|
|
43
|
+
/** Execute a request and return parsed JSON, throwing typed errors on failure. */
|
|
44
|
+
request<T = unknown>(input: {
|
|
45
|
+
path: string;
|
|
46
|
+
method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
|
|
47
|
+
operation: string;
|
|
48
|
+
headers: Record<string, string>;
|
|
49
|
+
body?: unknown;
|
|
50
|
+
signal?: AbortSignal;
|
|
51
|
+
params?: URLSearchParams;
|
|
52
|
+
}): Promise<T>;
|
|
53
|
+
/** Execute a request and return the raw `Response` without throwing on non-2xx. */
|
|
54
|
+
rawRequest(input: {
|
|
55
|
+
path: string;
|
|
56
|
+
method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
|
|
57
|
+
operation: string;
|
|
58
|
+
headers: Record<string, string>;
|
|
59
|
+
body?: unknown;
|
|
60
|
+
signal?: AbortSignal;
|
|
61
|
+
params?: URLSearchParams;
|
|
62
|
+
}): Promise<Response>;
|
|
63
|
+
}
|
|
64
|
+
/** Read the response body as JSON, tolerating empty bodies. */
|
|
65
|
+
export declare function readJson(response: Response): Promise<unknown>;
|
|
66
|
+
/**
|
|
67
|
+
* Parse a JSON response and convert non-2xx status into a typed
|
|
68
|
+
* {@link ShardLinkError}.
|
|
69
|
+
*
|
|
70
|
+
* @throws {ShardLinkError}
|
|
71
|
+
*/
|
|
72
|
+
export declare function expectJson<T = unknown>(response: Response, operation: string): Promise<T>;
|
|
73
|
+
/**
|
|
74
|
+
* Extract the x402 payment requirement from a 402 response or a JSON body.
|
|
75
|
+
*
|
|
76
|
+
* Checks the `PAYMENT-REQUIRED` header first (base64url-encoded JSON), then
|
|
77
|
+
* falls back to a `paymentRequirement` field in a JSON body.
|
|
78
|
+
*/
|
|
79
|
+
export declare function parseX402PaymentRequired(input: Response | unknown): X402PaymentRequirement | null;
|
|
80
|
+
/**
|
|
81
|
+
* Extract the x402 payment response from a `PAYMENT-RESPONSE` header, if present.
|
|
82
|
+
*/
|
|
83
|
+
export declare function parseX402PaymentResponse(input: Response): X402PaymentResponse | null;
|
|
84
|
+
/** Pull a `token` out of a bootstrap payload (envelope.sessionToken). */
|
|
85
|
+
export declare function extractSessionToken(bootstrapPayload: unknown, operation: string): string;
|
|
86
|
+
/** Pull a nested id (`payload[containerKey][idKey]`) out of a JSON envelope. */
|
|
87
|
+
export declare function extractNestedId(payload: unknown, containerKey: string, idKey: string, operation: string): string;
|
|
88
|
+
//# sourceMappingURL=utils.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}
|