| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138 |
- /// <reference path="../env.d.ts" />
- import { tool } from "@opencode-ai/plugin"
- import { pendingRequest, clearPendingRequest, recoverRequest, cancelAndObserve } from "../lib/recovery"
- import {
- loadAgentPaaSConfig,
- resolveAgentID,
- digest,
- canonicalJSON,
- requestContext,
- loadConversationState,
- saveConversationState,
- formatRunResult,
- scientificLabel,
- requestJSON,
- verifyAgent,
- trackRun,
- } from "../lib/agentpaas"
- type SSEEvent = { event: string; data: unknown }
- type ProgressStatus = "completed" | "running" | "pending" | "failed" | "paused" | "cancelled" | "skipped" | "unknown"
- type ProgressMilestone = {
- id: string
- label: string
- status: ProgressStatus
- done?: Set<string>
- total?: number
- detail?: string
- }
- type ProgressStage = {
- id: string
- label: string
- status: ProgressStatus
- milestones: ProgressMilestone[]
- }
- export default tool({
- description: `把任务转发给 PaaS 目录中的智能体执行,返回真实运行状态、答案和产物。
- 参数说明:
- - agent_id / agent_name:至少填写一个;优先使用目录返回的 ID,同名时必须使用 ID
- - input:要执行的用户任务指令
- - input_file_ids:已通过 agentpaas_upload 上传的文件 ID,不接受客户端路径
- - mode:iterate(多轮迭代,默认)/ chat(单轮)/ edit(单轮并指定目标子智能体)
- - target_subagent:mode=edit 时的目标子智能体 ID
- - work_dir:可选的服务端可见工作目录;留空时由 AgentPaaS 创建隔离 workspace
- - conversation:continue(默认,沿用远端 thread 并引用上一轮成果)/ new(新课题)
- - thread_id:可选的远端会话线程 ID;显式值优先于自动映射
- - parameters:额外参数,原样传给远端智能体
- 适用于 PaaS 目录中的本地或远端智能体,包括科研、数据分析、软件工程和问答等已注册能力。
- 查询、继续观察或控制已有任务请用 agentpaas_task,不要再次提交。`,
- args: {
- input: tool.schema.string().describe("用户任务指令"),
- background: tool.schema
- .boolean()
- .optional()
- .describe("长任务设为 true:受理并保存编号后返回,在服务端继续执行;用 task/watch 查看,用 cancel 停止"),
- agent_name: tool.schema.string().optional().describe("远端 AgentPaaS 智能体名称;与 agent_id 至少填写一个"),
- agent_id: tool.schema.string().optional().describe("目录返回的稳定 ID;同名智能体用 ID 选择"),
- input_file_ids: tool.schema
- .array(tool.schema.string())
- .optional()
- .describe("agentpaas_upload 返回的 file_id;不接受客户端路径"),
- mode: tool.schema.enum(["iterate", "chat", "edit"]).default("iterate"),
- target_subagent: tool.schema.string().optional().describe("mode=edit 时的目标子智能 ID"),
- work_dir: tool.schema.string().optional().describe("服务端可见工作目录;通常留空,由 AgentPaaS 创建"),
- thread_id: tool.schema.string().optional().describe("远端会话线程 ID;通常留空,由 OpenCode session 自动维护"),
- conversation: tool.schema.enum(["continue", "new"]).default("continue").describe("复用当前对话或开始新课题"),
- question_id: tool.schema.number().int().min(1).max(125).optional().describe("Science 125 科学问题编号"),
- feedback_kind: tool.schema.enum(["human", "program_check", "execution_result", "evidence"]).optional(),
- input_artifact_ids: tool.schema
- .array(tool.schema.string())
- .optional()
- .describe("续跑时选取的上一轮产物 ID;省略时复用上一轮已登记产物"),
- idempotency_key: tool.schema.string().optional().describe("同一请求重试时复用;不同请求必须使用不同键"),
- max_cost_usd: tool.schema
- .number()
- .positive()
- .finite()
- .optional()
- .describe("仅支持预检查声明可用的 CEK 单智能体;按服务端计量在调用结算后检查,非供应商硬限额"),
- parameters: tool.schema
- .record(tool.schema.string(), tool.schema.any())
- .optional()
- .describe("额外参数,原样传给远端智能体"),
- },
- async execute(args, context) {
- const config = await loadAgentPaaSConfig()
- if (args.mode === "edit" && !args.target_subagent) {
- throw new Error("mode=edit 时必须提供 target_subagent")
- }
- const agentID = await resolveAgentID(config, args.agent_id || args.agent_name || "", context.abort)
- const agentName = args.agent_name || agentID
- context.metadata({ title: `PaaS ${agentName} · 执行前检查`, metadata: { agent_id: agentID, status: "checking" } })
- const preflight = await verifyAgent(config, agentID, context.abort, undefined, true)
- if (preflight.blocked) throw new Error(preflight.summary)
- if (args.max_cost_usd !== undefined && preflight.client_budget_supported !== true)
- throw new Error("此智能体未声明支持客户端费用预算,任务未提交;不能承诺限额会生效。")
- const conversation = args.conversation ?? "continue"
- const conversationKey = `${config.url}\n${agentID}\n${digest(config.apiKey)}`
- const savedConversation =
- conversation === "new" ? undefined : await loadConversationState(context.sessionID, conversationKey)
- const threadID = args.thread_id?.trim() || savedConversation?.threadID || ""
- const continueRunID =
- conversation === "continue" && (!args.thread_id?.trim() || args.thread_id.trim() === savedConversation?.threadID)
- ? savedConversation?.runID || ""
- : ""
- // Observation mode does not change the admitted business task.
- const intent = digest(canonicalJSON({ ...args, background: undefined, idempotency_key: undefined, conversation }))
- const idempotencyKey =
- args.idempotency_key?.trim() ||
- `opencode-${digest(canonicalJSON([context.sessionID, context.messageID, agentID, intent]))}`
- // Freeze the parent before submitting. Once `started` advances the session,
- // retrying this same request must not turn it into a new research revision.
- const admission = await requestContext(config, agentID, idempotencyKey, { intent, threadID, runID: continueRunID })
- const rememberRecovered = async (run: Record<string, unknown>) => {
- const runID = getString(run.run_id),
- remoteThreadID = getString(run.session_id) || getString(run.thread_id)
- if (!runID || !remoteThreadID) return
- const latest = await loadConversationState(context.sessionID, conversationKey)
- if (!latest || latest.runID === admission.runID || latest.runID === runID)
- await saveConversationState(context.sessionID, conversationKey, { threadID: remoteThreadID, runID })
- }
- const inputFiles = await Promise.all(
- (args.input_file_ids ?? []).map(async (id) => {
- const file = await requestJSON(config, `/files/${encodeURIComponent(id)}`, context.abort)
- if (file.file_id !== id || file.status !== "available") throw new Error(`输入文件不可用:${id}`)
- return file
- }),
- )
- // OpenCode 的宿主机目录不会自动挂载进 AgentPaaS Docker。只有调用方
- // 明确给出服务端可见路径时才覆盖,否则让 PaaS 创建并隔离 run workspace。
- const workDir = args.work_dir
- const url = `${config.url}/api/v1/agents/${encodeURIComponent(agentID)}/run/stream`
- let resp: Response
- await pendingRequest(config, agentID, idempotencyKey)
- const admissionAbort = new AbortController()
- const admissionTimer = setTimeout(() => admissionAbort.abort(), 30000)
- try {
- resp = await fetch(url, {
- method: "POST",
- headers: {
- Authorization: `Bearer ${config.apiKey}`,
- "Content-Type": "application/json",
- Accept: "text/event-stream",
- "Idempotency-Key": idempotencyKey,
- },
- body: JSON.stringify({
- input: args.input,
- cancel_on_disconnect: false,
- ...(inputFiles.length ? { input_files: inputFiles } : {}),
- mode: args.mode,
- target_subagent: args.target_subagent ?? "",
- thread_id: admission.threadID,
- parameters: {
- ...args.parameters,
- ...(args.max_cost_usd !== undefined ? { client_budget_usd: args.max_cost_usd } : {}),
- },
- context: {
- ...(workDir ? { work_dir: workDir } : {}),
- ...(admission.runID ? { run_id: admission.runID } : {}),
- ...(args.question_id ? { question_id: args.question_id } : {}),
- ...(args.feedback_kind ? { feedback_kind: args.feedback_kind } : {}),
- ...(args.input_artifact_ids ? { input_artifact_ids: args.input_artifact_ids } : {}),
- },
- }),
- signal: AbortSignal.any([context.abort, admissionAbort.signal]),
- redirect: "error",
- })
- } catch (err) {
- clearTimeout(admissionTimer)
- if (!context.abort.aborted) {
- const recovered = await recoverRequest(config, agentID, idempotencyKey, context.abort).catch(() => undefined)
- if (recovered) {
- await rememberRecovered(recovered).catch(() => undefined)
- return formatRunResult(agentName, recovered, { agent_id: agentID, admission_recovered: true })
- }
- }
- throw new Error(
- `AgentPaaS 请求失败: ${err instanceof Error ? err.message : String(err)};idempotency_key=${idempotencyKey}。可能已受理,请查询原任务;不得换键自动重跑。`,
- )
- }
- if (!resp.ok) {
- clearTimeout(admissionTimer)
- const detail = await resp.text().catch(() => "")
- throw new Error(`AgentPaaS HTTP ${resp.status}: ${detail.slice(0, 500)}`)
- }
- if (!resp.body) {
- clearTimeout(admissionTimer)
- throw new Error("AgentPaaS 响应没有 body")
- }
- const errors: string[] = []
- const warnings: string[] = []
- const liveMetadata: Record<string, unknown> = {
- agent_name: agentName,
- agent_id: agentID,
- idempotency_key: idempotencyKey,
- status: "running",
- preflight,
- }
- let done: Record<string, unknown> | null = null
- let startedRunID = ""
- let sawCancelled = false
- let lastThinkUpdate = 0
- const progress = createResearch67Progress()
- const researchUI = /research|科研/i.test(agentName) || context.agent.startsWith("research")
- const updateMetadata = (title: string, next: Record<string, unknown>) => {
- Object.assign(liveMetadata, next)
- const snapshot = researchUI ? progress.snapshot() : undefined
- context.metadata({
- title: snapshot?.title ?? (researchUI ? title : title.replaceAll("Research67", agentName)),
- metadata: { ...liveMetadata, ...(snapshot ? { research67_progress: snapshot } : {}) },
- })
- }
- let remoteCancellation: Promise<unknown> | undefined
- const cancelOnAbort = () => {
- if (args.background) return
- if (!startedRunID || remoteCancellation) return
- remoteCancellation = cancelAndObserve(config, agentID, startedRunID).then(
- (result) => {
- updateMetadata("PaaS 取消状态", result)
- },
- (error) => {
- updateMetadata("PaaS 取消未确认,请查询原任务", {
- cancellation_status: "unconfirmed",
- cancellation_error: String(error),
- })
- },
- )
- }
- context.abort.addEventListener("abort", cancelOnAbort, { once: true })
- try {
- for await (const ev of parseSSE(resp.body)) {
- const data = asRecord(ev.data)
- if (ev.event === "started") {
- clearTimeout(admissionTimer)
- startedRunID = getString(data?.run_id)
- if (!startedRunID) throw new Error("PaaS started 事件缺少 run_id;不能确认任务受理情况")
- const remoteThreadID = getString(data?.thread_id) || getString(data?.session_id)
- await trackRun(config, {
- agent_id: agentID,
- agent_name: agentName,
- run_id: startedRunID,
- thread_id: remoteThreadID,
- })
- .then(() => clearPendingRequest(config, agentID, idempotencyKey))
- .catch(() => {
- warnings.push(
- `本机任务索引写入失败,请保存 agent_id=${agentID}、run_id=${startedRunID},稍后用 status 查询。`,
- )
- })
- if (remoteThreadID && startedRunID) {
- const latest = await loadConversationState(context.sessionID, conversationKey)
- if (admission.created || !latest || latest.runID === admission.runID || latest.runID === startedRunID) {
- await saveConversationState(context.sessionID, conversationKey, {
- threadID: remoteThreadID,
- runID: startedRunID,
- })
- }
- }
- if (context.abort.aborted) cancelOnAbort()
- updateMetadata("Research67 正在运行", {
- run_id: data?.run_id,
- thread_id: data?.thread_id,
- latest_event: ev.event,
- })
- if (args.background) {
- // Breaking cancels only this reader. The worker owns the durable run.
- done = { ...data, status: "queued", run_id: startedRunID }
- break
- }
- } else if (ev.event === "stage_started") {
- const stageName = getString(data?.stage_name) || getString(data?.stage_id) || "未知阶段"
- progress.startStage(getString(data?.stage_id), getPositiveInteger(data?.attempt))
- updateMetadata(`Research67 正在进行 ${stageName}`, {
- pipeline_id: data?.pipeline_id,
- stage_id: data?.stage_id,
- stage_name: stageName,
- stage_status: data?.status,
- attempt: data?.attempt,
- latest_event: ev.event,
- })
- } else if (ev.event === "stage_passed") {
- const stageName = getString(data?.stage_name) || getString(data?.stage_id) || "当前阶段"
- progress.finishStage(getString(data?.stage_id), "completed")
- updateMetadata(`Research67 已通过 ${stageName}`, {
- pipeline_id: data?.pipeline_id,
- stage_id: data?.stage_id,
- stage_name: stageName,
- stage_status: data?.status,
- attempt: data?.attempt,
- latest_event: ev.event,
- })
- } else if (ev.event === "stage_failed") {
- const stageName = getString(data?.stage_name) || getString(data?.stage_id) || "当前阶段"
- progress.finishStage(getString(data?.stage_id), "failed")
- updateMetadata(`Research67 阶段失败:${stageName}`, {
- pipeline_id: data?.pipeline_id,
- stage_id: data?.stage_id,
- stage_name: stageName,
- stage_status: data?.status,
- stage_error: data?.error,
- attempt: data?.attempt,
- latest_event: ev.event,
- status: "failed",
- })
- } else if (ev.event === "pipeline_completed") {
- progress.finishPipeline()
- updateMetadata("Research67 流水线已完成", {
- pipeline_id: data?.pipeline_id,
- pipeline_status: data?.status,
- latest_event: ev.event,
- status: "completed",
- })
- } else if (ev.event === "confirm_required") {
- const runID = getString(data?.run_id) || getString(liveMetadata.run_id)
- const toolName = getString(data?.tool) || "高风险工具"
- const reason = getString(data?.reason)
- const input = getString(data?.input)
- if (!runID) throw new Error("AgentPaaS confirm_required 事件缺少 run_id")
- const approvalID = getString(data?.approval_id)
- if (!approvalID) throw new Error("PaaS 确认事件缺少 approval_id;请升级执行服务,不能批准未绑定的操作。")
- // Replayed journals can contain already-resolved confirmations.
- // Only ask about the operation that is still pending on the worker.
- const current = await requestJSON(
- config,
- `/agents/${encodeURIComponent(agentID)}/runs/${encodeURIComponent(runID)}`,
- context.abort,
- )
- const pending = asRecord(current.pending_confirmation) || asRecord(current.pending_approval)
- if (!pending || pending.approval_id !== approvalID || pending.status !== "pending") continue
- progress.note(`等待确认 · ${toolName}`)
- updateMetadata(`Research67 正在等待确认:${toolName}`, {
- latest_event: ev.event,
- pending_confirmation: true,
- confirmation_tool: toolName,
- confirmation_reason: reason,
- confirmation_input: input,
- })
- let approved = true
- try {
- await context.ask({
- permission: "agentpaas_confirm",
- patterns: [`${agentID}:${runID}:${approvalID}`],
- always: [],
- metadata: {
- run_id: runID,
- approval_id: approvalID,
- agent_name: agentName,
- tool: toolName,
- reason,
- input,
- },
- })
- } catch {
- approved = false
- }
- await resolveConfirmation(config, agentID, runID, approved, context.abort, approvalID)
- progress.note(approved ? "确认已通过,继续执行" : "确认被拒绝,等待流程处理")
- updateMetadata(`Research67 已${approved ? "批准" : "拒绝"} ${toolName}`, {
- latest_event: "confirmation_resolved",
- pending_confirmation: false,
- confirmation_approved: approved,
- })
- } else if (ev.event === "tool_call") {
- const toolName = getString(data?.tool) || "工具"
- progress.toolCall(toolName, getString(data?.content))
- updateMetadata(withStage("Research67 正在处理当前步骤", liveMetadata), {
- latest_event: ev.event,
- latest_tool: toolName,
- step: data?.step,
- })
- } else if (ev.event === "tool_result") {
- const toolName = getString(data?.tool) || getString(liveMetadata.latest_tool) || "工具"
- progress.toolResult(toolName, getString(data?.content))
- updateMetadata(withStage("Research67 已更新当前步骤", liveMetadata), {
- latest_event: ev.event,
- latest_tool: toolName,
- step: data?.step,
- })
- } else if (ev.event === "think" || ev.event === "think_chunk") {
- const now = Date.now()
- if (ev.event === "think" || now - lastThinkUpdate >= 1000) {
- lastThinkUpdate = now
- updateMetadata(withStage("Research67 正在思考", liveMetadata), {
- latest_event: ev.event,
- step: data?.step,
- })
- }
- } else if (ev.event === "answer") {
- updateMetadata(withStage("Research67 正在整理结果", liveMetadata), {
- latest_event: ev.event,
- step: data?.step,
- })
- } else if (ev.event === "heartbeat") {
- updateMetadata(withStage("Research67 仍在运行", liveMetadata), { latest_event: ev.event })
- } else if (ev.event === "error") {
- const message = extractMessage(ev.data)
- errors.push(message)
- updateMetadata("Research67 执行失败", {
- latest_event: ev.event,
- status: "failed",
- error_code: data?.code,
- error_message: message,
- workspace_path: data?.workspace_path ?? liveMetadata.workspace_path,
- })
- } else if (ev.event === "paused") {
- progress.pause()
- updateMetadata("Research67 已暂停", {
- latest_event: ev.event,
- status: "paused",
- checkpoint_id: data?.checkpoint_id,
- workspace_path: data?.workspace_path ?? liveMetadata.workspace_path,
- })
- } else if (ev.event === "approval_required") {
- // Durable human gates stop the stream. Surface the approval card; a separate
- // control action must approve it and re-subscribe to the same run.
- updateMetadata("Research67 等待人工反馈", {
- latest_event: ev.event,
- status: "waiting_human",
- pending_approval: data,
- })
- } else if (ev.event === "cancelled") {
- sawCancelled = true
- progress.cancel()
- updateMetadata("Research67 已取消", { latest_event: ev.event, status: "cancelled" })
- } else if (ev.event === "research_status" && data) {
- updateMetadata(scientificLabel(data.status), { scientific_status: data.status, latest_event: ev.event })
- } else if (ev.event === "done" && data) {
- done = data
- break
- }
- }
- } catch (error) {
- if (context.abort.aborted) throw error
- errors.push(error instanceof Error ? error.message : String(error))
- } finally {
- clearTimeout(admissionTimer)
- context.abort.removeEventListener("abort", cancelOnAbort)
- if (remoteCancellation) await remoteCancellation
- }
- if (!done && !startedRunID && !context.abort.aborted) {
- done = (await recoverRequest(config, agentID, idempotencyKey, context.abort).catch(() => undefined)) ?? null
- if (done) {
- liveMetadata.admission_recovered = true
- await rememberRecovered(done).catch(() =>
- warnings.push("任务已找回,会话映射保存失败;继续修订前请 select 此 run_id。"),
- )
- }
- }
- if ((!done || args.background) && startedRunID && !context.abort.aborted) {
- // A dropped transport is not a failed run. Query, never resubmit.
- const snapshot = await requestJSON(
- config,
- `/agents/${encodeURIComponent(agentID)}/runs/${encodeURIComponent(startedRunID)}`,
- context.abort,
- ).catch(() => null)
- if (snapshot) done = snapshot
- if (snapshot && !args.background) liveMetadata.connection_recovered = true
- if (!snapshot && args.background) {
- done = { ...done, status: "unknown" }
- warnings.push("任务已受理,最新状态暂不可读取;请用原 run_id 恢复查看,不要重复提交。")
- }
- }
- if (!done) {
- const hint = sawCancelled ? "(收到 cancelled 事件)" : "(未收到 done 事件,连接可能中断)"
- throw new Error(
- `AgentPaaS 任务未正常结束${hint}${errors.length ? ":" + errors.join("; ") : ""}。run_id=${startedRunID || "尚未收到"};idempotency_key=${idempotencyKey}。请先查询原运行状态,不要换键重复执行。`,
- )
- }
- const status = typeof done.status === "string" ? done.status : "unknown"
- if (["completed", "partial", "needs_clarification", "failed"].includes(status)) progress.stopUnverified()
- if (status === "paused") progress.pause()
- if (status === "cancelled") progress.cancel()
- const progressMetadata = researchUI ? progress.snapshot() : undefined
- const metadata = {
- agent_name: agentName,
- agent_id: agentID,
- idempotency_key: idempotencyKey,
- run_id: done.run_id ?? liveMetadata.run_id,
- thread_id: done.thread_id ?? done.session_id ?? liveMetadata.thread_id,
- status,
- steps: done.steps,
- total_tokens: done.total_tokens ?? asRecord(done.usage)?.total_tokens,
- cost_usd: done.cost_usd ?? asRecord(done.usage)?.cost_usd,
- research: done.research,
- artifacts: Array.isArray(done.artifacts) ? done.artifacts : [],
- workspace_path: done.workspace_path ?? liveMetadata.workspace_path,
- error_code: liveMetadata.error_code,
- error_message: liveMetadata.error_message,
- connection_recovered: liveMetadata.connection_recovered,
- admission_recovered: liveMetadata.admission_recovered,
- checkpoint_id: done.checkpoint_id ?? liveMetadata.checkpoint_id,
- pending_approval: done.pending_approval ?? liveMetadata.pending_approval,
- preflight,
- background: args.background === true,
- warnings,
- ...(progressMetadata ? { research67_progress: progressMetadata } : {}),
- }
- const result = formatRunResult(agentName, { ...done, ...metadata, output: done.output }, metadata)
- return {
- ...result,
- output: [
- args.background ? "后台任务已受理;关闭当前观察不会取消执行。重新打开后用 /paas-tasks 找回。" : "",
- preflight.summary,
- result.output,
- ...warnings,
- ]
- .filter(Boolean)
- .join("\n"),
- }
- },
- })
- async function resolveConfirmation(
- config: { url: string; apiKey: string },
- agentID: string,
- runID: string,
- approved: boolean,
- signal: AbortSignal,
- approvalID: string,
- ) {
- // Compatibility adapter: legacy local runs keep their existing confirmation API.
- // Remote runs must use their owner-aware route; never fall back after a failed POST.
- const remote = agentID.startsWith("locostack:")
- const endpoint = remote
- ? `/api/v1/agents/${encodeURIComponent(agentID)}/runs/${encodeURIComponent(runID)}/confirm`
- : `/api/v1/traces/${encodeURIComponent(runID)}/confirm`
- const resp = await fetch(`${config.url}${endpoint}`, {
- method: "POST",
- headers: {
- Authorization: `Bearer ${config.apiKey}`,
- "Content-Type": "application/json",
- },
- body: JSON.stringify({ approved, approval_id: approvalID }),
- signal,
- redirect: "error",
- })
- if (resp.ok) return
- const detail = await resp.text().catch(() => "")
- throw new Error(`AgentPaaS 确认请求失败: HTTP ${resp.status}: ${detail.slice(0, 500)}`)
- }
- async function* parseSSE(body: ReadableStream<Uint8Array>): AsyncGenerator<SSEEvent> {
- const reader = body.getReader()
- const decoder = new TextDecoder()
- let buffer = ""
- try {
- while (true) {
- const { done, value } = await reader.read()
- if (done) break
- buffer += decoder.decode(value, { stream: true })
- buffer = buffer.replace(/\r\n/g, "\n")
- let idx: number
- while ((idx = buffer.indexOf("\n\n")) >= 0) {
- const chunk = buffer.slice(0, idx)
- buffer = buffer.slice(idx + 2)
- const event = parseSSEField(chunk, "event")
- const dataRaw = parseSSEField(chunk, "data")
- if (!event && chunk.split("\n").some((line) => line.trim() === ": heartbeat")) {
- yield { event: "heartbeat", data: undefined }
- continue
- }
- let data: unknown = dataRaw
- if (dataRaw !== "") {
- try {
- data = JSON.parse(dataRaw)
- } catch {
- /* 非 JSON 当纯文本 */
- }
- }
- if (event) yield { event, data }
- }
- }
- } finally {
- await reader.cancel().catch(() => undefined)
- reader.releaseLock()
- }
- }
- function parseSSEField(chunk: string, field: string): string {
- const lines = chunk.split("\n")
- const parts: string[] = []
- for (const line of lines) {
- if (line.startsWith(":")) continue
- const m = line.match(new RegExp(`^${field}:\\s?(.*)$`))
- if (m) parts.push(m[1])
- }
- return parts.join("\n")
- }
- function extractMessage(data: unknown): string {
- if (data && typeof data === "object" && "message" in data) return String((data as Record<string, unknown>).message)
- return String(data)
- }
- function asRecord(value: unknown): Record<string, unknown> | undefined {
- if (!value || typeof value !== "object" || Array.isArray(value)) return undefined
- const result: Record<string, unknown> = {}
- for (const [key, item] of Object.entries(value)) result[key] = item
- return result
- }
- function getString(value: unknown): string {
- return typeof value === "string" ? value : ""
- }
- function getPositiveInteger(value: unknown): number {
- return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : 1
- }
- function getWriteFilePath(content: string): string {
- try {
- const filePath = getString(asRecord(JSON.parse(content))?.file_path)
- if (filePath) return filePath
- } catch {}
- return content.match(/["']file_path["']\s*:\s*(["'])(.*?)\1/)?.[2] ?? ""
- }
- function withStage(title: string, metadata: Record<string, unknown>): string {
- const stageName = getString(metadata.stage_name)
- return stageName ? `${title}(${stageName})` : title
- }
- function createResearch67Progress() {
- const stages: ProgressStage[] = [
- {
- id: "ontology-seed",
- label: "本体构建 · seed ontology",
- status: "pending",
- milestones: [
- { id: "parse", label: "解析问题与学科路由", status: "pending", done: new Set(), total: 1 },
- { id: "seed", label: "生成基础本体", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "ontology-audit",
- label: "ontology-auditor · 本体审计",
- status: "pending",
- milestones: [
- { id: "schema", label: "检查 schema 和关系", status: "pending", done: new Set(), total: 1 },
- { id: "gaps", label: "识别证据与机制缺口", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "ontology-enrichment",
- label: "ontology-enricher · 知识补全",
- status: "pending",
- milestones: [
- { id: "kb", label: "召回本地知识库与教材锚点", status: "pending", done: new Set(), total: 1 },
- { id: "search", label: "检索与来源核验", status: "pending", done: new Set(), detail: "尚未开始" },
- { id: "patch", label: "生成本体补丁", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "hypothesis-build",
- label: "hypothesis-builder · 假设构建",
- status: "pending",
- milestones: [
- { id: "hypothesis", label: "生成可证伪假设", status: "pending", done: new Set(), total: 1 },
- { id: "falsifiers", label: "生成可证伪条件", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "research-plan",
- label: "plan-builder · 研究计划",
- status: "pending",
- milestones: [
- { id: "plan", label: "形成研究计划本体", status: "pending", done: new Set(), total: 1 },
- { id: "dag", label: "编译 Action DAG", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "evaluation",
- label: "action-reasoner · 证据评估",
- status: "pending",
- milestones: [
- { id: "assess", label: "评估假设支持状态", status: "pending", done: new Set(), total: 1 },
- { id: "synthesis", label: "形成边界化结论", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "experiment-design",
- label: "exp-planner · 实验规划 / 授权包",
- status: "pending",
- milestones: [
- { id: "protocol", label: "生成实验协议", status: "pending", done: new Set(), total: 1 },
- { id: "authorization", label: "生成授权与数据回传要求", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "experiment-execution",
- label: "exp-executor · 授权实验执行",
- status: "pending",
- milestones: [
- { id: "auth", label: "确认授权与执行边界", status: "pending", done: new Set(), total: 1 },
- { id: "run", label: "运行计算/数据实验", status: "pending", done: new Set(), total: 1 },
- { id: "receipt", label: "保存执行日志与结果", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "result-analysis",
- label: "result-analyzer · 结果分析",
- status: "pending",
- milestones: [
- { id: "analysis", label: "分析实验或回传数据", status: "pending", done: new Set(), total: 1 },
- { id: "patch", label: "生成 observation patch", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "paper-writing",
- label: "paper-writer · 论文写作",
- status: "pending",
- milestones: [
- { id: "outline", label: "写作计划与大纲", status: "pending", done: new Set(), total: 2 },
- { id: "english", label: "英文稿与参考文献", status: "pending", done: new Set(), total: 8 },
- { id: "chinese", label: "中文稿", status: "pending", done: new Set(), total: 7 },
- { id: "compile", label: "编译双语 PDF", status: "pending", done: new Set(), total: 2 },
- { id: "report", label: "形成交付报告", status: "pending", done: new Set(), total: 2 },
- ],
- },
- {
- id: "data-verification",
- label: "data-verifier · 数据与主张核验",
- status: "pending",
- milestones: [
- { id: "claims", label: "核验论文主张与来源", status: "pending", done: new Set(), total: 1 },
- { id: "numbers", label: "核验数据和表述一致性", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "paper-review",
- label: "paper-reviewer · 论文评审",
- status: "pending",
- milestones: [
- { id: "rubric", label: "按科学性和可复现性评分", status: "pending", done: new Set(), total: 1 },
- { id: "gaps", label: "输出研究缺口", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "review-feedback",
- label: "review-feedback · 反馈迭代",
- status: "pending",
- milestones: [
- { id: "compile", label: "编译评审反馈", status: "pending", done: new Set(), total: 1 },
- { id: "next", label: "生成下一轮 action 与本体补丁", status: "pending", done: new Set(), total: 1 },
- ],
- },
- {
- id: "ontology-reaudit",
- label: "ontology-auditor · 本体再审计",
- status: "pending",
- milestones: [
- { id: "audit", label: "检查反馈后的本体", status: "pending", done: new Set(), total: 1 },
- { id: "decision", label: "决定完成或进入下一轮", status: "pending", done: new Set(), total: 1 },
- ],
- },
- // 兼容旧三阶段 Lite pipeline 事件。
- {
- id: "idea-analysis",
- label: "idea-analyst · 创意分析",
- status: "pending",
- milestones: [
- { id: "plan", label: "制定分析计划", status: "pending", done: new Set(), total: 1 },
- { id: "directions", label: "生成检索方向", status: "pending", done: new Set(), total: 2 },
- { id: "report", label: "形成分析报告", status: "pending", done: new Set(), total: 2 },
- ],
- },
- {
- id: "literature-review",
- label: "lit-searcher · 文献检索",
- status: "pending",
- milestones: [
- { id: "plan", label: "制定检索计划", status: "pending", done: new Set(), total: 1 },
- { id: "search", label: "检索候选文献", status: "pending", done: new Set(), detail: "尚未开始" },
- { id: "select", label: "筛选入选论文", status: "pending", done: new Set(), total: 1 },
- { id: "report", label: "形成文献综述", status: "pending", done: new Set(), total: 2 },
- ],
- },
- ]
- const observedStages: ProgressStage[] = []
- let current: ProgressStage | undefined
- let active: ProgressMilestone | undefined
- const pendingArtifacts = new Map<string, Array<Array<{ milestone: ProgressMilestone; key: string }>>>()
- let searchCalls = 0
- let note = ""
- let activeSince = Date.now()
- let activeAttempt = 0
- let timerRunning = false
- const aliases: Record<string, string> = {
- ontology_seed: "ontology-seed",
- "seed-ontology": "ontology-seed",
- "audit-ontology": "ontology-audit",
- audit_ontology: "ontology-reaudit",
- ontology_audit: "ontology-audit",
- "ontology-enrich": "ontology-enrichment",
- ontology_enrichment: "ontology-enrichment",
- "enrich-evidence": "ontology-enrichment",
- enrich_evidence: "ontology-enrichment",
- search: "ontology-enrichment",
- "build-hypothesis": "hypothesis-build",
- build_hypothesis: "hypothesis-build",
- "hypothesis-builder": "hypothesis-build",
- "plan-build": "research-plan",
- "build-research-plan": "research-plan",
- build_research_plan: "research-plan",
- "action-dag": "research-plan",
- synthesis: "evaluation",
- "falsification-assessment": "evaluation",
- falsification_assessment: "evaluation",
- "experiment-plan": "experiment-design",
- experiment_design: "experiment-design",
- experiment_execution: "experiment-execution",
- result_analysis: "result-analysis",
- paper_writing: "paper-writing",
- data_verification: "data-verification",
- paper_review: "paper-review",
- review_feedback: "review-feedback",
- }
- const genericMilestones = (): ProgressMilestone[] => [
- { id: "run", label: "远端阶段执行中", status: "pending", done: new Set(), total: 1 },
- { id: "receipt", label: "等待 receipt / artifact", status: "pending", done: new Set(), total: 1 },
- ]
- const normalizeStageID = (stageID: string) => aliases[stageID] ?? aliases[stageID.replaceAll("_", "-")] ?? stageID
- const findOrCreateStage = (stageID: string) => {
- const normalized = normalizeStageID(stageID || "remote-stage")
- let stage = stages.find((item) => item.id === normalized)
- if (stage) {
- if (!observedStages.includes(stage)) observedStages.push(stage)
- return stage
- }
- stage = {
- id: normalized,
- label: `${stageID || "remote-stage"} · 远端阶段`,
- status: "pending",
- milestones: genericMilestones(),
- }
- stages.push(stage)
- observedStages.push(stage)
- return stage
- }
- const startMilestone = (milestone: ProgressMilestone) => {
- if (!current) return
- if (milestone.status === "completed") return
- milestone.status = "running"
- if (milestone.detail === "尚未开始") milestone.detail = undefined
- if (active !== milestone) activeSince = Date.now()
- active = milestone
- timerRunning = true
- note = ""
- }
- const resetStage = (stage: ProgressStage) => {
- for (const milestone of stage.milestones) {
- milestone.status = "pending"
- milestone.done?.clear()
- milestone.detail = milestone.id === "search" ? "尚未开始" : undefined
- }
- if (["literature-review", "ontology-enrichment"].includes(stage.id)) searchCalls = 0
- pendingArtifacts.clear()
- }
- const artifact = (filePath: string) => {
- if (!current) return undefined
- const value = filePath.replaceAll("\\", "/").toLowerCase()
- const stage = value
- .split("/")
- .findLastIndex((part) => part === current?.id || new RegExp(`^${current?.id}_a\\d+$`).test(part))
- if (stage < 0) return undefined
- const relative = value
- .split("/")
- .slice(stage + 1)
- .join("/")
- const match = (milestoneID: string, key: string) => {
- const milestone = current?.milestones.find((item) => item.id === milestoneID)
- return milestone ? { milestone, key } : undefined
- }
- if (relative === "work_plan.md") {
- return match(current.id === "paper-writing" ? "outline" : "plan", "work_plan")
- }
- if (current.id === "idea-analysis") {
- if (relative === "artifacts/search_queries.json") return match("directions", "search_queries")
- if (relative === "artifacts/similar_papers.json") return match("directions", "similar_papers")
- if (relative === "report.json") return match("report", "report_json")
- if (relative === "report.md") return match("report", "report_md")
- }
- if (["literature-review", "ontology-enrichment"].includes(current.id)) {
- if (relative === "artifacts/papers_selected.json") return match("select", "papers_selected")
- if (relative === "report.json") return match("report", "report_json")
- if (relative === "report.md") return match("report", "report_md")
- if (relative.endsWith("search-log.jsonl")) return match("search", "search_log")
- }
- if (current.id === "experiment-design") {
- if (relative.endsWith("experiment_protocol.json")) return match("protocol", "experiment_protocol")
- if (relative.endsWith("external_authorization_package.json"))
- return match("authorization", "external_authorization_package")
- }
- if (current.id !== "paper-writing") return undefined
- if (relative === "artifacts/outline.json") return match("outline", "outline")
- const section = relative.match(
- /^artifacts\/sections\/(abstract|introduction|related_work|method|experiments|conclusion)\.tex$/,
- )
- if (section) return match("english", `section:${section[1]}`)
- if (relative === "artifacts/paper.tex") return match("english", "paper_tex")
- if (relative === "artifacts/references.bib") return match("english", "references")
- const sectionZh = relative.match(
- /^artifacts\/sections_zh\/(abstract|introduction|related_work|method|experiments|conclusion)\.tex$/,
- )
- if (sectionZh) return match("chinese", `section:${sectionZh[1]}`)
- if (relative === "artifacts/paper_zh.tex") return match("chinese", "paper_zh_tex")
- if (relative === "report.json") return match("report", "report_json")
- if (relative === "report.md") return match("report", "report_md")
- return undefined
- }
- const invalidatePaperBuild = (items: Array<{ milestone: ProgressMilestone; key: string }>) => {
- if (current?.id !== "paper-writing") return
- if (!items.some((item) => ["english", "chinese"].includes(item.milestone.id))) return
- const compile = current.milestones.find((item) => item.id === "compile")!
- const report = current.milestones.find((item) => item.id === "report")!
- if (compile.status === "pending" && !compile.done?.size && report.status === "pending") return
- compile.status = "pending"
- compile.done?.clear()
- report.status = "pending"
- report.done?.clear()
- if (active === compile || active === report) active = undefined
- activeSince = Date.now()
- timerRunning = true
- note = "论文源文件已更新,等待重新编译"
- }
- const completeArtifact = (item: { milestone: ProgressMilestone; key: string }) => {
- item.milestone.done?.add(item.key)
- if (!item.milestone.total || (item.milestone.done?.size ?? 0) < item.milestone.total) return
- item.milestone.status = "completed"
- if (active !== item.milestone || !current) return
- const next = current.milestones[current.milestones.indexOf(item.milestone) + 1]
- if (next) return startMilestone(next)
- active = undefined
- activeSince = Date.now()
- timerRunning = true
- note = "正在进行 Guard / 阶段产物验收"
- }
- const enqueueArtifacts = (toolName: string, items: Array<{ milestone: ProgressMilestone; key: string }>) => {
- const queue = pendingArtifacts.get(toolName) ?? []
- queue.push(items)
- pendingArtifacts.set(toolName, queue)
- }
- const dequeueArtifacts = (toolName: string) => {
- const queue = pendingArtifacts.get(toolName)
- const items = queue?.shift()
- if (!queue?.length) pendingArtifacts.delete(toolName)
- return items
- }
- return {
- startStage(stageID: string, attempt: number) {
- const stage = findOrCreateStage(stageID)
- if (stage === current && attempt <= activeAttempt) return
- if (stage === current) resetStage(stage)
- current = stage
- activeAttempt = attempt
- // A later stage starting says nothing about whether earlier stages ran.
- current.status = "running"
- startMilestone(current.milestones[0])
- },
- finishStage(stageID: string, status: "completed" | "failed") {
- const stage = findOrCreateStage(stageID)
- stage.status = status
- if (status === "completed") {
- for (const milestone of stage.milestones) milestone.status = "completed"
- } else {
- for (const milestone of stage.milestones) {
- if (milestone.status === "running") milestone.status = "failed"
- }
- }
- current = stage
- active = status === "failed" ? active : undefined
- timerRunning = false
- note = status === "failed" ? "阶段执行失败" : "阶段验收通过"
- },
- finishPipeline() {
- // Terminal pipeline status is not evidence that every predefined stage ran.
- for (const stage of observedStages) {
- if (stage.status === "running") stage.status = "unknown"
- for (const milestone of stage.milestones) {
- if (milestone.status === "running") milestone.status = "unknown"
- }
- }
- active = undefined
- timerRunning = false
- note = "流程已结束;阶段状态以服务端事件为准"
- },
- stopUnverified() {
- for (const stage of observedStages) {
- if (stage.status === "running") stage.status = "unknown"
- for (const milestone of stage.milestones) {
- if (milestone.status === "running") milestone.status = "unknown"
- }
- }
- active = undefined
- timerRunning = false
- },
- pause() {
- if (current?.status === "running") current.status = "paused"
- if (active?.status === "running") active.status = "paused"
- timerRunning = false
- note = "任务已暂停,等待恢复"
- },
- cancel() {
- if (current?.status === "running") current.status = "cancelled"
- if (active?.status === "running") active.status = "cancelled"
- timerRunning = false
- note = "任务已取消"
- },
- note(value: string) {
- note = value
- },
- toolCall(toolName: string, content: string) {
- const lower = toolName.toLowerCase()
- if (
- current?.id === "ontology-enrichment" &&
- ["kbsearch", "websearch", "webfetch", "openalex_search", "crossref_search"].includes(lower)
- ) {
- const milestone = current.milestones.find((item) => item.id === "search")!
- startMilestone(milestone)
- return
- }
- if (current?.id === "literature-review" && ["arxiv_search", "openalex_search"].includes(lower)) {
- const milestone = current.milestones.find((item) => item.id === "search")!
- startMilestone(milestone)
- return
- }
- if (current?.id === "paper-writing" && lower === "compilelatex") {
- const milestone = current.milestones.find((item) => item.id === "compile")!
- const key = content.toLowerCase().includes("paper_zh.tex") ? "paper_zh_pdf" : "paper_pdf"
- milestone.done?.delete(key)
- if (milestone.status === "completed") milestone.status = "pending"
- startMilestone(milestone)
- enqueueArtifacts(lower, [{ milestone, key }])
- return
- }
- if (current?.id === "paper-writing" && lower === "buildresearchpaper") {
- const milestone = current.milestones.find((item) => item.id === "compile")!
- milestone.status = "pending"
- milestone.done?.clear()
- startMilestone(milestone)
- enqueueArtifacts(lower, [
- { milestone, key: "paper_pdf" },
- { milestone, key: "paper_zh_pdf" },
- ])
- return
- }
- if (lower !== "writefile") return
- const item = artifact(getWriteFilePath(content))
- if (!item) {
- enqueueArtifacts(lower, [])
- return
- }
- if (
- ["literature-review", "ontology-enrichment"].includes(current?.id ?? "") &&
- item.milestone.id === "select" &&
- searchCalls
- ) {
- const searchMilestone = current?.milestones.find((milestone) => milestone.id === "search")
- if (searchMilestone) searchMilestone.status = "completed"
- }
- startMilestone(item.milestone)
- enqueueArtifacts(lower, [item])
- },
- toolResult(toolName: string, content: string) {
- const lower = toolName.toLowerCase()
- const failed = /\[(?:tool_)?error\]|mcp_error|"status"\s*:\s*"(?:failed|error)"|"passed"\s*:\s*false/i.test(
- content,
- )
- if (
- current?.id === "ontology-enrichment" &&
- ["kbsearch", "websearch", "webfetch", "openalex_search", "crossref_search"].includes(lower)
- ) {
- if (!failed) searchCalls++
- const milestone = current.milestones.find((item) => item.id === "search")!
- milestone.detail = searchCalls ? `已完成 ${searchCalls} 轮检索/核验` : "等待检索重试"
- return
- }
- if (current?.id === "literature-review" && ["arxiv_search", "openalex_search"].includes(lower)) {
- if (!failed) searchCalls++
- const milestone = current.milestones.find((item) => item.id === "search")!
- milestone.detail = searchCalls ? `已完成 ${searchCalls} 轮检索` : "等待检索重试"
- return
- }
- const items = dequeueArtifacts(lower)
- if (!items) return
- if (!failed) {
- items.forEach(completeArtifact)
- invalidatePaperBuild(items)
- }
- if (failed) {
- for (const item of items) item.milestone.status = "failed"
- note = "当前操作失败,等待重试"
- }
- },
- snapshot() {
- if (!current) return undefined
- const rows = observedStages.flatMap((stage) => {
- const detail = stage.status === "running" ? active?.label : undefined
- const parent = [{ id: stage.id, label: stage.label, status: stage.status, detail, depth: 0 }]
- if (stage !== current || !["running", "failed"].includes(stage.status)) return parent
- return parent.concat(
- stage.milestones.map((milestone) => ({
- id: `${stage.id}:${milestone.id}`,
- label: milestone.label,
- status: milestone.status,
- detail:
- milestone.detail ??
- (milestone.status !== "completed" && milestone.total && milestone.done?.size
- ? `${milestone.done.size}/${milestone.total}`
- : undefined),
- depth: 1,
- })),
- )
- })
- return {
- kind: "research67",
- title: active ? `Research67 · ${current.label} · ${active.label}` : `Research67 · ${current.label}`,
- rows,
- activeSince: timerRunning ? activeSince : undefined,
- footer: note || (!active ? "进度已更新" : undefined),
- }
- },
- }
- }
|