@walkeros/mcp 4.1.0-next-1778668930820 → 4.1.0

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.1.0-next-1778668930820"
+      version: "4.1.0"
     });
     return mcpResult5({ ok: true });
   } catch (error) {
@@ -984,7 +984,7 @@ function registerFeedbackTool(server, client) {
 }
 
 // src/tools/validate.ts
-import { validate } from "@walkeros/cli";
+import { validate, loadJsonConfig } from "@walkeros/cli";
 import { schemas } from "@walkeros/cli/dev";
 import { mcpResult as mcpResult6, mcpError as mcpError6 } from "@walkeros/core";
 
@@ -1077,6 +1077,34 @@ var ExamplesListOutputShape = {
 };
 
 // src/tools/validate.ts
+var DEPRECATED_STORE_PACKAGE = "@walkeros/store-memory";
+function detectDeprecatedStorePackages(config) {
+  const errors = [];
+  if (!config || typeof config !== "object") return errors;
+  const flows = config.flows;
+  if (!flows || typeof flows !== "object") return errors;
+  for (const [flowName, flowEntry] of Object.entries(
+    flows
+  )) {
+    if (!flowEntry || typeof flowEntry !== "object") continue;
+    const stores = flowEntry.stores;
+    if (!stores || typeof stores !== "object") continue;
+    for (const [storeId, storeEntry] of Object.entries(
+      stores
+    )) {
+      if (!storeEntry || typeof storeEntry !== "object") continue;
+      const pkg = storeEntry.package;
+      if (pkg === DEPRECATED_STORE_PACKAGE) {
+        errors.push({
+          path: `flows.${flowName}.stores.${storeId}`,
+          message: `Store "${storeId}" uses ${DEPRECATED_STORE_PACKAGE}, which has been removed. Use the built-in cache by omitting cache.store, or remove the store declaration if it was only used as a cache target.`,
+          code: "DEPRECATED_PACKAGE"
+        });
+      }
+    }
+  }
+  return errors;
+}
 function wrapIssueMessages(result) {
   return {
     ...result,
@@ -1121,7 +1149,22 @@ async function flowValidateHandlerBody(input) {
       flow,
       path
     });
-    const hints = result.valid ? {
+    let augmented = result;
+    if (type === "flow" && typeof validateInput === "string") {
+      try {
+        const config = await loadJsonConfig(validateInput);
+        const deprecatedErrors = detectDeprecatedStorePackages(config);
+        if (deprecatedErrors.length > 0) {
+          augmented = {
+            ...result,
+            valid: false,
+            errors: [...result.errors, ...deprecatedErrors]
+          };
+        }
+      } catch {
+      }
+    }
+    const hints = augmented.valid ? {
       next: [
         "Use flow_simulate to test event flow",
         "Use flow_bundle to build"
@@ -1132,7 +1175,7 @@ async function flowValidateHandlerBody(input) {
         "Read walkeros://reference/flow-schema for correct structure"
       ]
     };
-    return mcpResult6(wrapIssueMessages(result), hints);
+    return mcpResult6(wrapIssueMessages(augmented), hints);
   } catch (error) {
     return mcpError6(
       error,
@@ -1499,7 +1542,7 @@ function registerFlowPushTool(server) {
 
 // src/tools/examples.ts
 import { z as z9 } from "zod";
-import { loadJsonConfig } from "@walkeros/cli";
+import { loadJsonConfig as loadJsonConfig2 } from "@walkeros/cli";
 import { mcpResult as mcpResult10, mcpError as mcpError10 } from "@walkeros/core";
 var TITLE10 = "Flow Examples";
 var DESCRIPTION10 = "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.";
@@ -1533,7 +1576,7 @@ function createFlowExamplesToolSpec() {
 async function flowExamplesHandlerBody(input) {
   const { configPath, flow, step, full, includeHidden } = input ?? {};
   try {
-    const rawConfig = await loadJsonConfig(configPath);
+    const rawConfig = await loadJsonConfig2(configPath);
     const flowNames = Object.keys(rawConfig.flows || {});
     const flowName = flow || (flowNames.length === 1 ? flowNames[0] : void 0);
     if (!flowName) {
@@ -1620,7 +1663,7 @@ function registerFlowExamplesTool(server) {
 
 // src/tools/flow-load.ts
 import { z as z10 } from "zod";
-import { loadJsonConfig as loadJsonConfig2 } from "@walkeros/cli";
+import { loadJsonConfig as loadJsonConfig3 } from "@walkeros/cli";
 import { mcpResult as mcpResult11, mcpError as mcpError11 } from "@walkeros/core";
 var KEEP_LITERAL2 = /* @__PURE__ */ new Set([
   "id",
@@ -1687,7 +1730,7 @@ async function flowLoadHandlerBody(input) {
   const { source, platform } = input ?? {};
   try {
     if (source) {
-      const config = await loadJsonConfig2(source);
+      const config = await loadJsonConfig3(source);
       return mcpResult11(redactNestedStrings(config, { skip: keepLiteral2 }), {
         next: ["Use flow_validate to check", "Use add-step prompt to modify"]
       });
@@ -1741,7 +1784,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.1.0-next-1778668930820";
+var CLIENT_HEADER = "walkeros-mcp/4.1.0";
 var cache;
 function normalizePlatform(platform) {
   if (platform == null) return [];
@@ -2341,7 +2384,7 @@ function registerAddStepPrompt(server) {
               "- Read the walkeros://reference/flow-schema resource to understand connection rules.",
               "- Sources connect to pre-collector transformers via `next`.",
               "- Destinations connect to post-collector transformers via `before`.",
-              '- Routing supports string IDs, sequences (`["a", "b"]`), or RouteConfig (`{ match?, next }` for gated single-target or `{ match?, case: [...] }` for first-match dispatch). Omit `match` for always-match.',
+              '- Routing supports string IDs, sequences (`["a", "b"]`), or RouteConfig (`{ match?, next }` for gated single-target or `{ match?, one: [...] }` for first-match dispatch). Use `many` (instead of `one`) when every matching entry should run as an independent parallel flow \u2014 restricted to pre-collector positions. Omit `match` for always-match.',
               "- A transformer entry can be code-bearing (`code`), package-bearing (`package`), or a **pass-through step** (no `code`, no `package`). Pass-through synthesis is automatic at runtime. Three flavors of pass-through: `before`/`next`-only (named hop reusable across destinations), `cache`-only (dedup, rate-limit), or `mapping`-only (declarative event-to-event transform). A pass-through must declare at least one of `before`, `next`, `cache`, or `mapping`.",
               "- The `mapping` field on a transformer step uses the same `Mapping.Config` shape as destinations, but the semantic is event-to-event (mutates the event in place via `policy`, per-rule `policy`, `mapping[].name` for renames, `mapping[].ignore` to drop). Vendor-payload fields (`data`, `silent`) are no-ops at this position.",
               "- Closed schema: unknown top-level keys on a transformer step are errors (catches typos like `dedup` instead of `cache`). `code` + `package` together is a conflict.",
@@ -2502,7 +2545,7 @@ Every component in a flow is a **step**: sources capture events, transformers pr
 - **Contracts** define event schemas using entity-action keying. Can generate FROM mappings or scaffold mappings FROM contracts.
 - **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.
-- **Routing** wires steps via \`next\` (pre-collector) and \`before\` (post-collector). A route is a string ID, a sequence (\`["a", "b"]\`), or a RouteConfig (\`{ match?, next }\` or \`{ match?, case: [...] }\`). The \`case\` operator dispatches first-match against an ordered list. The optional \`match\` field is omitted to mean always-match (no wildcard literal).
+- **Routing** wires steps via \`next\` (pre-collector) and \`before\` (post-collector). A route is a string ID, a sequence (\`["a", "b"]\`), or a RouteConfig (\`{ match?, next }\` or \`{ match?, one: [...] }\`). The \`one\` operator dispatches first-match against an ordered list of branches. Use \`many\` (instead of \`one\`) when every matching entry should run as an independent parallel flow \u2014 restricted to pre-collector positions. The optional \`match\` field is omitted to mean always-match (no wildcard literal).
 - **Pass-through steps** are transformer entries with no \`code\` and no \`package\`. The runtime synthesizes the push for them automatically. Three flavors share this shape: a \`before\` / \`next\`-only step (named hop reusable across destinations), a \`cache\`-only step (dedup, rate-limit), and a \`mapping\`-only step (declarative event-to-event transform). A pass-through must declare at least one of \`before\`, \`next\`, \`cache\`, or \`mapping\`.
 - **Mapping at the transformer position** uses the same \`Mapping.Config\` shape as destinations, but the semantic is event-to-event: \`policy\` and per-rule \`policy\`, \`mapping[].name\` (rename), \`mapping[].ignore\` (drop from chain), \`consent\`, and \`include\` apply. Vendor-payload fields (\`data\`, \`silent\`, \`mapping[].data\`) are no-ops at this position.
 - **Closed-schema rule on transformer entries:** known keys only. Operative keys are \`code\`, \`package\`, \`before\`, \`next\`, \`cache\`, \`mapping\`. Combined with structural keys (\`config\`, \`env\`, \`validate\`, \`disabled\`, \`id\`, etc.). Unknown top-level keys on a transformer step are errors (catches typos like \`dedup: {}\` instead of nested under \`cache\`). \`code\` + \`package\` together is a conflict.