灵露花园
GENARRATIVE_REAL_E2E_VISIBLE
Goal: defend the garden and win every wave.
@@ -128,6 +132,7 @@ export function deterministicLaneDefenseInitialHtml() {
`;
}
@@ -374,12 +379,12 @@ function isUiPrototypeInspectionRequest(payload, context) {
: false;
return (
hasInputImage &&
- context.includes('resourceBar') &&
- context.includes('unitCardTray') &&
- context.includes('battlefieldGrid') &&
- context.includes('enemyEntryDirection') &&
- context.includes('waveStatus') &&
+ context.includes('informationHud') &&
+ context.includes('gameplaySurface') &&
+ context.includes('objectiveEntities') &&
context.includes('primaryControls') &&
+ context.includes('failureRestartFlow') &&
+ context.includes('responsiveLayout') &&
context.includes('implementationClarity') &&
context.includes('originalTheme')
);
@@ -397,6 +402,152 @@ function nativeResponse(response) {
return { name: 'respond_to_user', arguments: { response } };
}
+function goalContractCall() {
+ return nativeAction(
+ 'agent.goal_contract',
+ '冻结本轮可玩游戏交付目标与验收标准',
+ {
+ outcome:
+ '交付一个可完整游玩的原创植物塔防网页游戏，并让当前最终 revision 通过自动静态检查和桌面、移动双视口真实试玩。',
+ nonNegotiables: [
+ '必须形成从开始、放置防御单位、敌人移动与受伤到胜利、下一关和重开的完整闭环',
+ '必须在无人确认、无人补充输入和无人 steer 的条件下完成',
+ ],
+ preferences: ['保持单页自包含并提供清晰的桌面与移动端操作反馈'],
+ forbiddenAssumptions: [
+ '不得把静态页面、占位素材或未执行的试玩声明为完成',
+ ],
+ openQuestions: [],
+ acceptanceNodes: [
+ {
+ criterionId: 'static-current-revision',
+ criterion:
+ '当前最终 revision 的游戏入口通过可执行 JavaScript、Canvas 与完整玩法合同静态检查',
+ required: true,
+ requiredEvidence: ['tool:command.run_limited'],
+ dependsOn: [],
+ },
+ {
+ criterionId: 'playable-current-revision',
+ criterion:
+ '当前最终 revision 的完整塔防循环在桌面与移动视口均通过真实浏览器试玩',
+ required: true,
+ requiredEvidence: ['tool:preview.validate'],
+ dependsOn: ['static-current-revision'],
+ },
+ ],
+ },
+ );
+}
+
+function actionHistoryCall() {
+ return nativeAction(
+ 'agent.action_history',
+ '读取当前根 Run 的最终静态检查与真实试玩动作回执',
+ {
+ runId: null,
+ actionId: null,
+ tool: null,
+ status: 'ok',
+ limit: 10,
+ },
+ );
+}
+
+function goalContractFingerprint(context) {
+ const marker = '[Root Goal Contract]';
+ const start = context.lastIndexOf(marker);
+ if (start < 0) return null;
+ const tail = context.slice(start);
+ const end = tail.indexOf('\n\n');
+ const goalContractContext = end < 0 ? tail : tail.slice(0, end);
+ const matches = new Set(
+ [
+ ...goalContractContext.matchAll(
+ /"contractFingerprint"\s*:\s*"([0-9a-f]{64})"/giu,
+ ),
+ ].map((match) => match[1].toLowerCase()),
+ );
+ return matches.size === 1 ? [...matches][0] : null;
+}
+
+function finalAcceptanceEvidence(context, expectedRunId) {
+ const observation = latestToolObservation(context);
+ if (
+ observation?.tool !== 'agent.action_history' ||
+ observation?.status !== 'ok' ||
+ typeof observation.detail !== 'string'
+ ) {
+ throw providerError('provider-final-action-history-observation-invalid');
+ }
+ let detail;
+ try {
+ detail = JSON.parse(observation.detail);
+ } catch {
+ throw providerError('provider-final-action-history-detail-invalid');
+ }
+ if (
+ detail?.runId !== expectedRunId ||
+ !Array.isArray(detail?.actions) ||
+ detail?.count !== detail.actions.length
+ ) {
+ throw providerError('provider-final-action-history-identity-invalid');
+ }
+ const evidenceByTool = new Map();
+ for (const action of detail.actions) {
+ if (
+ action?.agentId !== 'project-supervisor' ||
+ action?.runId !== expectedRunId ||
+ action?.status !== 'ok' ||
+ typeof action?.actionId !== 'string' ||
+ !/^action-[0-9a-f]{24}$/iu.test(action.actionId) ||
+ !['command.run_limited', 'preview.validate'].includes(action?.tool)
+ ) {
+ continue;
+ }
+ evidenceByTool.set(action.tool, {
+ agentId: action.agentId,
+ runId: action.runId,
+ actionId: action.actionId,
+ });
+ }
+ const staticSmoke = evidenceByTool.get('command.run_limited');
+ const preview = evidenceByTool.get('preview.validate');
+ if (!staticSmoke || !preview) {
+ throw providerError('provider-final-acceptance-evidence-missing');
+ }
+ return { staticSmoke, preview };
+}
+
+function acceptanceUpdateCall(context, runId) {
+ const contractFingerprint = goalContractFingerprint(context);
+ if (!contractFingerprint) {
+ throw providerError('provider-goal-contract-fingerprint-missing');
+ }
+ const evidence = finalAcceptanceEvidence(context, runId);
+ return nativeAction(
+ 'agent.acceptance_update',
+ '提交当前最终 revision 的静态检查与双视口试玩验收证据',
+ {
+ contractFingerprint,
+ evaluations: [
+ {
+ criterionId: 'static-current-revision',
+ status: 'passed',
+ evidence: [evidence.staticSmoke],
+ summary: '当前最终 revision 已通过 game.static_smoke。',
+ },
+ {
+ criterionId: 'playable-current-revision',
+ status: 'passed',
+ evidence: [evidence.preview],
+ summary: '当前最终 revision 已通过桌面与移动双视口真实试玩。',
+ },
+ ],
+ },
+ );
+}
+
function completedPlanCall(explanation, steps) {
return {
name: 'update_agent_plan',
@@ -463,17 +614,6 @@ function chatTextResponse(sequence, model, content) {
};
}
-function delegateCall(agentId, task, acceptanceCriteria, expectedArtifacts) {
- return nativeAction('agent.delegate', `把独立工作交给 ${agentId}`, {
- agentId,
- task,
- acceptanceCriteria,
- expectedArtifacts,
- repairOfDelegationId: null,
- runId: null,
- });
-}
-
const projectMutationFunctionNames = new Set(
[
'blackboard.write',
@@ -492,22 +632,6 @@ const projectMutationFunctionNames = new Set(
].map(runtimeFunction),
);
-function isGameIndexArtifactContract(expectedArtifacts) {
- return (
- Array.isArray(expectedArtifacts) &&
- expectedArtifacts.length === 1 &&
- expectedArtifacts[0] === 'game/index.html'
- );
-}
-
-function isExplicitReadOnlyQualityTask(task) {
- return (
- typeof task === 'string' &&
- task.includes('只读验收') &&
- task.includes('不要修改任何文件')
- );
-}
-
function staticSmokeCall(reason) {
return nativeAction('command.run_limited', reason, {
commandId: 'game.static_smoke',
@@ -540,15 +664,6 @@ function runStatusCall(reason) {
});
}
-function repairPatchCall(reason) {
- return nativeAction('file.patch', reason, {
- path: 'game/index.html',
- oldText: hiddenCanvasCss,
- newText: visibleCanvasCss,
- expectedReplacements: 1,
- });
-}
-
function fileReadCall(path, reason) {
return nativeAction('file.read', reason, {
path,
@@ -566,6 +681,18 @@ function assetListCall(reason) {
}
function canvasAssetCall(agentId) {
+ if (agentId === 'art-director') {
+ return nativeAction('canvas.asset_generate', '生成统一视觉规范图', {
+ prompt:
+ '原创明亮花园植物塔防游戏的方形图标规范图。统一展示露华花守卫、棘刺芽守卫、雾影兽入侵者、晶苔地块、灵露资源和主要 UI 图标的轮廓、配色、材质与尺寸关系；纯色分区背景，适合后续角色、场景和 UI 共用，不使用任何现有游戏角色、Logo 或受保护视觉语言。',
+ outputPath: 'assets/art-spec.png',
+ aspectRatio: '1:1',
+ imageSize: '1K',
+ assetKind: 'icon-spec',
+ assetLabel: '游戏统一视觉规范图',
+ replaceExisting: false,
+ });
+ }
if (agentId === 'design-foundation') {
return nativeAction('canvas.asset_generate', '生成横屏游戏界面原型', {
prompt:
@@ -635,6 +762,67 @@ function revisionBlockedObservation(context) {
);
}
+function projectRevisionDriftObservation(context, tool) {
+ const observation = latestToolObservation(context);
+ const detail =
+ typeof observation?.detail === 'string' ? observation.detail : '';
+ const hasStructuredDetail =
+ detail.includes('projectRevisionDrift=true') &&
+ detail.includes('expectedRevision=') &&
+ detail.includes('currentRevision=') &&
+ detail.includes('replanRequired=true');
+ const detailUnavailable =
+ observation?.detail == null || detail === '[redacted sensitive context]';
+ return (
+ observation?.tool === tool &&
+ observation?.status === 'blocked' &&
+ observation?.summary === '并行项目变更使旧动作过期，旧动作未执行' &&
+ (hasStructuredDetail || detailUnavailable)
+ );
+}
+
+function visualAssetBlockedObservation(context) {
+ const observation = latestToolObservation(context);
+ return (
+ observation?.tool === 'runtime.visual_asset' &&
+ observation?.status === 'blocked' &&
+ typeof observation?.detail === 'string' &&
+ observation.detail.includes('expectedPath=assets/ui-prototype.png') &&
+ observation.detail.includes('requiredInspection=image.inspect')
+ );
+}
+
+function missingGeneratedVisualAssetObservation(context, agentId) {
+ const expected = {
+ 'art-director': {
+ path: 'assets/art-spec.png',
+ kind: 'icon-spec',
+ summary: '统一视觉规范图尚未按正式视觉流程生成并登记，不能完成任务',
+ },
+ 'design-foundation': {
+ path: 'assets/ui-prototype.png',
+ kind: 'ui-prototype',
+ summary: '策划界面原型图尚未按正式视觉流程生成并登记，不能完成任务',
+ },
+ 'art-asset-plan': {
+ path: 'assets/art-spritesheet.png',
+ kind: 'art-spritesheet',
+ summary: '首版美术素材图尚未按正式视觉流程生成并登记，不能完成任务',
+ },
+ }[agentId];
+ if (!expected) return false;
+ const observation = latestToolObservation(context);
+ return (
+ observation?.tool === 'runtime.visual_asset' &&
+ observation?.status === 'blocked' &&
+ observation?.summary === expected.summary &&
+ typeof observation?.detail === 'string' &&
+ (observation.detail === '[redacted sensitive context]' ||
+ (observation.detail.includes(`expectedPath=${expected.path}`) &&
+ observation.detail.includes(`expectedKind=${expected.kind}`)))
+ );
+}
+
function specialistVerificationRepairContext(context) {
return (
context.includes(
@@ -646,17 +834,27 @@ function specialistVerificationRepairContext(context) {
);
}
+function verifiedDeliveryRepairContext(context) {
+ return (
+ context.includes('当前 revision 已通过验证') &&
+ context.includes('本次修复的原生工具目录只保留 respond_to_user')
+ );
+}
+
function transientCommandObservation(context) {
const observation = latestToolObservation(context);
- const detail = observation?.detail;
+ const detail =
+ typeof observation?.detail === 'string'
+ ? observation.detail.replaceAll('\\', '/')
+ : '';
return (
observation?.tool === 'command.run_limited' &&
((observation?.status === 'blocked' &&
- (detail?.includes('repositoryContextDrift=true') ||
- (detail?.includes('projectRevisionDrift=true') &&
+ (detail.includes('repositoryContextDrift=true') ||
+ (detail.includes('projectRevisionDrift=true') &&
detail.includes('replanRequired=true')))) ||
(observation?.status === 'failed' &&
- detail?.includes('.agent/project.lock')))
+ detail.includes('.agent/project.lock')))
);
}
@@ -668,13 +866,6 @@ function successfulProjectMutationObservation(context) {
);
}
-function successfulCommandObservation(context) {
- const observation = latestToolObservation(context);
- return (
- observation?.tool === 'command.run_limited' && observation?.status === 'ok'
- );
-}
-
function observationsIncludeAsset(context, path) {
const observations = observationContext(context);
return observations.includes('# 本地项目资产') && observations.includes(path);
@@ -722,36 +913,20 @@ export function createDeterministicLaneDefenseRouter({
const readyTaskCompletionRetryCounts = new Map();
const readyTaskPreCompletionRetryCounts = new Map();
const readyTaskReplayAvailableRuns = new Set();
- const terminalRetryCounts = new Map();
- const terminalVerificationPendingRuns = new Set();
- const terminalReplayAvailableRuns = new Set();
- const terminalObservationFingerprints = new Map();
const agentCounts = new Map();
const stats = {
requestCount: 0,
contextCompactionRequestCount: 0,
planningRequestCount: 0,
finalReplyRequestCount: 0,
- initialDelegationCount: 0,
- followupDelegationCount: 0,
+ goalContractCount: 0,
+ actionHistoryCount: 0,
+ acceptanceUpdateCount: 0,
+ delegateActionCount: 0,
runStatusCount: 0,
sourceWriteCount: 0,
- sourcePatchCount: 0,
staticSmokeCount: 0,
previewValidationCount: 0,
- supervisorDirectMutationAttemptCount: 0,
- delegationContractCount: 0,
- delegationContractViolationCount: 0,
- codePrototypeDelegationCount: 0,
- codePrototypeExpectedArtifactCount: 0,
- codePrototypeGameIndexArtifactDelegationCount: 0,
- qualityReviewDelegationCount: 0,
- qualityReviewReadOnlyDelegationCount: 0,
- qualityReviewExpectedArtifactCount: 0,
- artAssetPlanDelegationCount: 0,
- artAssetPlanExpectedArtifactCount: 0,
- artAssetPlanArtifactContractCount: 0,
- qualityRevisionReplanCount: 0,
manifestReadyTaskRunCount: 0,
manifestReadyTaskCompletionCount: 0,
manifestReadyTaskFileReadCount: 0,
@@ -760,6 +935,7 @@ export function createDeterministicLaneDefenseRouter({
manifestReadyTaskPreviewValidationCount: 0,
manifestReadyTaskCanvasGenerationCount: 0,
canonicalCodeRunCount: 0,
+ canonicalCodeAssetListCount: 0,
imageInspectionRequestCount: 0,
interactionExecuteCount: 0,
readyTaskRunsByAgent: {},
@@ -771,9 +947,7 @@ export function createDeterministicLaneDefenseRouter({
byAgent: {},
};
let responseSequence = 0;
- let parentStage = 'initial-delegation';
- let initialBuilderRunId = null;
- let repairBuilderRunId = null;
+ let parentStage = 'goal-contract';
function updateReadyTaskCounts(agentId, kind) {
const current = stats.readyTaskCountsByAgent[agentId] ?? {
@@ -784,53 +958,6 @@ export function createDeterministicLaneDefenseRouter({
stats.readyTaskCountsByAgent[agentId] = current;
}
- function consumeTerminalRetry(agentId, runId) {
- const retryCount = terminalRetryCounts.get(runId) ?? 0;
- if (retryCount >= 16) {
- throw providerError(`provider-terminal-retry-exhausted:${agentId}`);
- }
- terminalRetryCounts.set(runId, retryCount + 1);
- }
-
- function retryTerminalStaticVerification(agentId, runId, tools, reason) {
- if (!tools.has(runtimeFunction('command.run_limited'))) {
- throw providerError(
- `provider-terminal-retry-verification-tool-missing:${agentId}`,
- );
- }
- consumeTerminalRetry(agentId, runId);
- terminalReplayAvailableRuns.delete(runId);
- terminalVerificationPendingRuns.add(runId);
- stats.staticSmokeCount += 1;
- return callsResponse(agentId, tools, [staticSmokeCall(reason)]);
- }
-
- function consumeTerminalReplayAuthorization(agentId, runId) {
- if (terminalVerificationPendingRuns.delete(runId)) return;
- if (terminalReplayAvailableRuns.delete(runId)) return;
- throw providerError(`provider-terminal-replay-unarmed:${agentId}`);
- }
-
- function consumeUniqueTerminalObservation(agentId, runId, context) {
- const observation = latestToolObservation(context);
- const repairFingerprint = context.includes('当前专业合同明确要求只读交付')
- ? 'read-only-delivery-repair'
- : null;
- if (!observation && !repairFingerprint) {
- throw providerError(`provider-terminal-observation-missing:${agentId}`);
- }
- const fingerprint = observation
- ? JSON.stringify(observation)
- : repairFingerprint;
- const seen = terminalObservationFingerprints.get(runId) ?? new Set();
- if (seen.has(fingerprint)) {
- throw providerError(`provider-terminal-observation-duplicate:${agentId}`);
- }
- consumeTerminalRetry(agentId, runId);
- seen.add(fingerprint);
- terminalObservationFingerprints.set(runId, seen);
- }
-
function recordReadyTaskRun(agentId, runId) {
if (!deterministicManifestReadyAgentIds.includes(agentId)) {
throw providerError(`provider-ready-agent-unsupported:${agentId}`);
@@ -893,6 +1020,21 @@ export function createDeterministicLaneDefenseRouter({
(agentId === 'preview-playtest'
? 'preview.validate'
: 'command.run_limited');
+ if (
+ tools.size === 1 &&
+ tools.has('respond_to_user') &&
+ verifiedDeliveryRepairContext(context)
+ ) {
+ readyTaskCompletionRetryArmedRuns.delete(runId);
+ readyTaskCompletionVerificationTools.delete(runId);
+ readyTaskReplayAvailableRuns.delete(runId);
+ return readyCallsResponse(
+ agentId,
+ runId,
+ tools,
+ readyTaskFinalizationCalls(context, agentId, tools),
+ );
+ }
if (readyTaskCompletionRetryArmedRuns.has(runId)) {
const observation = latestToolObservation(context);
if (
@@ -914,6 +1056,22 @@ export function createDeterministicLaneDefenseRouter({
readyTaskFinalizationCalls(context, agentId, tools),
);
}
+ if (
+ expectedVerificationTool === 'image.inspect' &&
+ observation?.tool === 'image.inspect' &&
+ ['blocked', 'failed'].includes(observation?.status) &&
+ tools.has(runtimeFunction('image.inspect'))
+ ) {
+ if (retryCount >= 16) {
+ throw providerError(
+ `provider-ready-retry-verification-exhausted:${agentId}`,
+ );
+ }
+ readyTaskCompletionRetryCounts.set(runId, retryCount + 1);
+ return readyCallsResponse(agentId, runId, tools, [
+ imageInspectCall(),
+ ]);
+ }
const transientCommandFailure = transientCommandObservation(context);
if (
transientCommandFailure &&
@@ -936,6 +1094,36 @@ export function createDeterministicLaneDefenseRouter({
);
}
const latestObservation = latestToolObservation(context);
+ if (
+ missingGeneratedVisualAssetObservation(context, agentId) &&
+ tools.has(runtimeFunction('canvas.asset_generate'))
+ ) {
+ if (retryCount >= 16) {
+ throw providerError(
+ `provider-ready-retry-verification-exhausted:${agentId}`,
+ );
+ }
+ readyTaskCompletionRetryCounts.set(runId, retryCount + 1);
+ stats.manifestReadyTaskCanvasGenerationCount += 1;
+ return readyCallsResponse(agentId, runId, tools, [
+ canvasAssetCall(agentId),
+ ]);
+ }
+ if (
+ agentId === 'design-foundation' &&
+ visualAssetBlockedObservation(context) &&
+ tools.has(runtimeFunction('image.inspect'))
+ ) {
+ if (retryCount >= 16) {
+ throw providerError(
+ `provider-ready-retry-verification-exhausted:${agentId}`,
+ );
+ }
+ readyTaskCompletionRetryCounts.set(runId, retryCount + 1);
+ readyTaskCompletionRetryArmedRuns.add(runId);
+ readyTaskCompletionVerificationTools.set(runId, 'image.inspect');
+ return readyCallsResponse(agentId, runId, tools, [imageInspectCall()]);
+ }
const successfulProjectMutation =
successfulProjectMutationObservation(context);
const standaloneSuccessfulVerification =
@@ -1120,52 +1308,20 @@ export function createDeterministicLaneDefenseRouter({
publishAgentCounts();
for (const call of calls) {
- if (call.name !== runtimeFunction('agent.delegate')) continue;
- stats.delegationContractCount += 1;
- const input = call.arguments?.input;
- const hasExplicitExpectedArtifacts = Array.isArray(
- input?.expectedArtifacts,
- );
- const expectedArtifacts = hasExplicitExpectedArtifacts
- ? input.expectedArtifacts
- : [];
- if (input?.agentId === 'code-prototype') {
- stats.codePrototypeDelegationCount += 1;
- stats.codePrototypeExpectedArtifactCount += expectedArtifacts.length;
- if (isGameIndexArtifactContract(expectedArtifacts)) {
- stats.codePrototypeGameIndexArtifactDelegationCount += 1;
- } else {
- stats.delegationContractViolationCount += 1;
- }
- } else if (input?.agentId === 'quality-review') {
- stats.qualityReviewDelegationCount += 1;
- stats.qualityReviewExpectedArtifactCount += expectedArtifacts.length;
- if (
- hasExplicitExpectedArtifacts &&
- expectedArtifacts.length === 0 &&
- isExplicitReadOnlyQualityTask(input.task)
- ) {
- stats.qualityReviewReadOnlyDelegationCount += 1;
- } else {
- stats.delegationContractViolationCount += 1;
- }
- } else if (input?.agentId === 'art-asset-plan') {
- stats.artAssetPlanDelegationCount += 1;
- stats.artAssetPlanExpectedArtifactCount += expectedArtifacts.length;
- if (
- hasExplicitExpectedArtifacts &&
- expectedArtifacts.length === 2 &&
- expectedArtifacts.includes('assets/manifest.art.json') &&
- expectedArtifacts.includes('assets/art-spritesheet.png') &&
- typeof input?.task === 'string' &&
- input.task.includes('生成')
- ) {
- stats.artAssetPlanArtifactContractCount += 1;
- } else {
- stats.delegationContractViolationCount += 1;
- }
- } else {
- stats.delegationContractViolationCount += 1;
+ if (call.name === runtimeFunction('agent.goal_contract')) {
+ stats.goalContractCount += 1;
+ } else if (call.name === runtimeFunction('agent.action_history')) {
+ stats.actionHistoryCount += 1;
+ } else if (call.name === runtimeFunction('agent.acceptance_update')) {
+ stats.acceptanceUpdateCount += 1;
+ } else if (call.name === runtimeFunction('agent.delegate')) {
+ stats.delegateActionCount += 1;
+ }
+ if (
+ agentId === 'code-prototype' &&
+ call.name === runtimeFunction('asset.list')
+ ) {
+ stats.canonicalCodeAssetListCount += 1;
}
}
}
@@ -1178,177 +1334,134 @@ export function createDeterministicLaneDefenseRouter({
}
function parentCalls(context, tools) {
- const manifestDagWaitPrompt =
- context.includes('当前正式 manifest DAG 仍有专业 task 在运行') &&
- tools.has(runtimeFunction('task.list')) &&
- tools.has(runtimeFunction('agent.run_status'));
- if (manifestDagWaitPrompt) {
- parentStage = 'await-manifest';
- stats.runStatusCount += 1;
- return callsResponse('project-supervisor', tools, [
- nativeAction('task.list', '检查正式产物任务图是否已经收敛', {}),
- runStatusCall('等待并读取并行专业任务的最新状态'),
- ]);
- }
- const delegateRepairPrompt =
- (context.includes('当前父 run 已进入只编排模式') &&
- context.includes('只保留 agent.delegate')) ||
- (parentStage === 'await-delegation-repair' &&
- tools.has(runtimeFunction('agent.delegate')));
- if (delegateRepairPrompt) {
- if (parentStage !== 'await-delegation-repair') {
- throw providerError('provider-repair-prompt-out-of-order');
+ const goalContractTool = runtimeFunction('agent.goal_contract');
+ if (tools.size === 1 && tools.has(goalContractTool)) {
+ if (parentStage !== 'goal-contract') {
+ throw providerError('provider-goal-contract-out-of-order');
}
- parentStage = 'verify-repair';
- stats.followupDelegationCount += 1;
- return callsResponse('project-supervisor', tools, [
- delegateCall(
- 'code-prototype',
- '修复最近一次真实浏览器验证证明的 canvas 不可见问题；保持现有 lane-defense-v1 交互、状态面、关卡推进和重开行为不变，并在修改后通过静态自检。',
- [
- 'game/index.html 的 canvas 在桌面与移动视口可见且有非空像素',
- 'lane-defense-v1 全部固定试玩断言继续通过',
- '修改后的当前 revision 通过 game.static_smoke',
- ],
- ['game/index.html'],
- ),
- ]);
+ parentStage = 'await-manifest';
+ return callsResponse('project-supervisor', tools, [goalContractCall()]);
+ }
+
+ const advertisedProjectMutation = [...tools].some((tool) =>
+ projectMutationFunctionNames.has(tool),
+ );
+ const advertisedSafeExecution = [
+ 'agent.goal_contract',
+ 'task.list',
+ 'agent.run_status',
+ 'command.run_limited',
+ 'preview.validate',
+ 'agent.action_history',
+ 'agent.acceptance_update',
+ ].some((tool) => tools.has(runtimeFunction(tool)));
+ if (advertisedProjectMutation && !advertisedSafeExecution) {
+ if (
+ tools.has('respond_to_user') &&
+ context.includes('当前父 run 已进入只编排模式')
+ ) {
+ return callsResponse('project-supervisor', tools, [
+ nativeResponse('专业任务尚未收敛，继续等待 Runtime 完成门复核。'),
+ ]);
+ }
+ throw providerError('provider-supervisor-direct-mutation-denied');
}
switch (parentStage) {
- case 'initial-delegation': {
- parentStage = 'claim-initial';
- stats.initialDelegationCount += 3;
- return callsResponse('project-supervisor', tools, [
- delegateCall(
- 'code-prototype',
- '生成一个紧凑但完整的植物塔防网页游戏：支持开始、选择植物、放置防御单位、敌人移动和受伤、胜利、下一关与重开；写入 game/index.html，并在修改后通过静态自检。',
- [
- 'game/index.html 提供完整 lane-defense-v1 状态面和六个可点击控件',
- '敌人会移动并受伤，关卡可胜利、进入下一关并重开',
- '修改后的当前 revision 通过 game.static_smoke',
- ],
- ['game/index.html'],
- ),
- delegateCall(
- 'quality-review',
- '执行只读验收：独立核对塔防交付合同是否覆盖植物选择、战斗、胜利、下一关、重开、桌面和移动视口；只返回合同验收重点，不要修改任何文件，也不要读取或依赖并行 code-prototype 尚未完成的项目产物。',
- [
- '验收结论覆盖完整可玩循环和双视口',
- '只读返回合同重点且项目 mutation 为零',
- ],
- [],
- ),
- delegateCall(
- 'art-asset-plan',
- '生成原创首版核心美术素材并写入正式资产清单；必须调用 canvas.asset_generate 生成 assets/art-spritesheet.png，并写入可解析的 assets/manifest.art.json，不得用占位文件代替。',
- [
- 'assets/art-spritesheet.png 是可解码的原创 1:1 PNG',
- 'assets/manifest.art.json 可解析并登记该图片',
- '生成结果已通过资产列表核对',
- ],
- ['assets/manifest.art.json', 'assets/art-spritesheet.png'],
- ),
- ]);
- }
- case 'claim-initial':
- parentStage = 'static-initial';
- stats.runStatusCount += 1;
- return callsResponse('project-supervisor', tools, [
- runStatusCall('认领两份首轮专业回执'),
- ]);
- case 'static-initial':
- parentStage = 'preview-initial';
- stats.staticSmokeCount += 1;
- return callsResponse('project-supervisor', tools, [
- staticSmokeCall('验证初版当前 revision'),
- ]);
- case 'preview-initial':
- parentStage = 'attempt-forbidden-repair';
- stats.previewValidationCount += 1;
- return callsResponse('project-supervisor', tools, [
- previewCall('真实试玩并检查桌面与移动视口'),
- ]);
- case 'attempt-forbidden-repair':
- if (observationContext(context).includes('浏览器验证已通过')) {
- parentStage = 'respond';
- return parentCalls(context, tools);
- }
- parentStage = 'await-delegation-repair';
- stats.supervisorDirectMutationAttemptCount += 1;
- return callsResponse('project-supervisor', tools, [
- repairPatchCall('根据浏览器失败诊断直接修复不可见 canvas'),
- ]);
- case 'verify-repair':
- parentStage = 'await-manifest';
- stats.runStatusCount += 1;
- return callsResponse('project-supervisor', tools, [
- runStatusCall('先认领返工后的专业交付，再验证最新 revision'),
- ]);
case 'await-manifest':
- if (!tools.has(runtimeFunction('task.list'))) {
- if (tools.has(runtimeFunction('command.run_limited'))) {
- stats.staticSmokeCount += 1;
- return callsResponse('project-supervisor', tools, [
- staticSmokeCall('刷新并行产物修改后的当前 revision 验证凭证'),
- ]);
- }
- if (tools.has(runtimeFunction('preview.validate'))) {
- parentStage = 'respond';
- stats.previewValidationCount += 1;
- return callsResponse('project-supervisor', tools, [
- previewCall('对最终 current revision 完成双视口交互试玩'),
- ]);
- }
- }
if (!manifestTasksCompleted(context)) {
+ if (
+ !tools.has(runtimeFunction('task.list')) ||
+ !tools.has(runtimeFunction('agent.run_status'))
+ ) {
+ throw providerError('provider-manifest-wait-tools-invalid');
+ }
stats.runStatusCount += 1;
return callsResponse('project-supervisor', tools, [
nativeAction('task.list', '检查正式产物任务图是否已经收敛', {}),
runStatusCall('等待并读取并行专业任务的最新状态'),
]);
}
- parentStage = 'verify-final';
+ parentStage = 'final-static-smoke';
return parentCalls(context, tools);
- case 'verify-final':
- parentStage = 'respond';
+ case 'final-static-smoke':
+ if (!tools.has(runtimeFunction('command.run_limited'))) {
+ throw providerError('provider-final-static-smoke-tool-missing');
+ }
+ parentStage = 'final-preview';
stats.staticSmokeCount += 1;
- stats.previewValidationCount += 1;
return callsResponse('project-supervisor', tools, [
staticSmokeCall('验证全部正式产物整合后的当前 revision'),
+ ]);
+ case 'final-preview': {
+ const observation = latestToolObservation(context);
+ if (
+ observation?.tool !== 'command.run_limited' ||
+ observation?.status !== 'ok'
+ ) {
+ throw providerError(
+ 'provider-final-static-smoke-observation-invalid',
+ );
+ }
+ if (!tools.has(runtimeFunction('preview.validate'))) {
+ throw providerError('provider-final-preview-tool-missing');
+ }
+ parentStage = 'final-action-history';
+ stats.previewValidationCount += 1;
+ return callsResponse('project-supervisor', tools, [
previewCall('对最终 current revision 重跑完整真实试玩和双视口检查'),
]);
- case 'respond':
+ }
+ case 'final-action-history': {
+ const observation = latestToolObservation(context);
+ if (
+ observation?.tool !== 'preview.validate' ||
+ observation?.status !== 'ok'
+ ) {
+ throw providerError('provider-final-preview-observation-invalid');
+ }
+ if (!tools.has(runtimeFunction('agent.action_history'))) {
+ throw providerError('provider-final-action-history-tool-missing');
+ }
+ parentStage = 'final-acceptance-update';
+ return callsResponse('project-supervisor', tools, [
+ actionHistoryCall(),
+ ]);
+ }
+ case 'final-acceptance-update':
+ if (!tools.has(runtimeFunction('agent.acceptance_update'))) {
+ throw providerError('provider-final-acceptance-update-tool-missing');
+ }
+ {
+ const call = acceptanceUpdateCall(
+ context,
+ extractIdentity(context).runId,
+ );
+ parentStage = 'final-respond';
+ return callsResponse('project-supervisor', tools, [call]);
+ }
+ case 'final-respond': {
+ const observation = latestToolObservation(context);
+ if (
+ observation?.tool !== 'agent.acceptance_update' ||
+ observation?.status !== 'ok'
+ ) {
+ throw providerError('provider-final-acceptance-observation-invalid');
+ }
+ if (!tools.has('respond_to_user')) {
+ throw providerError('provider-final-respond-tool-missing');
+ }
parentStage = 'done';
return callsResponse('project-supervisor', tools, [
- ...completedPlanCallsForContext(
- context,
- '可试玩项目和全部验证已经完成',
- ),
nativeResponse(
- '可试玩塔防版本已经完成，并通过静态检查、完整交互试玩以及桌面和移动视口验证。',
+ '可试玩塔防版本已经完成，并通过当前 revision 静态检查、完整交互试玩以及桌面和移动视口验证。',
),
]);
+ }
case 'done':
- if (tools.has(runtimeFunction('task.list'))) {
- parentStage = 'await-manifest';
- return parentCalls(context, tools);
- }
- if (
- tools.has(runtimeFunction('command.run_limited')) &&
- tools.has(runtimeFunction('preview.validate'))
- ) {
- parentStage = 'verify-final';
- return parentCalls(context, tools);
- }
- if (tools.has('respond_to_user')) {
- return callsResponse('project-supervisor', tools, [
- nativeResponse(
- '可试玩塔防版本已经完成，并通过正式产物检查、静态检查和双视口交互试玩。',
- ),
- ]);
- }
- throw providerError('provider-parent-done-tools-invalid');
+ throw providerError('provider-parent-terminal-duplicate');
+ case 'goal-contract':
+ throw providerError('provider-goal-contract-required-first');
default:
throw providerError(`provider-parent-stage-invalid:${parentStage}`);
}
@@ -1369,12 +1482,6 @@ export function createDeterministicLaneDefenseRouter({
fileReadCall('memory/project.md', '读取长期项目约束'),
],
],
- 'art-director': [
- [
- fileReadCall('game/game_design.md', '读取玩法规格以确定视觉方向'),
- assetListCall('核对当前已有美术资产'),
- ],
- ],
'art-polish': [
[
fileReadCall(
@@ -1428,6 +1535,43 @@ export function createDeterministicLaneDefenseRouter({
);
}
+ function artDirectorReadyCalls(runId, tools, context) {
+ const agentId = 'art-director';
+ const phase = ensureReadyTaskRun(runId, agentId);
+ if (phase === 0) {
+ return readyCallsResponse(agentId, runId, tools, [
+ assetListCall('核对当前已有美术资产'),
+ ]);
+ }
+ if (phase === 1) {
+ if (!tools.has(runtimeFunction('canvas.asset_generate'))) {
+ throw providerError('provider-ready-art-director-canvas-tool-missing');
+ }
+ stats.manifestReadyTaskCanvasGenerationCount += 1;
+ return readyCallsResponse(agentId, runId, tools, [
+ canvasAssetCall(agentId),
+ ]);
+ }
+ if (phase === 2) {
+ if (
+ tools.has('respond_to_user') &&
+ !tools.has(runtimeFunction('asset.list'))
+ ) {
+ return readyTaskCompleteResponse(agentId, runId, tools, context);
+ }
+ return readyCallsResponse(agentId, runId, tools, [
+ assetListCall('核对统一视觉规范图已经生成并登记'),
+ ]);
+ }
+ if (phase === 3) {
+ return readyTaskCompleteResponse(agentId, runId, tools, context);
+ }
+ if (phase >= 4) {
+ return readyTaskCompleteResponse(agentId, runId, tools, context);
+ }
+ throw providerError(`provider-ready-art-director-stage-invalid:${phase}`);
+ }
+
function designFoundationReadyCalls(runId, tools, context) {
const agentId = 'design-foundation';
const phase = ensureReadyTaskRun(runId, agentId);
@@ -1590,93 +1734,6 @@ export function createDeterministicLaneDefenseRouter({
);
}
- function initialArtDelegationCalls(runId, tools, context) {
- const agentId = 'art-asset-plan';
- const existingKind = runKinds.get(runId);
- if (!existingKind) {
- runKinds.set(runId, 'initial-art-delegation');
- runPhases.set(runId, 0);
- } else if (existingKind !== 'initial-art-delegation') {
- throw providerError(`provider-initial-art-run-kind-invalid:${runId}`);
- }
- const phase = runPhases.get(runId) ?? 0;
- const respond = (calls) => {
- runPhases.set(runId, phase + 1);
- return callsResponse(agentId, tools, calls);
- };
- if (phase === 0) {
- return respond([assetListCall('核对首版核心美术是否已经生成')]);
- }
- if (phase === 1) {
- stats.sourceWriteCount += 1;
- return respond([
- fileWriteCall(
- 'assets/manifest.art.json',
- `${JSON.stringify(deterministicArtManifest(true), null, 2)}\n`,
- '写入登记首版核心图片的正式美术资产清单',
- ),
- ]);
- }
- if (phase === 2) {
- if (!tools.has(runtimeFunction('canvas.asset_generate'))) {
- throw providerError('provider-initial-art-canvas-tool-missing');
- }
- return respond([canvasAssetCall(agentId)]);
- }
- if (phase === 3) {
- return respond([
- fileReadCall('assets/manifest.art.json', '回读并核对正式美术清单'),
- assetListCall('确认核心美术图片已生成并登记'),
- ]);
- }
- if (phase === 4) {
- terminalReplayAvailableRuns.add(runId);
- return respond([
- ...completedPlanCallsForContext(
- context,
- '首版核心美术和正式资产清单已经完成',
- ),
- nativeResponse('首版核心美术图片与正式资产清单已经生成并核对。'),
- ]);
- }
- if (successfulCommandObservation(context) && tools.has('respond_to_user')) {
- consumeTerminalReplayAuthorization(agentId, runId);
- return respond([
- ...completedPlanCallsForContext(
- context,
- '首版核心美术和正式资产清单已经完成并通过验证',
- ),
- nativeResponse('首版核心美术图片与正式资产清单已经生成并验证。'),
- ]);
- }
- if (
- specialistVerificationRepairContext(context) ||
- revisionBlockedObservation(context) ||
- transientCommandObservation(context)
- ) {
- return retryTerminalStaticVerification(
- agentId,
- runId,
- tools,
- '补充验证首版核心美术和正式资产清单的当前 revision',
- );
- }
- if (
- tools.has('respond_to_user') &&
- context.includes('当前 revision 已通过验证')
- ) {
- consumeTerminalReplayAuthorization(agentId, runId);
- return respond([
- ...completedPlanCallsForContext(
- context,
- '首版核心美术和正式资产清单已经完成并通过验证',
- ),
- nativeResponse('首版核心美术图片与正式资产清单已经生成并验证。'),
- ]);
- }
- throw providerError('provider-initial-art-terminal-duplicate');
- }
-
function artAssetReadyCalls(runId, tools, context) {
const agentId = 'art-asset-plan';
const phase = ensureReadyTaskRun(runId, agentId);
@@ -1693,21 +1750,16 @@ export function createDeterministicLaneDefenseRouter({
const hasCanvas = tools.has(runtimeFunction('canvas.asset_generate'));
const willGenerate = hasCanvas && !existing;
const hasVisualAsset = existing || willGenerate;
- const calls = [
+ stats.sourceWriteCount += 1;
+ stats.manifestReadyTaskFileWriteCount += 1;
+ runData.set(runId, { existing, hasCanvas, willGenerate });
+ return readyCallsResponse(agentId, runId, tools, [
fileWriteCall(
'assets/manifest.art.json',
`${JSON.stringify(deterministicArtManifest(hasVisualAsset, 'manifest-ready'), null, 2)}\n`,
'写入可解析的首版美术资产清单',
),
- ];
- stats.sourceWriteCount += 1;
- stats.manifestReadyTaskFileWriteCount += 1;
- if (willGenerate) {
- calls.push(canvasAssetCall(agentId));
- stats.manifestReadyTaskCanvasGenerationCount += 1;
- }
- runData.set(runId, { existing, hasCanvas, willGenerate });
- return readyCallsResponse(agentId, runId, tools, calls);
+ ]);
}
if (phase === 2) {
const data = runData.get(runId) ?? {
@@ -1715,11 +1767,17 @@ export function createDeterministicLaneDefenseRouter({
hasCanvas: false,
willGenerate: false,
};
+ if (data.willGenerate) {
+ stats.manifestReadyTaskCanvasGenerationCount += 1;
+ return readyCallsResponse(agentId, runId, tools, [
+ canvasAssetCall(agentId),
+ ]);
+ }
const calls = [
fileReadCall('assets/manifest.art.json', '回读并核对美术清单 JSON'),
];
stats.manifestReadyTaskFileReadCount += 1;
- if (data.willGenerate) {
+ if (data.existing) {
calls.push(assetListCall('核对新图片已登记到项目资产清单'));
} else {
calls.push(staticSmokeCall('验证美术清单写入后的当前 revision'));
@@ -1728,11 +1786,9 @@ export function createDeterministicLaneDefenseRouter({
}
return readyCallsResponse(agentId, runId, tools, calls);
}
- if (phase === 3) {
- return readyTaskCompleteResponse(agentId, runId, tools, context);
- }
- if (phase >= 4) {
+ if (phase >= 3) {
if (
+ phase >= 5 &&
!tools.has('respond_to_user') &&
!tools.has(runtimeFunction('command.run_limited')) &&
tools.has(runtimeFunction('file.write'))
@@ -1747,6 +1803,51 @@ export function createDeterministicLaneDefenseRouter({
),
]);
}
+ if (completedReadyTaskRuns.has(runId)) {
+ return readyTaskCompleteResponse(agentId, runId, tools, context);
+ }
+ const data = runData.get(runId) ?? {
+ existing: false,
+ hasCanvas: false,
+ willGenerate: false,
+ };
+ if (
+ data.willGenerate &&
+ projectRevisionDriftObservation(context, 'canvas.asset_generate')
+ ) {
+ if (!tools.has(runtimeFunction('canvas.asset_generate'))) {
+ throw providerError('provider-ready-art-canvas-tool-missing');
+ }
+ const retryCount = readyTaskPreCompletionRetryCounts.get(runId) ?? 0;
+ if (retryCount >= 16) {
+ throw providerError('provider-ready-art-canvas-retry-exhausted');
+ }
+ readyTaskPreCompletionRetryCounts.set(runId, retryCount + 1);
+ stats.manifestReadyTaskCanvasGenerationCount += 1;
+ return readyCallsResponse(agentId, runId, tools, [
+ canvasAssetCall(agentId),
+ ]);
+ }
+ if (data.willGenerate) {
+ const observation = latestToolObservation(context);
+ if (
+ observation?.tool === 'canvas.asset_generate' &&
+ observation?.status === 'ok'
+ ) {
+ stats.manifestReadyTaskFileReadCount += 1;
+ return readyCallsResponse(agentId, runId, tools, [
+ fileReadCall('assets/manifest.art.json', '回读并核对美术清单 JSON'),
+ assetListCall('核对新图片已登记到项目资产清单'),
+ ]);
+ }
+ if (phase === 3) {
+ stats.manifestReadyTaskFileReadCount += 1;
+ return readyCallsResponse(agentId, runId, tools, [
+ fileReadCall('assets/manifest.art.json', '回读并核对美术清单 JSON'),
+ assetListCall('核对新图片已登记到项目资产清单'),
+ ]);
+ }
+ }
return readyTaskCompleteResponse(agentId, runId, tools, context);
}
throw providerError(`provider-ready-art-stage-invalid:${phase}`);
@@ -1770,6 +1871,7 @@ export function createDeterministicLaneDefenseRouter({
fileReadCall('assets/manifest.art.json', '读取美术资产清单'),
fileReadCall('assets/manifest.audio.json', '读取声音事件清单'),
fileReadCall('game/index.html', '读取当前入口以保留既有试玩行为'),
+ assetListCall('核对 Canvas 登记、图集与四类切片的权威资产身份'),
]);
}
if (phase === 2) {
@@ -1859,7 +1961,6 @@ export function createDeterministicLaneDefenseRouter({
[
'design-director',
'balance-director',
- 'art-director',
'art-polish',
'audio-director',
'code-director',
@@ -1868,6 +1969,9 @@ export function createDeterministicLaneDefenseRouter({
) {
return readOnlyReadyCalls(agentId, runId, tools, context);
}
+ if (agentId === 'art-director') {
+ return artDirectorReadyCalls(runId, tools, context);
+ }
if (agentId === 'design-foundation') {
return designFoundationReadyCalls(runId, tools, context);
}
@@ -1907,223 +2011,6 @@ export function createDeterministicLaneDefenseRouter({
throw providerError(`provider-ready-agent-unsupported:${agentId}`);
}
- function codeCalls(runId, tools, context) {
- if (!runKinds.has(runId)) {
- if (!initialBuilderRunId) {
- initialBuilderRunId = runId;
- runKinds.set(runId, 'initial-builder');
- } else if (!repairBuilderRunId) {
- repairBuilderRunId = runId;
- runKinds.set(runId, 'repair-builder');
- } else {
- throw providerError('provider-extra-builder-run');
- }
- runPhases.set(runId, 0);
- }
- const kind = runKinds.get(runId);
- const phase = runPhases.get(runId);
- if (kind === 'initial-builder') {
- if (phase === 0) {
- runPhases.set(runId, 1);
- stats.sourceWriteCount += 1;
- return callsResponse('code-prototype', tools, [
- nativeAction('file.write', '写入完整可玩的塔防初版', {
- path: 'game/index.html',
- content: deterministicLaneDefenseInitialHtml(),
- }),
- ]);
- }
- if (phase === 1) {
- runPhases.set(runId, 2);
- stats.staticSmokeCount += 1;
- return callsResponse('code-prototype', tools, [
- staticSmokeCall('验证初版源码与状态面'),
- ]);
- }
- if (phase === 2) {
- runPhases.set(runId, 3);
- terminalReplayAvailableRuns.add(runId);
- return callsResponse('code-prototype', tools, [
- ...completedPlanCallsForContext(
- context,
- '初版实现和静态验证已经完成',
- ),
- nativeResponse('初版塔防玩法与交互状态面已经生成，并通过静态自检。'),
- ]);
- }
- if (phase >= 3) {
- if (
- successfulCommandObservation(context) &&
- tools.has('respond_to_user')
- ) {
- consumeTerminalReplayAuthorization('code-prototype', runId);
- return callsResponse('code-prototype', tools, [
- ...completedPlanCallsForContext(
- context,
- '初版实现和静态验证已经完成',
- ),
- nativeResponse(
- '初版塔防玩法与交互状态面已经生成，并通过静态自检。',
- ),
- ]);
- }
- if (
- specialistVerificationRepairContext(context) ||
- revisionBlockedObservation(context) ||
- transientCommandObservation(context)
- ) {
- return retryTerminalStaticVerification(
- 'code-prototype',
- runId,
- tools,
- '重试验证初版源码与状态面',
- );
- }
- if (
- tools.has('respond_to_user') &&
- context.includes('当前 revision 已通过验证')
- ) {
- consumeTerminalReplayAuthorization('code-prototype', runId);
- return callsResponse('code-prototype', tools, [
- ...completedPlanCallsForContext(
- context,
- '初版实现和静态验证已经完成',
- ),
- nativeResponse(
- '初版塔防玩法与交互状态面已经生成，并通过静态自检。',
- ),
- ]);
- }
- }
- }
- if (kind === 'repair-builder') {
- if (phase === 0) {
- runPhases.set(runId, 1);
- stats.sourcePatchCount += 1;
- return callsResponse('code-prototype', tools, [
- repairPatchCall('修复真实浏览器发现的 canvas 可见性'),
- ]);
- }
- if (phase === 1) {
- runPhases.set(runId, 2);
- stats.staticSmokeCount += 1;
- return callsResponse('code-prototype', tools, [
- staticSmokeCall('验证返工后的源码'),
- ]);
- }
- if (phase === 2) {
- runPhases.set(runId, 3);
- terminalReplayAvailableRuns.add(runId);
- return callsResponse('code-prototype', tools, [
- ...completedPlanCallsForContext(
- context,
- '画布可见性返工和静态验证已经完成',
- ),
- nativeResponse(
- '画布可见性已修复，原有完整试玩行为保持不变并通过静态自检。',
- ),
- ]);
- }
- if (phase >= 3) {
- if (
- successfulCommandObservation(context) &&
- tools.has('respond_to_user')
- ) {
- consumeTerminalReplayAuthorization('code-prototype', runId);
- return callsResponse('code-prototype', tools, [
- ...completedPlanCallsForContext(
- context,
- '画布可见性返工和静态验证已经完成',
- ),
- nativeResponse(
- '画布可见性已修复，原有完整试玩行为保持不变并通过静态自检。',
- ),
- ]);
- }
- if (
- specialistVerificationRepairContext(context) ||
- revisionBlockedObservation(context) ||
- transientCommandObservation(context)
- ) {
- return retryTerminalStaticVerification(
- 'code-prototype',
- runId,
- tools,
- '重试验证返工后的源码',
- );
- }
- if (
- tools.has('respond_to_user') &&
- context.includes('当前 revision 已通过验证')
- ) {
- consumeTerminalReplayAuthorization('code-prototype', runId);
- return callsResponse('code-prototype', tools, [
- ...completedPlanCallsForContext(
- context,
- '画布可见性返工和静态验证已经完成',
- ),
- nativeResponse(
- '画布可见性已修复，原有完整试玩行为保持不变并通过静态自检。',
- ),
- ]);
- }
- }
- }
- throw providerError(`provider-builder-stage-invalid:${kind}:${phase}`);
- }
-
- function qualityCalls(runId, tools, context) {
- const phase = runPhases.get(runId) ?? 0;
- if (phase === 0) {
- runKinds.set(runId, 'quality-review');
- runPhases.set(runId, 1);
- return callsResponse('quality-review', tools, [
- ...completedPlanCallsForContext(context, '独立验收重点已经核对'),
- nativeResponse(
- '验收必须以真实植物选择、放置、战斗推进、胜利、下一关、重开和双视口可见性为准。',
- ),
- ]);
- }
- if (phase === 1) {
- if (
- !revisionBlockedObservation(context) &&
- !context.includes('当前专业合同明确要求只读交付')
- ) {
- throw providerError('provider-quality-terminal-duplicate');
- }
- consumeUniqueTerminalObservation('quality-review', runId, context);
- runPhases.set(runId, 2);
- stats.qualityRevisionReplanCount += 1;
- return callsResponse('quality-review', tools, [
- ...completedPlanCallsForContext(
- context,
- '项目 revision 更新后已重新核对独立验收重点',
- ),
- nativeResponse(
- '已基于最新项目 revision 复核验收重点，仍需以真实植物选择、放置、战斗推进、胜利、下一关、重开和双视口可见性为准。',
- ),
- ]);
- }
- if (
- phase >= 2 &&
- tools.has('respond_to_user') &&
- (revisionBlockedObservation(context) ||
- context.includes('当前专业合同明确要求只读交付'))
- ) {
- consumeUniqueTerminalObservation('quality-review', runId, context);
- return callsResponse('quality-review', tools, [
- ...completedPlanCallsForContext(
- context,
- '项目 revision 更新后已重新核对独立验收重点',
- ),
- nativeResponse(
- '已基于最新项目 revision 复核验收重点，仍需以真实植物选择、放置、战斗推进、胜利、下一关、重开和双视口可见性为准。',
- ),
- ]);
- }
- throw providerError(`provider-quality-stage-invalid:${phase}`);
- }
-
function finalReply(identity, context) {
const key = `${identity.agentId}\0${identity.runId}`;
if (finalReplyRuns.has(key)) {
@@ -2135,6 +2022,9 @@ export function createDeterministicLaneDefenseRouter({
) {
throw providerError('provider-unexpected-text-request');
}
+ if (identity.agentId === 'project-supervisor' && parentStage !== 'done') {
+ throw providerError('provider-parent-final-reply-before-acceptance');
+ }
finalReplyRuns.add(key);
const content =
identity.agentId === 'project-supervisor'
@@ -2175,6 +2065,18 @@ export function createDeterministicLaneDefenseRouter({
context.includes('用户这轮输入：') &&
tools.has('runtime_execute')
) {
+ if (payload.reasoning_effort !== 'max') {
+ throw providerError('provider-interaction-reasoning-effort-invalid');
+ }
+ if (stats.interactionExecuteCount !== 0) {
+ throw providerError('provider-interaction-execute-duplicate');
+ }
+ if (
+ stats.manifestReadyTaskRunCount !== 0 ||
+ stats.manifestReadyTaskCompletionCount !== 0
+ ) {
+ throw providerError('provider-interaction-execute-out-of-order');
+ }
stats.planningRequestCount += 1;
stats.interactionExecuteCount += 1;
recordAgent('project-supervisor', 'planning');
@@ -2190,17 +2092,17 @@ export function createDeterministicLaneDefenseRouter({
model,
JSON.stringify({
checks: {
- resourceBar: true,
- unitCardTray: true,
- battlefieldGrid: true,
- enemyEntryDirection: true,
- waveStatus: true,
+ informationHud: true,
+ gameplaySurface: true,
+ objectiveEntities: true,
primaryControls: true,
+ failureRestartFlow: true,
+ responsiveLayout: true,
implementationClarity: true,
originalTheme: true,
},
issues: [],
- summary: '确定性 UI 原型覆盖完整横屏塔防实现合同。',
+ summary: '确定性 UI 原型覆盖完整玩法界面实现合同。',
}),
);
}
@@ -2253,15 +2155,6 @@ export function createDeterministicLaneDefenseRouter({
if (identity.agentId === 'project-supervisor') {
return parentCalls(context, tools);
}
- if (identity.agentId === 'code-prototype') {
- return codeCalls(identity.runId, tools, context);
- }
- if (identity.agentId === 'quality-review') {
- return qualityCalls(identity.runId, tools, context);
- }
- if (identity.agentId === 'art-asset-plan') {
- return initialArtDelegationCalls(identity.runId, tools, context);
- }
throw providerError(`provider-agent-unsupported:${identity.agentId}`);
} catch (error) {
stats.unexpectedRequestCount += 1;
@@ -2376,6 +2269,7 @@ function createDeterministicCanvasFixture(apiKey) {
canvasApiRequestCount: 0,
canvasGenerationRequestCount: 0,
canvasDownloadRequestCount: 0,
+ canvasSliceDownloadRequestCount: 0,
canvasGeneratedAspectRatios: {},
};
let projectTitle = null;
@@ -2473,6 +2367,137 @@ function createDeterministicCanvasFixture(apiKey) {
: '未命名游戏原型';
return json(200, { data: { folder: { folderId, label: folderLabel } } });
}
+ if (
+ request.method === 'POST' &&
+ parsed.pathname ===
+ '/api/external/v1/editor/icon-spritesheets/generations'
+ ) {
+ const idempotencyKey = request.headers['idempotency-key'];
+ if (
+ typeof idempotencyKey !== 'string' ||
+ !/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(
+ idempotencyKey,
+ )
+ ) {
+ request.resume();
+ return json(400, { error: { message: 'invalid idempotency key' } });
+ }
+ const body = await readJsonBody(request);
+ const aspectRatio = body?.aspectRatio === '16:9' ? '16:9' : '1:1';
+ const width = aspectRatio === '16:9' ? 1280 : 1024;
+ const height = aspectRatio === '16:9' ? 720 : 1024;
+ generationSequence += 1;
+ stats.canvasGenerationRequestCount += 1;
+ stats.canvasGeneratedAspectRatios[aspectRatio] =
+ (stats.canvasGeneratedAspectRatios[aspectRatio] ?? 0) + 1;
+ const imageId = `deterministic-${generationSequence}`;
+ const objectKey = `generated/deterministic/${imageId}.png`;
+ const assetObjectId = `asset-object-${imageId}`;
+ const resourceId = `resource-${imageId}`;
+ const taskId = `task-${imageId}`;
+ images.set(imageId, {
+ aspectRatio,
+ width,
+ height,
+ bytes: deterministicPng(width, height, {
+ variant: generationSequence,
+ transparent: true,
+ }),
+ objectKey,
+ downloadKind: 'generation',
+ });
+ const sliceNames = ['玩家主体', '目标与危险物', '场景与资源', '反馈特效'];
+ const iconImageSrcs = sliceNames.map((name, index) => {
+ const sliceImageId = `${imageId}-slice-${index + 1}`;
+ const sliceObjectKey = `generated/deterministic/${sliceImageId}.png`;
+ const sliceResourceId = `resource-${sliceImageId}`;
+ const sliceAssetObjectId = `asset-object-${sliceImageId}`;
+ images.set(sliceImageId, {
+ aspectRatio: '1:1',
+ width: 256,
+ height: 256,
+ bytes: deterministicPng(256, 256, {
+ variant: generationSequence * 10 + index + 1,
+ }),
+ objectKey: sliceObjectKey,
+ downloadKind: 'slice',
+ });
+ return {
+ name,
+ imageSrc: `/${sliceObjectKey}`,
+ width: 256,
+ height: 256,
+ projectId,
+ taskId,
+ sourceResourceId: resourceId,
+ resource: {
+ resourceId: sliceResourceId,
+ projectId,
+ imageSrc: `/${sliceObjectKey}`,
+ objectKey: sliceObjectKey,
+ assetObjectId: sliceAssetObjectId,
+ taskId,
+ sourceResourceId: resourceId,
+ },
+ asset: {
+ assetId: `asset-${sliceImageId}`,
+ assetObjectId: sliceAssetObjectId,
+ assetKind: 'art-spritesheet-slice',
+ projectId,
+ taskId,
+ },
+ };
+ });
+ const operationId = `task-${imageId}`;
+ generationOperations.set(operationId, {
+ spritesheetImageSrc: `/${objectKey}`,
+ objectKey,
+ assetObjectId,
+ resourceId,
+ projectId,
+ taskId,
+ width,
+ height,
+ sourceType: 'generated',
+ prompt:
+ body?.iconDescriptions?.join('\n') ??
+ 'deterministic spritesheet fixture',
+ actualPrompt:
+ body?.iconDescriptions?.join('\n') ??
+ 'deterministic spritesheet fixture',
+ model: 'deterministic-canvas-v1',
+ provider: 'deterministic-loopback',
+ spritesheetResource: {
+ resourceId,
+ projectId,
+ imageSrc: `/${objectKey}`,
+ objectKey,
+ assetObjectId,
+ width,
+ height,
+ sourceType: 'generated',
+ taskId,
+ },
+ spritesheetAsset: {
+ assetId: `asset-${imageId}`,
+ assetObjectId,
+ assetKind: 'art-spritesheet',
+ projectId,
+ taskId,
+ },
+ iconImageSrcs,
+ });
+ return json(202, {
+ data: {
+ operationId,
+ kind: 'editor_icon_spritesheet_generation',
+ status: 'queued',
+ statusUrl: `/api/external/v1/generations/${operationId}`,
+ pollAfterMs: 1,
+ updatedAtMicros: generationSequence,
+ },
+ });
+ }
if (
request.method === 'POST' &&
parsed.pathname === '/api/external/v1/editor/images/generations'
@@ -2499,7 +2524,11 @@ function createDeterministicCanvasFixture(apiKey) {
const resourceId = `resource-${imageId}`;
const assetKind =
typeof body?.assetKind === 'string' ? body.assetKind : 'game-art';
- images.set(imageId, { ...image, objectKey });
+ images.set(imageId, {
+ ...image,
+ objectKey,
+ downloadKind: 'generation',
+ });
const operationId = `task-${imageId}`;
generationOperations.set(operationId, {
imageSrc: `/${objectKey}`,
@@ -2555,7 +2584,8 @@ function createDeterministicCanvasFixture(apiKey) {
'/api/external/v1/generations/'.length,
);
const result = generationOperations.get(operationId);
- if (!result) return json(404, { error: { message: 'operation not found' } });
+ if (!result)
+ return json(404, { error: { message: 'operation not found' } });
return json(200, {
data: {
operationId,
@@ -2600,7 +2630,11 @@ function createDeterministicCanvasFixture(apiKey) {
const imageId = parsed.pathname.slice('/signed/'.length, -'.png'.length);
const image = images.get(imageId);
if (!image) return json(404, { error: { message: 'image not found' } });
- stats.canvasDownloadRequestCount += 1;
+ if (image.downloadKind === 'slice') {
+ stats.canvasSliceDownloadRequestCount += 1;
+ } else {
+ stats.canvasDownloadRequestCount += 1;
+ }
return {
statusCode: 200,
contentType: 'image/png',
diff --git a/apps/ai-game-creator-shell/scripts/direct-codex-smoke.mjs b/apps/ai-game-creator-shell/scripts/direct-codex-smoke.mjs
new file mode 100644
index 000000000..09269cdc6
--- /dev/null
+++ b/apps/ai-game-creator-shell/scripts/direct-codex-smoke.mjs
@@ -0,0 +1,139 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import readline from 'node:readline';
+
+const configPath =
+ process.env.AGC_CONFIG_PATH ??
+ 'C:/Users/kdletters/AppData/Roaming/world.genarrative.ai-game-creator/game-creator.config.json';
+const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+const args = [
+ 'app-server',
+ '--stdio',
+ '-c',
+ 'mcp_servers={}',
+ '-c',
+ 'web_search="disabled"',
+ '-c',
+ 'agents.enabled=false',
+];
+for (const feature of [
+ 'apps',
+ 'browser_use',
+ 'browser_use_external',
+ 'browser_use_full_cdp_access',
+ 'computer_use',
+ 'goals',
+ 'image_generation',
+ 'in_app_browser',
+ 'plugins',
+ 'remote_plugin',
+ 'shell_tool',
+ 'tool_suggest',
+ 'unified_exec',
+ 'workspace_dependencies',
+])
+ args.push('--disable', feature);
+args.push(
+ '-c',
+ 'model_provider="genarrative_agc"',
+ '-c',
+ 'model_providers.genarrative_agc.name="Genarrative AGC"',
+ '-c',
+ `model_providers.genarrative_agc.base_url="${config.llm.baseUrl.replace(/\/$/, '')}"`,
+ '-c',
+ 'model_providers.genarrative_agc.env_key="GENARRATIVE_AGC_API_KEY"',
+ '-c',
+ 'model_providers.genarrative_agc.wire_api="responses"',
+);
+const child = spawn(
+ 'C:/Program Files/nodejs/node.exe',
+ [
+ 'C:/Users/kdletters/AppData/Roaming/npm/node_modules/@openai/codex/bin/codex.js',
+ ...args,
+ ],
+ {
+ cwd: process.cwd(),
+ env: { ...process.env, GENARRATIVE_AGC_API_KEY: config.llm.apiKey },
+ stdio: ['pipe', 'pipe', 'pipe'],
+ },
+);
+const send = (value) => child.stdin.write(`${JSON.stringify(value)}\n`);
+const timer = setTimeout(
+ () => {
+ console.log('smoke-timeout');
+ child.kill();
+ process.exit(1);
+ },
+ Number(process.env.DIRECT_SMOKE_TIMEOUT_MS ?? 180000),
+);
+readline.createInterface({ input: child.stdout }).on('line', (line) => {
+ let message;
+ try {
+ message = JSON.parse(line);
+ } catch {
+ return;
+ }
+ if (message.id === 2) {
+ console.log('thread-start-ok');
+ const write = process.env.DIRECT_SMOKE_WRITE === '1';
+ send({
+ id: 3,
+ method: 'turn/start',
+ params: {
+ threadId: message.result.thread.id,
+ input: [
+ {
+ type: 'text',
+ text:
+ process.env.DIRECT_SMOKE_PROMPT ??
+ (write
+ ? '在当前工作区创建 smoke-marker.txt，写入 DIRECT_CODEX_WRITE_OK，然后回复已完成。'
+ : '只回复 DIRECT_CODEX_SMOKE_OK，不要修改文件。'),
+ },
+ ],
+ model: config.llm.model,
+ approvalPolicy: 'never',
+ sandboxPolicy: write
+ ? {
+ type: 'workspaceWrite',
+ writableRoots: [process.cwd()],
+ networkAccess: true,
+ }
+ : { type: 'readOnly', networkAccess: false },
+ },
+ });
+ }
+ if (message.id === 3 && message.error) {
+ console.log(`turn-start-error:${message.error.message}`);
+ clearTimeout(timer);
+ child.kill();
+ process.exit(1);
+ }
+ if (message.method === 'turn/completed') {
+ console.log(`turn-completed:${message.params?.turn?.status}`);
+ clearTimeout(timer);
+ child.kill();
+ process.exit(message.params?.turn?.status === 'completed' ? 0 : 1);
+ }
+});
+send({
+ id: 1,
+ method: 'initialize',
+ params: {
+ clientInfo: { name: 'agc-direct-smoke', version: '0.1' },
+ capabilities: { experimentalApi: true },
+ },
+});
+send({ method: 'initialized', params: {} });
+send({
+ id: 2,
+ method: 'thread/start',
+ params: {
+ cwd: process.cwd(),
+ model: config.llm.model,
+ approvalPolicy: 'never',
+ sandbox:
+ process.env.DIRECT_SMOKE_WRITE === '1' ? 'workspace-write' : 'read-only',
+ ephemeral: true,
+ },
+});
diff --git a/apps/ai-game-creator-shell/scripts/start-dev-server.mjs b/apps/ai-game-creator-shell/scripts/start-dev-server.mjs
index 355e29197..db7c8d42c 100644
--- a/apps/ai-game-creator-shell/scripts/start-dev-server.mjs
+++ b/apps/ai-game-creator-shell/scripts/start-dev-server.mjs
@@ -47,7 +47,7 @@ function isAiGameCreatorServer(response) {
response &&
response.statusCode >= 200 &&
response.statusCode < 500 &&
- response.body.includes('
+![](\"/assets/direct-game-background.png\")
",
+ )
+ .expect("index");
+ std::fs::write(root.path().join("game/style.css"), "body {}").expect("style");
+ std::fs::write(
+ root.path().join("game/game.js"),
+ "const player = new Image(); player.src = '/assets/art-spritesheet-slices/player.png'; const target = new Image(); target.src = '/assets/art-spritesheet-slices/blocks-and-targets.png'; const obstacle = new Image(); obstacle.src = '/assets/art-spritesheet-slices/obstacles-and-scene.png'; const feedback = new Image(); feedback.src = '/assets/art-spritesheet-slices/feedback-effects.png'; const ctx = document.querySelector('#game').getContext('2d'); ctx.drawImage(player, 0, 0); ctx.drawImage(target, 1, 1); ctx.drawImage(obstacle, 2, 2); ctx.drawImage(feedback, 3, 3); requestAnimationFrame(()=>{});",
+ )
+ .expect("script");
+
+ let initial_fingerprint = direct_codex_output_fingerprint(root.path());
+ sync_direct_codex_project_outputs_at(root.path(), Some(&initial_fingerprint))
+ .expect("sync outputs");
+
+ let manifest = read_manifest(&root.path().join(".agent/manifest.json")).expect("manifest");
+ assert!(manifest.assets.iter().any(|asset| {
+ asset.local_path == "game/index.html" && asset.media_type == "text/html"
+ }));
+ assert!(manifest.assets.iter().any(|asset| {
+ asset.local_path == "game/style.css" && asset.media_type == "text/css"
+ }));
+ assert!(manifest.assets.iter().any(|asset| {
+ asset.local_path == "game/game.js" && asset.media_type == "text/javascript"
+ }));
+ assert_eq!(
+ manifest
+ .tasks
+ .iter()
+ .find(|task| task.id == "code-prototype")
+ .map(|task| task.status.clone()),
+ Some(GameCreationAppTaskStatus::Completed)
+ );
+ assert_eq!(manifest.versions.len(), 1);
+ assert_eq!(manifest.versions[0].version_id, "initial-1");
+ assert_eq!(manifest.versions[0].project_revision, 1);
+ assert_eq!(manifest.versions[0].resource_bindings.len(), 6);
+ for expected_path in DIRECT_CODEX_ART_ASSET_PATHS {
+ assert!(manifest.versions[0]
+ .resource_bindings
+ .iter()
+ .any(|binding| {
+ manifest
+ .assets
+ .iter()
+ .find(|asset| asset.id == binding.resource_id)
+ .is_some_and(|asset| asset.local_path == expected_path)
+ }));
+ }
+
+ let first_asset_ids = manifest
+ .assets
+ .iter()
+ .map(|asset| asset.id.clone())
+ .collect::