@ai-matrx/agents 0.38.4 → 0.41.0

package/dist/index.d.cts

@@ -8,7 +8,7 @@ export { ApiTargetLogContext, BackendApiError, BackendApiErrorData, BackendError
 export { F as FollowRuntimeOperationOptions, a as FollowRuntimeOperationToEndOptions, b as FollowRuntimeOperationToEndResult, M as MatrxAgentStartRequest, c as MatrxCancelResponse, d as MatrxChatMessage, e as MatrxCompletedRun, f as MatrxContextAnchor, g as MatrxConversationContinueRequest, h as MatrxConversationResumeRequest, i as MatrxConversationStart, j as MatrxEphemeralConversation, k as MatrxJsonObject, l as MatrxJsonValue, m as MatrxMandateStartRequest, n as MatrxOperationEventsPage, o as MatrxOperationFollowEvent, p as MatrxOperationStatusResponse, q as MatrxOperationsByLinkResponse, r as MatrxRequestScope, s as MatrxRunError, t as MatrxRunHandle, u as MatrxRuntimeExecutionStatus, v as MatrxRuntimeOperationEvent, w as MatrxRuntimeOperationView, x as MatrxStoredConversationContinue, y as MatrxStoredConversationCreate, z as MatrxStreamCallOptions, A as MatrxTurnFields, R as RunAgentToCompletionOptions, T as TERMINAL_MATRX_RUNTIME_STATUSES, B as cancelAgentRun, C as continueAgentConversation, D as continueEphemeralConversationStart, E as continueStoredConversationStart, G as followRuntimeOperationEvents, H as followRuntimeOperationToEnd, I as getRuntimeOperationStatus, J as getRuntimeOperationsByLink, K as listRuntimeOperationEvents, L as mintMatrxConversationId, N as newEphemeralConversationStart, O as newStoredConversationStart, P as rejoinRuntimeOperation, Q as resumeAgentConversation, S as runAgentToCompletion, U as startAgentRun, V as startMandateRun } from './operations-C9QvBH_2.cjs';
 import '@ai-matrx/data';
 import '@ai-matrx/data/net';
-import './keys.generated-DxG5tgWt.cjs';
+import './keys.generated-ClN6zfUo.cjs';
 
 /**
  * Media reference roles — the builder's side of the one vocabulary.
@@ -114,6 +114,8 @@ declare function referenceRoleCaption(role: unknown, name: unknown): string | nu
 /** The minimum variable shape this derivation reads (a superset is fine). */
 interface RunInputVariable {
     name: string;
+    /** What the person called it ("Normal Text") — `name` is the `{{normal_text}}` key. */
+    label?: string | null;
     defaultValue?: unknown;
     helpText?: string | null;
     required?: boolean | null;
@@ -160,14 +162,15 @@ declare function partitionControlVariables<T extends RunInputVariable>(defs: rea
 /** The order every variable form renders in. Returns the same array when already ordered. */
 declare function orderVariablesForForm<T extends RunInputVariable>(defs: T[]): T[];
 /**
- * The label a run form shows for a variable: a media variable that fills a
- * reference role is asked for BY that role ("Style reference"); every other
- * variable keeps its formatted name.
+ * The label every screen shows for a variable: the person's own label
+ * ("Normal Text"), else — for a media variable that fills a reference role —
+ * the role's ask ("Style reference"), else the key through THE humanizer
+ * (`@ai-matrx/kit/text-case` `humanizeIdentifier`). Never the raw key.
  */
-declare function variableRunLabel(variable: RunInputVariable, formatName: (name: string) => string): string;
+declare function variableRunLabel(variable: RunInputVariable, formatName?: (name: string) => string): string;
 /** The hint under / beside a variable: its own help text, else the role's line. */
 declare function variableRunHint(variable: RunInputVariable): string | undefined;
 /** Derive the ordered, grouped, labelled run inputs for an agent's variables. */
-declare function deriveRunInputs<V extends RunInputVariable>(defs: readonly V[] | null | undefined, formatName: (name: string) => string): RunInput<V>[];
+declare function deriveRunInputs<V extends RunInputVariable>(defs: readonly V[] | null | undefined, formatName?: (name: string) => string): RunInput<V>[];
 
 export { AUDIO_REFERENCE_ROLES, type AudioReferenceRole, IMAGE_REFERENCE_ROLES, IMAGE_ROLE_META, type ImageReferenceRole, type ImageRoleLimits, type ImageRoleMeta, type ImageRoleVerdict, type ReferenceRole, type RunInput, type RunInputGroup, type RunInputMediaKind, type RunInputVariable, VIDEO_IMAGE_ROLES, VIDEO_REFERENCE_ROLES, type VideoReferenceRole, deriveRunInputs, imageRoleVerdict, isControlVariable, isImageReferenceRole, isReferenceRole, namedReferenceVerdict, normalizeReferenceName, orderVariablesForForm, partitionControlVariables, readImageRoleLimits, referenceRoleCaption, roleTakesName, rolesFor, variableNameOfImageUrl, variableNameOfMediaUrl, variableRunHint, variableRunLabel };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { ApiTargetLogContext, BackendApiError, BackendApiErrorData, BackendError
 export { F as FollowRuntimeOperationOptions, a as FollowRuntimeOperationToEndOptions, b as FollowRuntimeOperationToEndResult, M as MatrxAgentStartRequest, c as MatrxCancelResponse, d as MatrxChatMessage, e as MatrxCompletedRun, f as MatrxContextAnchor, g as MatrxConversationContinueRequest, h as MatrxConversationResumeRequest, i as MatrxConversationStart, j as MatrxEphemeralConversation, k as MatrxJsonObject, l as MatrxJsonValue, m as MatrxMandateStartRequest, n as MatrxOperationEventsPage, o as MatrxOperationFollowEvent, p as MatrxOperationStatusResponse, q as MatrxOperationsByLinkResponse, r as MatrxRequestScope, s as MatrxRunError, t as MatrxRunHandle, u as MatrxRuntimeExecutionStatus, v as MatrxRuntimeOperationEvent, w as MatrxRuntimeOperationView, x as MatrxStoredConversationContinue, y as MatrxStoredConversationCreate, z as MatrxStreamCallOptions, A as MatrxTurnFields, R as RunAgentToCompletionOptions, T as TERMINAL_MATRX_RUNTIME_STATUSES, B as cancelAgentRun, C as continueAgentConversation, D as continueEphemeralConversationStart, E as continueStoredConversationStart, G as followRuntimeOperationEvents, H as followRuntimeOperationToEnd, I as getRuntimeOperationStatus, J as getRuntimeOperationsByLink, K as listRuntimeOperationEvents, L as mintMatrxConversationId, N as newEphemeralConversationStart, O as newStoredConversationStart, P as rejoinRuntimeOperation, Q as resumeAgentConversation, S as runAgentToCompletion, U as startAgentRun, V as startMandateRun } from './operations-C3iHFcnt.js';
 import '@ai-matrx/data';
 import '@ai-matrx/data/net';
-import './keys.generated-DxG5tgWt.js';
+import './keys.generated-ClN6zfUo.js';
 
 /**
  * Media reference roles — the builder's side of the one vocabulary.
@@ -114,6 +114,8 @@ declare function referenceRoleCaption(role: unknown, name: unknown): string | nu
 /** The minimum variable shape this derivation reads (a superset is fine). */
 interface RunInputVariable {
     name: string;
+    /** What the person called it ("Normal Text") — `name` is the `{{normal_text}}` key. */
+    label?: string | null;
     defaultValue?: unknown;
     helpText?: string | null;
     required?: boolean | null;
@@ -160,14 +162,15 @@ declare function partitionControlVariables<T extends RunInputVariable>(defs: rea
 /** The order every variable form renders in. Returns the same array when already ordered. */
 declare function orderVariablesForForm<T extends RunInputVariable>(defs: T[]): T[];
 /**
- * The label a run form shows for a variable: a media variable that fills a
- * reference role is asked for BY that role ("Style reference"); every other
- * variable keeps its formatted name.
+ * The label every screen shows for a variable: the person's own label
+ * ("Normal Text"), else — for a media variable that fills a reference role —
+ * the role's ask ("Style reference"), else the key through THE humanizer
+ * (`@ai-matrx/kit/text-case` `humanizeIdentifier`). Never the raw key.
  */
-declare function variableRunLabel(variable: RunInputVariable, formatName: (name: string) => string): string;
+declare function variableRunLabel(variable: RunInputVariable, formatName?: (name: string) => string): string;
 /** The hint under / beside a variable: its own help text, else the role's line. */
 declare function variableRunHint(variable: RunInputVariable): string | undefined;
 /** Derive the ordered, grouped, labelled run inputs for an agent's variables. */
-declare function deriveRunInputs<V extends RunInputVariable>(defs: readonly V[] | null | undefined, formatName: (name: string) => string): RunInput<V>[];
+declare function deriveRunInputs<V extends RunInputVariable>(defs: readonly V[] | null | undefined, formatName?: (name: string) => string): RunInput<V>[];
 
 export { AUDIO_REFERENCE_ROLES, type AudioReferenceRole, IMAGE_REFERENCE_ROLES, IMAGE_ROLE_META, type ImageReferenceRole, type ImageRoleLimits, type ImageRoleMeta, type ImageRoleVerdict, type ReferenceRole, type RunInput, type RunInputGroup, type RunInputMediaKind, type RunInputVariable, VIDEO_IMAGE_ROLES, VIDEO_REFERENCE_ROLES, type VideoReferenceRole, deriveRunInputs, imageRoleVerdict, isControlVariable, isImageReferenceRole, isReferenceRole, namedReferenceVerdict, normalizeReferenceName, orderVariablesForForm, partitionControlVariables, readImageRoleLimits, referenceRoleCaption, roleTakesName, rolesFor, variableNameOfImageUrl, variableNameOfMediaUrl, variableRunHint, variableRunLabel };

package/dist/index.js

@@ -3299,6 +3299,7 @@ function referenceRoleCaption(role, name) {
 }
 
 // variables/run-inputs.ts
+import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
 var MEDIA_KINDS = ["image", "video", "audio", "document", "youtube"];
 function isControlVariable(def) {
   return typeof def.control?.key === "string" && def.control.key.length > 0;
@@ -3321,16 +3322,18 @@ function roleOf(variable) {
   const roled = type === "image" || type === "video" || type === "audio";
   return roled && isReferenceRole(role) ? role : null;
 }
-function variableRunLabel(variable, formatName) {
+function variableRunLabel(variable, formatName = humanizeIdentifier) {
+  const own = (variable.label ?? "").trim();
+  if (own !== "") return own;
   const role = roleOf(variable);
-  return role ? IMAGE_ROLE_META[role].ask : formatName(variable.name);
+  return role ? IMAGE_ROLE_META[role].ask : formatName(variable.name) || variable.name;
 }
 function variableRunHint(variable) {
   if (variable.helpText) return variable.helpText;
   const role = roleOf(variable);
   return role ? IMAGE_ROLE_META[role].explanation : void 0;
 }
-function deriveRunInputs(defs, formatName) {
+function deriveRunInputs(defs, formatName = humanizeIdentifier) {
   return orderVariablesForForm([...defs ?? []]).map((variable) => {
     const type = variable.customComponent?.type ?? "textarea";
     const options = variable.customComponent?.options ?? void 0;