@telorun/kernel 0.2.4 → 0.2.5

package/dist/kernel.d.ts

@@ -1,47 +1,37 @@
-import { RuntimeEvent, RuntimeResource } from "@telorun/sdk";
+import { EvaluationContext, Kernel as IKernel, ModuleContext, ResourceDefinition, RuntimeEvent } 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;
+    private rootContext;
     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;
+    getModuleContext(_moduleName: string): ModuleContext;
+    resolveModuleAlias(_declaringModule: string, alias: string): string | undefined;
+    registerModuleImport(_declaringModule: string, alias: string, targetModule: string, kinds: string[]): void;
     isCapabilityRegistered(name: string): boolean;
     getCapabilitySchema(name: string): Record<string, any> | null | undefined;
     /**
-     * Load built-in Runtime definitions (e.g., Runtime.Module)
+     * Load built-in Runtime definitions (e.g., Kernel.Module)
+     * Also declares all known module namespaces upfront so that resources can be
+     * registered to them. User-defined modules are declared explicitly by Kernel.Module
+     * resources during the initialization phase.
      */
     private loadBuiltinDefinitions;
     /**
@@ -57,7 +47,6 @@ export declare class Kernel implements IKernel {
      * 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;
@@ -70,25 +59,31 @@ export declare class Kernel implements IKernel {
      */
     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;
+    /**
+     * Create a resource instance: resolves the controller, validates the schema,
+     * calls create/init, registers context providers, stores the snapshot, and
+     * mirrors the instance into the Kernel-level and module-level registries.
+     * Returns null when the controller is not yet registered (retry signal).
+     */
+    private _createInstance;
+    /**
+     * Tear down all resource instances owned by a dynamically-spawned context,
+     * cascading depth-first through its children. Removes entries from both
+     * ctx.resourceInstances and the Kernel-level resourceInstances map, and
+     * emits Teardown events (matching the behaviour of teardownResource()).
+     */
+    teardownContext(ctx: EvaluationContext): Promise<void>;
     /**
      * 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)
@@ -102,9 +97,6 @@ export declare class Kernel implements IKernel {
      * 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
      */

package/dist/kernel.d.ts.map

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