@zusehq/serve 0.1.3 → 0.1.5

package/dist/{cli-Cz9Ua4SV.mjs → cli-BKZzhoKT.mjs}

@@ -1,11 +1,12 @@
 import { randomUUID } from "node:crypto";
 import { readFile, stat } from "node:fs/promises";
+import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { Data, Effect, Layer, ManagedRuntime, Schema, Scope, Struct } from "effect";
 import { Rpc, RpcClient, RpcGroup, RpcSerialization } from "effect/unstable/rpc";
 import { Socket } from "effect/unstable/socket";
 //#region package.json
-var version = "0.1.3";
+var version = "0.1.5";
 //#endregion
 //#region ../client-runtime/src/connection.ts
 var WireProtocolMismatchError = class extends Data.TaggedError("WireProtocolMismatchError") {};
@@ -57,7 +58,7 @@ const WorktreeId = makeEntityId("WorktreeId");
 const ChatId = makeEntityId("ChatId");
 const EnvironmentId = makeEntityId("EnvironmentId");
 const AuthTokenId = makeEntityId("AuthTokenId");
-makeEntityId("CommandId");
+const CommandId = makeEntityId("CommandId");
 makeEntityId("EventId");
 //#endregion
 //#region ../contracts/src/agent.ts
@@ -360,9 +361,17 @@ const VersionEvent = Schema.TaggedStruct("Version", {
 	sdkVersion: Schema.optional(Schema.String)
 });
 const CapabilitiesEvent = Schema.TaggedStruct("Capabilities", { capabilities: Schema.Array(Schema.String) });
+/** Absolute, monotonically revised text emitted for one stable provider item. */
+const ProviderMessageCheckpoint = Schema.Struct({
+	/** Revisions start at 1 and increase for every accepted cumulative value. */
+	revision: Schema.Number,
+	/** Final promotion is itself a strictly newer revision. */
+	final: Schema.Boolean
+});
 const AssistantMessageEvent = Schema.TaggedStruct("AssistantMessage", {
 	itemId: AgentItemId,
 	text: Schema.String,
+	checkpoint: Schema.optional(ProviderMessageCheckpoint),
 	/** True when the provider emitted a dedicated final plan item. */
 	isPlan: Schema.optional(Schema.Boolean),
 	parentItemId: Schema.optional(AgentItemId)
@@ -371,6 +380,7 @@ const ThinkingEvent = Schema.TaggedStruct("Thinking", {
 	itemId: AgentItemId,
 	text: Schema.String,
 	redacted: Schema.Boolean,
+	checkpoint: Schema.optional(ProviderMessageCheckpoint),
 	parentItemId: Schema.optional(AgentItemId)
 });
 /**
@@ -1841,6 +1851,15 @@ var FsConflictError = class extends Schema.TaggedErrorClass()("FsConflictError",
 	expectedMtime: Schema.String,
 	actualMtime: Schema.String
 }) {};
+/**
+* A command id is an idempotency key, so it may only ever describe one exact
+* file write. Reusing it with a different target or payload is rejected
+* instead of returning an unrelated prior receipt.
+*/
+var FsCommandReuseError = class extends Schema.TaggedErrorClass()("FsCommandReuseError", {
+	commandId: CommandId,
+	reason: Schema.Literals(["target-mismatch", "payload-mismatch"])
+}) {};
 var FsExternalReadError = class extends Schema.TaggedErrorClass()("FsExternalReadError", {
 	path: Schema.String,
 	reason: Schema.String
@@ -1880,6 +1899,7 @@ const FsWriteFileErrors = Schema.Union([
 	FsPathOutsideError,
 	FsReadError,
 	FsConflictError,
+	FsCommandReuseError,
 	FsTooLargeError
 ]);
 const FsCreateErrors = Schema.Union([
@@ -1909,17 +1929,35 @@ const FsTreeRpc = Rpc.make("fs.tree", {
 	success: Schema.Array(FsEntry),
 	error: FsErrors
 });
+const FsTreeWatchEvent = Schema.Union([
+	Schema.TaggedStruct("ready", {
+		epoch: Schema.String,
+		sequence: Schema.Number
+	}),
+	Schema.TaggedStruct("changed", {
+		epoch: Schema.String,
+		sequence: Schema.Number,
+		paths: Schema.Array(Schema.String)
+	}),
+	Schema.TaggedStruct("gap", {
+		epoch: Schema.String,
+		sequence: Schema.Number,
+		reason: Schema.String
+	})
+]);
 /**
 * Live stream of filesystem changes under the current project/worktree root.
-* Emits debounced batches of forward-slash, project-relative paths so the
-* renderer can refresh only the open tree branches affected by disk changes.
+* `ready` proves the server watcher was attached before a client reads its
+* snapshot. Subsequent `changed` frames carry a stream-local monotonic
+* sequence. `gap` means the watcher can no longer prove continuity and the
+* client must attach a replacement watcher and perform a full reconciliation.
 */
 const FsWatchTreeRpc = Rpc.make("fs.watchTree", {
 	payload: Schema.Struct({
 		folderId: FolderId,
 		worktreeId: Schema.optional(Schema.NullOr(WorktreeId))
 	}),
-	success: Schema.Struct({ paths: Schema.Array(Schema.String) }),
+	success: FsTreeWatchEvent,
 	error: FsErrors,
 	stream: true
 });
@@ -1964,6 +2002,8 @@ const FsReadFileRpc = Rpc.make("fs.readFile", {
 */
 const FsWriteFileRpc = Rpc.make("fs.writeFile", {
 	payload: Schema.Struct({
+		/** Stable identity makes a lost write response safe to retry. */
+		commandId: CommandId,
 		folderId: FolderId,
 		path: Schema.String,
 		content: Schema.String,
@@ -2447,6 +2487,7 @@ const UserRichContent = Schema.TaggedStruct("user_rich", {
 const AssistantContent = Schema.TaggedStruct("assistant", {
 	itemId: Schema.optional(AgentItemId),
 	text: Schema.String,
+	checkpoint: Schema.optional(ProviderMessageCheckpoint),
 	/** Preserves a provider's dedicated final-plan item through persistence. */
 	isPlan: Schema.optional(Schema.Boolean),
 	parentItemId: Schema.optional(AgentItemId)
@@ -2461,6 +2502,7 @@ const ThinkingContent = Schema.TaggedStruct("thinking", {
 	itemId: AgentItemId,
 	text: Schema.String,
 	redacted: Schema.Boolean,
+	checkpoint: Schema.optional(ProviderMessageCheckpoint),
 	parentItemId: Schema.optional(AgentItemId)
 });
 const ToolUseContent = Schema.TaggedStruct("tool_use", {
@@ -2627,6 +2669,16 @@ var QueuedMessageNotFoundError = class extends Schema.TaggedErrorClass()("Queued
 	sessionId: SessionId,
 	queueId: Schema.String
 }) {};
+var QueuedMessageCapacityError = class extends Schema.TaggedErrorClass()("QueuedMessageCapacityError", {
+	sessionId: SessionId,
+	reason: Schema.Literals([
+		"too-many-items",
+		"item-too-large",
+		"queue-too-large"
+	]),
+	limit: Schema.Number,
+	actual: Schema.Number
+}) {};
 var QueueState = class extends Schema.Class("QueueState")({
 	items: Schema.Array(QueuedMessage),
 	paused: Schema.Boolean
@@ -2644,6 +2696,8 @@ const SessionTimelineTurn = Schema.Struct({
 });
 var SessionTimelineProjection = class extends Schema.Class("SessionTimelineProjection")({
 	messages: Schema.Array(Message),
+	/** Sequence immediately before the oldest materialized message, if any. */
+	olderMessageSequence: Schema.optional(Schema.NullOr(Schema.Number)),
 	status: SessionStatus,
 	currentTurn: Schema.NullOr(SessionTimelineTurn),
 	queue: QueueState,
@@ -2683,24 +2737,46 @@ const SessionTimelineEvent = Schema.Union([
 	Schema.TaggedStruct("QueueRemoved", { queueId: Schema.String }),
 	Schema.TaggedStruct("QueueReordered", { queueIds: Schema.Array(Schema.String) })
 ]);
+/** Durable cursor for one database epoch and one session stream. */
+const SessionStreamCursor = Schema.Struct({
+	epoch: Schema.String,
+	version: Schema.Number
+});
 const SessionTimelineFrame = Schema.Union([
 	Schema.Struct({
 		kind: Schema.Literal("snapshot"),
 		sessionId: SessionId,
 		throughVersion: Schema.Number,
-		projection: SessionTimelineProjection
+		projection: SessionTimelineProjection,
+		/** Present on new runtimes; omitted by older peers during protocol rollout. */
+		cursor: Schema.optional(SessionStreamCursor),
+		/** Sequence immediately before the oldest included message, if any. */
+		olderMessageSequence: Schema.optional(Schema.NullOr(Schema.Number))
 	}),
 	Schema.Struct({
 		kind: Schema.Literal("event"),
 		sessionId: SessionId,
 		streamVersion: Schema.Number,
 		eventId: Schema.String,
-		event: SessionTimelineEvent
+		event: SessionTimelineEvent,
+		cursor: Schema.optional(SessionStreamCursor)
 	}),
 	Schema.Struct({
 		kind: Schema.Literal("synchronized"),
 		sessionId: SessionId,
-		throughVersion: Schema.Number
+		throughVersion: Schema.Number,
+		cursor: Schema.optional(SessionStreamCursor)
+	}),
+	Schema.Struct({
+		kind: Schema.Literal("reset-required"),
+		sessionId: SessionId,
+		throughVersion: Schema.Number,
+		cursor: SessionStreamCursor,
+		reason: Schema.Literals([
+			"restored",
+			"compacted",
+			"cursor-invalid"
+		])
 	})
 ]);
 var SessionNotFoundError = class extends Schema.TaggedErrorClass()("SessionNotFoundError", { sessionId: SessionId }) {};
@@ -2821,6 +2897,7 @@ const SessionSetWorktreeRpc = Rpc.make("session.setWorktree", {
 });
 const SessionRenameRpc = Rpc.make("session.rename", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		title: Schema.String
 	}),
@@ -3072,6 +3149,7 @@ const ChatCreationOperation = Schema.Struct({
 	prompt: Schema.NullOr(Schema.String),
 	startupInput: Schema.NullOr(ComposerInput),
 	startupQueueId: Schema.NullOr(Schema.String),
+	startupReady: Schema.Boolean,
 	workspacePolicy: ChatWorkspacePolicy,
 	worktreeId: Schema.NullOr(WorktreeId),
 	status: ChatCreationOperationStatus,
@@ -3083,9 +3161,16 @@ const ChatCreationListRpc = Rpc.make("chat.creation.list", {
 	payload: Schema.Struct({ projectId: FolderId }),
 	success: Schema.Array(ChatCreationOperation)
 });
+const ChatCreationSummaryChange = Schema.Union([Schema.Struct({
+	_tag: Schema.Literal("snapshot"),
+	operations: Schema.Array(ChatCreationOperation)
+}), Schema.Struct({
+	_tag: Schema.Literal("change"),
+	operation: ChatCreationOperation
+})]);
 const ChatCreationStreamRpc = Rpc.make("chat.creation.stream", {
 	payload: Schema.Struct({ projectId: FolderId }),
-	success: ChatCreationOperation,
+	success: ChatCreationSummaryChange,
 	stream: true
 });
 const ChatCreationDiscardRpc = Rpc.make("chat.creation.discard", {
@@ -3109,6 +3194,8 @@ const ChatCreateRpc = Rpc.make("chat.create", {
 		workspacePolicy: Schema.optional(ChatWorkspacePolicy),
 		startupInput: Schema.optional(ComposerInput),
 		startupQueueId: Schema.optional(Schema.String),
+		/** False while attachment or generated context preparation is pending. */
+		startupReady: Schema.optional(Schema.Boolean),
 		agents: Schema.optional(Schema.Record(Schema.String, AgentDefinition)),
 		enableSubagents: Schema.optional(Schema.Boolean),
 		permissionMode: Schema.optional(PermissionMode),
@@ -3264,18 +3351,31 @@ const MessagesListRpc = Rpc.make("messages.list", {
 */
 const MessagesSendRpc = Rpc.make("messages.send", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		text: Schema.optional(Schema.String),
 		input: Schema.optional(ComposerInput),
 		asGoal: Schema.optional(Schema.Boolean),
+		modelOptions: Schema.optional(Schema.Record(Schema.String, Schema.String)),
 		clientMessageId: Schema.optional(MessageId)
 	}),
 	success: Schema.Void,
 	error: Schema.Union([SessionNotFoundError, DirectoryUnavailableError])
 });
+/** Durable outcome of an exact-turn interrupt request. */
+const TurnInterruptReceipt = Schema.Union([Schema.TaggedStruct("requested", { turnId: AgentTurnId }), Schema.TaggedStruct("not-active", {
+	reason: Schema.Literals(["no-active-turn", "turn-mismatch"]),
+	expectedTurnId: Schema.NullOr(AgentTurnId),
+	actualTurnId: Schema.NullOr(AgentTurnId)
+})]);
 const MessagesInterruptRpc = Rpc.make("messages.interrupt", {
-	payload: Schema.Struct({ sessionId: SessionId }),
-	success: Schema.Void,
+	payload: Schema.Struct({
+		commandId: CommandId,
+		sessionId: SessionId,
+		/** Fences retries to the turn visible when the user pressed Stop. */
+		expectedTurnId: Schema.optional(AgentTurnId)
+	}),
+	success: TurnInterruptReceipt,
 	error: SessionNotFoundError
 });
 const MessagesQueueListRpc = Rpc.make("messages.queue.list", {
@@ -3285,6 +3385,7 @@ const MessagesQueueListRpc = Rpc.make("messages.queue.list", {
 });
 const MessagesQueueAddRpc = Rpc.make("messages.queue.add", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		/** Stable identity used to make persistence retries idempotent. */
 		queueId: Schema.optional(Schema.String),
@@ -3295,19 +3396,25 @@ const MessagesQueueAddRpc = Rpc.make("messages.queue.add", {
 		flush: Schema.optional(Schema.Boolean)
 	}),
 	success: QueuedMessage,
-	error: SessionNotFoundError
+	error: Schema.Union([SessionNotFoundError, QueuedMessageCapacityError])
 });
 const MessagesQueueUpdateRpc = Rpc.make("messages.queue.update", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		queueId: Schema.String,
 		input: ComposerInput
 	}),
 	success: QueuedMessage,
-	error: Schema.Union([SessionNotFoundError, QueuedMessageNotFoundError])
+	error: Schema.Union([
+		SessionNotFoundError,
+		QueuedMessageNotFoundError,
+		QueuedMessageCapacityError
+	])
 });
 const MessagesQueueDeleteRpc = Rpc.make("messages.queue.delete", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		queueId: Schema.String
 	}),
@@ -3320,6 +3427,7 @@ const MessagesQueueDeleteRpc = Rpc.make("messages.queue.delete", {
 */
 const MessagesQueueRunNextRpc = Rpc.make("messages.queue.runNext", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		queueId: Schema.String
 	}),
@@ -3328,6 +3436,7 @@ const MessagesQueueRunNextRpc = Rpc.make("messages.queue.runNext", {
 });
 const MessagesQueueReorderRpc = Rpc.make("messages.queue.reorder", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		queueIds: Schema.Array(Schema.String)
 	}),
@@ -3335,12 +3444,18 @@ const MessagesQueueReorderRpc = Rpc.make("messages.queue.reorder", {
 	error: SessionNotFoundError
 });
 const MessagesQueueFlushRpc = Rpc.make("messages.queue.flush", {
-	payload: Schema.Struct({ sessionId: SessionId }),
+	payload: Schema.Struct({
+		commandId: CommandId,
+		sessionId: SessionId
+	}),
 	success: Schema.Void,
 	error: SessionNotFoundError
 });
 const MessagesQueueResumeRpc = Rpc.make("messages.queue.resume", {
-	payload: Schema.Struct({ sessionId: SessionId }),
+	payload: Schema.Struct({
+		commandId: CommandId,
+		sessionId: SessionId
+	}),
 	success: Schema.Void,
 	error: SessionNotFoundError
 });
@@ -3361,6 +3476,7 @@ const SessionResumeRpc = Rpc.make("session.resume", {
 */
 const SessionSetRuntimeModeRpc = Rpc.make("session.setRuntimeMode", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		runtimeMode: RuntimeMode
 	}),
@@ -3375,6 +3491,7 @@ const SessionSetRuntimeModeRpc = Rpc.make("session.setRuntimeMode", {
 */
 const SessionSetPermissionModeRpc = Rpc.make("session.setPermissionMode", {
 	payload: Schema.Struct({
+		commandId: CommandId,
 		sessionId: SessionId,
 		mode: PermissionMode
 	}),
@@ -3422,6 +3539,7 @@ const SessionEventsRpc = Rpc.make("session.events", {
 	payload: Schema.Struct({
 		sessionId: SessionId,
 		afterVersion: Schema.optional(Schema.Number),
+		streamEpoch: Schema.optional(Schema.String),
 		hasProjection: Schema.optional(Schema.Boolean)
 	}),
 	success: SessionTimelineFrame,
@@ -3431,7 +3549,23 @@ const SessionEventsRpc = Rpc.make("session.events", {
 /** Lightweight durable cursor used to detect an open-but-stalled event stream. */
 const SessionEventsHeadRpc = Rpc.make("session.events.head", {
 	payload: Schema.Struct({ sessionId: SessionId }),
-	success: Schema.Struct({ throughVersion: Schema.Number }),
+	success: Schema.Struct({
+		throughVersion: Schema.Number,
+		streamEpoch: Schema.optional(Schema.String)
+	}),
+	error: SessionNotFoundError
+});
+/** Older timeline messages, newest page first on the wire then rendered ascending. */
+const SessionMessagesPageRpc = Rpc.make("session.messages.page", {
+	payload: Schema.Struct({
+		sessionId: SessionId,
+		beforeSequence: Schema.optional(Schema.Number),
+		limit: Schema.optional(Schema.Number)
+	}),
+	success: Schema.Struct({
+		messages: Schema.Array(Message),
+		olderMessageSequence: Schema.NullOr(Schema.Number)
+	}),
 	error: SessionNotFoundError
 });
 const SessionGoalGetRpc = Rpc.make("session.goal.get", {
@@ -3882,7 +4016,6 @@ const CloudWorkspaceState = Schema.Literals([
 	"resuming",
 	"archiving",
 	"archived",
-	"recovering",
 	"deleting",
 	"deleted",
 	"failed"
@@ -4004,9 +4137,7 @@ var CloudWorkspace = class extends Schema.Class("CloudWorkspace")({
 	initialSessionId: AgentSessionId,
 	createdAt: Schema.Number,
 	updatedAt: Schema.Number,
-	lastActivityAt: Schema.Number,
-	warmRetentionDeadline: Schema.optional(Schema.Number),
-	recoveryAvailable: Schema.Boolean
+	lastActivityAt: Schema.Number
 }) {};
 var CloudWorkspaceLaunch = class extends Schema.Class("CloudWorkspaceLaunch")({
 	workspace: CloudWorkspace,
@@ -4017,47 +4148,19 @@ var CloudWorkspaceConnection = class extends Schema.Class("CloudWorkspaceConnect
 	workspaceId: Schema.String,
 	wsUrl: Schema.String,
 	protocol: Schema.String,
+	role: Schema.Literal("client"),
+	generation: Schema.Number,
+	gatewayEpoch: Schema.Number,
 	credential: Schema.String,
 	expiresAt: Schema.Number
 }) {};
-var CloudChatEvent = class extends Schema.Class("CloudChatEvent")({
-	sequence: Schema.Number,
-	eventId: Schema.String,
-	streamId: Schema.String,
-	streamVersion: Schema.Number,
-	type: Schema.String,
-	payloadJson: Schema.String,
-	createdAt: Schema.Number
-}) {};
-var CloudChatQueuedMessage = class extends Schema.Class("CloudChatQueuedMessage")({
-	sequence: Schema.optional(Schema.Number),
-	clientMessageId: MessageId,
-	input: ComposerInput,
-	state: Schema.Literals([
-		"queued",
-		"claimed",
-		"acknowledged",
-		"failed"
-	]),
-	asGoal: Schema.Boolean,
-	createdAt: Schema.Number
-}) {};
-var CloudChatHistory = class extends Schema.Class("CloudChatHistory")({
-	workspaceId: Schema.String,
-	chatId: ChatId,
-	initialSessionId: AgentSessionId,
-	firstMessage: Schema.optional(Schema.String),
-	commandState: Schema.Literals([
-		"queued",
-		"claimed",
-		"acknowledged",
-		"failed"
-	]),
-	events: Schema.Array(CloudChatEvent),
-	queuedMessages: Schema.Array(CloudChatQueuedMessage),
-	cursor: Schema.Number
-}) {};
-/** Durable cloud-chat metadata that is available without a live sandbox. */
+Schema.Class("CloudWorkspaceRuntimeSummary")({
+	summaryRevision: Schema.Number,
+	title: Schema.String,
+	lastActivityAt: Schema.Number,
+	sessionHeadVersion: Schema.Number
+});
+/** Last-known cloud workspace metadata available without a live runtime. */
 var CloudChatSummary = class extends Schema.Class("CloudChatSummary")({
 	workspaceId: Schema.String,
 	projectId: Schema.String,
@@ -4076,16 +4179,69 @@ var CloudChatSummary = class extends Schema.Class("CloudChatSummary")({
 	statusCode: Schema.String,
 	startupPhase: CloudWorkspaceStartupPhase,
 	revision: Schema.Number,
+	/** Monotonic within the current runtime generation. */
+	summaryRevision: Schema.Number.pipe(Schema.withConstructorDefault(Effect.succeed(0)), Schema.withDecodingDefaultType(Effect.succeed(0))),
+	/** Authoritative runtime session head represented by this summary. */
+	sessionHeadVersion: Schema.Number.pipe(Schema.withConstructorDefault(Effect.succeed(0)), Schema.withDecodingDefaultType(Effect.succeed(0))),
 	unread: Schema.Boolean,
 	lastMessageAt: Schema.NullOr(Schema.Number),
 	archivedAt: Schema.optional(Schema.Number),
-	archivePhase: Schema.optional(Schema.String),
-	archiveErrorCode: Schema.optional(Schema.String),
-	archiveDiagnostic: Schema.optional(Schema.String),
 	createdAt: Schema.Number,
 	updatedAt: Schema.Number
 }) {};
 var CloudChatList = class extends Schema.Class("CloudChatList")({ chats: Schema.Array(CloudChatSummary) }) {};
+Schema.Class("CloudTranscriptCheckpointPayload")({
+	schemaVersion: Schema.Literal(1),
+	workspaceId: Schema.String,
+	sessionId: AgentSessionId,
+	cursor: SessionStreamCursor,
+	projection: SessionTimelineProjection
+});
+var CloudTranscriptCheckpointMetadata = class extends Schema.Class("CloudTranscriptCheckpointMetadata")({
+	workspaceId: Schema.String,
+	sessionId: AgentSessionId,
+	runtimeGeneration: Schema.Number,
+	cursor: SessionStreamCursor,
+	objectKey: Schema.String,
+	ciphertextSha256: Schema.String,
+	ciphertextBytes: Schema.Number,
+	createdAt: Schema.Number
+}) {};
+Schema.Class("CloudTranscriptCheckpointUpload")({
+	sessionId: AgentSessionId,
+	cursor: SessionStreamCursor,
+	ciphertext: Schema.String,
+	ciphertextSha256: Schema.String
+});
+var CloudTranscriptCheckpointAccess = class extends Schema.Class("CloudTranscriptCheckpointAccess")({
+	metadata: CloudTranscriptCheckpointMetadata,
+	ciphertext: Schema.String,
+	transcriptKey: Schema.String
+}) {};
+var CloudTranscriptCheckpointResult = class extends Schema.Class("CloudTranscriptCheckpointResult")({ checkpoint: Schema.NullOr(CloudTranscriptCheckpointAccess) }) {};
+Schema.Class("CloudTranscriptMessagePagePayload")({
+	schemaVersion: Schema.Literal(1),
+	workspaceId: Schema.String,
+	sessionId: AgentSessionId,
+	cursor: SessionStreamCursor,
+	beforeSequence: Schema.Number,
+	messages: Schema.Array(Message),
+	olderMessageSequence: Schema.NullOr(Schema.Number)
+});
+Schema.Class("CloudTranscriptMessagePageUpload")({
+	sessionId: AgentSessionId,
+	cursor: SessionStreamCursor,
+	beforeSequence: Schema.Number,
+	ciphertext: Schema.String,
+	ciphertextSha256: Schema.String
+});
+var CloudTranscriptMessagePageResult = class extends Schema.Class("CloudTranscriptMessagePageResult")({ page: Schema.NullOr(Schema.Struct({
+	cursor: SessionStreamCursor,
+	beforeSequence: Schema.Number,
+	ciphertext: Schema.String,
+	ciphertextSha256: Schema.String,
+	transcriptKey: Schema.String
+})) }) {};
 var CloudWorkspaceList = class extends Schema.Class("CloudWorkspaceList")({ workspaces: Schema.Array(CloudWorkspace) }) {};
 var CloudWorkspaceCreateRequest = class extends Schema.Class("CloudWorkspaceCreateRequest")({
 	projectId: Schema.String,
@@ -4100,7 +4256,29 @@ var CloudWorkspaceCreateRequest = class extends Schema.Class("CloudWorkspaceCrea
 	firstMessage: Schema.optional(Schema.String),
 	idempotencyKey: Schema.String
 }) {};
-var CloudWorkspaceActionRequest = class extends Schema.Class("CloudWorkspaceActionRequest")({ workspaceId: Schema.String }) {};
+var CloudWorkspaceActionRequest = class extends Schema.Class("CloudWorkspaceActionRequest")({
+	workspaceId: Schema.String,
+	commandId: Schema.optional(Schema.String)
+}) {};
+var CloudWorkspaceResumeRequest = class extends Schema.Class("CloudWorkspaceResumeRequest")({
+	workspaceId: Schema.String,
+	commandId: Schema.optional(Schema.String),
+	/** The gateway proved that Relay's online projection has no runtime socket. */
+	recoverRuntime: Schema.optional(Schema.Boolean)
+}) {};
+/**
+* A short-lived grant for the workspace runtime's WebSocket SSH bridge. The
+* relay stages the hashed ticket inside the sandbox; the desktop's
+* ProxyCommand bridge presents the plain ticket when it connects to `wsUrl`.
+*/
+var CloudWorkspaceSshAccess = class extends Schema.Class("CloudWorkspaceSshAccess")({
+	workspaceId: Schema.String,
+	wsUrl: Schema.String,
+	ticket: Schema.String,
+	expiresAt: Schema.Number,
+	user: Schema.String,
+	workspacePath: Schema.String
+}) {};
 var CloudCredentialConnection = class extends Schema.Class("CloudCredentialConnection")({
 	kind: CloudCredentialKind,
 	state: Schema.Literals([
@@ -4134,7 +4312,8 @@ var CloudWorkspaceOpError = class extends Schema.TaggedErrorClass()("CloudWorksp
 	"project-not-ready",
 	"credential-required",
 	"branch-in-use",
-	"conflict"
+	"conflict",
+	"billing-hold"
 ]) }) {};
 const CloudProvidersRpc = Rpc.make("cloud.providers", {
 	payload: Schema.Void,
@@ -4166,6 +4345,19 @@ const CloudWorkspacesGetRpc = Rpc.make("cloud.workspaces.get", {
 	success: CloudWorkspace,
 	error: CloudWorkspaceOpError
 });
+/**
+* One monotonic lifecycle control stream for a workspace. The server adapts
+* Relay's current REST surface; clients never own lifecycle polling loops.
+*/
+const CloudWorkspacesWatchRpc = Rpc.make("cloud.workspaces.watch", {
+	payload: Schema.Struct({
+		workspaceId: Schema.String,
+		afterRevision: Schema.optional(Schema.Number)
+	}),
+	success: CloudWorkspace,
+	error: CloudWorkspaceOpError,
+	stream: true
+});
 const CloudWorkspacesCreateRpc = Rpc.make("cloud.workspaces.create", {
 	payload: CloudWorkspaceCreateRequest,
 	success: CloudWorkspaceLaunch,
@@ -4176,14 +4368,6 @@ const CloudWorkspacesConnectRpc = Rpc.make("cloud.workspaces.connect", {
 	success: CloudWorkspaceConnection,
 	error: CloudWorkspaceOpError
 });
-const CloudChatsHistoryRpc = Rpc.make("cloud.chats.history", {
-	payload: Schema.Struct({
-		workspaceId: Schema.String,
-		after: Schema.optional(Schema.Number)
-	}),
-	success: CloudChatHistory,
-	error: CloudWorkspaceOpError
-});
 const CloudChatsListRpc = Rpc.make("cloud.chats.list", {
 	payload: Schema.Struct({
 		projectId: Schema.optional(Schema.String),
@@ -4196,32 +4380,25 @@ const CloudChatsListRpc = Rpc.make("cloud.chats.list", {
 	success: CloudChatList,
 	error: CloudWorkspaceOpError
 });
-const CloudChatsRenameRpc = Rpc.make("cloud.chats.rename", {
-	payload: Schema.Struct({
-		workspaceId: Schema.String,
-		title: Schema.String
-	}),
-	success: CloudChatSummary,
+const CloudWorkspacesPauseRpc = Rpc.make("cloud.workspaces.pause", {
+	payload: CloudWorkspaceActionRequest,
+	success: CloudWorkspace,
 	error: CloudWorkspaceOpError
 });
-const CloudChatsSendRpc = Rpc.make("cloud.chats.send", {
-	payload: Schema.Struct({
-		workspaceId: Schema.String,
-		input: ComposerInput,
-		clientMessageId: MessageId,
-		asGoal: Schema.optional(Schema.Boolean)
-	}),
-	success: Schema.Struct({ sequence: Schema.Number }),
+const CloudWorkspacesResumeRpc = Rpc.make("cloud.workspaces.resume", {
+	payload: CloudWorkspaceResumeRequest,
+	success: CloudWorkspace,
 	error: CloudWorkspaceOpError
 });
-const CloudWorkspacesPauseRpc = Rpc.make("cloud.workspaces.pause", {
+/** Restart the runtime of a running workspace in place (same sandbox). */
+const CloudWorkspacesRestartRpc = Rpc.make("cloud.workspaces.restart", {
 	payload: CloudWorkspaceActionRequest,
 	success: CloudWorkspace,
 	error: CloudWorkspaceOpError
 });
-const CloudWorkspacesResumeRpc = Rpc.make("cloud.workspaces.resume", {
+const CloudWorkspacesSshAccessRpc = Rpc.make("cloud.workspaces.sshAccess", {
 	payload: CloudWorkspaceActionRequest,
-	success: CloudWorkspace,
+	success: CloudWorkspaceSshAccess,
 	error: CloudWorkspaceOpError
 });
 const CloudWorkspacesArchiveRpc = Rpc.make("cloud.workspaces.archive", {
@@ -4239,6 +4416,25 @@ const CloudWorkspacesDeleteRpc = Rpc.make("cloud.workspaces.delete", {
 	success: CloudWorkspace,
 	error: CloudWorkspaceOpError
 });
+const CloudTranscriptCheckpointGetRpc = Rpc.make("cloud.transcript.get", {
+	payload: Schema.Struct({
+		workspaceId: Schema.String,
+		sessionId: AgentSessionId,
+		cursor: Schema.optional(SessionStreamCursor)
+	}),
+	success: CloudTranscriptCheckpointResult,
+	error: CloudWorkspaceOpError
+});
+const CloudTranscriptMessagePageGetRpc = Rpc.make("cloud.transcript.messages.page", {
+	payload: Schema.Struct({
+		workspaceId: Schema.String,
+		sessionId: AgentSessionId,
+		cursor: SessionStreamCursor,
+		beforeSequence: Schema.Number
+	}),
+	success: CloudTranscriptMessagePageResult,
+	error: CloudWorkspaceOpError
+});
 const CloudCredentialsListRpc = Rpc.make("cloud.credentials.list", {
 	payload: Schema.Void,
 	success: CloudCredentialList,
@@ -4255,158 +4451,80 @@ const CloudCredentialsDisconnectRpc = Rpc.make("cloud.credentials.disconnect", {
 	error: CloudWorkspaceOpError
 });
 //#endregion
-//#region ../contracts/src/code-index.ts
-/**
-* Wire schemas for the Phase 0.04 code index. The engine in
-* `@zuse/index` defines a richer TS type per kind; here we keep the
-* shapes flat and primitive so they cross the effect/unstable/rpc + MCP JSON-schema
-* boundaries without ceremony.
-*/
-const IndexState = Schema.Literals([
-	"idle",
-	"indexing",
-	"ready",
-	"error"
-]);
-const IndexProgress = Schema.NullOr(Schema.Struct({
-	processed: Schema.Number,
-	total: Schema.Number
-}));
-const IndexStats = Schema.Struct({
-	blobs: Schema.Number,
-	chunks: Schema.Number,
-	symbols: Schema.Number,
-	refs: Schema.Number
-});
-var IndexStatusInfo = class extends Schema.Class("IndexStatusInfo")({
-	state: IndexState,
-	branch: Schema.NullOr(Schema.String),
-	progress: IndexProgress,
-	stats: IndexStats
-}) {};
-const SymbolKind = Schema.Literals([
-	"function",
-	"method",
-	"class",
-	"interface",
-	"type",
-	"enum",
-	"const",
-	"variable",
-	"property",
-	"export"
-]);
-const Range = Schema.Struct({
-	start: Schema.Number,
-	end: Schema.Number
-});
-const SearchKind = Schema.Literals([
-	"auto",
-	"symbol",
-	"text",
-	"semantic"
+//#region ../contracts/src/cloud-billing.ts
+const CloudBillingStatus = Schema.Literals([
+	"active",
+	"grace",
+	"billing-hold",
+	"ended",
+	"manual"
 ]);
-const SearchHit = Schema.Struct({
-	chunkId: Schema.Number,
-	file: Schema.String,
-	range: Range,
-	symbol: Schema.NullOr(Schema.Struct({
-		name: Schema.String,
-		kind: SymbolKind
-	})),
-	content: Schema.String,
-	score: Schema.Number,
-	source: Schema.Literals([
-		"symbol",
-		"bm25",
-		"vector",
-		"fused"
+var CloudBillingSummary = class extends Schema.Class("CloudBillingSummary")({
+	currency: Schema.Literal("USD"),
+	status: CloudBillingStatus,
+	periodStart: Schema.Number,
+	periodEnd: Schema.Number,
+	basePriceMicros: Schema.Number,
+	includedProviderCostMicros: Schema.Number,
+	providerCostMicros: Schema.Number,
+	includedUsedMicros: Schema.Number,
+	includedRemainingMicros: Schema.Number,
+	overageProviderCostMicros: Schema.Number,
+	overageChargeMicros: Schema.Number,
+	overageCapMicros: Schema.Number,
+	markupBasisPoints: Schema.Number,
+	currentInvoiceEstimateMicros: Schema.Number,
+	lastProviderReconciledAt: Schema.optional(Schema.Number),
+	lastPolarReconciledAt: Schema.optional(Schema.Number),
+	usageProvisional: Schema.Boolean
+}) {};
+var CloudBillingUsageItem = class extends Schema.Class("CloudBillingUsageItem")({
+	entryId: Schema.String,
+	resourceKind: Schema.Literals([
+		"workspace",
+		"build",
+		"other"
+	]),
+	resourceId: Schema.String,
+	provider: Schema.String,
+	providerExecutionId: Schema.optional(Schema.String),
+	startedAt: Schema.Number,
+	endedAt: Schema.Number,
+	vcpuCount: Schema.Number,
+	memoryMib: Schema.Number,
+	providerCostMicros: Schema.Number,
+	status: Schema.Literals([
+		"provisional",
+		"confirmed",
+		"corrected"
 	])
+}) {};
+var CloudBillingUsagePage = class extends Schema.Class("CloudBillingUsagePage")({
+	items: Schema.Array(CloudBillingUsageItem),
+	nextCursor: Schema.optional(Schema.String)
+}) {};
+var CloudBillingUsageRequest = class extends Schema.Class("CloudBillingUsageRequest")({
+	cursor: Schema.optional(Schema.String),
+	limit: Schema.optional(Schema.Number)
+}) {};
+var CloudBillingCapRequest = class extends Schema.Class("CloudBillingCapRequest")({
+	overageCapMicros: Schema.Number,
+	idempotencyKey: Schema.String
+}) {};
+const CloudBillingSummaryRpc = Rpc.make("cloud.billing.summary", {
+	payload: Schema.Void,
+	success: CloudBillingSummary,
+	error: CloudWorkspaceOpError
 });
-const SymbolHit = Schema.Struct({
-	symbolId: Schema.Number,
-	chunkId: Schema.NullOr(Schema.Number),
-	name: Schema.String,
-	kind: SymbolKind,
-	signature: Schema.NullOr(Schema.String),
-	file: Schema.String,
-	range: Range,
-	exported: Schema.Boolean
-});
-const RefHit = Schema.Struct({
-	refId: Schema.Number,
-	file: Schema.String,
-	range: Range,
-	context: Schema.String
-});
-const ChunkContent = Schema.NullOr(Schema.Struct({
-	chunkId: Schema.Number,
-	file: Schema.String,
-	content: Schema.String,
-	range: Range
-}));
-const SymbolSummary = Schema.Struct({
-	name: Schema.String,
-	kind: SymbolKind,
-	signature: Schema.NullOr(Schema.String),
-	startLine: Schema.Number,
-	exported: Schema.Boolean
-});
-Rpc.make("index.status", {
-	payload: Schema.Struct({ folderId: FolderId }),
-	success: IndexStatusInfo
-});
-Rpc.make("index.statusStream", {
-	payload: Schema.Struct({ folderId: FolderId }),
-	success: IndexStatusInfo,
-	stream: true
-});
-Rpc.make("index.reindex", {
-	payload: Schema.Struct({ folderId: FolderId }),
-	success: IndexStatusInfo
-});
-Rpc.make("index.search", {
-	payload: Schema.Struct({
-		folderId: FolderId,
-		query: Schema.String,
-		kind: Schema.optional(SearchKind),
-		limit: Schema.optional(Schema.Number),
-		pathGlob: Schema.optional(Schema.String)
-	}),
-	success: Schema.Array(SearchHit)
-});
-Rpc.make("index.symbolLookup", {
-	payload: Schema.Struct({
-		folderId: FolderId,
-		name: Schema.String,
-		kind: Schema.optional(Schema.String),
-		limit: Schema.optional(Schema.Number),
-		pathGlob: Schema.optional(Schema.String)
-	}),
-	success: Schema.Array(SymbolHit)
-});
-Rpc.make("index.findReferences", {
-	payload: Schema.Struct({
-		folderId: FolderId,
-		symbol: Schema.String,
-		limit: Schema.optional(Schema.Number),
-		pathGlob: Schema.optional(Schema.String)
-	}),
-	success: Schema.Array(RefHit)
-});
-Rpc.make("index.readChunk", {
-	payload: Schema.Struct({
-		folderId: FolderId,
-		chunkId: Schema.Number
-	}),
-	success: ChunkContent
+const CloudBillingUsageRpc = Rpc.make("cloud.billing.usage", {
+	payload: CloudBillingUsageRequest,
+	success: CloudBillingUsagePage,
+	error: CloudWorkspaceOpError
 });
-Rpc.make("index.listModule", {
-	payload: Schema.Struct({
-		folderId: FolderId,
-		path: Schema.String
-	}),
-	success: Schema.Array(SymbolSummary)
+const CloudBillingSetCapRpc = Rpc.make("cloud.billing.setCap", {
+	payload: CloudBillingCapRequest,
+	success: CloudBillingSummary,
+	error: CloudWorkspaceOpError
 });
 //#endregion
 //#region ../contracts/src/connect.ts
@@ -4901,6 +5019,7 @@ var GithubRepoSummary = class extends Schema.Class("GithubRepoSummary")({
 	sshUrl: Schema.String,
 	httpsUrl: Schema.String,
 	isPrivate: Schema.Boolean,
+	defaultBranch: Schema.String,
 	updatedAt: Schema.DateFromString
 }) {};
 /**
@@ -5177,9 +5296,18 @@ const GitUserNameRpc = Rpc.make("git.userName", {
 	success: Schema.Struct({ userName: Schema.String }),
 	error: GitErrors
 });
-const GitHeadChangedRpc = Rpc.make("git.headChanged", {
-	payload: Schema.Struct({ folderId: FolderId }),
-	success: Schema.Struct({ sha: Schema.String }),
+/**
+* Coalesced invalidation for one explicit repository checkout. The first
+* frame is emitted immediately, then filesystem/index/HEAD changes advance a
+* monotonic revision. Clients re-read their materialized Git resource after
+* each revision; no transcript or patch payload is duplicated in this stream.
+*/
+const GitWorkspaceChangesRpc = Rpc.make("git.workspaceChanges", {
+	payload: Schema.Struct({
+		folderId: FolderId,
+		worktreeId: Schema.optional(Schema.NullOr(WorktreeId))
+	}),
+	success: Schema.Struct({ revision: Schema.Number }),
 	error: GitErrors,
 	stream: true
 });
@@ -5731,26 +5859,6 @@ const GitRevertAllRpc = Rpc.make("git.revertAll", {
 	success: Schema.Struct({ reverted: Schema.Boolean }),
 	error: GitErrors
 });
-/**
-* Total additions/deletions of a worktree's branch — including uncommitted
-* working-tree edits — relative to its base branch. Computed as
-* `git diff --numstat <merge-base(base, HEAD)>`, where `base` is the repo's
-* default branch (`origin/HEAD`, falling back to origin/main, main, …). Drives
-* the projects sidebar's per-chat `+N −N` stats so a branch shows its diff
-* even before a PR is opened. Returns zeros rather than failing when there's
-* no base, no commits, or no diff.
-*/
-const GitDiffStatRpc = Rpc.make("git.diffStat", {
-	payload: Schema.Struct({
-		folderId: FolderId,
-		worktreeId: Schema.optional(Schema.NullOr(WorktreeId))
-	}),
-	success: Schema.Struct({
-		additions: Schema.Number,
-		deletions: Schema.Number
-	}),
-	error: GitErrors
-});
 //#endregion
 //#region ../contracts/src/handshake.ts
 var WireHello = class extends Schema.Class("WireHello")({ protocolVersion: Schema.Number }) {};
@@ -6289,6 +6397,23 @@ const MachineRuntimeUpdateRpc = Rpc.make("machine.runtime.update", {
 	success: MachineRuntimeStatus,
 	error: MachineOpError
 });
+var MachineResourceSample = class extends Schema.Class("MachineResourceSample")({
+	sampledAt: Schema.Number,
+	cpuCores: Schema.Number,
+	cpuPercent: Schema.Number,
+	memTotalBytes: Schema.Number,
+	memUsedBytes: Schema.Number,
+	diskTotalBytes: Schema.Number,
+	diskUsedBytes: Schema.Number,
+	/** Filesystem the disk numbers describe (the workspace root when present). */
+	diskPath: Schema.String
+}) {};
+const MachineResourcesWatchRpc = Rpc.make("machine.resources.watch", {
+	payload: Schema.Struct({ intervalMs: Schema.optional(Schema.Number) }),
+	success: MachineResourceSample,
+	error: MachineOpError,
+	stream: true
+});
 const AccountAccessProvider = Schema.Literals([
 	"github",
 	"claude",
@@ -6745,6 +6870,20 @@ var SavedDecision = class extends Schema.Class("SavedDecision")({
 	decidedAt: Schema.DateFromString
 }) {};
 var PermissionRequestNotFoundError = class extends Schema.TaggedErrorClass()("PermissionRequestNotFoundError", { requestId: Schema.String }) {};
+const PermissionRequestChange = Schema.Union([
+	Schema.Struct({
+		_tag: Schema.Literal("snapshot"),
+		requests: Schema.Array(PermissionRequest)
+	}),
+	Schema.Struct({
+		_tag: Schema.Literal("change"),
+		request: PermissionRequest
+	}),
+	Schema.Struct({
+		_tag: Schema.Literal("remove"),
+		requestId: Schema.String
+	})
+]);
 /**
 * Live stream of pending requests across every session. The renderer
 * filters by selected session; broadcasting once and filtering on the
@@ -6753,7 +6892,7 @@ var PermissionRequestNotFoundError = class extends Schema.TaggedErrorClass()("Pe
 */
 const PermissionRequestsRpc = Rpc.make("permission.requests", {
 	payload: Schema.Struct({}),
-	success: PermissionRequest,
+	success: PermissionRequestChange,
 	stream: true
 });
 const PermissionDecideRpc = Rpc.make("permission.decide", {
@@ -7879,7 +8018,7 @@ const UsageLimitsHistoryRpc = Rpc.make("usage.limits.history", {
 *
 * Add new RPCs by importing them here and including them in the group.
 */
-const MemoizeRpcs = RpcGroup.make(PingRpc, AnalyticsGetContextRpc, AnalyticsContextChangesRpc, AuthGetSessionRpc, AuthSignInRpc, AuthSignOutRpc, AuthSessionChangesRpc, LinearListConnectionsRpc, LinearConnectRpc, LinearDisconnectRpc, LinearListIssuesRpc, LinearPrepareContextRpc, PairingStartRpc, PairingListTokensRpc, PairingRevokeTokenRpc, PairingListNearbyRequestsRpc, PairingResolveNearbyRequestRpc, ConnectHandshakeRpc, ConnectDescribeRpc, ConnectLinkProofRpc, ConnectRelayConfigRpc, RelayLinkRpc, RelayStatusRpc, RelayUnlinkRpc, EnvironmentsListRpc, EnvironmentConnectRpc, CloudProvidersRpc, CloudProjectsListRpc, CloudProjectsConnectRpc, CloudProjectsPrepareRpc, CloudWorkspacesListRpc, CloudWorkspacesGetRpc, CloudWorkspacesCreateRpc, CloudWorkspacesConnectRpc, CloudChatsHistoryRpc, CloudChatsListRpc, CloudChatsRenameRpc, CloudChatsSendRpc, CloudWorkspacesPauseRpc, CloudWorkspacesResumeRpc, CloudWorkspacesArchiveRpc, CloudWorkspacesUnarchiveRpc, CloudWorkspacesDeleteRpc, CloudCredentialsListRpc, CloudCredentialsImportLocalRpc, CloudCredentialsDisconnectRpc, MachinesOffersRpc, MachinesListRpc, MachinesGetRpc, MachinesCreateRpc, MachinesCancelRpc, MachinesRecoverRpc, MachinesDestroyRpc, MachinesCheckoutRpc, MachinesBillingPortalRpc, MachinesEntitlementsRpc, MachineSshKeysAddRpc, MachineSshKeysListRpc, MachineSshKeysRemoveRpc, MachinePrivateNetworkEnableRpc, MachinePrivateNetworkStatusRpc, MachineRuntimeTargetRpc, MachineRuntimeStatusRpc, MachineRuntimeUpdateRpc, MachineSshModeSetRpc, AccountAccessStatusRpc, AccountAccessDetectLocalRpc, AccountAccessStartLoginRpc, AccountAccessPrepareImportRpc, AccountAccessCreateClaudeTransferRpc, AccountAccessContinueClaudeTransferRpc, AccountAccessImportRpc, AccountAccessDisconnectRpc, RelayEnvironmentsRpc, RelayConnectEnvironmentRpc, RelayClientsRpc, RelayRevokeClientRpc, WorkspaceAddRpc, WorkspaceBrowseDirectoryRpc, WorkspaceListRpc, WorkspaceRemoveRpc, WorkspacePickFolderRpc, WorkspaceGetSelectedRpc, WorkspaceSetSelectedRpc, WorkspaceStreamChangesRpc, WorkspaceSearchFilesRpc, WorkspaceCloneRepoRpc, WorkspaceCreateProjectRpc, WorkspaceListGithubReposRpc, WorkspaceGhAuthStatusRpc, ExternalThreadsListRpc, ExternalThreadsContinueRpc, PtyOpenRpc, PtyWriteRpc, PtyResizeRpc, PtyCloseRpc, PtyOutputRpc, GitLogRpc, GitStatusRpc, GitBranchesRpc, GitSwitchBranchRpc, GitUserNameRpc, GitHeadChangedRpc, GitOriginRpc, GitPrStateRpc, GitPrDetailsRpc, GitListPrsRpc, GitListIssuesRpc, GitIssueMarkdownRpc, GitChangesRpc, GitReviewSummaryRpc, GitReviewPatchesRpc, GitReviewFileContentsRpc, GitReviewIdentityRpc, GitDiffRpc, GitCommitRpc, GitCreateReviewCommentRpc, GitPushRpc, GitResolveConflictRpc, GitMergePrRpc, GitMarkReadyRpc, GitInitRpc, GitFixFailingChecksRpc, GitRevertFileRpc, GitRestoreFileToBaseRpc, GitRevertAllRpc, GitDiffStatRpc, FsTreeRpc, FsWatchTreeRpc, FsListPathsRpc, FsMoveRpc, FsReadFileRpc, FsWriteFileRpc, FsCreateFileRpc, FsCreateDirectoryRpc, FsRemoveRpc, FsReadExternalFileRpc, FsWriteExternalFileRpc, ProviderAvailabilityRpc, ProviderRemoveCredentialRpc, ProviderSetCredentialRpc, ProviderOpencodeInventoryRpc, ProviderKiroInventoryRpc, ProviderOpencodeSetAuthRpc, ProviderOpencodeRemoveAuthRpc, ProviderOpencodeAddCustomRpc, ProviderOpencodeRemoveCustomRpc, ProviderStartLoginRpc, ProviderUpdateRpc, ChatArchivePreviewRpc, McpListRpc, McpRefreshRpc, McpSetEnabledRpc, McpAuthenticateRpc, ChatListRpc, ChatGetRpc, ChatCreateRpc, ChatCreationListRpc, ChatCreationStreamRpc, ChatCreationDiscardRpc, ChatRenameRpc, ChatMarkReadRpc, ChatStreamChangesRpc, ChatSetWorktreeRpc, ChatSetActiveSessionRpc, ChatArchiveRpc, ChatArchiveStatusRpc, ChatArchiveJobsRpc, ChatDirectoryStatusRpc, ChatUnarchiveRpc, ChatDeleteRpc, SessionListRpc, SessionStreamChangesRpc, SessionMcpUpdateRpc, SessionGetRpc, SessionCreateRpc, SessionRenameRpc, SessionGoalGetRpc, SessionGoalSetRpc, SessionGoalClearRpc, SessionGoalStreamRpc, SessionSetModelRpc, SessionSetProviderRpc, SessionArchiveRpc, SessionUnarchiveRpc, SessionDeleteRpc, SessionEventsHeadRpc, SessionEventsRpc, SessionForkRpc, SessionExportTranscriptRpc, SessionLatestPlanRpc, SessionResumeRpc, SessionSetRuntimeModeRpc, SessionSetPermissionModeRpc, SessionAnswerQuestionRpc, SessionPlanRespondRpc, SessionSetWorktreeRpc, MessagesListRpc, MessagesSendRpc, MessagesInterruptRpc, MessagesQueueListRpc, MessagesQueueAddRpc, MessagesQueueUpdateRpc, MessagesQueueDeleteRpc, MessagesQueueRunNextRpc, MessagesQueueReorderRpc, MessagesQueueFlushRpc, MessagesQueueResumeRpc, AttachmentUploadRpc, ContextSaveTextRpc, SkillListRpc, SkillListForProjectRpc, SkillStreamRpc, PermissionRequestsRpc, PermissionDecideRpc, PermissionListPendingRpc, PermissionListDecisionsRpc, PermissionRevokeDecisionRpc, PokemonPokedexRpc, PokemonEnsureSpriteCachedRpc, BrowserCommandsRpc, BrowserRespondRpc, BrowserSetCredentialRpc, BrowserListCredentialsRpc, BrowserRemoveCredentialRpc, WorktreeCreateRpc, WorktreeListRpc, WorktreeGetRpc, WorktreeRenameBranchRpc, WorktreeRerunSetupRpc, WorktreeSetupStreamRpc, WorktreeStartRunRpc, WorktreeRemoveRpc, RepositorySettingsGetRpc, RepositorySettingsUpdateRpc, SettingsGetRpc, SettingsUpdateRpc, SettingsStreamRpc, SettingsMigrateLocalStorageRpc, UsageReportRpc, UsageOverviewRpc, UsageSessionsRpc, UsageLimitsRpc, UsageLimitsHistoryRpc, DiagnosticsExportRpc, DiagnosticsOverviewRpc, DiagnosticsEventsRpc, DiagnosticsProcessesRpc, DiagnosticsSignalRpc, DiagnosticsIngestRpc, DiagnosticsCaptureRpc, KeybindingsGetRpc, KeybindingsReplaceRpc, KeybindingsStreamRpc, SessionSetWorktreeRpc);
+const MemoizeRpcs = RpcGroup.make(PingRpc, AnalyticsGetContextRpc, AnalyticsContextChangesRpc, AuthGetSessionRpc, AuthSignInRpc, AuthSignOutRpc, AuthSessionChangesRpc, LinearListConnectionsRpc, LinearConnectRpc, LinearDisconnectRpc, LinearListIssuesRpc, LinearPrepareContextRpc, PairingStartRpc, PairingListTokensRpc, PairingRevokeTokenRpc, PairingListNearbyRequestsRpc, PairingResolveNearbyRequestRpc, ConnectHandshakeRpc, ConnectDescribeRpc, ConnectLinkProofRpc, ConnectRelayConfigRpc, RelayLinkRpc, RelayStatusRpc, RelayUnlinkRpc, EnvironmentsListRpc, EnvironmentConnectRpc, CloudBillingSummaryRpc, CloudBillingUsageRpc, CloudBillingSetCapRpc, CloudProvidersRpc, CloudProjectsListRpc, CloudProjectsConnectRpc, CloudProjectsPrepareRpc, CloudWorkspacesListRpc, CloudWorkspacesGetRpc, CloudWorkspacesWatchRpc, CloudWorkspacesCreateRpc, CloudWorkspacesConnectRpc, CloudChatsListRpc, CloudWorkspacesPauseRpc, CloudWorkspacesResumeRpc, CloudWorkspacesRestartRpc, CloudWorkspacesSshAccessRpc, CloudWorkspacesArchiveRpc, CloudWorkspacesUnarchiveRpc, CloudWorkspacesDeleteRpc, CloudTranscriptCheckpointGetRpc, CloudTranscriptMessagePageGetRpc, CloudCredentialsListRpc, CloudCredentialsImportLocalRpc, CloudCredentialsDisconnectRpc, MachinesOffersRpc, MachinesListRpc, MachinesGetRpc, MachinesCreateRpc, MachinesCancelRpc, MachinesRecoverRpc, MachinesDestroyRpc, MachinesCheckoutRpc, MachinesBillingPortalRpc, MachinesEntitlementsRpc, MachineSshKeysAddRpc, MachineSshKeysListRpc, MachineSshKeysRemoveRpc, MachinePrivateNetworkEnableRpc, MachinePrivateNetworkStatusRpc, MachineRuntimeTargetRpc, MachineRuntimeStatusRpc, MachineRuntimeUpdateRpc, MachineResourcesWatchRpc, MachineSshModeSetRpc, AccountAccessStatusRpc, AccountAccessDetectLocalRpc, AccountAccessStartLoginRpc, AccountAccessPrepareImportRpc, AccountAccessCreateClaudeTransferRpc, AccountAccessContinueClaudeTransferRpc, AccountAccessImportRpc, AccountAccessDisconnectRpc, RelayEnvironmentsRpc, RelayConnectEnvironmentRpc, RelayClientsRpc, RelayRevokeClientRpc, WorkspaceAddRpc, WorkspaceBrowseDirectoryRpc, WorkspaceListRpc, WorkspaceRemoveRpc, WorkspacePickFolderRpc, WorkspaceGetSelectedRpc, WorkspaceSetSelectedRpc, WorkspaceStreamChangesRpc, WorkspaceSearchFilesRpc, WorkspaceCloneRepoRpc, WorkspaceCreateProjectRpc, WorkspaceListGithubReposRpc, WorkspaceGhAuthStatusRpc, ExternalThreadsListRpc, ExternalThreadsContinueRpc, PtyOpenRpc, PtyWriteRpc, PtyResizeRpc, PtyCloseRpc, PtyOutputRpc, GitLogRpc, GitStatusRpc, GitBranchesRpc, GitSwitchBranchRpc, GitUserNameRpc, GitWorkspaceChangesRpc, GitOriginRpc, GitPrStateRpc, GitPrDetailsRpc, GitListPrsRpc, GitListIssuesRpc, GitIssueMarkdownRpc, GitChangesRpc, GitReviewSummaryRpc, GitReviewPatchesRpc, GitReviewFileContentsRpc, GitReviewIdentityRpc, GitDiffRpc, GitCommitRpc, GitCreateReviewCommentRpc, GitPushRpc, GitResolveConflictRpc, GitMergePrRpc, GitMarkReadyRpc, GitInitRpc, GitFixFailingChecksRpc, GitRevertFileRpc, GitRestoreFileToBaseRpc, GitRevertAllRpc, FsTreeRpc, FsWatchTreeRpc, FsListPathsRpc, FsMoveRpc, FsReadFileRpc, FsWriteFileRpc, FsCreateFileRpc, FsCreateDirectoryRpc, FsRemoveRpc, FsReadExternalFileRpc, FsWriteExternalFileRpc, ProviderAvailabilityRpc, ProviderRemoveCredentialRpc, ProviderSetCredentialRpc, ProviderOpencodeInventoryRpc, ProviderKiroInventoryRpc, ProviderOpencodeSetAuthRpc, ProviderOpencodeRemoveAuthRpc, ProviderOpencodeAddCustomRpc, ProviderOpencodeRemoveCustomRpc, ProviderStartLoginRpc, ProviderUpdateRpc, ChatArchivePreviewRpc, McpListRpc, McpRefreshRpc, McpSetEnabledRpc, McpAuthenticateRpc, ChatListRpc, ChatGetRpc, ChatCreateRpc, ChatCreationListRpc, ChatCreationStreamRpc, ChatCreationDiscardRpc, ChatRenameRpc, ChatMarkReadRpc, ChatStreamChangesRpc, ChatSetWorktreeRpc, ChatSetActiveSessionRpc, ChatArchiveRpc, ChatArchiveStatusRpc, ChatArchiveJobsRpc, ChatDirectoryStatusRpc, ChatUnarchiveRpc, ChatDeleteRpc, SessionListRpc, SessionStreamChangesRpc, SessionMcpUpdateRpc, SessionGetRpc, SessionCreateRpc, SessionRenameRpc, SessionGoalGetRpc, SessionGoalSetRpc, SessionGoalClearRpc, SessionGoalStreamRpc, SessionSetModelRpc, SessionSetProviderRpc, SessionArchiveRpc, SessionUnarchiveRpc, SessionDeleteRpc, SessionEventsHeadRpc, SessionEventsRpc, SessionMessagesPageRpc, SessionForkRpc, SessionExportTranscriptRpc, SessionLatestPlanRpc, SessionResumeRpc, SessionSetRuntimeModeRpc, SessionSetPermissionModeRpc, SessionAnswerQuestionRpc, SessionPlanRespondRpc, SessionSetWorktreeRpc, MessagesListRpc, MessagesSendRpc, MessagesInterruptRpc, MessagesQueueListRpc, MessagesQueueAddRpc, MessagesQueueUpdateRpc, MessagesQueueDeleteRpc, MessagesQueueRunNextRpc, MessagesQueueReorderRpc, MessagesQueueFlushRpc, MessagesQueueResumeRpc, AttachmentUploadRpc, ContextSaveTextRpc, SkillListRpc, SkillListForProjectRpc, SkillStreamRpc, PermissionRequestsRpc, PermissionDecideRpc, PermissionListPendingRpc, PermissionListDecisionsRpc, PermissionRevokeDecisionRpc, PokemonPokedexRpc, PokemonEnsureSpriteCachedRpc, BrowserCommandsRpc, BrowserRespondRpc, BrowserSetCredentialRpc, BrowserListCredentialsRpc, BrowserRemoveCredentialRpc, WorktreeCreateRpc, WorktreeListRpc, WorktreeGetRpc, WorktreeRenameBranchRpc, WorktreeRerunSetupRpc, WorktreeSetupStreamRpc, WorktreeStartRunRpc, WorktreeRemoveRpc, RepositorySettingsGetRpc, RepositorySettingsUpdateRpc, SettingsGetRpc, SettingsUpdateRpc, SettingsStreamRpc, SettingsMigrateLocalStorageRpc, UsageReportRpc, UsageOverviewRpc, UsageSessionsRpc, UsageLimitsRpc, UsageLimitsHistoryRpc, DiagnosticsExportRpc, DiagnosticsOverviewRpc, DiagnosticsEventsRpc, DiagnosticsProcessesRpc, DiagnosticsSignalRpc, DiagnosticsIngestRpc, DiagnosticsCaptureRpc, KeybindingsGetRpc, KeybindingsReplaceRpc, KeybindingsStreamRpc, SessionSetWorktreeRpc);
 //#endregion
 //#region ../contracts/src/serve.ts
 const ServeServiceState = Schema.Literals([
@@ -8007,7 +8146,7 @@ const authenticatedWsUrl = (options) => {
 	const base = options.wsBaseUrl?.trim();
 	const url = new URL(base && base.length > 0 ? base : wsUrl(options));
 	if (options.token?.trim()) url.searchParams.set("token", options.token.trim());
-	return withWireProtocolVersion(url.toString(), 4);
+	return withWireProtocolVersion(url.toString(), 5);
 };
 const wsClientProtocolLayer = (endpoint, options) => {
 	const makeWebSocket = options?.onClose === void 0 ? options?.makeWebSocket : observeWebSocketConstructor(options.makeWebSocket ?? ((url, protocols) => new globalThis.WebSocket(url, protocols)), options.onClose);
@@ -8015,6 +8154,7 @@ const wsClientProtocolLayer = (endpoint, options) => {
 };
 //#endregion
 //#region src/agent-cli.ts
+const commandId = (kind) => CommandId.make(`${kind}:${randomUUID()}`);
 const GROUPS = /* @__PURE__ */ new Set([
 	"commands",
 	"computer",
@@ -8120,9 +8260,16 @@ const promptFor = async (args, message = false) => {
 	if (file === void 0) return "";
 	return file === "-" ? readStdin() : readFile(resolve(file), "utf8");
 };
-const devCliAccess = async (env) => {
+const installedCliAccessCandidates = (env, platform = process.platform) => {
+	const configured = env.ZUSE_USER_DATA_DIR?.trim();
+	if (configured) return [join(resolve(configured), "cli-access.json")];
+	if (platform === "darwin") return [join(homedir(), "Library", "Application Support", "Zuse Alpha", "cli-access.json")];
+	if (platform === "win32" && env.APPDATA?.trim()) return [join(resolve(env.APPDATA), "Zuse Alpha", "cli-access.json")];
+	return [join(resolve(env.XDG_CONFIG_HOME?.trim() || join(homedir(), ".config")), "Zuse Alpha", "cli-access.json")];
+};
+const localCliAccess = async (env) => {
 	const explicit = env.ZUSE_DEV_CLI_ACCESS_FILE?.trim();
-	const candidates = explicit ? [resolve(explicit)] : [];
+	const candidates = explicit ? [resolve(explicit)] : [...installedCliAccessCandidates(env)];
 	let cursor = resolve(process.cwd());
 	while (true) {
 		const instance = env.ZUSE_DEV_INSTANCE?.trim() || "default";
@@ -8140,18 +8287,18 @@ const devCliAccess = async (env) => {
 const endpoint = async (args, env) => {
 	const computer = one(args, "computer") ?? "local";
 	if (computer !== "local" && one(args, "ws-url") === void 0) throw new CliError("computer_unavailable", "A connected computer requires --ws-url and, when protected, --token.", { computer });
-	const access = one(args, "ws-url") === void 0 && env.ZUSE_WS_URL === void 0 ? await devCliAccess(env) : null;
+	const access = one(args, "ws-url") === void 0 && env.ZUSE_WS_URL === void 0 ? await localCliAccess(env) : null;
 	const raw = one(args, "ws-url") ?? env.ZUSE_WS_URL ?? access?.wsUrl ?? `ws://127.0.0.1:${env.ZUSE_PORT ?? "47837"}/rpc`;
 	const url = new URL(raw);
 	if (url.pathname === "/") url.pathname = "/rpc";
-	url.searchParams.set("wireVersion", String(4));
+	url.searchParams.set("wireVersion", String(5));
 	const token = one(args, "token") ?? env.ZUSE_TOKEN ?? access?.token;
 	if (token !== void 0) url.searchParams.set("token", token);
 	return url.toString();
 };
 const connect = async (args, env) => {
 	return makeRpcClientSession(wsClientProtocolLayer(await endpoint(args, env)), MemoizeRpcs, {
-		protocolVersion: 4,
+		protocolVersion: 5,
 		perform: (client, hello) => client["connect.handshake"](hello)
 	});
 };
@@ -8524,6 +8671,7 @@ const execute = async (argv, env) => {
 				permissionMode: permission(args)
 			}));
 			if (prompt || context.attachments.length || context.fileRefs.length) await rpc(client["messages.send"]({
+				commandId: commandId("message-send"),
 				sessionId: created.id,
 				input: composer(prompt, context)
 			}));
@@ -8570,6 +8718,7 @@ const execute = async (argv, env) => {
 			return { session: await rpc(client["session.get"]({ sessionId: selectedSessionId })) };
 		}
 		if (group === "session" && action === "rename") return { session: await rpc(client["session.rename"]({
+			commandId: commandId("session-rename"),
 			sessionId: selectedSessionId,
 			title: required(one(args, "title"), "--title")
 		})) };
@@ -8599,14 +8748,17 @@ const execute = async (argv, env) => {
 			const context = await contextFor(client, args, selectedSessionId, project);
 			const text = await promptFor(args, true);
 			if (one(args, "permission")) await rpc(client["session.setPermissionMode"]({
+				commandId: commandId("session-permission-mode"),
 				sessionId: selectedSessionId,
 				mode: permission(args)
 			}));
 			if (one(args, "runtime")) await rpc(client["session.setRuntimeMode"]({
+				commandId: commandId("session-runtime-mode"),
 				sessionId: selectedSessionId,
 				runtimeMode: runtime(args)
 			}));
 			await rpc(client["messages.send"]({
+				commandId: commandId("message-send"),
 				sessionId: selectedSessionId,
 				input: composer(text, context)
 			}));
@@ -8652,6 +8804,7 @@ const execute = async (argv, env) => {
 			const input = composer(await promptFor(args, true), context);
 			if (action === "queue-add") return {
 				item: await rpc(client["messages.queue.add"]({
+					commandId: commandId("queue-add"),
 					sessionId: selectedSessionId,
 					input,
 					...one(args, "queue") ? { queueId: one(args, "queue") } : {},
@@ -8662,6 +8815,7 @@ const execute = async (argv, env) => {
 			};
 			return {
 				item: await rpc(client["messages.queue.update"]({
+					commandId: commandId("queue-update"),
 					sessionId: selectedSessionId,
 					queueId: required(one(args, "queue"), "--queue"),
 					input
@@ -8672,6 +8826,7 @@ const execute = async (argv, env) => {
 		if (group === "session" && action === "queue-delete") {
 			const queueId = required(one(args, "queue"), "--queue");
 			await rpc(client["messages.queue.delete"]({
+				commandId: commandId("queue-delete"),
 				sessionId: selectedSessionId,
 				queueId
 			}));
@@ -8682,12 +8837,14 @@ const execute = async (argv, env) => {
 			};
 		}
 		if (group === "session" && action === "queue-reorder") return { items: await rpc(client["messages.queue.reorder"]({
+			commandId: commandId("queue-reorder"),
 			sessionId: selectedSessionId,
 			queueIds: many(args, "queue")
 		})) };
 		if (group === "session" && action === "queue-run-next") {
 			const queueId = required(one(args, "queue"), "--queue");
 			await rpc(client["messages.queue.runNext"]({
+				commandId: commandId("queue-run-next"),
 				sessionId: selectedSessionId,
 				queueId
 			}));
@@ -8698,14 +8855,20 @@ const execute = async (argv, env) => {
 			};
 		}
 		if (group === "session" && action === "queue-flush") {
-			await rpc(client["messages.queue.flush"]({ sessionId: selectedSessionId }));
+			await rpc(client["messages.queue.flush"]({
+				commandId: commandId("queue-flush"),
+				sessionId: selectedSessionId
+			}));
 			return {
 				sessionId: selectedSessionId,
 				flushed: true
 			};
 		}
 		if (group === "session" && action === "queue-resume") {
-			await rpc(client["messages.queue.resume"]({ sessionId: selectedSessionId }));
+			await rpc(client["messages.queue.resume"]({
+				commandId: commandId("queue-resume"),
+				sessionId: selectedSessionId
+			}));
 			return {
 				sessionId: selectedSessionId,
 				resumed: true
@@ -8714,17 +8877,22 @@ const execute = async (argv, env) => {
 		if (group === "session" && action === "mode") {
 			if (!one(args, "permission") && !one(args, "runtime")) throw new CliError("invalid_input", "session mode requires --permission or --runtime.");
 			if (one(args, "permission")) await rpc(client["session.setPermissionMode"]({
+				commandId: commandId("session-permission-mode"),
 				sessionId: selectedSessionId,
 				mode: permission(args)
 			}));
 			if (one(args, "runtime")) await rpc(client["session.setRuntimeMode"]({
+				commandId: commandId("session-runtime-mode"),
 				sessionId: selectedSessionId,
 				runtimeMode: runtime(args)
 			}));
 			return { session: await rpc(client["session.get"]({ sessionId: selectedSessionId })) };
 		}
 		if (group === "session" && action === "interrupt") {
-			await rpc(client["messages.interrupt"]({ sessionId: selectedSessionId }));
+			await rpc(client["messages.interrupt"]({
+				commandId: commandId("message-interrupt"),
+				sessionId: selectedSessionId
+			}));
 			return {
 				sessionId: selectedSessionId,
 				interrupted: true
@@ -8753,4 +8921,4 @@ const runServeCli = async (argv, env = process.env) => {
 //#endregion
 export { runServeCli as t };
 
-//# sourceMappingURL=cli-Cz9Ua4SV.mjs.map
+//# sourceMappingURL=cli-BKZzhoKT.mjs.map