You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 400e8cc
Browse filesBrowse the repository at this point in the historyBrowse files
fix(spec): objectName is planned — the liveness row warns its authors and the describe says no door reads it yet
Drills flow.variables in the liveness ledger (the five wired keys live,
objectName planned with authorWarn), drops the undrilled-container row,
words the describe, TSDoc, docs and changeset in the planned style, pins the
author warning, and gives flow-input-unknown-object an os explain entry.
Claude-Session: https://claude.ai/code/session_01JQwxbaiSvS6eyjEknCGKao
Co-authored-by: Claude <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: .changeset/29442-flow-start-input-record.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,9 +9,9 @@ feat(spec): a flow start input can declare that it is the id of a record of a na
9
9
Clause-②: yes (widening)
10
10
Metadata-protocol: added
11
11
12
-
`FlowVariableSchema` declares one optional key, `objectName`: on an input (`isInput: true`), it says the input's value is the id of one record of the named object, e.g. `{ name: 'accountId', type: 'text', isInput: true, objectName: 'crm_account' }`. The rule it states: every door that starts the flow by name (the trigger route, an action of type flow over REST and MCP `run_action`, a declared endpoint of type flow) loads a declared input from that object in the caller's own scope before the run exists; an id the caller cannot read there is refused `404 RECORD_NOT_FOUND`, and a value that is not an id is refused `400 VALIDATION_FAILED` naming the input. An input without the declaration keeps the visible-read rule: it is judged as a record only where the flow's own definition reads it as a record id.
12
+
`FlowVariableSchema` declares one optional key, `objectName`: on an input (`isInput: true`), it says the input's value is the id of one record of the named object, e.g. `{ name: 'accountId', type: 'text', isInput: true, objectName: 'crm_account' }`. The key is **planned**: no door reads it yet, and `os validate` warns on every flow that writes it (`liveness-planned-property`). The contract it states, for the start doors to enforce: every door that starts the flow by name (the trigger route, an action of type flow over REST and MCP `run_action`, a declared endpoint of type flow) loads a declared input from that object in the caller's own scope before the run exists; an id the caller cannot read there is refused `404 RECORD_NOT_FOUND`, and a value that is not an id is refused `400 VALIDATION_FAILED` naming the input. An input without the declaration keeps the visible-read rule: it is judged as a record only where the flow's own definition reads it as a record id.
13
13
14
14
-**Spec.**`objectName` is an object name (snake_case) and is refused on a variable that is not an input, since no caller's value reaches one. `type` stays the data type: the variable holds the id. A `reference` or `object` key on a flow variable is still refused, and the refusal now names `objectName`. The flow form's variables repeater gains the column, labelled in the metadata-form bundles (en, zh-CN, ja-JP, es-ES).
15
15
-**Lint.**`flow-input-unknown-object`: a declared object the stack does not define is a warning (it may come from another installed package), and an error at the runtime publish gate when the write's package closure does not reach it, the verdict `flow-trigger-unknown-object` gives a trigger object. A `sys_` name is not judged.
16
16
17
-
This is the contract half: the start doors read the declaration in a later change, and until then no door loads a declared input. Nothing to do for existing flows.
17
+
This is the contract half: the start doors read the declaration in a later change, and until then no door loads a declared input, so a start that hands the input an id the caller cannot read still runs. Nothing to do for existing flows.
Copy file name to clipboardExpand all lines: content/docs/automation/flows.mdx
+12-3Lines changed: 12 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2029,7 +2029,7 @@ variables: [
2029
2029
|`isInput`|`boolean`| Available as input parameter |
2030
2030
|`isOutput`|`boolean`| Available as output parameter |
2031
2031
|`defaultValue`|`unknown`| Bound at run start when no parameter supplies one — this is what makes the declaration a guarantee. Optional |
2032
-
|`objectName`|`string`| On an input only: the input is the id of a record of this object. See [a start input that is a record id](#a-start-input-that-is-a-record-id). Optional |
2032
+
|`objectName`|`string`|**Planned.**On an input only (refused at parse on any other variable): the input is the id of a record of this object. No start door reads it yet. See [a start input that is a record id](#a-start-input-that-is-a-record-id). Optional |
2033
2033
2034
2034
### `defaultValue` — declaring a variable is not the same as binding it
"note": "{name,isInput,isOutput} wired. `objectName` (#29425 ruling A, declared by #29442): an input's declaration that its value is the id of a record of the named object. PLANNED consumer, not yet wired: the start doors in packages/runtime/src/flow-start-admission.ts load a declared input from that object in the caller's scope before the run exists — the server half, Blocked-by #29442. Until it lands the key is parsed, validated (input-only, an object name) and linted (flow-input-unknown-object), and no door reads it. `variables` is an undrilled container (scripts/liveness/undrilled-containers.baseline.json), so the key has no row of its own and this note is its record."
65
+
"note": "{name,type,isInput,isOutput,defaultValue} wired; drilled per key (#29442) so `objectName` can carry its own `planned` row and author warning — the blanket row could not say that one child is not read yet.",
66
+
"children": {
67
+
"name": {
68
+
"status": "live",
69
+
"verifiedAt": "2026-11-02",
70
+
"evidence": "packages/services/service-automation/src/dag-traversal.ts#seedDeclaredVariables (binds each declared variable under `v.name`, from `context.params[v.name]` or its default)"
71
+
},
72
+
"type": {
73
+
"status": "live",
74
+
"verifiedAt": "2026-11-02",
75
+
"evidence": "ui/apps/console/src/pages/developer/FlowRunsPage.tsx#FlowTestRunner (the Flow Runs test runner picks each input's widget and coerces its value by `v.type`)",
76
+
"note": "An open string: no engine path coerces by it; the Console test runner is its reader."
77
+
},
78
+
"isInput": {
79
+
"status": "live",
80
+
"verifiedAt": "2026-11-02",
81
+
"evidence": "packages/services/service-automation/src/dag-traversal.ts#seedDeclaredVariables (only an `isInput` variable is bound from the caller's params)"
82
+
},
83
+
"isOutput": {
84
+
"status": "live",
85
+
"verifiedAt": "2026-11-02",
86
+
"evidence": "packages/services/service-automation/src/dag-traversal.ts#executeWithoutRetry (an `isOutput` variable's final value is copied onto the run result's output)"
87
+
},
88
+
"defaultValue": {
89
+
"status": "live",
90
+
"verifiedAt": "2026-11-02",
91
+
"evidence": "packages/services/service-automation/src/dag-traversal.ts#seedDeclaredVariables (bound when no param supplies the name, #4697)"
92
+
},
93
+
"objectName": {
94
+
"status": "planned",
95
+
"verifiedAt": "2026-11-02",
96
+
"evidence": "packages/spec/src/automation/flow.zod.ts#FlowVariableSchema (the superRefine that refuses `objectName` on a variable that is not an input — the one place the key is read today)",
97
+
"authorWarn": true,
98
+
"authorHint": "Keep it, but nothing reads it yet: no start door loads a declared input from its object until the server half of #29425 ruling A ships, so an id the caller cannot read still starts a run.",
99
+
"note": "PLANNED RECORD (#29442, the spec half of #29425 ruling A 6580257050): an input's declaration that its value is the id of one record of the named object. Parsed, refused on a non-input (the evidence above) and linted (`flow-input-unknown-object` in packages/lint/src/validate-flow-trigger-readiness.ts). No door reads it: the start doors' third question (packages/runtime/src/flow-start-admission.ts, `flowDeclaredRecordReads` / `refuseUnreadableFlowStartRecords` in action-execution.ts) judges only inputs the definition reads in plain sight. Carrier: the #29425 server half, Blocked-by #29442 (every start door loads a declared input in the caller's scope, 404 RECORD_NOT_FOUND / 400 VALIDATION_FAILED). Flip to `live` on the commit that cites that reader, drop `authorWarn` / `authorHint` and the describe's planned sentence in that same edit."
0 commit comments