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

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentRest.d.ts","sourceRoot":"","sources":["../../../../../src/components/core/solid-agent/client/agentRest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,MAAM,mBAAmB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AACtE,MAAM,MAAM,wBAAwB,GAAG;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAsBF,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,SAAI,oCAKhF;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,yCAEhD;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,4CAE7D;AAED,yFAAyF;AACzF,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,yCAE1D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,oBAEhE;AAED,wEAAwE;AACxE,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA+BjI"}

package/dist/components/core/solid-agent/client/agentRest.js

@@ -0,0 +1,178 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+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 };
+    }
+};
+import { clearAgentAuth, loadAgentAuth, isExternalAgentAuth, renewExternalAgentAuth } from "./agentAuth";
+export var HISTORY_PAGE_SIZE = 50;
+/** Calls the agent at the `httpUrl` named at sign-in, with `Authorization: Bearer <agentToken>`; null when signed out or on error. */
+function agentFetch(agentUrl, path, init, retried) {
+    var _a, _b;
+    if (init === void 0) { init = {}; }
+    if (retried === void 0) { retried = false; }
+    return __awaiter(this, void 0, void 0, function () {
+        var auth, res, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0: return [4 /*yield*/, loadAgentAuth(agentUrl)];
+                case 1:
+                    auth = _d.sent();
+                    if (!auth)
+                        return [2 /*return*/, null];
+                    return [4 /*yield*/, fetch("".concat(auth.httpUrl.replace(/\/$/, "")).concat(path), __assign(__assign({}, init), { headers: __assign({ Authorization: "Bearer ".concat(auth.agentToken) }, ((_a = init.headers) !== null && _a !== void 0 ? _a : {})) }))];
+                case 2:
+                    res = _d.sent();
+                    if (!(res.status === 401)) return [3 /*break*/, 7];
+                    return [4 /*yield*/, loadAgentAuth(agentUrl)];
+                case 3:
+                    if (((_b = (_d.sent())) === null || _b === void 0 ? void 0 : _b.agentToken) === auth.agentToken)
+                        clearAgentAuth(agentUrl);
+                    if (!(!retried && isExternalAgentAuth(agentUrl))) return [3 /*break*/, 7];
+                    return [4 /*yield*/, loadAgentAuth(agentUrl)];
+                case 4:
+                    if (!!(_d.sent())) return [3 /*break*/, 6];
+                    return [4 /*yield*/, renewExternalAgentAuth(agentUrl)];
+                case 5:
+                    _d.sent();
+                    _d.label = 6;
+                case 6: return [2 /*return*/, agentFetch(agentUrl, path, init, true)];
+                case 7:
+                    if (!res.ok)
+                        return [2 /*return*/, null];
+                    if (!(res.status === 204)) return [3 /*break*/, 8];
+                    _c = null;
+                    return [3 /*break*/, 10];
+                case 8: return [4 /*yield*/, res.json()];
+                case 9:
+                    _c = (_d.sent());
+                    _d.label = 10;
+                case 10: return [2 /*return*/, _c];
+            }
+        });
+    });
+}
+/** One page of a session's stored events, oldest first (page 1 = most recent page). */
+export function fetchSessionHistory(agentUrl, sessionId, page) {
+    if (page === void 0) { page = 1; }
+    return agentFetch(agentUrl, "/api/agent/sessions/".concat(encodeURIComponent(sessionId), "/messages?page=").concat(page, "&page_size=").concat(HISTORY_PAGE_SIZE));
+}
+/** The current user's past conversations (the agent derives the user from the token). */
+export function fetchSessionList(agentUrl) {
+    return agentFetch(agentUrl, "/api/agent/sessions/history");
+}
+export function fetchAgentConfigVersionStatus(agentUrl) {
+    return agentFetch(agentUrl, "/api/agent/config-version", { cache: "no-store" });
+}
+/** Model labels reported by the connected agent backend (never provider credentials). */
+export function fetchAgentModelAssignments(agentUrl) {
+    return agentFetch(agentUrl, "/api/agent/models", { cache: "no-store" });
+}
+export function deleteSession(agentUrl, sessionId) {
+    return agentFetch(agentUrl, "/api/agent/sessions/".concat(encodeURIComponent(sessionId)), { method: "DELETE" });
+}
+/** Upload files through the agent runtime into SolidX media storage. */
+export function uploadAgentAttachments(agentUrl, files, retried) {
+    var _a, _b, _c;
+    if (retried === void 0) { retried = false; }
+    return __awaiter(this, void 0, void 0, function () {
+        var auth, formData, response, message, body_1, _d, body;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0: return [4 /*yield*/, loadAgentAuth(agentUrl)];
+                case 1:
+                    auth = _e.sent();
+                    if (!auth)
+                        throw new Error("Sign in to the agent before uploading files.");
+                    formData = new FormData();
+                    files.forEach(function (file) { return formData.append("files", file); });
+                    return [4 /*yield*/, fetch("".concat(auth.httpUrl.replace(/\/$/, ""), "/api/agent/attachments"), {
+                            method: "POST",
+                            headers: { Authorization: "Bearer ".concat(auth.agentToken) },
+                            body: formData,
+                        })];
+                case 2:
+                    response = _e.sent();
+                    if (!(response.status === 401)) return [3 /*break*/, 7];
+                    return [4 /*yield*/, loadAgentAuth(agentUrl)];
+                case 3:
+                    if (((_a = (_e.sent())) === null || _a === void 0 ? void 0 : _a.agentToken) === auth.agentToken)
+                        clearAgentAuth(agentUrl);
+                    if (!(!retried && isExternalAgentAuth(agentUrl))) return [3 /*break*/, 7];
+                    return [4 /*yield*/, loadAgentAuth(agentUrl)];
+                case 4:
+                    if (!!(_e.sent())) return [3 /*break*/, 6];
+                    return [4 /*yield*/, renewExternalAgentAuth(agentUrl)];
+                case 5:
+                    _e.sent();
+                    _e.label = 6;
+                case 6: return [2 /*return*/, uploadAgentAttachments(agentUrl, files, true)];
+                case 7:
+                    if (!!response.ok) return [3 /*break*/, 12];
+                    message = "File upload failed.";
+                    _e.label = 8;
+                case 8:
+                    _e.trys.push([8, 10, , 11]);
+                    return [4 /*yield*/, response.json()];
+                case 9:
+                    body_1 = _e.sent();
+                    message = (_c = (_b = body_1 === null || body_1 === void 0 ? void 0 : body_1.detail) !== null && _b !== void 0 ? _b : body_1 === null || body_1 === void 0 ? void 0 : body_1.message) !== null && _c !== void 0 ? _c : message;
+                    if (Array.isArray(message))
+                        message = message.join(", ");
+                    return [3 /*break*/, 11];
+                case 10:
+                    _d = _e.sent();
+                    return [3 /*break*/, 11];
+                case 11: throw new Error(String(message));
+                case 12: return [4 /*yield*/, response.json()];
+                case 13:
+                    body = _e.sent();
+                    if (!Array.isArray(body === null || body === void 0 ? void 0 : body.attachments))
+                        throw new Error("The agent returned an invalid file upload response.");
+                    return [2 /*return*/, body.attachments];
+            }
+        });
+    });
+}
+//# sourceMappingURL=agentRest.js.map

package/dist/components/core/solid-agent/client/agentRest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRest.js","sourceRoot":"","sources":["../../../../../src/components/core/solid-agent/client/agentRest.ts"],"names":[],"mappings":"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","sourcesContent":["import { clearAgentAuth, loadAgentAuth, isExternalAgentAuth, renewExternalAgentAuth } from \"./agentAuth\";\nimport type { AgentUploadedAttachment } from \"../types\";\nimport type { AgentModelAssignments } from \"../types\";\n\nexport const HISTORY_PAGE_SIZE = 50;\n\nexport type AgentSessionSummary = {\n    session_id: string;\n    status: string;\n    totalSteps: number;\n    created_at: string | null;\n    preview: string;\n};\n\nexport type AgentHistoryPage = { messages: any[]; has_more: boolean };\nexport type AgentConfigVersionStatus = {\n    processConfigVersion: number;\n    latestConfigVersion: number;\n    stale: boolean;\n};\n\n/** Calls the agent at the `httpUrl` named at sign-in, with `Authorization: Bearer <agentToken>`; null when signed out or on error. */\nasync function agentFetch<T>(agentUrl: string, path: string, init: RequestInit = {}, retried = false): Promise<T | null> {\n    const auth = await loadAgentAuth(agentUrl);\n    if (!auth) return null;\n    const res = await fetch(`${auth.httpUrl.replace(/\\/$/, \"\")}${path}`, {\n        ...init,\n        headers: { Authorization: `Bearer ${auth.agentToken}`, ...(init.headers ?? {}) },\n    });\n    // The agent forgot the token (idle 30 min or restarted): sign in again.\n    if (res.status === 401) {\n        if ((await loadAgentAuth(agentUrl))?.agentToken === auth.agentToken) clearAgentAuth(agentUrl);\n        if (!retried && isExternalAgentAuth(agentUrl)) {\n            if (!(await loadAgentAuth(agentUrl))) await renewExternalAgentAuth(agentUrl);\n            return agentFetch<T>(agentUrl, path, init, true);\n        }\n    }\n    if (!res.ok) return null;\n    return res.status === 204 ? (null as T) : ((await res.json()) as T);\n}\n\n/** One page of a session's stored events, oldest first (page 1 = most recent page). */\nexport function fetchSessionHistory(agentUrl: string, sessionId: string, page = 1) {\n    return agentFetch<AgentHistoryPage>(\n        agentUrl,\n        `/api/agent/sessions/${encodeURIComponent(sessionId)}/messages?page=${page}&page_size=${HISTORY_PAGE_SIZE}`,\n    );\n}\n\n/** The current user's past conversations (the agent derives the user from the token). */\nexport function fetchSessionList(agentUrl: string) {\n    return agentFetch<AgentSessionSummary[]>(agentUrl, \"/api/agent/sessions/history\");\n}\n\nexport function fetchAgentConfigVersionStatus(agentUrl: string) {\n    return agentFetch<AgentConfigVersionStatus>(agentUrl, \"/api/agent/config-version\", { cache: \"no-store\" });\n}\n\n/** Model labels reported by the connected agent backend (never provider credentials). */\nexport function fetchAgentModelAssignments(agentUrl: string) {\n    return agentFetch<AgentModelAssignments>(agentUrl, \"/api/agent/models\", { cache: \"no-store\" });\n}\n\nexport function deleteSession(agentUrl: string, sessionId: string) {\n    return agentFetch<unknown>(agentUrl, `/api/agent/sessions/${encodeURIComponent(sessionId)}`, { method: \"DELETE\" });\n}\n\n/** Upload files through the agent runtime into SolidX media storage. */\nexport async function uploadAgentAttachments(agentUrl: string, files: File[], retried = false): Promise<AgentUploadedAttachment[]> {\n    const auth = await loadAgentAuth(agentUrl);\n    if (!auth) throw new Error(\"Sign in to the agent before uploading files.\");\n    const formData = new FormData();\n    files.forEach((file) => formData.append(\"files\", file));\n    const response = await fetch(`${auth.httpUrl.replace(/\\/$/, \"\")}/api/agent/attachments`, {\n        method: \"POST\",\n        headers: { Authorization: `Bearer ${auth.agentToken}` },\n        body: formData,\n    });\n    if (response.status === 401) {\n        if ((await loadAgentAuth(agentUrl))?.agentToken === auth.agentToken) clearAgentAuth(agentUrl);\n        if (!retried && isExternalAgentAuth(agentUrl)) {\n            if (!(await loadAgentAuth(agentUrl))) await renewExternalAgentAuth(agentUrl);\n            return uploadAgentAttachments(agentUrl, files, true);\n        }\n    }\n    if (!response.ok) {\n        let message = \"File upload failed.\";\n        try {\n            const body = await response.json();\n            message = body?.detail ?? body?.message ?? message;\n            if (Array.isArray(message)) message = message.join(\", \");\n        } catch {\n            // Keep a useful generic error if the runtime did not return JSON.\n        }\n        throw new Error(String(message));\n    }\n    const body = await response.json();\n    if (!Array.isArray(body?.attachments)) throw new Error(\"The agent returned an invalid file upload response.\");\n    return body.attachments as AgentUploadedAttachment[];\n}\n"]}

package/dist/components/core/solid-agent/client/agentRest.ts

@@ -0,0 +1,100 @@
+import { clearAgentAuth, loadAgentAuth, isExternalAgentAuth, renewExternalAgentAuth } from "./agentAuth";
+import type { AgentUploadedAttachment } from "../types";
+import type { AgentModelAssignments } from "../types";
+
+export const HISTORY_PAGE_SIZE = 50;
+
+export type AgentSessionSummary = {
+    session_id: string;
+    status: string;
+    totalSteps: number;
+    created_at: string | null;
+    preview: string;
+};
+
+export type AgentHistoryPage = { messages: any[]; has_more: boolean };
+export type AgentConfigVersionStatus = {
+    processConfigVersion: number;
+    latestConfigVersion: number;
+    stale: boolean;
+};
+
+/** Calls the agent at the `httpUrl` named at sign-in, with `Authorization: Bearer <agentToken>`; null when signed out or on error. */
+async function agentFetch<T>(agentUrl: string, path: string, init: RequestInit = {}, retried = false): Promise<T | null> {
+    const auth = await loadAgentAuth(agentUrl);
+    if (!auth) return null;
+    const res = await fetch(`${auth.httpUrl.replace(/\/$/, "")}${path}`, {
+        ...init,
+        headers: { Authorization: `Bearer ${auth.agentToken}`, ...(init.headers ?? {}) },
+    });
+    // The agent forgot the token (idle 30 min or restarted): sign in again.
+    if (res.status === 401) {
+        if ((await loadAgentAuth(agentUrl))?.agentToken === auth.agentToken) clearAgentAuth(agentUrl);
+        if (!retried && isExternalAgentAuth(agentUrl)) {
+            if (!(await loadAgentAuth(agentUrl))) await renewExternalAgentAuth(agentUrl);
+            return agentFetch<T>(agentUrl, path, init, true);
+        }
+    }
+    if (!res.ok) return null;
+    return res.status === 204 ? (null as T) : ((await res.json()) as T);
+}
+
+/** One page of a session's stored events, oldest first (page 1 = most recent page). */
+export function fetchSessionHistory(agentUrl: string, sessionId: string, page = 1) {
+    return agentFetch<AgentHistoryPage>(
+        agentUrl,
+        `/api/agent/sessions/${encodeURIComponent(sessionId)}/messages?page=${page}&page_size=${HISTORY_PAGE_SIZE}`,
+    );
+}
+
+/** The current user's past conversations (the agent derives the user from the token). */
+export function fetchSessionList(agentUrl: string) {
+    return agentFetch<AgentSessionSummary[]>(agentUrl, "/api/agent/sessions/history");
+}
+
+export function fetchAgentConfigVersionStatus(agentUrl: string) {
+    return agentFetch<AgentConfigVersionStatus>(agentUrl, "/api/agent/config-version", { cache: "no-store" });
+}
+
+/** Model labels reported by the connected agent backend (never provider credentials). */
+export function fetchAgentModelAssignments(agentUrl: string) {
+    return agentFetch<AgentModelAssignments>(agentUrl, "/api/agent/models", { cache: "no-store" });
+}
+
+export function deleteSession(agentUrl: string, sessionId: string) {
+    return agentFetch<unknown>(agentUrl, `/api/agent/sessions/${encodeURIComponent(sessionId)}`, { method: "DELETE" });
+}
+
+/** Upload files through the agent runtime into SolidX media storage. */
+export async function uploadAgentAttachments(agentUrl: string, files: File[], retried = false): Promise<AgentUploadedAttachment[]> {
+    const auth = await loadAgentAuth(agentUrl);
+    if (!auth) throw new Error("Sign in to the agent before uploading files.");
+    const formData = new FormData();
+    files.forEach((file) => formData.append("files", file));
+    const response = await fetch(`${auth.httpUrl.replace(/\/$/, "")}/api/agent/attachments`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${auth.agentToken}` },
+        body: formData,
+    });
+    if (response.status === 401) {
+        if ((await loadAgentAuth(agentUrl))?.agentToken === auth.agentToken) clearAgentAuth(agentUrl);
+        if (!retried && isExternalAgentAuth(agentUrl)) {
+            if (!(await loadAgentAuth(agentUrl))) await renewExternalAgentAuth(agentUrl);
+            return uploadAgentAttachments(agentUrl, files, true);
+        }
+    }
+    if (!response.ok) {
+        let message = "File upload failed.";
+        try {
+            const body = await response.json();
+            message = body?.detail ?? body?.message ?? message;
+            if (Array.isArray(message)) message = message.join(", ");
+        } catch {
+            // Keep a useful generic error if the runtime did not return JSON.
+        }
+        throw new Error(String(message));
+    }
+    const body = await response.json();
+    if (!Array.isArray(body?.attachments)) throw new Error("The agent returned an invalid file upload response.");
+    return body.attachments as AgentUploadedAttachment[];
+}

package/dist/components/core/solid-agent/client/agentRuntime.d.ts

@@ -0,0 +1,48 @@
+import { type AgentState } from "../../../../redux/features/agentSlice";
+import { type AgentRuntimeType, type AgentAttachment, type AgentContext } from "../types";
+import { AgentSocket } from "./agentSocket";
+/**
+ * A live connection to one agent backend. The "solidx" runtime is shared by the floating window and
+ * any embedded chat of that type (ensureAgentRuntime); other types get their own runtime per
+ * embedded chat (see useAgentChat). Owns the AgentSocket, normalises frames to `{ eventType, eventData }`, batches LlmToken
+ * deltas to one dispatch per animation frame, loads history on session start, and emits the
+ * public SDK events on the event bus.
+ */
+type Dispatch = (action: any) => any;
+type GetAgentState = () => AgentState | undefined;
+export declare class AgentRuntime {
+    readonly agentUrl: string;
+    private dispatch;
+    private getState;
+    readonly agentRuntime: AgentRuntimeType;
+    private persistSession;
+    readonly socket: AgentSocket;
+    private pendingDelta;
+    private frame;
+    private unsubscribers;
+    private lastContext;
+    private readonly sessionKey;
+    constructor(agentUrl: string, dispatch: Dispatch, getState: GetAgentState, agentRuntime?: AgentRuntimeType, persistSession?: boolean);
+    /**
+     * Uploads files into SolidX media storage first, then sends their IDs with the socket message.
+     */
+    sendMessage(text: string, context?: AgentContext, attachments?: AgentAttachment[], inputs?: Record<string, unknown>): Promise<void>;
+    /** Answers a widget. Sent as text too, so agents without widget_reply support still understand it. */
+    replyToWidget(widgetId: string, widget: string, value: unknown): void;
+    cancel(): void;
+    newChat(): void;
+    resume(sessionId: string): void;
+    loadOlder(): Promise<void>;
+    dispose(): void;
+    private loadHistory;
+    private handleFrame;
+    private emitSdkEvents;
+    private flushTokens;
+}
+/** Returns the shared "solidx" runtime, creating (or re-pointing) it for `agentUrl`. */
+export declare function ensureAgentRuntime(agentUrl: string, dispatch: Dispatch, getState: GetAgentState): AgentRuntime;
+export declare function getAgentRuntime(): AgentRuntime | null;
+/** Closes the connection and forgets this tab's agent logins (e.g. on logout). */
+export declare function disposeAgentRuntime(): void;
+export {};
+//# sourceMappingURL=agentRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentRuntime.d.ts","sourceRoot":"","sources":["../../../../../src/components/core/solid-agent/client/agentRuntime.ts"],"names":[],"mappings":"AACA,OAAO,EAMH,KAAK,UAAU,EAClB,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAAmB,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAuB,KAAK,YAAY,EAAuB,MAAM,UAAU,CAAC;AAIrJ,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C;;;;;;GAMG;AAEH,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;AACrC,KAAK,aAAa,GAAG,MAAM,UAAU,GAAG,SAAS,CAAC;AAyBlD,qBAAa,YAAY;IAUjB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAChB,QAAQ,CAAC,YAAY,EAAE,gBAAgB;IACvC,OAAO,CAAC,cAAc;IAb1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,WAAW,CAA2B;IAE9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGvB,QAAQ,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,aAAa,EACtB,YAAY,GAAE,gBAA2B,EAC1C,cAAc,UAAO;IAWjC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,WAAW,GAAE,eAAe,EAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAyB7H,sGAAsG;IACtG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IAa9D,MAAM;IAKN,OAAO;IAOP,MAAM,CAAC,SAAS,EAAE,MAAM;IAMlB,SAAS;IAMf,OAAO;YAMO,WAAW;IAazB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,WAAW;CAUtB;AAID,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,YAAY,CAK9G;AAED,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,SAIlC"}