@opencode/client 2.0.24 → 2.0.25

package/dist/effect/index.js

@@ -1,15 +1,15 @@
 import {
-  ClientError3
-} from "../chunks/pty-handoff-7f0py9js.js";
-import"../chunks/pty-handoff-vmytr4q8.js";
-import"../chunks/pty-handoff-5yf5aaev.js";
-import"../chunks/pty-handoff-6mptkzbc.js";
-import"../chunks/pty-handoff-frbwqjmf.js";
-import"../chunks/pty-handoff-t1xa31vm.js";
-import"../chunks/pty-handoff-w1w809zr.js";
+  ClientError2
+} from "../chunks/service-probe-y2etg5bs.js";
+import"../chunks/service-probe-vmytr4q8.js";
+import"../chunks/service-probe-vnspkrex.js";
+import"../chunks/service-probe-6mptkzbc.js";
+import"../chunks/service-probe-frbwqjmf.js";
+import"../chunks/service-probe-t1xa31vm.js";
+import"../chunks/service-probe-65kht65h.js";
 import {
-  exports_client3
-} from "../chunks/pty-handoff-myyn5x39.js";
+  exports_client
+} from "../chunks/service-probe-y99g37y2.js";
 
 // src/effect/index.ts
 import { Agent } from "@opencode/schema/agent";
@@ -43,7 +43,7 @@ import { PromptInput } from "@opencode/schema/prompt-input";
 export {
   AbsolutePath,
   Agent,
-  ClientError3 as ClientError,
+  ClientError2 as ClientError,
   Command,
   Config,
   Credential,
@@ -54,7 +54,7 @@ export {
   Integration,
   Location,
   Model,
-  exports_client3 as OpenCode,
+  exports_client as OpenCode,
   Permission,
   PermissionSaved,
   Project,

package/dist/effect/rpc.js

@@ -1,11 +1,11 @@
 import {
-  make6,
+  make3,
   aborted2,
   exports_rpc
-} from "../chunks/pty-handoff-w1w809zr.js";
-import"../chunks/pty-handoff-t1xa31vm.js";
+} from "../chunks/service-probe-65kht65h.js";
+import"../chunks/service-probe-t1xa31vm.js";
 export {
   exports_rpc as RpcClientRuntime,
   aborted2 as aborted,
-  make6 as make
+  make3 as make
 };

package/dist/effect/service.d.ts

@@ -29,7 +29,14 @@ export declare const incumbent: (options: DiscoverOptions & {
     state: "failed" | "ready" | "waiting";
 } | undefined, never, FileSystem.FileSystem>;
 /** Ensure a healthy, compatible local service is running. */
-export declare const ensure: (options?: EnsureOptions | undefined) => Effect.Effect<import("./service.js").Endpoint, Error, FileSystem.FileSystem>;
+export declare const ensure: (options?: EnsureOptions | undefined) => Effect.Effect<{
+    url: string;
+    auth: {
+        type: "basic";
+        username: string;
+        password: string;
+    } | undefined;
+}, Error, FileSystem.FileSystem>;
 /** Stop the registered local service. */
 export declare const stop: (options?: StopOptions | undefined) => Effect.Effect<void, Error, FileSystem.FileSystem>;
 /** Schema for the local service registration file. */
@@ -63,7 +70,14 @@ export declare const Service: {
         };
         state: "failed" | "ready" | "waiting";
     } | undefined, never, FileSystem.FileSystem>;
-    ensure: (options?: EnsureOptions | undefined) => Effect.Effect<import("./service.js").Endpoint, Error, FileSystem.FileSystem>;
+    ensure: (options?: EnsureOptions | undefined) => Effect.Effect<{
+        url: string;
+        auth: {
+            type: "basic";
+            username: string;
+            password: string;
+        } | undefined;
+    }, Error, FileSystem.FileSystem>;
     stop: (options?: StopOptions | undefined) => Effect.Effect<void, Error, FileSystem.FileSystem>;
     headers: typeof headers;
     Info: Schema.Struct<{

package/dist/effect/service.js

@@ -1,27 +1,28 @@
 import {
   spawnServiceContender2,
   contenderPool2
-} from "../chunks/pty-handoff-ve4aws36.js";
+} from "../chunks/service-probe-ve4aws36.js";
 import {
   defaultEnsureTiming2,
   ensureTiming2
-} from "../chunks/pty-handoff-xgnj2w4v.js";
+} from "../chunks/service-probe-xgnj2w4v.js";
 import {
   matchesVersion2
-} from "../chunks/pty-handoff-sxt88q69.js";
+} from "../chunks/service-probe-sxt88q69.js";
 import {
   prepare2,
   environment2,
   complete2,
   clear2
-} from "../chunks/pty-handoff-71wkqa80.js";
+} from "../chunks/service-probe-1thtawyv.js";
 import {
+  decide2,
   fallback2,
   same2,
   probeResult2,
   headers2
-} from "../chunks/pty-handoff-ank0d71z.js";
-import"../chunks/pty-handoff-qav6mfdz.js";
+} from "../chunks/service-probe-2ny4vxct.js";
+import"../chunks/service-probe-qav6mfdz.js";
 
 // src/effect/service.ts
 import { Effect, FileSystem, Option, Schedule, Schema } from "effect";
@@ -91,26 +92,20 @@ var ensure = Effect.fn("service.ensure")(function* (options = {}) {
       timeouts = undefined;
     if (service2 !== undefined) {
       pool.serviceAnswered();
-      const versionMatches = matchesVersion2(service2.version, options);
-      const compatible = service2.compatible && versionMatches;
-      if (!service2.compatible && versionMatches)
-        return yield* Effect.fail(new Error("Background service uses an incompatible health protocol. Update this client or explicitly restart the service."));
-      if (compatible && service2.state === "ready") {
+      const decision = decide2(service2, options);
+      if (decision._tag === "fail")
+        return yield* Effect.fail(decision.error);
+      if (decision._tag === "reuse") {
         yield* Effect.tryPromise(() => complete2(options.file ?? fallback2(), service2.info));
         return Option.some(service2);
       }
-      if (compatible && service2.state === "failed")
-        return yield* Effect.fail(new Error("Background service failed to start"));
-      if (compatible)
-        return Option.none();
-      yield* announce("version-mismatch", service2.version);
-      if (service2.state !== "ready")
-        yield* Effect.logWarning("Background service is not ready; replacement cannot preserve persistent terminals");
-      yield* stop({
-        file: options.file,
-        pty: service2.state === "ready" ? "handoff" : "clear"
-      }).pipe(Effect.ignore);
-      pool.evict(service2.info.pid);
+      if (decision._tag === "replace") {
+        yield* announce("version-mismatch", service2.version);
+        if (service2.state !== "ready")
+          yield* Effect.logWarning("Background service is not ready; replacement cannot preserve persistent terminals");
+        yield* stop({ file: options.file, pty: decision.pty }).pipe(Effect.ignore);
+        pool.evict(service2.info.pid);
+      }
       return Option.none();
     }
     const failed = pool.reap();

package/dist/promise/client.d.ts

@@ -113,6 +113,7 @@ export declare function make(options: ClientOptions): {
         };
         connect: {
             key: (input: import("./index.js").IntegrationConnectKeyInput, requestOptions?: OpenCode.RequestOptions) => Promise<void>;
+            external: (input: import("./index.js").IntegrationConnectExternalInput, requestOptions?: OpenCode.RequestOptions) => Promise<void>;
         };
         oauth: {
             connect: (input: import("./index.js").IntegrationOauthConnectInput, requestOptions?: OpenCode.RequestOptions) => Promise<import("./index.js").IntegrationOauthConnectOutput>;

package/dist/promise/client.js

@@ -1,14 +1,14 @@
 import {
-  make2,
-  exports_client
-} from "../chunks/pty-handoff-cqfz2qxq.js";
-import"../chunks/pty-handoff-vyas3vgt.js";
-import"../chunks/pty-handoff-qzsnm4q8.js";
-import"../chunks/pty-handoff-js54wxgp.js";
-import"../chunks/pty-handoff-1y4a697q.js";
-import"../chunks/pty-handoff-vt9jbch8.js";
-import"../chunks/pty-handoff-frbwqjmf.js";
+  make5,
+  exports_client3
+} from "../chunks/service-probe-z1hcmzxa.js";
+import"../chunks/service-probe-vyas3vgt.js";
+import"../chunks/service-probe-1y4a697q.js";
+import"../chunks/service-probe-vt9jbch8.js";
+import"../chunks/service-probe-9h52wrcy.js";
+import"../chunks/service-probe-nwcpakzx.js";
+import"../chunks/service-probe-frbwqjmf.js";
 export {
-  exports_client as OpenCode,
-  make2 as make
+  exports_client3 as OpenCode,
+  make5 as make
 };

package/dist/promise/generated/client-error.js

@@ -1,6 +1,6 @@
 import {
-  ClientError2
-} from "../../chunks/pty-handoff-js54wxgp.js";
+  ClientError3
+} from "../../chunks/service-probe-nwcpakzx.js";
 export {
-  ClientError2 as ClientError
+  ClientError3 as ClientError
 };

package/dist/promise/generated/client.d.ts

@@ -1,4 +1,4 @@
-import type { ServerConnectInput, LocationGetInput, AgentListInput, AgentListOutput, AgentGetInput, AgentGetOutput, PluginListInput, PluginListOutput, PluginCheckInput, PluginCheckOutput, PluginUpdateInput, SessionListInput, SessionStatsInput, SessionCreateInput, SessionImportInput, SessionExportInput, SessionGetInput, SessionRemoveInput, SessionForkInput, SessionSwitchAgentInput, SessionSwitchModelInput, SessionUpdateInput, SessionMoveInput, SessionPromptInput, SessionCommandInput, SessionSkillInput, SessionSyntheticInput, SessionShellInput, SessionCompactInput, SessionWaitInput, SessionRevertStageInput, SessionRevertClearInput, SessionRevertCommitInput, SessionContextInput, SessionDiffInput, SessionInboxListInput, SessionInboxCancelInput, SessionInboxUpdateInput, SessionInstructionsEntryListInput, SessionInstructionsEntryPutInput, SessionInstructionsEntryRemoveInput, SessionGenerateInput, SessionLogInput, SessionLogOutput, SessionInterruptInput, SessionBackgroundInput, SessionMessageGetInput, SessionFormListInput, SessionFormCreateInput, SessionFormGetInput, SessionFormReplyInput, SessionFormCancelInput, SessionEnvironmentInput, SessionViewInput, MessageListInput, ModelListInput, ModelListOutput, ModelDefaultInput, ModelDefaultOutput, GenerateTextInput, ProviderListInput, ProviderListOutput, ProviderGetInput, ProviderGetOutput, IntegrationListInput, IntegrationListOutput, IntegrationGetInput, IntegrationGetOutput, IntegrationWellknownAddInput, IntegrationConnectKeyInput, IntegrationOauthConnectInput, IntegrationOauthConnectOutput, IntegrationOauthStatusInput, IntegrationOauthStatusOutput, IntegrationOauthCompleteInput, IntegrationOauthCancelInput, IntegrationCommandConnectInput, IntegrationCommandConnectOutput, IntegrationCommandStatusInput, IntegrationCommandStatusOutput, IntegrationCommandCancelInput, McpListInput, McpListOutput, McpAddInput, McpRemoveInput, McpConnectInput, McpDisconnectInput, McpResourceCatalogInput, McpResourceCatalogOutput, CredentialCreateInput, CredentialUpdateInput, CredentialActivateInput, CredentialRemoveInput, ProjectListOutput, ProjectUpdateInput, FormListInput, FormListOutput, PermissionRequestListInput, PermissionRequestListOutput, PermissionSavedListInput, PermissionSavedRemoveInput, PermissionCreateInput, PermissionListInput, PermissionGetInput, PermissionReplyInput, FileReadInput, FileReadOutput, FileListInput, FileListOutput, FileFindInput, FileFindOutput, FileWriteInput, FileWriteOutput, CommandListInput, CommandListOutput, SkillListInput, SkillListOutput, RpcCallInput, EventSubscribeOutput, PtyListInput, PtyListOutput, PtyCreateInput, PtyCreateOutput, PtyGetInput, PtyGetOutput, PtyUpdateInput, PtyUpdateOutput, PtyRemoveInput, PtyConnectTokenInput, PtyConnectTokenOutput, ExperimentalPersistentPtyReadInput, ExperimentalPersistentPtyListInput, ExperimentalPersistentPtyCreateInput, ExperimentalPersistentPtyHandoffOutput, ExperimentalPersistentPtyGetInput, ExperimentalPersistentPtyUpdateInput, ExperimentalPersistentPtySnapshotInput, ExperimentalPersistentPtyRemoveInput, ExperimentalPersistentPtyConnectTokenInput, ShellListInput, ShellListOutput, ShellCreateInput, ShellCreateOutput, ShellGetInput, ShellGetOutput, ShellOutputInput, ShellOutputOutput, ShellRemoveInput, ReferenceListInput, ReferenceListOutput, WorktreeListInput, WorktreeCreateInput, WorktreeRemoveInput, WorktreeRefreshInput, VcsInitInput, VcsGetInput, VcsGetOutput, VcsBaseInput, VcsBaseOutput, VcsStatusInput, VcsStatusOutput, VcsBranchListInput, VcsBranchListOutput, VcsDiffInput, VcsDiffOutput, DebugLocationListOutput, DebugLocationEvictInput, MigrationV1StatusOutput, WebsearchProvidersInput, WebsearchProvidersOutput, WebsearchQueryInput, WebsearchQueryOutput, ConfigGetInput, ConfigGetOutput, ConfigShellsOutput, ConfigUpdateInput } from "./types.js";
+import type { ServerConnectInput, LocationGetInput, AgentListInput, AgentListOutput, AgentGetInput, AgentGetOutput, PluginListInput, PluginListOutput, PluginCheckInput, PluginCheckOutput, PluginUpdateInput, SessionListInput, SessionStatsInput, SessionCreateInput, SessionImportInput, SessionExportInput, SessionGetInput, SessionRemoveInput, SessionForkInput, SessionSwitchAgentInput, SessionSwitchModelInput, SessionUpdateInput, SessionMoveInput, SessionPromptInput, SessionCommandInput, SessionSkillInput, SessionSyntheticInput, SessionShellInput, SessionCompactInput, SessionWaitInput, SessionRevertStageInput, SessionRevertClearInput, SessionRevertCommitInput, SessionContextInput, SessionDiffInput, SessionInboxListInput, SessionInboxCancelInput, SessionInboxUpdateInput, SessionInstructionsEntryListInput, SessionInstructionsEntryPutInput, SessionInstructionsEntryRemoveInput, SessionGenerateInput, SessionLogInput, SessionLogOutput, SessionInterruptInput, SessionBackgroundInput, SessionMessageGetInput, SessionFormListInput, SessionFormCreateInput, SessionFormGetInput, SessionFormReplyInput, SessionFormCancelInput, SessionEnvironmentInput, SessionViewInput, MessageListInput, ModelListInput, ModelListOutput, ModelDefaultInput, ModelDefaultOutput, GenerateTextInput, ProviderListInput, ProviderListOutput, ProviderGetInput, ProviderGetOutput, IntegrationListInput, IntegrationListOutput, IntegrationGetInput, IntegrationGetOutput, IntegrationWellknownAddInput, IntegrationConnectKeyInput, IntegrationConnectExternalInput, IntegrationOauthConnectInput, IntegrationOauthConnectOutput, IntegrationOauthStatusInput, IntegrationOauthStatusOutput, IntegrationOauthCompleteInput, IntegrationOauthCancelInput, IntegrationCommandConnectInput, IntegrationCommandConnectOutput, IntegrationCommandStatusInput, IntegrationCommandStatusOutput, IntegrationCommandCancelInput, McpListInput, McpListOutput, McpAddInput, McpRemoveInput, McpConnectInput, McpDisconnectInput, McpResourceCatalogInput, McpResourceCatalogOutput, CredentialCreateInput, CredentialUpdateInput, CredentialActivateInput, CredentialRemoveInput, ProjectListOutput, ProjectUpdateInput, FormListInput, FormListOutput, PermissionRequestListInput, PermissionRequestListOutput, PermissionSavedListInput, PermissionSavedRemoveInput, PermissionCreateInput, PermissionListInput, PermissionGetInput, PermissionReplyInput, FileReadInput, FileReadOutput, FileListInput, FileListOutput, FileFindInput, FileFindOutput, FileWriteInput, FileWriteOutput, CommandListInput, CommandListOutput, SkillListInput, SkillListOutput, RpcCallInput, EventSubscribeOutput, PtyListInput, PtyListOutput, PtyCreateInput, PtyCreateOutput, PtyGetInput, PtyGetOutput, PtyUpdateInput, PtyUpdateOutput, PtyRemoveInput, PtyConnectTokenInput, PtyConnectTokenOutput, ExperimentalPersistentPtyReadInput, ExperimentalPersistentPtyListInput, ExperimentalPersistentPtyCreateInput, ExperimentalPersistentPtyHandoffOutput, ExperimentalPersistentPtyGetInput, ExperimentalPersistentPtyUpdateInput, ExperimentalPersistentPtySnapshotInput, ExperimentalPersistentPtyRemoveInput, ExperimentalPersistentPtyConnectTokenInput, ShellListInput, ShellListOutput, ShellCreateInput, ShellCreateOutput, ShellGetInput, ShellGetOutput, ShellOutputInput, ShellOutputOutput, ShellRemoveInput, ReferenceListInput, ReferenceListOutput, WorktreeListInput, WorktreeCreateInput, WorktreeRemoveInput, WorktreeRefreshInput, VcsInitInput, VcsGetInput, VcsGetOutput, VcsBaseInput, VcsBaseOutput, VcsStatusInput, VcsStatusOutput, VcsBranchListInput, VcsBranchListOutput, VcsDiffInput, VcsDiffOutput, DebugLocationListOutput, DebugLocationEvictInput, MigrationV1StatusOutput, WebsearchProvidersInput, WebsearchProvidersOutput, WebsearchQueryInput, WebsearchQueryOutput, ConfigGetInput, ConfigGetOutput, ConfigShellsOutput, ConfigUpdateInput } from "./types.js";
 export interface ClientOptions {
     readonly baseUrl: string;
     readonly fetch?: typeof globalThis.fetch;
@@ -114,6 +114,7 @@ export declare function make(options: ClientOptions): {
         };
         connect: {
             key: (input: IntegrationConnectKeyInput, requestOptions?: RequestOptions) => Promise<void>;
+            external: (input: IntegrationConnectExternalInput, requestOptions?: RequestOptions) => Promise<void>;
         };
         oauth: {
             connect: (input: IntegrationOauthConnectInput, requestOptions?: RequestOptions) => Promise<IntegrationOauthConnectOutput>;

package/dist/promise/generated/client.js

@@ -1,7 +1,7 @@
 import {
-  make3
-} from "../../chunks/pty-handoff-qzsnm4q8.js";
-import"../../chunks/pty-handoff-js54wxgp.js";
+  make6
+} from "../../chunks/service-probe-9h52wrcy.js";
+import"../../chunks/service-probe-nwcpakzx.js";
 export {
-  make3 as make
+  make6 as make
 };

package/dist/promise/generated/index.js

@@ -1,10 +1,4 @@
-import"../../chunks/pty-handoff-vyas3vgt.js";
-import {
-  exports_client2
-} from "../../chunks/pty-handoff-qzsnm4q8.js";
-import {
-  ClientError2
-} from "../../chunks/pty-handoff-js54wxgp.js";
+import"../../chunks/service-probe-vyas3vgt.js";
 import {
   isInvalidRequestError2,
   isUnauthorizedError2,
@@ -39,10 +33,16 @@ import {
   isShellNotFoundError2,
   isWorktreeError2,
   isVcsInitNotSupportedError2
-} from "../../chunks/pty-handoff-vt9jbch8.js";
+} from "../../chunks/service-probe-vt9jbch8.js";
+import {
+  exports_client4
+} from "../../chunks/service-probe-9h52wrcy.js";
+import {
+  ClientError3
+} from "../../chunks/service-probe-nwcpakzx.js";
 export {
-  ClientError2 as ClientError,
-  exports_client2 as OpenCode,
+  ClientError3 as ClientError,
+  exports_client4 as OpenCode,
   isAgentNotFoundError2 as isAgentNotFoundError,
   isCommandExecutionError2 as isCommandExecutionError,
   isCommandNotFoundError2 as isCommandNotFoundError,

package/dist/promise/generated/types.d.ts

@@ -496,6 +496,13 @@ export type CredentialOAuth = {
         [x: string]: JsonValue;
     };
 };
+export type CredentialExternal = {
+    type: "external";
+    methodID: string;
+    metadata?: {
+        [x: string]: JsonValue;
+    };
+};
 export type ProjectVcs = string;
 export type ProjectIcon = {
     url?: string;
@@ -2207,6 +2214,8 @@ export type ModelCompatibility = {
     requireFinishReason?: boolean;
     requireAssistantAfterTool?: boolean;
     supportsPromptCacheKey?: boolean;
+    supportsThinkingBlockBinding?: boolean;
+    supportsEffortUpdates?: boolean;
 };
 export type ModelCost = {
     tier?: {
@@ -2224,7 +2233,7 @@ export type ConnectionCredentialInfo = {
     type: "credential";
     id: string;
     label: string;
-    method: "key" | "oauth";
+    method: "key" | "oauth" | "external";
     status?: ConnectionStatus;
 };
 export type ConnectionEnvInfo = {
@@ -3136,7 +3145,7 @@ export type ConfigEntry = {
             portable_shell_scanner?: boolean;
             subagent_depth?: number;
             policies?: Array<{
-                action: "provider.use" | "permission";
+                action: "provider.use" | "tool.use" | "integration.use";
                 resource: string;
                 effect: "allow" | "deny";
             }>;
@@ -3203,7 +3212,7 @@ export type SessionMessageAssistantTool1 = {
     };
 };
 export type FormFields = [FormField, ...Array<FormField>];
-export type CredentialValue = CredentialOAuth | CredentialKey;
+export type CredentialValue = CredentialOAuth | CredentialKey | CredentialExternal;
 export type FormFields2 = [FormField1, ...Array<FormField1>];
 export type SessionsResponse = {
     data: Array<SessionInfo>;
@@ -3286,6 +3295,12 @@ export type IntegrationKeyMethod = {
     label?: string;
     form?: FormFields;
 };
+export type IntegrationExternalMethod = {
+    id: string;
+    type: "external";
+    label: string;
+    form?: FormFields;
+};
 export type CredentialEntry = {
     id: string;
     integrationID: string;
@@ -3320,7 +3335,7 @@ export type SessionMessageContentUpdated = {
         content: Array<SessionMessageAssistantContentEncoded>;
     };
 };
-export type IntegrationMethod = IntegrationOAuthMethod | IntegrationCommandMethod | IntegrationKeyMethod | IntegrationEnvMethod;
+export type IntegrationMethod = IntegrationOAuthMethod | IntegrationCommandMethod | IntegrationKeyMethod | IntegrationExternalMethod | IntegrationEnvMethod;
 export type FormCreated = {
     id: string;
     created: number;
@@ -7322,6 +7337,38 @@ export type IntegrationConnectKeyInput = {
     }["label"];
 };
 export type IntegrationConnectKeyOutput = void;
+export type IntegrationConnectExternalInput = {
+    readonly integrationID: {
+        readonly integrationID: string;
+    }["integrationID"];
+    readonly location?: {
+        readonly location?: {
+            readonly directory?: string | undefined;
+        } | undefined;
+    }["location"];
+    readonly methodID: {
+        readonly methodID: string;
+        readonly answer?: {
+            readonly [x: string]: string | number | boolean | ReadonlyArray<string>;
+        } | undefined;
+        readonly label?: string | undefined;
+    }["methodID"];
+    readonly answer?: {
+        readonly methodID: string;
+        readonly answer?: {
+            readonly [x: string]: string | number | boolean | ReadonlyArray<string>;
+        } | undefined;
+        readonly label?: string | undefined;
+    }["answer"];
+    readonly label?: {
+        readonly methodID: string;
+        readonly answer?: {
+            readonly [x: string]: string | number | boolean | ReadonlyArray<string>;
+        } | undefined;
+        readonly label?: string | undefined;
+    }["label"];
+};
+export type IntegrationConnectExternalOutput = void;
 export type IntegrationOauthConnectInput = {
     readonly integrationID: {
         readonly integrationID: string;
@@ -7600,6 +7647,12 @@ export type CredentialCreateInput = {
             readonly configuration?: {
                 readonly [x: string]: string | number | "Infinity" | "-Infinity" | "NaN" | boolean | ReadonlyArray<string>;
             };
+        } | {
+            readonly type: "external";
+            readonly methodID: string;
+            readonly metadata?: {
+                readonly [x: string]: JsonValue;
+            };
         };
         readonly activate?: boolean;
     }["id"];
@@ -7625,6 +7678,12 @@ export type CredentialCreateInput = {
             readonly configuration?: {
                 readonly [x: string]: string | number | "Infinity" | "-Infinity" | "NaN" | boolean | ReadonlyArray<string>;
             };
+        } | {
+            readonly type: "external";
+            readonly methodID: string;
+            readonly metadata?: {
+                readonly [x: string]: JsonValue;
+            };
         };
         readonly activate?: boolean;
     }["integrationID"];
@@ -7650,6 +7709,12 @@ export type CredentialCreateInput = {
             readonly configuration?: {
                 readonly [x: string]: string | number | "Infinity" | "-Infinity" | "NaN" | boolean | ReadonlyArray<string>;
             };
+        } | {
+            readonly type: "external";
+            readonly methodID: string;
+            readonly metadata?: {
+                readonly [x: string]: JsonValue;
+            };
         };
         readonly activate?: boolean;
     }["label"];
@@ -7675,6 +7740,12 @@ export type CredentialCreateInput = {
             readonly configuration?: {
                 readonly [x: string]: string | number | "Infinity" | "-Infinity" | "NaN" | boolean | ReadonlyArray<string>;
             };
+        } | {
+            readonly type: "external";
+            readonly methodID: string;
+            readonly metadata?: {
+                readonly [x: string]: JsonValue;
+            };
         };
         readonly activate?: boolean;
     }["value"];
@@ -7700,6 +7771,12 @@ export type CredentialCreateInput = {
             readonly configuration?: {
                 readonly [x: string]: string | number | "Infinity" | "-Infinity" | "NaN" | boolean | ReadonlyArray<string>;
             };
+        } | {
+            readonly type: "external";
+            readonly methodID: string;
+            readonly metadata?: {
+                readonly [x: string]: JsonValue;
+            };
         };
         readonly activate?: boolean;
     }["activate"];

package/dist/promise/generated/types.js

@@ -32,7 +32,7 @@ import {
   isShellNotFoundError2,
   isWorktreeError2,
   isVcsInitNotSupportedError2
-} from "../../chunks/pty-handoff-vt9jbch8.js";
+} from "../../chunks/service-probe-vt9jbch8.js";
 export {
   isAgentNotFoundError2 as isAgentNotFoundError,
   isCommandExecutionError2 as isCommandExecutionError,

package/dist/promise/index.js

@@ -1,13 +1,9 @@
-import"../chunks/pty-handoff-m2eywc8w.js";
+import"../chunks/service-probe-m2eywc8w.js";
 import {
-  exports_client
-} from "../chunks/pty-handoff-cqfz2qxq.js";
-import"../chunks/pty-handoff-vyas3vgt.js";
-import"../chunks/pty-handoff-qzsnm4q8.js";
-import {
-  ClientError2
-} from "../chunks/pty-handoff-js54wxgp.js";
-import"../chunks/pty-handoff-1y4a697q.js";
+  exports_client3
+} from "../chunks/service-probe-z1hcmzxa.js";
+import"../chunks/service-probe-vyas3vgt.js";
+import"../chunks/service-probe-1y4a697q.js";
 import {
   isInvalidRequestError2,
   isUnauthorizedError2,
@@ -42,11 +38,15 @@ import {
   isShellNotFoundError2,
   isWorktreeError2,
   isVcsInitNotSupportedError2
-} from "../chunks/pty-handoff-vt9jbch8.js";
-import"../chunks/pty-handoff-frbwqjmf.js";
+} from "../chunks/service-probe-vt9jbch8.js";
+import"../chunks/service-probe-9h52wrcy.js";
+import {
+  ClientError3
+} from "../chunks/service-probe-nwcpakzx.js";
+import"../chunks/service-probe-frbwqjmf.js";
 export {
-  ClientError2 as ClientError,
-  exports_client as OpenCode,
+  ClientError3 as ClientError,
+  exports_client3 as OpenCode,
   isAgentNotFoundError2 as isAgentNotFoundError,
   isCommandExecutionError2 as isCommandExecutionError,
   isCommandNotFoundError2 as isCommandNotFoundError,

package/dist/promise/rpc.js

@@ -1,7 +1,7 @@
 import {
   makeRpc2
-} from "../chunks/pty-handoff-1y4a697q.js";
-import"../chunks/pty-handoff-vt9jbch8.js";
+} from "../chunks/service-probe-1y4a697q.js";
+import"../chunks/service-probe-vt9jbch8.js";
 export {
   makeRpc2 as makeRpc
 };

package/dist/promise/service.js

@@ -1,27 +1,28 @@
 import {
   spawnServiceContender2,
   contenderPool2
-} from "../chunks/pty-handoff-ve4aws36.js";
+} from "../chunks/service-probe-ve4aws36.js";
 import {
   defaultEnsureTiming2,
   ensureTiming2
-} from "../chunks/pty-handoff-xgnj2w4v.js";
+} from "../chunks/service-probe-xgnj2w4v.js";
 import {
   matchesVersion2
-} from "../chunks/pty-handoff-sxt88q69.js";
+} from "../chunks/service-probe-sxt88q69.js";
 import {
   prepare2,
   environment2,
   complete2,
   clear2
-} from "../chunks/pty-handoff-71wkqa80.js";
+} from "../chunks/service-probe-1thtawyv.js";
 import {
+  decide2,
   fallback2,
   same2,
   probeResult2,
   headers2
-} from "../chunks/pty-handoff-ank0d71z.js";
-import"../chunks/pty-handoff-qav6mfdz.js";
+} from "../chunks/service-probe-2ny4vxct.js";
+import"../chunks/service-probe-qav6mfdz.js";
 
 // src/promise/service.ts
 import { readFile, rm } from "node:fs/promises";
@@ -81,24 +82,18 @@ async function ensure(options = {}) {
       if (registration.service !== undefined) {
         pool.serviceAnswered();
         const service2 = registration.service;
-        const versionMatches = matchesVersion2(service2.version, options);
-        const compatible = service2.compatible && versionMatches;
-        if (!service2.compatible && versionMatches)
-          throw new Error("Background service uses an incompatible health protocol. Update this client or explicitly restart the service.");
-        if (compatible && service2.state === "ready") {
+        const decision = decide2(service2, options);
+        if (decision._tag === "fail")
+          throw decision.error;
+        if (decision._tag === "reuse") {
           await complete2(options.file ?? fallback2(), service2.info);
           return service2.endpoint;
         }
-        if (compatible && service2.state === "failed")
-          throw new Error("Background service failed to start");
-        if (!compatible) {
+        if (decision._tag === "replace") {
           announce("version-mismatch", service2.version);
           if (service2.state !== "ready")
             console.warn("Background service is not ready; replacement cannot preserve persistent terminals");
-          await stop({
-            file: options.file,
-            pty: service2.state === "ready" ? "handoff" : "clear"
-          }).catch(() => {
+          await stop({ file: options.file, pty: decision.pty }).catch(() => {
             return;
           });
           pool.evict(service2.info.pid);

package/dist/pty-handoff.js

@@ -4,7 +4,7 @@ import {
   complete2,
   clear2,
   exports_pty_handoff
-} from "./chunks/pty-handoff-71wkqa80.js";
+} from "./chunks/service-probe-1thtawyv.js";
 export {
   exports_pty_handoff as PtyHandoff,
   clear2 as clear,

package/dist/rpc-runtime.js

@@ -4,7 +4,7 @@ import {
   event2,
   eventType2,
   exports_rpc_runtime
-} from "./chunks/pty-handoff-t1xa31vm.js";
+} from "./chunks/service-probe-t1xa31vm.js";
 export {
   exports_rpc_runtime as RpcRuntime,
   event2 as event,

package/dist/service-contender.js

@@ -2,7 +2,7 @@ import {
   spawnServiceContender2,
   contenderPool2,
   contenderFinished2
-} from "./chunks/pty-handoff-ve4aws36.js";
+} from "./chunks/service-probe-ve4aws36.js";
 export {
   contenderFinished2 as contenderFinished,
   contenderPool2 as contenderPool,

package/dist/service-probe.d.ts

@@ -1,4 +1,4 @@
-import type { Endpoint, Info } from "./service.js";
+import type { DiscoverOptions, Endpoint, Info } from "./service.js";
 export type LocalService = {
     readonly info: Info;
     readonly endpoint: Endpoint;
@@ -6,6 +6,23 @@ export type LocalService = {
     readonly state: "ready" | "waiting" | "failed";
     readonly compatible: boolean;
 };
+/**
+ * What `ensure()` does with a registered service that answered: return it, keep polling while
+ * it starts, replace it because its version does not meet the requirement, or fail.
+ */
+export declare function decide(service: LocalService, options: DiscoverOptions): {
+    _tag: "fail";
+    error: Error;
+} | {
+    readonly _tag: "replace";
+    readonly pty: "clear" | "handoff";
+} | {
+    readonly _tag: "reuse";
+    readonly pty?: undefined;
+} | {
+    readonly _tag: "wait";
+    readonly pty?: undefined;
+};
 /** The default registration file. */
 export declare function fallback(): string;
 /** Whether two registrations describe the same service instance. */