Allow passing a custom timeout to opencode run

Some models, like `gpt-5-pro`, can think for way longer than the default 5 minutes timeout. This PR allows the customization of this parameter.

Author: AurelienRibon

packages/opencode/src/cli/cmd/run.ts

@@ -82,6 +82,10 @@ export const RunCommand = cmd({
         type: "string",
         describe: "title for the session (uses truncated prompt if no value provided)",
       })
+      .option("timeout", {
+        type: "number",
+        describe: "timeout in milliseconds for each AI request (default: 300000 ms, 5 mins)",
+      })
   },
   handler: async (args) => {
     let message = args.message.join(" ")
@@ -284,6 +288,7 @@ export const RunCommand = cmd({
             model: providerID + "/" + modelID,
             command: args.command,
             arguments: message,
+            timeout: args.timeout,
           })
         }
         return await SessionPrompt.prompt({
@@ -302,6 +307,7 @@ export const RunCommand = cmd({
               text: message,
             },
           ],
+          timeout: args.timeout,
         })
       })()
       if (errorMsg) process.exit(1)

packages/opencode/src/provider/provider.ts

@@ -398,7 +398,7 @@ export namespace Provider {
     return state().then((state) => state.providers)
   }
 
-  async function getSDK(provider: ModelsDev.Provider, model: ModelsDev.Model) {
+  async function getSDK(provider: ModelsDev.Provider, model: ModelsDev.Model, runtimeOptions?: Record<string, any>) {
     return (async () => {
       using _ = log.time("getSDK", {
         providerID: provider.id,
@@ -422,14 +422,15 @@ export namespace Provider {
       const modPath =
         provider.id === "google-vertex-anthropic" ? `${installedPath}/dist/anthropic/index.mjs` : installedPath
       const mod = await import(modPath)
-      if (options["timeout"] !== undefined && options["timeout"] !== null) {
+      const timeout = runtimeOptions?.timeout ?? options["timeout"]
+      if (timeout !== undefined && timeout !== null) {
         // Only override fetch if user explicitly sets timeout
         options["fetch"] = async (input: any, init?: BunFetchRequestInit) => {
           const { signal, ...rest } = init ?? {}
 
           const signals: AbortSignal[] = []
           if (signal) signals.push(signal)
-          if (options["timeout"] !== false) signals.push(AbortSignal.timeout(options["timeout"]))
+          if (timeout !== false) signals.push(AbortSignal.timeout(timeout))
 
           const combined = signals.length > 1 ? AbortSignal.any(signals) : signals[0]
 
@@ -457,10 +458,16 @@ export namespace Provider {
     return state().then((s) => s.providers[providerID])
   }
 
-  export async function getModel(providerID: string, modelID: string) {
-    const key = `${providerID}/${modelID}`
+  export async function getModel(providerID: string, modelID: string, runtimeOptions?: Record<string, any>) {
     const s = await state()
-    if (s.models.has(key)) return s.models.get(key)!
+
+    // Include runtime options in cache key
+    // Runtime options are only used from `opencode run` command
+    const cacheKey = runtimeOptions
+      ? `${providerID}/${modelID}:${Bun.hash.xxHash32(JSON.stringify(runtimeOptions))}`
+      : `${providerID}/${modelID}`
+
+    if (s.models.has(cacheKey)) return s.models.get(cacheKey)!
 
     log.info("getModel", {
       providerID,
@@ -471,7 +478,7 @@ export namespace Provider {
     if (!provider) throw new ModelNotFoundError({ providerID, modelID })
     const info = provider.info.models[modelID]
     if (!info) throw new ModelNotFoundError({ providerID, modelID })
-    const sdk = await getSDK(provider.info, info)
+    const sdk = await getSDK(provider.info, info, runtimeOptions)
 
     try {
       const keyReal = `${providerID}/${modelID}`
@@ -480,7 +487,7 @@ export namespace Provider {
         ? await provider.getModel(sdk, realID, provider.options)
         : sdk.languageModel(realID)
       log.info("found", { providerID, modelID })
-      s.models.set(key, {
+      s.models.set(cacheKey, {
         providerID,
         modelID,
         info,

packages/opencode/src/session/prompt.ts

@@ -98,6 +98,7 @@ export namespace SessionPrompt {
     noReply: z.boolean().optional(),
     system: z.string().optional(),
     tools: z.record(z.string(), z.boolean()).optional(),
+    timeout: z.number().int().positive().optional(),
     parts: z.array(
       z.discriminatedUnion("type", [
         MessageV2.TextPart.omit({
@@ -159,11 +160,19 @@ export namespace SessionPrompt {
         state().queued.set(input.sessionID, queue)
       })
     }
+
+    // Build runtime options
+    let runtimeOptions: Record<string, unknown> | undefined = undefined
+    if (input.timeout) {
+      runtimeOptions ??= {}
+      runtimeOptions.timeout = input.timeout
+    }
+
     const agent = await Agent.get(input.agent ?? "build")
     const model = await resolveModel({
       agent,
       model: input.model,
-    }).then((x) => Provider.getModel(x.providerID, x.modelID))
+    }).then((x) => Provider.getModel(x.providerID, x.modelID, runtimeOptions))
 
     using abort = lock(input.sessionID)
 
@@ -1480,6 +1489,7 @@ export namespace SessionPrompt {
     model: z.string().optional(),
     arguments: z.string(),
     command: z.string(),
+    timeout: z.number().int().positive().optional(),
   })
   export type CommandInput = z.infer<typeof CommandInput>
   const bashRegex = /!`([^`]+)`/g
@@ -1692,6 +1702,7 @@ export namespace SessionPrompt {
       model,
       agent: agentName,
       parts,
+      timeout: input.timeout,
     })
   }