mirror of
https://github.com/stablyai/orca.git
synced 2026-11-16 02:47:34 +00:00
88 lines
3.5 KiB
TypeScript
88 lines
3.5 KiB
TypeScript
import { RuntimeClientError, RuntimeRpcFailureError } from './runtime-client'
|
|
import { classifyAgentLaunchReplayRefusal } from '../shared/agent-launch/contracts/agent-launch-replay-refusal'
|
|
import {
|
|
recoverableOrchestrationArgs,
|
|
resolveOrchestrationCliExecutable
|
|
} from './runtime/orchestration-recovery-command'
|
|
|
|
/** A lost reply never authorizes a new launch, even on hosts without a replay ledger. */
|
|
export async function withCliAgentLaunchRecovery<T>(
|
|
launch: Promise<T>,
|
|
recovery: {
|
|
operationId?: string
|
|
replayed?: boolean
|
|
rawArgs?: readonly string[]
|
|
params: unknown
|
|
}
|
|
): Promise<T> {
|
|
try {
|
|
return await launch
|
|
} catch (error) {
|
|
// A replay method's ordinary refusal proves no effects; legacy errors may follow a spawn.
|
|
if (
|
|
recovery.operationId &&
|
|
error instanceof RuntimeRpcFailureError &&
|
|
error.code !== 'runtime_error' &&
|
|
classifyAgentLaunchReplayRefusal(error, recovery.replayed === true) !== 'unknown'
|
|
) {
|
|
throw error
|
|
}
|
|
// This specific lineage refusal occurs before creation or agent start on every launch route.
|
|
if (error instanceof RuntimeRpcFailureError && error.code === 'LINEAGE_PARENT_AMBIGUOUS') {
|
|
throw error
|
|
}
|
|
// Keep the setup choice's pre-launch refusal intact for the CLI's existing recovery.
|
|
if (
|
|
error instanceof RuntimeClientError &&
|
|
error.message === 'Setup decision required for this repository'
|
|
) {
|
|
throw error
|
|
}
|
|
const args = recovery.rawArgs && recoverableOrchestrationArgs(recovery.rawArgs)
|
|
const retryArgs: string[] = []
|
|
for (let index = 0; index < (args?.length ?? 0); index++) {
|
|
const arg = args?.[index]
|
|
if (arg === '--retry-launch') {
|
|
index++
|
|
} else if (arg && !arg.startsWith('--retry-launch=')) {
|
|
retryArgs.push(arg)
|
|
}
|
|
}
|
|
const recoveryCommand =
|
|
args && recovery.operationId
|
|
? [
|
|
resolveOrchestrationCliExecutable(),
|
|
...retryArgs,
|
|
'--retry-launch',
|
|
recovery.operationId
|
|
]
|
|
: undefined
|
|
const nextSteps = recovery.operationId
|
|
? [
|
|
`Re-issue the exact same command from the same directory against the same execution host with --retry-launch ${recovery.operationId}. Keep that ID on every retry; never retry as a fresh launch.`,
|
|
'If replay reports an unknown or expired outcome, inspect the workspace and agent without sending input before deciding what to do.'
|
|
]
|
|
: [
|
|
'Do not repeat the launch: this older host cannot prove whether it started the agent or sent the prompt.',
|
|
'Inspect worktree list and terminal list on the execution host, then read the agent without sending input. Confirm the outcome before deliberately starting another agent.'
|
|
]
|
|
// Replace transport restart-and-retry advice: the accepted launch may still be running.
|
|
throw new RuntimeClientError(
|
|
'agent_session_operation_unknown',
|
|
'Orca could not confirm the launch outcome; the agent may already be running and the prompt may already be submitted.',
|
|
{
|
|
launchOutcome: 'unknown',
|
|
retrySafe: Boolean(recovery.operationId),
|
|
...(recovery.operationId ? { operationId: recovery.operationId } : {}),
|
|
launchRequest: recovery.params,
|
|
...(recoveryCommand ? { recoveryCommand } : {}),
|
|
nextSteps,
|
|
cause:
|
|
error instanceof Error
|
|
? error.message.replace(/\bRestart Orca and try again\./g, '')
|
|
: String(error)
|
|
}
|
|
)
|
|
}
|
|
}
|