@gajae-code/coding-agent 0.11.11 → 0.12.0

package/dist/types/session/memory-guard-checkpoint-participant.d.ts

@@ -0,0 +1,69 @@
+import type { RecoveryFsRoot } from "@gajae-code/natives";
+import type { RecoveryHydrationContext, ResumeSessionIdentity, SessionDestinationInput, SessionManager, SessionManagerCheckpointRevisionStrings, StrictSessionOpenFailure } from "./session-manager";
+export interface MemoryGuardTranscriptDescriptorV1 {
+    bytes: string;
+    relative_path: string;
+    sha256: string;
+}
+export interface MemoryGuardCheckpointBlobAuthorityV1 {
+    kind: "checkpoint_blob_tree_v1";
+    manifest_relative_path: string;
+    manifest_sha256: string;
+    root_relative_path: string;
+}
+export interface MemoryGuardCheckpointBlobManifestEntryV1 {
+    bytes: string;
+    relative_path: string;
+    sha256: string;
+}
+export interface MemoryGuardCheckpointBlobManifestV1 {
+    entries: MemoryGuardCheckpointBlobManifestEntryV1[];
+    schema_version: 1;
+}
+export interface MemoryGuardSessionManagerCheckpointV1 {
+    blob_authority: MemoryGuardCheckpointBlobAuthorityV1;
+    revisions: SessionManagerCheckpointRevisionStrings;
+    schema_version: 1;
+    session_id: string;
+    session_name: string | null;
+    transcript: MemoryGuardTranscriptDescriptorV1;
+}
+export interface MemoryGuardParticipantDescriptorV1 {
+    ordinal: number;
+    checkpoint: MemoryGuardCheckpointBlobAuthorityV1;
+    revisions: SessionManagerCheckpointRevisionStrings;
+    session_id: string;
+    session_name: string | null;
+    transcript: MemoryGuardTranscriptDescriptorV1;
+}
+export interface MemoryGuardParticipantIngressLease {
+    readonly token: symbol;
+    release(): void;
+}
+export interface MemoryGuardCreateCheckpointInput {
+    ingressLease: MemoryGuardParticipantIngressLease;
+    checkpointRoot: string;
+}
+export type MemoryGuardRestoreBlockedReason = StrictSessionOpenFailure["reason"] | "checkpoint-mismatch" | "participant-mismatch" | "transcript-mismatch" | "blob-manifest-mismatch" | "blob-missing" | "blob-hash-mismatch" | "blob-authority-mismatch" | "destination-unavailable";
+export interface MemoryGuardRestoreInput {
+    incidentAuthority: RecoveryFsRoot;
+    participant: MemoryGuardParticipantDescriptorV1;
+    checkpoint: MemoryGuardSessionManagerCheckpointV1;
+    destination: SessionDestinationInput;
+}
+export type MemoryGuardRestoreResult = {
+    kind: "staged";
+    manager: SessionManager;
+    hydrationContext: RecoveryHydrationContext;
+    transcriptIdentity: ResumeSessionIdentity;
+    cleanup: () => Promise<void>;
+} | {
+    kind: "blocked";
+    reason: MemoryGuardRestoreBlockedReason;
+};
+export declare function memoryGuardCanonicalJson(value: unknown): string;
+export declare function memoryGuardSha256Hex(value: Uint8Array | string): string;
+export declare function isMemoryGuardDecimalString(value: unknown): value is string;
+export declare function isMemoryGuardSha256Hex(value: unknown): value is string;
+export declare function isMemoryGuardRelativePath(value: unknown): value is string;
+export declare function hasOnlyKeys(value: Record<string, unknown>, allowed: readonly string[]): boolean;

package/dist/types/session/session-manager.d.ts

@@ -8,6 +8,7 @@ import { ArtifactManager } from "./artifacts";
 import { type BlobPutResult, BlobStore } from "./blob-store";
 import { type ManagedMigrationPolicy } from "./internal/managed-session-scope";
 import { type ManagedDirectoryRoot, ManagedSessionDescendantStore } from "./internal/managed-session-storage";
+import { type MemoryGuardCreateCheckpointInput, type MemoryGuardParticipantIngressLease, type MemoryGuardRestoreInput, type MemoryGuardRestoreResult, type MemoryGuardSessionManagerCheckpointV1 } from "./memory-guard-checkpoint-participant";
 import { type BashExecutionMessage, type CustomMessage, type FileMentionMessage, type HookMessage, type PythonExecutionMessage } from "./messages";
 import { type SessionManagerReadAccess, sessionManagerReadCapability } from "./session-manager-internal";
 import type { ManagedSessionSecurityContext, SessionStorage, SessionStorageStat, VerifiedSessionDeleteResult, VerifiedSessionDeleteTarget } from "./session-storage";
@@ -259,6 +260,21 @@ export type DefaultModelSelectionStage = {
     readonly tempPath: string | undefined;
     readonly persistsToExistingFile: boolean;
 };
+export interface SessionManagerRevisionSnapshot {
+    entry: number;
+    leaf: number;
+    headerExport: number;
+    label: number;
+    replayMetadata: number;
+}
+export interface SessionManagerCheckpointRevisionStrings {
+    entry: string;
+    leaf: string;
+    headerExport: string;
+    label: string;
+    replayMetadata: string;
+}
+export declare function toSessionManagerCheckpointRevisionStrings(snapshot: SessionManagerRevisionSnapshot): SessionManagerCheckpointRevisionStrings;
 export type DefaultModelSelectionPromotion = {
     readonly kind: "promoted";
 } | {
@@ -541,6 +557,10 @@ export declare function residentBlobSentinelForTests(kind: ResidentBlobKind, ref
 export declare function materializeResidentEntriesForPersistenceForTests<T>(entries: T[], textStore: BlobStore, imageStore?: BlobStore): T[];
 /** Get recent sessions for display in welcome screen */
 export declare function getRecentSessions(sessionDir: string, limit?: number, storage?: SessionStorage): Promise<RecentSessionInfo[]>;
+export declare function getRecentSessionDisplay(sessions: readonly SessionInfo[], limit?: number): Array<{
+    name: string;
+    timeAgo: string;
+}>;
 /**
  * Manages conversation sessions as append-only trees stored in JSONL files.
  *
@@ -589,13 +609,7 @@ export declare class SessionManager {
      * revision contract). Tests assert the invalidation mapping through this;
      * future export/label-view caches key off their respective domains.
      */
-    revisionSnapshot(): {
-        entry: number;
-        leaf: number;
-        headerExport: number;
-        label: number;
-        replayMetadata: number;
-    };
+    revisionSnapshot(): SessionManagerRevisionSnapshot;
     /** Puts a binary blob into the blob store and returns the blob reference */
     putBlob(data: Buffer): Promise<BlobPutResult>;
     captureState(): SessionManagerStateSnapshot;
@@ -691,6 +705,8 @@ export declare class SessionManager {
     listForResumePickerReadOnly(): Promise<SessionInfo[]>;
     getSessionId(): string;
     getSessionFile(): string | undefined;
+    acquireMemoryGuardParticipantIngressLease(): MemoryGuardParticipantIngressLease;
+    createMemoryGuardCheckpoint(input: MemoryGuardCreateCheckpointInput): Promise<MemoryGuardSessionManagerCheckpointV1>;
     /**
      * Returns the session artifacts directory path (session file path without .jsonl).
      * Returns null when the session is not persisted to a file.
@@ -747,11 +763,6 @@ export declare class SessionManager {
     /** The source that set the session name: "user" (manual /rename or RPC) or "auto" (generated title). */
     get titleSource(): "auto" | "user" | undefined;
     getSessionName(): string | undefined;
-    /**
-     * Set the session display name.
-     * @param source - "user" for explicit renames (/rename command, RPC); "auto" for generated titles.
-     *   Auto-generated titles are silently ignored when the user has already set a name.
-     */
     setSessionName(name: string, source?: "auto" | "user"): Promise<boolean>;
     _persist(entry: SessionEntry): void;
     /** Append a configured fallback chain as child of current leaf, then advance leaf. Returns entry id. */
@@ -971,7 +982,7 @@ export declare class SessionManager {
      * legacy sibling directories.
      */
     static listForResumePickerReadOnly(cwd: string, sessionDir?: string, storage?: SessionStorage): Promise<SessionInfo[]>;
-    /** Tombstone and exact-delete a default-managed candidate. */
+    /** Delete an authorized managed or project-local picker candidate. */
     static deleteManagedCandidate(sessionPath: string): Promise<void>;
     /** Capture exact source content for a strict fork without granting write ownership. */
     static captureTranscriptStrict(filePath: string, storage?: SessionStorage): StrictSessionCaptureResult;
@@ -981,6 +992,7 @@ export declare class SessionManager {
      * persistence; destination history always comes from the captured bytes.
      */
     static forkFromCaptured(snapshot: CapturedSessionTranscriptSnapshot, cwd: string, destinationInput?: SessionDestinationInput, _migrationPolicy?: SessionDirectoryMigrationPolicy): Promise<StrictSessionForkResult>;
+    static restoreMemoryGuardCheckpoint(input: MemoryGuardRestoreInput): Promise<MemoryGuardRestoreResult>;
     /** Inspect a selected session without acquiring write-capable ownership. */
     static inspectSessionTailReadOnly(filePath: string, storage?: SessionStorage): Promise<ResumeTailInspection>;
     /**

package/dist/types/session/streaming-output.d.ts

@@ -83,7 +83,10 @@ export interface TruncationResult {
     elidedLines?: number;
     lastLinePartial?: boolean;
     firstLineExceedsLimit?: boolean;
+    lastLineExceedsLimit?: boolean;
 }
+/** Direction vocabulary used by callers that select which end of content to retain. */
+export type TruncationDirection = "head" | "last" | "both";
 export interface TruncationOptions {
     /** Maximum number of lines (default: 3000) */
     maxLines?: number;
@@ -99,6 +102,8 @@ export interface TruncationOptions {
      * window receives `maxLines - maxHeadLines`. Default `floor(maxLines/2)`.
      */
     maxHeadLines?: number;
+    /** Direction to dispatch through truncateContent (head, last, or both). */
+    direction?: TruncationDirection;
 }
 /** Result from byte-level truncation helpers. */
 export interface ByteTruncationResult {
@@ -155,14 +160,64 @@ export declare function truncateTail(content: string, options?: TruncationOption
  */
 export declare function formatMiddleElisionMarker(elidedLines: number, elidedBytes: number): string;
 /**
- * Truncate content keeping a head window and a tail window, eliding the middle.
+ * A retained source segment returned by {@link truncateMiddleWindows}.
+ * Line coordinates are 1-indexed and inclusive.
+ */
+export type ReadSegment = {
+    kind: "lines";
+    content: string;
+    lines: number;
+    bytes: number;
+    origin: {
+        startLine: number;
+        endLine: number;
+    };
+    lastLinePartial: false;
+} | {
+    kind: "partial-line";
+    content: string;
+    lines: 1;
+    bytes: number;
+    origin: {
+        startLine: number;
+        endLine: number;
+    };
+    sourceLineBytes: number;
+    lastLinePartial: true;
+};
+/** The actual windows retained by middle truncation. */
+export interface ReadWindow {
+    kind: "full" | "head-only" | "tail-only" | "middle";
+    head?: ReadSegment;
+    tail?: ReadSegment;
+    overlap: "disjoint" | "adjacent" | "overlapping";
+    elidedLines: number;
+    elidedBytes: number;
+    totalLines: number;
+    totalBytes: number;
+    /** @deprecated Non-enumerable compatibility reason for older consumers. */
+    truncatedBy?: "lines" | "bytes" | "middle";
+}
+/**
+ * Truncate content while exposing the exact retained head/tail windows.
  *
- * The combined output is `<head>\n<marker>\n<tail>` when truncation is needed.
- * `maxHeadBytes` defaults to `floor(maxBytes / 2)`; the tail receives the
- * remainder. Falls back to `truncateTail` / `truncateHead` if either side's
- * budget is empty or the content already fits.
+ * The budget split and fallback ordering intentionally mirror truncateMiddle.
+ * The overlap classification is performed before resolving an overlap to a
+ * full window, so callers can distinguish disjoint, adjacent and overlapping
+ * candidate windows even when no marker is needed.
+ */
+export declare function truncateMiddleWindows(content: string, options?: TruncationOptions): ReadWindow;
+/**
+ * Truncate content keeping a head window and a tail window, eliding the middle.
+ * The composed return shape remains field-for-field compatible with the
+ * historical implementation; callers that need coordinates use
+ * truncateMiddleWindows directly.
  */
 export declare function truncateMiddle(content: string, options?: TruncationOptions): TruncationResult;
+/**
+ * Dispatch truncation using the caller-facing direction vocabulary.
+ */
+export declare function truncateContent(content: string, options?: TruncationOptions): TruncationResult;
 export declare class TailBuffer {
     #private;
     readonly maxBytes: number;

package/dist/types/skill-state/active-state.d.ts

@@ -45,8 +45,6 @@ export interface SkillActiveEntry {
     handoff_at?: string;
     active_subskills?: ActiveSubskillEntry[];
     source_state_revision?: number;
-    /** Durable ordering token from the source workflow mode-state, not this cache file's revision. */
-    committed_mode_state_revision?: number;
 }
 export interface SkillActiveState {
     version?: number;
@@ -87,8 +85,6 @@ export interface SyncSkillActiveStateOptions {
     handoff_at?: string;
     active_subskills?: ActiveSubskillEntry[];
     sourceRevision?: number;
-    /** Durable ordering token from the source workflow mode-state, not this cache file's revision. */
-    committedModeRevision?: number;
 }
 export declare function normalizeWorkflowHudSummary(raw: unknown): WorkflowHudSummary | undefined;
 export declare function isCanonicalGjcWorkflowSkill(skill: string): skill is CanonicalGjcWorkflowSkill;

package/dist/types/skill-state/workflow-hud.d.ts

@@ -20,6 +20,9 @@ interface RalplanHudState extends WorkflowGateHudState {
     iteration?: number;
     iterationFromIndex?: number;
     stages?: string;
+    architectPasses?: number;
+    criticPasses?: number;
+    reviewPassBudget?: number;
     verdict?: string;
     latestSummary?: string;
     pendingApproval?: boolean;

package/dist/types/tools/browser/launch.d.ts

@@ -13,6 +13,13 @@ export declare const DEFAULT_VIEWPORT: {
 export declare const BROWSER_PROTOCOL_TIMEOUT_MS = 60000;
 export declare function loadPuppeteer(): Promise<typeof Puppeteer>;
 export declare function loadPuppeteerInWorker(safeDir: string): Promise<typeof Puppeteer>;
+/** Test seam: the browser launch overrides as resolved from trusted env. */
+export declare function resolveBrowserEnvOverridesForTest(): {
+    executablePath: string | undefined;
+    proxy: string | undefined;
+    proxyBypassLoopback: boolean;
+    ignoreCertErrors: boolean;
+};
 export interface LaunchHeadlessOptions {
     headless: boolean;
     viewport?: {

package/dist/types/tools/fetch.d.ts

@@ -4,6 +4,7 @@ import type { Settings } from "../config/settings";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { type Theme } from "../modes/theme/theme";
 import type { ToolSession } from "../sdk";
+import { type TruncationDirection } from "../session/streaming-output";
 import type { RenderResult } from "../web/scrapers/types";
 import { type OutputMeta } from "./output-meta";
 export declare function isReadableUrlPath(value: string): boolean;
@@ -50,7 +51,12 @@ interface ReadUrlCacheEntry {
     artifactId?: string;
     details: ReadUrlToolDetails;
     image?: FetchImagePayload;
+    /** Complete URL output, including its preamble and body. */
     output: string;
+    /** UTF-16 code-unit offset of the preamble in `output`. */
+    preambleChars: number;
+    /** Offset of the preamble after `wrapUntrustedContent(output)` is persisted. */
+    wrappedPreambleChars?: number;
 }
 export declare function loadReadUrlCacheEntry(session: ToolSession, params: {
     path: string;
@@ -59,11 +65,21 @@ export declare function loadReadUrlCacheEntry(session: ToolSession, params: {
     ensureArtifact?: boolean;
     preferCached?: boolean;
 }): Promise<ReadUrlCacheEntry>;
+export declare const WRAP_PREFIX_CHARS: number;
+export declare function escapeUntrustedContent(content: string): string;
 export declare function wrapUntrustedContent(content: string): string;
+/**
+ * Remove only the outer URL-output wrapper before line pagination. The content
+ * remains escaped exactly as persisted; it is deliberately never unescaped.
+ */
+export declare function prepareReadUrlSelectorInput(output: string, preambleChars: number, wrappedPreambleChars?: number): {
+    text: string;
+    preambleChars: number;
+};
 export declare function executeReadUrl(session: ToolSession, params: {
     path: string;
     raw?: boolean;
-}, signal?: AbortSignal): Promise<AgentToolResult<ReadUrlToolDetails>>;
+}, signal?: AbortSignal, direction?: TruncationDirection): Promise<AgentToolResult<ReadUrlToolDetails>>;
 /** Render URL read call (URL preview) */
 export declare function renderReadUrlCall(args: {
     path?: string;

package/dist/types/tools/output-meta.d.ts

@@ -7,12 +7,15 @@
 import type { AgentTool } from "@gajae-code/agent-core";
 import { type Settings } from "../config/settings";
 import type { Theme } from "../modes/theme/theme";
-import { type OutputSummary, type TruncationResult } from "../session/streaming-output";
+import { type OutputSummary, type ReadWindow, type TruncationResult } from "../session/streaming-output";
 /**
  * Truncation metadata for the output notice.
  */
 export interface TruncationMeta {
     direction: "head" | "tail" | "middle";
+    /** Coordinate basis for shown/head/tail ranges. Omitted means file coordinates; "window" is the selected-range coordinate system. */
+    rangeBase?: "file" | "window";
+    noticeOwner?: "body";
     truncatedBy: "lines" | "bytes" | "middle";
     totalLines: number;
     totalBytes: number;
@@ -33,6 +36,12 @@ export interface TruncationMeta {
         start: number;
         end: number;
     };
+    /** Partial source-line preview retained by a directional window. */
+    partialLine?: {
+        line: number;
+        bytes: number;
+        sourceBytes: number;
+    };
     /** Bytes elided from the middle. */
     elidedBytes?: number;
     /** Lines elided from the middle. */
@@ -96,11 +105,14 @@ export interface TruncationOptions {
     startLine?: number;
     totalFileLines?: number;
     artifactId?: string;
+    maxBytes?: number;
+    noticeOwner?: "body";
 }
 export interface TruncationSummaryOptions {
     direction: "head" | "tail" | "middle";
     startLine?: number;
     totalFileLines?: number;
+    noticeOwner?: "body";
 }
 export interface TruncationTextOptions {
     direction: "head" | "tail" | "middle";
@@ -108,6 +120,7 @@ export interface TruncationTextOptions {
     totalBytes?: number;
     maxBytes?: number;
     artifactId?: string;
+    noticeOwner?: "body";
 }
 /**
  * Fluent builder for OutputMeta.
@@ -125,6 +138,13 @@ export declare class OutputMetaBuilder {
     #private;
     /** Add truncation info from TruncationResult. No-op if not truncated. */
     truncation(result: TruncationResult, options: TruncationOptions): this;
+    /** Add metadata from the actual head/tail windows retained by middle truncation. */
+    truncationWindows(windows: ReadWindow, options?: {
+        artifactId?: string;
+        noticeOwner?: "body";
+        maxBytes?: number;
+        rangeBase?: "file" | "window";
+    }): this;
     /** Add truncation info from OutputSummary. No-op if not truncated. */
     truncationFromSummary(summary: OutputSummary, options: TruncationSummaryOptions): this;
     /** Add truncation info from truncated output text. No-op if truncation not detected. */

package/dist/types/tools/read-internals.d.ts

@@ -0,0 +1,12 @@
+import type { Settings } from "../config/settings";
+import type { TruncationDirection } from "../session/streaming-output";
+/**
+ * Read execution routes that have distinct truncation-default contracts.
+ * Routes that share the same default are grouped only when their truncation
+ * policy is identical; selection and rendering remain owned by read.ts.
+ */
+export type ReadRoute = "local-bare-stream" | "local-bare-acp" | "archive-member-bare" | "local-range" | "local-multi-range" | "local-raw" | "local-summary" | "url-reader" | "url-cache-page" | "dir-local" | "dir-archive" | "sqlite-list" | "sqlite-rows" | "converted";
+/** Resolve the configured default for a route; explicit parameters bypass it. */
+export declare function pathDefault(route: ReadRoute, settings: Settings): TruncationDirection;
+/** Resolve the effective caller-facing direction with explicit precedence. */
+export declare function resolveEffectiveDirection(explicitParam: TruncationDirection | undefined, route: ReadRoute, settings: Settings): TruncationDirection;

package/dist/types/tools/read.d.ts

@@ -4,10 +4,49 @@ import * as z from "zod/v4";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { type Theme } from "../modes/theme/theme";
 import type { ToolSession } from "../sdk";
-import { type TruncationResult } from "../session/streaming-output";
+import type { ReadWindow, TruncationResult } from "../session/streaming-output";
 import { type OutputMeta } from "./output-meta";
+export declare function streamLinesFromFile(filePath: string, startLine: number, maxLinesToCollect: number, maxBytes: number, selectedLineLimit: number | null, signal?: AbortSignal, collect?: "head" | "tail" | "both", collectEndExclusive?: number | null): Promise<{
+    lines: string[];
+    totalFileLines: number;
+    collectedBytes: number;
+    stoppedByByteLimit: boolean;
+    firstLinePreview?: {
+        text: string;
+        bytes: number;
+    };
+    firstLineByteLength?: number;
+    selectedBytesTotal: number;
+    windowBytesTotal: number;
+    windowLinesTotal: number;
+    windowStartIndex: number;
+    tailPartial?: {
+        text: string;
+        bytes: number;
+        sourceIndex: number;
+        sourceLineBytes: number;
+    };
+    maxBytes: number;
+    headLines?: string[];
+    headBytes?: number;
+    headStartIndex?: number;
+    degenerateTailBudget: boolean;
+    degenerateHeadBudget: boolean;
+    headStoppedByBytes: boolean;
+    headStoppedByLines: boolean;
+    ringBudgetLines: number;
+    ringEvictedForBytes: boolean;
+    ringEvictedForLines: boolean;
+    tailDroppedForBytes: boolean;
+}>;
+export declare function streamResultWindow(result: Awaited<ReturnType<typeof streamLinesFromFile>>, collect: "tail" | "both", startLine: number, collectEndExclusive: number | null): ReadWindow;
 declare const readSchema: z.ZodObject<{
     path: z.ZodString;
+    truncation: z.ZodOptional<z.ZodEnum<{
+        both: "both";
+        head: "head";
+        last: "last";
+    }>>;
 }, z.core.$strict>;
 export type ReadToolInput = z.infer<typeof readSchema>;
 /** Project paths and output sizes without exposing read content or remote URLs. */
@@ -60,6 +99,11 @@ export declare class ReadTool implements AgentTool<typeof readSchema, ReadToolDe
     readonly description: string;
     readonly parameters: z.ZodObject<{
         path: z.ZodString;
+        truncation: z.ZodOptional<z.ZodEnum<{
+            both: "both";
+            head: "head";
+            last: "last";
+        }>>;
     }, z.core.$strict>;
     readonly nonAbortable = true;
     readonly strict = true;

package/dist/types/tools/resource-gc.d.ts

@@ -1,5 +1,6 @@
 import type { WindowsJobMemoryProbeResult } from "@gajae-code/natives";
 import type { Settings } from "../config/settings";
+import type { MemoryGuardWorkerSample } from "../runtime/memory-guard-contract";
 import { type TabGcSnapshot } from "./browser/tab-supervisor";
 export interface BrowserGcPolicy {
     enabled: boolean;
@@ -35,10 +36,13 @@ export interface ResourceGcDeps {
         removed: number;
     }>;
     screenshotArmed: () => boolean;
+    listTeamWorkers?: (cwd: string, sessionId: string) => Promise<MemoryGuardWorkerSample[]>;
+    applyTeamWorkerGuard?: (cwd: string, sessionId: string, workerId: string, excessBytes: number, incidentId: string) => Promise<void>;
 }
 export interface ResourceGcRegistration {
     sessionId: string;
     settings: Settings;
+    cwd?: string | (() => string);
 }
 /**
  * Register a session with the resource GC. Starts the single shared timer on the first

package/dist/types/tools/tool-result.d.ts

@@ -1,6 +1,6 @@
 import type { AgentToolResult } from "@gajae-code/agent-core";
 import type { ImageContent, TextContent } from "@gajae-code/ai";
-import type { OutputSummary, TruncationResult } from "../session/streaming-output";
+import type { OutputSummary, ReadWindow, TruncationResult } from "../session/streaming-output";
 import type { OutputMeta, TruncationOptions, TruncationSummaryOptions, TruncationTextOptions } from "./output-meta";
 type ToolContent = Array<TextContent | ImageContent>;
 type DetailsWithMeta = {
@@ -12,6 +12,12 @@ export declare class ToolResultBuilder<TDetails extends DetailsWithMeta> {
     text(text: string): this;
     content(content: ToolContent): this;
     truncation(result: TruncationResult, options: TruncationOptions): this;
+    truncationWindows(windows: ReadWindow, options?: {
+        artifactId?: string;
+        noticeOwner?: "body";
+        maxBytes?: number;
+        rangeBase?: "file" | "window";
+    }): this;
     truncationFromSummary(summary: OutputSummary, options: TruncationSummaryOptions): this;
     truncationFromText(text: string, options: TruncationTextOptions): this;
     limits(limits: {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.11.11",
+	"version": "0.12.0",
 	"description": "Gajae Code CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://gajae-code.com",
 	"author": "Yeachan-Heo and Gajae Code Contributors",
@@ -50,16 +50,16 @@
 		"check:sdk-closure": "bun ../../scripts/telegram-daemon-generation-guard.ts --validate-current-tree && bun test ../../scripts/telegram-daemon-generation-guard.test.ts && bun scripts/generate-sdk-operation-inventory.ts --check && bun scripts/generate-sdk-adapter-parity-manifest.ts --check && bun scripts/run-test-manifest.ts test/manifests/sdk-adapter-parity-v1.json && bun scripts/generate-telegram-baseline-manifest.ts --check && bun scripts/run-test-manifest.ts test/manifests/telegram-baseline-v1.json && bun test test/sdk-downgrade-rollback.test.ts test/sdk-downgrade-unknown-version.test.ts && bun scripts/verify-gjc-sdk-canonicalization.ts --self-test && bun scripts/verify-gjc-sdk-canonicalization.ts && bun scripts/verify-gjc-sdk-rename.ts"
 	},
 	"dependencies": {
-		"@agentclientprotocol/sdk": "1.2.1",
+		"@agentclientprotocol/sdk": "1.3.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.11.11",
-		"@gajae-code/agent-core": "0.11.11",
-		"@gajae-code/ai": "0.11.11",
-		"@gajae-code/bridge-client": "0.11.11",
-		"@gajae-code/natives": "0.11.11",
-		"@gajae-code/tui": "0.11.11",
-		"@gajae-code/utils": "0.11.11",
+		"@gajae-code/stats": "0.12.0",
+		"@gajae-code/agent-core": "0.12.0",
+		"@gajae-code/ai": "0.12.0",
+		"@gajae-code/bridge-client": "0.12.0",
+		"@gajae-code/natives": "0.12.0",
+		"@gajae-code/tui": "0.12.0",
+		"@gajae-code/utils": "0.12.0",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",
@@ -343,10 +343,6 @@
 			"types": "./dist/types/extensibility/custom-commands/bundled/ci-green/index.d.ts",
 			"import": "./src/extensibility/custom-commands/bundled/ci-green/index.ts"
 		},
-		"./extensibility/custom-commands/bundled/review": {
-			"types": "./dist/types/extensibility/custom-commands/bundled/review/index.d.ts",
-			"import": "./src/extensibility/custom-commands/bundled/review/index.ts"
-		},
 		"./extensibility/custom-tools": {
 			"types": "./dist/types/extensibility/custom-tools/index.d.ts",
 			"import": "./src/extensibility/custom-tools/index.ts"