callman-mcp 0.4.0 → 0.5.0

package/dist-cjs/tools/lookups.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sameName = exports.connectionResolverFor = exports.loadConnections = exports.resolveDiagram = exports.resolveDiagramFolder = exports.diagramFolderPath = exports.diagramFolderRows = exports.loadDiagramFolders = exports.loadDiagrams = exports.resolveScenarioFolder = exports.resolveScenario = exports.loadScenarioCatalog = exports.resolveEnvironment = exports.loadEnvironments = exports.resolveRequest = exports.searchRequests = exports.requestIdsInFolder = exports.resolveFolder = exports.loadTree = exports.resolveCollection = exports.findEnvironment = exports.findRequest = exports.findCollection = exports.findInWorkspaces = exports.workspaceTag = exports.workspacesForListing = exports.isAllWorkspaces = exports.loadCollections = void 0;
+exports.sameName = exports.connectionResolverFor = exports.loadConnections = exports.resolveUiTest = exports.resolveUiTestFolder = exports.uiTestFolderSubtree = exports.loadUiTestFolders = exports.loadUiTests = exports.resolveDiagram = exports.loadDiagrams = exports.resolveScenarioFolder = exports.resolveScenario = exports.loadScenarioCatalog = exports.resolveEnvironment = exports.loadEnvironments = exports.resolveRequest = exports.searchRequests = exports.requestIdsInFolder = exports.resolveFolder = exports.loadTree = exports.resolveCollection = exports.findEnvironment = exports.findRequest = exports.findCollection = exports.findInWorkspaces = exports.workspaceTag = exports.workspacesForListing = exports.isAllWorkspaces = exports.loadCollections = void 0;
 const errors_js_1 = require("../client/errors.js");
 const requestIntegrations_js_1 = require("../domain/requestIntegrations.js");
 const resolve_js_1 = require("../domain/resolve.js");
@@ -240,51 +240,6 @@ const resolveScenarioFolder = async (ctx, ws, ref) => (0, resolve_js_1.resolveRe
 exports.resolveScenarioFolder = resolveScenarioFolder;
 const loadDiagrams = (ctx) => ctx.cache.getOrSet("diagrams", () => ctx.api.listDiagrams());
 exports.loadDiagrams = loadDiagrams;
-// ── diagram folders (the token owner's private library tree) ──────────
-const loadDiagramFolders = (ctx) => ctx.cache.getOrSet("diagram-folders", () => ctx.api.listDiagramFolders());
-exports.loadDiagramFolders = loadDiagramFolders;
-// The tree as rows with paths ("Architecture/Payments"), depth-first,
-// siblings by name — what a model refers to folders by. An older backend
-// without the route yields no rows (every diagram is then at the top level).
-const diagramFolderRows = async (ctx) => {
-    let folders;
-    try {
-        folders = await (0, exports.loadDiagramFolders)(ctx);
-    }
-    catch (error) {
-        if (error instanceof errors_js_1.CallmanApiError && (error.status === 404 || error.status === 403))
-            return [];
-        throw error;
-    }
-    const byName = (a, b) => a.name.localeCompare(b.name, undefined, { numeric: true, sensitivity: "base" }) || a.id.localeCompare(b.id);
-    const out = [];
-    const seen = new Set();
-    const walk = (parentId, prefix, depth) => {
-        for (const folder of folders.filter((entry) => entry.parentId === parentId).sort(byName)) {
-            if (seen.has(folder.id))
-                continue; // a corrupt cycle must not recurse forever
-            seen.add(folder.id);
-            const path = prefix ? `${prefix}/${folder.name}` : folder.name;
-            out.push({ id: folder.id, name: folder.name, parentId: folder.parentId, path, depth });
-            walk(folder.id, path, depth + 1);
-        }
-    };
-    walk(null, "", 0);
-    return out;
-};
-exports.diagramFolderRows = diagramFolderRows;
-const diagramFolderPath = (rows, folderId) => folderId ? (rows.find((row) => row.id === folderId)?.path ?? null) : null;
-exports.diagramFolderPath = diagramFolderPath;
-// A folder by id, exact path, exact name (unique) or unique substring.
-const resolveDiagramFolder = async (ctx, ref, options = {}) => {
-    const rows = await (0, exports.diagramFolderRows)(ctx);
-    return (0, resolve_js_1.resolveRef)("diagram folder", ref, rows, {
-        describe: (folder) => ({ path: folder.path }),
-        aliases: (folder) => [folder.path],
-        exact: options.exact,
-    });
-};
-exports.resolveDiagramFolder = resolveDiagramFolder;
 const resolveDiagram = async (ctx, ref, options = {}) => {
     if ((0, ids_js_1.isObjectId)(ref))
         return { item: await ctx.api.getDiagram(ref), matched: "id" };
@@ -296,6 +251,88 @@ const resolveDiagram = async (ctx, ref, options = {}) => {
     return { ...resolved, item: await ctx.api.getDiagram(resolved.item.id) };
 };
 exports.resolveDiagram = resolveDiagram;
+const loadUiTests = (ctx) => ctx.cache.getOrSet("uitests:list", () => ctx.api.listUiTests(true));
+exports.loadUiTests = loadUiTests;
+const loadUiTestFolders = (ctx) => ctx.cache.getOrSet("uitests:folders", async () => {
+    const raw = await ctx.api.listUiTestFolders();
+    const byId = new Map(raw.map((folder) => [folder.clientId, folder]));
+    const pathOf = (folder) => {
+        const names = [folder.name];
+        const seen = new Set([folder.clientId]);
+        let parent = folder.parentId ? byId.get(folder.parentId) : undefined;
+        while (parent && !seen.has(parent.clientId)) {
+            names.unshift(parent.name);
+            seen.add(parent.clientId);
+            parent = parent.parentId ? byId.get(parent.parentId) : undefined;
+        }
+        return { path: names.join("/"), depth: names.length - 1 };
+    };
+    return raw.map((folder) => ({
+        id: folder.clientId,
+        name: folder.name,
+        parentId: folder.parentId ?? null,
+        ...pathOf(folder),
+        workspaceId: folder.workspaceId,
+        groupId: folder.groupId ?? null,
+        sortOrder: folder.sortOrder ?? 0,
+    }));
+});
+exports.loadUiTestFolders = loadUiTestFolders;
+// Folder ids of `folderId` and every folder below it.
+const uiTestFolderSubtree = (folders, folderId) => {
+    const out = new Set([folderId]);
+    let grew = true;
+    while (grew) {
+        grew = false;
+        for (const folder of folders) {
+            if (folder.parentId && out.has(folder.parentId) && !out.has(folder.id)) {
+                out.add(folder.id);
+                grew = true;
+            }
+        }
+    }
+    return out;
+};
+exports.uiTestFolderSubtree = uiTestFolderSubtree;
+const workspaceFilter = async (ctx, workspace) => workspace && workspace.trim() && !(0, exports.isAllWorkspaces)(workspace) ? ctx.resolveWorkspace(workspace) : null;
+const resolveUiTestFolder = async (ctx, workspace, ref, options = {}) => {
+    const ws = await workspaceFilter(ctx, workspace);
+    const folders = (await (0, exports.loadUiTestFolders)(ctx)).filter((folder) => !ws || folder.workspaceId === ws.id);
+    return (0, resolve_js_1.resolveRef)("UI-test folder", ref, folders, { describe: (folder) => ({ path: folder.path }), aliases: (folder) => [folder.path], exact: options.exact });
+};
+exports.resolveUiTestFolder = resolveUiTestFolder;
+// A flow by clientId or name (unique across the workspaces in scope). The
+// cached list may miss a flow created a moment ago — an unknown ref is tried
+// as a clientId before giving up.
+const resolveUiTest = async (ctx, workspace, ref, options = {}) => {
+    const ws = await workspaceFilter(ctx, workspace);
+    const [flows, workspaces, folders] = await Promise.all([(0, exports.loadUiTests)(ctx), ctx.listWorkspaces(), (0, exports.loadUiTestFolders)(ctx).catch(() => [])]);
+    const workspaceName = new Map(workspaces.map((entry) => [entry.id, entry.name]));
+    const folderPath = new Map(folders.map((folder) => [folder.id, folder.path]));
+    const items = flows.filter((flow) => !ws || flow.workspaceId === ws.id).map((flow) => ({ ...flow, id: flow.clientId }));
+    try {
+        return (0, resolve_js_1.resolveRef)("UI test", ref, items, {
+            describe: (flow) => ({ platform: flow.platform, folder: flow.folderId ? (folderPath.get(flow.folderId) ?? null) : null, ...(workspaces.length > 1 ? { workspace: workspaceName.get(flow.workspaceId) ?? flow.workspaceId } : {}) }),
+            exact: options.exact,
+        });
+    }
+    catch (error) {
+        if (!(error instanceof errors_js_1.ToolInputError) || error.code !== "REF_NOT_FOUND" || /\s/.test(ref.trim()))
+            throw error;
+        try {
+            const fresh = await ctx.api.getUiTest(ref.trim());
+            if (ws && fresh.workspaceId !== ws.id)
+                throw error;
+            return { item: { ...fresh, id: fresh.clientId }, matched: "id" };
+        }
+        catch (lookup) {
+            if (lookup instanceof errors_js_1.CallmanApiError && (lookup.status === 404 || lookup.status === 400))
+                throw error;
+            throw lookup;
+        }
+    }
+};
+exports.resolveUiTest = resolveUiTest;
 const loadConnections = (ctx, ws) => ctx.cache.getOrSet(`connections:${ws}`, () => ctx.api.listConnections(ws));
 exports.loadConnections = loadConnections;
 // Connection resolver for request integration steps — loaded only when a

package/dist-cjs/tools/shared.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireConfirm = exports.dryRunArg = exports.confirmArg = exports.cursorArgs = exports.refArg = exports.workspaceArg = exports.RUN = exports.DESTRUCTIVE = exports.IDEMPOTENT_WRITE = exports.WRITE = exports.READ = exports.guarded = exports.failureOf = exports.toolFailure = exports.ok = void 0;
+exports.requireConfirm = exports.dryRunArg = exports.confirmArg = exports.cursorArgs = exports.refArg = exports.workspaceArg = exports.RUN = exports.DESTRUCTIVE = exports.IDEMPOTENT_WRITE = exports.WRITE = exports.READ = exports.guarded = exports.failureOf = exports.toolFailure = exports.okWithImages = exports.ok = void 0;
 const zod_1 = require("zod");
 const errors_js_1 = require("../client/errors.js");
 const truncate_js_1 = require("../lib/truncate.js");
@@ -17,6 +17,17 @@ const ok = (structured, text) => ({
     structuredContent: structured,
 });
 exports.ok = ok;
+// `ok` plus MCP image blocks (screenshots): the structured result stays JSON,
+// each image follows as { type: "image", data: <base64>, mimeType } preceded
+// by a one-line caption so the model knows which is which.
+const okWithImages = (structured, images) => {
+    const result = (0, exports.ok)(structured);
+    for (const image of images) {
+        result.content.push({ type: "text", text: image.caption }, { type: "image", data: image.data, mimeType: image.mimeType });
+    }
+    return result;
+};
+exports.okWithImages = okWithImages;
 const toolFailure = (error) => {
     let payload;
     if (error instanceof errors_js_1.CallmanApiError) {