callman-mcp 0.4.0 → 0.6.0

package/dist/domain/uiTest/summarize.js

@@ -0,0 +1,145 @@
+import { resolveRunSettings } from "callman-core";
+import { isMasked } from "../../lib/mask.js";
+import { clip, jsonPreview } from "../../lib/truncate.js";
+// Compact UI-test views: a flow row, a run timeline with the failing steps
+// expanded, schedule rows. Screenshots never go into structuredContent —
+// they travel as MCP image blocks (tools/uiTestRuns) or as `has…` flags.
+const time = (value) => {
+    if (value === null || value === undefined || value === "")
+        return null;
+    const date = typeof value === "number" ? new Date(value) : new Date(String(value));
+    return Number.isNaN(date.getTime()) ? String(value) : date.toISOString();
+};
+export const flowSummaryView = (flow, folderPath) => ({
+    id: flow.clientId,
+    name: flow.name,
+    platform: flow.platform,
+    ...(flow.description ? { description: clip(flow.description, 300) } : {}),
+    folder: folderPath ?? null,
+    tags: flow.tags ?? [],
+    testType: flow.testType ?? null,
+    severity: flow.severity ?? null,
+    version: flow.version ?? null,
+    ...(flow.reviewStatus ? { reviewStatus: flow.reviewStatus } : {}),
+    ...(flow.activeVersionNumber ? { activeVersionNumber: flow.activeVersionNumber } : {}),
+    ...(flow.groupName ? { group: flow.groupName } : {}),
+    updatedAt: time(flow.updatedAt),
+});
+export const maskedDatasetKeys = (dataset) => Object.entries(dataset ?? {}).filter(([, value]) => isMasked(value)).map(([key]) => key);
+export const settingsView = (flow) => ({
+    ...(flow.platform === "web" ? { browserKind: flow.browserKind ?? null, headless: flow.headless ?? null } : { dismissPopups: flow.dismissPopups ?? [] }),
+    runSettings: resolveRunSettings(flow.runSettings ?? null),
+});
+const MAX_STEP_ROWS = 300;
+const stepRow = (step, index) => ({
+    index: index + 1,
+    command: clip(step.command ?? "", 160),
+    status: step.status,
+    durationMs: step.durationMs ?? null,
+    ...(step.error ? { error: clip(step.error, 500) } : {}),
+    ...(step.source ? { source: step.source } : {}),
+    ...(step.healed ? { healed: clip(step.healed, 200) } : {}),
+    ...(step.retries ? { retries: step.retries } : {}),
+});
+const failedStepDetail = (step, index) => ({
+    index: index + 1,
+    command: clip(step.command ?? "", 400),
+    status: step.status,
+    error: step.error ? clip(step.error, 4000) : null,
+    ...(step.source ? { source: step.source } : {}),
+    ...(step.note ? { note: clip(step.note, 500) } : {}),
+    ...(step.data !== undefined && step.data !== null ? { data: jsonPreview(step.data, 3000) } : {}),
+    ...(step.extracted ? { extracted: jsonPreview(step.extracted, 1500) } : {}),
+    ...(step.dataTruncated ? { dataTruncated: true } : {}),
+});
+const isFailed = (status) => status === "failed" || status === "error";
+export const runReportView = (report, options = {}) => {
+    const steps = report.steps ?? [];
+    const counts = steps.reduce((acc, step) => ((acc[step.status] = (acc[step.status] ?? 0) + 1), acc), {});
+    const failed = steps.map((step, index) => ({ step, index })).filter(({ step }) => isFailed(step.status));
+    const withData = options.allStepData ? steps.map((step, index) => ({ step, index })).filter(({ step }) => !isFailed(step.status) && (step.data != null || step.extracted)) : [];
+    return {
+        reportId: report.id,
+        flow: { id: report.flowClientId, name: report.flowName },
+        status: report.status,
+        ...(report.executor ? { executor: report.executor } : {}),
+        ...(report.platform ? { platform: report.platform } : {}),
+        ...(report.relay?.deviceName || report.relay?.deviceId ? { device: report.relay.deviceName ?? report.relay.deviceId } : {}),
+        triggerType: report.triggerType ?? null,
+        ...(report.scheduleName ? { schedule: report.scheduleName } : {}),
+        startedAt: time(report.startedAt),
+        finishedAt: time(report.finishedAt),
+        durationMs: report.durationMs ?? null,
+        ...(report.error ? { error: clip(report.error, 4000) } : {}),
+        stepCounts: counts,
+        steps: steps.slice(0, MAX_STEP_ROWS).map(stepRow),
+        ...(steps.length > MAX_STEP_ROWS ? { stepsTruncated: steps.length } : {}),
+        ...(failed.length > 0 ? { failedSteps: failed.slice(0, 10).map(({ step, index }) => failedStepDetail(step, index)) } : {}),
+        ...(withData.length > 0 ? { stepData: withData.slice(0, 30).map(({ step, index }) => failedStepDetail(step, index)) } : {}),
+        ...(report.datasetIssues?.length ? { datasetIssues: report.datasetIssues } : {}),
+        ...(report.warnings?.length ? { warnings: report.warnings } : {}),
+        screenshots: {
+            failure: Boolean(report.failureScreenshot ?? report.hasFailureScreenshot),
+            final: Boolean(report.finalScreenshot ?? report.hasFinalScreenshot),
+        },
+        ...(options.includeNetwork
+            ? { network: jsonPreview(report.network ?? [], 12_000), ...(report.networkTruncated ? { networkTruncated: true } : {}) }
+            : (report.network?.length ?? report.networkCount)
+                ? { networkEvents: report.network?.length ?? report.networkCount }
+                : {}),
+        ...(report.fromApprovedSnapshot ? { fromApprovedSnapshot: true, flowVersionNumber: report.flowVersionNumber ?? null } : {}),
+    };
+};
+export const runListRow = (report) => ({
+    reportId: report.id,
+    flow: { id: report.flowClientId, name: report.flowName },
+    status: report.status,
+    ...(report.executor ? { executor: report.executor } : {}),
+    triggerType: report.triggerType ?? null,
+    startedAt: time(report.startedAt),
+    durationMs: report.durationMs ?? null,
+    ...(report.error ? { error: clip(report.error, 300) } : {}),
+    ...(report.steps ? { failedStep: (() => {
+            const index = report.steps.findIndex((step) => isFailed(step.status));
+            return index >= 0 ? { index: index + 1, command: clip(report.steps[index].command, 160) } : null;
+        })() } : {}),
+});
+export const historyRow = (row) => ({
+    flow: { id: row.flowClientId, name: row.flowName },
+    status: row.status,
+    source: row.triggeredBy === "schedule" ? "schedule" : row.triggeredBy ? row.triggeredBy : "desktop",
+    platform: row.platform,
+    ...(row.deviceId ? { device: row.deviceId } : {}),
+    startedAt: time(row.startedAt),
+    durationMs: row.durationMs,
+    ...(row.error ? { error: clip(row.error, 300) } : {}),
+    ...(row.reportId ? { reportId: row.reportId } : {}),
+});
+export const scheduleView = (schedule) => ({
+    id: schedule.id,
+    name: schedule.name,
+    flow: { id: schedule.flowClientId, name: schedule.flowName },
+    enabled: schedule.enabled,
+    triggerType: schedule.triggerType,
+    timezone: schedule.timezone,
+    ...(schedule.dailyConfig ? { dailyConfig: schedule.dailyConfig } : {}),
+    ...(schedule.weeklyConfig ? { weeklyConfig: schedule.weeklyConfig } : {}),
+    ...(schedule.monthlyConfig ? { monthlyConfig: schedule.monthlyConfig } : {}),
+    ...(schedule.customCronExpression ? { customCronExpression: schedule.customCronExpression } : {}),
+    ...(schedule.description ? { description: schedule.description } : {}),
+    ...(schedule.executionPolicy ? { executionPolicy: schedule.executionPolicy } : {}),
+    ...(schedule.failurePolicy ? { failurePolicy: schedule.failurePolicy } : {}),
+    ...(schedule.notificationConfig ? { notificationConfig: schedule.notificationConfig } : {}),
+    lastRunAt: time(schedule.lastRunAt),
+    lastRunStatus: schedule.lastRunStatus ?? null,
+    nextRunAt: time(schedule.nextRunAt),
+    ...(schedule.isRunning ? { isRunning: true } : {}),
+});
+// `data:image/jpeg;base64,…` → an MCP image block.
+export const imageFromDataUrl = (dataUrl) => {
+    if (!dataUrl)
+        return null;
+    const match = /^data:(image\/[a-z0-9.+-]+);base64,(.+)$/i.exec(dataUrl.trim());
+    return match ? { mimeType: match[1].toLowerCase(), data: match[2] } : null;
+};
+//# sourceMappingURL=summarize.js.map

package/dist/domain/uiTest/summarize.js.map

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

package/dist/lib/truncate.d.ts

@@ -19,7 +19,7 @@ export interface Clipped {
     totalBytes: number;
 }
 export declare const clipBytes: (value: string, maxBytes: number) => Clipped;
-export declare const jsonPreview: (value: unknown, max?: 2000) => string | null;
+export declare const jsonPreview: (value: unknown, max?: number) => string | null;
 export declare const safeStringify: (value: unknown, space?: number) => string;
 export declare const byteLength: (value: unknown) => number;
 //# sourceMappingURL=truncate.d.ts.map

package/dist/lib/truncate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/lib/truncate.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM;;;;;;;;;;;;;EAajB,CAAC;AAEH,eAAO,MAAM,IAAI,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,MACM,CAAC;AAEzD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,OAM3D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,UAAyB,KAAG,MAAM,GAAG,IAIhF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,QAAQ,MAAM,KAAG,MAM9D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,MACyC,CAAC"}
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/lib/truncate.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM;;;;;;;;;;;;;EAajB,CAAC;AAEH,eAAO,MAAM,IAAI,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,MACM,CAAC;AAEzD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,OAM3D,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,MAAK,MAA4B,KAAG,MAAM,GAAG,IAIxF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,EAAE,QAAQ,MAAM,KAAG,MAM9D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,MACyC,CAAC"}

package/dist/lib/truncate.js.map

@@ -1 +1 @@
-{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../src/lib/truncate.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,6DAA6D;AAE7D,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,GAAG;IACT,YAAY,EAAE,KAAK;IACnB,SAAS,EAAE,EAAE,GAAG,IAAI;IACpB,gBAAgB,EAAE,EAAE,GAAG,IAAI;IAC3B,YAAY,EAAE,GAAG,GAAG,IAAI;IACxB,aAAa,EAAE,GAAG,GAAG,IAAI;IACzB,YAAY,EAAE,GAAG,GAAG,IAAI;IACxB,cAAc,EAAE,EAAE;IAClB,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,GAAW,EAAU,EAAE,CACzD,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAQzD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAW,EAAE;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpD,IAAI,UAAU,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACjF,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,QAAQ;QAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjH,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAE,GAAG,GAAG,MAAM,CAAC,YAAY,EAAiB,EAAE;IACtF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAc,EAAU,EAAE;IACtE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAU,EAAE,CACnD,MAAM,CAAC,UAAU,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC"}
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../src/lib/truncate.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,6DAA6D;AAE7D,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,GAAG;IACT,YAAY,EAAE,KAAK;IACnB,SAAS,EAAE,EAAE,GAAG,IAAI;IACpB,gBAAgB,EAAE,EAAE,GAAG,IAAI;IAC3B,YAAY,EAAE,GAAG,GAAG,IAAI;IACxB,aAAa,EAAE,GAAG,GAAG,IAAI;IACzB,YAAY,EAAE,GAAG,GAAG,IAAI;IACxB,cAAc,EAAE,EAAE;IAClB,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,GAAW,EAAU,EAAE,CACzD,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAQzD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAW,EAAE;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpD,IAAI,UAAU,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACjF,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,QAAQ;QAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjH,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAE,MAAc,MAAM,CAAC,YAAY,EAAiB,EAAE;IAC9F,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAc,EAAU,EAAE;IACtE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAU,EAAE,CACnD,MAAM,CAAC,UAAU,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC"}

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

@@ -1,2 +1,3 @@
-export declare const DIAGRAM_SCHEMA_DOC = "# Diagrams (create_diagram, update_diagram, patch_diagram)\n\nA diagram is a **DiagramDocument** (schemaVersion 1): typed nodes with positions and sizes,\nedges between nodes, a title. You write the compact form below; the server assigns ids,\nsizes from the component catalog, edge styles from the semantic, and lays the nodes out.\nEvery object is strict: a misspelled or unknown key is an error that names the valid keys,\nnever silently dropped.\n\n## Compact input\n```jsonc\n{\n  \"name\": \"Order platform\",             // library entry name\n  \"title\": \"Order platform \u2014 runtime view\",\n  \"nodes\": [\n    { \"id\": \"k8s\",   \"type\": \"frame\",           \"label\": \"Kubernetes\",      // a container\n      \"style\": { \"stroke\": \"#8B5CF6\", \"fill\": \"rgba(139,92,246,0.07)\", \"textColor\": \"#8B5CF6\", \"strokeWidth\": 2, \"bold\": true } },\n    { \"id\": \"gw\",    \"type\": \"net.api-gateway\", \"label\": \"API Gateway\" },\n    { \"id\": \"orders\",\"type\": \"net.service\",     \"label\": \"Orders service\", \"parent\": \"k8s\" },\n    { \"id\": \"db\",    \"type\": \"db.postgres\",     \"label\": \"orders db\" },\n    { \"id\": \"bus\",   \"type\": \"mq.kafka\",        \"label\": \"events\" }\n  ],\n  \"edges\": [\n    { \"source\": \"gw\",     \"target\": \"orders\", \"label\": \"REST\",  \"semantic\": \"sync\" },\n    { \"source\": \"orders\", \"target\": \"db\",     \"semantic\": \"sync\", \"color\": \"#10B981\" },\n    { \"source\": \"orders\", \"target\": \"bus\",    \"label\": \"OrderCreated\" }   // \u2192 bus automatically\n  ]\n}\n```\n\n## Nodes\n| Field | Type | Notes |\n| --- | --- | --- |\n| `id` | string | Stable id you reference from `parent` and edges; generated (n1, n2\u2026) when omitted |\n| `type` | string | MUST be a catalog type \u2014 `callman://diagram/components` (or one category: `callman://diagram/components/aws`). Unknown types are rejected with suggestions; `strictTypes: false` draws them as rectangles |\n| `label` | string | 1\u20133 words reads best |\n| `parent` | node id | Puts the node inside a container: `frame`, `pool.horizontal` or `pool.vertical` |\n| `position` | {x, y} | Top-left, relative to the parent container. Omit to auto-layout |\n| `size` | {width, height} | Defaults to the catalog size |\n| `style` | object | See **Styling** |\n| `rotation` | number | Degrees, clockwise |\n| `locked` / `hidden` | boolean | Locked nodes cannot be moved in the studio |\n| `data` | object | Free-form metadata kept with the node; not rendered |\n\n`line`, `arrow` and `line.dashed` are connectors in the studio's palette, not nodes \u2014 draw\nconnections as edges.\n\n## Edges\n| Field | Type | Notes |\n| --- | --- | --- |\n| `source`, `target` | node id | A container id is allowed |\n| `label` | string | |\n| `semantic` | sync \u00B7 async \u00B7 fallback \u00B7 bus | `sync` solid (request/response, default), `async` dashed (event, callback), `fallback` dotted (retry / optional path), `bus` heavy (message bus / stream \u2014 automatic when an end is a messaging component) |\n| `color` | CSS color | Line color, independent of the semantic |\n| `routing` | orthogonal \u00B7 straight \u00B7 curved | Default orthogonal (auto-routed right angles) |\n| `markerEnd` / `markerStart` | none \u00B7 classic \u00B7 classicThin \u00B7 open \u00B7 block \u00B7 diamond \u00B7 oval | Default: classicThin at the target, none at the source. Set `markerStart` for a two-way line |\n\nThe semantic owns the line pattern and width; there is no separate dash or width field on edges.\n\n## Styling (node `style`)\n| Key | Type | Notes |\n| --- | --- | --- |\n| `fill` | CSS color | Background. A translucent `rgba(r,g,b,0.07)` tints a container without hiding its children |\n| `stroke` | CSS color | Border |\n| `textColor` | CSS color | Label |\n| `strokeWidth` | number (px) | Border width |\n| `dashed` | boolean | Containers (frame) are dashed by default |\n| `dashPattern` | string | SVG dash array when dashed: `\"6 4\"` dashed, `\"1 3\"` dotted |\n| `radius` | number (px) | Corner radius (`rounded: true` for the default radius) |\n| `fontSize` | number (px) | |\n| `fontFamily` | string | |\n| `bold`, `italic`, `underline` | boolean | |\n| `align` | left \u00B7 center \u00B7 right | |\n| `verticalAlign` | top \u00B7 middle \u00B7 bottom | |\n| `shadow` | boolean | |\n| `opacity` | 0\u2013100 | |\n\nColors are CSS strings \u2014 `\"#3B82F6\"`, `\"rgb(59,130,246)\"`, `\"rgba(59,130,246,0.08)\"`, `\"tomato\"`.\nPick mid-tone colors: the studio has light and dark themes.\n\nColor-coding containers is the quickest way to make zones read at a glance:\n```jsonc\n{ \"op\": \"updateNode\", \"id\": \"k8s\", \"changes\": { \"style\": { \"stroke\": \"#8B5CF6\", \"fill\": \"rgba(139,92,246,0.07)\", \"textColor\": \"#8B5CF6\", \"strokeWidth\": 2, \"bold\": true } } }\n```\n\n## Layout\nPositions are optional; when any node lacks one the whole diagram is laid out\n(`direction`: DOWN, RIGHT, UP, LEFT). Give explicit `position: {x,y}` only when the user\nasks for a specific arrangement. Keep diagrams readable: 8\u201325 nodes, short labels, one edge\nper relationship.\n\n## Editing: patch_diagram ops\nOps describe CHANGES; the rest of the diagram stays exactly as it is. The op list below is the\nsame vocabulary the desktop's AI assistant uses \u2014 one implementation (callman-core) applies both.\n```jsonc\n{ \"op\": \"addNode\",    \"node\": { \"type\": \"db.redis\", \"label\": \"cache\", \"parent\": \"k8s\" } }\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"label\": \"Orders API\", \"style\": { \"fill\": \"#EFF6FF\" } } }\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"style\": { \"fill\": null } } }   // remove one style key\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"style\": null } }                // clear the style\n{ \"op\": \"removeNode\", \"id\": \"bus\" }                 // its edges are removed, its children move to the top level\n{ \"op\": \"addEdge\",    \"edge\": { \"source\": \"orders\", \"target\": \"cache\", \"semantic\": \"async\", \"color\": \"#F59E0B\" } }\n{ \"op\": \"updateEdge\", \"id\": \"e2\", \"changes\": { \"label\": \"gRPC\", \"semantic\": \"fallback\" } }  // color is kept\n{ \"op\": \"updateEdge\", \"id\": \"e2\", \"changes\": { \"color\": null } }                  // back to the default color\n{ \"op\": \"removeEdge\", \"id\": \"e3\" }\n{ \"op\": \"setTitle\",   \"title\": \"New title\" }\n{ \"op\": \"moveNode\",   \"id\": \"orders\", \"position\": { \"x\": 320, \"y\": 80 } }\n{ \"op\": \"reparent\",   \"id\": \"orders\", \"parent\": \"k8s\" }                          // null = top level\n{ \"op\": \"setEdgeRoute\", \"id\": \"e2\", \"routing\": \"smart\", \"sourceSide\": \"right\", \"targetSide\": \"left\" }\n{ \"op\": \"reorder\",    \"id\": \"k8s\", \"index\": \"back\" }\n{ \"op\": \"setCanvas\",  \"canvas\": { \"background\": \"grid\", \"defaultRouting\": \"orthogonal\" } }\n{ \"op\": \"group\",      \"ids\": [\"orders\", \"db\"], \"label\": \"Order domain\" }         // a new frame around them\n{ \"op\": \"ungroup\",    \"id\": \"k8s\" }                                             // members stay where they are\n{ \"op\": \"relayout\",   \"scope\": \"new\" }                                           // hint: place only the new nodes (or \"all\")\n```\n- updateNode `changes` accepts: type, label, parent (null/\"\" = top level), position, size,\n  style, rotation, locked, hidden, collapsed, data. `style` and `data` MERGE into what the\n  node has; a key set to null is removed.\n- updateEdge `changes` accepts: source, target, label (\"\" removes it), semantic, color,\n  routing, markerEnd, markerStart, sourceSide, targetSide (null = floating).\n- Ids: a node written without an id gets a slug of its label (`orders-service`, `-2` on a\n  clash); the result's `idMap` reports any id that had to change.\n- Moving a node (position, size or parent) or re-pointing an edge drops the saved route of\n  the edges involved; the studio re-routes them (`reroutedEdges` in the result).\n- `relayout`: `new` (default \u2014 only new nodes get a place), `all` (re-run layout), `none`.\n- `get_diagram` (view `graph`) returns nodes and edges in this same shape \u2014 ids, parents,\n  styles, colors, routing, sides \u2014 so read it before a patch.\n- If someone saved the diagram between your read and your patch, the ops are re-applied on\n  the newer version automatically (they describe intent, not a whole document).\n\n## Mermaid\n- `get_diagram` view `mermaid` renders any diagram as a Mermaid flowchart (`id@{ shape, label }`\n  nodes, `subgraph` containers, `e1@-->` edge ids, `-->`/`-.->`/`==>` for sync/async/bus).\n- `create_diagram` / `update_diagram` accept `source: { format: \"mermaid\", text }` instead of\n  nodes: a flowchart/graph becomes nodes and edges (laid out automatically) and the text stays\n  attached as the diagram's source \u2014 later ops keep it in sync (the desktop shows both).\n  Bracket shapes map to component types (`[( )]` \u2192 database, `{ }` \u2192 decision, `([ ])` \u2192\n  terminator \u2026); `click`, `%%` comments and unknown statements are kept untouched.\n- Any other Mermaid type (sequenceDiagram, classDiagram, erDiagram \u2026) is stored as source only:\n  `get_diagram` view `source` returns it, the desktop previews it, and structural ops are\n  refused with `DIAGRAM_SOURCE_UNSUPPORTED_TYPE`.\n\n## BPMN\n- A BPMN diagram keeps its truth in BPMN 2.0 XML: `create_diagram` with `kind: \"bpmn\"` (or nodes\n  typed bpmn.*) writes the XML from your nodes and edges; `source: { format: \"bpmn\", text }` stores a\n  file you already have (from Camunda Modeler, for example). The desktop opens it in its BPMN editor.\n- Node `type` is one of the bpmn.* types listed under DIAGRAM OPS above (bpmn.start-event,\n  bpmn.user-task, bpmn.service-task, bpmn.exclusive-gateway, bpmn.parallel-gateway, bpmn.subprocess,\n  bpmn.pool, bpmn.lane, bpmn.boundary-event \u2026). `data.bpmn` carries the BPMN facts:\n  `eventDefinition` (message | timer | error | signal | \u2026), `attachedTo` (boundary events),\n  `cancelActivity`, `isExpanded`. Edges are sequence flows; `data.bpmn` may set\n  `flow: \"message\"` (between pools), `conditionExpression` and `isDefault`.\n- Pools and lanes are containers (`parent`); a boundary event's parent is its host's parent.\n  New nodes need no position: they are placed after their predecessor.\n- `patch_diagram` works as on any diagram: every op lands on the XML as a minimal edit \u2014 extension\n  elements, annotations and the modeler's formatting stay untouched. `get_diagram` view `source`\n  returns the XML; view `graph` shows the derived nodes/edges with their `bpmn` facts.\n\n## Database diagrams (ERD)\n- A database diagram keeps its truth in a JSON database model (`source.format: \"database\"`):\n  tables (`entities`) with columns, keys, indexes and comments, and relationships between them;\n  the nodes on the canvas hold only positions and visibility. The desktop opens it on an ERD\n  canvas; `get_diagram` view `schema` shows tables with their columns and the relationships as\n  `table.column` pairs \u2014 read it before editing.\n- Create one with `create_diagram`: `tables` + `relationships` (`{ name, schema?, columns:\n  [{ name, dataType, primaryKey?, nullable?, unique?, defaultValue?, comment? }] }` and\n  `{ source: \"orders.user_id\", target: \"users.id\", cardinality: \"N:1\" }` \u2014 source is the child /\n  foreign-key side), or nodes typed db.table / db.view / db.collection with the columns in\n  `data.db.columns`, or `fromConnection` to read a real database through one of the\n  workspace's connections (`introspect_database` reads the same schema without drawing it).\n- Edit with the schema ops of `patch_diagram`:\n```jsonc\n{ \"op\": \"addTable\", \"table\": { \"name\": \"payments\", \"columns\": [{ \"name\": \"id\", \"dataType\": \"uuid\", \"primaryKey\": true }, { \"name\": \"order_id\", \"dataType\": \"bigint\" }, { \"name\": \"amount\", \"dataType\": \"numeric(12,2)\" }] } }\n{ \"op\": \"addColumn\", \"table\": \"users\", \"column\": { \"name\": \"profile_id\", \"dataType\": \"uuid\", \"nullable\": true }, \"after\": \"id\" }\n{ \"op\": \"alterColumn\", \"table\": \"users\", \"column\": \"email\", \"changes\": { \"unique\": true, \"nullable\": false } }\n{ \"op\": \"removeColumn\", \"table\": \"users\", \"column\": \"nickname\" }\n{ \"op\": \"setPrimaryKey\", \"table\": \"order_items\", \"columns\": [\"order_id\", \"line\"] }\n{ \"op\": \"renameTable\", \"table\": \"users\", \"name\": \"accounts\", \"schema\": \"auth\" }\n{ \"op\": \"setTableComment\", \"table\": \"users\", \"comment\": \"People who can sign in\" }\n{ \"op\": \"addRelationship\", \"source\": \"payments.order_id\", \"target\": \"orders.id\", \"cardinality\": \"N:1\" }\n{ \"op\": \"updateRelationship\", \"relationship\": \"fk-payments-orders\", \"changes\": { \"cardinality\": \"1:1\", \"label\": \"settles\" } }\n{ \"op\": \"removeRelationship\", \"relationship\": \"fk-payments-orders\" }\n{ \"op\": \"removeTable\", \"table\": \"audit_log\" }                                   // its relationships go with it\n{ \"op\": \"hideTable\", \"table\": \"migrations\" }                                    // canvas only; showTable brings it back\n```\n  Tables are named (`users`, `public.users`), columns as `table.column`; ids stay stable\n  across renames. New tables are placed to the right of the existing ones (or laid out with\n  `relayout: \"all\"`). moveNode, hideTable/showTable and setCanvas change the canvas only;\n  group / ungroup / reparent do not apply.\n\n## Stored document (get_diagram view: \"full\")\n```ts\ninterface DiagramDocument {\n  schemaVersion: 1; id: string;\n  meta: { title: string; createdAt: string; updatedAt: string; revision?: number };\n  canvas?: { background?: \"grid\" | \"dots\" | \"blank\"; gridSize?: number;\n             defaultRouting?: \"orthogonal\" | \"straight\" | \"curved\" | \"smart\";\n             layout?: { algorithm; direction }; viewport?: { x; y; zoom } };\n  nodes: { id; type; position: {x,y}; size: {width,height}; label?; parentId?; rotation?;\n           locked?; hidden?; collapsed?; collapsedSize?; style?: DiagramStyle; data? }[];\n  edges: { id; source?; target?; label?; labelPosition?; routing?; sourceHandle?; targetHandle?;\n           style?: DiagramStyle; markerStart?; markerEnd?; waypoints? }[];\n  source?: { format: \"mermaid\" | \"bpmn\" | \"database\"; text; diagramType; grammar?; valid? };\n}\n// Stored colors are { raw: \"#3B82F6\" } (or a theme { token }); bold/italic/underline are\n// the bitmask fontStyle (1 | 2 | 4). The tools convert both ways \u2014 write plain colors.\n```\nEdge meaning is derived from `style` (dashed + dashPattern + strokeWidth) \u2014 set it with\n`semantic`, never directly.\n";
+export declare const DIAGRAM_SCHEMA_DOC = "# Diagrams (create_diagram, update_diagram, patch_diagram)\n\nThe desktop has four kinds of diagram, and every tool here works on all of them:\n| Kind | Create with | Node types | Section |\n|---|---|---|---|\n| System design (canvas) | `nodes` + `edges` (default) | callman://diagram/components | Compact input |\n| BPMN process | `kind: \"bpmn\"`, bpmn.* nodes, or `source: { format: \"bpmn\" }` | bpmn.* (end of this doc) | BPMN |\n| Mermaid | `source: { format: \"mermaid\", text }` | \u2014 (a flowchart becomes nodes) | Mermaid |\n| Database / ERD | `kind: \"database\"` + `tables` / `relationships`, or `fromConnection` | db.table / db.view / db.collection | Database diagrams |\n\nA diagram is a **DiagramDocument** (schemaVersion 1): typed nodes with positions and sizes,\nedges between nodes, a title. You write the compact form below; the server assigns ids,\nsizes from the component catalog, edge styles from the semantic, and lays the nodes out.\nEvery object is strict: a misspelled or unknown key is an error that names the valid keys,\nnever silently dropped.\n\n## Compact input\n```jsonc\n{\n  \"name\": \"Order platform\",             // library entry name\n  \"title\": \"Order platform \u2014 runtime view\",\n  \"nodes\": [\n    { \"id\": \"k8s\",   \"type\": \"frame\",           \"label\": \"Kubernetes\",      // a container\n      \"style\": { \"stroke\": \"#8B5CF6\", \"fill\": \"rgba(139,92,246,0.07)\", \"textColor\": \"#8B5CF6\", \"strokeWidth\": 2, \"bold\": true } },\n    { \"id\": \"gw\",    \"type\": \"net.api-gateway\", \"label\": \"API Gateway\" },\n    { \"id\": \"orders\",\"type\": \"net.service\",     \"label\": \"Orders service\", \"parent\": \"k8s\" },\n    { \"id\": \"db\",    \"type\": \"db.postgres\",     \"label\": \"orders db\" },\n    { \"id\": \"bus\",   \"type\": \"mq.kafka\",        \"label\": \"events\" }\n  ],\n  \"edges\": [\n    { \"source\": \"gw\",     \"target\": \"orders\", \"label\": \"REST\",  \"semantic\": \"sync\" },\n    { \"source\": \"orders\", \"target\": \"db\",     \"semantic\": \"sync\", \"color\": \"#10B981\" },\n    { \"source\": \"orders\", \"target\": \"bus\",    \"label\": \"OrderCreated\" }   // \u2192 bus automatically\n  ]\n}\n```\n\n## Nodes\n| Field | Type | Notes |\n| --- | --- | --- |\n| `id` | string | Stable id you reference from `parent` and edges; generated (n1, n2\u2026) when omitted |\n| `type` | string | MUST be a catalog type \u2014 `callman://diagram/components` (or one category: `callman://diagram/components/aws`). Unknown types are rejected with suggestions; `strictTypes: false` draws them as rectangles |\n| `label` | string | 1\u20133 words reads best |\n| `parent` | node id | Puts the node inside a container: `frame`, `pool.horizontal` or `pool.vertical` |\n| `position` | {x, y} | Top-left, relative to the parent container. Omit to auto-layout |\n| `size` | {width, height} | Defaults to the catalog size |\n| `style` | object | See **Styling** |\n| `rotation` | number | Degrees, clockwise |\n| `locked` / `hidden` | boolean | Locked nodes cannot be moved in the studio |\n| `data` | object | Free-form metadata kept with the node; not rendered |\n\n`line`, `arrow` and `line.dashed` are connectors in the studio's palette, not nodes \u2014 draw\nconnections as edges.\n\n## Edges\n| Field | Type | Notes |\n| --- | --- | --- |\n| `source`, `target` | node id | A container id is allowed |\n| `label` | string | |\n| `semantic` | sync \u00B7 async \u00B7 fallback \u00B7 bus | `sync` solid (request/response, default), `async` dashed (event, callback), `fallback` dotted (retry / optional path), `bus` heavy (message bus / stream \u2014 automatic when an end is a messaging component) |\n| `color` | CSS color | Line color, independent of the semantic |\n| `routing` | orthogonal \u00B7 straight \u00B7 curved | Default orthogonal (auto-routed right angles) |\n| `markerEnd` / `markerStart` | none \u00B7 classic \u00B7 classicThin \u00B7 open \u00B7 block \u00B7 diamond \u00B7 oval | Default: classicThin at the target, none at the source. Set `markerStart` for a two-way line |\n\nThe semantic owns the line pattern and width; there is no separate dash or width field on edges.\n\n## Styling (node `style`)\n| Key | Type | Notes |\n| --- | --- | --- |\n| `fill` | CSS color | Background. A translucent `rgba(r,g,b,0.07)` tints a container without hiding its children |\n| `stroke` | CSS color | Border |\n| `textColor` | CSS color | Label |\n| `strokeWidth` | number (px) | Border width |\n| `dashed` | boolean | Containers (frame) are dashed by default |\n| `dashPattern` | string | SVG dash array when dashed: `\"6 4\"` dashed, `\"1 3\"` dotted |\n| `radius` | number (px) | Corner radius (`rounded: true` for the default radius) |\n| `fontSize` | number (px) | |\n| `fontFamily` | string | |\n| `bold`, `italic`, `underline` | boolean | |\n| `align` | left \u00B7 center \u00B7 right | |\n| `verticalAlign` | top \u00B7 middle \u00B7 bottom | |\n| `shadow` | boolean | |\n| `opacity` | 0\u2013100 | |\n\nColors are CSS strings \u2014 `\"#3B82F6\"`, `\"rgb(59,130,246)\"`, `\"rgba(59,130,246,0.08)\"`, `\"tomato\"`.\nPick mid-tone colors: the studio has light and dark themes.\n\nColor-coding containers is the quickest way to make zones read at a glance:\n```jsonc\n{ \"op\": \"updateNode\", \"id\": \"k8s\", \"changes\": { \"style\": { \"stroke\": \"#8B5CF6\", \"fill\": \"rgba(139,92,246,0.07)\", \"textColor\": \"#8B5CF6\", \"strokeWidth\": 2, \"bold\": true } } }\n```\n\n## Layout\nPositions are optional; when any node lacks one the whole diagram is laid out\n(`direction`: DOWN, RIGHT, UP, LEFT). Give explicit `position: {x,y}` only when the user\nasks for a specific arrangement. Keep diagrams readable: 8\u201325 nodes, short labels, one edge\nper relationship.\n\n## Editing: patch_diagram ops\nOps describe CHANGES; the rest of the diagram stays exactly as it is. The op list below is the\nsame vocabulary the desktop's AI assistant uses \u2014 one implementation (callman-core) applies both.\n```jsonc\n{ \"op\": \"addNode\",    \"node\": { \"type\": \"db.redis\", \"label\": \"cache\", \"parent\": \"k8s\" } }\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"label\": \"Orders API\", \"style\": { \"fill\": \"#EFF6FF\" } } }\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"style\": { \"fill\": null } } }   // remove one style key\n{ \"op\": \"updateNode\", \"id\": \"orders\", \"changes\": { \"style\": null } }                // clear the style\n{ \"op\": \"removeNode\", \"id\": \"bus\" }                 // its edges are removed, its children move to the top level\n{ \"op\": \"addEdge\",    \"edge\": { \"source\": \"orders\", \"target\": \"cache\", \"semantic\": \"async\", \"color\": \"#F59E0B\" } }\n{ \"op\": \"updateEdge\", \"id\": \"e2\", \"changes\": { \"label\": \"gRPC\", \"semantic\": \"fallback\" } }  // color is kept\n{ \"op\": \"updateEdge\", \"id\": \"e2\", \"changes\": { \"color\": null } }                  // back to the default color\n{ \"op\": \"removeEdge\", \"id\": \"e3\" }\n{ \"op\": \"setTitle\",   \"title\": \"New title\" }\n{ \"op\": \"moveNode\",   \"id\": \"orders\", \"position\": { \"x\": 320, \"y\": 80 } }\n{ \"op\": \"reparent\",   \"id\": \"orders\", \"parent\": \"k8s\" }                          // null = top level\n{ \"op\": \"setEdgeRoute\", \"id\": \"e2\", \"routing\": \"smart\", \"sourceSide\": \"right\", \"targetSide\": \"left\" }\n{ \"op\": \"reorder\",    \"id\": \"k8s\", \"index\": \"back\" }\n{ \"op\": \"setCanvas\",  \"canvas\": { \"background\": \"grid\", \"defaultRouting\": \"orthogonal\" } }\n{ \"op\": \"group\",      \"ids\": [\"orders\", \"db\"], \"label\": \"Order domain\" }         // a new frame around them\n{ \"op\": \"ungroup\",    \"id\": \"k8s\" }                                             // members stay where they are\n{ \"op\": \"relayout\",   \"scope\": \"new\" }                                           // hint: place only the new nodes (or \"all\")\n```\n- updateNode `changes` accepts: type, label, parent (null/\"\" = top level), position, size,\n  style, rotation, locked, hidden, collapsed, data. `style` and `data` MERGE into what the\n  node has; a key set to null is removed.\n- updateEdge `changes` accepts: source, target, label (\"\" removes it), semantic, color,\n  routing, markerEnd, markerStart, sourceSide, targetSide (null = floating).\n- Ids: a node written without an id gets a slug of its label (`orders-service`, `-2` on a\n  clash); the result's `idMap` reports any id that had to change.\n- Moving a node (position, size or parent) or re-pointing an edge drops the saved route of\n  the edges involved; the studio re-routes them (`reroutedEdges` in the result).\n- `relayout`: `new` (default \u2014 only new nodes get a place), `all` (re-run layout), `none`.\n- `get_diagram` (view `graph`) returns nodes and edges in this same shape \u2014 ids, parents,\n  styles, colors, routing, sides \u2014 so read it before a patch.\n- If someone saved the diagram between your read and your patch, the ops are re-applied on\n  the newer version automatically (they describe intent, not a whole document).\n\n## Mermaid\n- `get_diagram` view `mermaid` renders any diagram as a Mermaid flowchart (`id@{ shape, label }`\n  nodes, `subgraph` containers, `e1@-->` edge ids, `-->`/`-.->`/`==>` for sync/async/bus).\n- `create_diagram` / `update_diagram` accept `source: { format: \"mermaid\", text }` instead of\n  nodes: a flowchart/graph becomes nodes and edges (laid out automatically) and the text stays\n  attached as the diagram's source \u2014 later ops keep it in sync (the desktop shows both).\n  Bracket shapes map to component types (`[( )]` \u2192 database, `{ }` \u2192 decision, `([ ])` \u2192\n  terminator \u2026); `click`, `%%` comments and unknown statements are kept untouched.\n- Any other Mermaid type (sequenceDiagram, classDiagram, erDiagram \u2026) is stored as source only:\n  `get_diagram` view `source` returns it, the desktop previews it, and structural ops are\n  refused with `DIAGRAM_SOURCE_UNSUPPORTED_TYPE`.\n\n## BPMN\n- A BPMN diagram keeps its truth in BPMN 2.0 XML: `create_diagram` with `kind: \"bpmn\"` (or nodes\n  typed bpmn.*) writes the XML from your nodes and edges; `source: { format: \"bpmn\", text }` stores a\n  file you already have (from Camunda Modeler, for example). The desktop opens it in its BPMN editor.\n- Node `type` is one of the bpmn.* types \u2014 the full list is under \"Reference: BPMN vocabulary\" at\n  the end of this document (bpmn.start-event, bpmn.user-task, bpmn.service-task,\n  bpmn.exclusive-gateway, bpmn.parallel-gateway, bpmn.subprocess, bpmn.pool, bpmn.lane,\n  bpmn.boundary-event \u2026). They are not in callman://diagram/components. `data.bpmn` carries the BPMN facts:\n  `eventDefinition` (message | timer | error | signal | \u2026), `attachedTo` (boundary events),\n  `cancelActivity`, `isExpanded`. Edges are sequence flows; `data.bpmn` may set\n  `flow: \"message\"` (between pools), `conditionExpression` and `isDefault`.\n- Pools and lanes are containers (`parent`); a boundary event's parent is its host's parent.\n  New nodes need no position: they are placed after their predecessor.\n- `patch_diagram` works as on any diagram: every op lands on the XML as a minimal edit \u2014 extension\n  elements, annotations and the modeler's formatting stay untouched. `get_diagram` view `source`\n  returns the XML; view `graph` shows the derived nodes/edges with their `bpmn` facts.\n\n## Database diagrams (ERD)\n- A database diagram keeps its truth in a JSON database model (`source.format: \"database\"`):\n  tables (`entities`) with columns, keys, indexes and comments, and relationships between them;\n  the nodes on the canvas hold only positions and visibility. The desktop opens it on an ERD\n  canvas; `get_diagram` view `schema` shows tables with their columns and the relationships as\n  `table.column` pairs \u2014 read it before editing.\n- Create one with `create_diagram`: `tables` + `relationships` (`{ name, schema?, columns:\n  [{ name, dataType, primaryKey?, nullable?, unique?, defaultValue?, comment? }] }` and\n  `{ source: \"orders.user_id\", target: \"users.id\", cardinality: \"N:1\" }` \u2014 source is the child /\n  foreign-key side), or nodes typed db.table / db.view / db.collection with the columns in\n  `data.db.columns`, or `fromConnection` to read a real database through one of the\n  workspace's connections (`introspect_database` reads the same schema without drawing it).\n- Edit with the schema ops of `patch_diagram`:\n```jsonc\n{ \"op\": \"addTable\", \"table\": { \"name\": \"payments\", \"columns\": [{ \"name\": \"id\", \"dataType\": \"uuid\", \"primaryKey\": true }, { \"name\": \"order_id\", \"dataType\": \"bigint\" }, { \"name\": \"amount\", \"dataType\": \"numeric(12,2)\" }] } }\n{ \"op\": \"addColumn\", \"table\": \"users\", \"column\": { \"name\": \"profile_id\", \"dataType\": \"uuid\", \"nullable\": true }, \"after\": \"id\" }\n{ \"op\": \"alterColumn\", \"table\": \"users\", \"column\": \"email\", \"changes\": { \"unique\": true, \"nullable\": false } }\n{ \"op\": \"removeColumn\", \"table\": \"users\", \"column\": \"nickname\" }\n{ \"op\": \"setPrimaryKey\", \"table\": \"order_items\", \"columns\": [\"order_id\", \"line\"] }\n{ \"op\": \"renameTable\", \"table\": \"users\", \"name\": \"accounts\", \"schema\": \"auth\" }\n{ \"op\": \"setTableComment\", \"table\": \"users\", \"comment\": \"People who can sign in\" }\n{ \"op\": \"addRelationship\", \"source\": \"payments.order_id\", \"target\": \"orders.id\", \"cardinality\": \"N:1\" }\n{ \"op\": \"updateRelationship\", \"relationship\": \"fk-payments-orders\", \"changes\": { \"cardinality\": \"1:1\", \"label\": \"settles\" } }\n{ \"op\": \"removeRelationship\", \"relationship\": \"fk-payments-orders\" }\n{ \"op\": \"removeTable\", \"table\": \"audit_log\" }                                   // its relationships go with it\n{ \"op\": \"hideTable\", \"table\": \"migrations\" }                                    // canvas only; showTable brings it back\n```\n  Tables are named (`users`, `public.users`), columns as `table.column`; ids stay stable\n  across renames. New tables are placed to the right of the existing ones (or laid out with\n  `relayout: \"all\"`). moveNode, hideTable/showTable and setCanvas change the canvas only;\n  group / ungroup / reparent do not apply.\n\n## Stored document (get_diagram view: \"full\")\n```ts\ninterface DiagramDocument {\n  schemaVersion: 1; id: string;\n  meta: { title: string; createdAt: string; updatedAt: string; revision?: number };\n  canvas?: { background?: \"grid\" | \"dots\" | \"blank\"; gridSize?: number;\n             defaultRouting?: \"orthogonal\" | \"straight\" | \"curved\" | \"smart\";\n             layout?: { algorithm; direction }; viewport?: { x; y; zoom } };\n  nodes: { id; type; position: {x,y}; size: {width,height}; label?; parentId?; rotation?;\n           locked?; hidden?; collapsed?; collapsedSize?; style?: DiagramStyle; data? }[];\n  edges: { id; source?; target?; label?; labelPosition?; routing?; sourceHandle?; targetHandle?;\n           style?: DiagramStyle; markerStart?; markerEnd?; waypoints? }[];\n  source?: { format: \"mermaid\" | \"bpmn\" | \"database\"; text; diagramType; grammar?; valid? };\n}\n// Stored colors are { raw: \"#3B82F6\" } (or a theme { token }); bold/italic/underline are\n// the bitmask fontStyle (1 | 2 | 4). The tools convert both ways \u2014 write plain colors.\n```\nEdge meaning is derived from `style` (dashed + dashPattern + strokeWidth) \u2014 set it with\n`semantic`, never directly.\n";
+export declare const diagramSchemaDoc: () => string;
 //# sourceMappingURL=diagramSchema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"diagramSchema.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/diagramSchema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,mmdA+M9B,CAAC"}
+{"version":3,"file":"diagramSchema.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/diagramSchema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,i0eAwN9B,CAAC;AAIF,eAAO,MAAM,gBAAgB,QAAO,MAetB,CAAC"}

package/dist/resources/docs/diagramSchema.js

@@ -1,5 +1,14 @@
+import { renderBpmnVocabulary, renderDatabaseOps, renderDatabaseVocabulary } from "callman-core";
 export const DIAGRAM_SCHEMA_DOC = `# Diagrams (create_diagram, update_diagram, patch_diagram)
 
+The desktop has four kinds of diagram, and every tool here works on all of them:
+| Kind | Create with | Node types | Section |
+|---|---|---|---|
+| System design (canvas) | \`nodes\` + \`edges\` (default) | callman://diagram/components | Compact input |
+| BPMN process | \`kind: "bpmn"\`, bpmn.* nodes, or \`source: { format: "bpmn" }\` | bpmn.* (end of this doc) | BPMN |
+| Mermaid | \`source: { format: "mermaid", text }\` | — (a flowchart becomes nodes) | Mermaid |
+| Database / ERD | \`kind: "database"\` + \`tables\` / \`relationships\`, or \`fromConnection\` | db.table / db.view / db.collection | Database diagrams |
+
 A diagram is a **DiagramDocument** (schemaVersion 1): typed nodes with positions and sizes,
 edges between nodes, a title. You write the compact form below; the server assigns ids,
 sizes from the component catalog, edge styles from the semantic, and lays the nodes out.
@@ -142,9 +151,10 @@ same vocabulary the desktop's AI assistant uses — one implementation (callman-
 - A BPMN diagram keeps its truth in BPMN 2.0 XML: \`create_diagram\` with \`kind: "bpmn"\` (or nodes
   typed bpmn.*) writes the XML from your nodes and edges; \`source: { format: "bpmn", text }\` stores a
   file you already have (from Camunda Modeler, for example). The desktop opens it in its BPMN editor.
-- Node \`type\` is one of the bpmn.* types listed under DIAGRAM OPS above (bpmn.start-event,
-  bpmn.user-task, bpmn.service-task, bpmn.exclusive-gateway, bpmn.parallel-gateway, bpmn.subprocess,
-  bpmn.pool, bpmn.lane, bpmn.boundary-event …). \`data.bpmn\` carries the BPMN facts:
+- Node \`type\` is one of the bpmn.* types — the full list is under "Reference: BPMN vocabulary" at
+  the end of this document (bpmn.start-event, bpmn.user-task, bpmn.service-task,
+  bpmn.exclusive-gateway, bpmn.parallel-gateway, bpmn.subprocess, bpmn.pool, bpmn.lane,
+  bpmn.boundary-event …). They are not in callman://diagram/components. \`data.bpmn\` carries the BPMN facts:
   \`eventDefinition\` (message | timer | error | signal | …), \`attachedTo\` (boundary events),
   \`cancelActivity\`, \`isExpanded\`. Edges are sequence flows; \`data.bpmn\` may set
   \`flow: "message"\` (between pools), \`conditionExpression\` and \`isDefault\`.
@@ -206,4 +216,21 @@ interface DiagramDocument {
 Edge meaning is derived from \`style\` (dashed + dashPattern + strokeWidth) — set it with
 \`semantic\`, never directly.
 `;
+// The BPMN and database vocabularies come from callman-core — the same text the
+// desktop's AI reads — so the type lists and op shapes can never drift.
+export const diagramSchemaDoc = () => [
+    DIAGRAM_SCHEMA_DOC,
+    "## Reference: BPMN vocabulary",
+    "```text",
+    renderBpmnVocabulary(),
+    "```",
+    "",
+    "## Reference: database model and schema ops",
+    "```text",
+    renderDatabaseVocabulary(),
+    "",
+    renderDatabaseOps(),
+    "```",
+    "",
+].join("\n");
 //# sourceMappingURL=diagramSchema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"diagramSchema.js","sourceRoot":"","sources":["../../../src/resources/docs/diagramSchema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+MjC,CAAC"}
+{"version":3,"file":"diagramSchema.js","sourceRoot":"","sources":["../../../src/resources/docs/diagramSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAEjG,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwNjC,CAAC;AAEF,gFAAgF;AAChF,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAW,EAAE,CAC3C;IACE,kBAAkB;IAClB,+BAA+B;IAC/B,SAAS;IACT,oBAAoB,EAAE;IACtB,KAAK;IACL,EAAE;IACF,6CAA6C;IAC7C,SAAS;IACT,wBAAwB,EAAE;IAC1B,EAAE;IACF,iBAAiB,EAAE;IACnB,KAAK;IACL,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

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

@@ -1,2 +1,2 @@
-export declare const OVERVIEW_DOC = "# Working with Callman through MCP\n\nCallman is an API client and test platform (collections of HTTP requests, environments,\nmulti-step test scenarios, system-design diagrams). This server exposes it to you through\ntools; everything you do goes to the same server the Callman desktop app uses, as the user\nwhose token is configured, limited to that token's permissions and the user's workspace role.\n\n## Start here\n1. `whoami` \u2014 proves the connection and tells you the workspaces, features and which tools\n   this token can use.\n2. Look before you create: `list_collections` / `get_collection_tree` / `search_requests`.\n   Creating a collection whose name exists is refused on purpose.\n3. Arguments are strict: a misspelled or unknown argument is an error that lists the valid\n   ones \u2014 read it and retry; nothing is silently ignored.\n4. Names work as references everywhere an id does (collection, folder, request, environment,\n   scenario, diagram, workspace). Ambiguous names come back as a candidate list \u2014 pick one.\n5. Preview big writes with `dryRun: true` (bulk create, imports, scenarios, diagrams).\n6. Deletions need `confirm: true` and an exact name or id. Ask the user unless they explicitly\n   requested the deletion.\n\n## Workspaces\nThe token works in EVERY workspace the user belongs to (with their role in each):\n- Lists and searches (`list_collections`, `search_requests`, `list_environments`,\n  `list_connections`, `list_scenarios`) cover all workspaces unless you pass `workspace`;\n  every row says which workspace it is in.\n- A name (collection, request, environment) is looked up in the default workspace first, then\n  in all others; a unique match anywhere is used and the result says where it was found. The\n  same name in several workspaces comes back as candidates tagged with their workspace \u2014 pass\n  `workspace` or the id.\n- Creating needs one target: `workspace`, or the collection it goes into, or the session\n  default. `use_workspace` changes the default for the session (it never hides the others).\n- Environments, connections and global variables belong to one workspace: a request uses the\n  ones of its own workspace.\n\n## Requests\n- Use `{{variable}}` for hosts and secrets (`{{baseUrl}}/users`) and put the values in an\n  environment (`create_environment` / `set_environment_variables`). Use `:id` for path\n  variables. See `callman://docs/request-schema`.\n- get_request returns a request in the same shape create/update take \u2014 read, change, send back.\n- Bodies: a JSON value, a raw string, or `{ mode: raw|formdata|urlencoded|json }`.\n- Database / Kafka / Redis steps and DB assertions are request fields; connections are\n  referenced by id or name (`list_connections`).\n- Contract checks (field rules, data-driven rows) \u2014 `callman://docs/contracts`.\n- Scripts run in a sandbox with the `pm.*` API \u2014 `callman://docs/scripting/pm-api`.\n- `run_request` / `run_collection` execute on the user's machine with real variable values;\n  you only get results and the names of variables scripts changed.\n\n## Secrets\nEnvironment values come back masked (`\u2022\u2022\u2022\u2022ab`) unless the token holds `environments:reveal`\nand you ask for `reveal: true`. Never write a masked environment value back \u2014 it is refused.\nRequest auth secrets and sensitive headers are masked the same way; sending a masked request\nsecret back UNCHANGED keeps the stored one, anything else masked is refused.\n\n## Scenarios\nMulti-step flows as a graph of typed nodes (request, condition, assertion, set-vars, poll,\ndb, kafka, script, wait, end \u2026). Read `callman://docs/scenario-nodes` before building one;\npartial node configs are merged over defaults. Runs happen on the server (`run_scenario`).\n\n## Diagrams\nSystem-design diagrams use a fixed component catalog \u2014 `callman://diagram/components`.\nBuild with `create_diagram` (auto layout), edit with `patch_diagram`, share with\n`share_diagram`. See `callman://docs/diagram-schema`. The user's library has private\nfolders: `list_diagrams` shows the tree as paths (\"Architecture/Payments\"); file a\ndiagram with `folder` on `create_diagram` / `update_diagram`; manage folders with\n`create_diagram_folder`, `update_diagram_folder`, `delete_diagram_folder`.\n\n## After writing\nThe desktop app refreshes when the user switches back to it. Tell the user what you created\nand where (collection / folder names).\n";
+export declare const OVERVIEW_DOC = "# Working with Callman through MCP\n\nCallman is an API client and test platform (collections of HTTP requests, environments,\nmulti-step API test scenarios, UI tests for web / Android / iOS, and diagrams). This\nserver exposes it to you through tools; everything you do goes to the same server the Callman desktop app uses, as the user\nwhose token is configured, limited to that token's permissions and the user's workspace role.\n\n## Start here\n1. `whoami` \u2014 proves the connection and tells you the workspaces, features and which tools\n   this token can use.\n2. Look before you create: `list_collections` / `get_collection_tree` / `search_requests`.\n   Creating a collection whose name exists is refused on purpose.\n3. Arguments are strict: a misspelled or unknown argument is an error that lists the valid\n   ones \u2014 read it and retry; nothing is silently ignored.\n4. Names work as references everywhere an id does (collection, folder, request, environment,\n   scenario, UI test, diagram, workspace). Ambiguous names come back as a candidate list \u2014 pick one.\n5. Preview big writes with `dryRun: true` (bulk create, imports, scenarios, diagrams).\n6. Deletions need `confirm: true` and an exact name or id. Ask the user unless they explicitly\n   requested the deletion.\n\n## Workspaces\nThe token works in EVERY workspace the user belongs to (with their role in each):\n- Lists and searches (`list_collections`, `search_requests`, `list_environments`,\n  `list_connections`, `list_scenarios`) cover all workspaces unless you pass `workspace`;\n  every row says which workspace it is in.\n- A name (collection, request, environment) is looked up in the default workspace first, then\n  in all others; a unique match anywhere is used and the result says where it was found. The\n  same name in several workspaces comes back as candidates tagged with their workspace \u2014 pass\n  `workspace` or the id.\n- Creating needs one target: `workspace`, or the collection it goes into, or the session\n  default. `use_workspace` changes the default for the session (it never hides the others).\n- Environments, connections and global variables belong to one workspace: a request uses the\n  ones of its own workspace.\n\n## Requests\n- Use `{{variable}}` for hosts and secrets (`{{baseUrl}}/users`) and put the values in an\n  environment (`create_environment` / `set_environment_variables`). Use `:id` for path\n  variables. See `callman://docs/request-schema`.\n- get_request returns a request in the same shape create/update take \u2014 read, change, send back.\n- Bodies: a JSON value, a raw string, or `{ mode: raw|formdata|urlencoded|json }`.\n- Database / Kafka / Redis steps and DB assertions are request fields; connections are\n  referenced by id or name (`list_connections`).\n- Contract checks (field rules, data-driven rows) \u2014 `callman://docs/contracts`.\n- Scripts run in a sandbox with the `pm.*` API \u2014 `callman://docs/scripting/pm-api`.\n- `run_request` / `run_collection` execute on the user's machine with real variable values;\n  you only get results and the names of variables scripts changed.\n\n## Secrets\nEnvironment values come back masked (`\u2022\u2022\u2022\u2022ab`) unless the token holds `environments:reveal`\nand you ask for `reveal: true`. Never write a masked environment value back \u2014 it is refused.\nRequest auth secrets and sensitive headers are masked the same way; sending a masked request\nsecret back UNCHANGED keeps the stored one, anything else masked is refused.\n\n## Scenarios\nMulti-step flows as a graph of typed nodes (request, condition, assertion, set-vars, poll,\ndb, kafka, script, wait, end \u2026). Read `callman://docs/scenario-nodes` before building one;\npartial node configs are merged over defaults. Link a shared setup / teardown with a\nscenario-ref node: `config: { scenario: \"<name or id>\" }` \u2014 the server copies it in. Nodes\nwithout a position are placed next to the node they follow, clear of the others.\n- **Where runs happen.** `run_scenario` runs on the Callman server by default, which only\n  reaches what the server's network reaches. For the user's localhost, port-forwards, VPN-only\n  hosts or internal databases use `target: \"desktop\"`: the user's own Callman desktop app runs\n  it (open, signed in, Settings \u2192 AI tools \u2192 \"Let AI tools run scenarios on this computer\").\n- **Reports.** `get_scenario_report` shows server, scheduled, CLI and desktop runs\n  (`triggerType` / `executor`).\n- **Negative checks** (\"this event must NOT be published\", \"this call must be refused\"): give the\n  node `executionPolicy.expectFailure` \u2014 an error edge always ends the run\n  completed_with_failures.\n- **Editing.** `update_scenario` (whole graph) is checked against the version you last read; if\n  the user saved in the desktop meanwhile you get a conflict \u2014 re-read, then retry. Folders:\n  `create_scenario_folder` / `update_scenario_folder` / `delete_scenario_folder`. On-prem\n  review: `submit_scenario`, `review_scenario`, `list_scenario_versions`,\n  `restore_scenario_version`.\n\n## UI tests\nBrowser and mobile-app flows (YAML: header, `---`, steps) \u2014 the desktop app's UI Testing area.\nRead `callman://docs/ui-tests` first and `callman://docs/ui-test-steps` for every step. Flows are\nlinted before they are saved (`validate_ui_test`); edit steps by number with\n`patch_ui_test_steps`. Web flows run on the server runner when there is one; Android, iOS (and\nweb without a runner) run on the user's own Callman desktop app, which must be open with\n\"Let AI tools run UI tests on this computer\" on \u2014 `list_ui_test_devices` shows what is\navailable. Runs return per-step results; screenshots come back as images on request.\n\n## Diagrams\nFour kinds, all built with `create_diagram` (auto layout), edited with `patch_diagram` and\nshared with `share_diagram` \u2014 read `callman://docs/diagram-schema` first:\n- **System design**: nodes from the fixed component catalog `callman://diagram/components`.\n- **BPMN process**: `kind: \"bpmn\"` with bpmn.* nodes, stored as BPMN 2.0 XML.\n- **Mermaid**: `source: { format: \"mermaid\", text }` \u2014 a flowchart becomes nodes, other\n  Mermaid types are kept as source.\n- **Database / ERD**: `kind: \"database\"` with `tables` + `relationships`, or `fromConnection`\n  to read a real database's schema (`introspect_database` reads it without drawing). Edit it\n  with the schema ops (addTable, addColumn, addRelationship \u2026) and read it with view `schema`.\n\nThe user's library has private\nfolders: `list_diagrams` shows the tree as paths (\"Architecture/Payments\"); file a\ndiagram with `folder` on `create_diagram` / `update_diagram`; manage folders with\n`create_diagram_folder`, `update_diagram_folder`, `delete_diagram_folder`.\n\n## After writing\nThe desktop app refreshes when the user switches back to it. Tell the user what you created\nand where (collection / folder names).\n";
 //# sourceMappingURL=overview.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/overview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,k4IAqExB,CAAC"}
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/overview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,m2NAsGxB,CAAC"}

package/dist/resources/docs/overview.js

@@ -1,8 +1,8 @@
 export const OVERVIEW_DOC = `# Working with Callman through MCP
 
 Callman is an API client and test platform (collections of HTTP requests, environments,
-multi-step test scenarios, system-design diagrams). This server exposes it to you through
-tools; everything you do goes to the same server the Callman desktop app uses, as the user
+multi-step API test scenarios, UI tests for web / Android / iOS, and diagrams). This
+server exposes it to you through tools; everything you do goes to the same server the Callman desktop app uses, as the user
 whose token is configured, limited to that token's permissions and the user's workspace role.
 
 ## Start here
@@ -13,7 +13,7 @@ whose token is configured, limited to that token's permissions and the user's wo
 3. Arguments are strict: a misspelled or unknown argument is an error that lists the valid
    ones — read it and retry; nothing is silently ignored.
 4. Names work as references everywhere an id does (collection, folder, request, environment,
-   scenario, diagram, workspace). Ambiguous names come back as a candidate list — pick one.
+   scenario, UI test, diagram, workspace). Ambiguous names come back as a candidate list — pick one.
 5. Preview big writes with \`dryRun: true\` (bulk create, imports, scenarios, diagrams).
 6. Deletions need \`confirm: true\` and an exact name or id. Ask the user unless they explicitly
    requested the deletion.
@@ -54,12 +54,45 @@ secret back UNCHANGED keeps the stored one, anything else masked is refused.
 ## Scenarios
 Multi-step flows as a graph of typed nodes (request, condition, assertion, set-vars, poll,
 db, kafka, script, wait, end …). Read \`callman://docs/scenario-nodes\` before building one;
-partial node configs are merged over defaults. Runs happen on the server (\`run_scenario\`).
+partial node configs are merged over defaults. Link a shared setup / teardown with a
+scenario-ref node: \`config: { scenario: "<name or id>" }\` — the server copies it in. Nodes
+without a position are placed next to the node they follow, clear of the others.
+- **Where runs happen.** \`run_scenario\` runs on the Callman server by default, which only
+  reaches what the server's network reaches. For the user's localhost, port-forwards, VPN-only
+  hosts or internal databases use \`target: "desktop"\`: the user's own Callman desktop app runs
+  it (open, signed in, Settings → AI tools → "Let AI tools run scenarios on this computer").
+- **Reports.** \`get_scenario_report\` shows server, scheduled, CLI and desktop runs
+  (\`triggerType\` / \`executor\`).
+- **Negative checks** ("this event must NOT be published", "this call must be refused"): give the
+  node \`executionPolicy.expectFailure\` — an error edge always ends the run
+  completed_with_failures.
+- **Editing.** \`update_scenario\` (whole graph) is checked against the version you last read; if
+  the user saved in the desktop meanwhile you get a conflict — re-read, then retry. Folders:
+  \`create_scenario_folder\` / \`update_scenario_folder\` / \`delete_scenario_folder\`. On-prem
+  review: \`submit_scenario\`, \`review_scenario\`, \`list_scenario_versions\`,
+  \`restore_scenario_version\`.
+
+## UI tests
+Browser and mobile-app flows (YAML: header, \`---\`, steps) — the desktop app's UI Testing area.
+Read \`callman://docs/ui-tests\` first and \`callman://docs/ui-test-steps\` for every step. Flows are
+linted before they are saved (\`validate_ui_test\`); edit steps by number with
+\`patch_ui_test_steps\`. Web flows run on the server runner when there is one; Android, iOS (and
+web without a runner) run on the user's own Callman desktop app, which must be open with
+"Let AI tools run UI tests on this computer" on — \`list_ui_test_devices\` shows what is
+available. Runs return per-step results; screenshots come back as images on request.
 
 ## Diagrams
-System-design diagrams use a fixed component catalog — \`callman://diagram/components\`.
-Build with \`create_diagram\` (auto layout), edit with \`patch_diagram\`, share with
-\`share_diagram\`. See \`callman://docs/diagram-schema\`. The user's library has private
+Four kinds, all built with \`create_diagram\` (auto layout), edited with \`patch_diagram\` and
+shared with \`share_diagram\` — read \`callman://docs/diagram-schema\` first:
+- **System design**: nodes from the fixed component catalog \`callman://diagram/components\`.
+- **BPMN process**: \`kind: "bpmn"\` with bpmn.* nodes, stored as BPMN 2.0 XML.
+- **Mermaid**: \`source: { format: "mermaid", text }\` — a flowchart becomes nodes, other
+  Mermaid types are kept as source.
+- **Database / ERD**: \`kind: "database"\` with \`tables\` + \`relationships\`, or \`fromConnection\`
+  to read a real database's schema (\`introspect_database\` reads it without drawing). Edit it
+  with the schema ops (addTable, addColumn, addRelationship …) and read it with view \`schema\`.
+
+The user's library has private
 folders: \`list_diagrams\` shows the tree as paths ("Architecture/Payments"); file a
 diagram with \`folder\` on \`create_diagram\` / \`update_diagram\`; manage folders with
 \`create_diagram_folder\`, \`update_diagram_folder\`, \`delete_diagram_folder\`.

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

@@ -1 +1 @@
-{"version":3,"file":"overview.js","sourceRoot":"","sources":["../../../src/resources/docs/overview.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqE3B,CAAC"}
+{"version":3,"file":"overview.js","sourceRoot":"","sources":["../../../src/resources/docs/overview.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsG3B,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare const UI_TESTS_DOC = "# UI tests in Callman\n\nUI tests drive a real web browser or a mobile app step by step \u2014 the same flows QA builds in\nthe desktop app's UI Testing area. Every step (`tapOn`, `inputText`, `assertVisible`,\n`dbQuery` \u2026) with its arguments is in `callman://docs/ui-test-steps`.\n\n## A flow\nA flow is YAML text: an optional **header**, a `---` line, then a **list of steps**.\n\n```yaml\nurl: https://shop.example.com        # web: where the browser starts   (mobile: appId: com.shop.app)\n---\n- runFlow: \"Login\"                   # precondition: another flow, by EXACT name\n- tapOn: \"Catalog\"\n- inputText:\n    id: \"search\"\n    text: \"{{product}}\"              # dataset placeholder\n- assertVisible:\n    text: \"{{product}}\"\n    label: \"Search shows the product\"\n- dbQuery:                           # hybrid data step (runs between UI steps)\n    connection: orders-db            # a workspace connection, by name or id\n    query: \"select status from orders where id = '{{orderId}}'\"\n    expect:\n      - field: \"rows[0].status\"\n        op: equals\n        value: \"PAID\"\n```\n\n- **Platforms**: `web` (Playwright), `android` and `ios` (the mobile engine in the desktop app).\n  A flow has one platform; steps the platform cannot run are lint warnings.\n- **Header**: `url` (web) or `appId` (android/ios) is what matters; `env`, `tags`, `appActivity`,\n  `deviceName`, `onFlowStart`/`onFlowComplete` are optional.\n- **Preconditions / sub-flows**: `- runFlow: \"Name\"` inlines another flow of the library by its\n  exact name (recursively). The leading runFlow lines are the flow's *preconditions*\n  (create_ui_test / update_ui_test `preconditions: [\"Login\"]`). Renaming a flow breaks callers \u2014\n  update_ui_test lists them. Names are unique per workspace.\n- **Labels**: any mapping step may carry `label:` \u2014 its name in reports (patch op `setLabel`).\n\n## Data\n- **dataset**: key \u2192 value, used as `{{key}}` anywhere (header included). Values whose key looks\n  secret (password, token, apiKey, pin, otp \u2026) come back masked (`\u2022\u2022\u2022\u2022ab`) unless the token holds\n  `environments:reveal` and you pass `reveal: true`. Editing a flow without reveal is fine:\n  stored secrets are kept as they are. Never type a masked value yourself \u2014 pass the real value\n  to change a secret, or leave the key out.\n- **datasetSources**: `{ key: { connection, query, column? } }` \u2014 the value comes from a database\n  query at run time (a database connection of the workspace).\n- **Extracted values**: `extract` / `copyTextFrom` / data steps save `{{vars}}` for later steps.\n- **Hybrid steps**: `dbQuery`, `apiCall`, `kafkaPublish`, `kafkaCheck`, `redisCheck`, `runScript`\n  run outside the UI engine, in order. Connections are the workspace's (`list_connections`),\n  referenced by name or id.\n\n## Settings\nPer flow: `browserKind` (chrome / firefox / webkit) and `headless` for web desktop runs;\n`dismissPopups` (texts auto-dismissed) for mobile; `runSettings` { screenshotOnSuccess,\nscreenshotOnFailure, autoRetryTransient, captureNetwork } \u2014 null = the shared default.\n\n## Where runs happen\n- **Server runner** (`target: \"server\"`): web flows only, when the installation runs one.\n  Schedules always use it.\n- **Your desktop app** (`target: \"desktop\"`): the Callman desktop app on the user's computer runs\n  the job \u2014 Android devices/emulators, iOS simulators/devices, local browsers. It must be open,\n  signed in, with **Settings \u2192 AI tools \u2192 \"Let AI tools run UI tests on this computer\"** on.\n  Desktop runs queue one at a time. `device`, `browserKind`, `headless` and a one-off\n  `dataset` override apply here.\n- `target: \"auto\"` (default): web \u2192 server runner when available, otherwise the desktop.\n- `list_ui_test_devices` shows the server runner, the online desktop apps and their devices.\n  `UI_TEST_DESKTOP_OFFLINE` means no desktop app of the user is online.\n\n## Reports\n`run_ui_test` / `get_ui_test_run` return per-step rows (command, status, duration, error, the\nsub-flow it came from), failing steps expanded with the data they returned (DB rows, API\nresponses, extracted vars), dataset issues and warnings. `includeScreenshots: true` adds the\nfailure / final screenshots as images; `includeNetwork: true` the captured API calls.\n`list_ui_test_runs` merges server reports with the history the desktop app recorded itself.\n\n## Schedules\nWeb flows only, on the server runner: daily / weekly / monthly at times (HH:mm) or a cron\nexpression, with retries and notifications. One call can schedule many flows. On-prem,\nschedules run the flow's APPROVED version.\n\n## Review (on-prem)\nEditing a flow makes it a draft. `submit_ui_test` sends it for review; an approver\n`review_ui_test` (approve / reject with a note). Each approval is a version\n(`list_ui_test_versions`, with a diff against the current content); `restore_ui_test_version`\nre-activates an older one. Cloud has no review workflow \u2014 flows run as saved.\n\n## Recommended workflow\n1. `list_ui_test_devices` \u2014 where can it run (server runner? desktop app + devices?).\n2. `list_ui_tests` \u2014 reuse existing flows (Login \u2026) as preconditions instead of copying steps.\n3. Read `callman://docs/ui-test-steps`, draft the steps, then `validate_ui_test` (content +\n   platform) \u2014 or `create_ui_test` with `dryRun: true`.\n4. `create_ui_test` (lint errors refuse the save; warnings are reported).\n5. `run_ui_test` \u2192 read the failing steps; `get_ui_test_run includeScreenshots: true` when a\n   picture helps.\n6. Fix with `patch_ui_test_steps` (insert / replace / remove / move / setLabel by step number\n   from `get_ui_test`) and run again.\n7. Organise with folders (`create_ui_test_folder`, `move_ui_tests`), schedule web flows\n   (`create_ui_test_schedule`), submit for approval on-prem.\n";
+//# sourceMappingURL=uiTests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uiTests.d.ts","sourceRoot":"","sources":["../../../src/resources/docs/uiTests.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,gzLAmGxB,CAAC"}

package/dist/resources/docs/uiTests.js

@@ -0,0 +1,101 @@
+export const UI_TESTS_DOC = `# UI tests in Callman
+
+UI tests drive a real web browser or a mobile app step by step — the same flows QA builds in
+the desktop app's UI Testing area. Every step (\`tapOn\`, \`inputText\`, \`assertVisible\`,
+\`dbQuery\` …) with its arguments is in \`callman://docs/ui-test-steps\`.
+
+## A flow
+A flow is YAML text: an optional **header**, a \`---\` line, then a **list of steps**.
+
+\`\`\`yaml
+url: https://shop.example.com        # web: where the browser starts   (mobile: appId: com.shop.app)
+---
+- runFlow: "Login"                   # precondition: another flow, by EXACT name
+- tapOn: "Catalog"
+- inputText:
+    id: "search"
+    text: "{{product}}"              # dataset placeholder
+- assertVisible:
+    text: "{{product}}"
+    label: "Search shows the product"
+- dbQuery:                           # hybrid data step (runs between UI steps)
+    connection: orders-db            # a workspace connection, by name or id
+    query: "select status from orders where id = '{{orderId}}'"
+    expect:
+      - field: "rows[0].status"
+        op: equals
+        value: "PAID"
+\`\`\`
+
+- **Platforms**: \`web\` (Playwright), \`android\` and \`ios\` (the mobile engine in the desktop app).
+  A flow has one platform; steps the platform cannot run are lint warnings.
+- **Header**: \`url\` (web) or \`appId\` (android/ios) is what matters; \`env\`, \`tags\`, \`appActivity\`,
+  \`deviceName\`, \`onFlowStart\`/\`onFlowComplete\` are optional.
+- **Preconditions / sub-flows**: \`- runFlow: "Name"\` inlines another flow of the library by its
+  exact name (recursively). The leading runFlow lines are the flow's *preconditions*
+  (create_ui_test / update_ui_test \`preconditions: ["Login"]\`). Renaming a flow breaks callers —
+  update_ui_test lists them. Names are unique per workspace.
+- **Labels**: any mapping step may carry \`label:\` — its name in reports (patch op \`setLabel\`).
+
+## Data
+- **dataset**: key → value, used as \`{{key}}\` anywhere (header included). Values whose key looks
+  secret (password, token, apiKey, pin, otp …) come back masked (\`••••ab\`) unless the token holds
+  \`environments:reveal\` and you pass \`reveal: true\`. Editing a flow without reveal is fine:
+  stored secrets are kept as they are. Never type a masked value yourself — pass the real value
+  to change a secret, or leave the key out.
+- **datasetSources**: \`{ key: { connection, query, column? } }\` — the value comes from a database
+  query at run time (a database connection of the workspace).
+- **Extracted values**: \`extract\` / \`copyTextFrom\` / data steps save \`{{vars}}\` for later steps.
+- **Hybrid steps**: \`dbQuery\`, \`apiCall\`, \`kafkaPublish\`, \`kafkaCheck\`, \`redisCheck\`, \`runScript\`
+  run outside the UI engine, in order. Connections are the workspace's (\`list_connections\`),
+  referenced by name or id.
+
+## Settings
+Per flow: \`browserKind\` (chrome / firefox / webkit) and \`headless\` for web desktop runs;
+\`dismissPopups\` (texts auto-dismissed) for mobile; \`runSettings\` { screenshotOnSuccess,
+screenshotOnFailure, autoRetryTransient, captureNetwork } — null = the shared default.
+
+## Where runs happen
+- **Server runner** (\`target: "server"\`): web flows only, when the installation runs one.
+  Schedules always use it.
+- **Your desktop app** (\`target: "desktop"\`): the Callman desktop app on the user's computer runs
+  the job — Android devices/emulators, iOS simulators/devices, local browsers. It must be open,
+  signed in, with **Settings → AI tools → "Let AI tools run UI tests on this computer"** on.
+  Desktop runs queue one at a time. \`device\`, \`browserKind\`, \`headless\` and a one-off
+  \`dataset\` override apply here.
+- \`target: "auto"\` (default): web → server runner when available, otherwise the desktop.
+- \`list_ui_test_devices\` shows the server runner, the online desktop apps and their devices.
+  \`UI_TEST_DESKTOP_OFFLINE\` means no desktop app of the user is online.
+
+## Reports
+\`run_ui_test\` / \`get_ui_test_run\` return per-step rows (command, status, duration, error, the
+sub-flow it came from), failing steps expanded with the data they returned (DB rows, API
+responses, extracted vars), dataset issues and warnings. \`includeScreenshots: true\` adds the
+failure / final screenshots as images; \`includeNetwork: true\` the captured API calls.
+\`list_ui_test_runs\` merges server reports with the history the desktop app recorded itself.
+
+## Schedules
+Web flows only, on the server runner: daily / weekly / monthly at times (HH:mm) or a cron
+expression, with retries and notifications. One call can schedule many flows. On-prem,
+schedules run the flow's APPROVED version.
+
+## Review (on-prem)
+Editing a flow makes it a draft. \`submit_ui_test\` sends it for review; an approver
+\`review_ui_test\` (approve / reject with a note). Each approval is a version
+(\`list_ui_test_versions\`, with a diff against the current content); \`restore_ui_test_version\`
+re-activates an older one. Cloud has no review workflow — flows run as saved.
+
+## Recommended workflow
+1. \`list_ui_test_devices\` — where can it run (server runner? desktop app + devices?).
+2. \`list_ui_tests\` — reuse existing flows (Login …) as preconditions instead of copying steps.
+3. Read \`callman://docs/ui-test-steps\`, draft the steps, then \`validate_ui_test\` (content +
+   platform) — or \`create_ui_test\` with \`dryRun: true\`.
+4. \`create_ui_test\` (lint errors refuse the save; warnings are reported).
+5. \`run_ui_test\` → read the failing steps; \`get_ui_test_run includeScreenshots: true\` when a
+   picture helps.
+6. Fix with \`patch_ui_test_steps\` (insert / replace / remove / move / setLabel by step number
+   from \`get_ui_test\`) and run again.
+7. Organise with folders (\`create_ui_test_folder\`, \`move_ui_tests\`), schedule web flows
+   (\`create_ui_test_schedule\`), submit for approval on-prem.
+`;
+//# sourceMappingURL=uiTests.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uiTests.js","sourceRoot":"","sources":["../../../src/resources/docs/uiTests.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmG3B,CAAC"}

package/dist/resources/generated/aiPacks.d.ts

@@ -1,3 +1,3 @@
-export declare const AI_PACKS_CORE_VERSION = "1.30.0";
+export declare const AI_PACKS_CORE_VERSION = "1.32.0";
 export declare const AI_PACKS: Record<string, string>;
 //# sourceMappingURL=aiPacks.d.ts.map