@ai-matrx/chat 0.3.11 → 0.3.19

package/dist/agents/hooks/useAgentUndoRedo.js

@@ -1,134 +0,0 @@
-"use client";
-import { useEffect, useCallback } from "react";
-import { keyEventInside } from "@ai-matrx/kit/keyboard-scope";
-import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
-import {
-  undoAgentEdit,
-  redoAgentEdit
-} from "../redux/agent-definition/slice.js";
-import {
-  selectAgentCanUndo,
-  selectAgentCanRedo
-} from "../redux/agent-definition/selectors.js";
-let _cachedPlatform = null;
-function getPlatform() {
-  if (_cachedPlatform) return _cachedPlatform;
-  if (typeof navigator === "undefined") return "unknown";
-  const ua = navigator.userAgent.toLowerCase();
-  if (/iphone|ipad|ipod/.test(ua)) {
-    _cachedPlatform = "ios";
-  } else if (/android/.test(ua)) {
-    _cachedPlatform = "android";
-  } else if (/mac/.test(ua)) {
-    _cachedPlatform = "mac";
-  } else if (/win/.test(ua)) {
-    _cachedPlatform = "windows";
-  } else if (/linux/.test(ua)) {
-    _cachedPlatform = "linux";
-  } else {
-    _cachedPlatform = "unknown";
-  }
-  return _cachedPlatform;
-}
-function isMacLike() {
-  const p = getPlatform();
-  return p === "mac" || p === "ios";
-}
-function isTouchDevice() {
-  const p = getPlatform();
-  return p === "ios" || p === "android";
-}
-function getUndoShortcutHint() {
-  const p = getPlatform();
-  switch (p) {
-    case "mac":
-      return "\u2318Z";
-    case "ios":
-      return "Shake to Undo";
-    case "android":
-      return "Ctrl+Z";
-    case "windows":
-      return "Ctrl+Z";
-    case "linux":
-      return "Ctrl+Z";
-    default:
-      return "Ctrl+Z";
-  }
-}
-function getRedoShortcutHint() {
-  const p = getPlatform();
-  switch (p) {
-    case "mac":
-      return "\u21E7\u2318Z";
-    case "ios":
-      return "Shake to Redo";
-    case "android":
-      return "Ctrl+Shift+Z";
-    case "windows":
-      return "Ctrl+Y";
-    case "linux":
-      return "Ctrl+Shift+Z";
-    default:
-      return "Ctrl+Shift+Z";
-  }
-}
-function useAgentUndoRedo({
-  agentId,
-  scope,
-  enabled = true
-}) {
-  const dispatch = useAppDispatch();
-  const canUndo = useAppSelector(
-    (state) => agentId ? selectAgentCanUndo(state, agentId) : false
-  );
-  const canRedo = useAppSelector(
-    (state) => agentId ? selectAgentCanRedo(state, agentId) : false
-  );
-  const undo = useCallback(() => {
-    if (agentId && canUndo) dispatch(undoAgentEdit({ id: agentId }));
-  }, [dispatch, agentId, canUndo]);
-  const redo = useCallback(() => {
-    if (agentId && canRedo) dispatch(redoAgentEdit({ id: agentId }));
-  }, [dispatch, agentId, canRedo]);
-  useEffect(() => {
-    if (!enabled || !agentId) return void 0;
-    function handleKeyDown(e) {
-      const mod = isMacLike() ? e.metaKey : e.ctrlKey;
-      if (!mod) return;
-      if (!keyEventInside(e, scope())) return;
-      if (e.key === "z" || e.key === "Z") {
-        if (e.shiftKey) {
-          e.preventDefault();
-          if (canRedo) dispatch(redoAgentEdit({ id: agentId }));
-        } else {
-          e.preventDefault();
-          if (canUndo) dispatch(undoAgentEdit({ id: agentId }));
-        }
-        return;
-      }
-      if ((e.key === "y" || e.key === "Y") && !isMacLike()) {
-        e.preventDefault();
-        if (canRedo) dispatch(redoAgentEdit({ id: agentId }));
-      }
-    }
-    document.addEventListener("keydown", handleKeyDown, true);
-    return () => document.removeEventListener("keydown", handleKeyDown, true);
-  }, [enabled, agentId, canUndo, canRedo, dispatch, scope]);
-  return {
-    canUndo,
-    canRedo,
-    undo,
-    redo,
-    undoHint: getUndoShortcutHint(),
-    redoHint: getRedoShortcutHint(),
-    platform: getPlatform()
-  };
-}
-export {
-  getPlatform,
-  getRedoShortcutHint,
-  getUndoShortcutHint,
-  isMacLike,
-  isTouchDevice,
-  useAgentUndoRedo
-};

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

@@ -1,17 +0,0 @@
-/**
- * useAgentUsages — dispatch-on-idle hook for one agent's find-usages scan.
- * Every consumer (user window, admin window, report detail pane) reads through
- * this hook so no component fetches ad hoc.
- */
-import type { UsageScope } from "../../ui/usages/usages.slice.js";
-export declare function useAgentUsages(agentId: string | null, scope: UsageScope): {
-    readonly status: import("../../ui/usages/usages.types.js").UsagesLoadStatus;
-    readonly error: string | null;
-    readonly groups: {
-        usageType: string;
-        items: import("../../ui/usages/usages.types.js").AgentUsageRow[];
-    }[];
-    readonly aggregates: import("../../ui/usages/usages.types.js").AgentUsageAggregate[];
-    readonly summary: import("../../host/ui-slots.js").RedFlagSummary;
-    readonly refresh: () => void;
-};

package/dist/agents/hooks/useAgentUsages.js

@@ -1,36 +0,0 @@
-"use client";
-import { useEffect, useCallback } from "react";
-import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
-import { fetchAgentUsages } from "../../host/ui-slots.js";
-import { makeSelectUsageCache, makeSelectUsageGroups, makeSelectUsageAggregates, makeSelectRedFlagSummary } from "../../host/ui-slots.js";
-import { useMemo } from "react";
-function useAgentUsages(agentId, scope) {
-  const dispatch = useAppDispatch();
-  const id = agentId ?? "";
-  const selectCache = useMemo(() => makeSelectUsageCache(scope, id), [scope, id]);
-  const selectGroups = useMemo(() => makeSelectUsageGroups(scope, id), [scope, id]);
-  const selectAggregates = useMemo(() => makeSelectUsageAggregates(scope, id), [scope, id]);
-  const selectSummary = useMemo(() => makeSelectRedFlagSummary(scope, id), [scope, id]);
-  const cache = useAppSelector(selectCache);
-  const groups = useAppSelector(selectGroups);
-  const aggregates = useAppSelector(selectAggregates);
-  const summary = useAppSelector(selectSummary);
-  useEffect(() => {
-    if (!agentId) return;
-    dispatch(fetchAgentUsages({ agentId, scope }));
-  }, [dispatch, agentId, scope]);
-  const refresh = useCallback(() => {
-    if (agentId) dispatch(fetchAgentUsages({ agentId, scope, force: true }));
-  }, [dispatch, agentId, scope]);
-  return {
-    status: cache?.status ?? "idle",
-    error: cache?.error ?? null,
-    groups,
-    aggregates,
-    summary,
-    refresh
-  };
-}
-export {
-  useAgentUsages
-};

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

@@ -1,11 +0,0 @@
-/**
- * useDriftAlerts — dispatch-on-idle hook for the caller's open drift alerts,
- * powering the agents-page header drift indicator. Exposes dismiss + view-stamp actions.
- */
-import type { DriftAlertRow } from "../../ui/usages/usages.types.js";
-export declare function useDriftAlerts(): {
-    readonly alerts: DriftAlertRow[];
-    readonly status: import("../../ui/usages/usages.types.js").UsagesLoadStatus;
-    readonly dismiss: (alert: DriftAlertRow) => void;
-    readonly markViewed: (alertId: string) => void;
-};

package/dist/agents/hooks/useDriftAlerts.js

@@ -1,36 +0,0 @@
-"use client";
-import { useEffect, useCallback } from "react";
-import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
-import { dismissDriftAlert, fetchDriftAlerts, markDriftAlertViewed } from "../../host/ui-slots.js";
-import { selectActiveBannerAlerts, selectDriftAlertsStatus } from "../../host/ui-slots.js";
-import { selectAccessToken, selectAuthReady, selectUserId } from "../../host/identity.js";
-function useDriftAlerts() {
-  const dispatch = useAppDispatch();
-  const alerts = useAppSelector(selectActiveBannerAlerts);
-  const status = useAppSelector(selectDriftAlertsStatus);
-  const authReady = useAppSelector(selectAuthReady);
-  const userId = useAppSelector(selectUserId);
-  const accessToken = useAppSelector(selectAccessToken);
-  useEffect(() => {
-    if (authReady && userId && accessToken) {
-      dispatch(fetchDriftAlerts());
-    }
-  }, [dispatch, authReady, userId, accessToken]);
-  const dismiss = useCallback(
-    (alert) => {
-      const prev = alert.status === "acknowledged" ? "acknowledged" : "pending";
-      dispatch(dismissDriftAlert({ alertId: alert.id, previousStatus: prev }));
-    },
-    [dispatch]
-  );
-  const markViewed = useCallback(
-    (alertId) => {
-      dispatch(markDriftAlertViewed(alertId));
-    },
-    [dispatch]
-  );
-  return { alerts, status, dismiss, markViewed };
-}
-export {
-  useDriftAlerts
-};

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

@@ -1,20 +0,0 @@
-/**
- * useDriftReport — dispatch-on-idle hook for the drift report rollup.
- */
-import type { ReportSortKey } from "../../ui/usages/usages.types.js";
-import type { UsageScope } from "../../ui/usages/usages.slice.js";
-export declare function useDriftReport(scope: UsageScope, sort?: {
-    key: ReportSortKey;
-    desc: boolean;
-}): {
-    readonly status: import("../../ui/usages/usages.types.js").UsagesLoadStatus;
-    readonly error: string | null;
-    readonly rows: import("../../ui/usages/usages.types.js").AgentDriftReportRow[];
-    readonly adminRows: import("../../ui/usages/usages.types.js").AgentDriftReportAdminRow[];
-    readonly totals: {
-        totals: Record<import("../../ui/usages/usages.types.js").DriftSeverity, number>;
-        agents: number;
-        order: import("../../ui/usages/usages.types.js").DriftSeverity[];
-    };
-    readonly refresh: () => void;
-};

package/dist/agents/hooks/useDriftReport.js

@@ -1,34 +0,0 @@
-"use client";
-import { useEffect, useCallback, useMemo } from "react";
-import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
-import { fetchAgentUsageReport } from "../../host/ui-slots.js";
-import { makeSelectReport, makeSelectReportSorted, makeSelectReportTotals } from "../../host/ui-slots.js";
-function useDriftReport(scope, sort = { key: "breaking", desc: true }) {
-  const dispatch = useAppDispatch();
-  const selectEntry = useMemo(() => makeSelectReport(scope), [scope]);
-  const selectSorted = useMemo(
-    () => makeSelectReportSorted(scope, sort.key, sort.desc),
-    [scope, sort.key, sort.desc]
-  );
-  const selectTotals = useMemo(() => makeSelectReportTotals(scope), [scope]);
-  const entry = useAppSelector(selectEntry);
-  const sorted = useAppSelector(selectSorted);
-  const totals = useAppSelector(selectTotals);
-  useEffect(() => {
-    dispatch(fetchAgentUsageReport({ scope }));
-  }, [dispatch, scope]);
-  const refresh = useCallback(() => {
-    dispatch(fetchAgentUsageReport({ scope, force: true }));
-  }, [dispatch, scope]);
-  return {
-    status: entry.status,
-    error: entry.error,
-    rows: sorted.rows,
-    adminRows: sorted.adminRows,
-    totals,
-    refresh
-  };
-}
-export {
-  useDriftReport
-};

package/dist/agents/lifecycle/useAgentLifecycleActions.d.ts

@@ -1,17 +0,0 @@
-export interface AgentLifecycleActions {
-    /** Whether the agent is archived right now (false while it is still loading). */
-    isArchived: boolean;
-    /** "Archive" or "Unarchive" — the label for the control, never a guess. */
-    archiveLabel: string;
-    /** Flip the archive flag. Resolves when the write has landed or failed loudly. */
-    toggleArchived: () => Promise<void>;
-    /** Confirm, soft-delete, then leave the agent's own page. */
-    remove: () => Promise<void>;
-    /** True while either write is in flight, so a menu can disable both. */
-    isBusy: boolean;
-    /** False in a host that registered no builder door: the menu leaves archive and delete out (reported once). */
-    available: boolean;
-}
-export declare function useAgentLifecycleActions(agentId: string, 
-/** Where to land after a delete — the agent's page no longer has a subject. */
-basePath?: string): AgentLifecycleActions;

package/dist/agents/lifecycle/useAgentLifecycleActions.js

@@ -1,63 +0,0 @@
-"use client";
-import { useCallback, useState } from "react";
-import { useRouter } from "../../host/navigation.js";
-import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
-import { getBuilderDoor, requireBuilderDoor } from "../../host/builder-door.js";
-import { selectAgentById } from "../redux/agent-definition/selectors.js";
-import { confirm } from "../../host/ui-slots.js";
-import { buildAgentDeleteConfirm } from "../../ui/agentDeleteConfirm.js";
-import { toast } from "../../host/notify.js";
-function useAgentLifecycleActions(agentId, basePath = "/agents") {
-  const dispatch = useAppDispatch();
-  const router = useRouter();
-  const agent = useAppSelector((state) => selectAgentById(state, agentId));
-  const [isBusy, setIsBusy] = useState(false);
-  const available = getBuilderDoor() !== null;
-  const isArchived = Boolean(agent?.isArchived);
-  const name = agent?.name ?? "";
-  const toggleArchived = useCallback(async () => {
-    setIsBusy(true);
-    try {
-      await dispatch(
-        requireBuilderDoor().saveAgentField({ agentId, field: "isArchived", value: !isArchived })
-      ).unwrap();
-      toast.success(
-        isArchived ? `"${name || "Agent"}" is back in your lists` : `"${name || "Agent"}" archived \u2014 it stays in your archive and can be restored`
-      );
-    } catch (err) {
-      toast.error(
-        isArchived ? "Could not unarchive this agent" : "Could not archive this agent",
-        { description: err instanceof Error ? err.message : void 0 }
-      );
-    } finally {
-      setIsBusy(false);
-    }
-  }, [agentId, dispatch, isArchived, name]);
-  const remove = useCallback(async () => {
-    const ok = await confirm(buildAgentDeleteConfirm(name));
-    if (!ok) return;
-    setIsBusy(true);
-    try {
-      await dispatch(requireBuilderDoor().deleteAgent(agentId)).unwrap();
-      toast.success(name ? `Deleted "${name}"` : "Agent deleted");
-      router.push(basePath);
-    } catch (err) {
-      toast.error("Could not delete agent", {
-        description: err instanceof Error ? err.message : void 0
-      });
-    } finally {
-      setIsBusy(false);
-    }
-  }, [agentId, basePath, dispatch, name, router]);
-  return {
-    isArchived,
-    archiveLabel: isArchived ? "Unarchive" : "Archive",
-    toggleArchived,
-    remove,
-    isBusy,
-    available
-  };
-}
-export {
-  useAgentLifecycleActions
-};

package/dist/agents/message-flags/useMessageFlags.d.ts

@@ -1,8 +0,0 @@
-import { type MessageFlagKey, type MessageFlags } from "./flags.js";
-import type { FlagToggleState } from "./MessageFlagToggles.js";
-export interface MessageFlagsController {
-    flags: MessageFlags;
-    states: Partial<Record<MessageFlagKey, FlagToggleState>>;
-    onToggle: (flag: MessageFlagKey) => void;
-}
-export declare function useMessageFlags(agentId: string, messageIndex: number): MessageFlagsController;

package/dist/agents/message-flags/useMessageFlags.js

@@ -1,68 +0,0 @@
-"use client";
-import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
-import {
-  selectAgentMessages,
-  selectAgentModelId,
-  selectAgentOfferingPin
-} from "../redux/agent-definition/selectors.js";
-import { setAgentMessages } from "../redux/agent-definition/slice.js";
-import { useModelFull } from "../../host/ui-slots.js";
-import { useSessionKnob } from "../../host/prefs-react.js";
-import {
-  FLAG_COMPATIBILITY_KNOB,
-  cacheBoundaryVerdict,
-  flagPlacementProblem,
-  flagsOf,
-  prefillVerdict,
-  resolveFlagCompatibilityMode,
-  toggleMessageFlag
-} from "./flags.js";
-import { useMessageFlagProfile } from "./useMessageFlagProfile.js";
-function useMessageFlags(agentId, messageIndex) {
-  const dispatch = useAppDispatch();
-  const messages = useAppSelector((state) => selectAgentMessages(state, agentId));
-  const modelId = useAppSelector((state) => selectAgentModelId(state, agentId));
-  const model = useModelFull(modelId);
-  const offeringPin = useAppSelector((state) => selectAgentOfferingPin(state, agentId));
-  const profile = useMessageFlagProfile(modelId, offeringPin);
-  const mode = resolveFlagCompatibilityMode(useSessionKnob(FLAG_COMPATIBILITY_KNOB));
-  const list = messages ?? [];
-  const message = list[messageIndex];
-  const flags = flagsOf(message);
-  const role = message?.role;
-  const isLast = messageIndex === list.length - 1;
-  const states = {
-    cache_boundary: {
-      verdict: cacheBoundaryVerdict(model, profile),
-      placementProblem: flags.cache_boundary ? flagPlacementProblem(list, messageIndex, "cache_boundary") : null
-    },
-    example: {
-      hidden: role !== "user" && role !== "assistant",
-      verdict: {
-        verdict: "native",
-        reason: "Sent as an ordinary turn; the paired user and assistant messages toggle together."
-      },
-      placementProblem: flags.example ? flagPlacementProblem(list, messageIndex, "example") : null
-    },
-    prefill: {
-      // Absent unless it can be lawful here — or it is set and now misplaced,
-      // so the author can see why and switch it off.
-      hidden: !flags.prefill && !(role === "assistant" && isLast),
-      verdict: prefillVerdict(model, mode),
-      placementProblem: flags.prefill ? flagPlacementProblem(list, messageIndex, "prefill") : null
-    }
-  };
-  const onToggle = (flag) => {
-    if (!messages) return;
-    dispatch(
-      setAgentMessages({
-        id: agentId,
-        messages: toggleMessageFlag(messages, messageIndex, flag)
-      })
-    );
-  };
-  return { flags, states, onToggle };
-}
-export {
-  useMessageFlags
-};

package/dist/agents/services/agent-definition-snapshot.service.d.ts

@@ -1,15 +0,0 @@
-import type { AgentDefinition } from "../types/agent-definition.types.js";
-/**
- * Read the currently saved agent definition without hydrating Redux.
- *
- * Comparison and review surfaces must use this instead of `fetchFullAgent`:
- * that builder thunk intentionally marks its Redux record clean and clears
- * undo history, which would destroy unrelated unsaved edits in another view.
- *
- * Failures never carry database text to a person (features/access-gate THE
- * LAW): zero rows throws `recordUnavailable` with the `agent` token, so a
- * surface can render `<AccessGate token id/>` and ASK which of deleted /
- * missing / no access / signed out it really is; a real fault throws
- * `operationFailed` with the raw response as `cause` for the inspector.
- */
-export declare function fetchSavedAgentDefinition(agentId: string): Promise<AgentDefinition>;

package/dist/agents/services/agent-definition-snapshot.service.js

@@ -1,20 +0,0 @@
-import { dbRowToAgentDefinition } from "../redux/agent-definition/converters.js";
-import { supabase } from "../../host/db.js";
-import { recordUnavailable } from "../../host/diagnostics.js";
-import { operationFailed } from "@ai-matrx/kit/errors";
-async function fetchSavedAgentDefinition(agentId) {
-  const { data, error } = await supabase.schema("agent").from("definition").select("*").eq("id", agentId).maybeSingle();
-  if (error) throw operationFailed("load this agent", error);
-  if (!data)
-    throw recordUnavailable({
-      entity: "agent",
-      reason: "unknown",
-      recordId: agentId,
-      token: "agent",
-      relation: "agent.definition"
-    });
-  return dbRowToAgentDefinition(data);
-}
-export {
-  fetchSavedAgentDefinition
-};

package/dist/agents/surface-catalog-profile.d.ts

@@ -1,96 +0,0 @@
-/**
- * features/agents/surface-catalog-profile.ts
- *
- * The ONE definition of the composite "agent catalog profile" write contract —
- * `{description?, category?, tags?}` — shared by every surface that lets an
- * agent rewrite how ANOTHER agent is described and filed.
- *
- * WHY THIS FILE EXISTS. Two surfaces edit the same three columns on the same
- * `agent.definition` row from two different windows:
- *
- *   - `matrx-user/agent-advanced-editor` — the floating Agent Advanced Editor
- *     (`AgentContentWindow`), which shipped this contract first as
- *     `editor_catalog_profile`.
- *   - `matrx-user/agent-settings` — the floating Agent Settings window
- *     (`AgentSettingsWindow` → `AgentSettingsForm`), as
- *     `settings_catalog_profile`.
- *
- * Two target definitions over the same fields is a defect, not a coincidence:
- * the campaign's own precedent is `matrx-user/pick-lists` / `matrx-user/pick-list-manager`,
- * whose shared targets were lifted into `features/data-tables/pick-lists/`. So the CONTRACT
- * — the accepted keys, the per-field bounds, the replace-vs-patch semantics,
- * and the model-facing prose that states them — is defined exactly once, here.
- *
- * WHAT IS **NOT** SHARED, AND WHY. The lists precedent shares the target NAME
- * and the HANDLER as well. This one deliberately cannot, for two structural
- * reasons that do not apply there:
- *
- *  1. **The two mounts have different draft containers.** The advanced editor
- *     stages into the `agent-definition` Redux slice (`setAgentField`) and
- *     commits on its own footer Save. `AgentSettingsForm` stages into REACT
- *     COMPONENT STATE (`draft` / `tagsInput` `useState`) and commits by
- *     dispatching `saveAgentField` per changed field. There is no one handler
- *     that serves both — one dispatches an action, the other calls a setState.
- *     `ListDetailClient`, by contrast, is literally the same component driving
- *     the same server actions from both of its mounts.
- *  2. **A shared NAME would land the write in the wrong window.** These are
- *     both floating windows, they can be open at once — `AgentSettingsForm`'s
- *     own Messages / Variables / Tools tiles OPEN the advanced editor — and
- *     each has its own agent picker, so the agent open in one is frequently not
- *     the agent open in the other. `applySurfaceWrite` resolves a bare target
- *     name DEEPEST-FIRST across the mounted stack
- *     (`features/surfaces/runtime/surface-writeback.ts`), so one shared name
- *     would be captured by whichever window happened to be deeper and stage the
- *     text into a record the user who pressed Apply cannot see. That is the
- *     exact hazard `agent-advanced-editor` invented its `editor_` prefix for;
- *     re-using its name here would re-open it.
- *
- * So: one contract, two names, two handlers. The names differ because they must;
- * everything a model is told and everything that is enforced comes from here, so
- * the two cannot drift.
- *
- * BOUNDS COME FROM `agent-identity-metadata.ts`, the canonical validators for
- * these columns (already used by `matrx-admin/system-agents`). This module adds
- * the composite envelope around them and nothing else — it does not re-type a
- * single bound, and the prose below interpolates the real constants so the
- * contract the model SEES is the contract that is ENFORCED.
- *
- * Deliberately React-free and Redux-free: surface manifests import it for the
- * description prose, and the manifest registry is loaded by
- * `scripts/check-surface-drift.ts` outside any React/Next runtime.
- */
-/** The patch a catalog-profile target produces. Every key is optional; at
- * least one is always present (an empty patch throws). */
-export interface AgentCatalogProfilePatch {
-    description?: string;
-    category?: string;
-    tags?: string[];
-}
-/** The ONLY keys any catalog-profile target accepts. */
-export declare const AGENT_CATALOG_PROFILE_KEYS: readonly ["description", "category", "tags"];
-/**
- * Validate a catalog-profile value, WHOLE, before any of it is applied.
- *
- * Nothing here mutates page state: the caller dispatches only after this
- * returns, so a bad `tags` array can never leave a new description already
- * staged. One confirm, one all-or-nothing write.
- *
- * Unknown keys THROW and are named in the message rather than being dropped.
- * An agent reaching for `is_public` or `name` inside this object must hear a
- * refusal — silently ignoring it would let the model report a change it never
- * made.
- */
-export declare function parseAgentCatalogProfile(value: unknown, targetName: string): AgentCatalogProfilePatch;
-/**
- * The model-facing contract prose for a catalog-profile target.
- *
- * `tagsReadTwin` names the surface's own read value for the current tag set,
- * because `tags` is a FULL replacement and an agent that does not re-read first
- * will silently drop the tags it did not think to re-send. `landing` is the one
- * sentence that differs per surface: WHERE the staged value shows up and what
- * the user presses to commit it.
- */
-export declare function agentCatalogProfileTargetDescription(options: {
-    tagsReadTwin: string;
-    landing: string;
-}): string;

package/dist/agents/surface-catalog-profile.js

@@ -1,79 +0,0 @@
-import {
-  AGENT_CATEGORY_MAX_CHARS,
-  AGENT_DESCRIPTION_MAX_CHARS,
-  AGENT_TAGS_MAX_COUNT,
-  AGENT_TAG_MAX_CHARS,
-  normalizeAgentCategory,
-  normalizeAgentDescription,
-  normalizeAgentTags
-} from "./constants/agent-identity-metadata.js";
-const AGENT_CATALOG_PROFILE_KEYS = [
-  "description",
-  "category",
-  "tags"
-];
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function describe(value) {
-  if (value === null) return "null";
-  if (Array.isArray(value)) return "an array";
-  return `a ${typeof value}`;
-}
-function rethrowAsProfileKey(error, targetName) {
-  const message = error instanceof Error ? error.message : String(error);
-  throw new Error(
-    message.replace(/^agent_(description|category|tags)/, `${targetName}.$1`)
-  );
-}
-function parseAgentCatalogProfile(value, targetName) {
-  if (!isPlainObject(value)) {
-    throw new Error(
-      `${targetName} expects an OBJECT like {"description": "...", "category": "...", "tags": ["..."]} \u2014 received ${describe(value)}. Send structured JSON, not a JSON-encoded string, and not the description on its own.`
-    );
-  }
-  const unknownKeys = Object.keys(value).filter(
-    (key) => !AGENT_CATALOG_PROFILE_KEYS.includes(key)
-  );
-  if (unknownKeys.length > 0) {
-    throw new Error(
-      `${targetName} does not accept ${unknownKeys.map((key) => `"${key}"`).join(", ")}. The only accepted keys are description, category and tags. The agent's name, model, tools, web state and lifecycle flags are not writable from this surface.`
-    );
-  }
-  const patch = {};
-  if (value.description !== void 0) {
-    try {
-      patch.description = normalizeAgentDescription(value.description);
-    } catch (error) {
-      rethrowAsProfileKey(error, targetName);
-    }
-  }
-  if (value.category !== void 0) {
-    try {
-      patch.category = normalizeAgentCategory(value.category);
-    } catch (error) {
-      rethrowAsProfileKey(error, targetName);
-    }
-  }
-  if (value.tags !== void 0) {
-    try {
-      patch.tags = normalizeAgentTags(value.tags);
-    } catch (error) {
-      rethrowAsProfileKey(error, targetName);
-    }
-  }
-  if (Object.keys(patch).length === 0) {
-    throw new Error(
-      `${targetName} needs at least one of description, category or tags. An empty object changes nothing.`
-    );
-  }
-  return patch;
-}
-function agentCatalogProfileTargetDescription(options) {
-  return `Updates how the agent is described and filed in the catalog, in ONE atomic write. Value: an OBJECT (structured JSON, never a JSON-encoded string) with at least one of {"description": "a few sentences of plain prose, no markdown headings, up to ${AGENT_DESCRIPTION_MAX_CHARS} characters", "category": "a single short free-text label on one line, up to ${AGENT_CATEGORY_MAX_CHARS} characters \u2014 reuse an existing category rather than inventing a near-duplicate", "tags": ["short", "free-text"]}. Keys you omit are left alone. \`tags\` is a FULL replacement of the tag set, so read the \`${options.tagsReadTwin}\` value first and include every tag you want kept (pass [] to clear them all); at most ${AGENT_TAGS_MAX_COUNT} tags, each up to ${AGENT_TAG_MAX_CHARS} characters, no duplicates and no commas inside a tag. Empty strings are rejected rather than treated as "clear this field" \u2014 blanking a description or a category stays a human edit. No other keys are accepted: the agent's name, model, tools, web state and lifecycle flags are not writable here. ` + options.landing;
-}
-export {
-  AGENT_CATALOG_PROFILE_KEYS,
-  agentCatalogProfileTargetDescription,
-  parseAgentCatalogProfile
-};

package/dist/cx-chat/hooks/useAgentBootstrap.d.ts

@@ -1 +0,0 @@
-export declare function useAgentBootstrap(): void;