npm - @golba98/codexa - Versions diffs - 1.0.1 - Mend

@golba98/codexa 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (226) hide show

package/README.md +320 -0
package/bin/codexa.js +445 -0
package/package.json +45 -0
package/scripts/audit-codexa-capabilities.mjs +466 -0
package/scripts/smoke-terminal-bench.mjs +35 -0
package/src/app.tsx +4561 -0
package/src/appRenderStability.test.ts +131 -0
package/src/commands/handler.test.ts +643 -0
package/src/commands/handler.ts +875 -0
package/src/config/launchArgs.test.ts +158 -0
package/src/config/launchArgs.ts +186 -0
package/src/config/layeredConfig.test.ts +143 -0
package/src/config/layeredConfig.ts +836 -0
package/src/config/persistence.test.ts +110 -0
package/src/config/persistence.ts +311 -0
package/src/config/runtimeConfig.test.ts +218 -0
package/src/config/runtimeConfig.ts +554 -0
package/src/config/settings.test.ts +155 -0
package/src/config/settings.ts +401 -0
package/src/config/toml-serialize.ts +98 -0
package/src/config/trustStore.test.ts +29 -0
package/src/config/trustStore.ts +68 -0
package/src/core/attachments.test.ts +155 -0
package/src/core/attachments.ts +71 -0
package/src/core/auth/codexAuth.test.ts +68 -0
package/src/core/auth/codexAuth.ts +359 -0
package/src/core/cleanupFastFail.test.ts +76 -0
package/src/core/cleanupFastFail.ts +67 -0
package/src/core/clipboard.ts +24 -0
package/src/core/codex.ts +124 -0
package/src/core/codexExecArgs.test.ts +195 -0
package/src/core/codexExecArgs.ts +152 -0
package/src/core/codexLaunch.test.ts +205 -0
package/src/core/codexLaunch.ts +162 -0
package/src/core/codexPrompt.test.ts +252 -0
package/src/core/codexPrompt.ts +428 -0
package/src/core/executables/claudeExecutable.ts +63 -0
package/src/core/executables/codexExecutable.test.ts +212 -0
package/src/core/executables/codexExecutable.ts +159 -0
package/src/core/executables/executableResolver.test.ts +129 -0
package/src/core/executables/executableResolver.ts +138 -0
package/src/core/executables/geminiExecutable.test.ts +116 -0
package/src/core/executables/geminiExecutable.ts +78 -0
package/src/core/executables/pathSanityScan.test.ts +47 -0
package/src/core/githubDiagnostics.test.ts +92 -0
package/src/core/githubDiagnostics.ts +222 -0
package/src/core/hollowResponseFormat.test.ts +58 -0
package/src/core/hollowResponseFormat.ts +39 -0
package/src/core/inputDebug.ts +51 -0
package/src/core/launchContext.test.ts +157 -0
package/src/core/launchContext.ts +266 -0
package/src/core/models/codexCapabilities.test.ts +45 -0
package/src/core/models/codexCapabilities.ts +95 -0
package/src/core/models/codexModelCapabilities.test.ts +246 -0
package/src/core/models/codexModelCapabilities.ts +571 -0
package/src/core/models/modelSpecs.test.ts +283 -0
package/src/core/models/modelSpecs.ts +300 -0
package/src/core/perf/profiler.ts +125 -0
package/src/core/perf/renderDebug.test.ts +230 -0
package/src/core/perf/renderDebug.ts +373 -0
package/src/core/planStorage.test.ts +143 -0
package/src/core/planStorage.ts +141 -0
package/src/core/process/CommandRunner.test.ts +105 -0
package/src/core/process/CommandRunner.ts +269 -0
package/src/core/process/processValidation.ts +101 -0
package/src/core/projectInstructions.test.ts +50 -0
package/src/core/projectInstructions.ts +54 -0
package/src/core/providerLauncher/launcher.test.ts +238 -0
package/src/core/providerLauncher/launcher.ts +203 -0
package/src/core/providerLauncher/registry.test.ts +324 -0
package/src/core/providerLauncher/registry.ts +253 -0
package/src/core/providerLauncher/types.ts +84 -0
package/src/core/providerLauncher/workspaceConfig.test.ts +638 -0
package/src/core/providerLauncher/workspaceConfig.ts +407 -0
package/src/core/providerRuntime/anthropic.test.ts +1120 -0
package/src/core/providerRuntime/anthropic.ts +576 -0
package/src/core/providerRuntime/capabilityProfile.test.ts +311 -0
package/src/core/providerRuntime/capabilityProfile.ts +288 -0
package/src/core/providerRuntime/claudeCodeDiscovery.ts +446 -0
package/src/core/providerRuntime/contextMetadata.test.ts +468 -0
package/src/core/providerRuntime/contextMetadata.ts +409 -0
package/src/core/providerRuntime/gemini.test.ts +437 -0
package/src/core/providerRuntime/gemini.ts +784 -0
package/src/core/providerRuntime/lmstudio.test.ts +168 -0
package/src/core/providerRuntime/lmstudio.ts +118 -0
package/src/core/providerRuntime/local.test.ts +787 -0
package/src/core/providerRuntime/local.ts +754 -0
package/src/core/providerRuntime/models.ts +150 -0
package/src/core/providerRuntime/reasoning.ts +17 -0
package/src/core/providerRuntime/registry.test.ts +233 -0
package/src/core/providerRuntime/registry.ts +203 -0
package/src/core/providerRuntime/types.ts +103 -0
package/src/core/providers/codexJsonStream.test.ts +148 -0
package/src/core/providers/codexJsonStream.ts +305 -0
package/src/core/providers/codexSubprocess.test.ts +68 -0
package/src/core/providers/codexSubprocess.ts +372 -0
package/src/core/providers/codexTranscript.test.ts +284 -0
package/src/core/providers/codexTranscript.ts +695 -0
package/src/core/providers/openaiNative.ts +13 -0
package/src/core/providers/registry.ts +21 -0
package/src/core/providers/types.ts +59 -0
package/src/core/terminal/terminalCapabilities.test.ts +93 -0
package/src/core/terminal/terminalCapabilities.ts +100 -0
package/src/core/terminal/terminalControl.test.ts +75 -0
package/src/core/terminal/terminalControl.ts +147 -0
package/src/core/terminal/terminalSanitize.test.ts +22 -0
package/src/core/terminal/terminalSanitize.ts +147 -0
package/src/core/terminal/terminalSelection.test.ts +42 -0
package/src/core/terminal/terminalSelection.ts +66 -0
package/src/core/terminal/terminalTitle.test.ts +328 -0
package/src/core/terminal/terminalTitle.ts +483 -0
package/src/core/workspaceActivity.test.ts +163 -0
package/src/core/workspaceActivity.ts +380 -0
package/src/core/workspaceGuard.test.ts +151 -0
package/src/core/workspaceGuard.ts +288 -0
package/src/core/workspaceRoot.test.ts +23 -0
package/src/core/workspaceRoot.ts +47 -0
package/src/exec.test.ts +13 -0
package/src/exec.ts +72 -0
package/src/headless/execArgs.test.ts +147 -0
package/src/headless/execArgs.ts +294 -0
package/src/headless/execRunner.test.ts +434 -0
package/src/headless/execRunner.ts +304 -0
package/src/index.test.tsx +618 -0
package/src/index.tsx +296 -0
package/src/session/appSession.test.ts +897 -0
package/src/session/appSession.ts +761 -0
package/src/session/chatLifecycle.test.ts +64 -0
package/src/session/chatLifecycle.ts +951 -0
package/src/session/liveRenderScheduler.test.ts +201 -0
package/src/session/liveRenderScheduler.ts +214 -0
package/src/session/planFlow.test.ts +103 -0
package/src/session/planFlow.ts +149 -0
package/src/session/planTranscript.test.ts +65 -0
package/src/session/planTranscript.ts +15 -0
package/src/session/promptRunSchedule.test.ts +36 -0
package/src/session/promptRunSchedule.ts +26 -0
package/src/session/types.ts +228 -0
package/src/test/runtimeTestUtils.ts +14 -0
package/src/types/react-dom.d.ts +3 -0
package/src/ui/ActionRequiredBlock.tsx +38 -0
package/src/ui/ActivityBars.tsx +68 -0
package/src/ui/ActivityIndicator.test.tsx +58 -0
package/src/ui/ActivityIndicator.tsx +58 -0
package/src/ui/AgentBlock.test.ts +6 -0
package/src/ui/AgentBlock.tsx +130 -0
package/src/ui/AnimatedStatusText.test.ts +16 -0
package/src/ui/AnimatedStatusText.tsx +69 -0
package/src/ui/AppShell.test.tsx +1739 -0
package/src/ui/AppShell.tsx +698 -0
package/src/ui/AttachmentImportPanel.test.tsx +204 -0
package/src/ui/AttachmentImportPanel.tsx +98 -0
package/src/ui/AuthPanel.tsx +113 -0
package/src/ui/BackendPicker.tsx +28 -0
package/src/ui/BottomComposer.test.ts +674 -0
package/src/ui/BottomComposer.tsx +1028 -0
package/src/ui/CodexLogo.tsx +55 -0
package/src/ui/DashCard.tsx +82 -0
package/src/ui/Markdown.test.ts +157 -0
package/src/ui/Markdown.tsx +310 -0
package/src/ui/ModePicker.tsx +27 -0
package/src/ui/ModelPicker.tsx +31 -0
package/src/ui/ModelPickerProviderScope.test.tsx +411 -0
package/src/ui/ModelPickerScreen.test.tsx +99 -0
package/src/ui/ModelPickerScreen.tsx +416 -0
package/src/ui/ModelPickerState.test.tsx +151 -0
package/src/ui/ModelReasoningPicker.test.tsx +447 -0
package/src/ui/ModelReasoningPicker.tsx +458 -0
package/src/ui/Panel.tsx +51 -0
package/src/ui/PermissionsPanel.tsx +78 -0
package/src/ui/PlanActionPicker.tsx +119 -0
package/src/ui/PlanReviewPanel.test.tsx +267 -0
package/src/ui/PlanReviewPanel.tsx +212 -0
package/src/ui/PromptCardBorder.test.tsx +161 -0
package/src/ui/ProviderPicker.test.tsx +289 -0
package/src/ui/ProviderPicker.tsx +321 -0
package/src/ui/ProviderShortcut.test.tsx +143 -0
package/src/ui/ReasoningPicker.tsx +46 -0
package/src/ui/RunFooter.tsx +65 -0
package/src/ui/SelectionPanel.tsx +67 -0
package/src/ui/SettingsPanel.test.tsx +233 -0
package/src/ui/SettingsPanel.tsx +156 -0
package/src/ui/Spinner.tsx +25 -0
package/src/ui/StaticIntroItem.tsx +54 -0
package/src/ui/StaticTranscriptItem.tsx +56 -0
package/src/ui/TextEntryPanel.tsx +139 -0
package/src/ui/ThemePicker.tsx +31 -0
package/src/ui/ThinkingBlock.tsx +100 -0
package/src/ui/Timeline.test.ts +2067 -0
package/src/ui/Timeline.tsx +1472 -0
package/src/ui/TimelineNavigation.test.tsx +201 -0
package/src/ui/TopHeader.test.tsx +239 -0
package/src/ui/TopHeader.tsx +257 -0
package/src/ui/TurnGroup.test.tsx +365 -0
package/src/ui/TurnGroup.tsx +657 -0
package/src/ui/busyStatusAnimation.test.ts +30 -0
package/src/ui/busyStatusAnimation.ts +11 -0
package/src/ui/commandNormalize.test.ts +142 -0
package/src/ui/commandNormalize.ts +66 -0
package/src/ui/diffRenderer.test.ts +102 -0
package/src/ui/diffRenderer.ts +116 -0
package/src/ui/focus.ts +61 -0
package/src/ui/focusFlow.test.tsx +1098 -0
package/src/ui/inputBuffer.test.ts +151 -0
package/src/ui/inputBuffer.ts +203 -0
package/src/ui/layout.test.ts +145 -0
package/src/ui/layout.ts +287 -0
package/src/ui/modeDisplay.test.ts +42 -0
package/src/ui/modeDisplay.ts +52 -0
package/src/ui/outputPipeline.ts +64 -0
package/src/ui/progressEntries.ts +156 -0
package/src/ui/runActivityView.test.ts +89 -0
package/src/ui/runActivityView.ts +37 -0
package/src/ui/runLifecycleView.test.tsx +237 -0
package/src/ui/slashCommands.ts +41 -0
package/src/ui/statusRenderIsolation.test.tsx +654 -0
package/src/ui/terminalAnswerFormat.test.ts +19 -0
package/src/ui/terminalAnswerFormat.ts +128 -0
package/src/ui/textLayout.test.ts +18 -0
package/src/ui/textLayout.ts +338 -0
package/src/ui/theme.tsx +395 -0
package/src/ui/themeFlow.test.ts +53 -0
package/src/ui/themeFlow.ts +41 -0
package/src/ui/timelineMeasure.ts +3088 -0
package/src/ui/timelineMeasureCache.test.ts +986 -0
package/src/ui/useThrottledValue.ts +31 -0

package/src/core/models/modelSpecs.test.ts ADDED Viewed

@@ -0,0 +1,283 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { mkdtempSync, readFileSync, rmSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+import {
+  areModelSpecsEqual,
+  createLoadingModelSpec,
+  createModelSpecService,
+  createUnknownModelSpec,
+  extractModelSpecFromDocText,
+  KNOWN_MODEL_SPECS,
+  loadModelSpecCache,
+  MODEL_SPEC_DOC_URLS,
+  parseTokenCount,
+  resolveModelSpec,
+  saveModelSpecCache,
+  stripHtmlToText,
+  type ModelSpec,
+  type VerifiedModelSpec,
+} from "./modelSpecs.js";
+test("parses token counts with commas and suffixes", () => {
+  assert.equal(parseTokenCount("1,050,000"), 1_050_000);
+  assert.equal(parseTokenCount("128,000"), 128_000);
+  assert.equal(parseTokenCount("1.05M"), 1_050_000);
+  assert.equal(parseTokenCount("400k"), 400_000);
+  assert.equal(parseTokenCount("nope"), null);
+});
+test("extracts verified model specs from official-doc-like text", () => {
+  const spec = extractModelSpecFromDocText(
+    "gpt-5.4",
+    "GPT-5.4 1,050,000 context window 128,000 max output tokens",
+    123,
+  );
+  assert.deepEqual(spec, {
+    status: "verified",
+    contextWindow: 1_050_000,
+    maxOutputTokens: 128_000,
+    sourceUrl: MODEL_SPEC_DOC_URLS["gpt-5.4"],
+    verifiedAt: 123,
+  });
+});
+test("returns null for ambiguous or incomplete model spec text", () => {
+  assert.equal(
+    extractModelSpecFromDocText("gpt-5.4-mini", "GPT-5.4 mini supports coding and agents.", 123),
+    null,
+  );
+  assert.equal(
+    extractModelSpecFromDocText("gpt-5.4-mini", "400,000 context window but no output limit", 123),
+    null,
+  );
+});
+test("strips HTML before parsing model specs", () => {
+  const html = `
+    <html>
+      <body>
+        <h1>GPT-5.3-Codex</h1>
+        <div>400,000 <strong>context window</strong></div>
+        <div>128,000 <em>max output tokens</em></div>
+      </body>
+    </html>
+  `;
+  const text = stripHtmlToText(html);
+  assert.match(text, /400,000 context window/i);
+  assert.match(text, /128,000 max output tokens/i);
+});
+test("cache round-trip preserves verified values", () => {
+  const dir = mkdtempSync(join(tmpdir(), "codexa-model-specs-"));
+  const cacheFile = join(dir, "model-specs.json");
+  try {
+    const cache = {
+      "gpt-5.2": {
+        status: "verified" as const,
+        contextWindow: 400_000,
+        maxOutputTokens: 128_000,
+        sourceUrl: MODEL_SPEC_DOC_URLS["gpt-5.2"],
+        verifiedAt: 456,
+      },
+    };
+    saveModelSpecCache(cache, cacheFile);
+    const loaded = loadModelSpecCache(cacheFile);
+    assert.deepEqual(loaded, cache);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+test("background refresh updates specs and dedupes concurrent requests", async () => {
+  const dir = mkdtempSync(join(tmpdir(), "codexa-model-specs-"));
+  const cacheFile = join(dir, "model-specs.json");
+  let fetchCalls = 0;
+  const service = createModelSpecService({
+    cacheFile,
+    now: () => 789,
+    fetchImpl: async () => {
+      fetchCalls += 1;
+      return new Response("400,000 context window 128,000 max output tokens", { status: 200 });
+    },
+  });
+  try {
+    const [left, right] = await Promise.all([
+      service.refreshSpec("gpt-5.2"),
+      service.refreshSpec("gpt-5.2"),
+    ]);
+    assert.equal(fetchCalls, 1);
+    assert.equal(left.status, "verified");
+    assert.equal(right.status, "verified");
+    assert.equal(left.contextWindow, 400_000);
+    assert.equal(left.maxOutputTokens, 128_000);
+    const persisted = JSON.parse(readFileSync(cacheFile, "utf-8")) as Record<string, ModelSpec>;
+    assert.equal(persisted["gpt-5.2"]?.verifiedAt, 789);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+test("refresh returns unknown when a fetch fails even if cache exists", async () => {
+  const dir = mkdtempSync(join(tmpdir(), "codexa-model-specs-"));
+  const cacheFile = join(dir, "model-specs.json");
+  saveModelSpecCache({
+    "gpt-5.3-codex": {
+      status: "verified",
+      contextWindow: 400_000,
+      maxOutputTokens: 128_000,
+      sourceUrl: MODEL_SPEC_DOC_URLS["gpt-5.3-codex"],
+      verifiedAt: 123,
+    },
+  }, cacheFile);
+  const service = createModelSpecService({
+    cacheFile,
+    fetchImpl: async () => new Response("broken page", { status: 200 }),
+  });
+  try {
+    const spec = await service.refreshSpec("gpt-5.3-codex");
+    assert.equal(spec.status, "unknown");
+    assert.equal(spec.contextWindow, null);
+    assert.equal(spec.maxOutputTokens, null);
+    assert.equal(spec.error, "Unable to parse model spec for gpt-5.3-codex");
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+test("refresh returns unknown when there is no cache and verification fails", async () => {
+  const dir = mkdtempSync(join(tmpdir(), "codexa-model-specs-"));
+  const cacheFile = join(dir, "model-specs.json");
+  const service = createModelSpecService({
+    cacheFile,
+    fetchImpl: async () => new Response("no token limits here", { status: 200 }),
+  });
+  try {
+    const spec = await service.refreshSpec("gpt-5.2");
+    assert.deepEqual(spec, createUnknownModelSpec("gpt-5.2", "Unable to parse model spec for gpt-5.2"));
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+test("resolveModelSpec prefers runtime discovery metadata", () => {
+  const spec = resolveModelSpec("gpt-5.4", {
+    runtimeContextWindow: 2_000_000,
+    runtimeMaxOutputTokens: 256_000,
+    cache: {
+      "gpt-5.4": {
+        status: "verified",
+        contextWindow: 1_050_000,
+        maxOutputTokens: 128_000,
+        sourceUrl: MODEL_SPEC_DOC_URLS["gpt-5.4"]!,
+        verifiedAt: 1,
+      },
+    },
+    now: () => 999,
+  });
+  assert.equal(spec.status, "verified");
+  assert.equal(spec.contextWindow, 2_000_000);
+  assert.equal(spec.maxOutputTokens, 256_000);
+});
+test("resolveModelSpec falls back to persisted cache when runtime lacks context metadata", () => {
+  const spec = resolveModelSpec("gpt-5.4", {
+    cache: {
+      "gpt-5.4": {
+        status: "verified",
+        contextWindow: 1_050_000,
+        maxOutputTokens: 128_000,
+        sourceUrl: MODEL_SPEC_DOC_URLS["gpt-5.4"]!,
+        verifiedAt: 42,
+      },
+    },
+  });
+  assert.equal(spec.status, "verified");
+  assert.equal(spec.contextWindow, 1_050_000);
+  assert.equal(spec.verifiedAt, 42);
+});
+test("resolveModelSpec does not use static registry values when cache is empty", () => {
+  const spec = resolveModelSpec("gpt-5.4-mini", { now: () => 11 });
+  assert.equal(spec.status, "unknown");
+  assert.equal(spec.contextWindow, null);
+  assert.deepEqual(KNOWN_MODEL_SPECS, {});
+});
+test("resolveModelSpec returns loading while refresh is in-flight for unmapped models", () => {
+  const spec = resolveModelSpec("gpt-future-9", { refreshInFlight: true });
+  assert.equal(spec.status, "loading");
+  assert.equal(spec.contextWindow, null);
+});
+test("resolveModelSpec returns unknown only when no source can supply context metadata", () => {
+  const spec = resolveModelSpec("gpt-future-9");
+  assert.equal(spec.status, "unknown");
+  assert.equal(spec.contextWindow, null);
+});
+test("resolveModelSpec does not infer registry entries when switching between model names", () => {
+  const specFour = resolveModelSpec("gpt-5.4");
+  const specTwo = resolveModelSpec("gpt-5.2");
+  assert.equal(specFour.contextWindow, null);
+  assert.equal(specTwo.contextWindow, null);
+});
+test("reports equality across verified and unknown specs", () => {
+  assert.equal(
+    areModelSpecsEqual(
+      createLoadingModelSpec("gpt-5.4"),
+      createLoadingModelSpec("gpt-5.4"),
+    ),
+    true,
+  );
+  assert.equal(
+    areModelSpecsEqual(
+      createUnknownModelSpec("gpt-5.4", "a"),
+      createUnknownModelSpec("gpt-5.4", "b"),
+    ),
+    false,
+  );
+});
+test("resolveModelSpec returns unknown for claude-sonnet-4-6 without runtime/config context", () => {
+  const spec = resolveModelSpec("claude-sonnet-4-6");
+  assert.equal(spec.status, "unknown");
+  assert.equal(spec.contextWindow, null);
+});
+test("resolveModelSpec returns unknown for anthropic short alias 'haiku'", () => {
+  const spec = resolveModelSpec("haiku");
+  assert.equal(spec.status, "unknown");
+  assert.equal(spec.contextWindow, null);
+});
+test("resolveModelSpec returns unknown for gemini-2.5-flash without provider context metadata", () => {
+  const spec = resolveModelSpec("gemini-2.5-flash");
+  assert.equal(spec.status, "unknown");
+  assert.equal(spec.contextWindow, null);
+});
+test("resolveModelSpec returns null contextWindow (not 0) for an unrecognized model", () => {
+  const spec = resolveModelSpec("totally-unknown-model");
+  assert.equal(spec.status, "unknown");
+  assert.equal(spec.contextWindow, null);
+});
+test("resolveModelSpec does not estimate gemini-3-flash-preview", () => {
+  const spec = resolveModelSpec("gemini-3-flash-preview");
+  assert.equal(spec.status, "unknown");
+  assert.equal(spec.contextWindow, null);
+});

package/src/core/models/modelSpecs.ts ADDED Viewed

@@ -0,0 +1,300 @@
+import { readFileSync, renameSync, writeFileSync } from "fs";
+import { MODEL_SPECS_FILE } from "../../config/settings.js";
+export type ModelSpecStatus = "verified" | "loading" | "unknown";
+export interface VerifiedModelSpec {
+  status: "verified";
+  contextWindow: number;
+  maxOutputTokens: number;
+  sourceUrl: string;
+  verifiedAt: number;
+  isEstimated?: boolean;
+}
+export interface PendingModelSpec {
+  status: "loading" | "unknown";
+  contextWindow: null;
+  maxOutputTokens: null;
+  sourceUrl: string;
+  verifiedAt: null;
+  error: string | null;
+}
+export type ModelSpec = VerifiedModelSpec | PendingModelSpec;
+export const MODEL_SPEC_DOC_URLS: Record<string, string> = {
+  "gpt-5.4": "https://developers.openai.com/api/docs/models/gpt-5.4",
+  "gpt-5.4-mini": "https://developers.openai.com/api/docs/models/gpt-5.4-mini",
+  "gpt-5.3-codex": "https://developers.openai.com/api/docs/models/gpt-5.3-codex",
+  "gpt-5.2": "https://developers.openai.com/api/docs/models/gpt-5.2",
+};
+// Legacy model spec registry. Context-window display now goes through
+// providerRuntime/contextMetadata.ts so values are source-aware and provider
+// scoped. Keep this empty to avoid showing broad or guessed model limits.
+export interface KnownModelSpec {
+  contextWindow: number;
+  maxOutputTokens: number;
+}
+export const KNOWN_MODEL_SPECS: Record<string, KnownModelSpec> = {};
+type ModelSpecCache = Partial<Record<string, VerifiedModelSpec>>;
+interface ModelSpecServiceOptions {
+  cacheFile?: string;
+  fetchImpl?: typeof fetch;
+  now?: () => number;
+}
+function createPendingModelSpec(
+  model: string,
+  status: PendingModelSpec["status"],
+  error: string | null = null,
+): PendingModelSpec {
+  return {
+    status,
+    contextWindow: null,
+    maxOutputTokens: null,
+    sourceUrl: getModelSpecDocUrl(model),
+    verifiedAt: null,
+    error,
+  };
+}
+function getModelSpecDocUrl(model: string): string {
+  return MODEL_SPEC_DOC_URLS[model] ?? `https://developers.openai.com/api/docs/models/${encodeURIComponent(model)}`;
+}
+export function createLoadingModelSpec(model: string): ModelSpec {
+  return createPendingModelSpec(model, "loading");
+}
+export function createUnknownModelSpec(model: string, error: string | null = null): ModelSpec {
+  return createPendingModelSpec(model, "unknown", error);
+}
+export function parseTokenCount(rawValue: string): number | null {
+  const normalized = rawValue.trim().replace(/\s+/g, "").toLowerCase();
+  if (!normalized) return null;
+  const suffix = normalized.endsWith("m")
+    ? 1_000_000
+    : normalized.endsWith("k")
+      ? 1_000
+      : 1;
+  const numericText = suffix === 1 ? normalized : normalized.slice(0, -1);
+  const numeric = Number.parseFloat(numericText.replace(/,/g, ""));
+  if (!Number.isFinite(numeric)) return null;
+  return Math.round(numeric * suffix);
+}
+export function stripHtmlToText(html: string): string {
+  return html
+    .replace(/<script\b[\s\S]*?<\/script[^>]*>/gi, " ")
+    .replace(/<style[\s\S]*?<\/style>/gi, " ")
+    .replace(/<[^>]+>/g, " ")
+    .replace(/&nbsp;|&#160;/gi, " ")
+    .replace(/&quot;/gi, "\"")
+    .replace(/&#39;|&apos;/gi, "'")
+    .replace(/&amp;/gi, "&")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+export function extractModelSpecFromDocText(
+  model: string,
+  text: string,
+  verifiedAt = Date.now(),
+): VerifiedModelSpec | null {
+  const normalized = text.replace(/\u00a0/g, " ").replace(/\s+/g, " ");
+  const contextMatch = normalized.match(/(\d[\d,.]*(?:\s*[mk])?)\s+context\s+window/i);
+  const maxOutputMatch = normalized.match(/(\d[\d,.]*(?:\s*[mk])?)\s+max\s+output\s+tokens/i);
+  const contextWindow = contextMatch ? parseTokenCount(contextMatch[1] ?? "") : null;
+  const maxOutputTokens = maxOutputMatch ? parseTokenCount(maxOutputMatch[1] ?? "") : null;
+  if (!contextWindow || !maxOutputTokens) {
+    return null;
+  }
+  return {
+    status: "verified",
+    contextWindow,
+    maxOutputTokens,
+    sourceUrl: getModelSpecDocUrl(model),
+    verifiedAt,
+  };
+}
+function isVerifiedModelSpec(value: unknown): value is VerifiedModelSpec {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value as Partial<VerifiedModelSpec>;
+  return candidate.status === "verified"
+    && typeof candidate.contextWindow === "number"
+    && Number.isFinite(candidate.contextWindow)
+    && typeof candidate.maxOutputTokens === "number"
+    && Number.isFinite(candidate.maxOutputTokens)
+    && typeof candidate.sourceUrl === "string"
+    && typeof candidate.verifiedAt === "number"
+    && Number.isFinite(candidate.verifiedAt);
+}
+export function loadModelSpecCache(cacheFile = MODEL_SPECS_FILE): ModelSpecCache {
+  try {
+    const raw = JSON.parse(readFileSync(cacheFile, "utf-8")) as Record<string, unknown>;
+    const cache: ModelSpecCache = {};
+    for (const [model, value] of Object.entries(raw)) {
+      if (isVerifiedModelSpec(value)) {
+        cache[model] = value;
+      }
+    }
+    return cache;
+  } catch {
+    return {};
+  }
+}
+export function saveModelSpecCache(cache: ModelSpecCache, cacheFile = MODEL_SPECS_FILE): void {
+  try {
+    const tmpFile = `${cacheFile}.tmp`;
+    writeFileSync(tmpFile, JSON.stringify(cache, null, 2), "utf-8");
+    renameSync(tmpFile, cacheFile);
+  } catch {
+    // Best-effort cache only.
+  }
+}
+export async function fetchModelSpecFromDocs(
+  model: string,
+  fetchImpl: typeof fetch = fetch,
+  verifiedAt = Date.now(),
+): Promise<VerifiedModelSpec> {
+  const response = await fetchImpl(getModelSpecDocUrl(model), {
+    headers: {
+      Accept: "text/html,application/xhtml+xml",
+    },
+  });
+  if (!response.ok) {
+    throw new Error(`Spec request failed with ${response.status}`);
+  }
+  const html = await response.text();
+  const parsed = extractModelSpecFromDocText(model, stripHtmlToText(html), verifiedAt);
+  if (!parsed) {
+    throw new Error(`Unable to parse model spec for ${model}`);
+  }
+  return parsed;
+}
+export interface ResolveModelSpecOptions {
+  // Persisted verified cache (loaded synchronously at startup).
+  cache?: Partial<Record<string, VerifiedModelSpec>>;
+  // Runtime discovery contextWindow if/when Codex starts providing it.
+  runtimeContextWindow?: number | null;
+  runtimeMaxOutputTokens?: number | null;
+  // Set true when a background refresh is in progress and no other source
+  // has produced verified numbers — lets callers render a "loading" state
+  // instead of "unknown".
+  refreshInFlight?: boolean;
+  now?: () => number;
+}
+// Single authoritative resolver. Precedence:
+//   1. Runtime discovery metadata (if contextWindow is provided)
+//   2. Persistent spec cache (~/.codexa-model-specs.json)
+//   3. Trusted static registry (KNOWN_MODEL_SPECS)
+//   4. Loading (if a background refresh is in-flight)
+//   5. Unknown
+export function resolveModelSpec(model: string, options: ResolveModelSpecOptions = {}): ModelSpec {
+  const now = options.now?.() ?? Date.now();
+  const runtimeCtx = options.runtimeContextWindow;
+  const runtimeMax = options.runtimeMaxOutputTokens;
+  if (
+    typeof runtimeCtx === "number" && Number.isFinite(runtimeCtx) && runtimeCtx > 0
+    && typeof runtimeMax === "number" && Number.isFinite(runtimeMax) && runtimeMax > 0
+  ) {
+    return {
+      status: "verified",
+      contextWindow: runtimeCtx,
+      maxOutputTokens: runtimeMax,
+      sourceUrl: getModelSpecDocUrl(model),
+      verifiedAt: now,
+    };
+  }
+  const cached = options.cache?.[model];
+  if (cached && cached.status === "verified") {
+    return cached;
+  }
+  const known = KNOWN_MODEL_SPECS[model];
+  if (known) {
+    return {
+      status: "verified",
+      contextWindow: known.contextWindow,
+      maxOutputTokens: known.maxOutputTokens,
+      sourceUrl: getModelSpecDocUrl(model),
+      verifiedAt: now,
+    };
+  }
+  if (options.refreshInFlight) {
+    return createLoadingModelSpec(model);
+  }
+  return createUnknownModelSpec(model);
+}
+export function areModelSpecsEqual(left: ModelSpec | undefined, right: ModelSpec): boolean {
+  if (!left) return false;
+  if (left.status !== right.status) return false;
+  return left.contextWindow === right.contextWindow
+    && left.maxOutputTokens === right.maxOutputTokens
+    && left.sourceUrl === right.sourceUrl
+    && left.verifiedAt === right.verifiedAt
+    && ("error" in left ? left.error : null) === ("error" in right ? right.error : null);
+}
+export function createModelSpecService(options: ModelSpecServiceOptions = {}) {
+  const cacheFile = options.cacheFile ?? MODEL_SPECS_FILE;
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const now = options.now ?? Date.now;
+  // Persisted specs are kept for saving, not for live UI trust.
+  const cache = loadModelSpecCache(cacheFile);
+  const inflight = new Map<string, Promise<ModelSpec>>();
+  return {
+    async refreshSpec(model: string): Promise<ModelSpec> {
+      const current = inflight.get(model);
+      if (current) return current;
+      const refreshPromise = (async () => {
+        try {
+          const verified = await fetchModelSpecFromDocs(model, fetchImpl, now());
+          cache[model] = verified;
+          saveModelSpecCache(cache, cacheFile);
+          return verified;
+        } catch (error) {
+          return createUnknownModelSpec(
+            model,
+            error instanceof Error ? error.message : "Unknown model spec failure",
+          );
+        } finally {
+          inflight.delete(model);
+        }
+      })();
+      inflight.set(model, refreshPromise);
+      return refreshPromise;
+    },
+  };
+}

package/src/core/perf/profiler.ts ADDED Viewed

@@ -0,0 +1,125 @@
+import { appendFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+export interface PerfSession {
+  runId: string;
+  marks: Record<string, number>;
+  counters: Record<string, number>;
+  accumulations: Record<string, number>;
+  metadata: Record<string, unknown>;
+}
+let _enabled: boolean | null = null;
+let _session: PerfSession | null = null;
+export function isEnabled(): boolean {
+  if (_enabled === null) {
+    _enabled = process.env["CODEXA_PERF"] === "1";
+  }
+  return _enabled;
+}
+export function startSession(runId: string): void {
+  if (!isEnabled()) return;
+  _session = { runId, marks: {}, counters: {}, accumulations: {}, metadata: {} };
+}
+export function mark(label: string): void {
+  if (_session) _session.marks[label] = performance.now();
+}
+export function inc(counter: string, by = 1): void {
+  if (_session) _session.counters[counter] = (_session.counters[counter] ?? 0) + by;
+}
+export function accumulate(key: string, ms: number): void {
+  if (_session) _session.accumulations[key] = (_session.accumulations[key] ?? 0) + ms;
+}
+export function setMeta(key: string, value: unknown): void {
+  if (_session) _session.metadata[key] = value;
+}
+export function getSession(): PerfSession | null {
+  return _session;
+}
+// ─── Formatting ───────────────────────────────────────────────────────────────
+function dur(session: PerfSession, from: string, to: string): string {
+  const a = session.marks[from];
+  const b = session.marks[to];
+  if (a === undefined || b === undefined) return "   ?";
+  return String(Math.round(b - a)).padStart(4);
+}
+const STAGE_ROWS: Array<[from: string, to: string, label: string, note?: string]> = [
+  ["submit", "dispatch_start", "submit → dispatch_start", "pre-dispatch overhead"],
+  ["dispatch_start", "provider_run_start", "dispatch_start → provider_run_start", "orchestration setup"],
+  ["exec_resolve_start", "exec_resolve_end", "exec_resolve", "cached after first run"],
+  ["caps_probe_start", "caps_probe_end", "caps_probe", "cached after first run"],
+  ["provider_run_start", "spawn_done", "provider_run_start → spawn_done", "spawn overhead"],
+  ["spawn_done", "first_chunk", "spawn_done → first_chunk  (TTFT)", "← backend latency"],
+  ["first_chunk", "first_render", "first_chunk → first_render", "render dispatch"],
+  ["first_chunk", "last_chunk", "streaming duration", "total stream time"],
+  ["last_chunk", "response_cb_start", "last_chunk → response_cb", ""],
+  ["snapshot_start", "snapshot_end", "workspace_snapshot  (blocking)", "← post-run overhead"],
+  ["finalize_start", "finalize_done", "finalize_start → finalize_done", ""],
+];
+export function buildSummary(session: PerfSession): string {
+  const lines: string[] = [
+    "┌── CODEXA PERF REPORT ─────────────────────────────────────────",
+    "│ Stage                                         ms",
+  ];
+  const durations: Array<{ label: string; ms: number }> = [];
+  for (const [from, to, label, note] of STAGE_ROWS) {
+    const a = session.marks[from];
+    const b = session.marks[to];
+    const ms = a !== undefined && b !== undefined ? Math.round(b - a) : null;
+    const msStr = ms !== null ? String(ms).padStart(4) : "   ?";
+    const noteStr = note ? `  ${note}` : "";
+    lines.push(`│  ${label.padEnd(44)} ${msStr}ms${noteStr}`);
+    if (ms !== null) durations.push({ label, ms });
+  }
+  const c = session.counters;
+  const a = session.accumulations;
+  lines.push("│");
+  lines.push(
+    `│  Counters   chunks=${c["chunks"] ?? 0}  flushes=${c["flushes"] ?? 0}  progress_updates=${c["progress_updates"] ?? 0}`,
+  );
+  lines.push(`│  Sanitise   accumulated ${Math.round(a["sanitize_ms"] ?? 0)}ms across ${c["chunks"] ?? 0} chunks`);
+  const metaEntries = Object.entries(session.metadata);
+  if (metaEntries.length > 0) {
+    lines.push("│");
+    for (const [k, v] of metaEntries) {
+      lines.push(`│  ${k}: ${String(v)}`);
+    }
+  }
+  // Bottleneck: largest duration stage
+  if (durations.length > 0) {
+    const top = durations.reduce((a, b) => (b.ms > a.ms ? b : a));
+    lines.push("│");
+    lines.push(`│  ► BOTTLENECK: ${top.label} = ${top.ms}ms`);
+  }
+  lines.push("└───────────────────────────────────────────────────────────────");
+  return lines.join("\n");
+}
+// Sessions are appended as JSONL to ~/.codexa-perf.jsonl for offline analysis.
+export function persistSession(session: PerfSession): void {
+  try {
+    const logPath = join(homedir(), ".codexa-perf.jsonl");
+    const line = JSON.stringify({ ...session, ts: Date.now() }) + "\n";
+    appendFileSync(logPath, line, "utf8");
+  } catch {
+    // Profiling must never crash the app.
+  }
+}