@frontmcp/sdk 0.6.0 → 0.6.2

package/src/resource/flows/unsubscribe-resource.flow.js

@@ -1,107 +0,0 @@
-"use strict";
-// file: libs/sdk/src/resource/flows/unsubscribe-resource.flow.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const common_1 = require("../../common");
-const zod_1 = require("zod");
-const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-const errors_1 = require("../../errors");
-const inputSchema = zod_1.z.object({
-    request: types_js_1.UnsubscribeRequestSchema,
-    ctx: zod_1.z.unknown(),
-});
-const outputSchema = types_js_1.EmptyResultSchema;
-const stateSchema = zod_1.z.object({
-    input: zod_1.z.object({
-        uri: zod_1.z.string().min(1),
-    }),
-    sessionId: zod_1.z.string(),
-    output: outputSchema,
-});
-const plan = {
-    pre: ['parseInput'],
-    execute: ['unsubscribe'],
-    finalize: ['finalize'],
-};
-const name = 'resources:unsubscribe';
-const { Stage } = (0, common_1.FlowHooksOf)(name);
-let UnsubscribeResourceFlow = class UnsubscribeResourceFlow extends common_1.FlowBase {
-    logger = this.scopeLogger.child('UnsubscribeResourceFlow');
-    async parseInput() {
-        this.logger.verbose('parseInput:start');
-        let method;
-        let params;
-        let ctx;
-        try {
-            const inputData = inputSchema.parse(this.rawInput);
-            method = inputData.request.method;
-            params = inputData.request.params;
-            ctx = inputData.ctx;
-        }
-        catch (e) {
-            throw new errors_1.InvalidInputError('Invalid Input', e instanceof zod_1.z.ZodError ? e.issues : undefined);
-        }
-        if (method !== 'resources/unsubscribe') {
-            this.logger.warn(`parseInput: invalid method "${method}"`);
-            throw new errors_1.InvalidMethodError(method, 'resources/unsubscribe');
-        }
-        // Get session ID from context - required for subscription tracking
-        const sessionId = ctx?.['sessionId'];
-        if (!sessionId || typeof sessionId !== 'string') {
-            this.logger.warn('parseInput: sessionId not found in context');
-            throw new errors_1.InvalidInputError('Session ID is required for resource unsubscriptions');
-        }
-        this.state.set({ input: params, sessionId });
-        this.logger.verbose('parseInput:done');
-    }
-    async unsubscribe() {
-        this.logger.verbose('unsubscribe:start');
-        const { uri } = this.state.required.input;
-        const { sessionId } = this.state.required;
-        // Per MCP spec, unsubscribe should succeed even if the resource doesn't exist
-        // or the session wasn't subscribed. We just silently succeed.
-        const wasSubscribed = this.scope.notifications.unsubscribeResource(sessionId, uri);
-        if (wasSubscribed) {
-            this.logger.info(`unsubscribe: session unsubscribed from resource ${uri}`);
-        }
-        else {
-            this.logger.verbose(`unsubscribe: session was not subscribed to resource ${uri}`);
-        }
-        this.logger.verbose('unsubscribe:done');
-    }
-    async finalize() {
-        this.logger.verbose('finalize:start');
-        // Per MCP spec, resources/unsubscribe returns an empty result
-        this.respond({});
-        this.logger.verbose('finalize:done');
-    }
-};
-tslib_1.__decorate([
-    Stage('parseInput'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], UnsubscribeResourceFlow.prototype, "parseInput", null);
-tslib_1.__decorate([
-    Stage('unsubscribe'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], UnsubscribeResourceFlow.prototype, "unsubscribe", null);
-tslib_1.__decorate([
-    Stage('finalize'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], UnsubscribeResourceFlow.prototype, "finalize", null);
-UnsubscribeResourceFlow = tslib_1.__decorate([
-    (0, common_1.Flow)({
-        name,
-        plan,
-        inputSchema,
-        outputSchema,
-        access: 'authorized',
-    })
-], UnsubscribeResourceFlow);
-exports.default = UnsubscribeResourceFlow;
-//# sourceMappingURL=unsubscribe-resource.flow.js.map

package/src/resource/flows/unsubscribe-resource.flow.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"unsubscribe-resource.flow.js","sourceRoot":"","sources":["../../../../src/resource/flows/unsubscribe-resource.flow.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/resource/flows/unsubscribe-resource.flow.ts\n\nimport { Flow, FlowBase, FlowHooksOf, FlowPlan, FlowRunOptions } from '../../common';\nimport { z } from 'zod';\nimport { UnsubscribeRequestSchema, EmptyResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { InvalidMethodError, InvalidInputError } from '../../errors';\n\nconst inputSchema = z.object({\n  request: UnsubscribeRequestSchema,\n  ctx: z.unknown(),\n});\n\nconst outputSchema = EmptyResultSchema;\n\nconst stateSchema = z.object({\n  input: z.object({\n    uri: z.string().min(1),\n  }),\n  sessionId: z.string(),\n  output: outputSchema,\n});\n\nconst plan = {\n  pre: ['parseInput'],\n  execute: ['unsubscribe'],\n  finalize: ['finalize'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'resources:unsubscribe': FlowRunOptions<\n      UnsubscribeResourceFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'resources:unsubscribe' as const;\nconst { Stage } = FlowHooksOf<'resources:unsubscribe'>(name);\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class UnsubscribeResourceFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('UnsubscribeResourceFlow');\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: z.infer<typeof UnsubscribeRequestSchema>['params'];\n    let ctx: unknown;\n    try {\n      const inputData = inputSchema.parse(this.rawInput);\n      method = inputData.request.method;\n      params = inputData.request.params;\n      ctx = inputData.ctx;\n    } catch (e) {\n      throw new InvalidInputError('Invalid Input', e instanceof z.ZodError ? e.issues : undefined);\n    }\n\n    if (method !== 'resources/unsubscribe') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'resources/unsubscribe');\n    }\n\n    // Get session ID from context - required for subscription tracking\n    const sessionId = (ctx as Record<string, unknown> | undefined)?.['sessionId'];\n    if (!sessionId || typeof sessionId !== 'string') {\n      this.logger.warn('parseInput: sessionId not found in context');\n      throw new InvalidInputError('Session ID is required for resource unsubscriptions');\n    }\n\n    this.state.set({ input: params, sessionId });\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('unsubscribe')\n  async unsubscribe() {\n    this.logger.verbose('unsubscribe:start');\n    const { uri } = this.state.required.input;\n    const { sessionId } = this.state.required;\n\n    // Per MCP spec, unsubscribe should succeed even if the resource doesn't exist\n    // or the session wasn't subscribed. We just silently succeed.\n    const wasSubscribed = this.scope.notifications.unsubscribeResource(sessionId, uri);\n\n    if (wasSubscribed) {\n      this.logger.info(`unsubscribe: session unsubscribed from resource ${uri}`);\n    } else {\n      this.logger.verbose(`unsubscribe: session was not subscribed to resource ${uri}`);\n    }\n\n    this.logger.verbose('unsubscribe:done');\n  }\n\n  @Stage('finalize')\n  async finalize() {\n    this.logger.verbose('finalize:start');\n    // Per MCP spec, resources/unsubscribe returns an empty result\n    this.respond({});\n    this.logger.verbose('finalize:done');\n  }\n}\n"]}

package/src/resource/index.js

@@ -1,20 +0,0 @@
-"use strict";
-// file: libs/sdk/src/resource/index.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReadResourceFlow = exports.ResourceTemplatesListFlow = exports.ResourcesListFlow = exports.ResourceInstance = exports.ResourceRegistry = void 0;
-const tslib_1 = require("tslib");
-var resource_registry_1 = require("./resource.registry");
-Object.defineProperty(exports, "ResourceRegistry", { enumerable: true, get: function () { return tslib_1.__importDefault(resource_registry_1).default; } });
-var resource_instance_1 = require("./resource.instance");
-Object.defineProperty(exports, "ResourceInstance", { enumerable: true, get: function () { return resource_instance_1.ResourceInstance; } });
-tslib_1.__exportStar(require("./resource.events"), exports);
-tslib_1.__exportStar(require("./resource.types"), exports);
-tslib_1.__exportStar(require("./resource.utils"), exports);
-// Flows
-var resources_list_flow_1 = require("./flows/resources-list.flow");
-Object.defineProperty(exports, "ResourcesListFlow", { enumerable: true, get: function () { return tslib_1.__importDefault(resources_list_flow_1).default; } });
-var resource_templates_list_flow_1 = require("./flows/resource-templates-list.flow");
-Object.defineProperty(exports, "ResourceTemplatesListFlow", { enumerable: true, get: function () { return tslib_1.__importDefault(resource_templates_list_flow_1).default; } });
-var read_resource_flow_1 = require("./flows/read-resource.flow");
-Object.defineProperty(exports, "ReadResourceFlow", { enumerable: true, get: function () { return tslib_1.__importDefault(read_resource_flow_1).default; } });
-//# sourceMappingURL=index.js.map

package/src/resource/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resource/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;;;;AAEvC,yDAAkE;AAAzD,8IAAA,OAAO,OAAoB;AACpC,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,4DAAkC;AAClC,2DAAiC;AACjC,2DAAiC;AAEjC,QAAQ;AACR,mEAA2E;AAAlE,iJAAA,OAAO,OAAqB;AACrC,qFAA4F;AAAnF,kKAAA,OAAO,OAA6B;AAC7C,iEAAyE;AAAhE,+IAAA,OAAO,OAAoB","sourcesContent":["// file: libs/sdk/src/resource/index.ts\n\nexport { default as ResourceRegistry } from './resource.registry';\nexport { ResourceInstance } from './resource.instance';\nexport * from './resource.events';\nexport * from './resource.types';\nexport * from './resource.utils';\n\n// Flows\nexport { default as ResourcesListFlow } from './flows/resources-list.flow';\nexport { default as ResourceTemplatesListFlow } from './flows/resource-templates-list.flow';\nexport { default as ReadResourceFlow } from './flows/read-resource.flow';\n"]}

package/src/resource/resource.events.js

@@ -1,17 +0,0 @@
-"use strict";
-// file: libs/sdk/src/resource/resource.events.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceEmitter = void 0;
-class ResourceEmitter {
-    listeners = new Set();
-    on(l) {
-        this.listeners.add(l);
-        return () => this.listeners.delete(l);
-    }
-    emit(e) {
-        for (const l of [...this.listeners])
-            l(e);
-    }
-}
-exports.ResourceEmitter = ResourceEmitter;
-//# sourceMappingURL=resource.events.js.map

package/src/resource/resource.events.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource.events.js","sourceRoot":"","sources":["../../../src/resource/resource.events.ts"],"names":[],"mappings":";AAAA,iDAAiD;;;AAyBjD,MAAa,eAAe;IAClB,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IAExC,EAAE,CAAC,CAAW;QACZ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,CAAsB;QACzB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF;AAXD,0CAWC","sourcesContent":["// file: libs/sdk/src/resource/resource.events.ts\n\nimport { ResourceInstance } from './resource.instance';\n\nexport type ResourceChangeKind = 'added' | 'updated' | 'removed' | 'reset';\n\n/**\n * The scope of a change event.\n * - `global`: Change affects all sessions\n * - `session`: Change affects only a specific session\n */\nexport type ResourceChangeScope = 'global' | 'session';\n\nexport type ResourceChangeEvent = {\n  kind: ResourceChangeKind;\n  /** Whether the change affects all sessions or a specific session */\n  changeScope: ResourceChangeScope;\n  sessionId?: string;\n  relatedRequestId?: string;\n  version: number;\n  snapshot: readonly ResourceInstance[];\n};\n\ntype Listener = (e: ResourceChangeEvent) => void;\n\nexport class ResourceEmitter {\n  private listeners = new Set<Listener>();\n\n  on(l: Listener): () => void {\n    this.listeners.add(l);\n    return () => this.listeners.delete(l);\n  }\n\n  emit(e: ResourceChangeEvent) {\n    for (const l of [...this.listeners]) l(e);\n  }\n}\n"]}

package/src/resource/resource.instance.js

@@ -1,163 +0,0 @@
-"use strict";
-// file: libs/sdk/src/resource/resource.instance.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceInstance = void 0;
-const common_1 = require("../common");
-const hooks_utils_1 = require("../hooks/hooks.utils");
-const resource_utils_1 = require("./resource.utils");
-const mcp_error_1 = require("../errors/mcp.error");
-class ResourceInstance extends common_1.ResourceEntry {
-    providers;
-    scope;
-    hooks;
-    /** Parsed URI template info for template resources */
-    templateInfo;
-    constructor(record, providers, owner) {
-        super(record);
-        this.owner = owner;
-        this.providers = providers;
-        this.name = record.metadata.name;
-        this.fullName = this.owner.id + ':' + this.name;
-        this.scope = this.providers.getActiveScope();
-        this.hooks = this.scope.providers.getHooksRegistry();
-        // Determine if this is a template resource
-        this.isTemplate = 'uriTemplate' in record.metadata;
-        if (this.isTemplate) {
-            const templateMetadata = record.metadata;
-            this.uriTemplate = templateMetadata.uriTemplate;
-            // Pre-parse the URI template for efficient matching
-            this.templateInfo = (0, resource_utils_1.parseUriTemplate)(this.uriTemplate);
-        }
-        else {
-            const resourceMetadata = record.metadata;
-            this.uri = resourceMetadata.uri;
-        }
-        this.ready = this.initialize();
-    }
-    async initialize() {
-        // Valid flows for resource hooks
-        const validFlows = ['resources:read-resource', 'resources:list-resources', 'resources:list-resource-templates'];
-        const allHooks = (0, hooks_utils_1.normalizeHooksFromCls)(this.record.provide);
-        // Separate valid and invalid hooks
-        const validHooks = allHooks.filter((hook) => validFlows.includes(hook.metadata.flow));
-        const invalidHooks = allHooks.filter((hook) => !validFlows.includes(hook.metadata.flow));
-        // Throw error for invalid hooks (fail fast)
-        if (invalidHooks.length > 0) {
-            const className = this.record.provide?.name ?? 'Unknown';
-            const invalidFlowNames = invalidHooks.map((h) => h.metadata.flow).join(', ');
-            throw new mcp_error_1.InvalidHookFlowError(`Resource "${className}" has hooks for unsupported flows: ${invalidFlowNames}. ` +
-                `Only resource flows (${validFlows.join(', ')}) are supported on resource classes.`);
-        }
-        // Register valid hooks
-        if (validHooks.length > 0) {
-            await this.hooks.registerHooks(true, ...validHooks);
-        }
-    }
-    getMetadata() {
-        return this.record.metadata;
-    }
-    /**
-     * Match a URI against this resource.
-     * For static resources: exact match against uri
-     * For templates: pattern match and extract parameters
-     */
-    matchUri(uri) {
-        if (this.isTemplate && this.templateInfo && this.uriTemplate) {
-            const params = (0, resource_utils_1.matchUriTemplate)(this.uriTemplate, uri);
-            if (params) {
-                return { matches: true, params: params };
-            }
-            return { matches: false, params: {} };
-        }
-        // Static resource: exact match
-        if (this.uri === uri) {
-            return { matches: true, params: {} };
-        }
-        return { matches: false, params: {} };
-    }
-    /**
-     * Create a resource context (class or function wrapper).
-     */
-    create(uri, params, ctx) {
-        const metadata = this.metadata;
-        const providers = this.providers;
-        const scope = this.providers.getActiveScope();
-        const logger = scope.logger;
-        const authInfo = ctx.authInfo;
-        const resourceCtorArgs = {
-            metadata,
-            uri,
-            params,
-            providers,
-            logger,
-            authInfo,
-        };
-        const record = this.record;
-        switch (record.kind) {
-            case common_1.ResourceKind.CLASS_TOKEN:
-            case common_1.ResourceTemplateKind.CLASS_TOKEN:
-                return new record.provide(resourceCtorArgs);
-            case common_1.ResourceKind.FUNCTION:
-            case common_1.ResourceTemplateKind.FUNCTION:
-                return new FunctionResourceContext(record, resourceCtorArgs);
-            default:
-                // This should be unreachable if all ResourceKind and ResourceTemplateKind values are handled
-                throw new Error(`Unhandled resource kind: ${record.kind}`);
-        }
-    }
-    /**
-     * Convert the raw resource return value into an MCP ReadResourceResult.
-     */
-    parseOutput(raw) {
-        const uri = this.isTemplate ? this.uriTemplate : this.uri;
-        const mimeType = this.metadata.mimeType;
-        // If raw is already in ReadResourceResult format
-        if (raw && typeof raw === 'object' && 'contents' in raw) {
-            return raw;
-        }
-        // If raw is an array, assume it's an array of content items
-        if (Array.isArray(raw)) {
-            const contents = raw.map((item, index) => {
-                if (item && typeof item === 'object' && ('text' in item || 'blob' in item)) {
-                    const itemUri = item['uri'] || `${uri}#${index}`;
-                    const itemMimeType = item['mimeType'] || mimeType;
-                    if ('text' in item) {
-                        return { uri: itemUri, mimeType: itemMimeType, text: item['text'] };
-                    }
-                    return { uri: itemUri, mimeType: itemMimeType, blob: item['blob'] };
-                }
-                return (0, resource_utils_1.buildParsedResourceResult)(`${uri}#${index}`, item, mimeType);
-            });
-            return { contents };
-        }
-        // Single content item
-        const content = (0, resource_utils_1.buildParsedResourceResult)(uri, raw, mimeType);
-        return { contents: [content] };
-    }
-    /**
-     * Safe version of parseOutput that returns success/error instead of throwing.
-     */
-    safeParseOutput(raw) {
-        try {
-            return { success: true, data: this.parseOutput(raw) };
-        }
-        catch (error) {
-            return { success: false, error: error instanceof Error ? error : new Error(String(error)) };
-        }
-    }
-}
-exports.ResourceInstance = ResourceInstance;
-/**
- * Resource context for function-decorated resources.
- */
-class FunctionResourceContext extends common_1.ResourceContext {
-    record;
-    constructor(record, args) {
-        super(args);
-        this.record = record;
-    }
-    execute(uri, params) {
-        return this.record.provide(uri, params, this);
-    }
-}
-//# sourceMappingURL=resource.instance.js.map

package/src/resource/resource.instance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource.instance.js","sourceRoot":"","sources":["../../../src/resource/resource.instance.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/resource/resource.instance.ts\n\nimport {\n  EntryOwnerRef,\n  ResourceEntry,\n  ResourceReadExtra,\n  ParsedResourceResult,\n  ResourceSafeTransformResult,\n  ResourceRecord,\n  ResourceKind,\n  ResourceContext,\n  ResourceCtorArgs,\n  ResourceMetadata,\n  ResourceTemplateMetadata,\n  ResourceFunctionRecord,\n  ResourceTemplateRecord,\n  ResourceTemplateKind,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport HookRegistry from '../hooks/hook.registry';\nimport { Scope } from '../scope';\nimport { normalizeHooksFromCls } from '../hooks/hooks.utils';\nimport { matchUriTemplate, parseUriTemplate, buildParsedResourceResult } from './resource.utils';\nimport { InvalidHookFlowError } from '../errors/mcp.error';\n\nexport class ResourceInstance<\n  Params extends Record<string, string> = Record<string, string>,\n  Out = unknown,\n> extends ResourceEntry<Params, Out> {\n  private readonly providers: ProviderRegistry;\n  readonly scope: Scope;\n  readonly hooks: HookRegistry;\n\n  /** Parsed URI template info for template resources */\n  private templateInfo?: { pattern: RegExp; paramNames: string[] };\n\n  constructor(record: ResourceRecord | ResourceTemplateRecord, providers: ProviderRegistry, owner: EntryOwnerRef) {\n    super(record);\n    this.owner = owner;\n    this.providers = providers;\n    this.name = record.metadata.name;\n    this.fullName = this.owner.id + ':' + this.name;\n    this.scope = this.providers.getActiveScope();\n    this.hooks = this.scope.providers.getHooksRegistry();\n\n    // Determine if this is a template resource\n    this.isTemplate = 'uriTemplate' in record.metadata;\n\n    if (this.isTemplate) {\n      const templateMetadata = record.metadata as ResourceTemplateMetadata;\n      this.uriTemplate = templateMetadata.uriTemplate;\n      // Pre-parse the URI template for efficient matching\n      this.templateInfo = parseUriTemplate(this.uriTemplate);\n    } else {\n      const resourceMetadata = record.metadata as ResourceMetadata;\n      this.uri = resourceMetadata.uri;\n    }\n\n    this.ready = this.initialize();\n  }\n\n  protected async initialize(): Promise<void> {\n    // Valid flows for resource hooks\n    const validFlows = ['resources:read-resource', 'resources:list-resources', 'resources:list-resource-templates'];\n\n    const allHooks = normalizeHooksFromCls(this.record.provide);\n\n    // Separate valid and invalid hooks\n    const validHooks = allHooks.filter((hook) => validFlows.includes(hook.metadata.flow));\n    const invalidHooks = allHooks.filter((hook) => !validFlows.includes(hook.metadata.flow));\n\n    // Throw error for invalid hooks (fail fast)\n    if (invalidHooks.length > 0) {\n      const className = (this.record.provide as any)?.name ?? 'Unknown';\n      const invalidFlowNames = invalidHooks.map((h) => h.metadata.flow).join(', ');\n      throw new InvalidHookFlowError(\n        `Resource \"${className}\" has hooks for unsupported flows: ${invalidFlowNames}. ` +\n          `Only resource flows (${validFlows.join(', ')}) are supported on resource classes.`,\n      );\n    }\n\n    // Register valid hooks\n    if (validHooks.length > 0) {\n      await this.hooks.registerHooks(true, ...validHooks);\n    }\n  }\n\n  getMetadata(): ResourceMetadata | ResourceTemplateMetadata {\n    return this.record.metadata;\n  }\n\n  /**\n   * Match a URI against this resource.\n   * For static resources: exact match against uri\n   * For templates: pattern match and extract parameters\n   */\n  override matchUri(uri: string): { matches: boolean; params: Params } {\n    if (this.isTemplate && this.templateInfo && this.uriTemplate) {\n      const params = matchUriTemplate(this.uriTemplate, uri);\n      if (params) {\n        return { matches: true, params: params as Params };\n      }\n      return { matches: false, params: {} as Params };\n    }\n\n    // Static resource: exact match\n    if (this.uri === uri) {\n      return { matches: true, params: {} as Params };\n    }\n    return { matches: false, params: {} as Params };\n  }\n\n  /**\n   * Create a resource context (class or function wrapper).\n   */\n  override create(uri: string, params: Params, ctx: ResourceReadExtra): ResourceContext<Params, Out> {\n    const metadata = this.metadata;\n    const providers = this.providers;\n    const scope = this.providers.getActiveScope();\n    const logger = scope.logger;\n    const authInfo = ctx.authInfo;\n\n    const resourceCtorArgs: ResourceCtorArgs<Params> = {\n      metadata,\n      uri,\n      params,\n      providers,\n      logger,\n      authInfo,\n    };\n\n    const record = this.record as ResourceRecord | ResourceTemplateRecord;\n\n    switch (record.kind) {\n      case ResourceKind.CLASS_TOKEN:\n      case ResourceTemplateKind.CLASS_TOKEN:\n        return new (record.provide as unknown as new (args: ResourceCtorArgs<Params>) => ResourceContext<Params, Out>)(\n          resourceCtorArgs,\n        );\n      case ResourceKind.FUNCTION:\n      case ResourceTemplateKind.FUNCTION:\n        return new FunctionResourceContext<Params, Out>(record as ResourceFunctionRecord, resourceCtorArgs);\n      default:\n        // This should be unreachable if all ResourceKind and ResourceTemplateKind values are handled\n        throw new Error(`Unhandled resource kind: ${(record as any).kind}`);\n    }\n  }\n\n  /**\n   * Convert the raw resource return value into an MCP ReadResourceResult.\n   */\n  override parseOutput(raw: Out): ParsedResourceResult {\n    const uri = this.isTemplate ? this.uriTemplate! : this.uri!;\n    const mimeType = this.metadata.mimeType;\n\n    // If raw is already in ReadResourceResult format\n    if (raw && typeof raw === 'object' && 'contents' in raw) {\n      return raw as unknown as ParsedResourceResult;\n    }\n\n    // If raw is an array, assume it's an array of content items\n    if (Array.isArray(raw)) {\n      const contents = raw.map((item, index) => {\n        if (item && typeof item === 'object' && ('text' in item || 'blob' in item)) {\n          const itemUri = ((item as Record<string, unknown>)['uri'] as string | undefined) || `${uri}#${index}`;\n          const itemMimeType = ((item as Record<string, unknown>)['mimeType'] as string | undefined) || mimeType;\n          if ('text' in item) {\n            return { uri: itemUri, mimeType: itemMimeType, text: (item as Record<string, unknown>)['text'] as string };\n          }\n          return { uri: itemUri, mimeType: itemMimeType, blob: (item as Record<string, unknown>)['blob'] as string };\n        }\n        return buildParsedResourceResult(`${uri}#${index}`, item, mimeType);\n      });\n      return { contents };\n    }\n\n    // Single content item\n    const content = buildParsedResourceResult(uri, raw, mimeType);\n    return { contents: [content] };\n  }\n\n  /**\n   * Safe version of parseOutput that returns success/error instead of throwing.\n   */\n  override safeParseOutput(raw: Out): ResourceSafeTransformResult<ParsedResourceResult> {\n    try {\n      return { success: true, data: this.parseOutput(raw) };\n    } catch (error: unknown) {\n      return { success: false, error: error instanceof Error ? error : new Error(String(error)) };\n    }\n  }\n}\n\n/**\n * Resource context for function-decorated resources.\n */\nclass FunctionResourceContext<\n  Params extends Record<string, string> = Record<string, string>,\n  Out = unknown,\n> extends ResourceContext<Params, Out> {\n  constructor(private readonly record: ResourceFunctionRecord, args: ResourceCtorArgs<Params>) {\n    super(args);\n  }\n\n  execute(uri: string, params: Params): Promise<Out> {\n    return this.record.provide(uri, params, this);\n  }\n}\n"]}