mirror of
https://github.com/stablyai/orca.git
synced 2026-11-16 19:07:41 +00:00
* refactor(cli): group runtime modules by responsibility * test(cli): retain QR privacy and mounted AppImage observations
152 lines
5.1 KiB
TypeScript
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
|
|
}
|
|
}
|