@vorim/sdk 3.23.0 → 4.0.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/CHANGELOG.md +23 -0
- package/dist/index.cjs +212 -14
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +195 -16
- package/dist/index.d.ts +195 -16
- package/dist/index.js +211 -14
- package/dist/index.js.map +1 -1
- package/dist/integrations/anthropic.d.cts +1 -1
- package/dist/integrations/anthropic.d.ts +1 -1
- package/dist/integrations/ap2.d.cts +1 -1
- package/dist/integrations/ap2.d.ts +1 -1
- package/dist/integrations/aws-iam.d.cts +1 -1
- package/dist/integrations/aws-iam.d.ts +1 -1
- package/dist/integrations/bank-rails.d.cts +1 -1
- package/dist/integrations/bank-rails.d.ts +1 -1
- package/dist/integrations/circle.d.cts +1 -1
- package/dist/integrations/circle.d.ts +1 -1
- package/dist/integrations/cloudflare.d.cts +1 -1
- package/dist/integrations/cloudflare.d.ts +1 -1
- package/dist/integrations/coinbase-cdp.d.cts +1 -1
- package/dist/integrations/coinbase-cdp.d.ts +1 -1
- package/dist/integrations/commerce-agents.d.cts +1 -1
- package/dist/integrations/commerce-agents.d.ts +1 -1
- package/dist/integrations/crewai.d.cts +1 -1
- package/dist/integrations/crewai.d.ts +1 -1
- package/dist/integrations/entra.d.cts +1 -1
- package/dist/integrations/entra.d.ts +1 -1
- package/dist/integrations/fhir.d.cts +1 -1
- package/dist/integrations/fhir.d.ts +1 -1
- package/dist/integrations/grok.d.cts +1 -1
- package/dist/integrations/grok.d.ts +1 -1
- package/dist/integrations/guidewire.d.cts +1 -1
- package/dist/integrations/guidewire.d.ts +1 -1
- package/dist/integrations/hermes.d.cts +1 -1
- package/dist/integrations/hermes.d.ts +1 -1
- package/dist/integrations/jira.d.cts +1 -1
- package/dist/integrations/jira.d.ts +1 -1
- package/dist/integrations/langchain.d.cts +1 -1
- package/dist/integrations/langchain.d.ts +1 -1
- package/dist/integrations/langgraph.d.cts +1 -1
- package/dist/integrations/langgraph.d.ts +1 -1
- package/dist/integrations/legal.d.cts +1 -1
- package/dist/integrations/legal.d.ts +1 -1
- package/dist/integrations/life-sciences.d.cts +1 -1
- package/dist/integrations/life-sciences.d.ts +1 -1
- package/dist/integrations/linear.d.cts +1 -1
- package/dist/integrations/linear.d.ts +1 -1
- package/dist/integrations/lithic.d.cts +1 -1
- package/dist/integrations/lithic.d.ts +1 -1
- package/dist/integrations/llamaindex.d.cts +1 -1
- package/dist/integrations/llamaindex.d.ts +1 -1
- package/dist/integrations/marqeta.d.cts +1 -1
- package/dist/integrations/marqeta.d.ts +1 -1
- package/dist/integrations/modern-treasury.d.cts +1 -1
- package/dist/integrations/modern-treasury.d.ts +1 -1
- package/dist/integrations/muse.d.cts +1 -1
- package/dist/integrations/muse.d.ts +1 -1
- package/dist/integrations/nekuda.d.cts +1 -1
- package/dist/integrations/nekuda.d.ts +1 -1
- package/dist/integrations/okta.d.cts +1 -1
- package/dist/integrations/okta.d.ts +1 -1
- package/dist/integrations/openai.d.cts +1 -1
- package/dist/integrations/openai.d.ts +1 -1
- package/dist/integrations/openrouter.d.cts +1 -1
- package/dist/integrations/openrouter.d.ts +1 -1
- package/dist/integrations/paypal-agent.d.cts +1 -1
- package/dist/integrations/paypal-agent.d.ts +1 -1
- package/dist/integrations/perplexity.d.cts +1 -1
- package/dist/integrations/perplexity.d.ts +1 -1
- package/dist/integrations/plaid.d.cts +1 -1
- package/dist/integrations/plaid.d.ts +1 -1
- package/dist/integrations/ramp.d.cts +1 -1
- package/dist/integrations/ramp.d.ts +1 -1
- package/dist/integrations/shopify.d.cts +1 -1
- package/dist/integrations/shopify.d.ts +1 -1
- package/dist/integrations/siem.d.cts +1 -1
- package/dist/integrations/siem.d.ts +1 -1
- package/dist/integrations/skyfire.d.cts +1 -1
- package/dist/integrations/skyfire.d.ts +1 -1
- package/dist/integrations/stripe-acp.d.cts +1 -1
- package/dist/integrations/stripe-acp.d.ts +1 -1
- package/dist/integrations/stripe-issuing.d.cts +1 -1
- package/dist/integrations/stripe-issuing.d.ts +1 -1
- package/dist/integrations/truanon.d.cts +1 -1
- package/dist/integrations/truanon.d.ts +1 -1
- package/dist/integrations/typesafe.d.cts +1 -1
- package/dist/integrations/typesafe.d.ts +1 -1
- package/dist/integrations/ucp.d.cts +1 -1
- package/dist/integrations/ucp.d.ts +1 -1
- package/dist/integrations/vercel-ai.d.cts +1 -1
- package/dist/integrations/vercel-ai.d.ts +1 -1
- package/dist/integrations/x402.d.cts +1 -1
- package/dist/integrations/x402.d.ts +1 -1
- package/dist/{types-BrDQAJdl.d.cts → types-DphtTyIC.d.cts} +72 -3
- package/dist/{types-BrDQAJdl.d.ts → types-DphtTyIC.d.ts} +72 -3
- package/package.json +1 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { VorimSDK, ReplayInputs } from '../index.cjs';
|
|
2
|
-
import { P as PermissionScope } from '../types-
|
|
2
|
+
import { P as PermissionScope } from '../types-DphtTyIC.cjs';
|
|
3
3
|
import { E as EscalationPolicy, T as TransportFailurePolicy } from '../_runtime-gate-DOJUKJBu.cjs';
|
|
4
4
|
import '@vorim/shared-types';
|
|
5
5
|
import '../httpSignatures.cjs';
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { VorimSDK, ReplayInputs } from '../index.js';
|
|
2
|
-
import { P as PermissionScope } from '../types-
|
|
2
|
+
import { P as PermissionScope } from '../types-DphtTyIC.js';
|
|
3
3
|
import { E as EscalationPolicy, T as TransportFailurePolicy } from '../_runtime-gate-DOJUKJBu.js';
|
|
4
4
|
import '@vorim/shared-types';
|
|
5
5
|
import '../httpSignatures.js';
|
|
@@ -1,4 +1,29 @@
|
|
|
1
1
|
type AgentStatus = 'pending' | 'active' | 'suspended' | 'revoked' | 'expired';
|
|
2
|
+
/**
|
|
3
|
+
* What suspending (or revoking) an agent would touch: every agent reachable
|
|
4
|
+
* through its active identity delegations. From GET /agents/:id/suspend-preview.
|
|
5
|
+
*/
|
|
6
|
+
interface SuspendPreview {
|
|
7
|
+
root: {
|
|
8
|
+
agent_id: string;
|
|
9
|
+
name: string;
|
|
10
|
+
status: string;
|
|
11
|
+
};
|
|
12
|
+
descendants: Array<{
|
|
13
|
+
id: string;
|
|
14
|
+
agent_id: string;
|
|
15
|
+
name: string;
|
|
16
|
+
status: string;
|
|
17
|
+
depth: number;
|
|
18
|
+
}>;
|
|
19
|
+
/** Descendants currently active, which a cascading suspend would stop. */
|
|
20
|
+
will_suspend: number;
|
|
21
|
+
already_suspended: number;
|
|
22
|
+
/** Pending escalations across the root and every descendant. */
|
|
23
|
+
open_escalations: number;
|
|
24
|
+
/** Active identity-delegation links inside the subtree (revoke cuts them). */
|
|
25
|
+
active_delegations: number;
|
|
26
|
+
}
|
|
2
27
|
interface Agent {
|
|
3
28
|
id: string;
|
|
4
29
|
agent_id: string;
|
|
@@ -11,12 +36,34 @@ interface Agent {
|
|
|
11
36
|
trust_score: number;
|
|
12
37
|
capabilities: string[];
|
|
13
38
|
metadata: Record<string, unknown>;
|
|
39
|
+
/**
|
|
40
|
+
* Server-minted swarm this agent belongs to, or null for a standalone
|
|
41
|
+
* agent. Minted on a root at its first delegation or ephemeral spawn and
|
|
42
|
+
* inherited by members; nothing in a request can set it. Swarm-scoped
|
|
43
|
+
* budgets, behaviour windows and cascading suspend key on it.
|
|
44
|
+
*/
|
|
45
|
+
swarm_id?: string | null;
|
|
14
46
|
expires_at?: string;
|
|
15
47
|
created_at: string;
|
|
16
48
|
updated_at: string;
|
|
17
49
|
revoked_at?: string;
|
|
18
50
|
revoked_by?: string;
|
|
19
51
|
}
|
|
52
|
+
/** From GET /agents/:id/swarm. */
|
|
53
|
+
interface SwarmView {
|
|
54
|
+
swarm_id: string | null;
|
|
55
|
+
members: Array<{
|
|
56
|
+
agent_id: string;
|
|
57
|
+
name: string;
|
|
58
|
+
status: string;
|
|
59
|
+
expires_at: string | null;
|
|
60
|
+
/** The member it joined the swarm under; null on the root. */
|
|
61
|
+
parent_agent_id: string | null;
|
|
62
|
+
is_ephemeral?: boolean;
|
|
63
|
+
/** metadata.class = 'guardian': judges escalations assigned to the swarm's guardians. */
|
|
64
|
+
is_guardian?: boolean;
|
|
65
|
+
}>;
|
|
66
|
+
}
|
|
20
67
|
interface AgentRegistrationInput {
|
|
21
68
|
name: string;
|
|
22
69
|
description?: string;
|
|
@@ -85,6 +132,16 @@ interface AuditEventInput {
|
|
|
85
132
|
delegator_agent_id?: string;
|
|
86
133
|
delegation_chain_id?: string;
|
|
87
134
|
delegation_depth?: number;
|
|
135
|
+
/**
|
|
136
|
+
* The OpenTelemetry trace context of the span that performed the action,
|
|
137
|
+
* correlation only: joins this signed event to your trace. `trace_id` (32
|
|
138
|
+
* hex) and `span_id` (16 hex) are stored and returned with the event (a v1
|
|
139
|
+
* signature covers them). A W3C `traceparent` header value is folded into
|
|
140
|
+
* the two ids before signing and never sent as such.
|
|
141
|
+
*/
|
|
142
|
+
trace_id?: string;
|
|
143
|
+
span_id?: string;
|
|
144
|
+
traceparent?: string;
|
|
88
145
|
/**
|
|
89
146
|
* Runtime-control linkage. When this action was gated through
|
|
90
147
|
* {@link VorimSDK.beforeAction} before being performed, pass the
|
|
@@ -254,8 +311,18 @@ interface BeforeActionInput {
|
|
|
254
311
|
* estimate before the LLM call (e.g. prompt tokens + max_tokens).
|
|
255
312
|
*/
|
|
256
313
|
estimatedTokens?: number;
|
|
314
|
+
/**
|
|
315
|
+
* The OpenTelemetry trace context of the span asking for this action,
|
|
316
|
+
* correlation only: Vorim stores it on the decision and its OTLP connector
|
|
317
|
+
* parents the decision's span under yours. Either the two ids (32 and 16
|
|
318
|
+
* hex) or a W3C `traceparent` header value.
|
|
319
|
+
*/
|
|
320
|
+
traceId?: string;
|
|
321
|
+
spanId?: string;
|
|
322
|
+
traceparent?: string;
|
|
257
323
|
}
|
|
258
|
-
|
|
324
|
+
/** 'agent' and 'swarm' keys are server-asserted; 'workflow' is a caller label. */
|
|
325
|
+
type BudgetScope = 'agent' | 'workflow' | 'swarm';
|
|
259
326
|
type BudgetEnforcement = 'hard' | 'soft';
|
|
260
327
|
/** A configured rolling token budget for an agent or workflow. */
|
|
261
328
|
interface TokenBudget {
|
|
@@ -337,6 +404,8 @@ interface RuntimeDecision {
|
|
|
337
404
|
/** True when the engine fell back (timeout/error/unreachable). */
|
|
338
405
|
isFallback: boolean;
|
|
339
406
|
policyVersion: number;
|
|
407
|
+
/** The acting agent's server-minted swarm at decision time, or null. */
|
|
408
|
+
swarmId: string | null;
|
|
340
409
|
/**
|
|
341
410
|
* The human verdict on an escalation, once resolved by an operator:
|
|
342
411
|
* `'approved'`, `'denied'`, or `null` if not (yet) an escalation outcome.
|
|
@@ -345,7 +414,7 @@ interface RuntimeDecision {
|
|
|
345
414
|
* (`approved` → `'allow'`, `denied` → `'deny'`) so the normal verdict
|
|
346
415
|
* checks work — this field is the raw resolution for callers who want it.
|
|
347
416
|
*/
|
|
348
|
-
escalationResolution: 'approved' | 'denied' | null;
|
|
417
|
+
escalationResolution: 'approved' | 'denied' | 'timed_out' | null;
|
|
349
418
|
/**
|
|
350
419
|
* The signed approval, when this decision is an escalation a human
|
|
351
420
|
* APPROVED. `null` on everything else — including a denial, and including
|
|
@@ -425,4 +494,4 @@ interface CapabilityProfile {
|
|
|
425
494
|
alreadyLeastPrivilege: boolean;
|
|
426
495
|
}
|
|
427
496
|
|
|
428
|
-
export type { AgentRegistrationResult as A, BeforeActionInput as B, CapabilityProfile as C, DelegationLinkClaims as D, PermissionScope as P, RuntimeDecision as R,
|
|
497
|
+
export type { AgentRegistrationResult as A, BeforeActionInput as B, CapabilityProfile as C, DelegationLinkClaims as D, PermissionScope as P, RuntimeDecision as R, SuspendPreview as S, TrustRecord as T, WorkflowProvenanceGraph as W, AgentRegistrationInput as a, Agent as b, PermissionCheckResult as c, AgentDelegationRecord as d, SharedMemoryWriteInput as e, SharedMemoryEntry as f, SharedMemoryListResult as g, TokenBudgetInput as h, TokenBudget as i, BudgetSpend as j, AuditEventInput as k, SwarmView as l, AgentStatus as m, ApprovalAttestation as n, AuditEventType as o, AuditResult as p, BudgetEnforcement as q, BudgetScope as r, DecisionVerdict as s, WorkflowGraphEdge as t, WorkflowGraphEvent as u, WorkflowGraphNode as v };
|
|
@@ -1,4 +1,29 @@
|
|
|
1
1
|
type AgentStatus = 'pending' | 'active' | 'suspended' | 'revoked' | 'expired';
|
|
2
|
+
/**
|
|
3
|
+
* What suspending (or revoking) an agent would touch: every agent reachable
|
|
4
|
+
* through its active identity delegations. From GET /agents/:id/suspend-preview.
|
|
5
|
+
*/
|
|
6
|
+
interface SuspendPreview {
|
|
7
|
+
root: {
|
|
8
|
+
agent_id: string;
|
|
9
|
+
name: string;
|
|
10
|
+
status: string;
|
|
11
|
+
};
|
|
12
|
+
descendants: Array<{
|
|
13
|
+
id: string;
|
|
14
|
+
agent_id: string;
|
|
15
|
+
name: string;
|
|
16
|
+
status: string;
|
|
17
|
+
depth: number;
|
|
18
|
+
}>;
|
|
19
|
+
/** Descendants currently active, which a cascading suspend would stop. */
|
|
20
|
+
will_suspend: number;
|
|
21
|
+
already_suspended: number;
|
|
22
|
+
/** Pending escalations across the root and every descendant. */
|
|
23
|
+
open_escalations: number;
|
|
24
|
+
/** Active identity-delegation links inside the subtree (revoke cuts them). */
|
|
25
|
+
active_delegations: number;
|
|
26
|
+
}
|
|
2
27
|
interface Agent {
|
|
3
28
|
id: string;
|
|
4
29
|
agent_id: string;
|
|
@@ -11,12 +36,34 @@ interface Agent {
|
|
|
11
36
|
trust_score: number;
|
|
12
37
|
capabilities: string[];
|
|
13
38
|
metadata: Record<string, unknown>;
|
|
39
|
+
/**
|
|
40
|
+
* Server-minted swarm this agent belongs to, or null for a standalone
|
|
41
|
+
* agent. Minted on a root at its first delegation or ephemeral spawn and
|
|
42
|
+
* inherited by members; nothing in a request can set it. Swarm-scoped
|
|
43
|
+
* budgets, behaviour windows and cascading suspend key on it.
|
|
44
|
+
*/
|
|
45
|
+
swarm_id?: string | null;
|
|
14
46
|
expires_at?: string;
|
|
15
47
|
created_at: string;
|
|
16
48
|
updated_at: string;
|
|
17
49
|
revoked_at?: string;
|
|
18
50
|
revoked_by?: string;
|
|
19
51
|
}
|
|
52
|
+
/** From GET /agents/:id/swarm. */
|
|
53
|
+
interface SwarmView {
|
|
54
|
+
swarm_id: string | null;
|
|
55
|
+
members: Array<{
|
|
56
|
+
agent_id: string;
|
|
57
|
+
name: string;
|
|
58
|
+
status: string;
|
|
59
|
+
expires_at: string | null;
|
|
60
|
+
/** The member it joined the swarm under; null on the root. */
|
|
61
|
+
parent_agent_id: string | null;
|
|
62
|
+
is_ephemeral?: boolean;
|
|
63
|
+
/** metadata.class = 'guardian': judges escalations assigned to the swarm's guardians. */
|
|
64
|
+
is_guardian?: boolean;
|
|
65
|
+
}>;
|
|
66
|
+
}
|
|
20
67
|
interface AgentRegistrationInput {
|
|
21
68
|
name: string;
|
|
22
69
|
description?: string;
|
|
@@ -85,6 +132,16 @@ interface AuditEventInput {
|
|
|
85
132
|
delegator_agent_id?: string;
|
|
86
133
|
delegation_chain_id?: string;
|
|
87
134
|
delegation_depth?: number;
|
|
135
|
+
/**
|
|
136
|
+
* The OpenTelemetry trace context of the span that performed the action,
|
|
137
|
+
* correlation only: joins this signed event to your trace. `trace_id` (32
|
|
138
|
+
* hex) and `span_id` (16 hex) are stored and returned with the event (a v1
|
|
139
|
+
* signature covers them). A W3C `traceparent` header value is folded into
|
|
140
|
+
* the two ids before signing and never sent as such.
|
|
141
|
+
*/
|
|
142
|
+
trace_id?: string;
|
|
143
|
+
span_id?: string;
|
|
144
|
+
traceparent?: string;
|
|
88
145
|
/**
|
|
89
146
|
* Runtime-control linkage. When this action was gated through
|
|
90
147
|
* {@link VorimSDK.beforeAction} before being performed, pass the
|
|
@@ -254,8 +311,18 @@ interface BeforeActionInput {
|
|
|
254
311
|
* estimate before the LLM call (e.g. prompt tokens + max_tokens).
|
|
255
312
|
*/
|
|
256
313
|
estimatedTokens?: number;
|
|
314
|
+
/**
|
|
315
|
+
* The OpenTelemetry trace context of the span asking for this action,
|
|
316
|
+
* correlation only: Vorim stores it on the decision and its OTLP connector
|
|
317
|
+
* parents the decision's span under yours. Either the two ids (32 and 16
|
|
318
|
+
* hex) or a W3C `traceparent` header value.
|
|
319
|
+
*/
|
|
320
|
+
traceId?: string;
|
|
321
|
+
spanId?: string;
|
|
322
|
+
traceparent?: string;
|
|
257
323
|
}
|
|
258
|
-
|
|
324
|
+
/** 'agent' and 'swarm' keys are server-asserted; 'workflow' is a caller label. */
|
|
325
|
+
type BudgetScope = 'agent' | 'workflow' | 'swarm';
|
|
259
326
|
type BudgetEnforcement = 'hard' | 'soft';
|
|
260
327
|
/** A configured rolling token budget for an agent or workflow. */
|
|
261
328
|
interface TokenBudget {
|
|
@@ -337,6 +404,8 @@ interface RuntimeDecision {
|
|
|
337
404
|
/** True when the engine fell back (timeout/error/unreachable). */
|
|
338
405
|
isFallback: boolean;
|
|
339
406
|
policyVersion: number;
|
|
407
|
+
/** The acting agent's server-minted swarm at decision time, or null. */
|
|
408
|
+
swarmId: string | null;
|
|
340
409
|
/**
|
|
341
410
|
* The human verdict on an escalation, once resolved by an operator:
|
|
342
411
|
* `'approved'`, `'denied'`, or `null` if not (yet) an escalation outcome.
|
|
@@ -345,7 +414,7 @@ interface RuntimeDecision {
|
|
|
345
414
|
* (`approved` → `'allow'`, `denied` → `'deny'`) so the normal verdict
|
|
346
415
|
* checks work — this field is the raw resolution for callers who want it.
|
|
347
416
|
*/
|
|
348
|
-
escalationResolution: 'approved' | 'denied' | null;
|
|
417
|
+
escalationResolution: 'approved' | 'denied' | 'timed_out' | null;
|
|
349
418
|
/**
|
|
350
419
|
* The signed approval, when this decision is an escalation a human
|
|
351
420
|
* APPROVED. `null` on everything else — including a denial, and including
|
|
@@ -425,4 +494,4 @@ interface CapabilityProfile {
|
|
|
425
494
|
alreadyLeastPrivilege: boolean;
|
|
426
495
|
}
|
|
427
496
|
|
|
428
|
-
export type { AgentRegistrationResult as A, BeforeActionInput as B, CapabilityProfile as C, DelegationLinkClaims as D, PermissionScope as P, RuntimeDecision as R,
|
|
497
|
+
export type { AgentRegistrationResult as A, BeforeActionInput as B, CapabilityProfile as C, DelegationLinkClaims as D, PermissionScope as P, RuntimeDecision as R, SuspendPreview as S, TrustRecord as T, WorkflowProvenanceGraph as W, AgentRegistrationInput as a, Agent as b, PermissionCheckResult as c, AgentDelegationRecord as d, SharedMemoryWriteInput as e, SharedMemoryEntry as f, SharedMemoryListResult as g, TokenBudgetInput as h, TokenBudget as i, BudgetSpend as j, AuditEventInput as k, SwarmView as l, AgentStatus as m, ApprovalAttestation as n, AuditEventType as o, AuditResult as p, BudgetEnforcement as q, BudgetScope as r, DecisionVerdict as s, WorkflowGraphEdge as t, WorkflowGraphEvent as u, WorkflowGraphNode as v };
|