@cuylabs/agent-runtime-dapr 0.5.0

package/dist/execution/index.d.ts

@@ -0,0 +1,126 @@
+import { h as DaprExecutionStore } from '../store-pRLGfYhN.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 } from '../store-pRLGfYhN.js';
+import { AgentTaskPayload, AgentTaskObserver, AgentTaskExecutionRun, AgentTaskExecutionSnapshot, AgentTaskExecutionCheckpoint, AgentTaskResult } from '@cuylabs/agent-core';
+export { f as DaprWorkflowObserverBridge, g as DaprWorkflowObserverOptions, h as createWorkflowObserverBridge } from '../workflow-bridge-C8Z1yr0Y.js';
+
+interface DaprExecutionObserverOptions<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+    /**
+     * Store used to persist durable execution snapshots and checkpoints.
+     *
+     * The observer itself is intentionally thin. Persistence policy lives in the
+     * store so host apps can inspect execution state independently of runtime
+     * scheduling or orchestration concerns.
+     */
+    store: DaprExecutionStore<TPayload>;
+}
+/**
+ * Dapr-backed execution observer for `createAgentTaskRunner(...)`.
+ *
+ * This adapter consumes the neutral lifecycle/checkpoint hooks exported by
+ * `@cuylabs/agent-core` and persists them into Dapr state without leaking any
+ * Dapr-specific dependency back into `agent-core`.
+ */
+declare class DaprExecutionObserver<TPayload extends AgentTaskPayload = AgentTaskPayload> implements AgentTaskObserver<TPayload> {
+    private readonly store;
+    constructor(options: DaprExecutionObserverOptions<TPayload>);
+    onTaskStart(run: AgentTaskExecutionRun<TPayload>, snapshot: AgentTaskExecutionSnapshot): Promise<void>;
+    onCheckpoint(checkpoint: AgentTaskExecutionCheckpoint<TPayload>): Promise<void>;
+    onTaskComplete(run: AgentTaskExecutionRun<TPayload>, result: AgentTaskResult, snapshot: AgentTaskExecutionSnapshot): Promise<void>;
+    onTaskError(run: AgentTaskExecutionRun<TPayload>, error: Error, snapshot: AgentTaskExecutionSnapshot): Promise<void>;
+}
+declare function createDaprExecutionObserver<TPayload extends AgentTaskPayload = AgentTaskPayload>(options: DaprExecutionObserverOptions<TPayload>): DaprExecutionObserver<TPayload>;
+
+interface DaprHostLoggerLike {
+    info(message: string): void;
+    warn?(message: string): void;
+    error?(message: string): void;
+}
+interface DaprLoggingObserverOptions {
+    /** Logger instance. Defaults to console. */
+    logger?: DaprHostLoggerLike;
+    /** Prefix for all log lines. Defaults to "[agent]". */
+    prefix?: string;
+    /**
+     * Log every streamed event (very verbose).
+     * Defaults to false — only lifecycle events are logged.
+     */
+    verbose?: boolean;
+}
+/**
+ * A lightweight observer that logs agent task lifecycle events.
+ *
+ * Wire it into `createDaprAgentRuntime({ taskRunnerOptions: { observers: [...] } })`
+ * or pass it directly.
+ */
+declare function createDaprLoggingObserver<TPayload extends AgentTaskPayload = AgentTaskPayload>(options?: DaprLoggingObserverOptions): AgentTaskObserver<TPayload>;
+
+/**
+ * OpenTelemetry Observer
+ *
+ * Creates spans for Dapr workflow activities so that the full agent
+ * execution — from workflow orchestration down to individual LLM calls
+ * — appears as a single correlated trace.
+ *
+ * Uses `@opentelemetry/api` directly (the standard approach).
+ * If no TracerProvider is registered, all spans are no-ops.
+ *
+ * Span hierarchy (direct execution — /agents/run or runner.run()):
+ * ```
+ * agent.turn                        ← this observer
+ *   └─ invoke_agent my-agent        ← otelMiddleware (via activateContext)
+ *        └─ ai.streamText           ← AI SDK
+ *        └─ execute_tool greet      ← otelMiddleware
+ * ```
+ *
+ * Span hierarchy (workflow execution — /agents/workflow):
+ * ```
+ * agent.turn                        ← this observer
+ *   └─ invoke_agent my-agent        ← otelMiddleware (via runChatStart/End)
+ *        └─ ai.streamText           ← AI SDK
+ *        └─ ai.toolCall             ← AI SDK
+ *   └─ execute_tool greet           ← otelMiddleware (via beforeToolCall)
+ *   └─ invoke_agent my-agent        ← otelMiddleware (step 2)
+ *        └─ ai.streamText           ← AI SDK
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { createDaprAgentRunner, createOtelObserver } from "@cuylabs/agent-runtime-dapr";
+ *
+ * const runner = createDaprAgentRunner({
+ *   agent,
+ *   name: "my-agent",
+ *   workflowRuntime: new WorkflowRuntime(),
+ *   observers: [createOtelObserver()],
+ * });
+ * ```
+ *
+ * Requires `@opentelemetry/api` as a peer dependency.
+ */
+
+/**
+ * Configuration for the OpenTelemetry observer.
+ */
+interface OtelObserverConfig {
+    /**
+     * Agent name — recorded as `gen_ai.agent.name` on the `agent.turn` span.
+     * Required for Phoenix/OpenInference to classify the span as AGENT kind.
+     */
+    agentName?: string;
+    /**
+     * TTL in milliseconds for orphaned spans.
+     * If `onTaskComplete`/`onTaskError` is never called, the span is
+     * auto-closed after this duration. Defaults to 5 minutes.
+     */
+    spanTimeoutMs?: number;
+}
+/**
+ * Create an OpenTelemetry observer for Dapr agent workflow execution.
+ *
+ * Emits an `agent.turn` span per agent turn with checkpoint events
+ * and `gen_ai.usage.*` token attributes. Pair with `otelMiddleware()`
+ * from agent-core for full trace correlation.
+ */
+declare function createOtelObserver(config?: OtelObserverConfig): AgentTaskObserver;
+
+export { DaprExecutionObserver, type DaprExecutionObserverOptions, DaprExecutionStore, type DaprHostLoggerLike, type DaprLoggingObserverOptions, type OtelObserverConfig, createDaprExecutionObserver, createDaprLoggingObserver, createOtelObserver };

package/dist/execution/index.js

@@ -0,0 +1,17 @@
+import {
+  DaprExecutionObserver,
+  DaprExecutionStore,
+  createDaprExecutionObserver,
+  createDaprLoggingObserver,
+  createOtelObserver,
+  createWorkflowObserverBridge
+} from "../chunk-2CEICSJH.js";
+import "../chunk-A34CHK2E.js";
+export {
+  DaprExecutionObserver,
+  DaprExecutionStore,
+  createDaprExecutionObserver,
+  createDaprLoggingObserver,
+  createOtelObserver,
+  createWorkflowObserverBridge
+};

package/dist/host/index.d.ts

@@ -0,0 +1,7 @@
+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';
+import '@cuylabs/agent-core';
+import '../store-pRLGfYhN.js';
+import '../workflow-bridge-C8Z1yr0Y.js';
+import '../workflow/index.js';
+import '@cuylabs/agent-runtime';
+import 'node:http';

package/dist/host/index.js

@@ -0,0 +1,27 @@
+import {
+  DaprServiceInvoker,
+  createDaprAgentRunner,
+  createDaprAgentRuntime,
+  createDaprAgentWorkflowHost,
+  createDaprHostHttpHandler,
+  createDaprMultiAgentRunner,
+  createDaprWorkflowWorker,
+  invokeRemoteAgentRun,
+  startDaprAgentWorkflowTurn,
+  startDaprHostHttpServer
+} from "../chunk-2FMHOZLU.js";
+import "../chunk-2CEICSJH.js";
+import "../chunk-DILON56B.js";
+import "../chunk-A34CHK2E.js";
+export {
+  DaprServiceInvoker,
+  createDaprAgentRunner,
+  createDaprAgentRuntime,
+  createDaprAgentWorkflowHost,
+  createDaprHostHttpHandler,
+  createDaprMultiAgentRunner,
+  createDaprWorkflowWorker,
+  invokeRemoteAgentRun,
+  startDaprAgentWorkflowTurn,
+  startDaprHostHttpServer
+};