@galaxy-tool-util/schema 0.1.0 → 0.4.0

package/dist/workflow/runtime-markers.js

@@ -0,0 +1,26 @@
+/**
+ * Runtime value markers used inside workflow tool_state.
+ *
+ * Galaxy has two in-band markers indicating a parameter value is not a
+ * literal but will be supplied at invocation time:
+ * - `ConnectedValue`: value comes from an upstream step output
+ * - `RuntimeValue`: value is supplied by the user at workflow runtime
+ *
+ * Both are encoded as `{ __class__: "ConnectedValue" | "RuntimeValue" }`
+ * inside native tool_state dicts. Matches Galaxy Python terminology.
+ */
+export const CONNECTED_VALUE = { __class__: "ConnectedValue" };
+export const RUNTIME_VALUE = { __class__: "RuntimeValue" };
+export function isConnectedValue(value) {
+    return (value != null &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        value.__class__ === "ConnectedValue");
+}
+export function isRuntimeValue(value) {
+    return (value != null &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        value.__class__ === "RuntimeValue");
+}
+//# sourceMappingURL=runtime-markers.js.map

package/dist/workflow/runtime-markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-markers.js","sourceRoot":"","sources":["../../src/workflow/runtime-markers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,SAAS,EAAE,gBAAgB,EAAW,CAAC;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,SAAS,EAAE,cAAc,EAAW,CAAC;AAEpE,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,KAAK,IAAI,IAAI;QACb,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAiC,CAAC,SAAS,KAAK,gBAAgB,CAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,KAAK,IAAI,IAAI;QACb,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAiC,CAAC,SAAS,KAAK,cAAc,CAChE,CAAC;AACJ,CAAC"}

package/dist/workflow/schema-rules.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Schema-rule catalog types and parser.
+ *
+ * Mirrors gxformat2/schema_rules.py. Schema rules describe checks already
+ * enforced by the Effect decode layer. Each rule ships with positive and
+ * negative fixtures; the catalog contract is tested end-to-end by running
+ * fixtures through validators — not by inspecting ParseError shapes.
+ *
+ * The YAML file lives alongside this module at `./schema_rules.yml`. This
+ * module stays fs-free to keep src/ browser-compatible — callers read the
+ * file themselves (see test/schema-rules-catalog.test.ts) and hand the
+ * string to `parseSchemaRules`.
+ */
+/** Relative path (from this module) to the catalog YAML. */
+export declare const SCHEMA_RULES_FILENAME = "schema_rules.yml";
+export type Severity = "error" | "warning";
+export type AppliesTo = "format2" | "native";
+/**
+ * Validator flavors that reject the negative fixture.
+ * - `both`: both lax and strict reject (e.g. missing required field)
+ * - `strict`: only strict rejects (e.g. unknown extra field)
+ * - `lax`: only lax rejects — unusual, reserved for completeness
+ */
+export type Scope = "both" | "strict" | "lax";
+export interface SchemaRuleTests {
+    positive: string[];
+    negative: string[];
+}
+export interface SchemaRule {
+    id: string;
+    severity: Severity;
+    applies_to: AppliesTo[];
+    scope: Scope;
+    description: string;
+    tests: SchemaRuleTests;
+}
+export declare function parseSchemaRules(yamlContent: string): SchemaRule[];
+//# sourceMappingURL=schema-rules.d.ts.map

package/dist/workflow/schema-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-rules.d.ts","sourceRoot":"","sources":["../../src/workflow/schema-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC7C;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,eAAe,CAAC;CACxB;AAUD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE,CAUlE"}

package/dist/workflow/schema-rules.js

@@ -0,0 +1,28 @@
+/**
+ * Schema-rule catalog types and parser.
+ *
+ * Mirrors gxformat2/schema_rules.py. Schema rules describe checks already
+ * enforced by the Effect decode layer. Each rule ships with positive and
+ * negative fixtures; the catalog contract is tested end-to-end by running
+ * fixtures through validators — not by inspecting ParseError shapes.
+ *
+ * The YAML file lives alongside this module at `./schema_rules.yml`. This
+ * module stays fs-free to keep src/ browser-compatible — callers read the
+ * file themselves (see test/schema-rules-catalog.test.ts) and hand the
+ * string to `parseSchemaRules`.
+ */
+import * as yaml from "yaml";
+/** Relative path (from this module) to the catalog YAML. */
+export const SCHEMA_RULES_FILENAME = "schema_rules.yml";
+export function parseSchemaRules(yamlContent) {
+    const raw = yaml.parse(yamlContent);
+    return Object.entries(raw).map(([id, body]) => ({
+        id,
+        severity: body.severity,
+        applies_to: body.applies_to,
+        scope: body.scope,
+        description: body.description ?? "",
+        tests: body.tests,
+    }));
+}
+//# sourceMappingURL=schema-rules.js.map

package/dist/workflow/schema-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-rules.js","sourceRoot":"","sources":["../../src/workflow/schema-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAkCxD,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAkC,CAAC;IACrE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,EAAE;QACF,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/workflow/schema_rules.yml

@@ -0,0 +1,69 @@
+# Schema rule catalog.
+#
+# Each entry keys a schema-decode-enforced rule. Positive fixtures must pass
+# both lax and strict validation; negative fixtures must fail per `scope`.
+# Catalog contract is verified end-to-end by tests/test_schema_rules_catalog.py;
+# no pydantic error shapes are introspected.
+
+Format2MissingSteps:
+  severity: error
+  applies_to: [format2]
+  scope: both
+  description: "Format2 workflow missing required `steps` field."
+  tests:
+    positive: [synthetic-basic.gxwf.yml]
+    negative: [synthetic-missing-steps.gxwf.yml]
+
+NativeMissingMarker:
+  severity: error
+  applies_to: [native]
+  scope: both
+  description: "Native workflow missing required `a_galaxy_workflow` marker."
+  tests:
+    positive: [real-unicycler-assembly.ga]
+    negative: [synthetic-missing-marker.ga]
+
+NativeMarkerNotTrue:
+  severity: error
+  applies_to: [native]
+  scope: both
+  description: "`a_galaxy_workflow` must be literal string \"true\"."
+  tests:
+    positive: [real-unicycler-assembly.ga]
+    negative: [synthetic-lint-bad-marker.ga]
+
+NativeMissingFormatVersion:
+  severity: error
+  applies_to: [native]
+  scope: both
+  description: "Native workflow missing required `format-version` field."
+  tests:
+    positive: [real-unicycler-assembly.ga]
+    negative: [real-hacked-basic-missing-format-version.ga]
+
+NativeFormatVersionNotSupported:
+  severity: error
+  applies_to: [native]
+  scope: both
+  description: "`format-version` must be literal string \"0.1\"."
+  tests:
+    positive: [real-unicycler-assembly.ga]
+    negative: [synthetic-lint-bad-format-version.ga]
+
+ReportMarkdownNotString:
+  severity: error
+  applies_to: [format2, native]
+  scope: both
+  description: "Workflow `report.markdown` must be a string."
+  tests:
+    positive: [synthetic-basic.gxwf.yml, real-unicycler-assembly.ga]
+    negative: [synthetic-lint-report-bad-type.gxwf.yml, synthetic-lint-report-bad-type.ga]
+
+SchemaStrictExtraField:
+  severity: warning
+  applies_to: [format2, native]
+  scope: strict
+  description: "Unknown field present on a closed record under strict validation."
+  tests:
+    positive: [synthetic-basic.gxwf.yml, real-unicycler-assembly.ga]
+    negative: [synthetic-extra-field.gxwf.yml, synthetic-extra-field.ga]

package/dist/workflow/serialize.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Format-aware workflow serialization + format resolution.
+ *
+ * Shared between the CLI (`@galaxy-tool-util/cli`) and the web server
+ * (`@galaxy-tool-util/gxwf-web`) so both produce byte-compatible output.
+ */
+import { type WorkflowFormat } from "./detect-format.js";
+export interface SerializeWorkflowOptions {
+    /** Force JSON output regardless of format. */
+    json?: boolean;
+    /** Force YAML output regardless of format. */
+    yaml?: boolean;
+    /** JSON indent level (ignored for YAML). Default: 2. */
+    indent?: number;
+    /** Append a trailing newline (both JSON and YAML). Default: true. */
+    trailingNewline?: boolean;
+}
+/**
+ * Serialize a workflow dict as JSON or YAML based on `format` (or explicit
+ * `json` / `yaml` overrides).
+ *
+ * YAML uses `lineWidth: 0` to disable line-wrapping so diffs stay stable.
+ */
+export declare function serializeWorkflow(data: Record<string, unknown>, format: WorkflowFormat, opts?: SerializeWorkflowOptions): string;
+/**
+ * Resolve workflow format from an optional explicit choice, falling back to
+ * `detectFormat` on the dict.
+ */
+export declare function resolveFormat(data: Record<string, unknown>, formatOpt?: string): WorkflowFormat;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/workflow/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/workflow/serialize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,wBAA6B,GAClC,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAG/F"}

package/dist/workflow/serialize.js

@@ -0,0 +1,37 @@
+/**
+ * Format-aware workflow serialization + format resolution.
+ *
+ * Shared between the CLI (`@galaxy-tool-util/cli`) and the web server
+ * (`@galaxy-tool-util/gxwf-web`) so both produce byte-compatible output.
+ */
+import { stringify as stringifyYaml } from "yaml";
+import { detectFormat } from "./detect-format.js";
+/**
+ * Serialize a workflow dict as JSON or YAML based on `format` (or explicit
+ * `json` / `yaml` overrides).
+ *
+ * YAML uses `lineWidth: 0` to disable line-wrapping so diffs stay stable.
+ */
+export function serializeWorkflow(data, format, opts = {}) {
+    const useYaml = opts.yaml || (!opts.json && format === "format2");
+    const newline = opts.trailingNewline ?? true;
+    if (useYaml) {
+        const out = stringifyYaml(data, { lineWidth: 0 });
+        // `yaml` already ends with a newline; don't double-append.
+        if (newline)
+            return out.endsWith("\n") ? out : out + "\n";
+        return out.endsWith("\n") ? out.slice(0, -1) : out;
+    }
+    const indent = opts.indent ?? 2;
+    return JSON.stringify(data, null, indent) + (newline ? "\n" : "");
+}
+/**
+ * Resolve workflow format from an optional explicit choice, falling back to
+ * `detectFormat` on the dict.
+ */
+export function resolveFormat(data, formatOpt) {
+    if (formatOpt === "native" || formatOpt === "format2")
+        return formatOpt;
+    return detectFormat(data);
+}
+//# sourceMappingURL=serialize.js.map

package/dist/workflow/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/workflow/serialize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,YAAY,EAAuB,MAAM,oBAAoB,CAAC;AAavE;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAA6B,EAC7B,MAAsB,EACtB,OAAiC,EAAE;IAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAClD,2DAA2D;QAC3D,IAAI,OAAO;YAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;QAC1D,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAA6B,EAAE,SAAkB;IAC7E,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/workflow/stale-keys.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Stale/bookkeeping key set for workflow tool_state.
+ *
+ * Mirrors Python's `galaxy.tool_util.workflow_state.stale_keys` set — keys
+ * that Galaxy injects into tool_state for runtime bookkeeping and that are
+ * not real parameter values. The state walker allows them through unknown-
+ * key detection, and the roundtrip differ ignores them when diffing.
+ *
+ * Future work: classify into BOOKKEEPING / RUNTIME_LEAK / STALE_ROOT /
+ * STALE_BRANCH / UNKNOWN to mirror Python's `stale_keys.py` and drive an
+ * `--allow` / `--deny` policy for stateful export.
+ */
+/** Keys injected by Galaxy's runtime/UI; safe to ignore during conversion. */
+export declare const STALE_KEYS: ReadonlySet<string>;
+export declare function isRuntimeLeakKey(key: string): boolean;
+//# sourceMappingURL=stale-keys.d.ts.map

package/dist/workflow/stale-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-keys.d.ts","sourceRoot":"","sources":["../../src/workflow/stale-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,CAQzC,CAAC;AAoBH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/workflow/stale-keys.js

@@ -0,0 +1,43 @@
+/**
+ * Stale/bookkeeping key set for workflow tool_state.
+ *
+ * Mirrors Python's `galaxy.tool_util.workflow_state.stale_keys` set — keys
+ * that Galaxy injects into tool_state for runtime bookkeeping and that are
+ * not real parameter values. The state walker allows them through unknown-
+ * key detection, and the roundtrip differ ignores them when diffing.
+ *
+ * Future work: classify into BOOKKEEPING / RUNTIME_LEAK / STALE_ROOT /
+ * STALE_BRANCH / UNKNOWN to mirror Python's `stale_keys.py` and drive an
+ * `--allow` / `--deny` policy for stateful export.
+ */
+/** Keys injected by Galaxy's runtime/UI; safe to ignore during conversion. */
+export const STALE_KEYS = new Set([
+    "__current_case__",
+    "__input_ext",
+    "__page__",
+    "__rerun_remap_job_id__",
+    "__index__",
+    "__job_resource",
+    "chromInfo",
+]);
+/**
+ * Runtime-leak key detection.
+ *
+ * These keys leak from job execution into persisted `tool_state` and are not
+ * real parameter values. Galaxy classifies them as `RUNTIME_LEAK` in
+ * `stale_keys.py`; its `for_export` policy preserves them through format2
+ * export while `for_validate` flags them. Our walker silently drops them
+ * during stateful conversion (neither side of the roundtrip keeps them), so
+ * the roundtrip differ treats drops/appearances as benign.
+ *
+ * - Exact match: `__workflow_invocation_uuid__`
+ * - Suffix match: `|__identifier__` (e.g. `input|__identifier__`,
+ *   `dadaF|__identifier__` — collection element identifier, attached to
+ *   whichever param received the collection)
+ */
+const RUNTIME_LEAK_EXACT = new Set(["__workflow_invocation_uuid__"]);
+const RUNTIME_LEAK_SUFFIX = "|__identifier__";
+export function isRuntimeLeakKey(key) {
+    return RUNTIME_LEAK_EXACT.has(key) || key.endsWith(RUNTIME_LEAK_SUFFIX);
+}
+//# sourceMappingURL=stale-keys.js.map

package/dist/workflow/stale-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-keys.js","sourceRoot":"","sources":["../../src/workflow/stale-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAC;IACrD,kBAAkB;IAClB,aAAa;IACb,UAAU;IACV,wBAAwB;IACxB,WAAW;IACX,gBAAgB;IAChB,WAAW;CACZ,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC;AAC1F,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAC1E,CAAC"}

package/dist/workflow/state-merge.d.ts

@@ -1,40 +1,22 @@
 /**
- * Inject ConnectedValue markers into workflow state dicts.
+ * ConnectedValue injection and stripping for workflow state dicts.
  *
- * Port of Python galaxy.tool_util.workflow_state._state_merge +
- * helper functions from galaxy.tool_util.parameters.visitor.
+ * Thin wrappers around walkNativeState that inject or strip
+ * ConnectedValue markers. Mutate state in-place for caller compat.
  *
- * Walks the parameter tree to match pipe-separated connection paths
- * (e.g. "queries_0|input2") to tool parameters. Handles conditionals,
- * repeats, and sections. Used by validate-workflow for both native
- * and format2 validation paths.
+ * Port of Python galaxy.tool_util.workflow_state._state_merge.
+ * Tree-walking helpers live in walk-helpers.ts; re-exported here
+ * for backward compatibility.
  */
-import type { ToolParameterModel, ConditionalParameterModel, ConditionalWhen } from "../schema/bundle-types.js";
-/** Build flat pipe-separated state path: `name` or `prefix|name`. */
-export declare function flatStatePath(name: string, prefix?: string): string;
-/** Filter a flat key→value map to keys starting with a given prefix. */
-export declare function keysStartingWith<T>(map: Record<string, T>, prefix: string): Record<string, T>;
-/**
- * Split flat connection keys for a repeat into per-instance arrays.
- *
- * Connection keys use the pattern `repeatName_N|paramName`.
- * Returns an array of per-instance connection dicts.
- */
-export declare function repeatInputsToArray<T>(statePath: string, inputs: Record<string, T>): Record<string, T>[];
-/**
- * Select the matching ConditionalWhen for a conditional state dict.
- *
- * Matches the test parameter's value in state against each when's
- * discriminator. Falls back to the default when if no match found.
- * Returns null if no match at all (graceful degradation).
- */
-export declare function selectWhichWhen(conditional: ConditionalParameterModel, state: Record<string, unknown>): ConditionalWhen | null;
+import type { ToolParameterModel } from "../schema/bundle-types.js";
+import { flatStatePath, keysStartingWith, repeatInputsToArray, selectWhichWhen } from "./walk-helpers.js";
+export { flatStatePath, keysStartingWith, repeatInputsToArray, selectWhichWhen };
 /**
  * Inject ConnectedValue markers into a state dict for all connections.
  *
- * Walks the parameter tree to match connection paths to tool parameters,
- * setting matched leaves to `{"__class__": "ConnectedValue"}`.
- * Mutates `state` in-place.
+ * Uses walkNativeState with a leaf callback that replaces connected
+ * leaves with ConnectedValue markers, then reassigns the input state
+ * in-place to preserve the mutation contract callers expect.
  *
  * @returns remaining unmatched connection paths (empty if all consumed)
  */
@@ -42,8 +24,9 @@ export declare function injectConnectionsIntoState(toolInputs: ToolParameterMode
 /**
  * Strip ConnectedValue markers from a state dict using the parameter tree.
  *
- * Walks conditionals, repeats, and sections so nested markers inside
- * container parameters are removed. Mutates `state` in-place.
+ * Uses walkNativeState with a leaf callback that omits ConnectedValue
+ * entries via SKIP_VALUE, then reassigns the input state in-place to
+ * preserve the mutation contract callers expect.
  */
 export declare function stripConnectedValues(toolInputs: ToolParameterModel[], state: Record<string, unknown>): void;
 //# sourceMappingURL=state-merge.d.ts.map

package/dist/workflow/state-merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-merge.d.ts","sourceRoot":"","sources":["../../src/workflow/state-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EAKhB,MAAM,2BAA2B,CAAC;AAInC,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAQ7F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GACxB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAuBrB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,yBAAyB,EACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,eAAe,GAAG,IAAI,CAmBxB;AAgCD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,kBAAkB,EAAE,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AA2GD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,kBAAkB,EAAE,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAIN"}
+{"version":3,"file":"state-merge.d.ts","sourceRoot":"","sources":["../../src/workflow/state-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC;AAIjF;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,kBAAkB,EAAE,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,kBAAkB,EAAE,EAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAWN"}