@gajae-code/coding-agent 0.13.3 → 0.14.0

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

@@ -6,6 +6,10 @@ export type OperationKind = "control" | "global" | "query" | "reverse";
 export type Idempotency = "idempotent" | "ordered" | "fast_lane";
 export type QueryContinuityClass = "stable_prefix" | "retained_revision" | "scalar_snapshot" | "content_addressed";
 
+/** Legacy kind-specific selectors for canonical Q26 `turn.result`. */
+export const TURN_RESULT_PROMPT_ALIAS = "turn.prompt_status";
+export const TURN_RESULT_SKILL_ALIAS = "skill.invoke_status";
+
 export interface Operation {
 	id: string;
 	sdkId: string;
@@ -15,13 +19,17 @@ export interface Operation {
 	errorCodes: string[];
 	revisionResource?: string;
 	continuityClass?: QueryContinuityClass;
+	/** Non-canonical request IDs that resolve to this operation's contract. */
+	aliases?: readonly string[];
 
 	adapterDispositions: Record<Adapter, AdapterDisposition>;
 	testIds: string[];
 }
 
 export function findOperation(kind: OperationKind, sdkId: string): Operation | undefined {
-	return OPERATIONS.find(operation => operation.kind === kind && operation.sdkId === sdkId);
+	return OPERATIONS.find(
+		operation => operation.kind === kind && (operation.sdkId === sdkId || operation.aliases?.includes(sdkId)),
+	);
 }
 
 export function adapterDispositionError(
@@ -157,12 +165,55 @@ const queries = [
 	["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."],
-	["skill.invoke_status", "Legacy alias for the authoritative turn result query."],
-
 	["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."],
+] as const;
+
+// Q28 was folded into Q26; preserve the independent Q29/Q30 query identities.
+const queryIds = [
+	"Q01",
+	"Q02",
+	"Q03",
+	"Q04",
+	"Q05",
+	"Q06",
+	"Q07",
+	"Q08",
+	"Q09",
+	"Q10",
+	"Q11",
+	"Q12",
+	"Q13",
+	"Q14",
+	"Q15",
+	"Q16",
+	"Q17",
+	"Q18",
+	"Q19",
+	"Q20",
+	"Q21",
+	"Q22",
+	"Q23",
+	"Q24",
+	"Q25",
+	"Q26",
+	"Q27",
+	"Q29",
+	"Q30",
+	"Q31",
 ] as const;
 
+function queryId(index: number): string {
+	const id = queryIds[index];
+	if (!id) throw new Error("Query registry IDs are out of sync with query definitions.");
+	return id;
+}
+
+const queryAliases: Readonly<Record<string, readonly string[]>> = {
+	Q26: [TURN_RESULT_PROMPT_ALIAS, TURN_RESULT_SKILL_ALIAS],
+};
+
 const reverse = [
 	["terminal.create/output/release/wait", "Direct terminal lifecycle requests."],
 	["filesystem.read/write", "Direct filesystem read and write requests."],
@@ -173,8 +224,16 @@ const reverse = [
 ] as const;
 
 function controlDisposition(id: string): Record<Adapter, AdapterDisposition> {
-	if (["C25", "C26", "C52"].includes(id))
-		return dispositions({ telegram: "prohibited", discord: "prohibited", slack: "prohibited" });
+	if (["C25", "C26", "C27", "C28", "C29", "C30", "C31", "C32", "C34", "C48"].includes(id))
+		return dispositions({
+			telegram: "prohibited",
+			discord: "prohibited",
+			slack: "prohibited",
+			mcp: "prohibited",
+			acp: "prohibited",
+			daemonCli: "prohibited",
+		});
+	if (id === "C52") return dispositions({ telegram: "prohibited", discord: "prohibited", slack: "prohibited" });
 	if (id === "C38")
 		return dispositions({
 			telegram: "prohibited",
@@ -199,6 +258,7 @@ function controlDisposition(id: string): Record<Adapter, AdapterDisposition> {
 function controlErrors(id: string): string[] {
 	const errors: Record<string, string[]> = {
 		C01: ["client_ref_conflict", "reconciliation_capacity", "reconciliation_persist_failed"],
+		C02: ["client_ref_conflict", "reconciliation_capacity", "reconciliation_persist_failed"],
 		C09: ["client_ref_conflict", "reconciliation_capacity", "reconciliation_persist_failed"],
 		C06: ["action_claimed"],
 		C07: ["action_claimed", "terminal_uncertain"],
@@ -241,7 +301,7 @@ function queryContinuityClass(id: string): QueryContinuityClass {
 }
 
 function queryDisposition(id: string): Record<Adapter, AdapterDisposition> {
-	if (["Q23", "Q24", "Q25", "Q26", "Q27", "Q28", "Q29", "Q30"].includes(id))
+	if (["Q23", "Q24", "Q25", "Q26", "Q27", "Q29", "Q30", "Q31"].includes(id))
 		return dispositions({ telegram: "prohibited", discord: "prohibited", slack: "prohibited" });
 	return dispositions();
 }
@@ -289,12 +349,14 @@ export const OPERATIONS: readonly Operation[] = [
 							acp: "machine_only",
 							daemonCli: "machine_only",
 						})
-					: dispositions(),
+					: ["G03", "G04", "G05", "G06", "G07"].includes(id)
+						? dispositions({ telegram: "prohibited", discord: "prohibited", slack: "prohibited" })
+						: dispositions(),
 			testIds: ["packages/coding-agent/test/sdk-operation-inventory.test.ts"],
 		};
 	}),
 	...queries.map(([sdkId, description], index) => {
-		const id = `Q${String(index + 1).padStart(2, "0")}`;
+		const id = queryId(index);
 		return {
 			id,
 			sdkId,
@@ -308,6 +370,7 @@ export const OPERATIONS: readonly Operation[] = [
 						? ["invalid_request", "resource_gone", "model_profile_registry_error"]
 						: ["invalid_request", "resource_gone"],
 			continuityClass: queryContinuityClass(id),
+			...(queryAliases[id] === undefined ? {} : { aliases: queryAliases[id] }),
 			adapterDispositions: queryDisposition(id),
 			testIds: ["packages/coding-agent/test/sdk-operation-inventory.test.ts"],
 		};

package/src/sdk/receipt-state.ts

@@ -0,0 +1,43 @@
+export type ReceiptState = "absent" | "present" | "missing" | "unknown";
+
+export type ExecutionState = "accepted" | "in_flight" | "terminal_ok" | "failed" | "cancelled" | "unknown";
+
+export interface ReceiptSource {
+	text?: string | null;
+	artifactPath?: string | null;
+}
+
+export interface TerminalReceiptInput {
+	execution: "accepted" | "in_flight" | "completed" | "failed" | "cancelled" | "unknown";
+	reportable: boolean;
+}
+
+export interface TerminalReceiptState {
+	execution: ExecutionState;
+	receipt: ReceiptState;
+}
+
+export function reportableReceipt({ text, artifactPath }: ReceiptSource): boolean {
+	return Boolean(text?.trim() || artifactPath?.trim());
+}
+
+export function receiptStateForTerminal(source: ReceiptSource): Extract<ReceiptState, "present" | "missing"> {
+	return reportableReceipt(source) ? "present" : "missing";
+}
+
+export function reduceTerminalReceiptState(input: TerminalReceiptInput): TerminalReceiptState {
+	switch (input.execution) {
+		case "accepted":
+			return { execution: "accepted", receipt: "absent" };
+		case "in_flight":
+			return { execution: "in_flight", receipt: "absent" };
+		case "completed":
+			return { execution: "terminal_ok", receipt: input.reportable ? "present" : "missing" };
+		case "failed":
+			return { execution: "failed", receipt: input.reportable ? "present" : "absent" };
+		case "cancelled":
+			return { execution: "cancelled", receipt: input.reportable ? "present" : "absent" };
+		case "unknown":
+			return { execution: "unknown", receipt: "unknown" };
+	}
+}

package/src/sdk/reconciliation-extensions.ts

@@ -0,0 +1,14 @@
+export {
+	createKindAwareReconciliation,
+	type KindAwareReconciliation,
+	type ReconciliationKind,
+	type SteerReconciliationResult,
+} from "./bus/kind-aware-reconciliation";
+export {
+	createReconciliationStore,
+	type DurableExecutionReconciliationRecord,
+	type DurableReconciliationRecord,
+	type DurableSteerReconciliationRecord,
+	type ReconciliationStore,
+	resolveReconciliationSessionFile,
+} from "./bus/reconciliation-store";

package/src/sdk/router/index.ts

@@ -0,0 +1 @@
+export * from "./session-router";