Files
orca/src/cli/workspaces/worktree-create-agent-launch.ts
T
Neil 8af94ff899 refactor(cli): group runtime modules by responsibility (#42378)
* refactor(cli): group runtime modules by responsibility

* test(cli): retain QR privacy and mounted AppImage observations
2026-11-14 04:43:56 -08:00

152 lines
5.1 KiB
TypeScript

// Use agent.launch for surface/model/effort; older hosts fall back to the create startup terminal.
import {
folderSetupUnsupportedWarning,
withFolderSetupSupportWarning
} from './folder-setup-support-warning'
import type { AgentLaunchResult } from '../../shared/agent-launch/contracts/agent-launch-intent'
import {
AGENT_LAUNCH_LOCAL_PRESENTATION_RUNTIME_CAPABILITY,
AGENT_LAUNCH_PROMPT_CARRY_RUNTIME_CAPABILITY
} from '../../shared/agent-launch/contracts/agent-launch-runtime-capability'
import type {
RuntimeWorktreeCreateResult,
RuntimeWorktreeRecord
} from '../../shared/runtime-worktree-contracts'
import {
callAgentLaunch,
formatAgentLaunch,
hasLaunchModelFlags,
getAgentLaunchCapabilities,
type CliAgentLaunch,
SURFACE_UNSUPPORTED_MESSAGE
} from '../agents/agent-launch-request'
import { formatWorktreeShow } from './workspace-format'
import { printResult } from '../output/command-result-output'
import { RuntimeClientError } from '../runtime/connection/types'
import type { RuntimeClient } from '../runtime/client'
import { printLineageSummary } from './worktree-lineage-summary'
import { printHookWarning } from './worktree-removal-warnings'
import { withSetupDecisionRecovery } from './worktree-setup-decision-recovery'
import { withCliAgentLaunchRecovery } from '../agents/agent-launch-recovery'
type WorktreeAgentLaunchResult = Pick<
RuntimeWorktreeCreateResult,
'lineage' | 'workspaceLineage' | 'crossStoreLineage'
> & {
/** Absent only when the host could not show the worktree it just created. */
worktree?: RuntimeWorktreeRecord
launch: AgentLaunchResult
}
export async function createWorktreeWithAgent(args: {
client: RuntimeClient
flags: Map<string, string | boolean>
create: Record<string, unknown>
launch: CliAgentLaunch
json: boolean
rawArgs?: readonly string[]
}): Promise<void> {
const { client, flags, create, launch, json, rawArgs } = args
const capabilities = await getAgentLaunchCapabilities(client)
if (
!capabilities?.includes(AGENT_LAUNCH_LOCAL_PRESENTATION_RUNTIME_CAPABILITY) ||
(launch.prompt && !capabilities.includes(AGENT_LAUNCH_PROMPT_CARRY_RUNTIME_CAPABILITY))
) {
if (launch.operationId) {
throw new RuntimeClientError(
'agent_session_operation_unknown',
'This host cannot replay the earlier launch. Return to the original execution host; do not retry without --retry-launch.'
)
}
if (hasLaunchModelFlags(flags)) {
throw new RuntimeClientError(
'incompatible_runtime',
'This Orca host cannot start an agent on a chosen model or effort. Update Orca on the execution host, or omit --model and --effort.'
)
}
if (launch.surface) {
throw new RuntimeClientError('incompatible_runtime', SURFACE_UNSUPPORTED_MESSAGE)
}
const params = {
...create,
startupAgent: launch.agent,
startupPrompt: launch.prompt?.text ?? '',
launchSource: 'cli'
}
const response = await withSetupDecisionRecovery(
withCliAgentLaunchRecovery(
client.call<RuntimeWorktreeCreateResult>('worktree.create', params),
{
rawArgs,
params
}
)
)
const created = {
...response,
result: await withFolderSetupSupportWarning(client, response.result, create)
}
printHookWarning(created.result, json)
printLineageSummary(created.result, json)
printResult(created, json, formatWorktreeShow)
return
}
const launched = await withSetupDecisionRecovery(
callAgentLaunch(
client,
launch,
{
target: { kind: 'create-worktree', create },
presentation: create.activate === true ? 'focused' : 'background'
},
capabilities,
rawArgs
),
launch.operationId !== undefined
)
const worktree = await showLaunchedWorktree(client, launched.result.worktreeId)
const setupWarning = await folderSetupUnsupportedWarning(
client,
launched.result.worktreeId,
create
)
if (setupWarning) {
// stderr keeps --json output parseable while still reporting the skipped setup.
console.error(`warning: ${setupWarning}`)
}
const result: WorktreeAgentLaunchResult = {
...(worktree
? {
worktree,
lineage: worktree.lineage,
workspaceLineage: worktree.workspaceLineage ?? null,
crossStoreLineage: worktree.crossStoreLineage ?? null
}
: { lineage: null }),
launch: launched.result
}
printLineageSummary(result, json)
printResult({ ...launched, result }, json, (value) =>
[
...(value.worktree ? [formatWorktreeShow({ worktree: value.worktree })] : []),
formatAgentLaunch(value.launch)
].join('\n')
)
}
/** Reporting, never a reason to fail: the agent already runs, and a retry would start a second. */
async function showLaunchedWorktree(
client: RuntimeClient,
worktreeId: string
): Promise<RuntimeWorktreeRecord | undefined> {
try {
const shown = await client.call<{ worktree: RuntimeWorktreeRecord }>('worktree.show', {
worktree: `id:${worktreeId}`
})
return shown.result.worktree
} catch {
return undefined
}
}