sneakoscope 7.3.0 → 7.5.0

package/dist/core/hooks-runtime.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { projectRoot, readJson, writeJsonAtomic, appendJsonl, nowIso, runProcess, sha256, packageRoot, tmpdir } from './fsx.js';
+import { projectRoot, readJson, writeJsonAtomic, appendJsonl, nowIso, sha256, packageRoot } from './fsx.js';
 import { looksInteractiveCommand, interactiveCommandReason } from './no-question-guard.js';
 import { loadStateForSession, missionDir, sessionStateKey, setCurrent, stateFileForSession } from './mission.js';
 import { checkDbOperation, dbBlockReason, handleMadSksUserConfirmation } from './db-safety.js';
@@ -42,6 +42,7 @@ import { activeAuthoritativeSksSkillRefresh, activeGoalOverlayContext, attachAut
 import { sealedSubagentRoutingContext, subagentRouteContext } from './hooks-runtime/subagent-context.js';
 export { loadHookPayload, normalizeHookResult };
 export { refreshOfficialSubagentCompletionArtifacts };
+export { selftestCodexCommitHooks } from './hooks-runtime/codex-commit-hooks-selftest.js';
 async function loadState(root, payload = {}) {
     const sessionKey = conversationId(payload);
     if (!explicitConversationId(payload))
@@ -863,8 +864,9 @@ async function hookStop(root, state, payload, noQuestion, sessionKey = null) {
         await refreshOfficialSubagentCompletionArtifacts(root, state, last, sessionKey).catch(() => null);
     }
     const routeDecision = await evaluateStop(root, state, payload, { noQuestion });
-    if (routeDecision)
+    if (routeDecision && !successfulAppNarutoStopNeedsVisibleSummary(state, routeDecision)) {
         return routeDecision;
+    }
     if (!noQuestion) {
         const languageBasis = state?.prompt || state?.task || extractUserPrompt(payload) || last;
         if (!hasHonestMode(last)) {
@@ -892,13 +894,23 @@ async function hookStop(root, state, payload, noQuestion, sessionKey = null) {
         }
         if (state?.honest_loop_required)
             await resolveHonestModeLoopback(root, state, sessionKey);
-        return { continue: true };
+        return routeDecision || { continue: true };
     }
     return {
         decision: 'block',
         reason: 'SKS no-question run is not done. Continue autonomously, fix failing checks, update the active gate file, and do not ask the user.'
     };
 }
+function successfulAppNarutoStopNeedsVisibleSummary(state = {}, routeDecision = {}) {
+    const route = String(state?.route || state?.route_command || state?.mode || '')
+        .replace(/^\$/, '')
+        .replace(/[-_]/g, '')
+        .toUpperCase();
+    return route === 'NARUTO'
+        && Boolean(state?.session_scope)
+        && routeDecision?.continue === true
+        && !['hard_blocked', 'route_closed'].includes(String(routeDecision?.action || ''));
+}
 async function consumeLightRouteStop(root, payload = {}) {
     const file = path.join(root, '.sneakoscope', 'state', LIGHT_ROUTE_STOP_ARTIFACT);
     const record = await readJson(file, null).catch(() => null);
@@ -982,12 +994,22 @@ function hasHonestModeUnresolvedGap(text) {
 }
 export function honestModeGapLines(text) {
     const issue = /(gap|remaining|unverified|not verified|not run|not complete|incomplete|failed|blocked|blocker|could not|couldn't|missing|미완료|미검증|미실행|실패|차단|누락|못했|못 했|안 했|안함|아직|남은)/i;
-    return String(text || '')
+    const lines = String(text || '')
         .split(/\n/)
-        .map((line) => line.trim())
-        .filter((line) => issue.test(line) && !honestGapLineResolved(line))
+        .map((line) => line.trim());
+    return lines
+        .filter((line, index) => issue.test(line)
+        && !honestGapLineResolved(line)
+        && !honestGapHeadingResolved(line, lines.slice(index + 1).find((candidate) => candidate.length > 0)))
         .slice(0, 12);
 }
+function honestGapHeadingResolved(line, nextLine) {
+    const heading = String(line || '').replace(/^#{1,6}\s*/, '').replace(/\s*[:：]\s*$/, '').trim();
+    if (!/^(?:remaining|unresolved)\s+(?:gaps?|issues?)$|^(?:남은|미해결)\s*(?:문제|항목|갭|gap)$/i.test(heading)) {
+        return false;
+    }
+    return /^(?:없음|없습니다|없다|none|no(?:ne)?|0|0개)[.!。]?$/i.test(String(nextLine || '').trim());
+}
 function honestGapLineResolved(line) {
     if (/(?:unverified|미검증)\s*:\s*\[\s*\]/i.test(line) && /blockers?\s*:\s*\[\s*\]/i.test(line))
         return true;
@@ -1080,83 +1102,3 @@ export async function emitHook(name) {
     const result = await hookMain(name);
     process.stdout.write(`${JSON.stringify(normalizeHookResult(name, result))}\n`);
 }
-export async function selftestCodexCommitHooks() {
-    const root = tmpdir();
-    const hookBin = path.join(packageRoot(), 'dist', 'bin', 'sks.js');
-    const env = { SKS_DISABLE_UPDATE_CHECK: '1' };
-    const setup = await runProcess(process.execPath, [hookBin, 'setup', '--install-scope', 'project'], { cwd: root, env, timeoutMs: 15000, maxOutputBytes: 128 * 1024 });
-    if (setup.code !== 0)
-        throw new Error(`selftest failed: commit setup ${setup.code}: ${setup.stderr}`);
-    const runHook = (name, payload) => runProcess(process.execPath, [hookBin, 'hook', name], { cwd: root, input: JSON.stringify({ cwd: root, ...payload }), env, timeoutMs: 15000, maxOutputBytes: 128 * 1024 });
-    const id = 'commit-selftest';
-    const hook = await runHook('user-prompt-submit', { conversation_id: id, action: 'codex_git_commit', prompt: 'Generate a git commit message for the staged diff.' });
-    if (hook.code !== 0)
-        throw new Error(`selftest failed: commit hook ${hook.code}: ${hook.stderr}`);
-    const hookJson = JSON.parse(hook.stdout);
-    if (hookJson.decision === 'block' || hookJson.hookSpecificOutput?.additionalContext || !String(hookJson.systemMessage || '').includes('git action'))
-        throw new Error('selftest failed: commit route bypass');
-    const stop = await runHook('stop', { conversation_id: id, last_assistant_message: 'Fix Codex App commit message hook bypass' });
-    if (stop.code !== 0)
-        throw new Error(`selftest failed: commit stop ${stop.code}: ${stop.stderr}`);
-    const stopJson = JSON.parse(stop.stdout);
-    if (stopJson.decision === 'block' || !String(stopJson.systemMessage || '').includes('accepted without route finalization'))
-        throw new Error('selftest failed: commit stop bypass');
-    const commitPushId = 'commit-push-selftest';
-    const appCommitPushHook = await runHook('user-prompt-submit', { conversation_id: commitPushId, action: 'Codex App Git Actions Commit and Push', prompt: 'Commit and push changes.' });
-    if (appCommitPushHook.code !== 0)
-        throw new Error(`selftest failed: app commit-push hook ${appCommitPushHook.code}: ${appCommitPushHook.stderr}`);
-    const appCommitPushJson = JSON.parse(appCommitPushHook.stdout);
-    if (appCommitPushJson.decision === 'block' || appCommitPushJson.hookSpecificOutput?.additionalContext || !String(appCommitPushJson.systemMessage || '').includes('git action'))
-        throw new Error('selftest failed: app commit-push route bypass');
-    const appCommitPushStop = await runHook('stop', { conversation_id: commitPushId, last_assistant_message: 'Commit and push complete.' });
-    if (appCommitPushStop.code !== 0)
-        throw new Error(`selftest failed: app commit-push stop ${appCommitPushStop.code}: ${appCommitPushStop.stderr}`);
-    if (JSON.parse(appCommitPushStop.stdout).decision === 'block')
-        throw new Error('selftest failed: app commit-push stop bypass');
-    const appPushId = 'app-push-selftest';
-    const appPushHook = await runHook('user-prompt-submit', { conversation_id: appPushId, metadata: { source: 'codex_app', action: 'Git Actions Push' }, prompt: 'Push changes.' });
-    if (appPushHook.code !== 0)
-        throw new Error(`selftest failed: app push hook ${appPushHook.code}: ${appPushHook.stderr}`);
-    const appPushJson = JSON.parse(appPushHook.stdout);
-    if (appPushJson.decision === 'block' || appPushJson.hookSpecificOutput?.additionalContext || !String(appPushJson.systemMessage || '').includes('git action'))
-        throw new Error('selftest failed: app push metadata route bypass');
-    const appPushStop = await runHook('stop', { conversation_id: appPushId, metadata: { source: 'codex_app', action: 'Git Actions Push' }, last_assistant_message: 'Done.' });
-    if (appPushStop.code !== 0)
-        throw new Error(`selftest failed: app push stop ${appPushStop.code}: ${appPushStop.stderr}`);
-    if (JSON.parse(appPushStop.stdout).decision === 'block')
-        throw new Error('selftest failed: app push metadata stop bypass');
-    const metadataLightId = 'metadata-light-commit-push-selftest';
-    const metadataLightHook = await runHook('user-prompt-submit', { conversation_id: metadataLightId, prompt: 'Commit and push changes.' });
-    if (metadataLightHook.code !== 0)
-        throw new Error(`selftest failed: metadata-light commit-push hook ${metadataLightHook.code}: ${metadataLightHook.stderr}`);
-    const metadataLightJson = JSON.parse(metadataLightHook.stdout);
-    if (metadataLightJson.decision === 'block' || metadataLightJson.hookSpecificOutput?.additionalContext || !String(metadataLightJson.systemMessage || '').includes('git action'))
-        throw new Error('selftest failed: metadata-light app commit-push route bypass');
-    const metadataLightStop = await runHook('stop', { conversation_id: metadataLightId, last_assistant_message: 'Commit and push complete.' });
-    if (metadataLightStop.code !== 0)
-        throw new Error(`selftest failed: metadata-light commit-push stop ${metadataLightStop.code}: ${metadataLightStop.stderr}`);
-    if (JSON.parse(metadataLightStop.stdout).decision === 'block')
-        throw new Error('selftest failed: metadata-light commit-push stop bypass');
-    const settingsHook = await runHook('user-prompt-submit', { model: 'future-codex-catalog-model', metadata: { source: 'codex_app_settings', feature: 'speed profile' } });
-    if (settingsHook.code !== 0)
-        throw new Error(`selftest failed: settings hook ${settingsHook.code}: ${settingsHook.stderr}`);
-    const settingsJson = JSON.parse(settingsHook.stdout);
-    if (settingsJson.decision === 'block' || settingsJson.hookSpecificOutput?.additionalContext || !String(settingsJson.systemMessage || '').includes('settings/profile event ignored'))
-        throw new Error('selftest failed: settings/profile event should not route or block');
-    const userHook = await runHook('user-prompt-submit', { prompt: '[커밋 메시지를 생성하지 못했습니다.] 코덱스 앱에서 이 버그 수정해줘' });
-    if (userHook.code !== 0)
-        throw new Error(`selftest failed: user commit hook ${userHook.code}: ${userHook.stderr}`);
-    if (!JSON.parse(userHook.stdout).hookSpecificOutput?.additionalContext?.includes('$Naruto route prepared'))
-        throw new Error('selftest failed: user prompt route');
-    const userCommitPushHook = await runHook('user-prompt-submit', { prompt: '배포하게 커밋하고 푸쉬해줘' });
-    if (userCommitPushHook.code !== 0)
-        throw new Error(`selftest failed: user commit-push hook ${userCommitPushHook.code}: ${userCommitPushHook.stderr}`);
-    const userCommitPushJson = JSON.parse(userCommitPushHook.stdout);
-    if (userCommitPushJson.decision === 'block' || userCommitPushJson.hookSpecificOutput?.additionalContext || !String(userCommitPushJson.systemMessage || '').includes('git action'))
-        throw new Error('selftest failed: user commit-push prompt should bypass route');
-    const userCommitPushStop = await runHook('stop', { last_assistant_message: 'Commit and push complete.' });
-    if (userCommitPushStop.code !== 0)
-        throw new Error(`selftest failed: user commit-push stop ${userCommitPushStop.code}: ${userCommitPushStop.stderr}`);
-    if (JSON.parse(userCommitPushStop.stdout).decision === 'block')
-        throw new Error('selftest failed: user commit-push stop bypass');
-}

package/dist/core/image-ux-review/callout-extraction.js

@@ -27,12 +27,18 @@ export function buildIssueLedgerFromGeneratedCallouts(generatedReviewLedger = {}
         blockers.push('ux_review_text_only_fallback');
     if (generated.length && !issues.length)
         blockers.push(generated.some((image) => image.callout_extraction_status === 'pending') ? 'callout_extraction_pending' : 'callout_extraction_schema_failed');
+    const primaryGenerated = generated.find((image) => image.id === existing?.generated_image_id)
+        || generated.find((image) => image.id === issues[0]?.generated_review_image_id)
+        || generated[0]
+        || null;
     return {
         schema: 'sks.image-ux-issue-ledger.v3',
         schema_version: 3,
         extraction_source: 'image-ux-generated-review-ledger.json',
         extraction_method: 'codex_exec_resume_output_schema_preferred',
         extraction_schema: 'schemas/codex/image-ux-issue-ledger.schema.json',
+        generated_image_id: primaryGenerated?.id || existing?.generated_image_id || issues[0]?.generated_review_image_id || null,
+        generated_image_sha256: primaryGenerated?.sha256 || existing?.generated_image_sha256 || issues[0]?.generated_image_sha256 || null,
         extracted_from_generated_callout: issues.length > 0,
         issues,
         blocking_issue_count: issues.filter((issue) => ['P0', 'P1'].includes(issue.severity) && !['fixed', 'accepted_not_applicable'].includes(issue.status)).length,

package/dist/core/image-ux-review/imagegen-adapter.js

@@ -12,9 +12,11 @@ import { discoverCodexAppGeneratedImage } from './codex-app-generated-image-disc
 import { writeImageArtifactPathContract } from '../image/image-artifact-path-contract.js';
 import { registerImageArtifact } from '../image/image-artifact-registry.js';
 const DEFAULT_OPENAI_IMAGE_EDITS_ENDPOINT = 'https://api.openai.com/v1/images/edits';
+export const DEFAULT_IMAGEGEN_FETCH_TIMEOUT_MS = 180000;
+const responseDeadlines = new WeakMap();
 export function buildCalloutPrompt(sourceScreenId, context = {}) {
     return [
-        'Review this UI screenshot as a senior product design lead.',
+        'Review this UI screenshot as a senior Toss UI/UX product designer.',
         `Screenshot source id: ${sourceScreenId}.`,
         'Output must be a new image artifact, not prose.',
         'Text-only response is invalid.',
@@ -373,7 +375,7 @@ export function createOpenAIImagesApiAdapter(opts = {}) {
                     status: 'blocked',
                     blocker: auth.blocker,
                     setup_guidance: auth.auth_source === 'CODEX_LB_API_KEY'
-                        ? 'CODEX_LB_API_KEY is only a non-Codex API fallback when explicitly enabled; it does not satisfy Codex App $imagegen evidence. Attach a real Codex App $imagegen output image for full SKS verification.'
+                        ? 'Repair the selected codex-lb credential binding. Completed output from a selected provider can satisfy full evidence; codex-lb used only as a fallback while another provider is selected cannot.'
                         : 'Set OPENAI_API_KEY only for an explicit non-Codex Images API fallback, or attach a real Codex App $imagegen output image for full SKS verification.',
                     local_only: true
                 };
@@ -463,6 +465,8 @@ export function createOpenAIImagesApiAdapter(opts = {}) {
                         output_id: meta.output_id,
                         output_source: responsesOutputSource,
                         image_output_recovered_from_stream: payload?.image_output_recovered_from_stream === true,
+                        image_output_provenance: payload?.image_output_provenance || 'response.output',
+                        image_output_partial_frame: false,
                         image_artifact_path_contract: imageContract?.artifact_path || null,
                         dimensions: { width: meta.width, height: meta.height, format: meta.format },
                         latency_ms: Date.now() - started,
@@ -605,6 +609,8 @@ function codexLbTargetInputs(source = {}) {
     const inputs = {};
     if (source?.home)
         inputs.home = source.home;
+    if (source?.codexHome)
+        inputs.codexHome = source.codexHome;
     if (source?.env)
         inputs.env = source.env;
     if (typeof source?.configText === 'string')
@@ -625,15 +631,22 @@ export function imagegenCapabilityBlocker(surface = 'Codex App $imagegen') {
         blocker: 'imagegen_capability_missing',
         surface,
         model: 'gpt-image-2',
-        guidance: 'Run the request in Codex App with $imagegen/gpt-image-2 and attach the generated annotated review image path. OPENAI_API_KEY or CODEX_LB_API_KEY may be used only for an explicitly requested non-Codex API fallback, and that fallback does not satisfy Codex App imagegen evidence. SKS must not fabricate or substitute a text-only review.'
+        guidance: 'Run the request with gpt-image-2 through Codex App $imagegen or a selected, ready codex-lb provider and bind the completed generated image path. OPENAI_API_KEY, or codex-lb used while another provider is selected, remains non-Codex fallback evidence. SKS must not fabricate or substitute a text-only review.'
     };
 }
 async function resolveImagesApiAuth(opts = {}) {
+    const codexLb = opts.codexLb?.available === true ? opts.codexLb : null;
+    const target = opts.codexLbTarget || (codexLb
+        ? await resolveCodexLbImagegenTarget(codexLbTargetInputs(opts)).catch(() => null)
+        : null);
+    if (target?.selected === true)
+        return codexLbImagesApiAuth(opts, codexLb, target);
     const openAiKey = String(opts.apiKey || process.env.OPENAI_API_KEY || '').trim();
     if (openAiKey) {
         return {
             apiKey: openAiKey,
             auth_source: 'OPENAI_API_KEY',
+            api_key_source: null,
             responses_model: responsesImagegenModel(opts),
             responses_model_source: responsesImagegenModel(opts) ? 'explicit' : null,
             endpoint: imageEditsEndpoint(opts.baseUrl || 'https://api.openai.com/v1'),
@@ -641,11 +654,11 @@ async function resolveImagesApiAuth(opts = {}) {
             blocker: null
         };
     }
-    const codexLb = opts.codexLb?.available === true ? opts.codexLb : null;
     if (!codexLb) {
         return {
             apiKey: null,
             auth_source: null,
+            api_key_source: null,
             responses_model: responsesImagegenModel(opts),
             responses_model_source: null,
             endpoint: imageEditsEndpoint(opts.baseUrl || 'https://api.openai.com/v1'),
@@ -653,10 +666,12 @@ async function resolveImagesApiAuth(opts = {}) {
             blocker: 'openai_api_key_missing'
         };
     }
-    const envKey = codexLb.env_key || 'CODEX_LB_API_KEY';
-    const target = opts.codexLbTarget || await resolveCodexLbImagegenTarget(codexLbTargetInputs(opts)).catch(() => null);
+    return codexLbImagesApiAuth(opts, codexLb, target);
+}
+function codexLbImagesApiAuth(opts, codexLb, target) {
+    const envKey = codexLb?.env_key || 'CODEX_LB_API_KEY';
     const codexLbKey = String(opts.codexLbApiKey || target?.api_key || '').trim();
-    const baseUrl = target?.base_url || codexLb.base_url || opts.baseUrl || '';
+    const baseUrl = target?.base_url || codexLb?.base_url || opts.baseUrl || '';
     return {
         apiKey: codexLbKey || null,
         auth_source: envKey,
@@ -677,23 +692,27 @@ function responsesEndpoint(baseUrl = '') {
     return /\/responses$/i.test(base) ? base : `${base}/responses`;
 }
 function responsesImagegenModel(opts = {}) {
-    return String(opts.responsesModel || process.env.SKS_IMAGEGEN_RESPONSES_MODEL || process.env.OPENAI_MODEL || '').trim();
+    return String(opts.responsesModel || process.env.SKS_IMAGEGEN_RESPONSES_MODEL || '').trim();
 }
 function imagegenFetchTimeoutMs(opts = {}) {
-    const value = Number(opts.fetchTimeoutMs || process.env.SKS_IMAGEGEN_FETCH_TIMEOUT_MS || 90000);
-    return Number.isFinite(value) && value > 0 ? value : 90000;
+    const value = Number(opts.fetchTimeoutMs || process.env.SKS_IMAGEGEN_FETCH_TIMEOUT_MS || DEFAULT_IMAGEGEN_FETCH_TIMEOUT_MS);
+    return Number.isFinite(value) && value > 0 ? value : DEFAULT_IMAGEGEN_FETCH_TIMEOUT_MS;
 }
 async function fetchWithTimeout(url, init, timeoutMs) {
     const controller = new AbortController();
+    const startedAt = Date.now();
     const timeout = setTimeout(() => controller.abort(new Error(`imagegen_fetch_timeout_${timeoutMs}ms`)), timeoutMs);
     try {
-        return await fetch(url, { ...init, signal: controller.signal });
+        const response = await fetch(url, { ...init, signal: controller.signal });
+        responseDeadlines.set(response, { controller, startedAt, timeoutMs, timer: timeout });
+        return response;
     }
-    finally {
+    catch (err) {
         clearTimeout(timeout);
+        throw err;
     }
 }
-async function readResponsePayload(response, timeoutMs = 90000) {
+async function readResponsePayload(response, timeoutMs = DEFAULT_IMAGEGEN_FETCH_TIMEOUT_MS) {
     const text = await textWithTimeout(response, timeoutMs);
     if (!text)
         return {};
@@ -708,23 +727,39 @@ async function readResponsePayload(response, timeoutMs = 90000) {
     }
 }
 async function textWithTimeout(response, timeoutMs) {
+    const deadline = responseDeadlines.get(response);
+    if (deadline)
+        clearTimeout(deadline.timer);
+    const remainingMs = deadline
+        ? Math.max(1, deadline.timeoutMs - (Date.now() - deadline.startedAt))
+        : timeoutMs;
     let timeout = null;
     try {
         return await Promise.race([
             response.text(),
             new Promise((_, reject) => {
-                timeout = setTimeout(() => reject(new Error(`imagegen_response_read_timeout_${timeoutMs}ms`)), timeoutMs);
+                timeout = setTimeout(() => {
+                    const error = new Error(`imagegen_response_read_timeout_${timeoutMs}ms`);
+                    deadline?.controller.abort(error);
+                    void response.body?.cancel(error).catch(() => { });
+                    reject(error);
+                }, remainingMs);
             })
         ]);
     }
     finally {
         if (timeout)
             clearTimeout(timeout);
+        responseDeadlines.delete(response);
     }
 }
 function findResponsesImageGenerationOutput(payload) {
+    if (payload?.image_output_partial_frame === true)
+        return null;
     for (const output of Array.isArray(payload?.output) ? payload.output : []) {
         if (String(output?.type || '') === 'image_generation_call') {
+            if (String(output?.status || '') === 'partial')
+                continue;
             const b64 = typeof output?.result === 'string' ? output.result : output?.result?.b64_json || output?.b64_json || null;
             if (b64)
                 return { b64: String(b64), id: output?.id || payload?.id || null };
@@ -813,10 +848,8 @@ function imagegenRetryOptions(opts = {}) {
     return {
         sleep: opts.retrySleep,
         classifyError: (err) => {
-            const code = String(err?.code
-                || err?.name
-                || err?.message
-                || '');
+            const row = err;
+            const code = [row?.code, row?.name, row?.message].filter(Boolean).join(' ');
             if (/AbortError|timeout|abort/i.test(code))
                 return { code: 'ETIMEDOUT', status: null };
             if (/ECONNRESET|EAI_AGAIN|ETIMEDOUT|ENOTFOUND|ECONNREFUSED|fetch failed/i.test(code))
@@ -834,6 +867,9 @@ function summarizeImagegenPayload(payload) {
         model: payload?.model || null,
         error_type: payload?.error?.type || null,
         error_code: payload?.error?.code || null,
+        image_output_partial_frame: payload?.image_output_partial_frame === true,
+        partial_image_output_present: payload?.partial_image_output_present === true,
+        image_output_provenance: payload?.image_output_provenance || null,
         output_count: outputs.length,
         output: outputs.slice(0, 8).map((output) => ({
             id: output?.id || null,

package/dist/core/image-ux-review/real-callout-extractor.js

@@ -130,6 +130,7 @@ export function buildRealCalloutExtractionPrompt(input) {
     const source = input.sourceScreenshot || {};
     return [
         'Analyze the generated UX review image pixels directly.',
+        'The source screenshot is context only; do not analyze it instead of the generated annotated image.',
         'Return only visible numbered callouts from the generated image.',
         'Do not invent issues, requirements, or invisible callouts.',
         'Return bbox coordinates in the generated image coordinate system as [x,y,width,height].',