@linnlabs/linnkit 0.8.0

package/dist/index-CJeWHopy.d.ts

@@ -0,0 +1,584 @@
+import * as zod from 'zod';
+import { A as AnyAgentEvent } from './agentEvents-DEB7Fy_J.js';
+import { e as RuntimeEvent } from './todo-B1PmDlp3.js';
+import { A as AiMessage } from './messages-XthmnHZ3.js';
+import { a as ToolPresentationPort } from './ports-DnLuKfpE.js';
+import { a as SSEEvent } from './sse-vPyrOPa0.js';
+
+interface EventMappingContext {
+    conversationId: string;
+    turnId: string;
+    timestamp?: number;
+    /**
+     * 事件级扩展元数据（透传到 SSE/RuntimeEvent.metadata）。
+     *
+     * 中文备注：这里只放跨事件归类信息，不放 ui.hidden 这类单事件展示语义。
+     */
+    metadata?: Record<string, unknown>;
+}
+interface SSEMappingOptions {
+    emitSse?: boolean;
+    skipAlreadyDispatched?: boolean;
+    toolPresentationPort?: ToolPresentationPort;
+}
+interface RuntimeMappingOptions {
+    collectRuntime?: boolean;
+    skipIncomplete?: boolean;
+    toolPresentationPort?: ToolPresentationPort;
+}
+/**
+ * RuntimeEvent 回放所需的最小会话内存端口。
+ *
+ * 中文备注：
+ * - core 只依赖“写入消息”的最小能力；
+ * - 具体产品实现只要结构兼容即可接入。
+ */
+interface ConversationMemoryPort {
+    addUserMessage(content: string, id?: string): void;
+    addAssistantMessage(content: string | null, type: AiMessage['type'] & ('thought' | 'final_answer' | 'tool_calls'), metadata?: AiMessage['metadata'], id?: string): void;
+    addToolResponse(toolCallId: string, content: string, toolName?: string, id?: string): void;
+    appendMessage(message: AiMessage): void;
+}
+
+declare function agentEventToRuntime(agentEvent: AnyAgentEvent | RuntimeEvent, context: EventMappingContext, options?: RuntimeMappingOptions): RuntimeEvent | null;
+
+declare function applyRuntimeEventToMemory(event: RuntimeEvent, memory: ConversationMemoryPort): void;
+
+declare function agentEventToSSE(agentEvent: AnyAgentEvent, context: EventMappingContext, options?: SSEMappingOptions): SSEEvent | null;
+
+/**
+ * 统一的事件映射器。
+ *
+ * 中文备注：
+ * - 保持旧调用方式 `eventMapper.xxx` 不变；
+ * - 新逻辑不要继续写回本文件，按职责放到拆分后的模块。
+ */
+declare const eventMapper: {
+    /**
+     * 将 AgentEvent 转换为 SSEEvent。
+     */
+    agentToSse: typeof agentEventToSSE;
+    /**
+     * 将 AgentEvent 转换为 RuntimeEvent。
+     */
+    agentToRuntime: typeof agentEventToRuntime;
+    /**
+     * 将 RuntimeEvent 应用到 ConversationMemoryPort。
+     */
+    applyToMemory: typeof applyRuntimeEventToMemory;
+    /**
+     * 批量处理 AgentEvent → SSEEvent + RuntimeEvent。
+     */
+    agentToBoth: (agentEvent: AnyAgentEvent, context: EventMappingContext, options?: {
+        sseOptions?: SSEMappingOptions;
+        runtimeOptions?: RuntimeMappingOptions;
+    }) => {
+        sseEvent: {
+            type: "thought";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            is_complete: boolean;
+            content?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            thought_message_id?: string | undefined;
+            delta?: string | undefined;
+        } | {
+            type: "final_answer_chunk";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            answer_id: string;
+            seq: number;
+            chunk: string;
+            metadata?: Record<string, unknown> | undefined;
+            is_last?: boolean | undefined;
+        } | {
+            type: "final_answer";
+            id: string;
+            content: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            answer_id: string;
+            metadata?: Record<string, unknown> | undefined;
+            meta?: Record<string, any> | undefined;
+        } | {
+            type: "markdown_chunk";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            text: string;
+            content_type: "code" | "image" | "text" | "table";
+            metadata?: Record<string, unknown> | undefined;
+            seq?: number | undefined;
+        } | {
+            type: "tool_call_decision";
+            status: "error" | "loading" | "success";
+            id: string;
+            tool_name: string;
+            tool_call_id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            phase: "start" | "update" | "complete" | "error";
+            args?: any;
+            metadata?: Record<string, unknown> | undefined;
+            payload?: any;
+            meta?: Record<string, any> | undefined;
+        } | {
+            type: "tool_process";
+            status: "error" | "loading" | "success";
+            id: string;
+            tool_name: string;
+            tool_call_id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            phase: "start" | "update" | "complete" | "error";
+            args?: any;
+            metadata?: Record<string, unknown> | undefined;
+            payload?: any;
+            meta?: Record<string, any> | undefined;
+        } | {
+            type: "tool_output";
+            status: "error" | "success";
+            id: string;
+            tool_name: string;
+            tool_call_id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            metadata?: Record<string, unknown> | undefined;
+            payload?: Record<string, any> | undefined;
+            output?: any;
+            duration_ms?: number | undefined;
+        } | {
+            type: "todo_updated";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            todo_list_id: string;
+            todo_list_version: number;
+            items: {
+                status: "in_progress" | "completed" | "cancelled" | "pending";
+                id: string;
+                content: string;
+            }[];
+            metadata?: Record<string, unknown> | undefined;
+        } | {
+            type: "subrun_trace";
+            id: string;
+            timestamp: number;
+            kind: "final_answer" | "tool_output" | "tool_call_decision" | "tool_process" | "thought_delta" | "thought_complete" | "final_answer_chunk";
+            conversation_id: string;
+            turn_id: string;
+            parent_tool_call_id: string;
+            subrun_id: string;
+            status?: "error" | "loading" | "success" | undefined;
+            tool_name?: string | undefined;
+            args?: unknown;
+            tool_call_id?: string | undefined;
+            content?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            delta?: string | undefined;
+            phase?: "start" | "update" | "complete" | "error" | undefined;
+            meta?: Record<string, unknown> | undefined;
+            output?: unknown;
+            duration_ms?: number | undefined;
+            subrun_parent_id?: string | undefined;
+        } | {
+            type: "requires_user_interaction";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            metadata?: Record<string, unknown> | undefined;
+            form?: any;
+            interaction_type?: string | undefined;
+            prompt?: string | undefined;
+        } | {
+            type: "error";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            error: string;
+            metadata?: Record<string, unknown> | undefined;
+            details?: any;
+            error_code?: string | undefined;
+            retryable?: boolean | undefined;
+        } | {
+            type: "stream_end";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            metadata?: Record<string, unknown> | undefined;
+            reason?: "complete" | "error" | "interrupted" | "timeout" | undefined;
+            reason_message?: string | undefined;
+            stats?: {
+                duration_ms?: number | undefined;
+                total_events?: number | undefined;
+                error_count?: number | undefined;
+                benchmark?: Record<string, unknown> | undefined;
+            } | undefined;
+        } | {
+            type: "history_summary";
+            id: string;
+            content: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            summary_seq: number;
+            original_message_count: number;
+            summary_id: string;
+            metadata?: Record<string, unknown> | undefined;
+        } | {
+            type: "summarization_start";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            metadata?: Record<string, unknown> | undefined;
+            originalMessages?: number | undefined;
+        } | {
+            type: "summarization_end";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            compressionRatio?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            originalMessages?: number | undefined;
+            compressedMessages?: number | undefined;
+            timeSaved?: string | undefined;
+        } | {
+            type: "summarization_error";
+            id: string;
+            timestamp: number;
+            conversation_id: string;
+            turn_id: string;
+            error: string;
+            metadata?: Record<string, unknown> | undefined;
+        } | null;
+        runtimeEvent: {
+            type: "user_input";
+            id: string;
+            content: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            source: "system" | "user" | "editor";
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            raw_content?: string | undefined;
+        } | {
+            type: "thought";
+            id: string;
+            content: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            is_complete: boolean;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            thought_message_id?: string | undefined;
+            delta?: string | undefined;
+        } | {
+            type: "tool_call_decision";
+            status: "error" | "loading" | "success";
+            id: string;
+            tool_name: string;
+            tool_call_id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            phase: "start" | "update" | "complete" | "error";
+            args?: Record<string, any> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            payload?: zod.objectOutputType<{
+                args: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodAny>>;
+                tool_calls: zod.ZodOptional<zod.ZodArray<zod.ZodUnknown, "many">>;
+                reasoning_details: zod.ZodOptional<zod.ZodArray<zod.ZodUnknown, "many">>;
+            }, zod.ZodTypeAny, "passthrough"> | undefined;
+            parent_tool_call_id?: string | undefined;
+            meta?: Record<string, any> | undefined;
+        } | {
+            type: "tool_process";
+            status: "error" | "loading" | "success";
+            id: string;
+            tool_name: string;
+            tool_call_id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            phase: "start" | "update" | "complete" | "error";
+            args?: Record<string, any> | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            payload?: Record<string, any> | undefined;
+            parent_tool_call_id?: string | undefined;
+            meta?: Record<string, any> | undefined;
+        } | {
+            type: "tool_output";
+            status: "error" | "success";
+            id: string;
+            tool_name: string;
+            tool_call_id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            error?: string | undefined;
+            payload?: Record<string, any> | undefined;
+            output?: any;
+            duration_ms?: number | undefined;
+        } | {
+            type: "todo_updated";
+            id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            todo_list_id: string;
+            todo_list_version: number;
+            items: {
+                status: "in_progress" | "completed" | "cancelled" | "pending";
+                id: string;
+                content: string;
+            }[];
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+        } | {
+            type: "subrun_trace";
+            id: string;
+            timestamp: number;
+            kind: "final_answer" | "tool_output" | "tool_call_decision" | "tool_process" | "thought_delta" | "thought_complete" | "final_answer_chunk";
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            parent_tool_call_id: string;
+            subrun_id: string;
+            status?: "error" | "loading" | "success" | undefined;
+            tool_name?: string | undefined;
+            args?: unknown;
+            tool_call_id?: string | undefined;
+            content?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            delta?: string | undefined;
+            phase?: "start" | "update" | "complete" | "error" | undefined;
+            meta?: Record<string, unknown> | undefined;
+            output?: unknown;
+            duration_ms?: number | undefined;
+            subrun_parent_id?: string | undefined;
+        } | {
+            type: "requires_user_interaction";
+            id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            form?: any;
+            interaction_type?: string | undefined;
+            prompt?: string | undefined;
+        } | {
+            type: "audit_envelope";
+            id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            envelope: {
+                runId: string;
+                envelopeId: string;
+                ts: number;
+                actor: {
+                    kind: "system" | "user" | "tool" | "agent" | "host" | "model";
+                    id?: string | undefined;
+                    name?: string | undefined;
+                };
+                action: string;
+                parentRunId?: string | undefined;
+                decision?: {
+                    outcome: "requested" | "allowed" | "denied" | "fallback" | "retry" | "cancelled" | "paused" | "resumed" | "recorded";
+                    metadata?: Record<string, unknown> | undefined;
+                    reason?: string | undefined;
+                    policy?: string | undefined;
+                } | undefined;
+                evidence?: {
+                    kind: string;
+                    summary?: string | undefined;
+                    metadata?: Record<string, unknown> | undefined;
+                    ref?: string | undefined;
+                }[] | undefined;
+                costDelta?: {
+                    tokensInput?: number | undefined;
+                    tokensOutput?: number | undefined;
+                    totalCostUsd?: number | undefined;
+                    latencyMs?: number | undefined;
+                } | undefined;
+                scope?: {
+                    metadata?: Record<string, unknown> | undefined;
+                    toolName?: string | undefined;
+                    conversationId?: string | undefined;
+                    runId?: string | undefined;
+                    parentRunId?: string | undefined;
+                    turnId?: string | undefined;
+                    traceId?: string | undefined;
+                    agentSpecId?: string | undefined;
+                    toolCallId?: string | undefined;
+                    modelId?: string | undefined;
+                    nodeId?: string | undefined;
+                } | undefined;
+            };
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+        } | {
+            type: "final_answer";
+            id: string;
+            content: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            is_complete: boolean;
+            answer_id: string;
+            reasoning_details?: unknown[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            meta?: Record<string, any> | undefined;
+        } | {
+            type: "final_answer_chunk";
+            id: string;
+            content: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            answer_id: string;
+            seq: number;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            is_last?: boolean | undefined;
+        } | {
+            type: "history_summary";
+            id: string;
+            content: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            replaced_message_ids: string[];
+            summary_seq: number;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            original_message_count?: number | undefined;
+            compression_ratio?: number | undefined;
+            included_old_summary?: boolean | undefined;
+        } | {
+            type: "error";
+            id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            error: string;
+            metadata?: Record<string, unknown> | undefined;
+            ephemeral?: boolean | undefined;
+            details?: any;
+            error_code?: string | undefined;
+            retryable?: boolean | undefined;
+        } | {
+            type: "control";
+            id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            op: "truncate_after" | "replace" | "redo" | "branch";
+            metadata?: Record<string, unknown> | undefined;
+            reason?: string | undefined;
+            ephemeral?: boolean | undefined;
+            meta?: any;
+            target_id?: string | undefined;
+        } | {
+            type: "stream_end";
+            id: string;
+            timestamp: number;
+            version: 1;
+            conversation_id: string;
+            turn_id: string;
+            metadata?: Record<string, unknown> | undefined;
+            reason?: "complete" | "error" | "interrupted" | "timeout" | undefined;
+            ephemeral?: boolean | undefined;
+            reason_message?: string | undefined;
+            stats?: {
+                duration_ms?: number | undefined;
+                total_events?: number | undefined;
+                error_count?: number | undefined;
+            } | undefined;
+        } | null;
+    };
+    /**
+     * 批量重建内存。
+     */
+    rebuildMemory: (events: RuntimeEvent[], memory: ConversationMemoryPort) => void;
+};
+
+type RuntimeEventUiProjectionKind = 'hidden' | 'user_input' | 'thought' | 'final_answer' | 'final_answer_chunk' | 'tool_call_decision' | 'tool_process' | 'tool_output' | 'requires_user_interaction' | 'audit_envelope' | 'todo_updated' | 'subrun_trace' | 'error' | 'stream_end' | 'history_summary' | 'checkpoint_history_summary' | 'unsupported';
+type RuntimeEventRealtimeChannel = 'event_bus_sse' | 'none';
+interface RuntimeEventLifecycleDecision {
+    uiProjectionKind: RuntimeEventUiProjectionKind;
+    persist: boolean;
+    replayToUi: boolean;
+    enterAgentContext: boolean;
+    realtimeChannel: RuntimeEventRealtimeChannel;
+}
+declare function isToolCallDecisionEvent<T extends {
+    type: string;
+}>(event: T): event is T & {
+    type: 'tool_call_decision';
+};
+declare function shouldPersistRuntimeEvent(event: RuntimeEvent): boolean;
+declare function shouldReplayRuntimeEventToUi(event: RuntimeEvent): boolean;
+declare function shouldEnterAgentContext(event: RuntimeEvent): boolean;
+declare function isCheckpointHistorySummaryEvent(event: RuntimeEvent): event is Extract<RuntimeEvent, {
+    type: 'history_summary';
+}>;
+declare function getRuntimeEventUiProjectionKind(event: RuntimeEvent): RuntimeEventUiProjectionKind;
+declare function describeRuntimeEventLifecycle(event: RuntimeEvent): RuntimeEventLifecycleDecision;
+declare function shouldEmitRuntimeEventToSse(event: RuntimeEvent): boolean;
+
+declare const index_AnyAgentEvent: typeof AnyAgentEvent;
+type index_ConversationMemoryPort = ConversationMemoryPort;
+type index_EventMappingContext = EventMappingContext;
+type index_RuntimeEventLifecycleDecision = RuntimeEventLifecycleDecision;
+declare const index_describeRuntimeEventLifecycle: typeof describeRuntimeEventLifecycle;
+declare const index_eventMapper: typeof eventMapper;
+declare const index_getRuntimeEventUiProjectionKind: typeof getRuntimeEventUiProjectionKind;
+declare const index_isCheckpointHistorySummaryEvent: typeof isCheckpointHistorySummaryEvent;
+declare const index_isToolCallDecisionEvent: typeof isToolCallDecisionEvent;
+declare const index_shouldEmitRuntimeEventToSse: typeof shouldEmitRuntimeEventToSse;
+declare const index_shouldEnterAgentContext: typeof shouldEnterAgentContext;
+declare const index_shouldPersistRuntimeEvent: typeof shouldPersistRuntimeEvent;
+declare const index_shouldReplayRuntimeEventToUi: typeof shouldReplayRuntimeEventToUi;
+declare namespace index {
+  export { index_AnyAgentEvent as AnyAgentEvent, type index_ConversationMemoryPort as ConversationMemoryPort, type index_EventMappingContext as EventMappingContext, type index_RuntimeEventLifecycleDecision as RuntimeEventLifecycleDecision, index_describeRuntimeEventLifecycle as describeRuntimeEventLifecycle, index_eventMapper as eventMapper, index_getRuntimeEventUiProjectionKind as getRuntimeEventUiProjectionKind, index_isCheckpointHistorySummaryEvent as isCheckpointHistorySummaryEvent, index_isToolCallDecisionEvent as isToolCallDecisionEvent, index_shouldEmitRuntimeEventToSse as shouldEmitRuntimeEventToSse, index_shouldEnterAgentContext as shouldEnterAgentContext, index_shouldPersistRuntimeEvent as shouldPersistRuntimeEvent, index_shouldReplayRuntimeEventToUi as shouldReplayRuntimeEventToUi };
+}
+
+export { type ConversationMemoryPort as C, type EventMappingContext as E, type RuntimeEventLifecycleDecision as R, isCheckpointHistorySummaryEvent as a, isToolCallDecisionEvent as b, shouldEnterAgentContext as c, describeRuntimeEventLifecycle as d, eventMapper as e, shouldPersistRuntimeEvent as f, getRuntimeEventUiProjectionKind as g, shouldReplayRuntimeEventToUi as h, index as i, shouldEmitRuntimeEventToSse as s };