@telorun/sdk 0.2.3 → 0.2.5

package/dist/module-context.js

@@ -0,0 +1,150 @@
+import { EvaluationContext } from "./evaluation-context.js";
+function collectSecretValues(secrets) {
+    const values = new Set();
+    for (const value of Object.values(secrets)) {
+        if (typeof value === "string" && value.length > 0) {
+            values.add(value);
+        }
+    }
+    return values;
+}
+/**
+ * Persistent, module-scoped context. Three reserved CEL namespaces:
+ * variables, secrets, resources.
+ *
+ * Unlike the base EvaluationContext, ModuleContext is stateful and mutable:
+ * variables/secrets/resources accumulate during multi-pass initialization and
+ * the context record is rebuilt on each mutation. Import aliases are tracked
+ * here for alias-prefixed kind resolution (e.g. MyImport.Http.Route).
+ *
+ * Imported modules are surfaced under resources.<alias> alongside local
+ * resources — no separate imports namespace needed.
+ */
+export class ModuleContext extends EvaluationContext {
+    targets;
+    _variables;
+    _secrets;
+    _resources;
+    /** Maps import alias → real module name for kind resolution. */
+    importAliases = new Map();
+    /** Maps import alias → allowed kind names. Absent entry = unrestricted (e.g. Kernel). */
+    importedKinds = new Map();
+    constructor(source, variables = {}, secrets = {}, resources = {}, targets = [], createInstance = async () => null, emit) {
+        super(source, {}, createInstance, new Set(), emit);
+        this.targets = targets;
+        this._variables = variables;
+        this._secrets = secrets;
+        this._resources = resources;
+        this._rebuildContext();
+    }
+    get variables() {
+        return this._variables;
+    }
+    get secrets() {
+        return this._secrets;
+    }
+    get resources() {
+        return this._resources;
+    }
+    setVariables(vars) {
+        this._variables = vars;
+        this._rebuildContext();
+    }
+    setTargets(vars) {
+        this.targets = vars;
+    }
+    setSecrets(secrets) {
+        this._secrets = secrets;
+        this._rebuildContext();
+    }
+    setResource(name, props) {
+        this._resources = { ...this._resources, [name]: props };
+        this._rebuildContext();
+    }
+    /**
+     * Register an imported module under the given alias, with the list of kind names
+     * it exports. An empty kinds array means no restriction (used for built-ins like Kernel).
+     */
+    registerImport(alias, targetModule, kinds) {
+        this.importAliases.set(alias, targetModule);
+        if (kinds.length > 0) {
+            this.importedKinds.set(alias, new Set(kinds));
+        }
+    }
+    getInstance(name) {
+        const entry = this.resourceInstances.get(name);
+        if (!entry) {
+            throw new Error(`Resource '${name}' not found in module context. Available resources: ${[...this.resourceInstances.keys()].join(", ")}`);
+        }
+        return entry?.instance;
+    }
+    getInvokable(name) {
+        const instance = this.getInstance(name);
+        if (instance &&
+            typeof instance === "object" &&
+            "invoke" in instance &&
+            typeof instance.invoke !== "function") {
+            throw new Error(`Resource '${name}' does not have an invoke() method.`);
+        }
+        return instance;
+    }
+    /**
+     * Resolve a fully-qualified kind like "Http.Server" to its real kind "http-server.Server".
+     * Splits on the first dot, looks up the prefix in importAliases, validates against
+     * importedKinds (if set), and reconstructs the resolved kind.
+     * Throws with a clear message if the alias is unknown or the kind is not exported.
+     */
+    resolveKind(kind) {
+        const dot = kind.indexOf(".");
+        if (dot === -1) {
+            throw new Error(`Kind '${kind}' must be fully qualified (e.g. 'Module.KindName')`);
+        }
+        const prefix = kind.slice(0, dot);
+        const suffix = kind.slice(dot + 1);
+        const realModule = this.importAliases.get(prefix);
+        if (!realModule) {
+            const known = [...this.importAliases.keys()].join(", ") || "(none)";
+            throw new Error(`Kind '${kind}': no module imported with alias '${prefix}'. Known aliases: ${known}`);
+        }
+        const allowed = this.importedKinds.get(prefix);
+        if (allowed !== undefined && !allowed.has(suffix)) {
+            throw new Error(`Kind '${suffix}' is not exported by module '${realModule}' (imported as '${prefix}'). ` +
+                `Exported kinds: ${[...allowed].join(", ")}`);
+        }
+        return `${realModule}.${suffix}`;
+    }
+    _rebuildContext() {
+        this._context = {
+            variables: this._variables,
+            secrets: this._secrets,
+            resources: this._resources,
+        };
+        this._secretValues = collectSecretValues(this._secrets);
+    }
+    async invoke(kind, name, ...args) {
+        const result = await super.invoke(kind, name, ...args);
+        const entry = this.resourceInstances.get(name);
+        if (entry && typeof entry.instance.snapshot === "function") {
+            const snap = await Promise.resolve(entry.instance.snapshot());
+            this.setResource(name, snap);
+        }
+        return result;
+    }
+    async run(name) {
+        const resource = this.resourceInstances.get(name);
+        if (!resource) {
+            throw new Error(`Target resource ${name} not found in module context. Available resources: ${[...this.resourceInstances.keys()].join(", ")}`);
+        }
+        if (typeof resource.instance.run === "function") {
+            await resource.instance.run();
+        }
+        else {
+            throw new Error(`Target resource ${name} does not have a run() method.`);
+        }
+    }
+    async runTargets() {
+        for (const target of this.targets) {
+            await this.run(target);
+        }
+    }
+}

package/dist/resource-context.d.ts

@@ -1,4 +1,6 @@
 import { ControllerContext } from "./controller-context.js";
+import { EvaluationContext } from "./evaluation-context.js";
+import { ModuleContext } from "./module-context.js";
 import { RuntimeResource } from "./runtime-resource.js";
 export interface DataValidator {
     validate(data: any): void;
@@ -12,12 +14,30 @@ export interface ResourceContext extends ControllerContext {
     acquireHold(reason?: string): () => void;
     emitEvent(event: string, payload?: any): Promise<void>;
     invoke(kind: string, name: string, ...args: any[]): Promise<any>;
+    run(kind: string, name: string): Promise<void>;
     getResources(kind: string): RuntimeResource[];
     getResourcesByName(kind: string, name: string): RuntimeResource | null;
     registerManifest(resource: any): void;
+    spawnChildContext(): EvaluationContext;
+    withManifests<T>(manifests: any[], fn: () => T): T;
+    resolveChildren(resource: any, resourceName?: string): {
+        kind: string;
+        name: string;
+    };
     validateSchema(value: any, schema: any): void;
     createSchemaValidator(schema: any): DataValidator;
-    registerController(moduleName: string, resourceKind: string, controllerInstance: any): Promise<void>;
+    registerSchema(name: string, schema: object): void;
+    lookupSchema(name: string): object | undefined;
+    registerController(moduleName: string, kindName: string, controllerInstance: any): Promise<void>;
     registerDefinition(definition: any): void;
+    registerModuleImport(alias: string, targetModule: string, kinds: string[]): void;
+    registerCapability(name: string, schema?: Record<string, any>): void;
+    isCapabilityRegistered(name: string): boolean;
+    getCapabilitySchema(name: string): Record<string, any> | null | undefined;
     teardownResource(kind: string, name: string): Promise<void>;
+    moduleContext: ModuleContext;
+    stdin: NodeJS.ReadableStream;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
 }
+//# sourceMappingURL=resource-context.d.ts.map

package/dist/resource-context.d.ts.map

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

package/dist/resource-instance.d.ts

@@ -11,3 +11,4 @@ export type ResourceInstance = {
      */
     snapshot?(): Record<string, any> | Promise<Record<string, any>>;
 };
+//# sourceMappingURL=resource-instance.d.ts.map

package/dist/resource-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-instance.d.ts","sourceRoot":"","sources":["../src/resource-instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,GAAG,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CACjE,CAAC"}

package/dist/resource-manifest.d.ts

@@ -5,8 +5,9 @@ export interface ResourceManifest {
     kind: string;
     metadata: {
         name: string;
-        module: string;
+        module?: string;
         [key: string]: any;
     };
     [key: string]: any;
 }
+//# sourceMappingURL=resource-manifest.d.ts.map

package/dist/resource-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-manifest.d.ts","sourceRoot":"","sources":["../src/resource-manifest.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/runtime-error.d.ts

@@ -1 +1,2 @@
-export type RuntimeErrorCode = 'ERR_RESOURCE_NOT_FOUND' | 'ERR_CONTROLLER_NOT_FOUND' | 'ERR_CONTROLLER_INVALID' | 'ERR_RESOURCE_NOT_INVOKABLE' | 'ERR_DUPLICATE_RESOURCE' | 'ERR_EXECUTION_FAILED' | 'ERR_INVALID_VALUE';
+export type RuntimeErrorCode = "ERR_RESOURCE_NOT_FOUND" | "ERR_RESOURCE_NOT_RUNNABLE" | "ERR_CONTROLLER_NOT_FOUND" | "ERR_CONTROLLER_INVALID" | "ERR_RESOURCE_INITIALIZATION_FAILED" | "ERR_RESOURCE_NOT_INVOKABLE" | "ERR_RESOURCE_SCHEMA_VALIDATION_FAILED" | "ERR_DUPLICATE_RESOURCE" | "ERR_EXECUTION_FAILED" | "ERR_INVALID_VALUE" | "ERR_VISIBILITY_DENIED";
+//# sourceMappingURL=runtime-error.d.ts.map

package/dist/runtime-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-error.d.ts","sourceRoot":"","sources":["../src/runtime-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GACxB,2BAA2B,GAC3B,0BAA0B,GAC1B,wBAAwB,GACxB,oCAAoC,GACpC,4BAA4B,GAC5B,uCAAuC,GACvC,wBAAwB,GACxB,sBAAsB,GACtB,mBAAmB,GACnB,uBAAuB,CAAC"}

package/dist/runtime-event.d.ts

@@ -3,3 +3,4 @@ export type RuntimeEvent = {
     payload?: any;
     metadata?: Record<string, any>;
 };
+//# sourceMappingURL=runtime-event.d.ts.map

package/dist/runtime-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-event.d.ts","sourceRoot":"","sources":["../src/runtime-event.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC,CAAC"}

package/dist/runtime-resource.d.ts

@@ -6,3 +6,4 @@ export interface RuntimeResource {
         [key: string]: any;
     };
 }
+//# sourceMappingURL=runtime-resource.d.ts.map

package/dist/runtime-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-resource.d.ts","sourceRoot":"","sources":["../src/runtime-resource.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+import { ControllerContext } from "./controller-context.js";
+import { ResourceContext } from "./resource-context.js";
+import { ResourceInstance } from "./resource-instance.js";
+import { ResourceManifest } from "./resource-manifest.js";
+import { RuntimeErrorCode } from "./runtime-error.js";
+import { RuntimeResource } from "./runtime-resource.js";
+export interface KernelContext {
+    kernel: Kernel;
+}
+export interface ExecContext {
+    execute(urn: string, input: any): Promise<any>;
+    [key: string]: any;
+}
+export type ResourceCapability = string;
+export interface ResourceDefinition {
+    kind: string;
+    metadata: {
+        name: string;
+        module: string;
+    };
+    schema: Record<string, any>;
+    capabilities: ResourceCapability[];
+    events?: string[];
+    controllers?: Array<{
+        runtime: string;
+        entry: string;
+    }>;
+}
+/**
+ * Controller definition for a resource kind.
+ * Maps a fully-qualified resource kind to its controller implementation for a specific runtime.
+ */
+export interface ControllerDefinition {
+    kind: string;
+    runtime: string;
+    entry: string;
+    controller?: any;
+}
+/**
+ * Controller instance - runtime representation of a controller that handles resource instances.
+ */
+export interface ControllerInstance {
+    execute?(name: string, inputs: any, ctx: ExecContext): Promise<any>;
+    compile?(resource: ResourceManifest, ctx: ResourceContext): RuntimeResource | Promise<RuntimeResource>;
+    register?(ctx: ControllerContext): void | Promise<void>;
+    create?(resource: ResourceManifest, ctx: ResourceContext): ResourceInstance | null | Promise<ResourceInstance | null>;
+    schema: any;
+}
+export interface Kernel {
+    loadFromConfig(runtimeYamlPath: string): Promise<void>;
+    start(): Promise<void>;
+    acquireHold(reason?: string): () => void;
+    waitForIdle(): Promise<void>;
+    requestExit(code: number): void;
+    readonly exitCode: number;
+    shutdown(): void;
+}
+export declare class RuntimeError extends Error {
+    code: RuntimeErrorCode;
+    constructor(code: RuntimeErrorCode, message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACpE,OAAO,CAAC,CACN,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,eAAe,GACnB,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,QAAQ,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,CACL,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,eAAe,GACnB,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9D,MAAM,EAAE,GAAG,CAAC;CACb;AAED,MAAM,WAAW,MAAM;IACrB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IACzC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAI1B,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,qBAAa,YAAa,SAAQ,KAAK;IAE5B,IAAI,EAAE,gBAAgB;gBAAtB,IAAI,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM;CAKlB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+export class RuntimeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "RuntimeError";
+    }
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
       "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
@@ -15,6 +16,9 @@
     "dist/**",
     "src/**"
   ],
+  "dependencies": {
+    "cel-js": "^0.8.2"
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0"

package/src/capabilities/invokable.ts

@@ -0,0 +1,3 @@
+export interface Invokable {
+  invoke(inputs: Record<string, any>): Promise<any>;
+}

package/src/capabilities/provider.ts

@@ -0,0 +1,3 @@
+export interface Provider {
+  init(): Promise<void>;
+}

package/src/capabilities/runnable.ts

@@ -0,0 +1,3 @@
+export interface Runnable {
+  run(): Promise<void>;
+}

package/src/context-provider.ts

@@ -0,0 +1,25 @@
+/**
+ * Optional interface that a ResourceInstance can implement to expose
+ * stable, boot-time key/value pairs into the shared CEL context.
+ *
+ * Values are captured once after init() completes and cached for the
+ * lifetime of the initialization phase. Do not return request-specific
+ * or mutable data — this is AOT (Ahead-of-Time) static context only.
+ */
+export interface ContextProvider {
+  provideContext(): Record<string, unknown>;
+}
+
+/**
+ * Duck-type guard: returns true when `instance` has a callable `provideContext` method.
+ * The kernel uses this to detect providers without coupling to any concrete class,
+ * keeping the Core 100% generic.
+ */
+export function isContextProvider(instance: unknown): instance is ContextProvider {
+  return (
+    typeof instance === 'object' &&
+    instance !== null &&
+    'provideContext' in instance &&
+    typeof (instance as Record<string, unknown>)['provideContext'] === 'function'
+  );
+}

package/src/controller-context.ts

@@ -1,21 +1,11 @@
-import { RuntimeEvent } from './runtime-event.js';
+import { RuntimeEvent } from "./runtime-event.js";
 
 export interface ControllerContext {
-  on(
-    event: string,
-    handler: (event: RuntimeEvent) => void | Promise<void>,
-  ): void;
-  once(
-    event: string,
-    handler: (event: RuntimeEvent) => void | Promise<void>,
-  ): void;
-  off(
-    event: string,
-    handler: (event: RuntimeEvent) => void | Promise<void>,
-  ): void;
+  on(event: string, handler: (event: RuntimeEvent) => void | Promise<void>): void;
+  once(event: string, handler: (event: RuntimeEvent) => void | Promise<void>): void;
+  off(event: string, handler: (event: RuntimeEvent) => void | Promise<void>): void;
   emit(event: string, payload?: any, metadata?: Record<string, any>): void;
   acquireHold(reason?: string): () => void;
   requestExit(code: number): void;
-  evaluateCel(expression: string, context: Record<string, any>): unknown;
   expandValue(value: any, context: Record<string, any>): any;
 }