@scotthuang/agent-knock-knock 0.13.18 → 0.14.0

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

@@ -0,0 +1,176 @@
+import { randomUUID } from "node:crypto";
+import { DesktopIpcError } from "./desktop-types.js";
+const presets = {
+    "read-only": { permissions: ":read-only", approvalPolicy: "on-request", sandboxType: "readOnly", label: "Read Only" },
+    default: { permissions: ":workspace", approvalPolicy: "on-request", sandboxType: "workspaceWrite", label: "Default" },
+    "full-access": { permissions: ":danger-full-access", approvalPolicy: "never", sandboxType: "dangerFullAccess", label: "Full Access" }
+};
+function sameThread(snapshot, identity) {
+    if (snapshot.threadId !== identity.threadId || !snapshot.ownerClientId) {
+        throw new DesktopIpcError("invalid_response", "Desktop settings observation changed the selected native thread");
+    }
+}
+function idleSnapshot(snapshot, identity) {
+    sameThread(snapshot, identity);
+    if (!snapshot.canSend || snapshot.runtimeStatus !== "idle") {
+        throw new DesktopIpcError("thread_not_idle", "Change Desktop settings while this exact conversation is idle");
+    }
+}
+function effectivePermissions(snapshot) {
+    const source = snapshot.runtimeStatus === "idle" ? snapshot.threadSettings ?? snapshot.currentPermissions : snapshot.currentPermissions;
+    if (!source)
+        return undefined;
+    return { activePermissionProfile: source.activePermissionProfile, approvalPolicy: source.approvalPolicy,
+        approvalsReviewer: source.approvalsReviewer, sandboxPolicy: source.sandboxPolicy, runtimeWorkspaceRoots: source.runtimeWorkspaceRoots };
+}
+function permissionMode(snapshot) {
+    const current = effectivePermissions(snapshot);
+    return Object.keys(presets).find(mode => {
+        const preset = presets[mode];
+        return current?.activePermissionProfile?.id === preset.permissions && current.approvalPolicy === preset.approvalPolicy
+            && current.approvalsReviewer === "user" && current.sandboxPolicy?.type === preset.sandboxType;
+    }) ?? null;
+}
+function modelState(snapshot) {
+    return { model: snapshot.latestCollaborationMode?.settings.model ?? snapshot.latestModel ?? null,
+        reasoning_effort: snapshot.latestCollaborationMode?.settings.reasoning_effort ?? snapshot.latestReasoningEffort ?? null,
+        collaboration_mode: snapshot.latestCollaborationMode?.mode ?? null };
+}
+function matchesModel(snapshot, selection, expectedMode) {
+    const current = modelState(snapshot);
+    return current.model === selection.model && current.reasoning_effort === selection.reasoningEffort
+        && (expectedMode == null || current.collaboration_mode === expectedMode);
+}
+function validateModel(selection) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9._:/+\-]{0,159}$/u.test(selection.model)
+        || !/^[a-z][a-z0-9_-]{0,63}$/u.test(selection.reasoningEffort)
+        || selection.collaborationMode !== undefined && !["plan", "default"].includes(selection.collaborationMode)) {
+        throw new DesktopIpcError("invalid_argument", "Desktop model requires an explicit model/effort tuple and optional plan/default mode");
+    }
+}
+function errorCode(error) {
+    return error instanceof DesktopIpcError ? error.code : "desktop_effective_settings_unconfirmed";
+}
+/** Settings affect one idle native conversation; effective snapshots, not acknowledgements, prove success. */
+export function createDesktopSessionControls(deps) {
+    const sleep = deps.sleep ?? (ms => new Promise(resolve => setTimeout(resolve, ms)));
+    const uuid = deps.randomUUID ?? randomUUID;
+    async function observe(identity) {
+        const snapshot = await deps.observe(identity);
+        sameThread(snapshot, identity);
+        return snapshot;
+    }
+    async function confirm(identity, owner, matches) {
+        for (let attempt = 0; attempt < (deps.observationAttempts ?? 20); attempt++) {
+            const snapshot = await observe(identity);
+            if (snapshot.ownerClientId !== owner)
+                throw new DesktopIpcError("owner_changed", "Desktop owner changed while verifying the requested setting", "unknown");
+            if (matches(snapshot))
+                return snapshot;
+            await sleep(250);
+        }
+        throw new DesktopIpcError("timeout", "The requested Desktop state has not been observed; refresh Status before another operation", "unknown");
+    }
+    async function change(identity, before, settings, matches) {
+        let dispatchError;
+        try {
+            await deps.updateSettings(identity, { threadId: identity.threadId, ownerClientId: before.ownerClientId,
+                operationId: uuid(), settings, beforeDispatch: async (snapshot) => idleSnapshot(snapshot, identity) });
+        }
+        catch (error) {
+            if (error instanceof DesktopIpcError && error.dispatchState === "not_sent")
+                throw error;
+            dispatchError = error;
+        }
+        try {
+            return { snapshot: await confirm(identity, before.ownerClientId, matches) };
+        }
+        catch (error) {
+            return { error_code: errorCode(dispatchError ?? error) };
+        }
+    }
+    async function permissionOptions(identity) {
+        const snapshot = await observe(identity);
+        return { scope: "current_session", current: permissionMode(snapshot), defaults_changed: false,
+            settings: effectivePermissions(snapshot), applies_to: snapshot.runtimeStatus === "idle" ? "next_task" : "active_task", choices: Object.keys(presets).map(mode => ({
+                id: mode, mode, label: presets[mode].label, description: mode === "full-access"
+                    ? "Unrestricted execution without approval prompts in this conversation."
+                    : mode === "read-only" ? "Read-only access; additional access requires approval."
+                        : "Write in this conversation's workspace; additional access requires approval."
+            })) };
+    }
+    async function setPermissions(identity, mode) {
+        if (!Object.hasOwn(presets, mode))
+            throw new DesktopIpcError("invalid_argument", "Unknown Desktop permission preset");
+        const before = await observe(identity);
+        idleSnapshot(before, identity);
+        const requested = { mode };
+        const previous = permissionMode(before);
+        const base = { scope: "current_session", defaults_changed: false, requested };
+        if (previous === mode)
+            return { ...base, applied: true, do_not_retry: false, outcome: "already_effective", effective: requested };
+        const preset = presets[mode];
+        const result = await change(identity, before, { permissions: preset.permissions,
+            approvalPolicy: preset.approvalPolicy, approvalsReviewer: "user" }, snapshot => permissionMode(snapshot) === mode);
+        if (!result.snapshot)
+            return { ...base, applied: false, do_not_retry: true, outcome: "unconfirmed", error_code: result.error_code };
+        return { ...base, applied: true, do_not_retry: false, outcome: "changed", effective: requested, applies_to: "next_task", settings: effectivePermissions(result.snapshot) };
+    }
+    async function modelOptions(identity) {
+        const snapshot = await observe(identity);
+        const settings = await deps.readModelSettings(identity, { threadId: identity.threadId, ownerClientId: snapshot.ownerClientId });
+        return { scope: "current_session", current: modelState(snapshot), model_provider: settings.modelProvider,
+            catalog_available: false, selection_mode: "explicit_model_id",
+            collaboration_modes: ["default", "plan"],
+            limitations: ["Desktop owner exposes current model settings but no model catalog. Use an explicitly requested model ID. AKK verifies effective settings; model availability is not exposed."] };
+    }
+    async function setModel(identity, selection) {
+        validateModel(selection);
+        const before = await observe(identity);
+        idleSnapshot(before, identity);
+        const expectedMode = selection.collaborationMode ?? before.latestCollaborationMode?.mode;
+        const requested = { model: selection.model, reasoning_effort: selection.reasoningEffort,
+            ...(selection.collaborationMode ? { collaboration_mode: selection.collaborationMode } : {}) };
+        const base = { scope: "current_session", defaults_changed: false, requested };
+        if (matchesModel(before, selection, expectedMode))
+            return { ...base, applied: true, do_not_retry: false, outcome: "already_effective", effective: modelState(before) };
+        const result = await change(identity, before, { model: selection.model, effort: selection.reasoningEffort,
+            ...(selection.collaborationMode ? { collaborationMode: { mode: selection.collaborationMode,
+                    settings: { model: selection.model, reasoning_effort: selection.reasoningEffort, developer_instructions: null } } } : {})
+        }, snapshot => matchesModel(snapshot, selection, expectedMode));
+        if (!result.snapshot)
+            return { ...base, applied: false, do_not_retry: true, outcome: "unconfirmed", error_code: result.error_code };
+        return { ...base, applied: true, do_not_retry: false, outcome: "changed", effective: modelState(result.snapshot) };
+    }
+    async function interrupt(identity, expectedTurnId) {
+        if (!expectedTurnId?.trim())
+            throw new DesktopIpcError("invalid_argument", "Desktop cancellation requires its exact native turn");
+        const before = await observe(identity);
+        const exact = before.turns.find(turn => turn.turnId === expectedTurnId);
+        if (exact && ["completed", "failed", "interrupted"].includes(exact.status)) {
+            return { native_turn_id: expectedTurnId, interrupted: exact.status === "interrupted", state: exact.status, outcome: "already_settled", do_not_retry: false };
+        }
+        if (!exact || exact.status !== "inProgress" || before.latestTurnId !== expectedTurnId) {
+            throw new DesktopIpcError("stale_interaction", "The selected Desktop task is no longer the active task");
+        }
+        let dispatchError;
+        try {
+            await deps.interruptTurn(identity, { threadId: identity.threadId, ownerClientId: before.ownerClientId, expectedTurnId, operationId: uuid() });
+        }
+        catch (error) {
+            if (error instanceof DesktopIpcError && error.dispatchState === "not_sent")
+                throw error;
+            dispatchError = error;
+        }
+        try {
+            const snapshot = await confirm(identity, before.ownerClientId, state => state.turns.some(turn => turn.turnId === expectedTurnId && ["completed", "failed", "interrupted"].includes(turn.status)));
+            const status = snapshot.turns.find(turn => turn.turnId === expectedTurnId).status;
+            return { native_turn_id: expectedTurnId, interrupted: status === "interrupted", state: status, outcome: "settled", do_not_retry: false };
+        }
+        catch (error) {
+            return { native_turn_id: expectedTurnId, interrupted: false, state: "unconfirmed", outcome: "unconfirmed", do_not_retry: true, error_code: errorCode(dispatchError ?? error) };
+        }
+    }
+    return { permissionOptions, setPermissions, modelOptions, setModel, interrupt };
+}
+//# sourceMappingURL=desktop-session-controls.js.map

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

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

package/dist/src/desktop-sidebar-metadata.d.ts

@@ -0,0 +1,27 @@
+export interface DesktopSidebarMetadata {
+    available: boolean;
+    mode?: string;
+    collapsed: Record<string, boolean>;
+    expanded: Record<string, boolean>;
+    projects: Record<string, {
+        name: string;
+        roots: string[];
+    }>;
+    assignments: Record<string, {
+        projectId: string;
+        hostId: string;
+    }>;
+    projectOrder: string[];
+    pinnedIds: string[];
+    migratedPinnedIds: string[];
+    nativePinnedOrder: string[];
+    projectIdMappings: Record<string, string>;
+    projectlessIds: string[];
+    rootHints: Record<string, string>;
+    customSectionThreadIds: string[];
+    limitations: string[];
+}
+export type DesktopSidebarReader = (codexHome: string) => Promise<DesktopSidebarMetadata>;
+/** Select only layout metadata. Never return the global state, credentials, or drafts. */
+export declare function readDesktopSidebarMetadata(home: string): Promise<DesktopSidebarMetadata>;
+export declare function parseDesktopSidebarMetadata(value: unknown, home: string): DesktopSidebarMetadata;

package/dist/src/desktop-sidebar-metadata.js

@@ -0,0 +1,83 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+/** Select only layout metadata. Never return the global state, credentials, or drafts. */
+export async function readDesktopSidebarMetadata(home) {
+    try {
+        const file = path.join(home, ".codex-global-state.json");
+        if ((await fs.stat(file)).size > 16 * 1024 * 1024)
+            throw new Error("oversized layout");
+        return parseDesktopSidebarMetadata(JSON.parse(await fs.readFile(file, "utf8")), home);
+    }
+    catch {
+        return { available: false, collapsed: {}, expanded: {}, projects: {}, assignments: {}, projectOrder: [],
+            pinnedIds: [], migratedPinnedIds: [], nativePinnedOrder: [], projectIdMappings: {},
+            projectlessIds: [], rootHints: {}, customSectionThreadIds: [],
+            limitations: ["Desktop persisted sidebar layout is unavailable or invalid."] };
+    }
+}
+export function parseDesktopSidebarMetadata(value, home) {
+    const state = record(value), atoms = record(state["electron-persisted-atom-state"]);
+    const preferences = record(atoms["flat-project-sidebar-preferences-v1"]);
+    const identity = `local:${home}`;
+    const projects = Object.fromEntries(Object.entries(record(state["local-projects"]))
+        .filter(([, item]) => typeof record(item).name === "string")
+        .map(([id, item]) => [id, { name: String(record(item).name).slice(0, 160), roots: projectRoots(record(item)) }]));
+    const limitations = [];
+    const sections = Object.values(record(atoms["sidebar-custom-sections-v3"])).flatMap(item => {
+        const sectionList = record(item).sections;
+        return Array.isArray(sectionList) ? sectionList : [];
+    });
+    if (sections.length) {
+        limitations.push("Custom sidebar sections are not included in this layout projection.");
+    }
+    if (Object.values(record(atoms["chatgpt-sidebar-state-v2"])).some(item => ["pinnedConversations", "pinnedProjects", "projects"].some(key => Array.isArray(record(item)[key]) && record(item)[key].length))) {
+        limitations.push("Cloud sidebar projects and pins are not included in this local layout projection.");
+    }
+    return { available: true, mode: typeof preferences.mode === "string" ? preferences.mode : undefined,
+        collapsed: booleanRecord(atoms["sidebar-collapsed-sections-v1"]),
+        expanded: Object.fromEntries(Object.entries(atoms).filter(([key, item]) => key.startsWith("sidebar-project-expanded-v1-codex:") && typeof item === "boolean")
+            .map(([key, item]) => [key.slice("sidebar-project-expanded-v1-codex:".length), item])),
+        projects, assignments: sidebarAssignments(state, limitations),
+        projectOrder: strings(state["project-order"]), pinnedIds: strings(state["pinned-thread-ids"]),
+        migratedPinnedIds: strings(record(state["app-server-migrated-pinned-thread-ids-by-host"])[identity]),
+        nativePinnedOrder: strings(atoms["app-server-pinned-thread-order-v1"]),
+        projectIdMappings: stringRecord(record(state["app-server-project-id-by-legacy-project-id-by-host"])[identity]),
+        projectlessIds: strings(state["projectless-thread-ids"]), rootHints: stringRecord(state["thread-workspace-root-hints"]),
+        customSectionThreadIds: sections.flatMap(section => strings(record(section).itemKeys))
+            .filter(key => key.startsWith("codex:thread:local:")).map(key => key.slice("codex:thread:local:".length)), limitations };
+}
+function projectRoots(project) {
+    const aliases = Array.isArray(project.rootPathAliases) ? project.rootPathAliases : [];
+    return [...new Set([...strings(project.rootPaths), ...aliases.flatMap(value => {
+                const alias = record(value);
+                return [alias.alias, alias.pathAlias].filter((item) => typeof item === "string");
+            }), ...(typeof project.pathAlias === "string" ? [project.pathAlias] : [])])].filter(item => path.isAbsolute(item)).map(item => path.resolve(item));
+}
+function sidebarAssignments(state, limitations) {
+    const hosts = record(state["thread-project-membership-host-ids"]);
+    const entries = Object.entries(record(state["thread-project-assignments"]));
+    const result = {};
+    for (const [id, value] of entries) {
+        const item = record(value);
+        if (item.projectKind !== "local" || typeof item.projectId !== "string") {
+            // Keep an explicit exclusion: dropping the record would let cwd inference
+            // incorrectly reassign this thread to a local project.
+            result[id] = { projectId: typeof item.projectId === "string" ? item.projectId : "", hostId: "non-local" };
+            limitations.push("Non-local project assignments are not included in this layout projection.");
+            continue;
+        }
+        result[id] = { projectId: item.projectId, hostId: typeof hosts[id] === "string" ? hosts[id] : "local" };
+    }
+    return result;
+}
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function strings(value) { return Array.isArray(value) ? value.filter(item => typeof item === "string") : []; }
+function stringRecord(value) {
+    return Object.fromEntries(Object.entries(record(value)).filter((entry) => typeof entry[1] === "string"));
+}
+function booleanRecord(value) {
+    return Object.fromEntries(Object.entries(record(value)).filter((entry) => typeof entry[1] === "boolean"));
+}
+//# sourceMappingURL=desktop-sidebar-metadata.js.map

package/dist/src/desktop-sidebar-metadata.js.map

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

package/dist/src/desktop-sidebar-projects.d.ts

@@ -0,0 +1,10 @@
+import type { DesktopSidebarMetadata } from "./desktop-sidebar-metadata.js";
+export interface DesktopSidebarProjectCandidate {
+    hostId: string;
+    threadId: string;
+    cwd: string | null;
+}
+/** Renderer project membership uses explicit assignment, then its saved root/hint filters. */
+export declare function desktopSidebarProject(entry: DesktopSidebarProjectCandidate, layout: DesktopSidebarMetadata): string | undefined;
+/** Overlapping root ownership also depends on renderer-specific project priority. */
+export declare function desktopSidebarHasOverlappingRoots(layout: DesktopSidebarMetadata): boolean;

package/dist/src/desktop-sidebar-projects.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+/** Renderer project membership uses explicit assignment, then its saved root/hint filters. */
+export function desktopSidebarProject(entry, layout) {
+    if (entry.hostId !== "local")
+        return undefined;
+    const assigned = layout.assignments[entry.threadId];
+    if (assigned)
+        return assigned.hostId === "local" ? assigned.projectId : undefined;
+    if (layout.projectlessIds.includes(entry.threadId))
+        return undefined;
+    const hint = layout.rootHints[entry.threadId];
+    const candidates = Object.entries(layout.projects).flatMap(([id, project]) => project.roots
+        .filter(root => hint != null && path.isAbsolute(hint) && root === path.resolve(hint) || rootContains(root, entry.cwd))
+        .map(root => ({ id, root })));
+    candidates.sort((a, b) => b.root.length - a.root.length || a.id.localeCompare(b.id));
+    if (candidates.length > 1 && candidates[1].root === candidates[0].root && candidates[1].id !== candidates[0].id)
+        return undefined;
+    return candidates[0]?.id;
+}
+/** Overlapping root ownership also depends on renderer-specific project priority. */
+export function desktopSidebarHasOverlappingRoots(layout) {
+    const roots = Object.entries(layout.projects).flatMap(([id, project]) => project.roots.map(root => ({ id, root })));
+    return roots.some((entry, index) => roots.slice(index + 1).some(other => entry.id !== other.id && (rootContains(entry.root, other.root) || rootContains(other.root, entry.root))));
+}
+function rootContains(root, value) {
+    if (!value || !path.isAbsolute(value))
+        return false;
+    const relative = path.relative(root, path.resolve(value));
+    return relative === "" || relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
+}
+//# sourceMappingURL=desktop-sidebar-projects.js.map

package/dist/src/desktop-sidebar-projects.js.map

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

package/dist/src/desktop-sidebar-selection.d.ts

@@ -0,0 +1,28 @@
+import type { DesktopSidebarMetadata } from "./desktop-sidebar-metadata.js";
+import { type DesktopSidebarProjectCandidate } from "./desktop-sidebar-projects.js";
+export interface DesktopSidebarSummary {
+    status: "supported" | "partial" | "unsupported" | "unavailable";
+    mode?: string;
+    limitations: string[];
+    selectionScope: "persisted_expanded_membership";
+}
+export interface DesktopSidebarMembership {
+    section: "pinned" | "project";
+    projectId?: string;
+    projectName?: string;
+}
+interface SidebarCandidate extends DesktopSidebarProjectCandidate {
+    codexHome: string;
+    conversationId: string;
+    updatedAtMs: number;
+    threadSectionId?: string | null;
+    sectionPosition?: number;
+    sidebar?: DesktopSidebarMembership;
+}
+export declare const DESKTOP_PINNED_SECTION_ID = "01984de2-8f74-7c91-a3b2-5c5e937cf318";
+export declare function selectDesktopSidebar<T extends SidebarCandidate>(entries: T[], layouts: Map<string, DesktopSidebarMetadata>, archivedIds?: Set<string>): {
+    sessions: T[];
+    sidebar: DesktopSidebarSummary;
+    fingerprint: string;
+};
+export {};

package/dist/src/desktop-sidebar-selection.js

@@ -0,0 +1,85 @@
+import { createHash } from "node:crypto";
+import { desktopSidebarProject, desktopSidebarHasOverlappingRoots } from "./desktop-sidebar-projects.js";
+// Codex Desktop's reserved app-server Pinned section; a user section named "Pinned" is not sufficient.
+export const DESKTOP_PINNED_SECTION_ID = "01984de2-8f74-7c91-a3b2-5c5e937cf318";
+export function selectDesktopSidebar(entries, layouts, archivedIds = new Set()) {
+    const selected = new Map();
+    const summaries = [];
+    for (const [home, layout] of layouts) {
+        const localEntries = entries.filter(entry => entry.codexHome === home);
+        const summary = sidebarSummary(layout);
+        summaries.push(summary);
+        if (summary.status === "unavailable" || summary.status === "unsupported")
+            continue;
+        selectLayout(home, localEntries, layout, selected, archivedIds, summary);
+    }
+    const sidebar = combineSummaries(summaries);
+    const sessions = [...selected.values()];
+    const fingerprint = createHash("sha256").update(JSON.stringify({ layouts: [...layouts],
+        selected: sessions.map(entry => [entry.conversationId, entry.updatedAtMs, entry.sidebar]), sidebar })).digest("hex");
+    return { sessions, sidebar, fingerprint };
+}
+function sidebarSummary(layout) {
+    const limitations = [...new Set(layout.limitations)];
+    if (desktopSidebarHasOverlappingRoots(layout))
+        limitations.push("Overlapping project roots use approximate ownership; renderer project-priority ordering is not verified.");
+    if (layout.available && layout.mode !== "project")
+        limitations.push("This Desktop sidebar mode is not supported; use desktop_view=history for saved candidates.");
+    if (layout.available && layout.mode === "project" && layout.collapsed.chats !== true) {
+        limitations.push("Expanded Chats include runtime catalog and pagination state; only pinned and expanded-project membership is returned.");
+    }
+    return { status: !layout.available ? "unavailable" : layout.mode !== "project" ? "unsupported" : limitations.length ? "partial" : "supported",
+        mode: layout.mode, limitations, selectionScope: "persisted_expanded_membership" };
+}
+function selectLayout(home, entries, layout, selected, archived, summary) {
+    const byThread = new Map(entries.filter(entry => entry.hostId === "local").map(entry => [entry.threadId, entry]));
+    const add = (id, membership) => {
+        const entry = byThread.get(id);
+        if (!entry) {
+            if (!archived.has(`${home}\0local\0${id}`)) {
+                summary.status = "partial";
+                summary.limitations.push("A sidebar member has no supported local catalog metadata.");
+            }
+            return;
+        }
+        if (!selected.has(entry.conversationId))
+            selected.set(entry.conversationId, { ...entry, sidebar: membership });
+    };
+    const pinned = new Set(pinnedThreads(entries, layout));
+    if (layout.collapsed.pinned !== true) {
+        for (const id of pinned)
+            add(id, { section: "pinned" });
+    }
+    for (const projectId of layout.collapsed.threads === true ? [] : orderedProjects(layout)) {
+        if (layout.expanded[projectId] === false)
+            continue;
+        const members = entries.filter(entry => !pinned.has(entry.threadId) && !entry.threadSectionId && !layout.customSectionThreadIds.includes(entry.threadId) &&
+            desktopSidebarProject(entry, layout) === projectId);
+        for (const entry of members)
+            add(entry.threadId, { section: "project", projectId, projectName: layout.projects[projectId]?.name });
+        for (const [id, assignment] of Object.entries(layout.assignments)) {
+            if (assignment.projectId === projectId && assignment.hostId === "local" && !byThread.has(id))
+                add(id, { section: "project", projectId });
+        }
+    }
+    summary.limitations = [...new Set(summary.limitations)];
+}
+function pinnedThreads(entries, layout) {
+    const native = entries.filter(entry => entry.hostId === "local" && entry.threadSectionId === DESKTOP_PINNED_SECTION_ID)
+        .sort((a, b) => (a.sectionPosition ?? 0) - (b.sectionPosition ?? 0)).map(entry => entry.threadId);
+    const migrated = new Set(layout.migratedPinnedIds);
+    const retained = new Set([...native, ...layout.pinnedIds.filter(id => !migrated.has(id))]);
+    return [...new Set([...layout.nativePinnedOrder.filter(id => retained.has(id)), ...retained])];
+}
+function orderedProjects(layout) {
+    return [...new Set([...layout.projectOrder.filter(id => Object.hasOwn(layout.projects, id)), ...Object.keys(layout.projects)])];
+}
+function combineSummaries(items) {
+    const usable = items.filter(item => item.status === "supported" || item.status === "partial");
+    const status = items.length > 0 && items.every(item => item.status === "supported") ? "supported"
+        : usable.length ? "partial" : items.some(item => item.status === "unsupported") ? "unsupported" : "unavailable";
+    const modes = [...new Set(items.map(item => item.mode).filter(Boolean))];
+    return { status, mode: modes.length === 1 ? modes[0] : undefined,
+        limitations: [...new Set(items.flatMap(item => item.limitations))], selectionScope: "persisted_expanded_membership" };
+}
+//# sourceMappingURL=desktop-sidebar-selection.js.map

package/dist/src/desktop-sidebar-selection.js.map

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

package/dist/src/desktop-snapshot-details.d.ts

@@ -0,0 +1,4 @@
+import { type DesktopCollaborationMode, type DesktopTurnItem, type DesktopSnapshot } from "./desktop-types.js";
+export declare function desktopCollaborationMode(value: unknown): DesktopCollaborationMode;
+export declare function desktopSettingsSnapshot(raw: Record<string, unknown>): Pick<DesktopSnapshot, "threadSettings" | "currentPermissions" | "latestModel" | "latestReasoningEffort" | "latestCollaborationMode">;
+export declare function projectDesktopItemDetails(raw: Record<string, unknown>, result: DesktopTurnItem): void;

package/dist/src/desktop-snapshot-details.js

@@ -0,0 +1,116 @@
+import { DesktopIpcError } from "./desktop-types.js";
+import { desktopObject, desktopNativeRequestId } from "./desktop-request-interactions.js";
+function invalid() { throw new DesktopIpcError("invalid_response", "Invalid Desktop native detail"); }
+function optionalString(value) {
+    if (value == null)
+        return undefined;
+    if (typeof value !== "string")
+        invalid();
+    return value;
+}
+function object(value) { if (!desktopObject(value))
+    invalid(); return value; }
+export function desktopCollaborationMode(value) {
+    const mode = object(value), settings = object(mode.settings);
+    if (typeof mode.mode !== "string" || typeof settings.model !== "string")
+        invalid();
+    return { mode: mode.mode, settings: { model: settings.model,
+            reasoning_effort: optionalString(settings.reasoning_effort) ?? null,
+            developer_instructions: optionalString(settings.developer_instructions) ?? null } };
+}
+function permissions(value) {
+    const raw = object(value), result = {};
+    if (raw.activePermissionProfile != null) {
+        const profile = object(raw.activePermissionProfile);
+        if (typeof profile.id !== "string")
+            invalid();
+        result.activePermissionProfile = { id: profile.id, extends: optionalString(profile.extends) ?? null };
+    }
+    else if (raw.activePermissionProfile === null)
+        result.activePermissionProfile = null;
+    if (raw.approvalPolicy != null)
+        result.approvalPolicy = typeof raw.approvalPolicy === "string" ? raw.approvalPolicy : structuredClone(object(raw.approvalPolicy));
+    if (raw.approvalsReviewer != null)
+        result.approvalsReviewer = optionalString(raw.approvalsReviewer);
+    if (raw.sandboxPolicy != null)
+        result.sandboxPolicy = structuredClone(object(raw.sandboxPolicy));
+    if (raw.runtimeWorkspaceRoots != null) {
+        if (!Array.isArray(raw.runtimeWorkspaceRoots) || raw.runtimeWorkspaceRoots.some(root => typeof root !== "string"))
+            invalid();
+        result.runtimeWorkspaceRoots = [...raw.runtimeWorkspaceRoots];
+    }
+    return result;
+}
+function threadSettings(value) {
+    const raw = object(value), result = permissions(raw);
+    for (const field of ["model", "permissions"])
+        if (raw[field] != null)
+            result[field] = optionalString(raw[field]);
+    if (raw.effort !== undefined)
+        result.effort = optionalString(raw.effort) ?? null;
+    if (raw.collaborationMode != null)
+        result.collaborationMode = desktopCollaborationMode(raw.collaborationMode);
+    return result;
+}
+export function desktopSettingsSnapshot(raw) {
+    return {
+        ...(raw.latestThreadSettings == null ? {} : { threadSettings: threadSettings(raw.latestThreadSettings) }),
+        ...(raw.currentPermissions == null ? {} : { currentPermissions: permissions(raw.currentPermissions) }),
+        ...(raw.latestModel == null ? {} : { latestModel: optionalString(raw.latestModel) }),
+        ...(raw.latestReasoningEffort === undefined ? {} : { latestReasoningEffort: optionalString(raw.latestReasoningEffort) ?? null }),
+        ...(raw.latestCollaborationMode == null ? {} : { latestCollaborationMode: desktopCollaborationMode(raw.latestCollaborationMode) })
+    };
+}
+function fileChanges(value) {
+    if (!Array.isArray(value))
+        invalid();
+    return value.map(raw => {
+        const change = object(raw);
+        if (typeof change.path !== "string")
+            invalid();
+        const kind = typeof change.kind === "string" ? change.kind : change.kind == null ? undefined : optionalString(object(change.kind).type);
+        const diff = optionalString(change.diff);
+        return { path: change.path, ...(kind ? { kind } : {}), ...(diff === undefined ? {} : {
+                diff: diff.slice(0, 16_384), ...(diff.length > 16_384 ? { diffTruncated: true } : {})
+            }) };
+    });
+}
+function inputResponse(value, result) {
+    if (value.requestId !== undefined)
+        result.requestId = desktopNativeRequestId(value.requestId);
+    if (value.turnId !== undefined)
+        result.turnId = optionalString(value.turnId);
+    if (value.completed !== undefined) {
+        if (typeof value.completed !== "boolean")
+            invalid();
+        result.completed = value.completed;
+    }
+    if (value.answers !== undefined) {
+        const answers = object(value.answers), projected = Object.create(null);
+        for (const [id, answer] of Object.entries(answers)) {
+            if (!Array.isArray(answer) || answer.some(value => typeof value !== "string"))
+                invalid();
+            projected[id] = [...answer];
+        }
+        result.answers = projected;
+    }
+}
+export function projectDesktopItemDetails(raw, result) {
+    if (result.type === "userInputResponse")
+        inputResponse(raw, result);
+    if (result.type === "fileChange" && raw.changes != null)
+        result.changes = fileChanges(raw.changes);
+    if (result.type !== "commandExecution")
+        return;
+    for (const field of ["command", "cwd"])
+        if (raw[field] != null)
+            result[field] = optionalString(raw[field]);
+    if (raw.aggregatedOutput !== undefined)
+        result.aggregatedOutput = optionalString(raw.aggregatedOutput) ?? null;
+    if (raw.exitCode !== undefined) {
+        if (raw.exitCode !== null && (typeof raw.exitCode !== "number" || !Number.isSafeInteger(raw.exitCode)))
+            invalid();
+        result.exitCode = raw.exitCode;
+    }
+}
+//# sourceMappingURL=desktop-snapshot-details.js.map