@frontmcp/sdk 0.4.1 → 0.5.1

package/src/resource/flows/resources-list.flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources-list.flow.js","sourceRoot":"","sources":["../../../../src/resource/flows/resources-list.flow.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/resource/flows/resources-list.flow.ts\n\nimport { Flow, FlowBase, FlowControl, FlowHooksOf, FlowPlan, FlowRunOptions, ResourceEntry } from '../../common';\nimport 'reflect-metadata';\nimport { z } from 'zod';\nimport { ListResourcesRequestSchema, ListResourcesResultSchema, Resource } from '@modelcontextprotocol/sdk/types.js';\nimport { InvalidMethodError, InvalidInputError } from '../../errors';\n\nconst inputSchema = z.object({\n  request: ListResourcesRequestSchema,\n  ctx: z.unknown(),\n});\n\nconst outputSchema = ListResourcesResultSchema;\n\nconst stateSchema = z.object({\n  cursor: z.string().optional(),\n  resources: z.array(\n    z.object({\n      ownerName: z.string(),\n      resource: z.instanceof(ResourceEntry),\n    }),\n  ),\n  resolvedResources: z.array(\n    z.object({\n      ownerName: z.string(),\n      resource: z.instanceof(ResourceEntry),\n      finalName: z.string(),\n    }),\n  ),\n});\n\ntype ResponseResourceItem = Resource;\n\nconst plan = {\n  pre: ['parseInput'],\n  execute: ['findResources', 'resolveConflicts'],\n  post: ['parseResources'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'resources:list-resources': FlowRunOptions<\n      ResourcesListFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'resources:list-resources' as const;\nconst { Stage } = FlowHooksOf('resources:list-resources');\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class ResourcesListFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('ResourcesListFlow');\n\n  private sample<T>(arr: T[], n = 5): T[] {\n    return arr.slice(0, n);\n  }\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: any;\n    try {\n      const inputData = inputSchema.parse(this.rawInput);\n      method = inputData.request.method;\n      params = inputData.request.params;\n    } catch (e) {\n      throw new InvalidInputError('Invalid request format', e instanceof z.ZodError ? e.issues : undefined);\n    }\n\n    if (method !== 'resources/list') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'resources/list');\n    }\n\n    const cursor = params?.cursor;\n    if (cursor) this.logger.verbose(`parseInput: cursor=${cursor}`);\n    this.state.set('cursor', cursor);\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('findResources')\n  async findResources() {\n    this.logger.info('findResources:start');\n\n    try {\n      const resources: Array<{ ownerName: string; resource: ResourceEntry }> = [];\n\n      // Get resources from scope's resource registry\n      const scopeResources = this.scope.resources.getResources();\n      this.logger.verbose(`findResources: scope resources=${scopeResources.length}`);\n\n      for (const resource of scopeResources) {\n        resources.push({ ownerName: resource.owner.id, resource });\n      }\n\n      this.logger.info(`findResources: total resources collected=${resources.length}`);\n      if (resources.length === 0) {\n        this.logger.warn('findResources: no resources found');\n      }\n\n      this.state.set('resources', resources);\n      this.logger.verbose('findResources:done');\n    } catch (error) {\n      this.logger.error('findResources: failed to collect resources', error);\n      throw error;\n    }\n  }\n\n  @Stage('resolveConflicts')\n  async resolveConflicts() {\n    this.logger.verbose('resolveConflicts:start');\n\n    try {\n      const found = this.state.required.resources;\n\n      const counts = new Map<string, number>();\n      for (const { resource } of found) {\n        const baseName = resource.metadata.name;\n        counts.set(baseName, (counts.get(baseName) ?? 0) + 1);\n      }\n\n      const conflicts = new Set<string>([...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k));\n\n      if (conflicts.size > 0) {\n        const preview = this.sample(Array.from(conflicts)).join(', ');\n        const extra = conflicts.size > 5 ? `, +${conflicts.size - 5} more` : '';\n        this.logger.warn(`resolveConflicts: ${conflicts.size} name conflict(s) detected: ${preview}${extra}`);\n      } else {\n        this.logger.info('resolveConflicts: no name conflicts detected');\n      }\n\n      const resolved = found.map(({ ownerName, resource }) => {\n        const baseName = resource.metadata.name;\n        const finalName = conflicts.has(baseName) ? `${ownerName}:${baseName}` : baseName;\n        return { ownerName, resource, finalName };\n      });\n\n      this.state.set('resolvedResources', resolved);\n      this.logger.verbose('resolveConflicts:done');\n    } catch (error) {\n      this.logger.error('resolveConflicts: failed to resolve conflicts', error);\n      throw error;\n    }\n  }\n\n  @Stage('parseResources')\n  async parseResources() {\n    this.logger.verbose('parseResources:start');\n\n    try {\n      const resolved = this.state.required.resolvedResources;\n\n      // Log resources that will be filtered out due to missing URI\n      const withoutUri = resolved.filter(({ resource }) => resource.uri == null);\n      if (withoutUri.length > 0) {\n        this.logger.warn(`parseResources: ${withoutUri.length} resource(s) skipped due to missing URI`);\n      }\n\n      const resources: ResponseResourceItem[] = resolved\n        .filter(({ resource }) => resource.uri != null)\n        .map(({ finalName, resource }) => {\n          // Extract uri with type narrowing (guaranteed by filter above)\n          const uri = resource.uri as string;\n\n          const item: ResponseResourceItem = {\n            uri,\n            name: finalName,\n            title: resource.metadata.title,\n            description: resource.metadata.description,\n            mimeType: resource.metadata.mimeType,\n            icons: resource.metadata.icons,\n          };\n\n          // Add OpenAI-specific _meta for skybridge widget resources\n          // This is CRITICAL for ChatGPT to discover and render widgets\n          if (resource.metadata.mimeType === 'text/html+skybridge') {\n            item._meta = {\n              'openai/outputTemplate': uri,\n              'openai/resultCanProduceWidget': true,\n              'openai/widgetAccessible': true,\n            };\n          }\n\n          return item;\n        });\n\n      const preview = this.sample(resources.map((r) => r.name)).join(', ');\n      const extra = resources.length > 5 ? `, +${resources.length - 5} more` : '';\n      this.logger.info(`parseResources: prepared ${resources.length} resource descriptor(s): ${preview}${extra}`);\n\n      this.respond({ resources });\n      this.logger.info('parseResources: response sent');\n      this.logger.verbose('parseResources:done');\n    } catch (error) {\n      if (error instanceof FlowControl) throw error;\n      this.logger.error('parseResources: failed to parse resources', error);\n      throw error;\n    }\n  }\n}\n"]}

package/src/resource/flows/subscribe-resource.flow.d.ts

@@ -0,0 +1,60 @@
+import { FlowBase, FlowRunOptions } from '../../common';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        method: z.ZodLiteral<"resources/subscribe">;
+        params: z.ZodObject<{
+            task: z.ZodOptional<z.ZodObject<{
+                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                pollInterval: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
+                    taskId: z.ZodString;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
+            uri: z.ZodString;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+    ctx: z.ZodUnknown;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{
+        "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
+            taskId: z.ZodString;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$strict>;
+declare const stateSchema: z.ZodObject<{
+    input: z.ZodObject<{
+        uri: z.ZodString;
+    }, z.core.$strip>;
+    sessionId: z.ZodString;
+    output: z.ZodObject<{
+        _meta: z.ZodOptional<z.ZodObject<{
+            "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
+                taskId: z.ZodString;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+declare const plan: {
+    readonly pre: ["parseInput", "validateResource"];
+    readonly execute: ["subscribe"];
+    readonly finalize: ["finalize"];
+};
+declare global {
+    interface ExtendFlows {
+        'resources:subscribe': FlowRunOptions<SubscribeResourceFlow, typeof plan, typeof inputSchema, typeof outputSchema, typeof stateSchema>;
+    }
+}
+declare const name: "resources:subscribe";
+export default class SubscribeResourceFlow extends FlowBase<typeof name> {
+    logger: import("../../common").FrontMcpLogger;
+    parseInput(): Promise<void>;
+    validateResource(): Promise<void>;
+    subscribe(): Promise<void>;
+    finalize(): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,123 @@
+"use strict";
+// file: libs/sdk/src/resource/flows/subscribe-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.SubscribeRequestSchema,
+    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', 'validateResource'],
+    execute: ['subscribe'],
+    finalize: ['finalize'],
+};
+const name = 'resources:subscribe';
+const { Stage } = (0, common_1.FlowHooksOf)(name);
+let SubscribeResourceFlow = class SubscribeResourceFlow extends common_1.FlowBase {
+    logger = this.scopeLogger.child('SubscribeResourceFlow');
+    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/subscribe') {
+            this.logger.warn(`parseInput: invalid method "${method}"`);
+            throw new errors_1.InvalidMethodError(method, 'resources/subscribe');
+        }
+        // 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 subscriptions');
+        }
+        this.state.set({ input: params, sessionId });
+        this.logger.verbose('parseInput:done');
+    }
+    async validateResource() {
+        this.logger.verbose('validateResource:start');
+        const { uri } = this.state.required.input;
+        this.logger.info(`validateResource: checking resource with URI "${uri}"`);
+        // Verify the resource exists before allowing subscription
+        const match = this.scope.resources.findResourceForUri(uri);
+        if (!match) {
+            this.logger.warn(`validateResource: resource for URI "${uri}" not found`);
+            throw new errors_1.ResourceNotFoundError(uri);
+        }
+        this.logger.verbose('validateResource:done');
+    }
+    async subscribe() {
+        this.logger.verbose('subscribe:start');
+        const { uri } = this.state.required.input;
+        const { sessionId } = this.state.required;
+        const isNew = this.scope.notifications.subscribeResource(sessionId, uri);
+        if (isNew) {
+            this.logger.info(`subscribe: session subscribed to resource ${uri}`);
+        }
+        else {
+            this.logger.verbose(`subscribe: session already subscribed to resource ${uri}`);
+        }
+        this.logger.verbose('subscribe:done');
+    }
+    async finalize() {
+        this.logger.verbose('finalize:start');
+        // Per MCP spec, resources/subscribe 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)
+], SubscribeResourceFlow.prototype, "parseInput", null);
+tslib_1.__decorate([
+    Stage('validateResource'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], SubscribeResourceFlow.prototype, "validateResource", null);
+tslib_1.__decorate([
+    Stage('subscribe'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], SubscribeResourceFlow.prototype, "subscribe", null);
+tslib_1.__decorate([
+    Stage('finalize'),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], SubscribeResourceFlow.prototype, "finalize", null);
+SubscribeResourceFlow = tslib_1.__decorate([
+    (0, common_1.Flow)({
+        name,
+        plan,
+        inputSchema,
+        outputSchema,
+        access: 'authorized',
+    })
+], SubscribeResourceFlow);
+exports.default = SubscribeResourceFlow;
+//# sourceMappingURL=subscribe-resource.flow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-resource.flow.js","sourceRoot":"","sources":["../../../../src/resource/flows/subscribe-resource.flow.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/resource/flows/subscribe-resource.flow.ts\n\nimport { Flow, FlowBase, FlowHooksOf, FlowPlan, FlowRunOptions } from '../../common';\nimport { z } from 'zod';\nimport { SubscribeRequestSchema, EmptyResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { InvalidMethodError, InvalidInputError, ResourceNotFoundError } from '../../errors';\n\nconst inputSchema = z.object({\n  request: SubscribeRequestSchema,\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', 'validateResource'],\n  execute: ['subscribe'],\n  finalize: ['finalize'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'resources:subscribe': FlowRunOptions<\n      SubscribeResourceFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'resources:subscribe' as const;\nconst { Stage } = FlowHooksOf<'resources:subscribe'>(name);\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class SubscribeResourceFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('SubscribeResourceFlow');\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: z.infer<typeof SubscribeRequestSchema>['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/subscribe') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'resources/subscribe');\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 subscriptions');\n    }\n\n    this.state.set({ input: params, sessionId });\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('validateResource')\n  async validateResource() {\n    this.logger.verbose('validateResource:start');\n\n    const { uri } = this.state.required.input;\n    this.logger.info(`validateResource: checking resource with URI \"${uri}\"`);\n\n    // Verify the resource exists before allowing subscription\n    const match = this.scope.resources.findResourceForUri(uri);\n\n    if (!match) {\n      this.logger.warn(`validateResource: resource for URI \"${uri}\" not found`);\n      throw new ResourceNotFoundError(uri);\n    }\n\n    this.logger.verbose('validateResource:done');\n  }\n\n  @Stage('subscribe')\n  async subscribe() {\n    this.logger.verbose('subscribe:start');\n    const { uri } = this.state.required.input;\n    const { sessionId } = this.state.required;\n\n    const isNew = this.scope.notifications.subscribeResource(sessionId, uri);\n\n    if (isNew) {\n      this.logger.info(`subscribe: session subscribed to resource ${uri}`);\n    } else {\n      this.logger.verbose(`subscribe: session already subscribed to resource ${uri}`);\n    }\n\n    this.logger.verbose('subscribe:done');\n  }\n\n  @Stage('finalize')\n  async finalize() {\n    this.logger.verbose('finalize:start');\n    // Per MCP spec, resources/subscribe returns an empty result\n    this.respond({});\n    this.logger.verbose('finalize:done');\n  }\n}\n"]}

package/src/resource/flows/unsubscribe-resource.flow.d.ts

@@ -0,0 +1,59 @@
+import { FlowBase, FlowRunOptions } from '../../common';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        method: z.ZodLiteral<"resources/unsubscribe">;
+        params: z.ZodObject<{
+            task: z.ZodOptional<z.ZodObject<{
+                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+                pollInterval: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
+                    taskId: z.ZodString;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>;
+            uri: z.ZodString;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+    ctx: z.ZodUnknown;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodObject<{
+        "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
+            taskId: z.ZodString;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$strict>;
+declare const stateSchema: z.ZodObject<{
+    input: z.ZodObject<{
+        uri: z.ZodString;
+    }, z.core.$strip>;
+    sessionId: z.ZodString;
+    output: z.ZodObject<{
+        _meta: z.ZodOptional<z.ZodObject<{
+            "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
+                taskId: z.ZodString;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+declare const plan: {
+    readonly pre: ["parseInput"];
+    readonly execute: ["unsubscribe"];
+    readonly finalize: ["finalize"];
+};
+declare global {
+    interface ExtendFlows {
+        'resources:unsubscribe': FlowRunOptions<UnsubscribeResourceFlow, typeof plan, typeof inputSchema, typeof outputSchema, typeof stateSchema>;
+    }
+}
+declare const name: "resources:unsubscribe";
+export default class UnsubscribeResourceFlow extends FlowBase<typeof name> {
+    logger: import("../../common").FrontMcpLogger;
+    parseInput(): Promise<void>;
+    unsubscribe(): Promise<void>;
+    finalize(): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,107 @@
+"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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,8 @@
+export { default as ResourceRegistry } from './resource.registry';
+export { ResourceInstance } from './resource.instance';
+export * from './resource.events';
+export * from './resource.types';
+export * from './resource.utils';
+export { default as ResourcesListFlow } from './flows/resources-list.flow';
+export { default as ResourceTemplatesListFlow } from './flows/resource-templates-list.flow';
+export { default as ReadResourceFlow } from './flows/read-resource.flow';

package/src/resource/index.js

@@ -0,0 +1,20 @@
+"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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,24 @@
+import { ResourceInstance } from './resource.instance';
+export type ResourceChangeKind = 'added' | 'updated' | 'removed' | 'reset';
+/**
+ * The scope of a change event.
+ * - `global`: Change affects all sessions
+ * - `session`: Change affects only a specific session
+ */
+export type ResourceChangeScope = 'global' | 'session';
+export type ResourceChangeEvent = {
+    kind: ResourceChangeKind;
+    /** Whether the change affects all sessions or a specific session */
+    changeScope: ResourceChangeScope;
+    sessionId?: string;
+    relatedRequestId?: string;
+    version: number;
+    snapshot: readonly ResourceInstance[];
+};
+type Listener = (e: ResourceChangeEvent) => void;
+export declare class ResourceEmitter {
+    private listeners;
+    on(l: Listener): () => void;
+    emit(e: ResourceChangeEvent): void;
+}
+export {};

package/src/resource/resource.events.js

@@ -0,0 +1,17 @@
+"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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,35 @@
+import { EntryOwnerRef, ResourceEntry, ResourceReadExtra, ParsedResourceResult, ResourceSafeTransformResult, ResourceRecord, ResourceContext, ResourceMetadata, ResourceTemplateMetadata, ResourceTemplateRecord } from '../common';
+import ProviderRegistry from '../provider/provider.registry';
+import HookRegistry from '../hooks/hook.registry';
+import { Scope } from '../scope';
+export declare class ResourceInstance<Params extends Record<string, string> = Record<string, string>, Out = unknown> extends ResourceEntry<Params, Out> {
+    private readonly providers;
+    readonly scope: Scope;
+    readonly hooks: HookRegistry;
+    /** Parsed URI template info for template resources */
+    private templateInfo?;
+    constructor(record: ResourceRecord | ResourceTemplateRecord, providers: ProviderRegistry, owner: EntryOwnerRef);
+    protected initialize(): Promise<void>;
+    getMetadata(): ResourceMetadata | ResourceTemplateMetadata;
+    /**
+     * Match a URI against this resource.
+     * For static resources: exact match against uri
+     * For templates: pattern match and extract parameters
+     */
+    matchUri(uri: string): {
+        matches: boolean;
+        params: Params;
+    };
+    /**
+     * Create a resource context (class or function wrapper).
+     */
+    create(uri: string, params: Params, ctx: ResourceReadExtra): ResourceContext<Params, Out>;
+    /**
+     * Convert the raw resource return value into an MCP ReadResourceResult.
+     */
+    parseOutput(raw: Out): ParsedResourceResult;
+    /**
+     * Safe version of parseOutput that returns success/error instead of throwing.
+     */
+    safeParseOutput(raw: Out): ResourceSafeTransformResult<ParsedResourceResult>;
+}