@longzai-intelligence-workflow/core 0.0.1

package/src/ports/feed-event.port.ts

@@ -0,0 +1,74 @@
+/**
+ * feed 事件端口契约（W-2，Phase 2）
+ *
+ * 定义工作流引擎订阅 feed 事件的端口契约。
+ * feed 项目 F-2 完成事件端口暴露后，需提供实现此端口的事件总线适配器，
+ * 供 trigger 子插件在 type='feed.event' 时订阅 feed 事件。
+ *
+ * C1 合规：本端口为零框架依赖的纯类型契约，由 feed 项目的实现层提供具体实现。
+ */
+
+import type { FeedEventFilter, FeedEventName, FeedEventPayload } from '../types';
+
+/**
+ * feed 事件订阅句柄
+ *
+ * 由 subscribe 方法返回，调用 unsubscribe 取消订阅。
+ */
+export type FeedEventSubscription = {
+  /**
+   * 取消订阅，释放底层资源
+   */
+  unsubscribe: () => Promise<void> | void;
+};
+
+/**
+ * feed 事件处理器
+ *
+ * 事件到达时被调用，接收事件 payload。
+ * 工作流引擎在此处理器中启动新的工作流实例并注入 payload 作为上下文输入。
+ */
+export type FeedEventHandler = {
+  /**
+   * 事件处理回调
+   *
+   * @param payload - feed 事件 payload
+   */
+  handle: (payload: FeedEventPayload) => Promise<void> | void;
+};
+
+/**
+ * feed 事件端口
+ *
+ * 工作流引擎通过此端口订阅 feed 事件总线，
+ * 当 feed 项目有新条目/抓取/过滤/行业识别事件时触发回调。
+ *
+ * 依赖 feed 项目 F-2 暴露事件端口实现。
+ */
+export type FeedEventPort = {
+  /**
+   * 订阅指定 feed 事件
+   *
+   * @param eventName - 订阅的事件名称
+   * @param handler - 事件处理器
+   * @param filter - 可选事件过滤条件
+   * @returns 订阅句柄，用于取消订阅
+   */
+  subscribe: (
+    eventName: FeedEventName,
+    handler: FeedEventHandler,
+    filter?: FeedEventFilter,
+  ) => Promise<FeedEventSubscription>;
+
+  /**
+   * 检查 feed 事件端口是否可用
+   *
+   * @returns 端口是否可用
+   */
+  isAvailable: () => Promise<boolean>;
+};
+
+/**
+ * feed 事件端口 DI 令牌
+ */
+export const FEED_EVENT_PORT_TOKEN = Symbol('FEED_EVENT_PORT_TOKEN');

package/src/ports/index.ts

@@ -0,0 +1,9 @@
+/**
+ * workflow core 端口契约导出
+ *
+ * 汇总导出工作流领域的端口契约，供适配器层实现。
+ * 端口契约为零框架依赖的纯类型定义，符合 C1 合规要求。
+ */
+
+export * from './feed-event.port';
+export * from './action-executor.port';

package/src/schemas/action-executor.schema.ts

@@ -0,0 +1,209 @@
+/**
+ * action 执行器 Schema 定义（W-3，Phase 2）
+ *
+ * 定义工作流内置 action 执行器的 Zod Schema 契约，
+ * 供 execution 子插件注册 action handler 时使用。
+ *
+ * 支持的 action 类型：
+ * - feed.applyTags：调用 feed F-2 applyTags，为条目打标签
+ * - feed.summarize：调用 feed F-3 summarize，生成摘要
+ * - llm.complete：调用 agent LlmCompletePort，完成文本
+ * - webhook.send：调用 webhook 项目，发送 webhook 请求
+ *
+ * D-08 决策：不暴露 DSL 编辑 UI，action 通过自然语言编译的 DSL 执行。
+ */
+
+import { z } from 'zod';
+
+import { ACTION_TYPES } from '../constants/workflow';
+
+/**
+ * action 类型 Schema
+ *
+ * 内置 action 类型枚举。
+ */
+export const actionTypeSchema = z.enum(ACTION_TYPES);
+
+/**
+ * feed.applyTags action 输入 Schema
+ *
+ * 调用 feed F-2 applyTags 为指定条目打标签。
+ */
+export const feedApplyTagsActionSchema = z.object({
+  /**
+   * action 类型，固定为 'feed.applyTags'
+   */
+  type: z.literal('feed.applyTags'),
+
+  /**
+   * 目标 feed 条目 ID
+   */
+  itemId: z.string(),
+
+  /**
+   * 待应用的标签列表
+   */
+  tags: z.array(z.string()),
+
+  /**
+   * 标签来源（默认 'workflow'）
+   */
+  source: z.enum(['manual', 'rule', 'workflow']).optional(),
+});
+
+/**
+ * feed.summarize action 输入 Schema
+ *
+ * 调用 feed F-3 summarize 生成指定条目的摘要。
+ */
+export const feedSummarizeActionSchema = z.object({
+  /**
+   * action 类型，固定为 'feed.summarize'
+   */
+  type: z.literal('feed.summarize'),
+
+  /**
+   * 目标 feed 条目 ID
+   */
+  itemId: z.string(),
+
+  /**
+   * 摘要级别
+   *
+   * - micro：超短摘要（卡片展示）
+   * - short：短摘要
+   * - structured：结构化摘要
+   */
+  level: z.enum(['micro', 'short', 'structured']),
+});
+
+/**
+ * llm.complete action 输入 Schema
+ *
+ * 调用 agent LlmCompletePort 完成文本生成。
+ * D-07 决策：默认走 anthropic provider。
+ */
+export const llmCompleteActionSchema = z.object({
+  /**
+   * action 类型，固定为 'llm.complete'
+   */
+  type: z.literal('llm.complete'),
+
+  /**
+   * 用户输入的文本提示
+   */
+  prompt: z.string(),
+
+  /**
+   * 系统提示词，用于设定 LLM 角色 or 任务上下文
+   */
+  systemPrompt: z.string().optional(),
+
+  /**
+   * 最大生成 token 数
+   */
+  maxTokens: z.number().optional(),
+
+  /**
+   * 采样温度，控制输出随机性，取值范围 0-1
+   */
+  temperature: z.number().min(0).max(1).optional(),
+});
+
+/**
+ * webhook.send action 输入 Schema
+ *
+ * 调用 webhook 项目发送 webhook 请求。
+ */
+export const webhookSendActionSchema = z.object({
+  /**
+   * action 类型，固定为 'webhook.send'
+   */
+  type: z.literal('webhook.send'),
+
+  /**
+   * 目标 webhook URL
+   */
+  url: z.string(),
+
+  /**
+   * HTTP 方法（默认 POST）
+   */
+  method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).optional(),
+
+  /**
+   * 请求头
+   */
+  headers: z.record(z.string(), z.string()).optional(),
+
+  /**
+   * 请求体
+   */
+  body: z.unknown().optional(),
+});
+
+/**
+ * action 联合类型 Schema
+ *
+ * 通过 discriminatedUnion 按 type 字段区分具体 action 类型。
+ */
+export const actionSchema = z.discriminatedUnion('type', [
+  feedApplyTagsActionSchema,
+  feedSummarizeActionSchema,
+  llmCompleteActionSchema,
+  webhookSendActionSchema,
+]);
+
+/**
+ * action 执行上下文 Schema
+ *
+ * 工作流引擎在执行 action 节点时传入的上下文信息。
+ */
+export const actionContextSchema = z.object({
+  /**
+   * 工作流实例 ID
+   */
+  instanceId: z.string(),
+
+  /**
+   * 工作流定义 ID
+   */
+  definitionId: z.string(),
+
+  /**
+   * 当前节点 ID
+   */
+  nodeId: z.string(),
+
+  /**
+   * 工作流变量（运行时上下文）
+   */
+  variables: z.record(z.string(), z.unknown()),
+
+  /**
+   * 上一节点的输出（作为当前 action 的输入）
+   */
+  input: z.unknown(),
+});
+
+/**
+ * action 执行结果 Schema
+ *
+ * action handler 执行完成后返回的结果。
+ */
+export const actionResultSchema = z.object({
+  /**
+   * 是否执行成功
+   */
+  success: z.boolean(),
+
+  /**
+   * 执行输出数据（成功时）
+   */
+  data: z.unknown().optional(),
+
+  /**
+   * 错误信息（失败时）
+   */
+  error: z.string().optional(),
+});

package/src/schemas/api.schema.ts

@@ -0,0 +1,11 @@
+/**
+ * 通用 API Schema 已清理
+ *
+ * 历史上此文件导出 apiResponseSchema、paginatedResponseSchema、paginationInfoSchema、
+ * apiErrorSchema 等通用 API Zod Schema，但经核查无任何外部消费方
+ * （apps/web 与 packages/sdk 均在各自模块内本地定义 apiResponseSchema，
+ * 或使用 packages/sdk/src/schemas/error.schema.ts 提供的 ApiResponseSchema/PaginatedResponseSchema）。
+ *
+ * 为清理死代码，此文件内容已被清空，文件本身保留以维持包结构骨架。
+ */
+export {};

package/src/schemas/definition.schema.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+
+import { NODE_TYPES } from '../constants/workflow';
+
+export const workflowNodeDtoSchema = z.object({
+  nodeId: z.string(),
+  name: z.string(),
+  type: z.enum(NODE_TYPES),
+  properties: z.record(z.string(), z.unknown()),
+  position: z.object({ x: z.number(), y: z.number() }),
+});
+
+export const workflowEdgeDtoSchema = z.object({
+  edgeId: z.string(),
+  sourceNodeId: z.string(),
+  targetNodeId: z.string(),
+  condition: z.string().optional(),
+  label: z.string().optional(),
+});
+
+export const stateTransitionDtoSchema = z.object({
+  from: z.string(),
+  to: z.string(),
+  event: z.string(),
+  guard: z.string().optional(),
+  action: z.string().optional(),
+});
+
+export const createDefinitionInputSchema = z.object({
+  name: z.string(),
+  description: z.string().optional(),
+  nodes: z.array(workflowNodeDtoSchema),
+  edges: z.array(workflowEdgeDtoSchema),
+  initialState: z.string(),
+  states: z.array(z.string()),
+  transitions: z.array(stateTransitionDtoSchema),
+});
+
+export const updateDefinitionInputSchema = createDefinitionInputSchema.partial();
+
+export const definitionDtoSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  description: z.string().nullable(),
+  version: z.number(),
+  nodes: z.array(workflowNodeDtoSchema),
+  edges: z.array(workflowEdgeDtoSchema),
+  initialState: z.string(),
+  states: z.array(z.string()),
+  publishedAt: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});

package/src/schemas/feed-event-trigger.schema.ts

@@ -0,0 +1,102 @@
+/**
+ * feed 事件触发器 Schema 定义（W-2，Phase 2）
+ *
+ * 定义 feed 事件触发器的 Zod Schema 契约，供 trigger 子插件扩展
+ * type: 'feed.event' 触发器类型时使用。
+ *
+ * D-08 决策：仅自然语言输入，DSL 由系统编译，不暴露 DSL 编辑 UI，
+ * 故 feed 事件触发器配置由系统编译的 DSL 携带，不暴露编辑端点。
+ *
+ * 依赖 feed 项目 F-2 暴露的事件端口（FeedEventPort）。
+ */
+
+import { z } from 'zod';
+
+import { FEED_EVENT_NAMES } from '../constants/workflow';
+
+/**
+ * feed 事件名称 Schema
+ *
+ * 枚举 feed 项目暴露的可订阅事件名称。
+ */
+export const feedEventNameSchema = z.enum(FEED_EVENT_NAMES);
+
+/**
+ * feed 事件过滤条件 Schema
+ *
+ * 用于在订阅 feed 事件时按信息源、订阅、行业、标签过滤，
+ * 仅匹配的事件才会触发工作流。
+ */
+export const feedEventFilterSchema = z
+  .object({
+    /**
+     * 信息源 ID 过滤
+     */
+    sourceId: z.string().optional(),
+
+    /**
+     * 订阅 ID 过滤
+     */
+    subscriptionId: z.string().optional(),
+
+    /**
+     * 行业过滤
+     */
+    industry: z.string().optional(),
+
+    /**
+     * 标签过滤（匹配任一标签）
+     */
+    tags: z.array(z.string()).optional(),
+  })
+  .optional();
+
+/**
+ * feed 事件触发器配置 Schema
+ *
+ * 工作流 trigger.type 为 'feed.event' 时的配置结构，
+ * 描述订阅的事件名称与可选过滤条件。
+ */
+export const feedEventTriggerSchema = z.object({
+  /**
+   * 触发器类型，固定为 'feed.event'
+   */
+  type: z.literal('feed.event'),
+
+  /**
+   * 订阅的 feed 事件名称
+   */
+  eventName: feedEventNameSchema,
+
+  /**
+   * 事件过滤条件（可选）
+   */
+  filter: feedEventFilterSchema,
+});
+
+/**
+ * feed 事件 payload Schema
+ *
+ * feed 项目 F-2 在事件触发时传递给工作流上下文的事件数据结构。
+ */
+export const feedEventPayloadSchema = z.object({
+  /**
+   * 触发的事件名称
+   */
+  eventName: feedEventNameSchema,
+
+  /**
+   * 关联的 feed 条目 ID（item.ingested/item.filtered/industry.detected 时存在）
+   */
+  itemId: z.string().optional(),
+
+  /**
+   * 关联的信息源 ID（source.fetched 时存在）
+   */
+  sourceId: z.string().optional(),
+
+  /**
+   * 事件附加数据
+   */
+  data: z.record(z.string(), z.unknown()),
+});

package/src/schemas/index.ts

@@ -0,0 +1,8 @@
+export * from './definition.schema';
+export * from './workflow-doc.schema';
+export * from './instance.schema';
+export * from './trigger.schema';
+export * from './monitoring.schema';
+export * from './feed-event-trigger.schema';
+export * from './action-executor.schema';
+export * from './workflow-doc.schema';

package/src/schemas/instance.schema.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+
+import { INSTANCE_STATUSES, NODE_EXECUTION_STATUSES } from '../constants/workflow';
+
+export const instanceStatusDtoSchema = z.enum(INSTANCE_STATUSES);
+
+export const nodeExecutionStatusDtoSchema = z.enum(NODE_EXECUTION_STATUSES);
+
+export const nodeExecutionDtoSchema = z.object({
+  id: z.string(),
+  instanceId: z.string(),
+  nodeId: z.string(),
+  nodeName: z.string(),
+  nodeType: z.string(),
+  status: nodeExecutionStatusDtoSchema,
+  startedAt: z.string().nullable(),
+  completedAt: z.string().nullable(),
+  error: z.string().nullable(),
+  createdAt: z.string(),
+});
+
+export const instanceDtoSchema = z.object({
+  id: z.string(),
+  definitionId: z.string(),
+  definitionVersion: z.number(),
+  status: instanceStatusDtoSchema,
+  currentState: z.string(),
+  previousState: z.string().nullable(),
+  currentNodeId: z.string().nullable(),
+  variables: z.record(z.string(), z.unknown()),
+  startedAt: z.string().nullable(),
+  completedAt: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const createInstanceInputSchema = z.object({
+  definitionId: z.string(),
+  input: z.record(z.string(), z.unknown()).optional(),
+});
+
+export const instanceQueryParamsSchema = z.object({
+  status: instanceStatusDtoSchema.optional(),
+  definitionId: z.string().optional(),
+  page: z.number().optional(),
+  pageSize: z.number().optional(),
+});

package/src/schemas/monitoring.schema.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+
+import { ALERT_TYPES, METRIC_TYPES } from '../constants/workflow';
+
+export const alertTypeDtoSchema = z.enum(ALERT_TYPES);
+
+export const metricTypeDtoSchema = z.enum(METRIC_TYPES);
+
+export const auditLogDtoSchema = z.object({
+  id: z.string(),
+  instanceId: z.string(),
+  nodeId: z.string().nullable(),
+  action: z.string(),
+  fromStatus: z.string().nullable(),
+  toStatus: z.string(),
+  operator: z.string().nullable(),
+  detail: z.record(z.string(), z.unknown()),
+  createdAt: z.string(),
+});
+
+export const alertDtoSchema = z.object({
+  id: z.string(),
+  definitionId: z.string(),
+  type: alertTypeDtoSchema,
+  threshold: z.number(),
+  notifyConfig: z.record(z.string(), z.unknown()),
+  enabled: z.boolean(),
+  lastTriggeredAt: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const performanceMetricDtoSchema = z.object({
+  id: z.string(),
+  definitionId: z.string(),
+  metricType: metricTypeDtoSchema,
+  value: z.number(),
+  period: z.string(),
+  calculatedAt: z.string(),
+});
+
+export const trendPointDtoSchema = z.object({
+  date: z.string(),
+  value: z.number(),
+});
+
+export const monitoringDashboardDtoSchema = z.object({
+  runningInstances: z.number(),
+  successRate: z.number(),
+  avgDuration: z.number(),
+  failureAlerts: z.number(),
+  trend: z.array(trendPointDtoSchema),
+});

package/src/schemas/trigger.schema.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+
+import { TRIGGER_TYPES } from '../constants/workflow';
+
+export const triggerTypeDtoSchema = z.enum(TRIGGER_TYPES);
+
+export const triggerDtoSchema = z.object({
+  id: z.string(),
+  definitionId: z.string(),
+  name: z.string(),
+  type: triggerTypeDtoSchema,
+  config: z.record(z.string(), z.unknown()),
+  enabled: z.boolean(),
+  lastTriggeredAt: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const createTriggerInputSchema = z.object({
+  definitionId: z.string(),
+  name: z.string(),
+  type: triggerTypeDtoSchema,
+  config: z.record(z.string(), z.unknown()),
+});
+
+export const updateTriggerInputSchema = createTriggerInputSchema.partial();