@gt-fe/eap-runtime 0.0.8

package/dist/sse/events/code-events.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 代码执行事件 Payload 定义
+ *
+ * 可选事件：
+ * - code.executed
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** 代码执行 */
+export interface CodeExecutedPayload {
+    /** 编程语言 */
+    language: string;
+    /** 执行状态 */
+    status: 'success' | 'error' | 'timeout';
+    /** 执行输出内容 */
+    output: string;
+    /** 退出码 */
+    exitCode: number;
+}

package/dist/sse/events/code-events.js

@@ -0,0 +1,9 @@
+/**
+ * 代码执行事件 Payload 定义
+ *
+ * 可选事件：
+ * - code.executed
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/collaboration-events.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 协作事件 Payload 定义
+ *
+ * 可选事件：
+ * - collaboration.handed_off
+ * - collaboration.subtask.started
+ * - collaboration.subtask.completed
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** Agent 间任务移交 */
+export interface CollaborationHandedOffPayload {
+    /** 移交发起方 Agent */
+    fromAgent: string;
+    /** 移交接收方 Agent */
+    toAgent: string;
+    /** 移交原因 */
+    reason: string;
+}
+/** 子任务开始 */
+export interface CollaborationSubtaskStartedPayload {
+    /** 子任务 ID */
+    subtaskId: string;
+    /** 目标执行 Agent */
+    targetAgent: string;
+    /** 子任务输入 */
+    input: string;
+}
+/** 子任务完成 */
+export interface CollaborationSubtaskCompletedPayload {
+    /** 子任务 ID */
+    subtaskId: string;
+    /** 执行 Agent */
+    targetAgent: string;
+    /** 子任务执行结果 */
+    result: string;
+}

package/dist/sse/events/collaboration-events.js

@@ -0,0 +1,11 @@
+/**
+ * 协作事件 Payload 定义
+ *
+ * 可选事件：
+ * - collaboration.handed_off
+ * - collaboration.subtask.started
+ * - collaboration.subtask.completed
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/connection-events.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 连接事件 Payload 定义
+ *
+ * 核心事件：
+ * - connection.heartbeat
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** 心跳保活 */
+export interface ConnectionHeartbeatPayload {
+    /** 心跳时间戳 (ISO 8601) */
+    timestamp: string;
+}

package/dist/sse/events/connection-events.js

@@ -0,0 +1,9 @@
+/**
+ * 连接事件 Payload 定义
+ *
+ * 核心事件：
+ * - connection.heartbeat
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/file-events.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 文件操作事件 Payload 定义
+ *
+ * 可选事件：
+ * - file.created
+ * - file.updated
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** 文件创建 */
+export interface FileCreatedPayload {
+    /** 文件名 */
+    fileName: string;
+    /** 文件类型（如 pdf, csv, json） */
+    fileType: string;
+    /** 文件大小（字节） */
+    size: number;
+    /** 文件下载/访问 URL */
+    url: string;
+}
+/** 文件更新 */
+export interface FileUpdatedPayload {
+    /** 文件名 */
+    fileName: string;
+    /** 变更 diff 内容 */
+    diff: string;
+    /** 文件访问 URL */
+    url: string;
+}

package/dist/sse/events/file-events.js

@@ -0,0 +1,10 @@
+/**
+ * 文件操作事件 Payload 定义
+ *
+ * 可选事件：
+ * - file.created
+ * - file.updated
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/hitl-events.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 人工介入事件 Payload 定义
+ *
+ * 核心事件：
+ * - hitl.waited
+ * - hitl.resumed
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** 等待人工确认 */
+export interface HitlWaitedPayload {
+    /** 确认问题 */
+    question: string;
+    /** 可选的选项列表 */
+    options: string[];
+    /** 超时时间（秒） */
+    timeout: number;
+    /** Checkpoint thread；Hosting resume 应回传 */
+    threadId?: string;
+    /**
+     * 若本等待由确认类 Tool 打断：与已发出的 `tool.called` 同一 id。
+     * 此时不要用 `tool.result` 收 span，等 resume 后再等同 id 的 result/error。
+     */
+    toolCallId?: string;
+    toolName?: string;
+}
+/** 人工确认后继续 */
+export interface HitlResumedPayload {
+    /** 用户选择 */
+    choice: string;
+    /** 操作用户 ID */
+    userId: string;
+}

package/dist/sse/events/hitl-events.js

@@ -0,0 +1,10 @@
+/**
+ * 人工介入事件 Payload 定义
+ *
+ * 核心事件：
+ * - hitl.waited
+ * - hitl.resumed
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * SSE 事件 Payload 类型 — 统一导出
+ *
+ * 定义 SSE 事件的 Payload 接口和 SSEEventType 联合类型。
+ *
+ * 命名规范：
+ * - 格式：{domain}.{action}
+ * - 分隔符：点号（.）
+ * - 大小写：全小写
+ * - 时态：过去式（started/completed）或名词（final/heartbeat）
+ *
+ * 分层设计：
+ * - 核心事件（14 种）：所有 Agent 必须支持
+ * - 可选事件：Agent 按需支持
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ * @see eap-contracts/src/events/sse-events.ts
+ */
+export * from './session-events.js';
+export * from './skill-events.js';
+export * from './reasoning-events.js';
+export * from './tool-events.js';
+export * from './file-events.js';
+export * from './code-events.js';
+export * from './collaboration-events.js';
+export * from './hitl-events.js';
+export * from './plan-events.js';
+export * from './response-events.js';
+export * from './stats-events.js';
+export * from './connection-events.js';
+/**
+ * 事件层级
+ */
+export type SseEventLevel = 'core' | 'optional';
+/**
+ * 核心事件类型（所有 Agent 必须支持）
+ */
+export declare const CORE_SSE_EVENTS: readonly ["session.created", "task.started", "task.completed", "task.error", "reasoning.started", "response.chunk", "tool.called", "tool.result", "tool.error", "hitl.waited", "hitl.resumed", "response.final", "stats.token_usage", "connection.heartbeat"];
+/**
+ * 可选事件类型（Agent 按需支持）
+ */
+export declare const OPTIONAL_SSE_EVENTS: readonly ["skill.matched", "skill.unmatched", "skill.started", "skill.completed", "skill.failed", "reasoning.step", "tool.progress", "file.created", "file.updated", "code.executed", "collaboration.handed_off", "collaboration.subtask.started", "collaboration.subtask.completed", "plan.created", "plan.step.started", "plan.step.completed", "response.max_iterations_reached", "stats.node_token_usage"];
+/**
+ * SSEEventType — SSE 事件类型字符串联合类型
+ */
+export type SSEEventType = 'session.created' | 'task.started' | 'task.completed' | 'task.error' | 'reasoning.started' | 'response.chunk' | 'tool.called' | 'tool.result' | 'tool.error' | 'hitl.waited' | 'hitl.resumed' | 'response.final' | 'stats.token_usage' | 'connection.heartbeat' | 'skill.matched' | 'skill.unmatched' | 'skill.started' | 'skill.completed' | 'skill.failed' | 'reasoning.step' | 'tool.progress' | 'file.created' | 'file.updated' | 'code.executed' | 'collaboration.handed_off' | 'collaboration.subtask.started' | 'collaboration.subtask.completed' | 'plan.created' | 'plan.step.started' | 'plan.step.completed' | 'response.max_iterations_reached' | 'stats.node_token_usage';
+import type { SessionCreatedPayload, TaskStartedPayload, TaskCompletedPayload, TaskErrorPayload } from './session-events.js';
+import type { SkillMatchedPayload, SkillUnmatchedPayload, SkillStartedPayload, SkillCompletedPayload, SkillFailedPayload } from './skill-events.js';
+import type { ReasoningStartedPayload, ReasoningStepPayload, ResponseChunkPayload } from './reasoning-events.js';
+import type { ToolCalledPayload, ToolResultPayload, ToolProgressPayload, ToolErrorPayload } from './tool-events.js';
+import type { FileCreatedPayload, FileUpdatedPayload } from './file-events.js';
+import type { CodeExecutedPayload } from './code-events.js';
+import type { CollaborationHandedOffPayload, CollaborationSubtaskStartedPayload, CollaborationSubtaskCompletedPayload } from './collaboration-events.js';
+import type { HitlWaitedPayload, HitlResumedPayload } from './hitl-events.js';
+import type { PlanCreatedPayload, PlanStepStartedPayload, PlanStepCompletedPayload } from './plan-events.js';
+import type { ResponseFinalPayload, ResponseMaxIterationsReachedPayload } from './response-events.js';
+import type { StatsTokenUsagePayload, StatsNodeTokenUsagePayload } from './stats-events.js';
+import type { ConnectionHeartbeatPayload } from './connection-events.js';
+/**
+ * SSEEventPayloadMap — 事件类型名称到 Payload 类型的完整映射
+ */
+export interface SSEEventPayloadMap {
+    'session.created': SessionCreatedPayload;
+    'task.started': TaskStartedPayload;
+    'task.completed': TaskCompletedPayload;
+    'task.error': TaskErrorPayload;
+    'reasoning.started': ReasoningStartedPayload;
+    'response.chunk': ResponseChunkPayload;
+    'tool.called': ToolCalledPayload;
+    'tool.result': ToolResultPayload;
+    'tool.error': ToolErrorPayload;
+    'hitl.waited': HitlWaitedPayload;
+    'hitl.resumed': HitlResumedPayload;
+    'response.final': ResponseFinalPayload;
+    'stats.token_usage': StatsTokenUsagePayload;
+    'connection.heartbeat': ConnectionHeartbeatPayload;
+    'skill.matched': SkillMatchedPayload;
+    'skill.unmatched': SkillUnmatchedPayload;
+    'skill.started': SkillStartedPayload;
+    'skill.completed': SkillCompletedPayload;
+    'skill.failed': SkillFailedPayload;
+    'reasoning.step': ReasoningStepPayload;
+    'tool.progress': ToolProgressPayload;
+    'file.created': FileCreatedPayload;
+    'file.updated': FileUpdatedPayload;
+    'code.executed': CodeExecutedPayload;
+    'collaboration.handed_off': CollaborationHandedOffPayload;
+    'collaboration.subtask.started': CollaborationSubtaskStartedPayload;
+    'collaboration.subtask.completed': CollaborationSubtaskCompletedPayload;
+    'plan.created': PlanCreatedPayload;
+    'plan.step.started': PlanStepStartedPayload;
+    'plan.step.completed': PlanStepCompletedPayload;
+    'response.max_iterations_reached': ResponseMaxIterationsReachedPayload;
+    'stats.node_token_usage': StatsNodeTokenUsagePayload;
+}
+/**
+ * 判断事件是否为核心事件
+ */
+export declare function isCoreEvent(eventType: string): boolean;
+/**
+ * 判断事件是否为可选事件
+ */
+export declare function isOptionalEvent(eventType: string): boolean;
+/**
+ * 获取事件层级
+ */
+export declare function getEventLevel(eventType: string): SseEventLevel;

package/dist/sse/events/index.js

@@ -0,0 +1,96 @@
+/**
+ * SSE 事件 Payload 类型 — 统一导出
+ *
+ * 定义 SSE 事件的 Payload 接口和 SSEEventType 联合类型。
+ *
+ * 命名规范：
+ * - 格式：{domain}.{action}
+ * - 分隔符：点号（.）
+ * - 大小写：全小写
+ * - 时态：过去式（started/completed）或名词（final/heartbeat）
+ *
+ * 分层设计：
+ * - 核心事件（14 种）：所有 Agent 必须支持
+ * - 可选事件：Agent 按需支持
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ * @see eap-contracts/src/events/sse-events.ts
+ */
+// ─────────────────────────────────────────────
+// 分模块导出
+// ─────────────────────────────────────────────
+export * from './session-events.js';
+export * from './skill-events.js';
+export * from './reasoning-events.js';
+export * from './tool-events.js';
+export * from './file-events.js';
+export * from './code-events.js';
+export * from './collaboration-events.js';
+export * from './hitl-events.js';
+export * from './plan-events.js';
+export * from './response-events.js';
+export * from './stats-events.js';
+export * from './connection-events.js';
+/**
+ * 核心事件类型（所有 Agent 必须支持）
+ */
+export const CORE_SSE_EVENTS = [
+    'session.created',
+    'task.started',
+    'task.completed',
+    'task.error',
+    'reasoning.started',
+    'response.chunk',
+    'tool.called',
+    'tool.result',
+    'tool.error',
+    'hitl.waited',
+    'hitl.resumed',
+    'response.final',
+    'stats.token_usage',
+    'connection.heartbeat',
+];
+/**
+ * 可选事件类型（Agent 按需支持）
+ */
+export const OPTIONAL_SSE_EVENTS = [
+    'skill.matched',
+    'skill.unmatched',
+    'skill.started',
+    'skill.completed',
+    'skill.failed',
+    'reasoning.step',
+    'tool.progress',
+    'file.created',
+    'file.updated',
+    'code.executed',
+    'collaboration.handed_off',
+    'collaboration.subtask.started',
+    'collaboration.subtask.completed',
+    'plan.created',
+    'plan.step.started',
+    'plan.step.completed',
+    'response.max_iterations_reached',
+    'stats.node_token_usage',
+];
+// ─────────────────────────────────────────────
+// 工具函数
+// ─────────────────────────────────────────────
+/**
+ * 判断事件是否为核心事件
+ */
+export function isCoreEvent(eventType) {
+    return CORE_SSE_EVENTS.includes(eventType);
+}
+/**
+ * 判断事件是否为可选事件
+ */
+export function isOptionalEvent(eventType) {
+    return OPTIONAL_SSE_EVENTS.includes(eventType);
+}
+/**
+ * 获取事件层级
+ */
+export function getEventLevel(eventType) {
+    return isCoreEvent(eventType) ? 'core' : 'optional';
+}

package/dist/sse/events/plan-events.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 规划事件 Payload 定义
+ *
+ * 可选事件：
+ * - plan.created
+ * - plan.step.started
+ * - plan.step.completed
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** 执行计划步骤 */
+export interface PlanStep {
+    /** 步骤描述 */
+    description: string;
+    /** 预估耗时（毫秒） */
+    estimatedDuration?: number;
+}
+/** 执行计划创建 */
+export interface PlanCreatedPayload {
+    /** 计划步骤列表 */
+    steps: PlanStep[];
+    /** 预估总耗时（毫秒） */
+    estimatedDuration: number;
+}
+/** 计划步骤开始 */
+export interface PlanStepStartedPayload {
+    /** 步骤索引（从 0 开始） */
+    stepIndex: number;
+    /** 步骤描述 */
+    stepDescription: string;
+}
+/** 计划步骤完成 */
+export interface PlanStepCompletedPayload {
+    /** 步骤索引（从 0 开始） */
+    stepIndex: number;
+    /** 步骤执行结果 */
+    result: string;
+}

package/dist/sse/events/plan-events.js

@@ -0,0 +1,11 @@
+/**
+ * 规划事件 Payload 定义
+ *
+ * 可选事件：
+ * - plan.created
+ * - plan.step.started
+ * - plan.step.completed
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/reasoning-events.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 推理事件 Payload 定义
+ *
+ * 核心事件：
+ * - reasoning.started
+ * - response.chunk
+ *
+ * 可选事件：
+ * - reasoning.step
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** LLM 开始推理 */
+export interface ReasoningStartedPayload {
+    /** 当前迭代轮次 */
+    iterationCount: number;
+    /** 使用的模型名称（可选；未知时可省略） */
+    model?: string;
+}
+/** 推理中间步骤（思考过程） */
+export interface ReasoningStepPayload {
+    /** 步骤序号 */
+    step: number;
+    /** 思考内容 */
+    thought: string;
+    /** 规划内容 */
+    plan: string;
+}
+/** LLM 流式输出 */
+export interface ResponseChunkPayload {
+    /** 内容片段 */
+    content: string;
+    /** 片段序号（从 0 开始） */
+    index: number;
+}

package/dist/sse/events/reasoning-events.js

@@ -0,0 +1,13 @@
+/**
+ * 推理事件 Payload 定义
+ *
+ * 核心事件：
+ * - reasoning.started
+ * - response.chunk
+ *
+ * 可选事件：
+ * - reasoning.step
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/response-events.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 响应事件 Payload 定义
+ *
+ * 核心事件：
+ * - response.final
+ *
+ * 可选事件：
+ * - response.max_iterations_reached
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** 最终回复 */
+export interface ResponseFinalPayload {
+    /** 最终回复内容 */
+    content: string;
+    /** 回复格式（如 text, markdown, json） */
+    format: string;
+}
+/** 达到最大迭代次数 */
+export interface ResponseMaxIterationsReachedPayload {
+    /** 最大迭代次数 */
+    maxIterations: number;
+    /** 提示信息 */
+    message: string;
+}

package/dist/sse/events/response-events.js

@@ -0,0 +1,12 @@
+/**
+ * 响应事件 Payload 定义
+ *
+ * 核心事件：
+ * - response.final
+ *
+ * 可选事件：
+ * - response.max_iterations_reached
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/session-events.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 会话管理事件 Payload 定义
+ *
+ * 核心事件：
+ * - session.created
+ * - task.started
+ * - task.completed
+ * - task.error
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+/** 会话创建或恢复 */
+export interface SessionCreatedPayload {
+    /** 会话 ID */
+    sessionId: string;
+    /** 用户 ID */
+    userId: string;
+}
+/** 任务开始 */
+export interface TaskStartedPayload {
+    /** 会话 ID */
+    sessionId: string;
+    /** 任务 ID */
+    taskId: string;
+}
+/** 任务完成 */
+export interface TaskCompletedPayload {
+    /** 会话 ID */
+    sessionId: string;
+    /** 任务 ID */
+    taskId: string;
+    /** 任务执行耗时（毫秒） */
+    duration: number;
+}
+/** 任务失败 */
+export interface TaskErrorPayload {
+    /** 错误码 */
+    code: string;
+    /** 错误信息 */
+    message: string;
+    /** 是否可恢复 */
+    recoverable: boolean;
+}

package/dist/sse/events/session-events.js

@@ -0,0 +1,12 @@
+/**
+ * 会话管理事件 Payload 定义
+ *
+ * 核心事件：
+ * - session.created
+ * - task.started
+ * - task.completed
+ * - task.error
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ */
+export {};

package/dist/sse/events/skill-events.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 技能事件 Payload 定义
+ *
+ * 可选事件：
+ * - skill.matched / skill.unmatched（select/bind 选中与否）
+ * - skill.started / skill.completed / skill.failed（子图执行生命周期）
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ * @see @gt-fe/eap-contracts OPTIONAL_SSE_EVENTS
+ */
+/** 技能匹配成功 */
+export interface SkillMatchedPayload {
+    /** 技能名称 */
+    skillName: string;
+    /** 技能主键；与 skillName 可能不同 */
+    skillId?: string;
+    /** 匹配置信度 (0-1) */
+    confidence: number;
+}
+/** 无技能匹配 */
+export interface SkillUnmatchedPayload {
+    /** 用户原始输入 */
+    userInput: string;
+    /** 识别的用户意图 */
+    userIntent: string;
+    /** 关键词列表 */
+    keywords: string[];
+    /** 不匹配原因 */
+    reason: string;
+}
+/** Skill 子图开始执行 */
+export interface SkillStartedPayload {
+    skillId: string;
+    skillName: string;
+    node?: string;
+}
+/** Skill 子图执行成功 */
+export interface SkillCompletedPayload {
+    skillId: string;
+    skillName: string;
+    output?: unknown;
+}
+/** Skill 子图执行失败 */
+export interface SkillFailedPayload {
+    skillId: string;
+    skillName: string;
+    error: string;
+}

package/dist/sse/events/skill-events.js

@@ -0,0 +1,11 @@
+/**
+ * 技能事件 Payload 定义
+ *
+ * 可选事件：
+ * - skill.matched / skill.unmatched（select/bind 选中与否）
+ * - skill.started / skill.completed / skill.failed（子图执行生命周期）
+ *
+ * @see design.md §1.6 SSE事件协议定义
+ * @see @gt-fe/eap-contracts OPTIONAL_SSE_EVENTS
+ */
+export {};