@linnlabs/linnkit 0.8.0

package/dist/agentEvents-DEB7Fy_J.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @file runtime-kernel/events/agentEvents.ts
+ * @description graph 主执行链使用的最小 Agent 事件契约
+ *
+ * 中文备注：
+ * - 该文件只承载 runtime-kernel 主链路真正需要识别的事件子集；
+ * - 目标是让 `executor` / `llmNode` / `eventMappers` 不再反向依赖宿主或产品层事件定义；
+ * - host/product 层若有更丰富的事件，只要结构兼容，仍可在边界透传进来。
+ */
+interface AgentEvent {
+    type: string;
+    timestamp: number;
+    id?: string;
+    /**
+     * 中文备注：
+     * - 该标记只在运行期内存中使用，用于避免同一事件被 SSE 重复分发；
+     * - 不属于持久化协议字段。
+     */
+    __dispatched_via_sse__?: true;
+}
+interface BaseToolLifecycleAgentEvent extends AgentEvent {
+    tool_name: string;
+    tool_args: Record<string, unknown>;
+    tool_calls?: unknown[];
+    tool_call_id?: string;
+    phase?: 'start' | 'update' | 'complete' | 'error';
+    status?: 'loading' | 'success' | 'error';
+    payload?: Record<string, unknown>;
+    meta?: Record<string, unknown>;
+}
+interface ThoughtEvent extends AgentEvent {
+    type: 'thought';
+    content: string;
+    delta?: string;
+    is_complete?: boolean;
+    meta?: Record<string, unknown>;
+    thought_message_id?: string;
+}
+interface ToolCallDecisionEvent extends BaseToolLifecycleAgentEvent {
+    type: 'tool_call_decision';
+}
+interface ToolProcessEvent extends BaseToolLifecycleAgentEvent {
+    type: 'tool_process';
+}
+interface ObservationEvent extends AgentEvent {
+    type: 'observation';
+    tool_name: string;
+    tool_call_id?: string;
+    output: string;
+    success?: boolean;
+    payload?: Record<string, unknown>;
+    duration_ms?: number;
+}
+interface FinalAnswerEvent extends AgentEvent {
+    type: 'final_answer';
+    answer: string;
+    answer_id?: string;
+    answerId?: string;
+    reasoning_details?: unknown[];
+    meta?: Record<string, unknown>;
+}
+interface ErrorEvent extends AgentEvent {
+    type: 'error';
+    error: string;
+    details?: string;
+}
+interface StreamChunkEvent extends AgentEvent {
+    type: 'stream_chunk';
+    content: string;
+    answer_id?: string;
+    seq?: number;
+    is_last?: boolean;
+    isLast?: boolean;
+}
+interface ProviderSidecarEvent extends AgentEvent {
+    type: 'provider_sidecar';
+    reasoning_details?: unknown[];
+}
+type AnyAgentEvent = ThoughtEvent | ToolCallDecisionEvent | ToolProcessEvent | ObservationEvent | FinalAnswerEvent | ErrorEvent | StreamChunkEvent | ProviderSidecarEvent;
+
+export type { AnyAgentEvent as A };