@primeuicom/agent-setup 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,136 @@
+declare const PRIMEUI_AI_PRESET_VALUES: readonly ["codex", "claude", "cursor"];
+type PrimeUiAiPreset = (typeof PRIMEUI_AI_PRESET_VALUES)[number];
+type PrimeUiAiSetupChoice = PrimeUiAiPreset | "nothing";
+declare const DEFAULT_PRIMEUI_AI_PRESET: PrimeUiAiPreset;
+declare const PRIMEUI_AI_SETUP_CHOICE_VALUES: readonly ["codex", "claude", "cursor", "nothing"];
+declare const PRIMEUI_AI_PRESET_OPTIONS: ReadonlyArray<{
+    value: PrimeUiAiPreset;
+    label: string;
+    hint: string;
+}>;
+declare const PRIMEUI_AI_SETUP_CHOICE_OPTIONS: ReadonlyArray<{
+    value: PrimeUiAiSetupChoice;
+    label: string;
+    hint: string;
+}>;
+declare function isPrimeUiAiPreset(value: string): value is PrimeUiAiPreset;
+declare function isPrimeUiAiSetupChoice(value: string): value is PrimeUiAiSetupChoice;
+
+declare const PRIMEUI_SUPPORTED_AGENT_VALUES: readonly ["claude-code", "codex", "cursor", "gemini-cli", "opencode", "vscode", "zed", "mcporter"];
+type PrimeUiSupportedAgent = (typeof PRIMEUI_SUPPORTED_AGENT_VALUES)[number];
+type PrimeUiAgentSupportLevel = "full" | "mcp-only";
+type PrimeUiSupportedAgentPreset = {
+    agent: PrimeUiSupportedAgent;
+    supportLevel: PrimeUiAgentSupportLevel;
+    presetDirName: PrimeUiSupportedAgent;
+    mcpFiles: string[];
+    detectionPaths: string[];
+    presetInferencePaths?: string[];
+    skillsDirectory?: string;
+    skillsLockFile?: string;
+    aiPreset?: PrimeUiAiPreset;
+};
+declare function listPrimeUiSupportedAgents(): PrimeUiSupportedAgent[];
+declare function listPrimeUiSupportedAgentPresets(): PrimeUiSupportedAgentPreset[];
+declare function getPrimeUiSupportedAgentPreset(agent: PrimeUiSupportedAgent): PrimeUiSupportedAgentPreset;
+declare function getPrimeUiAgentPresetDirectory(agent: PrimeUiSupportedAgent): string;
+declare function listPrimeUiAgentPresetFiles(agent: PrimeUiSupportedAgent): Promise<string[]>;
+
+type PrimeUiAiAgent = "codex" | "claude-code" | "cursor";
+type PrimeUiMcpServerConfig = {
+    type: "stdio";
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+};
+type PrimeUiResolvedMcpConfig = {
+    mcpServers: Record<string, PrimeUiMcpServerConfig>;
+};
+type PrimeUiSkillCollection = {
+    source: string;
+    skills: string[];
+};
+declare const PRIMEUI_SHARED_MCP_CONFIG_PATH = ".mcp.json";
+declare const PRIMEUI_SHARED_SKILLS_LOCK_PATH = "skills-lock.json";
+declare const PRIMEUI_SHARED_VERIFICATION_SCRIPTS: readonly ["format", "lint", "typecheck", "build"];
+declare const PRIMEUI_LOCAL_AI_ARTIFACT_PATHS: readonly [".codex", ".claude", ".cursor", ".agents", ".mcp.json", "skills-lock.json"];
+declare const PRIMEUI_MANAGED_AI_CLEANUP_PATHS: readonly [".codex", ".claude", ".cursor", ".mcp.json"];
+declare function getPrimeUiAiAgent(aiPreset: PrimeUiAiPreset): PrimeUiAiAgent;
+declare function getPrimeUiManagedConfigFiles(aiPreset: PrimeUiAiPreset): string[];
+declare function getPrimeUiManagedInstructionFiles(aiPreset: PrimeUiAiPreset): string[];
+declare function getPrimeUiManagedConfigFileContents(aiPreset: PrimeUiAiPreset): Record<string, string>;
+declare function getPrimeUiManagedInstructionFileContents(aiPreset: PrimeUiAiPreset): Record<string, string>;
+declare function listPrimeUiAiSkillRefs(): string[];
+declare function listPrimeUiAiSkillCollections(): PrimeUiSkillCollection[];
+declare function getPrimeUiInstalledSkillsDirectory(aiPreset: PrimeUiAiPreset): string;
+declare function listPrimeUiAllowedShellCommands(): string[];
+declare function listPrimeUiAllowedMcpServers(): string[];
+declare function listPrimeUiClaudeAllowedPermissions(): string[];
+declare function listPrimeUiCursorAllowedPermissions(): string[];
+declare function listPrimeUiInstructionFilePaths(): string[];
+declare function listPrimeUiVerificationScripts(): string[];
+declare function shouldWritePrimeUiSharedMcpConfig(aiPreset: PrimeUiAiPreset): boolean;
+declare function resolvePrimeUiMcpConfig(env?: NodeJS.ProcessEnv): PrimeUiResolvedMcpConfig;
+declare function createPrimeUiAiSetupEnv(env?: NodeJS.ProcessEnv, primeUiApiBaseUrl?: string): NodeJS.ProcessEnv;
+declare function buildPrimeUiCodexConfigToml(): string;
+declare function buildPrimeUiClaudeSettings(): Record<string, unknown>;
+declare function buildPrimeUiClaudeSettingsFileContent(): string;
+declare function buildPrimeUiCursorCliConfig(): Record<string, unknown>;
+declare function buildPrimeUiCursorCliConfigFileContent(): string;
+
+type CommandResult = {
+    exitCode?: number;
+    stdout: string;
+    stderr: string;
+};
+type ExecaLike = (file: string, args: string[], options: {
+    cwd: string;
+    reject: false;
+    stderr: "pipe";
+    stdout: "pipe";
+}) => Promise<CommandResult>;
+type PrimeUiAiSetupResult = {
+    status: "applied";
+    aiPreset: PrimeUiAiPreset;
+    agent: PrimeUiAiAgent;
+    installedMcpServers: string[];
+    installedSkillRefs: string[];
+};
+type ApplyPrimeUiAiSetupOptions = {
+    aiPreset: PrimeUiAiPreset;
+    env?: NodeJS.ProcessEnv;
+    execaFn?: ExecaLike;
+};
+declare function applyPrimeUiAiSetup(projectDirectory: string, options: ApplyPrimeUiAiSetupOptions): Promise<PrimeUiAiSetupResult>;
+
+type PrimeUiDetectedAgentSignal = {
+    agent: PrimeUiSupportedAgent;
+    supportLevel: PrimeUiSupportedAgentPreset["supportLevel"];
+    matchedPaths: string[];
+};
+type PrimeUiLocalAgentDetectionResult = {
+    detectedAgents: PrimeUiDetectedAgentSignal[];
+};
+declare function detectPrimeUiLocalAgentSetup(projectDirectory: string): Promise<PrimeUiLocalAgentDetectionResult>;
+
+declare const PRIMEUI_AGENT_SETUP_ERROR_CODES: {
+    readonly AI_SETUP_FAILED: "AI_SETUP_FAILED";
+    readonly UNKNOWN: "UNKNOWN";
+};
+type PrimeUiAgentSetupErrorCode = (typeof PRIMEUI_AGENT_SETUP_ERROR_CODES)[keyof typeof PRIMEUI_AGENT_SETUP_ERROR_CODES];
+type PrimeUiAgentSetupErrorOptions = {
+    code?: PrimeUiAgentSetupErrorCode;
+    hint?: string;
+    cause?: unknown;
+};
+declare class PrimeUiAgentSetupError extends Error {
+    readonly code: PrimeUiAgentSetupErrorCode;
+    readonly hint?: string;
+    constructor(message: string, options?: PrimeUiAgentSetupErrorOptions);
+}
+declare function toPrimeUiAgentSetupError(error: unknown): PrimeUiAgentSetupError;
+
+declare function detectPrimeUiAiPresetCandidates(projectDirectory: string): Promise<PrimeUiAiPreset[]>;
+declare function inferPrimeUiAiPreset(projectDirectory: string): Promise<PrimeUiAiPreset | undefined>;
+
+export { type ApplyPrimeUiAiSetupOptions, DEFAULT_PRIMEUI_AI_PRESET, type ExecaLike, PRIMEUI_AGENT_SETUP_ERROR_CODES, PRIMEUI_AI_PRESET_OPTIONS, PRIMEUI_AI_PRESET_VALUES, PRIMEUI_AI_SETUP_CHOICE_OPTIONS, PRIMEUI_AI_SETUP_CHOICE_VALUES, PRIMEUI_LOCAL_AI_ARTIFACT_PATHS, PRIMEUI_MANAGED_AI_CLEANUP_PATHS, PRIMEUI_SHARED_MCP_CONFIG_PATH, PRIMEUI_SHARED_SKILLS_LOCK_PATH, PRIMEUI_SHARED_VERIFICATION_SCRIPTS, PRIMEUI_SUPPORTED_AGENT_VALUES, PrimeUiAgentSetupError, type PrimeUiAgentSetupErrorCode, type PrimeUiAgentSupportLevel, type PrimeUiAiAgent, type PrimeUiAiPreset, type PrimeUiAiSetupChoice, type PrimeUiAiSetupResult, type PrimeUiDetectedAgentSignal, type PrimeUiLocalAgentDetectionResult, type PrimeUiMcpServerConfig, type PrimeUiResolvedMcpConfig, type PrimeUiSkillCollection, type PrimeUiSupportedAgent, type PrimeUiSupportedAgentPreset, applyPrimeUiAiSetup, buildPrimeUiClaudeSettings, buildPrimeUiClaudeSettingsFileContent, buildPrimeUiCodexConfigToml, buildPrimeUiCursorCliConfig, buildPrimeUiCursorCliConfigFileContent, createPrimeUiAiSetupEnv, detectPrimeUiAiPresetCandidates, detectPrimeUiLocalAgentSetup, getPrimeUiAgentPresetDirectory, getPrimeUiAiAgent, getPrimeUiInstalledSkillsDirectory, getPrimeUiManagedConfigFileContents, getPrimeUiManagedConfigFiles, getPrimeUiManagedInstructionFileContents, getPrimeUiManagedInstructionFiles, getPrimeUiSupportedAgentPreset, inferPrimeUiAiPreset, isPrimeUiAiPreset, isPrimeUiAiSetupChoice, listPrimeUiAgentPresetFiles, listPrimeUiAiSkillCollections, listPrimeUiAiSkillRefs, listPrimeUiAllowedMcpServers, listPrimeUiAllowedShellCommands, listPrimeUiClaudeAllowedPermissions, listPrimeUiCursorAllowedPermissions, listPrimeUiInstructionFilePaths, listPrimeUiSupportedAgentPresets, listPrimeUiSupportedAgents, listPrimeUiVerificationScripts, resolvePrimeUiMcpConfig, shouldWritePrimeUiSharedMcpConfig, toPrimeUiAgentSetupError };