aiden-runtime 4.1.2 → 4.1.4

package/dist/cli/v4/toolPreview.js

@@ -29,9 +29,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TOOL_PRIMARY_ARG = void 0;
 exports.buildToolPreview = buildToolPreview;
 /**
- * Map of tool-name → name of the property in `args` that should render
- * as the at-a-glance preview. Stable contract; tests assert specific
- * entries.
+ * Map of tool-name → preview extractor (string key OR function).
+ * Stable contract; tests assert specific entries.
  */
 exports.TOOL_PRIMARY_ARG = {
     // ── terminal / execution ─────────────────────────────────────────────
@@ -86,6 +85,51 @@ exports.TOOL_PRIMARY_ARG = {
     system_info: '',
     now_playing: '',
     get_natural_events: '',
+    // ── v4.1.4-media — three-layer media-control bundle ──────────────────
+    // `media_sessions` has no args by schema; the empty-arg preview is
+    // suppressed by buildToolPreview returning ''.
+    // `media_transport` → preview by target ("spotify"), the actionable
+    // identifier the user typed. `action` is intentionally NOT chosen —
+    // GSMTC actions (play/pause/toggle) are short, the target is the
+    // discriminator.
+    // `media_key` is layer-3 fallback; show `action` since there's no
+    // target to surface (it's a blind keystroke).
+    // `app_input` shows `app` so the user sees which window got the keys.
+    media_sessions: '',
+    media_transport: 'target',
+    media_key: 'action',
+    app_input: 'app',
+    // ── v4.1.4 Phase 3b' (Issue H) ───────────────────────────────────────
+    // app_launch needs custom logic: when `app === 'explorer.exe'` the
+    // binary is just the URI dispatcher and the meaningful target is in
+    // `args[0]` (e.g. 'spotify:track/...'). Surface the protocol scheme
+    // ('spotify') rather than the dispatch binary. Falls through to the
+    // app name for normal exe launches.
+    app_launch: (args) => {
+        if (!args || typeof args !== 'object')
+            return '';
+        const a = args;
+        const appRaw = typeof a.app === 'string' ? a.app.trim() : '';
+        // URI-protocol case: explorer.exe + 'scheme:...' in args[0].
+        if (appRaw.toLowerCase() === 'explorer.exe' && Array.isArray(a.args)) {
+            const first = a.args[0];
+            if (typeof first === 'string' && first.length > 0) {
+                // Scheme requires ≥2 chars so Windows drive letters
+                // (`C:/path`) don't mis-detect as the scheme `C`. Real URI
+                // schemes (spotify, vscode, http, file, etc.) are all
+                // multi-char by RFC.
+                const m = first.match(/^([A-Za-z][A-Za-z0-9+.-]+):/);
+                if (m)
+                    return m[1]; // 'spotify:track/...' → 'spotify'
+                return first; // No protocol — surface the raw arg
+            }
+        }
+        return appRaw;
+    },
+    // Clipboard write — the actual text being copied is the meaningful
+    // target. Reads have no args worth showing (empty schema).
+    clipboard_write: 'text',
+    clipboard_read: '',
 };
 /**
  * Maximum visible characters for the preview value. Long commands /
@@ -107,28 +151,47 @@ function buildToolPreview(toolName, args) {
     if (!Object.prototype.hasOwnProperty.call(exports.TOOL_PRIMARY_ARG, toolName)) {
         return null;
     }
-    const argKey = exports.TOOL_PRIMARY_ARG[toolName];
-    if (argKey === '')
-        return '';
-    if (!args || typeof args !== 'object')
-        return '';
-    const raw = args[argKey];
-    if (raw === undefined || raw === null)
-        return '';
+    const extractor = exports.TOOL_PRIMARY_ARG[toolName];
+    // v4.1.4 Phase 3b' (Issue H1): function extractor path. Used by
+    // tools whose preview can't be expressed as a single key lookup
+    // (e.g. app_launch with URI-protocol routing through explorer.exe).
     let str;
-    if (typeof raw === 'string') {
-        str = raw;
-    }
-    else if (typeof raw === 'number' || typeof raw === 'boolean') {
-        str = String(raw);
-    }
-    else {
+    if (typeof extractor === 'function') {
         try {
-            str = JSON.stringify(raw);
+            const out = extractor(args);
+            str = typeof out === 'string' ? out : '';
         }
         catch {
+            // Extractor threw — degrade to empty preview rather than crash
+            // the tool-row render. The tool name + state cluster still
+            // carries enough info.
+            str = '';
+        }
+    }
+    else {
+        // String-key path (legacy, unchanged behaviour).
+        const argKey = extractor;
+        if (argKey === '')
+            return '';
+        if (!args || typeof args !== 'object')
+            return '';
+        const raw = args[argKey];
+        if (raw === undefined || raw === null)
+            return '';
+        if (typeof raw === 'string') {
+            str = raw;
+        }
+        else if (typeof raw === 'number' || typeof raw === 'boolean') {
             str = String(raw);
         }
+        else {
+            try {
+                str = JSON.stringify(raw);
+            }
+            catch {
+                str = String(raw);
+            }
+        }
     }
     // Collapse whitespace so multi-line commands stay on one preview row.
     str = str.replace(/\s+/g, ' ').trim();

package/dist/core/tools/nowPlaying.js

@@ -2,27 +2,19 @@
 // core/tools/nowPlaying.ts — Live media session query via Windows WinRT
 // Uses GlobalSystemMediaTransportControlsSessionManager (works for Spotify,
 // YouTube in browser, Windows Media Player, and any SMTC-registered app).
+//
+// v4.1.4-media: the WinRT `Await` PS5.1 reflection bridge moved into the
+// shared helper `tools/v4/system/_psHelpers.ts::winRtAwaitPreamble()` so
+// the three GSMTC callers (this file + mediaSessions + mediaTransport)
+// share one canonical implementation.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNowPlaying = getNowPlaying;
 const child_process_1 = require("child_process");
 const util_1 = require("util");
+const _psHelpers_1 = require("../../tools/v4/system/_psHelpers");
 const execAsync = (0, util_1.promisify)(child_process_1.exec);
-// PowerShell uses System.WindowsRuntimeSystemExtensions.AsTask to bridge
-// WinRT IAsyncOperation<T> into a .NET Task — required because PS5.1 cannot
-// await WinRT async operations natively via .GetAwaiter().
 const PS_SCRIPT = `
-Add-Type -AssemblyName System.Runtime.WindowsRuntime
-function Await($WinRtTask, $ResultType) {
-    $m = ([System.WindowsRuntimeSystemExtensions].GetMethods() | Where-Object {
-        $_.Name -eq 'AsTask' -and
-        $_.GetParameters().Count -eq 1 -and
-        $_.GetParameters()[0].ParameterType.Name -eq 'IAsyncOperation\`1'
-    })[0]
-    $m = $m.MakeGenericMethod($ResultType)
-    $t = $m.Invoke($null, @($WinRtTask))
-    $t.Wait(-1) | Out-Null
-    $t.Result
-}
+${(0, _psHelpers_1.winRtAwaitPreamble)()}
 $mgType = [Windows.Media.Control.GlobalSystemMediaTransportControlsSessionManager,Windows.Media.Control,ContentType=WindowsRuntime]
 $mgr = Await ($mgType::RequestAsync()) $mgType
 $s = $mgr.GetCurrentSession()

package/dist/core/v4/aidenAgent.js

@@ -650,6 +650,15 @@ class AidenAgent {
             else if (evt.type === 'tool_call') {
                 runOptions.onToolCallStart?.(evt.toolCall);
             }
+            else if (evt.type === 'progress') {
+                // v4.1.4 Part 1.6 — drive the per-turn token progress bar.
+                // Defensive try/catch — a misbehaving display sink must not
+                // tear down the stream consumer.
+                try {
+                    runOptions.onProgress?.(evt.outputTokens, evt.maxTokens);
+                }
+                catch { /* progress sink errors don't block streaming */ }
+            }
             else if (evt.type === 'done') {
                 finalOutput = evt.output;
             }

package/dist/core/v4/promptBuilder.js

@@ -128,7 +128,8 @@ const EXECUTION_DISCIPLINE_PROSE = [
     'file"), you MUST immediately make the corresponding tool call in the same response.',
     'Never end your turn with a promise of future action — execute it now. Every',
     'response should either contain tool calls that make progress, or deliver a final',
-    'result. Responses that only describe intentions without acting are not acceptable.',
+    'result. When the user requests an action, take it. When the user requests',
+    'discussion, discuss.',
 ].join('\n');
 /**
  * Llama-3.3-specific tool-call format guard. Adapter-side recovery picks

package/dist/core/v4/sessionDistiller.js

@@ -192,7 +192,19 @@ function recoverBullets(raw) {
     }
     return [];
 }
-const DEFAULT_TIMEOUT_MS = 4000;
+/**
+ * v4.1.3-essentials distillation-fix: default raised from 4000ms to
+ * 12000ms after visual smoke showed chatgpt-plus Codex regularly
+ * exceeded the original budget for 800-token summaries on
+ * cold-start. Symptom: every `/quit` distillation returned
+ * `partial:true` with empty bullets/decisions/open_items, killing
+ * both the MEMORY.md update path AND the promotion prompt.
+ *
+ * 12s gives comfortable headroom while still aborting genuinely
+ * stuck calls. Power users can override via `AIDEN_SUMMARY_TIMEOUT_MS`
+ * env var (consumed by `resolveSummaryTimeoutMs()` in chatSession).
+ */
+const DEFAULT_TIMEOUT_MS = 12000;
 /**
  * Phase v4.1.2-bug-Y: max chars of tool-result content surfaced to the
  * auxiliary LLM. Covers typical error messages + JSON-payload heads
@@ -372,11 +384,46 @@ async function distillSession(opts) {
             setTimeout(() => resolve({ ok: false, error: new Error(`auxiliary call timed out after ${timeoutMs}ms`), timedOut: true }), timeoutMs);
         }),
     ]);
+    // v4.1.3-essentials distillation-fix: emit a diagnostic line for
+    // each of the three failure classes so the caller can surface the
+    // root cause. Previously all three paths produced an identical
+    // `partial:true + empty` result with no signal about WHICH failure
+    // fired. Safe to call onDiagnostic synchronously — caller wraps in
+    // try/catch so a throwing sink doesn't break distillation.
+    const diag = (msg) => {
+        if (!opts.onDiagnostic)
+            return;
+        try {
+            opts.onDiagnostic(msg);
+        }
+        catch { /* never break distillation */ }
+    };
     let semantic;
     if (llmRaw.ok) {
         semantic = parseLLMDistillation(llmRaw.content);
+        if (semantic.partial) {
+            // Parser fell back to bullets-only or fully-empty — the LLM
+            // returned content but it wasn't valid JSON. First-200-chars
+            // hint lets the user / debugger see what shape the model
+            // actually emitted (often a chatty preamble that confused
+            // the JSON extractor).
+            const head = llmRaw.content.trim().slice(0, 200).replace(/\n/g, ' ');
+            diag(`auxiliary returned unparseable JSON (first 200 chars: ${head})`);
+        }
     }
     else {
+        // Race resolved with the failure branch — either the timeout
+        // fired or auxiliaryClient.call threw. Hoist `error` into a
+        // local so the narrowed type stays stable inside the branch
+        // (TS can't infer `error` exists on `llmRaw` because the union
+        // overlaps with the success branch in its type literal).
+        const failure = llmRaw;
+        if (failure.timedOut === true) {
+            diag(`auxiliary call timed out after ${timeoutMs}ms`);
+        }
+        else {
+            diag(`auxiliary call failed: ${failure.error.message}`);
+        }
         semantic = {
             bullets: [],
             decisions: [],

package/dist/core/v4/toolRegistry.js

@@ -154,7 +154,22 @@ class ToolRegistry {
             }
             try {
                 const result = await handler.execute(args, context);
-                return { id: call.id, name: call.name, result };
+                // v4.1.3-repl-polish: lift `degraded` + `degradedReason` from the
+                // handler's inner result to the outer ToolCallResult so the CLI
+                // trail row can render the partial-yellow state. Tools opt in by
+                // setting these on the object they return; without this lift the
+                // flags would sit on `out.result.degraded` where callbacks.ts
+                // can't see them. Strict typeof checks avoid promoting truthy-
+                // but-wrong-shape junk (numbers, strings, nested objects).
+                const inner = result;
+                const out = { id: call.id, name: call.name, result };
+                if (typeof inner?.degraded === 'boolean' && inner.degraded) {
+                    out.degraded = true;
+                    if (typeof inner.degradedReason === 'string') {
+                        out.degradedReason = inner.degradedReason;
+                    }
+                }
+                return out;
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);

package/dist/core/version.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 // AUTO-GENERATED by scripts/inject-version.js — do not edit by hand
-exports.VERSION = '4.1.2';
+exports.VERSION = '4.1.4';

package/dist/moat/plannerGuard.js

@@ -91,6 +91,25 @@ const RULES = [
         keywords: /\b(process|background|long.?running|server|spawn|kill|daemon)\b/i,
         toolsets: ['process'],
     },
+    // Media playback control (v4.1.4-media)
+    //
+    // Without this, intents like "list media sessions" matched the
+    // `sessions` rule via the bare word "session" → narrowed surface to
+    // toolset `sessions` only → `media_sessions` (toolset `system`) was
+    // filtered out and the model honestly reported it as unavailable.
+    // UNION semantics mean both rules contribute on phrases that hit
+    // both ("media sessions" → sessions + system), giving the model the
+    // full picture without needing a dedicated `media` toolset.
+    //
+    // Toolset is `system` (broad but minimal blast radius): the bundle
+    // covers media_sessions, media_transport, media_key, app_input,
+    // now_playing, plus the plausibly-relevant app_launch / volume_set /
+    // os_process_list. Carving out a dedicated `media` toolset is a
+    // separate slice if the surface noise becomes a real problem.
+    {
+        keywords: /\b(play|pause|skip|spotify|music|song|video|youtube|track|playback|media)\b/i,
+        toolsets: ['system'],
+    },
 ];
 /** Always-on tools regardless of mode. The agent needs schema lookup
  *  + skill discovery + session search to be useful even on cold turns. */

package/dist/providers/v4/anthropicAdapter.js

@@ -114,7 +114,7 @@ class AnthropicAdapter {
             };
             return;
         }
-        yield* decodeStream(reply.body);
+        yield* decodeStream(reply.body, input.maxTokens ?? DEFAULT_MAX_TOKENS);
     }
     // ── Request body assembly ────────────────────────────────────────────────
     buildBody(input, streaming) {
@@ -404,13 +404,20 @@ function decodeUsage(u) {
     }
     return out;
 }
-async function* decodeStream(body) {
+async function* decodeStream(body, maxTokens) {
     const blocks = new Map();
     const toolCalls = [];
     let stopReason;
     let usage = undefined;
     // Stable text emission order: walk content blocks by index at end-of-stream.
     const textOrder = [];
+    // v4.1.4 Part 1.6: track the last-emitted output-token count so we
+    // only yield a `progress` event when the counter actually advances.
+    // Anthropic emits `message_delta.usage.output_tokens` as a running
+    // total — multiple deltas may carry the same value if no new tokens
+    // were produced between them. Deduping keeps the event stream
+    // proportional to real progress.
+    let lastProgressEmitted = -1;
     for await (const payload of (0, chatCompletionsAdapter_1.parseSseStream)(body)) {
         if (!payload || payload === '[DONE]')
             continue;
@@ -490,6 +497,22 @@ async function* decodeStream(body) {
                     stopReason = evt.delta.stop_reason;
                 if (evt.usage) {
                     usage = { ...(usage ?? {}), ...evt.usage };
+                    // v4.1.4 Part 1.6 — emit a `progress` event when the running
+                    // output-token counter advances. The display layer uses these
+                    // for the ▰▱ progress bar. Deduped via `lastProgressEmitted`
+                    // so a stream of message_delta events with no real progress
+                    // doesn't flood the consumer.
+                    const outputTokens = typeof evt.usage.output_tokens === 'number'
+                        ? evt.usage.output_tokens
+                        : -1;
+                    if (outputTokens > lastProgressEmitted) {
+                        lastProgressEmitted = outputTokens;
+                        yield {
+                            type: 'progress',
+                            outputTokens,
+                            maxTokens,
+                        };
+                    }
                 }
                 break;
             }

package/dist/providers/v4/errors.js

@@ -17,6 +17,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProviderRateLimitError = exports.ProviderTimeoutError = exports.ProviderError = void 0;
 exports.formatRawForMessage = formatRawForMessage;
+exports.classifyProviderError = classifyProviderError;
+exports.suggestForErrorClass = suggestForErrorClass;
 /**
  * Format a raw response body for inclusion in the user-facing error
  * message. Recognises three JSON envelope shapes and falls back to the
@@ -109,3 +111,93 @@ class ProviderRateLimitError extends ProviderError {
     }
 }
 exports.ProviderRateLimitError = ProviderRateLimitError;
+function classifyProviderError(err) {
+    if (err == null)
+        return 'other';
+    // 1. Type-based class detection (fastest, most structured).
+    if (err instanceof ProviderRateLimitError)
+        return 'rate_limit';
+    if (err instanceof ProviderTimeoutError)
+        return 'transport';
+    if (err instanceof ProviderError) {
+        if (err.statusCode === 413)
+            return 'context_overflow';
+        if (err.statusCode === 429)
+            return 'rate_limit';
+        if (err.statusCode === 401 || err.statusCode === 403)
+            return 'auth';
+    }
+    // 2. Fall back to message scanning. Adapters that pass through the
+    //    upstream JSON `error.message` verbatim land here.
+    const msg = err instanceof Error ? err.message : String(err);
+    const lc = msg.toLowerCase();
+    // Context overflow / 413 family. Groq's free-tier TPM cap triggers
+    // these on the first turn once the prompt + tool schemas inflate.
+    if (lc.includes('413') ||
+        lc.includes('context_length_exceeded') ||
+        lc.includes('context length') ||
+        lc.includes('too large') ||
+        lc.includes('maximum context length') ||
+        lc.includes('payload too large')) {
+        return 'context_overflow';
+    }
+    // Rate-limit family — 429 / TPM / quota / "too many requests".
+    if (lc.includes('429') ||
+        lc.includes('rate_limit') ||
+        lc.includes('rate limit') ||
+        lc.includes('too many requests') ||
+        lc.includes('quota') ||
+        lc.includes('tpm')) {
+        return 'rate_limit';
+    }
+    // Auth family — 401 / 403 / invalid keys / unauthenticated.
+    if (lc.includes('401') ||
+        lc.includes('403') ||
+        lc.includes('invalid_api_key') ||
+        lc.includes('invalid api key') ||
+        lc.includes('unauthenticated') ||
+        lc.includes('unauthorized') ||
+        lc.includes('forbidden')) {
+        return 'auth';
+    }
+    // Transport — network, DNS, timeouts that escaped the typed path.
+    if (lc.includes('econnrefused') ||
+        lc.includes('enotfound') ||
+        lc.includes('etimedout') ||
+        lc.includes('socket hang up') ||
+        lc.includes('network')) {
+        return 'transport';
+    }
+    return 'other';
+}
+/**
+ * v4.1.3-prebump: produce a single-sentence actionable hint for the
+ * given error class. Returns null for `'other'` so the caller can keep
+ * its existing default suggestion. Provider name is surfaced where it
+ * sharpens the advice ("groq rate-limited" reads clearer than
+ * "rate limit").
+ *
+ * Pure helper. The REPL displays the result; tests assert it. No
+ * registry / state access — feed it the class + provider name.
+ */
+function suggestForErrorClass(cls, providerName) {
+    const p = providerName ?? 'this provider';
+    switch (cls) {
+        case 'context_overflow':
+            return (`${p} returned 413 (context too large). The combined system prompt ` +
+                `+ tool schemas exceed ${p}'s context window. Try \`/model\` to ` +
+                `switch to a provider with more headroom (chatgpt-plus, anthropic, ` +
+                `deepseek).`);
+        case 'rate_limit':
+            return (`${p} is rate-limited. Wait a minute, or run \`/model\` to switch ` +
+                `to another authed provider while ${p} cools off.`);
+        case 'auth':
+            return (`${p} rejected the credentials. Run \`/auth status\` (or check the ` +
+                `relevant API key env var) and \`/auth login\` if needed.`);
+        case 'transport':
+            return (`Network or transport error reaching ${p}. Check connectivity, then ` +
+                `retry — or \`/model\` to a local provider (ollama) for offline work.`);
+        case 'other':
+            return null;
+    }
+}

package/dist/tools/v4/index.js

@@ -21,7 +21,8 @@
  * Status: PHASE 8.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sessionSummaryTool = exports.memoryRemoveTool = exports.memoryReplaceTool = exports.memoryAddTool = exports.processWaitTool = exports.processKillTool = exports.processLogReadTool = exports.processListTool = exports.processSpawnTool = exports.executeCodeTool = exports.shellExecTool = exports.clipboardWriteTool = exports.clipboardReadTool = exports.appCloseTool = exports.appLaunchTool = exports.volumeSetTool = exports.mediaKeyTool = exports.osProcessListTool = exports.screenshotTool = exports.naturalEventsTool = exports.nowPlayingTool = exports.systemInfoTool = exports.makeLookupToolSchema = exports.skillManageTool = exports.skillViewTool = exports.skillsListTool = exports.sessionListTool = exports.sessionSearchTool = exports.browserCloseTool = exports.browserScrollTool = exports.browserFillTool = exports.browserTypeTool = exports.browserClickTool = exports.browserNavigateTool = exports.browserGetUrlTool = exports.browserExtractTool = exports.browserScreenshotTool = exports.fileCopyTool = exports.fileMoveTool = exports.fileDeleteTool = exports.filePatchTool = exports.fileWriteTool = exports.fileListTool = exports.fileReadTool = exports.deepResearchTool = exports.webPageTool = exports.webFetchTool = exports.webSearchTool = exports.makeSubagentFanoutTool = void 0;
+exports.memoryReplaceTool = exports.memoryAddTool = exports.processWaitTool = exports.processKillTool = exports.processLogReadTool = exports.processListTool = exports.processSpawnTool = exports.executeCodeTool = exports.shellExecTool = exports.appInputTool = exports.mediaTransportTool = exports.mediaSessionsTool = exports.clipboardWriteTool = exports.clipboardReadTool = exports.appCloseTool = exports.appLaunchTool = exports.volumeSetTool = exports.mediaKeyTool = exports.osProcessListTool = exports.screenshotTool = exports.naturalEventsTool = exports.nowPlayingTool = exports.systemInfoTool = exports.makeLookupToolSchema = exports.skillManageTool = exports.skillViewTool = exports.skillsListTool = exports.sessionListTool = exports.sessionSearchTool = exports.browserCloseTool = exports.browserScrollTool = exports.browserFillTool = exports.browserTypeTool = exports.browserClickTool = exports.browserNavigateTool = exports.browserGetUrlTool = exports.browserExtractTool = exports.browserScreenshotTool = exports.fileCopyTool = exports.fileMoveTool = exports.fileDeleteTool = exports.filePatchTool = exports.fileWriteTool = exports.fileListTool = exports.fileReadTool = exports.deepResearchTool = exports.webPageTool = exports.webFetchTool = exports.webSearchTool = exports.makeSubagentFanoutTool = void 0;
+exports.sessionSummaryTool = exports.memoryRemoveTool = void 0;
 exports.registerReadOnlyTools = registerReadOnlyTools;
 exports.registerWriteTools = registerWriteTools;
 exports.registerAllTools = registerAllTools;
@@ -66,6 +67,13 @@ const appLaunch_1 = require("./system/appLaunch");
 const appClose_1 = require("./system/appClose");
 const clipboardRead_1 = require("./system/clipboardRead");
 const clipboardWrite_1 = require("./system/clipboardWrite");
+// v4.1.4-media — three-layer media-control bundle.
+// Layer 2 (OS media session): mediaSessions (read) + mediaTransport (write).
+// Layer 3 fallback (mediaKey, blind keystroke) remains unchanged.
+// Layer 1 (semantic API) is per-app and out of this slice.
+const mediaSessions_1 = require("./system/mediaSessions");
+const mediaTransport_1 = require("./system/mediaTransport");
+const appInput_1 = require("./system/appInput");
 // Phase v4.1.2-update — natural-language self-update entry point.
 // Routes through the same shared executeInstall executor as `/update install`.
 const aidenSelfUpdate_1 = require("./system/aidenSelfUpdate");
@@ -123,6 +131,9 @@ function registerReadOnlyTools(registry) {
     registry.register(screenshot_1.screenshotTool);
     registry.register(osProcessList_1.osProcessListTool);
     registry.register(clipboardRead_1.clipboardReadTool);
+    // v4.1.4-media — GSMTC session enumeration (read). Pair with
+    // mediaTransport (write) in the write-tools registration below.
+    registry.register(mediaSessions_1.mediaSessionsTool);
     registry.register((0, lookupToolSchema_1.makeLookupToolSchema)(registry));
     // Phase v4.1-subagent — register a stub for subagent_fanout so its
     // schema is visible to the agent loop, the MCP server, and the
@@ -198,6 +209,11 @@ function registerWriteTools(registry) {
     registry.register(appLaunch_1.appLaunchTool);
     registry.register(appClose_1.appCloseTool);
     registry.register(clipboardWrite_1.clipboardWriteTool);
+    // v4.1.4-media — verified GSMTC transport (replaces mediaKey for
+    // the "name an app, play/pause it" case) + focused-window SendKeys
+    // (escape hatch when GSMTC doesn't enumerate the surface).
+    registry.register(mediaTransport_1.mediaTransportTool);
+    registry.register(appInput_1.appInputTool);
 }
 /** Register every v4 tool. Most callers want this. */
 function registerAllTools(registry) {
@@ -281,6 +297,13 @@ var clipboardRead_2 = require("./system/clipboardRead");
 Object.defineProperty(exports, "clipboardReadTool", { enumerable: true, get: function () { return clipboardRead_2.clipboardReadTool; } });
 var clipboardWrite_2 = require("./system/clipboardWrite");
 Object.defineProperty(exports, "clipboardWriteTool", { enumerable: true, get: function () { return clipboardWrite_2.clipboardWriteTool; } });
+// v4.1.4-media exports — three-layer media-control bundle.
+var mediaSessions_2 = require("./system/mediaSessions");
+Object.defineProperty(exports, "mediaSessionsTool", { enumerable: true, get: function () { return mediaSessions_2.mediaSessionsTool; } });
+var mediaTransport_2 = require("./system/mediaTransport");
+Object.defineProperty(exports, "mediaTransportTool", { enumerable: true, get: function () { return mediaTransport_2.mediaTransportTool; } });
+var appInput_2 = require("./system/appInput");
+Object.defineProperty(exports, "appInputTool", { enumerable: true, get: function () { return appInput_2.appInputTool; } });
 var shellExec_2 = require("./terminal/shellExec");
 Object.defineProperty(exports, "shellExecTool", { enumerable: true, get: function () { return shellExec_2.shellExecTool; } });
 var executeCode_2 = require("./executeCode");

package/dist/tools/v4/sessions/recallSession.js

@@ -132,6 +132,14 @@ exports.recallSessionTool = {
             include_full: args.include_full === true,
         };
         const ranked = (0, distillationIndex_1.rankDistillations)(dists, recallQuery);
+        // v4.1.3-repl-polish: mark degraded when any matched session was
+        // distilled with the Phase A+B `partial: true` flag (LLM-timeout
+        // path — deterministic fields present, semantic bullets/decisions
+        // may be empty). The model still gets the full match list; the
+        // trail row renders yellow so the user knows recall completed
+        // against partial data.
+        const partialCount = ranked.matches.filter((m) => m.partial === true).length;
+        const degraded = partialCount > 0;
         return {
             success: true,
             query: recallQuery.query,
@@ -142,6 +150,12 @@ exports.recallSessionTool = {
             // delta is malformed files; the agent can suggest running aiden
             // doctor to inspect.
             scanned: ids.length,
+            ...(degraded && {
+                degraded: true,
+                degradedReason: partialCount === 1
+                    ? '1 matched session has partial distillation data'
+                    : `${partialCount} matched sessions have partial distillation data`,
+            }),
         };
         // Note re: subsystem health — wire-up happens at the runtime
         // construction layer (cli/v4/aidenCLI.ts) where the registry is