forked from ChaiHao/BPOS-MVP
ChaiHaoandClaude Fable 5
f96eff906a
用户定:Agent 调用工具一律**声明式**;人类工具与 LLM 工具要系统内化;
工具总线基于 Mastra tool 设计。
**声明面**(`toolbox/internal/domain/tool-bus.ts`,纯逻辑零框架):
`compileToolBus(声明 × 目录) → 一张清单` —— 编译期定死这一单能调什么,
清单之外结构上调不到(白名单在缝里再把一次关);缺件/停用如实报不静默。
三路同一形状:
· `function` 功能工具:按活动白名单查目录,带出效应(read/write)
· `human` **人类工具**(系统内化、零声明即得):调人 = 发工单 + 立监听听人 ——
这是 Harness 给的能力,不进目录、不需白名单,每个活动天然可以调人
· `llm` **LLM 五件**(系统内化):extract/classify/summarize/judge/rewrite,
各有入参出参契约、经模型网关一缝;**仅当活动声明了模型用途名才上总线**
(没声明却会问模型 = 越权,用量也无从归因);提示词归系统,活动改不了
**装配面**(`app/tool-bus.ts`,Mastra `createTool`):清单 → 可调用工具,
JSON Schema 现译 zod(模型照它填参,填错当场被拦);三路各穿各的缝:
写类工具**过程中一律不落地**,只登记动作意向(骗 Agent 说已执行是最坏选项);
调人把卡号记进 trace,引擎据此把这一拍挂起。
**Agent 开环**(`app/mastra-agent-runner.ts`,M5-2 第二实现,用户选的路线):
Mastra `Agent` + 工具总线,拍内自主连环调工具,拍末交回结构化结论。
放开的是工具循环不是规矩:写类不落地、终局唯放行、调人即挂起(新增
`AgentAction.asked` 型 —— 卡已由总线发出,引擎只收尾,不重复发卡)、
用量按 usage 计入预算。`JCAI_AGENT_OPEN_LOOP=1` 开启,缺省仍是单拍版。
`ModelGateway.resolve` 新增:名 → 四元(密钥当场解出,只给 app 层装配用)。
代价如实记 debt M5-2:开环下模型**逐轮**调用不经录制回放(tool-calling 往返
`generate` 的 text-in/text-out 承载不了)—— 凭证隔离与工具调用一缝完整。
测试:tool-bus 六例(白名单/缺件/停用/人类工具恒在/LLM 按声明/五件契约);
四闸(typecheck/lint/depcruise/test)全过;spike 目录排除出 lint(验证性原型)。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
47 lines
1.8 KiB
TypeScript
47 lines
1.8 KiB
TypeScript
/** 冒烟:确认 createWorkflow / suspend / resume / InMemoryStore 这套 API 在 1.53 上能跑 */
|
|
import { Mastra } from '@mastra/core';
|
|
import { InMemoryStore } from '@mastra/core/storage';
|
|
import { createStep, createWorkflow, createWorkflowStateReader } from '@mastra/core/workflows';
|
|
import { z } from 'zod';
|
|
|
|
const ask = createStep({
|
|
id: 'ask',
|
|
inputSchema: z.object({ q: z.string() }),
|
|
outputSchema: z.object({ a: z.string() }),
|
|
resumeSchema: z.object({ a: z.string() }),
|
|
suspendSchema: z.object({ taskId: z.string() }),
|
|
execute: async ({ inputData, resumeData, suspend }) => {
|
|
console.log('[ask.execute] inputData=', inputData, 'resumeData=', resumeData);
|
|
if (!resumeData) return await suspend({ taskId: 'T-1' }, { resumeLabel: 'ask' });
|
|
return { a: resumeData.a };
|
|
},
|
|
});
|
|
|
|
const wf = createWorkflow({
|
|
id: 'smoke',
|
|
inputSchema: z.object({ q: z.string() }),
|
|
outputSchema: z.object({ a: z.string() }),
|
|
})
|
|
.then(ask)
|
|
.commit();
|
|
|
|
const mastra = new Mastra({
|
|
workflows: { smoke: wf },
|
|
storage: new InMemoryStore(),
|
|
logger: false,
|
|
});
|
|
|
|
const run = await mastra.getWorkflow('smoke').createRun();
|
|
const r1 = await run.start({ inputData: { q: 'hi' } });
|
|
console.log('r1.status =', r1.status);
|
|
console.log('r1 =', JSON.stringify(r1, null, 2).slice(0, 1200));
|
|
|
|
const state = await mastra.getWorkflow('smoke').getWorkflowRunById(run.runId);
|
|
console.log('state.status =', state?.status);
|
|
const reader = createWorkflowStateReader(state!);
|
|
console.log('suspendedStep =', JSON.stringify(reader.getSuspendedStep(), null, 2));
|
|
console.log('resumeLabels =', JSON.stringify(reader.getResumeLabels(), null, 2));
|
|
|
|
const r2 = await run.resume({ step: 'ask', resumeData: { a: '42' } });
|
|
console.log('r2.status =', r2.status, 'result =', (r2 as { result?: unknown }).result);
|