@cyanheads/mcp-ts-core 0.1.0-beta.12

package/dist/config/index.js

@@ -0,0 +1,464 @@
+/**
+ * @fileoverview Loads, validates, and exports application configuration.
+ * This module centralizes configuration management, sourcing values from
+ * environment variables. It uses Zod for schema validation to ensure type safety
+ * and correctness of configuration parameters, and is designed to be
+ * environment-agnostic (e.g., Node.js, Cloudflare Workers).
+ *
+ * @module src/config/index
+ */
+import { dirname, isAbsolute, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import dotenv from 'dotenv';
+import { z } from 'zod';
+import packageJson from '../../package.json' with { type: 'json' };
+import { JsonRpcErrorCode, McpError } from '../types-global/errors.js';
+import { runtimeCaps } from '../utils/internal/runtime.js';
+const packageManifest = packageJson;
+// Suppress dotenv's noisy initial log message as suggested by its output.
+dotenv.config({ quiet: true });
+// --- Helper Functions ---
+const emptyStringAsUndefined = (val) => {
+    if (typeof val === 'string' && val.trim() === '') {
+        return;
+    }
+    return val;
+};
+// --- Schema Definition ---
+const ConfigSchema = z
+    .object({
+    // Package information sourced from environment variables
+    pkg: z.object({
+        name: z.string(),
+        version: z.string(),
+        description: z.string().optional(),
+    }),
+    mcpServerName: z.string(), // Will be derived from pkg.name
+    mcpServerVersion: z.string(), // Will be derived from pkg.version
+    mcpServerDescription: z.string().optional(), // Will be derived from pkg.description
+    logLevel: z
+        .preprocess((val) => {
+        const str = emptyStringAsUndefined(val);
+        if (typeof str === 'string') {
+            const lower = str.toLowerCase();
+            // Normalize common aliases to RFC5424/MCP log level names
+            const aliasMap = {
+                warn: 'warning',
+                err: 'error',
+                information: 'info',
+                fatal: 'emerg',
+                trace: 'debug',
+                silent: 'emerg',
+            };
+            return aliasMap[lower] ?? lower;
+        }
+        return str;
+    }, z.enum(['debug', 'info', 'notice', 'warning', 'error', 'crit', 'alert', 'emerg']))
+        .default('debug'),
+    logsPath: z.string().optional(), // Made optional as it's Node-specific
+    environment: z
+        .preprocess((val) => {
+        const str = emptyStringAsUndefined(val);
+        if (typeof str === 'string') {
+            const lower = str.toLowerCase();
+            const aliasMap = {
+                dev: 'development',
+                prod: 'production',
+                test: 'testing',
+            };
+            return aliasMap[lower] ?? lower;
+        }
+        return str;
+    }, z.enum(['development', 'production', 'testing']))
+        .default('development'),
+    mcpTransportType: z.preprocess(emptyStringAsUndefined, z.enum(['stdio', 'http']).default('stdio')),
+    mcpSessionMode: z.preprocess(emptyStringAsUndefined, z.enum(['stateless', 'stateful', 'auto']).default('auto')),
+    mcpResponseVerbosity: z.preprocess(emptyStringAsUndefined, z.enum(['minimal', 'standard', 'full']).default('standard')),
+    mcpHttpPort: z.coerce.number().min(0).max(65535).default(3010),
+    mcpHttpHost: z.string().default('127.0.0.1'),
+    mcpHttpEndpointPath: z.string().default('/mcp'),
+    mcpHttpMaxPortRetries: z.coerce.number().default(15),
+    mcpHttpPortRetryDelayMs: z.coerce.number().default(50),
+    mcpStatefulSessionStaleTimeoutMs: z.coerce.number().default(1_800_000),
+    mcpAllowedOrigins: z.array(z.string()).optional(),
+    mcpAuthSecretKey: z.string().optional(),
+    mcpAuthMode: z.preprocess(emptyStringAsUndefined, z.enum(['jwt', 'oauth', 'none']).default('none')),
+    oauthIssuerUrl: z.url().optional(),
+    oauthJwksUri: z.url().optional(),
+    oauthAudience: z.string().optional(),
+    oauthJwksCooldownMs: z.coerce.number().default(300_000), // 5 minutes
+    oauthJwksTimeoutMs: z.coerce.number().default(5_000), // 5 seconds
+    mcpServerResourceIdentifier: z.url().optional(), // RFC 8707 resource indicator
+    devMcpAuthBypass: z
+        .preprocess((val) => {
+        if (val === undefined || val === null || val === '')
+            return false;
+        const str = String(val).toLowerCase().trim();
+        return str === 'true' || str === '1';
+    }, z.boolean())
+        .default(false),
+    devMcpClientId: z.string().optional(),
+    devMcpScopes: z.array(z.string()).optional(),
+    openrouterAppUrl: z.string().default('http://localhost:3000'),
+    openrouterAppName: z.string(),
+    openrouterApiKey: z.string().optional(),
+    llmDefaultModel: z.string().default('google/gemini-2.5-flash-preview-05-20'),
+    llmDefaultTemperature: z.coerce.number().optional(),
+    llmDefaultTopP: z.coerce.number().optional(),
+    llmDefaultMaxTokens: z.coerce.number().optional(),
+    llmDefaultTopK: z.coerce.number().optional(),
+    llmDefaultMinP: z.coerce.number().optional(),
+    oauthProxy: z
+        .object({
+        authorizationUrl: z.url().optional(),
+        tokenUrl: z.url().optional(),
+        revocationUrl: z.url().optional(),
+        issuerUrl: z.url().optional(),
+        serviceDocumentationUrl: z.url().optional(),
+        defaultClientRedirectUris: z.array(z.string()).optional(),
+    })
+        .optional(),
+    supabase: z
+        .object({
+        url: z.url(),
+        anonKey: z.string(),
+        serviceRoleKey: z.string().optional(),
+    })
+        .optional(),
+    storage: z.object({
+        providerType: z
+            .preprocess((val) => {
+            const str = emptyStringAsUndefined(val);
+            if (typeof str === 'string') {
+                const lower = str.toLowerCase();
+                const aliasMap = {
+                    mem: 'in-memory',
+                    fs: 'filesystem',
+                };
+                return aliasMap[lower] ?? lower;
+            }
+            return str;
+        }, z.enum([
+            'in-memory',
+            'filesystem',
+            'supabase',
+            'cloudflare-r2',
+            'cloudflare-kv',
+            'cloudflare-d1',
+        ]))
+            .default('in-memory'),
+        filesystemPath: z.string().default('./.storage'), // This remains, but will only be used if providerType is 'filesystem'
+    }),
+    // Experimental: Task store configuration
+    tasks: z.object({
+        storeType: z
+            .preprocess((val) => {
+            const str = emptyStringAsUndefined(val);
+            if (typeof str === 'string') {
+                const lower = str.toLowerCase();
+                const aliasMap = {
+                    mem: 'in-memory',
+                    memory: 'in-memory',
+                    persistent: 'storage',
+                };
+                return aliasMap[lower] ?? lower;
+            }
+            return str;
+        }, z.enum(['in-memory', 'storage']))
+            .default('in-memory'),
+        tenantId: z.string().default('system-tasks'),
+        defaultTtlMs: z.coerce.number().nullable().optional(),
+    }),
+    openTelemetry: z.object({
+        enabled: z.coerce.boolean().default(false),
+        serviceName: z.string(),
+        serviceVersion: z.string(),
+        tracesEndpoint: z.url().optional(),
+        metricsEndpoint: z.url().optional(),
+        samplingRatio: z.coerce.number().min(0).max(1).default(1.0),
+        logLevel: z
+            .preprocess((val) => {
+            const str = emptyStringAsUndefined(val);
+            if (typeof str === 'string') {
+                const lower = str.toLowerCase();
+                const aliasMap = {
+                    err: 'ERROR',
+                    warning: 'WARN',
+                    information: 'INFO',
+                };
+                return aliasMap[lower] ?? str.toUpperCase();
+            }
+            return str;
+        }, z.enum(['NONE', 'ERROR', 'WARN', 'INFO', 'DEBUG', 'VERBOSE', 'ALL']))
+            .default('INFO'),
+    }),
+    speech: z
+        .object({
+        tts: z
+            .object({
+            enabled: z.coerce.boolean().default(false),
+            provider: z.enum(['elevenlabs']).default('elevenlabs'),
+            apiKey: z.string().optional(),
+            baseUrl: z.url().optional(),
+            defaultVoiceId: z.string().optional(),
+            defaultModelId: z.string().optional(),
+            timeout: z.coerce.number().optional(),
+        })
+            .optional(),
+        stt: z
+            .object({
+            enabled: z.coerce.boolean().default(false),
+            provider: z.enum(['openai-whisper']).default('openai-whisper'),
+            apiKey: z.string().optional(),
+            baseUrl: z.url().optional(),
+            defaultModelId: z.string().optional(),
+            timeout: z.coerce.number().optional(),
+        })
+            .optional(),
+    })
+        .optional(),
+})
+    .superRefine((data, ctx) => {
+    // Production guard: reject dev bypass in production regardless of auth mode
+    if (data.environment === 'production' && data.devMcpAuthBypass) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ['devMcpAuthBypass'],
+            message: 'DEV_MCP_AUTH_BYPASS cannot be enabled in production (NODE_ENV=production). This flag is for development only.',
+        });
+    }
+    // JWT mode: require secret key of sufficient length (unless dev bypass is on)
+    if (data.mcpAuthMode === 'jwt' && !data.devMcpAuthBypass) {
+        if (!data.mcpAuthSecretKey) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['mcpAuthSecretKey'],
+                message: 'MCP_AUTH_SECRET_KEY is required when MCP_AUTH_MODE=jwt (set DEV_MCP_AUTH_BYPASS=true to skip in development).',
+            });
+        }
+        else if (data.mcpAuthSecretKey.length < 32) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['mcpAuthSecretKey'],
+                message: 'MCP_AUTH_SECRET_KEY must be at least 32 characters for JWT mode.',
+            });
+        }
+    }
+    // OAuth mode: require issuer URL and audience
+    if (data.mcpAuthMode === 'oauth') {
+        if (!data.oauthIssuerUrl) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['oauthIssuerUrl'],
+                message: 'OAUTH_ISSUER_URL is required when MCP_AUTH_MODE=oauth.',
+            });
+        }
+        if (!data.oauthAudience) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ['oauthAudience'],
+                message: 'OAUTH_AUDIENCE is required when MCP_AUTH_MODE=oauth.',
+            });
+        }
+    }
+});
+// --- Parsing Logic ---
+const parseConfig = () => {
+    const env = process.env;
+    const rawConfig = {
+        pkg: {
+            name: env.PACKAGE_NAME ?? packageManifest.name,
+            version: env.PACKAGE_VERSION ?? packageManifest.version,
+            description: env.PACKAGE_DESCRIPTION ?? packageManifest.description,
+        },
+        logLevel: env.MCP_LOG_LEVEL,
+        logsPath: env.LOGS_DIR,
+        environment: env.NODE_ENV,
+        mcpTransportType: env.MCP_TRANSPORT_TYPE,
+        mcpSessionMode: env.MCP_SESSION_MODE,
+        mcpResponseVerbosity: env.MCP_RESPONSE_VERBOSITY,
+        mcpHttpPort: env.MCP_HTTP_PORT,
+        mcpHttpHost: env.MCP_HTTP_HOST,
+        mcpHttpEndpointPath: env.MCP_HTTP_ENDPOINT_PATH,
+        mcpHttpMaxPortRetries: env.MCP_HTTP_MAX_PORT_RETRIES,
+        mcpHttpPortRetryDelayMs: env.MCP_HTTP_PORT_RETRY_DELAY_MS,
+        mcpStatefulSessionStaleTimeoutMs: env.MCP_STATEFUL_SESSION_STALE_TIMEOUT_MS,
+        mcpAllowedOrigins: env.MCP_ALLOWED_ORIGINS?.split(',')
+            .map((o) => o.trim())
+            .filter(Boolean),
+        mcpAuthSecretKey: env.MCP_AUTH_SECRET_KEY,
+        mcpAuthMode: env.MCP_AUTH_MODE,
+        oauthIssuerUrl: env.OAUTH_ISSUER_URL,
+        oauthJwksUri: env.OAUTH_JWKS_URI,
+        oauthAudience: env.OAUTH_AUDIENCE,
+        oauthJwksCooldownMs: env.OAUTH_JWKS_COOLDOWN_MS,
+        oauthJwksTimeoutMs: env.OAUTH_JWKS_TIMEOUT_MS,
+        mcpServerResourceIdentifier: env.MCP_SERVER_RESOURCE_IDENTIFIER,
+        devMcpAuthBypass: env.DEV_MCP_AUTH_BYPASS,
+        devMcpClientId: env.DEV_MCP_CLIENT_ID,
+        devMcpScopes: env.DEV_MCP_SCOPES?.split(',').map((s) => s.trim()),
+        openrouterAppUrl: env.OPENROUTER_APP_URL,
+        openrouterAppName: env.OPENROUTER_APP_NAME,
+        openrouterApiKey: env.OPENROUTER_API_KEY,
+        llmDefaultModel: env.LLM_DEFAULT_MODEL,
+        llmDefaultTemperature: env.LLM_DEFAULT_TEMPERATURE,
+        llmDefaultTopP: env.LLM_DEFAULT_TOP_P,
+        llmDefaultMaxTokens: env.LLM_DEFAULT_MAX_TOKENS,
+        llmDefaultTopK: env.LLM_DEFAULT_TOP_K,
+        llmDefaultMinP: env.LLM_DEFAULT_MIN_P,
+        oauthProxy: env.OAUTH_PROXY_AUTHORIZATION_URL || env.OAUTH_PROXY_TOKEN_URL
+            ? {
+                authorizationUrl: env.OAUTH_PROXY_AUTHORIZATION_URL,
+                tokenUrl: env.OAUTH_PROXY_TOKEN_URL,
+                revocationUrl: env.OAUTH_PROXY_REVOCATION_URL,
+                issuerUrl: env.OAUTH_PROXY_ISSUER_URL,
+                serviceDocumentationUrl: env.OAUTH_PROXY_SERVICE_DOCUMENTATION_URL,
+                defaultClientRedirectUris: env.OAUTH_PROXY_DEFAULT_CLIENT_REDIRECT_URIS?.split(',')
+                    .map((uri) => uri.trim())
+                    .filter(Boolean),
+            }
+            : undefined,
+        supabase: env.SUPABASE_URL && env.SUPABASE_ANON_KEY
+            ? {
+                url: env.SUPABASE_URL,
+                anonKey: env.SUPABASE_ANON_KEY,
+                serviceRoleKey: env.SUPABASE_SERVICE_ROLE_KEY,
+            }
+            : undefined,
+        storage: {
+            providerType: env.STORAGE_PROVIDER_TYPE,
+            filesystemPath: env.STORAGE_FILESYSTEM_PATH,
+        },
+        tasks: {
+            storeType: env.TASK_STORE_TYPE,
+            tenantId: env.TASK_STORE_TENANT_ID,
+            defaultTtlMs: env.TASK_STORE_DEFAULT_TTL_MS,
+        },
+        openTelemetry: {
+            enabled: env.OTEL_ENABLED,
+            serviceName: env.OTEL_SERVICE_NAME,
+            serviceVersion: env.OTEL_SERVICE_VERSION,
+            tracesEndpoint: env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT,
+            metricsEndpoint: env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT,
+            samplingRatio: env.OTEL_TRACES_SAMPLER_ARG,
+            logLevel: env.OTEL_LOG_LEVEL,
+        },
+        speech: env.SPEECH_TTS_ENABLED || env.SPEECH_STT_ENABLED
+            ? {
+                tts: env.SPEECH_TTS_ENABLED
+                    ? {
+                        enabled: env.SPEECH_TTS_ENABLED,
+                        provider: env.SPEECH_TTS_PROVIDER,
+                        apiKey: env.SPEECH_TTS_API_KEY,
+                        baseUrl: env.SPEECH_TTS_BASE_URL,
+                        defaultVoiceId: env.SPEECH_TTS_DEFAULT_VOICE_ID,
+                        defaultModelId: env.SPEECH_TTS_DEFAULT_MODEL_ID,
+                        timeout: env.SPEECH_TTS_TIMEOUT,
+                    }
+                    : undefined,
+                stt: env.SPEECH_STT_ENABLED
+                    ? {
+                        enabled: env.SPEECH_STT_ENABLED,
+                        provider: env.SPEECH_STT_PROVIDER,
+                        apiKey: env.SPEECH_STT_API_KEY,
+                        baseUrl: env.SPEECH_STT_BASE_URL,
+                        defaultModelId: env.SPEECH_STT_DEFAULT_MODEL_ID,
+                        timeout: env.SPEECH_STT_TIMEOUT,
+                    }
+                    : undefined,
+            }
+            : undefined,
+        // The following fields will be derived and are not directly from env
+        mcpServerName: env.MCP_SERVER_NAME,
+        mcpServerVersion: env.MCP_SERVER_VERSION,
+        mcpServerDescription: env.MCP_SERVER_DESCRIPTION,
+    };
+    // Use a temporary schema to parse package info and provide defaults
+    const pkgSchema = z.object({
+        name: z.string(),
+        version: z.string(),
+        description: z.string().optional(),
+    });
+    const parsedPkg = pkgSchema.parse(rawConfig.pkg);
+    // Now add the derived values to the main rawConfig object to be parsed
+    const finalRawConfig = {
+        ...rawConfig,
+        pkg: parsedPkg,
+        logsPath: runtimeCaps.isNode
+            ? (() => {
+                // Bundled (dist/index.js) is one level deep; source (src/config/index.ts) is two.
+                // Detect bundle path to avoid overshooting the project root.
+                const depth = import.meta.url.includes('/dist/') ? '..' : '../..';
+                const thisFile = fileURLToPath(import.meta.url);
+                const root = join(dirname(thisFile), depth);
+                const logsDir = rawConfig.logsPath ?? 'logs';
+                if (isAbsolute(logsDir))
+                    return logsDir;
+                return join(root, logsDir);
+            })()
+            : undefined,
+        mcpServerName: env.MCP_SERVER_NAME ?? parsedPkg.name,
+        mcpServerVersion: env.MCP_SERVER_VERSION ?? parsedPkg.version,
+        mcpServerDescription: env.MCP_SERVER_DESCRIPTION ?? parsedPkg.description,
+        openTelemetry: {
+            ...rawConfig.openTelemetry,
+            serviceName: env.OTEL_SERVICE_NAME ?? parsedPkg.name,
+            serviceVersion: env.OTEL_SERVICE_VERSION ?? parsedPkg.version,
+        },
+        openrouterAppName: env.OPENROUTER_APP_NAME ?? parsedPkg.name,
+    };
+    const parsedConfig = ConfigSchema.safeParse(finalRawConfig);
+    if (!parsedConfig.success) {
+        // Keep existing TTY error logging for developer convenience.
+        if (process.stdout.isTTY) {
+            console.error('❌ Invalid configuration found. Please check your environment variables.', parsedConfig.error.flatten().fieldErrors);
+        }
+        // Throw a specific, typed error instead of exiting.
+        throw new McpError(JsonRpcErrorCode.ConfigurationError, 'Invalid application configuration.', {
+            validationErrors: parsedConfig.error.flatten().fieldErrors,
+        });
+    }
+    return parsedConfig.data;
+};
+let _config;
+/**
+ * Resets the cached config, forcing re-parse on next access.
+ * Used in Cloudflare Workers (env vars injected at request time, after ESM
+ * static imports) and for test isolation.
+ */
+const resetConfig = () => {
+    _config = undefined;
+};
+/**
+ * Lazy config proxy. Defers `parseConfig()` until the first property access.
+ * This is critical for Cloudflare Workers where environment variables are
+ * injected via `injectEnvVars()` at request time — before config is read,
+ * but after ESM static imports have been evaluated. Without this, config
+ * would freeze at module-load time with empty/default env values.
+ */
+const config = new Proxy({}, {
+    get(_target, prop) {
+        _config ??= parseConfig();
+        return _config[prop];
+    },
+    set() {
+        return false;
+    },
+    defineProperty() {
+        return false;
+    },
+    has(_target, prop) {
+        _config ??= parseConfig();
+        return prop in _config;
+    },
+    ownKeys() {
+        _config ??= parseConfig();
+        return Reflect.ownKeys(_config);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+        _config ??= parseConfig();
+        return Object.getOwnPropertyDescriptor(_config, prop);
+    },
+});
+export { config, ConfigSchema, parseConfig, resetConfig };
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview Unified Context interface for tool and resource handlers.
+ * Replaces the split `appContext` (RequestContext) + `sdkContext` (RequestHandlerExtra)
+ * pattern with a single object that provides logging, storage, protocol capabilities,
+ * and cancellation.
+ * @module src/context
+ */
+import type { RequestTaskStore } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { CreateMessageResult, ElicitResult, SamplingMessage } from '@modelcontextprotocol/sdk/types.js';
+import type { z } from 'zod';
+import type { StorageService } from './storage/core/StorageService.js';
+import type { Logger } from './utils/internal/logger.js';
+import type { AuthContext, RequestContext } from './utils/internal/requestContext.js';
+export type { AuthContext };
+/**
+ * Structured logger scoped to the current request.
+ * Auto-includes requestId, traceId, tenantId in every log entry.
+ */
+export interface ContextLogger {
+    debug(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, error?: Error, data?: Record<string, unknown>): void;
+    info(msg: string, data?: Record<string, unknown>): void;
+    notice(msg: string, data?: Record<string, unknown>): void;
+    warning(msg: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Tenant-scoped key-value storage.
+ * Delegates to StorageService with the request's tenantId.
+ */
+export interface ContextState {
+    delete(key: string): Promise<void>;
+    get(key: string): Promise<string | null>;
+    list(prefix?: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        items: Array<{
+            key: string;
+            value: string;
+        }>;
+        cursor?: string;
+    }>;
+    set(key: string, value: string, opts?: {
+        ttl?: number;
+    }): Promise<void>;
+}
+/**
+ * Progress reporting for background tasks.
+ * Present only when the tool has `task: true`.
+ */
+export interface ContextProgress {
+    /** Increment completed work by amount (default: 1). */
+    increment(amount?: number): Promise<void>;
+    /** Set the total expected units of work. */
+    setTotal(total: number): Promise<void>;
+    /** Set a custom status message. */
+    update(message: string): Promise<void>;
+}
+/** Options for sampling requests. */
+export interface SamplingOpts {
+    includeContext?: 'none' | 'thisServer' | 'allServers';
+    maxTokens?: number;
+    modelPreferences?: Record<string, unknown>;
+    stopSequences?: string[];
+    temperature?: number;
+}
+/**
+ * The unified object every tool and resource handler receives.
+ * Replaces the split `appContext` + `sdkContext` pattern.
+ */
+export interface Context {
+    /** Auth data when request is authenticated. */
+    readonly auth?: AuthContext | undefined;
+    /** Ask the human user a question. Present when client supports elicitation. */
+    readonly elicit?: ((message: string, schema: z.ZodObject<z.ZodRawShape>) => Promise<ElicitResult>) | undefined;
+    /** Logger scoped to this request. Auto-includes requestId, traceId, tenantId. */
+    readonly log: ContextLogger;
+    /** Progress reporting for background tasks. Undefined for non-task tools. */
+    readonly progress?: ContextProgress | undefined;
+    /** Unique request ID for log correlation. */
+    readonly requestId: string;
+    /** Request LLM completion from the client. Present when client supports sampling. */
+    readonly sample?: ((messages: SamplingMessage[], opts?: SamplingOpts) => Promise<CreateMessageResult>) | undefined;
+    /** AbortSignal for request cancellation. */
+    readonly signal: AbortSignal;
+    /** OpenTelemetry span ID (auto-injected). */
+    readonly spanId?: string | undefined;
+    /** Key-value state scoped to the current tenant. Throws if tenantId is missing. */
+    readonly state: ContextState;
+    /** Tenant ID — from JWT 'tid' claim (HTTP) or 'default' (stdio). */
+    readonly tenantId?: string | undefined;
+    /** ISO 8601 creation time. */
+    readonly timestamp: string;
+    /** OpenTelemetry trace ID (auto-injected). */
+    readonly traceId?: string | undefined;
+    /** The parsed resource URI. Only set in resource handler context. */
+    readonly uri?: URL | undefined;
+}
+/** @internal */
+export interface ContextDeps {
+    appContext: RequestContext;
+    elicit?: Context['elicit'];
+    logger: Logger;
+    sample?: Context['sample'];
+    signal: AbortSignal;
+    storage: StorageService;
+    taskCtx?: {
+        store: RequestTaskStore;
+        taskId: string;
+    } | undefined;
+    uri?: URL | undefined;
+}
+/**
+ * Constructs a Context from internal dependencies.
+ * Called by handler factories — not exposed to consumers.
+ * @internal
+ */
+export declare function createContext(deps: ContextDeps): Context;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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