nolo-cli 0.84.0-alpha.1 → 0.84.0

package/chunk-BNGW5ASC.js

@@ -0,0 +1,344 @@
+import {
+  publicAgentKey
+} from "./chunk-M2EJHDJP.js";
+
+// packages/core/builtinAgentCatalog.ts
+var BUILTIN_AGENT_CATALOG = [
+  // ── 平台内置 6 个（builtinAgents BUILTIN_*）──
+  {
+    id: "01NOLOAPPBLD000000019KCKT0",
+    group: "builtin",
+    name: "nolo",
+    provider: "nolo",
+    model: "deepseek-flash",
+    runtimeFallback: true
+  },
+  {
+    id: "01APPBUILDER00000001YAII3I",
+    group: "builtin",
+    name: "\u5E94\u7528\u6784\u5EFA\u52A9\u624B",
+    provider: "nolo",
+    model: "deepseek-flash"
+  },
+  {
+    id: "01ECOMMERCEAG00000001PYQ2J",
+    group: "builtin",
+    name: "\u7535\u5546\u5546\u54C1\u53C2\u6570\u52A9\u624B",
+    provider: "openai",
+    model: "gpt-6-luna"
+  },
+  {
+    id: "01NOLOAGENTCRT000000000001",
+    group: "builtin",
+    name: "AI \u521B\u5EFA\u52A9\u624B",
+    provider: "nolo",
+    model: "deepseek-flash"
+  },
+  {
+    id: "01NOLOFEEDBACKA000000000R2",
+    group: "builtin",
+    name: "\u53CD\u9988\u5165\u53E3",
+    provider: "nolo",
+    model: "deepseek-flash"
+  },
+  {
+    id: "01CHROMEOPR000000000001",
+    group: "builtin",
+    name: "Chrome \u64CD\u4F5C\u5458",
+    provider: "nolo",
+    model: "deepseek-flash"
+  },
+  // ── quick-chat 档位 public（图片助手已无 runtimeFallback，见下方图片档段） ──
+  // 2026-09-10 兜底最小化：runtimeFallback 只保留产品代码显式引用的条目
+  // （nolo 默认档、PLATFORM_TIER_AGENT_KEYS 的 flash/image-compat、
+  // SYSTEM_BUILTIN_TRUSTED 的 flash/pro/glm-flash）。广场档与图片助手不再
+  // 兜底——记录缺失时明确报 Agent not found，而不是合成无 prompt 的裸配置。
+  {
+    id: "01DSV4FLASHPB00000000JFPFD",
+    group: "public",
+    name: "DeepSeek Flash",
+    provider: "nolo",
+    model: "deepseek-flash",
+    runtimeFallback: true
+  },
+  {
+    id: "01DSV4PRONPB00000001VIR3EK",
+    group: "public",
+    name: "DeepSeek V4 Pro",
+    provider: "nolo",
+    model: "deepseek-v4-pro",
+    runtimeFallback: true
+  },
+  {
+    id: "01GLM52DIPB00000000I3E2MY",
+    group: "public",
+    name: "GLM 5.3",
+    provider: "nolo",
+    model: "glm-5.3"
+  },
+  {
+    id: "01GLMFLASHPB00000000BT20BC",
+    group: "public",
+    name: "GLM 5.3 Flash",
+    provider: "nolo",
+    model: "glm-5-3-flash",
+    runtimeFallback: true
+  },
+  {
+    id: "01KIMIK26OLLAMA0000000001",
+    // 已下架的公共入口：保留 internal catalog entry 仅用于旧 Agent 记录的运行时兼容。
+    group: "internal",
+    lifecycle: "retired",
+    name: "Kimi K2.6\uFF08\u517C\u5BB9\uFF09",
+    provider: "nolo",
+    model: "kimi-k2.6",
+    runtimeFallback: true
+  },
+  // ── 广场公开聊天档（从 createSpaceAgents PUBLIC_AGENT_DEFS 收编，2026-08-19）──
+  // ID 与 createSpaceAgents 的 deterministicId 结果一致；provider 按 agentSeedBuilder
+  // 默认规则：显式 provider 用显式值，未写则 openai。
+  // 2026-09-10 预设收敛：GPT-5.6 Sol/Terra、GPT-5.5 Pro 从广场退场转 internal 兼容，
+  // 公开聊天档只保留 Luna + nolo 托管组 + 图片档（图片档仍在广场，但不再 runtimeFallback）。
+  {
+    id: "01GPT56SOLPB00000000VXMGCW",
+    // 已从广场/预设退场（2026-09-10）：保留 internal 兼容条目，仅为存量 agent
+    // 记录提供运行时路由；不再出现在广场与 createSpaceAgents 播种清单。
+    group: "internal",
+    lifecycle: "retired",
+    name: "GPT-5.6 Sol\uFF08\u517C\u5BB9\uFF09",
+    provider: "openai",
+    model: "gpt-5.6-sol"
+  },
+  {
+    id: "01GPT56TERPB00000001UX7RKW",
+    // 已从广场/预设退场（2026-09-10）：同 Sol，internal 兼容。
+    group: "internal",
+    lifecycle: "retired",
+    name: "GPT-5.6 Terra\uFF08\u517C\u5BB9\uFF09",
+    provider: "openai",
+    model: "gpt-5.6-terra"
+  },
+  {
+    id: "01GPT56LUNPB00000001VVVZHS",
+    // 2026-09-23 换代：同一稳定 ID（用户收藏 / 别名 / Space 内容键不失效）升级为
+    // 平台托管 GPT-6 Luna。注意与 retired 的区别：Luna 是在架商品原地换代，
+    //
+    // provider 必须是 "nolo"（平台托管命名空间），不能写上游名 "openai"：
+    // ① 计费按 calculatePrice(provider, model) 查价，平台价只注册在 nolo 下，
+    //    写 openai 会落零价虚拟模型（2026-09-24 实测 openai/gpt-6-luna → cost 0）；
+    // ② agent-run 的托管路由门 isPlatformManagedProvider 只认 nolo/deepseek/
+    //    kimi 系，provider 非 nolo 时读不到 hosted routing table，直连 key 也拿不到。
+    // 平台 agent 统一收敛到 nolo provider 是既定方向（见 modelUpgradeTable 的
+    // 「尽量迁移到 nolo 平台托管」原则），其余上游名 provider 逐步退场。
+    group: "public",
+    lifecycle: "active",
+    name: "GPT-6 Luna",
+    provider: "nolo",
+    model: "gpt-6-luna"
+  },
+  {
+    id: "01GPT55PROPUB00000000IV47M",
+    // 已从广场/预设退场（2026-09-10 retired，2026-09-23 起 overlay 强制过滤
+    // 存量 DB 记录）：internal 兼容，理由同 Sol。
+    group: "internal",
+    lifecycle: "retired",
+    name: "GPT-5.5 Pro\uFF08\u517C\u5BB9\uFF09",
+    provider: "openai",
+    model: "gpt-5.5-pro"
+  },
+  {
+    id: "01CLSO50DIPB00000000A1DVVU",
+    // 旧代 Claude 广场入口（2026-09-01 下架时随条目删除，只剩线上孤儿记录，
+    // 2026-09-24 重新收编）：internal + retired 保留运行时兼容，广场由 overlay
+    // 按 retiredCatalogIds 过滤其存量 agent-pub-* 记录（退场 ≠ 删除——Space
+    // contentKey / dialog primaryAgentKey 硬引用不断链）。model 沿用 2026-09-15
+    // 恢复的真实 DeepInfra 官方名（与平台模型名同名）。
+    group: "internal",
+    lifecycle: "retired",
+    name: "Claude Sonnet 5\uFF08\u517C\u5BB9\uFF09",
+    provider: "nolo",
+    model: "anthropic/claude-sonnet-5"
+  },
+  {
+    id: "01FABLE5DIPB00000001VJBKM4",
+    // 同 Sonnet 5：旧代 Claude 广场入口转 internal + retired 兼容条目。
+    group: "internal",
+    lifecycle: "retired",
+    name: "Claude Fable 5\uFF08\u517C\u5BB9\uFF09",
+    provider: "nolo",
+    model: "anthropic/claude-fable-5"
+  },
+  {
+    id: "01CLOP48DIPB0000000001OI1W",
+    // 同 Sonnet 5 / Fable 5。这条尤其重要：线上同时存在
+    // agent-system-01CLOP48DIPB...（userId=system）与 owner 副本。catalog 若无该
+    // 条目，overlay 的「DB 有、catalog 无 → 用户自建」规则会把 system 名下记录当成
+    // 用户自建保留——正是 2026-09-24 设计会商点名的「事故复活通道」实例。
+    group: "internal",
+    lifecycle: "retired",
+    name: "Claude Opus 5\uFF08\u517C\u5BB9\uFF09",
+    provider: "nolo",
+    model: "anthropic/claude-opus-5"
+  },
+  // Claude 系 2026-09-24 广场重新上架：只上架最新一代（Fable 5.1 / Opus 5.5）。
+  // 平台托管通道 2026-09-15 起已是真实 DeepInfra 模型（nolo 目录），provider
+  // 收敛到 nolo 命名空间；旧代 Sonnet 5 / Fable 5 只保留上面的 retired 兼容条目。
+  // Gemini 文本档只上架最新一代：旧版留在广场只会分散选择、拉长列表，而
+  // 用户想要的是「最新的那个 Gemini」。旧版模型仍可保留用于兼容历史请求，
+  // （modelAbility / 定价表照旧），下架的只是广场入口。
+  {
+    id: "01CLDFBL51PB000000013N70D7",
+    group: "public",
+    lifecycle: "active",
+    name: "Claude Fable 5.1",
+    provider: "nolo",
+    model: "anthropic/claude-fable-5-1"
+  },
+  {
+    id: "01CLDOPU55PB00000001MQHSW0",
+    group: "public",
+    lifecycle: "active",
+    name: "Claude Opus 5.5",
+    provider: "nolo",
+    model: "anthropic/claude-opus-5-5"
+  },
+  {
+    id: "01GEM37FLPB00000000FJCRNC",
+    group: "public",
+    name: "Gemini 3.8 Flash",
+    provider: "nolo",
+    model: "gemini-3.8-flash"
+  },
+  {
+    id: "01GROK46PLAZ00000001PTJZ3K",
+    group: "public",
+    name: "Grok 4.6",
+    provider: "xai",
+    model: "grok-4.6"
+  },
+  {
+    id: "01GPTIMG2GEN00000000SSEBOS",
+    group: "public",
+    name: "GPT Image 2 \u56FE\u7247\u751F\u6210\u5668",
+    provider: "nolo",
+    model: "gpt-6-luna",
+    hasImageOutput: true,
+    imageModel: "gpt-image-2",
+    imageWorkflow: "generate",
+    imageConfig: { enabled: true }
+  },
+  {
+    id: "01GPTIMG2EDT00000001R4R4H4",
+    group: "public",
+    name: "GPT Image 2 \u56FE\u7247\u7F16\u8F91\u5668",
+    provider: "nolo",
+    model: "gpt-6-luna",
+    hasImageOutput: true,
+    imageModel: "gpt-image-2",
+    imageWorkflow: "edit",
+    imageConfig: { enabled: true }
+  },
+  {
+    id: "01GPTIMG2CNT00000000USKZFO",
+    group: "public",
+    name: "GPT Image 2 \u8FDE\u7EED\u521B\u4F5C\u52A9\u624B",
+    provider: "nolo",
+    model: "gpt-6-luna",
+    hasImageOutput: true,
+    imageModel: "gpt-image-2",
+    imageWorkflow: "continuous",
+    imageConfig: { enabled: true }
+  },
+  {
+    id: "01NB2LITEGEN00000001XE1MNO",
+    group: "public",
+    name: "Nano Banana 2 Lite \u6587\u751F\u56FE",
+    provider: "nolo",
+    model: "gemini-3.1-flash-lite-image",
+    hasImageOutput: true
+  }
+];
+var CATALOG_BY_ID = new Map(BUILTIN_AGENT_CATALOG.map((e) => [e.id, e]));
+function builtinAgentCatalogEntryById(id) {
+  if (!id) return void 0;
+  return CATALOG_BY_ID.get(id);
+}
+function builtinRuntimeFallbackEntries() {
+  return BUILTIN_AGENT_CATALOG.filter((e) => e.runtimeFallback === true);
+}
+function builtinPlatformEntries() {
+  return BUILTIN_AGENT_CATALOG.filter((e) => e.group === "builtin");
+}
+function isRetiredCatalogEntry(entry2) {
+  return entry2?.lifecycle === "retired";
+}
+
+// packages/core/builtinAgents.ts
+var entry = (id) => {
+  const e = builtinAgentCatalogEntryById(id);
+  if (!e) throw new Error(`missing builtin agent catalog entry: ${id}`);
+  return e;
+};
+var BUILTIN_NOLO_AGENT_ID = entry("01NOLOAPPBLD000000019KCKT0").id;
+var BUILTIN_NOLO_AGENT_KEY = publicAgentKey(BUILTIN_NOLO_AGENT_ID);
+var BUILTIN_NOLO_AGENT_NAME = entry("01NOLOAPPBLD000000019KCKT0").name;
+var BUILTIN_NOLO_AGENT_MODEL = entry("01NOLOAPPBLD000000019KCKT0").model;
+var BUILTIN_APP_BUILDER_AGENT_ID = entry("01APPBUILDER00000001YAII3I").id;
+var BUILTIN_APP_BUILDER_AGENT_KEY = publicAgentKey(BUILTIN_APP_BUILDER_AGENT_ID);
+var BUILTIN_ECOMMERCE_AGENT_ID = entry("01ECOMMERCEAG00000001PYQ2J").id;
+var BUILTIN_ECOMMERCE_AGENT_KEY = publicAgentKey(BUILTIN_ECOMMERCE_AGENT_ID);
+var BUILTIN_AGENT_CREATOR_AGENT_ID = entry("01NOLOAGENTCRT000000000001").id;
+var BUILTIN_AGENT_CREATOR_AGENT_KEY = publicAgentKey(BUILTIN_AGENT_CREATOR_AGENT_ID);
+var BUILTIN_FEEDBACK_AGENT_ID = entry("01NOLOFEEDBACKA000000000R2").id;
+var BUILTIN_FEEDBACK_AGENT_KEY = publicAgentKey(BUILTIN_FEEDBACK_AGENT_ID);
+var BUILTIN_CHROME_OPERATOR_AGENT_ID = entry("01CHROMEOPR000000000001").id;
+var BUILTIN_CHROME_OPERATOR_AGENT_KEY = publicAgentKey(BUILTIN_CHROME_OPERATOR_AGENT_ID);
+var BUILTIN_PLATFORM_AGENT_KEYS = builtinPlatformEntries().map(
+  (e) => publicAgentKey(e.id)
+);
+var BUILTIN_PLATFORM_AGENT_KEY_SET = new Set(BUILTIN_PLATFORM_AGENT_KEYS);
+var PUBLIC_DEEPSEEK_V4_FLASH_AGENT_ID = entry("01DSV4FLASHPB00000000JFPFD").id;
+var PUBLIC_DEEPSEEK_V4_FLASH_AGENT_KEY = publicAgentKey(PUBLIC_DEEPSEEK_V4_FLASH_AGENT_ID);
+var PUBLIC_DEEPSEEK_V4_PRO_AGENT_ID = entry("01DSV4PRONPB00000001VIR3EK").id;
+var PUBLIC_DEEPSEEK_V4_PRO_AGENT_KEY = publicAgentKey(PUBLIC_DEEPSEEK_V4_PRO_AGENT_ID);
+var PUBLIC_GLM_53_FLASH_AGENT_ID = entry("01GLMFLASHPB00000000BT20BC").id;
+var PUBLIC_GLM_53_FLASH_AGENT_KEY = publicAgentKey(PUBLIC_GLM_53_FLASH_AGENT_ID);
+var PUBLIC_KIMI_K26_IMAGE_AGENT_ID = entry("01KIMIK26OLLAMA0000000001").id;
+var PUBLIC_KIMI_K26_IMAGE_AGENT_KEY = publicAgentKey(PUBLIC_KIMI_K26_IMAGE_AGENT_ID);
+var PUBLIC_GPT_IMAGE_2_GENERATOR_AGENT_ID = entry("01GPTIMG2GEN00000000SSEBOS").id;
+var PUBLIC_GPT_IMAGE_2_GENERATOR_AGENT_KEY = publicAgentKey(PUBLIC_GPT_IMAGE_2_GENERATOR_AGENT_ID);
+var PUBLIC_GPT_IMAGE_2_EDITOR_AGENT_ID = entry("01GPTIMG2EDT00000001R4R4H4").id;
+var PUBLIC_GPT_IMAGE_2_EDITOR_AGENT_KEY = publicAgentKey(PUBLIC_GPT_IMAGE_2_EDITOR_AGENT_ID);
+var PUBLIC_GPT_IMAGE_2_CONTINUOUS_AGENT_ID = entry("01GPTIMG2CNT00000000USKZFO").id;
+var PUBLIC_GPT_IMAGE_2_CONTINUOUS_AGENT_KEY = publicAgentKey(PUBLIC_GPT_IMAGE_2_CONTINUOUS_AGENT_ID);
+var PUBLIC_NANO_BANANA_2_LITE_AGENT_ID = entry("01NB2LITEGEN00000001XE1MNO").id;
+var PUBLIC_NANO_BANANA_2_LITE_AGENT_KEY = publicAgentKey(PUBLIC_NANO_BANANA_2_LITE_AGENT_ID);
+var SYSTEM_BUILTIN_TRUSTED_AGENT_KEYS = [
+  PUBLIC_DEEPSEEK_V4_FLASH_AGENT_KEY,
+  PUBLIC_DEEPSEEK_V4_PRO_AGENT_KEY,
+  PUBLIC_GLM_53_FLASH_AGENT_KEY
+];
+var SYSTEM_BUILTIN_TRUSTED_AGENT_KEY_SET = new Set(
+  SYSTEM_BUILTIN_TRUSTED_AGENT_KEYS
+);
+var isSystemBuiltinTrustedAgentKey = (key) => typeof key === "string" && SYSTEM_BUILTIN_TRUSTED_AGENT_KEY_SET.has(key);
+var isBuiltinPlatformAgentKey = (key) => typeof key === "string" && BUILTIN_PLATFORM_AGENT_KEY_SET.has(key);
+
+export {
+  builtinAgentCatalogEntryById,
+  builtinRuntimeFallbackEntries,
+  isRetiredCatalogEntry,
+  BUILTIN_NOLO_AGENT_KEY,
+  BUILTIN_NOLO_AGENT_NAME,
+  BUILTIN_NOLO_AGENT_MODEL,
+  BUILTIN_PLATFORM_AGENT_KEYS,
+  PUBLIC_DEEPSEEK_V4_FLASH_AGENT_ID,
+  PUBLIC_DEEPSEEK_V4_PRO_AGENT_ID,
+  PUBLIC_GLM_53_FLASH_AGENT_ID,
+  PUBLIC_GPT_IMAGE_2_GENERATOR_AGENT_ID,
+  PUBLIC_GPT_IMAGE_2_EDITOR_AGENT_ID,
+  PUBLIC_GPT_IMAGE_2_CONTINUOUS_AGENT_ID,
+  PUBLIC_NANO_BANANA_2_LITE_AGENT_ID,
+  isSystemBuiltinTrustedAgentKey,
+  isBuiltinPlatformAgentKey
+};

package/{chunk-2KDR4CWE.js → chunk-BYMV6QZG.js}

@@ -285,6 +285,27 @@ function saveProfileAgentSelection(selection, path = getDefaultProfileConfigPath
 `, "utf8");
   return config;
 }
+function getProfileOAuthSync(provider, path = getDefaultProfileConfigPath()) {
+  const config = loadProfileConfig(path);
+  if (!config) return void 0;
+  const profile = config.profiles[config.currentProfile];
+  return profile?.oauthSync?.[provider];
+}
+function saveProfileOAuthSync(provider, sync, path = getDefaultProfileConfigPath()) {
+  if (isProtectedHomeProfileWrite(path)) return null;
+  const config = loadProfileConfig(path);
+  if (!config) return null;
+  const profile = config.profiles[config.currentProfile];
+  if (!profile) return null;
+  profile.oauthSync = {
+    ...profile.oauthSync ?? {},
+    [provider]: sync
+  };
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+  return config;
+}
 
 export {
   getDefaultProfileConfigPath,
@@ -299,5 +320,7 @@ export {
   saveProfileLocale,
   getAgentSelectionAuditPath,
   readLastAgentSelectionAudit,
-  saveProfileAgentSelection
+  saveProfileAgentSelection,
+  getProfileOAuthSync,
+  saveProfileOAuthSync
 };

package/{chunk-73BR2IQT.js → chunk-CWQINZEA.js}

@@ -3,21 +3,24 @@ import {
 } from "./chunk-YYLHWIW6.js";
 import {
   compareAgentSelection
-} from "./chunk-ZVN6I33J.js";
+} from "./chunk-HCT7U36O.js";
+import {
+  isAgentUnavailableNow
+} from "./chunk-FDTR4QJ6.js";
 import {
   isAntigravityOAuthAgent
-} from "./chunk-LHDV2QUI.js";
+} from "./chunk-GNCCNNZD.js";
 import {
   getModelAbility
-} from "./chunk-NG4UT4K4.js";
+} from "./chunk-ACTMNVHM.js";
 import {
   isOwnedAgentKey,
   ownedAgentKey,
   publicAgentKey
-} from "./chunk-BJIRLHJR.js";
+} from "./chunk-M2EJHDJP.js";
 import {
   fnv1a32Hex
-} from "./chunk-3RAG2NAD.js";
+} from "./chunk-UKWGR5SS.js";
 
 // packages/ai/agent/agentBilling.ts
 function resolveBillingSource(candidate) {
@@ -356,6 +359,8 @@ function toSafeAgentSummary(record, options) {
   const isPublic = record?.isPublic === true || record?.isPublicFlag === true || record?.publicRecordExists === true;
   const updatedAt = safeTimestamp(record?.updatedAt ?? record?.createdAt ?? record?.created);
   const nextAvailableAt = typeof record?.nextAvailableAt === "number" && Number.isFinite(record.nextAvailableAt) ? record.nextAvailableAt : void 0;
+  const rawQuota = record?.quota;
+  const quota = rawQuota && typeof rawQuota === "object" && Array.isArray(rawQuota.windows) && typeof rawQuota.observedAt === "number" && Number.isFinite(rawQuota.observedAt) ? rawQuota : void 0;
   const currentUserId = options?.userId;
   const isOwnedByRecord = Boolean(currentUserId) && (typeof record?.userId === "string" && record.userId === currentUserId || typeof record?.ownerId === "string" && record.ownerId === currentUserId);
   const ownedKey = currentUserId ? [record?.dbKey, record?.privateKey].find(
@@ -418,8 +423,12 @@ function toSafeAgentSummary(record, options) {
     isOwned,
     isOAuth,
     ...nextAvailableAt !== void 0 ? { nextAvailableAt } : {},
+    ...quota !== void 0 ? { quota } : {},
     ...credentialGroup !== void 0 ? { credentialGroup } : {},
     ...credentialKind !== void 0 ? { credentialKind } : {},
+    // 「未知 ≠ 独立」：无 credentialGroup 时显式 credentialed:false，调用方
+    // 不得把缺失解读成独立凭证（并发扇出守卫依赖这个区分）。
+    credentialed: credentialGroup !== void 0,
     updatedAt
   };
 }
@@ -445,8 +454,11 @@ var COMPACT_AGENT_SUMMARY_FIELDS = [
   // 决策信息（CLI --show-unavailable 场景）；默认列表已把这类 agent 过滤掉，
   // 所以通常根本不占字节。
   "nextAvailableAt",
+  // 额度快照：只有上游真上报过窗口的 agent 才带（通常是小对象）。
+  "quota",
   "credentialGroup",
-  "credentialKind"
+  "credentialKind",
+  "credentialed"
 ];
 function omitNullishAgentSummaryFields(summary) {
   const result = {};
@@ -477,6 +489,7 @@ var UNAVAILABLE_AGENT_SUMMARY_FIELDS = [
   "isOAuth",
   "isOwned",
   "nextAvailableAt",
+  "quota",
   "favoritedAt",
   "updatedAt"
 ];
@@ -496,6 +509,110 @@ function toUnavailableAgentSummary(summary) {
   return item;
 }
 
+// packages/ai/agent/agentDiscovery.ts
+function isPreferredAgent(agent) {
+  return agent.isFavorite === true || agent.isOwned === true || agent.isOAuth === true || agent.billingSource === "user_subscription" || agent.billingSource === "user_api" || agent.billingSource === "local";
+}
+function isPublicDiscoveryAgent(agent) {
+  return agent.isPublic === true && !isPreferredAgent(agent);
+}
+function resolveDiscoveryScope(args) {
+  const rawScope = typeof args?.scope === "string" ? args.scope.trim().toLowerCase() : void 0;
+  const hasScope = rawScope !== void 0 && rawScope !== "";
+  const hasPublicOnly = typeof args?.publicOnly === "boolean";
+  const publicOnly = args?.publicOnly === true;
+  if (hasScope) {
+    if (rawScope !== "preferred" && rawScope !== "public" && rawScope !== "all") {
+      throw new Error(`Invalid scope '${args?.scope}': must be 'preferred', 'public', or 'all'.`);
+    }
+    const scope = rawScope;
+    if (hasPublicOnly) {
+      if (publicOnly && scope !== "public") {
+        throw new Error(
+          `Conflicting arguments: scope='${args?.scope}' conflicts with publicOnly=true.`
+        );
+      }
+      if (!publicOnly && scope === "public") {
+        throw new Error(
+          `Conflicting arguments: scope='${args?.scope}' conflicts with publicOnly=false.`
+        );
+      }
+    }
+    return scope;
+  }
+  if (hasPublicOnly && publicOnly) {
+    return "public";
+  }
+  return "preferred";
+}
+function agentIdentityKeys(agent) {
+  return [agent.agentKey, agent.publicKey, agent.id].filter(
+    (key) => typeof key === "string" && key.length > 0
+  );
+}
+function deduplicateAgentSummaries(agents) {
+  const byIdentity = /* @__PURE__ */ new Map();
+  for (const agent of agents) {
+    const keys = agentIdentityKeys(agent);
+    const existing = keys.map((key) => byIdentity.get(key)).find(Boolean);
+    if (!existing) {
+      for (const key of keys) byIdentity.set(key, agent);
+      continue;
+    }
+    const winner = isPreferredAgent(agent) && !isPreferredAgent(existing) ? agent : existing;
+    for (const key of /* @__PURE__ */ new Set([...agentIdentityKeys(existing), ...keys])) byIdentity.set(key, winner);
+  }
+  return [...new Set(byIdentity.values())];
+}
+function filterAgentsByScope(agents, scope) {
+  const unique = deduplicateAgentSummaries(agents);
+  if (scope === "preferred") return unique.filter((agent) => isPreferredAgent(agent));
+  if (scope === "public") return unique.filter((agent) => isPublicDiscoveryAgent(agent));
+  return unique.filter((agent) => isPreferredAgent(agent) || agent.isPublic === true);
+}
+function matchesAgentQuery(agent, query) {
+  if (!query || typeof query !== "string") return true;
+  const q = query.trim().toLowerCase();
+  if (!q) return true;
+  const candidates = [
+    agent.name,
+    agent.model,
+    agent.provider,
+    agent.handle,
+    agent.agentKey,
+    agent.publicKey,
+    agent.id
+  ];
+  return candidates.some((text) => typeof text === "string" && text.toLowerCase().includes(q));
+}
+function buildAgentDiscoveryResult(options) {
+  const scope = resolveDiscoveryScope({
+    scope: options.scope,
+    publicOnly: options.publicOnly
+  });
+  const now = options.now ?? Date.now();
+  let scopedAgents = filterAgentsByScope(options.agents, scope);
+  if (options.query && typeof options.query === "string" && options.query.trim()) {
+    scopedAgents = scopedAgents.filter((a) => matchesAgentQuery(a, options.query));
+  }
+  const unavailableList = scopedAgents.filter((a) => isAgentUnavailableNow(a, now));
+  const unavailableCount = unavailableList.length;
+  const unavailableAgents = sortSafeAgentSummaries(unavailableList).map(toUnavailableAgentSummary);
+  const credentialGroups = summarizeCredentialGroups(scopedAgents, now);
+  if (options.showUnavailable !== true) {
+    scopedAgents = scopedAgents.filter((a) => !isAgentUnavailableNow(a, now));
+  }
+  const sortedAgents = sortSafeAgentSummaries(scopedAgents);
+  const projectedAgents = options.verbose === true ? sortedAgents.map(omitNullishAgentSummaryFields) : sortedAgents.map(toCompactAgentSummary);
+  return {
+    total: projectedAgents.length,
+    unavailableCount,
+    unavailableAgents,
+    credentialGroups,
+    agents: projectedAgents
+  };
+}
+
 export {
   deriveCredentialGroup,
   summarizeCredentialGroups,
@@ -503,5 +620,8 @@ export {
   sortSafeAgentSummaries,
   omitNullishAgentSummaryFields,
   toCompactAgentSummary,
-  toUnavailableAgentSummary
+  toUnavailableAgentSummary,
+  resolveDiscoveryScope,
+  matchesAgentQuery,
+  buildAgentDiscoveryResult
 };