@f5-sales-demo/xcsh 19.51.2

package/src/modes/theme/theme-schema.json

@@ -0,0 +1,553 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"title": "OMP Coding Agent Theme",
+	"description": "Theme schema for the OMP coding agent",
+	"type": "object",
+	"required": ["name", "colors"],
+	"properties": {
+		"$schema": {
+			"type": "string",
+			"description": "JSON schema reference"
+		},
+		"name": {
+			"type": "string",
+			"description": "Theme name"
+		},
+		"vars": {
+			"type": "object",
+			"description": "Reusable color variables",
+			"additionalProperties": {
+				"oneOf": [
+					{
+						"type": "string",
+						"description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
+					},
+					{
+						"type": "integer",
+						"minimum": 0,
+						"maximum": 255,
+						"description": "256-color palette index (0-255)"
+					}
+				]
+			}
+		},
+		"colors": {
+			"type": "object",
+			"description": "Theme color definitions (all required)",
+			"required": [
+				"accent",
+				"border",
+				"borderAccent",
+				"borderMuted",
+				"success",
+				"error",
+				"warning",
+				"muted",
+				"dim",
+				"text",
+				"thinkingText",
+				"selectedBg",
+				"userMessageBg",
+				"userMessageText",
+				"customMessageBg",
+				"customMessageText",
+				"customMessageLabel",
+				"toolPendingBg",
+				"toolSuccessBg",
+				"toolErrorBg",
+				"toolTitle",
+				"toolOutput",
+				"mdHeading",
+				"mdLink",
+				"mdLinkUrl",
+				"mdCode",
+				"mdCodeBlock",
+				"mdCodeBlockBorder",
+				"mdQuote",
+				"mdQuoteBorder",
+				"mdHr",
+				"mdListBullet",
+				"toolDiffAdded",
+				"toolDiffRemoved",
+				"toolDiffContext",
+				"syntaxComment",
+				"syntaxKeyword",
+				"syntaxFunction",
+				"syntaxVariable",
+				"syntaxString",
+				"syntaxNumber",
+				"syntaxType",
+				"syntaxOperator",
+				"syntaxPunctuation",
+				"syntaxControl",
+				"thinkingOff",
+				"thinkingMinimal",
+				"thinkingLow",
+				"thinkingMedium",
+				"thinkingHigh",
+				"thinkingXhigh",
+				"bashMode",
+				"pythonMode",
+				"statusLineBg",
+				"statusLineSep",
+				"statusLineModel",
+				"statusLinePath",
+				"statusLineGitClean",
+				"statusLineGitDirty",
+				"statusLineContext",
+				"statusLineSpend",
+				"statusLineStaged",
+				"statusLineDirty",
+				"statusLineUntracked",
+				"statusLineOutput",
+				"statusLineCost",
+				"statusLineSubagents",
+				"chromeAccent",
+				"spinnerAccent",
+				"contentAccent",
+				"gutterSuccess",
+				"gutterWarning",
+				"statusLineOsIconBg",
+				"statusLineOsIconFg",
+				"statusLinePathBg",
+				"statusLinePathFg",
+				"statusLineGitCleanBg",
+				"statusLineGitCleanFg",
+				"statusLineGitDirtyBg",
+				"statusLineGitDirtyFg",
+				"statusLineGitStagedBg",
+				"statusLineGitStagedFg",
+				"statusLineGitUntrackedBg",
+				"statusLineGitUntrackedFg",
+				"statusLineGitConflictBg",
+				"statusLineGitConflictFg",
+				"statusLinePlanModeBg",
+				"statusLinePlanModeFg",
+				"statusLineContextXcshBg",
+				"statusLineContextXcshFg"
+			],
+			"properties": {
+				"accent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Primary accent color (logo, selected items, cursor)"
+				},
+				"border": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Normal borders"
+				},
+				"borderAccent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Highlighted borders"
+				},
+				"borderMuted": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Subtle borders"
+				},
+				"success": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Success states"
+				},
+				"error": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Error states"
+				},
+				"gutterSuccess": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Optional: done-state tool/command gutter dot color for successful outcomes. Falls back to `success` when omitted."
+				},
+				"gutterError": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Optional: done-state tool/command gutter dot color for failed outcomes. Falls back to `error` when omitted."
+				},
+				"warning": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Warning states"
+				},
+				"muted": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Secondary/dimmed text"
+				},
+				"dim": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Very dimmed text (more subtle than muted)"
+				},
+				"text": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Default text color (usually empty string)"
+				},
+				"thinkingText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking text color"
+				},
+				"selectedBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Selected background (list highlight)"
+				},
+				"userMessageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "User message background"
+				},
+				"userMessageText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "User message text color"
+				},
+				"customMessageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message background (hook-injected messages)"
+				},
+				"customMessageText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message text color"
+				},
+				"customMessageLabel": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message type label color"
+				},
+				"toolPendingBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (pending state)"
+				},
+				"toolSuccessBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (success state)"
+				},
+				"toolErrorBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (error state)"
+				},
+				"toolTitle": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool title text"
+				},
+				"toolOutput": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool output text"
+				},
+				"mdHeading": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown heading text"
+				},
+				"mdLink": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown link text"
+				},
+				"mdLinkUrl": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown link URL text"
+				},
+				"mdCode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown inline code"
+				},
+				"mdCodeBlock": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown code block content"
+				},
+				"mdCodeBlockBorder": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown code block fences"
+				},
+				"mdQuote": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown blockquote text"
+				},
+				"mdQuoteBorder": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown blockquote border"
+				},
+				"mdHr": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown horizontal rule"
+				},
+				"mdListBullet": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown list bullets/numbers"
+				},
+				"toolDiffAdded": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Added lines in tool diffs"
+				},
+				"toolDiffRemoved": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Removed lines in tool diffs"
+				},
+				"toolDiffContext": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Context lines in tool diffs"
+				},
+				"syntaxComment": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: comments"
+				},
+				"syntaxKeyword": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: keywords"
+				},
+				"syntaxFunction": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: function names"
+				},
+				"syntaxVariable": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: variable names"
+				},
+				"syntaxString": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: string literals"
+				},
+				"syntaxNumber": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: number literals"
+				},
+				"syntaxType": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: type names"
+				},
+				"syntaxOperator": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: operators"
+				},
+				"syntaxPunctuation": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: punctuation"
+				},
+				"syntaxControl": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: control flow keywords (if, else, for, while, return, import)"
+				},
+				"thinkingOff": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: off"
+				},
+				"thinkingMinimal": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: minimal"
+				},
+				"thinkingLow": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: low"
+				},
+				"thinkingMedium": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: medium"
+				},
+				"thinkingHigh": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: high"
+				},
+				"thinkingXhigh": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: xhigh (OpenAI codex-max only)"
+				},
+				"bashMode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Editor border color in bash mode"
+				},
+				"pythonMode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Editor border color in python mode"
+				},
+				"statusLineBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line background"
+				},
+				"statusLineSep": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line separator color"
+				},
+				"statusLineModel": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line model segment"
+				},
+				"statusLinePath": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line path text color (hex). Used for non-powerline rendering. See 'statusLinePathBg'/'Fg' for the corresponding powerline palette indices."
+				},
+				"statusLineGitClean": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line git clean text color (hex). Used for non-powerline rendering. See 'statusLineGitCleanBg'/'Fg' for the corresponding powerline palette indices."
+				},
+				"statusLineGitDirty": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line git dirty text color (hex). Used for non-powerline rendering. See 'statusLineGitDirtyBg'/'Fg' for the corresponding powerline palette indices."
+				},
+				"statusLineContext": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line context segment"
+				},
+				"statusLineSpend": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line spend segment"
+				},
+				"statusLineStaged": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line git staged count text color (hex). Used for non-powerline rendering. See 'statusLineGitStagedBg'/'Fg' for the corresponding powerline palette indices."
+				},
+				"statusLineDirty": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line git dirty count text color (hex). Used for non-powerline rendering. See 'statusLineGitDirtyBg'/'Fg' for the corresponding powerline palette indices."
+				},
+				"statusLineUntracked": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line git untracked text color (hex). Used for non-powerline rendering. See 'statusLineGitUntrackedBg'/'Fg' for the corresponding powerline palette indices."
+				},
+				"statusLineOutput": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line output segment"
+				},
+				"statusLineCost": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line cost segment"
+				},
+				"statusLineSubagents": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Status line subagents segment"
+				},
+				"chromeAccent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Chrome / UI accent color (non-content accent). Defaults to `accent` when omitted — but in this project it is always overridden per theme."
+				},
+				"spinnerAccent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Spinner accent color. Defaults to `accent` when omitted — but in this project it is always overridden per theme."
+				},
+				"contentAccent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Content accent color (distinct from UI chrome). Defaults to `accent` when omitted — but in this project it is always overridden per theme."
+				},
+				"gutterWarning": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Done-state tool/command gutter dot color for warning outcomes. Defaults to `warning` when omitted — but in this project it is always overridden per theme."
+				},
+				"statusLineOsIconBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline OS icon segment background. Independent from hex-based text colors used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLineOsIconFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline OS icon segment foreground. Independent from hex-based text colors used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLinePathBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline path segment background. Independent from the hex-based `statusLinePath` text color used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLinePathFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline path segment foreground. Independent from the hex-based `statusLinePath` text color used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitCleanBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-clean segment background. Independent from the hex-based `statusLineGitClean` text color used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitCleanFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-clean segment foreground. Independent from the hex-based `statusLineGitClean` text color used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitDirtyBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-dirty (unstaged) segment background. Independent from the hex-based `statusLineGitDirty` text color used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitDirtyFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-dirty (unstaged) segment foreground. Independent from the hex-based `statusLineGitDirty` text color used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitStagedBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-staged-only segment background. Rendered when the repo has staged changes but no unstaged or conflicted changes. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitStagedFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-staged-only segment foreground. Rendered when the repo has staged changes but no unstaged or conflicted changes. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitUntrackedBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-untracked-only segment background. Independent from the hex-based `statusLineUntracked` text color used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitUntrackedFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-untracked-only segment foreground. Independent from the hex-based `statusLineUntracked` text color used for non-powerline rendering. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitConflictBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-conflict segment background. See issue #242 for the two-domain color model."
+				},
+				"statusLineGitConflictFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline git-conflict segment foreground. See issue #242 for the two-domain color model."
+				},
+				"statusLinePlanModeBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline plan-mode segment background. See issue #242 for the two-domain color model."
+				},
+				"statusLinePlanModeFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline plan-mode segment foreground. See issue #242 for the two-domain color model."
+				},
+				"statusLineContextXcshBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index OR color reference for the powerline F5 XC context segment background. Stays F5 brand red across light and dark themes. See issue #242 for the two-domain color model."
+				},
+				"statusLineContextXcshFg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "256-color palette index for the powerline F5 XC context segment foreground. See issue #242 for the two-domain color model."
+				}
+			},
+			"additionalProperties": false
+		},
+		"export": {
+			"type": "object",
+			"description": "Optional colors for HTML export (defaults derived from userMessageBg if not specified)",
+			"properties": {
+				"pageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Page background color"
+				},
+				"cardBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Card/container background color"
+				},
+				"infoBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Info sections background (system prompt, notices)"
+				}
+			},
+			"additionalProperties": false
+		},
+		"symbols": {
+			"type": "object",
+			"description": "Symbol configuration for UI glyphs and icons",
+			"properties": {
+				"preset": {
+					"type": "string",
+					"enum": ["unicode", "nerd", "ascii"],
+					"description": "Default symbol preset for this theme (can be overridden by user setting)"
+				},
+				"overrides": {
+					"type": "object",
+					"description": "Override individual symbol keys (e.g., 'status.success': '✔')",
+					"additionalProperties": {
+						"type": "string"
+					}
+				}
+			},
+			"additionalProperties": false
+		}
+	},
+	"additionalProperties": false,
+	"$defs": {
+		"colorValue": {
+			"oneOf": [
+				{
+					"type": "string",
+					"description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
+				},
+				{
+					"type": "integer",
+					"minimum": 0,
+					"maximum": 255,
+					"description": "256-color palette index (0-255)"
+				}
+			]
+		}
+	}
+}