DXIR

Read the DXIR account authenticated for this Codex connection. Browser logout or account changes do not switch this connection. Check this account before connecting a Room.

Read the selected owned Action Room, immutable report tasks, prior results and sync state. Does not execute work.

Read the complete immutable report as rendered HTML before executing its tasks. The original report JSON is private. Preserve this report version; do not substitute a newer report.

Get a short-lived download URL for one attachment already included in the selected report input. Does not read arbitrary folders or URLs. Never echo the signed URL.

Prepare an analysis from the recorded user service choice, exact inputs and sources. Preserve mutation_id and show the returned input and cost terms. Does not submit paid work. Analysis contract: Prepare, start or read a research/strategy analysis. Use the user service choice recorded by dxir_service_selection. prepare requires its selection_id, SAME mutation_id and service_key, exact input/source_ids and model. Show immutable inputs, sources, limitations and cost. Submit only the analysis the user requested and respect confirmations required by the host. DXIR applies its fixed always_auto server admission policy; this does not replace the user's authorization or host safeguards. Call start with the exact analysis_id and input_sha256; the server validates current access, prices, sources, balance and selection and returns authorization_status=automatic after atomic submission. That receipt describes server admission, not a host confirmation. Never fabricate a form response or claim submission without the server receipt. For new analyses use the returned funding contract: available personal API first when selected, otherwise a positive available DXIR wallet balance starts the analysis. Personal API usage is billed directly to the user by the provider. DXIR API charges actual usage plus its service fee only from reserved wallet funds; DXIR covers the remaining shortfall of admitted analyses and never recovers it from future topups. Under personal_first, confirmed personal API connection/quota failure continues through DXIR API. Do not request a per-analysis spending cap or an extra funding approval. Explicit personal-only choices and legacy capped drafts keep their terms. Zero starting funds without a usable personal API, stale prices, invalid inputs or revoked access stops new admission; preserve the request and resolve the cause. Report returned billing state, including API switches, sponsorship and unresolved receipts. Reuse exact IDs and poll status; an already-submitted analysis is not charged again. Deliver result and continue the user-authorized report work through its returned handoff; prepare is a fallback. Preserve cancelled/deferred work during polling. Deferred work or revised reports resume only on an explicit execution request with the current review_hash and saved mutation_id. Cancellation remains in DXIR.

dxir_analysis_prepare

Retrieve the completed report as HTML. The server may persist its already-authorized handoff and Room. Preserve this analysis and report version; completed tasks are not repeated.

dxir_analysis_result

Read the prepared analysis input, sources, cost terms and fixed automatic approval policy.

dxir_analysis_review

Submit the prepared analysis the user requested using its exact analysis_id and input_sha256. May consume the connected DXIR account balance for actual API usage and the service fee. Respect confirmations required by the host. The server checks ownership, service choice, input, pricing and balance. Reuse the same IDs after uncertainty; an already-submitted analysis is not charged again. Analysis contract: Prepare, start or read a research/strategy analysis. Use the user service choice recorded by dxir_service_selection. prepare requires its selection_id, SAME mutation_id and service_key, exact input/source_ids and model. Show immutable inputs, sources, limitations and cost. Submit only the analysis the user requested and respect confirmations required by the host. DXIR applies its fixed always_auto server admission policy; this does not replace the user's authorization or host safeguards. Call start with the exact analysis_id and input_sha256; the server validates current access, prices, sources, balance and selection and returns authorization_status=automatic after atomic submission. That receipt describes server admission, not a host confirmation. Never fabricate a form response or claim submission without the server receipt. For new analyses use the returned funding contract: available personal API first when selected, otherwise a positive available DXIR wallet balance starts the analysis. Personal API usage is billed directly to the user by the provider. DXIR API charges actual usage plus its service fee only from reserved wallet funds; DXIR covers the remaining shortfall of admitted analyses and never recovers it from future topups. Under personal_first, confirmed personal API connection/quota failure continues through DXIR API. Do not request a per-analysis spending cap or an extra funding approval. Explicit personal-only choices and legacy capped drafts keep their terms. Zero starting funds without a usable personal API, stale prices, invalid inputs or revoked access stops new admission; preserve the request and resolve the cause. Report returned billing state, including API switches, sponsorship and unresolved receipts. Reuse exact IDs and poll status; an already-submitted analysis is not charged again. Deliver result and continue the user-authorized report work through its returned handoff; prepare is a fallback. Preserve cancelled/deferred work during polling. Deferred work or revised reports resume only on an explicit execution request with the current review_hash and saved mutation_id. Cancellation remains in DXIR.

dxir_analysis_start

Retrieve the saved analysis status and billing state. On completion the server may persist its already-authorized report handoff and Room. Does not start another analysis or rerun completed tasks.

dxir_analysis_status

Attach the current executor to the report Room using the actual folder connection and stable execution_context_id. Reuse the returned executor_key on retries.

dxir_handoff_bind