@kya-os/contracts 1.6.2-canary.0 → 1.6.3-canary.0

package/dist/consent/schemas.d.ts

@@ -38,13 +38,13 @@ export declare const consentTermsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     required: boolean;
     version?: string | undefined;
-    url?: string | undefined;
     text?: string | undefined;
-}, {
-    version?: string | undefined;
     url?: string | undefined;
+}, {
     required?: boolean | undefined;
+    version?: string | undefined;
     text?: string | undefined;
+    url?: string | undefined;
 }>;
 export type ConsentTerms = z.infer<typeof consentTermsSchema>;
 /**
@@ -82,8 +82,8 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
     pattern: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "text" | "textarea" | "checkbox" | "select";
-    name: string;
     required: boolean;
+    name: string;
     label: string;
     options?: {
         value: string;
@@ -93,8 +93,8 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
     pattern?: string | undefined;
 }, {
     type: "text" | "textarea" | "checkbox" | "select";
-    name: string;
     required: boolean;
+    name: string;
     label: string;
     options?: {
         value: string;
@@ -104,8 +104,8 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
     pattern?: string | undefined;
 }>, {
     type: "text" | "textarea" | "checkbox" | "select";
-    name: string;
     required: boolean;
+    name: string;
     label: string;
     options?: {
         value: string;
@@ -115,8 +115,8 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
     pattern?: string | undefined;
 }, {
     type: "text" | "textarea" | "checkbox" | "select";
-    name: string;
     required: boolean;
+    name: string;
     label: string;
     options?: {
         value: string;
@@ -151,13 +151,13 @@ export declare const oauthIdentitySchema: z.ZodObject<{
      */
     name: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    subject: string;
     provider: string;
+    subject: string;
     name?: string | undefined;
     email?: string | undefined;
 }, {
-    subject: string;
     provider: string;
+    subject: string;
     name?: string | undefined;
     email?: string | undefined;
 }>;
@@ -165,13 +165,14 @@ export type OAuthIdentity = z.infer<typeof oauthIdentitySchema>;
 /**
  * Consent Page Config Schema
  */
-export declare const consentPageConfigSchema: z.ZodObject<{
+export declare const consentPageConfigSchema: z.ZodEffects<z.ZodObject<{
     tool: z.ZodString;
     toolDescription: z.ZodString;
     scopes: z.ZodArray<z.ZodString, "many">;
     agentDid: z.ZodString;
     sessionId: z.ZodString;
     projectId: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
     branding: z.ZodOptional<z.ZodObject<{
         primaryColor: z.ZodOptional<z.ZodString>;
         logoUrl: z.ZodOptional<z.ZodString>;
@@ -196,13 +197,13 @@ export declare const consentPageConfigSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         required: boolean;
         version?: string | undefined;
-        url?: string | undefined;
         text?: string | undefined;
-    }, {
-        version?: string | undefined;
         url?: string | undefined;
+    }, {
         required?: boolean | undefined;
+        version?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     }>>;
     customFields: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
         name: z.ZodString;
@@ -223,8 +224,8 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -234,8 +235,8 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }, {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -245,8 +246,8 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }>, {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -256,8 +257,8 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }, {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -268,14 +269,25 @@ export declare const consentPageConfigSchema: z.ZodObject<{
     }>, "many">>;
     serverUrl: z.ZodString;
     autoClose: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Whether OAuth authorization is required immediately
+     * If true, the consent page will act as a landing page before redirecting
+     */
+    oauthRequired: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * The OAuth authorization URL to redirect to
+     * Required if oauthRequired is true
+     */
+    oauthUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>;
 }, "strip", z.ZodTypeAny, {
-    agentDid: string;
+    scopes: string[];
     sessionId: string;
+    agentDid: string;
     tool: string;
-    scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
+    provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logoUrl?: string | undefined;
@@ -285,13 +297,13 @@ export declare const consentPageConfigSchema: z.ZodObject<{
     terms?: {
         required: boolean;
         version?: string | undefined;
-        url?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -301,14 +313,53 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }[] | undefined;
     autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
 }, {
-    agentDid: string;
+    scopes: string[];
     sessionId: string;
+    agentDid: string;
     tool: string;
-    scopes: string[];
     projectId: string;
+    serverUrl: string;
     toolDescription: string;
+    provider?: string | undefined;
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    terms?: {
+        required?: boolean | undefined;
+        version?: string | undefined;
+        text?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "textarea" | "checkbox" | "select";
+        required: boolean;
+        name: string;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
+}>, {
+    scopes: string[];
+    sessionId: string;
+    agentDid: string;
+    tool: string;
+    projectId: string;
     serverUrl: string;
+    toolDescription: string;
+    provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logoUrl?: string | undefined;
@@ -316,15 +367,51 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         theme?: "light" | "dark" | "auto" | undefined;
     } | undefined;
     terms?: {
+        required: boolean;
         version?: string | undefined;
+        text?: string | undefined;
         url?: string | undefined;
+    } | undefined;
+    customFields?: {
+        type: "text" | "textarea" | "checkbox" | "select";
+        required: boolean;
+        name: string;
+        label: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        placeholder?: string | undefined;
+        pattern?: string | undefined;
+    }[] | undefined;
+    autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
+}, {
+    scopes: string[];
+    sessionId: string;
+    agentDid: string;
+    tool: string;
+    projectId: string;
+    serverUrl: string;
+    toolDescription: string;
+    provider?: string | undefined;
+    branding?: {
+        primaryColor?: string | undefined;
+        logoUrl?: string | undefined;
+        companyName?: string | undefined;
+        theme?: "light" | "dark" | "auto" | undefined;
+    } | undefined;
+    terms?: {
         required?: boolean | undefined;
+        version?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -334,6 +421,8 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }[] | undefined;
     autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
 }>;
 export type ConsentPageConfig = z.infer<typeof consentPageConfigSchema>;
 /**
@@ -380,13 +469,13 @@ export declare const consentApprovalRequestSchema: z.ZodObject<{
          */
         name: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        subject: string;
         provider: string;
+        subject: string;
         name?: string | undefined;
         email?: string | undefined;
     }, {
-        subject: string;
         provider: string;
+        subject: string;
         name?: string | undefined;
         email?: string | undefined;
     }>>>;
@@ -397,33 +486,33 @@ export declare const consentApprovalRequestSchema: z.ZodObject<{
      */
     user_did: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    tool: string;
-    session_id: string;
     scopes: string[];
+    session_id: string;
+    tool: string;
+    termsAccepted: boolean;
     agent_did: string;
     project_id: string;
-    termsAccepted: boolean;
     customFields?: Record<string, string | boolean> | undefined;
     termsVersion?: string | undefined;
     oauth_identity?: {
-        subject: string;
         provider: string;
+        subject: string;
         name?: string | undefined;
         email?: string | undefined;
     } | null | undefined;
     user_did?: string | undefined;
 }, {
-    tool: string;
-    session_id: string;
     scopes: string[];
+    session_id: string;
+    tool: string;
+    termsAccepted: boolean;
     agent_did: string;
     project_id: string;
-    termsAccepted: boolean;
     customFields?: Record<string, string | boolean> | undefined;
     termsVersion?: string | undefined;
     oauth_identity?: {
-        subject: string;
         provider: string;
+        subject: string;
         name?: string | undefined;
         email?: string | undefined;
     } | null | undefined;
@@ -493,13 +582,13 @@ export declare const consentConfigSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         required: boolean;
         version?: string | undefined;
-        url?: string | undefined;
         text?: string | undefined;
-    }, {
-        version?: string | undefined;
         url?: string | undefined;
+    }, {
         required?: boolean | undefined;
+        version?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     }>>;
     customFields: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
         name: z.ZodString;
@@ -520,8 +609,8 @@ export declare const consentConfigSchema: z.ZodObject<{
         pattern: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -531,8 +620,8 @@ export declare const consentConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }, {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -542,8 +631,8 @@ export declare const consentConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }>, {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -553,8 +642,8 @@ export declare const consentConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }, {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -589,13 +678,13 @@ export declare const consentConfigSchema: z.ZodObject<{
     terms?: {
         required: boolean;
         version?: string | undefined;
-        url?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -618,15 +707,15 @@ export declare const consentConfigSchema: z.ZodObject<{
         theme?: "light" | "dark" | "auto" | undefined;
     } | undefined;
     terms?: {
-        version?: string | undefined;
-        url?: string | undefined;
         required?: boolean | undefined;
+        version?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -653,13 +742,14 @@ export type ConsentConfig = z.infer<typeof consentConfigSchema>;
  * @returns Validation result
  */
 export declare function validateConsentPageConfig(config: unknown): z.SafeParseReturnType<{
-    agentDid: string;
+    scopes: string[];
     sessionId: string;
+    agentDid: string;
     tool: string;
-    scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
+    provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logoUrl?: string | undefined;
@@ -667,15 +757,15 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
         theme?: "light" | "dark" | "auto" | undefined;
     } | undefined;
     terms?: {
-        version?: string | undefined;
-        url?: string | undefined;
         required?: boolean | undefined;
+        version?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -685,14 +775,17 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
         pattern?: string | undefined;
     }[] | undefined;
     autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
 }, {
-    agentDid: string;
+    scopes: string[];
     sessionId: string;
+    agentDid: string;
     tool: string;
-    scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
+    provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logoUrl?: string | undefined;
@@ -702,13 +795,13 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
     terms?: {
         required: boolean;
         version?: string | undefined;
-        url?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -718,6 +811,8 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
         pattern?: string | undefined;
     }[] | undefined;
     autoClose?: boolean | undefined;
+    oauthRequired?: boolean | undefined;
+    oauthUrl?: string | undefined;
 }>;
 /**
  * Validate a consent approval request
@@ -726,33 +821,33 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
  * @returns Validation result
  */
 export declare function validateConsentApprovalRequest(request: unknown): z.SafeParseReturnType<{
-    tool: string;
-    session_id: string;
     scopes: string[];
+    session_id: string;
+    tool: string;
+    termsAccepted: boolean;
     agent_did: string;
     project_id: string;
-    termsAccepted: boolean;
     customFields?: Record<string, string | boolean> | undefined;
     termsVersion?: string | undefined;
     oauth_identity?: {
-        subject: string;
         provider: string;
+        subject: string;
         name?: string | undefined;
         email?: string | undefined;
     } | null | undefined;
     user_did?: string | undefined;
 }, {
-    tool: string;
-    session_id: string;
     scopes: string[];
+    session_id: string;
+    tool: string;
+    termsAccepted: boolean;
     agent_did: string;
     project_id: string;
-    termsAccepted: boolean;
     customFields?: Record<string, string | boolean> | undefined;
     termsVersion?: string | undefined;
     oauth_identity?: {
-        subject: string;
         provider: string;
+        subject: string;
         name?: string | undefined;
         email?: string | undefined;
     } | null | undefined;
@@ -791,15 +886,15 @@ export declare function validateConsentConfig(config: unknown): z.SafeParseRetur
         theme?: "light" | "dark" | "auto" | undefined;
     } | undefined;
     terms?: {
-        version?: string | undefined;
-        url?: string | undefined;
         required?: boolean | undefined;
+        version?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;
@@ -824,13 +919,13 @@ export declare function validateConsentConfig(config: unknown): z.SafeParseRetur
     terms?: {
         required: boolean;
         version?: string | undefined;
-        url?: string | undefined;
         text?: string | undefined;
+        url?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
-        name: string;
         required: boolean;
+        name: string;
         label: string;
         options?: {
             value: string;

package/dist/consent/schemas.js

@@ -132,7 +132,8 @@ exports.oauthIdentitySchema = zod_1.z.object({
 /**
  * Consent Page Config Schema
  */
-exports.consentPageConfigSchema = zod_1.z.object({
+exports.consentPageConfigSchema = zod_1.z
+    .object({
     tool: zod_1.z.string().min(1, "Tool name is required"),
     toolDescription: zod_1.z
         .string()
@@ -141,6 +142,7 @@ exports.consentPageConfigSchema = zod_1.z.object({
     agentDid: zod_1.z.string().min(1, "Agent DID is required"),
     sessionId: zod_1.z.string().min(1, "Session ID is required"),
     projectId: zod_1.z.string().min(1, "Project ID is required"),
+    provider: zod_1.z.string().optional(), // Phase 2: OAuth provider name (e.g., "github", "google")
     branding: exports.consentBrandingSchema.optional(),
     terms: exports.consentTermsSchema.optional(),
     customFields: zod_1.z
@@ -149,6 +151,42 @@ exports.consentPageConfigSchema = zod_1.z.object({
         .optional(),
     serverUrl: zod_1.z.string().url("Server URL must be a valid URL"),
     autoClose: zod_1.z.boolean().optional(),
+    /**
+     * Whether OAuth authorization is required immediately
+     * If true, the consent page will act as a landing page before redirecting
+     */
+    oauthRequired: zod_1.z.boolean().optional(),
+    /**
+     * The OAuth authorization URL to redirect to
+     * Required if oauthRequired is true
+     */
+    oauthUrl: zod_1.z
+        .union([
+        zod_1.z.string().url(),
+        zod_1.z.literal(""), // Allow empty string to catch it in refine with better error
+    ])
+        .optional(),
+})
+    .superRefine((data, ctx) => {
+    // If oauthRequired is true, oauthUrl must be provided and non-empty
+    if (data.oauthRequired === true) {
+        if (data.oauthUrl === undefined || data.oauthUrl === "") {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: "oauthUrl is required when oauthRequired is true",
+                path: ["oauthUrl"],
+            });
+            return;
+        }
+    }
+    // If oauthUrl is provided (not undefined), it must be a valid URL (not empty)
+    if (data.oauthUrl !== undefined && data.oauthUrl === "") {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "oauthUrl must be a valid URL",
+            path: ["oauthUrl"],
+        });
+    }
 });
 /**
  * Consent Approval Request Schema

package/dist/dashboard-config/index.d.ts

@@ -5,6 +5,6 @@
  *
  * @package @kya-os/contracts/dashboard-config
  */
-export type { MCPIServerConfig, GetServerConfigRequest, GetServerConfigResponse, UpdateServerConfigRequest, UpdateServerConfigResponse, ValidateServerConfigRequest, ValidateServerConfigResponse, } from './types.js';
-export { identityConfigSchema, proofingConfigSchema, delegationConfigSchema, toolProtectionConfigSchema, auditConfigSchema, sessionConfigSchema, platformConfigSchema, cloudflarePlatformConfigSchema, nodePlatformConfigSchema, vercelPlatformConfigSchema, configMetadataSchema, mcpIServerConfigSchema, getServerConfigRequestSchema, getServerConfigResponseSchema, updateServerConfigRequestSchema, updateServerConfigResponseSchema, validateServerConfigRequestSchema, validateServerConfigResponseSchema, } from './schemas.js';
+export type { MCPIServerConfig, MergedMCPIServerConfig, GetServerConfigRequest, GetServerConfigResponse, GetMergedServerConfigResponse, UpdateServerConfigRequest, UpdateServerConfigResponse, ValidateServerConfigRequest, ValidateServerConfigResponse, } from './types.js';
+export { identityConfigSchema, proofingConfigSchema, delegationConfigSchema, toolProtectionConfigSchema, mergedToolProtectionConfigSchema, auditConfigSchema, sessionConfigSchema, platformConfigSchema, cloudflarePlatformConfigSchema, nodePlatformConfigSchema, vercelPlatformConfigSchema, configMetadataSchema, mcpIServerConfigSchema, mergedMcpIServerConfigSchema, getServerConfigRequestSchema, getServerConfigResponseSchema, getMergedServerConfigResponseSchema, updateServerConfigRequestSchema, updateServerConfigResponseSchema, validateServerConfigRequestSchema, validateServerConfigResponseSchema, } from './schemas.js';
 export { defaultConfig, getDefaultConfigForPlatform, mergeWithDefaults, } from './default-config.js';