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

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

@@ -0,0 +1,155 @@
+/**
+ * Shared types for the SolidX Agent chat (launcher, window, thread).
+ *
+ * Wire format: every agent payload carries `event_type` and `event_data`. When
+ * `event_data.widget` names a registered chat widget, that widget renders the event;
+ * otherwise the event is rendered by the default widget for its `event_type`.
+ * (Legacy frames `{ type, data }` are normalised to the same shape.)
+ * The widget contract itself (SolidChatWidgetProps) lives in types/solid-core.d.ts.
+ */
+/** Page context passed with a prompt so the agent knows where the user is. */
+export type AgentContext = {
+    module?: string;
+    model?: string;
+    recordId?: string | number;
+    route?: string;
+    [key: string]: unknown;
+};
+export type AgentMode = "bubble" | "compact" | "docked" | "maximized";
+/**
+ * Which agent backend a chat talks to: "solidx" (setting solidxAgentBackendUrl; the floating
+ * launcher) or "agentHub" (setting solidxAgentHubBackendUrl).
+ */
+export type AgentRuntimeType = "solidx" | "agentHub";
+export type AgentModelAssignment = {
+    provider: string;
+    model: string;
+} | null;
+export type AgentModelAssignments = {
+    reasoning: AgentModelAssignment;
+    fast: AgentModelAssignment;
+};
+/** @deprecated Use AgentRuntimeType. */
+export type AgentType = AgentRuntimeType;
+export type AgentConnection = "idle" | "connecting" | "open" | "reconnecting" | "offline";
+/** A slash command advertised by the agent in `session_started`. */
+export type AgentCommand = {
+    name: string;
+    description?: string;
+};
+/** A frame as it arrives on the socket or from session history (before normalisation). */
+export type AgentWireFrame = {
+    event_type?: string;
+    event_data?: Record<string, any>;
+    type?: string;
+    data?: Record<string, any>;
+    session_id?: string;
+    history_session_id?: string;
+    [key: string]: any;
+};
+/** The normalised event every reducer and widget works with. */
+export type AgentChatEvent = {
+    eventType: string;
+    eventData: Record<string, any>;
+    /** Top-level fields of the frame (session_id, history_session_id, commands, ...). */
+    frame: AgentWireFrame;
+};
+/** Event types the chat knows by name. Anything else is still rendered (via its widget or the fallback). */
+export declare const AgentEventTypes: {
+    readonly sessionStarted: "session_started";
+    readonly sessionEnded: "session_ended";
+    readonly userMessage: "UserMessage";
+    readonly agentStarted: "AgentStarted";
+    readonly stepStarted: "StepStarted";
+    readonly stepComplete: "StepComplete";
+    readonly llmToken: "LlmToken";
+    readonly llmComplete: "LlmComplete";
+    readonly toolCalling: "ToolCalling";
+    readonly toolProgress: "ToolProgress";
+    readonly toolResult: "ToolResult";
+    readonly turnComplete: "TurnCompleteEvent";
+    readonly turnCompleteLegacy: "turn_complete";
+    readonly agentComplete: "AgentComplete";
+    readonly executionCancelled: "ExecutionCancelled";
+    readonly executionCancelledLegacy: "execution_cancelled";
+    readonly agentError: "AgentError";
+    readonly error: "error";
+};
+export type WidgetReply = {
+    widgetId: string;
+    value: unknown;
+};
+/** A file sent inline with a message: text files as text, images base64-encoded (no data: prefix). */
+export type AgentAttachmentPayload = {
+    name: string;
+    mimeType: string;
+    size: number;
+    encoding: "text" | "base64";
+    content: string;
+};
+/** What the thread shows for an attachment (history only has name/type/size). */
+export type AgentAttachmentMeta = {
+    mediaId?: number;
+    name: string;
+    mimeType: string;
+    size: number;
+    /** data: URL for image thumbnails of files attached in this browser session. */
+    previewUrl?: string;
+    /** Stored copy in Solid media storage (resolved when a conversation is reopened). */
+    url?: string;
+};
+export type AgentAttachment = {
+    payload: AgentAttachmentPayload;
+    meta: AgentAttachmentMeta;
+    file: File;
+};
+export type AgentUploadedAttachment = {
+    id: number;
+    name: string;
+    mimeType: string;
+    size: number;
+};
+export type AgentAction = {
+    action: "start_session";
+} | {
+    action: "resume_session";
+    session_id: string;
+} | {
+    action: "message";
+    session_id: string;
+    content: string;
+    context?: AgentContext;
+    inputs?: Record<string, unknown>;
+    widget_reply?: WidgetReply | null;
+    attachments?: AgentAttachmentPayload[] | AgentUploadedAttachment[];
+} | {
+    action: "cancel";
+    session_id: string;
+} | {
+    action: "end_session";
+    session_id: string;
+};
+/**
+ * One rendered entry in the thread. `eventData` is the (accumulated) event payload handed to
+ * the widget; `widget` is set when the agent named one, otherwise the default for `eventType`.
+ */
+export type AgentChatItem = {
+    id: string;
+    at: number;
+    eventType: string;
+    eventData: Record<string, any>;
+    widget?: string;
+    widgetId?: string;
+    /** Live items (a running tool, a streaming reply) are still updating. */
+    live?: boolean;
+    /** A final widget accepts no more updates or replies. */
+    final?: boolean;
+};
+/** Options for `solidAgent.open`. */
+export type SolidAgentOpenOptions = {
+    prompt?: string;
+    autoSend?: boolean;
+    context?: AgentContext;
+    mode?: Exclude<AgentMode, "bubble">;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,31 @@
+/**
+ * Shared types for the SolidX Agent chat (launcher, window, thread).
+ *
+ * Wire format: every agent payload carries `event_type` and `event_data`. When
+ * `event_data.widget` names a registered chat widget, that widget renders the event;
+ * otherwise the event is rendered by the default widget for its `event_type`.
+ * (Legacy frames `{ type, data }` are normalised to the same shape.)
+ * The widget contract itself (SolidChatWidgetProps) lives in types/solid-core.d.ts.
+ */
+/** Event types the chat knows by name. Anything else is still rendered (via its widget or the fallback). */
+export var AgentEventTypes = {
+    sessionStarted: "session_started",
+    sessionEnded: "session_ended",
+    userMessage: "UserMessage",
+    agentStarted: "AgentStarted",
+    stepStarted: "StepStarted",
+    stepComplete: "StepComplete",
+    llmToken: "LlmToken",
+    llmComplete: "LlmComplete",
+    toolCalling: "ToolCalling",
+    toolProgress: "ToolProgress",
+    toolResult: "ToolResult",
+    turnComplete: "TurnCompleteEvent",
+    turnCompleteLegacy: "turn_complete",
+    agentComplete: "AgentComplete",
+    executionCancelled: "ExecutionCancelled",
+    executionCancelledLegacy: "execution_cancelled",
+    agentError: "AgentError",
+    error: "error",
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiDH,4GAA4G;AAC5G,MAAM,CAAC,IAAM,eAAe,GAAG;IAC3B,cAAc,EAAE,iBAAiB;IACjC,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,mBAAmB;IACjC,kBAAkB,EAAE,eAAe;IACnC,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;IACxC,wBAAwB,EAAE,qBAAqB;IAC/C,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,OAAO;CACR,CAAC","sourcesContent":["/**\n * Shared types for the SolidX Agent chat (launcher, window, thread).\n *\n * Wire format: every agent payload carries `event_type` and `event_data`. When\n * `event_data.widget` names a registered chat widget, that widget renders the event;\n * otherwise the event is rendered by the default widget for its `event_type`.\n * (Legacy frames `{ type, data }` are normalised to the same shape.)\n * The widget contract itself (SolidChatWidgetProps) lives in types/solid-core.d.ts.\n */\n\n/** Page context passed with a prompt so the agent knows where the user is. */\nexport type AgentContext = {\n    module?: string;\n    model?: string;\n    recordId?: string | number;\n    route?: string;\n    [key: string]: unknown;\n};\n\nexport type AgentMode = \"bubble\" | \"compact\" | \"docked\" | \"maximized\";\n\n/**\n * Which agent backend a chat talks to: \"solidx\" (setting solidxAgentBackendUrl; the floating\n * launcher) or \"agentHub\" (setting solidxAgentHubBackendUrl).\n */\nexport type AgentRuntimeType = \"solidx\" | \"agentHub\";\nexport type AgentModelAssignment = { provider: string; model: string } | null;\nexport type AgentModelAssignments = { reasoning: AgentModelAssignment; fast: AgentModelAssignment };\n/** @deprecated Use AgentRuntimeType. */\nexport type AgentType = AgentRuntimeType;\n\nexport type AgentConnection = \"idle\" | \"connecting\" | \"open\" | \"reconnecting\" | \"offline\";\n\n/** A slash command advertised by the agent in `session_started`. */\nexport type AgentCommand = { name: string; description?: string };\n\n// ── Inbound ───────────────────────────────────────────────────────────────────\n\n/** A frame as it arrives on the socket or from session history (before normalisation). */\nexport type AgentWireFrame = {\n    event_type?: string;\n    event_data?: Record<string, any>;\n    type?: string;\n    data?: Record<string, any>;\n    session_id?: string;\n    history_session_id?: string;\n    [key: string]: any;\n};\n\n/** The normalised event every reducer and widget works with. */\nexport type AgentChatEvent = {\n    eventType: string;\n    eventData: Record<string, any>;\n    /** Top-level fields of the frame (session_id, history_session_id, commands, ...). */\n    frame: AgentWireFrame;\n};\n\n/** Event types the chat knows by name. Anything else is still rendered (via its widget or the fallback). */\nexport const AgentEventTypes = {\n    sessionStarted: \"session_started\",\n    sessionEnded: \"session_ended\",\n    userMessage: \"UserMessage\",\n    agentStarted: \"AgentStarted\",\n    stepStarted: \"StepStarted\",\n    stepComplete: \"StepComplete\",\n    llmToken: \"LlmToken\",\n    llmComplete: \"LlmComplete\",\n    toolCalling: \"ToolCalling\",\n    toolProgress: \"ToolProgress\",\n    toolResult: \"ToolResult\",\n    turnComplete: \"TurnCompleteEvent\",\n    turnCompleteLegacy: \"turn_complete\",\n    agentComplete: \"AgentComplete\",\n    executionCancelled: \"ExecutionCancelled\",\n    executionCancelledLegacy: \"execution_cancelled\",\n    agentError: \"AgentError\",\n    error: \"error\",\n} as const;\n\n// ── Outbound ──────────────────────────────────────────────────────────────────\n\nexport type WidgetReply = { widgetId: string; value: unknown };\n\n/** A file sent inline with a message: text files as text, images base64-encoded (no data: prefix). */\nexport type AgentAttachmentPayload = {\n    name: string;\n    mimeType: string;\n    size: number;\n    encoding: \"text\" | \"base64\";\n    content: string;\n};\n\n/** What the thread shows for an attachment (history only has name/type/size). */\nexport type AgentAttachmentMeta = {\n    mediaId?: number;\n    name: string;\n    mimeType: string;\n    size: number;\n    /** data: URL for image thumbnails of files attached in this browser session. */\n    previewUrl?: string;\n    /** Stored copy in Solid media storage (resolved when a conversation is reopened). */\n    url?: string;\n};\n\nexport type AgentAttachment = { payload: AgentAttachmentPayload; meta: AgentAttachmentMeta; file: File };\nexport type AgentUploadedAttachment = { id: number; name: string; mimeType: string; size: number };\n\nexport type AgentAction =\n    | { action: \"start_session\" }\n    | { action: \"resume_session\"; session_id: string }\n    | {\n          action: \"message\";\n          session_id: string;\n          content: string;\n          context?: AgentContext;\n          inputs?: Record<string, unknown>;\n          widget_reply?: WidgetReply | null;\n          attachments?: AgentAttachmentPayload[] | AgentUploadedAttachment[];\n      }\n    | { action: \"cancel\"; session_id: string }\n    | { action: \"end_session\"; session_id: string };\n\n// ── Thread items ──────────────────────────────────────────────────────────────\n\n/**\n * One rendered entry in the thread. `eventData` is the (accumulated) event payload handed to\n * the widget; `widget` is set when the agent named one, otherwise the default for `eventType`.\n */\nexport type AgentChatItem = {\n    id: string;\n    at: number;\n    eventType: string;\n    eventData: Record<string, any>;\n    widget?: string;\n    widgetId?: string;\n    /** Live items (a running tool, a streaming reply) are still updating. */\n    live?: boolean;\n    /** A final widget accepts no more updates or replies. */\n    final?: boolean;\n};\n\n/** Options for `solidAgent.open`. */\nexport type SolidAgentOpenOptions = {\n    prompt?: string;\n    autoSend?: boolean;\n    context?: AgentContext;\n    mode?: Exclude<AgentMode, \"bubble\">;\n};\n"]}

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

@@ -0,0 +1,148 @@
+/**
+ * Shared types for the SolidX Agent chat (launcher, window, thread).
+ *
+ * Wire format: every agent payload carries `event_type` and `event_data`. When
+ * `event_data.widget` names a registered chat widget, that widget renders the event;
+ * otherwise the event is rendered by the default widget for its `event_type`.
+ * (Legacy frames `{ type, data }` are normalised to the same shape.)
+ * The widget contract itself (SolidChatWidgetProps) lives in types/solid-core.d.ts.
+ */
+
+/** Page context passed with a prompt so the agent knows where the user is. */
+export type AgentContext = {
+    module?: string;
+    model?: string;
+    recordId?: string | number;
+    route?: string;
+    [key: string]: unknown;
+};
+
+export type AgentMode = "bubble" | "compact" | "docked" | "maximized";
+
+/**
+ * Which agent backend a chat talks to: "solidx" (setting solidxAgentBackendUrl; the floating
+ * launcher) or "agentHub" (setting solidxAgentHubBackendUrl).
+ */
+export type AgentRuntimeType = "solidx" | "agentHub";
+export type AgentModelAssignment = { provider: string; model: string } | null;
+export type AgentModelAssignments = { reasoning: AgentModelAssignment; fast: AgentModelAssignment };
+/** @deprecated Use AgentRuntimeType. */
+export type AgentType = AgentRuntimeType;
+
+export type AgentConnection = "idle" | "connecting" | "open" | "reconnecting" | "offline";
+
+/** A slash command advertised by the agent in `session_started`. */
+export type AgentCommand = { name: string; description?: string };
+
+// ── Inbound ───────────────────────────────────────────────────────────────────
+
+/** A frame as it arrives on the socket or from session history (before normalisation). */
+export type AgentWireFrame = {
+    event_type?: string;
+    event_data?: Record<string, any>;
+    type?: string;
+    data?: Record<string, any>;
+    session_id?: string;
+    history_session_id?: string;
+    [key: string]: any;
+};
+
+/** The normalised event every reducer and widget works with. */
+export type AgentChatEvent = {
+    eventType: string;
+    eventData: Record<string, any>;
+    /** Top-level fields of the frame (session_id, history_session_id, commands, ...). */
+    frame: AgentWireFrame;
+};
+
+/** Event types the chat knows by name. Anything else is still rendered (via its widget or the fallback). */
+export const AgentEventTypes = {
+    sessionStarted: "session_started",
+    sessionEnded: "session_ended",
+    userMessage: "UserMessage",
+    agentStarted: "AgentStarted",
+    stepStarted: "StepStarted",
+    stepComplete: "StepComplete",
+    llmToken: "LlmToken",
+    llmComplete: "LlmComplete",
+    toolCalling: "ToolCalling",
+    toolProgress: "ToolProgress",
+    toolResult: "ToolResult",
+    turnComplete: "TurnCompleteEvent",
+    turnCompleteLegacy: "turn_complete",
+    agentComplete: "AgentComplete",
+    executionCancelled: "ExecutionCancelled",
+    executionCancelledLegacy: "execution_cancelled",
+    agentError: "AgentError",
+    error: "error",
+} as const;
+
+// ── Outbound ──────────────────────────────────────────────────────────────────
+
+export type WidgetReply = { widgetId: string; value: unknown };
+
+/** A file sent inline with a message: text files as text, images base64-encoded (no data: prefix). */
+export type AgentAttachmentPayload = {
+    name: string;
+    mimeType: string;
+    size: number;
+    encoding: "text" | "base64";
+    content: string;
+};
+
+/** What the thread shows for an attachment (history only has name/type/size). */
+export type AgentAttachmentMeta = {
+    mediaId?: number;
+    name: string;
+    mimeType: string;
+    size: number;
+    /** data: URL for image thumbnails of files attached in this browser session. */
+    previewUrl?: string;
+    /** Stored copy in Solid media storage (resolved when a conversation is reopened). */
+    url?: string;
+};
+
+export type AgentAttachment = { payload: AgentAttachmentPayload; meta: AgentAttachmentMeta; file: File };
+export type AgentUploadedAttachment = { id: number; name: string; mimeType: string; size: number };
+
+export type AgentAction =
+    | { action: "start_session" }
+    | { action: "resume_session"; session_id: string }
+    | {
+          action: "message";
+          session_id: string;
+          content: string;
+          context?: AgentContext;
+          inputs?: Record<string, unknown>;
+          widget_reply?: WidgetReply | null;
+          attachments?: AgentAttachmentPayload[] | AgentUploadedAttachment[];
+      }
+    | { action: "cancel"; session_id: string }
+    | { action: "end_session"; session_id: string };
+
+// ── Thread items ──────────────────────────────────────────────────────────────
+
+/**
+ * One rendered entry in the thread. `eventData` is the (accumulated) event payload handed to
+ * the widget; `widget` is set when the agent named one, otherwise the default for `eventType`.
+ */
+export type AgentChatItem = {
+    id: string;
+    at: number;
+    eventType: string;
+    eventData: Record<string, any>;
+    widget?: string;
+    widgetId?: string;
+    /** Live items (a running tool, a streaming reply) are still updating. */
+    live?: boolean;
+    /** A final widget accepts no more updates or replies. */
+    final?: boolean;
+};
+
+/** Options for `solidAgent.open`. */
+export type SolidAgentOpenOptions = {
+    prompt?: string;
+    autoSend?: boolean;
+    context?: AgentContext;
+    mode?: Exclude<AgentMode, "bubble">;
+};

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

@@ -0,0 +1,4 @@
+export type AgentInputContext = Record<string, unknown>;
+/** Infer model-view context from Solid Core's admin route structure. */
+export declare function useAdminInputContext(): AgentInputContext;
+//# sourceMappingURL=useAdminInputContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminInputContext.d.ts","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/useAdminInputContext.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,wEAAwE;AACxE,wBAAgB,oBAAoB,IAAI,iBAAiB,CA4CxD"}

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

@@ -0,0 +1,49 @@
+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);
+};
+import { useMemo } from "react";
+import { camelCase } from "lodash";
+import { useLocation } from "react-router-dom";
+/** Infer model-view context from Solid Core's admin route structure. */
+export function useAdminInputContext() {
+    var pathname = useLocation().pathname;
+    return useMemo(function () {
+        var segments = pathname.split("/").filter(Boolean).map(function (segment) {
+            try {
+                return decodeURIComponent(segment);
+            }
+            catch (_a) {
+                return segment;
+            }
+        });
+        var adminCoreIndex = segments.findIndex(function (segment, index) { return segment === "admin" && segments[index + 1] === "core"; });
+        if (adminCoreIndex < 0)
+            return {};
+        var moduleName = segments[adminCoreIndex + 2];
+        var modelSegment = segments[adminCoreIndex + 3];
+        var viewName = segments[adminCoreIndex + 4];
+        if (!moduleName || !modelSegment || !viewName)
+            return {};
+        if (["list", "card", "kanban", "tree"].includes(viewName)) {
+            return { viewName: viewName, moduleName: moduleName, modelName: camelCase(modelSegment) };
+        }
+        if (viewName === "form") {
+            var modelId_1 = segments[adminCoreIndex + 5];
+            return __assign({ viewName: viewName, moduleName: moduleName, modelName: camelCase(modelSegment) }, (modelId_1 && modelId_1 !== "new" ? { modelId: modelId_1 } : {}));
+        }
+        // Custom admin pages (for example, /<model>/editor/:id) still carry
+        // the module and model in the standard route positions. Treat their
+        // route as a custom view and pass along an optional record identifier.
+        var modelId = segments[adminCoreIndex + 5];
+        return __assign({ viewName: "custom", moduleName: moduleName, modelName: camelCase(modelSegment) }, (modelId && modelId !== "new" ? { modelId: modelId } : {}));
+    }, [pathname]);
+}
+//# sourceMappingURL=useAdminInputContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdminInputContext.js","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/useAdminInputContext.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,wEAAwE;AACxE,MAAM,UAAU,oBAAoB;IACxB,IAAA,QAAQ,GAAK,WAAW,EAAE,SAAlB,CAAmB;IAEnC,OAAO,OAAO,CAAC;QACX,IAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAC,OAAO;YAC7D,IAAI;gBACA,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;aACtC;YAAC,WAAM;gBACJ,OAAO,OAAO,CAAC;aAClB;QACL,CAAC,CAAC,CAAC;QACH,IAAM,cAAc,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAC,OAAO,EAAE,KAAK,IAAK,OAAA,OAAO,KAAK,OAAO,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,MAAM,EAArD,CAAqD,CAAC,CAAC;QACrH,IAAI,cAAc,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,IAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;QAChD,IAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;QAClD,IAAM,QAAQ,GAAG,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;YACvD,OAAO,EAAE,QAAQ,UAAA,EAAE,UAAU,YAAA,EAAE,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;SACvE;QAED,IAAI,QAAQ,KAAK,MAAM,EAAE;YACrB,IAAM,SAAO,GAAG,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;YAC7C,kBACI,QAAQ,UAAA,EACR,UAAU,YAAA,EACV,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,IAC/B,CAAC,SAAO,IAAI,SAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,WAAA,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACtD;SACL;QAED,oEAAoE;QACpE,oEAAoE;QACpE,uEAAuE;QACvE,IAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;QAC7C,kBACI,QAAQ,EAAE,QAAQ,EAClB,UAAU,YAAA,EACV,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,IAC/B,CAAC,OAAO,IAAI,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,SAAA,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACtD;IACN,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnB,CAAC","sourcesContent":["import { useMemo } from \"react\";\nimport { camelCase } from \"lodash\";\nimport { useLocation } from \"react-router-dom\";\n\nexport type AgentInputContext = Record<string, unknown>;\n\n/** Infer model-view context from Solid Core's admin route structure. */\nexport function useAdminInputContext(): AgentInputContext {\n    const { pathname } = useLocation();\n\n    return useMemo(() => {\n        const segments = pathname.split(\"/\").filter(Boolean).map((segment) => {\n            try {\n                return decodeURIComponent(segment);\n            } catch {\n                return segment;\n            }\n        });\n        const adminCoreIndex = segments.findIndex((segment, index) => segment === \"admin\" && segments[index + 1] === \"core\");\n        if (adminCoreIndex < 0) return {};\n\n        const moduleName = segments[adminCoreIndex + 2];\n        const modelSegment = segments[adminCoreIndex + 3];\n        const viewName = segments[adminCoreIndex + 4];\n        if (!moduleName || !modelSegment || !viewName) return {};\n\n        if ([\"list\", \"card\", \"kanban\", \"tree\"].includes(viewName)) {\n            return { viewName, moduleName, modelName: camelCase(modelSegment) };\n        }\n\n        if (viewName === \"form\") {\n            const modelId = segments[adminCoreIndex + 5];\n            return {\n                viewName,\n                moduleName,\n                modelName: camelCase(modelSegment),\n                ...(modelId && modelId !== \"new\" ? { modelId } : {}),\n            };\n        }\n\n        // Custom admin pages (for example, /<model>/editor/:id) still carry\n        // the module and model in the standard route positions. Treat their\n        // route as a custom view and pass along an optional record identifier.\n        const modelId = segments[adminCoreIndex + 5];\n        return {\n            viewName: \"custom\",\n            moduleName,\n            modelName: camelCase(modelSegment),\n            ...(modelId && modelId !== \"new\" ? { modelId } : {}),\n        };\n    }, [pathname]);\n}\n"]}

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

@@ -0,0 +1,52 @@
+import { useMemo } from "react";
+import { camelCase } from "lodash";
+import { useLocation } from "react-router-dom";
+
+export type AgentInputContext = Record<string, unknown>;
+
+/** Infer model-view context from Solid Core's admin route structure. */
+export function useAdminInputContext(): AgentInputContext {
+    const { pathname } = useLocation();
+
+    return useMemo(() => {
+        const segments = pathname.split("/").filter(Boolean).map((segment) => {
+            try {
+                return decodeURIComponent(segment);
+            } catch {
+                return segment;
+            }
+        });
+        const adminCoreIndex = segments.findIndex((segment, index) => segment === "admin" && segments[index + 1] === "core");
+        if (adminCoreIndex < 0) return {};
+
+        const moduleName = segments[adminCoreIndex + 2];
+        const modelSegment = segments[adminCoreIndex + 3];
+        const viewName = segments[adminCoreIndex + 4];
+        if (!moduleName || !modelSegment || !viewName) return {};
+
+        if (["list", "card", "kanban", "tree"].includes(viewName)) {
+            return { viewName, moduleName, modelName: camelCase(modelSegment) };
+        }
+
+        if (viewName === "form") {
+            const modelId = segments[adminCoreIndex + 5];
+            return {
+                viewName,
+                moduleName,
+                modelName: camelCase(modelSegment),
+                ...(modelId && modelId !== "new" ? { modelId } : {}),
+            };
+        }
+
+        // Custom admin pages (for example, /<model>/editor/:id) still carry
+        // the module and model in the standard route positions. Treat their
+        // route as a custom view and pass along an optional record identifier.
+        const modelId = segments[adminCoreIndex + 5];
+        return {
+            viewName: "custom",
+            moduleName,
+            modelName: camelCase(modelSegment),
+            ...(modelId && modelId !== "new" ? { modelId } : {}),
+        };
+    }, [pathname]);
+}

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

@@ -0,0 +1,14 @@
+import { type AgentAuth } from "./client/agentAuth";
+export type AgentAuthState = {
+    status: "checking";
+    auth: null;
+} | {
+    status: "signedOut";
+    auth: null;
+} | {
+    status: "signedIn";
+    auth: AgentAuth;
+};
+/** The agent login for `agentUrl` in this tab, kept current as the user signs in or the token expires. */
+export declare function useAgentAuth(agentUrl: string, checkProcessAvailability?: boolean): AgentAuthState;
+//# sourceMappingURL=useAgentAuth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentAuth.d.ts","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/useAgentAuth.ts"],"names":[],"mappings":"AACA,OAAO,EAA6E,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/H,MAAM,MAAM,cAAc,GACpB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAE9C,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,wBAAwB,UAAQ,GAAG,cAAc,CA8B/F"}

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

@@ -0,0 +1,88 @@
+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 { useEffect, useState } from "react";
+import { clearAgentAuth, isAgentProcessAvailable, loadAgentAuth, onAgentAuthChange } from "./client/agentAuth";
+/** The agent login for `agentUrl` in this tab, kept current as the user signs in or the token expires. */
+export function useAgentAuth(agentUrl, checkProcessAvailability) {
+    var _this = this;
+    if (checkProcessAvailability === void 0) { checkProcessAvailability = false; }
+    var _a = useState({ status: "checking", auth: null }), state = _a[0], setState = _a[1];
+    useEffect(function () {
+        var alive = true;
+        var refresh = function () {
+            void loadAgentAuth(agentUrl).then(function (auth) { return __awaiter(_this, void 0, void 0, function () {
+                var _a;
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            if (!auth) {
+                                if (alive)
+                                    setState({ status: "signedOut", auth: null });
+                                return [2 /*return*/];
+                            }
+                            _a = checkProcessAvailability;
+                            if (!_a) return [3 /*break*/, 2];
+                            return [4 /*yield*/, isAgentProcessAvailable(auth)];
+                        case 1:
+                            _a = !(_b.sent());
+                            _b.label = 2;
+                        case 2:
+                            if (_a) {
+                                // The stored wsUrl points at a dead process. Signing in again asks the manager
+                                // for a live process and its current WebSocket URL.
+                                clearAgentAuth(agentUrl);
+                                if (alive)
+                                    setState({ status: "signedOut", auth: null });
+                                return [2 /*return*/];
+                            }
+                            if (alive)
+                                setState({ status: "signedIn", auth: auth });
+                            return [2 /*return*/];
+                    }
+                });
+            }); });
+        };
+        refresh();
+        var off = onAgentAuthChange(agentUrl, refresh);
+        return function () {
+            alive = false;
+            off();
+        };
+    }, [agentUrl, checkProcessAvailability]);
+    return state;
+}
+//# sourceMappingURL=useAgentAuth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentAuth.js","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/useAgentAuth.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,aAAa,EAAE,iBAAiB,EAAkB,MAAM,oBAAoB,CAAC;AAO/H,0GAA0G;AAC1G,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,wBAAgC;IAA/E,iBA8BC;IA9B8C,yCAAA,EAAA,gCAAgC;IACrE,IAAA,KAAoB,QAAQ,CAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAA/E,KAAK,QAAA,EAAE,QAAQ,QAAgE,CAAC;IAEvF,SAAS,CAAC;QACN,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,IAAM,OAAO,GAAG;YACZ,KAAK,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAO,IAAI;;;;;4BACzC,IAAI,CAAC,IAAI,EAAE;gCACP,IAAI,KAAK;oCAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gCACzD,sBAAO;6BACV;4BACG,KAAA,wBAAwB,CAAA;qCAAxB,wBAAwB;4BAAM,qBAAM,uBAAuB,CAAC,IAAI,CAAC,EAAA;;4BAArC,KAAA,CAAC,CAAC,SAAmC,CAAC,CAAA;;;4BAAtE,QAAwE;gCACpE,+EAA+E;gCAC/E,oDAAoD;gCACpD,cAAc,CAAC,QAAQ,CAAC,CAAC;gCACzB,IAAI,KAAK;oCAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gCACzD,sBAAO;6BACV;4BACD,IAAI,KAAK;gCAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,MAAA,EAAE,CAAC,CAAC;;;;iBACrD,CAAC,CAAC;QACP,CAAC,CAAC;QACF,OAAO,EAAE,CAAC;QACV,IAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO;YACH,KAAK,GAAG,KAAK,CAAC;YACd,GAAG,EAAE,CAAC;QACV,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAEzC,OAAO,KAAK,CAAC;AACjB,CAAC","sourcesContent":["import { useEffect, useState } from \"react\";\nimport { clearAgentAuth, isAgentProcessAvailable, loadAgentAuth, onAgentAuthChange, type AgentAuth } from \"./client/agentAuth\";\n\nexport type AgentAuthState =\n    | { status: \"checking\"; auth: null }\n    | { status: \"signedOut\"; auth: null }\n    | { status: \"signedIn\"; auth: AgentAuth };\n\n/** The agent login for `agentUrl` in this tab, kept current as the user signs in or the token expires. */\nexport function useAgentAuth(agentUrl: string, checkProcessAvailability = false): AgentAuthState {\n    const [state, setState] = useState<AgentAuthState>({ status: \"checking\", auth: null });\n\n    useEffect(() => {\n        let alive = true;\n        const refresh = () => {\n            void loadAgentAuth(agentUrl).then(async (auth) => {\n                if (!auth) {\n                    if (alive) setState({ status: \"signedOut\", auth: null });\n                    return;\n                }\n                if (checkProcessAvailability && !(await isAgentProcessAvailable(auth))) {\n                    // The stored wsUrl points at a dead process. Signing in again asks the manager\n                    // for a live process and its current WebSocket URL.\n                    clearAgentAuth(agentUrl);\n                    if (alive) setState({ status: \"signedOut\", auth: null });\n                    return;\n                }\n                if (alive) setState({ status: \"signedIn\", auth });\n            });\n        };\n        refresh();\n        const off = onAgentAuthChange(agentUrl, refresh);\n        return () => {\n            alive = false;\n            off();\n        };\n    }, [agentUrl, checkProcessAvailability]);\n\n    return state;\n}\n"]}

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

@@ -0,0 +1,40 @@
+import { useEffect, useState } from "react";
+import { clearAgentAuth, isAgentProcessAvailable, loadAgentAuth, onAgentAuthChange, type AgentAuth } from "./client/agentAuth";
+
+export type AgentAuthState =
+    | { status: "checking"; auth: null }
+    | { status: "signedOut"; auth: null }
+    | { status: "signedIn"; auth: AgentAuth };
+
+/** The agent login for `agentUrl` in this tab, kept current as the user signs in or the token expires. */
+export function useAgentAuth(agentUrl: string, checkProcessAvailability = false): AgentAuthState {
+    const [state, setState] = useState<AgentAuthState>({ status: "checking", auth: null });
+
+    useEffect(() => {
+        let alive = true;
+        const refresh = () => {
+            void loadAgentAuth(agentUrl).then(async (auth) => {
+                if (!auth) {
+                    if (alive) setState({ status: "signedOut", auth: null });
+                    return;
+                }
+                if (checkProcessAvailability && !(await isAgentProcessAvailable(auth))) {
+                    // The stored wsUrl points at a dead process. Signing in again asks the manager
+                    // for a live process and its current WebSocket URL.
+                    clearAgentAuth(agentUrl);
+                    if (alive) setState({ status: "signedOut", auth: null });
+                    return;
+                }
+                if (alive) setState({ status: "signedIn", auth });
+            });
+        };
+        refresh();
+        const off = onAgentAuthChange(agentUrl, refresh);
+        return () => {
+            alive = false;
+            off();
+        };
+    }, [agentUrl, checkProcessAvailability]);
+
+    return state;
+}