Repository navigation
Python: fix(declarative): treat omitted workflow inputs as blank in PowerFx - #9730
Naveen Chatlapalli (1aifanatic) wants to merge 2 commits into
Conversation
…owerFx
When a caller omits an input that a formula references, PowerFx fails to
compile inputs.<name> / Workflow.Inputs.<name> ("Name isn't valid") and
eval() returns None for the whole expression. That breaks the documented
default pattern =If(IsBlank(inputs.name), "World", inputs.name): the
simple_workflow sample printed "Hello, !" for workflow.run({}).
Bind referenced-but-missing inputs to blank for that evaluation only, the
same result as passing the input as None, without writing them to state.
Also print the simple_workflow sample's second run, which was discarded.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
There was a problem hiding this comment.
🟡 Changes recommended
Reference discovery matches literal and comment text while missing valid quoted and whitespace-separated references.
2 open issues
What changed in this PR
This PR addresses #9729 by binding omitted workflow inputs as blank during PowerFx evaluation, allowing default expressions to run without modifying workflow state.
Changes:
- Adds evaluation-only blank bindings for references through both input aliases.
- Tests omitted-input defaults and verifies state remains unchanged.
- Prints the custom-name run’s outputs in the simple workflow sample.
| File | Description |
|---|---|
python/samples/03-workflows/declarative/simple_workflow/main.py |
Prints outputs from the “Alice” run. |
python/packages/declarative/tests/test_powerfx_yaml_compatibility.py |
Adds missing-input regression tests for both aliases. |
python/packages/declarative/agent_framework_declarative/_workflows/_declarative_base.py |
Discovers missing input references and binds evaluation-only blanks. |
Review effort: Balanced
Skip comments and string literals when looking for inputs.<name> and Workflow.Inputs.<name>, and accept single-quoted field names and whitespace or comments around the dots. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
| if member is None or member[0] != "Inputs": | ||
| continue | ||
| after_root = member[1] | ||
| elif root_name != "inputs": |
There was a problem hiding this comment.
Naveen Chatlapalli (@1aifanatic) This can treat a member name or locally bound inputs as the global workflow alias. After state.initialize({"other": 1}) and state.set("Local.inputs", {"name": "local"}), =If(Local . inputs . name = "local", inputs, inputs) returns {"other": 1.0, "name": None} instead of the base result {"other": 1.0}.
With({inputs: {name: "local"}}, {Chosen: inputs.name, Received: Workflow.Inputs}) likewise adds a global blank field solely from its local reference. Please distinguish actual global aliases from member names and local bindings before adding missing fields.
| if not missing: | ||
| return symbols | ||
| bound_inputs: dict[str, Any] = {**input_values, **dict.fromkeys(sorted(missing))} | ||
| return {**symbols, "Workflow": {**symbols["Workflow"], "Inputs": bound_inputs}, "inputs": bound_inputs} |
There was a problem hiding this comment.
Naveen Chatlapalli (@1aifanatic) The inputs symbol can be a custom namespace rather than the canonical input record. Replacing both bindings from it loses supplied values: after state.initialize({"name": "Alice"}) and state.set("inputs.other", 1), state.eval("=Workflow.Inputs.name") now returns None; base returns "Alice".
The public YAML path also reproduces this: SetValue at inputs.other, followed by SendActivity reading Workflow.Inputs.name, loses the message. Please preserve independently resolved records and synchronize aliases only when they still refer to the same canonical input namespace.

Motivation & Context
=If(IsBlank(inputs.name), "World", inputs.name)never applies its default when the caller omitsname, so thesimple_workflowsample printsHello, !forworkflow.run({}). PowerFx fails to compileinputs.namewhen the inputs record has no such field, andDeclarativeWorkflowState.eval()returnsNonefor the whole expression. Details and an input matrix are in #9729.Description & Review Guide
_bind_missing_input_references()findsinputs.<name>/Workflow.Inputs.<name>references in the formula. Any input the caller did not supply is bound to blank (None) in that evaluation's PowerFx symbols, for both aliases. Workflow state is not modified, and other undefined names keep the existingNonebehavior. The regex follows the existing_ENV_REFERENCE_REapproach forEnv.<name>.test_if_with_isblank_when_input_is_missing, next totest_if_with_isblank, which only covered{"name": ""}. It checks both aliases and that the missing key is not written to state.simple_workflowsample now prints the outputs of its second ("Alice") run, which were discarded.None. Expressions that previously evaluated toNoneonly because an input was absent now evaluate normally with that input blank.inputs:schema, butsimple_workflowdoes not declare its inputs.Verification, with the .NET 10 runtime for PowerFx:
mainassert None == 'World'simple_workflowsampleHello, !, then no output for AliceHello, World!,Hello, Alice!packages/declarative/testsPyright on
_declarative_base.pyreports 0 errors. Mypy reports the same 5 errors before and after (none on the changed lines).ruff checkandruff format --checkpass.Related Issue
Fixes #9729
AI Assistance
AI assistance details: Claude Code helped find the bug by running the declarative samples locally, trace it to
DeclarativeWorkflowState.eval(), implement the fix and test, and draft this description and the linked issue.Contribution Checklist
breaking changelabel (or add "[BREAKING]" to the title prefix, before or after any language prefix) — a workflow keeps the label and title prefix in sync automatically.🤖 Generated with Claude Code