@qmediat.io/gemini-code-context-mcp 1.0.0

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 (120) hide show
  1. package/CHANGELOG.md +79 -0
  2. package/LICENSE +21 -0
  3. package/README.md +159 -0
  4. package/dist/auth/credentials-store.d.ts +47 -0
  5. package/dist/auth/credentials-store.d.ts.map +1 -0
  6. package/dist/auth/credentials-store.js +215 -0
  7. package/dist/auth/credentials-store.js.map +1 -0
  8. package/dist/auth/fingerprint.d.ts +8 -0
  9. package/dist/auth/fingerprint.d.ts.map +1 -0
  10. package/dist/auth/fingerprint.js +12 -0
  11. package/dist/auth/fingerprint.js.map +1 -0
  12. package/dist/auth/init-command.d.ts +9 -0
  13. package/dist/auth/init-command.d.ts.map +1 -0
  14. package/dist/auth/init-command.js +279 -0
  15. package/dist/auth/init-command.js.map +1 -0
  16. package/dist/auth/profile-loader.d.ts +28 -0
  17. package/dist/auth/profile-loader.d.ts.map +1 -0
  18. package/dist/auth/profile-loader.js +107 -0
  19. package/dist/auth/profile-loader.js.map +1 -0
  20. package/dist/cache/cache-manager.d.ts +78 -0
  21. package/dist/cache/cache-manager.d.ts.map +1 -0
  22. package/dist/cache/cache-manager.js +364 -0
  23. package/dist/cache/cache-manager.js.map +1 -0
  24. package/dist/cache/files-uploader.d.ts +42 -0
  25. package/dist/cache/files-uploader.d.ts.map +1 -0
  26. package/dist/cache/files-uploader.js +176 -0
  27. package/dist/cache/files-uploader.js.map +1 -0
  28. package/dist/cache/ttl-watcher.d.ts +21 -0
  29. package/dist/cache/ttl-watcher.d.ts.map +1 -0
  30. package/dist/cache/ttl-watcher.js +75 -0
  31. package/dist/cache/ttl-watcher.js.map +1 -0
  32. package/dist/config.d.ts +25 -0
  33. package/dist/config.d.ts.map +1 -0
  34. package/dist/config.js +34 -0
  35. package/dist/config.js.map +1 -0
  36. package/dist/gemini/client.d.ts +7 -0
  37. package/dist/gemini/client.d.ts.map +1 -0
  38. package/dist/gemini/client.js +19 -0
  39. package/dist/gemini/client.js.map +1 -0
  40. package/dist/gemini/model-registry.d.ts +25 -0
  41. package/dist/gemini/model-registry.d.ts.map +1 -0
  42. package/dist/gemini/model-registry.js +70 -0
  43. package/dist/gemini/model-registry.js.map +1 -0
  44. package/dist/gemini/models.d.ts +23 -0
  45. package/dist/gemini/models.d.ts.map +1 -0
  46. package/dist/gemini/models.js +98 -0
  47. package/dist/gemini/models.js.map +1 -0
  48. package/dist/index.d.ts +10 -0
  49. package/dist/index.d.ts.map +1 -0
  50. package/dist/index.js +55 -0
  51. package/dist/index.js.map +1 -0
  52. package/dist/indexer/globs.d.ts +25 -0
  53. package/dist/indexer/globs.d.ts.map +1 -0
  54. package/dist/indexer/globs.js +210 -0
  55. package/dist/indexer/globs.js.map +1 -0
  56. package/dist/indexer/hasher.d.ts +31 -0
  57. package/dist/indexer/hasher.d.ts.map +1 -0
  58. package/dist/indexer/hasher.js +61 -0
  59. package/dist/indexer/hasher.js.map +1 -0
  60. package/dist/indexer/workspace-scanner.d.ts +27 -0
  61. package/dist/indexer/workspace-scanner.d.ts.map +1 -0
  62. package/dist/indexer/workspace-scanner.js +77 -0
  63. package/dist/indexer/workspace-scanner.js.map +1 -0
  64. package/dist/manifest/db.d.ts +38 -0
  65. package/dist/manifest/db.d.ts.map +1 -0
  66. package/dist/manifest/db.js +223 -0
  67. package/dist/manifest/db.js.map +1 -0
  68. package/dist/server.d.ts +5 -0
  69. package/dist/server.d.ts.map +1 -0
  70. package/dist/server.js +117 -0
  71. package/dist/server.js.map +1 -0
  72. package/dist/tools/ask.tool.d.ts +34 -0
  73. package/dist/tools/ask.tool.d.ts.map +1 -0
  74. package/dist/tools/ask.tool.js +216 -0
  75. package/dist/tools/ask.tool.js.map +1 -0
  76. package/dist/tools/clear.tool.d.ts +15 -0
  77. package/dist/tools/clear.tool.d.ts.map +1 -0
  78. package/dist/tools/clear.tool.js +31 -0
  79. package/dist/tools/clear.tool.js.map +1 -0
  80. package/dist/tools/code.tool.d.ts +42 -0
  81. package/dist/tools/code.tool.d.ts.map +1 -0
  82. package/dist/tools/code.tool.js +327 -0
  83. package/dist/tools/code.tool.js.map +1 -0
  84. package/dist/tools/index.d.ts +3 -0
  85. package/dist/tools/index.d.ts.map +1 -0
  86. package/dist/tools/index.js +14 -0
  87. package/dist/tools/index.js.map +1 -0
  88. package/dist/tools/registry.d.ts +37 -0
  89. package/dist/tools/registry.d.ts.map +1 -0
  90. package/dist/tools/registry.js +16 -0
  91. package/dist/tools/registry.js.map +1 -0
  92. package/dist/tools/reindex.tool.d.ts +21 -0
  93. package/dist/tools/reindex.tool.d.ts.map +1 -0
  94. package/dist/tools/reindex.tool.js +62 -0
  95. package/dist/tools/reindex.tool.js.map +1 -0
  96. package/dist/tools/status.tool.d.ts +15 -0
  97. package/dist/tools/status.tool.d.ts.map +1 -0
  98. package/dist/tools/status.tool.js +105 -0
  99. package/dist/tools/status.tool.js.map +1 -0
  100. package/dist/types.d.ts +68 -0
  101. package/dist/types.d.ts.map +1 -0
  102. package/dist/types.js +5 -0
  103. package/dist/types.js.map +1 -0
  104. package/dist/utils/cost-estimator.d.ts +32 -0
  105. package/dist/utils/cost-estimator.d.ts.map +1 -0
  106. package/dist/utils/cost-estimator.js +83 -0
  107. package/dist/utils/cost-estimator.js.map +1 -0
  108. package/dist/utils/logger.d.ts +11 -0
  109. package/dist/utils/logger.d.ts.map +1 -0
  110. package/dist/utils/logger.js +21 -0
  111. package/dist/utils/logger.js.map +1 -0
  112. package/dist/utils/paths.d.ts +20 -0
  113. package/dist/utils/paths.d.ts.map +1 -0
  114. package/dist/utils/paths.js +41 -0
  115. package/dist/utils/paths.js.map +1 -0
  116. package/dist/utils/progress.d.ts +16 -0
  117. package/dist/utils/progress.d.ts.map +1 -0
  118. package/dist/utils/progress.js +47 -0
  119. package/dist/utils/progress.js.map +1 -0
  120. package/package.json +78 -0
@@ -0,0 +1,279 @@
1
+ /**
2
+ * Interactive `init` subcommand — guides the user through secure credential setup.
3
+ *
4
+ * Writes `~/.config/qmediat/credentials` with chmod 0600. Offers to print an MCP
5
+ * host config snippet to paste into `~/.claude.json` (etc.) that references the
6
+ * profile by name rather than embedding the key.
7
+ */
8
+ import { execFileSync } from 'node:child_process';
9
+ import { existsSync, statSync } from 'node:fs';
10
+ import { dirname, join } from 'node:path';
11
+ import { stdin as input, stdout as output } from 'node:process';
12
+ import { createInterface } from 'node:readline/promises';
13
+ import { credentialsPath, qmediatConfigDir } from '../utils/paths.js';
14
+ import { sanitizeProfileName, saveProfile } from './credentials-store.js';
15
+ import { fingerprint } from './fingerprint.js';
16
+ async function askHidden(prompt) {
17
+ // Refuse to read secrets when stdin is not a TTY. Piped input (`echo $KEY | init`)
18
+ // leaves the key in shell history, pipe buffers, and screen-recorded CI logs.
19
+ // Non-interactive environments should use GEMINI_API_KEY env var or Vertex ADC.
20
+ if (!input.isTTY) {
21
+ throw new Error([
22
+ 'Cannot read a secret without a TTY (stdin is piped or redirected).',
23
+ 'To avoid leaking your key via shell history / CI logs, pick one of:',
24
+ ' 1. Run `init` in an interactive terminal.',
25
+ ' 2. Skip `init` and set GEMINI_API_KEY as an env var in your MCP host config (Tier 3, logs a warning).',
26
+ ' 3. Use Vertex: `gcloud auth application-default login` + GEMINI_USE_VERTEX=true + GOOGLE_CLOUD_PROJECT.',
27
+ ].join('\n'));
28
+ }
29
+ // Interactive TTY path: echo '*' for each char so users can verify length without leaking content.
30
+ output.write(`${prompt} `);
31
+ return await new Promise((resolve, reject) => {
32
+ let buf = '';
33
+ // Ensure the terminal is ALWAYS restored, even on exit / uncaught errors.
34
+ // Without this, Ctrl+C leaves the shell in raw mode — no echo, no line editing —
35
+ // until the user blindly types `reset`.
36
+ const cleanup = () => {
37
+ try {
38
+ input.off('data', listener);
39
+ input.setRawMode?.(false);
40
+ input.pause();
41
+ }
42
+ catch {
43
+ /* best-effort */
44
+ }
45
+ // Detach process-level handlers so repeated askHidden calls don't
46
+ // accumulate listeners (Node warns at >10). `process.off` is a no-op
47
+ // if the handler isn't registered, so calling unconditionally is safe.
48
+ try {
49
+ process.off('SIGINT', cleanup);
50
+ process.off('exit', cleanup);
51
+ }
52
+ catch {
53
+ /* best-effort */
54
+ }
55
+ };
56
+ const listener = (chunk) => {
57
+ const s = chunk.toString('utf8');
58
+ let i = 0;
59
+ while (i < s.length) {
60
+ const ch = s[i];
61
+ if (ch === undefined) {
62
+ i += 1;
63
+ continue;
64
+ }
65
+ if (ch === '\r' || ch === '\n') {
66
+ output.write('\n');
67
+ cleanup();
68
+ resolve(buf);
69
+ return;
70
+ }
71
+ if (ch === '\u0003') {
72
+ // Ctrl+C — restore terminal before exiting, otherwise the shell is left unusable.
73
+ output.write('\n');
74
+ cleanup();
75
+ // Use reject so the caller's try/finally (runInit → rl.close) still fires.
76
+ reject(new Error('Interrupted by user (Ctrl+C)'));
77
+ return;
78
+ }
79
+ if (ch === '\u007f' || ch === '\b') {
80
+ if (buf.length > 0) {
81
+ buf = buf.slice(0, -1);
82
+ output.write('\b \b');
83
+ }
84
+ i += 1;
85
+ continue;
86
+ }
87
+ // Strip ANSI escape sequences — they'd otherwise silently corrupt the key.
88
+ // Handle the four main ESC forms that terminals emit during password entry:
89
+ // CSI: ESC [ <params> <final-letter> (arrow keys, Home/End)
90
+ // SS3: ESC O <letter> (F1-F4 on xterm/tmux)
91
+ // OSC: ESC ] <params> <BEL or ESC \> (title sets, clipboard pastes)
92
+ // DCS: ESC P <params> <ESC \> (device control, rare)
93
+ // Anything else starting with ESC is consumed as a 2-byte sequence (ESC + next).
94
+ if (ch === '\u001b') {
95
+ i += 1;
96
+ const next = s[i];
97
+ if (next === '[') {
98
+ // CSI: skip params then the final letter.
99
+ i += 1;
100
+ while (i < s.length && !/[A-Za-z~]/.test(s[i] ?? ''))
101
+ i += 1;
102
+ i += 1;
103
+ }
104
+ else if (next === 'O') {
105
+ // SS3: ESC O <letter> — consume the letter.
106
+ i += 1; // skip 'O'
107
+ if (i < s.length)
108
+ i += 1; // skip final letter
109
+ }
110
+ else if (next === ']' || next === 'P') {
111
+ // OSC / DCS: terminated by BEL (\x07) or ST (ESC \).
112
+ i += 1; // skip ']' or 'P'
113
+ while (i < s.length) {
114
+ const c = s[i];
115
+ if (c === '\u0007') {
116
+ i += 1;
117
+ break;
118
+ }
119
+ if (c === '\u001b' && s[i + 1] === '\\') {
120
+ i += 2;
121
+ break;
122
+ }
123
+ i += 1;
124
+ }
125
+ }
126
+ else {
127
+ // Unknown ESC-prefixed sequence: consume ESC + next byte.
128
+ if (i < s.length)
129
+ i += 1;
130
+ }
131
+ continue;
132
+ }
133
+ // Reject other control chars (0x00-0x1F except handled above, and 0x7F).
134
+ const code = ch.charCodeAt(0);
135
+ if (code < 0x20 || code === 0x7f) {
136
+ i += 1;
137
+ continue;
138
+ }
139
+ buf += ch;
140
+ output.write('*');
141
+ i += 1;
142
+ }
143
+ };
144
+ process.once('SIGINT', cleanup);
145
+ process.once('exit', cleanup);
146
+ input.setRawMode?.(true);
147
+ input.resume();
148
+ input.on('data', listener);
149
+ });
150
+ }
151
+ function claudeCodeConfigPath() {
152
+ return join(process.env.HOME ?? '', '.claude.json');
153
+ }
154
+ /**
155
+ * Detect whether the credentials directory sits inside a git-tracked tree.
156
+ *
157
+ * On a fresh install the credentials dir doesn't exist yet; running `git` there
158
+ * fails with ENOENT and previously returned `false` — missing the warning for
159
+ * users whose home / dotfiles repo tracks `~/.config/`. We walk up the path
160
+ * hierarchy until we hit an existing ancestor and run the check from there.
161
+ */
162
+ function detectGitUnderConfigDir() {
163
+ let cwd = qmediatConfigDir();
164
+ while (!existsSync(cwd)) {
165
+ const parent = dirname(cwd);
166
+ if (parent === cwd)
167
+ return false;
168
+ cwd = parent;
169
+ }
170
+ try {
171
+ // `execFileSync` (no shell) → no `2>/dev/null` quirks on Windows cmd.exe.
172
+ // stderr suppressed via `stdio: ['ignore', 'pipe', 'ignore']`.
173
+ const output = execFileSync('git', ['rev-parse', '--show-toplevel'], {
174
+ cwd,
175
+ encoding: 'utf8',
176
+ stdio: ['ignore', 'pipe', 'ignore'],
177
+ });
178
+ const top = output.trim();
179
+ return top.length > 0 && existsSync(top);
180
+ }
181
+ catch {
182
+ return false;
183
+ }
184
+ }
185
+ export async function runInit() {
186
+ const rl = createInterface({ input, output });
187
+ const log = (line) => {
188
+ output.write(`${line}\n`);
189
+ };
190
+ try {
191
+ log('');
192
+ log('qmediat — gemini-code-context-mcp secure setup');
193
+ log('==============================================');
194
+ log('');
195
+ log('This will store credentials in ~/.config/qmediat/credentials (chmod 0600).');
196
+ log('Your MCP host config (~/.claude.json etc.) will only reference the profile name,');
197
+ log('never the raw key.');
198
+ log('');
199
+ if (detectGitUnderConfigDir()) {
200
+ log('Warning: ~/.config/qmediat appears to be inside a git repository.');
201
+ log(' Make sure `qmediat/credentials` is .gitignored before continuing.');
202
+ log('');
203
+ }
204
+ const methodInput = (await rl.question('Auth method? [1] API key (Gemini Developer API), [2] Vertex AI (enterprise GCP) [1]: ')).trim();
205
+ const method = methodInput === '2' ? 'vertex' : 'api-key';
206
+ // Note: raw ADC without Vertex is not a supported path — @google/genai expects
207
+ // either an API key or a Vertex configuration. Users who want ADC should pick
208
+ // option 2 and let the SDK pick up GOOGLE_APPLICATION_CREDENTIALS automatically.
209
+ const profileInput = (await rl.question('Profile name [default]: ')).trim();
210
+ // Validate now so we fail fast with a clear message instead of at write time.
211
+ let profileName;
212
+ try {
213
+ profileName = sanitizeProfileName(profileInput.length > 0 ? profileInput : 'default');
214
+ }
215
+ catch (err) {
216
+ log(err instanceof Error ? err.message : String(err));
217
+ return;
218
+ }
219
+ const data = {};
220
+ if (method === 'api-key') {
221
+ const key = (await askHidden('Paste your Gemini API key (hidden):')).trim();
222
+ if (key.length < 20) {
223
+ log('Key looks too short — aborting.');
224
+ return;
225
+ }
226
+ data.geminiApiKey = key;
227
+ }
228
+ else if (method === 'vertex') {
229
+ const project = (await rl.question('GCP project ID: ')).trim();
230
+ if (project.length === 0) {
231
+ log('Project is required for Vertex. Aborting.');
232
+ return;
233
+ }
234
+ const location = (await rl.question('Location [us-central1]: ')).trim() || 'us-central1';
235
+ data.vertexProject = project;
236
+ data.vertexLocation = location;
237
+ }
238
+ const modelInput = (await rl.question('Default model [latest-pro]: ')).trim();
239
+ if (modelInput.length > 0)
240
+ data.defaultModel = modelInput;
241
+ const budgetInput = (await rl.question('Daily budget cap in USD (blank = no cap) []: ')).trim();
242
+ if (budgetInput.length > 0) {
243
+ const n = Number.parseFloat(budgetInput);
244
+ if (Number.isFinite(n) && n > 0)
245
+ data.dailyBudgetUsd = n;
246
+ }
247
+ saveProfile(profileName, data);
248
+ log('');
249
+ log(`Saved profile '${profileName}' to ${credentialsPath()} (chmod 0600).`);
250
+ if (data.geminiApiKey) {
251
+ log(` Key fingerprint: ${fingerprint(data.geminiApiKey)}`);
252
+ }
253
+ log('');
254
+ log('Add this to your MCP host config (no API key leaves this machine):');
255
+ log('');
256
+ log(' {');
257
+ log(' "mcpServers": {');
258
+ log(' "gemini-code-context": {');
259
+ log(' "command": "npx",');
260
+ log(' "args": ["-y", "@qmediat.io/gemini-code-context-mcp"],');
261
+ log(` "env": { "GEMINI_CREDENTIALS_PROFILE": "${profileName}"${method === 'vertex' ? ', "GEMINI_USE_VERTEX": "true"' : ''} }`);
262
+ log(' }');
263
+ log(' }');
264
+ log(' }');
265
+ log('');
266
+ const claudeConfig = claudeCodeConfigPath();
267
+ if (existsSync(claudeConfig)) {
268
+ const stats = statSync(claudeConfig);
269
+ log(`Detected Claude Code config at ${claudeConfig} (${stats.size} bytes).`);
270
+ log('Edit it by hand — we intentionally do not auto-modify it to avoid clobbering state.');
271
+ }
272
+ log('');
273
+ log('Never commit the credentials file to git.');
274
+ }
275
+ finally {
276
+ rl.close();
277
+ }
278
+ }
279
+ //# sourceMappingURL=init-command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init-command.js","sourceRoot":"","sources":["../../src/auth/init-command.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Resolve the active auth profile for this process.
3
+ *
4
+ * Resolution order (highest trust first):
5
+ * 1. Vertex env (`GEMINI_USE_VERTEX=true` + `GOOGLE_CLOUD_PROJECT` + `GOOGLE_CLOUD_LOCATION`)
6
+ * → Tier 1 ADC-like (relies on gcloud ADC under the hood)
7
+ * 2. Credentials profile file (`GEMINI_CREDENTIALS_PROFILE` env → profile name)
8
+ * → Tier 2 (0600 file)
9
+ * 3. API key env var (`GEMINI_API_KEY`)
10
+ * → Tier 3 (logs a warning at startup)
11
+ *
12
+ * The server also exposes `GOOGLE_APPLICATION_CREDENTIALS` as an alternative ADC
13
+ * path — that's picked up automatically by the SDK, nothing for us to do here.
14
+ */
15
+ import type { AuthProfile } from '../types.js';
16
+ export interface ResolvedAuth {
17
+ profile: AuthProfile;
18
+ source: 'vertex-env' | 'credentials-file' | 'env-var';
19
+ /** Default model override from the profile, if any. */
20
+ defaultModel?: string;
21
+ /** Daily budget cap in USD, if configured. */
22
+ dailyBudgetUsd?: number;
23
+ /** Safe key preview for logging. */
24
+ keyFingerprint: string;
25
+ }
26
+ /** Resolve the best available auth profile, or throw with actionable instructions. */
27
+ export declare function resolveAuth(): ResolvedAuth;
28
+ //# sourceMappingURL=profile-loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profile-loader.d.ts","sourceRoot":"","sources":["../../src/auth/profile-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,YAAY,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACtD,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;CACxB;AAwED,sFAAsF;AACtF,wBAAgB,WAAW,IAAI,YAAY,CA2B1C"}
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Resolve the active auth profile for this process.
3
+ *
4
+ * Resolution order (highest trust first):
5
+ * 1. Vertex env (`GEMINI_USE_VERTEX=true` + `GOOGLE_CLOUD_PROJECT` + `GOOGLE_CLOUD_LOCATION`)
6
+ * → Tier 1 ADC-like (relies on gcloud ADC under the hood)
7
+ * 2. Credentials profile file (`GEMINI_CREDENTIALS_PROFILE` env → profile name)
8
+ * → Tier 2 (0600 file)
9
+ * 3. API key env var (`GEMINI_API_KEY`)
10
+ * → Tier 3 (logs a warning at startup)
11
+ *
12
+ * The server also exposes `GOOGLE_APPLICATION_CREDENTIALS` as an alternative ADC
13
+ * path — that's picked up automatically by the SDK, nothing for us to do here.
14
+ */
15
+ import { logger } from '../utils/logger.js';
16
+ import { loadProfile } from './credentials-store.js';
17
+ import { fingerprint } from './fingerprint.js';
18
+ function readProfileEnvName() {
19
+ const name = process.env.GEMINI_CREDENTIALS_PROFILE;
20
+ return name && name.length > 0 ? name : 'default';
21
+ }
22
+ function tryVertex() {
23
+ if (process.env.GEMINI_USE_VERTEX !== 'true')
24
+ return null;
25
+ const project = process.env.GOOGLE_CLOUD_PROJECT;
26
+ const location = process.env.GOOGLE_CLOUD_LOCATION ?? 'us-central1';
27
+ if (!project) {
28
+ logger.warn('GEMINI_USE_VERTEX=true but GOOGLE_CLOUD_PROJECT is not set — skipping Vertex profile.');
29
+ return null;
30
+ }
31
+ return {
32
+ profile: { kind: 'vertex', project, location },
33
+ source: 'vertex-env',
34
+ keyFingerprint: 'vertex:adc',
35
+ };
36
+ }
37
+ function tryCredentialsFile() {
38
+ const name = readProfileEnvName();
39
+ let profileData;
40
+ try {
41
+ profileData = loadProfile(name);
42
+ }
43
+ catch {
44
+ return null;
45
+ }
46
+ if (profileData.vertexProject) {
47
+ return {
48
+ profile: {
49
+ kind: 'vertex',
50
+ project: profileData.vertexProject,
51
+ location: profileData.vertexLocation ?? 'us-central1',
52
+ },
53
+ source: 'credentials-file',
54
+ ...(profileData.defaultModel !== undefined ? { defaultModel: profileData.defaultModel } : {}),
55
+ ...(profileData.dailyBudgetUsd !== undefined
56
+ ? { dailyBudgetUsd: profileData.dailyBudgetUsd }
57
+ : {}),
58
+ keyFingerprint: 'vertex:adc',
59
+ };
60
+ }
61
+ if (!profileData.geminiApiKey)
62
+ return null;
63
+ return {
64
+ profile: { kind: 'api-key', apiKey: profileData.geminiApiKey },
65
+ source: 'credentials-file',
66
+ ...(profileData.defaultModel !== undefined ? { defaultModel: profileData.defaultModel } : {}),
67
+ ...(profileData.dailyBudgetUsd !== undefined
68
+ ? { dailyBudgetUsd: profileData.dailyBudgetUsd }
69
+ : {}),
70
+ keyFingerprint: fingerprint(profileData.geminiApiKey),
71
+ };
72
+ }
73
+ function tryEnvKey() {
74
+ const key = process.env.GEMINI_API_KEY;
75
+ if (!key || key.length === 0)
76
+ return null;
77
+ return {
78
+ profile: { kind: 'api-key', apiKey: key },
79
+ source: 'env-var',
80
+ keyFingerprint: fingerprint(key),
81
+ };
82
+ }
83
+ /** Resolve the best available auth profile, or throw with actionable instructions. */
84
+ export function resolveAuth() {
85
+ const vertex = tryVertex();
86
+ if (vertex)
87
+ return vertex;
88
+ const file = tryCredentialsFile();
89
+ if (file)
90
+ return file;
91
+ const env = tryEnvKey();
92
+ if (env) {
93
+ logger.warn(`API key loaded from GEMINI_API_KEY env var (fingerprint: ${env.keyFingerprint}). This is NOT recommended for production — run \`npx @qmediat.io/gemini-code-context-mcp init\` to move it to a secure credentials file (chmod 0600).`);
94
+ return env;
95
+ }
96
+ throw new Error([
97
+ 'No Gemini credentials found.',
98
+ '',
99
+ 'Choose one of:',
100
+ ' 1. Recommended: `npx @qmediat.io/gemini-code-context-mcp init` (guided setup)',
101
+ ' 2. `gcloud auth application-default login` + GEMINI_USE_VERTEX=true',
102
+ ' 3. Set GEMINI_API_KEY env var (quick test only)',
103
+ '',
104
+ 'See: https://github.com/qmediat/gemini-code-context-mcp#setup',
105
+ ].join('\n'));
106
+ }
107
+ //# sourceMappingURL=profile-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profile-loader.js","sourceRoot":"","sources":["../../src/auth/profile-loader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ /**
2
+ * Build / reuse / invalidate Gemini Context Caches keyed by workspace state.
3
+ *
4
+ * Cache key = `(workspaceRoot, filesHash, model, systemPromptHash)`. When any
5
+ * component changes, we rebuild. When the same key is requested concurrently
6
+ * (two ask() calls in parallel), we coalesce via a per-workspace in-process
7
+ * mutex so only one cache is created.
8
+ *
9
+ * Inline fallback path: for small workspaces or `noCache:true`, we skip the
10
+ * Files API upload entirely and embed file text inline. This avoids unnecessary
11
+ * network latency for workspaces that wouldn't benefit from caching anyway
12
+ * (Gemini rejects caches below 1024 tokens, and small workspaces don't amortise
13
+ * the upload cost over enough queries).
14
+ *
15
+ * Content shape: we emit ONE `{role:'user', parts: [...]}` Content with a
16
+ * `--- FILE: <relpath> ---` text marker before each file's data. This (a) gives
17
+ * the model enough context to resolve imports and architecture, and (b) avoids
18
+ * the consecutive-user-role-violation risk on stricter Gemini models.
19
+ */
20
+ import type { Content, GoogleGenAI } from '@google/genai';
21
+ import type { ScanResult } from '../indexer/workspace-scanner.js';
22
+ import type { ManifestDb } from '../manifest/db.js';
23
+ import type { ResolvedModel } from '../types.js';
24
+ import type { ProgressEmitter } from '../utils/progress.js';
25
+ import { type UploadResult } from './files-uploader.js';
26
+ export interface PreparedContext {
27
+ /** Cache resource name (`cachedContents/abc123`) or null if caching skipped. */
28
+ cacheId: string | null;
29
+ cacheExpiresAt: number | null;
30
+ /**
31
+ * Content entries to send as the file-context prefix when NOT using a cache.
32
+ * Contains zero or one `{role:'user'}` entry with all file parts (markers +
33
+ * file-data or inline text) consolidated. Empty when caching is active or
34
+ * the workspace has no files.
35
+ */
36
+ inlineContents: Content[];
37
+ uploaded: UploadResult;
38
+ rebuilt: boolean;
39
+ reused: boolean;
40
+ /**
41
+ * When true, the server operated without hitting the Files API. The caller
42
+ * has the full file text inline and can skip any upload-progress UI.
43
+ */
44
+ inlineOnly: boolean;
45
+ }
46
+ export interface BuildOptions {
47
+ client: GoogleGenAI;
48
+ manifest: ManifestDb;
49
+ scan: ScanResult;
50
+ model: ResolvedModel;
51
+ systemPromptHash: string;
52
+ systemInstruction?: string;
53
+ ttlSeconds: number;
54
+ /**
55
+ * Minimum estimated workspace tokens required to attempt `caches.create`.
56
+ * Gemini currently enforces 1024; below that, we silently skip the cache
57
+ * build and use inline file parts instead. Default: 1024.
58
+ */
59
+ cacheMinTokens?: number;
60
+ /** Concurrency for Files API uploads. Default: 10. */
61
+ uploadConcurrency?: number;
62
+ emitter: ProgressEmitter;
63
+ allowCaching: boolean;
64
+ }
65
+ export declare function prepareContext(opts: BuildOptions): Promise<PreparedContext>;
66
+ export declare function invalidateWorkspaceCache(args: {
67
+ client: GoogleGenAI;
68
+ manifest: ManifestDb;
69
+ workspaceRoot: string;
70
+ }): Promise<void>;
71
+ /**
72
+ * Heuristic check for "cached content is stale / not found" errors from the
73
+ * Gemini API, used by ask/code to decide whether a retry with a rebuilt cache
74
+ * is worth attempting. Matches observed error strings; conservative by design
75
+ * — returns false for any error we don't recognise as cache-specific.
76
+ */
77
+ export declare function isStaleCacheError(err: unknown): boolean;
78
+ //# sourceMappingURL=cache-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/cache/cache-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAQ,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,qBAAqB,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AA+GD,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAajF;AA0ND,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,UAAU,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMvD"}