@sanqianx/project-knowledge 5.0.18 → 5.0.20-rc.1

package/_site/lib/knowledge-schema.js

@@ -1,121 +1,121 @@
-const crypto = require('crypto');
-const arrow = require('apache-arrow');
-
-const KNOWLEDGE_DB_SCHEMA_VERSION = 1;
-const KNOWLEDGE_TABLE = 'knowledge_chunks';
-const EMBEDDING_DIMENSIONS = 512;
-
-function field(name, type, nullable = false) {
-  return new arrow.Field(name, type, nullable);
-}
-
-function knowledgeChunkSchema(dimensions = EMBEDDING_DIMENSIONS) {
-  return new arrow.Schema([
-    field('schema_version', new arrow.Int32()),
-    field('record_id', new arrow.Utf8()),
-    field('space_id', new arrow.Utf8()),
-    field('entry_id', new arrow.Utf8()),
-    field('entry_type', new arrow.Utf8()),
-    field('entry_version', new arrow.Int32()),
-    field('chunk_id', new arrow.Utf8()),
-    field('chunk_order', new arrow.Int32()),
-    field('title', new arrow.Utf8()),
-    field('heading_path', new arrow.Utf8()),
-    field('chunk_text', new arrow.Utf8()),
-    field('search_text', new arrow.Utf8()),
-    field('vector', new arrow.FixedSizeList(dimensions, field('item', new arrow.Float32()))),
-    field('tags_json', new arrow.Utf8()),
-    field('source_paths_json', new arrow.Utf8()),
-    field('routes_json', new arrow.Utf8()),
-    field('symbols_json', new arrow.Utf8()),
-    field('source_project_id', new arrow.Utf8()),
-    field('source_commit', new arrow.Utf8()),
-    field('document_hash', new arrow.Utf8()),
-    field('content_hash', new arrow.Utf8()),
-    field('created_at', new arrow.Utf8()),
-    field('updated_at', new arrow.Utf8()),
-  ]);
-}
-
-function sha256(value) {
-  return crypto.createHash('sha256').update(String(value || ''), 'utf8').digest('hex');
-}
-
-function requiredText(value, name) {
-  const normalized = String(value || '').trim();
-  if (!normalized) throw new Error(`${name} is required`);
-  return normalized;
-}
-
-function jsonArray(value) {
-  return JSON.stringify(Array.isArray(value) ? value.map(item => String(item)) : []);
-}
-
-function normalizeVector(value, dimensions = EMBEDDING_DIMENSIONS) {
-  const vector = Array.from(value || [], Number);
-  if (vector.length !== dimensions || vector.some(item => !Number.isFinite(item))) {
-    throw new Error(`vector must contain exactly ${dimensions} finite numbers`);
-  }
-  return vector;
-}
-
-function normalizeKnowledgeChunk(input, options = {}) {
-  const dimensions = options.dimensions || EMBEDDING_DIMENSIONS;
-  const now = options.now || new Date().toISOString();
-  const spaceId = requiredText(input.spaceId || input.space_id, 'spaceId');
-  const entryId = requiredText(input.entryId || input.entry_id, 'entryId');
-  const chunkOrder = Number.isInteger(input.chunkOrder) ? input.chunkOrder : Number(input.chunk_order || 0);
-  if (!Number.isInteger(chunkOrder) || chunkOrder < 0) throw new Error('chunkOrder must be a non-negative integer');
-  const chunkText = requiredText(input.chunkText || input.chunk_text, 'chunkText');
-  const contentHash = String(input.contentHash || input.content_hash || sha256(chunkText));
-  const chunkId = String(input.chunkId || input.chunk_id || `${entryId}:${chunkOrder}`);
-
-  return {
-    schema_version: KNOWLEDGE_DB_SCHEMA_VERSION,
-    record_id: `${spaceId}:${chunkId}`,
-    space_id: spaceId,
-    entry_id: entryId,
-    entry_type: String(input.entryType || input.entry_type || 'document'),
-    entry_version: Number.isInteger(input.entryVersion) ? input.entryVersion : Number(input.entry_version || 1),
-    chunk_id: chunkId,
-    chunk_order: chunkOrder,
-    title: String(input.title || ''),
-    heading_path: Array.isArray(input.headingPath) ? input.headingPath.join(' > ') : String(input.heading_path || ''),
-    chunk_text: chunkText,
-    search_text: String(input.searchText || input.search_text || `${input.title || ''}\n${chunkText}`).trim(),
-    vector: normalizeVector(input.vector, dimensions),
-    tags_json: jsonArray(input.tags),
-    source_paths_json: jsonArray(input.sourcePaths || input.source_paths),
-    routes_json: jsonArray(input.routes),
-    symbols_json: jsonArray(input.symbols),
-    source_project_id: String(input.sourceProjectId || input.source_project_id || ''),
-    source_commit: String(input.sourceCommit || input.source_commit || ''),
-    document_hash: String(input.documentHash || input.document_hash || contentHash),
-    content_hash: contentHash,
-    created_at: String(input.createdAt || input.created_at || now),
-    updated_at: String(input.updatedAt || input.updated_at || now),
-  };
-}
-
-function decodeKnowledgeChunk(row) {
-  const parse = (value) => {
-    try { return JSON.parse(value || '[]'); } catch { return []; }
-  };
-  return {
-    ...row,
-    tags: parse(row.tags_json),
-    sourcePaths: parse(row.source_paths_json),
-    routes: parse(row.routes_json),
-    symbols: parse(row.symbols_json),
-  };
-}
-
-module.exports = {
-  KNOWLEDGE_DB_SCHEMA_VERSION,
-  KNOWLEDGE_TABLE,
-  EMBEDDING_DIMENSIONS,
-  knowledgeChunkSchema,
-  normalizeKnowledgeChunk,
-  decodeKnowledgeChunk,
-  sha256,
-};
+const crypto = require('crypto');
+const arrow = require('apache-arrow');
+
+const KNOWLEDGE_DB_SCHEMA_VERSION = 1;
+const KNOWLEDGE_TABLE = 'knowledge_chunks';
+const EMBEDDING_DIMENSIONS = 512;
+
+function field(name, type, nullable = false) {
+  return new arrow.Field(name, type, nullable);
+}
+
+function knowledgeChunkSchema(dimensions = EMBEDDING_DIMENSIONS) {
+  return new arrow.Schema([
+    field('schema_version', new arrow.Int32()),
+    field('record_id', new arrow.Utf8()),
+    field('space_id', new arrow.Utf8()),
+    field('entry_id', new arrow.Utf8()),
+    field('entry_type', new arrow.Utf8()),
+    field('entry_version', new arrow.Int32()),
+    field('chunk_id', new arrow.Utf8()),
+    field('chunk_order', new arrow.Int32()),
+    field('title', new arrow.Utf8()),
+    field('heading_path', new arrow.Utf8()),
+    field('chunk_text', new arrow.Utf8()),
+    field('search_text', new arrow.Utf8()),
+    field('vector', new arrow.FixedSizeList(dimensions, field('item', new arrow.Float32()))),
+    field('tags_json', new arrow.Utf8()),
+    field('source_paths_json', new arrow.Utf8()),
+    field('routes_json', new arrow.Utf8()),
+    field('symbols_json', new arrow.Utf8()),
+    field('source_project_id', new arrow.Utf8()),
+    field('source_commit', new arrow.Utf8()),
+    field('document_hash', new arrow.Utf8()),
+    field('content_hash', new arrow.Utf8()),
+    field('created_at', new arrow.Utf8()),
+    field('updated_at', new arrow.Utf8()),
+  ]);
+}
+
+function sha256(value) {
+  return crypto.createHash('sha256').update(String(value || ''), 'utf8').digest('hex');
+}
+
+function requiredText(value, name) {
+  const normalized = String(value || '').trim();
+  if (!normalized) throw new Error(`${name} is required`);
+  return normalized;
+}
+
+function jsonArray(value) {
+  return JSON.stringify(Array.isArray(value) ? value.map(item => String(item)) : []);
+}
+
+function normalizeVector(value, dimensions = EMBEDDING_DIMENSIONS) {
+  const vector = Array.from(value || [], Number);
+  if (vector.length !== dimensions || vector.some(item => !Number.isFinite(item))) {
+    throw new Error(`vector must contain exactly ${dimensions} finite numbers`);
+  }
+  return vector;
+}
+
+function normalizeKnowledgeChunk(input, options = {}) {
+  const dimensions = options.dimensions || EMBEDDING_DIMENSIONS;
+  const now = options.now || new Date().toISOString();
+  const spaceId = requiredText(input.spaceId || input.space_id, 'spaceId');
+  const entryId = requiredText(input.entryId || input.entry_id, 'entryId');
+  const chunkOrder = Number.isInteger(input.chunkOrder) ? input.chunkOrder : Number(input.chunk_order || 0);
+  if (!Number.isInteger(chunkOrder) || chunkOrder < 0) throw new Error('chunkOrder must be a non-negative integer');
+  const chunkText = requiredText(input.chunkText || input.chunk_text, 'chunkText');
+  const contentHash = String(input.contentHash || input.content_hash || sha256(chunkText));
+  const chunkId = String(input.chunkId || input.chunk_id || `${entryId}:${chunkOrder}`);
+
+  return {
+    schema_version: KNOWLEDGE_DB_SCHEMA_VERSION,
+    record_id: `${spaceId}:${chunkId}`,
+    space_id: spaceId,
+    entry_id: entryId,
+    entry_type: String(input.entryType || input.entry_type || 'document'),
+    entry_version: Number.isInteger(input.entryVersion) ? input.entryVersion : Number(input.entry_version || 1),
+    chunk_id: chunkId,
+    chunk_order: chunkOrder,
+    title: String(input.title || ''),
+    heading_path: Array.isArray(input.headingPath) ? input.headingPath.join(' > ') : String(input.heading_path || ''),
+    chunk_text: chunkText,
+    search_text: String(input.searchText || input.search_text || `${input.title || ''}\n${chunkText}`).trim(),
+    vector: normalizeVector(input.vector, dimensions),
+    tags_json: jsonArray(input.tags),
+    source_paths_json: jsonArray(input.sourcePaths || input.source_paths),
+    routes_json: jsonArray(input.routes),
+    symbols_json: jsonArray(input.symbols),
+    source_project_id: String(input.sourceProjectId || input.source_project_id || ''),
+    source_commit: String(input.sourceCommit || input.source_commit || ''),
+    document_hash: String(input.documentHash || input.document_hash || contentHash),
+    content_hash: contentHash,
+    created_at: String(input.createdAt || input.created_at || now),
+    updated_at: String(input.updatedAt || input.updated_at || now),
+  };
+}
+
+function decodeKnowledgeChunk(row) {
+  const parse = (value) => {
+    try { return JSON.parse(value || '[]'); } catch { return []; }
+  };
+  return {
+    ...row,
+    tags: parse(row.tags_json),
+    sourcePaths: parse(row.source_paths_json),
+    routes: parse(row.routes_json),
+    symbols: parse(row.symbols_json),
+  };
+}
+
+module.exports = {
+  KNOWLEDGE_DB_SCHEMA_VERSION,
+  KNOWLEDGE_TABLE,
+  EMBEDDING_DIMENSIONS,
+  knowledgeChunkSchema,
+  normalizeKnowledgeChunk,
+  decodeKnowledgeChunk,
+  sha256,
+};

package/_site/lib/live-gateway.js

@@ -1,76 +1,78 @@
-'use strict';
-const { WebSocketServer } = require('ws');
-const { TextDecoder } = require('node:util');
-
-function attachLiveGateway(server, runtime) {
-  const wss = new WebSocketServer({ noServer: true, maxPayload: 8192 });
-  function target(route) {
-    const url = new URL(route, 'http://local');
-    if (url.origin !== 'http://local' || !route.startsWith('/') || route.length > 2048) throw new Error('INVALID_ROUTE');
-    if ([...url.searchParams.keys()].some(k => !['after', 'projectId', 'level', 'component', 'event', 'q', 'operationId', 'runId', 'commitSha', 'limit', 'summary', 'jobId', 'since', 'streamCursor'].includes(k))) throw new Error('INVALID_QUERY');
-    const bridge = runtime.moduleBridge;
-    if (url.pathname === '/api/engine/progress') {
-      if (bridge.engineCompatible === false) throw new Error('ENGINE_CONNECTION_PENDING');
-      return `${bridge.engineUrl}/api/progress${url.search}`;
-    }
-    if (/^\/api\/terminal\/sessions\/[a-zA-Z0-9_-]+\/events$/.test(url.pathname)) return bridge._terminalApi(url.pathname) + url.search;
-    if (url.pathname === '/api/logs/stream') return `http://${runtime.liveAddress}${route}`;
-    throw new Error('INVALID_ROUTE');
-  }
-  server.on('upgrade', (req, socket, head) => {
-    const local = ['127.0.0.1', '::1', '::ffff:127.0.0.1'].includes(req.socket.remoteAddress);
-    let hostname; try { hostname = new URL(`http://${req.headers.host}`).hostname; } catch { socket.destroy(); return; }
-    if (req.url !== '/api/live' || !local || !['127.0.0.1', 'localhost', '[::1]'].includes(hostname) || req.headers.origin !== `http://${req.headers.host}`) { socket.destroy(); return; }
-    wss.handleUpgrade(req, socket, head, ws => wss.emit('connection', ws));
-  });
-  wss.on('connection', ws => {
-    const subscriptions = new Map();
-    const send = payload => {
-      if (ws.readyState !== 1) return;
-      if (ws.bufferedAmount > 1024 * 1024) { ws.close(1013, 'slow consumer'); return; }
-      ws.send(JSON.stringify(payload));
-    };
-    const stop = id => { subscriptions.get(id)?.abort(); subscriptions.delete(id); };
-    ws.on('message', async bytes => {
-      let message, controller;
-      try {
-        message = JSON.parse(String(bytes));
-        if (typeof message?.id !== 'string' || !/^[a-zA-Z0-9_-]{1,80}$/.test(message.id)) throw new Error('INVALID_SUBSCRIPTION');
-        if (message.type === 'unsubscribe') { stop(message.id); return; }
-        if (message.type !== 'subscribe' || subscriptions.size >= 8) throw new Error('INVALID_SUBSCRIPTION');
-        const url = target(message.route); stop(message.id);
-        controller = new AbortController(); subscriptions.set(message.id, controller);
-        const deadline = setTimeout(() => controller.abort(), 3000);
-        let upstream;
-        try { upstream = await fetch(url, { signal: controller.signal, headers: message.after ? { 'Last-Event-ID': String(message.after).slice(0, 128) } : {} }); }
-        finally { clearTimeout(deadline); }
-        if (!upstream.ok || !upstream.headers.get('content-type')?.includes('text/event-stream')) throw new Error('UPSTREAM_UNAVAILABLE');
-        send({ id: message.id, type: 'open' });
-        const decoder = new TextDecoder(); let buffer = '';
-        for await (const chunk of upstream.body) {
-          buffer += decoder.decode(chunk, { stream: true });
-          if (buffer.length > 2 * 1024 * 1024) throw new Error('EVENT_TOO_LARGE');
-          let boundary;
-          while ((boundary = /\r?\n\r?\n/.exec(buffer))) {
-            const block = buffer.slice(0, boundary.index); buffer = buffer.slice(boundary.index + boundary[0].length);
-            let event = 'message', data = [], cursor;
-            for (const line of block.split(/\r?\n/)) {
-              const colon = line.indexOf(':'), key = colon < 0 ? line : line.slice(0, colon), value = colon < 0 ? '' : line.slice(colon + 1).replace(/^ /, '');
-              if (key === 'event') event = value; else if (key === 'data') data.push(value); else if (key === 'id') cursor = value;
-            }
-            if (data.length && subscriptions.get(message.id) === controller) send({ type: 'event', id: message.id, event, data: data.join('\n'), cursor });
-          }
-        }
-        if (!controller.signal.aborted) throw new Error('UPSTREAM_CLOSED');
-      } catch {
-        if (controller) { if (subscriptions.get(message.id) === controller) { stop(message.id); send({ type: 'error', id: message.id, code: 'STREAM_UNAVAILABLE' }); } }
-        else send({ type: 'error', id: message?.id, code: 'INVALID_SUBSCRIPTION' });
-      }
-    });
-    const heartbeat = setInterval(() => { if (ws.isAlive === false) return ws.terminate(); ws.isAlive = false; ws.ping(); }, 30000);
-    ws.on('pong', () => { ws.isAlive = true; });
-    ws.on('close', () => { clearInterval(heartbeat); for (const id of subscriptions.keys()) stop(id); });
-  });
-  return { close() { for (const ws of wss.clients) ws.terminate(); wss.close(); } };
-}
-module.exports = { attachLiveGateway };
+'use strict';
+const { WebSocketServer } = require('ws');
+const { TextDecoder } = require('node:util');
+
+function attachLiveGateway(server, runtime) {
+  const wss = new WebSocketServer({ noServer: true, maxPayload: 8192 });
+  function target(route) {
+    const url = new URL(route, 'http://local');
+    if (url.origin !== 'http://local' || !route.startsWith('/') || route.length > 2048) throw new Error('INVALID_ROUTE');
+    if ([...url.searchParams.keys()].some(k => !['after', 'projectId', 'contextId', 'level', 'component', 'event', 'q', 'operationId', 'runId', 'commitSha', 'limit', 'summary', 'jobId', 'since', 'streamCursor'].includes(k))) throw new Error('INVALID_QUERY');
+    const bridge = runtime.moduleBridge;
+    if (url.pathname === '/api/engine/progress') {
+      if (bridge.engineCompatible === false) throw new Error('ENGINE_CONNECTION_PENDING');
+      return `${bridge.engineUrl}/api/progress${url.search}`;
+    }
+    if (/^\/api\/terminal\/sessions\/[a-zA-Z0-9_-]+\/events$/.test(url.pathname)) return bridge._terminalApi(url.pathname) + url.search;
+    if (url.pathname === '/api/terminal/sessions/changes') return bridge._terminalApi(url.pathname) + url.search;
+    if (url.pathname === '/api/registry/events') return `http://${runtime.liveAddress}${route}`;
+    if (url.pathname === '/api/logs/stream') return `http://${runtime.liveAddress}${route}`;
+    throw new Error('INVALID_ROUTE');
+  }
+  server.on('upgrade', (req, socket, head) => {
+    const local = ['127.0.0.1', '::1', '::ffff:127.0.0.1'].includes(req.socket.remoteAddress);
+    let hostname; try { hostname = new URL(`http://${req.headers.host}`).hostname; } catch { socket.destroy(); return; }
+    if (req.url !== '/api/live' || !local || !['127.0.0.1', 'localhost', '[::1]'].includes(hostname) || req.headers.origin !== `http://${req.headers.host}`) { socket.destroy(); return; }
+    wss.handleUpgrade(req, socket, head, ws => wss.emit('connection', ws));
+  });
+  wss.on('connection', ws => {
+    const subscriptions = new Map();
+    const send = payload => {
+      if (ws.readyState !== 1) return;
+      if (ws.bufferedAmount > 1024 * 1024) { ws.close(1013, 'slow consumer'); return; }
+      ws.send(JSON.stringify(payload));
+    };
+    const stop = id => { subscriptions.get(id)?.abort(); subscriptions.delete(id); };
+    ws.on('message', async bytes => {
+      let message, controller;
+      try {
+        message = JSON.parse(String(bytes));
+        if (typeof message?.id !== 'string' || !/^[a-zA-Z0-9_-]{1,80}$/.test(message.id)) throw new Error('INVALID_SUBSCRIPTION');
+        if (message.type === 'unsubscribe') { stop(message.id); return; }
+        if (message.type !== 'subscribe' || subscriptions.size >= 8) throw new Error('INVALID_SUBSCRIPTION');
+        const url = target(message.route); stop(message.id);
+        controller = new AbortController(); subscriptions.set(message.id, controller);
+        const deadline = setTimeout(() => controller.abort(), 3000);
+        let upstream;
+        try { upstream = await fetch(url, { signal: controller.signal, headers: message.after ? { 'Last-Event-ID': String(message.after).slice(0, 128) } : {} }); }
+        finally { clearTimeout(deadline); }
+        if (!upstream.ok || !upstream.headers.get('content-type')?.includes('text/event-stream')) throw new Error('UPSTREAM_UNAVAILABLE');
+        send({ id: message.id, type: 'open' });
+        const decoder = new TextDecoder(); let buffer = '';
+        for await (const chunk of upstream.body) {
+          buffer += decoder.decode(chunk, { stream: true });
+          if (buffer.length > 2 * 1024 * 1024) throw new Error('EVENT_TOO_LARGE');
+          let boundary;
+          while ((boundary = /\r?\n\r?\n/.exec(buffer))) {
+            const block = buffer.slice(0, boundary.index); buffer = buffer.slice(boundary.index + boundary[0].length);
+            let event = 'message', data = [], cursor;
+            for (const line of block.split(/\r?\n/)) {
+              const colon = line.indexOf(':'), key = colon < 0 ? line : line.slice(0, colon), value = colon < 0 ? '' : line.slice(colon + 1).replace(/^ /, '');
+              if (key === 'event') event = value; else if (key === 'data') data.push(value); else if (key === 'id') cursor = value;
+            }
+            if (data.length && subscriptions.get(message.id) === controller) send({ type: 'event', id: message.id, event, data: data.join('\n'), cursor });
+          }
+        }
+        if (!controller.signal.aborted) throw new Error('UPSTREAM_CLOSED');
+      } catch {
+        if (controller) { if (subscriptions.get(message.id) === controller) { stop(message.id); send({ type: 'error', id: message.id, code: 'STREAM_UNAVAILABLE' }); } }
+        else send({ type: 'error', id: message?.id, code: 'INVALID_SUBSCRIPTION' });
+      }
+    });
+    const heartbeat = setInterval(() => { if (ws.isAlive === false) return ws.terminate(); ws.isAlive = false; ws.ping(); }, 30000);
+    ws.on('pong', () => { ws.isAlive = true; });
+    ws.on('close', () => { clearInterval(heartbeat); for (const id of subscriptions.keys()) stop(id); });
+  });
+  return { close() { for (const ws of wss.clients) ws.terminate(); wss.close(); } };
+}
+module.exports = { attachLiveGateway };

package/_site/lib/llm-client.js

@@ -39,12 +39,12 @@ function findProfile(profileId) {
   return readProfilesFile().find(profile => profile && profile.id === profileId) || null;
 }
 
-function readConfig(options = {}) {
-  const profileId = typeof options === 'string' ? options : options.profileId;
-  const inlineProfile = options && typeof options === 'object' && options.profile && typeof options.profile === 'object'
-    ? options.profile
-    : null;
-  const profile = inlineProfile || findProfile(profileId) || {};
+function readConfig(options = {}) {
+  const profileId = typeof options === 'string' ? options : options.profileId;
+  const inlineProfile = options && typeof options === 'object' && options.profile && typeof options.profile === 'object'
+    ? options.profile
+    : null;
+  const profile = inlineProfile || findProfile(profileId) || {};
   const timeoutMs = Number(profile.timeoutMs || process.env.API_TIMEOUT_MS || 60_000);
   return {
     profileId: profile.id || profileId || null,
@@ -102,8 +102,8 @@ function postJson({ baseUrl, path: p, body, apiKey, version, timeoutMs = 60_000
   });
 }
 
-async function completeText({ system, user, maxTokens = 512, model, profileId, profile }) {
-  const cfg = readConfig({ profileId, profile });
+async function completeText({ system, user, maxTokens = 512, model, profileId, profile }) {
+  const cfg = readConfig({ profileId, profile });
   if (!cfg.apiKey) {
     const id = profileId ? ` for profile ${profileId}` : '';
     throw new Error(`API key not set${id}`);
@@ -139,10 +139,10 @@ async function completeText({ system, user, maxTokens = 512, model, profileId, p
   };
 }
 
-async function completeJson({ system, user, schema, maxTokens = 2048, model, profileId, profile }) {
-  const schemaHint = schema ? `\n\nThe output MUST be a JSON object matching this schema:\n${schema}\n` : '';
-  const finalUser = `${user}${schemaHint}\n\nRespond with ONLY the JSON object, no prose, no markdown fences.`;
-  const result = await completeText({ system, user: finalUser, maxTokens, model, profileId, profile });
+async function completeJson({ system, user, schema, maxTokens = 2048, model, profileId, profile }) {
+  const schemaHint = schema ? `\n\nThe output MUST be a JSON object matching this schema:\n${schema}\n` : '';
+  const finalUser = `${user}${schemaHint}\n\nRespond with ONLY the JSON object, no prose, no markdown fences.`;
+  const result = await completeText({ system, user: finalUser, maxTokens, model, profileId, profile });
   const text = result.text;
 
   let parsed = null;

package/_site/lib/model-context-windows.js

@@ -1,82 +1,82 @@
-// Per-family context window sizes (in tokens) for common models.
-// Match strategy: lowercase the model name, then prefix-match — first hit wins.
-// Entry order matters: more specific prefixes (e.g. 'claude-opus-4') precede
-// broader ones (e.g. 'claude'). Keep specific entries above generic ones.
-const MODEL_CONTEXT_WINDOWS = [
-  // Anthropic Claude — full family 200K
-  ['claude-opus-4', 200000],
-  ['claude-sonnet-4', 200000],
-  ['claude-haiku-4', 200000],
-  ['claude-3-7', 200000],
-  ['claude-3-5', 200000],
-  ['claude-3', 200000],
-  ['claude', 200000],
-
-  // MiniMax
-  ['minimax-m3', 1048576],
-  ['minimax-m2', 1048576],
-  ['minimax', 1048576],
-
-  // Zhipu GLM
-  ['glm-5', 1048576],
-  ['glm-4.6', 1048576],
-  ['glm-4.5', 128000],
-  ['glm-4-plus', 128000],
-  ['glm-4', 128000],
-  ['glm', 128000],
-
-  // DeepSeek
-  ['deepseek-v3', 128000],
-  ['deepseek-r1', 128000],
-  ['deepseek', 64000],
-
-  // OpenAI
-  ['gpt-5', 200000],
-  ['gpt-4.1', 1047576],
-  ['gpt-4o', 128000],
-  ['gpt-4-turbo', 128000],
-  ['gpt-4', 8192],
-  ['o3', 200000],
-  ['o4-mini', 200000],
-  ['o1', 200000],
-
-  // Qwen
-  ['qwen3', 131072],
-  ['qwen-max', 32768],
-  ['qwen', 32768],
-
-  // Google Gemini
-  ['gemini-2.5', 1048576],
-  ['gemini-1.5', 1048576],
-  ['gemini', 32768],
-];
-
-function normalizeModelName(model) {
-  return String(model || '').trim().toLowerCase();
-}
-
-function lookupContextWindow(modelName) {
-  const name = normalizeModelName(modelName);
-  if (!name) return null;
-  for (const [prefix, size] of MODEL_CONTEXT_WINDOWS) {
-    if (name.startsWith(prefix)) return size;
-  }
-  return null;
-}
-
-// Resolution order: explicit profile override → model table → env var → fallback.
-function resolveContextWindow({ profileContextWindow, model, env = process.env, fallback = 200000 } = {}) {
-  const explicit = Number(profileContextWindow);
-  if (Number.isFinite(explicit) && explicit > 0) return Math.floor(explicit);
-  const tableHit = lookupContextWindow(model);
-  if (tableHit) return tableHit;
-  const envValue = Number(env && env.CLAUDE_CONTEXT_WINDOW);
-  if (Number.isFinite(envValue) && envValue > 0) return Math.floor(envValue);
-  return fallback;
-}
-
-module.exports = {
-  MODEL_CONTEXT_WINDOWS,
-  lookupContextWindow,
-  resolveContextWindow,
-};
+// Per-family context window sizes (in tokens) for common models.
+// Match strategy: lowercase the model name, then prefix-match — first hit wins.
+// Entry order matters: more specific prefixes (e.g. 'claude-opus-4') precede
+// broader ones (e.g. 'claude'). Keep specific entries above generic ones.
+const MODEL_CONTEXT_WINDOWS = [
+  // Anthropic Claude — full family 200K
+  ['claude-opus-4', 200000],
+  ['claude-sonnet-4', 200000],
+  ['claude-haiku-4', 200000],
+  ['claude-3-7', 200000],
+  ['claude-3-5', 200000],
+  ['claude-3', 200000],
+  ['claude', 200000],
+
+  // MiniMax
+  ['minimax-m3', 1048576],
+  ['minimax-m2', 1048576],
+  ['minimax', 1048576],
+
+  // Zhipu GLM
+  ['glm-5', 1048576],
+  ['glm-4.6', 1048576],
+  ['glm-4.5', 128000],
+  ['glm-4-plus', 128000],
+  ['glm-4', 128000],
+  ['glm', 128000],
+
+  // DeepSeek
+  ['deepseek-v3', 128000],
+  ['deepseek-r1', 128000],
+  ['deepseek', 64000],
+
+  // OpenAI
+  ['gpt-5', 200000],
+  ['gpt-4.1', 1047576],
+  ['gpt-4o', 128000],
+  ['gpt-4-turbo', 128000],
+  ['gpt-4', 8192],
+  ['o3', 200000],
+  ['o4-mini', 200000],
+  ['o1', 200000],
+
+  // Qwen
+  ['qwen3', 131072],
+  ['qwen-max', 32768],
+  ['qwen', 32768],
+
+  // Google Gemini
+  ['gemini-2.5', 1048576],
+  ['gemini-1.5', 1048576],
+  ['gemini', 32768],
+];
+
+function normalizeModelName(model) {
+  return String(model || '').trim().toLowerCase();
+}
+
+function lookupContextWindow(modelName) {
+  const name = normalizeModelName(modelName);
+  if (!name) return null;
+  for (const [prefix, size] of MODEL_CONTEXT_WINDOWS) {
+    if (name.startsWith(prefix)) return size;
+  }
+  return null;
+}
+
+// Resolution order: explicit profile override → model table → env var → fallback.
+function resolveContextWindow({ profileContextWindow, model, env = process.env, fallback = 200000 } = {}) {
+  const explicit = Number(profileContextWindow);
+  if (Number.isFinite(explicit) && explicit > 0) return Math.floor(explicit);
+  const tableHit = lookupContextWindow(model);
+  if (tableHit) return tableHit;
+  const envValue = Number(env && env.CLAUDE_CONTEXT_WINDOW);
+  if (Number.isFinite(envValue) && envValue > 0) return Math.floor(envValue);
+  return fallback;
+}
+
+module.exports = {
+  MODEL_CONTEXT_WINDOWS,
+  lookupContextWindow,
+  resolveContextWindow,
+};