dominds 1.26.1 → 1.26.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/README.zh.md +2 -0
- package/dist/cli/webui.js +14 -4
- package/dist/docs/cli-usage.md +1 -1
- package/dist/docs/cli-usage.zh.md +1 -1
- package/dist/llm/gen/mock.js +11 -3
- package/dist/llm/kernel-driver/context-health.d.ts +1 -0
- package/dist/llm/kernel-driver/context-health.js +7 -0
- package/dist/llm/kernel-driver/drive.js +23 -30
- package/dist/llm/kernel-driver/idle-reminder-wake.js +6 -2
- package/dist/llm/kernel-driver/reminder-context.d.ts +25 -0
- package/dist/llm/kernel-driver/reminder-context.js +81 -0
- package/dist/llm/kernel-driver/reply-guidance.js +10 -4
- package/dist/llm/kernel-driver/tellask-special.js +50 -35
- package/dist/mcp/supervisor.js +2 -2
- package/dist/minds/system-prompt-parts.js +30 -30
- package/dist/minds/system-prompt.js +55 -40
- package/dist/persistence.js +15 -1
- package/dist/runtime/driver-messages.d.ts +32 -7
- package/dist/runtime/driver-messages.js +279 -118
- package/dist/runtime/inter-dialog-format.js +24 -12
- package/dist/runtime/reply-prompt-copy.d.ts +8 -8
- package/dist/runtime/reply-prompt-copy.js +69 -38
- package/dist/server/certificates.js +65 -25
- package/dist/server/network-hosts.js +42 -29
- package/dist/server.js +4 -4
- package/dist/tools/mcp.js +12 -12
- package/dist/tools/prompts/control/en/index.md +2 -2
- package/dist/tools/prompts/control/en/principles.md +12 -12
- package/dist/tools/prompts/control/en/scenarios.md +5 -5
- package/dist/tools/prompts/control/en/tools.md +10 -10
- package/dist/tools/prompts/control/zh/index.md +3 -3
- package/dist/tools/prompts/control/zh/principles.md +12 -12
- package/dist/tools/prompts/control/zh/scenarios.md +7 -7
- package/dist/tools/prompts/control/zh/tools.md +11 -11
- package/dist/tools/prompts/mcp_admin/en/principles.md +4 -4
- package/dist/tools/prompts/mcp_admin/en/scenarios.md +1 -1
- package/dist/tools/prompts/mcp_admin/en/tools.md +3 -3
- package/dist/tools/prompts/mcp_admin/zh/principles.md +4 -4
- package/dist/tools/prompts/mcp_admin/zh/scenarios.md +1 -1
- package/dist/tools/prompts/mcp_admin/zh/tools.md +3 -3
- package/dist/tools/team_mgmt-mcp-manual.js +12 -12
- package/package.json +3 -2
- package/webapp/dist/assets/{_basePickBy-DUivPKf7.js → _basePickBy-DTJFxmut.js} +3 -3
- package/webapp/dist/assets/{_basePickBy-DUivPKf7.js.map → _basePickBy-DTJFxmut.js.map} +1 -1
- package/webapp/dist/assets/{_baseUniq-hcs024vD.js → _baseUniq-CVu4lo4P.js} +2 -2
- package/webapp/dist/assets/{_baseUniq-hcs024vD.js.map → _baseUniq-CVu4lo4P.js.map} +1 -1
- package/webapp/dist/assets/{arc-Dr6-FXp5.js → arc-4mEKx1Qr.js} +2 -2
- package/webapp/dist/assets/{arc-Dr6-FXp5.js.map → arc-4mEKx1Qr.js.map} +1 -1
- package/webapp/dist/assets/{architectureDiagram-2XIMDMQ5-DXqcDq4R.js → architectureDiagram-2XIMDMQ5-CmUkdSiN.js} +7 -7
- package/webapp/dist/assets/{architectureDiagram-2XIMDMQ5-DXqcDq4R.js.map → architectureDiagram-2XIMDMQ5-CmUkdSiN.js.map} +1 -1
- package/webapp/dist/assets/{blockDiagram-WCTKOSBZ-IIP6LGXS.js → blockDiagram-WCTKOSBZ-CijmZ89y.js} +7 -7
- package/webapp/dist/assets/{blockDiagram-WCTKOSBZ-IIP6LGXS.js.map → blockDiagram-WCTKOSBZ-CijmZ89y.js.map} +1 -1
- package/webapp/dist/assets/{c4Diagram-IC4MRINW-D_d3F9XD.js → c4Diagram-IC4MRINW-D0GcQMKs.js} +3 -3
- package/webapp/dist/assets/{c4Diagram-IC4MRINW-D_d3F9XD.js.map → c4Diagram-IC4MRINW-D0GcQMKs.js.map} +1 -1
- package/webapp/dist/assets/{channel-CWWjsXtU.js → channel-6pgfGez4.js} +2 -2
- package/webapp/dist/assets/{channel-CWWjsXtU.js.map → channel-6pgfGez4.js.map} +1 -1
- package/webapp/dist/assets/{chunk-4BX2VUAB-BF4yph2W.js → chunk-4BX2VUAB-BQDAaqXK.js} +2 -2
- package/webapp/dist/assets/{chunk-4BX2VUAB-BF4yph2W.js.map → chunk-4BX2VUAB-BQDAaqXK.js.map} +1 -1
- package/webapp/dist/assets/{chunk-55IACEB6-Hn3CmDYz.js → chunk-55IACEB6-DGYbZ_6j.js} +2 -2
- package/webapp/dist/assets/{chunk-55IACEB6-Hn3CmDYz.js.map → chunk-55IACEB6-DGYbZ_6j.js.map} +1 -1
- package/webapp/dist/assets/{chunk-FMBD7UC4-C05pl9Ov.js → chunk-FMBD7UC4-EVNnQ_SU.js} +2 -2
- package/webapp/dist/assets/{chunk-FMBD7UC4-C05pl9Ov.js.map → chunk-FMBD7UC4-EVNnQ_SU.js.map} +1 -1
- package/webapp/dist/assets/{chunk-JSJVCQXG-BVlq_BAS.js → chunk-JSJVCQXG-BSQe2NHw.js} +2 -2
- package/webapp/dist/assets/{chunk-JSJVCQXG-BVlq_BAS.js.map → chunk-JSJVCQXG-BSQe2NHw.js.map} +1 -1
- package/webapp/dist/assets/{chunk-KX2RTZJC-BQoaRWif.js → chunk-KX2RTZJC-I1LMYfrr.js} +2 -2
- package/webapp/dist/assets/{chunk-KX2RTZJC-BQoaRWif.js.map → chunk-KX2RTZJC-I1LMYfrr.js.map} +1 -1
- package/webapp/dist/assets/{chunk-NQ4KR5QH-0okCAXtW.js → chunk-NQ4KR5QH-C9HmN9dA.js} +4 -4
- package/webapp/dist/assets/{chunk-NQ4KR5QH-0okCAXtW.js.map → chunk-NQ4KR5QH-C9HmN9dA.js.map} +1 -1
- package/webapp/dist/assets/{chunk-QZHKN3VN-DEiprgz-.js → chunk-QZHKN3VN-73ijGXNd.js} +2 -2
- package/webapp/dist/assets/{chunk-QZHKN3VN-DEiprgz-.js.map → chunk-QZHKN3VN-73ijGXNd.js.map} +1 -1
- package/webapp/dist/assets/{chunk-WL4C6EOR-B-Xkb3lo.js → chunk-WL4C6EOR-DeVu-9ac.js} +6 -6
- package/webapp/dist/assets/{chunk-WL4C6EOR-B-Xkb3lo.js.map → chunk-WL4C6EOR-DeVu-9ac.js.map} +1 -1
- package/webapp/dist/assets/{classDiagram-VBA2DB6C-DCCQrdwF.js → classDiagram-VBA2DB6C-2HURCFLk.js} +7 -7
- package/webapp/dist/assets/{classDiagram-VBA2DB6C-DCCQrdwF.js.map → classDiagram-VBA2DB6C-2HURCFLk.js.map} +1 -1
- package/webapp/dist/assets/{classDiagram-v2-RAHNMMFH-DCCQrdwF.js → classDiagram-v2-RAHNMMFH-2HURCFLk.js} +7 -7
- package/webapp/dist/assets/{classDiagram-v2-RAHNMMFH-DCCQrdwF.js.map → classDiagram-v2-RAHNMMFH-2HURCFLk.js.map} +1 -1
- package/webapp/dist/assets/{clone-Drtik9pk.js → clone-BNPlfGMh.js} +2 -2
- package/webapp/dist/assets/{clone-Drtik9pk.js.map → clone-BNPlfGMh.js.map} +1 -1
- package/webapp/dist/assets/{cose-bilkent-S5V4N54A-BBWvHErL.js → cose-bilkent-S5V4N54A-BeoZCFA5.js} +2 -2
- package/webapp/dist/assets/{cose-bilkent-S5V4N54A-BBWvHErL.js.map → cose-bilkent-S5V4N54A-BeoZCFA5.js.map} +1 -1
- package/webapp/dist/assets/{dagre-KLK3FWXG-2qk0ikdt.js → dagre-KLK3FWXG-DYxCt50h.js} +7 -7
- package/webapp/dist/assets/{dagre-KLK3FWXG-2qk0ikdt.js.map → dagre-KLK3FWXG-DYxCt50h.js.map} +1 -1
- package/webapp/dist/assets/{diagram-E7M64L7V-C1DbHDbf.js → diagram-E7M64L7V-BWxcTI3B.js} +8 -8
- package/webapp/dist/assets/{diagram-E7M64L7V-C1DbHDbf.js.map → diagram-E7M64L7V-BWxcTI3B.js.map} +1 -1
- package/webapp/dist/assets/{diagram-IFDJBPK2-DToz8zk9.js → diagram-IFDJBPK2-BAIPE4Rn.js} +7 -7
- package/webapp/dist/assets/{diagram-IFDJBPK2-DToz8zk9.js.map → diagram-IFDJBPK2-BAIPE4Rn.js.map} +1 -1
- package/webapp/dist/assets/{diagram-P4PSJMXO-B9V-tQMe.js → diagram-P4PSJMXO-CvcxPsVp.js} +7 -7
- package/webapp/dist/assets/{diagram-P4PSJMXO-B9V-tQMe.js.map → diagram-P4PSJMXO-CvcxPsVp.js.map} +1 -1
- package/webapp/dist/assets/{erDiagram-INFDFZHY-CV68FwGf.js → erDiagram-INFDFZHY-BDO90e-f.js} +5 -5
- package/webapp/dist/assets/{erDiagram-INFDFZHY-CV68FwGf.js.map → erDiagram-INFDFZHY-BDO90e-f.js.map} +1 -1
- package/webapp/dist/assets/{flowDiagram-PKNHOUZH-CW06almb.js → flowDiagram-PKNHOUZH-hd4TorKR.js} +7 -7
- package/webapp/dist/assets/{flowDiagram-PKNHOUZH-CW06almb.js.map → flowDiagram-PKNHOUZH-hd4TorKR.js.map} +1 -1
- package/webapp/dist/assets/{ganttDiagram-A5KZAMGK-C96NncCU.js → ganttDiagram-A5KZAMGK-mID1sFSl.js} +3 -3
- package/webapp/dist/assets/{ganttDiagram-A5KZAMGK-C96NncCU.js.map → ganttDiagram-A5KZAMGK-mID1sFSl.js.map} +1 -1
- package/webapp/dist/assets/{gitGraphDiagram-K3NZZRJ6-CAuIexWi.js → gitGraphDiagram-K3NZZRJ6-DaA7yodM.js} +8 -8
- package/webapp/dist/assets/{gitGraphDiagram-K3NZZRJ6-CAuIexWi.js.map → gitGraphDiagram-K3NZZRJ6-DaA7yodM.js.map} +1 -1
- package/webapp/dist/assets/{graph-CvhwAY6w.js → graph-B86JxOkQ.js} +3 -3
- package/webapp/dist/assets/{graph-CvhwAY6w.js.map → graph-B86JxOkQ.js.map} +1 -1
- package/webapp/dist/assets/{index-BOO_zFrI.js → index-DYO4ZL8y.js} +369 -389
- package/webapp/dist/assets/{index-BOO_zFrI.js.map → index-DYO4ZL8y.js.map} +1 -1
- package/webapp/dist/assets/{infoDiagram-LFFYTUFH-C16Sckpz.js → infoDiagram-LFFYTUFH-DxF36W9g.js} +6 -6
- package/webapp/dist/assets/{infoDiagram-LFFYTUFH-C16Sckpz.js.map → infoDiagram-LFFYTUFH-DxF36W9g.js.map} +1 -1
- package/webapp/dist/assets/{ishikawaDiagram-PHBUUO56-oNG6I0p3.js → ishikawaDiagram-PHBUUO56-wvAzRzSO.js} +2 -2
- package/webapp/dist/assets/{ishikawaDiagram-PHBUUO56-oNG6I0p3.js.map → ishikawaDiagram-PHBUUO56-wvAzRzSO.js.map} +1 -1
- package/webapp/dist/assets/{journeyDiagram-4ABVD52K-437hhFHC.js → journeyDiagram-4ABVD52K-CIBXsttK.js} +5 -5
- package/webapp/dist/assets/{journeyDiagram-4ABVD52K-437hhFHC.js.map → journeyDiagram-4ABVD52K-CIBXsttK.js.map} +1 -1
- package/webapp/dist/assets/{kanban-definition-K7BYSVSG-DsCV_Tpx.js → kanban-definition-K7BYSVSG-DQTPyM5m.js} +3 -3
- package/webapp/dist/assets/{kanban-definition-K7BYSVSG-DsCV_Tpx.js.map → kanban-definition-K7BYSVSG-DQTPyM5m.js.map} +1 -1
- package/webapp/dist/assets/{layout-BttZf7fQ.js → layout-BG7IzQAG.js} +5 -5
- package/webapp/dist/assets/{layout-BttZf7fQ.js.map → layout-BG7IzQAG.js.map} +1 -1
- package/webapp/dist/assets/{linear-B75vD4Ho.js → linear-5XR-mXYw.js} +2 -2
- package/webapp/dist/assets/{linear-B75vD4Ho.js.map → linear-5XR-mXYw.js.map} +1 -1
- package/webapp/dist/assets/{mindmap-definition-YRQLILUH-DA1-XaNi.js → mindmap-definition-YRQLILUH-BwTQE6uN.js} +4 -4
- package/webapp/dist/assets/{mindmap-definition-YRQLILUH-DA1-XaNi.js.map → mindmap-definition-YRQLILUH-BwTQE6uN.js.map} +1 -1
- package/webapp/dist/assets/{pieDiagram-SKSYHLDU-Bx6hUJ4Q.js → pieDiagram-SKSYHLDU-ZYB35zd5.js} +8 -8
- package/webapp/dist/assets/{pieDiagram-SKSYHLDU-Bx6hUJ4Q.js.map → pieDiagram-SKSYHLDU-ZYB35zd5.js.map} +1 -1
- package/webapp/dist/assets/{quadrantDiagram-337W2JSQ-zyduIle0.js → quadrantDiagram-337W2JSQ-BM041Q-W.js} +3 -3
- package/webapp/dist/assets/{quadrantDiagram-337W2JSQ-zyduIle0.js.map → quadrantDiagram-337W2JSQ-BM041Q-W.js.map} +1 -1
- package/webapp/dist/assets/{requirementDiagram-Z7DCOOCP-BgfjyEJM.js → requirementDiagram-Z7DCOOCP-r_xMoroM.js} +4 -4
- package/webapp/dist/assets/{requirementDiagram-Z7DCOOCP-BgfjyEJM.js.map → requirementDiagram-Z7DCOOCP-r_xMoroM.js.map} +1 -1
- package/webapp/dist/assets/{sankeyDiagram-WA2Y5GQK-lmOWaczS.js → sankeyDiagram-WA2Y5GQK-Ju2-t24N.js} +2 -2
- package/webapp/dist/assets/{sankeyDiagram-WA2Y5GQK-lmOWaczS.js.map → sankeyDiagram-WA2Y5GQK-Ju2-t24N.js.map} +1 -1
- package/webapp/dist/assets/{sequenceDiagram-2WXFIKYE-DqJz-iYI.js → sequenceDiagram-2WXFIKYE-D83Bocd1.js} +4 -4
- package/webapp/dist/assets/{sequenceDiagram-2WXFIKYE-DqJz-iYI.js.map → sequenceDiagram-2WXFIKYE-D83Bocd1.js.map} +1 -1
- package/webapp/dist/assets/{stateDiagram-RAJIS63D-CngWYuX-.js → stateDiagram-RAJIS63D-mTmpZzpU.js} +9 -9
- package/webapp/dist/assets/{stateDiagram-RAJIS63D-CngWYuX-.js.map → stateDiagram-RAJIS63D-mTmpZzpU.js.map} +1 -1
- package/webapp/dist/assets/{stateDiagram-v2-FVOUBMTO-BxyHvrvU.js → stateDiagram-v2-FVOUBMTO-BCn7mFeH.js} +5 -5
- package/webapp/dist/assets/{stateDiagram-v2-FVOUBMTO-BxyHvrvU.js.map → stateDiagram-v2-FVOUBMTO-BCn7mFeH.js.map} +1 -1
- package/webapp/dist/assets/{timeline-definition-YZTLITO2-C7t6WVS3.js → timeline-definition-YZTLITO2-C1QBcYz8.js} +3 -3
- package/webapp/dist/assets/{timeline-definition-YZTLITO2-C7t6WVS3.js.map → timeline-definition-YZTLITO2-C1QBcYz8.js.map} +1 -1
- package/webapp/dist/assets/{treemap-KZPCXAKY-BDZ3n5TC.js → treemap-KZPCXAKY-BEyfK-Fo.js} +5 -5
- package/webapp/dist/assets/{treemap-KZPCXAKY-BDZ3n5TC.js.map → treemap-KZPCXAKY-BEyfK-Fo.js.map} +1 -1
- package/webapp/dist/assets/{vennDiagram-LZ73GAT5-CEw7GPed.js → vennDiagram-LZ73GAT5-C6SZhLMq.js} +2 -2
- package/webapp/dist/assets/{vennDiagram-LZ73GAT5-CEw7GPed.js.map → vennDiagram-LZ73GAT5-C6SZhLMq.js.map} +1 -1
- package/webapp/dist/assets/{xychartDiagram-JWTSCODW-DmS8BiaA.js → xychartDiagram-JWTSCODW-BUlvexnm.js} +3 -3
- package/webapp/dist/assets/{xychartDiagram-JWTSCODW-DmS8BiaA.js.map → xychartDiagram-JWTSCODW-BUlvexnm.js.map} +1 -1
- package/webapp/dist/index.html +1 -1
package/dist/server.js
CHANGED
|
@@ -121,16 +121,16 @@ async function startServer(opts = {}) {
|
|
|
121
121
|
}
|
|
122
122
|
const tls = certificateLookup.kind === 'found' && !strictPort ? certificateLookup.certificate : undefined;
|
|
123
123
|
const urlHost = (0, network_hosts_1.resolveHttpUrlHostForBindHost)(host);
|
|
124
|
-
log.
|
|
124
|
+
log.debug(`Starting server in ${mode} mode on ${(0, auth_1.formatServerOrigin)({
|
|
125
125
|
scheme: 'http',
|
|
126
126
|
host: urlHost,
|
|
127
127
|
port: preferredPort,
|
|
128
128
|
})} (bind ${host}; ${strictPort ? 'strict port' : `auto port ${portAutoDirection}`}; working language: ${(0, work_language_1.getWorkLanguage)()} from ${source})`);
|
|
129
129
|
if (certificateLookup.kind === 'found' && strictPort) {
|
|
130
|
-
log.
|
|
130
|
+
log.debug(`HTTPS certificate found but Dominds HTTPS is disabled for strict --port; assuming HTTPS, if needed, is handled by a front proxy (${certificateLookup.certificate.certPath})`);
|
|
131
131
|
}
|
|
132
132
|
else if (tls !== undefined) {
|
|
133
|
-
log.
|
|
133
|
+
log.debug(`HTTPS certificate available: ${tls.certPath} (matched host ${tls.matchedHost})`);
|
|
134
134
|
}
|
|
135
135
|
let startedCore = null;
|
|
136
136
|
let boundPort = null;
|
|
@@ -208,7 +208,7 @@ async function startServer(opts = {}) {
|
|
|
208
208
|
await startedCore.stop();
|
|
209
209
|
throw new Error(`Failed to start WebUI HTTPS: no available adjacent port found from ${preferredHttpsPort}`);
|
|
210
210
|
}
|
|
211
|
-
log.
|
|
211
|
+
log.debug(`HTTPS WebUI ready: ${(0, auth_1.formatServerOrigin)({
|
|
212
212
|
scheme: 'https',
|
|
213
213
|
host: httpsUrlHost,
|
|
214
214
|
port: httpsPort,
|
package/dist/tools/mcp.js
CHANGED
|
@@ -57,7 +57,7 @@ const mcpReleaseSchema = {
|
|
|
57
57
|
properties: {
|
|
58
58
|
serverId: {
|
|
59
59
|
type: 'string',
|
|
60
|
-
description: "MCP server id from `.minds/mcp.yaml` (e.g., 'playwright'). Releases this dialog's current leased MCP
|
|
60
|
+
description: "MCP server id from `.minds/mcp.yaml` (e.g., 'playwright'). Releases this dialog's current leased MCP connection/process for that server.",
|
|
61
61
|
},
|
|
62
62
|
},
|
|
63
63
|
required: ['serverId'],
|
|
@@ -68,7 +68,7 @@ const mcpDisableSchema = {
|
|
|
68
68
|
properties: {
|
|
69
69
|
serverId: {
|
|
70
70
|
type: 'string',
|
|
71
|
-
description: "MCP server id from `.minds/mcp.yaml` (e.g., 'playwright'). Stops any loaded
|
|
71
|
+
description: "MCP server id from `.minds/mcp.yaml` (e.g., 'playwright'). Stops any loaded MCP connection/leases and writes servers.<id>.enabled=false.",
|
|
72
72
|
},
|
|
73
73
|
},
|
|
74
74
|
required: ['serverId'],
|
|
@@ -109,10 +109,10 @@ exports.mcpRestartTool = {
|
|
|
109
109
|
exports.mcpReleaseTool = {
|
|
110
110
|
type: 'func',
|
|
111
111
|
name: 'mcp_release',
|
|
112
|
-
description: "Release this dialog's current leased MCP
|
|
112
|
+
description: "Release this dialog's current leased MCP connection/process for a server.",
|
|
113
113
|
descriptionI18n: {
|
|
114
|
-
en: "Release this dialog's current leased MCP
|
|
115
|
-
zh: '释放当前对话为某个 server 持有的 MCP
|
|
114
|
+
en: "Release this dialog's current leased MCP connection/process for a server.",
|
|
115
|
+
zh: '释放当前对话为某个 server 持有的 MCP 连接/进程。',
|
|
116
116
|
},
|
|
117
117
|
parameters: mcpReleaseSchema,
|
|
118
118
|
argsValidation: 'dominds',
|
|
@@ -147,10 +147,10 @@ exports.mcpReleaseTool = {
|
|
|
147
147
|
exports.mcpDisableTool = {
|
|
148
148
|
type: 'func',
|
|
149
149
|
name: 'mcp_disable',
|
|
150
|
-
description: 'Disable a configured MCP server, clear its loaded
|
|
150
|
+
description: 'Disable a configured MCP server, clear its loaded MCP connection/leases, and persist enabled=false in `.minds/mcp.yaml`.',
|
|
151
151
|
descriptionI18n: {
|
|
152
|
-
en: 'Disable a configured MCP server, clear its loaded
|
|
153
|
-
zh: '禁用指定 MCP
|
|
152
|
+
en: 'Disable a configured MCP server, clear its loaded MCP connection/leases, and persist enabled=false in `.minds/mcp.yaml`.',
|
|
153
|
+
zh: '禁用指定 MCP 服务器,清理其已加载 MCP 连接/租约,并在 `.minds/mcp.yaml` 中持久写入 enabled=false。',
|
|
154
154
|
},
|
|
155
155
|
parameters: mcpDisableSchema,
|
|
156
156
|
argsValidation: 'dominds',
|
|
@@ -210,18 +210,18 @@ exports.mcpLeaseReminderOwner = {
|
|
|
210
210
|
? [
|
|
211
211
|
`${prefix} MCP 工具集租约 [${reminder.id}]: \`${serverId}\``,
|
|
212
212
|
'',
|
|
213
|
-
`你当前看到的是系统维护的 MCP 租约状态。该 MCP server 被视为非“真正无状态”;当前对话持有一个 MCP
|
|
213
|
+
`你当前看到的是系统维护的 MCP 租约状态。该 MCP server 被视为非“真正无状态”;当前对话持有一个 MCP 连接/进程(HTTP 连接或 stdio 进程)。`,
|
|
214
214
|
(0, driver_messages_1.formatAutoMaintainedReminderManualMirrorBan)(workLanguage),
|
|
215
215
|
'',
|
|
216
|
-
|
|
216
|
+
`该提醒项只说明当前对话持有的连接/进程;它不决定该 server 的全局工具注册/可见性。`,
|
|
217
217
|
].join('\n')
|
|
218
218
|
: [
|
|
219
219
|
`${prefix} MCP toolset lease [${reminder.id}]: \`${serverId}\``,
|
|
220
220
|
'',
|
|
221
|
-
`You are looking at system-maintained MCP lease state. This MCP server is treated as non-stateless, and the current dialog holds one MCP
|
|
221
|
+
`You are looking at system-maintained MCP lease state. This MCP server is treated as non-stateless, and the current dialog holds one MCP connection/process for it (an HTTP connection or stdio process).`,
|
|
222
222
|
(0, driver_messages_1.formatAutoMaintainedReminderManualMirrorBan)(workLanguage),
|
|
223
223
|
'',
|
|
224
|
-
`This reminder only describes the
|
|
224
|
+
`This reminder only describes the connection/process held by the current dialog; it does not determine global tool registration/visibility for that server.`,
|
|
225
225
|
].join('\n'),
|
|
226
226
|
};
|
|
227
227
|
},
|
|
@@ -29,7 +29,7 @@ control is Dominds' **dialog control toolset** for managing dialog state, remind
|
|
|
29
29
|
- **Reminder management**: Three reminder scopes: `dialog` / `task` / `agent`. Default to `task` for current work under the same Taskdoc; use `dialog` only for truly dialog-local notes; use `agent` only for urgent, short-lived, globally visible cues
|
|
30
30
|
- **Taskdoc operations**: Append to, replace, or delete task contract sections (goals/constraints/progress); within Taskdoc, `progress` is the team-shared, quasi-real-time, scannable task bulletin board
|
|
31
31
|
- **Context maintenance**: Reduce cognitive load without losing key resume state
|
|
32
|
-
- **Reply routing**: Separate
|
|
32
|
+
- **Reply routing**: Separate asking the tellasker back, sending the final reply, and ordinary plain text in Side Dialog / ask-back flows
|
|
33
33
|
|
|
34
34
|
## Quick Navigation
|
|
35
35
|
|
|
@@ -58,7 +58,7 @@ Reminders are temporary current-work information for:
|
|
|
58
58
|
- Recording blocking issues
|
|
59
59
|
- Holding continuation-package bridge notes before `clear_mind`
|
|
60
60
|
|
|
61
|
-
Reminders are not for manually copying
|
|
61
|
+
Reminders are not for manually copying environment state automatically maintained by Dominds, such as background process status, in-flight background asks/collaboration, or browser/session attachment state. Dominds-managed reminders, panels, and tool outputs are the authoritative place for that state; manual notes go stale easily and create cognitive noise.
|
|
62
62
|
|
|
63
63
|
Scope rule:
|
|
64
64
|
|
|
@@ -42,7 +42,7 @@ Default to `task`. Use `dialog` only when the note is truly dialog-local; use `a
|
|
|
42
42
|
- `agent` reminders stay visible in all later dialogs you lead
|
|
43
43
|
- Can be added, modified, or deleted at any time
|
|
44
44
|
- Should stay compact, scannable, and directly actionable by default
|
|
45
|
-
- Before `clear_mind`, the Main Dialog first records undocumented discussion details the next course needs to know into Taskdoc, then creates a structured continuation-package reminder; a Side Dialog directly maintains sufficiently detailed continuation-package reminders. If
|
|
45
|
+
- Before `clear_mind`, the Main Dialog first records undocumented discussion details the next course needs to know into Taskdoc, then creates a structured continuation-package reminder; a Side Dialog directly maintains sufficiently detailed continuation-package reminders. If Dominds has already warned that context is tight or critical, Side Dialog reminders have no fixed length limit and rough multi-reminder carry-over is acceptable
|
|
46
46
|
|
|
47
47
|
**Difference from memory:**
|
|
48
48
|
| Feature | dialog reminder | task reminder | agent reminder | personal memory |
|
|
@@ -104,17 +104,17 @@ Taskdoc is a **task contract** and the task's **team-shared source of current tr
|
|
|
104
104
|
- Do not treat an agent teammate like a human coworker who can only handle one conversation at a time. Same teammate + same `sessionSlug` = continue the same task and update that task; `tellaskSessionless` or a different `sessionSlug` = another independent task
|
|
105
105
|
- Call `tellaskBack({ tellaskContent })` only when the tellasker must clarify the request, decide a tradeoff, confirm acceptance criteria, provide missing input, or current SOP cannot determine ownership
|
|
106
106
|
- If a human must personally perform login / GUI / captcha / high-risk authorization: call `askHuman({ tellaskContent })`
|
|
107
|
-
- If the current Side Dialog is complete and the
|
|
108
|
-
- If the current Side Dialog is complete and the
|
|
109
|
-
- If you are answering a tellasker `tellaskBack` follow-up and
|
|
110
|
-
- Plain text is not the completion channel for inter-dialog delivery
|
|
107
|
+
- If the current Side Dialog is complete and the task header says `replyTellask`: call `replyTellask({ replyContent })`
|
|
108
|
+
- If the current Side Dialog is complete and the task header says `replyTellaskSessionless`: call `replyTellaskSessionless({ replyContent })`
|
|
109
|
+
- If you are answering a tellasker `tellaskBack` follow-up and Dominds shows `replyTellaskBack`: call `replyTellaskBack({ replyContent })`
|
|
110
|
+
- Plain text is not the completion channel for inter-dialog delivery. If you write final content for the requester but do not send it through the reply tool named by Dominds, Dominds may temporarily remind you to use that tool. Do not treat plain text as the formal reply path; the other dialog may not receive a formal reply that way.
|
|
111
111
|
|
|
112
112
|
### Low-Burden Rule
|
|
113
113
|
|
|
114
|
-
- Focus on doing the current task correctly first;
|
|
115
|
-
- Do not memorize reply variants by yourself; follow the current
|
|
116
|
-
-
|
|
117
|
-
- If
|
|
114
|
+
- Focus on doing the current task correctly first; send the final reply only when the final content is ready and Dominds names a reply tool
|
|
115
|
+
- Do not memorize reply variants by yourself; follow the current task header and the reply tool currently named/shown by Dominds
|
|
116
|
+
- Reply tool descriptions are intentionally minimal and spec-like; use this manual's principles / scenarios for situational guidance
|
|
117
|
+
- If Dominds names/shows only one reply tool, that is the only correct completion path for the current state
|
|
118
118
|
- `tellaskBack` is valid only when ownership cannot be determined from existing SOP, or when the tellasker must answer; it is not the default first move for every blocked state
|
|
119
119
|
|
|
120
120
|
## Best Practices
|
|
@@ -137,10 +137,10 @@ Taskdoc is a **task contract** and the task's **team-shared source of current tr
|
|
|
137
137
|
|
|
138
138
|
- Keep concise: reminders are often 1-3 items; prefer `update_reminder` to compress/merge
|
|
139
139
|
- Separate carriers: information that must synchronize the team's current effective state, key decisions, next steps, or still-active blockers belongs in `progress`, the quasi-real-time task bulletin board; reminders keep local resume details
|
|
140
|
-
- Do not duplicate system state: background process status, in-flight background asks/collaboration, browser/session attachment state, and similar
|
|
140
|
+
- Do not duplicate system state: background process status, in-flight background asks/collaboration, browser/session attachment state, and similar environment state automatically maintained by Dominds do not belong in manual reminders. Dominds-managed reminders, panels, and tool outputs are the authoritative place for that state; manual copies go stale easily and create cognitive noise
|
|
141
141
|
- Team-facing: keep `progress` scannable and centered on what is still effective now; do not let it degrade into a personal log, raw chronology, scratchpad, or stale history pile. Use `mind_more` for small additions; when cleanup/reordering/compression is needed, call `recall_taskdoc` first and then use `change_mind` with the returned `content_hash` as `previous_content_hash`
|
|
142
142
|
- Condense when needed: `mind_more` is not the default bookkeeping move. If one topic already has several phase notes, prefer `change_mind` to merge them into the current summary; put the detailed expansion in formal rtws documentation and keep a document pointer in Taskdoc. If the replacement would overwrite existing content, proceed only with direct human confirmation or after applying a human-approved SOP/acceptance standard that considers the existing content
|
|
143
|
-
- Collapse before clearing: the Main Dialog first records undocumented discussion details the next course needs to know into the appropriate Taskdoc sections, then creates a structured continuation-package reminder; a Side Dialog must not maintain Taskdoc or draft Taskdoc update proposals, and should directly maintain sufficiently detailed continuation-package reminders. If
|
|
143
|
+
- Collapse before clearing: the Main Dialog first records undocumented discussion details the next course needs to know into the appropriate Taskdoc sections, then creates a structured continuation-package reminder; a Side Dialog must not maintain Taskdoc or draft Taskdoc update proposals, and should directly maintain sufficiently detailed continuation-package reminders. If Dominds has already warned that context is tight or critical, rough multi-reminder carry-over is acceptable but must be reconciled first in the new course
|
|
144
144
|
- Avoid raw-material dumps: do not paste long logs or large tool outputs into reminders
|
|
145
145
|
- Documentation layering: Taskdoc says “what the team should sync on / do next now”; formal rtws documentation carries “why, how, detailed evidence, and the full process”. When Taskdoc references formal rtws documentation, use a stable path/section name/relevant command instead of copying the full content
|
|
146
146
|
|
|
@@ -164,5 +164,5 @@ Taskdoc is a **task contract** and the task's **team-shared source of current tr
|
|
|
164
164
|
1. `dialog` reminders end with the dialog; `task` reminders stay visible under the current Taskdoc; `agent` reminders stay visible in all later dialogs you lead
|
|
165
165
|
2. Use `do_mind` to create missing Taskdoc sections; use `mind_more` for small Taskdoc additions; use `change_mind` for full-section replacement of existing sections only after merging existing content and calling `recall_taskdoc` for the current `content_hash`; use `never_mind` when a whole section file should be deleted. Do not treat `mind_more` as a chronology tool; when cleanup, stale-entry removal, or same-topic consolidation is needed, use `recall_taskdoc` then `change_mind`
|
|
166
166
|
3. `do_mind` / `mind_more` / `change_mind` / `never_mind` do not start a new course
|
|
167
|
-
4. A continuation-package reminder should keep only details still not covered by Taskdoc but easy to lose during resume; in the Main Dialog, undocumented discussion details from current dialog history that the next course needs to know should be written to the appropriate Taskdoc sections first; in a Side Dialog
|
|
167
|
+
4. A continuation-package reminder should keep only details still not covered by Taskdoc but easy to lose during resume; in the Main Dialog, undocumented discussion details from current dialog history that the next course needs to know should be written to the appropriate Taskdoc sections first; in a Side Dialog after Dominds warns that context is tight or critical, maintain sufficiently detailed continuation-package reminders only
|
|
168
168
|
5. Do not turn `task` / `agent` reminders into a long-term fact dump; move durable knowledge into `personal_memory`
|
|
@@ -57,11 +57,11 @@ delete_reminder({
|
|
|
57
57
|
- If the information should synchronize the whole team's current effective state, put it in Taskdoc `progress` instead
|
|
58
58
|
- If the note is durable knowledge rather than an active current-work cue, move it to `personal_memory` instead
|
|
59
59
|
|
|
60
|
-
## Scenario 2: Side Dialog is complete, and the
|
|
60
|
+
## Scenario 2: Side Dialog is complete, and the task header requires replyTellask
|
|
61
61
|
|
|
62
62
|
### Scenario Description
|
|
63
63
|
|
|
64
|
-
The current Side Dialog is finished, and the
|
|
64
|
+
The current Side Dialog is finished, and the task header explicitly says "when complete, call `replyTellask`".
|
|
65
65
|
|
|
66
66
|
### Example
|
|
67
67
|
|
|
@@ -74,7 +74,7 @@ replyTellask({
|
|
|
74
74
|
|
|
75
75
|
### Key Points
|
|
76
76
|
|
|
77
|
-
- Do not replace this with a plain final message;
|
|
77
|
+
- Do not replace this with a plain final message; formal delivery must use the reply tool named by Dominds, or the other dialog may not receive a formal reply
|
|
78
78
|
- Put the final deliverable body directly in `replyContent`
|
|
79
79
|
- If the header says `replyTellaskSessionless`, use the same shape with that exact function name
|
|
80
80
|
|
|
@@ -97,13 +97,13 @@ tellaskBack({
|
|
|
97
97
|
|
|
98
98
|
- This example uses `tellaskBack` because tellasker input is specifically required
|
|
99
99
|
- If team SOP / role ownership already identifies the responsible executor, directly use `tellask` / `tellaskSessionless` for that owner instead of mapping every unfinished state to `tellaskBack`
|
|
100
|
-
- Do not use
|
|
100
|
+
- Do not use reply tools for intermediate clarifications
|
|
101
101
|
|
|
102
102
|
## Scenario 4: Tellasker answered the ask-back, so use replyTellaskBack to close
|
|
103
103
|
|
|
104
104
|
### Scenario Description
|
|
105
105
|
|
|
106
|
-
You previously sent a `tellaskBack`, the tellasker has now replied, and
|
|
106
|
+
You previously sent a `tellaskBack`, the tellasker has now replied, and Dominds shows `replyTellaskBack`.
|
|
107
107
|
|
|
108
108
|
### Example
|
|
109
109
|
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
|
|
24
24
|
The **tool descriptions themselves** for these functions intentionally stay minimal and spec-like. This section carries the smallest practical lookup for when they appear and how to choose among them.
|
|
25
25
|
|
|
26
|
-
| Function | Minimal parameter contract | When
|
|
26
|
+
| Function | Minimal parameter contract | When Dominds shows it | Effect |
|
|
27
27
|
| ------------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
|
|
28
28
|
| `replyTellask` | `{ replyContent: string }` | Current Side Dialog comes from a sessioned `tellask` and is ready for final delivery | Delivers the final result for the current tellask session |
|
|
29
29
|
| `replyTellaskSessionless` | `{ replyContent: string }` | Current Side Dialog comes from a one-shot `tellaskSessionless` and is ready for final delivery | Delivers the final result for the current one-shot tellask |
|
|
@@ -32,11 +32,11 @@ The **tool descriptions themselves** for these functions intentionally stay mini
|
|
|
32
32
|
|
|
33
33
|
### Minimal Usage Rules
|
|
34
34
|
|
|
35
|
-
- Focus on doing the current task correctly first;
|
|
36
|
-
- Call whichever
|
|
37
|
-
- If the
|
|
35
|
+
- Focus on doing the current task correctly first; send the final reply only when the final content is ready and Dominds names a reply tool
|
|
36
|
+
- Call whichever reply tool Dominds currently shows; do not switch to another reply tool by yourself
|
|
37
|
+
- If the task header explicitly names a reply tool, follow that exact name
|
|
38
38
|
- Put only the final deliverable body in `replyContent`; do not wrap it in meta-explanations like "I am now calling replyTellask"
|
|
39
|
-
- If you
|
|
39
|
+
- If you write final deliverable content but do not send it through the reply tool named by Dominds, Dominds may temporarily remind you to use that tool; do not treat plain text as the formal reply path, because the other dialog may not receive a formal reply that way
|
|
40
40
|
|
|
41
41
|
### 1. add_reminder
|
|
42
42
|
|
|
@@ -45,8 +45,8 @@ Add reminder.
|
|
|
45
45
|
Use when:
|
|
46
46
|
|
|
47
47
|
- Adding a new temporary current-work item
|
|
48
|
-
- Before `clear_mind`, the Main Dialog first records undocumented discussion details the next course needs to know into Taskdoc, then creates continuation-package notes; a Side Dialog directly maintains sufficiently detailed continuation-package reminders. When
|
|
49
|
-
- Record only manually maintained current-work / continuation details; do not put
|
|
48
|
+
- Before `clear_mind`, the Main Dialog first records undocumented discussion details the next course needs to know into Taskdoc, then creates continuation-package notes; a Side Dialog directly maintains sufficiently detailed continuation-package reminders. When Dominds has already warned that context is tight or critical, Side Dialog reminders have no fixed length limit and rough bridge notes are acceptable
|
|
49
|
+
- Record only manually maintained current-work / continuation details; do not put environment state automatically maintained by Dominds, such as background process status, in-flight background asks, or session attachment state, into manual reminders
|
|
50
50
|
|
|
51
51
|
**Parameters:**
|
|
52
52
|
|
|
@@ -92,7 +92,7 @@ Use when:
|
|
|
92
92
|
- Compressing / merging existing reminders
|
|
93
93
|
- Rewriting pre-clear resume info into continuation-package notes
|
|
94
94
|
- Removing details that have already been promoted into Taskdoc
|
|
95
|
-
- Removing or rewriting system environment state that was mistakenly captured in a manual reminder;
|
|
95
|
+
- Removing or rewriting system environment state that was mistakenly captured in a manual reminder; Dominds-managed reminders, panels, and tool outputs are the authoritative place for that state
|
|
96
96
|
|
|
97
97
|
**Parameters:**
|
|
98
98
|
|
|
@@ -360,7 +360,7 @@ message: <error message>
|
|
|
360
360
|
|
|
361
361
|
- Normal reminders should stay concise, fresh, and directly actionable; often 1-3 items total
|
|
362
362
|
- For a continuation package, use structured notes by default: next step, key pointers, run/verify, easy-to-lose volatile details
|
|
363
|
-
- If
|
|
363
|
+
- If Dominds has already warned that context is tight or critical: the Main Dialog first records undocumented discussion details the next course needs to know into the appropriate Taskdoc sections, then keeps necessary continuation-package reminders; a Side Dialog must not maintain Taskdoc or draft Taskdoc update proposals, and should directly maintain sufficiently detailed continuation-package reminders with no fixed length limit. Rough multi-reminder bridge notes are acceptable and should be reconciled as the first step only after Dominds actually starts the new course
|
|
364
364
|
- Keep only details still not covered by Taskdoc; do not repeat team-shared status. If the team needs “where we are now / which decisions are in effect / what is next / which blockers still hold”, write it back to Taskdoc `progress`
|
|
365
|
-
- Do not manually record
|
|
365
|
+
- Do not manually record environment state automatically maintained by Dominds, such as whether background processes are still running, in-flight background asks/collaboration, or browser/session attachment state. Manual copies go stale easily and conflict with the Dominds-managed status, creating cognitive noise
|
|
366
366
|
- Do not paste long logs, large tool outputs, or raw material into reminders
|
|
@@ -29,7 +29,7 @@ control 是 Dominds 的**对话控制工具集**,用于管理对话状态、
|
|
|
29
29
|
- **提醒管理**:提醒分 `dialog` / `task` / `agent` 三个 scope;默认是 `task`,用于同一差遣牒任务下的手头工作;`dialog` 只用于真正对话局部的提醒;`agent` 只用于紧急、短期、全局刺眼提醒
|
|
30
30
|
- **差遣牒操作**:追加、替换或删除任务契约章节(goals/constraints/progress);其中 `progress` 是全队共享、准实时、可扫读的任务公告牌
|
|
31
31
|
- **上下文维护**:在不丢关键恢复线索的前提下降低认知负载
|
|
32
|
-
-
|
|
32
|
+
- **回复路由**:在支线/回问语境下,区分回问诉请者、发送最终回贴与普通文本的职责边界
|
|
33
33
|
|
|
34
34
|
## 快速导航
|
|
35
35
|
|
|
@@ -56,9 +56,9 @@ control 是 Dominds 的**对话控制工具集**,用于管理对话状态、
|
|
|
56
56
|
- 标记待处理事项
|
|
57
57
|
- 追踪当前下一步/阻塞
|
|
58
58
|
- 记录阻塞问题
|
|
59
|
-
- 在 `clear_mind`
|
|
59
|
+
- 在 `clear_mind` 前承载接续包;若 Dominds 已提醒当前程吃紧/告急,可先带多条粗略提醒项过桥
|
|
60
60
|
|
|
61
|
-
提醒不用于手工复制 Dominds
|
|
61
|
+
提醒不用于手工复制 Dominds 会自动维护的系统状态,例如后台进程状态、后台进行中诉请/协作、浏览器/会话附件状态等。这些状态以 Dominds 自动维护的提醒、面板和工具输出为准;手工记录很容易过时并造成认知干扰。
|
|
62
62
|
|
|
63
63
|
scope 规则:
|
|
64
64
|
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
- `agent` 提醒会在所有由你主理的后续对话里继续可见
|
|
43
43
|
- 可随时添加、修改、删除
|
|
44
44
|
- 默认应保持少量、可扫读、可直接指导下一步
|
|
45
|
-
- 准备 `clear_mind`
|
|
45
|
+
- 准备 `clear_mind` 时,主线对话先把应由下一程知会的未落文档讨论细节补进差遣牒,再压缩成结构化接续包提醒项;支线对话直接维护足够详尽的接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,支线提醒项没有固定长度限制,也可先保留多条粗略提醒项过桥
|
|
46
46
|
|
|
47
47
|
**与 memory 的区别:**
|
|
48
48
|
| 特性 | dialog reminder | task reminder | agent reminder | personal memory |
|
|
@@ -103,17 +103,17 @@
|
|
|
103
103
|
- 不要把智能体队友当成真人同事:祂不会因为你又发一条诉请而被打扰。同一个队友 + 同一个 `sessionSlug` = 接着同一件事说,并更新那件正在做的事;`tellaskSessionless` 或不同 `sessionSlug` = 另一件独立任务
|
|
104
104
|
- 只有当必须向诉请者补需求、澄清目标、裁决取舍、确认验收口径、提供缺失输入,或现有规程无法明确判责时:调用 `tellaskBack({ tellaskContent })`
|
|
105
105
|
- 需要人类亲自登录 / GUI / 验证码 / 高风险授权时:调用 `askHuman({ tellaskContent })`
|
|
106
|
-
-
|
|
107
|
-
-
|
|
108
|
-
- 当前是在回复一条诉请者发来的 `tellaskBack` 续诉请,且
|
|
109
|
-
-
|
|
106
|
+
- 当前支线已经完成,且当前任务开头明确要求 `replyTellask`:调用 `replyTellask({ replyContent })`
|
|
107
|
+
- 当前支线已经完成,且当前任务开头明确要求 `replyTellaskSessionless`:调用 `replyTellaskSessionless({ replyContent })`
|
|
108
|
+
- 当前是在回复一条诉请者发来的 `tellaskBack` 续诉请,且 Dominds 显示了 `replyTellaskBack`:调用 `replyTellaskBack({ replyContent })`
|
|
109
|
+
- 普通文本不是跨对话完成交付通道;如果你直接写出了可回给诉请者的最终内容但没按 Dominds 点名的回复工具发送,Dominds 可能临时提醒你改用那个工具。不要把普通文本当成正式回贴路径;对方可能收不到正式回贴。
|
|
110
110
|
|
|
111
111
|
### 心智负担最小化规则
|
|
112
112
|
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
- 若
|
|
113
|
+
- 先专注把当前任务做对;只有最终内容准备好、且 Dominds 点名了回复工具时,才发送最终回贴
|
|
114
|
+
- 不要靠记忆硬选回复工具;以当前任务开头和 Dominds 当前点名/显示的回复工具为准
|
|
115
|
+
- 回复工具自身说明文案故意保持极简,只承载最小规格;情景判断看本手册的 principles / scenarios
|
|
116
|
+
- 若 Dominds 只点名/显示一个回复工具,那就是当前应调用的唯一完成路径
|
|
117
117
|
- `tellaskBack` 只在“无法按现有规程明确判责,或必须回问诉请者”时成立,不是所有阻塞的默认第一动作
|
|
118
118
|
|
|
119
119
|
## 最佳实践
|
|
@@ -122,7 +122,7 @@
|
|
|
122
122
|
|
|
123
123
|
- **当前手头工作**:当前下一步、阻塞、关键定位信息
|
|
124
124
|
- **易丢细节**:临时路径、id、命令、样例输入
|
|
125
|
-
- **换程接续**:在 `clear_mind`
|
|
125
|
+
- **换程接续**:在 `clear_mind` 前整理接续包;若 Dominds 已提醒当前程吃紧/告急,可先保留多条粗略提醒项
|
|
126
126
|
- **任务延续提示**:如果在当前差遣牒任务内都应该继续看到它,用 `task`
|
|
127
127
|
- **全局刺眼提示**:如果它应该在所有由你主理的后续对话里继续看到,而且是短期、紧急、全局刺眼提醒,用 `agent`
|
|
128
128
|
|
|
@@ -136,10 +136,10 @@
|
|
|
136
136
|
|
|
137
137
|
- 保持简洁:默认提醒项常见 1–3 条,优先 `update_reminder` 压缩/合并
|
|
138
138
|
- 区分载体:需要向全队同步的当前有效状态、关键决策、下一步与仍成立阻塞,写入 `progress` 这一准实时任务公告牌;提醒项只留个人/当前对话恢复所需细节
|
|
139
|
-
- 避免重复系统状态:后台进程状态、后台进行中诉请/协作、浏览器/会话附件状态等 Dominds
|
|
139
|
+
- 避免重复系统状态:后台进程状态、后台进行中诉请/协作、浏览器/会话附件状态等 Dominds 会自动维护的信息,不要写进手工提醒项;这些状态以 Dominds 自动维护的提醒、面板和工具输出为准,手工副本容易过时并造成认知干扰
|
|
140
140
|
- 面向全队:`progress` 应保持可扫读、以“当前仍有效”为准,不要退化成个人日志、流水账、临时便签或历史残影堆积;少量新增用 `mind_more`,需要清旧/重排/压缩时先调用 `recall_taskdoc`,再用 `change_mind` 并携带返回的 `content_hash` 作为 `previous_content_hash`
|
|
141
141
|
- 按需整理:`mind_more` 不是默认记账动作。若同一主题已有多条阶段性记录,优先用 `change_mind` 合并成当前摘要;把细节放进 rtws 正式文档,并在差遣牒里保留文档定位 pointer。若会冲掉原有内容,必须有直接人类确认,或已按人类认可 SOP/验收标准充分考虑原有内容后再改写
|
|
142
|
-
-
|
|
142
|
+
- 换程前收束:主线对话先把尚未落实到文档、且下一程需要知会的讨论细节写入差遣牒合适章节,再整理结构化接续包提醒项;支线对话不要维护差遣牒,也不要整理差遣牒更新提案,直接维护足够详尽的接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,则先保留多条粗略提醒项过桥也可以;当前程只做落文档/保信息 + `clear_mind`(支线只做保信息 + `clear_mind`),Dominds 真正开启新一程后第一步再收敛
|
|
143
143
|
- 拒绝原料堆积:不要把长日志/大段 tool output 直接塞进提醒项
|
|
144
144
|
- 文档分层:差遣牒写“现在应如何同步/推进”,正式文档写“为什么、怎么做、详细证据和完整过程”。差遣牒需要引用正式文档时,写稳定路径/章节名/相关命令,而不是复制整段内容
|
|
145
145
|
|
|
@@ -57,11 +57,11 @@ delete_reminder({
|
|
|
57
57
|
- 如果信息需要向全队同步当前有效状态、关键决策、下一步或仍成立阻塞,应写入 Taskdoc `progress`
|
|
58
58
|
- 如果内容本质上是长期知识而不是当前手头工作提示,应改存到 `personal_memory`
|
|
59
59
|
|
|
60
|
-
## 场景 2
|
|
60
|
+
## 场景 2:支线已完成,按任务开头要求调用 replyTellask
|
|
61
61
|
|
|
62
62
|
### 场景描述
|
|
63
63
|
|
|
64
|
-
|
|
64
|
+
当前支线处理完毕,任务开头明确写着“完成任务时必须调用 `replyTellask`”。
|
|
65
65
|
|
|
66
66
|
### 示例
|
|
67
67
|
|
|
@@ -73,9 +73,9 @@ replyTellask({
|
|
|
73
73
|
|
|
74
74
|
### 关键点
|
|
75
75
|
|
|
76
|
-
-
|
|
76
|
+
- 不要再发一条普通最终消息代替;正式回贴必须走 Dominds 点名的回复工具,否则对方可能收不到正式回贴
|
|
77
77
|
- `replyContent` 直接放最终交付正文
|
|
78
|
-
-
|
|
78
|
+
- 若任务开头写的是 `replyTellaskSessionless`,则同结构替换函数名
|
|
79
79
|
|
|
80
80
|
## 场景 3:当前未完成,需要回问诉请者
|
|
81
81
|
|
|
@@ -90,20 +90,20 @@ tellaskBack({
|
|
|
90
90
|
tellaskContent: '还缺少生产环境端口与部署入口信息。请补充这两项后我再继续给出最终方案。',
|
|
91
91
|
});
|
|
92
92
|
|
|
93
|
-
// 等诉请者补充后,
|
|
93
|
+
// 等诉请者补充后,Dominds 会在当前对话里继续推进
|
|
94
94
|
```
|
|
95
95
|
|
|
96
96
|
### 关键点
|
|
97
97
|
|
|
98
98
|
- 这里只是“必须向诉请者补输入”的例子,所以用 `tellaskBack`
|
|
99
99
|
- 若团队规程 / SOP / 职责卡已经能明确执行负责人,应直接 `tellask` / `tellaskSessionless` 对应负责人,而不是机械因为“未完成态”就用 `tellaskBack`
|
|
100
|
-
- `tellaskBack`
|
|
100
|
+
- `tellaskBack` 只负责把问题问回去,不负责最终交付;中间澄清不要调用回复工具
|
|
101
101
|
|
|
102
102
|
## 场景 4:收到 ask-back 续诉请后,用 replyTellaskBack 收口
|
|
103
103
|
|
|
104
104
|
### 场景描述
|
|
105
105
|
|
|
106
|
-
你之前发过 `tellaskBack`,诉请者现在补回了所需信息,
|
|
106
|
+
你之前发过 `tellaskBack`,诉请者现在补回了所需信息,Dominds 显示了 `replyTellaskBack`。
|
|
107
107
|
|
|
108
108
|
### 示例
|
|
109
109
|
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
|
|
24
24
|
这些函数的**工具自身说明**刻意保持最小规格风格;这里负责补充“何时会出现、出现后怎么选”的最小速查。
|
|
25
25
|
|
|
26
|
-
| 函数 | 最小参数契约 |
|
|
26
|
+
| 函数 | 最小参数契约 | Dominds 何时显示 | 调用后语义 |
|
|
27
27
|
| ------------------------- | ---------------------------- | -------------------------------------------------------------------- | ----------------------------------- |
|
|
28
28
|
| `replyTellask` | `{ replyContent: string }` | 当前支线承接的是 sessioned `tellask`,且已进入可交付完成态 | 把最终结果回复给当前 `tellask` 会话 |
|
|
29
29
|
| `replyTellaskSessionless` | `{ replyContent: string }` | 当前支线承接的是 one-shot `tellaskSessionless`,且已进入可交付完成态 | 把最终结果回复给当前一次性诉请 |
|
|
@@ -32,11 +32,11 @@
|
|
|
32
32
|
|
|
33
33
|
### 最小使用规则
|
|
34
34
|
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
35
|
+
- 先专注把当前任务做对;只有最终内容准备好、且 Dominds 点名了回复工具时,才发送最终回贴
|
|
36
|
+
- 看见 Dominds 当前显示哪一个回复工具,就调用哪一个;不要自行改选别的回复工具
|
|
37
|
+
- 任务开头若已点名回复工具名,以那个名字为准
|
|
38
38
|
- `replyContent` 只放最终交付正文,不要再包一层“我现在调用了 replyXXX”
|
|
39
|
-
-
|
|
39
|
+
- 如果你直接写出了最终回贴内容但没按 Dominds 点名的回复工具发送,Dominds 可能临时提醒你改用那个工具;不要把普通文本当成正式回贴路径,对方可能收不到正式回贴
|
|
40
40
|
|
|
41
41
|
### 1. add_reminder
|
|
42
42
|
|
|
@@ -45,8 +45,8 @@
|
|
|
45
45
|
**适用:**
|
|
46
46
|
|
|
47
47
|
- 添加新的临时手头工作条目
|
|
48
|
-
- 若准备 `clear_mind
|
|
49
|
-
- 只记录需要你手工维护的手头工作/接续细节;不要在手工提醒项里记录后台进程状态、后台进行中诉请、会话附件状态等 Dominds
|
|
48
|
+
- 若准备 `clear_mind`,主线对话先把应由下一程知会的未落文档讨论细节补进差遣牒,再新建接续包提醒项;支线对话直接维护足够详尽的接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,支线提醒项没有固定长度限制,先记粗略过桥信息也可以
|
|
49
|
+
- 只记录需要你手工维护的手头工作/接续细节;不要在手工提醒项里记录后台进程状态、后台进行中诉请、会话附件状态等 Dominds 会自动维护的信息
|
|
50
50
|
|
|
51
51
|
**参数:**
|
|
52
52
|
|
|
@@ -90,9 +90,9 @@ deleted_at: <删除时间戳>
|
|
|
90
90
|
**适用:**
|
|
91
91
|
|
|
92
92
|
- 压缩/合并现有提醒项
|
|
93
|
-
-
|
|
93
|
+
- 把换程前需要保留的信息整理成接续包;若 Dominds 已提醒当前程吃紧/告急,也可先保留多条粗略提醒项
|
|
94
94
|
- 删除已写入差遣牒、无需在提醒项重复保留的内容
|
|
95
|
-
- 删除/改写手工提醒项里误记录的系统环境状态;这类状态以
|
|
95
|
+
- 删除/改写手工提醒项里误记录的系统环境状态;这类状态以 Dominds 自动维护的提醒、面板和工具输出为准
|
|
96
96
|
|
|
97
97
|
**参数:**
|
|
98
98
|
|
|
@@ -353,7 +353,7 @@ message: <错误消息>
|
|
|
353
353
|
|
|
354
354
|
- 默认提醒项应保持短、新、能直接指导下一步,常见 1–3 条
|
|
355
355
|
- 若用于接续包,默认优先结构化内容:下一步行动、关键定位、运行/验证、容易丢的临时细节
|
|
356
|
-
-
|
|
356
|
+
- 若 Dominds 已提醒上下文吃紧/告急:主线对话先把尚未落实到文档、且下一程需要知会的讨论细节写入差遣牒合适章节,再保留必要的接续包提醒项;支线对话不要维护差遣牒,也不要整理差遣牒更新提案,直接维护足够详尽的接续包提醒项,没有固定长度限制;多条粗略提醒项也可以,Dominds 真正开启新一程后第一步再收敛整理
|
|
357
357
|
- 接续包只保留差遣牒仍未覆盖的细节;不要重复团队共享状态。要向全队同步“现在到哪了 / 哪些决策已生效 / 下一步是什么 / 哪些阻塞仍成立”,请写回 Taskdoc `progress`
|
|
358
|
-
- 不要手工记录 Dominds
|
|
358
|
+
- 不要手工记录 Dominds 会自动维护的系统状态,例如后台进程是否仍在运行、后台进行中的诉请/协作、浏览器/会话附件状态等;手工记录很容易过时,并与 Dominds 自动维护的状态冲突,造成认知干扰
|
|
359
359
|
- 不要把长日志、大段 tool output、原始材料直接塞进提醒项
|
|
@@ -37,15 +37,15 @@ MCP (Model Context Protocol) is a protocol for connecting to external services.
|
|
|
37
37
|
|
|
38
38
|
### 2. MCP Lease
|
|
39
39
|
|
|
40
|
-
MCP uses a lease mechanism to manage
|
|
40
|
+
MCP uses a lease mechanism to manage connection/process resources such as HTTP connections and stdio processes. Lease ownership is about who holds a connection/process; it does not define global MCP tool registration or visibility.
|
|
41
41
|
|
|
42
42
|
**Lifecycle:**
|
|
43
43
|
|
|
44
|
-
- **Acquire lease**: Establish or hold a
|
|
45
|
-
- **Hold lease**: Keep using that
|
|
44
|
+
- **Acquire lease**: Establish or hold a connection/process
|
|
45
|
+
- **Hold lease**: Keep using that connection/process
|
|
46
46
|
- **Release lease**: Stop/disconnect and release resources
|
|
47
47
|
|
|
48
|
-
`mcp_restart` changes the target server from `enabled: false` back to `enabled: true`, then tries to start it. When it succeeds, it replaces the global MCP
|
|
48
|
+
`mcp_restart` changes the target server from `enabled: false` back to `enabled: true`, then tries to start it. When it succeeds, it replaces the global MCP service connection and clears all dialog leases on the old connection/process; you do not need to call `mcp_release` first. To force a server into the disabled state, use `mcp_disable`.
|
|
49
49
|
|
|
50
50
|
### 3. Environment Variables
|
|
51
51
|
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
|
|
18
18
|
When an MCP service has issues, needs to refresh the connection, or is currently disabled with `enabled: false`, enable and restart the MCP service.
|
|
19
19
|
|
|
20
|
-
`mcp_restart` writes `enabled: true` when the server is currently `enabled: false`, then tries to start it. After it succeeds, it clears every dialog lease on the old
|
|
20
|
+
`mcp_restart` writes `enabled: true` when the server is currently `enabled: false`, then tries to start it. After it succeeds, it clears every dialog lease on the old connection/process; you do not need to call `mcp_release` first.
|
|
21
21
|
|
|
22
22
|
### Example
|
|
23
23
|
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
### 1. mcp_restart
|
|
23
23
|
|
|
24
|
-
Enable and rebuild an MCP service using the current `.minds/mcp.yaml` config. If the target server is currently `enabled: false`, this writes `enabled: true` before trying to start it. After a successful restart, Dominds replaces the global MCP
|
|
24
|
+
Enable and rebuild an MCP service using the current `.minds/mcp.yaml` config. If the target server is currently `enabled: false`, this writes `enabled: true` before trying to start it. After a successful restart, Dominds replaces the global MCP tool registration and clears all dialog leases held on the old connection/process. If restart fails, the old connection/process and leases are kept so troubleshooting does not tear down a still-working connection.
|
|
25
25
|
|
|
26
26
|
**Parameters:**
|
|
27
27
|
|
|
@@ -39,7 +39,7 @@ ok: restarted <MCP service identifier>
|
|
|
39
39
|
|
|
40
40
|
### 2. mcp_release
|
|
41
41
|
|
|
42
|
-
Release the current dialog's leased MCP
|
|
42
|
+
Release the current dialog's leased MCP connection/process for a server. This stops/releases the underlying HTTP connection or stdio process, but does not define global tool registration/visibility.
|
|
43
43
|
|
|
44
44
|
**Parameters:**
|
|
45
45
|
|
|
@@ -64,7 +64,7 @@ ok: no active lease for <MCP service identifier> (or server is truely-stateless)
|
|
|
64
64
|
|
|
65
65
|
### 3. mcp_disable
|
|
66
66
|
|
|
67
|
-
Disable an MCP service and write `enabled: false` for that server in `.minds/mcp.yaml`. This does not wait for a replacement service to become available: it unconditionally clears the loaded
|
|
67
|
+
Disable an MCP service and write `enabled: false` for that server in `.minds/mcp.yaml`. This does not wait for a replacement service to become available: it unconditionally clears the loaded MCP connection/leases. The disabled server remains visible as a zero-tool MCP toolset, with its manual clearly marked disabled.
|
|
68
68
|
|
|
69
69
|
**Parameters:**
|
|
70
70
|
|
|
@@ -37,15 +37,15 @@ MCP(Model Context Protocol)是连接外部服务的协议。
|
|
|
37
37
|
|
|
38
38
|
### 2. MCP 租约
|
|
39
39
|
|
|
40
|
-
MCP
|
|
40
|
+
MCP 使用租约机制管理连接/进程资源,例如 HTTP 连接和 stdio 进程。租约只表示谁持有某个连接/进程,不决定 MCP 工具的全局注册或可见性。
|
|
41
41
|
|
|
42
42
|
**生命周期:**
|
|
43
43
|
|
|
44
|
-
-
|
|
45
|
-
-
|
|
44
|
+
- **获取租约**:建立或持有一个连接/进程
|
|
45
|
+
- **持有租约**:继续使用该连接/进程
|
|
46
46
|
- **释放租约**:停止/断开并释放资源
|
|
47
47
|
|
|
48
|
-
`mcp_restart` 会把目标 server 的 `enabled: false` 改回 `enabled: true`,然后尝试启动;成功时会替换全局 MCP
|
|
48
|
+
`mcp_restart` 会把目标 server 的 `enabled: false` 改回 `enabled: true`,然后尝试启动;成功时会替换全局 MCP 服务连接,并清掉旧连接/进程的所有对话 lease;不需要先逐个 `mcp_release`。如果需要强制禁用某个 server,使用 `mcp_disable`。
|
|
49
49
|
|
|
50
50
|
### 3. 环境变量
|
|
51
51
|
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
|
|
18
18
|
当 MCP 服务出现故障、需要刷新连接,或当前被 `enabled: false` 禁用时,启用并重启 MCP 服务。
|
|
19
19
|
|
|
20
|
-
`mcp_restart` 会把 `enabled: false` 写回 `enabled: true`
|
|
20
|
+
`mcp_restart` 会把 `enabled: false` 写回 `enabled: true` 后尝试启动;成功后会清理旧连接/进程 的全部对话 lease,不需要先 `mcp_release`。
|
|
21
21
|
|
|
22
22
|
### 示例
|
|
23
23
|
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
### 1. mcp_restart
|
|
23
23
|
|
|
24
|
-
按当前 `.minds/mcp.yaml` 配置启用并重建 MCP 服务。如果目标 server 当前是 `enabled: false`,会先写回 `enabled: true` 再尝试启动。重启成功后会替换全局 MCP
|
|
24
|
+
按当前 `.minds/mcp.yaml` 配置启用并重建 MCP 服务。如果目标 server 当前是 `enabled: false`,会先写回 `enabled: true` 再尝试启动。重启成功后会替换全局 MCP 工具注册,并清理旧连接/进程上所有对话持有的 lease;重启失败时保留旧连接/进程和 lease,避免排障过程中把仍可用的连接拆掉。
|
|
25
25
|
|
|
26
26
|
**参数:**
|
|
27
27
|
|
|
@@ -39,7 +39,7 @@ ok: restarted <MCP 服务标识符>
|
|
|
39
39
|
|
|
40
40
|
### 2. mcp_release
|
|
41
41
|
|
|
42
|
-
释放当前对话为某个 server 持有的 MCP
|
|
42
|
+
释放当前对话为某个 server 持有的 MCP 连接/进程。它会停止/释放底层 HTTP 连接或 stdio 进程,但不决定工具的全局注册或可见性。
|
|
43
43
|
|
|
44
44
|
**参数:**
|
|
45
45
|
|
|
@@ -64,7 +64,7 @@ ok: no active lease for <MCP 服务标识符> (or server is truely-stateless)
|
|
|
64
64
|
|
|
65
65
|
### 3. mcp_disable
|
|
66
66
|
|
|
67
|
-
禁用 MCP 服务并将 `.minds/mcp.yaml` 中对应 server 写为 `enabled: false`。该操作不等待新服务可用:会无条件清理已加载
|
|
67
|
+
禁用 MCP 服务并将 `.minds/mcp.yaml` 中对应 server 写为 `enabled: false`。该操作不等待新服务可用:会无条件清理已加载 MCP 连接/lease。禁用后的 server 仍作为 0 工具 MCP toolset 可见,并在手册中明确标记为 disabled。
|
|
68
68
|
|
|
69
69
|
**参数:**
|
|
70
70
|
|