@athenaintel/react 0.32.0 → 0.36.0

package/dist/catalog/agent-mode-menu.js

@@ -0,0 +1,115 @@
+const BASE_MODE_ID = "base";
+const WEB_ENTRY = "web";
+const MAX_MODE_KEY_LENGTH = 64;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isModeKey = (value) => typeof value === "string" && value.length > 0 && value.length <= MAX_MODE_KEY_LENGTH;
+const decoded = (value) => {
+  if (typeof value !== "string") return value;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+};
+const uniqueKeys = (value) => {
+  const kept = [];
+  if (Array.isArray(value)) {
+    for (const entry of value) {
+      if (isModeKey(entry) && !kept.includes(entry)) kept.push(entry);
+    }
+  }
+  return kept;
+};
+function publishedAgentModeSource(athenaMetadata) {
+  if (!isRecord(athenaMetadata) || !athenaMetadata.published_version_id) return null;
+  const config = athenaMetadata.published_config;
+  if (!isRecord(config)) return null;
+  const agentModes = decoded(config.agentModes);
+  const stored = isRecord(agentModes) ? agentModes : {};
+  const startModes = {};
+  if (isRecord(stored.startModes)) {
+    for (const [channel, mode] of Object.entries(stored.startModes)) {
+      if (isModeKey(channel) && isModeKey(mode)) startModes[channel] = mode;
+    }
+  }
+  const switchModes = {};
+  if (isRecord(stored.switchModes)) {
+    for (const [channel, targets] of Object.entries(stored.switchModes)) {
+      const kept = uniqueKeys(targets);
+      if (isModeKey(channel) && kept.length > 0) switchModes[channel] = kept;
+    }
+  }
+  const channels = {};
+  const customChannels = decoded(config.customChannels);
+  if (Array.isArray(customChannels)) {
+    for (const entry of customChannels) {
+      if (!isRecord(entry) || !isModeKey(entry.id) || entry.id in channels) continue;
+      const name = typeof entry.name === "string" ? entry.name.trim() : "";
+      channels[entry.id] = { label: name || entry.id, enabled: entry.enabled !== false };
+    }
+  }
+  return {
+    modes: uniqueKeys(stored.modes).filter((id) => id !== BASE_MODE_ID),
+    startModes,
+    switchModes,
+    lockedChannels: uniqueKeys(stored.lockedChannels),
+    channels
+  };
+}
+function agentModeEntry({
+  source,
+  channel
+}) {
+  return channel && isCustomEntry({ source, channel }) ? channel : WEB_ENTRY;
+}
+const isCustomEntry = ({ source, channel }) => channel !== BASE_MODE_ID && !source.modes.includes(channel) && channel in source.channels;
+function agentModeOfChannel({
+  source,
+  channel
+}) {
+  return isCustomEntry({ source, channel }) ? source.startModes[channel] ?? channel : channel;
+}
+const optionLabel = ({ source, id }) => {
+  var _a;
+  return id === BASE_MODE_ID ? "Default" : ((_a = source.channels[id]) == null ? void 0 : _a.label) ?? id;
+};
+function agentModeMenu({
+  source,
+  channel,
+  hostModes
+}) {
+  var _a;
+  const entry = agentModeEntry({ source, channel });
+  const startModeId = source.startModes[entry] ?? (entry === WEB_ENTRY ? BASE_MODE_ID : entry);
+  const ownMode = channel && agentModeOfChannel({ source, channel }) === channel ? [channel] : [];
+  const offered = /* @__PURE__ */ new Set([startModeId, ...ownMode, ...source.switchModes[entry] ?? []]);
+  const options = [];
+  for (const id of hostModes) {
+    if (!offered.has(id) || options.some((option) => option.id === id)) continue;
+    if (id !== BASE_MODE_ID && ((_a = source.channels[id]) == null ? void 0 : _a.enabled) === false) continue;
+    options.push({ id, label: optionLabel({ source, id }) });
+  }
+  return {
+    entry,
+    startModeId,
+    firstSendModeId: channel ? agentModeOfChannel({ source, channel }) : startModeId,
+    options,
+    locked: source.lockedChannels.includes(entry)
+  };
+}
+function sessionChannelFromMetadata(athenaMetadata) {
+  if (!isRecord(athenaMetadata)) return null;
+  const current = athenaMetadata.collab_current_channel_id;
+  if (isModeKey(current)) return current;
+  const stamp = athenaMetadata.collab_channel_id;
+  return isModeKey(stamp) ? stamp : null;
+}
+export {
+  BASE_MODE_ID,
+  agentModeEntry,
+  agentModeMenu,
+  agentModeOfChannel,
+  publishedAgentModeSource,
+  sessionChannelFromMetadata
+};
+//# sourceMappingURL=agent-mode-menu.js.map

package/dist/catalog/agent-mode-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-mode-menu.js","sources":["../../src/catalog/agent-mode-menu.ts"],"sourcesContent":["/**\n * A collab agent's mode menu for an SDK chat, from its published definition.\n *\n * A chat offers the modes a session entered through its channel may run in,\n * by the rule agora checks every switch with (`resolve_mode_switch`): the\n * channel's start mode, the channel itself, and the modes the agent's author\n * lists for it (`agentModes.switchModes[<entry>]`). A channel the author\n * locks (`agentModes.lockedChannels`) keeps each session in the mode it\n * starts in: people pick the mode before a session's first message, and it\n * stays. A custom channel that is not itself a mode is its own entry; no\n * channel, a mode or a built-in channel is the Default (Text) entry (`web`).\n *\n * The host lists which of those modes its menu shows (`AthenaProvider`'s\n * `modes`); a mode the agent does not offer there is left out, never sent.\n *\n * Pure, for `useAthenaChatMode` and the tests.\n */\n\n/** The id of the agent as configured, with no mode's overrides (agora's `base`). */\nexport const BASE_MODE_ID = 'base';\n\n/** The Default (Text) entry: chats that name no custom channel of their own. */\nconst WEB_ENTRY = 'web';\n\n/** agora's limit on a mode key's length (`_MAX_MODE_KEY_LENGTH`). */\nconst MAX_MODE_KEY_LENGTH = 64;\n\n/** What an agent's published definition says about its modes. */\nexport interface AgentModeSource {\n  /** Custom channels the author marked as modes (`agentModes.modes`). */\n  modes: readonly string[];\n  /** Channel key → the mode its sessions start in (`agentModes.startModes`). */\n  startModes: Readonly<Record<string, string>>;\n  /** Entry channel key → the modes its sessions may switch to (`agentModes.switchModes`). */\n  switchModes: Readonly<Record<string, readonly string[]>>;\n  /** Entry channels that keep each session in its start mode (`agentModes.lockedChannels`). */\n  lockedChannels: readonly string[];\n  /** The agent's custom channels by id (`customChannels`). */\n  channels: Readonly<Record<string, { label: string; enabled: boolean }>>;\n}\n\n/** One mode a chat may run in. */\nexport interface AthenaChatModeOption {\n  /** What a send names as `collab_channel_id`: `base` or a mode's id. */\n  id: string;\n  /** The author's name for it (`Default` for `base`). */\n  label: string;\n}\n\n/** The mode menu of a chat on one channel of an agent. */\nexport interface AgentModeMenu {\n  /** The entry channel its sessions are judged by (`web` for the Default (Text) entry). */\n  entry: string;\n  /** The mode a session of the entry starts in. */\n  startModeId: string;\n  /** The mode a new chat's first send runs in when nobody picks one: the\n   *  entry's start mode, or the channel itself when it names a mode. */\n  firstSendModeId: string;\n  /** The modes the host listed that the agent offers there, in the host's order. */\n  options: readonly AthenaChatModeOption[];\n  /** The channel keeps each session in the mode it starts in. */\n  locked: boolean;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst isModeKey = (value: unknown): value is string =>\n  typeof value === 'string' && value.length > 0 && value.length <= MAX_MODE_KEY_LENGTH;\n\n/** A stored JSON field: the live doc keeps it as a string, the caches decoded. */\nconst decoded = (value: unknown): unknown => {\n  if (typeof value !== 'string') return value;\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return value;\n  }\n};\n\nconst uniqueKeys = (value: unknown): string[] => {\n  const kept: string[] = [];\n  if (Array.isArray(value)) {\n    for (const entry of value) {\n      if (isModeKey(entry) && !kept.includes(entry)) kept.push(entry);\n    }\n  }\n  return kept;\n};\n\n/**\n * What an agent's published definition (`athenaMetadata.published_config`)\n * says about its modes, read as leniently as agora reads it\n * (`parse_agent_modes`, `parse_custom_channels`): malformed parts are dropped.\n * `null` for an agent never published.\n */\nexport function publishedAgentModeSource(athenaMetadata: unknown): AgentModeSource | null {\n  if (!isRecord(athenaMetadata) || !athenaMetadata.published_version_id) return null;\n  const config = athenaMetadata.published_config;\n  if (!isRecord(config)) return null;\n  const agentModes = decoded(config.agentModes);\n  const stored = isRecord(agentModes) ? agentModes : {};\n  const startModes: Record<string, string> = {};\n  if (isRecord(stored.startModes)) {\n    for (const [channel, mode] of Object.entries(stored.startModes)) {\n      if (isModeKey(channel) && isModeKey(mode)) startModes[channel] = mode;\n    }\n  }\n  const switchModes: Record<string, string[]> = {};\n  if (isRecord(stored.switchModes)) {\n    for (const [channel, targets] of Object.entries(stored.switchModes)) {\n      const kept = uniqueKeys(targets);\n      if (isModeKey(channel) && kept.length > 0) switchModes[channel] = kept;\n    }\n  }\n  const channels: Record<string, { label: string; enabled: boolean }> = {};\n  const customChannels = decoded(config.customChannels);\n  if (Array.isArray(customChannels)) {\n    for (const entry of customChannels) {\n      if (!isRecord(entry) || !isModeKey(entry.id) || entry.id in channels) continue;\n      const name = typeof entry.name === 'string' ? entry.name.trim() : '';\n      channels[entry.id] = { label: name || entry.id, enabled: entry.enabled !== false };\n    }\n  }\n  return {\n    modes: uniqueKeys(stored.modes).filter((id) => id !== BASE_MODE_ID),\n    startModes,\n    switchModes,\n    lockedChannels: uniqueKeys(stored.lockedChannels),\n    channels,\n  };\n}\n\n/**\n * The entry a session on `channel` is judged by (agora `session_entry_channel`):\n * one of the agent's custom channels that is not a mode, else the Default\n * (Text) entry.\n */\nexport function agentModeEntry({\n  source,\n  channel,\n}: {\n  source: AgentModeSource;\n  channel: string | null;\n}): string {\n  return channel && isCustomEntry({ source, channel }) ? channel : WEB_ENTRY;\n}\n\nconst isCustomEntry = ({ source, channel }: { source: AgentModeSource; channel: string }) =>\n  channel !== BASE_MODE_ID && !source.modes.includes(channel) && channel in source.channels;\n\n/**\n * The mode a run on `channel` runs in, as agora compiles it: a custom entry\n * channel follows its start mode even when a send names it, while `base`, a\n * mode or a built-in channel runs its own layer.\n */\nexport function agentModeOfChannel({\n  source,\n  channel,\n}: {\n  source: AgentModeSource;\n  channel: string;\n}): string {\n  return isCustomEntry({ source, channel }) ? (source.startModes[channel] ?? channel) : channel;\n}\n\nconst optionLabel = ({ source, id }: { source: AgentModeSource; id: string }): string =>\n  id === BASE_MODE_ID ? 'Default' : (source.channels[id]?.label ?? id);\n\n/**\n * The menu of a chat on `channel` (the provider's `channel`, `null` for none)\n * that lists `hostModes`: the modes the agent offers its entry — its start\n * mode, the channel itself (unless naming it runs that start mode), its switch\n * list — that the host listed, in the host's order, without a mode that is\n * switched off.\n */\nexport function agentModeMenu({\n  source,\n  channel,\n  hostModes,\n}: {\n  source: AgentModeSource;\n  channel: string | null;\n  hostModes: readonly string[];\n}): AgentModeMenu {\n  const entry = agentModeEntry({ source, channel });\n  const startModeId = source.startModes[entry] ?? (entry === WEB_ENTRY ? BASE_MODE_ID : entry);\n  // A custom entry channel that starts in another mode runs that mode when\n  // named, so it is no option of its own.\n  const ownMode = channel && agentModeOfChannel({ source, channel }) === channel ? [channel] : [];\n  const offered = new Set([startModeId, ...ownMode, ...(source.switchModes[entry] ?? [])]);\n  const options: AthenaChatModeOption[] = [];\n  for (const id of hostModes) {\n    if (!offered.has(id) || options.some((option) => option.id === id)) continue;\n    if (id !== BASE_MODE_ID && source.channels[id]?.enabled === false) continue;\n    options.push({ id, label: optionLabel({ source, id }) });\n  }\n  return {\n    entry,\n    startModeId,\n    firstSendModeId: channel ? agentModeOfChannel({ source, channel }) : startModeId,\n    options,\n    locked: source.lockedChannels.includes(entry),\n  };\n}\n\n/**\n * The channel agora reads as a session's current one, from its session\n * asset's metadata: the mode it last switched to or started in\n * (`collab_current_channel_id`), else its channel stamp (`collab_channel_id`).\n * A send that names it continues the session without switching it; the mode\n * it runs in is {@link agentModeOfChannel} of it. `null` when neither is set.\n */\nexport function sessionChannelFromMetadata(athenaMetadata: unknown): string | null {\n  if (!isRecord(athenaMetadata)) return null;\n  const current = athenaMetadata.collab_current_channel_id;\n  if (isModeKey(current)) return current;\n  const stamp = athenaMetadata.collab_channel_id;\n  return isModeKey(stamp) ? stamp : null;\n}\n"],"names":[],"mappings":"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"}

package/dist/catalog/agent-model-options.cjs

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const statewireRunConfig = require("../runtime/statewire-run-config.cjs");
+function allowsAnyModel(value) {
+  return value !== false;
+}
+const LEGACY_DEFAULT_ENTRY_ID = "default";
+const LEGACY_DEFAULT_ENTRY_LABEL = "Default";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const nonBlank = (value) => typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+function agentAssetIdOf(agent) {
+  const trimmed = nonBlank(agent);
+  if (trimmed === null) return null;
+  return statewireRunConfig.parseCollabAgentRef(trimmed) ?? (trimmed.includes(":") ? null : trimmed);
+}
+function labeledModelsOf(value) {
+  let rows = value;
+  if (typeof rows === "string") {
+    try {
+      rows = JSON.parse(rows);
+    } catch {
+      return [];
+    }
+  }
+  if (!Array.isArray(rows)) return [];
+  const entries = [];
+  for (const row of rows) {
+    if (!isRecord(row)) continue;
+    const model = nonBlank(row.model);
+    if (model === null) continue;
+    entries.push({
+      id: typeof row.id === "string" && row.id !== "" ? row.id : model,
+      model,
+      label: nonBlank(row.label) ?? model,
+      isDefault: row.isDefault === true
+    });
+  }
+  return entries;
+}
+function channelModelsOf(value) {
+  if (!isRecord(value)) return {};
+  const out = {};
+  for (const [channel, override] of Object.entries(value)) {
+    const model = isRecord(override) ? nonBlank(override.model) : null;
+    if (model !== null) out[channel] = model;
+  }
+  return out;
+}
+function isPublishedAgent(athenaMetadata) {
+  if (!isRecord(athenaMetadata)) return false;
+  const versionId = athenaMetadata.published_version_id;
+  return typeof versionId === "string" && versionId !== "" || typeof versionId === "number" && Number.isFinite(versionId);
+}
+function publishedAgentModelSource(athenaMetadata) {
+  if (!isRecord(athenaMetadata) || !isPublishedAgent(athenaMetadata)) return null;
+  const config = athenaMetadata.published_config;
+  if (!isRecord(config)) return null;
+  const source = {
+    model: nonBlank(config.model),
+    models: labeledModelsOf(config.models),
+    channelModels: channelModelsOf(config.channelOverrides),
+    // The editor stores the field name; agora also accepts its snake-case alias.
+    allowAnyModel: allowsAnyModel(
+      Object.hasOwn(config, "allowAnyModel") ? config.allowAnyModel : config.allow_any_model
+    )
+  };
+  const namesAModel = source.model !== null || source.models.length > 0 || Object.keys(source.channelModels).length > 0;
+  return namesAModel ? source : null;
+}
+function isAutomaticModelLabel({
+  entry,
+  modelLabel
+}) {
+  const label = entry.label.trim();
+  if (label === "") return true;
+  if (entry.id === LEGACY_DEFAULT_ENTRY_ID && label === LEGACY_DEFAULT_ENTRY_LABEL) return true;
+  return label === entry.model || label === modelLabel(entry.model);
+}
+function agentDefaultModel({
+  source,
+  channel
+}) {
+  const marked = source.models.find((entry) => entry.isDefault) ?? source.models[0];
+  return (channel ? source.channelModels[channel] : void 0) ?? source.model ?? (marked == null ? void 0 : marked.model) ?? null;
+}
+function buildAgentModelOptions({
+  source,
+  channel,
+  pinnedModel,
+  modelLabel
+}) {
+  const options = [];
+  const add = (model, label) => {
+    if (options.some((option) => option.model === model)) return;
+    options.push({ model, label, isDefault: false, pinnedOutside: false });
+  };
+  for (const entry of source.models) {
+    add(
+      entry.model,
+      isAutomaticModelLabel({ entry, modelLabel }) ? modelLabel(entry.model) : entry.label.trim()
+    );
+  }
+  if (options.length === 0 && source.model !== null) add(source.model, modelLabel(source.model));
+  const defaultModel = agentDefaultModel({ source, channel });
+  if (defaultModel !== null) {
+    add(defaultModel, modelLabel(defaultModel));
+    for (const option of options) option.isDefault = option.model === defaultModel;
+  }
+  const pinned = nonBlank(pinnedModel);
+  if (pinned !== null && !options.some((option) => option.model === pinned)) {
+    options.push({ model: pinned, label: modelLabel(pinned), isDefault: false, pinnedOutside: true });
+  }
+  return { options, defaultModel };
+}
+exports.agentAssetIdOf = agentAssetIdOf;
+exports.agentDefaultModel = agentDefaultModel;
+exports.allowsAnyModel = allowsAnyModel;
+exports.buildAgentModelOptions = buildAgentModelOptions;
+exports.isAutomaticModelLabel = isAutomaticModelLabel;
+exports.isPublishedAgent = isPublishedAgent;
+exports.publishedAgentModelSource = publishedAgentModelSource;
+//# sourceMappingURL=agent-model-options.cjs.map

package/dist/catalog/agent-model-options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-model-options.cjs","sources":["../../src/catalog/agent-model-options.ts"],"sourcesContent":["import { parseCollabAgentRef } from '../runtime/statewire-run-config';\n\n/**\n * A collab agent's own model choices, from its published definition: exactly\n * the models its author listed (the agent editor's Models section), the\n * default marked. The rules are Athena's own composer's (Olympus) and the\n * Jevin app's, so every host offers the same choices for one agent:\n *\n * - the options are the agent's labeled models, by the author's labels; an\n *   automatic name (empty, the editor's old `{ id: 'default', label: 'Default' }`,\n *   or one that only restates the model) shows the model's catalog label;\n * - a legacy agent with no labeled list offers its single `model`;\n * - the session channel's model override (`channelOverrides[channel].model`)\n *   is that channel's default, added when the list lacks it;\n * - a model the thread pins that is none of the agent's models is shown as it\n *   is (`pinnedOutside`), never replaced.\n *\n * Restricting a picker to these choices is opt-in per agent: only an agent\n * whose \"Allow any workspace model\" switch is off (`allowAnyModel: false`)\n * does; every other agent keeps the workspace's models.\n *\n * Pure, for `useAthenaAgentModelOptions` and the tests.\n */\n\n/** One model choice of a collab agent. */\nexport interface AthenaAgentModelOption {\n  /** The model id a send carries (`model`). */\n  model: string;\n  /** The author's label, or the model's catalog label for an automatic name. */\n  label: string;\n  /** The model the thread runs while it pins none (the agent's own, or its channel's). */\n  isDefault: boolean;\n  /**\n   * A model the thread's server config pins that is none of the agent's models\n   * (pinned by another client, or by an older picker): shown, never replaced.\n   */\n  pinnedOutside: boolean;\n}\n\n/** One entry of the agent's labeled model list. */\nexport interface AgentLabeledModel {\n  id: string;\n  model: string;\n  label: string;\n  isDefault: boolean;\n}\n\n/** What an agent's published definition says about its models. */\nexport interface AgentModelSource {\n  /** The model the definition runs (`config.model`); `null` when it names none. */\n  model: string | null;\n  /** The labeled list (`config.models`), complete rows only, in the author's order. */\n  models: readonly AgentLabeledModel[];\n  /** Per-channel model overrides (`channelOverrides[<channel>].model`), by channel id. */\n  channelModels: Readonly<Record<string, string>>;\n  /**\n   * Whether people may pick any workspace model (`config.allowAnyModel`, the\n   * agent editor's \"Allow any workspace model\" switch; see\n   * {@link allowsAnyModel}). Only `false` restricts a picker to the agent's\n   * own models.\n   */\n  allowAnyModel: boolean;\n}\n\n/**\n * Whether a config's `allowAnyModel` value lets people pick any model: only an\n * explicit `false` restricts; absent, `null`, `true` and any non-boolean allow\n * (agora's `collab_agent_allows_any_model`), so every agent saved before the\n * switch existed behaves as it always has.\n */\nexport function allowsAnyModel(value: unknown): boolean {\n  return value !== false;\n}\n\n/** The display label of a model id; the id itself when the catalog does not know it. */\nexport type ModelLabelOf = (model: string) => string;\n\n/** The row the agent editor used to create for an agent with no stored entries. */\nconst LEGACY_DEFAULT_ENTRY_ID = 'default';\nconst LEGACY_DEFAULT_ENTRY_LABEL = 'Default';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst nonBlank = (value: unknown): string | null =>\n  typeof value === 'string' && value.trim() !== '' ? value.trim() : null;\n\n/**\n * The collab agent's asset id for an `agent` value: a `collab_agent:<id>` ref\n * (the provider's `agent` shape) or the bare asset id (the agent picker's\n * value). `null` for a blank value.\n */\nexport function agentAssetIdOf(agent: string | null | undefined): string | null {\n  const trimmed = nonBlank(agent);\n  if (trimmed === null) return null;\n  return parseCollabAgentRef(trimmed) ?? (trimmed.includes(':') ? null : trimmed);\n}\n\n/** A stored `models` value: an array of rows, JSON-encoded or not; malformed rows dropped. */\nfunction labeledModelsOf(value: unknown): AgentLabeledModel[] {\n  let rows: unknown = value;\n  if (typeof rows === 'string') {\n    try {\n      rows = JSON.parse(rows);\n    } catch {\n      return [];\n    }\n  }\n  if (!Array.isArray(rows)) return [];\n  const entries: AgentLabeledModel[] = [];\n  for (const row of rows) {\n    if (!isRecord(row)) continue;\n    const model = nonBlank(row.model);\n    if (model === null) continue;\n    entries.push({\n      id: typeof row.id === 'string' && row.id !== '' ? row.id : model,\n      model,\n      label: nonBlank(row.label) ?? model,\n      isDefault: row.isDefault === true,\n    });\n  }\n  return entries;\n}\n\n/** A stored `channelOverrides` value's per-channel models. */\nfunction channelModelsOf(value: unknown): Record<string, string> {\n  if (!isRecord(value)) return {};\n  const out: Record<string, string> = {};\n  for (const [channel, override] of Object.entries(value)) {\n    const model = isRecord(override) ? nonBlank(override.model) : null;\n    if (model !== null) out[channel] = model;\n  }\n  return out;\n}\n\n/** Whether the agent asset's `athena_metadata` points at a published version. */\nexport function isPublishedAgent(athenaMetadata: unknown): boolean {\n  if (!isRecord(athenaMetadata)) return false;\n  const versionId = athenaMetadata.published_version_id;\n  return (\n    (typeof versionId === 'string' && versionId !== '') ||\n    (typeof versionId === 'number' && Number.isFinite(versionId))\n  );\n}\n\n/**\n * The model source of the agent's PUBLISHED definition, which every SDK run\n * compiles, from the agent asset's `athena_metadata` (publish writes\n * `published_config` beside `published_version_id`). `null` for an agent\n * that was never published, or whose published definition names no model\n * (not even a channel's).\n */\nexport function publishedAgentModelSource(athenaMetadata: unknown): AgentModelSource | null {\n  if (!isRecord(athenaMetadata) || !isPublishedAgent(athenaMetadata)) return null;\n  const config = athenaMetadata.published_config;\n  if (!isRecord(config)) return null;\n  const source: AgentModelSource = {\n    model: nonBlank(config.model),\n    models: labeledModelsOf(config.models),\n    channelModels: channelModelsOf(config.channelOverrides),\n    // The editor stores the field name; agora also accepts its snake-case alias.\n    allowAnyModel: allowsAnyModel(\n      Object.hasOwn(config, 'allowAnyModel') ? config.allowAnyModel : config.allow_any_model,\n    ),\n  };\n  const namesAModel =\n    source.model !== null ||\n    source.models.length > 0 ||\n    Object.keys(source.channelModels).length > 0;\n  return namesAModel ? source : null;\n}\n\n/**\n * Whether an entry's name is automatic: empty, the editor's old \"Default\", or\n * a name that only restates the entry's model (its id or catalog label).\n */\nexport function isAutomaticModelLabel({\n  entry,\n  modelLabel,\n}: {\n  entry: Pick<AgentLabeledModel, 'id' | 'model' | 'label'>;\n  modelLabel: ModelLabelOf;\n}): boolean {\n  const label = entry.label.trim();\n  if (label === '') return true;\n  if (entry.id === LEGACY_DEFAULT_ENTRY_ID && label === LEGACY_DEFAULT_ENTRY_LABEL) return true;\n  return label === entry.model || label === modelLabel(entry.model);\n}\n\n/**\n * The model a thread runs while it pins none: the channel's override, else the\n * definition's `model`, else its marked (or first) labeled entry.\n */\nexport function agentDefaultModel({\n  source,\n  channel,\n}: {\n  source: AgentModelSource;\n  channel: string | null;\n}): string | null {\n  const marked = source.models.find((entry) => entry.isDefault) ?? source.models[0];\n  return (channel ? source.channelModels[channel] : undefined) ?? source.model ?? marked?.model ?? null;\n}\n\n/**\n * The agent's model choices and its default, by the rules above. Options keep\n * the author's order, one per model (the first entry of a model names it); the\n * default is marked, and appended when the list lacks it; a pinned model\n * outside the list comes last.\n */\nexport function buildAgentModelOptions({\n  source,\n  channel,\n  pinnedModel,\n  modelLabel,\n}: {\n  source: AgentModelSource;\n  channel: string | null;\n  /** The model the thread's server config pins; `null` while it pins none (or is unknown). */\n  pinnedModel: string | null;\n  modelLabel: ModelLabelOf;\n}): { options: AthenaAgentModelOption[]; defaultModel: string | null } {\n  const options: AthenaAgentModelOption[] = [];\n  const add = (model: string, label: string) => {\n    if (options.some((option) => option.model === model)) return;\n    options.push({ model, label, isDefault: false, pinnedOutside: false });\n  };\n  for (const entry of source.models) {\n    add(\n      entry.model,\n      isAutomaticModelLabel({ entry, modelLabel }) ? modelLabel(entry.model) : entry.label.trim(),\n    );\n  }\n  if (options.length === 0 && source.model !== null) add(source.model, modelLabel(source.model));\n\n  const defaultModel = agentDefaultModel({ source, channel });\n  if (defaultModel !== null) {\n    add(defaultModel, modelLabel(defaultModel));\n    for (const option of options) option.isDefault = option.model === defaultModel;\n  }\n\n  const pinned = nonBlank(pinnedModel);\n  if (pinned !== null && !options.some((option) => option.model === pinned)) {\n    options.push({ model: pinned, label: modelLabel(pinned), isDefault: false, pinnedOutside: true });\n  }\n  return { options, defaultModel };\n}\n"],"names":["parseCollabAgentRef"],"mappings":"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"}

package/dist/catalog/agent-model-options.d.ts

@@ -0,0 +1,115 @@
+/**
+ * A collab agent's own model choices, from its published definition: exactly
+ * the models its author listed (the agent editor's Models section), the
+ * default marked. The rules are Athena's own composer's (Olympus) and the
+ * Jevin app's, so every host offers the same choices for one agent:
+ *
+ * - the options are the agent's labeled models, by the author's labels; an
+ *   automatic name (empty, the editor's old `{ id: 'default', label: 'Default' }`,
+ *   or one that only restates the model) shows the model's catalog label;
+ * - a legacy agent with no labeled list offers its single `model`;
+ * - the session channel's model override (`channelOverrides[channel].model`)
+ *   is that channel's default, added when the list lacks it;
+ * - a model the thread pins that is none of the agent's models is shown as it
+ *   is (`pinnedOutside`), never replaced.
+ *
+ * Restricting a picker to these choices is opt-in per agent: only an agent
+ * whose "Allow any workspace model" switch is off (`allowAnyModel: false`)
+ * does; every other agent keeps the workspace's models.
+ *
+ * Pure, for `useAthenaAgentModelOptions` and the tests.
+ */
+/** One model choice of a collab agent. */
+export interface AthenaAgentModelOption {
+    /** The model id a send carries (`model`). */
+    model: string;
+    /** The author's label, or the model's catalog label for an automatic name. */
+    label: string;
+    /** The model the thread runs while it pins none (the agent's own, or its channel's). */
+    isDefault: boolean;
+    /**
+     * A model the thread's server config pins that is none of the agent's models
+     * (pinned by another client, or by an older picker): shown, never replaced.
+     */
+    pinnedOutside: boolean;
+}
+/** One entry of the agent's labeled model list. */
+export interface AgentLabeledModel {
+    id: string;
+    model: string;
+    label: string;
+    isDefault: boolean;
+}
+/** What an agent's published definition says about its models. */
+export interface AgentModelSource {
+    /** The model the definition runs (`config.model`); `null` when it names none. */
+    model: string | null;
+    /** The labeled list (`config.models`), complete rows only, in the author's order. */
+    models: readonly AgentLabeledModel[];
+    /** Per-channel model overrides (`channelOverrides[<channel>].model`), by channel id. */
+    channelModels: Readonly<Record<string, string>>;
+    /**
+     * Whether people may pick any workspace model (`config.allowAnyModel`, the
+     * agent editor's "Allow any workspace model" switch; see
+     * {@link allowsAnyModel}). Only `false` restricts a picker to the agent's
+     * own models.
+     */
+    allowAnyModel: boolean;
+}
+/**
+ * Whether a config's `allowAnyModel` value lets people pick any model: only an
+ * explicit `false` restricts; absent, `null`, `true` and any non-boolean allow
+ * (agora's `collab_agent_allows_any_model`), so every agent saved before the
+ * switch existed behaves as it always has.
+ */
+export declare function allowsAnyModel(value: unknown): boolean;
+/** The display label of a model id; the id itself when the catalog does not know it. */
+export type ModelLabelOf = (model: string) => string;
+/**
+ * The collab agent's asset id for an `agent` value: a `collab_agent:<id>` ref
+ * (the provider's `agent` shape) or the bare asset id (the agent picker's
+ * value). `null` for a blank value.
+ */
+export declare function agentAssetIdOf(agent: string | null | undefined): string | null;
+/** Whether the agent asset's `athena_metadata` points at a published version. */
+export declare function isPublishedAgent(athenaMetadata: unknown): boolean;
+/**
+ * The model source of the agent's PUBLISHED definition, which every SDK run
+ * compiles, from the agent asset's `athena_metadata` (publish writes
+ * `published_config` beside `published_version_id`). `null` for an agent
+ * that was never published, or whose published definition names no model
+ * (not even a channel's).
+ */
+export declare function publishedAgentModelSource(athenaMetadata: unknown): AgentModelSource | null;
+/**
+ * Whether an entry's name is automatic: empty, the editor's old "Default", or
+ * a name that only restates the entry's model (its id or catalog label).
+ */
+export declare function isAutomaticModelLabel({ entry, modelLabel, }: {
+    entry: Pick<AgentLabeledModel, 'id' | 'model' | 'label'>;
+    modelLabel: ModelLabelOf;
+}): boolean;
+/**
+ * The model a thread runs while it pins none: the channel's override, else the
+ * definition's `model`, else its marked (or first) labeled entry.
+ */
+export declare function agentDefaultModel({ source, channel, }: {
+    source: AgentModelSource;
+    channel: string | null;
+}): string | null;
+/**
+ * The agent's model choices and its default, by the rules above. Options keep
+ * the author's order, one per model (the first entry of a model names it); the
+ * default is marked, and appended when the list lacks it; a pinned model
+ * outside the list comes last.
+ */
+export declare function buildAgentModelOptions({ source, channel, pinnedModel, modelLabel, }: {
+    source: AgentModelSource;
+    channel: string | null;
+    /** The model the thread's server config pins; `null` while it pins none (or is unknown). */
+    pinnedModel: string | null;
+    modelLabel: ModelLabelOf;
+}): {
+    options: AthenaAgentModelOption[];
+    defaultModel: string | null;
+};

package/dist/catalog/agent-model-options.js

@@ -0,0 +1,122 @@
+import { parseCollabAgentRef } from "../runtime/statewire-run-config.js";
+function allowsAnyModel(value) {
+  return value !== false;
+}
+const LEGACY_DEFAULT_ENTRY_ID = "default";
+const LEGACY_DEFAULT_ENTRY_LABEL = "Default";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const nonBlank = (value) => typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+function agentAssetIdOf(agent) {
+  const trimmed = nonBlank(agent);
+  if (trimmed === null) return null;
+  return parseCollabAgentRef(trimmed) ?? (trimmed.includes(":") ? null : trimmed);
+}
+function labeledModelsOf(value) {
+  let rows = value;
+  if (typeof rows === "string") {
+    try {
+      rows = JSON.parse(rows);
+    } catch {
+      return [];
+    }
+  }
+  if (!Array.isArray(rows)) return [];
+  const entries = [];
+  for (const row of rows) {
+    if (!isRecord(row)) continue;
+    const model = nonBlank(row.model);
+    if (model === null) continue;
+    entries.push({
+      id: typeof row.id === "string" && row.id !== "" ? row.id : model,
+      model,
+      label: nonBlank(row.label) ?? model,
+      isDefault: row.isDefault === true
+    });
+  }
+  return entries;
+}
+function channelModelsOf(value) {
+  if (!isRecord(value)) return {};
+  const out = {};
+  for (const [channel, override] of Object.entries(value)) {
+    const model = isRecord(override) ? nonBlank(override.model) : null;
+    if (model !== null) out[channel] = model;
+  }
+  return out;
+}
+function isPublishedAgent(athenaMetadata) {
+  if (!isRecord(athenaMetadata)) return false;
+  const versionId = athenaMetadata.published_version_id;
+  return typeof versionId === "string" && versionId !== "" || typeof versionId === "number" && Number.isFinite(versionId);
+}
+function publishedAgentModelSource(athenaMetadata) {
+  if (!isRecord(athenaMetadata) || !isPublishedAgent(athenaMetadata)) return null;
+  const config = athenaMetadata.published_config;
+  if (!isRecord(config)) return null;
+  const source = {
+    model: nonBlank(config.model),
+    models: labeledModelsOf(config.models),
+    channelModels: channelModelsOf(config.channelOverrides),
+    // The editor stores the field name; agora also accepts its snake-case alias.
+    allowAnyModel: allowsAnyModel(
+      Object.hasOwn(config, "allowAnyModel") ? config.allowAnyModel : config.allow_any_model
+    )
+  };
+  const namesAModel = source.model !== null || source.models.length > 0 || Object.keys(source.channelModels).length > 0;
+  return namesAModel ? source : null;
+}
+function isAutomaticModelLabel({
+  entry,
+  modelLabel
+}) {
+  const label = entry.label.trim();
+  if (label === "") return true;
+  if (entry.id === LEGACY_DEFAULT_ENTRY_ID && label === LEGACY_DEFAULT_ENTRY_LABEL) return true;
+  return label === entry.model || label === modelLabel(entry.model);
+}
+function agentDefaultModel({
+  source,
+  channel
+}) {
+  const marked = source.models.find((entry) => entry.isDefault) ?? source.models[0];
+  return (channel ? source.channelModels[channel] : void 0) ?? source.model ?? (marked == null ? void 0 : marked.model) ?? null;
+}
+function buildAgentModelOptions({
+  source,
+  channel,
+  pinnedModel,
+  modelLabel
+}) {
+  const options = [];
+  const add = (model, label) => {
+    if (options.some((option) => option.model === model)) return;
+    options.push({ model, label, isDefault: false, pinnedOutside: false });
+  };
+  for (const entry of source.models) {
+    add(
+      entry.model,
+      isAutomaticModelLabel({ entry, modelLabel }) ? modelLabel(entry.model) : entry.label.trim()
+    );
+  }
+  if (options.length === 0 && source.model !== null) add(source.model, modelLabel(source.model));
+  const defaultModel = agentDefaultModel({ source, channel });
+  if (defaultModel !== null) {
+    add(defaultModel, modelLabel(defaultModel));
+    for (const option of options) option.isDefault = option.model === defaultModel;
+  }
+  const pinned = nonBlank(pinnedModel);
+  if (pinned !== null && !options.some((option) => option.model === pinned)) {
+    options.push({ model: pinned, label: modelLabel(pinned), isDefault: false, pinnedOutside: true });
+  }
+  return { options, defaultModel };
+}
+export {
+  agentAssetIdOf,
+  agentDefaultModel,
+  allowsAnyModel,
+  buildAgentModelOptions,
+  isAutomaticModelLabel,
+  isPublishedAgent,
+  publishedAgentModelSource
+};
+//# sourceMappingURL=agent-model-options.js.map

package/dist/catalog/agent-model-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-model-options.js","sources":["../../src/catalog/agent-model-options.ts"],"sourcesContent":["import { parseCollabAgentRef } from '../runtime/statewire-run-config';\n\n/**\n * A collab agent's own model choices, from its published definition: exactly\n * the models its author listed (the agent editor's Models section), the\n * default marked. The rules are Athena's own composer's (Olympus) and the\n * Jevin app's, so every host offers the same choices for one agent:\n *\n * - the options are the agent's labeled models, by the author's labels; an\n *   automatic name (empty, the editor's old `{ id: 'default', label: 'Default' }`,\n *   or one that only restates the model) shows the model's catalog label;\n * - a legacy agent with no labeled list offers its single `model`;\n * - the session channel's model override (`channelOverrides[channel].model`)\n *   is that channel's default, added when the list lacks it;\n * - a model the thread pins that is none of the agent's models is shown as it\n *   is (`pinnedOutside`), never replaced.\n *\n * Restricting a picker to these choices is opt-in per agent: only an agent\n * whose \"Allow any workspace model\" switch is off (`allowAnyModel: false`)\n * does; every other agent keeps the workspace's models.\n *\n * Pure, for `useAthenaAgentModelOptions` and the tests.\n */\n\n/** One model choice of a collab agent. */\nexport interface AthenaAgentModelOption {\n  /** The model id a send carries (`model`). */\n  model: string;\n  /** The author's label, or the model's catalog label for an automatic name. */\n  label: string;\n  /** The model the thread runs while it pins none (the agent's own, or its channel's). */\n  isDefault: boolean;\n  /**\n   * A model the thread's server config pins that is none of the agent's models\n   * (pinned by another client, or by an older picker): shown, never replaced.\n   */\n  pinnedOutside: boolean;\n}\n\n/** One entry of the agent's labeled model list. */\nexport interface AgentLabeledModel {\n  id: string;\n  model: string;\n  label: string;\n  isDefault: boolean;\n}\n\n/** What an agent's published definition says about its models. */\nexport interface AgentModelSource {\n  /** The model the definition runs (`config.model`); `null` when it names none. */\n  model: string | null;\n  /** The labeled list (`config.models`), complete rows only, in the author's order. */\n  models: readonly AgentLabeledModel[];\n  /** Per-channel model overrides (`channelOverrides[<channel>].model`), by channel id. */\n  channelModels: Readonly<Record<string, string>>;\n  /**\n   * Whether people may pick any workspace model (`config.allowAnyModel`, the\n   * agent editor's \"Allow any workspace model\" switch; see\n   * {@link allowsAnyModel}). Only `false` restricts a picker to the agent's\n   * own models.\n   */\n  allowAnyModel: boolean;\n}\n\n/**\n * Whether a config's `allowAnyModel` value lets people pick any model: only an\n * explicit `false` restricts; absent, `null`, `true` and any non-boolean allow\n * (agora's `collab_agent_allows_any_model`), so every agent saved before the\n * switch existed behaves as it always has.\n */\nexport function allowsAnyModel(value: unknown): boolean {\n  return value !== false;\n}\n\n/** The display label of a model id; the id itself when the catalog does not know it. */\nexport type ModelLabelOf = (model: string) => string;\n\n/** The row the agent editor used to create for an agent with no stored entries. */\nconst LEGACY_DEFAULT_ENTRY_ID = 'default';\nconst LEGACY_DEFAULT_ENTRY_LABEL = 'Default';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst nonBlank = (value: unknown): string | null =>\n  typeof value === 'string' && value.trim() !== '' ? value.trim() : null;\n\n/**\n * The collab agent's asset id for an `agent` value: a `collab_agent:<id>` ref\n * (the provider's `agent` shape) or the bare asset id (the agent picker's\n * value). `null` for a blank value.\n */\nexport function agentAssetIdOf(agent: string | null | undefined): string | null {\n  const trimmed = nonBlank(agent);\n  if (trimmed === null) return null;\n  return parseCollabAgentRef(trimmed) ?? (trimmed.includes(':') ? null : trimmed);\n}\n\n/** A stored `models` value: an array of rows, JSON-encoded or not; malformed rows dropped. */\nfunction labeledModelsOf(value: unknown): AgentLabeledModel[] {\n  let rows: unknown = value;\n  if (typeof rows === 'string') {\n    try {\n      rows = JSON.parse(rows);\n    } catch {\n      return [];\n    }\n  }\n  if (!Array.isArray(rows)) return [];\n  const entries: AgentLabeledModel[] = [];\n  for (const row of rows) {\n    if (!isRecord(row)) continue;\n    const model = nonBlank(row.model);\n    if (model === null) continue;\n    entries.push({\n      id: typeof row.id === 'string' && row.id !== '' ? row.id : model,\n      model,\n      label: nonBlank(row.label) ?? model,\n      isDefault: row.isDefault === true,\n    });\n  }\n  return entries;\n}\n\n/** A stored `channelOverrides` value's per-channel models. */\nfunction channelModelsOf(value: unknown): Record<string, string> {\n  if (!isRecord(value)) return {};\n  const out: Record<string, string> = {};\n  for (const [channel, override] of Object.entries(value)) {\n    const model = isRecord(override) ? nonBlank(override.model) : null;\n    if (model !== null) out[channel] = model;\n  }\n  return out;\n}\n\n/** Whether the agent asset's `athena_metadata` points at a published version. */\nexport function isPublishedAgent(athenaMetadata: unknown): boolean {\n  if (!isRecord(athenaMetadata)) return false;\n  const versionId = athenaMetadata.published_version_id;\n  return (\n    (typeof versionId === 'string' && versionId !== '') ||\n    (typeof versionId === 'number' && Number.isFinite(versionId))\n  );\n}\n\n/**\n * The model source of the agent's PUBLISHED definition, which every SDK run\n * compiles, from the agent asset's `athena_metadata` (publish writes\n * `published_config` beside `published_version_id`). `null` for an agent\n * that was never published, or whose published definition names no model\n * (not even a channel's).\n */\nexport function publishedAgentModelSource(athenaMetadata: unknown): AgentModelSource | null {\n  if (!isRecord(athenaMetadata) || !isPublishedAgent(athenaMetadata)) return null;\n  const config = athenaMetadata.published_config;\n  if (!isRecord(config)) return null;\n  const source: AgentModelSource = {\n    model: nonBlank(config.model),\n    models: labeledModelsOf(config.models),\n    channelModels: channelModelsOf(config.channelOverrides),\n    // The editor stores the field name; agora also accepts its snake-case alias.\n    allowAnyModel: allowsAnyModel(\n      Object.hasOwn(config, 'allowAnyModel') ? config.allowAnyModel : config.allow_any_model,\n    ),\n  };\n  const namesAModel =\n    source.model !== null ||\n    source.models.length > 0 ||\n    Object.keys(source.channelModels).length > 0;\n  return namesAModel ? source : null;\n}\n\n/**\n * Whether an entry's name is automatic: empty, the editor's old \"Default\", or\n * a name that only restates the entry's model (its id or catalog label).\n */\nexport function isAutomaticModelLabel({\n  entry,\n  modelLabel,\n}: {\n  entry: Pick<AgentLabeledModel, 'id' | 'model' | 'label'>;\n  modelLabel: ModelLabelOf;\n}): boolean {\n  const label = entry.label.trim();\n  if (label === '') return true;\n  if (entry.id === LEGACY_DEFAULT_ENTRY_ID && label === LEGACY_DEFAULT_ENTRY_LABEL) return true;\n  return label === entry.model || label === modelLabel(entry.model);\n}\n\n/**\n * The model a thread runs while it pins none: the channel's override, else the\n * definition's `model`, else its marked (or first) labeled entry.\n */\nexport function agentDefaultModel({\n  source,\n  channel,\n}: {\n  source: AgentModelSource;\n  channel: string | null;\n}): string | null {\n  const marked = source.models.find((entry) => entry.isDefault) ?? source.models[0];\n  return (channel ? source.channelModels[channel] : undefined) ?? source.model ?? marked?.model ?? null;\n}\n\n/**\n * The agent's model choices and its default, by the rules above. Options keep\n * the author's order, one per model (the first entry of a model names it); the\n * default is marked, and appended when the list lacks it; a pinned model\n * outside the list comes last.\n */\nexport function buildAgentModelOptions({\n  source,\n  channel,\n  pinnedModel,\n  modelLabel,\n}: {\n  source: AgentModelSource;\n  channel: string | null;\n  /** The model the thread's server config pins; `null` while it pins none (or is unknown). */\n  pinnedModel: string | null;\n  modelLabel: ModelLabelOf;\n}): { options: AthenaAgentModelOption[]; defaultModel: string | null } {\n  const options: AthenaAgentModelOption[] = [];\n  const add = (model: string, label: string) => {\n    if (options.some((option) => option.model === model)) return;\n    options.push({ model, label, isDefault: false, pinnedOutside: false });\n  };\n  for (const entry of source.models) {\n    add(\n      entry.model,\n      isAutomaticModelLabel({ entry, modelLabel }) ? modelLabel(entry.model) : entry.label.trim(),\n    );\n  }\n  if (options.length === 0 && source.model !== null) add(source.model, modelLabel(source.model));\n\n  const defaultModel = agentDefaultModel({ source, channel });\n  if (defaultModel !== null) {\n    add(defaultModel, modelLabel(defaultModel));\n    for (const option of options) option.isDefault = option.model === defaultModel;\n  }\n\n  const pinned = nonBlank(pinnedModel);\n  if (pinned !== null && !options.some((option) => option.model === pinned)) {\n    options.push({ model: pinned, label: modelLabel(pinned), isDefault: false, pinnedOutside: true });\n  }\n  return { options, defaultModel };\n}\n"],"names":[],"mappings":"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"}