@pixelbyte-software/pixcode 1.35.1 → 1.35.2

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 (172) 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-CBdsvGSR.js → index-D1-AIL_5.js} +1 -1
  11. package/dist/clear-cache.html +85 -85
  12. package/dist/convert-icons.md +52 -52
  13. package/dist/favicon.svg +8 -8
  14. package/dist/generate-icons.js +48 -48
  15. package/dist/icons/codex-white.svg +3 -3
  16. package/dist/icons/codex.svg +3 -3
  17. package/dist/icons/cursor-white.svg +11 -11
  18. package/dist/icons/icon-128x128.svg +9 -9
  19. package/dist/icons/icon-144x144.svg +9 -9
  20. package/dist/icons/icon-152x152.svg +9 -9
  21. package/dist/icons/icon-192x192.svg +9 -9
  22. package/dist/icons/icon-384x384.svg +9 -9
  23. package/dist/icons/icon-512x512.svg +9 -9
  24. package/dist/icons/icon-72x72.svg +9 -9
  25. package/dist/icons/icon-96x96.svg +9 -9
  26. package/dist/icons/icon-template.svg +9 -9
  27. package/dist/icons/qwen-logo.svg +14 -14
  28. package/dist/index.html +58 -58
  29. package/dist/logo.svg +12 -12
  30. package/dist/manifest.json +60 -60
  31. package/dist/openapi.yaml +1693 -1693
  32. package/dist/sw.js +124 -124
  33. package/dist-server/server/cli.js +96 -96
  34. package/dist-server/server/daemon/manager.js +33 -33
  35. package/dist-server/server/daemon-manager.js +64 -64
  36. package/dist-server/server/routes/commands.js +25 -25
  37. package/dist-server/server/routes/git.js +17 -17
  38. package/dist-server/server/routes/taskmaster.js +419 -419
  39. package/package.json +180 -180
  40. package/scripts/fix-node-pty.js +67 -67
  41. package/scripts/smoke/a2a-roundtrip.mjs +167 -167
  42. package/scripts/smoke/orchestration-api.mjs +172 -172
  43. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  44. package/server/claude-sdk.js +898 -898
  45. package/server/cli.js +935 -935
  46. package/server/constants/config.js +4 -4
  47. package/server/cursor-cli.js +342 -342
  48. package/server/daemon/manager.js +564 -564
  49. package/server/daemon-manager.js +959 -959
  50. package/server/database/db.js +794 -794
  51. package/server/database/json-store.js +197 -197
  52. package/server/gemini-cli.js +535 -535
  53. package/server/gemini-response-handler.js +79 -79
  54. package/server/index.js +3135 -3135
  55. package/server/load-env.js +34 -34
  56. package/server/middleware/auth.js +173 -173
  57. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  58. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +55 -55
  59. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +284 -284
  60. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  61. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  62. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  63. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  64. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  65. package/server/modules/orchestration/a2a/routes.ts +577 -577
  66. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  67. package/server/modules/orchestration/a2a/types.ts +125 -125
  68. package/server/modules/orchestration/a2a/validator.ts +113 -113
  69. package/server/modules/orchestration/index.ts +66 -66
  70. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  71. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  72. package/server/modules/orchestration/preview/types.ts +19 -19
  73. package/server/modules/orchestration/tasks/orchestration-task-store.ts +45 -45
  74. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +73 -73
  75. package/server/modules/orchestration/tasks/orchestration-task.service.ts +145 -145
  76. package/server/modules/orchestration/tasks/orchestration-task.types.ts +29 -29
  77. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  78. package/server/modules/orchestration/workflows/workflow-runner.ts +1206 -1206
  79. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  80. package/server/modules/orchestration/workflows/workflow.routes.ts +169 -169
  81. package/server/modules/orchestration/workflows/workflow.types.ts +70 -70
  82. package/server/modules/orchestration/workflows/workspace-target.ts +120 -120
  83. package/server/modules/orchestration/workspace/docker-workspace.ts +135 -135
  84. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  85. package/server/modules/orchestration/workspace/types.ts +52 -52
  86. package/server/modules/orchestration/workspace/workspace-manager.ts +97 -97
  87. package/server/modules/orchestration/workspace/worktree-workspace.ts +125 -125
  88. package/server/modules/providers/index.ts +2 -2
  89. package/server/modules/providers/list/claude/claude-auth.provider.ts +145 -145
  90. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  91. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  92. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  93. package/server/modules/providers/list/codex/codex-auth.provider.ts +115 -115
  94. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  95. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  96. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  97. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +143 -143
  98. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  99. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  100. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  101. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +163 -163
  102. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  103. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  104. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  105. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +130 -130
  106. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  107. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +232 -232
  108. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  109. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +145 -145
  110. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  111. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  112. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  113. package/server/modules/providers/provider.registry.ts +40 -40
  114. package/server/modules/providers/provider.routes.ts +819 -819
  115. package/server/modules/providers/services/mcp.service.ts +86 -86
  116. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  117. package/server/modules/providers/services/sessions.service.ts +45 -45
  118. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  119. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  120. package/server/modules/providers/shared/provider-configs.ts +142 -142
  121. package/server/modules/providers/tests/mcp.test.ts +293 -293
  122. package/server/openai-codex.js +462 -462
  123. package/server/opencode-cli.js +459 -459
  124. package/server/opencode-response-handler.js +107 -107
  125. package/server/projects.js +3105 -3105
  126. package/server/qwen-code-cli.js +395 -395
  127. package/server/qwen-response-handler.js +73 -73
  128. package/server/routes/agent.js +1365 -1365
  129. package/server/routes/auth.js +138 -138
  130. package/server/routes/codex.js +19 -19
  131. package/server/routes/commands.js +554 -554
  132. package/server/routes/cursor.js +52 -52
  133. package/server/routes/gemini.js +24 -24
  134. package/server/routes/git.js +1488 -1488
  135. package/server/routes/mcp-utils.js +31 -31
  136. package/server/routes/messages.js +61 -61
  137. package/server/routes/network.js +120 -120
  138. package/server/routes/plugins.js +318 -318
  139. package/server/routes/projects.js +915 -915
  140. package/server/routes/qwen.js +27 -27
  141. package/server/routes/settings.js +286 -286
  142. package/server/routes/taskmaster.js +1496 -1496
  143. package/server/routes/telegram.js +125 -125
  144. package/server/routes/user.js +123 -123
  145. package/server/services/external-access.js +171 -171
  146. package/server/services/install-jobs.js +571 -571
  147. package/server/services/notification-orchestrator.js +242 -242
  148. package/server/services/provider-credentials.js +189 -189
  149. package/server/services/provider-models.js +381 -381
  150. package/server/services/telegram/bot.js +279 -279
  151. package/server/services/telegram/telegram-http-client.js +130 -130
  152. package/server/services/telegram/translations.js +170 -170
  153. package/server/services/vapid-keys.js +36 -36
  154. package/server/sessionManager.js +225 -225
  155. package/server/shared/interfaces.ts +54 -54
  156. package/server/shared/types.ts +172 -172
  157. package/server/shared/utils.ts +193 -193
  158. package/server/tsconfig.json +36 -36
  159. package/server/utils/colors.js +21 -21
  160. package/server/utils/commandParser.js +303 -303
  161. package/server/utils/frontmatter.js +18 -18
  162. package/server/utils/gitConfig.js +34 -34
  163. package/server/utils/mcp-detector.js +147 -147
  164. package/server/utils/plugin-loader.js +457 -457
  165. package/server/utils/plugin-process-manager.js +184 -184
  166. package/server/utils/port-access.js +209 -209
  167. package/server/utils/runtime-paths.js +37 -37
  168. package/server/utils/taskmaster-websocket.js +128 -128
  169. package/server/utils/url-detection.js +71 -71
  170. package/server/vite-daemon.js +78 -78
  171. package/shared/modelConstants.js +162 -162
  172. 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
+ }