ryco-cli 0.1.30 → 0.1.31

package/dist/{src-CARHuYkT.cjs → src-FmeCeBJ9.cjs}

@@ -285,6 +285,10 @@ const ExecutionEnvironmentCapabilities = effect.Schema.Struct({
 	threadSettlement: effect.Schema.Boolean.pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(false))),
 	threadPriorityRanking: effect.Schema.Boolean.pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(false))),
 	worktreeSubmoduleSettings: effect.Schema.optionalKey(effect.Schema.Boolean),
+	/** Usage-limit settings and the resume/snooze worker; absent on older servers. */
+	usageLimitRecovery: effect.Schema.optionalKey(effect.Schema.Boolean),
+	/** Server-owned worktree notes (`notes.list` / `notes.command`); absent on older servers. */
+	worktreeNotes: effect.Schema.optionalKey(effect.Schema.Boolean),
 	fileAttachments: effect.Schema.optional(effect.Schema.Struct({ maxUploadBytes: NonNegativeInt }))
 });
 const ExecutionEnvironmentDescriptor = effect.Schema.Struct({
@@ -1832,6 +1836,12 @@ const DESKTOP_NATIVE_NODE_CLAIM_DESCRIPTOR_PATH = "/api/desktop/hub/native-node-
 const DESKTOP_NATIVE_NODE_CLAIM_SIGN_PATH = "/api/desktop/hub/native-node-claim/sign";
 const DESKTOP_NATIVE_NODE_CLAIM_COMMIT_PATH = "/api/desktop/hub/native-node-claim/commit";
 const DESKTOP_NATIVE_NODE_CLAIM_MAX_BODY_BYTES = 16384;
+/**
+* Desktop main asks its own backend, over the same per-child local control
+* channel, whether other devices can reach this node through the Hub, to keep
+* the machine awake only while they can.
+*/
+const DESKTOP_HUB_REACHABILITY_PATH = "/api/desktop/hub/reachability";
 const strict = (schema) => schema.annotate({ parseOptions: { onExcessProperty: "error" } });
 strict(effect.Schema.Struct({
 	protocolVersion: effect.Schema.Literal(1),
@@ -1869,6 +1879,15 @@ strict(effect.Schema.Struct({
 	status: effect.Schema.Literal("active"),
 	result: NativeNodeClaimFinishResponse
 }));
+strict(effect.Schema.Struct({
+	protocolVersion: effect.Schema.Literal(1),
+	reachable: effect.Schema.Boolean,
+	/**
+	* Whether the backend runs its connector at all. A standby launch can
+	* resolve to off, which only a relaunch with an explicit enable changes.
+	*/
+	connectorEnabled: effect.Schema.Boolean
+}));
 strict(effect.Schema.Struct({ error: effect.Schema.Literals([
 	"native_node_claim_unavailable",
 	"native_node_claim_rejected",
@@ -2556,6 +2575,14 @@ const MODEL_SLUG_ALIASES_BY_PROVIDER = {
 	[GROK_DRIVER_KIND]: {},
 	[OPENCODE_DRIVER_KIND]: {}
 };
+const PROVIDER_DISPLAY_NAMES = {
+	[CODEX_DRIVER_KIND]: "Codex",
+	[CLAUDE_DRIVER_KIND]: "Claude",
+	[COPILOT_DRIVER_KIND]: "GitHub Copilot",
+	[CURSOR_DRIVER_KIND]: "Cursor",
+	[GROK_DRIVER_KIND]: "Grok",
+	[OPENCODE_DRIVER_KIND]: "OpenCode"
+};
 const ThreadPriorityTier = effect.Schema.Literals([
 	"now",
 	"soon",
@@ -2762,13 +2789,67 @@ const SourceControlCheckRollupItem = effect.Schema.Struct({
 	conclusion: effect.Schema.Option(TrimmedNonEmptyString),
 	url: effect.Schema.Option(TrimmedNonEmptyString),
 	startedAt: effect.Schema.Option(effect.Schema.DateTimeUtc),
-	completedAt: effect.Schema.Option(effect.Schema.DateTimeUtc)
+	completedAt: effect.Schema.Option(effect.Schema.DateTimeUtc),
+	/**
+	* The base branch's protection requires this check to pass before merging.
+	* Absent when the host did not say (list rows, hosts without the concept,
+	* or a failed lookup), which is not the same as `false`.
+	*/
+	isRequired: effect.Schema.optional(effect.Schema.Boolean)
 });
 const SourceControlLabel = effect.Schema.Struct({
 	name: TrimmedNonEmptyString,
 	color: effect.Schema.optional(TrimmedNonEmptyString),
 	description: effect.Schema.optional(TrimmedNonEmptyString)
 });
+/** Aggregate review verdict as reported by the host (GitHub `reviewDecision`). */
+const SourceControlChangeRequestReviewDecision = effect.Schema.Literals([
+	"approved",
+	"changes_requested",
+	"review_required"
+]);
+/**
+* Why a change request can or cannot merge right now (GitHub `mergeStateStatus`,
+* lower-cased). `behind` means the head needs the base merged in; `blocked`
+* means required reviews or checks are missing; `dirty` means conflicts.
+*/
+const SourceControlChangeRequestMergeStateStatus = effect.Schema.Literals([
+	"behind",
+	"blocked",
+	"clean",
+	"dirty",
+	"draft",
+	"has_hooks",
+	"unknown",
+	"unstable"
+]);
+/** One reviewer's latest standing on a change request. `requested` = asked, not yet reviewed. */
+const SourceControlChangeRequestReviewerState = effect.Schema.Literals([
+	"approved",
+	"changes_requested",
+	"commented",
+	"dismissed",
+	"requested"
+]);
+const SourceControlChangeRequestReviewer = effect.Schema.Struct({
+	/** User login, or `org/team-slug` for team review requests. */
+	login: TrimmedNonEmptyString,
+	kind: effect.Schema.Literals([
+		"user",
+		"team",
+		"bot"
+	]),
+	state: SourceControlChangeRequestReviewerState,
+	avatarUrl: effect.Schema.optional(effect.Schema.String),
+	submittedAt: effect.Schema.optional(effect.Schema.DateTimeUtc),
+	/** True when the request came from CODEOWNERS. */
+	isCodeOwner: effect.Schema.optional(effect.Schema.Boolean)
+});
+const SourceControlChangeRequestAutoMerge = effect.Schema.Struct({
+	mergeMethod: SourceControlChangeRequestMergeMethod,
+	enabledBy: effect.Schema.optional(TrimmedNonEmptyString),
+	enabledAt: effect.Schema.optional(effect.Schema.DateTimeUtc)
+});
 const ChangeRequest = effect.Schema.Struct({
 	provider: SourceControlProviderKind,
 	number: PositiveInt,
@@ -2788,8 +2869,20 @@ const ChangeRequest = effect.Schema.Struct({
 	headRepositoryOwnerLogin: effect.Schema.optional(effect.Schema.NullOr(TrimmedNonEmptyString)),
 	headSha: effect.Schema.optional(TrimmedNonEmptyString),
 	mergeability: effect.Schema.optional(SourceControlChangeRequestMergeability),
+	/**
+	* Why it can or cannot merge right now. Always on the detail where the host
+	* reports readiness; on list rows only where the list payload carries it
+	* (GitLab's `detailed_merge_status`).
+	*/
+	mergeStateStatus: effect.Schema.optional(SourceControlChangeRequestMergeStateStatus),
 	checkRollup: effect.Schema.optional(effect.Schema.Array(SourceControlCheckRollupItem)),
-	stackSummary: effect.Schema.optional(SourceControlChangeRequestStackSummary)
+	stackSummary: effect.Schema.optional(SourceControlChangeRequestStackSummary),
+	createdAt: effect.Schema.optional(effect.Schema.DateTimeUtc),
+	reviewDecision: effect.Schema.optional(effect.Schema.NullOr(SourceControlChangeRequestReviewDecision)),
+	additions: effect.Schema.optional(NonNegativeInt),
+	deletions: effect.Schema.optional(NonNegativeInt),
+	/** Files touched (list rows waiting on the viewer's review show it). */
+	changedFiles: effect.Schema.optional(NonNegativeInt)
 });
 const SOURCE_CONTROL_DETAIL_BODY_MAX_BYTES = 8192;
 const SOURCE_CONTROL_DETAIL_COMMENT_BODY_MAX_BYTES = 2048;
@@ -2874,11 +2967,11 @@ const SourceControlCreateIssueInput = effect.Schema.Struct({
 	assignees: effect.Schema.optional(effect.Schema.Array(TrimmedNonEmptyString)),
 	worktree: effect.Schema.optional(SourceControlCreateIssueWorktree)
 });
-const NonBlankMarkdownBody = effect.Schema.String.check(effect.Schema.makeFilter((body) => body.trim().length > 0 ? void 0 : "Expected a non-blank Markdown body"));
+const NonBlankMarkdownBody$1 = effect.Schema.String.check(effect.Schema.makeFilter((body) => body.trim().length > 0 ? void 0 : "Expected a non-blank Markdown body"));
 const SourceControlAddIssueCommentInput = effect.Schema.Struct({
 	cwd: TrimmedNonEmptyString,
 	reference: TrimmedNonEmptyString,
-	body: NonBlankMarkdownBody,
+	body: NonBlankMarkdownBody$1,
 	clientMutationId: effect.Schema.optional(TrimmedNonEmptyString)
 });
 const SourceControlAddIssueCommentResult = effect.Schema.Struct({ detail: SourceControlIssueDetail });
@@ -2924,12 +3017,24 @@ const SourceControlChangeRequestDetail = effect.Schema.Struct({
 	files: effect.Schema.optional(effect.Schema.Array(SourceControlChangeRequestFile)),
 	stack: effect.Schema.optional(SourceControlChangeRequestStack),
 	stackMetadataIncomplete: effect.Schema.optional(effect.Schema.Boolean),
-	mergeCapabilities: effect.Schema.optional(SourceControlChangeRequestMergeCapabilities)
+	mergeCapabilities: effect.Schema.optional(SourceControlChangeRequestMergeCapabilities),
+	/** Per-reviewer latest state, including pending (requested) reviewers. */
+	reviewerStates: effect.Schema.optional(effect.Schema.Array(SourceControlChangeRequestReviewer)),
+	autoMerge: effect.Schema.optional(effect.Schema.NullOr(SourceControlChangeRequestAutoMerge)),
+	closedAt: effect.Schema.optional(effect.Schema.DateTimeUtc),
+	mergedAt: effect.Schema.optional(effect.Schema.DateTimeUtc),
+	mergedBy: effect.Schema.optional(TrimmedNonEmptyString),
+	/** True when the host deletes the head branch automatically after merge. */
+	deleteBranchOnMerge: effect.Schema.optional(effect.Schema.Boolean)
 });
 const SourceControlMergeChangeRequestInput = effect.Schema.Struct({
 	cwd: TrimmedNonEmptyString,
 	reference: TrimmedNonEmptyString,
-	mergeMethod: SourceControlChangeRequestMergeMethod
+	mergeMethod: SourceControlChangeRequestMergeMethod,
+	/** Delete the head branch after a successful (non-queued) merge. */
+	deleteBranch: effect.Schema.optional(effect.Schema.Boolean),
+	/** Refuse to merge when the head moved since the user looked. */
+	expectedHeadSha: effect.Schema.optional(TrimmedNonEmptyString)
 });
 const SourceControlMergeChangeRequestResult = effect.Schema.Struct({ outcome: effect.Schema.Literals(["merged", "enqueued"]) });
 const SOURCE_CONTROL_WORKFLOW_LOG_MAX_BYTES = 204800;
@@ -2946,6 +3051,12 @@ const SourceControlWorkflowRun = effect.Schema.Struct({
 	branch: effect.Schema.Option(TrimmedNonEmptyString),
 	event: effect.Schema.optional(TrimmedNonEmptyString),
 	commit: SourceControlWorkflowRunCommit,
+	/**
+	* The change request head this run verifies when `commit` is not the head
+	* itself but a merge of it into the target (GitLab merged-results and
+	* merge-train pipelines). Absent when the run is on the head commit.
+	*/
+	sourceHeadOid: effect.Schema.optional(TrimmedNonEmptyString),
 	actor: effect.Schema.Option(TrimmedNonEmptyString),
 	status: TrimmedNonEmptyString,
 	conclusion: effect.Schema.Option(TrimmedNonEmptyString),
@@ -3034,7 +3145,7 @@ const SourceControlWorkflowRerunResult = effect.Schema.Struct({
 const SourceControlAddChangeRequestCommentInput = effect.Schema.Struct({
 	cwd: TrimmedNonEmptyString,
 	reference: TrimmedNonEmptyString,
-	body: NonBlankMarkdownBody,
+	body: NonBlankMarkdownBody$1,
 	clientMutationId: effect.Schema.optional(TrimmedNonEmptyString)
 });
 const SourceControlAddChangeRequestCommentResult = effect.Schema.Struct({ detail: SourceControlChangeRequestDetail });
@@ -3511,6 +3622,8 @@ const StatusBucket = effect.Schema.Literals([
 	"done"
 ]);
 const WorktreeCheckoutLocation = effect.Schema.Literals(["appManaged", "projectMetadata"]);
+/** Why a workspace record no longer has a checkout: removed by Ryco, or found missing. */
+const WorktreeCheckoutRemovalReason = effect.Schema.Literals(["removed", "missing"]);
 const Worktree = effect.Schema.Struct({
 	worktreeId: WorktreeId,
 	projectId: ProjectId,
@@ -3525,6 +3638,12 @@ const Worktree = effect.Schema.Struct({
 	prState: effect.Schema.optional(effect.Schema.NullOr(PullRequestState)).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
 	prIsDraft: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.Boolean)).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
 	issueState: effect.Schema.optional(effect.Schema.NullOr(IssueState)).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
+	/**
+	* When the PR reached its current merged/closed state (forge time, else first
+	* observation). `null` while open, unknown, or absent. No decoding default:
+	* an absent key means the server predates the field (legacy settlement rule).
+	*/
+	prTerminalAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
 	workItemProvider: effect.Schema.optional(effect.Schema.NullOr(WorkItemProviderKind)).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
 	workItemKey: effect.Schema.optional(effect.Schema.NullOr(TrimmedNonEmptyString)).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
 	workItemTitle: effect.Schema.optional(effect.Schema.NullOr(TrimmedNonEmptyString)).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
@@ -3534,6 +3653,12 @@ const Worktree = effect.Schema.Struct({
 	createdAt: IsoDateTime,
 	updatedAt: IsoDateTime,
 	archivedAt: effect.Schema.NullOr(IsoDateTime),
+	/**
+	* Set once the physical checkout is gone (removed or found missing). The record,
+	* `worktreePath` and `branch` stay as provenance. Optional so older peers decode.
+	*/
+	checkoutRemovedAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
+	checkoutRemovalReason: effect.Schema.optional(effect.Schema.NullOr(WorktreeCheckoutRemovalReason)),
 	manualPosition: effect.Schema.Number
 });
 const CreateWorktreeIntent = effect.Schema.Union([
@@ -3655,6 +3780,13 @@ const CONTEXT_HANDOFF_ERROR_MAX_CHARS = 2e3;
 const CONTEXT_HANDOFF_INSPECTION_MAX_RESPONSE_BYTES = 131072;
 const CONTEXT_HANDOFF_INSPECTION_CHUNK_MAX_BYTES = 98304;
 const ContextHandoffMode = effect.Schema.Literal("full-context-fresh-session");
+/**
+* Why a thread handed its context to a fresh session:
+* - `model-change`: the user switched to another provider instance.
+* - `cwd-relocation`: the thread's working directory moved (for example, a chat became a project)
+*   and the provider cannot resume its conversation there.
+*/
+const ContextHandoffReason = effect.Schema.Literals(["model-change", "cwd-relocation"]);
 const ContextHandoffEndpointSnapshot = effect.Schema.Struct({
 	providerInstanceId: ProviderInstanceId,
 	driverKind: ProviderDriverKind,
@@ -3680,6 +3812,8 @@ const ContextHandoffActivityBaseFields = {
 	schemaVersion: effect.Schema.Literal(1),
 	handoffId: ContextHandoffId,
 	mode: ContextHandoffMode,
+	/** Absent on records written before reasons existed: those are model changes. */
+	reason: effect.Schema.optional(ContextHandoffReason),
 	targetMessageId: MessageId,
 	targetTurnId: effect.Schema.optional(TurnId),
 	sourceSelection: ModelSelection,
@@ -3735,6 +3869,44 @@ const ContextHandoffActivityPayload = effect.Schema.Union([
 		inspection: effect.Schema.optional(ContextHandoffInspectionSummaryMetadata)
 	})
 ]);
+/**
+* Lifecycle activity journaling one checkpoint revert. Its id is
+* `checkpoint-revert:<revertRequestId>`; every phase replaces the same row.
+*/
+const CHECKPOINT_REVERT_ACTIVITY_KIND = "checkpoint.revert";
+const CheckpointRevertStatus = effect.Schema.Literals([
+	"requested",
+	"rolling-back",
+	"restoring-files",
+	"completed",
+	"files-not-restored",
+	"failed",
+	"interrupted"
+]);
+const CheckpointRevertFailureReason = effect.Schema.Literals([
+	"thread-busy",
+	"target-unavailable",
+	"handoff-boundary",
+	"not-git",
+	"shared-checkout",
+	"provider-unsupported",
+	"provider-failed",
+	"files-failed",
+	"restart",
+	"internal-error"
+]);
+const CheckpointRevertActivityPayload = effect.Schema.Struct({
+	schemaVersion: effect.Schema.Literal(1),
+	revertRequestId: CommandId,
+	/** Target checkpoint K. */
+	turnCount: NonNegativeInt,
+	fromTurnCount: effect.Schema.optional(NonNegativeInt),
+	status: CheckpointRevertStatus,
+	reason: effect.Schema.optional(CheckpointRevertFailureReason),
+	detail: effect.Schema.optional(TrimmedNonEmptyString),
+	/** Restore cwd, recorded from "rolling-back" on so startup recovery can finish. */
+	cwd: effect.Schema.optional(TrimmedNonEmptyString)
+});
 const ContextHandoffInspectionScope = effect.Schema.Literals(["sent", "complete"]);
 const ContextHandoffInspectionSection = effect.Schema.Literals([
 	"messages",
@@ -3946,6 +4118,25 @@ const UploadChatImageAttachment = effect.Schema.Struct({
 	sizeBytes: NonNegativeInt.check(effect.Schema.isLessThanOrEqualTo(PROVIDER_SEND_TURN_MAX_IMAGE_BYTES)),
 	dataUrl: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(PROVIDER_SEND_TURN_MAX_IMAGE_DATA_URL_CHARS))
 });
+/**
+* Marks a `text/html` file attachment as an agent HTML render: a page the agent
+* published with `ryco_html_render` for clients to show inline in the thread.
+* Deliberately loose (any finite numbers, no length caps) so a newer server's
+* metadata can never fail an older client's decode; `@ryco/shared/htmlRender`
+* `readHtmlRenderMetadata` clamps it before use.
+*/
+const ChatHtmlRenderMetadata = effect.Schema.Struct({
+	title: effect.Schema.String,
+	/** The agent's frame height in CSS pixels, and the cap on any measured height. */
+	height: effect.Schema.Finite,
+	/** `[width, contentHeight]` pairs measured at publish; absent when not measured. */
+	heights: effect.Schema.optional(effect.Schema.Array(effect.Schema.Tuple([effect.Schema.Finite, effect.Schema.Finite]))),
+	/** Small `data:image/...` screenshots of the page's top per appearance; absent when not captured. */
+	thumbnails: effect.Schema.optional(effect.Schema.Struct({
+		dark: effect.Schema.optional(effect.Schema.String),
+		light: effect.Schema.optional(effect.Schema.String)
+	}))
+});
 const ChatFileAttachment = effect.Schema.Struct({
 	type: effect.Schema.Literal("file"),
 	id: ChatAttachmentId,
@@ -3953,7 +4144,8 @@ const ChatFileAttachment = effect.Schema.Struct({
 	mimeType: ChatAttachmentMimeType,
 	sizeBytes: NonNegativeInt.check(effect.Schema.isLessThanOrEqualTo(PROVIDER_SEND_TURN_MAX_FILE_BYTES)),
 	width: effect.Schema.optional(NonNegativeInt),
-	height: effect.Schema.optional(NonNegativeInt)
+	height: effect.Schema.optional(NonNegativeInt),
+	htmlRender: effect.Schema.optional(ChatHtmlRenderMetadata)
 });
 const CHAT_ATTACHMENT_READ_CHUNK_BYTES = 262144;
 const ChatAttachmentReadChunkInput = effect.Schema.Struct({
@@ -4031,8 +4223,18 @@ const ProjectScript = effect.Schema.Struct({
 const ProjectCustomSystemPrompt = TrimmedNonEmptyString.check(effect.Schema.isMaxLength(2e4));
 const DEFAULT_PROJECT_METADATA_DIR = ".ryco";
 const ProjectMetadataDir = TrimmedNonEmptyString.check(effect.Schema.isMaxLength(256), effect.Schema.isPattern(/^(?![\\/])(?!~)(?![A-Za-z]:[\\/])(?!.*(?:^|[\\/])\.\.(?:[\\/]|$)).+$/));
+/**
+* `chat` backs a "No project" chat: one project record per chat, rooted in a Ryco-managed
+* plain folder under the chats root. Promotion turns it into a regular `project`, never back.
+* Read it through `@ryco/shared/projectKind`, which treats an absent kind as `project`.
+*/
+const ProjectKind = effect.Schema.Literals(["project", "chat"]);
+const DEFAULT_PROJECT_KIND = "project";
+/** Absent on snapshots, events and nodes that predate chats; those only had regular projects. */
+const OptionalProjectKind = effect.Schema.optional(ProjectKind).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(DEFAULT_PROJECT_KIND)));
 const OrchestrationProject = effect.Schema.Struct({
 	id: ProjectId,
+	kind: OptionalProjectKind,
 	title: TrimmedNonEmptyString,
 	workspaceRoot: TrimmedNonEmptyString,
 	projectMetadataDir: effect.Schema.optional(ProjectMetadataDir).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(DEFAULT_PROJECT_METADATA_DIR))),
@@ -4052,6 +4254,19 @@ const OrchestrationMessageRole = effect.Schema.Literals([
 	"system"
 ]);
 const TurnDispatchMode = effect.Schema.Literals(["queue", "steer"]);
+/**
+* Why a steer was not applied. `deferred`: the message stays queued and is sent as the next turn
+* (the turn ended, or the provider could not take it right now). `failed`: a real provider error.
+* Absent on older events, which read as `failed`.
+*/
+const TurnSteerRejectionReason = effect.Schema.Literals(["deferred", "failed"]);
+/**
+* Set on a `failed` steer rejection the provider may still have received (a restart cut off its
+* delivery). Clients hold such a message for an explicit retry or removal instead of sending it
+* again as the next turn. An optional flag rather than a third reason, so older clients that
+* decode the event keep working and read it as a plain failure.
+*/
+const TurnSteerDeliveryUncertain = effect.Schema.optionalKey(effect.Schema.Boolean);
 const OrchestrationMessage = effect.Schema.Struct({
 	id: MessageId,
 	role: OrchestrationMessageRole,
@@ -4142,6 +4357,31 @@ const OrchestrationLatestTurnState = effect.Schema.Literals([
 	"completed",
 	"error"
 ]);
+/**
+* Frozen set of states a turn can end in. New outcomes (for example usage limits)
+* go into `reason` or a separate field, never into this literal set.
+*/
+const OrchestrationTerminalTurnState = effect.Schema.Literals([
+	"completed",
+	"error",
+	"interrupted"
+]);
+/** Server-internal: what the caller knows about how the active turn ended. */
+const OrchestrationTurnOutcome = effect.Schema.Struct({
+	/** Omitted = "the turn this release ends", whichever it is. */
+	turnId: effect.Schema.optional(TurnId),
+	state: OrchestrationTerminalTurnState,
+	/** Open diagnostic string (see TURN_FINALIZATION_REASON). Never a closed literal set. */
+	reason: TrimmedNonEmptyString,
+	completedAt: effect.Schema.optional(IsoDateTime)
+});
+/** Decided by the server: the turn this session-set releases, and how it ended. */
+const OrchestrationReleasedTurn = effect.Schema.Struct({
+	turnId: TurnId,
+	state: OrchestrationTerminalTurnState,
+	completedAt: IsoDateTime,
+	reason: TrimmedNonEmptyString
+});
 const OrchestrationLatestTurn = effect.Schema.Struct({
 	userMessageId: effect.Schema.optional(MessageId),
 	turnId: TurnId,
@@ -4152,6 +4392,42 @@ const OrchestrationLatestTurn = effect.Schema.Struct({
 	assistantMessageId: effect.Schema.NullOr(MessageId),
 	sourceProposedPlan: effect.Schema.optional(SourceProposedPlanReference)
 });
+const ThreadUsageLimitId = TrimmedNonEmptyString.check(effect.Schema.isMaxLength(512));
+/**
+* A provider usage limit stopped this thread's turn. Durable until a turn starts, the
+* thread is archived or reverted; it only gates the thread while
+* `modelSelection.instanceId === providerInstanceId`.
+*/
+const ThreadUsageLimit = effect.Schema.Struct({
+	/** "usage-limit:<threadId>:<turnId>" */
+	limitId: ThreadUsageLimitId,
+	provider: ProviderDriverKind,
+	providerInstanceId: ProviderInstanceId,
+	turnId: TurnId,
+	message: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(1e3)),
+	limitedAt: IsoDateTime,
+	resetAt: effect.Schema.NullOr(IsoDateTime),
+	/** null follows ServerSettings.autoResumeLimitedThreads; a boolean is an explicit per-thread override. */
+	autoResume: effect.Schema.NullOr(effect.Schema.Boolean),
+	updatedAt: IsoDateTime
+});
+/** Accepts the resume turn only while this exact limit is still recorded and idle. */
+const UsageLimitResumeGuard = effect.Schema.Struct({
+	limitId: ThreadUsageLimitId,
+	origin: effect.Schema.Literals(["auto", "manual"])
+});
+/**
+* Server-owned provenance of a thread created on behalf of another thread.
+* Absent on root threads. Immutable for a thread incarnation. Never authority.
+* `relationship` is deliberately an open string: a newer server may add kinds
+* without failing older clients' shell decode. Clients must treat values they
+* do not know as "no known relationship". Known values: "delegated".
+*/
+const ThreadLineage = effect.Schema.Struct({
+	parentThreadId: ThreadId,
+	rootThreadId: ThreadId,
+	relationship: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(64))
+});
 const OrchestrationThread = effect.Schema.Struct({
 	id: ThreadId,
 	projectId: ProjectId,
@@ -4167,6 +4443,8 @@ const OrchestrationThread = effect.Schema.Struct({
 	manualPosition: effect.Schema.optional(effect.Schema.Number),
 	latestTurn: effect.Schema.NullOr(OrchestrationLatestTurn),
 	goal: effect.Schema.optional(effect.Schema.NullOr(ThreadGoal)).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
+	/** Server-owned provenance; absent on root threads and from older servers. */
+	lineage: effect.Schema.optional(effect.Schema.NullOr(ThreadLineage)),
 	createdAt: IsoDateTime,
 	updatedAt: IsoDateTime,
 	archivedAt: effect.Schema.NullOr(IsoDateTime).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
@@ -4174,14 +4452,25 @@ const OrchestrationThread = effect.Schema.Struct({
 	settledAt: effect.Schema.NullOr(IsoDateTime).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
 	snoozedUntil: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
 	snoozedAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
+	/** Optional so mixed-version snapshots decode; older clients strip it. */
+	usageLimit: effect.Schema.optional(effect.Schema.NullOr(ThreadUsageLimit)),
+	/**
+	* Hidden from every live view. A trashed thread also carries `trashedAt` and keeps
+	* its history and assets; without `trashedAt` the deletion is permanent.
+	*/
 	deletedAt: effect.Schema.NullOr(IsoDateTime),
+	trashedAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
 	messages: effect.Schema.Array(OrchestrationMessage),
 	proposedPlans: effect.Schema.Array(OrchestrationProposedPlan).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed([]))),
 	activities: effect.Schema.Array(OrchestrationThreadActivity),
 	checkpoints: effect.Schema.Array(OrchestrationCheckpointSummary),
 	session: effect.Schema.NullOr(OrchestrationSession)
 });
-const OrchestrationWorktreeShell = Worktree;
+const OrchestrationWorktreeShell = effect.Schema.Struct({
+	...Worktree.fields,
+	/** Retired managed path, so persisted drafts can retarget after a cold reconnect. */
+	relocatedFromPath: effect.Schema.optional(effect.Schema.NullOr(TrimmedNonEmptyString))
+});
 const OrchestrationReadModel = effect.Schema.Struct({
 	snapshotSequence: NonNegativeInt,
 	projects: effect.Schema.Array(OrchestrationProject),
@@ -4191,6 +4480,7 @@ const OrchestrationReadModel = effect.Schema.Struct({
 });
 const OrchestrationProjectShell = effect.Schema.Struct({
 	id: ProjectId,
+	kind: OptionalProjectKind,
 	title: TrimmedNonEmptyString,
 	workspaceRoot: TrimmedNonEmptyString,
 	projectMetadataDir: effect.Schema.optional(ProjectMetadataDir).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(DEFAULT_PROJECT_METADATA_DIR))),
@@ -4236,6 +4526,8 @@ const OrchestrationThreadShell = effect.Schema.Struct({
 	settledAt: effect.Schema.NullOr(IsoDateTime).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(null))),
 	snoozedUntil: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
 	snoozedAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
+	/** Optional so mixed-version snapshots decode; older clients strip it. */
+	usageLimit: effect.Schema.optional(effect.Schema.NullOr(ThreadUsageLimit)),
 	session: effect.Schema.NullOr(OrchestrationSession),
 	latestUserMessageAt: effect.Schema.NullOr(IsoDateTime),
 	/** Last successful turn that is no longer active; absent on older servers. */
@@ -4249,6 +4541,8 @@ const OrchestrationThreadShell = effect.Schema.Struct({
 	* live work. Optional so old servers/clients interop; absent = none.
 	*/
 	backgroundLiveness: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.Literals(["working", "monitoring"]))),
+	/** Server-owned provenance; absent on root threads and from older servers. */
+	lineage: effect.Schema.optional(effect.Schema.NullOr(ThreadLineage)),
 	priority: effect.Schema.optional(ThreadPriorityProjectedRanking)
 });
 const OrchestrationShellSnapshot = effect.Schema.Struct({
@@ -4279,6 +4573,13 @@ const OrchestrationShellStreamEvent = effect.Schema.Union([
 		sequence: NonNegativeInt,
 		worktree: OrchestrationWorktreeShell
 	}),
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("worktree-relocated"),
+		sequence: NonNegativeInt,
+		worktree: OrchestrationWorktreeShell,
+		sourcePath: TrimmedNonEmptyString,
+		destinationPath: TrimmedNonEmptyString
+	}),
 	effect.Schema.Struct({
 		kind: effect.Schema.Literal("thread-removed"),
 		sequence: NonNegativeInt,
@@ -4360,7 +4661,13 @@ const OrchestrationSubscribeThreadWindowInput = effect.Schema.Struct({
 const OrchestrationThreadWindowSnapshot = effect.Schema.Struct({
 	snapshotSequence: NonNegativeInt,
 	thread: OrchestrationThread,
-	history: OrchestrationThreadHistoryState
+	history: OrchestrationThreadHistoryState,
+	/**
+	* The directory the thread's next turn runs in (its worktree, else its project root), as the
+	* server resolves it when starting a provider session. Absent from older servers and when the
+	* thread has no resolvable project.
+	*/
+	workspaceCwd: effect.Schema.optional(TrimmedNonEmptyString)
 });
 const OrchestrationThreadHistoryPageMode = effect.Schema.Struct({
 	kind: effect.Schema.Literal("before"),
@@ -4424,6 +4731,8 @@ const ProjectCreateCommand = effect.Schema.Struct({
 	type: effect.Schema.Literal("project.create"),
 	commandId: CommandId,
 	projectId: ProjectId,
+	/** Absent creates a regular project. */
+	kind: effect.Schema.optional(ProjectKind),
 	title: TrimmedNonEmptyString,
 	workspaceRoot: TrimmedNonEmptyString,
 	projectMetadataDir: effect.Schema.optional(ProjectMetadataDir).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(DEFAULT_PROJECT_METADATA_DIR))),
@@ -4439,6 +4748,8 @@ const ProjectMetaUpdateCommand = effect.Schema.Struct({
 	projectId: ProjectId,
 	/** Optional compare-and-set guard used by governed mutation flows. */
 	expectedUpdatedAt: effect.Schema.optional(IsoDateTime),
+	/** Only `chat` -> `project` (promotion) is accepted; the same kind is a no-op. */
+	kind: effect.Schema.optional(ProjectKind),
 	title: effect.Schema.optional(TrimmedNonEmptyString),
 	workspaceRoot: effect.Schema.optional(TrimmedNonEmptyString),
 	projectMetadataDir: effect.Schema.optional(ProjectMetadataDir),
@@ -4477,11 +4788,29 @@ const ThreadCreateCommand = effect.Schema.Struct({
 	worktreePath: effect.Schema.NullOr(TrimmedNonEmptyString),
 	createdAt: IsoDateTime
 });
+/** Server-originated only (Agent Control). Never part of ClientOrchestrationCommand. */
+const ThreadDelegatedCreateCommand = effect.Schema.Struct({
+	...ThreadCreateCommand.fields,
+	type: effect.Schema.Literal("thread.delegated.create"),
+	parentThreadId: ThreadId
+});
+/** Permanent deletion. Only a trashed (or never-used) thread can be deleted. */
 const ThreadDeleteCommand = effect.Schema.Struct({
 	type: effect.Schema.Literal("thread.delete"),
 	commandId: CommandId,
 	threadId: ThreadId
 });
+/** Recoverable removal: hidden everywhere, history and assets preserved. */
+const ThreadTrashCommand = effect.Schema.Struct({
+	type: effect.Schema.Literal("thread.trash"),
+	commandId: CommandId,
+	threadId: ThreadId
+});
+const ThreadUntrashCommand = effect.Schema.Struct({
+	type: effect.Schema.Literal("thread.untrash"),
+	commandId: CommandId,
+	threadId: ThreadId
+});
 const ThreadArchiveCommand = effect.Schema.Struct({
 	type: effect.Schema.Literal("thread.archive"),
 	commandId: CommandId,
@@ -4509,6 +4838,15 @@ const ThreadUnsnoozeCommand = effect.Schema.Struct({
 	commandId: CommandId,
 	threadId: ThreadId
 });
+/** Per-thread auto-resume override for the thread's current usage limit. */
+const ThreadUsageLimitConfigureCommand = effect.Schema.Struct({
+	type: effect.Schema.Literal("thread.usage-limit.configure"),
+	commandId: CommandId,
+	threadId: ThreadId,
+	limitId: ThreadUsageLimitId,
+	autoResume: effect.Schema.NullOr(effect.Schema.Boolean),
+	createdAt: IsoDateTime
+});
 const ThreadSettleCommand = effect.Schema.Struct({
 	type: effect.Schema.Literal("thread.settle"),
 	commandId: CommandId,
@@ -4581,36 +4919,81 @@ const ThreadTurnStartBootstrapPrepareWorktree = effect.Schema.Struct({
 	baseBranch: TrimmedNonEmptyString,
 	branch: effect.Schema.optional(TrimmedNonEmptyString)
 });
+/**
+* Shown when work (a turn, provider session, terminal or file write) is refused because the chat's
+* folder is moving into a project. The move settles in moments, so retrying shortly succeeds.
+*/
+const PROJECT_RELOCATION_PENDING_MESSAGE = "This chat is being moved into a project. Try again in a moment.";
+/**
+* First send of a "No project" chat. The server, not the client, allocates the chat folder
+* under its chats root, creates a `chat` project with `projectId` there, and then continues
+* with `createThread` for that project. Mutually exclusive with `prepareWorktree` and
+* `requireWorktree`: a chat folder is a plain directory, never a Git worktree.
+*/
+const ThreadTurnStartBootstrapCreateChatProject = effect.Schema.Struct({
+	projectId: ProjectId,
+	/** Seeds the chat title and its folder name; the folder name never changes afterwards. */
+	titleSeed: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(200))
+});
 const ThreadTurnStartBootstrap = effect.Schema.Struct({
 	/** Reject a turn unless this bootstrap creates a fresh isolated Git worktree. */
 	requireWorktree: effect.Schema.optional(effect.Schema.Boolean),
+	createChatProject: effect.Schema.optional(ThreadTurnStartBootstrapCreateChatProject),
 	createThread: effect.Schema.optional(ThreadTurnStartBootstrapCreateThread),
 	prepareWorktree: effect.Schema.optional(ThreadTurnStartBootstrapPrepareWorktree),
 	runSetupScript: effect.Schema.optional(effect.Schema.Boolean)
-});
-/** Optimistic identity fence for delayed delegated-result queue delivery. */
+}).check(effect.Schema.makeFilter((bootstrap) => {
+	if (bootstrap.createChatProject === void 0) return void 0;
+	if (bootstrap.prepareWorktree !== void 0 || bootstrap.requireWorktree === true) return "A chat without a project cannot also prepare a Git worktree";
+	if (bootstrap.createThread?.projectId !== bootstrap.createChatProject.projectId) return "A chat without a project must create its first thread in that chat";
+}));
+/**
+* Delegated-result wake fence. Legacy fields (`turnMessageId`, `turnId`, `runtimeSessionId`,
+* `providerInstanceId`) are decoded for stored events and ledger commands and ignored.
+*/
 const DelegationReturnGuard = effect.Schema.Struct({
-	turnMessageId: MessageId,
 	latestUserMessageId: effect.Schema.NullOr(MessageId),
 	projectId: ProjectId,
-	turnId: TurnId,
-	runtimeSessionId: RuntimeSessionId,
-	providerInstanceId: ProviderInstanceId,
 	runtimeMode: RuntimeMode,
-	worktreePath: effect.Schema.NullOr(effect.Schema.String)
+	worktreePath: effect.Schema.NullOr(effect.Schema.String),
+	turnMessageId: effect.Schema.optional(MessageId),
+	turnId: effect.Schema.optional(TurnId),
+	runtimeSessionId: effect.Schema.optional(RuntimeSessionId),
+	providerInstanceId: effect.Schema.optional(ProviderInstanceId)
 });
 const ClaudeResumeGuard = effect.Schema.Struct({
 	requireReady: effect.Schema.Boolean,
-	runtimeSessionId: RuntimeSessionId,
+	/**
+	* The runtime the review saw. Null when the session had none (it was stopped): the send is
+	* then accepted only while still no runtime is bound, so the review stays current until the
+	* next turn starts one.
+	*/
+	runtimeSessionId: effect.Schema.NullOr(RuntimeSessionId),
 	latestTurnId: effect.Schema.NullOr(TurnId),
 	modelSelection: ModelSelection
 });
+/**
+* Server-only optimistic fence for an automatic continuation after a restart. Never part
+* of `ClientThreadTurnStartCommand`: client decode strips it, so it cannot be forged.
+*/
+const RestartContinuationGuard = effect.Schema.Struct({
+	sourceTurnId: TurnId,
+	expectedLatestTurnState: effect.Schema.Literals(["interrupted", "completed"]),
+	latestUserMessageId: effect.Schema.NullOr(MessageId),
+	modelSelection: ModelSelection,
+	runtimeMode: RuntimeMode,
+	interactionMode: ProviderInteractionMode,
+	worktreePath: effect.Schema.NullOr(effect.Schema.String),
+	providerInstanceId: ProviderInstanceId
+});
 const ThreadTurnStartCommand = effect.Schema.Struct({
 	claudeResumeGuard: effect.Schema.optional(ClaudeResumeGuard),
+	restartContinuationGuard: effect.Schema.optional(RestartContinuationGuard),
 	computerUse: effect.Schema.optionalKey(ComputerTurnIntent),
 	projectMemory: effect.Schema.optional(effect.Schema.Never),
 	type: effect.Schema.Literal("thread.turn.start"),
 	delegationReturnGuard: effect.Schema.optional(DelegationReturnGuard),
+	usageLimitResumeGuard: effect.Schema.optional(UsageLimitResumeGuard),
 	commandId: CommandId,
 	threadId: ThreadId,
 	message: effect.Schema.Struct({
@@ -4636,6 +5019,7 @@ const ClientThreadTurnStartCommand = effect.Schema.Struct({
 	projectMemory: effect.Schema.optional(effect.Schema.Never),
 	type: effect.Schema.Literal("thread.turn.start"),
 	delegationReturnGuard: effect.Schema.optional(DelegationReturnGuard),
+	usageLimitResumeGuard: effect.Schema.optional(UsageLimitResumeGuard),
 	commandId: CommandId,
 	threadId: ThreadId,
 	message: effect.Schema.Struct({
@@ -4778,6 +5162,8 @@ const WorktreeSourceControlStateUpdateCommand = effect.Schema.Struct({
 	prTitle: effect.Schema.optional(effect.Schema.NullOr(TrimmedNonEmptyString)),
 	prState: effect.Schema.NullOr(PullRequestState),
 	prIsDraft: effect.Schema.NullOr(effect.Schema.Boolean),
+	/** When the PR reached its current merged/closed state; see `Worktree.prTerminalAt`. */
+	prTerminalAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
 	issueState: effect.Schema.NullOr(IssueState),
 	updatedAt: IsoDateTime
 });
@@ -4789,6 +5175,11 @@ const WorktreeRestoreCommand = effect.Schema.Struct({
 	worktreePath: effect.Schema.optional(effect.Schema.NullOr(TrimmedNonEmptyString)),
 	restoredAt: IsoDateTime
 });
+/**
+* Drops a workspace record. Never touches conversations: the decider refuses while
+* any conversation (active, archived or trashed) still references the record.
+* `sessions` is decoded for stored commands only; "delete" is always refused.
+*/
 const WorktreeDeleteCommand = effect.Schema.Struct({
 	sessions: effect.Schema.optional(effect.Schema.Literals(["preserve", "delete"])),
 	type: effect.Schema.Literal("worktree.delete"),
@@ -4798,6 +5189,37 @@ const WorktreeDeleteCommand = effect.Schema.Struct({
 	deletedAt: IsoDateTime,
 	deletedBranch: effect.Schema.Boolean
 });
+/**
+* Server-only (workspace lifecycle service): records that the physical checkout is
+* gone. Archives the record when it is still active; the path and branch stay.
+*/
+const WorktreeCheckoutRemoveCommand = effect.Schema.Struct({
+	type: effect.Schema.Literal("worktree.checkout.remove"),
+	commandId: CommandId,
+	worktreeId: WorktreeId,
+	reason: WorktreeCheckoutRemovalReason,
+	lifecycleGuard: effect.Schema.optional(WorktreeLifecycleGuard),
+	removedAt: IsoDateTime
+});
+/** Server-only: the checkout was recreated at its recorded path. */
+const WorktreeCheckoutRestoreCommand = effect.Schema.Struct({
+	type: effect.Schema.Literal("worktree.checkout.restore"),
+	commandId: CommandId,
+	worktreeId: WorktreeId,
+	worktreePath: TrimmedNonEmptyString,
+	restoredAt: IsoDateTime
+});
+/** Server-only: a verified managed checkout moved under workspace lifecycle admission. */
+const WorktreeRelocateCommand = effect.Schema.Struct({
+	type: effect.Schema.Literal("worktree.relocate"),
+	commandId: CommandId,
+	worktreeId: WorktreeId,
+	projectId: ProjectId,
+	sourcePath: TrimmedNonEmptyString,
+	destinationPath: TrimmedNonEmptyString,
+	expectedUpdatedAt: IsoDateTime,
+	relocatedAt: IsoDateTime
+});
 const ThreadAttachToWorktreeCommand = effect.Schema.Struct({
 	type: effect.Schema.Literal("thread.attach-to-worktree"),
 	commandId: CommandId,
@@ -4833,11 +5255,14 @@ const DispatchableClientOrchestrationCommand = effect.Schema.Union([
 	ProjectDeleteCommand,
 	ThreadCreateCommand,
 	ThreadDeleteCommand,
+	ThreadTrashCommand,
+	ThreadUntrashCommand,
 	ThreadArchiveCommand,
 	ThreadSidebarUndoCommand,
 	ThreadUnarchiveCommand,
 	ThreadSnoozeCommand,
 	ThreadUnsnoozeCommand,
+	ThreadUsageLimitConfigureCommand,
 	ThreadSettleCommand,
 	ThreadUnsettleCommand,
 	ThreadMetaUpdateCommand,
@@ -4871,11 +5296,14 @@ const ClientOrchestrationCommand = effect.Schema.Union([
 	ProjectDeleteCommand,
 	ThreadCreateCommand,
 	ThreadDeleteCommand,
+	ThreadTrashCommand,
+	ThreadUntrashCommand,
 	ThreadArchiveCommand,
 	ThreadSidebarUndoCommand,
 	ThreadUnarchiveCommand,
 	ThreadSnoozeCommand,
 	ThreadUnsnoozeCommand,
+	ThreadUsageLimitConfigureCommand,
 	ThreadSettleCommand,
 	ThreadUnsettleCommand,
 	ThreadMetaUpdateCommand,
@@ -4902,11 +5330,25 @@ const ClientOrchestrationCommand = effect.Schema.Union([
 	ThreadManualPositionSetCommand,
 	WorktreeManualPositionSetCommand
 ]);
+/**
+* The runtime a provider-originated session update comes from. The update applies only while
+* the thread's session is still bound to exactly this provider instance and runtime (null: none),
+* so a late lifecycle event of a replaced runtime can never overwrite its successor, whatever
+* order the two writes reach the engine in.
+*/
+const ThreadSessionSetExpectedRuntime = effect.Schema.Struct({
+	providerInstanceId: effect.Schema.NullOr(ProviderInstanceId),
+	runtimeSessionId: effect.Schema.NullOr(RuntimeSessionId)
+});
 const ThreadSessionSetCommand = effect.Schema.Struct({
 	type: effect.Schema.Literal("thread.session.set"),
 	commandId: CommandId,
 	threadId: ThreadId,
 	session: OrchestrationSession,
+	/** Server-internal precondition; absent for server-decided transitions (bind, stop, restart). */
+	expectedRuntime: effect.Schema.optional(ThreadSessionSetExpectedRuntime),
+	/** Internal hint: how the turn this session-set releases ended, when the caller knows. */
+	turnOutcome: effect.Schema.optional(OrchestrationTurnOutcome),
 	createdAt: IsoDateTime
 });
 const ThreadMessageAssistantDeltaCommand = effect.Schema.Struct({
@@ -4991,6 +5433,8 @@ const ThreadTurnSteerResolveCommand = effect.Schema.Union([effect.Schema.Struct(
 	resolution: effect.Schema.Struct({
 		status: effect.Schema.Literal("rejected"),
 		error: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(1e3)),
+		reason: effect.Schema.optionalKey(TurnSteerRejectionReason),
+		deliveryUncertain: TurnSteerDeliveryUncertain,
 		resolvedAt: IsoDateTime
 	})
 })]);
@@ -4999,6 +5443,8 @@ const ThreadRevertCompleteCommand = effect.Schema.Struct({
 	commandId: CommandId,
 	threadId: ThreadId,
 	turnCount: NonNegativeInt,
+	droppedTurnIds: effect.Schema.optional(effect.Schema.Array(TurnId)),
+	latestTurn: effect.Schema.optional(effect.Schema.NullOr(OrchestrationLatestTurn)),
 	createdAt: IsoDateTime
 });
 const ThreadGoalSyncCommand = effect.Schema.Struct({
@@ -5009,6 +5455,19 @@ const ThreadGoalSyncCommand = effect.Schema.Struct({
 	expectedRequestId: effect.Schema.optional(effect.Schema.String),
 	createdAt: IsoDateTime
 });
+/** Internal only: clients must never be able to forge a usage limit. */
+const ThreadUsageLimitRecordCommand = effect.Schema.Struct({
+	type: effect.Schema.Literal("thread.usage-limit.record"),
+	commandId: CommandId,
+	threadId: ThreadId,
+	limitId: ThreadUsageLimitId,
+	provider: ProviderDriverKind,
+	providerInstanceId: ProviderInstanceId,
+	turnId: TurnId,
+	message: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(1e3)),
+	resetAt: effect.Schema.NullOr(IsoDateTime),
+	createdAt: IsoDateTime
+});
 const ThreadGoalProviderClearCommand = effect.Schema.Struct({
 	type: effect.Schema.Literal("thread.goal.provider-clear"),
 	commandId: CommandId,
@@ -5017,6 +5476,7 @@ const ThreadGoalProviderClearCommand = effect.Schema.Struct({
 	createdAt: IsoDateTime
 });
 const InternalOrchestrationCommand = effect.Schema.Union([
+	ThreadDelegatedCreateCommand,
 	effect.Schema.Struct({
 		...ThreadCreateCommand.fields,
 		type: effect.Schema.Literal("thread.history.import"),
@@ -5046,7 +5506,11 @@ const InternalOrchestrationCommand = effect.Schema.Union([
 	ThreadTurnSteerResolveCommand,
 	ThreadRevertCompleteCommand,
 	ThreadGoalSyncCommand,
-	ThreadGoalProviderClearCommand
+	ThreadGoalProviderClearCommand,
+	ThreadUsageLimitRecordCommand,
+	WorktreeCheckoutRemoveCommand,
+	WorktreeCheckoutRestoreCommand,
+	WorktreeRelocateCommand
 ]);
 const OrchestrationCommand = effect.Schema.Union([DispatchableClientOrchestrationCommand, InternalOrchestrationCommand]);
 const OrchestrationEventType = effect.Schema.Literals([
@@ -5056,12 +5520,16 @@ const OrchestrationEventType = effect.Schema.Literals([
 	"project.deleted",
 	"thread.created",
 	"thread.deleted",
+	"thread.trashed",
+	"thread.untrashed",
 	"thread.archived",
 	"thread.unarchived",
 	"thread.snoozed",
 	"thread.unsnoozed",
 	"thread.settled",
 	"thread.unsettled",
+	"thread.usage-limit-set",
+	"thread.usage-limit-cleared",
 	"thread.meta-updated",
 	"thread.runtime-mode-set",
 	"thread.interaction-mode-set",
@@ -5090,6 +5558,9 @@ const OrchestrationEventType = effect.Schema.Literals([
 	"worktree.sourceControlStateUpdated",
 	"worktree.restored",
 	"worktree.deleted",
+	"worktree.checkoutRemoved",
+	"worktree.checkoutRestored",
+	"worktree.relocated",
 	"thread.attachedToWorktree",
 	"thread.statusBucketOverridden",
 	"thread.manualPositionSet",
@@ -5107,6 +5578,7 @@ const OrchestrationActorKind = effect.Schema.Literals([
 ]);
 const ProjectCreatedPayload = effect.Schema.Struct({
 	projectId: ProjectId,
+	kind: OptionalProjectKind,
 	title: TrimmedNonEmptyString,
 	workspaceRoot: TrimmedNonEmptyString,
 	projectMetadataDir: effect.Schema.optional(ProjectMetadataDir).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed(DEFAULT_PROJECT_METADATA_DIR))),
@@ -5119,6 +5591,8 @@ const ProjectCreatedPayload = effect.Schema.Struct({
 });
 const ProjectMetaUpdatedPayload = effect.Schema.Struct({
 	projectId: ProjectId,
+	/** Present only when the kind changed, which is always `chat` -> `project`. */
+	kind: effect.Schema.optional(ProjectKind),
 	title: effect.Schema.optional(TrimmedNonEmptyString),
 	workspaceRoot: effect.Schema.optional(TrimmedNonEmptyString),
 	projectMetadataDir: effect.Schema.optional(ProjectMetadataDir),
@@ -5149,12 +5623,22 @@ const ThreadCreatedPayload = effect.Schema.Struct({
 	branch: effect.Schema.NullOr(TrimmedNonEmptyString),
 	worktreePath: effect.Schema.NullOr(TrimmedNonEmptyString),
 	createdAt: IsoDateTime,
-	updatedAt: IsoDateTime
+	updatedAt: IsoDateTime,
+	lineage: effect.Schema.optional(ThreadLineage)
 });
 const ThreadDeletedPayload = effect.Schema.Struct({
 	threadId: ThreadId,
 	deletedAt: IsoDateTime
 });
+const ThreadTrashedPayload = effect.Schema.Struct({
+	threadId: ThreadId,
+	trashedAt: IsoDateTime,
+	updatedAt: IsoDateTime
+});
+const ThreadUntrashedPayload = effect.Schema.Struct({
+	threadId: ThreadId,
+	updatedAt: IsoDateTime
+});
 const ThreadArchivedPayload = effect.Schema.Struct({
 	threadId: ThreadId,
 	archivedAt: IsoDateTime,
@@ -5192,6 +5676,20 @@ const ThreadUnsettledPayload = effect.Schema.Struct({
 	updatedAt: IsoDateTime,
 	restoredSidebarState: effect.Schema.optional(ThreadSidebarRestoreState)
 });
+const ThreadUsageLimitSetPayload = effect.Schema.Struct({
+	threadId: ThreadId,
+	usageLimit: ThreadUsageLimit
+});
+const ThreadUsageLimitClearedPayload = effect.Schema.Struct({
+	threadId: ThreadId,
+	limitId: ThreadUsageLimitId,
+	reason: effect.Schema.Literals([
+		"turn-started",
+		"archived",
+		"reverted"
+	]),
+	updatedAt: IsoDateTime
+});
 const ThreadMetaUpdatedPayload = effect.Schema.Struct({
 	threadId: ThreadId,
 	title: effect.Schema.optional(TrimmedNonEmptyString),
@@ -5261,6 +5759,8 @@ const ThreadTurnSteerRejectedPayload = effect.Schema.Struct({
 	messageId: MessageId,
 	expectedTurnId: TurnId,
 	error: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(1e3)),
+	reason: effect.Schema.optionalKey(TurnSteerRejectionReason),
+	deliveryUncertain: TurnSteerDeliveryUncertain,
 	resolvedAt: IsoDateTime
 });
 const ThreadContextHandoffRequestedPayload = effect.Schema.Struct({
@@ -5315,7 +5815,13 @@ const ThreadCheckpointRevertRequestedPayload = effect.Schema.Struct({
 });
 const ThreadRevertedPayload = effect.Schema.Struct({
 	threadId: ThreadId,
-	turnCount: NonNegativeInt
+	turnCount: NonNegativeInt,
+	/**
+	* Authoritative revert result read from the projection. Absent on legacy
+	* events, which keep the count-based projection.
+	*/
+	droppedTurnIds: effect.Schema.optional(effect.Schema.Array(TurnId)),
+	latestTurn: effect.Schema.optional(effect.Schema.NullOr(OrchestrationLatestTurn))
 });
 const ThreadSessionStopRequestedPayload = effect.Schema.Struct({
 	threadId: ThreadId,
@@ -5323,7 +5829,9 @@ const ThreadSessionStopRequestedPayload = effect.Schema.Struct({
 });
 const ThreadSessionSetPayload = effect.Schema.Struct({
 	threadId: ThreadId,
-	session: OrchestrationSession
+	session: OrchestrationSession,
+	/** Decided by the server: the turn this session-set releases and its terminal state. */
+	releasedTurn: effect.Schema.optional(OrchestrationReleasedTurn)
 });
 const ThreadProposedPlanUpsertedPayload = effect.Schema.Struct({
 	threadId: ThreadId,
@@ -5379,6 +5887,8 @@ const WorktreeSourceControlStateUpdatedPayload = effect.Schema.Struct({
 	prTitle: effect.Schema.optional(effect.Schema.NullOr(TrimmedNonEmptyString)),
 	prState: effect.Schema.NullOr(PullRequestState),
 	prIsDraft: effect.Schema.NullOr(effect.Schema.Boolean),
+	/** When the PR reached its current merged/closed state; see `Worktree.prTerminalAt`. */
+	prTerminalAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
 	issueState: effect.Schema.NullOr(IssueState),
 	updatedAt: IsoDateTime
 });
@@ -5392,6 +5902,23 @@ const WorktreeDeletedPayload = effect.Schema.Struct({
 	deletedAt: IsoDateTime,
 	deletedBranch: effect.Schema.Boolean
 });
+const WorktreeCheckoutRemovedPayload = effect.Schema.Struct({
+	worktreeId: WorktreeId,
+	reason: WorktreeCheckoutRemovalReason,
+	removedAt: IsoDateTime
+});
+const WorktreeCheckoutRestoredPayload = effect.Schema.Struct({
+	worktreeId: WorktreeId,
+	worktreePath: TrimmedNonEmptyString,
+	restoredAt: IsoDateTime
+});
+const WorktreeRelocatedPayload = effect.Schema.Struct({
+	worktreeId: WorktreeId,
+	projectId: ProjectId,
+	sourcePath: TrimmedNonEmptyString,
+	destinationPath: TrimmedNonEmptyString,
+	relocatedAt: IsoDateTime
+});
 const ThreadAttachedToWorktreePayload = effect.Schema.Struct({
 	threadId: ThreadId,
 	worktreeId: WorktreeId,
@@ -5465,6 +5992,16 @@ const OrchestrationEvent = effect.Schema.Union([
 		type: effect.Schema.Literal("thread.deleted"),
 		payload: ThreadDeletedPayload
 	}),
+	effect.Schema.Struct({
+		...EventBaseFields,
+		type: effect.Schema.Literal("thread.trashed"),
+		payload: ThreadTrashedPayload
+	}),
+	effect.Schema.Struct({
+		...EventBaseFields,
+		type: effect.Schema.Literal("thread.untrashed"),
+		payload: ThreadUntrashedPayload
+	}),
 	effect.Schema.Struct({
 		...EventBaseFields,
 		type: effect.Schema.Literal("thread.archived"),
@@ -5495,6 +6032,16 @@ const OrchestrationEvent = effect.Schema.Union([
 		type: effect.Schema.Literal("thread.unsettled"),
 		payload: ThreadUnsettledPayload
 	}),
+	effect.Schema.Struct({
+		...EventBaseFields,
+		type: effect.Schema.Literal("thread.usage-limit-set"),
+		payload: ThreadUsageLimitSetPayload
+	}),
+	effect.Schema.Struct({
+		...EventBaseFields,
+		type: effect.Schema.Literal("thread.usage-limit-cleared"),
+		payload: ThreadUsageLimitClearedPayload
+	}),
 	effect.Schema.Struct({
 		...EventBaseFields,
 		type: effect.Schema.Literal("thread.meta-updated"),
@@ -5635,6 +6182,21 @@ const OrchestrationEvent = effect.Schema.Union([
 		type: effect.Schema.Literal("worktree.deleted"),
 		payload: WorktreeDeletedPayload
 	}),
+	effect.Schema.Struct({
+		...EventBaseFields,
+		type: effect.Schema.Literal("worktree.checkoutRemoved"),
+		payload: WorktreeCheckoutRemovedPayload
+	}),
+	effect.Schema.Struct({
+		...EventBaseFields,
+		type: effect.Schema.Literal("worktree.checkoutRestored"),
+		payload: WorktreeCheckoutRestoredPayload
+	}),
+	effect.Schema.Struct({
+		...EventBaseFields,
+		type: effect.Schema.Literal("worktree.relocated"),
+		payload: WorktreeRelocatedPayload
+	}),
 	effect.Schema.Struct({
 		...EventBaseFields,
 		type: effect.Schema.Literal("thread.attachedToWorktree"),
@@ -5933,8 +6495,20 @@ var OrchestrationGetSnapshotError = class extends effect.Schema.TaggedError()("O
 	message: TrimmedNonEmptyString,
 	cause: effect.Schema.optional(effect.Schema.Defect())
 }) {};
+/**
+* Machine-readable dispatch failures a client acts on. Absent for every other failure, which a
+* client only shows by `message`.
+*
+* - `chat-project-retired`: a `thread.turn.start` whose `bootstrap.createChatProject` names a
+*   project id this node has already deleted, such as an unused chat removed by startup cleanup.
+*   Nothing was created and the id can never be used again. The client gives the draft a fresh
+*   project id and sends again once.
+*/
+const OrchestrationDispatchCommandErrorReason = effect.Schema.Literals(["chat-project-retired"]);
 var OrchestrationDispatchCommandError = class extends effect.Schema.TaggedError()("OrchestrationDispatchCommandError", {
 	message: TrimmedNonEmptyString,
+	/** Additive: older clients ignore it and show `message`. */
+	reason: effect.Schema.optionalKey(OrchestrationDispatchCommandErrorReason),
 	cause: effect.Schema.optional(effect.Schema.Defect())
 }) {};
 var OrchestrationGetTurnDiffError = class extends effect.Schema.TaggedError()("OrchestrationGetTurnDiffError", {
@@ -6075,6 +6649,13 @@ const ClaudeCacheObservation = effect.Schema.Struct({
 	providerInstanceId: ProviderInstanceId,
 	model: TrimmedNonEmptyString,
 	modelSelection: effect.Schema.optional(ModelSelection),
+	/**
+	* The working directory of the runtime that made this request. Claude keeps native
+	* conversations per directory, so once the thread's working directory differs, the next
+	* turn continues in a fresh session instead of resuming this conversation. Absent from
+	* older servers.
+	*/
+	cwd: effect.Schema.optional(TrimmedNonEmptyString),
 	messageId: TrimmedNonEmptyString,
 	directInputTokens: NonNegativeInt,
 	cacheReadInputTokens: NonNegativeInt,
@@ -6170,6 +6751,7 @@ const RuntimeErrorClass = effect.Schema.Literals([
 	"transport_error",
 	"permission_error",
 	"validation_error",
+	"usage_limit",
 	"unknown"
 ]);
 const TOOL_LIFECYCLE_ITEM_TYPES = [
@@ -6360,7 +6942,25 @@ const ThreadMetadataUpdatedPayload = effect.Schema.Struct({
 });
 const ProviderThreadGoalUpdatedPayload = effect.Schema.Struct({ goal: ThreadGoal });
 const ProviderThreadGoalClearedPayload = effect.Schema.Struct({});
+/** Billing/work counters are separate from the current context-window gauge. */
+const ProcessedTokenUsage = effect.Schema.Struct({
+	scope: effect.Schema.Literals([
+		"session",
+		"turn",
+		"request"
+	]),
+	requestId: effect.Schema.optional(TrimmedNonEmptyStringSchema$1),
+	sessionId: effect.Schema.optional(TrimmedNonEmptyStringSchema$1),
+	/** Includes cache reads and writes. */
+	inputTokens: NonNegativeInt,
+	cachedInputTokens: NonNegativeInt,
+	/** Includes reasoning output; reasoning is not charged a second time. */
+	outputTokens: NonNegativeInt,
+	reasoningOutputTokens: NonNegativeInt,
+	totalTokens: NonNegativeInt
+});
 const ThreadTokenUsageSnapshot = effect.Schema.Struct({
+	processedUsage: effect.Schema.optional(ProcessedTokenUsage),
 	claudeCache: effect.Schema.optional(ClaudeCacheObservation),
 	usedTokens: NonNegativeInt,
 	totalProcessedTokens: effect.Schema.optional(NonNegativeInt),
@@ -6686,7 +7286,19 @@ const AuthStatusPayload = effect.Schema.Struct({
 	error: effect.Schema.optional(TrimmedNonEmptyStringSchema$1)
 });
 const AccountUpdatedPayload = effect.Schema.Struct({ account: effect.Schema.Unknown });
-const AccountRateLimitsUpdatedPayload = effect.Schema.Struct({ rateLimits: effect.Schema.Unknown });
+/**
+* Provider-agnostic reading of a rate-limit update. `exhausted` means at least one
+* window is rejected or at 100%; `resetAt` is when ALL exhausted windows reset, or
+* null when any of their resets is unknown.
+*/
+const UsageLimitState = effect.Schema.Struct({
+	exhausted: effect.Schema.Boolean,
+	resetAt: effect.Schema.NullOr(IsoDateTime)
+});
+const AccountRateLimitsUpdatedPayload = effect.Schema.Struct({
+	rateLimits: effect.Schema.Unknown,
+	usageLimitState: effect.Schema.optional(UsageLimitState)
+});
 const McpStatusUpdatedPayload = effect.Schema.Struct({ status: effect.Schema.Unknown });
 const McpOauthCompletedPayload = effect.Schema.Struct({
 	success: effect.Schema.Boolean,
@@ -6731,7 +7343,12 @@ const RuntimeWarningPayload = effect.Schema.Struct({
 const RuntimeErrorPayload = effect.Schema.Struct({
 	message: TrimmedNonEmptyStringSchema$1,
 	class: effect.Schema.optional(RuntimeErrorClass),
-	detail: effect.Schema.optional(effect.Schema.Unknown)
+	detail: effect.Schema.optional(effect.Schema.Unknown),
+	/**
+	* Only meaningful for `class: "usage_limit"`: when the limit resets. null = a limit
+	* with an unknown reset; absent = not applicable.
+	*/
+	resetAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime))
 });
 const ProviderRuntimeSessionStartedEvent = effect.Schema.Struct({
 	...ProviderRuntimeEventBase.fields,
@@ -7101,6 +7718,11 @@ const THREAD_KEYBINDING_COMMANDS = [
 	"thread.next",
 	...THREAD_JUMP_KEYBINDING_COMMANDS
 ];
+/**
+* Every built-in command a key can be bound to. Some ship without a default
+* key, so this — not the default keymap — is the list a keybindings editor
+* offers.
+*/
 const STATIC_KEYBINDING_COMMANDS = [
 	"terminal.toggle",
 	"terminal.split",
@@ -7116,8 +7738,15 @@ const STATIC_KEYBINDING_COMMANDS = [
 	"sidebar.showProjects",
 	"chat.new",
 	"chat.newLocal",
+	"chat.newWithoutProject",
 	"composer.stash",
 	"editor.openFavorite",
+	"pane.split",
+	"pane.close",
+	"pane.focusNext",
+	"pane.focusPrevious",
+	"pullRequests.open",
+	"projects.open",
 	...["modelPicker.toggle", ...MODEL_PICKER_JUMP_KEYBINDING_COMMANDS],
 	...THREAD_KEYBINDING_COMMANDS
 ];
@@ -7126,7 +7755,13 @@ const SCRIPT_RUN_COMMAND_PATTERN = effect.Schema.TemplateLiteral([
 	effect.Schema.NonEmptyString.check(effect.Schema.isMaxLength(24), effect.Schema.isPattern(/^[a-z0-9][a-z0-9-]*$/)),
 	effect.Schema.Literal(".run")
 ]);
-const KeybindingCommand = effect.Schema.Union([effect.Schema.Literals(STATIC_KEYBINDING_COMMANDS), SCRIPT_RUN_COMMAND_PATTERN]);
+/** Client-owned script commands include the environment and project identity. */
+const SCOPED_SCRIPT_RUN_COMMAND = effect.Schema.String.check(effect.Schema.isMaxLength(2048), effect.Schema.isPattern(/^projectScript\.[^/]+\/[^/]+\/[a-z0-9][a-z0-9-]{0,23}\.run$/));
+const KeybindingCommand = effect.Schema.Union([
+	effect.Schema.Literals(STATIC_KEYBINDING_COMMANDS),
+	SCRIPT_RUN_COMMAND_PATTERN,
+	SCOPED_SCRIPT_RUN_COMMAND
+]);
 const KeybindingValue = TrimmedString.check(effect.Schema.isMinLength(1), effect.Schema.isMaxLength(64));
 const KeybindingWhen = TrimmedString.check(effect.Schema.isMinLength(1), effect.Schema.isMaxLength(MAX_KEYBINDING_WHEN_LENGTH));
 const KeybindingRule = effect.Schema.Struct({
@@ -7179,6 +7814,10 @@ var KeybindingsConfigError = class extends effect.Schema.TaggedError()("Keybindi
 		return `Unable to parse keybindings config at ${this.configPath}: ${this.detail}`;
 	}
 };
+effect.Schema.Struct({
+	rules: KeybindingsConfig,
+	disabledCommands: effect.Schema.Array(KeybindingCommand).check(effect.Schema.isMaxLength(256))
+});
 //#endregion
 //#region ../../packages/contracts/src/codexResetCredits.ts
 const CodexResetCredit = effect.Schema.Struct({
@@ -7292,25 +7931,252 @@ var StorageError = class extends effect.Schema.TaggedError()("StorageError", { d
 	}
 };
 //#endregion
-//#region ../../packages/contracts/src/settings.ts
-const TimestampFormat = effect_Schema.Literals([
-	"locale",
-	"12-hour",
-	"24-hour"
+//#region ../../packages/contracts/src/workspaceLifecycle.ts
+/**
+* Workspace lifecycle is separate from conversation lifecycle. No action here ever
+* deletes a conversation; checkout removal archives the workspace's conversations
+* by default and keeps their history and the branch. Only an explicit discard
+* ("Delete workspace") throws work away, and it moves conversations to Trash.
+*/
+const WorkspaceLifecycleAction = effect.Schema.Literals([
+	"archive",
+	"restore",
+	"remove-checkout",
+	"remove-stale-record",
+	"recreate-checkout"
 ]);
-const DEFAULT_TIMESTAMP_FORMAT = "locale";
-const SidebarProjectSortOrder = effect_Schema.Literals([
-	"updated_at",
-	"created_at",
-	"manual"
+/** `removed`: the record says the checkout is gone. `unavailable`: inspection failed. */
+const WorkspaceCheckoutState = effect.Schema.Literals([
+	"present",
+	"missing",
+	"removed",
+	"unavailable"
 ]);
-const DEFAULT_SIDEBAR_PROJECT_SORT_ORDER = "updated_at";
-const SidebarThreadSortOrder = effect_Schema.Literals(["updated_at", "created_at"]);
-const DEFAULT_SIDEBAR_THREAD_SORT_ORDER = "updated_at";
-const SidebarAutoSettleAfterDays = effect_Schema.NullOr(effect_Schema.Literals([
-	1,
-	3,
-	7,
+const SamplePaths = effect.Schema.Array(effect.Schema.String).check(effect.Schema.isMaxLength(20));
+const WorkspaceChangeSummary = effect.Schema.Struct({
+	/** Tracked files with staged, unstaged or conflicted changes. */
+	modified: NonNegativeInt,
+	untracked: NonNegativeInt,
+	/** Ignored content that is not a known regenerable cache (credentials, databases, outputs…). */
+	protectedIgnored: NonNegativeInt,
+	protectedIgnoredSample: SamplePaths,
+	/** Ignored caches/build outputs that `git worktree remove` may discard. */
+	regenerableIgnored: NonNegativeInt,
+	regenerableIgnoredSample: SamplePaths,
+	/** Status output exceeded its bound; treated as blocking. */
+	truncated: effect.Schema.Boolean
+});
+const WorkspaceConversationCounts = effect.Schema.Struct({
+	active: NonNegativeInt,
+	archived: NonNegativeInt,
+	trashed: NonNegativeInt
+});
+const WorkspaceActionAvailability = effect.Schema.Struct({
+	action: WorkspaceLifecycleAction,
+	available: effect.Schema.Boolean,
+	blockers: effect.Schema.Array(effect.Schema.String)
+});
+const WorkspaceLifecycleSummary = effect.Schema.Struct({
+	worktreeId: WorktreeId,
+	projectId: ProjectId,
+	title: effect.Schema.String,
+	branch: TrimmedNonEmptyString,
+	path: effect.Schema.NullOr(effect.Schema.String),
+	origin: WorktreeOrigin,
+	/** The project root/main checkout is never a disposable workspace. */
+	main: effect.Schema.Boolean,
+	archivedAt: effect.Schema.NullOr(IsoDateTime),
+	checkoutRemovedAt: effect.Schema.NullOr(IsoDateTime),
+	checkout: WorkspaceCheckoutState,
+	gitRegistered: effect.Schema.NullOr(effect.Schema.Boolean),
+	branchExists: effect.Schema.NullOr(effect.Schema.Boolean),
+	/** Commits on the branch that the project HEAD does not contain. */
+	unmerged: effect.Schema.NullOr(effect.Schema.Boolean),
+	changes: effect.Schema.NullOr(WorkspaceChangeSummary),
+	conversations: WorkspaceConversationCounts,
+	activeWork: effect.Schema.Array(effect.Schema.String),
+	actions: effect.Schema.Array(WorkspaceActionAvailability),
+	/**
+	* Why "Delete workspace" (`remove-checkout` with `discard`) cannot run; empty
+	* when it can. Absent from nodes that predate it.
+	*/
+	discardBlockers: effect.Schema.optional(effect.Schema.Array(effect.Schema.String)),
+	inspectedAt: IsoDateTime
+});
+const WorkspaceLifecycleListInput = effect.Schema.Struct({ projectId: ProjectId });
+const WorkspaceLifecycleRequest = effect.Schema.Struct({
+	worktreeId: WorktreeId,
+	action: WorkspaceLifecycleAction,
+	/** Default true for checkout removal and stale-record cleanup; ignored otherwise. */
+	archiveConversations: effect.Schema.optional(effect.Schema.Boolean),
+	/**
+	* Off by default. Only on removal; a verified merged branch, or any branch when
+	* discarding.
+	*/
+	deleteBranch: effect.Schema.optional(effect.Schema.Boolean),
+	/**
+	* Off by default; `remove-checkout` only. "Delete workspace": the checkout is
+	* removed even with uncommitted, untracked or ignored files (they are lost),
+	* an unmerged branch may be deleted, and the workspace's conversations move to
+	* Trash instead of the archive. Also finishes a workspace whose checkout is
+	* already removed. Active work still blocks it.
+	*/
+	discard: effect.Schema.optional(effect.Schema.Boolean)
+});
+const WorkspaceLifecycleEffects = effect.Schema.Struct({
+	archiveWorkspace: effect.Schema.Boolean,
+	restoreWorkspace: effect.Schema.Boolean,
+	removeCheckout: effect.Schema.Boolean,
+	recreateCheckout: effect.Schema.Boolean,
+	recordCheckoutRemoval: effect.Schema.Boolean,
+	stopSessionThreadIds: effect.Schema.Array(ThreadId),
+	archiveConversationIds: effect.Schema.Array(ThreadId),
+	/** Conversations left exactly as they are (already archived, trashed or never used). */
+	unchangedConversations: NonNegativeInt,
+	discardedRegenerableIgnored: NonNegativeInt,
+	deleteBranch: effect.Schema.Boolean,
+	branch: TrimmedNonEmptyString,
+	/** The request discards ("Delete workspace"). Absent from nodes that predate it. */
+	discard: effect.Schema.optional(effect.Schema.Boolean),
+	/** Conversations moved to Trash, where they stay restorable. */
+	trashConversationIds: effect.Schema.optional(effect.Schema.Array(ThreadId)),
+	/** Work that exists nowhere else is lost: changed or untracked files, unmerged commits. */
+	discardsWork: effect.Schema.optional(effect.Schema.Boolean)
+});
+const WorkspaceLifecyclePreview = effect.Schema.Struct({
+	request: WorkspaceLifecycleRequest,
+	workspace: WorkspaceLifecycleSummary,
+	effects: WorkspaceLifecycleEffects,
+	/** One-line exact effect, e.g. "Remove 1 checkout, archive 4 conversations, keep history and branch." */
+	summary: effect.Schema.String,
+	details: effect.Schema.Array(effect.Schema.String),
+	blockers: effect.Schema.Array(effect.Schema.String),
+	/** Binds an apply to exactly the state this preview inspected. */
+	fingerprint: TrimmedNonEmptyString
+});
+const WorkspaceLifecycleApplyInput = effect.Schema.Struct({
+	...WorkspaceLifecycleRequest.fields,
+	expectedFingerprint: TrimmedNonEmptyString
+});
+const WorkspaceLifecycleStepId = effect.Schema.Literals([
+	"preflight",
+	"stop-sessions",
+	"fence-checkout",
+	"revalidate",
+	"remove-checkout",
+	"recreate-checkout",
+	"update-record",
+	"archive-conversations",
+	"delete-branch"
+]);
+const WorkspaceLifecycleStep = effect.Schema.Struct({
+	id: WorkspaceLifecycleStepId,
+	status: effect.Schema.Literals([
+		"done",
+		"skipped",
+		"failed"
+	]),
+	detail: effect.Schema.String
+});
+/**
+* `blocked`: nothing changed. `failed`: nothing durable changed. `partial`: some steps
+* completed (listed truthfully); retrying the same action resumes safely.
+*/
+const WorkspaceLifecycleOutcome = effect.Schema.Literals([
+	"completed",
+	"blocked",
+	"partial",
+	"failed"
+]);
+const WorkspaceLifecycleResult = effect.Schema.Struct({
+	outcome: WorkspaceLifecycleOutcome,
+	message: effect.Schema.String,
+	steps: effect.Schema.Array(WorkspaceLifecycleStep)
+});
+var WorkspaceLifecycleError = class extends effect.Schema.TaggedError()("WorkspaceLifecycleError", { detail: effect.Schema.String }) {
+	get message() {
+		return this.detail;
+	}
+};
+const SuggestionDays = effect.Schema.NullOr(effect.Schema.Int.check(effect.Schema.isBetween({
+	minimum: 1,
+	maximum: 3650
+})));
+/** `null` turns a suggestion off. Suggestions never act on their own; each needs approval. */
+const LifecycleSuggestionPolicy = effect.Schema.Struct({
+	archiveInactiveThreadsDays: SuggestionDays,
+	removeArchivedCheckoutsDays: SuggestionDays
+});
+const DEFAULT_LIFECYCLE_SUGGESTION_POLICY = {
+	archiveInactiveThreadsDays: 30,
+	removeArchivedCheckoutsDays: 7
+};
+const ThreadArchiveSuggestion = effect.Schema.Struct({
+	threadId: ThreadId,
+	projectId: ProjectId,
+	title: effect.Schema.String,
+	lastActivityAt: IsoDateTime
+});
+const CheckoutRemovalSuggestion = effect.Schema.Struct({
+	worktreeId: WorktreeId,
+	projectId: ProjectId,
+	title: effect.Schema.String,
+	branch: TrimmedNonEmptyString,
+	/** When the last of its conversations was archived. */
+	archivedSince: IsoDateTime,
+	conversations: NonNegativeInt
+});
+const LifecycleSuggestions = effect.Schema.Struct({
+	generatedAt: IsoDateTime,
+	threads: effect.Schema.Array(ThreadArchiveSuggestion),
+	checkouts: effect.Schema.Array(CheckoutRemovalSuggestion)
+});
+const TrashedThreadSummary = effect.Schema.Struct({
+	threadId: ThreadId,
+	projectId: ProjectId,
+	projectTitle: effect.Schema.NullOr(effect.Schema.String),
+	/**
+	* The owning project's kind, so a chat is listed as "No project" without the client's project
+	* store. Absent when the project record is gone, or from a node that predates chats; both read
+	* as a regular project.
+	*/
+	projectKind: effect.Schema.optionalKey(ProjectKind),
+	/** False when the owning project was removed; restore is unavailable. */
+	projectAvailable: effect.Schema.Boolean,
+	title: effect.Schema.String,
+	branch: effect.Schema.NullOr(effect.Schema.String),
+	worktreePath: effect.Schema.NullOr(effect.Schema.String),
+	worktreeId: effect.Schema.NullOr(WorktreeId),
+	/** Restoring returns the conversation to this archive state. */
+	archivedAt: effect.Schema.NullOr(IsoDateTime),
+	trashedAt: IsoDateTime,
+	createdAt: IsoDateTime,
+	updatedAt: IsoDateTime
+});
+const TrashListResult = effect.Schema.Struct({
+	threads: effect.Schema.Array(TrashedThreadSummary),
+	truncated: effect.Schema.Boolean
+});
+//#endregion
+//#region ../../packages/contracts/src/settings.ts
+const TimestampFormat = effect_Schema.Literals([
+	"locale",
+	"12-hour",
+	"24-hour"
+]);
+const DEFAULT_TIMESTAMP_FORMAT = "locale";
+const SidebarProjectSortOrder = effect_Schema.Literals([
+	"updated_at",
+	"created_at",
+	"manual"
+]);
+const DEFAULT_SIDEBAR_PROJECT_SORT_ORDER = "updated_at";
+const SidebarThreadSortOrder = effect_Schema.Literals(["updated_at", "created_at"]);
+const DEFAULT_SIDEBAR_THREAD_SORT_ORDER = "updated_at";
+const SidebarAutoSettleAfterDays = effect_Schema.NullOr(effect_Schema.Literals([
+	1,
+	3,
+	7,
 	14,
 	30,
 	90
@@ -7344,6 +8210,13 @@ const AiFocusRefreshIntervalMs = effect_Schema.Literals([
 	864e5
 ]);
 const DEFAULT_AI_FOCUS_REFRESH_INTERVAL_MS = 6e5;
+/**
+* What Enter does with a message sent while a turn runs: `queue` waits for the turn to finish,
+* `steer` adds it to the running turn when the provider supports steering. Mod+Enter does the
+* opposite.
+*/
+const FollowUpBehavior = effect_Schema.Literals(["queue", "steer"]);
+const DEFAULT_FOLLOW_UP_BEHAVIOR = "queue";
 /** Missing effort is a legacy model-only preset; provider remains the stable instance id. */
 const ModelFavorite = effect_Schema.Struct({
 	provider: ProviderInstanceId,
@@ -7361,6 +8234,7 @@ const ClientSettingsSchema = effect_Schema.Struct({
 	dismissedProviderUpdateNotificationKeys: effect_Schema.Array(TrimmedNonEmptyString).pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed([]))),
 	diffIgnoreWhitespace: effect_Schema.Boolean.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(true))),
 	diffWordWrap: effect_Schema.Boolean.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(false))),
+	followUpBehavior: FollowUpBehavior.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(DEFAULT_FOLLOW_UP_BEHAVIOR))),
 	favorites: effect_Schema.Array(ModelFavorite).pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed([]))),
 	providerModelPreferences: effect_Schema.Record(ProviderInstanceId, effect_Schema.Struct({
 		hiddenModels: effect_Schema.Array(effect_Schema.String).pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed([]))),
@@ -7632,13 +8506,19 @@ const ServerSettings = effect_Schema.Struct({
 	environmentIcon: EnvironmentMachineHint.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(null))),
 	enableLegacyTokenStreaming: effect_Schema.Boolean.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(false))),
 	enableProviderUpdateChecks: effect_Schema.Boolean.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(true))),
+	continueThreadsAfterRestart: effect_Schema.Boolean.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(false))),
+	autoResumeLimitedThreads: effect_Schema.Boolean.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(false))),
+	snoozeLimitedThreads: effect_Schema.Boolean.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(false))),
 	storageRetention: StorageRetentionPolicy.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed({
 		automatic: false,
 		completedWorktreeDays: null,
 		temporaryDataDays: null
 	}))),
 	projectStorageRetention: effect_Schema.Record(effect_Schema.String, effect_Schema.NullOr(StorageRetentionPolicy)).pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed({}))),
+	lifecycleSuggestions: LifecycleSuggestionPolicy.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(DEFAULT_LIFECYCLE_SUGGESTION_POLICY))),
+	projectLifecycleSuggestions: effect_Schema.Record(effect_Schema.String, effect_Schema.NullOr(LifecycleSuggestionPolicy)).pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed({}))),
 	worktreeRoot: WorktreeRoot.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(""))),
+	chatsRoot: WorktreeRoot.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed(""))),
 	worktreeSubmodules: WorktreeSubmodules.pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed("recursive"))),
 	projectWorktreeSubmodules: effect_Schema.Record(effect_Schema.String, effect_Schema.NullOr(WorktreeSubmodules)).pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed({}))),
 	projectWorktreeRoots: effect_Schema.Record(effect_Schema.String, effect_Schema.NullOr(WorktreeRoot)).pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed({}))),
@@ -7733,9 +8613,15 @@ const ServerSettingsPatch = effect_Schema.Struct({
 	environmentIcon: effect_Schema.optionalKey(effect_Schema.NullOr(EnvironmentMachineKind)),
 	enableLegacyTokenStreaming: effect_Schema.optionalKey(effect_Schema.Boolean),
 	enableProviderUpdateChecks: effect_Schema.optionalKey(effect_Schema.Boolean),
+	continueThreadsAfterRestart: effect_Schema.optionalKey(effect_Schema.Boolean),
+	autoResumeLimitedThreads: effect_Schema.optionalKey(effect_Schema.Boolean),
+	snoozeLimitedThreads: effect_Schema.optionalKey(effect_Schema.Boolean),
 	storageRetention: effect_Schema.optionalKey(StorageRetentionPolicy),
 	projectStorageRetention: effect_Schema.optionalKey(effect_Schema.Record(effect_Schema.String, effect_Schema.NullOr(StorageRetentionPolicy))),
+	lifecycleSuggestions: effect_Schema.optionalKey(LifecycleSuggestionPolicy),
+	projectLifecycleSuggestions: effect_Schema.optionalKey(effect_Schema.Record(effect_Schema.String, effect_Schema.NullOr(LifecycleSuggestionPolicy))),
 	worktreeRoot: effect_Schema.optionalKey(WorktreeRoot),
+	chatsRoot: effect_Schema.optionalKey(WorktreeRoot),
 	worktreeSubmodules: effect_Schema.optionalKey(WorktreeSubmodules),
 	projectWorktreeSubmodules: effect_Schema.optionalKey(effect_Schema.Record(effect_Schema.String, effect_Schema.NullOr(WorktreeSubmodules))),
 	projectWorktreeRoots: effect_Schema.optionalKey(effect_Schema.Record(effect_Schema.String, effect_Schema.NullOr(WorktreeRoot))),
@@ -7770,6 +8656,7 @@ effect_Schema.Struct({
 	confirmThreadUnpin: effect_Schema.optionalKey(effect_Schema.Boolean),
 	diffIgnoreWhitespace: effect_Schema.optionalKey(effect_Schema.Boolean),
 	diffWordWrap: effect_Schema.optionalKey(effect_Schema.Boolean),
+	followUpBehavior: effect_Schema.optionalKey(FollowUpBehavior),
 	favorites: effect_Schema.optionalKey(effect_Schema.Array(ModelFavorite)),
 	providerModelPreferences: effect_Schema.optionalKey(effect_Schema.Record(ProviderInstanceId, effect_Schema.Struct({
 		hiddenModels: effect_Schema.Array(effect_Schema.String).pipe(effect_Schema.withDecodingDefault(effect.Effect.succeed([]))),
@@ -7898,6 +8785,27 @@ const ServerProviderRateLimits = effect.Schema.Struct({
 	resetCredits: effect.Schema.optional(CodexResetCredits),
 	rateLimitReachedType: effect.Schema.optional(TrimmedNonEmptyString)
 });
+/**
+* How a provider version fits this Ryco release, per the server's compatibility policy
+* (code-owned floors + bundled defaults + remote model manifest).
+* FROZEN: mobile/desktop clients ship separately and decode whole provider lists with this
+* schema, so an unknown literal would fail the entire `ServerProvider` list. Never add a member —
+* put new meanings in a new optional field.
+*/
+const ServerProviderCompatibilityStatus = effect.Schema.Literals([
+	"unknown",
+	"supported",
+	"graceful",
+	"unsupported",
+	"broken"
+]);
+const ServerProviderCompatibilityAdvisory = effect.Schema.Struct({
+	/** Rating of `ServerProvider.version`. */
+	status: ServerProviderCompatibilityStatus,
+	/** Rating of `versionAdvisory.latestVersion`; absent when no latest version is known. */
+	latestVersionStatus: effect.Schema.optionalKey(ServerProviderCompatibilityStatus),
+	message: effect.Schema.NullOr(TrimmedNonEmptyString)
+});
 const ServerProviderVersionAdvisoryStatus = effect.Schema.Literals([
 	"unknown",
 	"current",
@@ -7949,6 +8857,7 @@ const ServerProvider = effect.Schema.Struct({
 	showInteractionModeToggle: effect.Schema.optional(effect.Schema.Boolean),
 	supportsAskMode: effect.Schema.optional(effect.Schema.Boolean),
 	supportsTurnSteering: effect.Schema.optional(effect.Schema.Boolean),
+	supportsConversationRollback: effect.Schema.optional(effect.Schema.Boolean),
 	enabled: effect.Schema.Boolean,
 	installed: effect.Schema.Boolean,
 	version: effect.Schema.NullOr(TrimmedNonEmptyString),
@@ -7963,9 +8872,17 @@ const ServerProvider = effect.Schema.Struct({
 	skills: effect.Schema.Array(ServerProviderSkill).pipe(effect.Schema.withDecodingDefault(effect.Effect.succeed([]))),
 	rateLimits: effect.Schema.optional(ServerProviderRateLimits),
 	versionAdvisory: effect.Schema.optionalKey(ServerProviderVersionAdvisory),
+	compatibilityAdvisory: effect.Schema.optionalKey(ServerProviderCompatibilityAdvisory),
 	updateState: effect.Schema.optionalKey(ServerProviderUpdateState)
 });
 const ServerProviders = effect.Schema.Array(ServerProvider);
+/**
+* Treat the optional `availability` as "available" when absent. This is
+* the rule legacy producers (which omit the field) and new producers
+* (which set it explicitly) agree on so consumers never have to thread
+* `?? "available"` defaults through their code paths.
+*/
+const isProviderAvailable = (snapshot) => snapshot.availability !== "unavailable";
 const ServerLocalDiagnosticsMetrics = effect.Schema.Struct({
 	turnQuiescenceAvgMs: effect.Schema.NullOr(effect.Schema.Number),
 	checkpointDurationP95Ms: effect.Schema.NullOr(effect.Schema.Number),
@@ -7985,12 +8902,32 @@ const ServerObservability = effect.Schema.Struct({
 	otlpMetricsEnabled: effect.Schema.Boolean,
 	localMetrics: effect.Schema.optional(ServerLocalDiagnosticsMetrics)
 });
+/**
+* Why "No project" chats are off on this node:
+* - `inside-git-repository`: the chats root lies in a Git working tree, so every chat would show
+*   the parent repository's branch and diff.
+* - `root-unavailable`: the chats root cannot be resolved or created.
+* - `restricted`: the workspace access policy does not allow the chats root.
+*/
+const ServerChatsUnavailableReason = effect.Schema.Literals([
+	"inside-git-repository",
+	"root-unavailable",
+	"restricted"
+]);
+/** Absent from nodes without chat support; clients then hide every "No project" entry point. */
+const ServerChatsCapability = effect.Schema.Struct({
+	available: effect.Schema.Boolean,
+	/** Resolved chats root (symlinks resolved), present when it could be determined. */
+	root: effect.Schema.optionalKey(TrimmedNonEmptyString),
+	unavailableReason: effect.Schema.optionalKey(ServerChatsUnavailableReason)
+});
 const ServerConfig = effect.Schema.Struct({
 	usageContractVersion: effect.Schema.optional(NonNegativeInt),
 	environment: ExecutionEnvironmentDescriptor,
 	auth: ServerAuthDescriptor,
 	cwd: TrimmedNonEmptyString,
 	workspaceAccessRoot: effect.Schema.optional(TrimmedNonEmptyString),
+	chats: effect.Schema.optionalKey(ServerChatsCapability),
 	keybindingsConfigPath: TrimmedNonEmptyString,
 	keybindings: ResolvedKeybindingsConfig,
 	issues: ServerConfigIssues,
@@ -9521,6 +10458,24 @@ const GitReadLineBlameResult = effect.Schema.Union([effect.Schema.Struct({
 	kind: effect.Schema.Literal("unavailable"),
 	reason: effect.Schema.String
 })]);
+/**
+* One stored blob named by a review patch's `index` line. Patches without
+* `--full-index` carry abbreviated IDs. No path, index or working-tree lookup.
+*/
+const GitReadImageBlobInput = effect.Schema.Struct({
+	cwd: TrimmedNonEmptyStringSchema,
+	oid: effect.Schema.String.check(effect.Schema.isPattern(/^(?:[0-9a-f]{4,40}|[0-9a-f]{64})$/))
+});
+/** The mime type is sniffed from the blob's bytes, never from a path. */
+const GitReadImageBlobResult = effect.Schema.Union([effect.Schema.Struct({
+	kind: effect.Schema.Literal("image"),
+	dataBase64: effect.Schema.String,
+	mimeType: TrimmedNonEmptyStringSchema,
+	sizeBytes: NonNegativeInt
+}), effect.Schema.Struct({
+	kind: effect.Schema.Literal("unavailable"),
+	reason: effect.Schema.String
+})]);
 const GitLocalChangesInput = effect.Schema.Struct({ cwd: TrimmedNonEmptyStringSchema });
 const GitLocalChangesScope = effect.Schema.Literals(["staged", "unstaged"]);
 const GitLocalPatch = effect.Schema.Struct({
@@ -9549,6 +10504,402 @@ const GitApplyIndexPatchInput = effect.Schema.Struct({
 	hunkIndex: effect.Schema.optional(NonNegativeInt)
 });
 //#endregion
+//#region ../../packages/contracts/src/changeRequestReview.ts
+/**
+* Review conversation, timeline, and lifecycle contracts for the dedicated
+* pull request page. Unlike `SourceControlChangeRequestDetail`, these payloads
+* are never attached to agent prompts, so they are bounded by page size
+* rather than by the composer token budget.
+*/
+const NonBlankMarkdownBody = effect.Schema.String.check(effect.Schema.makeFilter((body) => body.trim().length > 0 ? void 0 : "Expected a non-blank Markdown body"));
+/** `left` is the base (deleted) side of a diff, `right` the head (added) side. */
+const ChangeRequestDiffSide = effect.Schema.Literals(["left", "right"]);
+const ChangeRequestActor = effect.Schema.Struct({
+	login: TrimmedNonEmptyString,
+	avatarUrl: effect.Schema.optional(effect.Schema.String),
+	isBot: effect.Schema.optional(effect.Schema.Boolean)
+});
+const ChangeRequestReviewComment = effect.Schema.Struct({
+	/** Host node id; used for replies, reactions, edits, and deletes. */
+	id: TrimmedNonEmptyString,
+	author: ChangeRequestActor,
+	authorAssociation: effect.Schema.optional(effect.Schema.String),
+	body: effect.Schema.String,
+	createdAt: effect.Schema.DateTimeUtc,
+	updatedAt: effect.Schema.optional(effect.Schema.DateTimeUtc),
+	url: effect.Schema.optional(effect.Schema.String),
+	reactions: effect.Schema.optional(effect.Schema.Array(SourceControlCommentReaction)),
+	/** `pending` comments belong to the viewer's unsubmitted host-side review. */
+	state: effect.Schema.optional(effect.Schema.Literals(["pending", "submitted"])),
+	viewerCanUpdate: effect.Schema.optional(effect.Schema.Boolean),
+	viewerCanDelete: effect.Schema.optional(effect.Schema.Boolean),
+	isMinimized: effect.Schema.optional(effect.Schema.Boolean)
+});
+const ChangeRequestReviewThread = effect.Schema.Struct({
+	id: TrimmedNonEmptyString,
+	path: TrimmedNonEmptyString,
+	subjectType: effect.Schema.Literals(["line", "file"]),
+	side: ChangeRequestDiffSide,
+	startSide: effect.Schema.optional(ChangeRequestDiffSide),
+	/** Current anchor line; null when the thread is outdated and no longer maps onto the diff. */
+	line: effect.Schema.NullOr(PositiveInt),
+	startLine: effect.Schema.optional(effect.Schema.NullOr(PositiveInt)),
+	originalLine: effect.Schema.optional(effect.Schema.NullOr(PositiveInt)),
+	originalStartLine: effect.Schema.optional(effect.Schema.NullOr(PositiveInt)),
+	/** Commit the first comment was written on; `originalLine` refers to that commit. */
+	originalCommitOid: effect.Schema.optional(TrimmedNonEmptyString),
+	/** Unified diff excerpt the first comment was written against. */
+	diffHunk: effect.Schema.optional(effect.Schema.String),
+	isResolved: effect.Schema.Boolean,
+	isOutdated: effect.Schema.Boolean,
+	resolvedBy: effect.Schema.optional(TrimmedNonEmptyString),
+	viewerCanReply: effect.Schema.Boolean,
+	viewerCanResolve: effect.Schema.Boolean,
+	viewerCanUnresolve: effect.Schema.Boolean,
+	comments: effect.Schema.Array(ChangeRequestReviewComment),
+	/** Total comments on the host; larger than `comments.length` when paged. */
+	totalComments: NonNegativeInt
+});
+const TimelineBase = {
+	id: TrimmedNonEmptyString,
+	createdAt: effect.Schema.DateTimeUtc,
+	actor: effect.Schema.optional(ChangeRequestActor)
+};
+const ChangeRequestTimelineComment = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("comment"),
+	body: effect.Schema.String,
+	authorAssociation: effect.Schema.optional(effect.Schema.String),
+	updatedAt: effect.Schema.optional(effect.Schema.DateTimeUtc),
+	url: effect.Schema.optional(effect.Schema.String),
+	reactions: effect.Schema.optional(effect.Schema.Array(SourceControlCommentReaction)),
+	viewerCanUpdate: effect.Schema.optional(effect.Schema.Boolean),
+	viewerCanDelete: effect.Schema.optional(effect.Schema.Boolean),
+	isMinimized: effect.Schema.optional(effect.Schema.Boolean)
+});
+const ChangeRequestTimelineReview = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("review"),
+	state: SourceControlReviewState,
+	body: effect.Schema.String,
+	authorAssociation: effect.Schema.optional(effect.Schema.String),
+	url: effect.Schema.optional(effect.Schema.String),
+	reactions: effect.Schema.optional(effect.Schema.Array(SourceControlCommentReaction)),
+	/** Review threads opened by this review, so the timeline can nest them. */
+	threadIds: effect.Schema.Array(TrimmedNonEmptyString),
+	viewerCanUpdate: effect.Schema.optional(effect.Schema.Boolean)
+});
+const ChangeRequestTimelineCommit = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("commit"),
+	oid: TrimmedNonEmptyString,
+	shortOid: TrimmedNonEmptyString,
+	messageHeadline: effect.Schema.String,
+	messageBody: effect.Schema.optional(effect.Schema.String),
+	/** Rollup of the commit's checks, when the host reports one. */
+	checkState: effect.Schema.optional(effect.Schema.Literals([
+		"success",
+		"failure",
+		"pending",
+		"neutral"
+	]))
+});
+const ChangeRequestTimelineForcePush = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("force-pushed"),
+	beforeOid: effect.Schema.optional(TrimmedNonEmptyString),
+	afterOid: effect.Schema.optional(TrimmedNonEmptyString)
+});
+const ChangeRequestTimelineReviewRequest = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literals(["review-requested", "review-request-removed"]),
+	reviewer: TrimmedNonEmptyString,
+	reviewerKind: effect.Schema.Literals([
+		"user",
+		"team",
+		"bot"
+	])
+});
+const ChangeRequestTimelineLabel = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literals(["labeled", "unlabeled"]),
+	label: SourceControlLabel
+});
+const ChangeRequestTimelineAssignment = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literals(["assigned", "unassigned"]),
+	assignee: TrimmedNonEmptyString
+});
+const ChangeRequestTimelineRename = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("renamed"),
+	previousTitle: effect.Schema.String,
+	currentTitle: effect.Schema.String
+});
+const ChangeRequestTimelineMerged = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("merged"),
+	commitOid: effect.Schema.optional(TrimmedNonEmptyString),
+	baseRefName: effect.Schema.optional(TrimmedNonEmptyString)
+});
+const ChangeRequestTimelineLifecycle = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literals([
+		"closed",
+		"reopened",
+		"ready-for-review",
+		"converted-to-draft",
+		"head-ref-deleted",
+		"head-ref-restored"
+	])
+});
+const ChangeRequestTimelineBaseChanged = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("base-ref-changed"),
+	previousRefName: effect.Schema.optional(TrimmedNonEmptyString),
+	currentRefName: effect.Schema.optional(TrimmedNonEmptyString)
+});
+const ChangeRequestTimelineCrossReference = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("cross-referenced"),
+	source: effect.Schema.Struct({
+		kind: effect.Schema.Literals(["issue", "change-request"]),
+		number: PositiveInt,
+		title: effect.Schema.String,
+		url: effect.Schema.String,
+		repository: effect.Schema.optional(TrimmedNonEmptyString),
+		state: effect.Schema.optional(effect.Schema.Literals([
+			"open",
+			"closed",
+			"merged"
+		]))
+	}),
+	willCloseTarget: effect.Schema.optional(effect.Schema.Boolean)
+});
+const ChangeRequestTimelineAutoMerge = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literals(["auto-merge-enabled", "auto-merge-disabled"]),
+	mergeMethod: effect.Schema.optional(SourceControlChangeRequestMergeMethod)
+});
+const ChangeRequestTimelineReviewDismissed = effect.Schema.Struct({
+	...TimelineBase,
+	kind: effect.Schema.Literal("review-dismissed"),
+	reviewAuthor: effect.Schema.optional(TrimmedNonEmptyString),
+	message: effect.Schema.optional(effect.Schema.String)
+});
+const ChangeRequestTimelineItem = effect.Schema.Union([
+	ChangeRequestTimelineComment,
+	ChangeRequestTimelineReview,
+	ChangeRequestTimelineCommit,
+	ChangeRequestTimelineForcePush,
+	ChangeRequestTimelineReviewRequest,
+	ChangeRequestTimelineLabel,
+	ChangeRequestTimelineAssignment,
+	ChangeRequestTimelineRename,
+	ChangeRequestTimelineMerged,
+	ChangeRequestTimelineLifecycle,
+	ChangeRequestTimelineBaseChanged,
+	ChangeRequestTimelineCrossReference,
+	ChangeRequestTimelineAutoMerge,
+	ChangeRequestTimelineReviewDismissed
+]);
+const ChangeRequestViewerCapabilities = effect.Schema.Struct({
+	login: TrimmedNonEmptyString,
+	isAuthor: effect.Schema.Boolean,
+	/** Edit title/body/base, labels, assignees, reviewers, draft state, close/reopen. */
+	canUpdate: effect.Schema.Boolean,
+	canMerge: effect.Schema.Boolean,
+	canReview: effect.Schema.Boolean,
+	canUpdateBranch: effect.Schema.Boolean,
+	canEnableAutoMerge: effect.Schema.Boolean,
+	canDisableAutoMerge: effect.Schema.Boolean
+});
+const ChangeRequestActivityInput = effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	reference: TrimmedNonEmptyString
+});
+const ChangeRequestActivity = effect.Schema.Struct({
+	provider: SourceControlProviderKind,
+	number: PositiveInt,
+	headSha: effect.Schema.NullOr(TrimmedNonEmptyString),
+	viewer: effect.Schema.NullOr(ChangeRequestViewerCapabilities),
+	/** Chronological (oldest first). */
+	timeline: effect.Schema.Array(ChangeRequestTimelineItem),
+	/** True when older timeline items were dropped to stay within the page budget. */
+	timelineTruncated: effect.Schema.Boolean,
+	reviewThreads: effect.Schema.Array(ChangeRequestReviewThread),
+	reviewThreadsTruncated: effect.Schema.Boolean,
+	/** The viewer's unsubmitted host-side review (e.g. started on the web), if any. */
+	pendingReview: effect.Schema.NullOr(effect.Schema.Struct({
+		id: TrimmedNonEmptyString,
+		commentsCount: NonNegativeInt
+	}))
+});
+const ChangeRequestReviewEvent = effect.Schema.Literals([
+	"comment",
+	"approve",
+	"request_changes"
+]);
+const ChangeRequestDraftReviewComment = effect.Schema.Struct({
+	path: TrimmedNonEmptyString,
+	body: NonBlankMarkdownBody,
+	/** `file` comments attach to the whole file and ignore line/side. */
+	subjectType: effect.Schema.optional(effect.Schema.Literals(["line", "file"])),
+	line: effect.Schema.optional(PositiveInt),
+	side: effect.Schema.optional(ChangeRequestDiffSide),
+	startLine: effect.Schema.optional(PositiveInt),
+	startSide: effect.Schema.optional(ChangeRequestDiffSide)
+});
+const ChangeRequestSubmitReviewInput = effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	reference: TrimmedNonEmptyString,
+	event: ChangeRequestReviewEvent,
+	body: effect.Schema.optional(effect.Schema.String),
+	comments: effect.Schema.Array(ChangeRequestDraftReviewComment),
+	/** The head the comments were written against; the host anchors lines to it. */
+	expectedHeadSha: TrimmedNonEmptyString
+});
+const ChangeRequestSubmitReviewResult = effect.Schema.Struct({
+	reviewId: TrimmedNonEmptyString,
+	state: SourceControlReviewState,
+	url: effect.Schema.optional(effect.Schema.String)
+});
+const ChangeRequestReplyToThreadInput = effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	reference: TrimmedNonEmptyString,
+	threadId: TrimmedNonEmptyString,
+	body: NonBlankMarkdownBody,
+	clientMutationId: effect.Schema.optional(TrimmedNonEmptyString)
+});
+const ChangeRequestReplyToThreadResult = effect.Schema.Struct({ thread: ChangeRequestReviewThread });
+const ChangeRequestSetThreadResolvedInput = effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	reference: TrimmedNonEmptyString,
+	threadId: TrimmedNonEmptyString,
+	resolved: effect.Schema.Boolean
+});
+const ChangeRequestSetThreadResolvedResult = effect.Schema.Struct({
+	threadId: TrimmedNonEmptyString,
+	isResolved: effect.Schema.Boolean,
+	resolvedBy: effect.Schema.optional(TrimmedNonEmptyString)
+});
+const ChangeRequestCommentKind = effect.Schema.Literals([
+	"issue-comment",
+	"review-comment",
+	"review"
+]);
+const ChangeRequestUpdateCommentInput = effect.Schema.Union([effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	reference: TrimmedNonEmptyString,
+	commentId: TrimmedNonEmptyString,
+	commentKind: ChangeRequestCommentKind,
+	action: effect.Schema.Literal("edit"),
+	body: NonBlankMarkdownBody
+}), effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	reference: TrimmedNonEmptyString,
+	commentId: TrimmedNonEmptyString,
+	commentKind: effect.Schema.Literals(["issue-comment", "review-comment"]),
+	action: effect.Schema.Literal("delete")
+})]);
+const ChangeRequestUpdateCommentResult = effect.Schema.Struct({
+	commentId: TrimmedNonEmptyString,
+	deleted: effect.Schema.Boolean
+});
+const ListEdit = {
+	add: effect.Schema.Array(TrimmedNonEmptyString),
+	remove: effect.Schema.Array(TrimmedNonEmptyString)
+};
+const ChangeRequestUpdateAction = effect.Schema.Union([
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("edit"),
+		title: effect.Schema.optional(TrimmedNonEmptyString),
+		body: effect.Schema.optional(effect.Schema.String),
+		baseRefName: effect.Schema.optional(TrimmedNonEmptyString)
+	}),
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("set-draft"),
+		draft: effect.Schema.Boolean
+	}),
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("close"),
+		deleteBranch: effect.Schema.optional(effect.Schema.Boolean)
+	}),
+	effect.Schema.Struct({ kind: effect.Schema.Literal("reopen") }),
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("reviewers"),
+		...ListEdit
+	}),
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("labels"),
+		...ListEdit
+	}),
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("assignees"),
+		...ListEdit
+	}),
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("update-branch"),
+		method: effect.Schema.Literals(["merge", "rebase"]),
+		expectedHeadSha: TrimmedNonEmptyString
+	}),
+	effect.Schema.Struct({
+		kind: effect.Schema.Literal("auto-merge"),
+		enabled: effect.Schema.Boolean,
+		mergeMethod: effect.Schema.optional(SourceControlChangeRequestMergeMethod),
+		/** When enabling: refuse if the head moved since the user looked (as for merges). */
+		expectedHeadSha: effect.Schema.optional(TrimmedNonEmptyString)
+	}),
+	effect.Schema.Struct({ kind: effect.Schema.Literal("delete-branch") })
+]);
+const ChangeRequestUpdateInput = effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	reference: TrimmedNonEmptyString,
+	action: ChangeRequestUpdateAction
+});
+const ChangeRequestUpdateResult = effect.Schema.Struct({ 
+/** Fresh, uncapped (`fullContent`) detail after the action. */
+detail: SourceControlChangeRequestDetail });
+const ChangeRequestCreateInput = effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	baseRefName: TrimmedNonEmptyString,
+	/** Branch name, or `owner:branch` for a fork head. */
+	headRefName: TrimmedNonEmptyString,
+	title: TrimmedNonEmptyString,
+	body: effect.Schema.String,
+	draft: effect.Schema.optional(effect.Schema.Boolean)
+});
+const CHANGE_REQUEST_FILE_CONTENTS_MAX_BYTES = 1048576;
+const ChangeRequestFileContentsInput = effect.Schema.Struct({
+	cwd: TrimmedNonEmptyString,
+	reference: TrimmedNonEmptyString,
+	path: TrimmedNonEmptyString,
+	/** Pre-rename path on the base side, when the file moved. */
+	previousPath: effect.Schema.optional(TrimmedNonEmptyString),
+	/**
+	* Old-side revision. Omit for the whole change request: the server resolves
+	* the merge base of the base branch and `headSha`, matching the PR diff.
+	* Pass the parent commit when the diff is scoped to a single commit.
+	*/
+	baseSha: effect.Schema.optional(TrimmedNonEmptyString),
+	headSha: TrimmedNonEmptyString
+});
+const ChangeRequestFileContents = effect.Schema.Struct({
+	path: TrimmedNonEmptyString,
+	/** Null when the file does not exist on that side (added/deleted) or is binary. */
+	oldContents: effect.Schema.NullOr(effect.Schema.String),
+	newContents: effect.Schema.NullOr(effect.Schema.String),
+	truncated: effect.Schema.Boolean
+});
+/** Server-side involvement filter for change request lists (relative to the viewer). */
+const ChangeRequestInvolvement = effect.Schema.Literals([
+	"authored",
+	"review-requested",
+	"assigned",
+	"mentioned",
+	"involved"
+]);
+//#endregion
 //#region ../../packages/contracts/src/atlassian.ts
 const AtlassianConnectionKind = effect.Schema.Literals([
 	"oauth_3lo",
@@ -10519,6 +11870,15 @@ const AgentControlRequestId = TrimmedNonEmptyString.check(effect.Schema.isMaxLen
 * per-provider-runtime, in-memory, thread-bound, and revoked on runtime
 * teardown — none of that credential material appears in this contract.
 */
+/** Audit-safe target thread state captured at submission and used to reject stale approved plans. */
+const AgentControlTargetThreadSnapshot = effect.Schema.Struct({
+	threadId: ThreadId,
+	projectId: ProjectId,
+	runtimeMode: RuntimeMode,
+	envMode: ThreadEnvMode,
+	archived: effect.Schema.Boolean,
+	activeTurnId: effect.Schema.NullOr(TurnId)
+});
 const AgentControlProviderSessionPrincipal = effect.Schema.Struct({
 	kind: effect.Schema.Literal("provider-session"),
 	threadId: ThreadId,
@@ -10532,28 +11892,26 @@ const AgentControlProviderSessionPrincipal = effect.Schema.Struct({
 	originRuntimeMode: effect.Schema.optional(RuntimeMode),
 	originEnvMode: effect.Schema.optional(ThreadEnvMode),
 	/** Audit-safe target state used to reject stale approved plans. */
-	targetSnapshots: effect.Schema.optional(effect.Schema.Array(effect.Schema.Struct({
-		threadId: ThreadId,
-		projectId: ProjectId,
-		runtimeMode: RuntimeMode,
-		envMode: ThreadEnvMode,
-		archived: effect.Schema.Boolean,
-		activeTurnId: effect.Schema.NullOr(TurnId)
-	})))
+	targetSnapshots: effect.Schema.optional(effect.Schema.Array(AgentControlTargetThreadSnapshot))
 });
 /**
-* A separately paired local MCP client. Pairing, credential issuance, and
-* scope grants are owned by later PRs; the principal identity is defined
-* here so proposals persist a stable, audit-safe origin from day one.
+* A separately paired local MCP client. It has no caller thread, so its
+* privilege evidence is the integration's grant ceiling at submission.
 */
 const AgentControlExternalIntegrationPrincipal = effect.Schema.Struct({
 	kind: effect.Schema.Literal("external-integration"),
 	integrationId: AgentControlIntegrationId,
 	label: effect.Schema.optional(TrimmedNonEmptyString.check(effect.Schema.isMaxLength(120))),
-	/** Immutable execution-policy evidence captured when the proposal is created. */
+	/**
+	* Immutable execution-policy evidence captured when the proposal is created:
+	* the task's own policy for created threads, or the integration's runtime
+	* and checkout ceiling for thread control.
+	*/
 	projectId: effect.Schema.optional(ProjectId),
 	runtimeMode: effect.Schema.optional(RuntimeMode),
-	envMode: effect.Schema.optional(ThreadEnvMode)
+	envMode: effect.Schema.optional(ThreadEnvMode),
+	/** Audit-safe target state for thread control, used to reject stale approved plans. */
+	targetSnapshots: effect.Schema.optional(effect.Schema.Array(AgentControlTargetThreadSnapshot))
 });
 /** Owner-authored automation only; never accepted from an MCP principal. */
 const AgentControlAutomationOwnerPrincipal = effect.Schema.Struct({
@@ -10577,6 +11935,8 @@ const AgentControlCapability = agentControlSlug.pipe(effect.Schema.brand("AgentC
 const AGENT_CONTROL_CAPABILITIES = {
 	read: AgentControlCapability.make("read"),
 	attachFile: AgentControlCapability.make("files.attach"),
+	/** Preview HTML pages in Ryco's headless browser and show them inline in the caller's thread. */
+	renderHtml: AgentControlCapability.make("html.render"),
 	createThreads: AgentControlCapability.make("threads.create"),
 	sendMessage: AgentControlCapability.make("threads.send-message"),
 	interruptThread: AgentControlCapability.make("threads.interrupt"),
@@ -10604,7 +11964,13 @@ const AGENT_CONTROL_CAPABILITIES = {
 	externalReadAutomations: AgentControlCapability.make("external.automations.read"),
 	externalManageAutomations: AgentControlCapability.make("external.automations.manage"),
 	externalReadActivity: AgentControlCapability.make("external.activity.read"),
-	externalReadDiagnostics: AgentControlCapability.make("external.diagnostics.read")
+	externalReadDiagnostics: AgentControlCapability.make("external.diagnostics.read"),
+	externalReadThreads: AgentControlCapability.make("external.threads.read"),
+	externalReadReviews: AgentControlCapability.make("external.reviews.read"),
+	externalReadFiles: AgentControlCapability.make("external.files.read"),
+	externalReadWorkspaces: AgentControlCapability.make("external.workspaces.read"),
+	externalControlThreads: AgentControlCapability.make("external.threads.control"),
+	externalManageWorkspaces: AgentControlCapability.make("external.workspaces.manage")
 };
 const AgentControlActionKind = effect.Schema.Literals([
 	"createThreads",
@@ -11817,6 +13183,7 @@ const AgentControlMcpReadDeviceStateResult = effect.Schema.Struct({
 });
 const AgentControlMcpProjectSummary = effect.Schema.Struct({
 	projectId: ProjectId,
+	kind: OptionalProjectKind,
 	title: TrimmedNonEmptyString,
 	createdAt: IsoDateTime,
 	updatedAt: IsoDateTime
@@ -12185,7 +13552,24 @@ const AGENT_CONTROL_EXTERNAL_MCP_TOOLS = {
 	recentActivity: "ryco_recent_activity",
 	orchestrationEvents: "ryco_orchestration_events",
 	providerRuntimeEvents: "ryco_provider_runtime_events",
-	diagnosticsSummary: "ryco_diagnostics_summary"
+	diagnosticsSummary: "ryco_diagnostics_summary",
+	readControlRequest: "ryco_read_control_request",
+	waitForControlRequest: "ryco_wait_for_control_request",
+	listThreads: "ryco_list_threads",
+	readThread: "ryco_read_thread",
+	searchThreads: "ryco_search_threads",
+	waitThreads: "ryco_wait_threads",
+	inspectThread: "ryco_inspect_thread",
+	readThreadDiff: "ryco_read_thread_diff",
+	readThreadFile: "ryco_read_thread_file",
+	readProject: "ryco_read_project",
+	listWorkspaces: "ryco_list_workspaces",
+	readWorkspace: "ryco_read_workspace",
+	sendMessage: "ryco_send_message",
+	interruptThread: "ryco_interrupt_thread",
+	updateThread: "ryco_update_thread",
+	planWorkspace: "ryco_plan_workspace_lifecycle",
+	proposeWorkspace: "ryco_propose_workspace_lifecycle"
 };
 const AGENT_CONTROL_EXTERNAL_MCP_TOOL_NAMES = Object.values(AGENT_CONTROL_EXTERNAL_MCP_TOOLS);
 const AgentControlExternalCreateTaskInput = effect.Schema.Struct({
@@ -12374,6 +13758,107 @@ const ProjectReadIconResult = effect.Schema.NullOr(effect.Schema.Struct({
 	])
 }));
 var ProjectReadIconError = class extends effect.Schema.TaggedError()("ProjectReadIconError", { message: TrimmedNonEmptyString }) {};
+/** Server-local absolute directory; access and filesystem validation belong to the server. */
+const ProjectChatDestination = TrimmedNonEmptyString.check(effect.Schema.isMaxLength(4096));
+/**
+* Where a promoted chat folder would go. Only `available` can be promoted:
+* - `exists`: something is already at the destination, or another chat is moving there.
+* - `invalid`: not an absolute path, or its parent is missing or not a writable directory.
+* - `access-denied`: the workspace access policy rejects it.
+* - `inside-chats`: it lies inside the chats root.
+* - `inside-source`: it lies inside the chat folder being moved.
+* - `retired-checkout`: it is at or inside a workspace checkout Ryco removed (or is removing or
+*   moving). The server keeps new work out of such paths, so a project there could never run.
+*/
+const ProjectChatDestinationStatus = effect.Schema.Literals([
+	"available",
+	"exists",
+	"invalid",
+	"access-denied",
+	"inside-chats",
+	"inside-source",
+	"retired-checkout"
+]);
+const ProjectsPromoteChatPreviewInput = effect.Schema.Struct({
+	projectId: ProjectId,
+	/** Absent previews the default destination. Any text is accepted and judged in the result. */
+	destination: effect.Schema.optional(effect.Schema.String.check(effect.Schema.isMaxLength(4096)))
+});
+/** Read-only: previewing never creates, moves or locks anything. */
+const ProjectsPromoteChatPreviewResult = effect.Schema.Struct({
+	projectId: ProjectId,
+	/** The chat folder that would move. */
+	source: TrimmedNonEmptyString,
+	/**
+	* A free folder under `addProjectBaseDirectory` (or its default): `<slug>` when nothing is there,
+	* otherwise the first free `<slug>-2`, `<slug>-3`, …
+	*/
+	defaultDestination: TrimmedNonEmptyString,
+	/** The destination that was judged: the input's (normalized) or the default. */
+	destination: effect.Schema.String,
+	destinationStatus: ProjectChatDestinationStatus,
+	fileCount: NonNegativeInt,
+	totalBytes: NonNegativeInt,
+	/** The scan stopped at its bound; the counts are lower limits. */
+	countTruncated: effect.Schema.Boolean,
+	/** Threads with live work (running turn, pending approval or input, queued dispatch). */
+	busyThreadIds: effect.Schema.Array(ThreadId),
+	gitAvailable: effect.Schema.Boolean,
+	/** Whether `user.name` and `user.email` resolve, so an initial commit can succeed. */
+	gitIdentityConfigured: effect.Schema.Boolean,
+	/** Source and destination are on different devices: the move is a copy, then a delete. */
+	crossDevice: effect.Schema.Boolean
+});
+const ProjectsPromoteChatInput = effect.Schema.Struct({
+	projectId: ProjectId,
+	/** Compare-and-set guard against the project as previewed. */
+	expectedUpdatedAt: effect.Schema.optional(IsoDateTime),
+	title: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(200)),
+	destination: ProjectChatDestination,
+	initializeGit: effect.Schema.Boolean,
+	/** Ignored unless `initializeGit`. */
+	initialCommit: effect.Schema.Boolean,
+	/** Ignored unless `initializeGit`; never overwrites an existing `.gitignore`. */
+	writeGitignore: effect.Schema.Boolean
+});
+const ProjectsPromoteChatResult = effect.Schema.Struct({
+	projectId: ProjectId,
+	workspaceRoot: TrimmedNonEmptyString,
+	gitInitialized: effect.Schema.Boolean,
+	initialCommitCreated: effect.Schema.Boolean,
+	/** The project was promoted, but its first commit failed (for example, no Git identity). */
+	commitError: effect.Schema.optional(effect.Schema.String)
+});
+/**
+* The explicit "Also delete files" step for a chat. Refused while the chat still has threads, and
+* never removes anything outside the chats root.
+*/
+const ProjectsDeleteChatFolderInput = effect.Schema.Struct({ projectId: ProjectId });
+const ProjectsDeleteChatFolderResult = effect.Schema.Struct({ 
+/** False when the folder was already gone. */
+deleted: effect.Schema.Boolean });
+const ProjectChatErrorReason = effect.Schema.Literals([
+	"not-found",
+	"not-chat",
+	"busy",
+	"stale",
+	"destination-exists",
+	"destination-invalid",
+	"destination-inside-chats",
+	"destination-inside-source",
+	"destination-retired-checkout",
+	"access-denied",
+	"move-failed",
+	"git-failed",
+	"chats-unavailable",
+	"has-threads",
+	"outside-chats-root"
+]);
+/** One error for every chat-folder RPC; `reason` is the stable, machine-readable part. */
+var ProjectChatError = class extends effect.Schema.TaggedError()("ProjectChatError", {
+	reason: ProjectChatErrorReason,
+	message: TrimmedNonEmptyString
+}) {};
 //#endregion
 //#region ../../packages/contracts/src/filesystem.ts
 const FILESYSTEM_PATH_MAX_LENGTH = 512;
@@ -12397,6 +13882,195 @@ var FilesystemBrowseError = class extends effect.Schema.TaggedError()("Filesyste
 	cause: effect.Schema.optional(effect.Schema.Defect())
 }) {};
 //#endregion
+//#region ../../packages/contracts/src/localTasks.ts
+const LocalTaskId = effect.Schema.String.check(effect.Schema.isPattern(/^[a-zA-Z0-9_-]{1,128}$/));
+const Title = effect.Schema.String.check(effect.Schema.isMinLength(1), effect.Schema.isMaxLength(500));
+const Notes = effect.Schema.String.check(effect.Schema.isMaxLength(2e4));
+const LocalTaskPriority = effect.Schema.Literals([
+	"low",
+	"normal",
+	"high",
+	"urgent"
+]);
+const LocalTaskFields = {
+	title: Title,
+	notes: Notes,
+	priority: LocalTaskPriority,
+	dueAt: effect.Schema.NullOr(IsoDateTime),
+	projectId: effect.Schema.NullOr(ProjectId)
+};
+const LocalTaskStatus = effect.Schema.Literals([
+	"todo",
+	"starting",
+	"running",
+	"needs-you",
+	"review",
+	"failed",
+	"unavailable",
+	"done"
+]);
+const LocalTask = effect.Schema.Struct({
+	taskId: LocalTaskId,
+	revision: NonNegativeInt,
+	...LocalTaskFields,
+	state: effect.Schema.Literals(["todo", "done"]),
+	status: LocalTaskStatus,
+	delegation: effect.Schema.NullOr(effect.Schema.Struct({
+		threadId: ThreadId,
+		messageId: MessageId,
+		commandId: CommandId,
+		dispatched: effect.Schema.Boolean
+	})),
+	createdAt: IsoDateTime,
+	updatedAt: IsoDateTime
+});
+const LocalTaskCreateInput = effect.Schema.Struct({
+	taskId: LocalTaskId,
+	...LocalTaskFields
+});
+const LocalTaskUpdateInput = effect.Schema.Struct({
+	taskId: LocalTaskId,
+	expectedRevision: NonNegativeInt,
+	title: effect.Schema.optional(Title),
+	notes: effect.Schema.optional(Notes),
+	priority: effect.Schema.optional(LocalTaskPriority),
+	dueAt: effect.Schema.optional(effect.Schema.NullOr(IsoDateTime)),
+	projectId: effect.Schema.optional(effect.Schema.NullOr(ProjectId)),
+	state: effect.Schema.optional(effect.Schema.Literals(["todo", "done"]))
+});
+const LocalTaskDeleteInput = effect.Schema.Struct({
+	taskId: LocalTaskId,
+	expectedRevision: NonNegativeInt
+});
+const LocalTaskListInput = effect.Schema.Struct({
+	limit: effect.Schema.optional(effect.Schema.Int.check(effect.Schema.isBetween({
+		minimum: 1,
+		maximum: 100
+	}))),
+	afterId: effect.Schema.optional(LocalTaskId)
+});
+const LocalTaskListResult = effect.Schema.Struct({
+	tasks: effect.Schema.Array(LocalTask),
+	nextCursor: effect.Schema.NullOr(LocalTaskId)
+});
+const LocalTaskDelegateInput = effect.Schema.Struct({
+	taskId: LocalTaskId,
+	expectedRevision: NonNegativeInt,
+	command: ClientThreadTurnStartCommand
+});
+var LocalTaskError = class extends effect.Schema.TaggedError()("LocalTaskError", {
+	reason: effect.Schema.Literals([
+		"not-found",
+		"conflict",
+		"invalid",
+		"persistence"
+	]),
+	message: effect.Schema.String
+}) {};
+//#endregion
+//#region ../../packages/contracts/src/notes.ts
+/** `worktree` belongs to one checkout; `project` is shared by the whole project. */
+const NoteScope = effect.Schema.Literals(["worktree", "project"]);
+/** Free text; empty is a cleared document. */
+const NoteBody = effect.Schema.String.check(effect.Schema.isMaxLength(1e5));
+/**
+* One free-text notes document: a checkout's (`scope: "worktree"`, keyed by
+* its worktree, `null` for the main checkout) or the project's own
+* (`scope: "project"`, always `worktreeId: null`).
+*/
+const NotesDocument = effect.Schema.Struct({
+	projectId: ProjectId,
+	scope: NoteScope,
+	worktreeId: effect.Schema.NullOr(WorktreeId),
+	body: NoteBody,
+	/** Bumped by every save; a document never saved is revision 0 and is not listed. */
+	revision: NonNegativeInt,
+	updatedAt: IsoDateTime
+});
+const NotesListInput = effect.Schema.Struct({ projectId: ProjectId });
+const NotesSnapshot = effect.Schema.Struct({
+	projectId: ProjectId,
+	/** The project's document and every live checkout's, in no particular order. */
+	documents: effect.Schema.Array(NotesDocument)
+});
+/** Replaces one document's body; judged against the revision the edit started from. */
+const NotesCommand = effect.Schema.Struct({
+	kind: effect.Schema.Literal("save"),
+	projectId: ProjectId,
+	scope: NoteScope,
+	/** Must be `null` for the project's document. */
+	worktreeId: effect.Schema.NullOr(WorktreeId),
+	body: NoteBody,
+	/** The revision the edit was based on (0 for a document never saved). */
+	expectedRevision: NonNegativeInt
+}).annotate({ parseOptions: { onExcessProperty: "error" } });
+var NotesError = class extends effect.Schema.TaggedError()("NotesError", {
+	reason: effect.Schema.Literals([
+		"conflict",
+		"invalid",
+		"persistence"
+	]),
+	message: effect.Schema.String
+}) {};
+//#endregion
+//#region ../../packages/contracts/src/dailyRecap.ts
+const DailyRecapRequest = effect.Schema.Struct({
+	date: UsageCalendarDate,
+	timeZone: TrimmedNonEmptyString,
+	/** Maximum threads in each section; defaults to 20. Counts remain complete. */
+	limit: effect.Schema.optional(PositiveInt.check(effect.Schema.isLessThanOrEqualTo(50)))
+});
+const DailyRecapThread = effect.Schema.Struct({
+	threadId: ThreadId,
+	threadTitle: effect.Schema.String,
+	projectId: ProjectId,
+	projectTitle: effect.Schema.String,
+	lastActivityAt: IsoDateTime
+});
+const DailyRecapAttentionThread = effect.Schema.Struct({
+	...DailyRecapThread.fields,
+	pendingApprovals: NonNegativeInt,
+	pendingUserInputs: NonNegativeInt,
+	hasProposedPlan: effect.Schema.Boolean,
+	sessionError: effect.Schema.Boolean
+});
+const DailyRecapThreadSection = effect.Schema.Struct({
+	totalThreads: NonNegativeInt,
+	threads: effect.Schema.Array(DailyRecapThread),
+	truncated: effect.Schema.Boolean
+});
+const DailyRecapSnapshot = effect.Schema.Struct({
+	date: UsageCalendarDate,
+	timeZone: TrimmedNonEmptyString,
+	generatedAt: IsoDateTime,
+	/** Exact UTC interval for the selected local calendar day; end is exclusive. */
+	from: IsoDateTime,
+	to: IsoDateTime,
+	/** Ryco turn outcomes in this day, excluding deleted threads and projects. */
+	counts: effect.Schema.Struct({
+		completedTurns: NonNegativeInt,
+		failedTurns: NonNegativeInt,
+		interruptedTurns: NonNegativeInt
+	}),
+	/** Sections are independent: a thread may have both successful and failed turns. */
+	completed: DailyRecapThreadSection,
+	failed: DailyRecapThreadSection,
+	/** Current outstanding attention, regardless of the selected day; excludes archived threads. */
+	needsAttention: effect.Schema.Struct({
+		totalThreads: NonNegativeInt,
+		threads: effect.Schema.Array(DailyRecapAttentionThread),
+		truncated: effect.Schema.Boolean
+	})
+});
+var DailyRecapReadError = class extends effect.Schema.TaggedError()("DailyRecapReadError", {
+	reason: effect.Schema.Literals([
+		"invalid-date",
+		"invalid-time-zone",
+		"query-failed"
+	]),
+	detail: TrimmedNonEmptyString
+}) {};
+//#endregion
 //#region ../../packages/contracts/src/sessionImport.ts
 const SessionImportSource = effect.Schema.Literals(["codex", "claudeAgent"]);
 const ImportKey = effect.Schema.String.check(effect.Schema.isPattern(/^[a-f0-9]{64}$/));
@@ -12584,6 +14258,7 @@ const WS_METHODS = {
 	vcsRefreshStatus: "vcs.refreshStatus",
 	vcsListRefs: "vcs.listRefs",
 	vcsReadLineBlame: "vcs.readLineBlame",
+	vcsReadImageBlob: "vcs.readImageBlob",
 	vcsReadLocalChanges: "vcs.readLocalChanges",
 	vcsApplyIndexPatch: "vcs.applyIndexPatch",
 	vcsReadComparison: "vcs.readComparison",
@@ -12600,10 +14275,18 @@ const WS_METHODS = {
 	gitArchiveWorktree: "git.archiveWorktree",
 	gitRestoreWorktree: "git.restoreWorktree",
 	gitDeleteWorktree: "git.deleteWorktree",
+	lifecycleListWorkspaces: "lifecycle.listWorkspaces",
+	lifecyclePreviewWorkspace: "lifecycle.previewWorkspace",
+	lifecycleApplyWorkspace: "lifecycle.applyWorkspace",
+	lifecycleSuggestions: "lifecycle.suggestions",
+	lifecycleListTrash: "lifecycle.listTrash",
 	threadsSetManualBucket: "threads.setManualBucket",
 	threadsSetManualPosition: "threads.setManualPosition",
 	worktreesSetManualPosition: "worktrees.setManualPosition",
 	projectsInitializeGit: "projects.initializeGit",
+	projectsPromoteChatPreview: "projects.promoteChatPreview",
+	projectsPromoteChat: "projects.promoteChat",
+	projectsDeleteChatFolder: "projects.deleteChatFolder",
 	searchThreadMessages: "threads.searchMessages",
 	threadPriorityEnsureCurrent: "threadPriority.ensureCurrent",
 	terminalOpen: "terminal.open",
@@ -12621,6 +14304,15 @@ const WS_METHODS = {
 	serverAuthenticateAcpRegistry: "server.authenticateAcpRegistry",
 	serverReadCodexResetCredits: "server.readCodexResetCredits",
 	serverConsumeCodexResetCredit: "server.consumeCodexResetCredit",
+	serverListLocalTasks: "server.listLocalTasks",
+	serverGetLocalTask: "server.getLocalTask",
+	serverCreateLocalTask: "server.createLocalTask",
+	serverUpdateLocalTask: "server.updateLocalTask",
+	serverDeleteLocalTask: "server.deleteLocalTask",
+	serverDelegateLocalTask: "server.delegateLocalTask",
+	serverGetDailyRecap: "server.getDailyRecap",
+	notesList: "notes.list",
+	notesCommand: "notes.command",
 	serverRefreshProviders: "server.refreshProviders",
 	serverUpdateProvider: "server.updateProvider",
 	serverUpsertKeybinding: "server.upsertKeybinding",
@@ -12670,6 +14362,14 @@ const WS_METHODS = {
 	sourceControlGetWorkflowRunJobs: "sourceControl.getWorkflowRunJobs",
 	sourceControlGetWorkflowJobLog: "sourceControl.getWorkflowJobLog",
 	sourceControlRerunWorkflow: "sourceControl.rerunWorkflow",
+	sourceControlGetChangeRequestActivity: "sourceControl.getChangeRequestActivity",
+	sourceControlGetChangeRequestFileContents: "sourceControl.getChangeRequestFileContents",
+	sourceControlSubmitChangeRequestReview: "sourceControl.submitChangeRequestReview",
+	sourceControlReplyToReviewThread: "sourceControl.replyToReviewThread",
+	sourceControlSetReviewThreadResolved: "sourceControl.setReviewThreadResolved",
+	sourceControlUpdateChangeRequestComment: "sourceControl.updateChangeRequestComment",
+	sourceControlUpdateChangeRequest: "sourceControl.updateChangeRequest",
+	sourceControlCreateChangeRequest: "sourceControl.createChangeRequest",
 	textGenerationGenerateIssueContent: "textGeneration.generateIssueContent",
 	textGenerationAskSideQuestion: "textGeneration.askSideQuestion",
 	textGenerationCancelSideQuestion: "textGeneration.cancelSideQuestion",
@@ -12873,6 +14573,55 @@ const WsServerConsumeCodexResetCreditRpc = effect_unstable_rpc_Rpc.make(WS_METHO
 	success: effect.Schema.Struct({ outcome: CodexResetCreditOutcome }),
 	error: effect.Schema.Union([CodexResetCreditError, AuthRpcError])
 });
+const WsServerListLocalTasksRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.serverListLocalTasks, {
+	payload: LocalTaskListInput,
+	success: LocalTaskListResult,
+	error: effect.Schema.Union([LocalTaskError, AuthRpcError])
+});
+const WsServerGetLocalTaskRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.serverGetLocalTask, {
+	payload: effect.Schema.Struct({ taskId: LocalTaskId }),
+	success: LocalTask,
+	error: effect.Schema.Union([LocalTaskError, AuthRpcError])
+});
+const WsServerCreateLocalTaskRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.serverCreateLocalTask, {
+	payload: LocalTaskCreateInput,
+	success: LocalTask,
+	error: effect.Schema.Union([LocalTaskError, AuthRpcError])
+});
+const WsServerUpdateLocalTaskRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.serverUpdateLocalTask, {
+	payload: LocalTaskUpdateInput,
+	success: LocalTask,
+	error: effect.Schema.Union([LocalTaskError, AuthRpcError])
+});
+const WsServerDeleteLocalTaskRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.serverDeleteLocalTask, {
+	payload: LocalTaskDeleteInput,
+	success: effect.Schema.Struct({ deleted: effect.Schema.Literal(true) }),
+	error: effect.Schema.Union([LocalTaskError, AuthRpcError])
+});
+const WsServerDelegateLocalTaskRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.serverDelegateLocalTask, {
+	payload: LocalTaskDelegateInput,
+	success: LocalTask,
+	error: effect.Schema.Union([
+		LocalTaskError,
+		AuthRpcError,
+		OrchestrationDispatchCommandError
+	])
+});
+const WsNotesListRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.notesList, {
+	payload: NotesListInput,
+	success: NotesSnapshot,
+	error: effect.Schema.Union([NotesError, AuthRpcError])
+});
+const WsNotesCommandRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.notesCommand, {
+	payload: NotesCommand,
+	success: NotesSnapshot,
+	error: effect.Schema.Union([NotesError, AuthRpcError])
+});
+const WsServerGetDailyRecapRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.serverGetDailyRecap, {
+	payload: DailyRecapRequest,
+	success: DailyRecapSnapshot,
+	error: effect.Schema.Union([DailyRecapReadError, AuthRpcError])
+});
 const WsServerRefreshProvidersRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.serverRefreshProviders, {
 	payload: effect.Schema.Struct({ 
 	/**
@@ -13051,7 +14800,9 @@ const WsSourceControlListChangeRequestsRpc = effect_unstable_rpc_Rpc.make(WS_MET
 			"all"
 		]),
 		limit: effect.Schema.optional(effect.Schema.Number),
-		query: effect.Schema.optional(effect.Schema.String)
+		query: effect.Schema.optional(effect.Schema.String),
+		/** Narrow to change requests involving the authenticated viewer. */
+		involvement: effect.Schema.optional(ChangeRequestInvolvement)
 	}),
 	success: effect.Schema.Array(ChangeRequest),
 	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
@@ -13088,7 +14839,9 @@ const WsSourceControlGetChangeRequestDiffRpc = effect_unstable_rpc_Rpc.make(WS_M
 	payload: effect.Schema.Struct({
 		cwd: effect.Schema.String,
 		reference: effect.Schema.String,
-		expectedHeadSha: effect.Schema.optional(TrimmedNonEmptyString)
+		expectedHeadSha: effect.Schema.optional(TrimmedNonEmptyString),
+		/** Scope the diff to a single commit of the change request. */
+		commitSha: effect.Schema.optional(TrimmedNonEmptyString)
 	}),
 	success: effect.Schema.String,
 	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
@@ -13137,24 +14890,64 @@ const WsSourceControlListIssueAssigneesRpc = effect_unstable_rpc_Rpc.make(WS_MET
 	success: effect.Schema.Array(SourceControlAssigneeCandidate),
 	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
 });
-const WsSourceControlListWorkflowRunsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlListWorkflowRuns, {
-	payload: SourceControlWorkflowRunListInput,
-	success: SourceControlWorkflowRunListResult,
+const WsSourceControlListWorkflowRunsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlListWorkflowRuns, {
+	payload: SourceControlWorkflowRunListInput,
+	success: SourceControlWorkflowRunListResult,
+	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
+});
+const WsSourceControlGetWorkflowRunJobsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlGetWorkflowRunJobs, {
+	payload: SourceControlWorkflowRunJobsInput,
+	success: SourceControlWorkflowRunJobsResult,
+	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
+});
+const WsSourceControlGetWorkflowJobLogRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlGetWorkflowJobLog, {
+	payload: SourceControlWorkflowJobLogInput,
+	success: SourceControlWorkflowJobLogResult,
+	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
+});
+const WsSourceControlRerunWorkflowRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlRerunWorkflow, {
+	payload: SourceControlWorkflowRerunInput,
+	success: SourceControlWorkflowRerunResult,
+	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
+});
+const WsSourceControlGetChangeRequestActivityRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlGetChangeRequestActivity, {
+	payload: ChangeRequestActivityInput,
+	success: ChangeRequestActivity,
+	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
+});
+const WsSourceControlGetChangeRequestFileContentsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlGetChangeRequestFileContents, {
+	payload: ChangeRequestFileContentsInput,
+	success: ChangeRequestFileContents,
+	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
+});
+const WsSourceControlSubmitChangeRequestReviewRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlSubmitChangeRequestReview, {
+	payload: ChangeRequestSubmitReviewInput,
+	success: ChangeRequestSubmitReviewResult,
+	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
+});
+const WsSourceControlReplyToReviewThreadRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlReplyToReviewThread, {
+	payload: ChangeRequestReplyToThreadInput,
+	success: ChangeRequestReplyToThreadResult,
+	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
+});
+const WsSourceControlSetReviewThreadResolvedRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlSetReviewThreadResolved, {
+	payload: ChangeRequestSetThreadResolvedInput,
+	success: ChangeRequestSetThreadResolvedResult,
 	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
 });
-const WsSourceControlGetWorkflowRunJobsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlGetWorkflowRunJobs, {
-	payload: SourceControlWorkflowRunJobsInput,
-	success: SourceControlWorkflowRunJobsResult,
+const WsSourceControlUpdateChangeRequestCommentRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlUpdateChangeRequestComment, {
+	payload: ChangeRequestUpdateCommentInput,
+	success: ChangeRequestUpdateCommentResult,
 	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
 });
-const WsSourceControlGetWorkflowJobLogRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlGetWorkflowJobLog, {
-	payload: SourceControlWorkflowJobLogInput,
-	success: SourceControlWorkflowJobLogResult,
+const WsSourceControlUpdateChangeRequestRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlUpdateChangeRequest, {
+	payload: ChangeRequestUpdateInput,
+	success: ChangeRequestUpdateResult,
 	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
 });
-const WsSourceControlRerunWorkflowRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlRerunWorkflow, {
-	payload: SourceControlWorkflowRerunInput,
-	success: SourceControlWorkflowRerunResult,
+const WsSourceControlCreateChangeRequestRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.sourceControlCreateChangeRequest, {
+	payload: ChangeRequestCreateInput,
+	success: ChangeRequest,
 	error: effect.Schema.Union([SourceControlProviderError, AuthRpcError])
 });
 const WsTextGenerationAskSideQuestionRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.textGenerationAskSideQuestion, {
@@ -13449,6 +15242,31 @@ const WsGitDeleteWorktreeRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.gitDelete
 	success: EmptyRpcResult,
 	error: effect.Schema.Union([GitManagerServiceError, AuthRpcError])
 });
+const WsLifecycleListWorkspacesRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.lifecycleListWorkspaces, {
+	payload: WorkspaceLifecycleListInput,
+	success: effect.Schema.Array(WorkspaceLifecycleSummary),
+	error: effect.Schema.Union([WorkspaceLifecycleError, AuthRpcError])
+});
+const WsLifecyclePreviewWorkspaceRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.lifecyclePreviewWorkspace, {
+	payload: WorkspaceLifecycleRequest,
+	success: WorkspaceLifecyclePreview,
+	error: effect.Schema.Union([WorkspaceLifecycleError, AuthRpcError])
+});
+const WsLifecycleApplyWorkspaceRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.lifecycleApplyWorkspace, {
+	payload: WorkspaceLifecycleApplyInput,
+	success: WorkspaceLifecycleResult,
+	error: effect.Schema.Union([WorkspaceLifecycleError, AuthRpcError])
+});
+const WsLifecycleSuggestionsRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.lifecycleSuggestions, {
+	payload: effect.Schema.Struct({}),
+	success: LifecycleSuggestions,
+	error: effect.Schema.Union([WorkspaceLifecycleError, AuthRpcError])
+});
+const WsLifecycleListTrashRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.lifecycleListTrash, {
+	payload: effect.Schema.Struct({}),
+	success: TrashListResult,
+	error: effect.Schema.Union([WorkspaceLifecycleError, AuthRpcError])
+});
 const WsThreadsSetManualBucketRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.threadsSetManualBucket, {
 	payload: ThreadsSetManualBucketInput,
 	success: EmptyRpcResult,
@@ -13479,11 +15297,31 @@ const WsProjectsInitializeGitRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.proje
 	success: EmptyRpcResult,
 	error: effect.Schema.Union([GitManagerServiceError, AuthRpcError])
 });
+const WsProjectsPromoteChatPreviewRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.projectsPromoteChatPreview, {
+	payload: ProjectsPromoteChatPreviewInput,
+	success: ProjectsPromoteChatPreviewResult,
+	error: effect.Schema.Union([ProjectChatError, AuthRpcError])
+});
+const WsProjectsPromoteChatRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.projectsPromoteChat, {
+	payload: ProjectsPromoteChatInput,
+	success: ProjectsPromoteChatResult,
+	error: effect.Schema.Union([ProjectChatError, AuthRpcError])
+});
+const WsProjectsDeleteChatFolderRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.projectsDeleteChatFolder, {
+	payload: ProjectsDeleteChatFolderInput,
+	success: ProjectsDeleteChatFolderResult,
+	error: effect.Schema.Union([ProjectChatError, AuthRpcError])
+});
 const WsVcsReadLineBlameRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.vcsReadLineBlame, {
 	payload: GitReadLineBlameInput,
 	success: GitReadLineBlameResult,
 	error: effect.Schema.Union([GitCommandError, AuthRpcError])
 });
+const WsVcsReadImageBlobRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.vcsReadImageBlob, {
+	payload: GitReadImageBlobInput,
+	success: GitReadImageBlobResult,
+	error: effect.Schema.Union([GitCommandError, AuthRpcError])
+});
 const WsVcsReadLocalChangesRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.vcsReadLocalChanges, {
 	payload: GitLocalChangesInput,
 	success: GitLocalChangesResult,
@@ -13762,7 +15600,7 @@ const WsAgentControlDisconnectMcpInstallationRpc = effect_unstable_rpc_Rpc.make(
 	error: effect.Schema.Union([AgentControlExternalRpcError, AuthRpcError])
 });
 /** Keep declaration emit bounded as shared settings and RPC schemas grow. */
-const WsRpcGroup = effect_unstable_rpc_RpcGroup.make(WsSessionImportSourcesRpc, WsSessionImportReconcileRpc, WsSessionImportAdoptRpc, WsSessionImportDiscoverRpc, WsSessionImportRunRpc, WsServerGetConfigRpc, WsServerGetAdvertisedEndpointsRpc, WsServerGetDiagnosticsMetricsRpc, WsServerGetStatisticsRpc, WsServerGetUsageSummaryRpc, WsServerSearchAcpRegistryRpc, WsServerInstallAcpRegistryRpc, WsServerGetAcpRegistryAuthMethodsRpc, WsServerAuthenticateAcpRegistryRpc, WsServerReadCodexResetCreditsRpc, WsServerConsumeCodexResetCreditRpc, WsServerRefreshProvidersRpc, WsServerUpdateProviderRpc, WsServerUpsertKeybindingRpc, WsKeybindingsReplaceCustomRpc, WsServerGetProjectPreferencesRpc, WsServerGetSettingsRpc, WsServerUpdateSettingsRpc, WsServerGetDiagnosticsSnapshotRpc, WsServerSignalDiagnosticProcessRpc, WsServerGetResourceTelemetryHistoryRpc, WsServerRetryResourceTelemetryRpc, WsServerDiscoverSourceControlRpc, WsServerListOpinionatedPluginsRpc, WsServerCheckOpinionatedPluginsRpc, WsServerInstallOpinionatedPluginRpc, WsMcpListWorkspacesRpc, WsMcpListServersRpc, WsMcpUpsertServerRpc, WsMcpSetServerEnabledRpc, WsMcpRemoveServerRpc, WsMcpReloadServersRpc, WsMcpStartOauthLoginRpc, WsSourceControlLookupRepositoryRpc, WsSourceControlSearchRepositoriesRpc, WsSourceControlCloneRepositoryRpc, WsSourceControlPublishRepositoryRpc, WsSourceControlListIssuesRpc, WsSourceControlGetIssueRpc, WsSourceControlSearchIssuesRpc, WsSourceControlListChangeRequestsRpc, WsSourceControlSearchChangeRequestsRpc, WsSourceControlGetChangeRequestDetailRpc, WsSourceControlGetChangeRequestFilesViewedRpc, WsSourceControlSetChangeRequestFileViewedRpc, WsSourceControlGetChangeRequestDiffRpc, WsSourceControlMergeChangeRequestRpc, WsSourceControlCreateIssueRpc, WsSourceControlAddIssueCommentRpc, WsSourceControlAddIssueCommentReactionRpc, WsSourceControlAddChangeRequestCommentRpc, WsSourceControlAddChangeRequestCommentReactionRpc, WsSourceControlListIssueLabelsRpc, WsSourceControlListIssueAssigneesRpc, WsSourceControlListWorkflowRunsRpc, WsSourceControlGetWorkflowRunJobsRpc, WsSourceControlGetWorkflowJobLogRpc, WsSourceControlRerunWorkflowRpc, WsTextGenerationAskSideQuestionRpc, WsTextGenerationCancelSideQuestionRpc, WsTextGenerationGenerateIssueContentRpc, WsTextGenerationGenerateBranchNameRpc, WsAtlassianListConnectionsRpc, WsAtlassianStartOAuthRpc, WsAtlassianDisconnectRpc, WsAtlassianRefreshRpc, WsAtlassianListResourcesRpc, WsAtlassianGetProjectLinkRpc, WsAtlassianSaveProjectLinkRpc, WsAtlassianSaveManualBitbucketTokenRpc, WsAtlassianSaveManualJiraTokenRpc, WsWorkItemsListProjectsRpc, WsWorkItemsListRpc, WsWorkItemsSearchRpc, WsWorkItemsGetRpc, WsWorkItemsAddCommentRpc, WsWorkItemsEditCommentRpc, WsWorkItemsUpdateRpc, WsWorkItemsListTransitionsRpc, WsWorkItemsTransitionRpc, WsProjectsListEntriesRpc, WsProjectsSearchEntriesRpc, WsProjectsReadFileRpc, WsProjectsReadIconRpc, WsProjectsReadFileBinaryRpc, WsProjectsWriteFileRpc, WsProjectsStageFileReferenceRpc, WsChatAttachmentsCreateFileUploadRpc, WsChatAttachmentsReadChunkRpc, WsShellOpenInEditorRpc, WsFilesystemBrowseRpc, WsSubscribeVcsStatusRpc, WsVcsPullRpc, WsVcsRefreshStatusRpc, WsGitRunStackedActionRpc, WsGitResolvePullRequestRpc, WsGitPreparePullRequestThreadRpc, WsStorageScanRpc, WsStoragePreviewRpc, WsStorageExecuteRpc, WsGitCreateWorktreeForProjectRpc, WsGitFindWorktreeForOriginRpc, WsGitArchiveWorktreeRpc, WsGitRestoreWorktreeRpc, WsGitDeleteWorktreeRpc, WsThreadsSetManualBucketRpc, WsThreadsSetManualPositionRpc, WsSearchThreadMessagesRpc, WsThreadPriorityEnsureCurrentRpc, WsWorktreesSetManualPositionRpc, WsProjectsInitializeGitRpc, WsVcsReadLineBlameRpc, WsVcsReadLocalChangesRpc, WsVcsApplyIndexPatchRpc, WsVcsReadComparisonRpc, WsVcsListRefsRpc, WsVcsCreateWorktreeRpc, WsVcsRemoveWorktreeRpc, WsVcsCreateRefRpc, WsVcsSwitchRefRpc, WsVcsInitRpc, WsTerminalOpenRpc, WsTerminalWriteRpc, WsTerminalResizeRpc, WsTerminalClearRpc, WsTerminalRestartRpc, WsTerminalCloseRpc, WsSubscribeTerminalEventsRpc, WsSubscribeServerConfigRpc, WsSubscribeServerLifecycleRpc, WsSubscribeAuthAccessRpc, WsAutomationCentreRpc, WsAutomationCommandRpc, WsAgentControlListProposalsRpc, WsAgentControlGetProposalRpc, WsAgentControlAcceptProposalRpc, WsAgentControlRejectProposalRpc, WsAgentControlSubscribeProposalsRpc, WsAgentControlListIntegrationsRpc, WsAgentControlCreateIntegrationRpc, WsAgentControlUpdateIntegrationRpc, WsAgentControlResumeIntegrationPairingRpc, WsAgentControlRevokeIntegrationRpc, WsAgentControlDeleteIntegrationRpc, WsAgentControlListMcpInstallationsRpc, WsAgentControlConnectMcpInstallationRpc, WsAgentControlRepairMcpInstallationRpc, WsAgentControlDisconnectMcpInstallationRpc, WsOrchestrationDispatchCommandRpc, WsOrchestrationGetWorkflowScriptRpc, WsOrchestrationGetTaskOutputRpc, WsOrchestrationStopBackgroundTaskRpc, WsOrchestrationGetTurnDiffRpc, WsOrchestrationGetFullThreadDiffRpc, WsOrchestrationSearchThreadMessagesRpc, WsOrchestrationGetThreadWindowRpc, WsOrchestrationGetThreadHistoryPageRpc, WsOrchestrationReplayEventsRpc, WsOrchestrationReplayEventsPageRpc, WsOrchestrationSubscribeShellRpc, WsOrchestrationSubscribeThreadRpc, WsOrchestrationSubscribeThreadWindowRpc, WsContextHandoffGetInspectionSummaryRpc, WsContextHandoffListInspectionEntriesRpc, WsContextHandoffReadRawPayloadChunkRpc, WsContextHandoffReadExportChunkRpc);
+const WsRpcGroup = effect_unstable_rpc_RpcGroup.make(WsSessionImportSourcesRpc, WsSessionImportReconcileRpc, WsSessionImportAdoptRpc, WsSessionImportDiscoverRpc, WsSessionImportRunRpc, WsServerGetConfigRpc, WsServerGetAdvertisedEndpointsRpc, WsServerGetDiagnosticsMetricsRpc, WsServerGetStatisticsRpc, WsServerGetUsageSummaryRpc, WsServerSearchAcpRegistryRpc, WsServerInstallAcpRegistryRpc, WsServerGetAcpRegistryAuthMethodsRpc, WsServerAuthenticateAcpRegistryRpc, WsServerReadCodexResetCreditsRpc, WsServerConsumeCodexResetCreditRpc, WsServerListLocalTasksRpc, WsServerGetLocalTaskRpc, WsServerCreateLocalTaskRpc, WsServerUpdateLocalTaskRpc, WsServerDeleteLocalTaskRpc, WsServerDelegateLocalTaskRpc, WsNotesListRpc, WsNotesCommandRpc, WsServerGetDailyRecapRpc, WsServerRefreshProvidersRpc, WsServerUpdateProviderRpc, WsServerUpsertKeybindingRpc, WsKeybindingsReplaceCustomRpc, WsServerGetProjectPreferencesRpc, WsServerGetSettingsRpc, WsServerUpdateSettingsRpc, WsServerGetDiagnosticsSnapshotRpc, WsServerSignalDiagnosticProcessRpc, WsServerGetResourceTelemetryHistoryRpc, WsServerRetryResourceTelemetryRpc, WsServerDiscoverSourceControlRpc, WsServerListOpinionatedPluginsRpc, WsServerCheckOpinionatedPluginsRpc, WsServerInstallOpinionatedPluginRpc, WsMcpListWorkspacesRpc, WsMcpListServersRpc, WsMcpUpsertServerRpc, WsMcpSetServerEnabledRpc, WsMcpRemoveServerRpc, WsMcpReloadServersRpc, WsMcpStartOauthLoginRpc, WsSourceControlLookupRepositoryRpc, WsSourceControlSearchRepositoriesRpc, WsSourceControlCloneRepositoryRpc, WsSourceControlPublishRepositoryRpc, WsSourceControlListIssuesRpc, WsSourceControlGetIssueRpc, WsSourceControlSearchIssuesRpc, WsSourceControlListChangeRequestsRpc, WsSourceControlSearchChangeRequestsRpc, WsSourceControlGetChangeRequestDetailRpc, WsSourceControlGetChangeRequestFilesViewedRpc, WsSourceControlSetChangeRequestFileViewedRpc, WsSourceControlGetChangeRequestDiffRpc, WsSourceControlMergeChangeRequestRpc, WsSourceControlCreateIssueRpc, WsSourceControlAddIssueCommentRpc, WsSourceControlAddIssueCommentReactionRpc, WsSourceControlAddChangeRequestCommentRpc, WsSourceControlAddChangeRequestCommentReactionRpc, WsSourceControlListIssueLabelsRpc, WsSourceControlListIssueAssigneesRpc, WsSourceControlListWorkflowRunsRpc, WsSourceControlGetWorkflowRunJobsRpc, WsSourceControlGetWorkflowJobLogRpc, WsSourceControlRerunWorkflowRpc, WsSourceControlGetChangeRequestActivityRpc, WsSourceControlGetChangeRequestFileContentsRpc, WsSourceControlSubmitChangeRequestReviewRpc, WsSourceControlReplyToReviewThreadRpc, WsSourceControlSetReviewThreadResolvedRpc, WsSourceControlUpdateChangeRequestCommentRpc, WsSourceControlUpdateChangeRequestRpc, WsSourceControlCreateChangeRequestRpc, WsTextGenerationAskSideQuestionRpc, WsTextGenerationCancelSideQuestionRpc, WsTextGenerationGenerateIssueContentRpc, WsTextGenerationGenerateBranchNameRpc, WsAtlassianListConnectionsRpc, WsAtlassianStartOAuthRpc, WsAtlassianDisconnectRpc, WsAtlassianRefreshRpc, WsAtlassianListResourcesRpc, WsAtlassianGetProjectLinkRpc, WsAtlassianSaveProjectLinkRpc, WsAtlassianSaveManualBitbucketTokenRpc, WsAtlassianSaveManualJiraTokenRpc, WsWorkItemsListProjectsRpc, WsWorkItemsListRpc, WsWorkItemsSearchRpc, WsWorkItemsGetRpc, WsWorkItemsAddCommentRpc, WsWorkItemsEditCommentRpc, WsWorkItemsUpdateRpc, WsWorkItemsListTransitionsRpc, WsWorkItemsTransitionRpc, WsProjectsListEntriesRpc, WsProjectsSearchEntriesRpc, WsProjectsReadFileRpc, WsProjectsReadIconRpc, WsProjectsReadFileBinaryRpc, WsProjectsWriteFileRpc, WsProjectsStageFileReferenceRpc, WsChatAttachmentsCreateFileUploadRpc, WsChatAttachmentsReadChunkRpc, WsShellOpenInEditorRpc, WsFilesystemBrowseRpc, WsSubscribeVcsStatusRpc, WsVcsPullRpc, WsVcsRefreshStatusRpc, WsGitRunStackedActionRpc, WsGitResolvePullRequestRpc, WsGitPreparePullRequestThreadRpc, WsStorageScanRpc, WsStoragePreviewRpc, WsStorageExecuteRpc, WsGitCreateWorktreeForProjectRpc, WsGitFindWorktreeForOriginRpc, WsGitArchiveWorktreeRpc, WsGitRestoreWorktreeRpc, WsGitDeleteWorktreeRpc, WsLifecycleListWorkspacesRpc, WsLifecyclePreviewWorkspaceRpc, WsLifecycleApplyWorkspaceRpc, WsLifecycleSuggestionsRpc, WsLifecycleListTrashRpc, WsThreadsSetManualBucketRpc, WsThreadsSetManualPositionRpc, WsSearchThreadMessagesRpc, WsThreadPriorityEnsureCurrentRpc, WsWorktreesSetManualPositionRpc, WsProjectsInitializeGitRpc, WsProjectsPromoteChatPreviewRpc, WsProjectsPromoteChatRpc, WsProjectsDeleteChatFolderRpc, WsVcsReadLineBlameRpc, WsVcsReadImageBlobRpc, WsVcsReadLocalChangesRpc, WsVcsApplyIndexPatchRpc, WsVcsReadComparisonRpc, WsVcsListRefsRpc, WsVcsCreateWorktreeRpc, WsVcsRemoveWorktreeRpc, WsVcsCreateRefRpc, WsVcsSwitchRefRpc, WsVcsInitRpc, WsTerminalOpenRpc, WsTerminalWriteRpc, WsTerminalResizeRpc, WsTerminalClearRpc, WsTerminalRestartRpc, WsTerminalCloseRpc, WsSubscribeTerminalEventsRpc, WsSubscribeServerConfigRpc, WsSubscribeServerLifecycleRpc, WsSubscribeAuthAccessRpc, WsAutomationCentreRpc, WsAutomationCommandRpc, WsAgentControlListProposalsRpc, WsAgentControlGetProposalRpc, WsAgentControlAcceptProposalRpc, WsAgentControlRejectProposalRpc, WsAgentControlSubscribeProposalsRpc, WsAgentControlListIntegrationsRpc, WsAgentControlCreateIntegrationRpc, WsAgentControlUpdateIntegrationRpc, WsAgentControlResumeIntegrationPairingRpc, WsAgentControlRevokeIntegrationRpc, WsAgentControlDeleteIntegrationRpc, WsAgentControlListMcpInstallationsRpc, WsAgentControlConnectMcpInstallationRpc, WsAgentControlRepairMcpInstallationRpc, WsAgentControlDisconnectMcpInstallationRpc, WsOrchestrationDispatchCommandRpc, WsOrchestrationGetWorkflowScriptRpc, WsOrchestrationGetTaskOutputRpc, WsOrchestrationStopBackgroundTaskRpc, WsOrchestrationGetTurnDiffRpc, WsOrchestrationGetFullThreadDiffRpc, WsOrchestrationSearchThreadMessagesRpc, WsOrchestrationGetThreadWindowRpc, WsOrchestrationGetThreadHistoryPageRpc, WsOrchestrationReplayEventsRpc, WsOrchestrationReplayEventsPageRpc, WsOrchestrationSubscribeShellRpc, WsOrchestrationSubscribeThreadRpc, WsOrchestrationSubscribeThreadWindowRpc, WsContextHandoffGetInspectionSummaryRpc, WsContextHandoffListInspectionEntriesRpc, WsContextHandoffReadRawPayloadChunkRpc, WsContextHandoffReadExportChunkRpc);
 /**
 * Hosted relay channels carry both groups through one lifecycle-owned encrypted
 * channel. Direct clients keep the device group on its own low-priority socket
@@ -13945,6 +15783,81 @@ const AgentControlReadThreadFileInput = effect.Schema.Struct({
 	threadId: ThreadId,
 	relativePath: TrimmedNonEmptyString.check(effect.Schema.isMaxLength(4096))
 });
+//#endregion
+//#region ../../packages/contracts/src/agentControlDelegation.ts
+/**
+* Private-session tools for tasks a chat delegated with `ryco_create_threads` and
+* `returnToOrigin`. Like the inspection tools, they are not part of
+* `AGENT_CONTROL_MCP_TOOLS` and never reach the external endpoint.
+*/
+const AGENT_CONTROL_DELEGATION_MCP_TOOLS = {
+	taskStatus: "ryco_task_status",
+	taskCancel: "ryco_task_cancel"
+};
+const AGENT_CONTROL_TASK_RESULT_MAX_CHARS = 8e3;
+const AGENT_CONTROL_TASK_NOTICE_MAX_CHARS = 4e3;
+/** Child-side terminal outcomes a task returns as a server-authored notice instead of a result. */
+const AgentControlTaskNoticeOutcome = effect.Schema.Literals([
+	"interrupted",
+	"stopped",
+	"start-failed",
+	"advanced",
+	"archived",
+	"request-failed",
+	"expired"
+]);
+const AgentControlTaskStatusInput = effect.Schema.Struct({ taskId: effect.Schema.optional(ThreadId) }).annotate({ parseOptions: { onExcessProperty: "error" } });
+const AgentControlTaskCancelInput = effect.Schema.Struct({
+	requestId: AgentControlRequestId,
+	taskId: ThreadId
+}).annotate({ parseOptions: { onExcessProperty: "error" } });
+const AgentControlTaskRunState = effect.Schema.Literals([
+	"starting",
+	"running",
+	"needs-you",
+	"completed",
+	"failed",
+	"interrupted",
+	"unavailable"
+]);
+const AgentControlTaskStatusEntry = effect.Schema.Struct({
+	taskId: ThreadId,
+	proposalId: AgentControlProposalId,
+	title: effect.Schema.NullOr(effect.Schema.String),
+	return: effect.Schema.Struct({
+		status: AgentControlCompletionReturn.fields.status,
+		detail: AgentControlCompletionReturn.fields.detail,
+		updatedAt: IsoDateTime
+	}),
+	run: effect.Schema.Struct({
+		state: AgentControlTaskRunState,
+		sessionStatus: effect.Schema.NullOr(OrchestrationSessionStatus),
+		hasPendingApprovals: effect.Schema.Boolean,
+		hasPendingUserInput: effect.Schema.Boolean,
+		backgroundLiveness: effect.Schema.NullOr(effect.Schema.Literals(["working", "monitoring"])),
+		advanced: effect.Schema.Boolean
+	}),
+	/** Untrusted child output: reference data, never instructions or approval. */
+	result: effect.Schema.NullOr(effect.Schema.Struct({
+		untrustedChildOutput: effect.Schema.Literal(true),
+		state: effect.Schema.Literals(["completed", "error"]),
+		text: effect.Schema.String.check(effect.Schema.isMaxLength(AGENT_CONTROL_TASK_RESULT_MAX_CHARS)),
+		truncated: effect.Schema.Boolean
+	})),
+	/**
+	* The notice the task returns instead of a result (the same text a wake carries). It is
+	* server-authored, holds no child text and stays visible after an acknowledgement.
+	*/
+	notice: effect.Schema.NullOr(effect.Schema.Struct({
+		outcome: AgentControlTaskNoticeOutcome,
+		text: effect.Schema.String.check(effect.Schema.isMaxLength(AGENT_CONTROL_TASK_NOTICE_MAX_CHARS))
+	})),
+	acknowledged: effect.Schema.Boolean
+});
+const AgentControlTaskStatusResult = effect.Schema.Struct({
+	tasks: effect.Schema.Array(AgentControlTaskStatusEntry).check(effect.Schema.isMaxLength(20)),
+	truncated: effect.Schema.Boolean
+});
 /**
 * Exported because it bounds `ComputerActionResult.value`, and the clipboard
 * read path must enforce it before putting clipboard text on that field.
@@ -15043,6 +16956,12 @@ Object.defineProperty(exports, "AGENT_CONTROL_CAPABILITIES", {
 		return AGENT_CONTROL_CAPABILITIES;
 	}
 });
+Object.defineProperty(exports, "AGENT_CONTROL_DELEGATION_MCP_TOOLS", {
+	enumerable: true,
+	get: function() {
+		return AGENT_CONTROL_DELEGATION_MCP_TOOLS;
+	}
+});
 Object.defineProperty(exports, "AGENT_CONTROL_DEVICE_ACTION_KINDS", {
 	enumerable: true,
 	get: function() {
@@ -15145,6 +17064,18 @@ Object.defineProperty(exports, "AGENT_CONTROL_RISK_TAGS", {
 		return AGENT_CONTROL_RISK_TAGS;
 	}
 });
+Object.defineProperty(exports, "AGENT_CONTROL_TASK_NOTICE_MAX_CHARS", {
+	enumerable: true,
+	get: function() {
+		return AGENT_CONTROL_TASK_NOTICE_MAX_CHARS;
+	}
+});
+Object.defineProperty(exports, "AGENT_CONTROL_TASK_RESULT_MAX_CHARS", {
+	enumerable: true,
+	get: function() {
+		return AGENT_CONTROL_TASK_RESULT_MAX_CHARS;
+	}
+});
 Object.defineProperty(exports, "AGENT_CONTROL_TERMINAL_PROPOSAL_STATUSES", {
 	enumerable: true,
 	get: function() {
@@ -15781,6 +17712,30 @@ Object.defineProperty(exports, "AgentControlSearchThreadsInput", {
 		return AgentControlSearchThreadsInput;
 	}
 });
+Object.defineProperty(exports, "AgentControlTaskCancelInput", {
+	enumerable: true,
+	get: function() {
+		return AgentControlTaskCancelInput;
+	}
+});
+Object.defineProperty(exports, "AgentControlTaskNoticeOutcome", {
+	enumerable: true,
+	get: function() {
+		return AgentControlTaskNoticeOutcome;
+	}
+});
+Object.defineProperty(exports, "AgentControlTaskStatusInput", {
+	enumerable: true,
+	get: function() {
+		return AgentControlTaskStatusInput;
+	}
+});
+Object.defineProperty(exports, "AgentControlTaskStatusResult", {
+	enumerable: true,
+	get: function() {
+		return AgentControlTaskStatusResult;
+	}
+});
 Object.defineProperty(exports, "AgentControlWaitThreadsInput", {
 	enumerable: true,
 	get: function() {
@@ -15907,12 +17862,24 @@ Object.defineProperty(exports, "BrowserExternalIdentityConnectResponse", {
 		return BrowserExternalIdentityConnectResponse;
 	}
 });
+Object.defineProperty(exports, "CHANGE_REQUEST_FILE_CONTENTS_MAX_BYTES", {
+	enumerable: true,
+	get: function() {
+		return CHANGE_REQUEST_FILE_CONTENTS_MAX_BYTES;
+	}
+});
 Object.defineProperty(exports, "CHAT_ATTACHMENT_READ_CHUNK_BYTES", {
 	enumerable: true,
 	get: function() {
 		return CHAT_ATTACHMENT_READ_CHUNK_BYTES;
 	}
 });
+Object.defineProperty(exports, "CHECKPOINT_REVERT_ACTIVITY_KIND", {
+	enumerable: true,
+	get: function() {
+		return CHECKPOINT_REVERT_ACTIVITY_KIND;
+	}
+});
 Object.defineProperty(exports, "COMPUTER_BROWSER_DRIVER_NAMES", {
 	enumerable: true,
 	get: function() {
@@ -15997,6 +17964,30 @@ Object.defineProperty(exports, "CONTEXT_HANDOFF_WS_METHODS", {
 		return CONTEXT_HANDOFF_WS_METHODS;
 	}
 });
+Object.defineProperty(exports, "ChangeRequestReviewComment", {
+	enumerable: true,
+	get: function() {
+		return ChangeRequestReviewComment;
+	}
+});
+Object.defineProperty(exports, "ChangeRequestReviewThread", {
+	enumerable: true,
+	get: function() {
+		return ChangeRequestReviewThread;
+	}
+});
+Object.defineProperty(exports, "ChangeRequestTimelineItem", {
+	enumerable: true,
+	get: function() {
+		return ChangeRequestTimelineItem;
+	}
+});
+Object.defineProperty(exports, "ChangeRequestViewerCapabilities", {
+	enumerable: true,
+	get: function() {
+		return ChangeRequestViewerCapabilities;
+	}
+});
 Object.defineProperty(exports, "ChatAttachment", {
 	enumerable: true,
 	get: function() {
@@ -16009,12 +18000,30 @@ Object.defineProperty(exports, "ChatAttachmentReadError", {
 		return ChatAttachmentReadError;
 	}
 });
+Object.defineProperty(exports, "ChatFileAttachment", {
+	enumerable: true,
+	get: function() {
+		return ChatFileAttachment;
+	}
+});
 Object.defineProperty(exports, "CheckpointRef", {
 	enumerable: true,
 	get: function() {
 		return CheckpointRef;
 	}
 });
+Object.defineProperty(exports, "CheckpointRevertActivityPayload", {
+	enumerable: true,
+	get: function() {
+		return CheckpointRevertActivityPayload;
+	}
+});
+Object.defineProperty(exports, "ClaudeCacheObservation", {
+	enumerable: true,
+	get: function() {
+		return ClaudeCacheObservation;
+	}
+});
 Object.defineProperty(exports, "ClaudeSettings", {
 	enumerable: true,
 	get: function() {
@@ -16027,6 +18036,12 @@ Object.defineProperty(exports, "ClientOrchestrationCommand", {
 		return ClientOrchestrationCommand;
 	}
 });
+Object.defineProperty(exports, "ClientThreadTurnStartCommand", {
+	enumerable: true,
+	get: function() {
+		return ClientThreadTurnStartCommand;
+	}
+});
 Object.defineProperty(exports, "CodexResetCreditError", {
 	enumerable: true,
 	get: function() {
@@ -16147,12 +18162,24 @@ Object.defineProperty(exports, "DEFAULT_GIT_TEXT_GENERATION_OPTIONS_BY_PROVIDER"
 		return DEFAULT_GIT_TEXT_GENERATION_OPTIONS_BY_PROVIDER;
 	}
 });
+Object.defineProperty(exports, "DEFAULT_LIFECYCLE_SUGGESTION_POLICY", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_LIFECYCLE_SUGGESTION_POLICY;
+	}
+});
 Object.defineProperty(exports, "DEFAULT_MODEL", {
 	enumerable: true,
 	get: function() {
 		return DEFAULT_MODEL;
 	}
 });
+Object.defineProperty(exports, "DEFAULT_PROJECT_KIND", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_PROJECT_KIND;
+	}
+});
 Object.defineProperty(exports, "DEFAULT_PROJECT_METADATA_DIR", {
 	enumerable: true,
 	get: function() {
@@ -16183,6 +18210,12 @@ Object.defineProperty(exports, "DEFAULT_WORKTREE_BRANCH_PREFIX", {
 		return DEFAULT_WORKTREE_BRANCH_PREFIX;
 	}
 });
+Object.defineProperty(exports, "DESKTOP_HUB_REACHABILITY_PATH", {
+	enumerable: true,
+	get: function() {
+		return DESKTOP_HUB_REACHABILITY_PATH;
+	}
+});
 Object.defineProperty(exports, "DESKTOP_NATIVE_NODE_CLAIM_COMMIT_PATH", {
 	enumerable: true,
 	get: function() {
@@ -16231,6 +18264,18 @@ Object.defineProperty(exports, "DEVICE_WS_METHODS", {
 		return DEVICE_WS_METHODS;
 	}
 });
+Object.defineProperty(exports, "DailyRecapReadError", {
+	enumerable: true,
+	get: function() {
+		return DailyRecapReadError;
+	}
+});
+Object.defineProperty(exports, "DailyRecapThread", {
+	enumerable: true,
+	get: function() {
+		return DailyRecapThread;
+	}
+});
 Object.defineProperty(exports, "DesktopNativeNodeClaimCommitRequest", {
 	enumerable: true,
 	get: function() {
@@ -16501,6 +18546,12 @@ Object.defineProperty(exports, "GitReadComparisonInput", {
 		return GitReadComparisonInput;
 	}
 });
+Object.defineProperty(exports, "GitReadImageBlobInput", {
+	enumerable: true,
+	get: function() {
+		return GitReadImageBlobInput;
+	}
+});
 Object.defineProperty(exports, "GitReadLineBlameInput", {
 	enumerable: true,
 	get: function() {
@@ -16573,6 +18624,12 @@ Object.defineProperty(exports, "HubIdentitySummary", {
 		return HubIdentitySummary;
 	}
 });
+Object.defineProperty(exports, "HubSpaceId", {
+	enumerable: true,
+	get: function() {
+		return HubSpaceId;
+	}
+});
 Object.defineProperty(exports, "IsoDateTime", {
 	enumerable: true,
 	get: function() {
@@ -16627,6 +18684,48 @@ Object.defineProperty(exports, "LocalIntroductionCompleteRequest", {
 		return LocalIntroductionCompleteRequest;
 	}
 });
+Object.defineProperty(exports, "LocalTask", {
+	enumerable: true,
+	get: function() {
+		return LocalTask;
+	}
+});
+Object.defineProperty(exports, "LocalTaskCreateInput", {
+	enumerable: true,
+	get: function() {
+		return LocalTaskCreateInput;
+	}
+});
+Object.defineProperty(exports, "LocalTaskDelegateInput", {
+	enumerable: true,
+	get: function() {
+		return LocalTaskDelegateInput;
+	}
+});
+Object.defineProperty(exports, "LocalTaskDeleteInput", {
+	enumerable: true,
+	get: function() {
+		return LocalTaskDeleteInput;
+	}
+});
+Object.defineProperty(exports, "LocalTaskError", {
+	enumerable: true,
+	get: function() {
+		return LocalTaskError;
+	}
+});
+Object.defineProperty(exports, "LocalTaskListInput", {
+	enumerable: true,
+	get: function() {
+		return LocalTaskListInput;
+	}
+});
+Object.defineProperty(exports, "LocalTaskUpdateInput", {
+	enumerable: true,
+	get: function() {
+		return LocalTaskUpdateInput;
+	}
+});
 Object.defineProperty(exports, "MODEL_PICKER_JUMP_KEYBINDING_COMMANDS", {
 	enumerable: true,
 	get: function() {
@@ -17185,6 +19284,30 @@ Object.defineProperty(exports, "NonNegativeInt", {
 		return NonNegativeInt;
 	}
 });
+Object.defineProperty(exports, "NotesCommand", {
+	enumerable: true,
+	get: function() {
+		return NotesCommand;
+	}
+});
+Object.defineProperty(exports, "NotesDocument", {
+	enumerable: true,
+	get: function() {
+		return NotesDocument;
+	}
+});
+Object.defineProperty(exports, "NotesError", {
+	enumerable: true,
+	get: function() {
+		return NotesError;
+	}
+});
+Object.defineProperty(exports, "NotesListInput", {
+	enumerable: true,
+	get: function() {
+		return NotesListInput;
+	}
+});
 Object.defineProperty(exports, "ORCHESTRATION_WS_METHODS", {
 	enumerable: true,
 	get: function() {
@@ -17443,12 +19566,24 @@ Object.defineProperty(exports, "PROJECT_READ_FILE_BINARY_MAX_BYTES", {
 		return PROJECT_READ_FILE_BINARY_MAX_BYTES;
 	}
 });
+Object.defineProperty(exports, "PROJECT_RELOCATION_PENDING_MESSAGE", {
+	enumerable: true,
+	get: function() {
+		return PROJECT_RELOCATION_PENDING_MESSAGE;
+	}
+});
 Object.defineProperty(exports, "PROJECT_STAGE_FILE_MAX_BYTES", {
 	enumerable: true,
 	get: function() {
 		return PROJECT_STAGE_FILE_MAX_BYTES;
 	}
 });
+Object.defineProperty(exports, "PROVIDER_DISPLAY_NAMES", {
+	enumerable: true,
+	get: function() {
+		return PROVIDER_DISPLAY_NAMES;
+	}
+});
 Object.defineProperty(exports, "PROVIDER_SEND_TURN_MAX_ATTACHMENT_TOTAL_BYTES", {
 	enumerable: true,
 	get: function() {
@@ -17575,6 +19710,12 @@ Object.defineProperty(exports, "ProjectAvatarSetPayload", {
 		return ProjectAvatarSetPayload;
 	}
 });
+Object.defineProperty(exports, "ProjectChatError", {
+	enumerable: true,
+	get: function() {
+		return ProjectChatError;
+	}
+});
 Object.defineProperty(exports, "ProjectCreatedPayload", {
 	enumerable: true,
 	get: function() {
@@ -17593,6 +19734,12 @@ Object.defineProperty(exports, "ProjectId", {
 		return ProjectId;
 	}
 });
+Object.defineProperty(exports, "ProjectKind", {
+	enumerable: true,
+	get: function() {
+		return ProjectKind;
+	}
+});
 Object.defineProperty(exports, "ProjectListEntriesError", {
 	enumerable: true,
 	get: function() {
@@ -17959,6 +20106,12 @@ Object.defineProperty(exports, "ServerProvider", {
 		return ServerProvider;
 	}
 });
+Object.defineProperty(exports, "ServerProviderCompatibilityStatus", {
+	enumerable: true,
+	get: function() {
+		return ServerProviderCompatibilityStatus;
+	}
+});
 Object.defineProperty(exports, "ServerProviderUpdateError", {
 	enumerable: true,
 	get: function() {
@@ -17983,6 +20136,12 @@ Object.defineProperty(exports, "SessionImportError", {
 		return SessionImportError;
 	}
 });
+Object.defineProperty(exports, "SourceControlChangeRequestReviewer", {
+	enumerable: true,
+	get: function() {
+		return SourceControlChangeRequestReviewer;
+	}
+});
 Object.defineProperty(exports, "SourceControlProviderError", {
 	enumerable: true,
 	get: function() {
@@ -18247,6 +20406,12 @@ Object.defineProperty(exports, "ThreadTokenModeSetPayload", {
 		return ThreadTokenModeSetPayload;
 	}
 });
+Object.defineProperty(exports, "ThreadTrashedPayload", {
+	enumerable: true,
+	get: function() {
+		return ThreadTrashedPayload;
+	}
+});
 Object.defineProperty(exports, "ThreadTurnDiffCompletedPayload", {
 	enumerable: true,
 	get: function() {
@@ -18277,6 +20442,30 @@ Object.defineProperty(exports, "ThreadUnsnoozedPayload", {
 		return ThreadUnsnoozedPayload;
 	}
 });
+Object.defineProperty(exports, "ThreadUntrashedPayload", {
+	enumerable: true,
+	get: function() {
+		return ThreadUntrashedPayload;
+	}
+});
+Object.defineProperty(exports, "ThreadUsageLimit", {
+	enumerable: true,
+	get: function() {
+		return ThreadUsageLimit;
+	}
+});
+Object.defineProperty(exports, "ThreadUsageLimitClearedPayload", {
+	enumerable: true,
+	get: function() {
+		return ThreadUsageLimitClearedPayload;
+	}
+});
+Object.defineProperty(exports, "ThreadUsageLimitSetPayload", {
+	enumerable: true,
+	get: function() {
+		return ThreadUsageLimitSetPayload;
+	}
+});
 Object.defineProperty(exports, "ToolLifecycleItemType", {
 	enumerable: true,
 	get: function() {
@@ -18379,6 +20568,12 @@ Object.defineProperty(exports, "WorkItemProviderKind", {
 		return WorkItemProviderKind;
 	}
 });
+Object.defineProperty(exports, "WorkspaceLifecycleError", {
+	enumerable: true,
+	get: function() {
+		return WorkspaceLifecycleError;
+	}
+});
 Object.defineProperty(exports, "Worktree", {
 	enumerable: true,
 	get: function() {
@@ -18391,6 +20586,18 @@ Object.defineProperty(exports, "WorktreeArchivedPayload", {
 		return WorktreeArchivedPayload;
 	}
 });
+Object.defineProperty(exports, "WorktreeCheckoutRemovedPayload", {
+	enumerable: true,
+	get: function() {
+		return WorktreeCheckoutRemovedPayload;
+	}
+});
+Object.defineProperty(exports, "WorktreeCheckoutRestoredPayload", {
+	enumerable: true,
+	get: function() {
+		return WorktreeCheckoutRestoredPayload;
+	}
+});
 Object.defineProperty(exports, "WorktreeCreatedPayload", {
 	enumerable: true,
 	get: function() {
@@ -18421,6 +20628,12 @@ Object.defineProperty(exports, "WorktreeMetaUpdatedPayload", {
 		return WorktreeMetaUpdatedPayload;
 	}
 });
+Object.defineProperty(exports, "WorktreeRelocatedPayload", {
+	enumerable: true,
+	get: function() {
+		return WorktreeRelocatedPayload;
+	}
+});
 Object.defineProperty(exports, "WorktreeRestoredPayload", {
 	enumerable: true,
 	get: function() {
@@ -18463,6 +20676,12 @@ Object.defineProperty(exports, "defaultInstanceIdForDriver", {
 		return defaultInstanceIdForDriver;
 	}
 });
+Object.defineProperty(exports, "isProviderAvailable", {
+	enumerable: true,
+	get: function() {
+		return isProviderAvailable;
+	}
+});
 Object.defineProperty(exports, "isProviderDriverKind", {
 	enumerable: true,
 	get: function() {