@bastani/atomic 0.8.30 → 0.8.31-alpha.1

package/dist/core/context-window.d.ts

@@ -0,0 +1,29 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+declare module "@earendil-works/pi-ai" {
+    interface Model<TApi extends Api> {
+        /** Selectable context-window sizes for this model. The scalar contextWindow remains the default/effective value. */
+        contextWindowOptions?: readonly number[];
+        /** Original/default scalar context window, preserved when contextWindow is overridden for a session. */
+        defaultContextWindow?: number;
+    }
+}
+export interface ContextWindowParseResult {
+    value?: number;
+    error?: string;
+}
+export interface ContextWindowSelection<TApi extends Api = Api> {
+    model: Model<TApi>;
+    contextWindow: number;
+}
+export interface ContextWindowSelectionError {
+    error: string;
+}
+export declare function validateContextWindowValue(value: number): string | undefined;
+export declare function parseContextWindowValue(input: string): ContextWindowParseResult;
+export declare function formatContextWindow(value: number): string;
+export declare function normalizeContextWindowOptions(values: readonly number[] | undefined): number[];
+export declare function getModelDefaultContextWindow(model: Model<Api>): number;
+export declare function getSupportedContextWindows(model: Model<Api>): number[];
+export declare function withContextWindowOptions<TApi extends Api>(model: Model<TApi>, contextWindowOptions: readonly number[]): Model<TApi>;
+export declare function selectContextWindow<TApi extends Api>(model: Model<TApi>, contextWindow: number): ContextWindowSelection<TApi> | ContextWindowSelectionError;
+//# sourceMappingURL=context-window.d.ts.map

package/dist/core/context-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.d.ts","sourceRoot":"","sources":["../../src/core/context-window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,QAAQ,uBAAuB,CAAC,CAAC;IACvC,UAAU,KAAK,CAAC,IAAI,SAAS,GAAG;QAC/B,oHAAoH;QACpH,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACzC,wGAAwG;QACxG,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC9B;CACD;AAED,MAAM,WAAW,wBAAwB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB,CAAC,IAAI,SAAS,GAAG,GAAG,GAAG;IAC7D,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC3C,KAAK,EAAE,MAAM,CAAC;CACd;AAWD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAqB/E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAS7F;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAEtE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAEtE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,SAAS,GAAG,EACxD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,oBAAoB,EAAE,SAAS,MAAM,EAAE,GACrC,KAAK,CAAC,IAAI,CAAC,CAMb;AAED,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,GAAG,EACnD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,aAAa,EAAE,MAAM,GACnB,sBAAsB,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAsB5D","sourcesContent":["import type { Api, Model } from \"@earendil-works/pi-ai\";\n\ndeclare module \"@earendil-works/pi-ai\" {\n\tinterface Model<TApi extends Api> {\n\t\t/** Selectable context-window sizes for this model. The scalar contextWindow remains the default/effective value. */\n\t\tcontextWindowOptions?: readonly number[];\n\t\t/** Original/default scalar context window, preserved when contextWindow is overridden for a session. */\n\t\tdefaultContextWindow?: number;\n\t}\n}\n\nexport interface ContextWindowParseResult {\n\tvalue?: number;\n\terror?: string;\n}\n\nexport interface ContextWindowSelection<TApi extends Api = Api> {\n\tmodel: Model<TApi>;\n\tcontextWindow: number;\n}\n\nexport interface ContextWindowSelectionError {\n\terror: string;\n}\n\nconst CONTEXT_WINDOW_UNITS: Record<string, number> = {\n\tk: 1_000,\n\tm: 1_000_000,\n};\n\nfunction isPositiveInteger(value: number): boolean {\n\treturn Number.isFinite(value) && Number.isInteger(value) && value > 0;\n}\n\nexport function validateContextWindowValue(value: number): string | undefined {\n\treturn isPositiveInteger(value) ? undefined : \"Context window must be a positive integer token count\";\n}\n\nexport function parseContextWindowValue(input: string): ContextWindowParseResult {\n\tconst trimmed = input.trim();\n\tif (!trimmed) {\n\t\treturn { error: \"Context window requires a value\" };\n\t}\n\n\tconst match = /^(\\d+(?:\\.\\d+)?)([kKmM])?$/.exec(trimmed);\n\tif (!match) {\n\t\treturn { error: `Invalid context window \"${input}\". Use a positive number, or a compact value like 400k or 1m.` };\n\t}\n\n\tconst numericValue = Number(match[1]);\n\tconst unit = match[2]?.toLowerCase();\n\tconst multiplier = unit ? CONTEXT_WINDOW_UNITS[unit] : 1;\n\tconst tokens = numericValue * multiplier;\n\tconst validationError = validateContextWindowValue(tokens);\n\tif (validationError) {\n\t\treturn { error: `Invalid context window \"${input}\". ${validationError}.` };\n\t}\n\n\treturn { value: tokens };\n}\n\nexport function formatContextWindow(value: number): string {\n\tif (value >= 1_000_000) {\n\t\tconst millions = value / 1_000_000;\n\t\treturn millions % 1 === 0 ? `${millions}m` : `${millions.toFixed(1)}m`;\n\t}\n\tif (value >= 1_000) {\n\t\tconst thousands = value / 1_000;\n\t\treturn thousands % 1 === 0 ? `${thousands}k` : `${thousands.toFixed(1)}k`;\n\t}\n\treturn String(value);\n}\n\nexport function normalizeContextWindowOptions(values: readonly number[] | undefined): number[] {\n\tconst seen = new Set<number>();\n\tconst normalized: number[] = [];\n\tfor (const value of values ?? []) {\n\t\tif (!isPositiveInteger(value) || seen.has(value)) continue;\n\t\tseen.add(value);\n\t\tnormalized.push(value);\n\t}\n\treturn normalized.sort((a, b) => a - b);\n}\n\nexport function getModelDefaultContextWindow(model: Model<Api>): number {\n\treturn isPositiveInteger(model.defaultContextWindow ?? 0) ? model.defaultContextWindow! : model.contextWindow;\n}\n\nexport function getSupportedContextWindows(model: Model<Api>): number[] {\n\treturn normalizeContextWindowOptions([getModelDefaultContextWindow(model), ...(model.contextWindowOptions ?? [])]);\n}\n\nexport function withContextWindowOptions<TApi extends Api>(\n\tmodel: Model<TApi>,\n\tcontextWindowOptions: readonly number[],\n): Model<TApi> {\n\treturn {\n\t\t...model,\n\t\tdefaultContextWindow: getModelDefaultContextWindow(model as Model<Api>),\n\t\tcontextWindowOptions: normalizeContextWindowOptions(contextWindowOptions),\n\t};\n}\n\nexport function selectContextWindow<TApi extends Api>(\n\tmodel: Model<TApi>,\n\tcontextWindow: number,\n): ContextWindowSelection<TApi> | ContextWindowSelectionError {\n\tconst validationError = validateContextWindowValue(contextWindow);\n\tif (validationError) {\n\t\treturn { error: validationError };\n\t}\n\n\tconst supported = getSupportedContextWindows(model as Model<Api>);\n\tif (!supported.includes(contextWindow)) {\n\t\treturn {\n\t\t\terror: `Context window ${formatContextWindow(contextWindow)} is not supported by ${model.provider}/${model.id}. Supported values: ${supported.map(formatContextWindow).join(\", \")}.`,\n\t\t};\n\t}\n\n\treturn {\n\t\tmodel: {\n\t\t\t...model,\n\t\t\tdefaultContextWindow: getModelDefaultContextWindow(model as Model<Api>),\n\t\t\tcontextWindow,\n\t\t\tcontextWindowOptions: supported,\n\t\t},\n\t\tcontextWindow,\n\t};\n}\n"]}

package/dist/core/context-window.js

@@ -0,0 +1,86 @@
+const CONTEXT_WINDOW_UNITS = {
+    k: 1_000,
+    m: 1_000_000,
+};
+function isPositiveInteger(value) {
+    return Number.isFinite(value) && Number.isInteger(value) && value > 0;
+}
+export function validateContextWindowValue(value) {
+    return isPositiveInteger(value) ? undefined : "Context window must be a positive integer token count";
+}
+export function parseContextWindowValue(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return { error: "Context window requires a value" };
+    }
+    const match = /^(\d+(?:\.\d+)?)([kKmM])?$/.exec(trimmed);
+    if (!match) {
+        return { error: `Invalid context window "${input}". Use a positive number, or a compact value like 400k or 1m.` };
+    }
+    const numericValue = Number(match[1]);
+    const unit = match[2]?.toLowerCase();
+    const multiplier = unit ? CONTEXT_WINDOW_UNITS[unit] : 1;
+    const tokens = numericValue * multiplier;
+    const validationError = validateContextWindowValue(tokens);
+    if (validationError) {
+        return { error: `Invalid context window "${input}". ${validationError}.` };
+    }
+    return { value: tokens };
+}
+export function formatContextWindow(value) {
+    if (value >= 1_000_000) {
+        const millions = value / 1_000_000;
+        return millions % 1 === 0 ? `${millions}m` : `${millions.toFixed(1)}m`;
+    }
+    if (value >= 1_000) {
+        const thousands = value / 1_000;
+        return thousands % 1 === 0 ? `${thousands}k` : `${thousands.toFixed(1)}k`;
+    }
+    return String(value);
+}
+export function normalizeContextWindowOptions(values) {
+    const seen = new Set();
+    const normalized = [];
+    for (const value of values ?? []) {
+        if (!isPositiveInteger(value) || seen.has(value))
+            continue;
+        seen.add(value);
+        normalized.push(value);
+    }
+    return normalized.sort((a, b) => a - b);
+}
+export function getModelDefaultContextWindow(model) {
+    return isPositiveInteger(model.defaultContextWindow ?? 0) ? model.defaultContextWindow : model.contextWindow;
+}
+export function getSupportedContextWindows(model) {
+    return normalizeContextWindowOptions([getModelDefaultContextWindow(model), ...(model.contextWindowOptions ?? [])]);
+}
+export function withContextWindowOptions(model, contextWindowOptions) {
+    return {
+        ...model,
+        defaultContextWindow: getModelDefaultContextWindow(model),
+        contextWindowOptions: normalizeContextWindowOptions(contextWindowOptions),
+    };
+}
+export function selectContextWindow(model, contextWindow) {
+    const validationError = validateContextWindowValue(contextWindow);
+    if (validationError) {
+        return { error: validationError };
+    }
+    const supported = getSupportedContextWindows(model);
+    if (!supported.includes(contextWindow)) {
+        return {
+            error: `Context window ${formatContextWindow(contextWindow)} is not supported by ${model.provider}/${model.id}. Supported values: ${supported.map(formatContextWindow).join(", ")}.`,
+        };
+    }
+    return {
+        model: {
+            ...model,
+            defaultContextWindow: getModelDefaultContextWindow(model),
+            contextWindow,
+            contextWindowOptions: supported,
+        },
+        contextWindow,
+    };
+}
+//# sourceMappingURL=context-window.js.map

package/dist/core/context-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.js","sourceRoot":"","sources":["../../src/core/context-window.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Api, Model } from \"@earendil-works/pi-ai\";\n\ndeclare module \"@earendil-works/pi-ai\" {\n\tinterface Model<TApi extends Api> {\n\t\t/** Selectable context-window sizes for this model. The scalar contextWindow remains the default/effective value. */\n\t\tcontextWindowOptions?: readonly number[];\n\t\t/** Original/default scalar context window, preserved when contextWindow is overridden for a session. */\n\t\tdefaultContextWindow?: number;\n\t}\n}\n\nexport interface ContextWindowParseResult {\n\tvalue?: number;\n\terror?: string;\n}\n\nexport interface ContextWindowSelection<TApi extends Api = Api> {\n\tmodel: Model<TApi>;\n\tcontextWindow: number;\n}\n\nexport interface ContextWindowSelectionError {\n\terror: string;\n}\n\nconst CONTEXT_WINDOW_UNITS: Record<string, number> = {\n\tk: 1_000,\n\tm: 1_000_000,\n};\n\nfunction isPositiveInteger(value: number): boolean {\n\treturn Number.isFinite(value) && Number.isInteger(value) && value > 0;\n}\n\nexport function validateContextWindowValue(value: number): string | undefined {\n\treturn isPositiveInteger(value) ? undefined : \"Context window must be a positive integer token count\";\n}\n\nexport function parseContextWindowValue(input: string): ContextWindowParseResult {\n\tconst trimmed = input.trim();\n\tif (!trimmed) {\n\t\treturn { error: \"Context window requires a value\" };\n\t}\n\n\tconst match = /^(\\d+(?:\\.\\d+)?)([kKmM])?$/.exec(trimmed);\n\tif (!match) {\n\t\treturn { error: `Invalid context window \"${input}\". Use a positive number, or a compact value like 400k or 1m.` };\n\t}\n\n\tconst numericValue = Number(match[1]);\n\tconst unit = match[2]?.toLowerCase();\n\tconst multiplier = unit ? CONTEXT_WINDOW_UNITS[unit] : 1;\n\tconst tokens = numericValue * multiplier;\n\tconst validationError = validateContextWindowValue(tokens);\n\tif (validationError) {\n\t\treturn { error: `Invalid context window \"${input}\". ${validationError}.` };\n\t}\n\n\treturn { value: tokens };\n}\n\nexport function formatContextWindow(value: number): string {\n\tif (value >= 1_000_000) {\n\t\tconst millions = value / 1_000_000;\n\t\treturn millions % 1 === 0 ? `${millions}m` : `${millions.toFixed(1)}m`;\n\t}\n\tif (value >= 1_000) {\n\t\tconst thousands = value / 1_000;\n\t\treturn thousands % 1 === 0 ? `${thousands}k` : `${thousands.toFixed(1)}k`;\n\t}\n\treturn String(value);\n}\n\nexport function normalizeContextWindowOptions(values: readonly number[] | undefined): number[] {\n\tconst seen = new Set<number>();\n\tconst normalized: number[] = [];\n\tfor (const value of values ?? []) {\n\t\tif (!isPositiveInteger(value) || seen.has(value)) continue;\n\t\tseen.add(value);\n\t\tnormalized.push(value);\n\t}\n\treturn normalized.sort((a, b) => a - b);\n}\n\nexport function getModelDefaultContextWindow(model: Model<Api>): number {\n\treturn isPositiveInteger(model.defaultContextWindow ?? 0) ? model.defaultContextWindow! : model.contextWindow;\n}\n\nexport function getSupportedContextWindows(model: Model<Api>): number[] {\n\treturn normalizeContextWindowOptions([getModelDefaultContextWindow(model), ...(model.contextWindowOptions ?? [])]);\n}\n\nexport function withContextWindowOptions<TApi extends Api>(\n\tmodel: Model<TApi>,\n\tcontextWindowOptions: readonly number[],\n): Model<TApi> {\n\treturn {\n\t\t...model,\n\t\tdefaultContextWindow: getModelDefaultContextWindow(model as Model<Api>),\n\t\tcontextWindowOptions: normalizeContextWindowOptions(contextWindowOptions),\n\t};\n}\n\nexport function selectContextWindow<TApi extends Api>(\n\tmodel: Model<TApi>,\n\tcontextWindow: number,\n): ContextWindowSelection<TApi> | ContextWindowSelectionError {\n\tconst validationError = validateContextWindowValue(contextWindow);\n\tif (validationError) {\n\t\treturn { error: validationError };\n\t}\n\n\tconst supported = getSupportedContextWindows(model as Model<Api>);\n\tif (!supported.includes(contextWindow)) {\n\t\treturn {\n\t\t\terror: `Context window ${formatContextWindow(contextWindow)} is not supported by ${model.provider}/${model.id}. Supported values: ${supported.map(formatContextWindow).join(\", \")}.`,\n\t\t};\n\t}\n\n\treturn {\n\t\tmodel: {\n\t\t\t...model,\n\t\t\tdefaultContextWindow: getModelDefaultContextWindow(model as Model<Api>),\n\t\t\tcontextWindow,\n\t\t\tcontextWindowOptions: supported,\n\t\t},\n\t\tcontextWindow,\n\t};\n}\n"]}

package/dist/core/copilot-errors.d.ts

@@ -0,0 +1,9 @@
+export interface CopilotPromptLimitError {
+    promptTokens: number;
+    limitTokens: number;
+}
+export declare function parseCopilotPromptLimitError(errorMessage: string): CopilotPromptLimitError | undefined;
+export declare function isCopilotPromptLimitError(errorMessage: string): boolean;
+export declare function formatCopilotPromptLimitError(errorMessage: string): string;
+export declare function formatCopilotProviderError(modelProvider: string, errorMessage: string): string;
+//# sourceMappingURL=copilot-errors.d.ts.map

package/dist/core/copilot-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-errors.d.ts","sourceRoot":"","sources":["../../src/core/copilot-errors.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAUtG;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9F","sourcesContent":["const COPILOT_PROMPT_LIMIT_PATTERN = /\\bprompt token count of ([\\d,]+) exceeds the limit of ([\\d,]+)/i;\nconst COPILOT_LONG_CONTEXT_GUIDANCE_MARKER = \"Copilot long-context/usage-based billing\";\n\nexport interface CopilotPromptLimitError {\n\tpromptTokens: number;\n\tlimitTokens: number;\n}\n\nfunction parseTokenCount(value: string): number {\n\treturn Number(value.replace(/,/g, \"\"));\n}\n\nexport function parseCopilotPromptLimitError(errorMessage: string): CopilotPromptLimitError | undefined {\n\tconst match = COPILOT_PROMPT_LIMIT_PATTERN.exec(errorMessage);\n\tif (!match) return undefined;\n\tconst promptTokenText = match[1];\n\tconst limitTokenText = match[2];\n\tif (!promptTokenText || !limitTokenText) return undefined;\n\tconst promptTokens = parseTokenCount(promptTokenText);\n\tconst limitTokens = parseTokenCount(limitTokenText);\n\tif (!Number.isFinite(promptTokens) || !Number.isFinite(limitTokens)) return undefined;\n\treturn { promptTokens, limitTokens };\n}\n\nexport function isCopilotPromptLimitError(errorMessage: string): boolean {\n\treturn parseCopilotPromptLimitError(errorMessage) !== undefined;\n}\n\nexport function formatCopilotPromptLimitError(errorMessage: string): string {\n\tif (!isCopilotPromptLimitError(errorMessage) || errorMessage.includes(COPILOT_LONG_CONTEXT_GUIDANCE_MARKER)) {\n\t\treturn errorMessage;\n\t}\n\n\treturn `${errorMessage}\\n\\nGitHub Copilot rejected this prompt at the API/server context cap. Atomic raises the local token budget for selected larger context windows and sends X-GitHub-Api-Version: 2026-06-01 so Copilot can choose its long-context tier server-side by prompt token count, but GitHub still requires the account to have Copilot long-context/usage-based billing entitlement enabled. Long-context Copilot requests consume higher-cost AI credits. Reduce the session context, choose a smaller context window/model, or enable the required Copilot long-context/usage-based billing entitlement for this account.`;\n}\n\nexport function formatCopilotProviderError(modelProvider: string, errorMessage: string): string {\n\treturn modelProvider === \"github-copilot\" ? formatCopilotPromptLimitError(errorMessage) : errorMessage;\n}\n"]}

package/dist/core/copilot-errors.js

@@ -0,0 +1,32 @@
+const COPILOT_PROMPT_LIMIT_PATTERN = /\bprompt token count of ([\d,]+) exceeds the limit of ([\d,]+)/i;
+const COPILOT_LONG_CONTEXT_GUIDANCE_MARKER = "Copilot long-context/usage-based billing";
+function parseTokenCount(value) {
+    return Number(value.replace(/,/g, ""));
+}
+export function parseCopilotPromptLimitError(errorMessage) {
+    const match = COPILOT_PROMPT_LIMIT_PATTERN.exec(errorMessage);
+    if (!match)
+        return undefined;
+    const promptTokenText = match[1];
+    const limitTokenText = match[2];
+    if (!promptTokenText || !limitTokenText)
+        return undefined;
+    const promptTokens = parseTokenCount(promptTokenText);
+    const limitTokens = parseTokenCount(limitTokenText);
+    if (!Number.isFinite(promptTokens) || !Number.isFinite(limitTokens))
+        return undefined;
+    return { promptTokens, limitTokens };
+}
+export function isCopilotPromptLimitError(errorMessage) {
+    return parseCopilotPromptLimitError(errorMessage) !== undefined;
+}
+export function formatCopilotPromptLimitError(errorMessage) {
+    if (!isCopilotPromptLimitError(errorMessage) || errorMessage.includes(COPILOT_LONG_CONTEXT_GUIDANCE_MARKER)) {
+        return errorMessage;
+    }
+    return `${errorMessage}\n\nGitHub Copilot rejected this prompt at the API/server context cap. Atomic raises the local token budget for selected larger context windows and sends X-GitHub-Api-Version: 2026-06-01 so Copilot can choose its long-context tier server-side by prompt token count, but GitHub still requires the account to have Copilot long-context/usage-based billing entitlement enabled. Long-context Copilot requests consume higher-cost AI credits. Reduce the session context, choose a smaller context window/model, or enable the required Copilot long-context/usage-based billing entitlement for this account.`;
+}
+export function formatCopilotProviderError(modelProvider, errorMessage) {
+    return modelProvider === "github-copilot" ? formatCopilotPromptLimitError(errorMessage) : errorMessage;
+}
+//# sourceMappingURL=copilot-errors.js.map

package/dist/core/copilot-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-errors.js","sourceRoot":"","sources":["../../src/core/copilot-errors.ts"],"names":[],"mappings":"AAAA,MAAM,4BAA4B,GAAG,iEAAiE,CAAC;AACvG,MAAM,oCAAoC,GAAG,0CAA0C,CAAC;AAOxF,SAAS,eAAe,CAAC,KAAa;IACrC,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,YAAoB;IAChE,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,eAAe,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,YAAY,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,YAAoB;IAC7D,OAAO,4BAA4B,CAAC,YAAY,CAAC,KAAK,SAAS,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,YAAoB;IACjE,IAAI,CAAC,yBAAyB,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,oCAAoC,CAAC,EAAE,CAAC;QAC7G,OAAO,YAAY,CAAC;IACrB,CAAC;IAED,OAAO,GAAG,YAAY,slBAAslB,CAAC;AAC9mB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,aAAqB,EAAE,YAAoB;IACrF,OAAO,aAAa,KAAK,gBAAgB,CAAC,CAAC,CAAC,6BAA6B,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AACxG,CAAC","sourcesContent":["const COPILOT_PROMPT_LIMIT_PATTERN = /\\bprompt token count of ([\\d,]+) exceeds the limit of ([\\d,]+)/i;\nconst COPILOT_LONG_CONTEXT_GUIDANCE_MARKER = \"Copilot long-context/usage-based billing\";\n\nexport interface CopilotPromptLimitError {\n\tpromptTokens: number;\n\tlimitTokens: number;\n}\n\nfunction parseTokenCount(value: string): number {\n\treturn Number(value.replace(/,/g, \"\"));\n}\n\nexport function parseCopilotPromptLimitError(errorMessage: string): CopilotPromptLimitError | undefined {\n\tconst match = COPILOT_PROMPT_LIMIT_PATTERN.exec(errorMessage);\n\tif (!match) return undefined;\n\tconst promptTokenText = match[1];\n\tconst limitTokenText = match[2];\n\tif (!promptTokenText || !limitTokenText) return undefined;\n\tconst promptTokens = parseTokenCount(promptTokenText);\n\tconst limitTokens = parseTokenCount(limitTokenText);\n\tif (!Number.isFinite(promptTokens) || !Number.isFinite(limitTokens)) return undefined;\n\treturn { promptTokens, limitTokens };\n}\n\nexport function isCopilotPromptLimitError(errorMessage: string): boolean {\n\treturn parseCopilotPromptLimitError(errorMessage) !== undefined;\n}\n\nexport function formatCopilotPromptLimitError(errorMessage: string): string {\n\tif (!isCopilotPromptLimitError(errorMessage) || errorMessage.includes(COPILOT_LONG_CONTEXT_GUIDANCE_MARKER)) {\n\t\treturn errorMessage;\n\t}\n\n\treturn `${errorMessage}\\n\\nGitHub Copilot rejected this prompt at the API/server context cap. Atomic raises the local token budget for selected larger context windows and sends X-GitHub-Api-Version: 2026-06-01 so Copilot can choose its long-context tier server-side by prompt token count, but GitHub still requires the account to have Copilot long-context/usage-based billing entitlement enabled. Long-context Copilot requests consume higher-cost AI credits. Reduce the session context, choose a smaller context window/model, or enable the required Copilot long-context/usage-based billing entitlement for this account.`;\n}\n\nexport function formatCopilotProviderError(modelProvider: string, errorMessage: string): string {\n\treturn modelProvider === \"github-copilot\" ? formatCopilotPromptLimitError(errorMessage) : errorMessage;\n}\n"]}

package/dist/core/copilot-model-catalog.d.ts

@@ -0,0 +1,132 @@
+/**
+ * GitHub Copilot model catalog (CAPI) — dynamic, input-token context windows.
+ *
+ * GitHub's Copilot API (CAPI) exposes per-model limits via `GET {baseUrl}/models`. Every window
+ * Atomic shows for a Copilot model is measured in INPUT (prompt) tokens, exactly like every other
+ * provider's `contextWindow`, so GitHub models read consistently across the UI:
+ *
+ *   - A model's input budget = `capabilities.limits.max_prompt_tokens`
+ *       ?? `capabilities.limits.max_context_window_tokens`
+ *       ?? 128_000   (the two fallbacks are safeties real CAPI entries never hit).
+ *   - Models with tiered pricing expose per-tier input budgets via
+ *     `billing.token_prices.<tier>.context_max`. The `default` tier is the base context window
+ *     (e.g. gpt-5.5 272k, Claude 200k); a `long_context` tier adds a selectable larger input
+ *     window (e.g. gpt-5.5 922k, Claude 936k) the user can switch to via the `/model` picker.
+ *
+ * This data is intentionally NOT baked into a static map: GitHub adds/removes models and retiers
+ * windows over time (e.g. a model that disappears from the catalog), so a hardcoded snapshot goes
+ * stale. Instead the catalog is fetched live (gated on the user actually having the GitHub Copilot
+ * provider) and cached on disk for a short TTL, exactly like the Copilot CLI.
+ */
+/** Resolved input-token context window(s) for a single Copilot model. */
+export interface CopilotModelContext {
+    /**
+     * Base context window in INPUT tokens — shown in the footer and used for compaction. The
+     * default tier's `context_max`, or the model-level `max_prompt_tokens` fallback otherwise.
+     */
+    contextWindow: number;
+    /**
+     * Selectable input-token windows (`[default, long]`) when the model exposes a `long_context`
+     * tier larger than its default; absent for single-window models.
+     */
+    contextWindowOptions?: readonly number[];
+}
+/** Map of model id → resolved input-token context window(s). */
+export type CopilotModelCatalog = ReadonlyMap<string, CopilotModelContext>;
+/** Safety fallback when a model reports neither `max_prompt_tokens` nor `max_context_window_tokens`. */
+export declare const COPILOT_CONTEXT_WINDOW_FALLBACK = 128000;
+export declare const COPILOT_CATALOG_API_VERSION = "2026-06-01";
+/**
+ * Headers GitHub's CAPI expects for catalog reads. Mirrors the editor headers pi-ai already sends
+ * for Copilot token refresh and model-policy calls, plus the dated API version.
+ */
+export declare const COPILOT_CATALOG_HEADERS: Readonly<Record<string, string>>;
+/** Default (non-enterprise) Copilot CAPI base URL when the token has no resolvable `proxy-ep`. */
+export declare const DEFAULT_COPILOT_API_BASE_URL = "https://api.individual.githubcopilot.com";
+/** Disk-cache freshness window, matching the Copilot CLI's list-models cache TTL. */
+export declare const COPILOT_CATALOG_CACHE_TTL_MS: number;
+/** Current on-disk cache schema version. */
+export declare const COPILOT_CATALOG_CACHE_VERSION: 2;
+/**
+ * Resolve the Copilot CAPI base URL.
+ *
+ * Copilot access tokens embed a `proxy-ep=proxy.<host>` segment; the API host is the same host with
+ * `proxy.` swapped for `api.`. Falls back to the enterprise host or the individual default. (pi-ai
+ * exposes an equivalent helper, but its published `dist` mangles the export name, so the small,
+ * stable parsing logic is reimplemented here.)
+ */
+export declare function copilotApiBaseUrlFromToken(token: string | undefined, enterpriseDomain?: string): string;
+/** Raw input-token limits parsed from a CAPI model entry. */
+export interface CopilotModelLimits {
+    /** `capabilities.limits.max_prompt_tokens`. */
+    maxPromptTokens?: number;
+    /** `capabilities.limits.max_context_window_tokens`. */
+    maxContextWindowTokens?: number;
+    /** `billing.token_prices.default.context_max`. */
+    defaultContextMax?: number;
+    /** `billing.token_prices.long_context.context_max`. */
+    longContextMax?: number;
+}
+/**
+ * Resolve a model's input-token context window(s) from its CAPI limits.
+ *
+ * `contextWindow` is the model's base input budget — the default tier's `context_max` when tiered,
+ * otherwise `max_prompt_tokens ?? max_context_window_tokens ?? 128_000`. A `long_context` tier that
+ * is larger than the base adds a second selectable window. Returns `undefined` when the entry
+ * carries no usable limit signal at all.
+ */
+export declare function resolveCopilotModelContext(limits: CopilotModelLimits): CopilotModelContext | undefined;
+/**
+ * Parse a raw CAPI `/models` response body into an input-token context-window catalog.
+ */
+export declare function parseCopilotModelCatalog(body: unknown): CopilotModelCatalog;
+export interface FetchCopilotModelCatalogOptions {
+    /** Valid Copilot CAPI bearer token (e.g. from `modelRegistry.getApiKeyForProvider`). */
+    token: string;
+    /** Override the resolved base URL; defaults to one derived from the token. */
+    baseUrl?: string;
+    /** Enterprise domain, used for base-URL resolution when the token lacks a `proxy-ep`. */
+    enterpriseDomain?: string;
+    /** Extra/override request headers. */
+    headers?: Record<string, string>;
+    /** Injectable `fetch` for testing. */
+    fetchImpl?: typeof fetch;
+    /** Abort signal. */
+    signal?: AbortSignal;
+}
+/** Fetch and parse the live Copilot model catalog from CAPI `GET {baseUrl}/models`. */
+export declare function fetchCopilotModelCatalog(options: FetchCopilotModelCatalogOptions): Promise<CopilotModelCatalog>;
+/** Replace the active catalog the registry derives context windows from. */
+export declare function setActiveCopilotModelCatalog(catalog: CopilotModelCatalog): void;
+/** The active catalog (empty until a successful auth-gated fetch/cache load). */
+export declare function getActiveCopilotModelCatalog(): CopilotModelCatalog;
+/** Reset the active catalog (primarily for tests). */
+export declare function clearActiveCopilotModelCatalog(): void;
+export interface ReadCopilotCatalogCacheOptions {
+    /** Expected CAPI host; a cached file from a different host is ignored. */
+    host: string;
+    /** Current epoch ms (injectable for tests). */
+    now?: number;
+    /** Freshness window; defaults to {@link COPILOT_CATALOG_CACHE_TTL_MS}. */
+    ttlMs?: number;
+}
+/** Read a fresh, host-matching catalog from the cache file, or `undefined` if missing/stale/invalid. */
+export declare function readCopilotCatalogCache(path: string, options: ReadCopilotCatalogCacheOptions): CopilotModelCatalog | undefined;
+/** Write the catalog to the cache file (creating parent dirs). Best-effort; never throws. */
+export declare function writeCopilotCatalogCache(path: string, baseUrl: string, catalog: CopilotModelCatalog, now?: number): void;
+/** Host component of a base URL, for matching {@link readCopilotCatalogCache} `host`. */
+export declare function copilotCatalogCacheHost(baseUrl: string): string;
+/** Standard on-disk cache path for the Copilot model catalog under an agent directory. */
+export declare function copilotCatalogCachePath(agentDir: string): string;
+/**
+ * Seed the active catalog synchronously from the on-disk cache, gated on a Copilot access token.
+ *
+ * Called at model-registry construction so a returning user's previously selected long-context
+ * window is recognized before startup validation runs — otherwise the persisted choice would warn
+ * ("context window 936k is not supported…") and reset until the async refresh completes. The cache
+ * TTL is intentionally ignored here: stale-but-present windows are still valid for selection, and
+ * the async loader independently refetches on its own freshness window. Returns true when a catalog
+ * was applied. No-op (returns false) without a token or a host-matching cached catalog.
+ */
+export declare function seedActiveCopilotModelCatalogFromCache(accessToken: string | undefined, cachePath: string, now?: number): boolean;
+//# sourceMappingURL=copilot-model-catalog.d.ts.map

package/dist/core/copilot-model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-model-catalog.d.ts","sourceRoot":"","sources":["../../src/core/copilot-model-catalog.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * GitHub Copilot model catalog (CAPI) — dynamic, input-token context windows.\n *\n * GitHub's Copilot API (CAPI) exposes per-model limits via `GET {baseUrl}/models`. Every window\n * Atomic shows for a Copilot model is measured in INPUT (prompt) tokens, exactly like every other\n * provider's `contextWindow`, so GitHub models read consistently across the UI:\n *\n *   - A model's input budget = `capabilities.limits.max_prompt_tokens`\n *       ?? `capabilities.limits.max_context_window_tokens`\n *       ?? 128_000   (the two fallbacks are safeties real CAPI entries never hit).\n *   - Models with tiered pricing expose per-tier input budgets via\n *     `billing.token_prices.<tier>.context_max`. The `default` tier is the base context window\n *     (e.g. gpt-5.5 272k, Claude 200k); a `long_context` tier adds a selectable larger input\n *     window (e.g. gpt-5.5 922k, Claude 936k) the user can switch to via the `/model` picker.\n *\n * This data is intentionally NOT baked into a static map: GitHub adds/removes models and retiers\n * windows over time (e.g. a model that disappears from the catalog), so a hardcoded snapshot goes\n * stale. Instead the catalog is fetched live (gated on the user actually having the GitHub Copilot\n * provider) and cached on disk for a short TTL, exactly like the Copilot CLI.\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\n/** Resolved input-token context window(s) for a single Copilot model. */\nexport interface CopilotModelContext {\n\t/**\n\t * Base context window in INPUT tokens — shown in the footer and used for compaction. The\n\t * default tier's `context_max`, or the model-level `max_prompt_tokens` fallback otherwise.\n\t */\n\tcontextWindow: number;\n\t/**\n\t * Selectable input-token windows (`[default, long]`) when the model exposes a `long_context`\n\t * tier larger than its default; absent for single-window models.\n\t */\n\tcontextWindowOptions?: readonly number[];\n}\n\n/** Map of model id → resolved input-token context window(s). */\nexport type CopilotModelCatalog = ReadonlyMap<string, CopilotModelContext>;\n\n/** Safety fallback when a model reports neither `max_prompt_tokens` nor `max_context_window_tokens`. */\nexport const COPILOT_CONTEXT_WINDOW_FALLBACK = 128_000;\n\nexport const COPILOT_CATALOG_API_VERSION = \"2026-06-01\";\n\n/**\n * Headers GitHub's CAPI expects for catalog reads. Mirrors the editor headers pi-ai already sends\n * for Copilot token refresh and model-policy calls, plus the dated API version.\n */\nexport const COPILOT_CATALOG_HEADERS: Readonly<Record<string, string>> = {\n\t\"User-Agent\": \"GitHubCopilotChat/0.35.0\",\n\t\"Editor-Version\": \"vscode/1.107.0\",\n\t\"Editor-Plugin-Version\": \"copilot-chat/0.35.0\",\n\t\"Copilot-Integration-Id\": \"vscode-chat\",\n\t\"X-GitHub-Api-Version\": COPILOT_CATALOG_API_VERSION,\n};\n\n/** Default (non-enterprise) Copilot CAPI base URL when the token has no resolvable `proxy-ep`. */\nexport const DEFAULT_COPILOT_API_BASE_URL = \"https://api.individual.githubcopilot.com\";\n\n/** Disk-cache freshness window, matching the Copilot CLI's list-models cache TTL. */\nexport const COPILOT_CATALOG_CACHE_TTL_MS = 30 * 60 * 1000;\n\n/** Current on-disk cache schema version. */\nexport const COPILOT_CATALOG_CACHE_VERSION = 2 as const;\n\n/**\n * Resolve the Copilot CAPI base URL.\n *\n * Copilot access tokens embed a `proxy-ep=proxy.<host>` segment; the API host is the same host with\n * `proxy.` swapped for `api.`. Falls back to the enterprise host or the individual default. (pi-ai\n * exposes an equivalent helper, but its published `dist` mangles the export name, so the small,\n * stable parsing logic is reimplemented here.)\n */\nexport function copilotApiBaseUrlFromToken(token: string | undefined, enterpriseDomain?: string): string {\n\tif (token) {\n\t\tconst match = token.match(/proxy-ep=([^;]+)/);\n\t\tif (match) {\n\t\t\treturn `https://${match[1].replace(/^proxy\\./, \"api.\")}`;\n\t\t}\n\t}\n\tif (enterpriseDomain) return `https://copilot-api.${enterpriseDomain}`;\n\treturn DEFAULT_COPILOT_API_BASE_URL;\n}\n\nfunction trimTrailingSlash(url: string): string {\n\treturn url.replace(/\\/+$/, \"\");\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n\treturn value && typeof value === \"object\" ? (value as Record<string, unknown>) : undefined;\n}\n\nfunction toPositiveInt(value: unknown): number | undefined {\n\treturn typeof value === \"number\" && Number.isInteger(value) && value > 0 ? value : undefined;\n}\n\n/** Raw input-token limits parsed from a CAPI model entry. */\nexport interface CopilotModelLimits {\n\t/** `capabilities.limits.max_prompt_tokens`. */\n\tmaxPromptTokens?: number;\n\t/** `capabilities.limits.max_context_window_tokens`. */\n\tmaxContextWindowTokens?: number;\n\t/** `billing.token_prices.default.context_max`. */\n\tdefaultContextMax?: number;\n\t/** `billing.token_prices.long_context.context_max`. */\n\tlongContextMax?: number;\n}\n\n/**\n * Resolve a model's input-token context window(s) from its CAPI limits.\n *\n * `contextWindow` is the model's base input budget — the default tier's `context_max` when tiered,\n * otherwise `max_prompt_tokens ?? max_context_window_tokens ?? 128_000`. A `long_context` tier that\n * is larger than the base adds a second selectable window. Returns `undefined` when the entry\n * carries no usable limit signal at all.\n */\nexport function resolveCopilotModelContext(limits: CopilotModelLimits): CopilotModelContext | undefined {\n\tconst hasSignal =\n\t\tlimits.maxPromptTokens !== undefined ||\n\t\tlimits.maxContextWindowTokens !== undefined ||\n\t\tlimits.defaultContextMax !== undefined ||\n\t\tlimits.longContextMax !== undefined;\n\tif (!hasSignal) return undefined;\n\n\tconst maxInput = limits.maxPromptTokens ?? limits.maxContextWindowTokens ?? COPILOT_CONTEXT_WINDOW_FALLBACK;\n\tconst base = limits.defaultContextMax ?? maxInput;\n\tif (limits.longContextMax !== undefined && limits.longContextMax > base) {\n\t\treturn { contextWindow: base, contextWindowOptions: [base, limits.longContextMax] };\n\t}\n\treturn { contextWindow: base };\n}\n\n/**\n * Parse a raw CAPI `/models` response body into an input-token context-window catalog.\n */\nexport function parseCopilotModelCatalog(body: unknown): CopilotModelCatalog {\n\tconst catalog = new Map<string, CopilotModelContext>();\n\tconst data = asRecord(body)?.data;\n\tif (!Array.isArray(data)) return catalog;\n\n\tfor (const entry of data) {\n\t\tconst record = asRecord(entry);\n\t\tif (!record) continue;\n\t\tconst id = record.id;\n\t\tif (typeof id !== \"string\" || id.length === 0) continue;\n\n\t\tconst limits = asRecord(asRecord(record.capabilities)?.limits);\n\t\tconst prices = asRecord(asRecord(record.billing)?.token_prices);\n\t\tconst context = resolveCopilotModelContext({\n\t\t\tmaxPromptTokens: toPositiveInt(limits?.max_prompt_tokens),\n\t\t\tmaxContextWindowTokens: toPositiveInt(limits?.max_context_window_tokens),\n\t\t\tdefaultContextMax: toPositiveInt(asRecord(prices?.default)?.context_max),\n\t\t\tlongContextMax: toPositiveInt(asRecord(prices?.long_context)?.context_max),\n\t\t});\n\t\tif (context) catalog.set(id, context);\n\t}\n\n\treturn catalog;\n}\n\nexport interface FetchCopilotModelCatalogOptions {\n\t/** Valid Copilot CAPI bearer token (e.g. from `modelRegistry.getApiKeyForProvider`). */\n\ttoken: string;\n\t/** Override the resolved base URL; defaults to one derived from the token. */\n\tbaseUrl?: string;\n\t/** Enterprise domain, used for base-URL resolution when the token lacks a `proxy-ep`. */\n\tenterpriseDomain?: string;\n\t/** Extra/override request headers. */\n\theaders?: Record<string, string>;\n\t/** Injectable `fetch` for testing. */\n\tfetchImpl?: typeof fetch;\n\t/** Abort signal. */\n\tsignal?: AbortSignal;\n}\n\n/** Fetch and parse the live Copilot model catalog from CAPI `GET {baseUrl}/models`. */\nexport async function fetchCopilotModelCatalog(options: FetchCopilotModelCatalogOptions): Promise<CopilotModelCatalog> {\n\tconst fetchImpl = options.fetchImpl ?? fetch;\n\tconst baseUrl = options.baseUrl ?? copilotApiBaseUrlFromToken(options.token, options.enterpriseDomain);\n\tconst response = await fetchImpl(`${trimTrailingSlash(baseUrl)}/models`, {\n\t\tmethod: \"GET\",\n\t\theaders: {\n\t\t\tAccept: \"application/json\",\n\t\t\tAuthorization: `Bearer ${options.token}`,\n\t\t\t...COPILOT_CATALOG_HEADERS,\n\t\t\t...options.headers,\n\t\t},\n\t\t...(options.signal ? { signal: options.signal } : {}),\n\t});\n\tif (!response.ok) {\n\t\tthrow new Error(`GitHub Copilot /models request failed: ${response.status} ${response.statusText}`);\n\t}\n\treturn parseCopilotModelCatalog(await response.json());\n}\n\n// ----------------------------------------------------------------------------\n// Active in-memory catalog (consulted by the model registry).\n//\n// Empty by default, so with no Copilot auth / no successful fetch the registry leaves Copilot\n// model context windows untouched and the picker never appears.\n// ----------------------------------------------------------------------------\n\nlet activeCatalog: CopilotModelCatalog = new Map();\n\n/** Replace the active catalog the registry derives context windows from. */\nexport function setActiveCopilotModelCatalog(catalog: CopilotModelCatalog): void {\n\tactiveCatalog = catalog;\n}\n\n/** The active catalog (empty until a successful auth-gated fetch/cache load). */\nexport function getActiveCopilotModelCatalog(): CopilotModelCatalog {\n\treturn activeCatalog;\n}\n\n/** Reset the active catalog (primarily for tests). */\nexport function clearActiveCopilotModelCatalog(): void {\n\tactiveCatalog = new Map();\n}\n\n// ----------------------------------------------------------------------------\n// Disk cache.\n// ----------------------------------------------------------------------------\n\ninterface CopilotCatalogCacheFile {\n\tversion: typeof COPILOT_CATALOG_CACHE_VERSION;\n\t/** CAPI host the catalog was fetched from; cache misses on host change (e.g. enterprise switch). */\n\thost: string;\n\t/** Epoch ms the catalog was fetched. */\n\tfetchedAt: number;\n\tmodels: Record<string, CopilotModelContext>;\n}\n\nfunction hostFromBaseUrl(baseUrl: string): string {\n\ttry {\n\t\treturn new URL(baseUrl).host;\n\t} catch {\n\t\treturn baseUrl;\n\t}\n}\n\nexport interface ReadCopilotCatalogCacheOptions {\n\t/** Expected CAPI host; a cached file from a different host is ignored. */\n\thost: string;\n\t/** Current epoch ms (injectable for tests). */\n\tnow?: number;\n\t/** Freshness window; defaults to {@link COPILOT_CATALOG_CACHE_TTL_MS}. */\n\tttlMs?: number;\n}\n\nfunction sanitizeCachedContext(value: unknown): CopilotModelContext | undefined {\n\tconst record = asRecord(value);\n\tconst contextWindow = toPositiveInt(record?.contextWindow);\n\tif (contextWindow === undefined) return undefined;\n\tconst rawOptions = record?.contextWindowOptions;\n\tif (Array.isArray(rawOptions)) {\n\t\tconst options = rawOptions.map(toPositiveInt).filter((n): n is number => n !== undefined);\n\t\tif (options.length > 1) return { contextWindow, contextWindowOptions: options };\n\t}\n\treturn { contextWindow };\n}\n\n/** Read a fresh, host-matching catalog from the cache file, or `undefined` if missing/stale/invalid. */\nexport function readCopilotCatalogCache(\n\tpath: string,\n\toptions: ReadCopilotCatalogCacheOptions,\n): CopilotModelCatalog | undefined {\n\tlet parsed: CopilotCatalogCacheFile;\n\ttry {\n\t\tif (!existsSync(path)) return undefined;\n\t\tparsed = JSON.parse(readFileSync(path, \"utf8\")) as CopilotCatalogCacheFile;\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!parsed || parsed.version !== COPILOT_CATALOG_CACHE_VERSION) return undefined;\n\tif (parsed.host !== options.host) return undefined;\n\tconst now = options.now ?? Date.now();\n\tconst ttlMs = options.ttlMs ?? COPILOT_CATALOG_CACHE_TTL_MS;\n\tif (typeof parsed.fetchedAt !== \"number\" || now - parsed.fetchedAt >= ttlMs) return undefined;\n\tconst models = asRecord(parsed.models);\n\tif (!models) return undefined;\n\n\tconst catalog = new Map<string, CopilotModelContext>();\n\tfor (const [id, value] of Object.entries(models)) {\n\t\tconst context = sanitizeCachedContext(value);\n\t\tif (context) catalog.set(id, context);\n\t}\n\treturn catalog;\n}\n\n/** Write the catalog to the cache file (creating parent dirs). Best-effort; never throws. */\nexport function writeCopilotCatalogCache(\n\tpath: string,\n\tbaseUrl: string,\n\tcatalog: CopilotModelCatalog,\n\tnow?: number,\n): void {\n\tconst payload: CopilotCatalogCacheFile = {\n\t\tversion: COPILOT_CATALOG_CACHE_VERSION,\n\t\thost: hostFromBaseUrl(baseUrl),\n\t\tfetchedAt: now ?? Date.now(),\n\t\tmodels: Object.fromEntries(catalog),\n\t};\n\ttry {\n\t\tmkdirSync(dirname(path), { recursive: true });\n\t\twriteFileSync(path, JSON.stringify(payload), \"utf8\");\n\t} catch {\n\t\t// best-effort cache; ignore write failures\n\t}\n}\n\n/** Host component of a base URL, for matching {@link readCopilotCatalogCache} `host`. */\nexport function copilotCatalogCacheHost(baseUrl: string): string {\n\treturn hostFromBaseUrl(baseUrl);\n}\n\n/** Standard on-disk cache path for the Copilot model catalog under an agent directory. */\nexport function copilotCatalogCachePath(agentDir: string): string {\n\treturn join(agentDir, \"cache\", \"copilot-models.json\");\n}\n\n/**\n * Seed the active catalog synchronously from the on-disk cache, gated on a Copilot access token.\n *\n * Called at model-registry construction so a returning user's previously selected long-context\n * window is recognized before startup validation runs — otherwise the persisted choice would warn\n * (\"context window 936k is not supported…\") and reset until the async refresh completes. The cache\n * TTL is intentionally ignored here: stale-but-present windows are still valid for selection, and\n * the async loader independently refetches on its own freshness window. Returns true when a catalog\n * was applied. No-op (returns false) without a token or a host-matching cached catalog.\n */\nexport function seedActiveCopilotModelCatalogFromCache(\n\taccessToken: string | undefined,\n\tcachePath: string,\n\tnow?: number,\n): boolean {\n\tif (typeof accessToken !== \"string\" || accessToken.length === 0) return false;\n\tconst host = copilotCatalogCacheHost(copilotApiBaseUrlFromToken(accessToken));\n\tconst cached = readCopilotCatalogCache(cachePath, { host, now, ttlMs: Number.POSITIVE_INFINITY });\n\tif (!cached) return false;\n\tsetActiveCopilotModelCatalog(cached);\n\treturn true;\n}\n"]}

package/dist/core/copilot-model-catalog.js

@@ -0,0 +1,254 @@
+/**
+ * GitHub Copilot model catalog (CAPI) — dynamic, input-token context windows.
+ *
+ * GitHub's Copilot API (CAPI) exposes per-model limits via `GET {baseUrl}/models`. Every window
+ * Atomic shows for a Copilot model is measured in INPUT (prompt) tokens, exactly like every other
+ * provider's `contextWindow`, so GitHub models read consistently across the UI:
+ *
+ *   - A model's input budget = `capabilities.limits.max_prompt_tokens`
+ *       ?? `capabilities.limits.max_context_window_tokens`
+ *       ?? 128_000   (the two fallbacks are safeties real CAPI entries never hit).
+ *   - Models with tiered pricing expose per-tier input budgets via
+ *     `billing.token_prices.<tier>.context_max`. The `default` tier is the base context window
+ *     (e.g. gpt-5.5 272k, Claude 200k); a `long_context` tier adds a selectable larger input
+ *     window (e.g. gpt-5.5 922k, Claude 936k) the user can switch to via the `/model` picker.
+ *
+ * This data is intentionally NOT baked into a static map: GitHub adds/removes models and retiers
+ * windows over time (e.g. a model that disappears from the catalog), so a hardcoded snapshot goes
+ * stale. Instead the catalog is fetched live (gated on the user actually having the GitHub Copilot
+ * provider) and cached on disk for a short TTL, exactly like the Copilot CLI.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/** Safety fallback when a model reports neither `max_prompt_tokens` nor `max_context_window_tokens`. */
+export const COPILOT_CONTEXT_WINDOW_FALLBACK = 128_000;
+export const COPILOT_CATALOG_API_VERSION = "2026-06-01";
+/**
+ * Headers GitHub's CAPI expects for catalog reads. Mirrors the editor headers pi-ai already sends
+ * for Copilot token refresh and model-policy calls, plus the dated API version.
+ */
+export const COPILOT_CATALOG_HEADERS = {
+    "User-Agent": "GitHubCopilotChat/0.35.0",
+    "Editor-Version": "vscode/1.107.0",
+    "Editor-Plugin-Version": "copilot-chat/0.35.0",
+    "Copilot-Integration-Id": "vscode-chat",
+    "X-GitHub-Api-Version": COPILOT_CATALOG_API_VERSION,
+};
+/** Default (non-enterprise) Copilot CAPI base URL when the token has no resolvable `proxy-ep`. */
+export const DEFAULT_COPILOT_API_BASE_URL = "https://api.individual.githubcopilot.com";
+/** Disk-cache freshness window, matching the Copilot CLI's list-models cache TTL. */
+export const COPILOT_CATALOG_CACHE_TTL_MS = 30 * 60 * 1000;
+/** Current on-disk cache schema version. */
+export const COPILOT_CATALOG_CACHE_VERSION = 2;
+/**
+ * Resolve the Copilot CAPI base URL.
+ *
+ * Copilot access tokens embed a `proxy-ep=proxy.<host>` segment; the API host is the same host with
+ * `proxy.` swapped for `api.`. Falls back to the enterprise host or the individual default. (pi-ai
+ * exposes an equivalent helper, but its published `dist` mangles the export name, so the small,
+ * stable parsing logic is reimplemented here.)
+ */
+export function copilotApiBaseUrlFromToken(token, enterpriseDomain) {
+    if (token) {
+        const match = token.match(/proxy-ep=([^;]+)/);
+        if (match) {
+            return `https://${match[1].replace(/^proxy\./, "api.")}`;
+        }
+    }
+    if (enterpriseDomain)
+        return `https://copilot-api.${enterpriseDomain}`;
+    return DEFAULT_COPILOT_API_BASE_URL;
+}
+function trimTrailingSlash(url) {
+    return url.replace(/\/+$/, "");
+}
+function asRecord(value) {
+    return value && typeof value === "object" ? value : undefined;
+}
+function toPositiveInt(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+/**
+ * Resolve a model's input-token context window(s) from its CAPI limits.
+ *
+ * `contextWindow` is the model's base input budget — the default tier's `context_max` when tiered,
+ * otherwise `max_prompt_tokens ?? max_context_window_tokens ?? 128_000`. A `long_context` tier that
+ * is larger than the base adds a second selectable window. Returns `undefined` when the entry
+ * carries no usable limit signal at all.
+ */
+export function resolveCopilotModelContext(limits) {
+    const hasSignal = limits.maxPromptTokens !== undefined ||
+        limits.maxContextWindowTokens !== undefined ||
+        limits.defaultContextMax !== undefined ||
+        limits.longContextMax !== undefined;
+    if (!hasSignal)
+        return undefined;
+    const maxInput = limits.maxPromptTokens ?? limits.maxContextWindowTokens ?? COPILOT_CONTEXT_WINDOW_FALLBACK;
+    const base = limits.defaultContextMax ?? maxInput;
+    if (limits.longContextMax !== undefined && limits.longContextMax > base) {
+        return { contextWindow: base, contextWindowOptions: [base, limits.longContextMax] };
+    }
+    return { contextWindow: base };
+}
+/**
+ * Parse a raw CAPI `/models` response body into an input-token context-window catalog.
+ */
+export function parseCopilotModelCatalog(body) {
+    const catalog = new Map();
+    const data = asRecord(body)?.data;
+    if (!Array.isArray(data))
+        return catalog;
+    for (const entry of data) {
+        const record = asRecord(entry);
+        if (!record)
+            continue;
+        const id = record.id;
+        if (typeof id !== "string" || id.length === 0)
+            continue;
+        const limits = asRecord(asRecord(record.capabilities)?.limits);
+        const prices = asRecord(asRecord(record.billing)?.token_prices);
+        const context = resolveCopilotModelContext({
+            maxPromptTokens: toPositiveInt(limits?.max_prompt_tokens),
+            maxContextWindowTokens: toPositiveInt(limits?.max_context_window_tokens),
+            defaultContextMax: toPositiveInt(asRecord(prices?.default)?.context_max),
+            longContextMax: toPositiveInt(asRecord(prices?.long_context)?.context_max),
+        });
+        if (context)
+            catalog.set(id, context);
+    }
+    return catalog;
+}
+/** Fetch and parse the live Copilot model catalog from CAPI `GET {baseUrl}/models`. */
+export async function fetchCopilotModelCatalog(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const baseUrl = options.baseUrl ?? copilotApiBaseUrlFromToken(options.token, options.enterpriseDomain);
+    const response = await fetchImpl(`${trimTrailingSlash(baseUrl)}/models`, {
+        method: "GET",
+        headers: {
+            Accept: "application/json",
+            Authorization: `Bearer ${options.token}`,
+            ...COPILOT_CATALOG_HEADERS,
+            ...options.headers,
+        },
+        ...(options.signal ? { signal: options.signal } : {}),
+    });
+    if (!response.ok) {
+        throw new Error(`GitHub Copilot /models request failed: ${response.status} ${response.statusText}`);
+    }
+    return parseCopilotModelCatalog(await response.json());
+}
+// ----------------------------------------------------------------------------
+// Active in-memory catalog (consulted by the model registry).
+//
+// Empty by default, so with no Copilot auth / no successful fetch the registry leaves Copilot
+// model context windows untouched and the picker never appears.
+// ----------------------------------------------------------------------------
+let activeCatalog = new Map();
+/** Replace the active catalog the registry derives context windows from. */
+export function setActiveCopilotModelCatalog(catalog) {
+    activeCatalog = catalog;
+}
+/** The active catalog (empty until a successful auth-gated fetch/cache load). */
+export function getActiveCopilotModelCatalog() {
+    return activeCatalog;
+}
+/** Reset the active catalog (primarily for tests). */
+export function clearActiveCopilotModelCatalog() {
+    activeCatalog = new Map();
+}
+function hostFromBaseUrl(baseUrl) {
+    try {
+        return new URL(baseUrl).host;
+    }
+    catch {
+        return baseUrl;
+    }
+}
+function sanitizeCachedContext(value) {
+    const record = asRecord(value);
+    const contextWindow = toPositiveInt(record?.contextWindow);
+    if (contextWindow === undefined)
+        return undefined;
+    const rawOptions = record?.contextWindowOptions;
+    if (Array.isArray(rawOptions)) {
+        const options = rawOptions.map(toPositiveInt).filter((n) => n !== undefined);
+        if (options.length > 1)
+            return { contextWindow, contextWindowOptions: options };
+    }
+    return { contextWindow };
+}
+/** Read a fresh, host-matching catalog from the cache file, or `undefined` if missing/stale/invalid. */
+export function readCopilotCatalogCache(path, options) {
+    let parsed;
+    try {
+        if (!existsSync(path))
+            return undefined;
+        parsed = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (!parsed || parsed.version !== COPILOT_CATALOG_CACHE_VERSION)
+        return undefined;
+    if (parsed.host !== options.host)
+        return undefined;
+    const now = options.now ?? Date.now();
+    const ttlMs = options.ttlMs ?? COPILOT_CATALOG_CACHE_TTL_MS;
+    if (typeof parsed.fetchedAt !== "number" || now - parsed.fetchedAt >= ttlMs)
+        return undefined;
+    const models = asRecord(parsed.models);
+    if (!models)
+        return undefined;
+    const catalog = new Map();
+    for (const [id, value] of Object.entries(models)) {
+        const context = sanitizeCachedContext(value);
+        if (context)
+            catalog.set(id, context);
+    }
+    return catalog;
+}
+/** Write the catalog to the cache file (creating parent dirs). Best-effort; never throws. */
+export function writeCopilotCatalogCache(path, baseUrl, catalog, now) {
+    const payload = {
+        version: COPILOT_CATALOG_CACHE_VERSION,
+        host: hostFromBaseUrl(baseUrl),
+        fetchedAt: now ?? Date.now(),
+        models: Object.fromEntries(catalog),
+    };
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(payload), "utf8");
+    }
+    catch {
+        // best-effort cache; ignore write failures
+    }
+}
+/** Host component of a base URL, for matching {@link readCopilotCatalogCache} `host`. */
+export function copilotCatalogCacheHost(baseUrl) {
+    return hostFromBaseUrl(baseUrl);
+}
+/** Standard on-disk cache path for the Copilot model catalog under an agent directory. */
+export function copilotCatalogCachePath(agentDir) {
+    return join(agentDir, "cache", "copilot-models.json");
+}
+/**
+ * Seed the active catalog synchronously from the on-disk cache, gated on a Copilot access token.
+ *
+ * Called at model-registry construction so a returning user's previously selected long-context
+ * window is recognized before startup validation runs — otherwise the persisted choice would warn
+ * ("context window 936k is not supported…") and reset until the async refresh completes. The cache
+ * TTL is intentionally ignored here: stale-but-present windows are still valid for selection, and
+ * the async loader independently refetches on its own freshness window. Returns true when a catalog
+ * was applied. No-op (returns false) without a token or a host-matching cached catalog.
+ */
+export function seedActiveCopilotModelCatalogFromCache(accessToken, cachePath, now) {
+    if (typeof accessToken !== "string" || accessToken.length === 0)
+        return false;
+    const host = copilotCatalogCacheHost(copilotApiBaseUrlFromToken(accessToken));
+    const cached = readCopilotCatalogCache(cachePath, { host, now, ttlMs: Number.POSITIVE_INFINITY });
+    if (!cached)
+        return false;
+    setActiveCopilotModelCatalog(cached);
+    return true;
+}
+//# sourceMappingURL=copilot-model-catalog.js.map