@ai-matrx/coding-sessions 0.2.0 → 0.3.0

package/dist/{index-29t7n472.d.cts → index-Bbe11HoB.d.cts}

@@ -140,7 +140,7 @@ interface DiscoveredSession {
      */
     title: string;
     /** Where `title` came from (`TITLE_PRECEDENCE`). */
-    titleSource?: TitleSource | undefined;
+    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). */
@@ -263,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";
@@ -432,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[]>;
@@ -606,6 +615,8 @@ interface CodexHome {
 }
 interface ProviderHomes {
     claudeProjects: string;
+    /** The claude-accounts holder's copies (`<vault>/<id>/transcript.jsonl`): a held chat's history when its own file is gone. */
+    claudeVault?: string | undefined;
     /** Every Codex home to read (main first). The owner of the apps' index names them (Matrx 2: the Codex source's homes). */
     codex: CodexHome[];
 }
@@ -616,6 +627,12 @@ interface DiscoverOptions {
     homes?: ProviderHomes | undefined;
     /** Processes that are OUR runs (never "live elsewhere"). */
     excludePids?: ReadonlySet<number> | undefined;
+    /**
+     * The apps' own titles from the owner of their index (`provider:id` → title). Given → the apps'
+     * files are not read here at all (Codex thread names come from it); absent → the standalone host
+     * reads Codex's `session_index.jsonl` itself.
+     */
+    appTitles?: ReadonlyMap<string, string> | undefined;
 }
 /** Fresh "is it live elsewhere?" for one session (the preview and the takeover confirm). */
 declare function sessionActivity(provider: CodingProvider, providerSessionId: string, options?: {
@@ -645,7 +662,8 @@ type HintProvider = "claude" | "codex";
 interface TitleHint {
     /** The app's title (pre-override: the person's rename is applied by whoever draws the row). */
     title: string;
-    source: TitleSource;
+    /** Where the owner's title came from; "unknown" when the owner did not say (shown as such, never guessed). */
+    source: TitleSource | "unknown";
     /** The app hides it: archived in the app (shown behind a toggle). */
     archived?: boolean | undefined;
     /** A scheduled or automated run (shown behind a toggle). */
@@ -658,13 +676,18 @@ interface TitleHint {
 interface TitleHints {
     /** The hints now, keyed `titleHintKey()`; null while the owner's index is still loading. Never waits. */
     current(): ReadonlyMap<string, TitleHint> | null;
-    /** Called after the hints change (a rename in the app, a new chat, the first load). */
+    /** Called after the hints change (a rename in the app, a new chat, the first load, a failure). */
     subscribe(listener: () => void): () => void;
+    /** Why the apps' titles could not be had right now (shown with a Retry), or null. */
+    problem?(): string | null;
+    /** Ask the owner again now (the Retry). */
+    retry?(): void;
 }
 declare function titleHintKey(provider: HintProvider, sessionId: string): string;
 /** A hints port the host fills by hand (tests, or an owner that pushes whole snapshots). */
 declare function createTitleHintsStore(): TitleHints & {
     set(hints: ReadonlyMap<string, TitleHint> | null): void;
+    setProblem(problem: string | null): void;
 };
 
 /**
@@ -748,6 +771,8 @@ interface SearchOptions {
     homes?: ProviderHomes | undefined;
     cursor?: number | undefined;
     limit?: number | undefined;
+    /** The apps' own titles (`provider:id` → title) from the owner of their index; absent → Codex's index is read here. */
+    appTitles?: ReadonlyMap<string, string> | undefined;
     /** Stop reading after this long and hand back a cursor. Default 3.5 s. */
     budgetMs?: number | undefined;
 }
@@ -861,6 +886,8 @@ interface CodingSessionsEngineOptions {
 }
 interface CodingSessionsEngine extends CodingSessionsApi {
     subscribe(listener: (event: CodingEvent) => void): () => void;
+    /** Where the providers keep their sessions, learned after start (Matrx 2: Codex homes from its core). */
+    setHomes(homes: ProviderHomes): void;
     /** Stop every live run and wait for the index to be written. */
     dispose(): Promise<void>;
     readonly dataDir: string;

package/dist/{index-29t7n472.d.ts → index-Bbe11HoB.d.ts}

@@ -140,7 +140,7 @@ interface DiscoveredSession {
      */
     title: string;
     /** Where `title` came from (`TITLE_PRECEDENCE`). */
-    titleSource?: TitleSource | undefined;
+    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). */
@@ -263,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";
@@ -432,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[]>;
@@ -606,6 +615,8 @@ interface CodexHome {
 }
 interface ProviderHomes {
     claudeProjects: string;
+    /** The claude-accounts holder's copies (`<vault>/<id>/transcript.jsonl`): a held chat's history when its own file is gone. */
+    claudeVault?: string | undefined;
     /** Every Codex home to read (main first). The owner of the apps' index names them (Matrx 2: the Codex source's homes). */
     codex: CodexHome[];
 }
@@ -616,6 +627,12 @@ interface DiscoverOptions {
     homes?: ProviderHomes | undefined;
     /** Processes that are OUR runs (never "live elsewhere"). */
     excludePids?: ReadonlySet<number> | undefined;
+    /**
+     * The apps' own titles from the owner of their index (`provider:id` → title). Given → the apps'
+     * files are not read here at all (Codex thread names come from it); absent → the standalone host
+     * reads Codex's `session_index.jsonl` itself.
+     */
+    appTitles?: ReadonlyMap<string, string> | undefined;
 }
 /** Fresh "is it live elsewhere?" for one session (the preview and the takeover confirm). */
 declare function sessionActivity(provider: CodingProvider, providerSessionId: string, options?: {
@@ -645,7 +662,8 @@ type HintProvider = "claude" | "codex";
 interface TitleHint {
     /** The app's title (pre-override: the person's rename is applied by whoever draws the row). */
     title: string;
-    source: TitleSource;
+    /** Where the owner's title came from; "unknown" when the owner did not say (shown as such, never guessed). */
+    source: TitleSource | "unknown";
     /** The app hides it: archived in the app (shown behind a toggle). */
     archived?: boolean | undefined;
     /** A scheduled or automated run (shown behind a toggle). */
@@ -658,13 +676,18 @@ interface TitleHint {
 interface TitleHints {
     /** The hints now, keyed `titleHintKey()`; null while the owner's index is still loading. Never waits. */
     current(): ReadonlyMap<string, TitleHint> | null;
-    /** Called after the hints change (a rename in the app, a new chat, the first load). */
+    /** Called after the hints change (a rename in the app, a new chat, the first load, a failure). */
     subscribe(listener: () => void): () => void;
+    /** Why the apps' titles could not be had right now (shown with a Retry), or null. */
+    problem?(): string | null;
+    /** Ask the owner again now (the Retry). */
+    retry?(): void;
 }
 declare function titleHintKey(provider: HintProvider, sessionId: string): string;
 /** A hints port the host fills by hand (tests, or an owner that pushes whole snapshots). */
 declare function createTitleHintsStore(): TitleHints & {
     set(hints: ReadonlyMap<string, TitleHint> | null): void;
+    setProblem(problem: string | null): void;
 };
 
 /**
@@ -748,6 +771,8 @@ interface SearchOptions {
     homes?: ProviderHomes | undefined;
     cursor?: number | undefined;
     limit?: number | undefined;
+    /** The apps' own titles (`provider:id` → title) from the owner of their index; absent → Codex's index is read here. */
+    appTitles?: ReadonlyMap<string, string> | undefined;
     /** Stop reading after this long and hand back a cursor. Default 3.5 s. */
     budgetMs?: number | undefined;
 }
@@ -861,6 +886,8 @@ interface CodingSessionsEngineOptions {
 }
 interface CodingSessionsEngine extends CodingSessionsApi {
     subscribe(listener: (event: CodingEvent) => void): () => void;
+    /** Where the providers keep their sessions, learned after start (Matrx 2: Codex homes from its core). */
+    setHomes(homes: ProviderHomes): void;
     /** Stop every live run and wait for the index to be written. */
     dispose(): Promise<void>;
     readonly dataDir: string;