@bastani/atomic 0.8.26-alpha.7 → 0.8.26-alpha.9

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## [Unreleased]
 
+## [0.8.26-alpha.9] - 2026-06-07
+
+### Changed
+
+- Documented npm/pnpm installation options in Atomic docs and limited Mintlify validation to pull requests ([#1294](https://github.com/bastani-inc/atomic/pull/1294)).
+- Fixed Mintlify MDX autolinks in package docs so documentation validation passes ([#1293](https://github.com/bastani-inc/atomic/pull/1293)).
+
+## [0.8.26-alpha.8] - 2026-06-07
+
+### Changed
+
+- Changed manual `/compact` and auto-compaction to use deletion-only context compaction by default, preserving retained transcript content verbatim.
+- Restyled completed context compaction results with the same expandable summary-card treatment as summary compaction.
+
+### Removed
+
+- Removed the `/context-compact` interactive and workflow-stage slash command; use `/compact` instead.
+
 ## [0.8.26-alpha.7] - 2026-06-07
 
 ### Added

package/README.md

@@ -179,8 +179,7 @@ Type `/` in the editor to trigger commands. [Extensions](#extensions) can regist
 | `/tree` | Jump to any point in the session and continue from there |
 | `/fork` | Create a new session from a previous user message |
 | `/clone` | Duplicate the current active branch into a new session |
-| `/compact [prompt]` | Manually compact context, optional custom instructions |
-| `/context-compact` | Delete safe older transcript objects verbatim; no arguments |
+| `/compact` | Delete safe older transcript objects verbatim |
 | `/copy` | Copy last assistant message to clipboard |
 | `/export [file]` | Export session to HTML file |
 | `/share` | Upload as private GitHub gist with shareable HTML link |
@@ -259,15 +258,13 @@ Use `/session` in interactive mode to see the current session ID before reusing
 
 ### Compaction
 
-Long sessions can exhaust context windows. Summary compaction summarizes older messages while keeping recent ones.
+Long sessions can exhaust context windows. Compaction now uses deletion-only context compaction by default: the selected model proposes safe deletion targets, Atomic validates them locally, and retained transcript content stays verbatim.
 
-**Manual summary:** `/compact` or `/compact <custom instructions>`
+**Manual:** `/compact` has no prompt arguments.
 
-**Manual verbatim deletion:** `/context-compact` asks the selected model for deletion targets using a fixed internal prompt, validates the plan locally, and applies logical deletions only. It has no prompt arguments; `/context-compact anything` is invalid/ignored rather than treated as instructions.
+**Automatic:** Enabled by default. Triggers on context overflow (recovers and retries) or when approaching the limit (proactive). Configure via `/settings` or `settings.json`. Automatic compaction uses the same verbatim deletion path.
 
-**Automatic:** Enabled by default. Triggers on context overflow (recovers and retries) or when approaching the limit (proactive). Configure via `/settings` or `settings.json`. Automatic compaction remains summary-based.
-
-Summary compaction is lossy. `/context-compact` preserves retained transcript content verbatim, but the full history still remains in the JSONL file; use `/tree` to revisit. Customize summary compaction behavior via [extensions](#extensions). See [docs/compaction.md](docs/compaction.md) for internals.
+The full history still remains in the JSONL file; use `/tree` to revisit. See [docs/compaction.md](docs/compaction.md) for internals.
 
 ---
 

package/dist/builtin/intercom/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to the `pi-intercom` extension will be documented in this fi
 
 ## [Unreleased]
 
+## [0.8.26-alpha.9] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.9 prerelease.
+
+## [0.8.26-alpha.8] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.8 prerelease.
+
 ## [0.8.26-alpha.7] - 2026-06-07
 
 ### Changed

package/dist/builtin/intercom/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/intercom",
-  "version": "0.8.26-alpha.7",
+  "version": "0.8.26-alpha.9",
   "private": true,
   "description": "Atomic extension providing a private coordination channel between parent and child agent sessions. Fork of: https://github.com/nicobailon/pi-intercom",
   "contributors": [

package/dist/builtin/mcp/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.26-alpha.9] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.9 prerelease.
+
+## [0.8.26-alpha.8] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.8 prerelease.
+
 ## [0.8.26-alpha.7] - 2026-06-07
 
 ### Changed

package/dist/builtin/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/mcp",
-  "version": "0.8.26-alpha.7",
+  "version": "0.8.26-alpha.9",
   "private": true,
   "description": "Atomic extension that adapts MCP (Model Context Protocol) servers into the coding agent. Fork of: https://github.com/nicobailon/pi-mcp-adapter",
   "contributors": [

package/dist/builtin/subagents/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## [Unreleased]
 
+## [0.8.26-alpha.9] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.9 prerelease.
+
+## [0.8.26-alpha.8] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.8 prerelease.
+
 ## [0.8.26-alpha.7] - 2026-06-07
 
 ### Added

package/dist/builtin/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/subagents",
-  "version": "0.8.26-alpha.7",
+  "version": "0.8.26-alpha.9",
   "private": true,
   "description": "Atomic extension for delegating tasks to subagents with chains, parallel execution, and TUI clarification. Fork of: https://github.com/nicobailon/pi-subagents",
   "contributors": [

package/dist/builtin/web-access/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.8.26-alpha.9] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.9 prerelease.
+
+## [0.8.26-alpha.8] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.8 prerelease.
+
 ## [0.8.26-alpha.7] - 2026-06-07
 
 ### Changed

package/dist/builtin/web-access/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/web-access",
-  "version": "0.8.26-alpha.7",
+  "version": "0.8.26-alpha.9",
   "private": true,
   "description": "Atomic extension for web search, URL fetching, GitHub repo cloning, PDF/video extraction. Fork of: https://github.com/nicobailon/pi-web-access",
   "contributors": [

package/dist/builtin/workflows/CHANGELOG.md

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.8.26-alpha.9] - 2026-06-07
+
+### Changed
+
+- Bumped package version for the Atomic 0.8.26-alpha.9 prerelease.
+
+## [0.8.26-alpha.8] - 2026-06-07
+
+### Changed
+
+- Updated workflow-stage chat so `/compact` is the no-argument compaction command and `/context-compact` is no longer handled locally.
+
 ## [0.8.26-alpha.7] - 2026-06-07
 
 ### Changed

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.8.26-alpha.7",
+  "version": "0.8.26-alpha.9",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [

package/dist/builtin/workflows/src/extension/wiring.ts

@@ -226,7 +226,19 @@ async function createTestAgentSession(_options?: CreateAgentSessionOptions): Pro
       return { cancelled: true };
     },
     async compact(): ReturnType<StageSessionRuntime["compact"]> {
-      return { summary: "", firstKeptEntryId: "", tokensBefore: 0 };
+      return {
+        promptVersion: 1,
+        deletedTargets: [],
+        protectedEntryIds: [],
+        stats: {
+          objectsBefore: 0,
+          objectsAfter: 0,
+          objectsDeleted: 0,
+          tokensBefore: 0,
+          tokensAfter: 0,
+          percentReduction: 0,
+        },
+      };
     },
     abortCompaction(): void {},
     async abort(): Promise<void> {},

package/dist/builtin/workflows/src/runs/foreground/executor.ts

@@ -3462,9 +3462,15 @@ export async function run<TInputs extends WorkflowInputValues>(
 
       const compactionMeta = (result: unknown): string | undefined => {
         if (result === undefined || result === null || typeof result !== "object") return undefined;
-        const compaction = result as { tokensBefore?: unknown; tokensAfter?: unknown; tokensKept?: unknown };
-        const before = typeof compaction.tokensBefore === "number" ? compaction.tokensBefore : undefined;
-        const keptRaw = compaction.tokensKept ?? compaction.tokensAfter;
+        const compaction = result as {
+          stats?: { tokensBefore?: unknown; tokensAfter?: unknown };
+          tokensBefore?: unknown;
+          tokensAfter?: unknown;
+          tokensKept?: unknown;
+        };
+        const beforeRaw = compaction.stats?.tokensBefore ?? compaction.tokensBefore;
+        const keptRaw = compaction.stats?.tokensAfter ?? compaction.tokensKept ?? compaction.tokensAfter;
+        const before = typeof beforeRaw === "number" ? beforeRaw : undefined;
         const kept = typeof keptRaw === "number" ? keptRaw : undefined;
         if (before === undefined || kept === undefined) return undefined;
         return `${(before / 1000).toFixed(1)}k → ${(kept / 1000).toFixed(1)}k`;
@@ -3509,9 +3515,9 @@ export async function run<TInputs extends WorkflowInputValues>(
           recordStageNotice({ kind: "tree", to: targetId });
           return innerCtx.navigateTree(targetId, treeOptions);
         },
-        compact: async (customInstructions) => {
-          const result = await innerCtx.compact(customInstructions);
-          recordStageNotice({ kind: "compaction", to: "summarized", meta: compactionMeta(result) });
+        compact: async () => {
+          const result = await innerCtx.compact();
+          recordStageNotice({ kind: "compaction", to: "compacted", meta: compactionMeta(result) });
           return result;
         },
         abortCompaction: () => innerCtx.abortCompaction(),

package/dist/builtin/workflows/src/runs/foreground/stage-runner.ts

@@ -992,8 +992,8 @@ export function createStageContext(opts: StageRunnerOpts): InternalStageContext
       return (await ensureSession()).navigateTree(targetId, options);
     },
 
-    async compact(customInstructions) {
-      return (await ensureSession()).compact(customInstructions);
+    async compact() {
+      return (await ensureSession()).compact();
     },
 
     abortCompaction() {

package/dist/builtin/workflows/src/shared/authoring-contract.d.ts

@@ -188,7 +188,7 @@ export interface StageSessionRuntime {
         readonly editorText?: string;
         readonly cancelled: boolean;
     }>;
-    compact(customInstructions?: string): Promise<object>;
+    compact(): Promise<object>;
     abortCompaction(): void;
     abort(): Promise<void>;
     dispose(): void | Promise<void>;
@@ -248,7 +248,7 @@ export interface StageContext {
         readonly editorText?: string;
         readonly cancelled: boolean;
     }>;
-    compact(customInstructions?: string): Promise<object>;
+    compact(): Promise<object>;
     abortCompaction(): void;
     abort(): Promise<void>;
 }

package/dist/builtin/workflows/src/shared/types.ts

@@ -6,7 +6,7 @@
 import type {
   AgentSession,
   AgentSessionEvent,
-  CompactionResult,
+  ContextCompactionResult,
   CreateAgentSessionOptions,
   ModelCycleResult,
   PromptOptions,
@@ -19,7 +19,7 @@ import type * as AuthoringContract from "./authoring-contract.js";
 
 export type { TSchema };
 
-export type { AgentSessionEvent, CompactionResult, ModelCycleResult, PromptOptions };
+export type { AgentSessionEvent, ContextCompactionResult, ModelCycleResult, PromptOptions };
 
 export type WorkflowModelValue = NonNullable<CreateAgentSessionOptions["model"]> | string;
 export type WorkflowModelUsage = AuthoringContract.WorkflowModelUsage;
@@ -308,7 +308,7 @@ export interface StageContext {
   ): Promise<{ editorText?: string; cancelled: boolean }>;
 
   /** Compaction. */
-  compact(customInstructions?: string): Promise<CompactionResult>;
+  compact(): Promise<ContextCompactionResult>;
   abortCompaction(): void;
 
   /** Abort current operation. */

package/dist/builtin/workflows/src/tui/stage-chat-view.ts

@@ -665,20 +665,12 @@ export class StageChatView implements Component, Focusable {
     const [command, ...rest] = text.trim().split(/\s+/);
     switch (command) {
       case "/compact": {
-        const handle = this._liveHandle();
-        if (!handle) return false;
-        await handle.ensureAttached();
-        if (!handle.agentSession) return false;
-        await handle.agentSession.compact(rest.join(" ") || undefined);
-        return true;
-      }
-      case "/context-compact": {
         if (rest.length > 0) return true;
         const handle = this._liveHandle();
         if (!handle) return false;
         await handle.ensureAttached();
         if (!handle.agentSession) return false;
-        await handle.agentSession.contextCompact();
+        await handle.agentSession.compact();
         return true;
       }
       case "/quit":

package/dist/core/agent-session.d.ts

@@ -61,7 +61,7 @@ export type AgentSessionEvent = AgentEvent | {
 } | {
     type: "compaction_end";
     reason: "manual" | "threshold" | "overflow";
-    result: CompactionResult | undefined;
+    result: CompactionResult | ContextCompactionResult | undefined;
     aborted: boolean;
     willRetry: boolean;
     errorMessage?: string;
@@ -483,12 +483,12 @@ export declare class AgentSession {
      * Saves to settings.
      */
     setFollowUpMode(mode: "all" | "one-at-a-time"): void;
+    private _applyContextVerbatimCompaction;
     /**
-     * Manually compact the session context.
-     * Aborts current agent operation first.
-     * @param customInstructions Optional instructions for the compaction summary
+     * Manually compact the session context using deletion-only verbatim context compaction.
+     * Aborts current agent operation first. Custom summary instructions are not accepted.
      */
-    compact(customInstructions?: string): Promise<CompactionResult>;
+    compact(customInstructions?: string): Promise<ContextCompactionResult>;
     /**
      * Manually compact the session context by applying validated logical deletions.
      * Retained transcript entries/content blocks stay verbatim; no user prompt text is accepted.