codex-configurator 0.2.6 → 0.2.7

package/README.md

@@ -39,7 +39,7 @@ npm start
 - `↑` `↓` : move selection
 - `PgUp` `PgDn`: move one page up/down
 - `Home` `End`: jump to first/last item
-- `Enter`: open selected table; for mixed scalar/object settings, choose a preset first (object presets open nested settings); for boolean settings, toggle directly; for string settings, open inline input; for other preset values, open picker
+- `Enter`: open selected table; for mixed scalar/object settings, choose a preset first (object presets open nested settings); for boolean settings, toggle directly; for string and numeric scalar settings, open inline input; for other preset values, open picker
 - `Del`: unset selected value or remove selected custom `<id>` entry from `config.toml`
 - `←` / `Backspace`: move up one level (to parent table)
 - `:`: enter command mode
@@ -49,7 +49,7 @@ npm start
 - `:help`: toggle quick help overlay
 - `:quit` (or `:q`): quit
 
-The right-hand pane shows what each setting means, plus a picker when a value has preset options.
+The right-hand pane shows what each setting means, the current configured value for plain scalar settings, and a picker when a value has preset options.
 Deprecated settings are marked with a `[!]` warning marker; only that marker is highlighted.
 Model picker entries are curated presets maintained by this project.
 In select lists, `[default]` marks the default option.

package/index.js

@@ -20,11 +20,13 @@ import {
 	writeConfig,
 } from './src/configParser.js';
 import { getConfigOptions, getConfigVariantMeta } from './src/configHelp.js';
-import {
-	getReferenceOptionForPath,
-	getReferenceCustomIdPlaceholder,
-} from './src/configReference.js';
+import { getReferenceCustomIdPlaceholder } from './src/configReference.js';
 import { normalizeCustomPathId } from './src/customPathId.js';
+import {
+	getReferenceScalarType,
+	getScalarEditType,
+	parseScalarDraftValue,
+} from './src/scalarEditing.js';
 import {
 	applyVariantSelection,
 	buildVariantSelectorOptions,
@@ -54,17 +56,6 @@ import { StatusLine } from './src/ui/panes/StatusLine.js';
 const require = createRequire(import.meta.url);
 const { version: PACKAGE_VERSION = 'unknown' } = require('./package.json');
 
-const isStringReferenceType = (type) =>
-	/^string(?:\s|$)/.test(String(type || '').trim());
-
-const isStringField = (pathSegments, value) => {
-	if (typeof value === 'string') {
-		return true;
-	}
-
-	return isStringReferenceType(getReferenceOptionForPath(pathSegments)?.type);
-};
-
 const isCustomIdTableRow = (pathSegments, row) =>
 	row?.kind === 'table' &&
 	typeof row?.pathSegment === 'string' &&
@@ -889,13 +880,14 @@ const App = () => {
 		});
 	};
 
-	const beginTextEditing = (target, targetPath) => {
+	const beginScalarEditing = (target, targetPath, scalarType) => {
 		setEditError('');
 		setEditMode({
-			mode: 'text',
+			mode: 'scalar',
+			scalarType,
 			path: targetPath,
-			draftValue: typeof target.value === 'string' ? target.value : '',
-			savedValue: null,
+			draftValue:
+				typeof target.value === 'undefined' ? '' : String(target.value),
 		});
 	};
 
@@ -1028,15 +1020,24 @@ const App = () => {
 		setEditError('');
 	};
 
-	const applyTextEdit = () => {
-		if (!editMode || editMode.mode !== 'text') {
+	const applyScalarEdit = () => {
+		if (!editMode || editMode.mode !== 'scalar') {
+			return;
+		}
+
+		const parsedValue = parseScalarDraftValue(
+			editMode.draftValue,
+			editMode.scalarType,
+		);
+		if (!parsedValue.ok) {
+			setEditError(parsedValue.error);
 			return;
 		}
 
 		const nextData = setValueAtPath(
 			snapshot.ok ? snapshot.data : {},
 			editMode.path,
-			editMode.draftValue,
+			parsedValue.value,
 		);
 		if (!ensureAgentConfigFile(nextData, editMode.path)) {
 			return;
@@ -1129,17 +1130,13 @@ const App = () => {
 						undefined,
 						'value',
 					) || [];
-				if (requiredOptions.length > 0) {
-					return requiredOptions[0];
-				}
+					if (requiredOptions.length > 0) {
+						return requiredOptions[0];
+					}
 
-				if (
-					isStringReferenceType(
-						getReferenceOptionForPath(requiredPath)?.type,
-					)
-				) {
-					return '';
-				}
+					if (getReferenceScalarType(requiredPath) === 'string') {
+						return '';
+					}
 
 				return {};
 			},
@@ -1340,28 +1337,28 @@ const App = () => {
 					setCommandInput,
 					getCommandInput: () => commandInputRef.current,
 					setCommandMessage,
-					setEditError,
-					beginAddIdEditing,
-					beginTextEditing,
-					beginVariantEditing,
-					beginEditing,
-					beginFileSwitchMode,
-					applyFileSwitch,
-					applyTextEdit,
-					applyAddId,
-					applyVariantEdit,
-					applyEdit,
+						setEditError,
+						beginAddIdEditing,
+						beginScalarEditing,
+						beginVariantEditing,
+						beginEditing,
+						beginFileSwitchMode,
+						applyFileSwitch,
+						applyScalarEdit,
+						applyAddId,
+						applyVariantEdit,
+						applyEdit,
 					applyBooleanToggle,
 					unsetValueAtPath,
 					openPathView,
 					reloadActiveConfig,
 					getConfigOptions: getConfigOptions,
-					getConfigVariantMeta,
-					getNodeAtPath,
-					buildRows,
-					isStringField,
-					isCustomIdTableRow,
-					resolveMixedVariantBackNavigationPath,
+						getConfigVariantMeta,
+						getNodeAtPath,
+						buildRows,
+						getScalarEditType,
+						isCustomIdTableRow,
+						resolveMixedVariantBackNavigationPath,
 					adjustScrollForSelection,
 					getSavedIndex,
 					readActiveConfigSnapshot,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "codex-configurator",
-	"version": "0.2.6",
+	"version": "0.2.7",
 	"description": "TOML-aware Ink TUI for Codex Configurator",
 	"main": "index.js",
 	"type": "module",

package/src/components/ConfigNavigator.js

@@ -10,6 +10,7 @@ import {
 import { computePaneWidths, clamp } from '../layout.js';
 import { getNodeAtPath, buildRows } from '../configParser.js';
 import { filterRowsByQuery } from '../fuzzySearch.js';
+import { getReadOnlyValuePreviewText } from '../valuePreview.js';
 import {
 	buildVariantSelectorOptions,
 	isObjectValue,
@@ -112,7 +113,7 @@ const renderArrayDetails = (rows) => {
 	);
 };
 
-const renderTextEditor = (draftValue) =>
+const renderScalarEditor = (draftValue, scalarType) =>
 	React.createElement(
 		React.Fragment,
 		null,
@@ -124,7 +125,13 @@ const renderTextEditor = (draftValue) =>
 		React.createElement(
 			Text,
 			{ color: 'gray', wrap: 'truncate-end' },
-			'Type to edit • Enter: save • Esc: cancel',
+			`Type ${
+				scalarType === 'string'
+					? 'text'
+					: scalarType === 'integer'
+						? 'integer'
+						: 'number'
+			} • Enter: save • Esc: cancel`,
 		),
 	);
 
@@ -416,6 +423,10 @@ export const ConfigNavigator = ({
 	);
 	const shouldShowReadOnlyOptions =
 		readOnlyOptions.length > 0 && !isBooleanOnlyOptions(readOnlyOptions);
+	const readOnlyValuePreviewText = getReadOnlyValuePreviewText(
+		selectedRow,
+		shouldShowReadOnlyOptions,
+	);
 
 	const editRow = rows[selected] || null;
 	const editDefaultOption =
@@ -471,8 +482,8 @@ export const ConfigNavigator = ({
 			)
 		: null;
 	const optionSelector = editMode
-		? editMode.mode === 'text'
-			? renderTextEditor(editMode.draftValue)
+		? editMode.mode === 'scalar'
+			? renderScalarEditor(editMode.draftValue, editMode.scalarType)
 			: editMode.mode === 'add-id'
 				? renderIdEditor(editMode.placeholder, editMode.draftValue)
 				: renderEditableOptions(
@@ -497,6 +508,17 @@ export const ConfigNavigator = ({
 						false,
 					),
 				)
+			: readOnlyValuePreviewText
+				? React.createElement(
+						React.Fragment,
+						null,
+						React.createElement(Text, { color: 'gray' }, ' '),
+						React.createElement(
+							Text,
+							{ color: 'white', wrap: 'truncate-end' },
+							readOnlyValuePreviewText,
+						),
+					)
 			: selectedRow?.kind === 'array'
 				? renderArrayDetails(selectedRow.value)
 				: null;

package/src/constants.js

@@ -3,7 +3,7 @@ export const CONTROL_HINT =
 export const FILE_SWITCH_HINT =
 	'↑/↓ choose • PgUp/PgDn page • Home/End jump • Enter switch file • Esc/Backspace/← cancel';
 export const EDIT_CONTROL_HINT =
-	'↑/↓ choose • PgUp/PgDn page • Home/End jump • Enter save • Esc/Backspace/← cancel • Del delete char (text input)';
+	'↑/↓ choose • PgUp/PgDn page • Home/End jump • Enter save • Esc/Backspace/← cancel • Del delete char (inline input)';
 export const FILTER_CONTROL_HINT =
 	'Type filter • Enter/Esc: done • Del/Backspace: delete • Ctrl+U: clear';
 export const COMMAND_HINT = 'Type : to see commands';

package/src/reference/config-schema.json

@@ -20,6 +20,13 @@
         "description": {
           "description": "Human-facing role documentation used in spawn tool guidance.",
           "type": "string"
+        },
+        "nickname_candidates": {
+          "description": "Candidate nicknames for agents spawned with this role.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
         }
       },
       "type": "object"
@@ -313,6 +320,9 @@
             "apps_mcp_gateway": {
               "type": "boolean"
             },
+            "artifact": {
+              "type": "boolean"
+            },
             "child_agents_md": {
               "type": "boolean"
             },
@@ -349,6 +359,15 @@
             "experimental_windows_sandbox": {
               "type": "boolean"
             },
+            "fast_mode": {
+              "type": "boolean"
+            },
+            "image_detail_original": {
+              "type": "boolean"
+            },
+            "image_generation": {
+              "type": "boolean"
+            },
             "include_apply_patch_tool": {
               "type": "boolean"
             },
@@ -370,6 +389,9 @@
             "personality": {
               "type": "boolean"
             },
+            "plugins": {
+              "type": "boolean"
+            },
             "powershell_utf8": {
               "type": "boolean"
             },
@@ -502,6 +524,9 @@
         "sandbox_mode": {
           "$ref": "#/definitions/SandboxMode"
         },
+        "service_tier": {
+          "$ref": "#/definitions/ServiceTier"
+        },
         "tools_view_image": {
           "type": "boolean"
         },
@@ -613,7 +638,19 @@
       "additionalProperties": false,
       "description": "Memories settings loaded from config.toml.",
       "properties": {
-        "max_raw_memories_for_global": {
+        "consolidation_model": {
+          "description": "Model used for memory consolidation.",
+          "type": "string"
+        },
+        "extract_model": {
+          "description": "Model used for thread summarisation.",
+          "type": "string"
+        },
+        "generate_memories": {
+          "description": "When `false`, newly created threads are stored with `memory_mode = \"disabled\"` in the state DB.",
+          "type": "boolean"
+        },
+        "max_raw_memories_for_consolidation": {
           "description": "Maximum number of recent raw memories retained for global consolidation.",
           "format": "uint",
           "minimum": 0,
@@ -640,17 +677,25 @@
           "format": "int64",
           "type": "integer"
         },
-        "phase_1_model": {
-          "description": "Model used for thread summarisation.",
-          "type": "string"
+        "no_memories_if_mcp_or_web_search": {
+          "description": "When `true`, web searches and MCP tool calls mark the thread `memory_mode` as `\"polluted\"`.",
+          "type": "boolean"
         },
-        "phase_2_model": {
-          "description": "Model used for memory consolidation.",
-          "type": "string"
+        "use_memories": {
+          "description": "When `false`, skip injecting memory usage instructions into developer prompts.",
+          "type": "boolean"
         }
       },
       "type": "object"
     },
+    "ModelAvailabilityNuxConfig": {
+      "additionalProperties": {
+        "format": "uint32",
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": "object"
+    },
     "ModelProviderInfo": {
       "additionalProperties": false,
       "description": "Serializable representation of a provider definition.",
@@ -1069,6 +1114,16 @@
       ],
       "type": "string"
     },
+    "PluginConfig": {
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "default": true,
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
     "ProjectConfig": {
       "additionalProperties": false,
       "properties": {
@@ -1146,6 +1201,10 @@
           },
           "type": "object"
         },
+        "oauth_resource": {
+          "default": null,
+          "type": "string"
+        },
         "required": {
           "default": null,
           "type": "boolean"
@@ -1179,6 +1238,18 @@
       },
       "type": "object"
     },
+    "RealtimeAudioToml": {
+      "additionalProperties": false,
+      "properties": {
+        "microphone": {
+          "type": "string"
+        },
+        "speaker": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "ReasoningEffort": {
       "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
       "enum": [
@@ -1266,6 +1337,13 @@
       },
       "type": "object"
     },
+    "ServiceTier": {
+      "enum": [
+        "fast",
+        "flex"
+      ],
+      "type": "string"
+    },
     "ShellEnvironmentPolicyInherit": {
       "oneOf": [
         {
@@ -1396,6 +1474,15 @@
           "description": "Enable animations (welcome screen, shimmer effects, spinners). Defaults to `true`.",
           "type": "boolean"
         },
+        "model_availability_nux": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/ModelAvailabilityNuxConfig"
+            }
+          ],
+          "default": {},
+          "description": "Startup tooltip availability NUX state persisted by the TUI."
+        },
         "notification_method": {
           "allOf": [
             {
@@ -1540,6 +1627,15 @@
       "default": null,
       "description": "Settings for app-specific controls."
     },
+    "audio": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/RealtimeAudioToml"
+        }
+      ],
+      "default": null,
+      "description": "Machine-local realtime audio device preferences used by realtime voice."
+    },
     "background_terminal_max_timeout": {
       "description": "Maximum poll window for background terminal output (`write_stdin`), in milliseconds. Default: `300000` (5 minutes).",
       "format": "uint64",
@@ -1584,11 +1680,15 @@
       "$ref": "#/definitions/AbsolutePathBuf"
     },
     "experimental_realtime_ws_backend_prompt": {
-      "description": "Experimental / do not use. Overrides only the realtime conversation websocket transport backend prompt (the `Op::RealtimeConversation` `/ws` session.create backend_prompt) without changing normal prompts.",
+      "description": "Experimental / do not use. Overrides only the realtime conversation websocket transport instructions (the `Op::RealtimeConversation` `/ws` session.update instructions) without changing normal prompts.",
       "type": "string"
     },
     "experimental_realtime_ws_base_url": {
-      "description": "Experimental / do not use. Overrides only the realtime conversation websocket transport base URL (the `Op::RealtimeConversation` `/ws` connection) without changing normal provider HTTP requests.",
+      "description": "Experimental / do not use. Overrides only the realtime conversation websocket transport base URL (the `Op::RealtimeConversation` `/v1/realtime` connection) without changing normal provider HTTP requests.",
+      "type": "string"
+    },
+    "experimental_realtime_ws_model": {
+      "description": "Experimental / do not use. Selects the realtime websocket model/snapshot used for the `Op::RealtimeConversation` connection.",
       "type": "string"
     },
     "experimental_use_freeform_apply_patch": {
@@ -1611,6 +1711,9 @@
         "apps_mcp_gateway": {
           "type": "boolean"
         },
+        "artifact": {
+          "type": "boolean"
+        },
         "child_agents_md": {
           "type": "boolean"
         },
@@ -1647,6 +1750,15 @@
         "experimental_windows_sandbox": {
           "type": "boolean"
         },
+        "fast_mode": {
+          "type": "boolean"
+        },
+        "image_detail_original": {
+          "type": "boolean"
+        },
+        "image_generation": {
+          "type": "boolean"
+        },
         "include_apply_patch_tool": {
           "type": "boolean"
         },
@@ -1668,6 +1780,9 @@
         "personality": {
           "type": "boolean"
         },
+        "plugins": {
+          "type": "boolean"
+        },
         "powershell_utf8": {
           "type": "boolean"
         },
@@ -1965,6 +2080,14 @@
     "plan_mode_reasoning_effort": {
       "$ref": "#/definitions/ReasoningEffort"
     },
+    "plugins": {
+      "additionalProperties": {
+        "$ref": "#/definitions/PluginConfig"
+      },
+      "default": {},
+      "description": "User-level plugin config entries keyed by plugin name.",
+      "type": "object"
+    },
     "profile": {
       "description": "Profile to use from the `profiles` map.",
       "type": "string"
@@ -2024,6 +2147,14 @@
       ],
       "description": "Sandbox configuration to apply if `sandbox` is `WorkspaceWrite`."
     },
+    "service_tier": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceTier"
+        }
+      ],
+      "description": "Optional explicit service tier preference for new turns (`fast` or `flex`)."
+    },
     "shell_environment_policy": {
       "allOf": [
         {

package/src/scalarEditing.js

@@ -0,0 +1,117 @@
+import { getReferenceOptionForPath } from './configReference.js';
+
+const STRING_REFERENCE_TYPE_PATTERN = /^string(?:\s|$)/;
+const DIGIT_GROUP_PATTERN = '\\d(?:_?\\d)*';
+const INTEGER_DRAFT_PATTERN = new RegExp(
+	`^[+-]?${DIGIT_GROUP_PATTERN}$`,
+);
+const NUMBER_DRAFT_PATTERN = new RegExp(
+	`^[+-]?(?:(?:${DIGIT_GROUP_PATTERN}(?:\\.(?:${DIGIT_GROUP_PATTERN})?)?)|(?:\\.${DIGIT_GROUP_PATTERN}))(?:[eE][+-]?${DIGIT_GROUP_PATTERN})?$`,
+);
+
+export const getReferenceScalarType = (pathSegments) => {
+	const referenceType = String(
+		getReferenceOptionForPath(pathSegments)?.type || '',
+	).trim();
+
+	if (STRING_REFERENCE_TYPE_PATTERN.test(referenceType)) {
+		return 'string';
+	}
+
+	if (referenceType === 'integer') {
+		return 'integer';
+	}
+
+	if (referenceType === 'number') {
+		return 'number';
+	}
+
+	return null;
+};
+
+export const getScalarEditType = (pathSegments, value) => {
+	const referenceScalarType = getReferenceScalarType(pathSegments);
+	if (referenceScalarType) {
+		return referenceScalarType;
+	}
+
+	if (typeof value === 'string') {
+		return 'string';
+	}
+
+	if (typeof value === 'number') {
+		return Number.isInteger(value) ? 'integer' : 'number';
+	}
+	return null;
+};
+
+export const parseScalarDraftValue = (draftValue, scalarType) => {
+	const nextDraftValue =
+		typeof draftValue === 'string'
+			? draftValue
+			: String(draftValue ?? '');
+
+	if (scalarType === 'string') {
+		return {
+			ok: true,
+			value: nextDraftValue,
+		};
+	}
+
+	const normalized = nextDraftValue.trim();
+	if (!normalized) {
+		return {
+			ok: false,
+			error: 'Value cannot be empty. Use Del to unset it.',
+		};
+	}
+
+	if (scalarType === 'integer') {
+		if (!INTEGER_DRAFT_PATTERN.test(normalized)) {
+			return {
+				ok: false,
+				error: 'Value must be a whole number.',
+			};
+		}
+
+		const parsed = Number(normalized.replaceAll('_', ''));
+		if (!Number.isSafeInteger(parsed)) {
+			return {
+				ok: false,
+				error: 'Value must be a safe integer.',
+			};
+		}
+
+		return {
+			ok: true,
+			value: parsed,
+		};
+	}
+
+	if (scalarType === 'number') {
+		if (!NUMBER_DRAFT_PATTERN.test(normalized)) {
+			return {
+				ok: false,
+				error: 'Value must be a finite decimal number.',
+			};
+		}
+
+		const parsed = Number(normalized.replaceAll('_', ''));
+		if (!Number.isFinite(parsed)) {
+			return {
+				ok: false,
+				error: 'Value must be a finite decimal number.',
+			};
+		}
+
+		return {
+			ok: true,
+			value: parsed,
+		};
+	}
+
+	return {
+		ok: false,
+		error: 'Unsupported scalar type.',
+	};
+};

package/src/ui/commands.js

@@ -15,7 +15,7 @@ import {
 	FILTER_CONTROL_HINT,
 } from '../constants.js';
 
-const isInlineTextMode = (mode) => mode === 'text' || mode === 'add-id';
+const isInlineDraftMode = (mode) => mode === 'scalar' || mode === 'add-id';
 
 const isBooleanOnlyOptions = (options) =>
 	Array.isArray(options) &&
@@ -215,7 +215,7 @@ export const executeInputCommand = ({ input, key, context }) => {
 		configFileCatalog,
 	} = context;
 
-	const isTextEditing = isInlineTextMode(editMode?.mode);
+	const isInlineEditing = isInlineDraftMode(editMode?.mode);
 	const isCapturingCommand = isCommandModeLocked || isCommandMode;
 
 	if (isCapturingCommand) {
@@ -382,10 +382,10 @@ export const executeInputCommand = ({ input, key, context }) => {
 	}
 
 	if (editMode) {
-		if (isTextEditing) {
+		if (isInlineEditing) {
 			if (key.return) {
-				if (editMode.mode === 'text') {
-					context.applyTextEdit();
+				if (editMode.mode === 'scalar') {
+					context.applyScalarEdit();
 					return true;
 				}
 
@@ -669,8 +669,12 @@ export const executeInputCommand = ({ input, key, context }) => {
 			return true;
 		}
 
-		if (context.isStringField(targetPath, target.value)) {
-			context.beginTextEditing(target, targetPath);
+		const scalarType = context.getScalarEditType(
+			targetPath,
+			target.value,
+		);
+		if (scalarType) {
+			context.beginScalarEditing(target, targetPath, scalarType);
 		}
 
 		return true;

package/src/valuePreview.js

@@ -0,0 +1,38 @@
+const isPrimitivePreviewValue = (value) =>
+	value === null ||
+	typeof value === 'string' ||
+	typeof value === 'number' ||
+	typeof value === 'boolean';
+
+export const formatReadOnlyValuePreview = (value) => {
+	if (typeof value === 'string') {
+		return JSON.stringify(value);
+	}
+
+	if (
+		typeof value === 'number' ||
+		typeof value === 'boolean' ||
+		value === null
+	) {
+		return String(value);
+	}
+
+	return String(value);
+};
+
+export const getReadOnlyValuePreviewText = (
+	row,
+	shouldShowReadOnlyOptions = false,
+) => {
+	if (
+		!row ||
+		row.kind !== 'value' ||
+		row.isConfigured !== true ||
+		shouldShowReadOnlyOptions ||
+		!isPrimitivePreviewValue(row.value)
+	) {
+		return null;
+	}
+
+	return `Current: ${formatReadOnlyValuePreview(row.value)}`;
+};