@frontmcp/sdk 0.7.2 → 0.8.0

package/common/utils/decide-request-intent.utils.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { ServerRequest } from '../interfaces';
-import { TransportConfig } from '../types';
+import { LegacyProtocolFlags } from '../types';
 export declare const intentSchema: z.ZodUnion<readonly [z.ZodLiteral<"legacy-sse">, z.ZodLiteral<"sse">, z.ZodLiteral<"streamable-http">, z.ZodLiteral<"stateful-http">, z.ZodLiteral<"stateless-http">, z.ZodLiteral<"delete-session">, z.ZodLiteral<"unknown">]>;
 export declare const decisionSchema: z.ZodObject<{
     intent: z.ZodUnion<readonly [z.ZodLiteral<"legacy-sse">, z.ZodLiteral<"sse">, z.ZodLiteral<"streamable-http">, z.ZodLiteral<"stateful-http">, z.ZodLiteral<"stateless-http">, z.ZodLiteral<"delete-session">, z.ZodLiteral<"unknown">]>;
@@ -32,9 +32,9 @@ export type Decision = {
 };
 /**
  * Configuration for request intent decision.
- * Extends TransportConfig with additional runtime option.
+ * Extends LegacyProtocolFlags with additional runtime option.
  */
-export interface Config extends TransportConfig {
+export interface Config extends LegacyProtocolFlags {
     tolerateMissingAccept: boolean;
 }
 export declare function decideIntent(req: ServerRequest, cfg: Config): Decision;

package/common/utils/decide-request-intent.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decide-request-intent.utils.d.ts","sourceRoot":"","sources":["../../../src/common/utils/decide-request-intent.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAI3C,eAAO,MAAM,YAAY,iOAQvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAiBzB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,KAAK,GACL,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,MAAM,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAEnD,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAEzD,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,MAAO,SAAQ,eAAe;IAC7C,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAkWD,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAsDtE"}
+{"version":3,"file":"decide-request-intent.utils.d.ts","sourceRoot":"","sources":["../../../src/common/utils/decide-request-intent.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAI/C,eAAO,MAAM,YAAY,iOAQvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAiBzB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,KAAK,GACL,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,MAAM,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAEnD,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAEzD,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,MAAO,SAAQ,mBAAmB;IACjD,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAkWD,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAsDtE"}

package/context/context-extension.d.ts

@@ -21,32 +21,5 @@
  *
  * @internal
  */
-import type { ContextExtension } from '../common/metadata/plugin.metadata';
-/**
- * Install context extensions declared by a plugin.
- * Called by the SDK during plugin registration.
- *
- * @param pluginName - Name of the plugin (for error messages)
- * @param extensions - Array of context extensions to install
- *
- * @internal
- */
-export declare function installContextExtensions(pluginName: string, extensions: ContextExtension[]): void;
-/**
- * Check if a context extension property is installed.
- *
- * @param property - Property name to check
- * @returns true if the property is installed
- *
- * @internal
- */
-export declare function isContextExtensionInstalled(property: string): boolean;
-/**
- * Get list of all installed context extension properties.
- *
- * @returns Array of installed property names
- *
- * @internal
- */
-export declare function getInstalledContextExtensions(): string[];
+export {};
 //# sourceMappingURL=context-extension.d.ts.map

package/context/context-extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-extension.d.ts","sourceRoot":"","sources":["../../src/context/context-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAK3E;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAkDjG;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,EAAE,CAExD"}
+{"version":3,"file":"context-extension.d.ts","sourceRoot":"","sources":["../../src/context/context-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/context/frontmcp-context-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmcp-context-storage.d.ts","sourceRoot":"","sources":["../../src/context/frontmcp-context-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAmB,MAAM,oBAAoB,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAW1E;;;;;;GAMG;AACH,qBAKa,sBAAsB;IACjC;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAK3E;;;;;;;;;;OAUG;IACH,cAAc,CAAC,CAAC,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,GAAG,UAAU,CAAC,EAC5D,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAWjB;;;;;;;;OAQG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrF;;;;OAIG;IACH,QAAQ,IAAI,eAAe,GAAG,SAAS;IAIvC;;;;OAIG;IACH,eAAe,IAAI,eAAe;IAUlC;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAKzF;AAiDD;;;GAGG;AACH,OAAO,EAAE,sBAAsB,IAAI,cAAc,EAAE,CAAC"}
+{"version":3,"file":"frontmcp-context-storage.d.ts","sourceRoot":"","sources":["../../src/context/frontmcp-context-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAW1E;;;;;;GAMG;AACH,qBAKa,sBAAsB;IACjC;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAK3E;;;;;;;;;;OAUG;IACH,cAAc,CAAC,CAAC,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,GAAG,UAAU,CAAC,EAC5D,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAWjB;;;;;;;;OAQG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrF;;;;OAIG;IACH,QAAQ,IAAI,eAAe,GAAG,SAAS;IAIvC;;;;OAIG;IACH,eAAe,IAAI,eAAe;IAUlC;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAKzF;AAED;;;GAGG;AACH,OAAO,EAAE,sBAAsB,IAAI,cAAc,EAAE,CAAC"}

package/context/frontmcp-context.d.ts

@@ -14,6 +14,8 @@ import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
 import { FrontMcpLogger } from '../common/interfaces/logger.interface';
 import { TraceContext } from './trace-context';
 import type { SessionIdPayload } from '../common/types';
+import { ElicitResult, ElicitOptions } from '../elicitation';
+import { ZodType } from 'zod';
 /**
  * Request metadata extracted from HTTP headers.
  */
@@ -75,12 +77,12 @@ export interface TransportAccessor {
      *
      * @param message - Message to display to the user
      * @param requestedSchema - Zod schema for validating the response
-     * @returns Typed elicit result with action and validated content
+     * @param options - Elicit options (mode, ttl, elicitationId)
+     * @returns Typed elicit result with status and validated content
+     * @throws ElicitationNotSupportedError if client doesn't support elicitation
+     * @throws ElicitationTimeoutError if request times out
      */
-    elicit<T>(message: string, requestedSchema: T): Promise<{
-        action: string;
-        content: unknown;
-    }>;
+    elicit<S extends ZodType>(message: string, requestedSchema: S, options?: ElicitOptions): Promise<ElicitResult<S extends ZodType<infer O> ? O : unknown>>;
 }
 type FlowBaseRef = {
     readonly name: string;
@@ -89,10 +91,30 @@ type ScopeRef = {
     readonly id: string;
     readonly logger: FrontMcpLogger;
 };
-type TransportRef = {
-    sendElicitRequest: TransportAccessor['elicit'];
-    readonly type: string;
-};
+/**
+ * Session ID validation constants.
+ */
+/** Maximum allowed length for session IDs */
+export declare const SESSION_ID_MAX_LENGTH = 2048;
+/**
+ * Valid characters for session IDs:
+ * - Alphanumeric (a-z, A-Z, 0-9)
+ * - Hyphen, underscore, period
+ * - Colon (for namespaced IDs like "anon:uuid")
+ */
+export declare const SESSION_ID_VALID_PATTERN: RegExp;
+/**
+ * Validate a session ID string.
+ *
+ * Validates:
+ * - Not empty
+ * - Maximum length (2048 characters)
+ * - Valid characters only (alphanumeric, hyphen, underscore, period, colon)
+ *
+ * @param value - The session ID to validate
+ * @throws InvalidInputError if validation fails (empty, too long, invalid characters)
+ */
+export declare function validateSessionId(value: string): void;
 /**
  * FrontMcpContext - Unified context for FrontMCP
  *
@@ -126,60 +148,35 @@ export declare class FrontMcpContext {
     private _scope?;
     private readonly marks;
     private readonly store;
+    /**
+     * Tokens that should be injected into the provider context.
+     * These are registered by auth flows and made available to tools via context extensions.
+     */
+    private readonly _contextTokens;
     constructor(args: FrontMcpContextArgs);
     /**
      * Get authentication information.
      * Returns Partial<AuthInfo> because auth info is progressively populated.
      */
     get authInfo(): Partial<AuthInfo>;
-    /**
-     * Update auth info after authorization is verified.
-     * Can be called multiple times to progressively add fields.
-     *
-     * @param authInfo - The auth info fields to set/update
-     * @internal
-     */
-    updateAuthInfo(authInfo: Partial<AuthInfo>): void;
     /**
      * Get session metadata (protocol, platform type, node info).
      * Only available after session verification.
      */
     get sessionMetadata(): SessionIdPayload | undefined;
-    /**
-     * Update session metadata after session verification.
-     *
-     * @param metadata - Session metadata from verified session
-     * @internal
-     */
-    updateSessionMetadata(metadata: SessionIdPayload): void;
     /**
      * Get transport accessor for elicit support.
      * Returns undefined if no transport is registered.
      */
     get transport(): TransportAccessor | undefined;
-    /**
-     * Set transport reference (internal use).
-     * @internal
-     */
-    setTransport(transport: TransportRef): void;
     /**
      * Get current flow reference.
      */
     get flow(): FlowBaseRef | undefined;
-    /**
-     * Set flow reference (internal use).
-     * @internal
-     */
-    setFlow(flow: FlowBaseRef): void;
     /**
      * Get scope reference.
      */
     get scope(): ScopeRef | undefined;
-    /**
-     * Set scope reference (internal use).
-     * @internal
-     */
-    setScope(scope: ScopeRef): void;
     /**
      * Store context-scoped data.
      *

package/context/frontmcp-context.d.ts.map

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

package/context/frontmcp-context.provider.d.ts

@@ -4,6 +4,8 @@
  * Defines the DI token and factory provider for accessing FrontMcpContext.
  * The context is retrieved from AsyncLocalStorage via FrontMcpContextStorage.
  */
+import { FrontMcpContext } from './frontmcp-context';
+import { Token } from '@frontmcp/di';
 /**
  * DI token for accessing the current FrontMcpContext.
  *
@@ -22,11 +24,7 @@
  * const response = await ctx.fetch('https://api.example.com/data');
  * ```
  */
-export declare const FRONTMCP_CONTEXT: unique symbol;
-/**
- * @deprecated Use FRONTMCP_CONTEXT instead
- */
-export declare const REQUEST_CONTEXT: symbol;
+export declare const FRONTMCP_CONTEXT: Token<FrontMcpContext>;
 /**
  * Factory provider for FrontMcpContext.
  *
@@ -37,8 +35,4 @@ export declare const REQUEST_CONTEXT: symbol;
  * (i.e., without first calling FrontMcpContextStorage.run or runFromHeaders).
  */
 export declare const FrontMcpContextProvider: import("../common/interfaces/provider.interface").ProviderFactoryType<unknown, readonly (import("@frontmcp/di").ClassToken | import("@frontmcp/di").Reference<any>)[]>;
-/**
- * @deprecated Use FrontMcpContextProvider instead
- */
-export declare const RequestContextProvider: import("../common/interfaces/provider.interface").ProviderFactoryType<unknown, readonly (import("@frontmcp/di").ClassToken | import("@frontmcp/di").Reference<any>)[]>;
 //# sourceMappingURL=frontmcp-context.provider.d.ts.map

package/context/frontmcp-context.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmcp-context.provider.d.ts","sourceRoot":"","sources":["../../src/context/frontmcp-context.provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,eAAiC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,wKAW3B,CAAC;AAEV;;GAEG;AACH,eAAO,MAAM,sBAAsB,wKAA0B,CAAC"}
+{"version":3,"file":"frontmcp-context.provider.d.ts","sourceRoot":"","sources":["../../src/context/frontmcp-context.provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,eAAe,CAAkC,CAAC;AAEvF;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,wKAW3B,CAAC"}

package/context/index.d.ts

@@ -8,28 +8,13 @@
  * - FrontMcpContextStorage: AsyncLocalStorage wrapper for context propagation
  * - FRONTMCP_CONTEXT: DI token for accessing current context
  * - TraceContext utilities: W3C Trace Context parsing and generation
- *
- * @deprecated exports (backward compatibility):
- * - RequestContext: Use FrontMcpContext instead
- * - RequestContextStorage: Use FrontMcpContextStorage instead
- * - REQUEST_CONTEXT: Use FRONTMCP_CONTEXT instead
- * - SessionKey: No longer needed with unified context
+ * - Session validation: validateSessionId for validating session identifiers
  */
 export { FrontMcpContext, Context, // Short alias
-FrontMcpContextArgs, FrontMcpContextConfig, RequestMetadata, TransportAccessor, } from './frontmcp-context';
+FrontMcpContextArgs, FrontMcpContextConfig, RequestMetadata, TransportAccessor, validateSessionId, SESSION_ID_MAX_LENGTH, SESSION_ID_VALID_PATTERN, } from './frontmcp-context';
 export { FrontMcpContextStorage, ContextStorage } from './frontmcp-context-storage';
-export { FRONTMCP_CONTEXT, FrontMcpContextProvider, REQUEST_CONTEXT, RequestContextProvider, } from './frontmcp-context.provider';
+export { FRONTMCP_CONTEXT, FrontMcpContextProvider } from './frontmcp-context.provider';
 export { TraceContext, parseTraceContext, generateTraceContext, createChildSpanContext } from './trace-context';
-/**
- * @deprecated Use FrontMcpContext instead
- */
-export { RequestContext, RequestContextArgs as LegacyRequestContextArgs } from './request-context';
-/**
- * @deprecated Use FrontMcpContextStorage instead
- */
-export { RequestContextStorage } from './request-context-storage';
-/**
- * @deprecated SessionKey is no longer needed. Use ctx.sessionId directly.
- */
-export { SessionKey } from './session-key.provider';
+export { extractMetadata, extractClientIp } from './metadata.utils';
+export { installContextExtensions, isContextExtensionInstalled, getInstalledContextExtensions, } from './context-extension';
 //# sourceMappingURL=index.d.ts.map

package/context/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,EACL,eAAe,EACf,OAAO,EAAE,cAAc;AACvB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGpF,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAEvB,eAAe,EACf,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAMhH;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,kBAAkB,IAAI,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAEnG;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EACL,eAAe,EACf,OAAO,EAAE,cAAc;AACvB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EAEjB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAKpF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAKxF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAKhH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKpE,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC"}

package/context/metadata.utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Metadata Utilities
+ *
+ * Shared utilities for extracting request metadata from HTTP headers.
+ */
+import type { RequestMetadata } from './frontmcp-context';
+/**
+ * Extract request metadata from headers.
+ *
+ * @param headers - HTTP headers object
+ * @returns Extracted metadata including user-agent, content-type, client IP, and custom headers
+ */
+export declare function extractMetadata(headers: Record<string, unknown>): RequestMetadata;
+/**
+ * Extract client IP from headers.
+ *
+ * Handles both string and array header values (some adapters pass arrays).
+ * Supports x-forwarded-for (comma-separated list) and x-real-ip headers.
+ *
+ * @param headers - HTTP headers object
+ * @returns Client IP address or undefined if not found
+ */
+export declare function extractClientIp(headers: Record<string, unknown>): string | undefined;
+//# sourceMappingURL=metadata.utils.d.ts.map

package/context/metadata.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.utils.d.ts","sourceRoot":"","sources":["../../src/context/metadata.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAgBjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAoBpF"}