@mcp-b/react-components 0.47.0 → 0.49.0

package/dist/components/agents-sdk/WorkspaceCorrespondence.d.ts

@@ -33,18 +33,27 @@ interface WorkspaceCorrespondenceSource {
   onDelete?: (path: string) => void | Promise<void>;
 }
 interface WorkspaceCorrespondenceCardProps extends Omit<CardProps, "children" | "hover" | "size" | "title" | "onChange"> {
+  /** Correspondence renderer key, such as the message or email kind selected by the host. */
   kind: string;
+  /** Workspace-relative file path represented by this card. */
   path: string;
+  /** Ordered header fields rendered above the correspondence body. */
   fields: readonly WorkspaceCorrespondenceField[];
+  /** Editable or read-only correspondence body. */
   body: string;
+  /** Leading icon identifying the correspondence channel. */
   icon?: React.ReactNode;
   /** `sent` renders the read-only snapshot and ignores `onChange`/`onSend`. */
   state?: WorkspaceCorrespondenceState;
   /** Persistence lifecycle of the visible draft. Send is disabled while set. */
   saveState?: ConnectedAppCardSaveState;
+  /** Receives the complete draft after an editable field changes. */
   onChange?: (next: WorkspaceCorrespondenceDraft) => void;
+  /** Sends the visible draft through the host-owned channel. */
   onSend?: () => void | Promise<void>;
+  /** Opens the backing correspondence file or detail route. */
   onOpen?: () => void;
+  /** Deletes the backing correspondence through the host. */
   onDelete?: () => void | Promise<void>;
 }
 interface WorkspaceCorrespondenceFileProps extends Omit<WorkspaceCorrespondenceCardProps, "body" | "fields" | "kind" | "onChange" | "onDelete" | "onOpen" | "onSend" | "path" | "saveState" | "state"> {
@@ -72,7 +81,7 @@ declare function WorkspaceCorrespondenceCard({
   ref,
   ...props
 }: WorkspaceCorrespondenceCardProps & {
-  ref?: React.Ref<HTMLDivElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLDivElement>;
 }): React.JSX.Element;
 /**
  * Query-backed reviewed correspondence. The host supplies normalized reads
@@ -85,16 +94,12 @@ declare function WorkspaceCorrespondenceCard({
  * flushes the outstanding edit first and refuses when that save fails — the
  * agent must never be told to send content the workspace does not hold.
  *
- * Interaction state belongs to one file. The adapter resets it when the
- * source's query key changes, but hosts should still key this element by path
- * where a placement can swap files, so React reconciles it as a new card.
+ * Interaction state belongs to one query identity. The keyed session makes a
+ * source swap a real unmount, so an old save or send cannot settle onto the
+ * next file.
  */
-declare function WorkspaceCorrespondenceFile({
-  fallback,
-  source,
-  ...props
-}: WorkspaceCorrespondenceFileProps & {
+declare function WorkspaceCorrespondenceFile(props: WorkspaceCorrespondenceFileProps & {
   ref?: React.Ref<HTMLDivElement>;
-}): string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null;
+}): React.JSX.Element;
 //#endregion
 export { WorkspaceCorrespondence, WorkspaceCorrespondenceCard, WorkspaceCorrespondenceCardProps, WorkspaceCorrespondenceDraft, WorkspaceCorrespondenceField, WorkspaceCorrespondenceFile, WorkspaceCorrespondenceFileProps, WorkspaceCorrespondenceSource, WorkspaceCorrespondenceState };

package/dist/components/agents-sdk/WorkspaceCorrespondence.js

@@ -9,14 +9,17 @@ import { Input } from "../foundations/Input.js";
 import { DescriptionList } from "../foundations/DescriptionList.js";
 import { Card, CardAction, CardContent, CardFooter, CardHeader, CardTitle } from "../foundations/Card.js";
 import { EmailMessageCard, SlackMessageCard } from "../ai-sdk/ConnectedAppCards.js";
-import { i as WorkspaceDeleteControl, r as httpUrl, t as FaviconMark } from "../../workspace-assets-CxpEHsac.js";
+import { i as WorkspaceDeleteControl, r as httpUrl, t as FaviconMark } from "../../workspace-assets-Bg7XhPsk.js";
 import * as React from "react";
+import { createElement } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { hashKey, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 //#region src/components/agents-sdk/WorkspaceCorrespondence.tsx
 const SAVE_DEBOUNCE_MS = 400;
 const SEND_BLOCKED_MESSAGE = "Your edit has not saved, so nothing was sent. Retry the save first.";
 const FILE_MISSING_MESSAGE = "The file is no longer in the workspace.";
+const SAVE_UNAVAILABLE_MESSAGE = "Saving is no longer available.";
+const SEND_UNAVAILABLE_MESSAGE = "Sending is no longer available.";
 function fieldValue(fields, name) {
 	return fields.find((field) => field.name === name)?.value;
 }
@@ -105,7 +108,10 @@ function GenericWorkspaceCorrespondenceCard({ className, body, fields, kind, pat
 			/* @__PURE__ */ jsxs(CardHeader, { children: [/* @__PURE__ */ jsxs(CardTitle, {
 				id: titleId,
 				className: "connected-app-card__title",
-				render: /* @__PURE__ */ jsx("h3", {}),
+				render: (props) => /* @__PURE__ */ jsx("h3", {
+					...props,
+					children: props.children
+				}),
 				children: [/* @__PURE__ */ jsx("span", {
 					className: "connected-app-card__icon",
 					"aria-hidden": "true",
@@ -298,11 +304,17 @@ function WorkspaceCorrespondenceCard({ body, fields, kind, path, icon, saveState
 * flushes the outstanding edit first and refuses when that save fails — the
 * agent must never be told to send content the workspace does not hold.
 *
-* Interaction state belongs to one file. The adapter resets it when the
-* source's query key changes, but hosts should still key this element by path
-* where a placement can swap files, so React reconciles it as a new card.
+* Interaction state belongs to one query identity. The keyed session makes a
+* source swap a real unmount, so an old save or send cannot settle onto the
+* next file.
 */
-function WorkspaceCorrespondenceFile({ fallback = null, source, ...props }) {
+function WorkspaceCorrespondenceFile(props) {
+	return /* @__PURE__ */ createElement(WorkspaceCorrespondenceFileSession, {
+		...props,
+		key: hashKey(props.source.queryOptions.queryKey)
+	});
+}
+function WorkspaceCorrespondenceFileSession({ fallback = null, source, ...props }) {
 	const queryClient = useQueryClient();
 	const persisted = useQuery(source.queryOptions).data ?? null;
 	const path = persisted?.path;
@@ -316,20 +328,9 @@ function WorkspaceCorrespondenceFile({ fallback = null, source, ...props }) {
 	const savePromiseRef = React.useRef(null);
 	/** The last projection this card rendered, kept for the sent snapshot. */
 	const lastShownRef = React.useRef(null);
-	const identity = String(source.queryOptions.queryKey);
-	const [seenIdentity, setSeenIdentity] = React.useState(identity);
-	if (identity !== seenIdentity) {
-		setSeenIdentity(identity);
-		setDraft(null);
-		setSessionSent(false);
-		attemptedDraftRef.current = null;
-		savedDraftRef.current = null;
-		savePromiseRef.current = null;
-		lastShownRef.current = null;
-	}
 	const saveMutation = useMutation({
 		mutationFn: async (next) => {
-			if (!source.onChange) return;
+			if (!source.onChange) throw new Error(SAVE_UNAVAILABLE_MESSAGE);
 			if (path === void 0) throw new Error(FILE_MISSING_MESSAGE);
 			await source.onChange(path, next);
 		},
@@ -357,36 +358,34 @@ function WorkspaceCorrespondenceFile({ fallback = null, source, ...props }) {
 		savePromiseRef.current = settled;
 		return settled;
 	}, [mutateSaveAsync]);
-	const sendMutation = useMutation({ mutationFn: async () => {
-		if (!source.onSend) return;
-		if (path === void 0) throw new Error(FILE_MISSING_MESSAGE);
-		await source.onSend(path);
-	} });
-	const { mutateAsync: mutateSendAsync } = sendMutation;
+	const { mutateAsync: mutateSendAsync } = useMutation({
+		mutationFn: async () => {
+			if (!source.onSend) throw new Error(SEND_UNAVAILABLE_MESSAGE);
+			if (path === void 0) throw new Error(FILE_MISSING_MESSAGE);
+			await source.onSend(path);
+		},
+		onSuccess: () => queryClient.invalidateQueries({
+			queryKey: source.queryOptions.queryKey,
+			exact: true
+		})
+	});
 	const canSave = source.onChange != null;
+	const settled = persisted?.state === "sent" || persisted?.state === void 0 && sessionSent;
+	const runDebouncedSave = React.useEffectEvent((next) => {
+		runSave(next);
+	});
 	React.useEffect(() => {
-		if (!canSave || path === void 0 || sessionSent || draft === null) return;
+		if (!canSave || path === void 0 || settled || draft === null) return;
 		if (draft === savedDraftRef.current || draft === attemptedDraftRef.current) return;
 		if (savePending) return;
-		const timer = setTimeout(() => void runSave(draft), SAVE_DEBOUNCE_MS);
+		const timer = setTimeout(() => runDebouncedSave(draft), SAVE_DEBOUNCE_MS);
 		return () => clearTimeout(timer);
 	}, [
 		canSave,
 		draft,
 		path,
-		runSave,
 		savePending,
-		sessionSent
-	]);
-	const { reset: resetSave } = saveMutation;
-	const { reset: resetSend } = sendMutation;
-	React.useEffect(() => {
-		resetSave();
-		resetSend();
-	}, [
-		identity,
-		resetSave,
-		resetSend
+		settled
 	]);
 	const send = React.useCallback(async () => {
 		if (savePromiseRef.current !== null && !await savePromiseRef.current) throw new Error(SEND_BLOCKED_MESSAGE);
@@ -395,13 +394,17 @@ function WorkspaceCorrespondenceFile({ fallback = null, source, ...props }) {
 			if (!await runSave(outstanding)) throw new Error(SEND_BLOCKED_MESSAGE);
 		}
 		await mutateSendAsync();
+		if (persisted) lastShownRef.current = draft === null ? persisted : {
+			...persisted,
+			...draft
+		};
 		setSessionSent(true);
 	}, [
 		draft,
 		mutateSendAsync,
+		persisted,
 		runSave
 	]);
-	if (persisted) lastShownRef.current = persisted;
 	const shown = persisted ?? (sessionSent ? lastShownRef.current : null);
 	if (!shown) return fallback;
 	const visible = draft ?? shown;

package/dist/components/agents-sdk/WorkspaceExecution.d.ts

@@ -1,4 +1,3 @@
-import { ThinkFullAppPanel } from "./ThinkFullApp.js";
 import { WorkspaceConceptQueryOptions } from "./WorkspaceConcept.js";
 import { CardProps } from "../foundations/Card.js";
 import * as React from "react";
@@ -10,51 +9,60 @@ interface WorkspaceExecutionParam {
   label: string;
   type: WorkspaceExecutionParamType;
   /**
-   * Whether the module's schema lists this property as required. Optional
-   * string and number fields may run empty and are omitted from the submitted
-   * values; required ones refuse the run until filled.
+   * Whether the module's schema lists this property as required. This is a
+   * presentation hint only; the execution runtime owns argument validation.
    */
   required: boolean;
-  value: string | number | boolean;
+  value?: string | number | boolean;
 }
 interface WorkspaceExecutionRun {
   path: string;
   label: string;
+}
+interface WorkspaceExecutionRunView extends WorkspaceExecutionRun {
   onOpen?: () => void;
 }
+interface WorkspaceExecutionOutcome {
+  /** Serialized return value from the existing execution runtime. */
+  result: unknown;
+  logs: readonly string[];
+  /** Result and log files emitted when the runtime overflowed its inline bounds. */
+  runs: readonly WorkspaceExecutionRun[];
+}
+interface WorkspaceExecutionViewOutcome extends Omit<WorkspaceExecutionOutcome, "runs"> {
+  runs: readonly WorkspaceExecutionRunView[];
+}
 interface WorkspaceExecution {
   /** Workspace path of the module file. */
   path: string;
   name: string;
   description?: string;
-  /**
-   * Hostnames or URLs the model said this operates on. Shown like user-script
-   * Sites. Not a run argument and not parsed from the JavaScript.
-   */
-  sites?: readonly string[];
-  /** Brand mark. Defaults to the first site favicon, then `TerminalIcon`. */
+  /** Brand mark. Defaults to `TerminalIcon`. */
   icon?: React.ReactNode;
   parameters: readonly WorkspaceExecutionParam[];
   /** Recent result peeks, newest first. Not a results directory. */
   runs?: readonly WorkspaceExecutionRun[];
+}
+/** Data-only execution projection hydrated with card actions outside Query. */
+interface WorkspaceExecutionView extends WorkspaceExecution {
+  runs?: readonly WorkspaceExecutionRunView[];
   /**
-   * Runs the module with the submitted values and resolves with its visible
-   * result files. The card owns the run lifecycle: a resolved promise shows a
-   * completed run even when the array is empty; returned files enrich that row.
+   * Runs the module with the submitted values. The card owns the run lifecycle;
+   * inline output and any overflow files enrich the completed row.
    */
-  onRun?: (parameters: readonly WorkspaceExecutionParam[]) => Promise<readonly WorkspaceExecutionRun[]>;
+  onRun?: (parameters: readonly WorkspaceExecutionParam[]) => Promise<WorkspaceExecutionViewOutcome>;
   onOpen?: () => void;
   onDelete?: () => void | Promise<void>;
 }
 interface WorkspaceExecutionSource {
   queryOptions: WorkspaceConceptQueryOptions<readonly WorkspaceExecution[]>;
-  /** Runs the module with the submitted values and returns its visible result files. */
-  onRun?: (path: string, parameters: readonly WorkspaceExecutionParam[]) => Promise<readonly WorkspaceExecutionRun[]>;
+  /** Runs the module with the submitted values and returns its visible outcome. */
+  onRun?: (path: string, parameters: readonly WorkspaceExecutionParam[]) => Promise<WorkspaceExecutionOutcome>;
   onOpen?: (path: string) => void;
   onDelete?: (path: string) => void | Promise<void>;
 }
 interface WorkspaceExecutionCardProps extends Omit<CardProps, "children" | "hover" | "size" | "title"> {
-  module: WorkspaceExecution;
+  module: WorkspaceExecutionView;
 }
 interface WorkspaceExecutionFileProps extends Omit<WorkspaceExecutionCardProps, "module"> {
   path: string;
@@ -62,15 +70,11 @@ interface WorkspaceExecutionFileProps extends Omit<WorkspaceExecutionCardProps,
   fallback?: React.ReactNode;
 }
 interface WorkspaceExecutionsPanelProps extends Omit<React.HTMLAttributes<HTMLElement>, "children"> {
-  modules: readonly WorkspaceExecution[];
-  /** Query failure to show instead of the empty state. Loaded modules win. */
-  error?: string;
-  onRetry?: () => void;
+  /** Shared workspace query and host actions, also used by inline module cards. */
+  source: WorkspaceExecutionSource;
 }
 declare function WorkspaceExecutionCard({
-  className,
   module,
-  ref,
   ...props
 }: WorkspaceExecutionCardProps & {
   ref?: React.Ref<HTMLDivElement>;
@@ -92,15 +96,11 @@ declare function WorkspaceExecutionFile({
  */
 declare function WorkspaceExecutionsPanel({
   className,
-  error,
-  modules,
-  onRetry,
+  source,
   ref,
   ...props
 }: WorkspaceExecutionsPanelProps & {
-  ref?: React.Ref<HTMLElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLElement>;
 }): React.JSX.Element;
-/** Canonical workbench descriptor; hosts supply only the source adapter. */
-declare function workspaceExecutionsPanel(source: WorkspaceExecutionSource): ThinkFullAppPanel;
 //#endregion
-export { WorkspaceExecution, WorkspaceExecutionCard, WorkspaceExecutionCardProps, WorkspaceExecutionFile, WorkspaceExecutionFileProps, WorkspaceExecutionParam, WorkspaceExecutionParamType, WorkspaceExecutionRun, WorkspaceExecutionSource, WorkspaceExecutionsPanel, WorkspaceExecutionsPanelProps, workspaceExecutionsPanel };
+export { WorkspaceExecution, WorkspaceExecutionCard, WorkspaceExecutionCardProps, WorkspaceExecutionFile, WorkspaceExecutionFileProps, WorkspaceExecutionOutcome, WorkspaceExecutionParam, WorkspaceExecutionParamType, WorkspaceExecutionRun, WorkspaceExecutionRunView, WorkspaceExecutionSource, WorkspaceExecutionView, WorkspaceExecutionViewOutcome, WorkspaceExecutionsPanel, WorkspaceExecutionsPanelProps };