@kya-os/contracts 1.3.2 → 1.3.3

package/dist/runtime/errors.js

@@ -1,113 +1,45 @@
 "use strict";
-/**
- * Runtime Error Contracts
- *
- * Error types and schemas for runtime errors, especially authorization errors
- *
- * Related Spec: MCP-I §6
- * Python Reference: Core-Documentation.md
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ERROR_CODES = exports.RuntimeErrorSchema = exports.NeedsAuthorizationErrorSchema = exports.AuthorizationDisplaySchema = exports.DisplayHintSchema = void 0;
 exports.validateNeedsAuthorizationError = validateNeedsAuthorizationError;
 exports.isNeedsAuthorizationError = isNeedsAuthorizationError;
 exports.createNeedsAuthorizationError = createNeedsAuthorizationError;
 const zod_1 = require("zod");
-/**
- * Display hint types for authorization UI
- */
 exports.DisplayHintSchema = zod_1.z.enum(['link', 'qr', 'code']);
-/**
- * Display options for authorization flow
- */
 exports.AuthorizationDisplaySchema = zod_1.z.object({
-    /** Optional title for the authorization screen */
     title: zod_1.z.string().optional(),
-    /** Hints for how to display authorization (link, QR code, or code) */
     hint: zod_1.z.array(exports.DisplayHintSchema).optional(),
-    /** Optional short authorization code */
     authorizationCode: zod_1.z.string().optional(),
-    /** Optional QR code URL */
     qrUrl: zod_1.z.string().url().optional(),
 }).passthrough();
-/**
- * NeedsAuthorizationError Schema
- *
- * Error returned when a request requires authorization.
- * Includes a resumeToken and authorizationUrl for the authorization flow.
- */
 exports.NeedsAuthorizationErrorSchema = zod_1.z.object({
-    /** Error code */
     error: zod_1.z.literal('needs_authorization'),
-    /** Human-readable error message */
     message: zod_1.z.string().min(1),
-    /** URL for the user to authorize (includes resume token) */
     authorizationUrl: zod_1.z.string().url(),
-    /** Short-lived resume token for continuing after authorization */
     resumeToken: zod_1.z.string().min(1),
-    /** Expiration timestamp for the resume token (milliseconds since epoch) */
     expiresAt: zod_1.z.number().int().positive(),
-    /** Required scopes for authorization */
     scopes: zod_1.z.array(zod_1.z.string()),
-    /** Optional display configuration for authorization UI */
     display: exports.AuthorizationDisplaySchema.optional(),
-    /** Optional additional context */
     context: zod_1.z.record(zod_1.z.any()).optional(),
 }).passthrough();
-/**
- * Generic Error Schema
- *
- * Standard error format for all runtime errors
- */
 exports.RuntimeErrorSchema = zod_1.z.object({
-    /** Error code */
     error: zod_1.z.string().min(1),
-    /** Human-readable error message */
     message: zod_1.z.string().min(1),
-    /** Optional error details */
     details: zod_1.z.record(zod_1.z.any()).optional(),
-    /** HTTP status code (if applicable) */
     httpStatus: zod_1.z.number().int().min(400).max(599).optional(),
 });
-/**
- * Validation Helpers
- */
-/**
- * Validate a needs authorization error
- *
- * @param error - The error to validate
- * @returns Validation result
- */
 function validateNeedsAuthorizationError(error) {
     return exports.NeedsAuthorizationErrorSchema.safeParse(error);
 }
-/**
- * Check if error is a needs authorization error
- *
- * @param error - The error to check
- * @returns true if it's a needs authorization error
- */
 function isNeedsAuthorizationError(error) {
     return error && error.error === 'needs_authorization';
 }
-/**
- * Create a needs authorization error
- *
- * @param config - Configuration for the error
- * @returns NeedsAuthorizationError instance
- */
 function createNeedsAuthorizationError(config) {
     return {
         error: 'needs_authorization',
         ...config,
     };
 }
-/**
- * Constants
- */
-/**
- * Error codes
- */
 exports.ERROR_CODES = Object.freeze({
     NEEDS_AUTHORIZATION: 'needs_authorization',
     INVALID_TOKEN: 'invalid_token',
@@ -117,4 +49,3 @@ exports.ERROR_CODES = Object.freeze({
     DELEGATION_REVOKED: 'delegation_revoked',
     CREDENTIAL_REVOKED: 'credential_revoked',
 });
-//# sourceMappingURL=errors.js.map

package/dist/runtime/headers.d.ts

@@ -1,35 +1,12 @@
-/**
- * Runtime Header Contracts
- *
- * Header contracts for downstream services
- *
- * Related Spec: MCP-I §6
- * Python Reference: Core-Documentation.md
- */
-/**
- * Downstream Headers Interface
- *
- * Headers passed to downstream services after verification
- */
 export interface DownstreamHeaders {
-    /** DID of the verified agent */
     'X-Agent-DID': string;
-    /** Optional delegation ID */
     'X-Delegation-Id'?: string;
-    /** Optional delegation chain (format: vc_id>del_id>...) */
     'X-Delegation-Chain'?: string;
-    /** Proof ID for audit trail */
     'X-MCPI-Proof-Id': string;
-    /** Optional CRISP spend info (JSON string: {unit, delta, remaining}) */
     'X-CRISP-Spend'?: string;
-    /** Optional session ID */
     'X-Session-Id'?: string;
-    /** Optional scopes */
     'X-Scopes'?: string;
 }
-/**
- * Header names as constants for type safety
- */
 export declare const DOWNSTREAM_HEADER_NAMES: Readonly<{
     readonly AGENT_DID: "X-Agent-DID";
     readonly DELEGATION_ID: "X-Delegation-Id";
@@ -39,39 +16,13 @@ export declare const DOWNSTREAM_HEADER_NAMES: Readonly<{
     readonly SESSION_ID: "X-Session-Id";
     readonly SCOPES: "X-Scopes";
 }>;
-/**
- * CRISP Spend Info
- *
- * Structure for X-CRISP-Spend header value
- */
 export interface CrispSpendInfo {
-    /** Unit of spending */
     unit: 'USD' | 'ops' | 'points';
-    /** Amount spent in this request */
     delta?: number;
-    /** Remaining budget */
     remaining?: number;
 }
-/**
- * Helper to serialize CRISP spend info to header value
- *
- * @param info - CRISP spend info
- * @returns JSON string for header
- */
 export declare function serializeCrispSpend(info: CrispSpendInfo): string;
-/**
- * Helper to parse CRISP spend info from header value
- *
- * @param headerValue - JSON string from header
- * @returns Parsed CRISP spend info or null if invalid
- */
 export declare function parseCrispSpend(headerValue: string): CrispSpendInfo | null;
-/**
- * Helper to create downstream headers
- *
- * @param config - Configuration for headers
- * @returns DownstreamHeaders object
- */
 export declare function createDownstreamHeaders(config: {
     agentDid: string;
     proofId: string;
@@ -81,4 +32,3 @@ export declare function createDownstreamHeaders(config: {
     sessionId?: string;
     scopes?: string[];
 }): DownstreamHeaders;
-//# sourceMappingURL=headers.d.ts.map

package/dist/runtime/headers.js

@@ -1,20 +1,9 @@
 "use strict";
-/**
- * Runtime Header Contracts
- *
- * Header contracts for downstream services
- *
- * Related Spec: MCP-I §6
- * Python Reference: Core-Documentation.md
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DOWNSTREAM_HEADER_NAMES = void 0;
 exports.serializeCrispSpend = serializeCrispSpend;
 exports.parseCrispSpend = parseCrispSpend;
 exports.createDownstreamHeaders = createDownstreamHeaders;
-/**
- * Header names as constants for type safety
- */
 exports.DOWNSTREAM_HEADER_NAMES = Object.freeze({
     AGENT_DID: 'X-Agent-DID',
     DELEGATION_ID: 'X-Delegation-Id',
@@ -24,21 +13,9 @@ exports.DOWNSTREAM_HEADER_NAMES = Object.freeze({
     SESSION_ID: 'X-Session-Id',
     SCOPES: 'X-Scopes',
 });
-/**
- * Helper to serialize CRISP spend info to header value
- *
- * @param info - CRISP spend info
- * @returns JSON string for header
- */
 function serializeCrispSpend(info) {
     return JSON.stringify(info);
 }
-/**
- * Helper to parse CRISP spend info from header value
- *
- * @param headerValue - JSON string from header
- * @returns Parsed CRISP spend info or null if invalid
- */
 function parseCrispSpend(headerValue) {
     try {
         const parsed = JSON.parse(headerValue);
@@ -51,12 +28,6 @@ function parseCrispSpend(headerValue) {
         return null;
     }
 }
-/**
- * Helper to create downstream headers
- *
- * @param config - Configuration for headers
- * @returns DownstreamHeaders object
- */
 function createDownstreamHeaders(config) {
     const headers = {
         'X-Agent-DID': config.agentDid,
@@ -79,4 +50,3 @@ function createDownstreamHeaders(config) {
     }
     return headers;
 }
-//# sourceMappingURL=headers.js.map

package/dist/runtime/index.d.ts

@@ -1,6 +1,2 @@
-/**
- * Runtime Module Exports
- */
 export * from './errors.js';
 export * from './headers.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.js

@@ -1,7 +1,4 @@
 "use strict";
-/**
- * Runtime Module Exports
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -19,4 +16,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./errors.js"), exports);
 __exportStar(require("./headers.js"), exports);
-//# sourceMappingURL=index.js.map

package/dist/test.d.ts

@@ -1,13 +1,4 @@
-/**
- * Test infrastructure types and schemas for XMCP-I
- *
- * This module provides types and utilities for testing XMCP-I applications
- * without hitting external services like KTA.
- */
 import { z } from "zod";
-/**
- * Test environment configuration
- */
 export declare const TestEnvironmentSchema: z.ZodObject<{
     mode: z.ZodLiteral<"test">;
     seed: z.ZodOptional<z.ZodString>;
@@ -25,9 +16,6 @@ export declare const TestEnvironmentSchema: z.ZodObject<{
     skipKTACalls?: boolean | undefined;
 }>;
 export type TestEnvironment = z.infer<typeof TestEnvironmentSchema>;
-/**
- * Mock identity configuration for testing
- */
 export declare const MockIdentitySchema: z.ZodObject<{
     did: z.ZodString;
     kid: z.ZodString;
@@ -51,19 +39,10 @@ export declare const MockIdentitySchema: z.ZodObject<{
     lastRotated?: string | undefined;
 }>;
 export type MockIdentity = z.infer<typeof MockIdentitySchema>;
-/**
- * Mock delegation status for testing
- */
 export declare const MockDelegationStatusSchema: z.ZodEnum<["active", "revoked", "pending"]>;
 export type MockDelegationStatus = z.infer<typeof MockDelegationStatusSchema>;
-/**
- * Mock KTA failure scenarios for testing
- */
 export declare const MockKTAFailureTypeSchema: z.ZodEnum<["network", "auth", "invalid", "timeout"]>;
 export type MockKTAFailureType = z.infer<typeof MockKTAFailureTypeSchema>;
-/**
- * Mock identity provider configuration
- */
 export declare const MockIdentityProviderConfigSchema: z.ZodObject<{
     identities: z.ZodRecord<z.ZodString, z.ZodObject<{
         did: z.ZodString;
@@ -116,9 +95,6 @@ export declare const MockIdentityProviderConfigSchema: z.ZodObject<{
     deterministicSeed?: string | undefined;
 }>;
 export type MockIdentityProviderConfig = z.infer<typeof MockIdentityProviderConfigSchema>;
-/**
- * Local verification result for offline testing
- */
 export declare const LocalVerificationResultSchema: z.ZodObject<{
     valid: z.ZodBoolean;
     did: z.ZodOptional<z.ZodString>;
@@ -218,9 +194,6 @@ export declare const LocalVerificationResultSchema: z.ZodObject<{
     errors?: string[] | undefined;
 }>;
 export type LocalVerificationResult = z.infer<typeof LocalVerificationResultSchema>;
-/**
- * Test DID and Key ID constants
- */
 export declare const TEST_DIDS: {
     readonly AGENT_1: "did:test:agent-1";
     readonly AGENT_2: "did:test:agent-2";
@@ -231,17 +204,8 @@ export declare const TEST_KEY_IDS: {
     readonly KEY_TEST_2: "key-test-2";
     readonly KEY_VERIFIER_1: "key-verifier-1";
 };
-/**
- * Test environment detection
- */
 export declare function isTestEnvironment(): boolean;
-/**
- * Get test seed from environment or test name
- */
 export declare function getTestSeed(testName?: string): string;
-/**
- * Error codes for test infrastructure
- */
 export declare const TEST_ERROR_CODES: {
     readonly MOCK_KTA_FAILURE: "XMCP_I_TEST_MOCK_KTA_FAILURE";
     readonly DETERMINISTIC_KEY_GENERATION_FAILED: "XMCP_I_TEST_DETERMINISTIC_KEY_FAILED";
@@ -249,4 +213,3 @@ export declare const TEST_ERROR_CODES: {
     readonly INVALID_TEST_CONFIGURATION: "XMCP_I_TEST_INVALID_CONFIG";
 };
 export type TestErrorCode = (typeof TEST_ERROR_CODES)[keyof typeof TEST_ERROR_CODES];
-//# sourceMappingURL=test.d.ts.map

package/dist/test.js

@@ -1,27 +1,15 @@
 "use strict";
-/**
- * Test infrastructure types and schemas for XMCP-I
- *
- * This module provides types and utilities for testing XMCP-I applications
- * without hitting external services like KTA.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TEST_ERROR_CODES = exports.TEST_KEY_IDS = exports.TEST_DIDS = exports.LocalVerificationResultSchema = exports.MockIdentityProviderConfigSchema = exports.MockKTAFailureTypeSchema = exports.MockDelegationStatusSchema = exports.MockIdentitySchema = exports.TestEnvironmentSchema = void 0;
 exports.isTestEnvironment = isTestEnvironment;
 exports.getTestSeed = getTestSeed;
 const zod_1 = require("zod");
-/**
- * Test environment configuration
- */
 exports.TestEnvironmentSchema = zod_1.z.object({
     mode: zod_1.z.literal("test"),
     seed: zod_1.z.string().optional(),
     deterministicKeys: zod_1.z.boolean().default(true),
     skipKTACalls: zod_1.z.boolean().default(true),
 });
-/**
- * Mock identity configuration for testing
- */
 exports.MockIdentitySchema = zod_1.z.object({
     did: zod_1.z.string(),
     kid: zod_1.z.string(),
@@ -30,35 +18,23 @@ exports.MockIdentitySchema = zod_1.z.object({
     createdAt: zod_1.z.string(),
     lastRotated: zod_1.z.string().optional(),
 });
-/**
- * Mock delegation status for testing
- */
 exports.MockDelegationStatusSchema = zod_1.z.enum([
     "active",
     "revoked",
     "pending",
 ]);
-/**
- * Mock KTA failure scenarios for testing
- */
 exports.MockKTAFailureTypeSchema = zod_1.z.enum([
     "network",
     "auth",
     "invalid",
     "timeout",
 ]);
-/**
- * Mock identity provider configuration
- */
 exports.MockIdentityProviderConfigSchema = zod_1.z.object({
     identities: zod_1.z.record(zod_1.z.string(), exports.MockIdentitySchema),
     delegations: zod_1.z.record(zod_1.z.string(), exports.MockDelegationStatusSchema),
     ktaFailures: zod_1.z.array(exports.MockKTAFailureTypeSchema).default([]),
     deterministicSeed: zod_1.z.string().optional(),
 });
-/**
- * Local verification result for offline testing
- */
 exports.LocalVerificationResultSchema = zod_1.z.object({
     valid: zod_1.z.boolean(),
     did: zod_1.z.string().optional(),
@@ -83,9 +59,6 @@ exports.LocalVerificationResultSchema = zod_1.z.object({
     errors: zod_1.z.array(zod_1.z.string()).default([]),
     warnings: zod_1.z.array(zod_1.z.string()).default([]),
 });
-/**
- * Test DID and Key ID constants
- */
 exports.TEST_DIDS = {
     AGENT_1: "did:test:agent-1",
     AGENT_2: "did:test:agent-2",
@@ -96,25 +69,15 @@ exports.TEST_KEY_IDS = {
     KEY_TEST_2: "key-test-2",
     KEY_VERIFIER_1: "key-verifier-1",
 };
-/**
- * Test environment detection
- */
 function isTestEnvironment() {
     return process.env.XMCP_ENV === "test";
 }
-/**
- * Get test seed from environment or test name
- */
 function getTestSeed(testName) {
     return process.env.XMCP_TEST_SEED || testName || "default-test-seed";
 }
-/**
- * Error codes for test infrastructure
- */
 exports.TEST_ERROR_CODES = {
     MOCK_KTA_FAILURE: "XMCP_I_TEST_MOCK_KTA_FAILURE",
     DETERMINISTIC_KEY_GENERATION_FAILED: "XMCP_I_TEST_DETERMINISTIC_KEY_FAILED",
     LOCAL_VERIFICATION_FAILED: "XMCP_I_TEST_LOCAL_VERIFICATION_FAILED",
     INVALID_TEST_CONFIGURATION: "XMCP_I_TEST_INVALID_CONFIG",
 };
-//# sourceMappingURL=test.js.map

package/dist/tlkrc/index.d.ts

@@ -1,5 +1 @@
-/**
- * TLKRC Module Exports
- */
 export * from './rotation.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/tlkrc/index.js

@@ -1,7 +1,4 @@
 "use strict";
-/**
- * TLKRC Module Exports
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -18,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./rotation.js"), exports);
-//# sourceMappingURL=index.js.map