@abot-ai/runtime 1.3.0 → 1.4.0

package/dist/src/web-ui/app/components/runtime-setup/plugins.js

@@ -0,0 +1,173 @@
+import { escapeAttribute, escapeHtml } from "../../lib/text-format.js";
+
+function blockReason(plugin, capability) {
+  if (capability?.blockedReason) return capability.blockedReason;
+  if (plugin.blockedByGlobalPolicy)
+    return "Blocked by the global plugin policy.";
+  if (capability && plugin.pluginEnabled === false)
+    return "Enable this plugin to choose individual tools.";
+  return capability?.blockedByPolicy
+    ? "Blocked by an existing plugin policy rule."
+    : "";
+}
+
+function checkbox(plugin, capability, busy) {
+  const reason = blockReason(plugin, capability);
+  const enabled = capability
+    ? capability.enabled === true
+    : plugin.pluginEnabled === true;
+  const id = capability?.id || plugin.id;
+  const description = capability?.description || "";
+  const version =
+    !capability && plugin.version
+      ? `<small class="runtime-plugin-version">v${escapeHtml(plugin.version)}</small>`
+      : "";
+  return `<label class="runtime-plugin-choice${capability ? "" : " runtime-plugin-master"}">
+    <input type="checkbox" data-runtime-plugin-toggle="${escapeAttribute(plugin.id)}" ${capability ? `data-runtime-capability="${escapeAttribute(capability.id)}"` : ""} ${enabled && !reason ? "checked" : ""} ${busy || reason ? "disabled" : ""} />
+    <span><strong>${escapeHtml(id)}</strong>${version}${description ? `<small class="runtime-plugin-description" title="${escapeAttribute(description)}">${escapeHtml(description)}</small>` : ""}${reason ? `<small class="runtime-plugin-block">${escapeHtml(reason)}</small>` : ""}</span>
+  </label>`;
+}
+
+function renderPluginCard(plugin, busy) {
+  const capabilities = plugin.capabilities || [];
+  return `<li class="runtime-plugin-card">
+    ${checkbox(plugin, null, busy)}
+    <p class="runtime-plugin-summary" title="${escapeAttribute(plugin.description || "")}">${escapeHtml(plugin.description || "Installed Runtime plugin.")}</p>
+    <div class="runtime-plugin-tools-heading"><span>Tools</span><span>${plugin.selectedCapabilityCount} of ${capabilities.length} selected</span></div>
+    <ul class="runtime-plugin-capabilities" aria-label="${escapeAttribute(`Tools in ${plugin.id}`)}">${capabilities.map((capability) => `<li>${checkbox(plugin, capability, busy)}</li>`).join("")}</ul>
+  </li>`;
+}
+
+export function createSetupPluginStep({
+  container,
+  getEnvironmentId,
+  loadPlugins,
+  setPlugin,
+  onChange,
+}) {
+  const state = {
+    snapshot: null,
+    loaded: false,
+    busy: false,
+    error: "",
+    message: "",
+  };
+  let generation = 0;
+  let focusTarget = null;
+  const isCurrentPluginOperation = (revision, environment) =>
+    revision === generation && environment === getEnvironmentId();
+
+  function reset() {
+    generation += 1;
+    focusTarget = null;
+    Object.assign(state, {
+      snapshot: null,
+      loaded: false,
+      busy: false,
+      error: "",
+      message: "",
+    });
+  }
+
+  async function load(force = false) {
+    if ((!force && state.loaded) || state.busy) return;
+    const revision = ++generation;
+    const environment = getEnvironmentId();
+    state.busy = true;
+    state.error = "";
+    onChange();
+    try {
+      const snapshot = await loadPlugins();
+      if (!isCurrentPluginOperation(revision, environment)) return;
+      state.snapshot = snapshot;
+      state.loaded = true;
+    } catch {
+      if (isCurrentPluginOperation(revision, environment))
+        state.error = "Could not load plugins. Try again before continuing.";
+    } finally {
+      if (isCurrentPluginOperation(revision, environment)) {
+        state.busy = false;
+        onChange();
+      }
+    }
+  }
+
+  async function toggle(target) {
+    if (state.busy) return;
+    const pluginId = target.dataset.runtimePluginToggle;
+    const capabilityId = target.dataset.runtimeCapability;
+    const plugin = state.snapshot?.plugins?.find(
+      (entry) => entry.id === pluginId,
+    );
+    const capability = capabilityId
+      ? plugin?.capabilities?.find((entry) => entry.id === capabilityId)
+      : null;
+    if (
+      !plugin ||
+      (capabilityId && !capability) ||
+      blockReason(plugin, capability)
+    )
+      return;
+    const enabled = target.checked === true;
+    const revision = ++generation;
+    const environment = getEnvironmentId();
+    focusTarget = { pluginId, capabilityId };
+    state.busy = true;
+    state.error = "";
+    state.message = "";
+    onChange();
+    try {
+      const snapshot = await setPlugin({
+        pluginId,
+        enabled,
+        ...(capabilityId ? { capabilityId } : {}),
+      });
+      if (!isCurrentPluginOperation(revision, environment)) return;
+      state.snapshot = snapshot;
+      state.message =
+        "Selection saved. It will take effect when you finish setup.";
+    } catch {
+      if (isCurrentPluginOperation(revision, environment))
+        state.error =
+          "Could not save this selection. Your previous selection is still shown. Try again.";
+    } finally {
+      if (isCurrentPluginOperation(revision, environment)) {
+        state.busy = false;
+        onChange();
+      }
+    }
+  }
+
+  function markup() {
+    const plugins = state.snapshot?.plugins || [];
+    const globalBlocked =
+      state.snapshot?.selection?.enabled === false ||
+      state.snapshot?.selection?.deny?.includes("*");
+    return `<div class="runtime-setup-plugins">
+      <p class="runtime-setup-feedback">All installed plugins start enabled in a new setup. Turn off anything you do not need.</p>
+      ${globalBlocked ? '<p class="runtime-setup-feedback">An existing global policy blocks plugins. Your saved policy is preserved.</p>' : ""}
+      ${state.error ? `<p class="runtime-setup-feedback error" role="alert">${escapeHtml(state.error)}</p><button type="button" class="runtime-setup-inline-action" data-runtime-setup-action="plugins-reload">Reload selection</button>` : state.message ? `<p class="runtime-setup-feedback" role="status">${escapeHtml(state.message)}</p>` : ""}
+      ${state.busy ? '<p class="runtime-setup-feedback" role="status">Saving or loading plugin selection…</p>' : ""}
+      <ul class="runtime-plugin-list">${plugins.map((plugin) => renderPluginCard(plugin, state.busy)).join("")}</ul>
+      ${state.loaded && !plugins.length ? '<p class="runtime-setup-feedback">No installed plugins found. You can add plugins later.</p>' : ""}
+    </div>`;
+  }
+
+  function afterPaint({ restoreFocus = true } = {}) {
+    for (const input of container.querySelectorAll?.(
+      "[data-runtime-plugin-toggle]",
+    ) || []) {
+      input.addEventListener("change", () => void toggle(input));
+      if (
+        restoreFocus &&
+        !state.busy &&
+        focusTarget?.pluginId === input.dataset.runtimePluginToggle &&
+        focusTarget?.capabilityId === input.dataset.runtimeCapability
+      )
+        input.focus?.({ preventScroll: true });
+    }
+    if (!state.busy) focusTarget = null;
+  }
+
+  return { state, reset, load, markup, afterPaint, toggle };
+}

package/dist/src/web-ui/app/components/runtime-setup/rendering.js

@@ -0,0 +1,141 @@
+import { escapeHtml } from "../../lib/text-format.js";
+import { formatContextWindowTokens } from "./context-window.js";
+import {
+  canEditSetupConnection,
+  setupConnectionSubmitLabel,
+} from "./connection-state.js";
+import {
+  renderProviderChoices,
+  renderConnectionFields,
+} from "./connection-form.js";
+import { renderWizardShell } from "./wizard-shell.js";
+
+const STEP_LABELS = ["Provider", "Connection", "Embedding", "Plugins", "Ready"];
+
+function readyMarkup(state, optional) {
+  const applied = state.finishAttempted && state.activation?.status === "ready";
+  const message = applied
+    ? "Your setup is applied. Continue to your first conversation."
+    : state.finishAttempted
+      ? state.activation?.message ||
+        "Your settings are saved. Try again when your agent is idle."
+      : "Apply your choices to start your first conversation.";
+  const selectedPlugins = (optional.plugins?.plugins || []).filter(
+    (plugin) => plugin.pluginEnabled,
+  ).length;
+  return `<div class="runtime-setup-result"><p>${escapeHtml(message)}</p><dl>
+    <div><dt>Provider</dt><dd>${escapeHtml(state.providers.find((provider) => provider.id === state.provider)?.label || state.provider)}</dd></div>
+    <div><dt>Model</dt><dd>${escapeHtml(state.modelId)}</dd></div>
+    <div><dt>Context window</dt><dd>${escapeHtml(formatContextWindowTokens(state.contextWindowTokens))}</dd></div>
+    <div><dt>Embedding</dt><dd>${escapeHtml(optional.memory?.enabled ? optional.memory.model || "Configured" : "Set up later")}</dd></div>
+    <div><dt>Plugins</dt><dd>${selectedPlugins} enabled</dd></div>
+  </dl></div>`;
+}
+
+function statusMarkup(state, availability) {
+  if (state.error)
+    return `<p class="runtime-setup-feedback error" id="runtimeSetupError" role="alert">${escapeHtml(state.error)}</p>`;
+  if (state.loading)
+    return '<p class="runtime-setup-feedback" role="status">Loading connection options…</p>';
+  if (state.applying)
+    return '<p class="runtime-setup-feedback" role="status">Applying your connection…</p>';
+  if (state.saving)
+    return '<p class="runtime-setup-feedback" role="status">Saving your connection…</p>';
+  if (availability.status === "checking")
+    return '<p class="runtime-setup-feedback" role="status">Checking the model catalog…</p>';
+  if (availability.status === "error")
+    return `<p class="runtime-setup-feedback error" role="alert">Could not check the model catalog. ${escapeHtml(availability.message || "Try again.")}</p>`;
+  return "";
+}
+
+function footerMarkup(state, availability, optional) {
+  const busy =
+    state.loading ||
+    state.saving ||
+    state.applying ||
+    optional.busy ||
+    availability.status === "checking";
+  const disabled = busy ? "disabled" : "";
+  if (state.step === (optional.readyStep ?? 4)) {
+    const action =
+      state.finishAttempted && state.activation?.status === "ready"
+        ? "check"
+        : "apply";
+    const label = state.applying
+      ? "Applying…"
+      : action === "check"
+        ? "Start chatting"
+        : state.finishAttempted
+          ? "Try again"
+          : "Finish setup";
+    const back =
+      action === "check"
+        ? "<span></span>"
+        : `<button type="button" class="runtime-setup-secondary" data-runtime-setup-action="back" ${disabled}>Back</button>`;
+    return `${back}<button type="button" class="runtime-setup-action" data-runtime-setup-action="${action}" ${disabled}>${label}</button>`;
+  }
+  if (state.step === 2)
+    return `<button type="button" class="runtime-setup-secondary" data-runtime-setup-action="back" ${disabled}>Back</button><div class="runtime-setup-footer-actions"><button type="button" class="runtime-setup-secondary" data-runtime-setup-action="skip-embedding" ${disabled}>Skip for now</button><button type="submit" class="runtime-setup-action" ${busy || !optional.canContinue ? "disabled" : ""}>${optional.busy ? "Checking…" : optional.primaryLabel}</button></div>`;
+  if (state.step === 3)
+    return `<button type="button" class="runtime-setup-secondary" data-runtime-setup-action="back" ${disabled}>Back</button><button type="submit" class="runtime-setup-action" ${busy || !optional.canContinue ? "disabled" : ""}>Continue</button>`;
+  if (state.step === 4 && optional.hasComputerStep)
+    return `<button type="button" class="runtime-setup-secondary" data-runtime-setup-action="back">Back</button><div class="runtime-setup-footer-actions"><button type="button" class="runtime-setup-secondary" data-runtime-setup-action="skip-computer">Skip for now</button><button type="submit" class="runtime-setup-action" ${!optional.canContinue ? "disabled" : ""}>Continue</button></div>`;
+  const secondary =
+    state.step === 1 && canEditSetupConnection(state)
+      ? `<button type="button" class="runtime-setup-secondary" data-runtime-setup-action="back" ${disabled}>Back</button>`
+      : `<button type="button" class="runtime-setup-secondary" data-runtime-setup-action="check" ${disabled}>${availability.status === "checking" ? "Checking…" : "Check existing setup"}</button>`;
+  if (state.loadFailed)
+    return `${secondary}<button type="button" class="runtime-setup-action" data-runtime-setup-action="reload" ${disabled}>Try again</button>`;
+  const nextDisabled = busy || (state.step === 0 && !state.provider);
+  return `${secondary}<button type="submit" class="runtime-setup-action" ${nextDisabled ? "disabled" : ""}>${state.saving ? "Saving…" : state.step === 0 ? "Continue" : setupConnectionSubmitLabel(state)}</button>`;
+}
+
+export function renderRuntimeSetup(state, availability, optional = {}) {
+  const titles = [
+    "Connect your first model",
+    "Connection details",
+    "Add embedding",
+    "Choose your plugins",
+    state.finishAttempted && state.activation?.status === "ready"
+      ? "You're ready"
+      : "Ready to finish",
+  ];
+  const descriptions = [
+    "Choose where your model runs.",
+    state.provider === "ollama"
+      ? "Connect ABot to your Ollama server."
+      : "Connect ABot to your OpenAI account.",
+    "Optional. Enable long-term memory with an embedding model, or set it up later.",
+    "Choose what your agent can use. You can change these choices later in Settings.",
+    "",
+  ];
+  const steps = [...STEP_LABELS];
+  if (optional.hasComputerStep) {
+    steps.splice(4, 0, "Computer");
+    titles.splice(4, 0, "Set up computer access");
+    descriptions.splice(
+      4,
+      0,
+      "Optional. Use applications on your computer, or set up access later in Settings.",
+    );
+  }
+  const content =
+    state.step === 0
+      ? renderProviderChoices(state)
+      : state.step === 1
+        ? renderConnectionFields(state)
+        : state.step === (optional.readyStep ?? 4)
+          ? readyMarkup(state, optional)
+          : optional.content;
+  const busy = state.loading || state.saving || state.applying || optional.busy;
+  return renderWizardShell({
+    steps,
+    step: state.step,
+    title: titles[state.step],
+    description: descriptions[state.step],
+    busy,
+    panelClass: state.step === 3 ? "runtime-setup-panel--plugins" : "",
+    content: `${content}${statusMarkup(state, availability)}`,
+    footer: footerMarkup(state, availability, optional),
+  });
+}

package/dist/src/web-ui/app/components/runtime-setup/validation.js

@@ -0,0 +1,69 @@
+import { textOf } from "../../lib/text-format.js";
+
+const PROVIDERS = new Set(["ollama", "openai"]);
+const SAFE_MODEL_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_@+.:/=-]*$/;
+const SAFE_ORIGIN_HOST_PATTERN =
+  /^(?:\[[0-9A-Fa-f:.]+\]|[A-Za-z0-9._-]+)(?::[0-9]+)?$/;
+export const DEFAULT_OLLAMA_BASE_URL = "http://127.0.0.1:11434";
+
+export function normalizeProvider(value) {
+  const provider = textOf(value).trim().toLowerCase();
+  return PROVIDERS.has(provider) ? provider : "";
+}
+
+export function validateRuntimeSetupModelId(value) {
+  const modelId = textOf(value);
+  if (!modelId.trim()) {
+    return { valid: false, value: "", message: "Enter a model ID." };
+  }
+  if (modelId.startsWith("--")) {
+    return {
+      valid: false,
+      value: "",
+      message: "Model ID cannot start with --.",
+    };
+  }
+  if (!SAFE_MODEL_ID_PATTERN.test(modelId)) {
+    return {
+      valid: false,
+      value: "",
+      message:
+        "Start with a letter or number. After that, use only letters, numbers, and _ @ + . : / = -.",
+    };
+  }
+  return { valid: true, value: modelId, message: "" };
+}
+
+function baseUrlIsPlainHttpOrigin(parsed) {
+  if (!["http:", "https:"].includes(parsed.protocol)) return false;
+  if (!SAFE_ORIGIN_HOST_PATTERN.test(parsed.host)) return false;
+  if (parsed.username || parsed.password) return false;
+  if (parsed.search || parsed.hash) return false;
+  return parsed.pathname === "" || parsed.pathname === "/";
+}
+
+export function validateRuntimeSetupBaseUrl(value) {
+  const raw = textOf(value).trim();
+  let parsed;
+  try {
+    parsed = new URL(raw);
+  } catch {
+    return {
+      valid: false,
+      value: "",
+      message: "Enter an HTTP or HTTPS origin without a path.",
+    };
+  }
+  if (!baseUrlIsPlainHttpOrigin(parsed)) {
+    return {
+      valid: false,
+      value: "",
+      message: "Enter an HTTP or HTTPS origin without a path.",
+    };
+  }
+  return {
+    valid: true,
+    value: `${parsed.protocol}//${parsed.host}`,
+    message: "",
+  };
+}

package/dist/src/web-ui/app/components/runtime-setup/view-state.js

@@ -0,0 +1,58 @@
+export function createSetupViewState(container) {
+  let focusIdentity = null;
+  let focusIsOutside = false;
+  let scrollTop = 0;
+  const scroller = () =>
+    container.closest?.(".home-workspace-panel") || container;
+
+  function capture() {
+    scrollTop = scroller().scrollTop;
+    const active = container.ownerDocument?.activeElement;
+    if (!active) {
+      focusIsOutside = false;
+      return;
+    }
+    const focusIsOnPage =
+      active === container.ownerDocument.body ||
+      active === container.ownerDocument.documentElement;
+    focusIsOutside = !focusIsOnPage && !container.contains?.(active);
+    if (focusIsOutside) {
+      focusIdentity = null;
+      return;
+    }
+    if (focusIsOnPage) return;
+    if (active.dataset?.runtimeSetupField)
+      focusIdentity = { field: active.dataset.runtimeSetupField };
+    else if (active.dataset?.runtimeSetupAction)
+      focusIdentity = { action: active.dataset.runtimeSetupAction };
+    else if (active.hasAttribute?.("data-runtime-setup-title"))
+      focusIdentity = { title: true };
+    else if (active.type === "submit") focusIdentity = { submit: true };
+    else focusIdentity = null;
+  }
+
+  function restore({ focus = false, busy = false } = {}) {
+    scroller().scrollTop = focus ? 0 : scrollTop;
+    if (focus && !focusIsOutside) focusIdentity = { title: true };
+    if (focusIsOutside || (busy && !focus) || !focusIdentity) return;
+    let selector = "[data-runtime-setup-title]";
+    if (focusIdentity.field)
+      selector = `[data-runtime-setup-field="${focusIdentity.field}"]`;
+    if (focusIdentity.action)
+      selector = `[data-runtime-setup-action="${focusIdentity.action}"]`;
+    if (focusIdentity.submit) selector = '.runtime-setup-action[type="submit"]';
+    const target = container.querySelector(selector);
+    if (!target?.disabled) target?.focus?.({ preventScroll: true });
+  }
+
+  return {
+    capture,
+    restore,
+    canRestoreFocus: () => !focusIsOutside,
+    reset: () => {
+      focusIdentity = null;
+      focusIsOutside = false;
+      scrollTop = 0;
+    },
+  };
+}

package/dist/src/web-ui/app/components/runtime-setup/wizard-shell.js

@@ -0,0 +1,27 @@
+import { escapeAttribute, escapeHtml } from "../../lib/text-format.js";
+
+export function renderWizardProgress(steps, step) {
+  return `<ol class="runtime-setup-progress" aria-label="Setup progress" style="grid-template-columns:repeat(${steps.length},minmax(0,1fr))">${steps.map((label, index) => `<li ${index === step ? 'aria-current="step"' : ""} class="${index < step ? "complete" : ""}"><span aria-hidden="true">${index + 1}</span><span class="runtime-setup-progress-label">${escapeHtml(label)}</span></li>`).join("")}</ol>`;
+}
+
+export function renderWizardShell({
+  steps,
+  step,
+  title,
+  description = "",
+  content,
+  footer,
+  busy = false,
+  panelClass = "",
+  form = true,
+  idPrefix = "runtimeSetup",
+}) {
+  const tag = form ? "form" : "section";
+  return `<${tag} class="runtime-setup-panel${panelClass ? ` ${escapeAttribute(panelClass)}` : ""}" ${form ? "novalidate" : ""} aria-busy="${Boolean(busy)}" aria-labelledby="${escapeAttribute(idPrefix)}Title">
+    <div data-wizard-progress>${renderWizardProgress(steps, step)}</div>
+    <p class="runtime-setup-mobile-progress" data-wizard-mobile-progress aria-hidden="true">Step ${step + 1} of ${steps.length} · ${escapeHtml(steps[step])}</p>
+    <header class="runtime-setup-heading"><h3 tabindex="-1" id="${escapeAttribute(idPrefix)}Title" data-runtime-setup-title>${escapeHtml(title)}</h3><p data-wizard-description ${description ? "" : "hidden"}>${escapeHtml(description)}</p></header>
+    <div class="runtime-setup-content" data-wizard-content ${busy ? "inert" : ""}>${content}</div>
+    <footer class="runtime-setup-footer" data-wizard-footer>${footer}</footer>
+  </${tag}>`;
+}

package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts

@@ -1,23 +1,82 @@
+import type { SetupEmbeddingInput } from "../../local-runtime/setup-embedding-input.js";
+
 export type RuntimeSetupValidation = Readonly<{
   valid: boolean;
   value: string;
   message: string;
 }>;
-
 export type RuntimeSetupCommands = Readonly<{
   "ollama-pull": string;
   setup: string;
   "model-gateway": string;
   "web-ui": string;
 }>;
-
+export type RuntimeSetupProvider = Readonly<{
+  id: "openai" | "ollama";
+  label: string;
+  requiresApiKey: boolean;
+  credentialConfigured: boolean;
+}>;
+export type RuntimeSetupSnapshot = Readonly<{
+  status: "required" | "ready";
+  providers: readonly RuntimeSetupProvider[];
+  configExists: boolean;
+  recovery?: "configuration";
+  message?: string;
+  defaultContextWindowTokens: number;
+  editableConnection?: { revision: string };
+  existingModel?: {
+    provider: "openai" | "ollama";
+    model: string;
+    contextWindowTokens?: number;
+    baseUrl?: string;
+  };
+}>;
+export type RuntimeSetupInput = {
+  provider: "openai" | "ollama";
+  model: string;
+  contextWindowTokens?: number;
+  baseUrl?: string;
+  apiKey?: string;
+  deferActivation?: boolean;
+  connectionRevision?: string;
+};
+export type RuntimeSetupResponse = {
+  setup: RuntimeSetupSnapshot;
+  activation: { status: "ready" | "restart_required"; message?: string };
+  embeddingInvalidated?: boolean;
+};
 export interface RuntimeSetupGuideDependencies {
   readonly container: HTMLElement;
   readonly conversationRegion: HTMLElement;
-  readonly copyText?: (value: string) => void | Promise<void>;
-  readonly getSetupCommandMode?: () => "source" | "package" | undefined;
+  readonly loadSetup: () => Promise<{ setup: RuntimeSetupSnapshot }>;
+  readonly applySetup: () => Promise<{
+    activation: RuntimeSetupResponse["activation"];
+  }>;
+  readonly saveSetup: (
+    input: RuntimeSetupInput,
+  ) => Promise<RuntimeSetupResponse>;
+  readonly loadEmbeddingStatus: () => Promise<Record<string, unknown>>;
+  readonly discoverEmbeddingModels: (
+    providerId: string,
+  ) => Promise<Record<string, unknown>>;
+  readonly saveEmbedding: (
+    input: SetupEmbeddingInput,
+  ) => Promise<Record<string, unknown>>;
+  readonly loadPlugins: () => Promise<Record<string, unknown>>;
+  readonly setPlugin: (input: {
+    pluginId: string;
+    capabilityId?: string;
+    enabled: boolean;
+  }) => Promise<Record<string, unknown>>;
+  readonly getEnvironmentId?: () => string;
+  readonly loadHostConnection?: () => Promise<Record<string, unknown>>;
+  readonly downloadHostSetup?: (
+    platform: "windows" | "macos",
+  ) => Promise<Record<string, unknown>>;
+  readonly revokeHostConnection?: () => Promise<Record<string, unknown>>;
+  readonly openConfiguration?: () => void;
 }
-
 export declare function validateRuntimeSetupModelId(
   value: unknown,
 ): RuntimeSetupValidation;
@@ -34,6 +93,8 @@ export declare function createRuntimeSetupGuide(
   options: RuntimeSetupGuideDependencies,
 ): {
   bind(options?: { onCheckAgain?: () => void | Promise<void> }): void;
+  clearSecret(): void;
+  dispose(): void;
   focusAction(): void;
   render(setup: Record<string, unknown>): void;
 };