tmux-ide 2.6.1 → 2.8.0

package/packages/daemon/dist/lib/update-check.js

@@ -223,6 +223,11 @@ export async function runUpdateCheck({ now = Date.now() } = {}) {
     const cache = readUpdateCache();
     if (!shouldCheck(cache?.lastCheckedAt ?? null, now))
         return;
+    // The agent-detection manifest-pack refresh RIDES this same daily throttle
+    // (M25.4) — no timer of its own, gated again inside on `updates.manifests`
+    // (default false) and never throwing. Dynamic import: manifest-pack imports
+    // this module for getCurrentVersion, so a static import would be a cycle.
+    void import("./manifest-pack.js").then((m) => m.maybeRefreshManifestPack()).catch(() => { });
     const fetched = await fetchLatestVersion();
     writeUpdateCache({
         lastCheckedAt: now,

package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/Info.plist

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleDevelopmentRegion</key>
+  <string>en</string>
+  <key>CFBundleDisplayName</key>
+  <string>tmux-ide</string>
+  <key>CFBundleExecutable</key>
+  <string>tmux-ide-notifier</string>
+  <key>CFBundleIconFile</key>
+  <string>AppIcon</string>
+  <key>CFBundleIconName</key>
+  <string>AppIcon</string>
+  <key>CFBundleIdentifier</key>
+  <string>com.wavyrai.tmuxide.notifier</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>CFBundleName</key>
+  <string>tmux-ide</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>CFBundleShortVersionString</key>
+  <string>2.8.0</string>
+  <key>CFBundleVersion</key>
+  <string>2.8.0</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>11.0</string>
+  <key>LSUIElement</key>
+  <true/>
+  <key>NSPrincipalClass</key>
+  <string>NSApplication</string>
+</dict>
+</plist>

package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/PkgInfo

@@ -0,0 +1 @@
+APPL????

package/packages/daemon/dist/native/TmuxIdeNotifier.app/Contents/_CodeSignature/CodeResources

@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>files</key>
+	<dict>
+		<key>Resources/AppIcon.icns</key>
+		<data>
+		X3UpT06Bz44e6JibpJhhiMxRfno=
+		</data>
+		<key>Resources/Assets.car</key>
+		<data>
+		I3z+NDxWadVSrUS0xGMi1yZxHfA=
+		</data>
+	</dict>
+	<key>files2</key>
+	<dict>
+		<key>Resources/AppIcon.icns</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			tkz+Ee3lkawLrys701JjQo2Z+YlNtbudhtH13NTsrQw=
+			</data>
+		</dict>
+		<key>Resources/Assets.car</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			vuVGO00nkAAaL21f21SA22M7NZ311c+KH7/lizezdck=
+			</data>
+		</dict>
+	</dict>
+	<key>rules</key>
+	<dict>
+		<key>^Resources/</key>
+		<true/>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^version.plist$</key>
+		<true/>
+	</dict>
+	<key>rules2</key>
+	<dict>
+		<key>.*\.dSYM($|/)</key>
+		<dict>
+			<key>weight</key>
+			<real>11</real>
+		</dict>
+		<key>^(.*/)?\.DS_Store$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>2000</real>
+		</dict>
+		<key>^(Frameworks|SharedFrameworks|PlugIns|Plug-ins|XPCServices|Helpers|MacOS|Library/(Automator|Spotlight|LoginItems))/</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^.*</key>
+		<true/>
+		<key>^Info\.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^PkgInfo$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^[^/]+$</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^embedded\.provisionprofile$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^version\.plist$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/packages/daemon/dist/restore.d.ts

@@ -32,19 +32,46 @@ export interface RestorePlan {
  * config; failing that, we raw-rebuild from the recorded windows/panes.
  */
 export declare function buildRestorePlan(snapshot: FleetSnapshot, liveSessionNames: Iterable<string>, ideProjects?: Map<string, string>): RestorePlan;
+/**
+ * The native session-resume invocation per agent kind (M24.1 — the table was
+ * claude-only until then). ONLY VERIFIED entries ship; each spelling's source:
+ *  - `claude --resume <id>`: the shipped integration (its hooks record the id).
+ *  - `codex resume <id>`: `codex resume --help` — "Usage: codex resume
+ *    [OPTIONS] [SESSION_ID]  … Session id (UUID) or session name".
+ *  - `opencode --session <id>`: `opencode --help` — "-s, --session  session id
+ *    to continue".
+ *  - `cursor-agent --resume <id>`: `cursor-agent --help` — "--resume [chatId]
+ *    Select a session to resume".
+ *  - `copilot --resume=<id>`: GitHub Copilot CLI command reference —
+ *    "--resume[=VALUE]  Resume a previous interactive session … Optionally
+ *    specify a session ID" (the `=` form, since the value is optional).
+ * Unverified (no entry): gemini, aider, goose, amp — no confirmed native
+ * per-session resume invocation at the time of writing.
+ *
+ * How `@agent_session_id` gets recorded per kind (M25.3):
+ *  - claude — the hooks integration (`integration install claude`).
+ *  - opencode — the plugin integration (`integration install opencode`).
+ *  - codex, cursor — automatic: the chrome updater probes the agent's own
+ *    on-disk session state ({@link ./tui/detect/session-id.ts}).
+ *  - copilot — no automatic capture (skipped with evidence — see the
+ *    session-id module header); fires only for panes whose agent self-reported
+ *    the id per the agent contract
+ *    (`tmux set-option -p @agent_session_id <id>`), which any kind may do.
+ */
+export declare const AGENT_RESUME_COMMANDS: Record<string, (id: string) => string>;
 /**
  * PURE — the command to relaunch a pane so its agent conversation is revived,
  * or `null` for "no resume — leave it a plain shell (or replay `command`)".
  *
  * Decision table (only fires when `resumeAgents` is on):
- *  - claude + a recorded `@agent_session_id` → `claude --resume <id>`. The id is
- *    a uuid, but we don't trust the snapshot: unless it matches
- *    {@link SAFE_SESSION_ID} (`[A-Za-z0-9-]`) we bail to `null` rather than risk
- *    feeding shell metacharacters into send-keys.
- *  - claude with NO session id → `null`. `claude --continue` would be too
- *    magical here (it resumes the most-recent conversation in the cwd, which may
- *    belong to a different pane); a fresh shell is the safe, predictable default.
- *  - any other agent → `null`. No native resume story yet.
+ *  - a kind in {@link AGENT_RESUME_COMMANDS} + a recorded `@agent_session_id` →
+ *    that kind's resume invocation. The id is uuid-ish, but we don't trust the
+ *    snapshot: unless it matches {@link SAFE_SESSION_ID} we bail to `null`
+ *    rather than risk feeding shell metacharacters into send-keys.
+ *  - a known kind with NO session id → `null`. A "continue most recent" flag
+ *    would be too magical here (it resumes the cwd's most-recent conversation,
+ *    which may belong to a different pane); a fresh shell is the safe default.
+ *  - any other agent → `null`. No VERIFIED resume story.
  *  - `resumeAgents` off → always `null`.
  */
 export declare function paneResumeCommand(pane: PaneSnapshot, opts: {

package/packages/daemon/dist/restore.js

@@ -13,9 +13,11 @@
  *
  * `--resume-agents` (or `{ "restore": { "resumeAgents": true } }` in
  * `~/.tmux-ide/config.json`) layers native agent-resume on top: a rebuilt
- * claude pane that carries a recorded `@agent_session_id` relaunches as
- * `claude --resume <id>`, reviving the actual conversation rather than opening
- * a fresh shell. See {@link paneResumeCommand} for the exact decision table.
+ * agent pane that carries a recorded `@agent_session_id` relaunches with its
+ * kind's VERIFIED resume invocation (`claude --resume <id>`, `codex resume
+ * <id>`, … — {@link AGENT_RESUME_COMMANDS}), reviving the actual conversation
+ * rather than opening a fresh shell. See {@link paneResumeCommand} for the
+ * exact decision table.
  *
  * {@link buildRestorePlan} + {@link paneResumeCommand} + {@link restorePrefs}
  * are PURE (unit-tested); {@link restore} is the thin io wrapper that reads the
@@ -58,32 +60,67 @@ export function buildRestorePlan(snapshot, liveSessionNames, ideProjects = new M
 // ---------------------------------------------------------------------------
 // Pure — agent resume decision
 // ---------------------------------------------------------------------------
-/** A session id is trusted only if it's the uuid alphabet — nothing shell-active. */
-const SAFE_SESSION_ID = /^[A-Za-z0-9-]+$/;
+/** A session id is trusted only if it's uuid-ish (`[A-Za-z0-9_-]` — underscore
+ *  covers opencode's `ses_…` ids) — nothing shell-active. */
+const SAFE_SESSION_ID = /^[A-Za-z0-9_-]+$/;
+/**
+ * The native session-resume invocation per agent kind (M24.1 — the table was
+ * claude-only until then). ONLY VERIFIED entries ship; each spelling's source:
+ *  - `claude --resume <id>`: the shipped integration (its hooks record the id).
+ *  - `codex resume <id>`: `codex resume --help` — "Usage: codex resume
+ *    [OPTIONS] [SESSION_ID]  … Session id (UUID) or session name".
+ *  - `opencode --session <id>`: `opencode --help` — "-s, --session  session id
+ *    to continue".
+ *  - `cursor-agent --resume <id>`: `cursor-agent --help` — "--resume [chatId]
+ *    Select a session to resume".
+ *  - `copilot --resume=<id>`: GitHub Copilot CLI command reference —
+ *    "--resume[=VALUE]  Resume a previous interactive session … Optionally
+ *    specify a session ID" (the `=` form, since the value is optional).
+ * Unverified (no entry): gemini, aider, goose, amp — no confirmed native
+ * per-session resume invocation at the time of writing.
+ *
+ * How `@agent_session_id` gets recorded per kind (M25.3):
+ *  - claude — the hooks integration (`integration install claude`).
+ *  - opencode — the plugin integration (`integration install opencode`).
+ *  - codex, cursor — automatic: the chrome updater probes the agent's own
+ *    on-disk session state ({@link ./tui/detect/session-id.ts}).
+ *  - copilot — no automatic capture (skipped with evidence — see the
+ *    session-id module header); fires only for panes whose agent self-reported
+ *    the id per the agent contract
+ *    (`tmux set-option -p @agent_session_id <id>`), which any kind may do.
+ */
+export const AGENT_RESUME_COMMANDS = {
+    claude: (id) => `claude --resume ${id}`,
+    codex: (id) => `codex resume ${id}`,
+    opencode: (id) => `opencode --session ${id}`,
+    cursor: (id) => `cursor-agent --resume ${id}`,
+    copilot: (id) => `copilot --resume=${id}`,
+};
 /**
  * PURE — the command to relaunch a pane so its agent conversation is revived,
  * or `null` for "no resume — leave it a plain shell (or replay `command`)".
  *
  * Decision table (only fires when `resumeAgents` is on):
- *  - claude + a recorded `@agent_session_id` → `claude --resume <id>`. The id is
- *    a uuid, but we don't trust the snapshot: unless it matches
- *    {@link SAFE_SESSION_ID} (`[A-Za-z0-9-]`) we bail to `null` rather than risk
- *    feeding shell metacharacters into send-keys.
- *  - claude with NO session id → `null`. `claude --continue` would be too
- *    magical here (it resumes the most-recent conversation in the cwd, which may
- *    belong to a different pane); a fresh shell is the safe, predictable default.
- *  - any other agent → `null`. No native resume story yet.
+ *  - a kind in {@link AGENT_RESUME_COMMANDS} + a recorded `@agent_session_id` →
+ *    that kind's resume invocation. The id is uuid-ish, but we don't trust the
+ *    snapshot: unless it matches {@link SAFE_SESSION_ID} we bail to `null`
+ *    rather than risk feeding shell metacharacters into send-keys.
+ *  - a known kind with NO session id → `null`. A "continue most recent" flag
+ *    would be too magical here (it resumes the cwd's most-recent conversation,
+ *    which may belong to a different pane); a fresh shell is the safe default.
+ *  - any other agent → `null`. No VERIFIED resume story.
  *  - `resumeAgents` off → always `null`.
  */
 export function paneResumeCommand(pane, opts) {
     if (!opts.resumeAgents)
         return null;
-    if (pane.agent !== "claude")
+    const resume = pane.agent ? AGENT_RESUME_COMMANDS[pane.agent] : undefined;
+    if (!resume)
         return null;
     const id = pane.agentSessionId;
     if (!id || !SAFE_SESSION_ID.test(id))
         return null;
-    return `claude --resume ${id}`;
+    return resume(id);
 }
 /** PURE — how many of a session's panes would resume under `resumeAgents`. */
 export function countResumableAgents(session, resumeAgents) {

package/packages/daemon/dist/send.d.ts

@@ -1,4 +1,4 @@
-import { type PaneInfo } from "./widgets/lib/pane-comms.ts";
+import { type PaneInfo, type PaneBusyStatus } from "./widgets/lib/pane-comms.ts";
 export declare const LONG_MESSAGE_THRESHOLD = 150;
 /**
  * Write a long message to a dispatch file and return the short trigger command.
@@ -23,5 +23,37 @@ interface SendOptions {
  * 5. Case-insensitive partial title match
  */
 export declare function resolvePane(panes: PaneInfo[], target: string): PaneInfo | null;
+/** What a delivery reports back (the `send --json` payload, and the control
+ *  socket's `send` verb data). */
+export interface DeliverResult {
+    ok: true;
+    session: string;
+    target: {
+        paneId: string;
+        name: string | null;
+        title: string;
+        role: string | null;
+    };
+    message: string;
+    busyStatus: PaneBusyStatus;
+    sentViaFile: boolean;
+    warning?: "agent_busy";
+}
+/**
+ * Deliver `message` to a pane of `session` — the SHARED core behind the
+ * `tmux-ide send` CLI case and the control socket's `send` verb. Resolves
+ * `target` (pane id / @ide_name / title / role / partial title), adapts to
+ * the pane's busy status, and routes long messages through a dispatch file
+ * under `dir` when one is given (without a `dir` the text is sent directly).
+ * Throws `IdeError` (SESSION_NOT_FOUND / PANE_NOT_FOUND) — no printing here.
+ */
+export declare function deliverMessage(opts: {
+    session: string;
+    target: string;
+    message: string;
+    noEnter?: boolean;
+    /** The project dir long messages are dispatched through as a file. */
+    dir?: string;
+}): DeliverResult;
 export declare function send(targetDir: string | undefined, opts: SendOptions): Promise<void>;
 export {};

package/packages/daemon/dist/send.js

@@ -64,21 +64,16 @@ function prepareMessage(message, busyStatus) {
     }
     return message;
 }
-export async function send(targetDir, opts) {
-    const dir = resolve(targetDir ?? ".");
-    const { name: session } = getSessionName(dir);
-    const { json, to: target, message: rawMessage, noEnter } = opts;
-    if (!target) {
-        throw new IdeError("Missing target. Usage: tmux-ide send <target> <message>", {
-            code: "USAGE",
-        });
-    }
-    if (!rawMessage) {
-        throw new IdeError("Missing message. Usage: tmux-ide send <target> <message>", {
-            code: "USAGE",
-        });
-    }
-    // Verify session is running
+/**
+ * Deliver `message` to a pane of `session` — the SHARED core behind the
+ * `tmux-ide send` CLI case and the control socket's `send` verb. Resolves
+ * `target` (pane id / @ide_name / title / role / partial title), adapts to
+ * the pane's busy status, and routes long messages through a dispatch file
+ * under `dir` when one is given (without a `dir` the text is sent directly).
+ * Throws `IdeError` (SESSION_NOT_FOUND / PANE_NOT_FOUND) — no printing here.
+ */
+export function deliverMessage(opts) {
+    const { session, target, noEnter, dir } = opts;
     const state = getSessionState(session);
     if (!state.running) {
         throw new IdeError(`Session "${session}" is not running`, {
@@ -99,13 +94,13 @@ export async function send(targetDir, opts) {
         });
     }
     const busyStatus = getPaneBusyStatus(session, pane.id);
-    const message = prepareMessage(rawMessage, busyStatus);
+    const message = prepareMessage(opts.message, busyStatus);
     let sentViaFile = false;
     if (noEnter) {
         sendText(session, pane.id, message);
     }
     else {
-        const dispatch = writeDispatchFile(dir, pane.id, message);
+        const dispatch = dir ? writeDispatchFile(dir, pane.id, message) : null;
         if (dispatch) {
             sendCommand(session, pane.id, dispatch.triggerCmd);
             sentViaFile = true;
@@ -114,7 +109,7 @@ export async function send(targetDir, opts) {
             sendCommand(session, pane.id, message);
         }
     }
-    const result = {
+    return {
         ok: true,
         session,
         target: {
@@ -128,13 +123,31 @@ export async function send(targetDir, opts) {
         sentViaFile,
         ...(busyStatus === "agent" ? { warning: "agent_busy" } : {}),
     };
+}
+export async function send(targetDir, opts) {
+    const dir = resolve(targetDir ?? ".");
+    const { name: session } = getSessionName(dir);
+    const { json, to: target, message: rawMessage, noEnter } = opts;
+    if (!target) {
+        throw new IdeError("Missing target. Usage: tmux-ide send <target> <message>", {
+            code: "USAGE",
+        });
+    }
+    if (!rawMessage) {
+        throw new IdeError("Missing message. Usage: tmux-ide send <target> <message>", {
+            code: "USAGE",
+        });
+    }
+    const result = deliverMessage({ session, target, message: rawMessage, noEnter, dir });
+    const { message, busyStatus } = result;
+    const pane = result.target;
     if (json) {
         console.log(JSON.stringify(result, null, 2));
         return;
     }
     const label = pane.name ?? pane.title;
     const preview = message.length > 60 ? message.slice(0, 60) + "..." : message;
-    console.log(`Sent to "${label}" (${pane.id}): ${preview}`);
+    console.log(`Sent to "${label}" (${pane.paneId}): ${preview}`);
     if (busyStatus === "agent") {
         console.log("Warning: agent appears busy. Message sent anyway.");
     }

package/packages/daemon/dist/widgets/explorer/breadcrumbs.d.ts

@@ -6,5 +6,5 @@ interface BreadcrumbsProps {
     theme: WidgetTheme;
     onNavigate: (absolutePath: string) => void;
 }
-export declare function Breadcrumbs(props: BreadcrumbsProps): any;
+export declare function Breadcrumbs(props: BreadcrumbsProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/explorer/footer.d.ts

@@ -2,5 +2,5 @@ import type { WidgetTheme } from "../lib/theme.ts";
 interface FooterProps {
     theme: WidgetTheme;
 }
-export declare function Footer(props: FooterProps): any;
+export declare function Footer(props: FooterProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/explorer/tree.d.ts

@@ -9,5 +9,5 @@ interface FileTreeProps {
     onActivate: (node: TreeNode) => void;
     onInputModeChange: (mode: "keyboard" | "mouse") => void;
 }
-export declare function FileTree(props: FileTreeProps): any;
+export declare function FileTree(props: FileTreeProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/lib/help-overlay.d.ts

@@ -16,4 +16,4 @@ export interface HelpOverlayProps {
  * the surface's own keys. Replaces the surface body while `?` is held open;
  * `esc`/`q`/`?` close it.
  */
-export declare function HelpOverlay(props: HelpOverlayProps): any;
+export declare function HelpOverlay(props: HelpOverlayProps): import("solid-js").JSX.Element;

package/packages/daemon/dist/widgets/setup/agent-naming.d.ts

@@ -5,5 +5,5 @@ interface AgentNamingProps {
     onContinue: (names: string[]) => void;
     theme: WidgetTheme;
 }
-export declare function AgentNaming(props: AgentNamingProps): any;
+export declare function AgentNaming(props: AgentNamingProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/setup/config-tree.d.ts

@@ -9,5 +9,5 @@ interface ConfigTreeProps {
     onConfigChange: (config: IdeConfig) => void;
     theme: WidgetTheme;
 }
-export declare function ConfigTree(props: ConfigTreeProps): any;
+export declare function ConfigTree(props: ConfigTreeProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/setup/detect-panel.d.ts

@@ -10,5 +10,5 @@ interface DetectPanelProps {
     onContinue: () => void;
     theme: WidgetTheme;
 }
-export declare function DetectPanel(props: DetectPanelProps): any;
+export declare function DetectPanel(props: DetectPanelProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/setup/field-editor.d.ts

@@ -9,4 +9,4 @@ export interface FieldEditorProps {
     onCancel: () => void;
     theme: WidgetTheme;
 }
-export declare function FieldEditor(props: FieldEditorProps): any;
+export declare function FieldEditor(props: FieldEditorProps): import("solid-js").JSX.Element;

package/packages/daemon/dist/widgets/setup/footer.d.ts

@@ -13,5 +13,5 @@ interface FooterProps {
     theme: WidgetTheme;
     actions?: FooterActions;
 }
-export declare function Footer(props: FooterProps): any;
+export declare function Footer(props: FooterProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/dist/widgets/setup/layout-picker.d.ts

@@ -5,5 +5,5 @@ interface LayoutPickerProps {
     onSelect: (preset: LayoutPreset) => void;
     theme: WidgetTheme;
 }
-export declare function LayoutPicker(props: LayoutPickerProps): any;
+export declare function LayoutPicker(props: LayoutPickerProps): import("solid-js").JSX.Element;
 export {};

package/packages/daemon/src/agent-explain.ts

@@ -14,7 +14,7 @@
  * the target pane.
  */
 import { execFileSync } from "node:child_process";
-import { explain, type DetectedState } from "./tui/detect/manifest.ts";
+import { explain, type DetectedState, type ManifestConfidence } from "./tui/detect/manifest.ts";
 import {
   classifyInstant,
   parseAuthority,
@@ -22,7 +22,11 @@ import {
   type InstantState,
 } from "./tui/detect/classify.ts";
 import { getManifests } from "./tui/detect/manifest-loader.ts";
-import { readProcessTable, resolveAgentCommand } from "./tui/detect/process-tree.ts";
+import {
+  describeSubtree,
+  readProcessTable,
+  resolveAgentCommand,
+} from "./tui/detect/process-tree.ts";
 import { readPaneSnapshot } from "./tui/detect/snapshot.ts";
 import { IdeError } from "./lib/errors.ts";
 
@@ -53,6 +57,13 @@ export interface ExplainReport {
     manifestId: string | null;
     matchedCommand: string;
     source: "hint" | "fast" | "tree" | "none";
+    /** The matched manifest's evidence confidence (null when nothing resolved). */
+    confidence: ManifestConfidence | null;
+    /**
+     * Executable-ish tokens seen in the pane's process subtree. Populated for
+     * the "no manifest matched" case so the report can say what it DID find.
+     */
+    subtree: string[];
   };
   states: Array<{ state: DetectedState; matched: boolean }>;
   winner: DetectedState | null;
@@ -137,6 +148,9 @@ export function buildReport(target: string): ExplainReport {
     hint: info.hintRaw,
   });
   const manifest = resolved.manifest;
+  // When nothing resolved, record what the process-tree DID see so `explain`
+  // can point the user at an `@agent_hint` target instead of a dead end.
+  const subtree = manifest ? [] : describeSubtree(table, info.pid);
 
   // Snapshot + per-state explanation.
   const snapshot = { ...readPaneSnapshot(info.id), title: info.title };
@@ -168,6 +182,8 @@ export function buildReport(target: string): ExplainReport {
       manifestId: manifest?.id ?? null,
       matchedCommand: resolved.matchedCommand,
       source: resolved.source,
+      confidence: manifest ? (manifest.confidence ?? "conservative") : null,
+      subtree,
     },
     states: explained.checked,
     winner: explained.state,
@@ -223,10 +239,22 @@ export function renderReport(r: ExplainReport, opts: { color?: boolean } = {}):
   }
 
   // Resolution
-  const mid = r.resolution.manifestId ?? dim("none");
-  out.push(
-    `  ${label("manifest")}  ${mid}  ${dim(`via ${r.resolution.source}` + (r.resolution.matchedCommand ? ` "${r.resolution.matchedCommand}"` : ""))}`,
-  );
+  if (r.resolution.manifestId) {
+    const conf =
+      r.resolution.confidence === "tuned"
+        ? c("\x1b[32m", "tuned")
+        : dim(r.resolution.confidence ?? "conservative");
+    out.push(
+      `  ${label("manifest")}  ${r.resolution.manifestId}  ${dim(`via ${r.resolution.source}` + (r.resolution.matchedCommand ? ` "${r.resolution.matchedCommand}"` : ""))}  [${conf}]`,
+    );
+  } else {
+    // No manifest matched — say so, and report what the process-tree DID see so
+    // the user can set an `@agent_hint` or add a manifest.
+    const saw =
+      r.resolution.subtree.length > 0 ? r.resolution.subtree.join(", ") : r.pane.cmd || "(nothing)";
+    out.push(`  ${label("manifest")}  ${dim("none matched")} — ${dim(`process-tree saw: ${saw}`)}`);
+    out.push(`            ${dim("set `tmux set-option -p @agent_hint <agent>` to force one")}`);
+  }
 
   // Per-state rule results
   out.push("");