@cuylabs/agent-runtime-dapr 0.5.0 → 0.6.0

package/README.md

@@ -3,6 +3,22 @@
 Run AI agents with **Dapr durability** — crash-safe workflows, persistent state,
 and scheduled jobs. Built on `@cuylabs/agent-core` and `@cuylabs/agent-runtime`.
 
+## Package Boundary
+
+Use `@cuylabs/agent-runtime-dapr` when you want Dapr-backed infrastructure for workloads or agents:
+
+- Dapr runtime driver for scheduled and manually triggered jobs
+- durable workflow decomposition for agent turns
+- persistent execution snapshots and checkpoints
+- hosted HTTP runners and multi-agent hosts
+- Dapr service invocation and workflow clients
+
+This package does not redefine agent semantics or generic workload orchestration.
+It builds on:
+
+- `agent-core` for task and turn execution semantics
+- `agent-runtime` for the outer workload runtime contract
+
 ## Why Dapr?
 
 Dapr provides the durable infrastructure while your agent owns the intelligence:
@@ -30,6 +46,13 @@ import { createDaprAgentRunner } from "@cuylabs/agent-runtime-dapr/host";
 import { DaprWorkflowClient } from "@cuylabs/agent-runtime-dapr/workflow";
 ```
 
+Under the hood, this package now exposes two layers:
+
+- `createDaprWorkloadRuntime(...)` for any workload that fits the neutral
+  `agent-runtime` contract
+- `createDaprAgentRuntime(...)` and `createDaprAgentRunner(...)` as the
+  `agent-core`-specific adapters built on top of that
+
 ## Quick Start
 
 ### Step 1: Define your agent
@@ -214,6 +237,7 @@ invocation), the package also exports the lower-level building blocks:
 |--------|---------|
 | `createDaprAgentWorkflowHost()` | Wrap an Agent into a workflow host |
 | `createDaprWorkflowWorker()` | Register workflow hosts in a WorkflowRuntime |
+| `createDaprWorkloadRuntime()` | Dapr-backed runtime bundle for generic workloads |
 | `createDaprAgentRuntime()` | Create runtime bundle (scheduling + runner + store) |
 | `startDaprHostHttpServer()` | Start the HTTP control surface |
 | `DaprWorkflowClient` | Manage workflow instances via HTTP API |
@@ -230,6 +254,32 @@ See the [docs/](docs/) folder for detailed guides:
 - [API Reference](docs/api-reference.md) — all exported types and functions
 - [Advanced Patterns](docs/advanced-patterns.md) — cross-service invocation, custom observers, etc.
 
+## Runtime Boundary
+
+The package layering is:
+
+- `agent-core`: agent turn/task semantics
+- `agent-runtime`: generic workload orchestration contract
+- `agent-runtime-dapr`: Dapr-backed implementation of that contract
+
+`agent-runtime-dapr` integrates with those lower layers in two different ways:
+
+- outer workload path: it uses `agent-runtime` to schedule, dispatch, retry,
+  and observe jobs
+- inner durable turn path: it uses `agent-core` runtime primitives to split one
+  agent turn into durable workflow activities such as `model-step`,
+  `tool-call`, `step-commit`, and `output-commit`
+
+So this package does not only sit "on top of" `agent-runtime`. It also reaches
+into the reusable turn/task surface exported by `agent-core` when it needs
+fine-grained durable execution.
+
+If you are running ordinary jobs or non-agent workloads, use
+`createDaprWorkloadRuntime(...)`.
+
+If you are running `agent-core` tasks, use `createDaprAgentRuntime(...)` or the
+higher-level `createDaprAgentRunner(...)`.
+
 ## Examples
 
 The [`examples/`](examples/) directory has complete, runnable scripts:

package/dist/{chunk-2FMHOZLU.js → chunk-R47X4FG2.js}

@@ -1092,14 +1092,9 @@ import {
   createAgentTaskRunner
 } from "@cuylabs/agent-core";
 import {
-  createAgentRuntime
+  createWorkloadRuntime,
+  createRuntimeWorkloadExecutor
 } from "@cuylabs/agent-runtime";
-function toErrorMessage(error) {
-  if (error instanceof Error && error.message) {
-    return error.message;
-  }
-  return String(error);
-}
 function createExecutionContext(jobId, runtimeContext) {
   return {
     signal: runtimeContext.signal,
@@ -1139,45 +1134,53 @@ function resolveExecutionStore(options) {
     ...options.executionStoreOptions
   });
 }
-function createExecutor(runTask, options) {
-  return async (job, runtimeContext) => {
-    try {
-      const result = await runTask(
-        job.payload,
-        createExecutionContext(job.id, runtimeContext)
-      );
-      if (options.onTaskResult) {
-        await options.onTaskResult({
-          jobId: job.id,
-          payload: job.payload,
-          runtimeContext,
-          result
-        });
-      }
-      return { status: "ok" };
-    } catch (error) {
-      const message = toErrorMessage(error);
-      if (options.onTaskError) {
-        try {
-          await options.onTaskError({
+function createAgentWorkloadRunner(runTask) {
+  return async (payload, runtimeContext) => {
+    return await runTask(
+      payload,
+      createExecutionContext(runtimeContext.jobId, runtimeContext)
+    );
+  };
+}
+function createDaprWorkloadRuntime(options) {
+  const driver = new DaprRuntimeDriver(options.driver);
+  const runtime = createWorkloadRuntime({
+    ...options.runtime,
+    driver,
+    execute: createRuntimeWorkloadExecutor({
+      run: options.runWorkload,
+      ...options.onWorkloadResult ? {
+        onResult: async ({ job, context, result }) => {
+          await options.onWorkloadResult?.({
             jobId: job.id,
             payload: job.payload,
-            runtimeContext,
+            runtimeContext: context,
+            result
+          });
+        }
+      } : {},
+      ...options.onWorkloadError ? {
+        onError: async ({ job, context, error, message }) => {
+          await options.onWorkloadError?.({
+            jobId: job.id,
+            payload: job.payload,
+            runtimeContext: context,
             error,
             message
           });
-        } catch {
         }
-      }
-      return {
-        status: "error",
-        error: message
-      };
-    }
+      } : {}
+    })
+  });
+  const handleDaprJob = createDaprHttpJobHandler({ driver });
+  return {
+    runtime,
+    driver,
+    runWorkload: options.runWorkload,
+    handleDaprJob
   };
 }
 function createDaprAgentRuntime(options) {
-  const driver = new DaprRuntimeDriver(options.driver);
   const executionStore = resolveExecutionStore(options);
   if (options.taskRunner && executionStore) {
     throw new Error(
@@ -1189,18 +1192,26 @@ function createDaprAgentRuntime(options) {
     options.agent,
     buildTaskRunnerOptions(options, executionObserver)
   );
-  const runtime = createAgentRuntime({
-    ...options.runtime,
-    driver,
-    execute: createExecutor(runTask, options)
+  const runWorkload = createAgentWorkloadRunner(runTask);
+  const bundle = createDaprWorkloadRuntime({
+    driver: options.driver,
+    runtime: options.runtime,
+    runWorkload,
+    ...options.onTaskResult ? {
+      onWorkloadResult: async (context) => {
+        await options.onTaskResult?.(context);
+      }
+    } : {},
+    ...options.onTaskError ? {
+      onWorkloadError: async (context) => {
+        await options.onTaskError?.(context);
+      }
+    } : {}
   });
-  const handleDaprJob = createDaprHttpJobHandler({ driver });
   return {
-    runtime,
-    driver,
+    ...bundle,
     runTask,
-    executionStore,
-    handleDaprJob
+    executionStore
   };
 }
 
@@ -1222,7 +1233,7 @@ function json(value, status = 200) {
 function text(message, status = 200) {
   return new Response(message, { status });
 }
-function toErrorMessage2(error) {
+function toErrorMessage(error) {
   if (error instanceof Error && error.message) {
     return error.message;
   }
@@ -1390,7 +1401,7 @@ function createDaprHostHttpHandler(options) {
         );
         return json(result);
       } catch (error) {
-        return json({ error: toErrorMessage2(error) }, 404);
+        return json({ error: toErrorMessage(error) }, 404);
       }
     }
     if (request.method === "POST" && segments.length === 2 && segments[0] === "agents" && segments[1] === "workflow") {
@@ -1423,7 +1434,7 @@ function createDaprHostHttpHandler(options) {
           sessionId: result.sessionId
         }, 202);
       } catch (error) {
-        return json({ error: toErrorMessage2(error) }, 500);
+        return json({ error: toErrorMessage(error) }, 500);
       }
     }
     if (segments[0] === "agents" && segments.length >= 2) {
@@ -1453,7 +1464,7 @@ function createDaprHostHttpHandler(options) {
             sessionId: result.sessionId
           }, 202);
         } catch (error) {
-          return json({ error: toErrorMessage2(error) }, 500);
+          return json({ error: toErrorMessage(error) }, 500);
         }
       }
       if (request.method === "GET" && segments.length === 4 && segments[2] === "executions") {
@@ -1477,7 +1488,7 @@ async function startDaprHostHttpServer(options) {
       const response = await handler(request);
       await writeResponse(response, res);
     } catch (error) {
-      await writeResponse(json({ error: toErrorMessage2(error) }, 500), res);
+      await writeResponse(json({ error: toErrorMessage(error) }, 500), res);
     }
   });
   await new Promise((resolve, reject) => {
@@ -1533,7 +1544,7 @@ function buildObservers(options) {
   }
   return observers;
 }
-function toErrorMessage3(error) {
+function toErrorMessage2(error) {
   if (error instanceof Error && error.message) {
     return error.message;
   }
@@ -1579,7 +1590,7 @@ async function collectSingleRunnerReadiness(params) {
     checks.push({
       name: "dapr-sidecar",
       ok: false,
-      detail: toErrorMessage3(error)
+      detail: toErrorMessage2(error)
     });
   }
   try {
@@ -1589,7 +1600,7 @@ async function collectSingleRunnerReadiness(params) {
     checks.push({
       name: "state-store",
       ok: false,
-      detail: toErrorMessage3(error)
+      detail: toErrorMessage2(error)
     });
   }
   return {
@@ -1865,7 +1876,7 @@ function createDaprMultiAgentRunner(options) {
         checks.push({
           name: "dapr-sidecar",
           ok: false,
-          detail: toErrorMessage3(error)
+          detail: toErrorMessage2(error)
         });
       }
       try {
@@ -1875,7 +1886,7 @@ function createDaprMultiAgentRunner(options) {
         checks.push({
           name: "state-store",
           ok: false,
-          detail: toErrorMessage3(error)
+          detail: toErrorMessage2(error)
         });
       }
       return {
@@ -1989,6 +2000,7 @@ export {
   createDaprAgentWorkflowHost,
   startDaprAgentWorkflowTurn,
   createDaprWorkflowWorker,
+  createDaprWorkloadRuntime,
   createDaprAgentRuntime,
   createDaprHostHttpHandler,
   startDaprHostHttpServer,

package/dist/host/index.d.ts

@@ -1,4 +1,4 @@
-export { D as DaprAgentRunner, a as DaprAgentRunnerOptions, b as DaprAgentRuntimeBundle, c as DaprAgentRuntimeOptions, d as DaprAgentServeOptions, e as DaprAgentTaskErrorContext, f as DaprAgentTaskResultContext, g as DaprAgentWorkflowHost, h as DaprAgentWorkflowHostOptions, i as DaprAgentWorkflowRunRequest, j as DaprAgentWorkflowRunResult, k as DaprHostApp, l as DaprHostHttpHandlerOptions, m as DaprHostHttpServer, n as DaprHostHttpServerOptions, o as DaprHostReadinessCheck, p as DaprHostReadinessStatus, q as DaprHostRemoteRunRequest, r as DaprHostedAgentInfo, u as DaprInvokeMethodOptions, v as DaprInvokeMethodResult, x as DaprMultiAgentRunner, y as DaprMultiAgentRunnerAgentConfig, z as DaprMultiAgentRunnerOptions, B as DaprServiceInvoker, C as DaprServiceInvokerOptions, E as DaprWorkflowRuntimeRegistrar, F as DaprWorkflowStarterLike, G as DaprWorkflowWorker, H as DaprWorkflowWorkerAgentDefinition, I as DaprWorkflowWorkerLogger, J as DaprWorkflowWorkerOptions, K as DaprWorkflowWorkerRuntime, R as RemoteAgentRunRequest, L as RemoteAgentRunResponse, M as createDaprAgentRunner, N as createDaprAgentRuntime, O as createDaprAgentWorkflowHost, P as createDaprHostHttpHandler, S as createDaprMultiAgentRunner, T as createDaprWorkflowWorker, U as invokeRemoteAgentRun, V as startDaprAgentWorkflowTurn, W as startDaprHostHttpServer } from '../index-CKTP36vE.js';
+export { D as DaprAgentRunner, a as DaprAgentRunnerOptions, b as DaprAgentRuntimeBundle, c as DaprAgentRuntimeOptions, d as DaprAgentServeOptions, e as DaprAgentTaskErrorContext, f as DaprAgentTaskResultContext, g as DaprAgentWorkflowHost, h as DaprAgentWorkflowHostOptions, i as DaprAgentWorkflowRunRequest, j as DaprAgentWorkflowRunResult, k as DaprHostApp, l as DaprHostHttpHandlerOptions, m as DaprHostHttpServer, n as DaprHostHttpServerOptions, o as DaprHostReadinessCheck, p as DaprHostReadinessStatus, q as DaprHostRemoteRunRequest, r as DaprHostedAgentInfo, u as DaprInvokeMethodOptions, v as DaprInvokeMethodResult, x as DaprMultiAgentRunner, y as DaprMultiAgentRunnerAgentConfig, z as DaprMultiAgentRunnerOptions, B as DaprServiceInvoker, C as DaprServiceInvokerOptions, E as DaprWorkflowRuntimeRegistrar, F as DaprWorkflowStarterLike, G as DaprWorkflowWorker, H as DaprWorkflowWorkerAgentDefinition, I as DaprWorkflowWorkerLogger, J as DaprWorkflowWorkerOptions, K as DaprWorkflowWorkerRuntime, L as DaprWorkloadErrorContext, M as DaprWorkloadResultContext, N as DaprWorkloadRuntimeBundle, O as DaprWorkloadRuntimeOptions, R as RemoteAgentRunRequest, P as RemoteAgentRunResponse, Q as createDaprAgentRunner, S as createDaprAgentRuntime, T as createDaprAgentWorkflowHost, U as createDaprHostHttpHandler, W as createDaprMultiAgentRunner, X as createDaprWorkflowWorker, Y as createDaprWorkloadRuntime, Z as invokeRemoteAgentRun, _ as startDaprAgentWorkflowTurn, $ as startDaprHostHttpServer } from '../index-nZvCz3bO.js';
 import '@cuylabs/agent-core';
 import '../store-pRLGfYhN.js';
 import '../workflow-bridge-C8Z1yr0Y.js';

package/dist/host/index.js

@@ -6,10 +6,11 @@ import {
   createDaprHostHttpHandler,
   createDaprMultiAgentRunner,
   createDaprWorkflowWorker,
+  createDaprWorkloadRuntime,
   invokeRemoteAgentRun,
   startDaprAgentWorkflowTurn,
   startDaprHostHttpServer
-} from "../chunk-2FMHOZLU.js";
+} from "../chunk-R47X4FG2.js";
 import "../chunk-2CEICSJH.js";
 import "../chunk-DILON56B.js";
 import "../chunk-A34CHK2E.js";
@@ -21,6 +22,7 @@ export {
   createDaprHostHttpHandler,
   createDaprMultiAgentRunner,
   createDaprWorkflowWorker,
+  createDaprWorkloadRuntime,
   invokeRemoteAgentRun,
   startDaprAgentWorkflowTurn,
   startDaprHostHttpServer

package/dist/{index-CKTP36vE.d.ts → index-nZvCz3bO.d.ts}

@@ -1,7 +1,7 @@
 import { AgentWorkflowTurnState, Agent, AgentTaskObserver, AgentTaskPayload, AgentTaskResult, AgentTaskRunner, AgentTaskRunnerOptions } from '@cuylabs/agent-core';
 import { h as DaprExecutionStore } from './store-pRLGfYhN.js';
 import { DaprAgentTurnWorkflowActivityNames, DaprAgentTurnWorkflowDefinition, StartDaprWorkflowOptions, DaprStartWorkflowResponse, CreateDaprAgentTurnWorkflowKitOptions, DaprWorkflowClient } from './workflow/index.js';
-import { RuntimeDriver, RuntimeDriverContext, RuntimeJobRecord, AgentRuntime, AgentRuntimeOptions, RuntimeExecutionContext } from '@cuylabs/agent-runtime';
+import { RuntimeDriver, RuntimeDriverContext, RuntimeJobRecord, WorkloadRuntime, RuntimeWorkloadRunner, WorkloadRuntimeOptions, RuntimeWorkloadContext } from '@cuylabs/agent-runtime';
 import { c as DaprRuntimeDriverOptions, a as DaprExecutionStoreOptions } from './workflow-bridge-C8Z1yr0Y.js';
 import { Server } from 'node:http';
 
@@ -228,29 +228,53 @@ interface DaprWorkflowWorker {
  */
 declare function createDaprWorkflowWorker(options: DaprWorkflowWorkerOptions): DaprWorkflowWorker;
 
-interface DaprAgentTaskResultContext<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+interface DaprWorkloadResultContext<TPayload = unknown, TResult = unknown> {
     jobId: string;
     payload: TPayload;
-    runtimeContext: RuntimeExecutionContext;
-    result: AgentTaskResult;
+    runtimeContext: RuntimeWorkloadContext;
+    result: TResult;
 }
-interface DaprAgentTaskErrorContext<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+interface DaprWorkloadErrorContext<TPayload = unknown> {
     jobId: string;
     payload: TPayload;
-    runtimeContext: RuntimeExecutionContext;
+    runtimeContext: RuntimeWorkloadContext;
     error: unknown;
     message: string;
 }
-interface DaprAgentRuntimeOptions<TPayload extends AgentTaskPayload = AgentTaskPayload> {
-    /** Agent instance used for job execution. */
-    agent: Agent;
+interface DaprWorkloadRuntimeOptions<TPayload = unknown, TResult = unknown> {
     /** Dapr driver configuration (sidecar + state store + retries). */
     driver: DaprRuntimeDriverOptions;
     /**
      * Optional runtime options excluding driver and execute.
      * Use this to set concurrency/timeouts/logging behavior.
      */
-    runtime?: Omit<AgentRuntimeOptions<TPayload>, "driver" | "execute">;
+    runtime?: Omit<WorkloadRuntimeOptions<TPayload>, "driver" | "execute">;
+    /**
+     * Domain workload executed for each scheduled or manually triggered job.
+     *
+     * This is the neutral seam between `agent-runtime` orchestration and
+     * application-specific work. `agent-core` task runners can plug in here,
+     * but so can any other job/workload adapter.
+     */
+    runWorkload: RuntimeWorkloadRunner<TPayload, TResult>;
+    /** Optional hook invoked after successful workload execution. */
+    onWorkloadResult?: (context: DaprWorkloadResultContext<TPayload, TResult>) => void | Promise<void>;
+    /** Optional hook invoked when workload execution fails. */
+    onWorkloadError?: (context: DaprWorkloadErrorContext<TPayload>) => void | Promise<void>;
+}
+interface DaprWorkloadRuntimeBundle<TPayload = unknown, TResult = unknown> {
+    runtime: WorkloadRuntime<TPayload>;
+    driver: DaprRuntimeDriver<TPayload>;
+    runWorkload: RuntimeWorkloadRunner<TPayload, TResult>;
+    handleDaprJob: (jobName: string) => Promise<DaprHttpJobHandlerResult>;
+}
+interface DaprAgentTaskResultContext<TPayload extends AgentTaskPayload = AgentTaskPayload> extends DaprWorkloadResultContext<TPayload, AgentTaskResult> {
+}
+interface DaprAgentTaskErrorContext<TPayload extends AgentTaskPayload = AgentTaskPayload> extends DaprWorkloadErrorContext<TPayload> {
+}
+interface DaprAgentRuntimeOptions<TPayload extends AgentTaskPayload = AgentTaskPayload> extends Omit<DaprWorkloadRuntimeOptions<TPayload, AgentTaskResult>, "runWorkload" | "onWorkloadResult" | "onWorkloadError"> {
+    /** Agent instance used for job execution. */
+    agent: Agent;
     /**
      * Optional explicit task runner. If omitted, one is created with
      * createAgentTaskRunner(agent, taskRunnerOptions).
@@ -281,21 +305,28 @@ interface DaprAgentRuntimeOptions<TPayload extends AgentTaskPayload = AgentTaskP
     /** Optional hook invoked when task execution fails. */
     onTaskError?: (context: DaprAgentTaskErrorContext<TPayload>) => void | Promise<void>;
 }
-interface DaprAgentRuntimeBundle<TPayload extends AgentTaskPayload = AgentTaskPayload> {
-    runtime: AgentRuntime<TPayload>;
-    driver: DaprRuntimeDriver<TPayload>;
+interface DaprAgentRuntimeBundle<TPayload extends AgentTaskPayload = AgentTaskPayload> extends DaprWorkloadRuntimeBundle<TPayload, AgentTaskResult> {
     runTask: AgentTaskRunner<TPayload>;
     executionStore?: DaprExecutionStore<TPayload>;
-    handleDaprJob: (jobName: string) => Promise<DaprHttpJobHandlerResult>;
 }
 /**
- * Create a Dapr-backed runtime bundle for executing agent tasks.
+ * Create a Dapr-backed runtime bundle for generic application workloads.
+ *
+ * This is the neutral Dapr implementation of the `agent-runtime` workload
+ * contract. Agent-specific helpers in this package are built on top of this.
+ */
+declare function createDaprWorkloadRuntime<TPayload = unknown, TResult = unknown>(options: DaprWorkloadRuntimeOptions<TPayload, TResult>): DaprWorkloadRuntimeBundle<TPayload, TResult>;
+/**
+ * Create a Dapr-backed runtime bundle for executing `agent-core` task
+ * workloads. This is a thin agent-specific wrapper over
+ * `createDaprWorkloadRuntime(...)`.
+ *
+ * This is the outer integration seam:
+ * - `createAgentTaskRunner(...)` adapts an `Agent` into a workload-shaped task
+ * - `createDaprWorkloadRuntime(...)` lets `agent-runtime` schedule and dispatch it
  *
- * The returned bundle includes:
- * - runtime: scheduling + execution loop
- * - driver: Dapr persistence/scheduler adapter
- * - runTask: direct task runner (for manual invocation/tests)
- * - handleDaprJob: reusable callback handler for `/job/:name` routes
+ * Durable workflow decomposition is handled separately by the workflow host
+ * and `workflow/runtime.ts`.
  */
 declare function createDaprAgentRuntime<TPayload extends AgentTaskPayload = AgentTaskPayload>(options: DaprAgentRuntimeOptions<TPayload>): DaprAgentRuntimeBundle<TPayload>;
 
@@ -424,7 +455,7 @@ interface DaprAgentRunner {
     readonly name: string;
     /** The underlying workflow host. */
     readonly workflowHost: DaprAgentWorkflowHost;
-    /** The underlying runtime bundle (scheduling, task runner, execution store). */
+    /** The underlying runtime bundle (scheduling, workload adapter, execution store). */
     readonly runtimeBundle: DaprAgentRuntimeBundle;
     /** The underlying workflow worker. */
     readonly worker: DaprWorkflowWorker;
@@ -458,7 +489,7 @@ interface DaprAgentRunner {
  *
  * Equivalent to Diagrid's `DaprWorkflowAgentRunner`. Internally creates:
  * - Workflow host (Dapr workflow registration + turn state management)
- * - Runtime bundle (scheduling + task runner + execution store)
+ * - Runtime bundle (scheduling + workload adapter + execution store)
  * - Workflow worker (gRPC worker for Dapr workflow engine)
  * - Workflow client (HTTP client for managing workflow instances)
  * - HTTP server (on `serve()`)
@@ -530,4 +561,4 @@ interface DaprMultiAgentRunner {
  */
 declare function createDaprMultiAgentRunner(options: DaprMultiAgentRunnerOptions): DaprMultiAgentRunner;
 
-export { DaprRuntimeDriver as A, DaprServiceInvoker as B, type DaprServiceInvokerOptions as C, type DaprAgentRunner as D, type DaprWorkflowRuntimeRegistrar as E, type DaprWorkflowStarterLike as F, type DaprWorkflowWorker as G, type DaprWorkflowWorkerAgentDefinition as H, type DaprWorkflowWorkerLogger as I, type DaprWorkflowWorkerOptions as J, type DaprWorkflowWorkerRuntime as K, type RemoteAgentRunResponse as L, createDaprAgentRunner as M, createDaprAgentRuntime as N, createDaprAgentWorkflowHost as O, createDaprHostHttpHandler as P, createDaprHttpJobHandler as Q, type RemoteAgentRunRequest as R, createDaprMultiAgentRunner as S, createDaprWorkflowWorker as T, invokeRemoteAgentRun as U, startDaprAgentWorkflowTurn as V, startDaprHostHttpServer as W, type DaprAgentRunnerOptions as a, type DaprAgentRuntimeBundle as b, type DaprAgentRuntimeOptions as c, type DaprAgentServeOptions as d, type DaprAgentTaskErrorContext as e, type DaprAgentTaskResultContext as f, type DaprAgentWorkflowHost as g, type DaprAgentWorkflowHostOptions as h, type DaprAgentWorkflowRunRequest as i, type DaprAgentWorkflowRunResult as j, type DaprHostApp as k, type DaprHostHttpHandlerOptions as l, type DaprHostHttpServer as m, type DaprHostHttpServerOptions as n, type DaprHostReadinessCheck as o, type DaprHostReadinessStatus as p, type DaprHostRemoteRunRequest as q, type DaprHostedAgentInfo as r, type DaprHttpJobHandlerOptions as s, type DaprHttpJobHandlerResult as t, type DaprInvokeMethodOptions as u, type DaprInvokeMethodResult as v, type DaprJobTriggerHandler as w, type DaprMultiAgentRunner as x, type DaprMultiAgentRunnerAgentConfig as y, type DaprMultiAgentRunnerOptions as z };
+export { startDaprHostHttpServer as $, DaprRuntimeDriver as A, DaprServiceInvoker as B, type DaprServiceInvokerOptions as C, type DaprAgentRunner as D, type DaprWorkflowRuntimeRegistrar as E, type DaprWorkflowStarterLike as F, type DaprWorkflowWorker as G, type DaprWorkflowWorkerAgentDefinition as H, type DaprWorkflowWorkerLogger as I, type DaprWorkflowWorkerOptions as J, type DaprWorkflowWorkerRuntime as K, type DaprWorkloadErrorContext as L, type DaprWorkloadResultContext as M, type DaprWorkloadRuntimeBundle as N, type DaprWorkloadRuntimeOptions as O, type RemoteAgentRunResponse as P, createDaprAgentRunner as Q, type RemoteAgentRunRequest as R, createDaprAgentRuntime as S, createDaprAgentWorkflowHost as T, createDaprHostHttpHandler as U, createDaprHttpJobHandler as V, createDaprMultiAgentRunner as W, createDaprWorkflowWorker as X, createDaprWorkloadRuntime as Y, invokeRemoteAgentRun as Z, startDaprAgentWorkflowTurn as _, type DaprAgentRunnerOptions as a, type DaprAgentRuntimeBundle as b, type DaprAgentRuntimeOptions as c, type DaprAgentServeOptions as d, type DaprAgentTaskErrorContext as e, type DaprAgentTaskResultContext as f, type DaprAgentWorkflowHost as g, type DaprAgentWorkflowHostOptions as h, type DaprAgentWorkflowRunRequest as i, type DaprAgentWorkflowRunResult as j, type DaprHostApp as k, type DaprHostHttpHandlerOptions as l, type DaprHostHttpServer as m, type DaprHostHttpServerOptions as n, type DaprHostReadinessCheck as o, type DaprHostReadinessStatus as p, type DaprHostRemoteRunRequest as q, type DaprHostedAgentInfo as r, type DaprHttpJobHandlerOptions as s, type DaprHttpJobHandlerResult as t, type DaprInvokeMethodOptions as u, type DaprInvokeMethodResult as v, type DaprJobTriggerHandler as w, type DaprMultiAgentRunner as x, type DaprMultiAgentRunnerAgentConfig as y, type DaprMultiAgentRunnerOptions as z };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { D as DaprOrchestratorRunStoreOptions } from './workflow-bridge-C8Z1yr0Y.js';
 export { a as DaprExecutionStoreOptions, b as DaprFetch, c as DaprRuntimeDriverOptions, d as DaprSidecarClientOptions, e as DaprStateStoreClientOptions, f as DaprWorkflowObserverBridge, g as DaprWorkflowObserverOptions, h as createWorkflowObserverBridge } from './workflow-bridge-C8Z1yr0Y.js';
 export { CreateDaprAgentTurnWorkflowDefinitionOptions, CreateDaprAgentTurnWorkflowKitOptions, CreateDaprAgentTurnWorkflowOptions, DaprAgentTurnActivityRegistration, DaprAgentTurnCommitActivityOptions, DaprAgentTurnModelStepActivityOptions, DaprAgentTurnToolCallActivityOptions, DaprAgentTurnWorkflowActivityNames, DaprAgentTurnWorkflowContextLike, DaprAgentTurnWorkflowDefinition, DaprAgentTurnWorkflowKit, DaprAgentTurnWorkflowRegistration, DaprStartWorkflowResponse, DaprWorkflowApiVersion, DaprWorkflowClient, DaprWorkflowClientOptions, DaprWorkflowRuntimeStatus, DaprWorkflowState, RaiseDaprWorkflowEventOptions, StartDaprWorkflowOptions, WaitForDaprWorkflowOptions, createDaprAgentTurnModelStepActivity, createDaprAgentTurnOutputCommitActivity, createDaprAgentTurnStepCommitActivity, createDaprAgentTurnToolCallActivity, createDaprAgentTurnWorkflowDefinition, createDaprAgentTurnWorkflowKit, hasStartedDaprWorkflow, isTerminalDaprWorkflowStatus } from './workflow/index.js';
-export { D as DaprAgentRunner, a as DaprAgentRunnerOptions, b as DaprAgentRuntimeBundle, c as DaprAgentRuntimeOptions, d as DaprAgentServeOptions, e as DaprAgentTaskErrorContext, f as DaprAgentTaskResultContext, g as DaprAgentWorkflowHost, h as DaprAgentWorkflowHostOptions, i as DaprAgentWorkflowRunRequest, j as DaprAgentWorkflowRunResult, k as DaprHostApp, l as DaprHostHttpHandlerOptions, m as DaprHostHttpServer, n as DaprHostHttpServerOptions, o as DaprHostReadinessCheck, p as DaprHostReadinessStatus, q as DaprHostRemoteRunRequest, r as DaprHostedAgentInfo, s as DaprHttpJobHandlerOptions, t as DaprHttpJobHandlerResult, u as DaprInvokeMethodOptions, v as DaprInvokeMethodResult, w as DaprJobTriggerHandler, x as DaprMultiAgentRunner, y as DaprMultiAgentRunnerAgentConfig, z as DaprMultiAgentRunnerOptions, A as DaprRuntimeDriver, B as DaprServiceInvoker, C as DaprServiceInvokerOptions, E as DaprWorkflowRuntimeRegistrar, F as DaprWorkflowStarterLike, G as DaprWorkflowWorker, H as DaprWorkflowWorkerAgentDefinition, I as DaprWorkflowWorkerLogger, J as DaprWorkflowWorkerOptions, K as DaprWorkflowWorkerRuntime, R as RemoteAgentRunRequest, L as RemoteAgentRunResponse, M as createDaprAgentRunner, N as createDaprAgentRuntime, O as createDaprAgentWorkflowHost, P as createDaprHostHttpHandler, Q as createDaprHttpJobHandler, S as createDaprMultiAgentRunner, T as createDaprWorkflowWorker, U as invokeRemoteAgentRun, V as startDaprAgentWorkflowTurn, W as startDaprHostHttpServer } from './index-CKTP36vE.js';
+export { D as DaprAgentRunner, a as DaprAgentRunnerOptions, b as DaprAgentRuntimeBundle, c as DaprAgentRuntimeOptions, d as DaprAgentServeOptions, e as DaprAgentTaskErrorContext, f as DaprAgentTaskResultContext, g as DaprAgentWorkflowHost, h as DaprAgentWorkflowHostOptions, i as DaprAgentWorkflowRunRequest, j as DaprAgentWorkflowRunResult, k as DaprHostApp, l as DaprHostHttpHandlerOptions, m as DaprHostHttpServer, n as DaprHostHttpServerOptions, o as DaprHostReadinessCheck, p as DaprHostReadinessStatus, q as DaprHostRemoteRunRequest, r as DaprHostedAgentInfo, s as DaprHttpJobHandlerOptions, t as DaprHttpJobHandlerResult, u as DaprInvokeMethodOptions, v as DaprInvokeMethodResult, w as DaprJobTriggerHandler, x as DaprMultiAgentRunner, y as DaprMultiAgentRunnerAgentConfig, z as DaprMultiAgentRunnerOptions, A as DaprRuntimeDriver, B as DaprServiceInvoker, C as DaprServiceInvokerOptions, E as DaprWorkflowRuntimeRegistrar, F as DaprWorkflowStarterLike, G as DaprWorkflowWorker, H as DaprWorkflowWorkerAgentDefinition, I as DaprWorkflowWorkerLogger, J as DaprWorkflowWorkerOptions, K as DaprWorkflowWorkerRuntime, L as DaprWorkloadErrorContext, M as DaprWorkloadResultContext, N as DaprWorkloadRuntimeBundle, O as DaprWorkloadRuntimeOptions, R as RemoteAgentRunRequest, P as RemoteAgentRunResponse, Q as createDaprAgentRunner, S as createDaprAgentRuntime, T as createDaprAgentWorkflowHost, U as createDaprHostHttpHandler, V as createDaprHttpJobHandler, W as createDaprMultiAgentRunner, X as createDaprWorkflowWorker, Y as createDaprWorkloadRuntime, Z as invokeRemoteAgentRun, _ as startDaprAgentWorkflowTurn, $ as startDaprHostHttpServer } from './index-nZvCz3bO.js';
 export { D as DaprExecutionCheckpointRecord, a as DaprExecutionCleanupOptions, b as DaprExecutionCleanupResult, c as DaprExecutionContextMetadata, d as DaprExecutionErrorRecord, e as DaprExecutionRunRecord, f as DaprExecutionSnapshot, g as DaprExecutionStatus, h as DaprExecutionStore } from './store-pRLGfYhN.js';
 export { DaprExecutionObserver, DaprExecutionObserverOptions, DaprHostLoggerLike, DaprLoggingObserverOptions, OtelObserverConfig, createDaprExecutionObserver, createDaprLoggingObserver, createOtelObserver } from './execution/index.js';
 import { OrchestratorRunStatus, OrchestratorRunStore, OrchestratorRunRecord } from '@cuylabs/agent-runtime';

package/dist/index.js

@@ -9,10 +9,11 @@ import {
   createDaprHttpJobHandler,
   createDaprMultiAgentRunner,
   createDaprWorkflowWorker,
+  createDaprWorkloadRuntime,
   invokeRemoteAgentRun,
   startDaprAgentWorkflowTurn,
   startDaprHostHttpServer
-} from "./chunk-2FMHOZLU.js";
+} from "./chunk-R47X4FG2.js";
 import {
   DaprExecutionObserver,
   DaprExecutionStore,
@@ -55,6 +56,7 @@ export {
   createDaprLoggingObserver,
   createDaprMultiAgentRunner,
   createDaprWorkflowWorker,
+  createDaprWorkloadRuntime,
   createOtelObserver,
   createWorkflowObserverBridge,
   hasStartedDaprWorkflow,

package/dist/workflow/index.d.ts

@@ -62,6 +62,15 @@ interface DaprStartWorkflowResponse {
 declare function isTerminalDaprWorkflowStatus(status: DaprWorkflowRuntimeStatus): boolean;
 declare function hasStartedDaprWorkflow(status: DaprWorkflowRuntimeStatus): boolean;
 
+/**
+ * Durable workflow execution for agent turns.
+ *
+ * This is the inner integration seam between `agent-runtime-dapr` and
+ * `agent-core`: instead of scheduling a whole task as one opaque unit, the
+ * workflow reuses `agent-core` turn primitives to run model, tool, and commit
+ * phases as separate durable activities.
+ */
+
 interface DaprAgentTurnWorkflowActivityNames {
     modelStep: string;
     toolCall: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cuylabs/agent-runtime-dapr",
-  "version": "0.5.0",
-  "description": "Dapr-backed runtime driver for @cuylabs/agent-runtime",
+  "version": "0.6.0",
+  "description": "Dapr-backed workload runtime and host adapters for @cuylabs/agent-runtime",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -32,8 +32,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@cuylabs/agent-core": "^0.5.0",
-    "@cuylabs/agent-runtime": "^0.5.0"
+    "@cuylabs/agent-core": "^0.6.0",
+    "@cuylabs/agent-runtime": "^0.6.0"
   },
   "peerDependencies": {
     "@dapr/dapr": "^3.6.1",
@@ -65,7 +65,7 @@
     "typescript": "^5.7.0",
     "vitest": "^4.0.18",
     "zod": "^3.24.0",
-    "@cuylabs/agent-code": "^0.5.0"
+    "@cuylabs/agent-code": "^0.6.0"
   },
   "keywords": [
     "agent",