@ftai/plugin-host-api 0.0.0-stage → 2.0.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/LICENSE +21 -0
- package/README.md +4 -2
- package/lib/attachments.d.ts +38 -0
- package/lib/attachments.js +26 -0
- package/lib/fs.d.ts +53 -0
- package/lib/fs.js +14 -0
- package/lib/generated.d.ts +579 -0
- package/lib/generated.js +20 -0
- package/lib/index.d.ts +369 -0
- package/lib/index.js +110 -0
- package/lib/llm.d.ts +152 -0
- package/lib/llm.js +102 -0
- package/lib/porting.d.ts +35 -0
- package/lib/porting.js +127 -0
- package/package.json +40 -3
package/lib/llm.js
ADDED
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
/** 模型层的失败(同 0.12):没有这条路由是 `NO_ADAPTER`,路由里没有这个模型是 `UNKNOWN_MODEL`。 */
|
|
2
|
+
export class LlmError extends Error {
|
|
3
|
+
code;
|
|
4
|
+
failure;
|
|
5
|
+
constructor(message, code, options) {
|
|
6
|
+
super(message, options);
|
|
7
|
+
this.code = code;
|
|
8
|
+
this.name = 'LlmError';
|
|
9
|
+
this.failure = { message, code };
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* 把流式输出拼成完整的内容块(同 0.12 的 `BlockAssembler`)。也接受只有增量、没有 `block-start` / `block-end` 的流;
|
|
14
|
+
* 一块已经由 `block-end` 结束后,同一个序号再来的增量忽略。
|
|
15
|
+
*/
|
|
16
|
+
export class BlockAssembler {
|
|
17
|
+
partials = new Map();
|
|
18
|
+
order = [];
|
|
19
|
+
finishReason;
|
|
20
|
+
reportedUsage;
|
|
21
|
+
/** 按流的顺序送进一块。 */
|
|
22
|
+
push(chunk) {
|
|
23
|
+
switch (chunk.type) {
|
|
24
|
+
case 'block-start':
|
|
25
|
+
this.ensure(chunk.index, chunk.blockType);
|
|
26
|
+
return;
|
|
27
|
+
case 'text-delta':
|
|
28
|
+
case 'reasoning-delta': {
|
|
29
|
+
const partial = this.ensure(chunk.index, chunk.type === 'text-delta' ? 'text' : 'reasoning');
|
|
30
|
+
if (partial.block === undefined)
|
|
31
|
+
partial.text += chunk.text;
|
|
32
|
+
return;
|
|
33
|
+
}
|
|
34
|
+
case 'tool-call-delta': {
|
|
35
|
+
const partial = this.ensure(chunk.index, 'tool-call');
|
|
36
|
+
if (partial.block !== undefined)
|
|
37
|
+
return;
|
|
38
|
+
partial.toolCallId = chunk.id;
|
|
39
|
+
if (chunk.name)
|
|
40
|
+
partial.toolCallName = chunk.name;
|
|
41
|
+
partial.toolCallArguments += chunk.argumentsDelta;
|
|
42
|
+
return;
|
|
43
|
+
}
|
|
44
|
+
case 'block-end': {
|
|
45
|
+
const partial = this.ensure(chunk.index, chunk.block.type);
|
|
46
|
+
partial.block ??= chunk.block;
|
|
47
|
+
return;
|
|
48
|
+
}
|
|
49
|
+
case 'usage':
|
|
50
|
+
this.reportedUsage = chunk.usage;
|
|
51
|
+
return;
|
|
52
|
+
case 'finish':
|
|
53
|
+
this.finishReason = chunk.reason;
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
/** 到目前为止的全部块,按流的顺序;因输出上限截断时去掉工具调用(执行不了)。还没结束的块按已到的增量拼出。 */
|
|
58
|
+
blocks() {
|
|
59
|
+
const blocks = this.order.map(index => this.assemble(index));
|
|
60
|
+
return this.finish.kind === 'max-tokens' ? blocks.filter(block => block.type !== 'tool-call') : blocks;
|
|
61
|
+
}
|
|
62
|
+
/** 流被中断时能保留的部分:有非空白内容的文本与推理块,按流的顺序;工具调用不保留。 */
|
|
63
|
+
interruptedBlocks() {
|
|
64
|
+
return this.order.flatMap((index) => {
|
|
65
|
+
const partial = this.partials.get(index);
|
|
66
|
+
const type = partial.block?.type ?? partial.blockType;
|
|
67
|
+
if (type !== 'text' && type !== 'reasoning')
|
|
68
|
+
return [];
|
|
69
|
+
const block = this.assemble(index);
|
|
70
|
+
return (block.type === 'text' || block.type === 'reasoning') && block.text.trim() !== '' ? [block] : [];
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
/** `usage` 块给出的用量;还没到时为 undefined。 */
|
|
74
|
+
get usage() {
|
|
75
|
+
return this.reportedUsage;
|
|
76
|
+
}
|
|
77
|
+
/** `finish` 块给出的结束原因;流没有 `finish` 块就结束时是 `{ kind: 'stop' }`。 */
|
|
78
|
+
get finish() {
|
|
79
|
+
return this.finishReason ?? { kind: 'stop' };
|
|
80
|
+
}
|
|
81
|
+
ensure(index, blockType) {
|
|
82
|
+
let partial = this.partials.get(index);
|
|
83
|
+
if (partial === undefined) {
|
|
84
|
+
partial = { blockType, text: '', toolCallArguments: '' };
|
|
85
|
+
this.partials.set(index, partial);
|
|
86
|
+
this.order.push(index);
|
|
87
|
+
}
|
|
88
|
+
return partial;
|
|
89
|
+
}
|
|
90
|
+
assemble(index) {
|
|
91
|
+
const partial = this.partials.get(index);
|
|
92
|
+
if (partial.block !== undefined)
|
|
93
|
+
return partial.block;
|
|
94
|
+
switch (partial.blockType) {
|
|
95
|
+
case 'text': return { type: 'text', text: partial.text };
|
|
96
|
+
case 'reasoning': return { type: 'reasoning', text: partial.text };
|
|
97
|
+
case 'tool-call': return { type: 'tool-call', id: partial.toolCallId ?? `call-${String(index)}`, name: partial.toolCallName ?? '', arguments: partial.toolCallArguments };
|
|
98
|
+
default: throw new Error(`cannot assemble incomplete block of type "${partial.blockType}"`);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
//# sourceMappingURL=llm.js.map
|
package/lib/porting.d.ts
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 对照表:0.12 写法(0.12 插件契约)的每项服务、扩展点与常用函数在 SDK 2.0 里的对应(docs/rust-host/architecture.md
|
|
3
|
+
* 「移植路径」)。插件契约文档里的对照表、codemod 的改写与插件运行时加载失败的提示都取自这里。
|
|
4
|
+
*
|
|
5
|
+
* 覆盖面由测试守住:0.12 契约的 17 项服务、现有 TS 插件与 0.12 模板用到的全部 0.12 导出、服务、成员与扩展点都要有一行
|
|
6
|
+
* (tests/porting-table.test.ts);写着 SDK 对应名字的行,SDK 里要真有这个导出。
|
|
7
|
+
*
|
|
8
|
+
* 表里的 `@deepseek-ai/*` 是 0.12 插件里写的旧包名,仓库已不依赖这些包:留着是为了给按 0.12 写的第三方插件指出对应,
|
|
9
|
+
* codemod 也要按它们认出要改写的引用。
|
|
10
|
+
* @module @ftai/plugin-host-api/porting
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* - `same`:同名同形,换 import 即可(codemod 自动改);
|
|
14
|
+
* - `changed`:形状有变,`note` 写改法(codemod 只插 TODO,不改写);
|
|
15
|
+
* - `removed`:不再提供,`note` 写替代;
|
|
16
|
+
* - `pending`:宿主还没有提供,`note` 写由哪条线、哪一批提供;在此之前用到它的插件加载失败。
|
|
17
|
+
*/
|
|
18
|
+
export type PortingStatus = 'same' | 'changed' | 'removed' | 'pending';
|
|
19
|
+
export interface PortingEntry {
|
|
20
|
+
/**
|
|
21
|
+
* 0.12 一侧:服务写成 `ctx.<服务名>`,服务的成员写成 `ctx.<服务名>.<成员>`,扩展点写成它的名字(如 `tools/pre-execute`),
|
|
22
|
+
* 包的导出写成 `<包名>#<导出名>`(默认导出写成 `<包名>#default`)。
|
|
23
|
+
*/
|
|
24
|
+
readonly legacy: string;
|
|
25
|
+
readonly status: PortingStatus;
|
|
26
|
+
/** SDK 一侧的对应:`@ftai/plugin-sdk/host#<导出名>`、`ctx.<服务名>`、`cordis#<导出名>` 或扩展点名;没有时不写。 */
|
|
27
|
+
readonly sdk?: string;
|
|
28
|
+
/** 改法、替代或由谁提供;同名同形时可以不写。 */
|
|
29
|
+
readonly note?: string;
|
|
30
|
+
/** 形状有变,但照 0.12 写的用法多数不用改(如载荷换成句柄、用法不变):codemod 不在用到它的地方插 TODO。 */
|
|
31
|
+
readonly todo?: false;
|
|
32
|
+
}
|
|
33
|
+
export declare const PORTING_TABLE: readonly PortingEntry[];
|
|
34
|
+
/** 按 0.12 一侧的名字查一行。 */
|
|
35
|
+
export declare function portingOf(legacy: string): PortingEntry | undefined;
|
package/lib/porting.js
ADDED
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 对照表:0.12 写法(0.12 插件契约)的每项服务、扩展点与常用函数在 SDK 2.0 里的对应(docs/rust-host/architecture.md
|
|
3
|
+
* 「移植路径」)。插件契约文档里的对照表、codemod 的改写与插件运行时加载失败的提示都取自这里。
|
|
4
|
+
*
|
|
5
|
+
* 覆盖面由测试守住:0.12 契约的 17 项服务、现有 TS 插件与 0.12 模板用到的全部 0.12 导出、服务、成员与扩展点都要有一行
|
|
6
|
+
* (tests/porting-table.test.ts);写着 SDK 对应名字的行,SDK 里要真有这个导出。
|
|
7
|
+
*
|
|
8
|
+
* 表里的 `@deepseek-ai/*` 是 0.12 插件里写的旧包名,仓库已不依赖这些包:留着是为了给按 0.12 写的第三方插件指出对应,
|
|
9
|
+
* codemod 也要按它们认出要改写的引用。
|
|
10
|
+
* @module @ftai/plugin-host-api/porting
|
|
11
|
+
*/
|
|
12
|
+
const HOST = '@ftai/plugin-sdk/host';
|
|
13
|
+
export const PORTING_TABLE = [
|
|
14
|
+
// ── 0.12 契约的 17 项服务 ──
|
|
15
|
+
{ legacy: 'ctx.tools', status: 'changed', sdk: 'ctx.tools', note: '`ctx.tools.register(defineTool({...}))` 照旧;工具定义只收 `name`、`description`、`parameters`、`output`、`execute`、`isConcurrencySafe`(只接受常量)、`needsApproval` 与 `sandboxEscalation`(新加:申请提权,见 `ctx.fs.sandboxMode` 一行),其余同步回调不再提供(见 `ToolDefinition` 一行)' },
|
|
16
|
+
{ legacy: 'ctx.tools.register', status: 'same', sdk: 'ctx.tools' },
|
|
17
|
+
{ legacy: 'ctx.tools.restrict', status: 'changed', note: '只能按 agent 收起:在 `agent/created` 里调用 `agent.ctx.tools.restrict(filter)`,随 agent 结束撤销' },
|
|
18
|
+
{ legacy: 'ctx.llm', status: 'changed', sdk: 'ctx.llm', note: '模型路由改为 `ctx.llm.registerRoute(route, credentials)`(0.12 的 `registerAdapter`);直接调用模型只有 `stream`(没有 `generate`,输出用 `BlockAssembler` 拼)与 `resolveModelInfo`' },
|
|
19
|
+
{ legacy: 'ctx.llm.registerAdapter', status: 'changed', sdk: 'ctx.llm', note: '改为 `ctx.llm.registerRoute(route, credentials)`:一个 provider 与它的模型清单,每次请求经回调向插件取地址与凭据;清单变了就撤销旧的注册、再注册一次' },
|
|
20
|
+
{ legacy: 'ctx.llm.stream', status: 'changed', sdk: 'ctx.llm', note: '`GenerateOptions` 只收插件直接调用用得到的字段(见 `GenerateOptions` 一行);模型不收图时图片换成占位文本、请求照发,同 0.12;不重试,失败是最后一个 `finish` 块' },
|
|
21
|
+
{ legacy: 'ctx.llm.resolveModelInfo', status: 'same', sdk: 'ctx.llm', note: '没有这个 provider 报 `NO_ADAPTER`,没有这个模型报 `UNKNOWN_MODEL`(`LlmError`)' },
|
|
22
|
+
{ legacy: 'ctx.agents', status: 'changed', sdk: 'ctx.agents', note: '`get(id)`、`list()` 给出 agent 的句柄(同一个 id 总是同一个对象),保留 `agent.id`、`agent.session`、`agent.ctx`;`agent.inject()` 宿主尚未提供(线 A Loop)' },
|
|
23
|
+
{ legacy: 'ctx.agents.get', status: 'changed', sdk: 'ctx.agents', note: '参数是会话 id 字符串(不再有 `SessionId` 包装),返回句柄或 undefined' },
|
|
24
|
+
{ legacy: 'ctx.systemPrompt', status: 'changed', sdk: 'ctx.systemPrompt', note: '`section({ name, order, text })` 只收静态文本;函数形式的段落改为在 `agent/created` 里经 `agent.ctx.systemPrompt.section()` 按 agent 注册;`system-prompt/assemble` 不再提供' },
|
|
25
|
+
{ legacy: 'ctx.systemPrompt.section', status: 'changed', sdk: 'ctx.systemPrompt', note: '`text` 只能是字符串' },
|
|
26
|
+
{ legacy: 'ctx.systemPrompt.getSectionOrder', status: 'removed', note: '`order` 直接写数字,照 0.12 的 `SECTION_ORDERS`(如 `MCP_SERVERS` 是 3100)' },
|
|
27
|
+
{ legacy: 'ctx.commands', status: 'pending', note: '斜杠命令:宿主尚未提供,归属待定' },
|
|
28
|
+
{ legacy: 'ctx.skills', status: 'pending', note: '线 B 第 4 批(skills)' },
|
|
29
|
+
{ legacy: 'ctx.sessions', status: 'changed', note: '插件记录改用 SDK 的 `appendPluginRecord()`(异步);读写会话日志的其余方法不再提供;导出会话日志改用内部 SDK 的 `ctx.sessionLog.read(sessionId)`(只给一方插件)' },
|
|
30
|
+
{ legacy: 'ctx.sessionProjections', status: 'changed', sdk: 'ctx.sessionProjections', note: '`register()` 照旧(reducer 在插件进程里运行);`stateOf()` 改为异步,加 `await`' },
|
|
31
|
+
{ legacy: 'ctx.sessionProjections.register', status: 'same', sdk: 'ctx.sessionProjections' },
|
|
32
|
+
{ legacy: 'ctx.sessionProjections.stateOf', status: 'changed', sdk: 'ctx.sessionProjections', note: '返回 Promise:`await ctx.sessionProjections.stateOf(session, key)`,所在的监听者改成 async' },
|
|
33
|
+
{ legacy: 'ctx.fs', status: 'changed', sdk: 'ctx.fs', note: '宿主上的操作中途取消不了(`signal` 在调用前后各查一次);写二进制改用 `ctx.fs.writeBytes(target, bytes, { execution, expected })`,宿主在写之前跑 `fs/write-intent`;没有 `sandboxMode`' },
|
|
34
|
+
{ legacy: 'ctx.fs.resolve', status: 'same', sdk: 'ctx.fs' },
|
|
35
|
+
{ legacy: 'ctx.fs.stat', status: 'same', sdk: 'ctx.fs' },
|
|
36
|
+
{ legacy: 'ctx.fs.readBytes', status: 'same', sdk: 'ctx.fs', note: '超过 `maxBytes` 报 `FS_TOO_LARGE`' },
|
|
37
|
+
{ legacy: 'ctx.fs.processPath', status: 'same', sdk: 'ctx.fs', note: '照旧是同步的;只认本进程 `ctx.fs.resolve()` 得到的目标' },
|
|
38
|
+
{ legacy: 'ctx.fs.sandboxMode', status: 'removed', note: '插件不再自己围沙箱写二进制:改用 `ctx.fs.writeBytes(target, bytes, { execution, expected })`,由宿主写。工具自带的 `sandbox_permissions`、`justification` 与审批换成工具定义的 `sandboxEscalation: true`:宿主加上这两个参数,执行之前经审批定下这一次的模式,`writeBytes` 带着这次调用写入时沿用' },
|
|
39
|
+
{ legacy: 'ctx.shell', status: 'pending', note: '线 A 工具与权限:在会话的沙箱里执行命令' },
|
|
40
|
+
{ legacy: 'ctx.web', status: 'pending', note: '线 B 第 5 批(web-fetch-http、web-search)' },
|
|
41
|
+
{ legacy: 'ctx.jobs', status: 'pending', note: '线 A 工具:工具的后台任务' },
|
|
42
|
+
{ legacy: 'ctx.approval', status: 'changed', sdk: 'ctx.approval', note: '内部 SDK,只给一方插件:`await ctx.approval.request(execution, reason, displayReason)`,`execution` 是进行中工具调用的 `exec.token`,只能为自己正在执行的这次调用申请;结论照旧是四种之一,审批策略 never 与「替我审批」的会话直接拒绝;拦截工具调用时优先在 `tools/pre-execute` 返回 `{ kind: \'ask\' }`' },
|
|
43
|
+
{ legacy: 'ctx.userQuestions', status: 'pending', note: '线 A Loop:向用户提问' },
|
|
44
|
+
{ legacy: 'ctx.storageDomain', status: 'pending', note: '插件自己的结构化数据:宿主尚未提供,归属待定' },
|
|
45
|
+
{ legacy: 'ctx.credentials', status: 'pending', note: '线 B 第 1 批(credentials-keyring)给 TS 插件的那一层尚未进扩展点表' },
|
|
46
|
+
{ legacy: 'ctx.typert', status: 'changed', sdk: `${HOST}#TypertRemoteService`, note: '不再注入:服务继承 SDK 的 `TypertRemoteService` 即挂上 remote 命名空间;构建时把 `ftai-plugin-typert` 换成 `ftai-plugin-remote`,包导出 `./remote` 指向 `lib/remote.*`,不再有 `./typert`' },
|
|
47
|
+
// ── 现有插件用到的其他服务 ──
|
|
48
|
+
{ legacy: 'ctx.ftaiAccount', status: 'changed', sdk: 'ctx.ftaiAccount', note: '内部 SDK,只给一方插件:`import type {} from \'@ftai/plugin-sdk-internal/host\'`;方法都是异步的,见下面各行;`static inject` 或 `ctx.get(\'ftaiAccount\')` 照旧' },
|
|
49
|
+
{ legacy: 'ctx.ftaiAccount.request', status: 'changed', sdk: 'ctx.ftaiAccount', note: '答复 `{ status, body }`(状态码与响应体原文),不是 `Response`:按 `status` 判断,`JSON.parse(body)` 取 JSON;请求体按 JSON 给 `body`,multipart 给 `form`(字段按顺序,文件的字节按 base64),不收 `FormData`;不收 `signal`,不能中途取消,超时缺省 15 秒(`timeoutMs`)' },
|
|
50
|
+
{ legacy: 'ctx.ftaiAccount.currentUserId', status: 'changed', sdk: 'ctx.ftaiAccount', note: '异步,自己先等启动时的登录恢复完:`await ctx.ftaiAccount.currentUserId()`' },
|
|
51
|
+
{ legacy: 'ctx.ftaiAccount.currentUserInternal', status: 'changed', sdk: 'ctx.ftaiAccount', note: '异步,自己先等启动时的登录恢复完:`await ctx.ftaiAccount.currentUserInternal()`' },
|
|
52
|
+
{ legacy: 'ctx.ftaiAccount.ftaiConnection', status: 'pending', note: '令牌不出宿主:登记经 FTAI 服务端转发的 MCP 服务器改用 `ctx.ftaiMcp.provideFtaiServer`,以登录身份发请求用 `ctx.ftaiAccount.request`;自己开长连接的(远程控制)由线 B 迁 remote-control 时定' },
|
|
53
|
+
{ legacy: 'ctx.ftaiAccount.restored', status: 'removed', note: '去掉 `await account.restored`:`currentUserId()` 与 `request()` 自己等登录恢复完' },
|
|
54
|
+
{ legacy: 'ctx.ftaiAccount.watch', status: 'changed', sdk: 'ftai-account/subject-changed', note: '没有账号状态流:登录主体变了(登录、退出、换人、换公司)宿主发 `ftai-account/subject-changed`,监听它再 `await ctx.ftaiAccount.currentUserInternal()` 等重新取' },
|
|
55
|
+
{ legacy: 'ctx.ftaiAccount.wecomUserId', status: 'changed', sdk: 'ctx.ftaiAccount', note: '不收 `signal`:`await ctx.ftaiAccount.wecomUserId()`' },
|
|
56
|
+
{ legacy: 'ctx.ftaiAccount.ocrModel', status: 'changed', sdk: 'ctx.ftaiAccount', note: '异步,只给路由:`await ctx.ftaiAccount.ocrModel()` 得到 `{ provider, model }`(没有可用的识别模型时为 null),交给 `ctx.llm.stream` 的 `provider`、`model`;0.12 给的是 pi-ai 的 `Model`' },
|
|
57
|
+
{ legacy: 'ctx.ftaiNetwork', status: 'changed', sdk: 'ctx.ftaiNetwork', note: '内部 SDK,只给一方插件:`import type {} from \'@ftai/plugin-sdk-internal/host\'`;只有 `tunnel`,见下一行' },
|
|
58
|
+
{ legacy: 'ctx.ftaiNetwork.tunnel', status: 'changed', sdk: 'ctx.ftaiNetwork', note: '活的 socket 跨不了进程:`await ctx.ftaiNetwork.tunnel(url)` 该走代理时给出本机隧道代理的一次性票 `{ port, target, token }`,向 `127.0.0.1:<port>` 发 `CONNECT <target>`、带 `Proxy-Authorization: Bearer <token>`,收到 200 后在这条连接上握手;直连时为 null' },
|
|
59
|
+
{ legacy: 'ctx.ftaiMcp', status: 'changed', sdk: 'ctx.ftaiMcp', note: '内部 SDK,只给一方插件:`import type {} from \'@ftai/plugin-sdk-internal/host\'`;只有插件登记服务器与调它的工具,见下一行;`static inject` 照旧' },
|
|
60
|
+
{ legacy: 'ctx.ftaiMcp.provideServer', status: 'changed', sdk: 'ctx.ftaiMcp', note: '不再传插件 id(登记归属于调用方插件):`provideServer(name, config)`,返回撤销函数而不是句柄(登记方撤销时也随之撤销);句柄的 `callTool(tool, args)` 改为 `await ctx.ftaiMcp.callProvidedTool(name, tool, args)`,不收 `signal`,结论照旧是 MCP 的 CallToolResult;要换配置先撤销再登记。经 FTAI 服务端转发、要带登录头的服务器改用 `provideFtaiServer(name, path, config)`,登录头由宿主带上,插件拿不到令牌' },
|
|
61
|
+
{ legacy: 'ctx.ftaiPacks', status: 'changed', sdk: 'ctx.ftaiPacks', note: '内部 SDK,只给一方插件:`import type {} from \'@ftai/plugin-sdk-internal/host\'`;只有 `isEnabled`,见下一行;能力包的其余操作只给界面(remote 命名空间 `ftaiPacks`)' },
|
|
62
|
+
{ legacy: 'ctx.ftaiPacks.isEnabled', status: 'changed', sdk: 'ctx.ftaiPacks', note: '异步:`await ctx.ftaiPacks.isEnabled(id)`;还没读过能力包时为否,第一次读完会发 `ftai-packs/changed`' },
|
|
63
|
+
{ legacy: 'ctx.sessionPersistence', status: 'removed', note: '不再注入会话存储;导出会话日志改用内部 SDK 的 `ctx.sessionLog.read(sessionId)`(只给一方插件)' },
|
|
64
|
+
{ legacy: 'ctx.attachments', status: 'same', sdk: 'ctx.attachments', note: '只有 `saveImages`' },
|
|
65
|
+
{ legacy: 'ctx.attachments.saveImages', status: 'same', sdk: 'ctx.attachments', note: '`data` 是 `Uint8Array`;失败抛 `AttachmentError`,`isImageAdmissionError` 照旧' },
|
|
66
|
+
{ legacy: 'ctx.sandboxPolicy', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
67
|
+
{ legacy: 'ctx.sandboxPolicy.resolve', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
68
|
+
{ legacy: 'ctx.subprocess', status: 'removed', note: '插件进程里直接用 Node 的 `child_process`(插件进程有 Node 的全部能力,不经沙箱)' },
|
|
69
|
+
{ legacy: 'ctx.logger', status: 'same', sdk: 'ctx.logger', note: 'cordis 自带的日志,进宿主日志' },
|
|
70
|
+
{ legacy: 'ctx.effect', status: 'same', sdk: 'ctx.effect', note: 'cordis 自带' },
|
|
71
|
+
{ legacy: 'ctx.on', status: 'same', sdk: 'ctx.on', note: 'cordis 自带;宿主的扩展点经它监听' },
|
|
72
|
+
{ legacy: 'ctx.inject', status: 'same', sdk: 'ctx.inject', note: 'cordis 自带' },
|
|
73
|
+
{ legacy: 'ctx.get', status: 'same', sdk: 'ctx.get', note: 'cordis 自带' },
|
|
74
|
+
{ legacy: 'ctx.waterfall', status: 'same', sdk: 'ctx.waterfall', note: 'cordis 自带;宿主的扩展点不能从插件发起(如 `fs/write-intent`,见那一行)' },
|
|
75
|
+
// ── 扩展点 ──
|
|
76
|
+
{ legacy: 'tools/pre-execute', status: 'changed', sdk: 'tools/pre-execute', todo: false, note: '`exec` 是工具调用的句柄(同一次调用总是同一个对象),`exec.arguments` 照 0.12 是解析后的 JSON;结论的四种 `kind` 照旧;超时或插件进程不在时按拒绝' },
|
|
77
|
+
{ legacy: 'agent/created', status: 'changed', sdk: 'agent/created', todo: false, note: '载荷是 `{ agent, source }`,`agent` 是句柄,按 agent 的注册写在 `agent.ctx` 上' },
|
|
78
|
+
{ legacy: 'agent/assistant-stream', status: 'changed', sdk: 'agent/assistant-stream', todo: false, note: '载荷是 `{ agent, frame }`,`frame.chunk` 是会话格式 v4 的 `StreamChunk`;跨进程按批送到' },
|
|
79
|
+
{ legacy: 'session/event', status: 'changed', sdk: 'session/event', todo: false, note: '参数是 `(session, event)`:会话句柄与会话文件里的 v4 行' },
|
|
80
|
+
{ legacy: 'fs/write-intent', status: 'removed', note: '插件不能发起:写二进制用 `ctx.fs.writeBytes`,宿主在写之前跑它,本轮改动记录据此先存下原文件' },
|
|
81
|
+
{ legacy: 'ftai-account/user-changed', status: 'same', sdk: 'ftai-account/user-changed', note: '内部 SDK,只给一方插件;参数照旧是新的用户 id,退出时为 null' },
|
|
82
|
+
{ legacy: 'ftai-packs/changed', status: 'same', sdk: 'ftai-packs/changed', note: '内部 SDK,只给一方插件;监听者收到的参数是 null' },
|
|
83
|
+
{ legacy: 'llm/stream', status: 'removed', note: '不再能改写模型的流式输出;只观察时用 `agent/assistant-stream`' },
|
|
84
|
+
{ legacy: 'tools/post-execute', status: 'pending', note: '线 A 工具:改写工具结果' },
|
|
85
|
+
{ legacy: 'system-prompt/assemble', status: 'removed', note: '按 agent 注册静态的提示词段(`agent.ctx.systemPrompt.section()`)' },
|
|
86
|
+
{ legacy: 'approval/request', status: 'removed', note: '插件不能替用户应答审批;要审批时在 `tools/pre-execute` 返回 `{ kind: \'ask\' }`' },
|
|
87
|
+
// ── 包的导出 ──
|
|
88
|
+
{ legacy: '@deepseek-ai/cordis#Context', status: 'same', sdk: 'cordis#Context', note: '上游 cordis;模块扩充的目标随之改为 `cordis`' },
|
|
89
|
+
{ legacy: '@deepseek-ai/dsh-tools#defineTool', status: 'same', sdk: `${HOST}#defineTool`, note: '参数与结果的类型照旧由 `parameters`、`output.schema` 推出;`output.render` 只给文本块与图片块(`ToolContent`,图片放 `ctx.attachments.saveImages` 得到的引用)' },
|
|
90
|
+
{ legacy: '@deepseek-ai/dsh-tools#ToolDefinition', status: 'changed', sdk: `${HOST}#ToolDefinition`, note: '不再有 `presentCall`、`presentResult`、`presentationMeta`、`projectContent`、`finalizeContent`、`deferLoading`、`timeoutMs`;`isConcurrencySafe` 只接受常量' },
|
|
91
|
+
{ legacy: '@deepseek-ai/dsh-tools#ToolExecution', status: 'changed', sdk: `${HOST}#ToolExecution`, note: '工具调用的句柄:`token`、`callId`、`name`、`arguments`、`agent`、`signal`;这一步用的模型在 `exec.model`(`{ provider, model }`),不再读 `agent.session.requestHeader().config`' },
|
|
92
|
+
{ legacy: '@deepseek-ai/dsh-session#appendPluginRecord', status: 'changed', sdk: `${HOST}#appendPluginRecord`, note: '返回 Promise(记录的 seq),加 `await`;兑现时本进程的会话投影已经读到它' },
|
|
93
|
+
{ legacy: '@deepseek-ai/dsh-session#pluginRecordOf', status: 'same', sdk: `${HOST}#pluginRecordOf` },
|
|
94
|
+
{ legacy: '@deepseek-ai/dsh-session/types#SessionEvent', status: 'same', sdk: `${HOST}#SessionEvent`, note: '会话文件里的 v4 行' },
|
|
95
|
+
{ legacy: '@deepseek-ai/dsh-session/types#SessionId', status: 'removed', note: '会话 id 就是字符串:去掉 `SessionId(...)` 包装' },
|
|
96
|
+
{ legacy: '@deepseek-ai/dsh-session/types#PluginRecordMap', status: 'same', sdk: `${HOST}#PluginRecordMap`, note: '模块扩充的目标改为 `@ftai/plugin-sdk/host`' },
|
|
97
|
+
{ legacy: '@deepseek-ai/dsh-session-projection/types#SessionProjectionStateMap', status: 'same', sdk: `${HOST}#SessionProjectionStateMap`, note: '模块扩充的目标改为 `@ftai/plugin-sdk/host`' },
|
|
98
|
+
{ legacy: '@deepseek-ai/dsh-session-log-export#flushLiveSessionLog', status: 'removed', note: '去掉:宿主的会话写入同步落盘,`ctx.sessionLog.read()` 读到的已包含刚发生的事件' },
|
|
99
|
+
{ legacy: '@deepseek-ai/dsh-session-log-export#readSessionLogText', status: 'changed', sdk: 'ctx.sessionLog', note: '内部 SDK,只给一方插件:`await ctx.sessionLog.read(sessionId)`,参数是会话 id 字符串,没有这个会话时为 null(不是 undefined)' },
|
|
100
|
+
{ legacy: '@deepseek-ai/dsh-typert-protocol#TypertRemoteService', status: 'same', sdk: `${HOST}#TypertRemoteService`, note: '服务名就是 remote 命名空间;服务类要从包的入口导出(`ftai-plugin-remote` 引用它生成前端的类型)' },
|
|
101
|
+
{ legacy: '@deepseek-ai/dsh-typert-protocol#Remote', status: 'same', sdk: `${HOST}#Remote`, note: '`@Remote`、`@Remote(\'名字\')`、`@Remote({ mode: \'stream\' })` 照旧;宿主另传最后一个参数 `signal`' },
|
|
102
|
+
{ legacy: '@deepseek-ai/dsh-typert-protocol#RemoteError', status: 'same', sdk: `${HOST}#RemoteError`, note: '错误码登记在 `@ftai/plugin-sdk/host` 的 `RemoteErrorDetailsMap`;插件前端的结果类型(`@ftai/plugin-sdk/remote`)沿用同一张表,不用另行扩充' },
|
|
103
|
+
{ legacy: '@deepseek-ai/dsh-typert-protocol#RemoteScope', status: 'removed', note: '与会话相关的方法直接收 `sessionId` 字符串' },
|
|
104
|
+
{ legacy: '@deepseek-ai/dsh-llm#BlockAssembler', status: 'changed', sdk: `${HOST}#BlockAssembler`, note: '拼法同 0.12(单测逐项比对);没有 `replayState` 与 `message()`' },
|
|
105
|
+
{ legacy: '@deepseek-ai/dsh-llm#ContentBlock', status: 'changed', sdk: `${HOST}#ContentBlock`, note: '只有文本、推理、图片、文件与工具调用块(没有工具增减块);图片块没有 `offloaded`' },
|
|
106
|
+
{ legacy: '@deepseek-ai/dsh-llm#GenerateOptions', status: 'changed', sdk: `${HOST}#GenerateOptions`, note: '只收 `provider`、`model`、`system`、`messages`、`maxTokens`、`reasoningEffort`、`sessionId` 与 `signal`;`messages` 只有 user 与 assistant 两种' },
|
|
107
|
+
{ legacy: '@deepseek-ai/dsh-llm#StreamChunk', status: 'changed', sdk: `${HOST}#StreamChunk`, note: '同会话格式 v4 的 `StreamChunk`,`finish` 不带 `replayState`;`agent/assistant-stream` 的一帧是 `StreamFrame`,其中的 `chunk` 也是它(类型是 JSON 对象)' },
|
|
108
|
+
{ legacy: '@deepseek-ai/dsh-fs#FsError', status: 'same', sdk: `${HOST}#FsError`, note: '错误码同 0.12(`FS_TOO_LARGE` 等),`instanceof FsError` 照旧' },
|
|
109
|
+
{ legacy: '@deepseek-ai/dsh-fs#FsTarget', status: 'same', sdk: `${HOST}#FsTarget`, note: '`targetKey` 是普通字符串,不是品牌类型' },
|
|
110
|
+
{ legacy: '@deepseek-ai/dsh-attachment#ImageAttachmentRef', status: 'same', sdk: `${HOST}#ImageAttachmentRef`, note: '`attachmentId` 是普通字符串,不是品牌类型' },
|
|
111
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#SandboxExecutionPolicy', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
112
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#SandboxMode', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
113
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#ESCALATION_TARGETS', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
114
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#approveEscalation', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
115
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#escalationHintMarker', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
116
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#sandboxDenialMarker', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
117
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#sandboxPermissionsDescription', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
118
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#validateEscalationArgs', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
119
|
+
{ legacy: '@deepseek-ai/dsh-sandbox#writableRoots', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
120
|
+
{ legacy: '@deepseek-ai/dsh-sandbox-policy#SandboxPolicyService', status: 'removed', note: '插件不自己围沙箱:写二进制用 `ctx.fs.writeBytes`,宿主按这次工具调用所在会话的沙箱围住,越界时报 `FS_SANDBOX_DENIED`,说明就是给模型看的;工具要为写入申请提权(`sandbox_permissions`)时在定义里写 `sandboxEscalation: true`(见 `ctx.tools` 一行)' },
|
|
121
|
+
{ legacy: '@deepseek-ai/schemastery#default', status: 'removed', note: '插件配置的 schema 改用 standard schema 的库(如 zod),写在插件的 `Config` 上;cordis 在组合时校验' },
|
|
122
|
+
];
|
|
123
|
+
/** 按 0.12 一侧的名字查一行。 */
|
|
124
|
+
export function portingOf(legacy) {
|
|
125
|
+
return PORTING_TABLE.find((entry) => entry.legacy === legacy);
|
|
126
|
+
}
|
|
127
|
+
//# sourceMappingURL=porting.js.map
|
package/package.json
CHANGED
|
@@ -1,6 +1,43 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ftai/plugin-host-api",
|
|
3
|
-
"
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"description": "FtAi Desktop 插件后端(宿主一半)的接口,插件经 @ftai/plugin-sdk/host 使用:服务与扩展点的类型由宿主的扩展点表生成,另有以 0.12 写法包的一层与常用函数",
|
|
4
|
+
"version": "2.0.0",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"homepage": "https://ftai.chat/desktop/docs/plugins/",
|
|
7
|
+
"type": "module",
|
|
8
|
+
"main": "lib/index.js",
|
|
9
|
+
"types": "lib/index.d.ts",
|
|
10
|
+
"exports": {
|
|
11
|
+
".": {
|
|
12
|
+
"types": "./lib/index.d.ts",
|
|
13
|
+
"default": "./lib/index.js"
|
|
14
|
+
},
|
|
15
|
+
"./generated": {
|
|
16
|
+
"types": "./lib/generated.d.ts",
|
|
17
|
+
"default": "./lib/generated.js"
|
|
18
|
+
},
|
|
19
|
+
"./porting": {
|
|
20
|
+
"types": "./lib/porting.d.ts",
|
|
21
|
+
"default": "./lib/porting.js"
|
|
22
|
+
},
|
|
23
|
+
"./package.json": "./package.json"
|
|
24
|
+
},
|
|
25
|
+
"files": [
|
|
26
|
+
"lib",
|
|
27
|
+
"!lib/**/*.map"
|
|
28
|
+
],
|
|
29
|
+
"publishConfig": {
|
|
30
|
+
"access": "public"
|
|
31
|
+
},
|
|
32
|
+
"peerDependencies": {
|
|
33
|
+
"cordis": "4.0.0-rc.12"
|
|
34
|
+
},
|
|
35
|
+
"devDependencies": {
|
|
36
|
+
"@types/node": "^24.9.0",
|
|
37
|
+
"cordis": "4.0.0-rc.12",
|
|
38
|
+
"typescript": "~6.0.3"
|
|
39
|
+
},
|
|
40
|
+
"scripts": {
|
|
41
|
+
"build": "tsc -p tsconfig.json"
|
|
42
|
+
}
|
|
6
43
|
}
|