@njuptlzf/agent-chat-server 0.3.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/authz.d.ts +9 -9
- package/dist/authz.js +6 -1
- package/dist/checkpoint-store.d.ts +78 -0
- package/dist/checkpoint-store.js +52 -0
- package/dist/components.d.ts +15 -0
- package/dist/components.js +50 -0
- package/dist/extension-admission.d.ts +32 -0
- package/dist/extension-admission.js +155 -0
- package/dist/flows.d.ts +49 -0
- package/dist/flows.js +208 -0
- package/dist/ledger.d.ts +90 -0
- package/dist/ledger.js +130 -0
- package/dist/main.js +14 -2
- package/dist/manifest.js +14 -1
- package/dist/orchestrator/engine.d.ts +132 -0
- package/dist/orchestrator/engine.js +1 -0
- package/dist/orchestrator/engines/fake.d.ts +14 -0
- package/dist/orchestrator/engines/fake.js +282 -0
- package/dist/orchestrator/engines/taskflow.d.ts +4 -0
- package/dist/orchestrator/engines/taskflow.js +541 -0
- package/dist/orchestrator/run-spec.d.ts +154 -0
- package/dist/orchestrator/run-spec.js +11 -0
- package/dist/server.d.ts +21 -2
- package/dist/server.js +543 -187
- package/dist/sqlite-stores.d.ts +46 -6
- package/dist/sqlite-stores.js +297 -33
- package/dist/stores.d.ts +3 -34
- package/dist/stores.js +0 -27
- package/dist/testing.d.ts +5 -4
- package/dist/testing.js +5 -4
- package/package.json +7 -6
- package/scripts/agentchat-integrate.mjs +853 -853
- package/src/authz.ts +15 -8
- package/src/checkpoint-store.ts +122 -0
- package/src/components.ts +66 -0
- package/src/extension-admission.ts +131 -0
- package/src/flows.ts +244 -0
- package/src/ledger.ts +193 -0
- package/src/main.ts +16 -2
- package/src/manifest.ts +14 -1
- package/src/orchestrator/engine.ts +134 -0
- package/src/orchestrator/engines/fake.ts +330 -0
- package/src/orchestrator/engines/taskflow.ts +626 -0
- package/src/orchestrator/run-spec.ts +171 -0
- package/src/server.ts +553 -183
- package/src/session.ts +689 -689
- package/src/sqlite-stores.ts +347 -35
- package/src/stores.ts +3 -39
- package/src/testing.ts +4 -4
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 编排层的**平台类型**(M-14 / R-010)。
|
|
3
|
+
*
|
|
4
|
+
* 这一层的契约由平台定义,**不 import 任何引擎实现的类型**(纪律 E1)。
|
|
5
|
+
* 理由不是洁癖:`RunSpec` 要承载产品 manifest、`run_jobs` 表、SSE 事件协议——
|
|
6
|
+
* 若直接用某个引擎库的 schema,它改一次字段我们就要迁产品和数据。
|
|
7
|
+
*
|
|
8
|
+
* 引擎实现(`engines/*.ts`)只许认这里的类型 + `EngineDeps`;
|
|
9
|
+
* 反向(本文件 import 引擎库)由 `boundary.test.ts` 的源码扫描拦下。
|
|
10
|
+
*
|
|
11
|
+
* 一句话边界:**RunSpec 是产品契约,PhaseSpec 是它的最小可执行单元,
|
|
12
|
+
* JobSpec 是一次子会话的输入。** 三者都不含任何引擎特有概念。
|
|
13
|
+
*/
|
|
14
|
+
import type { TokenUsage } from "@njuptlzf/agent-chat-protocol";
|
|
15
|
+
|
|
16
|
+
/** 四类 phase。刻意只收这四种——引擎库里别种 kind 在 `validate` 阶段拒绝。 */
|
|
17
|
+
export const PHASE_KINDS = ["agent", "parallel", "gate", "reduce"] as const;
|
|
18
|
+
export type PhaseKind = (typeof PHASE_KINDS)[number];
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* 单次子会话的输入。**不含模型、凭据、session 句柄**——那些由 `EngineDeps.runJob`
|
|
22
|
+
* 背后的宿主装配决定,编排层不认识 pi。
|
|
23
|
+
*/
|
|
24
|
+
export interface JobSpec {
|
|
25
|
+
/** 成员/人格 id(产品 manifest 里声明的那个)。 */
|
|
26
|
+
readonly persona: string;
|
|
27
|
+
/** 交给这个 agent 的任务文本。 */
|
|
28
|
+
readonly task: string;
|
|
29
|
+
/**
|
|
30
|
+
* 工具白名单。**只能比父级更窄**(不变量 I2):越界即 `invalid_request`,
|
|
31
|
+
* 由 `validate` 在消耗任何 token 之前拒绝。
|
|
32
|
+
*/
|
|
33
|
+
readonly tools?: readonly string[];
|
|
34
|
+
/** 单次子会话的墙钟上限(毫秒)。缺省沿用宿主默认。 */
|
|
35
|
+
readonly timeoutMs?: number;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** 一个 phase:DAG 的节点。 */
|
|
39
|
+
export interface PhaseSpec {
|
|
40
|
+
readonly id: string;
|
|
41
|
+
readonly kind: PhaseKind;
|
|
42
|
+
/** 依赖的 phase id。空/缺省 = 入口。 */
|
|
43
|
+
readonly dependsOn?: readonly string[];
|
|
44
|
+
/**
|
|
45
|
+
* `kind === "agent"` / `kind === "reduce"` 时必填(reduce 用它指定「谁来汇总」)。
|
|
46
|
+
* `kind === "parallel"` 时用 `branches` 代替。
|
|
47
|
+
*
|
|
48
|
+
* `kind === "gate"` 目前**恒被拒**:gate 要的是「这个 phase 算通过吗」的判定规则,
|
|
49
|
+
* 那属于产品业务语义(及格线、必含项),平台不猜。等真实产品需求定下形状再加。
|
|
50
|
+
*/
|
|
51
|
+
readonly job?: JobSpec;
|
|
52
|
+
/**
|
|
53
|
+
* `kind === "parallel"` 的 fan-out 分支:各自跑一个子会话,全部完成后 phase 收口。
|
|
54
|
+
* 每个分支是一个完整 `JobSpec`(可带自己的 persona 与 tools)。
|
|
55
|
+
*
|
|
56
|
+
* **并发数不由这里控制**——由 `RunSpec.concurrency` 统一管(见该字段注释)。
|
|
57
|
+
*/
|
|
58
|
+
readonly branches?: readonly JobSpec[];
|
|
59
|
+
/**
|
|
60
|
+
* `kind === "reduce"` 的输入来源:若干已完成的 phase id。
|
|
61
|
+
* 它们各自的输出会被聚合后喂给 `job.task`(聚合格式由引擎定,见引擎注释)。
|
|
62
|
+
*/
|
|
63
|
+
readonly from?: readonly string[];
|
|
64
|
+
/** 是否作为 Run 的最终输出来源。多个标 `final` 时取最后一个完成的(引擎定)。 */
|
|
65
|
+
readonly final?: boolean;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/** Run 级预算。超限时引擎在派发**下一个** job 前停下,并标记 `budget_exhausted`。 */
|
|
69
|
+
export interface Budget {
|
|
70
|
+
/** 全 Run 的 token 上界(input + output)。 */
|
|
71
|
+
readonly maxTokens?: number;
|
|
72
|
+
/** 全 Run 的花费上界(美分)。 */
|
|
73
|
+
readonly maxCostCents?: number;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* 一次 Run 的输入。档 1 = `phases.length === 1`,不分两套代码。
|
|
78
|
+
*/
|
|
79
|
+
export interface RunSpec {
|
|
80
|
+
readonly runId: string;
|
|
81
|
+
readonly phases: readonly PhaseSpec[];
|
|
82
|
+
readonly budget?: Budget;
|
|
83
|
+
/**
|
|
84
|
+
* 同时在跑的子会话上限。单 phase 时无意义;`parallel` phase 的 fan-out 用它。
|
|
85
|
+
* 缺省由引擎定(taskflow 的默认值 8)。
|
|
86
|
+
*
|
|
87
|
+
* **与 pi worker 队列的口径(T1 已厘清)**:pi 的 `PI_CODEMODE_MAX_WORKERS`
|
|
88
|
+
* 约束的是**单个 pi 会话进程内**的 codemode 脚本 / 进程内 subagent 排队。
|
|
89
|
+
* 本仓的编排是**每个 job 各建一个独立 pi session**(见 server.ts 的
|
|
90
|
+
* `runMemberJob`),并发单位是这个上层 session,不进任何单个 pi 的 worker
|
|
91
|
+
* 池——所以两者不是同一个队列,无需取 min。这里才是唯一的并发闸门,
|
|
92
|
+
* taskflow 按它 `mapWithConcurrencyLimit` 派发;I4 的预算/配额在派发前预留,
|
|
93
|
+
* 不因 pi 内部排队失真。
|
|
94
|
+
*/
|
|
95
|
+
readonly concurrency?: number;
|
|
96
|
+
/**
|
|
97
|
+
* 断点续跑:已完成 phase 的产物(来自上一次中断的 checkpoint)。
|
|
98
|
+
*
|
|
99
|
+
* **空/缺省 = 全新 Run**。命中这里的 phase 直接取产物、**不重新调用 `runJob`**
|
|
100
|
+
* (I7)——不重复花 token、不重复扣费。键是 `phaseId`。
|
|
101
|
+
*
|
|
102
|
+
* 语义边界:checkpoint 是「上一次已经付过钱的产物」,引擎不去校验它是否还
|
|
103
|
+
* 符合当前 `JobSpec`(那需要内容哈希,属于产品层的事)。宿主负责只喂可信来源。
|
|
104
|
+
*/
|
|
105
|
+
readonly resumeFrom?: Readonly<Record<string, PhaseCheckpoint>>;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* 一个已完成 phase 的断点产物。刻意只留**三样**:
|
|
110
|
+
* 产物本身、它的 usage(I3 要能加总)、以及完成时间(对账/诊断)。
|
|
111
|
+
*
|
|
112
|
+
* 不含 `JobSpec` 的快照——那会让「改了流程定义还能不能续跑」变成一个隐式问题;
|
|
113
|
+
* 现在的答案很明确:**resume 只恢复产物,不恢复定义**。定义永远是本次 `RunSpec` 的。
|
|
114
|
+
*/
|
|
115
|
+
export interface PhaseCheckpoint {
|
|
116
|
+
readonly phaseId: string;
|
|
117
|
+
/** 该 phase 的产物文本。 */
|
|
118
|
+
readonly output: string;
|
|
119
|
+
/** 该 phase 已消耗的 usage(续跑时计入 Run 总量,账才对得上)。 */
|
|
120
|
+
readonly usage: TokenUsage;
|
|
121
|
+
/** 该 phase 完成时刻(毫秒时间戳)。 */
|
|
122
|
+
readonly at: number;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/** 静态验证报告。**零 token、零 I/O**,用于 I1。 */
|
|
126
|
+
export interface ValidationReport {
|
|
127
|
+
readonly ok: boolean;
|
|
128
|
+
readonly errors: readonly string[];
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/** Job 六态。与 `run_jobs.state` 列一一对应。 */
|
|
132
|
+
export const JOB_STATES = [
|
|
133
|
+
"queued",
|
|
134
|
+
"running",
|
|
135
|
+
"completed",
|
|
136
|
+
"failed",
|
|
137
|
+
"stopped",
|
|
138
|
+
"blocked",
|
|
139
|
+
] as const;
|
|
140
|
+
export type JobState = (typeof JOB_STATES)[number];
|
|
141
|
+
|
|
142
|
+
/** 单个 job 的结局。 */
|
|
143
|
+
export interface JobOutcome {
|
|
144
|
+
readonly jobId: string;
|
|
145
|
+
/** 所属 phase。多 phase 的 `run_jobs` 表按它分组;单 phase 恒为 `"chat"`。 */
|
|
146
|
+
readonly phaseId: string;
|
|
147
|
+
readonly state: JobState;
|
|
148
|
+
/** 产出文本。`failed` / `stopped` 时为空串。 */
|
|
149
|
+
readonly output: string;
|
|
150
|
+
/** 这个 job 实际消耗;`Engine` 负责归总到 Run(I3)。 */
|
|
151
|
+
readonly usage: TokenUsage;
|
|
152
|
+
readonly stopReason: string;
|
|
153
|
+
/** 这一 job 内部的重试次数(模型切换等),由 `runJob` 报告。 */
|
|
154
|
+
readonly attempts?: number;
|
|
155
|
+
/** `failed` 时的可读原因。 */
|
|
156
|
+
readonly error?: string;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** 一次 Run 的结局。 */
|
|
160
|
+
export interface RunOutcome {
|
|
161
|
+
readonly runId: string;
|
|
162
|
+
readonly state: Exclude<JobState, "queued" | "running">;
|
|
163
|
+
/** 最终输出(取 `final` 标记者;未标记则取最后一个完成的 phase)。 */
|
|
164
|
+
readonly output: string;
|
|
165
|
+
/** 全部 job 加总(I3:一请求一账本)。 */
|
|
166
|
+
readonly usage: TokenUsage;
|
|
167
|
+
readonly jobs: readonly JobOutcome[];
|
|
168
|
+
/** 各 phase 的断点产物。宿主据此写 checkpoint,`resumeFrom` 从同一处读回(I7)。 */
|
|
169
|
+
readonly checkpoints?: readonly PhaseCheckpoint[];
|
|
170
|
+
readonly error?: string;
|
|
171
|
+
}
|