AGENTS.md@packages/client/src/lib/spawn git:20261104.c382d40A

Immutable. This exact content never changes and is served at /api/v1/blob/7f6f9cb646a1ac00.

# DOX — packages/client/src/lib/spawn

Files in this directory. One row per source file.

| File | Purpose |
|------|---------|
| `__tests__/spawn-choice-memory.test.ts` | E36 storage-unavailable totality, E37 per-field fallback, garbled JSON → empty. See change: add-spawn-model-choice. |
| `__tests__/spawn-opts.test.ts` | E44 `siblingSpawnOpts` matrix (pi / empty / ACP) + `initializeSpawnOpts`. See change: add-spawn-model-choice. |
| `spawn-choice-memory.ts` | Per-folder spawn model · thinking memory (read side, eager landing chunk; no React). localStorage `pi-dashboard:spawn-choice:<cwd>` = `{model?, thinkingLevel?}`; `@role` stored verbatim. `getRememberedSpawnChoice` (total), `normalizeSpawnChoice`, `spawnChoiceKey`. Settings-defaults mirror `setSpawnDefaults` / `getSpawnDefaults` / `subscribeSpawnDefaults` (App writes). `getEffectiveSpawnChoice(cwd, fallback?)` = remembered ?? default, per field. See change: add-spawn-model-choice. |
| `spawn-choice-write.ts` | Write side of the spawn-choice memory: `setRememberedSpawnChoice` (empty → key removed), `clearRememberedSpawnField`. Total over unavailable storage. Imported only by the lazy `SpawnChoiceChip` so writes stay off the landing chunk. See change: add-spawn-model-choice. |
| `spawn-opts.ts` | `siblingSpawnOpts(s)` — ACP → `{agent}`, pi → non-empty `model`/`thinkingLevel`, else `undefined`. `initializeSpawnOpts(cwd, prompt)` — `{initialPrompt, ...getEffectiveSpawnChoice(cwd)}`, always pi. Used by `SessionList` + `App`. See change: add-spawn-model-choice. |