@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
  1. package/README.md +320 -0
  2. package/bin/codexa.js +445 -0
  3. package/package.json +45 -0
  4. package/scripts/audit-codexa-capabilities.mjs +466 -0
  5. package/scripts/smoke-terminal-bench.mjs +35 -0
  6. package/src/app.tsx +4561 -0
  7. package/src/appRenderStability.test.ts +131 -0
  8. package/src/commands/handler.test.ts +643 -0
  9. package/src/commands/handler.ts +875 -0
  10. package/src/config/launchArgs.test.ts +158 -0
  11. package/src/config/launchArgs.ts +186 -0
  12. package/src/config/layeredConfig.test.ts +143 -0
  13. package/src/config/layeredConfig.ts +836 -0
  14. package/src/config/persistence.test.ts +110 -0
  15. package/src/config/persistence.ts +311 -0
  16. package/src/config/runtimeConfig.test.ts +218 -0
  17. package/src/config/runtimeConfig.ts +554 -0
  18. package/src/config/settings.test.ts +155 -0
  19. package/src/config/settings.ts +401 -0
  20. package/src/config/toml-serialize.ts +98 -0
  21. package/src/config/trustStore.test.ts +29 -0
  22. package/src/config/trustStore.ts +68 -0
  23. package/src/core/attachments.test.ts +155 -0
  24. package/src/core/attachments.ts +71 -0
  25. package/src/core/auth/codexAuth.test.ts +68 -0
  26. package/src/core/auth/codexAuth.ts +359 -0
  27. package/src/core/cleanupFastFail.test.ts +76 -0
  28. package/src/core/cleanupFastFail.ts +67 -0
  29. package/src/core/clipboard.ts +24 -0
  30. package/src/core/codex.ts +124 -0
  31. package/src/core/codexExecArgs.test.ts +195 -0
  32. package/src/core/codexExecArgs.ts +152 -0
  33. package/src/core/codexLaunch.test.ts +205 -0
  34. package/src/core/codexLaunch.ts +162 -0
  35. package/src/core/codexPrompt.test.ts +252 -0
  36. package/src/core/codexPrompt.ts +428 -0
  37. package/src/core/executables/claudeExecutable.ts +63 -0
  38. package/src/core/executables/codexExecutable.test.ts +212 -0
  39. package/src/core/executables/codexExecutable.ts +159 -0
  40. package/src/core/executables/executableResolver.test.ts +129 -0
  41. package/src/core/executables/executableResolver.ts +138 -0
  42. package/src/core/executables/geminiExecutable.test.ts +116 -0
  43. package/src/core/executables/geminiExecutable.ts +78 -0
  44. package/src/core/executables/pathSanityScan.test.ts +47 -0
  45. package/src/core/githubDiagnostics.test.ts +92 -0
  46. package/src/core/githubDiagnostics.ts +222 -0
  47. package/src/core/hollowResponseFormat.test.ts +58 -0
  48. package/src/core/hollowResponseFormat.ts +39 -0
  49. package/src/core/inputDebug.ts +51 -0
  50. package/src/core/launchContext.test.ts +157 -0
  51. package/src/core/launchContext.ts +266 -0
  52. package/src/core/models/codexCapabilities.test.ts +45 -0
  53. package/src/core/models/codexCapabilities.ts +95 -0
  54. package/src/core/models/codexModelCapabilities.test.ts +246 -0
  55. package/src/core/models/codexModelCapabilities.ts +571 -0
  56. package/src/core/models/modelSpecs.test.ts +283 -0
  57. package/src/core/models/modelSpecs.ts +300 -0
  58. package/src/core/perf/profiler.ts +125 -0
  59. package/src/core/perf/renderDebug.test.ts +230 -0
  60. package/src/core/perf/renderDebug.ts +373 -0
  61. package/src/core/planStorage.test.ts +143 -0
  62. package/src/core/planStorage.ts +141 -0
  63. package/src/core/process/CommandRunner.test.ts +105 -0
  64. package/src/core/process/CommandRunner.ts +269 -0
  65. package/src/core/process/processValidation.ts +101 -0
  66. package/src/core/projectInstructions.test.ts +50 -0
  67. package/src/core/projectInstructions.ts +54 -0
  68. package/src/core/providerLauncher/launcher.test.ts +238 -0
  69. package/src/core/providerLauncher/launcher.ts +203 -0
  70. package/src/core/providerLauncher/registry.test.ts +324 -0
  71. package/src/core/providerLauncher/registry.ts +253 -0
  72. package/src/core/providerLauncher/types.ts +84 -0
  73. package/src/core/providerLauncher/workspaceConfig.test.ts +638 -0
  74. package/src/core/providerLauncher/workspaceConfig.ts +407 -0
  75. package/src/core/providerRuntime/anthropic.test.ts +1120 -0
  76. package/src/core/providerRuntime/anthropic.ts +576 -0
  77. package/src/core/providerRuntime/capabilityProfile.test.ts +311 -0
  78. package/src/core/providerRuntime/capabilityProfile.ts +288 -0
  79. package/src/core/providerRuntime/claudeCodeDiscovery.ts +446 -0
  80. package/src/core/providerRuntime/contextMetadata.test.ts +468 -0
  81. package/src/core/providerRuntime/contextMetadata.ts +409 -0
  82. package/src/core/providerRuntime/gemini.test.ts +437 -0
  83. package/src/core/providerRuntime/gemini.ts +784 -0
  84. package/src/core/providerRuntime/lmstudio.test.ts +168 -0
  85. package/src/core/providerRuntime/lmstudio.ts +118 -0
  86. package/src/core/providerRuntime/local.test.ts +787 -0
  87. package/src/core/providerRuntime/local.ts +754 -0
  88. package/src/core/providerRuntime/models.ts +150 -0
  89. package/src/core/providerRuntime/reasoning.ts +17 -0
  90. package/src/core/providerRuntime/registry.test.ts +233 -0
  91. package/src/core/providerRuntime/registry.ts +203 -0
  92. package/src/core/providerRuntime/types.ts +103 -0
  93. package/src/core/providers/codexJsonStream.test.ts +148 -0
  94. package/src/core/providers/codexJsonStream.ts +305 -0
  95. package/src/core/providers/codexSubprocess.test.ts +68 -0
  96. package/src/core/providers/codexSubprocess.ts +372 -0
  97. package/src/core/providers/codexTranscript.test.ts +284 -0
  98. package/src/core/providers/codexTranscript.ts +695 -0
  99. package/src/core/providers/openaiNative.ts +13 -0
  100. package/src/core/providers/registry.ts +21 -0
  101. package/src/core/providers/types.ts +59 -0
  102. package/src/core/terminal/terminalCapabilities.test.ts +93 -0
  103. package/src/core/terminal/terminalCapabilities.ts +100 -0
  104. package/src/core/terminal/terminalControl.test.ts +75 -0
  105. package/src/core/terminal/terminalControl.ts +147 -0
  106. package/src/core/terminal/terminalSanitize.test.ts +22 -0
  107. package/src/core/terminal/terminalSanitize.ts +147 -0
  108. package/src/core/terminal/terminalSelection.test.ts +42 -0
  109. package/src/core/terminal/terminalSelection.ts +66 -0
  110. package/src/core/terminal/terminalTitle.test.ts +328 -0
  111. package/src/core/terminal/terminalTitle.ts +483 -0
  112. package/src/core/workspaceActivity.test.ts +163 -0
  113. package/src/core/workspaceActivity.ts +380 -0
  114. package/src/core/workspaceGuard.test.ts +151 -0
  115. package/src/core/workspaceGuard.ts +288 -0
  116. package/src/core/workspaceRoot.test.ts +23 -0
  117. package/src/core/workspaceRoot.ts +47 -0
  118. package/src/exec.test.ts +13 -0
  119. package/src/exec.ts +72 -0
  120. package/src/headless/execArgs.test.ts +147 -0
  121. package/src/headless/execArgs.ts +294 -0
  122. package/src/headless/execRunner.test.ts +434 -0
  123. package/src/headless/execRunner.ts +304 -0
  124. package/src/index.test.tsx +618 -0
  125. package/src/index.tsx +296 -0
  126. package/src/session/appSession.test.ts +897 -0
  127. package/src/session/appSession.ts +761 -0
  128. package/src/session/chatLifecycle.test.ts +64 -0
  129. package/src/session/chatLifecycle.ts +951 -0
  130. package/src/session/liveRenderScheduler.test.ts +201 -0
  131. package/src/session/liveRenderScheduler.ts +214 -0
  132. package/src/session/planFlow.test.ts +103 -0
  133. package/src/session/planFlow.ts +149 -0
  134. package/src/session/planTranscript.test.ts +65 -0
  135. package/src/session/planTranscript.ts +15 -0
  136. package/src/session/promptRunSchedule.test.ts +36 -0
  137. package/src/session/promptRunSchedule.ts +26 -0
  138. package/src/session/types.ts +228 -0
  139. package/src/test/runtimeTestUtils.ts +14 -0
  140. package/src/types/react-dom.d.ts +3 -0
  141. package/src/ui/ActionRequiredBlock.tsx +38 -0
  142. package/src/ui/ActivityBars.tsx +68 -0
  143. package/src/ui/ActivityIndicator.test.tsx +58 -0
  144. package/src/ui/ActivityIndicator.tsx +58 -0
  145. package/src/ui/AgentBlock.test.ts +6 -0
  146. package/src/ui/AgentBlock.tsx +130 -0
  147. package/src/ui/AnimatedStatusText.test.ts +16 -0
  148. package/src/ui/AnimatedStatusText.tsx +69 -0
  149. package/src/ui/AppShell.test.tsx +1739 -0
  150. package/src/ui/AppShell.tsx +698 -0
  151. package/src/ui/AttachmentImportPanel.test.tsx +204 -0
  152. package/src/ui/AttachmentImportPanel.tsx +98 -0
  153. package/src/ui/AuthPanel.tsx +113 -0
  154. package/src/ui/BackendPicker.tsx +28 -0
  155. package/src/ui/BottomComposer.test.ts +674 -0
  156. package/src/ui/BottomComposer.tsx +1028 -0
  157. package/src/ui/CodexLogo.tsx +55 -0
  158. package/src/ui/DashCard.tsx +82 -0
  159. package/src/ui/Markdown.test.ts +157 -0
  160. package/src/ui/Markdown.tsx +310 -0
  161. package/src/ui/ModePicker.tsx +27 -0
  162. package/src/ui/ModelPicker.tsx +31 -0
  163. package/src/ui/ModelPickerProviderScope.test.tsx +411 -0
  164. package/src/ui/ModelPickerScreen.test.tsx +99 -0
  165. package/src/ui/ModelPickerScreen.tsx +416 -0
  166. package/src/ui/ModelPickerState.test.tsx +151 -0
  167. package/src/ui/ModelReasoningPicker.test.tsx +447 -0
  168. package/src/ui/ModelReasoningPicker.tsx +458 -0
  169. package/src/ui/Panel.tsx +51 -0
  170. package/src/ui/PermissionsPanel.tsx +78 -0
  171. package/src/ui/PlanActionPicker.tsx +119 -0
  172. package/src/ui/PlanReviewPanel.test.tsx +267 -0
  173. package/src/ui/PlanReviewPanel.tsx +212 -0
  174. package/src/ui/PromptCardBorder.test.tsx +161 -0
  175. package/src/ui/ProviderPicker.test.tsx +289 -0
  176. package/src/ui/ProviderPicker.tsx +321 -0
  177. package/src/ui/ProviderShortcut.test.tsx +143 -0
  178. package/src/ui/ReasoningPicker.tsx +46 -0
  179. package/src/ui/RunFooter.tsx +65 -0
  180. package/src/ui/SelectionPanel.tsx +67 -0
  181. package/src/ui/SettingsPanel.test.tsx +233 -0
  182. package/src/ui/SettingsPanel.tsx +156 -0
  183. package/src/ui/Spinner.tsx +25 -0
  184. package/src/ui/StaticIntroItem.tsx +54 -0
  185. package/src/ui/StaticTranscriptItem.tsx +56 -0
  186. package/src/ui/TextEntryPanel.tsx +139 -0
  187. package/src/ui/ThemePicker.tsx +31 -0
  188. package/src/ui/ThinkingBlock.tsx +100 -0
  189. package/src/ui/Timeline.test.ts +2067 -0
  190. package/src/ui/Timeline.tsx +1472 -0
  191. package/src/ui/TimelineNavigation.test.tsx +201 -0
  192. package/src/ui/TopHeader.test.tsx +239 -0
  193. package/src/ui/TopHeader.tsx +257 -0
  194. package/src/ui/TurnGroup.test.tsx +365 -0
  195. package/src/ui/TurnGroup.tsx +657 -0
  196. package/src/ui/busyStatusAnimation.test.ts +30 -0
  197. package/src/ui/busyStatusAnimation.ts +11 -0
  198. package/src/ui/commandNormalize.test.ts +142 -0
  199. package/src/ui/commandNormalize.ts +66 -0
  200. package/src/ui/diffRenderer.test.ts +102 -0
  201. package/src/ui/diffRenderer.ts +116 -0
  202. package/src/ui/focus.ts +61 -0
  203. package/src/ui/focusFlow.test.tsx +1098 -0
  204. package/src/ui/inputBuffer.test.ts +151 -0
  205. package/src/ui/inputBuffer.ts +203 -0
  206. package/src/ui/layout.test.ts +145 -0
  207. package/src/ui/layout.ts +287 -0
  208. package/src/ui/modeDisplay.test.ts +42 -0
  209. package/src/ui/modeDisplay.ts +52 -0
  210. package/src/ui/outputPipeline.ts +64 -0
  211. package/src/ui/progressEntries.ts +156 -0
  212. package/src/ui/runActivityView.test.ts +89 -0
  213. package/src/ui/runActivityView.ts +37 -0
  214. package/src/ui/runLifecycleView.test.tsx +237 -0
  215. package/src/ui/slashCommands.ts +41 -0
  216. package/src/ui/statusRenderIsolation.test.tsx +654 -0
  217. package/src/ui/terminalAnswerFormat.test.ts +19 -0
  218. package/src/ui/terminalAnswerFormat.ts +128 -0
  219. package/src/ui/textLayout.test.ts +18 -0
  220. package/src/ui/textLayout.ts +338 -0
  221. package/src/ui/theme.tsx +395 -0
  222. package/src/ui/themeFlow.test.ts +53 -0
  223. package/src/ui/themeFlow.ts +41 -0
  224. package/src/ui/timelineMeasure.ts +3088 -0
  225. package/src/ui/timelineMeasureCache.test.ts +986 -0
  226. package/src/ui/useThrottledValue.ts +31 -0
@@ -0,0 +1,130 @@
1
+ import React, { memo, useDeferredValue, useMemo } from "react";
2
+ import { Box, Text } from "ink";
3
+ import type { AssistantEvent, RunEvent } from "../session/types.js";
4
+ import { getAssistantContent } from "../session/types.js";
5
+ import { MemoizedRenderMessage } from "./Markdown.js";
6
+ import { getUsableShellWidth } from "./layout.js";
7
+ import { useTheme } from "./theme.js";
8
+ import { wrapPlainText } from "./textLayout.js";
9
+ import { RUN_OUTPUT_TRUNCATION_NOTICE } from "../session/chatLifecycle.js";
10
+ import { sanitizeTerminalOutput } from "../core/terminal/terminalSanitize.js";
11
+ import {
12
+ sanitizeOutput,
13
+ sanitizeStreamChunk,
14
+ normalizeOutput,
15
+ classifyOutput,
16
+ formatForBox,
17
+ } from "./outputPipeline.js";
18
+ import { DashCard } from "./DashCard.js";
19
+
20
+
21
+ function formatDuration(ms: number): string {
22
+ if (ms < 1000) return `${ms}ms`;
23
+ return `${(ms / 1000).toFixed(1)}s`;
24
+ }
25
+
26
+ interface AgentBlockProps {
27
+ cols: number;
28
+ assistant: AssistantEvent | null;
29
+ run: RunEvent | null;
30
+ streaming: boolean;
31
+ turnIndex: number;
32
+ dim?: boolean;
33
+ runPhase?: "streaming" | "final";
34
+ streamingPreviewRows?: number;
35
+ streamingMode?: "assistant-first";
36
+ }
37
+
38
+ const MemoizedMessageBody = memo(function MessageBody({
39
+ segments,
40
+ width,
41
+ }: {
42
+ segments: ReturnType<typeof formatForBox>;
43
+ width: number;
44
+ }) {
45
+ return <MemoizedRenderMessage segments={segments} width={width} />;
46
+ }, (prev, next) => prev.segments === next.segments && prev.width === next.width);
47
+
48
+ const StreamingCursor = memo(function StreamingCursor() {
49
+ const theme = useTheme();
50
+ return (
51
+ <Box width="100%" paddingLeft={2}>
52
+ <Text color={theme.ACCENT}>{"▌"}</Text>
53
+ </Box>
54
+ );
55
+ });
56
+
57
+ export function AgentBlock({
58
+ cols,
59
+ assistant,
60
+ run,
61
+ streaming,
62
+ dim = false,
63
+ runPhase = streaming ? "streaming" : "final",
64
+ }: AgentBlockProps) {
65
+ const theme = useTheme();
66
+ const content = getAssistantContent(assistant);
67
+ const deferredContent = useDeferredValue(content);
68
+ // During streaming, use content directly for immediate rendering.
69
+ // When not streaming, defer large final content to avoid blocking input.
70
+ const renderContent = streaming ? content : deferredContent;
71
+ const contentWidth = Math.max(1, getUsableShellWidth(cols, 4));
72
+
73
+ const pipelineState = useMemo(() => {
74
+ const sanitized = streaming ? sanitizeStreamChunk(renderContent) : sanitizeOutput(renderContent);
75
+ const normalized = normalizeOutput(sanitized);
76
+ const classified = classifyOutput(normalized);
77
+ const formatted = formatForBox(classified, contentWidth);
78
+ return { length: normalized.length, formatted };
79
+ }, [contentWidth, renderContent, streaming]);
80
+
81
+ const failureMessage = run?.status === "failed"
82
+ ? sanitizeTerminalOutput(run.errorMessage ?? run.summary)
83
+ : null;
84
+ const cancelMessage = run?.status === "canceled" ? sanitizeTerminalOutput(run.summary) : null;
85
+
86
+ const runStatus = runPhase === "streaming"
87
+ ? "streaming"
88
+ : run?.status === "completed"
89
+ ? "complete"
90
+ : run?.status ?? "running";
91
+ const rightBadge = run?.durationMs != null && runPhase !== "streaming"
92
+ ? `${runStatus} • ${formatDuration(run.durationMs)}`
93
+ : runStatus;
94
+ const heading = run?.runtime.model ? run.runtime.model.toUpperCase().replace(/-/g, " ") : "Codex";
95
+
96
+ const borderColor = dim ? theme.BORDER_SUBTLE : (runPhase === "streaming" ? theme.BORDER_ACTIVE : theme.BORDER_SUBTLE);
97
+
98
+ return (
99
+ <DashCard cols={cols} title={heading} rightBadge={rightBadge} borderColor={borderColor}>
100
+ {!streaming && failureMessage && (
101
+ <Box flexDirection="column" width="100%">
102
+ {wrapPlainText(failureMessage, contentWidth).map((row, index) => (
103
+ <Text key={index} color={theme.ERROR}>{index === 0 ? `✕ ${row || " "}` : row || " "}</Text>
104
+ ))}
105
+ </Box>
106
+ )}
107
+
108
+ {pipelineState.length > 0 && (
109
+ <Box flexDirection="column" width="100%">
110
+ <MemoizedMessageBody segments={pipelineState.formatted} width={contentWidth} />
111
+ </Box>
112
+ )}
113
+
114
+ {streaming && <StreamingCursor />}
115
+
116
+ {!streaming && run && run.status !== "running" && (
117
+ <Box flexDirection="column" width="100%">
118
+ {run.status === "canceled" && cancelMessage ? (
119
+ <Text color={theme.WARNING}>{cancelMessage}</Text>
120
+ ) : run.status === "completed" && pipelineState.length === 0 ? (
121
+ <Text color={theme.DIM}>{"(no output)"}</Text>
122
+ ) : null}
123
+ {run.truncatedOutput && (
124
+ <Text color={theme.DIM}>{RUN_OUTPUT_TRUNCATION_NOTICE}</Text>
125
+ )}
126
+ </Box>
127
+ )}
128
+ </DashCard>
129
+ );
130
+ }
@@ -0,0 +1,16 @@
1
+ import assert from "node:assert/strict";
2
+ import { readFileSync } from "node:fs";
3
+ import { fileURLToPath } from "node:url";
4
+ import { dirname, join } from "node:path";
5
+ import test from "node:test";
6
+
7
+ const here = dirname(fileURLToPath(import.meta.url));
8
+
9
+ test("busy status text owns the local animation timer", () => {
10
+ const source = readFileSync(join(here, "AnimatedStatusText.tsx"), "utf8");
11
+
12
+ assert.match(source, /setInterval/);
13
+ assert.match(source, /useEffect/);
14
+ assert.match(source, /useState/);
15
+ assert.doesNotMatch(source, /useAnimatedDots|useThrottledValue/);
16
+ });
@@ -0,0 +1,69 @@
1
+ import React, { useEffect, useState } from "react";
2
+ import { Text } from "ink";
3
+ import * as renderDebug from "../core/perf/renderDebug.js";
4
+ import { useTheme } from "./theme.js";
5
+ import { sanitizeTerminalOutput } from "../core/terminal/terminalSanitize.js";
6
+ import { BUSY_STATUS_FRAME_MS, BUSY_STATUS_FRAMES, getBusyStatusFrame } from "./busyStatusAnimation.js";
7
+
8
+ interface AnimatedStatusTextProps {
9
+ baseText: string;
10
+ isActive: boolean;
11
+ isError?: boolean;
12
+ animationFrame?: string;
13
+ }
14
+
15
+ function useLocalBusyStatusFrame(isActive: boolean, label: string): string {
16
+ const [frameIndex, setFrameIndex] = useState(0);
17
+ const staticStatus = process.env.CODEXA_DEBUG_STATIC_STATUS === "1";
18
+
19
+ useEffect(() => {
20
+ if (!isActive || staticStatus) {
21
+ setFrameIndex(0);
22
+ return;
23
+ }
24
+
25
+ setFrameIndex(0);
26
+ const timer = setInterval(() => {
27
+ setFrameIndex((current) => {
28
+ const next = current + 1;
29
+ renderDebug.traceStatusTick({ owner: "Status", label, frameIndex: next });
30
+ return next;
31
+ });
32
+ }, BUSY_STATUS_FRAME_MS);
33
+ timer.unref?.();
34
+
35
+ return () => {
36
+ clearInterval(timer);
37
+ };
38
+ }, [isActive, label, staticStatus]);
39
+
40
+ if (isActive && staticStatus) {
41
+ return BUSY_STATUS_FRAMES[BUSY_STATUS_FRAMES.length - 1]!;
42
+ }
43
+ return getBusyStatusFrame(frameIndex);
44
+ }
45
+
46
+ export function AnimatedStatusText({ baseText, isActive, isError = false, animationFrame }: AnimatedStatusTextProps) {
47
+ const localFrame = useLocalBusyStatusFrame(isActive, baseText);
48
+ renderDebug.useRenderDebug("Status", {
49
+ baseText,
50
+ isActive,
51
+ isError,
52
+ animationFrame: animationFrame ?? localFrame,
53
+ });
54
+ renderDebug.useLifecycleDebug("Status", {
55
+ baseText,
56
+ isActive,
57
+ isError,
58
+ });
59
+
60
+ const theme = useTheme();
61
+ const renderedText = sanitizeTerminalOutput(baseText);
62
+ const suffix = isActive ? animationFrame ?? localFrame : "";
63
+
64
+ return (
65
+ <Text color={isError ? theme.ERROR : theme.INFO} wrap="truncate">
66
+ {renderedText}{suffix}
67
+ </Text>
68
+ );
69
+ }