@gajae-code/coding-agent 0.16.0 → 0.16.3

package/src/sdk/host/surface-policy.ts

@@ -34,7 +34,7 @@ const CONTROL_BINDINGS: Readonly<Record<string, string | undefined>> = {
 	"thinking.cycle": "cycleThinkingLevel",
 	"queue.steering_mode.set": "setQueueMode",
 	"queue.follow_up_mode.set": "setQueueMode",
-	"queue.interrupt_mode.set": "setQueueMode",
+	"queue.tool_interrupt_policy.set": "setQueueMode",
 	"todo.replace": "sdkControl",
 	"permission_mode.set": "sdkControl",
 	"skill.invoke": "invokeSkill",
@@ -62,8 +62,8 @@ const CONTROL_BINDINGS: Readonly<Record<string, string | undefined>> = {
 // Resource queries (`artifact.read`, `runtime.jobs.list`) remain dispatchable when their
 // backing session resource is absent so their handlers can return `resource_gone`.
 // `session.checkpoint` (Q30) is likewise unconditionally installed: it is an SDK-native
-// replay authority that degrades to the live transcript head when the host publishes no
-// durable checkpoint, so it must never be hidden behind a binding gate.
+// replay authority whose handler returns explicit `unavailable` when the host cannot
+// provide one atomic transcript/ring/idle capture, so it must never be hidden behind a binding gate.
 const QUERY_BINDINGS: Readonly<Record<string, string | undefined>> = {
 	"skill.list/state": "getSkillState",
 	"config.list/get": "getConfigItems",

package/src/sdk/lifecycle-session.ts

@@ -1,5 +1,5 @@
 import { parseModelString } from "../config/model-resolver";
-import type { AgentSession } from "../session/agent-session";
+import { type AgentSession, isSessionDisposalIncompleteError } from "../session/agent-session";
 import { type CreateAgentSessionOptions, createAgentSession } from "./session";
 import {
 	lifecycleMcpStartupTimeoutOption,
@@ -106,7 +106,12 @@ export async function createLifecycleAgentSession(
 			const expected = parseModelString(modelId);
 			const expectedSelector = expected ? `${expected.provider}/${expected.id}` : modelId;
 			if (!activeSelector || activeSelector.toLowerCase() !== expectedSelector.toLowerCase()) {
-				await result.session.dispose().catch(() => {});
+				try {
+					await result.session.dispose();
+				} catch (error) {
+					if (!isSessionDisposalIncompleteError(error)) throw error;
+					await result.session.awaitDisposeCompletion();
+				}
 				throw new Error(
 					`Model "${modelId}" not found. Use --list-models to see available models.${
 						activeSelector ? ` Session resolved ${activeSelector} instead.` : ""

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

@@ -7,6 +7,7 @@ import {
 	promptDeadlineAt,
 	recordAttributableProgress,
 } from "./prompt-deadline-lease";
+import type { SdkPromptTerminalOutcome } from "./prompt-status";
 import type { TurnResultContent } from "./turn-result";
 
 const MAX_EXPIRY_RETRIES = 5;
@@ -26,7 +27,7 @@ export type PromptDeadlineOutcome = {
 export interface PromptTerminalTransitionEvidence {
 	content?: TurnResultContent;
 	hasActivity?: boolean;
-	outcome?: { kind: "stopped"; reason: "cancelled"; provenance: "client_cancel" };
+	outcome?: SdkPromptTerminalOutcome;
 }
 
 function leaseKey(correlation: InvocationCorrelation): string {

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

@@ -346,7 +346,7 @@
 		"sourceFile": "packages/coding-agent/src/sdk/protocol/operation-registry.ts",
 		"sourceKind": "registry",
 		"decision": "include",
-		"sdkId": "queue.interrupt_mode.set",
+		"sdkId": "queue.tool_interrupt_policy.set",
 		"adapterMappings": {
 			"telegram": "generic_safe",
 			"discord": "generic_safe",
@@ -2315,6 +2315,28 @@
 			"testIds": "not_applicable"
 		}
 	},
+	{
+		"sourceId": "slash_command:star",
+		"sourceFile": "packages/coding-agent/src/slash-commands/builtin-registry.ts",
+		"sourceKind": "slash_command",
+		"decision": "exclude",
+		"rationale": "local transcript-discovery metadata command; no SDK operation counterpart or runtime/retention authority",
+		"exclusionMetadata": {
+			"adapterMappings": "not_applicable",
+			"testIds": "not_applicable"
+		}
+	},
+	{
+		"sourceId": "slash_command:unstar",
+		"sourceFile": "packages/coding-agent/src/slash-commands/builtin-registry.ts",
+		"sourceKind": "slash_command",
+		"decision": "exclude",
+		"rationale": "local transcript-discovery metadata command; no SDK operation counterpart or runtime/retention authority",
+		"exclusionMetadata": {
+			"adapterMappings": "not_applicable",
+			"testIds": "not_applicable"
+		}
+	},
 	{
 		"sourceId": "slash_command:resume",
 		"sourceFile": "packages/coding-agent/src/slash-commands/builtin-registry.ts",
@@ -3038,6 +3060,17 @@
 			"testIds": "not_applicable"
 		}
 	},
+	{
+		"sourceId": "agent_session:onJobFold",
+		"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
+		"sourceKind": "agent_session",
+		"decision": "exclude",
+		"rationale": "internal fold-event plumbing feeding the bash_folded event frame, not a control seam",
+		"exclusionMetadata": {
+			"adapterMappings": "not_applicable",
+			"testIds": "not_applicable"
+		}
+	},
 	{
 		"sourceId": "agent_session:requestForegroundBashBackground",
 		"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
@@ -3049,6 +3082,24 @@
 			"testIds": "not_applicable"
 		}
 	},
+	{
+		"sourceId": "agent_session:requestForegroundBashBackgroundOutcome",
+		"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
+		"sourceKind": "agent_session",
+		"decision": "include",
+		"sdkId": "bash.background",
+		"adapterMappings": {
+			"telegram": "prohibited",
+			"discord": "prohibited",
+			"slack": "prohibited",
+			"mcp": "generic_safe",
+			"acp": "generic_safe",
+			"daemonCli": "generic_safe"
+		},
+		"testIds": [
+			"packages/coding-agent/test/sdk-operation-inventory.test.ts"
+		]
+	},
 	{
 		"sourceId": "agent_session:getAllToolNames",
 		"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
@@ -4732,11 +4783,11 @@
 		]
 	},
 	{
-		"sourceId": "agent_session:setInterruptMode",
+		"sourceId": "agent_session:setToolInterruptPolicy",
 		"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
 		"sourceKind": "agent_session",
 		"decision": "include",
-		"sdkId": "queue.interrupt_mode.set",
+		"sdkId": "queue.tool_interrupt_policy.set",
 		"adapterMappings": {
 			"telegram": "generic_safe",
 			"discord": "generic_safe",

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

@@ -91,7 +91,7 @@ const controls = [
 	["permission_mode.set", "Set permission mode."],
 	["queue.steering_mode.set", "Set steering queue mode."],
 	["queue.follow_up_mode.set", "Set follow-up queue mode."],
-	["queue.interrupt_mode.set", "Set interrupt queue mode."],
+	["queue.tool_interrupt_policy.set", "Set whether a steer aborts or finishes in-flight tools."],
 	["compaction.run", "Run context compaction."],
 	["compaction.auto.set", "Set automatic compaction."],
 	["retry.auto.set", "Set automatic retry."],

package/src/sdk/receipt-state.ts

@@ -25,6 +25,16 @@ export function receiptStateForTerminal(source: ReceiptSource): Extract<ReceiptS
 	return reportableReceipt(source) ? "present" : "missing";
 }
 
+/** Terminal receipt evidence is monotonic: present > missing > unknown. */
+export function reduceReceiptState(
+	existing: Exclude<ReceiptState, "absent"> | undefined,
+	incoming: Exclude<ReceiptState, "absent"> | undefined,
+): Exclude<ReceiptState, "absent"> | undefined {
+	if (existing === "present" || incoming === "present") return "present";
+	if (existing === "missing" || incoming === "missing") return "missing";
+	return existing ?? incoming;
+}
+
 export function reduceTerminalReceiptState(input: TerminalReceiptInput): TerminalReceiptState {
 	switch (input.execution) {
 		case "accepted":