@tutti-os/agent-gui 0.0.57 → 0.0.59

package/dist/agent-conversation/index.d.ts

@@ -2,10 +2,10 @@ import * as react from 'react';
 import { ReactNode, JSX } from 'react';
 import { W as WorkspaceLinkAction } from '../workspaceLinkActions-Bjy_XfBm.js';
 import { A as AgentMessageMarkdownWorkspaceAppIcon } from '../AgentMessageMarkdown-DeYPURtF.js';
-import { c as AgentConversationVM, W as WorkspaceAgentSessionDetailViewModel } from '../agentConversationVM-Qbz9GBwR.js';
-export { B as BuildWorkspaceAgentSessionDetailInput, d as buildWorkspaceAgentSessionDetailViewModel } from '../agentConversationVM-Qbz9GBwR.js';
-import { d as AgentGUIProviderSkillOption } from '../agentGuiNodeTypes-BRU6P22B.js';
-export { W as WorkspaceAgentActivityCard, n as WorkspaceAgentActivitySession, q as WorkspaceAgentActivityTimelineItem } from '../workspaceAgentActivityListViewModel-B5viw5Da.js';
+import { c as AgentConversationVM, W as WorkspaceAgentSessionDetailViewModel } from '../agentConversationVM-DPAgUJlR.js';
+export { B as BuildWorkspaceAgentSessionDetailInput, d as buildWorkspaceAgentSessionDetailViewModel } from '../agentConversationVM-DPAgUJlR.js';
+import { d as AgentGUIProviderSkillOption } from '../agentGuiNodeTypes-CupCLd9p.js';
+export { W as WorkspaceAgentActivityCard, n as WorkspaceAgentActivitySession, q as WorkspaceAgentActivityTimelineItem } from '../workspaceAgentActivityListViewModel-DJvAqZso.js';
 import '@tutti-os/workspace-issue-manager/core';
 import '@tutti-os/agent-activity-core';
 import '../types-BsHvTjIZ.js';

package/dist/agent-conversation/index.js

@@ -6,19 +6,20 @@ import {
   projectAgentConversationVM,
   reconcileProjectedAgentConversationVM,
   useProjectedAgentConversation
-} from "../chunk-DZ76JPCV.js";
-import "../chunk-2VHP7KQ5.js";
-import "../chunk-N37A5CJH.js";
+} from "../chunk-BEFNWUOZ.js";
+import "../chunk-SLT5Q37C.js";
+import "../chunk-PSLAWU25.js";
+import "../chunk-NX6T3DDS.js";
 import "../chunk-Y35GDLP2.js";
 import "../chunk-LUGELG5V.js";
-import "../chunk-S6PCOX3S.js";
+import "../chunk-HVU46DDA.js";
 import "../chunk-TYGL25EL.js";
-import "../chunk-PJP5BUU6.js";
-import "../chunk-MTFSQWZ6.js";
 import {
   translate
-} from "../chunk-Z3AAQQFD.js";
-import "../chunk-33LWYV6O.js";
+} from "../chunk-5SRRKWE4.js";
+import "../chunk-PJP5BUU6.js";
+import "../chunk-MTFSQWZ6.js";
+import "../chunk-IS6JUDDY.js";
 
 // shared/WorkspaceAgentSessionDetail.tsx
 import { useMemo } from "react";

package/dist/agent-conversation/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../shared/WorkspaceAgentSessionDetail.tsx"],"sourcesContent":["import { useMemo, type JSX } from \"react\";\nimport type { WorkspaceLinkAction } from \"../contexts/workspace/presentation/renderer/actions/workspaceLinkActions\";\nimport { translate } from \"../i18n/index\";\nimport { AgentConversationFlow } from \"./agentConversation/components/AgentConversationFlow\";\nimport { useProjectedAgentConversation } from \"./agentConversation/projection/useProjectedAgentConversation\";\nimport type { WorkspaceAgentSessionDetailViewModel } from \"./workspaceAgentSessionDetailViewModel\";\n\ninterface WorkspaceAgentSessionDetailProps {\n  detail: WorkspaceAgentSessionDetailViewModel;\n  avoidGroupingEdits?: boolean;\n  isLoading: boolean;\n  timelineItemCount: number;\n  onLinkAction?: (action: WorkspaceLinkAction) => void;\n  toolCallsLabel: (count: number) => string;\n  thinkingLabel?: string;\n  loadingLabel?: string;\n  rawTimelineJsonLabel?: string;\n  showRawTimelineJson?: boolean;\n}\n\nexport function WorkspaceAgentSessionDetail({\n  detail,\n  avoidGroupingEdits = false,\n  isLoading,\n  timelineItemCount,\n  onLinkAction,\n  toolCallsLabel,\n  thinkingLabel = translate(\"agentHost.workspaceAgentSessionDetailThinking\"),\n  loadingLabel = translate(\"common.loading\"),\n  rawTimelineJsonLabel,\n  showRawTimelineJson = false\n}: WorkspaceAgentSessionDetailProps): JSX.Element {\n  const conversation = useProjectedAgentConversation({\n    detail,\n    avoidGroupingEdits\n  });\n  const showLoadingSkeleton =\n    detail.turns.length === 0 &&\n    (isLoading ||\n      detail.activity.status === \"waiting\" ||\n      detail.activity.status === \"working\");\n  const emptySummary =\n    detail.activity.latestActivitySummary ||\n    (timelineItemCount > 0\n      ? translate(\"agentHost.workspaceAgentSessionDetailEmptyWithTimeline\")\n      : translate(\"agentHost.workspaceAgentSessionDetailEmptyNoTimeline\"));\n  const flowLabels = useMemo(\n    () => ({\n      thinkingLabel,\n      toolCallsLabel,\n      processing: translate(\"agentHost.agentGui.processing\"),\n      turnSummary: translate(\"agentHost.agentGui.turnSummary\"),\n      rawTimelineJson: rawTimelineJsonLabel\n    }),\n    [rawTimelineJsonLabel, thinkingLabel, toolCallsLabel]\n  );\n  const emptyState = useMemo(\n    () => (\n      <div className=\"workspace-agents-status-panel__detail-empty\">\n        {emptySummary}\n      </div>\n    ),\n    [emptySummary]\n  );\n\n  return (\n    <div className=\"workspace-agents-status-panel__detail\">\n      <AgentConversationFlow\n        conversation={detail.turns.length > 0 ? conversation : null}\n        isLoading={showLoadingSkeleton}\n        loadingLabel={loadingLabel}\n        empty={emptyState}\n        onLinkAction={onLinkAction}\n        showRawTimelineJson={showRawTimelineJson}\n        labels={flowLabels}\n      />\n    </div>\n  );\n}\n\nexport function WorkspaceAgentSessionDetailSkeleton({\n  loading = true,\n  loadingLabel = translate(\"common.loading\")\n}: {\n  loading?: boolean;\n  loadingLabel?: string;\n}): JSX.Element {\n  const flowLabels = useMemo(\n    () => ({\n      thinkingLabel: translate(\"agentHost.workspaceAgentSessionDetailThinking\"),\n      toolCallsLabel: (count: number) =>\n        translate(\"agentHost.workspaceAgentSessionDetailToolCalls\", { count }),\n      processing: translate(\"agentHost.agentGui.processing\"),\n      turnSummary: translate(\"agentHost.agentGui.turnSummary\")\n    }),\n    []\n  );\n\n  if (!loading) {\n    return <></>;\n  }\n\n  return (\n    <div\n      className=\"workspace-agents-status-panel__detail-skeleton\"\n      data-testid=\"workspace-agents-status-panel-detail-skeleton\"\n      role=\"status\"\n      aria-busy=\"true\"\n      aria-label={loadingLabel}\n    >\n      <AgentConversationFlow\n        conversation={null}\n        isLoading\n        loadingLabel={loadingLabel}\n        loadingTestId=\"workspace-agents-status-panel-detail-skeleton\"\n        empty={null}\n        labels={flowLabels}\n      />\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,eAAyB;AA0D5B,SAyCK,UAzCL;AAtCC,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA,qBAAqB;AAAA,EACrB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,gBAAgB,UAAU,+CAA+C;AAAA,EACzE,eAAe,UAAU,gBAAgB;AAAA,EACzC;AAAA,EACA,sBAAsB;AACxB,GAAkD;AAChD,QAAM,eAAe,8BAA8B;AAAA,IACjD;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,sBACJ,OAAO,MAAM,WAAW,MACvB,aACC,OAAO,SAAS,WAAW,aAC3B,OAAO,SAAS,WAAW;AAC/B,QAAM,eACJ,OAAO,SAAS,0BACf,oBAAoB,IACjB,UAAU,wDAAwD,IAClE,UAAU,sDAAsD;AACtE,QAAM,aAAa;AAAA,IACjB,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,YAAY,UAAU,+BAA+B;AAAA,MACrD,aAAa,UAAU,gCAAgC;AAAA,MACvD,iBAAiB;AAAA,IACnB;AAAA,IACA,CAAC,sBAAsB,eAAe,cAAc;AAAA,EACtD;AACA,QAAM,aAAa;AAAA,IACjB,MACE,oBAAC,SAAI,WAAU,+CACZ,wBACH;AAAA,IAEF,CAAC,YAAY;AAAA,EACf;AAEA,SACE,oBAAC,SAAI,WAAU,yCACb;AAAA,IAAC;AAAA;AAAA,MACC,cAAc,OAAO,MAAM,SAAS,IAAI,eAAe;AAAA,MACvD,WAAW;AAAA,MACX;AAAA,MACA,OAAO;AAAA,MACP;AAAA,MACA;AAAA,MACA,QAAQ;AAAA;AAAA,EACV,GACF;AAEJ;","names":[]}
+{"version":3,"sources":["../../shared/WorkspaceAgentSessionDetail.tsx"],"sourcesContent":["import { useMemo, type JSX } from \"react\";\nimport type { WorkspaceLinkAction } from \"../contexts/workspace/presentation/renderer/actions/workspaceLinkActions\";\nimport { translate } from \"../i18n/index\";\nimport { AgentConversationFlow } from \"./agentConversation/components/AgentConversationFlow\";\nimport { useProjectedAgentConversation } from \"./agentConversation/projection/useProjectedAgentConversation\";\nimport type { WorkspaceAgentSessionDetailViewModel } from \"./workspaceAgentSessionDetailViewModel\";\n\ninterface WorkspaceAgentSessionDetailProps {\n  detail: WorkspaceAgentSessionDetailViewModel;\n  avoidGroupingEdits?: boolean;\n  isLoading: boolean;\n  timelineItemCount: number;\n  onLinkAction?: (action: WorkspaceLinkAction) => void;\n  toolCallsLabel: (count: number) => string;\n  thinkingLabel?: string;\n  loadingLabel?: string;\n  rawTimelineJsonLabel?: string;\n  showRawTimelineJson?: boolean;\n}\n\nexport function WorkspaceAgentSessionDetail({\n  detail,\n  avoidGroupingEdits = false,\n  isLoading,\n  timelineItemCount,\n  onLinkAction,\n  toolCallsLabel,\n  thinkingLabel = translate(\"agentHost.workspaceAgentSessionDetailThinking\"),\n  loadingLabel = translate(\"common.loading\"),\n  rawTimelineJsonLabel,\n  showRawTimelineJson = false\n}: WorkspaceAgentSessionDetailProps): JSX.Element {\n  const conversation = useProjectedAgentConversation({\n    detail,\n    avoidGroupingEdits\n  });\n  const showLoadingSkeleton =\n    detail.turns.length === 0 &&\n    (isLoading ||\n      detail.activity.status === \"waiting\" ||\n      detail.activity.status === \"working\");\n  const emptySummary =\n    detail.activity.latestActivitySummary ||\n    (timelineItemCount > 0\n      ? translate(\"agentHost.workspaceAgentSessionDetailEmptyWithTimeline\")\n      : translate(\"agentHost.workspaceAgentSessionDetailEmptyNoTimeline\"));\n  const flowLabels = useMemo(\n    () => ({\n      thinkingLabel,\n      toolCallsLabel,\n      processing: translate(\"agentHost.agentGui.processing\"),\n      turnSummary: translate(\"agentHost.agentGui.turnSummary\"),\n      rawTimelineJson: rawTimelineJsonLabel\n    }),\n    [rawTimelineJsonLabel, thinkingLabel, toolCallsLabel]\n  );\n  const emptyState = useMemo(\n    () => (\n      <div className=\"workspace-agents-status-panel__detail-empty\">\n        {emptySummary}\n      </div>\n    ),\n    [emptySummary]\n  );\n\n  return (\n    <div className=\"workspace-agents-status-panel__detail\">\n      <AgentConversationFlow\n        conversation={detail.turns.length > 0 ? conversation : null}\n        isLoading={showLoadingSkeleton}\n        loadingLabel={loadingLabel}\n        empty={emptyState}\n        onLinkAction={onLinkAction}\n        showRawTimelineJson={showRawTimelineJson}\n        labels={flowLabels}\n      />\n    </div>\n  );\n}\n\nexport function WorkspaceAgentSessionDetailSkeleton({\n  loading = true,\n  loadingLabel = translate(\"common.loading\")\n}: {\n  loading?: boolean;\n  loadingLabel?: string;\n}): JSX.Element {\n  const flowLabels = useMemo(\n    () => ({\n      thinkingLabel: translate(\"agentHost.workspaceAgentSessionDetailThinking\"),\n      toolCallsLabel: (count: number) =>\n        translate(\"agentHost.workspaceAgentSessionDetailToolCalls\", { count }),\n      processing: translate(\"agentHost.agentGui.processing\"),\n      turnSummary: translate(\"agentHost.agentGui.turnSummary\")\n    }),\n    []\n  );\n\n  if (!loading) {\n    return <></>;\n  }\n\n  return (\n    <div\n      className=\"workspace-agents-status-panel__detail-skeleton\"\n      data-testid=\"workspace-agents-status-panel-detail-skeleton\"\n      role=\"status\"\n      aria-busy=\"true\"\n      aria-label={loadingLabel}\n    >\n      <AgentConversationFlow\n        conversation={null}\n        isLoading\n        loadingLabel={loadingLabel}\n        loadingTestId=\"workspace-agents-status-panel-detail-skeleton\"\n        empty={null}\n        labels={flowLabels}\n      />\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,eAAyB;AA0D5B,SAyCK,UAzCL;AAtCC,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA,qBAAqB;AAAA,EACrB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,gBAAgB,UAAU,+CAA+C;AAAA,EACzE,eAAe,UAAU,gBAAgB;AAAA,EACzC;AAAA,EACA,sBAAsB;AACxB,GAAkD;AAChD,QAAM,eAAe,8BAA8B;AAAA,IACjD;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,sBACJ,OAAO,MAAM,WAAW,MACvB,aACC,OAAO,SAAS,WAAW,aAC3B,OAAO,SAAS,WAAW;AAC/B,QAAM,eACJ,OAAO,SAAS,0BACf,oBAAoB,IACjB,UAAU,wDAAwD,IAClE,UAAU,sDAAsD;AACtE,QAAM,aAAa;AAAA,IACjB,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,YAAY,UAAU,+BAA+B;AAAA,MACrD,aAAa,UAAU,gCAAgC;AAAA,MACvD,iBAAiB;AAAA,IACnB;AAAA,IACA,CAAC,sBAAsB,eAAe,cAAc;AAAA,EACtD;AACA,QAAM,aAAa;AAAA,IACjB,MACE,oBAAC,SAAI,WAAU,+CACZ,wBACH;AAAA,IAEF,CAAC,YAAY;AAAA,EACf;AAEA,SACE,oBAAC,SAAI,WAAU,yCACb;AAAA,IAAC;AAAA;AAAA,MACC,cAAc,OAAO,MAAM,SAAS,IAAI,eAAe;AAAA,MACvD,WAAW;AAAA,MACX;AAAA,MACA,OAAO;AAAA,MACP;AAAA,MACA;AAAA,MACA,QAAQ;AAAA;AAAA,EACV,GACF;AAEJ;","names":[]}

package/dist/agent-env/index.d.ts

@@ -0,0 +1,285 @@
+import { WorkspaceAgentProvider, AgentProviderStatus } from '@tutti-os/client-tuttid-ts';
+
+/**
+ * Section the Agent Env panel (the片6 Setup Wizard / config panel) should scroll
+ * to / emphasise when opened via a deep-link. The error card (片5) maps a domain
+ * error code to one of these so the user lands on the relevant remediation.
+ */
+type AgentEnvPanelFocus = "detect" | "install" | "repair" | "upgrade" | "auth" | "network" | "registry";
+interface AgentEnvPanelRequest {
+    open: boolean;
+    provider: string | null;
+    focus: AgentEnvPanelFocus | null;
+    /**
+     * Bumped on every openAgentEnvPanel() call. The host panel watches this to
+     * re-run detection even when it is already open (e.g. a second deep-link).
+     */
+    requestSequence: number;
+}
+interface OpenAgentEnvPanelInput {
+    provider?: string | null;
+    focus?: AgentEnvPanelFocus | null;
+}
+/**
+ * Open the agent environment panel. Safe to call from anywhere in the agent-gui
+ * tree (rail footer entry, error-card deep-link). The host renders the actual
+ * panel and reacts to this singleton store.
+ */
+declare function openAgentEnvPanel(input?: OpenAgentEnvPanelInput): void;
+declare function closeAgentEnvPanel(): void;
+/** Imperative read, mainly for tests. Components should use the hook. */
+declare function getAgentEnvPanelStore(): AgentEnvPanelRequest;
+/** Reactive snapshot of the panel request for the host renderer. */
+declare function useAgentEnvPanelRequest(): AgentEnvPanelRequest;
+
+/**
+ * Run-failure codes actually emitted by the daemon runtime classifier
+ * (packages/agent/daemon/runtime/visible_error.go `visibleFailureCode`). These
+ * are the codes the conversation error card really receives — unlike the
+ * aspirational `CODEX_*` codes, which the run pipeline never produces.
+ *
+ * Keep this union aligned with the Go switch in `visibleFailureCode`.
+ */
+type AgentRunErrorCode = "auth_required" | "cli_not_found" | "cli_version_unsupported" | "network_error" | "runtime_unavailable" | "request_timed_out" | "provider_config_timeout" | "provider_stream_disconnected" | "provider_concurrency_limit" | "quota_or_rate_limit" | "process_exited" | "provider_error" | "unknown";
+interface AgentErrorPresentation {
+    /**
+     * i18n key for the one human sentence shown in the card, or null to let the
+     * caller fall back to its phase-aware generic title.
+     */
+    messageKey: string | null;
+    /**
+     * Env-panel section the remediation button deep-links to, or null when the
+     * failure is transient/server-side and the wizard cannot fix it — in which
+     * case no call-to-action is shown (showing one would misrepresent reality).
+     */
+    focus: AgentEnvPanelFocus | null;
+    /** i18n key for the remediation button. Only meaningful when `focus` is set. */
+    actionKey: string | null;
+}
+/**
+ * Resolves the card presentation for a run-failure code. Returns null for codes
+ * outside the known vocabulary so the caller renders its plain generic card with
+ * no call-to-action.
+ */
+declare function resolveAgentErrorPresentation(code: string | null | undefined): AgentErrorPresentation | null;
+/**
+ * Some providers (notably Claude Code) report an environment failure — e.g. a
+ * dropped login (401) — as a plain failed assistant message rather than a
+ * structured visibleError, so it never gets the remediation card. This recovers
+ * the env-fixable code from that message's text so the caller can still route the
+ * user to the wizard. Returns null when the text isn't a recognized env failure
+ * (so transient/unknown failures stay plain).
+ */
+declare function classifyFailedAgentMessage(body: string | null | undefined): AgentRunErrorCode | null;
+
+/**
+ * Frontend contract for the Codex setup progress stream surfaced on the agent
+ * provider status snapshot as `activeAction` (片3 progress-flow contract). The
+ * backend slice that populates this field has its own source of truth; the
+ * generated `AgentProviderStatus` type does not (yet) declare it, so the panel
+ * reads it defensively and degrades to detection-only state when it is absent.
+ */
+type CodexSetupStepStatus = "pending" | "running" | "ok" | "error" | "skipped";
+interface CodexSetupStep {
+    id: string;
+    label: string | null;
+    status: CodexSetupStepStatus;
+    detail: string | null;
+}
+type CodexSetupPhase = "detect" | "install" | "repair" | "verify" | "done" | "error";
+interface CodexSetupActiveActionError {
+    code: string | null;
+    message: string | null;
+}
+interface CodexSetupActiveAction {
+    phase: CodexSetupPhase;
+    steps: CodexSetupStep[];
+    registry: string | null;
+    log: string[];
+    error: CodexSetupActiveActionError | null;
+}
+/**
+ * Defensively reads the `activeAction` field off an AgentProviderStatus-like
+ * object. Returns null when the field is missing or malformed, which the panel
+ * treats as "no live setup action in progress".
+ */
+declare function readCodexSetupActiveAction(status: unknown): CodexSetupActiveAction | null;
+
+type AgentSetupStageId = "detect" | "network" | "install" | "adapter" | "login" | "ready";
+type StageDetailToken = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "version-floor";
+    current: string;
+    required: string;
+} | {
+    kind: "version-mismatch";
+    current: string;
+    required: string;
+};
+declare function reasonCodeIndicatesCliVersionUnsupported(reasonCode: string | null | undefined): boolean;
+interface AgentSetupStage {
+    id: AgentSetupStageId;
+    label: string;
+    status: CodexSetupStepStatus;
+    detail: StageDetailToken | null;
+    /**
+     * Optional explicit problem token for a blocked stage that can't be inferred
+     * from `status` alone. Today only the install stage sets it — when the codex
+     * launcher is present but its platform subpackage is missing, the stage is
+     * `pending` (the daemon repairs it via the install action) yet needs a distinct
+     * "platform package missing" problem rather than the generic "install-missing".
+     */
+    problem?: StageProblem;
+    authMethod?: string | null;
+}
+interface AgentSetupStageLabels {
+    detect: string;
+    network: string;
+    install: string;
+    adapter: string;
+    login: string;
+    ready: string;
+}
+interface DeriveAgentSetupStagesInput {
+    detected: boolean;
+    cliInstalled: boolean;
+    versionTooOld: boolean;
+    /**
+     * The codex CLI launcher is resolved but its platform-specific optional
+     * dependency subpackage (e.g. @openai/codex-darwin-arm64) is missing — the
+     * binary spawns ENOENT. The daemon repairs this in place via the install
+     * action, so the install stage is `pending` (not `ok`) with a distinct
+     * "platform package missing" problem token.
+     */
+    platformPackageIncomplete?: boolean;
+    adapterInstalled: boolean;
+    adapterVersionMismatch: boolean;
+    authenticated: boolean;
+    authRequired: boolean;
+    ready: boolean;
+    activePhase: CodexSetupPhase | null;
+    /**
+     * Whether the daemon-driven install action is in flight. This is the
+     * authoritative "installing" signal: the adapter (external-registry) installer
+     * emits no activeAction phase, so without this an in-progress adapter install
+     * would show no spinner.
+     */
+    installActionPending: boolean;
+    loginPending: boolean;
+    /**
+     * Active connectivity probe verdict: true (reachable), false (offline), or
+     * null when the daemon reported no network info (older daemon / not probed) —
+     * null is treated as "don't block".
+     */
+    networkReachable: boolean | null;
+    cliVersionDetail: StageDetailToken | null;
+    adapterDetail: StageDetailToken | null;
+    accountDetail: StageDetailToken | null;
+    authMethod: string | null;
+    networkDetail: StageDetailToken | null;
+    labels: AgentSetupStageLabels;
+}
+/**
+ * Maps primitive provider-status flags onto the fixed 5-stage track the wizard
+ * renders. Version verification folds into the install (CLI) stage (an
+ * unsupported version means install is `error`, not `ok`). The adapter stage
+ * covers the ACP adapter, which for some providers (e.g. claude-code) is a
+ * separate, slow npm install distinct from the CLI; for providers where the
+ * adapter is the CLI itself it simply tracks the CLI. Login `running` is driven
+ * by the caller's pending flag because login runs as a terminal action, not via
+ * the activeAction phase stream.
+ */
+declare function deriveAgentSetupStages(input: DeriveAgentSetupStagesInput): AgentSetupStage[];
+/**
+ * Step-by-step reveal: even when prerequisites are already satisfied, the wizard
+ * walks a cursor down the track so each stage visibly "checks off" one at a time
+ * instead of all flashing complete at once.
+ *
+ * `revealIndex` is the cursor position. Stages before it show their real status
+ * (already revealed). The stage AT the cursor is shown as `running` when its
+ * real status is terminal-ok (the brief "working on it" moment before it checks
+ * off) and otherwise shows its real status (so a genuinely running install, an
+ * error, or a blocked prerequisite are honest). Stages after the cursor are
+ * dimmed to `pending`.
+ */
+declare function projectRevealedStages(realStages: AgentSetupStage[], revealIndex: number): AgentSetupStage[];
+/**
+ * The reveal cursor advances past a stage only once that stage is really done
+ * (`ok`/`skipped`). It parks on a stage that is still `running` (a real install
+ * in progress), `error`, or `pending` (a blocked prerequisite) — so the
+ * animation never races ahead of reality.
+ */
+declare function shouldAdvanceReveal(realStages: AgentSetupStage[], revealIndex: number): boolean;
+type StageActionId = "install" | "login" | "redetect";
+/**
+ * The problem token a blocked stage represents. The UI maps this to "未xxx"
+ * copy; keeping it i18n-agnostic here lets the mapping stay tested without
+ * pulling translation strings into the pure flow module.
+ */
+type StageProblem = "network-unreachable" | "install-missing" | "install-outdated" | "install-platform-incomplete" | "adapter-missing" | "adapter-mismatch" | "login-missing";
+interface StageRemediation {
+    actionId: StageActionId;
+    problem: StageProblem;
+}
+/**
+ * For a stage the user must act on (idle `pending`/`error`, never `running` or
+ * `ok`), returns what is wrong and which action fixes it. `detect`/`ready` never
+ * carry their own remediation — they reflect prerequisites, not user actions.
+ *
+ * `error` means a version problem on the install/adapter stages (the only stages
+ * derive marks `error`); `pending` means the step simply has not run yet.
+ */
+declare function stageRemediation(stage: AgentSetupStage): StageRemediation | null;
+interface ResolveWizardAutoStartInput {
+    focus: AgentEnvPanelFocus | null;
+    detected: boolean;
+    ready: boolean;
+    installPending: boolean;
+    loginPending: boolean;
+}
+/**
+ * Decides whether opening the wizard with a remediation focus should auto-start
+ * an action. Returns the action id to run, or null when nothing should run
+ * (non-remediation focus, detection not settled, already ready, or already
+ * pending). The caller is responsible for firing this at most once per open.
+ */
+declare function resolveWizardAutoStartAction(input: ResolveWizardAutoStartInput): "install" | "login" | null;
+
+interface NetworkCheck {
+    kind: "registry" | "api" | "proxy";
+    reachable: boolean;
+    host: string | null;
+    configured?: boolean;
+}
+declare function deriveHasAnomaly(stages: AgentSetupStage[], activeActionError: CodexSetupActiveActionError | null): boolean;
+interface AgentEnvWizardViewModelInput {
+    provider: WorkspaceAgentProvider;
+    status: AgentProviderStatus | null;
+    isLoading: boolean;
+    activeAction: CodexSetupActiveAction | null;
+    installActionPending: boolean;
+    loginPending: boolean;
+    revealIndex: number;
+    stageLabels: AgentSetupStageLabels;
+}
+interface AgentEnvWizardViewModel {
+    ready: boolean;
+    busy: boolean;
+    redetecting: boolean;
+    displayStages: AgentSetupStage[];
+    blockingStageId: AgentSetupStageId | null;
+    networkChecks: NetworkCheck[];
+    hasAnomaly: boolean;
+    activePhase: CodexSetupPhase | null;
+    log: string[];
+    registry: string | null;
+    error: CodexSetupActiveActionError | null;
+    manualCommand: string | null;
+    installPending: boolean;
+    loginPending: boolean;
+}
+declare function buildAgentEnvWizardViewModel(input: AgentEnvWizardViewModelInput): AgentEnvWizardViewModel;
+
+export { type AgentEnvPanelFocus, type AgentEnvPanelRequest, type AgentEnvWizardViewModel, type AgentEnvWizardViewModelInput, type AgentErrorPresentation, type AgentRunErrorCode, type AgentSetupStage, type AgentSetupStageId, type AgentSetupStageLabels, type CodexSetupActiveAction, type CodexSetupActiveActionError, type CodexSetupPhase, type CodexSetupStep, type CodexSetupStepStatus, type DeriveAgentSetupStagesInput, type NetworkCheck, type OpenAgentEnvPanelInput, type ResolveWizardAutoStartInput, type StageActionId, type StageDetailToken, type StageProblem, type StageRemediation, buildAgentEnvWizardViewModel, classifyFailedAgentMessage, closeAgentEnvPanel, deriveAgentSetupStages, deriveHasAnomaly, getAgentEnvPanelStore, openAgentEnvPanel, projectRevealedStages, readCodexSetupActiveAction, reasonCodeIndicatesCliVersionUnsupported, resolveAgentErrorPresentation, resolveWizardAutoStartAction, shouldAdvanceReveal, stageRemediation, useAgentEnvPanelRequest };