@telorun/sdk 0.2.4 → 0.2.6

package/dist/module-context.js

@@ -0,0 +1,177 @@
+import { EvaluationContext } from "./evaluation-context.js";
+/** Wraps process.env so that missing keys return null instead of throwing in CEL.
+ * cel-js uses Object.hasOwn(obj, key) before accessing obj[key], so we must
+ * intercept getOwnPropertyDescriptor to report every string key as "own". */
+function lenientEnv(env) {
+    return new Proxy(env, {
+        get(target, key) {
+            if (typeof key !== "string")
+                return target[key];
+            return key in target ? (target[key] ?? null) : null;
+        },
+        has() {
+            return true;
+        },
+        getOwnPropertyDescriptor(target, key) {
+            if (typeof key !== "string")
+                return Object.getOwnPropertyDescriptor(target, key);
+            const value = key in target ? (target[key] ?? null) : null;
+            return { configurable: true, enumerable: true, writable: true, value };
+        },
+    });
+}
+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;
+    _hostEnv;
+    _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, _hostEnv) {
+        super(source, {}, createInstance, new Set(), emit);
+        this.targets = targets;
+        this._hostEnv = _hostEnv;
+        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();
+    }
+    onResourceSnapshotted(name, snap) {
+        this.setResource(name, snap);
+    }
+    /**
+     * 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;
+    }
+    getInvocable(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._hostEnv ? { env: lenientEnv(this._hostEnv) } : {}),
+        };
+        this._secretValues = collectSecretValues(this._secrets);
+    }
+    async invoke(kind, name, inputs) {
+        const result = await super.invoke(kind, name, inputs);
+        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/ref.d.ts

@@ -0,0 +1,47 @@
+import type { ResourceInstance } from "./resource-instance.js";
+/** Marker type for x-telo-ref fields. Carries the live instance type at the TypeScript level;
+ *  at runtime this field holds `{ kind, name }` until Phase 5 injection replaces it.
+ *  T is a phantom type — any capability interface (Invocable, Runnable, …) or ResourceInstance. */
+export interface KindRef<T = ResourceInstance> {
+    readonly kind: string;
+    readonly name: string;
+    readonly __type?: T;
+}
+/** Marker type for x-telo-scope fields. Has no runtime value — used only as a discriminant
+ *  for Injected<T> to transform the field to ScopeHandle. */
+export interface ScopeRef {
+    readonly __scope: true;
+}
+/** Gives a controller access to the resources initialized within a scope. */
+export interface ScopeContext {
+    /** Returns the initialized instance for the given name.
+     *  Throws synchronously if the name was not declared in the scope —
+     *  this is always a programming error; all scope members are statically
+     *  validated in Phase 3 before the kernel ever reaches runtime. */
+    getInstance(name: string): ResourceInstance;
+}
+/** Returned by Phase 5 injection in place of an x-telo-scope manifest array.
+ *  The controller calls run() to open the scope, execute work, and tear it down. */
+export interface ScopeHandle {
+    run<T>(fn: (scope: ScopeContext) => Promise<T>): Promise<T>;
+}
+/** Transforms the raw config shape into the controller's view:
+ *  - KindRef<U>   → U        (live instance, injected by Phase 5)
+ *  - KindRef<U>[] → U[]      (live instances, injected by Phase 5)
+ *  - ScopeRef     → ScopeHandle
+ *  - everything else is unchanged */
+export type Injected<T> = {
+    [K in keyof T]: T[K] extends KindRef<infer U> ? U : T[K] extends KindRef<infer U>[] ? U[] : NonNullable<T[K]> extends ScopeRef ? ScopeHandle | Exclude<T[K], ScopeRef> : T[K];
+};
+/** Returns a schema node that emits `x-telo-ref` for buildReferenceFieldMap and carries
+ *  KindRef<T> as its TypeScript type. For TypeBox schemas use Type.Unsafe<KindRef<T>>(Ref(...)).
+ *
+ *  @param ref Canonical ref string: "namespace/module-name#TypeName" or "kernel#TypeName" */
+export declare const Ref: <T = ResourceInstance>(ref: string) => KindRef<T>;
+/** Returns a schema node that emits `x-telo-scope` for buildReferenceFieldMap and carries
+ *  ScopeRef as its TypeScript type. For TypeBox schemas use Type.Unsafe<ScopeRef>(Scope(...)).
+ *
+ *  @param visibilityPath JSON Pointer(s) (RFC 6901) declaring where x-telo-ref slots within
+ *                        this field can resolve to scoped resources. */
+export declare const Scope: (visibilityPath: string | string[]) => ScopeRef;
+//# sourceMappingURL=ref.d.ts.map

package/dist/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;mGAEmG;AACnG,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,gBAAgB;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACrB;AAED;6DAC6D;AAC7D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;CACxB;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B;;;uEAGmE;IACnE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;CAC7C;AAED;oFACoF;AACpF,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7D;AAED;;;;qCAIqC;AACrC,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACzC,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,GAC7B,CAAC,EAAE,GACH,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAChC,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GACrC,CAAC,CAAC,CAAC,CAAC;CACb,CAAC;AAEF;;;6FAG6F;AAC7F,eAAO,MAAM,GAAG,GAAI,CAAC,GAAG,gBAAgB,EAAE,KAAK,MAAM,KAAG,OAAO,CAAC,CAAC,CACf,CAAC;AAEnD;;;;wEAIwE;AACxE,eAAO,MAAM,KAAK,GAAI,gBAAgB,MAAM,GAAG,MAAM,EAAE,KAAG,QACG,CAAC"}

package/dist/ref.js

@@ -0,0 +1,11 @@
+/** Returns a schema node that emits `x-telo-ref` for buildReferenceFieldMap and carries
+ *  KindRef<T> as its TypeScript type. For TypeBox schemas use Type.Unsafe<KindRef<T>>(Ref(...)).
+ *
+ *  @param ref Canonical ref string: "namespace/module-name#TypeName" or "kernel#TypeName" */
+export const Ref = (ref) => ({ "x-telo-ref": ref });
+/** Returns a schema node that emits `x-telo-scope` for buildReferenceFieldMap and carries
+ *  ScopeRef as its TypeScript type. For TypeBox schemas use Type.Unsafe<ScopeRef>(Scope(...)).
+ *
+ *  @param visibilityPath JSON Pointer(s) (RFC 6901) declaring where x-telo-ref slots within
+ *                        this field can resolve to scoped resources. */
+export const Scope = (visibilityPath) => ({ "x-telo-scope": visibilityPath });

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;
@@ -11,10 +13,14 @@ export declare class NoopValidator implements DataValidator {
 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>;
+    invoke<TInputs>(kind: string, name: string, inputs: TInputs, options?: 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;
+    transientChild(context: Record<string, any>): EvaluationContext;
+    withManifests<T>(manifests: any[], fn: () => T): T;
     resolveChildren(resource: any, resourceName?: string): {
         kind: string;
         name: string;
@@ -25,8 +31,11 @@ export interface ResourceContext extends ControllerContext {
     lookupSchema(name: string): object | undefined;
     registerController(moduleName: string, kindName: string, controllerInstance: any): Promise<void>;
     registerDefinition(definition: any): void;
-    registerCapability(name: string, schema?: Record<string, any>): void;
-    isCapabilityRegistered(name: string): boolean;
-    getCapabilitySchema(name: string): Record<string, any> | null | undefined;
+    registerModuleImport(alias: string, targetModule: string, kinds: string[]): void;
     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":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC;CAC7B;AAED,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO;IAIP,QAAQ;CAGT;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IACzC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1F,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IAC9C,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;IACvE,gBAAgB,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IACtC,iBAAiB,IAAI,iBAAiB,CAAC;IACvC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC;IAChE,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACnD,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAC9C,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,aAAa,CAAC;IAClD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/C,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjG,kBAAkB,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;IAC1C,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;CAC/B"}

package/dist/resource-instance.d.ts

@@ -1,13 +1,9 @@
-import { ResourceContext } from "./resource-context.js";
-export type ResourceInstance = {
+import type { Invocable } from "./capabilities/invokable.js";
+import type { Runnable } from "./capabilities/runnable.js";
+import type { ResourceContext } from "./resource-context.js";
+export type ResourceInstance<TInput = Record<string, any>, TOutput = any> = Partial<Invocable<TInput, TOutput>> & Partial<Runnable> & {
     init?(ctx?: ResourceContext): Promise<void>;
-    run?(): void | Promise<void>;
-    invoke?(input: any): any | Promise<any>;
     teardown?(): void | Promise<void>;
-    /**
-     * Optional method for debugging/snapshots
-     * Called when taking runtime state snapshots
-     * Should return serializable state data specific to this resource
-     */
     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,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,gBAAgB,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,GAAG,IAAI,OAAO,CACjF,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAC3B,GACC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAClB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,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,8 @@
-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' | 'ERR_VISIBILITY_DENIED';
+export interface RuntimeDiagnostic {
+    severity?: "error" | "warning";
+    message: string;
+    resource?: string;
+    code?: string;
+}
+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" | "ERR_MANIFEST_VALIDATION_FAILED" | "ERR_CIRCULAR_DEPENDENCY" | "ERR_SCOPE_RESOURCE_NOT_FOUND";
+//# 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,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,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,GACvB,gCAAgC,GAChC,yBAAyB,GACzB,8BAA8B,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,70 @@
+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 { RuntimeDiagnostic, 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 interface ResourceDefinition {
+    kind: string;
+    metadata: {
+        name: string;
+        module: string;
+    };
+    /** JSON Schema for the resource's compile-time configuration fields. */
+    schema?: Record<string, any>;
+    capability?: 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.
+ *
+ * TResource - the typed shape of the resource manifest (compile-time config)
+ * TInput    - the typed shape of invoke() inputs (runtime)
+ * TOutput   - the typed shape of invoke() outputs (runtime)
+ */
+export interface ControllerInstance<TResource extends ResourceManifest = ResourceManifest, TInput = Record<string, any>, TOutput = any> {
+    execute?(name: string, inputs: any, ctx: ExecContext): Promise<any>;
+    compile?(resource: TResource, ctx: ResourceContext): RuntimeResource | Promise<RuntimeResource>;
+    register?(ctx: ControllerContext): void | Promise<void>;
+    create?(resource: TResource, ctx: ResourceContext): ResourceInstance<TInput, TOutput> | null | Promise<ResourceInstance<TInput, TOutput> | null>;
+    schema?: any;
+    /** JSON Schema for invoke() inputs — used for runtime validation and static analysis. */
+    inputSchema?: Record<string, any>;
+    /** JSON Schema for invoke() outputs — used for documentation and static analysis. */
+    outputSchema?: Record<string, 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;
+    diagnostics?: RuntimeDiagnostic[] | undefined;
+    constructor(code: RuntimeErrorCode, message: string, diagnostics?: RuntimeDiagnostic[] | undefined);
+}
+//# 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":"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"}

package/dist/types.js

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

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "bun": "./src/index.ts",
       "import": "./dist/index.js",

package/src/capabilities/invokable.ts

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

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/compiled-value.ts

@@ -0,0 +1,11 @@
+/** A precompiled template or expression produced by the analyzer.
+ *  Replaces raw "${{ }}" strings in manifests at load time.
+ *  The SDK has no knowledge of CEL — it only calls .call(). */
+export interface CompiledValue {
+  readonly __compiled: true;
+  call(ctx: Record<string, unknown>): unknown;
+}
+
+export function isCompiledValue(v: unknown): v is CompiledValue {
+  return v !== null && typeof v === "object" && (v as any).__compiled === true;
+}

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;
 }