@apicircle/mcp-server 1.0.7 → 1.0.9

package/dist/index.js

@@ -6,7 +6,7 @@ import { z } from "zod";
 // package.json
 var package_default = {
   name: "@apicircle/mcp-server",
-  version: "1.0.7",
+  version: "1.0.9",
   private: false,
   type: "module",
   description: "Model Context Protocol server exposing API Circle Studio's workspace as a tool catalog. Used by Claude Desktop, ChatGPT, Cursor, GitHub Copilot, and any other MCP-compatible AI client.",
@@ -2118,15 +2118,143 @@ var promptSetEndpointMultipliersTool = {
   }
 };
 
-// src/tools/mocks.ts
+// src/tools/globalAssets.ts
 import { z as z10 } from "zod";
-import { generateId as generateId4, makeDefaultMockResponse as makeDefaultMockResponse2, makeDefaultRequestSchema as makeDefaultRequestSchema2 } from "@apicircle/shared";
+import { generateId as generateId4 } from "@apicircle/shared";
+function deriveState(asset, hasPendingUpload) {
+  const w = asset.workingBranchRef ?? null;
+  const b = asset.baseBranchRef ?? null;
+  if (w && b) {
+    if (w.blobSha && b.blobSha && w.blobSha !== b.blobSha) return "diverged";
+    return "merged";
+  }
+  if (w && !b) return "workingOnly";
+  if (!w && b) return "baseOnly";
+  if (hasPendingUpload) return "uploading";
+  return "missing";
+}
+var globalAssetsFilesListTool = {
+  name: "assets.list_files",
+  description: "List every Global File Asset with its provenance state and reference count. Each entry includes id, name, filename, size, mimeType, sha256, state (uploading | workingOnly | merged | baseOnly | missing | diverged), workingBranchRef, baseBranchRef, and usage { requests, mockEndpoints, total }.",
+  inputSchema: z10.object({}).strict(),
+  async handler(_input, ctx) {
+    const state = await ctx.workspace.read();
+    const files = state.synced.globalAssets.files ?? {};
+    const pending = state.local.pendingFileUploads ?? {};
+    const usage = state.local.assetUsageIndex ?? {};
+    const items = Object.values(files).map((asset) => {
+      const hasPending = Boolean(pending[asset.id]);
+      const u = usage[asset.id] ?? { requests: [], mockEndpoints: [], total: 0 };
+      return {
+        id: asset.id,
+        name: asset.name,
+        description: asset.description ?? null,
+        filename: asset.filename,
+        size: asset.size,
+        mimeType: asset.mimeType,
+        sha256: asset.sha256 ?? null,
+        state: deriveState(asset, hasPending),
+        workingBranchRef: asset.workingBranchRef ?? null,
+        baseBranchRef: asset.baseBranchRef ?? null,
+        usage: { ...u }
+      };
+    });
+    return { count: items.length, files: items };
+  }
+};
+var globalAssetsFilesCreateTool = {
+  name: "assets.create_file",
+  description: 'Register a Global File Asset entry. Bytes are NOT carried \u2014 MCP returns the new asset id and the asset enters the "missing" state. The user fills the bytes from the Global Assets panel (a "Fill bytes" button surfaces on missing-state assets) which preserves the slot id and queues the bytes for the next push. Use this when an AI client wants to claim an asset slot for a file the user will provide later.',
+  inputSchema: z10.object({
+    name: z10.string().min(1, "name is required"),
+    description: z10.string().optional(),
+    filename: z10.string().min(1, "filename is required"),
+    size: z10.number().int().nonnegative(),
+    mimeType: z10.string().default("application/octet-stream"),
+    sha256: z10.string().optional()
+  }).strict(),
+  async handler(input, ctx) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const file = {
+      id: generateId4(),
+      name: input.name,
+      description: input.description,
+      slotId: generateId4(),
+      filename: input.filename,
+      size: input.size,
+      mimeType: input.mimeType,
+      sha256: input.sha256,
+      createdAt: now,
+      updatedAt: now
+    };
+    const out = await ctx.workspace.apply({ kind: "globalAsset.upsertFile", file });
+    return { id: file.id, slotId: file.slotId, changedIds: out.changedIds };
+  }
+};
+var globalAssetsFilesUpdateTool = {
+  name: "assets.update_file",
+  description: "Rename or re-describe a Global File Asset. Provenance refs (workingBranchRef, baseBranchRef) and binary metadata (slotId, sha256, size, mimeType) are preserved verbatim.",
+  inputSchema: z10.object({
+    id: z10.string().min(1),
+    patch: z10.object({
+      name: z10.string().optional(),
+      description: z10.string().nullable().optional()
+    }).strict()
+  }).strict(),
+  async handler(input, ctx) {
+    const state = await ctx.workspace.read();
+    const existing = state.synced.globalAssets.files?.[input.id];
+    if (!existing) {
+      return { found: false, changedIds: [] };
+    }
+    const next = {
+      ...existing,
+      name: input.patch.name ?? existing.name,
+      description: input.patch.description === null ? void 0 : input.patch.description ?? existing.description
+    };
+    const out = await ctx.workspace.apply({ kind: "globalAsset.upsertFile", file: next });
+    return { found: true, id: next.id, changedIds: out.changedIds };
+  }
+};
+var globalAssetsFilesDeleteTool = {
+  name: "assets.delete_file",
+  description: "Delete a Global File Asset. Cascades \u2014 every request body and mock-response body that referenced the asset is unbound in the same mutation. The result envelope includes the consumer list that was cleared so the caller can report what changed.",
+  inputSchema: z10.object({ id: z10.string().min(1) }).strict(),
+  async handler(input, ctx) {
+    const before = await ctx.workspace.read();
+    const usage = before.local.assetUsageIndex?.[input.id] ?? {
+      requests: [],
+      mockEndpoints: [],
+      total: 0
+    };
+    const existing = before.synced.globalAssets.files?.[input.id];
+    if (!existing) {
+      return { found: false, changedIds: [] };
+    }
+    const out = await ctx.workspace.apply({ kind: "globalAsset.removeFile", id: input.id });
+    return {
+      found: true,
+      id: input.id,
+      filename: existing.filename,
+      unbound: {
+        requests: usage.requests,
+        mockEndpoints: usage.mockEndpoints,
+        total: usage.total
+      },
+      changedIds: out.changedIds
+    };
+  }
+};
+
+// src/tools/mocks.ts
+import { z as z11 } from "zod";
+import { generateId as generateId5, makeDefaultMockResponse as makeDefaultMockResponse2, makeDefaultRequestSchema as makeDefaultRequestSchema2 } from "@apicircle/shared";
 import { parseSourceToEndpoints } from "@apicircle/mock-server-core";
 async function ingestSource(source, name) {
   const { endpoints, warnings } = await parseSourceToEndpoints(source);
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const mock = {
-    id: generateId4(),
+    id: generateId5(),
     name,
     source,
     endpoints,
@@ -2142,10 +2270,10 @@ async function ingestSource(source, name) {
 var mockCreateFromOpenApiTool = {
   name: "mock.create_from_openapi",
   description: "Create a mock server from an OpenAPI / Swagger spec (YAML or JSON).",
-  inputSchema: z10.object({
-    name: z10.string(),
-    spec: z10.string().min(1),
-    format: z10.enum(["json", "yaml"]).default("json")
+  inputSchema: z11.object({
+    name: z11.string(),
+    spec: z11.string().min(1),
+    format: z11.enum(["json", "yaml"]).default("json")
   }),
   async handler(input, ctx) {
     const { mock, warnings } = await ingestSource(
@@ -2164,7 +2292,7 @@ var mockCreateFromOpenApiTool = {
 var mockCreateFromPostmanTool = {
   name: "mock.create_from_postman",
   description: "Create a mock server from a Postman v2/v2.1 collection.",
-  inputSchema: z10.object({ name: z10.string(), collection: z10.string().min(1) }),
+  inputSchema: z11.object({ name: z11.string(), collection: z11.string().min(1) }),
   async handler(input, ctx) {
     const { mock, warnings } = await ingestSource(
       { kind: "postman", collection: input.collection },
@@ -2182,7 +2310,7 @@ var mockCreateFromPostmanTool = {
 var mockCreateFromInsomniaTool = {
   name: "mock.create_from_insomnia",
   description: "Create a mock server from an Insomnia v4 export.",
-  inputSchema: z10.object({ name: z10.string(), export: z10.string().min(1) }),
+  inputSchema: z11.object({ name: z11.string(), export: z11.string().min(1) }),
   async handler(input, ctx) {
     const { mock, warnings } = await ingestSource(
       { kind: "insomnia", export: input.export },
@@ -2200,7 +2328,7 @@ var mockCreateFromInsomniaTool = {
 var mockImportPostmanMockCollectionTool = {
   name: "mock.import_postman_mock_collection",
   description: "Import a Postman Mock Collection (collections previously hosted on Postman's mock service). Same parser as a regular Postman collection but marked as a mock import.",
-  inputSchema: z10.object({ name: z10.string(), collection: z10.string().min(1) }),
+  inputSchema: z11.object({ name: z11.string(), collection: z11.string().min(1) }),
   async handler(input, ctx) {
     const { mock, warnings } = await ingestSource(
       { kind: "postman", collection: input.collection },
@@ -2218,7 +2346,7 @@ var mockImportPostmanMockCollectionTool = {
 var mockListTool = {
   name: "mock.list",
   description: "List all mock servers in the workspace plus their runtime status (running / stopped, port).",
-  inputSchema: z10.object({}),
+  inputSchema: z11.object({}),
   async handler(_input, ctx) {
     const state = await ctx.workspace.read();
     const running = await ctx.mock.list();
@@ -2240,9 +2368,9 @@ var mockListTool = {
 var mockStartTool = {
   name: "mock.start",
   description: "Start a mock server by id. Returns the bound port. Errors if the mock is already running or the requested port is in use.",
-  inputSchema: z10.object({
-    id: z10.string(),
-    port: z10.number().int().positive().optional()
+  inputSchema: z11.object({
+    id: z11.string(),
+    port: z11.number().int().positive().optional()
   }),
   async handler(input, ctx) {
     const state = await ctx.workspace.read();
@@ -2259,7 +2387,7 @@ var mockStartTool = {
 var mockStopTool = {
   name: "mock.stop",
   description: "Stop a running mock server by id (no-op if not running).",
-  inputSchema: z10.object({ id: z10.string() }),
+  inputSchema: z11.object({ id: z11.string() }),
   async handler(input, ctx) {
     try {
       await ctx.mock.stop(input.id);
@@ -2272,7 +2400,7 @@ var mockStopTool = {
 var mockDeleteTool = {
   name: "mock.delete",
   description: "Delete a mock server definition. Stops it first if it's running.",
-  inputSchema: z10.object({ id: z10.string() }),
+  inputSchema: z11.object({ id: z11.string() }),
   async handler(input, ctx) {
     try {
       await ctx.mock.stop(input.id);
@@ -2282,18 +2410,18 @@ var mockDeleteTool = {
     return { ok: true, changedIds: out.changedIds };
   }
 };
-var HTTP_METHOD3 = z10.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
+var HTTP_METHOD3 = z11.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
 var mockCreateManualTool = {
   name: "mock.create_manual",
   description: "Create an empty manual-mode mock server. Use `mock.add_endpoint` afterward to populate it. CORS defaults to off (same-origin only); enable + list explicit origins via `mock.update_cors` if cross-origin access is needed.",
-  inputSchema: z10.object({
-    name: z10.string().min(1),
-    defaultPort: z10.number().int().positive().nullable().optional()
+  inputSchema: z11.object({
+    name: z11.string().min(1),
+    defaultPort: z11.number().int().positive().nullable().optional()
   }),
   async handler(input, ctx) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const mock = {
-      id: generateId4(),
+      id: generateId5(),
       name: input.name,
       source: { kind: "manual", endpoints: [] },
       endpoints: [],
@@ -2311,7 +2439,7 @@ var mockCreateManualTool = {
 var mockListEndpointsTool = {
   name: "mock.list_endpoints",
   description: "List endpoints for a mock server (id, method, path, name).",
-  inputSchema: z10.object({ mockId: z10.string() }),
+  inputSchema: z11.object({ mockId: z11.string() }),
   async handler(input, ctx) {
     const state = await ctx.workspace.read();
     const mock = state.synced.mockServers[input.mockId];
@@ -2330,10 +2458,10 @@ var mockListEndpointsTool = {
     };
   }
 };
-var ENDPOINT_RESPONSE2 = z10.object({
-  status: z10.number().int().min(100).max(599).default(200),
-  jsonBody: z10.string().default("{}"),
-  contentType: z10.string().default("application/json")
+var ENDPOINT_RESPONSE2 = z11.object({
+  status: z11.number().int().min(100).max(599).default(200),
+  jsonBody: z11.string().default("{}"),
+  contentType: z11.string().default("application/json")
 });
 function buildDefaultEndpoint(args) {
   const response = args.response ?? {
@@ -2343,7 +2471,7 @@ function buildDefaultEndpoint(args) {
   };
   const headers = [{ key: "Content-Type", value: response.contentType, enabled: true }];
   return {
-    id: generateId4(),
+    id: generateId5(),
     name: args.name ?? `${args.method} ${args.pathPattern}`,
     method: args.method,
     pathPattern: args.pathPattern,
@@ -2362,12 +2490,12 @@ function buildDefaultEndpoint(args) {
 var mockAddEndpointTool = {
   name: "mock.add_endpoint",
   description: "Append a new endpoint to a mock server. Defaults to a 200 JSON response of `{}`. Returns the new endpoint id.",
-  inputSchema: z10.object({
-    mockId: z10.string(),
+  inputSchema: z11.object({
+    mockId: z11.string(),
     method: HTTP_METHOD3,
-    pathPattern: z10.string().min(1),
-    name: z10.string().optional(),
-    description: z10.string().optional(),
+    pathPattern: z11.string().min(1),
+    name: z11.string().optional(),
+    description: z11.string().optional(),
     response: ENDPOINT_RESPONSE2.optional()
   }),
   async handler(input, ctx) {
@@ -2390,13 +2518,13 @@ var mockAddEndpointTool = {
 var mockUpdateEndpointTool = {
   name: "mock.update_endpoint",
   description: "Patch fields on a single mock endpoint (method, pathPattern, name, description, defaultResponse status / contentType / json body). Pass only the fields you want to change.",
-  inputSchema: z10.object({
-    mockId: z10.string(),
-    endpointId: z10.string(),
+  inputSchema: z11.object({
+    mockId: z11.string(),
+    endpointId: z11.string(),
     method: HTTP_METHOD3.optional(),
-    pathPattern: z10.string().optional(),
-    name: z10.string().optional(),
-    description: z10.string().optional(),
+    pathPattern: z11.string().optional(),
+    name: z11.string().optional(),
+    description: z11.string().optional(),
     response: ENDPOINT_RESPONSE2.partial().optional()
   }),
   async handler(input, ctx) {
@@ -2437,7 +2565,7 @@ var mockUpdateEndpointTool = {
 var mockDeleteEndpointTool = {
   name: "mock.delete_endpoint",
   description: "Remove an endpoint from a mock server.",
-  inputSchema: z10.object({ mockId: z10.string(), endpointId: z10.string() }),
+  inputSchema: z11.object({ mockId: z11.string(), endpointId: z11.string() }),
   async handler(input, ctx) {
     const state = await ctx.workspace.read();
     const mock = state.synced.mockServers[input.mockId];
@@ -2457,9 +2585,9 @@ var mockDeleteEndpointTool = {
     return { ok: true, changedIds: out.changedIds };
   }
 };
-var VALIDATION_RULE = z10.object({
-  id: z10.string().optional(),
-  kind: z10.enum([
+var VALIDATION_RULE = z11.object({
+  id: z11.string().optional(),
+  kind: z11.enum([
     "header-required",
     "header-equals",
     "header-matches",
@@ -2470,43 +2598,43 @@ var VALIDATION_RULE = z10.object({
     "body-required",
     "content-type-equals"
   ]),
-  target: z10.string().default(""),
-  expected: z10.string().optional(),
-  message: z10.string().optional(),
-  enabled: z10.boolean().default(true),
-  failResponse: z10.object({
-    status: z10.number().int().min(100).max(599).default(400),
-    jsonBody: z10.string().default('{"error":"validation failed"}')
+  target: z11.string().default(""),
+  expected: z11.string().optional(),
+  message: z11.string().optional(),
+  enabled: z11.boolean().default(true),
+  failResponse: z11.object({
+    status: z11.number().int().min(100).max(599).default(400),
+    jsonBody: z11.string().default('{"error":"validation failed"}')
   }).default({})
 });
-var CONDITION_CLAUSE = z10.object({
-  id: z10.string().optional(),
-  scope: z10.enum(["query", "pathParam", "header", "cookie", "body-json-path"]),
-  target: z10.string(),
-  op: z10.enum(["equals", "not-equals", "matches", "gt", "lt", "gte", "lte", "present", "absent"]),
-  value: z10.string().optional()
+var CONDITION_CLAUSE = z11.object({
+  id: z11.string().optional(),
+  scope: z11.enum(["query", "pathParam", "header", "cookie", "body-json-path"]),
+  target: z11.string(),
+  op: z11.enum(["equals", "not-equals", "matches", "gt", "lt", "gte", "lte", "present", "absent"]),
+  value: z11.string().optional()
 });
-var RESPONSE_RULE = z10.object({
-  id: z10.string().optional(),
-  name: z10.string(),
-  enabled: z10.boolean().default(true),
-  when: z10.array(CONDITION_CLAUSE).default([]),
-  response: z10.object({
-    status: z10.number().int().min(100).max(599).default(200),
-    jsonBody: z10.string().default("{}")
+var RESPONSE_RULE = z11.object({
+  id: z11.string().optional(),
+  name: z11.string(),
+  enabled: z11.boolean().default(true),
+  when: z11.array(CONDITION_CLAUSE).default([]),
+  response: z11.object({
+    status: z11.number().int().min(100).max(599).default(200),
+    jsonBody: z11.string().default("{}")
   }).default({})
 });
-var MULTIPLIER = z10.object({
-  id: z10.string().optional(),
-  name: z10.string().optional(),
-  source: z10.object({
-    kind: z10.enum(["query", "pathParam", "header", "body-json-path"]),
-    key: z10.string()
+var MULTIPLIER = z11.object({
+  id: z11.string().optional(),
+  name: z11.string().optional(),
+  source: z11.object({
+    kind: z11.enum(["query", "pathParam", "header", "body-json-path"]),
+    key: z11.string()
   }),
-  targetJsonPath: z10.string(),
-  defaultCount: z10.number().int().nonnegative().default(0),
-  min: z10.number().int().nonnegative().optional(),
-  max: z10.number().int().nonnegative().optional()
+  targetJsonPath: z11.string(),
+  defaultCount: z11.number().int().nonnegative().default(0),
+  min: z11.number().int().nonnegative().optional(),
+  max: z11.number().int().nonnegative().optional()
 });
 function defaultJsonResponseConfig(args) {
   return {
@@ -2531,10 +2659,10 @@ function patchEndpoint2(mock, endpointId, patcher) {
 var mockSetValidationRulesTool = {
   name: "mock.set_validation_rules",
   description: "Replace an endpoint's validation rules. Rules without an `id` get a fresh one; existing rules can keep theirs to preserve client-side selection state. Empty array clears all rules.",
-  inputSchema: z10.object({
-    mockId: z10.string(),
-    endpointId: z10.string(),
-    rules: z10.array(VALIDATION_RULE)
+  inputSchema: z11.object({
+    mockId: z11.string(),
+    endpointId: z11.string(),
+    rules: z11.array(VALIDATION_RULE)
   }),
   async handler(input, ctx) {
     const state = await ctx.workspace.read();
@@ -2544,7 +2672,7 @@ var mockSetValidationRulesTool = {
     const next = patchEndpoint2(mock, input.endpointId, (e) => ({
       ...e,
       requestValidation: rules.map((r) => ({
-        id: r.id ?? generateId4(),
+        id: r.id ?? generateId5(),
         kind: r.kind,
         target: r.target,
         expected: r.expected,
@@ -2561,10 +2689,10 @@ var mockSetValidationRulesTool = {
 var mockSetResponseRulesTool = {
   name: "mock.set_response_rules",
   description: "Replace an endpoint's conditional response rules. Rules fire in order; the first whose every clause matches wins. Disabled rules are skipped. Empty array falls back to defaultResponse.",
-  inputSchema: z10.object({
-    mockId: z10.string(),
-    endpointId: z10.string(),
-    rules: z10.array(RESPONSE_RULE)
+  inputSchema: z11.object({
+    mockId: z11.string(),
+    endpointId: z11.string(),
+    rules: z11.array(RESPONSE_RULE)
   }),
   async handler(input, ctx) {
     const state = await ctx.workspace.read();
@@ -2574,11 +2702,11 @@ var mockSetResponseRulesTool = {
     const next = patchEndpoint2(mock, input.endpointId, (e) => ({
       ...e,
       responseRules: rules.map((r) => ({
-        id: r.id ?? generateId4(),
+        id: r.id ?? generateId5(),
         name: r.name,
         enabled: r.enabled,
         when: r.when.map((c) => ({
-          id: c.id ?? generateId4(),
+          id: c.id ?? generateId5(),
           scope: c.scope,
           target: c.target,
           op: c.op,
@@ -2595,10 +2723,10 @@ var mockSetResponseRulesTool = {
 var mockSetMultipliersTool = {
   name: "mock.set_multipliers",
   description: "Replace the response multipliers on an endpoint's defaultResponse. Multipliers expand an array at `targetJsonPath` to a count derived from a request value. Empty array clears all multipliers.",
-  inputSchema: z10.object({
-    mockId: z10.string(),
-    endpointId: z10.string(),
-    multipliers: z10.array(MULTIPLIER)
+  inputSchema: z11.object({
+    mockId: z11.string(),
+    endpointId: z11.string(),
+    multipliers: z11.array(MULTIPLIER)
   }),
   async handler(input, ctx) {
     const state = await ctx.workspace.read();
@@ -2610,7 +2738,7 @@ var mockSetMultipliersTool = {
       defaultResponse: {
         ...e.defaultResponse,
         multipliers: multipliers.length === 0 ? void 0 : multipliers.map((m) => ({
-          id: m.id ?? generateId4(),
+          id: m.id ?? generateId5(),
           name: m.name,
           source: { kind: m.source.kind, key: m.source.key },
           targetJsonPath: m.targetJsonPath,
@@ -2686,6 +2814,10 @@ var TOOL_REGISTRY = [
   promptSetEndpointValidationRulesTool,
   promptSetEndpointResponseRulesTool,
   promptSetEndpointMultipliersTool,
+  globalAssetsFilesListTool,
+  globalAssetsFilesCreateTool,
+  globalAssetsFilesUpdateTool,
+  globalAssetsFilesDeleteTool,
   mockCreateFromOpenApiTool,
   mockCreateFromPostmanTool,
   mockCreateFromInsomniaTool,
@@ -2832,17 +2964,58 @@ import {
   setActiveWorkspace as setActiveWorkspaceOnDisk,
   workspaceDirFor
 } from "@apicircle/core/workspace/registry";
+var LazyActiveWorkspaceProvider = class {
+  constructor(registryRoot, onActiveResolved) {
+    this.registryRoot = registryRoot;
+    this.onActiveResolved = onActiveResolved;
+  }
+  registryRoot;
+  onActiveResolved;
+  async resolveActive() {
+    const registry = await loadRegistry(this.registryRoot);
+    const activeId = registry?.activeWorkspaceId ?? null;
+    if (!activeId) {
+      throw new Error(
+        "No active workspace. Open the desktop app at least once, or run `apicircle workspaces create <name>`."
+      );
+    }
+    this.onActiveResolved(activeId);
+    return new FileBackedWorkspaceProvider(workspaceDirFor(this.registryRoot, activeId));
+  }
+  async read() {
+    const provider = await this.resolveActive();
+    return provider.read();
+  }
+  async apply(patch) {
+    const provider = await this.resolveActive();
+    return provider.apply(patch);
+  }
+  async write(next) {
+    const provider = await this.resolveActive();
+    return provider.write(next);
+  }
+};
 var MultiWorkspaceProvider = class {
   constructor(registryRoot) {
     this.registryRoot = registryRoot;
+    this.lazyProvider = new LazyActiveWorkspaceProvider(this.registryRoot, (id) => {
+      this.activeWorkspaceId = id;
+    });
   }
   registryRoot;
-  active = null;
+  /** 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. */
   activeWorkspaceId = null;
+  /** 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. */
+  lazyProvider;
   /**
-   * 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.
    */
   async init() {
     const registry = await loadRegistry(this.registryRoot) ?? {
@@ -2850,22 +3023,18 @@ var MultiWorkspaceProvider = class {
       activeWorkspaceId: null,
       workspaces: []
     };
-    if (registry.activeWorkspaceId) {
-      this.activeWorkspaceId = registry.activeWorkspaceId;
-      this.active = new FileBackedWorkspaceProvider(
-        workspaceDirFor(this.registryRoot, registry.activeWorkspaceId)
-      );
-    }
+    this.activeWorkspaceId = registry.activeWorkspaceId;
     return registry;
   }
-  /** 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() {
-    if (!this.active) {
-      throw new Error(
-        "No active workspace. Open the desktop app at least once, or run `apicircle workspaces create <name>`."
-      );
-    }
-    return this.active;
+    return this.lazyProvider;
   }
   // ─── Workspaces interface ──────────────────────────────────────────────────
   async list() {
@@ -2913,23 +3082,17 @@ var MultiWorkspaceProvider = class {
     if (!registry || !registry.workspaces.some((w) => w.id === workspaceId)) {
       throw new WorkspaceNotFoundError(workspaceId);
     }
-    const next = await setActiveWorkspaceOnDisk(this.registryRoot, workspaceId);
-    void next;
+    await setActiveWorkspaceOnDisk(this.registryRoot, workspaceId);
     this.activeWorkspaceId = workspaceId;
-    this.active = new FileBackedWorkspaceProvider(workspaceDirFor(this.registryRoot, workspaceId));
   }
   /**
    * 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.
    */
   async writeRegistry(registry) {
     await saveRegistry(this.registryRoot, registry);
     this.activeWorkspaceId = registry.activeWorkspaceId;
-    if (registry.activeWorkspaceId) {
-      this.active = new FileBackedWorkspaceProvider(
-        workspaceDirFor(this.registryRoot, registry.activeWorkspaceId)
-      );
-    }
   }
 };