@qfei-design/make-ai-assistant 0.2.16 → 0.3.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/docs/make-app-integration.md +37 -0
- package/package.ai.json +1 -1
- package/package.json +1 -1
|
@@ -33,3 +33,40 @@ capabilities 返回可选 feature、当前 modelInputKinds 和 limits。适配
|
|
|
33
33
|
chat.management 只控制改名、置顶和删除；缺失该可选 feature 时仍可创建、选择和读取会话。缺失 attachments.read 时不提供下载入口。
|
|
34
34
|
|
|
35
35
|
发生游标重置或采用权威快照后，后续恢复继续读取有界快照直到终态，避免把没有共同游标的确认视图与旧增量混合。
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
## 标准接入
|
|
39
|
+
|
|
40
|
+
```ts
|
|
41
|
+
import {
|
|
42
|
+
createMakeAgentClient,
|
|
43
|
+
type Scope,
|
|
44
|
+
type AuthenticatedTransport,
|
|
45
|
+
} from '@qfei-design/make-ai-assistant/client';
|
|
46
|
+
import { createMakeAppAssistantTransport } from '@qfei-design/make-ai-assistant/make-app';
|
|
47
|
+
|
|
48
|
+
async function connectAssistant(
|
|
49
|
+
scope: Scope,
|
|
50
|
+
agentId: string,
|
|
51
|
+
transport: AuthenticatedTransport,
|
|
52
|
+
signal: AbortSignal,
|
|
53
|
+
) {
|
|
54
|
+
const client = createMakeAgentClient({ scope, transport });
|
|
55
|
+
try {
|
|
56
|
+
const assistantTransport = await createMakeAppAssistantTransport({
|
|
57
|
+
client, agentId, signal,
|
|
58
|
+
});
|
|
59
|
+
return { transport: assistantTransport, dispose: () => client.dispose() };
|
|
60
|
+
} catch (error) {
|
|
61
|
+
client.dispose();
|
|
62
|
+
throw error;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
将返回的 transport 交给助手界面，在用户、租户、App 切换和宿主卸载时执行 dispose。适配器会读取 capabilities，因此工厂是异步函数。创建过程中传入 signal，防止身份切换后旧结果重新挂载。identityKey 只隔离客户端缓存，不能作为服务端授权凭据。
|
|
68
|
+
|
|
69
|
+
AuthenticatedTransport 提供一次正式认证的 HTTP 请求及原始字节流，明确 retryOwner。它沿用 Make App Auth 的登录与续期流程，不读取浏览器 Token 或 Cookie，不对 SSE 做 JSON 解包。服务代理保留方法、查询、二进制、AbortSignal、原始响应以及版本和请求 ID 头，不再次实现客户端状态机。
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
宿主只在正式身份可用后创建实例；初始化 signal 中止时不得把旧身份返回的 transport 挂到新页面。服务代理保留方法、查询、版本头、AbortSignal 与响应字节。
|
package/package.ai.json
CHANGED
package/package.json
CHANGED