@j0hanz/filesystem-mcp 2.7.6 → 2.8.1

package/dist/resources.js

@@ -2,8 +2,10 @@ import { ProtocolError, ProtocolErrorCode, ResourceNotFoundError, ResourceTempla
 import { ErrorCode, formatUnknownErrorMessage, isFsError } from "./core/errors.js";
 import { decodeFileUriPath, encodeFileUriPath, extractPath, FILESYSTEM_FILE_URI_TEMPLATE, } from "./core/file-uri.js";
 import { GuardedFileSystem } from "./core/fs.js";
-import { Logger } from "./core/observability.js";
+import { Logger, voidSend } from "./core/observability.js";
 import { suggestPaths } from "./core/path-completer.js";
+import { entryReadResult } from "./core/store.js";
+import { getMaxTextFileSize, jsonBytesOver, MAX_OUTBOUND_RESULT_BYTES } from "./core/util.js";
 import { createWatcherRegistry, MAX_WATCHERS, } from "./core/watcher-registry.js";
 import { buildSectionsRecord, INSTRUCTIONS_SUMMARY, INSTRUCTIONS_URI, renderSections, } from "./instructions.js";
 /**
@@ -97,7 +99,23 @@ function createFilesystemResource(options) {
             }
             await options.pathGuard.validateExistingPath(rawPath);
             const fs = new GuardedFileSystem(options.pathGuard);
+            const stdio = options.transport === 'stdio';
+            if (stdio) {
+                // Text encodes to at least its own bytes and base64 to 4/3 of them,
+                // so a file over the limit is refused before it is read. One past the
+                // file size limit is left to readRaw, whose refusal names that limit:
+                // HTTP would not serve it either.
+                const { stats } = await fs.stat(rawPath, { signal: ctx.mcpReq.signal });
+                if (stats.size > MAX_OUTBOUND_RESULT_BYTES && stats.size <= getMaxTextFileSize()) {
+                    throw tooLargeForStdio(stats.size, true);
+                }
+            }
             const readResult = await fs.readRaw(rawPath, { signal: ctx.mcpReq.signal });
+            if (stdio && readResult.isBinary) {
+                const base64Bytes = 4 * Math.ceil(readResult.content.length / 3);
+                if (base64Bytes > MAX_OUTBOUND_RESULT_BYTES)
+                    throw tooLargeForStdio(base64Bytes, true);
+            }
             return {
                 contents: [
                     {
@@ -233,15 +251,15 @@ function createResultResource(options) {
                 }
                 throw err;
             }
-            return {
-                contents: [{ uri: entry.uri, mimeType: entry.mimeType, text: entry.text }],
-            };
+            return entryReadResult(entry);
         },
     };
 }
 // ═══════════════════════════════════════════════════════════════
 // export contracts
 // ═══════════════════════════════════════════════════════════════
+// The file template last and typed as subscribable, so the registrar can
+// wire its subscribe handlers from the same list it registers.
 export function getResourceContracts(options) {
     return [
         createInstructionsResource(options),
@@ -267,10 +285,25 @@ function fsErrorToProtocolError(error) {
         ...(suggestion !== undefined ? { suggestion } : {}),
     });
 }
-function wrapRead(contract) {
+/**
+ * The refusal for a result stdio's fixed-size reader cannot carry. `atLeast`
+ * when `bytes` is a lower bound known before the result was encoded.
+ */
+function tooLargeForStdio(bytes, atLeast = false) {
+    const suggestion = 'Read smaller slices/pages with tools, or connect over HTTP.';
+    return new ProtocolError(ProtocolErrorCode.InvalidParams, `Resource result too large to return (${atLeast ? 'at least ' : ''}${String(bytes)} bytes once JSON-encoded, over the ${String(MAX_OUTBOUND_RESULT_BYTES)}-byte stdio message limit). ${suggestion}`, { code: ErrorCode.TOO_LARGE, suggestion });
+}
+function wrapRead(contract, transport) {
     return async (uri, variables, ctx) => {
         try {
-            return await contract.read(uri, variables, ctx);
+            const result = await contract.read(uri, variables, ctx);
+            if (transport === 'stdio') {
+                // Cache/file bytes exclude outer JSON escaping and binary base64.
+                const encodedBytes = jsonBytesOver(result, MAX_OUTBOUND_RESULT_BYTES);
+                if (encodedBytes !== undefined)
+                    throw tooLargeForStdio(encodedBytes);
+            }
+            return result;
         }
         catch (error) {
             // The SDK brands ProtocolError with `static [Symbol.hasInstance]`, so this
@@ -309,13 +342,8 @@ function owns(contract, uri) {
 }
 export function registerResources(deps) {
     const server = deps.server;
-    const options = { ...deps, readOnly: deps.readOnly ?? false };
-    const file = createFilesystemResource(options);
-    const resourceContracts = [
-        createInstructionsResource(options),
-        createResultResource(options),
-        file,
-    ];
+    const resourceContracts = getResourceContracts(deps);
+    const file = resourceContracts[2];
     for (const contract of resourceContracts) {
         const config = {
             ...(contract.title !== undefined ? { title: contract.title } : {}),
@@ -329,10 +357,10 @@ export function registerResources(deps) {
                 list: contract.list,
                 ...(contract.complete ? { complete: contract.complete } : {}),
             });
-            server.registerResource(contract.name, template, config, wrapRead(contract));
+            server.registerResource(contract.name, template, config, wrapRead(contract, deps.transport));
         }
         else if (contract.uri) {
-            server.registerResource(contract.name, contract.uri, config, (uri, ctx) => wrapRead(contract)(uri, {}, ctx));
+            server.registerResource(contract.name, contract.uri, config, (uri, ctx) => wrapRead(contract, deps.transport)(uri, {}, ctx));
         }
     }
     // `resources/subscribe`/`unsubscribe` are 2025-era-only verbs; a modern
@@ -341,9 +369,7 @@ export function registerResources(deps) {
     // reach. A legacy instance on the HTTP leg (the one built with a `notifier`)
     // lives for one request: a subscription accepted there would take a watcher
     // lease for an instance that is gone before the file changes. Leave the
-    // handlers off so the SDK refuses the verb, and no lease is taken. The
-    // predicate mirrors the capability gate in server.ts exactly, so the
-    // handler is registered if and only if `resources.subscribe` is advertised.
+    // handlers off so the SDK refuses the verb, and no lease is taken.
     // sunset(SEP-2577): removal trigger in docs/adr/002-legacy-protocol-paths-sunset.md.
     const legacyHttp = deps.era === 'legacy' && deps.notifier !== undefined;
     if (deps.era !== 'modern' && !legacyHttp) {
@@ -360,13 +386,8 @@ export function registerResources(deps) {
                 deps.notifier.resourceUpdated(updatedUri);
                 return;
             }
-            const updatePayload = { uri: updatedUri };
-            // A failed notify means the connection went away; nothing to recover.
-            void server.server.sendResourceUpdated(updatePayload).catch((err) => {
-                Logger.debug('resource update not delivered', {
-                    uri: updatedUri,
-                    error: formatUnknownErrorMessage(err),
-                });
+            voidSend(server.server.sendResourceUpdated({ uri: updatedUri }), 'resource update', {
+                uri: updatedUri,
             });
         };
         server.server.setRequestHandler('resources/subscribe', async (req) => {

package/dist/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CacheHint,\n  CompleteResourceTemplateCallback,\n  McpServer,\n  ReadResourceResult,\n  Resource,\n  ResourceUpdatedNotificationParams,\n  Role,\n  ServerContext,\n  ServerNotifier,\n  SubscribeRequestParams,\n  UnsubscribeRequestParams,\n} from '@modelcontextprotocol/server';\nimport {\n  ProtocolError,\n  ProtocolErrorCode,\n  ResourceNotFoundError,\n  ResourceTemplate,\n  UriTemplate,\n} from '@modelcontextprotocol/server';\n\nimport type { FsError } from './core/errors.ts';\nimport { ErrorCode, formatUnknownErrorMessage, isFsError } from './core/errors.ts';\nimport {\n  decodeFileUriPath,\n  encodeFileUriPath,\n  extractPath,\n  FILESYSTEM_FILE_URI_TEMPLATE,\n} from './core/file-uri.ts';\nimport { GuardedFileSystem } from './core/fs.ts';\nimport { Logger } from './core/observability.ts';\nimport { suggestPaths } from './core/path-completer.ts';\nimport type { PathGuard } from './core/path.ts';\nimport type { ResourceStore } from './core/store.ts';\nimport {\n  createWatcherRegistry,\n  MAX_WATCHERS,\n  type WatcherRegistry,\n} from './core/watcher-registry.ts';\nimport {\n  buildSectionsRecord,\n  INSTRUCTIONS_SUMMARY,\n  INSTRUCTIONS_URI,\n  renderSections,\n} from './instructions.ts';\n\n// ═══════════════════════════════════════════════════════════════\n// shared\n// ═══════════════════════════════════════════════════════════════\n\nexport interface ResourceRegistrationOptions {\n  resourceStore: ResourceStore;\n  pathGuard: PathGuard;\n  /** Mirrors the `--read-only` gate so the instructions match the tools actually registered. */\n  readOnly: boolean;\n  /**\n   * Shared file-watcher registry for the modern (per-request) HTTP leg. When set,\n   * the resource uses this handler-scoped registry instead of creating its own\n   * per-server one, so file-change watchers persist across requests and publish\n   * to the shared ServerEventBus. Omitted (per-server registry) on legacy/stdio.\n   */\n  watcherRegistry?: WatcherRegistry;\n  /** Modern-leg typed notification publisher. */\n  notifier?: ServerNotifier;\n  /** The protocol era this instance serves; omitted where the caller does not know. */\n  era?: 'legacy' | 'modern';\n  /**\n   * Scope for shared-content cache hints. 'private' when the endpoint is\n   * API-key gated, mirroring the list hints in server.ts — a shared cache must\n   * not store an authenticated response body. Defaults to 'public'.\n   */\n  cacheScope?: 'public' | 'private';\n}\n\ntype ResourceRegistrarDeps = Omit<ResourceRegistrationOptions, 'pathGuard' | 'readOnly'> & {\n  readonly server: McpServer;\n  readonly pathGuard: PathGuard;\n  readonly readOnly?: boolean;\n};\n\n/**\n * A filesystem failure that reads as not-found on the resource wire, for both\n * `resources/read` and `resources/subscribe`. ACCESS_DENIED folds in\n * deliberately: masking whether an out-of-root or denylisted path exists is the\n * security-correct answer, and the `FsError` message still carries the real\n * cause to the client.\n */\nfunction isNotFoundish(error: unknown): error is FsError {\n  return (\n    isFsError(error) &&\n    (error.code === ErrorCode.NOT_FOUND || error.code === ErrorCode.ACCESS_DENIED)\n  );\n}\n\n// ═══════════════════════════════════════════════════════════════\n// contract\n// ═══════════════════════════════════════════════════════════════\n\ninterface ResourceContract {\n  name: string;\n  title?: string;\n  description?: string;\n  mimeType?: string;\n  cacheHint?: CacheHint;\n  annotations?: {\n    audience?: Role[];\n    priority?: number;\n  };\n  /** A fixed, enumerable URI (e.g. internal://instructions)... */\n  uri?: string;\n  /** ...or a URI template, optionally with a completer for its variable. */\n  uriTemplate?: string;\n  complete?: { path: CompleteResourceTemplateCallback };\n  readonly read: (\n    uri: URL,\n    variables: Record<string, string | string[]>,\n    ctx: ServerContext,\n  ) => Promise<ReadResourceResult> | ReadResourceResult;\n  readonly subscribe?: (\n    uri: string,\n    notify: (uri: string) => void,\n  ) => Promise<boolean | undefined> | boolean | undefined;\n  readonly unsubscribe?: (uri: string) => void;\n  readonly destroy?: () => void;\n  readonly list?: (\n    ctx: ServerContext,\n  ) => Promise<{ resources: Resource[] }> | { resources: Resource[] };\n}\n\n/** The one contract with a live watcher behind it. */\ntype SubscribableContract = ResourceContract &\n  Required<Pick<ResourceContract, 'subscribe' | 'unsubscribe'>>;\n\n// ═══════════════════════════════════════════════════════════════\n// instructions\n// ═══════════════════════════════════════════════════════════════\n\nfunction createInstructionsResource(options: ResourceRegistrationOptions): ResourceContract {\n  const text = renderSections(buildSectionsRecord(options.readOnly));\n  return {\n    name: 'filesystem-mcp-instructions',\n    title: 'Server Instructions',\n    description: INSTRUCTIONS_SUMMARY,\n    mimeType: 'text/markdown',\n    uri: INSTRUCTIONS_URI,\n    annotations: { audience: ['assistant'], priority: 0.8 },\n    cacheHint: { cacheScope: options.cacheScope ?? 'public', ttlMs: 300_000 },\n    read(uri) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'text/markdown',\n            text,\n          },\n        ],\n      };\n    },\n  };\n}\n\n// ═══════════════════════════════════════════════════════════════\n// filesystem\n// ═══════════════════════════════════════════════════════════════\n\nfunction createFilesystemResource(options: ResourceRegistrationOptions): SubscribableContract {\n  const registry = options.watcherRegistry ?? createWatcherRegistry();\n  // Only the per-server (legacy/stdio) registry is owned by this resource and\n  // destroyed on dispose; the shared modern-leg registry is owned by the host\n  // and torn down at server shutdown.\n  const ownsRegistry = options.watcherRegistry === undefined;\n  // The URIs this connection holds a `resources/subscribe` lease for. The wire\n  // verb is per-URI and idempotent — a second subscribe is the same\n  // subscription, and one unsubscribe ends it — but the registry ref-counts\n  // leases (the HTTP listen leg needs that). Without this set a double\n  // subscribe took two leases that one unsubscribe could not release, and an\n  // unsubscribe for a URI never subscribed released a lease this connection\n  // never took, dropping a watcher some other holder still wanted.\n  const leasedUris = new Set<string>();\n  // Subscribes mid-acquire, keyed by URI. Two concurrent subscribes for the\n  // same URI must share one acquire: both passing the `leasedUris` check\n  // before either finished took two registry leases that the single set entry\n  // could release only once — on the shared modern registry that orphan lease\n  // pinned a watcher until process shutdown.\n  const inflight = new Map<string, Promise<boolean | undefined>>();\n\n  return {\n    name: 'filesystem-mcp-file',\n    title: 'Workspace File',\n    description: 'Read a file from the workspace. Subscribe to get updates when the file changes.',\n    uriTemplate: FILESYSTEM_FILE_URI_TEMPLATE,\n    annotations: { audience: ['assistant'], priority: 0.8 },\n    // Without this the SDK falls back to its conservative `{ ttlMs: 0,\n    // cacheScope: 'private' }`, making every file read uncacheable — and this\n    // is the one resource with a live invalidation channel, so TTL and the\n    // watcher compose exactly as the spec's caching section describes. The TTL\n    // stays short because a non-subscriber gets no invalidation signal at all.\n    cacheHint: { cacheScope: options.cacheScope ?? 'public', ttlMs: 5_000 },\n\n    // No `list`: the template registers with `list: undefined` — readable but\n    // not enumerable. Listing each allowed root as a concrete resource\n    // duplicated the template and grew resources/list linearly with roots;\n    // `list_roots` owns root discovery.\n\n    async read(uri, _variables, ctx: ServerContext) {\n      ctx.mcpReq.signal.throwIfAborted();\n      // Decode via extractPath — the same decoder resources/subscribe uses — so\n      // both consumers are symmetric with buildFileResourceUri's encoding. The\n      // {+path} template variable arrives still percent-encoded, so validating\n      // it directly would treat \"c%3A/proj/a.ts\" as a literal relative path;\n      // no fallback to it here, or the two branches would validate different\n      // strings. extractPath only fails past the template match on undecodable\n      // percent-encoding, which is the caller's malformed URI.\n      const rawPath = extractPath(uri.href);\n      if (rawPath === undefined) {\n        throw new ProtocolError(\n          ProtocolErrorCode.InvalidParams,\n          'Malformed file URI: path is not valid percent-encoding',\n        );\n      }\n      await options.pathGuard.validateExistingPath(rawPath);\n      const fs = new GuardedFileSystem(options.pathGuard);\n      const readResult = await fs.readRaw(rawPath, { signal: ctx.mcpReq.signal });\n\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: readResult.mimeType || 'application/octet-stream',\n            ...(readResult.isBinary\n              ? { blob: readResult.content.toString('base64') }\n              : { text: readResult.content.toString('utf-8') }),\n          },\n        ],\n      };\n    },\n\n    complete: {\n      // Both ends speak the `{+path}` form (see encodeFileUriPath), not raw OS\n      // paths: the partial arriving here is whatever this returned last, so the\n      // decode mirrors the encode. An undecodable partial is matched as typed.\n      path: async (value) => {\n        const suggestions = await suggestPaths(\n          options.pathGuard,\n          decodeFileUriPath(value) ?? value,\n        );\n        return suggestions.map(encodeFileUriPath);\n      },\n    },\n\n    subscribe(uri, notify) {\n      // Already subscribed on this connection: the watcher is live and the sink\n      // is registered, so this is a no-op success rather than a second lease.\n      if (leasedUris.has(uri)) return undefined;\n      // A subscribe for this URI is mid-acquire: share its outcome instead of\n      // taking a second lease the lease set cannot represent.\n      const pending = inflight.get(uri);\n      if (pending) return pending;\n\n      const acquire = async (): Promise<boolean | undefined> => {\n        const result = await registry.acquire(options.pathGuard, uri, notify, {\n          markSubscribe: true,\n        });\n        if (result.ok) {\n          leasedUris.add(uri);\n          return undefined;\n        }\n\n        if (result.reason === 'bad-uri') {\n          throw new ResourceNotFoundError(uri, `Cannot subscribe: not a filesystem URI`);\n        }\n        if (result.reason === 'invalid-path') {\n          const err = result.error;\n          if (isNotFoundish(err)) {\n            throw new ResourceNotFoundError(uri, `Cannot subscribe to ${uri}: ${err.message}`);\n          }\n          if (isFsError(err)) throw fsErrorToProtocolError(err);\n          Logger.warn(\n            `Unexpected error validating path for watcher ${uri}: ${formatUnknownErrorMessage(err)}`,\n          );\n          throw err;\n        }\n        // Unsubscribed (or the registry destroyed) mid-await: the caller already\n        // asked for this to stop, so there is nothing to reject.\n        if (result.reason === 'stale') return undefined;\n        // capped / attach-failed: `false` tells the handler to reject, since\n        // undefined would report success with no watcher attached.\n        return false;\n      };\n\n      const promise = acquire().finally(() => inflight.delete(uri));\n      inflight.set(uri, promise);\n      return promise;\n    },\n\n    unsubscribe(uri) {\n      // Only release a lease this connection actually took.\n      if (!leasedUris.delete(uri)) return;\n      registry.release(uri);\n    },\n\n    destroy() {\n      // Release what this connection still holds before the registry goes: on\n      // the shared (modern) registry nothing else would ever end these leases.\n      for (const uri of leasedUris) registry.release(uri);\n      leasedUris.clear();\n      if (ownsRegistry) registry.destroy();\n    },\n  };\n}\n\n// ═══════════════════════════════════════════════════════════════\n// result\n// ═══════════════════════════════════════════════════════════════\n\nfunction createResultResource(options: ResourceRegistrationOptions): ResourceContract {\n  return {\n    name: 'filesystem-mcp-result',\n    title: 'Cached Tool Result',\n    description:\n      'Ephemeral cached tool output. Listed via resources/list; entries expire after the cache TTL.',\n    mimeType: 'application/json',\n    uriTemplate: 'filesystem-mcp://result/{id}',\n    annotations: { audience: ['assistant'], priority: 0.3 },\n    cacheHint: { cacheScope: 'private', ttlMs: 60_000 },\n    list() {\n      const store = options.resourceStore;\n      const uris = store.keys(); // prunes expired first\n      const resources: Resource[] = [];\n      for (const uri of uris) {\n        try {\n          const entry = store.getEntry(uri);\n          resources.push({\n            uri: entry.uri,\n            name: entry.name,\n            description: `Cached tool result; expires ${entry.expiresAt}`,\n            mimeType: entry.mimeType,\n            size: entry.size,\n            annotations: { audience: ['assistant'], priority: 0.3, lastModified: entry.createdAt },\n          });\n        } catch (err) {\n          // An entry may expire between keys() and getEntry; skip it.\n          if (isFsError(err) && err.code === ErrorCode.NOT_FOUND) continue;\n          throw err;\n        }\n      }\n      // Recent-first: keys() returns insertion order, so the newest is last.\n      resources.reverse();\n      return { resources };\n    },\n    read(uri, variables) {\n      const { id } = variables;\n      if (typeof id !== 'string' || id.length === 0) {\n        throw new ProtocolError(\n          ProtocolErrorCode.InvalidParams,\n          'Malformed result URI: missing {id}. Use the exact resourceUri returned by the tool.',\n        );\n      }\n\n      let entry;\n      try {\n        entry = options.resourceStore.getEntry(uri.toString());\n      } catch (err) {\n        if (isFsError(err) && err.code === ErrorCode.NOT_FOUND) {\n          throw new ResourceNotFoundError(\n            uri.toString(),\n            'Cached result not found or expired. Re-run the tool to regenerate.',\n          );\n        }\n        throw err;\n      }\n      return {\n        contents: [{ uri: entry.uri, mimeType: entry.mimeType, text: entry.text }],\n      };\n    },\n  };\n}\n\n// ═══════════════════════════════════════════════════════════════\n// export contracts\n// ═══════════════════════════════════════════════════════════════\n\nexport function getResourceContracts(options: ResourceRegistrationOptions): ResourceContract[] {\n  return [\n    createInstructionsResource(options),\n    createResultResource(options),\n    createFilesystemResource(options),\n  ];\n}\n\n// ═══════════════════════════════════════════════════════════════\n// registrar\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * A caller-traceable FsError as the SDK's InvalidParams error. The Problem's\n * identity fields ride the SDK's error.data channel: `message` stays the\n * wire message, and code/path/suggestion give clients a machine-readable\n * view. Keyed by `code`, so it cannot collide with the\n * ResourceNotFoundError convention (data: { uri } and nothing else).\n */\nfunction fsErrorToProtocolError(error: FsError): ProtocolError {\n  const { code, path, suggestion } = error.problem;\n  return new ProtocolError(ProtocolErrorCode.InvalidParams, error.message, {\n    code,\n    ...(path !== undefined ? { path } : {}),\n    ...(suggestion !== undefined ? { suggestion } : {}),\n  });\n}\n\nfunction wrapRead(contract: ResourceContract) {\n  return async (uri: URL, variables: Record<string, string | string[]>, ctx: ServerContext) => {\n    try {\n      return await contract.read(uri, variables, ctx);\n    } catch (error) {\n      // The SDK brands ProtocolError with `static [Symbol.hasInstance]`, so this\n      // holds across separately bundled SDK copies and realms.\n      if (error instanceof ProtocolError) throw error;\n      // A missing or out-of-root path is a not-found, not a malformed request.\n      // The SDK puts ResourceNotFoundError on the wire as -32602 with\n      // `data.uri`, which is what clients match on; -32002 is the older code\n      // they also accept, and this SDK never emits it.\n      if (isNotFoundish(error)) {\n        throw new ResourceNotFoundError(uri.toString(), error.message);\n      }\n      // A remaining FsError (NOT_FILE, TOO_LARGE, ...) traces to the\n      // caller-supplied URI; anything else is a server-side failure and must\n      // not be blamed on the request.\n      if (isFsError(error)) throw fsErrorToProtocolError(error);\n      throw new ProtocolError(ProtocolErrorCode.InternalError, formatUnknownErrorMessage(error));\n    }\n  };\n}\n\n/**\n * Whether `contract` answers for `uri`, decided by the template matcher the SDK\n * dispatches `resources/read` with, so `resources/subscribe` and\n * `resources/read` agree on which resource owns a URI. Not\n * `checkResourceAllowed`: that is an RFC 8707 audience check comparing\n * `URL.origin`, which is the opaque `\"null\"` for every custom scheme, so it\n * matched `filesystem-mcp://result/…` — and any other scheme — to the file\n * template.\n */\nfunction owns(contract: ResourceContract, uri: string): boolean {\n  if (contract.uri !== undefined) return uri === contract.uri;\n  return (\n    contract.uriTemplate !== undefined && new UriTemplate(contract.uriTemplate).match(uri) !== null\n  );\n}\n\nexport function registerResources(deps: ResourceRegistrarDeps): { dispose(): void } {\n  const server = deps.server;\n  const options = { ...deps, readOnly: deps.readOnly ?? false };\n  const file = createFilesystemResource(options);\n  const resourceContracts = [\n    createInstructionsResource(options),\n    createResultResource(options),\n    file,\n  ];\n\n  for (const contract of resourceContracts) {\n    const config = {\n      ...(contract.title !== undefined ? { title: contract.title } : {}),\n      ...(contract.description !== undefined ? { description: contract.description } : {}),\n      ...(contract.mimeType !== undefined ? { mimeType: contract.mimeType } : {}),\n      ...(contract.annotations !== undefined ? { annotations: contract.annotations } : {}),\n      ...(contract.cacheHint !== undefined ? { cacheHint: contract.cacheHint } : {}),\n    };\n\n    if (contract.uriTemplate) {\n      const template = new ResourceTemplate(contract.uriTemplate, {\n        list: contract.list,\n        ...(contract.complete ? { complete: contract.complete } : {}),\n      });\n\n      server.registerResource(contract.name, template, config, wrapRead(contract));\n    } else if (contract.uri) {\n      server.registerResource(contract.name, contract.uri, config, (uri: URL, ctx: ServerContext) =>\n        wrapRead(contract)(uri, {}, ctx),\n      );\n    }\n  }\n\n  // `resources/subscribe`/`unsubscribe` are 2025-era-only verbs; a modern\n  // server answers `-32601 Method not found` for them, so registering these\n  // handlers on a modern-era instance would dispatch to code no request can\n  // reach. A legacy instance on the HTTP leg (the one built with a `notifier`)\n  // lives for one request: a subscription accepted there would take a watcher\n  // lease for an instance that is gone before the file changes. Leave the\n  // handlers off so the SDK refuses the verb, and no lease is taken. The\n  // predicate mirrors the capability gate in server.ts exactly, so the\n  // handler is registered if and only if `resources.subscribe` is advertised.\n  // sunset(SEP-2577): removal trigger in docs/adr/002-legacy-protocol-paths-sunset.md.\n  const legacyHttp = deps.era === 'legacy' && deps.notifier !== undefined;\n  if (deps.era !== 'modern' && !legacyHttp) {\n    server.server.assertCanSetRequestHandler('resources/subscribe');\n    server.server.assertCanSetRequestHandler('resources/unsubscribe');\n\n    // One stable callback for the whole registrar, NOT one per subscribe. The\n    // registry holds these in a Set keyed by identity, so a fresh closure per\n    // request made a second `resources/subscribe` for the same URI register a\n    // second sink: one file change then sent N notifications, and `unsubscribe`\n    // (which only ends a lease) removed none of them. Subscribe is per-URI on\n    // the wire, so the sink must be too — this makes it idempotent.\n    const notifyUpdated = (updatedUri: string): void => {\n      if (deps.notifier) {\n        deps.notifier.resourceUpdated(updatedUri);\n        return;\n      }\n      const updatePayload: ResourceUpdatedNotificationParams = { uri: updatedUri };\n      // A failed notify means the connection went away; nothing to recover.\n      void server.server.sendResourceUpdated(updatePayload).catch((err: unknown) => {\n        Logger.debug('resource update not delivered', {\n          uri: updatedUri,\n          error: formatUnknownErrorMessage(err),\n        });\n      });\n    };\n\n    server.server.setRequestHandler(\n      'resources/subscribe',\n      async (req: { params: SubscribeRequestParams }) => {\n        const { uri } = req.params;\n        if (!owns(file, uri)) {\n          // A resource that exists but has no watcher (the instructions text,\n          // a cached result) is NOT a not-found: reporting it as one told\n          // clients a URI they can list and read does not exist.\n          if (resourceContracts.some((contract) => owns(contract, uri))) {\n            throw new ProtocolError(\n              ProtocolErrorCode.InvalidParams,\n              `Resource ${uri} does not support subscriptions; only ${FILESYSTEM_FILE_URI_TEMPLATE} does. Read it again for the current contents.`,\n            );\n          }\n          throw new ResourceNotFoundError(uri, `Resource not found: ${uri}`);\n        }\n        if ((await file.subscribe(uri, notifyUpdated)) === false) {\n          // InternalError for want of anything better: ProtocolErrorCode has\n          // no resource-limit member, and the message already names the\n          // actionable cause.\n          throw new ProtocolError(\n            ProtocolErrorCode.InternalError,\n            `Subscription rejected: no watcher attached (watcher limit ${MAX_WATCHERS} reached, or fs.watch failed to start).`,\n          );\n        }\n        return {};\n      },\n    );\n\n    server.server.setRequestHandler(\n      'resources/unsubscribe',\n      (req: { params: UnsubscribeRequestParams }) => {\n        if (owns(file, req.params.uri)) file.unsubscribe(req.params.uri);\n        return {};\n      },\n    );\n  }\n\n  return {\n    dispose(): void {\n      for (const contract of resourceContracts) {\n        if (contract.destroy) {\n          contract.destroy();\n        }\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CacheHint,\n  CompleteResourceTemplateCallback,\n  McpServer,\n  ReadResourceResult,\n  Resource,\n  Role,\n  ServerContext,\n  ServerNotifier,\n  SubscribeRequestParams,\n  UnsubscribeRequestParams,\n} from '@modelcontextprotocol/server';\nimport {\n  ProtocolError,\n  ProtocolErrorCode,\n  ResourceNotFoundError,\n  ResourceTemplate,\n  UriTemplate,\n} from '@modelcontextprotocol/server';\n\nimport type { FsError } from './core/errors.ts';\nimport { ErrorCode, formatUnknownErrorMessage, isFsError } from './core/errors.ts';\nimport {\n  decodeFileUriPath,\n  encodeFileUriPath,\n  extractPath,\n  FILESYSTEM_FILE_URI_TEMPLATE,\n} from './core/file-uri.ts';\nimport { GuardedFileSystem } from './core/fs.ts';\nimport { Logger, voidSend } from './core/observability.ts';\nimport { suggestPaths } from './core/path-completer.ts';\nimport type { PathGuard } from './core/path.ts';\nimport type { ResourceStore } from './core/store.ts';\nimport { entryReadResult } from './core/store.ts';\nimport { getMaxTextFileSize, jsonBytesOver, MAX_OUTBOUND_RESULT_BYTES } from './core/util.ts';\nimport {\n  createWatcherRegistry,\n  MAX_WATCHERS,\n  type WatcherRegistry,\n} from './core/watcher-registry.ts';\nimport {\n  buildSectionsRecord,\n  INSTRUCTIONS_SUMMARY,\n  INSTRUCTIONS_URI,\n  renderSections,\n} from './instructions.ts';\n\n// ═══════════════════════════════════════════════════════════════\n// shared\n// ═══════════════════════════════════════════════════════════════\n\nexport interface ResourceRegistrationOptions {\n  resourceStore: ResourceStore;\n  pathGuard: PathGuard;\n  /** Mirrors the `--read-only` gate so the instructions match the tools actually registered. */\n  readOnly: boolean;\n  /**\n   * Shared file-watcher registry for the modern (per-request) HTTP leg. When set,\n   * the resource uses this handler-scoped registry instead of creating its own\n   * per-server one, so file-change watchers persist across requests and publish\n   * to the shared ServerEventBus. Omitted (per-server registry) on legacy/stdio.\n   */\n  watcherRegistry?: WatcherRegistry;\n  /** Modern-leg typed notification publisher. */\n  notifier?: ServerNotifier;\n  /** The protocol era this instance serves; omitted where the caller does not know. */\n  era?: 'legacy' | 'modern';\n  /** Only stdio has the SDK's fixed-size read buffer. */\n  transport?: 'stdio' | 'http';\n  /**\n   * Scope for shared-content cache hints. 'private' when the endpoint is\n   * API-key gated, mirroring the list hints in server.ts — a shared cache must\n   * not store an authenticated response body. Defaults to 'public'.\n   */\n  cacheScope?: 'public' | 'private';\n}\n\ntype ResourceRegistrarDeps = Omit<ResourceRegistrationOptions, 'pathGuard'> & {\n  readonly server: McpServer;\n  readonly pathGuard: PathGuard;\n};\n\n/**\n * A filesystem failure that reads as not-found on the resource wire, for both\n * `resources/read` and `resources/subscribe`. ACCESS_DENIED folds in\n * deliberately: masking whether an out-of-root or denylisted path exists is the\n * security-correct answer, and the `FsError` message still carries the real\n * cause to the client.\n */\nfunction isNotFoundish(error: unknown): error is FsError {\n  return (\n    isFsError(error) &&\n    (error.code === ErrorCode.NOT_FOUND || error.code === ErrorCode.ACCESS_DENIED)\n  );\n}\n\n// ═══════════════════════════════════════════════════════════════\n// contract\n// ═══════════════════════════════════════════════════════════════\n\ninterface ResourceContract {\n  name: string;\n  title?: string;\n  description?: string;\n  mimeType?: string;\n  cacheHint?: CacheHint;\n  annotations?: {\n    audience?: Role[];\n    priority?: number;\n  };\n  /** A fixed, enumerable URI (e.g. internal://instructions)... */\n  uri?: string;\n  /** ...or a URI template, optionally with a completer for its variable. */\n  uriTemplate?: string;\n  complete?: { path: CompleteResourceTemplateCallback };\n  readonly read: (\n    uri: URL,\n    variables: Record<string, string | string[]>,\n    ctx: ServerContext,\n  ) => Promise<ReadResourceResult> | ReadResourceResult;\n  readonly subscribe?: (\n    uri: string,\n    notify: (uri: string) => void,\n  ) => Promise<boolean | undefined> | boolean | undefined;\n  readonly unsubscribe?: (uri: string) => void;\n  readonly destroy?: () => void;\n  readonly list?: (\n    ctx: ServerContext,\n  ) => Promise<{ resources: Resource[] }> | { resources: Resource[] };\n}\n\n/** The one contract with a live watcher behind it. */\ntype SubscribableContract = ResourceContract &\n  Required<Pick<ResourceContract, 'subscribe' | 'unsubscribe'>>;\n\n// ═══════════════════════════════════════════════════════════════\n// instructions\n// ═══════════════════════════════════════════════════════════════\n\nfunction createInstructionsResource(options: ResourceRegistrationOptions): ResourceContract {\n  const text = renderSections(buildSectionsRecord(options.readOnly));\n  return {\n    name: 'filesystem-mcp-instructions',\n    title: 'Server Instructions',\n    description: INSTRUCTIONS_SUMMARY,\n    mimeType: 'text/markdown',\n    uri: INSTRUCTIONS_URI,\n    annotations: { audience: ['assistant'], priority: 0.8 },\n    cacheHint: { cacheScope: options.cacheScope ?? 'public', ttlMs: 300_000 },\n    read(uri) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'text/markdown',\n            text,\n          },\n        ],\n      };\n    },\n  };\n}\n\n// ═══════════════════════════════════════════════════════════════\n// filesystem\n// ═══════════════════════════════════════════════════════════════\n\nfunction createFilesystemResource(options: ResourceRegistrationOptions): SubscribableContract {\n  const registry = options.watcherRegistry ?? createWatcherRegistry();\n  // Only the per-server (legacy/stdio) registry is owned by this resource and\n  // destroyed on dispose; the shared modern-leg registry is owned by the host\n  // and torn down at server shutdown.\n  const ownsRegistry = options.watcherRegistry === undefined;\n  // The URIs this connection holds a `resources/subscribe` lease for. The wire\n  // verb is per-URI and idempotent — a second subscribe is the same\n  // subscription, and one unsubscribe ends it — but the registry ref-counts\n  // leases (the HTTP listen leg needs that). Without this set a double\n  // subscribe took two leases that one unsubscribe could not release, and an\n  // unsubscribe for a URI never subscribed released a lease this connection\n  // never took, dropping a watcher some other holder still wanted.\n  const leasedUris = new Set<string>();\n  // Subscribes mid-acquire, keyed by URI. Two concurrent subscribes for the\n  // same URI must share one acquire: both passing the `leasedUris` check\n  // before either finished took two registry leases that the single set entry\n  // could release only once — on the shared modern registry that orphan lease\n  // pinned a watcher until process shutdown.\n  const inflight = new Map<string, Promise<boolean | undefined>>();\n\n  return {\n    name: 'filesystem-mcp-file',\n    title: 'Workspace File',\n    description: 'Read a file from the workspace. Subscribe to get updates when the file changes.',\n    uriTemplate: FILESYSTEM_FILE_URI_TEMPLATE,\n    annotations: { audience: ['assistant'], priority: 0.8 },\n    // Without this the SDK falls back to its conservative `{ ttlMs: 0,\n    // cacheScope: 'private' }`, making every file read uncacheable — and this\n    // is the one resource with a live invalidation channel, so TTL and the\n    // watcher compose exactly as the spec's caching section describes. The TTL\n    // stays short because a non-subscriber gets no invalidation signal at all.\n    cacheHint: { cacheScope: options.cacheScope ?? 'public', ttlMs: 5_000 },\n\n    // No `list`: the template registers with `list: undefined` — readable but\n    // not enumerable. Listing each allowed root as a concrete resource\n    // duplicated the template and grew resources/list linearly with roots;\n    // `list_roots` owns root discovery.\n\n    async read(uri, _variables, ctx: ServerContext) {\n      ctx.mcpReq.signal.throwIfAborted();\n      // Decode via extractPath — the same decoder resources/subscribe uses — so\n      // both consumers are symmetric with buildFileResourceUri's encoding. The\n      // {+path} template variable arrives still percent-encoded, so validating\n      // it directly would treat \"c%3A/proj/a.ts\" as a literal relative path;\n      // no fallback to it here, or the two branches would validate different\n      // strings. extractPath only fails past the template match on undecodable\n      // percent-encoding, which is the caller's malformed URI.\n      const rawPath = extractPath(uri.href);\n      if (rawPath === undefined) {\n        throw new ProtocolError(\n          ProtocolErrorCode.InvalidParams,\n          'Malformed file URI: path is not valid percent-encoding',\n        );\n      }\n      await options.pathGuard.validateExistingPath(rawPath);\n      const fs = new GuardedFileSystem(options.pathGuard);\n      const stdio = options.transport === 'stdio';\n      if (stdio) {\n        // Text encodes to at least its own bytes and base64 to 4/3 of them,\n        // so a file over the limit is refused before it is read. One past the\n        // file size limit is left to readRaw, whose refusal names that limit:\n        // HTTP would not serve it either.\n        const { stats } = await fs.stat(rawPath, { signal: ctx.mcpReq.signal });\n        if (stats.size > MAX_OUTBOUND_RESULT_BYTES && stats.size <= getMaxTextFileSize()) {\n          throw tooLargeForStdio(stats.size, true);\n        }\n      }\n      const readResult = await fs.readRaw(rawPath, { signal: ctx.mcpReq.signal });\n      if (stdio && readResult.isBinary) {\n        const base64Bytes = 4 * Math.ceil(readResult.content.length / 3);\n        if (base64Bytes > MAX_OUTBOUND_RESULT_BYTES) throw tooLargeForStdio(base64Bytes, true);\n      }\n\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: readResult.mimeType || 'application/octet-stream',\n            ...(readResult.isBinary\n              ? { blob: readResult.content.toString('base64') }\n              : { text: readResult.content.toString('utf-8') }),\n          },\n        ],\n      };\n    },\n\n    complete: {\n      // Both ends speak the `{+path}` form (see encodeFileUriPath), not raw OS\n      // paths: the partial arriving here is whatever this returned last, so the\n      // decode mirrors the encode. An undecodable partial is matched as typed.\n      path: async (value) => {\n        const suggestions = await suggestPaths(\n          options.pathGuard,\n          decodeFileUriPath(value) ?? value,\n        );\n        return suggestions.map(encodeFileUriPath);\n      },\n    },\n\n    subscribe(uri, notify) {\n      // Already subscribed on this connection: the watcher is live and the sink\n      // is registered, so this is a no-op success rather than a second lease.\n      if (leasedUris.has(uri)) return undefined;\n      // A subscribe for this URI is mid-acquire: share its outcome instead of\n      // taking a second lease the lease set cannot represent.\n      const pending = inflight.get(uri);\n      if (pending) return pending;\n\n      const acquire = async (): Promise<boolean | undefined> => {\n        const result = await registry.acquire(options.pathGuard, uri, notify, {\n          markSubscribe: true,\n        });\n        if (result.ok) {\n          leasedUris.add(uri);\n          return undefined;\n        }\n\n        if (result.reason === 'bad-uri') {\n          throw new ResourceNotFoundError(uri, `Cannot subscribe: not a filesystem URI`);\n        }\n        if (result.reason === 'invalid-path') {\n          const err = result.error;\n          if (isNotFoundish(err)) {\n            throw new ResourceNotFoundError(uri, `Cannot subscribe to ${uri}: ${err.message}`);\n          }\n          if (isFsError(err)) throw fsErrorToProtocolError(err);\n          Logger.warn(\n            `Unexpected error validating path for watcher ${uri}: ${formatUnknownErrorMessage(err)}`,\n          );\n          throw err;\n        }\n        // Unsubscribed (or the registry destroyed) mid-await: the caller already\n        // asked for this to stop, so there is nothing to reject.\n        if (result.reason === 'stale') return undefined;\n        // capped / attach-failed: `false` tells the handler to reject, since\n        // undefined would report success with no watcher attached.\n        return false;\n      };\n\n      const promise = acquire().finally(() => inflight.delete(uri));\n      inflight.set(uri, promise);\n      return promise;\n    },\n\n    unsubscribe(uri) {\n      // Only release a lease this connection actually took.\n      if (!leasedUris.delete(uri)) return;\n      registry.release(uri);\n    },\n\n    destroy() {\n      // Release what this connection still holds before the registry goes: on\n      // the shared (modern) registry nothing else would ever end these leases.\n      for (const uri of leasedUris) registry.release(uri);\n      leasedUris.clear();\n      if (ownsRegistry) registry.destroy();\n    },\n  };\n}\n\n// ═══════════════════════════════════════════════════════════════\n// result\n// ═══════════════════════════════════════════════════════════════\n\nfunction createResultResource(options: ResourceRegistrationOptions): ResourceContract {\n  return {\n    name: 'filesystem-mcp-result',\n    title: 'Cached Tool Result',\n    description:\n      'Ephemeral cached tool output. Listed via resources/list; entries expire after the cache TTL.',\n    mimeType: 'application/json',\n    uriTemplate: 'filesystem-mcp://result/{id}',\n    annotations: { audience: ['assistant'], priority: 0.3 },\n    cacheHint: { cacheScope: 'private', ttlMs: 60_000 },\n    list() {\n      const store = options.resourceStore;\n      const uris = store.keys(); // prunes expired first\n      const resources: Resource[] = [];\n      for (const uri of uris) {\n        try {\n          const entry = store.getEntry(uri);\n          resources.push({\n            uri: entry.uri,\n            name: entry.name,\n            description: `Cached tool result; expires ${entry.expiresAt}`,\n            mimeType: entry.mimeType,\n            size: entry.size,\n            annotations: { audience: ['assistant'], priority: 0.3, lastModified: entry.createdAt },\n          });\n        } catch (err) {\n          // An entry may expire between keys() and getEntry; skip it.\n          if (isFsError(err) && err.code === ErrorCode.NOT_FOUND) continue;\n          throw err;\n        }\n      }\n      // Recent-first: keys() returns insertion order, so the newest is last.\n      resources.reverse();\n      return { resources };\n    },\n    read(uri, variables) {\n      const { id } = variables;\n      if (typeof id !== 'string' || id.length === 0) {\n        throw new ProtocolError(\n          ProtocolErrorCode.InvalidParams,\n          'Malformed result URI: missing {id}. Use the exact resourceUri returned by the tool.',\n        );\n      }\n\n      let entry;\n      try {\n        entry = options.resourceStore.getEntry(uri.toString());\n      } catch (err) {\n        if (isFsError(err) && err.code === ErrorCode.NOT_FOUND) {\n          throw new ResourceNotFoundError(\n            uri.toString(),\n            'Cached result not found or expired. Re-run the tool to regenerate.',\n          );\n        }\n        throw err;\n      }\n      return entryReadResult(entry);\n    },\n  };\n}\n\n// ═══════════════════════════════════════════════════════════════\n// export contracts\n// ═══════════════════════════════════════════════════════════════\n\n// The file template last and typed as subscribable, so the registrar can\n// wire its subscribe handlers from the same list it registers.\nexport function getResourceContracts(\n  options: ResourceRegistrationOptions,\n): readonly [ResourceContract, ResourceContract, SubscribableContract] {\n  return [\n    createInstructionsResource(options),\n    createResultResource(options),\n    createFilesystemResource(options),\n  ];\n}\n\n// ═══════════════════════════════════════════════════════════════\n// registrar\n// ═══════════════════════════════════════════════════════════════\n\n/**\n * A caller-traceable FsError as the SDK's InvalidParams error. The Problem's\n * identity fields ride the SDK's error.data channel: `message` stays the\n * wire message, and code/path/suggestion give clients a machine-readable\n * view. Keyed by `code`, so it cannot collide with the\n * ResourceNotFoundError convention (data: { uri } and nothing else).\n */\nfunction fsErrorToProtocolError(error: FsError): ProtocolError {\n  const { code, path, suggestion } = error.problem;\n  return new ProtocolError(ProtocolErrorCode.InvalidParams, error.message, {\n    code,\n    ...(path !== undefined ? { path } : {}),\n    ...(suggestion !== undefined ? { suggestion } : {}),\n  });\n}\n\n/**\n * The refusal for a result stdio's fixed-size reader cannot carry. `atLeast`\n * when `bytes` is a lower bound known before the result was encoded.\n */\nfunction tooLargeForStdio(bytes: number, atLeast = false): ProtocolError {\n  const suggestion = 'Read smaller slices/pages with tools, or connect over HTTP.';\n  return new ProtocolError(\n    ProtocolErrorCode.InvalidParams,\n    `Resource result too large to return (${atLeast ? 'at least ' : ''}${String(bytes)} bytes once JSON-encoded, over the ${String(MAX_OUTBOUND_RESULT_BYTES)}-byte stdio message limit). ${suggestion}`,\n    { code: ErrorCode.TOO_LARGE, suggestion },\n  );\n}\n\nfunction wrapRead(contract: ResourceContract, transport: ResourceRegistrationOptions['transport']) {\n  return async (uri: URL, variables: Record<string, string | string[]>, ctx: ServerContext) => {\n    try {\n      const result = await contract.read(uri, variables, ctx);\n      if (transport === 'stdio') {\n        // Cache/file bytes exclude outer JSON escaping and binary base64.\n        const encodedBytes = jsonBytesOver(result, MAX_OUTBOUND_RESULT_BYTES);\n        if (encodedBytes !== undefined) throw tooLargeForStdio(encodedBytes);\n      }\n      return result;\n    } catch (error) {\n      // The SDK brands ProtocolError with `static [Symbol.hasInstance]`, so this\n      // holds across separately bundled SDK copies and realms.\n      if (error instanceof ProtocolError) throw error;\n      // A missing or out-of-root path is a not-found, not a malformed request.\n      // The SDK puts ResourceNotFoundError on the wire as -32602 with\n      // `data.uri`, which is what clients match on; -32002 is the older code\n      // they also accept, and this SDK never emits it.\n      if (isNotFoundish(error)) {\n        throw new ResourceNotFoundError(uri.toString(), error.message);\n      }\n      // A remaining FsError (NOT_FILE, TOO_LARGE, ...) traces to the\n      // caller-supplied URI; anything else is a server-side failure and must\n      // not be blamed on the request.\n      if (isFsError(error)) throw fsErrorToProtocolError(error);\n      throw new ProtocolError(ProtocolErrorCode.InternalError, formatUnknownErrorMessage(error));\n    }\n  };\n}\n\n/**\n * Whether `contract` answers for `uri`, decided by the template matcher the SDK\n * dispatches `resources/read` with, so `resources/subscribe` and\n * `resources/read` agree on which resource owns a URI. Not\n * `checkResourceAllowed`: that is an RFC 8707 audience check comparing\n * `URL.origin`, which is the opaque `\"null\"` for every custom scheme, so it\n * matched `filesystem-mcp://result/…` — and any other scheme — to the file\n * template.\n */\nfunction owns(contract: ResourceContract, uri: string): boolean {\n  if (contract.uri !== undefined) return uri === contract.uri;\n  return (\n    contract.uriTemplate !== undefined && new UriTemplate(contract.uriTemplate).match(uri) !== null\n  );\n}\n\nexport function registerResources(deps: ResourceRegistrarDeps): { dispose(): void } {\n  const server = deps.server;\n  const resourceContracts = getResourceContracts(deps);\n  const file = resourceContracts[2];\n\n  for (const contract of resourceContracts) {\n    const config = {\n      ...(contract.title !== undefined ? { title: contract.title } : {}),\n      ...(contract.description !== undefined ? { description: contract.description } : {}),\n      ...(contract.mimeType !== undefined ? { mimeType: contract.mimeType } : {}),\n      ...(contract.annotations !== undefined ? { annotations: contract.annotations } : {}),\n      ...(contract.cacheHint !== undefined ? { cacheHint: contract.cacheHint } : {}),\n    };\n\n    if (contract.uriTemplate) {\n      const template = new ResourceTemplate(contract.uriTemplate, {\n        list: contract.list,\n        ...(contract.complete ? { complete: contract.complete } : {}),\n      });\n\n      server.registerResource(contract.name, template, config, wrapRead(contract, deps.transport));\n    } else if (contract.uri) {\n      server.registerResource(contract.name, contract.uri, config, (uri: URL, ctx: ServerContext) =>\n        wrapRead(contract, deps.transport)(uri, {}, ctx),\n      );\n    }\n  }\n\n  // `resources/subscribe`/`unsubscribe` are 2025-era-only verbs; a modern\n  // server answers `-32601 Method not found` for them, so registering these\n  // handlers on a modern-era instance would dispatch to code no request can\n  // reach. A legacy instance on the HTTP leg (the one built with a `notifier`)\n  // lives for one request: a subscription accepted there would take a watcher\n  // lease for an instance that is gone before the file changes. Leave the\n  // handlers off so the SDK refuses the verb, and no lease is taken.\n  // sunset(SEP-2577): removal trigger in docs/adr/002-legacy-protocol-paths-sunset.md.\n  const legacyHttp = deps.era === 'legacy' && deps.notifier !== undefined;\n  if (deps.era !== 'modern' && !legacyHttp) {\n    server.server.assertCanSetRequestHandler('resources/subscribe');\n    server.server.assertCanSetRequestHandler('resources/unsubscribe');\n\n    // One stable callback for the whole registrar, NOT one per subscribe. The\n    // registry holds these in a Set keyed by identity, so a fresh closure per\n    // request made a second `resources/subscribe` for the same URI register a\n    // second sink: one file change then sent N notifications, and `unsubscribe`\n    // (which only ends a lease) removed none of them. Subscribe is per-URI on\n    // the wire, so the sink must be too — this makes it idempotent.\n    const notifyUpdated = (updatedUri: string): void => {\n      if (deps.notifier) {\n        deps.notifier.resourceUpdated(updatedUri);\n        return;\n      }\n      voidSend(server.server.sendResourceUpdated({ uri: updatedUri }), 'resource update', {\n        uri: updatedUri,\n      });\n    };\n\n    server.server.setRequestHandler(\n      'resources/subscribe',\n      async (req: { params: SubscribeRequestParams }) => {\n        const { uri } = req.params;\n        if (!owns(file, uri)) {\n          // A resource that exists but has no watcher (the instructions text,\n          // a cached result) is NOT a not-found: reporting it as one told\n          // clients a URI they can list and read does not exist.\n          if (resourceContracts.some((contract) => owns(contract, uri))) {\n            throw new ProtocolError(\n              ProtocolErrorCode.InvalidParams,\n              `Resource ${uri} does not support subscriptions; only ${FILESYSTEM_FILE_URI_TEMPLATE} does. Read it again for the current contents.`,\n            );\n          }\n          throw new ResourceNotFoundError(uri, `Resource not found: ${uri}`);\n        }\n        if ((await file.subscribe(uri, notifyUpdated)) === false) {\n          // InternalError for want of anything better: ProtocolErrorCode has\n          // no resource-limit member, and the message already names the\n          // actionable cause.\n          throw new ProtocolError(\n            ProtocolErrorCode.InternalError,\n            `Subscription rejected: no watcher attached (watcher limit ${MAX_WATCHERS} reached, or fs.watch failed to start).`,\n          );\n        }\n        return {};\n      },\n    );\n\n    server.server.setRequestHandler(\n      'resources/unsubscribe',\n      (req: { params: UnsubscribeRequestParams }) => {\n        if (owns(file, req.params.uri)) file.unsubscribe(req.params.uri);\n        return {};\n      },\n    );\n  }\n\n  return {\n    dispose(): void {\n      for (const contract of resourceContracts) {\n        if (contract.destroy) {\n          contract.destroy();\n        }\n      }\n    },\n  };\n}\n"]}

package/dist/server.d.ts

@@ -36,14 +36,17 @@ export declare function createServer(options?: ServerOptions, extraDeps?: {
     pageStore?: PageSnapshotStore;
     /** The protocol era this instance serves; omitted where the caller does not know. */
     era?: 'legacy' | 'modern';
-    /** Only `stdio` has the SDK's fixed 10 MiB ReadBuffer, so only there does `read` cap its result. */
+    /**
+     * Only `stdio` has the SDK's fixed 10 MiB ReadBuffer, so only there are
+     * results capped: any tool call that changed nothing, any resource read,
+     * and a result-store entry by the size of its read (define.ts,
+     * resources.ts, store.ts).
+     */
     transport?: 'stdio' | 'http';
     /**
-     * The resolved HTTP credential, from `--api-key` or `FS_API_KEY`. Lives here
-     * rather than on `ServerOptions` because that object is `PathGuard`'s
-     * constructor argument and is exposed on its public `options` field — a
-     * bearer secret has no business being reachable from a tool handler.
+     * `private` when the HTTP host requires a bearer key, so a shared cache
+     * never serves one tenant's listing to another. Default `public`.
      */
-    apiKey?: string;
+    cacheScope?: 'private' | 'public';
 }): Promise<FilesystemServerContext>;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAKzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAgBlE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,mBAAmB,IAAI,IAAI,CAAC;CAC7B;AAED,wBAAsB,YAAY,CAChC,OAAO,GAAE,aAAkB,EAC3B,SAAS,CAAC,EAAE;IACV,0EAA0E;IAC1E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,qFAAqF;IACrF,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,oGAAoG;IACpG,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,uBAAuB,CAAC,CA8IlC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAKzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAgBlE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,mBAAmB,IAAI,IAAI,CAAC;CAC7B;AAED,wBAAsB,YAAY,CAChC,OAAO,GAAE,aAAkB,EAC3B,SAAS,CAAC,EAAE;IACV,0EAA0E;IAC1E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,qFAAqF;IACrF,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CACnC,GACA,OAAO,CAAC,uBAAuB,CAAC,CA+IlC"}

package/dist/server.js

@@ -1,10 +1,10 @@
 import { McpServer } from '@modelcontextprotocol/server';
 import packageJson from '../package.json' with { type: 'json' };
 import { requestStateCodec } from "./core/input-required.js";
-import { Logger } from "./core/observability.js";
+import { Logger, voidSend } from "./core/observability.js";
 import { PathGuard } from "./core/path.js";
 import { PageSnapshotStore, ResourceStore } from "./core/store.js";
-import { MAX_TOOL_INPUT_ELEMENTS } from "./core/util.js";
+import { MAX_OUTBOUND_RESULT_BYTES, MAX_TOOL_INPUT_ELEMENTS } from "./core/util.js";
 import { INSTRUCTIONS_SUMMARY, INSTRUCTIONS_URI } from "./instructions.js";
 import { registerPrompts } from "./prompts.js";
 import { registerResources } from "./resources.js";
@@ -33,7 +33,7 @@ export async function createServer(options = {}, extraDeps) {
     const capabilities = {
         resources: { subscribe: !legacyHttp, listChanged: !legacyHttp },
     };
-    const cacheScope = extraDeps?.apiKey ? 'private' : 'public';
+    const cacheScope = extraDeps?.cacheScope ?? 'public';
     const serverConfig = {
         capabilities,
         enforceStrictCapabilities: true,
@@ -92,17 +92,16 @@ export async function createServer(options = {}, extraDeps) {
         Logger.debug('Unhandled client notification', { method: notification.method });
         return Promise.resolve();
     };
-    // A failed send means the connection went away; nothing to recover.
     const resourceStore = extraDeps?.resourceStore ??
         new ResourceStore(() => {
             if (extraDeps?.notifier) {
                 extraDeps.notifier.resourcesChanged();
                 return;
             }
-            void server.server.sendResourceListChanged().catch((error) => {
-                Logger.debug('resource list_changed not delivered', { error: String(error) });
-            });
-        });
+            voidSend(server.server.sendResourceListChanged(), 'resource list_changed');
+        }, 
+        // A tool hands out no link that this connection's resources/read refuses.
+        extraDeps?.transport === 'stdio' ? { maxReadResultBytes: MAX_OUTBOUND_RESULT_BYTES } : {});
     const pageStore = extraDeps?.pageStore ?? new PageSnapshotStore();
     const pathGuard = extraDeps?.pathGuard ?? new PathGuard(options);
     // Recompute once per guard, keyed on the guard's own state rather than on
@@ -119,7 +118,7 @@ export async function createServer(options = {}, extraDeps) {
         pageStore,
         resourceStore,
         cacheScope,
-        ...(options.readOnly ? { readOnly: true } : {}),
+        readOnly: options.readOnly ?? false,
         ...(extraDeps?.watcherRegistry ? { watcherRegistry: extraDeps.watcherRegistry } : {}),
         ...(extraDeps?.notifier ? { notifier: extraDeps.notifier } : {}),
         ...(extraDeps?.era ? { era: extraDeps.era } : {}),

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Implementation,\n  ServerCapabilities,\n  ServerNotifier,\n} from '@modelcontextprotocol/server';\nimport { McpServer } from '@modelcontextprotocol/server';\n\nimport packageJson from '../package.json' with { type: 'json' };\nimport { requestStateCodec } from './core/input-required.ts';\nimport { Logger } from './core/observability.ts';\nimport type { ServerOptions } from './core/path.ts';\nimport { PathGuard } from './core/path.ts';\nimport { PageSnapshotStore, ResourceStore } from './core/store.ts';\nimport { MAX_TOOL_INPUT_ELEMENTS } from './core/util.ts';\nimport type { WatcherRegistry } from './core/watcher-registry.ts';\nimport { INSTRUCTIONS_SUMMARY, INSTRUCTIONS_URI } from './instructions.ts';\nimport { registerPrompts } from './prompts.ts';\nimport { registerResources } from './resources.ts';\nimport { registerTools } from './tools/index.ts';\n\n// ═══════════════════════════════════════════════════════════════\n// bootstrap\n// ═══════════════════════════════════════════════════════════════\n\nconst {\n  version: SERVER_VERSION,\n  description: SERVER_DESCRIPTION,\n  homepage: SERVER_HOMEPAGE,\n} = packageJson;\n\nexport interface FilesystemServerContext {\n  readonly mcp: McpServer;\n  readonly pathGuard: PathGuard;\n  disposeRuntimeState(): void;\n}\n\nexport async function createServer(\n  options: ServerOptions = {},\n  extraDeps?: {\n    /** Shared file-watcher registry for the modern (per-request) HTTP leg. */\n    watcherRegistry?: WatcherRegistry;\n    /** Modern-leg typed notification publisher. */\n    notifier?: ServerNotifier;\n    /**\n     * Guard to use instead of constructing one. The HTTP leg builds a single\n     * guard for the whole endpoint and passes it to every per-request instance,\n     * so an accepted access grant survives the request that accepted it (R8) and\n     * the listen-watcher path validates against the same allowed set. Omitted on\n     * stdio, where the instance is pinned for the connection and owns its guard.\n     */\n    pathGuard?: PathGuard;\n    /**\n     * Store to use instead of constructing one. The HTTP modern leg shares one\n     * store across every per-request instance, so a result a tool externalized\n     * in one POST survives to the follow-up resources/read. Omitted on stdio,\n     * where the pinned instance owns its store for the connection.\n     */\n    resourceStore?: ResourceStore;\n    /**\n     * Pagination snapshots shared by every modern HTTP request. Omitted on\n     * stdio, where the connection-owned context clears its store on close.\n     */\n    pageStore?: PageSnapshotStore;\n    /** The protocol era this instance serves; omitted where the caller does not know. */\n    era?: 'legacy' | 'modern';\n    /** Only `stdio` has the SDK's fixed 10 MiB ReadBuffer, so only there does `read` cap its result. */\n    transport?: 'stdio' | 'http';\n    /**\n     * The resolved HTTP credential, from `--api-key` or `FS_API_KEY`. Lives here\n     * rather than on `ServerOptions` because that object is `PathGuard`'s\n     * constructor argument and is exposed on its public `options` field — a\n     * bearer secret has no business being reachable from a tool handler.\n     */\n    apiKey?: string;\n  },\n): Promise<FilesystemServerContext> {\n  // Only `resources` is declared: `McpServer` advertises `tools` and `prompts`\n  // (with `listChanged: true`) and `completions` from the registrations below,\n  // but never infers `subscribe`.\n  //\n  // `resources.subscribe` stays advertised on both eras: the verb itself is\n  // 2025-only, but the SDK's listen router honors a `subscriptions/listen`\n  // resource filter only while this bit is advertised (dist: `allow(\n  // capabilities?.resources?.subscribe)` on `resourceSubscriptions`). The\n  // strict-capability gate on outbound `notifications/resources/updated`\n  // checks only that `resources` exists. The one exception is a\n  // legacy instance on the HTTP leg (era 'legacy' with a notifier): it serves\n  // one request, registers no subscribe handler (resources.ts, same\n  // predicate) and sends no notification of any kind — there is no stream to\n  // send it on — so neither `subscribe` nor `listChanged` is advertised.\n  // sunset(SEP-2577): removal trigger in docs/adr/002-legacy-protocol-paths-sunset.md.\n  const legacyHttp = extraDeps?.era === 'legacy' && extraDeps.notifier !== undefined;\n  const capabilities = {\n    resources: { subscribe: !legacyHttp, listChanged: !legacyHttp },\n  } satisfies ServerCapabilities;\n\n  const cacheScope: 'private' | 'public' = extraDeps?.apiKey ? 'private' : 'public';\n  const serverConfig: NonNullable<ConstructorParameters<typeof McpServer>[1]> = {\n    capabilities,\n    enforceStrictCapabilities: true,\n    // Structural bound on tools/call arguments, checked before Zod walks the\n    // value: the body limit is bytes (31 MiB by default), and every per-tool\n    // `.max()` runs only after a full traversal. No schema-legal call comes\n    // near this (see MAX_TOOL_INPUT_ELEMENTS); a payload over it is answered\n    // with a tool error after counting at most 4097 nodes.\n    maxToolInputElements: MAX_TOOL_INPUT_ELEMENTS,\n    cacheHints: {\n      'tools/list': { ttlMs: 3_600_000, cacheScope },\n      'prompts/list': { ttlMs: 3_600_000, cacheScope },\n      // Always private, never `cacheScope`: this list enumerates the\n      // ResourceStore, so its entries are one caller's externalized tool output\n      // — the same entries whose own read hint is `private` (resources.ts). The\n      // other four lists are the same for every caller and follow the key, and\n      // they are built from frozen module-level arrays that cannot change at\n      // runtime, so an hour is honest: a shorter hint only buys the client a\n      // re-fetch of bytes that cannot have differed, at the cost of the prompt\n      // cache stability the spec asks deterministic ordering to preserve.\n      'resources/list': { ttlMs: 30_000, cacheScope: 'private' },\n      'resources/templates/list': { ttlMs: 3_600_000, cacheScope },\n      'server/discover': { ttlMs: 3_600_000, cacheScope },\n    },\n    // Multi-round-trip `requestState` integrity (protocol revision 2026-07-28):\n    // the codec verifies the HMAC on every retried round before the handler\n    // runs, so a tampered or expired state is rejected as `-32602` rather than\n    // trusted. The decoded `PendingState` reaches handlers via\n    // `ctx.mcpReq.requestState<T>()`.\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    requestState: { verify: requestStateCodec.verify },\n    // The ResourceStore fires list-changed on every externalization and on\n    // every expiry prune (store.ts), so parallel tools/call on one\n    // connection can send the same notification several times in one tick;\n    // each copy makes the client refetch an unchanged list. The SDK\n    // coalesces same-tick duplicates for methods listed here.\n    // ponytail: same-tick coalescing only — cross-tick bursts (batch\n    // externalizations separated by fs awaits) still fan out; a store-level\n    // debounce is the fix if clients ever report that. The modern HTTP leg\n    // publishes through the ServerEventBus, which this option does not\n    // touch, so it protects the stdio/in-memory leg.\n    debouncedNotificationMethods: ['notifications/resources/list_changed'],\n  };\n\n  serverConfig.instructions =\n    `${INSTRUCTIONS_SUMMARY} ` +\n    `For full guidance, read ${INSTRUCTIONS_URI} or run the get-help prompt.`;\n\n  const implementation: Implementation = {\n    name: 'filesystem-mcp',\n    title: 'Filesystem MCP',\n    version: SERVER_VERSION,\n    ...(SERVER_DESCRIPTION ? { description: SERVER_DESCRIPTION } : {}),\n    ...(SERVER_HOMEPAGE ? { websiteUrl: SERVER_HOMEPAGE } : {}),\n  };\n  const server = new McpServer(implementation, serverConfig);\n  server.server.fallbackNotificationHandler = (notification) => {\n    Logger.debug('Unhandled client notification', { method: notification.method });\n    return Promise.resolve();\n  };\n\n  // A failed send means the connection went away; nothing to recover.\n  const resourceStore =\n    extraDeps?.resourceStore ??\n    new ResourceStore(() => {\n      if (extraDeps?.notifier) {\n        extraDeps.notifier.resourcesChanged();\n        return;\n      }\n      void server.server.sendResourceListChanged().catch((error: unknown) => {\n        Logger.debug('resource list_changed not delivered', { error: String(error) });\n      });\n    });\n  const pageStore = extraDeps?.pageStore ?? new PageSnapshotStore();\n\n  const pathGuard = extraDeps?.pathGuard ?? new PathGuard(options);\n  // Recompute once per guard, keyed on the guard's own state rather than on\n  // whether it was injected — an injected-but-uninitialized guard would\n  // otherwise deny every path. Not unconditional: the HTTP leg shares one guard\n  // across a fresh instance per request, and a repeat recompute would both redo\n  // the root resolution per request and race a concurrent `applyGrant`, which\n  // commits under a mutation lock this call does not take.\n  if (!pathGuard.isInitialized()) await pathGuard.recomputeAllowedDirectories();\n\n  const deps = {\n    server,\n    pathGuard,\n    pageStore,\n    resourceStore,\n    cacheScope,\n    ...(options.readOnly ? { readOnly: true } : {}),\n    ...(extraDeps?.watcherRegistry ? { watcherRegistry: extraDeps.watcherRegistry } : {}),\n    ...(extraDeps?.notifier ? { notifier: extraDeps.notifier } : {}),\n    ...(extraDeps?.era ? { era: extraDeps.era } : {}),\n    ...(extraDeps?.transport ? { transport: extraDeps.transport } : {}),\n  };\n\n  const resourceDisposable = registerResources(deps);\n  registerPrompts(deps);\n  registerTools(deps);\n\n  // False when the store is shared across instances and outlives this one.\n  const ownsPages = extraDeps?.pageStore === undefined;\n  let cleanedUp = false;\n  const context: FilesystemServerContext = {\n    mcp: server,\n    pathGuard,\n    disposeRuntimeState() {\n      if (cleanedUp) return;\n      cleanedUp = true;\n      if (ownsPages) pageStore.clear();\n      resourceDisposable.dispose();\n    },\n  };\n  const previousOnClose = server.server.onclose;\n  server.server.onclose = () => {\n    previousOnClose?.();\n    context.disposeRuntimeState();\n  };\n  return context;\n}\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Implementation,\n  ServerCapabilities,\n  ServerNotifier,\n} from '@modelcontextprotocol/server';\nimport { McpServer } from '@modelcontextprotocol/server';\n\nimport packageJson from '../package.json' with { type: 'json' };\nimport { requestStateCodec } from './core/input-required.ts';\nimport { Logger, voidSend } from './core/observability.ts';\nimport type { ServerOptions } from './core/path.ts';\nimport { PathGuard } from './core/path.ts';\nimport { PageSnapshotStore, ResourceStore } from './core/store.ts';\nimport { MAX_OUTBOUND_RESULT_BYTES, MAX_TOOL_INPUT_ELEMENTS } from './core/util.ts';\nimport type { WatcherRegistry } from './core/watcher-registry.ts';\nimport { INSTRUCTIONS_SUMMARY, INSTRUCTIONS_URI } from './instructions.ts';\nimport { registerPrompts } from './prompts.ts';\nimport { registerResources } from './resources.ts';\nimport { registerTools } from './tools/index.ts';\n\n// ═══════════════════════════════════════════════════════════════\n// bootstrap\n// ═══════════════════════════════════════════════════════════════\n\nconst {\n  version: SERVER_VERSION,\n  description: SERVER_DESCRIPTION,\n  homepage: SERVER_HOMEPAGE,\n} = packageJson;\n\nexport interface FilesystemServerContext {\n  readonly mcp: McpServer;\n  readonly pathGuard: PathGuard;\n  disposeRuntimeState(): void;\n}\n\nexport async function createServer(\n  options: ServerOptions = {},\n  extraDeps?: {\n    /** Shared file-watcher registry for the modern (per-request) HTTP leg. */\n    watcherRegistry?: WatcherRegistry;\n    /** Modern-leg typed notification publisher. */\n    notifier?: ServerNotifier;\n    /**\n     * Guard to use instead of constructing one. The HTTP leg builds a single\n     * guard for the whole endpoint and passes it to every per-request instance,\n     * so an accepted access grant survives the request that accepted it (R8) and\n     * the listen-watcher path validates against the same allowed set. Omitted on\n     * stdio, where the instance is pinned for the connection and owns its guard.\n     */\n    pathGuard?: PathGuard;\n    /**\n     * Store to use instead of constructing one. The HTTP modern leg shares one\n     * store across every per-request instance, so a result a tool externalized\n     * in one POST survives to the follow-up resources/read. Omitted on stdio,\n     * where the pinned instance owns its store for the connection.\n     */\n    resourceStore?: ResourceStore;\n    /**\n     * Pagination snapshots shared by every modern HTTP request. Omitted on\n     * stdio, where the connection-owned context clears its store on close.\n     */\n    pageStore?: PageSnapshotStore;\n    /** The protocol era this instance serves; omitted where the caller does not know. */\n    era?: 'legacy' | 'modern';\n    /**\n     * Only `stdio` has the SDK's fixed 10 MiB ReadBuffer, so only there are\n     * results capped: any tool call that changed nothing, any resource read,\n     * and a result-store entry by the size of its read (define.ts,\n     * resources.ts, store.ts).\n     */\n    transport?: 'stdio' | 'http';\n    /**\n     * `private` when the HTTP host requires a bearer key, so a shared cache\n     * never serves one tenant's listing to another. Default `public`.\n     */\n    cacheScope?: 'private' | 'public';\n  },\n): Promise<FilesystemServerContext> {\n  // Only `resources` is declared: `McpServer` advertises `tools` and `prompts`\n  // (with `listChanged: true`) and `completions` from the registrations below,\n  // but never infers `subscribe`.\n  //\n  // `resources.subscribe` stays advertised on both eras: the verb itself is\n  // 2025-only, but the SDK's listen router honors a `subscriptions/listen`\n  // resource filter only while this bit is advertised (dist: `allow(\n  // capabilities?.resources?.subscribe)` on `resourceSubscriptions`). The\n  // strict-capability gate on outbound `notifications/resources/updated`\n  // checks only that `resources` exists. The one exception is a\n  // legacy instance on the HTTP leg (era 'legacy' with a notifier): it serves\n  // one request, registers no subscribe handler (resources.ts, same\n  // predicate) and sends no notification of any kind — there is no stream to\n  // send it on — so neither `subscribe` nor `listChanged` is advertised.\n  // sunset(SEP-2577): removal trigger in docs/adr/002-legacy-protocol-paths-sunset.md.\n  const legacyHttp = extraDeps?.era === 'legacy' && extraDeps.notifier !== undefined;\n  const capabilities = {\n    resources: { subscribe: !legacyHttp, listChanged: !legacyHttp },\n  } satisfies ServerCapabilities;\n\n  const cacheScope = extraDeps?.cacheScope ?? 'public';\n  const serverConfig: NonNullable<ConstructorParameters<typeof McpServer>[1]> = {\n    capabilities,\n    enforceStrictCapabilities: true,\n    // Structural bound on tools/call arguments, checked before Zod walks the\n    // value: the body limit is bytes (31 MiB by default), and every per-tool\n    // `.max()` runs only after a full traversal. No schema-legal call comes\n    // near this (see MAX_TOOL_INPUT_ELEMENTS); a payload over it is answered\n    // with a tool error after counting at most 4097 nodes.\n    maxToolInputElements: MAX_TOOL_INPUT_ELEMENTS,\n    cacheHints: {\n      'tools/list': { ttlMs: 3_600_000, cacheScope },\n      'prompts/list': { ttlMs: 3_600_000, cacheScope },\n      // Always private, never `cacheScope`: this list enumerates the\n      // ResourceStore, so its entries are one caller's externalized tool output\n      // — the same entries whose own read hint is `private` (resources.ts). The\n      // other four lists are the same for every caller and follow the key, and\n      // they are built from frozen module-level arrays that cannot change at\n      // runtime, so an hour is honest: a shorter hint only buys the client a\n      // re-fetch of bytes that cannot have differed, at the cost of the prompt\n      // cache stability the spec asks deterministic ordering to preserve.\n      'resources/list': { ttlMs: 30_000, cacheScope: 'private' },\n      'resources/templates/list': { ttlMs: 3_600_000, cacheScope },\n      'server/discover': { ttlMs: 3_600_000, cacheScope },\n    },\n    // Multi-round-trip `requestState` integrity (protocol revision 2026-07-28):\n    // the codec verifies the HMAC on every retried round before the handler\n    // runs, so a tampered or expired state is rejected as `-32602` rather than\n    // trusted. The decoded `PendingState` reaches handlers via\n    // `ctx.mcpReq.requestState<T>()`.\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    requestState: { verify: requestStateCodec.verify },\n    // The ResourceStore fires list-changed on every externalization and on\n    // every expiry prune (store.ts), so parallel tools/call on one\n    // connection can send the same notification several times in one tick;\n    // each copy makes the client refetch an unchanged list. The SDK\n    // coalesces same-tick duplicates for methods listed here.\n    // ponytail: same-tick coalescing only — cross-tick bursts (batch\n    // externalizations separated by fs awaits) still fan out; a store-level\n    // debounce is the fix if clients ever report that. The modern HTTP leg\n    // publishes through the ServerEventBus, which this option does not\n    // touch, so it protects the stdio/in-memory leg.\n    debouncedNotificationMethods: ['notifications/resources/list_changed'],\n  };\n\n  serverConfig.instructions =\n    `${INSTRUCTIONS_SUMMARY} ` +\n    `For full guidance, read ${INSTRUCTIONS_URI} or run the get-help prompt.`;\n\n  const implementation: Implementation = {\n    name: 'filesystem-mcp',\n    title: 'Filesystem MCP',\n    version: SERVER_VERSION,\n    ...(SERVER_DESCRIPTION ? { description: SERVER_DESCRIPTION } : {}),\n    ...(SERVER_HOMEPAGE ? { websiteUrl: SERVER_HOMEPAGE } : {}),\n  };\n  const server = new McpServer(implementation, serverConfig);\n  server.server.fallbackNotificationHandler = (notification) => {\n    Logger.debug('Unhandled client notification', { method: notification.method });\n    return Promise.resolve();\n  };\n\n  const resourceStore =\n    extraDeps?.resourceStore ??\n    new ResourceStore(\n      () => {\n        if (extraDeps?.notifier) {\n          extraDeps.notifier.resourcesChanged();\n          return;\n        }\n        voidSend(server.server.sendResourceListChanged(), 'resource list_changed');\n      },\n      // A tool hands out no link that this connection's resources/read refuses.\n      extraDeps?.transport === 'stdio' ? { maxReadResultBytes: MAX_OUTBOUND_RESULT_BYTES } : {},\n    );\n  const pageStore = extraDeps?.pageStore ?? new PageSnapshotStore();\n\n  const pathGuard = extraDeps?.pathGuard ?? new PathGuard(options);\n  // Recompute once per guard, keyed on the guard's own state rather than on\n  // whether it was injected — an injected-but-uninitialized guard would\n  // otherwise deny every path. Not unconditional: the HTTP leg shares one guard\n  // across a fresh instance per request, and a repeat recompute would both redo\n  // the root resolution per request and race a concurrent `applyGrant`, which\n  // commits under a mutation lock this call does not take.\n  if (!pathGuard.isInitialized()) await pathGuard.recomputeAllowedDirectories();\n\n  const deps = {\n    server,\n    pathGuard,\n    pageStore,\n    resourceStore,\n    cacheScope,\n    readOnly: options.readOnly ?? false,\n    ...(extraDeps?.watcherRegistry ? { watcherRegistry: extraDeps.watcherRegistry } : {}),\n    ...(extraDeps?.notifier ? { notifier: extraDeps.notifier } : {}),\n    ...(extraDeps?.era ? { era: extraDeps.era } : {}),\n    ...(extraDeps?.transport ? { transport: extraDeps.transport } : {}),\n  };\n\n  const resourceDisposable = registerResources(deps);\n  registerPrompts(deps);\n  registerTools(deps);\n\n  // False when the store is shared across instances and outlives this one.\n  const ownsPages = extraDeps?.pageStore === undefined;\n  let cleanedUp = false;\n  const context: FilesystemServerContext = {\n    mcp: server,\n    pathGuard,\n    disposeRuntimeState() {\n      if (cleanedUp) return;\n      cleanedUp = true;\n      if (ownsPages) pageStore.clear();\n      resourceDisposable.dispose();\n    },\n  };\n  const previousOnClose = server.server.onclose;\n  server.server.onclose = () => {\n    previousOnClose?.();\n    context.disposeRuntimeState();\n  };\n  return context;\n}\n"]}

package/dist/tools/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/tools/create.ts"],"names":[],"mappings":"AA+GA,eAAO,MAAM,MAAM,mCAkIjB,CAAC"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/tools/create.ts"],"names":[],"mappings":"AA0GA,eAAO,MAAM,MAAM,mCA6HjB,CAAC"}

package/dist/tools/create.js

@@ -3,9 +3,9 @@ import * as z from 'zod/v4';
 import { processInParallel } from "../core/concurrency.js";
 import { ErrorCode, formatUnknownErrorMessage, FsError, rethrowIfAborted, } from "../core/errors.js";
 import { buildWrittenFileMeta, writtenFileLinks } from "../core/file-uri.js";
-import { countFileLines, destExists } from "../core/fs.js";
-import { confirmKey, describeRefusal, pendingRoundTrip, readAcceptedChoice, } from "../core/input-required.js";
-import { detectMimeFromContent, MIME_SAMPLE_SIZE } from "../core/mime.js";
+import { destExists } from "../core/fs.js";
+import { confirmKey, pendingRoundTrip, readPendingVerdict } from "../core/input-required.js";
+import { detectMimeFromContent } from "../core/mime.js";
 import { isSamePath } from "../core/path-utils.js";
 import { RequiredPath } from "../core/schema.js";
 import { getMaxTextFileSize, PARALLEL_CONCURRENCY } from "../core/util.js";
@@ -119,12 +119,11 @@ export const CREATE = defineTool({
         const batch = await runOverPaths(args.files, ctx, ErrorCode.UNKNOWN, async ({ path, content, append, overwrite }) => {
             const pendingPath = pendingByPath.get(path);
             if (pendingPath !== undefined) {
-                const key = confirmKey(pendingSorted.indexOf(pendingPath));
-                const choice = readAcceptedChoice(ctx.inputResponses, key);
-                if (choice === 'skip')
+                const verdict = readPendingVerdict(ctx, pendingSorted, pendingPath, 'overwrite');
+                if (verdict === 'skipped')
                     return { skipped: path };
-                if (choice !== 'overwrite') {
-                    throw new FsError(ErrorCode.CANCELLED, `create cancelled: overwrite of "${path}" was ${describeRefusal(ctx, key)}`, path);
+                if (verdict !== 'accepted') {
+                    throw new FsError(ErrorCode.CANCELLED, `create cancelled: overwrite of "${path}" was ${verdict.refused}`, path);
                 }
             }
             // Lock per resolved file so two entries naming one file (e.g. through a
@@ -166,10 +165,7 @@ export const CREATE = defineTool({
         // paths and dropped every per-file size, line count and error the caller
         // asked `create` for. Supplying no text makes this a data tool, so
         // `define.ts` renders the JSON and keeps it in `structuredContent`.
-        if (links.length > 0) {
-            return { structured, resources: links, isError: isTotalFailure(batch.summary) };
-        }
-        return { structured, isError: isTotalFailure(batch.summary) };
+        return { structured, resources: links, isError: isTotalFailure(batch.summary) };
     },
     progress: (args) => ({
         label: 'Create',
@@ -212,11 +208,11 @@ async function createOne(path, content, append, ctx) {
             stats = (await ctx.fs.stat(appended.validPath)).stats;
             // Sniff the resulting file's leading bytes, not the appended
             // chunk: text appended to a binary file is still a binary file.
-            const sample = await ctx.fs.readLeadingSample(appended.validPath, MIME_SAMPLE_SIZE);
+            const sample = await ctx.fs.readLeadingSample(appended.validPath);
             const mimeInfo = detectMimeFromContent(appended.validPath, sample);
             mimeType = mimeInfo.mimeType;
             kind = mimeInfo.kind;
-            lineCount = await countFileLines(appended.validPath);
+            lineCount = await ctx.fs.countFileLines(appended.validPath);
         }
         catch (error) {
             ctx.log('warning', `create append: result metadata degraded for ${appended.validPath}: ${formatUnknownErrorMessage(error)}`, 'create');
@@ -252,16 +248,8 @@ async function createOne(path, content, append, ctx) {
             lastModified: modified,
         });
     }
-    const file = {
-        path: validPath,
-        size: meta.size,
-        lineCount: meta.lineCount,
-        mimeType: meta.mimeType,
-        kind: meta.kind,
-        resourceUri: meta.resourceUri,
-        created,
-        modified,
-    };
-    return meta.resourceLink ? { file, resourceLink: meta.resourceLink } : { file };
+    const { resourceLink, ...fileMeta } = meta;
+    const file = { path: validPath, ...fileMeta, created, modified };
+    return resourceLink ? { file, resourceLink } : { file };
 }
 //# sourceMappingURL=create.js.map