@agi-fans/dsh-tui 0.16.0 → 0.18.0

package/lib/session/subagent-tracker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SubagentTracker — Session/SessionEvent stream -> published TuiSubagentRoster.
+ *
+ * Owns the live SubagentRoster, the epoch that fences the async catalog
+ * listing, and the snapshot-identity dedup that keeps unchanged rosters off
+ * the wire. The controller supplies Harness lookups (depth, agent status,
+ * session list, durable children) and owns where the snapshot lands.
+ */
+import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
+import type { SubagentCatalogEntry } from '@deepseek-ai/dsh-subagent';
+import type { TuiSubagentRoster } from '../definition.ts';
+export interface SubagentTrackerDeps {
+    /** Id of the active root agent's session, if a session is active. */
+    rootId(): string | undefined;
+    /** Depth of `session` under the active root, or undefined when unrelated. */
+    depth(session: Session): number | undefined;
+    /** Live status the agents service reports for a session, when loaded. */
+    agentStatus(id: string): 'idle' | 'running' | undefined;
+    /** Loaded sessions, consulted on a full resync. */
+    sessions(): readonly Session[];
+    /** Durable children of the root, when the subagents runtime is mounted. */
+    listChildren(rootId: string): Promise<readonly SubagentCatalogEntry[]> | undefined;
+    /** Publish the latest roster snapshot after the dedup check passes. */
+    publish(roster: TuiSubagentRoster | undefined): void;
+}
+export declare class SubagentTracker {
+    #private;
+    constructor(deps: SubagentTrackerDeps);
+    /** Whether the roster already tracks this session id. */
+    owns(id: string): boolean;
+    /** The current published snapshot, or undefined for an empty roster. */
+    snapshot(): TuiSubagentRoster | undefined;
+    /** Drop all tracked children and invalidate any in-flight catalog listing. */
+    reset(): void;
+    /** Remember a freshly created session when it descends from the root. */
+    noteSession(session: Session): void;
+    /** Fold one durable child event into its roster row. */
+    noteEvent(session: Session, event: SessionEvent): void;
+    /** Add the direct children a Session's durable catalog declares. */
+    observeCatalog(session: Session, events: readonly SessionEvent[]): void;
+    /** Apply a live agent-status change, hydrating cold children on first sight. */
+    noteStatus(session: Session, status: 'idle' | 'running'): void;
+    /** Mark a disposed session gone so its running tools settle. */
+    noteGone(session: Session): void;
+    /**
+     * Rebuild the roster around the active root: live sessions hydrate from
+     * their own events, then the durable catalog lists children that are not
+     * loaded. A stale listing is fenced by the epoch and a root re-check.
+     */
+    sync(): void;
+}

package/lib/session/subagent-tracker.js

@@ -0,0 +1,128 @@
+/**
+ * SubagentTracker — Session/SessionEvent stream -> published TuiSubagentRoster.
+ *
+ * Owns the live SubagentRoster, the epoch that fences the async catalog
+ * listing, and the snapshot-identity dedup that keeps unchanged rosters off
+ * the wire. The controller supplies Harness lookups (depth, agent status,
+ * session list, durable children) and owns where the snapshot lands.
+ */
+import { SubagentRoster } from "./subagent-roster.js";
+export class SubagentTracker {
+    #deps;
+    #roster = new SubagentRoster();
+    #published;
+    #epoch = 0;
+    constructor(deps) {
+        this.#deps = deps;
+    }
+    /** Whether the roster already tracks this session id. */
+    owns(id) {
+        return this.#roster.owns(id);
+    }
+    /** The current published snapshot, or undefined for an empty roster. */
+    snapshot() {
+        return this.#roster.snapshot();
+    }
+    /** Drop all tracked children and invalidate any in-flight catalog listing. */
+    reset() {
+        this.#epoch += 1;
+        this.#roster.reset();
+    }
+    /** Remember a freshly created session when it descends from the root. */
+    noteSession(session) {
+        const depth = this.#deps.depth(session);
+        if (depth === undefined)
+            return;
+        const parentId = session.header.parentSession;
+        this.#roster.remember({
+            id: session.id,
+            ...(parentId === undefined ? {} : { parentId }),
+            depth,
+            phase: this.#deps.agentStatus(session.id) === 'running' ? 'running' : 'starting',
+        });
+        this.#publish();
+    }
+    /** Fold one durable child event into its roster row. */
+    noteEvent(session, event) {
+        const depth = this.#deps.depth(session);
+        if (depth === undefined)
+            return;
+        this.#roster.apply(session, depth, event, this.#deps.agentStatus(session.id));
+        this.#publish();
+    }
+    /** Add the direct children a Session's durable catalog declares. */
+    observeCatalog(session, events) {
+        if (this.#roster.observeCatalog(session.id, events))
+            this.#publish();
+    }
+    /** Apply a live agent-status change, hydrating cold children on first sight. */
+    noteStatus(session, status) {
+        if (this.#roster.owns(session.id)) {
+            this.#roster.setAgentStatus(session.id, status);
+            this.#publish();
+            return;
+        }
+        const depth = this.#deps.depth(session);
+        if (depth === undefined)
+            return;
+        this.#roster.hydrate(session, depth, this.#deps.agentStatus(session.id) ?? status);
+        this.#publish();
+    }
+    /** Mark a disposed session gone so its running tools settle. */
+    noteGone(session) {
+        if (!this.#roster.owns(session.id))
+            return;
+        this.#roster.setAgentStatus(session.id, 'gone');
+        this.#publish();
+    }
+    /**
+     * Rebuild the roster around the active root: live sessions hydrate from
+     * their own events, then the durable catalog lists children that are not
+     * loaded. A stale listing is fenced by the epoch and a root re-check.
+     */
+    sync() {
+        const rootId = this.#deps.rootId();
+        const epoch = this.#epoch + 1;
+        this.#epoch = epoch;
+        if (rootId === undefined) {
+            this.#roster.reset();
+            this.#publish();
+            return;
+        }
+        this.#roster.reset(rootId);
+        for (const session of this.#deps.sessions()) {
+            const depth = this.#deps.depth(session);
+            if (depth === undefined)
+                continue;
+            this.#roster.hydrate(session, depth, this.#deps.agentStatus(session.id));
+        }
+        this.#publish();
+        const listed = this.#deps.listChildren(rootId);
+        if (listed === undefined)
+            return;
+        void listed.then((entries) => {
+            if (epoch !== this.#epoch || this.#deps.rootId() !== rootId)
+                return;
+            for (const entry of entries) {
+                this.#roster.remember({
+                    id: entry.id,
+                    depth: 1,
+                    // A listing may declare that it does not know the child's mode.
+                    ...(entry.mode === 'unknown' ? {} : { mode: entry.mode }),
+                    ...(entry.label === undefined ? {} : { label: entry.label }),
+                    phase: this.#deps.agentStatus(entry.id) === 'running' ? 'running' : 'waiting',
+                });
+            }
+            this.#publish();
+        }, () => undefined);
+    }
+    /** Push the roster when its snapshot identity changed since the last push. */
+    #publish() {
+        const roster = this.#roster.snapshot();
+        if (roster === this.#published)
+            return;
+        this.#published = roster;
+        this.#deps.publish(roster);
+    }
+}
+//# sourceMappingURL=subagent-tracker.js.map

package/lib/session/subagent-tracker.js.map

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

package/lib/session/tui-settings.d.ts

@@ -1,7 +1,8 @@
 /**
- * Durable TUI appearance and status-line preferences on the user-settings seam.
+ * Durable TUI appearance and status-line preferences as volatile plugin config.
  * @module @agi-fans/dsh-tui
  */
+import type { Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import { type StartupChangelogMode } from './release-notes.ts';
 import { type StatusBarConfig, type StatusPreset } from '../chrome/status-config.ts';
@@ -9,22 +10,44 @@ import { type ThemeName } from '../chrome/theme.ts';
 /** Available terminal animation policies. */
 export declare const MOTION_MODES: readonly ["full", "reduced", "off"];
 export type MotionMode = typeof MOTION_MODES[number];
-/** Settings namespace owned by the local TUI provider. */
-export declare const TUI_SETTINGS_NAMESPACE = "omdsh-tui";
-/** Durable TUI section stored in the user settings document. */
+/**
+ * Profile entry id owning these preferences. A form edit is addressed to the
+ * entry, so this is the id of the `@agi-fans/dsh-tui` row in the composition,
+ * never a section of a separate settings document.
+ */
+export declare const TUI_SETTINGS_ENTRY = "tui";
+/** Durable TUI preferences as live references on the owning entry's config. */
 export interface TuiSettings {
-    theme: ThemeName;
-    colors: boolean;
-    motion: MotionMode;
-    terminalProgress: boolean;
-    expandTools: boolean;
-    checkUpdates: boolean;
-    startupChangelog: StartupChangelogMode;
-    notifications: 'off' | 'long-running' | 'always';
-    notificationThreshold: '15s' | '30s' | '1m' | '2m';
-    statusBar?: StatusBarConfig;
-    /** Legacy input retained so older settings documents can be migrated. */
-    statusPreset?: StatusPreset;
+    theme: Volatile<ThemeName>;
+    colors: Volatile<boolean | undefined>;
+    motion: Volatile<MotionMode>;
+    terminalProgress: Volatile<boolean>;
+    expandTools: Volatile<boolean>;
+    checkUpdates: Volatile<boolean>;
+    startupChangelog: Volatile<StartupChangelogMode>;
+    notifications: Volatile<'off' | 'long-running' | 'always'>;
+    notificationThreshold: Volatile<'15s' | '30s' | '1m' | '2m'>;
+    statusBar: Volatile<StatusBarConfig | undefined>;
+    /** Legacy input retained so older documents can be migrated. */
+    statusPreset: Volatile<StatusPreset | undefined>;
 }
-/** Schema: palette, SGR, tool expansion, and status-line detail. */
-export declare const TuiSettingsSchema: z<TuiSettings>;
+/**
+ * Schema: palette, SGR, tool expansion, and status-line detail. Every field is
+ * volatile, so a settings edit commits into these references and the provider
+ * re-reads them instead of remounting. `colors` stays undefined until the
+ * provider resolves it against the output stream, and the two migration inputs
+ * stay undefined unless a value was written.
+ */
+export declare const TUI_SETTINGS_FIELDS: {
+    readonly theme: z<"dark" | "light" | "midnight" | "solarized" | "catppuccin" | "dracula" | "nord" | "gruvbox" | "rose-pine" | "mono", "dark" | "light" | "midnight" | "solarized" | "catppuccin" | "dracula" | "nord" | "gruvbox" | "rose-pine" | "mono", "volatile-defined">;
+    readonly colors: z<boolean, boolean, "volatile">;
+    readonly motion: z<"full" | "reduced" | "off", "full" | "reduced" | "off", "volatile-defined">;
+    readonly terminalProgress: z<boolean, boolean, "volatile-defined">;
+    readonly expandTools: z<boolean, boolean, "volatile-defined">;
+    readonly checkUpdates: z<boolean, boolean, "volatile-defined">;
+    readonly startupChangelog: z<"summary" | "expanded" | "hidden", "summary" | "expanded" | "hidden", "volatile-defined">;
+    readonly notifications: z<"off" | "long-running" | "always", "off" | "long-running" | "always", "volatile-defined">;
+    readonly notificationThreshold: z<"15s" | "30s" | "1m" | "2m", "15s" | "30s" | "1m" | "2m", "volatile-defined">;
+    readonly statusBar: z<any, any, "volatile" | "volatile-defined">;
+    readonly statusPreset: z<"minimal" | "compact" | "full", "minimal" | "compact" | "full", "volatile">;
+};

package/lib/session/tui-settings.js

@@ -1,5 +1,5 @@
 /**
- * Durable TUI appearance and status-line preferences on the user-settings seam.
+ * Durable TUI appearance and status-line preferences as volatile plugin config.
  * @module @agi-fans/dsh-tui
  */
 import z from '@deepseek-ai/schemastery';
@@ -8,42 +8,60 @@ import { STATUS_COLOR_TOKENS, STATUS_GROUP_IDS, STATUS_ITEM_IDS, STATUS_META_IDS
 import { THEME_NAMES } from "../chrome/theme.js";
 /** Available terminal animation policies. */
 export const MOTION_MODES = ['full', 'reduced', 'off'];
-/** Settings namespace owned by the local TUI provider. */
-export const TUI_SETTINGS_NAMESPACE = 'omdsh-tui';
-/** Schema: palette, SGR, tool expansion, and status-line detail. */
-export const TuiSettingsSchema = z.object({
-    theme: z.union([...THEME_NAMES]).default('dark'),
-    colors: z.boolean().default(true),
-    motion: z.union([...MOTION_MODES]).default('full'),
-    terminalProgress: z.boolean().default(false),
-    expandTools: z.boolean().default(false),
-    checkUpdates: z.boolean().default(true),
-    startupChangelog: z.union([...STARTUP_CHANGELOG_MODES]).default('summary'),
-    notifications: z.union(['off', 'long-running', 'always']).default('off'),
-    notificationThreshold: z.union(['15s', '30s', '1m', '2m']).default('30s'),
-    statusBar: z.union([z.object({
-            enabled: z.boolean().default(true),
-            labels: z.union([...STATUS_LABEL_STYLES]).default('compact'),
-            groups: z.array(z.union([...STATUS_GROUP_IDS])).default([...STATUS_GROUP_IDS]),
-            order: z.array(z.union([...STATUS_GROUP_IDS])),
-            meta: z.array(z.union([...STATUS_META_IDS])),
-            metaOrder: z.array(z.union([...STATUS_META_IDS])),
-            colors: z.object({
-                model: z.union([...STATUS_COLOR_TOKENS]),
-                effort: z.union([...STATUS_COLOR_TOKENS]),
-                path: z.union([...STATUS_COLOR_TOKENS]),
-                git: z.union([...STATUS_COLOR_TOKENS]),
-                session: z.union([...STATUS_COLOR_TOKENS]),
-                metrics: z.union([...STATUS_COLOR_TOKENS]),
-                context: z.union([...STATUS_COLOR_TOKENS]),
-                cache: z.union([...STATUS_COLOR_TOKENS]),
-                tokens: z.union([...STATUS_COLOR_TOKENS]),
-                speed: z.union([...STATUS_COLOR_TOKENS]),
-                durations: z.union([...STATUS_COLOR_TOKENS]),
-                counts: z.union([...STATUS_COLOR_TOKENS]),
-            }),
-            sides: z.object(Object.fromEntries(STATUS_ITEM_IDS.map(id => [id, z.union([...STATUS_SIDES])]))),
-        })]),
-    statusPreset: z.union([...STATUS_PRESETS]),
-});
+/**
+ * Profile entry id owning these preferences. A form edit is addressed to the
+ * entry, so this is the id of the `@agi-fans/dsh-tui` row in the composition,
+ * never a section of a separate settings document.
+ */
+export const TUI_SETTINGS_ENTRY = 'tui';
+/**
+ * Present-or-absent live object. The single-member union is what keeps an
+ * omitted `statusBar` undefined instead of materializing every default, so
+ * `resolveStatusBarConfig` still falls back to the legacy preset or the
+ * shipped default; the explicit annotation keeps the emitted declaration
+ * portable.
+ */
+const STATUS_BAR_SCHEMA = z.union([z.object({
+        enabled: z.boolean().default(true),
+        labels: z.union([...STATUS_LABEL_STYLES]).default('compact'),
+        groups: z.array(z.union([...STATUS_GROUP_IDS])).default([...STATUS_GROUP_IDS]),
+        order: z.array(z.union([...STATUS_GROUP_IDS])),
+        meta: z.array(z.union([...STATUS_META_IDS])),
+        metaOrder: z.array(z.union([...STATUS_META_IDS])),
+        colors: z.object({
+            model: z.union([...STATUS_COLOR_TOKENS]),
+            effort: z.union([...STATUS_COLOR_TOKENS]),
+            path: z.union([...STATUS_COLOR_TOKENS]),
+            git: z.union([...STATUS_COLOR_TOKENS]),
+            session: z.union([...STATUS_COLOR_TOKENS]),
+            metrics: z.union([...STATUS_COLOR_TOKENS]),
+            context: z.union([...STATUS_COLOR_TOKENS]),
+            cache: z.union([...STATUS_COLOR_TOKENS]),
+            tokens: z.union([...STATUS_COLOR_TOKENS]),
+            speed: z.union([...STATUS_COLOR_TOKENS]),
+            durations: z.union([...STATUS_COLOR_TOKENS]),
+            counts: z.union([...STATUS_COLOR_TOKENS]),
+        }),
+        sides: z.object(Object.fromEntries(STATUS_ITEM_IDS.map(id => [id, z.union([...STATUS_SIDES])]))),
+    })]);
+/**
+ * Schema: palette, SGR, tool expansion, and status-line detail. Every field is
+ * volatile, so a settings edit commits into these references and the provider
+ * re-reads them instead of remounting. `colors` stays undefined until the
+ * provider resolves it against the output stream, and the two migration inputs
+ * stay undefined unless a value was written.
+ */
+export const TUI_SETTINGS_FIELDS = {
+    theme: z.union([...THEME_NAMES]).default('dark').volatile(),
+    colors: z.boolean().volatile(),
+    motion: z.union([...MOTION_MODES]).default('full').volatile(),
+    terminalProgress: z.boolean().default(false).volatile(),
+    expandTools: z.boolean().default(false).volatile(),
+    checkUpdates: z.boolean().default(true).volatile(),
+    startupChangelog: z.union([...STARTUP_CHANGELOG_MODES]).default('summary').volatile(),
+    notifications: z.union(['off', 'long-running', 'always']).default('off').volatile(),
+    notificationThreshold: z.union(['15s', '30s', '1m', '2m']).default('30s').volatile(),
+    statusBar: STATUS_BAR_SCHEMA.volatile(),
+    statusPreset: z.union([...STATUS_PRESETS]).volatile(),
+};
 //# sourceMappingURL=tui-settings.js.map

package/lib/session/tui-settings.js.map

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

package/lib/session/update-check.js

@@ -1,21 +1,8 @@
 /** Cached, transport-neutral npm update decision. */
-function numericVersion(version) {
-    const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/u.exec(version);
-    if (match?.[1] === undefined || match[2] === undefined || match[3] === undefined)
-        return undefined;
-    return [Number(match[1]), Number(match[2]), Number(match[3])];
-}
+import { compareVersions } from "./version-compare.js";
 /** Whether a registry version is newer than the running package. */
 export function isNewerVersion(candidate, current) {
-    const left = numericVersion(candidate);
-    const right = numericVersion(current);
-    if (left === undefined || right === undefined)
-        return false;
-    for (let index = 0; index < left.length; index += 1) {
-        if ((left[index] ?? 0) !== (right[index] ?? 0))
-            return (left[index] ?? 0) > (right[index] ?? 0);
-    }
-    return false;
+    return compareVersions(candidate, current) > 0;
 }
 /** Resolve the latest version through a bounded cache and return only actionable updates. */
 export async function checkForUpdate(options) {

package/lib/session/update-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../src/session/update-check.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAOrD,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/D,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAClG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAe;IAC/D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC3D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACjG,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAOpC;IACC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;IACxC,IAAI,aAAqB,CAAA;IACzB,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/E,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;IACtC,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAA;QAC3C,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1F,CAAC"}
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../src/session/update-check.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAOtD,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAe;IAC/D,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;AAChD,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAOpC;IACC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;IACxC,IAAI,aAAqB,CAAA;IACzB,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/E,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;IACtC,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAA;QAC3C,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1F,CAAC"}

package/lib/session/version-compare.d.ts

@@ -0,0 +1,3 @@
+/** Three-part numeric version comparison shared by update checks and release notes. */
+/** Compare two `major.minor.patch` versions; unparsable inputs compare equal. */
+export declare function compareVersions(left: string, right: string): number;

package/lib/session/version-compare.js

@@ -0,0 +1,21 @@
+/** Three-part numeric version comparison shared by update checks and release notes. */
+function versionParts(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/u.exec(version);
+    if (match?.[1] === undefined || match[2] === undefined || match[3] === undefined)
+        return undefined;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+/** Compare two `major.minor.patch` versions; unparsable inputs compare equal. */
+export function compareVersions(left, right) {
+    const a = versionParts(left);
+    const b = versionParts(right);
+    if (a === undefined || b === undefined)
+        return 0;
+    for (let index = 0; index < a.length; index += 1) {
+        const difference = (a[index] ?? 0) - (b[index] ?? 0);
+        if (difference !== 0)
+            return difference;
+    }
+    return 0;
+}
+//# sourceMappingURL=version-compare.js.map

package/lib/session/version-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.js","sourceRoot":"","sources":["../../src/session/version-compare.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/D,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAClG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAC7B,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAA;IAChD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QACpD,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,UAAU,CAAA;IACzC,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC"}

package/lib/views/at-complete.d.ts

@@ -5,6 +5,8 @@ import { type DirReader, type PathSearcher } from './path-complete.ts';
 export interface SessionMentionCandidate {
     sessionId: string;
     label: string;
+    /** Presentation title preferred over {@link label}, e.g. a subagent's durable creation label. */
+    displayTitle?: string;
     cwd?: string;
 }
 /** List other sessions for the live `@` token. */

package/lib/views/at-complete.js

@@ -35,9 +35,9 @@ function sessionItems(candidates) {
     return candidates.map((candidate) => ({
         value: formatSessionReferenceMention({
             sessionId: SessionId(candidate.sessionId),
-            label: candidate.label,
+            label: candidate.displayTitle ?? candidate.label,
         }),
-        label: candidate.label,
+        label: candidate.displayTitle ?? candidate.label,
         ...(candidate.cwd === undefined ? {} : { description: candidate.cwd }),
         kind: 'session',
     }));

package/lib/views/at-complete.js.map

@@ -1 +1 @@
-{"version":3,"file":"at-complete.js","sourceRoot":"","sources":["../../src/views/at-complete.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"at-complete.js","sourceRoot":"","sources":["../../src/views/at-complete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAE1F,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA;AAElF,OAAO,EACL,YAAY,EACZ,qBAAqB,GAGtB,MAAM,oBAAoB,CAAA;AAuB3B,MAAM,YAAY,GAAqB,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAC/F,MAAM,eAAe,GAAqB,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAExG,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAM,GAAG,KAAK;IAC1D,OAAO,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAClF,CAAC;AAED,SAAS,QAAQ,CAAC,SAAiB;IACjC,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAC9D,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED,SAAS,gBAAgB,CACvB,UAA6C,EAC7C,MAAe;IAEf,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,KAAK,WAAW,CAAA;QAChD,OAAO,CAAC;gBACN,KAAK;gBACL,KAAK,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;gBACnE,IAAI,EAAE,MAAe;aACtB,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,UAA8C;IAClE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACpC,KAAK,EAAE,6BAA6B,CAAC;YACnC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC;YACzC,KAAK,EAAE,SAAS,CAAC,YAAY,IAAI,SAAS,CAAC,KAAK;SACjD,CAAC;QACF,KAAK,EAAE,SAAS,CAAC,YAAY,IAAI,SAAS,CAAC,KAAK;QAChD,GAAG,CAAC,SAAS,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC;QACtE,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC,CAAA;AACL,CAAC;AAED,SAAS,YAAY,CACnB,KAAkC,EAClC,QAAqC;IAErC,MAAM,KAAK,GAAuB,EAAE,CAAA;IACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,CAAA;IACxD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,QAAQ,CAAC,CAAA;IACjE,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAQ,KAA4B,CAAC,IAAI,KAAK,YAAY,CAAA;AAC5D,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,MAAc,EACd,IASC,EACD,WAAoC,EAAE;IAEtC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAChD,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IACnC,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IAChF,IAAI,KAAK,GAAuB,EAAE,CAAA;IAClC,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,KAAK,GAAG,gBAAgB,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,YAAY,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YACpC,KAAK,GAAG,EAAE,CAAA;QACZ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,CAAC,MAAM,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAA;IAClF,CAAC;IACD,IAAI,QAAQ,GAAuB,EAAE,CAAA;IACrC,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QAChF,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAC3E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,YAAY,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YACpC,QAAQ,GAAG,EAAE,CAAA;QACf,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAA;AACrC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,+BAA+B,CAC7C,KAAkC,EAClC,IAAY,EACZ,MAAc,CAAC;IAEf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAChC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;IACnE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;QACpE,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAA;IACpD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}