@gajae-code/coding-agent 0.17.4 → 0.17.5

package/dist/types/sdk/broker/managed-task-verification.d.ts

@@ -0,0 +1,37 @@
+import { type FinalizeChecks } from "../../harness-control-plane/finalize";
+import { type ManagedDomainBinding } from "./managed-task-dag";
+export type ManagedVerificationStatus = {
+    status: "running";
+    executionId: string;
+    started: false;
+} | {
+    status: "unknown";
+    executionId: string;
+    started: boolean;
+    reason?: string;
+} | {
+    status: "finished";
+    executionId: string;
+    started: false;
+    accepted: boolean;
+} | {
+    status: "accepted";
+    executionId: string;
+    started: boolean;
+    acceptedId: string;
+    acceptedHash: string;
+} | {
+    status: "failed";
+    executionId: string;
+    started: boolean;
+    reason: string;
+};
+export declare function markManagedVerificationUnknown(binding: ManagedDomainBinding, graphId: string, attemptId: string): Promise<void>;
+export declare function reconcileRunningManagedVerification(binding: ManagedDomainBinding): Promise<void>;
+export declare function verifyManagedTaskAttempt(input: {
+    binding: ManagedDomainBinding;
+    graphId: string;
+    nodeId: string;
+    owner: string;
+    runner?: FinalizeChecks;
+}): Promise<ManagedVerificationStatus>;

package/dist/types/sdk/broker/spawn-authority.d.ts

@@ -161,6 +161,8 @@ export type SpawnClaimDecision = {
 } | {
     kind: "idempotency_conflict";
     claim: SpawnClaimV2;
+} | {
+    kind: "managed_key_conflict";
 };
 type SpawnAuthorityDurableWrite = {
     claim: SpawnClaimV2;
@@ -190,6 +192,12 @@ export declare class SpawnAuthorityStore {
     claim(lifecycleIdentity: string): SpawnClaimV2 | undefined;
     authority(lifecycleIdentity: string): SpawnAuthorityV1 | undefined;
     open(): Promise<void>;
+    /**
+     * Durably reserves an ordinary session.spawn idempotency identity for one
+     * managed native identity. Multiple managed roots may share the alias, but an
+     * ordinary claim and a managed reservation can never both win.
+     */
+    reserveManagedKeyAliases(aliasIdentities: readonly string[], managedIdentity: string, controlRoot: string): Promise<boolean>;
     claimOrJoin(lifecycleIdentity: string, bindingMac: string | undefined, requestBindingMac?: string | undefined): Promise<SpawnClaimDecision>;
     /**
      * Fsyncs one allowlisted state edge. Callers cannot patch claims in place,

package/dist/types/sdk/broker/startup-failure.d.ts

@@ -1,6 +1,8 @@
 export interface BrokerStartupFailureMarker {
     version: 2;
     reason: string;
+    /** Validated manual lock cleanup command, stored separately when it cannot fit in `reason`. */
+    cleanupCommand?: string;
     exitCode: number | null;
     signal: string | null;
     writtenAt: number;
@@ -17,6 +19,8 @@ export interface BrokerStartupFailureMarker {
     incarnation: string;
 }
 export declare function brokerStartupFailurePath(agentDir: string): string;
+/** Whether validated compact cleanup guidance targets the exact lock path. */
+export declare function brokerStartupFailureCleanupTargetsLock(marker: BrokerStartupFailureMarker | undefined, lockPath: string): boolean;
 /**
  * Best-effort durable marker write; never throws (diagnostics must not mask the
  * exit itself). `pid` must be the writing broker process's own pid

package/dist/types/sdk/bus/telegram-daemon-contract.d.ts

@@ -287,8 +287,12 @@ export declare const SDK_LIFECYCLE_ROUTER_PROTOCOL_VERSION = 1;
  * replaced across this upgrade.
  * Generation 190 acknowledges the protected prompt-deadline boundary change,
  * so generation-189 owners are replaced instead of retaining the old path.
+ * Generation 192 makes session-host liveness a reference-counted work lease,
+ * so generation-191 owners cannot reap hosts with queued or promoted work.
+ * Generation 193 gates streamed content on negotiated observer capabilities,
+ * so existing owners are replaced before exposing the new observer path.
  */
-export declare const DAEMON_GENERATION = 192;
+export declare const DAEMON_GENERATION = 194;
 /**
  * Serving-compatibility boundary for daemon lifecycle requests. Epoch 7
  * requires durable publication receipts and acknowledged attachment dispatch,

package/dist/types/sdk/prompt-deadline-flush.d.ts

@@ -55,6 +55,8 @@ export interface PromptDeadlineFlushResult {
     worktreeRoot: string;
 }
 export interface PromptDeadlineFlushOptions {
+    /** Active session's agent directory, used to keep volatile broker state out of the WIP commit. */
+    readonly agentDir?: string;
     /**
      * Whether the caller resolved `sdk.flushWorktreeOnDeadline` to `true` from a
      * value the user actually wrote, rather than from the schema default. Only an

package/dist/types/sdk/session.d.ts

@@ -233,9 +233,9 @@ export interface CreateAgentSessionOptions {
     inheritedAsyncJobManager?: AsyncJobManager;
     /**
      * W6b: the parent's scope-held MCP facade, handed to a canonical sub-session so
-     * it can inherit always-on MCP tools without owning the manager. Replaces the
-     * removed `MCPManager.instance()` inheritance path; the sub-session never
-     * connects, registers callbacks, or disposes this manager.
+     * it can inherit MCP tools without owning the manager. Replaces the removed
+     * `MCPManager.instance()` inheritance path; the sub-session subscribes to catalog
+     * changes but never connects or disposes this manager.
      */
     inheritedMcpManager?: import("../runtime-mcp/manager").MCPManager;
     /** Session manager. Default: session stored under the configured agentDir sessions root */

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

@@ -792,8 +792,11 @@ export declare class AgentSession {
     } | undefined;
     /** Replace the session-owned MCP manager after a cwd rescope. */
     replaceOwnedMcpManager(next: MCPManager | undefined): Promise<void>;
-    /** Swap named custom/project tools after a cwd rescope. */
-    replaceNamedCustomTools(previousNames: readonly string[], nextTools: CustomTool[]): Promise<void>;
+    /** Swap named custom tools and their optional mandatory MCP selection. */
+    replaceNamedCustomTools(previousNames: readonly string[], nextTools: readonly CustomTool[], options?: {
+        mandatoryMCPToolNames?: readonly string[];
+        activateNewTools?: boolean;
+    }): Promise<void>;
     /** Best-effort accessor for the active skill's `current_phase` field from
      *  its persisted mode-state file. Used by the `skill` tool to enforce the
      *  terminal-phase chain guard. Returns undefined when no active skill is
@@ -1080,6 +1083,7 @@ export declare class AgentSession {
     refreshMCPTools(mcpTools: CustomTool[], options?: {
         selectedMCPToolNames?: string[];
         activeMCPToolNames?: string[];
+        mandatoryMCPToolNames?: string[];
         persistMCPSelection?: boolean;
     }): Promise<void>;
     /**
@@ -1583,6 +1587,7 @@ export declare class AgentSession {
         reason?: TemporaryModelReason;
         providerSessionScope?: TemporaryProviderSessionScope;
         signal?: AbortSignal;
+        onMutationStarted?: () => void;
     }): Promise<TemporaryProviderSessionScope | void>;
     /** Restore the exact live-model state captured before a failed selector transaction. */
     restoreModelSelectionForRollback(model: Model | undefined, thinkingLevel: ThinkingLevel | undefined): Promise<void>;

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

@@ -514,6 +514,8 @@ export interface AgentProgress {
     }>;
     recentOutput: string[];
     toolCount: number;
+    /** Epoch ms of the latest event observed from this subagent (any agent event). */
+    lastActivityMs?: number;
     /** Cumulative input + output + cacheWrite tokens across all turns. Excludes cacheRead (re-reads cached context every turn, making cumulative sum misleading). */
     tokens: number;
     /**

package/dist/types/tools/bash-interactive.d.ts

@@ -30,6 +30,7 @@ export declare function runInteractiveBashPty(ui: NonNullable<AgentToolContext["
     timeoutMs: number;
     signal?: AbortSignal;
     env?: Record<string, string>;
+    unsetEnv?: string[];
     artifactPath?: string;
     artifactId?: string;
     artifactPublisher?: TerminalArtifactPublisher;

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

@@ -4,8 +4,9 @@ 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 { AgentStorage } from "../session/agent-storage";
 import { type TruncationDirection } from "../session/streaming-output";
-import type { RenderResult } from "../web/scrapers/types";
+import { type RenderResult } from "../web/scrapers/types";
 import { type OutputMeta } from "./output-meta";
 export declare function isReadableUrlPath(value: string): boolean;
 export interface ParsedReadUrlTarget {
@@ -27,6 +28,14 @@ interface FetchImagePayload {
 type FetchRenderResult = RenderResult & {
     image?: FetchImagePayload;
 };
+/**
+ * Try all special handlers
+ */
+declare function handleSpecialUrls(url: string, timeout: number, signal: AbortSignal | undefined, storage: AgentStorage | null): Promise<FetchRenderResult | null>;
+/** Test-only seam for verifying lazy special-handler loading and dispatch. */
+export declare const fetchSpecialHandlerTestHooks: {
+    dispatch: typeof handleSpecialUrls;
+};
 export declare function tryInsaneFallback(args: {
     url: string;
     finalUrl: string;

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

@@ -80,6 +80,10 @@ export interface SubagentLiveProgress {
     recentOutputSummary?: {
         lineCount: number;
     };
+    toolCount?: number;
+    contextTokens?: number;
+    contextWindow?: number;
+    lastActivityMs?: number;
     fastMode?: boolean;
     retryState?: {
         attempt: number;
@@ -165,10 +169,13 @@ export declare function capCodePointsAndBytes(text: string, maxCodePoints: numbe
  * unsafe.
  *
  * Time-derived fields are intentionally excluded so the panel does not churn while
- * idle: raw durations (`durationMs`), current-tool elapsed (`currentToolStartMs`),
+ * idle (the child's last-event timestamp is included; it moves only on real
+ * activity): raw durations (`durationMs`), current-tool elapsed (`currentToolStartMs`),
  * and retry countdowns (`retryState.startedAtMs`) are omitted. Idle duration and
  * countdown ticking is sacrificed by design; every real transition still changes
  * the signature.
  */
+/** Shared cadence for await progress refreshes and rendered last-activity age. */
+export declare const SUBAGENT_ACTIVITY_BUCKET_MS = 5000;
 export declare function subagentAwaitRenderedStateSignature(subagents: readonly SubagentSnapshot[], receipt?: Pick<SubagentToolDetails, "awaitOutcome" | "interrupted">): string;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.17.4",
+	"version": "0.17.5",
 	"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",
@@ -57,12 +57,12 @@
 		"@agentclientprotocol/sdk": "1.3.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.17.4",
-		"@gajae-code/agent-core": "0.17.4",
-		"@gajae-code/ai": "0.17.4",
-		"@gajae-code/natives": "0.17.4",
-		"@gajae-code/tui": "0.17.4",
-		"@gajae-code/utils": "0.17.4",
+		"@gajae-code/stats": "0.17.5",
+		"@gajae-code/agent-core": "0.17.5",
+		"@gajae-code/ai": "0.17.5",
+		"@gajae-code/natives": "0.17.5",
+		"@gajae-code/tui": "0.17.5",
+		"@gajae-code/utils": "0.17.5",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/cli/public-command-registry.ts

@@ -82,6 +82,9 @@ const argument = (description: string, extra: Partial<PublicArgumentDescriptor>
 });
 const agentDir = stringFlag("SDK broker/state directory (default: the configured agent directory).");
 const repo = stringFlag("Workspace directory for scope or saved-session resolution (default: current directory).");
+const exactSessionRepo = stringFlag(
+	"Accepted for compatibility only; ignored because the exact session ID selects the broker target.",
+);
 const timeout = positive("Request or live-follow timeout in milliseconds; send uses this for its --wait window.");
 const idempotency = stringFlag(
 	"Caller idempotency key; retain it when reconciling an uncertain mutation, never blindly replay.",
@@ -275,6 +278,7 @@ export const PUBLIC_COMMANDS: readonly PublicCommandDescriptor[] = [
 	node("sdk session", {
 		description: "Manage broker-bound credential-free sessions.",
 		children: ["list", "inspect", "send", "status", "tail", "retire", "raw"],
+		flags: sessionFlags,
 		syntax: "<command>",
 	}),
 	node("sdk session list", {
@@ -294,7 +298,7 @@ export const PUBLIC_COMMANDS: readonly PublicCommandDescriptor[] = [
 	node("sdk session inspect", {
 		description: "Inspect a session without exposing endpoint credentials.",
 		args: sessionArg,
-		flags: sessionFlags,
+		flags: { ...sessionFlags, repo: exactSessionRepo },
 		syntax: "<sessionId>",
 	}),
 	node("sdk session send", {
@@ -302,6 +306,7 @@ export const PUBLIC_COMMANDS: readonly PublicCommandDescriptor[] = [
 		args: sessionArg,
 		flags: {
 			...sessionFlags,
+			repo: exactSessionRepo,
 			...jsonInput,
 			text: stringFlag("Prompt text, alternative to nonempty JSON input."),
 			"op-ref": stringFlag(
@@ -324,7 +329,7 @@ export const PUBLIC_COMMANDS: readonly PublicCommandDescriptor[] = [
 	node("sdk session status", {
 		description: "Read the durable prompt result for a known operation reference.",
 		args: { ...sessionArg, opRef: argument("Exact operation reference returned or supplied by send.") },
-		flags: { ...sessionFlags, "timeout-ms": timeout },
+		flags: { ...sessionFlags, repo: exactSessionRepo, "timeout-ms": timeout },
 		syntax: "<sessionId> <opRef>",
 	}),
 	node("sdk session tail", {
@@ -392,6 +397,7 @@ export const PUBLIC_COMMANDS: readonly PublicCommandDescriptor[] = [
 		operationKind: "query",
 		flags: {
 			...sessionFlags,
+			repo: exactSessionRepo,
 			...jsonInput,
 			query: stringFlag("Query ID (including registered query aliases).", { required: true }),
 			cursor: stringFlag("Raw query continuation cursor."),

package/src/cli/setup-cli.ts

@@ -935,6 +935,7 @@ ${chalk.bold("Provider example:")}
   ${APP_NAME} setup provider --preset glm
   ${APP_NAME} setup provider --preset cline-pass
   ${APP_NAME} setup provider --preset commandcode-goat
+  ${APP_NAME} setup provider --preset ionet
   ${APP_NAME} setup provider --preset litellm --base-url https://litellm.example.com/v1
   ${APP_NAME} setup provider --preset openai-compatible-proxy --base-url https://gateway.example.com/v1
   MY_PROVIDER_KEY=sk-... ${APP_NAME} setup provider --compat openai --provider my-oai --base-url https://api.example.com/v1 --api-key-env MY_PROVIDER_KEY --model gpt-example

package/src/cli/stats-cli.ts

@@ -168,7 +168,7 @@ export async function runStatsCommand(cmd: StatsCommandArgs): Promise<void> {
 async function printStatsSummary(): Promise<void> {
 	const { getDashboardStats } = await import("@gajae-code/stats");
 	const stats = await getDashboardStats();
-	const { overall, byModel, byFolder } = stats;
+	const { overall, byModel, byFolder, byAgent } = stats;
 
 	console.log(chalk.bold("\n=== AI Usage Statistics ===\n"));
 
@@ -196,6 +196,15 @@ async function printStatsSummary(): Promise<void> {
 		}
 	}
 
+	if (byAgent.length > 0) {
+		console.log(chalk.bold("\nBy Agent Role:"));
+		for (const agent of byAgent) {
+			console.log(
+				`  ${agent.agent}: ${formatNumber(agent.totalRequests)} reqs, ${formatNumber(agent.totalInputTokens)} input / ${formatNumber(agent.totalOutputTokens)} output, ${formatPercent(agent.cacheRate)} cache, ${formatCost(agent.totalCost)}`,
+			);
+		}
+	}
+
 	if (byFolder.length > 0) {
 		console.log(chalk.bold("\nBy Folder:"));
 		for (const f of byFolder.slice(0, 10)) {
@@ -231,6 +240,7 @@ ${chalk.bold("Examples:")}
 ${chalk.bold("Metrics:")}
   - Total requests and error rate
   - Token usage (input, output, cache)
+  - Role usage (default, executor, planner, architect, critic)
   - Cost breakdown
   - Average duration and time to first token (TTFT)
   - Tokens per second throughput