@kya-os/mcp 1.2.0

package/dist/types/protocol.d.ts

@@ -0,0 +1,320 @@
+/**
+ * MCP-I Protocol Types
+ *
+ * Inlined type definitions for the MCP-I protocol reference implementation.
+ * All types are pure TypeScript — no external dependencies.
+ *
+ * Related Spec: MCP-I §3, §4, §5, §6
+ */
+export interface CrispBudget {
+    unit: 'USD' | 'ops' | 'points';
+    cap: number;
+    window?: {
+        kind: 'rolling' | 'fixed';
+        durationSec: number;
+    };
+}
+export interface CrispScope {
+    resource: string;
+    matcher: 'exact' | 'prefix' | 'regex';
+    constraints?: Record<string, unknown>;
+}
+export interface DelegationConstraints {
+    notBefore?: number;
+    notAfter?: number;
+    scopes?: string[];
+    audience?: string | string[];
+    crisp?: {
+        budget?: CrispBudget;
+        scopes: CrispScope[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export type DelegationStatus = 'active' | 'revoked' | 'expired';
+export interface DelegationRecord {
+    id: string;
+    issuerDid: string;
+    subjectDid: string;
+    controller?: string;
+    vcId: string;
+    parentId?: string;
+    constraints: DelegationConstraints;
+    signature: string;
+    status: DelegationStatus;
+    createdAt?: number;
+    revokedAt?: number;
+    revokedReason?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface Proof {
+    type: string;
+    created?: string;
+    verificationMethod?: string;
+    proofPurpose?: string;
+    proofValue?: string;
+    jws?: string;
+    [key: string]: unknown;
+}
+export interface CredentialStatus {
+    id: string;
+    type: 'StatusList2021Entry';
+    statusPurpose: 'revocation' | 'suspension';
+    statusListIndex: string;
+    statusListCredential: string;
+    [key: string]: unknown;
+}
+export interface DelegationCredentialSubject {
+    id: string;
+    delegation: {
+        id: string;
+        issuerDid: string;
+        subjectDid: string;
+        userDid?: string;
+        userIdentifier?: string;
+        sessionId?: string;
+        scopes?: string[];
+        controller?: string;
+        parentId?: string;
+        constraints: DelegationConstraints;
+        status: DelegationStatus;
+        createdAt?: number;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface DelegationCredential {
+    '@context': (string | Record<string, unknown>)[];
+    id?: string;
+    type: string[];
+    issuer: string | {
+        id: string;
+        [key: string]: unknown;
+    };
+    issuanceDate: string;
+    expirationDate?: string;
+    credentialSubject: DelegationCredentialSubject;
+    credentialStatus?: CredentialStatus;
+    proof?: Proof;
+    [key: string]: unknown;
+}
+export declare const DELEGATION_CREDENTIAL_CONTEXT: "https://schema.modelcontextprotocol-identity.io/xmcp-i/credentials/delegation.v1.0.0.json";
+export interface StatusList2021Credential {
+    '@context': (string | Record<string, unknown>)[];
+    id: string;
+    type: string[];
+    issuer: string | {
+        id: string;
+    };
+    issuanceDate: string;
+    credentialSubject: {
+        id?: string;
+        type: 'StatusList2021';
+        statusPurpose: 'revocation' | 'suspension';
+        encodedList: string;
+    };
+    proof?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Wrap a DelegationRecord in an unsigned W3C VC structure.
+ */
+export declare function wrapDelegationAsVC(delegation: DelegationRecord, options?: {
+    id?: string;
+    issuanceDate?: string;
+    expirationDate?: string;
+    credentialStatus?: CredentialStatus;
+    userDid?: string;
+    userIdentifier?: string;
+    sessionId?: string;
+    scopes?: string[];
+}): Omit<DelegationCredential, 'proof'>;
+/**
+ * Extract a DelegationRecord from a DelegationCredential.
+ */
+export declare function extractDelegationFromVC(vc: DelegationCredential): DelegationRecord;
+/**
+ * Check if a DelegationCredential is expired.
+ */
+export declare function isDelegationCredentialExpired(vc: DelegationCredential): boolean;
+/**
+ * Check if a DelegationCredential is not yet valid.
+ */
+export declare function isDelegationCredentialNotYetValid(vc: DelegationCredential): boolean;
+/**
+ * Validate a DelegationCredential.
+ * Returns a Zod-compatible result shape.
+ */
+export declare function validateDelegationCredential(vc: unknown): {
+    success: boolean;
+    error?: {
+        message: string;
+    };
+    data?: DelegationCredential;
+};
+export interface MCPClientInfo {
+    name: string;
+    title?: string;
+    version?: string;
+    platform?: string;
+    vendor?: string;
+    persistentId?: string;
+}
+export interface MCPClientSessionInfo extends MCPClientInfo {
+    clientId: string;
+    protocolVersion?: string;
+    capabilities?: Record<string, unknown>;
+}
+export interface HandshakeRequest {
+    nonce: string;
+    audience: string;
+    timestamp: number;
+    agentDid?: string;
+    clientInfo?: MCPClientInfo & {
+        clientId?: string;
+    };
+    clientProtocolVersion?: string;
+    clientCapabilities?: Record<string, unknown>;
+}
+export type SessionIdentityState = 'anonymous' | 'authenticated';
+export interface SessionContext {
+    sessionId: string;
+    audience: string;
+    nonce: string;
+    timestamp: number;
+    createdAt: number;
+    lastActivity: number;
+    ttlMinutes: number;
+    agentDid?: string;
+    serverDid?: string;
+    clientDid?: string;
+    userDid?: string;
+    clientInfo?: MCPClientSessionInfo;
+    identityState: SessionIdentityState;
+    oauthIdentity?: {
+        provider: string;
+        subject: string;
+        email?: string;
+        name?: string;
+    };
+    delegationRef?: string;
+    delegationChain?: string;
+    delegationScopes?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Nonce cache interface for replay prevention.
+ */
+export interface NonceCache {
+    has(nonce: string, agentDid?: string): Promise<boolean>;
+    add(nonce: string, ttl: number, agentDid?: string): Promise<void>;
+    cleanup(): Promise<void>;
+}
+export declare const DEFAULT_SESSION_TTL_MINUTES = 30;
+export declare const DEFAULT_TIMESTAMP_SKEW_SECONDS = 120;
+export declare const NONCE_LENGTH_BYTES = 16;
+export interface ProofMeta {
+    did: string;
+    kid: string;
+    ts: number;
+    nonce: string;
+    audience: string;
+    sessionId: string;
+    requestHash: string;
+    responseHash: string;
+    scopeId?: string;
+    delegationRef?: string;
+    clientDid?: string;
+}
+export interface DetachedProof {
+    jws: string;
+    meta: ProofMeta;
+}
+export interface CanonicalHashes {
+    requestHash: string;
+    responseHash: string;
+}
+export interface AuditRecord {
+    version: 'audit.v1';
+    ts: number;
+    session: string;
+    audience: string;
+    did: string;
+    kid: string;
+    reqHash: string;
+    resHash: string;
+    verified: 'yes' | 'no';
+    scope: string;
+}
+export interface AuditContext {
+    identity: {
+        did: string;
+        kid: string;
+        [key: string]: unknown;
+    };
+    session: {
+        sessionId: string;
+        audience: string;
+        [key: string]: unknown;
+    };
+    requestHash: string;
+    responseHash: string;
+    verified: 'yes' | 'no';
+    scopeId?: string;
+}
+export interface AuditEventContext {
+    eventType: string;
+    identity: {
+        did: string;
+        kid: string;
+        [key: string]: unknown;
+    };
+    session: {
+        sessionId: string;
+        audience: string;
+        [key: string]: unknown;
+    };
+    eventData?: Record<string, unknown>;
+}
+export interface AuthorizationDisplay {
+    title?: string;
+    hint?: Array<'link' | 'qr' | 'code'>;
+    authorizationCode?: string;
+    qrUrl?: string;
+    [key: string]: unknown;
+}
+export interface NeedsAuthorizationError {
+    error: 'needs_authorization';
+    message: string;
+    authorizationUrl: string;
+    resumeToken: string;
+    expiresAt: number;
+    scopes: string[];
+    display?: AuthorizationDisplay;
+    context?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export declare function createNeedsAuthorizationError(config: {
+    message: string;
+    authorizationUrl: string;
+    resumeToken: string;
+    expiresAt: number;
+    scopes: string[];
+    display?: AuthorizationDisplay;
+}): NeedsAuthorizationError;
+export declare function isNeedsAuthorizationError(error: unknown): error is NeedsAuthorizationError;
+/**
+ * Validate a DetachedProof structure.
+ * Returns a Zod-compatible result shape.
+ */
+export declare function validateDetachedProof(proof: unknown): {
+    success: boolean;
+    error?: {
+        message: string;
+        errors?: Array<{
+            message: string;
+        }>;
+    };
+    data?: DetachedProof;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/types/protocol.d.ts.map

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

package/dist/types/protocol.js

@@ -0,0 +1,229 @@
+/**
+ * MCP-I Protocol Types
+ *
+ * Inlined type definitions for the MCP-I protocol reference implementation.
+ * All types are pure TypeScript — no external dependencies.
+ *
+ * Related Spec: MCP-I §3, §4, §5, §6
+ */
+export const DELEGATION_CREDENTIAL_CONTEXT = 'https://schema.modelcontextprotocol-identity.io/xmcp-i/credentials/delegation.v1.0.0.json';
+// ============================================================================
+// Delegation VC utility functions
+// ============================================================================
+/**
+ * Wrap a DelegationRecord in an unsigned W3C VC structure.
+ */
+export function wrapDelegationAsVC(delegation, options) {
+    const now = new Date().toISOString();
+    const expirationDate = delegation.constraints.notAfter
+        ? new Date(delegation.constraints.notAfter * 1000).toISOString()
+        : options?.expirationDate;
+    let issuanceDate = options?.issuanceDate || now;
+    if (!options?.issuanceDate && delegation.createdAt) {
+        issuanceDate = new Date(delegation.createdAt).toISOString();
+    }
+    const scopes = options?.scopes || delegation.constraints.scopes;
+    return {
+        '@context': [
+            'https://www.w3.org/2018/credentials/v1',
+            DELEGATION_CREDENTIAL_CONTEXT,
+        ],
+        id: options?.id || delegation.vcId || `urn:uuid:${delegation.id}`,
+        type: ['VerifiableCredential', 'DelegationCredential'],
+        issuer: delegation.issuerDid,
+        issuanceDate,
+        ...(expirationDate !== undefined && { expirationDate }),
+        credentialSubject: {
+            id: delegation.subjectDid,
+            delegation: {
+                id: delegation.id,
+                issuerDid: delegation.issuerDid,
+                subjectDid: delegation.subjectDid,
+                ...(options?.userDid && { userDid: options.userDid }),
+                ...(options?.userIdentifier && { userIdentifier: options.userIdentifier }),
+                ...(options?.sessionId && { sessionId: options.sessionId }),
+                ...(scopes && scopes.length > 0 && { scopes }),
+                ...(delegation.controller !== undefined && { controller: delegation.controller }),
+                ...(delegation.parentId !== undefined && { parentId: delegation.parentId }),
+                constraints: delegation.constraints,
+                status: delegation.status,
+                ...(delegation.createdAt !== undefined && { createdAt: delegation.createdAt }),
+                ...(delegation.metadata !== undefined && { metadata: delegation.metadata }),
+            },
+        },
+        ...(options?.credentialStatus !== undefined && { credentialStatus: options.credentialStatus }),
+    };
+}
+/**
+ * Extract a DelegationRecord from a DelegationCredential.
+ */
+export function extractDelegationFromVC(vc) {
+    const delegation = vc.credentialSubject.delegation;
+    let signature = '';
+    if (vc.proof) {
+        const proof = vc.proof;
+        signature = (proof['proofValue'] || proof['jws'] || proof['signatureValue'] || '');
+    }
+    return {
+        id: delegation.id,
+        issuerDid: delegation.issuerDid,
+        subjectDid: delegation.subjectDid,
+        controller: delegation.controller,
+        vcId: vc.id || `vc:${delegation.id}`,
+        parentId: delegation.parentId,
+        constraints: delegation.constraints,
+        signature,
+        status: delegation.status,
+        createdAt: delegation.createdAt,
+        revokedAt: undefined,
+        revokedReason: undefined,
+        metadata: delegation.metadata,
+    };
+}
+/**
+ * Check if a DelegationCredential is expired.
+ */
+export function isDelegationCredentialExpired(vc) {
+    if (vc.expirationDate) {
+        if (new Date(vc.expirationDate) < new Date()) {
+            return true;
+        }
+    }
+    const delegation = vc.credentialSubject.delegation;
+    if (delegation.constraints.notAfter) {
+        const nowSec = Math.floor(Date.now() / 1000);
+        if (nowSec > delegation.constraints.notAfter) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a DelegationCredential is not yet valid.
+ */
+export function isDelegationCredentialNotYetValid(vc) {
+    const delegation = vc.credentialSubject.delegation;
+    if (delegation.constraints.notBefore) {
+        const nowSec = Math.floor(Date.now() / 1000);
+        if (nowSec < delegation.constraints.notBefore) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Validate a DelegationCredential.
+ * Returns a Zod-compatible result shape.
+ */
+export function validateDelegationCredential(vc) {
+    if (!vc || typeof vc !== 'object') {
+        return { success: false, error: { message: 'Not an object' } };
+    }
+    const v = vc;
+    // Check @context
+    if (!Array.isArray(v['@context']) || v['@context'].length === 0) {
+        return { success: false, error: { message: 'Missing or invalid @context' } };
+    }
+    if (v['@context'][0] !== 'https://www.w3.org/2018/credentials/v1') {
+        return { success: false, error: { message: 'First @context must be W3C VC context' } };
+    }
+    // Check type
+    if (!Array.isArray(v['type'])) {
+        return { success: false, error: { message: 'Missing type array' } };
+    }
+    if (!v['type'].includes('VerifiableCredential') || !v['type'].includes('DelegationCredential')) {
+        return { success: false, error: { message: 'type must include VerifiableCredential and DelegationCredential' } };
+    }
+    // Check issuer
+    if (!v['issuer'] || (typeof v['issuer'] !== 'string' && typeof v['issuer'] !== 'object')) {
+        return { success: false, error: { message: 'Missing or invalid issuer' } };
+    }
+    // Check issuanceDate
+    if (!v['issuanceDate'] || typeof v['issuanceDate'] !== 'string') {
+        return { success: false, error: { message: 'Missing issuanceDate' } };
+    }
+    // Check credentialSubject
+    const cs = v['credentialSubject'];
+    if (!cs || typeof cs !== 'object') {
+        return { success: false, error: { message: 'Missing credentialSubject' } };
+    }
+    if (!cs['id'] || typeof cs['id'] !== 'string') {
+        return { success: false, error: { message: 'credentialSubject.id missing' } };
+    }
+    const del = cs['delegation'];
+    if (!del || typeof del !== 'object') {
+        return { success: false, error: { message: 'credentialSubject.delegation missing' } };
+    }
+    if (!del['id'] || !del['issuerDid'] || !del['subjectDid'] || !del['constraints']) {
+        return { success: false, error: { message: 'delegation fields missing' } };
+    }
+    return { success: true, data: vc };
+}
+export const DEFAULT_SESSION_TTL_MINUTES = 30;
+export const DEFAULT_TIMESTAMP_SKEW_SECONDS = 120;
+export const NONCE_LENGTH_BYTES = 16;
+export function createNeedsAuthorizationError(config) {
+    return {
+        error: 'needs_authorization',
+        ...config,
+    };
+}
+export function isNeedsAuthorizationError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        error['error'] === 'needs_authorization');
+}
+// ============================================================================
+// DetachedProof validation
+// ============================================================================
+const HASH_REGEX = /^sha256:[a-f0-9]{64}$/;
+/**
+ * Validate a DetachedProof structure.
+ * Returns a Zod-compatible result shape.
+ */
+export function validateDetachedProof(proof) {
+    if (!proof || typeof proof !== 'object') {
+        return { success: false, error: { message: 'Not an object' } };
+    }
+    const p = proof;
+    // Validate jws
+    if (typeof p['jws'] !== 'string' || p['jws'].length < 1) {
+        return { success: false, error: { message: 'jws must be a non-empty string' } };
+    }
+    // Validate meta
+    const meta = p['meta'];
+    if (!meta || typeof meta !== 'object') {
+        return { success: false, error: { message: 'meta must be an object' } };
+    }
+    const m = meta;
+    // Required string fields
+    const requiredStrings = ['did', 'kid', 'nonce', 'audience', 'sessionId'];
+    for (const field of requiredStrings) {
+        if (typeof m[field] !== 'string' || m[field].length < 1) {
+            return { success: false, error: { message: `meta.${field} must be a non-empty string` } };
+        }
+    }
+    // Validate ts (positive integer)
+    if (typeof m['ts'] !== 'number' || !Number.isInteger(m['ts']) || m['ts'] <= 0) {
+        return { success: false, error: { message: 'meta.ts must be a positive integer' } };
+    }
+    // Validate hash fields
+    const hashFields = ['requestHash', 'responseHash'];
+    for (const field of hashFields) {
+        if (typeof m[field] !== 'string' || !HASH_REGEX.test(m[field])) {
+            return { success: false, error: { message: `meta.${field} must match sha256:<64 hex chars>` } };
+        }
+    }
+    // Optional string fields
+    const optionalStrings = ['scopeId', 'delegationRef', 'clientDid'];
+    for (const field of optionalStrings) {
+        if (m[field] !== undefined && typeof m[field] !== 'string') {
+            return { success: false, error: { message: `meta.${field} must be a string if present` } };
+        }
+    }
+    return {
+        success: true,
+        data: proof,
+    };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/types/protocol.js.map

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

package/dist/utils/base58.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Base58 Utilities (Bitcoin alphabet)
+ *
+ * Encoding and decoding utilities for Base58 (Bitcoin alphabet).
+ * Used for did:key multibase encoding (with 'z' prefix for base58btc).
+ *
+ * The Bitcoin alphabet excludes ambiguous characters (0, O, I, l).
+ */
+/**
+ * Encode bytes to Base58 (Bitcoin alphabet)
+ *
+ * @param bytes - Bytes to encode
+ * @returns Base58-encoded string
+ */
+export declare function base58Encode(bytes: Uint8Array): string;
+/**
+ * Decode Base58 (Bitcoin alphabet) to bytes
+ *
+ * @param encoded - Base58-encoded string
+ * @returns Decoded bytes
+ * @throws Error if input contains invalid characters
+ */
+export declare function base58Decode(encoded: string): Uint8Array;
+/**
+ * Validate a Base58 string
+ *
+ * @param encoded - String to validate
+ * @returns true if valid Base58, false otherwise
+ */
+export declare function isValidBase58(encoded: string): boolean;
+//# sourceMappingURL=base58.d.ts.map

package/dist/utils/base58.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.d.ts","sourceRoot":"","sources":["../../src/utils/base58.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAyBtD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAoCxD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUtD"}