@ai-setting/roy-agent-core 1.3.10 → 1.3.14

package/src/env/workflow/types/run.ts

@@ -1,173 +0,0 @@
-import { z } from 'zod';
-import type { EventBus } from '../engine/event-bus';
-import { AskUserError } from './workflow-message';
-import type { SessionComponent } from '../../session/session-component';
-
-// ==================== 状态枚举 ====================
-
-export const RunStatusSchema = z.enum([
-  'idle', 'running', 'paused', 'stopped', 'completed', 'failed'
-]);
-export type RunStatus = z.infer<typeof RunStatusSchema>;
-
-export const NodeStatusSchema = z.enum([
-  'pending', 'scheduled', 'started', 'running', 'completed', 'failed', 'skipped'
-]);
-export type NodeStatus = z.infer<typeof NodeStatusSchema>;
-
-// ==================== Workflow Run ====================
-
-export interface WorkflowRun {
-  id: string;
-  workflowId: string;
-  workflowName: string;
-  status: RunStatus;
-  input?: Record<string, any>;
-  output?: Record<string, any>;
-  error?: string;
-  startedAt?: Date;
-  pausedAt?: Date;
-  resumedAt?: Date;
-  stoppedAt?: Date;
-  completedAt?: Date;
-  durationMs?: number;
-  debugMode: boolean;
-  parentRunId?: string;
-}
-
-// ==================== Node Run ====================
-
-export interface NodeRun {
-  id: string;
-  runId: string;
-  nodeId: string;
-  nodeType: string;
-  status: NodeStatus;
-  input?: any;
-  output?: any;
-  error?: string;
-  startedAt?: Date;
-  completedAt?: Date;
-  durationMs?: number;
-  retryCount: number;
-}
-
-// ==================== 运行选项 ====================
-
-export interface RunOptions {
-  input?: Record<string, any>;
-  debug?: boolean;
-  parallelLimit?: number | null;
-  timeout?: number | null;
-  /** @deprecated No-op: workflow always waits for completion */
-  sync?: boolean;
-}
-
-export interface RunResult {
-  runId: string;
-  /** Session ID (workflow_{runId} format) - useful for CLI resume */
-  sessionId?: string;
-  status: RunStatus;
-  output?: Record<string, any>;
-  error?: string;
-  durationMs?: number;
-  /** Pending node ID (when status is 'paused') */
-  pendingNodeId?: string;
-  /** Query from ask_user (when status is 'paused') */
-  query?: string;
-  /** Agent sub-session ID (for resuming agent nodes) */
-  agentSessionId?: string;
-}
-
-// ==================== 节点执行上下文 ====================
-
-/**
- * 节点执行上下文
- * 
- * 扩展后包含：
- * - sessionId: Session ID，用于消息持久化
- * - askUser(): 方法，让节点可以请求用户输入
- */
-export interface NodeExecutionContext {
-  runId: string;
-  sessionId: string;                 // Session ID = workflow_{runId}，用于消息持久化
-  workflowName: string;
-  nodeId: string;
-  input: unknown;
-  previousOutputs: Map<string, unknown>;  // 依赖节点的输出 (用于模板解析)
-  nodeOutputs: Map<string, unknown>;      // 所有节点的输出 (用于完整数据访问)
-  config: Record<string, unknown>;       // 节点配置
-  debug: boolean;
-  eventBus: EventBus;
-  
-  // Workflow 历史消息（用于 agent 节点之间共享 LLM 对话历史）
-  workflowHistory?: Array<{
-    role: 'user' | 'assistant' | 'tool';
-    content: string;
-    toolCallId?: string;
-    toolName?: string;
-    nodeId?: string;
-  }>;
-  
-  // Agent sub-session 支持
-  // SessionComponent 用于创建和管理 agent sub-sessions
-  sessionComponent?: SessionComponent;
-  // Agent sub-session ID（当节点是 agent 类型时）
-  agentSessionId?: string;
-  
-  // 新增方法
-  /**
-   * 请求用户输入
-   * 
-   * 调用此方法会抛出 AskUserError，引擎捕获后会暂停 workflow
-   * 
-   * @param query - 向用户询问的问题
-   * @throws AskUserError - 总是抛出此异常
-   */
-  askUser(query: string): never;
-}
-
-// ==================== 节点执行结果 ====================
-
-export interface NodeExecutionResult {
-  success?: boolean;
-  output?: any;
-  error?: string | Error;
-  duration?: number;
-  durationMs?: number;
-  metadata?: Record<string, unknown>;
-}
-
-// ==================== Context Factory ====================
-
-/**
- * 创建 NodeExecutionContext
- */
-export function createNodeExecutionContext(
-  params: {
-    runId: string;
-    workflowName: string;
-    nodeId: string;
-    input: unknown;
-    previousOutputs: Map<string, unknown>;
-    nodeOutputs: Map<string, unknown>;
-    config: Record<string, unknown>;
-    debug: boolean;
-    eventBus: EventBus;
-    sessionId: string;
-    workflowHistory?: NodeExecutionContext['workflowHistory'];
-  }
-): NodeExecutionContext {
-  return {
-    ...params,
-    askUser: (query: string): never => {
-      throw new AskUserError(
-        params.runId,
-        params.sessionId,
-        params.nodeId,
-        'unknown', // nodeType 会在外层设置
-        query
-      );
-    },
-  };
-}

package/src/env/workflow/types/workflow-hil.ts

@@ -1,114 +0,0 @@
-/**
- * @fileoverview Human-in-Loop (HIL) types for workflow
- * 
- * This module contains types and utilities for human-in-loop functionality:
- * - NodeInterruptEvent: Event when a node needs human input
- * - WorkflowAskUserEvent: Event when the workflow needs human confirmation
- * - AskUserError: Error thrown when a node requests user input
- */
-
-import type { BaseEvent } from './event';
-
-// ==================== Event Types ====================
-
-/**
- * Node 中断事件 - 节点等待用户输入
- */
-export interface NodeInterruptEvent extends BaseEvent {
-  type: 'node.interrupt';
-  node_id: string;
-  node_type: string;
-  query: string;
-  /** Agent sub-session ID (for agent nodes that need resume) */
-  agent_session_id?: string;
-}
-
-/**
- * Workflow Ask User 事件 - Workflow 等待用户输入
- */
-export interface WorkflowAskUserEvent extends BaseEvent {
-  type: 'workflow.ask-user';
-  session_id: string;
-  node_id: string;
-  node_type: string;
-  query: string;
-}
-
-/**
- * 创建 NodeInterruptEvent
- */
-export function createNodeInterruptEvent(
-  runId: string,
-  nodeId: string,
-  nodeType: string,
-  query: string,
-  agentSessionId?: string
-): NodeInterruptEvent {
-  return {
-    type: 'node.interrupt',
-    run_id: runId,
-    timestamp: Date.now(),
-    node_id: nodeId,
-    node_type: nodeType,
-    query,
-    ...(agentSessionId ? { agent_session_id: agentSessionId } : {}),
-  };
-}
-
-/**
- * 创建 WorkflowAskUserEvent
- */
-export function createWorkflowAskUserEvent(
-  runId: string,
-  sessionId: string,
-  nodeId: string,
-  nodeType: string,
-  query: string
-): WorkflowAskUserEvent {
-  return {
-    type: 'workflow.ask-user',
-    run_id: runId,
-    timestamp: Date.now(),
-    session_id: sessionId,
-    node_id: nodeId,
-    node_type: nodeType,
-    query,
-  };
-}
-
-// ==================== AskUserError ====================
-
-/**
- * AskUserError - 当节点调用 askUser() 时抛出
- */
-export class AskUserError extends Error {
-  readonly type = 'ask-user';
-  readonly name = 'AskUserError';
-  
-  constructor(
-    public readonly runId: string,
-    public readonly sessionId: string,
-    public readonly nodeId: string,
-    public readonly nodeType: string,
-    public readonly query: string,
-    public readonly agentSessionId?: string,
-    public readonly timestamp: number = Date.now()
-  ) {
-    super(`[${nodeType}:${nodeId}] Ask user: ${query}`);
-  }
-  
-  /**
-   * 转换为 WorkflowAskUserEvent
-   */
-  toEvent(): WorkflowAskUserEvent {
-    return {
-      type: 'workflow.ask-user',
-      run_id: this.runId,
-      timestamp: this.timestamp,
-      session_id: this.sessionId,
-      node_id: this.nodeId,
-      node_type: this.nodeType,
-      query: this.query,
-    };
-  }
-}

package/src/env/workflow/types/workflow-message.test.ts

@@ -1,138 +0,0 @@
-import { describe, it, expect } from 'bun:test';
-import {
-  AskUserError,
-  createNodeInterruptEvent,
-  createWorkflowAskUserEvent,
-  WorkflowMessageRoleSchema,
-  type WorkflowMessagePart,
-} from './workflow-message';
-
-describe('AskUserError', () => {
-  it('should create error with all properties', () => {
-    const error = new AskUserError(
-      'run_123',
-      'workflow_run_123',
-      'node_1',
-      'agent',
-      '确认继续吗？'
-    );
-    
-    expect(error.runId).toBe('run_123');
-    expect(error.sessionId).toBe('workflow_run_123');
-    expect(error.nodeId).toBe('node_1');
-    expect(error.nodeType).toBe('agent');
-    expect(error.query).toBe('确认继续吗？');
-    expect(error.type).toBe('ask-user');
-    expect(error.name).toBe('AskUserError');
-  });
-  
-  it('should convert to WorkflowAskUserEvent', () => {
-    const error = new AskUserError(
-      'run_123',
-      'workflow_run_123',
-      'node_1',
-      'agent',
-      '确认继续吗？'
-    );
-    
-    const event = error.toEvent();
-    
-    expect(event.type).toBe('workflow.ask-user');
-    expect(event.run_id).toBe('run_123');
-    expect(event.session_id).toBe('workflow_run_123');
-    expect(event.node_id).toBe('node_1');
-    expect(event.node_type).toBe('agent');
-    expect(event.query).toBe('确认继续吗？');
-  });
-  
-  it('should have correct error message', () => {
-    const error = new AskUserError(
-      'run_123',
-      'workflow_run_123',
-      'node_1',
-      'agent',
-      '确认继续吗？'
-    );
-    
-    expect(error.message).toBe('[agent:node_1] Ask user: 确认继续吗？');
-  });
-});
-
-describe('createNodeInterruptEvent', () => {
-  it('should create event with correct structure', () => {
-    const event = createNodeInterruptEvent(
-      'run_123',
-      'node_1',
-      'agent',
-      '确认继续吗？'
-    );
-    
-    expect(event.type).toBe('node.interrupt');
-    expect(event.run_id).toBe('run_123');
-    expect(event.node_id).toBe('node_1');
-    expect(event.node_type).toBe('agent');
-    expect(event.query).toBe('确认继续吗？');
-    expect(typeof event.timestamp).toBe('number');
-  });
-});
-
-describe('createWorkflowAskUserEvent', () => {
-  it('should create event with correct structure', () => {
-    const event = createWorkflowAskUserEvent(
-      'run_123',
-      'workflow_run_123',
-      'node_1',
-      'agent',
-      '确认继续吗？'
-    );
-    
-    expect(event.type).toBe('workflow.ask-user');
-    expect(event.run_id).toBe('run_123');
-    expect(event.session_id).toBe('workflow_run_123');
-    expect(event.node_id).toBe('node_1');
-    expect(event.node_type).toBe('agent');
-    expect(event.query).toBe('确认继续吗？');
-  });
-});
-
-describe('WorkflowMessageRoleSchema', () => {
-  it('should validate workflow message roles', () => {
-    expect(WorkflowMessageRoleSchema.parse('workflow.node.call')).toBe('workflow.node.call');
-    expect(WorkflowMessageRoleSchema.parse('workflow.node.interrupt')).toBe('workflow.node.interrupt');
-    expect(WorkflowMessageRoleSchema.parse('workflow.node.result')).toBe('workflow.node.result');
-    expect(WorkflowMessageRoleSchema.parse('workflow.node.resume')).toBe('workflow.node.resume');
-  });
-  
-  it('should reject invalid roles', () => {
-    expect(() => WorkflowMessageRoleSchema.parse('user')).toThrow();
-    expect(() => WorkflowMessageRoleSchema.parse('assistant')).toThrow();
-  });
-});
-
-describe('WorkflowMessagePart types', () => {
-  it('should allow WorkflowNodeCallPart', () => {
-    const part: WorkflowMessagePart = {
-      type: 'workflow-node-call',
-      nodeId: 'node_1',
-      nodeType: 'agent',
-      input: { value: 42 },
-      startTime: Date.now(),
-    };
-    
-    expect(part.type).toBe('workflow-node-call');
-    expect(part.nodeId).toBe('node_1');
-  });
-  
-  it('should allow WorkflowNodeResultPart', () => {
-    const part: WorkflowMessagePart = {
-      type: 'workflow-node-result',
-      nodeId: 'node_1',
-      nodeType: 'agent',
-      output: { result: 'success' },
-      durationMs: 1000,
-    };
-    
-    expect(part.type).toBe('workflow-node-result');
-    expect(part.durationMs).toBe(1000);
-  });
-});

package/src/env/workflow/types/workflow-message.ts

@@ -1,196 +0,0 @@
-import { z } from 'zod';
-
-// ==================== Workflow Message Roles ====================
-
-/**
- * Workflow 节点执行消息角色类型
- */
-export const WorkflowMessageRoleSchema = z.enum([
-  'workflow.node.call',
-  'workflow.node.interrupt', 
-  'workflow.node.result',
-  'workflow.node.resume'
-]);
-export type WorkflowMessageRole = z.infer<typeof WorkflowMessageRoleSchema>;
-
-// ==================== Message Parts ====================
-
-/**
- * workflow.node.call 消息 part
- */
-export interface WorkflowNodeCallPart {
-  type: 'workflow-node-call';
-  nodeId: string;
-  nodeType: string;
-  input: unknown;
-  startTime: number;
-  /** Agent session ID (only for agent nodes) */
-  agentSessionId?: string;
-}
-
-/**
- * workflow.node.interrupt 消息 part
- */
-export interface WorkflowNodeInterruptPart {
-  type: 'workflow-node-interrupt';
-  nodeId: string;
-  nodeType: string;
-  query: string;
-  timestamp: number;
-}
-
-/**
- * workflow.node.result 消息 part
- */
-export interface WorkflowNodeResultPart {
-  type: 'workflow-node-result';
-  nodeId: string;
-  nodeType: string;
-  output?: unknown;
-  error?: string;
-  durationMs: number;
-}
-
-/**
- * workflow.node.resume 消息 part
- */
-export interface WorkflowNodeResumePart {
-  type: 'workflow-node-resume';
-  response: string;
-  timestamp: number;
-}
-
-/**
- * workflow 消息 part 联合类型
- */
-export type WorkflowMessagePart = 
-  | WorkflowNodeCallPart 
-  | WorkflowNodeInterruptPart 
-  | WorkflowNodeResultPart 
-  | WorkflowNodeResumePart;
-
-// ==================== Session Metadata ====================
-
-/**
- * Workflow Session 元数据（简化版）
- * 
- * 简化原则：只保留必要字段，其他信息从 messages 推断
- * 
- * 设计原则：
- * - sessionId 直接作为 runId 使用
- * - Session.metadata.status 跟踪运行状态
- * - Session.messages 按时间顺序记录节点执行状态
- * - Next node 从 messages 推断（最后一条消息决定恢复点）
- */
-export interface WorkflowSessionMetadata {
-  type: 'workflow';
-  /** Used to load workflow definition */
-  workflowId: string;
-  /** Display name */
-  workflowName: string;
-  /** Workflow 版本 (可选) */
-  workflowVersion?: string;
-  /** Execution status */
-  status: 'running' | 'paused' | 'completed' | 'failed' | 'stopped';
-  
-  // === 以下字段已移除，从 messages 推断 ===
-  // - input: 从第一条 workflow.node.call 消息推断
-  // - rootNodeId: 从 workflow definition 推断
-  // - agentSessions: 从 call 消息的 agentSessionId 收集
-  // - pendingNodeId: 从最后一条 call/interrupt 消息推断
-  // - pauseReason: 从最后一条 interrupt 消息推断
-  // - lastInterruptQuery: 从最后一条 interrupt 消息推断
-  
-  /** Allow additional properties for metadata extension */
-  [key: string]: unknown;
-}
-
-/**
- * Agent Session 引用（存储在 workflow session metadata 中）
- */
-export interface AgentSessionRef {
-  nodeId: string;
-  sessionId: string;
-  status: 'active' | 'paused' | 'completed';
-  createdAt?: number;
-}
-
-// ==================== Message Metadata ====================
-
-/**
- * workflow.node.call 消息元数据
- */
-export interface WorkflowNodeCallMetadata {
-  type: 'workflow.node.call';
-  workflowNodeId: string;
-  workflowNodeType: string;
-  /** Agent session ID (only for agent nodes) */
-  agentSessionId?: string;
-}
-
-/**
- * workflow.node.interrupt 消息元数据
- */
-export interface WorkflowNodeInterruptMetadata {
-  type: 'workflow.node.interrupt';
-  workflowNodeId: string;
-  workflowNodeType: string;
-  query: string;
-  /** Agent session ID (only for agent nodes) */
-  agentSessionId?: string;
-}
-
-/**
- * workflow.node.result 消息元数据
- */
-export interface WorkflowNodeResultMetadata {
-  type: 'workflow.node.result';
-  workflowNodeId: string;
-  workflowNodeType: string;
-  success: boolean;
-}
-
-/**
- * workflow.node.resume 消息元数据
- */
-export interface WorkflowNodeResumeMetadata {
-  type: 'workflow.node.resume';
-  response: string;
-}
-
-/**
- * workflow 消息元数据联合类型
- */
-export type WorkflowMessageMetadata = 
-  | WorkflowNodeCallMetadata 
-  | WorkflowNodeInterruptMetadata 
-  | WorkflowNodeResultMetadata 
-  | WorkflowNodeResumeMetadata;
-
-// ==================== Agent Session Info ====================
-
-/**
- * Agent Session 信息（存储在 workflow message metadata 中）
- */
-export interface AgentSessionInfo {
-  /** Agent session ID */
-  sessionId: string;
-  /** Node ID */
-  nodeId: string;
-  /** 创建时间 */
-  createdAt: number;
-}
-
-// ==================== Re-export HIL types ====================
-
-// Re-export Human-in-Loop types and utilities
-export {
-  AskUserError,
-  createNodeInterruptEvent,
-  createWorkflowAskUserEvent,
-} from './workflow-hil';
-
-export type {
-  NodeInterruptEvent,
-  WorkflowAskUserEvent,
-} from './workflow-hil';

package/src/env/workflow/types/workflow-session.test.ts

@@ -1,95 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { isWorkflowSessionMetadata, getWorkflowSessionStatus } from './workflow-session';
-
-describe('WorkflowSessionMetadata', () => {
-  describe('isWorkflowSessionMetadata', () => {
-    it('should accept simplified metadata with required fields only', () => {
-      const metadata = {
-        type: 'workflow' as const,
-        workflowId: 'my-workflow',
-        workflowName: 'My Workflow',
-        status: 'running' as const,
-      };
-      
-      expect(isWorkflowSessionMetadata(metadata)).toBe(true);
-    });
-    
-    it('should accept all valid statuses', () => {
-      const statuses = ['running', 'paused', 'completed', 'failed', 'stopped'];
-      
-      for (const status of statuses) {
-        const metadata = {
-          type: 'workflow' as const,
-          workflowId: 'wf',
-          workflowName: 'Wf',
-          status,
-        };
-        expect(isWorkflowSessionMetadata(metadata)).toBe(true, `Status ${status} should be valid`);
-      }
-    });
-    
-    it('should accept metadata with optional fields', () => {
-      const metadata = {
-        type: 'workflow' as const,
-        workflowId: 'my-workflow',
-        workflowName: 'My Workflow',
-        status: 'running' as const,
-        workflowVersion: '1.0.0',
-      };
-      
-      expect(isWorkflowSessionMetadata(metadata)).toBe(true);
-    });
-    
-    it('should reject non-workflow metadata', () => {
-      const metadata = { type: 'agent', name: 'test' };
-      expect(isWorkflowSessionMetadata(metadata)).toBe(false);
-    });
-    
-    it('should reject metadata without type', () => {
-      const metadata = { workflowId: 'wf', workflowName: 'Wf', status: 'running' };
-      expect(isWorkflowSessionMetadata(metadata)).toBe(false);
-    });
-    
-    it('should reject metadata without workflowId', () => {
-      const metadata = { type: 'workflow', workflowName: 'Wf', status: 'running' };
-      expect(isWorkflowSessionMetadata(metadata)).toBe(false);
-    });
-    
-    it('should reject metadata without workflowName', () => {
-      const metadata = { type: 'workflow', workflowId: 'wf', status: 'running' };
-      expect(isWorkflowSessionMetadata(metadata)).toBe(false);
-    });
-    
-    it('should reject metadata without status', () => {
-      const metadata = { type: 'workflow', workflowId: 'wf', workflowName: 'Wf' };
-      expect(isWorkflowSessionMetadata(metadata)).toBe(false);
-    });
-    
-    it('should reject null', () => {
-      expect(isWorkflowSessionMetadata(null)).toBe(false);
-    });
-  });
-  
-  describe('getWorkflowSessionStatus', () => {
-    it('should return status from metadata', () => {
-      const metadata = {
-        type: 'workflow' as const,
-        workflowId: 'wf',
-        workflowName: 'Wf',
-        status: 'paused' as const,
-      };
-      
-      expect(getWorkflowSessionStatus(metadata)).toBe('paused');
-    });
-    
-    it('should return running as default when status is missing', () => {
-      const metadata = {
-        type: 'workflow' as const,
-        workflowId: 'wf',
-        workflowName: 'Wf',
-      } as any;
-      
-      expect(getWorkflowSessionStatus(metadata)).toBe('running');
-    });
-  });
-});