@apicircle/mcp-server 1.0.6 → 1.0.8

package/dist/index.d.cts

@@ -173,16 +173,29 @@ declare class FileBackedWorkspaceProvider implements WorkspaceProvider {
 
 declare class MultiWorkspaceProvider implements Workspaces {
     private readonly registryRoot;
-    private active;
+    /** Last-known active workspace id. Refreshed every time the lazy
+     *  provider resolves; reflects what the most recent operation saw on
+     *  disk, not a stale boot-time snapshot. */
     private activeWorkspaceId;
+    /** The lazy provider tool handlers consume as `ctx.workspace`. Holds a
+     *  reference back to this instance so each call updates
+     *  `activeWorkspaceId` for `activeId()` callers + diagnostic logs. */
+    private readonly lazyProvider;
     constructor(registryRoot: string);
     /**
-     * Hydrate the active provider from disk. Must be called once before the
-     * MCP host boots so `ctx.workspace.read()` doesn't race the first
-     * registry-load. Returns the registry the boot can log.
+     * Read the registry from disk so the host can log a boot banner. Does
+     * NOT cache a per-id provider — each `activeProvider()` call re-reads
+     * the registry, so a workspace switch in the desktop is picked up by
+     * the next tool call without restarting the MCP server.
      */
     init(): Promise<WorkspaceRegistry>;
-    /** The provider tool handlers see as `ctx.workspace`. */
+    /**
+     * The provider tool handlers see as `ctx.workspace`. Returns a lazy
+     * provider whose `read` / `apply` / `write` calls re-read
+     * `registry.json` so the right active workspace is always targeted
+     * even if the desktop switched workspaces since this MCP process
+     * started.
+     */
     activeProvider(): WorkspaceProvider;
     list(): Promise<WorkspaceSummary[]>;
     for(workspaceId: string): WorkspaceProvider;
@@ -190,7 +203,8 @@ declare class MultiWorkspaceProvider implements Workspaces {
     setActive(workspaceId: string): Promise<void>;
     /**
      * Idempotent registry write — used by tests / tools that need to
-     * persist registry updates that didn't go through `setActive`.
+     * persist registry updates that didn't go through `setActive`. The
+     * lazy active provider picks the new id up on its next operation.
      */
     writeRegistry(registry: WorkspaceRegistry): Promise<void>;
 }

package/dist/index.d.ts

@@ -173,16 +173,29 @@ declare class FileBackedWorkspaceProvider implements WorkspaceProvider {
 
 declare class MultiWorkspaceProvider implements Workspaces {
     private readonly registryRoot;
-    private active;
+    /** Last-known active workspace id. Refreshed every time the lazy
+     *  provider resolves; reflects what the most recent operation saw on
+     *  disk, not a stale boot-time snapshot. */
     private activeWorkspaceId;
+    /** The lazy provider tool handlers consume as `ctx.workspace`. Holds a
+     *  reference back to this instance so each call updates
+     *  `activeWorkspaceId` for `activeId()` callers + diagnostic logs. */
+    private readonly lazyProvider;
     constructor(registryRoot: string);
     /**
-     * Hydrate the active provider from disk. Must be called once before the
-     * MCP host boots so `ctx.workspace.read()` doesn't race the first
-     * registry-load. Returns the registry the boot can log.
+     * Read the registry from disk so the host can log a boot banner. Does
+     * NOT cache a per-id provider — each `activeProvider()` call re-reads
+     * the registry, so a workspace switch in the desktop is picked up by
+     * the next tool call without restarting the MCP server.
      */
     init(): Promise<WorkspaceRegistry>;
-    /** The provider tool handlers see as `ctx.workspace`. */
+    /**
+     * The provider tool handlers see as `ctx.workspace`. Returns a lazy
+     * provider whose `read` / `apply` / `write` calls re-read
+     * `registry.json` so the right active workspace is always targeted
+     * even if the desktop switched workspaces since this MCP process
+     * started.
+     */
     activeProvider(): WorkspaceProvider;
     list(): Promise<WorkspaceSummary[]>;
     for(workspaceId: string): WorkspaceProvider;
@@ -190,7 +203,8 @@ declare class MultiWorkspaceProvider implements Workspaces {
     setActive(workspaceId: string): Promise<void>;
     /**
      * Idempotent registry write — used by tests / tools that need to
-     * persist registry updates that didn't go through `setActive`.
+     * persist registry updates that didn't go through `setActive`. The
+     * lazy active provider picks the new id up on its next operation.
      */
     writeRegistry(registry: WorkspaceRegistry): Promise<void>;
 }