cdk-insights 1.14.0 → 1.16.0

package/dist/cli/analysisJob.d.ts

@@ -9,6 +9,14 @@ interface ConcurrencyConfig {
     retryDelay: number;
     timeoutMs: number;
 }
+/**
+ * Replace the plaintext logical ID inside a relationship summary entry
+ * (`"MyTable (Table)"`) with a deterministic hash of that ID, preserving
+ * the trailing `(TypeShort)` suffix so the AI still has resource-type
+ * context. Used to scrub user-chosen naming out of dependency lists
+ * before they're sent to the AI service.
+ */
+export declare const redactRelationshipEntry: (entry: string, stackName: string) => string;
 export interface CreateResourceAnalyzerParams {
     analyzeResource: AnalyzeResourceFn;
     redactionMapping: Record<string, string>;
@@ -30,6 +38,8 @@ export interface CreateResourceAnalyzerParams {
         dependents: string[];
         usageDescription?: string;
     }>;
+    /** Resolved Bedrock model ID — forwarded to backend per request. */
+    aiModelId?: string;
 }
 export interface ResourceAnalyzerParams {
     redactedId: string;
@@ -61,6 +71,12 @@ export interface ResourceHandlerParams {
         ttl: number;
         maxSize: number;
     };
+    /**
+     * Resolved Bedrock model ID for AI insights. Forwarded to the backend
+     * which routes the analysis through the chosen model. `undefined` =
+     * backend picks its tier default.
+     */
+    aiModelId?: string;
 }
-export declare const createResourceHandler: ({ analyzeResource, redactResources, config, }: CreateResourceHandlerParams) => ({ stackName, resources, authToken, existingFindingsMap, pathToLogicalId, fingerprint, noCache, cacheConfig, }: ResourceHandlerParams) => Promise<ImportedAnalysisResult>;
+export declare const createResourceHandler: ({ analyzeResource, redactResources, config, }: CreateResourceHandlerParams) => ({ stackName, resources, authToken, existingFindingsMap, pathToLogicalId, fingerprint, noCache, cacheConfig, aiModelId, }: ResourceHandlerParams) => Promise<ImportedAnalysisResult>;
 export {};

package/dist/cli/config/aiModel.d.ts

@@ -0,0 +1,77 @@
+/**
+ * AI Model selection — three-level resolution.
+ *
+ * The user can pick which Bedrock model handles their AI insights via
+ * (in order of precedence):
+ *
+ *   1. `--model <alias>` CLI flag
+ *   2. `cdkInsights:aiModel` context entry in `cdk.json`
+ *   3. `ai.model` field in `.cdk-insights.json` user config
+ *   4. Server-side default (no modelId sent → backend picks)
+ *
+ * Aliases are friendly names like `mistral-14b` rather than raw Bedrock
+ * IDs (`mistral.ministral-3-14b-instruct`); the resolver translates the
+ * alias to the Bedrock ID on the way out so the wire format stays stable.
+ *
+ * Tier gating: each model is gated to one of `free` / `pro` / `team`.
+ * If the resolved alias is above the user's tier, the resolver returns
+ * the tier's default with a warning rather than failing — the analysis
+ * still runs, just on a model the user is allowed to use.
+ */
+import type { Tier } from '../../config/featureGating';
+export type AiModelAlias = 'nova-lite' | 'mistral-14b' | 'llama-3-3-70b' | 'haiku-4-5' | 'sonnet-4-6';
+export interface AiModelDefinition {
+    /** Friendly alias used in flags and config */
+    alias: AiModelAlias;
+    /** AWS Bedrock model identifier sent on the wire */
+    bedrockModelId: string;
+    /** Human-readable name shown in CLI output */
+    displayName: string;
+    /** Lowest tier that may select this model */
+    minTier: Tier;
+    /**
+     * Quota multiplier. A model with multiplier 2 deducts 2 insights per
+     * call from the user's monthly quota. Keeps the per-insight unit cost
+     * roughly aligned across the registry — Pro user's 5,000 insights can
+     * be spent as 5K × Mistral or 1.25K × Haiku, their choice.
+     */
+    quotaMultiplier: number;
+    /** Short description for CLI help / model picker */
+    description: string;
+}
+export declare const AI_MODEL_REGISTRY: Record<AiModelAlias, AiModelDefinition>;
+export declare const TIER_DEFAULT_MODEL: Record<Tier, AiModelAlias>;
+export declare const isAiModelAlias: (value: unknown) => value is AiModelAlias;
+export interface ResolveAiModelArgs {
+    /** `--model` flag, if any */
+    flag?: string;
+    /** `cdkInsights:aiModel` from cdk.json, if any */
+    cdkContext?: string;
+    /** `ai.model` from .cdk-insights.json user config */
+    userConfig?: string;
+    /** User's current tier — gates which models are allowed */
+    tier?: Tier;
+}
+export interface ResolvedAiModel {
+    /** Resolved model alias */
+    alias: AiModelAlias;
+    /** Bedrock ID to send on the wire */
+    bedrockModelId: string;
+    /** Source of the resolution, for logging */
+    source: 'flag' | 'cdkContext' | 'userConfig' | 'tierDefault';
+    /** True if the user's preference was downgraded due to tier gating */
+    downgradedFromTierGate: boolean;
+    /** Original alias the user tried to pick (only set when downgraded) */
+    requestedAlias?: AiModelAlias;
+}
+/**
+ * Walk the resolution sources in precedence order, validate each candidate
+ * against tier gating, and return the resolved model. Falls back to the
+ * tier default (or `mistral-14b` if no tier supplied) when nothing matches.
+ */
+export declare const resolveAiModel: (args: ResolveAiModelArgs) => ResolvedAiModel;
+/**
+ * Lists the models the given tier is allowed to use, sorted by min-tier
+ * then by quota multiplier. Used by the CLI to render help text.
+ */
+export declare const getAvailableModelsForTier: (tier: Tier) => AiModelDefinition[];

package/dist/cli/config/aiModel.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/types/cli.types.d.ts

@@ -23,6 +23,7 @@ export interface AnalyzeCommandArgs {
     local?: boolean;
     warnSensitive?: boolean;
     prComment?: boolean;
+    model?: string;
     cache?: {
         enabled?: boolean;
         ttl?: number;
@@ -83,6 +84,16 @@ export interface UserConfig {
         ttl?: number;
         maxSize?: number;
     };
+    /**
+     * AI analysis configuration. The `model` field selects which Bedrock
+     * model handles AI insights — see `cli/config/aiModel.ts` for the
+     * registry of available aliases. Resolution precedence is
+     * `--model` flag → `cdk.json` `cdkInsights:aiModel` context →
+     * this user config → tier default.
+     */
+    ai?: {
+        model?: string;
+    };
     [key: string]: unknown;
 }
 export interface AnalysisSuccess {