@silo-code/sdk 0.41.0 → 0.43.0

package/dist/AgentIconGlyph.d.ts

@@ -0,0 +1,30 @@
+import type { AgentIcon, AgentIconMode } from "./agents-service.js";
+/**
+ * Renders a Catalog Agent's brand mark from its {@link AgentIcon} data (get one
+ * from {@link AgentsService.catalog}). Data-driven on purpose — it takes the
+ * icon, not an agent id, so it has no dependency on the sealed catalog and one
+ * renderer serves the host `+` menu, `silo.agents`, and third-party extensions.
+ *
+ * Returns `null` when `mode` is `"none"` or `icon` is absent — callers that
+ * gate tab chrome on "is there an icon" should check the return value, not
+ * construct the element unconditionally.
+ *
+ * `"color"` tints the glyph with the brand's own hex (picking
+ * {@link AgentIcon.hexLight} / {@link AgentIcon.hexDark} by `colorScheme`, since
+ * one hex can't contrast against both a light and a dark tab strip);
+ * `"monotone"` leaves `color` unset so it inherits `currentColor` from an
+ * ancestor. A duotone source (OpenCode's frame + panel) layers a second
+ * 40%-opacity path rather than flattening to one fill.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export declare function AgentIconGlyph({ icon, mode, colorScheme, className, }: {
+    icon: AgentIcon | undefined;
+    mode: AgentIconMode;
+    /** The host's active light/dark base — selects `hexLight` / `hexDark` in
+     *  `"color"` mode. */
+    colorScheme: "dark" | "light";
+    className?: string;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=AgentIconGlyph.d.ts.map

package/dist/AgentIconGlyph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentIconGlyph.d.ts","sourceRoot":"","sources":["../src/AgentIconGlyph.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,SAAS,GACV,EAAE;IACD,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB;0BACsB;IACtB,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,sCAqBA"}

package/dist/AgentIconGlyph.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Renders a Catalog Agent's brand mark from its {@link AgentIcon} data (get one
+ * from {@link AgentsService.catalog}). Data-driven on purpose — it takes the
+ * icon, not an agent id, so it has no dependency on the sealed catalog and one
+ * renderer serves the host `+` menu, `silo.agents`, and third-party extensions.
+ *
+ * Returns `null` when `mode` is `"none"` or `icon` is absent — callers that
+ * gate tab chrome on "is there an icon" should check the return value, not
+ * construct the element unconditionally.
+ *
+ * `"color"` tints the glyph with the brand's own hex (picking
+ * {@link AgentIcon.hexLight} / {@link AgentIcon.hexDark} by `colorScheme`, since
+ * one hex can't contrast against both a light and a dark tab strip);
+ * `"monotone"` leaves `color` unset so it inherits `currentColor` from an
+ * ancestor. A duotone source (OpenCode's frame + panel) layers a second
+ * 40%-opacity path rather than flattening to one fill.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export function AgentIconGlyph({ icon, mode, colorScheme, className, }) {
+    if (mode === "none" || !icon)
+        return null;
+    const hex = colorScheme === "light" ? icon.hexLight : icon.hexDark;
+    return (_jsxs("svg", { viewBox: "0 0 24 24", className: className, style: mode === "color" ? { color: `#${hex}` } : undefined, "aria-hidden": "true", children: [_jsx("path", { d: icon.path, fill: "currentColor", fillRule: icon.fillRule }), icon.accentPath && (_jsx("path", { d: icon.accentPath, fill: "currentColor", fillRule: icon.accentFillRule, opacity: 0.4 }))] }));
+}
+//# sourceMappingURL=AgentIconGlyph.js.map

package/dist/AgentIconGlyph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentIconGlyph.js","sourceRoot":"","sources":["../src/AgentIconGlyph.tsx"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,SAAS,GAQV;IACC,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAG,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACnE,OAAO,CACL,eACE,OAAO,EAAC,WAAW,EACnB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,iBAC9C,MAAM,aAElB,eAAM,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAC,cAAc,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAI,EAClE,IAAI,CAAC,UAAU,IAAI,CAClB,eACE,CAAC,EAAE,IAAI,CAAC,UAAU,EAClB,IAAI,EAAC,cAAc,EACnB,QAAQ,EAAE,IAAI,CAAC,cAAc,EAC7B,OAAO,EAAE,GAAG,GACZ,CACH,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/MenuButton.d.ts

@@ -1,6 +1,6 @@
 import type { ButtonHTMLAttributes, ReactNode } from "react";
-import { type MenuButtonSize } from "./menu-button-classes.js";
-export type { MenuButtonSize };
+import { type MenuButtonSize, type MenuButtonVariant } from "./menu-button-classes.js";
+export type { MenuButtonSize, MenuButtonVariant };
 /**
  * A **labelled** button that opens a menu — the counterpart to
  * {@link IconButton} for the cases where a bare `⋮` doesn't tell anyone what
@@ -17,7 +17,9 @@ export type { MenuButtonSize };
  * lines up under the button.
  *
  * Styled purely via host-provided `.silo-menu-button*` classes — no stylesheet
- * import is needed in the extension.
+ * import is needed in the extension. `variant="field"` gives it `Input` /
+ * `Select` chrome (border, full width, trailing chevron) for use as a value
+ * picker in a form, where a rich menu (icons, checks) beats a native `<select>`.
  *
  * @example
  * ```tsx
@@ -36,16 +38,30 @@ export type { MenuButtonSize };
  *
  * // compact — e.g. in a card footer or a ListRow's trailing slot
  * <MenuButton size="sm" label="More" onClick={openMenu} />
+ *
+ * // as a form field — a value picker inside a `Section`
+ * <MenuButton
+ *   variant="field"
+ *   label={agent?.displayName ?? "Auto-detect"}
+ *   onClick={(e) => ctx.ui.showMenu({ anchor: e.currentTarget, items })}
+ * >
+ *   <AgentIconGlyph icon={agent?.icon} mode="color" colorScheme={scheme} />
+ * </MenuButton>
  * ```
  *
  * @category Consumer Services
  * @public
  */
-export declare function MenuButton({ label, size, className, type, children, ...rest }: {
+export declare function MenuButton({ label, size, variant, className, type, children, ...rest }: {
     /** The visible label — the whole point of reaching for this over `IconButton`. */
     label: ReactNode;
     /** `sm` for compact contexts (card footers, list rows). */
     size?: MenuButtonSize;
+    /**
+     * `"bare"` (default) is a borderless label + chevron for toolbars and rows;
+     * `"field"` wears `Input` / `Select` chrome so it lines up as a form field.
+     */
+    variant?: MenuButtonVariant;
     /** Optional leading content, e.g. an icon before the label. */
     children?: ReactNode;
 } & Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children">): import("react").JSX.Element;

package/dist/MenuButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MenuButton.d.ts","sourceRoot":"","sources":["../src/MenuButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE7E,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,IAAe,EACf,SAAS,EACT,IAAe,EACf,QAAQ,EACR,GAAG,IAAI,EACR,EAAE;IACD,kFAAkF;IAClF,KAAK,EAAE,SAAS,CAAC;IACjB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC,+BA6B5D"}
+{"version":3,"file":"MenuButton.d.ts","sourceRoot":"","sources":["../src/MenuButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,IAAe,EACf,OAAgB,EAChB,SAAS,EACT,IAAe,EACf,QAAQ,EACR,GAAG,IAAI,EACR,EAAE;IACD,kFAAkF;IAClF,KAAK,EAAE,SAAS,CAAC;IACjB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC,+BA6B5D"}

package/dist/MenuButton.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { menuButtonClass } from "./menu-button-classes.js";
+import { menuButtonClass, } from "./menu-button-classes.js";
 /**
  * A **labelled** button that opens a menu — the counterpart to
  * {@link IconButton} for the cases where a bare `⋮` doesn't tell anyone what
@@ -16,7 +16,9 @@ import { menuButtonClass } from "./menu-button-classes.js";
  * lines up under the button.
  *
  * Styled purely via host-provided `.silo-menu-button*` classes — no stylesheet
- * import is needed in the extension.
+ * import is needed in the extension. `variant="field"` gives it `Input` /
+ * `Select` chrome (border, full width, trailing chevron) for use as a value
+ * picker in a form, where a rich menu (icons, checks) beats a native `<select>`.
  *
  * @example
  * ```tsx
@@ -35,13 +37,22 @@ import { menuButtonClass } from "./menu-button-classes.js";
  *
  * // compact — e.g. in a card footer or a ListRow's trailing slot
  * <MenuButton size="sm" label="More" onClick={openMenu} />
+ *
+ * // as a form field — a value picker inside a `Section`
+ * <MenuButton
+ *   variant="field"
+ *   label={agent?.displayName ?? "Auto-detect"}
+ *   onClick={(e) => ctx.ui.showMenu({ anchor: e.currentTarget, items })}
+ * >
+ *   <AgentIconGlyph icon={agent?.icon} mode="color" colorScheme={scheme} />
+ * </MenuButton>
  * ```
  *
  * @category Consumer Services
  * @public
  */
-export function MenuButton({ label, size = "normal", className, type = "button", children, ...rest }) {
-    const classes = menuButtonClass(size);
+export function MenuButton({ label, size = "normal", variant = "bare", className, type = "button", children, ...rest }) {
+    const classes = menuButtonClass(size, variant);
     return (_jsxs("button", { type: type, className: className ? `${classes} ${className}` : classes, "aria-haspopup": "menu", ...rest, children: [children, _jsx("span", { className: "silo-menu-button-label", children: label }), _jsx("svg", { className: "silo-menu-button-chevron", viewBox: "0 0 16 16", "aria-hidden": "true", children: _jsx("path", { d: "M4 6l4 4 4-4", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) })] }));
 }
 //# sourceMappingURL=MenuButton.js.map

package/dist/MenuButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"MenuButton.js","sourceRoot":"","sources":["../src/MenuButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAuB,MAAM,uBAAuB,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,KAAK,EACL,IAAI,GAAG,QAAQ,EACf,SAAS,EACT,IAAI,GAAG,QAAQ,EACf,QAAQ,EACR,GAAG,IAAI,EAQoD;IAC3D,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,CACL,kBACE,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,mBAG5C,MAAM,KAChB,IAAI,aAEP,QAAQ,EACT,eAAM,SAAS,EAAC,wBAAwB,YAAE,KAAK,GAAQ,EACvD,cACE,SAAS,EAAC,0BAA0B,EACpC,OAAO,EAAC,WAAW,iBACP,MAAM,YAElB,eACE,CAAC,EAAC,cAAc,EAChB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,GACtB,GACE,IACC,CACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"MenuButton.js","sourceRoot":"","sources":["../src/MenuButton.tsx"],"names":[],"mappings":";AACA,OAAO,EACL,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAI/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,KAAK,EACL,IAAI,GAAG,QAAQ,EACf,OAAO,GAAG,MAAM,EAChB,SAAS,EACT,IAAI,GAAG,QAAQ,EACf,QAAQ,EACR,GAAG,IAAI,EAaoD;IAC3D,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,CACL,kBACE,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,mBAG5C,MAAM,KAChB,IAAI,aAEP,QAAQ,EACT,eAAM,SAAS,EAAC,wBAAwB,YAAE,KAAK,GAAQ,EACvD,cACE,SAAS,EAAC,0BAA0B,EACpC,OAAO,EAAC,WAAW,iBACP,MAAM,YAElB,eACE,CAAC,EAAC,cAAc,EAChB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,GACtB,GACE,IACC,CACV,CAAC;AACJ,CAAC"}

package/dist/agents-service.d.ts

@@ -36,7 +36,15 @@ export interface AgentInfo {
     readonly terminalId: string;
     /** The workspace this terminal belongs to. */
     readonly workspaceId: string;
-    /** The terminal's kind at registration time (`"shell"`, `"claude"`, `"pi"`). */
+    /**
+     * The terminal's kind at registration time.
+     *
+     * @deprecated Always `"shell"` after RFC 0033 — the deprecated `"claude"` /
+     * `"pi"` kinds are normalized away at load and nothing creates them, so a
+     * consumer branching on this is reading a constant. Use
+     * {@link AgentInfo.agentId} for which agent is running, and
+     * {@link AgentInfo.isAgent} for whether one is.
+     */
     readonly kind: TerminalKind;
     /**
      * Whether this terminal currently hosts an agent — true if it was created
@@ -104,6 +112,54 @@ export interface AgentInfo {
      */
     readonly agentId?: string;
 }
+/**
+ * A Catalog Agent's brand mark — SVG path data plus the two theme-dependent
+ * hexes. Consumed by {@link AgentIconGlyph}; a single hex cannot have enough
+ * contrast against both a light and a dark tab strip, so `"color"` mode picks
+ * `hexLight` / `hexDark` by the host's active base.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface AgentIcon {
+    /** Display name, for the glyph's accessible label. */
+    title: string;
+    /** The brand's color against a light background, no leading `#`. */
+    hexLight: string;
+    /** The brand's color against a dark background, no leading `#`. */
+    hexDark: string;
+    /** SVG path data, `viewBox="0 0 24 24"`. */
+    path: string;
+    /** Set when the source path assumes `fill-rule: evenodd`; omit for the SVG
+     *  default (`nonzero`). */
+    fillRule?: "evenodd";
+    /** A second path (same viewBox) layered on {@link AgentIcon.path} at 40%
+     *  opacity, for a genuinely duotone mark (OpenCode's frame + inner panel). */
+    accentPath?: string;
+    /** `fill-rule` for {@link AgentIcon.accentPath}, independent of `fillRule`. */
+    accentFillRule?: "evenodd";
+}
+/**
+ * How {@link AgentIconGlyph} renders: `"none"` draws nothing, `"color"` tints
+ * with the brand hex, `"monotone"` inherits `currentColor`.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export type AgentIconMode = "none" | "color" | "monotone";
+/**
+ * One Catalog Agent as an extension may read it through
+ * {@link AgentsService.catalog}. Read-only — detection stays sealed (ADR 0028)
+ * and there is no way to register into the catalog.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface CatalogAgentSummary {
+    readonly id: string;
+    readonly displayName: string;
+    readonly icon?: AgentIcon;
+}
 /**
  * Host-computed coding-agent observability — exposed as
  * {@link ExtensionContext.agents}. Detection (what OSC/output signals mean
@@ -170,5 +226,18 @@ export interface AgentsService {
      * ```
      */
     acknowledge(terminalId: string): void;
+    /**
+     * Every coding agent Silo knows about, as read-only
+     * {@link CatalogAgentSummary} records. Detection stays sealed (ADR 0028) —
+     * there is no way to register into this list.
+     *
+     * The returned array is **memoized and deeply frozen**: it is read inside
+     * tab-icon rendering (`ctx.terminals.bindIcon`), so a fresh allocation per
+     * call would be a per-render cost and a mutable one a correctness hazard.
+     *
+     * @category Consumer Services
+     * @public
+     */
+    catalog(): readonly CatalogAgentSummary[];
 }
 //# sourceMappingURL=agents-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agents-service.d.ts","sourceRoot":"","sources":["../src/agents-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,EAAE,CAAC;IAC7D,8EAA8E;IAC9E,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3D;;;;OAIG;IACH,SAAS,CACP,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,EACtC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACpC,UAAU,CAAC;IACd;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC"}
+{"version":3,"file":"agents-service.d.ts","sourceRoot":"","sources":["../src/agents-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb;+BAC2B;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;kFAC8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,EAAE,CAAC;IAC7D,8EAA8E;IAC9E,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3D;;;;OAIG;IACH,SAAS,CACP,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,EACtC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACpC,UAAU,CAAC;IACd;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,SAAS,mBAAmB,EAAE,CAAC;CAC3C"}

package/dist/domain-types.d.ts

@@ -10,6 +10,17 @@
 /**
  * The kind of a terminal session.
  *
+ * @remarks
+ * The `"claude"` and `"pi"` values are **deprecated** (RFC 0033). Nothing in
+ * Silo creates a terminal with those kinds any more, and a persisted record
+ * carrying one is normalized to `"shell"` at load. Use an **Agent Profile** to
+ * start an agent in a terminal — it is the launch-time vocabulary for "which
+ * agent"; `TerminalKind` is neither the launch nor the identity vocabulary.
+ * `ctx.terminals.create({ kind: "claude" | "pi" })` still works (it creates a
+ * `"shell"` terminal and launches a matching profile if one exists), and the
+ * type keeps both values so third-party code compiles — removal is gated on a
+ * later engine bump.
+ *
  * @category Core Types
  * @public
  */
@@ -48,6 +59,20 @@ export interface TerminalRecord {
     cwd?: string;
     /** ISO timestamp of the last output we observed; used to pick a workspace's "primary" terminal. */
     lastActiveAt?: string;
+    /**
+     * The id of the Agent Profile this terminal was launched from (RFC 0033),
+     * when Silo launched it with one. A terminal created any other way — "New
+     * Terminal", the watermark, `core.newTerminal`, `ctx.terminals.create` — has
+     * no `profileId`; Silo never guesses one for a hand-typed agent.
+     *
+     * Written at launch and maintained by the host: renaming a profile's id
+     * rewrites this, deleting the profile clears it. It is written and kept
+     * current in phase 1 but not yet read — its first consumer is resume
+     * composition (RFC 0033 phase 4).
+     *
+     * @public
+     */
+    profileId?: string;
 }
 /**
  * The two modes of the one editor surface: a read-write text editor, or a

package/dist/domain-types.d.ts.map

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

package/dist/extension-storage.d.ts

@@ -34,8 +34,9 @@ export interface ExtensionStorage {
     subscribe(listener: () => void): Disposable;
 }
 /**
- * The two persisted-storage scopes available to an extension, exposed as
- * {@link ExtensionContext.storage}.
+ * The persisted-storage scopes available to an extension, exposed as
+ * {@link ExtensionContext.storage}: two key/value bags for settings-sized
+ * state, and the two matching **directories** for real data files.
  *
  * @category Consumer Services
  * @public
@@ -52,5 +53,55 @@ export interface ExtensionStorageScopes {
      * toggles). The bag is swapped when the active workspace changes.
      */
     readonly workspace: ExtensionStorage;
+    /**
+     * An absolute path to a **directory of your own**, shared across every
+     * workspace — the filesystem counterpart to {@link ExtensionStorageScopes.global}.
+     * Use it for real data files (a `.jsonl` log, a cache, an export) rather than
+     * inventing a path under the user's home directory.
+     *
+     * The directory is created on first call and lives under Silo's user-config
+     * root, namespaced by your extension id:
+     * `~/.config/silo/extension-storage/<your-id>/global`. The path is stable
+     * across calls, activations, and restarts.
+     *
+     * **No filesystem permission is needed inside it.** Paths beneath this
+     * directory are readable and writable through {@link ExtensionContext.files}
+     * without declaring `fs:read` or `fs:write` — your own storage is inside your
+     * sandbox, the same way the open workspace folder is. The lift stops at
+     * `ctx.files`: running a process with a working directory in here still needs
+     * the `process` permission (passing the path to a command as an *argument*
+     * needs nothing extra).
+     *
+     * Relative paths passed to `ctx.files` still resolve against the **workspace**,
+     * not this directory — always join onto the absolute path you get back.
+     *
+     * ```ts
+     * const dir = await ctx.storage.globalDir();
+     * await ctx.files.writeText(`${dir}/tasks.jsonl`, body);
+     * ```
+     *
+     * Uninstalling your extension does **not** delete this directory unless the
+     * user opts in; the data survives a reinstall.
+     */
+    globalDir(): Promise<string>;
+    /**
+     * An absolute path to a directory of your own scoped to the **active
+     * workspace** — the filesystem counterpart to
+     * {@link ExtensionStorageScopes.workspace}. Created on first call, at
+     * `~/.config/silo/extension-storage/<your-id>/workspaces/<workspaceId>`.
+     *
+     * Everything {@link ExtensionStorageScopes.globalDir} says about permissions
+     * and relative paths applies here too. Call it again after the active
+     * workspace changes — the path changes with it, so don't cache it across a
+     * workspace switch.
+     *
+     * The directory follows the workspace's **identity**, not its folder path:
+     * deleting a workspace and re-adding the same folder gives you a new, empty
+     * directory (the same rule {@link ExtensionStorageScopes.workspace} follows).
+     * Deleting a workspace leaves the directory on disk.
+     *
+     * Rejects with `NoWorkspaceError` when no workspace is open.
+     */
+    workspaceDir(): Promise<string>;
 }
 //# sourceMappingURL=extension-storage.d.ts.map

package/dist/extension-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-storage.d.ts","sourceRoot":"","sources":["../src/extension-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IACpC,kDAAkD;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,gDAAgD;IAChD,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC"}
+{"version":3,"file":"extension-storage.d.ts","sourceRoot":"","sources":["../src/extension-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IACpC,kDAAkD;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,gDAAgD;IAChD,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC"}

package/dist/index.d.ts

@@ -22,7 +22,7 @@ export type { EditorService, EditorSaveHandlers, OpenFileOptions, EditorViewInfo
 export type { LayoutService, LayoutState, SidePanelColumnState, SideLocation, SheetOptions, } from "./layout-service.js";
 export type { ProcessService, ProcessSession, ProcessSpawnOptions, ProcessExecOptions, ProcessExecResult, } from "./process-service.js";
 export type { ProcessesService, ProcessInfo, ProcessStats, ProcessTreeNode, } from "./processes-service.js";
-export type { AgentsService, AgentInfo, AgentActivity } from "./agents-service.js";
+export type { AgentsService, AgentInfo, AgentActivity, AgentIcon, AgentIconMode, CatalogAgentSummary, } from "./agents-service.js";
 export type { TerminalService, CreateTerminalInput, TerminalKind, TerminalRecord, TerminalTabDecoration, TerminalTabDecorationProvider, OscEvent, } from "./terminal-service.js";
 export type { TabAdornmentColor, TabIconAdornment, TabHighlightAdornment, TabIndicatorAdornment, TabIndicatorFlash, TabActivityAdornment, TabActivityFlash, TabIconContribution, TabHighlightContribution, TabIndicatorContribution, TabActivityContribution, TabIconBinder, TabHighlightBinder, TabIndicatorBinder, TabActivityBinder, TabAdornmentMethods, } from "./tab-adornment.js";
 export type { Activity, ActivitySize } from "./activity.js";
@@ -33,7 +33,7 @@ export type { ToolbarSurface, ToolbarItemContext, ToolbarItemFields, ToolbarComm
 export type { FileService, FileMeta, FileChangeKind, FileChangeEvent, } from "./file-service.js";
 export type { SearchService, SearchOptions, SearchMatch, SearchFileResult, SearchResponse, } from "./search-service.js";
 export type { Permission } from "./permissions.js";
-export { PathDeniedError } from "./permissions.js";
+export { PathDeniedError, NoWorkspaceError } from "./permissions.js";
 export type { ThemeService, ThemeState, ThemePreset, ResolvedTheme, ThemeBase, ThemeVars, CustomTheme, ThemeExport, } from "./theme-service.js";
 export type { ExtensionStorage, ExtensionStorageScopes, } from "./extension-storage.js";
 export type { DndService, DndItem, DndMime, DragInit, DndMode, DropContext, DropTargetHandlers, } from "./dnd-service.js";
@@ -53,7 +53,7 @@ export type { ButtonVariant, ButtonSize } from "./Button.js";
 export { IconButton } from "./IconButton.js";
 export type { IconButtonSize, IconButtonVariant } from "./IconButton.js";
 export { MenuButton } from "./MenuButton.js";
-export type { MenuButtonSize } from "./MenuButton.js";
+export type { MenuButtonSize, MenuButtonVariant } from "./MenuButton.js";
 export { Input } from "./Input.js";
 export { Textarea } from "./Textarea.js";
 export { SearchInput } from "./SearchInput.js";
@@ -73,6 +73,7 @@ export type { ListRowProps, ListRowTruncate } from "./List.js";
 export { AddRow } from "./AddRow.js";
 export { Badge } from "./Badge.js";
 export type { BadgeSize, BadgeTone } from "./Badge.js";
+export { AgentIconGlyph } from "./AgentIconGlyph.js";
 export { EmptyState } from "./EmptyState.js";
 export type { EmptyStateTone } from "./EmptyState.js";
 export { Callout } from "./Callout.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -17,7 +17,7 @@
  */
 export { activityFromAgent } from "./activity.js";
 export { ActivityGlyph } from "./ActivityGlyph.js";
-export { PathDeniedError } from "./permissions.js";
+export { PathDeniedError, NoWorkspaceError } from "./permissions.js";
 export { DND_MIME } from "./dnd-service.js";
 // Server-side HTTP client — bypasses CORS, readable response headers.
 export { NetworkError } from "./network-service.js";
@@ -48,6 +48,7 @@ export { Tabs, TabPanel } from "./Tabs.js";
 export { List, ListRow } from "./List.js";
 export { AddRow } from "./AddRow.js";
 export { Badge } from "./Badge.js";
+export { AgentIconGlyph } from "./AgentIconGlyph.js";
 export { EmptyState } from "./EmptyState.js";
 export { Callout } from "./Callout.js";
 export { Section } from "./Section.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsHH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAgChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA6BhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAyBzC,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkCjD,8EAA8E;AAC9E,8EAA8E;AAC9E,6DAA6D;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,4EAA4E;AAC5E,qDAAqD;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,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;AAUvE,6EAA6E;AAC7E,wEAAwE;AACxE,+CAA+C;AAC/C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA6HH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiChD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA6BlE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAyBzC,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkCjD,8EAA8E;AAC9E,8EAA8E;AAC9E,6DAA6D;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,4EAA4E;AAC5E,qDAAqD;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,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;AAUvE,6EAA6E;AAC7E,wEAAwE;AACxE,+CAA+C;AAC/C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC"}

package/dist/menu-button-classes.d.ts

@@ -6,10 +6,22 @@
  */
 export type MenuButtonSize = "normal" | "sm";
 /**
- * Resolve the host `.silo-menu-button*` class string for a MenuButton's `size`.
- * `sm` composes with the base class, matching how `.silo-button-sm` works.
+ * {@link MenuButton} chrome:
+ * - `"bare"` (default) — a borderless label + chevron, for toolbars and list
+ *   rows where the trigger sits among other inline controls.
+ * - `"field"` — input chrome (border, input background, full width, chevron
+ *   pushed to the trailing edge) so it lines up with `Input` / `Select` as a
+ *   form field. Reach for it when the menu is a value picker in a form.
  *
  * @internal
  */
-export declare function menuButtonClass(size?: MenuButtonSize): string;
+export type MenuButtonVariant = "bare" | "field";
+/**
+ * Resolve the host `.silo-menu-button*` class string for a MenuButton's `size`
+ * and `variant`. `sm` and `field` each compose onto the base class, matching
+ * how `.silo-button-sm` / `.silo-button-primary` work.
+ *
+ * @internal
+ */
+export declare function menuButtonClass(size?: MenuButtonSize, variant?: MenuButtonVariant): string;
 //# sourceMappingURL=menu-button-classes.d.ts.map

package/dist/menu-button-classes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu-button-classes.d.ts","sourceRoot":"","sources":["../src/menu-button-classes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,cAAyB,GAAG,MAAM,CAIvE"}
+{"version":3,"file":"menu-button-classes.d.ts","sourceRoot":"","sources":["../src/menu-button-classes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,GAAE,cAAyB,EAC/B,OAAO,GAAE,iBAA0B,GAClC,MAAM,CAKR"}

package/dist/menu-button-classes.js

@@ -1,12 +1,16 @@
 /**
- * Resolve the host `.silo-menu-button*` class string for a MenuButton's `size`.
- * `sm` composes with the base class, matching how `.silo-button-sm` works.
+ * Resolve the host `.silo-menu-button*` class string for a MenuButton's `size`
+ * and `variant`. `sm` and `field` each compose onto the base class, matching
+ * how `.silo-button-sm` / `.silo-button-primary` work.
  *
  * @internal
  */
-export function menuButtonClass(size = "normal") {
-    return size === "sm"
-        ? "silo-menu-button silo-menu-button-sm"
-        : "silo-menu-button";
+export function menuButtonClass(size = "normal", variant = "bare") {
+    const classes = ["silo-menu-button"];
+    if (size === "sm")
+        classes.push("silo-menu-button-sm");
+    if (variant === "field")
+        classes.push("silo-menu-button-field");
+    return classes.join(" ");
 }
 //# sourceMappingURL=menu-button-classes.js.map

package/dist/menu-button-classes.js.map

@@ -1 +1 @@
-{"version":3,"file":"menu-button-classes.js","sourceRoot":"","sources":["../src/menu-button-classes.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAuB,QAAQ;IAC7D,OAAO,IAAI,KAAK,IAAI;QAClB,CAAC,CAAC,sCAAsC;QACxC,CAAC,CAAC,kBAAkB,CAAC;AACzB,CAAC"}
+{"version":3,"file":"menu-button-classes.js","sourceRoot":"","sources":["../src/menu-button-classes.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAuB,QAAQ,EAC/B,UAA6B,MAAM;IAEnC,MAAM,OAAO,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACvD,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAChE,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/permissions.d.ts

@@ -43,4 +43,28 @@ export declare class PathDeniedError extends Error {
     readonly path: string;
     constructor(path: string, message?: string);
 }
+/**
+ * Thrown when an API that needs the **active workspace** is called while no
+ * workspace is open — today, {@link ExtensionStorageScopes.workspaceDir}.
+ *
+ * It is deliberately not a {@link PathDeniedError}: nothing was denied, there
+ * is simply nothing to scope to yet. Catch it to fall back to
+ * {@link ExtensionStorageScopes.globalDir | globalDir} or to defer the work
+ * until a workspace opens:
+ *
+ * ```ts
+ * try {
+ *   const dir = await ctx.storage.workspaceDir();
+ * } catch (err) {
+ *   if (err instanceof NoWorkspaceError) return; // nothing to persist yet
+ *   throw err;
+ * }
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export declare class NoWorkspaceError extends Error {
+    constructor(message?: string);
+}
 //# sourceMappingURL=permissions.d.ts.map

package/dist/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAS3C"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAS3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,CAAC,EAAE,MAAM;CAO7B"}

package/dist/permissions.js

@@ -37,4 +37,34 @@ export class PathDeniedError extends Error {
         Object.setPrototypeOf(this, PathDeniedError.prototype);
     }
 }
+/**
+ * Thrown when an API that needs the **active workspace** is called while no
+ * workspace is open — today, {@link ExtensionStorageScopes.workspaceDir}.
+ *
+ * It is deliberately not a {@link PathDeniedError}: nothing was denied, there
+ * is simply nothing to scope to yet. Catch it to fall back to
+ * {@link ExtensionStorageScopes.globalDir | globalDir} or to defer the work
+ * until a workspace opens:
+ *
+ * ```ts
+ * try {
+ *   const dir = await ctx.storage.workspaceDir();
+ * } catch (err) {
+ *   if (err instanceof NoWorkspaceError) return; // nothing to persist yet
+ *   throw err;
+ * }
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export class NoWorkspaceError extends Error {
+    constructor(message) {
+        super(message ?? "No workspace is open");
+        this.name = "NoWorkspaceError";
+        // Same prototype-chain restoration as PathDeniedError — `instanceof` has to
+        // survive the down-leveled build and the host↔extension boundary.
+        Object.setPrototypeOf(this, NoWorkspaceError.prototype);
+    }
+}
 //# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,qEAAqE;AA+BrE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAIxC,YAAY,IAAY,EAAE,OAAgB;QACxC,KAAK,CAAC,OAAO,IAAI,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAJ7D,8DAA8D;QACrD;;;;;WAAa;QAIpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,4EAA4E;QAC5E,4EAA4E;QAC5E,yCAAyC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,qEAAqE;AA+BrE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAIxC,YAAY,IAAY,EAAE,OAAgB;QACxC,KAAK,CAAC,OAAO,IAAI,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAJ7D,8DAA8D;QACrD;;;;;WAAa;QAIpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,4EAA4E;QAC5E,4EAA4E;QAC5E,yCAAyC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,4EAA4E;QAC5E,kEAAkE;QAClE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/terminal-service.d.ts

@@ -54,7 +54,14 @@ export interface TerminalTabDecorationProvider {
  * @public
  */
 export interface CreateTerminalInput {
-    /** Terminal kind — `"shell"` (default), `"claude"`, or `"pi"`. */
+    /**
+     * Terminal kind. Defaults to `"shell"`.
+     *
+     * @deprecated Pass `"shell"` (or omit). The `"claude"` / `"pi"` values are
+     * kept for compatibility (RFC 0033): they create a `"shell"` terminal and, if
+     * a matching Agent Profile exists, launch it — otherwise the bare command is
+     * typed. Start agents via an Agent Profile instead.
+     */
     kind?: TerminalKind;
     /** Working directory; falls back to the workspace folder when absent. */
     cwd?: string;

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silo-code/sdk",
-  "version": "0.41.0",
+  "version": "0.43.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/AgentIconGlyph.tsx

@@ -0,0 +1,56 @@
+import type { AgentIcon, AgentIconMode } from "./agents-service";
+
+/**
+ * Renders a Catalog Agent's brand mark from its {@link AgentIcon} data (get one
+ * from {@link AgentsService.catalog}). Data-driven on purpose — it takes the
+ * icon, not an agent id, so it has no dependency on the sealed catalog and one
+ * renderer serves the host `+` menu, `silo.agents`, and third-party extensions.
+ *
+ * Returns `null` when `mode` is `"none"` or `icon` is absent — callers that
+ * gate tab chrome on "is there an icon" should check the return value, not
+ * construct the element unconditionally.
+ *
+ * `"color"` tints the glyph with the brand's own hex (picking
+ * {@link AgentIcon.hexLight} / {@link AgentIcon.hexDark} by `colorScheme`, since
+ * one hex can't contrast against both a light and a dark tab strip);
+ * `"monotone"` leaves `color` unset so it inherits `currentColor` from an
+ * ancestor. A duotone source (OpenCode's frame + panel) layers a second
+ * 40%-opacity path rather than flattening to one fill.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export function AgentIconGlyph({
+  icon,
+  mode,
+  colorScheme,
+  className,
+}: {
+  icon: AgentIcon | undefined;
+  mode: AgentIconMode;
+  /** The host's active light/dark base — selects `hexLight` / `hexDark` in
+   *  `"color"` mode. */
+  colorScheme: "dark" | "light";
+  className?: string;
+}) {
+  if (mode === "none" || !icon) return null;
+  const hex = colorScheme === "light" ? icon.hexLight : icon.hexDark;
+  return (
+    <svg
+      viewBox="0 0 24 24"
+      className={className}
+      style={mode === "color" ? { color: `#${hex}` } : undefined}
+      aria-hidden="true"
+    >
+      <path d={icon.path} fill="currentColor" fillRule={icon.fillRule} />
+      {icon.accentPath && (
+        <path
+          d={icon.accentPath}
+          fill="currentColor"
+          fillRule={icon.accentFillRule}
+          opacity={0.4}
+        />
+      )}
+    </svg>
+  );
+}

package/src/MenuButton.tsx

@@ -1,7 +1,11 @@
 import type { ButtonHTMLAttributes, ReactNode } from "react";
-import { menuButtonClass, type MenuButtonSize } from "./menu-button-classes";
+import {
+  menuButtonClass,
+  type MenuButtonSize,
+  type MenuButtonVariant,
+} from "./menu-button-classes";
 
-export type { MenuButtonSize };
+export type { MenuButtonSize, MenuButtonVariant };
 
 /**
  * A **labelled** button that opens a menu — the counterpart to
@@ -19,7 +23,9 @@ export type { MenuButtonSize };
  * lines up under the button.
  *
  * Styled purely via host-provided `.silo-menu-button*` classes — no stylesheet
- * import is needed in the extension.
+ * import is needed in the extension. `variant="field"` gives it `Input` /
+ * `Select` chrome (border, full width, trailing chevron) for use as a value
+ * picker in a form, where a rich menu (icons, checks) beats a native `<select>`.
  *
  * @example
  * ```tsx
@@ -38,6 +44,15 @@ export type { MenuButtonSize };
  *
  * // compact — e.g. in a card footer or a ListRow's trailing slot
  * <MenuButton size="sm" label="More" onClick={openMenu} />
+ *
+ * // as a form field — a value picker inside a `Section`
+ * <MenuButton
+ *   variant="field"
+ *   label={agent?.displayName ?? "Auto-detect"}
+ *   onClick={(e) => ctx.ui.showMenu({ anchor: e.currentTarget, items })}
+ * >
+ *   <AgentIconGlyph icon={agent?.icon} mode="color" colorScheme={scheme} />
+ * </MenuButton>
  * ```
  *
  * @category Consumer Services
@@ -46,6 +61,7 @@ export type { MenuButtonSize };
 export function MenuButton({
   label,
   size = "normal",
+  variant = "bare",
   className,
   type = "button",
   children,
@@ -55,10 +71,15 @@ export function MenuButton({
   label: ReactNode;
   /** `sm` for compact contexts (card footers, list rows). */
   size?: MenuButtonSize;
+  /**
+   * `"bare"` (default) is a borderless label + chevron for toolbars and rows;
+   * `"field"` wears `Input` / `Select` chrome so it lines up as a form field.
+   */
+  variant?: MenuButtonVariant;
   /** Optional leading content, e.g. an icon before the label. */
   children?: ReactNode;
 } & Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children">) {
-  const classes = menuButtonClass(size);
+  const classes = menuButtonClass(size, variant);
   return (
     <button
       type={type}

package/src/agents-service.ts

@@ -44,7 +44,15 @@ export interface AgentInfo {
   readonly terminalId: string;
   /** The workspace this terminal belongs to. */
   readonly workspaceId: string;
-  /** The terminal's kind at registration time (`"shell"`, `"claude"`, `"pi"`). */
+  /**
+   * The terminal's kind at registration time.
+   *
+   * @deprecated Always `"shell"` after RFC 0033 — the deprecated `"claude"` /
+   * `"pi"` kinds are normalized away at load and nothing creates them, so a
+   * consumer branching on this is reading a constant. Use
+   * {@link AgentInfo.agentId} for which agent is running, and
+   * {@link AgentInfo.isAgent} for whether one is.
+   */
   readonly kind: TerminalKind;
   /**
    * Whether this terminal currently hosts an agent — true if it was created
@@ -113,6 +121,57 @@ export interface AgentInfo {
   readonly agentId?: string;
 }
 
+/**
+ * A Catalog Agent's brand mark — SVG path data plus the two theme-dependent
+ * hexes. Consumed by {@link AgentIconGlyph}; a single hex cannot have enough
+ * contrast against both a light and a dark tab strip, so `"color"` mode picks
+ * `hexLight` / `hexDark` by the host's active base.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface AgentIcon {
+  /** Display name, for the glyph's accessible label. */
+  title: string;
+  /** The brand's color against a light background, no leading `#`. */
+  hexLight: string;
+  /** The brand's color against a dark background, no leading `#`. */
+  hexDark: string;
+  /** SVG path data, `viewBox="0 0 24 24"`. */
+  path: string;
+  /** Set when the source path assumes `fill-rule: evenodd`; omit for the SVG
+   *  default (`nonzero`). */
+  fillRule?: "evenodd";
+  /** A second path (same viewBox) layered on {@link AgentIcon.path} at 40%
+   *  opacity, for a genuinely duotone mark (OpenCode's frame + inner panel). */
+  accentPath?: string;
+  /** `fill-rule` for {@link AgentIcon.accentPath}, independent of `fillRule`. */
+  accentFillRule?: "evenodd";
+}
+
+/**
+ * How {@link AgentIconGlyph} renders: `"none"` draws nothing, `"color"` tints
+ * with the brand hex, `"monotone"` inherits `currentColor`.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export type AgentIconMode = "none" | "color" | "monotone";
+
+/**
+ * One Catalog Agent as an extension may read it through
+ * {@link AgentsService.catalog}. Read-only — detection stays sealed (ADR 0028)
+ * and there is no way to register into the catalog.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface CatalogAgentSummary {
+  readonly id: string;
+  readonly displayName: string;
+  readonly icon?: AgentIcon;
+}
+
 /**
  * Host-computed coding-agent observability — exposed as
  * {@link ExtensionContext.agents}. Detection (what OSC/output signals mean
@@ -178,4 +237,17 @@ export interface AgentsService {
    * ```
    */
   acknowledge(terminalId: string): void;
+  /**
+   * Every coding agent Silo knows about, as read-only
+   * {@link CatalogAgentSummary} records. Detection stays sealed (ADR 0028) —
+   * there is no way to register into this list.
+   *
+   * The returned array is **memoized and deeply frozen**: it is read inside
+   * tab-icon rendering (`ctx.terminals.bindIcon`), so a fresh allocation per
+   * call would be a per-render cost and a mutable one a correctness hazard.
+   *
+   * @category Consumer Services
+   * @public
+   */
+  catalog(): readonly CatalogAgentSummary[];
 }

package/src/domain-types.ts

@@ -11,6 +11,17 @@
 /**
  * The kind of a terminal session.
  *
+ * @remarks
+ * The `"claude"` and `"pi"` values are **deprecated** (RFC 0033). Nothing in
+ * Silo creates a terminal with those kinds any more, and a persisted record
+ * carrying one is normalized to `"shell"` at load. Use an **Agent Profile** to
+ * start an agent in a terminal — it is the launch-time vocabulary for "which
+ * agent"; `TerminalKind` is neither the launch nor the identity vocabulary.
+ * `ctx.terminals.create({ kind: "claude" | "pi" })` still works (it creates a
+ * `"shell"` terminal and launches a matching profile if one exists), and the
+ * type keeps both values so third-party code compiles — removal is gated on a
+ * later engine bump.
+ *
  * @category Core Types
  * @public
  */
@@ -50,6 +61,20 @@ export interface TerminalRecord {
   cwd?: string;
   /** ISO timestamp of the last output we observed; used to pick a workspace's "primary" terminal. */
   lastActiveAt?: string;
+  /**
+   * The id of the Agent Profile this terminal was launched from (RFC 0033),
+   * when Silo launched it with one. A terminal created any other way — "New
+   * Terminal", the watermark, `core.newTerminal`, `ctx.terminals.create` — has
+   * no `profileId`; Silo never guesses one for a hand-typed agent.
+   *
+   * Written at launch and maintained by the host: renaming a profile's id
+   * rewrites this, deleting the profile clears it. It is written and kept
+   * current in phase 1 but not yet read — its first consumer is resume
+   * composition (RFC 0033 phase 4).
+   *
+   * @public
+   */
+  profileId?: string;
 }
 
 /**

package/src/extension-storage.ts

@@ -36,8 +36,9 @@ export interface ExtensionStorage {
 }
 
 /**
- * The two persisted-storage scopes available to an extension, exposed as
- * {@link ExtensionContext.storage}.
+ * The persisted-storage scopes available to an extension, exposed as
+ * {@link ExtensionContext.storage}: two key/value bags for settings-sized
+ * state, and the two matching **directories** for real data files.
  *
  * @category Consumer Services
  * @public
@@ -54,4 +55,54 @@ export interface ExtensionStorageScopes {
    * toggles). The bag is swapped when the active workspace changes.
    */
   readonly workspace: ExtensionStorage;
+  /**
+   * An absolute path to a **directory of your own**, shared across every
+   * workspace — the filesystem counterpart to {@link ExtensionStorageScopes.global}.
+   * Use it for real data files (a `.jsonl` log, a cache, an export) rather than
+   * inventing a path under the user's home directory.
+   *
+   * The directory is created on first call and lives under Silo's user-config
+   * root, namespaced by your extension id:
+   * `~/.config/silo/extension-storage/<your-id>/global`. The path is stable
+   * across calls, activations, and restarts.
+   *
+   * **No filesystem permission is needed inside it.** Paths beneath this
+   * directory are readable and writable through {@link ExtensionContext.files}
+   * without declaring `fs:read` or `fs:write` — your own storage is inside your
+   * sandbox, the same way the open workspace folder is. The lift stops at
+   * `ctx.files`: running a process with a working directory in here still needs
+   * the `process` permission (passing the path to a command as an *argument*
+   * needs nothing extra).
+   *
+   * Relative paths passed to `ctx.files` still resolve against the **workspace**,
+   * not this directory — always join onto the absolute path you get back.
+   *
+   * ```ts
+   * const dir = await ctx.storage.globalDir();
+   * await ctx.files.writeText(`${dir}/tasks.jsonl`, body);
+   * ```
+   *
+   * Uninstalling your extension does **not** delete this directory unless the
+   * user opts in; the data survives a reinstall.
+   */
+  globalDir(): Promise<string>;
+  /**
+   * An absolute path to a directory of your own scoped to the **active
+   * workspace** — the filesystem counterpart to
+   * {@link ExtensionStorageScopes.workspace}. Created on first call, at
+   * `~/.config/silo/extension-storage/<your-id>/workspaces/<workspaceId>`.
+   *
+   * Everything {@link ExtensionStorageScopes.globalDir} says about permissions
+   * and relative paths applies here too. Call it again after the active
+   * workspace changes — the path changes with it, so don't cache it across a
+   * workspace switch.
+   *
+   * The directory follows the workspace's **identity**, not its folder path:
+   * deleting a workspace and re-adding the same folder gives you a new, empty
+   * directory (the same rule {@link ExtensionStorageScopes.workspace} follows).
+   * Deleting a workspace leaves the directory on disk.
+   *
+   * Rejects with `NoWorkspaceError` when no workspace is open.
+   */
+  workspaceDir(): Promise<string>;
 }

package/src/index.ts

@@ -103,7 +103,14 @@ export type {
   ProcessStats,
   ProcessTreeNode,
 } from "./processes-service";
-export type { AgentsService, AgentInfo, AgentActivity } from "./agents-service";
+export type {
+  AgentsService,
+  AgentInfo,
+  AgentActivity,
+  AgentIcon,
+  AgentIconMode,
+  CatalogAgentSummary,
+} from "./agents-service";
 export type {
   TerminalService,
   CreateTerminalInput,
@@ -163,9 +170,10 @@ export type {
 } from "./search-service";
 // The permission surface: the capability vocabulary an extension declares, and
 // the error the host throws when an extension reaches outside the workspace
-// without the matching grant. `PathDeniedError` is a class (a runtime value).
+// without the matching grant. `PathDeniedError` and `NoWorkspaceError` are
+// classes (runtime values).
 export type { Permission } from "./permissions";
-export { PathDeniedError } from "./permissions";
+export { PathDeniedError, NoWorkspaceError } from "./permissions";
 // The theme domain: the consumer service + its state/resolve shapes, the
 // `ThemePreset` contribution type (registered via ctx.registerThemePreset), and
 // the underlying theme types (re-exported from ./domain-types via theme-service).
@@ -270,7 +278,7 @@ export type { ButtonVariant, ButtonSize } from "./Button";
 export { IconButton } from "./IconButton";
 export type { IconButtonSize, IconButtonVariant } from "./IconButton";
 export { MenuButton } from "./MenuButton";
-export type { MenuButtonSize } from "./MenuButton";
+export type { MenuButtonSize, MenuButtonVariant } from "./MenuButton";
 export { Input } from "./Input";
 export { Textarea } from "./Textarea";
 export { SearchInput } from "./SearchInput";
@@ -292,6 +300,7 @@ export type { ListRowProps, ListRowTruncate } from "./List";
 export { AddRow } from "./AddRow";
 export { Badge } from "./Badge";
 export type { BadgeSize, BadgeTone } from "./Badge";
+export { AgentIconGlyph } from "./AgentIconGlyph";
 export { EmptyState } from "./EmptyState";
 export type { EmptyStateTone } from "./EmptyState";
 export { Callout } from "./Callout";

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

@@ -7,9 +7,22 @@ describe("menuButtonClass", () => {
   it("defaults to the base class", () => {
     expect(menuButtonClass()).toBe("silo-menu-button");
     expect(menuButtonClass("normal")).toBe("silo-menu-button");
+    expect(menuButtonClass("normal", "bare")).toBe("silo-menu-button");
   });
 
   it("composes the compact modifier onto the base, like .silo-button-sm", () => {
     expect(menuButtonClass("sm")).toBe("silo-menu-button silo-menu-button-sm");
   });
+
+  it("composes the field variant onto the base", () => {
+    expect(menuButtonClass("normal", "field")).toBe(
+      "silo-menu-button silo-menu-button-field",
+    );
+  });
+
+  it("composes size and variant together", () => {
+    expect(menuButtonClass("sm", "field")).toBe(
+      "silo-menu-button silo-menu-button-sm silo-menu-button-field",
+    );
+  });
 });

package/src/menu-button-classes.ts

@@ -7,13 +7,30 @@
 export type MenuButtonSize = "normal" | "sm";
 
 /**
- * Resolve the host `.silo-menu-button*` class string for a MenuButton's `size`.
- * `sm` composes with the base class, matching how `.silo-button-sm` works.
+ * {@link MenuButton} chrome:
+ * - `"bare"` (default) — a borderless label + chevron, for toolbars and list
+ *   rows where the trigger sits among other inline controls.
+ * - `"field"` — input chrome (border, input background, full width, chevron
+ *   pushed to the trailing edge) so it lines up with `Input` / `Select` as a
+ *   form field. Reach for it when the menu is a value picker in a form.
  *
  * @internal
  */
-export function menuButtonClass(size: MenuButtonSize = "normal"): string {
-  return size === "sm"
-    ? "silo-menu-button silo-menu-button-sm"
-    : "silo-menu-button";
+export type MenuButtonVariant = "bare" | "field";
+
+/**
+ * Resolve the host `.silo-menu-button*` class string for a MenuButton's `size`
+ * and `variant`. `sm` and `field` each compose onto the base class, matching
+ * how `.silo-button-sm` / `.silo-button-primary` work.
+ *
+ * @internal
+ */
+export function menuButtonClass(
+  size: MenuButtonSize = "normal",
+  variant: MenuButtonVariant = "bare",
+): string {
+  const classes = ["silo-menu-button"];
+  if (size === "sm") classes.push("silo-menu-button-sm");
+  if (variant === "field") classes.push("silo-menu-button-field");
+  return classes.join(" ");
 }

package/src/permissions.ts

@@ -63,3 +63,34 @@ export class PathDeniedError extends Error {
     Object.setPrototypeOf(this, PathDeniedError.prototype);
   }
 }
+
+/**
+ * Thrown when an API that needs the **active workspace** is called while no
+ * workspace is open — today, {@link ExtensionStorageScopes.workspaceDir}.
+ *
+ * It is deliberately not a {@link PathDeniedError}: nothing was denied, there
+ * is simply nothing to scope to yet. Catch it to fall back to
+ * {@link ExtensionStorageScopes.globalDir | globalDir} or to defer the work
+ * until a workspace opens:
+ *
+ * ```ts
+ * try {
+ *   const dir = await ctx.storage.workspaceDir();
+ * } catch (err) {
+ *   if (err instanceof NoWorkspaceError) return; // nothing to persist yet
+ *   throw err;
+ * }
+ * ```
+ *
+ * @category Core Types
+ * @public
+ */
+export class NoWorkspaceError extends Error {
+  constructor(message?: string) {
+    super(message ?? "No workspace is open");
+    this.name = "NoWorkspaceError";
+    // Same prototype-chain restoration as PathDeniedError — `instanceof` has to
+    // survive the down-leveled build and the host↔extension boundary.
+    Object.setPrototypeOf(this, NoWorkspaceError.prototype);
+  }
+}

package/src/terminal-service.ts

@@ -63,7 +63,14 @@ export interface TerminalTabDecorationProvider {
  * @public
  */
 export interface CreateTerminalInput {
-  /** Terminal kind — `"shell"` (default), `"claude"`, or `"pi"`. */
+  /**
+   * Terminal kind. Defaults to `"shell"`.
+   *
+   * @deprecated Pass `"shell"` (or omit). The `"claude"` / `"pi"` values are
+   * kept for compatibility (RFC 0033): they create a `"shell"` terminal and, if
+   * a matching Agent Profile exists, launch it — otherwise the bare command is
+   * typed. Start agents via an Agent Profile instead.
+   */
   kind?: TerminalKind;
   /** Working directory; falls back to the workspace folder when absent. */
   cwd?: string;