@cuylabs/agent-runtime-dapr 0.8.0 → 0.10.0

package/dist/workflow/index.d.ts

@@ -1,225 +1,4 @@
-import { d as DaprSidecarClientOptions, f as DaprWorkflowObserverBridge } from '../workflow-bridge-C8Z1yr0Y.js';
-import { AgentWorkflowModelStepPlan, AgentWorkflowModelStepResult, AgentWorkflowToolCallPlan, AgentWorkflowToolCallResult, AgentWorkflowStepCommitPlan, AgentWorkflowCommitResult, AgentWorkflowOutputCommitPlan, AgentTurnStepRuntimeConfig, Tool, convertAgentMessagesToModelMessages, PrepareModelStepOptions, ToolHost, TurnTrackerContext, MiddlewareRunner, ReasoningLevel, AgentEvent, Message, AgentWorkflowTurnState } from '@cuylabs/agent-core';
-
-type DaprWorkflowApiVersion = "v1.0" | "v1.0-beta1" | "v1.0-alpha1";
-type DaprWorkflowRuntimeStatus = "RUNNING" | "COMPLETED" | "FAILED" | "TERMINATED" | "CONTINUED_AS_NEW" | "PENDING" | "SUSPENDED" | (string & {});
-interface DaprWorkflowClientOptions extends DaprSidecarClientOptions {
-    /**
-     * Dapr workflow component name configured in the sidecar resources.
-     *
-     * Dapr requires the component name as part of the workflow HTTP route, so the
-     * client keeps it explicit rather than guessing a default.
-     */
-    workflowComponent: string;
-    /**
-     * HTTP API version for workflow endpoints. Defaults to `v1.0`.
-     */
-    workflowApiVersion?: DaprWorkflowApiVersion;
-    /**
-     * Default polling interval for wait helpers. Defaults to 1000ms.
-     */
-    workflowPollIntervalMs?: number;
-}
-interface StartDaprWorkflowOptions<TInput = unknown> {
-    /**
-     * Optional workflow instance identifier. When omitted, Dapr generates one.
-     */
-    instanceId?: string;
-    /**
-     * Optional workflow input payload. Objects are JSON serialized; strings are
-     * sent as-is to preserve exact text payloads.
-     */
-    input?: TInput;
-}
-interface RaiseDaprWorkflowEventOptions<TEventData = unknown> {
-    eventData?: TEventData;
-}
-interface WaitForDaprWorkflowOptions {
-    /**
-     * Max time to wait before returning `undefined`. Defaults to 60000ms.
-     */
-    timeoutMs?: number;
-    /**
-     * Polling interval for repeated `getWorkflow` checks. Defaults to the client
-     * default and never below 50ms.
-     */
-    pollIntervalMs?: number;
-}
-interface DaprWorkflowState {
-    instanceId: string;
-    workflowName: string;
-    createdAt?: string;
-    lastUpdatedAt?: string;
-    runtimeStatus: DaprWorkflowRuntimeStatus;
-    /**
-     * Raw string properties returned by Dapr for the orchestration instance.
-     */
-    properties: Record<string, string>;
-}
-interface DaprStartWorkflowResponse {
-    instanceId: string;
-}
-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;
-    stepCommit: string;
-    outputCommit: string;
-}
-interface DaprAgentTurnWorkflowContextLike {
-    callActivity(name: string, input: unknown): unknown;
-    setCustomStatus?(status: string): void;
-    isReplaying?(): boolean;
-}
-type DaprAgentTurnWorkflowDefinition = (context: DaprAgentTurnWorkflowContextLike, input: AgentWorkflowTurnState) => AsyncGenerator<unknown, AgentWorkflowTurnState, unknown>;
-interface DaprAgentTurnActivityRegistration<TInput, TOutput> {
-    name: string;
-    handler: (context: unknown, input: TInput) => Promise<TOutput> | TOutput;
-}
-interface DaprAgentTurnWorkflowRegistration {
-    workflowName: string;
-    activityNames: DaprAgentTurnWorkflowActivityNames;
-    workflow: DaprAgentTurnWorkflowDefinition;
-}
-interface CreateDaprAgentTurnWorkflowOptions {
-    workflowName?: string;
-    activityNames?: Partial<DaprAgentTurnWorkflowActivityNames>;
-    now?: () => string;
-}
-type CreateDaprAgentTurnWorkflowRegistrationOptions = CreateDaprAgentTurnWorkflowOptions;
-interface DaprAgentTurnModelStepActivityOptions {
-    runtime: AgentTurnStepRuntimeConfig;
-    tools: Record<string, Tool.Info>;
-    toModelMessages?: typeof convertAgentMessagesToModelMessages;
-    mcpTools?: PrepareModelStepOptions["mcpTools"] | (() => Promise<PrepareModelStepOptions["mcpTools"]>);
-    host?: ToolHost;
-    turnTracker?: TurnTrackerContext;
-    middleware?: MiddlewareRunner;
-    reasoningLevel?: ReasoningLevel;
-    createAbortSignal?: () => AbortSignal;
-    onEvent?: (event: AgentEvent) => void | Promise<void>;
-    now?: () => string;
-    /** Observer bridge for OTel trace context propagation. */
-    observerBridge?: DaprWorkflowObserverBridge;
-}
-interface DaprAgentTurnToolCallActivityOptions {
-    tools: Record<string, Tool.Info>;
-    cwd: string;
-    host?: ToolHost;
-    turnTracker?: TurnTrackerContext;
-    middleware?: MiddlewareRunner;
-    createAbortSignal?: () => AbortSignal;
-    now?: () => string;
-    /** Observer bridge for OTel trace context propagation. */
-    observerBridge?: DaprWorkflowObserverBridge;
-}
-interface DaprAgentTurnCommitActivityOptions {
-    persistMessages: (sessionId: string, messages: Message[]) => Promise<void>;
-    now?: () => string;
-}
-interface CreateDaprAgentTurnWorkflowDefinitionOptions extends CreateDaprAgentTurnWorkflowRegistrationOptions {
-    modelStep: (input: AgentWorkflowModelStepPlan) => Promise<AgentWorkflowModelStepResult> | AgentWorkflowModelStepResult;
-    toolCall: (input: AgentWorkflowToolCallPlan) => Promise<AgentWorkflowToolCallResult> | AgentWorkflowToolCallResult;
-    stepCommit: (input: AgentWorkflowStepCommitPlan) => Promise<AgentWorkflowCommitResult> | AgentWorkflowCommitResult;
-    outputCommit: (input: AgentWorkflowOutputCommitPlan) => Promise<AgentWorkflowCommitResult> | AgentWorkflowCommitResult;
-    /**
-     * Optional observer bridge. When provided, the workflow generator emits
-     * lifecycle notifications (task-start, checkpoint, complete, error) so
-     * that `AgentTaskObserver`s work on the workflow path too.
-     */
-    observerBridge?: DaprWorkflowObserverBridge;
-}
-interface CreateDaprAgentTurnWorkflowKitOptions extends CreateDaprAgentTurnWorkflowRegistrationOptions {
-    modelStepActivity: DaprAgentTurnModelStepActivityOptions;
-    toolCallActivity: DaprAgentTurnToolCallActivityOptions;
-    commitActivity: DaprAgentTurnCommitActivityOptions;
-    /** Optional observer bridge passed through to the workflow definition. */
-    observerBridge?: DaprWorkflowObserverBridge;
-}
-interface DaprAgentTurnWorkflowKit extends DaprAgentTurnWorkflowRegistration {
-    activities: {
-        modelStep: DaprAgentTurnActivityRegistration<AgentWorkflowModelStepPlan, AgentWorkflowModelStepResult>;
-        toolCall: DaprAgentTurnActivityRegistration<AgentWorkflowToolCallPlan, AgentWorkflowToolCallResult>;
-        stepCommit: DaprAgentTurnActivityRegistration<AgentWorkflowStepCommitPlan, AgentWorkflowCommitResult>;
-        outputCommit: 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;
-/**
- * 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>;
-/**
- * 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<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 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;
-
-/**
- * Thin HTTP client for Dapr workflow management APIs.
- *
- * This intentionally mirrors the rest of `agent-runtime-dapr`: direct sidecar
- * HTTP calls with retry/timeout behavior owned by `DaprSidecarClient`. The
- * higher-level runtime/workflow adapter can build on this without pulling gRPC
- * or DurableTask types into the package boundary.
- */
-declare class DaprWorkflowClient {
-    private readonly client;
-    private readonly workflowComponent;
-    private readonly workflowApiVersion;
-    private readonly workflowPollIntervalMs;
-    constructor(options: DaprWorkflowClientOptions);
-    verifySidecar(): Promise<void>;
-    startWorkflow<TInput = unknown>(workflowName: string, options?: StartDaprWorkflowOptions<TInput>): Promise<DaprStartWorkflowResponse>;
-    getWorkflow(instanceId: string): Promise<DaprWorkflowState | undefined>;
-    waitForWorkflowStart(instanceId: string, options?: WaitForDaprWorkflowOptions): Promise<DaprWorkflowState | undefined>;
-    waitForWorkflowCompletion(instanceId: string, options?: WaitForDaprWorkflowOptions): Promise<DaprWorkflowState | undefined>;
-    pauseWorkflow(instanceId: string): Promise<void>;
-    resumeWorkflow(instanceId: string): Promise<void>;
-    terminateWorkflow(instanceId: string): Promise<void>;
-    purgeWorkflow(instanceId: string): Promise<void>;
-    raiseWorkflowEvent<TEventData = unknown>(instanceId: string, eventName: string, options?: RaiseDaprWorkflowEventOptions<TEventData>): Promise<void>;
-    private controlWorkflow;
-    private waitForWorkflowState;
-}
-
-export { type CreateDaprAgentTurnWorkflowDefinitionOptions, type CreateDaprAgentTurnWorkflowKitOptions, type CreateDaprAgentTurnWorkflowOptions, type DaprAgentTurnActivityRegistration, type DaprAgentTurnCommitActivityOptions, type DaprAgentTurnModelStepActivityOptions, type DaprAgentTurnToolCallActivityOptions, type DaprAgentTurnWorkflowActivityNames, type DaprAgentTurnWorkflowContextLike, type DaprAgentTurnWorkflowDefinition, type DaprAgentTurnWorkflowKit, type DaprAgentTurnWorkflowRegistration, type DaprStartWorkflowResponse, type DaprWorkflowApiVersion, DaprWorkflowClient, type DaprWorkflowClientOptions, type DaprWorkflowRuntimeStatus, type DaprWorkflowState, type RaiseDaprWorkflowEventOptions, type StartDaprWorkflowOptions, type WaitForDaprWorkflowOptions, createDaprAgentTurnModelStepActivity, createDaprAgentTurnOutputCommitActivity, createDaprAgentTurnStepCommitActivity, createDaprAgentTurnToolCallActivity, createDaprAgentTurnWorkflowDefinition, createDaprAgentTurnWorkflowKit, hasStartedDaprWorkflow, isTerminalDaprWorkflowStatus };
+export { C as CreateDaprAgentTurnWorkflowDefinitionOptions, c as CreateDaprAgentTurnWorkflowKitOptions, d as CreateDaprAgentTurnWorkflowOptions, b as DaprAgentTurnActivityRegistration, h as DaprAgentTurnCommitActivityOptions, l as DaprAgentTurnModelStepActivityOptions, o as DaprAgentTurnToolCallActivityOptions, p as DaprAgentTurnWorkflowActivityNames, q as DaprAgentTurnWorkflowContextLike, r as DaprAgentTurnWorkflowDefinition, s as DaprAgentTurnWorkflowKit, t as DaprAgentTurnWorkflowRegistration, a as DaprAgentTurnWorkflowToolHandler, u as DaprAgentTurnWorkflowToolHandlerInput, v as DaprStartWorkflowResponse, w as DaprWorkflowApiVersion, D as DaprWorkflowClient, 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 { b as createDaprAgentTurnModelStepActivity, d as createDaprAgentTurnOutputCommitActivity, f as createDaprAgentTurnStepCommitActivity, g as createDaprAgentTurnToolCallActivity, h as createDaprAgentTurnWorkflowDefinition, i as createDaprAgentTurnWorkflowKit } from '../index-CFm5LORU.js';
+import '@cuylabs/agent-core';
+import '../workflow-bridge-BcicHH1Y.js';

package/dist/workflow/index.js

@@ -8,8 +8,8 @@ import {
   createDaprAgentTurnWorkflowKit,
   hasStartedDaprWorkflow,
   isTerminalDaprWorkflowStatus
-} from "../chunk-DILON56B.js";
-import "../chunk-A34CHK2E.js";
+} from "../chunk-YS2CWYBQ.js";
+import "../chunk-MQJ4LZOX.js";
 export {
   DaprWorkflowClient,
   createDaprAgentTurnModelStepActivity,

package/dist/{workflow-bridge-C8Z1yr0Y.d.ts → workflow-bridge-BcicHH1Y.d.ts}

@@ -43,6 +43,8 @@ interface DaprWorkflowObserverOptions<TPayload extends AgentTaskPayload = AgentT
     payload: Readonly<TPayload>;
     /** Execution trigger label (e.g. "workflow", "http"). */
     trigger?: string;
+    /** Stable execution identifier for this workflow run. */
+    executionId?: string;
 }
 /**
  * A bridge that lets existing `AgentTaskObserver`s (DaprExecutionObserver,
@@ -76,8 +78,8 @@ interface DaprWorkflowObserverBridge {
      * Used by workflow activities to wrap their execution so child spans
      * (AI SDK, tool calls) are correlated under the observer's root span.
      */
-    getOtelContext(sessionId: string): unknown;
+    getOtelContext(sessionId: string, executionId?: string): unknown;
 }
 declare function createWorkflowObserverBridge<TPayload extends AgentTaskPayload = AgentTaskPayload>(options: DaprWorkflowObserverOptions<TPayload>): DaprWorkflowObserverBridge;
 
-export { type DaprOrchestratorRunStoreOptions as D, type DaprExecutionStoreOptions as a, type DaprFetch as b, type DaprRuntimeDriverOptions as c, type DaprSidecarClientOptions as d, type DaprStateStoreClientOptions as e, type DaprWorkflowObserverBridge as f, type DaprWorkflowObserverOptions as g, createWorkflowObserverBridge as h };
+export { type DaprExecutionStoreOptions as D, type DaprOrchestratorRunStoreOptions as a, type DaprFetch as b, type DaprRuntimeDriverOptions as c, type DaprSidecarClientOptions as d, type DaprStateStoreClientOptions as e, type DaprWorkflowObserverBridge as f, type DaprWorkflowObserverOptions as g, createWorkflowObserverBridge as h };