fix: stabilize OpenCode reuse and session switching

Check cached embedded servers before reuse, isolate concurrent cancellation, and serialize request MCP registration and cleanup. Preserve native controls across session switches and recover usable partial inventories.

Share the bundled offline OpenCode configuration with desktop and Agent launch paths, including model bridge environment forwarding.

Validation: focused tests and typecheck passed; lint passed before the final fixes. The full test run exceeded 120 seconds and reported a DS stdio MCP failure. Current-source Agent host and real suspend/resume validation remain pending.

Release note: 修复切换会话后 OpenCode 原生控件消失及并发取消相互影响的问题,并完善内嵌服务复用检查和桌面、Agent 的离线依赖配置。
This commit is contained in:
mesalogo
2026-09-08 01:09:14 +08:00
parent 86daae8be2
commit 9aed926cda
12 changed files with 19417 additions and 20142 deletions
+113 -127
View File
@@ -1,230 +1,216 @@
import {
dirname,
isAbsolute,
join,
relative,
resolve,
sep
} from 'node:path'
import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
import {
OPENCODE_REMOTE_RUNTIME_ENVIRONMENT_NAMES,
remoteRuntimeBundleManifestSchema,
type RemoteRuntimeBundleManifest
} from '../shared/remote-runtime-launch-contracts'
type RemoteRuntimeBundleManifest,
} from "../shared/remote-runtime-launch-contracts";
import {
modelBridgePolicySchema,
type ModelBridgePolicy
} from '../shared/model-bridge-contracts'
import {
assertAbsoluteManagedPath
} from './managed-paths'
type ModelBridgePolicy,
} from "../shared/model-bridge-contracts";
import { assertAbsoluteManagedPath } from "./managed-paths";
const OPEN_CODE_ASK_CONFIG = JSON.stringify({
permission: 'ask',
permission: "ask",
agent: {
build: {
permission: 'ask'
}
}
})
permission: "ask",
},
},
});
const OPEN_CODE_RUNTIME_ENVIRONMENT = Object.freeze({
OPENCODE_DISABLE_AUTOUPDATE: "1",
OPENCODE_DISABLE_CLAUDE_CODE_SKILLS: "1",
OPENCODE_DISABLE_EMBEDDED_WEB_UI: "1",
OPENCODE_DISABLE_EXTERNAL_SKILLS: "1",
OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER: "1",
OPENCODE_DISABLE_LSP_DOWNLOAD: "1",
OPENCODE_DISABLE_MODELS_FETCH: "1",
OPENCODE_DISABLE_PROJECT_CONFIG: "1",
OPENCODE_DISABLE_SHARE: "1",
});
export type OpenCodeLaunchProfile = {
executable: string
processExecutable: string
args: readonly string[]
cwd: string
env: Readonly<NodeJS.ProcessEnv>
workMode: 'ask' | 'execute'
}
executable: string;
processExecutable: string;
args: readonly string[];
cwd: string;
env: Readonly<NodeJS.ProcessEnv>;
workMode: "ask" | "execute";
};
export function createOpenCodeLaunchProfile(input: {
manifest: RemoteRuntimeBundleManifest
bundleDirectory: string
workspaceDirectory: string
workMode: 'ask' | 'execute'
manifest: RemoteRuntimeBundleManifest;
bundleDirectory: string;
workspaceDirectory: string;
workMode: "ask" | "execute";
modelBridge?: {
agentExecutablePath: string
bridgeDirectory: string
socketPath: string
policy: ModelBridgePolicy
}
agentExecutablePath: string;
bridgeDirectory: string;
socketPath: string;
policy: ModelBridgePolicy;
};
}): OpenCodeLaunchProfile {
const manifest = remoteRuntimeBundleManifestSchema.parse(
input.manifest
)
const manifest = remoteRuntimeBundleManifestSchema.parse(input.manifest);
if (
manifest.runtimeId !== 'opencode' ||
manifest.provider !== 'opencode' ||
manifest.entrypoint.identity !== 'opencode-acp' ||
manifest.runtimeId !== "opencode" ||
manifest.provider !== "opencode" ||
manifest.entrypoint.identity !== "opencode-acp" ||
manifest.entrypoint.argvPrefix.length !== 1 ||
manifest.entrypoint.argvPrefix[0] !== 'acp'
manifest.entrypoint.argvPrefix[0] !== "acp"
) {
throw new Error('Runtime manifest is not the fixed OpenCode ACP profile')
throw new Error("Runtime manifest is not the fixed OpenCode ACP profile");
}
if (
[...manifest.allowedEnvironmentNames].sort().join('\0') !==
[...OPENCODE_REMOTE_RUNTIME_ENVIRONMENT_NAMES]
.sort()
.join('\0')
[...manifest.allowedEnvironmentNames].sort().join("\0") !==
[...OPENCODE_REMOTE_RUNTIME_ENVIRONMENT_NAMES].sort().join("\0")
) {
throw new Error(
'OpenCode Runtime environment allowlist does not match the fixed profile'
)
"OpenCode Runtime environment allowlist does not match the fixed profile",
);
}
const bundleDirectory = assertAbsoluteManagedPath(
resolve(input.bundleDirectory)
)
resolve(input.bundleDirectory),
);
const workspaceDirectory = normalizedAbsolutePath(
input.workspaceDirectory,
'Workspace'
)
"Workspace",
);
const modelBridge =
input.modelBridge === undefined
? undefined
: {
agentExecutablePath: normalizedAbsolutePath(
input.modelBridge.agentExecutablePath,
'Agent executable'
"Agent executable",
),
agentInstallationDirectory: normalizedAbsolutePath(
dirname(input.modelBridge.agentExecutablePath),
'Agent installation'
"Agent installation",
),
bridgeDirectory: normalizedAbsolutePath(
input.modelBridge.bridgeDirectory,
'Model bridge'
"Model bridge",
),
socketPath: normalizedAbsolutePath(
input.modelBridge.socketPath,
'Model bridge socket'
"Model bridge socket",
),
policy: modelBridgePolicySchema.parse(
input.modelBridge.policy
)
}
policy: modelBridgePolicySchema.parse(input.modelBridge.policy),
};
if (
modelBridge !== undefined &&
(!isStrictDescendant(
modelBridge.bridgeDirectory,
modelBridge.socketPath
) ||
(!isStrictDescendant(modelBridge.bridgeDirectory, modelBridge.socketPath) ||
!isStrictDescendant(
modelBridge.agentInstallationDirectory,
modelBridge.agentExecutablePath
modelBridge.agentExecutablePath,
))
) {
throw new Error(
'Model bridge socket or Agent executable escapes its managed directory'
)
"Model bridge socket or Agent executable escapes its managed directory",
);
}
const executablePath = resolve(
bundleDirectory,
...manifest.entrypoint.path.split('/')
)
...manifest.entrypoint.path.split("/"),
);
if (!isStrictDescendant(bundleDirectory, executablePath)) {
throw new Error('OpenCode entrypoint escapes its bundle directory')
throw new Error("OpenCode entrypoint escapes its bundle directory");
}
const runtimeCommand =
modelBridge === undefined
? {
executable: executablePath,
args: [...manifest.entrypoint.argvPrefix]
args: [...manifest.entrypoint.argvPrefix],
}
: {
executable: join(
modelBridge.agentInstallationDirectory,
'node'
),
executable: join(modelBridge.agentInstallationDirectory, "node"),
args: [
join(
modelBridge.agentInstallationDirectory,
'lib',
'agent.cjs'
),
'model-bridge-helper',
'--socket-path',
join(modelBridge.agentInstallationDirectory, "lib", "agent.cjs"),
"model-bridge-helper",
"--socket-path",
modelBridge.socketPath,
'--protocol',
"--protocol",
modelBridge.policy.protocol,
'--model',
"--model",
modelBridge.policy.model,
'--supports-image-input',
modelBridge.policy.supportsImageInput ? 'true' : 'false',
'--work-mode',
"--supports-image-input",
modelBridge.policy.supportsImageInput ? "true" : "false",
"--work-mode",
input.workMode,
'--opencode-entrypoint',
executablePath
]
}
"--opencode-entrypoint",
executablePath,
],
};
const environmentBase = {
...executeEnvironment(process.env, workspaceDirectory),
...OPEN_CODE_RUNTIME_ENVIRONMENT,
OPENCODE_CONFIG_DIR: join(bundleDirectory, "config", "opencode"),
};
const environment =
input.workMode === 'ask'
input.workMode === "ask"
? {
...executeEnvironment(process.env, workspaceDirectory),
OPENCODE_CONFIG_CONTENT: OPEN_CODE_ASK_CONFIG
...environmentBase,
OPENCODE_CONFIG_CONTENT: OPEN_CODE_ASK_CONFIG,
}
: executeEnvironment(process.env, workspaceDirectory)
: environmentBase;
return {
...runtimeCommand,
processExecutable: runtimeCommand.executable,
cwd: workspaceDirectory,
env: environment,
workMode: input.workMode
}
workMode: input.workMode,
};
}
function normalizedAbsolutePath(value: string, label: string): string {
if (
value.includes('\0') ||
!isAbsolute(value) ||
resolve(value) !== value
) {
throw new Error(`${label} path must be a normalized absolute path`)
if (value.includes("\0") || !isAbsolute(value) || resolve(value) !== value) {
throw new Error(`${label} path must be a normalized absolute path`);
}
return value
return value;
}
function executeEnvironment(
source: Readonly<NodeJS.ProcessEnv>,
workspaceDirectory: string
workspaceDirectory: string,
): Readonly<NodeJS.ProcessEnv> {
const home = usableEnvironmentValue(source.HOME)
? source.HOME!
: workspaceDirectory
: workspaceDirectory;
const defaults = {
HOME: home,
LANG: 'C.UTF-8',
LC_ALL: 'C.UTF-8',
PATH: '/usr/bin:/bin',
TMPDIR: '/tmp',
XDG_CACHE_HOME: join(home, '.cache'),
XDG_CONFIG_HOME: join(home, '.config'),
XDG_DATA_HOME: join(home, '.local', 'share'),
XDG_STATE_HOME: join(home, '.local', 'state')
} as const
const environment: NodeJS.ProcessEnv = { ...source }
LANG: "C.UTF-8",
LC_ALL: "C.UTF-8",
PATH: "/usr/bin:/bin",
TMPDIR: "/tmp",
XDG_CACHE_HOME: join(home, ".cache"),
XDG_CONFIG_HOME: join(home, ".config"),
XDG_DATA_HOME: join(home, ".local", "share"),
XDG_STATE_HOME: join(home, ".local", "state"),
} as const;
const environment: NodeJS.ProcessEnv = { ...source };
for (const [name, fallback] of Object.entries(defaults)) {
if (!usableEnvironmentValue(environment[name])) {
environment[name] = fallback
environment[name] = fallback;
}
}
return environment
return environment;
}
function usableEnvironmentValue(
value: string | undefined
): value is string {
return value !== undefined && value.length > 0 && !value.includes('\0')
function usableEnvironmentValue(value: string | undefined): value is string {
return value !== undefined && value.length > 0 && !value.includes("\0");
}
function isStrictDescendant(parent: string, candidate: string): boolean {
const child = relative(parent, candidate)
const child = relative(parent, candidate);
return (
child.length > 0 &&
child !== '..' &&
child !== ".." &&
!child.startsWith(`..${sep}`) &&
!isAbsolute(child)
)
);
}