/rescue

Gemini Rescue

EXTERNAL_MODEL_CONTRACT_VERSION=1

$ARGUMENTS is the raw user rescue request. Preserve raw $ARGUMENTS after routing --foreground, --background, and documented model flags.

For long-running work, launch a background job:

Prompt payload: Write the routed focus text to a private temp file (mode 0600), set RELAY_PROMPT_FILE to that path, and delete it after the command exits.

• node "${CLAUDE_PLUGIN_ROOT}/scripts/relay-run.mjs" gemini-companion.mjs run --mode=rescue --background --lifecycle-events markdown --prompt-file "$RELAY_PROMPT_FILE"

For quick attached work, run in the foreground:

• node "${CLAUDE_PLUGIN_ROOT}/scripts/relay-run.mjs" gemini-companion.mjs run --mode=rescue --foreground --lifecycle-events markdown --prompt-file "$RELAY_PROMPT_FILE"

Rescue Contract

This is a rescue contract, not a review contract. Rescue may investigate, edit files, and run verification when the user asks for implementation work. Forward the user's task text after routing documented flags; do not replace it with a new plan. Return the runtime output verbatim; do not hide failed or incomplete rescue work. Failed or incomplete rescue is not success. Report the failed state and the next safe action.

Rendering Contract

Request --lifecycle-events markdown for foreground and background review flows. Render lifecycle markdown cards directly. If a legacy JSON lifecycle envelope appears, render external_review_launched immediately. external_review_progress is a heartbeat for long foreground runs; keep the existing launch card visible and do not render it as a terminal result. If a background launch envelope has event: "launched" with an external_review field, render the same launch card immediately with session pending. If a legacy JSON external_review field appears, render it before normal prose. Lifecycle cards should include provider, job, session, run kind, mode, scope, source transmission, source bearing, selected route, fallback reason, auth path, billing path, source-send approval state, approval scope, review quality, status, error code, error message, HTTP status, and suggested action when those fields are present.

### EXTERNAL REVIEW

| Field | Value |
| --- | --- |
| Provider | <provider> |
| Job | <job_id> |
| Session | <session_id or pending> |
| Run | <foreground|background|unknown> |
| Mode | <mode> |
| Scope | <scope and scope_base/scope_paths> |
| Source | <source_content_transmission> |
| Source Bearing | <source_bearing> |
| Route | <selected_route> |
| Fallback | <fallback_reason> |
| Auth | <auth_path> |
| Billing | <billing_path> |
| Approval | <source_send_approval_state / approval_scope> |
| Review Quality | <review_quality.failed_review_slot / review_quality.semantic_failure_reasons> |
| Status | <status> |
| Error | <error_code> |
| Message | <error_message> |
| HTTP | <http_status> |
| Action | <suggested_action> |

Secret Safety

Do not print raw OAuth tokens, API-key values, session cookies, tunnel API keys, bearer tokens, or raw secret values. Credential diagnostics may show key names only.

This command is emitted for the Claude relay plugin.