@telorun/kernel 0.2.4

package/dist/expressions.js

@@ -0,0 +1,253 @@
+import { evaluate } from "cel-js";
+const TEMPLATE_REGEX = /\$\{\{\s*([^}]+?)\s*\}\}/g;
+const EXACT_TEMPLATE_REGEX = /^\s*\$\{\{\s*([^}]+?)\s*\}\}\s*$/;
+export function evaluateCel(expression, context) {
+    return evaluate(expression, context);
+}
+export function expandValue(value, context) {
+    if (typeof value === "string") {
+        return expandString(value, context);
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => expandValue(entry, context));
+    }
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    const resolved = {};
+    for (const [key, entry] of Object.entries(value)) {
+        resolved[key] = expandValue(entry, context);
+    }
+    return resolved;
+}
+export function resolveExpressionsInRegistry(registry, runtimeConfig) {
+    const maxPasses = 5;
+    for (let pass = 0; pass < maxPasses; pass += 1) {
+        const context = buildEvaluationContext(registry, runtimeConfig);
+        let changed = false;
+        for (const [kind, resourcesByName] of registry.entries()) {
+            for (const [name, resource] of resourcesByName.entries()) {
+                const { value, updated } = resolveResource(resource, context, {
+                    kind,
+                    name,
+                });
+                if (updated) {
+                    resourcesByName.set(name, value);
+                    changed = true;
+                }
+            }
+        }
+        if (!changed) {
+            break;
+        }
+    }
+}
+function buildEvaluationContext(registry, runtimeConfig) {
+    // Whitelist environment variables
+    const allowedEnvVars = ["NODE_ENV", "PORT", "HOST", "PATH", "HOME", "USER", "LANG"];
+    const env = {};
+    for (const key of allowedEnvVars) {
+        if (process.env[key] !== undefined) {
+            env[key] = process.env[key];
+        }
+    }
+    const context = { env };
+    const modules = {};
+    if (runtimeConfig?.name) {
+        const moduleEntry = {
+            name: runtimeConfig.name,
+            version: runtimeConfig.version,
+        };
+        modules[runtimeConfig.name] = moduleEntry;
+        const alias = capitalize(runtimeConfig.name);
+        if (alias && alias !== runtimeConfig.name) {
+            modules[alias] = moduleEntry;
+        }
+    }
+    context.Namespace = modules;
+    for (const [kind, resourcesByName] of registry.entries()) {
+        const kindBucket = {};
+        for (const [name, resource] of resourcesByName.entries()) {
+            kindBucket[name] = resource;
+        }
+        const parts = kind.split(".").filter(Boolean);
+        if (parts.length <= 1) {
+            context[kind] = kindBucket;
+            continue;
+        }
+        let cursor = context;
+        for (let i = 0; i < parts.length - 1; i += 1) {
+            const part = parts[i];
+            if (!cursor[part] || typeof cursor[part] !== "object") {
+                cursor[part] = {};
+            }
+            cursor = cursor[part];
+        }
+        cursor[parts[parts.length - 1]] = kindBucket;
+    }
+    return context;
+}
+function resolveResource(resource, context, id) {
+    const { value, updated } = resolveValue(resource, context, id, {
+        isRoot: true,
+    });
+    return { value: value, updated };
+}
+function resolveValue(value, context, id, options) {
+    if (typeof value === "string") {
+        return resolveString(value, context, id);
+    }
+    if (Array.isArray(value)) {
+        let changed = false;
+        const resolved = value.map((entry) => {
+            const result = resolveValue(entry, context, id);
+            if (result.updated) {
+                changed = true;
+            }
+            return result.value;
+        });
+        return { value: changed ? resolved : value, updated: changed };
+    }
+    if (!value || typeof value !== "object") {
+        return { value, updated: false };
+    }
+    let changed = false;
+    const resolved = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (options?.isRoot && key === "kind") {
+            resolved[key] = entry;
+            continue;
+        }
+        if (options?.isMetadata && key === "name") {
+            resolved[key] = entry;
+            continue;
+        }
+        if (options?.isRoot && key === "metadata" && entry && typeof entry === "object") {
+            const result = resolveValue(entry, context, id, { isMetadata: true });
+            resolved[key] = result.value;
+            if (result.updated) {
+                changed = true;
+            }
+            continue;
+        }
+        const result = resolveValue(entry, context, id);
+        resolved[key] = result.value;
+        if (result.updated) {
+            changed = true;
+        }
+    }
+    return { value: changed ? resolved : value, updated: changed };
+}
+function resolveString(value, context, id) {
+    if (!value.includes("${{")) {
+        return { value, updated: false };
+    }
+    const exact = value.match(EXACT_TEMPLATE_REGEX);
+    if (exact) {
+        const expr = exact[1];
+        const evaluated = evaluateExpression(expr, context, id);
+        if (evaluated.deferred) {
+            return { value, updated: false };
+        }
+        return { value: evaluated.value, updated: true };
+    }
+    let replaced = value;
+    replaced = replaced.replace(TEMPLATE_REGEX, (_match, expr) => {
+        const evaluated = evaluateExpression(expr, context, id);
+        if (evaluated.deferred) {
+            return _match;
+        }
+        if (evaluated.value === null || evaluated.value === undefined) {
+            return "";
+        }
+        return String(evaluated.value);
+    });
+    return { value: replaced, updated: replaced !== value };
+}
+function expandString(value, context) {
+    if (!value.includes("${{")) {
+        return value;
+    }
+    const exact = value.match(EXACT_TEMPLATE_REGEX);
+    if (exact) {
+        return evaluateCelWithError(exact[1], context, {
+            kind: "Value",
+            name: "expand",
+        });
+    }
+    return value.replace(TEMPLATE_REGEX, (_match, expr) => {
+        const evaluated = evaluateCelWithError(expr, context, {
+            kind: "Value",
+            name: "expand",
+        });
+        if (evaluated === null || evaluated === undefined) {
+            return "";
+        }
+        return String(evaluated);
+    });
+}
+function evaluateExpression(expr, context, id) {
+    try {
+        return { value: evaluateCelWithError(expr, context, id), deferred: false };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (isDeferredExpressionError(message, expr)) {
+            return { deferred: true };
+        }
+        throw new Error(`CEL evaluation failed for ${id.kind}.${id.name}: "${expr}": ${message}`);
+    }
+}
+function capitalize(value) {
+    if (!value) {
+        return value;
+    }
+    return value[0].toUpperCase() + value.slice(1);
+}
+function isDeferredExpressionError(message, expr) {
+    const trimmed = expr.trim();
+    const deferredRoots = ["request.", "result."];
+    if (!deferredRoots.some((root) => trimmed.startsWith(root))) {
+        return false;
+    }
+    return message.includes('Identifier "') && message.includes("not found");
+}
+/**
+ * Resolve all non-deferred CEL expressions in a resource manifest using the
+ * provided boot context. Expressions referencing `request.*` or `result.*` are
+ * left untouched — they will be resolved at request time by the runtime.
+ *
+ * Missing identifiers that are not deferred prefixes will throw, which is
+ * intentional: if a consumer's manifest references a boot-context identifier
+ * that is absent from the context, it is a configuration error.
+ *
+ * @param manifest - The raw (pre-creation) ResourceManifest
+ * @param context  - CEL evaluation context built by BootContextRegistry.buildContext()
+ * @returns A new manifest object with all resolvable `${{ }}` templates replaced
+ */
+export function resolveManifestWithContext(manifest, context) {
+    const id = {
+        kind: manifest.kind,
+        name: manifest.metadata?.name ?? '(unknown)',
+    };
+    const { value } = resolveValue(manifest, context, id, { isRoot: true });
+    return value;
+}
+function evaluateCelWithError(expr, context, id) {
+    try {
+        return evaluateCel(expr, context);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        // Build helpful context information
+        const availableVars = Object.keys(context)
+            .filter((k) => k !== "env")
+            .concat(context.env ? Object.keys(context.env).map((k) => `env.${k}`) : [])
+            .sort();
+        throw new Error(`CEL evaluation failed for resource ${id.kind}.${id.name}\n` +
+            `Expression: "${expr}"\n` +
+            `Error: ${message}\n` +
+            `Available variables: ${availableVars.slice(0, 20).join(", ")}${availableVars.length > 20 ? "..." : ""}`);
+    }
+}
+//# sourceMappingURL=expressions.js.map

package/dist/expressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../src/expressions.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { ControllerRegistry } from "./controller-registry.js";
+export { EventStream } from "./event-stream.js";
+export { Kernel } from "./kernel.js";
+export { Loader } from "./loader.js";
+export { ManifestRegistry as Registry } from "./registry.js";
+export { ResourceURI } from "./resource-uri.js";
+export { SnapshotSerializer } from "./snapshot-serializer.js";
+export { RuntimeError } from "./types.js";
+export type { ControllerDefinition, ControllerInstance, ExecContext, Kernel as IKernel, KernelContext, ResourceDefinition } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { ControllerRegistry } from "./controller-registry.js";
+export { EventStream } from "./event-stream.js";
+export { Kernel } from "./kernel.js";
+export { Loader } from "./loader.js";
+export { ManifestRegistry as Registry } from "./registry.js";
+export { ResourceURI } from "./resource-uri.js";
+export { SnapshotSerializer } from "./snapshot-serializer.js";
+export { RuntimeError } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/kernel.d.ts

@@ -0,0 +1,113 @@
+import { RuntimeEvent, RuntimeResource } from "@telorun/sdk";
+import { EventStream } from "./event-stream.js";
+import { Kernel as IKernel, ResourceDefinition, ResourceManifest } from "./types.js";
+/**
+ * Kernel: Central orchestrator managing lifecycle and message bus
+ * Handles resource loading, initialization, and execution through controllers
+ */
+export declare class Kernel implements IKernel {
+    private loader;
+    private initializationQueue;
+    private controllers;
+    private eventBus;
+    private eventStream;
+    private resourceInstances;
+    private resourceEventBuses;
+    private resourceChildren;
+    private holdCount;
+    private idleResolvers;
+    private _exitCode;
+    private bootContextRegistry;
+    private readonly sharedSchemaValidator;
+    constructor();
+    /**
+     * Register a resource dynamically during initialization
+     */
+    registerManifest(resource: ResourceManifest): void;
+    /**
+     * Register a child resource and track the parent-child relationship for cascade teardown
+     */
+    registerChildManifest(parentKey: string, resource: ResourceManifest): void;
+    /**
+     * Tear down a single resource and cascade to its children first
+     */
+    teardownResource(module: string, kind: string, name: string): Promise<void>;
+    registerController(moduleName: string, kindName: string, controllerInstance: any): Promise<void>;
+    /**
+     * Register a resource definition with the controller registry
+     */
+    registerResourceDefinition(definition: ResourceDefinition): void;
+    registerCapability(name: string, schema?: Record<string, any>): void;
+    isCapabilityRegistered(name: string): boolean;
+    getCapabilitySchema(name: string): Record<string, any> | null | undefined;
+    /**
+     * Load built-in Runtime definitions (e.g., Runtime.Module)
+     */
+    private loadBuiltinDefinitions;
+    /**
+     * Load from runtime configuration file
+     */
+    loadFromConfig(runtimeYamlPath: string): Promise<void>;
+    /**
+     * Phase 1: Load - Ingest files from directory and load runtime config
+     * @deprecated Use loadFromConfig instead
+     */
+    loadDirectory(dirPath: string): Promise<void>;
+    /**
+     * Phase 2: Start - Initialize resources
+     */
+    start(): Promise<void>;
+    runInstances(): Promise<void>;
+    emitRuntimeEvent(event: string, payload?: any): Promise<void>;
+    get exitCode(): number;
+    requestExit(code: number): void;
+    acquireHold(reason?: string): () => void;
+    waitForIdle(): Promise<void>;
+    /**
+     * Force-resolve waitForIdle() regardless of active holds.
+     * Used for graceful shutdown when external signals (e.g. SIGINT) should
+     * bypass resource holds and proceed directly to teardown.
+     */
+    shutdown(): void;
+    hasEventHandlers(event: string): boolean;
+    hasResourceInstances(): boolean;
+    teardownResources(): Promise<void>;
+    on(event: string, handler: (event: RuntimeEvent) => void | Promise<void>): void;
+    private createControllerContext;
+    private createResourceContext;
+    getResourcesByKind(kind: string): RuntimeResource[];
+    getResourceByName(module: string, kind: string, name: string): RuntimeResource | null;
+    /**
+     * Returns the unique set of local file paths from which resources were loaded.
+     * HTTP/HTTPS sources are excluded — they cannot be watched on disk.
+     */
+    getSourceFiles(): string[];
+    /**
+     * Reload all resources that were loaded from the given source file.
+     * Safe order: parse first → if parse succeeds, tear down old → init new → run new only.
+     */
+    reloadSource(sourcePath: string): Promise<void>;
+    private initializeResources;
+    invoke(module: string, kind: string, name: string, ...args: any[]): Promise<any>;
+    private getResourceKey;
+    /**
+     * Enable event streaming to a file (JSONL format)
+     */
+    enableEventStream(filePath: string): Promise<void>;
+    /**
+     * Disable event streaming
+     */
+    disableEventStream(): void;
+    /**
+     * Get the event stream for testing and inspection
+     */
+    getEventStream(): EventStream;
+    /**
+     * Take a snapshot of current runtime state
+     */
+    /**
+     * Setup event streaming hook to capture all events
+     */
+    private setupEventStreaming;
+}
+//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,YAAY,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAIjG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD,OAAO,EAEL,MAAM,IAAI,OAAO,EACjB,kBAAkB,EAElB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,MAAO,YAAW,OAAO;IACpC,OAAO,CAAC,MAAM,CAAwB;IAEtC,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,WAAW,CAAgD;IACnE,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,WAAW,CAAkC;IAGrD,OAAO,CAAC,iBAAiB,CAGX;IACd,OAAO,CAAC,kBAAkB,CAAoC;IAC9D,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAyB;;IAM/D;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIlD;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAY1E;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B3E,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,GAAG,GACtB,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACH,0BAA0B,CACxB,UAAU,EAAE,kBAAkB,GAG7B,IAAI;IAIP,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIpE,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7C,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS;IAIzE;;OAEG;YACW,sBAAsB;IAoCpC;;OAEG;IACG,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7B,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,oBAAoB,IAAI,OAAO;IAIzB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC,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;IAoB/B,OAAO,CAAC,qBAAqB;IAS7B,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAUnD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAYrF;;;OAGG;IACH,cAAc,IAAI,MAAM,EAAE;IAW1B;;;OAGG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuCvC,mBAAmB;IA0M3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAqBtF,OAAO,CAAC,cAAc;IAetB;;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;IASH;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAS5B"}