@gajae-code/coding-agent 0.11.10 → 0.12.0

package/dist/types/task/types.d.ts

@@ -45,6 +45,10 @@ export declare const taskItemSchema: z.ZodObject<{
     id: z.ZodString;
     description: z.ZodString;
     assignment: z.ZodString;
+    executionMode: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        "ultragoal-red-team": "ultragoal-red-team";
+    }>>;
     inheritContext: z.ZodOptional<z.ZodEnum<{
         bounded: "bounded";
         full: "full";
@@ -69,6 +73,10 @@ export declare const taskSchema: z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "ultragoal-red-team": "ultragoal-red-team";
+        }>>;
         inheritContext: z.ZodOptional<z.ZodEnum<{
             bounded: "bounded";
             full: "full";
@@ -100,6 +108,10 @@ export declare const taskSchemaNoIsolation: z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "ultragoal-red-team": "ultragoal-red-team";
+        }>>;
         inheritContext: z.ZodOptional<z.ZodEnum<{
             bounded: "bounded";
             full: "full";
@@ -131,6 +143,10 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "ultragoal-red-team": "ultragoal-red-team";
+        }>>;
         inheritContext: z.ZodOptional<z.ZodEnum<{
             bounded: "bounded";
             full: "full";
@@ -161,6 +177,10 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "ultragoal-red-team": "ultragoal-red-team";
+        }>>;
         inheritContext: z.ZodOptional<z.ZodEnum<{
             bounded: "bounded";
             full: "full";
@@ -191,6 +211,10 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "ultragoal-red-team": "ultragoal-red-team";
+        }>>;
         inheritContext: z.ZodOptional<z.ZodEnum<{
             bounded: "bounded";
             full: "full";
@@ -221,6 +245,10 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "ultragoal-red-team": "ultragoal-red-team";
+        }>>;
         inheritContext: z.ZodOptional<z.ZodEnum<{
             bounded: "bounded";
             full: "full";
@@ -251,6 +279,10 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "ultragoal-red-team": "ultragoal-red-team";
+        }>>;
         inheritContext: z.ZodOptional<z.ZodEnum<{
             bounded: "bounded";
             full: "full";
@@ -281,6 +313,10 @@ declare const ALL_TASK_SCHEMAS: readonly [z.ZodObject<{
         id: z.ZodString;
         description: z.ZodString;
         assignment: z.ZodString;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            "ultragoal-red-team": "ultragoal-red-team";
+        }>>;
         inheritContext: z.ZodOptional<z.ZodEnum<{
             bounded: "bounded";
             full: "full";

package/dist/types/task/ultragoal-redteam-activation.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Decide whether an executor assignment should inject the ultragoal red-team
+ * prompt fragment.
+ *
+ * Preference order (parse, don't re-validate later):
+ * 1. Explicit typed `executionMode` on the task / ExecutorOptions — authoritative.
+ * 2. Assignment text heuristics — only explicit Ultragoal QA/red-team phrasing.
+ *
+ * Bare mentions of `executorQa` (docs, quality-gate field names, negative
+ * instructions) must not flip the mode (#2698 / #2456).
+ *
+ * Mirrors `executor.md`:
+ * "activates only when the assignment explicitly labels Executor as Ultragoal
+ * completion QA/red-team or asks for `executorQa` red-team evidence."
+ */
+export declare const EXECUTOR_EXECUTION_MODES: readonly ["default", "ultragoal-red-team"];
+export type ExecutorExecutionMode = (typeof EXECUTOR_EXECUTION_MODES)[number];
+export declare function isExecutorExecutionMode(value: unknown): value is ExecutorExecutionMode;
+/**
+ * Parse a caller-supplied mode. Unknown values fail closed to `undefined`
+ * so the assignment heuristic (or default off) still applies — never invent on.
+ */
+export declare function parseExecutorExecutionMode(value: unknown): ExecutorExecutionMode | undefined;
+export declare function assignmentRequestsUltragoalRedTeam(assignment: string | undefined): boolean;
+export interface ResolveUltragoalRedTeamArgs {
+    readonly executionMode?: unknown;
+    readonly assignment?: string;
+}
+/**
+ * Final activation decision for the executor prompt fragment.
+ * Typed mode wins; assignment text is a compatibility fallback only.
+ */
+export declare function resolveUltragoalRedTeamActivation(args: ResolveUltragoalRedTeamArgs): 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,4 +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;
@@ -16,7 +18,10 @@ export declare function resolveSweepIntervalMs(settings: Settings): number;
 /** Injectable seams so the controller is fully testable without real browsers/filesystem/RSS. */
 export interface ResourceGcDeps {
     now: () => number;
+    monotonicNow: () => number;
     rssBytes: () => number;
+    memorySnapshot: () => Promise<MemoryPressureSnapshot>;
+    runGc: () => void;
     logWarn: (msg: string, meta?: Record<string, unknown>) => void;
     listTabs: () => TabGcSnapshot[];
     releaseTab: (name: string, policy: {
@@ -31,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
@@ -43,6 +51,21 @@ export interface ResourceGcRegistration {
  */
 export declare function registerResourceGcSession(reg: ResourceGcRegistration): () => void;
 export declare function sweepOnce(d?: ResourceGcDeps): Promise<void>;
+export interface MemoryPressureDomain {
+    hardCapBytes: number;
+    totalUsageBytes: number;
+    source: MemoryPressureSnapshot["source"];
+}
+export interface MemoryPressureSnapshot {
+    hardCapBytes: number;
+    totalUsageBytes: number;
+    parentBytes: number;
+    source: "host" | "linux_cgroup_v2" | "linux_cgroup_v1" | "windows_job" | "windows_process_job_limit";
+    domains?: MemoryPressureDomain[];
+}
+export declare function __sampleLinuxCgroupHierarchyForTest(mountInfo: string, membership: string, fsType: "cgroup" | "cgroup2", hostBytes: number, parentBytes: number): Promise<MemoryPressureSnapshot | null>;
+export declare function __sampleWindowsJobMemoryForTest(hostBytes: number, parentBytes: number, probeResult?: WindowsJobMemoryProbeResult): MemoryPressureSnapshot | null;
+export declare function __selectMemoryPressureDomainForTest(snapshot: MemoryPressureSnapshot, policyLimitBytes: number | null): MemoryPressureSnapshot;
 export declare function __setResourceGcDepsForTest(overrides: Partial<ResourceGcDeps>): void;
 export declare function __setResourceGcSchedulerNowForTest(now: () => number): void;
 export declare function __runResourceGcTickForTest(): Promise<void>;

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.10",
+	"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.10",
-		"@gajae-code/agent-core": "0.11.10",
-		"@gajae-code/ai": "0.11.10",
-		"@gajae-code/bridge-client": "0.11.10",
-		"@gajae-code/natives": "0.11.10",
-		"@gajae-code/tui": "0.11.10",
-		"@gajae-code/utils": "0.11.10",
+		"@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"