@gajae-code/coding-agent 0.18.6 → 0.18.8

package/src/sdk/client/client.ts

@@ -100,6 +100,8 @@ export interface SdkClientOptions {
 
 export interface SdkRequestOptions {
 	timeoutMs?: number;
+	/** Absolute wall-clock deadline for this request, including connection setup. */
+	deadline?: number;
 	idempotencyKey?: string;
 	confirm?: boolean;
 	/**
@@ -496,6 +498,14 @@ export class SdkClient {
 			if (options.connectedOnly && error instanceof SdkClientError) throw new SdkPreparedDispatchError(error);
 			throw error;
 		}
+		const requestDeadline =
+			typeof options.deadline === "number" && Number.isFinite(options.deadline)
+				? Math.min(options.deadline, this.#deadline ?? Number.POSITIVE_INFINITY)
+				: this.#deadline;
+		if (requestDeadline !== undefined && Date.now() >= requestDeadline) {
+			const error = this.#deadlineError();
+			throw options.connectedOnly ? new SdkPreparedDispatchError(error) : error;
+		}
 		let incarnation: Incarnation;
 		if (options.connectedOnly) {
 			try {
@@ -504,8 +514,8 @@ export class SdkClient {
 				if (error instanceof SdkClientError) throw new SdkPreparedDispatchError(error);
 				throw error;
 			}
-		} else incarnation = await this.#connect();
-		const timeoutMs = this.#remainingTimeout(options.timeoutMs ?? this.#timeoutMs);
+		} else incarnation = await this.#connect(requestDeadline);
+		const timeoutMs = this.#remainingTimeout(options.timeoutMs ?? this.#timeoutMs, requestDeadline);
 		if (timeoutMs <= 0) {
 			const error = this.#deadlineError();
 			throw options.connectedOnly ? new SdkPreparedDispatchError(error) : error;
@@ -615,7 +625,7 @@ export class SdkClient {
 				);
 			return await deferred.promise;
 		}
-		if (this.#deadline !== undefined && Date.now() >= this.#deadline) {
+		if (requestDeadline !== undefined && Date.now() >= requestDeadline) {
 			const error = this.#deadlineError();
 			this.#settlePending(id, pending, options.connectedOnly ? new SdkPreparedDispatchError(error) : error);
 			return await deferred.promise;
@@ -686,17 +696,18 @@ export class SdkClient {
 		return transportError("timeout", "SDK client deadline elapsed.", undefined, reconnect);
 	}
 
-	#remainingTimeout(limit = this.#timeoutMs): number {
-		if (this.#deadline === undefined) return limit;
-		return Math.min(limit, Math.max(0, this.#deadline - Date.now()));
+	#remainingTimeout(limit = this.#timeoutMs, deadline = this.#deadline): number {
+		if (deadline === undefined) return limit;
+		return Math.min(limit, Math.max(0, deadline - Date.now()));
 	}
 
 	#throwIfDeadlineElapsed(): void {
 		if (this.#deadline !== undefined && Date.now() >= this.#deadline) throw this.#deadlineError();
 	}
 
-	async #connect(): Promise<Incarnation> {
+	async #connect(requestDeadline?: number): Promise<Incarnation> {
 		this.#throwIfDeadlineElapsed();
+		if (requestDeadline !== undefined && Date.now() >= requestDeadline) throw this.#deadlineError();
 		const current = this.#currentSocketRecord;
 		if (current && this.#isActive(current) && current.socket.readyState === WebSocket.OPEN) return current;
 		if (current)
@@ -708,7 +719,16 @@ export class SdkClient {
 			this.#opening = cycle;
 			cycle.promise = this.#openWithRetry(cycle);
 		}
-		return await cycle.promise!;
+		if (requestDeadline === undefined) return await cycle.promise!;
+		const remaining = requestDeadline - Date.now();
+		if (remaining <= 0) throw this.#deadlineError();
+		const expired = Promise.withResolvers<never>();
+		const timer = setTimeout(() => expired.reject(this.#deadlineError()), remaining);
+		try {
+			return await Promise.race([cycle.promise!, expired.promise]);
+		} finally {
+			clearTimeout(timer);
+		}
 	}
 
 	#requireConnectedIncarnation(): Incarnation {

package/src/sdk/host/host.ts

@@ -107,6 +107,12 @@ export const TOOL_ACTIVITY_CAPABILITY = "tool_activity_v2";
 export const TURN_STREAM_CAPABILITY = "turn_stream";
 /** Capability used by notification adapters that observe a host without owning its work. */
 export const SESSION_HOST_OBSERVER_CAPABILITY = "session_host_observer_v1";
+/**
+ * Opts notification adapters into positioned-only delivery for matching live
+ * effects: the host excludes a negotiating connection from the raw native leg
+ * of every frame its positioned envelope already reached.
+ */
+export const POSITIONED_NOTIFICATION_EFFECTS_CAPABILITY = "positioned_notification_effects_v1";
 export const CAP_GATED_FRAME_KINDS: ReadonlySet<string> = new Set(["tool_activity", "reasoning_summary"]);
 const EMPTY_CAPABILITIES: ReadonlySet<string> = new Set();
 

package/src/sdk/host/query/handlers.ts

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
+import type { ProjectProgressSnapshot } from "../../../progress/progress-contract.js";
 import { PROMPT_CLIENT_REF_MAX_LENGTH } from "../../prompt-status.js";
 import { TURN_RESULT_PROMPT_ALIAS, TURN_RESULT_SKILL_ALIAS } from "../../protocol/operation-registry.js";
-
 import type { ActiveProviderDescriptor } from "../../providers.js";
 import { ActiveProviderResolutionError } from "../../providers.js";
 
@@ -51,6 +51,8 @@ export interface SessionSurface {
 		| Promise<{ bytes: Uint8Array; totalBytes: number } | undefined>;
 
 	getJobs(): unknown | Promise<unknown>;
+	/** Q32 read-only project progress snapshot (`gjc.project_progress.v1`). */
+	getProjectProgress?(): ProjectProgressSnapshot | Promise<ProjectProgressSnapshot>;
 	/** Q26 keyed lookup of a submitted prompt's authoritative reconciliation status. */
 	getPromptStatus?(selector: { commandId?: string; turnId?: string; clientRef?: string }): unknown | Promise<unknown>;
 	getSkillInvokeStatus?(selector: {
@@ -152,6 +154,7 @@ const sources: Record<string, { resource: string; method: keyof SessionSurface;
 	Q25: { resource: "jobs", method: "getJobs", mvcc: false },
 	Q29: { resource: "activeProviders", method: "getActiveProviders", mvcc: false },
 	Q27: { resource: "modelProfiles", method: "getModelProfiles", mvcc: true },
+	Q32: { resource: "progress", method: "getProjectProgress", mvcc: false },
 };
 const names = [
 	"transcript.list",
@@ -186,6 +189,7 @@ const names = [
 	"providers.list/active",
 	"session.checkpoint",
 	"turn.steer_status",
+	"session.progress",
 ];
 
 export class QueryHandlers {
@@ -275,6 +279,10 @@ export class QueryHandlers {
 				);
 			if (query === "Q29" && typeof this.surface.getActiveProviders !== "function")
 				return this.#error(request, "unavailable", false, "providers.list/active is unavailable for this session.");
+			if (query === "Q32" && request.input && Object.keys(request.input).length > 0)
+				return this.#error(request, "invalid_request", false, "session.progress does not accept input fields.");
+			if (query === "Q32" && typeof this.surface.getProjectProgress !== "function")
+				return this.#error(request, "unavailable", false, "session.progress is unavailable for this session.");
 			const source = sources[query];
 			if (!source) return this.#error(request, "invalid_request");
 			return await this.#pageSource(request, query, source);