@raidiant/notifai 1.0.1 → 2.0.0

package/CHANGELOG.md

@@ -8,6 +8,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
 and [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
 
+## [2.0.0](https://github.com/Raidiant-io/notifai/compare/v1.1.0...v2.0.0) (2026-08-13)
+
+
+### ⚠ BREAKING CHANGES
+
+* **cli:** hide the service URL, move personal prefs, and shorten setup closes
+
+### Features
+
+* **cli:** pack a bounded consented slice of the local log ([6fb3d68](https://github.com/Raidiant-io/notifai/commit/6fb3d68cd0057ab901c031c6012318fe464949a9))
+* **cli:** send a test notification by kind, not by inventing a sound ([b90c8ed](https://github.com/Raidiant-io/notifai/commit/b90c8edcbf2ba98db09414701a309cef88aa1cc4))
+* **cli:** support Windows and Linux harness workflows ([779ab6b](https://github.com/Raidiant-io/notifai/commit/779ab6b075900a7a431b809ddcb715fd80836688))
+* compose native skills setup into init ([de6318a](https://github.com/Raidiant-io/notifai/commit/de6318a71166ef75774a217176f1e020116e177b))
+* **skill:** make agents set Notifai up and skip sound/level unless overriding ([9ffd87c](https://github.com/Raidiant-io/notifai/commit/9ffd87c0c79e539f8b92e94ac453407d58bca30f))
+
+
+### Bug Fixes
+
+* **cli:** cover Windows terminal behavior ([cda7abd](https://github.com/Raidiant-io/notifai/commit/cda7abd134744b2cac44204dd3eb1b20b9038edc))
+* **cli:** drop unfinished import changes from the skill rewrite ([2fd49b2](https://github.com/Raidiant-io/notifai/commit/2fd49b2ba4d4f218138da5dbc3455f1ac07adaf6))
+* **cli:** hide the service URL, move personal prefs, and shorten setup closes ([5b9fe52](https://github.com/Raidiant-io/notifai/commit/5b9fe52d9dc5296e5c3b328a82682a36719d891b))
+* **cli:** install hooks at one scope, not project and global ([f4cd237](https://github.com/Raidiant-io/notifai/commit/f4cd2376b57d9104fbcdcca83990ad9dfe09b296))
+* **cli:** isolate Codex hooks and reply routing ([#1](https://github.com/Raidiant-io/notifai/issues/1)) ([d060b6a](https://github.com/Raidiant-io/notifai/commit/d060b6a18b5937d82f74619a6c1bc711243be26c))
+* **cli:** keep Codex hook install on ~/.codex, ignore CODEX_HOME ([3f75f13](https://github.com/Raidiant-io/notifai/commit/3f75f131c24534d3813a336bb72422f78e24a972))
+* **cli:** offer labeled hooks install and uninstall in the interactive app ([f93d0ae](https://github.com/Raidiant-io/notifai/commit/f93d0ae1c981694de6abb317f93f1647dd1d64fa))
+* **cli:** preserve Codex hook trust on reinstall ([#3](https://github.com/Raidiant-io/notifai/issues/3)) ([5e2c2f4](https://github.com/Raidiant-io/notifai/commit/5e2c2f4d618276573f810a989f41a89ab1053564))
+* **cli:** report observed setup receipts ([99d04bb](https://github.com/Raidiant-io/notifai/commit/99d04bbd487681db3023468fbd88b77a1ba13ceb))
+* **cli:** skip readiness work that cannot change the next action ([7fc2295](https://github.com/Raidiant-io/notifai/commit/7fc2295e4a98b07f0116bad17ea93b8f98b265d1))
+* **cli:** stabilize Linux portability checks ([1462693](https://github.com/Raidiant-io/notifai/commit/146269306ae3dfc91f3559cce802460d3e058925))
+* **cli:** write Codex hooks in the layer's existing representation ([7589862](https://github.com/Raidiant-io/notifai/commit/758986296009c1d50bed66a79a5863ea977aa87e))
+* **cli:** write Codex hooks to config.toml, not hooks.json ([3cc6bb8](https://github.com/Raidiant-io/notifai/commit/3cc6bb8bc9bb592ee4abce3f1421d7c0c6f56d32))
+* make CLI package installable from npm ([67bd6be](https://github.com/Raidiant-io/notifai/commit/67bd6be77d648a12ff0d3036a5853b6a4391bebb))
+
+## [1.1.0](https://github.com/Raidiant-io/notifai/compare/v1.0.1...v1.1.0) (2026-08-13)
+
+
+### Features
+
+* **cli:** support Windows and Linux harness workflows ([779ab6b](https://github.com/Raidiant-io/notifai/commit/779ab6b075900a7a431b809ddcb715fd80836688))
+
+
+### Bug Fixes
+
+* **cli:** cover Windows terminal behavior ([cda7abd](https://github.com/Raidiant-io/notifai/commit/cda7abd134744b2cac44204dd3eb1b20b9038edc))
+* **cli:** isolate Codex hooks and reply routing ([#1](https://github.com/Raidiant-io/notifai/issues/1)) ([d060b6a](https://github.com/Raidiant-io/notifai/commit/d060b6a18b5937d82f74619a6c1bc711243be26c))
+* **cli:** keep Codex hook install on ~/.codex, ignore CODEX_HOME ([3f75f13](https://github.com/Raidiant-io/notifai/commit/3f75f131c24534d3813a336bb72422f78e24a972))
+* **cli:** preserve Codex hook trust on reinstall ([#3](https://github.com/Raidiant-io/notifai/issues/3)) ([5e2c2f4](https://github.com/Raidiant-io/notifai/commit/5e2c2f4d618276573f810a989f41a89ab1053564))
+* **cli:** report observed setup receipts ([99d04bb](https://github.com/Raidiant-io/notifai/commit/99d04bbd487681db3023468fbd88b77a1ba13ceb))
+* **cli:** stabilize Linux portability checks ([1462693](https://github.com/Raidiant-io/notifai/commit/146269306ae3dfc91f3559cce802460d3e058925))
+
 ## [Unreleased]
 
 ## [1.0.1] - 2026-08-13

package/README.md

@@ -56,6 +56,10 @@ For a harness that cannot resume an idle agent turn, `notifai send
 
 ## Agent harnesses
 
+The CLI and managed hook adapters support macOS, Linux, and Windows. Receiving
+still requires the current iPhone or macOS Companion App; native Windows and
+Linux Companion Apps are not shipped yet.
+
 ```sh
 notifai hooks install
 ```
@@ -67,13 +71,19 @@ or add one it did not see. This is what lets an agent's question reach
 your phone without the agent having to cooperate — no question detection,
 no state in a context window that compaction will eat.
 
-Every harness definition calls one stable user-level adapter at
-`~/.notifai/bin/hook-adapter`. Node, package manager, CLI version, checkout,
-XDG directories, and notification preferences are resolved behind it, so
-upgrades and configuration changes do not rewrite trusted hook definitions.
-The first migration may require one Codex `/hooks` approval; later repairs keep
-the same identity. Codex's Stop definition omits its timeout so the host default
-remains authoritative; prompt-submit and session-end retain fixed short limits.
+Every harness definition calls one stable user-level adapter under the account
+home (`~/.notifai/bin/hook-adapter` on macOS/Linux and the corresponding user
+profile path on Windows). Node, package manager, CLI version, checkout,
+configuration directories, and notification preferences are resolved behind
+it, so upgrades and configuration changes do not rewrite trusted hook
+definitions. Windows invokes its JavaScript adapter through the registered Node
+executable; macOS/Linux retain the POSIX adapter and its stable command bytes.
+Claude Code Stop returns immediately into the live inbox route on macOS/Linux;
+on Windows, where upstream exposes no inbox socket, Stop stays open and returns
+the accepted answer through the harness continuation. The first migration may
+require one Codex `/hooks` approval; later repairs keep the same identity.
+Codex's Stop definition omits its timeout so the host default remains
+authoritative; prompt-submit and session-end retain fixed short limits.
 
 `notifai doctor` compares Codex trust on a best-effort basis against Codex's
 current persisted representation. Notifai never writes that trust store;

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AccountAccessResponse, BeginPairingResponse, CapabilityDocument, CreateMediaUploadRequestT, CreateMediaUploadResponse, EvidenceSnapshot, ListDevicesResponse, ListRepliesResponse, Platform, PollPairingResponse, SubmissionReceipt, SubmitNotificationRequestT } from '@raidiant/notifai-protocol';
+import type { AccountAccessResponse, BeginPairingResponse, CapabilityDocument, CreateMediaUploadRequestT, CreateMediaUploadResponse, EvidenceSnapshot, GetAgentAcknowledgementResponse, ListDevicesResponse, ListRepliesResponse, Platform, PollPairingResponse, PutAgentAcknowledgementRequestT, PutAgentAcknowledgementResponse, SubmissionReceipt, SubmitNotificationRequestT } from '@raidiant/notifai-protocol';
 import type { Logger } from './logging.js';
 export declare class ApiCallError extends Error {
     status: number;
@@ -34,6 +34,10 @@ export interface ApiClient {
     }): Promise<ListRepliesResponse>;
     /** Retire a question and return the replies committed before the close fence. */
     closeReplies(requestId: string): Promise<ListRepliesResponse>;
+    putAgentAcknowledgement(requestId: string, body: PutAgentAcknowledgementRequestT): Promise<PutAgentAcknowledgementResponse>;
+    agentAcknowledgement(requestId: string, options: {
+        waitSeconds: number;
+    }): Promise<GetAgentAcknowledgementResponse>;
     createMediaUpload(body: CreateMediaUploadRequestT): Promise<CreateMediaUploadResponse>;
     uploadMedia(grant: CreateMediaUploadResponse, bytes: Uint8Array): Promise<void>;
     health(): Promise<boolean>;

package/dist/client.js

@@ -129,6 +129,8 @@ export function createClient(baseUrl, bearer, options = {}) {
         evidence: (requestId) => call('GET', `/api/v1/notifications/${requestId}`),
         replies: (requestId, { waitSeconds, afterSeq }) => call('GET', `/api/v1/notifications/${encodeURIComponent(requestId)}/replies?wait_seconds=${waitSeconds}&after_seq=${afterSeq}`, undefined, waitSeconds),
         closeReplies: (requestId) => call('POST', `/api/v1/notifications/${encodeURIComponent(requestId)}/replies/close`),
+        putAgentAcknowledgement: (requestId, body) => call('PUT', `/api/v1/notifications/${encodeURIComponent(requestId)}/agent-acknowledgement`, body),
+        agentAcknowledgement: (requestId, { waitSeconds }) => call('GET', `/api/v1/notifications/${encodeURIComponent(requestId)}/agent-acknowledgement?wait_seconds=${waitSeconds}`, undefined, waitSeconds),
         createMediaUpload: (body) => call('POST', '/api/v1/media', body),
         uploadMedia: async (grant, bytes) => {
             let response;

package/dist/client.js.map

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

package/dist/commands.d.ts

@@ -61,6 +61,8 @@ export interface CommandDeps {
     hookAdapterHome?: string;
     /** Test seam; production uses this process's Node and CLI paths. */
     hookInstallTarget?: HookAdapterTarget;
+    /** Test seam; production uses process.platform for adapter format and quoting. */
+    hookPlatform?: NodeJS.Platform;
     /** Test seam; production uses fetch against base_url. */
     clientFactory?: (baseUrl: string, bearer: string | null, options?: ClientOptions) => ApiClient;
     /** Test seam for bounded polling without wall-clock sleeps. */
@@ -228,8 +230,15 @@ export declare function buildQuestions(flags: AskFlags, question: string | undef
  * for `ask_grace_seconds` before it reaches any device.
  */
 export declare function askCommand(deps: CommandDeps, question: string | undefined, flags: AskFlags): number;
+/** Record the one Agent Acknowledgement associated with a replied-to request. */
+export declare function acknowledgeCommand(deps: CommandDeps, requestId: string, flags: {
+    text?: string;
+    json?: boolean;
+}): Promise<number>;
 /** Retire a question so a late answer is rejected rather than silently lost. */
-export declare function closeCommand(deps: CommandDeps, requestId: string): Promise<number>;
+export declare function closeCommand(deps: CommandDeps, requestId: string, flags?: {
+    json?: boolean;
+}): Promise<number>;
 export interface HooksInstallFlags {
     harness?: string;
     global?: boolean;

package/dist/commands.js

@@ -1,20 +1,19 @@
 import { createHash, randomBytes } from 'node:crypto';
-import { spawn } from 'node:child_process';
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, rmSync, unlinkSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { parse as parseToml, stringify as stringifyToml } from 'smol-toml';
-import { CAPABILITIES_V1, QUESTION_TEXT_MAX_LENGTH, REPLY_MAX_QUESTIONS, REPLY_MAX_WINDOW_SECONDS, validateDraft, } from '@raidiant/notifai-protocol';
+import { AGENT_ACKNOWLEDGEMENT_MAX_LENGTH, CAPABILITIES_V1, QUESTION_TEXT_MAX_LENGTH, REPLY_MAX_QUESTIONS, REPLY_MAX_WINDOW_SECONDS, validateDraft, } from '@raidiant/notifai-protocol';
 import { sha256Hex } from '@raidiant/notifai-protocol/node';
 import { ApiCallError, NetworkError, createClient, isRetryableReplyPollError, } from './client.js';
-import { BOOLEAN_CONFIG_KEYS, CONFIG_KEYS, LOG_LEVELS, NUMERIC_CONFIG_KEYS, configBounds, configDefaultValue, findProjectConfigPath, personalProjectConfigPath, globalConfigPath, loadConfig, sessionConfigPath, } from './config.js';
+import { BOOLEAN_CONFIG_KEYS, CONFIG_KEYS, LOG_LEVELS, NUMERIC_CONFIG_KEYS, configBounds, configDefaultValue, findProjectConfigPath, personalProjectConfigPath, globalConfigPath, loadConfig, sessionConfigPath, stateDir, } from './config.js';
 import { acceptedValues, configInfo } from './config-schema.js';
 import { packageVersion, skillsSource } from './release.js';
 import { atomicWriteFileSync } from './atomic-file.js';
 import { withTargetFileLock } from './file-lock.js';
 import { renderConfigExplain, renderConfigList, renderConfigPlain, } from './ui/config-view.js';
 import { firstBlocker, } from './readiness.js';
-import { WAITER_CEILING_SECONDS, handleSessionEnd, handleStop, handleUserPromptSubmit, parseHookInput, pruneAbandonedSessions, readLiveProjectSessionPointers, readMatchingProjectSessionPointer, readProjectSession, readProjectSessionPointer, readSessionState, registerQuestion, } from './hooks.js';
+import { WAITER_CEILING_SECONDS, clearAcknowledgementObligation, handleSessionEnd, handleStop, handleUserPromptSubmit, parseHookInput, pruneAbandonedSessions, readLiveProjectSessionPointers, readMatchingProjectSessionPointer, readProjectSession, readProjectSessionPointer, readSessionState, registerQuestion, } from './hooks.js';
 import { LOG_EVENTS, activeLogPath, archiveLogPaths, logConfigResolved, logSettingsFrom, logsDiskUsage, nullLogger, readLogRecords, renderRecord, } from './logging.js';
 import { BLOCKING_STOP_TIMEOUT_SECONDS, CLAUDE_ASYNC_STOP_TIMEOUT_SECONDS, HARNESSES, applyPlan, buildCursorHookConfig, buildHookConfig, collapseUnusedCodexRepresentation, codexLayerDir, codexLayerPaths, codexRepresentationProblems, codexTrustProblems, codexProjectRoot, detectHarness, detectedHarnesses, findInstallations, handlerEvent, hookDefinitionFiles, inspectCodexLayer, loadCursorSettings, loadSettings, mergeCursorHooks, mergeHooks, removeCursorHooks, removeHooks, settingsFile, } from './install-hooks.js';
 import { HARNESS_CAPABILITIES, HARNESS_LABELS } from './harnesses.js';
@@ -23,6 +22,7 @@ import { codexWakeRoute, inspectCodexResume, } from './codex-wake.js';
 import { inspectHookAdapter, installHookAdapter, isNpxAdapterTarget, } from './hook-adapter.js';
 import { isOurOpencodePlugin, opencodePluginSource, } from './opencode-plugin.js';
 import { CHOICE_USAGE, buildDraft, formatReceipt, parseChoices, receiptExitCode, slugify, } from './send.js';
+import { openUrl } from './platform.js';
 /** The invocation's logger, or one that discards everything. */
 export function log(deps) {
     return deps.logger ?? nullLogger();
@@ -422,6 +422,7 @@ export async function sendCommand(deps, flags) {
         title: flags.title,
         overall: receipt.overall,
         replayed: receipt.replayed,
+        agent_acknowledgement_required: receipt.agent_acknowledgement_required,
         deliveries: receipt.deliveries.length,
         wait_seconds: waitSeconds,
         exit: receiptExit,
@@ -452,6 +453,9 @@ export async function sendCommand(deps, flags) {
                     type: 'reply_result',
                     request_id: receipt.request_id,
                     replies: [],
+                    agent_acknowledgement_required: receipt.agent_acknowledgement_required,
+                    agent_acknowledgement: null,
+                    acknowledgement_command: null,
                     degraded: false,
                 })
                 : JSON.stringify(receipt, null, 2));
@@ -467,17 +471,16 @@ export async function sendCommand(deps, flags) {
         });
         recordReplies(deps, receipt.request_id, result.response.replies);
         if (flags.json) {
-            deps.io.out(JSON.stringify({
-                type: 'reply_result',
-                request_id: receipt.request_id,
-                replies: result.response.replies,
-                degraded: result.degraded,
-            }));
+            deps.io.out(JSON.stringify(replyResultJson(result.response, result.degraded)));
         }
-        else if (result.response.replies.length > 0)
+        else if (result.response.replies.length > 0) {
             printReplies(deps, result.response.replies);
-        else
+            printAcknowledgementStatus(deps, result.response);
+        }
+        else {
             printNoReply(deps, receipt.request_id, result.response.reply_expires_at);
+            printAcknowledgementStatus(deps, result.response);
+        }
         if (result.degraded) {
             log(deps).error('cli.error', {
                 kind: 'network',
@@ -601,15 +604,17 @@ export async function repliesCommand(deps, requestedId, flags) {
                 });
                 recordReplies(deps, requestId, result.response.replies);
                 if (flags.json) {
-                    jsonBodies.push({ ...result.response, degraded: result.degraded });
+                    jsonBodies.push(replyResultJson(result.response, result.degraded));
                 }
                 else if (result.response.replies.length > 0) {
                     if (flags.pending === true)
                         deps.io.out(`pending request ${requestId}`);
                     printReplies(deps, result.response.replies);
+                    printAcknowledgementStatus(deps, result.response);
                 }
                 else {
                     printNoReply(deps, requestId, result.response.reply_expires_at);
+                    printAcknowledgementStatus(deps, result.response);
                 }
                 anyReplies ||= result.response.replies.length > 0;
                 if (result.degraded)
@@ -687,7 +692,13 @@ export async function waitForReply(client, requestId, options) {
         throw lastTransientError;
     return {
         response: lastResponse ??
-            { request_id: requestId, reply_expires_at: null, replies: [] },
+            {
+                request_id: requestId,
+                reply_expires_at: null,
+                agent_acknowledgement_required: false,
+                agent_acknowledgement: null,
+                replies: [],
+            },
         timedOut: true,
         // A poll succeeded at some point, so we do not throw — but the last thing
         // we know is that we could not reach the server. Reporting that as a plain
@@ -723,6 +734,39 @@ function degradedWaitWarning(requestId) {
 function isNonNegativeInteger(value) {
     return Number.isInteger(value) && value >= 0;
 }
+function acknowledgementCommand(requestId, required, acknowledgement, hasReply = true) {
+    return required && acknowledgement === null && hasReply
+        ? `notifai acknowledge ${requestId} --text <text>`
+        : null;
+}
+function replyResultJson(response, degraded) {
+    return {
+        type: 'reply_result',
+        request_id: response.request_id,
+        reply_expires_at: response.reply_expires_at,
+        replies: response.replies,
+        agent_acknowledgement_required: response.agent_acknowledgement_required,
+        agent_acknowledgement: response.agent_acknowledgement,
+        acknowledgement_command: acknowledgementCommand(response.request_id, response.agent_acknowledgement_required, response.agent_acknowledgement, response.replies.length > 0),
+        degraded,
+    };
+}
+function printAcknowledgementStatus(deps, response) {
+    if (!response.agent_acknowledgement_required) {
+        deps.io.out('Agent Acknowledgement: not required for this request.');
+        return;
+    }
+    if (response.agent_acknowledgement !== null) {
+        deps.io.out(`Agent Acknowledgement: recorded at ${response.agent_acknowledgement.created_at}: ${response.agent_acknowledgement.text}`);
+        return;
+    }
+    if (response.replies.length > 0) {
+        deps.io.out('Agent Acknowledgement required.');
+        deps.io.out(`next: Run \`${acknowledgementCommand(response.request_id, true, null)}\` with concrete text saying what you will do because of the reply.`);
+        return;
+    }
+    deps.io.out('Agent Acknowledgement: required after a user reply; no reply is recorded yet.');
+}
 function recordReplies(deps, requestId, replies) {
     const logger = log(deps);
     for (const reply of replies) {
@@ -1128,6 +1172,8 @@ function stopWakeRoute(deps, harness, sessionId, cwd) {
     if (sessionId === undefined)
         return undefined;
     if (harness === 'claude-code') {
+        if ((deps.hookPlatform ?? process.platform) === 'win32')
+            return undefined;
         return claudeWakeRoute({
             sessionId,
             cwd,
@@ -1316,7 +1362,7 @@ export function askCommand(deps, question, flags) {
     const { active, contested } = resolveActiveHarness(deps.env, deps.cwd, now);
     let sessionId;
     if (active !== null) {
-        const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome);
+        const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform);
         const activeInstalled = installations.some((installation) => installation.harness === active.harness);
         if (!activeInstalled) {
             for (const line of diagnoseActiveHarnessSession(active, 'not-installed', installations, contested)) {
@@ -1518,11 +1564,11 @@ function activeQuestionRouteProblems(deps, active, installations) {
             }
         }
     }
-    for (const problem of inspectHookAdapter(deps.hookAdapterHome).problems) {
+    for (const problem of inspectHookAdapter(deps.hookAdapterHome, deps.hookPlatform).problems) {
         problems.push(problem);
     }
     for (const installation of matching)
-        problems.push(...stopShapeProblems(installation));
+        problems.push(...stopShapeProblems(installation, deps.hookPlatform));
     problems.push(...codexTrustProblems(matching, deps.env));
     return [...new Set(problems)];
 }
@@ -1574,7 +1620,7 @@ function diagnoseActiveHarnessSession(active, problem, installations, contested
  * checked after a prompt before assuming that a new session is required.
  */
 function diagnoseMissingSession(deps) {
-    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome);
+    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform);
     if (installations.length === 0) {
         return [
             'Could not tell which harness session this is: no Notifai hooks are installed for this project.',
@@ -1613,15 +1659,76 @@ function hookActivationAdvice(installations) {
     }
     return `${advice.join('. ')}.`;
 }
+/** Record the one Agent Acknowledgement associated with a replied-to request. */
+export async function acknowledgeCommand(deps, requestId, flags) {
+    const text = flags.text?.trim() ?? '';
+    if (text.length === 0) {
+        deps.io.err('--text is required and must contain non-whitespace text.');
+        return EXIT.usage;
+    }
+    if (text.length > AGENT_ACKNOWLEDGEMENT_MAX_LENGTH) {
+        deps.io.err(`--text must be at most ${AGENT_ACKNOWLEDGEMENT_MAX_LENGTH} characters after trimming.`);
+        return EXIT.usage;
+    }
+    const logger = log(deps);
+    const config = loadLoggedConfig(deps, { cwd: deps.cwd, env: deps.env });
+    logger.info('acknowledgement.attempted', {
+        request_id: requestId,
+        text,
+        characters: text.length,
+    });
+    const authed = authedClient(deps, config);
+    if (!authed)
+        return EXIT.auth;
+    try {
+        const result = await authed.client.putAgentAcknowledgement(requestId, { text });
+        const output = {
+            request_id: requestId,
+            outcome: result.status,
+            acknowledgement: result.agent_acknowledgement,
+            agent_acknowledgement_required: true,
+        };
+        logger.info('acknowledgement.outcome', {
+            request_id: requestId,
+            outcome: result.status,
+            text: result.agent_acknowledgement.text,
+            created_at: result.agent_acknowledgement.created_at,
+            agent_acknowledgement_required: true,
+        });
+        const sessionId = readProjectSession(deps.cwd, deps.env, (deps.now ?? Date.now)());
+        if (sessionId !== null) {
+            clearAcknowledgementObligation(sessionId, deps.env, requestId);
+        }
+        if (flags.json)
+            deps.io.out(JSON.stringify(output, null, 2));
+        else {
+            deps.io.out(`Agent Acknowledgement ${result.status} for ${requestId} at ${result.agent_acknowledgement.created_at}.`);
+        }
+        return EXIT.ok;
+    }
+    catch (err) {
+        return reportError(deps, err, { operation: 'agent_acknowledgement', request_id: requestId });
+    }
+}
 /** Retire a question so a late answer is rejected rather than silently lost. */
-export async function closeCommand(deps, requestId) {
+export async function closeCommand(deps, requestId, flags = {}) {
     const config = loadLoggedConfig(deps, { cwd: deps.cwd, env: deps.env });
     const authed = authedClient(deps, config);
     if (!authed)
         return EXIT.auth;
     try {
-        await authed.client.closeReplies(requestId);
-        deps.io.out(`Closed the reply window for ${requestId}.`);
+        const response = await authed.client.closeReplies(requestId);
+        if (flags.json) {
+            deps.io.out(JSON.stringify({
+                ...response,
+                acknowledgement_command: acknowledgementCommand(response.request_id, response.agent_acknowledgement_required, response.agent_acknowledgement, response.replies.length > 0),
+            }, null, 2));
+        }
+        else {
+            deps.io.out(`Closed the reply window for ${requestId}.`);
+            if (response.replies.length > 0)
+                printAcknowledgementStatus(deps, response);
+        }
         return EXIT.ok;
     }
     catch (err) {
@@ -1687,16 +1794,18 @@ export function hooksInstallCommand(deps, flags) {
         return EXIT.usage;
     const adapterTarget = resolveHookAdapterTarget(deps, flags);
     const scriptPath = flags.scriptPath ?? fileHookInstallTarget(adapterTarget)?.scriptPath ?? process.argv[1] ?? 'notifai';
+    const hookPlatform = deps.hookPlatform ?? process.platform;
+    const nodePath = adapterTarget.execPath;
     let adapterPath;
     try {
-        adapterPath = installHookAdapter(adapterTarget, deps.hookAdapterHome).path;
+        adapterPath = installHookAdapter(adapterTarget, deps.hookAdapterHome, hookPlatform).path;
     }
     catch (err) {
         deps.io.err(`Could not prepare the stable hook adapter: ${String(err)}`);
         return EXIT.failed;
     }
     const wantGlobal = flags.global === true;
-    const existing = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome).filter((installation) => installation.harness === harness);
+    const existing = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform).filter((installation) => installation.harness === harness);
     const otherScope = existing.filter((installation) => installation.global !== wantGlobal);
     if (!wantGlobal && otherScope.some((installation) => installation.global)) {
         const globalFile = otherScope.find((installation) => installation.global)?.file;
@@ -1708,13 +1817,15 @@ export function hooksInstallCommand(deps, flags) {
             return EXIT.failed;
         }
     }
-    const file = settingsFile(harness, wantGlobal, deps.cwd, deps.env);
+    const file = settingsFile(harness, wantGlobal, deps.cwd, deps.env, hookPlatform);
     // OpenCode's adapter is a generated plugin module rather than a handler
     // merged into a settings document, so it owns the whole file.
     if (harness === 'opencode') {
         return installOpencodePlugin(deps, file, {
             adapterPath,
             timeoutSeconds: BLOCKING_STOP_TIMEOUT_SECONDS,
+            platform: hookPlatform,
+            nodePath,
         });
     }
     if (harness === 'cursor') {
@@ -1724,6 +1835,8 @@ export function hooksInstallCommand(deps, flags) {
                 const result = mergeCursorHooks(document, buildCursorHookConfig({
                     adapterPath,
                     harness: 'cursor',
+                    platform: hookPlatform,
+                    nodePath,
                 }), scriptPath);
                 applyPlan(file, result.document);
                 return result;
@@ -1745,6 +1858,8 @@ export function hooksInstallCommand(deps, flags) {
             const result = mergeHooks(document, buildHookConfig({
                 adapterPath,
                 harness,
+                platform: hookPlatform,
+                nodePath,
             }), scriptPath);
             applyPlan(file, result.document);
             return result;
@@ -1818,7 +1933,7 @@ export function hooksUninstallCommand(deps, flags) {
     if (!harness)
         return EXIT.usage;
     const scriptPath = flags.scriptPath ?? process.argv[1] ?? 'notifai';
-    const file = settingsFile(harness, flags.global ?? false, deps.cwd, deps.env);
+    const file = settingsFile(harness, flags.global ?? false, deps.cwd, deps.env, deps.hookPlatform);
     if (harness === 'opencode') {
         try {
             return withTargetFileLock(file, () => {
@@ -2515,9 +2630,7 @@ function setupProofPath(deps) {
         // the resolved absolute path is still a stable local identity for it.
     }
     const digest = createHash('sha256').update(projectDir).digest('hex').slice(0, 32);
-    const xdg = deps.env['XDG_STATE_HOME'];
-    const base = xdg && xdg !== '' ? xdg : path.join(os.homedir(), '.local', 'state');
-    return path.join(base, 'notifai', 'setup-proofs', `${digest}.json`);
+    return path.join(stateDir(deps.env), 'setup-proofs', `${digest}.json`);
 }
 function readSetupProof(deps) {
     const file = setupProofPath(deps);
@@ -2816,6 +2929,7 @@ async function runSetupProof(deps) {
             const observed = observedCompanionReceipt(snapshot, proof.device_id);
             if (observed) {
                 spinner?.stop(`Receipt observed from ${observed.delivery.device_name}`);
+                deps.io.out(`Companion Receipt (the app's delivery confirmation) observed from ${observed.delivery.device_name}.`);
                 return 'closed';
             }
             lastError = null;
@@ -3559,7 +3673,7 @@ function remedyLine(state) {
  * is, is each check's own call (`HookCheck`).
  */
 function hookStates(deps) {
-    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome);
+    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform);
     const active = activeHarnessSession(deps.env, deps.cwd, (deps.now ?? Date.now)());
     const config = loadLoggedConfig(deps, { cwd: deps.cwd, env: deps.env });
     const settings = {
@@ -3647,12 +3761,12 @@ function hookStates(deps) {
  *     hashes into `trusted_hash`, and an untrusted handler is simply not run.
  *   - Everything else blocks its turn and needs a ceiling above the wait.
  */
-function stopShapeProblems(installation) {
+function stopShapeProblems(installation, platform = process.platform) {
     if (installation.harness === 'codex')
         return [];
     const problems = [];
     for (const handler of installation.handlers.filter((entry) => handlerEvent(entry.command) === 'stop')) {
-        if (installation.harness === 'claude-code') {
+        if (installation.harness === 'claude-code' && platform !== 'win32') {
             if (handler.async !== true) {
                 problems.push(`${installation.file} declares a blocking Stop handler; the Claude Code wake route needs \`async: true\` so the turn ends while the waiter runs`);
             }
@@ -3669,7 +3783,7 @@ function stopShapeProblems(installation) {
 }
 function hookChecks(deps) {
     const checks = [];
-    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome);
+    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform);
     // Not having hooks is a setup someone chose, not a fault: `send` works
     // without them. A setup that cannot work is what deserves to go red.
     if (installations.length === 0) {
@@ -3766,7 +3880,7 @@ function hookChecks(deps) {
             : `${stale.join('; ')} — rerun \`notifai hooks install\` to drop ${stale.length === 1 ? 'it' : 'them'}`,
     });
     const adapterProblems = installations.flatMap((installation) => (installation.problems ?? []).map((problem) => `${installation.file}: ${problem}`));
-    const sharedAdapter = inspectHookAdapter(deps.hookAdapterHome);
+    const sharedAdapter = inspectHookAdapter(deps.hookAdapterHome, deps.hookPlatform);
     adapterProblems.push(...sharedAdapter.problems);
     if (adapterProblems.length > 0) {
         checks.push({
@@ -3794,7 +3908,7 @@ function hookChecks(deps) {
                 },
             }),
     });
-    const shapeProblems = installations.flatMap((installation) => stopShapeProblems(installation).map((problem) => `${problem} — run \`notifai hooks install --harness ${installation.harness}${installation.global ? ' --global' : ''}\``));
+    const shapeProblems = installations.flatMap((installation) => stopShapeProblems(installation, deps.hookPlatform).map((problem) => `${problem} — run \`notifai hooks install --harness ${installation.harness}${installation.global ? ' --global' : ''}\``));
     checks.push({
         name: 'hooks (stop shape)',
         ok: shapeProblems.length === 0,
@@ -3963,7 +4077,7 @@ function wakeRouteCheck(deps, active, activeInstallations) {
     if (active.harness === 'claude-code') {
         const readiness = inspectClaudeInbox({
             pid: deps.claudeSourcePid ?? claudeSessionPid(deps.env),
-            platform: process.platform,
+            platform: deps.hookPlatform ?? process.platform,
             readDescriptor: deps.claudeWake?.readDescriptor ?? systemClaudeWakeAdapters(deps.env).readDescriptor,
             socketExists: (socketPath) => existsSync(socketPath),
         });
@@ -3978,7 +4092,7 @@ function wakeRouteCheck(deps, active, activeInstallations) {
     }
     if (active.harness === 'codex') {
         const readiness = inspectCodexResume(deps.env, {
-            platform: process.platform,
+            platform: deps.hookPlatform ?? process.platform,
             directoryExists: (directory) => existsSync(directory),
         });
         return {
@@ -4133,24 +4247,7 @@ export function realIo(env = process.env) {
                     return log.error(message);
             }
         },
-        openUrl: (url) => {
-            try {
-                if (process.platform === 'darwin') {
-                    spawn('open', [url], { stdio: 'ignore', detached: true }).unref();
-                }
-                else if (process.platform === 'win32') {
-                    // `start` is a cmd builtin; spawn('start', …) cannot work on Windows.
-                    // Empty title argument keeps URLs with special characters intact.
-                    spawn('cmd', ['/c', 'start', '', url], { stdio: 'ignore', detached: true }).unref();
-                }
-                else {
-                    spawn('xdg-open', [url], { stdio: 'ignore', detached: true }).unref();
-                }
-            }
-            catch {
-                // Browser opening is best-effort; the URL is printed anyway.
-            }
-        },
+        openUrl,
     };
 }
 //# sourceMappingURL=commands.js.map