@kya-os/contracts 1.6.1 → 1.6.2

package/dist/agentshield-api/schemas.js

@@ -8,7 +8,7 @@
  * @package @kya-os/contracts/agentshield-api
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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 = void 0;
+exports.registerSessionAPIResponseSchema = exports.registerSessionResponseSchema = exports.registerSessionRequestSchema = exports.sessionClientIdentitySchema = exports.sessionClientInfoSchema = 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 = void 0;
 const zod_1 = require("zod");
 const proof_js_1 = require("../proof.js");
 const index_js_1 = require("../delegation/index.js");
@@ -266,3 +266,49 @@ exports.revokeDelegationResponseSchema = zod_1.z.object({
  * Wrapped revocation response schema
  */
 exports.revokeDelegationAPIResponseSchema = (0, exports.agentShieldAPIResponseSchema)(exports.revokeDelegationResponseSchema);
+// ============================================================================
+// Session Registration Schemas
+// ============================================================================
+/**
+ * Session client info schema
+ */
+exports.sessionClientInfoSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1, "Client name is required"),
+    version: zod_1.z.string().optional(),
+    protocol_version: zod_1.z.string().optional(),
+    platform: zod_1.z.string().optional(),
+    vendor: zod_1.z.string().optional(),
+});
+/**
+ * Session client identity schema
+ */
+exports.sessionClientIdentitySchema = zod_1.z.object({
+    did: zod_1.z.string().min(1, "Client DID is required"),
+    source: zod_1.z.enum(["knowthat.ai", "kta-lookup", "generated"]),
+    registered: zod_1.z.boolean(),
+});
+/**
+ * Register session request schema
+ */
+exports.registerSessionRequestSchema = zod_1.z.object({
+    session_id: zod_1.z.string().min(1, "Session ID is required"),
+    agent_did: zod_1.z.string().min(1, "Agent DID is required"),
+    project_id: zod_1.z.string().min(1, "Project ID is required"),
+    created_at: zod_1.z.number().int().positive("Created at must be a positive timestamp"),
+    client_info: exports.sessionClientInfoSchema,
+    client_identity: exports.sessionClientIdentitySchema.optional(),
+    server_did: zod_1.z.string().optional(),
+    ttl_minutes: zod_1.z.number().int().positive().optional(),
+});
+/**
+ * Register session response schema
+ */
+exports.registerSessionResponseSchema = zod_1.z.object({
+    session_id: zod_1.z.string().min(1),
+    registered: zod_1.z.boolean(),
+    created_at: zod_1.z.string().datetime(),
+});
+/**
+ * Wrapped session registration response schema
+ */
+exports.registerSessionAPIResponseSchema = (0, exports.agentShieldAPIResponseSchema)(exports.registerSessionResponseSchema);

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

@@ -248,6 +248,69 @@ export interface RevokeDelegationResponse {
  * Wrapped revocation response
  */
 export type RevokeDelegationAPIResponse = AgentShieldAPIResponse<RevokeDelegationResponse>;
+/**
+ * MCP Client information from the initialize message
+ */
+export interface SessionClientInfo {
+    /** Client application name (e.g., "Claude Desktop", "Anthropic/ClaudeAI") */
+    name: string;
+    /** Client version (e.g., "1.0.0") */
+    version?: string;
+    /** MCP protocol version (e.g., "2025-06-18") */
+    protocol_version?: string;
+    /** Platform (e.g., "darwin", "win32") */
+    platform?: string;
+    /** Vendor name (e.g., "Anthropic") */
+    vendor?: string;
+}
+/**
+ * Client identity resolution information
+ */
+export interface SessionClientIdentity {
+    /** Resolved DID for the client */
+    did: string;
+    /** Source of the DID */
+    source: "knowthat.ai" | "kta-lookup" | "generated";
+    /** Whether client is registered on knowthat.ai */
+    registered: boolean;
+}
+/**
+ * Request body for session registration endpoint
+ * POST /api/v1/bouncer/sessions
+ */
+export interface RegisterSessionRequest {
+    /** Unique session identifier (matches proof.meta.sessionId) */
+    session_id: string;
+    /** Agent's DID */
+    agent_did: string;
+    /** AgentShield project ID */
+    project_id: string;
+    /** Unix timestamp in milliseconds when session was created */
+    created_at: number;
+    /** MCP client information */
+    client_info: SessionClientInfo;
+    /** Client identity resolution (optional) */
+    client_identity?: SessionClientIdentity;
+    /** MCP server's DID (optional) */
+    server_did?: string;
+    /** Session TTL in minutes (default: 30) */
+    ttl_minutes?: number;
+}
+/**
+ * Response from session registration endpoint
+ */
+export interface RegisterSessionResponse {
+    /** The registered session ID */
+    session_id: string;
+    /** Whether registration was successful */
+    registered: boolean;
+    /** ISO 8601 timestamp of registration */
+    created_at: string;
+}
+/**
+ * Wrapped session registration response
+ */
+export type RegisterSessionAPIResponse = AgentShieldAPIResponse<RegisterSessionResponse>;
 /**
  * AgentShield API error class
  */

package/dist/consent/schemas.d.ts

@@ -285,8 +285,8 @@ export declare const consentPageConfigSchema: z.ZodEffects<z.ZodObject<{
     tool: string;
     scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
     provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
@@ -321,8 +321,8 @@ export declare const consentPageConfigSchema: z.ZodEffects<z.ZodObject<{
     tool: string;
     scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
     provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
@@ -357,8 +357,8 @@ export declare const consentPageConfigSchema: z.ZodEffects<z.ZodObject<{
     tool: string;
     scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
     provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
@@ -393,8 +393,8 @@ export declare const consentPageConfigSchema: z.ZodEffects<z.ZodObject<{
     tool: string;
     scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
     provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
@@ -747,8 +747,8 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
     tool: string;
     scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
     provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
@@ -783,8 +783,8 @@ export declare function validateConsentPageConfig(config: unknown): z.SafeParseR
     tool: string;
     scopes: string[];
     projectId: string;
-    toolDescription: string;
     serverUrl: string;
+    toolDescription: string;
     provider?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;