@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,86 +1,86 @@
1
- import { providerRegistry } from '@/modules/providers/provider.registry.js';
2
- import type { LLMProvider, McpScope, ProviderMcpServer, UpsertProviderMcpServerInput } from '@/shared/types.js';
3
- import { AppError } from '@/shared/utils.js';
4
-
5
-
6
- export const providerMcpService = {
7
- /**
8
- * Lists MCP servers for one provider grouped by supported scopes.
9
- */
10
- async listProviderMcpServers(
11
- providerName: string,
12
- options?: { workspacePath?: string },
13
- ): Promise<Record<McpScope, ProviderMcpServer[]>> {
14
- const provider = providerRegistry.resolveProvider(providerName);
15
- return provider.mcp.listServers(options);
16
- },
17
-
18
- /**
19
- * Lists MCP servers for one provider scope.
20
- */
21
- async listProviderMcpServersForScope(
22
- providerName: string,
23
- scope: McpScope,
24
- options?: { workspacePath?: string },
25
- ): Promise<ProviderMcpServer[]> {
26
- const provider = providerRegistry.resolveProvider(providerName);
27
- return provider.mcp.listServersForScope(scope, options);
28
- },
29
-
30
- /**
31
- * Adds or updates one provider MCP server.
32
- */
33
- async upsertProviderMcpServer(
34
- providerName: string,
35
- input: UpsertProviderMcpServerInput,
36
- ): Promise<ProviderMcpServer> {
37
- const provider = providerRegistry.resolveProvider(providerName);
38
- return provider.mcp.upsertServer(input);
39
- },
40
-
41
- /**
42
- * Removes one provider MCP server.
43
- */
44
- async removeProviderMcpServer(
45
- providerName: string,
46
- input: { name: string; scope?: McpScope; workspacePath?: string },
47
- ): Promise<{ removed: boolean; provider: LLMProvider; name: string; scope: McpScope }> {
48
- const provider = providerRegistry.resolveProvider(providerName);
49
- return provider.mcp.removeServer(input);
50
- },
51
-
52
- /**
53
- * Adds one HTTP/stdio MCP server to every provider.
54
- */
55
- async addMcpServerToAllProviders(
56
- input: Omit<UpsertProviderMcpServerInput, 'scope'> & { scope?: Exclude<McpScope, 'local'> },
57
- ): Promise<Array<{ provider: LLMProvider; created: boolean; error?: string }>> {
58
- if (input.transport !== 'stdio' && input.transport !== 'http') {
59
- throw new AppError('Global MCP add supports only "stdio" and "http".', {
60
- code: 'INVALID_GLOBAL_MCP_TRANSPORT',
61
- statusCode: 400,
62
- });
63
- }
64
-
65
- const scope = input.scope ?? 'project';
66
- const results: Array<{ provider: LLMProvider; created: boolean; error?: string }> = [];
67
- // Cursor's Windows filter used to live here too; it's been removed so
68
- // global-MCP writes hit every registered provider uniformly. The UI
69
- // shows cursor on Windows now — the backend has to match.
70
- const providers = providerRegistry.listProviders();
71
- for (const provider of providers) {
72
- try {
73
- await provider.mcp.upsertServer({ ...input, scope });
74
- results.push({ provider: provider.id, created: true });
75
- } catch (error) {
76
- results.push({
77
- provider: provider.id,
78
- created: false,
79
- error: error instanceof Error ? error.message : 'Unknown error',
80
- });
81
- }
82
- }
83
-
84
- return results;
85
- },
86
- };
1
+ import { providerRegistry } from '@/modules/providers/provider.registry.js';
2
+ import type { LLMProvider, McpScope, ProviderMcpServer, UpsertProviderMcpServerInput } from '@/shared/types.js';
3
+ import { AppError } from '@/shared/utils.js';
4
+
5
+
6
+ export const providerMcpService = {
7
+ /**
8
+ * Lists MCP servers for one provider grouped by supported scopes.
9
+ */
10
+ async listProviderMcpServers(
11
+ providerName: string,
12
+ options?: { workspacePath?: string },
13
+ ): Promise<Record<McpScope, ProviderMcpServer[]>> {
14
+ const provider = providerRegistry.resolveProvider(providerName);
15
+ return provider.mcp.listServers(options);
16
+ },
17
+
18
+ /**
19
+ * Lists MCP servers for one provider scope.
20
+ */
21
+ async listProviderMcpServersForScope(
22
+ providerName: string,
23
+ scope: McpScope,
24
+ options?: { workspacePath?: string },
25
+ ): Promise<ProviderMcpServer[]> {
26
+ const provider = providerRegistry.resolveProvider(providerName);
27
+ return provider.mcp.listServersForScope(scope, options);
28
+ },
29
+
30
+ /**
31
+ * Adds or updates one provider MCP server.
32
+ */
33
+ async upsertProviderMcpServer(
34
+ providerName: string,
35
+ input: UpsertProviderMcpServerInput,
36
+ ): Promise<ProviderMcpServer> {
37
+ const provider = providerRegistry.resolveProvider(providerName);
38
+ return provider.mcp.upsertServer(input);
39
+ },
40
+
41
+ /**
42
+ * Removes one provider MCP server.
43
+ */
44
+ async removeProviderMcpServer(
45
+ providerName: string,
46
+ input: { name: string; scope?: McpScope; workspacePath?: string },
47
+ ): Promise<{ removed: boolean; provider: LLMProvider; name: string; scope: McpScope }> {
48
+ const provider = providerRegistry.resolveProvider(providerName);
49
+ return provider.mcp.removeServer(input);
50
+ },
51
+
52
+ /**
53
+ * Adds one HTTP/stdio MCP server to every provider.
54
+ */
55
+ async addMcpServerToAllProviders(
56
+ input: Omit<UpsertProviderMcpServerInput, 'scope'> & { scope?: Exclude<McpScope, 'local'> },
57
+ ): Promise<Array<{ provider: LLMProvider; created: boolean; error?: string }>> {
58
+ if (input.transport !== 'stdio' && input.transport !== 'http') {
59
+ throw new AppError('Global MCP add supports only "stdio" and "http".', {
60
+ code: 'INVALID_GLOBAL_MCP_TRANSPORT',
61
+ statusCode: 400,
62
+ });
63
+ }
64
+
65
+ const scope = input.scope ?? 'project';
66
+ const results: Array<{ provider: LLMProvider; created: boolean; error?: string }> = [];
67
+ // Cursor's Windows filter used to live here too; it's been removed so
68
+ // global-MCP writes hit every registered provider uniformly. The UI
69
+ // shows cursor on Windows now — the backend has to match.
70
+ const providers = providerRegistry.listProviders();
71
+ for (const provider of providers) {
72
+ try {
73
+ await provider.mcp.upsertServer({ ...input, scope });
74
+ results.push({ provider: provider.id, created: true });
75
+ } catch (error) {
76
+ results.push({
77
+ provider: provider.id,
78
+ created: false,
79
+ error: error instanceof Error ? error.message : 'Unknown error',
80
+ });
81
+ }
82
+ }
83
+
84
+ return results;
85
+ },
86
+ };
@@ -1,26 +1,26 @@
1
- import { providerRegistry } from '@/modules/providers/provider.registry.js';
2
- import type { LLMProvider, ProviderAuthStatus } from '@/shared/types.js';
3
-
4
- export const providerAuthService = {
5
- /**
6
- * Resolves a provider and returns its installation/authentication status.
7
- */
8
- async getProviderAuthStatus(providerName: string): Promise<ProviderAuthStatus> {
9
- const provider = providerRegistry.resolveProvider(providerName);
10
- return provider.auth.getStatus();
11
- },
12
-
13
- /**
14
- * Returns whether a provider runtime appears installed.
15
- * Falls back to true if status lookup itself fails so callers preserve the
16
- * original runtime error instead of replacing it with a status-check failure.
17
- */
18
- async isProviderInstalled(providerName: LLMProvider): Promise<boolean> {
19
- try {
20
- const status = await this.getProviderAuthStatus(providerName);
21
- return status.installed;
22
- } catch {
23
- return true;
24
- }
25
- },
26
- };
1
+ import { providerRegistry } from '@/modules/providers/provider.registry.js';
2
+ import type { LLMProvider, ProviderAuthStatus } from '@/shared/types.js';
3
+
4
+ export const providerAuthService = {
5
+ /**
6
+ * Resolves a provider and returns its installation/authentication status.
7
+ */
8
+ async getProviderAuthStatus(providerName: string): Promise<ProviderAuthStatus> {
9
+ const provider = providerRegistry.resolveProvider(providerName);
10
+ return provider.auth.getStatus();
11
+ },
12
+
13
+ /**
14
+ * Returns whether a provider runtime appears installed.
15
+ * Falls back to true if status lookup itself fails so callers preserve the
16
+ * original runtime error instead of replacing it with a status-check failure.
17
+ */
18
+ async isProviderInstalled(providerName: LLMProvider): Promise<boolean> {
19
+ try {
20
+ const status = await this.getProviderAuthStatus(providerName);
21
+ return status.installed;
22
+ } catch {
23
+ return true;
24
+ }
25
+ },
26
+ };
@@ -1,45 +1,45 @@
1
- import { providerRegistry } from '@/modules/providers/provider.registry.js';
2
- import type {
3
- FetchHistoryOptions,
4
- FetchHistoryResult,
5
- LLMProvider,
6
- NormalizedMessage,
7
- } from '@/shared/types.js';
8
-
9
- /**
10
- * Application service for provider-backed session message operations.
11
- *
12
- * Callers pass a provider id and this service resolves the concrete provider
13
- * class, keeping normalization/history call sites decoupled from implementation
14
- * file layout.
15
- */
16
- export const sessionsService = {
17
- /**
18
- * Lists provider ids that can load session history and normalize live messages.
19
- */
20
- listProviderIds(): LLMProvider[] {
21
- return providerRegistry.listProviders().map((provider) => provider.id);
22
- },
23
-
24
- /**
25
- * Normalizes one provider-native event into frontend session message events.
26
- */
27
- normalizeMessage(
28
- providerName: string,
29
- raw: unknown,
30
- sessionId: string | null,
31
- ): NormalizedMessage[] {
32
- return providerRegistry.resolveProvider(providerName).sessions.normalizeMessage(raw, sessionId);
33
- },
34
-
35
- /**
36
- * Fetches normalized persisted session history for one provider/session pair.
37
- */
38
- fetchHistory(
39
- providerName: string,
40
- sessionId: string,
41
- options?: FetchHistoryOptions,
42
- ): Promise<FetchHistoryResult> {
43
- return providerRegistry.resolveProvider(providerName).sessions.fetchHistory(sessionId, options);
44
- },
45
- };
1
+ import { providerRegistry } from '@/modules/providers/provider.registry.js';
2
+ import type {
3
+ FetchHistoryOptions,
4
+ FetchHistoryResult,
5
+ LLMProvider,
6
+ NormalizedMessage,
7
+ } from '@/shared/types.js';
8
+
9
+ /**
10
+ * Application service for provider-backed session message operations.
11
+ *
12
+ * Callers pass a provider id and this service resolves the concrete provider
13
+ * class, keeping normalization/history call sites decoupled from implementation
14
+ * file layout.
15
+ */
16
+ export const sessionsService = {
17
+ /**
18
+ * Lists provider ids that can load session history and normalize live messages.
19
+ */
20
+ listProviderIds(): LLMProvider[] {
21
+ return providerRegistry.listProviders().map((provider) => provider.id);
22
+ },
23
+
24
+ /**
25
+ * Normalizes one provider-native event into frontend session message events.
26
+ */
27
+ normalizeMessage(
28
+ providerName: string,
29
+ raw: unknown,
30
+ sessionId: string | null,
31
+ ): NormalizedMessage[] {
32
+ return providerRegistry.resolveProvider(providerName).sessions.normalizeMessage(raw, sessionId);
33
+ },
34
+
35
+ /**
36
+ * Fetches normalized persisted session history for one provider/session pair.
37
+ */
38
+ fetchHistory(
39
+ providerName: string,
40
+ sessionId: string,
41
+ options?: FetchHistoryOptions,
42
+ ): Promise<FetchHistoryResult> {
43
+ return providerRegistry.resolveProvider(providerName).sessions.fetchHistory(sessionId, options);
44
+ },
45
+ };
@@ -1,20 +1,20 @@
1
- import type { IProvider, IProviderAuth, IProviderMcp, IProviderSessions } from '@/shared/interfaces.js';
2
- import type { LLMProvider } from '@/shared/types.js';
3
-
4
- /**
5
- * Shared provider base.
6
- *
7
- * Concrete providers must expose auth/MCP handlers and implement message
8
- * normalization/history loading because those behaviors depend on native
9
- * SDK/CLI formats.
10
- */
11
- export abstract class AbstractProvider implements IProvider {
12
- readonly id: LLMProvider;
13
- abstract readonly mcp: IProviderMcp;
14
- abstract readonly auth: IProviderAuth;
15
- abstract readonly sessions: IProviderSessions;
16
-
17
- protected constructor(id: LLMProvider) {
18
- this.id = id;
19
- }
20
- }
1
+ import type { IProvider, IProviderAuth, IProviderMcp, IProviderSessions } from '@/shared/interfaces.js';
2
+ import type { LLMProvider } from '@/shared/types.js';
3
+
4
+ /**
5
+ * Shared provider base.
6
+ *
7
+ * Concrete providers must expose auth/MCP handlers and implement message
8
+ * normalization/history loading because those behaviors depend on native
9
+ * SDK/CLI formats.
10
+ */
11
+ export abstract class AbstractProvider implements IProvider {
12
+ readonly id: LLMProvider;
13
+ abstract readonly mcp: IProviderMcp;
14
+ abstract readonly auth: IProviderAuth;
15
+ abstract readonly sessions: IProviderSessions;
16
+
17
+ protected constructor(id: LLMProvider) {
18
+ this.id = id;
19
+ }
20
+ }
@@ -1,151 +1,151 @@
1
- import path from 'node:path';
2
-
3
- import type { IProviderMcp } from '@/shared/interfaces.js';
4
- import type { LLMProvider, McpScope, McpTransport, ProviderMcpServer, UpsertProviderMcpServerInput } from '@/shared/types.js';
5
- import { AppError } from '@/shared/utils.js';
6
-
7
- const resolveWorkspacePath = (workspacePath?: string): string =>
8
- path.resolve(workspacePath ?? process.cwd());
9
-
10
- const normalizeServerName = (name: string): string => {
11
- const normalized = name.trim();
12
- if (!normalized) {
13
- throw new AppError('MCP server name is required.', {
14
- code: 'MCP_SERVER_NAME_REQUIRED',
15
- statusCode: 400,
16
- });
17
- }
18
-
19
- return normalized;
20
- };
21
-
22
- /**
23
- * Shared MCP provider for provider-specific config readers/writers.
24
- */
25
- export abstract class McpProvider implements IProviderMcp {
26
- protected readonly provider: LLMProvider;
27
- protected readonly supportedScopes: McpScope[];
28
- protected readonly supportedTransports: McpTransport[];
29
-
30
- protected constructor(
31
- provider: LLMProvider,
32
- supportedScopes: McpScope[],
33
- supportedTransports: McpTransport[],
34
- ) {
35
- this.provider = provider;
36
- this.supportedScopes = supportedScopes;
37
- this.supportedTransports = supportedTransports;
38
- }
39
-
40
- async listServers(options?: { workspacePath?: string }): Promise<Record<McpScope, ProviderMcpServer[]>> {
41
- const grouped: Record<McpScope, ProviderMcpServer[]> = {
42
- user: [],
43
- local: [],
44
- project: [],
45
- };
46
-
47
- for (const scope of this.supportedScopes) {
48
- grouped[scope] = await this.listServersForScope(scope, options);
49
- }
50
-
51
- return grouped;
52
- }
53
-
54
- async listServersForScope(
55
- scope: McpScope,
56
- options?: { workspacePath?: string },
57
- ): Promise<ProviderMcpServer[]> {
58
- if (!this.supportedScopes.includes(scope)) {
59
- return [];
60
- }
61
-
62
- const workspacePath = resolveWorkspacePath(options?.workspacePath);
63
- const scopedServers = await this.readScopedServers(scope, workspacePath);
64
- return Object.entries(scopedServers)
65
- .map(([name, rawConfig]) => this.normalizeServerConfig(scope, name, rawConfig))
66
- .filter((entry): entry is ProviderMcpServer => entry !== null);
67
- }
68
-
69
- async upsertServer(input: UpsertProviderMcpServerInput): Promise<ProviderMcpServer> {
70
- const scope = input.scope ?? 'project';
71
- this.assertScopeAndTransport(scope, input.transport);
72
-
73
- const workspacePath = resolveWorkspacePath(input.workspacePath);
74
- const normalizedName = normalizeServerName(input.name);
75
- const scopedServers = await this.readScopedServers(scope, workspacePath);
76
- scopedServers[normalizedName] = this.buildServerConfig(input);
77
- await this.writeScopedServers(scope, workspacePath, scopedServers);
78
-
79
- return {
80
- provider: this.provider,
81
- name: normalizedName,
82
- scope,
83
- transport: input.transport,
84
- command: input.command,
85
- args: input.args,
86
- env: input.env,
87
- cwd: input.cwd,
88
- url: input.url,
89
- headers: input.headers,
90
- envVars: input.envVars,
91
- bearerTokenEnvVar: input.bearerTokenEnvVar,
92
- envHttpHeaders: input.envHttpHeaders,
93
- };
94
- }
95
-
96
- async removeServer(
97
- input: { name: string; scope?: McpScope; workspacePath?: string },
98
- ): Promise<{ removed: boolean; provider: LLMProvider; name: string; scope: McpScope }> {
99
- const scope = input.scope ?? 'project';
100
- this.assertScope(scope);
101
-
102
- const workspacePath = resolveWorkspacePath(input.workspacePath);
103
- const normalizedName = normalizeServerName(input.name);
104
- const scopedServers = await this.readScopedServers(scope, workspacePath);
105
- const removed = Object.prototype.hasOwnProperty.call(scopedServers, normalizedName);
106
- if (removed) {
107
- delete scopedServers[normalizedName];
108
- await this.writeScopedServers(scope, workspacePath, scopedServers);
109
- }
110
-
111
- return { removed, provider: this.provider, name: normalizedName, scope };
112
- }
113
-
114
- protected abstract readScopedServers(
115
- scope: McpScope,
116
- workspacePath: string,
117
- ): Promise<Record<string, unknown>>;
118
-
119
- protected abstract writeScopedServers(
120
- scope: McpScope,
121
- workspacePath: string,
122
- servers: Record<string, unknown>,
123
- ): Promise<void>;
124
-
125
- protected abstract buildServerConfig(input: UpsertProviderMcpServerInput): Record<string, unknown>;
126
-
127
- protected abstract normalizeServerConfig(
128
- scope: McpScope,
129
- name: string,
130
- rawConfig: unknown,
131
- ): ProviderMcpServer | null;
132
-
133
- protected assertScope(scope: McpScope): void {
134
- if (!this.supportedScopes.includes(scope)) {
135
- throw new AppError(`Provider "${this.provider}" does not support "${scope}" MCP scope.`, {
136
- code: 'MCP_SCOPE_NOT_SUPPORTED',
137
- statusCode: 400,
138
- });
139
- }
140
- }
141
-
142
- protected assertScopeAndTransport(scope: McpScope, transport: McpTransport): void {
143
- this.assertScope(scope);
144
- if (!this.supportedTransports.includes(transport)) {
145
- throw new AppError(`Provider "${this.provider}" does not support "${transport}" MCP transport.`, {
146
- code: 'MCP_TRANSPORT_NOT_SUPPORTED',
147
- statusCode: 400,
148
- });
149
- }
150
- }
151
- }
1
+ import path from 'node:path';
2
+
3
+ import type { IProviderMcp } from '@/shared/interfaces.js';
4
+ import type { LLMProvider, McpScope, McpTransport, ProviderMcpServer, UpsertProviderMcpServerInput } from '@/shared/types.js';
5
+ import { AppError } from '@/shared/utils.js';
6
+
7
+ const resolveWorkspacePath = (workspacePath?: string): string =>
8
+ path.resolve(workspacePath ?? process.cwd());
9
+
10
+ const normalizeServerName = (name: string): string => {
11
+ const normalized = name.trim();
12
+ if (!normalized) {
13
+ throw new AppError('MCP server name is required.', {
14
+ code: 'MCP_SERVER_NAME_REQUIRED',
15
+ statusCode: 400,
16
+ });
17
+ }
18
+
19
+ return normalized;
20
+ };
21
+
22
+ /**
23
+ * Shared MCP provider for provider-specific config readers/writers.
24
+ */
25
+ export abstract class McpProvider implements IProviderMcp {
26
+ protected readonly provider: LLMProvider;
27
+ protected readonly supportedScopes: McpScope[];
28
+ protected readonly supportedTransports: McpTransport[];
29
+
30
+ protected constructor(
31
+ provider: LLMProvider,
32
+ supportedScopes: McpScope[],
33
+ supportedTransports: McpTransport[],
34
+ ) {
35
+ this.provider = provider;
36
+ this.supportedScopes = supportedScopes;
37
+ this.supportedTransports = supportedTransports;
38
+ }
39
+
40
+ async listServers(options?: { workspacePath?: string }): Promise<Record<McpScope, ProviderMcpServer[]>> {
41
+ const grouped: Record<McpScope, ProviderMcpServer[]> = {
42
+ user: [],
43
+ local: [],
44
+ project: [],
45
+ };
46
+
47
+ for (const scope of this.supportedScopes) {
48
+ grouped[scope] = await this.listServersForScope(scope, options);
49
+ }
50
+
51
+ return grouped;
52
+ }
53
+
54
+ async listServersForScope(
55
+ scope: McpScope,
56
+ options?: { workspacePath?: string },
57
+ ): Promise<ProviderMcpServer[]> {
58
+ if (!this.supportedScopes.includes(scope)) {
59
+ return [];
60
+ }
61
+
62
+ const workspacePath = resolveWorkspacePath(options?.workspacePath);
63
+ const scopedServers = await this.readScopedServers(scope, workspacePath);
64
+ return Object.entries(scopedServers)
65
+ .map(([name, rawConfig]) => this.normalizeServerConfig(scope, name, rawConfig))
66
+ .filter((entry): entry is ProviderMcpServer => entry !== null);
67
+ }
68
+
69
+ async upsertServer(input: UpsertProviderMcpServerInput): Promise<ProviderMcpServer> {
70
+ const scope = input.scope ?? 'project';
71
+ this.assertScopeAndTransport(scope, input.transport);
72
+
73
+ const workspacePath = resolveWorkspacePath(input.workspacePath);
74
+ const normalizedName = normalizeServerName(input.name);
75
+ const scopedServers = await this.readScopedServers(scope, workspacePath);
76
+ scopedServers[normalizedName] = this.buildServerConfig(input);
77
+ await this.writeScopedServers(scope, workspacePath, scopedServers);
78
+
79
+ return {
80
+ provider: this.provider,
81
+ name: normalizedName,
82
+ scope,
83
+ transport: input.transport,
84
+ command: input.command,
85
+ args: input.args,
86
+ env: input.env,
87
+ cwd: input.cwd,
88
+ url: input.url,
89
+ headers: input.headers,
90
+ envVars: input.envVars,
91
+ bearerTokenEnvVar: input.bearerTokenEnvVar,
92
+ envHttpHeaders: input.envHttpHeaders,
93
+ };
94
+ }
95
+
96
+ async removeServer(
97
+ input: { name: string; scope?: McpScope; workspacePath?: string },
98
+ ): Promise<{ removed: boolean; provider: LLMProvider; name: string; scope: McpScope }> {
99
+ const scope = input.scope ?? 'project';
100
+ this.assertScope(scope);
101
+
102
+ const workspacePath = resolveWorkspacePath(input.workspacePath);
103
+ const normalizedName = normalizeServerName(input.name);
104
+ const scopedServers = await this.readScopedServers(scope, workspacePath);
105
+ const removed = Object.prototype.hasOwnProperty.call(scopedServers, normalizedName);
106
+ if (removed) {
107
+ delete scopedServers[normalizedName];
108
+ await this.writeScopedServers(scope, workspacePath, scopedServers);
109
+ }
110
+
111
+ return { removed, provider: this.provider, name: normalizedName, scope };
112
+ }
113
+
114
+ protected abstract readScopedServers(
115
+ scope: McpScope,
116
+ workspacePath: string,
117
+ ): Promise<Record<string, unknown>>;
118
+
119
+ protected abstract writeScopedServers(
120
+ scope: McpScope,
121
+ workspacePath: string,
122
+ servers: Record<string, unknown>,
123
+ ): Promise<void>;
124
+
125
+ protected abstract buildServerConfig(input: UpsertProviderMcpServerInput): Record<string, unknown>;
126
+
127
+ protected abstract normalizeServerConfig(
128
+ scope: McpScope,
129
+ name: string,
130
+ rawConfig: unknown,
131
+ ): ProviderMcpServer | null;
132
+
133
+ protected assertScope(scope: McpScope): void {
134
+ if (!this.supportedScopes.includes(scope)) {
135
+ throw new AppError(`Provider "${this.provider}" does not support "${scope}" MCP scope.`, {
136
+ code: 'MCP_SCOPE_NOT_SUPPORTED',
137
+ statusCode: 400,
138
+ });
139
+ }
140
+ }
141
+
142
+ protected assertScopeAndTransport(scope: McpScope, transport: McpTransport): void {
143
+ this.assertScope(scope);
144
+ if (!this.supportedTransports.includes(transport)) {
145
+ throw new AppError(`Provider "${this.provider}" does not support "${transport}" MCP transport.`, {
146
+ code: 'MCP_TRANSPORT_NOT_SUPPORTED',
147
+ statusCode: 400,
148
+ });
149
+ }
150
+ }
151
+ }