@pixelbyte-software/pixcode 1.35.2 → 1.35.3

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 (173) hide show
  1. package/LICENSE +718 -718
  2. package/README.de.md +248 -248
  3. package/README.ja.md +240 -240
  4. package/README.ko.md +240 -240
  5. package/README.md +303 -303
  6. package/README.ru.md +248 -248
  7. package/README.tr.md +250 -250
  8. package/README.zh-CN.md +240 -240
  9. package/dist/api-docs.html +548 -548
  10. package/dist/assets/{index-D1-AIL_5.js → index-D8z78r_D.js} +57 -57
  11. package/dist/assets/{index-B8w57E1r.css → index-DmchzORZ.css} +1 -1
  12. package/dist/clear-cache.html +85 -85
  13. package/dist/convert-icons.md +52 -52
  14. package/dist/favicon.svg +8 -8
  15. package/dist/generate-icons.js +48 -48
  16. package/dist/icons/codex-white.svg +3 -3
  17. package/dist/icons/codex.svg +3 -3
  18. package/dist/icons/cursor-white.svg +11 -11
  19. package/dist/icons/icon-128x128.svg +9 -9
  20. package/dist/icons/icon-144x144.svg +9 -9
  21. package/dist/icons/icon-152x152.svg +9 -9
  22. package/dist/icons/icon-192x192.svg +9 -9
  23. package/dist/icons/icon-384x384.svg +9 -9
  24. package/dist/icons/icon-512x512.svg +9 -9
  25. package/dist/icons/icon-72x72.svg +9 -9
  26. package/dist/icons/icon-96x96.svg +9 -9
  27. package/dist/icons/icon-template.svg +9 -9
  28. package/dist/icons/qwen-logo.svg +14 -14
  29. package/dist/index.html +59 -59
  30. package/dist/logo.svg +12 -12
  31. package/dist/manifest.json +60 -60
  32. package/dist/openapi.yaml +1693 -1693
  33. package/dist/sw.js +124 -124
  34. package/dist-server/server/cli.js +96 -96
  35. package/dist-server/server/daemon/manager.js +33 -33
  36. package/dist-server/server/daemon-manager.js +64 -64
  37. package/dist-server/server/routes/commands.js +25 -25
  38. package/dist-server/server/routes/git.js +17 -17
  39. package/dist-server/server/routes/taskmaster.js +419 -419
  40. package/package.json +180 -180
  41. package/scripts/fix-node-pty.js +67 -67
  42. package/scripts/smoke/a2a-roundtrip.mjs +167 -167
  43. package/scripts/smoke/orchestration-api.mjs +172 -172
  44. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  45. package/server/claude-sdk.js +898 -898
  46. package/server/cli.js +935 -935
  47. package/server/constants/config.js +4 -4
  48. package/server/cursor-cli.js +342 -342
  49. package/server/daemon/manager.js +564 -564
  50. package/server/daemon-manager.js +959 -959
  51. package/server/database/db.js +794 -794
  52. package/server/database/json-store.js +197 -197
  53. package/server/gemini-cli.js +535 -535
  54. package/server/gemini-response-handler.js +79 -79
  55. package/server/index.js +3135 -3135
  56. package/server/load-env.js +34 -34
  57. package/server/middleware/auth.js +173 -173
  58. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  59. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +55 -55
  60. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +284 -284
  61. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  62. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  63. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  64. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  65. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  66. package/server/modules/orchestration/a2a/routes.ts +577 -577
  67. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  68. package/server/modules/orchestration/a2a/types.ts +125 -125
  69. package/server/modules/orchestration/a2a/validator.ts +113 -113
  70. package/server/modules/orchestration/index.ts +66 -66
  71. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  72. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  73. package/server/modules/orchestration/preview/types.ts +19 -19
  74. package/server/modules/orchestration/tasks/orchestration-task-store.ts +45 -45
  75. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +73 -73
  76. package/server/modules/orchestration/tasks/orchestration-task.service.ts +145 -145
  77. package/server/modules/orchestration/tasks/orchestration-task.types.ts +29 -29
  78. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  79. package/server/modules/orchestration/workflows/workflow-runner.ts +1206 -1206
  80. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  81. package/server/modules/orchestration/workflows/workflow.routes.ts +169 -169
  82. package/server/modules/orchestration/workflows/workflow.types.ts +70 -70
  83. package/server/modules/orchestration/workflows/workspace-target.ts +120 -120
  84. package/server/modules/orchestration/workspace/docker-workspace.ts +135 -135
  85. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  86. package/server/modules/orchestration/workspace/types.ts +52 -52
  87. package/server/modules/orchestration/workspace/workspace-manager.ts +97 -97
  88. package/server/modules/orchestration/workspace/worktree-workspace.ts +125 -125
  89. package/server/modules/providers/index.ts +2 -2
  90. package/server/modules/providers/list/claude/claude-auth.provider.ts +145 -145
  91. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  92. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  93. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  94. package/server/modules/providers/list/codex/codex-auth.provider.ts +115 -115
  95. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  96. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  97. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  98. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +143 -143
  99. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  100. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  101. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  102. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +163 -163
  103. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  104. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  105. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  106. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +130 -130
  107. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  108. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +232 -232
  109. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  110. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +145 -145
  111. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  112. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  113. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  114. package/server/modules/providers/provider.registry.ts +40 -40
  115. package/server/modules/providers/provider.routes.ts +819 -819
  116. package/server/modules/providers/services/mcp.service.ts +86 -86
  117. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  118. package/server/modules/providers/services/sessions.service.ts +45 -45
  119. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  120. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  121. package/server/modules/providers/shared/provider-configs.ts +142 -142
  122. package/server/modules/providers/tests/mcp.test.ts +293 -293
  123. package/server/openai-codex.js +462 -462
  124. package/server/opencode-cli.js +459 -459
  125. package/server/opencode-response-handler.js +107 -107
  126. package/server/projects.js +3105 -3105
  127. package/server/qwen-code-cli.js +395 -395
  128. package/server/qwen-response-handler.js +73 -73
  129. package/server/routes/agent.js +1365 -1365
  130. package/server/routes/auth.js +138 -138
  131. package/server/routes/codex.js +19 -19
  132. package/server/routes/commands.js +554 -554
  133. package/server/routes/cursor.js +52 -52
  134. package/server/routes/gemini.js +24 -24
  135. package/server/routes/git.js +1488 -1488
  136. package/server/routes/mcp-utils.js +31 -31
  137. package/server/routes/messages.js +61 -61
  138. package/server/routes/network.js +120 -120
  139. package/server/routes/plugins.js +318 -318
  140. package/server/routes/projects.js +915 -915
  141. package/server/routes/qwen.js +27 -27
  142. package/server/routes/settings.js +286 -286
  143. package/server/routes/taskmaster.js +1496 -1496
  144. package/server/routes/telegram.js +125 -125
  145. package/server/routes/user.js +123 -123
  146. package/server/services/external-access.js +171 -171
  147. package/server/services/install-jobs.js +571 -571
  148. package/server/services/notification-orchestrator.js +242 -242
  149. package/server/services/provider-credentials.js +189 -189
  150. package/server/services/provider-models.js +381 -381
  151. package/server/services/telegram/bot.js +279 -279
  152. package/server/services/telegram/telegram-http-client.js +130 -130
  153. package/server/services/telegram/translations.js +170 -170
  154. package/server/services/vapid-keys.js +36 -36
  155. package/server/sessionManager.js +225 -225
  156. package/server/shared/interfaces.ts +54 -54
  157. package/server/shared/types.ts +172 -172
  158. package/server/shared/utils.ts +193 -193
  159. package/server/tsconfig.json +36 -36
  160. package/server/utils/colors.js +21 -21
  161. package/server/utils/commandParser.js +303 -303
  162. package/server/utils/frontmatter.js +18 -18
  163. package/server/utils/gitConfig.js +34 -34
  164. package/server/utils/mcp-detector.js +147 -147
  165. package/server/utils/plugin-loader.js +457 -457
  166. package/server/utils/plugin-process-manager.js +184 -184
  167. package/server/utils/port-access.js +209 -209
  168. package/server/utils/runtime-paths.js +37 -37
  169. package/server/utils/taskmaster-websocket.js +128 -128
  170. package/server/utils/url-detection.js +71 -71
  171. package/server/vite-daemon.js +78 -78
  172. package/shared/modelConstants.js +162 -162
  173. package/shared/networkHosts.js +22 -22
@@ -1,189 +1,189 @@
1
- import { promises as fs } from 'node:fs';
2
- import os from 'node:os';
3
- import path from 'node:path';
4
-
5
- /**
6
- * Central credentials store for CLI providers.
7
- *
8
- * File: `~/.pixcode/provider-credentials.json`. Lets the UI save an API key
9
- * (and optional base URL for OpenAI-compatible providers) once and have it
10
- * picked up by:
11
- * - the spawn adapters (claude-sdk.js, cursor-cli.js, openai-codex.js,
12
- * gemini-cli.js, qwen-code-cli.js) when they launch the CLI subprocess
13
- * - the provider-auth modules as an additional "authenticated" signal
14
- *
15
- * Keeping credentials in one file instead of per-CLI config files means we
16
- * don't have to learn each CLI's settings schema just to set an API key,
17
- * and users see one "Logout" button that actually clears everything.
18
- */
19
-
20
- const CONFIG_FILE = path.join(os.homedir(), '.pixcode', 'provider-credentials.json');
21
-
22
- /**
23
- * Map provider id → {apiKeyEnv, baseUrlEnv, extraEnv?} so we know which env
24
- * vars to inject into the spawn env. Cursor is OAuth-only; it has no api-key
25
- * entry.
26
- *
27
- * `baseUrlEnv` lets users point a provider at any OpenAI-compatible (or
28
- * Gemini-compatible) endpoint they want — third-party gateways, self-hosted
29
- * proxies, OpenRouter, Together, etc. — without forking the CLI. The CLI
30
- * picks the env var up natively because every supported CLI honours its
31
- * vendor's standard variable names. **Don't rename these.** Pixcode is just
32
- * a passthrough; people expect the same names that work outside Pixcode.
33
- *
34
- * `extraEnv` is a list of additional env-var names that should be mirrored
35
- * across with the same value as `baseUrlEnv` — handy when a provider has
36
- * historical aliases (e.g. Gemini's `GOOGLE_GEMINI_BASE_URL` vs newer
37
- * `GEMINI_BASE_URL` clients).
38
- */
39
- export const PROVIDER_ENV_VARS = Object.freeze({
40
- claude: { apiKeyEnv: 'ANTHROPIC_API_KEY', baseUrlEnv: 'ANTHROPIC_BASE_URL' },
41
- codex: { apiKeyEnv: 'OPENAI_API_KEY', baseUrlEnv: 'OPENAI_BASE_URL' },
42
- gemini: {
43
- apiKeyEnv: 'GEMINI_API_KEY',
44
- baseUrlEnv: 'GOOGLE_GEMINI_BASE_URL',
45
- // Some Gemini-API-compatible gateways pick up the shorter
46
- // `GEMINI_BASE_URL` name; mirror so either client works.
47
- extraBaseUrlEnv: ['GEMINI_BASE_URL'],
48
- },
49
- qwen: { apiKeyEnv: 'OPENAI_API_KEY', baseUrlEnv: 'OPENAI_BASE_URL' },
50
- // OpenCode is multi-provider. Default-set ANTHROPIC_*, but ALSO mirror
51
- // the same key into OPENAI_API_KEY when the user picks an OpenAI-flavour
52
- // model — handled at spawn time in opencode-cli.js, not here.
53
- opencode: { apiKeyEnv: 'ANTHROPIC_API_KEY', baseUrlEnv: 'ANTHROPIC_BASE_URL' },
54
- });
55
-
56
- async function readStore() {
57
- try {
58
- const raw = await fs.readFile(CONFIG_FILE, 'utf8');
59
- const parsed = JSON.parse(raw);
60
- return parsed && typeof parsed === 'object' ? parsed : {};
61
- } catch {
62
- return {};
63
- }
64
- }
65
-
66
- async function writeStore(next) {
67
- await fs.mkdir(path.dirname(CONFIG_FILE), { recursive: true });
68
- await fs.writeFile(CONFIG_FILE, JSON.stringify(next, null, 2), { mode: 0o600 });
69
- }
70
-
71
- /**
72
- * Returns `{ apiKey, baseUrl }` for the given provider, or `null` if no key
73
- * is stored. Safe to call on any provider id — unknown ids yield null.
74
- */
75
- export async function getProviderCredentials(provider) {
76
- const store = await readStore();
77
- const entry = store[provider];
78
- if (!entry || typeof entry !== 'object') return null;
79
- const apiKey = typeof entry.apiKey === 'string' && entry.apiKey.trim() ? entry.apiKey.trim() : null;
80
- if (!apiKey) return null;
81
- const baseUrl = typeof entry.baseUrl === 'string' && entry.baseUrl.trim() ? entry.baseUrl.trim() : null;
82
- return { apiKey, baseUrl };
83
- }
84
-
85
- /** Persist credentials; empty string apiKey deletes the entry. */
86
- export async function setProviderCredentials(provider, { apiKey, baseUrl }) {
87
- const store = await readStore();
88
- const trimmedKey = typeof apiKey === 'string' ? apiKey.trim() : '';
89
- if (!trimmedKey) {
90
- delete store[provider];
91
- } else {
92
- store[provider] = {
93
- apiKey: trimmedKey,
94
- baseUrl: typeof baseUrl === 'string' && baseUrl.trim() ? baseUrl.trim() : null,
95
- updatedAt: new Date().toISOString(),
96
- };
97
- }
98
- await writeStore(store);
99
- }
100
-
101
- export async function clearProviderCredentials(provider) {
102
- await setProviderCredentials(provider, { apiKey: '', baseUrl: null });
103
- }
104
-
105
- /**
106
- * Builds an env object that inherits from the server process env and
107
- * overlays stored credentials for the given provider. Use when spawning
108
- * a CLI subprocess so the user's Pixcode-configured key is available
109
- * without leaking unrelated provider keys into the child.
110
- */
111
- export async function buildSpawnEnv(provider, baseEnv = process.env) {
112
- const envVars = PROVIDER_ENV_VARS[provider];
113
- const env = { ...baseEnv };
114
- if (!envVars) return env;
115
-
116
- const creds = await getProviderCredentials(provider);
117
- if (!creds) return env;
118
-
119
- if (envVars.apiKeyEnv) env[envVars.apiKeyEnv] = creds.apiKey;
120
- if (envVars.baseUrlEnv && creds.baseUrl) {
121
- env[envVars.baseUrlEnv] = creds.baseUrl;
122
- // Mirror to alias env-var names so clients that read either work.
123
- for (const alias of envVars.extraBaseUrlEnv || []) {
124
- env[alias] = creds.baseUrl;
125
- }
126
- }
127
- return env;
128
- }
129
-
130
- /**
131
- * Apply stored credentials onto `process.env` for every known provider.
132
- * Called on server boot so SDK-based integrations (Claude, Codex) see the
133
- * API keys without reading our credentials file directly. Subprocess spawns
134
- * go through `buildSpawnEnv` which layers on top of this.
135
- */
136
- export async function applyAllStoredCredentialsToEnv() {
137
- const store = await readStore();
138
- for (const [provider, envVars] of Object.entries(PROVIDER_ENV_VARS)) {
139
- const entry = store[provider];
140
- if (!entry || typeof entry !== 'object') continue;
141
- const apiKey = typeof entry.apiKey === 'string' ? entry.apiKey.trim() : '';
142
- const baseUrl = typeof entry.baseUrl === 'string' ? entry.baseUrl.trim() : '';
143
- if (envVars.apiKeyEnv && apiKey) process.env[envVars.apiKeyEnv] = apiKey;
144
- if (envVars.baseUrlEnv && baseUrl) {
145
- process.env[envVars.baseUrlEnv] = baseUrl;
146
- for (const alias of envVars.extraBaseUrlEnv || []) {
147
- process.env[alias] = baseUrl;
148
- }
149
- }
150
- }
151
- }
152
-
153
- /**
154
- * Sync a single provider's credentials into `process.env` (or clear them
155
- * when no key is set). Call after mutating the store via the API so the
156
- * effect is immediate instead of needing a restart.
157
- */
158
- export async function applyProviderCredentialsToEnv(provider) {
159
- const envVars = PROVIDER_ENV_VARS[provider];
160
- if (!envVars) return;
161
- const creds = await getProviderCredentials(provider);
162
- if (envVars.apiKeyEnv) {
163
- if (creds?.apiKey) process.env[envVars.apiKeyEnv] = creds.apiKey;
164
- else delete process.env[envVars.apiKeyEnv];
165
- }
166
- if (envVars.baseUrlEnv) {
167
- if (creds?.baseUrl) process.env[envVars.baseUrlEnv] = creds.baseUrl;
168
- else delete process.env[envVars.baseUrlEnv];
169
- for (const alias of envVars.extraBaseUrlEnv || []) {
170
- if (creds?.baseUrl) process.env[alias] = creds.baseUrl;
171
- else delete process.env[alias];
172
- }
173
- }
174
- }
175
-
176
- /** Listing + logout helpers for the UI. */
177
- export async function listProviderCredentialSummaries() {
178
- const store = await readStore();
179
- const out = {};
180
- for (const key of Object.keys(PROVIDER_ENV_VARS)) {
181
- const entry = store[key];
182
- out[key] = {
183
- hasKey: Boolean(entry && typeof entry.apiKey === 'string' && entry.apiKey.trim()),
184
- baseUrl: entry && typeof entry.baseUrl === 'string' && entry.baseUrl.trim() ? entry.baseUrl.trim() : null,
185
- updatedAt: entry && typeof entry.updatedAt === 'string' ? entry.updatedAt : null,
186
- };
187
- }
188
- return out;
189
- }
1
+ import { promises as fs } from 'node:fs';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+
5
+ /**
6
+ * Central credentials store for CLI providers.
7
+ *
8
+ * File: `~/.pixcode/provider-credentials.json`. Lets the UI save an API key
9
+ * (and optional base URL for OpenAI-compatible providers) once and have it
10
+ * picked up by:
11
+ * - the spawn adapters (claude-sdk.js, cursor-cli.js, openai-codex.js,
12
+ * gemini-cli.js, qwen-code-cli.js) when they launch the CLI subprocess
13
+ * - the provider-auth modules as an additional "authenticated" signal
14
+ *
15
+ * Keeping credentials in one file instead of per-CLI config files means we
16
+ * don't have to learn each CLI's settings schema just to set an API key,
17
+ * and users see one "Logout" button that actually clears everything.
18
+ */
19
+
20
+ const CONFIG_FILE = path.join(os.homedir(), '.pixcode', 'provider-credentials.json');
21
+
22
+ /**
23
+ * Map provider id → {apiKeyEnv, baseUrlEnv, extraEnv?} so we know which env
24
+ * vars to inject into the spawn env. Cursor is OAuth-only; it has no api-key
25
+ * entry.
26
+ *
27
+ * `baseUrlEnv` lets users point a provider at any OpenAI-compatible (or
28
+ * Gemini-compatible) endpoint they want — third-party gateways, self-hosted
29
+ * proxies, OpenRouter, Together, etc. — without forking the CLI. The CLI
30
+ * picks the env var up natively because every supported CLI honours its
31
+ * vendor's standard variable names. **Don't rename these.** Pixcode is just
32
+ * a passthrough; people expect the same names that work outside Pixcode.
33
+ *
34
+ * `extraEnv` is a list of additional env-var names that should be mirrored
35
+ * across with the same value as `baseUrlEnv` — handy when a provider has
36
+ * historical aliases (e.g. Gemini's `GOOGLE_GEMINI_BASE_URL` vs newer
37
+ * `GEMINI_BASE_URL` clients).
38
+ */
39
+ export const PROVIDER_ENV_VARS = Object.freeze({
40
+ claude: { apiKeyEnv: 'ANTHROPIC_API_KEY', baseUrlEnv: 'ANTHROPIC_BASE_URL' },
41
+ codex: { apiKeyEnv: 'OPENAI_API_KEY', baseUrlEnv: 'OPENAI_BASE_URL' },
42
+ gemini: {
43
+ apiKeyEnv: 'GEMINI_API_KEY',
44
+ baseUrlEnv: 'GOOGLE_GEMINI_BASE_URL',
45
+ // Some Gemini-API-compatible gateways pick up the shorter
46
+ // `GEMINI_BASE_URL` name; mirror so either client works.
47
+ extraBaseUrlEnv: ['GEMINI_BASE_URL'],
48
+ },
49
+ qwen: { apiKeyEnv: 'OPENAI_API_KEY', baseUrlEnv: 'OPENAI_BASE_URL' },
50
+ // OpenCode is multi-provider. Default-set ANTHROPIC_*, but ALSO mirror
51
+ // the same key into OPENAI_API_KEY when the user picks an OpenAI-flavour
52
+ // model — handled at spawn time in opencode-cli.js, not here.
53
+ opencode: { apiKeyEnv: 'ANTHROPIC_API_KEY', baseUrlEnv: 'ANTHROPIC_BASE_URL' },
54
+ });
55
+
56
+ async function readStore() {
57
+ try {
58
+ const raw = await fs.readFile(CONFIG_FILE, 'utf8');
59
+ const parsed = JSON.parse(raw);
60
+ return parsed && typeof parsed === 'object' ? parsed : {};
61
+ } catch {
62
+ return {};
63
+ }
64
+ }
65
+
66
+ async function writeStore(next) {
67
+ await fs.mkdir(path.dirname(CONFIG_FILE), { recursive: true });
68
+ await fs.writeFile(CONFIG_FILE, JSON.stringify(next, null, 2), { mode: 0o600 });
69
+ }
70
+
71
+ /**
72
+ * Returns `{ apiKey, baseUrl }` for the given provider, or `null` if no key
73
+ * is stored. Safe to call on any provider id — unknown ids yield null.
74
+ */
75
+ export async function getProviderCredentials(provider) {
76
+ const store = await readStore();
77
+ const entry = store[provider];
78
+ if (!entry || typeof entry !== 'object') return null;
79
+ const apiKey = typeof entry.apiKey === 'string' && entry.apiKey.trim() ? entry.apiKey.trim() : null;
80
+ if (!apiKey) return null;
81
+ const baseUrl = typeof entry.baseUrl === 'string' && entry.baseUrl.trim() ? entry.baseUrl.trim() : null;
82
+ return { apiKey, baseUrl };
83
+ }
84
+
85
+ /** Persist credentials; empty string apiKey deletes the entry. */
86
+ export async function setProviderCredentials(provider, { apiKey, baseUrl }) {
87
+ const store = await readStore();
88
+ const trimmedKey = typeof apiKey === 'string' ? apiKey.trim() : '';
89
+ if (!trimmedKey) {
90
+ delete store[provider];
91
+ } else {
92
+ store[provider] = {
93
+ apiKey: trimmedKey,
94
+ baseUrl: typeof baseUrl === 'string' && baseUrl.trim() ? baseUrl.trim() : null,
95
+ updatedAt: new Date().toISOString(),
96
+ };
97
+ }
98
+ await writeStore(store);
99
+ }
100
+
101
+ export async function clearProviderCredentials(provider) {
102
+ await setProviderCredentials(provider, { apiKey: '', baseUrl: null });
103
+ }
104
+
105
+ /**
106
+ * Builds an env object that inherits from the server process env and
107
+ * overlays stored credentials for the given provider. Use when spawning
108
+ * a CLI subprocess so the user's Pixcode-configured key is available
109
+ * without leaking unrelated provider keys into the child.
110
+ */
111
+ export async function buildSpawnEnv(provider, baseEnv = process.env) {
112
+ const envVars = PROVIDER_ENV_VARS[provider];
113
+ const env = { ...baseEnv };
114
+ if (!envVars) return env;
115
+
116
+ const creds = await getProviderCredentials(provider);
117
+ if (!creds) return env;
118
+
119
+ if (envVars.apiKeyEnv) env[envVars.apiKeyEnv] = creds.apiKey;
120
+ if (envVars.baseUrlEnv && creds.baseUrl) {
121
+ env[envVars.baseUrlEnv] = creds.baseUrl;
122
+ // Mirror to alias env-var names so clients that read either work.
123
+ for (const alias of envVars.extraBaseUrlEnv || []) {
124
+ env[alias] = creds.baseUrl;
125
+ }
126
+ }
127
+ return env;
128
+ }
129
+
130
+ /**
131
+ * Apply stored credentials onto `process.env` for every known provider.
132
+ * Called on server boot so SDK-based integrations (Claude, Codex) see the
133
+ * API keys without reading our credentials file directly. Subprocess spawns
134
+ * go through `buildSpawnEnv` which layers on top of this.
135
+ */
136
+ export async function applyAllStoredCredentialsToEnv() {
137
+ const store = await readStore();
138
+ for (const [provider, envVars] of Object.entries(PROVIDER_ENV_VARS)) {
139
+ const entry = store[provider];
140
+ if (!entry || typeof entry !== 'object') continue;
141
+ const apiKey = typeof entry.apiKey === 'string' ? entry.apiKey.trim() : '';
142
+ const baseUrl = typeof entry.baseUrl === 'string' ? entry.baseUrl.trim() : '';
143
+ if (envVars.apiKeyEnv && apiKey) process.env[envVars.apiKeyEnv] = apiKey;
144
+ if (envVars.baseUrlEnv && baseUrl) {
145
+ process.env[envVars.baseUrlEnv] = baseUrl;
146
+ for (const alias of envVars.extraBaseUrlEnv || []) {
147
+ process.env[alias] = baseUrl;
148
+ }
149
+ }
150
+ }
151
+ }
152
+
153
+ /**
154
+ * Sync a single provider's credentials into `process.env` (or clear them
155
+ * when no key is set). Call after mutating the store via the API so the
156
+ * effect is immediate instead of needing a restart.
157
+ */
158
+ export async function applyProviderCredentialsToEnv(provider) {
159
+ const envVars = PROVIDER_ENV_VARS[provider];
160
+ if (!envVars) return;
161
+ const creds = await getProviderCredentials(provider);
162
+ if (envVars.apiKeyEnv) {
163
+ if (creds?.apiKey) process.env[envVars.apiKeyEnv] = creds.apiKey;
164
+ else delete process.env[envVars.apiKeyEnv];
165
+ }
166
+ if (envVars.baseUrlEnv) {
167
+ if (creds?.baseUrl) process.env[envVars.baseUrlEnv] = creds.baseUrl;
168
+ else delete process.env[envVars.baseUrlEnv];
169
+ for (const alias of envVars.extraBaseUrlEnv || []) {
170
+ if (creds?.baseUrl) process.env[alias] = creds.baseUrl;
171
+ else delete process.env[alias];
172
+ }
173
+ }
174
+ }
175
+
176
+ /** Listing + logout helpers for the UI. */
177
+ export async function listProviderCredentialSummaries() {
178
+ const store = await readStore();
179
+ const out = {};
180
+ for (const key of Object.keys(PROVIDER_ENV_VARS)) {
181
+ const entry = store[key];
182
+ out[key] = {
183
+ hasKey: Boolean(entry && typeof entry.apiKey === 'string' && entry.apiKey.trim()),
184
+ baseUrl: entry && typeof entry.baseUrl === 'string' && entry.baseUrl.trim() ? entry.baseUrl.trim() : null,
185
+ updatedAt: entry && typeof entry.updatedAt === 'string' ? entry.updatedAt : null,
186
+ };
187
+ }
188
+ return out;
189
+ }