@webinson/peer 0.4.15 → 0.4.16

package/README.md

@@ -19,12 +19,12 @@ In a Claude Code thread:
 - `/peer stop` ends sharing. Quitting or restarting Claude Code only pauses it: the thread shows as stopped and
   is shared again when the session is resumed. `/clear` and signing out of Claude Code end it.
 - A band above the prompt shows the thread's memories (`17 memories`), `Use Elephant` and `Use Jellyfish`, and
-  `● Active` (shared) or `○ Inactive` at the right; hovering a control explains it. The modes decide what memory
-  the thread uses:
-  - **Use Elephant** (shared): your OpenViking memory, recalled with each prompt and saved as the thread goes, on
-    top of Claude Code's own memory. It saves only the turns from the moment it was chosen.
-  - **Inactive** (not shared): Claude Code's own memory alone; OpenViking stays off.
-  - **Use Jellyfish** (shared): no memory at all, neither OpenViking nor Claude Code's own (`MEMORY.md`).
+  `● Active` (shared) or `○ Inactive` at the right; a press says in a toast what the thread now uses. The modes
+  decide what memory the thread uses:
+  - **Use Elephant** (shared): PeerMemory (your personal OpenViking), recalled with each prompt and saved as the
+    thread goes, on top of Claude Code's own memory. It saves only the turns from the moment it was chosen.
+  - **Inactive** (not shared): Claude Code's own memory alone; PeerMemory stays off.
+  - **Use Jellyfish** (shared): no memory at all, neither PeerMemory nor Claude Code's own (`MEMORY.md`).
     `CLAUDE.md` instructions stay.
 
   Pressing the lit mode again stops sharing (Inactive); pressing either while Inactive shares again. Every thread

package/mod/peer-thread-mark/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "peer-thread-mark",
-  "version": "0.4.15",
+  "version": "0.4.16",
   "description": "Marks a Claude Code thread shared with Peer (/peer) with a band above the prompt, with /peer stop and /peer start; panes for /peer-list, /peer-thread and /peer-all (search your memories)",
   "license": "MIT",
   "types": "./types/index.d.ts"

package/mod/peer-thread-mark/hooks/register.tsx

@@ -453,7 +453,8 @@ function projects(people: { email: string; threads: Thread[] }[]) {
 
 // A press does what typing the command does: the CLI's own hook shares or stops the thread and says so.
 // (A plugin may not submit a prompt that starts with `/`, so the hook is run directly.)
-async function send($: EngineInterface, prompt: string) {
+// `said`, when given, is the toast in place of the CLI's own line, once the press is done; a failure still says why.
+async function send($: EngineInterface, prompt: string, said?: () => Promise<string>) {
   try {
     const argv = await promptHook($)
     if (!argv) {
@@ -463,11 +464,23 @@ async function send($: EngineInterface, prompt: string) {
     const input = { session_id: await $.session.id(), cwd: await $.env.get('PWD'), prompt }
     const { stdout } = await $.process.run(argv, { stdin: JSON.stringify(input), timeoutMs: 10_000 })
     const reason = JSON.parse(stdout.trim().split('\n').pop() || '{}').reason
-    if (reason) $.ui.toast(String(reason))
+    if (reason && !said) $.ui.toast(String(reason))
   } catch (error) {
     $.ui.toast(`Peer: ${error instanceof Error ? error.message : String(error)}`)
+    await refresh($)
+    return
   }
   await refresh($)
+  if (said) $.ui.toast(await said())
+}
+
+// What a press of the band leaves the thread with, in a toast that stands in for a tooltip: the desktop does not
+// follow the pointer over the band, so a hover hint cannot show there.
+async function memoryNote($: EngineInterface) {
+  const use = await memoryUse($)
+  if (use === 'openviking') return 'Elephant: PeerMemory recalls and saves from now on.'
+  if (use === 'none') return 'Jellyfish: no memory in this thread.'
+  return 'Inactive: not shared, Claude Code memory only.'
 }
 
 export const register: Register = on => {
@@ -519,7 +532,7 @@ export const register: Register = on => {
 
   on('tool.call', async ($, e, next) => {
     if (e.tool.startsWith(OPENVIKING_TOOL) && (await memoryUse($)) !== 'openviking') {
-      return { deny: 'OpenViking is off in this thread: only Use Elephant in the Peer band turns it on.' }
+      return { deny: 'PeerMemory is off in this thread. Use Elephant turns it on.' }
     }
     return next(e)
   })
@@ -672,7 +685,7 @@ export const register: Register = on => {
             {nearHere.map((memory, index) => savedCard(memory, fromHere.length + index))}
             {recalled.map(recallCard)}
             {asked.map((use, index) =>
-              card(`a-${e.requestId}-${index}`, 'Asked', <Text bold wrap="truncate-end">{use.items[0] ?? use.kind}</Text>, clock(use.at), `OpenViking ${use.kind}`),
+              card(`a-${e.requestId}-${index}`, 'Asked', <Text bold wrap="truncate-end">{use.items[0] ?? use.kind}</Text>, clock(use.at), `PeerMemory ${use.kind}`),
             )}
           </Box>
         )}
@@ -696,9 +709,12 @@ export const register: Register = on => {
     const kind = await read($, mode)
 
     const { Box, Button, Text } = $.ui.resolve(e)
-    // A hint is the band's tooltip: a line under the controls, hidden until the pointer is on its control's scope.
+    // A hint is the band's tooltip: one line in the free space of the band's own row, between the modes and the
+    // status, hidden until the pointer is on its control, so the band never has to grow for it. The control's zone
+    // Box and its Button both join the hint's scope, as a desktop's native button may take the pointer from the Box
+    // around it; the zones carry keys of their own, apart from their Buttons'.
     const hint = (scope: string, text: string) => (
-      <Box key={`hint-${scope}`} display="none" hover={{ scope, display: 'flex' }}>
+      <Box key={`hint-${scope}`} display="none" flexGrow={1} hover={{ scope, display: 'flex' }}>
         <Text dimColor size="footnote" wrap="truncate-end">{text}</Text>
       </Box>
     )
@@ -707,26 +723,34 @@ export const register: Register = on => {
     // A mode is lit only while the thread is shared: pressing the lit one stops sharing (Inactive), pressing
     // either while Inactive picks it and shares again (Active), pressing the other while Active only switches.
     const pick = async (key: Mode) => {
-      if (isShared && kind === key) return send($, '/peer stop')
+      const said = () => memoryNote($)
+      if (isShared && kind === key) return send($, '/peer stop', said)
       await update($, mode, () => key)
-      if (isShared) await applyMemory($)
-      else await send($, '/peer')
+      if (!isShared) return send($, '/peer', said)
+      await applyMemory($)
+      $.ui.toast(await said())
     }
     // A desktop draws a Button's label as its own native button and leaves Text inside it unstyled, so the lit
     // mode is the primary button and the other the secondary; the terminal draws the primary in the accent color.
     const animal = (key: Mode, name: string) => (
-      <Box key={key} hover={{ scope: `peer-${key}` }}>
-        <Button key={key} label={name} variant={isShared && kind === key ? 'primary' : 'secondary'} onPress={() => void pick(key)} />
+      <Box key={`zone-${key}`} gap={1} alignItems="center" hover={{ scope: `peer-${key}` }}>
+        <Button key={key} label={name} variant={isShared && kind === key ? 'primary' : 'secondary'} hover={{ scope: `peer-${key}` }} onPress={() => void pick(key)} />
       </Box>
     )
     const modeHint = (key: Mode, about: string) =>
-      `${about} ${isShared && kind === key ? 'Press again to turn Peer off for this thread.' : isShared ? 'Press to switch.' : 'Press to turn Peer on with it.'}`
+      `${about} ${isShared && kind === key ? 'Press again to stop.' : isShared ? 'Press to switch.' : 'Press to share with it.'}`
+    const hints = {
+      memory: total ? 'What this thread saved.' : 'Nothing saved yet.',
+      elephant: modeHint('elephant', 'Recall and save with PeerMemory.'),
+      jellyfish: modeHint('jellyfish', 'No memory at all.'),
+      share: isShared ? 'Shared with your workspace. Press to stop.' : 'Not shared. Press to share.',
+    }
     return (
       <Box flexDirection="column">
         <Box width="100%" justifyContent="space-between" gap={2}>
           <Box gap={2}>
-            <Box key="memory" hover={{ scope: 'peer-memory' }}>
-              <Button key="memory" label={`${count} ${noun}`} plain onPress={async () => { memoryOpen = await openThread($) }}>
+            <Box key="zone-memory" gap={1} alignItems="center" hover={{ scope: 'peer-memory' }}>
+              <Button key="memory" label={`${count} ${noun}`} plain hover={{ scope: 'peer-memory' }} onPress={async () => { memoryOpen = await openThread($) }}>
                 <Text bold tabular>{count}</Text>
                 <Text>{` ${noun}`}</Text>
               </Button>
@@ -736,16 +760,18 @@ export const register: Register = on => {
               {animal('jellyfish', 'Use Jellyfish')}
             </Box>
           </Box>
+          <Box flexGrow={1} flexShrink={1} paddingX={2}>
+            {e.surface === 'terminal' && hint('peer-memory', hints.memory)}
+            {e.surface === 'terminal' && hint('peer-elephant', hints.elephant)}
+            {e.surface === 'terminal' && hint('peer-jellyfish', hints.jellyfish)}
+            {e.surface === 'terminal' && hint('peer-share', hints.share)}
+          </Box>
           {/* The dot is Text beside the Button, where both surfaces keep its color. */}
-          <Box key="toggle" gap={1} alignItems="center" hover={{ scope: 'peer-share' }}>
+          <Box key="zone-toggle" gap={1} alignItems="center" hover={{ scope: 'peer-share' }}>
             <Text color={isShared ? 'success' : 'inactive'}>{isShared ? '●' : '○'}</Text>
-            <Button key="toggle" label={isShared ? 'Active' : 'Inactive'} plain dimColor={!isShared} onPress={() => send($, isShared ? '/peer stop' : '/peer')} />
+            <Button key="toggle" label={isShared ? 'Active' : 'Inactive'} plain dimColor={!isShared} hover={{ scope: 'peer-share' }} onPress={() => send($, isShared ? '/peer stop' : '/peer', () => memoryNote($))} />
           </Box>
         </Box>
-        {hint('peer-memory', total ? `What this thread has saved to your memory. Open the list.` : 'Nothing saved from this thread yet. Open the list.')}
-        {hint('peer-elephant', modeHint('elephant', 'Elephant never forgets: this thread saves what it learns and recalls your memories.'))}
-        {hint('peer-jellyfish', modeHint('jellyfish', 'Jellyfish lives in the moment: this thread saves nothing and recalls nothing.'))}
-        {hint('peer-share', isShared ? 'Shared with your Peer workspace: teammates see this thread. Press to stop sharing (/peer stop).' : 'Not shared. Press to share this thread with your Peer workspace (/peer).')}
       </Box>
     )
   })
@@ -901,7 +927,7 @@ export const register: Register = on => {
       return status(now?.error ? <Text color="error">{`Peer: your memories did not load (${now.error})`}</Text> : <Text dimColor>Loading…</Text>)
     }
     if (now.error) return status(<Text color="error">{`Peer: your memories did not load (${now.error})`}</Text>)
-    if (!found.connected) return status(<Text dimColor>{`No personal OpenViking here (${found.reason}).`}</Text>)
+    if (!found.connected) return status(<Text dimColor>{`No PeerMemory here (${found.reason}).`}</Text>)
     if (found.total === 0) return status(<Text dimColor>{ask.text ? 'Nothing has those words.' : 'No memories yet.'}</Text>)
 
     const words = searchWords(ask.text)
@@ -1005,7 +1031,7 @@ export const register: Register = on => {
         </Box>
       )
     }
-    if (!now.connected) return <Text dimColor>{`No personal OpenViking here (${now.reason}).`}</Text>
+    if (!now.connected) return <Text dimColor>{`No PeerMemory here (${now.reason}).`}</Text>
 
     const groups = sections(now.saves)
     const total = groups.check.length + groups.added.length + groups.updated.length + groups.removed.length
@@ -1074,7 +1100,7 @@ export const register: Register = on => {
     // Where memory went into the thread, oldest first: one line each, what and when; a press opens which memories,
     // and Show in thread where it came with a message.
     const uses = now.uses ?? []
-    const USE_WORDS: Record<string, string> = { start: 'At the start', resume: 'On resume', prompt: 'With your message', tool: 'Asked OpenViking' }
+    const USE_WORDS: Record<string, string> = { start: 'At the start', resume: 'On resume', prompt: 'With your message', tool: 'Asked PeerMemory' }
     const useRow = (use: MemoryUse, index: number) => {
       const id = `use-${index}`
       const isOpen = open === id
@@ -1122,7 +1148,7 @@ export const register: Register = on => {
             {uses.map(useRow)}
           </Box>
         )}
-        {total === 0 && <Text dimColor>Nothing saved yet. OpenViking saves after longer turns.</Text>}
+        {total === 0 && <Text dimColor>Nothing saved yet. PeerMemory saves after longer turns.</Text>}
         {section('Check', groups.check, true)}
         {section('New', groups.added)}
         {section('Updated', groups.updated)}

package/mod/peer-thread-mark/tests/band.test.tsx

@@ -45,6 +45,8 @@ test('the band counts the thread\'s memories, names no workspace, and opens the
   on('session.id', () => ({ value: 's1' }) as never)
   on('env.set', () => ({ value: {} }) as never)
   on('ui.invalidate', () => ({ value: undefined }) as never)
+  const toasts: string[] = []
+  on('ui.toast', (_, e) => { toasts.push(String((e as { text?: string }).text ?? '')); return { value: undefined } as never })
   on('clock.now', () => ({ value: 1 }) as never)
   const opened: string[] = []
   on('ui.open', (_, e) => { opened.push((e as { id: string }).id); return { value: { isPlaced: true } } as never })
@@ -93,5 +95,8 @@ test('the band counts the thread\'s memories, names no workspace, and opens the
   texts = (await modes.findAll({ type: 'Text' })).map(t => t.text)
   expect(texts).toContain('●')
   expect(await lit(modes as never)).toEqual(['Use Jellyfish'])
+  // The desktop does not follow the pointer over the band, so each press says what the thread now uses, as a toast.
+  expect(toasts.at(-1)).toBe('Jellyfish: no memory in this thread.')
+  expect((await modes.findAll({ type: 'Box' } as never) as { key?: string }[]).some(b => b.key === 'hint-peer-jellyfish')).toBe(false)
   await modes.unmount()
 })

package/mod/peer-thread-mark/tests/modes.test.tsx

@@ -40,6 +40,7 @@ test('Elephant turns OpenViking on, Inactive keeps Claude Code memory alone, Jel
   on('command.register', (_, e) => ({ value: { command: (e as { name: string }).name } }) as never)
   on('ui.status', () => ({ value: undefined }) as never)
   on('ui.invalidate', () => ({ value: undefined }) as never)
+  on('ui.toast', () => ({ value: undefined }) as never)
   on('session.start', (_, e) => ({ cwd: e.cwd }))
   // Beneath the mod: OpenViking's recall and a hook of the person's own, a tool that answers, core's memory.
   on('classic.UserPromptSubmit', () => ({ additionalContext: ['<openviking-context>- [memory 80%] x</openviking-context>', 'kept'] }) as never)

package/mod/peer-thread-mark/tests/saved.test.tsx

@@ -118,7 +118,7 @@ test('a message shows under it what OpenViking saved from it, and what it only u
   olderTexts = (await older.findAll({ type: 'Text' })).map(t => t.text)
   expect(olderTexts).toContain('The partner API takes at most 100 items')
   expect(olderTexts).toContain(' Asked ')
-  expect(olderTexts).toContain('OpenViking search')
+  expect(olderTexts).toContain('PeerMemory search')
   await older.unmount()
 
   // The /peer-thread pane lists where memory went into the thread; one with a message can show it.
@@ -130,7 +130,7 @@ test('a message shows under it what OpenViking saved from it, and what it only u
   expect(usedTexts).toContain('Used')
   expect(usedTexts).toContain('At the start · 2 memories listed')
   expect(usedTexts).toContain("With your message · 1 teammate's page")
-  expect(usedTexts).toContain('Asked OpenViking: search')
+  expect(usedTexts).toContain('Asked PeerMemory: search')
   await usedPane.press({ key: 'use-0' } as never)
   expect((await usedPane.findAll({ type: 'Text' })).map(t => t.text)).toContain('· This Mac')
   expect((await usedPane.findAll({ type: 'Button' })).some(b => b.key === 'use-0-show')).toBe(false)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webinson/peer",
-  "version": "0.4.15",
+  "version": "0.4.16",
   "description": "Share chosen Claude Code threads with your team: who has agents running and on what.",
   "license": "MIT",
   "type": "module",