@aalis/api-workflow 0.11.0 → 0.13.0
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/index.d.ts +22 -11
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +6 -3
package/dist/index.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { TextRef } from '@aalis/schema-i18n';
|
|
1
2
|
export type TriggerSpec = {
|
|
2
3
|
type: 'cron';
|
|
3
4
|
expr: string;
|
|
@@ -57,10 +58,8 @@ export interface AgentNodeSpec extends BaseNodeSpec {
|
|
|
57
58
|
instruction: string;
|
|
58
59
|
/**
|
|
59
60
|
* 目标会话 id；支持插值。省略时为本节点生成一次性隔离子会话
|
|
60
|
-
* （`workflow
|
|
61
|
-
*
|
|
62
|
-
* ⚠️ 同一并行层内**不要**让多个 agent 节点指向**相同的显式 sessionId**：`agent:turn:after`
|
|
63
|
-
* 按 sessionId 匹配回复，会发生串扰捕获（A 可能拿到 B 的回复）。需要隔离子任务就省略本字段。
|
|
61
|
+
* （`workflow::<runId>::<nodeId>`，不含单冒号，不会被当成房间会话），适合"子任务"语义（推荐）。指令在目标会话里单独成一轮，
|
|
62
|
+
* 排在那里在跑的一轮之后；指向调起这次运行的会话时节点立即失败（那一轮在等这次运行，节点开不了轮）
|
|
64
63
|
*/
|
|
65
64
|
sessionId?: string;
|
|
66
65
|
/** 平台标识；默认 'workflow' */
|
|
@@ -95,8 +94,8 @@ export interface NodeRunInfo {
|
|
|
95
94
|
finishedAt?: number;
|
|
96
95
|
/** 节点输出（截断后的字符串展示） */
|
|
97
96
|
output?: string;
|
|
98
|
-
/**
|
|
99
|
-
error?: string;
|
|
97
|
+
/** 失败原因：可以是文字对象（读法同 {@link WorkflowRun.error}） */
|
|
98
|
+
error?: string | TextRef;
|
|
100
99
|
}
|
|
101
100
|
export interface WorkflowRun {
|
|
102
101
|
runId: string;
|
|
@@ -110,15 +109,22 @@ export interface WorkflowRun {
|
|
|
110
109
|
vars: Record<string, unknown>;
|
|
111
110
|
/** 节点运行明细 */
|
|
112
111
|
nodes: NodeRunInfo[];
|
|
113
|
-
/**
|
|
114
|
-
|
|
112
|
+
/**
|
|
113
|
+
* 整体错误（首个失败的简要）：可以是文字对象（@aalis/schema-i18n），给人看的经出口按读者语言渲染，交给模型与写日志的
|
|
114
|
+
* 取 toSource；随运行历史落盘
|
|
115
|
+
*/
|
|
116
|
+
error?: string | TextRef;
|
|
115
117
|
}
|
|
116
118
|
export interface WorkflowService {
|
|
117
119
|
/** 列出全部工作流定义 */
|
|
118
120
|
listWorkflows(): WorkflowDef[];
|
|
119
121
|
/** 按 id 获取定义 */
|
|
120
122
|
getWorkflow(id: string): WorkflowDef | undefined;
|
|
121
|
-
/**
|
|
123
|
+
/**
|
|
124
|
+
* 注册/覆盖一个工作流定义；persist 不为 false 时（缺省即写）同步写入 workspace/workflows/<id>.yaml。
|
|
125
|
+
* 经这里定义或覆盖的没有定义者（运行身份见 {@link WorkflowService.runWorkflow}）：服务认不出调用方是谁，定义者只由实现
|
|
126
|
+
* 自己认证过调用者的入口记下。event 触发器订阅不可作触发源的事件（负载带会话内容，列表由实现定）时抛错、不保存
|
|
127
|
+
*/
|
|
122
128
|
defineWorkflow(def: WorkflowDef, opts?: {
|
|
123
129
|
persist?: boolean;
|
|
124
130
|
}): Promise<void>;
|
|
@@ -126,10 +132,15 @@ export interface WorkflowService {
|
|
|
126
132
|
removeWorkflow(id: string): Promise<boolean>;
|
|
127
133
|
/** 手动触发一次运行；vars 与定义中的 vars 浅合并 */
|
|
128
134
|
runWorkflow(id: string, vars?: Record<string, unknown>, triggerSource?: string,
|
|
129
|
-
/**
|
|
135
|
+
/**
|
|
136
|
+
* 调用者身份（缺省=匿名）。内部工具与投递的消息按定义者与调用者里不是 owner 的一方裁决：调用者是 owner 时取定义者
|
|
137
|
+
* （没有即匿名），否则取调用者。定时与事件触发以定义者作调用者。sessionId 是调起这次运行的会话（经 workflow_run 调起时
|
|
138
|
+
* 有）：它所在的一轮在等这次运行，指向它的 agent 节点立即失败
|
|
139
|
+
*/
|
|
130
140
|
caller?: {
|
|
131
141
|
platform?: string;
|
|
132
142
|
userId?: string;
|
|
143
|
+
sessionId?: string;
|
|
133
144
|
}): Promise<WorkflowRun>;
|
|
134
145
|
/** 取消一个运行中的实例（若执行引擎支持） */
|
|
135
146
|
cancelRun(runId: string): boolean;
|
|
@@ -162,6 +173,6 @@ declare module '@aalis/core' {
|
|
|
162
173
|
}];
|
|
163
174
|
}
|
|
164
175
|
}
|
|
165
|
-
export declare const workflow: import("@aalis/core").ServiceDescriptor<WorkflowService,
|
|
176
|
+
export declare const workflow: import("@aalis/core").ServiceDescriptor<WorkflowService, WorkflowService>;
|
|
166
177
|
export {};
|
|
167
178
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA4M5C,oCAAoC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAkB,UAAU,CAAC,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aalis/api-workflow",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -18,13 +18,16 @@
|
|
|
18
18
|
"files": [
|
|
19
19
|
"dist"
|
|
20
20
|
],
|
|
21
|
+
"dependencies": {
|
|
22
|
+
"@aalis/schema-i18n": ">=0.1.0 <1.0.0"
|
|
23
|
+
},
|
|
21
24
|
"devDependencies": {
|
|
22
25
|
"@types/node": "^22.0.0",
|
|
23
26
|
"typescript": "^5.7.0",
|
|
24
|
-
"@aalis/core": "0.
|
|
27
|
+
"@aalis/core": "0.21.0"
|
|
25
28
|
},
|
|
26
29
|
"peerDependencies": {
|
|
27
|
-
"@aalis/core": ">=0.
|
|
30
|
+
"@aalis/core": ">=0.21.0 <1.0.0"
|
|
28
31
|
},
|
|
29
32
|
"keywords": [
|
|
30
33
|
"aalis",
|