callman-mcp 0.4.0 → 0.5.0

package/dist-cjs/resources/index.js

@@ -8,10 +8,12 @@ const requestShape_js_1 = require("../domain/requestShape.js");
 const summarize_js_2 = require("../domain/scenario/summarize.js");
 const truncate_js_1 = require("../lib/truncate.js");
 const lookups_js_1 = require("../tools/lookups.js");
+const uiTestShared_js_1 = require("../tools/uiTestShared.js");
 const contracts_js_1 = require("./docs/contracts.js");
 const diagramSchema_js_1 = require("./docs/diagramSchema.js");
 const overview_js_1 = require("./docs/overview.js");
 const requestSchema_js_1 = require("./docs/requestSchema.js");
+const uiTests_js_1 = require("./docs/uiTests.js");
 const aiPacks_js_1 = require("./generated/aiPacks.js");
 // Resources: reference material a model reads on demand (schemas, the
 // scripting API, the scenario node reference, the diagram component catalog
@@ -43,6 +45,8 @@ const registerResources = (server, ctx) => {
         { name: "docs-scripting-db-queries", uri: "callman://docs/scripting/db-queries", title: "Scripting: database queries", description: "How pm.db.* queries work per database provider.", body: () => (0, callman_core_1.renderDbQueryReference)() },
         { name: "docs-scripting-templating", uri: "callman://docs/scripting/templating", title: "Templating: {{variables}} and generators", description: "Variable resolution order and dynamic generators ({{$uuid}}, {{$randomInt}} …).", body: () => aiPacks_js_1.AI_PACKS.templating ?? "" },
         { name: "docs-scripting-sandbox", uri: "callman://docs/scripting/sandbox", title: "Scripting: sandbox and feature policy", description: "Globals available in the script sandbox and the feature policy for DB/Kafka capabilities.", body: () => `${aiPacks_js_1.AI_PACKS["sandbox-globals"] ?? ""}\n\n${aiPacks_js_1.AI_PACKS["feature-policy"] ?? ""}` },
+        { name: "docs-ui-tests", uri: "callman://docs/ui-tests", title: "UI tests", description: "UI-test concepts: platforms, header, preconditions and sub-flows, datasets and DB sources, hybrid data steps, settings, where runs happen (server runner vs your desktop app), reports and screenshots, schedules, review, masked secrets, and the recommended workflow.", body: () => uiTests_js_1.UI_TESTS_DOC },
+        { name: "docs-ui-test-steps", uri: "callman://docs/ui-test-steps", title: "UI-test step reference", description: "Every UI-test step (web / Android / iOS / hybrid data steps): aliases, platforms, forms, arguments and an example — generated from callman-core, the same catalog the linter uses.", body: () => (0, callman_core_1.renderUiTestCommandReference)() },
         { name: "docs-diagram-schema", uri: "callman://docs/diagram-schema", title: "Diagram schema", description: "Every node and edge field, styling (colors, borders, fonts), containers, edge semantics and colors, patch operations and merge rules, and the stored DiagramDocument.", body: () => diagramSchema_js_1.DIAGRAM_SCHEMA_DOC },
     ];
     for (const doc of staticDocs) {
@@ -105,6 +109,13 @@ const registerResources = (server, ctx) => {
         const resolved = await (0, lookups_js_1.resolveScenario)(ctx, ws?.id ?? null, variable(variables.scenario));
         return json(uri, { scenario: (0, summarize_js_2.scenarioFullView)(resolved.item) });
     });
+    server.registerResource("ui-test", new mcp_js_1.ResourceTemplate("callman://ui-test/{flow}", { list: undefined }), { title: "A UI test", description: "One UI test (id or name): header, settings, dataset (masked), preconditions, numbered steps, lint result and YAML.", mimeType: "application/json" }, async (uri, variables) => {
+        const resolved = await (0, lookups_js_1.resolveUiTest)(ctx, null, variable(variables.flow));
+        const fresh = await ctx.api.getUiTest(resolved.item.clientId);
+        const context = await (0, uiTestShared_js_1.lintContext)(ctx, fresh.workspaceId);
+        const lint = (0, uiTestShared_js_1.lintFlow)(fresh.content ?? "", fresh.platform, context, [...Object.keys(fresh.dataset ?? {}), ...Object.keys(fresh.datasetSources ?? {})]);
+        return json(uri, { uiTest: await (0, uiTestShared_js_1.flowDetailView)(ctx, fresh, lint, context, { workspaces: await ctx.listWorkspaces() }) });
+    });
     server.registerResource("diagram", new mcp_js_1.ResourceTemplate("callman://diagram/{diagram}", { list: undefined }), { title: "A diagram", description: "One diagram (id or name) as nodes/edges with edge semantics.", mimeType: "application/json" }, async (uri, variables) => {
         const ref = variable(variables.diagram);
         const resolved = await (0, lookups_js_1.resolveDiagram)(ctx, ref);

package/dist-cjs/server.js

@@ -7,8 +7,8 @@ const index_js_1 = require("./prompts/index.js");
 const index_js_2 = require("./resources/index.js");
 const index_js_3 = require("./tools/index.js");
 exports.SERVER_NAME = "callman";
-exports.SERVER_INSTRUCTIONS = `Callman is an API client and test platform: collections of HTTP requests, environments with variables, multi-step test scenarios, and system-design diagrams. You act as the user whose token is configured, within that token's permissions and the user's workspace role.
-Start with whoami. The token works in every workspace the user belongs to: lists and searches cover all of them unless you pass \`workspace\`, names are looked up in the default workspace first and then everywhere, and results say which workspace they come from; creating something needs a target (\`workspace\`, the collection it goes into, or the session default — use_workspace). Names work as references (collection, folder, request, environment, scenario, diagram, workspace); ambiguous names return candidates. List before creating — duplicate collection names are refused. Preview large writes with dryRun: true; deletions need confirm: true and the user's agreement. Environment values are masked unless the token holds environments:reveal and you pass reveal: true; never write a masked value back. Arguments are strict — an unknown key is an error listing the valid ones. Read callman://docs/overview for the conventions, callman://docs/request-schema before creating or editing requests, callman://docs/contracts before contract checks, callman://docs/scenario-nodes before scenarios, and callman://docs/diagram-schema + callman://diagram/components before diagrams.`;
+exports.SERVER_INSTRUCTIONS = `Callman is an API client and test platform: collections of HTTP requests, environments with variables, multi-step API test scenarios, UI tests (web / Android / iOS flows), and system-design diagrams. You act as the user whose token is configured, within that token's permissions and the user's workspace role.
+Start with whoami. The token works in every workspace the user belongs to: lists and searches cover all of them unless you pass \`workspace\`, names are looked up in the default workspace first and then everywhere, and results say which workspace they come from; creating something needs a target (\`workspace\`, the collection it goes into, or the session default — use_workspace). Names work as references (collection, folder, request, environment, scenario, UI test, diagram, workspace); ambiguous names return candidates. List before creating — duplicate collection names are refused. Preview large writes with dryRun: true; deletions need confirm: true and the user's agreement. Environment values are masked unless the token holds environments:reveal and you pass reveal: true; never write a masked value back. Arguments are strict — an unknown key is an error listing the valid ones. Read callman://docs/overview for the conventions, callman://docs/request-schema before creating or editing requests, callman://docs/contracts before contract checks, callman://docs/scenario-nodes before scenarios, callman://docs/ui-tests (+ callman://docs/ui-test-steps) before UI tests — they run on the server runner (web) or the user's own desktop app (list_ui_test_devices), and callman://docs/diagram-schema + callman://diagram/components before diagrams.`;
 const createCallmanMcpServer = (options) => {
     const version = options.version ?? "0.0.0";
     const context = (0, context_js_1.createToolContext)({

package/dist-cjs/tools/catalog.js

@@ -44,8 +44,6 @@ exports.TOOL_CATALOG = [
     { name: "delete_data_contract", group: "contracts", scopes: ["requests:delete"], destructive: true },
     // The safe connection record (no credentials) — readable with either family.
     { name: "list_connections", group: "connections", scopes: ["requests:read", "scenarios:read"], anyOf: true },
-    // The database behind a connection (metadata only) — what a Database Diagram is built from.
-    { name: "introspect_database", group: "connections", scopes: ["requests:read", "scenarios:read", "diagrams:write"], anyOf: true },
     // Documents and new collections → import:write; cURL/.http into an existing
     // collection → requests:write.
     { name: "import_content", group: "import", scopes: ["import:write", "requests:write"], anyOf: true },
@@ -67,6 +65,37 @@ exports.TOOL_CATALOG = [
     { name: "submit_scenario", group: "scenarios", scopes: ["scenarios:write"] },
     { name: "delete_scenario", group: "scenarios", scopes: ["scenarios:delete"], destructive: true },
     { name: "run_scenario", group: "scenarios", scopes: ["scenarios:run"] },
+    // UI tests (web / Android / iOS flows): ui_tests:* scopes. Runs start on the
+    // server runner (web) or the user's desktop app (desktop relay).
+    { name: "list_ui_tests", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "get_ui_test", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "validate_ui_test", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "create_ui_test", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "update_ui_test", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "patch_ui_test_steps", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "delete_ui_test", group: "uiTests", scopes: ["ui_tests:delete"], destructive: true },
+    { name: "list_ui_test_folders", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "create_ui_test_folder", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "update_ui_test_folder", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "delete_ui_test_folder", group: "uiTests", scopes: ["ui_tests:delete"], destructive: true },
+    { name: "move_ui_tests", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "list_ui_test_devices", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "run_ui_test", group: "uiTests", scopes: ["ui_tests:run"] },
+    { name: "run_ui_tests", group: "uiTests", scopes: ["ui_tests:run"] },
+    { name: "get_ui_test_run", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "list_ui_test_runs", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "cancel_ui_test_run", group: "uiTests", scopes: ["ui_tests:run"] },
+    { name: "list_ui_test_schedules", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "create_ui_test_schedule", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "update_ui_test_schedule", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "delete_ui_test_schedule", group: "uiTests", scopes: ["ui_tests:delete"], destructive: true },
+    { name: "run_ui_test_schedule_now", group: "uiTests", scopes: ["ui_tests:run"] },
+    { name: "submit_ui_test", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "review_ui_test", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "list_ui_test_versions", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "restore_ui_test_version", group: "uiTests", scopes: ["ui_tests:write"] },
+    { name: "export_ui_tests", group: "uiTests", scopes: ["ui_tests:read"] },
+    { name: "import_ui_tests", group: "uiTests", scopes: ["ui_tests:write"] },
     { name: "list_diagrams", group: "diagrams", scopes: ["diagrams:read"] },
     { name: "get_diagram", group: "diagrams", scopes: ["diagrams:read"] },
     { name: "create_diagram", group: "diagrams", scopes: ["diagrams:write"] },
@@ -74,9 +103,6 @@ exports.TOOL_CATALOG = [
     { name: "patch_diagram", group: "diagrams", scopes: ["diagrams:write"] },
     { name: "delete_diagram", group: "diagrams", scopes: ["diagrams:delete"], destructive: true },
     { name: "share_diagram", group: "diagrams", scopes: ["diagrams:share"] },
-    { name: "create_diagram_folder", group: "diagrams", scopes: ["diagrams:write"] },
-    { name: "update_diagram_folder", group: "diagrams", scopes: ["diagrams:write"] },
-    { name: "delete_diagram_folder", group: "diagrams", scopes: ["diagrams:delete"], destructive: true },
 ];
 const toolAvailability = (tokenScopes, allowLocalRun) => {
     const held = new Set(tokenScopes);