noah-code 0.3.0__tar.gz → 0.4.0__tar.gz

{noah_code-0.3.0 → noah_code-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: noah-code
-Version: 0.3.0
+Version: 0.4.0
 Summary: Noah Code terminal coding agent, built on NVIDIA OO Agents (NOOA)
 Project-URL: Homepage, https://github.com/skundu42/noah-code
 Project-URL: Documentation, https://github.com/skundu42/noah-code#readme
@@ -101,8 +101,9 @@ configuration or session history.
 - **Persistent sessions.** Resume repository-scoped conversations, steering, todos, model choices,
   budgets, background-job logs, and compacted context without losing full tool results.
 - **Token-efficient by construction.** Lean tool-output bounds with disk-backed recall, condensed
-  subagent results, cache-stable request prefixes (volatile status arrives as appended events),
-  and pointer-eviction compaction — measured live with `/tokens`.
+  subagent results, isolated low-token helper calls, cache-stable request prefixes (volatile status
+  arrives as appended events), route-aware cache telemetry, selective memory distillation, and
+  pointer-eviction compaction with a practical context ceiling — measured live with `/tokens`.
 - **Explicit control.** Switch between implementation-focused **build** mode and read-only
   **plan** mode, with ordered `allow`, `ask`, and `deny` permission rules.
 - **Extensible workflows.** Add slash commands, opt-in skills, MCP servers, or markdown subagents;
@@ -173,6 +174,7 @@ Type `/` to search the full command and configuration reference. The most common
 | `Tab` | Switch between build and plan mode |
 | `F2` | Open execution activity |
 | `F3` | Open paginated conversation history |
+| `F4` | Open the live agent, terminal, and job ledger |
 | `/model` | Configure a provider or switch the session model |
 | `/theme` | Choose Atom One Dark, Noah Ocean, Graphite, or High Contrast |
 | `/diff` | Review staged and unstaged changes |
@@ -182,8 +184,8 @@ Type `/` to search the full command and configuration reference. The most common
 | `/tokens` | Inspect tokens, cache usage, prefix stability, model wait, and tool output |
 | `/efficiency` | Switch between `fast`, `balanced`, and `deep` budgets |
 
-On wide terminals, the side rail prioritizes the active operation, Git branch and change counts,
-session, model usage, update state, and plan. Git status is refreshed in the background at turn
+On wide terminals, the side rail prioritizes the active operation, delegated agents, named
+terminals, Git branch and change counts, session, model usage, update state, and plan. Git status is refreshed in the background at turn
 boundaries, so the animated working state stays responsive. The main pane remains centered on the
 large Noah wordmark until the first prompt, then becomes the conversation and execution timeline.
 

{noah_code-0.3.0 → noah_code-0.4.0}/README.md

@@ -56,8 +56,9 @@ configuration or session history.
 - **Persistent sessions.** Resume repository-scoped conversations, steering, todos, model choices,
   budgets, background-job logs, and compacted context without losing full tool results.
 - **Token-efficient by construction.** Lean tool-output bounds with disk-backed recall, condensed
-  subagent results, cache-stable request prefixes (volatile status arrives as appended events),
-  and pointer-eviction compaction — measured live with `/tokens`.
+  subagent results, isolated low-token helper calls, cache-stable request prefixes (volatile status
+  arrives as appended events), route-aware cache telemetry, selective memory distillation, and
+  pointer-eviction compaction with a practical context ceiling — measured live with `/tokens`.
 - **Explicit control.** Switch between implementation-focused **build** mode and read-only
   **plan** mode, with ordered `allow`, `ask`, and `deny` permission rules.
 - **Extensible workflows.** Add slash commands, opt-in skills, MCP servers, or markdown subagents;
@@ -128,6 +129,7 @@ Type `/` to search the full command and configuration reference. The most common
 | `Tab` | Switch between build and plan mode |
 | `F2` | Open execution activity |
 | `F3` | Open paginated conversation history |
+| `F4` | Open the live agent, terminal, and job ledger |
 | `/model` | Configure a provider or switch the session model |
 | `/theme` | Choose Atom One Dark, Noah Ocean, Graphite, or High Contrast |
 | `/diff` | Review staged and unstaged changes |
@@ -137,8 +139,8 @@ Type `/` to search the full command and configuration reference. The most common
 | `/tokens` | Inspect tokens, cache usage, prefix stability, model wait, and tool output |
 | `/efficiency` | Switch between `fast`, `balanced`, and `deep` budgets |
 
-On wide terminals, the side rail prioritizes the active operation, Git branch and change counts,
-session, model usage, update state, and plan. Git status is refreshed in the background at turn
+On wide terminals, the side rail prioritizes the active operation, delegated agents, named
+terminals, Git branch and change counts, session, model usage, update state, and plan. Git status is refreshed in the background at turn
 boundaries, so the animated working state stays responsive. The main pane remains centered on the
 large Noah wordmark until the first prompt, then becomes the conversation and execution timeline.
 

{noah_code-0.3.0 → noah_code-0.4.0}/docs/configuration.md

@@ -107,7 +107,9 @@ max_output_chars = 16000
 profile = "fast"          # "fast", "balanced", or "deep"
 strategy = "lean"         # "standard" is the comparison fallback
 deterministic_titles = true
-lazy_mcp = false         # true catalogs servers without attaching them at start
+memory_distillation = "heuristic" # "off", "heuristic", or "always"
+lazy_mcp = false          # true catalogs servers without attaching them at start
+context_token_budget = 64000 # automatic compaction ceiling unless max_tokens is explicit
 max_output_lines = 250
 max_search_results = 100
 max_file_results = 500
@@ -289,8 +291,25 @@ fallback cache used when workspace tools are embedded without a durable session
 
 Set `lightweight_model` to route compaction to a faster or cheaper model. If it is omitted, that
 route follows live `/model` switches. Compaction starts at 35% of the active main model's context
-window by default, preserves the six newest events, and writes a coding checkpoint covering the
-objective, decisions, files, validation, blockers, and next steps.
+window, capped at `efficiency.context_token_budget` (64k by default), preserves the six newest
+events, and writes a coding checkpoint covering the objective, decisions, files, validation,
+blockers, and next steps. An explicit `summarization.max_tokens` overrides the ceiling.
+
+`memory_distillation = "heuristic"` avoids an auxiliary model call on ordinary coding prompts and
+runs only when the user states a likely standing convention (for example “remember”, “we always”,
+or “for this project”). Use `"always"` for the earlier every-turn behavior or `"off"` to disable
+automatic memory extraction; explicit `self.memory.save(...)` remains available to the agent.
+
+Noah keeps provider `prompt_cache_key` affinity stable for a durable session, including after a
+process restart. Cache namespaces, histories, summaries, memory state, and telemetry remain
+independent between sessions. `/tokens` reports provider cache hits plus route-aware prefix
+stability and an estimated common-prefix reuse ratio; provider-reported cached tokens remain the
+authoritative billing measure.
+
+Auxiliary model work (optional title generation, memory extraction, subagent-result condensation,
+and history compaction) uses isolated histories and distinct session-local cache routes. These
+calls do not inherit repository/tool context or add their internal Tasks and results to the coding
+conversation; only their usage and runtime observability events feed the parent session.
 
 ### Budgets, checkpoints, and reliability
 

{noah_code-0.3.0 → noah_code-0.4.0}/docs/development.md

@@ -35,6 +35,18 @@ uvx pre-commit install
 Use `/tokens` during a real session to inspect provider-reported token use, cache hits, model wait,
 tool output, and estimated cost.
 
+The hermetic prompt scorecard prevents efficiency work from silently dropping agent contracts or
+growing the first request. Run it with:
+
+```bash
+uv run --all-extras pytest -q tests/test_prompt_scorecard.py tests/test_cache_context.py
+```
+
+It gates the initial token estimate, per-session cache-key and system-prefix stability, compact
+dynamic task instructions, and the required editing, validation, delegation, and safety guidance.
+It also caps isolated helper routes at 250 estimated input tokens and proves they do not mutate the
+main coding history. Live `/tokens` results remain authoritative for provider cache billing.
+
 ## CI
 
 GitHub Actions runs the complete test suite on Python 3.12 and 3.13, plus platform smoke tests on

{noah_code-0.3.0 → noah_code-0.4.0}/docs/extensions.md

@@ -36,6 +36,11 @@ oversized transcripts are condensed by the lightweight model (fallback: truncati
 pointer) before they enter the parent's context. Tune with `subagent_result_max_chars` and
 `max_concurrent_subagents` under `[efficiency]`. Add project or user markdown agents:
 
+Use `self.task.collaborate(objective, assignments, lead="general")` when parallel findings need a
+deliberate handoff. Contributors run under the same concurrency and mutation-lane rules, then the
+lead receives their bounded reports and returns one synthesized result. Live queued, running,
+completed, failed, and cancelled states are visible in the TUI work ledger (`F4`) and `/work`.
+
 - `~/.config/noah-code/agents/*.md`
 - `.noah-code/agents/*.md`
 

{noah_code-0.3.0 → noah_code-0.4.0}/docs/interactive-reference.md

@@ -16,6 +16,7 @@
 | `F1` or `?` | Show help |
 | `F2` | Open recent activity and full captured output |
 | `F3` | Open paginated persisted conversation history |
+| `F4` | Open the live work ledger for agents, terminals, and background jobs |
 | `Ctrl+]` | Return to live transcript output and clear the new-output counter |
 
 At an approval prompt, press `1` to approve once, `2` to remember the approval for the current
@@ -69,7 +70,7 @@ clears it.
 Approval and `ask.question` modals keep the composer. Queueing resumes after the modal closes.
 
 These slash commands still run while a turn is in progress: `/status`, `/tokens`, `/todos`,
-`/health`, `/help`, `/trace`. `/attach PATH` remembers the file for the next queued follow-up.
+`/health`, `/help`, `/trace`, `/work`, and `/terminals`. `/attach PATH` remembers the file for the next queued follow-up.
 `/exit` cancels the turn (and the queue) then leaves. Mutating commands wait until the turn
 finishes, including `/undo`, `/redo`, `/mode`, `/model`, `/diff`, `/new`, `/sessions`, `/worktree`,
 `/pr`, `/plan`, `/memory`, and `/compact`.
@@ -107,6 +108,8 @@ compact. `F2` retains the latest 100 activity records, bounded by the configured
 | `/todos` | Show the agent's current task list |
 | `/health` | Show durable run, job, inbox, interaction, event, database, and artifact health |
 | `/agents` | List built-in and markdown subagents |
+| `/work` | Show live and recent subagent, terminal, and background-job work |
+| `/terminals` | List named persistent terminal sessions |
 | `/attach PATH` | Attach a workspace file or image to the next turn |
 | `/status` | Inspect the current session and repository state |
 | `/diff` | Review staged and unstaged files, patches, diagnostics, and changed symbols |
@@ -215,6 +218,13 @@ output, including output from jobs recovered after restart. Lifecycle updates ap
 without copying continuous logs into model context. An agent waiting for a job wakes and continues
 the same turn when the job finishes.
 
+For command sequences that benefit from retained shell state, the agent can open multiple named
+sessions with `self.processes.open_terminal(name)`, run commands with `terminal_run`, inspect them
+with `terminal_status`, and close them with `close_terminal`. Each command passes through the same
+permission and checkpoint policy as an ordinary shell command; raw `input` is blocked for managed
+terminals so an approved shell cannot become a permission bypass. Terminal stderr is merged into
+its ordered output stream, and session state such as the current directory persists between calls.
+
 ### Subagents, web, questions, and attachments
 
 The parent agent can run isolated NOOA subagents with `self.task.run("explore", ...)` or
@@ -224,6 +234,10 @@ them with `/agents`. Repository files cannot replace the built-in `explore` or `
 and unsafe linked or oversized repository definitions are ignored. Plan mode can run read-only
 agents only. Read-only agents may run concurrently; mutating agents share one serialized mutation
 lane so parallel delegation cannot corrupt the checkout.
+For coordinated work, `self.task.collaborate(objective, assignments, lead="general")` fans out
+bounded assignments and then hands all reports to one lead agent for conflict resolution and a
+single synthesis. Agent lifecycle records and terminal/job state appear in the context rail and
+the live `F4` work ledger; `/work` provides the same information in console-friendly text.
 
 `self.web.fetch(url)` and `self.web.search(query)` are read-only and allowed by default. Fetch
 follows a bounded number of redirects and accepts only public HTTP(S) destinations; private,

noah_code-0.4.0/docs/releases/v0.4.0.md

@@ -0,0 +1,61 @@
+# Noah Code v0.4.0
+
+This release makes Noah's coding harness easier to follow and more capable during complex,
+long-running work. It adds a live work ledger, independent persistent terminal sessions, richer
+multi-agent collaboration, and substantial prompt and cache-efficiency improvements.
+
+## Live coding UX
+
+- Added an F4 work ledger that surfaces active subagents, terminal sessions, background jobs, and
+  recent activity without interrupting the main conversation.
+- Added `/work` and `/terminals` commands for quickly inspecting current agent activity and shell
+  state.
+- Removed internal completion-summary rows from the transcript so user messages and useful agent
+  output remain the focus.
+- Replaced verbose checkpoint-saved text with a compact status icon.
+
+## Independent terminal sessions
+
+- Added multiple named, persistent terminal sessions. Each session keeps its own working directory,
+  environment, process state, and output history.
+- Added predictable session lifecycle controls for creating, selecting, restarting, and closing
+  terminals while preserving isolation between sessions.
+- Preserved Noah's permission and checkpoint protections for terminal commands, blocked unsafe raw
+  input paths, and kept output ordering deterministic.
+
+## Multi-agent collaboration
+
+- Added visible lifecycle tracking for delegated tasks, including queued, running, completed, and
+  failed work.
+- Added collaboration primitives for parallel fan-out and lead-agent synthesis, with bounded result
+  condensation to keep parent contexts focused.
+- Improved coordination safety by allowing concurrent read-only work while serializing conflicting
+  writers.
+
+## Prompt and cache efficiency
+
+- Reworked the main system prompt into a smaller, Noah-specific cacheable contract and isolated
+  helper-model calls from the main conversation history.
+- Added per-session and per-route cache namespaces, cache-prefix telemetry, selective memory
+  distillation, and a 64k context ceiling.
+- Added a prompt scorecard for catching token regressions. Measured main-prompt size dropped by
+  about 41%, while common helper routes dropped by roughly 90%.
+
+## Reliability and validation
+
+- Expanded tests for terminal isolation, agent collaboration, permission handling, context
+  compaction, cache routing, TUI activity rendering, and session lifecycle behavior.
+- Hardened terminal teardown and restart paths so independent sessions do not leak state or leave
+  managed processes behind.
+
+## Upgrade
+
+Existing managed installations can run:
+
+```bash
+noah update
+```
+
+New installations can use the one-command installer from the README.
+
+**Full changelog:** https://github.com/skundu42/noah-code/compare/v0.3.0...v0.4.0

{noah_code-0.3.0 → noah_code-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "noah-code"
-version = "0.3.0"
+version = "0.4.0"
 description = "Noah Code terminal coding agent, built on NVIDIA OO Agents (NOOA)"
 readme = "README.md"
 requires-python = ">=3.12,<3.14"

{noah_code-0.3.0 → noah_code-0.4.0}/src/noah_code/__init__.py

@@ -1,3 +1,3 @@
 """Noah Code: terminal coding agent on NVIDIA OO Agents."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"