dominds 1.23.0 → 1.23.2

package/dist/recovery/proceeding-drive.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recoverProceedingDrivesAfterRestart = recoverProceedingDrivesAfterRestart;
+const dialog_display_state_1 = require("../dialog-display-state");
+const dialog_global_registry_1 = require("../dialog-global-registry");
+const dialog_instance_registry_1 = require("../dialog-instance-registry");
+const kernel_driver_1 = require("../llm/kernel-driver");
+const log_1 = require("../log");
+const persistence_1 = require("../persistence");
+const persistence_errors_1 = require("../persistence-errors");
+const log = (0, log_1.createLogger)('proceeding-drive-recovery');
+async function restoreDialogForProceedingDrive(dialogId) {
+    const mainDialog = await (0, dialog_instance_registry_1.getOrRestoreMainDialog)(dialogId.rootId, 'running');
+    if (!mainDialog) {
+        return undefined;
+    }
+    if (dialogId.selfId === dialogId.rootId) {
+        return mainDialog;
+    }
+    return await (0, dialog_instance_registry_1.ensureDialogLoaded)(mainDialog, dialogId, 'running');
+}
+async function recoverRootProceedingDrive(dialog) {
+    await persistence_1.DialogPersistence.setNeedsDrive(dialog.id, true, dialog.status);
+    dialog_global_registry_1.globalDialogRegistry.markNeedsDrive(dialog.id.rootId, {
+        source: 'restart_recovery',
+        reason: 'persisted_drive_in_progress',
+    });
+}
+async function recoverSideDialogProceedingDrive(dialog) {
+    await (0, kernel_driver_1.driveDialogStream)(dialog, undefined, true, {
+        source: 'kernel_driver_sideDialog_resume',
+        reason: 'restart_recovery:persisted_drive_in_progress',
+        resumeInProgressGeneration: true,
+    });
+}
+async function recoverProceedingDrivesAfterRestart() {
+    const dialogIds = await persistence_1.DialogPersistence.listAllDialogIds('running');
+    const recoveredRootIds = new Set();
+    const recoveredDialogKeys = new Set();
+    for (const dialogId of dialogIds) {
+        let latest;
+        try {
+            latest = await persistence_1.DialogPersistence.loadDialogLatest(dialogId, 'running');
+        }
+        catch (error) {
+            if (!(0, persistence_errors_1.findDomindsPersistenceFileError)(error)) {
+                throw error;
+            }
+            log.warn('Skipping malformed dialog during proceeding-drive restart recovery', error, {
+                dialogId: dialogId.valueOf(),
+            });
+            continue;
+        }
+        if (!(0, dialog_display_state_1.isRecoverableGeneratingLatest)(latest)) {
+            continue;
+        }
+        try {
+            const dialog = await restoreDialogForProceedingDrive(dialogId);
+            if (!dialog) {
+                log.warn('Proceeding-drive restart recovery could not restore dialog', undefined, {
+                    rootId: dialogId.rootId,
+                    selfId: dialogId.selfId,
+                });
+                continue;
+            }
+            const dialogKey = dialog.id.key();
+            if (recoveredDialogKeys.has(dialogKey)) {
+                continue;
+            }
+            recoveredDialogKeys.add(dialogKey);
+            if (dialog.id.selfId === dialog.id.rootId) {
+                if (recoveredRootIds.has(dialog.id.rootId)) {
+                    continue;
+                }
+                recoveredRootIds.add(dialog.id.rootId);
+                await recoverRootProceedingDrive(dialog);
+            }
+            else {
+                await recoverSideDialogProceedingDrive(dialog);
+            }
+        }
+        catch (error) {
+            log.error('Failed to recover proceeding drive after restart', error, {
+                rootId: dialogId.rootId,
+                selfId: dialogId.selfId,
+            });
+        }
+    }
+}

package/dist/runtime/driver-messages.js

@@ -407,7 +407,7 @@ function formatAgentFacingContextHealthV3RemediationGuide(language, args) {
                 '',
                 '操作：',
                 '- 优先新增差遣牒章节保存讨论细节：do_mind({ "category": "<category>", "selector": "<selector>", "content": "..." })',
-                '- 只有在确实需要改写已有章节、且已对照当前差遣牒内容完成合并并带上 `previous_content_hash` 时，才更新：change_mind({"selector":"<selector>","content":"...","previous_content_hash":"sha256:..."})',
+                '- 只有在确实需要改写已有章节、且已对照当前差遣牒内容完成合并时，才先调用 recall_taskdoc({"selector":"<selector>"}) 取得 content_hash，再更新：change_mind({"selector":"<selector>","content":"...","previous_content_hash":"crc32:..."})',
                 '- 优先新增过桥提醒项：add_reminder({ "content": "..." })',
                 '- 只有在确实能就地复用现有提醒项、且不会额外增加当前程认知负担时，才更新：update_reminder({ "reminder_id": "<现有 reminder_id>", "content": "..." })',
             ].join('\n');
@@ -443,7 +443,7 @@ function formatAgentFacingContextHealthV3RemediationGuide(language, args) {
             '',
             '操作：',
             '- 优先新增差遣牒章节保存讨论细节：do_mind({ "category": "<category>", "selector": "<selector>", "content": "..." })',
-            '- 只有在确实需要改写已有章节、且已对照当前差遣牒内容完成合并并带上 `previous_content_hash` 时，才更新：change_mind({"selector":"<selector>","content":"...","previous_content_hash":"sha256:..."})',
+            '- 只有在确实需要改写已有章节、且已对照当前差遣牒内容完成合并时，才先调用 recall_taskdoc({"selector":"<selector>"}) 取得 content_hash，再更新：change_mind({"selector":"<selector>","content":"...","previous_content_hash":"crc32:..."})',
             '- 优先新增过桥提醒项：add_reminder({ "content": "..." })',
             '- 只有在确实能就地复用现有提醒项、且不会额外增加当前程认知负担时，才更新：update_reminder({ "reminder_id": "<现有 reminder_id>", "content": "..." })',
             '- clear_mind({})',
@@ -484,7 +484,7 @@ function formatAgentFacingContextHealthV3RemediationGuide(language, args) {
             '',
             'Operations:',
             '- Prefer creating a new Taskdoc section for discussion details: do_mind({ "category": "<category>", "selector": "<selector>", "content": "..." })',
-            '- Only update when an existing section truly needs rewriting and you have merged against the current Taskdoc content and can provide `previous_content_hash`: change_mind({"selector":"<selector>","content":"...","previous_content_hash":"sha256:..."})',
+            '- Only update when an existing section truly needs rewriting and you have merged against the current Taskdoc content: first call recall_taskdoc({"selector":"<selector>"}) for content_hash, then change_mind({"selector":"<selector>","content":"...","previous_content_hash":"crc32:..."})',
             '- Prefer adding a bridge reminder first: add_reminder({ "content": "..." })',
             '- Only if an existing reminder is clearly the right place, and updating it would not add extra cognitive load in the current course: update_reminder({ "reminder_id": "<existing reminder_id>", "content": "..." })',
         ].join('\n');
@@ -520,7 +520,7 @@ function formatAgentFacingContextHealthV3RemediationGuide(language, args) {
         '',
         'Operations:',
         '- Prefer creating a new Taskdoc section for discussion details: do_mind({ "category": "<category>", "selector": "<selector>", "content": "..." })',
-        '- Only update when an existing section truly needs rewriting and you have merged against the current Taskdoc content and can provide `previous_content_hash`: change_mind({"selector":"<selector>","content":"...","previous_content_hash":"sha256:..."})',
+        '- Only update when an existing section truly needs rewriting and you have merged against the current Taskdoc content: first call recall_taskdoc({"selector":"<selector>"}) for content_hash, then change_mind({"selector":"<selector>","content":"...","previous_content_hash":"crc32:..."})',
         '- Prefer adding a bridge reminder first: add_reminder({ "content": "..." })',
         '- Only if an existing reminder is clearly the right place, and updating it would not add extra cognitive load in the current course: update_reminder({ "reminder_id": "<existing reminder_id>", "content": "..." })',
         '- clear_mind({})',

package/dist/runtime/reply-prompt-copy.d.ts

@@ -2,6 +2,10 @@ import type { LanguageCode } from '@longrun-ai/kernel/types/language';
 import type { TellaskReplyDirective } from '@longrun-ai/kernel/types/storage';
 export declare const ACTIVE_REPLY_TOOL_PREFIX_EN = "[Dominds active reply tool]";
 export declare const ACTIVE_REPLY_TOOL_PREFIX_ZH = "[Dominds \u5F53\u524D\u56DE\u590D\u5DE5\u5177]";
+export declare const NO_ACTIVE_REPLY_PREFIX_EN = "[Dominds no active inter-dialog reply]";
+export declare const NO_ACTIVE_REPLY_PREFIX_ZH = "[Dominds \u5F53\u524D\u65E0\u8DE8\u5BF9\u8BDD\u56DE\u590D\u4E49\u52A1]";
+export declare const REPLY_TOOL_REMINDER_PREFIX_EN = "[Dominds replyTellask required]";
+export declare const REPLY_TOOL_REMINDER_PREFIX_ZH = "[Dominds \u5FC5\u987B\u8C03\u7528\u56DE\u590D\u5DE5\u5177]";
 export declare const REPLY_REASSERTION_PREFIX_EN = "[Dominds long-line reminder]";
 export declare const REPLY_REASSERTION_PREFIX_ZH = "[Dominds \u957F\u7EBF\u63D0\u9192]";
 export declare const REPLY_SUPPRESSION_PREFIX_EN = "[Dominds handle this interjection first]";
@@ -30,8 +34,8 @@ export declare function buildReplyObligationReassertionText(args: ReplyObligatio
 export declare function buildReplyToolReminderText(args: {
     language: LanguageCode;
     directive: TellaskReplyDirective;
-    prefix: string;
     replyTargetAgentId?: string;
 }): string;
+export declare function isReplyToolReminderPromptContent(content: string): boolean;
 export declare function isStandaloneRuntimeGuidePromptContent(content: string): boolean;
 export {};

package/dist/runtime/reply-prompt-copy.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REPLY_SUPPRESSION_PREFIX_ZH = exports.REPLY_SUPPRESSION_PREFIX_EN = exports.REPLY_REASSERTION_PREFIX_ZH = exports.REPLY_REASSERTION_PREFIX_EN = exports.ACTIVE_REPLY_TOOL_PREFIX_ZH = exports.ACTIVE_REPLY_TOOL_PREFIX_EN = void 0;
+exports.REPLY_SUPPRESSION_PREFIX_ZH = exports.REPLY_SUPPRESSION_PREFIX_EN = exports.REPLY_REASSERTION_PREFIX_ZH = exports.REPLY_REASSERTION_PREFIX_EN = exports.REPLY_TOOL_REMINDER_PREFIX_ZH = exports.REPLY_TOOL_REMINDER_PREFIX_EN = exports.NO_ACTIVE_REPLY_PREFIX_ZH = exports.NO_ACTIVE_REPLY_PREFIX_EN = exports.ACTIVE_REPLY_TOOL_PREFIX_ZH = exports.ACTIVE_REPLY_TOOL_PREFIX_EN = void 0;
 exports.buildActiveReplyToolNote = buildActiveReplyToolNote;
 exports.buildActiveReplyObligationContextText = buildActiveReplyObligationContextText;
 exports.buildSideDialogCompletionRule = buildSideDialogCompletionRule;
@@ -8,10 +8,15 @@ exports.buildSideDialogRoleHeaderCopy = buildSideDialogRoleHeaderCopy;
 exports.buildReplyObligationSuppressionGuideText = buildReplyObligationSuppressionGuideText;
 exports.buildReplyObligationReassertionText = buildReplyObligationReassertionText;
 exports.buildReplyToolReminderText = buildReplyToolReminderText;
+exports.isReplyToolReminderPromptContent = isReplyToolReminderPromptContent;
 exports.isStandaloneRuntimeGuidePromptContent = isStandaloneRuntimeGuidePromptContent;
 const tellask_labels_1 = require("./tellask-labels");
 exports.ACTIVE_REPLY_TOOL_PREFIX_EN = '[Dominds active reply tool]';
 exports.ACTIVE_REPLY_TOOL_PREFIX_ZH = '[Dominds 当前回复工具]';
+exports.NO_ACTIVE_REPLY_PREFIX_EN = '[Dominds no active inter-dialog reply]';
+exports.NO_ACTIVE_REPLY_PREFIX_ZH = '[Dominds 当前无跨对话回复义务]';
+exports.REPLY_TOOL_REMINDER_PREFIX_EN = '[Dominds replyTellask required]';
+exports.REPLY_TOOL_REMINDER_PREFIX_ZH = '[Dominds 必须调用回复工具]';
 exports.REPLY_REASSERTION_PREFIX_EN = '[Dominds long-line reminder]';
 exports.REPLY_REASSERTION_PREFIX_ZH = '[Dominds 长线提醒]';
 exports.REPLY_SUPPRESSION_PREFIX_EN = '[Dominds handle this interjection first]';
@@ -139,9 +144,10 @@ function buildReplyObligationReassertionText(args) {
         ].join('\n');
 }
 function buildReplyToolReminderText(args) {
+    const prefix = args.language === 'zh' ? exports.REPLY_TOOL_REMINDER_PREFIX_ZH : exports.REPLY_TOOL_REMINDER_PREFIX_EN;
     return args.language === 'zh'
         ? [
-            args.prefix,
+            prefix,
             '',
             `你刚才已经写了正文，但还没调用 \`${args.directive.expectedReplyCallName}\`。`,
             '',
@@ -149,7 +155,7 @@ function buildReplyToolReminderText(args) {
             '如果你再次直接输出最终消息而仍不调用该工具，运行时会按 direct-reply fallback 投递，并在 UI/传递正文中明确标注。',
         ].join('\n')
         : [
-            args.prefix,
+            prefix,
             '',
             `You already wrote the reply body, but you still have not called \`${args.directive.expectedReplyCallName}\`.`,
             '',
@@ -157,6 +163,10 @@ function buildReplyToolReminderText(args) {
             'If you still emit a plain final message without the tool, runtime will deliver it via direct-reply fallback and label that path explicitly in UI and transfer text.',
         ].join('\n');
 }
+function isReplyToolReminderPromptContent(content) {
+    return (content.startsWith(exports.REPLY_TOOL_REMINDER_PREFIX_ZH) ||
+        content.startsWith(exports.REPLY_TOOL_REMINDER_PREFIX_EN));
+}
 function isStandaloneRuntimeGuidePromptContent(content) {
     return (content.startsWith(exports.REPLY_REASSERTION_PREFIX_ZH) ||
         content.startsWith(exports.REPLY_REASSERTION_PREFIX_EN) ||

package/dist/server.d.ts

@@ -7,6 +7,7 @@ export type ServerOptions = {
     host?: string;
     mode?: 'dev' | 'prod';
     startBackendDriver?: boolean;
+    returnAfterListen?: boolean;
     strictPort?: boolean;
     portAutoDirection?: WebuiPortAutoDirection;
 };

package/dist/server.js

@@ -50,6 +50,7 @@ const dialog_display_state_1 = require("./dialog-display-state");
 const kernel_driver_1 = require("./llm/kernel-driver");
 const log_1 = require("./log");
 const supervisor_1 = require("./mcp/supervisor");
+const proceeding_drive_1 = require("./recovery/proceeding-drive");
 const reply_special_1 = require("./recovery/reply-special");
 const work_language_1 = require("./runtime/work-language");
 const auth_1 = require("./server/auth");
@@ -113,12 +114,53 @@ function parseArgs(argv) {
     }
     return out;
 }
+function attachPostListenStartupCancellation(httpServer, token) {
+    const originalStop = httpServer.stop.bind(httpServer);
+    httpServer.stop = async () => {
+        token.canceled = true;
+        await originalStop();
+    };
+    return httpServer;
+}
 function getErrnoCode(error) {
     if (!(error instanceof Error))
         return undefined;
     const withCode = error;
     return typeof withCode.code === 'string' ? withCode.code : undefined;
 }
+async function runPostListenStartup(params) {
+    await new Promise((resolve) => {
+        setImmediate(resolve);
+    });
+    if (params.token.canceled)
+        return;
+    // Apps host is optional for server boot: app failures must stay loud, but they must not block WebUI startup.
+    try {
+        await (0, runtime_1.initAppsRuntime)({ rtwsRootAbs: params.rtwsRootAbs, kernel: params.kernel });
+    }
+    catch (error) {
+        if (params.token.canceled)
+            return;
+        log.warn('Apps runtime initialization failed during server startup; continuing without app runtime capabilities until the app issue is fixed', error instanceof Error ? error : new Error(String(error)));
+    }
+    if (params.token.canceled)
+        return;
+    // Crash recovery: persisted in-flight generations are re-queued; stale non-generating queues
+    // are surfaced as blocked/resumable from durable facts.
+    await (0, dialog_display_state_1.reconcileDisplayStatesAfterRestart)();
+    if (params.token.canceled)
+        return;
+    await (0, proceeding_drive_1.recoverProceedingDrivesAfterRestart)();
+    if (params.token.canceled)
+        return;
+    await (0, reply_special_1.recoverPendingReplyTellaskCallsAfterRestart)();
+    if (params.token.canceled)
+        return;
+    // Tests may opt out so the process can shut down cleanly without a driver stop API.
+    if (params.startBackendDriver) {
+        void (0, kernel_driver_1.runBackendDriver)();
+    }
+}
 async function startServer(opts = {}) {
     const { language: resolvedLanguage, source } = (0, work_language_1.resolveWorkLanguage)({ env: process.env });
     (0, work_language_1.setWorkLanguage)(resolvedLanguage);
@@ -129,6 +171,7 @@ async function startServer(opts = {}) {
     const portAutoDirection = opts.portAutoDirection ?? 'down';
     const host = opts.host || '127.0.0.1';
     const startBackendDriver = opts.startBackendDriver ?? true;
+    const returnAfterListen = opts.returnAfterListen === true;
     const portCandidates = (0, port_selection_1.buildWebuiPortCandidates)({
         preferredPort,
         strictPort,
@@ -182,37 +225,48 @@ async function startServer(opts = {}) {
     if (!strictPort && boundPort !== preferredPort) {
         log.warn(`WebUI preferred port ${preferredPort} was unavailable; listening on ${boundPort}`);
     }
+    const postListenStartupToken = { canceled: false };
+    const httpServer = attachPostListenStartupCancellation(startedCore, postListenStartupToken);
     try {
+        const rtwsRootAbs = process.cwd();
         (0, dominds_self_update_1.configureDomindsSelfUpdate)({
             host,
             port: boundPort,
             mode: serverMode,
             stopServer: async () => {
-                await startedCore.stop();
+                await httpServer.stop();
             },
         });
         // MCP is best-effort: startup must not be blocked by MCP config/server issues.
-        (0, supervisor_1.startMcpSupervisor)();
-        // Apps host is optional for server boot: app failures must stay loud, but they must not block WebUI startup.
         try {
-            await (0, runtime_1.initAppsRuntime)({ rtwsRootAbs: process.cwd(), kernel: { host, port: boundPort } });
+            (0, supervisor_1.startMcpSupervisor)();
         }
         catch (error) {
-            log.warn('Apps runtime initialization failed during server startup; continuing without app runtime capabilities until the app issue is fixed', error instanceof Error ? error : new Error(String(error)));
+            log.warn('MCP supervisor startup failed during server startup; continuing without MCP runtime capabilities until the MCP issue is fixed', error instanceof Error ? error : new Error(String(error)));
         }
-        // Crash recovery: any dialogs left in "proceeding" state are surfaced as interrupted/resumable.
-        await (0, dialog_display_state_1.reconcileDisplayStatesAfterRestart)();
-        await (0, reply_special_1.recoverPendingReplyTellaskCallsAfterRestart)();
-        // Tests may opt out so the process can shut down cleanly without a driver stop API.
-        if (startBackendDriver) {
-            void (0, kernel_driver_1.runBackendDriver)();
+        const postListenStartup = runPostListenStartup({
+            rtwsRootAbs,
+            kernel: { host, port: boundPort },
+            startBackendDriver,
+            token: postListenStartupToken,
+        });
+        if (returnAfterListen) {
+            void postListenStartup.catch((error) => {
+                log.error('Post-listen server startup failed; WebUI remains reachable, but runtime recovery/driver startup did not complete', error instanceof Error ? error : new Error(String(error)));
+            });
+        }
+        else {
+            await postListenStartup;
         }
     }
     catch (error) {
-        await startedCore.stop();
+        if (!returnAfterListen) {
+            await httpServer.stop();
+            await (0, runtime_1.shutdownAppsRuntime)();
+        }
         throw error;
     }
-    return { httpServer: startedCore, auth, host, port: boundPort, mode };
+    return { httpServer, auth, host, port: boundPort, mode };
 }
 // Main function for CLI execution
 async function main() {
@@ -240,7 +294,7 @@ async function main() {
     const portAutoDirection = parsedPort?.portAutoDirection;
     const host = cliArgs['H'] || undefined;
     const mode = cliArgs['mode'] || undefined;
-    await startServer({ port, host, mode, strictPort, portAutoDirection });
+    await startServer({ port, host, mode, strictPort, portAutoDirection, returnAfterListen: true });
 }
 // Start server if this file is run directly
 if (require.main === module) {

package/dist/tools/cmd-runner.js

@@ -37,18 +37,13 @@ class ScrollingBuffer {
         };
     }
 }
-function sendIpc(msg) {
-    if (typeof process.send !== 'function') {
-        throw new Error('cmd_runner must be launched with an IPC channel');
-    }
-    process.send(msg);
-}
 async function flushIpc(msg) {
-    if (typeof process.send !== 'function') {
+    const send = process.send;
+    if (typeof send !== 'function') {
         throw new Error('cmd_runner must be launched with an IPC channel');
     }
     await new Promise((resolve, reject) => {
-        process.send?.(msg, (error) => {
+        send.call(process, msg, (error) => {
             if (error) {
                 reject(error);
                 return;
@@ -120,6 +115,16 @@ async function ensureSocketParentDir(endpoint) {
 function writeSocketResponse(socket, response) {
     socket.end(`${JSON.stringify(response)}\n`);
 }
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = typeof error === 'object' && error !== null ? error.code : undefined;
+        return code !== 'ESRCH';
+    }
+}
 async function main() {
     const initMessage = await new Promise((resolve, reject) => {
         const timeout = setTimeout(() => {
@@ -139,8 +144,12 @@ async function main() {
     if (typeof daemonPid !== 'number') {
         throw new Error('cmd_runner failed to spawn daemon command: missing pid');
     }
+    const stdout = childProcess.stdout;
+    const stderr = childProcess.stderr;
+    if (stdout === null || stderr === null) {
+        throw new Error('cmd_runner failed to spawn daemon command with piped stdout/stderr');
+    }
     const endpoint = (0, cmd_runner_protocol_1.getCmdRunnerEndpointForDaemonPid)(daemonPid);
-    await ensureSocketParentDir(endpoint);
     const state = {
         endpoint,
         daemonPid,
@@ -157,6 +166,46 @@ async function main() {
     let server;
     let closeRequested = false;
     let timeoutHandle;
+    let initialResultSent = false;
+    const tryFlushInitialResult = async (msg) => {
+        if (initialResultSent) {
+            return false;
+        }
+        initialResultSent = true;
+        await flushIpc(msg);
+        return true;
+    };
+    const waitForObservedChildExitOrMissingPid = async (timeoutMs) => {
+        if (!state.isRunning || closeRequested || !isProcessAlive(daemonPid)) {
+            return true;
+        }
+        return await new Promise((resolve) => {
+            let settled = false;
+            let timeout;
+            let interval;
+            const finish = (exited) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeout);
+                clearInterval(interval);
+                childProcess.off('close', onClose);
+                resolve(exited || !state.isRunning || closeRequested || !isProcessAlive(daemonPid));
+            };
+            const onClose = () => {
+                finish(true);
+            };
+            timeout = setTimeout(() => {
+                finish(false);
+            }, timeoutMs);
+            interval = setInterval(() => {
+                if (!isProcessAlive(daemonPid)) {
+                    finish(true);
+                }
+            }, 25);
+            childProcess.once('close', onClose);
+        });
+    };
     const closeServerAndExit = (code) => {
         if (closeRequested) {
             return;
@@ -204,8 +253,8 @@ async function main() {
         state.exitCode = code;
         state.exitSignal = signal;
         void (async () => {
-            if (state.daemonCommandLine === null) {
-                await flushIpc({
+            if (state.daemonCommandLine === null && !initialResultSent) {
+                await tryFlushInitialResult({
                     type: 'completed',
                     exitCode: code,
                     exitSignal: signal,
@@ -222,7 +271,7 @@ async function main() {
         if (timeoutHandle) {
             clearTimeout(timeoutHandle);
         }
-        void flushIpc({
+        void tryFlushInitialResult({
             type: 'failed',
             errorText: error.message,
         })
@@ -231,12 +280,16 @@ async function main() {
             closeServerAndExit(1);
         });
     });
-    childProcess.stdout?.on('data', (data) => {
+    stdout.on('data', (data) => {
         state.stdout.addText(data.toString());
     });
-    childProcess.stderr?.on('data', (data) => {
+    stderr.on('data', (data) => {
         state.stderr.addText(data.toString());
     });
+    await ensureSocketParentDir(endpoint);
+    if (closeRequested) {
+        return;
+    }
     server = node_net_1.default.createServer((socket) => {
         socket.setEncoding('utf8');
         let buffer = '';
@@ -309,6 +362,9 @@ async function main() {
                 return;
             }
             if (daemonCommandLine === undefined || daemonCommandLine.trim() === '') {
+                if (await waitForObservedChildExitOrMissingPid(250)) {
+                    return;
+                }
                 try {
                     process.kill(daemonPid, 'SIGTERM');
                 }
@@ -318,7 +374,7 @@ async function main() {
                 if (!state.isRunning) {
                     return;
                 }
-                sendIpc({
+                await tryFlushInitialResult({
                     type: 'failed',
                     errorText: `failed to capture daemon command line from OS for pid ${String(daemonPid)}`,
                 });
@@ -328,7 +384,7 @@ async function main() {
                 return;
             }
             state.daemonCommandLine = daemonCommandLine;
-            sendIpc({
+            await tryFlushInitialResult({
                 type: 'daemonized',
                 daemonPid,
                 daemonCommandLine,
@@ -339,7 +395,10 @@ async function main() {
                 startTime: state.startTime,
             });
         })().catch((error) => {
-            sendIpc({
+            if (initialResultSent) {
+                return;
+            }
+            void tryFlushInitialResult({
                 type: 'failed',
                 errorText: error instanceof Error ? error.message : String(error),
             });

package/dist/tools/ctrl.d.ts

@@ -17,7 +17,7 @@
  * - change_mind: Main Dialog only; update a `.tsk/` Taskdoc section without starting a new course
  * - mind_more: Main Dialog only; append entries to a `.tsk/` Taskdoc section without starting a new course
  * - never_mind: Main Dialog only; delete a `.tsk/` Taskdoc section file without starting a new course
- * - recall_taskdoc: Read a Taskdoc section from `*.tsk/` by (category, selector)
+ * - recall_taskdoc: Read a Taskdoc section from `*.tsk/` by selector and optional category
  *
  * USAGE CONTEXT:
  * Can both be triggered by an agent autonomously, or by human with role='user' msg,