@ai-matrx/chat 0.5.18 → 0.6.0

package/dist/agents/redux/agent-settings/settings-catalogue.js

@@ -1,176 +1 @@
-import { UI_GATE_KEYS } from "./ui-gates.js";
-import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
-const CONTROL_TYPES = [
-  "number",
-  "integer",
-  "boolean",
-  "string",
-  "enum",
-  "array",
-  "string_array",
-  "object_array"
-];
-function isControlDefinitionShape(value) {
-  return typeof value.type === "string" && CONTROL_TYPES.includes(value.type);
-}
-const TEXT_GROUP = [
-  { key: "response_format", label: "Response Format" },
-  { key: "stop_sequences", label: "Stop Sequences" },
-  { key: "temperature", label: "Temperature" },
-  { key: "max_output_tokens", label: "Max Output Tokens" },
-  { key: "top_p", label: "Top P" },
-  { key: "top_k", label: "Top K" },
-  { key: "thinking_budget", label: "Thinking Budget" },
-  { key: "thinking_level", label: "Thinking Level" },
-  { key: "reasoning_effort", label: "Reasoning Effort" },
-  { key: "reasoning_summary", label: "Reasoning Summary" },
-  // Deep Research agents: charts and images inside the report.
-  { key: "visualization", label: "Charts and Images" },
-  { key: "verbosity", label: "Verbosity" },
-  { key: "tool_choice", label: "Tool Choice" }
-];
-const FEATURE_FLAGS_GROUP = [
-  { key: "stream", label: "Stream Response" },
-  { key: "store", label: "Store Conversation" },
-  { key: "parallel_tool_calls", label: "Parallel Tool Calls" },
-  { key: "include_thoughts", label: "Include Thoughts" },
-  { key: "internal_web_search", label: "Internal Web Search" },
-  { key: "internal_url_context", label: "Internal URL Context" },
-  { key: "disable_safety_checker", label: "Disable Safety Checker" },
-  { key: "clear_thinking", label: "Clear Thinking" },
-  { key: "disable_reasoning", label: "Disable Reasoning" },
-  { key: "generate_audio", label: "Generate Audio" },
-  { key: "enhance_prompt", label: "Enhance Prompt" },
-  { key: "include_rai_reason", label: "Include RAI Reason" }
-];
-const IMAGE_VIDEO_GROUP = [
-  { key: "size", label: "Size" },
-  { key: "quality", label: "Quality" },
-  { key: "count", label: "Count" },
-  { key: "steps", label: "Steps" },
-  { key: "guidance_scale", label: "Guidance Scale" },
-  { key: "seed", label: "Seed" },
-  { key: "width", label: "Width" },
-  { key: "height", label: "Height" },
-  { key: "fps", label: "FPS" },
-  { key: "seconds", label: "Duration (s) [legacy string]" },
-  { key: "output_quality", label: "Output Quality" },
-  { key: "negative_prompt", label: "Negative Prompt" },
-  { key: "aspect_ratio", label: "Aspect Ratio" },
-  { key: "ratio", label: "Aspect Ratio (Together/Runway)" },
-  { key: "resolution", label: "Resolution" },
-  { key: "image_size", label: "Image Size" },
-  { key: "num_outputs", label: "Outputs" },
-  { key: "number_of_images", label: "Number of Images" },
-  { key: "render_quality", label: "Render Quality" },
-  { key: "background", label: "Background" },
-  { key: "input_fidelity", label: "Input Fidelity" },
-  { key: "output_compression", label: "Output Compression" },
-  { key: "moderation", label: "Moderation" },
-  { key: "partial_images", label: "Partial Images" },
-  { key: "output_mime_type", label: "Output MIME Type" },
-  { key: "person_generation", label: "Person Generation" },
-  { key: "image_format", label: "Image Format" },
-  { key: "style", label: "Style" },
-  { key: "reference_strength", label: "Reference Strength" },
-  { key: "duration_seconds", label: "Duration (s)" },
-  { key: "duration", label: "Duration" },
-  { key: "encode_quality", label: "Encode Quality" },
-  { key: "video_action", label: "Video Action" },
-  { key: "reference_images", label: "Reference Images" },
-  { key: "frame_images", label: "Frame Images" },
-  { key: "image_loras", label: "Image LoRAs" }
-];
-const AUDIO_GROUP = [
-  { key: "tts_voice", label: "Voice" },
-  { key: "performance_direction", label: "Performance Direction" },
-  { key: "speech_speed", label: "Speed" },
-  { key: "turn_pause_ms", label: "Pause Between Turns (ms)" },
-  { key: "language_code", label: "Language" },
-  { key: "audio_format", label: "Audio Format" }
-];
-const SETTINGS_CATALOGUE = [
-  { id: "text", label: "", entries: TEXT_GROUP },
-  { id: "featureFlags", label: "Feature Flags", entries: FEATURE_FLAGS_GROUP },
-  { id: "imageVideo", label: "Image / Video Settings", entries: IMAGE_VIDEO_GROUP },
-  { id: "audio", label: "Audio Settings", entries: AUDIO_GROUP }
-];
-const CATALOGUE_KEYS = new Set(
-  SETTINGS_CATALOGUE.flatMap((g) => g.entries.map((e) => e.key))
-);
-const CATCHALL_EXCLUDED = /* @__PURE__ */ new Set([
-  "rawControls",
-  "unmappedControls",
-  "model_id",
-  "model",
-  // chosen via the dedicated model picker, never a generic settings row
-  "multi_speaker",
-  // edited via the Voice editor alongside tts_voice
-  // Model-gated UI flags live in the ui_gates column + UiGatesEditor, never as
-  // settings rows — even when the model declares them as controls (e.g. every
-  // model now declares `tools` for the tool-support capability).
-  ...UI_GATE_KEYS
-]);
-function lookupControl(controls, key) {
-  if (!controls) return null;
-  if (CATCHALL_EXCLUDED.has(key)) {
-    if (key === "rawControls" || key === "unmappedControls") return null;
-  }
-  const candidate = controls[key];
-  if (candidate && typeof candidate === "object" && !Array.isArray(candidate)) {
-    const c = candidate;
-    if (isControlDefinitionShape(c)) {
-      return c;
-    }
-  }
-  return null;
-}
-function hasMeaningfulValue(settings, key) {
-  if (!settings) return false;
-  const v = settings[key];
-  return v !== void 0 && v !== null;
-}
-function buildSettingsRows(controls, settings) {
-  const groups = SETTINGS_CATALOGUE.map((group) => ({
-    id: group.id,
-    label: group.label,
-    rows: group.entries.flatMap((entry) => {
-      const control = lookupControl(controls, entry.key);
-      if (!control) return [];
-      return [
-        {
-          key: entry.key,
-          label: entry.label,
-          group: group.id,
-          control,
-          supported: true,
-          hasValue: hasMeaningfulValue(settings, entry.key)
-        }
-      ];
-    })
-  }));
-  const declaredExtra = [];
-  if (controls) {
-    for (const key of Object.keys(controls)) {
-      if (CATALOGUE_KEYS.has(key) || CATCHALL_EXCLUDED.has(key)) continue;
-      if (lookupControl(controls, key)) declaredExtra.push(key);
-    }
-  }
-  if (declaredExtra.length > 0) {
-    const rows = declaredExtra.sort().map((key) => ({
-      key,
-      label: humanizeIdentifier(key),
-      group: "other",
-      control: lookupControl(controls, key),
-      supported: true,
-      hasValue: hasMeaningfulValue(settings, key)
-    }));
-    groups.push({ id: "other", label: "Other Settings", rows });
-  }
-  return groups;
-}
-export {
-  CATALOGUE_KEYS,
-  SETTINGS_CATALOGUE,
-  buildSettingsRows
-};
+export * from "@ai-matrx/agents/settings";

package/dist/agents/redux/agent-settings/types.d.ts

@@ -1,148 +1,2 @@
-/**
- * Agent Settings — Type Definitions
- *
- * All field names are snake_case to match the Python backend exactly.
- * This is the single canonical type used across all contexts:
- *   - Prompt Builder (defaults only, no override tracking)
- *   - Chat (overrides tracked separately from agent defaults)
- *   - Test (multiple agents simultaneously, all in memory)
- */
-import type { VariableCustomComponent } from "../../types/agent-definition.types.js";
-import type { LLMParams } from "../../types/agent-api-types.js";
-/**
- * Agent model settings are the generated server contract—never a handwritten
- * subset or frontend extension. UI-only input capabilities live in UiGates and
- * runtime attachment state; selected tools live in the client-tools slice.
- */
-export type AgentSettings = LLMParams;
-export type ControlType = "number" | "integer" | "boolean" | "string" | "enum" | "array" | "string_array" | "object_array";
-export interface ControlDefinition {
-    type: ControlType;
-    min?: number;
-    max?: number;
-    default?: unknown;
-    enum?: string[];
-    required?: boolean;
-    /** True when the control is an "allowed" feature flag (not a submission param) */
-    isFeatureFlag?: boolean;
-}
-/**
- * Parsed capability map for a model. Keyed by AgentSettings field names (snake_case).
- * Always has rawControls and unmappedControls for debugging.
- */
-export type NormalizedControls = Partial<Record<keyof AgentSettings, ControlDefinition>> & {
-    /** Frontend capability declarations from model controls, never API params. */
-    tools?: ControlDefinition;
-    image_urls?: ControlDefinition;
-    file_urls?: ControlDefinition;
-    youtube_videos?: ControlDefinition;
-    rawControls: Record<string, unknown>;
-    unmappedControls: Record<string, unknown>;
-};
-export type ConflictReason = "unsupported_key" | "value_out_of_range" | "invalid_enum_value";
-export interface ConflictItem {
-    key: keyof AgentSettings;
-    currentValue: unknown;
-    newModelDefault: unknown;
-    reason: ConflictReason;
-    description: string;
-    /** If the new model uses a different parameter name for the same concept */
-    aliasHint?: string;
-}
-export type ResolutionMode = "keep_all" | "auto_resolve" | "remove_only" | "custom";
-export type ConflictAction = "keep" | "reset";
-/**
- * All state needed to present and resolve a pending model switch.
- * Lives in Redux state until the user confirms or cancels.
- */
-export interface PendingModelSwitch {
-    prevModelId: string;
-    prevModelName: string;
-    newModelId: string;
-    newModelName: string;
-    conflicts: ConflictItem[];
-    /** Keys from current settings that are fully compatible with the new model */
-    supportedKeys: Array<keyof AgentSettings>;
-    newModelControls: NormalizedControls;
-    mode: ResolutionMode;
-    /** Per-conflict override when mode === 'custom' */
-    customActions: Partial<Record<keyof AgentSettings, ConflictAction>>;
-    /**
-     * The CLASS (offering) picked with the new model, applied on confirm.
-     * Absent = no class picked → the old model's pin is dropped on confirm (a
-     * class belongs to exactly one model). Never written before confirm, so the
-     * entry never pairs the old model with the new model's class.
-     */
-    offeringId?: string;
-}
-export interface AgentVariable {
-    name: string;
-    defaultValue: string;
-    customComponent?: VariableCustomComponent;
-    required?: boolean;
-    helpText?: string;
-}
-export type AgentSource = "prompt" | "builtin";
-export type AgentContext = "builder" | "chat" | "test";
-export interface AgentSettingsEntry {
-    agentId: string;
-    source: AgentSource;
-    context: AgentContext;
-    /**
-     * The agent's persisted configuration loaded from the DB.
-     * In 'builder' context, user edits mutate this directly.
-     * In 'chat'/'test' contexts, this is read-only — changes go to overrides.
-     */
-    defaults: AgentSettings;
-    /**
-     * User-made changes that differ from defaults.
-     * Only populated in 'chat' and 'test' contexts.
-     * In 'builder' context, always empty (edits go directly to defaults).
-     */
-    overrides: Partial<AgentSettings>;
-    /**
-     * Variable defaults — from the separate `variable_defaults` DB column.
-     * NOT inside the settings JSONB blob.
-     */
-    variable_defaults: AgentVariable[];
-    /**
-     * Variable value overrides — used in 'chat'/'test' contexts.
-     * Maps variable name → current value. Never saved to DB.
-     */
-    variable_overrides: Record<string, string>;
-    /**
-     * A pending model switch awaiting user confirmation.
-     * Populated by requestModelSwitch thunk, cleared by confirm/cancel.
-     */
-    pendingSwitch: PendingModelSwitch | null;
-    isDirty: boolean;
-    isLoading: boolean;
-    isSaving: boolean;
-    error: string | null;
-    lastFetchedAt: string | null;
-}
-/** Minimal tool shape stored in the slice — matches the DB `tools` table */
-export interface AvailableTool {
-    id: string;
-    name: string;
-    description: string;
-    category?: string;
-    icon?: string;
-}
-export interface AgentSettingsState {
-    entries: Record<string, AgentSettingsEntry>;
-    /** The agentId currently "focused" in the UI (for shortcut selectors) */
-    activeAgentId: string | null;
-    /** All active tools fetched from Supabase — shared across all agents */
-    availableTools: AvailableTool[];
-    isLoadingTools: boolean;
-    toolsError: string | null;
-}
-/** Shape of a raw Supabase row from `prompts` or `agent.definition` (was `prompt_builtins`).
- * Note: agent.definition uses `variable_definitions` (mapped to `variable_defaults` at load time). */
-export interface RawAgentDbRow {
-    id: string;
-    settings: AgentSettings | null;
-    variable_defaults: AgentVariable[] | null;
-    [key: string]: unknown;
-}
+/** Agent settings live in the agent core (B4): `@ai-matrx/agents/settings`. */
+export * from "@ai-matrx/agents/settings";

package/dist/agents/redux/agent-settings/types.js

@@ -0,0 +1 @@
+export * from "@ai-matrx/agents/settings";

package/dist/agents/redux/agent-settings/ui-gates.d.ts

@@ -1,54 +1,2 @@
-/**
- * UI Gates — canonical model-gated UI flags.
- *
- * FE-ONLY. These flags NEVER reach the server. They gate what the chat / agent
- * builder UI exposes for the currently-selected model (e.g. whether to offer the
- * image-URL, file-URL or YouTube attachment inputs) — which in turn shapes the
- * request the client constructs. The flags themselves are not model parameters,
- * so the backend neither receives nor cares about them.
- *
- * Persisted in the dedicated `agx_agent.ui_gates` / `agx_version.ui_gates` jsonb
- * column — NEVER inside `settings` (which holds only server-consumed params).
- *
- * This module is the SINGLE SOURCE OF TRUTH that replaced the `UI_CAPABILITY_KEYS`
- * sets formerly copy-pasted across the execution selectors, the manual-execute
- * thunk, the validation rules/resolve-config, and the model-controls parser.
- * The concept is intentionally generic and open to growth: any future
- * "show X in the UI when the model supports it" affordance lands here.
- */
-import { z } from "zod";
-/**
- * UI-only agent/run configuration. This schema is the source of truth for the
- * persisted `ui_gates` JSONB boundary; never mirror it with an interface.
- * New product UI capabilities are added here, never to the Python parameter
- * contract. Unknown persisted keys are stripped at this boundary.
- */
-export declare const uiGatesSchema: z.ZodObject<{
-    tools: z.ZodOptional<z.ZodBoolean>;
-    image_urls: z.ZodOptional<z.ZodBoolean>;
-    file_urls: z.ZodOptional<z.ZodBoolean>;
-    youtube_videos: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-export type UiGates = z.infer<typeof uiGatesSchema>;
-/** Parse persisted/UI-boundary data. Invalid shapes fail loudly. */
-export declare function parseUiGates(value: unknown): UiGates;
-/** Every gate key the UI currently understands. Extend here, nowhere else. */
-export declare const UI_GATE_KEYS: readonly ["tools", "image_urls", "file_urls", "youtube_videos"];
-export type UiGateKey = (typeof UI_GATE_KEYS)[number];
-/**
- * The gates a USER toggles per-agent (the chat-attachment affordances).
- *
- * `tools` is intentionally **excluded**: tool support is a MODEL capability
- * (resolved from `ai_model.controls.tools` via `supportsTools` in
- * `useModelControls`), not a per-agent UI gate. `tools` remains in
- * `UI_GATE_KEYS` so any legacy `ui_gates.tools` value is still recognized and
- * stripped before the API call — it is just never offered as an editable toggle.
- */
-export declare const UI_GATE_EDITABLE_KEYS: readonly ["image_urls", "file_urls", "youtube_videos"];
-export type UiGateEditableKey = (typeof UI_GATE_EDITABLE_KEYS)[number];
-/** True when `key` is a model-gated UI flag (belongs in ui_gates, not settings). */
-export declare function isUiGateKey(key: string): boolean;
-/** The empty default — a record with no gates set. */
-export declare const EMPTY_UI_GATES: UiGates;
-/** Read a single gate as a strict boolean (absent ⇒ false). */
-export declare function gateEnabled(gates: UiGates | null | undefined, key: UiGateKey): boolean;
+/** Agent settings live in the agent core (B4): `@ai-matrx/agents/settings`. */
+export * from "@ai-matrx/agents/settings";

package/dist/agents/redux/agent-settings/ui-gates.js

@@ -1,38 +1 @@
-import { z } from "zod";
-const uiGatesSchema = z.object({
-  tools: z.boolean().optional(),
-  image_urls: z.boolean().optional(),
-  file_urls: z.boolean().optional(),
-  youtube_videos: z.boolean().optional()
-});
-function parseUiGates(value) {
-  return uiGatesSchema.parse(value ?? {});
-}
-const UI_GATE_KEYS = [
-  "tools",
-  "image_urls",
-  "file_urls",
-  "youtube_videos"
-];
-const UI_GATE_EDITABLE_KEYS = [
-  "image_urls",
-  "file_urls",
-  "youtube_videos"
-];
-const UI_GATE_KEY_SET = new Set(UI_GATE_KEYS);
-function isUiGateKey(key) {
-  return UI_GATE_KEY_SET.has(key);
-}
-const EMPTY_UI_GATES = {};
-function gateEnabled(gates, key) {
-  return gates?.[key] === true;
-}
-export {
-  EMPTY_UI_GATES,
-  UI_GATE_EDITABLE_KEYS,
-  UI_GATE_KEYS,
-  gateEnabled,
-  isUiGateKey,
-  parseUiGates,
-  uiGatesSchema
-};
+export * from "@ai-matrx/agents/settings";