@yugoo-design/dsh-design-studio-dsh 0.1.2 → 0.2.0

package/lib/authoring-workbench.js

@@ -0,0 +1,782 @@
+import { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { ConversationMessage, ConversationMessages, InstanceWorkbench, StudioFeedback } from "@yugoo-design/dsh-design-studio-ui";
+import { PanelSamplePreview } from "@yugoo-design/dsh-design-panel/sample-preview";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/authoring-workbench.tsx
+/** Browser projection only: native execution, candidate preparation and saving keep their existing owners. */
+const StudioAuthoringPromptContext = createContext(void 0);
+const conversationEntry = (attempt, saved) => ({
+	id: attempt.request.invocationId,
+	prompt: attempt.request.prompt,
+	status: attempt.observation?.status,
+	uncertain: attempt.uncertain,
+	candidateFiles: attempt.prepared?.candidate.diff.length,
+	candidateValid: attempt.prepared?.candidate.valid,
+	saved,
+	nativeRows: attempt.observation?.conversation?.rows,
+	omitted: attempt.observation?.conversation?.omitted
+});
+const message = (error) => error instanceof Error ? error.message : String(error);
+const address = (ref) => ({
+	sessionId: ref.sessionId,
+	epoch: ref.epoch
+});
+function sameReference(ref, request) {
+	return ref.invocationId === request.invocationId && ref.scope.id === request.id && ref.scope.expectedRevision === request.expectedRevision && ref.scope.bundle?.name === request.bundle?.name && ref.scope.bundle?.version === request.bundle?.version && ref.scope.allowedPaths.length === request.paths.length && ref.scope.allowedPaths.every((path) => request.paths.includes(path));
+}
+function sameRun(left, right) {
+	return left.sessionId === right.sessionId && left.epoch === right.epoch && left.parentSessionId === right.parentSessionId && left.messageId === right.messageId && left.afterSeq === right.afterSeq && sameReference(left, {
+		invocationId: right.invocationId,
+		id: right.scope.id,
+		expectedRevision: right.scope.expectedRevision,
+		paths: right.scope.allowedPaths,
+		bundle: right.scope.bundle,
+		prompt: ""
+	});
+}
+function matchesPrepared(prepared, request) {
+	return prepared.request.id === request.id && prepared.request.expectedRevision === request.expectedRevision && prepared.candidate.id === request.id && prepared.candidate.baseRevision === request.expectedRevision && prepared.candidate.revision === request.expectedRevision + 1;
+}
+/** Keep the editor mounted on connection changes, but never send old edits into a new parent's port. */
+function guardInstances(source, active) {
+	return new Proxy(Object.create(source), { get(_target, key) {
+		const value = Reflect.get(source, key);
+		if (typeof value !== "function") return value;
+		return async (...args) => {
+			if (!active()) throw new Error("The authoring connection changed. Your input is retained; reopen this working copy to reconnect.");
+			const result = await Reflect.apply(value, source, args);
+			if (!active()) throw new Error("The authoring connection changed while the request settled. Reopen to verify the saved source; your input is retained.");
+			return result;
+		};
+	} });
+}
+function StudioAuthoringWorkbench(props) {
+	return /* @__PURE__ */ jsx(Workbench, { ...props }, props.id);
+}
+function Workbench({ client, id, locale, onBack, onChanged, onDirtyChange, renderPreview, initialSelection, onExport, presentation = "full", preparedLocator, initialPrompt }) {
+	const contextPrompt = useContext(StudioAuthoringPromptContext);
+	const prefill = initialPrompt ?? contextPrompt;
+	const zh = locale === "zh";
+	const text = (en, cn) => zh ? cn : en;
+	const initial = useRef(client), current = useRef(client);
+	current.current = client;
+	const invalidated = useRef(false), live = useRef(true), sequence = useRef(0), reads = useRef(0);
+	const connected = client === initial.current && !invalidated.current;
+	const active = useCallback(() => live.current && !invalidated.current && current.current === initial.current, []);
+	const [instances] = useState(() => guardInstances(client.instances, active));
+	const reviewClient = useMemo(() => guardInstances(initial.current.instances, active), [client, active]);
+	const editor = useRef({
+		dirty: false,
+		busy: false
+	});
+	const [snapshot, setSnapshot] = useState(editor.current);
+	const syncEditor = useCallback((next) => {
+		editor.current = next;
+		setSnapshot((old) => old.record === next.record && old.dirty === next.dirty && old.busy === next.busy && old.previewBundle === next.previewBundle && old.proposalReplacement === next.proposalReplacement ? old : next);
+	}, []);
+	const [intent, setIntent] = useState(prefill ?? ""), [attempt, setAttempt] = useState();
+	const intentVersion = useRef(0);
+	const usedPrefill = useRef(!!prefill);
+	const currentIntent = useRef(intent);
+	currentIntent.current = intent;
+	useEffect(() => {
+		if (!prefill || usedPrefill.current) return;
+		usedPrefill.current = true;
+		if (!currentIntent.current.trim()) {
+			intentVersion.current++;
+			setIntent(prefill);
+		}
+	}, [prefill]);
+	const [history, setHistory] = useState([]);
+	const attemptRef = useRef(attempt);
+	attemptRef.current = attempt;
+	useEffect(() => {
+		if (attempt?.owned && !attempt.uncertain && attempt.observation?.consumed && attempt.observation.status !== "unknown" && attempt.intentVersion === intentVersion.current) setIntent((value) => value === attempt.request.prompt ? "" : value);
+	}, [attempt]);
+	const [busy, setBusy] = useState(false), busyRef = useRef(false);
+	const [error, setError] = useState(""), [review, setReview] = useState();
+	const [reviewSaved, setReviewSaved] = useState(false);
+	const [contentCandidate, setContentCandidate] = useState();
+	const [contentError, setContentError] = useState(""), [contentLoading, setContentLoading] = useState(false);
+	const [savedRequest, setSavedRequest] = useState();
+	const reviewRequest = useRef();
+	const reviewInvocation = useRef();
+	const openedRequest = useRef();
+	const openedFullCandidates = useRef(/* @__PURE__ */ new Set());
+	const fullCandidateKey = attempt?.prepared ? JSON.stringify([
+		attempt.request.invocationId,
+		attempt.prepared.request.id,
+		attempt.prepared.request.expectedRevision,
+		attempt.prepared.candidate.digest
+	]) : void 0;
+	const locatorKey = JSON.stringify(preparedLocator);
+	const dirty = useRef(false), notify = useRef(onDirtyChange);
+	notify.current = onDirtyChange;
+	const extraDirty = useRef(false);
+	extraDirty.current = !!intent || !!attempt && !reviewSaved || !!review && !reviewSaved;
+	const reportDirty = useCallback(() => {
+		if (live.current) notify.current?.(dirty.current || extraDirty.current);
+	}, []);
+	const editorDirty = useCallback((value) => {
+		dirty.current = value;
+		reportDirty();
+	}, [reportDirty]);
+	useEffect(reportDirty, [
+		intent,
+		attempt,
+		review,
+		reviewSaved,
+		reportDirty
+	]);
+	useLayoutEffect(() => {
+		if (client !== initial.current) {
+			invalidated.current = true;
+			sequence.current++;
+		}
+	}, [client]);
+	useEffect(() => {
+		live.current = true;
+		reportDirty();
+		const leave = (event) => {
+			if (extraDirty.current) {
+				event.preventDefault();
+				event.returnValue = "";
+			}
+		};
+		window.addEventListener("beforeunload", leave);
+		return () => {
+			live.current = false;
+			sequence.current++;
+			window.removeEventListener("beforeunload", leave);
+			notify.current?.(false);
+		};
+	}, [reportDirty]);
+	useEffect(() => {
+		if (!preparedLocator || !connected) return;
+		const locator = structuredClone(preparedLocator);
+		let stopped = false;
+		setContentCandidate(void 0);
+		setContentError("");
+		setContentLoading(true);
+		initial.current.readPrepared(locator).then((value) => {
+			if (stopped || !active()) return;
+			if (!value || locator.id !== id || value.request.id !== locator.id || value.request.expectedRevision !== locator.expectedRevision || value.candidate.id !== locator.id || value.candidate.baseRevision !== locator.expectedRevision || value.candidate.revision !== locator.expectedRevision + 1 || value.candidate.digest !== locator.digest || value.request.bundle && (value.request.bundle.name !== locator.bundle?.name || value.request.bundle.version !== locator.bundle?.version) || value.candidate.preview && (value.candidate.preview.bundle.name !== locator.bundle?.name || value.candidate.preview.bundle.version !== locator.bundle?.version)) throw new Error("The candidate does not match this exact working copy, revision, Bundle pin and digest.");
+			setContentCandidate(value);
+		}).catch((failure) => {
+			if (!stopped && active()) setContentError(message(failure));
+		}).finally(() => {
+			if (!stopped && active()) setContentLoading(false);
+		});
+		return () => {
+			stopped = true;
+		};
+	}, [
+		locatorKey,
+		presentation,
+		connected,
+		active,
+		id
+	]);
+	const update = (invocationId, change) => {
+		if (!active()) return;
+		setAttempt((value) => value?.request.invocationId === invocationId ? change(value) : value);
+	};
+	async function reconcile(value) {
+		if (!active()) return;
+		const reading = ++reads.current;
+		const valid = () => active() && reads.current === reading;
+		try {
+			let ref = value.reference;
+			if (!ref) {
+				const refs = (await initial.current.listReferences()).filter((ref) => sameReference(ref, value.request));
+				if (!valid()) return;
+				if (refs.length !== 1) throw new Error(text("This request is not yet uniquely recoverable. Check again; do not send it again.", "暂时无法唯一确认这次请求。请再次核对，不要重复发送。"));
+				ref = refs[0];
+				update(value.request.invocationId, (old) => ({
+					...old,
+					reference: ref
+				}));
+			}
+			const [observed, prepared] = await Promise.allSettled([initial.current.observe(address(ref)), initial.current.readPrepared(address(ref))]);
+			if (!valid()) return;
+			if (prepared.status === "fulfilled" && prepared.value && !matchesPrepared(prepared.value, value.request)) throw new Error("The candidate belongs to a different source revision or request.");
+			const observation = observed.status === "fulfilled" && sameRun(observed.value.reference, ref) ? observed.value : void 0;
+			update(value.request.invocationId, (old) => {
+				const previous = old.observation;
+				const next = observation && (!previous || observation.throughSeq >= previous.throughSeq && (!previous.terminal || observation.terminal)) ? observation : previous;
+				return {
+					...old,
+					reference: ref,
+					observation: next,
+					prepared: prepared.status === "fulfilled" ? prepared.value : old.prepared,
+					owned: prepared.status === "fulfilled",
+					uncertain: prepared.status === "rejected" || !observation || observation.status === "unknown",
+					error: prepared.status === "rejected" ? text("This connection cannot retrieve the owned candidate or control this run. Reopen to verify its outcome.", "当前连接无法取得候选或控制这次运行，请重新打开以核对结果。") : !observation ? text("Execution status could not be checked. An available candidate can still be reviewed; execution will not be resent.", "执行状态尚未核实。已取得的候选仍可审阅，不会重发执行。") : void 0
+				};
+			});
+		} catch (failure) {
+			if (valid()) update(value.request.invocationId, (old) => ({
+				...old,
+				uncertain: true,
+				owned: false,
+				error: message(failure)
+			}));
+		}
+	}
+	const invocationId = attempt?.request.invocationId, nativeKey = attempt?.reference?.epoch;
+	useEffect(() => {
+		if (presentation !== "full" || !connected || !invocationId || busy) return;
+		let stopped = false, timer;
+		const tick = async () => {
+			const value = attemptRef.current;
+			if (!value || stopped) return;
+			await reconcile(value);
+			const latest = attemptRef.current;
+			if (!stopped && active() && (!latest?.observation?.terminal || latest.uncertain)) timer = setTimeout(() => {
+				tick();
+			}, 1200);
+		};
+		tick();
+		return () => {
+			stopped = true;
+			reads.current++;
+			clearTimeout(timer);
+		};
+	}, [
+		presentation,
+		connected,
+		invocationId,
+		nativeKey,
+		busy
+	]);
+	const sourceReady = (value) => !value.dirty || !!review && !!value.proposalReplacement?.canReplace() && review.request.id === value.record?.id && review.request.expectedRevision === value.record?.revision;
+	async function begin(snapshot) {
+		if (busyRef.current || contentLoading || !active() || !instances.saveChanges || !sourceReady(snapshot) || snapshot.busy || !snapshot.record || !intent.trim()) return;
+		const prior = attemptRef.current, record = snapshot.record;
+		const submittedIntentVersion = intentVersion.current;
+		const request = {
+			invocationId: crypto.randomUUID(),
+			id: record.id,
+			expectedRevision: record.revision,
+			paths: record.files?.filter((file) => file.editable).slice(0, 64).map((file) => file.path) ?? [],
+			bundle: snapshot.previewBundle ?? record.bundle ?? record.source.bundle,
+			prompt: intent
+		};
+		if (record.kind === "bundle" && !request.bundle || !request.paths.length || request.paths.length > 64) return;
+		if (prior && (!prior.reference || prior.uncertain || !prior.owned || !prior.observation?.terminal || !prior.observation.consumed || prior.observation.pendingInput || intent === prior.request.prompt)) return;
+		busyRef.current = true;
+		setBusy(true);
+		setError("");
+		const token = ++sequence.current;
+		const valid = () => active() && token === sequence.current;
+		try {
+			const now = editor.current;
+			if (!sourceReady(now) || now.busy || now.record?.id !== record.id || now.record.revision !== record.revision) throw new Error(text("Your source changed before authoring started. Save or discard edits, then send a new request.", "开始编辑前原始文件发生了修改。请先保存或放弃编辑，再明确发送新请求。"));
+			const value = {
+				request,
+				intentVersion: submittedIntentVersion,
+				owned: false,
+				uncertain: true
+			};
+			if (prior) setHistory((old) => [...old, conversationEntry(prior, reviewSaved)]);
+			if (review) reviewInvocation.current = request.invocationId;
+			attemptRef.current = value;
+			setAttempt(value);
+			setReviewSaved(false);
+			try {
+				const ref = prior?.reference ? await initial.current.resume({
+					...request,
+					previous: address(prior.reference),
+					explicit: true
+				}) : await initial.current.start(request);
+				if (!valid()) return;
+				if (!sameReference(ref, request)) throw new Error("The native response belongs to a different request.");
+				const accepted = {
+					...value,
+					reference: ref
+				};
+				attemptRef.current = accepted;
+				setAttempt(accepted);
+				await reconcile(accepted);
+			} catch (failure) {
+				if (!valid()) return;
+				update(request.invocationId, (old) => ({
+					...old,
+					error: text("The response was not confirmed. Check this request before taking another action. ", "响应尚未确认，请先核对这次请求。") + message(failure),
+					uncertain: true
+				}));
+				await reconcile(value);
+			}
+		} catch (failure) {
+			if (valid()) setError(message(failure));
+		} finally {
+			if (valid()) {
+				busyRef.current = false;
+				setBusy(false);
+			}
+		}
+	}
+	async function cancel() {
+		const value = attemptRef.current;
+		if (busyRef.current || !active() || !value?.reference || !value.owned || value.uncertain || !value.observation || value.observation.terminal || !["queued", "running"].includes(value.observation.status)) return;
+		busyRef.current = true;
+		reads.current++;
+		setBusy(true);
+		const token = ++sequence.current;
+		try {
+			const observed = await initial.current.cancel(address(value.reference), { expectedTurn: value.observation.turn });
+			if (!active() || token !== sequence.current) return;
+			if (!sameRun(observed.reference, value.reference)) throw new Error("The cancellation response belongs to a different request.");
+			update(value.request.invocationId, (old) => ({
+				...old,
+				observation: observed,
+				uncertain: observed.status === "unknown",
+				error: void 0
+			}));
+		} catch (failure) {
+			update(value.request.invocationId, (old) => ({
+				...old,
+				uncertain: true,
+				owned: false,
+				error: message(failure)
+			}));
+		} finally {
+			if (active() && token === sequence.current) {
+				busyRef.current = false;
+				setBusy(false);
+			}
+		}
+	}
+	const preview = (value, _adopt, options) => renderPreview ? renderPreview(value, () => {}, {
+		...options,
+		readOnly: true
+	}) : /* @__PURE__ */ jsx(PanelSamplePreview, {
+		skill: value.bundle.name,
+		panelYaml: value.panelYaml,
+		sample: value.sample,
+		locale: zh ? "zh-CN" : "en-US"
+	});
+	const contentMatches = (value) => {
+		const record = value.record, locator = preparedLocator;
+		if (!record || !locator || !contentCandidate || record.id !== locator.id || record.revision !== locator.expectedRevision || contentCandidate.request.expectedRevision !== locator.expectedRevision || contentCandidate.candidate.digest !== locator.digest) return false;
+		const pin = locator.bundle;
+		return record.kind === "bundle" ? record.bundle?.name === pin?.name && record.bundle?.version === pin?.version : pin === void 0 ? contentCandidate.request.bundle === void 0 : record.mounts.some((mount) => mount.bundle.name === pin.name && mount.bundle.version === pin.version);
+	};
+	const openContentReview = () => {
+		if (!active() || !contentCandidate || !contentMatches(editor.current) || editor.current.dirty || editor.current.busy || busy || !instances.saveChanges || savedRequest === preparedLocator?.requestId) return;
+		reviewRequest.current = preparedLocator?.requestId;
+		openedRequest.current = locatorKey;
+		setReview(structuredClone(contentCandidate));
+		setReviewSaved(false);
+	};
+	useEffect(() => {
+		if (!preparedLocator || openedRequest.current === locatorKey || review || attempt || !active() || !contentCandidate || !contentMatches(snapshot) || snapshot.dirty || snapshot.busy || busy || !instances.saveChanges || savedRequest === preparedLocator.requestId) return;
+		openedRequest.current = locatorKey;
+		reviewRequest.current = preparedLocator.requestId;
+		setReview(structuredClone(contentCandidate));
+		setReviewSaved(false);
+	}, [
+		presentation,
+		locatorKey,
+		contentCandidate,
+		snapshot,
+		connected,
+		busy,
+		review,
+		attempt,
+		savedRequest,
+		active,
+		instances
+	]);
+	const latestMatches = (current) => !!attempt?.owned && !!attempt.prepared && current.record?.id === attempt.prepared.request.id && current.record.revision === attempt.prepared.request.expectedRevision && matchesPrepared(attempt.prepared, attempt.request);
+	const newerCandidate = !reviewSaved && !!attempt?.prepared && (review ? reviewInvocation.current === attempt.request.invocationId && review.candidate.digest !== attempt.prepared.candidate.digest : snapshot.dirty);
+	const reviewLatest = () => {
+		const current = editor.current;
+		if (!active() || busyRef.current || current.busy || !instances.saveChanges || !latestMatches(current) || !attempt?.prepared) return;
+		if (newerCandidate ? !current.proposalReplacement?.discard() : current.dirty) return;
+		reviewRequest.current = void 0;
+		reviewInvocation.current = attempt.request.invocationId;
+		if (fullCandidateKey) openedFullCandidates.current.add(fullCandidateKey);
+		setReview(structuredClone(attempt.prepared));
+		setReviewSaved(false);
+	};
+	useEffect(() => {
+		if (presentation !== "full" || !fullCandidateKey || (review ? review.candidate.digest === attempt?.prepared?.candidate.digest : openedFullCandidates.current.has(fullCandidateKey)) || !active() || busyRef.current || !instances.saveChanges || !attempt?.owned || !attempt.prepared) return;
+		const current = editor.current, prepared = attempt.prepared;
+		if (current.busy || !latestMatches(current) || !current.proposalReplacement?.canReplace() || review && (reviewInvocation.current !== attempt.request.invocationId || !matchesPrepared(review, attempt.request))) return;
+		openedFullCandidates.current.add(fullCandidateKey);
+		reviewRequest.current = void 0;
+		reviewInvocation.current = attempt.request.invocationId;
+		setReview(structuredClone(prepared));
+		setReviewSaved(false);
+	}, [
+		presentation,
+		fullCandidateKey,
+		review,
+		attempt,
+		snapshot,
+		busy,
+		active,
+		instances
+	]);
+	return /* @__PURE__ */ jsxs("main", {
+		className: `ygd-studio-main${presentation === "full" ? " ygd-studio-authoring-layout" : ""}`,
+		children: [presentation === "full" && /* @__PURE__ */ jsx(AuthoringControls, {
+			snapshot,
+			zh,
+			intent,
+			setIntent: (value) => {
+				intentVersion.current++;
+				setIntent(value);
+			},
+			attempt,
+			history,
+			busy: busy || contentLoading,
+			connected,
+			error,
+			hasSave: !!instances.saveChanges,
+			saved: reviewSaved,
+			reviewing: !!review,
+			canReopen: !!fullCandidateKey && openedFullCandidates.current.has(fullCandidateKey),
+			newerCandidate,
+			begin: () => {
+				begin(editor.current);
+			},
+			cancel: () => {
+				cancel();
+			},
+			check: () => {
+				if (attempt) reconcile(attempt);
+			},
+			review: reviewLatest
+		}), /* @__PURE__ */ jsx("div", {
+			className: "ygd-studio-authoring-content",
+			"aria-label": text("Working copy content", "工作副本内容"),
+			children: /* @__PURE__ */ jsx(InstanceWorkbench, {
+				client: instances,
+				id,
+				locale,
+				onBack,
+				embedded: true,
+				initialView: "preview",
+				sourceChanges: review ? {
+					prepared: review,
+					client: reviewClient,
+					onDismiss: () => {
+						if (fullCandidateKey) openedFullCandidates.current.add(fullCandidateKey);
+						setReview(void 0);
+					},
+					onSaved: (record) => {
+						const submitted = attemptRef.current;
+						const savedCurrentProposal = !submitted || !!submitted.prepared && matchesPrepared(review, submitted.request) && submitted.prepared.candidate.digest === review.candidate.digest;
+						setReviewSaved(savedCurrentProposal);
+						setSavedRequest(reviewRequest.current);
+						setReview(void 0);
+						onChanged(record);
+					}
+				} : void 0,
+				onChanged: (record) => {
+					setReview(void 0);
+					onChanged(record);
+				},
+				initialSelection,
+				onExport,
+				renderPreview: preview,
+				onDirtyChange: editorDirty,
+				renderSupplement: (value) => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(EditorSnapshot, {
+					value,
+					onChange: syncEditor
+				}), preparedLocator && !attempt && (!review || !connected || contentLoading || contentError) && /* @__PURE__ */ jsxs("div", {
+					className: "ygd-studio-doc-toolbar",
+					children: [
+						/* @__PURE__ */ jsx("p", {
+							role: "status",
+							children: savedRequest === preparedLocator.requestId ? text("Candidate saved to the working copy.", "候选已保存到工作副本。") : !connected ? text("The connection changed. Reopen to verify this candidate.", "连接已变化，请重新打开以核对此候选。") : contentLoading ? text("Checking proposed changes…", "正在核对修改建议…") : review ? "" : value.dirty || value.busy ? text("Save or discard source edits before reviewing changes.", "请先保存或放弃原始文件编辑，再审阅修改。") : contentCandidate && !contentMatches(value) ? text("The working copy or Bundle pin has changed. Reopen the current proposal.", "工作副本或技能包版本已变化，请重新打开当前建议。") : contentCandidate ? text(`${contentCandidate.candidate.diff.length} files changed. Review before saving.`, `涉及 ${contentCandidate.candidate.diff.length} 个文件，审阅后可保存。`) : ""
+						}),
+						contentError && /* @__PURE__ */ jsx(StudioFeedback, {
+							feedbackId: `content:${contentError}`,
+							tone: "error",
+							locale,
+							title: text("Candidate could not be opened", "未能打开候选"),
+							message: contentError
+						}),
+						!review && contentCandidate && openedRequest.current === locatorKey && savedRequest !== preparedLocator.requestId && /* @__PURE__ */ jsx("button", {
+							type: "button",
+							className: "ygd-studio-btn-primary",
+							disabled: !connected || !contentMatches(value) || value.dirty || value.busy || busy || !instances.saveChanges,
+							onClick: openContentReview,
+							children: text("Review proposed changes", "审阅修改建议")
+						})
+					]
+				})] })
+			})
+		})]
+	});
+}
+function EditorSnapshot({ value, onChange }) {
+	useLayoutEffect(() => {
+		onChange(value);
+	}, [
+		value.record,
+		value.dirty,
+		value.busy,
+		value.previewBundle,
+		value.proposalReplacement,
+		onChange
+	]);
+	return null;
+}
+function AuthoringControls({ snapshot, zh, intent, setIntent, attempt, history, busy, connected, error, hasSave, saved, reviewing, canReopen, newerCandidate, begin, cancel, check, review }) {
+	const log = useRef(null), composer = useRef(null), followTail = useRef(true);
+	useEffect(() => {
+		if (log.current) log.current.scrollTop = log.current.scrollHeight;
+	}, [attempt?.request.invocationId]);
+	useLayoutEffect(() => {
+		if (followTail.current && log.current) log.current.scrollTop = log.current.scrollHeight;
+	}, [JSON.stringify(attempt?.observation?.conversation), attempt?.observation?.status]);
+	const t = (en, cn) => zh ? cn : en;
+	const record = snapshot.record, count = record?.files?.filter((file) => file.editable).length ?? 0;
+	const unavailable = !connected ? t("The connection changed. Input is retained; reopen this working copy to reconnect.", "连接已变化，输入已保留；请重新打开此副本以连接。") : !record ? t("Opening the working copy…", "正在打开工作副本…") : record.kind === "bundle" && !(snapshot.previewBundle ?? record.bundle ?? record.source.bundle) ? t("The Bundle definition is unavailable. Reopen this working copy.", "技能包定义不可用，请重新打开此副本。") : !hasSave ? t("This connection cannot save reviewed candidates.", "当前连接不支持保存审阅后的候选。") : count === 0 ? t("This copy has no editable source files.", "此副本没有可编辑的原始文件。") : "";
+	const stale = !saved && !!attempt?.prepared && attempt.prepared.request.expectedRevision !== record?.revision;
+	const resume = !!attempt && !!attempt.reference && !attempt.uncertain && attempt.owned && !!attempt.observation?.terminal && attempt.observation.consumed && !attempt.observation.pendingInput && intent !== attempt.request.prompt;
+	const working = connected && !!attempt?.observation && !attempt.observation.terminal && (attempt.observation.status === "running" || attempt.observation.status === "queued");
+	const stoppable = working && !!attempt?.reference && attempt.owned && !attempt.uncertain;
+	const needsCheck = connected && !!attempt && (attempt.uncertain || !attempt.observation || !attempt.owned);
+	const status = !connected ? t("Connection changed; execution status is unverified.", "连接已变化，执行状态尚未核实。") : !attempt ? t("Describe a change to this copy. Suggestions are reviewed before saving.", "描述对此副本的修改意图，建议将在审阅后保存。") : attempt.uncertain ? t("The request outcome needs checking. No automatic resend will occur.", "这次请求的结果尚需核对，不会自动重发。") : {
+		queued: t("Queued", "等待执行"),
+		running: t("Working", "正在处理"),
+		completed: t("Execution finished", "执行已结束"),
+		cancelled: t("Execution cancelled", "执行已取消"),
+		failed: t("Execution failed", "执行失败"),
+		unknown: t("Outcome unknown", "结果未知")
+	}[attempt.observation?.status ?? "unknown"];
+	const pristineReview = reviewing && !!snapshot.proposalReplacement?.canReplace() && !stale;
+	const canContinue = !unavailable && !snapshot.busy && !busy && (!snapshot.dirty || pristineReview);
+	const canSend = canContinue && !!intent.trim() && (!attempt || resume);
+	const continueRepair = () => {
+		if (!intent.trim() || intent === attempt?.request.prompt) {
+			const issues = attempt?.prepared?.candidate.diagnostics.map((item) => item.message).join("\n");
+			setIntent(t("Fix the issues in the current proposed changes. Preserve the original Skill method and resources, and submit the complete corrected proposal for review.", "请修复当前修改建议中的问题，保留原有 Skill 方法和资源，提交完整的修正建议供我审阅。") + (issues ? "\n\n" + issues : ""));
+		}
+		composer.current?.focus();
+	};
+	const entry = attempt ? conversationEntry(attempt, saved) : void 0;
+	const renderEntry = (value, current) => /* @__PURE__ */ jsxs("div", {
+		className: "ygd-studio-conversation-turn",
+		children: [
+			/* @__PURE__ */ jsx(ConversationMessage, {
+				row: {
+					id: value.id,
+					role: "user",
+					label: t("You", "你"),
+					text: value.prompt,
+					status: "completed"
+				},
+				renderText: (text) => /* @__PURE__ */ jsx("p", {
+					style: { whiteSpace: "pre-wrap" },
+					children: text
+				})
+			}),
+			!!value.omitted && /* @__PURE__ */ jsx("p", {
+				className: "ygd-studio-conversation-note",
+				children: t("Showing recent activity.", "显示最近的工作记录。")
+			}),
+			/* @__PURE__ */ jsx(ConversationMessages, {
+				rows: value.nativeRows ?? [],
+				active: current && working,
+				terminal: !current || !!attempt?.observation?.terminal,
+				locale: zh ? "zh" : "en"
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "ygd-studio-conversation-message",
+				children: [
+					/* @__PURE__ */ jsxs("p", {
+						role: current ? "status" : void 0,
+						children: [
+							current && working && /* @__PURE__ */ jsx("span", {
+								className: "companion-spinner",
+								"aria-hidden": "true"
+							}),
+							current ? status : value.uncertain ? t("Outcome needs checking.", "结果待核对。") : {
+								queued: t("Queued", "等待执行"),
+								running: t("Working", "正在处理"),
+								completed: t("Execution finished", "执行已结束"),
+								cancelled: t("Execution cancelled", "执行已取消"),
+								failed: t("Execution failed", "执行失败"),
+								unknown: t("Outcome unknown", "结果未知")
+							}[value.status ?? "unknown"],
+							value.saved ? t(" · Changes saved to the working copy.", " · 修改已保存到工作副本。") : value.candidateValid ? t(" · Changes available for review; not saved.", " · 修改可审阅，尚未保存。") : ""
+						]
+					}),
+					value.candidateValid && value.candidateFiles !== void 0 && /* @__PURE__ */ jsx("p", {
+						className: "ygd-studio-conversation-note",
+						children: t(`${value.candidateFiles} files changed. Review their effect in the content area.`, `涉及 ${value.candidateFiles} 个文件，可在右侧审阅修改效果。`)
+					}),
+					current && /* @__PURE__ */ jsxs(Fragment, { children: [
+						newerCandidate && /* @__PURE__ */ jsx("p", {
+							className: "ygd-studio-conversation-note",
+							children: t("Newer proposed changes are available. Your current edits are retained; review the latest to replace them.", "有更新的修改建议。当前编辑已保留；选择审阅最新建议后可替换。")
+						}),
+						/* @__PURE__ */ jsxs("div", {
+							className: "ygd-studio-conversation-actions",
+							children: [
+								newerCandidate && /* @__PURE__ */ jsx("button", {
+									type: "button",
+									className: "ygd-studio-btn-primary",
+									disabled: !connected || busy || snapshot.busy || !attempt?.owned || stale || !hasSave || !snapshot.proposalReplacement?.canDiscard(),
+									onClick: review,
+									children: t("Review latest changes", "审阅最新建议")
+								}),
+								canReopen && !reviewing && !newerCandidate && attempt?.prepared && !saved && /* @__PURE__ */ jsx("button", {
+									type: "button",
+									className: "ygd-studio-btn-primary",
+									disabled: !connected || busy || reviewing || snapshot.dirty || snapshot.busy || !attempt.owned || stale || !hasSave,
+									onClick: review,
+									children: t("Review proposed changes", "审阅修改建议")
+								}),
+								needsCheck && !attempt?.error && /* @__PURE__ */ jsx("button", {
+									type: "button",
+									className: "ygd-studio-btn-secondary",
+									disabled: busy,
+									onClick: check,
+									children: t("Check request status", "核对请求结果")
+								})
+							]
+						}),
+						attempt?.observation?.terminal && !attempt.prepared && /* @__PURE__ */ jsx("p", {
+							className: "ygd-studio-conversation-note",
+							children: t("No changes are available for review.", "暂无可审阅的修改。")
+						}),
+						attempt?.error && /* @__PURE__ */ jsx(StudioFeedback, {
+							feedbackId: `run:${value.id}:${attempt.error}`,
+							tone: "error",
+							locale: zh ? "zh" : "en",
+							title: t("The request needs checking", "需要核对这次请求"),
+							message: attempt.error,
+							actions: connected ? [{
+								label: t("Check request status", "核对请求结果"),
+								onClick: check,
+								disabled: busy
+							}] : void 0
+						}),
+						!attempt?.error && !attempt?.uncertain && attempt?.observation?.terminal && !saved && (!attempt.prepared || !attempt.prepared.candidate.valid) && /* @__PURE__ */ jsx(StudioFeedback, {
+							feedbackId: `repair:${value.id}:${attempt.prepared?.candidate.digest ?? "none"}`,
+							tone: "error",
+							locale: zh ? "zh" : "en",
+							title: attempt.prepared ? t("Changes need repair before saving", "修改仍需完善后才能保存") : t("Execution ended without a candidate", "执行结束，尚无候选"),
+							message: t("Your input and available changes are retained. Describe the repair below and send it to continue this conversation.", "输入和已有修改均已保留。在下方描述修复诉求并发送，即可继续本次对话。"),
+							details: attempt.prepared?.candidate.diagnostics.map((item) => ({ message: item.message })),
+							actions: [{
+								label: t("Continue repair", "继续修复"),
+								disabled: !canContinue || !attempt.reference || !attempt.owned || !attempt.observation.consumed || attempt.observation.pendingInput,
+								onClick: continueRepair
+							}]
+						})
+					] })
+				]
+			})
+		]
+	}, value.id);
+	return /* @__PURE__ */ jsxs("section", {
+		className: "ygd-studio-conversation",
+		"aria-label": t("AI changes", "智能修改"),
+		children: [
+			/* @__PURE__ */ jsxs("header", {
+				className: "ygd-studio-conversation-header",
+				children: [/* @__PURE__ */ jsx("h2", { children: t("Conversation", "对话") }), /* @__PURE__ */ jsx("p", { children: t("Describe your intent and review the result alongside it.", "表达修改诉求，对照右侧内容逐步完善。") })]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				ref: log,
+				className: "ygd-studio-conversation-log",
+				onScroll: (event) => {
+					const el = event.currentTarget;
+					followTail.current = el.scrollHeight - el.scrollTop - el.clientHeight < 32;
+				},
+				role: "log",
+				"aria-live": "off",
+				"aria-label": t("Requests in this editor", "本次编辑中的对话"),
+				children: [
+					!entry && /* @__PURE__ */ jsxs("div", {
+						className: "ygd-studio-conversation-welcome",
+						children: [/* @__PURE__ */ jsx("strong", { children: record?.kind === "kit" ? t("What would make this Kit work better for you?", "你希望怎样调整这个设计套件？") : t("What would make this Bundle work better for you?", "你希望怎样调整这个技能包？") }), /* @__PURE__ */ jsx("p", { children: record?.kind === "kit" ? t("Describe its purpose, design method or Bundle selection. Changes will be proposed for review before saving.", "可以描述套件用途、设计方法或技能包选择。修改会先供你审阅，确认后再保存。") : t("Describe its method, fields or Panel. Changes will be proposed for review before saving.", "可以描述设计方法、字段或面板的调整。修改会先供你审阅，确认后再保存。") })]
+					}),
+					history.map((value) => renderEntry(value, false)),
+					entry && renderEntry(entry, true)
+				]
+			}),
+			/* @__PURE__ */ jsxs("form", {
+				className: "ygd-studio-conversation-composer",
+				onSubmit: (event) => {
+					event.preventDefault();
+					if (canSend) begin();
+				},
+				children: [
+					reviewing && /* @__PURE__ */ jsx("p", {
+						className: "ygd-studio-conversation-note",
+						children: pristineReview ? t("Review the changes on the right. When execution ends, send a new intent to refine them.", "在右侧审阅修改；执行结束后，可发送新诉求继续完善。") : t("Your source edits are retained. Save them or revert them before asking AI to replace the proposal.", "原始文件编辑已保留；保存或还原人工修改后，可请求 AI 更新建议。")
+					}),
+					unavailable && /* @__PURE__ */ jsx(StudioFeedback, {
+						feedbackId: `connection:${unavailable}`,
+						tone: "info",
+						dismissible: false,
+						locale: zh ? "zh" : "en",
+						title: !connected ? t("Connection changed; reopen this working copy to reconnect.", "连接已变化，请重新打开此副本以连接。") : t("AI connection unavailable", "AI 连接暂不可用"),
+						message: unavailable
+					}),
+					!reviewing && (snapshot.dirty || snapshot.busy) && /* @__PURE__ */ jsx("p", {
+						className: "ygd-studio-conversation-note",
+						children: t("Save or discard source edits before requesting or reviewing changes.", "请先保存或放弃原始文件编辑，再请求或审阅修改。")
+					}),
+					stale && /* @__PURE__ */ jsx("p", {
+						className: "ygd-studio-conversation-note",
+						children: t("The source has changed since this candidate. Reopen to verify the saved source, or explicitly continue with a new intent.", "此候选生成后原始文件已变化。请重新打开核对已保存内容，或明确用新意图继续。")
+					}),
+					error && /* @__PURE__ */ jsx(StudioFeedback, {
+						feedbackId: `dispatch:${error}`,
+						tone: "error",
+						locale: zh ? "zh" : "en",
+						title: t("Request could not be sent", "未能发送请求"),
+						message: error
+					}),
+					/* @__PURE__ */ jsxs("label", {
+						className: "ygd-studio-field",
+						children: [/* @__PURE__ */ jsx("span", { children: t("What would you like to change?", "你希望修改什么？") }), /* @__PURE__ */ jsx("textarea", {
+							ref: composer,
+							className: "ygd-studio-text-input ygd-studio-textarea",
+							rows: 3,
+							value: intent,
+							placeholder: t("Describe a change…", "描述希望如何修改…"),
+							onChange: (event) => setIntent(event.target.value),
+							onKeyDown: (event) => {
+								if ((event.ctrlKey || event.metaKey) && event.key === "Enter" && !event.nativeEvent.isComposing) {
+									event.preventDefault();
+									if (canSend) begin();
+								}
+							}
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "ygd-studio-conversation-send",
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "ygd-studio-conversation-note",
+							children: t("Ctrl / ⌘ + Enter to send", "Ctrl / ⌘ + Enter 发送")
+						}), stoppable ? /* @__PURE__ */ jsx("button", {
+							type: "button",
+							className: "ygd-studio-btn-primary",
+							disabled: busy,
+							onClick: cancel,
+							children: t("Stop", "停止")
+						}) : /* @__PURE__ */ jsx("button", {
+							type: "submit",
+							className: "ygd-studio-btn-primary",
+							disabled: !canSend,
+							children: t("Send", "发送")
+						})]
+					})
+				]
+			})
+		]
+	});
+}
+//#endregion
+export { StudioAuthoringPromptContext, StudioAuthoringWorkbench };