@silo-code/sdk 0.30.0 → 0.32.0

package/dist/workspace-service.d.ts

@@ -1,5 +1,6 @@
 import type { Disposable } from "./types.js";
 import type { Workspace } from "./domain-types.js";
+import type { Activity } from "./activity.js";
 export type { Workspace, TerminalRecord } from "./domain-types.js";
 /**
  * A single status row contributed by a {@link WorkspaceStatusProvider}.
@@ -11,8 +12,11 @@ export type { Workspace, TerminalRecord } from "./domain-types.js";
 export interface WorkspaceStatusRow {
     /** Stable key unique within this provider's results; used for reconciliation. */
     id: string;
-    /** Semantic status dot shown to the left of the label. */
-    status?: "ok" | "warn" | "busy" | "error";
+    /**
+     * Host-owned {@link Activity} glyph to the left of the label. Omit for the
+     * neutral gray fallback (same as today’s omitted `status`). See ADR 0030.
+     */
+    activity?: Activity;
     /** Short label — the host truncates with an ellipsis when space is tight. */
     label: string;
     /**
@@ -66,21 +70,22 @@ export interface WorkspaceBadge {
     /** Short text rendered inside the badge. */
     text: string;
     /**
-     * CSS color applied to both the badge border and text. Falls back to the
-     * muted text color (`--silo-color-text-lo`) when omitted.
+     * Solid chip fill color. Text paints white on top for contrast. Falls back
+     * to a muted solid background + hi text when omitted.
      */
     color?: string;
 }
 /**
- * A badge provider that contributes {@link WorkspaceBadge}s next to the
- * workspace name in the Workspaces side panel. Register via
- * {@link WorkspaceService.registerBadge}.
+ * A badge binder that contributes {@link WorkspaceBadge}s next to the
+ * workspace name in the Workspaces side panel. Prefer
+ * {@link WorkspaceService.bindBadge}; {@link WorkspaceService.registerBadge}
+ * remains as a deprecated alias.
  *
  * @category Consumer Services
  * @public
  */
 export interface WorkspaceBadgeProvider {
-    /** Unique id for this provider — conventionally `"<extension-id>.badges"`. */
+    /** Unique id for this binder — conventionally `"<extension-id>.badges"`. */
     id: string;
     /**
      * Called synchronously for each workspace during render. Return an empty
@@ -89,15 +94,19 @@ export interface WorkspaceBadgeProvider {
     provide(workspaceId: string): WorkspaceBadge[];
 }
 /**
- * A status provider that contributes {@link WorkspaceStatusRow}s to
- * workspace rows in the Workspaces side panel. Register via
- * {@link WorkspaceService.registerStatus}.
+ * A status binder that contributes {@link WorkspaceStatusRow}s to
+ * workspace rows in the Workspaces side panel. Prefer
+ * {@link WorkspaceService.bindStatus}; {@link WorkspaceService.registerStatus}
+ * remains as a deprecated alias.
+ *
+ * Unlike CenterDock tab `bindIndicator` (single adornment | null), status
+ * and badge binders return an **array** — one projection may emit many rows.
  *
  * @category Consumer Services
  * @public
  */
 export interface WorkspaceStatusProvider {
-    /** Unique id for this provider — conventionally `"<extension-id>.status"`. */
+    /** Unique id for this binder — conventionally `"<extension-id>.status"`. */
     id: string;
     /**
      * Called synchronously for each workspace during render. Return an empty
@@ -246,47 +255,56 @@ export interface WorkspaceService {
      */
     delete(id: string): Promise<void>;
     /**
-     * Register a status provider that contributes status rows to workspace
-     * rows in the Workspaces side panel. Multiple providers may be registered;
-     * their rows are concatenated in registration order. Returns a
-     * {@link Disposable} that unregisters the provider.
+     * Imperatively adorn a workspace row with a status line. `row.id` is the
+     * adornment key for {@link WorkspaceService.clearStatus}.
+     */
+    setStatus(workspaceId: string, row: WorkspaceStatusRow): void;
+    /** Remove an imperative status row previously set via {@link WorkspaceService.setStatus}. */
+    clearStatus(workspaceId: string, rowId: string): void;
+    /**
+     * Keep a status projection in sync for every workspace. `provide` returns
+     * an array of rows (may be empty). Prefer this over repeatedly calling
+     * {@link WorkspaceService.setStatus}.
      *
      * @example
      * ```ts
      * ctx.subscriptions.push(
-     *   ctx.workspaces.registerStatus({
+     *   ctx.workspaces.bindStatus({
      *     id: "my-ext.status",
      *     provide(workspaceId) {
      *       const running = getRunningTasks(workspaceId);
-     *       return running.map(t => ({ id: t.id, status: "busy", label: t.name, startedAt: t.startedAt }));
+     *       return running.map(t => ({ id: t.id, activity: "working", label: t.name, startedAt: t.startedAt }));
      *     },
      *   }),
-     *   ctx.workspaces.subscribeStatus(() => ctx.workspaces.invalidateStatus()),
      * );
      * ```
      */
+    bindStatus(binder: WorkspaceStatusProvider): Disposable;
+    /**
+     * @deprecated Prefer {@link WorkspaceService.bindStatus}.
+     */
     registerStatus(provider: WorkspaceStatusProvider): Disposable;
     /**
-     * Concatenate all registered providers' rows for one workspace (in
-     * registration order). Called synchronously during panel render — providers
-     * must be fast and side-effect-free.
+     * Concatenate imperative rows and all binders' rows for one workspace (in
+     * binder registration order). Called synchronously during panel render —
+     * binders must be fast and side-effect-free.
      */
     getStatus(workspaceId: string): WorkspaceStatusRow[];
     /**
-     * Signal that status data has changed. Fires all listeners registered
+     * Signal that binder data has changed. Fires all listeners registered
      * via {@link WorkspaceService.subscribeStatus}, causing the Workspaces
-     * panel to re-query providers and re-render the status rows.
+     * panel to re-query binders and re-render the status rows.
      *
      * Call this after any mutation to the state your `provide` function reads.
+     * Imperative {@link WorkspaceService.setStatus} / {@link WorkspaceService.clearStatus}
+     * already notify listeners.
      */
     invalidateStatus(): void;
     /**
      * Subscribe to status invalidations. The listener is called whenever
-     * {@link WorkspaceService.invalidateStatus} is invoked. Returns a
-     * {@link Disposable} that cancels the subscription.
-     *
-     * The Workspaces panel subscribes internally; extensions may also subscribe
-     * to observe invalidations.
+     * {@link WorkspaceService.invalidateStatus} is invoked (or imperative
+     * set/clear runs). Returns a {@link Disposable} that cancels the
+     * subscription.
      */
     subscribeStatus(listener: () => void): Disposable;
     /**
@@ -353,15 +371,20 @@ export interface WorkspaceService {
      */
     registerPropertyPage(page: WorkspacePropertyPage): Disposable;
     /**
-     * Register a badge provider that contributes {@link WorkspaceBadge}s next to
-     * the workspace name in the Workspaces side panel. Multiple providers may be
-     * registered; their badges are concatenated in registration order. Returns a
-     * {@link Disposable} that unregisters the provider.
+     * Imperatively adorn a workspace name with a badge. `badge.id` is the
+     * adornment key for {@link WorkspaceService.clearBadge}.
+     */
+    setBadge(workspaceId: string, badge: WorkspaceBadge): void;
+    /** Remove an imperative badge previously set via {@link WorkspaceService.setBadge}. */
+    clearBadge(workspaceId: string, badgeId: string): void;
+    /**
+     * Keep a badge projection in sync for every workspace. `provide` returns
+     * an array of badges (may be empty).
      *
      * @example
      * ```ts
      * ctx.subscriptions.push(
-     *   ctx.workspaces.registerBadge({
+     *   ctx.workspaces.bindBadge({
      *     id: "my-ext.badges",
      *     provide(workspaceId) {
      *       const status = getStatus(workspaceId);
@@ -372,25 +395,23 @@ export interface WorkspaceService {
      * );
      * ```
      */
+    bindBadge(binder: WorkspaceBadgeProvider): Disposable;
+    /**
+     * @deprecated Prefer {@link WorkspaceService.bindBadge}.
+     */
     registerBadge(provider: WorkspaceBadgeProvider): Disposable;
     /**
-     * Concatenate all registered providers' badges for one workspace (in
-     * registration order). Called synchronously during panel render — providers
-     * must be fast and side-effect-free.
+     * Concatenate imperative badges and all binders' badges for one workspace
+     * (in binder registration order).
      */
     getBadges(workspaceId: string): WorkspaceBadge[];
     /**
-     * Signal that badge data has changed. Fires all listeners registered via
-     * {@link WorkspaceService.subscribeBadges}, causing the Workspaces panel to
-     * re-query providers and re-render the name row.
-     *
-     * Call this after any mutation to the state your `provide` function reads.
+     * Signal that badge binder data has changed. Imperative set/clear already
+     * notify listeners.
      */
     invalidateBadges(): void;
     /**
-     * Subscribe to badge invalidations. The listener is called whenever
-     * {@link WorkspaceService.invalidateBadges} is invoked. Returns a
-     * {@link Disposable} that cancels the subscription.
+     * Subscribe to badge invalidations.
      */
     subscribeBadges(listener: () => void): Disposable;
 }

package/dist/workspace-service.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silo-code/sdk",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "The public, types-first SDK for building Silo extensions — the only surface third-party extensions import.",
   "license": "MIT",
   "author": "Dave Weaver",

package/src/ActivityGlyph.tsx

@@ -0,0 +1,43 @@
+import type { HTMLAttributes } from "react";
+import {
+  activityClass,
+  type Activity as ActivityKind,
+  type ActivitySize,
+} from "./activity";
+
+/**
+ * Host-painted activity glyph — same look on workspace rows, CenterDock tabs,
+ * and extension UI. Pick an {@link Activity}; the host owns color and motion
+ * (ADR 0030). Omit `activity` only for the workspace-row neutral gray fallback.
+ *
+ * Styled purely via host-provided `.silo-activity*` classes — no stylesheet
+ * import is needed in the extension.
+ *
+ * @example
+ * ```tsx
+ * <ActivityGlyph activity="working" size="md" />
+ * <ActivityGlyph activity="ready" />
+ * <ActivityGlyph size="sm" /> // workspace neutral (omit)
+ * ```
+ *
+ * @category Consumer Services
+ * @public
+ */
+export function ActivityGlyph({
+  activity,
+  size = "sm",
+  className,
+  ...rest
+}: {
+  activity?: ActivityKind;
+  size?: ActivitySize;
+} & Omit<HTMLAttributes<HTMLSpanElement>, "children">) {
+  const classes = activityClass(activity, size);
+  return (
+    <span
+      className={className ? `${classes} ${className}` : classes}
+      aria-hidden={rest["aria-label"] == null ? true : undefined}
+      {...rest}
+    />
+  );
+}

package/src/IconButton.tsx

@@ -1,7 +1,11 @@
 import type { ButtonHTMLAttributes, ReactNode } from "react";
-import { iconButtonClass, type IconButtonSize } from "./icon-button-classes";
+import {
+  iconButtonClass,
+  type IconButtonSize,
+  type IconButtonVariant,
+} from "./icon-button-classes";
 
-export type { IconButtonSize };
+export type { IconButtonSize, IconButtonVariant };
 
 /**
  * A square icon-only button — the kit's one answer for ✕, ⋮, ↻, ✏️, and
@@ -9,18 +13,27 @@ export type { IconButtonSize };
  * label is the accessible name. Pair with {@link Tooltip} so sighted users
  * get the same label on hover.
  *
+ * Sized in terms of `--silo-font-size-base` so the hit target and child SVGs
+ * scale with Silo's UI zoom (`uiFontSize`). Prefer Phosphor `size="1em"`
+ * (or omit a fixed px size) so the glyph tracks the button.
+ *
  * Styled purely via host-provided `.silo-icon-button*` classes — no
  * stylesheet import is needed in the extension.
  *
  * @example
  * ```tsx
  * <IconButton aria-label="Refresh" onClick={refresh}>
- *   <RefreshIcon />
+ *   <RefreshIcon size="1em" />
  * </IconButton>
  *
  * // compact — e.g. in a ListRow's trailing slot
  * <IconButton size="sm" aria-label="Pin" onClick={pin}>
- *   <PinIcon />
+ *   <PinIcon size="1em" />
+ * </IconButton>
+ *
+ * // panel / breadcrumb toolbar (local-web-viewer tone)
+ * <IconButton size="sm" variant="toolbar" aria-label="Mark">
+ *   <FlagIcon size="1em" weight="bold" />
  * </IconButton>
  * ```
  *
@@ -29,19 +42,28 @@ export type { IconButtonSize };
  */
 export function IconButton({
   size = "normal",
+  variant = "normal",
   className,
   type = "button",
   children,
   "aria-label": ariaLabel,
   ...rest
 }: {
-  /** 32px standalone / 26px for tight or inline contexts. */
+  /**
+   * Hit-target size in `em` of `--silo-font-size-base` (tracks Zoom In/Out).
+   * `normal` = 2.5em, `sm` = 2em (local-web-viewer toolbar buttons).
+   */
   size?: IconButtonSize;
+  /**
+   * `"toolbar"` — black/white toolbar-text icons, hover fill only, no
+   * press-scale. Use on editor/terminal breadcrumb clusters and panel bars.
+   */
+  variant?: IconButtonVariant;
   /** Required — the icon is the only visual. */
   "aria-label": string;
   children?: ReactNode;
 } & Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "aria-label">) {
-  const classes = iconButtonClass(size);
+  const classes = iconButtonClass(size, variant);
   return (
     <button
       type={type}

package/src/activity.test.ts

@@ -0,0 +1,35 @@
+import { describe, expect, it } from "vitest";
+import { activityClass, activityFromAgent } from "./activity";
+
+describe("activityClass", () => {
+  it("maps kinds and sizes", () => {
+    expect(activityClass("working", "md")).toBe(
+      "silo-activity silo-activity-working silo-activity-md",
+    );
+    expect(activityClass("ready")).toBe(
+      "silo-activity silo-activity-ready silo-activity-sm",
+    );
+    expect(activityClass("warn", "sm")).toBe(
+      "silo-activity silo-activity-warn silo-activity-sm",
+    );
+    expect(activityClass("error")).toBe(
+      "silo-activity silo-activity-error silo-activity-sm",
+    );
+  });
+
+  it("uses none fallback when activity is omitted", () => {
+    expect(activityClass(undefined)).toBe(
+      "silo-activity silo-activity-none silo-activity-sm",
+    );
+  });
+});
+
+describe("activityFromAgent", () => {
+  it("maps overlapping agent states", () => {
+    expect(activityFromAgent("working")).toBe("working");
+    expect(activityFromAgent("idle")).toBe("ready");
+    expect(activityFromAgent("error")).toBe("error");
+    expect(activityFromAgent("none")).toBeNull();
+    expect(activityFromAgent("dead")).toBeNull();
+  });
+});

package/src/activity.ts

@@ -0,0 +1,57 @@
+import type { AgentActivity } from "./agents-service";
+
+/**
+ * Host-owned activity state for chrome (workspace rows, CenterDock tabs,
+ * SideDock tabs, and the public {@link Activity} glyph). Extensions pick a
+ * kind only — never an icon, color, or motion. See ADR 0030.
+ *
+ * @category Core Types
+ * @public
+ */
+export type Activity = "working" | "ready" | "warn" | "error";
+
+/**
+ * Glyph size for {@link Activity}. `"sm"` matches workspace status rows (~6px);
+ * `"md"` is slightly larger for CenterDock / SideDock tabs.
+ *
+ * @category Core Types
+ * @public
+ */
+export type ActivitySize = "sm" | "md";
+
+/**
+ * Map {@link AgentActivity} onto UI {@link Activity}. Returns `null` when there
+ * is nothing to paint (`none` / `dead` — callers may map `dead` → `"error"`
+ * themselves if they want chrome).
+ *
+ * @category Core Types
+ * @public
+ */
+export function activityFromAgent(a: AgentActivity): Activity | null {
+  switch (a) {
+    case "working":
+      return "working";
+    case "idle":
+      return "ready";
+    case "error":
+      return "error";
+    case "none":
+    case "dead":
+      return null;
+  }
+}
+
+/**
+ * Resolve the host `.silo-activity*` class string. Pinned by unit tests
+ * (RFC 0016 class-contract pattern). When `activity` is omitted, uses the
+ * neutral workspace fallback (gray “none” look).
+ *
+ * @internal
+ */
+export function activityClass(
+  activity: Activity | undefined,
+  size: ActivitySize = "sm",
+): string {
+  const kind = activity ?? "none";
+  return `silo-activity silo-activity-${kind} silo-activity-${size}`;
+}

package/src/agents-service.ts

@@ -0,0 +1,181 @@
+import type { Disposable } from "./types";
+import type { TerminalKind } from "./domain-types";
+
+// `ctx.agents` — host-computed coding-agent activity and resume-identity
+// observability. See RFC 0018 (docs/proposals/0018-ctx-agents-surface.md).
+// Detection is fully sealed inside the host implementation — there is no
+// registration API for detectors or resume-hint resolvers. Extensions only
+// ever read this surface.
+
+/**
+ * What a terminal's agent is currently doing, as classified by the host from
+ * OSC/output signals. `"none"` means no agent activity has been observed
+ * (including plain, non-agent shells). `"idle"` means the agent finished its
+ * last turn and is waiting for the next input — this is purely a fact about
+ * the agent itself, independent of whether anyone is looking at the
+ * terminal; see {@link AgentInfo.needsAttention} for the separate "has a
+ * human seen this" signal (an earlier design conflated the two into a
+ * `"waiting"`/`"done"` split on `activity` itself — dropped once it turned
+ * out to carry no information `needsAttention` didn't already have).
+ * `"dead"` is distinct from a merely `stale` restored state — see
+ * {@link AgentInfo.stale} — and means the terminal's backend was confirmed
+ * gone (no daemon to reattach to) after an unclean shutdown; nothing will
+ * arrive to resolve this on its own.
+ *
+ * @category Core Types
+ * @public
+ * @beta
+ */
+export type AgentActivity = "none" | "working" | "idle" | "error" | "dead";
+
+/**
+ * Live agent-activity and resume-identity state for one terminal, computed
+ * once by the host and shared across every subscriber — never recomputed
+ * per-extension. Returned by {@link AgentsService.getState} and
+ * {@link AgentsService.getByTerminalId}; delivered to
+ * {@link AgentsService.subscribe} listeners on every change.
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export interface AgentInfo {
+  /** The terminal record id this state belongs to. */
+  readonly terminalId: string;
+  /** The workspace this terminal belongs to. */
+  readonly workspaceId: string;
+  /** The terminal's kind at registration time (`"shell"`, `"claude"`, `"pi"`). */
+  readonly kind: TerminalKind;
+  /**
+   * Whether this terminal currently hosts an agent — true if it was created
+   * as one, or an agent-specific signal was observed in it (e.g. typing
+   * `claude` into a plain shell).
+   */
+  readonly isAgent: boolean;
+  /** Current classified activity. */
+  readonly activity: AgentActivity;
+  /**
+   * Sticky "finished, go look" flag: set when the agent goes idle in a
+   * terminal that wasn't the active one at that moment, and cleared only by
+   * {@link AgentsService.acknowledge}. Never set at all if the terminal
+   * *was* already active the instant the agent went idle — being watched
+   * live counts as already seen, no acknowledgment needed.
+   */
+  readonly needsAttention: boolean;
+  /** ISO timestamp of when `needsAttention` was set; undefined when not pending. */
+  readonly attentionSince?: string;
+  /** ISO timestamp of when the current `"working"` phase started; undefined otherwise. */
+  readonly workingSince?: string;
+  /**
+   * Soft, time-gap-based, **self-clearing** signal: this restored `working`/
+   * `needsAttention` duration followed a gap long enough that it can't be
+   * fully trusted — the agent may have finished without it being observed.
+   * The next live signal clears it automatically. Distinct from
+   * `activity === "dead"`, which is a hard, structural, non-self-resolving
+   * fact — see {@link AgentActivity}.
+   */
+  readonly stale: boolean;
+  /**
+   * Exact session identifier for the agent running in this terminal, when one
+   * could be determined. Present only when an opt-in `SessionStart` hook has
+   * reported it (see the Settings → Agents page); absent otherwise — Silo
+   * never *infers* a session id by directory/recency, since that can silently
+   * resolve to the wrong session. Populated live once the hook fires (not
+   * deferred to death), then persisted, so a consumer reacting to
+   * `activity === "dead"` can read it back.
+   */
+  readonly sessionId?: string;
+  /**
+   * A ready-to-show (and copy/paste) resume hint. Either an exact
+   * `"claude --resume 01abc..."` (when {@link AgentInfo.sessionId} was
+   * resolved via a hook) or an honest, session-id-less
+   * `"was running claude in ~/foo"` note (when it wasn't). Attached the first
+   * time the terminal's agent is detected and persisted, so it is available
+   * both live and at `activity === "dead"`.
+   */
+  readonly resumeCommand?: string;
+  /**
+   * Human-readable agent name, e.g. `"Claude Code"` or `"Codex CLI"`. Tells
+   * you *which* agent CLI is running in this terminal, independent of
+   * whether an exact session id was ever resolved — populated as soon as a
+   * known agent leader is detected at all (same moment
+   * {@link AgentInfo.resumeCommand} is first attached), not deferred until
+   * {@link AgentInfo.sessionId} is available.
+   */
+  readonly agentName?: string;
+  /**
+   * Stable catalog key for the agent, e.g. `"claude"` or `"codex"` — unlike
+   * {@link AgentInfo.agentName} (a display string meant for showing to the
+   * user), this is meant for an extension's own code to switch or compare
+   * on, and won't change if the display name is ever reworded. Populated at
+   * the same moment and lifecycle as `agentName`.
+   */
+  readonly agentId?: string;
+}
+
+/**
+ * Host-computed coding-agent observability — exposed as
+ * {@link ExtensionContext.agents}. Detection (what OSC/output signals mean
+ * for a given agent) and resume-hint resolution are both sealed inside the
+ * host implementation; there is no registration API. Mirrors
+ * {@link ProcessesService} in shape: one shared, canonical answer, not
+ * something each extension recomputes — reads are unscoped, and
+ * {@link AgentsService.acknowledge} is the one deliberately scoped mutation,
+ * the same pattern {@link ProcessesService.kill} establishes.
+ *
+ * @example
+ * ```ts
+ * const sub = ctx.agents.subscribe((agents) => {
+ *   const dead = agents.find((a) => a.activity === "dead");
+ *   if (dead) ctx.ui.notify("info", dead.resumeCommand ?? "An agent session ended.");
+ * });
+ * ctx.subscriptions.push(sub);
+ * ```
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export interface AgentsService {
+  /**
+   * Current {@link AgentInfo} for every tracked terminal in the active
+   * workspace. Pass `{ allWorkspaces: true }` for every loaded workspace
+   * instead.
+   */
+  getState(options?: { allWorkspaces?: boolean }): AgentInfo[];
+  /** Look up {@link AgentInfo} for a specific terminal tab by its record id. */
+  getByTerminalId(terminalId: string): AgentInfo | undefined;
+  /**
+   * Subscribe to changes in the active workspace's agent state. Pass
+   * `{ allWorkspaces: true }` to be notified across every loaded workspace
+   * instead. Returns a {@link Disposable} that cancels the subscription.
+   */
+  subscribe(
+    listener: (state: AgentInfo[]) => void,
+    options?: { allWorkspaces?: boolean },
+  ): Disposable;
+  /**
+   * Acknowledge a finished run: clears {@link AgentInfo.needsAttention} (and
+   * its `attentionSince` timestamp). A no-op if the terminal wasn't pending
+   * attention. Doesn't touch `activity` — `"idle"` already correctly
+   * describes the agent both before and after acknowledgment; only whether
+   * a human has seen it changes.
+   *
+   * Deliberately **not** wired to focus automatically by the host — whether
+   * *viewing* a terminal should count as acknowledging it is a per-consumer
+   * policy call this method leaves to you, not a fixed rule `ctx.agents`
+   * imposes. Call it from wherever your own UI decides a run has been seen —
+   * typically `ctx.terminals.subscribeActive`, but it doesn't have to be.
+   *
+   * @example
+   * ```ts
+   * // Acknowledge whenever the user actually looks at the terminal.
+   * ctx.subscriptions.push(
+   *   ctx.terminals.subscribeActive((terminalId) => {
+   *     if (terminalId) ctx.agents.acknowledge(terminalId);
+   *   }),
+   * );
+   * ```
+   */
+  acknowledge(terminalId: string): void;
+}

package/src/editor-service.ts

@@ -1,6 +1,7 @@
 import type { Disposable } from "./types";
 import type { Event } from "./event";
 import type { EditorMode } from "./domain-types";
+import type { TabAdornmentMethods } from "./tab-adornment";
 
 // `ctx.editors` — the editor & document domain (public contract). Opening files
 // into editor tabs, the active-editor save/close commands, the diff-content
@@ -225,10 +226,13 @@ export interface EditorSaveEvent {
  * editors register save handlers. The single entry point for opening editors —
  * prefer it over reaching into workspace/editor state.
  *
+ * Tab chrome adornments (`setIcon` / `setIndicator` / …) take an **editor id**
+ * as the target — see {@link TabAdornmentMethods}.
+ *
  * @category Consumer Services
  * @public
  */
-export interface EditorService {
+export interface EditorService extends TabAdornmentMethods {
   /**
    * Open a file in an editor tab. Promotes an existing preview, focuses an
    * already-open tab, or opens a new one.