@pixelbyte-software/pixcode 1.35.0 → 1.35.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) 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-Djuh0wHV.js → index-CBdsvGSR.js} +133 -133
  11. package/dist/clear-cache.html +85 -85
  12. package/dist/convert-icons.md +52 -52
  13. package/dist/generate-icons.js +48 -48
  14. package/dist/icons/codex-white.svg +3 -3
  15. package/dist/icons/codex.svg +3 -3
  16. package/dist/icons/cursor-white.svg +11 -11
  17. package/dist/icons/qwen-logo.svg +14 -14
  18. package/dist/index.html +58 -58
  19. package/dist/manifest.json +60 -60
  20. package/dist/openapi.yaml +1693 -1693
  21. package/dist/sw.js +124 -124
  22. package/dist-server/server/cli.js +96 -96
  23. package/dist-server/server/daemon/manager.js +33 -33
  24. package/dist-server/server/daemon-manager.js +64 -64
  25. package/dist-server/server/modules/orchestration/preview/preview-proxy.js +3 -3
  26. package/dist-server/server/modules/orchestration/preview/preview-proxy.js.map +1 -1
  27. package/dist-server/server/routes/commands.js +25 -25
  28. package/dist-server/server/routes/git.js +17 -17
  29. package/dist-server/server/routes/taskmaster.js +419 -419
  30. package/package.json +180 -180
  31. package/scripts/fix-node-pty.js +67 -67
  32. package/scripts/smoke/a2a-roundtrip.mjs +167 -167
  33. package/scripts/smoke/orchestration-api.mjs +172 -172
  34. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  35. package/server/claude-sdk.js +898 -898
  36. package/server/cli.js +935 -935
  37. package/server/constants/config.js +4 -4
  38. package/server/cursor-cli.js +342 -342
  39. package/server/daemon/manager.js +564 -564
  40. package/server/daemon-manager.js +959 -959
  41. package/server/database/json-store.js +197 -197
  42. package/server/gemini-cli.js +535 -535
  43. package/server/gemini-response-handler.js +79 -79
  44. package/server/index.js +3135 -3135
  45. package/server/load-env.js +34 -34
  46. package/server/middleware/auth.js +173 -173
  47. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  48. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +55 -55
  49. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +284 -284
  50. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  51. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  52. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  53. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  54. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  55. package/server/modules/orchestration/a2a/agent-card.ts +55 -55
  56. package/server/modules/orchestration/a2a/auth.middleware.ts +29 -29
  57. package/server/modules/orchestration/a2a/bus.ts +46 -46
  58. package/server/modules/orchestration/a2a/routes.ts +577 -577
  59. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  60. package/server/modules/orchestration/a2a/types.ts +125 -125
  61. package/server/modules/orchestration/a2a/validator.ts +113 -113
  62. package/server/modules/orchestration/index.ts +66 -66
  63. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  64. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  65. package/server/modules/orchestration/preview/types.ts +19 -19
  66. package/server/modules/orchestration/tasks/orchestration-task-store.ts +45 -45
  67. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +73 -73
  68. package/server/modules/orchestration/tasks/orchestration-task.service.ts +145 -145
  69. package/server/modules/orchestration/tasks/orchestration-task.types.ts +29 -29
  70. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  71. package/server/modules/orchestration/workflows/workflow-runner.ts +1206 -1206
  72. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  73. package/server/modules/orchestration/workflows/workflow.routes.ts +169 -169
  74. package/server/modules/orchestration/workflows/workflow.types.ts +70 -70
  75. package/server/modules/orchestration/workflows/workspace-target.ts +120 -120
  76. package/server/modules/orchestration/workspace/docker-workspace.ts +135 -135
  77. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  78. package/server/modules/orchestration/workspace/types.ts +52 -52
  79. package/server/modules/orchestration/workspace/workspace-manager.ts +97 -97
  80. package/server/modules/orchestration/workspace/worktree-workspace.ts +125 -125
  81. package/server/modules/providers/index.ts +2 -2
  82. package/server/modules/providers/list/claude/claude-auth.provider.ts +145 -145
  83. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  84. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  85. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  86. package/server/modules/providers/list/codex/codex-auth.provider.ts +115 -115
  87. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  88. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  89. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  90. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +143 -143
  91. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  92. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  93. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  94. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +163 -163
  95. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  96. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  97. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  98. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +232 -232
  99. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  100. package/server/modules/providers/provider.registry.ts +40 -40
  101. package/server/modules/providers/provider.routes.ts +819 -819
  102. package/server/modules/providers/services/mcp.service.ts +86 -86
  103. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  104. package/server/modules/providers/services/sessions.service.ts +45 -45
  105. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  106. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  107. package/server/modules/providers/tests/mcp.test.ts +293 -293
  108. package/server/openai-codex.js +462 -462
  109. package/server/opencode-cli.js +459 -459
  110. package/server/opencode-response-handler.js +107 -107
  111. package/server/projects.js +3105 -3105
  112. package/server/routes/agent.js +1365 -1365
  113. package/server/routes/auth.js +138 -138
  114. package/server/routes/codex.js +19 -19
  115. package/server/routes/commands.js +554 -554
  116. package/server/routes/cursor.js +52 -52
  117. package/server/routes/gemini.js +24 -24
  118. package/server/routes/git.js +1488 -1488
  119. package/server/routes/mcp-utils.js +31 -31
  120. package/server/routes/messages.js +61 -61
  121. package/server/routes/network.js +120 -120
  122. package/server/routes/plugins.js +318 -318
  123. package/server/routes/projects.js +915 -915
  124. package/server/routes/settings.js +286 -286
  125. package/server/routes/taskmaster.js +1496 -1496
  126. package/server/routes/telegram.js +125 -125
  127. package/server/routes/user.js +123 -123
  128. package/server/services/install-jobs.js +571 -571
  129. package/server/services/notification-orchestrator.js +242 -242
  130. package/server/services/provider-credentials.js +189 -189
  131. package/server/services/telegram/bot.js +279 -279
  132. package/server/services/telegram/translations.js +170 -170
  133. package/server/sessionManager.js +225 -225
  134. package/server/shared/interfaces.ts +54 -54
  135. package/server/shared/types.ts +172 -172
  136. package/server/shared/utils.ts +193 -193
  137. package/server/tsconfig.json +36 -36
  138. package/server/utils/colors.js +21 -21
  139. package/server/utils/commandParser.js +303 -303
  140. package/server/utils/frontmatter.js +18 -18
  141. package/server/utils/gitConfig.js +34 -34
  142. package/server/utils/mcp-detector.js +147 -147
  143. package/server/utils/plugin-loader.js +457 -457
  144. package/server/utils/plugin-process-manager.js +184 -184
  145. package/server/utils/runtime-paths.js +37 -37
  146. package/server/utils/taskmaster-websocket.js +128 -128
  147. package/server/utils/url-detection.js +71 -71
  148. package/server/vite-daemon.js +78 -78
  149. package/shared/modelConstants.js +162 -162
  150. 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
+ }