@korso/shepherd-ui 0.1.0

package/dist/lib/index.d.ts

@@ -0,0 +1,306 @@
+import { ReactElement } from 'react';
+import { ReactNode } from 'react';
+import { z } from 'zod';
+
+/**
+ * Builds a browser fetch client for the Shepherd hub with exactly two methods.
+ * Each call wires up an AbortController timeout (cleared in `finally`), merges
+ * the injected auth headers over a JSON content-type base, and Zod-parses ONLY
+ * the response at the boundary — the request body is forwarded verbatim because
+ * the caller owns its input shape.
+ *
+ * @param config - Base URL, optional injected auth, 401 hook, and timeout.
+ * @returns A {@link ShepherdClient}.
+ */
+export declare function createShepherdClient(config: ShepherdClientConfig): ShepherdClient;
+
+/**
+ * The Shepherd wallboard shell. Composes {@link useLandscapePolling} (which reads
+ * the client from context, keeping this auth-agnostic) with the six leaf
+ * components, owning only the UI state app.js kept in module variables:
+ *
+ *  - `activeTab` — persisted to `"shepherd.tab"` (default `"tasks"`).
+ *  - `selectedRepo` — persisted to `"shepherd.repo"`; `null` derives a default on
+ *    the first render with >=2 repos (see {@link resolveSelectedRepo}).
+ *  - `doneShown` — the history page size, grown a page at a time by "Load older".
+ *
+ * Header chrome mirrors app.js: brand, the repo filter, vitals (online/active
+ * counts under the current filter), the poll status indicator, a freshness
+ * string, and the tab strip. The body shows the Tasks panel (crew + active +
+ * done) or the Chat panel (feed + composer); the composer's post-send hook is the
+ * polling hook's `refresh`, so a sent message shows up immediately.
+ *
+ * Renders the header even before the first snapshot arrives so the board never
+ * blanks — the panels simply render their own empty states off an empty
+ * landscape.
+ *
+ * @returns The dashboard element.
+ */
+export declare function Dashboard(): ReactElement;
+
+/** Props for {@link Dashboard}. Currently empty — the client comes from context. */
+export declare type DashboardProps = Record<string, never>;
+
+/**
+ * The wallboard's two read/write operations against the Shepherd hub. Responses
+ * are Zod-parsed at the boundary so callers receive contract-typed values.
+ */
+export declare interface ShepherdClient {
+    /** GET the unfiltered whole-workspace view (agents, tasks, announcements). */
+    getLandscape(): Promise<WorkspaceLandscapeResponseT>;
+    /** POST an operator announcement (broadcast or @targeted) to the workspace. */
+    announce(req: WorkspaceAnnounceRequestT): Promise<WorkspaceAnnounceResponseT>;
+}
+
+/**
+ * Construction options for {@link createShepherdClient}. Auth is supplied
+ * externally via `getAuthHeaders` so the core client stays auth-agnostic — it
+ * never reads tokens, localStorage, or a BFF; it only merges whatever headers
+ * the host injects and notifies the host on a 401 via `onUnauthorized`.
+ */
+export declare interface ShepherdClientConfig {
+    /** Hub origin; a trailing slash is tolerated and normalised away. */
+    baseUrl: string;
+    /** Returns auth headers to merge over the JSON content-type base, per call. */
+    getAuthHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** Invoked once when the hub responds 401, before the error is thrown. */
+    onUnauthorized?: () => void;
+    /** Per-request abort timeout in ms; defaults to {@link DEFAULT_TIMEOUT_MS}. */
+    timeoutMs?: number;
+}
+
+/**
+ * The single error type surfaced by the client. A missing `status` means a
+ * transport failure (network error or request timeout); a present `status` is
+ * the upstream HTTP status of a non-2xx response. One class — distinguished by
+ * the optional `status` — keeps callers from having to branch on two error
+ * types just to tell "couldn't reach the hub" from "the hub said no".
+ */
+export declare class ShepherdClientError extends Error {
+    /** Upstream HTTP status for a non-2xx response; absent for transport errors. */
+    readonly status?: number;
+    /**
+     * @param message - Human-readable failure description.
+     * @param status - Upstream HTTP status, omitted for network/abort failures.
+     */
+    constructor(message: string, status?: number);
+}
+
+/**
+ * Supplies a {@link ShepherdClient} to the React subtree. This is the seam that
+ * keeps the dashboard auth-agnostic: the host constructs a client (wiring in
+ * whatever auth it uses) and injects it here, so components below only ever see
+ * the auth-neutral client interface — never tokens or transport details.
+ *
+ * @param props - The client to provide and the children that consume it.
+ * @returns A provider element wrapping `children`.
+ */
+export declare function ShepherdClientProvider({ client, children, }: ShepherdClientProviderProps): ReactNode;
+
+/** Props for {@link ShepherdClientProvider}. */
+declare interface ShepherdClientProviderProps {
+    /** The client made available to every descendant via the context. */
+    client: ShepherdClient;
+    /** The subtree that may read the client through {@link useShepherdClient}. */
+    children: ReactNode;
+}
+
+/**
+ * Reads the {@link ShepherdClient} from context. Throws when called outside a
+ * {@link ShepherdClientProvider} so a missing provider surfaces as an immediate,
+ * named error at render time instead of a confusing null-dereference later.
+ *
+ * @returns The client supplied by the nearest provider.
+ * @throws Error When invoked with no {@link ShepherdClientProvider} ancestor.
+ */
+export declare function useShepherdClient(): ShepherdClient;
+
+declare const WorkspaceAnnounceRequest: z.ZodObject<{
+    body: z.ZodString;
+    targetAgentName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    repo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    body: string;
+    targetAgentName?: string | null | undefined;
+    repo?: string | null | undefined;
+}, {
+    body: string;
+    targetAgentName?: string | null | undefined;
+    repo?: string | null | undefined;
+}>;
+
+declare type WorkspaceAnnounceRequestT = z.infer<typeof WorkspaceAnnounceRequest>;
+
+declare const WorkspaceAnnounceResponse: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    announcementIds: z.ZodArray<z.ZodNumber, "many">;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    announcementIds: number[];
+}, {
+    ok: true;
+    announcementIds: number[];
+}>;
+
+declare type WorkspaceAnnounceResponseT = z.infer<typeof WorkspaceAnnounceResponse>;
+
+declare const WorkspaceLandscapeResponse: z.ZodObject<{
+    agents: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        human: z.ZodString;
+        program: z.ZodString;
+        model: z.ZodNullable<z.ZodString>;
+        repo: z.ZodNullable<z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        lastHeartbeatAt: z.ZodNullable<z.ZodString>;
+        presence: z.ZodEnum<["live", "offline"]>;
+    }, "strip", z.ZodTypeAny, {
+        human: string;
+        branch: string | null;
+        name: string;
+        program: string;
+        model: string | null;
+        repo: string | null;
+        lastHeartbeatAt: string | null;
+        presence: "live" | "offline";
+    }, {
+        human: string;
+        branch: string | null;
+        name: string;
+        program: string;
+        model: string | null;
+        repo: string | null;
+        lastHeartbeatAt: string | null;
+        presence: "live" | "offline";
+    }>, "many">;
+    tasks: z.ZodArray<z.ZodObject<{
+        agentName: z.ZodString;
+        program: z.ZodString;
+        model: z.ZodNullable<z.ZodString>;
+        repo: z.ZodString;
+        intent: z.ZodString;
+        pathGlobs: z.ZodArray<z.ZodString, "many">;
+        status: z.ZodEnum<["active", "done", "dropped"]>;
+        createdAt: z.ZodString;
+        endedAt: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        status: "active" | "done" | "dropped";
+        intent: string;
+        pathGlobs: string[];
+        createdAt: string;
+        program: string;
+        model: string | null;
+        repo: string;
+        endedAt: string | null;
+    }, {
+        agentName: string;
+        status: "active" | "done" | "dropped";
+        intent: string;
+        pathGlobs: string[];
+        createdAt: string;
+        program: string;
+        model: string | null;
+        repo: string;
+        endedAt: string | null;
+    }>, "many">;
+    announcements: z.ZodArray<z.ZodObject<{
+        fromAgentName: z.ZodString;
+        fromHuman: z.ZodString;
+        body: z.ZodString;
+        targetAgentName: z.ZodNullable<z.ZodString>;
+        repo: z.ZodString;
+        fromAdmin: z.ZodDefault<z.ZodBoolean>;
+        toAdmin: z.ZodDefault<z.ZodBoolean>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        fromAgentName: string;
+        fromHuman: string;
+        body: string;
+        targetAgentName: string | null;
+        createdAt: string;
+        repo: string;
+        fromAdmin: boolean;
+        toAdmin: boolean;
+    }, {
+        fromAgentName: string;
+        fromHuman: string;
+        body: string;
+        targetAgentName: string | null;
+        createdAt: string;
+        repo: string;
+        fromAdmin?: boolean | undefined;
+        toAdmin?: boolean | undefined;
+    }>, "many">;
+    serverTime: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    announcements: {
+        fromAgentName: string;
+        fromHuman: string;
+        body: string;
+        targetAgentName: string | null;
+        createdAt: string;
+        repo: string;
+        fromAdmin: boolean;
+        toAdmin: boolean;
+    }[];
+    agents: {
+        human: string;
+        branch: string | null;
+        name: string;
+        program: string;
+        model: string | null;
+        repo: string | null;
+        lastHeartbeatAt: string | null;
+        presence: "live" | "offline";
+    }[];
+    tasks: {
+        agentName: string;
+        status: "active" | "done" | "dropped";
+        intent: string;
+        pathGlobs: string[];
+        createdAt: string;
+        program: string;
+        model: string | null;
+        repo: string;
+        endedAt: string | null;
+    }[];
+    serverTime: string;
+}, {
+    announcements: {
+        fromAgentName: string;
+        fromHuman: string;
+        body: string;
+        targetAgentName: string | null;
+        createdAt: string;
+        repo: string;
+        fromAdmin?: boolean | undefined;
+        toAdmin?: boolean | undefined;
+    }[];
+    agents: {
+        human: string;
+        branch: string | null;
+        name: string;
+        program: string;
+        model: string | null;
+        repo: string | null;
+        lastHeartbeatAt: string | null;
+        presence: "live" | "offline";
+    }[];
+    tasks: {
+        agentName: string;
+        status: "active" | "done" | "dropped";
+        intent: string;
+        pathGlobs: string[];
+        createdAt: string;
+        program: string;
+        model: string | null;
+        repo: string;
+        endedAt: string | null;
+    }[];
+    serverTime: string;
+}>;
+
+export declare type WorkspaceLandscapeResponseT = z.infer<typeof WorkspaceLandscapeResponse>;
+
+export { }

package/dist/lib/index.js

@@ -0,0 +1,8 @@
+import { D as a, S as h, a as s, c as d, u as t } from "./Dashboard-CB6SL-J2.js";
+export {
+  a as Dashboard,
+  h as ShepherdClientError,
+  s as ShepherdClientProvider,
+  d as createShepherdClient,
+  t as useShepherdClient
+};

package/dist/lib/selfhost.d.ts

@@ -0,0 +1,25 @@
+import { ReactElement } from 'react';
+
+/**
+ * The self-host SPA root and the ONE place a team token is handled — the named
+ * auth exception to the auth-agnostic core. Everything below the provider (the
+ * client, the polling hook, the {@link Dashboard}) stays token-blind; this
+ * component owns the token's lifecycle:
+ *
+ *  - It seeds token state from `localStorage["shepherd.token"]` (back-compat with
+ *    the legacy board), so a returning viewer skips the gate.
+ *  - With NO token it renders the {@link Gate}; a successful submit persists the
+ *    token and re-renders into the dashboard.
+ *  - With a token it builds a same-origin client (`baseUrl: ""`) that injects the
+ *    `Authorization: Bearer <token>` header and, on a 401, clears the stored
+ *    token and resets state — which re-renders straight back to the gate. This is
+ *    the React analogue of app.js's `clearToken()` + re-prompt 401 flow.
+ *
+ * The client is memoised on the token so it is rebuilt only when the token
+ * actually changes, not on every freshness re-render of the dashboard subtree.
+ *
+ * @returns Either the token gate or the authenticated dashboard.
+ */
+export declare function SelfHostApp(): ReactElement;
+
+export { }

package/dist/lib/selfhost.js

@@ -0,0 +1,68 @@
+import { jsx as e, jsxs as l } from "react/jsx-runtime";
+import { useState as s, useMemo as h } from "react";
+import { c as d, a as m, D as u } from "./Dashboard-CB6SL-J2.js";
+const i = "shepherd.token";
+function p() {
+  try {
+    return localStorage.getItem(i) ?? "";
+  } catch {
+    return "";
+  }
+}
+function f({ onSubmit: t }) {
+  const [r, o] = s("");
+  return /* @__PURE__ */ l("section", { id: "gate", className: "gate", children: [
+    /* @__PURE__ */ e("h1", { children: "Shepherd" }),
+    /* @__PURE__ */ e("p", { children: "Enter the team token to view the workspace." }),
+    /* @__PURE__ */ l("form", { id: "gate-form", onSubmit: (n) => {
+      n.preventDefault();
+      const c = r.trim();
+      c !== "" && t(c);
+    }, children: [
+      /* @__PURE__ */ e(
+        "input",
+        {
+          id: "gate-input",
+          type: "password",
+          placeholder: "Team token",
+          "aria-label": "Team token",
+          autoComplete: "off",
+          value: r,
+          onChange: (n) => o(n.target.value)
+        }
+      ),
+      /* @__PURE__ */ e("button", { type: "submit", children: "View" })
+    ] })
+  ] });
+}
+function b() {
+  const [t, r] = s(p), o = h(
+    () => d({
+      baseUrl: "",
+      getAuthHeaders: () => ({ Authorization: `Bearer ${t}` }),
+      onUnauthorized: () => {
+        try {
+          localStorage.removeItem(i);
+        } catch {
+        }
+        r("");
+      }
+    }),
+    [t]
+  );
+  return t === "" ? /* @__PURE__ */ e(
+    f,
+    {
+      onSubmit: (a) => {
+        try {
+          localStorage.setItem(i, a);
+        } catch {
+        }
+        r(a);
+      }
+    }
+  ) : /* @__PURE__ */ e("div", { className: "wrap", children: /* @__PURE__ */ e(m, { client: o, children: /* @__PURE__ */ e(u, {}) }) });
+}
+export {
+  b as SelfHostApp
+};

package/dist/lib/styles.css

@@ -0,0 +1,182 @@
+      :root {
+        --bg:#ece0c6; --ink:#322c20; --ink2:#6f6450; --ink3:#9c917a;
+        --line:#d7c9ac; --line2:#e0d4b9; --live:#3d8b58; --drop:#bd4f3a;
+        --chip:#e3d6ba; --terr:#7a6a48; --card:#f5ecd9;
+      }
+      * { box-sizing:border-box; }
+      html,body { height:100%; }
+      body {
+        margin:0; background:var(--bg); color:var(--ink);
+        font:14px/1.45 'Inter', ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
+        -webkit-font-smoothing:antialiased;
+      }
+      .wrap { max-width:1100px; margin:0 auto; padding:40px 44px; }
+
+      header { display:flex; align-items:center; gap:12px; padding-bottom:18px; border-bottom:1px solid var(--line); }
+      /* Chat view: the card supplies its own border, so the header rule is redundant. */
+      #board:has(#panel-chat:not([hidden])) header { border-bottom:0; }
+      .brand { font-size:17px; font-weight:600; }
+      .vitals { color:var(--ink3); font-size:12.5px; }
+      .grow { flex:1; }
+      .status { font-size:12px; color:var(--ink3); }
+      .status--ok { color:var(--live); }
+      .status--warn { color:var(--terr); }
+      .status--error { color:var(--drop); }
+      .freshness { font-size:12px; color:var(--ink3); }
+
+      /* Repo selector (hidden when <2 repos; populated by app.js) */
+      .repo { position:relative; }
+      .repo-trig { display:inline-flex; align-items:center; gap:6px; font-size:13px;
+        font-family:inherit; color:var(--ink); appearance:none;
+        border:1px solid var(--line); border-radius:8px; padding:4px 10px;
+        background:rgba(255,250,238,.4); cursor:pointer; }
+      .repo-trig .slash { color:var(--ink3); }
+      .repo-menu { position:absolute; top:36px; left:0; min-width:200px; background:var(--card);
+        border:1px solid var(--line); border-radius:10px; padding:5px;
+        box-shadow:0 8px 24px rgba(50,40,20,.14); z-index:5; }
+      .repo-mi { display:flex; justify-content:space-between; gap:14px; padding:7px 9px;
+        width:100%; text-align:left; border:0; appearance:none; font-family:inherit; color:inherit;
+        background:transparent; border-radius:7px; font-size:13px; cursor:pointer; }
+      .repo-mi:hover { background:var(--chip); }
+      .repo-mi.on { background:var(--chip); font-weight:600; }
+      .repo-mi .ct { font-size:11px; color:var(--ink3); }
+      .repo-mi.all { border-top:1px solid var(--line2); margin-top:4px; padding-top:9px; color:var(--ink2); }
+
+      /* Tabs */
+      .tabs { display:flex; gap:4px; margin-left:auto; }
+      .tab { font-size:13px; color:var(--ink2); padding:5px 11px; border:0; border-radius:7px;
+        background:transparent; cursor:pointer; font:inherit; }
+      .tab--active { background:var(--ink); color:var(--bg); }
+
+      /* Crew strip */
+      .crew { display:flex; align-items:center; gap:8px; flex-wrap:wrap; margin:26px 0 32px; }
+      .person { display:inline-flex; align-items:center; gap:9px; padding:5px 13px 5px 5px;
+        border:1px solid var(--line); border-radius:999px; background:var(--card); font-size:13px; }
+      .person--idle { opacity:.55; }
+      .avatar { width:24px; height:24px; border-radius:50%; display:grid; place-items:center;
+        font-size:10px; font-weight:700; color:#fff; flex:none; }
+      .person__name { font-weight:600; }
+      .person__doing { color:var(--ink3); font-size:12px; }
+
+      /* Board */
+      .board { display:grid; grid-template-columns:1fr 1px 1fr; gap:0; }
+      .board__rule { background:var(--line); }
+      .col { padding:0 36px; } .col:first-child { padding-left:0; } .col:last-child { padding-right:0; }
+      .colhead { display:flex; align-items:center; gap:8px; margin-bottom:6px; }
+      .colhead h2 { font-size:12px; font-weight:600; letter-spacing:.03em; margin:0;
+        text-transform:uppercase; color:var(--ink2); }
+      .colhead .n { font-size:11px; color:var(--ink3); background:var(--chip);
+        border-radius:999px; padding:1px 8px; }
+
+      .task { padding:16px 0; border-bottom:1px solid var(--line2); }
+      .task__r1 { display:flex; align-items:center; gap:8px; }
+      .task__who { font-size:13.5px; font-weight:600; }
+      .task__tag { font-size:11px; color:var(--ink3); }
+      .task__repo { font-size:11px; color:var(--terr); background:rgba(122,106,72,.1);
+        border-radius:4px; padding:0 6px; }
+      .task__stat { margin-left:auto; font-size:11px; font-weight:500; color:var(--ink3); }
+      .task__stat--drop { color:var(--drop); }
+      .livedot { width:7px; height:7px; border-radius:50%; background:var(--live); margin-left:auto; }
+      .task__intent { font-size:13.5px; margin:5px 0 0; line-height:1.45; }
+      .terr { margin-top:8px; display:flex; flex-wrap:wrap; gap:6px; align-items:center; }
+      .terr__lbl { font-size:9.5px; text-transform:uppercase; letter-spacing:.05em; color:var(--ink3); }
+      .glob { font-family:ui-monospace, Menlo, monospace; font-size:11px; color:var(--terr);
+        background:rgba(122,106,72,.12); border:1px solid rgba(122,106,72,.22);
+        border-radius:5px; padding:1px 7px; }
+      .task__meta { font-size:11.5px; color:var(--ink3); margin-top:6px; }
+      /* expandable territory (2+ paths collapse to a one-line "N paths" toggle) */
+      .terrx { margin-top:8px; }
+      .terrx summary { list-style:none; cursor:pointer; display:flex; align-items:center;
+        gap:6px; flex-wrap:wrap; user-select:none; }
+      .terrx summary::-webkit-details-marker { display:none; }
+      .terrx .terr--full { margin-top:8px; }
+      .glob--more { cursor:pointer; color:var(--ink2); background:var(--chip);
+        border:1px solid var(--line); }
+      .glob--more .tw { color:var(--ink3); display:inline-block; transition:transform .15s; }
+      .terrx[open] summary .glob--more .tw { transform:rotate(90deg); }
+      /* grouped agent box: header + claims rail + collapsible "narrower" fold */
+      .grp { padding:16px 0; border-bottom:1px solid var(--line2); }
+      .grp__head { display:flex; align-items:center; gap:8px; }
+      .grp__who { font-size:13.5px; font-weight:600; }
+      .grp__tag { font-size:11px; color:var(--ink3); }
+      .grp__count { font-size:11px; color:var(--ink3); }
+      .grp__dot { width:7px; height:7px; border-radius:50%; background:var(--live); margin-left:auto; }
+      .claims { margin:10px 0 0 6px; padding-left:14px; border-left:1px solid var(--line); }
+      .claim { padding:6px 0; }
+      .claim + .claim { border-top:1px solid var(--line2); margin-top:6px; }
+      .fold { margin-top:10px; }
+      .fold summary { list-style:none; cursor:pointer; font-size:12px; color:var(--ink2);
+        display:inline-flex; align-items:center; gap:6px; user-select:none; }
+      .fold summary::-webkit-details-marker { display:none; }
+      .fold summary .tw { display:inline-block; color:var(--ink3); transition:transform .15s; }
+      .fold[open] summary .tw { transform:rotate(90deg); }
+      .fold__body { margin:8px 0 0 6px; padding-left:14px; border-left:1px dashed var(--line); }
+      .covered { font-size:10.5px; color:var(--ink3); font-style:italic; margin-top:4px; }
+      .day { font-size:11px; color:var(--ink3); padding:18px 0 2px; font-weight:600; }
+      .more { margin-top:20px; font-size:12.5px; color:var(--ink2); padding:7px 13px;
+        border:1px solid var(--line); border-radius:8px; background:rgba(255,250,238,.35);
+        cursor:pointer; }
+      .empty { color:var(--ink3); font-style:italic; padding:14px 0; }
+
+      /* Chat (re-themed; structure unchanged) */
+      .chat-wrap { background:var(--card); border:1px solid var(--line); border-radius:12px;
+        display:flex; flex-direction:column; overflow:hidden; height:calc(100vh - 150px); min-height:320px; }
+      .chat { flex:1; overflow-y:auto; padding:16px; }
+      .chat { scrollbar-width:thin; scrollbar-color:var(--line) transparent; }
+      .chat::-webkit-scrollbar { width:10px; }
+      .chat::-webkit-scrollbar-track { background:transparent; }
+      .chat::-webkit-scrollbar-thumb { background:var(--line); border-radius:999px;
+        border:3px solid var(--card); background-clip:padding-box; }
+      .chat::-webkit-scrollbar-thumb:hover { background:var(--ink3); background-clip:padding-box; }
+      .chat__note { padding:9px 16px; font-size:11.5px; color:var(--ink3); }
+      .msg { display:flex; gap:11px; padding:9px 0; }
+      .msg__avatar { flex:none; width:32px; height:32px; border-radius:50%; display:grid;
+        place-items:center; font-size:12px; font-weight:700; color:#fff; }
+      .msg__body { min-width:0; flex:1; }
+      .msg__head { display:flex; align-items:baseline; gap:8px; flex-wrap:wrap; }
+      .msg__who { font-weight:600; }
+      .msg__human { font-size:12px; color:var(--ink3); }
+      .msg__to { font-size:11.5px; color:var(--terr); }
+      .msg__time { font-size:11.5px; color:var(--ink3); margin-left:auto; }
+      .msg__text { margin-top:3px; padding:8px 12px; border-radius:4px 12px 12px 12px;
+        background:var(--chip); white-space:pre-wrap; word-break:break-word; }
+      .msg--targeted .msg__text { box-shadow:inset 3px 0 0 var(--terr); }
+
+      /* Operator's own messages — same group-chat structure, mirrored to the right. */
+      .msg--me { flex-direction:row-reverse; }
+      .msg--me .msg__head { flex-direction:row-reverse; }
+      .msg--me .msg__time { margin-left:0; margin-right:auto; }
+      .msg--me .msg__body { display:flex; flex-direction:column; align-items:flex-end; }
+      .msg--me .msg__text { border-radius:12px 4px 12px 12px; background:#d4e7d2; }
+      .msg--me.msg--targeted .msg__text { box-shadow:inset -3px 0 0 var(--terr); }
+
+      /* Composer */
+      .composer { position:relative; border-top:1px solid var(--line); padding:10px 12px; }
+      .chat-form { display:flex; gap:8px; }
+      .chat-input { flex:1; padding:9px 12px; border-radius:8px; border:1px solid var(--line);
+        background:var(--bg); color:var(--ink); font:inherit; }
+      .chat-input:focus { outline:none; border-color:var(--terr); }
+      .chat-send { padding:9px 16px; border-radius:8px; border:1px solid var(--ink);
+        background:var(--ink); color:var(--bg); font-weight:600; cursor:pointer; font:inherit; }
+      .chat-send:disabled { opacity:.5; cursor:default; }
+
+      /* @-mention autocomplete — floats above the input */
+      .mention-pop { position:absolute; left:12px; right:12px; bottom:56px; z-index:6;
+        background:var(--card); border:1px solid var(--line); border-radius:10px; padding:5px;
+        box-shadow:0 8px 24px rgba(50,40,20,.16); max-height:200px; overflow-y:auto; }
+      .mention-mi { display:flex; align-items:center; gap:9px; width:100%; text-align:left;
+        border:0; appearance:none; font-family:inherit; color:inherit; background:transparent;
+        border-radius:7px; padding:6px 8px; font-size:13px; cursor:pointer; }
+      .mention-mi:hover, .mention-mi.on { background:var(--chip); }
+      .mention-mi .ma { width:22px; height:22px; border-radius:50%; display:grid; place-items:center;
+        font-size:9px; font-weight:700; color:#fff; flex:none; }
+
+      /* Token gate */
+      .gate { max-width:420px; margin:12vh auto 0; text-align:center; }
+      .gate h1 { font-size:19px; margin:0 0 6px; }
+      .gate p { color:var(--ink2); margin:0 0 20px; }
+      .gate form { display:flex; gap:8px; }
+      .gate input { flex:1; padding:10px 12px; border-radius:8px; border:1px solid var(--line);
+        background:var(--card); color:var(--ink); }
+      .gate button { padding:10px 16px; border-radius:8px; border:1px solid var(--ink);
+        background:var(--ink); color:var(--bg); font-weight:600; cursor:pointer; }