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

package/dist/config/tool-protection.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Tool Protection Configuration Types
+ *
+ * Configuration for tool protection including delegation requirements,
+ * scopes, and multi-source resolution strategies.
+ *
+ * @module @kya-os/contracts/config
+ */
+import type { ToolProtection as BaseToolProtection, ToolProtectionMap as BaseToolProtectionMap, DelegationRequiredErrorData as BaseDelegationRequiredErrorData, ToolProtectionResponse as BaseToolProtectionResponse } from '../tool-protection/index.js';
+export type ToolProtection = BaseToolProtection;
+export type ToolProtectionMap = BaseToolProtectionMap;
+export type DelegationRequiredErrorData = BaseDelegationRequiredErrorData;
+export type ToolProtectionResponse = BaseToolProtectionResponse;
+/**
+ * Tool protection source types
+ */
+export type ToolProtectionSourceType = 'inline' | 'local' | 'agentshield' | 'kta' | 'multi';
+/**
+ * Tool protection source configuration
+ * Defines where tool protection settings come from
+ */
+export interface ToolProtectionSourceConfig {
+    /**
+     * Type of source to use
+     */
+    source: ToolProtectionSourceType;
+    /**
+     * Inline tool protection map
+     * Used when source is 'inline'
+     */
+    inline?: BaseToolProtectionMap;
+    /**
+     * Path to local tool protections file
+     * Used when source is 'local'
+     * @example './tool-protections.json'
+     */
+    localFile?: string;
+    /**
+     * AgentShield configuration
+     * Used when source is 'agentshield'
+     */
+    agentShield?: {
+        /**
+         * AgentShield API base URL
+         * @example 'https://kya.vouched.id'
+         */
+        apiUrl: string;
+        /**
+         * API key for authentication
+         */
+        apiKey?: string;
+        /**
+         * Project ID (optional, for backward compatibility)
+         * Modern approach uses agent DID
+         */
+        projectId?: string;
+        /**
+         * Cache TTL in milliseconds
+         * @default 300000 (5 minutes)
+         */
+        cacheTtl?: number;
+    };
+    /**
+     * KTA configuration
+     * Used when source is 'kta'
+     */
+    kta?: {
+        /**
+         * KTA API base URL
+         */
+        apiUrl: string;
+        /**
+         * API key for authentication
+         */
+        apiKey?: string;
+    };
+    /**
+     * Multi-source configuration
+     * Used when source is 'multi'
+     * Sources are checked in priority order
+     */
+    sources?: Array<{
+        /**
+         * Source configuration
+         */
+        config: Omit<ToolProtectionSourceConfig, 'source' | 'sources'>;
+        /**
+         * Priority (higher number = higher priority)
+         * @default 0
+         */
+        priority?: number;
+        /**
+         * Whether to stop after this source if found
+         * @default false
+         */
+        exclusive?: boolean;
+    }>;
+    /**
+     * Fallback configuration if all sources fail
+     */
+    fallback?: BaseToolProtectionMap;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Tool protection service configuration
+ * Used by provider-based implementations
+ */
+export interface ToolProtectionServiceConfig {
+    /**
+     * API base URL for fetching tool protections
+     */
+    apiUrl: string;
+    /**
+     * API key for authentication
+     */
+    apiKey: string;
+    /**
+     * Project ID (optional)
+     */
+    projectId?: string;
+    /**
+     * Cache TTL in milliseconds
+     * @default 300000 (5 minutes)
+     */
+    cacheTtl?: number;
+    /**
+     * Fallback configuration if API is unavailable
+     */
+    fallbackConfig?: BaseToolProtectionMap;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+}

package/dist/config/tool-protection.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Tool Protection Configuration Types
+ *
+ * Configuration for tool protection including delegation requirements,
+ * scopes, and multi-source resolution strategies.
+ *
+ * @module @kya-os/contracts/config
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/consent/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Consent Module Exports
+ *
+ * Types and schemas for consent page configuration and approval handling
+ */
+export { consentBrandingSchema, consentTermsSchema, consentCustomFieldSchema, consentCustomFieldOptionSchema, consentPageConfigSchema, consentApprovalRequestSchema, consentApprovalResponseSchema, consentConfigSchema, validateConsentPageConfig, validateConsentApprovalRequest, validateConsentApprovalResponse, validateConsentConfig, type ConsentBranding, type ConsentTerms, type ConsentCustomField, type ConsentPageConfig, type ConsentApprovalRequest, type ConsentApprovalResponse, type ConsentConfig, } from './schemas.js';

package/dist/consent/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Consent Module Exports
+ *
+ * Types and schemas for consent page configuration and approval handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConsentConfig = exports.validateConsentApprovalResponse = exports.validateConsentApprovalRequest = exports.validateConsentPageConfig = exports.consentConfigSchema = exports.consentApprovalResponseSchema = exports.consentApprovalRequestSchema = exports.consentPageConfigSchema = exports.consentCustomFieldOptionSchema = exports.consentCustomFieldSchema = exports.consentTermsSchema = exports.consentBrandingSchema = void 0;
+// Export schemas and inferred types (types are derived from schemas)
+var schemas_js_1 = require("./schemas.js");
+Object.defineProperty(exports, "consentBrandingSchema", { enumerable: true, get: function () { return schemas_js_1.consentBrandingSchema; } });
+Object.defineProperty(exports, "consentTermsSchema", { enumerable: true, get: function () { return schemas_js_1.consentTermsSchema; } });
+Object.defineProperty(exports, "consentCustomFieldSchema", { enumerable: true, get: function () { return schemas_js_1.consentCustomFieldSchema; } });
+Object.defineProperty(exports, "consentCustomFieldOptionSchema", { enumerable: true, get: function () { return schemas_js_1.consentCustomFieldOptionSchema; } });
+Object.defineProperty(exports, "consentPageConfigSchema", { enumerable: true, get: function () { return schemas_js_1.consentPageConfigSchema; } });
+Object.defineProperty(exports, "consentApprovalRequestSchema", { enumerable: true, get: function () { return schemas_js_1.consentApprovalRequestSchema; } });
+Object.defineProperty(exports, "consentApprovalResponseSchema", { enumerable: true, get: function () { return schemas_js_1.consentApprovalResponseSchema; } });
+Object.defineProperty(exports, "consentConfigSchema", { enumerable: true, get: function () { return schemas_js_1.consentConfigSchema; } });
+Object.defineProperty(exports, "validateConsentPageConfig", { enumerable: true, get: function () { return schemas_js_1.validateConsentPageConfig; } });
+Object.defineProperty(exports, "validateConsentApprovalRequest", { enumerable: true, get: function () { return schemas_js_1.validateConsentApprovalRequest; } });
+Object.defineProperty(exports, "validateConsentApprovalResponse", { enumerable: true, get: function () { return schemas_js_1.validateConsentApprovalResponse; } });
+Object.defineProperty(exports, "validateConsentConfig", { enumerable: true, get: function () { return schemas_js_1.validateConsentConfig; } });