@mostok/codexes 0.1.0

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.
Files changed (96) hide show
  1. package/LICENSE +15 -0
  2. package/README.md +88 -0
  3. package/dist/accounts/account-registry.d.ts +30 -0
  4. package/dist/accounts/account-registry.js +263 -0
  5. package/dist/accounts/account-registry.js.map +1 -0
  6. package/dist/accounts/account-resolution.d.ts +16 -0
  7. package/dist/accounts/account-resolution.js +71 -0
  8. package/dist/accounts/account-resolution.js.map +1 -0
  9. package/dist/accounts/resolve-active-account.d.ts +6 -0
  10. package/dist/accounts/resolve-active-account.js +32 -0
  11. package/dist/accounts/resolve-active-account.js.map +1 -0
  12. package/dist/cli.d.ts +1 -0
  13. package/dist/cli.js +3426 -0
  14. package/dist/cli.js.map +7 -0
  15. package/dist/commands/account-add/run-account-add-command.d.ts +2 -0
  16. package/dist/commands/account-add/run-account-add-command.js +296 -0
  17. package/dist/commands/account-add/run-account-add-command.js.map +1 -0
  18. package/dist/commands/account-list/run-account-list-command.d.ts +2 -0
  19. package/dist/commands/account-list/run-account-list-command.js +48 -0
  20. package/dist/commands/account-list/run-account-list-command.js.map +1 -0
  21. package/dist/commands/account-remove/run-account-remove-command.d.ts +2 -0
  22. package/dist/commands/account-remove/run-account-remove-command.js +52 -0
  23. package/dist/commands/account-remove/run-account-remove-command.js.map +1 -0
  24. package/dist/commands/account-use/run-account-use-command.d.ts +2 -0
  25. package/dist/commands/account-use/run-account-use-command.js +78 -0
  26. package/dist/commands/account-use/run-account-use-command.js.map +1 -0
  27. package/dist/commands/root/run-root-command.d.ts +2 -0
  28. package/dist/commands/root/run-root-command.js +175 -0
  29. package/dist/commands/root/run-root-command.js.map +1 -0
  30. package/dist/config/wrapper-config.d.ts +24 -0
  31. package/dist/config/wrapper-config.js +145 -0
  32. package/dist/config/wrapper-config.js.map +1 -0
  33. package/dist/core/bootstrap.d.ts +8 -0
  34. package/dist/core/bootstrap.js +32 -0
  35. package/dist/core/bootstrap.js.map +1 -0
  36. package/dist/core/context.d.ts +33 -0
  37. package/dist/core/context.js +72 -0
  38. package/dist/core/context.js.map +1 -0
  39. package/dist/core/paths.d.ts +12 -0
  40. package/dist/core/paths.js +30 -0
  41. package/dist/core/paths.js.map +1 -0
  42. package/dist/logging/logger.d.ts +18 -0
  43. package/dist/logging/logger.js +56 -0
  44. package/dist/logging/logger.js.map +1 -0
  45. package/dist/process/codex-launch-spec.d.ts +5 -0
  46. package/dist/process/codex-launch-spec.js +80 -0
  47. package/dist/process/codex-launch-spec.js.map +1 -0
  48. package/dist/process/find-codex-binary.d.ts +14 -0
  49. package/dist/process/find-codex-binary.js +73 -0
  50. package/dist/process/find-codex-binary.js.map +1 -0
  51. package/dist/process/run-codex-login.d.ts +14 -0
  52. package/dist/process/run-codex-login.js +97 -0
  53. package/dist/process/run-codex-login.js.map +1 -0
  54. package/dist/process/spawn-codex-command.d.ts +7 -0
  55. package/dist/process/spawn-codex-command.js +69 -0
  56. package/dist/process/spawn-codex-command.js.map +1 -0
  57. package/dist/runtime/activate-account/activate-account.d.ts +27 -0
  58. package/dist/runtime/activate-account/activate-account.js +298 -0
  59. package/dist/runtime/activate-account/activate-account.js.map +1 -0
  60. package/dist/runtime/auth-state-probe.d.ts +57 -0
  61. package/dist/runtime/auth-state-probe.js +394 -0
  62. package/dist/runtime/auth-state-probe.js.map +1 -0
  63. package/dist/runtime/init/initialize-runtime.d.ts +19 -0
  64. package/dist/runtime/init/initialize-runtime.js +275 -0
  65. package/dist/runtime/init/initialize-runtime.js.map +1 -0
  66. package/dist/runtime/lock/runtime-lock.d.ts +11 -0
  67. package/dist/runtime/lock/runtime-lock.js +99 -0
  68. package/dist/runtime/lock/runtime-lock.js.map +1 -0
  69. package/dist/runtime/login-workspace.d.ts +18 -0
  70. package/dist/runtime/login-workspace.js +171 -0
  71. package/dist/runtime/login-workspace.js.map +1 -0
  72. package/dist/runtime/runtime-contract.d.ts +44 -0
  73. package/dist/runtime/runtime-contract.js +79 -0
  74. package/dist/runtime/runtime-contract.js.map +1 -0
  75. package/dist/selection/account-auth-state.d.ts +23 -0
  76. package/dist/selection/account-auth-state.js +132 -0
  77. package/dist/selection/account-auth-state.js.map +1 -0
  78. package/dist/selection/select-account.d.ts +11 -0
  79. package/dist/selection/select-account.js +168 -0
  80. package/dist/selection/select-account.js.map +1 -0
  81. package/dist/selection/usage-cache.d.ts +24 -0
  82. package/dist/selection/usage-cache.js +106 -0
  83. package/dist/selection/usage-cache.js.map +1 -0
  84. package/dist/selection/usage-client.d.ts +23 -0
  85. package/dist/selection/usage-client.js +143 -0
  86. package/dist/selection/usage-client.js.map +1 -0
  87. package/dist/selection/usage-normalize.d.ts +7 -0
  88. package/dist/selection/usage-normalize.js +209 -0
  89. package/dist/selection/usage-normalize.js.map +1 -0
  90. package/dist/selection/usage-probe-coordinator.d.ts +18 -0
  91. package/dist/selection/usage-probe-coordinator.js +69 -0
  92. package/dist/selection/usage-probe-coordinator.js.map +1 -0
  93. package/dist/selection/usage-types.d.ts +59 -0
  94. package/dist/selection/usage-types.js +2 -0
  95. package/dist/selection/usage-types.js.map +1 -0
  96. package/package.json +59 -0
@@ -0,0 +1,275 @@
1
+ import os from "node:os";
2
+ import path from "node:path";
3
+ import { copyFile, cp, mkdir, readFile, stat, writeFile, } from "node:fs/promises";
4
+ import { createAccountRegistry } from "../../accounts/account-registry.js";
5
+ export async function initializeRuntimeEnvironment(input) {
6
+ const legacyCodexHome = path.join(os.homedir(), ".codex");
7
+ const firstRun = !(await pathExists(input.paths.sharedCodexHome));
8
+ const createdDirectories = [];
9
+ const createdFiles = [];
10
+ const copiedSharedArtifacts = [];
11
+ const skippedArtifacts = [];
12
+ input.logger.info("runtime_init.start", {
13
+ dataRoot: input.paths.dataRoot,
14
+ sharedCodexHome: input.paths.sharedCodexHome,
15
+ legacyCodexHome,
16
+ firstRun,
17
+ });
18
+ for (const directory of [
19
+ input.paths.dataRoot,
20
+ input.paths.sharedCodexHome,
21
+ input.paths.accountRoot,
22
+ input.paths.runtimeRoot,
23
+ path.join(input.paths.runtimeRoot, "backups"),
24
+ path.join(input.paths.runtimeRoot, "tmp"),
25
+ path.dirname(input.paths.registryFile),
26
+ ]) {
27
+ if (!(await pathExists(directory))) {
28
+ createdDirectories.push(directory);
29
+ input.logger.info("runtime_init.directory_create", { directory });
30
+ }
31
+ else {
32
+ input.logger.debug("runtime_init.directory_exists", { directory });
33
+ }
34
+ await mkdir(directory, { recursive: true });
35
+ }
36
+ const configResult = await ensureSharedConfigToml({
37
+ legacyCodexHome,
38
+ logger: input.logger,
39
+ sharedCodexHome: input.paths.sharedCodexHome,
40
+ });
41
+ createdFiles.push(...configResult.createdFiles);
42
+ copiedSharedArtifacts.push(...configResult.copiedArtifacts);
43
+ skippedArtifacts.push(...configResult.skippedArtifacts);
44
+ const mcpResult = await ensureSharedFileCopy({
45
+ artifactName: "mcp.json",
46
+ logger: input.logger,
47
+ sharedCodexHome: input.paths.sharedCodexHome,
48
+ sourceCodexHome: legacyCodexHome,
49
+ });
50
+ createdFiles.push(...mcpResult.createdFiles);
51
+ copiedSharedArtifacts.push(...mcpResult.copiedArtifacts);
52
+ skippedArtifacts.push(...mcpResult.skippedArtifacts);
53
+ const trustResult = await ensureSharedDirectoryCopy({
54
+ artifactName: "trust",
55
+ logger: input.logger,
56
+ sharedCodexHome: input.paths.sharedCodexHome,
57
+ sourceCodexHome: legacyCodexHome,
58
+ });
59
+ copiedSharedArtifacts.push(...trustResult.copiedArtifacts);
60
+ skippedArtifacts.push(...trustResult.skippedArtifacts);
61
+ // Registry creation is part of first-run runtime setup but must not create account auth state.
62
+ const registry = createAccountRegistry({
63
+ accountRoot: input.paths.accountRoot,
64
+ logger: input.logger,
65
+ registryFile: input.paths.registryFile,
66
+ });
67
+ if (!(await pathExists(input.paths.registryFile))) {
68
+ createdFiles.push(input.paths.registryFile);
69
+ input.logger.info("runtime_init.registry_bootstrap", {
70
+ registryFile: input.paths.registryFile,
71
+ });
72
+ }
73
+ else {
74
+ input.logger.debug("runtime_init.registry_exists", {
75
+ registryFile: input.paths.registryFile,
76
+ });
77
+ }
78
+ await registry.listAccounts();
79
+ const result = {
80
+ firstRun,
81
+ legacyCodexHome,
82
+ sharedCodexHome: input.paths.sharedCodexHome,
83
+ createdDirectories,
84
+ createdFiles,
85
+ copiedSharedArtifacts,
86
+ skippedArtifacts,
87
+ };
88
+ input.logger.info("runtime_init.complete", {
89
+ firstRun: result.firstRun,
90
+ createdDirectories: result.createdDirectories,
91
+ createdFiles: result.createdFiles,
92
+ copiedSharedArtifacts: result.copiedSharedArtifacts,
93
+ skippedArtifacts: result.skippedArtifacts,
94
+ });
95
+ return result;
96
+ }
97
+ async function ensureSharedConfigToml(input) {
98
+ const targetPath = path.join(input.sharedCodexHome, "config.toml");
99
+ const sourcePath = path.join(input.legacyCodexHome, "config.toml");
100
+ if (await pathExists(targetPath)) {
101
+ const existingConfig = await readFile(targetPath, "utf8");
102
+ const existingMode = detectCredentialStoreMode(existingConfig);
103
+ input.logger.debug("runtime_init.config_exists", {
104
+ targetPath,
105
+ credentialStoreMode: existingMode,
106
+ });
107
+ if (existingMode === "missing") {
108
+ await writeFile(targetPath, pinFileCredentialStore(existingConfig), "utf8");
109
+ input.logger.info("runtime_init.config_file_mode_pinned", {
110
+ targetPath,
111
+ });
112
+ }
113
+ else if (existingMode !== "file") {
114
+ input.logger.warn("runtime_init.config_mode_unsupported", {
115
+ targetPath,
116
+ credentialStoreMode: existingMode,
117
+ });
118
+ }
119
+ return emptyArtifactResult();
120
+ }
121
+ if (await pathExists(sourcePath) && !samePath(sourcePath, targetPath)) {
122
+ const sourceConfig = await readFile(sourcePath, "utf8");
123
+ const pinnedConfig = pinFileCredentialStore(sourceConfig);
124
+ await writeFile(targetPath, pinnedConfig, "utf8");
125
+ input.logger.info("runtime_init.config_imported", {
126
+ sourcePath,
127
+ targetPath,
128
+ sourceCredentialStoreMode: detectCredentialStoreMode(sourceConfig),
129
+ targetCredentialStoreMode: detectCredentialStoreMode(pinnedConfig),
130
+ });
131
+ return {
132
+ copiedArtifacts: ["config.toml"],
133
+ createdFiles: [targetPath],
134
+ skippedArtifacts: [],
135
+ };
136
+ }
137
+ await writeFile(targetPath, [
138
+ "cli_auth_credentials_store = \"file\"",
139
+ "",
140
+ "# Wrapper-owned shared Codex home for codexes.",
141
+ "# Add MCP and trust configuration here as needed.",
142
+ "",
143
+ ].join("\n"), "utf8");
144
+ input.logger.info("runtime_init.config_created", {
145
+ targetPath,
146
+ });
147
+ return {
148
+ copiedArtifacts: [],
149
+ createdFiles: [targetPath],
150
+ skippedArtifacts: [],
151
+ };
152
+ }
153
+ async function ensureSharedFileCopy(input) {
154
+ const targetPath = path.join(input.sharedCodexHome, input.artifactName);
155
+ const sourcePath = path.join(input.sourceCodexHome, input.artifactName);
156
+ if (await pathExists(targetPath)) {
157
+ input.logger.debug("runtime_init.file_exists", {
158
+ artifactName: input.artifactName,
159
+ targetPath,
160
+ });
161
+ return emptyArtifactResult();
162
+ }
163
+ if (!(await pathExists(sourcePath)) || samePath(sourcePath, targetPath)) {
164
+ input.logger.debug("runtime_init.file_skip", {
165
+ artifactName: input.artifactName,
166
+ sourcePath,
167
+ targetPath,
168
+ reason: "source_missing_or_same_path",
169
+ });
170
+ return {
171
+ copiedArtifacts: [],
172
+ createdFiles: [],
173
+ skippedArtifacts: [
174
+ {
175
+ path: input.artifactName,
176
+ reason: "source_missing_or_same_path",
177
+ },
178
+ ],
179
+ };
180
+ }
181
+ await copyFile(sourcePath, targetPath);
182
+ input.logger.info("runtime_init.file_copied", {
183
+ artifactName: input.artifactName,
184
+ sourcePath,
185
+ targetPath,
186
+ });
187
+ return {
188
+ copiedArtifacts: [input.artifactName],
189
+ createdFiles: [targetPath],
190
+ skippedArtifacts: [],
191
+ };
192
+ }
193
+ async function ensureSharedDirectoryCopy(input) {
194
+ const targetPath = path.join(input.sharedCodexHome, input.artifactName);
195
+ const sourcePath = path.join(input.sourceCodexHome, input.artifactName);
196
+ if (await pathExists(targetPath)) {
197
+ input.logger.debug("runtime_init.directory_artifact_exists", {
198
+ artifactName: input.artifactName,
199
+ targetPath,
200
+ });
201
+ return emptyArtifactResult();
202
+ }
203
+ if (!(await pathExists(sourcePath)) || samePath(sourcePath, targetPath)) {
204
+ input.logger.debug("runtime_init.directory_artifact_skip", {
205
+ artifactName: input.artifactName,
206
+ sourcePath,
207
+ targetPath,
208
+ reason: "source_missing_or_same_path",
209
+ });
210
+ return {
211
+ copiedArtifacts: [],
212
+ createdFiles: [],
213
+ skippedArtifacts: [
214
+ {
215
+ path: input.artifactName,
216
+ reason: "source_missing_or_same_path",
217
+ },
218
+ ],
219
+ };
220
+ }
221
+ await cp(sourcePath, targetPath, { recursive: true });
222
+ input.logger.info("runtime_init.directory_artifact_copied", {
223
+ artifactName: input.artifactName,
224
+ sourcePath,
225
+ targetPath,
226
+ });
227
+ return {
228
+ copiedArtifacts: [input.artifactName],
229
+ createdFiles: [],
230
+ skippedArtifacts: [],
231
+ };
232
+ }
233
+ function detectCredentialStoreMode(rawConfig) {
234
+ const match = rawConfig.match(/^\s*cli_auth_credentials_store\s*=\s*"([^"]+)"/m);
235
+ return match?.[1]?.trim().toLowerCase() ?? "missing";
236
+ }
237
+ function pinFileCredentialStore(rawConfig) {
238
+ if (/^\s*cli_auth_credentials_store\s*=\s*"file"/m.test(rawConfig)) {
239
+ return rawConfig;
240
+ }
241
+ if (/^\s*cli_auth_credentials_store\s*=\s*"[^"]+"/m.test(rawConfig)) {
242
+ return rawConfig.replace(/^\s*cli_auth_credentials_store\s*=\s*"[^"]+"/m, 'cli_auth_credentials_store = "file"');
243
+ }
244
+ const trimmed = rawConfig.trim();
245
+ if (!trimmed) {
246
+ return 'cli_auth_credentials_store = "file"\n';
247
+ }
248
+ return ['cli_auth_credentials_store = "file"', "", trimmed, ""].join("\n");
249
+ }
250
+ function samePath(left, right) {
251
+ return path.resolve(left) === path.resolve(right);
252
+ }
253
+ async function pathExists(targetPath) {
254
+ try {
255
+ await stat(targetPath);
256
+ return true;
257
+ }
258
+ catch (error) {
259
+ if (typeof error === "object" &&
260
+ error !== null &&
261
+ "code" in error &&
262
+ error.code === "ENOENT") {
263
+ return false;
264
+ }
265
+ throw error;
266
+ }
267
+ }
268
+ function emptyArtifactResult() {
269
+ return {
270
+ copiedArtifacts: [],
271
+ createdFiles: [],
272
+ skippedArtifacts: [],
273
+ };
274
+ }
275
+ //# sourceMappingURL=initialize-runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initialize-runtime.js","sourceRoot":"","sources":["../../../src/runtime/init/initialize-runtime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { Logger } from "../../logging/logger.js";
2
+ export interface RuntimeLock {
3
+ release(): Promise<void>;
4
+ }
5
+ export declare function acquireRuntimeLock(input: {
6
+ logger: Logger;
7
+ runtimeRoot: string;
8
+ pollIntervalMs?: number;
9
+ staleLockMs?: number;
10
+ waitTimeoutMs?: number;
11
+ }): Promise<RuntimeLock>;
@@ -0,0 +1,99 @@
1
+ import os from "node:os";
2
+ import path from "node:path";
3
+ import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
4
+ const DEFAULT_WAIT_TIMEOUT_MS = 15_000;
5
+ const DEFAULT_STALE_LOCK_MS = 5 * 60 * 1000;
6
+ const DEFAULT_POLL_INTERVAL_MS = 250;
7
+ export async function acquireRuntimeLock(input) {
8
+ const lockRoot = path.join(input.runtimeRoot, "lock");
9
+ const ownerFile = path.join(lockRoot, "owner.json");
10
+ const waitTimeoutMs = input.waitTimeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
11
+ const staleLockMs = input.staleLockMs ?? DEFAULT_STALE_LOCK_MS;
12
+ const pollIntervalMs = input.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
13
+ const startedAt = Date.now();
14
+ input.logger.info("runtime_lock.acquire.start", {
15
+ lockRoot,
16
+ waitTimeoutMs,
17
+ staleLockMs,
18
+ pollIntervalMs,
19
+ });
20
+ while (true) {
21
+ try {
22
+ await mkdir(lockRoot);
23
+ const owner = {
24
+ pid: process.pid,
25
+ host: os.hostname(),
26
+ createdAt: new Date().toISOString(),
27
+ };
28
+ await writeFile(ownerFile, JSON.stringify(owner, null, 2), "utf8");
29
+ input.logger.info("runtime_lock.acquire.complete", {
30
+ lockRoot,
31
+ waitedMs: Date.now() - startedAt,
32
+ owner,
33
+ });
34
+ return {
35
+ async release() {
36
+ input.logger.info("runtime_lock.release.start", { lockRoot });
37
+ await rm(lockRoot, { force: true, recursive: true }).catch(() => undefined);
38
+ input.logger.info("runtime_lock.release.complete", { lockRoot });
39
+ },
40
+ };
41
+ }
42
+ catch (error) {
43
+ if (!isAlreadyExistsError(error)) {
44
+ input.logger.error("runtime_lock.acquire.failed", {
45
+ lockRoot,
46
+ message: error instanceof Error ? error.message : String(error),
47
+ });
48
+ throw error;
49
+ }
50
+ }
51
+ const lockAgeMs = await readLockAgeMs(lockRoot, ownerFile);
52
+ if (lockAgeMs !== null && lockAgeMs > staleLockMs) {
53
+ input.logger.warn("runtime_lock.stale_detected", {
54
+ lockRoot,
55
+ lockAgeMs,
56
+ });
57
+ await rm(lockRoot, { force: true, recursive: true }).catch(() => undefined);
58
+ continue;
59
+ }
60
+ const waitedMs = Date.now() - startedAt;
61
+ input.logger.debug("runtime_lock.acquire.waiting", {
62
+ lockRoot,
63
+ waitedMs,
64
+ lockAgeMs,
65
+ });
66
+ if (waitedMs >= waitTimeoutMs) {
67
+ input.logger.error("runtime_lock.acquire.timeout", {
68
+ lockRoot,
69
+ waitedMs,
70
+ lockAgeMs,
71
+ });
72
+ throw new Error(`Timed out waiting for the shared runtime lock after ${waitTimeoutMs}ms.`);
73
+ }
74
+ await sleep(pollIntervalMs);
75
+ }
76
+ }
77
+ async function readLockAgeMs(lockRoot, ownerFile) {
78
+ const ownerContents = await readFile(ownerFile, "utf8").catch(() => null);
79
+ if (ownerContents) {
80
+ const parsed = JSON.parse(ownerContents);
81
+ if (typeof parsed.createdAt === "string") {
82
+ return Date.now() - new Date(parsed.createdAt).getTime();
83
+ }
84
+ }
85
+ const lockStats = await stat(lockRoot).catch(() => null);
86
+ return lockStats ? Date.now() - lockStats.mtimeMs : null;
87
+ }
88
+ function isAlreadyExistsError(error) {
89
+ return (typeof error === "object" &&
90
+ error !== null &&
91
+ "code" in error &&
92
+ error.code === "EEXIST");
93
+ }
94
+ function sleep(durationMs) {
95
+ return new Promise((resolve) => {
96
+ setTimeout(resolve, durationMs);
97
+ });
98
+ }
99
+ //# sourceMappingURL=runtime-lock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-lock.js","sourceRoot":"","sources":["../../../src/runtime/lock/runtime-lock.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import type { Logger } from "../logging/logger.js";
2
+ import type { RuntimeContract } from "./runtime-contract.js";
3
+ export interface LoginWorkspace {
4
+ workspaceRoot: string;
5
+ codexHome: string;
6
+ }
7
+ export declare function prepareLoginWorkspace(input: {
8
+ logger: Logger;
9
+ runtimeRoot: string;
10
+ sharedCodexHome: string;
11
+ }): Promise<LoginWorkspace>;
12
+ export declare function copyAccountScopedAuthArtifacts(input: {
13
+ accountId: string;
14
+ destinationRoot: string;
15
+ logger: Logger;
16
+ runtimeContract: RuntimeContract;
17
+ sourceCodexHome: string;
18
+ }): Promise<void>;
@@ -0,0 +1,171 @@
1
+ import { copyFile, cp, mkdir, mkdtemp, readFile, stat, writeFile } from "node:fs/promises";
2
+ import path from "node:path";
3
+ export async function prepareLoginWorkspace(input) {
4
+ const workspaceParent = path.join(input.runtimeRoot, "tmp");
5
+ await mkdir(workspaceParent, { recursive: true });
6
+ const workspaceRoot = await mkdtemp(path.join(workspaceParent, "account-add-"));
7
+ const codexHome = path.join(workspaceRoot, "codex-home");
8
+ await mkdir(codexHome, { recursive: true });
9
+ input.logger.info("login_workspace.created", {
10
+ workspaceRoot,
11
+ codexHome,
12
+ sharedCodexHome: input.sharedCodexHome,
13
+ });
14
+ await ensurePinnedFileConfig({
15
+ codexHome,
16
+ logger: input.logger,
17
+ sharedCodexHome: input.sharedCodexHome,
18
+ });
19
+ await copySharedArtifactIfPresent({
20
+ artifactName: "mcp.json",
21
+ codexHome,
22
+ logger: input.logger,
23
+ sharedCodexHome: input.sharedCodexHome,
24
+ });
25
+ await copySharedDirectoryIfPresent({
26
+ artifactName: "trust",
27
+ codexHome,
28
+ logger: input.logger,
29
+ sharedCodexHome: input.sharedCodexHome,
30
+ });
31
+ await mkdir(path.join(codexHome, "sessions"), { recursive: true });
32
+ return { workspaceRoot, codexHome };
33
+ }
34
+ export async function copyAccountScopedAuthArtifacts(input) {
35
+ const accountRules = input.runtimeContract.fileRules.filter((rule) => rule.classification === "account");
36
+ input.logger.info("login_workspace.copy_account_artifacts.start", {
37
+ accountId: input.accountId,
38
+ destinationRoot: input.destinationRoot,
39
+ sourceCodexHome: input.sourceCodexHome,
40
+ allowedPatterns: accountRules.map((rule) => rule.pathPattern),
41
+ });
42
+ await mkdir(input.destinationRoot, { recursive: true });
43
+ for (const rule of accountRules) {
44
+ await copyRuleArtifacts({
45
+ destinationRoot: input.destinationRoot,
46
+ logger: input.logger,
47
+ rule,
48
+ sourceCodexHome: input.sourceCodexHome,
49
+ });
50
+ }
51
+ input.logger.info("login_workspace.copy_account_artifacts.complete", {
52
+ accountId: input.accountId,
53
+ destinationRoot: input.destinationRoot,
54
+ });
55
+ }
56
+ async function ensurePinnedFileConfig(input) {
57
+ const sourceConfigPath = path.join(input.sharedCodexHome, "config.toml");
58
+ const targetConfigPath = path.join(input.codexHome, "config.toml");
59
+ const configContents = await readFile(sourceConfigPath, "utf8").catch(() => "");
60
+ const pinnedConfig = pinFileCredentialStore(configContents);
61
+ await writeFile(targetConfigPath, pinnedConfig, "utf8");
62
+ input.logger.info("login_workspace.config_prepared", {
63
+ sourceConfigPath,
64
+ targetConfigPath,
65
+ credentialStoreMode: "file",
66
+ });
67
+ }
68
+ async function copySharedArtifactIfPresent(input) {
69
+ const sourcePath = path.join(input.sharedCodexHome, input.artifactName);
70
+ const targetPath = path.join(input.codexHome, input.artifactName);
71
+ if (!(await pathExists(sourcePath))) {
72
+ input.logger.debug("login_workspace.shared_file_skipped", {
73
+ artifactName: input.artifactName,
74
+ sourcePath,
75
+ reason: "missing",
76
+ });
77
+ return;
78
+ }
79
+ await copyFile(sourcePath, targetPath);
80
+ input.logger.debug("login_workspace.shared_file_copied", {
81
+ artifactName: input.artifactName,
82
+ sourcePath,
83
+ targetPath,
84
+ });
85
+ }
86
+ async function copySharedDirectoryIfPresent(input) {
87
+ const sourcePath = path.join(input.sharedCodexHome, input.artifactName);
88
+ const targetPath = path.join(input.codexHome, input.artifactName);
89
+ if (!(await pathExists(sourcePath))) {
90
+ input.logger.debug("login_workspace.shared_directory_skipped", {
91
+ artifactName: input.artifactName,
92
+ sourcePath,
93
+ reason: "missing",
94
+ });
95
+ return;
96
+ }
97
+ await cp(sourcePath, targetPath, { recursive: true });
98
+ input.logger.debug("login_workspace.shared_directory_copied", {
99
+ artifactName: input.artifactName,
100
+ sourcePath,
101
+ targetPath,
102
+ });
103
+ }
104
+ async function copyRuleArtifacts(input) {
105
+ if (input.rule.pathPattern.endsWith("/**")) {
106
+ const relativeDirectory = input.rule.pathPattern.slice(0, -3);
107
+ const sourceDirectory = path.join(input.sourceCodexHome, relativeDirectory);
108
+ const targetDirectory = path.join(input.destinationRoot, relativeDirectory);
109
+ if (!(await pathExists(sourceDirectory))) {
110
+ input.logger.debug("login_workspace.account_directory_skipped", {
111
+ pathPattern: input.rule.pathPattern,
112
+ sourceDirectory,
113
+ reason: "missing",
114
+ });
115
+ return;
116
+ }
117
+ await cp(sourceDirectory, targetDirectory, { recursive: true });
118
+ input.logger.debug("login_workspace.account_directory_copied", {
119
+ pathPattern: input.rule.pathPattern,
120
+ sourceDirectory,
121
+ targetDirectory,
122
+ });
123
+ return;
124
+ }
125
+ const sourceFile = path.join(input.sourceCodexHome, input.rule.pathPattern);
126
+ const targetFile = path.join(input.destinationRoot, input.rule.pathPattern);
127
+ if (!(await pathExists(sourceFile))) {
128
+ input.logger.debug("login_workspace.account_file_skipped", {
129
+ pathPattern: input.rule.pathPattern,
130
+ sourceFile,
131
+ reason: "missing",
132
+ });
133
+ return;
134
+ }
135
+ await mkdir(path.dirname(targetFile), { recursive: true });
136
+ await copyFile(sourceFile, targetFile);
137
+ input.logger.debug("login_workspace.account_file_copied", {
138
+ pathPattern: input.rule.pathPattern,
139
+ sourceFile,
140
+ targetFile,
141
+ });
142
+ }
143
+ function pinFileCredentialStore(rawConfig) {
144
+ if (/^\s*cli_auth_credentials_store\s*=\s*"file"/m.test(rawConfig)) {
145
+ return rawConfig;
146
+ }
147
+ if (/^\s*cli_auth_credentials_store\s*=\s*"[^"]+"/m.test(rawConfig)) {
148
+ return rawConfig.replace(/^\s*cli_auth_credentials_store\s*=\s*"[^"]+"/m, 'cli_auth_credentials_store = "file"');
149
+ }
150
+ const trimmed = rawConfig.trim();
151
+ if (!trimmed) {
152
+ return 'cli_auth_credentials_store = "file"\n';
153
+ }
154
+ return ['cli_auth_credentials_store = "file"', "", trimmed, ""].join("\n");
155
+ }
156
+ async function pathExists(targetPath) {
157
+ try {
158
+ await stat(targetPath);
159
+ return true;
160
+ }
161
+ catch (error) {
162
+ if (typeof error === "object" &&
163
+ error !== null &&
164
+ "code" in error &&
165
+ error.code === "ENOENT") {
166
+ return false;
167
+ }
168
+ throw error;
169
+ }
170
+ }
171
+ //# sourceMappingURL=login-workspace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"login-workspace.js","sourceRoot":"","sources":["../../src/runtime/login-workspace.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import type { CredentialStoreMode } from "../config/wrapper-config.js";
2
+ import type { Logger } from "../logging/logger.js";
3
+ export type RuntimeFileClass = "shared" | "account" | "ephemeral" | "protected";
4
+ export interface RuntimeFileRule {
5
+ pathPattern: string;
6
+ classification: RuntimeFileClass;
7
+ syncBack: "never" | "if-changed" | "account-to-runtime-only";
8
+ reason: string;
9
+ }
10
+ export interface RuntimeContract {
11
+ credentialStoreMode: CredentialStoreMode;
12
+ sharedCodexHome: string;
13
+ runtimeRoot: string;
14
+ perAccountRoot: string;
15
+ supported: boolean;
16
+ fileRules: RuntimeFileRule[];
17
+ syncBackStrategy: {
18
+ whenChildProcessSucceeds: string;
19
+ whenChildProcessFails: string;
20
+ compareStrategy: string;
21
+ };
22
+ }
23
+ export declare function createRuntimeContract(input: {
24
+ accountRoot: string;
25
+ credentialStoreMode: CredentialStoreMode;
26
+ logger: Logger;
27
+ runtimeRoot: string;
28
+ sharedCodexHome: string;
29
+ }): RuntimeContract;
30
+ export declare function resolveAccountRuntimePaths(contract: RuntimeContract, accountId: string): {
31
+ accountDirectory: string;
32
+ accountStateDirectory: string;
33
+ accountMetadataFile: string;
34
+ runtimeBackupDirectory: string;
35
+ runtimeTempDirectory: string;
36
+ };
37
+ export declare function summarizeRuntimeContract(contract: RuntimeContract): {
38
+ supported: boolean;
39
+ credentialStoreMode: CredentialStoreMode;
40
+ sharedCodexHome: string;
41
+ runtimeRoot: string;
42
+ perAccountRoot: string;
43
+ classifications: Record<RuntimeFileClass, number>;
44
+ };