@solidxai/core-ui 0.1.18 → 0.1.19-beta.1

package/dist/components/core/solid-agent/SolidAgentMarkdown.tsx

@@ -0,0 +1,133 @@
+import React, { useState } from "react";
+import ReactMarkdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+import { Check, Copy } from "lucide-react";
+import styles from "./SolidAgent.module.css";
+import widgetStyles from "./widgets/solidChatWidgets.module.css";
+
+/** Only http(s), mailto and in-app paths are followed; anything else (javascript:, data:) is dropped. */
+export function safeHref(href?: string): string | undefined {
+    if (!href) return undefined;
+    if (/^(https?:|mailto:)/i.test(href) || href.startsWith("/") || href.startsWith("#")) return href;
+    return undefined;
+}
+
+async function copyText(text: string, done: () => void) {
+    try {
+        await navigator.clipboard.writeText(text);
+        done();
+    } catch {
+        // Clipboard blocked; the text stays selectable.
+    }
+}
+
+/** Icon-only copy button (toolbar style), used by the code / diff widgets. */
+export function SolidAgentCopyButton({ text, label }: { text: string; label?: string }) {
+    const [copied, setCopied] = useState(false);
+    return (
+        <button
+            type="button"
+            className={styles.iconBtn}
+            aria-label={label ?? "Copy"}
+            title={copied ? "Copied" : label ?? "Copy"}
+            onClick={(event) => {
+                event.stopPropagation();
+                void copyText(text, () => {
+                    setCopied(true);
+                    setTimeout(() => setCopied(false), 1600);
+                });
+            }}
+        >
+            {copied ? <Check size={14} /> : <Copy size={14} />}
+        </button>
+    );
+}
+
+/** Small copy button shown under a message bubble on hover. */
+export function SolidAgentMessageCopyButton({ text }: { text: string }) {
+    const [copied, setCopied] = useState(false);
+    return (
+        <button
+            type="button"
+            className={widgetStyles.CopyBtn}
+            title="Copy"
+            aria-label="Copy message"
+            onClick={(event) => {
+                event.stopPropagation();
+                void copyText(text, () => {
+                    setCopied(true);
+                    setTimeout(() => setCopied(false), 2000);
+                });
+            }}
+        >
+            {copied ? <Check size={11} /> : <Copy size={11} />}
+        </button>
+    );
+}
+
+function CodeBlock({ className, children }: { className?: string; children?: React.ReactNode }) {
+    const [copied, setCopied] = useState(false);
+    const code = String(children ?? "").replace(/\n$/, "");
+    const lang = className?.replace("language-", "") ?? "";
+    return (
+        <div className={widgetStyles.CodeBlockWrapper}>
+            <div className={widgetStyles.CodeBlockHeader}>
+                <span className={widgetStyles.CodeLang}>{lang || "code"}</span>
+                <button
+                    type="button"
+                    className={widgetStyles.CodeCopyBtn}
+                    onClick={() =>
+                        void copyText(code, () => {
+                            setCopied(true);
+                            setTimeout(() => setCopied(false), 2000);
+                        })
+                    }
+                >
+                    {copied ? <Check size={11} /> : <Copy size={11} />}
+                    {copied ? "Copied" : "Copy"}
+                </button>
+            </div>
+            <pre className={widgetStyles.CodePre}><code>{code}</code></pre>
+        </div>
+    );
+}
+
+const markdownComponents = {
+    code({ className, children, ...rest }: any) {
+        // Only named fenced blocks (```lang) become a code block; everything else is inline code.
+        if (!/language-/.test(className || "")) return <code className={widgetStyles.InlineCode} {...rest}>{children}</code>;
+        return <CodeBlock className={className}>{children}</CodeBlock>;
+    },
+    pre({ children }: any) {
+        return <>{children}</>;
+    },
+    table({ children }: any) {
+        return <div className={widgetStyles.MarkdownTableWrapper}><table>{children}</table></div>;
+    },
+    a({ href, children }: any) {
+        const safe = safeHref(href);
+        if (!safe) return <span>{children}</span>;
+        const external = /^https?:/i.test(safe);
+        return (
+            <a
+                href={safe}
+                className={widgetStyles.MarkdownLink}
+                target={external ? "_blank" : undefined}
+                rel={external ? "noopener noreferrer" : undefined}
+            >
+                {children}
+            </a>
+        );
+    },
+};
+
+/** Markdown for agent text. Raw HTML in the source is never rendered (react-markdown default). */
+export function SolidAgentMarkdown({ text }: { text: string }) {
+    return (
+        <div className={widgetStyles.MarkdownRoot}>
+            <ReactMarkdown remarkPlugins={[remarkGfm]} components={markdownComponents}>
+                {text}
+            </ReactMarkdown>
+        </div>
+    );
+}

package/dist/components/core/solid-agent/SolidAgentMount.d.ts

@@ -0,0 +1,3 @@
+/** Lazy, isolated mount point for the SolidX Agent launcher. Render once in the admin layout. */
+export declare function SolidAgentMount(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SolidAgentMount.d.ts.map

package/dist/components/core/solid-agent/SolidAgentMount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidAgentMount.d.ts","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/SolidAgentMount.tsx"],"names":[],"mappings":"AAqBA,iGAAiG;AACjG,wBAAgB,eAAe,4CAQ9B"}

package/dist/components/core/solid-agent/SolidAgentMount.js

@@ -0,0 +1,62 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { Suspense } from "react";
+var SolidAgentHost = React.lazy(function () { return import("./SolidAgentHost"); });
+/** If the agent UI fails (render error or chunk load), hide it and leave the admin app untouched. */
+var AgentHostBoundary = /** @class */ (function (_super) {
+    __extends(AgentHostBoundary, _super);
+    function AgentHostBoundary() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        Object.defineProperty(_this, "state", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: { failed: false }
+        });
+        return _this;
+    }
+    Object.defineProperty(AgentHostBoundary, "getDerivedStateFromError", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function () {
+            return { failed: true };
+        }
+    });
+    Object.defineProperty(AgentHostBoundary.prototype, "componentDidCatch", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function (error) {
+            console.error("[solidAgent] the agent launcher failed and was hidden", error);
+        }
+    });
+    Object.defineProperty(AgentHostBoundary.prototype, "render", {
+        enumerable: false,
+        configurable: true,
+        writable: true,
+        value: function () {
+            return this.state.failed ? null : this.props.children;
+        }
+    });
+    return AgentHostBoundary;
+}(React.Component));
+/** Lazy, isolated mount point for the SolidX Agent launcher. Render once in the admin layout. */
+export function SolidAgentMount() {
+    return (_jsx(AgentHostBoundary, { children: _jsx(Suspense, { fallback: null, children: _jsx(SolidAgentHost, {}) }) }));
+}
+//# sourceMappingURL=SolidAgentMount.js.map

package/dist/components/core/solid-agent/SolidAgentMount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidAgentMount.js","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/SolidAgentMount.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAExC,IAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,cAAM,OAAA,MAAM,CAAC,kBAAkB,CAAC,EAA1B,CAA0B,CAAC,CAAC;AAEpE,qGAAqG;AACrG;IAAgC,qCAAmE;IAAnG;QAAA,qEAcC;QAbG;;;;mBAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;WAAC;;IAa9B,CAAC;;;;;eAXG;YACI,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;;;;;;eAED,UAAkB,KAAY;YAC1B,OAAO,CAAC,KAAK,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAC;QAClF,CAAC;;;;;;eAED;YACI,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC1D,CAAC;;IACL,wBAAC;AAAD,CAAC,AAdD,CAAgC,KAAK,CAAC,SAAS,GAc9C;AAED,iGAAiG;AACjG,MAAM,UAAU,eAAe;IAC3B,OAAO,CACH,KAAC,iBAAiB,cACd,KAAC,QAAQ,IAAC,QAAQ,EAAE,IAAI,YACpB,KAAC,cAAc,KAAG,GACX,GACK,CACvB,CAAC;AACN,CAAC","sourcesContent":["import React, { Suspense } from \"react\";\n\nconst SolidAgentHost = React.lazy(() => import(\"./SolidAgentHost\"));\n\n/** If the agent UI fails (render error or chunk load), hide it and leave the admin app untouched. */\nclass AgentHostBoundary extends React.Component<{ children: React.ReactNode }, { failed: boolean }> {\n    state = { failed: false };\n\n    static getDerivedStateFromError() {\n        return { failed: true };\n    }\n\n    componentDidCatch(error: Error) {\n        console.error(\"[solidAgent] the agent launcher failed and was hidden\", error);\n    }\n\n    render() {\n        return this.state.failed ? null : this.props.children;\n    }\n}\n\n/** Lazy, isolated mount point for the SolidX Agent launcher. Render once in the admin layout. */\nexport function SolidAgentMount() {\n    return (\n        <AgentHostBoundary>\n            <Suspense fallback={null}>\n                <SolidAgentHost />\n            </Suspense>\n        </AgentHostBoundary>\n    );\n}\n"]}

package/dist/components/core/solid-agent/SolidAgentMount.tsx

@@ -0,0 +1,31 @@
+import React, { Suspense } from "react";
+
+const SolidAgentHost = React.lazy(() => import("./SolidAgentHost"));
+
+/** If the agent UI fails (render error or chunk load), hide it and leave the admin app untouched. */
+class AgentHostBoundary extends React.Component<{ children: React.ReactNode }, { failed: boolean }> {
+    state = { failed: false };
+
+    static getDerivedStateFromError() {
+        return { failed: true };
+    }
+
+    componentDidCatch(error: Error) {
+        console.error("[solidAgent] the agent launcher failed and was hidden", error);
+    }
+
+    render() {
+        return this.state.failed ? null : this.props.children;
+    }
+}
+
+/** Lazy, isolated mount point for the SolidX Agent launcher. Render once in the admin layout. */
+export function SolidAgentMount() {
+    return (
+        <AgentHostBoundary>
+            <Suspense fallback={null}>
+                <SolidAgentHost />
+            </Suspense>
+        </AgentHostBoundary>
+    );
+}

package/dist/components/core/solid-agent/SolidXAIIcon.d.ts

@@ -0,0 +1,5 @@
+/** The SolidX agent mark (same glyph as the SolidX agent-ui). Uses currentColor. */
+export declare const SolidXAIIcon: ({ size }: {
+    size?: number | undefined;
+}) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SolidXAIIcon.d.ts.map

package/dist/components/core/solid-agent/SolidXAIIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidXAIIcon.d.ts","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/SolidXAIIcon.tsx"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,YAAY;;6CAIxB,CAAC"}

package/dist/components/core/solid-agent/SolidXAIIcon.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** The SolidX agent mark (same glyph as the SolidX agent-ui). Uses currentColor. */
+export var SolidXAIIcon = function (_a) {
+    var _b = _a.size, size = _b === void 0 ? 16 : _b;
+    return (_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", width: size, height: size, viewBox: "0 0 309.6 300.99", fill: "currentColor", "aria-hidden": "true", children: _jsx("path", { d: "M192.59,156.74l-.06.06-.18-.18-.04-.05.05-.05.04.04.19.18,94.92-98.27c10.7-10.96,10.49-28.52-.47-39.22L267.32,0l-114.34,117.15-.1.11L36.01,2.42l-19.31,19.66c-10.73,10.93-10.58,28.48.35,39.22l97.21,95.5L0,273.86l19.72,19.25c10.96,10.69,28.52,10.48,39.21-.48l94.19-96.48,101.72,97.82c8.9,8.72,23.19,8.57,31.9-.33l22.86-23.34-117.01-113.56ZM186.84,160.69l-28.53,29.23c-2.5,2.56-6.6,2.61-9.16.11l-29.23-28.53c-2.56-2.5-2.61-6.59-.11-9.15l28.53-29.23c2.5-2.56,6.6-2.61,9.16-.11l29.23,28.53c2.56,2.5,2.61,6.6.11,9.15Z" }) }));
+};
+//# sourceMappingURL=SolidXAIIcon.js.map

package/dist/components/core/solid-agent/SolidXAIIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidXAIIcon.js","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/SolidXAIIcon.tsx"],"names":[],"mappings":";AAAA,oFAAoF;AACpF,MAAM,CAAC,IAAM,YAAY,GAAG,UAAC,EAAgC;QAA9B,YAAS,EAAT,IAAI,mBAAG,EAAE,KAAA;IAA0B,OAAA,CAC9D,cAAK,KAAK,EAAC,4BAA4B,EAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAC,kBAAkB,EAAC,IAAI,EAAC,cAAc,iBAAa,MAAM,YAChI,eAAM,CAAC,EAAC,igBAAigB,GAAG,GAC1gB,CACT;AAJiE,CAIjE,CAAC","sourcesContent":["/** The SolidX agent mark (same glyph as the SolidX agent-ui). Uses currentColor. */\nexport const SolidXAIIcon = ({ size = 16 }: { size?: number }) => (\n    <svg xmlns=\"http://www.w3.org/2000/svg\" width={size} height={size} viewBox=\"0 0 309.6 300.99\" fill=\"currentColor\" aria-hidden=\"true\">\n        <path d=\"M192.59,156.74l-.06.06-.18-.18-.04-.05.05-.05.04.04.19.18,94.92-98.27c10.7-10.96,10.49-28.52-.47-39.22L267.32,0l-114.34,117.15-.1.11L36.01,2.42l-19.31,19.66c-10.73,10.93-10.58,28.48.35,39.22l97.21,95.5L0,273.86l19.72,19.25c10.96,10.69,28.52,10.48,39.21-.48l94.19-96.48,101.72,97.82c8.9,8.72,23.19,8.57,31.9-.33l22.86-23.34-117.01-113.56ZM186.84,160.69l-28.53,29.23c-2.5,2.56-6.6,2.61-9.16.11l-29.23-28.53c-2.56-2.5-2.61-6.59-.11-9.15l28.53-29.23c2.5-2.56,6.6-2.61,9.16-.11l29.23,28.53c2.56,2.5,2.61,6.6.11,9.15Z\" />\n    </svg>\n);\n"]}

package/dist/components/core/solid-agent/SolidXAIIcon.tsx

@@ -0,0 +1,6 @@
+/** The SolidX agent mark (same glyph as the SolidX agent-ui). Uses currentColor. */
+export const SolidXAIIcon = ({ size = 16 }: { size?: number }) => (
+    <svg xmlns="http://www.w3.org/2000/svg" width={size} height={size} viewBox="0 0 309.6 300.99" fill="currentColor" aria-hidden="true">
+        <path d="M192.59,156.74l-.06.06-.18-.18-.04-.05.05-.05.04.04.19.18,94.92-98.27c10.7-10.96,10.49-28.52-.47-39.22L267.32,0l-114.34,117.15-.1.11L36.01,2.42l-19.31,19.66c-10.73,10.93-10.58,28.48.35,39.22l97.21,95.5L0,273.86l19.72,19.25c10.96,10.69,28.52,10.48,39.21-.48l94.19-96.48,101.72,97.82c8.9,8.72,23.19,8.57,31.9-.33l22.86-23.34-117.01-113.56ZM186.84,160.69l-28.53,29.23c-2.5,2.56-6.6,2.61-9.16.11l-29.23-28.53c-2.56-2.5-2.61-6.59-.11-9.15l28.53-29.23c2.5-2.56,6.6-2.61,9.16-.11l29.23,28.53c2.56,2.5,2.61,6.6.11,9.15Z" />
+    </svg>
+);

package/dist/components/core/solid-agent/agentAttachments.d.ts

@@ -0,0 +1,20 @@
+import type { AgentAttachment } from "./types";
+/**
+ * Reading chat attachments in the browser. Limits match the agent (server/attachments.py)
+ * so problems are reported before sending.
+ */
+export declare const MAX_AGENT_ATTACHMENTS = 5;
+export declare const MAX_AGENT_ATTACHMENT_BYTES: number;
+export declare const MAX_AGENT_ATTACHMENTS_TOTAL_BYTES: number;
+/** Value for the file input's `accept` attribute. */
+export declare const AGENT_ATTACHMENT_ACCEPT: string;
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Validates `files` against what is already attached and reads the accepted ones.
+ * Returns the new attachments plus one message per rejected file.
+ */
+export declare function readAgentAttachments(files: File[], existing: AgentAttachment[]): Promise<{
+    added: AgentAttachment[];
+    errors: string[];
+}>;
+//# sourceMappingURL=agentAttachments.d.ts.map

package/dist/components/core/solid-agent/agentAttachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAttachments.d.ts","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/agentAttachments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;GAGG;AAEH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,0BAA0B,QAAkB,CAAC;AAC1D,eAAO,MAAM,iCAAiC,QAAmB,CAAC;AA+BlE,qDAAqD;AACrD,eAAO,MAAM,uBAAuB,QAAkG,CAAC;AAEvI,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAoBD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA+C9I"}

package/dist/components/core/solid-agent/agentAttachments.js

@@ -0,0 +1,184 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+/**
+ * Reading chat attachments in the browser. Limits match the agent (server/attachments.py)
+ * so problems are reported before sending.
+ */
+export var MAX_AGENT_ATTACHMENTS = 5;
+export var MAX_AGENT_ATTACHMENT_BYTES = 5 * 1024 * 1024;
+export var MAX_AGENT_ATTACHMENTS_TOTAL_BYTES = 10 * 1024 * 1024;
+var IMAGE_TYPES = new Set(["image/png", "image/jpeg", "image/gif", "image/webp"]);
+/** Text files by extension; browsers often report "" (or odd types, e.g. .ts → video/mp2t). */
+var TEXT_EXTENSIONS = {
+    txt: "text/plain",
+    log: "text/plain",
+    md: "text/markdown",
+    csv: "text/csv",
+    tsv: "text/tab-separated-values",
+    html: "text/html",
+    css: "text/css",
+    json: "application/json",
+    xml: "application/xml",
+    yaml: "application/yaml",
+    yml: "application/yaml",
+    js: "application/javascript",
+    jsx: "application/javascript",
+    mjs: "application/javascript",
+    ts: "application/typescript",
+    tsx: "application/typescript",
+    sql: "application/sql",
+    sh: "application/x-sh",
+    py: "text/x-python",
+    java: "text/x-java",
+    env: "text/plain",
+    ini: "text/plain",
+    toml: "text/plain",
+};
+/** Value for the file input's `accept` attribute. */
+export var AGENT_ATTACHMENT_ACCEPT = __spreadArray(__spreadArray([], Array.from(IMAGE_TYPES), true), Object.keys(TEXT_EXTENSIONS).map(function (ext) { return ".".concat(ext); }), true).join(",");
+export function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return "".concat(bytes, " B");
+    if (bytes < 1024 * 1024)
+        return "".concat((bytes / 1024).toFixed(bytes < 10 * 1024 ? 1 : 0), " KB");
+    return "".concat((bytes / (1024 * 1024)).toFixed(1), " MB");
+}
+function resolveKind(file) {
+    if (IMAGE_TYPES.has(file.type))
+        return { kind: "image", mimeType: file.type };
+    var ext = file.name.includes(".") ? file.name.split(".").pop().toLowerCase() : "";
+    if (TEXT_EXTENSIONS[ext])
+        return { kind: "text", mimeType: TEXT_EXTENSIONS[ext] };
+    if (file.type.startsWith("text/"))
+        return { kind: "text", mimeType: file.type };
+    return null;
+}
+function readAs(file, mode) {
+    return new Promise(function (resolve, reject) {
+        var reader = new FileReader();
+        reader.onload = function () { var _a; return resolve(String((_a = reader.result) !== null && _a !== void 0 ? _a : "")); };
+        reader.onerror = function () { var _a; return reject((_a = reader.error) !== null && _a !== void 0 ? _a : new Error("read failed")); };
+        if (mode === "text")
+            reader.readAsText(file);
+        else
+            reader.readAsDataURL(file);
+    });
+}
+/**
+ * Validates `files` against what is already attached and reads the accepted ones.
+ * Returns the new attachments plus one message per rejected file.
+ */
+export function readAgentAttachments(files, existing) {
+    return __awaiter(this, void 0, void 0, function () {
+        var added, errors, count, total, _i, files_1, file, kind, dataUrl, text, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    added = [];
+                    errors = [];
+                    count = existing.length;
+                    total = existing.reduce(function (sum, item) { return sum + item.meta.size; }, 0);
+                    _i = 0, files_1 = files;
+                    _b.label = 1;
+                case 1:
+                    if (!(_i < files_1.length)) return [3 /*break*/, 9];
+                    file = files_1[_i];
+                    kind = resolveKind(file);
+                    if (!kind) {
+                        errors.push("\u201C".concat(file.name, "\u201D: this file type is not supported (images and text files only)."));
+                        return [3 /*break*/, 8];
+                    }
+                    if (count >= MAX_AGENT_ATTACHMENTS) {
+                        errors.push("You can attach up to ".concat(MAX_AGENT_ATTACHMENTS, " files per message."));
+                        return [3 /*break*/, 9];
+                    }
+                    if (file.size > MAX_AGENT_ATTACHMENT_BYTES) {
+                        errors.push("\u201C".concat(file.name, "\u201D is larger than ").concat(formatFileSize(MAX_AGENT_ATTACHMENT_BYTES), "."));
+                        return [3 /*break*/, 8];
+                    }
+                    if (total + file.size > MAX_AGENT_ATTACHMENTS_TOTAL_BYTES) {
+                        errors.push("Attachments can't exceed ".concat(formatFileSize(MAX_AGENT_ATTACHMENTS_TOTAL_BYTES), " in total."));
+                        return [3 /*break*/, 8];
+                    }
+                    _b.label = 2;
+                case 2:
+                    _b.trys.push([2, 7, , 8]);
+                    if (!(kind.kind === "image")) return [3 /*break*/, 4];
+                    return [4 /*yield*/, readAs(file, "dataUrl")];
+                case 3:
+                    dataUrl = _b.sent();
+                    added.push({
+                        payload: { name: file.name, mimeType: kind.mimeType, size: file.size, encoding: "base64", content: dataUrl.slice(dataUrl.indexOf(",") + 1) },
+                        meta: { name: file.name, mimeType: kind.mimeType, size: file.size, previewUrl: dataUrl },
+                        file: file,
+                    });
+                    return [3 /*break*/, 6];
+                case 4: return [4 /*yield*/, readAs(file, "text")];
+                case 5:
+                    text = _b.sent();
+                    added.push({
+                        payload: { name: file.name, mimeType: kind.mimeType, size: file.size, encoding: "text", content: text },
+                        meta: { name: file.name, mimeType: kind.mimeType, size: file.size },
+                        file: file,
+                    });
+                    _b.label = 6;
+                case 6:
+                    count += 1;
+                    total += file.size;
+                    return [3 /*break*/, 8];
+                case 7:
+                    _a = _b.sent();
+                    errors.push("\u201C".concat(file.name, "\u201D could not be read."));
+                    return [3 /*break*/, 8];
+                case 8:
+                    _i++;
+                    return [3 /*break*/, 1];
+                case 9: return [2 /*return*/, { added: added, errors: errors }];
+            }
+        });
+    });
+}
+//# sourceMappingURL=agentAttachments.js.map

package/dist/components/core/solid-agent/agentAttachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAttachments.js","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/agentAttachments.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentAttachment } from \"./types\";\n\n/**\n * Reading chat attachments in the browser. Limits match the agent (server/attachments.py)\n * so problems are reported before sending.\n */\n\nexport const MAX_AGENT_ATTACHMENTS = 5;\nexport const MAX_AGENT_ATTACHMENT_BYTES = 5 * 1024 * 1024;\nexport const MAX_AGENT_ATTACHMENTS_TOTAL_BYTES = 10 * 1024 * 1024;\n\nconst IMAGE_TYPES = new Set([\"image/png\", \"image/jpeg\", \"image/gif\", \"image/webp\"]);\n\n/** Text files by extension; browsers often report \"\" (or odd types, e.g. .ts → video/mp2t). */\nconst TEXT_EXTENSIONS: Record<string, string> = {\n    txt: \"text/plain\",\n    log: \"text/plain\",\n    md: \"text/markdown\",\n    csv: \"text/csv\",\n    tsv: \"text/tab-separated-values\",\n    html: \"text/html\",\n    css: \"text/css\",\n    json: \"application/json\",\n    xml: \"application/xml\",\n    yaml: \"application/yaml\",\n    yml: \"application/yaml\",\n    js: \"application/javascript\",\n    jsx: \"application/javascript\",\n    mjs: \"application/javascript\",\n    ts: \"application/typescript\",\n    tsx: \"application/typescript\",\n    sql: \"application/sql\",\n    sh: \"application/x-sh\",\n    py: \"text/x-python\",\n    java: \"text/x-java\",\n    env: \"text/plain\",\n    ini: \"text/plain\",\n    toml: \"text/plain\",\n};\n\n/** Value for the file input's `accept` attribute. */\nexport const AGENT_ATTACHMENT_ACCEPT = [...Array.from(IMAGE_TYPES), ...Object.keys(TEXT_EXTENSIONS).map((ext) => `.${ext}`)].join(\",\");\n\nexport function formatFileSize(bytes: number): string {\n    if (bytes < 1024) return `${bytes} B`;\n    if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(bytes < 10 * 1024 ? 1 : 0)} KB`;\n    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n\nfunction resolveKind(file: File): { kind: \"image\" | \"text\"; mimeType: string } | null {\n    if (IMAGE_TYPES.has(file.type)) return { kind: \"image\", mimeType: file.type };\n    const ext = file.name.includes(\".\") ? file.name.split(\".\").pop()!.toLowerCase() : \"\";\n    if (TEXT_EXTENSIONS[ext]) return { kind: \"text\", mimeType: TEXT_EXTENSIONS[ext] };\n    if (file.type.startsWith(\"text/\")) return { kind: \"text\", mimeType: file.type };\n    return null;\n}\n\nfunction readAs(file: File, mode: \"text\" | \"dataUrl\"): Promise<string> {\n    return new Promise((resolve, reject) => {\n        const reader = new FileReader();\n        reader.onload = () => resolve(String(reader.result ?? \"\"));\n        reader.onerror = () => reject(reader.error ?? new Error(\"read failed\"));\n        if (mode === \"text\") reader.readAsText(file);\n        else reader.readAsDataURL(file);\n    });\n}\n\n/**\n * Validates `files` against what is already attached and reads the accepted ones.\n * Returns the new attachments plus one message per rejected file.\n */\nexport async function readAgentAttachments(files: File[], existing: AgentAttachment[]): Promise<{ added: AgentAttachment[]; errors: string[] }> {\n    const added: AgentAttachment[] = [];\n    const errors: string[] = [];\n    let count = existing.length;\n    let total = existing.reduce((sum, item) => sum + item.meta.size, 0);\n\n    for (const file of files) {\n        const kind = resolveKind(file);\n        if (!kind) {\n            errors.push(`“${file.name}”: this file type is not supported (images and text files only).`);\n            continue;\n        }\n        if (count >= MAX_AGENT_ATTACHMENTS) {\n            errors.push(`You can attach up to ${MAX_AGENT_ATTACHMENTS} files per message.`);\n            break;\n        }\n        if (file.size > MAX_AGENT_ATTACHMENT_BYTES) {\n            errors.push(`“${file.name}” is larger than ${formatFileSize(MAX_AGENT_ATTACHMENT_BYTES)}.`);\n            continue;\n        }\n        if (total + file.size > MAX_AGENT_ATTACHMENTS_TOTAL_BYTES) {\n            errors.push(`Attachments can't exceed ${formatFileSize(MAX_AGENT_ATTACHMENTS_TOTAL_BYTES)} in total.`);\n            continue;\n        }\n        try {\n            if (kind.kind === \"image\") {\n                const dataUrl = await readAs(file, \"dataUrl\");\n                added.push({\n                    payload: { name: file.name, mimeType: kind.mimeType, size: file.size, encoding: \"base64\", content: dataUrl.slice(dataUrl.indexOf(\",\") + 1) },\n                    meta: { name: file.name, mimeType: kind.mimeType, size: file.size, previewUrl: dataUrl },\n                    file,\n                });\n            } else {\n                const text = await readAs(file, \"text\");\n                added.push({\n                    payload: { name: file.name, mimeType: kind.mimeType, size: file.size, encoding: \"text\", content: text },\n                    meta: { name: file.name, mimeType: kind.mimeType, size: file.size },\n                    file,\n                });\n            }\n            count += 1;\n            total += file.size;\n        } catch {\n            errors.push(`“${file.name}” could not be read.`);\n        }\n    }\n    return { added, errors };\n}\n"]}

package/dist/components/core/solid-agent/agentAttachments.ts

@@ -0,0 +1,119 @@
+import type { AgentAttachment } from "./types";
+
+/**
+ * Reading chat attachments in the browser. Limits match the agent (server/attachments.py)
+ * so problems are reported before sending.
+ */
+
+export const MAX_AGENT_ATTACHMENTS = 5;
+export const MAX_AGENT_ATTACHMENT_BYTES = 5 * 1024 * 1024;
+export const MAX_AGENT_ATTACHMENTS_TOTAL_BYTES = 10 * 1024 * 1024;
+
+const IMAGE_TYPES = new Set(["image/png", "image/jpeg", "image/gif", "image/webp"]);
+
+/** Text files by extension; browsers often report "" (or odd types, e.g. .ts → video/mp2t). */
+const TEXT_EXTENSIONS: Record<string, string> = {
+    txt: "text/plain",
+    log: "text/plain",
+    md: "text/markdown",
+    csv: "text/csv",
+    tsv: "text/tab-separated-values",
+    html: "text/html",
+    css: "text/css",
+    json: "application/json",
+    xml: "application/xml",
+    yaml: "application/yaml",
+    yml: "application/yaml",
+    js: "application/javascript",
+    jsx: "application/javascript",
+    mjs: "application/javascript",
+    ts: "application/typescript",
+    tsx: "application/typescript",
+    sql: "application/sql",
+    sh: "application/x-sh",
+    py: "text/x-python",
+    java: "text/x-java",
+    env: "text/plain",
+    ini: "text/plain",
+    toml: "text/plain",
+};
+
+/** Value for the file input's `accept` attribute. */
+export const AGENT_ATTACHMENT_ACCEPT = [...Array.from(IMAGE_TYPES), ...Object.keys(TEXT_EXTENSIONS).map((ext) => `.${ext}`)].join(",");
+
+export function formatFileSize(bytes: number): string {
+    if (bytes < 1024) return `${bytes} B`;
+    if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(bytes < 10 * 1024 ? 1 : 0)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+function resolveKind(file: File): { kind: "image" | "text"; mimeType: string } | null {
+    if (IMAGE_TYPES.has(file.type)) return { kind: "image", mimeType: file.type };
+    const ext = file.name.includes(".") ? file.name.split(".").pop()!.toLowerCase() : "";
+    if (TEXT_EXTENSIONS[ext]) return { kind: "text", mimeType: TEXT_EXTENSIONS[ext] };
+    if (file.type.startsWith("text/")) return { kind: "text", mimeType: file.type };
+    return null;
+}
+
+function readAs(file: File, mode: "text" | "dataUrl"): Promise<string> {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(String(reader.result ?? ""));
+        reader.onerror = () => reject(reader.error ?? new Error("read failed"));
+        if (mode === "text") reader.readAsText(file);
+        else reader.readAsDataURL(file);
+    });
+}
+
+/**
+ * Validates `files` against what is already attached and reads the accepted ones.
+ * Returns the new attachments plus one message per rejected file.
+ */
+export async function readAgentAttachments(files: File[], existing: AgentAttachment[]): Promise<{ added: AgentAttachment[]; errors: string[] }> {
+    const added: AgentAttachment[] = [];
+    const errors: string[] = [];
+    let count = existing.length;
+    let total = existing.reduce((sum, item) => sum + item.meta.size, 0);
+
+    for (const file of files) {
+        const kind = resolveKind(file);
+        if (!kind) {
+            errors.push(`“${file.name}”: this file type is not supported (images and text files only).`);
+            continue;
+        }
+        if (count >= MAX_AGENT_ATTACHMENTS) {
+            errors.push(`You can attach up to ${MAX_AGENT_ATTACHMENTS} files per message.`);
+            break;
+        }
+        if (file.size > MAX_AGENT_ATTACHMENT_BYTES) {
+            errors.push(`“${file.name}” is larger than ${formatFileSize(MAX_AGENT_ATTACHMENT_BYTES)}.`);
+            continue;
+        }
+        if (total + file.size > MAX_AGENT_ATTACHMENTS_TOTAL_BYTES) {
+            errors.push(`Attachments can't exceed ${formatFileSize(MAX_AGENT_ATTACHMENTS_TOTAL_BYTES)} in total.`);
+            continue;
+        }
+        try {
+            if (kind.kind === "image") {
+                const dataUrl = await readAs(file, "dataUrl");
+                added.push({
+                    payload: { name: file.name, mimeType: kind.mimeType, size: file.size, encoding: "base64", content: dataUrl.slice(dataUrl.indexOf(",") + 1) },
+                    meta: { name: file.name, mimeType: kind.mimeType, size: file.size, previewUrl: dataUrl },
+                    file,
+                });
+            } else {
+                const text = await readAs(file, "text");
+                added.push({
+                    payload: { name: file.name, mimeType: kind.mimeType, size: file.size, encoding: "text", content: text },
+                    meta: { name: file.name, mimeType: kind.mimeType, size: file.size },
+                    file,
+                });
+            }
+            count += 1;
+            total += file.size;
+        } catch {
+            errors.push(`“${file.name}” could not be read.`);
+        }
+    }
+    return { added, errors };
+}