feat(providers): make bundled Hoplite opt-in from the catalog

Keep the contributor ACP adapter and provisioning progress while activating it only when a provider config entry exists. Removing the entry removes membership across restarts; existing provider defaults remain unchanged.

Present the Add provider catalog as a searchable grid and gate Hoplite activation on host support.

Co-authored-by: Odin Glynn-Martin <odin.glynn@icloud.com>

plugins/hoplite-provider/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="1.394 1.679 8.494 7.828" fill="currentColor"><path d="M8.237 7.813C8.276 7.789 8.327 7.796 8.358 7.83L9.741 9.346C9.797 9.407 9.754 9.506 9.671 9.507H8.977C8.924 9.507 8.881 9.463 8.881 9.41V9.125C8.881 9.089 8.861 9.057 8.83 9.04L7.589 8.379C7.524 8.344 7.521 8.251 7.584 8.212L8.237 7.813ZM3.944 1.679C4.502 1.679 5.052 1.82 5.54 2.09L5.962 2.323C6.024 2.358 6.029 2.446 5.97 2.486L5.091 3.09C5.065 3.108 5.05 3.137 5.05 3.169V3.495C5.05 3.529 5.032 3.561 5.003 3.578L4.68 3.769C4.594 3.82 4.498 3.722 4.549 3.637L4.592 3.566C4.63 3.502 4.584 3.421 4.51 3.421H4.028C3.925 3.421 3.894 3.562 3.989 3.604L4.377 3.775C4.448 3.806 4.455 3.904 4.389 3.944L3.77 4.323C3.755 4.332 3.737 4.337 3.72 4.337H3.361C3.309 4.337 3.268 4.379 3.268 4.431C3.268 4.484 3.309 4.526 3.361 4.526H3.779C3.797 4.526 3.814 4.521 3.829 4.513L7.599 2.272C8.135 1.954 8.815 2.008 9.294 2.407C9.307 2.418 9.314 2.434 9.314 2.451V2.729C9.315 2.812 9.413 2.856 9.475 2.8L9.728 2.57C9.789 2.514 9.888 2.558 9.888 2.641V5.812C9.888 5.865 9.845 5.908 9.792 5.908H9.359C9.331 5.908 9.303 5.895 9.285 5.873L8.374 4.773C8.337 4.728 8.268 4.728 8.229 4.771L7.468 5.625C7.429 5.669 7.438 5.737 7.487 5.769L9.038 6.776C9.098 6.815 9.096 6.903 9.035 6.939L6.618 8.363C6.556 8.4 6.478 8.358 6.474 8.286L6.439 7.633C6.437 7.578 6.48 7.532 6.535 7.532H6.925C6.948 7.532 6.971 7.523 6.988 7.508L7.211 7.31C7.276 7.252 7.236 7.144 7.148 7.142L5.991 7.118H1.49C1.437 7.118 1.394 7.075 1.394 7.022V3.308C1.394 3.255 1.437 3.212 1.49 3.212H2.544C2.597 3.212 2.64 3.169 2.64 3.116V2.969C2.64 2.916 2.597 2.873 2.544 2.873H1.461C1.366 2.873 1.329 2.75 1.408 2.697L2.134 2.221C2.672 1.867 3.301 1.679 3.944 1.679Z"/></svg>

plugins/hoplite-provider/index.server.ts

@@ -0,0 +1,7 @@
+import type { PluginServerContext } from "@getpaseo/plugin/server";
+import { createHopliteProvider } from "./server/provider.js";
+
+export default function contribute(server: PluginServerContext) {
+  server.registerProvider(createHopliteProvider());
+  return () => {};
+}

plugins/hoplite-provider/paseo-plugin.json

@@ -0,0 +1 @@
+{ "id": "hoplite-provider", "requirements": { "paseo": ">=0.11.0" } }

plugins/hoplite-provider/server/provider.ts

@@ -0,0 +1,17 @@
+import { runAcpProvider } from "@getpaseo/plugin/server/acp";
+import type { ProviderRegistration } from "@getpaseo/plugin/server/provider";
+import { runPhaseTransformer } from "./run-phase.js";
+
+export function createHopliteProvider(): ProviderRegistration {
+  return {
+    requiresConfiguration: true,
+    ...runAcpProvider({
+      id: "hoplite",
+      label: "Hoplite",
+      description: "Hoplite's coding agent through the local `hoplite acp` bridge",
+      icon: "icon.svg",
+      command: ["hoplite", "acp"],
+      transformers: [runPhaseTransformer],
+    }),
+  };
+}

plugins/hoplite-provider/server/run-phase.test.ts

@@ -0,0 +1,74 @@
+import { describe, expect, it } from "vitest";
+import { runPhaseTransformer } from "./run-phase.js";
+
+const context = { sessionId: "session-1" };
+
+// Frames captured from `hoplite acp` 3.0.0.
+function runPhase(phase: string | null, label: string | null) {
+  return {
+    method: "_hoplite/run_phase",
+    params: {
+      sessionId: "thr_c75d39f7d7624256af918eeee2f4941b",
+      runId: "run_eb213b97bd3147afb2927fbc27f87180",
+      phase,
+      label,
+      startedAt: phase === null ? null : "2026-10-04T17:51:46.311Z",
+    },
+  };
+}
+
+describe("runPhaseTransformer", () => {
+  it("shows a provisioning phase as one running workspace item per run", () => {
+    const update = runPhaseTransformer.notification?.(
+      runPhase("fetching_repository", "Cloning repository"),
+      context,
+    );
+
+    expect(update).toEqual({
+      type: "timeline",
+      item: {
+        type: "tool_call",
+        id: "hoplite-run-phase:run_eb213b97bd3147afb2927fbc27f87180",
+        callId: "hoplite-run-phase:run_eb213b97bd3147afb2927fbc27f87180",
+        name: "Hoplite workspace",
+        detail: { type: "plain_text", label: "Cloning repository", icon: "wrench" },
+        status: "running",
+        error: null,
+      },
+    });
+  });
+
+  it("completes the same item when the run leaves provisioning", () => {
+    const update = runPhaseTransformer.notification?.(runPhase(null, null), context);
+
+    expect(update).toMatchObject({
+      type: "timeline",
+      item: {
+        id: "hoplite-run-phase:run_eb213b97bd3147afb2927fbc27f87180",
+        status: "completed",
+        detail: { label: "Workspace ready" },
+      },
+    });
+  });
+
+  it("falls back to the phase name when Hoplite sends no label", () => {
+    const update = runPhaseTransformer.notification?.(
+      runPhase("configuring_workspace", null),
+      context,
+    );
+
+    expect(update).toMatchObject({ item: { detail: { label: "configuring_workspace" } } });
+  });
+
+  it("ignores other vendor notifications and malformed phases", () => {
+    expect(
+      runPhaseTransformer.notification?.({ method: "_hoplite/other", params: {} }, context),
+    ).toBeNull();
+    expect(
+      runPhaseTransformer.notification?.(
+        { method: "_hoplite/run_phase", params: { phase: "x" } },
+        context,
+      ),
+    ).toBeNull();
+  });
+});

plugins/hoplite-provider/server/run-phase.ts

@@ -0,0 +1,39 @@
+import type { AcpTransformer } from "@getpaseo/plugin/server/acp";
+import { z } from "zod";
+
+// Hoplite provisions a cloud workspace before the first agent output of a run and reports each
+// step as `_hoplite/run_phase`. A null phase ends provisioning for that run.
+const runPhaseSchema = z.object({
+  runId: z.string().min(1),
+  phase: z.string().nullable(),
+  label: z.string().nullable(),
+});
+
+const RUN_PHASE_METHOD = "_hoplite/run_phase";
+
+export const runPhaseTransformer: AcpTransformer = {
+  notification(notification) {
+    if (notification.method !== RUN_PHASE_METHOD) return null;
+    const params = runPhaseSchema.safeParse(notification.params);
+    if (!params.success) return null;
+    const { runId, phase, label } = params.data;
+    const id = `hoplite-run-phase:${runId}`;
+    const running = phase !== null;
+    return {
+      type: "timeline",
+      item: {
+        type: "tool_call",
+        id,
+        callId: id,
+        name: "Hoplite workspace",
+        detail: {
+          type: "plain_text",
+          label: running ? (label ?? phase) : "Workspace ready",
+          icon: "wrench",
+        },
+        status: running ? "running" : "completed",
+        error: null,
+      },
+    };
+  },
+};