@gajae-code/coding-agent 0.15.4 → 0.15.6

package/src/sdk/prompt-deadline-manager.ts

@@ -7,6 +7,7 @@ import {
 	promptDeadlineAt,
 	recordAttributableProgress,
 } from "./prompt-deadline-lease";
+import type { TurnResultContent } from "./turn-result";
 
 const MAX_EXPIRY_RETRIES = 5;
 const MAX_UNCERTAINTY_RETRIES = 3;
@@ -22,6 +23,12 @@ export type PromptDeadlineOutcome = {
 	provenance: "deadline";
 };
 
+export interface PromptTerminalTransitionEvidence {
+	content?: TurnResultContent;
+	hasActivity?: boolean;
+	outcome?: { kind: "stopped"; reason: "cancelled"; provenance: "client_cancel" };
+}
+
 function leaseKey(correlation: InvocationCorrelation): string {
 	return `${correlation.commandId}:${correlation.turnId}`;
 }
@@ -37,6 +44,7 @@ export class PromptDeadlineManager {
 	readonly #expiring = new Set<string>();
 	readonly #pendingTerminalTransitions = new Set<string>();
 	readonly #pendingTerminalFailureReasons = new Map<string, { code: string; message: string }>();
+	readonly #pendingTerminalEvidence = new Map<string, PromptTerminalTransitionEvidence>();
 	readonly #getLeaseMs: () => number;
 	readonly #getMaxMs: () => number;
 	readonly #now: () => number;
@@ -102,7 +110,10 @@ export class PromptDeadlineManager {
 						error: Object.assign(new Error(failureReason.message), { code: failureReason.code }),
 					} as never);
 				}
-				await this.#reconciliation.noteTransition("prompt", correlation, { type: "agent_end" });
+				await this.#reconciliation.noteTransition("prompt", correlation, {
+					type: "agent_end",
+					...this.#pendingTerminalEvidence.get(key),
+				});
 				// Supersession check before retiring ownership (exact-head review P1):
 				// attributable progress during the awaited writes renews the lease
 				// past its deadline, so this replay instance must back off and
@@ -367,6 +378,7 @@ export class PromptDeadlineManager {
 	noteTerminalTransition(
 		correlation: InvocationCorrelation,
 		pendingFailure?: { code: string; message: string },
+		evidence?: PromptTerminalTransitionEvidence,
 	): void {
 		const key = leaseKey(correlation);
 		if (!this.#leases.has(key)) {
@@ -377,6 +389,7 @@ export class PromptDeadlineManager {
 			this.onAccepted(correlation);
 		}
 		this.#pendingTerminalTransitions.add(key);
+		if (evidence !== undefined) this.#pendingTerminalEvidence.set(key, evidence);
 		// Compound failure-plus-terminal recovery intent (exact-head review HIGH):
 		// when expiry replays this real terminal transition after a failed write, it
 		// must re-record the failure reason BEFORE agent_end, or the abandoned or
@@ -395,6 +408,7 @@ export class PromptDeadlineManager {
 		this.#expiring.delete(key);
 		this.#pendingTerminalTransitions.delete(key);
 		this.#pendingTerminalFailureReasons.delete(key);
+		this.#pendingTerminalEvidence.delete(key);
 	}
 
 	clearAll(): void {
@@ -407,6 +421,7 @@ export class PromptDeadlineManager {
 		this.#expiring.clear();
 		this.#pendingTerminalTransitions.clear();
 		this.#pendingTerminalFailureReasons.clear();
+		this.#pendingTerminalEvidence.clear();
 	}
 
 	/** For tests: current deadline or undefined if no lease. */

package/src/sdk/protocol/adapter-validation.ts

@@ -28,8 +28,35 @@ export type AdapterValidationError = {
 	message: string;
 };
 
+const PROMPT_OPERATIONS = new Set(["turn.prompt", "turn.steer", "turn.follow_up", "turn.abort_and_prompt"]);
+
+function hasUsablePromptImage(value: unknown): boolean {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const image = value as Record<string, unknown>;
+	return (
+		typeof image.data === "string" &&
+		image.data.trim().length > 0 &&
+		(image.mimeType === undefined || (typeof image.mimeType === "string" && image.mimeType.length > 0))
+	);
+}
+
+/** Rejects instruction-bearing controls before correlation or provider work. */
+export function validateRequiredPromptText(operation: string, input: Input): AdapterValidationError | undefined {
+	const hasUsableImage =
+		operation === "turn.prompt" && Array.isArray(input.images) && input.images.some(hasUsablePromptImage);
+	if (
+		PROMPT_OPERATIONS.has(operation) &&
+		(typeof input.text !== "string" || (input.text.trim().length === 0 && !hasUsableImage))
+	) {
+		return { code: "invalid_input", message: "Prompt must not be empty." };
+	}
+	return undefined;
+}
+
 /** Validates controls that adapters must reject before forwarding them to a host. */
 export function validateAdapterControl(operation: string, input: Input): AdapterValidationError | undefined {
+	const promptError = validateRequiredPromptText(operation, input);
+	if (promptError) return promptError;
 	if (operation === "runtime.reload") {
 		if (
 			!Array.isArray(input.components) ||

package/src/sdk/protocol/operation-inventory.generated.json

@@ -2937,7 +2937,7 @@
 		}
 	},
 	{
-		"sourceId": "agent_session:registerForegroundBashBackgroundRequestHandler",
+		"sourceId": "agent_session:registerForegroundFoldParticipant",
 		"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
 		"sourceKind": "agent_session",
 		"decision": "exclude",
@@ -2992,7 +2992,7 @@
 		"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
 		"sourceKind": "agent_session",
 		"decision": "exclude",
-		"rationale": "internal accessor/plumbing, not a user-facing control seam",
+		"rationale": "internal accessor/plumbing, not a user-facing SDK control seam",
 		"exclusionMetadata": {
 			"adapterMappings": "not_applicable",
 			"testIds": "not_applicable"

package/src/sdk/protocol/operation-registry.ts

@@ -165,7 +165,10 @@ const queries = [
 	["artifact.read", "Read a bounded artifact range."],
 	["runtime.jobs.list", "List managed jobs."],
 	["turn.result", "Read the authoritative durable result of a submitted turn by command/turn IDs or clientRef."],
-	["models.profiles.list", "List the effective built-in and configured model profiles for this session."],
+	[
+		"models.profiles.list",
+		"List the effective embedded, signed-registry, and configured model profiles for this session.",
+	],
 	["providers.list/active", "List active providers."],
 	["session.checkpoint", "Resolve a durable transcript checkpoint into a connection-owned replay cursor."],
 	["turn.steer_status", "Read the durable acknowledgement status of a correlated steer by clientRef."],