@koriit/opencode-claude-bridge 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koriit/opencode-claude-bridge",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "An OpenCode plugin that bridges enabled Claude Code plugins (commands, agents, skills, MCP, LSP) into OpenCode at runtime, namespaced so they never shadow your existing items.",
   "type": "module",
   "license": "MIT",

package/src/inject.ts

@@ -202,6 +202,209 @@ function modelIfMappable(model: unknown): string | undefined {
   return model.includes("/") ? model : undefined
 }
 
+// ── Agent color sanitization ──────────────────────────────────────────────────
+
+/**
+ * OpenCode's agent `color` field accepts exactly two forms (from ConfigAgentV1.Info):
+ *   1. A hex string matching `^#[0-9a-fA-F]{6}$`
+ *   2. One of the 7 semantic enum values: primary | secondary | accent | success | warning | error | info
+ *
+ * Claude Code agents use free-form CSS color names (e.g. "magenta", "cyan"). Writing these
+ * raw into cfg.agent causes OpenCode's schema validation to throw at config.get — outside
+ * our try/catch — crashing the entire instance.
+ *
+ * This regex matches form 1.
+ */
+const OPENCODE_HEX_COLOR_RE = /^#[0-9a-fA-F]{6}$/
+
+/**
+ * The 7 semantic color tokens OpenCode accepts as an alternative to a hex code.
+ */
+const OPENCODE_COLOR_ENUMS = new Set(["primary", "secondary", "accent", "success", "warning", "error", "info"])
+
+/**
+ * Mapping from CSS named colors to their `#rrggbb` equivalents.
+ * This covers the named colors Claude Code agents realistically use in frontmatter.
+ * Standard CSS named-color hex values (per the CSS Color Level 4 spec).
+ */
+const CSS_COLOR_TO_HEX: Record<string, string> = {
+  // Common single-word CSS colors used in Claude agent frontmatter
+  aliceblue: "#f0f8ff",
+  antiquewhite: "#faebd7",
+  aqua: "#00ffff",
+  aquamarine: "#7fffd4",
+  azure: "#f0ffff",
+  beige: "#f5f5dc",
+  bisque: "#ffe4c4",
+  black: "#000000",
+  blanchedalmond: "#ffebcd",
+  blue: "#0000ff",
+  blueviolet: "#8a2be2",
+  brown: "#a52a2a",
+  burlywood: "#deb887",
+  cadetblue: "#5f9ea0",
+  chartreuse: "#7fff00",
+  chocolate: "#d2691e",
+  coral: "#ff7f50",
+  cornflowerblue: "#6495ed",
+  cornsilk: "#fff8dc",
+  crimson: "#dc143c",
+  cyan: "#00ffff",
+  darkblue: "#00008b",
+  darkcyan: "#008b8b",
+  darkgoldenrod: "#b8860b",
+  darkgray: "#a9a9a9",
+  darkgreen: "#006400",
+  darkgrey: "#a9a9a9",
+  darkkhaki: "#bdb76b",
+  darkmagenta: "#8b008b",
+  darkolivegreen: "#556b2f",
+  darkorange: "#ff8c00",
+  darkorchid: "#9932cc",
+  darkred: "#8b0000",
+  darksalmon: "#e9967a",
+  darkseagreen: "#8fbc8f",
+  darkslateblue: "#483d8b",
+  darkslategray: "#2f4f4f",
+  darkslategrey: "#2f4f4f",
+  darkturquoise: "#00ced1",
+  darkviolet: "#9400d3",
+  deeppink: "#ff1493",
+  deepskyblue: "#00bfff",
+  dimgray: "#696969",
+  dimgrey: "#696969",
+  dodgerblue: "#1e90ff",
+  firebrick: "#b22222",
+  floralwhite: "#fffaf0",
+  forestgreen: "#228b22",
+  fuchsia: "#ff00ff",
+  gainsboro: "#dcdcdc",
+  ghostwhite: "#f8f8ff",
+  gold: "#ffd700",
+  goldenrod: "#daa520",
+  gray: "#808080",
+  green: "#008000",
+  greenyellow: "#adff2f",
+  grey: "#808080",
+  honeydew: "#f0fff0",
+  hotpink: "#ff69b4",
+  indianred: "#cd5c5c",
+  indigo: "#4b0082",
+  ivory: "#fffff0",
+  khaki: "#f0e68c",
+  lavender: "#e6e6fa",
+  lavenderblush: "#fff0f5",
+  lawngreen: "#7cfc00",
+  lemonchiffon: "#fffacd",
+  lightblue: "#add8e6",
+  lightcoral: "#f08080",
+  lightcyan: "#e0ffff",
+  lightgoldenrodyellow: "#fafad2",
+  lightgray: "#d3d3d3",
+  lightgreen: "#90ee90",
+  lightgrey: "#d3d3d3",
+  lightpink: "#ffb6c1",
+  lightsalmon: "#ffa07a",
+  lightseagreen: "#20b2aa",
+  lightskyblue: "#87cefa",
+  lightslategray: "#778899",
+  lightslategrey: "#778899",
+  lightsteelblue: "#b0c4de",
+  lightyellow: "#ffffe0",
+  lime: "#00ff00",
+  limegreen: "#32cd32",
+  linen: "#faf0e6",
+  magenta: "#ff00ff",
+  maroon: "#800000",
+  mediumaquamarine: "#66cdaa",
+  mediumblue: "#0000cd",
+  mediumorchid: "#ba55d3",
+  mediumpurple: "#9370db",
+  mediumseagreen: "#3cb371",
+  mediumslateblue: "#7b68ee",
+  mediumspringgreen: "#00fa9a",
+  mediumturquoise: "#48d1cc",
+  mediumvioletred: "#c71585",
+  midnightblue: "#191970",
+  mintcream: "#f5fffa",
+  mistyrose: "#ffe4e1",
+  moccasin: "#ffe4b5",
+  navajowhite: "#ffdead",
+  navy: "#000080",
+  oldlace: "#fdf5e6",
+  olive: "#808000",
+  olivedrab: "#6b8e23",
+  orange: "#ffa500",
+  orangered: "#ff4500",
+  orchid: "#da70d6",
+  palegoldenrod: "#eee8aa",
+  palegreen: "#98fb98",
+  paleturquoise: "#afeeee",
+  palevioletred: "#db7093",
+  papayawhip: "#ffefd5",
+  peachpuff: "#ffdab9",
+  peru: "#cd853f",
+  pink: "#ffc0cb",
+  plum: "#dda0dd",
+  powderblue: "#b0e0e6",
+  purple: "#800080",
+  rebeccapurple: "#663399",
+  red: "#ff0000",
+  rosybrown: "#bc8f8f",
+  royalblue: "#4169e1",
+  saddlebrown: "#8b4513",
+  salmon: "#fa8072",
+  sandybrown: "#f4a460",
+  seagreen: "#2e8b57",
+  seashell: "#fff5ee",
+  sienna: "#a0522d",
+  silver: "#c0c0c0",
+  skyblue: "#87ceeb",
+  slateblue: "#6a5acd",
+  slategray: "#708090",
+  slategrey: "#708090",
+  snow: "#fffafa",
+  springgreen: "#00ff7f",
+  steelblue: "#4682b4",
+  tan: "#d2b48c",
+  teal: "#008080",
+  thistle: "#d8bfd8",
+  tomato: "#ff6347",
+  turquoise: "#40e0d0",
+  violet: "#ee82ee",
+  wheat: "#f5deb3",
+  white: "#ffffff",
+  whitesmoke: "#f5f5f5",
+  yellow: "#ffff00",
+  yellowgreen: "#9acd32",
+}
+
+/**
+ * Sanitize an agent `color` value for injection into OpenCode's config.
+ *
+ * Returns the sanitized string if it can be mapped to a valid OpenCode color,
+ * or `null` if the value is unrecognizable and must be dropped. Never returns
+ * a value that would fail OpenCode's `^#[0-9a-fA-F]{6}$` / enum check.
+ *
+ * Decision table:
+ *   - Already a valid hex `#rrggbb`                  → pass through as-is
+ *   - Already one of the 7 OpenCode enum tokens       → pass through as-is
+ *   - A known CSS named color (case-insensitive)      → map to hex
+ *   - Anything else                                   → null (caller drops + warns)
+ */
+export function sanitizeAgentColor(value: string): string | null {
+  // Fast-path: already valid.
+  if (OPENCODE_HEX_COLOR_RE.test(value)) return value
+  if (OPENCODE_COLOR_ENUMS.has(value)) return value
+
+  // Try CSS named color (case-insensitive lookup).
+  const hex = CSS_COLOR_TO_HEX[value.toLowerCase()]
+  if (hex !== undefined) return hex
+
+  // Unknown — must be dropped to avoid an OpenCode schema error.
+  return null
+}
+
 // ── Command injection for one plugin ─────────────────────────────────────────
 
 /**
@@ -411,10 +614,12 @@ async function injectPluginAgents(
     if (typeof variant === "string") entry.variant = variant
 
     const temperature = data["temperature"]
-    if (typeof temperature === "number") entry.temperature = temperature
+    // OpenCode uses Schema.Finite which rejects NaN, Infinity, and -Infinity.
+    if (typeof temperature === "number" && isFinite(temperature)) entry.temperature = temperature
 
     const top_p = data["top_p"]
-    if (typeof top_p === "number") entry.top_p = top_p
+    // Same finite constraint as temperature.
+    if (typeof top_p === "number" && isFinite(top_p)) entry.top_p = top_p
 
     const steps = data["steps"]
     if (typeof steps === "number" && Number.isInteger(steps) && steps > 0) entry.steps = steps
@@ -422,8 +627,18 @@ async function injectPluginAgents(
     const hidden = data["hidden"]
     if (typeof hidden === "boolean") entry.hidden = hidden
 
-    const color = data["color"]
-    if (typeof color === "string") entry.color = color
+    const colorRaw = data["color"]
+    if (typeof colorRaw === "string") {
+      const color = sanitizeAgentColor(colorRaw)
+      if (color !== null) {
+        entry.color = color
+      } else {
+        logger.warn(
+          `agent "${bareName}" from plugin "${plugin.id}" has unrecognized color value "${colorRaw}"; dropping color field`,
+          { fatalInStrict: false },
+        )
+      }
+    }
 
     cfg.agent[name] = entry
     summary.agents++

package/src/mcp-inject.ts

@@ -178,7 +178,15 @@ export function mapClaudeMcpServer(
         if (typeof server.oauth.clientId === "string") oauth.clientId = server.oauth.clientId
         if (typeof server.oauth.clientSecret === "string") oauth.clientSecret = server.oauth.clientSecret
         if (typeof server.oauth.scope === "string") oauth.scope = server.oauth.scope
-        if (typeof server.oauth.callbackPort === "number") oauth.callbackPort = server.oauth.callbackPort
+        // OpenCode enforces callbackPort as an integer in [1, 65535] (Schema.isBetween).
+        if (
+          typeof server.oauth.callbackPort === "number" &&
+          Number.isInteger(server.oauth.callbackPort) &&
+          server.oauth.callbackPort >= 1 &&
+          server.oauth.callbackPort <= 65535
+        ) {
+          oauth.callbackPort = server.oauth.callbackPort
+        }
         if (typeof server.oauth.redirectUri === "string") oauth.redirectUri = server.oauth.redirectUri
         entry.oauth = oauth
       }