File size: 6,506 Bytes
5c2a829
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
import { resolveThinkingDefaultWithRuntimeCatalogCore } from "../agents/model-thinking-default.js";
import {
  getPreparedModelCatalogSnapshot,
  readPreparedModelCatalog,
  type LoadPreparedModelCatalogParams,
} from "../agents/prepared-model-catalog.js";
/**
 * @deprecated Broad public SDK barrel. Prefer focused agent/runtime subpaths
 * and avoid adding new imports here.
 */
import type { PluginMetadataSnapshot } from "../plugins/plugin-metadata-snapshot.types.js";

export {
  listAgentIds,
  resolveAgentEffectiveModelPrimary,
  resolveAgentWorkspaceDir,
  resolveDefaultAgentDir,
  setAgentEffectiveModelPrimary,
} from "../agents/agent-scope.js";
export { resolveSessionAgentIds } from "./agent-scope-runtime.js";

export { DEFAULT_PROVIDER } from "../agents/defaults.js";
// Consumed by the codex plugin's app-server usage surface.
export { CODEX_APP_SERVER_AUTH_MARKER } from "../agents/model-auth-markers.js";
export { resolveAgentAvatar } from "../agents/identity-avatar.js";
export type { AgentAvatarResolution } from "../agents/identity-avatar.js";
export {
  resolveAckReaction,
  resolveAgentIdentity,
  resolveHumanDelayConfig,
  resolveIdentityNamePrefix,
} from "../agents/identity.js";

export { resolveApiKeyForProviderCore as resolveApiKeyForProvider } from "../agents/model-auth.js";
export { findModelInCatalog, modelSupportsVision } from "../agents/model-catalog.js";
export type { ModelCatalogEntry } from "../agents/model-catalog.js";
export { getPreparedModelCatalogSnapshot };

/** Preserves the public SDK's writable default while internal catalog reads stay passive. */
export async function loadPreparedModelCatalog(params: LoadPreparedModelCatalogParams = {}) {
  return await readPreparedModelCatalog({ ...params, readOnly: params.readOnly ?? false });
}

type LoadModelCatalogCompatibilityParams = LoadPreparedModelCatalogParams & {
  /** @deprecated Lifecycle publication owns refreshes; retained for source compatibility. */
  useCache?: boolean;
  /** @deprecated Use getPreparedModelCatalogSnapshot for new nonblocking readers. */
  cacheOnly?: boolean;
  /** @deprecated Plugin metadata belongs to the published lifecycle generation. */
  metadataSnapshot?: Omit<PluginMetadataSnapshot, "owners" | "declaredProviderOwners"> & {
    // Shipped snapshots may predate prepared provider ownership and normalization policies.
    declaredProviderOwners?: PluginMetadataSnapshot["declaredProviderOwners"];
    owners: Omit<PluginMetadataSnapshot["owners"], "modelIdNormalizationPolicies"> &
      Partial<Pick<PluginMetadataSnapshot["owners"], "modelIdNormalizationPolicies">>;
  };
};

/** @deprecated Use loadPreparedModelCatalog or getPreparedModelCatalogSnapshot. */
export async function loadModelCatalog(params: LoadModelCatalogCompatibilityParams = {}) {
  const { agentId, agentDir, cacheOnly, config, env, readOnly, refreshFullCatalog, workspaceDir } =
    params;
  const preparedParams: LoadPreparedModelCatalogParams = {
    ...(agentId ? { agentId } : {}),
    ...(agentDir ? { agentDir } : {}),
    ...(config ? { config } : {}),
    ...(env ? { env } : {}),
    ...(readOnly !== undefined ? { readOnly } : {}),
    ...(refreshFullCatalog !== undefined ? { refreshFullCatalog } : {}),
    ...(workspaceDir ? { workspaceDir } : {}),
  };
  if (cacheOnly) {
    return getPreparedModelCatalogSnapshot(preparedParams)?.entries ?? [];
  }
  return await loadPreparedModelCatalog(preparedParams);
}

export {
  buildModelAliasIndex,
  findNormalizedProviderValue,
  parseModelRef,
  resolveAllowedModelRef,
  resolveModelRefFromString,
} from "../agents/model-selection.js";

// Preserve the v2026.7.1-2 callback contract at the SDK boundary; internal
// owners use loadRuntimeCatalog. Remove only at an approved SDK-breaking boundary.
export function resolveThinkingDefaultWithRuntimeCatalog(
  params: Omit<
    Parameters<typeof resolveThinkingDefaultWithRuntimeCatalogCore>[0],
    "loadRuntimeCatalog"
  > & {
    loadModelCatalog: Parameters<
      typeof resolveThinkingDefaultWithRuntimeCatalogCore
    >[0]["loadRuntimeCatalog"];
  },
) {
  const { loadModelCatalog: loadRuntimeCatalog, ...rest } = params;
  return resolveThinkingDefaultWithRuntimeCatalogCore({
    ...rest,
    loadRuntimeCatalog,
  });
}

export { EmbeddedBlockChunker } from "../agents/embedded-agent-block-chunker.js";
export { formatReasoningMessage } from "../agents/embedded-agent-utils.js";
export { resolveProviderIdForAuth } from "../agents/provider-auth-aliases.js";
export type { ProviderAuthAliasLookupParams } from "../agents/provider-auth-aliases.js";

export {
  readNonNegativeIntegerParam,
  readPositiveIntegerParam,
  readStringArrayParam,
} from "../agents/tools/common.js";

// Intentional public runtime surface: channel plugins use ingress agent helpers directly.
export { agentCommandFromIngress } from "../agents/agent-command.js";
export { getTtsProvider, resolveTtsConfig, resolveTtsPrefsPath } from "../tts/tts.js";
export type { ResolvedTtsConfig } from "../tts/tts.js";

export {
  listProfilesForProvider,
  clearRuntimeAuthProfileStoreSnapshots,
  ensureAuthProfileStore,
  loadAuthProfileStoreWithoutExternalProfiles,
  loadAuthProfileStoreForSecretsRuntime,
  loadAuthProfileStoreForRuntime,
  replaceRuntimeAuthProfileStoreSnapshots,
  saveAuthProfileStore,
  findPersistedAuthProfileCredential,
  resolvePersistedAuthProfileOwnerAgentDir,
  clearExpiredCooldowns,
  isProfileInCooldown,
  markAuthProfileBlockedUntil,
  refreshOAuthCredentialForRuntime,
  resolveProfilesUnavailableReason,
  resolveProfileUnusableUntilForDisplay,
  resolveApiKeyForProfile,
  resolveAuthProfileEligibility,
  resolveAuthProfileOrder,
  resolveAuthStorePathForDisplay,
} from "../agents/auth-profiles.js";
export type {
  AuthProfileCredential,
  AuthProfileFailureReason,
  AuthProfileStore,
  OAuthCredential,
} from "../agents/auth-profiles.js";

export { buildConfiguredModelCatalog } from "../agents/model-selection-shared.js";
export { extractEmbeddedAssistantText as extractAssistantText } from "../agents/embedded-agent-utils.js";
export { jsonResult } from "../agents/tools/tool-results.js";
export { readToolStringParam as readStringParam } from "../agents/tools/common.js";
export {
  resolveAgentConfig,
  resolveAgentDir,
  resolveDefaultAgentId,
} from "../agents/agent-scope-config.js";
export { resolveDefaultModelForAgent } from "../agents/model-selection-config.js";
export { resolveThinkingDefault } from "../agents/model-thinking-default.js";