npm - @openchambery/web - Versions diffs - 1.19.7-beta.2 → 1.19.7-beta.21 - Mend

@openchambery/web 1.19.7-beta.2 → 1.19.7-beta.21

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.

Files changed (187) hide show

package/dist/assets/AgentAvatar-DI2zs2WH.js +1 -0
package/dist/assets/AssistantView-sV1PVQiM.js +2 -0
package/dist/assets/DiagramView-D2hqP5VV.js +1 -0
package/dist/assets/FadeInOnReveal-BWJcUp5P.js +1 -0
package/dist/assets/Icon-4My8YZwt.js +1 -0
package/dist/assets/MarkdownLoadingSkeleton-Vezjvk9B.js +3 -0
package/dist/assets/MarkdownRenderer-x091Z--3.js +2 -0
package/dist/assets/MarkdownRendererImpl-DML8BSro.js +7 -0
package/dist/assets/MarkstreamRendererImpl-BK-HM2k3.js +1 -0
package/dist/assets/{MarkstreamRendererImpl-CR0fBG5w.css → MarkstreamRendererImpl-Ca7RATbs.css} +1 -1
package/dist/assets/MobileDetailNavigation-DcxkWiks.js +1 -0
package/dist/assets/MobileShareBridge-TAGcOiyb.js +4 -0
package/dist/assets/MobileSurface-zqlZzEFQ.js +2 -0
package/dist/assets/{MultiRunWindow-khpnWyZO.js → MultiRunWindow-iH1d9S14.js} +1 -1
package/dist/assets/OnboardingScreen-BNEtPmvw.js +1 -0
package/dist/assets/OverlayScrollbar-BZB21Yp_.js +2 -0
package/dist/assets/SettingsView-CzW23DZA.js +25 -0
package/dist/assets/{SettingsWindow-Dx5rU9v5.js → SettingsWindow-DZXCWZid.js} +1 -1
package/dist/assets/TerminalView-pU0wpD8s.js +8 -0
package/dist/assets/ToolOutputDialog-Bt7JChFG.js +10 -0
package/dist/assets/appThemeRegistry-BI7WR2Wo.js +1 -0
package/dist/assets/{button-z0GOBtWi.js → button-Or0daT9o.js} +1 -1
package/dist/assets/clipboard-BXxLshVq.js +1 -0
package/dist/assets/{collapsible-D9zJRpeB.js → collapsible-C-kzSGkq.js} +1 -1
package/dist/assets/context-menu-Dpjla5p4.js +1 -0
package/dist/assets/desktopHosts-BzSE0sK7.js +1 -0
package/dist/assets/desktopRelayRestore-BaKjk1kQ.js +1 -0
package/dist/assets/{diagram-CoEqmReY.js → diagram-D0mT3mo1.js} +1 -1
package/dist/assets/{dialog-HCE4eLUW.js → dialog-BkhHBTd4.js} +1 -1
package/dist/assets/dropdown-menu.styles-Bzo6L3FH.js +1 -0
package/dist/assets/{es-D9KcV5TX.js → es-BHqnSjoZ.js} +1 -1
package/dist/assets/fileQueries-DFY6Kiy1.js +1 -0
package/dist/assets/fileReferenceActions-Di_DoDex.js +1 -0
package/dist/assets/{fr-DPA9qUl3.js → fr-BfrlJY9i.js} +1 -1
package/dist/assets/{gitApi-DNTMAa3F.js → gitApi-CeFszLvk.js} +3 -3
package/dist/assets/{input-BG3VWTIF.js → input-BUsGnzwe.js} +1 -1
package/dist/assets/insertionBoundaries-DDJNusn2.js +4 -0
package/dist/assets/{ja-Dsif3NoD.js → ja-DP-7qt-x.js} +1 -1
package/dist/assets/{ko-Dixx4Ctg.js → ko-E2B5vGQP.js} +1 -1
package/dist/assets/main-CjnOsKDL.js +169 -0
package/dist/assets/main-j-Ij13jc.js +2 -0
package/dist/assets/markdown-worker-BuveaH3O.js +1 -0
package/dist/assets/markdownTheme-CVS01wHf.js +2 -0
package/dist/assets/miniChat-DgxavREE.js +2 -0
package/dist/assets/mobile-C0rwPMPM.js +2 -0
package/dist/assets/multirun-ot7-bKg7.js +4 -0
package/dist/assets/outsideFileGrants-BB4GPvCq.js +1 -0
package/dist/assets/path-utils-jGozTg9d.js +1 -0
package/dist/assets/persistence-CSZp1CNB.js +3 -0
package/dist/assets/{pl-Bj78ZGgf.js → pl-r8X5gRM5.js} +1 -1
package/dist/assets/platform-CenlWqxu.js +2 -0
package/dist/assets/projectMeta-3yOEc0oI.js +3 -0
package/dist/assets/{pt-BR-CFL3xSAf.js → pt-BR-DcpdXCf5.js} +1 -1
package/dist/assets/renderElectronMiniChatApp-BPNvFA_N.js +2 -0
package/dist/assets/renderMobileApp-CNog29Xy.js +28 -0
package/dist/assets/runtimeConfig-D28kNEYO.js +2 -0
package/dist/assets/runtimeEndpointReset-CorvFIRk.js +147 -0
package/dist/assets/sessionChangeSummary-CX2MJIkc.js +1 -0
package/dist/assets/sessionLookup-CbatbQf7.js +1 -0
package/dist/assets/sortable-tabs-strip-C5gGnikj.js +1 -0
package/dist/assets/src-Af9cMFKF.css +2 -0
package/dist/assets/{store-DzpbXWX1.js → store-BDFdnk6l.js} +2 -2
package/dist/assets/terminalApi-CIIs9vFx.js +1 -0
package/dist/assets/textarea-CIO34TZz.js +1 -0
package/dist/assets/toolHelpers-DEvVP9U0.js +2 -0
package/dist/assets/{tooltip-CtH61mQh.js → tooltip-BSrJYYYc.js} +1 -1
package/dist/assets/{uk-BY60Ub3Z.js → uk-Di0vl9V-.js} +1 -1
package/dist/assets/url-CE_gAfNa.js +1 -0
package/dist/assets/{ChatContainer-CnOrdAgs.js → useAppFontEffects-CDpeZWK4.js} +44 -39
package/dist/assets/useAssistantUIStore-BHacrxe_.js +1 -0
package/dist/assets/useDesktopWindowControlsLayout-D-xPByG0.js +1 -0
package/dist/assets/useEffectiveDirectory-Dp-tez_r.js +1 -0
package/dist/assets/useFontPreferences-BxOHKuVw.js +1 -0
package/dist/assets/useMobileNavigationStore-DE1Pe9A9.js +412 -0
package/dist/assets/useSessionAutoCleanup-jNJ_WC38.js +1 -0
package/dist/assets/useUIStore-CqqO11ZI.js +1 -0
package/dist/assets/useWorkerHighlightedLines-MDnGj3yv.js +7 -0
package/dist/assets/utils-B0mQXN9L.js +1 -0
package/dist/assets/{vendor-markstream-react-CwvbEg9R.js → vendor-markstream-react-C3K8YH0d.js} +4 -4
package/dist/assets/{zh-CN-Cox1LaOW.js → zh-CN-coFCfeQE.js} +1 -1
package/dist/assets/{zh-TW-B6RU0mxa.js → zh-TW-oDRZ1-yb.js} +1 -1
package/dist/index.html +9 -11
package/dist/mini-chat.html +9 -11
package/dist/mobile.html +15 -17
package/package.json +2 -1
package/server/index.js +2 -0
package/server/lib/assistant-delivery-parts.js +3 -1
package/server/lib/assistant-delivery-parts.test.js +11 -0
package/server/lib/assistants/DOCUMENTATION.md +76 -3
package/server/lib/assistants/assign.js +225 -0
package/server/lib/assistants/assign.test.js +118 -0
package/server/lib/assistants/bubbles.js +45 -0
package/server/lib/assistants/bubbles.test.js +36 -0
package/server/lib/assistants/cards.js +148 -0
package/server/lib/assistants/cards.test.js +116 -0
package/server/lib/assistants/contact-store.js +284 -0
package/server/lib/assistants/contact-store.test.js +131 -0
package/server/lib/assistants/contact-tools.js +761 -0
package/server/lib/assistants/contact-tools.test.js +328 -0
package/server/lib/assistants/contracts.js +20 -1
package/server/lib/assistants/harness.js +551 -0
package/server/lib/assistants/harness.test.js +607 -0
package/server/lib/assistants/routes.js +44 -4
package/server/lib/assistants/service.js +930 -17
package/server/lib/assistants/service.test.js +1163 -45
package/server/lib/llm/DOCUMENTATION.md +84 -0
package/server/lib/llm/catalog.js +100 -0
package/server/lib/llm/catalog.test.js +78 -0
package/server/lib/llm/completions.js +151 -0
package/server/lib/llm/completions.test.js +127 -0
package/server/lib/llm/generate.js +570 -0
package/server/lib/llm/generate.test.js +459 -0
package/server/lib/llm/routes.js +47 -0
package/server/lib/llm/temp-directory.js +37 -0
package/server/lib/notifications/APNS.md +23 -17
package/server/lib/notifications/DOCUMENTATION.md +5 -4
package/server/lib/notifications/apns-runtime.js +139 -20
package/server/lib/notifications/apns-runtime.test.js +66 -7
package/server/lib/notifications/apns-titles.js +62 -62
package/server/lib/notifications/apns-titles.test.js +3 -1
package/server/lib/notifications/routes.js +1 -1
package/server/lib/notifications/runtime.js +177 -86
package/server/lib/notifications/runtime.test.js +122 -0
package/server/lib/opencode/feature-routes-runtime.js +30 -0
package/server/lib/opencode/feature-routes-runtime.test.js +20 -0
package/server/lib/opencode/settings-runtime.js +18 -2
package/server/lib/session-goal/DOCUMENTATION.md +8 -1
package/server/lib/session-goal/runtime.js +20 -0
package/server/lib/session-index/DOCUMENTATION.md +3 -1
package/server/lib/session-index/service.js +10 -4
package/server/lib/session-index/service.test.js +37 -0
package/server/lib/session-title/runtime.js +1 -0
package/server/lib/session-title/runtime.test.js +11 -0
package/dist/assets/AgentAvatar-ziUs4sw3.js +0 -1
package/dist/assets/AssistantView-DF4yXFgS.js +0 -1
package/dist/assets/ContextPanel-Cg_uCHzJ.js +0 -285
package/dist/assets/DiagramView-DYh3Zn2y.js +0 -1
package/dist/assets/FadeInOnReveal-BAlsRFJH.js +0 -1
package/dist/assets/Icon-CLpn1mIz.js +0 -1
package/dist/assets/MarkdownRendererImpl-QzUEpBEm.js +0 -7
package/dist/assets/MarkstreamRendererImpl-CXrfeUia.js +0 -1
package/dist/assets/MobileDetailNavigation-DJXEYfq4.js +0 -1
package/dist/assets/MobileShareBridge-CliVo1YH.js +0 -4
package/dist/assets/MobileSurface-9Xh6WQkY.js +0 -2
package/dist/assets/OnboardingScreen-CJYyR54B.js +0 -1
package/dist/assets/OverlayScrollbar-C-jZ8ITG.js +0 -2
package/dist/assets/SettingsView-DyCZehFG.js +0 -25
package/dist/assets/TerminalView-XSALfUaH.js +0 -8
package/dist/assets/ToolOutputDialog-BfuXazW9.js +0 -10
package/dist/assets/appThemeRegistry-DDWrniMM.js +0 -2
package/dist/assets/clipboard-Bz0Zm9VJ.js +0 -1
package/dist/assets/desktop-CfLlmafK.js +0 -1
package/dist/assets/desktopHosts-C1Ns3DUu.js +0 -1
package/dist/assets/desktopRelayRestore-LBt0CBOj.js +0 -1
package/dist/assets/fileQueries-Dnn15WsA.js +0 -1
package/dist/assets/insertionBoundaries-DMxuUnL_.js +0 -4
package/dist/assets/main-B9HVtgXE.js +0 -2
package/dist/assets/main-ZNyIs3Sn.js +0 -29
package/dist/assets/markdown-worker-y3ewaqAK.js +0 -4
package/dist/assets/markdownTheme-TdhQOZSN.js +0 -2
package/dist/assets/miniChat-q0T0WGkZ.js +0 -2
package/dist/assets/mobile-DEduvLJj.js +0 -2
package/dist/assets/multirun-DU-wrxlG.js +0 -4
package/dist/assets/persistence-CmjKImz2.js +0 -3
package/dist/assets/platform-skqcMARt.js +0 -2
package/dist/assets/projectMeta-DNWx6Uva.js +0 -3
package/dist/assets/radio-BEonIX1k.js +0 -1
package/dist/assets/renderElectronMiniChatApp--JYWY41L.js +0 -2
package/dist/assets/renderMobileApp-B0Ix_uNo.js +0 -25
package/dist/assets/runtime-switch-BkpTTbEi.js +0 -1
package/dist/assets/runtimeConfig-BTDIG7mX.js +0 -2
package/dist/assets/runtimeEndpointReset-CZQCYtVI.js +0 -4
package/dist/assets/shikiHighlight-C9Cx56Qg.js +0 -1
package/dist/assets/sortable-tabs-strip-Bj8N0VWf.js +0 -1
package/dist/assets/src-2eFAiBLq.css +0 -2
package/dist/assets/terminalApi-CNqqwjfG.js +0 -1
package/dist/assets/url-KeihbE0d.js +0 -1
package/dist/assets/useAppFontEffects-CKLSamae.js +0 -7
package/dist/assets/useAssistantUIStore-DaplPyb0.js +0 -1
package/dist/assets/useDesktopWindowControlsLayout-DJSkFfhT.js +0 -1
package/dist/assets/useEffectiveDirectory-B3rbY1Kv.js +0 -1
package/dist/assets/useFontPreferences-D8emhcNv.js +0 -1
package/dist/assets/useMobileNavigationStore-CAvVUItx.js +0 -412
package/dist/assets/useSessionAutoCleanup-DxNgqJ8s.js +0 -1
package/dist/assets/useUIStore-B7KJS5G7.js +0 -1
package/dist/assets/useWorkerHighlightedLines-DiDF68LR.js +0 -7
package/dist/assets/utils-CTL16t2f.js +0 -1

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

@@ -0,0 +1,459 @@
+import { describe, expect, it, vi } from 'vitest'
+import { detectSessionlessGenerate, generateOpenCodeText, _test } from './generate.js'
+const completedAssistant = (text) => ({
+  info: {
+    role: 'assistant',
+    time: { completed: Date.now() },
+  },
+  parts: [{ type: 'text', text }],
+})
+describe('detectSessionlessGenerate', () => {
+  it('returns unavailable when the probe 404s', async () => {
+    const fetchImpl = vi.fn(async () => new Response('missing', { status: 404 }))
+    await expect(detectSessionlessGenerate({
+      fetchImpl,
+      baseUrl: 'http://127.0.0.1:4096',
+      headers: {},
+    })).resolves.toEqual({ available: false, mode: 'throwaway-session' })
+  })
+  it('returns available when the probe returns JSON', async () => {
+    const fetchImpl = vi.fn(async () => new Response(JSON.stringify({ ok: true }), {
+      status: 200,
+      headers: { 'Content-Type': 'application/json' },
+    }))
+    await expect(detectSessionlessGenerate({
+      fetchImpl,
+      baseUrl: 'http://127.0.0.1:4096',
+      headers: {},
+    })).resolves.toMatchObject({ available: true, mode: 'http' })
+  })
+  it('treats HTML 200 on /generate as unavailable', async () => {
+    const fetchImpl = vi.fn(async (url) => {
+      expect(String(url)).toMatch(/\/generate$/)
+      return new Response('<!doctype html><html><body>OpenChamber</body></html>', {
+        status: 200,
+        headers: { 'Content-Type': 'text/html; charset=utf-8' },
+      })
+    })
+    await expect(detectSessionlessGenerate({
+      fetchImpl,
+      baseUrl: 'http://127.0.0.1:4096',
+      headers: {},
+    })).resolves.toEqual({ available: false, mode: 'throwaway-session' })
+    expect(fetchImpl).toHaveBeenCalled()
+  })
+})
+describe('generateOpenCodeText', () => {
+  it('uses promptAsync with model+parts, waits for idle messages, and never calls v2 session.prompt', async () => {
+    const create = vi.fn(async () => ({ data: { id: 'ses_tmp' } }))
+    const update = vi.fn(async () => ({ data: { id: 'ses_tmp' } }))
+    const ids = vi.fn(async () => ({ data: ['bash', 'edit'] }))
+    const prompt = vi.fn(async () => {
+      throw new Error('v2 session.prompt must not be used')
+    })
+    const promptAsync = vi.fn(async () => ({ response: { status: 204 } }))
+    const status = vi.fn(async () => ({ data: { ses_tmp: { type: 'idle' } } }))
+    const messages = vi.fn(async () => ({ data: [completedAssistant('reply')] }))
+    const remove = vi.fn(async () => ({ data: true }))
+    const createOpencodeClient = vi.fn(() => ({
+      session: { create, update, prompt, promptAsync, status, messages, delete: remove },
+      tool: { ids },
+    }))
+    const result = await generateOpenCodeText({
+      buildOpenCodeUrl: () => 'http://127.0.0.1:4096',
+      getOpenCodeAuthHeaders: () => ({}),
+      providerID: 'opencode',
+      modelID: 'gpt-5-nano',
+      messages: [{ role: 'user', content: 'hi' }],
+      clientFactory: createOpencodeClient,
+      ensureTempDirectory: async () => '/tmp/openchamber-llm',
+      detect: async () => ({ available: false, mode: 'throwaway-session' }),
+    })
+    expect(create).toHaveBeenCalledWith(expect.objectContaining({
+      title: expect.stringContaining('[openchamber-llm]'),
+    }), expect.anything())
+    expect(update).toHaveBeenCalled()
+    expect(promptAsync).toHaveBeenCalledWith(expect.objectContaining({
+      sessionID: 'ses_tmp',
+      agent: 'openchamber-llm',
+      model: { providerID: 'opencode', modelID: 'gpt-5-nano' },
+      tools: { bash: false, edit: false },
+      parts: [{ type: 'text', text: 'User: hi', synthetic: false }],
+    }), expect.anything())
+    expect(prompt).not.toHaveBeenCalled()
+    expect(status).toHaveBeenCalled()
+    expect(messages).toHaveBeenCalledWith(expect.objectContaining({ sessionID: 'ses_tmp' }), expect.anything())
+    expect(remove).toHaveBeenCalled()
+    expect(result).toEqual({ text: 'reply', source: 'throwaway-session' })
+  })
+  it('forwards contact file parts on promptAsync so the model can see images', async () => {
+    const image = { type: 'file', mime: 'image/png', url: 'data:image/png;base64,aa', filename: 'shot.png' }
+    const file = { type: 'file', mime: 'text/plain', url: 'data:text/plain;base64,eA==', filename: 'notes.txt' }
+    const flattened = _test.flattenMessages([
+      { role: 'user', content: 'look', parts: [image, file] },
+    ])
+    expect(flattened.prompt).toContain('User: look')
+    expect(flattened.prompt).toContain('[image: shot.png (image/png)]')
+    expect(flattened.prompt).toContain('[file: notes.txt (text/plain)]')
+    expect(flattened.files).toEqual([image, file])
+    const promptAsync = vi.fn(async () => ({ response: { status: 204 } }))
+    const createOpencodeClient = vi.fn(() => ({
+      session: {
+        create: async () => ({ data: { id: 'ses_tmp' } }),
+        update: async () => ({ data: { id: 'ses_tmp' } }),
+        prompt: vi.fn(),
+        promptAsync,
+        status: async () => ({ data: { ses_tmp: { type: 'idle' } } }),
+        messages: async () => ({ data: [completedAssistant('saw it')] }),
+        delete: async () => ({ data: true }),
+      },
+      tool: { ids: async () => ({ data: [] }) },
+    }))
+    await generateOpenCodeText({
+      buildOpenCodeUrl: () => 'http://127.0.0.1:4096',
+      getOpenCodeAuthHeaders: () => ({}),
+      providerID: 'opencode',
+      modelID: 'gpt-5-nano',
+      messages: [{ role: 'user', content: 'look', parts: [image, file] }],
+      clientFactory: createOpencodeClient,
+      ensureTempDirectory: async () => '/tmp/openchamber-llm',
+      detect: async () => ({ available: false, mode: 'throwaway-session' }),
+      forwardImageParts: true,
+    })
+    expect(promptAsync.mock.calls[0][0].parts).toEqual([
+      expect.objectContaining({ type: 'text', synthetic: false }),
+      image,
+      file,
+    ])
+  })
+  it('skips image bytes for non-vision generate and keeps text files plus the image description', async () => {
+    const image = { type: 'file', mime: 'image/png', url: 'data:image/png;base64,aa', filename: 'shot.png' }
+    const file = { type: 'file', mime: 'text/plain', url: 'data:text/plain;base64,eA==', filename: 'notes.txt' }
+    expect(_test.filesForPrompt([image, file], false)).toEqual([file])
+    const promptAsync = vi.fn(async () => ({ response: { status: 204 } }))
+    const createOpencodeClient = vi.fn(() => ({
+      session: {
+        create: async () => ({ data: { id: 'ses_tmp' } }),
+        update: async () => ({ data: { id: 'ses_tmp' } }),
+        prompt: vi.fn(),
+        promptAsync,
+        status: async () => ({ data: { ses_tmp: { type: 'idle' } } }),
+        messages: async () => ({ data: [completedAssistant('cannot see images')] }),
+        delete: async () => ({ data: true }),
+      },
+      tool: { ids: async () => ({ data: [] }) },
+    }))
+    await generateOpenCodeText({
+      buildOpenCodeUrl: () => 'http://127.0.0.1:4096',
+      getOpenCodeAuthHeaders: () => ({}),
+      providerID: 'opencode',
+      modelID: 'deepseek-v4-flash',
+      messages: [{ role: 'user', content: 'look', parts: [image, file] }],
+      clientFactory: createOpencodeClient,
+      ensureTempDirectory: async () => '/tmp/openchamber-llm',
+      detect: async () => ({ available: false, mode: 'throwaway-session' }),
+    })
+    expect(promptAsync.mock.calls[0][0].parts).toEqual([
+      expect.objectContaining({
+        type: 'text',
+        text: expect.stringContaining('[image: shot.png (image/png)]'),
+      }),
+      file,
+    ])
+    expect(promptAsync.mock.calls[0][0].parts.some((part) => part.type === 'file' && part.mime.startsWith('image/'))).toBe(false)
+  })
+  it('surfaces the OpenCode assistant error string after promptAsync 204', async () => {
+    const promptAsync = vi.fn(async () => ({ response: { status: 204 } }))
+    const prompt = vi.fn()
+    const createOpencodeClient = vi.fn(() => ({
+      session: {
+        create: async () => ({ data: { id: 'ses_tmp' } }),
+        update: async () => ({ data: { id: 'ses_tmp' } }),
+        prompt,
+        promptAsync,
+        status: async () => ({ data: { ses_tmp: { type: 'idle' } } }),
+        messages: async () => ({
+          data: [{
+            info: { role: 'assistant', error: { message: 'model refused the request' }, time: { completed: Date.now() } },
+            parts: [],
+          }],
+        }),
+        delete: async () => ({ data: true }),
+      },
+      tool: { ids: async () => ({ data: [] }) },
+    }))
+    await expect(generateOpenCodeText({
+      buildOpenCodeUrl: () => 'http://127.0.0.1:4096',
+      getOpenCodeAuthHeaders: () => ({}),
+      providerID: 'opencode',
+      modelID: 'gpt-5-nano',
+      messages: [{ role: 'user', content: 'hi' }],
+      clientFactory: createOpencodeClient,
+      ensureTempDirectory: async () => '/tmp/openchamber-llm',
+      detect: async () => ({ available: false, mode: 'throwaway-session' }),
+    })).rejects.toMatchObject({
+      code: 'upstream_error',
+      message: 'model refused the request',
+    })
+    expect(prompt).not.toHaveBeenCalled()
+  })
+  it('falls through to promptAsync when the /generate probe returns HTML 200', async () => {
+    const fetchImpl = vi.fn(async () => new Response('<!doctype html>', {
+      status: 200,
+      headers: { 'Content-Type': 'text/html' },
+    }))
+    const promptAsync = vi.fn(async () => ({ response: { status: 204 } }))
+    const prompt = vi.fn()
+    const result = await generateOpenCodeText({
+      buildOpenCodeUrl: () => 'http://127.0.0.1:4096',
+      getOpenCodeAuthHeaders: () => ({}),
+      providerID: 'opencode',
+      modelID: 'glm-5.3-flash',
+      messages: [{ role: 'user', content: 'hi' }],
+      fetchImpl,
+      clientFactory: () => ({
+        session: {
+          create: async () => ({ data: { id: 'ses_tmp' } }),
+          update: async () => ({ data: { id: 'ses_tmp' } }),
+          prompt,
+          promptAsync,
+          status: async () => ({ data: { ses_tmp: { type: 'idle' } } }),
+          messages: async () => ({ data: [completedAssistant('reply')] }),
+          delete: async () => ({ data: true }),
+        },
+        tool: { ids: async () => ({ data: [] }) },
+      }),
+      ensureTempDirectory: async () => '/tmp/openchamber-llm',
+    })
+    expect(result).toEqual({ text: 'reply', source: 'throwaway-session' })
+    expect(promptAsync).toHaveBeenCalled()
+    expect(prompt).not.toHaveBeenCalled()
+  })
+  it('forwards filtered throwaway session text deltas via onTextDelta and still returns full text', async () => {
+    const subscribers = new Set()
+    const globalEventHub = {
+      subscribeEvent(fn) {
+        subscribers.add(fn)
+        return () => { subscribers.delete(fn) }
+      },
+      emit(event) {
+        for (const fn of Array.from(subscribers)) fn(event)
+      },
+    }
+    const deltas = []
+    const onTextDelta = vi.fn((text) => { deltas.push(text) })
+    const promptAsync = vi.fn(async () => {
+      // Same-session text deltas
+      globalEventHub.emit({
+        payload: {
+          type: 'message.part.delta',
+          properties: {
+            sessionID: 'ses_tmp',
+            messageID: 'msg_asst',
+            partID: 'prt_1',
+            field: 'text',
+            delta: 'Hel',
+          },
+        },
+      })
+      globalEventHub.emit({
+        payload: {
+          type: 'message.part.delta',
+          properties: {
+            sessionID: 'ses_tmp',
+            messageID: 'msg_asst',
+            partID: 'prt_1',
+            field: 'text',
+            delta: 'lo',
+          },
+        },
+      })
+      // Other session — must be ignored
+      globalEventHub.emit({
+        payload: {
+          type: 'message.part.delta',
+          properties: {
+            sessionID: 'ses_other',
+            messageID: 'msg_other',
+            partID: 'prt_x',
+            field: 'text',
+            delta: 'NOPE',
+          },
+        },
+      })
+      // Same session, different messageID after lock — ignored
+      globalEventHub.emit({
+        payload: {
+          type: 'message.part.delta',
+          properties: {
+            sessionID: 'ses_tmp',
+            messageID: 'msg_other_asst',
+            partID: 'prt_2',
+            field: 'text',
+            delta: 'SKIP',
+          },
+        },
+      })
+      // Non-text field — ignored
+      globalEventHub.emit({
+        payload: {
+          type: 'message.part.delta',
+          properties: {
+            sessionID: 'ses_tmp',
+            messageID: 'msg_asst',
+            partID: 'prt_1',
+            field: 'reasoning',
+            delta: 'think',
+          },
+        },
+      })
+      return { response: { status: 204 } }
+    })
+    const result = await generateOpenCodeText({
+      buildOpenCodeUrl: () => 'http://127.0.0.1:4096',
+      getOpenCodeAuthHeaders: () => ({}),
+      providerID: 'opencode',
+      modelID: 'gpt-5-nano',
+      messages: [{ role: 'user', content: 'hi' }],
+      clientFactory: () => ({
+        session: {
+          create: async () => ({ data: { id: 'ses_tmp' } }),
+          update: async () => ({ data: { id: 'ses_tmp' } }),
+          prompt: vi.fn(),
+          promptAsync,
+          status: async () => ({ data: { ses_tmp: { type: 'idle' } } }),
+          messages: async () => ({ data: [completedAssistant('Hello')] }),
+          delete: async () => ({ data: true }),
+        },
+        tool: { ids: async () => ({ data: [] }) },
+      }),
+      ensureTempDirectory: async () => '/tmp/openchamber-llm',
+      detect: async () => ({ available: false, mode: 'throwaway-session' }),
+      onTextDelta,
+      globalEventHub,
+    })
+    expect(result).toEqual({ text: 'Hello', source: 'throwaway-session' })
+    expect(deltas).toEqual(['Hel', 'lo'])
+    expect(onTextDelta).toHaveBeenCalledTimes(2)
+    // Listener removed after complete — further emits must not reach onTextDelta
+    expect(subscribers.size).toBe(0)
+    globalEventHub.emit({
+      payload: {
+        type: 'message.part.delta',
+        properties: {
+          sessionID: 'ses_tmp',
+          messageID: 'msg_asst',
+          partID: 'prt_1',
+          field: 'text',
+          delta: 'late',
+        },
+      },
+    })
+    expect(onTextDelta).toHaveBeenCalledTimes(2)
+  })
+  it('removes the hub listener when generate fails after subscribe', async () => {
+    const subscribers = new Set()
+    const globalEventHub = {
+      subscribeEvent(fn) {
+        subscribers.add(fn)
+        return () => { subscribers.delete(fn) }
+      },
+    }
+    const onTextDelta = vi.fn()
+    await expect(generateOpenCodeText({
+      buildOpenCodeUrl: () => 'http://127.0.0.1:4096',
+      getOpenCodeAuthHeaders: () => ({}),
+      providerID: 'opencode',
+      modelID: 'gpt-5-nano',
+      messages: [{ role: 'user', content: 'hi' }],
+      clientFactory: () => ({
+        session: {
+          create: async () => ({ data: { id: 'ses_tmp' } }),
+          update: async () => ({ data: { id: 'ses_tmp' } }),
+          prompt: vi.fn(),
+          promptAsync: async () => ({ response: { status: 204 } }),
+          status: async () => ({ data: { ses_tmp: { type: 'idle' } } }),
+          messages: async () => ({
+            data: [{
+              info: { role: 'assistant', error: { message: 'boom' }, time: { completed: Date.now() } },
+              parts: [],
+            }],
+          }),
+          delete: async () => ({ data: true }),
+        },
+        tool: { ids: async () => ({ data: [] }) },
+      }),
+      ensureTempDirectory: async () => '/tmp/openchamber-llm',
+      detect: async () => ({ available: false, mode: 'throwaway-session' }),
+      onTextDelta,
+      globalEventHub,
+    })).rejects.toMatchObject({ code: 'upstream_error', message: 'boom' })
+    expect(subscribers.size).toBe(0)
+  })
+  it('does not invent deltas on the sessionless /generate JSON path', async () => {
+    const onTextDelta = vi.fn()
+    const subscribers = new Set()
+    const globalEventHub = {
+      subscribeEvent(fn) {
+        subscribers.add(fn)
+        return () => { subscribers.delete(fn) }
+      },
+    }
+    const fetchImpl = vi.fn(async () => new Response(JSON.stringify({ text: 'full reply' }), {
+      status: 200,
+      headers: { 'Content-Type': 'application/json' },
+    }))
+    const result = await generateOpenCodeText({
+      buildOpenCodeUrl: () => 'http://127.0.0.1:4096',
+      getOpenCodeAuthHeaders: () => ({}),
+      providerID: 'opencode',
+      modelID: 'gpt-5-nano',
+      messages: [{ role: 'user', content: 'hi' }],
+      fetchImpl,
+      detect: async () => ({ available: true, mode: 'http', url: 'http://127.0.0.1:4096/generate' }),
+      onTextDelta,
+      globalEventHub,
+    })
+    expect(result).toEqual({ text: 'full reply', source: 'generate' })
+    expect(onTextDelta).not.toHaveBeenCalled()
+    expect(subscribers.size).toBe(0)
+  })
+})
+describe('subscribeThrowawayTextDeltas', () => {
+  it('returns null without a callback or hub', () => {
+    expect(_test.subscribeThrowawayTextDeltas({
+      sessionID: 'ses_1',
+      onTextDelta: null,
+      globalEventHub: { subscribeEvent: () => () => {} },
+    })).toBeNull()
+    expect(_test.subscribeThrowawayTextDeltas({
+      sessionID: 'ses_1',
+      onTextDelta: () => {},
+      globalEventHub: null,
+    })).toBeNull()
+  })
+})

package/server/lib/llm/routes.js ADDED Viewed

@@ -0,0 +1,47 @@
+import { createChatCompletion, LlmError } from './completions.js';
+import { loadConnectedCatalog } from './catalog.js';
+import { createOpencodeClient } from '@opencode-ai/sdk/v2';
+import { ensureLlmTempDirectory } from './temp-directory.js';
+const fail = (res, error) => {
+  const code = error instanceof LlmError ? error.code : error?.code || 'internal_error';
+  const status = error instanceof LlmError
+    ? error.statusCode
+    : code === 'no_provider'
+      ? 400
+      : code === 'validation_error'
+        ? 400
+        : code === 'upstream_error'
+          ? 502
+          : 500;
+  res.status(status).json({ ok: false, error: code, message: error?.message || code });
+};
+export const registerLlmRoutes = (app, dependencies) => {
+  const client = () => createOpencodeClient({
+    baseUrl: dependencies.buildOpenCodeUrl('/', '').replace(/\/$/, ''),
+    headers: dependencies.getOpenCodeAuthHeaders(),
+  });
+  app.get('/api/openchamber/llm/models', (_req, res) => {
+    Promise.resolve()
+      .then(() => loadConnectedCatalog(client()))
+      .then((catalog) => res.json({ ok: true, ...catalog }))
+      .catch((error) => fail(res, error));
+  });
+  app.post('/api/openchamber/llm/chat/completions', (req, res) => {
+    Promise.resolve()
+      .then(() => createChatCompletion({
+        body: req.body,
+        buildOpenCodeUrl: dependencies.buildOpenCodeUrl,
+        getOpenCodeAuthHeaders: dependencies.getOpenCodeAuthHeaders,
+        clientFactory: client,
+        ensureTempDirectory: ensureLlmTempDirectory,
+      }))
+      .then(({ completion }) => {
+        res.status(200).json(completion);
+      })
+      .catch((error) => fail(res, error));
+  });
+};

package/server/lib/llm/temp-directory.js ADDED Viewed

@@ -0,0 +1,37 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+/** @type {string | null} */
+let tempDirectory = null;
+/** @type {Promise<string> | null} */
+let inflight = null;
+export async function ensureLlmTempDirectory({ agentName, agentMarkdown }) {
+  if (tempDirectory) return tempDirectory;
+  if (!inflight) {
+    inflight = (async () => {
+      const root = await fs.mkdtemp(path.join(os.tmpdir(), 'openchamber-llm-'));
+      const agentDir = path.join(root, '.opencode', 'agent');
+      await fs.mkdir(agentDir, { recursive: true });
+      await fs.writeFile(path.join(agentDir, `${agentName}.md`), agentMarkdown, 'utf8');
+      tempDirectory = root;
+      return root;
+    })().finally(() => {
+      inflight = null;
+    });
+  }
+  return inflight;
+}
+export async function stopLlmTempDirectory() {
+  const dir = tempDirectory;
+  tempDirectory = null;
+  inflight = null;
+  if (!dir) return;
+  try {
+    await fs.rm(dir, { recursive: true, force: true });
+  } catch {
+    // Best-effort cleanup of the throwaway generator workspace.
+  }
+}

package/server/lib/notifications/APNS.md CHANGED Viewed

@@ -16,18 +16,22 @@ registered them — so a leaked device token alone can't be used to push.
  3. On a trigger (ready/error/question/permission/goal_*), the server composes **generic,
     content-free** text — a **locale-specific** scenario title (from `apns-titles.js`, keyed off
     the locale stored with each device token at `POST /api/push/apns-token`) + the **session name**
-    as the body, no model/project/message content — plus a **`badge`** count (see below). Tokens
-    are grouped by locale (relay signatures cover `title`, so mixed locales cannot share one
-    batch) and each group POSTs `{ tokens, title, body, badge, env, data:{sessionId},
-    publicKeyJwk, ts, sig }` to `POST /v1/push/send` (`apns-runtime.js` → `sendViaRelay`). It does
-    **not** gate on UI visibility (see below). Legacy tokens without a locale fall back to English.
+    as the body, no model/project/message content — plus a **`badge`** count (see below).
+    **Contact turns are the exception:** APNs keeps the assistant nickname as the title and the
+    spoken message as the body (`preserveAlert`), and forwards `assistantID` so a tap opens that
+    conversation. Tokens are grouped by locale (relay signatures cover `title`, so mixed locales
+    cannot share one batch) and each group POSTs `{ tokens, title, body, badge, env,
+    data:{sessionId|assistantID}, publicKeyJwk, ts, sig }` to `POST /v1/push/send`
+    (`apns-runtime.js` → `sendViaRelay`). It does **not** gate on UI visibility (see below).
+    Legacy tokens without a locale fall back to English.
 4. The **Push Relay** (`packages/relay-server/src/push/`, process `openchamber-push-relay`)
    verifies the signature + `ts` freshness, derives `serverId`, and only delivers to tokens bound
    to that server. It holds the project APNs `.p8` key, signs an ES256 JWT with Node crypto, and
    sends each token to APNs over HTTP/2, returning per-token results; the server drops tokens
    flagged `drop` (410 / BadDeviceToken). The Push database stores `token → serverId` bindings,
    not application plaintext. Layer 1 (`openchamber-relay`) never sees these secrets.
-5. Tapping a push deep-links to its session via the forwarded `sessionId`.
+5. Tapping a session push deep-links via the forwarded `sessionId`. Tapping a contact push
+   opens that assistant via `assistantID` / `openchamber://assistant/<id>`.
 ## Live Activity (update / end)
@@ -116,8 +120,8 @@ is server-global, so every device token of a server sees the same badge.
 Host (`apns-runtime.js`):
 - `OPENCHAMBER_PUSH_RELAY_URL` (explicit send-URL override), `OPENCHAMBER_APNS_ENVIRONMENT`
-  (`sandbox` default / `production` for TestFlight and App Store). The signing keypair is
-  auto-generated — nothing to set.
+  (`production` default for TestFlight/App Store builds; set `sandbox` for Xcode development
+  builds). The signing keypair is auto-generated — nothing to set.
 - Direct fallback: `OPENCHAMBER_APNS_KEY_ID`, `OPENCHAMBER_APNS_TEAM_ID`, `OPENCHAMBER_APNS_P8`
   (or `_P8_PATH`), `OPENCHAMBER_APNS_BUNDLE_ID`, `OPENCHAMBER_PUSH_RELAY_DISABLED=true`.
@@ -136,8 +140,8 @@ device tokens, or signatures.
 2. Give those values only to the Push process (environment or Docker secret). Do not put the
    `.p8` on Layer 1 or on each OpenChamber Host when using Relay mode.
 3. Xcode: confirm the Push Notifications capability; Clean Build Folder; run on device.
-   Development builds use APNs `sandbox`. TestFlight and App Store Hosts set
-   `OPENCHAMBER_APNS_ENVIRONMENT=production`.
+   Hosts default to APNs `production` (TestFlight/App Store tokens). Xcode development
+   builds (sandbox tokens) need `OPENCHAMBER_APNS_ENVIRONMENT=sandbox`.
 ## Security posture
@@ -167,13 +171,15 @@ Who can read the alert text:
 - **Apple APNs:** the alert text too — APNs always reads the alert payload of an `alert` push.
 - **The device:** displays it.
-This is acceptable **because the text is deliberately content-free**: a fixed scenario title
-(localized per device) + the session name only — no model, project, or message content
-(`runtime.js` → `toApnsGenericPayload` → `localizeApnsPayload`). The session name is the single
-semi-personal field that crosses the relay/Apple. To hide even that from Apple would require an
-end-to-end **encrypted payload** (`mutable-content` + a Notification Service Extension that
-decrypts on-device with a key never sent to the relay) — not implemented, and unnecessary for
-generic text.
+Ordinary session triggers stay **content-free**: a fixed scenario title (localized per device) +
+the session name only — no model, project, or message content (`runtime.js` →
+`toApnsGenericPayload` → `localizeApnsPayload`). The session name is the single semi-personal
+field that crosses the relay/Apple on that path.
+Contact-turn alerts are an intentional exception: nickname + spoken message cross the relay so
+the banner reads like a normal contact. To hide even that from Apple would require an end-to-end
+**encrypted payload** (`mutable-content` + a Notification Service Extension that decrypts
+on-device with a key never sent to the relay) — not implemented.
 ## Android (FCM) note

package/server/lib/notifications/DOCUMENTATION.md CHANGED Viewed

@@ -47,9 +47,10 @@ 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 and child sessions plus small-model system sessions (`metadata.openchamber.smallModel.purpose`) are suppressed
-  - top-level completion/error Live Activity `end` (`sendLiveActivityEnd`), independent of ordinary push settings and UI visibility, with the same child/small-model suppression; duplicate terminal events are idempotent at the token store
-  - session meta cache for child-session and small-model suppression
+  - 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.
+  - 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
   - template resolution and fallback behavior
   - native notification fanout and web push payload fanout
   - push always fans out to every subscribed surface; another client's visibility never suppresses delivery
@@ -79,7 +80,7 @@ This module provides notification message preparation utilities for the web serv
   - `sendApnsToAllUiSessions(payload)` — localizes scenario titles per stored token locale (`apns-titles.js`), groups tokens by locale, then signs + sends (no UI-visibility gate; iOS suppresses the foreground banner). Before a relay send, each token is checked against the in-memory registration success cache for the current register URL; cache hits skip `/v1/push/register-token`, misses are registered with bounded concurrency, and only successfully bound tokens are sent. Switching Relay/Push URL clears that cache so the next send re-binds persisted tokens to the new origin. No-ops with a single warning when APNs is unconfigured. Drops tokens on `410` / `BadDeviceToken` / `Unregistered`. Never sends Live Activity tokens.
   - `reRegisterAllTokens()` — binds every persisted device token to the current Push origin (same success cache and URL-switch invalidation as send).
   - `resolveApnsConfig()`
-- Configuration (env first, then `settings.apnsConfig`): `OPENCHAMBER_PUSH_RELAY_URL` (optional send-URL override), `OPENCHAMBER_PUSH_RELAY_DISABLED`, `OPENCHAMBER_APNS_KEY_ID`, `OPENCHAMBER_APNS_TEAM_ID`, `OPENCHAMBER_APNS_P8` (PEM contents; literal `\n` accepted) or `OPENCHAMBER_APNS_P8_PATH`, `OPENCHAMBER_APNS_BUNDLE_ID` (default `com.yee94.openchamber`), `OPENCHAMBER_APNS_ENVIRONMENT` (`sandbox` default, or `production` for TestFlight and App Store).
+- Configuration (env first, then `settings.apnsConfig`): `OPENCHAMBER_PUSH_RELAY_URL` (optional send-URL override), `OPENCHAMBER_PUSH_RELAY_DISABLED`, `OPENCHAMBER_APNS_KEY_ID`, `OPENCHAMBER_APNS_TEAM_ID`, `OPENCHAMBER_APNS_P8` (PEM contents; literal `\n` accepted) or `OPENCHAMBER_APNS_P8_PATH`, `OPENCHAMBER_APNS_BUNDLE_ID` (default `com.yee94.openchamber`), `OPENCHAMBER_APNS_ENVIRONMENT` (`production` default for TestFlight/App Store builds; set `sandbox` explicitly for Xcode development builds).
 ### Emitter runtime API (emitter-runtime.js)
 - `createNotificationEmitterRuntime(dependencies)`: creates runtime for unified notification emission channels.