@scotthuang/agent-knock-knock 0.13.17 → 0.14.0

package/dist/src/desktop-semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-semantic.js","sourceRoot":"","sources":["../../src/desktop-semantic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,qCAAqC,EAClF,oCAAoC,EAAE,sDAAsD,EAAE,MAAM,wCAAwC,CAAC;AAC/I,OAAO,EAAE,4BAA4B,EAAE,qCAAqC,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAC1J,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,qCAAqC,EAAE,MAAM,8BAA8B,CAAC;AACjI,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,MAA+B,EAAE,MAA+B,EAClG,OAAiC,EAAE,SAAkB;IACrD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IACrE,IAAI,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChH,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACxG,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,cAAc;QAChH,oBAAoB,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAClF,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,SAAS,EAAE,mCAAmC,CAAC,CAAC,CAAC;IAC1F,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzD,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACrD,YAAY,CAAC,IAAI,EAAE,8BAA8B,EAAE,YAAY,CAAC,MAAM,CAAC,uBAAuB,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACjJ,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA+B;IAChE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACtH,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IACrE,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC1E,OAAO,KAAK,CAAC;AACf,CAAC;AAGD,oFAAoF;AACpF,MAAM,UAAU,0BAA0B,CAAC,GAAW,EAAE,MAA+B,EACrF,MAA+B,EAAE,OAAsD;IACvF,MAAM,OAAO,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,qCAAqC,CAAC,CAAC;IAC3F,MAAM,aAAa,GAAG,qCAAqC,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACrG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAClI,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC5G,MAAM,QAAQ,GAAG,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvE,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;IAC3F,8BAA8B,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAC9G,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;QAC3E,oCAAoC,EAAE,WAAW,EAAE,mCAAmC,EAAE,UAAU,CAAC,UAAU;QAC7G,oBAAoB,EAAE,UAAU,CAAC,CAAC;IACpC,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW,EAAE,MAA+B,EAClF,MAA+B,EAAE,OAAsD;IACvF,MAAM,OAAO,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC7K,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,cAAc,CAAC;IACnD,IAAI,QAAQ,KAAK,cAAc,IAAI,QAAQ,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACrH,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,qCAAqC,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACrG,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAC9E,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,qCAAqC,CAAC,EAAE,aAAa,CAAC,CAAC;IAC3F,IAAI,CAAC,4BAA4B,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACjH,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAClG,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,oCAAoC,EAAE,WAAW;QACzG,mCAAmC,EAAE,UAAU,CAAC,UAAU,EAAE,oBAAoB,EAAE,UAAU,CAAC,CAAC;IAChG,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AACD,SAAS,mBAAmB,CAAC,GAAW,EAAE,OAAuE,EAC/G,UAAkB,EAAE,SAAiB,EAAE,aAAqB;IAC5D,MAAM,KAAK,GAAG,oCAAoC,CAAC,GAAG,EACpD,oCAAoC,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACxG,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAClG,MAAM,IAAI,KAAK,CAAC,yGAAyG,CAAC,CAAC;IAC7H,CAAC;IACD,MAAM,WAAW,GAAG,qCAAqC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,UAAU,EACnG,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7D,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,yBAAyB,CAAC,MAA+B;IAChE,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,IAAI,uBAAuB,CAAC,MAAM,CAAC,eAAe,CAAC;QAChH,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IACvC,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;WAC/E,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC;QAChH,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,YAAY;QAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAC3D,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,sBAAsB,EAAE,EAAE,EAAE,KAAK,IAAI,YAAa,EAAE,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,GAAW,EAAE,OAAsD,EAAE,MAAe;IAC5I,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,eAAe,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,eAAe,CAAC;WACzG,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO;IAC7F,8FAA8F;IAC9F,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAC9D,MAAM,EAAE,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACnD,sDAAsD,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7G,IAAI,WAAqE,CAAC;IAC1E,IAAI,CAAC;QAAC,WAAW,GAAG,qCAAqC,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAAC,CAAC;IAClJ,MAAM,CAAC;QAAC,OAAO;IAAC,CAAC;IACjB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,UAAU,CAAC,8BAA8B,CAAC;QAC9D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,SAAS;QACnD,qCAAqC,CAAC,GAAG,EAAE,oCAAoC,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,EACnH,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9H,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,KAAc;IAC9D,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACpI,CAAC"}

package/dist/src/desktop-session-catalog.d.ts

@@ -0,0 +1,68 @@
+import { type DesktopSidebarReader } from "./desktop-sidebar-metadata.js";
+import { type DesktopSidebarMembership, type DesktopSidebarSummary } from "./desktop-sidebar-selection.js";
+import type { DesktopThreadIdentity } from "./desktop-types.js";
+import { type DesktopMetadataBatch, type DesktopMetadataReader, type DesktopMetadataSource } from "./desktop-metadata-reader.js";
+export interface DesktopCatalogProvenance {
+    database: string;
+    table: "threads" | "local_thread_catalog";
+    sourceKind: string | null;
+    threadSource: string | null;
+}
+export interface DesktopCatalogEntry extends DesktopThreadIdentity {
+    conversationId: string;
+    title: string;
+    cwd: string | null;
+    updatedAtMs: number;
+    originator: string | null;
+    projectId: string | null;
+    sourceKind: string | null;
+    threadSource: string | null;
+    catalogMembership: "desktop_catalog" | "state_metadata";
+    localVerifiable: boolean;
+    /** Directory membership does not establish a current owner, loaded state, or send capability. */
+    metadataOnly: true;
+    provenance: DesktopCatalogProvenance[];
+    archived?: boolean;
+    threadSectionId?: string | null;
+    sectionPosition?: number;
+    sidebar?: DesktopSidebarMembership;
+}
+export interface DesktopCatalogListOptions {
+    view?: "sidebar" | "history";
+    limit?: number;
+    cursor?: string;
+    search?: string;
+    /** Exact project ID or normalized absolute project directory. */
+    project?: string;
+}
+export interface DesktopCatalogPage {
+    sessions: DesktopCatalogEntry[];
+    nextCursor?: string;
+    total: number;
+    sources: DesktopMetadataSource[];
+    /** All available supported sources were read; not a claim of live or cloud completeness. */
+    complete: boolean;
+    view?: "sidebar" | "history";
+    historyTotal?: number;
+    sidebar?: DesktopSidebarSummary;
+}
+export interface DesktopSessionCatalogOptions {
+    codexHomes?: string[];
+    readMetadata?: DesktopMetadataReader;
+    readSidebar?: DesktopSidebarReader;
+}
+export declare class DesktopSessionCatalog {
+    private readonly homes;
+    private readonly readMetadata;
+    private readonly readSidebar;
+    constructor(options?: DesktopSessionCatalogOptions);
+    list(options?: DesktopCatalogListOptions): Promise<DesktopCatalogPage>;
+    get(identity: DesktopThreadIdentity): Promise<DesktopCatalogEntry | undefined>;
+    private collect;
+}
+/** Catalog evidence outranks state evidence; owner availability is deliberately not an input. */
+export declare function mergeDesktopMetadata(batches: DesktopMetadataBatch[]): {
+    sessions: DesktopCatalogEntry[];
+    sources: DesktopMetadataSource[];
+    archivedIds: Set<string>;
+};

package/dist/src/desktop-session-catalog.js

@@ -0,0 +1,225 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createDesktopConversationId } from "./desktop-identity.js";
+import { readDesktopSidebarMetadata } from "./desktop-sidebar-metadata.js";
+import { selectDesktopSidebar } from "./desktop-sidebar-selection.js";
+import { readDesktopMetadata } from "./desktop-metadata-reader.js";
+export class DesktopSessionCatalog {
+    homes;
+    readMetadata;
+    readSidebar;
+    constructor(options = {}) {
+        this.homes = [...new Set((options.codexHomes ?? [path.join(os.homedir(), ".codex"), ...(process.env.CODEX_HOME ? [process.env.CODEX_HOME] : [])]).map(canonicalHome))];
+        this.readMetadata = options.readMetadata ?? readDesktopMetadata;
+        this.readSidebar = options.readSidebar ?? readDesktopSidebarMetadata;
+    }
+    async list(options = {}) {
+        const limit = options.limit ?? 50;
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 500)
+            throw new Error("Desktop catalog limit must be 1..500");
+        const search = options.search?.trim().toLocaleLowerCase() ?? "";
+        const project = options.project?.trim() ?? "";
+        const view = options.view ?? "history";
+        if (view !== "sidebar" && view !== "history")
+            throw new Error("Desktop view must be sidebar or history");
+        const all = await this.collect();
+        const selection = view === "sidebar" ? selectDesktopSidebar(all.sessions, new Map(await Promise.all(this.homes.map(async (home) => [home, await this.readSidebar(home)]))), all.archivedIds) : undefined;
+        const sessions = selection?.sessions ?? (view === "history" ? all.sessions : []);
+        const sources = all.sources;
+        const filtered = sessions.filter((session) => {
+            if (project && session.projectId !== project && session.sidebar?.projectId !== project && (!session.cwd || !path.isAbsolute(session.cwd) || !path.isAbsolute(project) || path.resolve(session.cwd) !== path.resolve(project)))
+                return false;
+            return !search || [session.title, session.cwd, session.threadId, session.projectId]
+                .some((value) => value?.toLocaleLowerCase().includes(search));
+        });
+        const queryKey = createHash("sha256").update(JSON.stringify([this.homes, search, project, view, selection?.fingerprint])).digest("hex");
+        return {
+            ...paginateCatalog(filtered, { limit, cursor: options.cursor, view, queryKey }),
+            sources,
+            complete: sources.every((source) => source.status !== "error"),
+            view, historyTotal: all.sessions.length, ...(selection ? { sidebar: selection.sidebar } : {})
+        };
+    }
+    async get(identity) {
+        const conversationId = createDesktopConversationId({ ...identity, codexHome: canonicalHome(identity.codexHome) });
+        return (await this.collect()).sessions.find((entry) => entry.conversationId === conversationId);
+    }
+    async collect() {
+        const batches = [];
+        for (const home of this.homes) {
+            try {
+                batches.push(...await this.readMetadata(home));
+            }
+            catch (error) {
+                batches.push({ source: { database: home, codexHome: home, kind: "state", status: "error", error: error instanceof Error ? error.message : String(error) }, rows: [] });
+            }
+        }
+        return mergeDesktopMetadata(batches);
+    }
+}
+function paginateCatalog(filtered, options) {
+    const after = options.cursor ? decodeCursor(options.cursor, options.queryKey) : undefined;
+    if (after && options.view === "sidebar" && !filtered.some(entry => entry.conversationId === after.conversationId))
+        throw new Error("Invalid Desktop sidebar cursor");
+    const remaining = after && options.view === "sidebar" ? filtered.slice(filtered.findIndex(entry => entry.conversationId === after.conversationId) + 1) : after ? filtered.filter(entry => entry.updatedAtMs < after.updatedAtMs || entry.updatedAtMs === after.updatedAtMs && entry.conversationId > after.conversationId) : filtered;
+    const page = remaining.slice(0, options.limit), tail = page.at(-1);
+    return { sessions: page, total: filtered.length,
+        ...(remaining.length > page.length && tail ? { nextCursor: Buffer.from(JSON.stringify({ v: 1, q: options.queryKey, t: tail.updatedAtMs, id: tail.conversationId })).toString("base64url") } : {}) };
+}
+/** Catalog evidence outranks state evidence; owner availability is deliberately not an input. */
+export function mergeDesktopMetadata(batches) {
+    const entries = new Map();
+    const preferredSourceTimes = new Map();
+    const sources = [];
+    // Determine directory membership before admitting state-only rows.
+    const normalized = [];
+    for (const batch of batches) {
+        try {
+            const parsed = batch.source.status === "ok" ? batch.rows.map((row) => normalizeRow(row, batch)) : [];
+            normalized.push(...parsed);
+            sources.push(batch.source);
+        }
+        catch (error) {
+            sources.push({ ...batch.source, status: "error", error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    const catalogIds = new Set(normalized.filter(({ entry }) => entry.catalogMembership === "desktop_catalog").map(({ entry }) => entry.conversationId));
+    const archivedIds = new Set(normalized.filter(({ entry }) => entry.archived).map(({ entry }) => `${entry.codexHome}\0${entry.hostId}\0${entry.threadId}`));
+    for (const { entry, stateEligible } of normalized) {
+        if (archivedIds.has(`${entry.codexHome}\0${entry.hostId}\0${entry.threadId}`))
+            continue;
+        if (entry.catalogMembership === "state_metadata" && !stateEligible && !catalogIds.has(entry.conversationId))
+            continue;
+        const previous = entries.get(entry.conversationId);
+        if (!previous) {
+            entries.set(entry.conversationId, entry);
+            preferredSourceTimes.set(entry.conversationId, entry.updatedAtMs);
+            continue;
+        }
+        const preferred = preferredEntry(entry, previous, preferredSourceTimes.get(entry.conversationId) ?? 0);
+        if (preferred === entry)
+            preferredSourceTimes.set(entry.conversationId, entry.updatedAtMs);
+        entries.set(entry.conversationId, enrichPreferredEntry(preferred, previous, entry));
+    }
+    return { sources, archivedIds, sessions: [...entries.values()].sort((a, b) => b.updatedAtMs - a.updatedAtMs || compare(a.conversationId, b.conversationId)) };
+}
+function preferredEntry(entry, previous, previousSourceTime) {
+    if (entry.catalogMembership !== previous.catalogMembership) {
+        return entry.catalogMembership === "desktop_catalog" ? entry : previous;
+    }
+    return entry.updatedAtMs > previousSourceTime ? entry : previous;
+}
+function enrichPreferredEntry(preferred, previous, entry) {
+    const other = preferred === entry ? previous : entry;
+    return {
+        ...preferred,
+        updatedAtMs: Math.max(previous.updatedAtMs, entry.updatedAtMs),
+        title: preferred.title || other.title,
+        cwd: preferred.cwd ?? other.cwd,
+        originator: preferred.originator ?? other.originator,
+        projectId: preferred.projectId ?? other.projectId,
+        threadSource: preferred.threadSource ?? other.threadSource,
+        threadSectionId: preferred.threadSectionId ?? other.threadSectionId,
+        sectionPosition: preferred.sectionPosition ?? other.sectionPosition,
+        provenance: [...previous.provenance, ...entry.provenance]
+    };
+}
+function normalizeRow(row, batch) {
+    const state = batch.source.kind === "state";
+    const identity = {
+        codexHome: canonicalHome(batch.source.codexHome),
+        hostId: state ? "local" : requiredText(row.host_id, "host_id"),
+        threadId: requiredText(state ? row.id : row.thread_id, "thread_id")
+    };
+    const sourceKind = normalizedSource(state ? row.source : row.source_kind);
+    const threadSource = optionalText(row.thread_source);
+    const title = metadataTitle(row, state);
+    const updatedAtMs = metadataTimestamp(row, state);
+    const catalogMembership = state ? "state_metadata" : "desktop_catalog";
+    return {
+        entry: {
+            ...identity, conversationId: createDesktopConversationId(identity), title: title.slice(0, 160),
+            cwd: optionalText(row.cwd), updatedAtMs, originator: optionalText(row.originator),
+            projectId: optionalText(row.project_id), sourceKind, threadSource, catalogMembership, metadataOnly: true,
+            ...(state ? stateSidebarMetadata(row) : {}),
+            localVerifiable: identity.hostId === "local" && (state || batch.hosts?.[identity.hostId] === "local") && sourceKind !== "chatgpt",
+            provenance: [{ database: batch.source.database, table: state ? "threads" : "local_thread_catalog", sourceKind, threadSource }]
+        },
+        stateEligible: !state || eligibleStateRow(row, sourceKind, threadSource)
+    };
+}
+function stateSidebarMetadata(row) {
+    return { archived: row.archived === 1 || row.archived === true, threadSectionId: optionalText(row.thread_section_id),
+        ...(typeof row.section_position === "number" && Number.isSafeInteger(row.section_position) ? { sectionPosition: row.section_position } : {}) };
+}
+function metadataTitle(row, state) {
+    return state ? optionalText(row.name)?.trim() || optionalText(row.title) || "" : optionalText(row.display_title) || "";
+}
+function metadataTimestamp(row, state) {
+    const updated = state ? row.updated_at_ms ?? (typeof row.updated_at === "number" ? row.updated_at * 1000 : null)
+        : typeof row.source_updated_at === "number" ? row.source_updated_at * 1000 : null;
+    if (typeof updated !== "number" || !Number.isFinite(updated) || updated < 0 || !Number.isSafeInteger(Math.round(updated))) {
+        throw new Error("Invalid metadata timestamp");
+    }
+    return Math.round(updated);
+}
+function eligibleStateRow(row, sourceKind, threadSource) {
+    return (row.archived === 0 || row.archived === false) && !optionalText(row.parent_thread_id) &&
+        sourceKind !== "exec" && sourceKind !== "structured" && !sourceKind?.toLowerCase().startsWith("subagent") &&
+        !["chatgpt_hidden", "ambient_suggestions", "pull_request_fix_automation"].includes(threadSource ?? "");
+}
+function normalizedSource(value) {
+    const source = optionalText(value);
+    if (!source?.trim().startsWith("{"))
+        return source;
+    try {
+        const parsed = JSON.parse(source);
+        if (parsed && typeof parsed === "object") {
+            if (Object.keys(parsed).some((key) => key.toLowerCase() === "subagent"))
+                return "subagent";
+            if (typeof parsed.custom === "string")
+                return parsed.custom;
+        }
+    }
+    catch { /* Unknown structured metadata is not proof of a root thread. */ }
+    return "structured";
+}
+function canonicalHome(home) {
+    const absolute = path.resolve(home);
+    try {
+        return fs.realpathSync(absolute);
+    }
+    catch {
+        return absolute;
+    }
+}
+function requiredText(value, label) {
+    const text = optionalText(value);
+    if (!text)
+        throw new Error(`Invalid metadata ${label}`);
+    return text;
+}
+function optionalText(value) {
+    if (value == null)
+        return null;
+    if (typeof value !== "string")
+        throw new Error("Invalid metadata text field");
+    return value || null;
+}
+function compare(a, b) { return a < b ? -1 : a > b ? 1 : 0; }
+function decodeCursor(cursor, query) {
+    try {
+        if (cursor.length > 8192 || !/^[A-Za-z0-9_-]+$/u.test(cursor))
+            throw new Error();
+        const value = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+        if (value.v !== 1 || value.q !== query || !Number.isSafeInteger(value.t) || typeof value.id !== "string")
+            throw new Error();
+        return { updatedAtMs: value.t, conversationId: value.id };
+    }
+    catch {
+        throw new Error("Invalid Desktop catalog cursor or changed search/project filter");
+    }
+}
+//# sourceMappingURL=desktop-session-catalog.js.map

package/dist/src/desktop-session-catalog.js.map

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

package/dist/src/desktop-session-controls.d.ts

@@ -0,0 +1,145 @@
+import type { DesktopIpcClient } from "./desktop-ipc-client.js";
+import { type DesktopModelSettings, type DesktopObserveTarget, type DesktopSnapshot, type DesktopThreadIdentity } from "./desktop-types.js";
+export type DesktopPermissionMode = "read-only" | "default" | "full-access";
+export interface DesktopModelSelection {
+    model: string;
+    reasoningEffort: string;
+    collaborationMode?: "plan" | "default";
+}
+export interface DesktopSessionControlDependencies {
+    observe(identity: DesktopThreadIdentity): Promise<DesktopSnapshot>;
+    readModelSettings(identity: DesktopThreadIdentity, target: DesktopObserveTarget): Promise<DesktopModelSettings>;
+    updateSettings(identity: DesktopThreadIdentity, options: Parameters<DesktopIpcClient["updateThreadSettingsOnce"]>[0]): ReturnType<DesktopIpcClient["updateThreadSettingsOnce"]>;
+    interruptTurn(identity: DesktopThreadIdentity, options: Parameters<DesktopIpcClient["interruptTurnOnce"]>[0]): ReturnType<DesktopIpcClient["interruptTurnOnce"]>;
+    sleep?(ms: number): Promise<void>;
+    randomUUID?(): string;
+    observationAttempts?: number;
+}
+/** Settings affect one idle native conversation; effective snapshots, not acknowledgements, prove success. */
+export declare function createDesktopSessionControls(deps: DesktopSessionControlDependencies): {
+    permissionOptions: (identity: DesktopThreadIdentity) => Promise<{
+        scope: string;
+        current: DesktopPermissionMode | null;
+        defaults_changed: boolean;
+        settings: {
+            activePermissionProfile: {
+                id: string;
+                extends?: string | null;
+            } | null | undefined;
+            approvalPolicy: string | Record<string, unknown> | undefined;
+            approvalsReviewer: string | undefined;
+            sandboxPolicy: Record<string, unknown> | undefined;
+            runtimeWorkspaceRoots: string[] | undefined;
+        } | undefined;
+        applies_to: string;
+        choices: {
+            id: DesktopPermissionMode;
+            mode: DesktopPermissionMode;
+            label: "Default" | "Full Access" | "Read Only";
+            description: string;
+        }[];
+    }>;
+    setPermissions: (identity: DesktopThreadIdentity, mode: DesktopPermissionMode) => Promise<{
+        scope: string;
+        defaults_changed: boolean;
+        requested: {
+            mode: DesktopPermissionMode;
+        };
+        applied: boolean;
+        do_not_retry: boolean;
+        outcome: string;
+        effective: {
+            mode: DesktopPermissionMode;
+        };
+    } | {
+        scope: string;
+        defaults_changed: boolean;
+        requested: {
+            mode: DesktopPermissionMode;
+        };
+        applied: boolean;
+        do_not_retry: boolean;
+        outcome: string;
+        error_code: string;
+    } | {
+        scope: string;
+        defaults_changed: boolean;
+        requested: {
+            mode: DesktopPermissionMode;
+        };
+        applied: boolean;
+        do_not_retry: boolean;
+        outcome: string;
+        effective: {
+            mode: DesktopPermissionMode;
+        };
+        applies_to: string;
+        settings: {
+            activePermissionProfile: {
+                id: string;
+                extends?: string | null;
+            } | null | undefined;
+            approvalPolicy: string | Record<string, unknown> | undefined;
+            approvalsReviewer: string | undefined;
+            sandboxPolicy: Record<string, unknown> | undefined;
+            runtimeWorkspaceRoots: string[] | undefined;
+        } | undefined;
+    }>;
+    modelOptions: (identity: DesktopThreadIdentity) => Promise<{
+        scope: string;
+        current: {
+            model: string | null;
+            reasoning_effort: string | null;
+            collaboration_mode: string | null;
+        };
+        model_provider: string | null | undefined;
+        catalog_available: boolean;
+        selection_mode: string;
+        collaboration_modes: string[];
+        limitations: string[];
+    }>;
+    setModel: (identity: DesktopThreadIdentity, selection: DesktopModelSelection) => Promise<{
+        scope: string;
+        defaults_changed: boolean;
+        requested: {
+            model: string;
+            reasoning_effort: string;
+            collaboration_mode?: "default" | "plan" | undefined;
+        };
+        applied: boolean;
+        do_not_retry: boolean;
+        outcome: string;
+        effective: {
+            model: string | null;
+            reasoning_effort: string | null;
+            collaboration_mode: string | null;
+        };
+    } | {
+        scope: string;
+        defaults_changed: boolean;
+        requested: {
+            model: string;
+            reasoning_effort: string;
+            collaboration_mode?: "default" | "plan" | undefined;
+        };
+        applied: boolean;
+        do_not_retry: boolean;
+        outcome: string;
+        error_code: string;
+    }>;
+    interrupt: (identity: DesktopThreadIdentity, expectedTurnId: string) => Promise<{
+        error_code?: undefined;
+        native_turn_id: string;
+        interrupted: boolean;
+        state: import("./desktop-types.js").DesktopTurnStatus;
+        outcome: string;
+        do_not_retry: boolean;
+    } | {
+        native_turn_id: string;
+        interrupted: boolean;
+        state: string;
+        outcome: string;
+        do_not_retry: boolean;
+        error_code: string;
+    }>;
+};