@ai-matrx/coding-sessions 0.1.166 → 0.3.0

package/dist/react/index.d.cts

@@ -2,6 +2,10 @@ import { ReactNode } from 'react';
 import { JsonValue } from '@ai-matrx/agents/portable';
 import { ChatThreadStore, ChatMessage } from '@ai-matrx/chat';
 
+/** Where a title came from, strongest first. */
+declare const TITLE_PRECEDENCE: readonly ["override", "app", "app-remembered", "custom-title", "ai-title", "agent-name", "summary", "first-prompt", "last-prompt"];
+type TitleSource = (typeof TITLE_PRECEDENCE)[number];
+
 /**
  * The public contract of `@ai-matrx/coding-sessions`, shared by the engine
  * (Node), the local host (Node) and the UI (browser). Pure types — nothing here
@@ -129,7 +133,22 @@ interface DiscoveredSession {
     provider: CodingProvider;
     providerSessionId: string;
     cwd: string | null;
+    /**
+     * The chat's own title by the one rule (`./sessions`): the coding app's title when the owner of
+     * the apps' index supplied it (title hints), else the transcript's. Never the person's rename —
+     * that is applied once, by the screen, from the preferences.
+     */
     title: string;
+    /** Where `title` came from (`TITLE_PRECEDENCE`). */
+    titleSource?: TitleSource | "unknown" | undefined;
+    /** The app's title is still on its way (hints not loaded yet); `title` is the transcript's for now. */
+    titlePending?: boolean | undefined;
+    /** Archived in the app (hidden by default, like Code › Chats). */
+    archived?: boolean | undefined;
+    /** A scheduled or automated run (hidden by default). */
+    scheduled?: boolean | undefined;
+    /** The app lists it but its conversation file is gone: why. Shown, cannot be taken over. */
+    unavailable?: string | null | undefined;
     updatedAt: string;
     /** Where it was started, when the provider records it ("cli", "vscode", "exec", …). */
     source: string | null;
@@ -244,6 +263,11 @@ type TranscriptItem = {
     id: string;
     text: string;
 };
+interface TitleStatus {
+    owner: boolean;
+    pending: boolean;
+    problem: string | null;
+}
 /** Everything the engine pushes to a listener. */
 type CodingEvent = {
     type: "session";
@@ -254,6 +278,10 @@ type CodingEvent = {
 } | {
     type: "preferences";
     preferences: Record<string, ChatPreference>;
+}
+/** The apps' titles changed (or finished loading): re-read the discovered chats. */
+ | {
+    type: "titles";
 } | {
     type: "item";
     sessionId: string;
@@ -409,6 +437,10 @@ interface CodingSessionsApi {
     discoverSessions(options?: {
         limit?: number;
     }): Promise<DiscoveredSession[]>;
+    /** Where the apps' own titles stand: an owner supplies them (`owner`), still loading, or failing (`problem`, shown with Retry). */
+    titleStatus(): Promise<TitleStatus>;
+    /** Ask the owner of the apps' titles again (the Retry). */
+    retryTitles(): Promise<void>;
     recentFolders(): Promise<RecentFolder[]>;
     listSessions(): Promise<CodingSession[]>;
     listRuns(sessionId: string): Promise<RunRecord[]>;
@@ -533,6 +565,8 @@ interface CodingSessionsState {
     preferences: Record<string, ChatPreference>;
     /** How many of "Your other chats" to list (grows with "Show more"). */
     discoveredLimit: number;
+    /** Where the apps' own titles stand (null until first asked; an engine without the method says nothing). */
+    titles: TitleStatus | null;
 }
 /** A run that just ended — for the tab badge and the desktop notification. */
 interface RunFinished {
@@ -595,6 +629,9 @@ declare class CodingSessionsClient {
     private load;
     refreshProviders: () => Promise<void>;
     refreshDiscovered: () => Promise<void>;
+    refreshTitleStatus: () => Promise<void>;
+    /** The Retry beside "app titles unavailable". */
+    retryTitles: () => Promise<void>;
     /** List more of "Your other chats". */
     showMoreDiscovered: () => Promise<void>;
     refreshPreferences: () => Promise<void>;

package/dist/react/index.d.ts

@@ -2,6 +2,10 @@ import { ReactNode } from 'react';
 import { JsonValue } from '@ai-matrx/agents/portable';
 import { ChatThreadStore, ChatMessage } from '@ai-matrx/chat';
 
+/** Where a title came from, strongest first. */
+declare const TITLE_PRECEDENCE: readonly ["override", "app", "app-remembered", "custom-title", "ai-title", "agent-name", "summary", "first-prompt", "last-prompt"];
+type TitleSource = (typeof TITLE_PRECEDENCE)[number];
+
 /**
  * The public contract of `@ai-matrx/coding-sessions`, shared by the engine
  * (Node), the local host (Node) and the UI (browser). Pure types — nothing here
@@ -129,7 +133,22 @@ interface DiscoveredSession {
     provider: CodingProvider;
     providerSessionId: string;
     cwd: string | null;
+    /**
+     * The chat's own title by the one rule (`./sessions`): the coding app's title when the owner of
+     * the apps' index supplied it (title hints), else the transcript's. Never the person's rename —
+     * that is applied once, by the screen, from the preferences.
+     */
     title: string;
+    /** Where `title` came from (`TITLE_PRECEDENCE`). */
+    titleSource?: TitleSource | "unknown" | undefined;
+    /** The app's title is still on its way (hints not loaded yet); `title` is the transcript's for now. */
+    titlePending?: boolean | undefined;
+    /** Archived in the app (hidden by default, like Code › Chats). */
+    archived?: boolean | undefined;
+    /** A scheduled or automated run (hidden by default). */
+    scheduled?: boolean | undefined;
+    /** The app lists it but its conversation file is gone: why. Shown, cannot be taken over. */
+    unavailable?: string | null | undefined;
     updatedAt: string;
     /** Where it was started, when the provider records it ("cli", "vscode", "exec", …). */
     source: string | null;
@@ -244,6 +263,11 @@ type TranscriptItem = {
     id: string;
     text: string;
 };
+interface TitleStatus {
+    owner: boolean;
+    pending: boolean;
+    problem: string | null;
+}
 /** Everything the engine pushes to a listener. */
 type CodingEvent = {
     type: "session";
@@ -254,6 +278,10 @@ type CodingEvent = {
 } | {
     type: "preferences";
     preferences: Record<string, ChatPreference>;
+}
+/** The apps' titles changed (or finished loading): re-read the discovered chats. */
+ | {
+    type: "titles";
 } | {
     type: "item";
     sessionId: string;
@@ -409,6 +437,10 @@ interface CodingSessionsApi {
     discoverSessions(options?: {
         limit?: number;
     }): Promise<DiscoveredSession[]>;
+    /** Where the apps' own titles stand: an owner supplies them (`owner`), still loading, or failing (`problem`, shown with Retry). */
+    titleStatus(): Promise<TitleStatus>;
+    /** Ask the owner of the apps' titles again (the Retry). */
+    retryTitles(): Promise<void>;
     recentFolders(): Promise<RecentFolder[]>;
     listSessions(): Promise<CodingSession[]>;
     listRuns(sessionId: string): Promise<RunRecord[]>;
@@ -533,6 +565,8 @@ interface CodingSessionsState {
     preferences: Record<string, ChatPreference>;
     /** How many of "Your other chats" to list (grows with "Show more"). */
     discoveredLimit: number;
+    /** Where the apps' own titles stand (null until first asked; an engine without the method says nothing). */
+    titles: TitleStatus | null;
 }
 /** A run that just ended — for the tab badge and the desktop notification. */
 interface RunFinished {
@@ -595,6 +629,9 @@ declare class CodingSessionsClient {
     private load;
     refreshProviders: () => Promise<void>;
     refreshDiscovered: () => Promise<void>;
+    refreshTitleStatus: () => Promise<void>;
+    /** The Retry beside "app titles unavailable". */
+    retryTitles: () => Promise<void>;
     /** List more of "Your other chats". */
     showMoreDiscovered: () => Promise<void>;
     refreshPreferences: () => Promise<void>;

package/dist/react/index.js

@@ -305,6 +305,7 @@ function sessionEntry(session, prefs) {
     updatedAt: session.updatedAt,
     pinned: pref.pinned === true,
     hidden: pref.hidden === true,
+    hiddenBy: pref.hidden === true ? "you" : null,
     session,
     discovered: null
   };
@@ -322,7 +323,9 @@ function discoveredEntry(d, prefs) {
     cwd: d.cwd,
     updatedAt: d.updatedAt,
     pinned: pref.pinned === true,
-    hidden: pref.hidden === true,
+    // Archived chats and scheduled runs are hidden by default, as in Code › Chats; a pin shows them.
+    hidden: pref.hidden === true || pref.pinned !== true && (d.archived === true || d.scheduled === true),
+    hiddenBy: pref.hidden === true ? "you" : pref.pinned === true ? null : d.archived ? "archived" : d.scheduled ? "scheduled" : null,
     session: null,
     discovered: d
   };
@@ -1268,6 +1271,14 @@ function ChooseAgentDialog(props) {
   ] }) });
 }
 
+// src/sessions/titles.ts
+var DISPLAY_MAX = 100;
+var LEADING_NOISE = /^(?:\s*(?:\d{1,3}[.)]|[-*•]|#{1,6}|>)\s+|\s*["“'‘`]+)+/;
+function displayTitle(title, max = DISPLAY_MAX) {
+  const stripped = title.replace(LEADING_NOISE, "").replace(/["”'’`]+$/, "").trim() || title.trim();
+  return stripped.length > max ? `${stripped.slice(0, max - 1).trimEnd()}\u2026` : stripped;
+}
+
 // src/react/sidebar.tsx
 import { useCallback, useEffect as useEffect3, useMemo as useMemo3, useRef as useRef2, useState as useState5 } from "react";
 import {
@@ -1381,7 +1392,7 @@ function Row(props) {
           /* @__PURE__ */ jsx6("span", { className: "pointer-events-none mt-0.5 shrink-0", children: props.live ? /* @__PURE__ */ jsx6(SpinnerIcon, { size: 16, className: "text-primary" }) : /* @__PURE__ */ jsx6(ProviderMark, { provider: entry.provider, size: 16 }) }),
           /* @__PURE__ */ jsxs6("span", { className: "cs-row__body", children: [
             renaming ? /* @__PURE__ */ jsx6("span", { className: "pointer-events-auto relative z-10 block", children: /* @__PURE__ */ jsx6(RenameInput, { initial: entry.title, onDone: rename }) }) : /* @__PURE__ */ jsxs6("span", { className: "flex items-center gap-1", children: [
-              /* @__PURE__ */ jsx6("span", { className: "min-w-0 truncate text-[13px] font-medium leading-5", children: entry.title }),
+              /* @__PURE__ */ jsx6("span", { className: "min-w-0 truncate text-[13px] font-medium leading-5", children: displayTitle(entry.title) }),
               entry.pinned ? /* @__PURE__ */ jsx6(PinIcon, { size: 11, className: "shrink-0 text-muted-foreground", "aria-label": "Pinned" }) : null
             ] }),
             /* @__PURE__ */ jsx6("span", { className: "block truncate text-[11.5px] leading-4 text-muted-foreground", children: props.meta }),
@@ -1483,6 +1494,8 @@ function Sidebar(props) {
   const [search, searchMore] = useContentSearch(query);
   const [groupMode, setGroupMode] = useState5(() => readLocal("coding-sessions.group", ["date", "folder"], "date"));
   const [showHidden, setShowHidden] = useState5(false);
+  const titlesProblem = state.titles?.problem ?? null;
+  const titlesUpdating = !titlesProblem && state.discovered.data.some((d) => d.titlePending === true);
   const [takingOver, setTakingOver] = useState5(null);
   const [takeoverError, setTakeoverError] = useState5(null);
   const prefs = state.preferences;
@@ -1536,6 +1549,7 @@ function Sidebar(props) {
         "Running in ",
         PROVIDER_LABEL[entry.provider]
       ] });
+    else if (d?.unavailable) meta = `${PROVIDER_LABEL[entry.provider]} \xB7 file missing \xB7 ${relativeTime(entry.updatedAt, now)}`;
     else {
       const status = run ? run.status === "failed" ? "Failed \xB7 " : run.status === "stopped" ? "Stopped \xB7 " : "" : "";
       const where = entry.cwd ? prettyPath2(entry.cwd) : "unknown folder";
@@ -1625,7 +1639,7 @@ function Sidebar(props) {
     ] }) : null,
     /* @__PURE__ */ jsx6(SectionLabel, { children: "Recent" }),
     state.sessions.loading && state.sessions.loadedAt === null ? /* @__PURE__ */ jsx6(SidebarSkeleton, {}) : state.sessions.error ? /* @__PURE__ */ jsx6("p", { className: "px-4 py-1 text-[12px] text-destructive", children: state.sessions.error }) : recent.length === 0 ? running.length === 0 ? /* @__PURE__ */ jsx6("p", { className: "px-4 py-1 text-[12px] leading-5 text-muted-foreground", children: "Sessions you start or take over here will appear here." }) : null : recent.map((e) => renderEntry(e)),
-    /* @__PURE__ */ jsx6(
+    /* @__PURE__ */ jsxs6(
       SectionLabel,
       {
         action: /* @__PURE__ */ jsxs6("span", { className: "flex items-center gap-0.5", children: [
@@ -1653,7 +1667,15 @@ function Sidebar(props) {
             }
           )
         ] }),
-        children: "Your other chats"
+        children: [
+          "Your other chats",
+          titlesUpdating ? /* @__PURE__ */ jsx6("span", { className: "ml-1 font-normal normal-case text-muted-foreground", "data-cs-titles": "updating", children: "\xB7 titles updating" }) : null,
+          titlesProblem ? /* @__PURE__ */ jsxs6("span", { className: "ml-1 font-normal normal-case text-destructive", "data-cs-titles": "unavailable", title: titlesProblem, children: [
+            "\xB7 app titles unavailable \u2014",
+            " ",
+            /* @__PURE__ */ jsx6("button", { type: "button", className: "cs-link", onClick: () => void client.retryTitles(), children: "Retry" })
+          ] }) : null
+        ]
       }
     ),
     state.discovered.loading && state.discovered.loadedAt === null ? /* @__PURE__ */ jsx6(SidebarSkeleton, {}) : state.discovered.error ? /* @__PURE__ */ jsx6("p", { className: "px-4 py-1 text-[12px] text-destructive", children: state.discovered.error }) : otherList.length === 0 ? /* @__PURE__ */ jsx6("p", { className: "px-4 py-1 text-[12px] leading-5 text-muted-foreground", children: others.length > 0 ? "Every chat found here is pinned or hidden." : "No other Claude Code or Codex chats were found on this computer." }) : /* @__PURE__ */ jsxs6(Fragment4, { children: [
@@ -2122,7 +2144,8 @@ var CodingSessionsClient = class {
       folders: loadable([]),
       runs: {},
       preferences: {},
-      discoveredLimit: DISCOVERED_PAGE
+      discoveredLimit: DISCOVERED_PAGE,
+      titles: null
     };
     transport.onStatus((connection) => {
       const wasOpen = this.state.connection.state === "open";
@@ -2171,6 +2194,10 @@ var CodingSessionsClient = class {
     } else if (event.type === "preferences") {
       this.set({ preferences: event.preferences });
       return;
+    } else if (event.type === "titles") {
+      void this.refreshDiscovered();
+      void this.refreshSessions();
+      return;
     }
     const sessionId = event.type === "session" ? event.session.id : event.type === "run" ? event.run.sessionId : event.sessionId;
     this.transcripts.get(sessionId)?.onEvent(event);
@@ -2187,7 +2214,21 @@ var CodingSessionsClient = class {
     }
   }
   refreshProviders = () => this.load("providers", () => this.transport.call("providers"));
-  refreshDiscovered = () => this.load("discovered", () => this.transport.call("discoverSessions", { limit: this.state.discoveredLimit }));
+  refreshDiscovered = async () => {
+    void this.refreshTitleStatus();
+    await this.load("discovered", () => this.transport.call("discoverSessions", { limit: this.state.discoveredLimit }));
+  };
+  refreshTitleStatus = async () => {
+    try {
+      this.set({ titles: await this.transport.call("titleStatus") });
+    } catch {
+    }
+  };
+  /** The Retry beside "app titles unavailable". */
+  retryTitles = async () => {
+    await this.transport.call("retryTitles").catch(() => void 0);
+    await this.refreshTitleStatus();
+  };
   /** List more of "Your other chats". */
   showMoreDiscovered = async () => {
     this.set({ discoveredLimit: this.state.discoveredLimit + DISCOVERED_PAGE });