@silo-code/sdk 0.31.0 → 0.33.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.31.0",
+  "version": "0.33.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/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.

package/src/icon-button-classes.test.ts

@@ -5,9 +5,19 @@ describe("iconButtonClass", () => {
   it("defaults to silo-icon-button", () => {
     expect(iconButtonClass()).toBe("silo-icon-button");
     expect(iconButtonClass("normal")).toBe("silo-icon-button");
+    expect(iconButtonClass("normal", "normal")).toBe("silo-icon-button");
   });
 
   it("adds the sm modifier", () => {
     expect(iconButtonClass("sm")).toBe("silo-icon-button silo-icon-button-sm");
   });
+
+  it("adds the toolbar variant", () => {
+    expect(iconButtonClass("normal", "toolbar")).toBe(
+      "silo-icon-button silo-icon-button-toolbar",
+    );
+    expect(iconButtonClass("sm", "toolbar")).toBe(
+      "silo-icon-button silo-icon-button-sm silo-icon-button-toolbar",
+    );
+  });
 });

package/src/icon-button-classes.ts

@@ -6,14 +6,27 @@
  */
 export type IconButtonSize = "normal" | "sm";
 
+/**
+ * Visual tone for {@link IconButton}. `"toolbar"` matches the local-web-viewer
+ * bar buttons (toolbar-text icons, hover fill only, no press-scale).
+ *
+ * @internal
+ */
+export type IconButtonVariant = "normal" | "toolbar";
+
 /**
  * Resolve the host `.silo-icon-button*` class string for an IconButton's
- * `size`. Default is the 32px standalone size; `sm` adds the 26px modifier.
+ * `size` + `variant`. Default is the standalone size; `sm` adds the compact
+ * modifier; `toolbar` swaps in the breadcrumb/panel-toolbar tone.
  *
  * @internal
  */
-export function iconButtonClass(size: IconButtonSize = "normal"): string {
-  return size === "sm"
-    ? "silo-icon-button silo-icon-button-sm"
-    : "silo-icon-button";
+export function iconButtonClass(
+  size: IconButtonSize = "normal",
+  variant: IconButtonVariant = "normal",
+): string {
+  const parts = ["silo-icon-button"];
+  if (size === "sm") parts.push("silo-icon-button-sm");
+  if (variant === "toolbar") parts.push("silo-icon-button-toolbar");
+  return parts.join(" ");
 }

package/src/index.ts

@@ -110,6 +110,40 @@ export type {
   TerminalTabDecorationProvider,
   OscEvent,
 } from "./terminal-service";
+export type {
+  TabAdornmentColor,
+  TabIconAdornment,
+  TabHighlightAdornment,
+  TabIndicatorAdornment,
+  TabIndicatorFlash,
+  TabActivityAdornment,
+  TabActivityFlash,
+  TabIconContribution,
+  TabHighlightContribution,
+  TabIndicatorContribution,
+  TabActivityContribution,
+  TabIconBinder,
+  TabHighlightBinder,
+  TabIndicatorBinder,
+  TabActivityBinder,
+  TabAdornmentMethods,
+} from "./tab-adornment";
+export type { Activity, ActivitySize } from "./activity";
+export { activityFromAgent } from "./activity";
+export { ActivityGlyph } from "./ActivityGlyph";
+export type { PhosphorIconName } from "./phosphor-icon";
+export type {
+  ToolbarSurface,
+  ToolbarItemContext,
+  ToolbarItemFields,
+  ToolbarCommandItemContribution,
+  ToolbarMenuItemContribution,
+  ToolbarChromeFields,
+  ToolbarSeparatorContribution,
+  ToolbarSpacerSize,
+  ToolbarSpacerContribution,
+  ToolbarItemContribution,
+} from "./toolbar-items";
 export type {
   FileService,
   FileMeta,
@@ -226,7 +260,7 @@ export { Tooltip } from "./Tooltip";
 export { Button } from "./Button";
 export type { ButtonVariant, ButtonSize } from "./Button";
 export { IconButton } from "./IconButton";
-export type { IconButtonSize } from "./IconButton";
+export type { IconButtonSize, IconButtonVariant } from "./IconButton";
 export { Input } from "./Input";
 export { Textarea } from "./Textarea";
 export { SearchInput } from "./SearchInput";

package/src/phosphor-icon.ts

@@ -0,0 +1,14 @@
+/**
+ * Export name of an icon from `@phosphor-icons/react` — e.g. `"Flag"`,
+ * `"ArrowClockwise"`, `"PushPin"`. The host resolves the name and paints it:
+ * toolbar chrome uses `weight="bold"`; tab decorations use `weight="regular"`
+ * by default (`filled: true` → `weight="fill"`); both use `size="1em"` so
+ * glyphs track UI zoom.
+ *
+ * Use the PascalCase component name from
+ * [Phosphor](https://phosphoricons.com), not a kebab-case path.
+ *
+ * @category Registration
+ * @public
+ */
+export type PhosphorIconName = string;