@sayansr26/agent-os 0.6.1 → 0.6.2

package/plugins/auto-handoff/tests/seed-row.test.tsx

@@ -0,0 +1,58 @@
+import { test, expect } from 'claude-code/testing'
+import { linkify } from '../hooks/config.ts'
+
+const PLUGIN = 'auto-handoff'
+const PATH = '/home/me/.claude/state/auto-handoff/dbd019e5-410b-4d91-8db9-6755b2924e48.md'
+const URL = 'http://100.85.122.99:3846/dbd019e5-410b-4d91-8db9-6755b2924e48.html'
+const SEED = `[auto-handoff] ↪ Handoff from session dbd019e5. The previous session hit its context limit and was cleared. Read the brief at ${PATH} before doing anything else (readable copy: ${URL}) and follow its Instructions section. Open your first reply with the line "↪ Handoff from session dbd019e5".`
+
+const row = (text: string, origin: Record<string, unknown>) => ({
+  component: 'UserMessage' as const,
+  props: { text, origin, isExpanded: false } as never,
+})
+
+test('linkify turns the brief path and viewer URL into markdown links', async () => {
+  const out = linkify(SEED)
+  expect(out).toContain(`[dbd019e5-410b-4d91-8db9-6755b2924e48.md](file://${PATH})`)
+  expect(out).toContain(`[${URL}](${URL})`)
+  // Everything else stays as written.
+  expect(out.startsWith('[auto-handoff] ↪ Handoff from session dbd019e5.')).toBe(true)
+  expect(out).toContain('follow its Instructions section.')
+})
+
+test('linkify leaves a seed with no viewer link alone except for the path', async () => {
+  const text = `[auto-handoff] ↪ Handoff from session abc. Read the brief at ${PATH} before doing anything else and follow its Instructions section.`
+  const out = linkify(text)
+  expect(out).toContain(`(file://${PATH})`)
+  expect(out).not.toContain('http')
+})
+
+test('the seed row draws as a Markdown with clickable links on every surface', async $ => {
+  for (const surface of ['terminal', 'desktop', 'vscode', 'mobile'] as const) {
+    const ui = await $.ui.mount({ plugin: PLUGIN, surface, ...row(SEED, { kind: 'plugin', name: PLUGIN }) })
+    const md = await ui.find({ type: 'Markdown' })
+    expect(md).toBeDefined()
+    expect(md?.text).toContain(`(file://${PATH})`)
+    expect(md?.text).toContain(`[${URL}](${URL})`)
+    await ui.unmount()
+  }
+})
+
+test('rows from other plugins or the person are left to the engine', async ($, on) => {
+  // Stands for the engine's own drawing beneath the plugin: a plain Text of the row.
+  on('ui.render', { component: 'UserMessage' }, async ($, e) => {
+    const { Text } = $.ui.resolve(e)
+    return <Text>{e.props.text}</Text>
+  })
+  const cases: Array<[string, Record<string, unknown>]> = [
+    [SEED, { kind: 'plugin', name: 'some-other-plugin' }],
+    [SEED, { kind: 'composer' }],
+    ['[auto-handoff] Not run: the context is past the handoff threshold.', { kind: 'plugin', name: PLUGIN }],
+  ]
+  for (const [text, origin] of cases) {
+    const ui = await $.ui.mount({ plugin: PLUGIN, surface: 'terminal', ...row(text, origin) })
+    expect(await ui.find({ type: 'Markdown' })).toBeUndefined()
+    expect((await ui.find({ type: 'Text' }))?.text).toBe(text)
+    await ui.unmount()
+  }
+})

package/plugins/auto-handoff/tests/viewer.test.ts

@@ -0,0 +1,111 @@
+import { describe, expect, test } from 'claude-code/testing'
+import { chainOf, parseBrief, renderPage, sections, viewerLink, withHeader } from '../hooks/viewer.ts'
+import { SERVER_JS } from '../hooks/server.ts'
+
+describe('viewer', () => {
+  test('parseBrief extracts header and body', () => {
+    const brief = `---
+from: abc123
+to: def456
+chain: main-chain
+tokens: 150000
+at: 2026-10-04T12:00:00Z
+cwd: /home/user/project
+---
+## Work in Progress
+Building the viewer.
+
+## Next Step
+Test it.`
+    const { header, body } = parseBrief(brief)
+    expect(header.from).toBe('abc123')
+    expect(header.chain).toBe('main-chain')
+    expect(body).toContain('## Work in Progress')
+  })
+
+  test('parseBrief handles briefs with no header', () => {
+    const brief = `## Work in Progress\nDoing stuff`
+    const { header, body } = parseBrief(brief)
+    expect(header).toEqual({})
+    expect(body).toBe(brief)
+  })
+
+  test('withHeader round-trips a brief', () => {
+    const header = { from: 'abc', to: 'def', tokens: '150000' }
+    const body = '## Work\nStuff'
+    const result = withHeader(header, body)
+    const { header: h2, body: b2 } = parseBrief(result)
+    expect(h2.from).toBe('abc')
+    expect(h2.to).toBe('def')
+    expect(b2).toBe(body)
+  })
+
+  test('viewerLink is the short served link, or the local file with no server', () => {
+    expect(viewerLink({ host: '100.64.0.1', port: '3846' }, '/pages', 'abc12345')).toBe('http://100.64.0.1:3846/abc12345')
+    expect(viewerLink(undefined, '/pages', 'abc12345')).toBe('file:///pages/abc12345.html')
+    expect(viewerLink(undefined, 'C:\\Users\\x/.claude/pages', 'abc12345')).toBe('file:///C:/Users/x/.claude/pages/abc12345.html')
+  })
+
+  test('renderPage links the chain and escapes a brief that tries to close the script tag', () => {
+    const a = { id: 'aaaaaaaa-1', header: { chain: 'aaaaaaaa-1', at: '2026-10-04T00:00:00Z', to: 'bbbbbbbb-2' }, body: '## Work in Progress\nFirst.' }
+    const b = { id: 'bbbbbbbb-2', header: { chain: 'aaaaaaaa-1', from: 'aaaaaaaa-1', at: '2026-10-04T01:00:00Z' }, body: '## Next Step\n</script><b>x</b>' }
+    const page = renderPage(b, [a, b])
+    expect(page).toContain('href="aaaaaaaa-1.html"')
+    expect(page).toContain('Handoff Chain')
+    expect(page).not.toContain('</script><b>')
+  })
+
+  test('previous and next follow the chain, even where a header lost its from', () => {
+    const e = (id: string, at: string, header: Record<string, string>) => ({ id, header: { at, ...header }, body: '' })
+    const a = e('aaaaaaaa-1', '1', { to: 'bbbbbbbb-2' })
+    const b = e('bbbbbbbb-2', '2', { to: 'cccccccc-3' }) // a reload dropped its from
+    const c = e('cccccccc-3', '3', { from: 'bbbbbbbb-2', to: 'dddddddd-4' })
+    const mid = renderPage(b, [a, b, c])
+    expect(mid).toContain('<a href="aaaaaaaa-1.html">← previous</a>')
+    expect(mid).toContain('<a href="cccccccc-3.html">next →</a>')
+    const last = renderPage(c, [a, b, c])
+    expect(last).toContain('next: dddddddd, still running')
+    expect(last).not.toContain('href="dddddddd-4.html"')
+    expect(renderPage(a, [a, b, c])).not.toContain('← previous')
+  })
+
+  test('sections extracts visible sections', () => {
+    const body = `## Work in Progress
+Doing X
+
+## Instructions
+Don't read this
+
+## Next Step
+Do Y
+
+## How to Use This Brief
+Also don't read`
+    const visible = sections(body)
+    expect(visible.length).toBe(2)
+    expect(visible[0]).toContain('Work in Progress')
+    expect(visible[1]).toContain('Next Step')
+  })
+
+  test('chainOf joins a run whose chain id broke partway, through from/to links', () => {
+    const e = (id: string, at: string, header: Record<string, string>) => ({ id, header: { at, ...header }, body: '' })
+    const entries = [
+      e('a', '1', { chain: 'a', to: 'b' }),
+      e('b', '2', { chain: 'a', from: 'a', to: 'c' }),
+      e('c', '3', { chain: 'c', to: 'd' }), // the reload lost its from
+      e('d', '4', { chain: 'c', from: 'c' }),
+      e('x', '5', { chain: 'x' }),
+    ]
+    expect(chainOf(entries, 'd').map(x => x.id)).toEqual(['a', 'b', 'c', 'd'])
+    expect(chainOf(entries, 'a').map(x => x.id)).toEqual(['a', 'b', 'c', 'd'])
+    expect(chainOf(entries, 'x').map(x => x.id)).toEqual(['x'])
+  })
+
+  // A second session finds the port taken. Its child used to die with an unhandled EADDRINUSE
+  // stack trace in the log; it now says so in one line and exits 0. (Run live: see the 0.8.2 commit.)
+  test('the server exits quietly when the port is taken', () => {
+    expect(SERVER_JS).toContain("err.code === 'EADDRINUSE'")
+    expect(SERVER_JS).toContain('process.exit(0)')
+    expect(SERVER_JS.indexOf(".on('error'")).toBeLessThan(SERVER_JS.indexOf('.listen('))
+  })
+})

package/plugins/auto-handoff/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./.claude-plugin/types/tsconfig.json",
+  "compilerOptions": { "allowImportingTsExtensions": true, "noEmit": true }
+}

package/src/cli.mjs

@@ -35,7 +35,9 @@ Options
   --force        overwrite files agent-os did not generate (it refuses by default)
   --no-plugin    skip installing or updating the Claude Code plugins during init
   --no-auto-route
-                 init: install agent-os but not the auto-route model router
+                 init: leave out the auto-route model router
+  --no-auto-handoff
+                 init: leave out the auto-handoff session handoff
   --global       init: also write ~/.claude settings without asking
   --no-global    init: leave ~/.claude alone
 `;
@@ -267,7 +269,7 @@ Pick one:
     }
 
     if (cmd === "init" && targets.includes("claude-code") && !argv.includes("--no-plugin")) {
-      // Both come from the same marketplace, so it is added or refreshed once:
+      // All come from the same marketplace, so it is added or refreshed once:
       // by the first plugin whose run gets that far.
       let refresh = true;
       for (const plugin of PLUGINS.filter((p) => p === PLUGIN || !argv.includes(`--no-${p}`))) {
@@ -285,7 +287,7 @@ Pick one:
         if (r.reason === "installed" || r.reason === "updated")
           console.log(`  ${dim("restart Claude Code, or /reload-plugins, to load it")}`);
       }
-      console.log(`\n  ${dim("--no-plugin skips this; --no-auto-route skips only the model router")}`);
+      console.log(`\n  ${dim("--no-plugin skips this; --no-auto-route / --no-auto-handoff skip one mod")}`);
     }
 
     if (cmd === "init" && !dry) {

package/src/plugin.mjs

@@ -2,9 +2,10 @@
  * Install or update the Claude Code half of agent-os during `init`.
  *
  * The CLI compiles rules for every tool. Claude Code additionally gets the
- * agents, skills, per-agent memory and hooks, which ship as a plugin, and
- * auto-route, a mod that picks the model and effort per turn. Both live in
- * this repo's marketplace. `init` brings each to the latest version whatever
+ * agents, skills, per-agent memory and hooks, which ship as a plugin; plus two
+ * mods: auto-route, which picks the model and effort per turn, and
+ * auto-handoff, which hands a full session to a fresh one instead of
+ * compacting. All three live in this repo's marketplace. `init` brings each to the latest version whatever
  * state it finds:
  *
  *   not installed        marketplace add + install, at project scope
@@ -28,7 +29,7 @@ export const MARKETPLACE = "sayansr26/agent-os";
 export const MARKETPLACE_NAME = "sayan-plugins";
 export const PLUGIN = "agent-os";
 // Installed by `init` in this order; each can be skipped with --no-<name>.
-export const PLUGINS = [PLUGIN, "auto-route"];
+export const PLUGINS = [PLUGIN, "auto-route", "auto-handoff"];
 const idOf = (plugin) => `${plugin}@${MARKETPLACE_NAME}`;
 
 const run = (args, cwd) =>

package/src/selftest.mjs

@@ -102,10 +102,14 @@ try {
     ok(/marketplace add sayansr26\/agent-os|plugin marketplace add|not on PATH/.test(pi.stdout),
        "init names the marketplace step or says why it could not run it");
     ok(pi.stdout.includes("auto-route@sayan-plugins"), "init sets up auto-route by default");
+    ok(pi.stdout.includes("auto-handoff@sayan-plugins"), "init sets up auto-handoff by default");
     ok((pi.stdout.match(/marketplace add/g) || []).length <= 1, "the marketplace is added once, not per plugin");
     const na = cli(["init", "--dry-run", "--no-auto-route"], r4);
     ok(!/install auto-route@sayan-plugins/.test(na.stdout) && /install agent-os@sayan-plugins/.test(na.stdout),
        "--no-auto-route keeps agent-os and skips auto-route");
+    const nh = cli(["init", "--dry-run", "--no-auto-handoff"], r4);
+    ok(!/install auto-handoff@sayan-plugins/.test(nh.stdout) && /install auto-route@sayan-plugins/.test(nh.stdout),
+       "--no-auto-handoff skips only auto-handoff");
     rmSync(r4, { recursive: true, force: true });
 
     // A hand-written file at a generated path must survive a sync.