@openchambery/web 1.19.9 → 1.19.10-beta.2

package/server/lib/assistants/contact-tools.test.js

@@ -2,6 +2,8 @@ import { describe, expect, it, vi } from 'vitest';
 import { AssignError, ASSIGN_CODES, PROJECT_REQUIRED_MESSAGE } from './assign.js';
 import {
   ASSIGN_SESSION_TOOL_NAME,
+  CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE,
+  CLEAR_CHAT_HISTORY_TOOL_NAME,
   CREATE_ASSISTANT_TOOL_NAME,
   LIST_PROJECTS_TOOL_NAME,
   LIST_SESSIONS_TOOL_NAME,
@@ -20,6 +22,7 @@ import {
   resolveContactProviderModel,
   resolvePeerAssistant,
   stripContactToolFences,
+  userTextAuthorizesClearChatHistory,
 } from './contact-tools.js';
 
 describe('contact tool protocol', () => {
@@ -78,6 +81,7 @@ describe('contact tool protocol', () => {
   it('detects 建助理 without treating 不要开编码 session as assign_session', () => {
     const tools = [
       NEW_CONVERSATION_TOOL_NAME,
+      CLEAR_CHAT_HISTORY_TOOL_NAME,
       LIST_PROJECTS_TOOL_NAME,
       LIST_SESSIONS_TOOL_NAME,
       CREATE_ASSISTANT_TOOL_NAME,
@@ -90,6 +94,7 @@ describe('contact tool protocol', () => {
     ]);
     expect(detectRequestedContactTools('每天 18:00 排一个 ping 定时任务', tools)).toEqual([SCHEDULE_TASK_TOOL_NAME]);
     expect(detectRequestedContactTools('建会话写一个文件', tools)).toEqual([ASSIGN_SESSION_TOOL_NAME]);
+    expect(detectRequestedContactTools('对，你直接派给那个项目组，再建个会话去修这个问题', tools)).toEqual([ASSIGN_SESSION_TOOL_NAME]);
     expect(detectRequestedContactTools('写一个文件', tools)).toEqual([]);
     expect(detectRequestedContactTools('pwd', tools)).toEqual([]);
     expect(detectRequestedContactTools('给 PeerQA 说一声 hello-from-assistant 写好了', tools)).toEqual([
@@ -98,11 +103,24 @@ describe('contact tool protocol', () => {
     expect(detectRequestedContactTools('开新对话', tools)).toEqual([NEW_CONVERSATION_TOOL_NAME]);
     expect(detectRequestedContactTools('new conversation please', tools)).toEqual([NEW_CONVERSATION_TOOL_NAME]);
     expect(detectRequestedContactTools('clear chat', tools)).toEqual([NEW_CONVERSATION_TOOL_NAME]);
+    expect(detectRequestedContactTools('清除记忆', tools)).toEqual([NEW_CONVERSATION_TOOL_NAME]);
+    expect(detectRequestedContactTools('清空聊天记录', tools)).toEqual([CLEAR_CHAT_HISTORY_TOOL_NAME]);
+    expect(detectRequestedContactTools('清除聊天记录', tools)).toEqual([CLEAR_CHAT_HISTORY_TOOL_NAME]);
+    expect(detectRequestedContactTools('clear chat history', tools)).toEqual([CLEAR_CHAT_HISTORY_TOOL_NAME]);
+    expect(detectRequestedContactTools('delete chat history', tools)).toEqual([CLEAR_CHAT_HISTORY_TOOL_NAME]);
+    expect(detectRequestedContactTools('不要清除聊天记录', tools)).toEqual([]);
+    expect(detectRequestedContactTools('do not clear chat history', tools)).toEqual([]);
     expect(detectRequestedContactTools('找项目 openchamber yee', tools)).toEqual([LIST_PROJECTS_TOOL_NAME]);
     expect(detectRequestedContactTools('看看现有对话', tools)).toEqual([LIST_SESSIONS_TOOL_NAME]);
     expect(detectRequestedContactTools('list sessions in that project', tools)).toEqual([LIST_SESSIONS_TOOL_NAME]);
     expect(detectRequestedContactTools('开新对话', tools)).not.toContain(ASSIGN_SESSION_TOOL_NAME);
+    expect(detectRequestedContactTools('开新对话', tools)).not.toContain(CLEAR_CHAT_HISTORY_TOOL_NAME);
     expect(detectRequestedContactTools('不要开编码 session', tools)).toEqual([]);
+    expect(userTextAuthorizesClearChatHistory('清除聊天记录')).toBe(true);
+    expect(userTextAuthorizesClearChatHistory('清空聊天记录')).toBe(true);
+    expect(userTextAuthorizesClearChatHistory('清除记忆')).toBe(false);
+    expect(userTextAuthorizesClearChatHistory('不要清除聊天记录')).toBe(false);
+    expect(userTextAuthorizesClearChatHistory('开新对话')).toBe(false);
   });
 
   it('parses bash fences when the pi coding tools are allowed', () => {
@@ -120,6 +138,7 @@ describe('contact tool protocol', () => {
   it('tells DeepSeek to call tools from natural language, not slash commands', () => {
     const prompt = formatContactToolsPrompt(createContactTools());
     expect(prompt).toContain('new_conversation');
+    expect(prompt).toContain('clear_chat_history');
     expect(prompt).toContain('list_projects');
     expect(prompt).toContain('list_sessions');
     expect(prompt).toContain('create_assistant');
@@ -127,12 +146,15 @@ describe('contact tool protocol', () => {
     expect(prompt).toContain('message_assistant');
     expect(prompt).toContain('assign_session');
     expect(prompt).toContain('开新对话');
+    expect(prompt).toContain('清除记忆');
+    expect(prompt).toContain('清空聊天记录');
     expect(prompt).toContain('找项目');
     expect(prompt).toContain('现有对话');
     expect(prompt).toContain('建助理');
     expect(prompt).toContain('排定时任务');
     expect(prompt).toContain('说一声');
     expect(prompt).toContain('session/new');
+    expect(prompt).toContain('LLM memory only');
     expect(prompt).not.toContain('/card');
     expect(prompt).not.toContain('/dm');
     expect(prompt).toContain('A reply without the tool call does nothing');
@@ -168,8 +190,10 @@ describe('contact tool protocol', () => {
 describe('createContactTools', () => {
   it('exposes create_assistant, schedule_task, and assign_session and returns success cards', async () => {
     const onCard = vi.fn();
-    const resetContact = vi.fn(async () => ({ reset: true }));
+    const clearContactMemory = vi.fn(async () => ({ reset: true, memoryCleared: true }));
+    const resetContact = vi.fn(async () => ({ reset: true, historyCleared: true }));
     const tools = createContactTools({
+      clearContactMemory,
       resetContact,
       createAssistant: async (input) => ({
         id: 'asst_flow',
@@ -204,6 +228,7 @@ describe('createContactTools', () => {
     });
     expect(tools.map((tool) => tool.name)).toEqual([
       NEW_CONVERSATION_TOOL_NAME,
+      CLEAR_CHAT_HISTORY_TOOL_NAME,
       LIST_PROJECTS_TOOL_NAME,
       LIST_SESSIONS_TOOL_NAME,
       CREATE_ASSISTANT_TOOL_NAME,
@@ -214,12 +239,19 @@ describe('createContactTools', () => {
     expect(tools.some((tool) => ['bash', 'edit', 'read', 'write'].includes(tool.name))).toBe(false);
 
     const reset = await tools.find((tool) => tool.name === NEW_CONVERSATION_TOOL_NAME).execute('call_0', {});
-    expect(resetContact).toHaveBeenCalledTimes(1);
+    expect(clearContactMemory).toHaveBeenCalledTimes(1);
+    expect(resetContact).not.toHaveBeenCalled();
     expect(reset.details.card).toBeUndefined();
-    expect(reset.details.reset).toBe(true);
+    expect(reset.details).toMatchObject({ reset: true, memoryCleared: true });
     expect(reset.terminate).toBe(true);
     expect(reset.content[0].text).toBe(NEW_CONVERSATION_CONFIRM_BUBBLE);
 
+    const wiped = await tools.find((tool) => tool.name === CLEAR_CHAT_HISTORY_TOOL_NAME).execute('call_wipe', {});
+    expect(resetContact).toHaveBeenCalledTimes(1);
+    expect(wiped.details).toMatchObject({ reset: true, historyCleared: true });
+    expect(wiped.terminate).toBe(true);
+    expect(wiped.content[0].text).toBe(CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE);
+
     const created = await tools.find((tool) => tool.name === CREATE_ASSISTANT_TOOL_NAME).execute('call_1', { name: 'FlowQA', model: 'opencode-go/deepseek-v4-flash' });
     expect(created.details.card).toMatchObject({
       type: 'card',
@@ -334,4 +366,14 @@ describe('confirmBubbleAfterContactReset', () => {
       'I still see your dot.png and note.txt from earlier.',
     ])).toEqual([NEW_CONVERSATION_CONFIRM_BUBBLE]);
   });
+
+  it('prefers the clear-history confirm when that tool ran', () => {
+    expect(confirmBubbleAfterContactReset([
+      CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE,
+      'I still see older cards.',
+    ], CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE)).toEqual([CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE]);
+    expect(confirmBubbleAfterContactReset([
+      'leftover only',
+    ], CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE)).toEqual([CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE]);
+  });
 });

package/server/lib/assistants/harness.js

@@ -1,7 +1,9 @@
 import { Agent } from '@earendil-works/pi-agent-core';
 import { isContactSpokenPreamble, splitContactBubbles } from './bubbles.js';
 import {
+  CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE,
   confirmBubbleAfterContactReset,
+  contactTurnClearedChatHistory,
   contactTurnHasSuccessfulReset,
   contactTurnHasToolResult,
   detectRequestedContactTools,
@@ -75,7 +77,7 @@ export const CONTACT_SYSTEM_PROMPT = [
   'Never write chain-of-thought, plans, tool names, or English narration of what you will do. The user never sees thinking.',
   'Do not expose tool traces, Activity, or editor actions.',
   'You have bash, read, write, and edit in the working directory. Use them for pwd, files, and shell. Never say you have no terminal or cannot read files. Ignore any temporary generator workspace in the environment.',
-  'Understand natural language in any language, including Chinese: 开新对话 means new_conversation, 找项目 means list_projects, 现有对话 means list_sessions, 建助理 means create_assistant, 建会话 / 开个新会话 means assign_session, 排定时任务 means schedule_task, 给 X 说一声 means message_assistant, 发卡片 means emit a card via those tools — never ask the user to type /card or /dm.',
+  'Understand natural language in any language, including Chinese: 开新对话 / 清除记忆 means new_conversation (LLM memory only, chat history stays), 清空聊天记录 means clear_chat_history (delete transcript), 找项目 means list_projects, 现有对话 means list_sessions, 建助理 means create_assistant, 建会话 / 开个新会话 means assign_session, 排定时任务 means schedule_task, 给 X 说一声 means message_assistant, 发卡片 means emit a card via those tools — never ask the user to type /card or /dm.',
   'You receive the registered project catalog every turn. You CAN see those projects. Look them up yourself (fuzzy match label/name/path). Never say you cannot see the registered project list. Never ask for a raw filesystem path when a name matches. If the catalog is empty, tell the user to add a project in Settings.',
   'File and shell work in this working directory uses read, write, edit, and bash. To open a separate Chat coding session: match the project, optionally list_sessions for existing chats, then assign_session with projectPath or sessionID.',
   'A reply without the tool call does nothing. Never say 已创建, created, scheduled, or opened unless the tool already returned success.',
@@ -521,8 +523,11 @@ export async function runContactTurn({
       throw error;
     }
     const requested = detectRequestedContactTools(userText, contactTools.map((tool) => tool.name));
+    const hasRequestedResult = () => agent.state.messages.some((message) => (
+      message?.role === 'toolResult' && requested.includes(message.toolName)
+    ));
     let retried = false;
-    if (requested.length > 0 && !contactTurnHasToolResult(agent.state.messages)) {
+    if (requested.length > 0 && !hasRequestedResult() && !contactTurnHasSuccessfulReset(agent.state.messages)) {
       retried = true;
       await agent.prompt(MISSED_FENCE_RETRY_USER_TEXT);
       if (agent.state.errorMessage) {
@@ -531,7 +536,7 @@ export async function runContactTurn({
         throw error;
       }
     }
-    if (requested.length > 0 && !contactTurnHasToolResult(agent.state.messages)) {
+    if (requested.length > 0 && !hasRequestedResult() && !contactTurnHasSuccessfulReset(agent.state.messages)) {
       return {
         text: MISSED_TOOL_FAILURE_BUBBLE,
         bubbles: [MISSED_TOOL_FAILURE_BUBBLE],
@@ -543,12 +548,17 @@ export async function runContactTurn({
     const outcome = extractContactTurnOutcome(agent.state.messages, retried);
     const text = stripContactToolFences(outcome.text);
     if (contactTurnHasSuccessfulReset(agent.state.messages)) {
-      const bubbles = confirmBubbleAfterContactReset(splitContactBubbles(text));
+      const historyCleared = contactTurnClearedChatHistory(agent.state.messages);
+      const preferredConfirm = historyCleared
+        ? CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE
+        : NEW_CONVERSATION_CONFIRM_BUBBLE;
+      const bubbles = confirmBubbleAfterContactReset(splitContactBubbles(text), preferredConfirm);
       return {
-        text: bubbles[0] || NEW_CONVERSATION_CONFIRM_BUBBLE,
+        text: bubbles[0] || preferredConfirm,
         bubbles,
         cards: [],
         reset: true,
+        historyCleared,
         thinkingLevel: agent.state.thinkingLevel,
         tools: [...agent.state.tools],
       };

package/server/lib/assistants/harness.test.js

@@ -211,6 +211,65 @@ describe('createContactStreamFn', () => {
 })
 
 describe('runContactTurn', () => {
+  it('keeps all eleven tools and assigns a session after reading a skill', async () => {
+    const workspace = fs.mkdtempSync(path.join(os.tmpdir(), 'oc-contact-mixed-'))
+    const home = path.join(workspace, 'home')
+    const skillDir = path.join(workspace, '.agents', 'skills', 'docs')
+    fs.mkdirSync(skillDir, { recursive: true })
+    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), '---\nname: docs\ndescription: Read documentation\n---\nRead project docs.\n')
+    const assignWork = vi.fn(async () => ({ sessionID: 'ses_mixed', directory: workspace, title: 'Fix', status: 'busy' }))
+    const tools = createContactTools({ assignWork })
+    const replies = [
+      '```openchamber-tool\n{"name":"read","arguments":{"path":".agents/skills/docs/SKILL.md"}}\n```',
+      'Only documentation search is available.',
+      `\`\`\`openchamber-tool\n${JSON.stringify({ name: 'assign_session', arguments: { prompt: 'Fix the issue', projectPath: workspace } })}\n\`\`\``,
+      'Session opened.',
+    ]
+    let call = 0
+    const createChatCompletion = vi.fn(async ({ body }) => {
+      expect(body.messages[0].content).toContain('assign_session')
+      expect(body.messages[0].content).toContain('docs')
+      const content = replies[call++]
+      if (!content) throw new Error('Unexpected completion')
+      return { completion: { choices: [{ message: { content } }] } }
+    })
+    try {
+      const result = await runContactTurn({
+        assistant: { providerID: 'p', modelID: 'm', effectiveWorkspacePath: workspace, defaultPrompt: 'Keep replies short.' },
+        history: [], userText: '再建个会话去修这个问题', tools,
+        projects: [{ id: 'project', path: workspace }], skillHomeDir: home, createChatCompletion,
+      })
+      expect(result.tools.map((tool) => tool.name)).toEqual([...PI_CODING_TOOL_NAMES, ...tools.map((tool) => tool.name)])
+      expect(assignWork).toHaveBeenCalledTimes(1)
+      expect(result.cards).toEqual([expect.objectContaining({ sessionID: 'ses_mixed' })])
+      expect(createChatCompletion).toHaveBeenCalledTimes(4)
+    } finally {
+      fs.rmSync(workspace, { recursive: true, force: true })
+    }
+  })
+  it('retries assignment after an unrelated read result', async () => {
+    const prompts = []
+    function AgentImpl(options) {
+      this.state = { ...options.initialState, messages: [] }
+      this.prompt = async (text) => {
+        prompts.push(text)
+        if (prompts.length === 1) {
+          this.state.messages.push({ role: 'toolResult', toolName: 'read', content: [{ type: 'text', text: 'Skill instructions' }] })
+          this.state.messages.push({ role: 'assistant', content: [{ type: 'text', text: 'Only document search is available.' }] })
+        } else {
+          this.state.messages.push({ role: 'user', content: text })
+          this.state.messages.push({ role: 'toolResult', toolName: 'assign_session', content: [{ type: 'text', text: 'Opened session.' }] })
+        }
+      }
+    }
+    const result = await runContactTurn({
+      assistant: { providerID: 'p', modelID: 'm', defaultPrompt: '' },
+      history: [], userText: '建会话', tools: createContactTools(),
+      createChatCompletion: vi.fn(), AgentImpl,
+    })
+    expect(prompts).toHaveLength(2)
+    expect(result.bubbles).toEqual(['Opened session.'])
+  })
   it('runs pi-agent-core with thinking off and no tools by default', async () => {
     const prompt = vi.fn(async function prompt() {
       this.state.messages = [{
@@ -653,8 +712,9 @@ describe('runContactTurn', () => {
   })
 
   it('keeps only the new_conversation confirm and drops leftover attachment text', async () => {
-    const resetContact = vi.fn(async () => ({ reset: true }))
-    const tools = createContactTools({ resetContact })
+    const clearContactMemory = vi.fn(async () => ({ reset: true, memoryCleared: true }))
+    const resetContact = vi.fn(async () => ({ reset: true, historyCleared: true }))
+    const tools = createContactTools({ clearContactMemory, resetContact })
     function AgentImpl(options) {
       this.state = { ...options.initialState, messages: options.initialState.messages }
       this.prompt = async () => {
@@ -687,8 +747,10 @@ describe('runContactTurn', () => {
       tools,
       AgentImpl,
     })
-    expect(resetContact).toHaveBeenCalledTimes(1)
+    expect(clearContactMemory).toHaveBeenCalledTimes(1)
+    expect(resetContact).not.toHaveBeenCalled()
     expect(result.reset).toBe(true)
+    expect(result.historyCleared).toBe(false)
     expect(result.cards).toEqual([])
     expect(result.bubbles).toEqual([NEW_CONVERSATION_CONFIRM_BUBBLE])
     expect(result.bubbles.join('')).not.toContain('dot.png')

package/server/lib/assistants/service.js

@@ -9,6 +9,7 @@ import { getWorktrees as defaultListWorktrees } from '../git/service.js';
 import { contactCardIdentity, parseContactCard, parseContactPart } from './cards.js';
 import {
   CONTACT_SETTLE_TEXT,
+  clearContactMemory as clearContactMemoryStore,
   contactHistoryForLlm,
   deleteContactMessages,
   ensureContactSchema,
@@ -23,12 +24,16 @@ import {
 import {
   ASSIGNED_SESSION_FALLBACK_BUBBLE,
   boundSessionListLimit,
+  CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE,
   confirmBubbleAfterContactReset,
+  contactTurnClearedChatHistory,
   createContactTools,
   filterRegisteredProjects,
   matchesProjectQuery,
+  NEW_CONVERSATION_CONFIRM_BUBBLE,
   normalizeRegisteredProjects,
   sanitizeRegisteredProject,
+  userTextAuthorizesClearChatHistory,
 } from './contact-tools.js';
 import { AssignError, ASSIGN_CODES, assignSession, resolveAssignDirectory } from './assign.js';
 import { runContactTurn as defaultRunContactTurn } from './harness.js';
@@ -1026,9 +1031,6 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
     if (!userText) fail('validation_error');
     const userParts = userContactParts(input, userText);
     const row = active(assistantID);
-    // Snapshot history before admitting the user so the harness does not see a
-    // duplicate of the current userText (prompt still receives userText).
-    const history = contactHistoryForLlm(db, assistantID);
     if (typeof createChatCompletion !== 'function' && runContactTurn === defaultRunContactTurn) fail('upstream_error');
     let registeredProjects = [];
     try {
@@ -1056,18 +1058,51 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
       messageID,
     });
     contactTurnSettlement(messageID);
+    // Authorize wipe from this turn's real userText only — not tool args.
+    const clearChatHistoryAuthorized = userTextAuthorizesClearChatHistory(userText);
     const kickTurn = () => {
       void inContactTurnLane(row.assistant_id, async () => {
+        // Load the LLM window when the lane runs — not at admit time — so a
+        // prior turn's clear-memory cannot leave queued work with stale history.
+        // Exclude the admitted user row; prompt still receives userText/parts.
+        // beforeOrdinal caps later-admitted queued user rows out of this turn.
+        const admitted = db.prepare(
+          'SELECT ordinal FROM assistant_contact_message WHERE message_id=?',
+        ).get(messageID);
+        const parsedOrdinal = admitted?.ordinal == null ? NaN : Number(admitted.ordinal);
+        const beforeOrdinal = Number.isFinite(parsedOrdinal) ? parsedOrdinal : null;
+        const history = contactHistoryForLlm(db, row.assistant_id, {
+          excludeMessageIDs: [messageID],
+          beforeOrdinal,
+        });
         const assignedCards = [];
         let contactResetThisTurn = false;
+        let contactHistoryClearedThisTurn = false;
         const tools = createContactTools({
           assignWork: (params) => assignWork(row, params),
           createAssistant: (toolInput) => createAssistant(toolInput),
           scheduleTask: (params) => scheduleWork(row, params),
           deliverPeerMessage: (toolInput) => deliverPeerMessage(row.assistant_id, toolInput),
+          clearContactMemory: () => {
+            // Cap the watermark at this turn's user ordinal — never global MAX,
+            // or later-admitted queued users are permanently excluded from LLM history.
+            const result = clearContactMemory(row.assistant_id, {
+              upToOrdinal: beforeOrdinal,
+            });
+            contactResetThisTurn = true;
+            return result;
+          },
           resetContact: () => {
+            // Server core gate: model mis-select cannot self-authorize delete.
+            if (!clearChatHistoryAuthorized) {
+              throw new AssignError(
+                ASSIGN_CODES.VALIDATION,
+                'clear_chat_history requires explicit user wipe intent in this message.',
+              );
+            }
             const result = resetContact(row.assistant_id);
             contactResetThisTurn = true;
+            contactHistoryClearedThisTurn = true;
             return result;
           },
           listAssistants: () => db.prepare('SELECT * FROM assistant_v2 WHERE tombstone_at IS NULL ORDER BY created_at').all().map(output),
@@ -1107,8 +1142,14 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
             return;
           }
           const resetThisTurn = contactResetThisTurn || generated?.reset === true;
+          const historyClearedThisTurn = contactHistoryClearedThisTurn
+            || contactTurnClearedChatHistory(generated?.messages)
+            || generated?.historyCleared === true;
+          const preferredConfirm = historyClearedThisTurn
+            ? CLEAR_CHAT_HISTORY_CONFIRM_BUBBLE
+            : NEW_CONVERSATION_CONFIRM_BUBBLE;
           const bubbles = resetThisTurn
-            ? confirmBubbleAfterContactReset(generated?.bubbles)
+            ? confirmBubbleAfterContactReset(generated?.bubbles, preferredConfirm)
             : (Array.isArray(generated?.bubbles) ? generated.bubbles.filter((item) => typeof item === 'string' && item.trim()) : []);
           const cards = resetThisTurn
             ? []
@@ -1134,8 +1175,9 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
             resolveContactTurnSettlement(messageID, { status: 'error', error: detail });
             return;
           }
-          // new_conversation wipes the transcript (including the admitted user row).
-          // Re-admit the reset user message, then persist only the confirm bubble.
+          // clear_chat_history / resetContact wipe the transcript (including the
+          // admitted user row). Re-admit that user message, then persist only the
+          // confirm bubble. new_conversation keeps rows and only moves the watermark.
           if (resetThisTurn) {
             const existingUser = db.prepare('SELECT 1 AS ok FROM assistant_contact_message WHERE message_id=?').get(messageID);
             if (!existingUser) {
@@ -1201,8 +1243,32 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
     return listContactMessages(db, assistantID, { before: query.before, limit });
   };
   /**
-   * Clear this assistant's OpenChamber contact transcript (messages, parts,
-   * watches). Does not call OpenCode session/new — that is worker binding.
+   * Clear LLM memory only: advance the durable context boundary so later
+   * contactHistoryForLlm drops prior turns. Transcript GET keeps every row.
+   * Failed writes roll back and keep the previous boundary. Does not call
+   * OpenCode session/new.
+   */
+  const clearContactMemory = (assistantID, options = {}) => {
+    const row = editable(assistantID);
+    const upToOrdinal = options && typeof options === 'object' ? options.upToOrdinal : undefined;
+    db.exec('BEGIN IMMEDIATE');
+    try {
+      const cleared = clearContactMemoryStore(db, row.assistant_id, {
+        updatedAt: now(),
+        ...(upToOrdinal !== undefined ? { upToOrdinal } : {}),
+      });
+      bump();
+      db.exec('COMMIT');
+      return { assistantID: row.assistant_id, reset: true, memoryCleared: true, afterOrdinal: cleared.afterOrdinal };
+    } catch (error) {
+      db.exec('ROLLBACK');
+      throw error;
+    }
+  };
+  /**
+   * Delete this assistant's OpenChamber contact transcript (messages, parts,
+   * watches) and clear the context boundary. Intentional wipe only — also the
+   * POST /contact/reset contract. Does not call OpenCode session/new.
    */
   const resetContact = (assistantID) => {
     const row = editable(assistantID);
@@ -1215,7 +1281,7 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
       db.exec('ROLLBACK');
       throw error;
     }
-    return { assistantID: row.assistant_id, reset: true };
+    return { assistantID: row.assistant_id, reset: true, historyCleared: true };
   };
   const appendContactCard = (assistantID, input) => {
     const row = active(assistantID);
@@ -1371,5 +1437,5 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
       db.exec('ROLLBACK');
       throw error;
     }
-  }, ensure, createNew, compact, send, whenContactTurnSettled, abort, captureQueueDeliveryTarget, sendWithCapturedConfig, share, shareOperation, historicalMessages, contactMessages, resetContact, appendContactCard, deliverPeerMessage, listAssistantScheduledTasks, processEvent, reportAssignedSessionSettle: reportAssignedSession, reconcile, close: () => { if (!closed) { closed = true; unsubscribeEvents?.(); clearIntervalFn(timer); db.close(); } } };
+  }, ensure, createNew, compact, send, whenContactTurnSettled, abort, captureQueueDeliveryTarget, sendWithCapturedConfig, share, shareOperation, historicalMessages, contactMessages, clearContactMemory, resetContact, appendContactCard, deliverPeerMessage, listAssistantScheduledTasks, processEvent, reportAssignedSessionSettle: reportAssignedSession, reconcile, close: () => { if (!closed) { closed = true; unsubscribeEvents?.(); clearIntervalFn(timer); db.close(); } } };
 };