OD Next Media Inputs
Use only when the current task needs media inputs. Reuse these instructions
while applicable; do not load them for tasks without asset work. Follow the
current route, stage, frozen plan, and delivery boundary. During
contract_repair, make no tool calls. Finish required input work before the
deliverable write that depends on it. Never label post-write artifact
inspection, rendering, validation, or repair as input preparation to bypass
ship-on-write.
Preserve the required slots
Use the frozen asset requirements in the existing working context: purpose,
subject, source/license constraints, geometry, reuse positions, and readiness.
Reuse suitable user assets and the same asset across pages. Deduplicate work,
not distinct subjects or required states. Do not add a new plan, manifest,
approval step, or review Agent. Preserve every required asset and quality
condition, including semantic fit, authenticity, licensing, local or inline
references, and image geometry.
Route each image slot
Decide each slot's route, and which libraries a stock search may use, with
the Core imagery-by-type rule; it is the only source of those rules.
Search stock photos
- Fetch every stock slot through the authenticated daemon wrapper in one
call, using the company service and your existing Vela login:
"$OD_NODE_BIN" "$OD_BIN" media stock-search --slots '[{"id":"hero","query":"black eyeglasses frame","width":1200,"orientation":"landscape"}]'.
Write queries in English with the subject first. The service follows configured channel priority,
tries each channel at most once within its attempt limit, ranks by alt text, and returns
each result. The wrapper downloads images into assets/stock/ and records
credits in assets/stock/credits.json. Provider keys stay on the server;
never ask the user to configure a stock-provider key.
- If the command fails or times out, or a slot returns
error, not_found,
or budget_exceeded, keep successful local files and use your available
web/image search tools for only the missing slots. This includes unavailable
service/login, API errors, rate limits and failed image downloads. Do not
call the stock tool again for those failed slots.
- Search the stock libraries' public pages or the correct official source
for a named real subject. Read each result's title/alt text, source and
license before selecting its actual image URL; never invent a URL or ID.
- Batch independent downloads, bound each request to 10–15 seconds, and
stop when the existing acquisition budget expires. On HTTP 403/429, switch
source instead of looping; at most one alternative web search per missing
slot. Keep successful images and disclose a designed placeholder when no
usable image is found.
- Download at display size (long edge 1600 px or less) and keep each JPEG or
WebP under about 400 KB.
- Preserve each photo's page URL, author when shown, and license returned by
the source in a sidecar next to the asset. Apply the Core Image attribution
rule to decide whether any of that metadata belongs in the visible artifact.
- When the time budget runs out, keep the files that succeeded. Use a
disclosed placeholder for any remaining slot.
Reuse capabilities and recover by cause
Use only tools, model IDs, parameters, and permissions actually provided for
this run. Reuse complete, valid capability results. Query only missing,
truncated, or invalidated facts; refresh relevant facts when the environment,
authorization, or an error changes the decision. A catalogue entry alone does
not prove authorization or readiness. Do not guess tool/model names or expose
credential values.
Classify failures before retrying:
- Authorization: a stable missing/invalid credential is not fixed by changing
the subject or guessing another model. Use only a verified, permitted alternative or
the existing contract's fallback; never bypass access controls.
- Parameters: correct the unsupported input using actual capability/error
information, without searching guessed aliases.
- Temporary failures: follow existing retry guidance and budgets. If a job
was accepted, retrieve its result before creating another. A retryable
transient error may justify unchanged parameters within that guidance.
- Asset mismatch: correct that slot's subject or composition; do not rename
the requested subject, delete the slot, or distort content to hide failure.
Retry only when the change addresses the cause, the relevant state changes,
or existing guidance permits retrying a temporary failure.
Do not sacrifice required quality to reduce calls; bound stock photo search
with its time budget.
Batch independent input work
When the tools support it and inputs are independent, batch search, fetch,
download, format handling, and intrinsic width/height measurements. Preserve
each item's result and failures; keep dependent requests ordered. Reuse valid
measurements for unchanged files; after transformation, remeasure affected
files before sizing their containers.
HTTP success and file/size probes do not prove semantic fit; decide it as the
Core imagery rule describes, without reading images back into the
conversation.
Collect results and stop when complete
Retain each actual job ID, status, returned cursor, original response, and
output location. Use only supported wait or batch operations. Submission and
exit success alone do not prove an asset is ready. Stop polling a job after
an explicit terminal result with complete output/error information; a failed
or interrupted terminal result is not a usable asset. Continue necessary
retrieval for running jobs, incomplete results, or new errors. Parse the saved
response again instead of requesting it merely to change formatting.
Stop acquiring assets when all required slots satisfy their content and input
conditions. If a required asset remains unavailable, follow the existing
fallback/failure contract and preserve uncertainty; never declare completion
just because fewer calls were made.