@kya-os/contracts 1.5.3-canary.4 → 1.5.3-canary.5

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.
@@ -6,7 +6,7 @@
6
6
  *
7
7
  * Related Spec: MCP-I Phase 0 Implementation Plan
8
8
  */
9
- import { z } from 'zod';
9
+ import { z } from "zod";
10
10
  /**
11
11
  * Consent Branding Schema
12
12
  */
@@ -20,58 +20,79 @@ const zod_1 = require("zod");
20
20
  exports.consentBrandingSchema = zod_1.z.object({
21
21
  primaryColor: zod_1.z
22
22
  .string()
23
- .regex(/^#[0-9A-Fa-f]{6}$/, 'Must be a valid hex color (e.g., #0066CC)')
23
+ .regex(/^#[0-9A-Fa-f]{6}$/, "Must be a valid hex color (e.g., #0066CC)")
24
24
  .optional(),
25
- logoUrl: zod_1.z.string().url('Must be a valid URL').optional(),
26
- companyName: zod_1.z.string().max(100, 'Company name must be 100 characters or less').optional(),
27
- theme: zod_1.z.enum(['light', 'dark', 'auto']).optional(),
25
+ logoUrl: zod_1.z.string().url("Must be a valid URL").optional(),
26
+ companyName: zod_1.z
27
+ .string()
28
+ .max(100, "Company name must be 100 characters or less")
29
+ .optional(),
30
+ theme: zod_1.z.enum(["light", "dark", "auto"]).optional(),
28
31
  });
29
32
  /**
30
33
  * Consent Terms Schema
31
34
  */
32
35
  exports.consentTermsSchema = zod_1.z.object({
33
- text: zod_1.z.string().max(10000, 'Terms text must be 10000 characters or less').optional(),
34
- url: zod_1.z.string().url('Must be a valid URL').optional(),
35
- version: zod_1.z.string().max(50, 'Version must be 50 characters or less').optional(),
36
+ text: zod_1.z
37
+ .string()
38
+ .max(10000, "Terms text must be 10000 characters or less")
39
+ .optional(),
40
+ url: zod_1.z.string().url("Must be a valid URL").optional(),
41
+ version: zod_1.z
42
+ .string()
43
+ .max(50, "Version must be 50 characters or less")
44
+ .optional(),
36
45
  required: zod_1.z.boolean().default(true),
37
46
  });
38
47
  /**
39
48
  * Consent Custom Field Option Schema
40
49
  */
41
50
  exports.consentCustomFieldOptionSchema = zod_1.z.object({
42
- value: zod_1.z.string().max(100, 'Option value must be 100 characters or less'),
43
- label: zod_1.z.string().max(100, 'Option label must be 100 characters or less'),
51
+ value: zod_1.z.string().max(100, "Option value must be 100 characters or less"),
52
+ label: zod_1.z.string().max(100, "Option label must be 100 characters or less"),
44
53
  });
45
54
  /**
46
55
  * Consent Custom Field Schema
47
56
  */
48
- exports.consentCustomFieldSchema = zod_1.z.object({
57
+ exports.consentCustomFieldSchema = zod_1.z
58
+ .object({
49
59
  name: zod_1.z
50
60
  .string()
51
- .min(1, 'Field name is required')
52
- .max(50, 'Field name must be 50 characters or less')
53
- .regex(/^[a-zA-Z0-9_]+$/, 'Field name must contain only letters, numbers, and underscores'),
54
- label: zod_1.z.string().min(1, 'Field label is required').max(100, 'Field label must be 100 characters or less'),
55
- type: zod_1.z.enum(['text', 'textarea', 'checkbox', 'select']),
61
+ .min(1, "Field name is required")
62
+ .max(50, "Field name must be 50 characters or less")
63
+ .regex(/^[a-zA-Z0-9_]+$/, "Field name must contain only letters, numbers, and underscores"),
64
+ label: zod_1.z
65
+ .string()
66
+ .min(1, "Field label is required")
67
+ .max(100, "Field label must be 100 characters or less"),
68
+ type: zod_1.z.enum(["text", "textarea", "checkbox", "select"]),
56
69
  required: zod_1.z.boolean(),
57
- placeholder: zod_1.z.string().max(200, 'Placeholder must be 200 characters or less').optional(),
70
+ placeholder: zod_1.z
71
+ .string()
72
+ .max(200, "Placeholder must be 200 characters or less")
73
+ .optional(),
58
74
  options: zod_1.z
59
75
  .array(exports.consentCustomFieldOptionSchema)
60
- .min(1, 'Select fields must have at least one option')
76
+ .min(1, "Select fields must have at least one option")
77
+ .optional(),
78
+ pattern: zod_1.z
79
+ .string()
80
+ .max(500, "Pattern must be 500 characters or less")
61
81
  .optional(),
62
- pattern: zod_1.z.string().max(500, 'Pattern must be 500 characters or less').optional(),
63
- }).refine((data) => {
82
+ })
83
+ .refine((data) => {
64
84
  // Select fields must have options
65
- if (data.type === 'select' && (!data.options || data.options.length === 0)) {
85
+ if (data.type === "select" &&
86
+ (!data.options || data.options.length === 0)) {
66
87
  return false;
67
88
  }
68
89
  // Non-select fields should not have options
69
- if (data.type !== 'select' && data.options) {
90
+ if (data.type !== "select" && data.options) {
70
91
  return false;
71
92
  }
72
93
  return true;
73
94
  }, {
74
- message: 'Select fields must have options, and non-select fields must not have options',
95
+ message: "Select fields must have options, and non-select fields must not have options",
75
96
  });
76
97
  /**
77
98
  * OAuth Identity Schema
@@ -83,47 +104,50 @@ exports.oauthIdentitySchema = zod_1.z.object({
83
104
  /**
84
105
  * OAuth provider name (e.g., "google", "github", "microsoft")
85
106
  */
86
- provider: zod_1.z.string()
87
- .min(1, 'Provider is required')
88
- .max(50, 'Provider name must be 50 characters or less'),
107
+ provider: zod_1.z
108
+ .string()
109
+ .min(1, "Provider is required")
110
+ .max(50, "Provider name must be 50 characters or less"),
89
111
  /**
90
112
  * OAuth subject identifier (unique user ID from provider)
91
113
  * @example "123456789" (Google), "github-user-id" (GitHub)
92
114
  */
93
- subject: zod_1.z.string()
94
- .min(1, 'Subject is required')
95
- .max(255, 'Subject must be 255 characters or less'),
115
+ subject: zod_1.z
116
+ .string()
117
+ .min(1, "Subject is required")
118
+ .max(255, "Subject must be 255 characters or less"),
96
119
  /**
97
120
  * User's email address from OAuth provider (optional)
98
121
  */
99
- email: zod_1.z.string()
100
- .email('Must be a valid email address')
101
- .max(255, 'Email must be 255 characters or less')
122
+ email: zod_1.z
123
+ .string()
124
+ .email("Must be a valid email address")
125
+ .max(255, "Email must be 255 characters or less")
102
126
  .optional(),
103
127
  /**
104
128
  * User's display name from OAuth provider (optional)
105
129
  */
106
- name: zod_1.z.string()
107
- .max(255, 'Name must be 255 characters or less')
108
- .optional(),
130
+ name: zod_1.z.string().max(255, "Name must be 255 characters or less").optional(),
109
131
  });
110
132
  /**
111
133
  * Consent Page Config Schema
112
134
  */
113
135
  exports.consentPageConfigSchema = zod_1.z.object({
114
- tool: zod_1.z.string().min(1, 'Tool name is required'),
115
- toolDescription: zod_1.z.string().max(500, 'Tool description must be 500 characters or less'),
116
- scopes: zod_1.z.array(zod_1.z.string()).min(0, 'Scopes array cannot be negative'),
117
- agentDid: zod_1.z.string().min(1, 'Agent DID is required'),
118
- sessionId: zod_1.z.string().min(1, 'Session ID is required'),
119
- projectId: zod_1.z.string().min(1, 'Project ID is required'),
136
+ tool: zod_1.z.string().min(1, "Tool name is required"),
137
+ toolDescription: zod_1.z
138
+ .string()
139
+ .max(500, "Tool description must be 500 characters or less"),
140
+ scopes: zod_1.z.array(zod_1.z.string()).min(0, "Scopes array cannot be negative"),
141
+ agentDid: zod_1.z.string().min(1, "Agent DID is required"),
142
+ sessionId: zod_1.z.string().min(1, "Session ID is required"),
143
+ projectId: zod_1.z.string().min(1, "Project ID is required"),
120
144
  branding: exports.consentBrandingSchema.optional(),
121
145
  terms: exports.consentTermsSchema.optional(),
122
146
  customFields: zod_1.z
123
147
  .array(exports.consentCustomFieldSchema)
124
- .max(10, 'Maximum 10 custom fields allowed')
148
+ .max(10, "Maximum 10 custom fields allowed")
125
149
  .optional(),
126
- serverUrl: zod_1.z.string().url('Server URL must be a valid URL'),
150
+ serverUrl: zod_1.z.string().url("Server URL must be a valid URL"),
127
151
  autoClose: zod_1.z.boolean().optional(),
128
152
  });
129
153
  /**
@@ -136,18 +160,17 @@ exports.consentPageConfigSchema = zod_1.z.object({
136
160
  * - user_did: Optional User DID for persistent identity (if already known)
137
161
  */
138
162
  exports.consentApprovalRequestSchema = zod_1.z.object({
139
- tool: zod_1.z.string().min(1, 'Tool name is required'),
140
- scopes: zod_1.z.array(zod_1.z.string()).min(0, 'Scopes array cannot be negative'),
141
- agent_did: zod_1.z.string().min(1, 'Agent DID is required'),
142
- session_id: zod_1.z.string().min(1, 'Session ID is required'),
143
- project_id: zod_1.z.string().min(1, 'Project ID is required'),
163
+ tool: zod_1.z.string().min(1, "Tool name is required"),
164
+ scopes: zod_1.z.array(zod_1.z.string()).min(0, "Scopes array cannot be negative"),
165
+ agent_did: zod_1.z.string().min(1, "Agent DID is required"),
166
+ session_id: zod_1.z.string().min(1, "Session ID is required"),
167
+ project_id: zod_1.z.string().min(1, "Project ID is required"),
144
168
  termsAccepted: zod_1.z.boolean(),
145
- termsVersion: zod_1.z.string()
146
- .max(50, 'Terms version must be 50 characters or less')
147
- .optional(),
148
- customFields: zod_1.z
149
- .record(zod_1.z.union([zod_1.z.string(), zod_1.z.boolean()]))
169
+ termsVersion: zod_1.z
170
+ .string()
171
+ .max(50, "Terms version must be 50 characters or less")
150
172
  .optional(),
173
+ customFields: zod_1.z.record(zod_1.z.union([zod_1.z.string(), zod_1.z.boolean()])).optional(),
151
174
  // Phase 4: OAuth identity linking
152
175
  /**
153
176
  * OAuth provider identity information (optional)
@@ -162,21 +185,24 @@ exports.consentApprovalRequestSchema = zod_1.z.object({
162
185
  * If provided, represents the persistent User DID for this user
163
186
  * Format: did:key:... or did:web:...
164
187
  */
165
- user_did: zod_1.z.string()
166
- .regex(/^did:/, 'Must be a valid DID format (starting with did:)')
167
- .max(500, 'DID must be 500 characters or less')
188
+ user_did: zod_1.z
189
+ .string()
190
+ .regex(/^did:/, "Must be a valid DID format (starting with did:)")
191
+ .max(500, "DID must be 500 characters or less")
168
192
  .optional(),
169
193
  });
170
194
  /**
171
195
  * Consent Approval Response Schema
172
196
  */
173
- exports.consentApprovalResponseSchema = zod_1.z.object({
197
+ exports.consentApprovalResponseSchema = zod_1.z
198
+ .object({
174
199
  success: zod_1.z.boolean(),
175
200
  delegation_id: zod_1.z.string().min(1).optional(),
176
201
  delegation_token: zod_1.z.string().min(1).optional(),
177
202
  error: zod_1.z.string().optional(),
178
203
  error_code: zod_1.z.string().optional(),
179
- }).refine((data) => {
204
+ })
205
+ .refine((data) => {
180
206
  // If success is true, must have delegation_id and delegation_token
181
207
  if (data.success) {
182
208
  return !!data.delegation_id && !!data.delegation_token;
@@ -184,7 +210,7 @@ exports.consentApprovalResponseSchema = zod_1.z.object({
184
210
  // If success is false, must have error or error_code
185
211
  return !!data.error || !!data.error_code;
186
212
  }, {
187
- message: 'Successful responses must include delegation_id and delegation_token. Failed responses must include error or error_code',
213
+ message: "Successful responses must include delegation_id and delegation_token. Failed responses must include error or error_code",
188
214
  });
189
215
  /**
190
216
  * Consent Config Schema
@@ -194,14 +220,21 @@ exports.consentConfigSchema = zod_1.z.object({
194
220
  terms: exports.consentTermsSchema.optional(),
195
221
  customFields: zod_1.z
196
222
  .array(exports.consentCustomFieldSchema)
197
- .max(10, 'Maximum 10 custom fields allowed')
223
+ .max(10, "Maximum 10 custom fields allowed")
198
224
  .optional(),
199
- ui: zod_1.z.object({
200
- theme: zod_1.z.enum(['light', 'dark', 'auto']).optional(),
225
+ ui: zod_1.z
226
+ .object({
227
+ theme: zod_1.z.enum(["light", "dark", "auto"]).optional(),
201
228
  popupEnabled: zod_1.z.boolean().optional(),
202
229
  autoClose: zod_1.z.boolean().optional(),
203
- autoCloseDelay: zod_1.z.number().int().positive().max(60000, 'Auto-close delay must be 60000ms or less').optional(),
204
- }).optional(),
230
+ autoCloseDelay: zod_1.z
231
+ .number()
232
+ .int()
233
+ .positive()
234
+ .max(60000, "Auto-close delay must be 60000ms or less")
235
+ .optional(),
236
+ })
237
+ .optional(),
205
238
  });
206
239
  /**
207
240
  * Validation Helpers
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kya-os/contracts",
3
- "version": "1.5.3-canary.4",
3
+ "version": "1.5.3-canary.5",
4
4
  "description": "Shared types and schemas for XMCP-I ecosystem",
5
5
  "type": "commonjs",
6
6
  "sideEffects": false,