@ekairos/events 1.22.35-beta.development.0 → 1.22.36-beta.development.0

package/dist/context.engine.d.ts

@@ -69,7 +69,11 @@ export interface ContextStreamOptions {
  */
 export type ContextModelInit = string | (() => Promise<any>);
 export type ContextReactParams<Env extends ContextEnvironment = ContextEnvironment> = {
-    runtime: ContextRuntime<Env>;
+    runtime?: ContextRuntime<Env>;
+    /**
+     * Backward-compatible runtime selector. New callers should pass `runtime`.
+     */
+    env?: Env;
     /**
      * Context selector (exclusive: `{ id }` OR `{ key }`).
      * - `{ id }` resolves a concrete context id.

package/dist/context.engine.js

@@ -11,6 +11,30 @@ import { getContextDurableWorkflow } from "./context.durable.js";
 export async function runContextReactionDirect(context, triggerEvent, params) {
     return await ContextEngine.runDirect(context, triggerEvent, params);
 }
+async function legacyRuntimeFromEnv(env) {
+    const { getContextRuntime } = await import("./runtime.step.js");
+    const legacy = (await getContextRuntime(env));
+    return {
+        env,
+        db: async () => legacy.db,
+        resolve: async () => ({
+            db: legacy.db,
+            meta: () => ({
+                domain: legacy.domain,
+            }),
+        }),
+        meta: () => ({
+            domain: legacy.domain,
+        }),
+    };
+}
+async function resolveReactRuntime(params) {
+    if (params.runtime)
+        return params.runtime;
+    if (params.env)
+        return await legacyRuntimeFromEnv(params.env);
+    throw new Error("ContextEngine.react requires either runtime or env.");
+}
 export { toolApprovalHookToken, toolApprovalWebhookToken, getClientResumeHookUrl };
 function nowIso() {
     return new Date().toISOString();
@@ -330,8 +354,9 @@ export class ContextEngine {
         return await ContextEngine.runDirect(this, triggerEvent, params);
     }
     static async prepareExecutionShell(story, triggerEvent, params) {
-        const env = params.runtime.env;
-        const ops = await measureBenchmark(params.__benchmark, "react.resolveOpsMs", async () => await getContextEngineOps(params.runtime, params.__benchmark));
+        const runtimeHandle = await resolveReactRuntime(params);
+        const env = runtimeHandle.env;
+        const ops = await measureBenchmark(params.__benchmark, "react.resolveOpsMs", async () => await getContextEngineOps(runtimeHandle, params.__benchmark));
         const silent = params.options?.silent ?? false;
         const ctxResult = await measureBenchmark(params.__benchmark, "react.initializeContextMs", async () => await ops.initializeContext(params.context ?? null, { silent }));
         let currentContext = ctxResult.context;
@@ -357,7 +382,8 @@ export class ContextEngine {
         };
     }
     static async startDurable(story, triggerEvent, params) {
-        const env = params.runtime.env;
+        const runtimeHandle = await resolveReactRuntime(params);
+        const env = runtimeHandle.env;
         if (params.options?.writable) {
             throw new Error("ContextEngine.react: durable runs manage their own workflow stream");
         }
@@ -378,7 +404,7 @@ export class ContextEngine {
             const startedRun = await start(workflow, [
                 {
                     contextKey,
-                    runtime: params.runtime,
+                    runtime: runtimeHandle,
                     context: params.context ?? null,
                     triggerEvent,
                     options: {
@@ -401,7 +427,7 @@ export class ContextEngine {
                 status: startedRun.status,
                 returnValue: startedRun.returnValue,
             };
-            const runtime = await createRuntimeOps(params.runtime);
+            const runtime = await createRuntimeOps(runtimeHandle);
             await runtime.db.transact([
                 runtime.db.tx.event_executions[shell.execution.id].update({
                     workflowRunId: startedRun.runId,
@@ -410,7 +436,7 @@ export class ContextEngine {
             ]);
         }
         catch (error) {
-            const ops = await getContextEngineOps(params.runtime, params.__benchmark);
+            const ops = await getContextEngineOps(runtimeHandle, params.__benchmark);
             await ops.completeExecution(shell.contextSelector, shell.execution.id, "failed").catch(() => null);
             throw error;
         }
@@ -423,8 +449,9 @@ export class ContextEngine {
         };
     }
     static async runDirect(story, triggerEvent, params) {
-        const env = params.runtime.env;
-        const ops = await measureBenchmark(params.__benchmark, "react.resolveOpsMs", async () => await getContextEngineOps(params.runtime, params.__benchmark));
+        const runtimeHandle = await resolveReactRuntime(params);
+        const env = runtimeHandle.env;
+        const ops = await measureBenchmark(params.__benchmark, "react.resolveOpsMs", async () => await getContextEngineOps(runtimeHandle, params.__benchmark));
         const maxIterations = params.options?.maxIterations ?? 20;
         const maxModelSteps = params.options?.maxModelSteps ?? 1;
         const preventClose = params.options?.preventClose ?? false;
@@ -499,7 +526,7 @@ export class ContextEngine {
                 }));
                 currentStepId = stepCreate.stepId;
                 currentStepStream = await createPersistedContextStepStream({
-                    runtime: params.runtime,
+                    runtime: runtimeHandle,
                     executionId,
                     stepId: stepCreate.stepId,
                 });
@@ -575,7 +602,7 @@ export class ContextEngine {
                     }, { executionId, contextId: String(currentContext.id) });
                 };
                 const reactionResult = await measureBenchmark(params.__benchmark, `${stagePrefix}.reactorMs`, async () => await reactor({
-                    runtime: params.runtime,
+                    runtime: runtimeHandle,
                     env,
                     context: updatedContext,
                     contextIdentifier: activeContextSelector,
@@ -673,7 +700,7 @@ export class ContextEngine {
                 }
                 if (currentStepStream) {
                     await closePersistedContextStepStream({
-                        runtime: params.runtime,
+                        runtime: runtimeHandle,
                         session: currentStepStream,
                     });
                     currentStepStream = null;
@@ -853,7 +880,7 @@ export class ContextEngine {
                             }
                         }
                         const output = await toolDef.execute(actionInput, {
-                            runtime: params.runtime,
+                            runtime: runtimeHandle,
                             env,
                             context: updatedContext,
                             contextIdentifier: activeContextSelector,
@@ -1060,7 +1087,7 @@ export class ContextEngine {
             if (currentStepStream) {
                 try {
                     await abortPersistedContextStepStream({
-                        runtime: params.runtime,
+                        runtime: runtimeHandle,
                         session: currentStepStream,
                         reason: error instanceof Error ? error.message : String(error),
                     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekairos/events",
-  "version": "1.22.35-beta.development.0",
+  "version": "1.22.36-beta.development.0",
   "description": "Ekairos Events - Context-first workflow runtime",
   "type": "module",
   "main": "dist/index.js",
@@ -117,7 +117,7 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^2.0.52",
-    "@ekairos/domain": "^1.22.35-beta.development.0",
+    "@ekairos/domain": "^1.22.36-beta.development.0",
     "@instantdb/admin": "0.22.158",
     "@instantdb/core": "0.22.142",
     "@vercel/mcp-adapter": "^1.0.0",