@ai-matrx/agents 0.59.211 → 0.59.212

package/CHANGELOG.md

@@ -1,10 +1,25 @@
 # Changelog
 
-## 0.59.211
+## 0.59.212
 
 UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
 Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/matrx-agents/src`.
 
+## 0.59.211
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff bcd75d763a 77dc9ac997 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.210
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 2887f76927 bcd75d763a -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.209
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 1ed8f032c1 2887f76927 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.208
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 4b1a35d58a 1ed8f032c1 -- apps/shared/matrx-agents/src`
@@ -4345,3 +4360,4 @@ byte-identical to v0.6.0). No source changes and no consumer action required.
 - Added strict tests, ESM declarations, packed-artifact validation, and an
   isolated consumer import canary.
 
+

package/dist/content-transfer/index.cjs

@@ -116,6 +116,7 @@ var MANDATE_KEYS = {
   brand_discovery__propose_offering_roles: "brand_discovery.propose_offering_roles",
   brand_discovery__read_self_page: "brand_discovery.read_self_page",
   brand_discovery__room_outside_world: "brand_discovery.room_outside_world",
+  brand_discovery__room_owner: "brand_discovery.room_owner",
   brand_discovery__room_self_description: "brand_discovery.room_self_description",
   brand_intake__asset_gaps: "brand_intake.asset_gaps",
   brand_intake__early_facts: "brand_intake.early_facts",

package/dist/content-transfer/index.js

@@ -93,6 +93,7 @@ var MANDATE_KEYS = {
   brand_discovery__propose_offering_roles: "brand_discovery.propose_offering_roles",
   brand_discovery__read_self_page: "brand_discovery.read_self_page",
   brand_discovery__room_outside_world: "brand_discovery.room_outside_world",
+  brand_discovery__room_owner: "brand_discovery.room_owner",
   brand_discovery__room_self_description: "brand_discovery.room_self_description",
   brand_intake__asset_gaps: "brand_intake.asset_gaps",
   brand_intake__early_facts: "brand_intake.early_facts",

package/dist/content-transfer/react/index.cjs

@@ -69,6 +69,7 @@ var MANDATE_KEYS = {
   brand_discovery__propose_offering_roles: "brand_discovery.propose_offering_roles",
   brand_discovery__read_self_page: "brand_discovery.read_self_page",
   brand_discovery__room_outside_world: "brand_discovery.room_outside_world",
+  brand_discovery__room_owner: "brand_discovery.room_owner",
   brand_discovery__room_self_description: "brand_discovery.room_self_description",
   brand_intake__asset_gaps: "brand_intake.asset_gaps",
   brand_intake__early_facts: "brand_intake.early_facts",

package/dist/content-transfer/react/index.js

@@ -41,6 +41,7 @@ var MANDATE_KEYS = {
   brand_discovery__propose_offering_roles: "brand_discovery.propose_offering_roles",
   brand_discovery__read_self_page: "brand_discovery.read_self_page",
   brand_discovery__room_outside_world: "brand_discovery.room_outside_world",
+  brand_discovery__room_owner: "brand_discovery.room_owner",
   brand_discovery__room_self_description: "brand_discovery.room_self_description",
   brand_intake__asset_gaps: "brand_intake.asset_gaps",
   brand_intake__early_facts: "brand_intake.early_facts",

package/dist/mandates/index.cjs

@@ -47,9 +47,9 @@ module.exports = __toCommonJS(mandates_exports);
 
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "77dc9ac9971e02c1dcd327b31dbf8e6eeba66185",
+  aidreamRevision: "e4cbd9b70fb8eec5f58b13b7484d796808472b4e",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.211",
+  packageVersion: "0.59.212",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -79,6 +79,7 @@ var MANDATE_KEYS = {
   brand_discovery__propose_offering_roles: "brand_discovery.propose_offering_roles",
   brand_discovery__read_self_page: "brand_discovery.read_self_page",
   brand_discovery__room_outside_world: "brand_discovery.room_outside_world",
+  brand_discovery__room_owner: "brand_discovery.room_owner",
   brand_discovery__room_self_description: "brand_discovery.room_self_description",
   brand_intake__asset_gaps: "brand_intake.asset_gaps",
   brand_intake__early_facts: "brand_intake.early_facts",

package/dist/mandates/index.d.cts

@@ -6,10 +6,10 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   77dc9ac9971e02c1dcd327b31dbf8e6eeba66185
+ * aidream revision:   e4cbd9b70fb8eec5f58b13b7484d796808472b4e
  * generator version:  1.0.0
- * package version:    0.59.211
- * active keys:        610
+ * package version:    0.59.212
+ * active keys:        611
  * retiring keys:      5
  *
  * THE IDENTIFIER RULE: every `.` in a key becomes `__`, any character outside
@@ -19,9 +19,9 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "77dc9ac9971e02c1dcd327b31dbf8e6eeba66185";
+    readonly aidreamRevision: "e4cbd9b70fb8eec5f58b13b7484d796808472b4e";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.211";
+    readonly packageVersion: "0.59.212";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -52,6 +52,7 @@ declare const MANDATE_KEYS: {
     readonly brand_discovery__propose_offering_roles: "brand_discovery.propose_offering_roles";
     readonly brand_discovery__read_self_page: "brand_discovery.read_self_page";
     readonly brand_discovery__room_outside_world: "brand_discovery.room_outside_world";
+    readonly brand_discovery__room_owner: "brand_discovery.room_owner";
     readonly brand_discovery__room_self_description: "brand_discovery.room_self_description";
     readonly brand_intake__asset_gaps: "brand_intake.asset_gaps";
     readonly brand_intake__early_facts: "brand_intake.early_facts";

package/dist/mandates/index.d.ts

@@ -6,10 +6,10 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   77dc9ac9971e02c1dcd327b31dbf8e6eeba66185
+ * aidream revision:   e4cbd9b70fb8eec5f58b13b7484d796808472b4e
  * generator version:  1.0.0
- * package version:    0.59.211
- * active keys:        610
+ * package version:    0.59.212
+ * active keys:        611
  * retiring keys:      5
  *
  * THE IDENTIFIER RULE: every `.` in a key becomes `__`, any character outside
@@ -19,9 +19,9 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "77dc9ac9971e02c1dcd327b31dbf8e6eeba66185";
+    readonly aidreamRevision: "e4cbd9b70fb8eec5f58b13b7484d796808472b4e";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.211";
+    readonly packageVersion: "0.59.212";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -52,6 +52,7 @@ declare const MANDATE_KEYS: {
     readonly brand_discovery__propose_offering_roles: "brand_discovery.propose_offering_roles";
     readonly brand_discovery__read_self_page: "brand_discovery.read_self_page";
     readonly brand_discovery__room_outside_world: "brand_discovery.room_outside_world";
+    readonly brand_discovery__room_owner: "brand_discovery.room_owner";
     readonly brand_discovery__room_self_description: "brand_discovery.room_self_description";
     readonly brand_intake__asset_gaps: "brand_intake.asset_gaps";
     readonly brand_intake__early_facts: "brand_intake.early_facts";

package/dist/mandates/index.js

@@ -1,8 +1,8 @@
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "77dc9ac9971e02c1dcd327b31dbf8e6eeba66185",
+  aidreamRevision: "e4cbd9b70fb8eec5f58b13b7484d796808472b4e",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.211",
+  packageVersion: "0.59.212",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -32,6 +32,7 @@ var MANDATE_KEYS = {
   brand_discovery__propose_offering_roles: "brand_discovery.propose_offering_roles",
   brand_discovery__read_self_page: "brand_discovery.read_self_page",
   brand_discovery__room_outside_world: "brand_discovery.room_outside_world",
+  brand_discovery__room_owner: "brand_discovery.room_owner",
   brand_discovery__room_self_description: "brand_discovery.room_self_description",
   brand_intake__asset_gaps: "brand_intake.asset_gaps",
   brand_intake__early_facts: "brand_intake.early_facts",

package/dist/models/index.cjs

@@ -113,6 +113,7 @@ __export(models_exports, {
   requiredArtifacts: () => requiredArtifacts,
   resetSuccessionLogForTests: () => resetSuccessionLogForTests,
   resolveLiveModelId: () => resolveLiveModelId,
+  resolveModelMapKnob: () => resolveModelMapKnob,
   resolveNewAgentModelId: () => resolveNewAgentModelId,
   resolvePreferredModelChoice: () => resolvePreferredModelChoice,
   resolveSuccessor: () => resolveSuccessor,
@@ -2766,7 +2767,7 @@ function cheapestAdequateModel(catalog, need, options = {}) {
 
 // models/default-model.ts
 var NEW_AGENT_DEFAULT_MODEL_KNOB = "agents.model_prefs.new_agent_default_model";
-async function resolveNewAgentModelId(resolveKnob) {
+async function resolveNewAgentModelId(resolveKnob, catalog) {
   let value;
   try {
     value = await resolveKnob(NEW_AGENT_DEFAULT_MODEL_KNOB);
@@ -2775,8 +2776,14 @@ async function resolveNewAgentModelId(resolveKnob) {
       `The model new agents start on (${NEW_AGENT_DEFAULT_MODEL_KNOB}) could not be read, so no agent was created: ${error instanceof Error ? error.message : String(error)}`
     );
   }
-  if (typeof value === "string" && value.trim() !== "") return { modelId: value.trim() };
+  if (typeof value === "string" && value.trim() !== "") return { modelId: await resolveLiveModelId(catalog, value.trim()) };
   throw new Error(
     `No model is set for new agents (${NEW_AGENT_DEFAULT_MODEL_KNOB} is empty for this organization), so no agent was created. Set it in Settings.`
   );
 }
+async function resolveModelMapKnob(value, catalog) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  const entries = Object.entries(value).filter((e) => typeof e[1] === "string" && e[1].trim() !== "");
+  const resolved = await Promise.all(entries.map(async ([k, id]) => [k, await resolveLiveModelId(catalog, id.trim())]));
+  return Object.fromEntries(resolved);
+}

package/dist/models/index.d.cts

@@ -1776,14 +1776,23 @@ declare function cheapestAdequateModel<T extends PricedCatalogModel>(catalog: re
  *
  * It is NOT `agent_authoring_default_model`: that knob is the agent FACTORY's own model.
  *
+ * Every read resolves the knob's id through the catalog's successor chain (`resolveLiveModelId`): a default that
+ * was deprecated with a successor answers its live successor with no knob edit.
+ *
  * No code fallback: an unset or unreadable knob refuses, naming the knob, so nothing is created on a model nobody
  * chose (the knob's platform default makes "unset" an admin act, not a normal state).
  */
+
 declare const NEW_AGENT_DEFAULT_MODEL_KNOB = "agents.model_prefs.new_agent_default_model";
 interface NewAgentModel {
     modelId: string;
 }
 /** The model a new agent starts on. `resolveKnob(fullKey)` is the host's effective-knob read. Throws, naming the knob, when it answers nothing. */
-declare function resolveNewAgentModelId(resolveKnob: (fullKey: string) => Promise<unknown>): Promise<NewAgentModel>;
+declare function resolveNewAgentModelId(resolveKnob: (fullKey: string) => Promise<unknown>, catalog: SuccessionClient): Promise<NewAgentModel>;
+/**
+ * A json knob mapping names to model ids (e.g. `agents.simple_run.capability_models`), each id resolved through the
+ * catalog's successor chain on this read. Non-string entries are dropped; a value that is not an object answers {}.
+ */
+declare function resolveModelMapKnob(value: unknown, catalog: SuccessionClient): Promise<Record<string, string>>;
 
-export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CheapestAdequateOptions, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, type FitCapabilities, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelNeed, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, NEW_AGENT_DEFAULT_MODEL_KNOB, type NewAgentModel, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type PricedCatalogModel, type RankOptions, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type VariantVerdict, type Want, acceptsTextInstructions, blendedPrice, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, cheapestAdequateModel, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsNeed, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isChatModelCapability, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolveNewAgentModelId, resolvePreferredModelChoice, resolveSuccessor, runtimesOnEngine, seesImages, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, takesInput, toAuditRecord, validateModelSet, variantVerdict, withModelClass };
+export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CheapestAdequateOptions, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, type FitCapabilities, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelNeed, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, NEW_AGENT_DEFAULT_MODEL_KNOB, type NewAgentModel, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type PricedCatalogModel, type RankOptions, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type VariantVerdict, type Want, acceptsTextInstructions, blendedPrice, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, cheapestAdequateModel, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsNeed, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isChatModelCapability, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolveModelMapKnob, resolveNewAgentModelId, resolvePreferredModelChoice, resolveSuccessor, runtimesOnEngine, seesImages, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, takesInput, toAuditRecord, validateModelSet, variantVerdict, withModelClass };

package/dist/models/index.d.ts

@@ -1776,14 +1776,23 @@ declare function cheapestAdequateModel<T extends PricedCatalogModel>(catalog: re
  *
  * It is NOT `agent_authoring_default_model`: that knob is the agent FACTORY's own model.
  *
+ * Every read resolves the knob's id through the catalog's successor chain (`resolveLiveModelId`): a default that
+ * was deprecated with a successor answers its live successor with no knob edit.
+ *
  * No code fallback: an unset or unreadable knob refuses, naming the knob, so nothing is created on a model nobody
  * chose (the knob's platform default makes "unset" an admin act, not a normal state).
  */
+
 declare const NEW_AGENT_DEFAULT_MODEL_KNOB = "agents.model_prefs.new_agent_default_model";
 interface NewAgentModel {
     modelId: string;
 }
 /** The model a new agent starts on. `resolveKnob(fullKey)` is the host's effective-knob read. Throws, naming the knob, when it answers nothing. */
-declare function resolveNewAgentModelId(resolveKnob: (fullKey: string) => Promise<unknown>): Promise<NewAgentModel>;
+declare function resolveNewAgentModelId(resolveKnob: (fullKey: string) => Promise<unknown>, catalog: SuccessionClient): Promise<NewAgentModel>;
+/**
+ * A json knob mapping names to model ids (e.g. `agents.simple_run.capability_models`), each id resolved through the
+ * catalog's successor chain on this read. Non-string entries are dropped; a value that is not an object answers {}.
+ */
+declare function resolveModelMapKnob(value: unknown, catalog: SuccessionClient): Promise<Record<string, string>>;
 
-export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CheapestAdequateOptions, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, type FitCapabilities, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelNeed, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, NEW_AGENT_DEFAULT_MODEL_KNOB, type NewAgentModel, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type PricedCatalogModel, type RankOptions, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type VariantVerdict, type Want, acceptsTextInstructions, blendedPrice, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, cheapestAdequateModel, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsNeed, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isChatModelCapability, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolveNewAgentModelId, resolvePreferredModelChoice, resolveSuccessor, runtimesOnEngine, seesImages, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, takesInput, toAuditRecord, validateModelSet, variantVerdict, withModelClass };
+export { type AdminOffering, type AdminPricingBand, type ArtifactUse, type AuditCapabilitiesRecord, CHAT_DEFAULT_MODEL_KNOB, CONTENT_TYPES, type CapabilitiesParseContext, type CatalogKindInput, type CatalogModel, type CatalogTier, type CheapestAdequateOptions, type CompatStatus, type ContentType, type CuratedCatalogClient, type CuratedModel, type CuratedPresentation, type CuratedRows, type CuratedVariant, DEFAULT_CAPABILITIES, type DecidedBy, type DeviceGraphics, type DeviceHardware, type DiscoveryAmbiguity, type DiscoveryArtifact, type DiscoveryMedia, type DiscoveryResult, type DiscoveryRuntime, type DiscoverySource, type DiscoveryVariant, EMPTY_MODEL_RECORDS, EXCLUDED_REVIEW_STATES, FEATURE_BUCKETS, FEATURE_BUCKET_ORDER, FEATURE_KEYS, FILE_TYPE_QUANT, type FeatureBucket, type FeatureBucketMeta, type FeatureKey, type FitCapabilities, GgufError, type GgufHeader, type GgufRead, type GgufTensor, type GroupedFeatures, type HardwareClass, type HardwareClasses, type HeaderFlag, type HeaderJudgement, type HeaderRefusal, INPUT_MODALITIES, INTERACTION_MODES, type Interaction, type InteractionMode, type LocalArtifact, type LocalCatalogClient, type LocalCatalogQuery, type LocalCompatRow, type LocalModel, type LocalModelCatalog, type LocalPresentation, type LocalRuntime, type LocalRuntimeBuild, type LocalVariant, MAX_SUCCESSION_HOPS, MODEL_CATALOG_KINDS, MODEL_FAVORITE_ENTITY_TYPE, type Modality, type ModelCapabilities, type ModelCatalog, type ModelCatalogClient, type ModelCatalogConfig, type ModelCatalogErrorSink, type ModelCatalogPgError, type ModelCatalogPgResult, type ModelCatalogQuery, type ModelCatalogState, type ModelCatalogVariant, type ModelCatalogVariantState, type ModelClassConfig, type ModelClassEntry, type ModelClassIndex, type ModelDiagnosticEntry, type ModelDiagnosticsSink, type ModelFavorites, type ModelFavoritesCache, type ModelFavoritesClient, type ModelFavoritesConfig, type ModelFavoritesErrorSink, type ModelFavoritesState, type ModelFetchScope, type ModelFileHandle, type ModelFit, type ModelIdentityRow, type ModelJson, type ModelNeed, type ModelOfferingRow, type ModelOption, type ModelOptionWithLifecycle, type ModelRecord, type ModelRecordFetchType, type ModelRecords, type ModelRecordsClient, type ModelRecordsConfig, type ModelRecordsState, type ModelSelectionPurpose, type ModelSetEnv, type ModelSetFacts, type ModelSetValidation, NEW_AGENT_DEFAULT_MODEL_KNOB, type NewAgentModel, type NoSelection, OUTPUT_MODALITIES, type OrderedLike, type PreferredModelChoice, type PreferredModelChoicePorts, type PriceTier, type PricedCatalogModel, type RankOptions, type RankedVariant, type ReadModelCatalogOptions, SERVICE_LABEL, SERVICE_LABEL_PLURAL, type SelectDevice, type Selection, type ShardName, type SuccessionClient, type SuccessionIndex, type SuccessionNode, TOP_TIER_COST_RATING, TOP_TIER_LOCKED_TITLE, type VariantDiscovery, type VariantVerdict, type Want, acceptsTextInstructions, blendedPrice, buildModelClassIndex, buildSuccessionIndex, catalogFingerprint, catalogForApp, catalogKindOf, cheapestAdequateModel, classConfigKey, collapseTiersByClass, costRatingTier, costRatingWord, createModelCatalog, createModelFavorites, createModelRecords, curatedList, displayOrderOf, favoriteIdsEqual, fetchCuratedModels, findNonCanonicalCapabilityValues, fitsMemory, fitsNeed, fitsThisComputer, formatMemoryBytes, fromDiscovery, ggufEngine, ggufFacts, groupFeatures, hardwareClassesOf, hasCompatibleDecisionInteraction, isChatModelCapability, isContentType, isConversationalModelCapability, isDecisionModelCapability, isFeatureKey, isHelperGguf, isInteractionMode, isListedVariant, isLocalModelCatalog, isManagedAgentModelCapability, isProjectorName, isSupersedable, isTopTierRating, judgeHeaderFacts, mergeAuditRecordIntoCapabilities, missingShards, modelClassKnobFor, modelClassName, modelClassPinOf, modelsForSelectionPurpose, normalizeArch, normalizeModel, normalizeModels, normalizeOs, normalizePromptSettings, orderCatalogGroups, orderCatalogModels, outputFormatControlKey, parseCapabilities, pickProjector, priceTierRating, quantFromName, rankVariants, readCuratedRows, readGgufHeader, readModelCatalog, reconcileModelFavoriteIds, reportModelDiagnostic, requireCanonicalCapabilities, requiredArtifacts, resetSuccessionLogForTests, resolveLiveModelId, resolveModelMapKnob, resolveNewAgentModelId, resolvePreferredModelChoice, resolveSuccessor, runtimesOnEngine, seesImages, selectActiveModels, selectActiveModelsReady, selectAllModelOptions, selectAllModels, selectAllModelsReady, selectDeprecatedModels, selectDeprecatedModelsReady, selectModelById, selectModelClassConfig, selectModelClassName, selectModelControls, selectModelDetailError, selectModelFetchType, selectModelFullyLoaded, selectModelIdentityById, selectModelIdentityLookupStatus, selectModelLabelById, selectModelLabelWithClass, selectModelNameById, selectModelOptions, selectVariant, serviceCountLabel, setModelDiagnosticsSink, shapeCuratedModels, shardFileName, shardName, speedRatingLabel, speedRatingWord, splitSetProblems, takesInput, toAuditRecord, validateModelSet, variantVerdict, withModelClass };

package/dist/models/index.js

@@ -2609,7 +2609,7 @@ function cheapestAdequateModel(catalog, need, options = {}) {
 
 // models/default-model.ts
 var NEW_AGENT_DEFAULT_MODEL_KNOB = "agents.model_prefs.new_agent_default_model";
-async function resolveNewAgentModelId(resolveKnob) {
+async function resolveNewAgentModelId(resolveKnob, catalog) {
   let value;
   try {
     value = await resolveKnob(NEW_AGENT_DEFAULT_MODEL_KNOB);
@@ -2618,11 +2618,17 @@ async function resolveNewAgentModelId(resolveKnob) {
       `The model new agents start on (${NEW_AGENT_DEFAULT_MODEL_KNOB}) could not be read, so no agent was created: ${error instanceof Error ? error.message : String(error)}`
     );
   }
-  if (typeof value === "string" && value.trim() !== "") return { modelId: value.trim() };
+  if (typeof value === "string" && value.trim() !== "") return { modelId: await resolveLiveModelId(catalog, value.trim()) };
   throw new Error(
     `No model is set for new agents (${NEW_AGENT_DEFAULT_MODEL_KNOB} is empty for this organization), so no agent was created. Set it in Settings.`
   );
 }
+async function resolveModelMapKnob(value, catalog) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  const entries = Object.entries(value).filter((e) => typeof e[1] === "string" && e[1].trim() !== "");
+  const resolved = await Promise.all(entries.map(async ([k, id]) => [k, await resolveLiveModelId(catalog, id.trim())]));
+  return Object.fromEntries(resolved);
+}
 export {
   CHAT_DEFAULT_MODEL_KNOB,
   CONTENT_TYPES,
@@ -2717,6 +2723,7 @@ export {
   requiredArtifacts,
   resetSuccessionLogForTests,
   resolveLiveModelId,
+  resolveModelMapKnob,
   resolveNewAgentModelId,
   resolvePreferredModelChoice,
   resolveSuccessor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.211",
+  "version": "0.59.212",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -508,14 +508,14 @@
   },
   "sideEffects": false,
   "dependencies": {
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
+    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/api": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
-    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/icons": "latest",
-    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/kit": "latest"
   },
   "peerDependencies": {
@@ -561,5 +561,5 @@
     "verify:tarball": "node ./scripts/verify-tarball.mjs",
     "typegen:self-test": "node scripts/typegen/drop-guard.self-test.mjs && node scripts/typegen/check-api-types-fresh.mjs --self-test"
   },
-  "gitHead": "77dc9ac9971e02c1dcd327b31dbf8e6eeba66185"
+  "gitHead": "e4cbd9b70fb8eec5f58b13b7484d796808472b4e"
 }