memorix 1.4.3 → 1.4.5

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 (158) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +20 -6
  3. package/README.zh-CN.md +16 -3
  4. package/TEAM.md +86 -86
  5. package/assets/star-history-dark.svg +8 -8
  6. package/assets/star-history-light.svg +8 -8
  7. package/assets/star-history.json +16 -2
  8. package/dist/cli/index.js +539 -233
  9. package/dist/cli/memcode.js +0 -0
  10. package/dist/index.js +72 -15
  11. package/dist/maintenance-runner.js +9 -7
  12. package/dist/media-audio-runner.js +9 -7
  13. package/dist/media-video-runner.js +9 -7
  14. package/dist/memcode/index.js +9 -7
  15. package/dist/memcode-runtime/CHANGELOG.md +34 -0
  16. package/dist/sdk.js +71 -14
  17. package/dist/types.d.ts +1 -1
  18. package/dist/vector-backfill-runner.js +9 -7
  19. package/docs/AGENT_OPERATOR_PLAYBOOK.md +6 -5
  20. package/docs/API_REFERENCE.md +9 -5
  21. package/docs/CONFIGURATION.md +15 -5
  22. package/docs/DESIGN_DECISIONS.md +357 -357
  23. package/docs/DEVELOPMENT.md +2 -2
  24. package/docs/INTEGRATIONS.md +9 -2
  25. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +4 -3
  26. package/docs/MEMCODE.md +1 -1
  27. package/docs/MODULES.md +1 -1
  28. package/docs/README.md +1 -1
  29. package/docs/SETUP.md +12 -4
  30. package/docs/hooks-architecture.md +2 -1
  31. package/llms-full.txt +7 -6
  32. package/llms.txt +2 -2
  33. package/package.json +1 -1
  34. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  35. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  36. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  37. package/plugins/copilot/memorix/plugin.json +1 -1
  38. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  39. package/plugins/omp/memorix/package.json +1 -1
  40. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  41. package/plugins/pi/memorix/package.json +1 -1
  42. package/server.json +2 -2
  43. package/src/audit/index.ts +156 -156
  44. package/src/cli/commands/agent-integrations.ts +7 -1
  45. package/src/cli/commands/audit-list.ts +89 -89
  46. package/src/cli/commands/formation.ts +48 -48
  47. package/src/cli/commands/git-hook-install.ts +111 -111
  48. package/src/cli/commands/handoff.ts +54 -54
  49. package/src/cli/commands/hooks-install.ts +2 -0
  50. package/src/cli/commands/hooks-preview.ts +5 -0
  51. package/src/cli/commands/hooks-status.ts +63 -63
  52. package/src/cli/commands/ingest.ts +44 -44
  53. package/src/cli/commands/integrate-shared.ts +15 -15
  54. package/src/cli/commands/integrate.ts +2 -0
  55. package/src/cli/commands/lock.ts +82 -82
  56. package/src/cli/commands/media-image.ts +27 -0
  57. package/src/cli/commands/media.ts +8 -1
  58. package/src/cli/commands/memory.ts +44 -34
  59. package/src/cli/commands/message.ts +104 -104
  60. package/src/cli/commands/operator-shared.ts +62 -18
  61. package/src/cli/commands/poll.ts +58 -58
  62. package/src/cli/commands/purge-all-memory.ts +85 -85
  63. package/src/cli/commands/purge-project-memory.ts +83 -83
  64. package/src/cli/commands/reasoning.ts +118 -118
  65. package/src/cli/commands/setup.ts +57 -2
  66. package/src/cli/commands/skills.ts +114 -114
  67. package/src/cli/commands/task.ts +167 -167
  68. package/src/cli/commands/transfer.ts +47 -47
  69. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  70. package/src/cli/commands/uninstall.ts +20 -0
  71. package/src/cli/tui/ChatView.tsx +234 -234
  72. package/src/cli/tui/CommandBar.tsx +312 -312
  73. package/src/cli/tui/ContextRail.tsx +118 -118
  74. package/src/cli/tui/HeaderBar.tsx +72 -72
  75. package/src/cli/tui/LogoBanner.tsx +51 -51
  76. package/src/cli/tui/Sidebar.tsx +179 -179
  77. package/src/cli/tui/index.ts +41 -41
  78. package/src/cli/tui/markdown-render.tsx +371 -371
  79. package/src/cli/tui/use-mouse.ts +157 -157
  80. package/src/cli/tui/useNavigation.ts +56 -56
  81. package/src/cli/version.ts +7 -7
  82. package/src/cli/workbench.ts +1 -1
  83. package/src/dashboard/project-classification.ts +64 -64
  84. package/src/git/hooks-path.ts +85 -85
  85. package/src/hooks/installers/index.ts +43 -2
  86. package/src/hooks/pattern-detector.ts +173 -173
  87. package/src/hooks/significance-filter.ts +250 -250
  88. package/src/hooks/types.ts +2 -0
  89. package/src/integrations/registry.ts +9 -0
  90. package/src/llm/memory-manager.ts +328 -328
  91. package/src/llm/provider.ts +885 -885
  92. package/src/llm/quality.ts +248 -248
  93. package/src/media/minimax.ts +9 -1
  94. package/src/memory/attribution-guard.ts +249 -249
  95. package/src/memory/disclosure-policy.ts +135 -135
  96. package/src/memory/entity-extractor.ts +197 -197
  97. package/src/memory/formation/evaluate.ts +217 -217
  98. package/src/memory/formation/extract.ts +361 -361
  99. package/src/memory/formation/index.ts +417 -417
  100. package/src/memory/formation/resolve.ts +344 -344
  101. package/src/memory/formation/types.ts +315 -315
  102. package/src/memory/freshness.ts +122 -122
  103. package/src/memory/graph.ts +197 -197
  104. package/src/memory/refs.ts +94 -94
  105. package/src/memory/secret-filter.ts +79 -79
  106. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  107. package/src/orchestrate/adapters/claude.ts +111 -111
  108. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  109. package/src/orchestrate/adapters/codex.ts +41 -41
  110. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  111. package/src/orchestrate/adapters/gemini.ts +42 -42
  112. package/src/orchestrate/adapters/index.ts +73 -73
  113. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  114. package/src/orchestrate/adapters/opencode.ts +47 -47
  115. package/src/orchestrate/adapters/types.ts +77 -77
  116. package/src/orchestrate/capability-router.ts +284 -284
  117. package/src/orchestrate/context-compact.ts +188 -188
  118. package/src/orchestrate/cost-tracker.ts +219 -219
  119. package/src/orchestrate/error-recovery.ts +191 -191
  120. package/src/orchestrate/evidence.ts +140 -140
  121. package/src/orchestrate/ledger.ts +110 -110
  122. package/src/orchestrate/memorix-bridge.ts +343 -343
  123. package/src/orchestrate/output-budget.ts +80 -80
  124. package/src/orchestrate/permission.ts +152 -152
  125. package/src/orchestrate/pipeline-trace.ts +131 -131
  126. package/src/orchestrate/prompt-builder.ts +155 -155
  127. package/src/orchestrate/ring-buffer.ts +37 -37
  128. package/src/orchestrate/task-graph.ts +389 -389
  129. package/src/project/aliases.ts +374 -374
  130. package/src/rules/adapters/trae.ts +56 -56
  131. package/src/rules/syncer.ts +235 -235
  132. package/src/search/query-expansion.ts +52 -52
  133. package/src/server/formation-timeout.ts +27 -27
  134. package/src/server.ts +23 -1
  135. package/src/skills/mini-skills.ts +386 -386
  136. package/src/store/chat-store.ts +119 -119
  137. package/src/store/graph-store.ts +249 -249
  138. package/src/store/mini-skill-store.ts +349 -349
  139. package/src/store/persistence-json.ts +212 -212
  140. package/src/store/persistence.ts +291 -291
  141. package/src/store/project-affinity.ts +195 -195
  142. package/src/team/event-bus.ts +76 -76
  143. package/src/team/file-locks.ts +173 -173
  144. package/src/team/handoff.ts +161 -161
  145. package/src/team/messages.ts +203 -203
  146. package/src/team/poll.ts +132 -132
  147. package/src/team/tasks.ts +211 -211
  148. package/src/types.ts +1 -1
  149. package/src/workspace/mcp-adapters/codex.ts +191 -191
  150. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  151. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  152. package/src/workspace/mcp-adapters/dsh.ts +147 -0
  153. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  154. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  155. package/src/workspace/mcp-adapters/trae.ts +134 -134
  156. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  157. package/src/workspace/sanitizer.ts +60 -60
  158. package/dist/memcode-runtime/docs/images/exy.png +0 -0
@@ -1,191 +1,191 @@
1
- import type { MCPConfigAdapter, MCPServerEntry } from '../../types.js';
2
- import { homedir } from 'node:os';
3
- import { join } from 'node:path';
4
-
5
- /**
6
- * Codex MCP config adapter.
7
- * Format: TOML file at ~/.codex/config.toml or .codex/config.toml (project-level)
8
- *
9
- * Structure:
10
- * [mcp_servers.<name>]
11
- * command = "npx"
12
- * args = ["-y", "memorix-mcp"]
13
- * url = "https://..." # for HTTP servers
14
- *
15
- * [mcp_servers.<name>.env]
16
- * KEY = "value"
17
- *
18
- * We implement a lightweight TOML parser (no external deps) sufficient
19
- * for MCP server config blocks. This avoids adding a TOML dependency.
20
- */
21
- export class CodexMCPAdapter implements MCPConfigAdapter {
22
- readonly source = 'codex' as const;
23
-
24
- parse(content: string): MCPServerEntry[] {
25
- if (!content.trim()) return [];
26
-
27
- const servers: MCPServerEntry[] = [];
28
- const lines = content.split('\n');
29
-
30
- let currentServer: string | null = null;
31
- let isEnvBlock = false;
32
- const serverMap = new Map<
33
- string,
34
- { command: string; args: string[]; env: Record<string, string>; url?: string; enabled?: boolean }
35
- >();
36
-
37
- for (const rawLine of lines) {
38
- const line = rawLine.trim();
39
-
40
- // Skip comments and empty lines
41
- if (!line || line.startsWith('#')) continue;
42
-
43
- // Match [mcp_servers.<name>.env]
44
- const envMatch = line.match(/^\[mcp_servers\.([^.\]]+)\.env\]$/);
45
- if (envMatch) {
46
- currentServer = envMatch[1];
47
- isEnvBlock = true;
48
- if (!serverMap.has(currentServer)) {
49
- serverMap.set(currentServer, { command: '', args: [], env: {} });
50
- }
51
- continue;
52
- }
53
-
54
- // Match [mcp_servers.<name>]
55
- const serverMatch = line.match(/^\[mcp_servers\.([^.\]]+)\]$/);
56
- if (serverMatch) {
57
- currentServer = serverMatch[1];
58
- isEnvBlock = false;
59
- if (!serverMap.has(currentServer)) {
60
- serverMap.set(currentServer, { command: '', args: [], env: {} });
61
- }
62
- continue;
63
- }
64
-
65
- // Any other section header resets context
66
- if (line.startsWith('[')) {
67
- currentServer = null;
68
- isEnvBlock = false;
69
- continue;
70
- }
71
-
72
- // Parse key = value within current server block
73
- if (currentServer) {
74
- const kvMatch = line.match(/^(\w+)\s*=\s*(.+)$/);
75
- if (!kvMatch) continue;
76
-
77
- const key = kvMatch[1];
78
- const rawValue = kvMatch[2].trim();
79
- const entry = serverMap.get(currentServer)!;
80
-
81
- if (isEnvBlock) {
82
- entry.env[key] = this.parseTomlString(rawValue);
83
- } else if (key === 'command') {
84
- entry.command = this.parseTomlString(rawValue);
85
- } else if (key === 'args') {
86
- entry.args = this.parseTomlArray(rawValue);
87
- } else if (key === 'url') {
88
- entry.url = this.parseTomlString(rawValue);
89
- } else if (key === 'enabled') {
90
- entry.enabled = rawValue === 'true';
91
- }
92
- }
93
- }
94
-
95
- for (const [name, entry] of serverMap) {
96
- servers.push({
97
- name,
98
- command: entry.command,
99
- args: entry.args,
100
- ...(Object.keys(entry.env).length > 0 ? { env: entry.env } : {}),
101
- ...(entry.url ? { url: entry.url } : {}),
102
- });
103
- }
104
-
105
- return servers;
106
- }
107
-
108
- generate(servers: MCPServerEntry[]): string {
109
- const blocks: string[] = [];
110
-
111
- for (const s of servers) {
112
- const lines: string[] = [];
113
- lines.push(`[mcp_servers.${s.name}]`);
114
-
115
- if (s.url) {
116
- lines.push(`url = ${this.toTomlString(s.url)}`);
117
- } else {
118
- lines.push(`command = ${this.toTomlString(s.command)}`);
119
- lines.push(`args = [${s.args.map((a) => this.toTomlString(a)).join(', ')}]`);
120
- }
121
-
122
- if (s.env && Object.keys(s.env).length > 0) {
123
- lines.push('');
124
- lines.push(`[mcp_servers.${s.name}.env]`);
125
- for (const [key, value] of Object.entries(s.env)) {
126
- lines.push(`${key} = ${this.toTomlString(value)}`);
127
- }
128
- }
129
-
130
- blocks.push(lines.join('\n'));
131
- }
132
-
133
- return blocks.join('\n\n') + '\n';
134
- }
135
-
136
- getConfigPath(projectRoot?: string): string {
137
- if (projectRoot) {
138
- return join(projectRoot, '.codex', 'config.toml');
139
- }
140
- return join(homedir(), '.codex', 'config.toml');
141
- }
142
-
143
- // ---- TOML helpers ----
144
-
145
- private parseTomlString(raw: string): string {
146
- const trimmed = raw.trim();
147
- if (
148
- (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
149
- (trimmed.startsWith("'") && trimmed.endsWith("'"))
150
- ) {
151
- return trimmed.slice(1, -1);
152
- }
153
- return trimmed;
154
- }
155
-
156
- private parseTomlArray(raw: string): string[] {
157
- const trimmed = raw.trim();
158
- if (!trimmed.startsWith('[') || !trimmed.endsWith(']')) return [];
159
- const inner = trimmed.slice(1, -1);
160
- const result: string[] = [];
161
- // Simple CSV parse respecting quotes
162
- let current = '';
163
- let inQuote = false;
164
- let quoteChar = '';
165
- for (const ch of inner) {
166
- if (inQuote) {
167
- if (ch === quoteChar) {
168
- inQuote = false;
169
- } else {
170
- current += ch;
171
- }
172
- } else if (ch === '"' || ch === "'") {
173
- inQuote = true;
174
- quoteChar = ch;
175
- } else if (ch === ',') {
176
- const val = current.trim();
177
- if (val) result.push(val);
178
- current = '';
179
- } else {
180
- current += ch;
181
- }
182
- }
183
- const last = current.trim();
184
- if (last) result.push(last);
185
- return result;
186
- }
187
-
188
- private toTomlString(value: string): string {
189
- return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
190
- }
191
- }
1
+ import type { MCPConfigAdapter, MCPServerEntry } from '../../types.js';
2
+ import { homedir } from 'node:os';
3
+ import { join } from 'node:path';
4
+
5
+ /**
6
+ * Codex MCP config adapter.
7
+ * Format: TOML file at ~/.codex/config.toml or .codex/config.toml (project-level)
8
+ *
9
+ * Structure:
10
+ * [mcp_servers.<name>]
11
+ * command = "npx"
12
+ * args = ["-y", "memorix-mcp"]
13
+ * url = "https://..." # for HTTP servers
14
+ *
15
+ * [mcp_servers.<name>.env]
16
+ * KEY = "value"
17
+ *
18
+ * We implement a lightweight TOML parser (no external deps) sufficient
19
+ * for MCP server config blocks. This avoids adding a TOML dependency.
20
+ */
21
+ export class CodexMCPAdapter implements MCPConfigAdapter {
22
+ readonly source = 'codex' as const;
23
+
24
+ parse(content: string): MCPServerEntry[] {
25
+ if (!content.trim()) return [];
26
+
27
+ const servers: MCPServerEntry[] = [];
28
+ const lines = content.split('\n');
29
+
30
+ let currentServer: string | null = null;
31
+ let isEnvBlock = false;
32
+ const serverMap = new Map<
33
+ string,
34
+ { command: string; args: string[]; env: Record<string, string>; url?: string; enabled?: boolean }
35
+ >();
36
+
37
+ for (const rawLine of lines) {
38
+ const line = rawLine.trim();
39
+
40
+ // Skip comments and empty lines
41
+ if (!line || line.startsWith('#')) continue;
42
+
43
+ // Match [mcp_servers.<name>.env]
44
+ const envMatch = line.match(/^\[mcp_servers\.([^.\]]+)\.env\]$/);
45
+ if (envMatch) {
46
+ currentServer = envMatch[1];
47
+ isEnvBlock = true;
48
+ if (!serverMap.has(currentServer)) {
49
+ serverMap.set(currentServer, { command: '', args: [], env: {} });
50
+ }
51
+ continue;
52
+ }
53
+
54
+ // Match [mcp_servers.<name>]
55
+ const serverMatch = line.match(/^\[mcp_servers\.([^.\]]+)\]$/);
56
+ if (serverMatch) {
57
+ currentServer = serverMatch[1];
58
+ isEnvBlock = false;
59
+ if (!serverMap.has(currentServer)) {
60
+ serverMap.set(currentServer, { command: '', args: [], env: {} });
61
+ }
62
+ continue;
63
+ }
64
+
65
+ // Any other section header resets context
66
+ if (line.startsWith('[')) {
67
+ currentServer = null;
68
+ isEnvBlock = false;
69
+ continue;
70
+ }
71
+
72
+ // Parse key = value within current server block
73
+ if (currentServer) {
74
+ const kvMatch = line.match(/^(\w+)\s*=\s*(.+)$/);
75
+ if (!kvMatch) continue;
76
+
77
+ const key = kvMatch[1];
78
+ const rawValue = kvMatch[2].trim();
79
+ const entry = serverMap.get(currentServer)!;
80
+
81
+ if (isEnvBlock) {
82
+ entry.env[key] = this.parseTomlString(rawValue);
83
+ } else if (key === 'command') {
84
+ entry.command = this.parseTomlString(rawValue);
85
+ } else if (key === 'args') {
86
+ entry.args = this.parseTomlArray(rawValue);
87
+ } else if (key === 'url') {
88
+ entry.url = this.parseTomlString(rawValue);
89
+ } else if (key === 'enabled') {
90
+ entry.enabled = rawValue === 'true';
91
+ }
92
+ }
93
+ }
94
+
95
+ for (const [name, entry] of serverMap) {
96
+ servers.push({
97
+ name,
98
+ command: entry.command,
99
+ args: entry.args,
100
+ ...(Object.keys(entry.env).length > 0 ? { env: entry.env } : {}),
101
+ ...(entry.url ? { url: entry.url } : {}),
102
+ });
103
+ }
104
+
105
+ return servers;
106
+ }
107
+
108
+ generate(servers: MCPServerEntry[]): string {
109
+ const blocks: string[] = [];
110
+
111
+ for (const s of servers) {
112
+ const lines: string[] = [];
113
+ lines.push(`[mcp_servers.${s.name}]`);
114
+
115
+ if (s.url) {
116
+ lines.push(`url = ${this.toTomlString(s.url)}`);
117
+ } else {
118
+ lines.push(`command = ${this.toTomlString(s.command)}`);
119
+ lines.push(`args = [${s.args.map((a) => this.toTomlString(a)).join(', ')}]`);
120
+ }
121
+
122
+ if (s.env && Object.keys(s.env).length > 0) {
123
+ lines.push('');
124
+ lines.push(`[mcp_servers.${s.name}.env]`);
125
+ for (const [key, value] of Object.entries(s.env)) {
126
+ lines.push(`${key} = ${this.toTomlString(value)}`);
127
+ }
128
+ }
129
+
130
+ blocks.push(lines.join('\n'));
131
+ }
132
+
133
+ return blocks.join('\n\n') + '\n';
134
+ }
135
+
136
+ getConfigPath(projectRoot?: string): string {
137
+ if (projectRoot) {
138
+ return join(projectRoot, '.codex', 'config.toml');
139
+ }
140
+ return join(homedir(), '.codex', 'config.toml');
141
+ }
142
+
143
+ // ---- TOML helpers ----
144
+
145
+ private parseTomlString(raw: string): string {
146
+ const trimmed = raw.trim();
147
+ if (
148
+ (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
149
+ (trimmed.startsWith("'") && trimmed.endsWith("'"))
150
+ ) {
151
+ return trimmed.slice(1, -1);
152
+ }
153
+ return trimmed;
154
+ }
155
+
156
+ private parseTomlArray(raw: string): string[] {
157
+ const trimmed = raw.trim();
158
+ if (!trimmed.startsWith('[') || !trimmed.endsWith(']')) return [];
159
+ const inner = trimmed.slice(1, -1);
160
+ const result: string[] = [];
161
+ // Simple CSV parse respecting quotes
162
+ let current = '';
163
+ let inQuote = false;
164
+ let quoteChar = '';
165
+ for (const ch of inner) {
166
+ if (inQuote) {
167
+ if (ch === quoteChar) {
168
+ inQuote = false;
169
+ } else {
170
+ current += ch;
171
+ }
172
+ } else if (ch === '"' || ch === "'") {
173
+ inQuote = true;
174
+ quoteChar = ch;
175
+ } else if (ch === ',') {
176
+ const val = current.trim();
177
+ if (val) result.push(val);
178
+ current = '';
179
+ } else {
180
+ current += ch;
181
+ }
182
+ }
183
+ const last = current.trim();
184
+ if (last) result.push(last);
185
+ return result;
186
+ }
187
+
188
+ private toTomlString(value: string): string {
189
+ return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
190
+ }
191
+ }
@@ -1,105 +1,105 @@
1
- import type { MCPConfigAdapter, MCPServerEntry } from '../../types.js';
2
- import { homedir } from 'node:os';
3
- import { join } from 'node:path';
4
-
5
- /**
6
- * VS Code Copilot MCP config adapter.
7
- *
8
- * Supports two config locations / formats:
9
- *
10
- * 1. Workspace-level (preferred, new):
11
- * Path: .vscode/mcp.json
12
- * Format: { "servers": { [name]: { command, args, env?, url? } } }
13
- *
14
- * 2. Global (legacy, still scanned):
15
- * Path: %APPDATA%/Code/User/settings.json
16
- * Format: { "mcp": { "servers": { [name]: { command, args, env? } } } }
17
- *
18
- * parse() auto-detects which format is provided.
19
- * generate() always outputs the new .vscode/mcp.json format.
20
- * getConfigPath(projectRoot) returns workspace path; getConfigPath() returns global path.
21
- */
22
- export class CopilotMCPAdapter implements MCPConfigAdapter {
23
- readonly source = 'copilot' as const;
24
-
25
- parse(content: string): MCPServerEntry[] {
26
- try {
27
- const config = JSON.parse(content);
28
-
29
- // Auto-detect format:
30
- // 1. mcp.json format: { "servers": { ... } }
31
- // 2. settings.json format: { "mcp": { "servers": { ... } } }
32
- const servers = config?.servers ?? config?.mcp?.servers ?? {};
33
-
34
- return Object.entries(servers).map(([name, entry]: [string, any]) => {
35
- const result: MCPServerEntry = {
36
- name,
37
- command: entry.command ?? '',
38
- args: entry.args ?? [],
39
- };
40
-
41
- if (entry.type) {
42
- // VS Code mcp.json supports "type" field (e.g., "http", "stdio")
43
- // Map to url for HTTP types
44
- if ((entry.type === 'http' || entry.type === 'sse') && entry.url) {
45
- result.url = entry.url;
46
- }
47
- } else if (entry.url) {
48
- result.url = entry.url;
49
- }
50
-
51
- if (entry.env && typeof entry.env === 'object' && Object.keys(entry.env).length > 0) {
52
- result.env = entry.env;
53
- }
54
-
55
- if (entry.headers && typeof entry.headers === 'object' && Object.keys(entry.headers).length > 0) {
56
- result.headers = entry.headers;
57
- }
58
-
59
- return result;
60
- });
61
- } catch {
62
- return [];
63
- }
64
- }
65
-
66
- generate(servers: MCPServerEntry[]): string {
67
- const mcpServers: Record<string, any> = {};
68
- for (const s of servers) {
69
- const entry: Record<string, any> = {};
70
- if (s.url) {
71
- entry.type = 'http';
72
- entry.url = s.url;
73
- if (s.headers && Object.keys(s.headers).length > 0) {
74
- entry.headers = s.headers;
75
- }
76
- } else {
77
- entry.command = s.command;
78
- entry.args = s.args;
79
- }
80
- if (s.env && Object.keys(s.env).length > 0) {
81
- entry.env = s.env;
82
- }
83
- mcpServers[s.name] = entry;
84
- }
85
-
86
- // Output the new .vscode/mcp.json format: { "servers": { ... } }
87
- return JSON.stringify({ servers: mcpServers }, null, 2);
88
- }
89
-
90
- getConfigPath(projectRoot?: string): string {
91
- if (projectRoot) {
92
- // Workspace-level: .vscode/mcp.json (new official format)
93
- return join(projectRoot, '.vscode', 'mcp.json');
94
- }
95
- // Global: VS Code user settings path (legacy, for scan fallback)
96
- const home = homedir();
97
- if (process.platform === 'win32') {
98
- return join(home, 'AppData', 'Roaming', 'Code', 'User', 'settings.json');
99
- } else if (process.platform === 'darwin') {
100
- return join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json');
101
- } else {
102
- return join(home, '.config', 'Code', 'User', 'settings.json');
103
- }
104
- }
105
- }
1
+ import type { MCPConfigAdapter, MCPServerEntry } from '../../types.js';
2
+ import { homedir } from 'node:os';
3
+ import { join } from 'node:path';
4
+
5
+ /**
6
+ * VS Code Copilot MCP config adapter.
7
+ *
8
+ * Supports two config locations / formats:
9
+ *
10
+ * 1. Workspace-level (preferred, new):
11
+ * Path: .vscode/mcp.json
12
+ * Format: { "servers": { [name]: { command, args, env?, url? } } }
13
+ *
14
+ * 2. Global (legacy, still scanned):
15
+ * Path: %APPDATA%/Code/User/settings.json
16
+ * Format: { "mcp": { "servers": { [name]: { command, args, env? } } } }
17
+ *
18
+ * parse() auto-detects which format is provided.
19
+ * generate() always outputs the new .vscode/mcp.json format.
20
+ * getConfigPath(projectRoot) returns workspace path; getConfigPath() returns global path.
21
+ */
22
+ export class CopilotMCPAdapter implements MCPConfigAdapter {
23
+ readonly source = 'copilot' as const;
24
+
25
+ parse(content: string): MCPServerEntry[] {
26
+ try {
27
+ const config = JSON.parse(content);
28
+
29
+ // Auto-detect format:
30
+ // 1. mcp.json format: { "servers": { ... } }
31
+ // 2. settings.json format: { "mcp": { "servers": { ... } } }
32
+ const servers = config?.servers ?? config?.mcp?.servers ?? {};
33
+
34
+ return Object.entries(servers).map(([name, entry]: [string, any]) => {
35
+ const result: MCPServerEntry = {
36
+ name,
37
+ command: entry.command ?? '',
38
+ args: entry.args ?? [],
39
+ };
40
+
41
+ if (entry.type) {
42
+ // VS Code mcp.json supports "type" field (e.g., "http", "stdio")
43
+ // Map to url for HTTP types
44
+ if ((entry.type === 'http' || entry.type === 'sse') && entry.url) {
45
+ result.url = entry.url;
46
+ }
47
+ } else if (entry.url) {
48
+ result.url = entry.url;
49
+ }
50
+
51
+ if (entry.env && typeof entry.env === 'object' && Object.keys(entry.env).length > 0) {
52
+ result.env = entry.env;
53
+ }
54
+
55
+ if (entry.headers && typeof entry.headers === 'object' && Object.keys(entry.headers).length > 0) {
56
+ result.headers = entry.headers;
57
+ }
58
+
59
+ return result;
60
+ });
61
+ } catch {
62
+ return [];
63
+ }
64
+ }
65
+
66
+ generate(servers: MCPServerEntry[]): string {
67
+ const mcpServers: Record<string, any> = {};
68
+ for (const s of servers) {
69
+ const entry: Record<string, any> = {};
70
+ if (s.url) {
71
+ entry.type = 'http';
72
+ entry.url = s.url;
73
+ if (s.headers && Object.keys(s.headers).length > 0) {
74
+ entry.headers = s.headers;
75
+ }
76
+ } else {
77
+ entry.command = s.command;
78
+ entry.args = s.args;
79
+ }
80
+ if (s.env && Object.keys(s.env).length > 0) {
81
+ entry.env = s.env;
82
+ }
83
+ mcpServers[s.name] = entry;
84
+ }
85
+
86
+ // Output the new .vscode/mcp.json format: { "servers": { ... } }
87
+ return JSON.stringify({ servers: mcpServers }, null, 2);
88
+ }
89
+
90
+ getConfigPath(projectRoot?: string): string {
91
+ if (projectRoot) {
92
+ // Workspace-level: .vscode/mcp.json (new official format)
93
+ return join(projectRoot, '.vscode', 'mcp.json');
94
+ }
95
+ // Global: VS Code user settings path (legacy, for scan fallback)
96
+ const home = homedir();
97
+ if (process.platform === 'win32') {
98
+ return join(home, 'AppData', 'Roaming', 'Code', 'User', 'settings.json');
99
+ } else if (process.platform === 'darwin') {
100
+ return join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json');
101
+ } else {
102
+ return join(home, '.config', 'Code', 'User', 'settings.json');
103
+ }
104
+ }
105
+ }