@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,145 +1,145 @@
1
- import { readFile } from 'node:fs/promises';
2
- import os from 'node:os';
3
- import path from 'node:path';
4
-
5
- import spawn from 'cross-spawn';
6
-
7
- import type { IProviderAuth } from '@/shared/interfaces.js';
8
- import type { ProviderAuthStatus } from '@/shared/types.js';
9
- import { readObjectRecord, readOptionalString } from '@/shared/utils.js';
10
- // eslint-disable-next-line @typescript-eslint/ban-ts-comment
11
- // @ts-ignore — plain-JS module
12
- import { getProviderCredentials } from '@/services/provider-credentials.js';
13
-
14
- type ClaudeCredentialsStatus = {
15
- authenticated: boolean;
16
- email: string | null;
17
- method: string | null;
18
- error?: string;
19
- };
20
-
21
- export class ClaudeProviderAuth implements IProviderAuth {
22
- /**
23
- * Checks whether the Claude Code CLI is available on this host.
24
- *
25
- * NOTE: `cross-spawn.sync` does NOT throw on ENOENT — it returns a result
26
- * object with `error` populated. The try/catch alone was always returning
27
- * true and every provider appeared "installed". We now require both
28
- * `!result.error` and a numeric exit status (0 for `--version`) before
29
- * trusting the install.
30
- */
31
- private checkInstalled(): boolean {
32
- const cliPath = process.env.CLAUDE_CLI_PATH || 'claude';
33
- try {
34
- const result = spawn.sync(cliPath, ['--version'], { stdio: 'ignore', timeout: 5000 });
35
- return !result.error && result.status === 0;
36
- } catch {
37
- return false;
38
- }
39
- }
40
-
41
- /**
42
- * Returns Claude installation and credential status using Claude Code's auth priority.
43
- */
44
- async getStatus(): Promise<ProviderAuthStatus> {
45
- const installed = this.checkInstalled();
46
-
47
- if (!installed) {
48
- return {
49
- installed,
50
- provider: 'claude',
51
- authenticated: false,
52
- email: null,
53
- method: null,
54
- error: 'Claude Code CLI is not installed',
55
- };
56
- }
57
-
58
- const credentials = await this.checkCredentials();
59
-
60
- return {
61
- installed,
62
- provider: 'claude',
63
- authenticated: credentials.authenticated,
64
- email: credentials.authenticated ? credentials.email || 'Authenticated' : credentials.email,
65
- method: credentials.method,
66
- error: credentials.authenticated ? undefined : credentials.error || 'Not authenticated',
67
- };
68
- }
69
-
70
- /**
71
- * Reads Claude settings env values that the CLI can use even when the server process env is empty.
72
- */
73
- private async loadSettingsEnv(): Promise<Record<string, unknown>> {
74
- try {
75
- const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
76
- const content = await readFile(settingsPath, 'utf8');
77
- const settings = readObjectRecord(JSON.parse(content));
78
- return readObjectRecord(settings?.env) ?? {};
79
- } catch {
80
- return {};
81
- }
82
- }
83
-
84
- /**
85
- * Checks Claude credentials in the same priority order used by Claude Code.
86
- */
87
- private async checkCredentials(): Promise<ClaudeCredentialsStatus> {
88
- // Pixcode-UI-saved credentials win. Users who paste a key into our
89
- // Settings > Agents form expect authenticated status immediately,
90
- // regardless of env var timing.
91
- try {
92
- const creds = await getProviderCredentials('claude');
93
- if (creds?.apiKey) {
94
- const label = creds.baseUrl
95
- ? `API Key · ${(() => { try { return new URL(creds.baseUrl).host; } catch { return creds.baseUrl; } })()}`
96
- : 'API Key Auth';
97
- return { authenticated: true, email: label, method: 'pixcode_store' };
98
- }
99
- } catch { /* fall through */ }
100
-
101
- if (process.env.ANTHROPIC_API_KEY?.trim()) {
102
- return { authenticated: true, email: 'API Key Auth', method: 'api_key' };
103
- }
104
-
105
- const settingsEnv = await this.loadSettingsEnv();
106
- if (readOptionalString(settingsEnv.ANTHROPIC_API_KEY)) {
107
- return { authenticated: true, email: 'API Key Auth', method: 'api_key' };
108
- }
109
-
110
- if (readOptionalString(settingsEnv.ANTHROPIC_AUTH_TOKEN)) {
111
- return { authenticated: true, email: 'Configured via settings.json', method: 'api_key' };
112
- }
113
-
114
- try {
115
- const credPath = path.join(os.homedir(), '.claude', '.credentials.json');
116
- const content = await readFile(credPath, 'utf8');
117
- const creds = readObjectRecord(JSON.parse(content)) ?? {};
118
- const oauth = readObjectRecord(creds.claudeAiOauth);
119
- const accessToken = readOptionalString(oauth?.accessToken);
120
-
121
- if (accessToken) {
122
- const expiresAt = typeof oauth?.expiresAt === 'number' ? oauth.expiresAt : undefined;
123
- const email = readOptionalString(creds.email) ?? readOptionalString(creds.user) ?? null;
124
- if (!expiresAt || Date.now() < expiresAt) {
125
- return {
126
- authenticated: true,
127
- email,
128
- method: 'credentials_file',
129
- };
130
- }
131
-
132
- return {
133
- authenticated: false,
134
- email,
135
- method: 'credentials_file',
136
- error: 'OAuth token has expired. Please re-authenticate with claude login',
137
- };
138
- }
139
-
140
- return { authenticated: false, email: null, method: null };
141
- } catch {
142
- return { authenticated: false, email: null, method: null };
143
- }
144
- }
145
- }
1
+ import { readFile } from 'node:fs/promises';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+
5
+ import spawn from 'cross-spawn';
6
+
7
+ import type { IProviderAuth } from '@/shared/interfaces.js';
8
+ import type { ProviderAuthStatus } from '@/shared/types.js';
9
+ import { readObjectRecord, readOptionalString } from '@/shared/utils.js';
10
+ // eslint-disable-next-line @typescript-eslint/ban-ts-comment
11
+ // @ts-ignore — plain-JS module
12
+ import { getProviderCredentials } from '@/services/provider-credentials.js';
13
+
14
+ type ClaudeCredentialsStatus = {
15
+ authenticated: boolean;
16
+ email: string | null;
17
+ method: string | null;
18
+ error?: string;
19
+ };
20
+
21
+ export class ClaudeProviderAuth implements IProviderAuth {
22
+ /**
23
+ * Checks whether the Claude Code CLI is available on this host.
24
+ *
25
+ * NOTE: `cross-spawn.sync` does NOT throw on ENOENT — it returns a result
26
+ * object with `error` populated. The try/catch alone was always returning
27
+ * true and every provider appeared "installed". We now require both
28
+ * `!result.error` and a numeric exit status (0 for `--version`) before
29
+ * trusting the install.
30
+ */
31
+ private checkInstalled(): boolean {
32
+ const cliPath = process.env.CLAUDE_CLI_PATH || 'claude';
33
+ try {
34
+ const result = spawn.sync(cliPath, ['--version'], { stdio: 'ignore', timeout: 5000 });
35
+ return !result.error && result.status === 0;
36
+ } catch {
37
+ return false;
38
+ }
39
+ }
40
+
41
+ /**
42
+ * Returns Claude installation and credential status using Claude Code's auth priority.
43
+ */
44
+ async getStatus(): Promise<ProviderAuthStatus> {
45
+ const installed = this.checkInstalled();
46
+
47
+ if (!installed) {
48
+ return {
49
+ installed,
50
+ provider: 'claude',
51
+ authenticated: false,
52
+ email: null,
53
+ method: null,
54
+ error: 'Claude Code CLI is not installed',
55
+ };
56
+ }
57
+
58
+ const credentials = await this.checkCredentials();
59
+
60
+ return {
61
+ installed,
62
+ provider: 'claude',
63
+ authenticated: credentials.authenticated,
64
+ email: credentials.authenticated ? credentials.email || 'Authenticated' : credentials.email,
65
+ method: credentials.method,
66
+ error: credentials.authenticated ? undefined : credentials.error || 'Not authenticated',
67
+ };
68
+ }
69
+
70
+ /**
71
+ * Reads Claude settings env values that the CLI can use even when the server process env is empty.
72
+ */
73
+ private async loadSettingsEnv(): Promise<Record<string, unknown>> {
74
+ try {
75
+ const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
76
+ const content = await readFile(settingsPath, 'utf8');
77
+ const settings = readObjectRecord(JSON.parse(content));
78
+ return readObjectRecord(settings?.env) ?? {};
79
+ } catch {
80
+ return {};
81
+ }
82
+ }
83
+
84
+ /**
85
+ * Checks Claude credentials in the same priority order used by Claude Code.
86
+ */
87
+ private async checkCredentials(): Promise<ClaudeCredentialsStatus> {
88
+ // Pixcode-UI-saved credentials win. Users who paste a key into our
89
+ // Settings > Agents form expect authenticated status immediately,
90
+ // regardless of env var timing.
91
+ try {
92
+ const creds = await getProviderCredentials('claude');
93
+ if (creds?.apiKey) {
94
+ const label = creds.baseUrl
95
+ ? `API Key · ${(() => { try { return new URL(creds.baseUrl).host; } catch { return creds.baseUrl; } })()}`
96
+ : 'API Key Auth';
97
+ return { authenticated: true, email: label, method: 'pixcode_store' };
98
+ }
99
+ } catch { /* fall through */ }
100
+
101
+ if (process.env.ANTHROPIC_API_KEY?.trim()) {
102
+ return { authenticated: true, email: 'API Key Auth', method: 'api_key' };
103
+ }
104
+
105
+ const settingsEnv = await this.loadSettingsEnv();
106
+ if (readOptionalString(settingsEnv.ANTHROPIC_API_KEY)) {
107
+ return { authenticated: true, email: 'API Key Auth', method: 'api_key' };
108
+ }
109
+
110
+ if (readOptionalString(settingsEnv.ANTHROPIC_AUTH_TOKEN)) {
111
+ return { authenticated: true, email: 'Configured via settings.json', method: 'api_key' };
112
+ }
113
+
114
+ try {
115
+ const credPath = path.join(os.homedir(), '.claude', '.credentials.json');
116
+ const content = await readFile(credPath, 'utf8');
117
+ const creds = readObjectRecord(JSON.parse(content)) ?? {};
118
+ const oauth = readObjectRecord(creds.claudeAiOauth);
119
+ const accessToken = readOptionalString(oauth?.accessToken);
120
+
121
+ if (accessToken) {
122
+ const expiresAt = typeof oauth?.expiresAt === 'number' ? oauth.expiresAt : undefined;
123
+ const email = readOptionalString(creds.email) ?? readOptionalString(creds.user) ?? null;
124
+ if (!expiresAt || Date.now() < expiresAt) {
125
+ return {
126
+ authenticated: true,
127
+ email,
128
+ method: 'credentials_file',
129
+ };
130
+ }
131
+
132
+ return {
133
+ authenticated: false,
134
+ email,
135
+ method: 'credentials_file',
136
+ error: 'OAuth token has expired. Please re-authenticate with claude login',
137
+ };
138
+ }
139
+
140
+ return { authenticated: false, email: null, method: null };
141
+ } catch {
142
+ return { authenticated: false, email: null, method: null };
143
+ }
144
+ }
145
+ }
@@ -1,135 +1,135 @@
1
- import os from 'node:os';
2
- import path from 'node:path';
3
-
4
- import { McpProvider } from '@/modules/providers/shared/mcp/mcp.provider.js';
5
- import type { McpScope, ProviderMcpServer, UpsertProviderMcpServerInput } from '@/shared/types.js';
6
- import {
7
- AppError,
8
- readJsonConfig,
9
- readObjectRecord,
10
- readOptionalString,
11
- readStringArray,
12
- readStringRecord,
13
- writeJsonConfig,
14
- } from '@/shared/utils.js';
15
-
16
- export class ClaudeMcpProvider extends McpProvider {
17
- constructor() {
18
- super('claude', ['user', 'local', 'project'], ['stdio', 'http', 'sse']);
19
- }
20
-
21
- protected async readScopedServers(scope: McpScope, workspacePath: string): Promise<Record<string, unknown>> {
22
- if (scope === 'project') {
23
- const filePath = path.join(workspacePath, '.mcp.json');
24
- const config = await readJsonConfig(filePath);
25
- return readObjectRecord(config.mcpServers) ?? {};
26
- }
27
-
28
- const filePath = path.join(os.homedir(), '.claude.json');
29
- const config = await readJsonConfig(filePath);
30
- if (scope === 'user') {
31
- return readObjectRecord(config.mcpServers) ?? {};
32
- }
33
-
34
- const projects = readObjectRecord(config.projects) ?? {};
35
- const projectConfig = readObjectRecord(projects[workspacePath]) ?? {};
36
- return readObjectRecord(projectConfig.mcpServers) ?? {};
37
- }
38
-
39
- protected async writeScopedServers(
40
- scope: McpScope,
41
- workspacePath: string,
42
- servers: Record<string, unknown>,
43
- ): Promise<void> {
44
- if (scope === 'project') {
45
- const filePath = path.join(workspacePath, '.mcp.json');
46
- const config = await readJsonConfig(filePath);
47
- config.mcpServers = servers;
48
- await writeJsonConfig(filePath, config);
49
- return;
50
- }
51
-
52
- const filePath = path.join(os.homedir(), '.claude.json');
53
- const config = await readJsonConfig(filePath);
54
- if (scope === 'user') {
55
- config.mcpServers = servers;
56
- await writeJsonConfig(filePath, config);
57
- return;
58
- }
59
-
60
- const projects = readObjectRecord(config.projects) ?? {};
61
- const projectConfig = readObjectRecord(projects[workspacePath]) ?? {};
62
- projectConfig.mcpServers = servers;
63
- projects[workspacePath] = projectConfig;
64
- config.projects = projects;
65
- await writeJsonConfig(filePath, config);
66
- }
67
-
68
- protected buildServerConfig(input: UpsertProviderMcpServerInput): Record<string, unknown> {
69
- if (input.transport === 'stdio') {
70
- if (!input.command?.trim()) {
71
- throw new AppError('command is required for stdio MCP servers.', {
72
- code: 'MCP_COMMAND_REQUIRED',
73
- statusCode: 400,
74
- });
75
- }
76
-
77
- return {
78
- type: 'stdio',
79
- command: input.command,
80
- args: input.args ?? [],
81
- env: input.env ?? {},
82
- };
83
- }
84
-
85
- if (!input.url?.trim()) {
86
- throw new AppError('url is required for http/sse MCP servers.', {
87
- code: 'MCP_URL_REQUIRED',
88
- statusCode: 400,
89
- });
90
- }
91
-
92
- return {
93
- type: input.transport,
94
- url: input.url,
95
- headers: input.headers ?? {},
96
- };
97
- }
98
-
99
- protected normalizeServerConfig(
100
- scope: McpScope,
101
- name: string,
102
- rawConfig: unknown,
103
- ): ProviderMcpServer | null {
104
- if (!rawConfig || typeof rawConfig !== 'object') {
105
- return null;
106
- }
107
-
108
- const config = rawConfig as Record<string, unknown>;
109
- if (typeof config.command === 'string') {
110
- return {
111
- provider: 'claude',
112
- name,
113
- scope,
114
- transport: 'stdio',
115
- command: config.command,
116
- args: readStringArray(config.args),
117
- env: readStringRecord(config.env),
118
- };
119
- }
120
-
121
- if (typeof config.url === 'string') {
122
- const transport = readOptionalString(config.type) === 'sse' ? 'sse' : 'http';
123
- return {
124
- provider: 'claude',
125
- name,
126
- scope,
127
- transport,
128
- url: config.url,
129
- headers: readStringRecord(config.headers),
130
- };
131
- }
132
-
133
- return null;
134
- }
135
- }
1
+ import os from 'node:os';
2
+ import path from 'node:path';
3
+
4
+ import { McpProvider } from '@/modules/providers/shared/mcp/mcp.provider.js';
5
+ import type { McpScope, ProviderMcpServer, UpsertProviderMcpServerInput } from '@/shared/types.js';
6
+ import {
7
+ AppError,
8
+ readJsonConfig,
9
+ readObjectRecord,
10
+ readOptionalString,
11
+ readStringArray,
12
+ readStringRecord,
13
+ writeJsonConfig,
14
+ } from '@/shared/utils.js';
15
+
16
+ export class ClaudeMcpProvider extends McpProvider {
17
+ constructor() {
18
+ super('claude', ['user', 'local', 'project'], ['stdio', 'http', 'sse']);
19
+ }
20
+
21
+ protected async readScopedServers(scope: McpScope, workspacePath: string): Promise<Record<string, unknown>> {
22
+ if (scope === 'project') {
23
+ const filePath = path.join(workspacePath, '.mcp.json');
24
+ const config = await readJsonConfig(filePath);
25
+ return readObjectRecord(config.mcpServers) ?? {};
26
+ }
27
+
28
+ const filePath = path.join(os.homedir(), '.claude.json');
29
+ const config = await readJsonConfig(filePath);
30
+ if (scope === 'user') {
31
+ return readObjectRecord(config.mcpServers) ?? {};
32
+ }
33
+
34
+ const projects = readObjectRecord(config.projects) ?? {};
35
+ const projectConfig = readObjectRecord(projects[workspacePath]) ?? {};
36
+ return readObjectRecord(projectConfig.mcpServers) ?? {};
37
+ }
38
+
39
+ protected async writeScopedServers(
40
+ scope: McpScope,
41
+ workspacePath: string,
42
+ servers: Record<string, unknown>,
43
+ ): Promise<void> {
44
+ if (scope === 'project') {
45
+ const filePath = path.join(workspacePath, '.mcp.json');
46
+ const config = await readJsonConfig(filePath);
47
+ config.mcpServers = servers;
48
+ await writeJsonConfig(filePath, config);
49
+ return;
50
+ }
51
+
52
+ const filePath = path.join(os.homedir(), '.claude.json');
53
+ const config = await readJsonConfig(filePath);
54
+ if (scope === 'user') {
55
+ config.mcpServers = servers;
56
+ await writeJsonConfig(filePath, config);
57
+ return;
58
+ }
59
+
60
+ const projects = readObjectRecord(config.projects) ?? {};
61
+ const projectConfig = readObjectRecord(projects[workspacePath]) ?? {};
62
+ projectConfig.mcpServers = servers;
63
+ projects[workspacePath] = projectConfig;
64
+ config.projects = projects;
65
+ await writeJsonConfig(filePath, config);
66
+ }
67
+
68
+ protected buildServerConfig(input: UpsertProviderMcpServerInput): Record<string, unknown> {
69
+ if (input.transport === 'stdio') {
70
+ if (!input.command?.trim()) {
71
+ throw new AppError('command is required for stdio MCP servers.', {
72
+ code: 'MCP_COMMAND_REQUIRED',
73
+ statusCode: 400,
74
+ });
75
+ }
76
+
77
+ return {
78
+ type: 'stdio',
79
+ command: input.command,
80
+ args: input.args ?? [],
81
+ env: input.env ?? {},
82
+ };
83
+ }
84
+
85
+ if (!input.url?.trim()) {
86
+ throw new AppError('url is required for http/sse MCP servers.', {
87
+ code: 'MCP_URL_REQUIRED',
88
+ statusCode: 400,
89
+ });
90
+ }
91
+
92
+ return {
93
+ type: input.transport,
94
+ url: input.url,
95
+ headers: input.headers ?? {},
96
+ };
97
+ }
98
+
99
+ protected normalizeServerConfig(
100
+ scope: McpScope,
101
+ name: string,
102
+ rawConfig: unknown,
103
+ ): ProviderMcpServer | null {
104
+ if (!rawConfig || typeof rawConfig !== 'object') {
105
+ return null;
106
+ }
107
+
108
+ const config = rawConfig as Record<string, unknown>;
109
+ if (typeof config.command === 'string') {
110
+ return {
111
+ provider: 'claude',
112
+ name,
113
+ scope,
114
+ transport: 'stdio',
115
+ command: config.command,
116
+ args: readStringArray(config.args),
117
+ env: readStringRecord(config.env),
118
+ };
119
+ }
120
+
121
+ if (typeof config.url === 'string') {
122
+ const transport = readOptionalString(config.type) === 'sse' ? 'sse' : 'http';
123
+ return {
124
+ provider: 'claude',
125
+ name,
126
+ scope,
127
+ transport,
128
+ url: config.url,
129
+ headers: readStringRecord(config.headers),
130
+ };
131
+ }
132
+
133
+ return null;
134
+ }
135
+ }