Files
Agent-Workbench/src/shared/contracts/execution.mjs
T

92 lines
4.8 KiB
JavaScript

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 预算已用完,请调整任务范围或新建任务。');
}
}