@pixelbyte-software/pixcode 1.35.2 → 1.35.3

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