@silo-code/sdk 0.9.0 → 0.10.1

package/dist/index.d.ts

@@ -11,11 +11,11 @@
  */
 export type { Disposable, DockPanelApi, DockPanelProps, EditorProps, EditorCapabilities, Editor, NewFileTemplate, FileType, Command, MenuId, MenuItemContribution, Keybinding, SidePanelProps, SidePanel, DockPanelKind, StatusItem, SettingsPage, ExtensionContext, Extension, ExtensionManifest, ExtensionHandle, } from "./types";
 export type { Workspace, EditorMode, EditorRecord, SidePanelSlot, } from "./domain-types";
-export type { WorkspaceService, WorkspaceState, CreateWorkspaceInput, } from "./workspace-service";
+export type { WorkspaceService, WorkspaceState, CreateWorkspaceInput, WorkspaceStatusRow, WorkspaceDecorationProvider, } from "./workspace-service";
 export type { EditorService, EditorSaveHandlers, OpenFileOptions, EditorViewInfo, OpenDiffSpec, DiffContent, DiffContentRequest, DiffContentProvider, } from "./editor-service";
 export type { LayoutService, LayoutState, SidePanelColumnState, SideLocation, } from "./layout-service";
 export type { ProcessService, ProcessSession, ProcessSpawnOptions, ProcessExecOptions, ProcessExecResult, } from "./process-service";
-export type { TerminalService, CreateTerminalInput, TerminalKind, TerminalRecord, } from "./terminal-service";
+export type { TerminalService, CreateTerminalInput, TerminalKind, TerminalRecord, TerminalTabDecoration, TerminalTabDecorationProvider, } from "./terminal-service";
 export type { FileService, FileMeta, FileChangeEvent } from "./file-service";
 export type { SearchService, SearchOptions, SearchMatch, SearchFileResult, SearchResponse, } from "./search-service";
 export type { Permission } from "./permissions";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,EACP,MAAM,EACN,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAKjB,YAAY,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7E,YAAY,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAI1B,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,YAAY,EACV,UAAU,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,OAAO,EACP,WAAW,EACX,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,MAAM,EACN,eAAe,EACf,QAAQ,EACR,OAAO,EACP,MAAM,EACN,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAKjB,YAAY,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7E,YAAY,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAI1B,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,YAAY,EACV,UAAU,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,OAAO,EACP,WAAW,EACX,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqFH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA0BhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA8BzC,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyFH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA0BhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA8BzC,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/terminal-service.d.ts

@@ -1,5 +1,47 @@
+import type React from "react";
+import type { Disposable } from "./types";
 import type { TerminalKind, TerminalRecord } from "./domain-types";
 export type { TerminalKind, TerminalRecord } from "./domain-types";
+/**
+ * A decoration that an extension can attach to a terminal tab — a small icon
+ * with an optional tooltip and semantic color. Registered via
+ * {@link TerminalService.registerTabDecoration}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface TerminalTabDecoration {
+    /**
+     * Small React node rendered as a decoration badge on the tab (≤16 px).
+     * The extension supplies the shape; the host applies `color` via a CSS
+     * data attribute mapped to design tokens.
+     */
+    icon: React.ReactNode;
+    /** Tooltip shown when hovering the decoration icon. */
+    tooltip?: string;
+    /**
+     * Semantic color applied to the icon element. The host maps this to the
+     * matching `--silo-color-*` design token so themes control the exact shade.
+     */
+    color?: "accent" | "warn" | "ok" | "error" | "muted";
+}
+/**
+ * A decoration provider for terminal tabs. Register via
+ * {@link TerminalService.registerTabDecoration}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface TerminalTabDecorationProvider {
+    /** Unique id — conventionally `"<extension-id>.tab-decoration"`. */
+    id: string;
+    /**
+     * Called synchronously for each terminal tab during render. Return `null`
+     * to contribute nothing for this terminal. When multiple providers are
+     * registered, the first non-null result wins.
+     */
+    provide(terminalId: string): TerminalTabDecoration | null;
+}
 /**
  * Input for {@link TerminalService.create}.
  *
@@ -34,5 +76,33 @@ export interface TerminalService {
     create(input?: CreateTerminalInput): TerminalRecord | undefined;
     /** Close and kill every terminal in a workspace (e.g. on workspace delete). */
     closeWorkspace(workspaceId: string): void;
+    /**
+     * Switch to the workspace containing this terminal and activate its tab in
+     * the center dock. No-ops if the terminal id is unknown.
+     */
+    focus(terminalId: string): void;
+    /**
+     * Register a decoration provider for terminal tabs. The first registered
+     * provider that returns a non-null decoration for a terminal wins; subsequent
+     * providers are not consulted. Returns a {@link Disposable} that unregisters
+     * the provider.
+     */
+    registerTabDecoration(provider: TerminalTabDecorationProvider): Disposable;
+    /**
+     * Get the current decoration for a terminal tab. Returns the first non-null
+     * result from registered providers, or `null` if none apply.
+     */
+    getTabDecoration(terminalId: string): TerminalTabDecoration | null;
+    /**
+     * Signal that tab decoration data has changed. Fires all listeners registered
+     * via {@link TerminalService.subscribeTabDecorations}, causing terminal tabs
+     * to re-query providers and re-render their decoration.
+     */
+    invalidateTabDecorations(): void;
+    /**
+     * Subscribe to tab decoration invalidations. Returns a {@link Disposable}
+     * that cancels the subscription.
+     */
+    subscribeTabDecorations(listener: () => void): Disposable;
 }
 //# sourceMappingURL=terminal-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"terminal-service.d.ts","sourceRoot":"","sources":["../src/terminal-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGnE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS,CAAC;IAChE,+EAA+E;IAC/E,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C"}
+{"version":3,"file":"terminal-service.d.ts","sourceRoot":"","sources":["../src/terminal-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGnE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;CACtD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;CAC3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS,CAAC;IAChE,+EAA+E;IAC/E,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;OAKG;IACH,qBAAqB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,UAAU,CAAC;IAE3E;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;IAEnE;;;;OAIG;IACH,wBAAwB,IAAI,IAAI,CAAC;IAEjC;;;OAGG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;CAC3D"}

package/dist/workspace-service.d.ts

@@ -1,6 +1,44 @@
 import type { Disposable } from "./types";
 import type { Workspace } from "./domain-types";
 export type { Workspace, TerminalRecord } from "./domain-types";
+/**
+ * A single status row contributed by a {@link WorkspaceDecorationProvider}.
+ * Rows appear below the path line in the Workspaces side panel.
+ *
+ * @category Consumer Services
+ * @public
+ */
+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";
+    /** Short label — the host truncates with an ellipsis when space is tight. */
+    label: string;
+    /**
+     * ISO timestamp for when this row started. The host renders it as elapsed
+     * time using the same `formatElapsed` helper as workspace uptime ("6h", "2d",
+     * "just now").
+     */
+    startedAt?: string;
+}
+/**
+ * A decoration provider that contributes {@link WorkspaceStatusRow}s to
+ * workspace rows in the Workspaces side panel. Register via
+ * {@link WorkspaceService.registerDecoration}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface WorkspaceDecorationProvider {
+    /** Unique id for this provider — conventionally `"<extension-id>.decoration"`. */
+    id: string;
+    /**
+     * Called synchronously for each workspace during render. Return an empty
+     * array to contribute nothing for this workspace.
+     */
+    provide(workspaceId: string): WorkspaceStatusRow[];
+}
 /**
  * An immutable, frozen view of workspace state, returned by
  * {@link WorkspaceService.getState} and delivered to subscribers — read
@@ -68,5 +106,49 @@ export interface WorkspaceService {
     removeFolder(id: string, folder: string): void;
     /** Hard delete — permanent removal. */
     delete(id: string): void;
+    /**
+     * Register a decoration 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.
+     *
+     * @example
+     * ```ts
+     * ctx.subscriptions.push(
+     *   ctx.workspaces.registerDecoration({
+     *     id: "my-ext.decoration",
+     *     provide(workspaceId) {
+     *       const running = getRunningTasks(workspaceId);
+     *       return running.map(t => ({ id: t.id, status: "busy", label: t.name, startedAt: t.startedAt }));
+     *     },
+     *   }),
+     *   ctx.workspaces.subscribeDecorations(() => ctx.workspaces.invalidateDecorations()),
+     * );
+     * ```
+     */
+    registerDecoration(provider: WorkspaceDecorationProvider): 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.
+     */
+    getDecorations(workspaceId: string): WorkspaceStatusRow[];
+    /**
+     * Signal that decoration data has changed. Fires all listeners registered
+     * via {@link WorkspaceService.subscribeDecorations}, causing the Workspaces
+     * panel to re-query providers and re-render the status rows.
+     *
+     * Call this after any mutation to the state your `provide` function reads.
+     */
+    invalidateDecorations(): void;
+    /**
+     * Subscribe to decoration invalidations. The listener is called whenever
+     * {@link WorkspaceService.invalidateDecorations} is invoked. Returns a
+     * {@link Disposable} that cancels the subscription.
+     *
+     * The Workspaces panel subscribes internally; extensions may also subscribe
+     * to observe invalidations.
+     */
+    subscribeDecorations(listener: () => void): Disposable;
 }
 //# sourceMappingURL=workspace-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workspace-service.d.ts","sourceRoot":"","sources":["../src/workspace-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,GAAG,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3B,uEAAuE;IACvE,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,QAAQ,IAAI,cAAc,CAAC;IAC3B,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,GAAG,UAAU,CAAC;IAC7D;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACvC,0EAA0E;IAC1E,sBAAsB,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IACtE,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wBAAwB;IACxB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uFAAuF;IACvF,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,+CAA+C;IAC/C,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,uCAAuC;IACvC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}
+{"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.9.0",
+  "version": "0.10.1",
   "description": "The public, types-first SDK for building Silo extensions — the only surface third-party extensions import.",
   "license": "MIT",
   "author": "Dave Weaver",

package/src/index.ts

@@ -50,6 +50,8 @@ export type {
   WorkspaceService,
   WorkspaceState,
   CreateWorkspaceInput,
+  WorkspaceStatusRow,
+  WorkspaceDecorationProvider,
 } from "./workspace-service";
 export type {
   EditorService,
@@ -79,6 +81,8 @@ export type {
   CreateTerminalInput,
   TerminalKind,
   TerminalRecord,
+  TerminalTabDecoration,
+  TerminalTabDecorationProvider,
 } from "./terminal-service";
 export type { FileService, FileMeta, FileChangeEvent } from "./file-service";
 // Cross-file content search exposed on the ExtensionContext as `ctx.search`.

package/src/terminal-service.ts

@@ -1,8 +1,52 @@
+import type React from "react";
+import type { Disposable } from "./types";
 import type { TerminalKind, TerminalRecord } from "./domain-types";
 
 // Re-export the terminal domain types so consumers can name them from the SDK.
 export type { TerminalKind, TerminalRecord } from "./domain-types";
 
+/**
+ * A decoration that an extension can attach to a terminal tab — a small icon
+ * with an optional tooltip and semantic color. Registered via
+ * {@link TerminalService.registerTabDecoration}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface TerminalTabDecoration {
+  /**
+   * Small React node rendered as a decoration badge on the tab (≤16 px).
+   * The extension supplies the shape; the host applies `color` via a CSS
+   * data attribute mapped to design tokens.
+   */
+  icon: React.ReactNode;
+  /** Tooltip shown when hovering the decoration icon. */
+  tooltip?: string;
+  /**
+   * Semantic color applied to the icon element. The host maps this to the
+   * matching `--silo-color-*` design token so themes control the exact shade.
+   */
+  color?: "accent" | "warn" | "ok" | "error" | "muted";
+}
+
+/**
+ * A decoration provider for terminal tabs. Register via
+ * {@link TerminalService.registerTabDecoration}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface TerminalTabDecorationProvider {
+  /** Unique id — conventionally `"<extension-id>.tab-decoration"`. */
+  id: string;
+  /**
+   * Called synchronously for each terminal tab during render. Return `null`
+   * to contribute nothing for this terminal. When multiple providers are
+   * registered, the first non-null result wins.
+   */
+  provide(terminalId: string): TerminalTabDecoration | null;
+}
+
 /**
  * Input for {@link TerminalService.create}.
  *
@@ -38,4 +82,37 @@ export interface TerminalService {
   create(input?: CreateTerminalInput): TerminalRecord | undefined;
   /** Close and kill every terminal in a workspace (e.g. on workspace delete). */
   closeWorkspace(workspaceId: string): void;
+
+  /**
+   * Switch to the workspace containing this terminal and activate its tab in
+   * the center dock. No-ops if the terminal id is unknown.
+   */
+  focus(terminalId: string): void;
+
+  /**
+   * Register a decoration provider for terminal tabs. The first registered
+   * provider that returns a non-null decoration for a terminal wins; subsequent
+   * providers are not consulted. Returns a {@link Disposable} that unregisters
+   * the provider.
+   */
+  registerTabDecoration(provider: TerminalTabDecorationProvider): Disposable;
+
+  /**
+   * Get the current decoration for a terminal tab. Returns the first non-null
+   * result from registered providers, or `null` if none apply.
+   */
+  getTabDecoration(terminalId: string): TerminalTabDecoration | null;
+
+  /**
+   * Signal that tab decoration data has changed. Fires all listeners registered
+   * via {@link TerminalService.subscribeTabDecorations}, causing terminal tabs
+   * to re-query providers and re-render their decoration.
+   */
+  invalidateTabDecorations(): void;
+
+  /**
+   * Subscribe to tab decoration invalidations. Returns a {@link Disposable}
+   * that cancels the subscription.
+   */
+  subscribeTabDecorations(listener: () => void): Disposable;
 }

package/src/workspace-service.ts

@@ -4,6 +4,46 @@ import type { Workspace } from "./domain-types";
 // Re-export the workspace domain types so consumers can name them from the SDK.
 export type { Workspace, TerminalRecord } from "./domain-types";
 
+/**
+ * A single status row contributed by a {@link WorkspaceDecorationProvider}.
+ * Rows appear below the path line in the Workspaces side panel.
+ *
+ * @category Consumer Services
+ * @public
+ */
+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";
+  /** Short label — the host truncates with an ellipsis when space is tight. */
+  label: string;
+  /**
+   * ISO timestamp for when this row started. The host renders it as elapsed
+   * time using the same `formatElapsed` helper as workspace uptime ("6h", "2d",
+   * "just now").
+   */
+  startedAt?: string;
+}
+
+/**
+ * A decoration provider that contributes {@link WorkspaceStatusRow}s to
+ * workspace rows in the Workspaces side panel. Register via
+ * {@link WorkspaceService.registerDecoration}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface WorkspaceDecorationProvider {
+  /** Unique id for this provider — conventionally `"<extension-id>.decoration"`. */
+  id: string;
+  /**
+   * Called synchronously for each workspace during render. Return an empty
+   * array to contribute nothing for this workspace.
+   */
+  provide(workspaceId: string): WorkspaceStatusRow[];
+}
+
 /**
  * An immutable, frozen view of workspace state, returned by
  * {@link WorkspaceService.getState} and delivered to subscribers — read
@@ -73,4 +113,52 @@ export interface WorkspaceService {
   removeFolder(id: string, folder: string): void;
   /** Hard delete — permanent removal. */
   delete(id: string): void;
+
+  /**
+   * Register a decoration 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.
+   *
+   * @example
+   * ```ts
+   * ctx.subscriptions.push(
+   *   ctx.workspaces.registerDecoration({
+   *     id: "my-ext.decoration",
+   *     provide(workspaceId) {
+   *       const running = getRunningTasks(workspaceId);
+   *       return running.map(t => ({ id: t.id, status: "busy", label: t.name, startedAt: t.startedAt }));
+   *     },
+   *   }),
+   *   ctx.workspaces.subscribeDecorations(() => ctx.workspaces.invalidateDecorations()),
+   * );
+   * ```
+   */
+  registerDecoration(provider: WorkspaceDecorationProvider): 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.
+   */
+  getDecorations(workspaceId: string): WorkspaceStatusRow[];
+
+  /**
+   * Signal that decoration data has changed. Fires all listeners registered
+   * via {@link WorkspaceService.subscribeDecorations}, causing the Workspaces
+   * panel to re-query providers and re-render the status rows.
+   *
+   * Call this after any mutation to the state your `provide` function reads.
+   */
+  invalidateDecorations(): void;
+
+  /**
+   * Subscribe to decoration invalidations. The listener is called whenever
+   * {@link WorkspaceService.invalidateDecorations} is invoked. Returns a
+   * {@link Disposable} that cancels the subscription.
+   *
+   * The Workspaces panel subscribes internally; extensions may also subscribe
+   * to observe invalidations.
+   */
+  subscribeDecorations(listener: () => void): Disposable;
 }