@telorun/kernel 0.2.4 → 0.2.6

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 (192) hide show
  1. package/dist/base-definition.d.ts +14 -0
  2. package/dist/base-definition.d.ts.map +1 -0
  3. package/dist/base-definition.js +17 -0
  4. package/dist/base-definition.js.map +1 -0
  5. package/dist/boot-context-registry.d.ts.map +1 -1
  6. package/dist/boot-context-registry.js +6 -6
  7. package/dist/boot-context-registry.js.map +1 -1
  8. package/dist/capabilities/capabilities/component.yaml +2 -1
  9. package/dist/capabilities/capabilities/executable.yaml +2 -1
  10. package/dist/capabilities/capabilities/handler.yaml +2 -1
  11. package/dist/capabilities/capabilities/listener.yaml +2 -1
  12. package/dist/capabilities/capabilities/provider.yaml +2 -1
  13. package/dist/capabilities/capabilities/template.yaml +2 -1
  14. package/dist/capabilities/capabilities/type.yaml +2 -1
  15. package/dist/capabilities/component.d.ts +3 -0
  16. package/dist/capabilities/component.d.ts.map +1 -0
  17. package/dist/capabilities/component.js +4 -0
  18. package/dist/capabilities/component.js.map +1 -0
  19. package/dist/capabilities/component.yaml +1 -1
  20. package/dist/capabilities/executable.d.ts +3 -0
  21. package/dist/capabilities/executable.d.ts.map +1 -0
  22. package/dist/capabilities/executable.js +5 -0
  23. package/dist/capabilities/executable.js.map +1 -0
  24. package/dist/capabilities/executable.yaml +1 -1
  25. package/dist/capabilities/handler.d.ts +3 -0
  26. package/dist/capabilities/handler.d.ts.map +1 -0
  27. package/dist/capabilities/handler.js +4 -0
  28. package/dist/capabilities/handler.js.map +1 -0
  29. package/dist/capabilities/handler.yaml +1 -1
  30. package/dist/capabilities/invokable.d.ts +3 -0
  31. package/dist/capabilities/invokable.d.ts.map +1 -0
  32. package/dist/capabilities/invokable.js +5 -0
  33. package/dist/capabilities/invokable.js.map +1 -0
  34. package/dist/capabilities/listener.d.ts +3 -0
  35. package/dist/capabilities/listener.d.ts.map +1 -0
  36. package/dist/capabilities/listener.js +5 -0
  37. package/dist/capabilities/listener.js.map +1 -0
  38. package/dist/capabilities/listener.yaml +1 -1
  39. package/dist/capabilities/mount.d.ts +3 -0
  40. package/dist/capabilities/mount.d.ts.map +1 -0
  41. package/dist/capabilities/mount.js +5 -0
  42. package/dist/capabilities/mount.js.map +1 -0
  43. package/dist/capabilities/provider.d.ts +3 -0
  44. package/dist/capabilities/provider.d.ts.map +1 -0
  45. package/dist/capabilities/provider.js +8 -0
  46. package/dist/capabilities/provider.js.map +1 -0
  47. package/dist/capabilities/provider.yaml +1 -1
  48. package/dist/capabilities/runnable.d.ts +3 -0
  49. package/dist/capabilities/runnable.d.ts.map +1 -0
  50. package/dist/capabilities/runnable.js +5 -0
  51. package/dist/capabilities/runnable.js.map +1 -0
  52. package/dist/capabilities/service.d.ts +3 -0
  53. package/dist/capabilities/service.d.ts.map +1 -0
  54. package/dist/capabilities/service.js +5 -0
  55. package/dist/capabilities/service.js.map +1 -0
  56. package/dist/capabilities/template.d.ts +3 -0
  57. package/dist/capabilities/template.d.ts.map +1 -0
  58. package/dist/capabilities/template.js +5 -0
  59. package/dist/capabilities/template.js.map +1 -0
  60. package/dist/capabilities/template.yaml +1 -1
  61. package/dist/capabilities/type.d.ts +3 -0
  62. package/dist/capabilities/type.d.ts.map +1 -0
  63. package/dist/capabilities/type.js +5 -0
  64. package/dist/capabilities/type.js.map +1 -0
  65. package/dist/capabilities/type.yaml +1 -1
  66. package/dist/controller-loader.d.ts +1 -1
  67. package/dist/controller-loader.d.ts.map +1 -1
  68. package/dist/controller-loader.js +6 -3
  69. package/dist/controller-loader.js.map +1 -1
  70. package/dist/controller-registry.d.ts +1 -6
  71. package/dist/controller-registry.d.ts.map +1 -1
  72. package/dist/controller-registry.js +11 -22
  73. package/dist/controller-registry.js.map +1 -1
  74. package/dist/controllers/capability/capability-controller.d.ts +0 -5
  75. package/dist/controllers/capability/capability-controller.d.ts.map +1 -1
  76. package/dist/controllers/capability/capability-controller.js +1 -5
  77. package/dist/controllers/capability/capability-controller.js.map +1 -1
  78. package/dist/controllers/module/import-controller.d.ts +35 -0
  79. package/dist/controllers/module/import-controller.d.ts.map +1 -0
  80. package/dist/controllers/module/import-controller.js +113 -0
  81. package/dist/controllers/module/import-controller.js.map +1 -0
  82. package/dist/controllers/module/module-controller.d.ts +2 -15
  83. package/dist/controllers/module/module-controller.d.ts.map +1 -1
  84. package/dist/controllers/module/module-controller.js +9 -90
  85. package/dist/controllers/module/module-controller.js.map +1 -1
  86. package/dist/controllers/resource-definition/resource-definition-controller.d.ts +3 -4
  87. package/dist/controllers/resource-definition/resource-definition-controller.d.ts.map +1 -1
  88. package/dist/controllers/resource-definition/resource-definition-controller.js +17 -11
  89. package/dist/controllers/resource-definition/resource-definition-controller.js.map +1 -1
  90. package/dist/controllers/resource-definition/resource-template-controller.d.ts +12 -0
  91. package/dist/controllers/resource-definition/resource-template-controller.d.ts.map +1 -0
  92. package/dist/controllers/resource-definition/resource-template-controller.js +112 -0
  93. package/dist/controllers/resource-definition/resource-template-controller.js.map +1 -0
  94. package/dist/evaluation-context.d.ts +91 -0
  95. package/dist/evaluation-context.d.ts.map +1 -0
  96. package/dist/evaluation-context.js +220 -0
  97. package/dist/evaluation-context.js.map +1 -0
  98. package/dist/execution-context.d.ts +13 -0
  99. package/dist/execution-context.d.ts.map +1 -0
  100. package/dist/execution-context.js +14 -0
  101. package/dist/execution-context.js.map +1 -0
  102. package/dist/index.d.ts +1 -4
  103. package/dist/index.d.ts.map +1 -1
  104. package/dist/index.js +0 -3
  105. package/dist/index.js.map +1 -1
  106. package/dist/kernel.d.ts +31 -42
  107. package/dist/kernel.d.ts.map +1 -1
  108. package/dist/kernel.js +315 -371
  109. package/dist/kernel.js.map +1 -1
  110. package/dist/loader.d.ts +11 -10
  111. package/dist/loader.d.ts.map +1 -1
  112. package/dist/loader.js +50 -112
  113. package/dist/loader.js.map +1 -1
  114. package/dist/manifest-adapters/http-adapter.d.ts.map +1 -1
  115. package/dist/manifest-adapters/http-adapter.js +3 -1
  116. package/dist/manifest-adapters/http-adapter.js.map +1 -1
  117. package/dist/manifest-adapters/local-file-adapter.d.ts +7 -5
  118. package/dist/manifest-adapters/local-file-adapter.d.ts.map +1 -1
  119. package/dist/manifest-adapters/local-file-adapter.js +28 -24
  120. package/dist/manifest-adapters/local-file-adapter.js.map +1 -1
  121. package/dist/manifest-adapters/manifest-adapter.d.ts +2 -0
  122. package/dist/manifest-adapters/manifest-adapter.d.ts.map +1 -1
  123. package/dist/manifest-adapters/registry-adapter.d.ts.map +1 -1
  124. package/dist/manifest-adapters/registry-adapter.js +3 -1
  125. package/dist/manifest-adapters/registry-adapter.js.map +1 -1
  126. package/dist/manifest-schemas.d.ts +61 -49
  127. package/dist/manifest-schemas.d.ts.map +1 -1
  128. package/dist/manifest-schemas.js +58 -37
  129. package/dist/manifest-schemas.js.map +1 -1
  130. package/dist/module-context-registry.d.ts +48 -0
  131. package/dist/module-context-registry.d.ts.map +1 -0
  132. package/dist/module-context-registry.js +91 -0
  133. package/dist/module-context-registry.js.map +1 -0
  134. package/dist/module-context.d.ts +31 -0
  135. package/dist/module-context.d.ts.map +1 -0
  136. package/dist/module-context.js +67 -0
  137. package/dist/module-context.js.map +1 -0
  138. package/dist/registry.d.ts +1 -2
  139. package/dist/registry.d.ts.map +1 -1
  140. package/dist/registry.js +3 -3
  141. package/dist/registry.js.map +1 -1
  142. package/dist/resource-context.d.ts +27 -10
  143. package/dist/resource-context.d.ts.map +1 -1
  144. package/dist/resource-context.js +100 -44
  145. package/dist/resource-context.js.map +1 -1
  146. package/dist/schema-valiator.d.ts.map +1 -1
  147. package/dist/schema-valiator.js +16 -3
  148. package/dist/schema-valiator.js.map +1 -1
  149. package/dist/snapshot-serializer.d.ts +1 -2
  150. package/dist/snapshot-serializer.d.ts.map +1 -1
  151. package/dist/snapshot-serializer.js.map +1 -1
  152. package/dist/types.d.ts +3 -0
  153. package/dist/types.d.ts.map +1 -1
  154. package/dist/types.js.map +1 -1
  155. package/package.json +11 -9
  156. package/src/boot-context-registry.ts +169 -0
  157. package/src/controller-loader.ts +299 -0
  158. package/src/controller-registry.ts +191 -0
  159. package/src/controllers/module/import-controller.ts +143 -0
  160. package/src/controllers/module/module-controller.ts +16 -0
  161. package/src/controllers/resource-definition/resource-definition-controller.ts +86 -0
  162. package/src/controllers/resource-definition/resource-definition.json +18 -0
  163. package/src/controllers/resource-definition/resource-template-controller.ts +138 -0
  164. package/src/event-stream.ts +121 -0
  165. package/src/events.ts +99 -0
  166. package/src/index.ts +7 -0
  167. package/src/kernel.ts +647 -0
  168. package/src/loader.ts +134 -0
  169. package/src/manifest-adapters/local-file-adapter.ts +62 -0
  170. package/src/manifest-adapters/manifest-adapter.ts +35 -0
  171. package/src/manifest-schemas.ts +85 -0
  172. package/src/registry.ts +137 -0
  173. package/src/resource-context.ts +267 -0
  174. package/src/resource-uri.ts +200 -0
  175. package/src/schema-valiator.ts +68 -0
  176. package/dist/cli.d.ts +0 -3
  177. package/dist/cli.d.ts.map +0 -1
  178. package/dist/cli.js +0 -109
  179. package/dist/cli.js.map +0 -1
  180. package/dist/expressions.d.ts +0 -20
  181. package/dist/expressions.d.ts.map +0 -1
  182. package/dist/expressions.js +0 -253
  183. package/dist/expressions.js.map +0 -1
  184. package/dist/src/controllers/module/module.yaml +0 -32
  185. package/dist/template-definition.d.ts +0 -38
  186. package/dist/template-definition.d.ts.map +0 -1
  187. package/dist/template-definition.js +0 -26
  188. package/dist/template-definition.js.map +0 -1
  189. package/dist/template-expander.d.ts +0 -19
  190. package/dist/template-expander.d.ts.map +0 -1
  191. package/dist/template-expander.js +0 -425
  192. package/dist/template-expander.js.map +0 -1
@@ -0,0 +1,91 @@
1
+ import type { ResourceInstance, ResourceManifest } from "@telorun/sdk";
2
+ /** Four-stage resource lifecycle defined in resource-lifecycle.md */
3
+ export type LifecycleState = "Pending" | "Validated" | "Initialized" | "Draining" | "Teardown";
4
+ /**
5
+ * Creates a ResourceInstance for the given manifest, or returns null if not yet
6
+ * ready (e.g. a dependency is still initializing). Injected at construction so
7
+ * every EvaluationContext node owns its full resource lifecycle.
8
+ */
9
+ export type InstanceFactory = (resource: ResourceManifest) => Promise<ResourceInstance | null>;
10
+ /** Canonical key for a resource instance: "<module>.<kind>.<name>" */
11
+ export declare function resourceKey(r: ResourceManifest): string;
12
+ /**
13
+ * Base class for all evaluation contexts. Owns CEL evaluation, template
14
+ * expansion, secrets redaction, and the generic resource lifecycle tree.
15
+ *
16
+ * Every EvaluationContext node can:
17
+ * - Hold its own resource instances (resourceInstances)
18
+ * - Queue resources for initialization (pendingResources)
19
+ * - Spawn child contexts (spawnChild) forming a lifecycle tree
20
+ * - Run a multi-pass initialization loop (initializeResources)
21
+ * - Cascade teardown depth-first through the tree (teardownResources)
22
+ */
23
+ export declare class EvaluationContext {
24
+ protected _context: Record<string, unknown>;
25
+ protected _secretValues: Set<string>;
26
+ protected _createInstance: InstanceFactory;
27
+ /** Position in the lifecycle tree. */
28
+ parent: EvaluationContext | undefined;
29
+ readonly children: EvaluationContext[];
30
+ /** Current lifecycle state of this context node. */
31
+ state: LifecycleState;
32
+ /** Resource instances owned by this context node, keyed by resourceKey(). */
33
+ readonly resourceInstances: Map<string, {
34
+ resource: ResourceManifest;
35
+ instance: ResourceInstance;
36
+ }>;
37
+ /** Resources queued for initialization on this context node. */
38
+ readonly pendingResources: ResourceManifest[];
39
+ constructor(context: Record<string, unknown>, createInstance?: InstanceFactory, secretValues?: Set<string>);
40
+ get createInstance(): InstanceFactory;
41
+ get context(): Record<string, unknown>;
42
+ get secretValues(): Set<string>;
43
+ /**
44
+ * Queue a resource manifest for initialization on this context.
45
+ */
46
+ registerManifest(resource: ResourceManifest): void;
47
+ /**
48
+ * Attach a child context to this node. The child's parent is set to this
49
+ * context and the child is registered under the given name.
50
+ */
51
+ spawnChild<T extends EvaluationContext>(child: T): T;
52
+ /**
53
+ * Multi-pass initialization loop. Processes pendingResources by calling the
54
+ * supplied instantiator for each resource, retrying failures across up to 10
55
+ * passes (handles dependency ordering without explicit topological sort).
56
+ *
57
+ * ERR_VISIBILITY_DENIED errors are fatal and re-thrown immediately.
58
+ * All other errors are tracked and retried until no progress is made.
59
+ */
60
+ initializeResources(): Promise<void>;
61
+ withManifests<T>(manifests: any[], fn: () => T): T;
62
+ /**
63
+ * Cascade teardown depth-first through the tree:
64
+ * 1. Tear down child contexts in reverse registration order.
65
+ * 2. Tear down own resource instances in reverse registration order.
66
+ *
67
+ * Note: Kernel-level events (e.g. Teardown events) are NOT emitted here —
68
+ * they remain the Kernel's responsibility.
69
+ */
70
+ teardownResources(): Promise<void>;
71
+ /**
72
+ * Evaluate a single CEL expression string against the context.
73
+ * Secret values are redacted from any thrown error message.
74
+ */
75
+ evaluate(expression: string): unknown;
76
+ /**
77
+ * Expand a value that may contain ${{ }} templates.
78
+ * Works recursively over strings, arrays, and objects.
79
+ * Templates whose identifiers are not present in the context are left
80
+ * unchanged (deferred) — they will be resolved at execution time when a
81
+ * richer ExecutionContext is available. All other CEL errors are propagated.
82
+ */
83
+ expand(value: unknown): unknown;
84
+ /**
85
+ * Merge another context on top of this one.
86
+ * Returns a new base EvaluationContext — 'other' wins on key conflict.
87
+ */
88
+ merge(other: EvaluationContext | Record<string, unknown>): EvaluationContext;
89
+ private expandString;
90
+ }
91
+ //# sourceMappingURL=evaluation-context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evaluation-context.d.ts","sourceRoot":"","sources":["../src/evaluation-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOvE,qEAAqE;AACrE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/F;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAE/F,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAEvD;AAYD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAC5B,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,SAAS,CAAC,eAAe,EAAE,eAAe,CAAC;IAE3C,sCAAsC;IACtC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAa;IAClD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAM;IAE5C,oDAAoD;IACpD,KAAK,EAAE,cAAc,CAAa;IAElC,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB;kBAEZ,gBAAgB;kBAAY,gBAAgB;OACtD;IAEJ,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,CAAM;gBAGjD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,cAAc,GAAE,eAAkC,EAClD,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;IAO5B,IAAI,cAAc,IAAI,eAAe,CAEpC;IAED,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;IAED,IAAI,YAAY,IAAI,GAAG,CAAC,MAAM,CAAC,CAE9B;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIlD;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAMpD;;;;;;;OAOG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD1C,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAiBlD;;;;;;;OAOG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAUrC;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAiB/B;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB;IAY5E,OAAO,CAAC,YAAY;CAkBrB"}
@@ -0,0 +1,220 @@
1
+ import { evaluate } from "cel-js";
2
+ import { RuntimeError } from "./types.js";
3
+ const TEMPLATE_REGEX = /\$\{\{\s*([^}]+?)\s*\}\}/g;
4
+ const EXACT_TEMPLATE_REGEX = /^\s*\$\{\{\s*([^}]+?)\s*\}\}\s*$/;
5
+ /** Canonical key for a resource instance: "<module>.<kind>.<name>" */
6
+ export function resourceKey(r) {
7
+ return `${r.metadata.module ?? "default"}.${r.kind}.${r.metadata.name}`;
8
+ }
9
+ function redactSecrets(message, secretValues) {
10
+ if (secretValues.size === 0)
11
+ return message;
12
+ const sorted = Array.from(secretValues).sort((a, b) => b.length - a.length);
13
+ let result = message;
14
+ for (const secret of sorted) {
15
+ result = result.split(secret).join("[REDACTED]");
16
+ }
17
+ return result;
18
+ }
19
+ /**
20
+ * Base class for all evaluation contexts. Owns CEL evaluation, template
21
+ * expansion, secrets redaction, and the generic resource lifecycle tree.
22
+ *
23
+ * Every EvaluationContext node can:
24
+ * - Hold its own resource instances (resourceInstances)
25
+ * - Queue resources for initialization (pendingResources)
26
+ * - Spawn child contexts (spawnChild) forming a lifecycle tree
27
+ * - Run a multi-pass initialization loop (initializeResources)
28
+ * - Cascade teardown depth-first through the tree (teardownResources)
29
+ */
30
+ export class EvaluationContext {
31
+ constructor(context, createInstance = async () => null, secretValues) {
32
+ /** Position in the lifecycle tree. */
33
+ this.parent = undefined;
34
+ this.children = [];
35
+ /** Current lifecycle state of this context node. */
36
+ this.state = "Pending";
37
+ /** Resource instances owned by this context node, keyed by resourceKey(). */
38
+ this.resourceInstances = new Map();
39
+ /** Resources queued for initialization on this context node. */
40
+ this.pendingResources = [];
41
+ this._context = context;
42
+ this._createInstance = createInstance;
43
+ this._secretValues = secretValues ?? new Set();
44
+ }
45
+ get createInstance() {
46
+ return this._createInstance;
47
+ }
48
+ get context() {
49
+ return this._context;
50
+ }
51
+ get secretValues() {
52
+ return this._secretValues;
53
+ }
54
+ /**
55
+ * Queue a resource manifest for initialization on this context.
56
+ */
57
+ registerManifest(resource) {
58
+ this.pendingResources.push(resource);
59
+ }
60
+ /**
61
+ * Attach a child context to this node. The child's parent is set to this
62
+ * context and the child is registered under the given name.
63
+ */
64
+ spawnChild(child) {
65
+ child.parent = this;
66
+ this.children.push(child);
67
+ return child;
68
+ }
69
+ /**
70
+ * Multi-pass initialization loop. Processes pendingResources by calling the
71
+ * supplied instantiator for each resource, retrying failures across up to 10
72
+ * passes (handles dependency ordering without explicit topological sort).
73
+ *
74
+ * ERR_VISIBILITY_DENIED errors are fatal and re-thrown immediately.
75
+ * All other errors are tracked and retried until no progress is made.
76
+ */
77
+ async initializeResources() {
78
+ const MAX_PASSES = 10;
79
+ let pass = 1;
80
+ const errors = new Map();
81
+ do {
82
+ const handled = [];
83
+ for (const resource of [...this.pendingResources]) {
84
+ const key = resourceKey(resource);
85
+ if (this.resourceInstances.has(key))
86
+ continue;
87
+ try {
88
+ const instance = await this._createInstance(resource);
89
+ if (instance) {
90
+ this.resourceInstances.set(key, { resource, instance });
91
+ handled.push(resource);
92
+ errors.delete(key);
93
+ }
94
+ }
95
+ catch (error) {
96
+ if (error instanceof RuntimeError && error.code === "ERR_VISIBILITY_DENIED")
97
+ throw error;
98
+ errors.set(key, error instanceof Error ? (error.stack ?? error.message) : String(error));
99
+ }
100
+ }
101
+ for (const r of handled) {
102
+ const idx = this.pendingResources.indexOf(r);
103
+ if (idx >= 0)
104
+ this.pendingResources.splice(idx, 1);
105
+ }
106
+ pass++;
107
+ if (handled.length === 0)
108
+ break;
109
+ } while (pass <= MAX_PASSES);
110
+ if (this.pendingResources.length > 0) {
111
+ const unhandledList = this.pendingResources
112
+ .reverse()
113
+ .map((r) => `- ${r.kind}:${r.metadata.name}: ${errors.get(resourceKey(r)) ?? "Unknown error"}`)
114
+ .join("\n");
115
+ throw new RuntimeError("ERR_RESOURCE_INITIALIZATION_FAILED", `Unable to process resources:\n\n${unhandledList}`);
116
+ }
117
+ this.state = "Initialized";
118
+ }
119
+ withManifests(manifests, fn) {
120
+ const child = this.spawnChild(new EvaluationContext(this._context, this._createInstance, this._secretValues));
121
+ try {
122
+ for (const manifest of manifests) {
123
+ child.registerManifest(manifest);
124
+ }
125
+ return fn();
126
+ }
127
+ finally {
128
+ // Tear down child context and its resources immediately after fn() completes.
129
+ // Note that this does NOT emit Kernel-level events (e.g. Teardown events) —
130
+ // they remain the Kernel's responsibility.
131
+ child.teardownResources();
132
+ }
133
+ }
134
+ /**
135
+ * Cascade teardown depth-first through the tree:
136
+ * 1. Tear down child contexts in reverse registration order.
137
+ * 2. Tear down own resource instances in reverse registration order.
138
+ *
139
+ * Note: Kernel-level events (e.g. Teardown events) are NOT emitted here —
140
+ * they remain the Kernel's responsibility.
141
+ */
142
+ async teardownResources() {
143
+ this.state = "Draining";
144
+ for (const child of [...this.children].reverse()) {
145
+ await child.teardownResources();
146
+ }
147
+ const entries = [...this.resourceInstances.entries()].reverse();
148
+ for (const [key, { instance }] of entries) {
149
+ if (instance.teardown)
150
+ await instance.teardown();
151
+ this.resourceInstances.delete(key);
152
+ }
153
+ this.state = "Teardown";
154
+ }
155
+ /**
156
+ * Evaluate a single CEL expression string against the context.
157
+ * Secret values are redacted from any thrown error message.
158
+ */
159
+ evaluate(expression) {
160
+ try {
161
+ return evaluate(expression, this._context);
162
+ }
163
+ catch (error) {
164
+ const raw = error instanceof Error ? error.message : String(error);
165
+ const safe = redactSecrets(raw, this._secretValues);
166
+ throw new Error(`CEL evaluation failed: "${expression}": ${safe}`);
167
+ }
168
+ }
169
+ /**
170
+ * Expand a value that may contain ${{ }} templates.
171
+ * Works recursively over strings, arrays, and objects.
172
+ * Templates whose identifiers are not present in the context are left
173
+ * unchanged (deferred) — they will be resolved at execution time when a
174
+ * richer ExecutionContext is available. All other CEL errors are propagated.
175
+ */
176
+ expand(value) {
177
+ if (typeof value === "string") {
178
+ return this.expandString(value);
179
+ }
180
+ if (Array.isArray(value)) {
181
+ return value.map((entry) => this.expand(entry));
182
+ }
183
+ if (value !== null && typeof value === "object") {
184
+ const resolved = {};
185
+ for (const [key, entry] of Object.entries(value)) {
186
+ resolved[key] = this.expand(entry);
187
+ }
188
+ return resolved;
189
+ }
190
+ return value;
191
+ }
192
+ /**
193
+ * Merge another context on top of this one.
194
+ * Returns a new base EvaluationContext — 'other' wins on key conflict.
195
+ */
196
+ merge(other) {
197
+ const otherCtx = other instanceof EvaluationContext ? other.context : other;
198
+ const otherSecrets = other instanceof EvaluationContext ? other.secretValues : new Set();
199
+ const merged = Object.assign(Object.create(null), this._context, otherCtx);
200
+ const mergedSecrets = new Set([...this._secretValues, ...otherSecrets]);
201
+ return new EvaluationContext(merged, this._createInstance, mergedSecrets);
202
+ }
203
+ expandString(value) {
204
+ if (!value.includes("${{")) {
205
+ return value;
206
+ }
207
+ const exact = value.match(EXACT_TEMPLATE_REGEX);
208
+ if (exact) {
209
+ return this.evaluate(exact[1]);
210
+ }
211
+ return value.replace(TEMPLATE_REGEX, (_match, expr) => {
212
+ const resolved = this.evaluate(expr);
213
+ if (resolved === null || resolved === undefined) {
214
+ return "";
215
+ }
216
+ return String(resolved);
217
+ });
218
+ }
219
+ }
220
+ //# sourceMappingURL=evaluation-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evaluation-context.js","sourceRoot":"","sources":["../src/evaluation-context.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { EvaluationContext } from "./evaluation-context.js";
2
+ import { ModuleContext } from "./module-context.js";
3
+ /**
4
+ * The ephemeral, per-trigger context layer. Merges a ModuleContext with
5
+ * arbitrary execution-time properties (e.g. { request, inputs } for HTTP;
6
+ * any shape is valid — determined by the trigger type).
7
+ *
8
+ * Execution props overlay the module namespaces on key conflict.
9
+ */
10
+ export declare class ExecutionContext extends EvaluationContext {
11
+ constructor(moduleCtx: ModuleContext, execProps: Record<string, unknown>);
12
+ }
13
+ //# sourceMappingURL=execution-context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../src/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;gBACzC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOzE"}
@@ -0,0 +1,14 @@
1
+ import { EvaluationContext } from "./evaluation-context.js";
2
+ /**
3
+ * The ephemeral, per-trigger context layer. Merges a ModuleContext with
4
+ * arbitrary execution-time properties (e.g. { request, inputs } for HTTP;
5
+ * any shape is valid — determined by the trigger type).
6
+ *
7
+ * Execution props overlay the module namespaces on key conflict.
8
+ */
9
+ export class ExecutionContext extends EvaluationContext {
10
+ constructor(moduleCtx, execProps) {
11
+ super(Object.assign(Object.create(null), moduleCtx.context, execProps), moduleCtx.createInstance, moduleCtx.secretValues);
12
+ }
13
+ }
14
+ //# sourceMappingURL=execution-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../src/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB;IACrD,YAAY,SAAwB,EAAE,SAAkC;QACtE,KAAK,CACH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAA4B,EAC3F,SAAS,CAAC,cAAc,EACxB,SAAS,CAAC,YAAY,CACvB,CAAC;IACJ,CAAC;CACF"}
package/dist/index.d.ts CHANGED
@@ -1,10 +1,7 @@
1
1
  export { ControllerRegistry } from "./controller-registry.js";
2
2
  export { EventStream } from "./event-stream.js";
3
3
  export { Kernel } from "./kernel.js";
4
- export { Loader } from "./loader.js";
5
4
  export { ManifestRegistry as Registry } from "./registry.js";
6
5
  export { ResourceURI } from "./resource-uri.js";
7
- export { SnapshotSerializer } from "./snapshot-serializer.js";
8
- export { RuntimeError } from "./types.js";
9
- export type { ControllerDefinition, ControllerInstance, ExecContext, Kernel as IKernel, KernelContext, ResourceDefinition } from "./types.js";
6
+ export type { RuntimeDiagnostic } from "@telorun/sdk";
10
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACR,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,MAAM,IAAI,OAAO,EACjB,aAAa,EACb,kBAAkB,EACrB,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}
package/dist/index.js CHANGED
@@ -1,9 +1,6 @@
1
1
  export { ControllerRegistry } from "./controller-registry.js";
2
2
  export { EventStream } from "./event-stream.js";
3
3
  export { Kernel } from "./kernel.js";
4
- export { Loader } from "./loader.js";
5
4
  export { ManifestRegistry as Registry } from "./registry.js";
6
5
  export { ResourceURI } from "./resource-uri.js";
7
- export { SnapshotSerializer } from "./snapshot-serializer.js";
8
- export { RuntimeError } from "./types.js";
9
6
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,gBAAgB,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
package/dist/kernel.d.ts CHANGED
@@ -1,47 +1,41 @@
1
- import { RuntimeEvent, RuntimeResource } from "@telorun/sdk";
1
+ import { AnalysisRegistry } from "@telorun/analyzer";
2
+ import { Kernel as IKernel, ModuleContext, ResourceDefinition, RuntimeEvent } from "@telorun/sdk";
2
3
  import { EventStream } from "./event-stream.js";
3
- import { Kernel as IKernel, ResourceDefinition, ResourceManifest } from "./types.js";
4
4
  /**
5
5
  * Kernel: Central orchestrator managing lifecycle and message bus
6
6
  * Handles resource loading, initialization, and execution through controllers
7
7
  */
8
8
  export declare class Kernel implements IKernel {
9
- private loader;
10
- private initializationQueue;
9
+ private readonly loader;
10
+ private readonly analyzer;
11
+ private readonly registry;
11
12
  private controllers;
12
13
  private eventBus;
13
14
  private eventStream;
14
- private resourceInstances;
15
- private resourceEventBuses;
16
- private resourceChildren;
17
15
  private holdCount;
18
16
  private idleResolvers;
19
17
  private _exitCode;
20
- private bootContextRegistry;
21
18
  private readonly sharedSchemaValidator;
19
+ private rootContext;
20
+ private staticManifests;
22
21
  constructor();
23
- /**
24
- * Register a resource dynamically during initialization
25
- */
26
- registerManifest(resource: ResourceManifest): void;
27
- /**
28
- * Register a child resource and track the parent-child relationship for cascade teardown
29
- */
30
- registerChildManifest(parentKey: string, resource: ResourceManifest): void;
31
- /**
32
- * Tear down a single resource and cascade to its children first
33
- */
34
- teardownResource(module: string, kind: string, name: string): Promise<void>;
35
22
  registerController(moduleName: string, kindName: string, controllerInstance: any): Promise<void>;
36
23
  /**
37
24
  * Register a resource definition with the controller registry
38
25
  */
39
26
  registerResourceDefinition(definition: ResourceDefinition): void;
40
- registerCapability(name: string, schema?: Record<string, any>): void;
41
- isCapabilityRegistered(name: string): boolean;
42
- getCapabilitySchema(name: string): Record<string, any> | null | undefined;
43
- /**
44
- * Load built-in Runtime definitions (e.g., Runtime.Module)
27
+ getModuleContext(_moduleName: string): ModuleContext;
28
+ resolveModuleAlias(_declaringModule: string, alias: string): string | undefined;
29
+ registerModuleImport(_declaringModule: string, alias: string, targetModule: string, kinds: string[]): void;
30
+ /** Returns the live analysis registry backed by this kernel's known definitions and aliases.
31
+ * Pass to StaticAnalyzer.analyze() for incremental validation of new manifests against
32
+ * already-registered types (e.g. front-end editor validating a manifest before submitting). */
33
+ getAnalysisRegistry(): AnalysisRegistry;
34
+ /**
35
+ * Load built-in Runtime definitions (e.g., Kernel.Module)
36
+ * Also declares all known module namespaces upfront so that resources can be
37
+ * registered to them. User-defined modules are declared explicitly by Kernel.Module
38
+ * resources during the initialization phase.
45
39
  */
46
40
  private loadBuiltinDefinitions;
47
41
  /**
@@ -57,7 +51,6 @@ export declare class Kernel implements IKernel {
57
51
  * Phase 2: Start - Initialize resources
58
52
  */
59
53
  start(): Promise<void>;
60
- runInstances(): Promise<void>;
61
54
  emitRuntimeEvent(event: string, payload?: any): Promise<void>;
62
55
  get exitCode(): number;
63
56
  requestExit(code: number): void;
@@ -70,26 +63,25 @@ export declare class Kernel implements IKernel {
70
63
  */
71
64
  shutdown(): void;
72
65
  hasEventHandlers(event: string): boolean;
73
- hasResourceInstances(): boolean;
74
- teardownResources(): Promise<void>;
75
66
  on(event: string, handler: (event: RuntimeEvent) => void | Promise<void>): void;
76
67
  private createControllerContext;
77
68
  private createResourceContext;
78
- getResourcesByKind(kind: string): RuntimeResource[];
79
- getResourceByName(module: string, kind: string, name: string): RuntimeResource | null;
80
69
  /**
81
- * Returns the unique set of local file paths from which resources were loaded.
82
- * HTTP/HTTPS sources are excluded they cannot be watched on disk.
70
+ * Create phase only: resolves the controller, validates the schema, and calls
71
+ * controller.create(). Returns { instance, ctx } so initializeResources can
72
+ * run init() separately in its second phase. Returns null when the controller
73
+ * is not yet registered (retry signal).
83
74
  */
84
- getSourceFiles(): string[];
75
+ private _createInstance;
85
76
  /**
86
- * Reload all resources that were loaded from the given source file.
87
- * Safe order: parse first → if parse succeeds, tear down old → init new → run new only.
77
+ * Phase 5 Inject live instances into reference fields of a resource config.
78
+ *
79
+ * Called between create() and init() for every resource. Walks the definition's
80
+ * field map and replaces each {kind, name} reference value (outside scope visibility
81
+ * paths) with the live ResourceInstance returned by getInstance(name). Fields within
82
+ * scope paths are left as {kind, name} — the controller resolves them at runtime.
88
83
  */
89
- reloadSource(sourcePath: string): Promise<void>;
90
- private initializeResources;
91
- invoke(module: string, kind: string, name: string, ...args: any[]): Promise<any>;
92
- private getResourceKey;
84
+ private _injectDependencies;
93
85
  /**
94
86
  * Enable event streaming to a file (JSONL format)
95
87
  */
@@ -102,9 +94,6 @@ export declare class Kernel implements IKernel {
102
94
  * Get the event stream for testing and inspection
103
95
  */
104
96
  getEventStream(): EventStream;
105
- /**
106
- * Take a snapshot of current runtime state
107
- */
108
97
  /**
109
98
  * Setup event streaming hook to capture all events
110
99
  */
@@ -1 +1 @@
1
- {"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAkB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAEH,MAAM,IAAI,OAAO,EACjB,aAAa,EAEb,kBAAkB,EAIlB,YAAY,EAEf,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;;GAGG;AACH,qBAAa,MAAO,YAAW,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IAEnD,OAAO,CAAC,WAAW,CAAgD;IACnE,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,WAAW,CAAkC;IAQrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,SAAS,CAAK;IAEtB,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAyB;IAC/D,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,eAAe,CAA0B;;IAM3C,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,GAAG,GACtB,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACH,0BAA0B,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAKhE,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAIpD,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/E,oBAAoB,CAClB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EAAE,GACd,IAAI;IAKP;;oGAEgG;IAChG,mBAAmB,IAAI,gBAAgB;IAIvC;;;;;OAKG;YACW,sBAAsB;IAuBpC;;OAEG;IACG,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4E5D;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDtB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI;IAyBxC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;;OAIG;IACH,QAAQ,IAAI,IAAI;IAKhB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIxC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI/E,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,qBAAqB;IAY7B;;;;;OAKG;YACW,eAAe;IAkF7B;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAS5B"}