@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,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
+ }