import { randomUUID } from 'node:crypto'; export const EXECUTION_SCHEMA = 1; export const ACTIVE_STATES = new Set(['running', 'awaiting_approval', 'stopping']); export const CORE_KINDS = ['task', 'run', 'step', 'tool', 'artifact', 'check_plan', 'check_job', 'delivery_plan', 'delivery_job', 'change_set', 'context_plan', 'workspace', 'research_target', 'research_job', 'engine_job', 'browser_plan', 'browser_job']; export const timestamp = () => new Date().toISOString(); export const isId = value => typeof value === 'string' && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(value); export function modelSnapshot(config) { return { mode: config.mode, baseUrl: config.baseUrl, model: config.model, contextLimit: config.contextLimit, maxOutputTokens: config.maxOutputTokens, configRevision: config.configRevision ?? 1, }; } export function executionBudget(config) { return { maxSteps: config.maxSteps ?? 12, maxDurationMs: config.maxRunDurationMs ?? 600000, maxTokens: config.maxRunTokens ?? 200000, maxTaskTokens: config.maxTaskTokens ?? 1000000, }; } export function emptyUsage() { return { requests: 0, inputTokens: 0, outputTokens: 0, totalTokens: 0, unknownRequests: 0, estimatedUnknownTokens: 0 }; } export function accumulateUsage(previous, received, estimate = 0) { const usage = { ...emptyUsage(), ...previous, requests: (previous?.requests ?? 0) + 1 }; const valid = value => Number.isSafeInteger(value) && value >= 0; if (received && (valid(received.total_tokens) || valid(received.prompt_tokens) && valid(received.completion_tokens))) { usage.inputTokens += valid(received.prompt_tokens) ? received.prompt_tokens : 0; usage.outputTokens += valid(received.completion_tokens) ? received.completion_tokens : 0; usage.totalTokens += valid(received.total_tokens) ? received.total_tokens : received.prompt_tokens + received.completion_tokens; } else { usage.unknownRequests++; usage.estimatedUnknownTokens += Math.max(0, Math.ceil(Number(estimate) || 0)); } return usage; } export const accountedTokens = usage => (usage?.totalTokens ?? 0) + (usage?.estimatedUnknownTokens ?? 0); export function createTask(session, goal, config, previousTaskId = null) { const at = timestamp(); return { schemaVersion: EXECUTION_SCHEMA, id: randomUUID(), sessionId: session.id, projectId: session.projectId, goal: String(goal), instructions: [], constraints: [], acceptance: [], status: 'idle', previousTaskId, createdAt: at, updatedAt: at, activeRunId: null, usage: emptyUsage(), budget: { maxTokens: executionBudget(config).maxTaskTokens }, verification: { status: 'not_configured', checkJobId: null }, origin: 'workbench', }; } export function createRun(session, task, config, resumeOf = null) { return { schemaVersion: EXECUTION_SCHEMA, id: randomUUID(), taskId: task.id, sessionId: session.id, projectId: session.projectId, engine: 'workbench', status: 'running', startedAt: timestamp(), finishedAt: null, resumeOf, model: modelSnapshot(config), budget: executionBudget(config), usage: emptyUsage(), steps: 0, toolCalls: 0, stopReason: null, checkpoint: { stepId: null, completedToolIds: [], pendingToolIds: [], requiresVerification: [] }, origin: 'workbench', }; } export function ownedRecord(kind, value, session) { if (!CORE_KINDS.includes(kind) || !isId(value.id) || value.sessionId !== session.id || value.projectId !== session.projectId) { throw new Error('执行记录的身份或项目归属无效。'); } if (value.taskId && !isId(value.taskId) || value.runId && !isId(value.runId)) throw new Error('任务或运行身份无效。'); return { kind, id: value.id, sessionId: value.sessionId, projectId: value.projectId, taskId: value.taskId ?? (kind === 'task' ? value.id : null), runId: value.runId ?? (kind === 'run' ? value.id : null), status: value.status ?? value.state ?? null, value }; } export class BudgetExceeded extends Error { constructor(reason, message) { super(message); this.name = 'BudgetExceeded'; this.reason = reason; } } export function checkBudget(run, task) { if (run.budget.maxDurationMs > 0 && Date.now() - Date.parse(run.startedAt) >= run.budget.maxDurationMs) { throw new BudgetExceeded('time_limit', '已到达本次运行的时间预算。执行记录已保存,可以核对后继续。'); } if (run.budget.maxTokens > 0 && accountedTokens(run.usage) >= run.budget.maxTokens) { throw new BudgetExceeded('token_limit', '已到达本次运行的 token 预算。已完成工具结果保留,可以核对后继续。'); } if (task.budget.maxTokens > 0 && accountedTokens(task.usage) >= task.budget.maxTokens) { throw new BudgetExceeded('task_token_limit', '这个任务的累计 token 预算已用完,请调整任务范围或新建任务。'); } }