dominds 1.12.0 → 1.12.1

package/dist/dialog.js

@@ -64,6 +64,9 @@ function getGlobalDialogMutex(dialogId) {
     globalDialogMutexes.set(key, created);
     return created;
 }
+function compareVisibleReminderTargetOrder(a, b) {
+    return (0, tool_1.compareReminderDisplayOrder)(a.reminder, b.reminder);
+}
 /**
  * Abstract base class for all dialog types.
  * Contains common properties and methods shared between RootDialog and SubDialog.
@@ -394,6 +397,9 @@ class Dialog {
                 agentId: this.agentId,
             });
         }
+        // Visible reminders are always merged into a single newest-first stream regardless of
+        // storage scope, so UI rendering, reminder injection, and reminder-id targeting agree.
+        targets.sort(compareVisibleReminderTargetOrder);
         return targets;
     }
     async listVisibleReminders() {
@@ -493,11 +499,13 @@ class Dialog {
             ...this.reminders.map((reminder) => (0, tool_1.cloneReminder)(reminder)),
             ...sharedReminders,
         ];
+        visibleReminders.sort(tool_1.compareReminderDisplayOrder);
         const reminders = visibleReminders.map((r) => ({
             content: r.content,
             meta: r.meta,
             reminder_id: r.id,
             echoback: (0, tool_1.reminderEchoBackEnabled)(r),
+            scope: r.scope,
         }));
         // Emit full_reminders_update event with complete reminder list including metadata
         const fullRemindersEvt = {

package/dist/llm/gen/mock.d.ts

@@ -49,7 +49,7 @@
  *
  * // Turn 2: Tool error (func_result_msg with role='tool'), LLM self-corrects
  * # docs/e2e-story-test/reminders.md: Tool syntax error recovery
- * - message: "Error: Invalid args. Use: add_reminder({ content: string, position: number }) (position=0 means append)."
+ * - message: "Error: Invalid args. Use: add_reminder({ content: string, position?: number, scope?: \"dialog\" | \"personal\" }) (omit position to append)."
  *   role: "tool"
  *   response: "Call the function tool `add_reminder` with {\"content\":\"Goals...\",\"position\":1}"
  */

package/dist/llm/gen/mock.js

@@ -50,7 +50,7 @@
  *
  * // Turn 2: Tool error (func_result_msg with role='tool'), LLM self-corrects
  * # docs/e2e-story-test/reminders.md: Tool syntax error recovery
- * - message: "Error: Invalid args. Use: add_reminder({ content: string, position: number }) (position=0 means append)."
+ * - message: "Error: Invalid args. Use: add_reminder({ content: string, position?: number, scope?: \"dialog\" | \"personal\" }) (omit position to append)."
  *   role: "tool"
  *   response: "Call the function tool `add_reminder` with {\"content\":\"Goals...\",\"position\":1}"
  */

package/dist/llm/kernel-driver/drive.js

@@ -505,6 +505,7 @@ async function renderRemindersForContext(dlg) {
             role: 'assistant',
             content: (0, driver_messages_1.formatReminderItemGuide)(language, reminder.id, reminder.content, {
                 meta: reminder.meta,
+                scope: reminder.scope,
             }),
         });
     }

package/dist/priming.js

@@ -176,8 +176,11 @@ function parseReminderSnapshots(frontmatter) {
             throw new Error(`${context}.echoback must be a boolean when provided`);
         }
         const scope = item['scope'];
-        if (scope !== undefined && scope !== 'dialog' && scope !== 'agent_shared') {
-            throw new Error(`${context}.scope must be "dialog" or "agent_shared" when provided`);
+        if (scope !== undefined &&
+            scope !== 'dialog' &&
+            scope !== 'personal' &&
+            scope !== 'agent_shared') {
+            throw new Error(`${context}.scope must be "dialog", "personal", or "agent_shared" when provided`);
         }
         const createdAt = item['createdAt'];
         if (createdAt !== undefined && typeof createdAt !== 'string') {
@@ -190,7 +193,7 @@ function parseReminderSnapshots(frontmatter) {
             ownerName: typeof ownerName === 'string' ? ownerName.trim() : undefined,
             meta,
             echoback,
-            scope: scope === 'dialog' || scope === 'agent_shared' ? scope : undefined,
+            scope: scope === 'dialog' || scope === 'personal' || scope === 'agent_shared' ? scope : undefined,
             createdAt: typeof createdAt === 'string' ? createdAt : undefined,
             priority,
         });

package/dist/runtime/driver-messages.d.ts

@@ -11,6 +11,7 @@ export declare function formatNewCourseStartPrompt(language: LanguageCode, args:
 export declare function formatDiligenceAutoContinuePrompt(language: LanguageCode, diligenceText: string): string;
 export declare function formatReminderItemGuide(language: LanguageCode, reminderId: string, content: string, options?: {
     meta?: unknown;
+    scope?: 'dialog' | 'personal' | 'agent_shared';
 }): string;
 export declare function formatQ4HDiligencePushBudgetExhausted(language: LanguageCode, args: {
     maxInjectCount: number;

package/dist/runtime/driver-messages.js

@@ -156,6 +156,7 @@ function formatReminderItemGuide(language, reminderId, content, options) {
     // `options.meta` is persisted JSON coming from tools. Runtime shape checks are unavoidable here
     // to keep reminder ownership/management loosely coupled and extensible.
     const metaValue = options && 'meta' in options ? options.meta : undefined;
+    const scope = options?.scope;
     const isContinuationPackageReminder = isRecord(metaValue) && metaValue['kind'] === 'continuation_package';
     const isPendingTellaskReminder = isRecord(metaValue) && metaValue['kind'] === 'pending_tellask';
     const pendingTellaskCount = isPendingTellaskReminder && typeof metaValue['pendingCount'] === 'number'
@@ -235,11 +236,15 @@ function formatReminderItemGuide(language, reminderId, content, options) {
             ].join('\n');
         }
         return [
-            `提醒项 [${reminderId}]`,
+            `提醒项 [${reminderId}]${scope === 'personal' ? '（个人范围）' : ''}`,
             '',
-            '这是我给自己的显眼提示，用于保留当前对话里容易丢的工作信息；我不把它自动当成系统下发的下一步动作。',
+            scope === 'personal'
+                ? '这是我给自己的个人范围显眼提示；在所有由我主理的后续对话里都会看到它。我不把它自动当成系统下发的下一步动作。'
+                : '这是我给自己的显眼提示，用于保留当前对话里容易丢的工作信息；我不把它自动当成系统下发的下一步动作。',
             '',
-            '我应保持简洁、及时更新；不再需要时就删除。若后续准备换程，也可以把它整理成接续包。',
+            scope === 'personal'
+                ? '我应保持简洁、及时更新；不再需要时就删除。若它只对当前对话有效，应改写成 dialog 范围提醒而不是长期堆在个人范围里。'
+                : '我应保持简洁、及时更新；不再需要时就删除。若后续准备换程，也可以把它整理成接续包。',
             '',
             `如果我要更新这条提醒项，可执行：update_reminder({ "reminder_id": "${reminderId}", "content": "..." })`,
             deleteInstruction,
@@ -283,11 +288,15 @@ ${deleteInstruction}
 ---
 ${content}`;
     }
-    return `REMINDER [${reminderId}]
+    return `REMINDER [${reminderId}]${scope === 'personal' ? ' (PERSONAL SCOPE)' : ''}
 
-This is my conspicuous self-reminder for easy-to-lose work details in the current dialog. I do not treat it as an automatically assigned next action.
+${scope === 'personal'
+        ? 'This is my conspicuous personal-scope reminder. I will keep seeing it in all later dialogs I lead, and I do not treat it as an automatically assigned next action.'
+        : 'This is my conspicuous self-reminder for easy-to-lose work details in the current dialog. I do not treat it as an automatically assigned next action.'}
 
-I should keep it concise, refresh it when needed, and delete it when obsolete. If I am preparing a new course, I can also rewrite it into a continuation package.
+${scope === 'personal'
+        ? 'I should keep it concise, refresh it when needed, and delete it when obsolete. If it is only useful for the current dialog, I should rewrite it into dialog scope instead of letting personal scope accumulate noise.'
+        : 'I should keep it concise, refresh it when needed, and delete it when obsolete. If I am preparing a new course, I can also rewrite it into a continuation package.'}
 
 If I need to update this reminder, run: update_reminder({ "reminder_id": "${reminderId}", "content": "..." })
 ${deleteInstruction}

package/dist/shared-reminders.js

@@ -96,14 +96,6 @@ function materializeStoredReminder(snapshot) {
 function cloneReminderList(reminders) {
     return reminders.map((reminder) => (0, tool_1.cloneReminder)(reminder));
 }
-function compareSharedReminders(a, b) {
-    const aCreatedAt = a.createdAt ?? '';
-    const bCreatedAt = b.createdAt ?? '';
-    if (aCreatedAt !== bCreatedAt) {
-        return aCreatedAt.localeCompare(bCreatedAt);
-    }
-    return a.id.localeCompare(b.id);
-}
 async function writeReminderSnapshotFile(filePath, snapshot) {
     const json = JSON.stringify(snapshot, null, 2);
     const tempFile = `${filePath}.${process.pid}.${(0, node_crypto_1.randomUUID)()}.tmp`;
@@ -133,7 +125,7 @@ async function readSharedRemindersUnlocked(agentId) {
         const raw = await fs.readFile(path.join(dirPath, fileName), 'utf-8');
         return materializeStoredReminder(JSON.parse(raw));
     }));
-    reminders.sort(compareSharedReminders);
+    reminders.sort(tool_1.compareReminderDisplayOrder);
     return reminders;
 }
 async function writeSharedRemindersUnlocked(agentId, reminders) {

package/dist/tool.d.ts

@@ -33,7 +33,7 @@ export interface ReminderOptions {
     readonly echoback?: boolean;
     readonly scope?: ReminderScope;
 }
-export type ReminderScope = 'dialog' | 'agent_shared';
+export type ReminderScope = 'dialog' | 'personal' | 'agent_shared';
 export type ReminderPriority = 'high' | 'medium' | 'low';
 export interface Reminder extends ReminderOptions {
     readonly id: string;
@@ -58,6 +58,7 @@ export declare function materializeReminder(input: Readonly<{
     priority?: ReminderPriority;
 }>): Reminder;
 export declare function cloneReminder(reminder: Reminder): Reminder;
+export declare function compareReminderDisplayOrder(a: Reminder, b: Reminder): number;
 export declare function getReminderOwnerName(reminder: Pick<Reminder, 'owner'>): string | undefined;
 export declare function reminderOwnedBy(reminder: Reminder, owner: ReminderOwner | string): boolean;
 export type ReminderTreatment = 'drop' | 'keep' | 'update';

package/dist/tool.js

@@ -6,6 +6,7 @@ exports.reminderIsListed = reminderIsListed;
 exports.generateReminderId = generateReminderId;
 exports.materializeReminder = materializeReminder;
 exports.cloneReminder = cloneReminder;
+exports.compareReminderDisplayOrder = compareReminderDisplayOrder;
 exports.getReminderOwnerName = getReminderOwnerName;
 exports.reminderOwnedBy = reminderOwnedBy;
 exports.validateArgs = validateArgs;
@@ -54,6 +55,17 @@ function cloneReminder(reminder) {
         priority: reminder.priority,
     });
 }
+// Reminder presentation order is a framework-level concern distinct from owner semantics.
+// Keep it centralized so dialog-local reminders and agent-shared reminders stay in the same
+// newest-first order everywhere they are merged, rendered, or injected.
+function compareReminderDisplayOrder(a, b) {
+    const aCreatedAt = a.createdAt ?? '';
+    const bCreatedAt = b.createdAt ?? '';
+    if (aCreatedAt !== bCreatedAt) {
+        return bCreatedAt.localeCompare(aCreatedAt);
+    }
+    return b.id.localeCompare(a.id);
+}
 function getReminderOwnerName(reminder) {
     return reminder.owner?.name;
 }

package/dist/tools/app-reminders.js

@@ -161,6 +161,7 @@ function fallbackRenderedReminder(reminder) {
         role: 'assistant',
         content: (0, driver_messages_1.formatReminderItemGuide)(language, reminder.id, reminder.content, {
             meta: reminder.meta,
+            scope: reminder.scope,
         }),
     };
 }
@@ -171,6 +172,7 @@ async function persistAndPublishReminders(dlg) {
         meta: isRecord(reminder.meta) ? reminder.meta : undefined,
         reminder_id: reminder.id,
         echoback: (0, tool_1.reminderEchoBackEnabled)(reminder),
+        scope: reminder.scope,
     }));
     const evt = { type: 'full_reminders_update', reminders };
     (0, evt_registry_1.postDialogEvent)(dlg, evt);

package/dist/tools/ctrl.js

@@ -70,6 +70,13 @@ const work_language_1 = require("../runtime/work-language");
 const shared_reminders_1 = require("../shared-reminders");
 const tool_1 = require("../tool");
 const task_package_1 = require("../utils/task-package");
+class InvalidReminderPositionError extends Error {
+    constructor(positionHuman, totalPlusOne) {
+        super(`Invalid reminder position ${positionHuman} (max ${String(totalPlusOne)})`);
+        this.positionHuman = positionHuman;
+        this.totalPlusOne = totalPlusOne;
+    }
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -139,16 +146,41 @@ function formatManualUpdateBlockedError(language, altInstruction) {
         : `Error: This reminder cannot be edited via update_reminder. Follow instead: ${altInstruction}`;
 }
 function listListedReminderIndices(reminders) {
+    return listListedReminderIndicesBy(reminders, () => true);
+}
+function listListedReminderIndicesBy(reminders, predicate) {
     const indices = [];
     for (let index = 0; index < reminders.length; index += 1) {
         const reminder = reminders[index];
-        if (!reminder || !(0, tool_1.reminderIsListed)(reminder)) {
+        if (!reminder || !(0, tool_1.reminderIsListed)(reminder) || !predicate(reminder)) {
             continue;
         }
         indices.push(index);
     }
     return indices;
 }
+function computeReminderInsertIndex(reminders, positionValue, predicate) {
+    const listedIndices = listListedReminderIndicesBy(reminders, predicate);
+    let insertIndex = reminders.length;
+    if (positionValue === undefined) {
+        return insertIndex;
+    }
+    if (typeof positionValue !== 'number' || !Number.isInteger(positionValue)) {
+        throw new Error('invalid_add_position_format');
+    }
+    const position = positionValue - 1;
+    if (position < 0 || position > listedIndices.length) {
+        throw new InvalidReminderPositionError(String(positionValue), listedIndices.length + 1);
+    }
+    if (position < listedIndices.length) {
+        const targetIndex = listedIndices[position];
+        if (targetIndex === undefined) {
+            throw new InvalidReminderPositionError(String(positionValue), listedIndices.length + 1);
+        }
+        insertIndex = targetIndex;
+    }
+    return insertIndex;
+}
 function getContinuationPackageContextHealthLevel(snapshot) {
     if (snapshot?.kind !== 'available') {
         return undefined;
@@ -219,7 +251,8 @@ function getCtrlMessages(language) {
         return {
             invalidFormatDelete: '参数格式不对。用法：delete_reminder({ reminder_id: string })',
             reminderDoesNotExist: (reminderId) => `提醒项 '${reminderId}' 不存在。`,
-            invalidFormatAdd: '参数格式不对。用法：add_reminder({ content: string, position: number })（position=0 表示追加）',
+            invalidFormatAdd: '参数格式不对。用法：add_reminder({ content: string, position?: number, scope?: "dialog" | "personal" })（省略 position 表示追加）',
+            personalPositionUnsupported: 'personal 范围提醒当前只支持追加，不能指定 position。',
             reminderContentEmpty: '提醒内容不能为空',
             invalidReminderPosition: (positionHuman, totalPlusOne) => `位置 ${positionHuman} 无效。有效范围：1-${totalPlusOne}`,
             invalidFormatUpdate: '参数格式不对。用法：update_reminder({ reminder_id: string, content: string })',
@@ -251,7 +284,8 @@ function getCtrlMessages(language) {
     return {
         invalidFormatDelete: 'Error: Invalid args. Use: delete_reminder({ reminder_id: string })',
         reminderDoesNotExist: (reminderId) => `Error: Reminder '${reminderId}' does not exist.`,
-        invalidFormatAdd: 'Error: Invalid args. Use: add_reminder({ content: string, position: number }) (position=0 means append).',
+        invalidFormatAdd: 'Error: Invalid args. Use: add_reminder({ content: string, position?: number, scope?: "dialog" | "personal" }) (omit position to append).',
+        personalPositionUnsupported: 'Error: personal-scope reminders currently support append only; do not pass position.',
         reminderContentEmpty: 'Error: Reminder content cannot be empty',
         invalidReminderPosition: (positionHuman, totalPlusOne) => `Error: Invalid reminder position ${positionHuman}. Valid range: 1-${totalPlusOne}`,
         invalidFormatUpdate: 'Error: Invalid args. Use: update_reminder({ reminder_id: string, content: string })',
@@ -329,10 +363,10 @@ exports.deleteReminderTool = {
 exports.addReminderTool = {
     type: 'func',
     name: 'add_reminder',
-    description: 'Add a reminder, optionally inserting at a 1-based position.',
+    description: 'Add a reminder, optionally inserting at a 1-based position and choosing dialog or personal scope.',
     descriptionI18n: {
-        en: 'Add a reminder, optionally inserting at a 1-based position.',
-        zh: '添加提醒，可选指定 1-based 插入位置。',
+        en: 'Add a reminder, optionally inserting at a 1-based position and choosing dialog or personal scope.',
+        zh: '添加提醒，可选指定 1-based 插入位置，并可选择对话或个人范围。',
     },
     parameters: {
         type: 'object',
@@ -341,6 +375,11 @@ exports.addReminderTool = {
         properties: {
             content: { type: 'string', description: 'Reminder content.' },
             position: { type: 'integer', description: 'Insert position (1-based). Defaults to append.' },
+            scope: {
+                type: 'string',
+                enum: ['dialog', 'personal'],
+                description: 'Reminder visibility scope. Defaults to dialog.',
+            },
         },
     },
     argsValidation: 'dominds',
@@ -351,25 +390,16 @@ exports.addReminderTool = {
         const reminderContent = typeof contentValue === 'string' ? contentValue.trim() : '';
         if (!reminderContent)
             return t.reminderContentEmpty;
-        const listedIndices = listListedReminderIndices(dlg.reminders);
-        const positionValue = args['position'];
-        let insertIndex = dlg.reminders.length;
-        if (positionValue !== undefined) {
-            if (typeof positionValue !== 'number' || !Number.isInteger(positionValue)) {
-                return t.invalidFormatAdd;
-            }
-            const position = positionValue - 1;
-            if (position < 0 || position > listedIndices.length) {
-                return t.invalidReminderPosition(String(positionValue), listedIndices.length + 1);
-            }
-            if (position < listedIndices.length) {
-                const targetIndex = listedIndices[position];
-                if (targetIndex === undefined) {
-                    return t.invalidReminderPosition(String(positionValue), listedIndices.length + 1);
-                }
-                insertIndex = targetIndex;
-            }
+        const scopeValue = args['scope'];
+        const reminderScope = scopeValue === undefined
+            ? 'dialog'
+            : scopeValue === 'dialog' || scopeValue === 'personal'
+                ? scopeValue
+                : null;
+        if (reminderScope === null) {
+            return t.invalidFormatAdd;
         }
+        const positionValue = args['position'];
         const contextHealthLevel = getContinuationPackageContextHealthLevel(dlg.getLastContextHealth());
         const reminderMeta = contextHealthLevel === undefined
             ? undefined
@@ -377,8 +407,49 @@ exports.addReminderTool = {
                 createdBy: 'context_health',
                 contextHealthLevel,
             });
-        dlg.addReminder(reminderContent, undefined, reminderMeta, insertIndex);
-        return (0, tool_result_messages_1.formatToolActionResult)(language, 'added');
+        if (reminderScope === 'dialog') {
+            try {
+                const insertIndex = computeReminderInsertIndex(dlg.reminders, positionValue, () => true);
+                dlg.addReminder(reminderContent, undefined, reminderMeta, insertIndex, { scope: 'dialog' });
+                return (0, tool_result_messages_1.formatToolActionResult)(language, 'added');
+            }
+            catch (error) {
+                if (error instanceof InvalidReminderPositionError) {
+                    return t.invalidReminderPosition(error.positionHuman, error.totalPlusOne);
+                }
+                if (error instanceof Error && error.message === 'invalid_add_position_format') {
+                    return t.invalidFormatAdd;
+                }
+                throw error;
+            }
+        }
+        try {
+            await (0, shared_reminders_1.mutateAgentSharedReminders)(dlg.agentId, (reminders) => {
+                if (positionValue !== undefined) {
+                    throw new Error('personal_add_position_unsupported');
+                }
+                const reminder = (0, tool_1.materializeReminder)({
+                    content: reminderContent,
+                    meta: reminderMeta,
+                    scope: 'personal',
+                });
+                reminders.push(reminder);
+            });
+            dlg.touchReminders();
+            return (0, tool_result_messages_1.formatToolActionResult)(language, 'added');
+        }
+        catch (error) {
+            if (error instanceof InvalidReminderPositionError) {
+                return t.invalidReminderPosition(error.positionHuman, error.totalPlusOne);
+            }
+            if (error instanceof Error && error.message === 'invalid_add_position_format') {
+                return t.invalidFormatAdd;
+            }
+            if (error instanceof Error && error.message === 'personal_add_position_unsupported') {
+                return t.personalPositionUnsupported;
+            }
+            throw error;
+        }
     },
 };
 exports.updateReminderTool = {