@agents24/chat-react 0.5.28 → 0.5.30

package/README.md

@@ -1,6 +1,6 @@
 # `@agents24/chat-react`
 
-Last Updated: 2026-08-24
+Last Updated: 2026-10-06
 
 Reusable React chat UI, runtime orchestration, and the canonical source-owned Agents24 chat scaffold.
 
@@ -109,3 +109,25 @@ The default scaffold uses the Soft shadcn preset `b2D1FHzlY`. Hosted Agent share
 For strict Vite CSP, load the application stylesheet with an HTML `<link>` and import the scaffold stylesheet from CSS. Do not add `unsafe-inline`.
 
 The package does not own credentials, routes, Fetch/SSE, token refresh, or product-specific citations, TTS, artifacts, and debug controls. React and ReactDOM `>=19 <20` are required.
+
+## Editable chat in an existing app
+
+Install the complete source-owned chat block into an existing React 19, Tailwind 4 application with shadcn configured:
+
+```sh
+npx shadcn@latest add https://docs.agents24.dev/r/agents24-chat.json
+```
+
+The block installs under your configured components directory in `agents24-chat/`. It does not replace existing host controls, create routes, or install a server bridge. Import its `styles.css` from your application stylesheet, then import `Agents24ChatScaffold` from the installed `agents24-chat/index`. For example, with the standard `src/components` directory, add `@import "../components/agents24-chat/styles.css";` to `src/app/globals.css` in Next.js, or `@import "./components/agents24-chat/styles.css";` to `src/styles.css` in Vite. Vite with strict CSP must load that application stylesheet through an HTML `<link>`, rather than a JavaScript CSS import.
+
+Pass your configured `AgentClient`, and keep authentication and routing in the host. The installed block defaults to `theme="inherit"`, using host semantic colors, fonts, radii, and dark mode. It does not manage host appearance. Soft/Sharp presets remain the defaults for hosted shares and generated applications; the installed block intentionally excludes preset styles.
+
+The source is yours to edit. Runtime packages remain dependencies and supply shared lifecycle fixes. Review source updates before reinstalling; do not use `--overwrite` on customized files. Each registry payload records its canonical source checksum and exact Agents24 dependency versions.
+
+## Composer customization
+
+`useAgentChatComposer` from `/ui` owns draft state, attachments, input validation, audio recording, submission serialization, and untouched-draft restoration. `AgentChatComposer` remains a low-level renderer; its optional `inputContract`, `recordingEnabled`, and `contextWindow` props add contract-aware controls. Without an input contract it preserves its unrestricted host-wired behavior.
+
+`Agents24ChatComposer` and `Agents24ChatComposerProps` from `/scaffold` expose the complete default composer, including Agent/model selectors and context status. The complete scaffold accepts `components={{ Composer: MyComposer }}` alongside its Timeline slot. A replacement receives the complete composer props and must preserve accessible validation, recording, cancellation, and queue controls. When rendering the complete composer outside a scaffold, wrap it in the exported `Agents24ChatThemeProvider` and `Agents24ChatTooltipProvider`; pass `theme="inherit"` for host-owned appearance.
+
+For a packaged scaffold embedded in a host theme, use `theme="inherit"` and import `@agents24/chat-react/scaffold/inherit.css` from your stylesheet instead of the preset scaffold stylesheet. Authentication remains host-owned; the scaffold provides the identity footer, not a sign-in gate.

package/dist/chunk-INO5DSSJ.js

@@ -0,0 +1,86 @@
+// src/runtime/input-contract.ts
+import { normalizeAttachmentMimeType, SUPPORTED_ATTACHMENT_MIME_TYPES } from "@agents24/client";
+import { attachmentFileAccept, normalizeAttachmentMimeType as normalizeAttachmentMimeType2 } from "@agents24/client";
+var SUPPORTED_INPUT_MIME_TYPES = SUPPORTED_ATTACHMENT_MIME_TYPES;
+function workflowInputRule(inputs, key) {
+  const input = inputs?.find((candidate) => candidate.key === key);
+  return {
+    enabled: input?.enabled !== false,
+    required: input?.required === true
+  };
+}
+function validateWorkflowInputSubmission(inputs, text, attachmentMimeTypes) {
+  const present = { files: false, images: false, audio: false };
+  if (text.trim() && !workflowInputRule(inputs, "text").enabled) {
+    return "This workflow does not accept text input.";
+  }
+  for (const rawMimeType of attachmentMimeTypes) {
+    const mimeType = canonicalInputMimeType(rawMimeType);
+    const modality = mimeType.startsWith("image/") ? "images" : mimeType.startsWith("audio/") ? "audio" : "files";
+    const supported = SUPPORTED_INPUT_MIME_TYPES[modality].includes(mimeType);
+    if (!supported || !workflowInputRule(inputs, modality).enabled) {
+      return `The attachment type ${mimeType || "unknown"} is not accepted.`;
+    }
+    present[modality] = true;
+  }
+  if (workflowInputRule(inputs, "text").required && !text.trim()) return "Text input is required.";
+  for (const modality of ["files", "images", "audio"]) {
+    if (workflowInputRule(inputs, modality).required && !present[modality]) {
+      return `${modality[0].toUpperCase()}${modality.slice(1)} input is required.`;
+    }
+  }
+  return null;
+}
+var canonicalInputMimeType = normalizeAttachmentMimeType;
+function uploadByteSize(data) {
+  if (data instanceof Uint8Array || data instanceof ArrayBuffer) return data.byteLength;
+  return data.size;
+}
+function inputMimeTypes(contract) {
+  if (!contract) return [];
+  return [
+    ...contract.modalities.files.allowed_mime_types,
+    ...contract.modalities.images.allowed_mime_types,
+    ...contract.modalities.audio.allowed_mime_types
+  ];
+}
+function validateAgentChatSubmission(contract, text, files) {
+  const { modalities, limits } = contract;
+  const normalizedText = text.trim();
+  if (normalizedText && !modalities.text.enabled) return "This agent does not accept text input.";
+  if (modalities.text.required && !normalizedText) return "Text input is required.";
+  if (files.length > limits.max_attachments_per_turn) {
+    return `You can attach up to ${limits.max_attachments_per_turn} items per message.`;
+  }
+  let totalBytes = 0;
+  const present = { files: false, images: false, audio: false };
+  for (const file of files) {
+    const mediaType = normalizeAttachmentMimeType(file.mediaType, file.name);
+    const modality = mediaType.startsWith("image/") ? "images" : mediaType.startsWith("audio/") ? "audio" : "files";
+    const rule = modalities[modality];
+    if (!rule.enabled || !rule.allowed_mime_types.includes(mediaType)) {
+      return `The attachment type ${mediaType || "unknown"} is not accepted.`;
+    }
+    const byteSize = file.byteSize ?? uploadByteSize(file.data);
+    if (byteSize > limits.max_file_bytes) return "An attachment exceeds the per-file size limit.";
+    totalBytes += byteSize;
+    present[modality] = true;
+  }
+  if (totalBytes > limits.max_total_bytes) return "Attachments exceed the total size limit.";
+  for (const modality of ["files", "images", "audio"]) {
+    if (modalities[modality].required && !present[modality]) return `${modality[0].toUpperCase()}${modality.slice(1)} input is required.`;
+  }
+  return null;
+}
+
+export {
+  SUPPORTED_INPUT_MIME_TYPES,
+  workflowInputRule,
+  validateWorkflowInputSubmission,
+  canonicalInputMimeType,
+  inputMimeTypes,
+  validateAgentChatSubmission,
+  attachmentFileAccept,
+  normalizeAttachmentMimeType2 as normalizeAttachmentMimeType
+};
+//# sourceMappingURL=chunk-INO5DSSJ.js.map

package/dist/chunk-INO5DSSJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/input-contract.ts"],"sourcesContent":["import { normalizeAttachmentMimeType, SUPPORTED_ATTACHMENT_MIME_TYPES, type ClientInputFeature, type PortableUpload } from \"@agents24/client\";\nexport { attachmentFileAccept, normalizeAttachmentMimeType } from \"@agents24/client\";\n\nexport type AgentChatInputContract = ClientInputFeature;\n\nexport const SUPPORTED_INPUT_MIME_TYPES = SUPPORTED_ATTACHMENT_MIME_TYPES;\n\nexport type WorkflowInputRule = {\n  key: string;\n  enabled?: boolean;\n  required?: boolean;\n};\n\nexport function workflowInputRule(\n  inputs: readonly WorkflowInputRule[] | null | undefined,\n  key: string,\n): { enabled: boolean; required: boolean } {\n  const input = inputs?.find((candidate) => candidate.key === key);\n  return {\n    enabled: input?.enabled !== false,\n    required: input?.required === true,\n  };\n}\n\nexport function validateWorkflowInputSubmission(\n  inputs: readonly WorkflowInputRule[] | null | undefined,\n  text: string,\n  attachmentMimeTypes: readonly string[],\n): string | null {\n  const present = { files: false, images: false, audio: false };\n  if (text.trim() && !workflowInputRule(inputs, \"text\").enabled) {\n    return \"This workflow does not accept text input.\";\n  }\n  for (const rawMimeType of attachmentMimeTypes) {\n    const mimeType = canonicalInputMimeType(rawMimeType);\n    const modality = mimeType.startsWith(\"image/\") ? \"images\" : mimeType.startsWith(\"audio/\") ? \"audio\" : \"files\";\n    const supported = (SUPPORTED_INPUT_MIME_TYPES[modality] as readonly string[]).includes(mimeType);\n    if (!supported || !workflowInputRule(inputs, modality).enabled) {\n      return `The attachment type ${mimeType || \"unknown\"} is not accepted.`;\n    }\n    present[modality] = true;\n  }\n  if (workflowInputRule(inputs, \"text\").required && !text.trim()) return \"Text input is required.\";\n  for (const modality of [\"files\", \"images\", \"audio\"] as const) {\n    if (workflowInputRule(inputs, modality).required && !present[modality]) {\n      return `${modality[0].toUpperCase()}${modality.slice(1)} input is required.`;\n    }\n  }\n  return null;\n}\n\nexport const canonicalInputMimeType = normalizeAttachmentMimeType;\n\nfunction uploadByteSize(data: PortableUpload[\"data\"]): number {\n  if (data instanceof Uint8Array || data instanceof ArrayBuffer) return data.byteLength;\n  return data.size;\n}\n\nexport function inputMimeTypes(contract: AgentChatInputContract | null | undefined): string[] {\n  if (!contract) return [];\n  return [\n    ...contract.modalities.files.allowed_mime_types,\n    ...contract.modalities.images.allowed_mime_types,\n    ...contract.modalities.audio.allowed_mime_types,\n  ];\n}\n\nexport function validateAgentChatSubmission(\n  contract: AgentChatInputContract,\n  text: string,\n  files: readonly (Pick<PortableUpload, \"mediaType\" | \"data\"> & Partial<Pick<PortableUpload, \"name\">> & { byteSize?: number })[],\n): string | null {\n  const { modalities, limits } = contract;\n  const normalizedText = text.trim();\n  if (normalizedText && !modalities.text.enabled) return \"This agent does not accept text input.\";\n  if (modalities.text.required && !normalizedText) return \"Text input is required.\";\n  if (files.length > limits.max_attachments_per_turn) {\n    return `You can attach up to ${limits.max_attachments_per_turn} items per message.`;\n  }\n  let totalBytes = 0;\n  const present = { files: false, images: false, audio: false };\n  for (const file of files) {\n    const mediaType = normalizeAttachmentMimeType(file.mediaType, file.name);\n    const modality = mediaType.startsWith(\"image/\") ? \"images\" : mediaType.startsWith(\"audio/\") ? \"audio\" : \"files\";\n    const rule = modalities[modality];\n    if (!rule.enabled || !rule.allowed_mime_types.includes(mediaType)) {\n      return `The attachment type ${mediaType || \"unknown\"} is not accepted.`;\n    }\n    const byteSize = file.byteSize ?? uploadByteSize(file.data);\n    if (byteSize > limits.max_file_bytes) return \"An attachment exceeds the per-file size limit.\";\n    totalBytes += byteSize;\n    present[modality] = true;\n  }\n  if (totalBytes > limits.max_total_bytes) return \"Attachments exceed the total size limit.\";\n  for (const modality of [\"files\", \"images\", \"audio\"] as const) {\n    if (modalities[modality].required && !present[modality]) return `${modality[0].toUpperCase()}${modality.slice(1)} input is required.`;\n  }\n  return null;\n}\n"],"mappings":"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","names":["normalizeAttachmentMimeType"]}