ai-workflow-flow-dsl-reference 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/dist/resource-module/WikiPages/README/manifest.xnl +1 -1
  2. package/dist/resource-module/WikiPages/foundation__depa-axioms/manifest.xnl +1 -1
  3. package/dist/resource-module/WikiPages/foundation__naming-axioms/manifest.xnl +1 -1
  4. package/dist/resource-module/WikiPages/foundation__syntax-axioms/manifest.xnl +1 -1
  5. package/dist/resource-module/WikiPages/spec__ai-workflow__ctrl-workflow/manifest.xnl +1 -1
  6. package/dist/resource-module/WikiPages/spec__ai-workflow__data-workflow/manifest.xnl +1 -1
  7. package/dist/resource-module/WikiPages/spec__ai-workflow__resources/manifest.xnl +1 -1
  8. package/dist/resource-module/WikiPages/spec__bp-ctrl-flow__domains/manifest.xnl +1 -1
  9. package/dist/resource-module/WikiPages/spec__bp-ctrl-flow__nodes/manifest.xnl +1 -1
  10. package/dist/resource-module/WikiPages/spec__eager-data-flow__domains/manifest.xnl +1 -1
  11. package/dist/resource-module/WikiPages/spec__eager-data-flow__files/manifest.xnl +1 -1
  12. package/dist/resource-module/WikiPages/spec__eager-data-flow__nodes/manifest.xnl +1 -1
  13. package/dist/resource-module/WikiPages/spec__eager-data-flow__refs/manifest.xnl +1 -1
  14. package/dist/resource-module/WikiPages/spec__flow-core__domains/manifest.xnl +1 -1
  15. package/dist/resource-module/WikiPages/spec__flow-core__files/manifest.xnl +1 -1
  16. package/dist/resource-module/WikiPages/spec__flow-core__nodes/manifest.xnl +1 -1
  17. package/dist/resource-module/WikiPages/spec__flow-core__orchestration/manifest.xnl +1 -1
  18. package/dist/resource-module/WikiPages/spec__flow-core__refs/manifest.xnl +1 -1
  19. package/dist/resource-module/WikiPages/spec__instant-ctrl-flow__domains/manifest.xnl +1 -1
  20. package/dist/resource-module/WikiPages/spec__instant-ctrl-flow__nodes/manifest.xnl +1 -1
  21. package/dist/resource-module/WikiPages/spec__work-ctrl-flow__domains/manifest.xnl +1 -1
  22. package/dist/resource-module/WikiPages/spec__work-ctrl-flow__nodes/manifest.xnl +1 -1
  23. package/dist/resource-module/WikiPages/std__ai-ctrl-workflow__axioms/manifest.xnl +1 -1
  24. package/dist/resource-module/WikiPages/std__ai-data-workflow__axioms/manifest.xnl +1 -1
  25. package/dist/resource-module/WikiPages/std__behavior-tree__axioms/manifest.xnl +1 -1
  26. package/dist/resource-module/WikiPages/std__bp-ctrl-flow__axioms/manifest.xnl +1 -1
  27. package/dist/resource-module/WikiPages/std__eager-data-flow__axioms/manifest.xnl +1 -1
  28. package/dist/resource-module/WikiPages/std__instant-ctrl-flow__axioms/manifest.xnl +1 -1
  29. package/dist/resource-module/WikiPages/std__work-ctrl-flow__axioms/manifest.xnl +1 -1
  30. package/dist/resource-module/content/.depa-flow-dsl-provenance.json +4 -4
  31. package/dist/resource-module/content/spec/ai-workflow/resources.md +44 -1
  32. package/dist/resource-module/manifest.xnl +1 -1
  33. package/package.json +1 -1
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Readme apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Readme apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: README.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Foundation.Depa.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Foundation.Depa.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: foundation/depa-axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Foundation.Naming.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Foundation.Naming.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: foundation/naming-axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Foundation.Syntax.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Foundation.Syntax.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: foundation/syntax-axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Ai.Workflow.Ctrl.Workflow apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Ai.Workflow.Ctrl.Workflow apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/ai-workflow/ctrl-workflow.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Ai.Workflow.Data.Workflow apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Ai.Workflow.Data.Workflow apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/ai-workflow/data-workflow.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Ai.Workflow.Resources apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Ai.Workflow.Resources apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/ai-workflow/resources.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Bp.Ctrl.Flow.Domains apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Bp.Ctrl.Flow.Domains apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/bp-ctrl-flow/domains.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Bp.Ctrl.Flow.Nodes apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Bp.Ctrl.Flow.Nodes apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/bp-ctrl-flow/nodes.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Eager.Data.Flow.Domains apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Eager.Data.Flow.Domains apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/eager-data-flow/domains.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Eager.Data.Flow.Files apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Eager.Data.Flow.Files apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/eager-data-flow/files.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Eager.Data.Flow.Nodes apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Eager.Data.Flow.Nodes apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/eager-data-flow/nodes.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Eager.Data.Flow.Refs apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Eager.Data.Flow.Refs apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/eager-data-flow/refs.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Domains apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Domains apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/flow-core/domains.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Files apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Files apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/flow-core/files.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Nodes apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Nodes apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/flow-core/nodes.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Orchestration apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Orchestration apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/flow-core/orchestration.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Refs apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Flow.Core.Refs apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/flow-core/refs.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Instant.Ctrl.Flow.Domains apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Instant.Ctrl.Flow.Domains apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/instant-ctrl-flow/domains.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Instant.Ctrl.Flow.Nodes apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Instant.Ctrl.Flow.Nodes apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/instant-ctrl-flow/nodes.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Work.Ctrl.Flow.Domains apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Work.Ctrl.Flow.Domains apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/work-ctrl-flow/domains.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Work.Ctrl.Flow.Nodes apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Spec.Work.Ctrl.Flow.Nodes apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: spec/work-ctrl-flow/nodes.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Ai.Ctrl.Workflow.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Ai.Ctrl.Workflow.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: std/ai-ctrl-workflow/axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Ai.Data.Workflow.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Ai.Data.Workflow.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: std/ai-data-workflow/axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Behavior.Tree.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Behavior.Tree.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: std/behavior-tree/axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Bp.Ctrl.Flow.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Bp.Ctrl.Flow.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: std/bp-ctrl-flow/axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Eager.Data.Flow.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Eager.Data.Flow.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: std/eager-data-flow/axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Instant.Ctrl.Flow.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Instant.Ctrl.Flow.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: std/instant-ctrl-flow/axioms.md."
4
4
  } (
@@ -1,4 +1,4 @@
1
- <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Work.Ctrl.Flow.Axioms apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <WikiPage #Depa.Flows.FlowDsl.Reference.Wiki.Std.Work.Ctrl.Flow.Axioms apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL reference page: std/work-ctrl-flow/axioms.md."
4
4
  } (
@@ -2,10 +2,10 @@
2
2
  "schemaVersion": "depa.flow-dsl-reference/v1",
3
3
  "moduleId": "DepaFlowsFlowDslReference",
4
4
  "packageName": "ai-workflow-flow-dsl-reference",
5
- "packageVersion": "0.1.0",
6
- "resourcePackageVersion": "1.0.0",
5
+ "packageVersion": "0.1.1",
6
+ "resourcePackageVersion": "1.0.1",
7
7
  "source": "depa-flows/docs/flow-dsl",
8
- "sourceTreeDigest": "sha256:21151172535409eb611183cb23793fc0165001144cb61ce8ec0b422de697a7c9",
8
+ "sourceTreeDigest": "sha256:b64896c118d8751130cd149969928da184b0fc1aad357b737d5f4cdd8383125c",
9
9
  "files": [
10
10
  {
11
11
  "path": "README.md",
@@ -33,7 +33,7 @@
33
33
  },
34
34
  {
35
35
  "path": "spec/ai-workflow/resources.md",
36
- "contentDigest": "sha256:5a02995f6a30a1fd5f80f94be4e2244b9c804d3cff7275f2fc57712c75b3a822"
36
+ "contentDigest": "sha256:27ad67b4938515a79009c9687b7a7a9b56d268f53e80dfcacfcf88e9884e3b5f"
37
37
  },
38
38
  {
39
39
  "path": "spec/bp-ctrl-flow/domains.md",
@@ -120,6 +120,36 @@ projector 会按 exact resource identity 在 Halfcode registry 中解析目标
120
120
 
121
121
  projector 只读取这些固定位置。普通 prompt、description、metadata 或其他 property 中即使出现 URI 形式文本或业务词语,也不会产生 tool、policy、task 或 dependency edge。
122
122
 
123
+ ### Executable schema and effect policy
124
+
125
+ `MessageSchema` 必须在唯一的 `schema` property 中声明 JSON Schema value map。schema 是资源内容事实;projector 会把它复制成与 Halfcode record 分离的深度不可变值。缺少 map、出现非有限 number、稀疏 list、accessor、symbol、cycle 或非 plain-data object 时,整个 Agent projection fail closed。
126
+
127
+ ```xnl
128
+ <MessageSchema #depa.flows.demo.Schema.Request apiVersion="depa.flows/v1" version="1.0.0" {
129
+ lifecycle = "Stable"
130
+ schema = {
131
+ type = "object"
132
+ properties = { request = { type = "string" } }
133
+ required = ["request"]
134
+ additionalProperties = false
135
+ }
136
+ }>
137
+ ```
138
+
139
+ `EffectPolicy` 的首个标准化执行 profile 是闭集 `toolMode`:
140
+
141
+ - `declared-only`:运行 host 只可向 Agent 暴露 `ToolRefs[]` 中声明且成功解析的 exact tools;
142
+ - `none`:运行 host 不可向 Agent 暴露工具;若 definition 同时声明非空 `ToolRefs[]`,host 必须 fail closed。
143
+
144
+ ```xnl
145
+ <EffectPolicy #depa.flows.demo.Policy.DeclaredOnly apiVersion="depa.flows/v1" version="1.0.0" {
146
+ lifecycle = "Stable"
147
+ toolMode = "declared-only"
148
+ }>
149
+ ```
150
+
151
+ depa-flows 只投影并冻结 schema/policy 领域事实,不选择 JSON Schema validator、不解析 host tool catalog,也不创建 actor。JSON Schema 校验、exact tool binding 与 actor lifecycle 由运行 host 承担。
152
+
123
153
  ## MaterialPort and MaterialBinding
124
154
 
125
155
  `MaterialPort` 定义 Agent 可消费的 material contract:
@@ -155,6 +185,19 @@ projector 只读取这些固定位置。普通 prompt、description、metadata
155
185
 
156
186
  `AgentTaskRef` 只是资源选择 tuple,不新增 substrate node,也不包含 run id、session、generation、actor 或 provider。所有 ref 都按完整 resource identity 和目标 kind 精确核对;相似名称没有关联语义。
157
187
 
188
+ 被选择的 material 必须在资源根的 `value` property 中声明可执行 `ResourceValue`。projector 深复制并冻结该值,运行 host 按 Agent 的 `MaterialPortRefs[]` authoring 顺序组装输入;`cardinality="many"` 的同一 port 内再按 MaterialBinding resource id 的固定 UTF-16 code-unit 顺序排列。
189
+
190
+ ```xnl
191
+ <RequestMaterial #depa.flows.demo.Material.Request.001 apiVersion="depa.flows/v1" version="1.0.0" {
192
+ lifecycle = "Active"
193
+ value = { request = "request-001" }
194
+ }>
195
+ ```
196
+
197
+ 输入 schema 校验发生在 dispatch 前,输出 schema 校验发生在 Agent 完成、workflow node 接收结果前。MaterialPort 自身的可选 `SchemaRef` 验证每个绑定值;Agent 的 `InputSchemaRef` 验证由 ordered port values 形成的完整输入。任一校验失败都不得启动 provider call、写入成功 result 或隐式丢弃 material。
198
+
199
+ 同一 tuple 同时适用于两种 profile:`AICtrlWorkflow` 的普通 `Run` node 与 `AIDataWorkflow` 的普通 `TransformNode` 可以通过各自明确的 `ai.agent` effect 调用该 Agent。`workflowKind` 必须与目标 workflow record kind 完全一致;depa-flows 不新增 `AIAgentTask` substrate statement,也不根据 node 名称、文字描述或 topology 猜测 Agent 调用。
200
+
158
201
  ## Typed dependency relations
159
202
 
160
203
  depa-flows 只发出闭集 relation:
@@ -235,7 +278,7 @@ const loaded = await loadAIWorkflowResourcePackage({ rootDir: resourceRootDir })
235
278
 
236
279
  - XNL ResourcePackage 和 ResourceRecord:Halfcode-owned authoring facts。
237
280
  - AIWorkflowAppBundleProjection:可从 normalized records 重建的 depa domain projection,不反写 source。
238
- - AIWorkflowAgentResourceProjection:固定 Agent/Message/Material 关系的可重建 depa domain projection,不是第二份 registry。
281
+ - AIWorkflowAgentResourceProjection:固定 Agent/Message/schema/effect-policy/Material 关系及其不可变可执行值的可重建 depa domain projection,不是第二份 registry。
239
282
  - AIWorkflowRunResourceFreezeReceipt:Halfcode snapshot proof + depa selected-resource semantic fingerprint;由运行 host 持久化但不回写 source。
240
283
  - AICtrlWorkflow / AIDataWorkflow definition:workflow domain facts。
241
284
  - workflow snapshot / RunGraph:运行态,不回写 ResourcePackage 或 app projection。
@@ -1,4 +1,4 @@
1
- <ResourcePackage #Depa.Flows.FlowDsl.Reference.Package apiVersion="halfcode.resources/v1" version="1.0.0" {
1
+ <ResourcePackage #Depa.Flows.FlowDsl.Reference.Package apiVersion="halfcode.resources/v1" version="1.0.1" {
2
2
  lifecycle = "Stable"
3
3
  description = "Canonical depa Flow DSL documentation reference resources for authoring Skills."
4
4
  } (
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-workflow-flow-dsl-reference",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "private": false,
5
5
  "description": "Canonical depa Flow DSL reference module for Halfcode authoring assemblies",
6
6
  "type": "module",