Archived
JCAI Main AgentandClaude Opus 5
3c974d2860
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
94 lines
3.3 KiB
TypeScript
94 lines
3.3 KiB
TypeScript
/**
|
|
* module: loop-engine —— 本模块要外界提供的能力(编码规范 §10.1 / §5.3)。
|
|
*/
|
|
import type { LoopModel, StaffId, TaskId } from '@contracts';
|
|
import type { CaseModel } from './internal/domain/cmmn-parse.ts';
|
|
import type { CaseRuntime, EnabledSet } from './internal/domain/lifecycle.ts';
|
|
import type { AgentAction } from './contract.ts';
|
|
|
|
export type Clock = { now(): Date };
|
|
|
|
/** 运行时实例状态 —— loop 的模型定位与就绪集(OS 09 三份持久状态之一) */
|
|
export type LoopStateStore = {
|
|
save(taskId: TaskId, model: LoopModel, parsed: CaseModel, runtime: CaseRuntime): Promise<void>;
|
|
load(taskId: TaskId): Promise<{ model: LoopModel; parsed: CaseModel; runtime: CaseRuntime } | undefined>;
|
|
};
|
|
|
|
/** S-FEEL —— app 注入 `@sfeel`;引擎零 LLM */
|
|
export type Sfeel = {
|
|
condition(expression: string, scope: Readonly<Record<string, unknown>>): boolean;
|
|
expression(expression: string, scope: Readonly<Record<string, unknown>>): unknown;
|
|
unaryTest(cell: string, value: unknown, scope: Readonly<Record<string, unknown>>): boolean;
|
|
};
|
|
|
|
/** 任务数据 —— app 注入 `ledger`(L1):引擎对**任务视图**求值,不依赖事件 */
|
|
export type TaskDataGateway = {
|
|
view(taskId: TaskId): Promise<Record<string, unknown>>;
|
|
draftWrite(input: {
|
|
taskId: TaskId;
|
|
domain: string;
|
|
object: string;
|
|
key: Record<string, string | number>;
|
|
patch: Record<string, unknown>;
|
|
}): Promise<void>;
|
|
};
|
|
|
|
/**
|
|
* Agent 回路 —— app 注入(Mastra Agent 在 adapter,§6.1)。
|
|
* **回合由 usecase 驱动,不放开自由 maxSteps,预算在环外由 Harness 强制。**
|
|
*/
|
|
export type AgentPort = {
|
|
decide(input: {
|
|
taskId: TaskId;
|
|
/** 叙事面:说明书 + 活动记忆选摘 + 任务记忆窗口 */
|
|
narrative: string;
|
|
enabled: EnabledSet;
|
|
scope: Record<string, unknown>;
|
|
}): Promise<AgentAction>;
|
|
};
|
|
|
|
/** 工具 / 人类工具 / 监听 —— 三型行动的落点 */
|
|
export type ToolGateway = {
|
|
invoke(input: { tool: string; input: Record<string, unknown>; activityId: string; taskId: TaskId }): Promise<{
|
|
ok: boolean;
|
|
output?: Record<string, unknown>;
|
|
error?: { message: string };
|
|
}>;
|
|
isWriteEffect(tool: string): Promise<boolean>;
|
|
registerIntent(input: { taskId: TaskId; tool: string; input: Record<string, unknown>; label: string }): Promise<void>;
|
|
};
|
|
|
|
export type CardGateway = {
|
|
issue(input: {
|
|
taskId: TaskId;
|
|
ownerId: StaffId;
|
|
humanCallCap: number;
|
|
workOrder: 'execution' | 'acceptance';
|
|
card: Record<string, unknown>;
|
|
}): Promise<{ id: string }>;
|
|
};
|
|
|
|
export type ListenerRegistrar = {
|
|
register(input: {
|
|
taskId: TaskId;
|
|
eventType: 'data' | 'time' | 'human';
|
|
keyFilter: Record<string, string>;
|
|
deadline: string;
|
|
}): Promise<{ id: string }>;
|
|
};
|
|
|
|
export type MemoryRecorder = {
|
|
append(input: {
|
|
taskId: TaskId;
|
|
kind: 'engine-transition' | 'evaluation' | 'thought' | 'action' | 'result' | 'observation';
|
|
title: string;
|
|
detail?: Record<string, unknown>;
|
|
}): Promise<void>;
|
|
/** 装载:按定位选摘活动记忆入 Agent 上下文(渐进披露) */
|
|
loadActivityMemory(activityId: string, limit: number): Promise<Array<{ layer: string; statement: string }>>;
|
|
};
|
|
|
|
export type TaskContext = {
|
|
of(taskId: TaskId): Promise<{ activityId: string; ownerId: StaffId; humanCallCap: number }>;
|
|
};
|