callman-mcp 0.7.1 → 0.9.0

package/dist/context.js.map

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

package/dist/domain/requestShape.d.ts

@@ -527,7 +527,7 @@ export declare const requestInputSchema: z.ZodObject<{
     folderKey: z.ZodOptional<z.ZodString>;
     isEnabledInRunner: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
-    method: "GET" | "POST" | "PATCH" | "DELETE" | "PUT" | "HEAD" | "OPTIONS" | "TRACE";
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "TRACE";
     name: string;
     url: string;
     query?: {
@@ -636,7 +636,7 @@ export declare const requestInputSchema: z.ZodObject<{
     folderKey?: string | undefined;
     isEnabledInRunner?: boolean | undefined;
 }, {
-    method: "GET" | "POST" | "PATCH" | "DELETE" | "PUT" | "HEAD" | "OPTIONS" | "TRACE";
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "TRACE";
     name: string;
     url: string;
     query?: {
@@ -1112,7 +1112,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
         value: string;
         enabled?: boolean | undefined;
     }[] | undefined;
-    method?: "GET" | "POST" | "PATCH" | "DELETE" | "PUT" | "HEAD" | "OPTIONS" | "TRACE" | undefined;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "TRACE" | undefined;
     headers?: {
         key: string;
         value: string;
@@ -1221,7 +1221,7 @@ export declare const updateRequestInputSchema: z.ZodObject<{
         value?: string | undefined;
         enabled?: boolean | undefined;
     }[] | undefined;
-    method?: "GET" | "POST" | "PATCH" | "DELETE" | "PUT" | "HEAD" | "OPTIONS" | "TRACE" | undefined;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | "TRACE" | undefined;
     headers?: {
         key: string;
         value?: string | undefined;

package/dist/index.js

@@ -5,7 +5,10 @@
 //   callman-mcp doctor     check URL / token / scopes / workspaces and exit
 //   callman-mcp --version | --help
 import { readFileSync } from "node:fs";
+import { readFile, stat } from "node:fs/promises";
+import { lookup } from "node:dns/promises";
 import { createRequire } from "node:module";
+import { resolve as resolvePath } from "node:path";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallmanApiError, CallmanNetworkError, hintFor } from "./client/errors.js";
 import { resolveConfig } from "./config.js";
@@ -33,6 +36,7 @@ Environment:
   CALLMAN_RUN_TIMEOUT_MS Local run budget (default 600000)
   CALLMAN_MAX_BODY_BYTES Response body preview cap (default 16384)
   CALLMAN_LOADTEST_MAX_SECONDS / _MAX_VUS / _MAX_RATE  run_load_test ceilings (default 120 s / 200 / 500 per s)
+  CALLMAN_ALLOW_LOCAL_SOURCES  1/true lets import_mock read local files and localhost / private URLs (default off)
 `;
 const out = (line) => {
     process.stdout.write(`${line}\n`);
@@ -48,6 +52,18 @@ const resolveLoadWorkerEntry = () => {
         return null;
     }
 };
+// import_mock's readers. Relative paths are taken from the directory the AI
+// tool started this server in (its project).
+const readSourceFile = async (path, maxBytes) => {
+    const absolute = resolvePath(path);
+    const info = await stat(absolute);
+    if (!info.isFile())
+        throw new Error(`${absolute} is not a file`);
+    if (info.size > maxBytes)
+        throw new Error(`${absolute} is ${info.size} bytes, more than the ${maxBytes} bytes a mock import takes`);
+    return readFile(absolute, "utf8");
+};
+const resolveHost = async (host) => (await lookup(host, { all: true })).map((entry) => entry.address);
 const loadConfig = () => ({
     ...resolveConfig({ env: process.env, readTokenFile: (path) => readFileSync(path, "utf8") }),
     loadWorkerEntry: resolveLoadWorkerEntry(),
@@ -68,7 +84,7 @@ const serve = async () => {
         // Always shown (not subject to CALLMAN_LOG_LEVEL): the token is about to go to the cloud.
         console.error(`[callman-mcp] CALLMAN_API_URL is not set, so the Callman cloud (${config.apiUrl}) is used. On-prem? Set CALLMAN_API_URL, or your token is sent to the cloud.`);
     }
-    const { server, hideUnavailableTools } = createCallmanMcpServer({ config, version: VERSION, logger });
+    const { server, hideUnavailableTools } = createCallmanMcpServer({ config, version: VERSION, logger, readFile: readSourceFile, resolveHost });
     const transport = new StdioServerTransport();
     const shutdown = () => {
         void server.close().finally(() => process.exit(0));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,0EAA0E;AAC1E,sCAAsC;AACtC,6EAA6E;AAC7E,4EAA4E;AAC5E,mCAAmC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE/E,MAAM,IAAI,GAAG,eAAe,OAAO;;;;;;;;;;;;;;;;;;;;CAoBlC,CAAC;AAEF,MAAM,GAAG,GAAG,CAAC,IAAY,EAAQ,EAAE;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,gFAAgF;AAChF,iFAAiF;AACjF,wBAAwB;AACxB,MAAM,sBAAsB,GAAG,GAAkB,EAAE;IACjD,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,4EAA4E;AAC5E,6CAA6C;AAC7C,MAAM,cAAc,GAAG,KAAK,EAAE,IAAY,EAAE,QAAgB,EAAmB,EAAE;IAC/E,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,gBAAgB,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,IAAI,GAAG,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,OAAO,IAAI,CAAC,IAAI,yBAAyB,QAAQ,4BAA4B,CAAC,CAAC;IACpI,OAAO,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,KAAK,EAAE,IAAY,EAAqB,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAEjI,MAAM,UAAU,GAAG,GAAqB,EAAE,CAAC,CAAC;IAC1C,GAAG,aAAa,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3F,eAAe,EAAE,sBAAsB,EAAE;CAC1C,CAAC,CAAC;AAEH,qEAAqE;AACrE,sEAAsE;AACtE,MAAM,aAAa,GAAG,GAAS,EAAE;IAC/B,KAAK,MAAM,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAU,EAAE,CAAC;QACxF,iFAAiF;QACjF,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACnE,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;IACtC,aAAa,EAAE,CAAC;IAChB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC3C,0FAA0F;QAC1F,OAAO,CAAC,KAAK,CACX,mEAAmE,MAAM,CAAC,MAAM,8EAA8E,CAC/J,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,sBAAsB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7I,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,MAAM,4GAA4G,CAAC,CAAC;IAChJ,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,eAAe,OAAO,YAAY,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,yDAAyD,EAAE,CAAC,CAAC;AACjJ,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,KAAK,IAAqB,EAAE;IACzC,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;IAC9B,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,+DAA+D,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,GAAG,CAAC,qGAAqG,CAAC,CAAC;QAC3G,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;IAC7E,MAAM,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxG,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1F,GAAG,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,OAAO,eAAe,EAAE,CAAC,KAAK,CAAC,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC;QAC3H,GAAG,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;QAClD,GAAG,CAAC,iBAAiB,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,GAAG,CAAC,OAAO,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpI,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB;YAAE,GAAG,CAAC,qFAAqF,CAAC,CAAC;QACpJ,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAClD,GAAG,CAAC,kBAAkB,QAAQ,CAAC,GAAG,IAAI,KAAK,cAAc,QAAQ,CAAC,SAAS,IAAI,KAAK,iBAAiB,QAAQ,CAAC,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC;QACzI,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,0CAA0C,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,YAAY,GAAG,gBAAgB,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7E,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnE,GAAG,CAAC,YAAY,YAAY,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,4BAA4B,CAAC,CAAC;QAC7G,KAAK,MAAM,IAAI,IAAI,WAAW;YAAE,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,SAAS,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACtH,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzD,GAAG,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;YAChD,GAAG,CAAC,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAChD,GAAG,CAAC,OAAO,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACnE,GAAG,CAAC,IAAI,CAAC,CAAC;QACV,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACnC,GAAG,CAAC,oBAAoB,OAAO,SAAS,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,EAAE,CAAC;AAChB,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/resources/docs/mocks.d.ts

@@ -0,0 +1,2 @@
+export declare const MOCKS_DOC: string;
+//# sourceMappingURL=mocks.d.ts.map

package/dist/resources/docs/mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/mocks.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,SAAS,QAibrB,CAAC"}

package/dist/resources/docs/mocks.js

@@ -0,0 +1,445 @@
+import { MOCK_DATA_OPERATIONS, MOCK_FAKER_HINTS, MOCK_FIELD_TYPES, MOCK_ID_STRATEGIES, MOCK_RESOURCE_ENDPOINTS, MOCK_RESOURCE_TEMPLATES, MOCK_TEMPLATE_CATALOG } from "callman-core/mock-engine";
+// The vocabularies below come from callman-core, so this page always lists
+// exactly the words the engine (and the tools' schemas) take.
+const list = (values) => values.map((value) => `\`${value}\``).join(", ");
+const templateCatalog = () => {
+    const groups = new Map();
+    for (const entry of MOCK_TEMPLATE_CATALOG)
+        groups.set(entry.group, [...(groups.get(entry.group) ?? []), `\`{{${entry.token}}}\` ${entry.description.toLowerCase()}`]);
+    return [...groups].map(([group, tokens]) => `  - **${group}**: ${tokens.join(" · ")}`).join("\n");
+};
+export const MOCKS_DOC = `# Mock APIs through MCP
+
+A mock API is a fake HTTP API that answers like the real one. Use it when a user says *"I need an API that
+returns …"* — to build a front end before the backend exists, to test a client against errors, slow answers
+and sign-in, or to give a test a stable dependency. You create it with a few tool calls and hand the user a URL.
+
+With **mock engine v2** a mock can replace a real API: it has its own small database (**resources** with
+auto CRUD endpoints, filtering, paging and relations), **routes that read and write that data**, **user
+sign-in** with JWTs, **faults** on purpose and **test sessions** that keep parallel test runs apart — and it
+can be **imported** from an OpenAPI document, a Postman or a Callman collection.
+
+## Which engine the server runs
+
+\`GET /api/mocks/policy\` says it: \`engine: { version: 2, features, limits }\` means mock engine v2; no
+\`engine\` means v1 (static, template and builder routes over state only). The tools check this for you. On a
+v1 server every v2 part — \`resources\`, \`userAuth\`, \`faults\`, routes with \`data\` / \`faults\` /
+\`protected\`, the resource / record / session tools and import_mock — is refused with
+**MOCK_ENGINE_UNSUPPORTED before anything is created** (an older server would silently drop what it does not
+know). The same answer carries the mock lifetime: \`defaultTtlHours\` / \`maxTtlHours\` are set by the
+deployment (on-prem the admin's mock lifetime, 2 days unless changed); \`engine.limits\` has this
+installation's limits.
+
+## Two places a mock can live (\`target\`)
+
+| | \`target: "server"\` (default) | \`target: "desktop"\` |
+|---|---|---|
+| Where | On the Callman server | Inside the user's Callman desktop app |
+| URL | \`<server>/mock/<slug>/…\` — public, reachable by anyone with the URL (or the token) | \`http://127.0.0.1:<port>/…\` — this computer only |
+| Answers | static, **template**, **builder** presets, **variants**, request validation, delay; v2: resources, data routes, sign-in, faults, sessions | static on every desktop; everything else on a desktop app with mock engine v2 (else 409 **LOCAL_MOCK_DESKTOP_OUTDATED**) |
+| Lifetime | the deployment's mock lifetime by default, any shorter \`ttlHours\`; renew with \`update_mock { ttlHours }\` | until deleted; lives while the app is open |
+| Needs | token with \`mocks:*\` | token with \`mocks:*\` **and** the desktop app open, signed in, with Settings → AI tools → "Let AI tools manage local mock APIs on this computer" on |
+| Routes are edited with | add_mock_route / update_mock_route / delete_mock_route | \`update_mock { routes }\` — REPLACES all routes |
+| Always on? | yes (no start/stop) | start_mock / stop_mock |
+
+If the server's \`publicUrl\` does not answer from your machine (an installation that never set its public
+address announces a host nobody can reach), use \`alternativeUrl\` from the same result — it is the API
+address plus \`/mock/<slug>\`.
+
+Pick **server** unless the user wants it on their own machine, needs no network exposure, or a tool on their
+computer must call it at localhost. Desktop calls go through a relay: the app picks the request up within a
+few seconds. If it answers \`LOCAL_MOCK_DESKTOP_OFFLINE\`, tell the user to open the app and switch the setting
+on (or fall back to a server mock).
+
+## From a user's request to a mock
+
+1. List first (\`list_mocks\`) — reuse or extend a mock that already fits instead of creating a duplicate.
+2. There is a spec or a collection already? → \`import_mock\` (dryRun first).
+3. Decide per endpoint:
+   - things clients **create, list, read, change, delete** (users, orders, products) → a **resource**: one
+     entry gives all CRUD endpoints, validation, paging, filters and relations;
+   - an operation over that data that is not plain CRUD (cancel an order, find a user by email, count) → a
+     route with \`data\`;
+   - a fixed answer → a static route; values from the request or random data → a template route;
+   - sign-in, "only logged-in users", "users see only their own orders" → \`userAuth\` + \`protected\` /
+     \`ownerField\`;
+   - "sometimes fails", "is slow", "fails the first two calls" → \`faults\`;
+   - different answers for different inputs → variants.
+4. Call \`create_mock\` with all of it at once — on a v2 server it is one atomic request (all or nothing). The
+   result has the URL and a \`curl\` line per route, resource endpoint and sign-in endpoint — give them to the
+   user, and try one if you can. \`dryRun: true\` first shows what would be sent and any \`issues\`.
+5. Iterate: add_mock_route / update_mock_route, add_mock_resource / update_mock_resource; read what real
+   clients sent with \`get_mock_logs\` and what they stored with \`query_mock_records\`.
+
+## Resources — a database inside the mock (engine v2)
+
+\`\`\`
+{ name, template?, basePath?, idField?, idStrategy?, lookupField?, allowClientId?, fields?, additionalFields?,
+  timestamps?, ownerField?, protected?, endpoints?, list?, seed? }
+\`\`\`
+
+- **name**: lowercase first letter, letters / digits / \`_\` / \`-\` (users, orders, line-items); unique per mock.
+- **template**: start from a ready resource — ${list(MOCK_RESOURCE_TEMPLATES.map((template) => template.id))} — with
+  fields, id strategy and generated seed; keys you pass override it (\`{ "template": "users" }\` alone works).
+- **basePath**: default \`/<name>\`. **idField**: default \`id\`. **idStrategy**: ${list(MOCK_ID_STRATEGIES)}
+  (default uuid; \`client\` = the caller sends it). **lookupField**: what \`/:id\` looks up by (e.g. \`slug\`).
+- **fields**: \`{ name, type, required?, nullable?, unique?, uniqueCaseInsensitive?, default?, enum?, min?, max?,
+  minLength?, maxLength?, pattern?, items?, readOnly?, writeOnly?, ref?, fakerHint? }\`. Types:
+  ${list(MOCK_FIELD_TYPES)}. A \`password\` field is stored salted-hashed and never returned; \`default\` may be a
+  template (\`"{{now}}"\`, \`"{{auth.sub}}"\`); \`fakerHint\` says how seed data is generated
+  (${list(MOCK_FAKER_HINTS.slice(0, 12))} … any \`$random*\` token, or a template). No fields = schemaless: anything goes.
+- **additionalFields**: \`allow\` (default) / \`strip\` / \`reject\` (400) for fields that are not declared.
+- **timestamps**: \`{ createdAt, updatedAt }\` field names (default those; \`null\` switches one off).
+- **seed**: \`{ records?: [...], generate?: N, salt? }\` — every new copy of the data starts with the records plus N
+  generated ones. \`reset_mock_data\` goes back to it.
+- **endpoints**: per auto endpoint (${list(MOCK_RESOURCE_ENDPOINTS)}): \`false\` switches it off; an object sets
+  \`protected\`, \`faults\`, \`delay\`, \`responses\` (per outcome) or \`requestValidation\`.
+- **list**: \`envelope\` (\`array\` default; \`data-meta\` → \`{ data, meta: { total, page, limit } }\`; \`items\`; \`custom\`
+  with \`customBody\`), \`defaultLimit\` (null = all up to \`maxLimit\`), \`maxLimit\`, \`totalCountHeader\`, \`linkHeader\`,
+  \`filterMode\` (\`declared\` fields only / \`any\` query parameter), \`searchable\` (\`?q=\`), \`defaultSort\`.
+
+### Auto CRUD endpoints
+
+| Request | Answer |
+|---|---|
+| \`GET /<basePath>\` | the list (query language below), \`X-Total-Count\` and \`Link\` headers |
+| \`POST /<basePath>\` | 201 + the record (id and timestamps generated), \`Location\` header |
+| \`GET /<basePath>/:id\` | the record, or 404 |
+| \`PUT /<basePath>/:id\` | replace (id kept) · \`PATCH\` change the given fields |
+| \`DELETE /<basePath>/:id\` | 204 (relations: cascade / nullify / restrict → 409) |
+| \`GET\\|POST /<parent>/:<fk>/<child>\` | nested, for every \`ref\` field (\`/users/7/orders\`) |
+
+Writes are validated: **400** \`{ error, invalidFields: [{ field, message }] }\`, **409** \`{ error, field }\` for a
+taken unique value or id, **413** for a record over the size limit, **409** at the record limit. These
+endpoints are computed, never stored as routes: they do not count against the route limit, and an explicit
+route with the same path wins. Records can also be read and written without HTTP: \`query_mock_records\`,
+\`insert_mock_records\`, \`update_mock_records\`, \`delete_mock_records\`.
+
+### The list query language (json-server style)
+
+| Query | Meaning |
+|---|---|
+| \`status=paid\` · \`status=paid&status=new\` | equals · repeated = any of them |
+| \`total_gte=10\` \`_gt\` \`_lte\` \`_lt\` \`_ne\` | comparisons |
+| \`id_in=1,2,3\` · \`id_nin=4\` | in / not in a list |
+| \`email_exists=true\` | field present (or \`false\`: missing) |
+| \`tags_contains=red\` | an array field holds the value |
+| \`name_like=ada\` | case-insensitive substring (never a regular expression) |
+| \`address.city=Baku\` | nested fields |
+| \`q=ada\` | full-text search (\`list.searchable\`, or a schemaless resource) |
+| \`_sort=-total,name\` (or \`_sort=total&_order=desc\`) | sort, \`-\` = descending |
+| \`_page=2&_limit=10\` (or \`_per_page\`) · \`_start=20&_end=30\` | paging · slicing |
+| \`_expand=user\` · \`_embed=orders\` | inline the record a ref points to · the records pointing here |
+| \`_fields=id,name\` | only these fields |
+
+\`query_mock_records\` takes the same as arguments: \`where\` (equality), \`filters: [{ field, op, value }]\`
+(\`op\`: eq ne gt gte lt lte in nin exists contains like), \`q\`, \`sort\`, \`page\` / \`limit\` (default 20),
+\`start\` / \`end\`, \`expand\`, \`embed\`, \`fields\` — or \`query: "status=paid&_sort=-total"\` verbatim — and \`id\` for
+one record. It returns the records, the total and the query string to reuse with curl.
+
+### Relations — \`ref\`, \`_expand\`, \`_embed\`
+
+A field \`{ "name": "userId", "type": "string", "ref": { "resource": "users", "onDelete": "cascade" } }\` makes
+orders point at users: \`GET /orders?_expand=user\` inlines each order's user (the name is the field without
+\`Id\`; \`ref.as\` changes it), \`GET /users/7?_embed=orders\` lists a user's orders, and \`/users/7/orders\` answers
+GET and POST. \`onDelete\`: \`restrict\` (deleting the user answers 409 while orders exist), \`cascade\`
+(deletes them), \`nullify\` (sets the field null), \`none\` (default). \`ref.check\` (default true) refuses an
+order whose user does not exist (400).
+
+## Routes
+
+\`\`\`
+{ method, path, name?, response | (statusCode?, headers?, body?), variants?, delay?, requestValidation?,
+  data?, faults?, protected? }
+\`\`\`
+
+- **method**: GET POST PUT DELETE PATCH or ANY (any method that no specific route takes).
+- **path**: starts with \`/\`; letters, digits and \`/ _ - : * .\`; no \`..\`; at most 256 characters; \`/__callman\`
+  is reserved. \`:name\` is a path parameter (letters, digits, underscore: \`:userId\`, not \`:user-id\`). A trailing
+  \`/*\` (or a \`*\` segment) matches everything below. The most specific route wins (literal segment >
+  parameter > wildcard); a trailing slash is ignored. One route per method + path.
+- **response**: the full shape below. **Shorthand** for the common case: \`statusCode\` (default 200),
+  \`headers\`, \`body\` directly on the route = a static response. Don't mix the two.
+- **name**: a label (shown in lists; usable as a reference).
+- **delay**: \`{ mode: "none" }\`, \`{ mode: "fixed", ms }\` or \`{ mode: "random", minMs, maxMs }\` — the
+  answer is held back that long (server ≤ 60 000 ms, desktop ≤ 30 000 ms). Use it to test timeouts and spinners.
+- **data**, **faults**, **protected** (engine v2): below.
+
+### Responses
+
+\`\`\`
+{ "type": "static",   "statusCode": 200, "headers": { "X-Foo": "1" }, "body": <any JSON> }
+{ "type": "template", "statusCode": 200, "headers": {}, "body": <JSON with {{expressions}}> }
+{ "type": "builder",  "preset": "list|detail|create|update|delete|echo|custom", "config": { "preset": <same>, … } }
+\`\`\`
+
+- **body**: any JSON value. An object/array is sent as JSON (\`content-type: application/json\` unless you
+  set one); a *string* is sent as is (\`text/plain\` unless you set a content type — for XML/HTML put
+  the text in \`body\` and set \`headers\`). No body = empty response (use for 204).
+- **template** — every string in the body (and in header values) may contain \`{{expression}}\`. A string that is
+  *only* one expression keeps its type (number, boolean, object); inside longer text the value becomes text.
+  Unknown expressions become \`null\` (whole) or empty (inline). Example:
+  \`{ "id": "{{request.params.id}}", "email": "{{faker.email}}", "age": "{{random.int(18,65)}}" }\` (\`age\` becomes a number).
+  The expressions:
+${templateCatalog()}
+
+### Builder presets (state-backed, every engine)
+
+A builder route does the work of a REST endpoint over **state** (arrays of objects, stored per mock). On a v2
+server prefer a **resource** — it does all of this with validation, relations and sessions. \`config\` is typed
+per preset; \`config.preset\` must equal \`preset\`. Required keys are marked; the rest have defaults.
+
+| preset | config | what it does |
+|---|---|---|
+| \`list\` | **source**: \`{kind:"static",data:[…]}\` or \`{kind:"state",stateKey}\`; \`filtering:{enabled,rules:[{queryParam,field,operator:equals\\|contains\\|startsWith\\|in}]}\`; \`sorting:{enabled,sortByParam:"sortBy",orderParam:"order",allowedFields:[…]}\`; \`pagination:{enabled,strategy:page\\|offset\\|cursor,defaultPageSize:20,maxPageSize:100,envelope:standard\\|data-meta\\|raw}\`; \`statusCode\`, \`headers\` | filter by query params, sort, paginate. Envelopes: standard \`{items,total,page,totalPages}\`, data-meta \`{data,meta:{total,page,limit}}\`, raw array |
+| \`detail\` | **source**, **notFoundBehavior**:\`{statusCode:404,body?}\`, \`paramName:"id"\`, \`lookupField:"id"\` | the item whose \`lookupField\` equals the path parameter; otherwise the not-found answer |
+| \`create\` | **stateKey**, \`autoGenerate:{id:"uuid"\\|"incremental",createdAt,updatedAt}\`, \`requiredFields:[…]\` (missing → 400), \`responseBehavior:return-created\\|return-id\\|status-only\`, \`statusCode:201\` | appends the request body (plus generated fields) to \`state[stateKey]\` |
+| \`update\` | **stateKey**, **notFoundBehavior**, \`paramName\`, \`lookupField\`, \`mergeStrategy:partial\\|full\`, \`autoUpdateUpdatedAt:true\`, \`statusCode:200\` | replaces/merges the matching item with the request body |
+| \`delete\` | **stateKey**, **notFoundBehavior**, \`paramName\`, \`lookupField\`, \`responseBehavior:204\\|return-deleted\\|success-message\`, \`statusCode:204\` | removes the matching item |
+| \`echo\` | \`statusCode\`, \`headers\` | answers with the request: \`{method,params,query,headers,body}\` — handy to see what a client sends |
+| \`custom\` | \`statusCode\`, \`headers\`, \`body\` | a fixed answer through the builder |
+
+State is a JSON object per mock (limit 1 MB). \`get_mock_state\` shows \`state\` (live) and \`initialState\`;
+\`set_mock_state\` replaces either wholesale; \`reset_mock_state\` copies \`initialState\` back into \`state\`.
+\`{{state.key}}\` templates read it. Resource data is separate (\`reset_mock_data\`).
+
+### Variants — different answers for different requests
+
+A route can carry up to 20 variants. Each has \`priority\` (lower is checked first), a \`condition\` and a
+\`response\` (same shapes as above). The first variant whose condition matches answers; otherwise the
+route's own \`response\` (or \`data\`) does.
+
+\`\`\`json
+{ "method": "GET", "path": "/profile",
+  "response": { "type": "static", "statusCode": 200, "body": { "name": "Ada" } },
+  "variants": [
+    { "priority": 1, "condition": { "type": "any", "rules": [{ "field": "query.fail", "operator": "equals", "value": "1" }] },
+      "response": { "type": "static", "statusCode": 500, "body": { "error": "boom" } } } ] }
+\`\`\`
+
+- \`condition.type\`: \`all\` (every rule) or \`any\` (at least one); 1–20 rules.
+- \`field\`: \`headers.<name>\`, \`params.<name>\`, \`query.<name>\`, \`body.<dotted.path>\` (v2 also \`auth.sub\`,
+  \`auth.claims.<name>\`, \`session.id\`).
+- \`operator\`: exists, not-exists (null and empty count as missing), equals, not-equals, contains,
+  starts-with, matches (a regular expression in \`value\`; unsafe patterns are refused). Values are compared as text.
+
+### Request validation
+
+\`requestValidation: { "mode": "schema", "schema": { …JSON Schema draft-07… } }\` makes the route reject a body
+that does not match with **400** and the list of invalid fields. Checked on POST, PUT and PATCH. \`mode: "any"\`
+(default) accepts anything; \`update_mock_route\` with \`requestValidation: null\` removes the gate.
+
+### Data routes — \`data\` (engine v2)
+
+A route that reads or writes a resource instead of answering a fixed body:
+
+\`\`\`
+data: { operation, resource, match?: [{ field, op?, value, skipIfEmpty? }], write?: { source?, pick?, omit?, set? },
+        mode?: "merge"|"replace", many?, find?: { useRequestQuery?, sort?, limit? }, responses? }
+\`\`\`
+
+- **operation**: ${list(MOCK_DATA_OPERATIONS)}. insert creates from the body; find answers a list (with
+  \`find.useRequestQuery\` the caller's list query applies too); findOne / update / delete / upsert act on the
+  first match (\`many: true\` → every match); count answers \`{ count }\`.
+- **match**: every rule must hold; \`value\` is a template or a literal — \`"{{request.params.id}}"\`,
+  \`"{{request.query.status}}"\`, \`"{{auth.sub}}"\`; \`op\` eq (default) ne gt gte lt lte in contains like;
+  \`skipIfEmpty\` ignores a rule whose value is empty (optional filters).
+- **write**: \`source\` (default \`"{{request.body}}"\`), \`pick\` / \`omit\` fields, \`set\` fields last
+  (\`{ "status": "cancelled", "cancelledAt": "{{now}}" }\`).
+- The answer is the record(s); no match → 404. **responses** overrides per outcome (success, created, notFound,
+  conflict, validationError, unauthorized, forbidden, limitExceeded, payloadTooLarge); a **template** \`response\`
+  on the route shapes the success answer with \`{{record}}\`, \`{{records}}\`, \`{{total}}\`. A static response
+  or the shorthand is refused on a data route.
+
+\`\`\`json
+{ "method": "GET",  "path": "/users/by-email/:email", "data": { "operation": "findOne", "resource": "users", "match": [{ "field": "email", "value": "{{request.params.email}}" }] } }
+{ "method": "POST", "path": "/orders/:id/cancel",     "data": { "operation": "update", "resource": "orders", "match": [{ "field": "id", "value": "{{request.params.id}}" }], "write": { "source": "{}", "set": { "status": "cancelled" } } } }
+{ "method": "GET",  "path": "/stats/orders",          "data": { "operation": "count", "resource": "orders", "match": [{ "field": "status", "value": "{{request.query.status}}", "skipIfEmpty": true }] } }
+\`\`\`
+
+## User sign-in — \`userAuth\` (engine v2)
+
+\`\`\`
+userAuth: { usersResource?: "users", identityField?: "email", passwordField?: "password", tokenTtlSeconds?: 3600,
+            roleClaim?: "role", claims?, protect?: "none"|"resources"|"all", endpoints?, responses?, issuer?, audience? }
+\`\`\`
+
+- \`POST /auth/register\` (201) and \`POST /auth/login\` (200) take \`{ <identityField>, <passwordField> }\` (register:
+  the whole user) and answer \`{ accessToken, tokenType: "Bearer", expiresIn, user }\`; \`GET /auth/me\` answers the
+  signed-in user. Paths change with \`endpoints: { login: { path }, register: { enabled: false } }\`.
+- The users resource needs the identity field (make it \`unique\`) and a \`password\` field (type password).
+- Tokens are HS256 JWTs signed with a per-mock secret (never shown); callers send \`Authorization: Bearer <token>\`.
+  Missing / invalid → **401** with \`WWW-Authenticate: Bearer\`; a role that does not fit → **403**.
+- What needs a user: \`protect\` sets the default — \`resources\` (default: every resource endpoint), \`all\` (every
+  route too) or \`none\`. \`protected\` on a route, a resource or one endpoint overrides it: \`true\` (any signed-in
+  user), \`{ "roles": ["admin"] }\` (the \`roleClaim\` field of the user must be one of them), \`false\` (public).
+- \`ownerField\` on a resource (\`"ownerField": "userId"\`) scopes it to the signed-in user: they list, read and
+  change only their own records, and new records get their id.
+- Templates see the user: \`{{auth.sub}}\`, \`{{auth.user.<field>}}\`, \`{{auth.claims.<name>}}\`.
+- \`X-Mock-Token\` (the mock's own access gate, \`auth: "token"\`) is separate and checked first.
+- \`update_mock { userAuth }\` changes it (the secret is kept), \`update_mock { userAuth: null }\` switches it off.
+
+## Faults — fail on purpose (engine v2)
+
+\`\`\`
+faults: { errorRate?, errorStatus?: 500, errorBody?, delay?, timeoutRate?, dropRate?, failFirst? }
+\`\`\`
+
+| Key | Effect |
+|---|---|
+| \`errorRate\` | % of requests answered with \`errorStatus\` (and \`errorBody\`) |
+| \`delay\` | extra delay on every request (\`{ mode: "fixed", ms }\` / \`{ mode: "random", minMs, maxMs }\`) |
+| \`timeoutRate\` | % of requests held unanswered, then 504 — the client's timeout fires first |
+| \`dropRate\` | % of requests whose connection is closed without an answer (a proxy in front shows 502) |
+| \`failFirst\` | the first N calls (per test session) fail with \`errorStatus\`, then it recovers — retry logic |
+
+Set them for the whole mock (\`create_mock\` / \`update_mock { faults }\`, null removes), for one route (the
+route's \`faults\`) or for one resource endpoint (\`endpoints: { create: { faults: … } }\`). \`reset_mock_data\`
+restarts the \`failFirst\` counters. A mock whose faults were set as full rules (conditions, sequences) shows
+them as \`faultRules\` next to the flat form.
+
+## Test sessions — \`X-Mock-Session\` (engine v2)
+
+A caller that sends \`X-Mock-Session: <id>\` (1–64 letters, digits, \`. _ : -\`) gets **its own copy of the data**,
+seeded on first use and dropped after being idle — so parallel test runs never see each other's writes. Too many
+active sessions → 429 (\`x-mock-limit-reason: session-limit\`). A caller can read and reset its own session at
+\`GET /__callman/session\` and \`POST /__callman/session/reset\`. From here: \`list_mock_sessions\`, and \`session\`
+on query_mock_records, insert / update / delete_mock_records and reset_mock_data.
+
+## Import — \`import_mock\` (engine v2)
+
+Builds a mock from an **OpenAPI 3.x / Swagger 2.0** document (JSON or YAML), a **Postman** collection (its saved
+examples) or a **Callman** collection (\`collection\`: its requests with their newest recorded responses,
+secrets redacted). One source: \`content\` (the document text, e.g. a file you read), \`url\` or \`filePath\`.
+**This MCP server reads URLs and files itself — the Callman server never fetches anything.** Files, and URLs on
+localhost or a private network, are refused (MOCK_IMPORT_SOURCE_BLOCKED) unless the user set
+\`CALLMAN_ALLOW_LOCAL_SOURCES=1\` for this server — read the file yourself and pass \`content\` instead.
+
+- \`mode: "auto"\` (default): CRUD groups (\`GET/POST /pets\` + \`GET/PUT/DELETE /pets/{id}\`) become resources with
+  the examples as seed records; everything else becomes routes. \`mode: "routes"\`: one route per operation.
+- Extra responses become variants; a caller picks one with \`X-Mock-Response-Code: 404\` or
+  \`X-Mock-Response-Name: <example name>\`. OpenAPI request schemas become request validation
+  (\`validateRequests: false\` turns it off); \`keepServerBasePath\` keeps \`/api/v3\` in the paths.
+- \`dryRun: true\` shows the routes and resources it would create and the **report**: what was converted, what
+  needs attention (\`warning\`) and what was \`lost\` — read it to the user.
+- \`into: { mock, strategy }\` adds to an existing mock: \`merge\` (default) keeps its routes and resources and adds
+  the new ones (same method + path or resource name is skipped); \`replace\` swaps them.
+- \`target: "desktop"\` converts on the server and writes a local mock to the desktop app.
+
+## Worked example — users + orders CRUD with login
+
+\`\`\`json
+create_mock {
+  "name": "Shop API", "slug": "shop-api",
+  "resources": [
+    { "template": "users" },
+    { "name": "orders", "idStrategy": "incremental", "ownerField": "userId",
+      "fields": [
+        { "name": "userId", "type": "string", "ref": { "resource": "users", "onDelete": "cascade" } },
+        { "name": "total", "type": "number", "required": true, "min": 0, "fakerHint": "$randomPrice" },
+        { "name": "status", "type": "string", "enum": ["pending", "paid", "cancelled"], "default": "pending" }
+      ] }
+  ],
+  "userAuth": { "usersResource": "users", "protect": "resources" },
+  "routes": [
+    { "method": "POST", "path": "/orders/:id/cancel", "protected": true,
+      "data": { "operation": "update", "resource": "orders",
+                "match": [{ "field": "id", "value": "{{request.params.id}}" }, { "field": "userId", "value": "{{auth.sub}}" }],
+                "write": { "source": "{}", "set": { "status": "cancelled" } } } },
+    { "method": "GET", "path": "/health", "statusCode": 200, "body": { "ok": true }, "protected": false }
+  ]
+}
+\`\`\`
+
+What the client (or you, with the curl lines from the result) can now do against \`<server>/mock/shop-api\`:
+
+\`\`\`
+POST /auth/register   { "email": "ada@example.com", "password": "secret123", "name": "Ada" }   → 201 { accessToken, user }
+POST /auth/login      { "email": "ada@example.com", "password": "secret123" }                 → 200 { accessToken, tokenType, expiresIn, user }
+GET  /auth/me                                   Authorization: Bearer <accessToken>          → Ada (no password)
+POST /orders          { "total": 42 }           Authorization: Bearer …                      → 201 { id: 1, userId: <Ada's id>, total: 42, status: "pending", createdAt, updatedAt }
+GET  /orders?status=pending&_sort=-total&_expand=user   (Bearer)                            → Ada's orders only, each with its user; X-Total-Count
+PATCH /orders/1       { "status": "paid" }      (Bearer)                                     → the changed order
+POST /orders/1/cancel                           (Bearer)                                     → status "cancelled"
+POST /orders          { "total": -1 }           (Bearer)                                     → 400 { error, invalidFields: [{ field: "total", … }] }
+GET  /orders                                    (no token)                                   → 401
+\`\`\`
+
+Then, for the user's tests:
+
+- \`update_mock { "mock": "shop-api", "faults": { "failFirst": 2, "errorStatus": 503 } }\` — the first two calls fail,
+  the third succeeds (retry logic); \`reset_mock_data\` restarts the count.
+- Each test run sends its own \`X-Mock-Session: run-<n>\` header → isolated data; \`list_mock_sessions\` shows them.
+- \`query_mock_records { "mock": "shop-api", "resource": "orders", "filters": [{ "field": "total", "op": "gte", "value": 10 }], "expand": ["user"] }\`
+  shows what the client stored; \`insert_mock_records\` prepares data; \`reset_mock_data\` puts the seed back.
+
+## Auth of the mock itself (server)
+
+\`auth: "public"\` (default) — anyone with the URL. \`auth: "token"\` — callers must send \`X-Mock-Token: <token>\`
+(else 401). The token is generated by the server and returned **once**, in the create_mock / update_mock result;
+\`get_mock\` keeps it masked unless the token holds \`environments:reveal\` and you pass \`reveal: true\`. Never put
+it into places the user did not ask for. (User sign-in above is a different thing: it simulates the API's own login.)
+
+## Limits (server defaults; an installation may change them — \`GET /api/mocks/policy\` → \`engine.limits\`)
+
+20 mocks per workspace · 50 routes per mock · response body ≤ 100 KB · request body ≤ 1 MB · state ≤ 1 MB ·
+20 000 requests in total per mock, then 429 · 30 requests per second per mock, then 429 · the 500 newest request
+logs are kept · slugs: 3–48 chars, lowercase letters/digits/single dashes, start with a letter, a few reserved
+words (api, mock, admin …) refused · lifetime up to the deployment's mock lifetime (longer requests are capped),
+then **410 Gone** — renew before that with \`update_mock { ttlHours }\`. A flood from one address gets 429 with
+\`X-Mock-Limit-Reason: ip-rate-limit\`. Engine v2: 20 resources per mock, 100 fields per resource, 1 000 records
+per resource, 16 KB per record, 512 KB of seed records, 20 active test sessions (idle after 60 min), 2 MB per import.
+Local (desktop): ports 1024–65535 (omit \`port\` and the app picks a free one), the mock
+listens on 127.0.0.1 only; a relay command carries at most 1 MB (a route body sent to an older desktop app: 256 KB).
+
+## Desktop (local) mocks
+
+\`create_mock { target: "desktop", name, port?, autoStart?, routes?, resources?, userAuth?, faults? }\` creates a
+local mock in the user's app and starts it (\`start: false\` to skip). Static routes —
+\`{ method, path, name?, statusCode, headers, body, delay }\` or \`response: { type: "static", … }\` — work with every
+desktop app: \`body\` is text (a string is sent verbatim, anything else as formatted JSON). Templates, variants,
+request validation, resources, data routes, sign-in and faults need a server and a desktop app with mock engine
+v2 (the same engine runs on the desktop); with a v1 server they are refused (LOCAL_MOCK_FEATURE_UNSUPPORTED /
+MOCK_ENGINE_UNSUPPORTED), with an older desktop app the server answers LOCAL_MOCK_DESKTOP_OUTDATED.
+\`:param\` segments and a trailing \`/*\` work; every request is logged (\`get_mock_logs { target: "desktop" }\`, the
+latest requests only, kept until the app quits). To change routes: \`get_mock { target: "desktop" }\`, edit,
+\`update_mock { routes: [...all of them] }\`. The resource, record and session tools take \`target: "desktop"\` too.
+\`start_mock\` / \`stop_mock\` / \`delete_mock\` act on one by name or id. Mocks the AI created carry an "AI" badge in
+the app. The mock is only reachable from the user's computer — don't hand out the URL to others.
+
+## Tools
+
+| Tool | Scope | |
+|---|---|---|
+| list_mocks, get_mock, get_mock_logs | mocks:read | \`target\` server/desktop |
+| get_mock_stats, get_mock_state | mocks:read | server |
+| query_mock_records, list_mock_sessions | mocks:read | engine v2, \`target\` server/desktop |
+| create_mock, update_mock | mocks:write | \`target\` server/desktop |
+| add_mock_route, update_mock_route, reorder_mock_routes, set_mock_state, reset_mock_state | mocks:write | server |
+| add_mock_resource, update_mock_resource, insert_mock_records, update_mock_records, reset_mock_data, import_mock | mocks:write | engine v2, \`target\` server/desktop |
+| start_mock, stop_mock | mocks:write | desktop |
+| delete_mock | mocks:delete (+ \`confirm: true\`) | \`target\` server/desktop |
+| delete_mock_route | mocks:delete (+ \`confirm: true\`) | server |
+| delete_mock_resource, delete_mock_records | mocks:delete (+ \`confirm: true\`) | engine v2, \`target\` server/desktop |
+
+\`mock\` is the name, the slug or the id. A route is referenced by routeId, \`"GET /users/:id"\`, its path
+(when unique) or its name; a resource by its name (or id). On a v1 server, if \`create_mock\` fails on a route,
+the new mock is deleted again (needs mocks:delete; otherwise the result says it is kept) and the error names the
+failing route and why; on a v2 server the create is atomic.
+
+## Errors you may meet
+
+\`PAT_SCOPE_MISSING\` (token lacks mocks:read/write/delete) · \`FEATURE_DISABLED\` (mocks switched off for the
+account) · \`MOCK_ENGINE_UNSUPPORTED\` (a v2 part on a v1 server — nothing was written) · \`MOCK_DEFINITION_INVALID\`
+(\`details.issues\` names each problem by path; nothing was written) · \`MOCK_SLUG_TAKEN\` (pick another slug) ·
+\`MOCK_LIMIT_REACHED\` (delete an old mock) · \`ROUTE_PATH_CONFLICT\` (the method + path exists) ·
+\`MOCK_ROUTE_LIMIT_REACHED\` · \`MOCK_RESOURCE_CONFLICT\` (a resource with that name exists) ·
+\`MOCK_RESOURCE_NOT_FOUND\` / \`MOCK_RECORD_NOT_FOUND\` · \`MOCK_RECORD_INVALID\` (the record does not fit the fields) ·
+\`MOCK_RECORD_DELETE_BLOCKED\` (a \`restrict\` reference) · \`REVISION_CONFLICT\` (changed elsewhere; read and repeat) ·
+\`MOCK_IMPORT_SOURCE_BLOCKED\` (a file or private URL without CALLMAN_ALLOW_LOCAL_SOURCES) ·
+\`MOCK_IMPORT_UNSUPPORTED\` / \`MOCK_IMPORT_UNREADABLE\` / \`MOCK_IMPORT_TOO_LARGE\` · \`VALIDATION_ERROR\` (details name
+the field) · \`LOCAL_MOCK_DESKTOP_OFFLINE\` (open the desktop app and switch the setting on) ·
+\`LOCAL_MOCK_DESKTOP_OUTDATED\` (update the desktop app, or use a server mock) · \`LOCAL_MOCK_TIMEOUT\` (the app did
+not answer; check with list_mocks before repeating a create) · \`LOCAL_MOCK_FEATURE_UNSUPPORTED\` (static only here).
+`;
+//# sourceMappingURL=mocks.js.map

package/dist/resources/docs/mocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks.js","sourceRoot":"","sources":["../../../src/resources/docs/mocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjM,2EAA2E;AAC3E,8DAA8D;AAC9D,MAAM,IAAI,GAAG,CAAC,MAAyB,EAAU,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAErG,MAAM,eAAe,GAAG,GAAW,EAAE;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,qBAAqB;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,KAAK,CAAC,KAAK,QAAQ,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;IACtK,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpG,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDAuEuB,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;;oFAExB,IAAI,CAAC,kBAAkB,CAAC;;;;IAIxG,IAAI,CAAC,gBAAgB,CAAC;;KAErB,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;;;;;sCAKF,IAAI,CAAC,uBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyFjE,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAyDA,IAAI,CAAC,oBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2M5C,CAAC"}