@silo-code/sdk 0.44.0 → 0.45.0

package/dist/ActivityGlyph.d.ts

@@ -8,18 +8,31 @@ import { type Activity as ActivityKind, type ActivitySize } from "./activity.js"
  * Styled purely via host-provided `.silo-activity*` classes — no stylesheet
  * import is needed in the extension.
  *
+ * Pass `jitterKey` whenever several animated glyphs render together (a list of
+ * agent or workspace rows) so their pulses don't run in lockstep — and so each
+ * one starts mid-cycle instead of freezing on first paint.
+ *
  * @example
  * ```tsx
  * <ActivityGlyph activity="working" size="md" />
- * <ActivityGlyph activity="ready" />
+ * <ActivityGlyph activity="ready" jitterKey={row.id} />
  * <ActivityGlyph size="sm" /> // workspace neutral (omit)
  * ```
  *
  * @category Consumer Services
  * @public
  */
-export declare function ActivityGlyph({ activity, size, className, ...rest }: {
+export declare function ActivityGlyph({ activity, size, className, jitterKey, style, ...rest }: {
     activity?: ActivityKind;
     size?: ActivitySize;
+    /**
+     * Stable id (a row or terminal id — never an array index) that gives this
+     * glyph a deterministic per-instance animation offset. Desynchronizes its
+     * pulse from other glyphs rendered alongside it, and makes the animation
+     * mount already in progress rather than pausing on first paint (a WebKit
+     * quirk when the glyph appears inside a just-shown container). Inert on
+     * non-animated glyphs.
+     */
+    jitterKey?: string;
 } & Omit<HTMLAttributes<HTMLSpanElement>, "children">): import("react").JSX.Element;
 //# sourceMappingURL=ActivityGlyph.d.ts.map

package/dist/ActivityGlyph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActivityGlyph.d.ts","sourceRoot":"","sources":["../src/ActivityGlyph.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAEL,KAAK,QAAQ,IAAI,YAAY,EAC7B,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,IAAW,EACX,SAAS,EACT,GAAG,IAAI,EACR,EAAE;IACD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,+BASpD"}
+{"version":3,"file":"ActivityGlyph.d.ts","sourceRoot":"","sources":["../src/ActivityGlyph.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAGL,KAAK,QAAQ,IAAI,YAAY,EAC7B,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,IAAW,EACX,SAAS,EACT,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACR,EAAE;IACD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,+BAcpD"}

package/dist/ActivityGlyph.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { activityClass, } from "./activity.js";
+import { activityClass, activityJitterStyle, } from "./activity.js";
 /**
  * Host-painted activity glyph — same look on workspace rows, CenterDock tabs,
  * and extension UI. Pick an {@link Activity}; the host owns color and motion
@@ -8,18 +8,25 @@ import { activityClass, } from "./activity.js";
  * Styled purely via host-provided `.silo-activity*` classes — no stylesheet
  * import is needed in the extension.
  *
+ * Pass `jitterKey` whenever several animated glyphs render together (a list of
+ * agent or workspace rows) so their pulses don't run in lockstep — and so each
+ * one starts mid-cycle instead of freezing on first paint.
+ *
  * @example
  * ```tsx
  * <ActivityGlyph activity="working" size="md" />
- * <ActivityGlyph activity="ready" />
+ * <ActivityGlyph activity="ready" jitterKey={row.id} />
  * <ActivityGlyph size="sm" /> // workspace neutral (omit)
  * ```
  *
  * @category Consumer Services
  * @public
  */
-export function ActivityGlyph({ activity, size = "sm", className, ...rest }) {
+export function ActivityGlyph({ activity, size = "sm", className, jitterKey, style, ...rest }) {
     const classes = activityClass(activity, size);
-    return (_jsx("span", { className: className ? `${classes} ${className}` : classes, "aria-hidden": rest["aria-label"] == null ? true : undefined, ...rest }));
+    const mergedStyle = jitterKey != null
+        ? { ...activityJitterStyle(jitterKey), ...style }
+        : style;
+    return (_jsx("span", { className: className ? `${classes} ${className}` : classes, style: mergedStyle, "aria-hidden": rest["aria-label"] == null ? true : undefined, ...rest }));
 }
 //# sourceMappingURL=ActivityGlyph.js.map

package/dist/ActivityGlyph.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActivityGlyph.js","sourceRoot":"","sources":["../src/ActivityGlyph.tsx"],"names":[],"mappings":";AACA,OAAO,EACL,aAAa,GAGd,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,QAAQ,EACR,IAAI,GAAG,IAAI,EACX,SAAS,EACT,GAAG,IAAI,EAI4C;IACnD,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,CACL,eACE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,iBAC7C,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,KACtD,IAAI,GACR,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ActivityGlyph.js","sourceRoot":"","sources":["../src/ActivityGlyph.tsx"],"names":[],"mappings":";AACA,OAAO,EACL,aAAa,EACb,mBAAmB,GAGpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,QAAQ,EACR,IAAI,GAAG,IAAI,EACX,SAAS,EACT,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EAa4C;IACnD,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,WAAW,GACf,SAAS,IAAI,IAAI;QACf,CAAC,CAAE,EAAE,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAoB;QACpE,CAAC,CAAC,KAAK,CAAC;IACZ,OAAO,CACL,eACE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,EAC1D,KAAK,EAAE,WAAW,iBACL,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,KACtD,IAAI,GACR,CACH,CAAC;AACJ,CAAC"}

package/dist/activity.d.ts

@@ -9,8 +9,11 @@ import type { AgentActivity } from "./agents-service.js";
  */
 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.
+ * Glyph size for {@link Activity}. `"sm"` (8px at the default `uiFontSize`) is
+ * the workbench size — workspace status rows and CenterDock / SideDock tabs;
+ * `"md"` (10px) is the roomier one, for a list that leads with the dot rather
+ * than tucking it into chrome. Both scale with `uiFontSize` rather than being
+ * fixed pixels.
  *
  * @category Core Types
  * @public
@@ -33,4 +36,24 @@ export declare function activityFromAgent(a: AgentActivity): Activity | null;
  * @internal
  */
 export declare function activityClass(activity: Activity | undefined, size?: ActivitySize): string;
+/**
+ * Deterministic per-instance `animation-delay` (via the `--silo-activity-jitter`
+ * custom property) for an animated {@link Activity} glyph, keyed off a stable id
+ * — a row or terminal id, not an array index. Two purposes:
+ *
+ * - **Desync.** Several `working` / `ready` glyphs rendered side by side would
+ *   otherwise pulse in perfect lockstep; a per-id offset staggers them.
+ * - **Start mid-cycle.** The value is a *negative* delay, so the animation
+ *   mounts already in progress rather than pausing on first paint — a WebKit
+ *   quirk that bites when the glyph is created inside a container that was
+ *   `display: none` moments earlier (e.g. a Navigator view on its first
+ *   activation), where a zero delay can leave the pulse frozen until the next
+ *   show/hide toggle.
+ *
+ * Hashed rather than random so the offset is stable across re-renders. Pinned
+ * by unit tests.
+ *
+ * @internal
+ */
+export declare function activityJitterStyle(key: string): Record<"--silo-activity-jitter", string>;
 //# sourceMappingURL=activity.d.ts.map

package/dist/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,IAAI,CAYnE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,IAAI,GAAE,YAAmB,GACxB,MAAM,CAGR"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,IAAI,CAYnE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,IAAI,GAAE,YAAmB,GACxB,MAAM,CAGR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAS1C"}

package/dist/activity.js

@@ -30,4 +30,33 @@ export function activityClass(activity, size = "sm") {
     const kind = activity ?? "none";
     return `silo-activity silo-activity-${kind} silo-activity-${size}`;
 }
+/**
+ * Deterministic per-instance `animation-delay` (via the `--silo-activity-jitter`
+ * custom property) for an animated {@link Activity} glyph, keyed off a stable id
+ * — a row or terminal id, not an array index. Two purposes:
+ *
+ * - **Desync.** Several `working` / `ready` glyphs rendered side by side would
+ *   otherwise pulse in perfect lockstep; a per-id offset staggers them.
+ * - **Start mid-cycle.** The value is a *negative* delay, so the animation
+ *   mounts already in progress rather than pausing on first paint — a WebKit
+ *   quirk that bites when the glyph is created inside a container that was
+ *   `display: none` moments earlier (e.g. a Navigator view on its first
+ *   activation), where a zero delay can leave the pulse frozen until the next
+ *   show/hide toggle.
+ *
+ * Hashed rather than random so the offset is stable across re-renders. Pinned
+ * by unit tests.
+ *
+ * @internal
+ */
+export function activityJitterStyle(key) {
+    let hash = 0;
+    for (let i = 0; i < key.length; i++) {
+        hash = (hash * 31 + key.charCodeAt(i)) | 0;
+    }
+    // 1.8s is the longest activity animation period (`silo-activity-wave`), so the
+    // offset spans one full cycle.
+    const delaySeconds = -(((hash >>> 0) % 1000) / 1000) * 1.8;
+    return { "--silo-activity-jitter": `${delaySeconds.toFixed(3)}s` };
+}
 //# sourceMappingURL=activity.js.map

package/dist/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAgB;IAChD,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA8B,EAC9B,OAAqB,IAAI;IAEzB,MAAM,IAAI,GAAG,QAAQ,IAAI,MAAM,CAAC;IAChC,OAAO,+BAA+B,IAAI,kBAAkB,IAAI,EAAE,CAAC;AACrE,CAAC"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAwBA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAgB;IAChD,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA8B,EAC9B,OAAqB,IAAI;IAEzB,MAAM,IAAI,GAAG,QAAQ,IAAI,MAAM,CAAC;IAChC,OAAO,+BAA+B,IAAI,kBAAkB,IAAI,EAAE,CAAC;AACrE,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW;IAEX,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,+EAA+E;IAC/E,+BAA+B;IAC/B,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IAC3D,OAAO,EAAE,wBAAwB,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACrE,CAAC"}

package/dist/agents-service.d.ts

@@ -160,6 +160,180 @@ export interface CatalogAgentSummary {
     readonly displayName: string;
     readonly icon?: AgentIcon;
 }
+/**
+ * One **Agent Profile** as an extension may read it through
+ * {@link AgentProfilesService.list} — a named recipe for starting a coding
+ * agent in a terminal, defined by the user on Settings → Agents → Profiles.
+ * Deliberately a summary, never the host's own profile record: the command
+ * line, its config directory, and every other launch detail stay host-owned
+ * (RFC 0033).
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export interface AgentProfileSummary {
+    /** Stable id — pass it to {@link AgentProfilesService.launch}. */
+    readonly id: string;
+    /** The user's own name for this profile, e.g. `"Claude (work)"`. Show this;
+     *  never show or parse the id. */
+    readonly label: string;
+    /** True for the single profile marked default, which is what `launch()`
+     *  starts when no `profileId` is given. False for every profile when the
+     *  user has not chosen one. */
+    readonly isDefault: boolean;
+    /**
+     * Whether this profile's agent can be given an **opening prompt**. A static
+     * fact about the agent, not about any particular launch — so a picker can
+     * grey out or annotate a profile up front instead of discovering
+     * `"agent-takes-none"` after the user has already typed one.
+     */
+    readonly acceptsPrompt: boolean;
+}
+/**
+ * Why an opening prompt could not be delivered. Silo refuses rather than
+ * approximating: a prompt it cannot quote exactly is never typed, and no agent
+ * is started without the prompt the caller asked for.
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export type PromptRefusal = 
+/** The profile matches no agent Silo knows, so there is no way to tell how
+ *  its CLI takes a prompt. The user can fix this by setting the agent on the
+ *  profile. */
+"no-agent"
+/** The profile's agent has no way to accept an opening prompt while staying
+ *  interactive. Check {@link AgentProfileSummary.acceptsPrompt} first to
+ *  avoid offering a prompt for such a profile at all. */
+ | "agent-takes-none"
+/** Silo has no exact quoting rule for the shell this terminal would run and
+ *  will not guess one. bash, zsh, and fish are supported. */
+ | "unsupported-shell"
+/**
+ * The prompt exceeds Silo's 2 KiB limit — roughly a page of prose.
+ *
+ * The ceiling is low because the prompt is *typed* into the user's shell,
+ * and a shell with syntax highlighting or autosuggestions cannot reliably
+ * consume more than a few KiB in one go. Silo refuses well short of where
+ * delivery starts failing, because a truncated prompt would reach the agent
+ * looking complete. Trim it and retry.
+ */
+ | "too-large";
+/**
+ * Options for {@link AgentProfilesService.launch}. Every field is optional —
+ * a bare `launch()` starts the default profile in the active workspace.
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export interface LaunchAgentProfileOptions {
+    /** Which profile to start. Defaults to the one marked default, else the
+     *  first — the same profile the built-in "New Agent" command uses. */
+    profileId?: string;
+    /** Which workspace to start it in. Defaults to the active one. A
+     *  background workspace works: the session is spawned eagerly, since no
+     *  panel will mount to do it. */
+    workspaceId?: string;
+    /** Working directory for the new terminal. Defaults to the workspace folder. */
+    cwd?: string;
+    /**
+     * An opening prompt to hand the agent on its launch line.
+     *
+     * The text is delivered as a literal — it is never interpreted by the
+     * shell, so `$HOME`, backticks, quotes, and newlines are all safe. If Silo
+     * cannot deliver it exactly, the launch is **refused** rather than mangled
+     * or silently dropped: nothing is typed, no terminal is created, and
+     * `launch()` returns the reason.
+     *
+     * Keep it to an opening instruction. The limit is **2 KiB** — about a page —
+     * and anything longer is refused with `"too-large"`; see that member for
+     * why the ceiling is where it is.
+     *
+     * The composed line is typed into the user's own interactive shell, so it
+     * appears in scrollback and in shell history exactly as if they had typed
+     * it. Don't put a secret in one.
+     */
+    prompt?: string;
+    /**
+     * Activate the target workspace and focus the new terminal. Defaults to
+     * `true`. Pass `false` to start an agent without stealing the user's place.
+     */
+    activate?: boolean;
+}
+/**
+ * What {@link AgentProfilesService.launch} did. A **result**, never a throw:
+ * every foreseeable reason a launch cannot happen is a value you can branch
+ * on and report to your own user.
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export type LaunchAgentProfileResult = {
+    readonly ok: true;
+    /** The created terminal's record id — the same id
+     *  {@link AgentsService.getByTerminalId} and `ctx.terminals` take. */
+    readonly terminalId: string;
+} | {
+    readonly ok: false;
+    /** Why nothing was launched. `"no-profile"` — the named profile does
+     *  not exist, or there are no profiles at all. `"no-workspace"` — the
+     *  named workspace does not exist, or none is open. Otherwise one of the
+     *  {@link PromptRefusal} reasons. */
+    readonly refusal: PromptRefusal | "no-profile" | "no-workspace";
+};
+/**
+ * Read the user's **Agent Profiles** and start one, optionally with an opening
+ * prompt — exposed as `ctx.agents.profiles` (RFC 0033).
+ *
+ * A profile is a way to *start* a terminal, not a way to talk to an agent:
+ * what comes up is a PTY running a real agent CLI, exactly as if the user had
+ * typed the command themselves. There is no agent-agnostic messaging layer
+ * here and there is not meant to be one.
+ *
+ * There is deliberately no `pick()` — build one from `list()` and
+ * `ctx.ui.showMenu`, which is the shared chrome — and no `get()`, which is
+ * `list().find()`.
+ *
+ * @example
+ * ```ts
+ * // Let the user choose a profile, then start it on a task.
+ * const profiles = ctx.agents.profiles.list();
+ * const chosen = await ctx.ui.showMenu(
+ *   profiles.map((p) => ({ id: p.id, label: p.label })),
+ * );
+ * if (chosen) {
+ *   const result = ctx.agents.profiles.launch({
+ *     profileId: chosen,
+ *     prompt: "Fix the failing test in src/foo.test.ts",
+ *   });
+ *   if (!result.ok) ctx.ui.notify("warn", `Couldn't start it: ${result.refusal}`);
+ * }
+ * ```
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export interface AgentProfilesService {
+    /**
+     * Every Agent Profile the user has defined, in the order they appear in
+     * Settings. The returned array is **read-only and deeply frozen**; it is
+     * recomputed when the profile list changes, not on every call.
+     */
+    list(): readonly AgentProfileSummary[];
+    /**
+     * Start a profile in a terminal. Returns the created terminal's id, or a
+     * typed refusal — see {@link LaunchAgentProfileResult}.
+     *
+     * A refused prompt creates nothing at all: no terminal record, no workspace
+     * activation, no focus change.
+     */
+    launch(options?: LaunchAgentProfileOptions): LaunchAgentProfileResult;
+}
 /**
  * Host-computed coding-agent observability — exposed as
  * {@link ExtensionContext.agents}. Detection (what OSC/output signals mean
@@ -239,5 +413,14 @@ export interface AgentsService {
      * @public
      */
     catalog(): readonly CatalogAgentSummary[];
+    /**
+     * The user's **Agent Profiles** — read them, and start one, optionally with
+     * an opening prompt. See {@link AgentProfilesService}.
+     *
+     * @category Consumer Services
+     * @public
+     * @beta
+     */
+    readonly profiles: AgentProfilesService;
 }
 //# 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;;;;;;;;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"}
+{"version":3,"file":"agents-service.d.ts","sourceRoot":"","sources":["../src/agents-service.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -22,8 +22,8 @@ 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, AgentIcon, AgentIconMode, CatalogAgentSummary, } from "./agents-service.js";
-export type { TerminalService, CreateTerminalInput, TerminalKind, TerminalRecord, TerminalTabDecoration, TerminalTabDecorationProvider, OscEvent, } from "./terminal-service.js";
+export type { AgentsService, AgentInfo, AgentActivity, AgentIcon, AgentIconMode, CatalogAgentSummary, AgentProfilesService, AgentProfileSummary, LaunchAgentProfileOptions, LaunchAgentProfileResult, PromptRefusal, } from "./agents-service.js";
+export type { TerminalService, CreateTerminalInput, TerminalKind, TerminalRecord, TerminalTabDecoration, TerminalTabDecorationProvider, OscEvent, OutputOrigin, SubscribeOutputOptions, } 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";
 export { activityFromAgent } from "./activity.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.map

@@ -1 +1 @@
-{"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;AA8BlE,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAoIH,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;AA8BlE,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/process-service.d.ts

@@ -1,4 +1,5 @@
 import type { Disposable } from "./types.js";
+import type { OutputOrigin, SubscribeOutputOptions } from "./terminal-service.js";
 /**
  * Options for spawning a process session. Today sessions are shell PTYs, so
  * `cwd` is required (the webview has no ambient working directory).
@@ -54,8 +55,17 @@ export interface ProcessSession {
     getBuffer(): Promise<string>;
     /** Persist an output buffer for later restore. */
     saveBuffer(data: string): Promise<void>;
-    /** Subscribe to output data. Dispose to stop listening. */
-    onData(listener: (data: string) => void): Disposable;
+    /**
+     * Subscribe to output data. Dispose to stop listening.
+     *
+     * By default only **live** output is delivered. A session survives app
+     * restarts, so re-attaching to one replays its recent scrollback; delivering
+     * that by default would make every reattach look like a burst of output
+     * arriving right now. Pass `{ includeReplay: true }` to receive the replayed
+     * history too — for instance to paint scrollback into a fresh view — and read
+     * `origin.replay` to tell the two apart.
+     */
+    onData(listener: (data: string, origin: OutputOrigin) => void, options?: SubscribeOutputOptions): Disposable;
     /** Subscribe to session exit. Dispose to stop listening. */
     onExit(listener: (exitCode: number) => void): Disposable;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"process-service.d.ts","sourceRoot":"","sources":["../src/process-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oDAAoD;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,6EAA6E;IAC7E,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,kDAAkD;IAClD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;IACrD,4DAA4D;IAC5D,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,KAAK,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D;;;OAGG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B"}
+{"version":3,"file":"process-service.d.ts","sourceRoot":"","sources":["../src/process-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAK/E;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oDAAoD;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,6EAA6E;IAC7E,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,kDAAkD;IAClD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC;;;;;;;;;OASG;IACH,MAAM,CACJ,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EACtD,OAAO,CAAC,EAAE,sBAAsB,GAC/B,UAAU,CAAC;IACd,4DAA4D;IAC5D,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,UAAU,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,KAAK,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D;;;OAGG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACtC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B"}

package/dist/terminal-service.d.ts

@@ -21,6 +21,51 @@ export interface OscEvent {
     /** The raw payload string after the code and its separating semicolon. */
     payload: string;
 }
+/**
+ * Where a chunk of terminal output came from in time.
+ *
+ * A terminal session outlives the app, so re-attaching to one replays the
+ * session host's recent scrollback — bytes that are byte-for-byte identical to
+ * live output but describe things that already happened, sometimes long ago.
+ * Treating them as live is what makes a reattached agent terminal announce a
+ * turn that finished before the app started.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface OutputOrigin {
+    /**
+     * `true` when the chunk is scrollback the session host is replaying on
+     * attach, `false` when the session produced it just now.
+     *
+     * Only ever `true` for a subscription that opted in with
+     * {@link SubscribeOutputOptions.includeReplay}.
+     */
+    replay: boolean;
+}
+/**
+ * Options for {@link TerminalService.subscribeOutput} and
+ * {@link TerminalService.subscribeOsc}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface SubscribeOutputOptions {
+    /**
+     * Deliver the scrollback the session host replays when re-attaching to a
+     * terminal, in addition to live output. Defaults to `false`.
+     *
+     * Leave it off for anything that reads output as *activity* — "the agent is
+     * working", "something just happened", a notification — because replayed
+     * bytes would fire all of it for events that are already over.
+     *
+     * Turn it on for anything that needs the terminal's *history*: rendering the
+     * scrollback, or identifying which program is running in a terminal you have
+     * only just attached to. Each chunk then arrives with an
+     * {@link OutputOrigin} saying which kind it is.
+     */
+    includeReplay?: boolean;
+}
 export type { TerminalKind, TerminalRecord } from "./domain-types.js";
 /**
  * @deprecated Prefer {@link TerminalService.setIndicator} /
@@ -214,8 +259,16 @@ export interface TerminalService extends TabAdornmentMethods {
      * });
      * ctx.subscriptions.push(sub);
      * ```
+     *
+     * @remarks
+     * OSC sequences ride the raw output stream, so the same replay rule applies
+     * as for {@link TerminalService.subscribeOutput}: by default only sequences
+     * from **live** output are delivered, and `{ includeReplay: true }` adds
+     * those found in the scrollback replayed on attach. Status titles are the
+     * usual reason to leave it off — a replayed "busy" title describes a turn
+     * that is already over.
      */
-    subscribeOsc(terminalId: string, handler: (event: OscEvent) => void): Disposable;
+    subscribeOsc(terminalId: string, handler: (event: OscEvent, origin: OutputOrigin) => void, options?: SubscribeOutputOptions): Disposable;
     /**
      * Subscribe to the raw PTY output stream of the terminal identified by
      * `terminalId`. The `handler` is called with every chunk of bytes the PTY
@@ -232,19 +285,42 @@ export interface TerminalService extends TabAdornmentMethods {
      * not the underlying PTY session id, so it survives terminal recreation within
      * the same record.
      *
+     * By default only **live** output is delivered. A terminal session outlives
+     * the app, so attaching to one replays its recent scrollback; without this
+     * default every reattach would look like a burst of activity happening right
+     * now. Pass `{ includeReplay: true }` to receive that history too — each
+     * chunk then arrives with an {@link OutputOrigin} saying which kind it is.
+     *
      * Returns a {@link Disposable} that cancels the subscription.
      *
      * @example
      * ```ts
      * // Track the last time any output arrived to confirm agent activity.
+     * // Replayed scrollback is excluded by default, so re-attaching to a
+     * // long-idle terminal doesn't read as fresh activity.
      * let lastOutputAt = 0;
      * const sub = ctx.terminals.subscribeOutput(terminalId, () => {
      *   lastOutputAt = Date.now();
      * });
      * ctx.subscriptions.push(sub);
      * ```
+     *
+     * @example
+     * ```ts
+     * // Opt in to the replayed scrollback — needed to work out what is running
+     * // in a terminal you just attached to — and keep the two apart.
+     * const sub = ctx.terminals.subscribeOutput(
+     *   terminalId,
+     *   (chunk, { replay }) => {
+     *     identifyProgram(chunk);           // history is evidence
+     *     if (!replay) noteActivity();      // …but only live output is activity
+     *   },
+     *   { includeReplay: true },
+     * );
+     * ctx.subscriptions.push(sub);
+     * ```
      */
-    subscribeOutput(terminalId: string, handler: (data: string) => void): Disposable;
+    subscribeOutput(terminalId: string, handler: (data: string, origin: OutputOrigin) => void, options?: SubscribeOutputOptions): Disposable;
     /**
      * The record id of the terminal tab that is currently active in the active
      * workspace's center dock, or `null` when an editor tab (or nothing) is

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.44.0",
+  "version": "0.45.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

@@ -1,6 +1,7 @@
-import type { HTMLAttributes } from "react";
+import type { CSSProperties, HTMLAttributes } from "react";
 import {
   activityClass,
+  activityJitterStyle,
   type Activity as ActivityKind,
   type ActivitySize,
 } from "./activity";
@@ -13,10 +14,14 @@ import {
  * Styled purely via host-provided `.silo-activity*` classes — no stylesheet
  * import is needed in the extension.
  *
+ * Pass `jitterKey` whenever several animated glyphs render together (a list of
+ * agent or workspace rows) so their pulses don't run in lockstep — and so each
+ * one starts mid-cycle instead of freezing on first paint.
+ *
  * @example
  * ```tsx
  * <ActivityGlyph activity="working" size="md" />
- * <ActivityGlyph activity="ready" />
+ * <ActivityGlyph activity="ready" jitterKey={row.id} />
  * <ActivityGlyph size="sm" /> // workspace neutral (omit)
  * ```
  *
@@ -27,15 +32,31 @@ export function ActivityGlyph({
   activity,
   size = "sm",
   className,
+  jitterKey,
+  style,
   ...rest
 }: {
   activity?: ActivityKind;
   size?: ActivitySize;
+  /**
+   * Stable id (a row or terminal id — never an array index) that gives this
+   * glyph a deterministic per-instance animation offset. Desynchronizes its
+   * pulse from other glyphs rendered alongside it, and makes the animation
+   * mount already in progress rather than pausing on first paint (a WebKit
+   * quirk when the glyph appears inside a just-shown container). Inert on
+   * non-animated glyphs.
+   */
+  jitterKey?: string;
 } & Omit<HTMLAttributes<HTMLSpanElement>, "children">) {
   const classes = activityClass(activity, size);
+  const mergedStyle =
+    jitterKey != null
+      ? ({ ...activityJitterStyle(jitterKey), ...style } as CSSProperties)
+      : style;
   return (
     <span
       className={className ? `${classes} ${className}` : classes}
+      style={mergedStyle}
       aria-hidden={rest["aria-label"] == null ? true : undefined}
       {...rest}
     />

package/src/activity.test.ts

@@ -1,5 +1,9 @@
 import { describe, expect, it } from "vitest";
-import { activityClass, activityFromAgent } from "./activity";
+import {
+  activityClass,
+  activityFromAgent,
+  activityJitterStyle,
+} from "./activity";
 
 describe("activityClass", () => {
   it("maps kinds and sizes", () => {
@@ -33,3 +37,32 @@ describe("activityFromAgent", () => {
     expect(activityFromAgent("dead")).toBeNull();
   });
 });
+
+describe("activityJitterStyle", () => {
+  const delay = (key: string) =>
+    Number.parseFloat(activityJitterStyle(key)["--silo-activity-jitter"]);
+
+  it("is deterministic for a given key", () => {
+    expect(activityJitterStyle("term-42")).toEqual(
+      activityJitterStyle("term-42"),
+    );
+  });
+
+  it("spreads different keys across the cycle", () => {
+    const keys = ["a", "b", "c", "d", "e", "term-1", "ws:build", "term-2"];
+    const delays = keys.map(delay);
+    // Not all landing on the same offset (the lockstep bug).
+    expect(new Set(delays).size).toBeGreaterThan(1);
+  });
+
+  it("emits a negative delay within one animation period", () => {
+    for (const key of ["", "x", "a-very-long-stable-row-identifier", "ws:1"]) {
+      const d = delay(key);
+      expect(d).toBeLessThanOrEqual(0);
+      expect(d).toBeGreaterThan(-1.8);
+      expect(activityJitterStyle(key)["--silo-activity-jitter"]).toMatch(
+        /^-?\d+\.\d{3}s$/,
+      );
+    }
+  });
+});

package/src/activity.ts

@@ -11,8 +11,11 @@ import type { AgentActivity } from "./agents-service";
 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.
+ * Glyph size for {@link Activity}. `"sm"` (8px at the default `uiFontSize`) is
+ * the workbench size — workspace status rows and CenterDock / SideDock tabs;
+ * `"md"` (10px) is the roomier one, for a list that leads with the dot rather
+ * than tucking it into chrome. Both scale with `uiFontSize` rather than being
+ * fixed pixels.
  *
  * @category Core Types
  * @public
@@ -55,3 +58,35 @@ export function activityClass(
   const kind = activity ?? "none";
   return `silo-activity silo-activity-${kind} silo-activity-${size}`;
 }
+
+/**
+ * Deterministic per-instance `animation-delay` (via the `--silo-activity-jitter`
+ * custom property) for an animated {@link Activity} glyph, keyed off a stable id
+ * — a row or terminal id, not an array index. Two purposes:
+ *
+ * - **Desync.** Several `working` / `ready` glyphs rendered side by side would
+ *   otherwise pulse in perfect lockstep; a per-id offset staggers them.
+ * - **Start mid-cycle.** The value is a *negative* delay, so the animation
+ *   mounts already in progress rather than pausing on first paint — a WebKit
+ *   quirk that bites when the glyph is created inside a container that was
+ *   `display: none` moments earlier (e.g. a Navigator view on its first
+ *   activation), where a zero delay can leave the pulse frozen until the next
+ *   show/hide toggle.
+ *
+ * Hashed rather than random so the offset is stable across re-renders. Pinned
+ * by unit tests.
+ *
+ * @internal
+ */
+export function activityJitterStyle(
+  key: string,
+): Record<"--silo-activity-jitter", string> {
+  let hash = 0;
+  for (let i = 0; i < key.length; i++) {
+    hash = (hash * 31 + key.charCodeAt(i)) | 0;
+  }
+  // 1.8s is the longest activity animation period (`silo-activity-wave`), so the
+  // offset spans one full cycle.
+  const delaySeconds = -(((hash >>> 0) % 1000) / 1000) * 1.8;
+  return { "--silo-activity-jitter": `${delaySeconds.toFixed(3)}s` };
+}

package/src/agents-service.ts

@@ -172,6 +172,187 @@ export interface CatalogAgentSummary {
   readonly icon?: AgentIcon;
 }
 
+/**
+ * One **Agent Profile** as an extension may read it through
+ * {@link AgentProfilesService.list} — a named recipe for starting a coding
+ * agent in a terminal, defined by the user on Settings → Agents → Profiles.
+ * Deliberately a summary, never the host's own profile record: the command
+ * line, its config directory, and every other launch detail stay host-owned
+ * (RFC 0033).
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export interface AgentProfileSummary {
+  /** Stable id — pass it to {@link AgentProfilesService.launch}. */
+  readonly id: string;
+  /** The user's own name for this profile, e.g. `"Claude (work)"`. Show this;
+   *  never show or parse the id. */
+  readonly label: string;
+  /** True for the single profile marked default, which is what `launch()`
+   *  starts when no `profileId` is given. False for every profile when the
+   *  user has not chosen one. */
+  readonly isDefault: boolean;
+  /**
+   * Whether this profile's agent can be given an **opening prompt**. A static
+   * fact about the agent, not about any particular launch — so a picker can
+   * grey out or annotate a profile up front instead of discovering
+   * `"agent-takes-none"` after the user has already typed one.
+   */
+  readonly acceptsPrompt: boolean;
+}
+
+/**
+ * Why an opening prompt could not be delivered. Silo refuses rather than
+ * approximating: a prompt it cannot quote exactly is never typed, and no agent
+ * is started without the prompt the caller asked for.
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export type PromptRefusal =
+  /** The profile matches no agent Silo knows, so there is no way to tell how
+   *  its CLI takes a prompt. The user can fix this by setting the agent on the
+   *  profile. */
+  | "no-agent"
+  /** The profile's agent has no way to accept an opening prompt while staying
+   *  interactive. Check {@link AgentProfileSummary.acceptsPrompt} first to
+   *  avoid offering a prompt for such a profile at all. */
+  | "agent-takes-none"
+  /** Silo has no exact quoting rule for the shell this terminal would run and
+   *  will not guess one. bash, zsh, and fish are supported. */
+  | "unsupported-shell"
+  /**
+   * The prompt exceeds Silo's 2 KiB limit — roughly a page of prose.
+   *
+   * The ceiling is low because the prompt is *typed* into the user's shell,
+   * and a shell with syntax highlighting or autosuggestions cannot reliably
+   * consume more than a few KiB in one go. Silo refuses well short of where
+   * delivery starts failing, because a truncated prompt would reach the agent
+   * looking complete. Trim it and retry.
+   */
+  | "too-large";
+
+/**
+ * Options for {@link AgentProfilesService.launch}. Every field is optional —
+ * a bare `launch()` starts the default profile in the active workspace.
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export interface LaunchAgentProfileOptions {
+  /** Which profile to start. Defaults to the one marked default, else the
+   *  first — the same profile the built-in "New Agent" command uses. */
+  profileId?: string;
+  /** Which workspace to start it in. Defaults to the active one. A
+   *  background workspace works: the session is spawned eagerly, since no
+   *  panel will mount to do it. */
+  workspaceId?: string;
+  /** Working directory for the new terminal. Defaults to the workspace folder. */
+  cwd?: string;
+  /**
+   * An opening prompt to hand the agent on its launch line.
+   *
+   * The text is delivered as a literal — it is never interpreted by the
+   * shell, so `$HOME`, backticks, quotes, and newlines are all safe. If Silo
+   * cannot deliver it exactly, the launch is **refused** rather than mangled
+   * or silently dropped: nothing is typed, no terminal is created, and
+   * `launch()` returns the reason.
+   *
+   * Keep it to an opening instruction. The limit is **2 KiB** — about a page —
+   * and anything longer is refused with `"too-large"`; see that member for
+   * why the ceiling is where it is.
+   *
+   * The composed line is typed into the user's own interactive shell, so it
+   * appears in scrollback and in shell history exactly as if they had typed
+   * it. Don't put a secret in one.
+   */
+  prompt?: string;
+  /**
+   * Activate the target workspace and focus the new terminal. Defaults to
+   * `true`. Pass `false` to start an agent without stealing the user's place.
+   */
+  activate?: boolean;
+}
+
+/**
+ * What {@link AgentProfilesService.launch} did. A **result**, never a throw:
+ * every foreseeable reason a launch cannot happen is a value you can branch
+ * on and report to your own user.
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export type LaunchAgentProfileResult =
+  | {
+      readonly ok: true;
+      /** The created terminal's record id — the same id
+       *  {@link AgentsService.getByTerminalId} and `ctx.terminals` take. */
+      readonly terminalId: string;
+    }
+  | {
+      readonly ok: false;
+      /** Why nothing was launched. `"no-profile"` — the named profile does
+       *  not exist, or there are no profiles at all. `"no-workspace"` — the
+       *  named workspace does not exist, or none is open. Otherwise one of the
+       *  {@link PromptRefusal} reasons. */
+      readonly refusal: PromptRefusal | "no-profile" | "no-workspace";
+    };
+
+/**
+ * Read the user's **Agent Profiles** and start one, optionally with an opening
+ * prompt — exposed as `ctx.agents.profiles` (RFC 0033).
+ *
+ * A profile is a way to *start* a terminal, not a way to talk to an agent:
+ * what comes up is a PTY running a real agent CLI, exactly as if the user had
+ * typed the command themselves. There is no agent-agnostic messaging layer
+ * here and there is not meant to be one.
+ *
+ * There is deliberately no `pick()` — build one from `list()` and
+ * `ctx.ui.showMenu`, which is the shared chrome — and no `get()`, which is
+ * `list().find()`.
+ *
+ * @example
+ * ```ts
+ * // Let the user choose a profile, then start it on a task.
+ * const profiles = ctx.agents.profiles.list();
+ * const chosen = await ctx.ui.showMenu(
+ *   profiles.map((p) => ({ id: p.id, label: p.label })),
+ * );
+ * if (chosen) {
+ *   const result = ctx.agents.profiles.launch({
+ *     profileId: chosen,
+ *     prompt: "Fix the failing test in src/foo.test.ts",
+ *   });
+ *   if (!result.ok) ctx.ui.notify("warn", `Couldn't start it: ${result.refusal}`);
+ * }
+ * ```
+ *
+ * @category Consumer Services
+ * @public
+ * @beta
+ */
+export interface AgentProfilesService {
+  /**
+   * Every Agent Profile the user has defined, in the order they appear in
+   * Settings. The returned array is **read-only and deeply frozen**; it is
+   * recomputed when the profile list changes, not on every call.
+   */
+  list(): readonly AgentProfileSummary[];
+  /**
+   * Start a profile in a terminal. Returns the created terminal's id, or a
+   * typed refusal — see {@link LaunchAgentProfileResult}.
+   *
+   * A refused prompt creates nothing at all: no terminal record, no workspace
+   * activation, no focus change.
+   */
+  launch(options?: LaunchAgentProfileOptions): LaunchAgentProfileResult;
+}
+
 /**
  * Host-computed coding-agent observability — exposed as
  * {@link ExtensionContext.agents}. Detection (what OSC/output signals mean
@@ -250,4 +431,13 @@ export interface AgentsService {
    * @public
    */
   catalog(): readonly CatalogAgentSummary[];
+  /**
+   * The user's **Agent Profiles** — read them, and start one, optionally with
+   * an opening prompt. See {@link AgentProfilesService}.
+   *
+   * @category Consumer Services
+   * @public
+   * @beta
+   */
+  readonly profiles: AgentProfilesService;
 }

package/src/index.ts

@@ -110,6 +110,11 @@ export type {
   AgentIcon,
   AgentIconMode,
   CatalogAgentSummary,
+  AgentProfilesService,
+  AgentProfileSummary,
+  LaunchAgentProfileOptions,
+  LaunchAgentProfileResult,
+  PromptRefusal,
 } from "./agents-service";
 export type {
   TerminalService,
@@ -119,6 +124,8 @@ export type {
   TerminalTabDecoration,
   TerminalTabDecorationProvider,
   OscEvent,
+  OutputOrigin,
+  SubscribeOutputOptions,
 } from "./terminal-service";
 export type {
   TabAdornmentColor,

package/src/process-service.ts

@@ -1,4 +1,5 @@
 import type { Disposable } from "./types";
+import type { OutputOrigin, SubscribeOutputOptions } from "./terminal-service";
 
 // `ctx.process` — persistent process / PTY sessions that survive app restarts.
 // The core primitive under the terminal (and future task runners / REPLs).
@@ -59,8 +60,20 @@ export interface ProcessSession {
   getBuffer(): Promise<string>;
   /** Persist an output buffer for later restore. */
   saveBuffer(data: string): Promise<void>;
-  /** Subscribe to output data. Dispose to stop listening. */
-  onData(listener: (data: string) => void): Disposable;
+  /**
+   * Subscribe to output data. Dispose to stop listening.
+   *
+   * By default only **live** output is delivered. A session survives app
+   * restarts, so re-attaching to one replays its recent scrollback; delivering
+   * that by default would make every reattach look like a burst of output
+   * arriving right now. Pass `{ includeReplay: true }` to receive the replayed
+   * history too — for instance to paint scrollback into a fresh view — and read
+   * `origin.replay` to tell the two apart.
+   */
+  onData(
+    listener: (data: string, origin: OutputOrigin) => void,
+    options?: SubscribeOutputOptions,
+  ): Disposable;
   /** Subscribe to session exit. Dispose to stop listening. */
   onExit(listener: (exitCode: number) => void): Disposable;
 }

package/src/terminal-service.ts

@@ -26,6 +26,53 @@ export interface OscEvent {
   payload: string;
 }
 
+/**
+ * Where a chunk of terminal output came from in time.
+ *
+ * A terminal session outlives the app, so re-attaching to one replays the
+ * session host's recent scrollback — bytes that are byte-for-byte identical to
+ * live output but describe things that already happened, sometimes long ago.
+ * Treating them as live is what makes a reattached agent terminal announce a
+ * turn that finished before the app started.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface OutputOrigin {
+  /**
+   * `true` when the chunk is scrollback the session host is replaying on
+   * attach, `false` when the session produced it just now.
+   *
+   * Only ever `true` for a subscription that opted in with
+   * {@link SubscribeOutputOptions.includeReplay}.
+   */
+  replay: boolean;
+}
+
+/**
+ * Options for {@link TerminalService.subscribeOutput} and
+ * {@link TerminalService.subscribeOsc}.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface SubscribeOutputOptions {
+  /**
+   * Deliver the scrollback the session host replays when re-attaching to a
+   * terminal, in addition to live output. Defaults to `false`.
+   *
+   * Leave it off for anything that reads output as *activity* — "the agent is
+   * working", "something just happened", a notification — because replayed
+   * bytes would fire all of it for events that are already over.
+   *
+   * Turn it on for anything that needs the terminal's *history*: rendering the
+   * scrollback, or identifying which program is running in a terminal you have
+   * only just attached to. Each chunk then arrives with an
+   * {@link OutputOrigin} saying which kind it is.
+   */
+  includeReplay?: boolean;
+}
+
 // Re-export the terminal domain types so consumers can name them from the SDK.
 export type { TerminalKind, TerminalRecord } from "./domain-types";
 
@@ -234,10 +281,19 @@ export interface TerminalService extends TabAdornmentMethods {
    * });
    * ctx.subscriptions.push(sub);
    * ```
+   *
+   * @remarks
+   * OSC sequences ride the raw output stream, so the same replay rule applies
+   * as for {@link TerminalService.subscribeOutput}: by default only sequences
+   * from **live** output are delivered, and `{ includeReplay: true }` adds
+   * those found in the scrollback replayed on attach. Status titles are the
+   * usual reason to leave it off — a replayed "busy" title describes a turn
+   * that is already over.
    */
   subscribeOsc(
     terminalId: string,
-    handler: (event: OscEvent) => void,
+    handler: (event: OscEvent, origin: OutputOrigin) => void,
+    options?: SubscribeOutputOptions,
   ): Disposable;
 
   /**
@@ -256,21 +312,45 @@ export interface TerminalService extends TabAdornmentMethods {
    * not the underlying PTY session id, so it survives terminal recreation within
    * the same record.
    *
+   * By default only **live** output is delivered. A terminal session outlives
+   * the app, so attaching to one replays its recent scrollback; without this
+   * default every reattach would look like a burst of activity happening right
+   * now. Pass `{ includeReplay: true }` to receive that history too — each
+   * chunk then arrives with an {@link OutputOrigin} saying which kind it is.
+   *
    * Returns a {@link Disposable} that cancels the subscription.
    *
    * @example
    * ```ts
    * // Track the last time any output arrived to confirm agent activity.
+   * // Replayed scrollback is excluded by default, so re-attaching to a
+   * // long-idle terminal doesn't read as fresh activity.
    * let lastOutputAt = 0;
    * const sub = ctx.terminals.subscribeOutput(terminalId, () => {
    *   lastOutputAt = Date.now();
    * });
    * ctx.subscriptions.push(sub);
    * ```
+   *
+   * @example
+   * ```ts
+   * // Opt in to the replayed scrollback — needed to work out what is running
+   * // in a terminal you just attached to — and keep the two apart.
+   * const sub = ctx.terminals.subscribeOutput(
+   *   terminalId,
+   *   (chunk, { replay }) => {
+   *     identifyProgram(chunk);           // history is evidence
+   *     if (!replay) noteActivity();      // …but only live output is activity
+   *   },
+   *   { includeReplay: true },
+   * );
+   * ctx.subscriptions.push(sub);
+   * ```
    */
   subscribeOutput(
     terminalId: string,
-    handler: (data: string) => void,
+    handler: (data: string, origin: OutputOrigin) => void,
+    options?: SubscribeOutputOptions,
   ): Disposable;
 
   /**