@frontmcp/sdk 0.4.0 → 0.5.0

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

@@ -0,0 +1,45 @@
+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<{
+            _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, 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.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, 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.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, 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,44 @@
+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<{
+            _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, 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.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, 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.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, 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>;
+}

package/src/resource/resource.instance.js

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