@telorun/sdk 0.2.3 → 0.2.4

package/README.md

@@ -1,6 +1,6 @@
 # Telo SDK (Node.js)
 
-The Node.js SDK provides the authoring surface for Telo modules. It defines the shared contracts (types and lifecycle interfaces) that modules use to plug into the runtime, so module code stays consistent across implementations.
+The Node.js SDK provides the authoring surface for Telo modules. It defines the shared contracts (types and lifecycle interfaces) that modules use to plug into the kernel, so module code stays consistent across implementations.
 
 ## What It Provides
 
@@ -14,10 +14,10 @@ Early prototype. APIs and contracts are still evolving. The API surface - includ
 
 ## When to Use It
 
-Use the SDK when building or extending Telo modules. It is not the runtime itself; it is the contract layer that keeps module behavior consistent and predictable.
+Use the SDK when building or extending Telo modules. It is not the kernel itself; it is the contract layer that keeps module behavior consistent and predictable.
 
 ## Related Docs
 
-- Runtime overview: `runtime/README.md`
+- Kernel overview: `kernel/README.md`
 - Built‑in modules: `modiles/`
 - SDKs index: `sdk/README.md`

package/dist/context-provider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 declare function isContextProvider(instance: unknown): instance is ContextProvider;

package/dist/context-provider.js

@@ -0,0 +1,11 @@
+/**
+ * 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) {
+    return (typeof instance === 'object' &&
+        instance !== null &&
+        'provideContext' in instance &&
+        typeof instance['provideContext'] === 'function');
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './controller-context.js';
+export * from './context-provider.js';
 export * from './resource-context.js';
 export * from './resource-instance.js';
 export * from './resource-manifest.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './controller-context.js';
+export * from './context-provider.js';
 export * from './resource-context.js';
 export * from './resource-instance.js';
 export * from './resource-manifest.js';

package/dist/resource-context.d.ts

@@ -15,9 +15,18 @@ export interface ResourceContext extends ControllerContext {
     getResources(kind: string): RuntimeResource[];
     getResourcesByName(kind: string, name: string): RuntimeResource | null;
     registerManifest(resource: any): void;
+    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;
+    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>;
 }

package/dist/runtime-error.d.ts

@@ -1 +1 @@
-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_CONTROLLER_NOT_FOUND' | 'ERR_CONTROLLER_INVALID' | 'ERR_RESOURCE_NOT_INVOKABLE' | 'ERR_DUPLICATE_RESOURCE' | 'ERR_EXECUTION_FAILED' | 'ERR_INVALID_VALUE' | 'ERR_VISIBILITY_DENIED';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {

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/index.ts

@@ -1,4 +1,5 @@
 export * from './controller-context.js';
+export * from './context-provider.js';
 export * from './resource-context.js';
 export * from './resource-instance.js';
 export * from './resource-manifest.js';

package/src/resource-context.ts

@@ -23,13 +23,19 @@ export interface ResourceContext extends ControllerContext {
   getResources(kind: string): RuntimeResource[];
   getResourcesByName(kind: string, name: string): RuntimeResource | null;
   registerManifest(resource: any): void;
+  resolveChildren(resource: any, resourceName?: string): { kind: string; name: string };
   validateSchema(value: any, schema: any): void;
   createSchemaValidator(schema: any): DataValidator;
+  registerSchema(name: string, schema: object): void;
+  lookupSchema(name: string): object | undefined;
   registerController(
     moduleName: string,
-    resourceKind: 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;
   teardownResource(kind: string, name: string): Promise<void>;
 }

package/src/runtime-error.ts

@@ -5,4 +5,5 @@ export type RuntimeErrorCode =
   | 'ERR_RESOURCE_NOT_INVOKABLE'
   | 'ERR_DUPLICATE_RESOURCE'
   | 'ERR_EXECUTION_FAILED'
-  | 'ERR_INVALID_VALUE';
+  | 'ERR_INVALID_VALUE'
+  | 'ERR_VISIBILITY_DENIED';