@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,226 +1,226 @@
1
- import { promises as fs } from 'fs';
2
- import path from 'path';
3
- import os from 'os';
4
-
5
- class SessionManager {
6
- constructor() {
7
- // Store sessions in memory with conversation history
8
- this.sessions = new Map();
9
- this.maxSessions = 100;
10
- this.sessionsDir = path.join(os.homedir(), '.gemini', 'sessions');
11
- this.ready = this.init();
12
- }
13
-
14
- async init() {
15
- await this.initSessionsDir();
16
- await this.loadSessions();
17
- }
18
-
19
- async initSessionsDir() {
20
- try {
21
- await fs.mkdir(this.sessionsDir, { recursive: true });
22
- } catch (error) {
23
- // console.error('Error creating sessions directory:', error);
24
- }
25
- }
26
-
27
- // Create a new session
28
- createSession(sessionId, projectPath) {
29
- const session = {
30
- id: sessionId,
31
- projectPath: projectPath,
32
- messages: [],
33
- createdAt: new Date(),
34
- lastActivity: new Date()
35
- };
36
-
37
- // Evict oldest session from memory if we exceed limit
38
- if (this.sessions.size >= this.maxSessions) {
39
- const oldestKey = this.sessions.keys().next().value;
40
- if (oldestKey) this.sessions.delete(oldestKey);
41
- }
42
-
43
- this.sessions.set(sessionId, session);
44
- this.saveSession(sessionId);
45
-
46
- return session;
47
- }
48
-
49
- // Add a message to session
50
- addMessage(sessionId, role, content) {
51
- let session = this.sessions.get(sessionId);
52
-
53
- if (!session) {
54
- // Create session if it doesn't exist
55
- session = this.createSession(sessionId, '');
56
- }
57
-
58
- const message = {
59
- role: role, // 'user' or 'assistant'
60
- content: content,
61
- timestamp: new Date()
62
- };
63
-
64
- session.messages.push(message);
65
- session.lastActivity = new Date();
66
-
67
- this.saveSession(sessionId);
68
-
69
- return session;
70
- }
71
-
72
- // Get session by ID
73
- getSession(sessionId) {
74
- return this.sessions.get(sessionId);
75
- }
76
-
77
- // Get all sessions for a project
78
- getProjectSessions(projectPath) {
79
- const sessions = [];
80
-
81
- for (const [id, session] of this.sessions) {
82
- if (session.projectPath === projectPath) {
83
- sessions.push({
84
- id: session.id,
85
- summary: this.getSessionSummary(session),
86
- messageCount: session.messages.length,
87
- lastActivity: session.lastActivity
88
- });
89
- }
90
- }
91
-
92
- return sessions.sort((a, b) =>
93
- new Date(b.lastActivity) - new Date(a.lastActivity)
94
- );
95
- }
96
-
97
- // Get session summary
98
- getSessionSummary(session) {
99
- if (session.messages.length === 0) {
100
- return 'New Session';
101
- }
102
-
103
- // Find first user message
104
- const firstUserMessage = session.messages.find(m => m.role === 'user');
105
- if (firstUserMessage) {
106
- const content = firstUserMessage.content;
107
- return content.length > 50 ? content.substring(0, 50) + '...' : content;
108
- }
109
-
110
- return 'New Session';
111
- }
112
-
113
- // Build conversation context for Gemini
114
- buildConversationContext(sessionId, maxMessages = 10) {
115
- const session = this.sessions.get(sessionId);
116
-
117
- if (!session || session.messages.length === 0) {
118
- return '';
119
- }
120
-
121
- // Get last N messages for context
122
- const recentMessages = session.messages.slice(-maxMessages);
123
-
124
- let context = 'Here is the conversation history:\n\n';
125
-
126
- for (const msg of recentMessages) {
127
- if (msg.role === 'user') {
128
- context += `User: ${msg.content}\n`;
129
- } else {
130
- context += `Assistant: ${msg.content}\n`;
131
- }
132
- }
133
-
134
- context += '\nBased on the conversation history above, please answer the following:\n';
135
-
136
- return context;
137
- }
138
-
139
- // Prevent path traversal
140
- _safeFilePath(sessionId) {
141
- const safeId = String(sessionId).replace(/[/\\]|\.\./g, '');
142
- return path.join(this.sessionsDir, `${safeId}.json`);
143
- }
144
-
145
- // Save session to disk
146
- async saveSession(sessionId) {
147
- const session = this.sessions.get(sessionId);
148
- if (!session) return;
149
-
150
- try {
151
- const filePath = this._safeFilePath(sessionId);
152
- await fs.writeFile(filePath, JSON.stringify(session, null, 2));
153
- } catch (error) {
154
- // console.error('Error saving session:', error);
155
- }
156
- }
157
-
158
- // Load sessions from disk
159
- async loadSessions() {
160
- try {
161
- const files = await fs.readdir(this.sessionsDir);
162
-
163
- for (const file of files) {
164
- if (file.endsWith('.json')) {
165
- try {
166
- const filePath = path.join(this.sessionsDir, file);
167
- const data = await fs.readFile(filePath, 'utf8');
168
- const session = JSON.parse(data);
169
-
170
- // Convert dates
171
- session.createdAt = new Date(session.createdAt);
172
- session.lastActivity = new Date(session.lastActivity);
173
- session.messages.forEach(msg => {
174
- msg.timestamp = new Date(msg.timestamp);
175
- });
176
-
177
- this.sessions.set(session.id, session);
178
- } catch (error) {
179
- // console.error(`Error loading session ${file}:`, error);
180
- }
181
- }
182
- }
183
-
184
- // Enforce eviction after loading to prevent massive memory usage
185
- while (this.sessions.size > this.maxSessions) {
186
- const oldestKey = this.sessions.keys().next().value;
187
- if (oldestKey) this.sessions.delete(oldestKey);
188
- }
189
- } catch (error) {
190
- // console.error('Error loading sessions:', error);
191
- }
192
- }
193
-
194
- // Delete a session
195
- async deleteSession(sessionId) {
196
- this.sessions.delete(sessionId);
197
-
198
- try {
199
- const filePath = this._safeFilePath(sessionId);
200
- await fs.unlink(filePath);
201
- } catch (error) {
202
- // console.error('Error deleting session file:', error);
203
- }
204
- }
205
-
206
- // Get session messages for display
207
- getSessionMessages(sessionId) {
208
- const session = this.sessions.get(sessionId);
209
- if (!session) return [];
210
-
211
- return session.messages.map(msg => ({
212
- type: 'message',
213
- message: {
214
- role: msg.role,
215
- content: msg.content
216
- },
217
- timestamp: msg.timestamp.toISOString()
218
- }));
219
- }
220
- }
221
-
222
- // Singleton instance
223
- const sessionManager = new SessionManager();
224
-
225
- export const ready = sessionManager.ready;
1
+ import { promises as fs } from 'fs';
2
+ import path from 'path';
3
+ import os from 'os';
4
+
5
+ class SessionManager {
6
+ constructor() {
7
+ // Store sessions in memory with conversation history
8
+ this.sessions = new Map();
9
+ this.maxSessions = 100;
10
+ this.sessionsDir = path.join(os.homedir(), '.gemini', 'sessions');
11
+ this.ready = this.init();
12
+ }
13
+
14
+ async init() {
15
+ await this.initSessionsDir();
16
+ await this.loadSessions();
17
+ }
18
+
19
+ async initSessionsDir() {
20
+ try {
21
+ await fs.mkdir(this.sessionsDir, { recursive: true });
22
+ } catch (error) {
23
+ // console.error('Error creating sessions directory:', error);
24
+ }
25
+ }
26
+
27
+ // Create a new session
28
+ createSession(sessionId, projectPath) {
29
+ const session = {
30
+ id: sessionId,
31
+ projectPath: projectPath,
32
+ messages: [],
33
+ createdAt: new Date(),
34
+ lastActivity: new Date()
35
+ };
36
+
37
+ // Evict oldest session from memory if we exceed limit
38
+ if (this.sessions.size >= this.maxSessions) {
39
+ const oldestKey = this.sessions.keys().next().value;
40
+ if (oldestKey) this.sessions.delete(oldestKey);
41
+ }
42
+
43
+ this.sessions.set(sessionId, session);
44
+ this.saveSession(sessionId);
45
+
46
+ return session;
47
+ }
48
+
49
+ // Add a message to session
50
+ addMessage(sessionId, role, content) {
51
+ let session = this.sessions.get(sessionId);
52
+
53
+ if (!session) {
54
+ // Create session if it doesn't exist
55
+ session = this.createSession(sessionId, '');
56
+ }
57
+
58
+ const message = {
59
+ role: role, // 'user' or 'assistant'
60
+ content: content,
61
+ timestamp: new Date()
62
+ };
63
+
64
+ session.messages.push(message);
65
+ session.lastActivity = new Date();
66
+
67
+ this.saveSession(sessionId);
68
+
69
+ return session;
70
+ }
71
+
72
+ // Get session by ID
73
+ getSession(sessionId) {
74
+ return this.sessions.get(sessionId);
75
+ }
76
+
77
+ // Get all sessions for a project
78
+ getProjectSessions(projectPath) {
79
+ const sessions = [];
80
+
81
+ for (const [id, session] of this.sessions) {
82
+ if (session.projectPath === projectPath) {
83
+ sessions.push({
84
+ id: session.id,
85
+ summary: this.getSessionSummary(session),
86
+ messageCount: session.messages.length,
87
+ lastActivity: session.lastActivity
88
+ });
89
+ }
90
+ }
91
+
92
+ return sessions.sort((a, b) =>
93
+ new Date(b.lastActivity) - new Date(a.lastActivity)
94
+ );
95
+ }
96
+
97
+ // Get session summary
98
+ getSessionSummary(session) {
99
+ if (session.messages.length === 0) {
100
+ return 'New Session';
101
+ }
102
+
103
+ // Find first user message
104
+ const firstUserMessage = session.messages.find(m => m.role === 'user');
105
+ if (firstUserMessage) {
106
+ const content = firstUserMessage.content;
107
+ return content.length > 50 ? content.substring(0, 50) + '...' : content;
108
+ }
109
+
110
+ return 'New Session';
111
+ }
112
+
113
+ // Build conversation context for Gemini
114
+ buildConversationContext(sessionId, maxMessages = 10) {
115
+ const session = this.sessions.get(sessionId);
116
+
117
+ if (!session || session.messages.length === 0) {
118
+ return '';
119
+ }
120
+
121
+ // Get last N messages for context
122
+ const recentMessages = session.messages.slice(-maxMessages);
123
+
124
+ let context = 'Here is the conversation history:\n\n';
125
+
126
+ for (const msg of recentMessages) {
127
+ if (msg.role === 'user') {
128
+ context += `User: ${msg.content}\n`;
129
+ } else {
130
+ context += `Assistant: ${msg.content}\n`;
131
+ }
132
+ }
133
+
134
+ context += '\nBased on the conversation history above, please answer the following:\n';
135
+
136
+ return context;
137
+ }
138
+
139
+ // Prevent path traversal
140
+ _safeFilePath(sessionId) {
141
+ const safeId = String(sessionId).replace(/[/\\]|\.\./g, '');
142
+ return path.join(this.sessionsDir, `${safeId}.json`);
143
+ }
144
+
145
+ // Save session to disk
146
+ async saveSession(sessionId) {
147
+ const session = this.sessions.get(sessionId);
148
+ if (!session) return;
149
+
150
+ try {
151
+ const filePath = this._safeFilePath(sessionId);
152
+ await fs.writeFile(filePath, JSON.stringify(session, null, 2));
153
+ } catch (error) {
154
+ // console.error('Error saving session:', error);
155
+ }
156
+ }
157
+
158
+ // Load sessions from disk
159
+ async loadSessions() {
160
+ try {
161
+ const files = await fs.readdir(this.sessionsDir);
162
+
163
+ for (const file of files) {
164
+ if (file.endsWith('.json')) {
165
+ try {
166
+ const filePath = path.join(this.sessionsDir, file);
167
+ const data = await fs.readFile(filePath, 'utf8');
168
+ const session = JSON.parse(data);
169
+
170
+ // Convert dates
171
+ session.createdAt = new Date(session.createdAt);
172
+ session.lastActivity = new Date(session.lastActivity);
173
+ session.messages.forEach(msg => {
174
+ msg.timestamp = new Date(msg.timestamp);
175
+ });
176
+
177
+ this.sessions.set(session.id, session);
178
+ } catch (error) {
179
+ // console.error(`Error loading session ${file}:`, error);
180
+ }
181
+ }
182
+ }
183
+
184
+ // Enforce eviction after loading to prevent massive memory usage
185
+ while (this.sessions.size > this.maxSessions) {
186
+ const oldestKey = this.sessions.keys().next().value;
187
+ if (oldestKey) this.sessions.delete(oldestKey);
188
+ }
189
+ } catch (error) {
190
+ // console.error('Error loading sessions:', error);
191
+ }
192
+ }
193
+
194
+ // Delete a session
195
+ async deleteSession(sessionId) {
196
+ this.sessions.delete(sessionId);
197
+
198
+ try {
199
+ const filePath = this._safeFilePath(sessionId);
200
+ await fs.unlink(filePath);
201
+ } catch (error) {
202
+ // console.error('Error deleting session file:', error);
203
+ }
204
+ }
205
+
206
+ // Get session messages for display
207
+ getSessionMessages(sessionId) {
208
+ const session = this.sessions.get(sessionId);
209
+ if (!session) return [];
210
+
211
+ return session.messages.map(msg => ({
212
+ type: 'message',
213
+ message: {
214
+ role: msg.role,
215
+ content: msg.content
216
+ },
217
+ timestamp: msg.timestamp.toISOString()
218
+ }));
219
+ }
220
+ }
221
+
222
+ // Singleton instance
223
+ const sessionManager = new SessionManager();
224
+
225
+ export const ready = sessionManager.ready;
226
226
  export default sessionManager;
@@ -1,54 +1,54 @@
1
- import type {
2
- FetchHistoryOptions,
3
- FetchHistoryResult,
4
- LLMProvider,
5
- McpScope,
6
- NormalizedMessage,
7
- ProviderAuthStatus,
8
- ProviderMcpServer,
9
- UpsertProviderMcpServerInput,
10
- } from '@/shared/types.js';
11
-
12
- /**
13
- * Main provider contract for CLI and SDK integrations.
14
- *
15
- * Each concrete provider owns its MCP/auth handlers plus the provider-specific
16
- * logic for converting native events/history into the app's normalized shape.
17
- */
18
- export interface IProvider {
19
- readonly id: LLMProvider;
20
- readonly mcp: IProviderMcp;
21
- readonly auth: IProviderAuth;
22
- readonly sessions: IProviderSessions;
23
- }
24
-
25
-
26
- /**
27
- * Auth contract for one provider.
28
- */
29
- export interface IProviderAuth {
30
- /**
31
- * Checks whether the provider is installed and has usable credentials.
32
- */
33
- getStatus(): Promise<ProviderAuthStatus>;
34
- }
35
-
36
- /**
37
- * MCP contract for one provider.
38
- */
39
- export interface IProviderMcp {
40
- listServers(options?: { workspacePath?: string }): Promise<Record<McpScope, ProviderMcpServer[]>>;
41
- listServersForScope(scope: McpScope, options?: { workspacePath?: string }): Promise<ProviderMcpServer[]>;
42
- upsertServer(input: UpsertProviderMcpServerInput): Promise<ProviderMcpServer>;
43
- removeServer(
44
- input: { name: string; scope?: McpScope; workspacePath?: string },
45
- ): Promise<{ removed: boolean; provider: LLMProvider; name: string; scope: McpScope }>;
46
- }
47
-
48
- /**
49
- * Session/history contract for one provider.
50
- */
51
- export interface IProviderSessions {
52
- normalizeMessage(raw: unknown, sessionId: string | null): NormalizedMessage[];
53
- fetchHistory(sessionId: string, options?: FetchHistoryOptions): Promise<FetchHistoryResult>;
54
- }
1
+ import type {
2
+ FetchHistoryOptions,
3
+ FetchHistoryResult,
4
+ LLMProvider,
5
+ McpScope,
6
+ NormalizedMessage,
7
+ ProviderAuthStatus,
8
+ ProviderMcpServer,
9
+ UpsertProviderMcpServerInput,
10
+ } from '@/shared/types.js';
11
+
12
+ /**
13
+ * Main provider contract for CLI and SDK integrations.
14
+ *
15
+ * Each concrete provider owns its MCP/auth handlers plus the provider-specific
16
+ * logic for converting native events/history into the app's normalized shape.
17
+ */
18
+ export interface IProvider {
19
+ readonly id: LLMProvider;
20
+ readonly mcp: IProviderMcp;
21
+ readonly auth: IProviderAuth;
22
+ readonly sessions: IProviderSessions;
23
+ }
24
+
25
+
26
+ /**
27
+ * Auth contract for one provider.
28
+ */
29
+ export interface IProviderAuth {
30
+ /**
31
+ * Checks whether the provider is installed and has usable credentials.
32
+ */
33
+ getStatus(): Promise<ProviderAuthStatus>;
34
+ }
35
+
36
+ /**
37
+ * MCP contract for one provider.
38
+ */
39
+ export interface IProviderMcp {
40
+ listServers(options?: { workspacePath?: string }): Promise<Record<McpScope, ProviderMcpServer[]>>;
41
+ listServersForScope(scope: McpScope, options?: { workspacePath?: string }): Promise<ProviderMcpServer[]>;
42
+ upsertServer(input: UpsertProviderMcpServerInput): Promise<ProviderMcpServer>;
43
+ removeServer(
44
+ input: { name: string; scope?: McpScope; workspacePath?: string },
45
+ ): Promise<{ removed: boolean; provider: LLMProvider; name: string; scope: McpScope }>;
46
+ }
47
+
48
+ /**
49
+ * Session/history contract for one provider.
50
+ */
51
+ export interface IProviderSessions {
52
+ normalizeMessage(raw: unknown, sessionId: string | null): NormalizedMessage[];
53
+ fetchHistory(sessionId: string, options?: FetchHistoryOptions): Promise<FetchHistoryResult>;
54
+ }