@ai-matrx/chat 0.3.11 → 0.3.19

package/dist/agents/components/widgets/build-widget-launch.d.ts

@@ -1,70 +0,0 @@
-/**
- * build-widget-launch — the ONE extractor that turns the widget tester's
- * on-screen form into launch options.
- *
- * `AgentWidgetsPage` is a pure local-state harness: "the on-screen state is
- * exactly what ships to `launchAgent`". That promise only holds if there is a
- * single builder, so both consumers read it here:
- *
- *   - clicking a display mode → the options actually launched
- *   - Copy / Copy-for-AI      → the SAME options, so the payload is what the
- *                               user sees, never a parallel re-derivation
- *
- * Pure: no React, no side effects. JSON parse failures come back as the exact
- * `error` string the tester renders in its red banner, so the copy payload can
- * carry the blocker verbatim instead of silently omitting it.
- */
-import type { ApiEndpointMode, ManagedAgentOptions, ResultDisplayMode } from "../../types/instance.types.js";
-import type { VariablesPanelStyle } from "../inputs/variable-input-variations/variable-input-options.js";
-/** Every piece of live tester state the launch options are built from. */
-export interface WidgetLaunchState {
-    variableValues: Record<string, unknown>;
-    userInput: string;
-    autoRun: boolean;
-    showVariablePanel: boolean;
-    variablesPanelStyle: VariablesPanelStyle;
-    showPreExecutionGate: boolean;
-    preExecutionMessage: string;
-    showDefinitionMessages: boolean;
-    showDefinitionMessageContent: boolean;
-    allowChat: boolean;
-    hideReasoning: boolean;
-    hideToolResults: boolean;
-    includeEditorContext: boolean;
-    editorSelection: string;
-    editorTextBefore: string;
-    editorTextAfter: string;
-    editorContent: string;
-    editorContext: string;
-    apiEndpointMode: ApiEndpointMode;
-    showAutoClearToggle: boolean;
-    autoClearConversation: boolean;
-    jsonExtractionEnabled: boolean;
-    jsonExtractionFuzzy: boolean;
-    jsonExtractionMaxResults: string;
-    overridesJson: string;
-    applicationScopeJson: string;
-}
-/**
- * Launch options minus the two values assigned at click time: `surfaceKey`
- * (minted per launch) and `config.displayMode` (the mode the user clicks).
- * Everything else is fully determined by what is on screen — which is exactly
- * what makes this copyable before any mode is chosen.
- */
-export type WidgetLaunchDraft = Omit<ManagedAgentOptions, "surfaceKey" | "config"> & {
-    config: Omit<NonNullable<ManagedAgentOptions["config"]>, "displayMode">;
-};
-export type WidgetLaunchBuild = {
-    ok: true;
-    draft: WidgetLaunchDraft;
-} | {
-    ok: false;
-    error: string;
-};
-/** Build the launch draft from live state, or the blocking error verbatim. */
-export declare function buildWidgetLaunchDraft(state: WidgetLaunchState): WidgetLaunchBuild;
-/** Seal a draft into the options `launchAgent` is called with. */
-export declare function sealWidgetLaunchOptions(draft: WidgetLaunchDraft, args: {
-    surfaceKey: string;
-    displayMode: ResultDisplayMode;
-}): ManagedAgentOptions;

package/dist/agents/components/widgets/build-widget-launch.js

@@ -1,90 +0,0 @@
-function buildWidgetLaunchDraft(state) {
-  let overrides;
-  if (state.overridesJson.trim()) {
-    try {
-      const parsed = JSON.parse(state.overridesJson);
-      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-        return { ok: false, error: "Overrides must be a JSON object" };
-      }
-      overrides = parsed;
-    } catch (e) {
-      return {
-        ok: false,
-        error: `Overrides JSON: ${e instanceof Error ? e.message : "invalid"}`
-      };
-    }
-  }
-  const scope = {};
-  if (state.includeEditorContext) {
-    if (state.editorSelection) scope.selection = state.editorSelection;
-    if (state.editorTextBefore) scope.text_before = state.editorTextBefore;
-    if (state.editorTextAfter) scope.text_after = state.editorTextAfter;
-    if (state.editorContent) scope.content = state.editorContent;
-    if (state.editorContext) scope.context = state.editorContext;
-  }
-  if (state.applicationScopeJson.trim()) {
-    try {
-      const parsed = JSON.parse(state.applicationScopeJson);
-      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-        return { ok: false, error: "Application scope must be a JSON object" };
-      }
-      Object.assign(scope, parsed);
-    } catch (e) {
-      return {
-        ok: false,
-        error: `Scope JSON: ${e instanceof Error ? e.message : "invalid"}`
-      };
-    }
-  }
-  const applicationScope = Object.keys(scope).length > 0 ? scope : void 0;
-  const maxResults = state.jsonExtractionMaxResults.trim() ? Number(state.jsonExtractionMaxResults) : NaN;
-  const jsonExtraction = state.jsonExtractionEnabled ? {
-    enabled: true,
-    ...state.jsonExtractionFuzzy ? { fuzzyOnFinalize: true } : {},
-    ...Number.isFinite(maxResults) ? { maxResults } : {}
-  } : void 0;
-  return {
-    ok: true,
-    draft: {
-      sourceFeature: "agents-other",
-      apiEndpointMode: state.apiEndpointMode,
-      autoClearConversation: state.autoClearConversation,
-      showAutoClearToggle: state.showAutoClearToggle,
-      ...jsonExtraction ? { jsonExtraction } : {},
-      config: {
-        autoRun: state.autoRun,
-        allowChat: state.allowChat,
-        showPreExecutionGate: state.showPreExecutionGate,
-        variablesPanelStyle: state.variablesPanelStyle,
-        showVariablePanel: state.showVariablePanel,
-        showDefinitionMessages: state.showDefinitionMessages,
-        showDefinitionMessageContent: state.showDefinitionMessageContent,
-        hideReasoning: state.hideReasoning,
-        hideToolResults: state.hideToolResults,
-        defaultVariables: state.variableValues,
-        ...state.preExecutionMessage ? { preExecutionMessage: state.preExecutionMessage } : {},
-        ...overrides ? { llmOverrides: overrides } : {}
-      },
-      runtime: {
-        // The widget lab is testing the selected agent itself. Only the
-        // explicit sample/application scope below belongs in the run; never
-        // auto-adopt the surrounding agent administration page.
-        surfaceName: null,
-        ...state.userInput ? { userInput: state.userInput } : {},
-        ...state.includeEditorContext && state.editorSelection ? { originalText: state.editorSelection } : {},
-        ...applicationScope ? { applicationScope } : {}
-      }
-    }
-  };
-}
-function sealWidgetLaunchOptions(draft, args) {
-  return {
-    ...draft,
-    surfaceKey: args.surfaceKey,
-    config: { ...draft.config, displayMode: args.displayMode }
-  };
-}
-export {
-  buildWidgetLaunchDraft,
-  sealWidgetLaunchOptions
-};

package/dist/agents/hooks/useAgentAutoSave.d.ts

@@ -1 +0,0 @@
-export declare function useAgentAutoSave(agentId: string): void;

package/dist/agents/hooks/useAgentAutoSave.js

@@ -1,127 +0,0 @@
-"use client";
-import { useEffect, useRef } from "react";
-import { useAppSelector, useAppDispatch } from "../../store/hooks.js";
-import isEqual from "lodash/isEqual";
-import {
-  selectAgentById,
-  selectAgentFetchStatus,
-  selectAgentIsReadOnly,
-  selectAgentAccessResolved
-} from "../redux/agent-definition/selectors.js";
-import {
-  resetAllAgentFields,
-  setAgentField
-} from "../redux/agent-definition/slice.js";
-import { readField } from "@ai-matrx/agents/field-flags";
-import { toast } from "../../host/notify.js";
-const STORAGE_PREFIX = "agent-autosave:";
-const DEBOUNCE_MS = 2e3;
-function useAgentAutoSave(agentId) {
-  const dispatch = useAppDispatch();
-  const record = useAppSelector((state) => selectAgentById(state, agentId));
-  const accessResolved = useAppSelector(
-    (state) => selectAgentAccessResolved(state, agentId)
-  );
-  const isReadOnly = useAppSelector(
-    (state) => selectAgentIsReadOnly(state, agentId)
-  );
-  const fetchStatus = useAppSelector(
-    (state) => selectAgentFetchStatus(state, agentId)
-  );
-  const timerRef = useRef(null);
-  const pendingRecoveryRef = useRef(null);
-  const restoredRef = useRef(false);
-  const skipPersistence = accessResolved && isReadOnly;
-  useEffect(() => {
-    pendingRecoveryRef.current = null;
-    restoredRef.current = false;
-    const storageKey = `${STORAGE_PREFIX}${agentId}`;
-    try {
-      const raw = localStorage.getItem(storageKey);
-      if (raw) {
-        const saved = JSON.parse(raw);
-        if (saved?._dirty) {
-          const { _dirty: _unused, ...fields } = saved;
-          pendingRecoveryRef.current = fields;
-        }
-      }
-    } catch {
-    }
-  }, [agentId]);
-  useEffect(() => {
-    const fields = pendingRecoveryRef.current;
-    if (!fields || !record || fetchStatus !== "full") return;
-    pendingRecoveryRef.current = null;
-    const restored = [];
-    for (const [field, value] of Object.entries(fields)) {
-      const key = field;
-      if (isEqual(readField(record, key), value)) continue;
-      dispatch(
-        setAgentField({
-          id: agentId,
-          field: key,
-          value
-        })
-      );
-      restored.push(field);
-    }
-    if (restored.length > 0) {
-      restoredRef.current = true;
-      toast.info(
-        `Restored unsaved changes to ${record.name || "this agent"} from this browser (${restored.join(", ")}). Save to keep them, or discard them.`,
-        {
-          id: `agent-autosave-restored:${agentId}`,
-          duration: 2e4,
-          action: {
-            label: "Discard",
-            // Back to the saved agent; the clean-state effect drops the backup.
-            onClick: () => dispatch(resetAllAgentFields({ id: agentId }))
-          }
-        }
-      );
-    }
-  }, [agentId, record, fetchStatus, dispatch]);
-  useEffect(() => {
-    if (record?._dirty) restoredRef.current = false;
-    if (skipPersistence || !record?._dirty) return void 0;
-    if (timerRef.current) clearTimeout(timerRef.current);
-    timerRef.current = setTimeout(() => {
-      const storageKey = `${STORAGE_PREFIX}${agentId}`;
-      try {
-        const snapshot = { _dirty: true };
-        if (record._dirtyFields) {
-          const fields = new Set(
-            Object.keys(record._dirtyFields)
-          );
-          if (fields.has("modelId") || fields.has("settings")) {
-            fields.add("modelId");
-            fields.add("settings");
-          }
-          for (const field of fields) {
-            snapshot[field] = readField(record, field);
-          }
-        }
-        localStorage.setItem(storageKey, JSON.stringify(snapshot));
-      } catch {
-      }
-    }, DEBOUNCE_MS);
-    return () => {
-      if (timerRef.current) clearTimeout(timerRef.current);
-    };
-  }, [agentId, record, skipPersistence]);
-  useEffect(() => {
-    if (record?._dirty !== false) return;
-    if (pendingRecoveryRef.current || restoredRef.current) {
-      restoredRef.current = false;
-      return;
-    }
-    const storageKey = `${STORAGE_PREFIX}${agentId}`;
-    try {
-      localStorage.removeItem(storageKey);
-    } catch {
-    }
-  }, [agentId, record?._dirty]);
-}
-export {
-  useAgentAutoSave
-};

package/dist/agents/hooks/useAgentBuilderWriteHandlers.d.ts

@@ -1,9 +0,0 @@
-/**
- * Returns the `getWriteHandlers` callback for the agent-builder surface.
- *
- * Reads through the store rather than `useAppSelector` for the same reason
- * `useAgentBuilderSurfaceScope` does: the builder must not re-render on every
- * keystroke of the agent it is editing, and a handler invoked at apply time
- * needs the state as it is THEN, not as it was at the last render.
- */
-export declare function useAgentBuilderWriteHandlers(agentId: string): () => Record<string, (value: unknown) => void>;

package/dist/agents/hooks/useAgentBuilderWriteHandlers.js

@@ -1,102 +0,0 @@
-"use client";
-import { useCallback } from "react";
-import { useAppDispatch, useAppStore } from "../../store/hooks.js";
-import {
-  selectAgentAccessResolved,
-  selectAgentById,
-  selectAgentIsReadOnly,
-  selectAgentMessages
-} from "../redux/agent-definition/selectors.js";
-import {
-  setAgentField,
-  setAgentMessages
-} from "../redux/agent-definition/slice.js";
-import { withAgentSystemInstruction } from "../utils/agent-system-instruction.js";
-function requireText(value, target) {
-  if (typeof value !== "string") {
-    throw new Error(`${target} expects a string value.`);
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
-    throw new Error(`${target} expects a non-empty string.`);
-  }
-  return trimmed;
-}
-function requireEditableAgent(state, agentId) {
-  const record = selectAgentById(state, agentId);
-  if (!record) {
-    throw new Error(
-      "The agent being edited has not finished loading \u2014 try again in a moment."
-    );
-  }
-  if (record.isVersion) {
-    throw new Error(
-      "This is a published version snapshot, which is read-only. Open the live agent to change it."
-    );
-  }
-  if (selectAgentAccessResolved(state, agentId) && selectAgentIsReadOnly(state, agentId)) {
-    throw new Error(
-      "This agent is shared with you as view-only, so changes cannot be saved here."
-    );
-  }
-  return record;
-}
-function useAgentBuilderWriteHandlers(agentId) {
-  const store = useAppStore();
-  const dispatch = useAppDispatch();
-  return useCallback(() => {
-    const patchField = (field, value) => {
-      requireEditableAgent(store.getState(), agentId);
-      dispatch(setAgentField({ id: agentId, field, value }));
-    };
-    const setSystemInstruction = (text) => {
-      const state = store.getState();
-      requireEditableAgent(state, agentId);
-      const messages = selectAgentMessages(state, agentId);
-      if (!messages) {
-        throw new Error(
-          "The agent's messages have not finished loading \u2014 try again in a moment."
-        );
-      }
-      dispatch(
-        setAgentMessages({
-          id: agentId,
-          messages: withAgentSystemInstruction(messages, text)
-        })
-      );
-    };
-    return {
-      system_instruction: (value) => {
-        setSystemInstruction(requireText(value, "system_instruction"));
-      },
-      agent_description: (value) => {
-        patchField("description", requireText(value, "agent_description"));
-      },
-      agent_name: (value) => {
-        patchField("name", requireText(value, "agent_name"));
-      },
-      agent_category: (value) => {
-        patchField("category", requireText(value, "agent_category"));
-      },
-      agent_tags: (value) => {
-        if (!Array.isArray(value)) {
-          throw new Error(
-            "agent_tags expects an array of tag strings (pass [] to clear all tags)."
-          );
-        }
-        const tags = value.map((entry, index) => {
-          if (typeof entry !== "string" || !entry.trim()) {
-            throw new Error(
-              `agent_tags[${index}] must be a non-empty string; got ${JSON.stringify(entry)}.`
-            );
-          }
-          return entry.trim();
-        });
-        patchField("tags", tags);
-      }
-    };
-  }, [store, dispatch, agentId]);
-}
-export {
-  useAgentBuilderWriteHandlers
-};

package/dist/agents/hooks/useAgentDuplicateFlow.d.ts

@@ -1,25 +0,0 @@
-interface UseAgentDuplicateFlowOptions {
-    basePath?: string;
-    /** Sub-route the copy opens on when the source is not the current page. */
-    fallbackSuffix?: string;
-}
-export interface StartDuplicateOptions {
-    /** Copy this saved version (definition_version id). Omitted = the current agent. */
-    versionId?: string;
-}
-/**
- * Shared duplicate flow for agent surfaces (options menu, versions tab,
- * read-only builder save, floating "create my copy" chip). Returns triggers +
- * the one dialog element:
- *   - `startDuplicate()` copies right away (current agent, or `{ versionId }`).
- *   - `openChooser()` first asks which version to copy, defaulting to current.
- */
-export declare function useAgentDuplicateFlow(agentId: string, options?: UseAgentDuplicateFlowOptions): {
-    readonly startDuplicate: (opts?: StartDuplicateOptions) => Promise<void>;
-    readonly openChooser: () => Promise<void>;
-    readonly dialog: import("react").JSX.Element;
-    readonly isDuplicating: boolean;
-    /** False in a host that registered no builder door: nothing offers a duplicate (reported once). */
-    readonly available: boolean;
-};
-export {};

package/dist/agents/hooks/useAgentDuplicateFlow.js

@@ -1,133 +0,0 @@
-"use client";
-import { jsx } from "react/jsx-runtime";
-import { useCallback, useState } from "react";
-import { usePathname } from "../../host/navigation.js";
-import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
-import { selectAgentById } from "../redux/agent-definition/selectors.js";
-import { getBuilderDoor, requireBuilderDoor } from "../../host/builder-door.js";
-import { supabase } from "../../host/db.js";
-import {
-  AgentDuplicateOutcomeDialog,
-  CURRENT_VERSION_CHOICE
-} from "../components/shared/AgentDuplicateOutcomeDialog.js";
-import { isAdminSystemAgentsContext } from "../components/shared/agent-route-context.js";
-import { getUserMessage } from "@ai-matrx/agents/matrx";
-import { isOrganizationSelectionCancelled } from "../../host/org.js";
-function useAgentDuplicateFlow(agentId, options) {
-  const dispatch = useAppDispatch();
-  const pathname = usePathname();
-  const basePath = options?.basePath ?? "/agents";
-  const fallbackSuffix = options?.fallbackSuffix ?? "/build";
-  const agent = useAppSelector((state2) => selectAgentById(state2, agentId));
-  const [open, setOpen] = useState(false);
-  const [state, setState] = useState("loading");
-  const [newAgentId, setNewAgentId] = useState(null);
-  const [errorMessage, setErrorMessage] = useState("");
-  const [asSystem, setAsSystem] = useState(false);
-  const [versions, setVersions] = useState([]);
-  const [versionsLoading, setVersionsLoading] = useState(false);
-  const [versionsError, setVersionsError] = useState(null);
-  const [selected, setSelected] = useState(CURRENT_VERSION_CHOICE);
-  const newAgent = useAppSelector(
-    (s) => newAgentId ? selectAgentById(s, newAgentId) : void 0
-  );
-  const isAdminContext = isAdminSystemAgentsContext(basePath);
-  const isBuiltin = agent?.agentType === "builtin";
-  const newAgentPath = newAgentId ? (() => {
-    const sourceSegment = `${basePath}/${agentId}`;
-    const here = pathname && pathname.startsWith(sourceSegment) ? pathname.slice(sourceSegment.length) : fallbackSuffix;
-    const suffix = /^\/v(\/|$)/.test(here) ? fallbackSuffix : here;
-    return `${basePath}/${newAgentId}${suffix || fallbackSuffix}`;
-  })() : null;
-  const startDuplicate = useCallback(
-    async (opts) => {
-      const duplicateAsSystem = isAdminContext && isBuiltin;
-      setAsSystem(duplicateAsSystem);
-      setNewAgentId(null);
-      setErrorMessage("");
-      setState("loading");
-      setOpen(true);
-      try {
-        const id = await dispatch(
-          requireBuilderDoor().duplicateAgent({
-            agentId,
-            asSystem: duplicateAsSystem,
-            versionId: opts?.versionId
-          })
-        ).unwrap();
-        setNewAgentId(id);
-        setState("success");
-      } catch (err) {
-        if (isOrganizationSelectionCancelled(err)) {
-          setOpen(false);
-          return;
-        }
-        setErrorMessage(getUserMessage(err));
-        setState("error");
-      }
-    },
-    [agentId, dispatch, isAdminContext, isBuiltin]
-  );
-  const openChooser = useCallback(async () => {
-    setSelected(CURRENT_VERSION_CHOICE);
-    setNewAgentId(null);
-    setErrorMessage("");
-    setState("choose");
-    setOpen(true);
-    setVersionsLoading(true);
-    setVersionsError(null);
-    const { data, error } = await supabase.rpc("agx_get_version_history", {
-      p_agent_id: agentId,
-      p_limit: 500,
-      p_offset: 0
-    });
-    setVersionsLoading(false);
-    if (error) {
-      setVersions([]);
-      setVersionsError(error.message);
-      return;
-    }
-    setVersions(
-      (data ?? []).map((row) => ({
-        versionId: row.version_id,
-        versionNumber: row.version_number,
-        changedAt: row.changed_at,
-        changeNote: row.change_note ?? null
-      }))
-    );
-  }, [agentId]);
-  const dialog = /* @__PURE__ */ jsx(
-    AgentDuplicateOutcomeDialog,
-    {
-      open,
-      onOpenChange: setOpen,
-      state,
-      newAgentName: newAgent?.name ?? "",
-      newAgentPath,
-      errorMessage,
-      asSystem,
-      chooser: {
-        currentVersion: agent?.version ?? null,
-        versions,
-        versionsLoading,
-        versionsError,
-        selected,
-        onSelectedChange: setSelected,
-        onConfirm: () => void startDuplicate(
-          selected === CURRENT_VERSION_CHOICE ? void 0 : { versionId: selected }
-        )
-      }
-    }
-  );
-  return {
-    startDuplicate,
-    openChooser,
-    dialog,
-    isDuplicating: open && state === "loading",
-    /** False in a host that registered no builder door: nothing offers a duplicate (reported once). */
-    available: getBuilderDoor() !== null
-  };
-}
-export {
-  useAgentDuplicateFlow
-};

package/dist/agents/hooks/useAgentUndoRedo.d.ts

@@ -1,31 +0,0 @@
-export type Platform = "mac" | "windows" | "ios" | "android" | "linux" | "unknown";
-export declare function getPlatform(): Platform;
-export declare function isMacLike(): boolean;
-export declare function isTouchDevice(): boolean;
-/**
- * Returns a human-readable shortcut hint string for the current platform.
- * Examples: "⌘Z" on Mac, "Ctrl+Z" on Windows, "Shake" on iOS.
- */
-export declare function getUndoShortcutHint(): string;
-export declare function getRedoShortcutHint(): string;
-interface UseAgentUndoRedoOptions {
-    agentId: string | null;
-    /**
-     * The editing surface this mount owns — the shortcut answers only keys
-     * pressed inside it. The builder mounts this hook once per message; an
-     * unscoped listener undid the agent once PER MESSAGE on a single ⌘Z.
-     */
-    scope: () => Element | null;
-    enabled?: boolean;
-}
-interface UseAgentUndoRedoReturn {
-    canUndo: boolean;
-    canRedo: boolean;
-    undo: () => void;
-    redo: () => void;
-    undoHint: string;
-    redoHint: string;
-    platform: Platform;
-}
-export declare function useAgentUndoRedo({ agentId, scope, enabled, }: UseAgentUndoRedoOptions): UseAgentUndoRedoReturn;
-export {};