workspaceTeamTools.test.ts 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250
  1. // @vitest-environment node
  2. import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
  3. import { mkdtempSync, rmSync } from 'node:fs'
  4. import { tmpdir } from 'node:os'
  5. import { join } from 'node:path'
  6. import { randomUUID } from 'node:crypto'
  7. import { WorkspaceStore } from '../../src/server/workspaceStore'
  8. import { WorkspaceRuntime } from '../../src/server/workspaceRuntime'
  9. import type { WorkspaceNodes, GatewayTarget } from '../../src/server/workspaceGateway'
  10. import { UploadStore } from '../../src/server/uploads'
  11. import { HttpError } from '../../src/server/errors'
  12. import { createWorkspaceToolLease, requireTeamToolBridge, type WorkspaceToolLease } from '../../src/server/workspaceToolLease'
  13. import type { Work } from '../../src/server/workspaceScheduler'
  14. import type { WorkspaceAgent, WorkspaceConversation, WorkspaceTask, WorkspaceRun } from '../../src/shared/workspace'
  15. let home: string, store: WorkspaceStore, runtime: WorkspaceRuntime, uploads: UploadStore
  16. let manager: WorkspaceAgent, work: Work, nodes: WorkspaceNodes, active: boolean
  17. let denied: Set<string>, target: GatewayTarget, binding: Record<string, any> | undefined
  18. let leases: WorkspaceToolLease[], upstream: Array<{ path: string; body: any }>
  19. const owner = 'account-one'
  20. const call = (tool: string, args: unknown = {}) => runtime.teamTools.call(owner, work.id, `workspace_${tool}`, args) as Promise<any>
  21. beforeEach(() => {
  22. home = mkdtempSync(join(tmpdir(), 'yaoyao-team-tools-'))
  23. store = new WorkspaceStore(home); uploads = new UploadStore(home)
  24. active = true; denied = new Set(); leases = []; upstream = []; binding = undefined
  25. target = {
  26. url: new URL('http://127.0.0.1:19119'),
  27. session: { request: vi.fn(async (path, options) => {
  28. upstream.push({ path, body: options?.body })
  29. if (path.endsWith('/bind')) binding = options!.body as Record<string, any>
  30. return { status: 200, body: Buffer.from(JSON.stringify(path.endsWith('/capabilities')
  31. ? { version: 1, ready: true, native_tools: true, in_process: true }
  32. : { ok: true, native_tools: true })), headers: new Headers() }
  33. }) },
  34. } as unknown as GatewayTarget
  35. nodes = {
  36. target: () => target,
  37. requireSource: (user: string, source: {profile: string}) => {
  38. if (user !== owner || denied.has(source.profile)) throw new HttpError(403, '未分配', 'agent_source_forbidden')
  39. },
  40. sources: async () => ({ sources: [{nodeId:'local',profile:'default',name:'基础 Agent'}, {nodeId:'local',profile:'writer',name:'写作'}], errors: [] }),
  41. } as unknown as WorkspaceNodes
  42. runtime = new WorkspaceRuntime(store, nodes, uploads, () => active)
  43. vi.spyOn(runtime, 'wake').mockImplementation(() => {})
  44. manager = store.createAgent(owner, {name:'老板',profile:'default',canManageTeam:true})
  45. const direct = store.list<WorkspaceConversation>(owner,'conversation')[0]!
  46. const run = runtime.send(owner,direct.id,{requestId:randomUUID(),content:'组建项目团队'})
  47. work = store.list<Work>(owner,'turn').find(w=>w.runId===run.id)!
  48. work.status = 'running'; work.teamManagementRevision=manager.revision; store.put(owner,'turn',work.id,work)
  49. })
  50. afterEach(async () => {
  51. await Promise.all(leases.map(lease => lease.dispose()))
  52. runtime.close(); uploads.close(); store.close()
  53. rmSync(home,{recursive:true,force:true})
  54. })
  55. async function buildTeam() {
  56. const member = (await call('create_agent',{requestId:randomUUID(),name:'研究员',profile:'writer'})).agent as WorkspaceAgent
  57. const created = await call('create_team',{requestId:randomUUID(),name:'项目团队',memberIds:[member.id]})
  58. return { member, team: created.team as WorkspaceConversation, task: created.task as WorkspaceTask }
  59. }
  60. describe('Agent-owned team tools', () => {
  61. it('creates durable members, a managed team and one idempotent task with client-visible events', async () => {
  62. const requestId = randomUUID(), args = {requestId,name:'研究员',profile:'writer',instructions:'研究事实并给出处'}
  63. const first = await call('create_agent',args)
  64. expect(await call('create_agent',args)).toEqual(first)
  65. expect(first.agent.canManageTeam).toBe(false)
  66. expect(store.list(owner,'agent')).toHaveLength(2)
  67. const groupArgs = {requestId:randomUUID(),name:'项目团队',memberIds:[first.agent.id]}
  68. const created = await call('create_team',groupArgs)
  69. expect(await call('create_team',groupArgs)).toEqual(created)
  70. expect(created.team).toMatchObject({memberIds:[manager.id,first.agent.id],administratorId:manager.id,mode:'host'})
  71. const taskArgs = {requestId:randomUUID(),teamId:created.team.id,title:'核对资料',content:'请研究员核对资料后汇总。'}
  72. const started = await call('start_team_task',taskArgs)
  73. expect(await call('start_team_task',taskArgs)).toEqual(started)
  74. expect(started.run.status).toBe('queued')
  75. expect(store.tasks(owner,created.team.id)).toHaveLength(1)
  76. expect(started.task.id).toBe(created.task.id)
  77. const result = await call('get_team_task',{teamId:created.team.id,taskId:started.task.id})
  78. expect(result.runs).toHaveLength(1)
  79. expect(result.messages[0].content).toBe(taskArgs.content)
  80. expect(store.events(owner,0).map(e=>e.type)).toEqual(expect.arrayContaining(['agent.changed','conversation.changed','task.changed','message.changed','run.changed']))
  81. expect(store.list('other','agent')).toEqual([])
  82. expect(await call('list_teams')).toMatchObject({teams:[{id:created.team.id}]})
  83. })
  84. it('denies grants, caller identity and arbitrary fields supplied by the model', async () => {
  85. for (const extra of [{canManageTeam:true},{owner:'other'},{agentId:randomUUID()},{token:'pretend'}])
  86. await expect(call('create_agent',{requestId:randomUUID(),name:'伪造',profile:'default',...extra})).rejects.toMatchObject({status:400})
  87. await expect(call('list_agents',{owner:'other'})).rejects.toMatchObject({status:400})
  88. expect(store.list(owner,'agent')).toHaveLength(1)
  89. const ordinary = store.createAgent(owner,{name:'普通',profile:'default'})
  90. expect(ordinary.canManageTeam).toBe(false)
  91. store.updateAgent(owner,manager.id,{canManageTeam:false})
  92. await expect(call('list_agents')).rejects.toMatchObject({status:403})
  93. })
  94. it('checks source permission before and after asynchronous discovery', async () => {
  95. denied.add('writer')
  96. expect((await call('list_sources')).sources.map((s:any)=>s.profile)).toEqual(['default'])
  97. await expect(call('create_agent',{requestId:randomUUID(),name:'越权',profile:'writer'})).rejects.toMatchObject({status:403})
  98. denied.clear()
  99. vi.spyOn(nodes,'sources').mockImplementationOnce(async () => {
  100. store.updateAgent(owner,manager.id,{canManageTeam:false})
  101. return {sources:[{nodeId:'local',profile:'writer',name:'写作'}],errors:[]}
  102. })
  103. await expect(call('create_agent',{requestId:randomUUID(),name:'竞态',profile:'writer'})).rejects.toMatchObject({status:403})
  104. expect(store.list(owner,'agent')).toHaveLength(1)
  105. })
  106. it('never revives a previous turn grant after permission is disabled and re-enabled', async () => {
  107. store.updateAgent(owner,manager.id,{canManageTeam:false})
  108. store.updateAgent(owner,manager.id,{canManageTeam:true})
  109. await expect(call('list_agents')).rejects.toMatchObject({status:403})
  110. store.put(owner,'turn',work.id,{...work,teamManagementRevision:store.require<WorkspaceAgent>(owner,'agent',manager.id).revision})
  111. expect((await call('list_agents')).agents).toHaveLength(1)
  112. })
  113. it('prevents account crossing and modification of teams controlled by another Agent', async () => {
  114. const {team,member} = await buildTeam()
  115. const other = store.createAgent('other',{name:'外部',profile:'default'})
  116. await expect(call('create_team',{requestId:randomUUID(),name:'跨账号',memberIds:[other.id]})).rejects.toMatchObject({status:404})
  117. store.updateConversation(owner,team.id,{administratorId:member.id})
  118. await expect(call('start_team_task',{requestId:randomUUID(),teamId:team.id,title:'越权',content:'开始'})).rejects.toMatchObject({status:403})
  119. expect((await call('list_teams')).teams).toEqual([])
  120. })
  121. it.each(['account','archive','cancel','stop','source','member','complete'])('revokes a live grant on %s changes', async reason => {
  122. if(reason==='account')active=false
  123. if(reason==='archive')store.updateAgent(owner,manager.id,{archived:true})
  124. if(reason==='source')denied.add('default')
  125. if(reason==='cancel')store.put(owner,'turn',work.id,{...work,cancelRequested:true})
  126. if(reason==='complete')store.put(owner,'turn',work.id,{...work,status:'complete'})
  127. if(reason==='stop')store.put(owner,'run',work.runId,{...store.require(owner,'run',work.runId),stopRequested:true})
  128. if(reason==='member')store.put(owner,'conversation',work.conversationId,{...store.require(owner,'conversation',work.conversationId),memberIds:[]})
  129. await expect(call('create_agent',{requestId:randomUUID(),name:'不应创建',profile:'default'})).rejects.toMatchObject({status:403})
  130. })
  131. it('rejects conflicting retries, duplicate teams and recursive starts', async () => {
  132. const requestId = randomUUID()
  133. await call('create_agent',{requestId,name:'甲',profile:'default'})
  134. await expect(call('create_agent',{requestId,name:'乙',profile:'default'})).rejects.toMatchObject({code:'idempotency_conflict'})
  135. const {team} = await buildTeam()
  136. await expect(call('create_team',{requestId:randomUUID(),name:team.name,memberIds:team.memberIds})).rejects.toMatchObject({code:'duplicate_team_name'})
  137. store.put(owner,'turn',work.id,{...work,conversationId:team.id})
  138. await expect(call('start_team_task',{requestId:randomUUID(),teamId:team.id,title:'递归',content:'再开始'})).rejects.toMatchObject({code:'team_task_reentrant'})
  139. })
  140. it('keeps operation receipts through a store reopen without creating duplicates', async () => {
  141. const args = {requestId:randomUUID(),name:'持久成员',profile:'default'}
  142. const first = await call('create_agent',args)
  143. runtime.close(); store.close()
  144. store = new WorkspaceStore(home)
  145. runtime = new WorkspaceRuntime(store,nodes,uploads,()=>active)
  146. vi.spyOn(runtime,'wake').mockImplementation(()=>{})
  147. store.put(owner,'turn',work.id,{...work,status:'running'})
  148. expect(await call('create_agent',args)).toEqual(first)
  149. expect(store.list(owner,'agent')).toHaveLength(2)
  150. })
  151. })
  152. async function mount(signal = new AbortController().signal) {
  153. const lease = await createWorkspaceToolLease({
  154. target, profile:manager.profile, workId:work.id,
  155. session:()=>({runtimeId:'runtime',storedId:'stored'}),signal,
  156. assertActive:()=>{runtime.teamTools.assertTurn(owner,work.id)},
  157. catalog:()=>runtime.teamTools.catalog(owner,work.id),
  158. call:(id,args)=>runtime.teamTools.call(owner,work.id,id,args),onFailure:()=>{},
  159. })
  160. leases.push(lease); await lease.bind()
  161. return lease
  162. }
  163. function http(path:string, body:unknown, options:RequestInit={}) {
  164. return fetch(binding!.bridge_url+path,{method:'POST',headers:{'Content-Type':'application/json',Authorization:`Bearer ${binding!.token}`},body:JSON.stringify(body),...options})
  165. }
  166. describe('loopback tool lease', () => {
  167. it('binds only the current session and executes the real HTTP catalog and call protocol', async () => {
  168. const lease = await mount()
  169. expect(binding).toMatchObject({native_tools:true,session_id:'runtime',stored_session_id:'stored',profile:'default'})
  170. const catalog = await (await http('/tools/list',{})).json()
  171. expect(catalog.tools).toHaveLength(7)
  172. expect(JSON.stringify(catalog)).not.toContain(binding!.token)
  173. const body={callId:'same-call',toolId:catalog.tools.find((t:any)=>t.name==='workspace_create_agent').id,arguments:{requestId:randomUUID(),name:'HTTP 成员',profile:'writer'}}
  174. const [first,second]=await Promise.all([http('/tools/call',body).then(r=>r.json()),http('/tools/call',body).then(r=>r.json())])
  175. expect(second).toEqual(first)
  176. expect(first.structuredContent.agent.canManageTeam).toBe(false)
  177. expect(store.list(owner,'agent')).toHaveLength(2)
  178. expect((await http('/tools/call',{...body,arguments:{...body.arguments,name:'替换'}})).status).toBe(409)
  179. await lease.dispose()
  180. expect(upstream.at(-1)).toMatchObject({path:expect.stringContaining('/unbind'),body:{session_id:'runtime',generation:binding!.generation}})
  181. await expect(http('/tools/list',{})).rejects.toThrow()
  182. })
  183. it('rejects missing tokens, browser origins, forged envelope identities and revoked permissions', async () => {
  184. await mount()
  185. expect((await http('/tools/list',{}, {headers:{'Content-Type':'application/json'}})).status).toBe(401)
  186. expect((await http('/tools/list',{}, {headers:{'Content-Type':'application/json',Authorization:`Bearer ${binding!.token}`,Origin:'http://evil.test'}})).status).toBe(403)
  187. expect((await http('/tools/list',{owner:'other'})).status).toBe(400)
  188. expect((await http('/tools/call',{toolId:'workspace_list_agents',arguments:{},callId:'id',owner:'other'})).status).toBe(400)
  189. store.updateAgent(owner,manager.id,{canManageTeam:false})
  190. expect((await http('/tools/list',{})).status).toBe(403)
  191. })
  192. it('checks readiness per Profile and rejects unavailable or remote bridges', async () => {
  193. await requireTeamToolBridge(target,'writer')
  194. expect(target.session.request).toHaveBeenCalledWith(expect.stringContaining('/capabilities'),expect.objectContaining({search:new URLSearchParams({profile:'writer'})}))
  195. await expect(requireTeamToolBridge({...target,url:new URL('http://192.168.1.20:9119')},'default')).rejects.toMatchObject({code:'team_tools_local_required'})
  196. vi.mocked(target.session.request).mockResolvedValueOnce({status:404,body:Buffer.from('{}'),headers:new Headers()})
  197. await expect(requireTeamToolBridge(target,'default')).rejects.toMatchObject({code:'team_tools_unavailable'})
  198. await expect(runtime.teamTools.requireAvailable(owner,{nodeId:'remote',profile:'default'})).rejects.toMatchObject({code:'team_tools_local_required'})
  199. })
  200. it('closes a cancelled lease even if binding has not returned yet', async () => {
  201. let finish!:()=>void
  202. vi.mocked(target.session.request).mockImplementation(async(path,options)=>{
  203. upstream.push({path,body:options?.body})
  204. if(path.endsWith('/bind')){
  205. binding=options?.body as any
  206. await new Promise<void>(resolve=>{finish=resolve})
  207. }
  208. return {status:200,body:Buffer.from('{"ok":true,"native_tools":true}'),headers:new Headers()}
  209. })
  210. const controller=new AbortController()
  211. const pending=mount(controller.signal)
  212. await vi.waitFor(()=>expect(finish).toBeTypeOf('function'))
  213. controller.abort();finish()
  214. await expect(pending).rejects.toThrow()
  215. await vi.waitFor(()=>expect(upstream.at(-1)?.path).toContain('/unbind'))
  216. await expect(http('/tools/list',{})).rejects.toThrow()
  217. })
  218. it('rejects an expired lease and another lease token', async () => {
  219. await mount()
  220. const first={...binding}
  221. const firstCatalog=await (await http('/tools/list',{})).json()
  222. await mount()
  223. const secondCatalog=await (await http('/tools/list',{})).json()
  224. expect(secondCatalog.tools.map((t:any)=>t.id)).not.toEqual(firstCatalog.tools.map((t:any)=>t.id))
  225. expect((await http('/tools/call',{toolId:firstCatalog.tools[0].id,arguments:{},callId:'cross-lease'})).status).toBe(404)
  226. expect((await http('/tools/list',{}, {headers:{'Content-Type':'application/json',Authorization:`Bearer ${first.token}`}})).status).toBe(401)
  227. vi.useFakeTimers({toFake:['Date']})
  228. try {
  229. vi.setSystemTime(Date.now()+31*60_000)
  230. expect((await http('/tools/list',{})).status).toBe(410)
  231. } finally { vi.useRealTimers() }
  232. })
  233. })