@walkeros/mcp 4.0.0 → 4.0.1-next-1778183328892

package/dist/stdio.js

@@ -643,7 +643,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 mcpResult5(result, hints);
@@ -679,7 +679,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.0.1-next-1778183328892";
 var cache;
 function normalizePlatform(platform) {
   if (platform == null) return [];
@@ -1006,7 +1006,7 @@ var inputSchema6 = {
 };
 var outputSchema = {
   version: z6.number().describe("Flow config version"),
-  flows: z6.record(z6.string(), z6.unknown()).describe("Flow definitions")
+  flows: z6.record(z6.string(), z6.unknown()).describe("Flow entries")
 };
 var annotations6 = {
   readOnlyHint: true,
@@ -1121,7 +1121,7 @@ async function feedbackHandlerBody(client, input) {
     const isAnonymous = explicitAnonymous ?? anonymous ?? true;
     await client.submitFeedback(text, {
       anonymous: isAnonymous,
-      version: "4.0.0"
+      version: "4.0.1-next-1778183328892"
     });
     return mcpResult8({ ok: true });
   } catch (error) {
@@ -2153,7 +2153,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 () => ({
@@ -2164,31 +2164,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"
+                          }
                         }
                       }
                     }
@@ -2382,7 +2386,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.",
@@ -2442,54 +2446,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.
 
@@ -2543,7 +2499,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
@@ -2652,7 +2608,6 @@ function createWalkerOSMcpServer(opts) {
   registerAddStepPrompt(server);
   registerSetupMappingPrompt(server);
   registerManageContractPrompt(server);
-  registerUseDefinitionsPrompt(server);
   wrapRegisteredToolsWithTelemetry(server);
   const priorOnInitialized = server.server.oninitialized;
   server.server.oninitialized = () => {
@@ -2800,7 +2755,7 @@ var HttpToolClient = class {
 };
 
 // src/stdio.ts
-setClientContext({ type: "mcp", version: "4.0.0" });
+setClientContext({ type: "mcp", version: "4.0.1-next-1778183328892" });
 process.on("uncaughtException", (err) => {
   const emitter = getMcpEmitterSingleton();
   if (emitter) {
@@ -2820,7 +2775,7 @@ process.on("unhandledRejection", (reason) => {
 async function main() {
   const server = createWalkerOSMcpServer({
     client: new HttpToolClient(),
-    version: "4.0.0"
+    version: "4.0.1-next-1778183328892"
   });
   const transport = new StdioServerTransport();
   await server.connect(transport);
@@ -2830,7 +2785,7 @@ main().catch(async (error) => {
   try {
     const emitter = await createMcpEmitter({
       clientInfo: void 0,
-      packageVersion: "4.0.0"
+      packageVersion: "4.0.1-next-1778183328892"
     });
     await emitter.emitError("startup");
   } catch {