@openchambery/web 1.19.7 → 1.19.8-beta.10

package/server/lib/assistants/pi-tools.js

@@ -0,0 +1,118 @@
+import os from 'node:os';
+import path from 'node:path';
+import {
+  createBashTool,
+  createEditTool,
+  createReadTool,
+  createWriteTool,
+  formatSkillsForSystemPrompt,
+  loadSkills,
+} from '@earendil-works/pi-agent-core';
+import { NodeExecutionEnv } from '@earendil-works/pi-agent-core/node';
+
+const EXTERNAL_SKILL_ROOTS = Object.freeze(['.claude', '.agents']);
+
+export const PI_CODING_TOOL_NAMES = Object.freeze(['read', 'write', 'edit', 'bash']);
+const PI_CODING_TOOL_NAME_SET = new Set(PI_CODING_TOOL_NAMES);
+
+export function isPiCodingToolName(name) {
+  return typeof name === 'string' && PI_CODING_TOOL_NAME_SET.has(name);
+}
+
+export function resolveAssistantCwd(assistant) {
+  for (const value of [assistant?.effectiveWorkspacePath, assistant?.workspacePath]) {
+    if (typeof value === 'string' && value.trim()) return value.trim();
+  }
+  return null;
+}
+
+/** Global ~/.claude/skills + ~/.agents/skills, then this project cwd (.claude then .agents). Later dirs win on name. */
+export function collectAssistantSkillDirectories(cwd, { homeDir = os.homedir() } = {}) {
+  const dirs = [];
+  const seen = new Set();
+  const push = (dir) => {
+    if (typeof dir !== 'string' || !dir.trim()) return;
+    const resolved = path.resolve(dir);
+    if (seen.has(resolved)) return;
+    seen.add(resolved);
+    dirs.push(resolved);
+  };
+  const home = typeof homeDir === 'string' && homeDir.trim() ? path.resolve(homeDir.trim()) : os.homedir();
+  for (const root of EXTERNAL_SKILL_ROOTS) {
+    push(path.join(home, root, 'skills'));
+  }
+  if (typeof cwd === 'string' && cwd.trim()) {
+    const project = path.resolve(cwd.trim());
+    for (const root of EXTERNAL_SKILL_ROOTS) {
+      push(path.join(project, root, 'skills'));
+    }
+  }
+  return dirs;
+}
+
+export function mergeSkillsByName(skills) {
+  const map = new Map();
+  for (const skill of Array.isArray(skills) ? skills : []) {
+    const name = typeof skill?.name === 'string' ? skill.name.trim() : '';
+    if (!name) continue;
+    map.set(name, skill);
+  }
+  return [...map.values()];
+}
+
+const bindHarnessTool = (tool, context) => ({
+  name: tool.name,
+  label: tool.label,
+  description: tool.description,
+  parameters: tool.parameters,
+  execute: (toolCallId, params, signal, onUpdate) => (
+    tool.execute(toolCallId, params, signal, onUpdate, context)
+  ),
+});
+
+export function formatPiCodingPrompt({ cwd, skillsPrompt = '' } = {}) {
+  if (typeof cwd !== 'string' || !cwd.trim()) return '';
+  return [
+    `Working directory: ${cwd}`,
+    'You have pi coding tools in this directory: read, write, edit, bash.',
+    'This is your working directory. Ignore any other cwd from the environment, including temporary generator workspaces under /var/folders or os.tmpdir.',
+    'When the user asks pwd, the current directory, or to look at files, call bash/read yourself. Never say you have no terminal or cannot read or write files.',
+    'Skills are merged from ~/.claude/skills, ~/.agents/skills, and this project\'s .claude/skills plus .agents/skills (project wins on name). Read a skill file when the task matches its description.',
+    'Call these tools with the same fenced JSON as other tools:',
+    '```openchamber-tool',
+    '{"name":"bash","arguments":{"command":"pwd"}}',
+    '```',
+    '```openchamber-tool',
+    '{"name":"read","arguments":{"path":".agents/skills/example/SKILL.md"}}',
+    '```',
+    typeof skillsPrompt === 'string' && skillsPrompt.trim() ? skillsPrompt.trim() : '',
+  ].filter(Boolean).join('\n');
+}
+
+export async function createPiCodingRuntime(cwd, { homeDir = os.homedir() } = {}) {
+  if (typeof cwd !== 'string' || !cwd.trim()) return null;
+  const resolved = cwd.trim();
+  const env = new NodeExecutionEnv({ cwd: resolved });
+  const context = { env };
+  const tools = [
+    bindHarnessTool(createReadTool(), context),
+    bindHarnessTool(createWriteTool(), context),
+    bindHarnessTool(createEditTool(), context),
+    bindHarnessTool(createBashTool(), context),
+  ];
+  let skillsPrompt = '';
+  try {
+    const loaded = await loadSkills(env, collectAssistantSkillDirectories(resolved, { homeDir }));
+    skillsPrompt = formatSkillsForSystemPrompt(mergeSkillsByName(loaded?.skills));
+  } catch {
+    skillsPrompt = '';
+  }
+  return {
+    cwd: resolved,
+    tools,
+    skillsPrompt,
+    close: async () => {
+      await env.cleanup();
+    },
+  };
+}

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

@@ -0,0 +1,114 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import {
+  collectAssistantSkillDirectories,
+  createPiCodingRuntime,
+  mergeSkillsByName,
+  PI_CODING_TOOL_NAMES,
+  resolveAssistantCwd,
+} from './pi-tools.js';
+
+const temps = [];
+const temp = () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'oc-pi-tools-'));
+  temps.push(dir);
+  return dir;
+};
+const writeSkill = (root, name, description = `${name} skill`) => {
+  const dir = path.join(root, name);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(path.join(dir, 'SKILL.md'), `---\nname: ${name}\ndescription: ${description}\n---\nInstructions for ${name}\n`);
+};
+
+afterEach(() => {
+  while (temps.length > 0) {
+    fs.rmSync(temps.pop(), { recursive: true, force: true });
+  }
+});
+
+describe('resolveAssistantCwd', () => {
+  it('prefers effectiveWorkspacePath over workspacePath', () => {
+    expect(resolveAssistantCwd({
+      effectiveWorkspacePath: '/effective',
+      workspacePath: '/workspace',
+    })).toBe('/effective');
+    expect(resolveAssistantCwd({ workspacePath: '/workspace' })).toBe('/workspace');
+    expect(resolveAssistantCwd({ defaultPrompt: 'x' })).toBeNull();
+  });
+});
+
+describe('collectAssistantSkillDirectories', () => {
+  it('lists global ~/.claude and ~/.agents then project .claude and .agents', () => {
+    const home = temp();
+    const cwd = temp();
+    expect(collectAssistantSkillDirectories(cwd, { homeDir: home })).toEqual([
+      path.resolve(home, '.claude', 'skills'),
+      path.resolve(home, '.agents', 'skills'),
+      path.resolve(cwd, '.claude', 'skills'),
+      path.resolve(cwd, '.agents', 'skills'),
+    ]);
+  });
+
+  it('does not invent skill roots on intermediate parent folders', () => {
+    const home = temp();
+    const root = temp();
+    const nested = path.join(root, 'apps', 'web');
+    fs.mkdirSync(nested, { recursive: true });
+    expect(collectAssistantSkillDirectories(nested, { homeDir: home })).toEqual([
+      path.resolve(home, '.claude', 'skills'),
+      path.resolve(home, '.agents', 'skills'),
+      path.resolve(nested, '.claude', 'skills'),
+      path.resolve(nested, '.agents', 'skills'),
+    ]);
+  });
+});
+
+describe('mergeSkillsByName', () => {
+  it('keeps the last skill with the same name', () => {
+    expect(mergeSkillsByName([
+      { name: 'shared', filePath: '/global' },
+      { name: 'shared', filePath: '/project' },
+      { name: 'other', filePath: '/other' },
+    ])).toEqual([
+      { name: 'shared', filePath: '/project' },
+      { name: 'other', filePath: '/other' },
+    ]);
+  });
+});
+
+describe('createPiCodingRuntime', () => {
+  it('installs read/write/edit/bash and merges global plus project skills', async () => {
+    const home = temp();
+    const cwd = temp();
+    writeSkill(path.join(home, '.claude', 'skills'), 'claude-global', 'Claude global');
+    writeSkill(path.join(home, '.agents', 'skills'), 'agents-global', 'Agents global');
+    writeSkill(path.join(cwd, '.claude', 'skills'), 'claude-project', 'Claude project');
+    writeSkill(path.join(cwd, '.agents', 'skills'), 'project-skill', 'Project skill');
+    writeSkill(path.join(home, '.agents', 'skills'), 'shared', 'Global shared');
+    writeSkill(path.join(cwd, '.agents', 'skills'), 'shared', 'Project shared');
+
+    const runtime = await createPiCodingRuntime(cwd, { homeDir: home });
+    expect(runtime.tools.map((tool) => tool.name)).toEqual([...PI_CODING_TOOL_NAMES]);
+    expect(runtime.skillsPrompt).toContain('claude-global');
+    expect(runtime.skillsPrompt).toContain('agents-global');
+    expect(runtime.skillsPrompt).toContain('claude-project');
+    expect(runtime.skillsPrompt).toContain('project-skill');
+    expect(runtime.skillsPrompt).toContain('Project shared');
+    expect(runtime.skillsPrompt).not.toContain('Global shared');
+    await runtime.close();
+  });
+
+  it('runs bash pwd in the workspace', async () => {
+    const cwd = temp();
+    const home = temp();
+    const runtime = await createPiCodingRuntime(cwd, { homeDir: home });
+    const bash = runtime.tools.find((tool) => tool.name === 'bash');
+    const result = await bash.execute('call_pwd', { command: 'pwd' });
+    const text = result.content.map((part) => part.text).join('');
+    const resolved = fs.realpathSync(cwd);
+    expect(text.includes(cwd) || text.includes(resolved)).toBe(true);
+    await runtime.close();
+  });
+});

package/server/lib/llm/DOCUMENTATION.md

@@ -41,10 +41,15 @@ The 1.18.4 client exposes `GET /provider`, `GET /config/providers`, and
    Non-vision models (for example deepseek-v4-flash) keep the `[image: …]`
    description and any text-file bytes, and skip image data URLs so generate
    cannot stall on unsupported vision parts. Non-image
-   text files are also inlined into the flattened prompt. Wait for idle via
-   `session.status` + `session.messages`, then delete the session. This is a
-    text generator only — never the contact transcript and never a coding
-    SessionPrompt loop. Upstream `info.error.message` is forwarded on 502.
+    text files are also inlined into the flattened prompt. Wait for idle via
+    `session.status` + `session.messages`, then delete the session. Throwaway
+    sessions are created with
+    `metadata.openchamber.llm.purpose = 'chat-completions'` (and archived
+    immediately) so sidebar visibility, session-index, session-title, and
+    notification/push fanout treat them as system-owned — same contract as
+    non-empty `smallModel.purpose`. This is a text generator only — never the
+    contact transcript and never a coding SessionPrompt loop. Upstream
+    `info.error.message` is forwarded on 502.
 
 ### Internal token callback (in-process only)
 

package/server/lib/llm/generate.test.js

@@ -78,6 +78,7 @@ describe('generateOpenCodeText', () => {
 
     expect(create).toHaveBeenCalledWith(expect.objectContaining({
       title: expect.stringContaining('[openchamber-llm]'),
+      metadata: { openchamber: { llm: { purpose: 'chat-completions' } } },
     }), expect.anything())
     expect(update).toHaveBeenCalled()
     expect(promptAsync).toHaveBeenCalledWith(expect.objectContaining({

package/server/lib/notifications/DOCUMENTATION.md

@@ -47,7 +47,7 @@ This module provides notification message preparation utilities for the web serv
 - Returned API:
   - `maybeSendPushForTrigger(payload)`
 - Owns:
-  - top-level completion/question/permission trigger routing; completion is the sole task-status notification. Ordinary push is limited to sidebar-visible root sessions. Child/subagent sessions, Assistant bindings (`openchamber.assistant.assistantID` unless `assigned.from === 'contact'`), scheduled-task sessions, small-model system sessions (`metadata.openchamber.smallModel.purpose`), and `smartfetch-secondary` titles are suppressed. Contact-assigned workers stay visible and still notify.
+  - top-level completion/question/permission trigger routing; completion is the sole task-status notification. Ordinary push is limited to sidebar-visible root sessions. Child/subagent sessions, Assistant bindings (`openchamber.assistant.assistantID` unless `assigned.from === 'contact'`), scheduled-task sessions, small-model system sessions (`metadata.openchamber.smallModel.purpose`), LLM gateway throwaway sessions (`metadata.openchamber.llm.purpose`), and `smartfetch-secondary` titles are suppressed. Contact-assigned workers stay visible and still notify.
   - contact-turn notifications (`sendContactTurnNotification`) are a separate SMS-style path: title is the assistant nickname, body is the spoken message text, on desktop / UI SSE / web-push / APNs. APNs does **not** rewrite these into the generic "Task completed" scenario title.
   - top-level completion/error Live Activity `end` (`sendLiveActivityEnd`), independent of ordinary push settings and UI visibility, with the same hidden-session suppression; duplicate terminal events are idempotent at the token store
   - session meta cache for sidebar-visibility suppression

package/server/lib/notifications/runtime.js

@@ -185,6 +185,9 @@ export const createNotificationTriggerRuntime = (deps) => {
       smallModelPurpose: meta.smallModelPurpose !== undefined
         ? meta.smallModelPurpose
         : (previous?.smallModelPurpose ?? null),
+      llmPurpose: meta.llmPurpose !== undefined
+        ? meta.llmPurpose
+        : (previous?.llmPurpose ?? null),
       assistantID: meta.assistantID !== undefined ? meta.assistantID : (previous?.assistantID ?? null),
       assignedFrom: meta.assignedFrom !== undefined ? meta.assignedFrom : (previous?.assignedFrom ?? null),
       scheduledTaskID: meta.scheduledTaskID !== undefined
@@ -202,6 +205,9 @@ export const createNotificationTriggerRuntime = (deps) => {
       : null;
     return {
       smallModelPurpose: normalizeSmallModelPurpose(openchamber?.smallModel?.purpose),
+      // Throwaway LLM gateway sessions (`metadata.openchamber.llm.purpose`) share
+      // the same sidebar-hidden contract as small-model system sessions.
+      llmPurpose: normalizeSmallModelPurpose(openchamber?.llm?.purpose),
       assistantID: nonEmptySystemID(openchamber?.assistant?.assistantID)
         ? openchamber.assistant.assistantID
         : null,
@@ -292,6 +298,7 @@ export const createNotificationTriggerRuntime = (deps) => {
     if (!meta) return false;
     if (typeof meta.parentID === 'string' && meta.parentID.length > 0) return true;
     if (typeof meta.smallModelPurpose === 'string' && meta.smallModelPurpose.length > 0) return true;
+    if (typeof meta.llmPurpose === 'string' && meta.llmPurpose.length > 0) return true;
     if (typeof meta.assistantID === 'string' && meta.assistantID.length > 0 && meta.assignedFrom !== 'contact') {
       return true;
     }
@@ -302,8 +309,8 @@ export const createNotificationTriggerRuntime = (deps) => {
 
   // Only sessions that can appear as sidebar roots get ordinary push. Child /
   // subagent sessions, archived Assistant bindings, scheduled-task sessions,
-  // small-model system sessions, and SmartFetch secondaries are excluded.
-  // Contact-assigned worker sessions stay visible and still notify.
+  // small-model / LLM gateway system sessions, and SmartFetch secondaries are
+  // excluded. Contact-assigned worker sessions stay visible and still notify.
   const shouldSkipSystemSessionNotification = async (sessionId, directory) => {
     const meta = await fetchSessionMeta(sessionId, directory);
     return isHiddenFromNavSession(meta);

package/server/lib/notifications/runtime.test.js

@@ -229,6 +229,150 @@ describe('notification trigger runtime smallModel suppression', () => {
   });
 });
 
+describe('notification trigger runtime llm system-session suppression', () => {
+  const llmSessionResponse = (purpose = 'chat-completions') => jsonResponse({
+    id: 'ses_llm',
+    parentID: null,
+    title: '[openchamber-llm] generate',
+    metadata: { openchamber: { llm: { purpose } } },
+  });
+
+  const expectAllOutletsSilent = ({
+    emitDesktopNotification,
+    broadcastUiNotification,
+    sendPushToAllUiSessions,
+    sendApnsToAllUiSessions,
+    sendLiveActivityEnd,
+  }) => {
+    expect(emitDesktopNotification).not.toHaveBeenCalled();
+    expect(broadcastUiNotification).not.toHaveBeenCalled();
+    expect(sendPushToAllUiSessions).not.toHaveBeenCalled();
+    expect(sendApnsToAllUiSessions).not.toHaveBeenCalled();
+    expect(sendLiveActivityEnd).not.toHaveBeenCalled();
+  };
+
+  it('skips ready notifications for llm sessions fetched by id', async () => {
+    vi.stubGlobal('fetch', vi.fn(async () => llmSessionResponse()));
+    const outlets = createRuntime();
+    await outlets.runtime.maybeSendPushForTrigger(completionPayload('ses_llm'));
+    expectAllOutletsSilent(outlets);
+  });
+
+  it('skips ready notifications synthesized from session.idle for llm sessions', async () => {
+    vi.stubGlobal('fetch', vi.fn(async () => llmSessionResponse()));
+    const outlets = createRuntime();
+    await outlets.runtime.maybeSendPushForTrigger({
+      type: 'session.idle',
+      properties: {
+        directory: '/repo',
+        sessionID: 'ses_llm',
+      },
+    });
+    expectAllOutletsSilent(outlets);
+  });
+
+  it('skips error notifications and live-activity end for llm sessions', async () => {
+    vi.stubGlobal('fetch', vi.fn(async () => llmSessionResponse()));
+    const outlets = createRuntime();
+    await outlets.runtime.maybeSendPushForTrigger({
+      type: 'session.error',
+      properties: {
+        directory: '/repo',
+        sessionID: 'ses_llm',
+        error: 'boom',
+      },
+    });
+    expectAllOutletsSilent(outlets);
+  });
+
+  it('skips question notifications for llm sessions', async () => {
+    vi.useFakeTimers();
+    vi.stubGlobal('fetch', vi.fn(async () => llmSessionResponse()));
+    const outlets = createRuntime();
+    await outlets.runtime.maybeSendPushForTrigger({
+      type: 'question.asked',
+      properties: {
+        directory: '/repo',
+        sessionID: 'ses_llm',
+        questions: [{ header: 'Input needed', question: 'Continue?' }],
+      },
+    });
+    await vi.runAllTimersAsync();
+    expectAllOutletsSilent(outlets);
+  });
+
+  it('skips permission notifications for llm sessions', async () => {
+    vi.useFakeTimers();
+    vi.stubGlobal('fetch', vi.fn(async () => llmSessionResponse()));
+    const outlets = createRuntime();
+    await outlets.runtime.maybeSendPushForTrigger({
+      type: 'permission.asked',
+      properties: {
+        directory: '/repo',
+        sessionID: 'ses_llm',
+        id: 'perm_llm',
+        permission: 'edit',
+      },
+    });
+    await vi.runAllTimersAsync();
+    expectAllOutletsSilent(outlets);
+  });
+
+  it('uses session.updated event cache so later idle stays suppressed without llm on fetch', async () => {
+    const fetchMock = vi.fn(async () => jsonResponse({
+      id: 'ses_llm',
+      parentID: null,
+      title: 'Ordinary after strip',
+      metadata: {},
+    }));
+    vi.stubGlobal('fetch', fetchMock);
+    const outlets = createRuntime();
+    await outlets.runtime.maybeSendPushForTrigger({
+      type: 'session.updated',
+      properties: {
+        directory: '/repo',
+        info: {
+          id: 'ses_llm',
+          sessionID: 'ses_llm',
+          parentID: null,
+          title: '[openchamber-llm] generate',
+          metadata: { openchamber: { llm: { purpose: 'chat-completions' } } },
+        },
+      },
+    });
+    await outlets.runtime.maybeSendPushForTrigger({
+      type: 'session.idle',
+      properties: {
+        directory: '/repo',
+        sessionID: 'ses_llm',
+      },
+    });
+    expect(fetchMock).not.toHaveBeenCalled();
+    expectAllOutletsSilent(outlets);
+  });
+
+  it('does not treat empty llm.purpose as a hidden system session', async () => {
+    vi.stubGlobal('fetch', vi.fn(async () => jsonResponse({
+      id: 'ses_llm_empty',
+      parentID: null,
+      title: 'Looks like llm',
+      metadata: { openchamber: { llm: { purpose: '' } } },
+    })));
+    const {
+      runtime,
+      emitDesktopNotification,
+      sendPushToAllUiSessions,
+      sendApnsToAllUiSessions,
+      sendLiveActivityEnd,
+    } = createRuntime();
+    await runtime.maybeSendPushForTrigger(completionPayload('ses_llm_empty'));
+    expect(emitDesktopNotification).toHaveBeenCalledTimes(1);
+    expect(sendPushToAllUiSessions).toHaveBeenCalledTimes(1);
+    expect(sendApnsToAllUiSessions).toHaveBeenCalledTimes(1);
+    expect(sendLiveActivityEnd).toHaveBeenCalledWith({ sessionId: 'ses_llm_empty', status: 'complete' });
+  });
+});
+
 const rootSessionResponse = () => jsonResponse({
   id: 'ses_root',
   parentID: null,

package/server/lib/session-index/DOCUMENTATION.md

@@ -18,8 +18,9 @@ the index excludes them from every snapshot and clears prior summaries when a
   `metadata.openchamber.assistant.assistantID` (unless
   `metadata.openchamber.assigned.from === 'contact'` — those are visible
   coding workers the Assistant subscribed to),
-  `metadata.openchamber.scheduledTask.taskID`, or
-  `metadata.openchamber.smallModel.purpose`. Title prefixes are human labels and
+  `metadata.openchamber.scheduledTask.taskID`,
+  `metadata.openchamber.smallModel.purpose`, or
+  `metadata.openchamber.llm.purpose`. Title prefixes are human labels and
   never participate in this filter. Metadata is the ownership/isolation signal;
 `time.archived` is archive state; `time.pinned` is OpenChamber-owned pin state
 overlaid from the independent `session_pin` table (also mirrored onto in-window

package/server/lib/session-index/service.js

@@ -20,6 +20,7 @@ const isSystemSession = (session) => {
   if (nonEmptySystemID(openchamber.assistant?.assistantID) && !isContactAssignedSession(openchamber)) return true;
   if (nonEmptySystemID(openchamber.scheduledTask?.taskID)) return true;
   if (nonEmptySystemID(openchamber.smallModel?.purpose)) return true;
+  if (nonEmptySystemID(openchamber.llm?.purpose)) return true;
   return false;
 };
 

package/server/lib/session-index/service.test.js

@@ -68,7 +68,7 @@ describe('Electron session index', () => {
     service.close();
   });
 
-  it('excludes Assistant, Scheduled, and smallModel system sessions from ordinary sidebar summaries', () => {
+  it('excludes Assistant, Scheduled, smallModel, and llm system sessions from ordinary sidebar summaries', () => {
     const runtimeRef = { value: 'http://runtime-a.test' };
     const service = createService(runtimeRef);
     const assistantSession = {
@@ -83,11 +83,15 @@ describe('Electron session index', () => {
       ...session('ses_small_model', 97),
       metadata: { openchamber: { smallModel: { purpose: 'session-title' } } },
     };
+    const llmSession = {
+      ...session('ses_llm', 96),
+      metadata: { openchamber: { llm: { purpose: 'chat-completions' } } },
+    };
     const ordinary = session('ses_ordinary', 98);
 
     service.replaceDirectory({
       directory: '/repo',
-      sessions: [assistantSession, scheduledSession, smallModelSession, ordinary],
+      sessions: [assistantSession, scheduledSession, smallModelSession, llmSession, ordinary],
       cursor: null,
       hasMore: false,
     });
@@ -96,6 +100,7 @@ describe('Electron session index', () => {
     service.upsert(assistantSession);
     service.upsert(scheduledSession);
     service.upsert(smallModelSession);
+    service.upsert(llmSession);
     expect(service.snapshot().directories[0].sessions.map((item) => item.id)).toEqual(['ses_ordinary']);
     service.close();
   });

package/server/lib/session-title/DOCUMENTATION.md

@@ -35,9 +35,10 @@ throttle (`TITLE_THROTTLE_MS`) when a refresh is armed.
   3. On fire:
     - Skip when Settings → Chat → session title refresh is off.
     - Skip system-owned sessions whose metadata carries a non-empty
-      `openchamber.assistant.assistantID`, `openchamber.scheduledTask.taskID`, or
-      `openchamber.smallModel.purpose`
-      (fixed Assistant / scheduled / small-model titles must not be rewritten). Early
+      `openchamber.assistant.assistantID`, `openchamber.scheduledTask.taskID`,
+      `openchamber.smallModel.purpose`, or `openchamber.llm.purpose`
+      (fixed Assistant / scheduled / small-model / LLM gateway titles must not be
+      rewritten). Early
       `session.created` and smart-title request extraction skip the same
       metadata when present so timers are not armed.
     - Skip sub-agent sessions (`parentID`), multi-run/fusion structural titles,

package/server/lib/session-title/runtime.js

@@ -167,6 +167,7 @@ export const isSystemOwnedSession = (sessionOrInfo) => {
   if (typeof openchamber.assistant?.assistantID === 'string' && openchamber.assistant.assistantID) return true;
   if (typeof openchamber.scheduledTask?.taskID === 'string' && openchamber.scheduledTask.taskID) return true;
   if (typeof openchamber.smallModel?.purpose === 'string' && openchamber.smallModel.purpose) return true;
+  if (typeof openchamber.llm?.purpose === 'string' && openchamber.llm.purpose) return true;
   return false;
 };
 

package/server/lib/session-title/runtime.test.js

@@ -235,6 +235,9 @@ describe('session-title helpers', () => {
     expect(isSystemOwnedSession({
       metadata: { openchamber: { smallModel: { purpose: 'session-title' } } },
     })).toBe(true);
+    expect(isSystemOwnedSession({
+      metadata: { openchamber: { llm: { purpose: 'chat-completions' } } },
+    })).toBe(true);
     expect(isSystemOwnedSession({
       title: '[Assistant] Looks system',
       metadata: { openchamber: { assistant: { name: 'no-id' } } },
@@ -242,6 +245,9 @@ describe('session-title helpers', () => {
     expect(isSystemOwnedSession({
       metadata: { openchamber: { smallModel: { purpose: '' } } },
     })).toBe(false);
+    expect(isSystemOwnedSession({
+      metadata: { openchamber: { llm: { purpose: '' } } },
+    })).toBe(false);
     expect(isSystemOwnedSession({ title: 'Ordinary' })).toBe(false);
     expect(isSystemOwnedSession({
       metadata: { openchamber: { assigned: { from: 'contact', assistantID: 'assistant_1' } } },