import { type ClaudeSettings, type ModelCapabilities, type ModelSelection, ProviderDriverKind, type ServerProviderModel, type ServerProviderSlashCommand,} from "@t3tools/contracts";import * as DateTime from "effect/DateTime";import * as Effect from "effect/Effect";import * as Option from "effect/Option";import * as Path from "effect/Path";import * as Result from "effect/Result";import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";import { createModelCapabilities, getModelSelectionStringOptionValue, getProviderOptionCurrentValue, getProviderOptionDescriptors,} from "@t3tools/shared/model";import { resolveSpawnCommand } from "@t3tools/shared/shell";import { compareSemverVersions } from "@t3tools/shared/semver";import { query as claudeQuery, type SlashCommand as ClaudeSlashCommand, type SDKUserMessage,} from "@anthropic-ai/claude-agent-sdk"; import { buildBooleanOptionDescriptor, buildSelectOptionDescriptor, buildServerProvider, DEFAULT_TIMEOUT_MS, isCommandMissingCause, parseGenericCliVersion, providerModelsFromSettings, spawnAndCollect, type ServerProviderDraft,} from "../providerSnapshot.ts";import { makeClaudeEnvironment } from "../Drivers/ClaudeHome.ts"; const DEFAULT_CLAUDE_MODEL_CAPABILITIES: ModelCapabilities = createModelCapabilities({ optionDescriptors: [],}); const PROVIDER = ProviderDriverKind.make("claudeAgent");const CLAUDE_PRESENTATION = { displayName: "Claude", showInteractionModeToggle: true,} as const;const MINIMUM_CLAUDE_FABLE_5_VERSION = "2.1.169";const MINIMUM_CLAUDE_OPUS_4_8_VERSION = "2.1.154";const MINIMUM_CLAUDE_OPUS_4_7_VERSION = "2.1.111"; const BUILT_IN_MODELS: ReadonlyArray<ServerProviderModel> = [ { slug: "claude-fable-5", name: "Claude Fable 5", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "xhigh", label: "Extra High" }, { value: "max", label: "Max" }, { value: "ultracode", label: "Ultracode" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildSelectOptionDescriptor({ id: "contextWindow", label: "Context Window", options: [ { value: "200k", label: "200k", isDefault: true }, { value: "1m", label: "1M" }, ], }), ], }), }, { slug: "claude-opus-4-8", name: "Claude Opus 4.8", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "xhigh", label: "Extra High" }, { value: "max", label: "Max" }, { value: "ultracode", label: "Ultracode" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildBooleanOptionDescriptor({ id: "fastMode", label: "Fast Mode", }), ], }), }, { slug: "claude-opus-4-7", name: "Claude Opus 4.7", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High" }, { value: "xhigh", label: "Extra High", isDefault: true }, { value: "max", label: "Max" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildBooleanOptionDescriptor({ id: "fastMode", label: "Fast Mode", }), ], }), }, { slug: "claude-opus-4-6", name: "Claude Opus 4.6", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "max", label: "Max" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildBooleanOptionDescriptor({ id: "fastMode", label: "Fast Mode", }), buildSelectOptionDescriptor({ id: "contextWindow", label: "Context Window", options: [ { value: "200k", label: "200k", isDefault: true }, { value: "1m", label: "1M" }, ], }), ], }), }, { slug: "claude-opus-4-5", name: "Claude Opus 4.5", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "max", label: "Max" }, ], }), buildBooleanOptionDescriptor({ id: "fastMode", label: "Fast Mode", }), ], }), }, { slug: "claude-sonnet-4-6", name: "Claude Sonnet 4.6", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "max", label: "Max" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildSelectOptionDescriptor({ id: "contextWindow", label: "Context Window", options: [ { value: "200k", label: "200k", isDefault: true }, { value: "1m", label: "1M" }, ], }), ], }), }, { slug: "claude-haiku-4-5", name: "Claude Haiku 4.5", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildBooleanOptionDescriptor({ id: "thinking", label: "Thinking", }), ], }), },]; function supportsClaudeFable5(version: string | null | undefined): boolean { return version ? compareSemverVersions(version, MINIMUM_CLAUDE_FABLE_5_VERSION) >= 0 : false;} function supportsClaudeOpus48(version: string | null | undefined): boolean { return version ? compareSemverVersions(version, MINIMUM_CLAUDE_OPUS_4_8_VERSION) >= 0 : false;} function supportsClaudeOpus47(version: string | null | undefined): boolean { return version ? compareSemverVersions(version, MINIMUM_CLAUDE_OPUS_4_7_VERSION) >= 0 : false;} function getBuiltInClaudeModelsForVersion( version: string | null | undefined,): ReadonlyArray<ServerProviderModel> { return BUILT_IN_MODELS.filter((model) => { if (model.slug === "claude-fable-5") { return supportsClaudeFable5(version); } if (model.slug === "claude-opus-4-8") { return supportsClaudeOpus48(version); } if (model.slug === "claude-opus-4-7") { return supportsClaudeOpus47(version); } return true; });} function formatClaudeFable5UpgradeMessage(version: string | null): string { const versionLabel = version ? `v${version}` : "the installed version"; return `Claude Code ${versionLabel} is too old for Claude Fable 5. Upgrade to v${MINIMUM_CLAUDE_FABLE_5_VERSION} or newer to access it.`;} function formatClaudeOpus48UpgradeMessage(version: string | null): string { const versionLabel = version ? `v${version}` : "the installed version"; return `Claude Code ${versionLabel} is too old for Claude Opus 4.8. Upgrade to v${MINIMUM_CLAUDE_OPUS_4_8_VERSION} or newer to access it.`;} function formatClaudeOpus47UpgradeMessage(version: string | null): string { const versionLabel = version ? `v${version}` : "the installed version"; return `Claude Code ${versionLabel} is too old for Claude Opus 4.7. Upgrade to v${MINIMUM_CLAUDE_OPUS_4_7_VERSION} or newer to access it.`;} export function getClaudeModelCapabilities(model: string | null | undefined): ModelCapabilities { const slug = model?.trim(); return ( BUILT_IN_MODELS.find((candidate) => candidate.slug === slug)?.capabilities ?? DEFAULT_CLAUDE_MODEL_CAPABILITIES );} export function resolveClaudeEffort( caps: ModelCapabilities, raw: string | null | undefined,): string | undefined { const descriptors = getProviderOptionDescriptors({ caps, ...(raw ? { selections: [{ id: "effort", value: raw }] } : {}), }); const effortDescriptor = descriptors.find((descriptor) => descriptor.id === "effort"); const value = getProviderOptionCurrentValue(effortDescriptor); return typeof value === "string" ? value : undefined;} /** * Normalize a resolved Claude effort value into one suitable for the Claude * CLI's `--effort` flag. * * Mirrors the mapping used when invoking the Claude Agent SDK * ({@link getEffectiveClaudeAgentEffort} in ClaudeAdapter): `ultracode` is a * Claude Code setting that pairs with `xhigh`, `ultrathink` is filtered out * because it is a prompt-prefix mode, and older model compatibility mappings * are preserved for current Claude Code behavior. */export function normalizeClaudeCliEffort( effort: string | null | undefined, model: string | null | undefined,): string | undefined { if (!effort || effort === "ultrathink") { return undefined; } if (effort === "ultracode") { return "xhigh"; } if (effort === "xhigh" && model !== "claude-fable-5" && model !== "claude-opus-4-8") { return "max"; } if (effort === "max" && model === "claude-sonnet-4-6") { return "high"; } return effort;} export function isClaudeUltracodeEffort(effort: string | null | undefined): boolean { return effort === "ultracode";} export function resolveClaudeApiModelId(modelSelection: ModelSelection): string { switch (getModelSelectionStringOptionValue(modelSelection, "contextWindow")) { case "1m": return `${modelSelection.model}[1m]`; default: return modelSelection.model; }} function toTitleCaseWords(value: string): string { const parts: Array<string> = []; for (const part of value.split(/[\s_-]+/g)) { if (part.length > 0) { parts.push(part[0]!.toUpperCase() + part.slice(1).toLowerCase()); } } return parts.join(" ");} function claudeSubscriptionLabel(subscriptionType: string | undefined): string | undefined { const normalized = subscriptionType?.toLowerCase().replace(/[\s_-]+/g, ""); if (!normalized) return undefined; switch (normalized) { case "claudemaxsubscription": return "Max"; case "claudemax5xsubscription": return "Max 5x"; case "claudemax20xsubscription": return "Max 20x"; case "claudeenterprisesubscription": return "Enterprise"; case "claudeteamsubscription": return "Team"; case "claudeprosubscription": return "Pro"; case "claudefreesubscription": return "Free"; case "max": case "maxplan": return "Max"; case "max5": return "Max 5x"; case "max20": return "Max 20x"; case "enterprise": return "Enterprise"; case "team": return "Team"; case "pro": return "Pro"; case "free": return "Free"; default: return toTitleCaseWords(subscriptionType!); }} function normalizeClaudeAuthMethod(authMethod: string | undefined): string | undefined { const normalized = authMethod?.toLowerCase().replace(/[\s_-]+/g, ""); if (!normalized) return undefined; if ( normalized === "apikey" || normalized === "anthropicapikey" || normalized === "anthropicauthtoken" ) { return "apiKey"; } return undefined;} function formatClaudeSubscriptionAuthLabel(subscriptionType: string): string { const subscriptionLabel = claudeSubscriptionLabel(subscriptionType) ?? toTitleCaseWords(subscriptionType); const normalized = subscriptionLabel.toLowerCase().replace(/[\s_-]+/g, ""); if (normalized.startsWith("claude") && normalized.endsWith("subscription")) { return subscriptionLabel; } if (normalized.startsWith("claude")) { return `${subscriptionLabel} Subscription`; } if (normalized.endsWith("subscription")) { return `Claude ${subscriptionLabel}`; } return `Claude ${subscriptionLabel} Subscription`;} function claudeAuthMetadata(input: { readonly subscriptionType: string | undefined; readonly authMethod: string | undefined;}): { readonly type: string; readonly label: string } | undefined { if (normalizeClaudeAuthMethod(input.authMethod) === "apiKey") { return { type: "apiKey", label: "Claude API Key", }; } if (input.subscriptionType) { return { type: input.subscriptionType, label: formatClaudeSubscriptionAuthLabel(input.subscriptionType), }; } return undefined;} // ── SDK capability probe ──────────────────────────────────────────── const CAPABILITIES_PROBE_TIMEOUT_MS = 8_000; function nonEmptyProbeString(value: string): string | undefined { const candidate = value.trim(); return candidate ? candidate : undefined;} type ClaudeCapabilitiesProbe = { readonly email: string | undefined; readonly subscriptionType: string | undefined; readonly tokenSource: string | undefined; readonly slashCommands: ReadonlyArray<ServerProviderSlashCommand>;}; function parseClaudeInitializationCommands( commands: ReadonlyArray<ClaudeSlashCommand> | undefined,): ReadonlyArray<ServerProviderSlashCommand> { return dedupeSlashCommands( (commands ?? []).flatMap((command) => { const name = nonEmptyProbeString(command.name); if (!name) { return []; } const description = nonEmptyProbeString(command.description); const argumentHint = nonEmptyProbeString(command.argumentHint); return [ { name, ...(description ? { description } : {}), ...(argumentHint ? { input: { hint: argumentHint } } : {}), } satisfies ServerProviderSlashCommand, ]; }), );} function dedupeSlashCommands( commands: ReadonlyArray<ServerProviderSlashCommand>,): ReadonlyArray<ServerProviderSlashCommand> { const commandsByName = new Map<string, ServerProviderSlashCommand>(); for (const command of commands) { const name = nonEmptyProbeString(command.name); if (!name) { continue; } const key = name.toLowerCase(); const existing = commandsByName.get(key); if (!existing) {Lines 1–500 of 829. Load more
import { type ClaudeSettings, type ModelCapabilities, type ModelSelection, ProviderDriverKind, type ServerProviderModel, type ServerProviderSlashCommand, } from "@t3tools/contracts"; import * as DateTime from "effect/DateTime"; import * as Effect from "effect/Effect"; import * as Option from "effect/Option"; import * as Path from "effect/Path"; import * as Result from "effect/Result"; import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process"; import { createModelCapabilities, getModelSelectionStringOptionValue, getProviderOptionCurrentValue, getProviderOptionDescriptors, } from "@t3tools/shared/model"; import { resolveSpawnCommand } from "@t3tools/shared/shell"; import { compareSemverVersions } from "@t3tools/shared/semver"; import { query as claudeQuery, type SlashCommand as ClaudeSlashCommand, type SDKUserMessage, } from "@anthropic-ai/claude-agent-sdk"; import { buildBooleanOptionDescriptor, buildSelectOptionDescriptor, buildServerProvider, DEFAULT_TIMEOUT_MS, isCommandMissingCause, parseGenericCliVersion, providerModelsFromSettings, spawnAndCollect, type ServerProviderDraft, } from "../providerSnapshot.ts"; import { makeClaudeEnvironment } from "../Drivers/ClaudeHome.ts"; const DEFAULT_CLAUDE_MODEL_CAPABILITIES: ModelCapabilities = createModelCapabilities({ optionDescriptors: [], }); const PROVIDER = ProviderDriverKind.make("claudeAgent"); const CLAUDE_PRESENTATION = { displayName: "Claude", showInteractionModeToggle: true, } as const; const MINIMUM_CLAUDE_FABLE_5_VERSION = "2.1.169"; const MINIMUM_CLAUDE_OPUS_4_8_VERSION = "2.1.154"; const MINIMUM_CLAUDE_OPUS_4_7_VERSION = "2.1.111"; const BUILT_IN_MODELS: ReadonlyArray<ServerProviderModel> = [ { slug: "claude-fable-5", name: "Claude Fable 5", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "xhigh", label: "Extra High" }, { value: "max", label: "Max" }, { value: "ultracode", label: "Ultracode" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildSelectOptionDescriptor({ id: "contextWindow", label: "Context Window", options: [ { value: "200k", label: "200k", isDefault: true }, { value: "1m", label: "1M" }, ], }), ], }), }, { slug: "claude-opus-4-8", name: "Claude Opus 4.8", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "xhigh", label: "Extra High" }, { value: "max", label: "Max" }, { value: "ultracode", label: "Ultracode" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildBooleanOptionDescriptor({ id: "fastMode", label: "Fast Mode", }), ], }), }, { slug: "claude-opus-4-7", name: "Claude Opus 4.7", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High" }, { value: "xhigh", label: "Extra High", isDefault: true }, { value: "max", label: "Max" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildBooleanOptionDescriptor({ id: "fastMode", label: "Fast Mode", }), ], }), }, { slug: "claude-opus-4-6", name: "Claude Opus 4.6", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "max", label: "Max" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildBooleanOptionDescriptor({ id: "fastMode", label: "Fast Mode", }), buildSelectOptionDescriptor({ id: "contextWindow", label: "Context Window", options: [ { value: "200k", label: "200k", isDefault: true }, { value: "1m", label: "1M" }, ], }), ], }), }, { slug: "claude-opus-4-5", name: "Claude Opus 4.5", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "max", label: "Max" }, ], }), buildBooleanOptionDescriptor({ id: "fastMode", label: "Fast Mode", }), ], }), }, { slug: "claude-sonnet-4-6", name: "Claude Sonnet 4.6", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildSelectOptionDescriptor({ id: "effort", label: "Reasoning", options: [ { value: "low", label: "Low" }, { value: "medium", label: "Medium" }, { value: "high", label: "High", isDefault: true }, { value: "max", label: "Max" }, { value: "ultrathink", label: "Ultrathink" }, ], promptInjectedValues: ["ultrathink"], }), buildSelectOptionDescriptor({ id: "contextWindow", label: "Context Window", options: [ { value: "200k", label: "200k", isDefault: true }, { value: "1m", label: "1M" }, ], }), ], }), }, { slug: "claude-haiku-4-5", name: "Claude Haiku 4.5", isCustom: false, capabilities: createModelCapabilities({ optionDescriptors: [ buildBooleanOptionDescriptor({ id: "thinking", label: "Thinking", }), ], }), }, ]; function supportsClaudeFable5(version: string | null | undefined): boolean { return version ? compareSemverVersions(version, MINIMUM_CLAUDE_FABLE_5_VERSION) >= 0 : false; } function supportsClaudeOpus48(version: string | null | undefined): boolean { return version ? compareSemverVersions(version, MINIMUM_CLAUDE_OPUS_4_8_VERSION) >= 0 : false; } function supportsClaudeOpus47(version: string | null | undefined): boolean { return version ? compareSemverVersions(version, MINIMUM_CLAUDE_OPUS_4_7_VERSION) >= 0 : false; } function getBuiltInClaudeModelsForVersion( version: string | null | undefined, ): ReadonlyArray<ServerProviderModel> { return BUILT_IN_MODELS.filter((model) => { if (model.slug === "claude-fable-5") { return supportsClaudeFable5(version); } if (model.slug === "claude-opus-4-8") { return supportsClaudeOpus48(version); } if (model.slug === "claude-opus-4-7") { return supportsClaudeOpus47(version); } return true; }); } function formatClaudeFable5UpgradeMessage(version: string | null): string { const versionLabel = version ? `v${version}` : "the installed version"; return `Claude Code ${versionLabel} is too old for Claude Fable 5. Upgrade to v${MINIMUM_CLAUDE_FABLE_5_VERSION} or newer to access it.`; } function formatClaudeOpus48UpgradeMessage(version: string | null): string { const versionLabel = version ? `v${version}` : "the installed version"; return `Claude Code ${versionLabel} is too old for Claude Opus 4.8. Upgrade to v${MINIMUM_CLAUDE_OPUS_4_8_VERSION} or newer to access it.`; } function formatClaudeOpus47UpgradeMessage(version: string | null): string { const versionLabel = version ? `v${version}` : "the installed version"; return `Claude Code ${versionLabel} is too old for Claude Opus 4.7. Upgrade to v${MINIMUM_CLAUDE_OPUS_4_7_VERSION} or newer to access it.`; } export function getClaudeModelCapabilities(model: string | null | undefined): ModelCapabilities { const slug = model?.trim(); return ( BUILT_IN_MODELS.find((candidate) => candidate.slug === slug)?.capabilities ?? DEFAULT_CLAUDE_MODEL_CAPABILITIES ); } export function resolveClaudeEffort( caps: ModelCapabilities, raw: string | null | undefined, ): string | undefined { const descriptors = getProviderOptionDescriptors({ caps, ...(raw ? { selections: [{ id: "effort", value: raw }] } : {}), }); const effortDescriptor = descriptors.find((descriptor) => descriptor.id === "effort"); const value = getProviderOptionCurrentValue(effortDescriptor); return typeof value === "string" ? value : undefined; } /** * Normalize a resolved Claude effort value into one suitable for the Claude * CLI's `--effort` flag. * * Mirrors the mapping used when invoking the Claude Agent SDK * ({@link getEffectiveClaudeAgentEffort} in ClaudeAdapter): `ultracode` is a * Claude Code setting that pairs with `xhigh`, `ultrathink` is filtered out * because it is a prompt-prefix mode, and older model compatibility mappings * are preserved for current Claude Code behavior. */ export function normalizeClaudeCliEffort( effort: string | null | undefined, model: string | null | undefined, ): string | undefined { if (!effort || effort === "ultrathink") { return undefined; } if (effort === "ultracode") { return "xhigh"; } if (effort === "xhigh" && model !== "claude-fable-5" && model !== "claude-opus-4-8") { return "max"; } if (effort === "max" && model === "claude-sonnet-4-6") { return "high"; } return effort; } export function isClaudeUltracodeEffort(effort: string | null | undefined): boolean { return effort === "ultracode"; } export function resolveClaudeApiModelId(modelSelection: ModelSelection): string { switch (getModelSelectionStringOptionValue(modelSelection, "contextWindow")) { case "1m": return `${modelSelection.model}[1m]`; default: return modelSelection.model; } } function toTitleCaseWords(value: string): string { const parts: Array<string> = []; for (const part of value.split(/[\s_-]+/g)) { if (part.length > 0) { parts.push(part[0]!.toUpperCase() + part.slice(1).toLowerCase()); } } return parts.join(" "); } function claudeSubscriptionLabel(subscriptionType: string | undefined): string | undefined { const normalized = subscriptionType?.toLowerCase().replace(/[\s_-]+/g, ""); if (!normalized) return undefined; switch (normalized) { case "claudemaxsubscription": return "Max"; case "claudemax5xsubscription": return "Max 5x"; case "claudemax20xsubscription": return "Max 20x"; case "claudeenterprisesubscription": return "Enterprise"; case "claudeteamsubscription": return "Team"; case "claudeprosubscription": return "Pro"; case "claudefreesubscription": return "Free"; case "max": case "maxplan": return "Max"; case "max5": return "Max 5x"; case "max20": return "Max 20x"; case "enterprise": return "Enterprise"; case "team": return "Team"; case "pro": return "Pro"; case "free": return "Free"; default: return toTitleCaseWords(subscriptionType!); } } function normalizeClaudeAuthMethod(authMethod: string | undefined): string | undefined { const normalized = authMethod?.toLowerCase().replace(/[\s_-]+/g, ""); if (!normalized) return undefined; if ( normalized === "apikey" || normalized === "anthropicapikey" || normalized === "anthropicauthtoken" ) { return "apiKey"; } return undefined; } function formatClaudeSubscriptionAuthLabel(subscriptionType: string): string { const subscriptionLabel = claudeSubscriptionLabel(subscriptionType) ?? toTitleCaseWords(subscriptionType); const normalized = subscriptionLabel.toLowerCase().replace(/[\s_-]+/g, ""); if (normalized.startsWith("claude") && normalized.endsWith("subscription")) { return subscriptionLabel; } if (normalized.startsWith("claude")) { return `${subscriptionLabel} Subscription`; } if (normalized.endsWith("subscription")) { return `Claude ${subscriptionLabel}`; } return `Claude ${subscriptionLabel} Subscription`; } function claudeAuthMetadata(input: { readonly subscriptionType: string | undefined; readonly authMethod: string | undefined; }): { readonly type: string; readonly label: string } | undefined { if (normalizeClaudeAuthMethod(input.authMethod) === "apiKey") { return { type: "apiKey", label: "Claude API Key", }; } if (input.subscriptionType) { return { type: input.subscriptionType, label: formatClaudeSubscriptionAuthLabel(input.subscriptionType), }; } return undefined; } // ── SDK capability probe ──────────────────────────────────────────── const CAPABILITIES_PROBE_TIMEOUT_MS = 8_000; function nonEmptyProbeString(value: string): string | undefined { const candidate = value.trim(); return candidate ? candidate : undefined; } type ClaudeCapabilitiesProbe = { readonly email: string | undefined; readonly subscriptionType: string | undefined; readonly tokenSource: string | undefined; readonly slashCommands: ReadonlyArray<ServerProviderSlashCommand>; }; function parseClaudeInitializationCommands( commands: ReadonlyArray<ClaudeSlashCommand> | undefined, ): ReadonlyArray<ServerProviderSlashCommand> { return dedupeSlashCommands( (commands ?? []).flatMap((command) => { const name = nonEmptyProbeString(command.name); if (!name) { return []; } const description = nonEmptyProbeString(command.description); const argumentHint = nonEmptyProbeString(command.argumentHint); return [ { name, ...(description ? { description } : {}), ...(argumentHint ? { input: { hint: argumentHint } } : {}), } satisfies ServerProviderSlashCommand, ]; }), ); } function dedupeSlashCommands( commands: ReadonlyArray<ServerProviderSlashCommand>, ): ReadonlyArray<ServerProviderSlashCommand> { const commandsByName = new Map<string, ServerProviderSlashCommand>(); for (const command of commands) { const name = nonEmptyProbeString(command.name); if (!name) { continue; } const key = name.toLowerCase(); const existing = commandsByName.get(key); if (!existing) {