@agentdeck/bridge 1.1.0 → 1.2.0

package/README.md

@@ -17,17 +17,25 @@ npm install -g @agentdeck/bridge
 ## Usage
 
 ```bash
-agentdeck claude          # run Claude Code inside an AgentDeck session bridge
-agentdeck codex           # same for Codex
-agentdeck opencode        # same for OpenCode
-agentdeck monitor         # terminal dashboard
-agentdeck daemon start    # start the daemon hub (port 9120)
+agentdeck daemon install  # install hooks and start the daemon on login
+claude                    # or: codex / opencode
+agentdeck dashboard       # terminal dashboard
+agentdeck daemon start    # start the daemon hub manually (port 9120)
 agentdeck devices         # list connected display devices
 agentdeck qr              # pairing QR for the iOS/Android companion apps
 agentdeck --help          # full command reference
 ```
 
-The daemon is the hub every dashboard client talks to; session bridges wrap your agent CLI in a PTY, report state via lifecycle hooks, and let paired devices steer the session (answer prompts, approve tools, switch modes).
+The daemon is the hub every dashboard client talks to. Normal agent commands
+report through lifecycle hooks or native event channels and can be steered where
+the observed session exposes a real delivery path.
+
+The legacy `agentdeck claude|codex|opencode|monitor` per-session bridges remain
+functional compatibility paths with no removal date. Prefer daemon-first for
+ordinary local sessions, but keep managed-only workflows working while
+[Discussion #278](https://github.com/puritysb/AgentDeck/discussions/278) and
+[#273](https://github.com/puritysb/AgentDeck/issues/273) define and validate
+replacements.
 
 Full CLI reference: https://github.com/puritysb/AgentDeck/blob/master/docs/cli.md
 

package/assets/fonts/NOTICE-PocketSansWorld.md

@@ -0,0 +1,10 @@
+# PocketSansWorld font pack notice
+
+PocketSansWorld is an SD-paged binary font bundle generated for Pocket Daily.
+It combines glyphs from Noto Sans KR, Noto Sans JP, Noto Sans SC, Noto Sans
+Hebrew, and Noto Sans. The original fonts and this redistributed derivative
+are licensed under the SIL Open Font License 1.1. See
+`OFL-PocketSansWorld.txt`.
+
+The provider validates the immutable pack size, MD5, SHA-256, cpfont format,
+source ledger, and licence before advertising it.

package/assets/fonts/OFL-PocketSansWorld.txt

@@ -0,0 +1,93 @@
+Copyright 2014-2021 Adobe (http://www.adobe.com/), with Reserved Font Name 'Source'
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/fonts/pocket-sans-world.manifest.json

@@ -0,0 +1,49 @@
+{
+  "fontPack": {
+    "id": "pocket-sans-world",
+    "version": 1,
+    "format": 4,
+    "size": 10903872,
+    "md5": "a6844503c142be1a62e4bac8be7c7802",
+    "sha256": "a1a15a6e9cdccd114cbaf34adb29fce08ad67d3dcd52b7970a77ab89db9ee753",
+    "licenseSpdx": "OFL-1.1"
+  },
+  "attribution": "PocketSansWorld is built from Noto Sans KR, JP, SC, Hebrew, and Noto Sans under the SIL Open Font License 1.1.",
+  "sources": [
+    {
+      "name": "Noto Sans KR",
+      "url": "https://github.com/google/fonts/tree/ec626514f79f831f1ab848a82114a0ce7e2d6372/ofl/notosanskr",
+      "revision": "ec626514f79f831f1ab848a82114a0ce7e2d6372",
+      "licenseSpdx": "OFL-1.1",
+      "attribution": "Noto Sans KR contributors"
+    },
+    {
+      "name": "Noto Sans SC",
+      "url": "https://github.com/google/fonts/tree/ec626514f79f831f1ab848a82114a0ce7e2d6372/ofl/notosanssc",
+      "revision": "ec626514f79f831f1ab848a82114a0ce7e2d6372",
+      "licenseSpdx": "OFL-1.1",
+      "attribution": "Noto Sans SC contributors"
+    },
+    {
+      "name": "Noto Sans JP",
+      "url": "https://github.com/google/fonts/tree/295d98a7a0c17c68f1341eaeea354e7960ea70d3/ofl/notosansjp",
+      "revision": "295d98a7a0c17c68f1341eaeea354e7960ea70d3",
+      "licenseSpdx": "OFL-1.1",
+      "attribution": "Noto Sans JP contributors"
+    },
+    {
+      "name": "Noto Sans",
+      "url": "https://github.com/notofonts/latin-greek-cyrillic",
+      "revision": "crosspoint-bundled-source",
+      "licenseSpdx": "OFL-1.1",
+      "attribution": "Noto Sans contributors"
+    },
+    {
+      "name": "Noto Sans Hebrew",
+      "url": "https://github.com/crosspoint-reader/crosspoint-reader/tree/94c0ba466cbb225a07f653d1c27f2a7261f1fb08/lib/EpdFont/builtinFonts/source/NotoSansHebrew",
+      "revision": "94c0ba466cbb225a07f653d1c27f2a7261f1fb08",
+      "licenseSpdx": "OFL-1.1",
+      "attribution": "The Noto Project Authors"
+    }
+  ]
+}

package/assets/learning/LICENSE-CC-BY-SA-4.0.txt

@@ -0,0 +1,10 @@
+Pocket Daily Japanese learning content
+Copyright (c) 2026 Pocket Daily contributors
+
+This learning content is licensed under the Creative Commons
+Attribution-ShareAlike 4.0 International License.
+
+License text and terms:
+https://creativecommons.org/licenses/by-sa/4.0/legalcode
+
+Attribution: Original Korean study content by Pocket Daily contributors.

package/assets/learning/NOTICE.md

@@ -0,0 +1,33 @@
+# Pocket Daily learning data — source and modification notice
+
+The `jp-n3-ko` dataset is an adapted subset of **OpenJLPT**, pinned at commit
+`c42fd9fa3777bfc1775446f7c418d549dfd6e4cf`. OpenJLPT distributes its dataset
+under **CC BY-SA 4.0** and records the following upstream sources:
+
+- **JMdict / EDICT and KANJIDIC2**, Electronic Dictionary Research and
+  Development Group (EDRDG): vocabulary and kanji readings and English
+  glosses; CC BY-SA 4.0. <https://www.edrdg.org/>
+- **Jonathan Waller's JLPT Resources**: unofficial N5–N1 level assignments;
+  CC BY according to the pinned OpenJLPT notice.
+  <https://www.tanos.co.uk/jlpt/>
+- **Tatoeba**: Japanese example sentences; CC BY 2.0 FR.
+  <https://tatoeba.org/>
+
+OpenJLPT and its full notice are available at
+<https://github.com/evanclan/OpenJLPT/tree/c42fd9fa3777bfc1775446f7c418d549dfd6e4cf>.
+
+Pocket Daily modifications are distributed under **CC BY-SA 4.0**:
+
+- retained the cumulative N5, N4, and N3 kanji subset (612 unique characters);
+- selected one compact representative word and Japanese example per character;
+- added Korean kanji glosses, word meanings, and example translations;
+- normalized the data into the fixed-record PDLP format for bounded SD reads.
+
+The Korean adaptations are by Pocket Daily contributors. Automated assistance
+was used to draft translations; field alignment, required Korean text, record
+counts, byte bounds, source pinning, and package checksums are validated before
+distribution. Corrections remain welcome and must be shared under CC BY-SA 4.0.
+
+The JLPT organization does not publish an official current vocabulary or kanji
+list. The level labels are therefore **unofficial N3-oriented study curation**,
+not a claim about the undisclosed contents of a particular examination.

package/assets/learning/jp-n3-ko.manifest.json

@@ -0,0 +1,27 @@
+{
+  "learningPack": {
+    "id": "jp-n3-ko",
+    "version": 3,
+    "format": 1,
+    "size": 568324,
+    "md5": "34681b78b5a1d65bc787dc57e863cba7",
+    "licenseSpdx": "CC-BY-SA-4.0"
+  },
+  "attribution": "OpenJLPT/EDRDG/Waller/Tatoeba 기반; Pocket Daily 한국어 각색; CC BY-SA 4.0",
+  "sources": [
+    {
+      "name": "OpenJLPT cumulative N5-N3 dataset",
+      "url": "https://github.com/evanclan/OpenJLPT",
+      "revision": "c42fd9fa3777bfc1775446f7c418d549dfd6e4cf",
+      "licenseSpdx": "CC-BY-SA-4.0",
+      "attribution": "OpenJLPT; upstream EDRDG KANJIDIC2/JMdict, Jonathan Waller JLPT resources, and Tatoeba"
+    },
+    {
+      "name": "Pocket Daily Korean adaptations",
+      "url": "https://github.com/puritysb/pocket-daily-reader",
+      "revision": "pocket-ko-2026-08-29",
+      "licenseSpdx": "CC-BY-SA-4.0",
+      "attribution": "Korean meanings and translations by Pocket Daily contributors"
+    }
+  ]
+}

package/dist/agent-cli-diagnostics.d.ts

@@ -0,0 +1,20 @@
+export type DiagnosedAgent = 'claude' | 'codex' | 'opencode';
+export interface AgentCliDiagnosticEntry {
+    id: DiagnosedAgent;
+    label: string;
+    installed: boolean;
+    version: string | null;
+    compatibleRange: string | null;
+    compatible: boolean | null;
+    installHint?: string;
+}
+export interface AgentCliDiagnosticReport {
+    kind: 'agent-cli-compatibility';
+    migration: string;
+    trackingIssue: string;
+    agents: AgentCliDiagnosticEntry[];
+}
+export type VersionCommandRunner = (command: string) => string;
+export declare function collectAgentCliDiagnosticReport(run?: VersionCommandRunner): AgentCliDiagnosticReport;
+export declare function formatAgentCliDiagnosticReport(report: AgentCliDiagnosticReport): string;
+//# sourceMappingURL=agent-cli-diagnostics.d.ts.map

package/dist/agent-cli-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cli-diagnostics.d.ts","sourceRoot":"","sources":["../src/agent-cli-diagnostics.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAiC7D,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,yBAAyB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AAW/D,wBAAgB,+BAA+B,CAC7C,GAAG,GAAE,oBAAwC,GAC5C,wBAAwB,CAiC1B;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAyBvF"}

package/dist/agent-cli-diagnostics.js

@@ -0,0 +1,100 @@
+import { execSync } from 'child_process';
+import { createRequire } from 'module';
+import { satisfiesRange } from './version-check.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+const AGENTS = [
+    {
+        id: 'claude',
+        label: 'Claude Code',
+        versionCommand: 'claude --version',
+        compatibleRange: packageJson.compatibleClaudeCode,
+        installHint: 'npm install -g @anthropic-ai/claude-code',
+    },
+    {
+        id: 'codex',
+        label: 'Codex CLI',
+        versionCommand: 'codex --version',
+        compatibleRange: packageJson.compatibleCodex,
+        installHint: 'npm install -g @openai/codex',
+    },
+    {
+        id: 'opencode',
+        label: 'OpenCode',
+        versionCommand: 'opencode --version',
+        installHint: 'brew install sst/tap/opencode  (or: npm i -g opencode-ai)',
+    },
+];
+function runVersionCommand(command) {
+    // Use the caller's PATH. A non-interactive login shell may skip interactive
+    // startup files and reorder PATH, causing diagnostics to inspect a stale
+    // installation instead of the executable `agentdeck` was launched beside.
+    return execSync(command, {
+        encoding: 'utf8', timeout: 5000, windowsHide: true,
+    }).trim();
+}
+export function collectAgentCliDiagnosticReport(run = runVersionCommand) {
+    return {
+        kind: 'agent-cli-compatibility',
+        migration: 'Run `agentdeck daemon install`, then start the agent normally.',
+        trackingIssue: 'https://github.com/puritysb/AgentDeck/issues/273',
+        agents: AGENTS.map((agent) => {
+            const compatibleRange = agent.compatibleRange?.trim() || null;
+            try {
+                const output = run(agent.versionCommand);
+                const version = output.match(/\b(\d+\.\d+\.\d+)\b/)?.[1] ?? null;
+                return {
+                    id: agent.id,
+                    label: agent.label,
+                    installed: true,
+                    version,
+                    compatibleRange,
+                    compatible: version && compatibleRange
+                        ? satisfiesRange(version, compatibleRange)
+                        : null,
+                };
+            }
+            catch {
+                return {
+                    id: agent.id,
+                    label: agent.label,
+                    installed: false,
+                    version: null,
+                    compatibleRange,
+                    compatible: null,
+                    installHint: agent.installHint,
+                };
+            }
+        }),
+    };
+}
+export function formatAgentCliDiagnosticReport(report) {
+    const lines = [
+        'Agent CLI compatibility (daemon-first)',
+        '',
+        report.migration,
+        '',
+    ];
+    for (const agent of report.agents) {
+        if (!agent.installed) {
+            lines.push(`- ${agent.label}: not found — install: ${agent.installHint}`);
+            continue;
+        }
+        const version = agent.version ?? 'version unknown';
+        if (!agent.compatibleRange) {
+            lines.push(`- ${agent.label}: ${version} — installed (no pinned compatibility range)`);
+        }
+        else if (agent.compatible === true) {
+            lines.push(`- ${agent.label}: ${version} — compatible (${agent.compatibleRange})`);
+        }
+        else if (agent.compatible === false) {
+            lines.push(`- ${agent.label}: ${version} — OUTSIDE supported range ${agent.compatibleRange}`);
+        }
+        else {
+            lines.push(`- ${agent.label}: ${version} — could not evaluate ${agent.compatibleRange}`);
+        }
+    }
+    lines.push('', `Managed-session compatibility: ${report.trackingIssue}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=agent-cli-diagnostics.js.map

package/dist/agent-cli-diagnostics.js.map

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

package/dist/apme/collector.d.ts

@@ -69,6 +69,10 @@ export type OnTaskOpened = (args: {
     projectName: string | null;
     taskIndex: number;
     startedAt: number;
+    /** Display title derived from the task's first user prompt
+     *  (`deriveTaskTitle` SSOT), or null when the prompt yields nothing
+     *  meaningful — consumers keep their `Task N` fallback on null. */
+    title: string | null;
 }) => void;
 /** Callback fired when the agent declares its todos done mid-task (the
  *  TodoWrite-all-completed soft hint). Non-segmenting — the task stays open —
@@ -92,6 +96,8 @@ export declare class ApmeCollector {
      *  client abort, or never having run at all. Injectable for tests; the
      *  default reads the Claude transcript tail once for all three. */
     private readonly openTurnProbe;
+    /** Injectable for tests only — production call sites take the default. */
+    private readonly idleGapMs;
     private readonly sessionToRun;
     private readonly sessionToAgentType;
     private readonly sessionToTurn;
@@ -121,11 +127,17 @@ export declare class ApmeCollector {
     /** Last milestone key (`taskId:turnIndex`) per session — a turn can carry
      *  several all-completed TodoWrite calls; surface only the first. */
     private readonly sessionToLastMilestone;
+    /** Per-session idle-gap timers — armed in `closeTurn`, cleared on the next
+     *  turn open / task close. See `AGENT_IDLE_GAP_MS` for the measurement the
+     *  constant rests on. */
+    private readonly sessionToIdleGapTimer;
     constructor(store: ApmeStore, hwSampler?: ApmeHwSampler | undefined, 
     /** What the transcript proves about a turn open since a timestamp — cancel,
      *  client abort, or never having run at all. Injectable for tests; the
      *  default reads the Claude transcript tail once for all three. */
-    openTurnProbe?: (transcriptPath: string, sinceMs: number) => OpenTurnEvidence | null);
+    openTurnProbe?: (transcriptPath: string, sinceMs: number) => OpenTurnEvidence | null, 
+    /** Injectable for tests only — production call sites take the default. */
+    idleGapMs?: number);
     /** Start a new run and return its id. Safe to call if store disabled (returns ''). */
     openRun(input: OpenRunInput): string;
     /** Record a hook event as a step + manage turn lifecycle.
@@ -223,6 +235,11 @@ export declare class ApmeCollector {
      *  when a task proves itself "real" (second turn, or TodoWrite plan).
      *  Mirrors ApmeCollector.swift `emitDeferredTaskStartIfNeeded`. */
     private emitDeferredTaskStartIfNeeded;
+    /** Arm the per-session idle-gap timer. Called from `closeTurn` — the turn
+     *  just finished, so the gap being measured is genuine idle time, never the
+     *  agent's own working time. Re-arming replaces any previous timer. */
+    private armIdleGapTimer;
+    private clearIdleGapTimer;
     /** Public wrapper for closeTask. Used by the manual-boundary CLI /
      *  HTTP route + the macOS detail-pane button — lets the user declare
      *  "this task is done" without `/clear` (which would also split the

package/dist/apme/collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/apme/collector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/apme/collector.ts"],"names":[],"mappings":"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"}

package/dist/apme/collector.js

@@ -18,7 +18,7 @@ import { mkdirSync, writeFileSync } from 'fs';
 import { homedir } from 'os';
 import { debug } from '../logger.js';
 import { resolveProjectName } from '../utils/project-name.js';
-import { isPricedModel, normalizeModelProvider, priceUsd } from '@agentdeck/shared';
+import { AGENT_IDLE_GAP_MS, deriveTaskTitle, isPricedModel, normalizeModelProvider, priceUsd } from '@agentdeck/shared';
 import { classifyRunSmart, computeSignals, classify } from './classifier.js';
 import { readOpenTurnEvidence } from './claude-transcript-reader.js';
 /** A turn_start with the same prompt landing on a fresh, still-empty turn
@@ -67,6 +67,7 @@ export class ApmeCollector {
     store;
     hwSampler;
     openTurnProbe;
+    idleGapMs;
     sessionToRun = new Map(); // sessionId → runId
     sessionToAgentType = new Map(); // sessionId → agentType (survives closeRun for late-attributed timeline rows)
     sessionToTurn = new Map(); // sessionId → current turn
@@ -96,14 +97,21 @@ export class ApmeCollector {
     /** Last milestone key (`taskId:turnIndex`) per session — a turn can carry
      *  several all-completed TodoWrite calls; surface only the first. */
     sessionToLastMilestone = new Map();
+    /** Per-session idle-gap timers — armed in `closeTurn`, cleared on the next
+     *  turn open / task close. See `AGENT_IDLE_GAP_MS` for the measurement the
+     *  constant rests on. */
+    sessionToIdleGapTimer = new Map();
     constructor(store, hwSampler, 
     /** What the transcript proves about a turn open since a timestamp — cancel,
      *  client abort, or never having run at all. Injectable for tests; the
      *  default reads the Claude transcript tail once for all three. */
-    openTurnProbe = readOpenTurnEvidence) {
+    openTurnProbe = readOpenTurnEvidence, 
+    /** Injectable for tests only — production call sites take the default. */
+    idleGapMs = AGENT_IDLE_GAP_MS) {
         this.store = store;
         this.hwSampler = hwSampler;
         this.openTurnProbe = openTurnProbe;
+        this.idleGapMs = idleGapMs;
     }
     /** Start a new run and return its id. Safe to call if store disabled (returns ''). */
     openRun(input) {
@@ -204,14 +212,18 @@ export class ApmeCollector {
                 prompt, hasResponse: false,
             };
             this.sessionToTurn.set(sessionId, turn);
+            // A new turn is the "still working" signal the idle-gap timer waits on.
+            this.clearIdleGapTimer(sessionId);
             // Ensure an active task exists so this turn can attach to it. Tasks group
             // consecutive turns between boundary signals (TodoWrite all-completed,
             // /clear, session_end). First turn in a run opens task 0.
             const task = this.openTaskIfNone(sessionId, runId);
             if (task) {
                 const wasFirstTurn = task.firstTurnIndex === null;
-                if (wasFirstTurn)
+                if (wasFirstTurn) {
                     task.firstTurnIndex = turnIndex;
+                    task.firstPrompt = prompt ?? null;
+                }
                 task.lastTurnIndex = turnIndex;
                 // Second (or later) turn on the same task proves it's a real,
                 // multi-turn work unit → promote the deferred TASK header so the
@@ -455,6 +467,9 @@ export class ApmeCollector {
         catch (err) {
             debug('APME', `closeTurn failed: ${String(err)}`);
         }
+        // Idle starts when the turn ends. The timer is cleared by the next turn
+        // open (still working) or by closeTask (boundary reached another way).
+        this.armIdleGapTimer(sessionId);
     }
     /** Get the current active turn ID for a session (if any). */
     getActiveTurnId(sessionId) {
@@ -519,6 +534,7 @@ export class ApmeCollector {
             startedAt: Date.now(),
             firstTurnIndex: null,
             lastTurnIndex: null,
+            firstPrompt: null,
             timelineEmitted: false,
         };
         this.sessionToTask.set(sessionId, task);
@@ -559,12 +575,40 @@ export class ApmeCollector {
                 projectName: run?.projectName ?? null,
                 taskIndex: task.index,
                 startedAt: task.startedAt,
+                title: deriveTaskTitle(task.firstPrompt),
             });
         }
         catch (err) {
             debug('APME', `onTaskOpened listener threw: ${String(err)}`);
         }
     }
+    /** Arm the per-session idle-gap timer. Called from `closeTurn` — the turn
+     *  just finished, so the gap being measured is genuine idle time, never the
+     *  agent's own working time. Re-arming replaces any previous timer. */
+    armIdleGapTimer(sessionId) {
+        this.clearIdleGapTimer(sessionId);
+        const timer = setTimeout(() => {
+            this.sessionToIdleGapTimer.delete(sessionId);
+            // A turn opened since (and its clear lost a race), or work is mid-turn:
+            // never split under an active turn.
+            if (this.sessionToTurn.has(sessionId))
+                return;
+            if (!this.sessionToTask.has(sessionId))
+                return;
+            debug('APME', `idle gap (${Math.round(this.idleGapMs / 1000)}s) → closing task for ${sessionId.slice(0, 8)}`);
+            this.closeTask(sessionId, 'idle_gap');
+        }, this.idleGapMs);
+        // Never hold the process open for an idle bookkeeping timer.
+        timer.unref?.();
+        this.sessionToIdleGapTimer.set(sessionId, timer);
+    }
+    clearIdleGapTimer(sessionId) {
+        const timer = this.sessionToIdleGapTimer.get(sessionId);
+        if (timer) {
+            clearTimeout(timer);
+            this.sessionToIdleGapTimer.delete(sessionId);
+        }
+    }
     /** Public wrapper for closeTask. Used by the manual-boundary CLI /
      *  HTTP route + the macOS detail-pane button — lets the user declare
      *  "this task is done" without `/clear` (which would also split the
@@ -597,6 +641,7 @@ export class ApmeCollector {
             return;
         this.sessionToTask.delete(sessionId);
         this.sessionToLastMilestone.delete(sessionId);
+        this.clearIdleGapTimer(sessionId);
         // Empty task: no turns ever attached. Drop the row so the dashboard
         // doesn't show phantom entries from back-to-back boundary signals.
         if (task.firstTurnIndex === null) {