@agent-native/toolkit 0.21.3 → 0.22.0-nightly-20260926111339

package/src/composer/PromptComposer.tsx

@@ -36,12 +36,15 @@ import {
   PROMPT_DOCUMENT_ATTACHMENT_ACCEPT,
   TextAttachmentAdapter,
 } from "./attachment-accept.js";
+import type { ComposerContextMenuItem } from "./ComposerContextMenu.js";
 import type { ComposerTerminalModeControl } from "./ComposerPlusMenu.js";
+import type { ComposerContextSnapshot } from "./context-items.js";
 import { isPastedTextAttachmentName } from "./pasted-text.js";
 import { PastedTextChip } from "./PastedTextChip.js";
 import { escapePromptAttachmentAttribute } from "./prompt-attachments.js";
 import {
   type EngineModelGroup,
+  type AgentChatContextItem,
   type ReasoningEffort,
   useComposerRuntimeAdapters,
 } from "./runtime-adapters.js";
@@ -75,9 +78,15 @@ export interface PromptComposerSubmitOptions {
   engine?: string;
   effort?: ReasoningEffort;
   attachments?: ReadonlyArray<unknown>;
+  contextItems?: ComposerContextSnapshot;
 }
 
 export interface PromptComposerProps {
+  contextItems?: readonly AgentChatContextItem[];
+  onRemoveContextItem?: (key: string) => void;
+  onInspectContextItem?: (key: string) => void;
+  onRetryContextItem?: (key: string) => void;
+  contextMenuItems?: readonly ComposerContextMenuItem[];
   /** Called when the user submits the composer. */
   onSubmit: (
     text: string,
@@ -89,6 +98,8 @@ export interface PromptComposerProps {
   /** Accessible name forwarded to the rich text editor. */
   ariaLabel?: string;
   disabled?: boolean;
+  /** Block all submission paths while allowing draft, file, and context staging. */
+  submissionDisabled?: boolean;
   /** Prevent submission while preserving editor focus and draft entry. */
   submitting?: boolean;
   /** Present the primary action as queueing instead of immediate send. */
@@ -118,6 +129,10 @@ export interface PromptComposerProps {
   voiceEnabled?: boolean;
   /** Show file upload controls and pass submitted files to onSubmit (default: true). */
   attachmentsEnabled?: boolean;
+  /** Host-owned file acceptance and staging; the shared composer still owns picker and chips. */
+  attachmentAdapter?: AttachmentAdapter;
+  /** Let hosts extract ordinary uploaded text without also inlining it. */
+  inlineTextAttachments?: boolean;
   /**
    * Controls the shared "+" affordance. Defaults to upload-only for standalone
    * prompt forms; chat surfaces can opt into the full sidebar menu.
@@ -280,10 +295,8 @@ function formatInlineTextFile(name: string, text: string): string {
 }
 
 /**
- * Only a confirmed-missing engine that also has a setup component to render
- * may block typing: a disabled composer with no way out is never an acceptable
- * terminal state, and `unknown`/`unavailable` mean the status check has not
- * answered — not that no provider is configured.
+ * Show the attached setup treatment only for a confirmed-missing engine with
+ * a setup component. Unresolved status does not mean a provider is missing.
  */
 export function shouldGateComposerForMissingEngine(input: {
   state: string;
@@ -295,6 +308,7 @@ export function shouldGateComposerForMissingEngine(input: {
 export async function buildPromptComposerSubmission(options: {
   text: string;
   attachments?: ReadonlyArray<unknown>;
+  inlineTextAttachments?: boolean;
 }): Promise<{ text: string; files: File[] }> {
   const files: File[] = [];
   const pastedTextBlocks: string[] = [];
@@ -311,7 +325,10 @@ export async function buildPromptComposerSubmission(options: {
           files.push(file);
         }
       } else {
-        if (isInlineableTextFile(file)) {
+        if (
+          options.inlineTextAttachments !== false &&
+          isInlineableTextFile(file)
+        ) {
           try {
             pastedTextBlocks.push(
               formatInlineTextFile(file.name, await file.text()),
@@ -519,9 +536,15 @@ function PromptAttachmentStrip() {
 
 function PromptComposerInner({
   onSubmit,
+  contextItems,
+  onRemoveContextItem,
+  onInspectContextItem,
+  onRetryContextItem,
+  contextMenuItems,
   placeholder,
   ariaLabel,
   disabled,
+  submissionDisabled,
   submitting,
   willQueue = false,
   onDisabledClick,
@@ -539,6 +562,7 @@ function PromptComposerInner({
   showAutoModelOption = true,
   voiceEnabled = DEFAULT_VOICE_DICTATION_ENABLED,
   attachmentsEnabled = true,
+  inlineTextAttachments = true,
   plusMenuMode,
   terminalModeControl,
   extensionTools = false,
@@ -578,7 +602,6 @@ function PromptComposerInner({
   composerRef,
 }: PromptComposerProps) {
   const adapters = useComposerRuntimeAdapters();
-  const t = adapters.translate!;
   const modelsAdapter = adapters.models!;
   const BuilderSetupCard = modelsAdapter.BuilderSetupCard;
   const BuilderSetupContent = modelsAdapter.BuilderSetupContent;
@@ -666,6 +689,10 @@ function PromptComposerInner({
     ),
   });
   const ensureEngineReadyBeforeSubmit = useCallback(async () => {
+    if (agentEngineConfigured.state === "missing") {
+      bounceMissingKeySetup();
+      return false;
+    }
     if (agentEngineConfigured.state !== "unknown") return true;
     const state = await modelsAdapter.fetchAgentEngineConfiguredState?.(true, {
       timeoutMs: 5_000,
@@ -678,7 +705,7 @@ function PromptComposerInner({
   }, [agentEngineConfigured.state, bounceMissingKeySetup, modelsAdapter]);
 
   useEffect(() => {
-    if (!autoFocus || gateComposer) return;
+    if (!autoFocus || disabled) return;
     const id = window.setTimeout(() => {
       const target =
         typeof handleRef === "object" && handleRef && "current" in handleRef
@@ -687,7 +714,7 @@ function PromptComposerInner({
       target?.focus();
     }, 50);
     return () => window.clearTimeout(id);
-  }, [autoFocus, gateComposer, handleRef]);
+  }, [autoFocus, disabled, handleRef]);
 
   const handleSubmit = useCallback(
     async (
@@ -705,6 +732,7 @@ function PromptComposerInner({
       const { text: finalText, files } = await buildPromptComposerSubmission({
         text,
         attachments,
+        inlineTextAttachments,
       });
       await onSubmit(finalText, files, references, {
         intent: submitOptions?.intent ?? "immediate",
@@ -712,9 +740,18 @@ function PromptComposerInner({
         engine: composerEngine,
         effort: composerEffort,
         attachments,
+        ...(submitOptions?.contextItems === undefined
+          ? {}
+          : { contextItems: submitOptions.contextItems }),
       });
     },
-    [composerEffort, composerEngine, composerModel, onSubmit],
+    [
+      composerEffort,
+      composerEngine,
+      composerModel,
+      onSubmit,
+      inlineTextAttachments,
+    ],
   );
   return (
     <>
@@ -738,7 +775,6 @@ function PromptComposerInner({
       <AgentComposerFrame
         className={cn(
           "text-start",
-          gateComposer && "cursor-pointer",
           (gateComposer || onDisabledClick) &&
             "agent-composer-area--attached-above",
           className,
@@ -747,30 +783,27 @@ function PromptComposerInner({
         style={style}
         rootStyle={rootStyle}
         layoutVariant={layoutVariant}
-        onClick={
-          gateComposer
-            ? bounceMissingKeySetup
-            : onDisabledClick
-              ? () => onDisabledClick()
-              : undefined
-        }
+        onClick={disabled ? onDisabledClick : undefined}
       >
         <PromptAttachmentStrip />
         <TiptapComposer
+          contextItems={contextItems}
+          contextMenuItems={contextMenuItems}
+          onRemoveContextItem={onRemoveContextItem}
+          onInspectContextItem={onInspectContextItem}
+          onRetryContextItem={onRetryContextItem}
+          attachmentsEnabled={attachmentsEnabled}
           ariaLabel={ariaLabel}
           focusRef={handleRef}
-          disabled={disabled || gateComposer}
+          disabled={disabled}
+          submissionDisabled={
+            submissionDisabled || agentEngineConfigured.state === "missing"
+          }
           submitting={submitting}
           willQueue={willQueue}
           maxDocumentAttachmentBytes={maxDocumentAttachmentBytes}
           documentAttachmentLimitLabel={documentAttachmentLimitLabel}
-          placeholder={
-            gateComposer
-              ? t("agentChat.composer.connectAbove", {
-                  defaultValue: "Connect AI above to continue...",
-                })
-              : placeholder
-          }
+          placeholder={placeholder}
           initialText={initialText}
           initialTextKey={initialTextKey}
           onSubmit={handleSubmit}
@@ -836,12 +869,13 @@ function PromptComposerRuntime(props: PromptComposerProps) {
     useComposerRuntimeAdapters().agentChat!.StaleIndexBoundary!;
   const attachmentAdapter = useMemo(
     () =>
+      props.attachmentAdapter ??
       new CompositeAttachmentAdapter([
         new RasterImageAttachmentAdapter(),
         new BinaryDocumentAttachmentAdapter(),
         new TextAttachmentAdapter(),
       ]),
-    [],
+    [props.attachmentAdapter],
   );
   const runtime = useLocalRuntime(NOOP_ADAPTER, {
     adapters: { attachments: attachmentAdapter },