@albinocrabs/o-switcher 0.1.1 → 0.3.0

package/dist/index.js

@@ -1,7 +1,6 @@
-import { createRequestLogger, generateCorrelationId, reloadConfig, inspectRequest, disableTarget, drainTarget, resumeTarget, pauseTarget, listTargets } from './chunk-IKNWSNAS.js';
-export { ADMISSION_RESULTS, BackoffConfigSchema, ConfigValidationError, DEFAULT_ALPHA, DEFAULT_BACKOFF_BASE_MS, DEFAULT_BACKOFF_JITTER, DEFAULT_BACKOFF_MAX_MS, DEFAULT_BACKOFF_MULTIPLIER, DEFAULT_BACKOFF_PARAMS, DEFAULT_FAILOVER_BUDGET, DEFAULT_RETRY, DEFAULT_RETRY_BUDGET, DEFAULT_TIMEOUT_MS, DualBreaker, EXCLUSION_REASONS, ErrorClassSchema, INITIAL_HEALTH_SCORE, REDACT_PATHS, SwitcherConfigSchema, TARGET_STATES, TargetConfigSchema, TargetRegistry, addProfile, applyConfigDiff, checkHardRejects, computeBackoffMs, computeConfigDiff, computeCooldownMs, computeScore, createAdmissionController, createAuditLogger, createAuthWatcher, createCircuitBreaker, createConcurrencyTracker, createCooldownManager, createFailoverOrchestrator, createLogSubscriber, createProfileTools, createRegistry, createRequestLogger, createRequestTraceBuffer, createRetryPolicy, createRoutingEventBus, disableTarget, discoverTargets, discoverTargetsFromProfiles, drainTarget, generateCorrelationId, getExclusionReason, getTargetStateTransition, inspectRequest, isRetryable, listProfiles, listTargets, loadProfiles, nextProfileId, normalizeLatency, pauseTarget, reloadConfig, removeProfile, resumeTarget, saveProfiles, selectTarget, updateHealthScore, updateLatencyEma, validateConfig } from './chunk-IKNWSNAS.js';
+import { createRequestLogger, generateCorrelationId } from './chunk-XXH633FY.js';
+export { ADMISSION_RESULTS, BackoffConfigSchema, ConfigValidationError, DEFAULT_ALPHA, DEFAULT_BACKOFF_BASE_MS, DEFAULT_BACKOFF_JITTER, DEFAULT_BACKOFF_MAX_MS, DEFAULT_BACKOFF_MULTIPLIER, DEFAULT_BACKOFF_PARAMS, DEFAULT_FAILOVER_BUDGET, DEFAULT_RETRY, DEFAULT_RETRY_BUDGET, DEFAULT_TIMEOUT_MS, DualBreaker, EXCLUSION_REASONS, ErrorClassSchema, INITIAL_HEALTH_SCORE, REDACT_PATHS, SwitcherConfigSchema, TARGET_STATES, TargetConfigSchema, TargetRegistry, addProfile, applyConfigDiff, checkHardRejects, computeBackoffMs, computeConfigDiff, computeCooldownMs, computeScore, createAdmissionController, createAuditLogger, createAuthWatcher, createCircuitBreaker, createConcurrencyTracker, createCooldownManager, createFailoverOrchestrator, createLogSubscriber, createOperatorTools, createProfileTools, createRegistry, createRequestLogger, createRequestTraceBuffer, createRetryPolicy, createRoutingEventBus, disableTarget, discoverTargets, discoverTargetsFromProfiles, drainTarget, generateCorrelationId, getExclusionReason, getTargetStateTransition, inspectRequest, isRetryable, listProfiles, listTargets, loadProfiles, nextProfileId, normalizeLatency, pauseTarget, reloadConfig, removeProfile, resumeTarget, saveProfiles, selectTarget, switchProfile, switchToNextProfile, updateHealthScore, updateLatencyEma, validateConfig } from './chunk-XXH633FY.js';
 import { timingSafeEqual } from 'crypto';
-import { tool } from '@opencode-ai/plugin/tool';
 
 // src/mode/detection.ts
 var detectDeploymentMode = (hint) => {
@@ -703,7 +702,12 @@ var createExecutionOrchestrator = (deps) => ({
         outcome = "success";
         finalTarget = failoverResult.target_id;
         const attemptValue = failoverResult.value;
-        const continuationMode = stitcher.segmentCount() === 0 ? "same_target_resume" : "same_target_resume";
+        const continuationMode = stitcher.segmentCount() === 0 ? "same_target_resume" : determineContinuationMode(
+          stitcher.assemble().segments[stitcher.segmentCount() - 1].source_target_id,
+          failoverResult.target_id,
+          true
+          // same model assumption in plugin-only mode
+        );
         stitcher.addSegment(attemptValue.buffer, {
           request_id: requestId,
           segment_id: stitcher.segmentCount(),
@@ -883,77 +887,5 @@ var validateBearerToken = (authHeader, expectedToken) => {
   }
   return { authorized: true };
 };
-var { schema: z } = tool;
-var createOperatorTools = (deps) => ({
-  listTargets: tool({
-    description: "List all routing targets with health scores, states, and circuit breaker status.",
-    args: {},
-    async execute() {
-      deps.logger.info({ op: "listTargets" }, "operator: listTargets");
-      const result = listTargets(deps);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  pauseTarget: tool({
-    description: "Pause a target, preventing new requests from being routed to it.",
-    args: { target_id: z.string().min(1) },
-    async execute(args) {
-      deps.logger.info({ op: "pauseTarget", target_id: args.target_id }, "operator: pauseTarget");
-      const result = pauseTarget(deps, args.target_id);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  resumeTarget: tool({
-    description: "Resume a previously paused or disabled target, allowing new requests.",
-    args: { target_id: z.string().min(1) },
-    async execute(args) {
-      deps.logger.info({ op: "resumeTarget", target_id: args.target_id }, "operator: resumeTarget");
-      const result = resumeTarget(deps, args.target_id);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  drainTarget: tool({
-    description: "Drain a target, allowing in-flight requests to complete but preventing new ones.",
-    args: { target_id: z.string().min(1) },
-    async execute(args) {
-      deps.logger.info({ op: "drainTarget", target_id: args.target_id }, "operator: drainTarget");
-      const result = drainTarget(deps, args.target_id);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  disableTarget: tool({
-    description: "Disable a target entirely, removing it from routing.",
-    args: { target_id: z.string().min(1) },
-    async execute(args) {
-      deps.logger.info(
-        { op: "disableTarget", target_id: args.target_id },
-        "operator: disableTarget"
-      );
-      const result = disableTarget(deps, args.target_id);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  inspectRequest: tool({
-    description: "Inspect a request trace by ID, showing attempts, segments, and outcome.",
-    args: { request_id: z.string().min(1) },
-    async execute(args) {
-      deps.logger.info(
-        { op: "inspectRequest", request_id: args.request_id },
-        "operator: inspectRequest"
-      );
-      const result = inspectRequest(deps, args.request_id);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  reloadConfig: tool({
-    description: "Reload routing configuration with diff-apply. Validates new config before applying.",
-    args: { config: z.record(z.string(), z.unknown()) },
-    async execute(args) {
-      deps.logger.info({ op: "reloadConfig" }, "operator: reloadConfig");
-      const result = reloadConfig(deps, args.config);
-      return JSON.stringify(result, null, 2);
-    }
-  })
-});
 
-export { HEURISTIC_PATTERNS, PROVIDER_PATTERNS, TEMPORAL_QUOTA_PATTERN, classify, createAuditCollector, createExecutionOrchestrator, createModeAdapter, createOperatorTools, createStreamBuffer, createStreamStitcher, detectDeploymentMode, determineContinuationMode, directSignalFromResponse, extractRetryAfterMs, getModeCapabilities, getSignalFidelity, heuristicSignalFromEvent, validateBearerToken };
+export { HEURISTIC_PATTERNS, PROVIDER_PATTERNS, TEMPORAL_QUOTA_PATTERN, classify, createAuditCollector, createExecutionOrchestrator, createModeAdapter, createStreamBuffer, createStreamStitcher, detectDeploymentMode, determineContinuationMode, directSignalFromResponse, extractRetryAfterMs, getModeCapabilities, getSignalFidelity, heuristicSignalFromEvent, validateBearerToken };

package/dist/plugin.cjs

@@ -2,25 +2,63 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkVABBGKSR_cjs = require('./chunk-VABBGKSR.cjs');
+var chunkH72U2MNG_cjs = require('./chunk-H72U2MNG.cjs');
+var promises = require('fs/promises');
+var path = require('path');
+var os = require('os');
+
+var STATE_DIR = path.join(os.homedir(), ".local", "share", "o-switcher");
+var STATE_FILE = path.join(STATE_DIR, "tui-state.json");
+var STATE_TMP = path.join(STATE_DIR, "tui-state.json.tmp");
+var writeStateAtomic = async (state) => {
+  await promises.mkdir(path.dirname(STATE_FILE), { recursive: true });
+  const json = JSON.stringify(state);
+  await promises.writeFile(STATE_TMP, json, "utf8");
+  await promises.rename(STATE_TMP, STATE_FILE);
+};
+var createStateWriter = (debounceMs = 500) => {
+  let pending;
+  let timer;
+  let writePromise = Promise.resolve();
+  const doWrite = () => {
+    if (!pending) return;
+    const snapshot = pending;
+    pending = void 0;
+    writePromise = writeStateAtomic(snapshot).catch(() => void 0);
+  };
+  const write = (state) => {
+    pending = state;
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(doWrite, debounceMs);
+  };
+  const flush = async () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    doWrite();
+    await writePromise;
+  };
+  return { write, flush };
+};
 
 // src/plugin.ts
 var initializeSwitcher = (rawConfig) => {
-  const config = chunkVABBGKSR_cjs.validateConfig(rawConfig);
-  const registry = chunkVABBGKSR_cjs.createRegistry(config);
-  const logger = chunkVABBGKSR_cjs.createAuditLogger();
-  const eventBus = chunkVABBGKSR_cjs.createRoutingEventBus();
+  const config = chunkH72U2MNG_cjs.validateConfig(rawConfig);
+  const registry = chunkH72U2MNG_cjs.createRegistry(config);
+  const logger = chunkH72U2MNG_cjs.createAuditLogger();
+  const eventBus = chunkH72U2MNG_cjs.createRoutingEventBus();
   const circuitBreakers = /* @__PURE__ */ new Map();
   for (const target of registry.getAllTargets()) {
     circuitBreakers.set(
       target.target_id,
-      chunkVABBGKSR_cjs.createCircuitBreaker(target.target_id, config.circuit_breaker, eventBus)
+      chunkH72U2MNG_cjs.createCircuitBreaker(target.target_id, config.circuit_breaker, eventBus)
     );
   }
-  const concurrency = chunkVABBGKSR_cjs.createConcurrencyTracker(config.concurrency_limit);
-  const cooldownManager = chunkVABBGKSR_cjs.createCooldownManager(registry, eventBus);
-  const traceBuffer = chunkVABBGKSR_cjs.createRequestTraceBuffer(100);
-  chunkVABBGKSR_cjs.createLogSubscriber(eventBus, logger);
+  const concurrency = chunkH72U2MNG_cjs.createConcurrencyTracker(config.concurrency_limit);
+  const cooldownManager = chunkH72U2MNG_cjs.createCooldownManager(registry, eventBus);
+  const traceBuffer = chunkH72U2MNG_cjs.createRequestTraceBuffer(100);
+  chunkH72U2MNG_cjs.createLogSubscriber(eventBus, logger);
   const configRef = {
     current: () => config,
     swap: () => {
@@ -35,10 +73,52 @@ var initializeSwitcher = (rawConfig) => {
   };
   return { config, registry, logger, circuitBreakers, concurrency, cooldownManager, operatorDeps };
 };
+var snapshotState = (state) => {
+  if (!state.registry) return void 0;
+  const allTargets = state.registry.getAllTargets();
+  const activeTarget = allTargets.find((t) => t.state === "Active" && t.enabled);
+  const targets = allTargets.map((t) => ({
+    target_id: t.target_id,
+    provider_id: t.provider_id,
+    profile: t.profile,
+    state: t.state,
+    health_score: t.health_score,
+    latency_ema_ms: t.latency_ema_ms,
+    enabled: t.enabled
+  }));
+  return {
+    version: 1,
+    updated_at: Date.now(),
+    active_target_id: activeTarget?.target_id,
+    targets
+  };
+};
 var server = async (_input) => {
-  const logger = chunkVABBGKSR_cjs.createAuditLogger({ level: "info" });
+  const logger = chunkH72U2MNG_cjs.createAuditLogger({ level: "info" });
   logger.info("O-Switcher plugin initializing");
   const state = {};
+  const stateWriter = createStateWriter();
+  const publishTuiState = () => {
+    const snapshot = snapshotState(state);
+    if (snapshot) stateWriter.write(snapshot);
+  };
+  const lazyOperatorDeps = {
+    get registry() {
+      return state.operatorDeps.registry;
+    },
+    get circuitBreakers() {
+      return state.operatorDeps.circuitBreakers;
+    },
+    get configRef() {
+      return state.operatorDeps.configRef;
+    },
+    get logger() {
+      return state.operatorDeps.logger;
+    },
+    get traceBuffer() {
+      return state.operatorDeps.traceBuffer;
+    }
+  };
   const hooks = {
     /**
      * Config hook: initialize O-Switcher when OpenCode config is loaded.
@@ -57,17 +137,17 @@ var server = async (_input) => {
         rawConfig["targets"] && Array.isArray(rawConfig["targets"]) && rawConfig["targets"].length > 0
       );
       if (!hasExplicitTargets) {
-        const profileStore = await chunkVABBGKSR_cjs.loadProfiles().catch(() => ({}));
+        const profileStore = await chunkH72U2MNG_cjs.loadProfiles().catch(() => ({}));
         const profileKeys = Object.keys(profileStore);
         if (profileKeys.length > 0) {
-          const profileTargets = chunkVABBGKSR_cjs.discoverTargetsFromProfiles(profileStore);
+          const profileTargets = chunkH72U2MNG_cjs.discoverTargetsFromProfiles(profileStore);
           rawConfig["targets"] = profileTargets;
           logger.info(
             { discovered: profileTargets.length, profiles: profileKeys },
             "Auto-discovered targets from O-Switcher profiles"
           );
         } else if (providerConfig && typeof providerConfig === "object") {
-          const discoveredTargets = chunkVABBGKSR_cjs.discoverTargets(providerConfig);
+          const discoveredTargets = chunkH72U2MNG_cjs.discoverTargets(providerConfig);
           if (discoveredTargets.length === 0) {
             logger.warn("No providers found \u2014 running in passthrough mode");
             return;
@@ -86,7 +166,8 @@ var server = async (_input) => {
         const initialized = initializeSwitcher(rawConfig);
         Object.assign(state, initialized);
         logger.info({ targets: state.registry?.getAllTargets().length }, "O-Switcher initialized");
-        state.authWatcher = chunkVABBGKSR_cjs.createAuthWatcher({ logger });
+        publishTuiState();
+        state.authWatcher = chunkH72U2MNG_cjs.createAuthWatcher({ logger });
         await state.authWatcher.start();
         logger.info("Auth watcher started");
       } catch (err) {
@@ -101,7 +182,7 @@ var server = async (_input) => {
      */
     async "chat.params"(input, output) {
       if (!state.registry) return;
-      const requestId = chunkVABBGKSR_cjs.generateCorrelationId();
+      const requestId = chunkH72U2MNG_cjs.generateCorrelationId();
       const targets = state.registry.getAllTargets();
       const providerId = input.provider?.info?.id ?? input.provider?.info?.name ?? input.model?.providerID ?? void 0;
       if (!providerId) return;
@@ -157,16 +238,36 @@ var server = async (_input) => {
             }
             state.registry.recordObservation(target.target_id, 0);
             state.circuitBreakers?.get(target.target_id)?.recordFailure();
+            publishTuiState();
             state.logger?.info(
               { target_id: target.target_id, event_type: event.type },
               "Recorded failure from session event"
             );
+            if (target.health_score < 0.3) {
+              const unhealthyIds = matchingTargets.filter((t) => t.health_score < 0.3).map((t) => t.target_id);
+              chunkH72U2MNG_cjs.switchToNextProfile({
+                provider: providerId,
+                currentProfileId: target.target_id,
+                excludeProfileIds: unhealthyIds,
+                logger: state.logger
+              }).then((result) => {
+                if (result.success) {
+                  state.logger?.info(
+                    { from: result.from, to: result.to, provider: providerId },
+                    "Auto-switched to next profile after health drop"
+                  );
+                }
+              }).catch((err) => {
+                state.logger?.warn({ err }, "Failed to auto-switch profile");
+              });
+            }
           }
         }
       }
     },
     tool: {
-      ...chunkVABBGKSR_cjs.createProfileTools()
+      ...chunkH72U2MNG_cjs.createProfileTools(),
+      ...chunkH72U2MNG_cjs.createOperatorTools(lazyOperatorDeps)
     }
   };
   return hooks;

package/dist/plugin.d.cts

@@ -10,7 +10,7 @@ export { PluginInput } from '@opencode-ai/plugin';
  * - tool definitions: 7 operator commands (list, pause, resume, drain, disable, inspect, reload)
  *
  * Install via opencode.json:
- *   "plugin": ["@apolenkov/o-switcher@latest"]
+ *   "plugin": ["@albinocrabs/o-switcher@latest"]
  *
  * Or local dev:
  *   "plugin": ["/path/to/o-switcher"]

package/dist/plugin.d.ts

@@ -10,7 +10,7 @@ export { PluginInput } from '@opencode-ai/plugin';
  * - tool definitions: 7 operator commands (list, pause, resume, drain, disable, inspect, reload)
  *
  * Install via opencode.json:
- *   "plugin": ["@apolenkov/o-switcher@latest"]
+ *   "plugin": ["@albinocrabs/o-switcher@latest"]
  *
  * Or local dev:
  *   "plugin": ["/path/to/o-switcher"]

package/dist/plugin.js

@@ -1,4 +1,42 @@
-import { createAuditLogger, createProfileTools, generateCorrelationId, loadProfiles, discoverTargetsFromProfiles, discoverTargets, createAuthWatcher, validateConfig, createRegistry, createRoutingEventBus, createCircuitBreaker, createConcurrencyTracker, createCooldownManager, createRequestTraceBuffer, createLogSubscriber } from './chunk-IKNWSNAS.js';
+import { createAuditLogger, createOperatorTools, createProfileTools, switchToNextProfile, generateCorrelationId, loadProfiles, discoverTargetsFromProfiles, discoverTargets, createAuthWatcher, validateConfig, createRegistry, createRoutingEventBus, createCircuitBreaker, createConcurrencyTracker, createCooldownManager, createRequestTraceBuffer, createLogSubscriber } from './chunk-XXH633FY.js';
+import { mkdir, writeFile, rename } from 'fs/promises';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+
+var STATE_DIR = join(homedir(), ".local", "share", "o-switcher");
+var STATE_FILE = join(STATE_DIR, "tui-state.json");
+var STATE_TMP = join(STATE_DIR, "tui-state.json.tmp");
+var writeStateAtomic = async (state) => {
+  await mkdir(dirname(STATE_FILE), { recursive: true });
+  const json = JSON.stringify(state);
+  await writeFile(STATE_TMP, json, "utf8");
+  await rename(STATE_TMP, STATE_FILE);
+};
+var createStateWriter = (debounceMs = 500) => {
+  let pending;
+  let timer;
+  let writePromise = Promise.resolve();
+  const doWrite = () => {
+    if (!pending) return;
+    const snapshot = pending;
+    pending = void 0;
+    writePromise = writeStateAtomic(snapshot).catch(() => void 0);
+  };
+  const write = (state) => {
+    pending = state;
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(doWrite, debounceMs);
+  };
+  const flush = async () => {
+    if (timer) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    doWrite();
+    await writePromise;
+  };
+  return { write, flush };
+};
 
 // src/plugin.ts
 var initializeSwitcher = (rawConfig) => {
@@ -31,10 +69,52 @@ var initializeSwitcher = (rawConfig) => {
   };
   return { config, registry, logger, circuitBreakers, concurrency, cooldownManager, operatorDeps };
 };
+var snapshotState = (state) => {
+  if (!state.registry) return void 0;
+  const allTargets = state.registry.getAllTargets();
+  const activeTarget = allTargets.find((t) => t.state === "Active" && t.enabled);
+  const targets = allTargets.map((t) => ({
+    target_id: t.target_id,
+    provider_id: t.provider_id,
+    profile: t.profile,
+    state: t.state,
+    health_score: t.health_score,
+    latency_ema_ms: t.latency_ema_ms,
+    enabled: t.enabled
+  }));
+  return {
+    version: 1,
+    updated_at: Date.now(),
+    active_target_id: activeTarget?.target_id,
+    targets
+  };
+};
 var server = async (_input) => {
   const logger = createAuditLogger({ level: "info" });
   logger.info("O-Switcher plugin initializing");
   const state = {};
+  const stateWriter = createStateWriter();
+  const publishTuiState = () => {
+    const snapshot = snapshotState(state);
+    if (snapshot) stateWriter.write(snapshot);
+  };
+  const lazyOperatorDeps = {
+    get registry() {
+      return state.operatorDeps.registry;
+    },
+    get circuitBreakers() {
+      return state.operatorDeps.circuitBreakers;
+    },
+    get configRef() {
+      return state.operatorDeps.configRef;
+    },
+    get logger() {
+      return state.operatorDeps.logger;
+    },
+    get traceBuffer() {
+      return state.operatorDeps.traceBuffer;
+    }
+  };
   const hooks = {
     /**
      * Config hook: initialize O-Switcher when OpenCode config is loaded.
@@ -82,6 +162,7 @@ var server = async (_input) => {
         const initialized = initializeSwitcher(rawConfig);
         Object.assign(state, initialized);
         logger.info({ targets: state.registry?.getAllTargets().length }, "O-Switcher initialized");
+        publishTuiState();
         state.authWatcher = createAuthWatcher({ logger });
         await state.authWatcher.start();
         logger.info("Auth watcher started");
@@ -153,16 +234,36 @@ var server = async (_input) => {
             }
             state.registry.recordObservation(target.target_id, 0);
             state.circuitBreakers?.get(target.target_id)?.recordFailure();
+            publishTuiState();
             state.logger?.info(
               { target_id: target.target_id, event_type: event.type },
               "Recorded failure from session event"
             );
+            if (target.health_score < 0.3) {
+              const unhealthyIds = matchingTargets.filter((t) => t.health_score < 0.3).map((t) => t.target_id);
+              switchToNextProfile({
+                provider: providerId,
+                currentProfileId: target.target_id,
+                excludeProfileIds: unhealthyIds,
+                logger: state.logger
+              }).then((result) => {
+                if (result.success) {
+                  state.logger?.info(
+                    { from: result.from, to: result.to, provider: providerId },
+                    "Auto-switched to next profile after health drop"
+                  );
+                }
+              }).catch((err) => {
+                state.logger?.warn({ err }, "Failed to auto-switch profile");
+              });
+            }
           }
         }
       }
     },
     tool: {
-      ...createProfileTools()
+      ...createProfileTools(),
+      ...createOperatorTools(lazyOperatorDeps)
     }
   };
   return hooks;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@albinocrabs/o-switcher",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Seamless OpenRouter profile rotation for OpenCode — buy multiple subscriptions, use as one pool",
   "type": "module",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/apolenkov/o-switcher.git"
@@ -20,6 +20,9 @@
   ],
   "files": [
     "dist",
+    "src/tui.tsx",
+    "src/state-bridge.ts",
+    "src/registry/types.ts",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -47,7 +50,8 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
-    }
+    },
+    "./tui": "./src/tui.tsx"
   },
   "scripts": {
     "build": "tsup",
@@ -56,7 +60,7 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
-    "lint:pkg": "publint && attw --pack . --ignore-rules no-resolution",
+    "lint:pkg": "publint && attw --pack . --ignore-rules no-resolution --ignore-rules cjs-resolves-to-esm",
     "format:check": "prettier --check \"src/**/*.ts\" \"*.config.*\" \"*.json\" \".prettierrc\"",
     "format": "prettier --write \"src/**/*.ts\" \"*.config.*\" \"*.json\" \".prettierrc\"",
     "test:coverage": "vitest run --coverage",
@@ -78,8 +82,10 @@
     "@changesets/cli": "^2.30.0",
     "@eslint/js": "^10.0.1",
     "@opencode-ai/plugin": "^1.4.3",
+    "@opentui/core": "^0.1.97",
+    "@opentui/solid": "^0.1.97",
     "@tsconfig/node20": "^20.1.9",
-    "@types/node": "^22",
+    "@types/node": "^25",
     "@vitest/coverage-v8": "^4.1.4",
     "eslint": "^10.2.0",
     "pino-pretty": "^13",

package/src/registry/types.ts

@@ -0,0 +1,65 @@
+/**
+ * Target registry types.
+ *
+ * Defines the TargetEntry interface with all FOUN-02 fields,
+ * the TargetState enum, and RegistrySnapshot for read-only access.
+ *
+ * SECURITY: No credential fields (api_key, token, secret, password).
+ * provider_id is a pointer to OpenCode's auth store (D-13, SECU-01, SECU-02).
+ */
+
+/**
+ * All valid states for a target in the registry.
+ *
+ * - Active: healthy and available for routing
+ * - CoolingDown: temporarily unavailable after transient failure
+ * - ReauthRequired: authentication failure, awaiting credential refresh
+ * - PolicyBlocked: blocked by policy (403), no retry
+ * - CircuitOpen: circuit breaker tripped, no requests allowed
+ * - CircuitHalfOpen: circuit breaker probing with limited requests
+ * - Draining: operator-initiated drain, no new requests
+ * - Disabled: operator-disabled or config-disabled
+ */
+export const TARGET_STATES = [
+  'Active',
+  'CoolingDown',
+  'ReauthRequired',
+  'PolicyBlocked',
+  'CircuitOpen',
+  'CircuitHalfOpen',
+  'Draining',
+  'Disabled',
+] as const;
+
+/** Target state type. */
+export type TargetState = (typeof TARGET_STATES)[number];
+
+/**
+ * A single target entry in the registry.
+ *
+ * Contains all fields per FOUN-02: target_id, provider_id, endpoint_id,
+ * capabilities, enabled, state, health_score, cooldown_until, latency_ema_ms,
+ * failure_score, operator_priority, policy_tags.
+ *
+ * NO credential fields -- provider_id maps to OpenCode's credential store.
+ */
+export interface TargetEntry {
+  readonly target_id: string;
+  readonly provider_id: string;
+  readonly profile: string | undefined;
+  readonly endpoint_id: string | undefined;
+  readonly capabilities: readonly string[];
+  readonly enabled: boolean;
+  readonly state: TargetState;
+  readonly health_score: number;
+  readonly cooldown_until: number | null;
+  readonly latency_ema_ms: number;
+  readonly failure_score: number;
+  readonly operator_priority: number;
+  readonly policy_tags: readonly string[];
+}
+
+/** Read-only snapshot of the entire registry. */
+export interface RegistrySnapshot {
+  readonly targets: ReadonlyArray<Readonly<TargetEntry>>;
+}