@stndrds/schema 1.0.0-alpha.345 → 1.0.0-alpha.346

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 
-import { $ as BilateralConfig, $t as indexBy, A as StorageError, An as ComputedDependency, At as StatusGroup, B as isObjectReferencedError, Bn as ComputedFormulaLiteralNode, Bt as OptionPropertyAttribute, C as RepositoryOperation, Cn as assertAcyclicComputedDependencies, Ct as RichTextAttribute, D as SchemaErrorCode, Dn as ComputedFunctionName, Dt as SelectAttribute, E as SchemaError, En as COMPUTED_FUNCTION_NAMES, Et as RollupFunction, F as SystemEntityImmutableError, Fn as ComputedValueType, Ft as inferInverseCardinality, G as BuiltInTransform, Gt as resolvePropertyDefinitions, H as isRecordReferencedError, Hn as ComputedFormulaPathNode, Ht as PropertySchema, I as ValidationError, In as ComputedFormulaAstNode, It as isAttributeSortable, J as ATTRIBUTE_TYPES, Jt as Uuid, K as MigrationDefinition, Kt as TenantId, L as ValidationErrorDetail, Ln as ComputedFormulaBinaryNode, Lt as isBilateralRelation, M as SyncCascadeError, Mn as ComputedOptionsSource, Mt as TimeFormat, N as SyncConflictError, Nn as ComputedPlan, Nt as UserAttribute, O as SchemaPlanNotFoundError, On as ComputedFunctionSignature, Ot as SingleRelationAttribute, P as SyncError, Pn as ComputedReturnType, Pt as UserReferenceType, Q as BaseAttribute, Qt as generateId, R as isAttributeInUseError, Rn as ComputedFormulaBinaryOperator, Rt as isUniversalRelation, S as RepositoryError, Sn as ComputedFormulaCompileError, St as RelationTarget, T as RoleNotFoundError, Tn as COMPUTED_FUNCTIONS, Tt as RollupAttribute, U as isSchemaError, Un as parseComputedFormula, Ut as PropertyType, V as isProtectedResourceError, Vn as ComputedFormulaParseError, Vt as PropertyAttribute, W as isValidationError, Wt as hasOptions, X as AttributeGroup, Xt as asUserId, Y as Attribute, Yt as asTenantId, Z as AttributeType, Zt as deepEqual, _ as ProtectedResourceError, _n as CompileComputedFormulaInput, _t as Option, a as ChangeTypeNotSupportedError, an as COMPUTED_FUNCTION_METADATA, at as DateRangeValue, b as RecordReference, bn as ComputedCompileSchema, bt as RELATION_TARGET_ANY, c as DuplicateError, cn as ComputedFormulaResult, ct as FormulaAttribute, d as MigrationTimeoutError, dn as evaluateComputedFormulaWithResult, dt as LocationAttribute, en as NonJsonValueError, et as CheckboxAttribute, f as NotFoundError, fn as formatComputedResult, ft as LocationGranularity, g as OrphanSystemAttributeError, gn as rollupToFormulaExpression, gt as NumberUnit, h as ObjectReferencedError, hn as inferRollupReturnType, ht as NumberAttribute, i as AttributeUsage, in as serializeStableJson, it as DateFormat, j as StorageOperation, jn as ComputedFieldKind, jt as TextAttribute, k as SearchBackendError, kn as isComputedFunctionName, kt as StatusAttribute, l as ForbiddenError, ln as evaluateComputedAst, lt as FormulaReturnType, m as ObjectNotFoundError, mn as compileRollupAttribute, mt as MultiselectAttribute, n as AttributeInUseError, nn as sameStableValue, nt as CurrencyAttribute, o as ConcurrentModificationError, on as ComputedFunctionCategory, ot as DateValue, p as NotImplementedError, pn as isPlainRecord, pt as MultiRelationAttribute, q as SchemaOperation, qt as UserId, r as AttributeNotFoundError, rn as serializeCanonicalJson, rt as DateAttribute, s as DestructiveSyncNotAllowedError, sn as ComputedFunctionMetadata, st as DocumentAttribute, t as AccessDeniedError, tn as canonicalStringify, tt as Currency, u as MemoryNotFoundError, un as evaluateComputedFormula, ut as Location, v as ProtectedRoleError, vn as ComputedCompileAttribute, vt as Phone, w as ReservedObjectNameError, wn as compileComputedFormula, wt as RichtextAttribute, x as RecordReferencedError, xn as ComputedDependencyGraphNode, xt as RelationAttribute, y as RecordNotFoundError, yn as ComputedCompileObject, yt as PhoneAttribute, z as isNotFoundError, zn as ComputedFormulaCallNode, zt as relationTargetsOf } from "./exceptions-BCfkN2ct.mjs";
-import { $ as RelativeDateValue, A as FormDensity, B as DynamicValue, C as ContentPlacement, D as DocumentsContentDefinition, E as CustomContentDefinition, F as RichtextContentDefinition, G as FilterRule, H as ExtendedFilterRule, I as ViewContentDefinition, J as NO_VALUE_OPERATORS, K as FilterState, L as ViewRead, M as KanbanCollectionContentDefinition, N as ListViewLayout, O as EmailsContentDefinition, P as MeetingsContentDefinition, Q as QueryState, R as CurrencyFilterValue, S as ContentOpenMode, T as ContentViewDefinition, U as FilterCombinator, V as EdgeQuantifier, W as FilterOperator, X as OPERATORS_BY_TYPE, Y as NoValueOperator, Z as PhoneFilterValue, _ as CollectionContentSource, a as displayAttributesSchema, b as ContentField, c as filterStateSchema, d as colorIdSchema, et as SortDirection, f as iconNameSchema, g as CollectionContentDefinition, h as CollectionAction, i as contentViewDefinitionSchemaFor, it as isNoValueOperator, j as FormsContentDefinition, k as FormContentDefinition, l as publishedViewContentDefinitionSchema, m as ActivityContentDefinition, n as columnsSchema, nt as filterOperatorsByTypeForGeneration, o as draftContentViewDefinitionSchema, p as SCHEMA_LIMITS, q as FilterValue, r as contentViewDefinitionSchema, rt as getRollupFilterOperators, s as draftContentViewDefinitionSchemaFor, t as collectionContentSourceSchema, tt as SortRule, u as sortsSchema, v as ColumnReference, w as ContentViewContext, x as ContentFieldGroup, y as ContentCreateMode, z as DayMonthValue } from "./all-DdTEiYEh.mjs";
-import { A as FolderPreset, C as ResourceVisibility, D as parseResourceVisibility, E as Timestamps, M as PresetNode, O as DocumentLayout, S as ReservedObjectName, T as SystemFieldName, _ as ObjectRecord, a as validateDraft, b as RESOURCE_VISIBILITIES, c as validateObjectOrThrow, f as createFormAttributeValidator, g as ObjectDefinition, h as ObjectAttribute, j as MAX_PRESET_DEPTH, k as DocumentLayoutVariant, m as ListViewTabVisibility, o as validateDraftOrThrow, p as LIST_VIEW_TAB_VISIBILITIES, r as rejectUnknownAttributesOrThrow, s as validateObject, v as RESERVED_ATTRIBUTE_NAMES, w as SYSTEM_FIELD_NAMES, x as ReservedAttributeName, y as RESERVED_OBJECT_NAMES } from "./index-Ds0DxPHk.mjs";
-import { S as UpdateObjectInput, _ as statusOptionWriteSchema, b as RelationOption, c as parseAttributeConfigForCreate, d as propertyAttributeWireSchema, f as propertySchemaSchema, g as statusGroupSchema, h as selectOptionWriteSchema, l as parseAttributeConfigForUpdate, m as refuseForeignKeys, n as WIRE_OMITTED_CONFIG_KEYS, o as multiselectOptionWriteSchema, p as propertySchemaWireSchema, r as attributeConfigSchemas, s as parseAttributeConfig, t as SIMPLE_PROPERTY_TYPES, u as propertyAttributeSchema, v as AddAttributeInput, x as RelationOptionsResponse, y as CreateCustomObjectInput } from "./index-_gdqRN1W.mjs";
-import { n as DEFAULT_VALIDATION_MESSAGES, r as ValidationMessages, t as formatZodErrors } from "./index-DzEWbzP-.mjs";
-import { t as createTextValidator } from "./text-CjhjkBXJ.mjs";
-import { t as createNumberValidator } from "./number-U7UMAXKt.mjs";
-import { t as createCheckboxValidator } from "./checkbox-DSzn5epa.mjs";
-import { t as createDateValidator } from "./date-CteDw_88.mjs";
+import { $ as BilateralConfig, $t as indexBy, A as StorageError, An as ComputedDependency, At as StatusGroup, B as isObjectReferencedError, Bn as ComputedFormulaLiteralNode, Bt as OptionPropertyAttribute, C as RepositoryOperation, Cn as assertAcyclicComputedDependencies, Ct as RichTextAttribute, D as SchemaErrorCode, Dn as ComputedFunctionName, Dt as SelectAttribute, E as SchemaError, En as COMPUTED_FUNCTION_NAMES, Et as RollupFunction, F as SystemEntityImmutableError, Fn as ComputedValueType, Ft as inferInverseCardinality, G as BuiltInTransform, Gt as resolvePropertyDefinitions, H as isRecordReferencedError, Hn as ComputedFormulaPathNode, Ht as PropertySchema, I as ValidationError, In as ComputedFormulaAstNode, It as isAttributeSortable, J as ATTRIBUTE_TYPES, Jt as Uuid, K as MigrationDefinition, Kt as TenantId, L as ValidationErrorDetail, Ln as ComputedFormulaBinaryNode, Lt as isBilateralRelation, M as SyncCascadeError, Mn as ComputedOptionsSource, Mt as TimeFormat, N as SyncConflictError, Nn as ComputedPlan, Nt as UserAttribute, O as SchemaPlanNotFoundError, On as ComputedFunctionSignature, Ot as SingleRelationAttribute, P as SyncError, Pn as ComputedReturnType, Pt as UserReferenceType, Q as BaseAttribute, Qt as generateId, R as isAttributeInUseError, Rn as ComputedFormulaBinaryOperator, Rt as isUniversalRelation, S as RepositoryError, Sn as ComputedFormulaCompileError, St as RelationTarget, T as RoleNotFoundError, Tn as COMPUTED_FUNCTIONS, Tt as RollupAttribute, U as isSchemaError, Un as parseComputedFormula, Ut as PropertyType, V as isProtectedResourceError, Vn as ComputedFormulaParseError, Vt as PropertyAttribute, W as isValidationError, Wt as hasOptions, X as AttributeGroup, Xt as asUserId, Y as Attribute, Yt as asTenantId, Z as AttributeType, Zt as deepEqual, _ as ProtectedResourceError, _n as CompileComputedFormulaInput, _t as Option, a as ChangeTypeNotSupportedError, an as COMPUTED_FUNCTION_METADATA, at as DateRangeValue, b as RecordReference, bn as ComputedCompileSchema, bt as RELATION_TARGET_ANY, c as DuplicateError, cn as ComputedFormulaResult, ct as FormulaAttribute, d as MigrationTimeoutError, dn as evaluateComputedFormulaWithResult, dt as LocationAttribute, en as NonJsonValueError, et as CheckboxAttribute, f as NotFoundError, fn as formatComputedResult, ft as LocationGranularity, g as OrphanSystemAttributeError, gn as rollupToFormulaExpression, gt as NumberUnit, h as ObjectReferencedError, hn as inferRollupReturnType, ht as NumberAttribute, i as AttributeUsage, in as serializeStableJson, it as DateFormat, j as StorageOperation, jn as ComputedFieldKind, jt as TextAttribute, k as SearchBackendError, kn as isComputedFunctionName, kt as StatusAttribute, l as ForbiddenError, ln as evaluateComputedAst, lt as FormulaReturnType, m as ObjectNotFoundError, mn as compileRollupAttribute, mt as MultiselectAttribute, n as AttributeInUseError, nn as sameStableValue, nt as CurrencyAttribute, o as ConcurrentModificationError, on as ComputedFunctionCategory, ot as DateValue, p as NotImplementedError, pn as isPlainRecord, pt as MultiRelationAttribute, q as SchemaOperation, qt as UserId, r as AttributeNotFoundError, rn as serializeCanonicalJson, rt as DateAttribute, s as DestructiveSyncNotAllowedError, sn as ComputedFunctionMetadata, st as DocumentAttribute, t as AccessDeniedError, tn as canonicalStringify, tt as Currency, u as MemoryNotFoundError, un as evaluateComputedFormula, ut as Location, v as ProtectedRoleError, vn as ComputedCompileAttribute, vt as Phone, w as ReservedObjectNameError, wn as compileComputedFormula, wt as RichtextAttribute, x as RecordReferencedError, xn as ComputedDependencyGraphNode, xt as RelationAttribute, y as RecordNotFoundError, yn as ComputedCompileObject, yt as PhoneAttribute, z as isNotFoundError, zn as ComputedFormulaCallNode, zt as relationTargetsOf } from "./exceptions-B3WE8Upv.mjs";
+import { $ as RelativeDateValue, A as FormDensity, B as DynamicValue, C as ContentPlacement, D as DocumentsContentDefinition, E as CustomContentDefinition, F as RichtextContentDefinition, G as FilterRule, H as ExtendedFilterRule, I as ViewContentDefinition, J as NO_VALUE_OPERATORS, K as FilterState, L as ViewRead, M as KanbanCollectionContentDefinition, N as ListViewLayout, O as EmailsContentDefinition, P as MeetingsContentDefinition, Q as QueryState, R as CurrencyFilterValue, S as ContentOpenMode, T as ContentViewDefinition, U as FilterCombinator, V as EdgeQuantifier, W as FilterOperator, X as OPERATORS_BY_TYPE, Y as NoValueOperator, Z as PhoneFilterValue, _ as CollectionContentSource, a as displayAttributesSchema, b as ContentField, c as filterStateSchema, d as colorIdSchema, et as SortDirection, f as iconNameSchema, g as CollectionContentDefinition, h as CollectionAction, i as contentViewDefinitionSchemaFor, it as isNoValueOperator, j as FormsContentDefinition, k as FormContentDefinition, l as publishedViewContentDefinitionSchema, m as ActivityContentDefinition, n as columnsSchema, nt as filterOperatorsByTypeForGeneration, o as draftContentViewDefinitionSchema, p as SCHEMA_LIMITS, q as FilterValue, r as contentViewDefinitionSchema, rt as getRollupFilterOperators, s as draftContentViewDefinitionSchemaFor, t as collectionContentSourceSchema, tt as SortRule, u as sortsSchema, v as ColumnReference, w as ContentViewContext, x as ContentFieldGroup, y as ContentCreateMode, z as DayMonthValue } from "./all-72y_keWh.mjs";
+import { A as FolderPreset, C as ResourceVisibility, D as parseResourceVisibility, E as Timestamps, M as PresetNode, O as DocumentLayout, S as ReservedObjectName, T as SystemFieldName, _ as ObjectRecord, a as validateDraft, b as RESOURCE_VISIBILITIES, c as validateObjectOrThrow, f as createFormAttributeValidator, g as ObjectDefinition, h as ObjectAttribute, j as MAX_PRESET_DEPTH, k as DocumentLayoutVariant, m as ListViewTabVisibility, o as validateDraftOrThrow, p as LIST_VIEW_TAB_VISIBILITIES, r as rejectUnknownAttributesOrThrow, s as validateObject, v as RESERVED_ATTRIBUTE_NAMES, w as SYSTEM_FIELD_NAMES, x as ReservedAttributeName, y as RESERVED_OBJECT_NAMES } from "./index-Dib0TdMy.mjs";
+import { S as UpdateObjectInput, _ as statusOptionWriteSchema, b as RelationOption, c as parseAttributeConfigForCreate, d as propertyAttributeWireSchema, f as propertySchemaSchema, g as statusGroupSchema, h as selectOptionWriteSchema, l as parseAttributeConfigForUpdate, m as refuseForeignKeys, n as WIRE_OMITTED_CONFIG_KEYS, o as multiselectOptionWriteSchema, p as propertySchemaWireSchema, r as attributeConfigSchemas, s as parseAttributeConfig, t as SIMPLE_PROPERTY_TYPES, u as propertyAttributeSchema, v as AddAttributeInput, x as RelationOptionsResponse, y as CreateCustomObjectInput } from "./index-BKMp1wdz.mjs";
+import { n as DEFAULT_VALIDATION_MESSAGES, r as ValidationMessages, t as formatZodErrors } from "./index-nzT7sEBR.mjs";
+import { t as createTextValidator } from "./text-CjNrbnmS.mjs";
+import { t as createNumberValidator } from "./number-B52ufFXh.mjs";
+import { t as createCheckboxValidator } from "./checkbox-CpPTW4Qn.mjs";
+import { t as createDateValidator } from "./date-B8W-uBOd.mjs";
 import z, { z as z$1 } from "zod";
 import { ColorId, CountryIso3, CurrencyCode, IconName, MimeType } from "@stndrds/constants";
 import { StandardSchemaV1, StandardSchemaV1 as StandardSchemaV1$1 } from "@standard-schema/spec";
@@ -1113,6 +1113,19 @@ export interface AuditChange {
   /** Resolved labels for newValue array, aligned by index. */
   newLabels?: string[];
 }
+/**
+ * Metadata key of the conversation an entry was written in, stamped by the
+ * runtime on every write that happens during an agent turn. A definition-less
+ * general chat writes as the human — it pins no agent actor — so `actorType`
+ * alone cannot tell such a write from a manual edit (#3782); this key can.
+ */
+export declare const AUDIT_AGENT_SESSION_METADATA_KEY = "agentSessionId";
+/**
+ * Whether an AI wrote this entry: an agent actor did, or a human's own
+ * conversation did on their behalf. The feed wears the AI cue on both; the
+ * human stays the author of the second.
+ */
+export declare function isAgentWrittenAuditEntry(entry: Pick<AuditLogEntry, "actorType" | "metadata">): boolean;
 /**
  * Audit log entry - immutable record of an action
  */
@@ -1423,6 +1436,43 @@ export declare const INFERENCE_SPEEDS: readonly ["standard", "fast"];
 export type InferenceSpeed = (typeof INFERENCE_SPEEDS)[number];
 export declare const INFERENCE_REASONING_OPTIONS: readonly ["none", "minimal", "low", "medium", "high", "xhigh"];
 export type InferenceReasoning = (typeof INFERENCE_REASONING_OPTIONS)[number];
+/** The kinds of work Auto routing classifies a turn into. */
+export declare const AGENT_TASK_KINDS: readonly ["conversation", "writing", "coding", "analysis", "extraction"];
+export type AgentTaskKind = (typeof AGENT_TASK_KINDS)[number];
+/**
+ * How demanding a classified turn is, least to most. A model's authored level
+ * is a ceiling, not a band: qualified for heavy serves light too.
+ */
+export declare const TASK_DEMAND_LEVELS: readonly ["light", "standard", "heavy"];
+export type TaskDemandLevel = (typeof TASK_DEMAND_LEVELS)[number];
+/**
+ * Who picks the model for a turn. `manual` is the default everywhere except a
+ * spawned agent session, which is created in `auto`. Branch on the union
+ * exhaustively; never add an `isAuto` boolean.
+ */
+export declare const INFERENCE_ROUTING_MODES: readonly ["manual", "auto"];
+export type InferenceRouting = (typeof INFERENCE_ROUTING_MODES)[number];
+/**
+ * Which ceiling a routed turn is held to. `interactive` is a root session in
+ * interactive mode — a person is at it, sees the routed model on every reply
+ * and can take the wheel. Everything else is `delegated`: a spawned session,
+ * an inline run, an autonomous root nobody watches.
+ */
+export type RoutingContext = "interactive" | "delegated";
+/** USD per million tokens, one figure per dimension. */
+export interface RoutingPrice {
+  readonly inputPerMillionUsd: number;
+  readonly outputPerMillionUsd: number;
+}
+/**
+ * A bill the client did not choose is a defect, so price gates admission rather
+ * than merely breaking ties. Above these, Auto never routes at all; the model
+ * stays selectable by hand, which returns the decision to the person.
+ *
+ * Declared here, not in the runtime, because `packages/ui` shows which models
+ * Auto may route to with the same numbers. One home, no drift.
+ */
+export declare const ROUTING_PRICE_CEILINGS: Record<RoutingContext, RoutingPrice>;
 /** The only model identity clients may persist. Capabilities always come from the catalogue. */
 export interface ModelReference {
   provider: ProviderName;
@@ -1432,6 +1482,8 @@ export interface ModelReference {
 export interface AgentInferencePreferences {
   speed?: InferenceSpeed;
   reasoning?: InferenceReasoning;
+  /** `auto` lets the router pick the model per turn. Absent means `manual`. */
+  routing?: InferenceRouting;
 }
 /** Durable per-conversation dimensions layered over an agent's inference defaults. */
 export interface AgentSessionInferenceOverrides extends AgentInferencePreferences {
@@ -1445,7 +1497,10 @@ export type SessionInferencePatch = {
   speed?: InferenceSpeed | null;
   reasoning?: InferenceReasoning | null;
   imageModel?: string | null;
+  routing?: InferenceRouting | null;
 };
+/** Every dimension a session patch may carry — the one list the server and the client both apply. */
+export declare const SESSION_INFERENCE_PATCH_KEYS: readonly ["model", "speed", "reasoning", "imageModel", "routing"];
 export interface ModelDefinition extends ModelReference {
   maxTokens?: number;
   /**
@@ -2077,6 +2132,19 @@ export interface AIAvailableModel {
   readonly recommendationRank?: number;
   /** Editorial economical-to-powerful position; never treated as a benchmark. */
   readonly profile?: AIModelProfile;
+  /**
+   * Per task, the highest demand this model is qualified to serve. An absent
+   * entry means Auto never routes that task here; an absent map means Auto
+   * never routes here at all. Routability IS this map — there is no separate
+   * flag that could contradict it.
+   */
+  readonly tasks?: Partial<Record<AgentTaskKind, TaskDemandLevel>>;
+  /**
+   * The non-promotional price, authored when the snapshot's rate is an
+   * introductory one. Routing judges at `max(snapshot, listPricing)` per
+   * dimension, so a stale figure here can only ever be too low.
+   */
+  readonly listPricing?: RoutingPrice;
   /** Canonical per-token decimal strings copied from Vercel AI Gateway. */
   readonly pricing?: AIModelPricing;
   /**
@@ -2349,6 +2417,15 @@ export interface AIChatNotification {
   /** Child's report, unwrapped from the `<subagent_result>` envelope; rendered as markdown. */
   body: string;
 }
+/** How an assistant message's model was chosen, when its turn ran under Auto. */
+export interface AIChatMessageRouting {
+  /** `provider/model` as persisted on the message; the UI resolves the label. */
+  model: string;
+  /** Absent together with `demand` when the router declined and the default ran. */
+  tasks?: readonly AgentTaskKind[];
+  demand?: TaskDemandLevel;
+  reason?: "selected" | "retained" | "fallback";
+}
 /**
  * Chat message for runtime/streaming.
  *
@@ -2391,6 +2468,8 @@ export interface AIChatMessage {
     input: number;
     output: number;
   };
+  /** Present only on an assistant message whose turn ran under Auto. */
+  routing?: AIChatMessageRouting;
 }
 /**
  * Question types supported by the agent
@@ -6934,6 +7013,13 @@ declare class FormulaAttributeBuilder<TName extends string> extends BaseAttribut
    * Set decimal places for number results
    */
   decimals(value: number): this;
+  /**
+   * Set the ISO 4217 code a `number` result renders with (#3419). The value
+   * stays a number and `returnType` stays `"number"`; this only carries the
+   * symbol to the screen — the rollup's `.targetCurrency()` for a formula.
+   * @param code - ISO 4217 code (e.g. "EUR")
+   */
+  currency(code: CurrencyCode): this;
   required(): any;
   optional(): any;
 }
@@ -12393,6 +12479,43 @@ export declare function conversationDisplayTitle(input: ConversationDisplayTitle
 export declare const SCHEMA_SOURCE_ID_PATTERN: RegExp;
 export declare function assertSchemaSourceId(sourceId: string): void;
 //#endregion
+//#region src/utils/routing-price.d.ts
+/**
+ * USD per million tokens for one dimension, judged at the HIGHEST figure the
+ * dimension can cost: the greater of the flat rate and every tier's cost.
+ *
+ * A tiered dimension charges more past a prompt-length threshold, and the
+ * snapshot carries both the flat rate and the tiers side by side. Reading the
+ * flat rate alone would judge a model at its cheapest tier and then bill the
+ * dearer one on a long prompt — a model sitting exactly on the delegated
+ * ceiling at its first tier crosses it by half at its second. The routing
+ * price exists to protect the bill, so it errs high on purpose (D4).
+ *
+ * The result is rounded to the nearest micro-dollar because scaling a per-token
+ * decimal by a million is a binary-float operation: `0.0000004 * 1e6` is
+ * `0.39999999999999997`, which no catalogue ever charges. Rounding below the
+ * smallest figure any provider publishes keeps the arithmetic exact where it is
+ * read — comparisons, ordering and the displayed price — without inventing
+ * precision.
+ */
+export declare function pricePerMillion(dimension: AIModelPriceDimension | undefined): number | undefined;
+/**
+ * The price routing judges a model at: per dimension, the greater of the rate
+ * the turn will be billed at (`pricing.fast` when Fast is asked for and
+ * priced, else the base) and the authored list price.
+ *
+ * Taking the maximum makes the rule self-correcting. While a promotion runs,
+ * the authored figure wins and the model is judged at what it will cost
+ * later. Once a snapshot refresh raises the base, the snapshot wins and the
+ * authored figure becomes inert rather than wrong. `undefined` when the
+ * snapshot has no price at all: an unknown price is not a low price.
+ */
+export declare function routingPrice(model: Pick<AIAvailableModel, "pricing" | "listPricing">, speed: InferenceSpeed): RoutingPrice | undefined;
+/** Both dimensions at or under the ceiling. An unknown price never passes. */
+export declare function isUnderRoutingCeiling(price: RoutingPrice | undefined, ceiling: RoutingPrice): boolean;
+/** Routability is the presence of at least one task entry, nothing else. */
+export declare function isRoutableModel(model: Pick<AIAvailableModel, "tasks">): boolean;
+//#endregion
 //#region src/types/schema-plan.d.ts
 /** An attribute to add to an object that already exists, or is created in the same plan. */
 export interface PlannedAttribute {
@@ -13014,8 +13137,8 @@ export declare const providerNameSchema: z$1.ZodEnum<{
   zai: "zai";
 }>;
 export declare const inferenceSpeedSchema: z$1.ZodEnum<{
-  fast: "fast";
   standard: "standard";
+  fast: "fast";
 }>;
 export declare const inferenceReasoningSchema: z$1.ZodEnum<{
   none: "none";
@@ -13025,6 +13148,10 @@ export declare const inferenceReasoningSchema: z$1.ZodEnum<{
   high: "high";
   xhigh: "xhigh";
 }>;
+export declare const inferenceRoutingSchema: z$1.ZodEnum<{
+  manual: "manual";
+  auto: "auto";
+}>;
 export declare const modelReferenceSchema: z$1.ZodObject<{
   provider: z$1.ZodEnum<{
     openai: "openai";
@@ -13043,8 +13170,8 @@ export declare const modelReferenceSchema: z$1.ZodObject<{
 }, z$1.core.$strict>;
 export declare const agentInferencePreferencesSchema: z$1.ZodObject<{
   speed: z$1.ZodOptional<z$1.ZodEnum<{
-    fast: "fast";
     standard: "standard";
+    fast: "fast";
   }>>;
   reasoning: z$1.ZodOptional<z$1.ZodEnum<{
     none: "none";
@@ -13054,6 +13181,10 @@ export declare const agentInferencePreferencesSchema: z$1.ZodObject<{
     high: "high";
     xhigh: "xhigh";
   }>>;
+  routing: z$1.ZodOptional<z$1.ZodEnum<{
+    manual: "manual";
+    auto: "auto";
+  }>>;
 }, z$1.core.$strict>;
 /** Syntax only; availability is checked by the dedicated server catalogue. */
 export declare const imageModelIdSchema: z$1.ZodString;
@@ -13075,8 +13206,8 @@ export declare const agentSessionInferenceOverridesInputSchema: z$1.ZodObject<{
     model: z$1.ZodString;
   }, z$1.core.$strict>>;
   speed: z$1.ZodOptional<z$1.ZodEnum<{
-    fast: "fast";
     standard: "standard";
+    fast: "fast";
   }>>;
   reasoning: z$1.ZodOptional<z$1.ZodEnum<{
     none: "none";
@@ -13087,6 +13218,10 @@ export declare const agentSessionInferenceOverridesInputSchema: z$1.ZodObject<{
     xhigh: "xhigh";
   }>>;
   imageModel: z$1.ZodOptional<z$1.ZodString>;
+  routing: z$1.ZodOptional<z$1.ZodEnum<{
+    manual: "manual";
+    auto: "auto";
+  }>>;
 }, z$1.core.$strict>;
 export declare const agentSessionInferenceOverridesSchema: z$1.ZodObject<{
   model: z$1.ZodOptional<z$1.ZodObject<{
@@ -13106,8 +13241,8 @@ export declare const agentSessionInferenceOverridesSchema: z$1.ZodObject<{
     model: z$1.ZodString;
   }, z$1.core.$strict>>;
   speed: z$1.ZodOptional<z$1.ZodEnum<{
-    fast: "fast";
     standard: "standard";
+    fast: "fast";
   }>>;
   reasoning: z$1.ZodOptional<z$1.ZodEnum<{
     none: "none";
@@ -13118,6 +13253,10 @@ export declare const agentSessionInferenceOverridesSchema: z$1.ZodObject<{
     xhigh: "xhigh";
   }>>;
   imageModel: z$1.ZodOptional<z$1.ZodString>;
+  routing: z$1.ZodOptional<z$1.ZodEnum<{
+    manual: "manual";
+    auto: "auto";
+  }>>;
 }, z$1.core.$strict>;
 export declare const sessionInferencePatchSchema: z$1.ZodObject<{
   model: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
@@ -13137,8 +13276,8 @@ export declare const sessionInferencePatchSchema: z$1.ZodObject<{
     model: z$1.ZodString;
   }, z$1.core.$strict>>>;
   speed: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodEnum<{
-    fast: "fast";
     standard: "standard";
+    fast: "fast";
   }>>>;
   reasoning: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodEnum<{
     none: "none";
@@ -13149,7 +13288,47 @@ export declare const sessionInferencePatchSchema: z$1.ZodObject<{
     xhigh: "xhigh";
   }>>>;
   imageModel: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
+  routing: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodEnum<{
+    manual: "manual";
+    auto: "auto";
+  }>>>;
 }, z$1.core.$strict>;
+/**
+ * The slice of an assistant message's `metadata.inference` the chat reads to
+ * say what answered. Non-strict on purpose: `speed` and `warnings` ride along
+ * and are dropped, and only a turn that ran under Auto carries `routing`.
+ */
+export declare const routedMessageInferenceSchema: z$1.ZodObject<{
+  model: z$1.ZodString;
+  routing: z$1.ZodObject<{
+    mode: z$1.ZodLiteral<"auto">;
+    tasks: z$1.ZodOptional<z$1.ZodArray<z$1.ZodEnum<{
+      conversation: "conversation";
+      writing: "writing";
+      coding: "coding";
+      analysis: "analysis";
+      extraction: "extraction";
+    }>>>;
+    demand: z$1.ZodOptional<z$1.ZodEnum<{
+      standard: "standard";
+      light: "light";
+      heavy: "heavy";
+    }>>;
+    reason: z$1.ZodOptional<z$1.ZodEnum<{
+      selected: "selected";
+      retained: "retained";
+      fallback: "fallback";
+    }>>;
+    relation: z$1.ZodOptional<z$1.ZodEnum<{
+      unknown: "unknown";
+      continue: "continue";
+      aside: "aside";
+      new: "new";
+      modify: "modify";
+    }>>;
+    anchorMessageId: z$1.ZodOptional<z$1.ZodString>;
+  }, z$1.core.$strip>;
+}, z$1.core.$strip>;
 export declare const toolImpactSchema: z$1.ZodObject<{
   label: z$1.ZodString;
   denied: z$1.ZodOptional<z$1.ZodBoolean>;
@@ -14001,6 +14180,21 @@ export declare function catalogTextModelSchema(id: string, free: boolean): z$1.Z
     character: "character";
     word: "word";
   }>>;
+  tasks: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodEnum<{
+    conversation: "conversation";
+    writing: "writing";
+    coding: "coding";
+    analysis: "analysis";
+    extraction: "extraction";
+  }> & z$1.core.$partial, z$1.ZodEnum<{
+    standard: "standard";
+    light: "light";
+    heavy: "heavy";
+  }>>>;
+  listPricing: z$1.ZodOptional<z$1.ZodObject<{
+    inputPerMillionUsd: z$1.ZodNumber;
+    outputPerMillionUsd: z$1.ZodNumber;
+  }, z$1.core.$strip>>;
 }, z$1.core.$loose>;
 /**
  * `id` is handed whole to `gateway.imageModel(...)`, so it is bounded twice: