@walkeros/mcp 4.0.0 → 4.1.0-next-1778155282668

package/dist/index.js

@@ -960,7 +960,7 @@ async function feedbackHandlerBody(client, input) {
     const isAnonymous = explicitAnonymous ?? anonymous ?? true;
     await client.submitFeedback(text, {
       anonymous: isAnonymous,
-      version: "4.0.0"
+      version: "4.1.0-next-1778155282668"
     });
     return mcpResult5({ ok: true });
   } catch (error) {
@@ -1592,7 +1592,7 @@ async function flowExamplesHandlerBody(input) {
     };
     if (examples.length === 0) {
       hints.warnings = [
-        "No examples found. Add examples to step definitions in your flow config for testing."
+        "No examples found. Add examples to step entries in your flow config for testing."
       ];
     }
     return mcpResult10(result, hints);
@@ -1665,7 +1665,7 @@ var inputSchema11 = {
 };
 var outputSchema = {
   version: z10.number().describe("Flow config version"),
-  flows: z10.record(z10.string(), z10.unknown()).describe("Flow definitions")
+  flows: z10.record(z10.string(), z10.unknown()).describe("Flow entries")
 };
 var annotations11 = {
   readOnlyHint: true,
@@ -1741,7 +1741,7 @@ var NPM_SEARCH_URL = "https://registry.npmjs.org/-/v1/search";
 var JSDELIVR_BASE = "https://cdn.jsdelivr.net/npm";
 var WALKEROS_JSON_PATH = "dist/walkerOS.json";
 var CACHE_TTL = 5 * 60 * 1e3;
-var CLIENT_HEADER = "walkeros-mcp/4.0.0";
+var CLIENT_HEADER = "walkeros-mcp/4.1.0-next-1778155282668";
 var cache;
 function normalizePlatform(platform) {
   if (platform == null) return [];
@@ -2150,7 +2150,7 @@ function registerReferenceResources(server) {
     "variables",
     "walkeros://reference/variables",
     {
-      description: "walkerOS variable patterns: $var, $env, $def, $contract, $code, $store, $secret substitution",
+      description: "walkerOS variable patterns: $var, $env, $contract, $code, $store, $secret substitution",
       mimeType: "application/json"
     },
     async () => ({
@@ -2161,31 +2161,35 @@ function registerReferenceResources(server) {
             {
               separatorRule: "`.` for names and paths; `:` for literal values or raw-code payloads.",
               patterns: {
-                "$var.name": "Variable substitution \u2014 cascade: step settings > flow settings > config variables",
-                "$env.NAME": "Environment variable \u2014 $env.GA_ID reads process.env.GA_ID",
-                "$env.NAME:default": "Environment variable with fallback \u2014 $env.GA_ID:G-DEFAULT (the `:` is the literal default separator)",
-                "$def.name": "Definition reference \u2014 reusable config blocks from definitions section",
-                "$def.name.path.deep": "Nested definition access \u2014 $def.ga4Events.purchase",
-                "$contract.name": "Contract reference \u2014 links to named contract for validation",
-                "$contract.name.path": "Nested contract access \u2014 $contract.ecommerce.product",
-                "$code:(expr)": "Inline JavaScript \u2014 $code:(event) => event.data.price * 100 (the `:` carries the raw-code payload)",
-                "$store.storeId": "Store injection in env values \u2014 wires runtime store access",
-                "$secret.NAME": "Secret injection \u2014 resolved server-side at deploy/runtime"
+                "$var.name": "Variable reference. Whole-string preserves native type (object, array, scalar). Inline interpolation requires a scalar. Reusable fragments (mapping templates, matcher lists, consent objects) live in the variables block and are referenced by name.",
+                "$var.name.deep.path": "Deep-path access into a structured variable. Walks nested keys/indices. Whole-string preserves type at the leaf; inline still requires a scalar leaf.",
+                "$env.NAME": "Environment variable. $env.GA_ID reads process.env.GA_ID.",
+                "$env.NAME:default": "Environment variable with fallback. $env.GA_ID:G-DEFAULT (the `:` is the literal default separator).",
+                "$contract.name": "Contract reference. Links to a named contract for validation.",
+                "$contract.name.path": "Nested contract access. $contract.ecommerce.product.",
+                "$code:(expr)": "Inline JavaScript. $code:(event) => event.data.price * 100 (the `:` carries the raw-code payload).",
+                "$store.storeId": "Store injection in env values. Wires runtime store access.",
+                "$secret.NAME": "Secret injection. Resolved server-side at deploy/runtime."
               },
               cascade: {
                 priority: [
-                  "1. Step-level settings (highest)",
-                  "2. Flow-level settings",
+                  "1. Step-level variables (highest)",
+                  "2. Flow-level variables",
                   "3. Config-level variables (lowest)"
                 ],
                 example: {
-                  variables: { apiKey: "default-key" },
+                  variables: {
+                    apiUrl: "https://x.io",
+                    mapping: { id: "data.id" }
+                  },
                   flows: {
                     production: {
                       destinations: {
                         api: {
-                          config: { key: "$var.apiKey" },
-                          settings: { apiKey: "prod-key" }
+                          config: {
+                            url: "$var.apiUrl",
+                            idPath: "$var.mapping.id"
+                          }
                         }
                       }
                     }
@@ -2379,7 +2383,7 @@ function registerSetupMappingPrompt(server) {
               "",
               'Mapping uses nested entity \u2192 action keys. Event "product add" maps to `{ "product": { "add": Rule } }`. Wildcards: `{ "*": { "view": Rule } }`.',
               "",
-              "Use $def references for shared mapping patterns across destinations.",
+              "Extract shared mapping shapes into variables, reference via $var.name (deep paths supported).",
               "",
               "Policy and consent in mapping:",
               "- config.policy runs BEFORE mapping rules \u2014 use it to inject or redact fields on the event.",
@@ -2439,54 +2443,6 @@ function registerManageContractPrompt(server) {
   );
 }
 
-// src/prompts/use-definitions.ts
-import { z as z15 } from "zod";
-function registerUseDefinitionsPrompt(server) {
-  server.registerPrompt(
-    "use-definitions",
-    {
-      description: "Extract shared patterns into definitions and variables for DRY, environment-aware flow configurations.",
-      argsSchema: {
-        flowPath: z15.string().optional().describe("Path to the flow.json file to analyze")
-      }
-    },
-    async ({ flowPath }) => ({
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: [
-              `Help me extract shared patterns into definitions and variables${flowPath ? ` in ${flowPath}` : ""}.`,
-              "",
-              "Follow these steps:",
-              "1. Read the walkeros://reference/variables resource to understand variable syntax.",
-              "2. Analyze the flow config for repeated patterns (same mapping blocks, same config values).",
-              "3. Extract repeated mapping patterns into the `definitions` section with `$def.name` references.",
-              "4. Extract environment-specific values into `variables` with `$var.name` references.",
-              "5. Show the cascade priority: step > settings > config.",
-              "6. Use flow_validate to verify the result.",
-              "",
-              "Variable types:",
-              "- `$var.name` \u2014 variable substitution (cascade: step > settings > config)",
-              "- `$env.NAME` and `$env.NAME:default` \u2014 environment variables",
-              "- `$def.name` and `$def.name.path.deep` \u2014 definition references",
-              "- `$contract.name` \u2014 contract references",
-              "- `$code:(expr)` \u2014 inline JavaScript functions",
-              "- `$store.storeId` \u2014 store injection in env values",
-              "",
-              "Look for:",
-              "- Same API keys or URLs across multiple destinations \u2192 $var or $env",
-              "- Identical mapping rules in multiple destinations \u2192 $def",
-              "- Environment-specific values (dev/staging/prod) \u2192 $var with overrides"
-            ].join("\n")
-          }
-        }
-      ]
-    })
-  );
-}
-
 // src/instructions.ts
 var SERVER_INSTRUCTIONS = `walkerOS is an open-source, privacy-first event data collection platform. Define event pipelines as code using JSON flow configurations.
 
@@ -2540,7 +2496,7 @@ Every component in a flow is a **step**: sources capture events, transformers pr
 
 - **Mapping** transforms events using data/map/loop/set/condition rules. Same syntax on sources and destinations. Mapping rules use NESTED entity \u2192 action keying: event name "product add" maps to \`{ "product": { "add": Rule } }\`. Wildcards: \`{ "*": { "view": Rule } }\`.
 - **Contracts** define event schemas using entity-action keying. Can generate FROM mappings or scaffold mappings FROM contracts.
-- **Variables** ($var, $env, $def, $code, $store) enable DRY, environment-aware config. Use the \`use-definitions\` prompt to extract shared patterns.
+- **Variables** ($var, $env, $code, $store) enable DRY, environment-aware config. Whole-string \`$var.name\` references preserve native type (object/array/scalar); inline interpolation requires a scalar. Deep paths via \`$var.name.deep.path\`.
 - **Consent** gates destinations, mapping rules, and individual fields. Privacy-first by design.
 
 ## Simulation Tips
@@ -2646,7 +2602,6 @@ function createWalkerOSMcpServer(opts) {
   registerAddStepPrompt(server);
   registerSetupMappingPrompt(server);
   registerManageContractPrompt(server);
-  registerUseDefinitionsPrompt(server);
   wrapRegisteredToolsWithTelemetry(server);
   const priorOnInitialized = server.server.oninitialized;
   server.server.oninitialized = () => {
@@ -2815,7 +2770,7 @@ function createStreamableHttpHandler(server, opts = {}) {
 }
 
 // src/tool-definitions.ts
-import { z as z16 } from "zod";
+import { z as z15 } from "zod";
 import { schemas as schemas6 } from "@walkeros/cli/dev";
 var TOOL_DEFINITIONS = [
   {
@@ -2823,8 +2778,8 @@ var TOOL_DEFINITIONS = [
     title: "Authentication",
     description: "Manage walkerOS authentication. Check login status, log in via device code flow, or log out. No terminal or browser required, the MCP client handles the authorization URL.",
     inputSchema: {
-      action: z16.enum(["status", "login", "logout"]),
-      deviceCode: z16.string().optional()
+      action: z15.enum(["status", "login", "logout"]),
+      deviceCode: z15.string().optional()
     },
     annotations: {
       readOnlyHint: false,
@@ -2838,7 +2793,7 @@ var TOOL_DEFINITIONS = [
     title: "Project Management",
     description: "Manage walkerOS projects. List, create, update, delete projects, or set a default project for CLI operations.",
     inputSchema: {
-      action: z16.enum([
+      action: z15.enum([
         "list",
         "get",
         "create",
@@ -2846,8 +2801,8 @@ var TOOL_DEFINITIONS = [
         "delete",
         "set_default"
       ]),
-      projectId: z16.string().optional(),
-      name: z16.string().optional()
+      projectId: z15.string().optional(),
+      name: z15.string().optional()
     },
     annotations: {
       readOnlyHint: false,
@@ -2861,7 +2816,7 @@ var TOOL_DEFINITIONS = [
     title: "Flow Management",
     description: "Manage walkerOS flows and their previews. List/get/create/update/delete/duplicate flows, or create/inspect/delete preview bundles for testing flow changes on live sites.",
     inputSchema: {
-      action: z16.enum([
+      action: z15.enum([
         "list",
         "get",
         "create",
@@ -2873,19 +2828,19 @@ var TOOL_DEFINITIONS = [
         "preview_create",
         "preview_delete"
       ]),
-      flowId: z16.string().optional(),
-      projectId: z16.string().optional(),
-      name: z16.string().optional(),
-      content: z16.record(z16.string(), z16.unknown()).optional(),
-      patch: z16.boolean().optional(),
-      fields: z16.array(z16.string()).optional(),
-      sort: z16.enum(["name", "updated_at", "created_at"]).optional(),
-      order: z16.enum(["asc", "desc"]).optional(),
-      includeDeleted: z16.boolean().optional(),
-      previewId: z16.string().optional(),
-      flowName: z16.string().optional(),
-      flowSettingsId: z16.string().optional(),
-      siteUrl: z16.string().optional()
+      flowId: z15.string().optional(),
+      projectId: z15.string().optional(),
+      name: z15.string().optional(),
+      content: z15.record(z15.string(), z15.unknown()).optional(),
+      patch: z15.boolean().optional(),
+      fields: z15.array(z15.string()).optional(),
+      sort: z15.enum(["name", "updated_at", "created_at"]).optional(),
+      order: z15.enum(["asc", "desc"]).optional(),
+      includeDeleted: z15.boolean().optional(),
+      previewId: z15.string().optional(),
+      flowName: z15.string().optional(),
+      flowSettingsId: z15.string().optional(),
+      siteUrl: z15.string().optional()
     },
     annotations: {
       readOnlyHint: false,
@@ -2899,14 +2854,14 @@ var TOOL_DEFINITIONS = [
     title: "Deploy Management",
     description: "Deploy walkerOS flows and manage deployments. For get/delete actions pass flowId (required) plus optional slug to disambiguate when a flow has multiple active deployments. If a flow has >=2 active deployments and no slug is supplied, the tool returns a MULTIPLE_DEPLOYMENTS error with a details[] list showing each deployment's slug, type, status, and updatedAt.",
     inputSchema: {
-      action: z16.enum(["deploy", "list", "get", "delete"]),
-      projectId: z16.string().optional(),
-      flowId: z16.string().optional(),
-      slug: z16.string().optional(),
-      type: z16.enum(["web", "server"]).optional(),
-      status: z16.string().optional(),
-      wait: z16.boolean().optional(),
-      flowName: z16.string().optional()
+      action: z15.enum(["deploy", "list", "get", "delete"]),
+      projectId: z15.string().optional(),
+      flowId: z15.string().optional(),
+      slug: z15.string().optional(),
+      type: z15.enum(["web", "server"]).optional(),
+      status: z15.string().optional(),
+      wait: z15.boolean().optional(),
+      flowName: z15.string().optional()
     },
     annotations: {
       readOnlyHint: false,
@@ -2933,8 +2888,8 @@ var TOOL_DEFINITIONS = [
     description: "Bundle a walkerOS flow configuration into deployable JavaScript. Resolves all destinations, sources, and transformers, then outputs a tree-shaken production bundle. Returns bundle statistics. Set remote: true to use the walkerOS cloud service instead of local build tools.",
     inputSchema: {
       ...schemas6.BundleInputShape,
-      remote: z16.boolean().optional(),
-      content: z16.record(z16.string(), z16.unknown()).optional()
+      remote: z15.boolean().optional(),
+      content: z15.record(z15.string(), z15.unknown()).optional()
     },
     annotations: {
       readOnlyHint: false,
@@ -2949,11 +2904,11 @@ var TOOL_DEFINITIONS = [
     description: 'Simulate events through a walkerOS flow without making real API calls. For destinations: event is a walkerOS event { name: "entity action", data: {...} }. For sources: event is { content: ..., trigger?: { type?, options? }, env?: {...} }. Use step to target a specific step. Use flow_examples to discover available test data. IMPORTANT: Destinations with require (e.g. require: ["consent"]) stay pending until that collector event fires, simulation will error "not found" if require is not satisfied. Remove require from config or provide consent/user events before simulating. Separately, destinations with consent (e.g. consent: { marketing: true }) only receive events where the event includes matching consent. Mapping transforms event names and data at the destination level. Policy redacts or injects fields before mapping runs.',
     inputSchema: {
       configPath: schemas6.SimulateInputShape.configPath,
-      event: z16.union([z16.record(z16.string(), z16.unknown()), z16.string()]).optional(),
+      event: z15.union([z15.record(z15.string(), z15.unknown()), z15.string()]).optional(),
       flow: schemas6.SimulateInputShape.flow,
       platform: schemas6.SimulateInputShape.platform,
       step: schemas6.SimulateInputShape.step,
-      verbose: z16.boolean().optional()
+      verbose: z15.boolean().optional()
     },
     annotations: {
       readOnlyHint: true,
@@ -2968,7 +2923,7 @@ var TOOL_DEFINITIONS = [
     description: "Push a real event through a walkerOS flow to actual destinations. Makes real API calls to real endpoints. Best suited for server-side flows, web flows should use flow_simulate for testing.",
     inputSchema: {
       configPath: schemas6.PushInputShape.configPath,
-      event: z16.record(z16.string(), z16.unknown()),
+      event: z15.record(z15.string(), z15.unknown()),
       flow: schemas6.PushInputShape.flow,
       platform: schemas6.PushInputShape.platform
     },
@@ -2984,11 +2939,11 @@ var TOOL_DEFINITIONS = [
     title: "Flow Examples",
     description: "List all step examples in a walkerOS flow configuration. Shows example names, step locations, and in/out shapes. Use this to discover available test fixtures and simulation data.",
     inputSchema: {
-      configPath: z16.string().min(1),
-      flow: z16.string().optional(),
-      step: z16.string().optional(),
-      full: z16.boolean().optional(),
-      includeHidden: z16.boolean().optional()
+      configPath: z15.string().min(1),
+      flow: z15.string().optional(),
+      step: z15.string().optional(),
+      full: z15.boolean().optional(),
+      includeHidden: z15.boolean().optional()
     },
     annotations: {
       readOnlyHint: true,
@@ -3002,8 +2957,8 @@ var TOOL_DEFINITIONS = [
     title: "Load or Create Flow",
     description: "Load an existing flow configuration from a local file path, URL, or walkerOS API (by flow ID). Or create a new empty flow by specifying a platform (web or server). Use the add-step prompt to add sources, destinations, transformers, or stores to the flow.",
     inputSchema: {
-      source: z16.string().optional(),
-      platform: z16.enum(["web", "server"]).optional()
+      source: z15.string().optional(),
+      platform: z15.enum(["web", "server"]).optional()
     },
     annotations: {
       readOnlyHint: true,
@@ -3017,10 +2972,10 @@ var TOOL_DEFINITIONS = [
     title: "Search Package",
     description: "Start here for package discovery. Never guess package names, use this tool first to find exact names. Without package name: returns catalog filtered by type/platform. With package name: returns metadata, hint keys, and example summaries.",
     inputSchema: {
-      package: z16.string().min(1).optional(),
-      type: z16.enum(["source", "destination", "transformer", "store"]).optional(),
-      platform: z16.enum(["web", "server"]).optional(),
-      version: z16.string().optional()
+      package: z15.string().min(1).optional(),
+      type: z15.enum(["source", "destination", "transformer", "store"]).optional(),
+      platform: z15.enum(["web", "server"]).optional(),
+      version: z15.string().optional()
     },
     annotations: {
       readOnlyHint: true,
@@ -3034,9 +2989,9 @@ var TOOL_DEFINITIONS = [
     title: "Get Package",
     description: 'Requires exact package name, do not guess names, use package_search first to find them. Returns schemas + hint texts + example summaries by default (lightweight). Use section parameter for full content: "hints" (with code blocks), "examples" (full in/out data), or "all".',
     inputSchema: {
-      package: z16.string().min(1),
-      version: z16.string().optional(),
-      section: z16.enum(["hints", "examples", "all"]).optional()
+      package: z15.string().min(1),
+      version: z15.string().optional(),
+      section: z15.enum(["hints", "examples", "all"]).optional()
     },
     annotations: {
       readOnlyHint: true,
@@ -3050,8 +3005,8 @@ var TOOL_DEFINITIONS = [
     title: "Send Feedback",
     description: "Send feedback about walkerOS",
     inputSchema: {
-      text: z16.string(),
-      anonymous: z16.boolean().optional()
+      text: z15.string(),
+      anonymous: z15.boolean().optional()
     },
     annotations: {
       readOnlyHint: false,