@frontmcp/sdk 0.4.0 → 0.5.0

package/src/common/interfaces/resource.interface.d.ts

@@ -1,21 +1,51 @@
-import { ResourceMetadata } from '../metadata';
-import { FuncType, Token, Type } from './base.interface';
-export interface ResourceInterface<In = any, Out = any> {
-    execute(input: In, context: ResourceContext<In, Out>): Promise<Out>;
+import { ResourceMetadata, ResourceTemplateMetadata } from '../metadata';
+import { FuncType, Type } from './base.interface';
+import { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';
+/**
+ * Base interface for resource implementations.
+ * @template Params - Type for URI template parameters (defaults to generic string record)
+ * @template Out - Type for the resource output
+ */
+export interface ResourceInterface<Params extends Record<string, string> = Record<string, string>, Out = unknown> {
+    execute(uri: string, params: Params): Promise<Out>;
 }
-export type ResourceType<In = any, Out = any> = Type<ResourceInterface<In, Out>> | FuncType<ResourceInterface<In, Out>>;
-export interface ResourceContext<In, Out> {
-    readonly resourceId: string;
-    readonly resourceName: string;
-    readonly metadata: ResourceMetadata;
-    get<T>(token: Token<T>): T;
-    tryGet<T>(token: Token<T>): T | undefined;
-    get inputHistory(): In[];
-    get outputHistory(): Out[];
-    set input(value: In);
-    get input(): In;
-    set output(value: Out);
+/**
+ * Type for resource class or function.
+ * @template Params - Type for URI template parameters
+ * @template Out - Type for the resource output
+ */
+export type ResourceType<Params extends Record<string, string> = Record<string, string>, Out = unknown> = Type<ResourceInterface<Params, Out>> | FuncType<ResourceInterface<Params, Out>>;
+type HistoryEntry<T> = {
+    at: number;
+    stage?: string;
+    value: T | undefined;
+    note?: string;
+};
+export type ResourceCtorArgs<Params extends Record<string, string> = Record<string, string>> = ExecutionContextBaseArgs & {
+    metadata: ResourceMetadata | ResourceTemplateMetadata;
+    uri: string;
+    params: Params;
+};
+/**
+ * Abstract base class for resource execution contexts.
+ * @template Params - Type for URI template parameters (e.g., `{ userId: string }`)
+ * @template Out - Type for the resource output
+ */
+export declare abstract class ResourceContext<Params extends Record<string, string> = Record<string, string>, Out = unknown> extends ExecutionContextBase<Out> {
+    protected readonly resourceId: string;
+    protected readonly resourceName: string;
+    readonly metadata: ResourceMetadata | ResourceTemplateMetadata;
+    /** The actual URI being read */
+    readonly uri: string;
+    /** Extracted URI template parameters (empty for static resources) */
+    readonly params: Params;
+    private _output?;
+    private readonly _outputHistory;
+    constructor(args: ResourceCtorArgs<Params>);
+    abstract execute(uri: string, params: Params): Promise<Out>;
     get output(): Out | undefined;
+    set output(v: Out | undefined);
+    get outputHistory(): ReadonlyArray<HistoryEntry<Out>>;
     respond(value: Out): never;
-    fail(reason: string, error: any): never;
 }
+export {};

package/src/common/interfaces/resource.interface.js

@@ -1,3 +1,56 @@
 "use strict";
+// file: libs/sdk/src/common/interfaces/resource.interface.ts
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceContext = void 0;
+const flow_interface_1 = require("./flow.interface");
+const execution_context_interface_1 = require("./execution-context.interface");
+/**
+ * Abstract base class for resource execution contexts.
+ * @template Params - Type for URI template parameters (e.g., `{ userId: string }`)
+ * @template Out - Type for the resource output
+ */
+class ResourceContext extends execution_context_interface_1.ExecutionContextBase {
+    resourceId;
+    resourceName;
+    metadata;
+    /** The actual URI being read */
+    uri;
+    /** Extracted URI template parameters (empty for static resources) */
+    params;
+    // ---- OUTPUT storages (backing fields)
+    _output;
+    // ---- histories
+    _outputHistory = [];
+    constructor(args) {
+        const { metadata, uri, params, providers, logger } = args;
+        super({
+            providers,
+            logger: logger.child(`resource:${metadata.name}`),
+            authInfo: args.authInfo,
+        });
+        this.resourceName = metadata.name;
+        // resourceId uses the metadata name as the stable identifier for the resource type
+        // (runId is the unique instance identifier for this specific execution)
+        this.resourceId = metadata.name;
+        this.metadata = metadata;
+        this.uri = uri;
+        this.params = params;
+    }
+    get output() {
+        return this._output;
+    }
+    set output(v) {
+        this._output = v;
+        this._outputHistory.push({ at: Date.now(), stage: this.activeStage, value: v });
+    }
+    get outputHistory() {
+        return this._outputHistory;
+    }
+    respond(value) {
+        // record validated output and surface the value via control flow
+        this.output = value;
+        flow_interface_1.FlowControl.respond(value);
+    }
+}
+exports.ResourceContext = ResourceContext;
 //# sourceMappingURL=resource.interface.js.map

package/src/common/interfaces/resource.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/resource.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { ResourceMetadata } from '../metadata';\nimport { FuncType, Token, Type } from './base.interface';\n\n\nexport interface ResourceInterface<In = any, Out = any> {\n  execute(input: In, context: ResourceContext<In, Out>): Promise<Out>;\n}\n\nexport type ResourceType<In = any, Out = any> =\n  | Type<ResourceInterface<In, Out>>\n  | FuncType<ResourceInterface<In, Out>>\n\n\nexport interface ResourceContext<In, Out> {\n  readonly resourceId: string;\n  readonly resourceName: string;\n  readonly metadata: ResourceMetadata;\n\n\n  get<T>(token: Token<T>): T;\n\n  tryGet<T>(token: Token<T>): T | undefined;\n\n  get inputHistory(): In[];\n\n  get outputHistory(): Out[];\n\n  set input(value: In);\n\n  get input(): In;\n\n  set output(value: Out);\n\n  get output(): Out | undefined;\n\n  respond(value: Out): never;\n\n  fail(reason: string, error: any): never;\n}"]}
+{"version":3,"file":"resource.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/resource.interface.ts"],"names":[],"mappings":";AAAA,6DAA6D;;;AAM7D,qDAA+C;AAE/C,+EAA+F;AAkC/F;;;;GAIG;AACH,MAAsB,eAGpB,SAAQ,kDAAyB;IACd,UAAU,CAAS;IACnB,YAAY,CAAS;IAC/B,QAAQ,CAA8C;IAE/D,gCAAgC;IACvB,GAAG,CAAS;IACrB,qEAAqE;IAC5D,MAAM,CAAS;IAExB,wCAAwC;IAChC,OAAO,CAAO;IAEtB,iBAAiB;IACA,cAAc,GAAwB,EAAE,CAAC;IAE1D,YAAY,IAA8B;QACxC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC1D,KAAK,CAAC;YACJ,SAAS;YACT,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjD,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;QAClC,mFAAmF;QACnF,wEAAwE;QACxE,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAID,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAW,MAAM,CAAC,CAAkB;QAClC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,KAAU;QAChB,iEAAiE;QACjE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,4BAAW,CAAC,OAAO,CAAM,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AAvDD,0CAuDC","sourcesContent":["// file: libs/sdk/src/common/interfaces/resource.interface.ts\n\nimport { ResourceMetadata, ResourceTemplateMetadata } from '../metadata';\nimport { FuncType, Type } from './base.interface';\nimport { ProviderRegistryInterface } from './internal';\nimport { FrontMcpLogger } from './logger.interface';\nimport { FlowControl } from './flow.interface';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';\n\n/**\n * Base interface for resource implementations.\n * @template Params - Type for URI template parameters (defaults to generic string record)\n * @template Out - Type for the resource output\n */\nexport interface ResourceInterface<Params extends Record<string, string> = Record<string, string>, Out = unknown> {\n  execute(uri: string, params: Params): Promise<Out>;\n}\n\n/**\n * Type for resource class or function.\n * @template Params - Type for URI template parameters\n * @template Out - Type for the resource output\n */\nexport type ResourceType<Params extends Record<string, string> = Record<string, string>, Out = unknown> =\n  | Type<ResourceInterface<Params, Out>>\n  | FuncType<ResourceInterface<Params, Out>>;\n\ntype HistoryEntry<T> = {\n  at: number;\n  stage?: string;\n  value: T | undefined;\n  note?: string;\n};\n\nexport type ResourceCtorArgs<Params extends Record<string, string> = Record<string, string>> =\n  ExecutionContextBaseArgs & {\n    metadata: ResourceMetadata | ResourceTemplateMetadata;\n    uri: string;\n    params: Params;\n  };\n\n/**\n * Abstract base class for resource execution contexts.\n * @template Params - Type for URI template parameters (e.g., `{ userId: string }`)\n * @template Out - Type for the resource output\n */\nexport abstract class ResourceContext<\n  Params extends Record<string, string> = Record<string, string>,\n  Out = unknown,\n> extends ExecutionContextBase<Out> {\n  protected readonly resourceId: string;\n  protected readonly resourceName: string;\n  readonly metadata: ResourceMetadata | ResourceTemplateMetadata;\n\n  /** The actual URI being read */\n  readonly uri: string;\n  /** Extracted URI template parameters (empty for static resources) */\n  readonly params: Params;\n\n  // ---- OUTPUT storages (backing fields)\n  private _output?: Out;\n\n  // ---- histories\n  private readonly _outputHistory: HistoryEntry<Out>[] = [];\n\n  constructor(args: ResourceCtorArgs<Params>) {\n    const { metadata, uri, params, providers, logger } = args;\n    super({\n      providers,\n      logger: logger.child(`resource:${metadata.name}`),\n      authInfo: args.authInfo,\n    });\n    this.resourceName = metadata.name;\n    // resourceId uses the metadata name as the stable identifier for the resource type\n    // (runId is the unique instance identifier for this specific execution)\n    this.resourceId = metadata.name;\n    this.metadata = metadata;\n    this.uri = uri;\n    this.params = params;\n  }\n\n  abstract execute(uri: string, params: Params): Promise<Out>;\n\n  public get output(): Out | undefined {\n    return this._output;\n  }\n\n  public set output(v: Out | undefined) {\n    this._output = v;\n    this._outputHistory.push({ at: Date.now(), stage: this.activeStage, value: v });\n  }\n\n  public get outputHistory(): ReadonlyArray<HistoryEntry<Out>> {\n    return this._outputHistory;\n  }\n\n  respond(value: Out): never {\n    // record validated output and surface the value via control flow\n    this.output = value;\n    FlowControl.respond<Out>(value);\n  }\n}\n"]}

package/src/common/interfaces/tool.interface.d.ts

@@ -1,10 +1,8 @@
-import { FuncType, Token, Type } from './base.interface';
-import { ProviderRegistryInterface } from './internal';
+import { FuncType, Type } from './base.interface';
 import { ToolInputType, ToolMetadata, ToolOutputType } from '../metadata';
-import { FrontMcpLogger } from './logger.interface';
-import { URL } from 'url';
-import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
 import { ToolInputOf, ToolOutputOf } from '../decorators';
+import { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';
+import type { AIPlatformType, ClientInfo } from '../../notification';
 export type ToolType<T = any> = Type<T> | FuncType<T>;
 type HistoryEntry<T> = {
     at: number;
@@ -12,37 +10,26 @@ type HistoryEntry<T> = {
     value: T | undefined;
     note?: string;
 };
-export type ToolCtorArgs<In> = {
+export type ToolCtorArgs<In> = ExecutionContextBaseArgs & {
     metadata: ToolMetadata;
     input: In;
-    providers: ProviderRegistryInterface;
-    logger: FrontMcpLogger;
-    authInfo: AuthInfo;
 };
 export declare abstract class ToolContext<InSchema extends ToolInputType = ToolInputType, OutSchema extends ToolOutputType = ToolOutputType, In = ToolInputOf<{
     inputSchema: InSchema;
 }>, Out = ToolOutputOf<{
     outputSchema: OutSchema;
-}>> {
-    private providers;
-    readonly authInfo: AuthInfo;
-    protected readonly runId: string;
+}>> extends ExecutionContextBase<Out> {
     protected readonly toolId: string;
     protected readonly toolName: string;
     readonly metadata: ToolMetadata;
-    protected readonly logger: FrontMcpLogger;
-    protected activeStage: string;
     private _rawInput?;
     private _input?;
     private _outputDraft?;
     private _output?;
-    private _error?;
     private readonly _inputHistory;
     private readonly _outputHistory;
     constructor(args: ToolCtorArgs<In>);
     abstract execute(input: In): Promise<Out>;
-    get<T>(token: Token<T>): T;
-    tryGet<T>(token: Token<T>): T | undefined;
     get input(): In;
     set input(v: In | undefined);
     get inputHistory(): ReadonlyArray<HistoryEntry<In>>;
@@ -50,9 +37,39 @@ export declare abstract class ToolContext<InSchema extends ToolInputType = ToolI
     set output(v: Out | undefined);
     get outputHistory(): ReadonlyArray<HistoryEntry<Out>>;
     respond(value: Out): never;
-    /** Fail the run (invoker will run error/finalize). */
-    protected fail(err: Error): never;
-    mark(stage: string): void;
-    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+    /**
+     * Get the detected AI platform type for the current session.
+     * This is auto-detected from the client info during MCP initialization.
+     *
+     * Use this to customize tool responses (e.g., UI format) based on the calling platform.
+     *
+     * @returns The detected platform type, or 'unknown' if not detected
+     * @example
+     * ```typescript
+     * async execute(input: Input): Promise<Output> {
+     *   const platform = this.platform;
+     *   if (platform === 'openai') {
+     *     // Return OpenAI-specific response format
+     *   }
+     *   // ...
+     * }
+     * ```
+     */
+    get platform(): AIPlatformType;
+    /**
+     * Get the client info (name and version) for the current session.
+     * This is captured from the MCP initialize request.
+     *
+     * @returns The client info, or undefined if not available
+     * @example
+     * ```typescript
+     * async execute(input: Input): Promise<Output> {
+     *   const client = this.clientInfo;
+     *   console.log(`Called by: ${client?.name} v${client?.version}`);
+     *   // ...
+     * }
+     * ```
+     */
+    get clientInfo(): ClientInfo | undefined;
 }
 export {};

package/src/common/interfaces/tool.interface.js

@@ -1,49 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolContext = void 0;
-const crypto_1 = require("crypto");
 const flow_interface_1 = require("./flow.interface");
-class ToolContext {
-    providers;
-    authInfo;
-    runId;
+const execution_context_interface_1 = require("./execution-context.interface");
+class ToolContext extends execution_context_interface_1.ExecutionContextBase {
     toolId;
     toolName;
     metadata;
-    logger;
-    activeStage;
     // ---- INPUT storages (backing fields)
     _rawInput;
     _input;
     // ---- OUTPUT storages (backing fields)
     _outputDraft;
     _output;
-    _error;
     // ---- histories
     _inputHistory = [];
     _outputHistory = [];
     constructor(args) {
-        const { metadata, input, providers, logger, authInfo } = args;
-        this.runId = (0, crypto_1.randomUUID)();
+        const { metadata, input, providers, logger } = args;
+        super({
+            providers,
+            logger: logger.child(`tool:${metadata.id ?? metadata.name}`),
+            authInfo: args.authInfo,
+        });
         this.toolName = metadata.name;
         this.toolId = metadata.id ?? metadata.name;
         this.metadata = metadata;
         this._input = input;
-        this.providers = providers;
-        this.logger = logger.child(`tool:${this.toolId}`);
-        this.authInfo = authInfo;
-    }
-    get(token) {
-        return this.providers.get(token);
-    }
-    tryGet(token) {
-        try {
-            return this.providers.get(token);
-        }
-        catch (e) {
-            this.logger.warn("Requesting provider that doesn't exist: ", token);
-            return undefined;
-        }
     }
     get input() {
         return this._input;
@@ -74,16 +57,60 @@ class ToolContext {
         this.output = value;
         flow_interface_1.FlowControl.respond(value);
     }
-    /** Fail the run (invoker will run error/finalize). */
-    fail(err) {
-        this._error = err;
-        flow_interface_1.FlowControl.fail(err);
-    }
-    mark(stage) {
-        this.activeStage = stage;
+    // ============================================
+    // Platform Detection API
+    // ============================================
+    /**
+     * Get the detected AI platform type for the current session.
+     * This is auto-detected from the client info during MCP initialization.
+     *
+     * Use this to customize tool responses (e.g., UI format) based on the calling platform.
+     *
+     * @returns The detected platform type, or 'unknown' if not detected
+     * @example
+     * ```typescript
+     * async execute(input: Input): Promise<Output> {
+     *   const platform = this.platform;
+     *   if (platform === 'openai') {
+     *     // Return OpenAI-specific response format
+     *   }
+     *   // ...
+     * }
+     * ```
+     */
+    get platform() {
+        // First check sessionIdPayload (detected from user-agent during session creation)
+        const payloadPlatform = this.authInfo.sessionIdPayload?.platformType;
+        if (payloadPlatform && payloadPlatform !== 'unknown') {
+            return payloadPlatform;
+        }
+        // Fall back to notification service (detected from MCP clientInfo during initialize)
+        const sessionId = this.authInfo.sessionId;
+        if (!sessionId) {
+            return 'unknown';
+        }
+        return this.scope.notifications.getPlatformType(sessionId);
     }
-    fetch(input, init) {
-        return fetch(input, init);
+    /**
+     * Get the client info (name and version) for the current session.
+     * This is captured from the MCP initialize request.
+     *
+     * @returns The client info, or undefined if not available
+     * @example
+     * ```typescript
+     * async execute(input: Input): Promise<Output> {
+     *   const client = this.clientInfo;
+     *   console.log(`Called by: ${client?.name} v${client?.version}`);
+     *   // ...
+     * }
+     * ```
+     */
+    get clientInfo() {
+        const sessionId = this.authInfo.sessionId;
+        if (!sessionId) {
+            return undefined;
+        }
+        return this.scope.notifications.getClientInfo(sessionId);
     }
 }
 exports.ToolContext = ToolContext;

package/src/common/interfaces/tool.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/tool.interface.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from 'crypto';\nimport { FuncType, Token, Type } from './base.interface';\nimport { ProviderRegistryInterface } from './internal';\nimport { ToolInputType, ToolMetadata, ToolOutputType } from '../metadata';\nimport { FrontMcpLogger } from './logger.interface';\nimport { FlowControl } from './flow.interface';\nimport { URL } from 'url';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { ToolInputOf, ToolOutputOf } from '../decorators';\n\nexport type ToolType<T = any> = Type<T> | FuncType<T>;\n\ntype HistoryEntry<T> = {\n  at: number;\n  stage?: string;\n  value: T | undefined;\n  note?: string;\n};\n\nexport type ToolCtorArgs<In> = {\n  metadata: ToolMetadata;\n  input: In;\n  providers: ProviderRegistryInterface;\n  logger: FrontMcpLogger;\n  authInfo: AuthInfo;\n};\n\nexport abstract class ToolContext<\n  InSchema extends ToolInputType = ToolInputType,\n  OutSchema extends ToolOutputType = ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> {\n  private providers: ProviderRegistryInterface;\n  readonly authInfo: AuthInfo;\n\n  protected readonly runId: string;\n  protected readonly toolId: string;\n  protected readonly toolName: string;\n  readonly metadata: ToolMetadata;\n  protected readonly logger: FrontMcpLogger;\n\n  protected activeStage: string;\n\n  // ---- INPUT storages (backing fields)\n  private _rawInput?: Partial<In> | any;\n  private _input?: In;\n\n  // ---- OUTPUT storages (backing fields)\n  private _outputDraft?: Partial<Out> | any;\n  private _output?: Out;\n\n  private _error?: Error;\n\n  // ---- histories\n  private readonly _inputHistory: HistoryEntry<In>[] = [];\n  private readonly _outputHistory: HistoryEntry<Out>[] = [];\n\n  constructor(args: ToolCtorArgs<In>) {\n    const { metadata, input, providers, logger, authInfo } = args;\n    this.runId = randomUUID();\n    this.toolName = metadata.name;\n    this.toolId = metadata.id ?? metadata.name;\n    this.metadata = metadata;\n    this._input = input;\n    this.providers = providers;\n    this.logger = logger.child(`tool:${this.toolId}`);\n    this.authInfo = authInfo;\n  }\n\n  abstract execute(input: In): Promise<Out>;\n\n  get<T>(token: Token<T>): T {\n    return this.providers.get(token);\n  }\n\n  tryGet<T>(token: Token<T>): T | undefined {\n    try {\n      return this.providers.get(token);\n    } catch (e) {\n      this.logger.warn(\"Requesting provider that doesn't exist: \", token);\n      return undefined;\n    }\n  }\n\n  public get input(): In {\n    return this._input as In;\n  }\n\n  public set input(v: In | undefined) {\n    this._input = v;\n    this._inputHistory.push({\n      at: Date.now(),\n      stage: this.activeStage,\n      value: v,\n    });\n  }\n\n  public get inputHistory(): ReadonlyArray<HistoryEntry<In>> {\n    return this._inputHistory;\n  }\n\n  public get output(): Out | undefined {\n    return this._output;\n  }\n\n  public set output(v: Out | undefined) {\n    this._output = v;\n    this._outputHistory.push({ at: Date.now(), stage: this.activeStage, value: v });\n  }\n\n  public get outputHistory(): ReadonlyArray<HistoryEntry<Out>> {\n    return this._outputHistory;\n  }\n\n  respond(value: Out): never {\n    // record validated output and surface the value via control flow\n    this.output = value;\n    FlowControl.respond<Out>(value);\n  }\n\n  /** Fail the run (invoker will run error/finalize). */\n  protected fail(err: Error): never {\n    this._error = err;\n    FlowControl.fail(err);\n  }\n\n  mark(stage: string): void {\n    this.activeStage = stage;\n  }\n\n  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    return fetch(input, init);\n  }\n}\n"]}
+{"version":3,"file":"tool.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/tool.interface.ts"],"names":[],"mappings":"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","sourcesContent":["import { FuncType, Type } from './base.interface';\nimport { ProviderRegistryInterface } from './internal';\nimport { ToolInputType, ToolMetadata, ToolOutputType } from '../metadata';\nimport { FrontMcpLogger } from './logger.interface';\nimport { FlowControl } from './flow.interface';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { ToolInputOf, ToolOutputOf } from '../decorators';\nimport { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';\nimport type { AIPlatformType, ClientInfo } from '../../notification';\n\nexport type ToolType<T = any> = Type<T> | FuncType<T>;\n\ntype HistoryEntry<T> = {\n  at: number;\n  stage?: string;\n  value: T | undefined;\n  note?: string;\n};\n\nexport type ToolCtorArgs<In> = ExecutionContextBaseArgs & {\n  metadata: ToolMetadata;\n  input: In;\n};\n\nexport abstract class ToolContext<\n  InSchema extends ToolInputType = ToolInputType,\n  OutSchema extends ToolOutputType = ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> extends ExecutionContextBase<Out> {\n  protected readonly toolId: string;\n  protected readonly toolName: string;\n  readonly metadata: ToolMetadata;\n\n  // ---- INPUT storages (backing fields)\n  private _rawInput?: Partial<In> | any;\n  private _input?: In;\n\n  // ---- OUTPUT storages (backing fields)\n  private _outputDraft?: Partial<Out> | any;\n  private _output?: Out;\n\n  // ---- histories\n  private readonly _inputHistory: HistoryEntry<In>[] = [];\n  private readonly _outputHistory: HistoryEntry<Out>[] = [];\n\n  constructor(args: ToolCtorArgs<In>) {\n    const { metadata, input, providers, logger } = args;\n    super({\n      providers,\n      logger: logger.child(`tool:${metadata.id ?? metadata.name}`),\n      authInfo: args.authInfo,\n    });\n    this.toolName = metadata.name;\n    this.toolId = metadata.id ?? metadata.name;\n    this.metadata = metadata;\n    this._input = input;\n  }\n\n  abstract execute(input: In): Promise<Out>;\n\n  public get input(): In {\n    return this._input as In;\n  }\n\n  public set input(v: In | undefined) {\n    this._input = v;\n    this._inputHistory.push({\n      at: Date.now(),\n      stage: this.activeStage,\n      value: v,\n    });\n  }\n\n  public get inputHistory(): ReadonlyArray<HistoryEntry<In>> {\n    return this._inputHistory;\n  }\n\n  public get output(): Out | undefined {\n    return this._output;\n  }\n\n  public set output(v: Out | undefined) {\n    this._output = v;\n    this._outputHistory.push({ at: Date.now(), stage: this.activeStage, value: v });\n  }\n\n  public get outputHistory(): ReadonlyArray<HistoryEntry<Out>> {\n    return this._outputHistory;\n  }\n\n  respond(value: Out): never {\n    // record validated output and surface the value via control flow\n    this.output = value;\n    FlowControl.respond<Out>(value);\n  }\n\n  // ============================================\n  // Platform Detection API\n  // ============================================\n\n  /**\n   * Get the detected AI platform type for the current session.\n   * This is auto-detected from the client info during MCP initialization.\n   *\n   * Use this to customize tool responses (e.g., UI format) based on the calling platform.\n   *\n   * @returns The detected platform type, or 'unknown' if not detected\n   * @example\n   * ```typescript\n   * async execute(input: Input): Promise<Output> {\n   *   const platform = this.platform;\n   *   if (platform === 'openai') {\n   *     // Return OpenAI-specific response format\n   *   }\n   *   // ...\n   * }\n   * ```\n   */\n  get platform(): AIPlatformType {\n    // First check sessionIdPayload (detected from user-agent during session creation)\n    const payloadPlatform = this.authInfo.sessionIdPayload?.platformType;\n    if (payloadPlatform && payloadPlatform !== 'unknown') {\n      return payloadPlatform;\n    }\n\n    // Fall back to notification service (detected from MCP clientInfo during initialize)\n    const sessionId = this.authInfo.sessionId;\n    if (!sessionId) {\n      return 'unknown';\n    }\n    return this.scope.notifications.getPlatformType(sessionId);\n  }\n\n  /**\n   * Get the client info (name and version) for the current session.\n   * This is captured from the MCP initialize request.\n   *\n   * @returns The client info, or undefined if not available\n   * @example\n   * ```typescript\n   * async execute(input: Input): Promise<Output> {\n   *   const client = this.clientInfo;\n   *   console.log(`Called by: ${client?.name} v${client?.version}`);\n   *   // ...\n   * }\n   * ```\n   */\n  get clientInfo(): ClientInfo | undefined {\n    const sessionId = this.authInfo.sessionId;\n    if (!sessionId) {\n      return undefined;\n    }\n    return this.scope.notifications.getClientInfo(sessionId);\n  }\n}\n"]}

package/src/common/metadata/adapter.metadata.d.ts

@@ -11,12 +11,4 @@ export declare const frontMcpAdapterMetadataSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-}, z.ZodTypeAny, "passthrough">>;
+}, z.core.$loose>;