@harness-mix/cli 0.1.3

package/src/native-ui/renderer-extension/dist/types/versioned-renderer-adapter.d.ts

@@ -0,0 +1,143 @@
+import { type HarnessModelRef, type HarnessPermissionModeId, type HarnessThinkingOptionId, type HostThreadId } from "@codexhost/shared-contracts";
+import type { RendererAgent } from "./agent-selection-state.js";
+import { type RendererModelClient } from "./renderer-model-client.js";
+export declare const PI_TRANSPORT_MODEL_ID = "codexhost/pi-native";
+export declare const PI_TRANSPORT_MODEL_PREFIX = "codexhost/pi-native@";
+export declare const CLAUDE_CODE_TRANSPORT_MODEL_ID = "codexhost/claude-code-native";
+export declare const CLAUDE_CODE_TRANSPORT_MODEL_PREFIX = "codexhost/claude-code-native@";
+export declare const DEEPSEEK_HARNESS_TRANSPORT_MODEL_ID = "codexhost/deepseek-harness-native";
+export declare const DEEPSEEK_HARNESS_TRANSPORT_MODEL_PREFIX = "codexhost/deepseek-harness-native@";
+export declare const OPENCODE_TRANSPORT_MODEL_ID = "codexhost/opencode-native";
+export declare const OPENCODE_TRANSPORT_MODEL_PREFIX = "codexhost/opencode-native@";
+export declare const GROK_TRANSPORT_MODEL_ID = "codexhost/grok-native";
+export declare const GROK_TRANSPORT_MODEL_PREFIX = "codexhost/grok-native@";
+export declare const OMP_TRANSPORT_MODEL_ID = "codexhost/omp-native";
+export declare const OMP_TRANSPORT_MODEL_PREFIX = "codexhost/omp-native@";
+export declare const ANTIGRAVITY_TRANSPORT_MODEL_ID = "codexhost/antigravity-native";
+export declare const ANTIGRAVITY_TRANSPORT_MODEL_PREFIX = "codexhost/antigravity-native@";
+export type RendererAdapterState = "installing" | "ready" | "unsupported";
+export interface LockedComposerSelection {
+    agent: RendererAgent;
+    composerId: string;
+    phase: "locked";
+    model?: HarnessModelRef;
+    thinkingOptionId?: HarnessThinkingOptionId;
+    permissionModeId?: HarnessPermissionModeId;
+}
+export interface RendererAdapterStatus {
+    state: RendererAdapterState;
+    reason: "installing" | "ready" | "asset-import-failed" | "installation-failed" | "draft-prewarm-clear-failed" | "draft-routing-policy-unavailable";
+    modelUpdates: number;
+    hook: "request-bridge" | null;
+}
+type RendererAdapterStatusTransition = Pick<RendererAdapterStatus, "state" | "reason" | "hook">;
+export declare function transitionRendererAdapterStatus(current: RendererAdapterStatus, next: RendererAdapterStatusTransition, publish: () => void): boolean;
+interface PrewarmTarget {
+    addNotificationCallback?: (method: string | readonly string[], callback: (notification: unknown) => void) => () => void;
+    enqueueRequest?: (...args: unknown[]) => unknown;
+    prewarmThreadStart?: (params: unknown, options?: unknown) => Promise<unknown> | unknown;
+    sendRequest?: (method: string, params: unknown, options?: unknown) => Promise<unknown> | unknown;
+    requestClient?: PrewarmTarget;
+    hostId?: unknown;
+    getHostId?: () => unknown;
+}
+export interface ModelPowerSelection {
+    model: unknown;
+    reasoningEffort: unknown;
+    [key: string]: unknown;
+}
+export interface RendererDraftPrewarmPolicy {
+    state: "ready";
+    hostId: string;
+    readonly requestTarget?: () => unknown;
+    select(model: string | null): boolean;
+    readonly selectAccount?: (accountId: string | null) => boolean;
+    clear(): Promise<void>;
+}
+interface RendererDraftPrewarmPolicyTarget {
+    __codexhostDraftPrewarmPolicyV1?: RendererDraftPrewarmPolicy;
+    setTimeout(handler: TimerHandler, timeout?: number): number;
+}
+declare global {
+    interface Window {
+        __codexhostMainProcessTitlePolicyV1?: {
+            state: "ready";
+        };
+        __codexhostDraftPrewarmPolicyV1?: RendererDraftPrewarmPolicy;
+    }
+}
+export declare function piTransportModelId(model?: HarnessModelRef, thinkingOptionId?: HarnessThinkingOptionId): string;
+export declare function ompTransportModelId(model?: HarnessModelRef, thinkingOptionId?: HarnessThinkingOptionId, permissionModeId?: HarnessPermissionModeId): string;
+export declare function antigravityTransportModelId(model?: HarnessModelRef, permissionModeId?: HarnessPermissionModeId, thinkingOptionId?: HarnessThinkingOptionId): string;
+export declare function openCodeTransportModelId(model?: HarnessModelRef, permissionModeId?: HarnessPermissionModeId, thinkingOptionId?: HarnessThinkingOptionId): string;
+export declare function decodeOpenCodeTransportModelId(value: unknown): {
+    model?: HarnessModelRef;
+    thinkingOptionId?: HarnessThinkingOptionId;
+    permissionModeId?: HarnessPermissionModeId;
+} | null;
+export declare function isOpenCodeTransportModelId(value: unknown): value is string;
+export declare function claudeTransportModelId(model?: HarnessModelRef, permissionModeId?: HarnessPermissionModeId, thinkingOptionId?: HarnessThinkingOptionId): string;
+export declare function grokTransportModelId(model?: HarnessModelRef, permissionModeId?: HarnessPermissionModeId, thinkingOptionId?: HarnessThinkingOptionId): string;
+export declare function decodeGrokTransportModelId(value: unknown): {
+    model?: HarnessModelRef;
+    thinkingOptionId?: HarnessThinkingOptionId;
+    permissionModeId?: HarnessPermissionModeId;
+} | null;
+export declare function decodeClaudeTransportModelId(value: unknown): {
+    model?: HarnessModelRef;
+    thinkingOptionId?: HarnessThinkingOptionId;
+    permissionModeId?: HarnessPermissionModeId;
+} | null;
+export declare function isGrokTransportModelId(value: unknown): value is string;
+export declare function isClaudeTransportModelId(value: unknown): value is string;
+export declare function deepSeekHarnessTransportModelId(model?: HarnessModelRef, permissionModeId?: HarnessPermissionModeId): string;
+export declare function decodeDeepSeekHarnessTransportModelId(value: unknown): {
+    model?: HarnessModelRef;
+    permissionModeId?: HarnessPermissionModeId;
+} | null;
+export declare function isDeepSeekHarnessTransportModelId(value: unknown): value is string;
+export declare function decodePiTransportModelId(value: unknown): {
+    model?: HarnessModelRef;
+    thinkingOptionId?: HarnessThinkingOptionId;
+} | null;
+export declare function isPiTransportModelId(value: unknown): value is string;
+export declare function decodeOmpTransportModelId(value: unknown): {
+    model?: HarnessModelRef;
+    permissionModeId?: HarnessPermissionModeId;
+    thinkingOptionId?: HarnessThinkingOptionId;
+} | null;
+export declare function isOmpTransportModelId(value: unknown): value is string;
+export declare function decodeAntigravityTransportModelId(value: unknown): {
+    model?: HarnessModelRef;
+    permissionModeId?: HarnessPermissionModeId;
+    thinkingOptionId?: HarnessThinkingOptionId;
+} | null;
+export declare function isAntigravityTransportModelId(value: unknown): value is string;
+export declare function threadIdFromComposerModelTarget(target: readonly unknown[] | null): HostThreadId | null;
+export declare function findActivePrewarmTargets(root: ParentNode): PrewarmTarget[];
+export declare function findComposerModelTarget(composer: Element): readonly unknown[] | null;
+export type RendererComposerModelContractState = "draft" | "conversation" | "missing" | "ambiguous";
+export declare function inspectComposerModelContract(composer: Element): RendererComposerModelContractState;
+export declare function isMainProcessTitlePolicyReady(value: unknown): boolean;
+export declare function isDraftPrewarmPolicyReady(value: unknown): value is RendererDraftPrewarmPolicy;
+export declare function activeRendererDraftPrewarmPolicy(policy: unknown, targets: readonly PrewarmTarget[]): RendererDraftPrewarmPolicy | null;
+export declare function rendererRequestTargetsForHost(targets: readonly PrewarmTarget[], hostId: string): readonly PrewarmTarget[] | null;
+export interface RendererRequestRoute {
+    readonly policy: RendererDraftPrewarmPolicy;
+    readonly targets: readonly PrewarmTarget[];
+}
+export declare function resolveRendererRequestRoute(policy: unknown, discoveredTargets: readonly PrewarmTarget[], previous: RendererRequestRoute | null): RendererRequestRoute | null;
+export declare function createRendererRequestRouteResolver(readPolicy: () => unknown, discoverTargets: () => readonly PrewarmTarget[]): {
+    resolve(): RendererRequestRoute | null;
+    clear(): void;
+};
+export declare function waitForRendererDraftPrewarmPolicy(target: RendererDraftPrewarmPolicyTarget): Promise<RendererDraftPrewarmPolicy>;
+export declare function modelSelectionForAgent(officialSelection: ModelPowerSelection | null, reasoningEffort: unknown, agent: RendererAgent, model?: HarnessModelRef, thinkingOptionId?: HarnessThinkingOptionId, permissionModeId?: HarnessPermissionModeId): ModelPowerSelection | null;
+export declare function installCurrentRendererAdapter(): {
+    status: RendererAdapterStatus;
+    modelControl: RendererModelClient | null;
+    applyAgent(agent: RendererAgent, model?: HarnessModelRef, thinkingOptionId?: HarnessThinkingOptionId, permissionModeId?: HarnessPermissionModeId, composer?: Element): boolean;
+    dispose(): void;
+};
+export {};
+//# sourceMappingURL=versioned-renderer-adapter.d.ts.map

package/src/native-ui/renderer-extension/dist/types/versioned-renderer-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-renderer-adapter.d.ts","sourceRoot":"","sources":["../../src/versioned-renderer-adapter.ts"],"names":[],"mappings":"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"}

package/src/native-ui/renderer-extension/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@codexhost/renderer-extension",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=browser --format=esm --target=es2024 --loader:.png=dataurl --loader:.svg=dataurl --loader:.css=text --outfile=dist/index.js && esbuild src/production-entry.ts --bundle --platform=browser --format=iife --target=es2024 --loader:.png=dataurl --loader:.svg=dataurl --loader:.css=text --outfile=dist/production.js && esbuild src/probe-entry.ts --bundle --platform=browser --format=iife --target=es2024 --loader:.png=dataurl --loader:.svg=dataurl --loader:.css=text --outfile=dist/renderer-binding-probe.js && esbuild src/audit-entry.ts --bundle --platform=browser --format=iife --target=es2024 --loader:.png=dataurl --loader:.svg=dataurl --loader:.css=text --outfile=dist/contract-audit.js"
+  },
+  "dependencies": {
+    "@codexhost/shared-contracts": "0.0.0",
+    "lucide": "1.28.0"
+  }
+}

package/src/native-ui/renderer-extension/src/agent-group-preference.ts

@@ -0,0 +1,174 @@
+import { KNOWN_RENDERER_AGENTS, type ExternalRendererAgent } from "./agent-selection-state.js";
+
+/**
+ * Where an external Agent currently lives from the user's point of view:
+ * - "main": shown directly in the Agent picker and the Connections list.
+ * - "more": folded away under a collapsible "More Agents" group so the
+ *   picker stays short as the number of supported Harnesses grows.
+ *
+ * This is a purely presentational preference. It never affects whether an
+ * Agent is installed, enabled, or reachable — those remain governed by
+ * `enabledAgents` / `RendererAgentAvailability` elsewhere.
+ */
+export type AgentGroupSection = "main" | "more";
+
+export interface AgentGroupEntry {
+  readonly agent: ExternalRendererAgent;
+  readonly section: AgentGroupSection;
+}
+
+export interface AgentGroupPreferenceStore {
+  /** All known external Agents, in display order, each tagged with its section. */
+  list(): readonly AgentGroupEntry[];
+  sectionOf(agent: ExternalRendererAgent): AgentGroupSection;
+  /**
+   * Move `agent` into `section`. When `beforeAgent` is provided the Agent is
+   * inserted immediately before it (both must end up in the same section);
+   * otherwise it is appended to the end of the target section.
+   */
+  moveAgent(
+    agent: ExternalRendererAgent,
+    section: AgentGroupSection,
+    beforeAgent?: ExternalRendererAgent | null,
+  ): void;
+  resetToDefault(): void;
+  subscribe(listener: () => void): () => void;
+}
+
+export const AGENT_GROUP_PREFERENCE_STORAGE_KEY = "codexhost.agentGroupPreference.v1";
+
+const EXTERNAL_AGENTS: readonly ExternalRendererAgent[] = KNOWN_RENDERER_AGENTS.filter(
+  (agent): agent is ExternalRendererAgent => agent !== "codex",
+);
+
+interface StoredEntry {
+  readonly agent: string;
+  readonly section: AgentGroupSection;
+}
+
+function isKnownExternalAgent(value: unknown): value is ExternalRendererAgent {
+  return typeof value === "string" && (EXTERNAL_AGENTS as readonly string[]).includes(value);
+}
+
+function isStoredEntry(value: unknown): value is StoredEntry {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value as Partial<StoredEntry>;
+  return (
+    isKnownExternalAgent(candidate.agent) &&
+    (candidate.section === "main" || candidate.section === "more")
+  );
+}
+
+function readStorage(storage: Pick<Storage, "getItem"> | null): StoredEntry[] | null {
+  if (!storage) return null;
+  try {
+    const raw = storage.getItem(AGENT_GROUP_PREFERENCE_STORAGE_KEY);
+    if (!raw) return null;
+    const parsed: unknown = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return null;
+    return parsed.map(entry => entry && entry.agent === 'workbuddy' ? { ...entry, agent: 'codebuddy' } : entry).filter(isStoredEntry);
+  } catch {
+    return null;
+  }
+}
+
+function writeStorage(
+  storage: Pick<Storage, "setItem"> | null,
+  entries: readonly StoredEntry[],
+): void {
+  if (!storage) return;
+  try {
+    storage.setItem(AGENT_GROUP_PREFERENCE_STORAGE_KEY, JSON.stringify(entries));
+  } catch {
+    // Best effort only: private browsing / quota errors should not break the UI.
+  }
+}
+
+function safeLocalStorage(): Storage | null {
+  try {
+    return typeof window !== "undefined" ? window.localStorage : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Creates an isolated preference store. Pass an explicit `storage` (or
+ * `null`) in tests to avoid touching the real `localStorage` and to keep
+ * cases independent from one another.
+ */
+export function createAgentGroupPreferenceStore(
+  storage: Storage | null = safeLocalStorage(),
+): AgentGroupPreferenceStore {
+  let order: ExternalRendererAgent[] = [...EXTERNAL_AGENTS];
+  let sections = new Map<ExternalRendererAgent, AgentGroupSection>(
+    EXTERNAL_AGENTS.map((agent) => [agent, "main" as AgentGroupSection]),
+  );
+  const listeners = new Set<() => void>();
+
+  const stored = readStorage(storage);
+  if (stored && stored.length > 0) {
+    const seen = new Set<ExternalRendererAgent>();
+    const nextOrder: ExternalRendererAgent[] = [];
+    for (const entry of stored) {
+      const agent = entry.agent as ExternalRendererAgent;
+      if (seen.has(agent)) continue;
+      seen.add(agent);
+      nextOrder.push(agent);
+      sections.set(agent, entry.section);
+    }
+    // Agents that shipped after the user last saved a preference (new
+    // Harnesses) default to "main" and land at the end of the list.
+    for (const agent of EXTERNAL_AGENTS) {
+      if (!seen.has(agent)) nextOrder.push(agent);
+    }
+    order = nextOrder;
+  }
+
+  const persist = (): void => {
+    writeStorage(
+      storage,
+      order.map((agent) => ({ agent, section: sections.get(agent) ?? "main" })),
+    );
+  };
+  const notify = (): void => {
+    for (const listener of [...listeners]) listener();
+  };
+
+  return {
+    list() {
+      return order.map((agent) => ({ agent, section: sections.get(agent) ?? "main" }));
+    },
+    sectionOf(agent) {
+      return sections.get(agent) ?? "main";
+    },
+    moveAgent(agent, section, beforeAgent = null) {
+      if (!EXTERNAL_AGENTS.includes(agent)) return;
+      order = order.filter((candidate) => candidate !== agent);
+      const insertAt = beforeAgent && beforeAgent !== agent ? order.indexOf(beforeAgent) : -1;
+      if (insertAt >= 0) order.splice(insertAt, 0, agent);
+      else order.push(agent);
+      sections.set(agent, section);
+      persist();
+      notify();
+    },
+    resetToDefault() {
+      order = [...EXTERNAL_AGENTS];
+      sections = new Map(EXTERNAL_AGENTS.map((agent) => [agent, "main" as AgentGroupSection]));
+      persist();
+      notify();
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+  };
+}
+
+let sharedStore: AgentGroupPreferenceStore | null = null;
+
+/** Shared singleton so the Connections settings page and every Agent picker stay in sync. */
+export function getSharedAgentGroupPreferenceStore(): AgentGroupPreferenceStore {
+  if (!sharedStore) sharedStore = createAgentGroupPreferenceStore();
+  return sharedStore;
+}