@vorionsys/contracts 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.
Files changed (173) hide show
  1. package/dist/aci/aci-string.d.ts +539 -0
  2. package/dist/aci/aci-string.d.ts.map +1 -0
  3. package/dist/aci/aci-string.js +563 -0
  4. package/dist/aci/aci-string.js.map +1 -0
  5. package/dist/aci/attestation.d.ts +648 -0
  6. package/dist/aci/attestation.d.ts.map +1 -0
  7. package/dist/aci/attestation.js +289 -0
  8. package/dist/aci/attestation.js.map +1 -0
  9. package/dist/aci/domains.d.ts +260 -0
  10. package/dist/aci/domains.d.ts.map +1 -0
  11. package/dist/aci/domains.js +322 -0
  12. package/dist/aci/domains.js.map +1 -0
  13. package/dist/aci/effective-permission.d.ts +371 -0
  14. package/dist/aci/effective-permission.d.ts.map +1 -0
  15. package/dist/aci/effective-permission.js +351 -0
  16. package/dist/aci/effective-permission.js.map +1 -0
  17. package/dist/aci/identity.d.ts +1100 -0
  18. package/dist/aci/identity.d.ts.map +1 -0
  19. package/dist/aci/identity.js +328 -0
  20. package/dist/aci/identity.js.map +1 -0
  21. package/dist/aci/index.d.ts +67 -0
  22. package/dist/aci/index.d.ts.map +1 -0
  23. package/dist/aci/index.js +157 -0
  24. package/dist/aci/index.js.map +1 -0
  25. package/dist/aci/jwt-claims.d.ts +756 -0
  26. package/dist/aci/jwt-claims.d.ts.map +1 -0
  27. package/dist/aci/jwt-claims.js +335 -0
  28. package/dist/aci/jwt-claims.js.map +1 -0
  29. package/dist/aci/levels.d.ts +279 -0
  30. package/dist/aci/levels.d.ts.map +1 -0
  31. package/dist/aci/levels.js +467 -0
  32. package/dist/aci/levels.js.map +1 -0
  33. package/dist/aci/mapping.d.ts +291 -0
  34. package/dist/aci/mapping.d.ts.map +1 -0
  35. package/dist/aci/mapping.js +427 -0
  36. package/dist/aci/mapping.js.map +1 -0
  37. package/dist/aci/skills.d.ts +314 -0
  38. package/dist/aci/skills.d.ts.map +1 -0
  39. package/dist/aci/skills.js +404 -0
  40. package/dist/aci/skills.js.map +1 -0
  41. package/dist/aci/tiers.d.ts +403 -0
  42. package/dist/aci/tiers.d.ts.map +1 -0
  43. package/dist/aci/tiers.js +659 -0
  44. package/dist/aci/tiers.js.map +1 -0
  45. package/dist/canonical/agent.d.ts +796 -0
  46. package/dist/canonical/agent.d.ts.map +1 -0
  47. package/dist/canonical/agent.js +527 -0
  48. package/dist/canonical/agent.js.map +1 -0
  49. package/dist/canonical/governance.d.ts +905 -0
  50. package/dist/canonical/governance.d.ts.map +1 -0
  51. package/dist/canonical/governance.js +454 -0
  52. package/dist/canonical/governance.js.map +1 -0
  53. package/dist/canonical/index.d.ts +17 -0
  54. package/dist/canonical/index.d.ts.map +1 -0
  55. package/dist/canonical/index.js +21 -0
  56. package/dist/canonical/index.js.map +1 -0
  57. package/dist/canonical/intent.d.ts +727 -0
  58. package/dist/canonical/intent.d.ts.map +1 -0
  59. package/dist/canonical/intent.js +203 -0
  60. package/dist/canonical/intent.js.map +1 -0
  61. package/dist/canonical/risk-level.d.ts +344 -0
  62. package/dist/canonical/risk-level.d.ts.map +1 -0
  63. package/dist/canonical/risk-level.js +472 -0
  64. package/dist/canonical/risk-level.js.map +1 -0
  65. package/dist/canonical/trust-band.d.ts +239 -0
  66. package/dist/canonical/trust-band.d.ts.map +1 -0
  67. package/dist/canonical/trust-band.js +298 -0
  68. package/dist/canonical/trust-band.js.map +1 -0
  69. package/dist/canonical/trust-score.d.ts +301 -0
  70. package/dist/canonical/trust-score.d.ts.map +1 -0
  71. package/dist/canonical/trust-score.js +390 -0
  72. package/dist/canonical/trust-score.js.map +1 -0
  73. package/dist/canonical/trust-signal.d.ts +617 -0
  74. package/dist/canonical/trust-signal.d.ts.map +1 -0
  75. package/dist/canonical/trust-signal.js +355 -0
  76. package/dist/canonical/trust-signal.js.map +1 -0
  77. package/dist/canonical/validation.d.ts +231 -0
  78. package/dist/canonical/validation.d.ts.map +1 -0
  79. package/dist/canonical/validation.js +558 -0
  80. package/dist/canonical/validation.js.map +1 -0
  81. package/dist/common/index.d.ts +7 -0
  82. package/dist/common/index.d.ts.map +1 -0
  83. package/dist/common/index.js +7 -0
  84. package/dist/common/index.js.map +1 -0
  85. package/dist/common/primitives.d.ts +56 -0
  86. package/dist/common/primitives.d.ts.map +1 -0
  87. package/dist/common/primitives.js +70 -0
  88. package/dist/common/primitives.js.map +1 -0
  89. package/dist/index.d.ts +11 -0
  90. package/dist/index.d.ts.map +1 -0
  91. package/dist/index.js +15 -0
  92. package/dist/index.js.map +1 -0
  93. package/dist/v2/canary-probe.d.ts +201 -0
  94. package/dist/v2/canary-probe.d.ts.map +1 -0
  95. package/dist/v2/canary-probe.js +99 -0
  96. package/dist/v2/canary-probe.js.map +1 -0
  97. package/dist/v2/component.d.ts +132 -0
  98. package/dist/v2/component.d.ts.map +1 -0
  99. package/dist/v2/component.js +5 -0
  100. package/dist/v2/component.js.map +1 -0
  101. package/dist/v2/decision.d.ts +310 -0
  102. package/dist/v2/decision.d.ts.map +1 -0
  103. package/dist/v2/decision.js +21 -0
  104. package/dist/v2/decision.js.map +1 -0
  105. package/dist/v2/enums.d.ts +185 -0
  106. package/dist/v2/enums.d.ts.map +1 -0
  107. package/dist/v2/enums.js +203 -0
  108. package/dist/v2/enums.js.map +1 -0
  109. package/dist/v2/evidence.d.ts +368 -0
  110. package/dist/v2/evidence.d.ts.map +1 -0
  111. package/dist/v2/evidence.js +152 -0
  112. package/dist/v2/evidence.js.map +1 -0
  113. package/dist/v2/execution.d.ts +190 -0
  114. package/dist/v2/execution.d.ts.map +1 -0
  115. package/dist/v2/execution.js +5 -0
  116. package/dist/v2/execution.js.map +1 -0
  117. package/dist/v2/index.d.ts +19 -0
  118. package/dist/v2/index.d.ts.map +1 -0
  119. package/dist/v2/index.js +32 -0
  120. package/dist/v2/index.js.map +1 -0
  121. package/dist/v2/intent.d.ts +89 -0
  122. package/dist/v2/intent.d.ts.map +1 -0
  123. package/dist/v2/intent.js +5 -0
  124. package/dist/v2/intent.js.map +1 -0
  125. package/dist/v2/policy-bundle.d.ts +166 -0
  126. package/dist/v2/policy-bundle.d.ts.map +1 -0
  127. package/dist/v2/policy-bundle.js +20 -0
  128. package/dist/v2/policy-bundle.js.map +1 -0
  129. package/dist/v2/pre-action-gate.d.ts +185 -0
  130. package/dist/v2/pre-action-gate.d.ts.map +1 -0
  131. package/dist/v2/pre-action-gate.js +64 -0
  132. package/dist/v2/pre-action-gate.js.map +1 -0
  133. package/dist/v2/proof-event.d.ts +201 -0
  134. package/dist/v2/proof-event.d.ts.map +1 -0
  135. package/dist/v2/proof-event.js +5 -0
  136. package/dist/v2/proof-event.js.map +1 -0
  137. package/dist/v2/retention.d.ts +329 -0
  138. package/dist/v2/retention.d.ts.map +1 -0
  139. package/dist/v2/retention.js +162 -0
  140. package/dist/v2/retention.js.map +1 -0
  141. package/dist/v2/trust-delta.d.ts +119 -0
  142. package/dist/v2/trust-delta.d.ts.map +1 -0
  143. package/dist/v2/trust-delta.js +28 -0
  144. package/dist/v2/trust-delta.js.map +1 -0
  145. package/dist/v2/trust-profile.d.ts +337 -0
  146. package/dist/v2/trust-profile.d.ts.map +1 -0
  147. package/dist/v2/trust-profile.js +96 -0
  148. package/dist/v2/trust-profile.js.map +1 -0
  149. package/dist/validators/decision.d.ts +430 -0
  150. package/dist/validators/decision.d.ts.map +1 -0
  151. package/dist/validators/decision.js +61 -0
  152. package/dist/validators/decision.js.map +1 -0
  153. package/dist/validators/enums.d.ts +24 -0
  154. package/dist/validators/enums.d.ts.map +1 -0
  155. package/dist/validators/enums.js +24 -0
  156. package/dist/validators/enums.js.map +1 -0
  157. package/dist/validators/index.d.ts +30 -0
  158. package/dist/validators/index.d.ts.map +1 -0
  159. package/dist/validators/index.js +42 -0
  160. package/dist/validators/index.js.map +1 -0
  161. package/dist/validators/intent.d.ts +229 -0
  162. package/dist/validators/intent.d.ts.map +1 -0
  163. package/dist/validators/intent.js +47 -0
  164. package/dist/validators/intent.js.map +1 -0
  165. package/dist/validators/proof-event.d.ts +981 -0
  166. package/dist/validators/proof-event.d.ts.map +1 -0
  167. package/dist/validators/proof-event.js +134 -0
  168. package/dist/validators/proof-event.js.map +1 -0
  169. package/dist/validators/trust-profile.d.ts +350 -0
  170. package/dist/validators/trust-profile.d.ts.map +1 -0
  171. package/dist/validators/trust-profile.js +65 -0
  172. package/dist/validators/trust-profile.js.map +1 -0
  173. package/package.json +65 -0
@@ -0,0 +1,727 @@
1
+ /**
2
+ * @fileoverview Canonical Intent type definitions for the Vorion Platform.
3
+ *
4
+ * This file provides the authoritative definition for intents - requests from
5
+ * agents to perform actions. It combines and reconciles the various Intent
6
+ * definitions found across the codebase into a single canonical source.
7
+ *
8
+ * An Intent represents what an agent wants to do, including the action,
9
+ * resources involved, classification metadata, and trust context.
10
+ *
11
+ * @module @vorion/contracts/canonical/intent
12
+ */
13
+ import { z } from 'zod';
14
+ import type { TrustBand } from './trust-band.js';
15
+ import type { TrustScore } from './trust-score.js';
16
+ import { type TrustScoreBrand } from './trust-score.js';
17
+ export type { TrustScoreBrand };
18
+ export { ActionType, DataSensitivity, Reversibility } from '../v2/enums.js';
19
+ import { ActionType, DataSensitivity, Reversibility } from '../v2/enums.js';
20
+ /**
21
+ * Intent lifecycle status.
22
+ *
23
+ * Tracks the intent through its complete lifecycle from submission
24
+ * to completion or termination.
25
+ *
26
+ * @type {string}
27
+ */
28
+ export type IntentStatus =
29
+ /** Intent received, awaiting evaluation */
30
+ 'pending'
31
+ /** Intent is being evaluated by trust/policy systems */
32
+ | 'evaluating'
33
+ /** Intent approved, awaiting execution */
34
+ | 'approved'
35
+ /** Intent denied by policy or trust requirements */
36
+ | 'denied'
37
+ /** Intent escalated for human review */
38
+ | 'escalated'
39
+ /** Intent is currently being executed */
40
+ | 'executing'
41
+ /** Intent execution completed successfully */
42
+ | 'completed'
43
+ /** Intent execution failed */
44
+ | 'failed'
45
+ /** Intent was cancelled before completion */
46
+ | 'cancelled';
47
+ /**
48
+ * All possible intent status values as an array.
49
+ */
50
+ export declare const INTENT_STATUS_VALUES: readonly IntentStatus[];
51
+ /**
52
+ * Terminal intent statuses (intent lifecycle has ended).
53
+ */
54
+ export declare const TERMINAL_INTENT_STATUSES: readonly IntentStatus[];
55
+ /**
56
+ * Active intent statuses (intent is still in progress).
57
+ */
58
+ export declare const ACTIVE_INTENT_STATUSES: readonly IntentStatus[];
59
+ /**
60
+ * Context information for intent evaluation.
61
+ *
62
+ * Provides additional context that policies and trust calculations
63
+ * can use when evaluating whether to approve an intent.
64
+ */
65
+ export interface IntentContext {
66
+ /**
67
+ * Domain of operation (e.g., 'healthcare', 'finance', 'hr').
68
+ * Used for domain-specific policy application.
69
+ */
70
+ domain?: string;
71
+ /**
72
+ * Deployment environment.
73
+ * Different policies may apply per environment.
74
+ */
75
+ environment?: 'production' | 'staging' | 'development' | 'test' | string;
76
+ /**
77
+ * User or entity on whose behalf the agent is acting.
78
+ * Important for delegation and audit trails.
79
+ */
80
+ onBehalfOf?: string;
81
+ /**
82
+ * Session or conversation identifier.
83
+ * Groups related intents together.
84
+ */
85
+ sessionId?: string;
86
+ /**
87
+ * Parent intent ID for chained operations.
88
+ * Enables multi-step operation tracking.
89
+ */
90
+ parentIntentId?: string;
91
+ /**
92
+ * Priority level (0 = lowest, 10 = highest).
93
+ * May affect queue ordering and resource allocation.
94
+ */
95
+ priority?: number;
96
+ /**
97
+ * Whether this intent handles Personally Identifiable Information.
98
+ * Triggers additional privacy controls.
99
+ */
100
+ handlesPii?: boolean;
101
+ /**
102
+ * Whether this intent handles Protected Health Information.
103
+ * Triggers HIPAA-related controls.
104
+ */
105
+ handlesPhi?: boolean;
106
+ /**
107
+ * Jurisdictions involved (e.g., 'EU', 'US-CA', 'APAC').
108
+ * Affects applicable compliance rules.
109
+ */
110
+ jurisdictions?: string[];
111
+ /**
112
+ * Tags for categorization and filtering.
113
+ */
114
+ tags?: string[];
115
+ /**
116
+ * Custom metadata for domain-specific context.
117
+ */
118
+ metadata?: Record<string, unknown>;
119
+ }
120
+ /**
121
+ * Trust state snapshot at intent submission time.
122
+ *
123
+ * Captures the agent's trust profile when the intent was created,
124
+ * providing context for decisions and audit.
125
+ */
126
+ export interface TrustSnapshot {
127
+ /** Trust score at submission (0-1000 scale) */
128
+ score: TrustScore;
129
+ /** Trust band at submission */
130
+ band: TrustBand;
131
+ /** Timestamp when snapshot was taken */
132
+ capturedAt: Date;
133
+ /** Profile version for optimistic concurrency */
134
+ profileVersion?: number;
135
+ }
136
+ /**
137
+ * Canonical Intent interface.
138
+ *
139
+ * Represents a complete intent record with all fields from across
140
+ * the platform's various Intent definitions unified into a single
141
+ * authoritative structure.
142
+ *
143
+ * @example
144
+ * ```typescript
145
+ * const intent: Intent = {
146
+ * intentId: 'int_abc123',
147
+ * tenantId: 'ten_xyz789',
148
+ * agentId: 'agt_def456',
149
+ * correlationId: 'corr_ghi012',
150
+ * action: 'Send quarterly report to stakeholders',
151
+ * actionType: ActionType.COMMUNICATE,
152
+ * resourceScope: ['reports:quarterly', 'email:external'],
153
+ * dataSensitivity: DataSensitivity.CONFIDENTIAL,
154
+ * reversibility: Reversibility.IRREVERSIBLE,
155
+ * context: {
156
+ * domain: 'finance',
157
+ * environment: 'production',
158
+ * handlesPii: true,
159
+ * },
160
+ * trustSnapshot: {
161
+ * score: createTrustScore(750),
162
+ * band: TrustBand.T4_TRUSTED,
163
+ * capturedAt: new Date(),
164
+ * },
165
+ * status: 'pending',
166
+ * createdAt: new Date(),
167
+ * updatedAt: new Date(),
168
+ * };
169
+ * ```
170
+ */
171
+ export interface Intent {
172
+ /**
173
+ * Unique intent identifier (UUID format).
174
+ * Primary key for the intent.
175
+ */
176
+ intentId: string;
177
+ /**
178
+ * Tenant/organization identifier.
179
+ * Enables multi-tenant isolation.
180
+ */
181
+ tenantId: string;
182
+ /**
183
+ * Agent making the request.
184
+ * References the agent's unique identifier.
185
+ */
186
+ agentId: string;
187
+ /**
188
+ * Correlation ID for end-to-end distributed tracing.
189
+ * Links related events across services.
190
+ */
191
+ correlationId: string;
192
+ /**
193
+ * Human-readable description of the intended action.
194
+ * Should be clear and specific about what the agent wants to do.
195
+ */
196
+ action: string;
197
+ /**
198
+ * Category of action being performed.
199
+ * Used for policy matching and risk assessment.
200
+ */
201
+ actionType: ActionType;
202
+ /**
203
+ * Resources this intent will access or modify.
204
+ * Format: 'resource_type:resource_id' or URN patterns.
205
+ *
206
+ * @example ['database:users', 'api:payments/*', 'file:reports/q4.pdf']
207
+ */
208
+ resourceScope: string[];
209
+ /**
210
+ * Data sensitivity level involved in this action.
211
+ * Determines required trust level and audit depth.
212
+ */
213
+ dataSensitivity: DataSensitivity;
214
+ /**
215
+ * Whether this action can be undone.
216
+ * Affects approval requirements and safeguards.
217
+ */
218
+ reversibility: Reversibility;
219
+ /**
220
+ * Additional context for policy evaluation.
221
+ * Contains domain, environment, and other contextual information.
222
+ */
223
+ context: IntentContext;
224
+ /**
225
+ * Trust profile snapshot at submission time.
226
+ * Captures the agent's trust state when the intent was created.
227
+ */
228
+ trustSnapshot: TrustSnapshot;
229
+ /**
230
+ * Current status in the intent lifecycle.
231
+ */
232
+ status: IntentStatus;
233
+ /**
234
+ * When the intent was created.
235
+ */
236
+ createdAt: Date;
237
+ /**
238
+ * When the intent was last updated.
239
+ */
240
+ updatedAt: Date;
241
+ /**
242
+ * When the intent expires (optional).
243
+ * After this time, the intent should be auto-denied.
244
+ */
245
+ expiresAt?: Date;
246
+ /**
247
+ * Soft delete timestamp for GDPR compliance.
248
+ * If set, the intent is considered deleted but retained for audit.
249
+ */
250
+ deletedAt?: Date;
251
+ /**
252
+ * Reason for cancellation (if status is 'cancelled').
253
+ */
254
+ cancellationReason?: string;
255
+ /**
256
+ * Reason for denial (if status is 'denied').
257
+ */
258
+ denialReason?: string;
259
+ /**
260
+ * Reason for failure (if status is 'failed').
261
+ */
262
+ failureReason?: string;
263
+ /**
264
+ * Source system that generated this intent.
265
+ * Useful for debugging and analytics.
266
+ */
267
+ source?: string;
268
+ /**
269
+ * Decision ID if a decision has been made.
270
+ * Links to the authorization decision record.
271
+ */
272
+ decisionId?: string;
273
+ /**
274
+ * Execution ID if execution has started.
275
+ * Links to the execution record.
276
+ */
277
+ executionId?: string;
278
+ }
279
+ /**
280
+ * Summary view of an intent for listings and dashboards.
281
+ */
282
+ export interface IntentSummary {
283
+ intentId: string;
284
+ tenantId: string;
285
+ agentId: string;
286
+ correlationId: string;
287
+ action: string;
288
+ actionType: ActionType;
289
+ dataSensitivity: DataSensitivity;
290
+ status: IntentStatus;
291
+ trustBand: TrustBand;
292
+ createdAt: Date;
293
+ }
294
+ /**
295
+ * Request to create a new intent.
296
+ *
297
+ * Contains the minimum required fields plus optional overrides.
298
+ */
299
+ export interface CreateIntentRequest {
300
+ /** Agent making the request */
301
+ agentId: string;
302
+ /** Action description */
303
+ action: string;
304
+ /** Action category */
305
+ actionType: ActionType;
306
+ /** Resources to access/modify */
307
+ resourceScope: string[];
308
+ /** Data sensitivity level */
309
+ dataSensitivity: DataSensitivity;
310
+ /** Reversibility classification */
311
+ reversibility: Reversibility;
312
+ /** Optional correlation ID (generated if not provided) */
313
+ correlationId?: string;
314
+ /** Optional context */
315
+ context?: Partial<IntentContext>;
316
+ /** Optional expiration in milliseconds from creation */
317
+ expiresInMs?: number;
318
+ /** Optional source identifier */
319
+ source?: string;
320
+ }
321
+ /**
322
+ * Type guard to check if a value is a valid IntentStatus.
323
+ *
324
+ * @param value - Value to check
325
+ * @returns True if value is a valid IntentStatus
326
+ */
327
+ export declare function isIntentStatus(value: unknown): value is IntentStatus;
328
+ /**
329
+ * Type guard to check if an IntentStatus is terminal.
330
+ *
331
+ * @param status - Status to check
332
+ * @returns True if status is a terminal state
333
+ */
334
+ export declare function isTerminalStatus(status: IntentStatus): boolean;
335
+ /**
336
+ * Type guard to check if an IntentStatus is active.
337
+ *
338
+ * @param status - Status to check
339
+ * @returns True if status is an active state
340
+ */
341
+ export declare function isActiveStatus(status: IntentStatus): boolean;
342
+ /**
343
+ * Zod schema for ActionType enum.
344
+ */
345
+ export declare const actionTypeSchema: z.ZodNativeEnum<typeof ActionType>;
346
+ /**
347
+ * Zod schema for DataSensitivity enum.
348
+ */
349
+ export declare const dataSensitivitySchema: z.ZodNativeEnum<typeof DataSensitivity>;
350
+ /**
351
+ * Zod schema for Reversibility enum.
352
+ */
353
+ export declare const reversibilitySchema: z.ZodNativeEnum<typeof Reversibility>;
354
+ /**
355
+ * Zod schema for IntentStatus.
356
+ */
357
+ export declare const intentStatusSchema: z.ZodEnum<["pending", "evaluating", "approved", "denied", "escalated", "executing", "completed", "failed", "cancelled"]>;
358
+ /**
359
+ * Zod schema for IntentContext.
360
+ */
361
+ export declare const intentContextSchema: z.ZodObject<{
362
+ domain: z.ZodOptional<z.ZodString>;
363
+ environment: z.ZodOptional<z.ZodString>;
364
+ onBehalfOf: z.ZodOptional<z.ZodString>;
365
+ sessionId: z.ZodOptional<z.ZodString>;
366
+ parentIntentId: z.ZodOptional<z.ZodString>;
367
+ priority: z.ZodOptional<z.ZodNumber>;
368
+ handlesPii: z.ZodOptional<z.ZodBoolean>;
369
+ handlesPhi: z.ZodOptional<z.ZodBoolean>;
370
+ jurisdictions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
371
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
372
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
373
+ }, "strict", z.ZodTypeAny, {
374
+ metadata?: Record<string, unknown> | undefined;
375
+ domain?: string | undefined;
376
+ priority?: number | undefined;
377
+ environment?: string | undefined;
378
+ sessionId?: string | undefined;
379
+ onBehalfOf?: string | undefined;
380
+ parentIntentId?: string | undefined;
381
+ handlesPii?: boolean | undefined;
382
+ handlesPhi?: boolean | undefined;
383
+ jurisdictions?: string[] | undefined;
384
+ tags?: string[] | undefined;
385
+ }, {
386
+ metadata?: Record<string, unknown> | undefined;
387
+ domain?: string | undefined;
388
+ priority?: number | undefined;
389
+ environment?: string | undefined;
390
+ sessionId?: string | undefined;
391
+ onBehalfOf?: string | undefined;
392
+ parentIntentId?: string | undefined;
393
+ handlesPii?: boolean | undefined;
394
+ handlesPhi?: boolean | undefined;
395
+ jurisdictions?: string[] | undefined;
396
+ tags?: string[] | undefined;
397
+ }>;
398
+ /**
399
+ * Zod schema for TrustSnapshot.
400
+ */
401
+ export declare const trustSnapshotSchema: z.ZodObject<{
402
+ score: z.ZodEffects<z.ZodNumber, TrustScore, number>;
403
+ band: z.ZodNativeEnum<typeof TrustBand>;
404
+ capturedAt: z.ZodDate;
405
+ profileVersion: z.ZodOptional<z.ZodNumber>;
406
+ }, "strip", z.ZodTypeAny, {
407
+ band: TrustBand;
408
+ score: number & {
409
+ readonly [TrustScoreBrand]: typeof TrustScoreBrand;
410
+ };
411
+ capturedAt: Date;
412
+ profileVersion?: number | undefined;
413
+ }, {
414
+ band: TrustBand;
415
+ score: number;
416
+ capturedAt: Date;
417
+ profileVersion?: number | undefined;
418
+ }>;
419
+ /**
420
+ * Zod schema for Intent validation.
421
+ */
422
+ export declare const intentSchema: z.ZodObject<{
423
+ intentId: z.ZodString;
424
+ tenantId: z.ZodString;
425
+ agentId: z.ZodString;
426
+ correlationId: z.ZodString;
427
+ action: z.ZodString;
428
+ actionType: z.ZodNativeEnum<typeof ActionType>;
429
+ resourceScope: z.ZodArray<z.ZodString, "many">;
430
+ dataSensitivity: z.ZodNativeEnum<typeof DataSensitivity>;
431
+ reversibility: z.ZodNativeEnum<typeof Reversibility>;
432
+ context: z.ZodObject<{
433
+ domain: z.ZodOptional<z.ZodString>;
434
+ environment: z.ZodOptional<z.ZodString>;
435
+ onBehalfOf: z.ZodOptional<z.ZodString>;
436
+ sessionId: z.ZodOptional<z.ZodString>;
437
+ parentIntentId: z.ZodOptional<z.ZodString>;
438
+ priority: z.ZodOptional<z.ZodNumber>;
439
+ handlesPii: z.ZodOptional<z.ZodBoolean>;
440
+ handlesPhi: z.ZodOptional<z.ZodBoolean>;
441
+ jurisdictions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
442
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
443
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
444
+ }, "strict", z.ZodTypeAny, {
445
+ metadata?: Record<string, unknown> | undefined;
446
+ domain?: string | undefined;
447
+ priority?: number | undefined;
448
+ environment?: string | undefined;
449
+ sessionId?: string | undefined;
450
+ onBehalfOf?: string | undefined;
451
+ parentIntentId?: string | undefined;
452
+ handlesPii?: boolean | undefined;
453
+ handlesPhi?: boolean | undefined;
454
+ jurisdictions?: string[] | undefined;
455
+ tags?: string[] | undefined;
456
+ }, {
457
+ metadata?: Record<string, unknown> | undefined;
458
+ domain?: string | undefined;
459
+ priority?: number | undefined;
460
+ environment?: string | undefined;
461
+ sessionId?: string | undefined;
462
+ onBehalfOf?: string | undefined;
463
+ parentIntentId?: string | undefined;
464
+ handlesPii?: boolean | undefined;
465
+ handlesPhi?: boolean | undefined;
466
+ jurisdictions?: string[] | undefined;
467
+ tags?: string[] | undefined;
468
+ }>;
469
+ trustSnapshot: z.ZodObject<{
470
+ score: z.ZodEffects<z.ZodNumber, TrustScore, number>;
471
+ band: z.ZodNativeEnum<typeof TrustBand>;
472
+ capturedAt: z.ZodDate;
473
+ profileVersion: z.ZodOptional<z.ZodNumber>;
474
+ }, "strip", z.ZodTypeAny, {
475
+ band: TrustBand;
476
+ score: number & {
477
+ readonly [TrustScoreBrand]: typeof TrustScoreBrand;
478
+ };
479
+ capturedAt: Date;
480
+ profileVersion?: number | undefined;
481
+ }, {
482
+ band: TrustBand;
483
+ score: number;
484
+ capturedAt: Date;
485
+ profileVersion?: number | undefined;
486
+ }>;
487
+ status: z.ZodEnum<["pending", "evaluating", "approved", "denied", "escalated", "executing", "completed", "failed", "cancelled"]>;
488
+ createdAt: z.ZodDate;
489
+ updatedAt: z.ZodDate;
490
+ expiresAt: z.ZodOptional<z.ZodDate>;
491
+ deletedAt: z.ZodOptional<z.ZodDate>;
492
+ cancellationReason: z.ZodOptional<z.ZodString>;
493
+ denialReason: z.ZodOptional<z.ZodString>;
494
+ failureReason: z.ZodOptional<z.ZodString>;
495
+ source: z.ZodOptional<z.ZodString>;
496
+ decisionId: z.ZodOptional<z.ZodString>;
497
+ executionId: z.ZodOptional<z.ZodString>;
498
+ }, "strip", z.ZodTypeAny, {
499
+ status: "completed" | "failed" | "cancelled" | "pending" | "evaluating" | "approved" | "denied" | "escalated" | "executing";
500
+ correlationId: string;
501
+ intentId: string;
502
+ createdAt: Date;
503
+ updatedAt: Date;
504
+ agentId: string;
505
+ context: {
506
+ metadata?: Record<string, unknown> | undefined;
507
+ domain?: string | undefined;
508
+ priority?: number | undefined;
509
+ environment?: string | undefined;
510
+ sessionId?: string | undefined;
511
+ onBehalfOf?: string | undefined;
512
+ parentIntentId?: string | undefined;
513
+ handlesPii?: boolean | undefined;
514
+ handlesPhi?: boolean | undefined;
515
+ jurisdictions?: string[] | undefined;
516
+ tags?: string[] | undefined;
517
+ };
518
+ tenantId: string;
519
+ action: string;
520
+ actionType: ActionType;
521
+ resourceScope: string[];
522
+ dataSensitivity: DataSensitivity;
523
+ reversibility: Reversibility;
524
+ trustSnapshot: {
525
+ band: TrustBand;
526
+ score: number & {
527
+ readonly [TrustScoreBrand]: typeof TrustScoreBrand;
528
+ };
529
+ capturedAt: Date;
530
+ profileVersion?: number | undefined;
531
+ };
532
+ decisionId?: string | undefined;
533
+ expiresAt?: Date | undefined;
534
+ deletedAt?: Date | undefined;
535
+ source?: string | undefined;
536
+ cancellationReason?: string | undefined;
537
+ denialReason?: string | undefined;
538
+ failureReason?: string | undefined;
539
+ executionId?: string | undefined;
540
+ }, {
541
+ status: "completed" | "failed" | "cancelled" | "pending" | "evaluating" | "approved" | "denied" | "escalated" | "executing";
542
+ correlationId: string;
543
+ intentId: string;
544
+ createdAt: Date;
545
+ updatedAt: Date;
546
+ agentId: string;
547
+ context: {
548
+ metadata?: Record<string, unknown> | undefined;
549
+ domain?: string | undefined;
550
+ priority?: number | undefined;
551
+ environment?: string | undefined;
552
+ sessionId?: string | undefined;
553
+ onBehalfOf?: string | undefined;
554
+ parentIntentId?: string | undefined;
555
+ handlesPii?: boolean | undefined;
556
+ handlesPhi?: boolean | undefined;
557
+ jurisdictions?: string[] | undefined;
558
+ tags?: string[] | undefined;
559
+ };
560
+ tenantId: string;
561
+ action: string;
562
+ actionType: ActionType;
563
+ resourceScope: string[];
564
+ dataSensitivity: DataSensitivity;
565
+ reversibility: Reversibility;
566
+ trustSnapshot: {
567
+ band: TrustBand;
568
+ score: number;
569
+ capturedAt: Date;
570
+ profileVersion?: number | undefined;
571
+ };
572
+ decisionId?: string | undefined;
573
+ expiresAt?: Date | undefined;
574
+ deletedAt?: Date | undefined;
575
+ source?: string | undefined;
576
+ cancellationReason?: string | undefined;
577
+ denialReason?: string | undefined;
578
+ failureReason?: string | undefined;
579
+ executionId?: string | undefined;
580
+ }>;
581
+ /**
582
+ * Zod schema for IntentSummary.
583
+ */
584
+ export declare const intentSummarySchema: z.ZodObject<{
585
+ intentId: z.ZodString;
586
+ tenantId: z.ZodString;
587
+ agentId: z.ZodString;
588
+ correlationId: z.ZodString;
589
+ action: z.ZodString;
590
+ actionType: z.ZodNativeEnum<typeof ActionType>;
591
+ dataSensitivity: z.ZodNativeEnum<typeof DataSensitivity>;
592
+ status: z.ZodEnum<["pending", "evaluating", "approved", "denied", "escalated", "executing", "completed", "failed", "cancelled"]>;
593
+ trustBand: z.ZodNativeEnum<typeof TrustBand>;
594
+ createdAt: z.ZodDate;
595
+ }, "strip", z.ZodTypeAny, {
596
+ status: "completed" | "failed" | "cancelled" | "pending" | "evaluating" | "approved" | "denied" | "escalated" | "executing";
597
+ correlationId: string;
598
+ intentId: string;
599
+ createdAt: Date;
600
+ agentId: string;
601
+ tenantId: string;
602
+ action: string;
603
+ actionType: ActionType;
604
+ dataSensitivity: DataSensitivity;
605
+ trustBand: TrustBand;
606
+ }, {
607
+ status: "completed" | "failed" | "cancelled" | "pending" | "evaluating" | "approved" | "denied" | "escalated" | "executing";
608
+ correlationId: string;
609
+ intentId: string;
610
+ createdAt: Date;
611
+ agentId: string;
612
+ tenantId: string;
613
+ action: string;
614
+ actionType: ActionType;
615
+ dataSensitivity: DataSensitivity;
616
+ trustBand: TrustBand;
617
+ }>;
618
+ /**
619
+ * Zod schema for CreateIntentRequest validation.
620
+ */
621
+ export declare const createIntentRequestSchema: z.ZodObject<{
622
+ agentId: z.ZodString;
623
+ action: z.ZodString;
624
+ actionType: z.ZodNativeEnum<typeof ActionType>;
625
+ resourceScope: z.ZodArray<z.ZodString, "many">;
626
+ dataSensitivity: z.ZodNativeEnum<typeof DataSensitivity>;
627
+ reversibility: z.ZodNativeEnum<typeof Reversibility>;
628
+ correlationId: z.ZodOptional<z.ZodString>;
629
+ context: z.ZodOptional<z.ZodObject<{
630
+ domain: z.ZodOptional<z.ZodOptional<z.ZodString>>;
631
+ environment: z.ZodOptional<z.ZodOptional<z.ZodString>>;
632
+ onBehalfOf: z.ZodOptional<z.ZodOptional<z.ZodString>>;
633
+ sessionId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
634
+ parentIntentId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
635
+ priority: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
636
+ handlesPii: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
637
+ handlesPhi: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
638
+ jurisdictions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
639
+ tags: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
640
+ metadata: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
641
+ }, "strict", z.ZodTypeAny, {
642
+ metadata?: Record<string, unknown> | undefined;
643
+ domain?: string | undefined;
644
+ priority?: number | undefined;
645
+ environment?: string | undefined;
646
+ sessionId?: string | undefined;
647
+ onBehalfOf?: string | undefined;
648
+ parentIntentId?: string | undefined;
649
+ handlesPii?: boolean | undefined;
650
+ handlesPhi?: boolean | undefined;
651
+ jurisdictions?: string[] | undefined;
652
+ tags?: string[] | undefined;
653
+ }, {
654
+ metadata?: Record<string, unknown> | undefined;
655
+ domain?: string | undefined;
656
+ priority?: number | undefined;
657
+ environment?: string | undefined;
658
+ sessionId?: string | undefined;
659
+ onBehalfOf?: string | undefined;
660
+ parentIntentId?: string | undefined;
661
+ handlesPii?: boolean | undefined;
662
+ handlesPhi?: boolean | undefined;
663
+ jurisdictions?: string[] | undefined;
664
+ tags?: string[] | undefined;
665
+ }>>;
666
+ expiresInMs: z.ZodOptional<z.ZodNumber>;
667
+ source: z.ZodOptional<z.ZodString>;
668
+ }, "strip", z.ZodTypeAny, {
669
+ agentId: string;
670
+ action: string;
671
+ actionType: ActionType;
672
+ resourceScope: string[];
673
+ dataSensitivity: DataSensitivity;
674
+ reversibility: Reversibility;
675
+ correlationId?: string | undefined;
676
+ context?: {
677
+ metadata?: Record<string, unknown> | undefined;
678
+ domain?: string | undefined;
679
+ priority?: number | undefined;
680
+ environment?: string | undefined;
681
+ sessionId?: string | undefined;
682
+ onBehalfOf?: string | undefined;
683
+ parentIntentId?: string | undefined;
684
+ handlesPii?: boolean | undefined;
685
+ handlesPhi?: boolean | undefined;
686
+ jurisdictions?: string[] | undefined;
687
+ tags?: string[] | undefined;
688
+ } | undefined;
689
+ source?: string | undefined;
690
+ expiresInMs?: number | undefined;
691
+ }, {
692
+ agentId: string;
693
+ action: string;
694
+ actionType: ActionType;
695
+ resourceScope: string[];
696
+ dataSensitivity: DataSensitivity;
697
+ reversibility: Reversibility;
698
+ correlationId?: string | undefined;
699
+ context?: {
700
+ metadata?: Record<string, unknown> | undefined;
701
+ domain?: string | undefined;
702
+ priority?: number | undefined;
703
+ environment?: string | undefined;
704
+ sessionId?: string | undefined;
705
+ onBehalfOf?: string | undefined;
706
+ parentIntentId?: string | undefined;
707
+ handlesPii?: boolean | undefined;
708
+ handlesPhi?: boolean | undefined;
709
+ jurisdictions?: string[] | undefined;
710
+ tags?: string[] | undefined;
711
+ } | undefined;
712
+ source?: string | undefined;
713
+ expiresInMs?: number | undefined;
714
+ }>;
715
+ /**
716
+ * Inferred Intent type from Zod schema.
717
+ */
718
+ export type IntentInput = z.input<typeof intentSchema>;
719
+ /**
720
+ * Inferred IntentContext type from Zod schema.
721
+ */
722
+ export type IntentContextInput = z.input<typeof intentContextSchema>;
723
+ /**
724
+ * Inferred CreateIntentRequest type from Zod schema.
725
+ */
726
+ export type CreateIntentRequestInput = z.input<typeof createIntentRequestSchema>;
727
+ //# sourceMappingURL=intent.d.ts.map