newmark-agent 0.3.5 → 0.3.7

package/dist/core/agent.js

@@ -3417,6 +3417,130 @@ class Agent {
             truncatedActivities: Math.max(0, publicEvents.length - activities.length),
         });
     }
+    async handleContextCompress(args, signal) {
+        let input = {};
+        try {
+            input = JSON.parse(args || '{}');
+        }
+        catch { }
+        if (this.history.length <= 1)
+            return { ok: false, output: '[context_compress] No context to compress.', error: 'No context to compress.' };
+        const previousKeepLast = this.config.getNum('context', 'keep_recent_messages');
+        const keepRecent = Math.max(2, Math.min(60, Math.floor(Number(input.keep_recent) || previousKeepLast || 10)));
+        const force = Boolean(input.force);
+        try {
+            this.config.set('context', 'keep_recent_messages', keepRecent);
+            const msgs = this.history.map(message => ({ ...message }));
+            const provider = this.engineModel();
+            await this.maybeCompress(msgs, provider, signal, this.activeModelName(), force);
+            if (this.history.length <= 1)
+                return { ok: false, output: '[context_compress] Compression skipped: context unchanged.', error: 'Compression skipped.' };
+            return {
+                ok: true,
+                output: JSON.stringify({
+                    ok: true,
+                    compressed: true,
+                    at: this.lastCompression?.at,
+                    originalMessages: this.lastCompression?.originalMessages,
+                    compressedMessages: this.lastCompression?.compressedMessages,
+                    originalChars: this.lastCompression?.originalChars,
+                    compressedChars: this.lastCompression?.compressedChars,
+                    estimatedTokens: this.lastCompression?.compressedTokens,
+                    summary: this.lastCompression?.summary?.slice(0, 2000),
+                    model: this.lastCompression?.model,
+                    fallback: this.lastCompression?.fallback,
+                    displayHistory: { untouched: true, messageCount: this.chatMessages.length },
+                }, null, 2),
+                metadata: { kind: 'context-compress' },
+            };
+        }
+        finally {
+            this.config.set('context', 'keep_recent_messages', previousKeepLast);
+        }
+    }
+    handleContextHistoryManage(args) {
+        let input = {};
+        try {
+            input = JSON.parse(args || '{}');
+        }
+        catch { }
+        const action = String(input.action || '').trim();
+        if (!action)
+            return { ok: false, output: '[context_history_manage] action is required (list|remove|summarize).', error: 'action is required.' };
+        if (action === 'list') {
+            const limit = Math.max(5, Math.min(400, Math.floor(Number(input.limit || 200))));
+            const entries = this.history.slice(0, limit).map((message, index) => ({
+                position: index,
+                role: String(message.role || ''),
+                name: String(message.name || ''),
+                chars: typeof message.content === 'string' ? message.content.length : JSON.stringify(message.content || '').length,
+                preview: this.compressionHistoryContent(message.content || '').slice(0, 160),
+            }));
+            return {
+                ok: true,
+                output: JSON.stringify({
+                    ok: true,
+                    action: 'list',
+                    entryCount: this.history.length,
+                    listed: entries.length,
+                    entries,
+                    displayHistory: { untouched: true, messageCount: this.chatMessages.length },
+                }, null, 2),
+                metadata: { kind: 'context-history-list' },
+            };
+        }
+        if (action === 'remove') {
+            const position = Math.floor(Number(input.position));
+            if (!Number.isFinite(position) || position < 0 || position >= this.history.length) {
+                return { ok: false, output: `[context_history_manage] remove position ${position} out of range (0..${this.history.length - 1}).`, error: 'remove position out of range.' };
+            }
+            const removed = this.history.splice(position, 1)[0];
+            this.saveWorkspaceConversationState(true);
+            return {
+                ok: true,
+                output: JSON.stringify({
+                    ok: true,
+                    action: 'remove',
+                    removedPosition: position,
+                    removedRole: String(removed?.role || ''),
+                    remaining: this.history.length,
+                    displayHistory: { untouched: true, messageCount: this.chatMessages.length },
+                }, null, 2),
+                metadata: { kind: 'context-history-remove' },
+            };
+        }
+        if (action === 'summarize') {
+            const from = Math.max(0, Math.floor(Number(input.position || 0)));
+            const toRaw = Math.floor(Number(input.to ?? input.position));
+            const to = Number.isFinite(toRaw) ? Math.min(this.history.length - 1, Math.max(from, toRaw)) : from;
+            if (from >= this.history.length)
+                return { ok: false, output: `[context_history_manage] summarize position ${from} out of range (0..${this.history.length - 1}).`, error: 'summarize position out of range.' };
+            if (to - from < 1)
+                return { ok: false, output: '[context_history_manage] summarize requires at least two entries in range.', error: 'summarize requires a range of at least two entries.' };
+            const segment = this.history.slice(from, to + 1);
+            const chars = segment.reduce((sum, message) => sum + (typeof message.content === 'string' ? message.content.length : JSON.stringify(message.content || '').length), 0);
+            const summary = this.localCompressionSummary(`Workspace: ${this.workspace.current?.path || this.rootPath}\nMode: ${this.modeName()}`, segment.map((message, i) => `#${i + 1} [${String(message.role || 'unknown')}${message.name ? ` ${String(message.name)}` : ''}]\n${this.compressionHistoryContent(message.content || '')}`).join('\n\n').slice(0, 20000), segment.length, chars);
+            const replacement = { role: 'system', content: `[Context History Summary]\n${summary}` };
+            this.history.splice(from, to - from + 1, replacement);
+            this.saveWorkspaceConversationState(true);
+            return {
+                ok: true,
+                output: JSON.stringify({
+                    ok: true,
+                    action: 'summarize',
+                    foldedFrom: from,
+                    foldedTo: to,
+                    foldedEntries: to - from + 1,
+                    foldedChars: chars,
+                    remaining: this.history.length,
+                    summary: summary.slice(0, 2000),
+                    displayHistory: { untouched: true, messageCount: this.chatMessages.length },
+                }, null, 2),
+                metadata: { kind: 'context-history-summarize' },
+            };
+        }
+        return { ok: false, output: `[context_history_manage] Unknown action: ${action}`, error: `Unknown action: ${action}` };
+    }
     recordContextCompressionStep() {
         const runId = this.currentWorkRunId();
         if (!runId)
@@ -5496,7 +5620,7 @@ class Agent {
             if (!sa)
                 return { ok: false, output: `[Subagent] Not found: ${name}`, error: `Not found: ${name}` };
             const transcript = sa.messages.map(m => `[${m.role}] ${m.content}`).join('\n');
-            return this.subagents.toToolResult(sa.id, `get.subagent("${sa.name}")\nStatus: ${sa.status}\nModel: ${sa.model}\nMode: ${sa.agentMode}\n\nResult:\n${sa.result || ''}\n\nConversation:\n${transcript}`, true);
+            return this.subagents.toToolResult(sa.id, `get.subagent("${sa.name}", id="${sa.id}")\nStatus: ${sa.status}\nModel: ${sa.model}\nMode: ${sa.agentMode}\n\nResult:\n${sa.result || ''}\n\nConversation:\n${transcript}`, true);
         }
         catch {
             return { ok: false, output: '[Subagent] Invalid result arguments.', error: 'Invalid result arguments.' };
@@ -6393,7 +6517,7 @@ class Agent {
             return;
         const total = msgs.reduce((sum, m) => sum + (typeof m.content === 'string' ? m.content.length : JSON.stringify(m.content || '').length), 0);
         const budget = this.compressionBudget(msgs);
-        if (budget.estimatedTokens < budget.triggerTokens)
+        if (budget.estimatedTokens < budget.triggerTokens && !force)
             return;
         if (!force && this.lastCompression && String(msgs[0]?.content || '').includes(this.lastCompression.summary)) {
             const baselineChars = Math.max(0, Number(this.lastCompression.compressedChars || 0));

package/dist/core/agentKernelRunner.js

@@ -1470,6 +1470,10 @@ async function executeNewmarkTool(agent, name, args, inputSchema, signal) {
             return agent.handleLinkedPlanTool(args);
         if (name === 'build_history_query')
             return agent.handleBuildHistoryQuery(args);
+        if (name === 'context_compress')
+            return (await agent.handleContextCompress(args, signal)).output;
+        if (name === 'context_history_manage')
+            return agent.handleContextHistoryManage(args).output;
         if (name === 'question') {
             if (agent.config.getStr('agent', 'option_feedback') === 'fully_autonomous')
                 return '[question] Disabled by fully_autonomous option feedback.';

package/dist/core/automationWake.js

@@ -109,43 +109,43 @@ class AutomationWakeScheduler {
         const startBoundary = toTaskSchedulerLocal(nextRunAt);
         const command = xmlEscape(this.exePath);
         const args = xmlEscape(`--root "${this.rootPath}" --automation-wake`);
-        const xml = `<?xml version="1.0" encoding="UTF-16"?>
-<Task version="1.4" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
-  <RegistrationInfo>
-    <Description>Wake Newmark Agent to run due automations.</Description>
-    <URI>\\${xmlEscape(taskName)}</URI>
-  </RegistrationInfo>
-  <Triggers>
-    <TimeTrigger>
-      <StartBoundary>${xmlEscape(startBoundary)}</StartBoundary>
-      <Enabled>true</Enabled>
-    </TimeTrigger>
-  </Triggers>
-  <Principals>
-    <Principal id="Author">
-      <UserId>${xmlEscape(os.userInfo().username)}</UserId>
-      <LogonType>InteractiveToken</LogonType>
-      <RunLevel>LeastPrivilege</RunLevel>
-    </Principal>
-  </Principals>
-  <Settings>
-    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
-    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
-    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
-    <AllowHardTerminate>true</AllowHardTerminate>
-    <StartWhenAvailable>true</StartWhenAvailable>
-    <WakeToRun>true</WakeToRun>
-    <Enabled>true</Enabled>
-    <Hidden>false</Hidden>
-    <ExecutionTimeLimit>PT2H</ExecutionTimeLimit>
-  </Settings>
-  <Actions Context="Author">
-    <Exec>
-      <Command>${command}</Command>
-      <Arguments>${args}</Arguments>
-      <WorkingDirectory>${xmlEscape(this.rootPath)}</WorkingDirectory>
-    </Exec>
-  </Actions>
+        const xml = `<?xml version="1.0" encoding="UTF-16"?>
+<Task version="1.4" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <RegistrationInfo>
+    <Description>Wake Newmark Agent to run due automations.</Description>
+    <URI>\\${xmlEscape(taskName)}</URI>
+  </RegistrationInfo>
+  <Triggers>
+    <TimeTrigger>
+      <StartBoundary>${xmlEscape(startBoundary)}</StartBoundary>
+      <Enabled>true</Enabled>
+    </TimeTrigger>
+  </Triggers>
+  <Principals>
+    <Principal id="Author">
+      <UserId>${xmlEscape(os.userInfo().username)}</UserId>
+      <LogonType>InteractiveToken</LogonType>
+      <RunLevel>LeastPrivilege</RunLevel>
+    </Principal>
+  </Principals>
+  <Settings>
+    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
+    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
+    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
+    <AllowHardTerminate>true</AllowHardTerminate>
+    <StartWhenAvailable>true</StartWhenAvailable>
+    <WakeToRun>true</WakeToRun>
+    <Enabled>true</Enabled>
+    <Hidden>false</Hidden>
+    <ExecutionTimeLimit>PT2H</ExecutionTimeLimit>
+  </Settings>
+  <Actions Context="Author">
+    <Exec>
+      <Command>${command}</Command>
+      <Arguments>${args}</Arguments>
+      <WorkingDirectory>${xmlEscape(this.rootPath)}</WorkingDirectory>
+    </Exec>
+  </Actions>
 </Task>`;
         fs.writeFileSync(xmlPath, Buffer.from(`\ufeff${xml}`, 'utf16le'));
         return xmlPath;

package/dist/core/subagent.d.ts

@@ -111,6 +111,7 @@ export interface SubagentReadSnapshot {
         natureSlug: string;
         displayName: string;
         qualifiedName: string;
+        name: string;
         createdByAgentId: string;
         status: SubagentStatus;
         active: boolean;

package/dist/core/subagent.js

@@ -119,6 +119,10 @@ class SubagentManager {
         const id = (0, crypto_1.randomUUID)();
         const shortId = id.replace(/-/g, '').slice(0, 8);
         const slug = natureSlug(name);
+        // The Agent-facing name is the caller's stable, human-readable label and is
+        // deliberately decoupled from the identity. The UUID and its short form are
+        // the only identity-bearing fields; the UI renders the short-id-qualified
+        // display name while Agent tool interactions accept both name and id.
         const displayName = `${slug}-${shortId}`;
         const qualifiedName = `${displayName}--${id}`;
         const stamp = now();
@@ -128,7 +132,7 @@ class SubagentManager {
             natureSlug: slug,
             displayName,
             qualifiedName,
-            name: qualifiedName,
+            name: slug,
             conversationId: this.conversationId,
             createdByAgentId,
             prompt,
@@ -139,7 +143,7 @@ class SubagentManager {
             flowName: flowName || undefined,
             flowPc: Math.max(0, Math.floor(Number(flowPc) || 0)),
             status: 'queued',
-            messages: [{ role: 'system', content: `Peer agent '${qualifiedName}': ${prompt}` }, { role: 'user', content: prompt, hidden_user_input: true }],
+            messages: [{ role: 'system', content: `Peer agent '${slug}' (${id}): ${prompt}` }, { role: 'user', content: prompt, hidden_user_input: true }],
             result: null,
             createdAt: stamp,
             updatedAt: stamp,
@@ -152,7 +156,14 @@ class SubagentManager {
         return id;
     }
     get(id) {
-        return this.subs.get(id) || [...this.subs.values()].find(item => item.name === id || item.qualifiedName === id || item.displayName === id || item.shortId === id || item.natureSlug === natureSlug(id));
+        if (this.subs.has(id))
+            return this.subs.get(id);
+        const exact = [...this.subs.values()].find(item => item.id === id || item.qualifiedName === id);
+        if (exact)
+            return exact;
+        // name is now caller-supplied and not identity-bearing, so it is a
+        // convenience lookup only; the id/shortId/displayName paths stay exact.
+        return [...this.subs.values()].find(item => item.name === id || item.displayName === id || item.shortId === id || item.natureSlug === natureSlug(id));
     }
     send(id, prompt) {
         const target = this.get(id);
@@ -321,6 +332,7 @@ class SubagentManager {
                     natureSlug: record.natureSlug,
                     displayName: record.displayName,
                     qualifiedName: record.qualifiedName,
+                    name: record.name,
                     createdByAgentId: record.createdByAgentId,
                     status: record.status,
                     active: record.status !== 'closed',

package/dist/core/toolPolicy.js

@@ -14,6 +14,8 @@ const MODE_SCOPED_TOOLS = new Set([
     'pdf_read',
     'linked_plan',
     'build_history_query',
+    'context_compress',
+    'context_history_manage',
     'question',
     'task',
     'subagent_list',

package/dist/main.js

@@ -491,34 +491,34 @@ function firstRunInit(root) {
     // Flow.md
     const fm = path.join(root, 'Flow', 'Flow.md');
     if (!fs.existsSync(fm)) {
-        fs.writeFileSync(fm, `# Newmark Flow Format Guide
-
-A Flow workflow is saved as \`name.Flow.json\` in the Flow/ folder.
-
-## File Format
-\`\`\`json
-{
-  "name": "my-workflow",
-  "components": [
-    {"id": 0, "type": "dialog", "mode": "build", "prompt": "Implement a web server"},
-    {"id": 1, "type": "dialog", "mode": "plan", "prompt": "Review: {#prompt#}"},
-    {"id": 2, "type": "logic", "prompt": "Is the review complete?", "goto_true": 0, "goto_false": 3},
-    {"id": 3, "type": "dialog", "mode": "build", "prompt": "Apply fixes from review"}
-  ]
-}
-\`\`\`
-
-## Component Types
-### dialog
-- id: Sequential index, type: "dialog", mode: "build"/"plan"/"goal"
-- prompt: Base prompt. Use \`{#prompt#}\` as placeholder for user input.
-
-### logic
-- id: Sequential index, type: "logic", prompt: Question for the agent to evaluate
-- goto_true/goto_false: Component ID to jump to
-
-## Execution
-Components execute in order 0 -> 1 -> 2 -> ..., unless a logic component redirects.
+        fs.writeFileSync(fm, `# Newmark Flow Format Guide
+
+A Flow workflow is saved as \`name.Flow.json\` in the Flow/ folder.
+
+## File Format
+\`\`\`json
+{
+  "name": "my-workflow",
+  "components": [
+    {"id": 0, "type": "dialog", "mode": "build", "prompt": "Implement a web server"},
+    {"id": 1, "type": "dialog", "mode": "plan", "prompt": "Review: {#prompt#}"},
+    {"id": 2, "type": "logic", "prompt": "Is the review complete?", "goto_true": 0, "goto_false": 3},
+    {"id": 3, "type": "dialog", "mode": "build", "prompt": "Apply fixes from review"}
+  ]
+}
+\`\`\`
+
+## Component Types
+### dialog
+- id: Sequential index, type: "dialog", mode: "build"/"plan"/"goal"
+- prompt: Base prompt. Use \`{#prompt#}\` as placeholder for user input.
+
+### logic
+- id: Sequential index, type: "logic", prompt: Question for the agent to evaluate
+- goto_true/goto_false: Component ID to jump to
+
+## Execution
+Components execute in order 0 -> 1 -> 2 -> ..., unless a logic component redirects.
 `, 'utf-8');
     }
     // Local.json, External.json, State.json
@@ -843,14 +843,14 @@ async function executeInBrowser(contents, script) {
     return await contents.executeJavaScript(script, true);
 }
 function browserSnapshotScript(maxChars) {
-    return `(() => {
-    const clone = document.body ? document.body.cloneNode(true) : null;
-    if (clone) clone.querySelectorAll('script,style,noscript,svg,canvas').forEach((node) => node.remove());
-    const text = (clone ? clone.innerText : document.documentElement.innerText || '')
-      .replace(/\\s+/g, ' ')
-      .trim()
-      .slice(0, ${Math.max(500, Math.min(maxChars, 50000))});
-    return { url: location.href, title: document.title || '', text };
+    return `(() => {
+    const clone = document.body ? document.body.cloneNode(true) : null;
+    if (clone) clone.querySelectorAll('script,style,noscript,svg,canvas').forEach((node) => node.remove());
+    const text = (clone ? clone.innerText : document.documentElement.innerText || '')
+      .replace(/\\s+/g, ' ')
+      .trim()
+      .slice(0, ${Math.max(500, Math.min(maxChars, 50000))});
+    return { url: location.href, title: document.title || '', text };
   })()`;
 }
 async function runBrowserControl(request) {
@@ -881,33 +881,33 @@ async function runBrowserControl(request) {
             return { ok: true, action, source: 'webview-cdp', ...snap };
         }
         if (action === 'click') {
-            const data = await executeInBrowser(contents, `(() => {
-        const el = document.querySelector(${JSON.stringify(request.selector || '')});
-        if (!el) return { clicked: false, error: 'selector not found' };
-        el.scrollIntoView({ block: 'center', inline: 'center' });
-        el.dispatchEvent(new MouseEvent('mouseover', { bubbles: true }));
-        el.dispatchEvent(new MouseEvent('mousedown', { bubbles: true }));
-        el.dispatchEvent(new MouseEvent('mouseup', { bubbles: true }));
-        el.click();
-        return { clicked: true, tag: el.tagName, text: (el.innerText || el.value || '').slice(0, 200) };
+            const data = await executeInBrowser(contents, `(() => {
+        const el = document.querySelector(${JSON.stringify(request.selector || '')});
+        if (!el) return { clicked: false, error: 'selector not found' };
+        el.scrollIntoView({ block: 'center', inline: 'center' });
+        el.dispatchEvent(new MouseEvent('mouseover', { bubbles: true }));
+        el.dispatchEvent(new MouseEvent('mousedown', { bubbles: true }));
+        el.dispatchEvent(new MouseEvent('mouseup', { bubbles: true }));
+        el.click();
+        return { clicked: true, tag: el.tagName, text: (el.innerText || el.value || '').slice(0, 200) };
       })()`);
             return { ok: true, action, source: 'webview-cdp', url: contents.getURL(), data };
         }
         if (action === 'type') {
-            const data = await executeInBrowser(contents, `(() => {
-        const el = document.querySelector(${JSON.stringify(request.selector || '')});
-        if (!el) return { typed: false, error: 'selector not found' };
-        el.scrollIntoView({ block: 'center', inline: 'center' });
-        el.focus();
-        if ('value' in el) {
-          el.value = ${JSON.stringify(request.text || '')};
-          el.dispatchEvent(new Event('input', { bubbles: true }));
-          el.dispatchEvent(new Event('change', { bubbles: true }));
-        } else {
-          el.textContent = ${JSON.stringify(request.text || '')};
-          el.dispatchEvent(new InputEvent('input', { bubbles: true, data: ${JSON.stringify(request.text || '')} }));
-        }
-        return { typed: true, tag: el.tagName };
+            const data = await executeInBrowser(contents, `(() => {
+        const el = document.querySelector(${JSON.stringify(request.selector || '')});
+        if (!el) return { typed: false, error: 'selector not found' };
+        el.scrollIntoView({ block: 'center', inline: 'center' });
+        el.focus();
+        if ('value' in el) {
+          el.value = ${JSON.stringify(request.text || '')};
+          el.dispatchEvent(new Event('input', { bubbles: true }));
+          el.dispatchEvent(new Event('change', { bubbles: true }));
+        } else {
+          el.textContent = ${JSON.stringify(request.text || '')};
+          el.dispatchEvent(new InputEvent('input', { bubbles: true, data: ${JSON.stringify(request.text || '')} }));
+        }
+        return { typed: true, tag: el.tagName };
       })()`);
             return { ok: true, action, source: 'webview-cdp', url: contents.getURL(), data };
         }
@@ -966,7 +966,7 @@ function viewerDocument(request) {
     const image = request?.type === 'image' && /^data:image\/(?:png|jpeg);base64,[A-Za-z0-9+/]+={0,2}$/i.test(String(request?.dataUrl || ''))
         ? `<img src="${viewerEscape(request.dataUrl)}" alt="${title}">`
         : '<div class="empty">Image unavailable</div>';
-    return `<!doctype html><html><head><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src data:; style-src 'unsafe-inline'"><title>${title}</title><style>
+    return `<!doctype html><html><head><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src data:; style-src 'unsafe-inline'"><title>${title}</title><style>
   :root{color-scheme:dark}*{box-sizing:border-box}html,body{margin:0;width:100%;height:100%;overflow:hidden;background:#090d16;color:#dce8f7;font:12px system-ui,sans-serif}main{height:100%;display:grid;grid-template-rows:auto 1fr;padding:14px;gap:10px}header{font-weight:650;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;color:#a8bdd4}section{min-height:0;display:flex;align-items:center;justify-content:center;border:1px solid #233044;border-radius:10px;background:#0d1420}img{display:block;max-width:100%;max-height:100%;object-fit:contain}svg{width:100%;height:100%}.edges line{stroke:#30435b;stroke-width:1;opacity:.62}text{fill:#9fb2c7;font-size:9px}.empty{color:#6f8196}</style></head><body><main><header>${title}</header><section>${image}</section></main></body></html>`;
 }
 async function createViewerWindow(request) {

package/dist/tools/index.js

@@ -365,14 +365,21 @@ class ToolExecutor {
                 remote_root: { type: 'string' },
                 remote_path: { type: 'string' },
             }, ['action']),
-            t('task', 'Create a same-conversation peer agent and return immediately. The peer has a nature slug, short id, and canonical UUID-qualified name. Pass model to select an exact configured model deployment (deployment:providerId:modelId or an unambiguous provider/model name). When model is omitted, the peer inherits the parent Agent\'s currently resolved model deployment. Plan mode peers are forced to Plan.', { nature: { type: 'string' }, name: { type: 'string', description: 'Legacy alias for nature.' }, prompt: { type: 'string' }, preset: { type: 'string' }, agent: { type: 'string' }, model: { type: 'string', description: 'Optional exact model deployment. Omit to inherit the parent Agent resolved model.' }, mode: { type: 'string' }, input_mode: { type: 'string' }, flow: { type: 'string' } }, ['prompt']),
-            t('subagent_list', 'List flat same-conversation peer agents, optionally filtered by status.', { status: { type: 'string', enum: ['idle', 'queued', 'working', 'completed', 'error', 'closed'] } }, []),
-            t('subagent_read', 'Read one same-conversation peer status, queue/mailbox summary, latest bounded feedback, and result. Available for running, queued, completed, error, and closed peers.', { id: { type: 'string' }, name: { type: 'string' }, max_chars: { type: 'number', description: 'Bounded result size from 2000 to 32000 characters.' } }, []),
-            t('subagent_send', 'Persist a mailbox message to a same-conversation peer agent.', { id: { type: 'string' }, name: { type: 'string' }, message: { type: 'string' }, prompt: { type: 'string', description: 'Legacy alias for message.' }, kind: { type: 'string', enum: ['directive', 'question', 'result', 'handoff'] }, reply_to: { type: 'string' }, correlation_id: { type: 'string' } }, []),
-            t('subagent_result', 'Return the persisted transcript, mailbox summary, status, and latest result for a peer agent.', { id: { type: 'string' }, name: { type: 'string' } }, []),
-            t('subagent_close', 'Close a same-conversation peer. Root can close any peer; a peer can close only itself.', { id: { type: 'string' }, name: { type: 'string' } }, []),
+            t('task', 'Create a same-conversation peer agent and return immediately. The peer has a stable human-readable name, a short id, and a canonical UUID-qualified identity. The peer name is decoupled from its id: pass name for readable references and id for exact targeting. Pass model to select an exact configured model deployment (deployment:providerId:modelId or an unambiguous provider/model name). When model is omitted, the peer inherits the parent Agent\'s currently resolved model deployment. Plan mode peers are forced to Plan.', { nature: { type: 'string' }, name: { type: 'string', description: 'Legacy alias for nature.' }, prompt: { type: 'string' }, preset: { type: 'string' }, agent: { type: 'string' }, model: { type: 'string', description: 'Optional exact model deployment. Omit to inherit the parent Agent resolved model.' }, mode: { type: 'string' }, input_mode: { type: 'string' }, flow: { type: 'string' } }, ['prompt']),
+            t('subagent_list', 'List flat same-conversation peer agents, optionally filtered by status. Each entry exposes both the stable name and the exact id; use the id for any subsequent targeting.', { status: { type: 'string', enum: ['idle', 'queued', 'working', 'completed', 'error', 'closed'] } }, []),
+            t('subagent_read', 'Read one same-conversation peer status, queue/mailbox summary, latest bounded feedback, and result. Available for running, queued, completed, error, and closed peers. Pass the exact id returned by subagent_list, or a name for convenience lookup.', { id: { type: 'string', description: 'Exact peer id from subagent_list.' }, name: { type: 'string', description: 'Convenience peer name; ambiguous names resolve to the first match.' }, max_chars: { type: 'number', description: 'Bounded result size from 2000 to 32000 characters.' } }, []),
+            t('subagent_send', 'Persist a mailbox message to a same-conversation peer agent. Target by exact id (preferred) or name.', { id: { type: 'string', description: 'Exact peer id from subagent_list.' }, name: { type: 'string', description: 'Convenience peer name.' }, message: { type: 'string' }, prompt: { type: 'string', description: 'Legacy alias for message.' }, kind: { type: 'string', enum: ['directive', 'question', 'result', 'handoff'] }, reply_to: { type: 'string' }, correlation_id: { type: 'string' } }, []),
+            t('subagent_result', 'Return the persisted transcript, mailbox summary, status, and latest result for a peer agent. Target by exact id (preferred) or name.', { id: { type: 'string', description: 'Exact peer id from subagent_list.' }, name: { type: 'string', description: 'Convenience peer name.' } }, []),
+            t('subagent_close', 'Close a same-conversation peer. Root can close any peer; a peer can close only itself. Target by exact id (preferred) or name.', { id: { type: 'string', description: 'Exact peer id from subagent_list.' }, name: { type: 'string', description: 'Convenience peer name.' } }, []),
             t('linked_plan', 'Read or update the current conversation linked Markdown plan. Update requires the current expected_revision.', { action: { type: 'string', enum: ['get', 'update'] }, markdown: { type: 'string' }, expected_revision: { type: 'number' } }, ['action']),
             t('build_history_query', 'Read the concrete public work details of one historical Build Block. The prompt already exposes user input, final summary, and completion status; call this read-only tool only when the user asks what specifically happened. Select by newest-to-oldest history_index, or by run_id returned from an earlier query.', { history_index: { type: 'number', minimum: 1, description: '1-based historical Build Block index from the request ledger; 1 is the newest previous task.' }, run_id: { type: 'string', description: 'Exact run id returned by an earlier build_history_query result.' }, max_events: { type: 'number', minimum: 1, maximum: 200, description: 'Maximum trailing public work events; defaults to 80.' } }, []),
+            t('context_compress', 'Actively compress the LLM context history for this conversation. This collapses older history entries into a concise summary while preserving the recent tail, which reduces context tokens and cost. IMPORTANT: it affects only the LLM context (what the model sees); the displayed conversation history shown to the user is never altered. Call this when the conversation is long, token pressure is high, or you judge that older turns are no longer needed in full. Idempotent and safe: repeated calls produce incremental summaries.', { keep_recent: { type: 'number', minimum: 2, maximum: 60, description: 'Recent message count to keep uncompressed at the tail. Defaults to the configured keep_recent_messages.' }, force: { type: 'boolean', description: 'Compress even if the context is not yet over the automatic threshold. Defaults to false.' } }, []),
+            t('context_history_manage', 'Manage the LLM context history for this conversation without affecting the displayed conversation history. This is the active context-management surface. Actions: list returns a bounded index of context entries (position, role, name, length, first-line preview); remove deletes the entry at a given position; summarize replaces a contiguous range of context entries with a concise local summary entry. The displayed conversation history (what the user sees) is never modified by any action.', {
+                action: { type: 'string', enum: ['list', 'remove', 'summarize'], description: 'list: index context entries. remove: delete the entry at position. summarize: fold entries [from, to] into one summary entry.' },
+                position: { type: 'number', minimum: 0, description: '0-based context entry index for remove, or the start of the range for summarize.' },
+                to: { type: 'number', minimum: 0, description: '0-based inclusive end of the range for summarize. Defaults to position.' },
+                limit: { type: 'number', minimum: 5, maximum: 400, description: 'Maximum context entries to list; defaults to 200.' },
+            }, ['action']),
             t('question', 'Ask user a multiple-choice question', { questions: { type: 'array' } }, ['questions']),
             t('skill_download', 'Download a skill', { name: { type: 'string' }, source: { type: 'string' } }, ['name', 'source']),
             t('skill', 'Search enabled skill metadata or load one exact skill body on demand. Use query when unsure, then name to load the selected skill.', { query: { type: 'string', maxLength: 200 }, name: { type: 'string', maxLength: 200 } }, []),

package/dist/tools/nativeTools.js

@@ -40,6 +40,8 @@ exports.NATIVE_TOOL_CATALOG = [
     { name: 'subagent_close', label: 'Subagent close', description: 'Close a same-conversation peer agent.', category: 'agent', defaultEnabled: true, protected: true, availability: 'mode-scoped' },
     { name: 'linked_plan', label: 'Linked plan', description: 'Read or conservatively update the conversation-linked Markdown plan.', category: 'agent', defaultEnabled: true, protected: true, availability: 'mode-scoped' },
     { name: 'build_history_query', label: 'Build history query', description: 'Read concrete public work details for one historical Build Block.', category: 'agent', defaultEnabled: true, protected: true, availability: 'mode-scoped' },
+    { name: 'context_compress', label: 'Context compress', description: 'Actively compress the LLM context history, leaving the displayed conversation history unchanged.', category: 'agent', defaultEnabled: true, protected: true, availability: 'mode-scoped' },
+    { name: 'context_history_manage', label: 'Context history manage', description: 'List, remove, or summarize entries in the LLM context history without touching the displayed conversation history.', category: 'agent', defaultEnabled: true, protected: true, availability: 'mode-scoped' },
     { name: 'question', label: 'Ask question', description: 'Ask the user for structured option feedback.', category: 'agent', defaultEnabled: true, protected: true, availability: 'mode-scoped' },
     { name: 'skill_download', label: 'Skill download', description: 'Download and install a skill.', category: 'agent', defaultEnabled: true },
     { name: 'skill', label: 'Skill', description: 'Search enabled skill metadata or load one skill body on demand.', category: 'agent', defaultEnabled: true, protected: true, availability: 'mode-scoped' },

package/dist/ui/index.html

@@ -9112,7 +9112,7 @@ function workToolActivity(event) {
   if (name === 'task' || name.indexOf('subagent_') === 0) return { key: 'subagents', type: 'tool_subagent' };
   if (name === 'skill' || name === 'skill_load' || name === 'skill_read' || name === 'skill_download') return { key: 'skills', type: 'tool_skill' };
   if (name === 'mcp' || name.indexOf('mcp__') === 0 || /^mcp[:._-]/.test(name) || /[:._-]mcp[:._-]/.test(name)) return { key: 'mcp', type: 'tool_mcp' };
-  if (name === 'context_compression') return { key: 'context_compression', type: 'tool_context_compression' };
+  if (name === 'context_compression' || name === 'context_compress' || name === 'context_history_manage') return { key: 'context_compression', type: 'tool_context_compression' };
   if (name === 'memory_lab_update' || name === 'memory_lab_reindex') return { key: 'memory_lab', type: 'tool_memory_lab' };
   if (name === 'image_inspect' || name === 'computer_use') return { key: 'images', type: 'tool_images' };
   if (name === 'write' || name === 'edit') return { key: 'files', type: 'tool_files' };