callman-mcp 0.4.0 → 0.5.0

package/dist/domain/uiTest/summarize.d.ts

@@ -0,0 +1,273 @@
+import type { UiTestFlow, UiTestResultRow, UiTestRunReport, UiTestSchedule } from "../../client/types.js";
+export declare const flowSummaryView: (flow: UiTestFlow, folderPath?: string | null) => {
+    updatedAt: string | null;
+    group?: string | undefined;
+    activeVersionNumber?: number | undefined;
+    reviewStatus?: import("../../client/types.js").ScenarioReviewStatus | undefined;
+    folder: string | null;
+    tags: string[];
+    testType: string | null;
+    severity: string | null;
+    version: number | null;
+    description?: string | undefined;
+    id: string;
+    name: string;
+    platform: import("../../client/types.js").UiTestPlatform;
+};
+export declare const maskedDatasetKeys: (dataset: Record<string, string> | undefined | null) => string[];
+export declare const settingsView: (flow: UiTestFlow) => {
+    runSettings: import("callman-core").UiTestRunSettings;
+    browserKind: import("../../client/types.js").UiTestBrowserKind | null;
+    headless: boolean | null;
+} | {
+    runSettings: import("callman-core").UiTestRunSettings;
+    dismissPopups: string[];
+};
+export declare const runReportView: (report: UiTestRunReport, options?: {
+    includeNetwork?: boolean;
+    allStepData?: boolean;
+}) => {
+    fromApprovedSnapshot?: boolean | undefined;
+    flowVersionNumber?: number | null | undefined;
+    networkTruncated?: boolean | undefined;
+    network: string | null;
+    screenshots: {
+        failure: boolean;
+        final: boolean;
+    };
+    warnings?: string[] | undefined;
+    datasetIssues?: string[] | undefined;
+    stepData?: {
+        dataTruncated?: boolean | undefined;
+        extracted?: string | null | undefined;
+        data?: string | null | undefined;
+        note?: string | undefined;
+        source?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        error: string | null;
+    }[] | undefined;
+    failedSteps?: {
+        dataTruncated?: boolean | undefined;
+        extracted?: string | null | undefined;
+        data?: string | null | undefined;
+        note?: string | undefined;
+        source?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        error: string | null;
+    }[] | undefined;
+    stepsTruncated?: number | undefined;
+    stepCounts: Record<string, number>;
+    steps: {
+        retries?: number | undefined;
+        healed?: string | undefined;
+        source?: string | undefined;
+        error?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        durationMs: number | null;
+    }[];
+    error?: string | undefined;
+    startedAt: string | null;
+    finishedAt: string | null;
+    durationMs: number | null;
+    schedule?: string | undefined;
+    triggerType: string | null;
+    device?: string | null | undefined;
+    platform?: import("../../client/types.js").UiTestPlatform | undefined;
+    executor?: "server" | "desktop" | undefined;
+    reportId: string;
+    flow: {
+        id: string;
+        name: string;
+    };
+    status: import("../../client/types.js").UiTestRunStatus;
+} | {
+    fromApprovedSnapshot?: boolean | undefined;
+    flowVersionNumber?: number | null | undefined;
+    networkEvents: number | undefined;
+    screenshots: {
+        failure: boolean;
+        final: boolean;
+    };
+    warnings?: string[] | undefined;
+    datasetIssues?: string[] | undefined;
+    stepData?: {
+        dataTruncated?: boolean | undefined;
+        extracted?: string | null | undefined;
+        data?: string | null | undefined;
+        note?: string | undefined;
+        source?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        error: string | null;
+    }[] | undefined;
+    failedSteps?: {
+        dataTruncated?: boolean | undefined;
+        extracted?: string | null | undefined;
+        data?: string | null | undefined;
+        note?: string | undefined;
+        source?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        error: string | null;
+    }[] | undefined;
+    stepsTruncated?: number | undefined;
+    stepCounts: Record<string, number>;
+    steps: {
+        retries?: number | undefined;
+        healed?: string | undefined;
+        source?: string | undefined;
+        error?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        durationMs: number | null;
+    }[];
+    error?: string | undefined;
+    startedAt: string | null;
+    finishedAt: string | null;
+    durationMs: number | null;
+    schedule?: string | undefined;
+    triggerType: string | null;
+    device?: string | null | undefined;
+    platform?: import("../../client/types.js").UiTestPlatform | undefined;
+    executor?: "server" | "desktop" | undefined;
+    reportId: string;
+    flow: {
+        id: string;
+        name: string;
+    };
+    status: import("../../client/types.js").UiTestRunStatus;
+} | {
+    fromApprovedSnapshot?: boolean | undefined;
+    flowVersionNumber?: number | null | undefined;
+    screenshots: {
+        failure: boolean;
+        final: boolean;
+    };
+    warnings?: string[] | undefined;
+    datasetIssues?: string[] | undefined;
+    stepData?: {
+        dataTruncated?: boolean | undefined;
+        extracted?: string | null | undefined;
+        data?: string | null | undefined;
+        note?: string | undefined;
+        source?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        error: string | null;
+    }[] | undefined;
+    failedSteps?: {
+        dataTruncated?: boolean | undefined;
+        extracted?: string | null | undefined;
+        data?: string | null | undefined;
+        note?: string | undefined;
+        source?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        error: string | null;
+    }[] | undefined;
+    stepsTruncated?: number | undefined;
+    stepCounts: Record<string, number>;
+    steps: {
+        retries?: number | undefined;
+        healed?: string | undefined;
+        source?: string | undefined;
+        error?: string | undefined;
+        index: number;
+        command: string;
+        status: string;
+        durationMs: number | null;
+    }[];
+    error?: string | undefined;
+    startedAt: string | null;
+    finishedAt: string | null;
+    durationMs: number | null;
+    schedule?: string | undefined;
+    triggerType: string | null;
+    device?: string | null | undefined;
+    platform?: import("../../client/types.js").UiTestPlatform | undefined;
+    executor?: "server" | "desktop" | undefined;
+    reportId: string;
+    flow: {
+        id: string;
+        name: string;
+    };
+    status: import("../../client/types.js").UiTestRunStatus;
+};
+export declare const runListRow: (report: UiTestRunReport) => {
+    failedStep?: {
+        index: number;
+        command: string;
+    } | null | undefined;
+    error?: string | undefined;
+    triggerType: string | null;
+    startedAt: string | null;
+    durationMs: number | null;
+    executor?: "server" | "desktop" | undefined;
+    reportId: string;
+    flow: {
+        id: string;
+        name: string;
+    };
+    status: import("../../client/types.js").UiTestRunStatus;
+};
+export declare const historyRow: (row: UiTestResultRow) => {
+    reportId?: string | undefined;
+    error?: string | undefined;
+    startedAt: string | null;
+    durationMs: number | null;
+    device?: string | undefined;
+    flow: {
+        id: string;
+        name: string;
+    };
+    status: "failed" | "stopped" | "passed";
+    source: string;
+    platform: import("../../client/types.js").UiTestPlatform;
+};
+export declare const scheduleView: (schedule: UiTestSchedule) => {
+    isRunning?: boolean | undefined;
+    lastRunAt: string | null;
+    lastRunStatus: string | null;
+    nextRunAt: string | null;
+    notificationConfig?: Record<string, unknown> | undefined;
+    failurePolicy?: Record<string, unknown> | undefined;
+    executionPolicy?: Record<string, unknown> | undefined;
+    description?: string | undefined;
+    customCronExpression?: string | undefined;
+    monthlyConfig?: {
+        daysOfMonth: number[];
+        times: string[];
+    } | undefined;
+    weeklyConfig?: {
+        daysOfWeek: number[];
+        times: string[];
+    } | undefined;
+    dailyConfig?: {
+        times: string[];
+    } | undefined;
+    id: string;
+    name: string;
+    flow: {
+        id: string;
+        name: string;
+    };
+    enabled: boolean;
+    triggerType: "daily" | "weekly" | "monthly" | "custom_cron";
+    timezone: string;
+};
+export declare const imageFromDataUrl: (dataUrl: string | null | undefined) => {
+    data: string;
+    mimeType: string;
+} | null;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/domain/uiTest/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/domain/uiTest/summarize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAiB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAczH,eAAO,MAAM,eAAe,GAAI,MAAM,UAAU,EAAE,aAAa,MAAM,GAAG,IAAI;;;;;;;;;;;;;;CAc1E,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI,KAAG,MAAM,EACH,CAAC;AAE3F,eAAO,MAAM,YAAY,GAAI,MAAM,UAAU;;;;;;;CAG3C,CAAC;AA6BH,eAAO,MAAM,aAAa,GAAI,QAAQ,eAAe,EAAE,UAAS;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCvH,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,eAAe;;;;;;;;;;;;;;;;CAahD,CAAC;AAEH,eAAO,MAAM,UAAU,GAAI,KAAK,eAAe;;;;;;;;;;;;;CAU7C,CAAC;AAEH,eAAO,MAAM,YAAY,GAAI,UAAU,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBnD,CAAC;AAGH,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAI1G,CAAC"}

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,2 @@
-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\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## 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\"; 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";
 //# 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":"AAAA,eAAO,MAAM,kBAAkB,iuXA+K9B,CAAC"}

package/dist/resources/docs/diagramSchema.js

@@ -154,38 +154,6 @@ same vocabulary the desktop's AI assistant uses — one implementation (callman-
   elements, annotations and the modeler's formatting stay untouched. \`get_diagram\` view \`source\`
   returns the XML; view \`graph\` shows the derived nodes/edges with their \`bpmn\` facts.
 
-## Database diagrams (ERD)
-- A database diagram keeps its truth in a JSON database model (\`source.format: "database"\`):
-  tables (\`entities\`) with columns, keys, indexes and comments, and relationships between them;
-  the nodes on the canvas hold only positions and visibility. The desktop opens it on an ERD
-  canvas; \`get_diagram\` view \`schema\` shows tables with their columns and the relationships as
-  \`table.column\` pairs — read it before editing.
-- Create one with \`create_diagram\`: \`tables\` + \`relationships\` (\`{ name, schema?, columns:
-  [{ name, dataType, primaryKey?, nullable?, unique?, defaultValue?, comment? }] }\` and
-  \`{ source: "orders.user_id", target: "users.id", cardinality: "N:1" }\` — source is the child /
-  foreign-key side), or nodes typed db.table / db.view / db.collection with the columns in
-  \`data.db.columns\`, or \`fromConnection\` to read a real database through one of the
-  workspace's connections (\`introspect_database\` reads the same schema without drawing it).
-- Edit with the schema ops of \`patch_diagram\`:
-\`\`\`jsonc
-{ "op": "addTable", "table": { "name": "payments", "columns": [{ "name": "id", "dataType": "uuid", "primaryKey": true }, { "name": "order_id", "dataType": "bigint" }, { "name": "amount", "dataType": "numeric(12,2)" }] } }
-{ "op": "addColumn", "table": "users", "column": { "name": "profile_id", "dataType": "uuid", "nullable": true }, "after": "id" }
-{ "op": "alterColumn", "table": "users", "column": "email", "changes": { "unique": true, "nullable": false } }
-{ "op": "removeColumn", "table": "users", "column": "nickname" }
-{ "op": "setPrimaryKey", "table": "order_items", "columns": ["order_id", "line"] }
-{ "op": "renameTable", "table": "users", "name": "accounts", "schema": "auth" }
-{ "op": "setTableComment", "table": "users", "comment": "People who can sign in" }
-{ "op": "addRelationship", "source": "payments.order_id", "target": "orders.id", "cardinality": "N:1" }
-{ "op": "updateRelationship", "relationship": "fk-payments-orders", "changes": { "cardinality": "1:1", "label": "settles" } }
-{ "op": "removeRelationship", "relationship": "fk-payments-orders" }
-{ "op": "removeTable", "table": "audit_log" }                                   // its relationships go with it
-{ "op": "hideTable", "table": "migrations" }                                    // canvas only; showTable brings it back
-\`\`\`
-  Tables are named (\`users\`, \`public.users\`), columns as \`table.column\`; ids stay stable
-  across renames. New tables are placed to the right of the existing ones (or laid out with
-  \`relayout: "all"\`). moveNode, hideTable/showTable and setCanvas change the canvas only;
-  group / ungroup / reparent do not apply.
-
 ## Stored document (get_diagram view: "full")
 \`\`\`ts
 interface DiagramDocument {
@@ -198,7 +166,7 @@ interface DiagramDocument {
            locked?; hidden?; collapsed?; collapsedSize?; style?: DiagramStyle; data? }[];
   edges: { id; source?; target?; label?; labelPosition?; routing?; sourceHandle?; targetHandle?;
            style?: DiagramStyle; markerStart?; markerEnd?; waypoints? }[];
-  source?: { format: "mermaid" | "bpmn" | "database"; text; diagramType; grammar?; valid? };
+  source?: { format: "mermaid"; text; diagramType; grammar?; valid? };
 }
 // Stored colors are { raw: "#3B82F6" } (or a theme { token }); bold/italic/underline are
 // the bitmask fontStyle (1 | 2 | 4). The tools convert both ways — write plain colors.

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,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+KjC,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, system-design 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. Runs happen on the server (`run_scenario`).\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\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`.\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