@kya-os/contracts 1.0.0-alpha

package/dist/registry.js

@@ -0,0 +1,115 @@
+import { z } from "zod";
+/**
+ * Registry integration schemas (Know-That-AI and MCP Registry)
+ */
+export const RegistrationInputSchema = z.object({
+    agentDID: z.string().min(1),
+    agentURL: z.string().url(),
+    verificationEndpoint: z.string().url(),
+    conformanceCapabilities: z.array(z.enum(["handshake", "signing", "verification"])),
+    metadata: z.record(z.any()).optional(),
+});
+export const RegistrationResultSchema = z.object({
+    agentDID: z.string().min(1),
+    agentURL: z.string().url(),
+    agentId: z.string().min(1),
+    agentSlug: z.string().min(1),
+    claimURL: z.string().url().optional(),
+    verificationEndpoint: z.string().url(),
+    conformanceCapabilities: z.tuple([
+        z.literal("handshake"),
+        z.literal("signing"),
+        z.literal("verification"),
+    ]),
+    mirrorStatus: z.enum(["pending", "success", "error"]),
+    mirrorLink: z.string().url().optional(),
+});
+export const ClaimTokenSchema = z.object({
+    token: z.string().min(1),
+    expiresAt: z.number().int().positive(),
+    ttlHours: z.number().int().positive().default(24),
+});
+export const MirrorStatusSchema = z.object({
+    status: z.enum(["pending", "success", "error"]),
+    lastUpdated: z.number().int().positive(),
+    errorMessage: z.string().optional(),
+    registryURL: z.string().url().optional(),
+});
+export const AgentStatusSchema = z.object({
+    did: z.string().min(1),
+    keyId: z.string().min(1),
+    ktaURL: z.string().url(),
+    mirrorStatus: MirrorStatusSchema,
+    lastHandshake: z.number().int().positive().optional(),
+});
+/**
+ * Delegation schemas for verifiable credentials
+ */
+export const DelegationSchema = z.object({
+    issuer: z.string().min(1), // DID of the issuer
+    subject: z.string().min(1), // DID of the subject
+    scopes: z.array(z.string()),
+    nbf: z.number().int().positive(), // Not before (unix timestamp)
+    exp: z.number().int().positive(), // Expires (unix timestamp)
+    aud: z.string().optional(), // Audience (optional)
+    delegationRef: z.string().optional(), // Reference to parent delegation
+});
+export const DelegationRequestSchema = z.object({
+    subject: z.string().min(1),
+    scopes: z.array(z.string()),
+    duration: z.number().int().positive().optional(), // Duration in seconds
+    audience: z.string().optional(),
+});
+/**
+ * Storage mode configuration for verifiable credentials and delegations
+ */
+export const StorageModeSchema = z.enum([
+    "ktaEncrypted",
+    "hybridReceiptsOnly",
+    "selfHostedAuthoritative",
+]);
+/**
+ * Receipt object returned by KTA for verifiable operations
+ * Schema ID: https://schemas.kya.dev/xmcpi/receipt/v1.0.0.json
+ */
+export const ReceiptSchema = z.object({
+    $schema: z
+        .literal("https://schemas.kya.dev/xmcpi/receipt/v1.0.0.json")
+        .optional(),
+    ref: z.string().min(1),
+    contentHash: z.string().regex(/^sha256:[a-f0-9]{64}$/),
+    action: z.enum(["issue", "revoke"]),
+    ts: z.number().int().positive(),
+    logIndex: z.number().int().nonnegative(),
+    logRoot: z.string().min(1),
+    inclusionProof: z.array(z.string()),
+});
+export const DelegationResponseSchema = z.object({
+    delegation: DelegationSchema,
+    receipt: ReceiptSchema,
+    encryptedPayload: z.string().optional(), // For ktaEncrypted mode
+});
+/**
+ * Storage configuration for different deployment modes
+ */
+export const StorageConfigSchema = z.object({
+    mode: StorageModeSchema,
+    encryptionEnabled: z.boolean().default(false),
+    receiptVerificationEnabled: z.boolean().default(true),
+    ktaBaseURL: z.string().url().default("https://knowthat.ai"),
+});
+// Constants
+export const MCP_I_CAPABILITIES = [
+    "handshake",
+    "signing",
+    "verification",
+];
+export const CLAIM_TOKEN_TTL_HOURS = 24;
+export const KTA_BASE_URL = "https://knowthat.ai"; // Placeholder for docs/tests
+// Storage mode constants
+export const DEFAULT_STORAGE_MODE = "ktaEncrypted";
+export const STORAGE_MODE_ENV_VAR = "XMCPI_STORAGE_MODE";
+// Receipt schema constants
+export const RECEIPT_SCHEMA_ID = "https://schemas.kya.dev/xmcpi/receipt/v1.0.0.json";
+export const CONTENT_HASH_REGEX = /^sha256:[a-f0-9]{64}$/;
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/test.d.ts

@@ -0,0 +1,252 @@
+/**
+ * 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>;
+    deterministicKeys: z.ZodDefault<z.ZodBoolean>;
+    skipKTACalls: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    mode: "test";
+    deterministicKeys: boolean;
+    skipKTACalls: boolean;
+    seed?: string | undefined;
+}, {
+    mode: "test";
+    seed?: string | undefined;
+    deterministicKeys?: boolean | undefined;
+    skipKTACalls?: boolean | undefined;
+}>;
+export type TestEnvironment = z.infer<typeof TestEnvironmentSchema>;
+/**
+ * Mock identity configuration for testing
+ */
+export declare const MockIdentitySchema: z.ZodObject<{
+    did: z.ZodString;
+    keyId: z.ZodString;
+    privateKey: z.ZodString;
+    publicKey: z.ZodString;
+    createdAt: z.ZodString;
+    lastRotated: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    did: string;
+    keyId: string;
+    privateKey: string;
+    publicKey: string;
+    createdAt: string;
+    lastRotated: string;
+}, {
+    did: string;
+    keyId: string;
+    privateKey: string;
+    publicKey: string;
+    createdAt: string;
+    lastRotated: string;
+}>;
+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;
+        keyId: z.ZodString;
+        privateKey: z.ZodString;
+        publicKey: z.ZodString;
+        createdAt: z.ZodString;
+        lastRotated: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        did: string;
+        keyId: string;
+        privateKey: string;
+        publicKey: string;
+        createdAt: string;
+        lastRotated: string;
+    }, {
+        did: string;
+        keyId: string;
+        privateKey: string;
+        publicKey: string;
+        createdAt: string;
+        lastRotated: string;
+    }>>;
+    delegations: z.ZodRecord<z.ZodString, z.ZodEnum<["active", "revoked", "pending"]>>;
+    ktaFailures: z.ZodDefault<z.ZodArray<z.ZodEnum<["network", "auth", "invalid", "timeout"]>, "many">>;
+    deterministicSeed: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    identities: Record<string, {
+        did: string;
+        keyId: string;
+        privateKey: string;
+        publicKey: string;
+        createdAt: string;
+        lastRotated: string;
+    }>;
+    delegations: Record<string, "pending" | "active" | "revoked">;
+    ktaFailures: ("network" | "auth" | "invalid" | "timeout")[];
+    deterministicSeed?: string | undefined;
+}, {
+    identities: Record<string, {
+        did: string;
+        keyId: string;
+        privateKey: string;
+        publicKey: string;
+        createdAt: string;
+        lastRotated: string;
+    }>;
+    delegations: Record<string, "pending" | "active" | "revoked">;
+    ktaFailures?: ("network" | "auth" | "invalid" | "timeout")[] | undefined;
+    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>;
+    keyId: z.ZodOptional<z.ZodString>;
+    signature: z.ZodObject<{
+        valid: z.ZodBoolean;
+        algorithm: z.ZodString;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        valid: boolean;
+        algorithm: string;
+        error?: string | undefined;
+    }, {
+        valid: boolean;
+        algorithm: string;
+        error?: string | undefined;
+    }>;
+    proof: z.ZodObject<{
+        valid: z.ZodBoolean;
+        structure: z.ZodBoolean;
+        timestamps: z.ZodBoolean;
+        hashes: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        valid: boolean;
+        structure: boolean;
+        timestamps: boolean;
+        hashes: boolean;
+        error?: string | undefined;
+    }, {
+        valid: boolean;
+        structure: boolean;
+        timestamps: boolean;
+        hashes: boolean;
+        error?: string | undefined;
+    }>;
+    session: z.ZodObject<{
+        valid: z.ZodBoolean;
+        expired: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        valid: boolean;
+        expired: boolean;
+        error?: string | undefined;
+    }, {
+        valid: boolean;
+        expired: boolean;
+        error?: string | undefined;
+    }>;
+    errors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    valid: boolean;
+    warnings: string[];
+    session: {
+        valid: boolean;
+        expired: boolean;
+        error?: string | undefined;
+    };
+    signature: {
+        valid: boolean;
+        algorithm: string;
+        error?: string | undefined;
+    };
+    proof: {
+        valid: boolean;
+        structure: boolean;
+        timestamps: boolean;
+        hashes: boolean;
+        error?: string | undefined;
+    };
+    errors: string[];
+    did?: string | undefined;
+    keyId?: string | undefined;
+}, {
+    valid: boolean;
+    session: {
+        valid: boolean;
+        expired: boolean;
+        error?: string | undefined;
+    };
+    signature: {
+        valid: boolean;
+        algorithm: string;
+        error?: string | undefined;
+    };
+    proof: {
+        valid: boolean;
+        structure: boolean;
+        timestamps: boolean;
+        hashes: boolean;
+        error?: string | undefined;
+    };
+    did?: string | undefined;
+    keyId?: string | undefined;
+    warnings?: string[] | undefined;
+    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";
+    readonly VERIFIER_1: "did:test:verifier-1";
+};
+export declare const TEST_KEY_IDS: {
+    readonly KEY_TEST_1: "key-test-1";
+    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";
+    readonly LOCAL_VERIFICATION_FAILED: "XMCP_I_TEST_LOCAL_VERIFICATION_FAILED";
+    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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,0BAA0B,6CAIrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,wBAAwB,sDAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX,MAAM,MAAM,aAAa,GACvB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/test.js

@@ -0,0 +1,115 @@
+/**
+ * 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 const TestEnvironmentSchema = z.object({
+    mode: z.literal("test"),
+    seed: z.string().optional(),
+    deterministicKeys: z.boolean().default(true),
+    skipKTACalls: z.boolean().default(true),
+});
+/**
+ * Mock identity configuration for testing
+ */
+export const MockIdentitySchema = z.object({
+    did: z.string(),
+    keyId: z.string(),
+    privateKey: z.string(),
+    publicKey: z.string(),
+    createdAt: z.string(),
+    lastRotated: z.string(),
+});
+/**
+ * Mock delegation status for testing
+ */
+export const MockDelegationStatusSchema = z.enum([
+    "active",
+    "revoked",
+    "pending",
+]);
+/**
+ * Mock KTA failure scenarios for testing
+ */
+export const MockKTAFailureTypeSchema = z.enum([
+    "network",
+    "auth",
+    "invalid",
+    "timeout",
+]);
+/**
+ * Mock identity provider configuration
+ */
+export const MockIdentityProviderConfigSchema = z.object({
+    identities: z.record(z.string(), MockIdentitySchema),
+    delegations: z.record(z.string(), MockDelegationStatusSchema),
+    ktaFailures: z.array(MockKTAFailureTypeSchema).default([]),
+    deterministicSeed: z.string().optional(),
+});
+/**
+ * Local verification result for offline testing
+ */
+export const LocalVerificationResultSchema = z.object({
+    valid: z.boolean(),
+    did: z.string().optional(),
+    keyId: z.string().optional(),
+    signature: z.object({
+        valid: z.boolean(),
+        algorithm: z.string(),
+        error: z.string().optional(),
+    }),
+    proof: z.object({
+        valid: z.boolean(),
+        structure: z.boolean(),
+        timestamps: z.boolean(),
+        hashes: z.boolean(),
+        error: z.string().optional(),
+    }),
+    session: z.object({
+        valid: z.boolean(),
+        expired: z.boolean(),
+        error: z.string().optional(),
+    }),
+    errors: z.array(z.string()).default([]),
+    warnings: z.array(z.string()).default([]),
+});
+/**
+ * Test DID and Key ID constants
+ */
+export const TEST_DIDS = {
+    AGENT_1: "did:test:agent-1",
+    AGENT_2: "did:test:agent-2",
+    VERIFIER_1: "did:test:verifier-1",
+};
+export const TEST_KEY_IDS = {
+    KEY_TEST_1: "key-test-1",
+    KEY_TEST_2: "key-test-2",
+    KEY_VERIFIER_1: "key-verifier-1",
+};
+/**
+ * Test environment detection
+ */
+export function isTestEnvironment() {
+    return process.env.XMCP_ENV === "test";
+}
+/**
+ * Get test seed from environment or test name
+ */
+export function getTestSeed(testName) {
+    return process.env.XMCP_TEST_SEED || testName || "default-test-seed";
+}
+/**
+ * Error codes for test infrastructure
+ */
+export const 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/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"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"}

package/dist/verifier.d.ts

@@ -0,0 +1,136 @@
+import { z } from "zod";
+/**
+ * Verifier middleware schemas and headers
+ */
+export declare const AgentContextSchema: z.ZodObject<{
+    did: z.ZodString;
+    keyId: z.ZodString;
+    subject: z.ZodOptional<z.ZodString>;
+    scopes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    session: z.ZodString;
+    confidence: z.ZodLiteral<"verified">;
+    delegationRef: z.ZodOptional<z.ZodString>;
+    registry: z.ZodString;
+    verifiedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    did: string;
+    keyId: string;
+    session: string;
+    scopes: string[];
+    confidence: "verified";
+    registry: string;
+    verifiedAt: number;
+    delegationRef?: string | undefined;
+    subject?: string | undefined;
+}, {
+    did: string;
+    keyId: string;
+    session: string;
+    confidence: "verified";
+    registry: string;
+    verifiedAt: number;
+    delegationRef?: string | undefined;
+    subject?: string | undefined;
+    scopes?: string[] | undefined;
+}>;
+export declare const VerifierResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodAny>;
+        httpStatus: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        httpStatus: number;
+        details?: any;
+    }, {
+        code: string;
+        message: string;
+        httpStatus: number;
+        details?: any;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    error?: {
+        code: string;
+        message: string;
+        httpStatus: number;
+        details?: any;
+    } | undefined;
+    headers?: Record<string, string> | undefined;
+}, {
+    success: boolean;
+    error?: {
+        code: string;
+        message: string;
+        httpStatus: number;
+        details?: any;
+    } | undefined;
+    headers?: Record<string, string> | undefined;
+}>;
+export declare const StructuredErrorSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodOptional<z.ZodString>;
+        expected: z.ZodOptional<z.ZodAny>;
+        received: z.ZodOptional<z.ZodAny>;
+        remediation: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        expected?: any;
+        received?: any;
+        reason?: string | undefined;
+        remediation?: string | undefined;
+    }, {
+        expected?: any;
+        received?: any;
+        reason?: string | undefined;
+        remediation?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    details?: {
+        expected?: any;
+        received?: any;
+        reason?: string | undefined;
+        remediation?: string | undefined;
+    } | undefined;
+}, {
+    code: string;
+    message: string;
+    details?: {
+        expected?: any;
+        received?: any;
+        reason?: string | undefined;
+        remediation?: string | undefined;
+    } | undefined;
+}>;
+export type AgentContext = z.infer<typeof AgentContextSchema>;
+export type VerifierResult = z.infer<typeof VerifierResultSchema>;
+export type StructuredError = z.infer<typeof StructuredErrorSchema>;
+export declare const AGENT_HEADERS: {
+    readonly DID: "X-Agent-DID";
+    readonly KEY_ID: "X-Agent-KeyId";
+    readonly SUBJECT: "X-Agent-Subject";
+    readonly SCOPES: "X-Agent-Scopes";
+    readonly SESSION: "X-Agent-Session";
+    readonly CONFIDENCE: "X-Agent-Confidence";
+    readonly DELEGATION_REF: "X-Agent-Delegation-Ref";
+    readonly REGISTRY: "X-Agent-Registry";
+    readonly VERIFIED_AT: "X-Agent-Verified-At";
+};
+export declare const ERROR_HTTP_STATUS: {
+    readonly XMCP_I_EBADPROOF: 403;
+    readonly XMCP_I_ENOIDENTITY: 500;
+    readonly XMCP_I_EMIRRORPENDING: 200;
+    readonly XMCP_I_EHANDSHAKE: 401;
+    readonly XMCP_I_ESESSION: 401;
+    readonly XMCP_I_ECLAIM: 400;
+    readonly XMCP_I_ECONFIG: 500;
+    readonly XMCP_I_ERUNTIME: 500;
+};
+//# sourceMappingURL=verifier.d.ts.map

package/dist/verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../src/verifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWhC,CAAC;AAGH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,eAAO,MAAM,aAAa;;;;;;;;;;CAUhB,CAAC;AAGX,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC"}