@kya-os/contracts 1.5.3 → 1.5.4-canary.2

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.
@@ -28,6 +28,8 @@ export declare const clearCacheResponseSchema: z.ZodObject<{
28
28
  had_value: z.ZodBoolean;
29
29
  had_old_value: z.ZodBoolean;
30
30
  cleared: z.ZodBoolean;
31
+ refreshed_immediately: z.ZodOptional<z.ZodBoolean>;
32
+ refresh_error: z.ZodOptional<z.ZodString>;
31
33
  }, "strip", z.ZodTypeAny, {
32
34
  agent_did: string;
33
35
  message: string;
@@ -37,6 +39,8 @@ export declare const clearCacheResponseSchema: z.ZodObject<{
37
39
  had_value: boolean;
38
40
  had_old_value: boolean;
39
41
  cleared: boolean;
42
+ refreshed_immediately?: boolean | undefined;
43
+ refresh_error?: string | undefined;
40
44
  }, {
41
45
  agent_did: string;
42
46
  message: string;
@@ -46,4 +50,6 @@ export declare const clearCacheResponseSchema: z.ZodObject<{
46
50
  had_value: boolean;
47
51
  had_old_value: boolean;
48
52
  cleared: boolean;
53
+ refreshed_immediately?: boolean | undefined;
54
+ refresh_error?: string | undefined;
49
55
  }>;
@@ -27,4 +27,6 @@ exports.clearCacheResponseSchema = zod_1.z.object({
27
27
  had_value: zod_1.z.boolean().describe('Whether the cache entry existed before clearing'),
28
28
  had_old_value: zod_1.z.boolean().describe('Whether the old cache entry existed before clearing'),
29
29
  cleared: zod_1.z.boolean().describe('Whether the cache was successfully cleared'),
30
+ refreshed_immediately: zod_1.z.boolean().optional().describe('Whether cache was immediately refreshed from API after clearing'),
31
+ refresh_error: zod_1.z.string().optional().describe('Error message if immediate refresh failed (non-fatal)'),
30
32
  });
@@ -34,4 +34,8 @@ export interface ClearCacheResponse {
34
34
  had_old_value: boolean;
35
35
  /** Whether the cache was successfully cleared */
36
36
  cleared: boolean;
37
+ /** Whether cache was immediately refreshed from API after clearing */
38
+ refreshed_immediately?: boolean;
39
+ /** Error message if immediate refresh failed (non-fatal) */
40
+ refresh_error?: string;
37
41
  }
@@ -37,13 +37,13 @@ export declare const consentTermsSchema: z.ZodObject<{
37
37
  required: z.ZodDefault<z.ZodBoolean>;
38
38
  }, "strip", z.ZodTypeAny, {
39
39
  required: boolean;
40
- version?: string | undefined;
41
- url?: string | undefined;
42
40
  text?: string | undefined;
43
- }, {
44
- version?: string | undefined;
45
41
  url?: string | undefined;
42
+ version?: string | undefined;
43
+ }, {
46
44
  text?: string | undefined;
45
+ url?: string | undefined;
46
+ version?: string | undefined;
47
47
  required?: boolean | undefined;
48
48
  }>;
49
49
  export type ConsentTerms = z.infer<typeof consentTermsSchema>;
@@ -81,10 +81,10 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
81
81
  }>, "many">>;
82
82
  pattern: z.ZodOptional<z.ZodString>;
83
83
  }, "strip", z.ZodTypeAny, {
84
- name: string;
85
84
  type: "text" | "textarea" | "checkbox" | "select";
86
85
  required: boolean;
87
86
  label: string;
87
+ name: string;
88
88
  options?: {
89
89
  value: string;
90
90
  label: string;
@@ -92,10 +92,10 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
92
92
  placeholder?: string | undefined;
93
93
  pattern?: string | undefined;
94
94
  }, {
95
- name: string;
96
95
  type: "text" | "textarea" | "checkbox" | "select";
97
96
  required: boolean;
98
97
  label: string;
98
+ name: string;
99
99
  options?: {
100
100
  value: string;
101
101
  label: string;
@@ -103,10 +103,10 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
103
103
  placeholder?: string | undefined;
104
104
  pattern?: string | undefined;
105
105
  }>, {
106
- name: string;
107
106
  type: "text" | "textarea" | "checkbox" | "select";
108
107
  required: boolean;
109
108
  label: string;
109
+ name: string;
110
110
  options?: {
111
111
  value: string;
112
112
  label: string;
@@ -114,10 +114,10 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
114
114
  placeholder?: string | undefined;
115
115
  pattern?: string | undefined;
116
116
  }, {
117
- name: string;
118
117
  type: "text" | "textarea" | "checkbox" | "select";
119
118
  required: boolean;
120
119
  label: string;
120
+ name: string;
121
121
  options?: {
122
122
  value: string;
123
123
  label: string;
@@ -195,13 +195,13 @@ export declare const consentPageConfigSchema: z.ZodObject<{
195
195
  required: z.ZodDefault<z.ZodBoolean>;
196
196
  }, "strip", z.ZodTypeAny, {
197
197
  required: boolean;
198
- version?: string | undefined;
199
- url?: string | undefined;
200
198
  text?: string | undefined;
201
- }, {
202
- version?: string | undefined;
203
199
  url?: string | undefined;
200
+ version?: string | undefined;
201
+ }, {
204
202
  text?: string | undefined;
203
+ url?: string | undefined;
204
+ version?: string | undefined;
205
205
  required?: boolean | undefined;
206
206
  }>>;
207
207
  customFields: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -222,10 +222,10 @@ export declare const consentPageConfigSchema: z.ZodObject<{
222
222
  }>, "many">>;
223
223
  pattern: z.ZodOptional<z.ZodString>;
224
224
  }, "strip", z.ZodTypeAny, {
225
- name: string;
226
225
  type: "text" | "textarea" | "checkbox" | "select";
227
226
  required: boolean;
228
227
  label: string;
228
+ name: string;
229
229
  options?: {
230
230
  value: string;
231
231
  label: string;
@@ -233,10 +233,10 @@ export declare const consentPageConfigSchema: z.ZodObject<{
233
233
  placeholder?: string | undefined;
234
234
  pattern?: string | undefined;
235
235
  }, {
236
- name: string;
237
236
  type: "text" | "textarea" | "checkbox" | "select";
238
237
  required: boolean;
239
238
  label: string;
239
+ name: string;
240
240
  options?: {
241
241
  value: string;
242
242
  label: string;
@@ -244,10 +244,10 @@ export declare const consentPageConfigSchema: z.ZodObject<{
244
244
  placeholder?: string | undefined;
245
245
  pattern?: string | undefined;
246
246
  }>, {
247
- name: string;
248
247
  type: "text" | "textarea" | "checkbox" | "select";
249
248
  required: boolean;
250
249
  label: string;
250
+ name: string;
251
251
  options?: {
252
252
  value: string;
253
253
  label: string;
@@ -255,10 +255,10 @@ export declare const consentPageConfigSchema: z.ZodObject<{
255
255
  placeholder?: string | undefined;
256
256
  pattern?: string | undefined;
257
257
  }, {
258
- name: string;
259
258
  type: "text" | "textarea" | "checkbox" | "select";
260
259
  required: boolean;
261
260
  label: string;
261
+ name: string;
262
262
  options?: {
263
263
  value: string;
264
264
  label: string;
@@ -269,11 +269,11 @@ export declare const consentPageConfigSchema: z.ZodObject<{
269
269
  serverUrl: z.ZodString;
270
270
  autoClose: z.ZodOptional<z.ZodBoolean>;
271
271
  }, "strip", z.ZodTypeAny, {
272
- agentDid: string;
273
- sessionId: string;
274
272
  tool: string;
275
273
  toolDescription: string;
276
274
  scopes: string[];
275
+ agentDid: string;
276
+ sessionId: string;
277
277
  projectId: string;
278
278
  serverUrl: string;
279
279
  branding?: {
@@ -284,15 +284,15 @@ export declare const consentPageConfigSchema: z.ZodObject<{
284
284
  } | undefined;
285
285
  terms?: {
286
286
  required: boolean;
287
- version?: string | undefined;
288
- url?: string | undefined;
289
287
  text?: string | undefined;
288
+ url?: string | undefined;
289
+ version?: string | undefined;
290
290
  } | undefined;
291
291
  customFields?: {
292
- name: string;
293
292
  type: "text" | "textarea" | "checkbox" | "select";
294
293
  required: boolean;
295
294
  label: string;
295
+ name: string;
296
296
  options?: {
297
297
  value: string;
298
298
  label: string;
@@ -302,11 +302,11 @@ export declare const consentPageConfigSchema: z.ZodObject<{
302
302
  }[] | undefined;
303
303
  autoClose?: boolean | undefined;
304
304
  }, {
305
- agentDid: string;
306
- sessionId: string;
307
305
  tool: string;
308
306
  toolDescription: string;
309
307
  scopes: string[];
308
+ agentDid: string;
309
+ sessionId: string;
310
310
  projectId: string;
311
311
  serverUrl: string;
312
312
  branding?: {
@@ -316,16 +316,16 @@ export declare const consentPageConfigSchema: z.ZodObject<{
316
316
  theme?: "light" | "dark" | "auto" | undefined;
317
317
  } | undefined;
318
318
  terms?: {
319
- version?: string | undefined;
320
- url?: string | undefined;
321
319
  text?: string | undefined;
320
+ url?: string | undefined;
321
+ version?: string | undefined;
322
322
  required?: boolean | undefined;
323
323
  } | undefined;
324
324
  customFields?: {
325
- name: string;
326
325
  type: "text" | "textarea" | "checkbox" | "select";
327
326
  required: boolean;
328
327
  label: string;
328
+ name: string;
329
329
  options?: {
330
330
  value: string;
331
331
  label: string;
@@ -355,10 +355,11 @@ export declare const consentApprovalRequestSchema: z.ZodObject<{
355
355
  termsVersion: z.ZodOptional<z.ZodString>;
356
356
  customFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean]>>>;
357
357
  /**
358
- * OAuth provider identity information (optional)
358
+ * OAuth provider identity information (optional, can be null)
359
359
  * Used to link OAuth accounts to persistent User DIDs
360
+ * Can be null when OAuth is not configured or user hasn't authenticated
360
361
  */
361
- oauth_identity: z.ZodOptional<z.ZodObject<{
362
+ oauth_identity: z.ZodOptional<z.ZodNullable<z.ZodObject<{
362
363
  /**
363
364
  * OAuth provider name (e.g., "google", "github", "microsoft")
364
365
  */
@@ -386,7 +387,7 @@ export declare const consentApprovalRequestSchema: z.ZodObject<{
386
387
  subject: string;
387
388
  name?: string | undefined;
388
389
  email?: string | undefined;
389
- }>>;
390
+ }>>>;
390
391
  /**
391
392
  * User DID (optional)
392
393
  * If provided, represents the persistent User DID for this user
@@ -407,7 +408,7 @@ export declare const consentApprovalRequestSchema: z.ZodObject<{
407
408
  subject: string;
408
409
  name?: string | undefined;
409
410
  email?: string | undefined;
410
- } | undefined;
411
+ } | null | undefined;
411
412
  user_did?: string | undefined;
412
413
  }, {
413
414
  tool: string;
@@ -423,7 +424,7 @@ export declare const consentApprovalRequestSchema: z.ZodObject<{
423
424
  subject: string;
424
425
  name?: string | undefined;
425
426
  email?: string | undefined;
426
- } | undefined;
427
+ } | null | undefined;
427
428
  user_did?: string | undefined;
428
429
  }>;
429
430
  export type ConsentApprovalRequest = z.infer<typeof consentApprovalRequestSchema>;
@@ -489,13 +490,13 @@ export declare const consentConfigSchema: z.ZodObject<{
489
490
  required: z.ZodDefault<z.ZodBoolean>;
490
491
  }, "strip", z.ZodTypeAny, {
491
492
  required: boolean;
492
- version?: string | undefined;
493
- url?: string | undefined;
494
493
  text?: string | undefined;
495
- }, {
496
- version?: string | undefined;
497
494
  url?: string | undefined;
495
+ version?: string | undefined;
496
+ }, {
498
497
  text?: string | undefined;
498
+ url?: string | undefined;
499
+ version?: string | undefined;
499
500
  required?: boolean | undefined;
500
501
  }>>;
501
502
  customFields: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -516,10 +517,10 @@ export declare const consentConfigSchema: z.ZodObject<{
516
517
  }>, "many">>;
517
518
  pattern: z.ZodOptional<z.ZodString>;
518
519
  }, "strip", z.ZodTypeAny, {
519
- name: string;
520
520
  type: "text" | "textarea" | "checkbox" | "select";
521
521
  required: boolean;
522
522
  label: string;
523
+ name: string;
523
524
  options?: {
524
525
  value: string;
525
526
  label: string;
@@ -527,10 +528,10 @@ export declare const consentConfigSchema: z.ZodObject<{
527
528
  placeholder?: string | undefined;
528
529
  pattern?: string | undefined;
529
530
  }, {
530
- name: string;
531
531
  type: "text" | "textarea" | "checkbox" | "select";
532
532
  required: boolean;
533
533
  label: string;
534
+ name: string;
534
535
  options?: {
535
536
  value: string;
536
537
  label: string;
@@ -538,10 +539,10 @@ export declare const consentConfigSchema: z.ZodObject<{
538
539
  placeholder?: string | undefined;
539
540
  pattern?: string | undefined;
540
541
  }>, {
541
- name: string;
542
542
  type: "text" | "textarea" | "checkbox" | "select";
543
543
  required: boolean;
544
544
  label: string;
545
+ name: string;
545
546
  options?: {
546
547
  value: string;
547
548
  label: string;
@@ -549,10 +550,10 @@ export declare const consentConfigSchema: z.ZodObject<{
549
550
  placeholder?: string | undefined;
550
551
  pattern?: string | undefined;
551
552
  }, {
552
- name: string;
553
553
  type: "text" | "textarea" | "checkbox" | "select";
554
554
  required: boolean;
555
555
  label: string;
556
+ name: string;
556
557
  options?: {
557
558
  value: string;
558
559
  label: string;
@@ -585,15 +586,15 @@ export declare const consentConfigSchema: z.ZodObject<{
585
586
  } | undefined;
586
587
  terms?: {
587
588
  required: boolean;
588
- version?: string | undefined;
589
- url?: string | undefined;
590
589
  text?: string | undefined;
590
+ url?: string | undefined;
591
+ version?: string | undefined;
591
592
  } | undefined;
592
593
  customFields?: {
593
- name: string;
594
594
  type: "text" | "textarea" | "checkbox" | "select";
595
595
  required: boolean;
596
596
  label: string;
597
+ name: string;
597
598
  options?: {
598
599
  value: string;
599
600
  label: string;
@@ -615,16 +616,16 @@ export declare const consentConfigSchema: z.ZodObject<{
615
616
  theme?: "light" | "dark" | "auto" | undefined;
616
617
  } | undefined;
617
618
  terms?: {
618
- version?: string | undefined;
619
- url?: string | undefined;
620
619
  text?: string | undefined;
620
+ url?: string | undefined;
621
+ version?: string | undefined;
621
622
  required?: boolean | undefined;
622
623
  } | undefined;
623
624
  customFields?: {
624
- name: string;
625
625
  type: "text" | "textarea" | "checkbox" | "select";
626
626
  required: boolean;
627
627
  label: string;
628
+ name: string;
628
629
  options?: {
629
630
  value: string;
630
631
  label: string;
@@ -650,11 +651,11 @@ export type ConsentConfig = z.infer<typeof consentConfigSchema>;
650
651
  * @returns Validation result
651
652
  */
652
653
  export declare function validateConsentPageConfig(config: unknown): z.SafeParseReturnType<{
653
- agentDid: string;
654
- sessionId: string;
655
654
  tool: string;
656
655
  toolDescription: string;
657
656
  scopes: string[];
657
+ agentDid: string;
658
+ sessionId: string;
658
659
  projectId: string;
659
660
  serverUrl: string;
660
661
  branding?: {
@@ -664,16 +665,16 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
664
665
  theme?: "light" | "dark" | "auto" | undefined;
665
666
  } | undefined;
666
667
  terms?: {
667
- version?: string | undefined;
668
- url?: string | undefined;
669
668
  text?: string | undefined;
669
+ url?: string | undefined;
670
+ version?: string | undefined;
670
671
  required?: boolean | undefined;
671
672
  } | undefined;
672
673
  customFields?: {
673
- name: string;
674
674
  type: "text" | "textarea" | "checkbox" | "select";
675
675
  required: boolean;
676
676
  label: string;
677
+ name: string;
677
678
  options?: {
678
679
  value: string;
679
680
  label: string;
@@ -683,11 +684,11 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
683
684
  }[] | undefined;
684
685
  autoClose?: boolean | undefined;
685
686
  }, {
686
- agentDid: string;
687
- sessionId: string;
688
687
  tool: string;
689
688
  toolDescription: string;
690
689
  scopes: string[];
690
+ agentDid: string;
691
+ sessionId: string;
691
692
  projectId: string;
692
693
  serverUrl: string;
693
694
  branding?: {
@@ -698,15 +699,15 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
698
699
  } | undefined;
699
700
  terms?: {
700
701
  required: boolean;
701
- version?: string | undefined;
702
- url?: string | undefined;
703
702
  text?: string | undefined;
703
+ url?: string | undefined;
704
+ version?: string | undefined;
704
705
  } | undefined;
705
706
  customFields?: {
706
- name: string;
707
707
  type: "text" | "textarea" | "checkbox" | "select";
708
708
  required: boolean;
709
709
  label: string;
710
+ name: string;
710
711
  options?: {
711
712
  value: string;
712
713
  label: string;
@@ -736,7 +737,7 @@ export declare function validateConsentApprovalRequest(request: unknown): z.Safe
736
737
  subject: string;
737
738
  name?: string | undefined;
738
739
  email?: string | undefined;
739
- } | undefined;
740
+ } | null | undefined;
740
741
  user_did?: string | undefined;
741
742
  }, {
742
743
  tool: string;
@@ -752,7 +753,7 @@ export declare function validateConsentApprovalRequest(request: unknown): z.Safe
752
753
  subject: string;
753
754
  name?: string | undefined;
754
755
  email?: string | undefined;
755
- } | undefined;
756
+ } | null | undefined;
756
757
  user_did?: string | undefined;
757
758
  }>;
758
759
  /**
@@ -788,16 +789,16 @@ export declare function validateConsentConfig(config: unknown): z.SafeParseRetur
788
789
  theme?: "light" | "dark" | "auto" | undefined;
789
790
  } | undefined;
790
791
  terms?: {
791
- version?: string | undefined;
792
- url?: string | undefined;
793
792
  text?: string | undefined;
793
+ url?: string | undefined;
794
+ version?: string | undefined;
794
795
  required?: boolean | undefined;
795
796
  } | undefined;
796
797
  customFields?: {
797
- name: string;
798
798
  type: "text" | "textarea" | "checkbox" | "select";
799
799
  required: boolean;
800
800
  label: string;
801
+ name: string;
801
802
  options?: {
802
803
  value: string;
803
804
  label: string;
@@ -820,15 +821,15 @@ export declare function validateConsentConfig(config: unknown): z.SafeParseRetur
820
821
  } | undefined;
821
822
  terms?: {
822
823
  required: boolean;
823
- version?: string | undefined;
824
- url?: string | undefined;
825
824
  text?: string | undefined;
825
+ url?: string | undefined;
826
+ version?: string | undefined;
826
827
  } | undefined;
827
828
  customFields?: {
828
- name: string;
829
829
  type: "text" | "textarea" | "checkbox" | "select";
830
830
  required: boolean;
831
831
  label: string;
832
+ name: string;
832
833
  options?: {
833
834
  value: string;
834
835
  label: string;
@@ -150,10 +150,11 @@ exports.consentApprovalRequestSchema = zod_1.z.object({
150
150
  .optional(),
151
151
  // Phase 4: OAuth identity linking
152
152
  /**
153
- * OAuth provider identity information (optional)
153
+ * OAuth provider identity information (optional, can be null)
154
154
  * Used to link OAuth accounts to persistent User DIDs
155
+ * Can be null when OAuth is not configured or user hasn't authenticated
155
156
  */
156
- oauth_identity: exports.oauthIdentitySchema.optional(),
157
+ oauth_identity: exports.oauthIdentitySchema.nullish(),
157
158
  /**
158
159
  * User DID (optional)
159
160
  * If provided, represents the persistent User DID for this user
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kya-os/contracts",
3
- "version": "1.5.3",
3
+ "version": "1.5.4-canary.2",
4
4
  "description": "Shared types and schemas for XMCP-I ecosystem",
5
5
  "type": "commonjs",
6
6
  "sideEffects": false,