@ifc-lite/mcp 0.2.0

package/dist/protocol/types.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Model Context Protocol (MCP) wire types.
+ *
+ * Implements the subset of MCP 2025-11 we need. JSON-RPC 2.0 envelopes,
+ * tool/resource/prompt shapes, progress notifications, and the cancellation
+ * helpers. We deliberately avoid `any` and keep the types narrow so the
+ * tool implementations get strong type-checking out of the box.
+ */
+export declare const PROTOCOL_VERSION = "2025-11-05";
+/**
+ * Protocol versions we are willing to negotiate. The server's wire surface
+ * (initialize, tools/{list,call}, resources/*, prompts/*, notifications/*,
+ * logging) has been backwards-compatible across these spec revisions, so we
+ * accept any of them and echo the requested version back during initialize.
+ * Unrecognized versions get downgraded to PROTOCOL_VERSION instead.
+ */
+export declare const SUPPORTED_PROTOCOL_VERSIONS: ReadonlySet<string>;
+export declare const JSONRPC_VERSION: "2.0";
+export type JsonRpcId = string | number;
+export interface JsonRpcRequest<P = unknown> {
+    jsonrpc: typeof JSONRPC_VERSION;
+    id: JsonRpcId;
+    method: string;
+    params?: P;
+}
+export interface JsonRpcNotification<P = unknown> {
+    jsonrpc: typeof JSONRPC_VERSION;
+    method: string;
+    params?: P;
+}
+export interface JsonRpcSuccessResponse<R = unknown> {
+    jsonrpc: typeof JSONRPC_VERSION;
+    id: JsonRpcId;
+    result: R;
+}
+export interface JsonRpcErrorResponse {
+    jsonrpc: typeof JSONRPC_VERSION;
+    id: JsonRpcId | null;
+    error: JsonRpcErrorObject;
+}
+export interface JsonRpcErrorObject {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;
+export declare const JsonRpcErrorCode: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    readonly ServerNotInitialized: -32002;
+    readonly RequestCancelled: -32800;
+};
+export interface ServerCapabilities {
+    tools?: {
+        listChanged?: boolean;
+    };
+    resources?: {
+        subscribe?: boolean;
+        listChanged?: boolean;
+    };
+    prompts?: {
+        listChanged?: boolean;
+    };
+    logging?: Record<string, never>;
+    experimental?: Record<string, unknown>;
+}
+export interface ClientCapabilities {
+    roots?: {
+        listChanged?: boolean;
+    };
+    sampling?: Record<string, never>;
+    experimental?: Record<string, unknown>;
+}
+export interface InitializeParams {
+    protocolVersion: string;
+    capabilities: ClientCapabilities;
+    clientInfo: {
+        name: string;
+        version: string;
+    };
+}
+export interface InitializeResult {
+    protocolVersion: string;
+    capabilities: ServerCapabilities;
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+    instructions?: string;
+}
+export type ContentBlock = TextContent | ImageContent | ResourceLink | EmbeddedResource;
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+export interface ImageContent {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+export interface ResourceLink {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+    };
+}
+export interface EmbeddedResource {
+    type: 'resource';
+    resource: ResourceContents;
+}
+export interface ResourceContents {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+    /** Optional metadata: which scope a token needs to call this tool. */
+    scope?: ToolScope;
+}
+export interface ListToolsResult {
+    tools: ToolDefinition[];
+    nextCursor?: string;
+}
+export interface CallToolParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+    _meta?: {
+        progressToken?: string | number;
+    };
+}
+export interface CallToolResult {
+    content: ContentBlock[];
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+}
+export type ToolScope = 'read' | 'validate' | 'mutate' | 'export' | 'admin';
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface ListResourcesResult {
+    resources: ResourceDefinition[];
+    nextCursor?: string;
+}
+export interface ReadResourceParams {
+    uri: string;
+}
+export interface ReadResourceResult {
+    contents: ResourceContents[];
+}
+export interface SubscribeParams {
+    uri: string;
+}
+export interface PromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: PromptArgument[];
+}
+export interface ListPromptsResult {
+    prompts: PromptDefinition[];
+}
+export interface GetPromptParams {
+    name: string;
+    arguments?: Record<string, string>;
+}
+export interface PromptMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: ContentBlock;
+}
+export interface GetPromptResult {
+    description?: string;
+    messages: PromptMessage[];
+}
+export interface ProgressNotification {
+    progressToken: string | number;
+    progress: number;
+    total?: number;
+    message?: string;
+}
+export interface ResourceUpdatedNotification {
+    uri: string;
+}
+export interface LogNotification {
+    level: 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical';
+    logger?: string;
+    data: unknown;
+}
+export interface JsonSchema {
+    type?: string | string[];
+    description?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: readonly unknown[];
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    format?: string;
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    additionalProperties?: boolean | JsonSchema;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAK1D,CAAC;AAEH,eAAO,MAAM,eAAe,EAAG,KAAc,CAAC;AAI9C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,OAAO;IACjD,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,CAAC,CAAC;CACX;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAEpF,eAAO,MAAM,gBAAgB;;;;;;;;CASnB,CAAC;AAIX,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAClC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,kBAAkB,CAAC;IACjC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,kBAAkB,CAAC;IACjC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,sEAAsE;IACtE,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAI5E,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAAG,GAAG,EAAE,MAAM,CAAA;CAAE;AAEnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAAG,GAAG,EAAE,MAAM,CAAA;CAAE;AAIhD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAID,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/protocol/types.js

@@ -0,0 +1,37 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Model Context Protocol (MCP) wire types.
+ *
+ * Implements the subset of MCP 2025-11 we need. JSON-RPC 2.0 envelopes,
+ * tool/resource/prompt shapes, progress notifications, and the cancellation
+ * helpers. We deliberately avoid `any` and keep the types narrow so the
+ * tool implementations get strong type-checking out of the box.
+ */
+export const PROTOCOL_VERSION = '2025-11-05';
+/**
+ * Protocol versions we are willing to negotiate. The server's wire surface
+ * (initialize, tools/{list,call}, resources/*, prompts/*, notifications/*,
+ * logging) has been backwards-compatible across these spec revisions, so we
+ * accept any of them and echo the requested version back during initialize.
+ * Unrecognized versions get downgraded to PROTOCOL_VERSION instead.
+ */
+export const SUPPORTED_PROTOCOL_VERSIONS = new Set([
+    '2025-03-26',
+    '2025-06-18',
+    '2025-11-05',
+    '2025-11-25',
+]);
+export const JSONRPC_VERSION = '2.0';
+export const JsonRpcErrorCode = {
+    ParseError: -32700,
+    InvalidRequest: -32600,
+    MethodNotFound: -32601,
+    InvalidParams: -32602,
+    InternalError: -32603,
+    // MCP-defined extension range starts at -32000.
+    ServerNotInitialized: -32002,
+    RequestCancelled: -32800,
+};
+//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAwB,IAAI,GAAG,CAAC;IACtE,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAc,CAAC;AAwC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,CAAC,KAAK;IAClB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,CAAC,KAAK;IACrB,aAAa,EAAE,CAAC,KAAK;IACrB,gDAAgD;IAChD,oBAAoB,EAAE,CAAC,KAAK;IAC5B,gBAAgB,EAAE,CAAC,KAAK;CAChB,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,6 @@
+import { ResourceRegistry } from './types.js';
+export { ResourceRegistry } from './types.js';
+export type { ResourceProvider } from './types.js';
+export { defaultResourceProviders } from './providers.js';
+export declare function buildDefaultResourceRegistry(): ResourceRegistry;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAAgB,4BAA4B,IAAI,gBAAgB,CAI/D"}

package/dist/resources/index.js

@@ -0,0 +1,13 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { ResourceRegistry } from './types.js';
+import { defaultResourceProviders } from './providers.js';
+export { ResourceRegistry } from './types.js';
+export { defaultResourceProviders } from './providers.js';
+export function buildDefaultResourceRegistry() {
+    const registry = new ResourceRegistry();
+    registry.registerAll(defaultResourceProviders());
+    return registry;
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,UAAU,4BAA4B;IAC1C,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,wBAAwB,EAAE,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/resources/providers.d.ts

@@ -0,0 +1,3 @@
+import type { ResourceProvider } from './types.js';
+export declare function defaultResourceProviders(): ResourceProvider[];
+//# sourceMappingURL=providers.d.ts.map

package/dist/resources/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/resources/providers.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgQnD,wBAAgB,wBAAwB,IAAI,gBAAgB,EAAE,CAW7D"}

package/dist/resources/providers.js

@@ -0,0 +1,270 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Resource providers for the `ifc-lite://` URI scheme (spec §8).
+ *
+ * The set lines up with the resource patterns in the spec table. Each
+ * provider knows both how to enumerate static resources (so they appear in
+ * `resources/list`) and how to resolve dynamic ones via URI matching.
+ */
+import { EntityNode } from '@ifc-lite/query';
+import { extractGeoreferencingOnDemand } from '@ifc-lite/parser';
+const URI_PREFIX = 'ifc-lite://';
+function jsonContents(uri, value) {
+    return {
+        uri,
+        mimeType: 'application/json',
+        text: JSON.stringify(value, null, 2),
+    };
+}
+class ManifestProvider {
+    name = 'manifest';
+    list(ctx) {
+        return ctx.registry.list().map((m) => ({
+            uri: `${URI_PREFIX}model/${m.id}/manifest`,
+            name: `${m.name} — manifest`,
+            description: `Schema, entity counts, georef, units for model '${m.id}'.`,
+            mimeType: 'application/json',
+        }));
+    }
+    match(uri) {
+        return /^ifc-lite:\/\/model\/[^/]+\/manifest$/.test(uri);
+    }
+    read(uri, ctx) {
+        const id = uri.replace(/^ifc-lite:\/\/model\//, '').replace(/\/manifest$/, '');
+        const m = ctx.registry.get(id);
+        if (!m)
+            return [];
+        const georef = extractGeoreferencingOnDemand(m.store);
+        return [jsonContents(uri, {
+                id: m.id,
+                name: m.name,
+                schema: m.store.schemaVersion,
+                entityCount: m.store.entityCount,
+                fileSize: m.store.fileSize,
+                georeferencing: georef ?? null,
+            })];
+    }
+}
+class EntityProvider {
+    name = 'entity';
+    list() {
+        // Entities are dynamic; expose the URL pattern as a hint via a single
+        // template entry the client can show in UI but won't try to fetch.
+        return [{
+                uri: `${URI_PREFIX}model/{model_id}/entity/{global_id}`,
+                name: 'Entity (template)',
+                description: 'Read full entity data by GlobalId. Substitute {model_id} and {global_id}.',
+                mimeType: 'application/json',
+            }];
+    }
+    match(uri) {
+        return /^ifc-lite:\/\/model\/[^/]+\/entity\/[^/]+$/.test(uri);
+    }
+    read(uri, ctx) {
+        const m = uri.match(/^ifc-lite:\/\/model\/([^/]+)\/entity\/(.+)$/);
+        if (!m)
+            return [];
+        const model = ctx.registry.get(m[1]);
+        if (!model)
+            return [];
+        const gid = decodeURIComponent(m[2]);
+        for (const [, ids] of model.store.entityIndex.byType) {
+            for (const id of ids) {
+                const node = new EntityNode(model.store, id);
+                if (node.globalId !== gid)
+                    continue;
+                const ref = { modelId: model.id, expressId: id };
+                return [jsonContents(uri, {
+                        ref,
+                        globalId: node.globalId,
+                        name: node.name,
+                        type: node.type,
+                        description: node.description,
+                        objectType: node.objectType,
+                        attributes: model.bim.attributes(ref),
+                        properties: model.bim.properties(ref),
+                        quantities: model.bim.quantities(ref),
+                        classifications: model.bim.classifications(ref),
+                        materials: model.bim.materials(ref),
+                    })];
+            }
+        }
+        return [];
+    }
+}
+class SpatialTreeProvider {
+    name = 'spatial-tree';
+    list(ctx) {
+        return ctx.registry.list().map((m) => ({
+            uri: `${URI_PREFIX}model/${m.id}/spatial-tree`,
+            name: `${m.name} — spatial tree`,
+            mimeType: 'application/json',
+        }));
+    }
+    match(uri) {
+        return /^ifc-lite:\/\/model\/[^/]+\/spatial-tree$/.test(uri);
+    }
+    read(uri, ctx) {
+        const id = uri.replace(/^ifc-lite:\/\/model\//, '').replace(/\/spatial-tree$/, '');
+        const m = ctx.registry.get(id);
+        if (!m)
+            return [];
+        const projectIds = m.store.entityIndex.byType.get('IFCPROJECT') ?? [];
+        if (projectIds.length === 0)
+            return [jsonContents(uri, null)];
+        return [jsonContents(uri, buildTreeNode(m.store, projectIds[0]))];
+    }
+}
+function buildTreeNode(store, expressId) {
+    const node = new EntityNode(store, expressId);
+    return {
+        expressId,
+        globalId: node.globalId,
+        type: node.type,
+        name: node.name,
+        children: node.decomposes().map((c) => buildTreeNode(store, c.expressId)),
+    };
+}
+class MaterialsProvider {
+    name = 'materials';
+    list(ctx) {
+        return ctx.registry.list().map((m) => ({
+            uri: `${URI_PREFIX}model/${m.id}/materials`,
+            name: `${m.name} — materials`,
+            mimeType: 'application/json',
+        }));
+    }
+    match(uri) {
+        return /^ifc-lite:\/\/model\/[^/]+\/materials$/.test(uri);
+    }
+    read(uri, ctx) {
+        const id = uri.replace(/^ifc-lite:\/\/model\//, '').replace(/\/materials$/, '');
+        const m = ctx.registry.get(id);
+        if (!m)
+            return [];
+        const counts = new Map();
+        for (const e of m.bim.query().toArray()) {
+            const mat = m.bim.materials(e.ref);
+            if (!mat)
+                continue;
+            const key = mat.name ?? '(unnamed)';
+            counts.set(key, (counts.get(key) ?? 0) + 1);
+        }
+        return [jsonContents(uri, {
+                materials: Array.from(counts.entries()).sort((a, b) => b[1] - a[1]).map(([name, count]) => ({ name, count })),
+            })];
+    }
+}
+class PropertySetsProvider {
+    name = 'property-sets';
+    list(ctx) {
+        return ctx.registry.list().map((m) => ({
+            uri: `${URI_PREFIX}model/${m.id}/property-sets`,
+            name: `${m.name} — property sets`,
+            mimeType: 'application/json',
+        }));
+    }
+    match(uri) {
+        return /^ifc-lite:\/\/model\/[^/]+\/property-sets$/.test(uri);
+    }
+    read(uri, ctx) {
+        const id = uri.replace(/^ifc-lite:\/\/model\//, '').replace(/\/property-sets$/, '');
+        const m = ctx.registry.get(id);
+        if (!m)
+            return [];
+        const seen = new Set();
+        const psets = [];
+        for (const e of m.bim.query().toArray()) {
+            for (const pset of m.bim.properties(e.ref)) {
+                if (seen.has(pset.name))
+                    continue;
+                seen.add(pset.name);
+                psets.push({ name: pset.name, properties: pset.properties.map((p) => p.name) });
+            }
+        }
+        return [jsonContents(uri, { propertySets: psets })];
+    }
+}
+class ServerManifestProvider {
+    name = 'server-manifest';
+    list() {
+        return [{
+                uri: `${URI_PREFIX}server/manifest`,
+                name: 'ifc-lite-mcp manifest',
+                description: 'Server-wide capabilities, version, and tool catalog summary.',
+                mimeType: 'application/json',
+            }];
+    }
+    match(uri) {
+        return uri === `${URI_PREFIX}server/manifest`;
+    }
+    read(uri, ctx) {
+        return [jsonContents(uri, {
+                readOnly: ctx.config.readOnly,
+                samplingEnabled: ctx.config.samplingEnabled,
+                bsddEndpoint: ctx.config.bsddEndpoint ?? 'https://api.bsdd.buildingsmart.org',
+                viewerOpen: ctx.viewer?.isOpen() ?? false,
+                modelsLoaded: ctx.registry.list().map((m) => ({ id: m.id, name: m.name, schema: m.store.schemaVersion })),
+            })];
+    }
+}
+class ViewerSelectionProvider {
+    name = 'viewer-selection';
+    list() {
+        return [{
+                uri: `${URI_PREFIX}viewer/selection`,
+                name: 'Viewer selection (live)',
+                description: 'Entity the user has clicked in the 3D viewer. Subscribe to receive `notifications/resources/updated` on every pick.',
+                mimeType: 'application/json',
+            }];
+    }
+    match(uri) {
+        return uri === `${URI_PREFIX}viewer/selection` || /^ifc-lite:\/\/model\/[^/]+\/viewer\/selection$/.test(uri);
+    }
+    read(uri, ctx) {
+        const state = ctx.viewer?.state();
+        if (!state) {
+            return [jsonContents(uri, { open: false, selection: [] })];
+        }
+        return [jsonContents(uri, {
+                open: true,
+                modelId: state.modelId,
+                url: state.url,
+                port: state.port,
+                selection: state.selection,
+            })];
+    }
+}
+class ViewerStatusProvider {
+    name = 'viewer-status';
+    list() {
+        return [{
+                uri: `${URI_PREFIX}viewer/status`,
+                name: 'Viewer status',
+                description: 'Whether the viewer is open, on what port, and how many browser clients are connected.',
+                mimeType: 'application/json',
+            }];
+    }
+    match(uri) {
+        return uri === `${URI_PREFIX}viewer/status`;
+    }
+    read(uri, ctx) {
+        const state = ctx.viewer?.state();
+        return [jsonContents(uri, state ?? { open: false })];
+    }
+}
+export function defaultResourceProviders() {
+    return [
+        new ServerManifestProvider(),
+        new ManifestProvider(),
+        new EntityProvider(),
+        new SpatialTreeProvider(),
+        new MaterialsProvider(),
+        new PropertySetsProvider(),
+        new ViewerSelectionProvider(),
+        new ViewerStatusProvider(),
+    ];
+}
+//# sourceMappingURL=providers.js.map

package/dist/resources/providers.js.map

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

package/dist/resources/types.d.ts

@@ -0,0 +1,29 @@
+import type { ResourceContents, ResourceDefinition } from '../protocol/index.js';
+import type { ToolContext } from '../context.js';
+/**
+ * A ResourceProvider can either:
+ *   - enumerate concrete resources (`list()`) — useful for static resources
+ *   - resolve URIs by pattern (`match()` + `read()`) — for dynamic ones
+ *     (e.g. `ifc-lite://model/{id}/entity/{globalId}`)
+ *
+ * Most providers do both: they enumerate the "manifest" resources and serve
+ * any URI that matches their patterns.
+ */
+export interface ResourceProvider {
+    /** Stable name for diagnostics. */
+    name: string;
+    /** Static resources advertised in `resources/list`. */
+    list(ctx: ToolContext): Promise<ResourceDefinition[]> | ResourceDefinition[];
+    /** True iff this provider can read the given URI. */
+    match(uri: string): boolean;
+    /** Read the resource. Throws when uri doesn't match. */
+    read(uri: string, ctx: ToolContext): Promise<ResourceContents[]> | ResourceContents[];
+}
+export declare class ResourceRegistry {
+    private providers;
+    register(provider: ResourceProvider): void;
+    registerAll(providers: ResourceProvider[]): void;
+    list(ctx: ToolContext): Promise<ResourceDefinition[]>;
+    matchProvider(uri: string): ResourceProvider | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/resources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resources/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC;IAC7E,qDAAqD;IACrD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,wDAAwD;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC;CACvF;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA0B;IAE3C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAI1C,WAAW,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAI1C,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAS3D,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;CAMpD"}

package/dist/resources/types.js

@@ -0,0 +1,30 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export class ResourceRegistry {
+    providers = [];
+    register(provider) {
+        this.providers.push(provider);
+    }
+    registerAll(providers) {
+        for (const p of providers)
+            this.register(p);
+    }
+    async list(ctx) {
+        const all = [];
+        for (const p of this.providers) {
+            const items = await p.list(ctx);
+            for (const item of items)
+                all.push(item);
+        }
+        return all;
+    }
+    matchProvider(uri) {
+        for (const p of this.providers) {
+            if (p.match(uri))
+                return p;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/resources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resources/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAyB/D,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAuB,EAAE,CAAC;IAE3C,QAAQ,CAAC,QAA0B;QACjC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,WAAW,CAAC,SAA6B;QACvC,KAAK,MAAM,CAAC,IAAI,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAgB;QACzB,MAAM,GAAG,GAAyB,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChC,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,aAAa,CAAC,GAAW;QACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}