@cuylabs/agent-runtime-dapr 0.9.0 → 0.11.0

package/dist/index-CFm5LORU.d.ts

@@ -0,0 +1,63 @@
+import { e as DaprAgentTurnApprovalCheckActivityOptions, b as DaprAgentTurnActivityRegistration, f as DaprAgentTurnApprovalCheckInput, g as DaprAgentTurnApprovalCheckResult, i as DaprAgentTurnHumanInputCheckActivityOptions, j as DaprAgentTurnHumanInputCheckInput, k as DaprAgentTurnHumanInputCheckResult, l as DaprAgentTurnModelStepActivityOptions, h as DaprAgentTurnCommitActivityOptions, m as DaprAgentTurnSteerDrainActivityOptions, n as DaprAgentTurnSteerDrainInput, o as DaprAgentTurnToolCallActivityOptions, C as CreateDaprAgentTurnWorkflowDefinitionOptions, t as DaprAgentTurnWorkflowRegistration, c as CreateDaprAgentTurnWorkflowKitOptions, s as DaprAgentTurnWorkflowKit } from './client-UsEIzDF6.js';
+import { AgentWorkflowModelStepPlan, AgentWorkflowModelStepResult, AgentWorkflowOutputCommitPlan, AgentWorkflowCommitResult, AgentWorkflowInputCommitPlan, AgentWorkflowStepCommitPlan, AgentWorkflowToolCallPlan, AgentWorkflowToolCallResult } from '@cuylabs/agent-core';
+
+/**
+ * Durable activity handlers for agent-turn workflows.
+ *
+ * Each activity is a single checkpointed unit of work:
+ * - Model-step: runs the LLM (one inference call)
+ * - Tool-call: executes a single tool
+ * - Step-commit: persists assistant/tool messages to session store
+ * - Output-commit: persists the final assistant output
+ *
+ * Extracted from `runtime.ts` for maintainability.
+ */
+
+declare function createDaprAgentTurnSteerDrainActivity(options: DaprAgentTurnSteerDrainActivityOptions): DaprAgentTurnActivityRegistration<DaprAgentTurnSteerDrainInput, {
+    id: string;
+    message: string;
+    createdAt: string;
+}[]>;
+/**
+ * Build the default model-step activity over the extracted `agent-core`
+ * phase helpers.
+ */
+declare function createDaprAgentTurnModelStepActivity(options: DaprAgentTurnModelStepActivityOptions): DaprAgentTurnActivityRegistration<AgentWorkflowModelStepPlan, AgentWorkflowModelStepResult>;
+/**
+ * Build the default single-tool-call activity.
+ *
+ * One tool call per activity is the durable boundary used by the workflow
+ * adapter. That is intentionally finer-grained than the in-process
+ * `runToolBatch(...)` helper.
+ */
+declare function createDaprAgentTurnToolCallActivity(options: DaprAgentTurnToolCallActivityOptions): DaprAgentTurnActivityRegistration<AgentWorkflowToolCallPlan, AgentWorkflowToolCallResult>;
+declare function createDaprAgentTurnApprovalCheckActivity(options: DaprAgentTurnApprovalCheckActivityOptions): DaprAgentTurnActivityRegistration<DaprAgentTurnApprovalCheckInput, DaprAgentTurnApprovalCheckResult>;
+declare function createDaprAgentTurnHumanInputCheckActivity(options: DaprAgentTurnHumanInputCheckActivityOptions): DaprAgentTurnActivityRegistration<DaprAgentTurnHumanInputCheckInput, DaprAgentTurnHumanInputCheckResult>;
+/**
+ * Build the default step-commit activity that appends assistant/tool messages
+ * to the durable session store owned by the host app.
+ */
+declare function createDaprAgentTurnStepCommitActivity(options: DaprAgentTurnCommitActivityOptions): DaprAgentTurnActivityRegistration<AgentWorkflowInputCommitPlan | AgentWorkflowStepCommitPlan, AgentWorkflowCommitResult>;
+/**
+ * Build the default output-commit activity that appends the final assistant
+ * message to the durable session store owned by the host app.
+ */
+declare function createDaprAgentTurnOutputCommitActivity(options: DaprAgentTurnCommitActivityOptions): DaprAgentTurnActivityRegistration<AgentWorkflowOutputCommitPlan, AgentWorkflowCommitResult>;
+
+/**
+ * Create the deterministic workflow definition that a host app can register
+ * with the Dapr JS SDK runtime.
+ *
+ * The returned workflow stays SDK-agnostic at the package boundary: it only
+ * assumes a context with `callActivity()` and optional `setCustomStatus()`.
+ */
+declare function createDaprAgentTurnWorkflowDefinition(options: CreateDaprAgentTurnWorkflowDefinitionOptions): DaprAgentTurnWorkflowRegistration;
+/**
+ * Create a full workflow registration kit with default activity handlers.
+ *
+ * Host apps can register the returned workflow and activities directly with the
+ * Dapr JS SDK runtime while keeping execution semantics in `agent-core`.
+ */
+declare function createDaprAgentTurnWorkflowKit(options: CreateDaprAgentTurnWorkflowKitOptions): DaprAgentTurnWorkflowKit;
+
+export { createDaprAgentTurnHumanInputCheckActivity as a, createDaprAgentTurnModelStepActivity as b, createDaprAgentTurnApprovalCheckActivity as c, createDaprAgentTurnOutputCommitActivity as d, createDaprAgentTurnSteerDrainActivity as e, createDaprAgentTurnStepCommitActivity as f, createDaprAgentTurnToolCallActivity as g, createDaprAgentTurnWorkflowDefinition as h, createDaprAgentTurnWorkflowKit as i };

package/dist/index-UtePd9on.d.ts

@@ -0,0 +1,101 @@
+import { DispatchRecord, DispatchTarget, DispatchTargetInspection, DispatchRuntime, TaskExecutor } from '@cuylabs/agent-core';
+import { e as DaprStateStoreClientOptions } from './workflow-bridge-BcicHH1Y.js';
+import { D as DaprWorkflowClient, z as DaprWorkflowState } from './client-UsEIzDF6.js';
+import { a as DaprAgentWorkflowHost, d as DaprAgentWorkflowRunRequest } from './workflow-host-D6W6fXoL.js';
+import { b as DaprServiceInvoker, c as DaprServiceInvokerOptions } from './invoker-B6ikdYaz.js';
+import { h as DaprExecutionStore } from './store-BXBIDz40.js';
+
+interface DaprDispatchRecord extends DispatchRecord {
+    agentId: string;
+}
+type DaprDispatchTargetInspection = DispatchTargetInspection;
+type DaprDispatchTarget = DispatchTarget<DaprDispatchRecord>;
+interface DaprDispatchRuntimeOptions extends DaprStateStoreClientOptions {
+    agentId: string;
+    targets: readonly DaprDispatchTarget[];
+    keyPrefix?: string;
+    now?: () => string;
+    pollIntervalMs?: number;
+    createId?: () => string;
+}
+interface DaprDispatchRecordWriterOptions extends DaprStateStoreClientOptions {
+    agentId: string;
+    keyPrefix?: string;
+}
+interface WorkflowDispatchTargetOptions {
+    name: string;
+    description: string;
+    host: DaprAgentWorkflowHost;
+    client: DaprWorkflowClient;
+    /**
+     * Optional hook for customizing the child workflow input.
+     * `message`, `sessionId`, and `workflowInstanceId` defaults are provided.
+     */
+    buildRequest?: (input: {
+        id: string;
+        brief: string;
+        title: string;
+        parentSessionId?: string;
+        sessionId?: string;
+    }) => DaprAgentWorkflowRunRequest;
+    /**
+     * Optional terminal-state reader that can attach a final result or
+     * richer error details when the child workflow completes.
+     */
+    readCompletion?: (input: {
+        record: DaprDispatchRecord;
+        workflow: DaprWorkflowState;
+    }) => Promise<Pick<DispatchTargetInspection, "result" | "error"> | undefined>;
+    /**
+     * When `true`, waits for the child workflow to reach a running state
+     * before returning the dispatch record. This confirms the sidecar has
+     * actually scheduled the workflow before the caller proceeds.
+     * Default: `false`.
+     */
+    waitForStart?: boolean;
+}
+interface RemoteAgentDispatchTargetOptions {
+    name: string;
+    description: string;
+    appId: string;
+    agentId?: string;
+    invoker?: DaprServiceInvoker;
+    invokerOptions?: DaprServiceInvokerOptions;
+    buildRunRequest?: (input: {
+        id: string;
+        brief: string;
+        title: string;
+        parentSessionId?: string;
+        sessionId?: string;
+    }) => {
+        message: string;
+        sessionId?: string;
+    };
+}
+declare function createWorkflowDispatchTarget(options: WorkflowDispatchTargetOptions): DaprDispatchTarget;
+declare function createRemoteAgentDispatchTarget(options: RemoteAgentDispatchTargetOptions): DaprDispatchTarget;
+declare function createDaprDispatchRuntime(options: DaprDispatchRuntimeOptions): DispatchRuntime;
+
+interface DaprWorkflowDispatchExecutorOptions {
+    workflowHosts: Map<string, DaprAgentWorkflowHost>;
+    workflowClient: DaprWorkflowClient;
+    executionStore?: DaprExecutionStore;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+declare function createDaprWorkflowDispatchExecutor(options: DaprWorkflowDispatchExecutorOptions): TaskExecutor;
+interface DaprAppDispatchExecutorOptions {
+    appsByRole: Map<string, string>;
+    invoker?: DaprServiceInvoker;
+    invokerOptions?: DaprServiceInvokerOptions;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+declare function createDaprAppDispatchExecutor(options: DaprAppDispatchExecutorOptions): TaskExecutor;
+declare function createDaprCompositeDispatchExecutor(options: {
+    workflow?: DaprWorkflowDispatchExecutorOptions;
+    app?: DaprAppDispatchExecutorOptions;
+    fallback?: TaskExecutor;
+}): TaskExecutor;
+
+export { type DaprDispatchRuntimeOptions as D, type RemoteAgentDispatchTargetOptions as R, type WorkflowDispatchTargetOptions as W, type DaprDispatchRecordWriterOptions as a, type DaprAppDispatchExecutorOptions as b, type DaprDispatchRecord as c, type DaprDispatchTarget as d, type DaprDispatchTargetInspection as e, type DaprWorkflowDispatchExecutorOptions as f, createDaprAppDispatchExecutor as g, createDaprCompositeDispatchExecutor as h, createDaprDispatchRuntime as i, createDaprWorkflowDispatchExecutor as j, createRemoteAgentDispatchTarget as k, createWorkflowDispatchTarget as l };

package/dist/index.d.ts

@@ -1,12 +1,23 @@
-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, 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-BCMkUMAf.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';
+import { a as DaprOrchestratorRunStoreOptions } from './workflow-bridge-BcicHH1Y.js';
+export { D 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-BcicHH1Y.js';
+import { D as DaprWorkflowClient, a as DaprAgentTurnWorkflowToolHandler, b as DaprAgentTurnActivityRegistration } from './client-UsEIzDF6.js';
+export { C as CreateDaprAgentTurnWorkflowDefinitionOptions, c as CreateDaprAgentTurnWorkflowKitOptions, d as CreateDaprAgentTurnWorkflowOptions, e as DaprAgentTurnApprovalCheckActivityOptions, f as DaprAgentTurnApprovalCheckInput, g as DaprAgentTurnApprovalCheckResult, h as DaprAgentTurnCommitActivityOptions, i as DaprAgentTurnHumanInputCheckActivityOptions, j as DaprAgentTurnHumanInputCheckInput, k as DaprAgentTurnHumanInputCheckResult, l as DaprAgentTurnModelStepActivityOptions, m as DaprAgentTurnSteerDrainActivityOptions, n as DaprAgentTurnSteerDrainInput, o as DaprAgentTurnToolCallActivityOptions, p as DaprAgentTurnWorkflowActivityNames, q as DaprAgentTurnWorkflowContextLike, r as DaprAgentTurnWorkflowDefinition, s as DaprAgentTurnWorkflowKit, t as DaprAgentTurnWorkflowRegistration, u as DaprAgentTurnWorkflowToolHandlerInput, v as DaprStartWorkflowResponse, w as DaprWorkflowApiVersion, x as DaprWorkflowClientOptions, y as DaprWorkflowRuntimeStatus, z as DaprWorkflowState, R as RaiseDaprWorkflowEventOptions, S as StartDaprWorkflowOptions, W as WaitForDaprWorkflowOptions, A as hasStartedDaprWorkflow, B as isTerminalDaprWorkflowStatus } from './client-UsEIzDF6.js';
+export { C as CreateDaprAgentServerAdapterOptions, a as CreateRemoteAgentToolOptions, D as DaprAgentDurableRunOptions, b as DaprAgentDurableRunResult, c as DaprAgentRunner, d as DaprAgentRunnerOptions, e as DaprAgentRuntimeBundle, f as DaprAgentRuntimeOptions, g as DaprAgentServeOptions, h as DaprAgentTaskErrorContext, i as DaprAgentTaskResultContext, j as DaprHostApp, k as DaprHostHttpHandlerOptions, l as DaprHostHttpServer, m as DaprHostHttpServerOptions, n as DaprHostReadinessCheck, o as DaprHostReadinessStatus, p as DaprHostRemoteRunRequest, q as DaprHostedAgentInfo, r as DaprHttpJobHandlerOptions, s as DaprHttpJobHandlerResult, t as DaprJobTriggerHandler, u as DaprMultiAgentRunner, v as DaprMultiAgentRunnerAgentConfig, w as DaprMultiAgentRunnerOptions, x as DaprRuntimeDriver, y as DaprWorkloadErrorContext, z as DaprWorkloadResultContext, A as DaprWorkloadRuntimeBundle, B as DaprWorkloadRuntimeOptions, E as createDaprAgentRunner, F as createDaprAgentRuntime, G as createDaprAgentServerAdapter, H as createDaprHostHttpHandler, I as createDaprHttpJobHandler, J as createDaprMultiAgentRunner, K as createDaprWorkloadRuntime, L as createRemoteAgentTool, M as startDaprHostHttpServer } from './index-BY0FipV1.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-BXBIDz40.js';
 export { DaprExecutionObserver, DaprExecutionObserverOptions, DaprHostLoggerLike, DaprLoggingObserverOptions, OtelObserverConfig, createDaprExecutionObserver, createDaprLoggingObserver, createOtelObserver } from './execution/index.js';
 import { OrchestratorRunStatus, OrchestratorRunStore, OrchestratorRunRecord } from '@cuylabs/agent-runtime';
-import '@cuylabs/agent-core';
+export { c as createDaprAgentTurnApprovalCheckActivity, a as createDaprAgentTurnHumanInputCheckActivity, b as createDaprAgentTurnModelStepActivity, d as createDaprAgentTurnOutputCommitActivity, e as createDaprAgentTurnSteerDrainActivity, f as createDaprAgentTurnStepCommitActivity, g as createDaprAgentTurnToolCallActivity, h as createDaprAgentTurnWorkflowDefinition, i as createDaprAgentTurnWorkflowKit } from './index-CFm5LORU.js';
+export { D as DaprInvokeMethodOptions, a as DaprInvokeMethodResult, b as DaprServiceInvoker, c as DaprServiceInvokerOptions, R as RemoteAgentRunRequest, d as RemoteAgentRunResponse, i as invokeRemoteAgentRun } from './invoker-B6ikdYaz.js';
+import { a as DaprAgentWorkflowHost } from './workflow-host-D6W6fXoL.js';
+export { b as DaprAgentWorkflowFollowUpRequest, c as DaprAgentWorkflowHostOptions, d as DaprAgentWorkflowRunRequest, e as DaprAgentWorkflowRunResult, f as DaprAgentWorkflowSteerRequest, g as DaprApprovalDecision, h as DaprApprovalRequestListOptions, i as DaprApprovalRequestRecord, j as DaprApprovalRequestStatus, k as DaprApprovalResolution, l as DaprFollowUpListOptions, m as DaprFollowUpRecord, n as DaprHumanInputRequestListOptions, o as DaprHumanInputRequestRecord, p as DaprHumanInputRequestStatus, q as DaprPubSubEventBridge, r as DaprPubSubEventBridgeOptions, s as DaprSteerRecord, t as DaprWorkflowApprovalCheckInput, u as DaprWorkflowApprovalCheckResult, v as DaprWorkflowApprovalRuntime, w as DaprWorkflowApprovalRuntimeOptions, x as DaprWorkflowEventRaiserLike, y as DaprWorkflowFollowUpRuntime, z as DaprWorkflowFollowUpRuntimeOptions, A as DaprWorkflowHumanInputCheckInput, B as DaprWorkflowHumanInputCheckResult, C as DaprWorkflowHumanInputRuntime, E as DaprWorkflowHumanInputRuntimeOptions, D as DaprWorkflowRuntimeRegistrar, F as DaprWorkflowStarterLike, G as DaprWorkflowSteerRuntime, H as DaprWorkflowSteerRuntimeOptions, I as createDaprAgentWorkflowHost, J as createDaprPubSubEventBridge, K as createDaprWorkflowApprovalRuntime, L as createDaprWorkflowFollowUpRuntime, M as createDaprWorkflowHumanInputRuntime, N as createDaprWorkflowSteerRuntime, O as startDaprAgentWorkflowTurn } from './workflow-host-D6W6fXoL.js';
+export { D as DaprWorkflowWorker, a as DaprWorkflowWorkerAgentDefinition, b as DaprWorkflowWorkerLogger, c as DaprWorkflowWorkerOptions, d as DaprWorkflowWorkerRuntime, e as createDaprWorkflowWorker } from './worker-CXq0IFGX.js';
+export { EventBus, EventBusMessage, EventBusOptions, EventBusSubscribeOptions, EventBusSubscription, createEventBus } from '@cuylabs/agent-core/events';
+import { D as DaprDispatchRuntimeOptions, a as DaprDispatchRecordWriterOptions } from './index-UtePd9on.js';
+export { b as DaprAppDispatchExecutorOptions, c as DaprDispatchRecord, d as DaprDispatchTarget, e as DaprDispatchTargetInspection, f as DaprWorkflowDispatchExecutorOptions, R as RemoteAgentDispatchTargetOptions, W as WorkflowDispatchTargetOptions, g as createDaprAppDispatchExecutor, h as createDaprCompositeDispatchExecutor, i as createDaprDispatchRuntime, j as createDaprWorkflowDispatchExecutor, k as createRemoteAgentDispatchTarget, l as createWorkflowDispatchTarget } from './index-UtePd9on.js';
+import { SubAgentRole, Agent, Tool } from '@cuylabs/agent-core';
+export { AppliedCoordinatorActionsResult, ApplyCoordinatorActionsActivityOptions, ApplyCoordinatorActionsInput, CheckTrackedTasksTerminalActivityOptions, CheckTrackedTasksTerminalInput, CollectWorkerReportsActivityOptions, CollectWorkerReportsInput, CollectedWorkerReportsResult, CommitExternalTaskActivityOptions, CommitExternalTaskInput, CommittedCoordinatorTaskResult, CoordinatorAssignment, CoordinatorChildLaunch, CoordinatorReasonActivityInput, CoordinatorReasonActivityOptions, CoordinatorReasonResult, CoordinatorRecordedAction, CoordinatorTaskNotification, CoordinatorTrackedTask, CoordinatorWorkflowActivityNames, CoordinatorWorkflowInput, CoordinatorWorkflowRegistration, CoordinatorWorkflowResult, CreateCoordinatorWorkflowOptions, DaprMailboxStore, DaprMailboxStoreOptions, DaprTaskBoardStore, DaprTaskBoardStoreOptions, DaprTeamDispatchOptions, DaprTeamDurableRunOptions, DaprTeamDurableRunStartResult, DaprTeamDurableRunState, DaprTeamHttpHandlerOptions, DaprTeamRunner, DaprTeamRunnerOptions, DaprTeamServeOptions, PrepareExternalTasksActivityOptions, PrepareExternalTasksInput, PreparedExternalTasksResult, createApplyCoordinatorActionsActivity, createCheckTrackedTasksTerminalActivity, createCollectWorkerReportsActivity, createCommitExternalTaskActivity, createCoordinatorReasonActivity, createCoordinatorWorkflowDefinition, createDaprTeamHttpHandler, createDaprTeamRunner, createPrepareExternalTasksActivity } from './team/index.js';
 import 'node:http';
+import '@cuylabs/agent-core/team';
 
 interface DaprOrchestratorRunCleanupOptions {
     maxAgeMs?: number;
@@ -31,17 +42,54 @@ declare class DaprOrchestratorRunStore<TInput = unknown, TResult = unknown> impl
     remove(runId: string): Promise<boolean>;
     cleanup(options?: DaprOrchestratorRunCleanupOptions): Promise<DaprOrchestratorRunCleanupResult>;
     private stateKeyForRun;
-    private stateKeyForIndex;
     private readRun;
     private writeRun;
-    private readIndex;
-    private writeIndex;
-    private addToIndex;
-    private removeFromIndex;
     private listRunsViaStateQuery;
-    private listRunsFromIndex;
     private decodeStoredRun;
-    private updateIndex;
 }
 
-export { type DaprOrchestratorRunCleanupOptions, type DaprOrchestratorRunCleanupResult, DaprOrchestratorRunStore, DaprOrchestratorRunStoreOptions };
+declare const DAPR_SUBAGENT_BACKEND = "@cuylabs/agent-runtime-dapr/workflow";
+interface DaprSubAgentToolsOptions extends Omit<DaprDispatchRuntimeOptions, "targets" | "agentId"> {
+    agentId: string;
+    roles: readonly SubAgentRole[];
+    workflowHosts: ReadonlyMap<string, DaprAgentWorkflowHost>;
+    workflowComponent: string;
+    workflowClient?: DaprWorkflowClient;
+    async?: boolean;
+    sessionTitlePrefix?: string;
+    maxConcurrent?: number;
+    maxDepth?: number;
+    currentDepth?: number;
+}
+interface DaprSubAgentInstallOptions extends Omit<DaprSubAgentToolsOptions, "roles" | "async" | "sessionTitlePrefix"> {
+    agent: Agent;
+    config: DaprSubAgentConfig;
+}
+interface DaprSubAgentConfig {
+    roles: readonly SubAgentRole[];
+    async?: boolean;
+    sessionTitlePrefix?: string;
+    maxConcurrent?: number;
+    maxDepth?: number;
+    currentDepth?: number;
+    mode?: "dispatch" | "child-workflow";
+}
+declare function configureDaprSubAgents(agent: object, config: DaprSubAgentConfig): DaprSubAgentConfig;
+declare function getConfiguredDaprSubAgents(agent: object): DaprSubAgentConfig | undefined;
+declare function createDaprSubAgentTools(options: DaprSubAgentToolsOptions): Tool.AnyInfo[];
+declare function installDaprSubAgents(options: DaprSubAgentInstallOptions): readonly Tool.AnyInfo[];
+
+interface CreateDaprSubAgentWorkflowSupportOptions extends DaprDispatchRecordWriterOptions {
+    workflowName: string;
+    agentId: string;
+    config: DaprSubAgentConfig;
+    roles: readonly SubAgentRole[];
+    workflowHosts: ReadonlyMap<string, DaprAgentWorkflowHost>;
+}
+interface DaprSubAgentWorkflowSupport {
+    workflowToolHandlers: readonly DaprAgentTurnWorkflowToolHandler[];
+    additionalActivities: readonly DaprAgentTurnActivityRegistration<any, any>[];
+}
+declare function createDaprSubAgentWorkflowSupport(options: CreateDaprSubAgentWorkflowSupportOptions): DaprSubAgentWorkflowSupport;
+
+export { type CreateDaprSubAgentWorkflowSupportOptions, DAPR_SUBAGENT_BACKEND, DaprAgentTurnActivityRegistration, DaprAgentTurnWorkflowToolHandler, DaprAgentWorkflowHost, DaprDispatchRuntimeOptions, type DaprOrchestratorRunCleanupOptions, type DaprOrchestratorRunCleanupResult, DaprOrchestratorRunStore, DaprOrchestratorRunStoreOptions, type DaprSubAgentConfig, type DaprSubAgentInstallOptions, type DaprSubAgentToolsOptions, type DaprSubAgentWorkflowSupport, DaprWorkflowClient, configureDaprSubAgents, createDaprSubAgentTools, createDaprSubAgentWorkflowSupport, getConfiguredDaprSubAgents, installDaprSubAgents };

package/dist/index.js

@@ -1,19 +1,52 @@
 import {
+  DAPR_SUBAGENT_BACKEND,
+  DaprMailboxStore,
   DaprOrchestratorRunStore,
   DaprRuntimeDriver,
-  DaprServiceInvoker,
+  DaprTaskBoardStore,
+  configureDaprSubAgents,
+  createApplyCoordinatorActionsActivity,
+  createCheckTrackedTasksTerminalActivity,
+  createCollectWorkerReportsActivity,
+  createCommitExternalTaskActivity,
+  createCoordinatorReasonActivity,
+  createCoordinatorWorkflowDefinition,
   createDaprAgentRunner,
   createDaprAgentRuntime,
+  createDaprAgentServerAdapter,
   createDaprAgentWorkflowHost,
   createDaprHostHttpHandler,
   createDaprHttpJobHandler,
   createDaprMultiAgentRunner,
+  createDaprPubSubEventBridge,
+  createDaprSubAgentTools,
+  createDaprSubAgentWorkflowSupport,
+  createDaprTeamHttpHandler,
+  createDaprTeamRunner,
+  createDaprWorkflowApprovalRuntime,
+  createDaprWorkflowFollowUpRuntime,
+  createDaprWorkflowHumanInputRuntime,
+  createDaprWorkflowSteerRuntime,
   createDaprWorkflowWorker,
   createDaprWorkloadRuntime,
-  invokeRemoteAgentRun,
+  createEventBus,
+  createPrepareExternalTasksActivity,
+  createRemoteAgentTool,
+  getConfiguredDaprSubAgents,
+  installDaprSubAgents,
   startDaprAgentWorkflowTurn,
   startDaprHostHttpServer
-} from "./chunk-R47X4FG2.js";
+} from "./chunk-O7H3XGY2.js";
+import {
+  DaprServiceInvoker,
+  createDaprAppDispatchExecutor,
+  createDaprCompositeDispatchExecutor,
+  createDaprDispatchRuntime,
+  createDaprWorkflowDispatchExecutor,
+  createRemoteAgentDispatchTarget,
+  createWorkflowDispatchTarget,
+  invokeRemoteAgentRun
+} from "./chunk-YQQTUE6B.js";
 import {
   DaprExecutionObserver,
   DaprExecutionStore,
@@ -21,45 +54,82 @@ import {
   createDaprLoggingObserver,
   createOtelObserver,
   createWorkflowObserverBridge
-} from "./chunk-2CEICSJH.js";
+} from "./chunk-5CJIC4YB.js";
 import {
   DaprWorkflowClient,
+  createDaprAgentTurnApprovalCheckActivity,
+  createDaprAgentTurnHumanInputCheckActivity,
   createDaprAgentTurnModelStepActivity,
   createDaprAgentTurnOutputCommitActivity,
+  createDaprAgentTurnSteerDrainActivity,
   createDaprAgentTurnStepCommitActivity,
   createDaprAgentTurnToolCallActivity,
   createDaprAgentTurnWorkflowDefinition,
   createDaprAgentTurnWorkflowKit,
   hasStartedDaprWorkflow,
   isTerminalDaprWorkflowStatus
-} from "./chunk-DILON56B.js";
-import "./chunk-A34CHK2E.js";
+} from "./chunk-YS2CWYBQ.js";
+import "./chunk-MQJ4LZOX.js";
 export {
+  DAPR_SUBAGENT_BACKEND,
   DaprExecutionObserver,
   DaprExecutionStore,
+  DaprMailboxStore,
   DaprOrchestratorRunStore,
   DaprRuntimeDriver,
   DaprServiceInvoker,
+  DaprTaskBoardStore,
   DaprWorkflowClient,
+  configureDaprSubAgents,
+  createApplyCoordinatorActionsActivity,
+  createCheckTrackedTasksTerminalActivity,
+  createCollectWorkerReportsActivity,
+  createCommitExternalTaskActivity,
+  createCoordinatorReasonActivity,
+  createCoordinatorWorkflowDefinition,
   createDaprAgentRunner,
   createDaprAgentRuntime,
+  createDaprAgentServerAdapter,
+  createDaprAgentTurnApprovalCheckActivity,
+  createDaprAgentTurnHumanInputCheckActivity,
   createDaprAgentTurnModelStepActivity,
   createDaprAgentTurnOutputCommitActivity,
+  createDaprAgentTurnSteerDrainActivity,
   createDaprAgentTurnStepCommitActivity,
   createDaprAgentTurnToolCallActivity,
   createDaprAgentTurnWorkflowDefinition,
   createDaprAgentTurnWorkflowKit,
   createDaprAgentWorkflowHost,
+  createDaprAppDispatchExecutor,
+  createDaprCompositeDispatchExecutor,
+  createDaprDispatchRuntime,
   createDaprExecutionObserver,
   createDaprHostHttpHandler,
   createDaprHttpJobHandler,
   createDaprLoggingObserver,
   createDaprMultiAgentRunner,
+  createDaprPubSubEventBridge,
+  createDaprSubAgentTools,
+  createDaprSubAgentWorkflowSupport,
+  createDaprTeamHttpHandler,
+  createDaprTeamRunner,
+  createDaprWorkflowApprovalRuntime,
+  createDaprWorkflowDispatchExecutor,
+  createDaprWorkflowFollowUpRuntime,
+  createDaprWorkflowHumanInputRuntime,
+  createDaprWorkflowSteerRuntime,
   createDaprWorkflowWorker,
   createDaprWorkloadRuntime,
+  createEventBus,
   createOtelObserver,
+  createPrepareExternalTasksActivity,
+  createRemoteAgentDispatchTarget,
+  createRemoteAgentTool,
+  createWorkflowDispatchTarget,
   createWorkflowObserverBridge,
+  getConfiguredDaprSubAgents,
   hasStartedDaprWorkflow,
+  installDaprSubAgents,
   invokeRemoteAgentRun,
   isTerminalDaprWorkflowStatus,
   startDaprAgentWorkflowTurn,

package/dist/invoker-B6ikdYaz.d.ts

@@ -0,0 +1,50 @@
+import { AgentTaskPayload, AgentTaskResult } from '@cuylabs/agent-core';
+
+interface DaprServiceInvokerOptions {
+    /** Dapr sidecar HTTP endpoint. Defaults to http://127.0.0.1:3500. */
+    daprHttpEndpoint?: string;
+    /** Optional Dapr API token sent as the dapr-api-token header. */
+    apiToken?: string;
+    /** Default request timeout in milliseconds. Defaults to 15000. */
+    requestTimeoutMs?: number;
+    /** Override fetch implementation for tests/custom runtimes. */
+    fetch?: typeof fetch;
+}
+interface DaprInvokeMethodOptions<TBody = unknown> {
+    /** HTTP method for invocation. Defaults to POST when body exists, otherwise GET. */
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    /** Request body. Objects are serialized as JSON. */
+    body?: TBody;
+    /** Additional HTTP headers. */
+    headers?: Record<string, string>;
+    /** Query-string parameters appended to method URL. */
+    query?: Record<string, string | number | boolean | undefined>;
+    /** Per-request timeout override in milliseconds. */
+    timeoutMs?: number;
+}
+interface DaprInvokeMethodResult<TResponse = unknown> {
+    status: number;
+    data: TResponse | undefined;
+    headers: Headers;
+}
+/** Default request contract for invoking a remote agent over service invocation. */
+type RemoteAgentRunRequest = AgentTaskPayload;
+/** Default response contract for remote agent execution. */
+type RemoteAgentRunResponse = AgentTaskResult;
+
+declare class DaprServiceInvoker {
+    private readonly daprHttpEndpoint;
+    private readonly apiToken?;
+    private readonly requestTimeoutMs;
+    private readonly fetchImpl;
+    constructor(options?: DaprServiceInvokerOptions);
+    invokeMethod<TResponse = unknown, TBody = unknown>(appId: string, methodPath: string, options?: DaprInvokeMethodOptions<TBody>): Promise<DaprInvokeMethodResult<TResponse>>;
+}
+/**
+ * Invoke a remote agent endpoint using the default run contract.
+ *
+ * Default route: `POST /agents/run`.
+ */
+declare function invokeRemoteAgentRun(invoker: DaprServiceInvoker, appId: string, request: RemoteAgentRunRequest, methodPath?: string): Promise<RemoteAgentRunResponse>;
+
+export { type DaprInvokeMethodOptions as D, type RemoteAgentRunRequest as R, type DaprInvokeMethodResult as a, DaprServiceInvoker as b, type DaprServiceInvokerOptions as c, type RemoteAgentRunResponse as d, invokeRemoteAgentRun as i };

package/dist/{store-pRLGfYhN.d.ts → store-BXBIDz40.d.ts}

@@ -1,5 +1,6 @@
-import { AgentTaskPayload, AgentTaskCheckpointReason, AgentTaskExecutionSnapshot, AgentTurnState, AgentTaskResult, AgentTaskExecutionRun, AgentTaskExecutionCheckpoint } from '@cuylabs/agent-core';
-import { a as DaprExecutionStoreOptions } from './workflow-bridge-C8Z1yr0Y.js';
+import { AgentTaskPayload, AgentTaskResumeSnapshot, AgentTaskCheckpointReason, AgentTaskExecutionSnapshot, AgentTurnState, AgentTaskResult, AgentTaskExecutionRun, AgentTaskExecutionCheckpoint } from '@cuylabs/agent-core';
+import { ExecutionStore, ExecutionRunRecord, ExecutionListOptions, ExecutionCheckpointRecord } from '@cuylabs/agent-runtime';
+import { D as DaprExecutionStoreOptions } from './workflow-bridge-BcicHH1Y.js';
 
 interface DaprExecutionCleanupOptions {
     maxAgeMs?: number;
@@ -65,10 +66,25 @@ interface DaprExecutionCheckpointRecord<TPayload extends AgentTaskPayload = Agen
     event?: unknown;
     createdAt: string;
 }
-declare class DaprExecutionStore<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+declare class DaprExecutionStore<TPayload extends AgentTaskPayload = AgentTaskPayload> implements ExecutionStore {
     private readonly client;
     private readonly keyPrefix;
     constructor(options: DaprExecutionStoreOptions);
+    get(sessionId: string): Promise<ExecutionRunRecord | undefined>;
+    list(options?: ExecutionListOptions): Promise<ExecutionRunRecord[]>;
+    listGenericCheckpoints(sessionId: string): Promise<ExecutionCheckpointRecord[]>;
+    remove(sessionId: string): Promise<boolean>;
+    /**
+     * Build a resume snapshot from a persisted execution record.
+     *
+     * Returns `undefined` if no execution exists for the session or the
+     * execution is already in a terminal state (completed/failed).
+     *
+     * The returned snapshot can be passed as `context.restoreFrom` to
+     * `createAgentTaskRunner(...)` to resume the direct-path execution
+     * from where it left off.
+     */
+    buildResumeSnapshot(sessionId: string): Promise<AgentTaskResumeSnapshot | undefined>;
     getExecution(sessionId: string): Promise<DaprExecutionRunRecord<TPayload> | undefined>;
     listExecutions(): Promise<DaprExecutionRunRecord<TPayload>[]>;
     listCheckpoints(sessionId: string): Promise<DaprExecutionCheckpointRecord<TPayload>[]>;
@@ -89,6 +105,11 @@ declare class DaprExecutionStore<TPayload extends AgentTaskPayload = AgentTaskPa
     private addCheckpointToIndex;
     private listCheckpointsFromIndex;
     private writeExecution;
+    /**
+     * Read-modify-write the execution record with optimistic concurrency.
+     * Retries on etag conflict up to 4 times.
+     */
+    private updateExecution;
     private writeCheckpoint;
     private decodeExecution;
     private decodeCheckpoint;