@odingard/guardian-sdk 0.1.0 → 0.2.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.
Files changed (50) hide show
  1. package/README.md +252 -17
  2. package/dist/contracts.js +9865 -0
  3. package/dist/index.js +12976 -1787
  4. package/dist/public-catalog.v1.json +6915 -0
  5. package/dist-dts/catalog.d.ts +14 -0
  6. package/dist-dts/client.d.ts +51 -1
  7. package/dist-dts/contracts/action-pack.d.ts +464 -0
  8. package/dist-dts/contracts/action-registry.d.ts +91 -1
  9. package/dist-dts/contracts/action.d.ts +1408 -17
  10. package/dist-dts/contracts/agent-state.d.ts +386 -0
  11. package/dist-dts/contracts/approval.d.ts +224 -5
  12. package/dist-dts/contracts/assurance.d.ts +60 -0
  13. package/dist-dts/contracts/authority-graph.d.ts +294 -0
  14. package/dist-dts/contracts/authority-state.d.ts +17 -2
  15. package/dist-dts/contracts/authority.d.ts +31 -5
  16. package/dist-dts/contracts/billing.d.ts +32 -0
  17. package/dist-dts/contracts/calendar.d.ts +6 -6
  18. package/dist-dts/contracts/denial.d.ts +648 -0
  19. package/dist-dts/contracts/evidence.d.ts +73 -16
  20. package/dist-dts/contracts/execution.d.ts +449 -55
  21. package/dist-dts/contracts/identifiers.d.ts +16 -0
  22. package/dist-dts/contracts/index.d.ts +22 -0
  23. package/dist-dts/contracts/intent.d.ts +335 -0
  24. package/dist-dts/contracts/lineage.d.ts +218 -0
  25. package/dist-dts/contracts/local.d.ts +101 -0
  26. package/dist-dts/contracts/multi-principal.d.ts +292 -0
  27. package/dist-dts/contracts/multiparty.d.ts +169 -0
  28. package/dist-dts/contracts/obligation.d.ts +196 -0
  29. package/dist-dts/contracts/plan.d.ts +67 -0
  30. package/dist-dts/contracts/policy-simulation.d.ts +681 -0
  31. package/dist-dts/contracts/prerequisite.d.ts +147 -0
  32. package/dist-dts/contracts/protected-data.d.ts +67 -0
  33. package/dist-dts/contracts/receipt.d.ts +3126 -0
  34. package/dist-dts/contracts/resource-claims.d.ts +146 -0
  35. package/dist-dts/contracts/runtime.d.ts +111 -0
  36. package/dist-dts/contracts/safety-envelope.d.ts +287 -0
  37. package/dist-dts/contracts/sequence.d.ts +132 -0
  38. package/dist-dts/contracts/sources.d.ts +191 -0
  39. package/dist-dts/contracts/tools.d.ts +50 -5
  40. package/dist-dts/contracts/transaction.d.ts +360 -0
  41. package/dist-dts/contracts-entry.d.ts +1 -0
  42. package/dist-dts/embedded.d.ts +58 -0
  43. package/dist-dts/evidence/evidence.d.ts +25 -0
  44. package/dist-dts/evidence/receipt.d.ts +61 -0
  45. package/dist-dts/index.d.ts +5 -1
  46. package/dist-dts/lifecycle.d.ts +25 -0
  47. package/dist-dts/proposal.d.ts +16 -0
  48. package/dist-dts/receipts.d.ts +37 -0
  49. package/package.json +12 -6
  50. package/dist-dts/__tests__/client.test.d.ts +0 -1
@@ -19,10 +19,13 @@ export declare const AuthorityStateSnapshotSchema: z.ZodObject<{
19
19
  revoked: "revoked";
20
20
  }>;
21
21
  allowedInterfaces: z.ZodPipe<z.ZodArray<z.ZodEnum<{
22
- internal: "internal";
23
22
  mcp: "mcp";
24
23
  rest: "rest";
25
- }>>, z.ZodTransform<("internal" | "mcp" | "rest")[], ("internal" | "mcp" | "rest")[]>>;
24
+ internal: "internal";
25
+ }>>, z.ZodTransform<("mcp" | "rest" | "internal")[], ("mcp" | "rest" | "internal")[]>>;
26
+ boundRuntime: z.ZodOptional<z.ZodString>;
27
+ boundModel: z.ZodOptional<z.ZodString>;
28
+ parentAgentId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "AgentId", "out">>;
26
29
  }, z.core.$strict>;
27
30
  policy: z.ZodObject<{
28
31
  id: z.core.$ZodBranded<z.ZodString, "PolicyId", "out">;
@@ -69,6 +72,18 @@ export declare const AuthorityStateSnapshotSchema: z.ZodObject<{
69
72
  revokedAtEpochMs: z.ZodNumber;
70
73
  reasonCode: z.ZodString;
71
74
  }, z.core.$strict>>;
75
+ pauses: z.ZodDefault<z.ZodArray<z.ZodObject<{
76
+ id: z.core.$ZodBranded<z.ZodString, "PauseId", "out">;
77
+ scope: z.ZodEnum<{
78
+ agent: "agent";
79
+ principal: "principal";
80
+ grant: "grant";
81
+ connection: "connection";
82
+ }>;
83
+ agentId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "AgentId", "out">>;
84
+ grantIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.core.$ZodBranded<z.ZodString, "GrantId", "out">>, z.ZodTransform<(string & z.core.$brand<"GrantId">)[], (string & z.core.$brand<"GrantId">)[]>>>;
85
+ adapterIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.core.$ZodBranded<z.ZodString, "AdapterId", "out">>, z.ZodTransform<(string & z.core.$brand<"AdapterId">)[], (string & z.core.$brand<"AdapterId">)[]>>>;
86
+ }, z.core.$strict>>>;
72
87
  allowedAdapterIds: z.ZodArray<z.core.$ZodBranded<z.ZodString, "AdapterId", "out">>;
73
88
  budgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
74
89
  id: z.core.$ZodBranded<z.ZodString, "BudgetId", "out">;
@@ -12,9 +12,9 @@ export declare const ActionTypeSchema: z.core.$ZodBranded<z.ZodString, "ActionTy
12
12
  export declare const ResourceRefSchema: z.core.$ZodBranded<z.ZodString, "ResourceRef", "out">;
13
13
  export declare const EpochMillisecondsSchema: z.ZodNumber;
14
14
  export declare const AgentInterfaceSchema: z.ZodEnum<{
15
- internal: "internal";
16
15
  mcp: "mcp";
17
16
  rest: "rest";
17
+ internal: "internal";
18
18
  }>;
19
19
  export declare const PrincipalSchema: z.ZodObject<{
20
20
  id: z.core.$ZodBranded<z.ZodString, "PrincipalId", "out">;
@@ -52,10 +52,13 @@ export declare const AgentIdentitySchema: z.ZodObject<{
52
52
  revoked: "revoked";
53
53
  }>;
54
54
  allowedInterfaces: z.ZodPipe<z.ZodArray<z.ZodEnum<{
55
- internal: "internal";
56
55
  mcp: "mcp";
57
56
  rest: "rest";
58
- }>>, z.ZodTransform<("internal" | "mcp" | "rest")[], ("internal" | "mcp" | "rest")[]>>;
57
+ internal: "internal";
58
+ }>>, z.ZodTransform<("mcp" | "rest" | "internal")[], ("mcp" | "rest" | "internal")[]>>;
59
+ boundRuntime: z.ZodOptional<z.ZodString>;
60
+ boundModel: z.ZodOptional<z.ZodString>;
61
+ parentAgentId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "AgentId", "out">>;
59
62
  }, z.core.$strict>;
60
63
  export declare const AuthorityConstraintsSchema: z.ZodObject<{
61
64
  actions: z.ZodPipe<z.ZodArray<z.core.$ZodBranded<z.ZodString, "ActionType", "out">>, z.ZodTransform<(string & z.core.$brand<"ActionType">)[], (string & z.core.$brand<"ActionType">)[]>>;
@@ -119,9 +122,9 @@ export declare const AuthorityRequestSchema: z.ZodObject<{
119
122
  action: z.core.$ZodBranded<z.ZodString, "ActionType", "out">;
120
123
  resource: z.core.$ZodBranded<z.ZodString, "ResourceRef", "out">;
121
124
  interface: z.ZodEnum<{
122
- internal: "internal";
123
125
  mcp: "mcp";
124
126
  rest: "rest";
127
+ internal: "internal";
125
128
  }>;
126
129
  requestedAdapterId: z.core.$ZodBranded<z.ZodString, "AdapterId", "out">;
127
130
  valueCents: z.ZodOptional<z.ZodNumber>;
@@ -132,6 +135,8 @@ export declare const AuthorityRequestSchema: z.ZodObject<{
132
135
  merchantCategory: z.ZodOptional<z.ZodString>;
133
136
  recurring: z.ZodOptional<z.ZodBoolean>;
134
137
  taskId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "TaskId", "out">>;
138
+ intentId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "IntentId", "out">>;
139
+ planId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "PlanId", "out">>;
135
140
  }, z.core.$strict>;
136
141
  export declare const DenyReasonCodeSchema: z.ZodEnum<{
137
142
  MALFORMED_INPUT: "MALFORMED_INPUT";
@@ -143,6 +148,7 @@ export declare const DenyReasonCodeSchema: z.ZodEnum<{
143
148
  AGENT_MISMATCH: "AGENT_MISMATCH";
144
149
  AGENT_NOT_ACTIVE: "AGENT_NOT_ACTIVE";
145
150
  INTERFACE_NOT_ALLOWED: "INTERFACE_NOT_ALLOWED";
151
+ AUTHORITY_PAUSED: "AUTHORITY_PAUSED";
146
152
  AUTHORITY_CHAIN_MISSING: "AUTHORITY_CHAIN_MISSING";
147
153
  DUPLICATE_GRANT_ID: "DUPLICATE_GRANT_ID";
148
154
  GRANT_TENANT_MISMATCH: "GRANT_TENANT_MISMATCH";
@@ -170,7 +176,7 @@ export declare const DenyReasonCodeSchema: z.ZodEnum<{
170
176
  BUDGET_EXCEEDED: "BUDGET_EXCEEDED";
171
177
  TRANSACTION_LIMIT_EXCEEDED: "TRANSACTION_LIMIT_EXCEEDED";
172
178
  }>;
173
- export declare const DENY_PRECEDENCE: readonly ["MALFORMED_INPUT", "TENANT_MISMATCH", "PRINCIPAL_MISMATCH", "PRINCIPAL_NOT_ACTIVE", "AGENT_TENANT_MISMATCH", "AGENT_OWNER_MISMATCH", "AGENT_MISMATCH", "AGENT_NOT_ACTIVE", "INTERFACE_NOT_ALLOWED", "AUTHORITY_CHAIN_MISSING", "DUPLICATE_GRANT_ID", "GRANT_TENANT_MISMATCH", "GRANT_PRINCIPAL_MISMATCH", "GRANT_AGENT_MISMATCH", "GRANT_REVOKED", "GRANT_NOT_ACTIVE", "GRANT_NOT_YET_VALID", "GRANT_EXPIRED", "INVALID_PARENT_LINK", "DELEGATION_NOT_ALLOWED", "AUTHORITY_AMPLIFICATION", "ACTION_NOT_ALLOWED", "RESOURCE_NOT_ALLOWED", "ADAPTER_NOT_ALLOWED", "VALUE_LIMIT_EXCEEDED", "USE_LIMIT_EXCEEDED", "MERCHANT_NOT_ALLOWED", "CATEGORY_NOT_ALLOWED", "RECURRENCE_NOT_ALLOWED", "BUDGET_NOT_FOUND", "BUDGET_SCOPE_MISMATCH", "BUDGET_NOT_ACTIVE", "BUDGET_EXPIRED", "BUDGET_EXCEEDED", "TRANSACTION_LIMIT_EXCEEDED"];
179
+ export declare const DENY_PRECEDENCE: readonly ["MALFORMED_INPUT", "TENANT_MISMATCH", "PRINCIPAL_MISMATCH", "PRINCIPAL_NOT_ACTIVE", "AGENT_TENANT_MISMATCH", "AGENT_OWNER_MISMATCH", "AGENT_MISMATCH", "AGENT_NOT_ACTIVE", "INTERFACE_NOT_ALLOWED", "AUTHORITY_PAUSED", "AUTHORITY_CHAIN_MISSING", "DUPLICATE_GRANT_ID", "GRANT_TENANT_MISMATCH", "GRANT_PRINCIPAL_MISMATCH", "GRANT_AGENT_MISMATCH", "GRANT_REVOKED", "GRANT_NOT_ACTIVE", "GRANT_NOT_YET_VALID", "GRANT_EXPIRED", "INVALID_PARENT_LINK", "DELEGATION_NOT_ALLOWED", "AUTHORITY_AMPLIFICATION", "ACTION_NOT_ALLOWED", "RESOURCE_NOT_ALLOWED", "ADAPTER_NOT_ALLOWED", "VALUE_LIMIT_EXCEEDED", "USE_LIMIT_EXCEEDED", "MERCHANT_NOT_ALLOWED", "CATEGORY_NOT_ALLOWED", "RECURRENCE_NOT_ALLOWED", "BUDGET_NOT_FOUND", "BUDGET_SCOPE_MISMATCH", "BUDGET_NOT_ACTIVE", "BUDGET_EXPIRED", "BUDGET_EXCEEDED", "TRANSACTION_LIMIT_EXCEEDED"];
174
180
  export declare const PolicyReferenceSchema: z.ZodObject<{
175
181
  id: z.core.$ZodBranded<z.ZodString, "PolicyId", "out">;
176
182
  version: z.ZodNumber;
@@ -244,6 +250,7 @@ export declare const AuthorityDecisionSchema: z.ZodDiscriminatedUnion<[z.ZodObje
244
250
  AGENT_MISMATCH: "AGENT_MISMATCH";
245
251
  AGENT_NOT_ACTIVE: "AGENT_NOT_ACTIVE";
246
252
  INTERFACE_NOT_ALLOWED: "INTERFACE_NOT_ALLOWED";
253
+ AUTHORITY_PAUSED: "AUTHORITY_PAUSED";
247
254
  AUTHORITY_CHAIN_MISSING: "AUTHORITY_CHAIN_MISSING";
248
255
  DUPLICATE_GRANT_ID: "DUPLICATE_GRANT_ID";
249
256
  GRANT_TENANT_MISMATCH: "GRANT_TENANT_MISMATCH";
@@ -294,6 +301,24 @@ export declare const RevocationSchema: z.ZodObject<{
294
301
  revokedAtEpochMs: z.ZodNumber;
295
302
  reasonCode: z.ZodString;
296
303
  }, z.core.$strict>;
304
+ /**
305
+ * WO-010 — a scoped authority suspension recorded in authority state. The
306
+ * control plane resolves each pause into the identifiers the kernel checks
307
+ * (grant ids as emitted on the chain, adapter ids for connection scope), so
308
+ * the kernel needs no persistence knowledge to fail closed (K15).
309
+ */
310
+ export declare const AuthorityPauseSchema: z.ZodObject<{
311
+ id: z.core.$ZodBranded<z.ZodString, "PauseId", "out">;
312
+ scope: z.ZodEnum<{
313
+ agent: "agent";
314
+ principal: "principal";
315
+ grant: "grant";
316
+ connection: "connection";
317
+ }>;
318
+ agentId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "AgentId", "out">>;
319
+ grantIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.core.$ZodBranded<z.ZodString, "GrantId", "out">>, z.ZodTransform<(string & z.core.$brand<"GrantId">)[], (string & z.core.$brand<"GrantId">)[]>>>;
320
+ adapterIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.core.$ZodBranded<z.ZodString, "AdapterId", "out">>, z.ZodTransform<(string & z.core.$brand<"AdapterId">)[], (string & z.core.$brand<"AdapterId">)[]>>>;
321
+ }, z.core.$strict>;
297
322
  export type ActionType = z.infer<typeof ActionTypeSchema>;
298
323
  export type ResourceRef = z.infer<typeof ResourceRefSchema>;
299
324
  export type Principal = z.infer<typeof PrincipalSchema>;
@@ -305,6 +330,7 @@ export type AuthorityRequest = z.infer<typeof AuthorityRequestSchema>;
305
330
  export type AuthorityDecision = z.infer<typeof AuthorityDecisionSchema>;
306
331
  export type DenyReasonCode = z.infer<typeof DenyReasonCodeSchema>;
307
332
  export type Revocation = z.infer<typeof RevocationSchema>;
333
+ export type AuthorityPause = z.infer<typeof AuthorityPauseSchema>;
308
334
  export type PolicyReference = z.infer<typeof PolicyReferenceSchema>;
309
335
  export type DecisionBinding = z.infer<typeof DecisionBindingSchema>;
310
336
  export type RecurrencePolicy = z.infer<typeof RecurrencePolicySchema>;
@@ -0,0 +1,32 @@
1
+ import { z } from "zod";
2
+ export declare const BillingPlanIdSchema: z.ZodEnum<{
3
+ family: "family";
4
+ free: "free";
5
+ personal: "personal";
6
+ developer: "developer";
7
+ pilot: "pilot";
8
+ }>;
9
+ export type BillingPlanId = z.infer<typeof BillingPlanIdSchema>;
10
+ export declare const CheckoutIntervalSchema: z.ZodEnum<{
11
+ month: "month";
12
+ year: "year";
13
+ }>;
14
+ export type CheckoutInterval = z.infer<typeof CheckoutIntervalSchema>;
15
+ export type PlanLimits = Readonly<{
16
+ connections: number;
17
+ agents: number;
18
+ protectedActionsPerMonth: number;
19
+ }>;
20
+ export declare const PLAN_LIMITS: Record<BillingPlanId, PlanLimits>;
21
+ export declare const PURCHASABLE_PLANS: readonly ["personal", "family", "developer"];
22
+ export type PurchasablePlan = (typeof PURCHASABLE_PLANS)[number];
23
+ export type PlanPricing = Readonly<{
24
+ displayName: string;
25
+ monthlyUsd: number | null;
26
+ annualUsd: number | null;
27
+ usageMetered: boolean;
28
+ tagline: string;
29
+ }>;
30
+ export declare const PLAN_PRICING: Record<BillingPlanId, PlanPricing>;
31
+ export declare function purchasableIntervals(plan: BillingPlanId): readonly CheckoutInterval[];
32
+ export declare function formatPlanPrice(plan: BillingPlanId, interval: CheckoutInterval): string;
@@ -33,9 +33,9 @@ export declare const CalendarUpdateParametersV1Schema: z.ZodObject<{
33
33
  timeZone: z.ZodOptional<z.ZodString>;
34
34
  }, z.core.$strict>>;
35
35
  sendUpdates: z.ZodOptional<z.ZodEnum<{
36
+ none: "none";
36
37
  all: "all";
37
38
  externalOnly: "externalOnly";
38
- none: "none";
39
39
  }>>;
40
40
  }, z.core.$strict>;
41
41
  export declare const CalendarCancelParametersV1Schema: z.ZodObject<{
@@ -44,9 +44,9 @@ export declare const CalendarCancelParametersV1Schema: z.ZodObject<{
44
44
  schema: z.ZodLiteral<"odingard.guardian.calendar.cancel.v1">;
45
45
  eventId: z.ZodString;
46
46
  sendUpdates: z.ZodOptional<z.ZodEnum<{
47
+ none: "none";
47
48
  all: "all";
48
49
  externalOnly: "externalOnly";
49
- none: "none";
50
50
  }>>;
51
51
  }, z.core.$strict>;
52
52
  export declare const CalendarInviteParametersV1Schema: z.ZodObject<{
@@ -59,9 +59,9 @@ export declare const CalendarInviteParametersV1Schema: z.ZodObject<{
59
59
  optional: z.ZodOptional<z.ZodBoolean>;
60
60
  }, z.core.$strict>>;
61
61
  sendUpdates: z.ZodOptional<z.ZodEnum<{
62
+ none: "none";
62
63
  all: "all";
63
64
  externalOnly: "externalOnly";
64
- none: "none";
65
65
  }>>;
66
66
  }, z.core.$strict>;
67
67
  export declare const CalendarParametersV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -97,9 +97,9 @@ export declare const CalendarParametersV1Schema: z.ZodDiscriminatedUnion<[z.ZodO
97
97
  timeZone: z.ZodOptional<z.ZodString>;
98
98
  }, z.core.$strict>>;
99
99
  sendUpdates: z.ZodOptional<z.ZodEnum<{
100
+ none: "none";
100
101
  all: "all";
101
102
  externalOnly: "externalOnly";
102
- none: "none";
103
103
  }>>;
104
104
  }, z.core.$strict>, z.ZodObject<{
105
105
  connectionId: z.core.$ZodBranded<z.ZodString, "ConnectionId", "out">;
@@ -107,9 +107,9 @@ export declare const CalendarParametersV1Schema: z.ZodDiscriminatedUnion<[z.ZodO
107
107
  schema: z.ZodLiteral<"odingard.guardian.calendar.cancel.v1">;
108
108
  eventId: z.ZodString;
109
109
  sendUpdates: z.ZodOptional<z.ZodEnum<{
110
+ none: "none";
110
111
  all: "all";
111
112
  externalOnly: "externalOnly";
112
- none: "none";
113
113
  }>>;
114
114
  }, z.core.$strict>, z.ZodObject<{
115
115
  connectionId: z.core.$ZodBranded<z.ZodString, "ConnectionId", "out">;
@@ -121,9 +121,9 @@ export declare const CalendarParametersV1Schema: z.ZodDiscriminatedUnion<[z.ZodO
121
121
  optional: z.ZodOptional<z.ZodBoolean>;
122
122
  }, z.core.$strict>>;
123
123
  sendUpdates: z.ZodOptional<z.ZodEnum<{
124
+ none: "none";
124
125
  all: "all";
125
126
  externalOnly: "externalOnly";
126
- none: "none";
127
127
  }>>;
128
128
  }, z.core.$strict>], "schema">;
129
129
  export type CalendarCreateParametersV1 = z.infer<typeof CalendarCreateParametersV1Schema>;