@kya-os/contracts 1.5.2-canary.3 → 1.5.2-canary.5

package/dist/agentshield-api/schemas.js

@@ -37,25 +37,48 @@ exports.agentShieldAPIResponseSchema = agentShieldAPIResponseSchema;
 // ============================================================================
 // Proof Submission Schemas
 // ============================================================================
+/**
+ * Tool Call Context Schema (AgentShield Extension)
+ * Optional plaintext context for dashboard enrichment
+ */
+const toolCallContextSchema = zod_1.z.object({
+    tool: zod_1.z.string().min(1, "Tool name is required"),
+    args: zod_1.z.record(zod_1.z.unknown()),
+    result: zod_1.z.unknown().optional(),
+    scopeId: zod_1.z.string().min(1, "scopeId is required to link context to proof"),
+    userIdentifier: zod_1.z.string().optional(),
+});
 /**
  * Proof submission request schema
  */
 exports.proofSubmissionRequestSchema = zod_1.z.object({
-    delegation_id: zod_1.z.string().uuid().nullable(),
-    session_id: zod_1.z.string().uuid(),
+    session_id: zod_1.z.string().max(100), // AgentShield session ID (may differ from MCP-I sessionId)
+    delegation_id: zod_1.z.string().uuid().nullish(),
     proofs: zod_1.z.array(proof_js_1.DetachedProofSchema).min(1),
+    // AgentShield extension: Optional context for dashboard enrichment
+    context: zod_1.z
+        .object({
+        toolCalls: zod_1.z.array(toolCallContextSchema).optional(),
+        mcpServerUrl: zod_1.z.string().url().optional(), // MCP server URL for tool discovery
+    })
+        .optional(),
 });
 /**
  * Proof submission response schema
  */
 exports.proofSubmissionResponseSchema = zod_1.z.object({
     success: zod_1.z.boolean(),
-    received: zod_1.z.number().int().min(0),
-    processed: zod_1.z.number().int().min(0),
+    accepted: zod_1.z.number().int().min(0),
+    rejected: zod_1.z.number().int().min(0),
+    outcomes: zod_1.z.record(zod_1.z.string(), zod_1.z.number().int().min(0)), // Record<BouncerOutcome, number>
     errors: zod_1.z
         .array(zod_1.z.object({
-        proofId: zod_1.z.string(),
-        error: zod_1.z.string(),
+        proof_index: zod_1.z.number().int().min(0),
+        error: zod_1.z.object({
+            code: zod_1.z.string(),
+            message: zod_1.z.string(),
+            details: zod_1.z.record(zod_1.z.unknown()).optional(),
+        }),
     }))
         .optional(),
 });
@@ -79,7 +102,9 @@ exports.delegationCredentialSchema = zod_1.z.object({
  */
 exports.verifyDelegationRequestSchema = zod_1.z.object({
     agent_did: zod_1.z.string(),
-    scopes: zod_1.z.array(zod_1.z.string()).min(1),
+    credential_jwt: zod_1.z.string().optional(), // Optional, omit (don't set to empty string) when not available for OAuth flow
+    delegation_token: zod_1.z.string().optional(), // Optional, for stateless MCP servers
+    scopes: zod_1.z.array(zod_1.z.string()).optional(), // Optional, can be empty array
     timestamp: zod_1.z.number().int().positive().optional(),
     client_info: zod_1.z
         .object({
@@ -88,7 +113,7 @@ exports.verifyDelegationRequestSchema = zod_1.z.object({
         user_agent: zod_1.z.string().optional(),
     })
         .optional(),
-});
+}).partial({ scopes: true }); // Make scopes truly optional by using partial
 /**
  * Delegation verification response schema
  */
@@ -127,6 +152,14 @@ exports.toolProtectionConfigResponseSchema = zod_1.z.object({
     tools: zod_1.z.record(zod_1.z.string(), exports.agentShieldToolProtectionSchema),
     reputation_threshold: zod_1.z.number().min(0).max(1).optional(),
     denied_agents: zod_1.z.array(zod_1.z.string()).optional(),
+    crisp_budget: zod_1.z
+        .object({
+        max_tokens: zod_1.z.number(),
+        max_cost: zod_1.z.number(),
+        currency: zod_1.z.string(),
+        time_window: zod_1.z.string(),
+    })
+        .optional(),
 });
 /**
  * Wrapped config response schema

package/dist/agentshield-api/types.d.ts

@@ -28,28 +28,55 @@ export interface AgentShieldAPIErrorResponse {
     message: string;
     details?: Record<string, unknown>;
 }
+/**
+ * Tool Call Context (AgentShield Extension to MCP-I)
+ *
+ * Optional plaintext context for dashboard enrichment.
+ * Links to MCP-I proof via scopeId.
+ */
+export interface ToolCallContext {
+    tool: string;
+    args: Record<string, unknown>;
+    result?: unknown;
+    scopeId: string;
+    userIdentifier?: string;
+}
 /**
  * Request body for proof submission endpoint
  * POST /api/v1/bouncer/proofs
  */
 export interface ProofSubmissionRequest {
-    /** Delegation ID (null if no delegation context) */
-    delegation_id: string | null;
-    /** Session ID for grouping proofs */
+    /** Delegation ID (nullable, optional - null if no delegation context) */
+    delegation_id?: string | null;
+    /** Session ID for grouping proofs (AgentShield session ID, may differ from MCP-I sessionId) */
     session_id: string;
     /** Array of proofs to submit */
     proofs: DetachedProof[];
+    /** AgentShield extension: Optional context for dashboard enrichment */
+    context?: {
+        toolCalls?: ToolCallContext[];
+        mcpServerUrl?: string;
+    };
 }
+/**
+ * Bouncer outcome types
+ */
+export type BouncerOutcome = "success" | "failed" | "blocked" | "error";
 /**
  * Response from proof submission endpoint
  */
 export interface ProofSubmissionResponse {
     success: boolean;
-    received: number;
-    processed: number;
+    accepted: number;
+    rejected: number;
+    outcomes: Record<BouncerOutcome, number>;
     errors?: Array<{
-        proofId: string;
-        error: string;
+        proof_index: number;
+        error: {
+            code: string;
+            message: string;
+            details?: Record<string, unknown>;
+        };
     }>;
 }
 /**
@@ -59,8 +86,12 @@ export interface ProofSubmissionResponse {
 export interface VerifyDelegationRequest {
     /** Agent DID to verify */
     agent_did: string;
-    /** Required scopes */
-    scopes: string[];
+    /** Credential JWT (optional, defaults to empty string for OAuth flow) */
+    credential_jwt?: string;
+    /** Delegation token from OAuth flow (optional, for stateless MCP servers) */
+    delegation_token?: string;
+    /** Required scopes (optional, can be empty array) */
+    scopes?: string[];
     /** Optional timestamp for verification */
     timestamp?: number;
     /** Optional client info for IP/origin checking */
@@ -116,6 +147,12 @@ export interface ToolProtectionConfigResponse {
     tools: Record<string, AgentShieldToolProtection>;
     reputation_threshold?: number;
     denied_agents?: string[];
+    crisp_budget?: {
+        max_tokens: number;
+        max_cost: number;
+        currency: string;
+        time_window: string;
+    };
 }
 /**
  * Wrapped config response

package/dist/config/builder.d.ts

@@ -31,4 +31,3 @@ export interface MCPIConfig extends MCPIBaseConfig {
  * @returns Complete MCPIConfig object
  */
 export declare function buildBaseConfig(env: Record<string, any>): MCPIConfig;
-//# sourceMappingURL=builder.d.ts.map

package/dist/config/identity.d.ts

@@ -114,4 +114,3 @@ export interface AgentIdentity {
         [key: string]: unknown;
     };
 }
-//# sourceMappingURL=identity.d.ts.map

package/dist/config/identity.js

@@ -8,4 +8,3 @@
  * @module @kya-os/contracts/config
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=identity.js.map

package/dist/config/index.d.ts

@@ -32,4 +32,3 @@ export interface MCPIConfig extends MCPIBaseConfig {
     delegation?: DelegationConfig;
     toolProtection?: ToolProtectionSourceConfig;
 }
-//# sourceMappingURL=index.d.ts.map

package/dist/config/index.js

@@ -12,4 +12,3 @@ exports.buildBaseConfig = void 0;
 // Configuration builder utilities
 var builder_js_1 = require("./builder.js");
 Object.defineProperty(exports, "buildBaseConfig", { enumerable: true, get: function () { return builder_js_1.buildBaseConfig; } });
-//# sourceMappingURL=index.js.map

package/dist/consent/schemas.d.ts

@@ -37,14 +37,14 @@ export declare const consentTermsSchema: z.ZodObject<{
     required: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     required: boolean;
-    text?: string | undefined;
-    url?: string | undefined;
     version?: string | undefined;
-}, {
-    text?: string | undefined;
     url?: string | undefined;
+    text?: string | undefined;
+}, {
     version?: string | undefined;
+    url?: string | undefined;
     required?: boolean | undefined;
+    text?: string | undefined;
 }>;
 export type ConsentTerms = z.infer<typeof consentTermsSchema>;
 /**
@@ -82,9 +82,9 @@ 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;
     label: string;
-    name: string;
     options?: {
         value: string;
         label: string;
@@ -93,9 +93,9 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
     pattern?: string | undefined;
 }, {
     type: "text" | "textarea" | "checkbox" | "select";
+    name: string;
     required: boolean;
     label: string;
-    name: string;
     options?: {
         value: string;
         label: string;
@@ -104,9 +104,9 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
     pattern?: string | undefined;
 }>, {
     type: "text" | "textarea" | "checkbox" | "select";
+    name: string;
     required: boolean;
     label: string;
-    name: string;
     options?: {
         value: string;
         label: string;
@@ -115,9 +115,9 @@ export declare const consentCustomFieldSchema: z.ZodEffects<z.ZodObject<{
     pattern?: string | undefined;
 }, {
     type: "text" | "textarea" | "checkbox" | "select";
+    name: string;
     required: boolean;
     label: string;
-    name: string;
     options?: {
         value: string;
         label: string;
@@ -159,14 +159,14 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         required: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         required: boolean;
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
-    }, {
-        text?: string | undefined;
         url?: string | undefined;
+        text?: string | undefined;
+    }, {
         version?: string | undefined;
+        url?: string | undefined;
         required?: boolean | undefined;
+        text?: string | undefined;
     }>>;
     customFields: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
         name: z.ZodString;
@@ -187,9 +187,9 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -198,9 +198,9 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }, {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -209,9 +209,9 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }>, {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -220,9 +220,9 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }, {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -233,11 +233,11 @@ export declare const consentPageConfigSchema: z.ZodObject<{
     serverUrl: z.ZodString;
     autoClose: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    tool: string;
-    toolDescription: string;
-    scopes: string[];
     agentDid: string;
     sessionId: string;
+    tool: string;
+    scopes: string[];
+    toolDescription: string;
     projectId: string;
     serverUrl: string;
     branding?: {
@@ -248,15 +248,15 @@ export declare const consentPageConfigSchema: z.ZodObject<{
     } | undefined;
     terms?: {
         required: boolean;
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
+        url?: string | undefined;
+        text?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -266,11 +266,11 @@ export declare const consentPageConfigSchema: z.ZodObject<{
     }[] | undefined;
     autoClose?: boolean | undefined;
 }, {
-    tool: string;
-    toolDescription: string;
-    scopes: string[];
     agentDid: string;
     sessionId: string;
+    tool: string;
+    scopes: string[];
+    toolDescription: string;
     projectId: string;
     serverUrl: string;
     branding?: {
@@ -280,16 +280,16 @@ export declare const consentPageConfigSchema: z.ZodObject<{
         theme?: "light" | "dark" | "auto" | undefined;
     } | undefined;
     terms?: {
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
+        url?: string | undefined;
         required?: boolean | undefined;
+        text?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -316,18 +316,18 @@ export declare const consentApprovalRequestSchema: z.ZodObject<{
     customFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean]>>>;
 }, "strip", z.ZodTypeAny, {
     tool: string;
+    session_id: string;
     scopes: string[];
     agent_did: string;
-    session_id: string;
     project_id: string;
     termsAccepted: boolean;
     customFields?: Record<string, string | boolean> | undefined;
     termsVersion?: string | undefined;
 }, {
     tool: string;
+    session_id: string;
     scopes: string[];
     agent_did: string;
-    session_id: string;
     project_id: string;
     termsAccepted: boolean;
     customFields?: Record<string, string | boolean> | undefined;
@@ -345,27 +345,27 @@ export declare const consentApprovalResponseSchema: z.ZodEffects<z.ZodObject<{
     error_code: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     success: boolean;
+    error?: string | undefined;
     delegation_id?: string | undefined;
     delegation_token?: string | undefined;
-    error?: string | undefined;
     error_code?: string | undefined;
 }, {
     success: boolean;
+    error?: string | undefined;
     delegation_id?: string | undefined;
     delegation_token?: string | undefined;
-    error?: string | undefined;
     error_code?: string | undefined;
 }>, {
     success: boolean;
+    error?: string | undefined;
     delegation_id?: string | undefined;
     delegation_token?: string | undefined;
-    error?: string | undefined;
     error_code?: string | undefined;
 }, {
     success: boolean;
+    error?: string | undefined;
     delegation_id?: string | undefined;
     delegation_token?: string | undefined;
-    error?: string | undefined;
     error_code?: string | undefined;
 }>;
 export type ConsentApprovalResponse = z.infer<typeof consentApprovalResponseSchema>;
@@ -396,14 +396,14 @@ export declare const consentConfigSchema: z.ZodObject<{
         required: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         required: boolean;
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
-    }, {
-        text?: string | undefined;
         url?: string | undefined;
+        text?: string | undefined;
+    }, {
         version?: string | undefined;
+        url?: string | undefined;
         required?: boolean | undefined;
+        text?: string | undefined;
     }>>;
     customFields: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
         name: z.ZodString;
@@ -424,9 +424,9 @@ export declare const consentConfigSchema: z.ZodObject<{
         pattern: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -435,9 +435,9 @@ export declare const consentConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }, {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -446,9 +446,9 @@ export declare const consentConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }>, {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -457,9 +457,9 @@ export declare const consentConfigSchema: z.ZodObject<{
         pattern?: string | undefined;
     }, {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -492,15 +492,15 @@ export declare const consentConfigSchema: z.ZodObject<{
     } | undefined;
     terms?: {
         required: boolean;
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
+        url?: string | undefined;
+        text?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -522,16 +522,16 @@ export declare const consentConfigSchema: z.ZodObject<{
         theme?: "light" | "dark" | "auto" | undefined;
     } | undefined;
     terms?: {
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
+        url?: string | undefined;
         required?: boolean | undefined;
+        text?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -557,11 +557,11 @@ export type ConsentConfig = z.infer<typeof consentConfigSchema>;
  * @returns Validation result
  */
 export declare function validateConsentPageConfig(config: unknown): z.SafeParseReturnType<{
-    tool: string;
-    toolDescription: string;
-    scopes: string[];
     agentDid: string;
     sessionId: string;
+    tool: string;
+    scopes: string[];
+    toolDescription: string;
     projectId: string;
     serverUrl: string;
     branding?: {
@@ -571,16 +571,16 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
         theme?: "light" | "dark" | "auto" | undefined;
     } | undefined;
     terms?: {
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
+        url?: string | undefined;
         required?: boolean | undefined;
+        text?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -590,11 +590,11 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
     }[] | undefined;
     autoClose?: boolean | undefined;
 }, {
-    tool: string;
-    toolDescription: string;
-    scopes: string[];
     agentDid: string;
     sessionId: string;
+    tool: string;
+    scopes: string[];
+    toolDescription: string;
     projectId: string;
     serverUrl: string;
     branding?: {
@@ -605,15 +605,15 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
     } | undefined;
     terms?: {
         required: boolean;
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
+        url?: string | undefined;
+        text?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -631,18 +631,18 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
  */
 export declare function validateConsentApprovalRequest(request: unknown): z.SafeParseReturnType<{
     tool: string;
+    session_id: string;
     scopes: string[];
     agent_did: string;
-    session_id: string;
     project_id: string;
     termsAccepted: boolean;
     customFields?: Record<string, string | boolean> | undefined;
     termsVersion?: string | undefined;
 }, {
     tool: string;
+    session_id: string;
     scopes: string[];
     agent_did: string;
-    session_id: string;
     project_id: string;
     termsAccepted: boolean;
     customFields?: Record<string, string | boolean> | undefined;
@@ -656,15 +656,15 @@ export declare function validateConsentApprovalRequest(request: unknown): z.Safe
  */
 export declare function validateConsentApprovalResponse(response: unknown): z.SafeParseReturnType<{
     success: boolean;
+    error?: string | undefined;
     delegation_id?: string | undefined;
     delegation_token?: string | undefined;
-    error?: string | undefined;
     error_code?: string | undefined;
 }, {
     success: boolean;
+    error?: string | undefined;
     delegation_id?: string | undefined;
     delegation_token?: string | undefined;
-    error?: string | undefined;
     error_code?: string | undefined;
 }>;
 /**
@@ -681,16 +681,16 @@ export declare function validateConsentConfig(config: unknown): z.SafeParseRetur
         theme?: "light" | "dark" | "auto" | undefined;
     } | undefined;
     terms?: {
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
+        url?: string | undefined;
         required?: boolean | undefined;
+        text?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;
@@ -713,15 +713,15 @@ export declare function validateConsentConfig(config: unknown): z.SafeParseRetur
     } | undefined;
     terms?: {
         required: boolean;
-        text?: string | undefined;
-        url?: string | undefined;
         version?: string | undefined;
+        url?: string | undefined;
+        text?: string | undefined;
     } | undefined;
     customFields?: {
         type: "text" | "textarea" | "checkbox" | "select";
+        name: string;
         required: boolean;
         label: string;
-        name: string;
         options?: {
             value: string;
             label: string;