import { findOptionOccurrence } from '../../shared/command-option-occurrence' import { stat } from 'node:fs/promises' import { prepareV1File, prepareV2File } from './opencode-text-task-files' import path from 'node:path' import type { TextGenerationOperation } from '../text-generation/source-control-text-generation-types' import { pathToFileURL } from 'node:url' export type OpenCodeTextTaskInput = { directory: string /** Absent on an attached server until its source/default location is resolved there. */ externalDirectory?: string external?: { url: string; username?: string; password?: string } sessionId?: string continue?: boolean fork?: boolean share?: boolean prompt: string serverArgs: string[] agent?: string model?: string variant?: string title?: string command?: string v1Files?: { type: 'file'; mime: string; filename: string; url: string }[] v2Files?: { uri: string; name: string }[] } const aliases: Record = { m: 'model', f: 'file', c: 'continue', s: 'session', p: 'password', u: 'username', i: 'interactive' } const commonStrings = ['model', 'agent', 'format', 'file', 'title', 'session'] const commonBooleans = [ 'continue', 'fork', 'thinking', 'auto', 'yolo', 'dangerously-skip-permissions', 'print-logs' ] const v1Strings = [ 'command', 'attach', 'password', 'username', 'dir', 'port', 'variant', 'replay-limit', 'log-level' ] const v1Booleans = ['share', 'mini', 'replay', 'interactive', 'demo', 'pure'] export function openCodeTextTaskEndpoint(args: readonly string[], legacyVariantFlag = false) { const valueOptions = [ ...commonStrings.map((name) => `--${name}`), ...v1Strings.map((name) => `--${name}`), '--server', '-m', '-f', '-s', '-p', '-u' ] const attached = findOptionOccurrence(args, ['--attach'], true, valueOptions, 0, 'required') const server = findOptionOccurrence(args, ['--server'], true, valueOptions, 0, 'required') if (!attached && !server) { return undefined } if (attached && server) { throw new Error('OpenCode server options cannot be combined') } const option = attached ?? server! if (!option.value) { throw new Error('OpenCode server option requires a value') } const parsed = parseRunArgs(args, !!server, legacyVariantFlag) return { version: server ? ('v2' as const) : ('v1' as const), url: option.value, username: parsed.values.get('username'), password: parsed.values.get('password') } } function parseRunArgs(args: readonly string[], v2: boolean, legacyVariantFlag: boolean) { const values = new Map() const flags = new Map() const files: string[] = [] const message: string[] = [] const strings = new Set([ ...commonStrings, ...(v2 ? ['server', ...(legacyVariantFlag ? ['variant'] : [])] : v1Strings) ]) const booleans = new Set([...commonBooleans, ...(v2 ? ['standalone'] : v1Booleans)]) for (let index = 0; index < args.length; index++) { const token = args[index] if (token === '--') { message.push(...args.slice(index + 1)) break } if (token === '-' || !token.startsWith('-')) { message.push(token) continue } const match = token.match(/^--([^=]+)(?:=(.*))?$/) ?? token.match(/^-([a-z])(.*)$/) if (!match) { throw new Error('OpenCode run option is invalid') } let name = aliases[match[1]] ?? match[1] let value: string | undefined = match[2] if (!token.startsWith('--') && !value) { value = undefined } const negated = name.startsWith('no-') if (negated) { name = name.slice(3) } if (booleans.has(name)) { if (value !== undefined && value !== 'true' && value !== 'false') { throw new Error('OpenCode boolean run option is invalid') } if (value === undefined && ['true', 'false'].includes(args[index + 1])) { value = args[++index] } flags.set(name, negated ? false : value !== 'false') continue } if (!strings.has(name) || negated) { throw new Error('OpenCode run option is unsupported') } if (value === undefined) { if (args[index + 1] !== undefined && !args[index + 1].startsWith('-')) { value = args[++index] } else if (name === 'title' && !v2) { value = '' } else { throw new Error('OpenCode run option requires a value') } } if (name === 'file') { files.push(value) // v1's yargs file option is an array; v2's repeated flag consumes one value. if (!v2 && !token.includes('=')) { while (args[index + 1] !== undefined && !args[index + 1].startsWith('-')) { files.push(args[++index]) } } } else { if (values.has(name)) { throw new Error('OpenCode singleton run option is repeated') } values.set(name, value) } } return { values, flags, files, message } } /** Resolve the selected CLI's run contract on the host that owns its filesystem. */ export async function prepareOpenCodeTextTaskInput(input: { version: 'v1' | 'v2' cwd: string prompt: string runArgs: readonly string[] signal: AbortSignal agent?: string model?: string variant?: string legacyVariantFlag?: boolean operation?: TextGenerationOperation }): Promise { input.signal.throwIfAborted() const v2 = input.version === 'v2' const { values, flags, files, message } = parseRunArgs( input.runArgs, v2, input.legacyVariantFlag === true ) let model = values.get('model') ?? input.model if (v2 && values.has('variant')) { if (!model) { throw new Error('OpenCode variant compatibility requires a model') } // Preserve the existing pre-prompt CLI compatibility projection, including suffix precedence. model = `${model.split('#')[0]}#${values.get('variant')}` } if (values.has('format') && !['default', 'json'].includes(values.get('format')!)) { throw new Error('OpenCode output format is invalid') } if (flags.get('mini') || flags.get('demo') || values.has('replay-limit')) { throw new Error('OpenCode interactive invocation cannot run as a hidden text task') } if (flags.get('fork') && !flags.get('continue') && !values.has('session')) { throw new Error('OpenCode fork requires a session') } // These modes have user-owned history/account/retention semantics; never silently discard them. if ( input.operation !== 'conversation-name' && (flags.get('continue') || flags.get('fork') || flags.get('share') || ['session', 'attach', 'server', 'password', 'username'].some((name) => values.has(name))) ) { throw new Error('OpenCode text task requires a fresh private session') } if (v2 && values.has('server') && flags.get('standalone')) { throw new Error('OpenCode server and standalone cannot be combined') } const endpoint = values.get(v2 ? 'server' : 'attach') const directory = path.resolve(input.cwd, values.get('dir') || '.') const positional = message .map((part) => (part.includes(' ') ? `"${part.replace(/"/g, '\\"')}"` : part)) .join(' ') let prompt = positional && input.prompt ? `${positional}\n${input.prompt}` : positional || input.prompt if (!prompt.trim() && !values.has('command')) { throw new Error('OpenCode text task has no input') } const serverArgs: string[] = [] if (flags.get('print-logs')) { serverArgs.push('--print-logs') } if (!v2 && flags.get('pure')) { serverArgs.push('--pure') } if (values.has('log-level')) { const level = values.get('log-level')! if (!['DEBUG', 'INFO', 'WARN', 'ERROR'].includes(level)) { throw new Error('OpenCode log level is invalid') } serverArgs.push('--log-level', level) } const result: OpenCodeTextTaskInput = { directory, prompt, serverArgs, ...(endpoint ? { external: { url: new URL(endpoint).toString().replace(/\/$/, ''), username: values.get('username'), password: values.get('password') }, externalDirectory: values.get('dir') } : {}), ...(values.has('session') ? { sessionId: values.get('session') } : {}), ...(flags.get('continue') ? { continue: true } : {}), ...(flags.get('fork') ? { fork: true } : {}), ...(flags.get('share') ? { share: true } : {}), agent: values.get('agent') ?? input.agent, model, variant: v2 ? input.variant : (values.get('variant') ?? input.variant), command: values.get('command'), title: values.has('title') ? values.get('title') || prompt.slice(0, 50) + (prompt.length > 50 ? '...' : '') : undefined } if (v2) { if (files.length > 100) { throw new Error('OpenCode accepts at most 100 attachments') } const text: string[] = [] result.v2Files = [] for (const file of files) { const prepared = await prepareV2File(file, endpoint ? input.cwd : directory, input.signal) if (prepared.text) { text.push(prepared.text) } if (prepared.attachment) { result.v2Files.push(prepared.attachment) } } prompt = [prompt, ...text].join('\n\n') result.prompt = prompt } else { result.v1Files = [] for (const file of files) { input.signal.throwIfAborted() const filename = path.resolve(endpoint ? input.cwd : directory, file) if (endpoint) { result.v1Files.push(await prepareV1File(file, input.cwd, input.signal)) continue } const info = await stat(filename) result.v1Files.push({ type: 'file', mime: info.isDirectory() ? 'application/x-directory' : 'text/plain', filename: path.basename(filename), url: pathToFileURL(filename).href }) } } input.signal.throwIfAborted() return result }