pi-roundtable 0.7.9 → 0.7.10

package/CHANGELOG.md

@@ -5,6 +5,17 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.7.10] - 2026-10-03
+
+### Added
+
+- Kit: the core's compaction tiers for a host that builds its own Pi session, such as a sandbox worker: `CompactionTiers`, `compactionEngine`, `SOFT_COMPACT_TOKENS`, `HARD_COMPACT_TOKENS`, `COMPACT_HEADROOM_TOKENS`, and the types `CompactionEngine`, `CompactionHistory` and `LatestCompaction`.
+- Sandbox: Pi worker sessions compact with those tiers, through an optional host compactor (`compaction` on `PiSandboxRuntime`) at 300,000 tokens and Pi's summary past 500,000, and the host logs each compaction and fallback per channel.
+
+### Changed
+
+- Sandbox: a failed Pi turn keeps its cause and is logged, the broker logs upstream failures, a timed-out worker's last log lines are logged before its container is removed, and Pi containers log to journald tagged `sandbox/<channel>` by default instead of local files (the Docker daemon must have journald).
+
 ## [0.7.9] - 2026-10-03
 
 ### Added

package/docs/plugins.md

@@ -67,6 +67,7 @@ Use the kit's building blocks for a plugin that runs Pi itself, such as a coding
 - Tools: `textToolsExtension`, `requiredString`, `stringList` (with `toolText` and `toolError`) for tools that return text.
 - Mirroring a built-in tool in a worker that cannot reach the host: `SCHEDULE_TOOLS`, `scheduleToolSpecs({ locale, timeZone })`, `isScheduleTool`, `callScheduleTool`, `DELEGATE_TOOL` and `DELEGATE_TOOL_SPEC`.
   The specs take the locale and time zone for their descriptions, so the worker needs no process-wide setting.
+- Compaction: `CompactionTiers` gives a session the core's compaction tiers (`settings()` for Pi's `SettingsManager`, `wrapCompactor(factory, onBypass)` to hold a compaction extension back past the ceiling, `latest()`), with `SOFT_COMPACT_TOKENS` (300,000), `HARD_COMPACT_TOKENS` (500,000), `COMPACT_HEADROOM_TOKENS` (50,000), `compactionEngine(details, engine)` and the types `CompactionEngine`, `CompactionHistory` and `LatestCompaction`.
 - Effort: `effortJudge` picks a turn's thinking level from a message with your own brief (`EffortBrief`, `JUDGE_WORK`).
 - Presentation and small helpers: `thinkingLine`, `zonedStamp(date, timeZone)`, `channelQueue()` (a queue of your own, so work does not wait behind a running turn), `checkRepoName` and `SKILL_LIST_TOOL` with `skillListExtension` for repositories and skills, and `searchTerms` for memory search.
 
@@ -2665,6 +2666,14 @@ Import from the entries listed below; source area files are internal.
 | `formatModelRef` | `pi-roundtable/kit` | value |
 | `headline` | `pi-roundtable/kit` | value |
 | `holdChain` | `pi-roundtable/kit` | value |
+| `COMPACT_HEADROOM_TOKENS` | `pi-roundtable/kit` | value |
+| `CompactionTiers` | `pi-roundtable/kit` | value |
+| `compactionEngine` | `pi-roundtable/kit` | value |
+| `HARD_COMPACT_TOKENS` | `pi-roundtable/kit` | value |
+| `SOFT_COMPACT_TOKENS` | `pi-roundtable/kit` | value |
+| `CompactionEngine` | `pi-roundtable/kit` | type |
+| `CompactionHistory` | `pi-roundtable/kit` | type |
+| `LatestCompaction` | `pi-roundtable/kit` | type |
 | `isScheduleTool` | `pi-roundtable/kit` | value |
 | `lastAssistant` | `pi-roundtable/kit` | value |
 | `mcpAdapterExtension` | `pi-roundtable/kit` | value |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable",
-	"version": "0.7.9",
+	"version": "0.7.10",
 	"description": "A plugin-driven Pi agent server for Discord",
 	"type": "module",
 	"license": "MIT",

package/src/kit/compaction.ts

@@ -0,0 +1,14 @@
+// The core's compaction tiers, for a host that builds its own Pi session (a sandbox worker, say).
+
+export type {
+	CompactionEngine,
+	CompactionHistory,
+	LatestCompaction,
+} from "../core/runtime/compaction-tiers.ts";
+export {
+	COMPACT_HEADROOM_TOKENS,
+	CompactionTiers,
+	compactionEngine,
+	HARD_COMPACT_TOKENS,
+	SOFT_COMPACT_TOKENS,
+} from "../core/runtime/compaction-tiers.ts";

package/src/kit/index.ts

@@ -14,6 +14,18 @@ export {
 	withAttachmentsBlock,
 	withReference,
 } from "./channels.ts";
+export type {
+	CompactionEngine,
+	CompactionHistory,
+	LatestCompaction,
+} from "./compaction.ts";
+export {
+	COMPACT_HEADROOM_TOKENS,
+	CompactionTiers,
+	compactionEngine,
+	HARD_COMPACT_TOKENS,
+	SOFT_COMPACT_TOKENS,
+} from "./compaction.ts";
 export { scrubDiagnostic } from "./diagnostics.ts";
 export type {
 	ChoiceAnswer,