@tagma/sdk 0.6.11 → 0.7.0

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 (132) hide show
  1. package/README.md +91 -18
  2. package/dist/bootstrap.d.ts +6 -6
  3. package/dist/bootstrap.d.ts.map +1 -1
  4. package/dist/bootstrap.js +5 -6
  5. package/dist/bootstrap.js.map +1 -1
  6. package/dist/config-ops.d.ts +4 -2
  7. package/dist/config-ops.d.ts.map +1 -1
  8. package/dist/config-ops.js +16 -2
  9. package/dist/config-ops.js.map +1 -1
  10. package/dist/config.d.ts +8 -0
  11. package/dist/config.d.ts.map +1 -0
  12. package/dist/config.js +5 -0
  13. package/dist/config.js.map +1 -0
  14. package/dist/core/dataflow.d.ts +23 -0
  15. package/dist/core/dataflow.d.ts.map +1 -0
  16. package/dist/core/dataflow.js +63 -0
  17. package/dist/core/dataflow.js.map +1 -0
  18. package/dist/core/log-prune.d.ts +16 -0
  19. package/dist/core/log-prune.d.ts.map +1 -0
  20. package/dist/core/log-prune.js +34 -0
  21. package/dist/core/log-prune.js.map +1 -0
  22. package/dist/core/preflight.d.ts +13 -0
  23. package/dist/core/preflight.d.ts.map +1 -0
  24. package/dist/core/preflight.js +61 -0
  25. package/dist/core/preflight.js.map +1 -0
  26. package/dist/core/run-context.d.ts +52 -0
  27. package/dist/core/run-context.d.ts.map +1 -0
  28. package/dist/core/run-context.js +156 -0
  29. package/dist/core/run-context.js.map +1 -0
  30. package/dist/core/run-state.d.ts +25 -0
  31. package/dist/core/run-state.d.ts.map +1 -0
  32. package/dist/core/run-state.js +93 -0
  33. package/dist/core/run-state.js.map +1 -0
  34. package/dist/core/scheduler.d.ts +13 -0
  35. package/dist/core/scheduler.d.ts.map +1 -0
  36. package/dist/core/scheduler.js +35 -0
  37. package/dist/core/scheduler.js.map +1 -0
  38. package/dist/core/task-executor.d.ts +13 -0
  39. package/dist/core/task-executor.d.ts.map +1 -0
  40. package/dist/core/task-executor.js +639 -0
  41. package/dist/core/task-executor.js.map +1 -0
  42. package/dist/core/trigger-errors.d.ts +9 -0
  43. package/dist/core/trigger-errors.d.ts.map +1 -0
  44. package/dist/core/trigger-errors.js +15 -0
  45. package/dist/core/trigger-errors.js.map +1 -0
  46. package/dist/engine.d.ts +6 -14
  47. package/dist/engine.d.ts.map +1 -1
  48. package/dist/engine.js +71 -990
  49. package/dist/engine.js.map +1 -1
  50. package/dist/index.d.ts +9 -0
  51. package/dist/index.d.ts.map +1 -0
  52. package/dist/index.js +6 -0
  53. package/dist/index.js.map +1 -0
  54. package/dist/pipeline-definition.d.ts +3 -0
  55. package/dist/pipeline-definition.d.ts.map +1 -0
  56. package/dist/pipeline-definition.js +4 -0
  57. package/dist/pipeline-definition.js.map +1 -0
  58. package/dist/pipeline-runner.d.ts +2 -1
  59. package/dist/pipeline-runner.d.ts.map +1 -1
  60. package/dist/pipeline-runner.js +2 -2
  61. package/dist/pipeline-runner.js.map +1 -1
  62. package/dist/plugins.d.ts +5 -0
  63. package/dist/plugins.d.ts.map +1 -0
  64. package/dist/plugins.js +3 -0
  65. package/dist/plugins.js.map +1 -0
  66. package/dist/ports.d.ts +23 -1
  67. package/dist/ports.d.ts.map +1 -1
  68. package/dist/ports.js +160 -0
  69. package/dist/ports.js.map +1 -1
  70. package/dist/registry.d.ts +3 -19
  71. package/dist/registry.d.ts.map +1 -1
  72. package/dist/registry.js +7 -35
  73. package/dist/registry.js.map +1 -1
  74. package/dist/schema.d.ts.map +1 -1
  75. package/dist/schema.js +7 -3
  76. package/dist/schema.js.map +1 -1
  77. package/dist/tagma.d.ts +24 -0
  78. package/dist/tagma.d.ts.map +1 -0
  79. package/dist/tagma.js +23 -0
  80. package/dist/tagma.js.map +1 -0
  81. package/dist/utils-api.d.ts +2 -0
  82. package/dist/utils-api.d.ts.map +1 -0
  83. package/dist/utils-api.js +2 -0
  84. package/dist/utils-api.js.map +1 -0
  85. package/dist/validate-raw.js +118 -0
  86. package/dist/validate-raw.js.map +1 -1
  87. package/dist/yaml.d.ts +4 -0
  88. package/dist/yaml.d.ts.map +1 -0
  89. package/dist/yaml.js +3 -0
  90. package/dist/yaml.js.map +1 -0
  91. package/package.json +53 -8
  92. package/src/bootstrap.ts +6 -6
  93. package/src/config-ops.ts +12 -2
  94. package/src/config.ts +26 -0
  95. package/src/core/dataflow.test.ts +167 -0
  96. package/src/core/dataflow.ts +118 -0
  97. package/src/core/log-prune.test.ts +58 -0
  98. package/src/core/log-prune.ts +43 -0
  99. package/src/core/preflight.test.ts +49 -0
  100. package/src/core/preflight.ts +89 -0
  101. package/src/core/run-context.test.ts +244 -0
  102. package/src/core/run-context.ts +207 -0
  103. package/src/core/run-state.test.ts +98 -0
  104. package/src/core/run-state.ts +122 -0
  105. package/src/core/scheduler.test.ts +83 -0
  106. package/src/core/scheduler.ts +42 -0
  107. package/src/core/task-executor.ts +803 -0
  108. package/src/core/trigger-errors.ts +15 -0
  109. package/src/engine-ports.test.ts +66 -0
  110. package/src/engine-task-type.test.ts +56 -0
  111. package/src/engine.ts +86 -1180
  112. package/src/index.ts +28 -0
  113. package/src/pipeline-definition.ts +5 -0
  114. package/src/pipeline-runner.ts +3 -2
  115. package/src/plugin-registry.test.ts +7 -10
  116. package/src/plugins.ts +18 -0
  117. package/src/ports.test.ts +127 -0
  118. package/src/ports.ts +224 -1
  119. package/src/registry.ts +7 -49
  120. package/src/schema-ports.test.ts +86 -0
  121. package/src/schema.ts +7 -3
  122. package/src/tagma.test.ts +84 -0
  123. package/src/tagma.ts +47 -0
  124. package/src/utils-api.ts +8 -0
  125. package/src/validate-raw-ports.test.ts +66 -0
  126. package/src/validate-raw.ts +137 -0
  127. package/src/yaml.ts +11 -0
  128. package/dist/sdk.d.ts +0 -32
  129. package/dist/sdk.d.ts.map +0 -1
  130. package/dist/sdk.js +0 -41
  131. package/dist/sdk.js.map +0 -1
  132. package/src/sdk.ts +0 -147
package/src/sdk.ts DELETED
@@ -1,147 +0,0 @@
1
- // ═══ tagma-sdk public API ═══
2
- //
3
- // This is the SDK entry point. Import from here, not from internal modules.
4
- // The CLI (src/index.ts in the CLI project) also imports from here.
5
-
6
- // ── Core engine ──
7
- export { runPipeline, TriggerBlockedError, TriggerTimeoutError } from './engine';
8
- export type { EngineResult, RunPipelineOptions, RunEventPayload } from './engine';
9
-
10
- // ── Pipeline runner (multi-pipeline lifecycle management) ──
11
- export { PipelineRunner } from './pipeline-runner';
12
- export type { PipelineRunnerStatus } from './pipeline-runner';
13
-
14
- // ── Raw config CRUD (visual editor / YAML sync) ──
15
- export {
16
- createEmptyPipeline,
17
- setPipelineField,
18
- upsertTrack,
19
- removeTrack,
20
- moveTrack,
21
- updateTrack,
22
- upsertTask,
23
- removeTask,
24
- moveTask,
25
- transferTask,
26
- } from './config-ops';
27
-
28
- // ── Raw config validation (real-time feedback) ──
29
- export { validateRaw } from './validate-raw';
30
- export type { ValidationError, KnownPluginTypes } from './validate-raw';
31
-
32
- // ── YAML compiler (validation + compile log support) ──
33
- export { compileYamlContent } from './yaml-compiler';
34
- export type { YamlCompileResult, CompileYamlOptions } from './yaml-compiler';
35
-
36
- // ── Schema: parse / resolve / load / serialize / validate ──
37
- export {
38
- parseYaml,
39
- resolveConfig,
40
- loadPipeline,
41
- serializePipeline,
42
- deresolvePipeline,
43
- validateConfig,
44
- } from './schema';
45
-
46
- // ── DAG ──
47
- export { buildDag, buildRawDag } from './dag';
48
- export type { DagNode, Dag, RawDagNode, RawDag } from './dag';
49
-
50
- // ── Plugin registry ──
51
- export { bootstrapBuiltins } from './bootstrap';
52
- export {
53
- PluginRegistry,
54
- defaultRegistry,
55
- loadPlugins,
56
- registerPlugin,
57
- unregisterPlugin,
58
- getHandler,
59
- hasHandler,
60
- listRegistered,
61
- isValidPluginName,
62
- PLUGIN_NAME_RE,
63
- readPluginManifest,
64
- } from './registry';
65
- export type { RegisterResult } from './registry';
66
-
67
- // ── Approval gateway ──
68
- export { InMemoryApprovalGateway } from './approval';
69
- export type {
70
- ApprovalGateway,
71
- ApprovalRequest,
72
- ApprovalDecision,
73
- ApprovalOutcome,
74
- ApprovalEvent,
75
- ApprovalListener,
76
- } from './approval';
77
-
78
- // ── Approval adapters ──
79
- export { attachStdinApprovalAdapter } from './adapters/stdin-approval';
80
- export type { StdinApprovalAdapter } from './adapters/stdin-approval';
81
- export { attachWebSocketApprovalAdapter } from './adapters/websocket-approval';
82
- export type {
83
- WebSocketApprovalAdapter,
84
- WebSocketApprovalAdapterOptions,
85
- } from './adapters/websocket-approval';
86
-
87
- // ── Logger ──
88
- export { Logger, tailLines, clip } from './logger';
89
- export type { LogRecord, LogLevel, LogListener } from './logger';
90
-
91
- // ── Hook context types (useful for frontend display) ──
92
- export type { HookResult, PipelineInfo, TrackInfo, TaskInfo } from './hooks';
93
-
94
- // ── Utils (public subset) ──
95
- export {
96
- parseDuration,
97
- validatePath,
98
- generateRunId,
99
- nowISO,
100
- truncateForName,
101
- _resetShellCache,
102
- } from './utils';
103
-
104
- // ── Task reference resolution (shared id normalization) ──
105
- export {
106
- TASK_ID_RE,
107
- isValidTaskId,
108
- qualifyTaskId,
109
- isQualifiedRef,
110
- buildTaskIndex,
111
- resolveTaskRef,
112
- AMBIGUOUS,
113
- } from './task-ref';
114
- export type { TaskIndex, RefResolution } from './task-ref';
115
-
116
- // ── Prompt document helpers (middleware authors + drivers) ──
117
- export {
118
- promptDocumentFromString,
119
- serializePromptDocument,
120
- appendContext,
121
- prependContext,
122
- renderInputsBlock,
123
- renderOutputSchemaBlock,
124
- } from './prompt-doc';
125
-
126
- // ── Task ports (editor: substitute placeholders, resolve upstream
127
- // values, extract downstream outputs; drivers that wrap the prompt
128
- // may want substituteInputs on their own envelope) ──
129
- export {
130
- substituteInputs,
131
- extractInputReferences,
132
- resolveTaskInputs,
133
- extractTaskOutputs,
134
- inferPromptPorts,
135
- } from './ports';
136
- export type {
137
- SubstituteResult,
138
- InputResolution,
139
- ExtractResult,
140
- PromptPortInference,
141
- PromptPortConflict,
142
- PromptUpstreamNeighbor,
143
- PromptDownstreamNeighbor,
144
- } from './ports';
145
-
146
- // ── All types from @tagma/types + runtime constants ──
147
- export * from './types';