@kya-os/contracts 1.5.2 → 1.5.4-canary.1

package/dist/agentshield-api/admin-schemas.d.ts

@@ -0,0 +1,55 @@
+/**
+ * AgentShield Admin API Validation Schemas
+ *
+ * Zod schemas for administrative operations in AgentShield.
+ *
+ * @package @kya-os/contracts/agentshield-api
+ */
+import { z } from 'zod';
+/**
+ * Request schema for clearing agent cache
+ */
+export declare const clearCacheRequestSchema: z.ZodObject<{
+    agent_did: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agent_did: string;
+}, {
+    agent_did: string;
+}>;
+/**
+ * Response schema for clear cache operation
+ */
+export declare const clearCacheResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    agent_did: z.ZodString;
+    project_id: z.ZodNullable<z.ZodString>;
+    cache_key: z.ZodString;
+    old_cache_key: z.ZodNullable<z.ZodString>;
+    had_value: z.ZodBoolean;
+    had_old_value: z.ZodBoolean;
+    cleared: z.ZodBoolean;
+    refreshed_immediately: z.ZodOptional<z.ZodBoolean>;
+    refresh_error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    agent_did: string;
+    message: string;
+    project_id: string | null;
+    cache_key: string;
+    old_cache_key: string | null;
+    had_value: boolean;
+    had_old_value: boolean;
+    cleared: boolean;
+    refreshed_immediately?: boolean | undefined;
+    refresh_error?: string | undefined;
+}, {
+    agent_did: string;
+    message: string;
+    project_id: string | null;
+    cache_key: string;
+    old_cache_key: string | null;
+    had_value: boolean;
+    had_old_value: boolean;
+    cleared: boolean;
+    refreshed_immediately?: boolean | undefined;
+    refresh_error?: string | undefined;
+}>;

package/dist/agentshield-api/admin-schemas.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * AgentShield Admin API Validation Schemas
+ *
+ * Zod schemas for administrative operations in AgentShield.
+ *
+ * @package @kya-os/contracts/agentshield-api
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearCacheResponseSchema = exports.clearCacheRequestSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Request schema for clearing agent cache
+ */
+exports.clearCacheRequestSchema = zod_1.z.object({
+    agent_did: zod_1.z.string().min(1).describe('The DID of the agent whose cache should be cleared'),
+});
+/**
+ * Response schema for clear cache operation
+ */
+exports.clearCacheResponseSchema = zod_1.z.object({
+    message: zod_1.z.string().describe('Human-readable message about the operation result'),
+    agent_did: zod_1.z.string().describe('The agent DID that was cleared'),
+    project_id: zod_1.z.string().nullable().describe('The project ID if available'),
+    cache_key: zod_1.z.string().describe('The cache key that was cleared'),
+    old_cache_key: zod_1.z.string().nullable().describe('Old cache key that was also cleared (for migration)'),
+    had_value: zod_1.z.boolean().describe('Whether the cache entry existed before clearing'),
+    had_old_value: zod_1.z.boolean().describe('Whether the old cache entry existed before clearing'),
+    cleared: zod_1.z.boolean().describe('Whether the cache was successfully cleared'),
+    refreshed_immediately: zod_1.z.boolean().optional().describe('Whether cache was immediately refreshed from API after clearing'),
+    refresh_error: zod_1.z.string().optional().describe('Error message if immediate refresh failed (non-fatal)'),
+});

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

@@ -0,0 +1,41 @@
+/**
+ * AgentShield Admin API Type Definitions
+ *
+ * TypeScript interfaces for administrative operations in AgentShield.
+ * These types ensure parity between xmcp-i admin endpoints and the AgentShield service.
+ *
+ * @package @kya-os/contracts/agentshield-api
+ */
+/**
+ * Request to clear agent cache
+ * POST /admin/clear-cache
+ */
+export interface ClearCacheRequest {
+    /** The DID of the agent whose cache should be cleared */
+    agent_did: string;
+}
+/**
+ * Response from clear cache operation
+ */
+export interface ClearCacheResponse {
+    /** Human-readable message about the operation result */
+    message: string;
+    /** The agent DID that was cleared */
+    agent_did: string;
+    /** The project ID if available */
+    project_id: string | null;
+    /** The cache key that was cleared */
+    cache_key: string;
+    /** Old cache key that was also cleared (for migration) */
+    old_cache_key: string | null;
+    /** Whether the cache entry existed before clearing */
+    had_value: boolean;
+    /** Whether the old cache entry existed before clearing */
+    had_old_value: boolean;
+    /** Whether the cache was successfully cleared */
+    cleared: boolean;
+    /** Whether cache was immediately refreshed from API after clearing */
+    refreshed_immediately?: boolean;
+    /** Error message if immediate refresh failed (non-fatal) */
+    refresh_error?: string;
+}

package/dist/agentshield-api/admin-types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * AgentShield Admin API Type Definitions
+ *
+ * TypeScript interfaces for administrative operations in AgentShield.
+ * These types ensure parity between xmcp-i admin endpoints and the AgentShield service.
+ *
+ * @package @kya-os/contracts/agentshield-api
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -6,8 +6,10 @@
  *
  * @package @kya-os/contracts/agentshield-api
  */
-export type { AgentShieldAPIResponse, AgentShieldAPIErrorResponse, ProofSubmissionRequest, ProofSubmissionResponse, ToolCallContext, BouncerOutcome, VerifyDelegationRequest, VerifyDelegationResponse, VerifyDelegationAPIResponse, DelegationCredential, AgentShieldToolProtection, ToolProtectionConfigResponse, ToolProtectionConfigAPIResponse, CreateDelegationRequest, CreateDelegationResponse, CreateDelegationAPIResponse, RevokeDelegationRequest, RevokeDelegationResponse, RevokeDelegationAPIResponse, } from './types.js';
-export { AgentShieldAPIError } from './types.js';
-export type { AgentShieldAPIHeaders } from './endpoints.js';
-export { agentShieldAPIErrorSchema, agentShieldAPIResponseSchema, proofSubmissionRequestSchema, proofSubmissionResponseSchema, delegationCredentialSchema, verifyDelegationRequestSchema, verifyDelegationResponseSchema, verifyDelegationAPIResponseSchema, agentShieldToolProtectionSchema, toolProtectionConfigResponseSchema, toolProtectionConfigAPIResponseSchema, createDelegationRequestSchema, createDelegationResponseSchema, createDelegationAPIResponseSchema, revokeDelegationRequestSchema, revokeDelegationResponseSchema, revokeDelegationAPIResponseSchema, } from './schemas.js';
-export { AGENTSHIELD_API_BASE, AGENTSHIELD_ENDPOINTS, AGENTSHIELD_METHODS, } from './endpoints.js';
+export type { AgentShieldAPIResponse, AgentShieldAPIErrorResponse, ProofSubmissionRequest, ProofSubmissionResponse, ToolCallContext, BouncerOutcome, VerifyDelegationRequest, VerifyDelegationResponse, VerifyDelegationAPIResponse, DelegationCredential, AgentShieldToolProtection, ToolProtectionConfigResponse, ToolProtectionConfigAPIResponse, CreateDelegationRequest, CreateDelegationResponse, CreateDelegationAPIResponse, RevokeDelegationRequest, RevokeDelegationResponse, RevokeDelegationAPIResponse, } from "./types.js";
+export { AgentShieldAPIError } from "./types.js";
+export type { AgentShieldAPIHeaders } from "./endpoints.js";
+export type { ClearCacheRequest, ClearCacheResponse } from "./admin-types.js";
+export { agentShieldAPIErrorSchema, agentShieldAPIResponseSchema, proofSubmissionRequestSchema, proofSubmissionResponseSchema, delegationCredentialSchema, verifyDelegationRequestSchema, verifyDelegationResponseSchema, verifyDelegationAPIResponseSchema, agentShieldToolProtectionSchema, toolProtectionConfigResponseSchema, toolProtectionConfigAPIResponseSchema, createDelegationRequestSchema, createDelegationResponseSchema, createDelegationAPIResponseSchema, revokeDelegationRequestSchema, revokeDelegationResponseSchema, revokeDelegationAPIResponseSchema, } from "./schemas.js";
+export { clearCacheRequestSchema, clearCacheResponseSchema, } from "./admin-schemas.js";
+export { AGENTSHIELD_API_BASE, AGENTSHIELD_ENDPOINTS, AGENTSHIELD_METHODS, } from "./endpoints.js";

package/dist/agentshield-api/index.js

@@ -8,7 +8,7 @@
  * @package @kya-os/contracts/agentshield-api
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENTSHIELD_METHODS = exports.AGENTSHIELD_ENDPOINTS = exports.AGENTSHIELD_API_BASE = exports.revokeDelegationAPIResponseSchema = exports.revokeDelegationResponseSchema = exports.revokeDelegationRequestSchema = exports.createDelegationAPIResponseSchema = exports.createDelegationResponseSchema = exports.createDelegationRequestSchema = exports.toolProtectionConfigAPIResponseSchema = exports.toolProtectionConfigResponseSchema = exports.agentShieldToolProtectionSchema = exports.verifyDelegationAPIResponseSchema = exports.verifyDelegationResponseSchema = exports.verifyDelegationRequestSchema = exports.delegationCredentialSchema = exports.proofSubmissionResponseSchema = exports.proofSubmissionRequestSchema = exports.agentShieldAPIResponseSchema = exports.agentShieldAPIErrorSchema = exports.AgentShieldAPIError = void 0;
+exports.AGENTSHIELD_METHODS = exports.AGENTSHIELD_ENDPOINTS = exports.AGENTSHIELD_API_BASE = exports.clearCacheResponseSchema = exports.clearCacheRequestSchema = exports.revokeDelegationAPIResponseSchema = exports.revokeDelegationResponseSchema = exports.revokeDelegationRequestSchema = exports.createDelegationAPIResponseSchema = exports.createDelegationResponseSchema = exports.createDelegationRequestSchema = exports.toolProtectionConfigAPIResponseSchema = exports.toolProtectionConfigResponseSchema = exports.agentShieldToolProtectionSchema = exports.verifyDelegationAPIResponseSchema = exports.verifyDelegationResponseSchema = exports.verifyDelegationRequestSchema = exports.delegationCredentialSchema = exports.proofSubmissionResponseSchema = exports.proofSubmissionRequestSchema = exports.agentShieldAPIResponseSchema = exports.agentShieldAPIErrorSchema = exports.AgentShieldAPIError = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "AgentShieldAPIError", { enumerable: true, get: function () { return types_js_1.AgentShieldAPIError; } });
 // Schema exports
@@ -30,6 +30,9 @@ Object.defineProperty(exports, "createDelegationAPIResponseSchema", { enumerable
 Object.defineProperty(exports, "revokeDelegationRequestSchema", { enumerable: true, get: function () { return schemas_js_1.revokeDelegationRequestSchema; } });
 Object.defineProperty(exports, "revokeDelegationResponseSchema", { enumerable: true, get: function () { return schemas_js_1.revokeDelegationResponseSchema; } });
 Object.defineProperty(exports, "revokeDelegationAPIResponseSchema", { enumerable: true, get: function () { return schemas_js_1.revokeDelegationAPIResponseSchema; } });
+var admin_schemas_js_1 = require("./admin-schemas.js");
+Object.defineProperty(exports, "clearCacheRequestSchema", { enumerable: true, get: function () { return admin_schemas_js_1.clearCacheRequestSchema; } });
+Object.defineProperty(exports, "clearCacheResponseSchema", { enumerable: true, get: function () { return admin_schemas_js_1.clearCacheResponseSchema; } });
 // Endpoint exports
 var endpoints_js_1 = require("./endpoints.js");
 Object.defineProperty(exports, "AGENTSHIELD_API_BASE", { enumerable: true, get: function () { return endpoints_js_1.AGENTSHIELD_API_BASE; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kya-os/contracts",
-  "version": "1.5.2",
+  "version": "1.5.4-canary.1",
   "description": "Shared types and schemas for XMCP-I ecosystem",
   "type": "commonjs",
   "sideEffects": false,