texlite 0.18.0 → 0.19.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/DESIGN.md +442 -26
- package/NPM_TESTING.md +23 -0
- package/OPERATIONS.md +227 -6
- package/README.md +8 -2
- package/README.zh-CN.md +6 -2
- package/THIRD_PARTY_NOTICES.md +73 -0
- package/dist/client/assets/AdminUsers-CuYfWnEk.js +1 -0
- package/dist/client/assets/AdminUsers-CuYfWnEk.js.br +0 -0
- package/dist/client/assets/AdminUsers-CuYfWnEk.js.gz +0 -0
- package/dist/client/assets/AgentIcon-ClP5dPRL.js +1 -0
- package/dist/client/assets/AgentIcon-ClP5dPRL.js.br +0 -0
- package/dist/client/assets/AgentIcon-ClP5dPRL.js.gz +0 -0
- package/dist/client/assets/AgentIcon-DxrC-zx_.css +1 -0
- package/dist/client/assets/AgentIcon-DxrC-zx_.css.br +0 -0
- package/dist/client/assets/AgentIcon-DxrC-zx_.css.gz +0 -0
- package/dist/client/assets/AgentManagement-jY_BF6Qy.js +1 -0
- package/dist/client/assets/AgentManagement-jY_BF6Qy.js.br +0 -0
- package/dist/client/assets/AgentManagement-jY_BF6Qy.js.gz +0 -0
- package/dist/client/assets/AgentTerminal-JKP2SVkZ.js +2 -0
- package/dist/client/assets/AgentTerminal-JKP2SVkZ.js.br +0 -0
- package/dist/client/assets/AgentTerminal-JKP2SVkZ.js.gz +0 -0
- package/dist/client/assets/AgentTerminalSurface-B5LH8GIb.css +1 -0
- package/dist/client/assets/AgentTerminalSurface-B5LH8GIb.css.br +0 -0
- package/dist/client/assets/AgentTerminalSurface-B5LH8GIb.css.gz +0 -0
- package/dist/client/assets/AgentTerminalSurface-CaYNNZ9A.js +16 -0
- package/dist/client/assets/AgentTerminalSurface-CaYNNZ9A.js.br +0 -0
- package/dist/client/assets/AgentTerminalSurface-CaYNNZ9A.js.gz +0 -0
- package/dist/client/assets/AvatarSettingsDialog-C2TACfvP.js +1 -0
- package/dist/client/assets/AvatarSettingsDialog-C2TACfvP.js.br +0 -0
- package/dist/client/assets/AvatarSettingsDialog-C2TACfvP.js.gz +0 -0
- package/dist/client/assets/CitationLibraryDialog-BdU9nbgG.js +1 -0
- package/dist/client/assets/CitationLibraryDialog-BdU9nbgG.js.br +0 -0
- package/dist/client/assets/CitationLibraryDialog-BdU9nbgG.js.gz +0 -0
- package/dist/client/assets/Dashboard-B7mMz5Gj.js +5 -0
- package/dist/client/assets/Dashboard-B7mMz5Gj.js.br +0 -0
- package/dist/client/assets/Dashboard-B7mMz5Gj.js.gz +0 -0
- package/dist/client/assets/GitDialog-C2H-jKVO.js +3 -0
- package/dist/client/assets/GitDialog-C2H-jKVO.js.br +0 -0
- package/dist/client/assets/GitDialog-C2H-jKVO.js.gz +0 -0
- package/dist/client/assets/GitHubAccountDialog-DdKiE3pw.js +1 -0
- package/dist/client/assets/GitHubAccountDialog-DdKiE3pw.js.br +0 -0
- package/dist/client/assets/GitHubAccountDialog-DdKiE3pw.js.gz +0 -0
- package/dist/client/assets/{GitHubIcon-DNR0CleM.js → GitHubIcon-Cjli8pd_.js} +1 -1
- package/dist/client/assets/HistoryDialog-CoxJ3EsK.js +8 -0
- package/dist/client/assets/HistoryDialog-CoxJ3EsK.js.br +0 -0
- package/dist/client/assets/HistoryDialog-CoxJ3EsK.js.gz +0 -0
- package/dist/client/assets/{LatexEditor-BzAk3WQM.js → LatexEditor-BhAKioho.js} +26 -26
- package/dist/client/assets/LatexEditor-BhAKioho.js.br +0 -0
- package/dist/client/assets/LatexEditor-BhAKioho.js.gz +0 -0
- package/dist/client/assets/PdfPreview-CC8KEz1Y.js +1 -0
- package/dist/client/assets/PdfPreview-CC8KEz1Y.js.br +0 -0
- package/dist/client/assets/PdfPreview-CC8KEz1Y.js.gz +0 -0
- package/dist/client/assets/ProjectIconPickerDialog-vi_HwlCS.js +1 -0
- package/dist/client/assets/ProjectIconPickerDialog-vi_HwlCS.js.br +0 -0
- package/dist/client/assets/ProjectIconPickerDialog-vi_HwlCS.js.gz +0 -0
- package/dist/client/assets/ProjectSettings-Bl1t-Gnh.js +4 -0
- package/dist/client/assets/ProjectSettings-Bl1t-Gnh.js.br +0 -0
- package/dist/client/assets/ProjectSettings-Bl1t-Gnh.js.gz +0 -0
- package/dist/client/assets/ProjectWorkspace-1UOdyfBq.js +30 -0
- package/dist/client/assets/ProjectWorkspace-1UOdyfBq.js.br +0 -0
- package/dist/client/assets/ProjectWorkspace-1UOdyfBq.js.gz +0 -0
- package/dist/client/assets/{QuickOpenDialog-CyqeckBM.js → QuickOpenDialog-BAzyrB-4.js} +1 -1
- package/dist/client/assets/QuickOpenDialog-BAzyrB-4.js.br +0 -0
- package/dist/client/assets/QuickOpenDialog-BAzyrB-4.js.gz +0 -0
- package/dist/client/assets/SaveButton-DkyoEu6j.js +1 -0
- package/dist/client/assets/SelectionHistoryDialog-DzlVKtxs.js +3 -0
- package/dist/client/assets/SelectionHistoryDialog-DzlVKtxs.js.br +0 -0
- package/dist/client/assets/SelectionHistoryDialog-DzlVKtxs.js.gz +0 -0
- package/dist/client/assets/SuccessNotice-ubBtzzi_.js +1 -0
- package/dist/client/assets/SystemMetricsDialog-C6RVZdJZ.js +1 -0
- package/dist/client/assets/SystemMetricsDialog-C6RVZdJZ.js.br +0 -0
- package/dist/client/assets/SystemMetricsDialog-C6RVZdJZ.js.gz +0 -0
- package/dist/client/assets/TagColorSelect-xbc2H5ou.js +1 -0
- package/dist/client/assets/TagManagementDialog-8pZUVaEI.js +1 -0
- package/dist/client/assets/TagManagementDialog-8pZUVaEI.js.br +0 -0
- package/dist/client/assets/TagManagementDialog-8pZUVaEI.js.gz +0 -0
- package/dist/client/assets/{WordCountDialog-Bp8kYngA.js → WordCountDialog-BODhL9iz.js} +1 -1
- package/dist/client/assets/WordCountDialog-BODhL9iz.js.br +0 -0
- package/dist/client/assets/WordCountDialog-BODhL9iz.js.gz +0 -0
- package/dist/client/assets/arrow-down-B6T7Z6IO.js +1 -0
- package/dist/client/assets/check-BRlv1lrZ.js +1 -0
- package/dist/client/assets/chevron-up-krb7w67X.js +1 -0
- package/dist/client/assets/{chktex-BcGmZVUy.js → chktex-Bz-LKycq.js} +1 -1
- package/dist/client/assets/{clock-3-x2vcGFSH.js → clock-3-Fb1_e3ec.js} +1 -1
- package/dist/client/assets/{dist-D5mbpudl.js → dist-CMYWzCHL.js} +1 -1
- package/dist/client/assets/dist-CMYWzCHL.js.br +0 -0
- package/dist/client/assets/dist-CMYWzCHL.js.gz +0 -0
- package/dist/client/assets/{eye-CvzXPIMu.js → eye-B6AX_5uX.js} +1 -1
- package/dist/client/assets/{hard-drive-BeGQ5o79.js → hard-drive-CBmnJ2xS.js} +1 -1
- package/dist/client/assets/i18n-DF6keNBA.js +13 -0
- package/dist/client/assets/i18n-DF6keNBA.js.br +0 -0
- package/dist/client/assets/i18n-DF6keNBA.js.gz +0 -0
- package/dist/client/assets/index-DCwfhKK9.js +42 -0
- package/dist/client/assets/index-DCwfhKK9.js.br +0 -0
- package/dist/client/assets/index-DCwfhKK9.js.gz +0 -0
- package/dist/client/assets/index-SVNFLCYh.css +1 -0
- package/dist/client/assets/index-SVNFLCYh.css.br +0 -0
- package/dist/client/assets/index-SVNFLCYh.css.gz +0 -0
- package/dist/client/assets/info-DNSAs0_-.js +1 -0
- package/dist/client/assets/{minimize-2-yYMmsVER.js → minimize-2-C8oL6PTV.js} +1 -1
- package/dist/client/assets/{minus-CNHOVLWS.js → minus-TCBOakyi.js} +1 -1
- package/dist/client/assets/plus-Dfkyfvvy.js +1 -0
- package/dist/client/assets/{refresh-cw-B7vZa5K2.js → refresh-cw-DuLtxWBX.js} +1 -1
- package/dist/client/assets/relativeTime-BR0CVAvz.js +1 -0
- package/dist/client/assets/relativeTime-BR0CVAvz.js.br +0 -0
- package/dist/client/assets/relativeTime-BR0CVAvz.js.gz +0 -0
- package/dist/client/assets/{search-Czv3qsBy.js → search-n-2tBATf.js} +1 -1
- package/dist/client/assets/{spellCheck-DDCaK8Yx.js → spellCheck-xzICTGx1.js} +1 -1
- package/dist/client/assets/spellCheck-xzICTGx1.js.br +0 -0
- package/dist/client/assets/spellCheck-xzICTGx1.js.gz +0 -0
- package/dist/client/assets/tags-Dy96boLq.js +1 -0
- package/dist/client/assets/terminal-C0xh8jVR.js +1 -0
- package/dist/client/assets/{type-NT195OCy.js → type-BjXWxrjH.js} +1 -1
- package/dist/client/assets/{user-plus-BRuwNzcg.js → user-plus-3oJZJXHW.js} +1 -1
- package/dist/client/index.html +13 -7
- package/dist/server/agents/adapters/claude.js +180 -0
- package/dist/server/agents/adapters/codex.js +47 -0
- package/dist/server/agents/adapters/common.js +86 -0
- package/dist/server/agents/adapters/opencode.js +196 -0
- package/dist/server/agents/adapters/types.js +1 -0
- package/dist/server/agents/execution.js +147 -0
- package/dist/server/agents/launcher.js +57 -0
- package/dist/server/agents/processIdentity.js +63 -0
- package/dist/server/agents/registry.js +72 -0
- package/dist/server/agents/sessions.js +574 -0
- package/dist/server/agents/terminal.js +84 -0
- package/dist/server/agents/workspaces.js +341 -0
- package/dist/server/app.js +32 -1
- package/dist/server/cli.js +19 -47
- package/dist/server/collaboration.js +64 -36
- package/dist/server/compileArtifacts.js +11 -44
- package/dist/server/compiler.js +16 -38
- package/dist/server/config.js +8 -2
- package/dist/server/db.js +33 -0
- package/dist/server/editHistory.js +59 -65
- package/dist/server/history.js +28 -13
- package/dist/server/i18n.js +26 -8
- package/dist/server/latexRoot.js +4 -2
- package/dist/server/locales/zh-Hant.js +145 -0
- package/dist/server/lucideIcons.js +14 -17
- package/dist/server/projectMutations.js +21 -0
- package/dist/server/routes/agents.js +135 -0
- package/dist/server/routes/compile.js +23 -43
- package/dist/server/routes/projectHistory.js +13 -6
- package/dist/server/routes/projectShared.js +6 -1
- package/dist/server/routes/projects.js +15 -23
- package/dist/shared/agentMessages.js +51 -0
- package/dist/shared/agentProtocol.js +41 -0
- package/dist/shared/historyFiles.js +1 -1
- package/dist/shared/historyTracking.js +2 -0
- package/dist/shared/locales.js +21 -0
- package/dist/shared/sourceCommentAnchors.js +52 -4
- package/package.json +7 -3
- package/templates/agents/AGENTS.md +135 -0
- package/texlite.config.example.json +3 -2
- package/dist/client/assets/AdminUsers-rPpYTAU6.js +0 -1
- package/dist/client/assets/AdminUsers-rPpYTAU6.js.br +0 -0
- package/dist/client/assets/AdminUsers-rPpYTAU6.js.gz +0 -0
- package/dist/client/assets/AvatarSettingsDialog-CIPKapVe.js +0 -1
- package/dist/client/assets/AvatarSettingsDialog-CIPKapVe.js.br +0 -0
- package/dist/client/assets/AvatarSettingsDialog-CIPKapVe.js.gz +0 -0
- package/dist/client/assets/CitationLibraryDialog-BhZX8BV2.js +0 -1
- package/dist/client/assets/CitationLibraryDialog-BhZX8BV2.js.br +0 -0
- package/dist/client/assets/CitationLibraryDialog-BhZX8BV2.js.gz +0 -0
- package/dist/client/assets/Dashboard-DppEhsjL.js +0 -5
- package/dist/client/assets/Dashboard-DppEhsjL.js.br +0 -0
- package/dist/client/assets/Dashboard-DppEhsjL.js.gz +0 -0
- package/dist/client/assets/GitDialog-BOu46hxA.js +0 -3
- package/dist/client/assets/GitDialog-BOu46hxA.js.br +0 -0
- package/dist/client/assets/GitDialog-BOu46hxA.js.gz +0 -0
- package/dist/client/assets/GitHubAccountDialog-hosK9cLW.js +0 -1
- package/dist/client/assets/GitHubAccountDialog-hosK9cLW.js.br +0 -0
- package/dist/client/assets/GitHubAccountDialog-hosK9cLW.js.gz +0 -0
- package/dist/client/assets/HistoryDialog-BdkuEl8r.js +0 -8
- package/dist/client/assets/HistoryDialog-BdkuEl8r.js.br +0 -0
- package/dist/client/assets/HistoryDialog-BdkuEl8r.js.gz +0 -0
- package/dist/client/assets/LatexEditor-BzAk3WQM.js.br +0 -0
- package/dist/client/assets/LatexEditor-BzAk3WQM.js.gz +0 -0
- package/dist/client/assets/PdfPreview-DkjI1eCo.js +0 -1
- package/dist/client/assets/PdfPreview-DkjI1eCo.js.br +0 -0
- package/dist/client/assets/PdfPreview-DkjI1eCo.js.gz +0 -0
- package/dist/client/assets/ProjectIconPickerDialog-D8Uo4H10.js +0 -1
- package/dist/client/assets/ProjectIconPickerDialog-D8Uo4H10.js.br +0 -0
- package/dist/client/assets/ProjectIconPickerDialog-D8Uo4H10.js.gz +0 -0
- package/dist/client/assets/ProjectSettings-Jdr94nOc.js +0 -1
- package/dist/client/assets/ProjectSettings-Jdr94nOc.js.br +0 -0
- package/dist/client/assets/ProjectSettings-Jdr94nOc.js.gz +0 -0
- package/dist/client/assets/ProjectWorkspace-D9v3Jj8T.js +0 -30
- package/dist/client/assets/ProjectWorkspace-D9v3Jj8T.js.br +0 -0
- package/dist/client/assets/ProjectWorkspace-D9v3Jj8T.js.gz +0 -0
- package/dist/client/assets/QuickOpenDialog-CyqeckBM.js.br +0 -0
- package/dist/client/assets/QuickOpenDialog-CyqeckBM.js.gz +0 -0
- package/dist/client/assets/SelectionHistoryDialog-Dlutex-A.js +0 -3
- package/dist/client/assets/SelectionHistoryDialog-Dlutex-A.js.br +0 -0
- package/dist/client/assets/SelectionHistoryDialog-Dlutex-A.js.gz +0 -0
- package/dist/client/assets/SystemMetricsDialog-CCWxXw6g.js +0 -1
- package/dist/client/assets/SystemMetricsDialog-CCWxXw6g.js.br +0 -0
- package/dist/client/assets/SystemMetricsDialog-CCWxXw6g.js.gz +0 -0
- package/dist/client/assets/TagColorSelect-D3T-rw4K.js +0 -1
- package/dist/client/assets/TagManagementDialog-CxjrSX-o.js +0 -1
- package/dist/client/assets/TagManagementDialog-CxjrSX-o.js.br +0 -0
- package/dist/client/assets/TagManagementDialog-CxjrSX-o.js.gz +0 -0
- package/dist/client/assets/WordCountDialog-Bp8kYngA.js.br +0 -0
- package/dist/client/assets/WordCountDialog-Bp8kYngA.js.gz +0 -0
- package/dist/client/assets/binary-B57nBiwS.js +0 -1
- package/dist/client/assets/check-DFoA73zZ.js +0 -1
- package/dist/client/assets/chevron-up-C8DyKLxi.js +0 -1
- package/dist/client/assets/dist-D5mbpudl.js.br +0 -0
- package/dist/client/assets/dist-D5mbpudl.js.gz +0 -0
- package/dist/client/assets/i18n-CRWKZA6W.js +0 -9
- package/dist/client/assets/i18n-CRWKZA6W.js.br +0 -0
- package/dist/client/assets/i18n-CRWKZA6W.js.gz +0 -0
- package/dist/client/assets/index-D0eqhDpZ.js +0 -42
- package/dist/client/assets/index-D0eqhDpZ.js.br +0 -0
- package/dist/client/assets/index-D0eqhDpZ.js.gz +0 -0
- package/dist/client/assets/index-DnhiIb1V.css +0 -1
- package/dist/client/assets/index-DnhiIb1V.css.br +0 -0
- package/dist/client/assets/index-DnhiIb1V.css.gz +0 -0
- package/dist/client/assets/plus-BDquy76g.js +0 -1
- package/dist/client/assets/relativeTime-DuOytR_J.js +0 -1
- package/dist/client/assets/relativeTime-DuOytR_J.js.br +0 -0
- package/dist/client/assets/relativeTime-DuOytR_J.js.gz +0 -0
- package/dist/client/assets/sigma-CI6gmAkl.js +0 -1
- package/dist/client/assets/spellCheck-DDCaK8Yx.js.br +0 -0
- package/dist/client/assets/spellCheck-DDCaK8Yx.js.gz +0 -0
- package/dist/client/assets/tags-CLK7WRSs.js +0 -1
- package/preview-1.png +0 -0
- package/preview-2.png +0 -0
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
import os from "node:os";
|
|
2
|
+
import fs from "node:fs";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import Database from "better-sqlite3";
|
|
5
|
+
import { agentLaunch, copyAgentSetting, executeAgentCommand } from "./common.js";
|
|
6
|
+
import { httpError } from "../../http.js";
|
|
7
|
+
const validSessionId = (id) => typeof id === "string" && /^ses_[\w-]+$/.test(id);
|
|
8
|
+
const privateDatabase = (context) => path.join(context.stateDirectory, "data", "opencode", "opencode.db");
|
|
9
|
+
const bindingFile = (context) => path.join(context.stateDirectory, "opencode-session.json");
|
|
10
|
+
const taskSessionId = (context) => `ses_texlite${context.taskId.replaceAll("-", "")}`;
|
|
11
|
+
function sharedSession(context) {
|
|
12
|
+
try {
|
|
13
|
+
const value = JSON.parse(fs.readFileSync(bindingFile(context), "utf8"));
|
|
14
|
+
if (!value || typeof value !== "object" || !("database" in value) || typeof value.database !== "string"
|
|
15
|
+
|| !path.isAbsolute(value.database) || !("sessionId" in value) || value.sessionId !== taskSessionId(context)) {
|
|
16
|
+
throw httpError(409, "AGENT_CONTEXT_CHECK_FAILED");
|
|
17
|
+
}
|
|
18
|
+
return { database: value.database, sessionId: value.sessionId };
|
|
19
|
+
}
|
|
20
|
+
catch (error) {
|
|
21
|
+
if (error.code === "ENOENT")
|
|
22
|
+
return null;
|
|
23
|
+
throw httpError(409, "AGENT_CONTEXT_CHECK_FAILED");
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
function nativeState(context) {
|
|
27
|
+
const binding = sharedSession(context);
|
|
28
|
+
if (binding)
|
|
29
|
+
return { shared: true, registered: true, ...binding };
|
|
30
|
+
// Keep existing private conversations where they were created. Empty private
|
|
31
|
+
// stores can be upgraded in prepare(), but are never silently abandoned.
|
|
32
|
+
if (!context.features.has("standalone") || fs.existsSync(privateDatabase(context))) {
|
|
33
|
+
return { shared: false, registered: false, database: privateDatabase(context), sessionId: context.nativeSessionId };
|
|
34
|
+
}
|
|
35
|
+
const data = process.env.XDG_DATA_HOME ?? path.join(os.homedir(), ".local", "share");
|
|
36
|
+
return { shared: true, registered: false, database: process.env.OPENCODE_DB ?? path.join(data, "opencode", "opencode.db"), sessionId: taskSessionId(context) };
|
|
37
|
+
}
|
|
38
|
+
function inspectDatabase(filename, expectedId) {
|
|
39
|
+
const db = new Database(filename, { readonly: true });
|
|
40
|
+
try {
|
|
41
|
+
// V2 may retain the legacy table after migration. Its current projection is
|
|
42
|
+
// authoritative: a deleted V2 session must not reappear from a legacy row.
|
|
43
|
+
const table = db.prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name IN ('session_v2', 'session')
|
|
44
|
+
ORDER BY CASE name WHEN 'session_v2' THEN 0 ELSE 1 END LIMIT 1`).get();
|
|
45
|
+
if (!table)
|
|
46
|
+
return { status: "unknown" };
|
|
47
|
+
if (expectedId) {
|
|
48
|
+
const found = db.prepare(`SELECT id FROM ${table.name} WHERE id = ?`).get(expectedId);
|
|
49
|
+
return found && validSessionId(found.id) ? { status: "found", id: found.id } : { status: "empty" };
|
|
50
|
+
}
|
|
51
|
+
const rows = db.prepare(`SELECT id FROM ${table.name} LIMIT 2`).all();
|
|
52
|
+
if (rows.length === 0)
|
|
53
|
+
return { status: "empty" };
|
|
54
|
+
return rows.length === 1 && validSessionId(rows[0].id) ? { status: "found", id: rows[0].id } : { status: "unknown" };
|
|
55
|
+
}
|
|
56
|
+
finally {
|
|
57
|
+
db.close();
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
/** Project deletion must not prevent exact-ID cleanup in the bound database. */
|
|
61
|
+
async function managementDirectory(context) {
|
|
62
|
+
try {
|
|
63
|
+
if ((await fs.promises.stat(context.workingDirectory)).isDirectory())
|
|
64
|
+
return context.workingDirectory;
|
|
65
|
+
}
|
|
66
|
+
catch (error) {
|
|
67
|
+
if (!["ENOENT", "ENOTDIR"].includes(error.code ?? ""))
|
|
68
|
+
throw error;
|
|
69
|
+
}
|
|
70
|
+
return context.stateDirectory;
|
|
71
|
+
}
|
|
72
|
+
export const opencodeAdapter = {
|
|
73
|
+
id: "opencode", label: "OpenCode", supportsResume: true,
|
|
74
|
+
async discoverFeatures(executable) {
|
|
75
|
+
const { stdout } = await executeAgentCommand(executable, ["--help"], { timeout: 5_000, maxBuffer: 128 * 1024, windowsHide: true });
|
|
76
|
+
return new Set(/(?:^|\s)--standalone(?:\s|$)/m.test(stdout) ? ["standalone"] : []);
|
|
77
|
+
},
|
|
78
|
+
async prepare(context) {
|
|
79
|
+
if (context.nativeSessionId) {
|
|
80
|
+
// Newer CLIs can CREATE a conversation for an unknown --session ID.
|
|
81
|
+
// Verify it first so a missing saved conversation is never replaced.
|
|
82
|
+
const native = await this.findNativeSession(context);
|
|
83
|
+
if (native.status === "unknown")
|
|
84
|
+
throw httpError(409, "AGENT_CONTEXT_CHECK_FAILED");
|
|
85
|
+
if (native.status !== "found" || native.id !== context.nativeSessionId)
|
|
86
|
+
throw httpError(409, "AGENT_NO_CONTEXT");
|
|
87
|
+
}
|
|
88
|
+
const state = nativeState(context);
|
|
89
|
+
if (state.shared && !context.features.has("standalone"))
|
|
90
|
+
throw httpError(409, "AGENT_UNAVAILABLE");
|
|
91
|
+
if (state.shared && state.registered)
|
|
92
|
+
return;
|
|
93
|
+
if (!state.shared && (context.nativeSessionId || !context.features.has("standalone"))) {
|
|
94
|
+
const host = path.join(process.env.XDG_DATA_HOME ?? path.join(os.homedir(), ".local", "share"), "opencode");
|
|
95
|
+
await copyAgentSetting(path.join(host, "auth.json"), path.join(context.stateDirectory, "data", "opencode", "auth.json"));
|
|
96
|
+
return;
|
|
97
|
+
}
|
|
98
|
+
if (!state.shared && (await this.findNativeSession(context)).status !== "empty")
|
|
99
|
+
throw httpError(409, "AGENT_CONTEXT_CHECK_FAILED");
|
|
100
|
+
// Ask the native CLI, rather than guessing release-channel/platform paths.
|
|
101
|
+
// Authentication stays entirely in the host database; no credentials are copied.
|
|
102
|
+
const env = agentLaunch(context, []).env;
|
|
103
|
+
if (process.env.OPENCODE_DB)
|
|
104
|
+
env.OPENCODE_DB = process.env.OPENCODE_DB;
|
|
105
|
+
let database;
|
|
106
|
+
try {
|
|
107
|
+
const { stdout } = await executeAgentCommand(context.executable, ["debug", "paths", "db"], {
|
|
108
|
+
cwd: context.workingDirectory, env, timeout: 5_000, maxBuffer: 16 * 1024, windowsHide: true
|
|
109
|
+
});
|
|
110
|
+
database = stdout.trim();
|
|
111
|
+
}
|
|
112
|
+
catch {
|
|
113
|
+
throw httpError(409, "AGENT_CONTEXT_CHECK_FAILED");
|
|
114
|
+
}
|
|
115
|
+
if (!path.isAbsolute(database) || /[\r\n\0]/.test(database))
|
|
116
|
+
throw httpError(409, "AGENT_CONTEXT_CHECK_FAILED");
|
|
117
|
+
const sessionId = taskSessionId(context);
|
|
118
|
+
// Register ownership before launching, and never claim an existing native
|
|
119
|
+
// conversation merely because it is the newest/only one in the database.
|
|
120
|
+
if (fs.existsSync(database) && inspectDatabase(database, sessionId).status !== "empty")
|
|
121
|
+
throw httpError(409, "AGENT_CONTEXT_CHECK_FAILED");
|
|
122
|
+
await fs.promises.mkdir(context.stateDirectory, { recursive: true, mode: 0o700 });
|
|
123
|
+
await fs.promises.writeFile(bindingFile(context), JSON.stringify({ database, sessionId }), { flag: "wx", mode: 0o600 });
|
|
124
|
+
},
|
|
125
|
+
start(context) {
|
|
126
|
+
const state = nativeState(context);
|
|
127
|
+
const args = context.features.has("standalone") ? ["--standalone"] : [];
|
|
128
|
+
return state.shared
|
|
129
|
+
? agentLaunch(context, [...args, "--session", state.sessionId], { OPENCODE_DB: state.database })
|
|
130
|
+
: agentLaunch(context, args, { OPENCODE_DB: state.database, XDG_DATA_HOME: path.join(context.stateDirectory, "data"),
|
|
131
|
+
XDG_STATE_HOME: path.join(context.stateDirectory, "runtime") });
|
|
132
|
+
},
|
|
133
|
+
resume(context) {
|
|
134
|
+
const state = nativeState(context);
|
|
135
|
+
if (state.shared && (!state.registered || state.sessionId !== context.nativeSessionId))
|
|
136
|
+
throw httpError(409, "AGENT_CONTEXT_CHECK_FAILED");
|
|
137
|
+
const launch = this.start(context);
|
|
138
|
+
return state.shared ? launch : { ...launch, args: [...launch.args, "--session", context.nativeSessionId] };
|
|
139
|
+
},
|
|
140
|
+
async findNativeSession(context) {
|
|
141
|
+
try {
|
|
142
|
+
// The list command may create a database itself. A missing task database
|
|
143
|
+
// must never be mistaken for a verified empty one after state loss.
|
|
144
|
+
const state = nativeState(context);
|
|
145
|
+
if (state.shared && (!state.registered || (context.nativeSessionId && context.nativeSessionId !== state.sessionId)))
|
|
146
|
+
return { status: "unknown" };
|
|
147
|
+
if (!(await fs.promises.stat(state.database)).isFile())
|
|
148
|
+
return { status: "unknown" };
|
|
149
|
+
// A shared database is queried by this task's registered ID only.
|
|
150
|
+
try {
|
|
151
|
+
return inspectDatabase(state.database, state.shared ? state.sessionId : context.nativeSessionId);
|
|
152
|
+
}
|
|
153
|
+
catch { /* Other native versions/formats can still be identified by the CLI. */ }
|
|
154
|
+
if (state.shared || context.features.has("standalone"))
|
|
155
|
+
return { status: "unknown" };
|
|
156
|
+
const launch = this.start(context);
|
|
157
|
+
const { stdout } = await executeAgentCommand(context.executable, ["session", "list", "--format", "json"], {
|
|
158
|
+
// OpenCode resolves project sessions from cwd as well as its state DB.
|
|
159
|
+
cwd: await managementDirectory(context), env: launch.env, timeout: 5_000, maxBuffer: 1024 * 1024, windowsHide: true
|
|
160
|
+
});
|
|
161
|
+
const records = JSON.parse(stdout);
|
|
162
|
+
if (Array.isArray(records) && records.length === 0)
|
|
163
|
+
return { status: "empty" };
|
|
164
|
+
if (Array.isArray(records) && records.length === 1 && validSessionId(records[0]?.id))
|
|
165
|
+
return { status: "found", id: records[0].id };
|
|
166
|
+
}
|
|
167
|
+
catch { /* Version-dependent management capability. */ }
|
|
168
|
+
return { status: "unknown" };
|
|
169
|
+
},
|
|
170
|
+
async cleanup(context) {
|
|
171
|
+
const state = nativeState(context);
|
|
172
|
+
if (state.shared) {
|
|
173
|
+
if (!state.registered || (context.nativeSessionId && context.nativeSessionId !== state.sessionId))
|
|
174
|
+
throw httpError(409, "AGENT_CLEANUP_FAILED");
|
|
175
|
+
const native = await this.findNativeSession(context);
|
|
176
|
+
if (native.status === "unknown")
|
|
177
|
+
throw httpError(409, "AGENT_CLEANUP_FAILED");
|
|
178
|
+
if (native.status === "empty")
|
|
179
|
+
return; // An exact-ID deletion already succeeded.
|
|
180
|
+
await executeAgentCommand(context.executable, ["session", "delete", state.sessionId, "--standalone"], {
|
|
181
|
+
cwd: await managementDirectory(context), env: this.start(context).env, timeout: 15_000, maxBuffer: 64 * 1024, windowsHide: true
|
|
182
|
+
});
|
|
183
|
+
if ((await this.findNativeSession(context)).status !== "empty")
|
|
184
|
+
throw httpError(409, "AGENT_CLEANUP_FAILED");
|
|
185
|
+
return;
|
|
186
|
+
}
|
|
187
|
+
// Private state can be removed with the task after its process tree stops.
|
|
188
|
+
if (context.features.has("standalone"))
|
|
189
|
+
return;
|
|
190
|
+
const native = context.nativeSessionId && context.executable ? await this.findNativeSession(context) : null;
|
|
191
|
+
if (native?.status === "found" && native.id === context.nativeSessionId)
|
|
192
|
+
await executeAgentCommand(context.executable, ["session", "delete", native.id], {
|
|
193
|
+
cwd: await managementDirectory(context), env: this.start(context).env, timeout: 15_000, maxBuffer: 64 * 1024, windowsHide: true
|
|
194
|
+
});
|
|
195
|
+
}
|
|
196
|
+
};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import { randomUUID } from "node:crypto";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
import { inspectAgentProcess, agentProcessGroupAlive } from "./processIdentity.js";
|
|
5
|
+
import { stopAgentPty, windowsAgentCommand } from "./terminal.js";
|
|
6
|
+
import { httpError } from "../http.js";
|
|
7
|
+
function readRecord(filename) {
|
|
8
|
+
let value;
|
|
9
|
+
try {
|
|
10
|
+
value = JSON.parse(fs.readFileSync(filename, "utf8"));
|
|
11
|
+
}
|
|
12
|
+
catch (error) {
|
|
13
|
+
if (error.code === "ENOENT")
|
|
14
|
+
return null;
|
|
15
|
+
throw error;
|
|
16
|
+
}
|
|
17
|
+
if (value?.version !== 1 || !/^[a-f\d-]{36}$/.test(value.executionId) || value.platform !== process.platform
|
|
18
|
+
|| !(value.pid === null && value.identity === null || Number.isSafeInteger(value.pid) && value.pid > 0 && typeof value.identity === "string" && value.identity)) {
|
|
19
|
+
throw httpError(409, "AGENT_RECOVERY_FAILED");
|
|
20
|
+
}
|
|
21
|
+
return value;
|
|
22
|
+
}
|
|
23
|
+
export function clearAgentExecution(filename) {
|
|
24
|
+
const record = readRecord(filename);
|
|
25
|
+
if (record) {
|
|
26
|
+
fs.rmSync(`${filename}.${record.executionId}.exit`, { force: true });
|
|
27
|
+
fs.rmSync(`${filename}.${record.executionId}.exit.tmp`, { force: true });
|
|
28
|
+
}
|
|
29
|
+
fs.rmSync(`${filename}.tmp`, { force: true });
|
|
30
|
+
fs.rmSync(filename, { force: true });
|
|
31
|
+
}
|
|
32
|
+
/** Only verified launchers may be signalled. Ambiguity keeps the durable lease. */
|
|
33
|
+
export async function recoverAgentExecution(filename) {
|
|
34
|
+
const record = readRecord(filename);
|
|
35
|
+
if (!record)
|
|
36
|
+
return;
|
|
37
|
+
if (record.pid !== null) {
|
|
38
|
+
const process = await inspectAgentProcess(record.pid, record.executionId);
|
|
39
|
+
if (process && process.identity === record.identity && process.owned) {
|
|
40
|
+
// Verify twice before signalling; a recycled PID must never be targeted.
|
|
41
|
+
const current = await inspectAgentProcess(record.pid, record.executionId);
|
|
42
|
+
if (!current || current.identity !== record.identity || !current.owned)
|
|
43
|
+
throw httpError(409, "AGENT_RECOVERY_FAILED");
|
|
44
|
+
await stopAgentPty({ pid: record.pid });
|
|
45
|
+
const deadline = Date.now() + 3_000;
|
|
46
|
+
while (true) {
|
|
47
|
+
const remaining = await inspectAgentProcess(record.pid, record.executionId);
|
|
48
|
+
if ((!remaining || remaining.identity !== record.identity) && !await agentProcessGroupAlive(record.pid))
|
|
49
|
+
break;
|
|
50
|
+
if (Date.now() >= deadline)
|
|
51
|
+
throw httpError(409, "AGENT_RECOVERY_FAILED");
|
|
52
|
+
await new Promise((resolve) => setTimeout(resolve, 50));
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
else if (process && process.identity === record.identity) {
|
|
56
|
+
throw httpError(409, "AGENT_RECOVERY_FAILED");
|
|
57
|
+
}
|
|
58
|
+
else if (!process && await agentProcessGroupAlive(record.pid)) {
|
|
59
|
+
// The wrapper was independently killed. Do not guess ownership of a
|
|
60
|
+
// leaderless group; the administrator can stop it on the host and retry.
|
|
61
|
+
throw httpError(409, "AGENT_RECOVERY_FAILED");
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
// An uncommitted launch cannot start the CLI. Removing its permit makes a
|
|
65
|
+
// delayed launcher exit, closing the spawn-before-identity-persistence gap.
|
|
66
|
+
clearAgentExecution(filename);
|
|
67
|
+
}
|
|
68
|
+
/** Start a gated, identifiable group leader without changing the CLI's TTY. */
|
|
69
|
+
export async function spawnRecoverableAgent(spawn, executable, args, options, filename, beforeStart) {
|
|
70
|
+
const record = { version: 1, executionId: randomUUID(), platform: process.platform, pid: null, identity: null };
|
|
71
|
+
fs.writeFileSync(filename, JSON.stringify(record), { flag: "wx", mode: 0o600 });
|
|
72
|
+
const compiled = new URL("./launcher.js", import.meta.url);
|
|
73
|
+
const launcher = fileURLToPath(fs.existsSync(compiled) ? compiled : new URL("./launcher.ts", import.meta.url));
|
|
74
|
+
let launch = { executable, args, windowsVerbatimArguments: false };
|
|
75
|
+
if (process.platform === "win32" && /\.(?:cmd|bat)$/i.test(executable)) {
|
|
76
|
+
const command = windowsAgentCommand(executable, args);
|
|
77
|
+
launch = { executable: command.executable, args: ["/d", "/v:off", "/s", "/c", command.args.slice("/d /v:off /s /c ".length)], windowsVerbatimArguments: true };
|
|
78
|
+
}
|
|
79
|
+
let pty;
|
|
80
|
+
try {
|
|
81
|
+
pty = await spawn(process.execPath, [launcher, filename, record.executionId], {
|
|
82
|
+
...options, env: { ...options.env, TEXLITE_AGENT_LAUNCH: JSON.stringify(launch) }
|
|
83
|
+
});
|
|
84
|
+
const wrapped = observeCliExit(pty, filename, record.executionId);
|
|
85
|
+
let identity = await inspectAgentProcess(pty.pid, record.executionId);
|
|
86
|
+
// Some PTY backends briefly expose their fork/exec helper's command line.
|
|
87
|
+
const deadline = Date.now() + 3_000;
|
|
88
|
+
while (!identity?.owned && Date.now() < deadline) {
|
|
89
|
+
await new Promise((resolve) => setTimeout(resolve, 25));
|
|
90
|
+
identity = await inspectAgentProcess(pty.pid, record.executionId);
|
|
91
|
+
}
|
|
92
|
+
if (!identity?.owned)
|
|
93
|
+
throw httpError(409, "AGENT_START_FAILED");
|
|
94
|
+
record.pid = pty.pid;
|
|
95
|
+
record.identity = identity.identity;
|
|
96
|
+
// Conversation cleanup ownership must be durable before the CLI is allowed
|
|
97
|
+
// to create any native state, not after the launch promise returns.
|
|
98
|
+
beforeStart?.();
|
|
99
|
+
const temporary = `${filename}.tmp`;
|
|
100
|
+
fs.writeFileSync(temporary, JSON.stringify(record), { mode: 0o600 });
|
|
101
|
+
fs.renameSync(temporary, filename);
|
|
102
|
+
return wrapped;
|
|
103
|
+
}
|
|
104
|
+
catch (error) {
|
|
105
|
+
// No permit was issued, so the CLI cannot have started. Keep any failed
|
|
106
|
+
// cleanup lease so service recovery can cancel the waiting launcher.
|
|
107
|
+
if (pty)
|
|
108
|
+
await stopAgentPty(pty);
|
|
109
|
+
clearAgentExecution(filename);
|
|
110
|
+
throw error;
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
function observeCliExit(pty, filename, executionId) {
|
|
114
|
+
const resultFile = `${filename}.${executionId}.exit`;
|
|
115
|
+
const listeners = new Set();
|
|
116
|
+
let exited;
|
|
117
|
+
const notify = (event) => {
|
|
118
|
+
if (exited)
|
|
119
|
+
return;
|
|
120
|
+
exited = event;
|
|
121
|
+
for (const listener of listeners)
|
|
122
|
+
listener(event);
|
|
123
|
+
};
|
|
124
|
+
const readExit = () => {
|
|
125
|
+
try {
|
|
126
|
+
const result = JSON.parse(fs.readFileSync(resultFile, "utf8"));
|
|
127
|
+
if (result.executionId === executionId && Number.isInteger(result.exitCode))
|
|
128
|
+
notify({ exitCode: result.exitCode });
|
|
129
|
+
}
|
|
130
|
+
catch (error) {
|
|
131
|
+
if (error.code !== "ENOENT")
|
|
132
|
+
notify({ exitCode: 1 });
|
|
133
|
+
}
|
|
134
|
+
};
|
|
135
|
+
fs.watchFile(resultFile, { interval: 100, persistent: false }, readExit);
|
|
136
|
+
pty.onExit((event) => { fs.unwatchFile(resultFile, readExit); notify(event); });
|
|
137
|
+
return { pid: pty.pid, write: (data) => pty.write(data), resize: (cols, rows) => pty.resize(cols, rows), onData: (callback) => pty.onData(callback),
|
|
138
|
+
onExit: (callback) => {
|
|
139
|
+
listeners.add(callback);
|
|
140
|
+
if (exited) {
|
|
141
|
+
const event = exited;
|
|
142
|
+
queueMicrotask(() => { if (listeners.has(callback))
|
|
143
|
+
callback(event); });
|
|
144
|
+
}
|
|
145
|
+
return { dispose: () => { listeners.delete(callback); } };
|
|
146
|
+
} };
|
|
147
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// Deliberately imports only Node builtins: the same file runs as compiled JS in
|
|
2
|
+
// npm installs and with Node 24's native TypeScript support in development.
|
|
3
|
+
import fs from "node:fs";
|
|
4
|
+
import { spawn } from "node:child_process";
|
|
5
|
+
import { constants } from "node:os";
|
|
6
|
+
const [recordFile, executionId] = process.argv.slice(2);
|
|
7
|
+
const launch = JSON.parse(process.env.TEXLITE_AGENT_LAUNCH ?? "null");
|
|
8
|
+
delete process.env.TEXLITE_AGENT_LAUNCH;
|
|
9
|
+
if (!recordFile || !executionId || !launch)
|
|
10
|
+
throw new Error("Missing agent launch context");
|
|
11
|
+
// Keep the identifiable group leader alive until TexLite reaps the whole group,
|
|
12
|
+
// even if the service dies or the CLI exits before its workers do.
|
|
13
|
+
process.on("SIGTERM", () => undefined);
|
|
14
|
+
process.on("SIGINT", () => undefined);
|
|
15
|
+
if (process.platform !== "win32")
|
|
16
|
+
process.on("SIGHUP", () => undefined);
|
|
17
|
+
const deadline = Date.now() + 10_000;
|
|
18
|
+
while (true) {
|
|
19
|
+
let record;
|
|
20
|
+
try {
|
|
21
|
+
record = JSON.parse(fs.readFileSync(recordFile, "utf8"));
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
process.exit(1);
|
|
25
|
+
}
|
|
26
|
+
if (record.executionId !== executionId)
|
|
27
|
+
process.exit(1);
|
|
28
|
+
if (record.pid === process.pid && record.identity)
|
|
29
|
+
break;
|
|
30
|
+
if (Date.now() >= deadline)
|
|
31
|
+
process.exit(1);
|
|
32
|
+
await new Promise((resolve) => setTimeout(resolve, 25));
|
|
33
|
+
}
|
|
34
|
+
// This interval only keeps the launcher available for verified tree cleanup;
|
|
35
|
+
// it imposes no time limit on the user's task.
|
|
36
|
+
setInterval(() => undefined, 60_000);
|
|
37
|
+
const resultFile = `${recordFile}.${executionId}.exit`;
|
|
38
|
+
let reported = false;
|
|
39
|
+
function report(exitCode) {
|
|
40
|
+
if (reported)
|
|
41
|
+
return;
|
|
42
|
+
reported = true;
|
|
43
|
+
const temporary = `${resultFile}.tmp`;
|
|
44
|
+
fs.writeFileSync(temporary, JSON.stringify({ executionId, exitCode }), { mode: 0o600 });
|
|
45
|
+
fs.renameSync(temporary, resultFile);
|
|
46
|
+
}
|
|
47
|
+
try {
|
|
48
|
+
const child = spawn(launch.executable, launch.args, {
|
|
49
|
+
stdio: "inherit", shell: false, windowsVerbatimArguments: launch.windowsVerbatimArguments
|
|
50
|
+
});
|
|
51
|
+
child.on("error", (error) => { console.error(error.message); report(1); });
|
|
52
|
+
child.on("exit", (code, signal) => report(code ?? (128 + (signal ? constants.signals[signal] ?? 0 : 0))));
|
|
53
|
+
}
|
|
54
|
+
catch (error) {
|
|
55
|
+
console.error(error instanceof Error ? error.message : error);
|
|
56
|
+
report(1);
|
|
57
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import fs from "node:fs/promises";
|
|
2
|
+
import { execFile } from "node:child_process";
|
|
3
|
+
import { promisify } from "node:util";
|
|
4
|
+
const systemIO = {
|
|
5
|
+
platform: process.platform,
|
|
6
|
+
read: (filename) => fs.readFile(filename, "utf8"),
|
|
7
|
+
command: async (command, args) => (await promisify(execFile)(command, args, { timeout: 5_000, maxBuffer: 4 * 1024 * 1024, windowsHide: true })).stdout
|
|
8
|
+
};
|
|
9
|
+
const missing = (error) => ["ENOENT", "ESRCH"].includes(error.code ?? "");
|
|
10
|
+
const marker = (command, executionId) => command.includes(executionId) && /(?:^|[\\/])launcher\.(?:js|ts)(?:[\s"\0]|$)/.test(command);
|
|
11
|
+
/** Birth identity plus a per-execution launcher marker; never trust a stored PID alone. */
|
|
12
|
+
export async function inspectAgentProcess(pid, executionId, io = systemIO) {
|
|
13
|
+
if (!Number.isSafeInteger(pid) || pid <= 0)
|
|
14
|
+
throw new Error("Invalid agent process ID");
|
|
15
|
+
if (io.platform === "linux") {
|
|
16
|
+
try {
|
|
17
|
+
const [stat, command, boot] = await Promise.all([io.read(`/proc/${pid}/stat`), io.read(`/proc/${pid}/cmdline`), io.read("/proc/sys/kernel/random/boot_id")]);
|
|
18
|
+
const fields = stat.slice(stat.lastIndexOf(")") + 2).trim().split(/\s+/);
|
|
19
|
+
if (fields.length < 20 || !/^\d+$/.test(fields[19]))
|
|
20
|
+
throw new Error("Cannot verify agent process birth");
|
|
21
|
+
if (fields[0] === "Z" || fields[0] === "X")
|
|
22
|
+
return null;
|
|
23
|
+
return { identity: `${boot.trim()}:${fields[19]}`, owned: marker(command.replaceAll("\0", " "), executionId) };
|
|
24
|
+
}
|
|
25
|
+
catch (error) {
|
|
26
|
+
if (missing(error))
|
|
27
|
+
return null;
|
|
28
|
+
throw error;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
if (io.platform === "win32") {
|
|
32
|
+
const output = await io.command("powershell.exe", ["-NoLogo", "-NoProfile", "-NonInteractive", "-Command",
|
|
33
|
+
`Get-CimInstance Win32_Process -Filter 'ProcessId = ${pid}' -ErrorAction Stop | Select-Object CreationDate,CommandLine | ConvertTo-Json -Compress`]);
|
|
34
|
+
if (!output.trim())
|
|
35
|
+
return null;
|
|
36
|
+
const value = JSON.parse(output);
|
|
37
|
+
if (value === null)
|
|
38
|
+
return null;
|
|
39
|
+
if (typeof value.CreationDate !== "string" || typeof value.CommandLine !== "string")
|
|
40
|
+
throw new Error("Cannot verify agent process birth");
|
|
41
|
+
return { identity: value.CreationDate, owned: marker(value.CommandLine, executionId) };
|
|
42
|
+
}
|
|
43
|
+
// macOS and other POSIX hosts expose a start time and full command via ps.
|
|
44
|
+
// Querying the full table distinguishes a missing PID from ps invocation errors.
|
|
45
|
+
const output = await io.command("ps", ["-ww", "-axo", "pid=,lstart=,args="]);
|
|
46
|
+
const line = output.split("\n").find((line) => Number(line.trim().match(/^\d+/)?.[0]) === pid);
|
|
47
|
+
if (!line)
|
|
48
|
+
return null;
|
|
49
|
+
const match = line.trim().match(/^\d+\s+(\w+\s+\w+\s+\d+\s+\d+:\d+:\d+\s+\d+)\s+(.+)$/);
|
|
50
|
+
if (!match)
|
|
51
|
+
throw new Error("Cannot verify agent process birth");
|
|
52
|
+
return { identity: match[1].replace(/\s+/g, " "), owned: marker(match[2], executionId) };
|
|
53
|
+
}
|
|
54
|
+
/** A vanished leader is not proof that all members of its POSIX group exited. */
|
|
55
|
+
export async function agentProcessGroupAlive(pid, io = systemIO) {
|
|
56
|
+
if (io.platform === "win32")
|
|
57
|
+
return false;
|
|
58
|
+
const output = await io.command("ps", ["-axo", "pgid=,stat="]);
|
|
59
|
+
return output.split("\n").some((line) => {
|
|
60
|
+
const [group, state] = line.trim().split(/\s+/);
|
|
61
|
+
return Number(group) === pid && state && !/^[ZX]/.test(state);
|
|
62
|
+
});
|
|
63
|
+
}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { AGENT_IDS } from "../../shared/agentProtocol.js";
|
|
4
|
+
import { executeAgentCommand } from "./adapters/common.js";
|
|
5
|
+
import { codexAdapter } from "./adapters/codex.js";
|
|
6
|
+
import { opencodeAdapter } from "./adapters/opencode.js";
|
|
7
|
+
import { claudeAdapter } from "./adapters/claude.js";
|
|
8
|
+
export function findAgentExecutable(name) {
|
|
9
|
+
const suffixes = process.platform === "win32" ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT").split(";") : [""];
|
|
10
|
+
for (const directory of (process.env.PATH ?? "").split(path.delimiter).filter(Boolean)) {
|
|
11
|
+
for (const suffix of suffixes) {
|
|
12
|
+
const candidate = path.join(directory, `${name}${suffix}`);
|
|
13
|
+
try {
|
|
14
|
+
fs.accessSync(candidate, process.platform === "win32" ? fs.constants.F_OK : fs.constants.X_OK);
|
|
15
|
+
if (fs.statSync(candidate).isFile())
|
|
16
|
+
return candidate;
|
|
17
|
+
}
|
|
18
|
+
catch { /* Try the next PATH entry. */ }
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
return null;
|
|
22
|
+
}
|
|
23
|
+
/** Registration/discovery only: native flags belong in individual adapters. */
|
|
24
|
+
export class AgentRegistry {
|
|
25
|
+
resolveExecutable;
|
|
26
|
+
detected = new Map();
|
|
27
|
+
adapters;
|
|
28
|
+
constructor(resolveExecutable = findAgentExecutable, adapters = [codexAdapter, opencodeAdapter, claudeAdapter]) {
|
|
29
|
+
this.resolveExecutable = resolveExecutable;
|
|
30
|
+
this.adapters = new Map(adapters.map((adapter) => [adapter.id, adapter]));
|
|
31
|
+
}
|
|
32
|
+
adapter(id) { return this.adapters.get(id); }
|
|
33
|
+
refresh() { this.detected.clear(); }
|
|
34
|
+
detect(id) {
|
|
35
|
+
let result = this.detected.get(id);
|
|
36
|
+
if (!result) {
|
|
37
|
+
result = this.probe(id);
|
|
38
|
+
this.detected.set(id, result);
|
|
39
|
+
}
|
|
40
|
+
return result;
|
|
41
|
+
}
|
|
42
|
+
async catalog(policy) {
|
|
43
|
+
return Promise.all(AGENT_IDS.map(async (id) => {
|
|
44
|
+
const detected = await this.detect(id);
|
|
45
|
+
const adapter = this.adapter(id);
|
|
46
|
+
return { id, label: adapter.label, installed: detected.executable !== null,
|
|
47
|
+
version: detected.version, enabled: policy.allowed.includes(id) };
|
|
48
|
+
}));
|
|
49
|
+
}
|
|
50
|
+
async context(id, taskId, root, nativeSessionId, workingDirectory) {
|
|
51
|
+
const detected = await this.detect(id);
|
|
52
|
+
return { taskId, stateDirectory: path.join(root, "state"), workingDirectory,
|
|
53
|
+
nativeSessionId, executable: detected.executable ?? "", features: detected.features };
|
|
54
|
+
}
|
|
55
|
+
async probe(id) {
|
|
56
|
+
const executable = this.resolveExecutable(id);
|
|
57
|
+
if (!executable)
|
|
58
|
+
return { executable: null, version: null, features: new Set() };
|
|
59
|
+
let version = null;
|
|
60
|
+
let features = new Set();
|
|
61
|
+
try {
|
|
62
|
+
const { stdout } = await executeAgentCommand(executable, ["--version"], { timeout: 5_000, maxBuffer: 64 * 1024, windowsHide: true });
|
|
63
|
+
version = stdout.match(/\bv?(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)/)?.[1] ?? null;
|
|
64
|
+
}
|
|
65
|
+
catch { /* Installed agents need not implement --version. */ }
|
|
66
|
+
try {
|
|
67
|
+
features = await this.adapter(id).discoverFeatures(executable);
|
|
68
|
+
}
|
|
69
|
+
catch { /* Optional capabilities. */ }
|
|
70
|
+
return { executable, version, features };
|
|
71
|
+
}
|
|
72
|
+
}
|