feat(session): amicode_session tool — spawn sessions as background tabs by aarontrowbridge · Pull Request #641 · harmoniqs/amicode

aarontrowbridge · 2026-08-29T14:04:49Z

Closes#639

What

A session can now spawn new sessions that surface as background tabs beside the parent — fan-out for parallel work, fork-mode for branching a thread mid-conversation.

Piece	What it does
`amicode_session` tool	Creates 1–4 child sessions via the engine-provided `PluginInput.client` (first server-mutating tool in the pack), posts the prompt immediately (explicit model bypasses draft-readiness retries), stamps `metadata {spawned_by, spawned_depth}`. `mode: "fork"` seeds from this session's history via the native fork endpoint + metadata PATCH.
Spawn policy (`session_spawn.ts`)	Pure + unit-tested: count cap 4/call, soft depth cap 2 overridable with `force`, model precedence (arg > parent's model > server default), hey-api unwrap, honest summaries.
Session route effect	Watches the server session store for `spawned_by == this route's session`; opens each child as a background tab (`tabs.addSessionTab` — never navigates, no focus steal); idempotent via opened-set. Selection logic in `session/spawn-tabs.ts` (bun tests).
Manifest	Per-file hashes updated for the modified `session.tsx` + the two new overlay files — drift gate green locally.

Design decisions (from #639 discussion)

Auto-open, background — addSessionTab never navigates; spawning cannot steal focus.
Start immediately — promptAsync with explicit model; children churn from birth (cost noted in the tool description).
Soft depth cap — default 2, force: true overrules; depth is derived from the session's OWN stamp, not the caller's claim, so the cap is enforced by construction.
Honest fallback — if no pane shows the parent, the child still spawns and is discoverable in the session list; the fork-mode metadata PATCH is tolerated to fail (child runs, just won't auto-open).

Test evidence

test/session_spawn.test.ts — 20 tests, green.
spawn-tabs.test.ts — 8 tests, green (bun).
tsc --noEmit clean; agents_md + amicode_tools suites green.
Full extension suite: the 7 failures are pre-existing on current main (environmental: vendored binary absent, pin fixtures, staged bins, pasqal venv) — verified by re-running the same files on a clean tree; this branch adds zero new failures.
drift_gate.mjs: PASS (556 files) — including the Complete the .18 pin: re-extract the app-bundle overlay + re-record the service-contract fixtures (unblocks #622 and main) #636-re-extracted state this branch rebased onto.
Overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse + review, consistent with current overlay-PR practice.

Sequencing note

Rebased onto the post-#636 main — the app-bundle-gate red that #639 was originally sequenced behind is resolved on this base.

…bs (#639) A session can now spawn new sessions that surface as background tabs in the parent's pane. Three pieces: - plugin (amicode_session): the pack's FIRST server-mutating tool. Uses the engine-provided PluginInput.client (server-bound SDK) to create and immediately prompt 1-4 children; mode=fork seeds from this session's history via /session/{id}/fork + a metadata PATCH. Children stamp metadata {spawned_by, spawned_depth}. Policy (count cap 4, soft depth cap 2 overridable with force, model precedence) lives in session_spawn.ts, unit-tested (20 tests). - app (session route): an effect in ResolvedTargetSessionRoute watches the server session store for sessions stamped spawned_by == this route's session and opens each as a background tab via tabs.addSessionTab — never navigates, never steals focus; idempotent via an opened-set. Selection logic extracted to session/spawn-tabs.ts (8 bun tests). - app-bundle manifest: hashes for the modified session.tsx + the two new overlay files (drift gate green). Test notes: the 7 failing tests in the extension suite are pre-existing on main (environmental: vendored binary, pin fixtures, staged bins) — this branch adds none. The overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse and review, consistent with current overlay-PR practice. Closes#639

coderabbitai · 2026-08-29T14:04:59Z

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
auto_review:
drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

…dated spawn plan (#646) (#648) The fleet's aggregated chat DB holds weeks of unclosed threads; nothing surfaces them. This skill codifies the sweep-and-resume pass: a read-only SQLite recipe (top-level sessions in a window, last assistant text per session, pending todos), a five-bucket classification (BLOCKED-ON-USER / INTERRUPTED / PARKED / AWAITING-REVIEW / STALE), consolidation of spawnable threads into at most 3-4 THEME-scoped sessions with self-contained seed prompts, and — only on explicit confirmation — one amicode_session call per theme (#641's spawn tool; graceful inline fallback when it isn't deployed). The DB recipe is verified verbatim against the live fleet server DB (97 sessions in a 14-day window → 60 after the noise filter; todo and last-text extraction working). Blocked-on-user and awaiting-review threads are deliberately never spawn candidates — a fresh session cannot press the button only the human can press.

aarontrowbridge · 2026-08-29T14:04:49Z

Closes#639

What

A session can now spawn new sessions that surface as background tabs beside the parent — fan-out for parallel work, fork-mode for branching a thread mid-conversation.

Piece	What it does
`amicode_session` tool	Creates 1–4 child sessions via the engine-provided `PluginInput.client` (first server-mutating tool in the pack), posts the prompt immediately (explicit model bypasses draft-readiness retries), stamps `metadata {spawned_by, spawned_depth}`. `mode: "fork"` seeds from this session's history via the native fork endpoint + metadata PATCH.
Spawn policy (`session_spawn.ts`)	Pure + unit-tested: count cap 4/call, soft depth cap 2 overridable with `force`, model precedence (arg > parent's model > server default), hey-api unwrap, honest summaries.
Session route effect	Watches the server session store for `spawned_by == this route's session`; opens each child as a background tab (`tabs.addSessionTab` — never navigates, no focus steal); idempotent via opened-set. Selection logic in `session/spawn-tabs.ts` (bun tests).
Manifest	Per-file hashes updated for the modified `session.tsx` + the two new overlay files — drift gate green locally.

Design decisions (from #639 discussion)

Auto-open, background — addSessionTab never navigates; spawning cannot steal focus.
Start immediately — promptAsync with explicit model; children churn from birth (cost noted in the tool description).
Soft depth cap — default 2, force: true overrules; depth is derived from the session's OWN stamp, not the caller's claim, so the cap is enforced by construction.
Honest fallback — if no pane shows the parent, the child still spawns and is discoverable in the session list; the fork-mode metadata PATCH is tolerated to fail (child runs, just won't auto-open).

Test evidence

test/session_spawn.test.ts — 20 tests, green.
spawn-tabs.test.ts — 8 tests, green (bun).
tsc --noEmit clean; agents_md + amicode_tools suites green.
Full extension suite: the 7 failures are pre-existing on current main (environmental: vendored binary absent, pin fixtures, staged bins, pasqal venv) — verified by re-running the same files on a clean tree; this branch adds zero new failures.
drift_gate.mjs: PASS (556 files) — including the Complete the .18 pin: re-extract the app-bundle overlay + re-record the service-contract fixtures (unblocks #622 and main) #636-re-extracted state this branch rebased onto.
Overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse + review, consistent with current overlay-PR practice.

Sequencing note

Rebased onto the post-#636 main — the app-bundle-gate red that #639 was originally sequenced behind is resolved on this base.

…bs (#639) A session can now spawn new sessions that surface as background tabs in the parent's pane. Three pieces: - plugin (amicode_session): the pack's FIRST server-mutating tool. Uses the engine-provided PluginInput.client (server-bound SDK) to create and immediately prompt 1-4 children; mode=fork seeds from this session's history via /session/{id}/fork + a metadata PATCH. Children stamp metadata {spawned_by, spawned_depth}. Policy (count cap 4, soft depth cap 2 overridable with force, model precedence) lives in session_spawn.ts, unit-tested (20 tests). - app (session route): an effect in ResolvedTargetSessionRoute watches the server session store for sessions stamped spawned_by == this route's session and opens each as a background tab via tabs.addSessionTab — never navigates, never steals focus; idempotent via an opened-set. Selection logic extracted to session/spawn-tabs.ts (8 bun tests). - app-bundle manifest: hashes for the modified session.tsx + the two new overlay files (drift gate green). Test notes: the 7 failing tests in the extension suite are pre-existing on main (environmental: vendored binary, pin fixtures, staged bins) — this branch adds none. The overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse and review, consistent with current overlay-PR practice. Closes#639

coderabbitai · 2026-08-29T14:04:59Z

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
auto_review:
drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

…dated spawn plan (#646) (#648) The fleet's aggregated chat DB holds weeks of unclosed threads; nothing surfaces them. This skill codifies the sweep-and-resume pass: a read-only SQLite recipe (top-level sessions in a window, last assistant text per session, pending todos), a five-bucket classification (BLOCKED-ON-USER / INTERRUPTED / PARKED / AWAITING-REVIEW / STALE), consolidation of spawnable threads into at most 3-4 THEME-scoped sessions with self-contained seed prompts, and — only on explicit confirmation — one amicode_session call per theme (#641's spawn tool; graceful inline fallback when it isn't deployed). The DB recipe is verified verbatim against the live fleet server DB (97 sessions in a 14-day window → 60 after the noise filter; todo and last-text extraction working). Blocked-on-user and awaiting-review threads are deliberately never spawn candidates — a fresh session cannot press the button only the human can press.

aarontrowbridge · 2026-08-29T14:04:49Z

Closes#639

What

A session can now spawn new sessions that surface as background tabs beside the parent — fan-out for parallel work, fork-mode for branching a thread mid-conversation.

Piece	What it does
`amicode_session` tool	Creates 1–4 child sessions via the engine-provided `PluginInput.client` (first server-mutating tool in the pack), posts the prompt immediately (explicit model bypasses draft-readiness retries), stamps `metadata {spawned_by, spawned_depth}`. `mode: "fork"` seeds from this session's history via the native fork endpoint + metadata PATCH.
Spawn policy (`session_spawn.ts`)	Pure + unit-tested: count cap 4/call, soft depth cap 2 overridable with `force`, model precedence (arg > parent's model > server default), hey-api unwrap, honest summaries.
Session route effect	Watches the server session store for `spawned_by == this route's session`; opens each child as a background tab (`tabs.addSessionTab` — never navigates, no focus steal); idempotent via opened-set. Selection logic in `session/spawn-tabs.ts` (bun tests).
Manifest	Per-file hashes updated for the modified `session.tsx` + the two new overlay files — drift gate green locally.

Design decisions (from #639 discussion)

Auto-open, background — addSessionTab never navigates; spawning cannot steal focus.
Start immediately — promptAsync with explicit model; children churn from birth (cost noted in the tool description).
Soft depth cap — default 2, force: true overrules; depth is derived from the session's OWN stamp, not the caller's claim, so the cap is enforced by construction.
Honest fallback — if no pane shows the parent, the child still spawns and is discoverable in the session list; the fork-mode metadata PATCH is tolerated to fail (child runs, just won't auto-open).

Test evidence

test/session_spawn.test.ts — 20 tests, green.
spawn-tabs.test.ts — 8 tests, green (bun).
tsc --noEmit clean; agents_md + amicode_tools suites green.
Full extension suite: the 7 failures are pre-existing on current main (environmental: vendored binary absent, pin fixtures, staged bins, pasqal venv) — verified by re-running the same files on a clean tree; this branch adds zero new failures.
drift_gate.mjs: PASS (556 files) — including the Complete the .18 pin: re-extract the app-bundle overlay + re-record the service-contract fixtures (unblocks #622 and main) #636-re-extracted state this branch rebased onto.
Overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse + review, consistent with current overlay-PR practice.

Sequencing note

Rebased onto the post-#636 main — the app-bundle-gate red that #639 was originally sequenced behind is resolved on this base.

…bs (#639) A session can now spawn new sessions that surface as background tabs in the parent's pane. Three pieces: - plugin (amicode_session): the pack's FIRST server-mutating tool. Uses the engine-provided PluginInput.client (server-bound SDK) to create and immediately prompt 1-4 children; mode=fork seeds from this session's history via /session/{id}/fork + a metadata PATCH. Children stamp metadata {spawned_by, spawned_depth}. Policy (count cap 4, soft depth cap 2 overridable with force, model precedence) lives in session_spawn.ts, unit-tested (20 tests). - app (session route): an effect in ResolvedTargetSessionRoute watches the server session store for sessions stamped spawned_by == this route's session and opens each as a background tab via tabs.addSessionTab — never navigates, never steals focus; idempotent via an opened-set. Selection logic extracted to session/spawn-tabs.ts (8 bun tests). - app-bundle manifest: hashes for the modified session.tsx + the two new overlay files (drift gate green). Test notes: the 7 failing tests in the extension suite are pre-existing on main (environmental: vendored binary, pin fixtures, staged bins) — this branch adds none. The overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse and review, consistent with current overlay-PR practice. Closes#639

coderabbitai · 2026-08-29T14:04:59Z

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
auto_review:
drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

…dated spawn plan (#646) (#648) The fleet's aggregated chat DB holds weeks of unclosed threads; nothing surfaces them. This skill codifies the sweep-and-resume pass: a read-only SQLite recipe (top-level sessions in a window, last assistant text per session, pending todos), a five-bucket classification (BLOCKED-ON-USER / INTERRUPTED / PARKED / AWAITING-REVIEW / STALE), consolidation of spawnable threads into at most 3-4 THEME-scoped sessions with self-contained seed prompts, and — only on explicit confirmation — one amicode_session call per theme (#641's spawn tool; graceful inline fallback when it isn't deployed). The DB recipe is verified verbatim against the live fleet server DB (97 sessions in a 14-day window → 60 after the noise filter; todo and last-text extraction working). Blocked-on-user and awaiting-review threads are deliberately never spawn candidates — a fresh session cannot press the button only the human can press.

aarontrowbridge · 2026-08-29T14:04:49Z

Closes#639

What

A session can now spawn new sessions that surface as background tabs beside the parent — fan-out for parallel work, fork-mode for branching a thread mid-conversation.

Piece	What it does
`amicode_session` tool	Creates 1–4 child sessions via the engine-provided `PluginInput.client` (first server-mutating tool in the pack), posts the prompt immediately (explicit model bypasses draft-readiness retries), stamps `metadata {spawned_by, spawned_depth}`. `mode: "fork"` seeds from this session's history via the native fork endpoint + metadata PATCH.
Spawn policy (`session_spawn.ts`)	Pure + unit-tested: count cap 4/call, soft depth cap 2 overridable with `force`, model precedence (arg > parent's model > server default), hey-api unwrap, honest summaries.
Session route effect	Watches the server session store for `spawned_by == this route's session`; opens each child as a background tab (`tabs.addSessionTab` — never navigates, no focus steal); idempotent via opened-set. Selection logic in `session/spawn-tabs.ts` (bun tests).
Manifest	Per-file hashes updated for the modified `session.tsx` + the two new overlay files — drift gate green locally.

Design decisions (from #639 discussion)

Auto-open, background — addSessionTab never navigates; spawning cannot steal focus.
Start immediately — promptAsync with explicit model; children churn from birth (cost noted in the tool description).
Soft depth cap — default 2, force: true overrules; depth is derived from the session's OWN stamp, not the caller's claim, so the cap is enforced by construction.
Honest fallback — if no pane shows the parent, the child still spawns and is discoverable in the session list; the fork-mode metadata PATCH is tolerated to fail (child runs, just won't auto-open).

Test evidence

test/session_spawn.test.ts — 20 tests, green.
spawn-tabs.test.ts — 8 tests, green (bun).
tsc --noEmit clean; agents_md + amicode_tools suites green.
Full extension suite: the 7 failures are pre-existing on current main (environmental: vendored binary absent, pin fixtures, staged bins, pasqal venv) — verified by re-running the same files on a clean tree; this branch adds zero new failures.
drift_gate.mjs: PASS (556 files) — including the Complete the .18 pin: re-extract the app-bundle overlay + re-record the service-contract fixtures (unblocks #622 and main) #636-re-extracted state this branch rebased onto.
Overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse + review, consistent with current overlay-PR practice.

Sequencing note

Rebased onto the post-#636 main — the app-bundle-gate red that #639 was originally sequenced behind is resolved on this base.

…bs (#639) A session can now spawn new sessions that surface as background tabs in the parent's pane. Three pieces: - plugin (amicode_session): the pack's FIRST server-mutating tool. Uses the engine-provided PluginInput.client (server-bound SDK) to create and immediately prompt 1-4 children; mode=fork seeds from this session's history via /session/{id}/fork + a metadata PATCH. Children stamp metadata {spawned_by, spawned_depth}. Policy (count cap 4, soft depth cap 2 overridable with force, model precedence) lives in session_spawn.ts, unit-tested (20 tests). - app (session route): an effect in ResolvedTargetSessionRoute watches the server session store for sessions stamped spawned_by == this route's session and opens each as a background tab via tabs.addSessionTab — never navigates, never steals focus; idempotent via an opened-set. Selection logic extracted to session/spawn-tabs.ts (8 bun tests). - app-bundle manifest: hashes for the modified session.tsx + the two new overlay files (drift gate green). Test notes: the 7 failing tests in the extension suite are pre-existing on main (environmental: vendored binary, pin fixtures, staged bins) — this branch adds none. The overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse and review, consistent with current overlay-PR practice. Closes#639

coderabbitai · 2026-08-29T14:04:59Z

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
auto_review:
drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

…dated spawn plan (#646) (#648) The fleet's aggregated chat DB holds weeks of unclosed threads; nothing surfaces them. This skill codifies the sweep-and-resume pass: a read-only SQLite recipe (top-level sessions in a window, last assistant text per session, pending todos), a five-bucket classification (BLOCKED-ON-USER / INTERRUPTED / PARKED / AWAITING-REVIEW / STALE), consolidation of spawnable threads into at most 3-4 THEME-scoped sessions with self-contained seed prompts, and — only on explicit confirmation — one amicode_session call per theme (#641's spawn tool; graceful inline fallback when it isn't deployed). The DB recipe is verified verbatim against the live fleet server DB (97 sessions in a 14-day window → 60 after the noise filter; todo and last-text extraction working). Blocked-on-user and awaiting-review threads are deliberately never spawn candidates — a fresh session cannot press the button only the human can press.

aarontrowbridge · 2026-08-29T14:04:49Z

Closes#639

What

A session can now spawn new sessions that surface as background tabs beside the parent — fan-out for parallel work, fork-mode for branching a thread mid-conversation.

Piece	What it does
`amicode_session` tool	Creates 1–4 child sessions via the engine-provided `PluginInput.client` (first server-mutating tool in the pack), posts the prompt immediately (explicit model bypasses draft-readiness retries), stamps `metadata {spawned_by, spawned_depth}`. `mode: "fork"` seeds from this session's history via the native fork endpoint + metadata PATCH.
Spawn policy (`session_spawn.ts`)	Pure + unit-tested: count cap 4/call, soft depth cap 2 overridable with `force`, model precedence (arg > parent's model > server default), hey-api unwrap, honest summaries.
Session route effect	Watches the server session store for `spawned_by == this route's session`; opens each child as a background tab (`tabs.addSessionTab` — never navigates, no focus steal); idempotent via opened-set. Selection logic in `session/spawn-tabs.ts` (bun tests).
Manifest	Per-file hashes updated for the modified `session.tsx` + the two new overlay files — drift gate green locally.

Design decisions (from #639 discussion)

Auto-open, background — addSessionTab never navigates; spawning cannot steal focus.
Start immediately — promptAsync with explicit model; children churn from birth (cost noted in the tool description).
Soft depth cap — default 2, force: true overrules; depth is derived from the session's OWN stamp, not the caller's claim, so the cap is enforced by construction.
Honest fallback — if no pane shows the parent, the child still spawns and is discoverable in the session list; the fork-mode metadata PATCH is tolerated to fail (child runs, just won't auto-open).

Test evidence

test/session_spawn.test.ts — 20 tests, green.
spawn-tabs.test.ts — 8 tests, green (bun).
tsc --noEmit clean; agents_md + amicode_tools suites green.
Full extension suite: the 7 failures are pre-existing on current main (environmental: vendored binary absent, pin fixtures, staged bins, pasqal venv) — verified by re-running the same files on a clean tree; this branch adds zero new failures.
drift_gate.mjs: PASS (556 files) — including the Complete the .18 pin: re-extract the app-bundle overlay + re-record the service-contract fixtures (unblocks #622 and main) #636-re-extracted state this branch rebased onto.
Overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse + review, consistent with current overlay-PR practice.

Sequencing note

Rebased onto the post-#636 main — the app-bundle-gate red that #639 was originally sequenced behind is resolved on this base.

…bs (#639) A session can now spawn new sessions that surface as background tabs in the parent's pane. Three pieces: - plugin (amicode_session): the pack's FIRST server-mutating tool. Uses the engine-provided PluginInput.client (server-bound SDK) to create and immediately prompt 1-4 children; mode=fork seeds from this session's history via /session/{id}/fork + a metadata PATCH. Children stamp metadata {spawned_by, spawned_depth}. Policy (count cap 4, soft depth cap 2 overridable with force, model precedence) lives in session_spawn.ts, unit-tested (20 tests). - app (session route): an effect in ResolvedTargetSessionRoute watches the server session store for sessions stamped spawned_by == this route's session and opens each as a background tab via tabs.addSessionTab — never navigates, never steals focus; idempotent via an opened-set. Selection logic extracted to session/spawn-tabs.ts (8 bun tests). - app-bundle manifest: hashes for the modified session.tsx + the two new overlay files (drift gate green). Test notes: the 7 failing tests in the extension suite are pre-existing on main (environmental: vendored binary, pin fixtures, staged bins) — this branch adds none. The overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse and review, consistent with current overlay-PR practice. Closes#639

coderabbitai · 2026-08-29T14:04:59Z

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
auto_review:
drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

…dated spawn plan (#646) (#648) The fleet's aggregated chat DB holds weeks of unclosed threads; nothing surfaces them. This skill codifies the sweep-and-resume pass: a read-only SQLite recipe (top-level sessions in a window, last assistant text per session, pending todos), a five-bucket classification (BLOCKED-ON-USER / INTERRUPTED / PARKED / AWAITING-REVIEW / STALE), consolidation of spawnable threads into at most 3-4 THEME-scoped sessions with self-contained seed prompts, and — only on explicit confirmation — one amicode_session call per theme (#641's spawn tool; graceful inline fallback when it isn't deployed). The DB recipe is verified verbatim against the live fleet server DB (97 sessions in a 14-day window → 60 after the noise filter; todo and last-text extraction working). Blocked-on-user and awaiting-review threads are deliberately never spawn candidates — a fresh session cannot press the button only the human can press.

aarontrowbridge · 2026-08-29T14:04:49Z

Closes#639

What

A session can now spawn new sessions that surface as background tabs beside the parent — fan-out for parallel work, fork-mode for branching a thread mid-conversation.

Piece	What it does
`amicode_session` tool	Creates 1–4 child sessions via the engine-provided `PluginInput.client` (first server-mutating tool in the pack), posts the prompt immediately (explicit model bypasses draft-readiness retries), stamps `metadata {spawned_by, spawned_depth}`. `mode: "fork"` seeds from this session's history via the native fork endpoint + metadata PATCH.
Spawn policy (`session_spawn.ts`)	Pure + unit-tested: count cap 4/call, soft depth cap 2 overridable with `force`, model precedence (arg > parent's model > server default), hey-api unwrap, honest summaries.
Session route effect	Watches the server session store for `spawned_by == this route's session`; opens each child as a background tab (`tabs.addSessionTab` — never navigates, no focus steal); idempotent via opened-set. Selection logic in `session/spawn-tabs.ts` (bun tests).
Manifest	Per-file hashes updated for the modified `session.tsx` + the two new overlay files — drift gate green locally.

Design decisions (from #639 discussion)

Auto-open, background — addSessionTab never navigates; spawning cannot steal focus.
Start immediately — promptAsync with explicit model; children churn from birth (cost noted in the tool description).
Soft depth cap — default 2, force: true overrules; depth is derived from the session's OWN stamp, not the caller's claim, so the cap is enforced by construction.
Honest fallback — if no pane shows the parent, the child still spawns and is discoverable in the session list; the fork-mode metadata PATCH is tolerated to fail (child runs, just won't auto-open).

Test evidence

test/session_spawn.test.ts — 20 tests, green.
spawn-tabs.test.ts — 8 tests, green (bun).
tsc --noEmit clean; agents_md + amicode_tools suites green.
Full extension suite: the 7 failures are pre-existing on current main (environmental: vendored binary absent, pin fixtures, staged bins, pasqal venv) — verified by re-running the same files on a clean tree; this branch adds zero new failures.
drift_gate.mjs: PASS (556 files) — including the Complete the .18 pin: re-extract the app-bundle overlay + re-record the service-contract fixtures (unblocks #622 and main) #636-re-extracted state this branch rebased onto.
Overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse + review, consistent with current overlay-PR practice.

Sequencing note

Rebased onto the post-#636 main — the app-bundle-gate red that #639 was originally sequenced behind is resolved on this base.

…bs (#639) A session can now spawn new sessions that surface as background tabs in the parent's pane. Three pieces: - plugin (amicode_session): the pack's FIRST server-mutating tool. Uses the engine-provided PluginInput.client (server-bound SDK) to create and immediately prompt 1-4 children; mode=fork seeds from this session's history via /session/{id}/fork + a metadata PATCH. Children stamp metadata {spawned_by, spawned_depth}. Policy (count cap 4, soft depth cap 2 overridable with force, model precedence) lives in session_spawn.ts, unit-tested (20 tests). - app (session route): an effect in ResolvedTargetSessionRoute watches the server session store for sessions stamped spawned_by == this route's session and opens each as a background tab via tabs.addSessionTab — never navigates, never steals focus; idempotent via an opened-set. Selection logic extracted to session/spawn-tabs.ts (8 bun tests). - app-bundle manifest: hashes for the modified session.tsx + the two new overlay files (drift gate green). Test notes: the 7 failing tests in the extension suite are pre-existing on main (environmental: vendored binary, pin fixtures, staged bins) — this branch adds none. The overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse and review, consistent with current overlay-PR practice. Closes#639

coderabbitai · 2026-08-29T14:04:59Z

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
auto_review:
drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

…dated spawn plan (#646) (#648) The fleet's aggregated chat DB holds weeks of unclosed threads; nothing surfaces them. This skill codifies the sweep-and-resume pass: a read-only SQLite recipe (top-level sessions in a window, last assistant text per session, pending todos), a five-bucket classification (BLOCKED-ON-USER / INTERRUPTED / PARKED / AWAITING-REVIEW / STALE), consolidation of spawnable threads into at most 3-4 THEME-scoped sessions with self-contained seed prompts, and — only on explicit confirmation — one amicode_session call per theme (#641's spawn tool; graceful inline fallback when it isn't deployed). The DB recipe is verified verbatim against the live fleet server DB (97 sessions in a 14-day window → 60 after the noise filter; todo and last-text extraction working). Blocked-on-user and awaiting-review threads are deliberately never spawn candidates — a fresh session cannot press the button only the human can press.

aarontrowbridge · 2026-08-29T14:04:49Z

Closes#639

What

A session can now spawn new sessions that surface as background tabs beside the parent — fan-out for parallel work, fork-mode for branching a thread mid-conversation.

Piece	What it does
`amicode_session` tool	Creates 1–4 child sessions via the engine-provided `PluginInput.client` (first server-mutating tool in the pack), posts the prompt immediately (explicit model bypasses draft-readiness retries), stamps `metadata {spawned_by, spawned_depth}`. `mode: "fork"` seeds from this session's history via the native fork endpoint + metadata PATCH.
Spawn policy (`session_spawn.ts`)	Pure + unit-tested: count cap 4/call, soft depth cap 2 overridable with `force`, model precedence (arg > parent's model > server default), hey-api unwrap, honest summaries.
Session route effect	Watches the server session store for `spawned_by == this route's session`; opens each child as a background tab (`tabs.addSessionTab` — never navigates, no focus steal); idempotent via opened-set. Selection logic in `session/spawn-tabs.ts` (bun tests).
Manifest	Per-file hashes updated for the modified `session.tsx` + the two new overlay files — drift gate green locally.

Design decisions (from #639 discussion)

Auto-open, background — addSessionTab never navigates; spawning cannot steal focus.
Start immediately — promptAsync with explicit model; children churn from birth (cost noted in the tool description).
Soft depth cap — default 2, force: true overrules; depth is derived from the session's OWN stamp, not the caller's claim, so the cap is enforced by construction.
Honest fallback — if no pane shows the parent, the child still spawns and is discoverable in the session list; the fork-mode metadata PATCH is tolerated to fail (child runs, just won't auto-open).

Test evidence

test/session_spawn.test.ts — 20 tests, green.
spawn-tabs.test.ts — 8 tests, green (bun).
tsc --noEmit clean; agents_md + amicode_tools suites green.
Full extension suite: the 7 failures are pre-existing on current main (environmental: vendored binary absent, pin fixtures, staged bins, pasqal venv) — verified by re-running the same files on a clean tree; this branch adds zero new failures.
drift_gate.mjs: PASS (556 files) — including the Complete the .18 pin: re-extract the app-bundle overlay + re-record the service-contract fixtures (unblocks #622 and main) #636-re-extracted state this branch rebased onto.
Overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse + review, consistent with current overlay-PR practice.

Sequencing note

Rebased onto the post-#636 main — the app-bundle-gate red that #639 was originally sequenced behind is resolved on this base.

…bs (#639) A session can now spawn new sessions that surface as background tabs in the parent's pane. Three pieces: - plugin (amicode_session): the pack's FIRST server-mutating tool. Uses the engine-provided PluginInput.client (server-bound SDK) to create and immediately prompt 1-4 children; mode=fork seeds from this session's history via /session/{id}/fork + a metadata PATCH. Children stamp metadata {spawned_by, spawned_depth}. Policy (count cap 4, soft depth cap 2 overridable with force, model precedence) lives in session_spawn.ts, unit-tested (20 tests). - app (session route): an effect in ResolvedTargetSessionRoute watches the server session store for sessions stamped spawned_by == this route's session and opens each as a background tab via tabs.addSessionTab — never navigates, never steals focus; idempotent via an opened-set. Selection logic extracted to session/spawn-tabs.ts (8 bun tests). - app-bundle manifest: hashes for the modified session.tsx + the two new overlay files (drift gate green). Test notes: the 7 failing tests in the extension suite are pre-existing on main (environmental: vendored binary, pin fixtures, staged bins) — this branch adds none. The overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse and review, consistent with current overlay-PR practice. Closes#639

coderabbitai · 2026-08-29T14:04:59Z

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
auto_review:
drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

…dated spawn plan (#646) (#648) The fleet's aggregated chat DB holds weeks of unclosed threads; nothing surfaces them. This skill codifies the sweep-and-resume pass: a read-only SQLite recipe (top-level sessions in a window, last assistant text per session, pending todos), a five-bucket classification (BLOCKED-ON-USER / INTERRUPTED / PARKED / AWAITING-REVIEW / STALE), consolidation of spawnable threads into at most 3-4 THEME-scoped sessions with self-contained seed prompts, and — only on explicit confirmation — one amicode_session call per theme (#641's spawn tool; graceful inline fallback when it isn't deployed). The DB recipe is verified verbatim against the live fleet server DB (97 sessions in a 14-day window → 60 after the noise filter; todo and last-text extraction working). Blocked-on-user and awaiting-review threads are deliberately never spawn candidates — a fresh session cannot press the button only the human can press.

aarontrowbridge · 2026-08-29T14:04:49Z

Closes#639

What

A session can now spawn new sessions that surface as background tabs beside the parent — fan-out for parallel work, fork-mode for branching a thread mid-conversation.

Piece	What it does
`amicode_session` tool	Creates 1–4 child sessions via the engine-provided `PluginInput.client` (first server-mutating tool in the pack), posts the prompt immediately (explicit model bypasses draft-readiness retries), stamps `metadata {spawned_by, spawned_depth}`. `mode: "fork"` seeds from this session's history via the native fork endpoint + metadata PATCH.
Spawn policy (`session_spawn.ts`)	Pure + unit-tested: count cap 4/call, soft depth cap 2 overridable with `force`, model precedence (arg > parent's model > server default), hey-api unwrap, honest summaries.
Session route effect	Watches the server session store for `spawned_by == this route's session`; opens each child as a background tab (`tabs.addSessionTab` — never navigates, no focus steal); idempotent via opened-set. Selection logic in `session/spawn-tabs.ts` (bun tests).
Manifest	Per-file hashes updated for the modified `session.tsx` + the two new overlay files — drift gate green locally.

Design decisions (from #639 discussion)

Auto-open, background — addSessionTab never navigates; spawning cannot steal focus.
Start immediately — promptAsync with explicit model; children churn from birth (cost noted in the tool description).
Soft depth cap — default 2, force: true overrules; depth is derived from the session's OWN stamp, not the caller's claim, so the cap is enforced by construction.
Honest fallback — if no pane shows the parent, the child still spawns and is discoverable in the session list; the fork-mode metadata PATCH is tolerated to fail (child runs, just won't auto-open).

Test evidence

test/session_spawn.test.ts — 20 tests, green.
spawn-tabs.test.ts — 8 tests, green (bun).
tsc --noEmit clean; agents_md + amicode_tools suites green.
Full extension suite: the 7 failures are pre-existing on current main (environmental: vendored binary absent, pin fixtures, staged bins, pasqal venv) — verified by re-running the same files on a clean tree; this branch adds zero new failures.
drift_gate.mjs: PASS (556 files) — including the Complete the .18 pin: re-extract the app-bundle overlay + re-record the service-contract fixtures (unblocks #622 and main) #636-re-extracted state this branch rebased onto.
Overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse + review, consistent with current overlay-PR practice.

Sequencing note

Rebased onto the post-#636 main — the app-bundle-gate red that #639 was originally sequenced behind is resolved on this base.

…bs (#639) A session can now spawn new sessions that surface as background tabs in the parent's pane. Three pieces: - plugin (amicode_session): the pack's FIRST server-mutating tool. Uses the engine-provided PluginInput.client (server-bound SDK) to create and immediately prompt 1-4 children; mode=fork seeds from this session's history via /session/{id}/fork + a metadata PATCH. Children stamp metadata {spawned_by, spawned_depth}. Policy (count cap 4, soft depth cap 2 overridable with force, model precedence) lives in session_spawn.ts, unit-tested (20 tests). - app (session route): an effect in ResolvedTargetSessionRoute watches the server session store for sessions stamped spawned_by == this route's session and opens each as a background tab via tabs.addSessionTab — never navigates, never steals focus; idempotent via an opened-set. Selection logic extracted to session/spawn-tabs.ts (8 bun tests). - app-bundle manifest: hashes for the modified session.tsx + the two new overlay files (drift gate green). Test notes: the 7 failing tests in the extension suite are pre-existing on main (environmental: vendored binary, pin fixtures, staged bins) — this branch adds none. The overlay app typecheck is not a CI lane (composition proof remains the pre-cutover gate); session.tsx passes esbuild parse and review, consistent with current overlay-PR practice. Closes#639

coderabbitai · 2026-08-29T14:04:59Z

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
auto_review:
drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

…dated spawn plan (#646) (#648) The fleet's aggregated chat DB holds weeks of unclosed threads; nothing surfaces them. This skill codifies the sweep-and-resume pass: a read-only SQLite recipe (top-level sessions in a window, last assistant text per session, pending todos), a five-bucket classification (BLOCKED-ON-USER / INTERRUPTED / PARKED / AWAITING-REVIEW / STALE), consolidation of spawnable threads into at most 3-4 THEME-scoped sessions with self-contained seed prompts, and — only on explicit confirmation — one amicode_session call per theme (#641's spawn tool; graceful inline fallback when it isn't deployed). The DB recipe is verified verbatim against the live fleet server DB (97 sessions in a 14-day window → 60 after the noise filter; todo and last-text extraction working). Blocked-on-user and awaiting-review threads are deliberately never spawn candidates — a fresh session cannot press the button only the human can press.

aarontrowbridge linked an issue Aug 29, 2026 that may be closed by this pull request
feat: amicode_session tool — spawn sessions from a session as background tabs #639
Closed
7 tasks

This was referenced Aug 30, 2026
skill: open-threads — sweep recent sessions, propose a consolidated spawn plan #646
Closed
feat(skills): open-threads — sweep recent sessions, propose a consolidated spawn plan #648
Merged

aarontrowbridge marked this pull request as ready for review August 31, 2026 00:18

aarontrowbridge merged commit a0f6a46 into mainAug 31, 2026
8 checks passed

aarontrowbridge deleted the 639-feat-amicode_session-tool-spawn-sessions-from-a-session-as-background-tabs branch August 31, 2026 00:18

aarontrowbridge mentioned this pull request Aug 31, 2026
BUG: one chat message creates two identical sessions (double session-create dispatch) #655
Open

aarontrowbridge restored the 639-feat-amicode_session-tool-spawn-sessions-from-a-session-as-background-tabs branch August 31, 2026 02:40