@walkeros/cli 4.8.0 → 4.8.1-next-1792019907609

package/dist/dev.d.ts

@@ -1,4 +1,5 @@
 import { z } from '@walkeros/core/dev';
+import { Flow } from '@walkeros/core';
 
 /**
  * CLI Primitive Schemas
@@ -301,4 +302,64 @@ declare namespace index {
   export { type index_BundleInput as BundleInput, index_BundleInputSchema as BundleInputSchema, index_BundleInputShape as BundleInputShape, type index_BundleOptions as BundleOptions, index_BundleOptionsSchema as BundleOptionsSchema, index_FilePathSchema as FilePathSchema, type index_Platform as Platform, index_PlatformSchema as PlatformSchema, index_PortSchema as PortSchema, type index_PushInput as PushInput, index_PushInputSchema as PushInputSchema, index_PushInputShape as PushInputShape, type index_PushOptions as PushOptions, index_PushOptionsSchema as PushOptionsSchema, type index_SimulateInput as SimulateInput, index_SimulateInputSchema as SimulateInputSchema, index_SimulateInputShape as SimulateInputShape, type index_SimulateOptions as SimulateOptions, index_SimulateOptionsSchema as SimulateOptionsSchema, type index_ValidateInput as ValidateInput, index_ValidateInputSchema as ValidateInputSchema, index_ValidateInputShape as ValidateInputShape, type index_ValidateOptions as ValidateOptions, index_ValidateOptionsSchema as ValidateOptionsSchema, type index_ValidationType as ValidationType, index_ValidationTypeSchema as ValidationTypeSchema };
 }
 
-export { index as schemas };
+/**
+ * Shared resolver for the export name to import from a flow component's
+ * package.
+ *
+ * Both `walkeros bundle` and `walkeros setup` need to know which named export
+ * (or default) to pull off a package referenced by a flow component. The
+ * precedence chain is:
+ *
+ * 1. `flow.<kind>.<id>.import` if set (named export selector at the step).
+ * 2. `flow.config.bundle.packages[<package>].imports[0]` if set.
+ * 3. Otherwise undefined; the caller falls back to the package's `default`
+ *    export.
+ *
+ * This lives in `cli/src/core/` so both `commands/bundle/*` and
+ * `commands/setup/*` import the same function. Duplicating the chain is how
+ * setup ended up out of sync with bundle (Bug F: `setup destination.pubsub`
+ * routed through BigQuery's setup because it ignored the `code` field and
+ * always grabbed `mod.default`).
+ */
+
+type ComponentKind = 'source' | 'transformer' | 'destination' | 'store';
+type ResolveSource = 'import' | 'imports' | 'default';
+interface ResolvedExportName {
+    /**
+     * The named export to pull off the imported module, or `undefined` to
+     * indicate the caller should use the package's `default` export.
+     */
+    exportName: string | undefined;
+    /** Which precedence step produced the result (useful for diagnostics). */
+    source: ResolveSource;
+}
+/**
+ * Resolve the export name to import for a flow component's package.
+ *
+ * See module docs for the precedence chain. Inline code (`code` is an object)
+ * doesn't enter this resolver at all — setup rejects inline code at a higher
+ * layer.
+ */
+declare function resolveExportName(flow: Flow, kind: ComponentKind, id: string): ResolvedExportName;
+
+/**
+ * Selects the dev examples of one export from a package's awaited `/dev`
+ * module.
+ *
+ * A package with several exports (`walkerOS.exports` in its package.json)
+ * ships `exportExamples`, a map from export name to that export's examples,
+ * the default export included. A package with one export ships only
+ * `examples`.
+ *
+ * - Map present, export named: `exportExamples[exportName]`. A name missing
+ *   from the map resolves to `undefined`, never to another export's examples.
+ * - Map present, no export name (the step uses the default export):
+ *   `examples`, which by convention holds the default export's examples.
+ * - No map: `examples`.
+ *
+ * `exportName` comes from `resolveExportName` (step `import`, else
+ * `bundle.packages[pkg].imports[0]`, else default).
+ */
+declare function selectDevExamples(devModule: unknown, exportName: string | undefined): Record<string, unknown> | undefined;
+
+export { resolveExportName, index as schemas, selectDevExamples };

package/dist/dev.js

@@ -120,7 +120,62 @@ var PushInputShape = {
   platform: PlatformSchema.optional().describe("Override platform detection")
 };
 var PushInputSchema = z5.object(PushInputShape);
+
+// src/core/resolve-export-name.ts
+function getStep(flow, kind, id) {
+  switch (kind) {
+    case "source":
+      return flow.sources?.[id];
+    case "transformer":
+      return flow.transformers?.[id];
+    case "destination":
+      return flow.destinations?.[id];
+    case "store":
+      return flow.stores?.[id];
+  }
+}
+function getBundlePackages(flow) {
+  return flow.config?.bundle?.packages;
+}
+function readFirstImport(packages, packageName) {
+  if (!packages || !packageName) return void 0;
+  const pkg = packages[packageName];
+  if (!pkg || !pkg.imports || pkg.imports.length === 0) return void 0;
+  const first = pkg.imports[0];
+  return typeof first === "string" && first.length > 0 ? first : void 0;
+}
+function resolveExportName(flow, kind, id) {
+  const step = getStep(flow, kind, id);
+  if (!step) return { exportName: void 0, source: "default" };
+  const packageName = step.package;
+  const importName = step.import;
+  if (typeof importName === "string" && importName.length > 0) {
+    return { exportName: importName, source: "import" };
+  }
+  const firstImport = readFirstImport(getBundlePackages(flow), packageName);
+  if (firstImport) {
+    return { exportName: firstImport, source: "imports" };
+  }
+  return { exportName: void 0, source: "default" };
+}
+
+// src/commands/push/dev-examples.ts
+function isRecord(value) {
+  return value !== null && typeof value === "object";
+}
+function selectDevExamples(devModule, exportName) {
+  if (!isRecord(devModule)) return void 0;
+  const map = devModule.exportExamples;
+  if (isRecord(map) && exportName !== void 0) {
+    const selected = map[exportName];
+    return isRecord(selected) ? selected : void 0;
+  }
+  const examples = devModule.examples;
+  return isRecord(examples) ? examples : void 0;
+}
 export {
-  schemas_exports as schemas
+  resolveExportName,
+  schemas_exports as schemas,
+  selectDevExamples
 };
 //# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/primitives.ts","../src/schemas/validate.ts","../src/schemas/bundle.ts","../src/schemas/simulate.ts","../src/schemas/push.ts"],"sourcesContent":["/**\n * CLI Schemas\n *\n * Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nexport { PortSchema, FilePathSchema } from './primitives';\n\nexport {\n  ValidationTypeSchema,\n  ValidateOptionsSchema,\n  ValidateInputShape,\n  ValidateInputSchema,\n  type ValidationType,\n  type ValidateOptions,\n  type ValidateInput,\n} from './validate';\n\nexport {\n  BundleOptionsSchema,\n  BundleInputShape,\n  BundleInputSchema,\n  type BundleOptions,\n  type BundleInput,\n} from './bundle';\n\nexport {\n  PlatformSchema,\n  SimulateOptionsSchema,\n  SimulateInputShape,\n  SimulateInputSchema,\n  type Platform,\n  type SimulateOptions,\n  type SimulateInput,\n} from './simulate';\n\nexport {\n  PushOptionsSchema,\n  PushInputShape,\n  PushInputSchema,\n  type PushOptions,\n  type PushInput,\n} from './push';\n","/**\n * CLI Primitive Schemas\n *\n * Basic Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Port number schema.\n *\n * @remarks\n * Validates HTTP server port number.\n * Must be integer between 1-65535.\n */\nexport const PortSchema = z\n  .number()\n  .int('Port must be an integer')\n  .min(1, 'Port must be at least 1')\n  .max(65535, 'Port must be at most 65535')\n  .describe('HTTP server port number');\n\n/**\n * File path schema.\n *\n * @remarks\n * Basic string validation for file paths.\n * File existence is checked separately (Zod can't check filesystem).\n */\nexport const FilePathSchema = z\n  .string()\n  .min(1, 'File path cannot be empty')\n  .describe('Path to configuration file');\n","/**\n * Validate Command Schemas\n *\n * Zod schemas for validate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Validation type schema.\n *\n * @remarks\n * Validates the type of validation to perform.\n * - `contract`: Validate a data contract\n * - `event`: Validate a walkerOS event object\n * - `flow`: Validate a flow configuration file\n * - `mapping`: Validate mapping rules\n */\nexport const ValidationTypeSchema = z\n  .enum(['contract', 'event', 'flow', 'mapping'])\n  .describe('Validation type: \"event\", \"flow\", \"mapping\", or \"contract\"');\n\nexport type ValidationType = z.infer<typeof ValidationTypeSchema>;\n\n/**\n * Validate options schema.\n *\n * @remarks\n * Options for the programmatic validate() API.\n */\nexport const ValidateOptionsSchema = z.object({\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      'Entry path for package schema validation (e.g., \"destinations.snowplow\", \"stores.cache\"). Checks the entry in every flow that has it, or only in --flow.',\n    ),\n  strict: z\n    .boolean()\n    .optional()\n    .describe(\n      'Escalate: strict turns warnings and skips into failures (valid is false), contract disagreements error',\n    ),\n  offline: z\n    .boolean()\n    .optional()\n    .describe(\n      'Do not fetch package schemas: step settings are not checked against them, and the result scope says so. Only with type \"flow\" and no path.',\n    ),\n  configDir: z\n    .string()\n    .optional()\n    .describe(\n      \"Directory local `path` packages resolve against. Defaults to the input file's directory; set it when passing a parsed document.\",\n    ),\n});\n\nexport type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const ValidateInputShape = {\n  type: ValidationTypeSchema,\n  input: z\n    .string()\n    .min(1)\n    .describe('JSON string, file path, or URL to validate'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      'Entry path for package schema validation (e.g., \"destinations.snowplow\"). Only with type \"flow\": validates the entry against its package JSON Schema in every flow that has it, or only in the given flow.',\n    ),\n  strict: z\n    .boolean()\n    .optional()\n    .describe(\n      'Escalate: strict turns warnings and skips into failures: valid is false (the CLI exits 2), and contract example disagreements become errors. Every check runs with or without it.',\n    ),\n  offline: z\n    .boolean()\n    .optional()\n    .describe(\n      'Do not fetch package schemas: step settings are not checked against them, and details.scope says so. Only with type \"flow\" and no path.',\n    ),\n};\n\n/**\n * Validate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including type and input source.\n */\nexport const ValidateInputSchema = z.object(ValidateInputShape);\n\nexport type ValidateInput = z.infer<typeof ValidateInputSchema>;\n","/**\n * Bundle Command Schemas\n *\n * Zod schemas for bundle command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Bundle options schema.\n *\n * @remarks\n * Options for the programmatic bundle() API.\n */\nexport const BundleOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  cache: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Enable package caching'),\n  flowName: z.string().optional().describe('Flow name for multi-flow configs'),\n});\n\nexport type BundleOptions = z.infer<typeof BundleOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const BundleInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file (JSON or JavaScript), URL, or inline JSON string',\n  ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  output: z\n    .string()\n    .optional()\n    .describe('Output file path (defaults to config-defined)'),\n};\n\n/**\n * Bundle input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path and options.\n */\nexport const BundleInputSchema = z.object(BundleInputShape);\n\nexport type BundleInput = z.infer<typeof BundleInputSchema>;\n","/**\n * Simulate Command Schemas\n *\n * Zod schemas for simulate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Platform schema.\n *\n * @remarks\n * Validates platform type for event simulation.\n */\nexport const PlatformSchema = z\n  .enum(['web', 'server'])\n  .describe('Platform type for event processing');\n\nexport type Platform = z.infer<typeof PlatformSchema>;\n\n/**\n * Simulate options schema.\n *\n * @remarks\n * Options for the programmatic simulate() API.\n */\nexport const SimulateOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const SimulateInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file, URL, or inline JSON string',\n  ),\n  event: z\n    .string()\n    .min(1)\n    .optional()\n    .describe(\n      'Event as JSON string, file path, or URL. For sources: { content, trigger?, env? }.',\n    ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n  step: z\n    .string()\n    .optional()\n    .describe(\n      'Step target in type.name format (e.g. \"source.browser\", \"destination.gtag\")',\n    ),\n};\n\n/**\n * Simulate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const SimulateInputSchema = z.object(SimulateInputShape);\n\nexport type SimulateInput = z.infer<typeof SimulateInputSchema>;\n","/**\n * Push Command Schemas\n *\n * Zod schemas for push command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\nimport { PlatformSchema } from './simulate';\n\n/**\n * Push options schema.\n *\n * @remarks\n * Options for the programmatic push() API.\n */\nexport const PushOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type PushOptions = z.infer<typeof PushOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const PushInputShape = {\n  configPath: FilePathSchema.describe('Path to flow configuration file'),\n  event: z.string().min(1).describe('Event as JSON string, file path, or URL'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n};\n\n/**\n * Push input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const PushInputSchema = z.object(PushInputShape);\n\nexport type PushInput = z.infer<typeof PushInputSchema>;\n"],"mappings":"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","names":["z","z","z","z","z","z","z"]}
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/primitives.ts","../src/schemas/validate.ts","../src/schemas/bundle.ts","../src/schemas/simulate.ts","../src/schemas/push.ts","../src/core/resolve-export-name.ts","../src/commands/push/dev-examples.ts"],"sourcesContent":["/**\n * CLI Schemas\n *\n * Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nexport { PortSchema, FilePathSchema } from './primitives';\n\nexport {\n  ValidationTypeSchema,\n  ValidateOptionsSchema,\n  ValidateInputShape,\n  ValidateInputSchema,\n  type ValidationType,\n  type ValidateOptions,\n  type ValidateInput,\n} from './validate';\n\nexport {\n  BundleOptionsSchema,\n  BundleInputShape,\n  BundleInputSchema,\n  type BundleOptions,\n  type BundleInput,\n} from './bundle';\n\nexport {\n  PlatformSchema,\n  SimulateOptionsSchema,\n  SimulateInputShape,\n  SimulateInputSchema,\n  type Platform,\n  type SimulateOptions,\n  type SimulateInput,\n} from './simulate';\n\nexport {\n  PushOptionsSchema,\n  PushInputShape,\n  PushInputSchema,\n  type PushOptions,\n  type PushInput,\n} from './push';\n","/**\n * CLI Primitive Schemas\n *\n * Basic Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Port number schema.\n *\n * @remarks\n * Validates HTTP server port number.\n * Must be integer between 1-65535.\n */\nexport const PortSchema = z\n  .number()\n  .int('Port must be an integer')\n  .min(1, 'Port must be at least 1')\n  .max(65535, 'Port must be at most 65535')\n  .describe('HTTP server port number');\n\n/**\n * File path schema.\n *\n * @remarks\n * Basic string validation for file paths.\n * File existence is checked separately (Zod can't check filesystem).\n */\nexport const FilePathSchema = z\n  .string()\n  .min(1, 'File path cannot be empty')\n  .describe('Path to configuration file');\n","/**\n * Validate Command Schemas\n *\n * Zod schemas for validate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Validation type schema.\n *\n * @remarks\n * Validates the type of validation to perform.\n * - `contract`: Validate a data contract\n * - `event`: Validate a walkerOS event object\n * - `flow`: Validate a flow configuration file\n * - `mapping`: Validate mapping rules\n */\nexport const ValidationTypeSchema = z\n  .enum(['contract', 'event', 'flow', 'mapping'])\n  .describe('Validation type: \"event\", \"flow\", \"mapping\", or \"contract\"');\n\nexport type ValidationType = z.infer<typeof ValidationTypeSchema>;\n\n/**\n * Validate options schema.\n *\n * @remarks\n * Options for the programmatic validate() API.\n */\nexport const ValidateOptionsSchema = z.object({\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      'Entry path for package schema validation (e.g., \"destinations.snowplow\", \"stores.cache\"). Checks the entry in every flow that has it, or only in --flow.',\n    ),\n  strict: z\n    .boolean()\n    .optional()\n    .describe(\n      'Escalate: strict turns warnings and skips into failures (valid is false), contract disagreements error',\n    ),\n  offline: z\n    .boolean()\n    .optional()\n    .describe(\n      'Do not fetch package schemas: step settings are not checked against them, and the result scope says so. Only with type \"flow\" and no path.',\n    ),\n  configDir: z\n    .string()\n    .optional()\n    .describe(\n      \"Directory local `path` packages resolve against. Defaults to the input file's directory; set it when passing a parsed document.\",\n    ),\n});\n\nexport type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const ValidateInputShape = {\n  type: ValidationTypeSchema,\n  input: z\n    .string()\n    .min(1)\n    .describe('JSON string, file path, or URL to validate'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      'Entry path for package schema validation (e.g., \"destinations.snowplow\"). Only with type \"flow\": validates the entry against its package JSON Schema in every flow that has it, or only in the given flow.',\n    ),\n  strict: z\n    .boolean()\n    .optional()\n    .describe(\n      'Escalate: strict turns warnings and skips into failures: valid is false (the CLI exits 2), and contract example disagreements become errors. Every check runs with or without it.',\n    ),\n  offline: z\n    .boolean()\n    .optional()\n    .describe(\n      'Do not fetch package schemas: step settings are not checked against them, and details.scope says so. Only with type \"flow\" and no path.',\n    ),\n};\n\n/**\n * Validate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including type and input source.\n */\nexport const ValidateInputSchema = z.object(ValidateInputShape);\n\nexport type ValidateInput = z.infer<typeof ValidateInputSchema>;\n","/**\n * Bundle Command Schemas\n *\n * Zod schemas for bundle command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Bundle options schema.\n *\n * @remarks\n * Options for the programmatic bundle() API.\n */\nexport const BundleOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  cache: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Enable package caching'),\n  flowName: z.string().optional().describe('Flow name for multi-flow configs'),\n});\n\nexport type BundleOptions = z.infer<typeof BundleOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const BundleInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file (JSON or JavaScript), URL, or inline JSON string',\n  ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  output: z\n    .string()\n    .optional()\n    .describe('Output file path (defaults to config-defined)'),\n};\n\n/**\n * Bundle input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path and options.\n */\nexport const BundleInputSchema = z.object(BundleInputShape);\n\nexport type BundleInput = z.infer<typeof BundleInputSchema>;\n","/**\n * Simulate Command Schemas\n *\n * Zod schemas for simulate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Platform schema.\n *\n * @remarks\n * Validates platform type for event simulation.\n */\nexport const PlatformSchema = z\n  .enum(['web', 'server'])\n  .describe('Platform type for event processing');\n\nexport type Platform = z.infer<typeof PlatformSchema>;\n\n/**\n * Simulate options schema.\n *\n * @remarks\n * Options for the programmatic simulate() API.\n */\nexport const SimulateOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const SimulateInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file, URL, or inline JSON string',\n  ),\n  event: z\n    .string()\n    .min(1)\n    .optional()\n    .describe(\n      'Event as JSON string, file path, or URL. For sources: { content, trigger?, env? }.',\n    ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n  step: z\n    .string()\n    .optional()\n    .describe(\n      'Step target in type.name format (e.g. \"source.browser\", \"destination.gtag\")',\n    ),\n};\n\n/**\n * Simulate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const SimulateInputSchema = z.object(SimulateInputShape);\n\nexport type SimulateInput = z.infer<typeof SimulateInputSchema>;\n","/**\n * Push Command Schemas\n *\n * Zod schemas for push command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\nimport { PlatformSchema } from './simulate';\n\n/**\n * Push options schema.\n *\n * @remarks\n * Options for the programmatic push() API.\n */\nexport const PushOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type PushOptions = z.infer<typeof PushOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const PushInputShape = {\n  configPath: FilePathSchema.describe('Path to flow configuration file'),\n  event: z.string().min(1).describe('Event as JSON string, file path, or URL'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n};\n\n/**\n * Push input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const PushInputSchema = z.object(PushInputShape);\n\nexport type PushInput = z.infer<typeof PushInputSchema>;\n","/**\n * Shared resolver for the export name to import from a flow component's\n * package.\n *\n * Both `walkeros bundle` and `walkeros setup` need to know which named export\n * (or default) to pull off a package referenced by a flow component. The\n * precedence chain is:\n *\n * 1. `flow.<kind>.<id>.import` if set (named export selector at the step).\n * 2. `flow.config.bundle.packages[<package>].imports[0]` if set.\n * 3. Otherwise undefined; the caller falls back to the package's `default`\n *    export.\n *\n * This lives in `cli/src/core/` so both `commands/bundle/*` and\n * `commands/setup/*` import the same function. Duplicating the chain is how\n * setup ended up out of sync with bundle (Bug F: `setup destination.pubsub`\n * routed through BigQuery's setup because it ignored the `code` field and\n * always grabbed `mod.default`).\n */\n\nimport type { Flow } from '@walkeros/core';\n\nexport type ComponentKind = 'source' | 'transformer' | 'destination' | 'store';\n\nexport type ResolveSource = 'import' | 'imports' | 'default';\n\nexport interface ResolvedExportName {\n  /**\n   * The named export to pull off the imported module, or `undefined` to\n   * indicate the caller should use the package's `default` export.\n   */\n  exportName: string | undefined;\n  /** Which precedence step produced the result (useful for diagnostics). */\n  source: ResolveSource;\n}\n\ninterface FlowStepView {\n  package?: string;\n  import?: string;\n}\n\nfunction getStep(\n  flow: Flow,\n  kind: ComponentKind,\n  id: string,\n): FlowStepView | undefined {\n  switch (kind) {\n    case 'source':\n      return flow.sources?.[id];\n    case 'transformer':\n      return flow.transformers?.[id];\n    case 'destination':\n      return flow.destinations?.[id];\n    case 'store':\n      return flow.stores?.[id];\n  }\n}\n\nfunction getBundlePackages(\n  flow: Flow,\n): Record<string, Flow.BundlePackage> | undefined {\n  return flow.config?.bundle?.packages;\n}\n\n/**\n * Read the first entry of `bundle.packages[<package>].imports` if it is a\n * non-empty string. Returns `undefined` otherwise.\n */\nfunction readFirstImport(\n  packages: Record<string, Flow.BundlePackage> | undefined,\n  packageName: string | undefined,\n): string | undefined {\n  if (!packages || !packageName) return undefined;\n  const pkg = packages[packageName];\n  if (!pkg || !pkg.imports || pkg.imports.length === 0) return undefined;\n  const first = pkg.imports[0];\n  return typeof first === 'string' && first.length > 0 ? first : undefined;\n}\n\n/**\n * Resolve the export name to import for a flow component's package.\n *\n * See module docs for the precedence chain. Inline code (`code` is an object)\n * doesn't enter this resolver at all — setup rejects inline code at a higher\n * layer.\n */\nexport function resolveExportName(\n  flow: Flow,\n  kind: ComponentKind,\n  id: string,\n): ResolvedExportName {\n  const step = getStep(flow, kind, id);\n  if (!step) return { exportName: undefined, source: 'default' };\n\n  const packageName = step.package;\n  const importName = step.import;\n\n  // 1. Explicit `import` field on the step wins.\n  if (typeof importName === 'string' && importName.length > 0) {\n    return { exportName: importName, source: 'import' };\n  }\n\n  // 2. Fallback to bundle.packages[pkg].imports[0].\n  const firstImport = readFirstImport(getBundlePackages(flow), packageName);\n  if (firstImport) {\n    return { exportName: firstImport, source: 'imports' };\n  }\n\n  // 3. Default export.\n  return { exportName: undefined, source: 'default' };\n}\n","function isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object';\n}\n\n/**\n * Selects the dev examples of one export from a package's awaited `/dev`\n * module.\n *\n * A package with several exports (`walkerOS.exports` in its package.json)\n * ships `exportExamples`, a map from export name to that export's examples,\n * the default export included. A package with one export ships only\n * `examples`.\n *\n * - Map present, export named: `exportExamples[exportName]`. A name missing\n *   from the map resolves to `undefined`, never to another export's examples.\n * - Map present, no export name (the step uses the default export):\n *   `examples`, which by convention holds the default export's examples.\n * - No map: `examples`.\n *\n * `exportName` comes from `resolveExportName` (step `import`, else\n * `bundle.packages[pkg].imports[0]`, else default).\n */\nexport function selectDevExamples(\n  devModule: unknown,\n  exportName: string | undefined,\n): Record<string, unknown> | undefined {\n  if (!isRecord(devModule)) return undefined;\n\n  const map = devModule.exportExamples;\n  if (isRecord(map) && exportName !== undefined) {\n    const selected = map[exportName];\n    return isRecord(selected) ? selected : undefined;\n  }\n\n  const examples = devModule.examples;\n  return isRecord(examples) ? examples : undefined;\n}\n\n/**\n * A package version from before export-keyed examples ships only\n * `examples` (the default export's), even when it declares several\n * exports. For a step naming an export, those examples may belong to\n * another export, so simulate must refuse instead of running that export's\n * mock (or none) against the real vendor. Returns the refusal message, or\n * `undefined` when the examples can be trusted.\n *\n * `packageExports` is the bundle's `__packageExports` (declared exports per\n * package, read at build time from the bundled copy). A bundle without it\n * (built before it existed) cannot tell single- from multi-export packages,\n * so a step naming an export without a map is refused.\n */\nexport function legacyExportRefusal(\n  devModule: unknown,\n  packageExports: Record<string, string[]> | undefined,\n  packageName: string,\n  exportName: string | undefined,\n): string | undefined {\n  if (exportName === undefined) return undefined;\n  if (isRecord(devModule) && isRecord(devModule.exportExamples))\n    return undefined;\n  if (packageExports) {\n    const declared = packageExports[packageName];\n    if (!declared || declared.length <= 1) return undefined;\n  }\n  return `No mock env for ${packageName} export ${exportName}: this package version predates export-keyed examples; use a version with exportExamples or a local path.`;\n}\n"],"mappings":"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","names":["z","z","z","z","z","z","z"]}

package/dist/examples/flow-complete.json

@@ -241,25 +241,25 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/web-source-cmp-usercentrics": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/web-source-session": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/web-source-datalayer": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/web-source-browser": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/web-destination-gtag": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/web-destination-api": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             }
           },
           "env": {
@@ -1765,40 +1765,40 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-source-express": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/transformer-ga4": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/transformer-validate": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-transformer-bot": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-transformer-fingerprint": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-transformer-file": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-store-fs": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-gcp": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-meta": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-piwikpro": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-datamanager": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             }
           }
         }
@@ -4875,13 +4875,13 @@
         "bundle": {
           "packages": {
             "@walkeros/collector": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-source-gcp": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-gcp": {
-              "version": "4.8.0"
+              "version": "4.8.1-next-1792019907609"
             }
           }
         }

package/dist/examples/flow-complete.md

@@ -907,16 +907,16 @@ walkeros cache info
     from the flow variable, so LOG_LEVEL changes it per environment.
 - **CI:** `walkeros validate packages/cli/examples/flow-complete.json --strict`
   plus the step examples as fixtures.
-- **CLI (app-bound, need a login; listed, not run for this guide):**
+- **CLI (app-bound, need a login or WALKEROS_TOKEN; listed, not run for this
+  guide):**
 
 ```bash
-walkeros flows create flow-complete -c packages/cli/examples/flow-complete.json
-walkeros deploy create packages/cli/examples/flow-complete.json
-walkeros deploy start <flowId>
-walkeros observe start <flowId>
+walkeros api GET /api/projects/{projectId}/flows
+walkeros api POST /api/projects/{projectId}/flows/<flowId>/deploy --header 'Idempotency-Key: <key>'
 ```
 
-- **MCP:** `flow_manage`, `deploy_manage`, `observe_session`, `flow_validate`
-  then `flow_simulate` then `flow_push` as the agent loop.
+- **MCP:** on your machine `flow_validate`, then `flow_simulate`, then
+  `flow_push` as the agent loop; saved flows, deployments and Observe through
+  the hosted walkerOS MCP server.
 - **In GTM:** preview mode and container versions.
 - **Docs:** `collector/logger`.

package/dist/examples/index.d.ts

@@ -1903,7 +1903,6 @@ declare const teaching: {
         useCases: "observability"[];
         note: string;
         docs: never[];
-        cli: string[];
     };
     'observe-level': {
         pointer: string;

package/dist/examples/index.js

@@ -264,25 +264,25 @@ var flow_complete_default = {
         bundle: {
           packages: {
             "@walkeros/collector": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/web-source-cmp-usercentrics": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/web-source-session": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/web-source-datalayer": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/web-source-browser": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/web-destination-gtag": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/web-destination-api": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             }
           },
           env: {
@@ -1788,40 +1788,40 @@ var flow_complete_default = {
         bundle: {
           packages: {
             "@walkeros/collector": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-source-express": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/transformer-ga4": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/transformer-validate": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-transformer-bot": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-transformer-fingerprint": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-transformer-file": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-store-fs": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-gcp": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-meta": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-piwikpro": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-datamanager": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             }
           }
         }
@@ -4898,13 +4898,13 @@ var flow_complete_default = {
         bundle: {
           packages: {
             "@walkeros/collector": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-source-gcp": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             },
             "@walkeros/server-destination-gcp": {
-              version: "4.8.0"
+              version: "4.8.1-next-1792019907609"
             }
           }
         }
@@ -6761,8 +6761,7 @@ var teaching = {
     level: "intermediate",
     useCases: ["observability"],
     note: "A web flow reports to Observe through a public url and binding.",
-    docs: [],
-    cli: ["walkeros observe start <flowId>"]
+    docs: []
   },
   "observe-level": {
     pointer: "/flows/server/config/observe/level",
@@ -6788,9 +6787,8 @@ var teaching = {
     note: "The log level comes from the flow variable, so LOG_LEVEL changes it per environment.",
     docs: [{ page: "collector/logger" }],
     cli: [
-      `walkeros flows create flow-complete -c ${FILE}`,
-      `walkeros deploy create ${FILE}`,
-      "walkeros deploy start <flowId>"
+      "walkeros api GET /api/projects/{projectId}/flows",
+      "walkeros api POST /api/projects/{projectId}/flows/<flowId>/deploy --header 'Idempotency-Key: <key>'"
     ]
   }
 };
@@ -7196,12 +7194,13 @@ var flowCompleteCli = [
   },
   { command: "walkeros cache info", chapter: "build-run" },
   {
-    command: `walkeros flows create flow-complete -c ${FILE}`,
+    command: "walkeros api GET /api/projects/{projectId}/flows",
     chapter: "operate"
   },
-  { command: `walkeros deploy create ${FILE}`, chapter: "operate" },
-  { command: "walkeros deploy start <flowId>", chapter: "operate" },
-  { command: "walkeros observe start <flowId>", chapter: "operate" }
+  {
+    command: "walkeros api POST /api/projects/{projectId}/flows/<flowId>/deploy --header 'Idempotency-Key: <key>'",
+    chapter: "operate"
+  }
 ];
 var flowCompleteManifest = {
   file: FILE,