@x12i/graphenix-plan-format 1.0.0 → 1.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 (28) hide show
  1. package/dist/index.d.ts +2 -0
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +2 -0
  4. package/dist/index.js.map +1 -1
  5. package/dist/test/golden-fixtures.test.d.ts +2 -0
  6. package/dist/test/golden-fixtures.test.d.ts.map +1 -0
  7. package/dist/test/golden-fixtures.test.js +31 -0
  8. package/dist/test/golden-fixtures.test.js.map +1 -0
  9. package/dist/validators/validate-executable-plan-v2.d.ts.map +1 -1
  10. package/dist/validators/validate-executable-plan-v2.js +1 -81
  11. package/dist/validators/validate-executable-plan-v2.js.map +1 -1
  12. package/dist/validators/validate-execution-unit.d.ts +13 -0
  13. package/dist/validators/validate-execution-unit.d.ts.map +1 -0
  14. package/dist/validators/validate-execution-unit.js +221 -0
  15. package/dist/validators/validate-execution-unit.js.map +1 -0
  16. package/dist/validators/validate-node-execution-plan.d.ts +6 -0
  17. package/dist/validators/validate-node-execution-plan.d.ts.map +1 -0
  18. package/dist/validators/validate-node-execution-plan.js +39 -0
  19. package/dist/validators/validate-node-execution-plan.js.map +1 -0
  20. package/fixtures/content-pipeline.plan.json +1292 -0
  21. package/fixtures/nodes/node-audience-insights.plan.json +184 -0
  22. package/fixtures/nodes/node-execution-strategies.plan.json +162 -0
  23. package/fixtures/nodes/node-hand-authored-units.plan.json +75 -0
  24. package/fixtures/nodes/node-input-synthesis-profile.plan.json +105 -0
  25. package/fixtures/nodes/node-narrative-preprocessor.plan.json +112 -0
  26. package/fixtures/nodes/node-post-audit.plan.json +106 -0
  27. package/fixtures/nodes/node-professional-answer-plain.plan.json +70 -0
  28. package/package.json +6 -3
@@ -0,0 +1,184 @@
1
+ {
2
+ "nodeId": "node:audience-insights",
3
+ "nodeType": "task",
4
+ "executionClass": "aiTask",
5
+ "skillKey": "professional-answer",
6
+ "selectedCases": {
7
+ "graphModelCaseId": "default"
8
+ },
9
+ "modelSlots": {
10
+ "preActionModel": {
11
+ "selection": {
12
+ "kind": "profileChoice",
13
+ "key": "cheap/default"
14
+ },
15
+ "source": "graphDefault",
16
+ "inherited": true,
17
+ "graphCaseId": "default"
18
+ },
19
+ "skillModel": {
20
+ "selection": {
21
+ "kind": "profileChoice",
22
+ "key": "vol/default"
23
+ },
24
+ "source": "graphDefault",
25
+ "inherited": true,
26
+ "graphCaseId": "default"
27
+ },
28
+ "postActionModel": {
29
+ "selection": {
30
+ "kind": "profileChoice",
31
+ "key": "cheap/default"
32
+ },
33
+ "source": "graphDefault",
34
+ "inherited": true,
35
+ "graphCaseId": "default"
36
+ }
37
+ },
38
+ "invokeContract": {
39
+ "taskVariable": {
40
+ "question": "Who is the primary audience for this campaign?",
41
+ "outputContract": {
42
+ "shortAnswer": "One paragraph summary.",
43
+ "fullAnswer": "Bullet list of segments and pains."
44
+ }
45
+ },
46
+ "inputsConfig": {
47
+ "brief": {
48
+ "executionMemoryPath": "executionMemory.input"
49
+ }
50
+ },
51
+ "smartInput": {
52
+ "paths": [
53
+ {
54
+ "path": "executionMemory.input",
55
+ "label": "Campaign brief"
56
+ }
57
+ ]
58
+ },
59
+ "executionMapping": {
60
+ "path": "content.audience",
61
+ "mode": "replace",
62
+ "map": {
63
+ "shortAnswer": "output.parsed.shortAnswer",
64
+ "fullAnswer": "output.parsed.fullAnswer"
65
+ }
66
+ },
67
+ "pipeline": {
68
+ "executionStrategies": [],
69
+ "aiTaskStrategies": {
70
+ "pre": "synthesis",
71
+ "preInputStrategy": "execution-memory-only"
72
+ }
73
+ }
74
+ },
75
+ "executionUnits": [
76
+ {
77
+ "unitId": "unit:node:audience-insights:pre:0",
78
+ "nodeId": "node:audience-insights",
79
+ "unitKind": "externalPreUtility",
80
+ "invokeMode": "externalRunTask",
81
+ "order": 0,
82
+ "strategyKey": "synthesis",
83
+ "actionKey": "synthesis",
84
+ "modelSlot": "preActionModel",
85
+ "modelSelection": {
86
+ "kind": "profileChoice",
87
+ "key": "cheap/default"
88
+ },
89
+ "modelSource": "graphDefault",
90
+ "unitParams": {
91
+ "synthesisInputStrategy": "execution-memory-only"
92
+ },
93
+ "invokeContract": {
94
+ "reads": [
95
+ "executionMemory.input"
96
+ ],
97
+ "writes": [
98
+ {
99
+ "destination": "execution",
100
+ "key": "xynthesized",
101
+ "mode": "replace"
102
+ }
103
+ ],
104
+ "includeContextInPrompt": true
105
+ },
106
+ "sourcePath": "/graph/nodes/0/parameters/taskConfiguration/aiTaskStrategies/pre"
107
+ },
108
+ {
109
+ "unitId": "unit:node:audience-insights:main",
110
+ "nodeId": "node:audience-insights",
111
+ "unitKind": "mainSkill",
112
+ "invokeMode": "mainRunTask",
113
+ "order": 1,
114
+ "skillKey": "professional-answer",
115
+ "modelSlot": "skillModel",
116
+ "modelSelection": {
117
+ "kind": "profileChoice",
118
+ "key": "vol/default"
119
+ },
120
+ "modelSource": "graphDefault",
121
+ "invokeContract": {
122
+ "reads": [
123
+ "executionMemory.input"
124
+ ],
125
+ "writes": [
126
+ {
127
+ "destination": "response",
128
+ "key": "skillOutput",
129
+ "mode": "replace"
130
+ }
131
+ ]
132
+ },
133
+ "sourcePath": "/graph/nodes/0/parameters/skillKey"
134
+ },
135
+ {
136
+ "unitId": "unit:node:audience-insights:mapping",
137
+ "nodeId": "node:audience-insights",
138
+ "unitKind": "mapping",
139
+ "invokeMode": "none",
140
+ "order": 2,
141
+ "outputContract": {
142
+ "path": "content.audience",
143
+ "mode": "replace",
144
+ "map": {
145
+ "shortAnswer": "output.parsed.shortAnswer",
146
+ "fullAnswer": "output.parsed.fullAnswer"
147
+ }
148
+ },
149
+ "invokeContract": {
150
+ "reads": [
151
+ "response.skillOutput"
152
+ ],
153
+ "writes": [
154
+ {
155
+ "destination": "execution",
156
+ "key": "content.audience",
157
+ "mode": "replace"
158
+ }
159
+ ]
160
+ },
161
+ "sourcePath": "/graph/nodes/0/parameters/executionMapping"
162
+ }
163
+ ],
164
+ "outputMapping": {
165
+ "path": "content.audience",
166
+ "mode": "replace",
167
+ "map": {
168
+ "shortAnswer": "output.parsed.shortAnswer",
169
+ "fullAnswer": "output.parsed.fullAnswer"
170
+ }
171
+ },
172
+ "executionMapping": {
173
+ "path": "content.audience",
174
+ "mode": "replace",
175
+ "map": {
176
+ "shortAnswer": "output.parsed.shortAnswer",
177
+ "fullAnswer": "output.parsed.fullAnswer"
178
+ }
179
+ },
180
+ "planVersion": "graphenix.node-plan/v2.1",
181
+ "compiledAt": "2026-06-07T15:07:47.691Z",
182
+ "compilerVersion": "1.1.0",
183
+ "sourcePath": "/graph/nodes/0"
184
+ }
@@ -0,0 +1,162 @@
1
+ {
2
+ "nodeId": "node:professional-answer",
3
+ "nodeType": "task",
4
+ "executionClass": "aiTask",
5
+ "skillKey": "professional-answer",
6
+ "selectedCases": {
7
+ "graphModelCaseId": "default"
8
+ },
9
+ "modelSlots": {
10
+ "preActionModel": {
11
+ "selection": {
12
+ "kind": "profileChoice",
13
+ "key": "cheap/default"
14
+ },
15
+ "source": "graphDefault",
16
+ "inherited": true,
17
+ "graphCaseId": "default"
18
+ },
19
+ "skillModel": {
20
+ "selection": {
21
+ "kind": "profileChoice",
22
+ "key": "vol/default"
23
+ },
24
+ "source": "graphDefault",
25
+ "inherited": true,
26
+ "graphCaseId": "default"
27
+ },
28
+ "postActionModel": {
29
+ "selection": {
30
+ "kind": "profileChoice",
31
+ "key": "cheap/default"
32
+ },
33
+ "source": "graphDefault",
34
+ "inherited": true,
35
+ "graphCaseId": "default"
36
+ }
37
+ },
38
+ "invokeContract": {
39
+ "inputsConfig": {
40
+ "brief": {
41
+ "executionMemoryPath": "executionMemory.input"
42
+ }
43
+ },
44
+ "pipeline": {
45
+ "executionStrategies": [
46
+ {
47
+ "strategyKey": "planner",
48
+ "phase": "before",
49
+ "priority": 0
50
+ },
51
+ {
52
+ "strategyKey": "optimizer",
53
+ "phase": "after",
54
+ "priority": 0,
55
+ "maxIterations": 2
56
+ }
57
+ ],
58
+ "aiTaskStrategies": {
59
+ "pre": "synthesis",
60
+ "preInputStrategy": "execution-memory-only"
61
+ }
62
+ }
63
+ },
64
+ "executionUnits": [
65
+ {
66
+ "unitId": "unit:node:professional-answer:pre:0",
67
+ "nodeId": "node:professional-answer",
68
+ "unitKind": "externalPreUtility",
69
+ "invokeMode": "externalRunTask",
70
+ "order": 0,
71
+ "strategyKey": "synthesis",
72
+ "actionKey": "synthesis",
73
+ "modelSlot": "preActionModel",
74
+ "modelSelection": {
75
+ "kind": "profileChoice",
76
+ "key": "cheap/default"
77
+ },
78
+ "modelSource": "graphDefault",
79
+ "unitParams": {
80
+ "synthesisInputStrategy": "execution-memory-only"
81
+ },
82
+ "invokeContract": {
83
+ "reads": [
84
+ "executionMemory.input"
85
+ ],
86
+ "writes": [
87
+ {
88
+ "destination": "execution",
89
+ "key": "xynthesized",
90
+ "mode": "replace"
91
+ }
92
+ ],
93
+ "includeContextInPrompt": true
94
+ },
95
+ "sourcePath": "/graph/nodes/0/parameters/taskConfiguration/aiTaskStrategies/pre"
96
+ },
97
+ {
98
+ "unitId": "unit:node:professional-answer:planner:0",
99
+ "nodeId": "node:professional-answer",
100
+ "unitKind": "executionStrategyPlanner",
101
+ "invokeMode": "executionStrategyPlanner",
102
+ "order": 1,
103
+ "strategyKey": "execution-plan",
104
+ "modelSlot": "postActionModel",
105
+ "modelSelection": {
106
+ "kind": "profileChoice",
107
+ "key": "cheap/default"
108
+ },
109
+ "modelSource": "graphDefault",
110
+ "invokeContract": {
111
+ "reads": [
112
+ "executionMemory.input",
113
+ "input",
114
+ "response.skillOutput"
115
+ ],
116
+ "writes": [
117
+ {
118
+ "destination": "execution",
119
+ "key": "executionPlan",
120
+ "mode": "replace"
121
+ }
122
+ ]
123
+ },
124
+ "sourcePath": "/graph/nodes/0/parameters/taskConfiguration/executionStrategies/0"
125
+ },
126
+ {
127
+ "unitId": "unit:node:professional-answer:main",
128
+ "nodeId": "node:professional-answer",
129
+ "unitKind": "mainSkill",
130
+ "invokeMode": "mainRunTask",
131
+ "order": 2,
132
+ "skillKey": "professional-answer",
133
+ "modelSlot": "skillModel",
134
+ "modelSelection": {
135
+ "kind": "profileChoice",
136
+ "key": "vol/default"
137
+ },
138
+ "modelSource": "graphDefault",
139
+ "invokeContract": {
140
+ "reads": [
141
+ "executionMemory.input"
142
+ ],
143
+ "writes": [
144
+ {
145
+ "destination": "response",
146
+ "key": "skillOutput",
147
+ "mode": "replace"
148
+ }
149
+ ]
150
+ },
151
+ "sourcePath": "/graph/nodes/0/parameters/skillKey",
152
+ "optimizerPolicy": {
153
+ "strategyKey": "execution-evaluate-result",
154
+ "maxIterations": 2
155
+ }
156
+ }
157
+ ],
158
+ "planVersion": "graphenix.node-plan/v2.1",
159
+ "compiledAt": "2026-06-07T15:07:47.736Z",
160
+ "compilerVersion": "1.1.0",
161
+ "sourcePath": "/graph/nodes/0"
162
+ }
@@ -0,0 +1,75 @@
1
+ {
2
+ "nodeId": "node:professional-answer",
3
+ "nodeType": "task",
4
+ "executionClass": "aiTask",
5
+ "skillKey": "professional-answer",
6
+ "selectedCases": {
7
+ "graphModelCaseId": "default"
8
+ },
9
+ "modelSlots": {
10
+ "preActionModel": {
11
+ "selection": {
12
+ "kind": "profileChoice",
13
+ "key": "cheap/default"
14
+ },
15
+ "source": "graphDefault",
16
+ "inherited": true,
17
+ "graphCaseId": "default"
18
+ },
19
+ "skillModel": {
20
+ "selection": {
21
+ "kind": "profileChoice",
22
+ "key": "vol/default"
23
+ },
24
+ "source": "graphDefault",
25
+ "inherited": true,
26
+ "graphCaseId": "default"
27
+ },
28
+ "postActionModel": {
29
+ "selection": {
30
+ "kind": "profileChoice",
31
+ "key": "cheap/default"
32
+ },
33
+ "source": "graphDefault",
34
+ "inherited": true,
35
+ "graphCaseId": "default"
36
+ }
37
+ },
38
+ "invokeContract": {
39
+ "pipeline": {
40
+ "executionStrategies": []
41
+ }
42
+ },
43
+ "executionUnits": [
44
+ {
45
+ "unitId": "unit:node:professional-answer:main",
46
+ "unitKind": "mainSkill",
47
+ "invokeMode": "mainRunTask",
48
+ "order": 0,
49
+ "skillKey": "professional-answer",
50
+ "modelSlot": "skillModel",
51
+ "modelSelection": {
52
+ "kind": "profileChoice",
53
+ "key": "vol/default"
54
+ },
55
+ "invokeContract": {
56
+ "reads": [
57
+ "executionMemory.input"
58
+ ],
59
+ "writes": [
60
+ {
61
+ "destination": "response",
62
+ "key": "skillOutput",
63
+ "mode": "replace"
64
+ }
65
+ ]
66
+ },
67
+ "sourcePath": "/graph/nodes/node:professional-answer/parameters/taskConfiguration/executionUnits/0",
68
+ "nodeId": "node:professional-answer"
69
+ }
70
+ ],
71
+ "planVersion": "graphenix.node-plan/v2.1",
72
+ "compiledAt": "2026-06-07T15:07:47.714Z",
73
+ "compilerVersion": "1.1.0",
74
+ "sourcePath": "/graph/nodes/0"
75
+ }
@@ -0,0 +1,105 @@
1
+ {
2
+ "nodeId": "node:professional-answer",
3
+ "nodeType": "task",
4
+ "executionClass": "aiTask",
5
+ "skillKey": "professional-answer",
6
+ "selectedCases": {
7
+ "graphModelCaseId": "default"
8
+ },
9
+ "modelSlots": {
10
+ "preActionModel": {
11
+ "selection": {
12
+ "kind": "profileChoice",
13
+ "key": "cheap/default"
14
+ },
15
+ "source": "graphDefault",
16
+ "inherited": true,
17
+ "graphCaseId": "default"
18
+ },
19
+ "skillModel": {
20
+ "selection": {
21
+ "kind": "profileChoice",
22
+ "key": "vol/default"
23
+ },
24
+ "source": "graphDefault",
25
+ "inherited": true,
26
+ "graphCaseId": "default"
27
+ },
28
+ "postActionModel": {
29
+ "selection": {
30
+ "kind": "profileChoice",
31
+ "key": "cheap/default"
32
+ },
33
+ "source": "graphDefault",
34
+ "inherited": true,
35
+ "graphCaseId": "default"
36
+ }
37
+ },
38
+ "invokeContract": {
39
+ "pipeline": {
40
+ "executionStrategies": [],
41
+ "aiTaskProfile": {
42
+ "inputSynthesis": {
43
+ "enabled": true
44
+ }
45
+ }
46
+ }
47
+ },
48
+ "executionUnits": [
49
+ {
50
+ "unitId": "unit:node:professional-answer:pipeline:inputSynthesis",
51
+ "nodeId": "node:professional-answer",
52
+ "unitKind": "pipelinePhase",
53
+ "invokeMode": "pipelinePhase",
54
+ "order": 0,
55
+ "strategyKey": "inputSynthesis",
56
+ "modelSlot": "preActionModel",
57
+ "modelSelection": {
58
+ "kind": "profileChoice",
59
+ "key": "cheap/default"
60
+ },
61
+ "modelSource": "graphDefault",
62
+ "invokeContract": {
63
+ "reads": [],
64
+ "writes": [
65
+ {
66
+ "destination": "execution",
67
+ "key": "synthesizedContext",
68
+ "mode": "merge"
69
+ }
70
+ ],
71
+ "includeContextInPrompt": true
72
+ },
73
+ "sourcePath": "/graph/nodes/0/parameters/taskConfiguration/aiTaskProfile/inputSynthesis"
74
+ },
75
+ {
76
+ "unitId": "unit:node:professional-answer:main",
77
+ "nodeId": "node:professional-answer",
78
+ "unitKind": "mainSkill",
79
+ "invokeMode": "mainRunTask",
80
+ "order": 1,
81
+ "skillKey": "professional-answer",
82
+ "modelSlot": "skillModel",
83
+ "modelSelection": {
84
+ "kind": "profileChoice",
85
+ "key": "vol/default"
86
+ },
87
+ "modelSource": "graphDefault",
88
+ "invokeContract": {
89
+ "reads": [],
90
+ "writes": [
91
+ {
92
+ "destination": "response",
93
+ "key": "skillOutput",
94
+ "mode": "replace"
95
+ }
96
+ ]
97
+ },
98
+ "sourcePath": "/graph/nodes/0/parameters/skillKey"
99
+ }
100
+ ],
101
+ "planVersion": "graphenix.node-plan/v2.1",
102
+ "compiledAt": "2026-06-07T15:07:47.729Z",
103
+ "compilerVersion": "1.1.0",
104
+ "sourcePath": "/graph/nodes/0"
105
+ }
@@ -0,0 +1,112 @@
1
+ {
2
+ "nodeId": "node:professional-answer",
3
+ "nodeType": "task",
4
+ "executionClass": "aiTask",
5
+ "skillKey": "professional-answer",
6
+ "selectedCases": {
7
+ "graphModelCaseId": "default"
8
+ },
9
+ "modelSlots": {
10
+ "preActionModel": {
11
+ "selection": {
12
+ "kind": "profileChoice",
13
+ "key": "cheap/default"
14
+ },
15
+ "source": "graphDefault",
16
+ "inherited": true,
17
+ "graphCaseId": "default"
18
+ },
19
+ "skillModel": {
20
+ "selection": {
21
+ "kind": "profileChoice",
22
+ "key": "vol/default"
23
+ },
24
+ "source": "graphDefault",
25
+ "inherited": true,
26
+ "graphCaseId": "default"
27
+ },
28
+ "postActionModel": {
29
+ "selection": {
30
+ "kind": "profileChoice",
31
+ "key": "cheap/default"
32
+ },
33
+ "source": "graphDefault",
34
+ "inherited": true,
35
+ "graphCaseId": "default"
36
+ }
37
+ },
38
+ "invokeContract": {
39
+ "pipeline": {
40
+ "executionStrategies": [],
41
+ "narrix": {
42
+ "datasetId": "ds:campaign",
43
+ "attachToField": "executionMemory._narrative"
44
+ },
45
+ "narrixMode": "preprocessor"
46
+ }
47
+ },
48
+ "executionUnits": [
49
+ {
50
+ "unitId": "unit:node:professional-answer:narrative:pre",
51
+ "nodeId": "node:professional-answer",
52
+ "unitKind": "narrativePreprocessor",
53
+ "invokeMode": "narrativePreprocessor",
54
+ "order": 0,
55
+ "strategyKey": "narrative-preprocessor",
56
+ "modelSlot": "preActionModel",
57
+ "modelSelection": {
58
+ "kind": "profileChoice",
59
+ "key": "cheap/default"
60
+ },
61
+ "modelSource": "graphDefault",
62
+ "unitParams": {
63
+ "datasetId": "ds:campaign",
64
+ "attachToField": "executionMemory._narrative",
65
+ "enableWebScope": false
66
+ },
67
+ "invokeContract": {
68
+ "reads": [
69
+ "executionMemory.input",
70
+ "input"
71
+ ],
72
+ "writes": [
73
+ {
74
+ "destination": "execution",
75
+ "key": "executionMemory._narrative",
76
+ "mode": "merge"
77
+ }
78
+ ]
79
+ },
80
+ "sourcePath": "/graph/nodes/0/parameters/taskConfiguration/narrixMode"
81
+ },
82
+ {
83
+ "unitId": "unit:node:professional-answer:main",
84
+ "nodeId": "node:professional-answer",
85
+ "unitKind": "mainSkill",
86
+ "invokeMode": "mainRunTask",
87
+ "order": 1,
88
+ "skillKey": "professional-answer",
89
+ "modelSlot": "skillModel",
90
+ "modelSelection": {
91
+ "kind": "profileChoice",
92
+ "key": "vol/default"
93
+ },
94
+ "modelSource": "graphDefault",
95
+ "invokeContract": {
96
+ "reads": [],
97
+ "writes": [
98
+ {
99
+ "destination": "response",
100
+ "key": "skillOutput",
101
+ "mode": "replace"
102
+ }
103
+ ]
104
+ },
105
+ "sourcePath": "/graph/nodes/0/parameters/skillKey"
106
+ }
107
+ ],
108
+ "planVersion": "graphenix.node-plan/v2.1",
109
+ "compiledAt": "2026-06-07T15:07:47.708Z",
110
+ "compilerVersion": "1.1.0",
111
+ "sourcePath": "/graph/nodes/0"
112
+ }