@cplace/mcp-server 1.6.2 → 1.7.0

package/dist/tools/wizards.d.ts

@@ -0,0 +1,148 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const WIZARD_TOOL_DEFINITIONS: {
+    readonly cplace_manage_wizard: {
+        readonly description: "Create or update a Forms Wizard configuration. Wizards define multi-step guided workflows for data entry and process automation. Use 'create' to define a new wizard with display names, target workspaces, and behavior options. Use 'update' to modify an existing wizard's properties.";
+        readonly inputSchema: {
+            readonly operation: z.ZodEnum<["create", "update"]>;
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+            readonly localizedDisplayNames: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            readonly description: z.ZodOptional<z.ZodString>;
+            readonly targetWorkspaces: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            readonly triggeringTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            readonly autoPersist: z.ZodOptional<z.ZodBoolean>;
+            readonly refreshAfterFinish: z.ZodOptional<z.ZodBoolean>;
+            readonly showProgressBar: z.ZodOptional<z.ZodBoolean>;
+            readonly showPercent: z.ZodOptional<z.ZodBoolean>;
+        };
+        readonly annotations: {
+            readonly title: "Manage Wizard";
+        };
+    };
+    readonly cplace_manage_wizard_step: {
+        readonly description: "Create or update a wizard step. Steps are the individual screens in a wizard flow. Each step has a type (form, info, table, decision, script) that determines its behavior and configuration options. Step type is immutable after creation.";
+        readonly inputSchema: {
+            readonly operation: z.ZodEnum<["create", "update"]>;
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+            readonly identifier: z.ZodString;
+            readonly stepType: z.ZodOptional<z.ZodEnum<["form", "info", "table", "decision", "script"]>>;
+            readonly title: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            readonly description: z.ZodOptional<z.ZodString>;
+            readonly targetTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            readonly formAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        };
+        readonly annotations: {
+            readonly title: "Manage Wizard Step";
+        };
+    };
+    readonly cplace_delete_wizard: {
+        readonly description: "Delete a wizard and optionally all its child steps. By default, cascade-deletes all steps. Set cascadeDeleteSteps to false to delete only the wizard page.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+            readonly cascadeDeleteSteps: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        };
+        readonly annotations: {
+            readonly title: "Delete Wizard";
+        };
+    };
+    readonly cplace_delete_wizard_step: {
+        readonly description: "Delete a single wizard step by its identifier. The step is removed from the wizard; any flow references to this step should be updated separately.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+            readonly identifier: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Delete Wizard Step";
+        };
+    };
+    readonly cplace_configure_wizard_flow: {
+        readonly description: "Configure the complete step flow graph for a wizard in a single call. Sets the start step, final steps, optional summary/cleanup steps, and all step-to-step connections. All referenced step identifiers must already exist.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+            readonly startStep: z.ZodString;
+            readonly finalSteps: z.ZodArray<z.ZodString, "many">;
+            readonly summaryStep: z.ZodOptional<z.ZodString>;
+            readonly cleanupScriptStep: z.ZodOptional<z.ZodString>;
+            readonly stepConnections: z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                nextSteps: z.ZodArray<z.ZodString, "many">;
+                skipTo: z.ZodOptional<z.ZodString>;
+                skipToFinish: z.ZodOptional<z.ZodBoolean>;
+                skipToLabel: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                from: string;
+                nextSteps: string[];
+                skipTo?: string | undefined;
+                skipToFinish?: boolean | undefined;
+                skipToLabel?: Record<string, string> | undefined;
+            }, {
+                from: string;
+                nextSteps: string[];
+                skipTo?: string | undefined;
+                skipToFinish?: boolean | undefined;
+                skipToLabel?: Record<string, string> | undefined;
+            }>, "many">;
+        };
+        readonly annotations: {
+            readonly title: "Configure Wizard Flow";
+        };
+    };
+    readonly cplace_activate_wizard: {
+        readonly description: "Activate or deactivate a wizard. On activation, runs the server-side analysis check (validates start step, final steps, step reachability, etc.). If activation fails, automatically runs analysis and returns detailed error information.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+            readonly activationState: z.ZodOptional<z.ZodEnum<["ACTIVE", "INACTIVE"]>>;
+        };
+        readonly annotations: {
+            readonly title: "Activate Wizard";
+        };
+    };
+    readonly cplace_get_wizard_details: {
+        readonly description: "Get detailed information about a wizard including all its steps, flow configuration, and activation state. Returns structured wizard-domain data with step identifiers, types, and connections.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Get Wizard Details";
+        };
+    };
+    readonly cplace_list_wizards: {
+        readonly description: "List all wizards in a workspace. Returns wizard names, display names, and basic configuration summary.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "List Wizards";
+        };
+    };
+    readonly cplace_analyze_wizard: {
+        readonly description: "Run the wizard analysis checks without changing activation state. Returns results from all wizard-level analyzers (start step, step reachability, final steps, leaf nodes, skip configuration, external access) plus per-step type-specific analysis. Use this to validate wizard configuration before activation or to debug why activation fails.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Analyze Wizard Configuration";
+        };
+    };
+    readonly cplace_get_wizard_activation_state: {
+        readonly description: "Get the current activation state of a wizard without changing it. Returns whether the wizard is ACTIVE or INACTIVE, and whether the state can be changed. Use this for pre-flight checks before activation, or to monitor wizard states across workspaces.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly wizardName: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Get Wizard Activation State";
+        };
+    };
+};
+export declare function registerWizardTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=wizards.d.ts.map

package/dist/tools/wizards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizards.d.ts","sourceRoot":"","sources":["../../src/tools/wizards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAmS5C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+G1B,CAAC;AAIX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA+jB7E"}