@ai-matrx/agents 0.59.229 → 0.59.231

package/dist/quick/index.d.cts

@@ -6,12 +6,13 @@ import { A as AgentSummary } from '../types-DZhDqrVE.cjs';
  * A quick agent is a named bundle of exactly: name, system prompt, model and three settings
  * (temperature, top-p, max output tokens). It is an ordinary `agent.definition` row — one agent
  * table, one permission model, no second prompt store — marked `kind: quick` so the big catalog
- * can hide or group it. This entry owns the shape and the pure builders/selectors; `./writes`
- * owns the four database calls (the one named write allowlist entry of this package).
+ * can hide or group it. This entry owns the shape and the pure builders/selectors; the WRITES go
+ * through chat's one agent-definition write path (`agents/redux/agent-definition/definition-writes`),
+ * never a second one here.
  *
- * The marker lives in two places on purpose: `metadata.kind = "quick"` is the record's own
- * statement; the `kind:quick` tag rides every catalog row (the catalog read carries tags, not
- * metadata), so a list can filter without a second read — exactly how `chat-agent` marks presets.
+ * The marker is the `kind:quick` tag: it rides every catalog row, so a list can filter without a
+ * second read — exactly how `chat-agent` marks presets. (Rows saved before the shared write path also
+ * carry `metadata.kind = "quick"`; both read as quick.)
  */
 
 declare const QUICK_AGENT_KIND: "quick";
@@ -34,26 +35,81 @@ interface QuickAgentDefinition {
 interface QuickAgent extends QuickAgentDefinition {
     id: string;
 }
-declare const QUICK_AGENT_BOUNDS: {
-    readonly temperature: {
-        readonly min: 0;
-        readonly max: 2;
-        readonly step: 0.1;
+/** One setting's slider: where it starts, where it stops, where a new agent rests. */
+interface QuickAgentSettingLimit {
+    min: number;
+    max: number;
+    step: number;
+    default: number;
+}
+interface QuickAgentLimits {
+    temperature: QuickAgentSettingLimit;
+    topP: QuickAgentSettingLimit;
+    maxOutputTokens: QuickAgentSettingLimit;
+}
+/** A model's own settings row for one control (`ai.model` controls: min / max / default), when it states one. */
+interface ModelSettingRow {
+    min?: number | null | undefined;
+    max?: number | null | undefined;
+    default?: unknown;
+}
+/** The chosen model's settings rows for the three controls; a control it does not state is absent. */
+interface ModelSettingRows {
+    temperature?: ModelSettingRow | null | undefined;
+    top_p?: ModelSettingRow | null | undefined;
+    max_output_tokens?: ModelSettingRow | null | undefined;
+}
+/**
+ * The `agents.quick` knob values (organization and person can set them). `undefined` = the register
+ * has not answered yet. A probability lives in 0..1 and a temperature starts at 0 by definition;
+ * every other bound and every default is a knob.
+ */
+interface QuickAgentKnobValues {
+    temperatureMax?: unknown;
+    temperatureDefault?: unknown;
+    topPDefault?: unknown;
+    maxOutputMin?: unknown;
+    maxOutputMax?: unknown;
+    maxOutputDefault?: unknown;
+}
+declare const QUICK_AGENT_KNOBS: {
+    readonly temperatureMax: {
+        readonly feature: "agents.quick";
+        readonly key: "temperature_max";
+    };
+    readonly temperatureDefault: {
+        readonly feature: "agents.quick";
+        readonly key: "temperature_default";
+    };
+    readonly topPDefault: {
+        readonly feature: "agents.quick";
+        readonly key: "top_p_default";
+    };
+    readonly maxOutputMin: {
+        readonly feature: "agents.quick";
+        readonly key: "max_output_min";
     };
-    readonly topP: {
-        readonly min: 0;
-        readonly max: 1;
-        readonly step: 0.05;
+    readonly maxOutputMax: {
+        readonly feature: "agents.quick";
+        readonly key: "max_output_max";
     };
-    readonly maxOutputTokens: {
-        readonly min: 256;
-        readonly max: 32768;
-        readonly step: 256;
+    readonly maxOutputDefault: {
+        readonly feature: "agents.quick";
+        readonly key: "max_output_default";
     };
 };
-declare const QUICK_AGENT_DEFAULT_SETTINGS: QuickAgentSettings;
-/** Settings pulled inside their bounds (a slider can never save a value the model refuses). */
-declare function clampQuickAgentSettings(settings: QuickAgentSettings): QuickAgentSettings;
+/** A slider step that gives ~100 positions over the range, on a 1 / 2 / 5 grid (0.02 -> 0.05 style). */
+declare function sliderStep(min: number, max: number): number;
+/**
+ * THE ONE SOURCE of the three sliders' bounds and resting values: the chosen model's own settings
+ * rows where it states them, else the `agents.quick` knobs. `null` until every number is known (the
+ * panel shows no slider for a number nobody has answered — there is no code default).
+ */
+declare function resolveQuickAgentLimits(model: ModelSettingRows | null | undefined, knobs: QuickAgentKnobValues): QuickAgentLimits | null;
+/** A new agent's settings: every slider at its resting value. */
+declare function defaultQuickAgentSettings(limits: QuickAgentLimits): QuickAgentSettings;
+/** Settings pulled inside their limits (a slider can never save a value the model refuses). */
+declare function clampQuickAgentSettings(settings: QuickAgentSettings, limits: QuickAgentLimits): QuickAgentSettings;
 /** What stops a save, in words — empty when the definition is saveable. */
 declare function quickAgentProblems(def: Pick<QuickAgentDefinition, "name" | "systemPrompt" | "modelId">): string[];
 interface QuickAgentSystemMessage {
@@ -66,28 +122,44 @@ interface QuickAgentSystemMessage {
 /** The persisted `settings` JSON: the three params plus the stream flag every agent row carries. */
 declare function quickAgentSettingsJson(settings: QuickAgentSettings): Record<string, unknown>;
 declare function quickAgentMessages(systemPrompt: string): QuickAgentSystemMessage[];
-/** The `agent.definition` insert for a new quick agent. Born active; no tools, variables or context. */
-declare function buildQuickAgentRow(def: QuickAgentDefinition, owner: {
-    organizationId: string;
-    userId: string;
-}): Record<string, unknown>;
-/** The `agent.definition` update for an edit: only the four things a quick agent has. */
-declare function buildQuickAgentUpdate(def: QuickAgentDefinition): Record<string, unknown>;
-/** A stored row read back as a quick agent; `null` when the row is not one. */
-declare function quickAgentFromRow(row: Record<string, unknown> | null | undefined): QuickAgent | null;
+/**
+ * The agent fields a quick agent sets, in the shape of the ONE agent-definition write path
+ * (chat `definition-writes`): name + system message + model + the three settings, marked quick, no
+ * tools. Nothing else is ever part of a quick agent.
+ */
+declare function quickAgentFields(def: QuickAgentDefinition): {
+    name: string;
+    tags: string[];
+    isActive: true;
+    isArchived: false;
+    modelId: string;
+    messages: QuickAgentSystemMessage[];
+    settings: Record<string, unknown>;
+    tools: never[];
+};
+/**
+ * A stored row read back as a quick agent; `null` when the row is not one. A setting the row does
+ * not carry rests at `defaults` (the resolved limits' resting values).
+ */
+declare function quickAgentFromRow(row: Record<string, unknown> | null | undefined, defaults: QuickAgentSettings): QuickAgent | null;
 declare function isQuickAgentSummary(row: Pick<AgentSummary, "tags">): boolean;
 /**
- * THE PERSONAL LIST: the person's own, live quick agents out of the ONE catalog read.
- * (Org and system lanes are the catalogue's own tabs; this is "mine".)
+ * THE QUICK-AGENT LIST in the platform's visibility lanes: mine, then my organization's, then the
+ * system's (the catalog's own user-type / builtin split; "mine" is what the person created).
  */
+declare function listQuickAgents(rows: readonly AgentSummary[], userId: string | null): {
+    mine: AgentSummary[];
+    organization: AgentSummary[];
+    system: AgentSummary[];
+};
+/** The pill's list: mine, then organization, then system. */
 declare function listMyQuickAgents(rows: readonly AgentSummary[], userId: string | null): AgentSummary[];
 /** The big catalogue's view: quick agents leave the general list (a filter, never a delete). */
 declare function withoutQuickAgents<T extends Pick<AgentSummary, "tags">>(rows: readonly T[]): T[];
 
 /**
- * The four database calls of a quick agent, over the EXISTING `agent.definition` table.
- * The only write entry of this package besides favorites (check-agents-below-chat WRITE_ALLOWLIST).
- * The client is the host's own RLS-bound Supabase client; nothing here knows how it was built.
+ * The one READ of a quick agent: its full definition (the catalog row carries no prompt). Reads
+ * only; every write goes through chat's one agent-definition write path.
  */
 
 interface QuickAgentClient {
@@ -95,14 +167,7 @@ interface QuickAgentClient {
         from(table: "definition"): any;
     };
 }
-declare function createQuickAgent(client: QuickAgentClient, def: QuickAgentDefinition, owner: {
-    organizationId: string;
-    userId: string;
-}): Promise<QuickAgent>;
-declare function updateQuickAgent(client: QuickAgentClient, id: string, def: QuickAgentDefinition): Promise<QuickAgent>;
-/** Soft delete — the same `deleted_at` every agent delete sets, so every list already hides it. */
-declare function deleteQuickAgent(client: QuickAgentClient, id: string): Promise<void>;
-/** One quick agent's full definition (the catalog row carries no prompt). */
-declare function readQuickAgent(client: QuickAgentClient, id: string): Promise<QuickAgent | null>;
+/** One quick agent's full definition; settings the row lacks rest at `defaults`. */
+declare function readQuickAgent(client: QuickAgentClient, id: string, defaults: QuickAgentSettings): Promise<QuickAgent | null>;
 
-export { QUICK_AGENT_BOUNDS, QUICK_AGENT_DEFAULT_SETTINGS, QUICK_AGENT_KIND, QUICK_AGENT_TAG, type QuickAgent, type QuickAgentClient, type QuickAgentDefinition, type QuickAgentSettings, type QuickAgentSystemMessage, buildQuickAgentRow, buildQuickAgentUpdate, clampQuickAgentSettings, createQuickAgent, deleteQuickAgent, isQuickAgentSummary, listMyQuickAgents, quickAgentFromRow, quickAgentMessages, quickAgentProblems, quickAgentSettingsJson, readQuickAgent, updateQuickAgent, withoutQuickAgents };
+export { type ModelSettingRow, type ModelSettingRows, QUICK_AGENT_KIND, QUICK_AGENT_KNOBS, QUICK_AGENT_TAG, type QuickAgent, type QuickAgentClient, type QuickAgentDefinition, type QuickAgentKnobValues, type QuickAgentLimits, type QuickAgentSettingLimit, type QuickAgentSettings, type QuickAgentSystemMessage, clampQuickAgentSettings, defaultQuickAgentSettings, isQuickAgentSummary, listMyQuickAgents, listQuickAgents, quickAgentFields, quickAgentFromRow, quickAgentMessages, quickAgentProblems, quickAgentSettingsJson, readQuickAgent, resolveQuickAgentLimits, sliderStep, withoutQuickAgents };

package/dist/quick/index.d.ts

@@ -6,12 +6,13 @@ import { A as AgentSummary } from '../types-DZhDqrVE.js';
  * A quick agent is a named bundle of exactly: name, system prompt, model and three settings
  * (temperature, top-p, max output tokens). It is an ordinary `agent.definition` row — one agent
  * table, one permission model, no second prompt store — marked `kind: quick` so the big catalog
- * can hide or group it. This entry owns the shape and the pure builders/selectors; `./writes`
- * owns the four database calls (the one named write allowlist entry of this package).
+ * can hide or group it. This entry owns the shape and the pure builders/selectors; the WRITES go
+ * through chat's one agent-definition write path (`agents/redux/agent-definition/definition-writes`),
+ * never a second one here.
  *
- * The marker lives in two places on purpose: `metadata.kind = "quick"` is the record's own
- * statement; the `kind:quick` tag rides every catalog row (the catalog read carries tags, not
- * metadata), so a list can filter without a second read — exactly how `chat-agent` marks presets.
+ * The marker is the `kind:quick` tag: it rides every catalog row, so a list can filter without a
+ * second read — exactly how `chat-agent` marks presets. (Rows saved before the shared write path also
+ * carry `metadata.kind = "quick"`; both read as quick.)
  */
 
 declare const QUICK_AGENT_KIND: "quick";
@@ -34,26 +35,81 @@ interface QuickAgentDefinition {
 interface QuickAgent extends QuickAgentDefinition {
     id: string;
 }
-declare const QUICK_AGENT_BOUNDS: {
-    readonly temperature: {
-        readonly min: 0;
-        readonly max: 2;
-        readonly step: 0.1;
+/** One setting's slider: where it starts, where it stops, where a new agent rests. */
+interface QuickAgentSettingLimit {
+    min: number;
+    max: number;
+    step: number;
+    default: number;
+}
+interface QuickAgentLimits {
+    temperature: QuickAgentSettingLimit;
+    topP: QuickAgentSettingLimit;
+    maxOutputTokens: QuickAgentSettingLimit;
+}
+/** A model's own settings row for one control (`ai.model` controls: min / max / default), when it states one. */
+interface ModelSettingRow {
+    min?: number | null | undefined;
+    max?: number | null | undefined;
+    default?: unknown;
+}
+/** The chosen model's settings rows for the three controls; a control it does not state is absent. */
+interface ModelSettingRows {
+    temperature?: ModelSettingRow | null | undefined;
+    top_p?: ModelSettingRow | null | undefined;
+    max_output_tokens?: ModelSettingRow | null | undefined;
+}
+/**
+ * The `agents.quick` knob values (organization and person can set them). `undefined` = the register
+ * has not answered yet. A probability lives in 0..1 and a temperature starts at 0 by definition;
+ * every other bound and every default is a knob.
+ */
+interface QuickAgentKnobValues {
+    temperatureMax?: unknown;
+    temperatureDefault?: unknown;
+    topPDefault?: unknown;
+    maxOutputMin?: unknown;
+    maxOutputMax?: unknown;
+    maxOutputDefault?: unknown;
+}
+declare const QUICK_AGENT_KNOBS: {
+    readonly temperatureMax: {
+        readonly feature: "agents.quick";
+        readonly key: "temperature_max";
+    };
+    readonly temperatureDefault: {
+        readonly feature: "agents.quick";
+        readonly key: "temperature_default";
+    };
+    readonly topPDefault: {
+        readonly feature: "agents.quick";
+        readonly key: "top_p_default";
+    };
+    readonly maxOutputMin: {
+        readonly feature: "agents.quick";
+        readonly key: "max_output_min";
     };
-    readonly topP: {
-        readonly min: 0;
-        readonly max: 1;
-        readonly step: 0.05;
+    readonly maxOutputMax: {
+        readonly feature: "agents.quick";
+        readonly key: "max_output_max";
     };
-    readonly maxOutputTokens: {
-        readonly min: 256;
-        readonly max: 32768;
-        readonly step: 256;
+    readonly maxOutputDefault: {
+        readonly feature: "agents.quick";
+        readonly key: "max_output_default";
     };
 };
-declare const QUICK_AGENT_DEFAULT_SETTINGS: QuickAgentSettings;
-/** Settings pulled inside their bounds (a slider can never save a value the model refuses). */
-declare function clampQuickAgentSettings(settings: QuickAgentSettings): QuickAgentSettings;
+/** A slider step that gives ~100 positions over the range, on a 1 / 2 / 5 grid (0.02 -> 0.05 style). */
+declare function sliderStep(min: number, max: number): number;
+/**
+ * THE ONE SOURCE of the three sliders' bounds and resting values: the chosen model's own settings
+ * rows where it states them, else the `agents.quick` knobs. `null` until every number is known (the
+ * panel shows no slider for a number nobody has answered — there is no code default).
+ */
+declare function resolveQuickAgentLimits(model: ModelSettingRows | null | undefined, knobs: QuickAgentKnobValues): QuickAgentLimits | null;
+/** A new agent's settings: every slider at its resting value. */
+declare function defaultQuickAgentSettings(limits: QuickAgentLimits): QuickAgentSettings;
+/** Settings pulled inside their limits (a slider can never save a value the model refuses). */
+declare function clampQuickAgentSettings(settings: QuickAgentSettings, limits: QuickAgentLimits): QuickAgentSettings;
 /** What stops a save, in words — empty when the definition is saveable. */
 declare function quickAgentProblems(def: Pick<QuickAgentDefinition, "name" | "systemPrompt" | "modelId">): string[];
 interface QuickAgentSystemMessage {
@@ -66,28 +122,44 @@ interface QuickAgentSystemMessage {
 /** The persisted `settings` JSON: the three params plus the stream flag every agent row carries. */
 declare function quickAgentSettingsJson(settings: QuickAgentSettings): Record<string, unknown>;
 declare function quickAgentMessages(systemPrompt: string): QuickAgentSystemMessage[];
-/** The `agent.definition` insert for a new quick agent. Born active; no tools, variables or context. */
-declare function buildQuickAgentRow(def: QuickAgentDefinition, owner: {
-    organizationId: string;
-    userId: string;
-}): Record<string, unknown>;
-/** The `agent.definition` update for an edit: only the four things a quick agent has. */
-declare function buildQuickAgentUpdate(def: QuickAgentDefinition): Record<string, unknown>;
-/** A stored row read back as a quick agent; `null` when the row is not one. */
-declare function quickAgentFromRow(row: Record<string, unknown> | null | undefined): QuickAgent | null;
+/**
+ * The agent fields a quick agent sets, in the shape of the ONE agent-definition write path
+ * (chat `definition-writes`): name + system message + model + the three settings, marked quick, no
+ * tools. Nothing else is ever part of a quick agent.
+ */
+declare function quickAgentFields(def: QuickAgentDefinition): {
+    name: string;
+    tags: string[];
+    isActive: true;
+    isArchived: false;
+    modelId: string;
+    messages: QuickAgentSystemMessage[];
+    settings: Record<string, unknown>;
+    tools: never[];
+};
+/**
+ * A stored row read back as a quick agent; `null` when the row is not one. A setting the row does
+ * not carry rests at `defaults` (the resolved limits' resting values).
+ */
+declare function quickAgentFromRow(row: Record<string, unknown> | null | undefined, defaults: QuickAgentSettings): QuickAgent | null;
 declare function isQuickAgentSummary(row: Pick<AgentSummary, "tags">): boolean;
 /**
- * THE PERSONAL LIST: the person's own, live quick agents out of the ONE catalog read.
- * (Org and system lanes are the catalogue's own tabs; this is "mine".)
+ * THE QUICK-AGENT LIST in the platform's visibility lanes: mine, then my organization's, then the
+ * system's (the catalog's own user-type / builtin split; "mine" is what the person created).
  */
+declare function listQuickAgents(rows: readonly AgentSummary[], userId: string | null): {
+    mine: AgentSummary[];
+    organization: AgentSummary[];
+    system: AgentSummary[];
+};
+/** The pill's list: mine, then organization, then system. */
 declare function listMyQuickAgents(rows: readonly AgentSummary[], userId: string | null): AgentSummary[];
 /** The big catalogue's view: quick agents leave the general list (a filter, never a delete). */
 declare function withoutQuickAgents<T extends Pick<AgentSummary, "tags">>(rows: readonly T[]): T[];
 
 /**
- * The four database calls of a quick agent, over the EXISTING `agent.definition` table.
- * The only write entry of this package besides favorites (check-agents-below-chat WRITE_ALLOWLIST).
- * The client is the host's own RLS-bound Supabase client; nothing here knows how it was built.
+ * The one READ of a quick agent: its full definition (the catalog row carries no prompt). Reads
+ * only; every write goes through chat's one agent-definition write path.
  */
 
 interface QuickAgentClient {
@@ -95,14 +167,7 @@ interface QuickAgentClient {
         from(table: "definition"): any;
     };
 }
-declare function createQuickAgent(client: QuickAgentClient, def: QuickAgentDefinition, owner: {
-    organizationId: string;
-    userId: string;
-}): Promise<QuickAgent>;
-declare function updateQuickAgent(client: QuickAgentClient, id: string, def: QuickAgentDefinition): Promise<QuickAgent>;
-/** Soft delete — the same `deleted_at` every agent delete sets, so every list already hides it. */
-declare function deleteQuickAgent(client: QuickAgentClient, id: string): Promise<void>;
-/** One quick agent's full definition (the catalog row carries no prompt). */
-declare function readQuickAgent(client: QuickAgentClient, id: string): Promise<QuickAgent | null>;
+/** One quick agent's full definition; settings the row lacks rest at `defaults`. */
+declare function readQuickAgent(client: QuickAgentClient, id: string, defaults: QuickAgentSettings): Promise<QuickAgent | null>;
 
-export { QUICK_AGENT_BOUNDS, QUICK_AGENT_DEFAULT_SETTINGS, QUICK_AGENT_KIND, QUICK_AGENT_TAG, type QuickAgent, type QuickAgentClient, type QuickAgentDefinition, type QuickAgentSettings, type QuickAgentSystemMessage, buildQuickAgentRow, buildQuickAgentUpdate, clampQuickAgentSettings, createQuickAgent, deleteQuickAgent, isQuickAgentSummary, listMyQuickAgents, quickAgentFromRow, quickAgentMessages, quickAgentProblems, quickAgentSettingsJson, readQuickAgent, updateQuickAgent, withoutQuickAgents };
+export { type ModelSettingRow, type ModelSettingRows, QUICK_AGENT_KIND, QUICK_AGENT_KNOBS, QUICK_AGENT_TAG, type QuickAgent, type QuickAgentClient, type QuickAgentDefinition, type QuickAgentKnobValues, type QuickAgentLimits, type QuickAgentSettingLimit, type QuickAgentSettings, type QuickAgentSystemMessage, clampQuickAgentSettings, defaultQuickAgentSettings, isQuickAgentSummary, listMyQuickAgents, listQuickAgents, quickAgentFields, quickAgentFromRow, quickAgentMessages, quickAgentProblems, quickAgentSettingsJson, readQuickAgent, resolveQuickAgentLimits, sliderStep, withoutQuickAgents };