skill-engine(L4):载方法不载权力(白名单外工具即拒)、结晶片段经 ToolInvoker 留痕、 装配入信封、技能目录渐进披露 flow-engine(L5):四种步型、确定性谓词跳步、重试与声明给定的兜底、 异步步即监听(时限必配)、写类工具登记动作意向、步序位置持久 loop-engine(L5):自研 CMMN 子集解析器(表外构件直接报错,子集封顶可机器证明)、 两副标准生命周期与迁移拓扑(引擎不得私改)、Enabled ≠ Active、 语义性前提标待裁量评估(引擎不代裁量)、DMN 确定性求值 + 命中行留痕、 DRD 缺口演绎与拓扑序、双向驱动与交集导航(断点即人环)、三型行动、 终局唯放行与 Harness task(L6):终态五名裁定(released 唯一成功)、Harness 预算环外强制与停滞熔断 (监听中是健康态)、控制三语义(叫停不是终态,记最重档纠正)、改派留痕通知双方、 断点续跑三份持久状态、封卷触发蒸馏钩子 301 个测试通过,门禁五道全绿 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
87 lines
3.5 KiB
TypeScript
87 lines
3.5 KiB
TypeScript
/**
|
|
* module: task —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
|
|
*/
|
|
import type { BudgetCaps, Paradigm, StaffId, TaskId, TerminalState } from '@contracts';
|
|
import type { Consumption } from './internal/domain/harness.ts';
|
|
import type { Task } from './contract.ts';
|
|
|
|
export type Clock = { now(): Date };
|
|
export type IdGenerator = { next(): string };
|
|
|
|
export type TaskStore = {
|
|
insert(task: Task): Promise<void>;
|
|
get(taskId: TaskId): Promise<Task | undefined>;
|
|
listByOwner(ownerId: StaffId, openOnly: boolean): Promise<Task[]>;
|
|
update(taskId: TaskId, patch: Partial<Task>): Promise<Task>;
|
|
addConsumption(taskId: TaskId, delta: Partial<Consumption>): Promise<Consumption>;
|
|
lastProgressAt(taskId: TaskId): Promise<Date | undefined>;
|
|
markProgress(taskId: TaskId, at: Date): Promise<void>;
|
|
};
|
|
|
|
/** 活动装载 —— app 注入 `activity-registry`(L4) */
|
|
export type ActivityLoader = {
|
|
load(activityId: string): Promise<{
|
|
paradigm: Paradigm;
|
|
caps: BudgetCaps;
|
|
envelope: Record<string, unknown>;
|
|
/** 输入 data 的 JSON Schema —— 缺项不得启动 */
|
|
inputSchema: Record<string, unknown>;
|
|
businessModel: unknown;
|
|
stallAfter: string;
|
|
}>;
|
|
};
|
|
|
|
export type SchemaValidator = {
|
|
validate(schema: Record<string, unknown>, value: unknown): { ok: boolean; errors: string[] };
|
|
};
|
|
|
|
/** 范式引擎 —— loop / flow 在此汇流;对上层不可区分(§9 双层边界) */
|
|
export type ParadigmEngine = {
|
|
load(taskId: TaskId, model: unknown): Promise<void>;
|
|
advance(taskId: TaskId): Promise<{ status: 'running' | 'awaiting' | 'submitted' | 'finished' | 'blocked'; reason?: string }>;
|
|
onEvent(
|
|
taskId: TaskId,
|
|
event: { kind: 'data' | 'time' | 'human' | 'control'; ref: string; payload: Record<string, unknown> },
|
|
): Promise<{ status: 'running' | 'awaiting' | 'submitted' | 'finished' | 'blocked'; reason?: string }>;
|
|
};
|
|
|
|
export type MemoryRecorder = {
|
|
append(input: {
|
|
taskId: TaskId;
|
|
kind: 'engine-transition' | 'terminal' | 'observation';
|
|
title: string;
|
|
detail?: Record<string, unknown>;
|
|
}): Promise<void>;
|
|
seal(taskId: TaskId): Promise<void>;
|
|
/** 终态封卷触发蒸馏钩子 —— 产出活动记忆候选条目 */
|
|
distill(input: { taskId: TaskId; activityId: string; trigger: 'terminal'; prompt: string }): Promise<unknown>;
|
|
hasHistory(taskId: TaskId): Promise<boolean>;
|
|
};
|
|
|
|
/** 监听在等?—— app 注入 `event`(L1):监听中是健康态,与停滞分别对待 */
|
|
export type ListenerProbe = {
|
|
hasArmedListener(taskId: TaskId): Promise<boolean>;
|
|
};
|
|
|
|
/** 草稿层与运行时状态是否在 —— 断点续跑的三份持久状态 */
|
|
export type PersistenceProbe = {
|
|
hasDrafts(taskId: TaskId): Promise<boolean>;
|
|
hasRuntimeState(taskId: TaskId): Promise<boolean>;
|
|
};
|
|
|
|
/** 控制事件与终态事件 —— app 注入 `event`(L1) */
|
|
export type TaskEventPublisher = {
|
|
publishControl(taskId: TaskId, semantic: string, by: StaffId, reason?: string): Promise<void>;
|
|
publishTerminal(taskId: TaskId, terminal: TerminalState, reason: string): Promise<void>;
|
|
};
|
|
|
|
/** 改派通知 —— app 注入 `message`(L2):改派留痕并**通知双方** */
|
|
export type ReassignNotifier = {
|
|
notify(input: { from: StaffId; to: StaffId; taskId: TaskId; title: string; by: StaffId }): Promise<void>;
|
|
};
|
|
|
|
/** 交互态 —— app 注入 `interaction`(L3):控制权按态转交 */
|
|
export type InteractionPhaseSetter = {
|
|
setPhase(taskId: TaskId, phase: 'activating' | 'active' | 'awaiting-human' | 'awaiting-event' | 'transitioning' | 'terminal'): Promise<void>;
|
|
};
|