captify 0.1.15

package/dist/services/llm/constants/llm.constants.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Constants for LLM provider and model management
+ */
+export declare const LLM_KEYS: {
+    readonly SEPARATOR: "#";
+    readonly PARTITION_KEY_PREFIX: {
+        readonly TENANT: "TENANT#";
+    };
+    readonly SORT_KEY: {
+        readonly PROVIDER_PREFIX: "PROVIDER#";
+        readonly MODEL_PREFIX: "MODEL#";
+        readonly METADATA: "METADATA";
+        readonly CONFIG_PREFIX: "CONFIG#";
+    };
+};
+export declare const PROVIDER_TYPES: readonly ["openai", "anthropic", "bedrock"];
+export type ProviderType = (typeof PROVIDER_TYPES)[number];
+export declare const MODEL_CAPABILITIES: readonly ["chat", "vision", "thinking", "streaming", "function-calling", "image-generation"];
+export type ModelCapability = (typeof MODEL_CAPABILITIES)[number];
+export declare function buildTenantPK(tenantId: string): string;
+export declare function buildProviderSK(providerId: string): string;
+export declare function buildModelSK(providerId: string, modelId: string): string;
+export declare function buildUserConfigPK(userId: string): string;
+export declare function buildUserConfigSK(providerId: string, modelId: string): string;
+export declare const LLM_LIMITS: {
+    readonly MAX_PROVIDER_NAME_LENGTH: 100;
+    readonly MAX_MODEL_NAME_LENGTH: 500;
+    readonly MAX_NICKNAME_LENGTH: 50;
+    readonly MAX_BASE_URL_LENGTH: 500;
+    readonly MAX_DESCRIPTION_LENGTH: 1000;
+};
+/**
+ * Error and validation messages for LLM service
+ */
+export declare const LLM_ERROR_MESSAGES: {
+    readonly DESCRIPTION_TOO_LONG: "Description exceeds maximum length";
+    readonly USER_ID_REQUIRED: "User ID is required";
+    readonly USER_ID_TOO_LONG: "User ID exceeds maximum length";
+    readonly PROVIDER_ID_REQUIRED: "Provider ID is required";
+    readonly PROVIDER_ID_INVALID_FORMAT: "Provider ID must be a UUID";
+    readonly PROVIDER_ID_TOO_LONG: "Provider ID exceeds maximum length";
+    readonly PROVIDER_NOT_FOUND: "Provider not found";
+    readonly PROVIDER_NOT_ENABLED: "Provider is not enabled";
+    readonly PROVIDER_NAME_REQUIRED: "Provider name is required";
+    readonly PROVIDER_NAME_TOO_LONG: "Provider name exceeds maximum length";
+    readonly PROVIDER_TYPE_INVALID: "Invalid provider type";
+    readonly MODEL_ID_REQUIRED: "Model ID is required";
+    readonly MODEL_ID_TOO_LONG: "Model ID exceeds maximum length";
+    readonly MODEL_NOT_FOUND: "Model not found";
+    readonly MODEL_NAME_REQUIRED: "Model name is required";
+    readonly MODEL_NAME_TOO_LONG: "Model name exceeds maximum length";
+    readonly MODEL_NOT_AVAILABLE: "Model is not currently available";
+    readonly MODEL_CAPABILITY_INVALID: "Invalid model capability";
+    readonly BASIC_ASSISTANT_DEFAULT_NOT_FOUND: "No Basic Assistant default model configured";
+    readonly BASIC_ASSISTANT_MODEL_UNAVAILABLE: "Configured Basic Assistant default model is unavailable";
+    readonly BASIC_ASSISTANT_PROVIDER_DISABLED: "Provider for Basic Assistant default model is disabled";
+    readonly BASIC_ASSISTANT_NO_FALLBACK: "No available model found for Basic Assistant fallback";
+    readonly BASE_URL_REQUIRED: "Base URL is required";
+    readonly BASE_URL_TOO_LONG: "Base URL exceeds maximum length";
+    readonly BASE_URL_INVALID: "Invalid URL format";
+    readonly INVALID_PROVIDER_STRUCTURE: "Invalid provider data structure";
+    readonly INVALID_MODEL_STRUCTURE: "Invalid model data structure";
+    readonly INVALID_CONFIG_STRUCTURE: "Invalid user configuration data structure";
+    readonly STREAMING_FAILED: "Failed to stream response from model";
+    readonly PROVIDER_API_ERROR: "Provider API error";
+};
+/**
+ * Success messages for LLM service
+ */
+export declare const LLM_SUCCESS_MESSAGES: {
+    readonly PROVIDER_CREATED: "Provider created successfully";
+    readonly PROVIDER_UPDATED: "Provider updated successfully";
+    readonly PROVIDER_DELETED: "Provider deleted successfully";
+    readonly MODEL_CREATED: "Model created successfully";
+    readonly MODEL_UPDATED: "Model updated successfully";
+    readonly MODEL_DELETED: "Model deleted successfully";
+    readonly CONFIG_CREATED: "Configuration created successfully";
+    readonly CONFIG_UPDATED: "Configuration updated successfully";
+    readonly CONFIG_DELETED: "Configuration deleted successfully";
+    readonly CONFIG_SET_DEFAULT: "Default model configuration updated";
+    readonly BASIC_ASSISTANT_DEFAULT_SET: "Model set as Basic Assistant default";
+    readonly BASIC_ASSISTANT_DEFAULT_CLEARED: "Basic Assistant default cleared";
+};
+//# sourceMappingURL=llm.constants.d.ts.map

package/dist/services/llm/constants/llm.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.constants.d.ts","sourceRoot":"","sources":["../../../../lib/services/llm/constants/llm.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWX,CAAC;AAGX,eAAO,MAAM,cAAc,6CAA8C,CAAC;AAE1E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAG3D,eAAO,MAAM,kBAAkB,8FAOrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIlE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAID,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AAID,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAExE;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAGD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7E;AAGD,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;CAavB,CAAC"}

package/dist/services/llm/constants/llm.constants.js

@@ -0,0 +1,118 @@
+/**
+ * Constants for LLM provider and model management
+ */
+// Key structure constants
+export const LLM_KEYS = {
+    SEPARATOR: "#",
+    PARTITION_KEY_PREFIX: {
+        TENANT: "TENANT#",
+    },
+    SORT_KEY: {
+        PROVIDER_PREFIX: "PROVIDER#",
+        MODEL_PREFIX: "MODEL#",
+        METADATA: "METADATA",
+        CONFIG_PREFIX: "CONFIG#",
+    },
+};
+// Provider types
+export const PROVIDER_TYPES = ["openai", "anthropic", "bedrock"];
+// Model capabilities
+export const MODEL_CAPABILITIES = [
+    "chat",
+    "vision",
+    "thinking",
+    "streaming",
+    "function-calling",
+    "image-generation",
+];
+// Build partition key for tenant (shared by all providers and models)
+// Format: TENANT#{tenantId}
+export function buildTenantPK(tenantId) {
+    return `${LLM_KEYS.PARTITION_KEY_PREFIX.TENANT}${tenantId}`;
+}
+// Build sort key for provider metadata
+// Format: METADATA#PROVIDER#{providerId}
+export function buildProviderSK(providerId) {
+    return `${LLM_KEYS.SORT_KEY.METADATA}${LLM_KEYS.SEPARATOR}${LLM_KEYS.SORT_KEY.PROVIDER_PREFIX}${providerId}`;
+}
+// Build sort key for model
+// Format: MODEL#{providerId}#{modelId}
+export function buildModelSK(providerId, modelId) {
+    return `${LLM_KEYS.SORT_KEY.MODEL_PREFIX}${providerId}${LLM_KEYS.SEPARATOR}${modelId}`;
+}
+// Build partition key for user config
+export function buildUserConfigPK(userId) {
+    return `USER${LLM_KEYS.SEPARATOR}${userId}`;
+}
+// Build sort key for user config
+export function buildUserConfigSK(providerId, modelId) {
+    return `${LLM_KEYS.SORT_KEY.CONFIG_PREFIX}${providerId}${LLM_KEYS.SEPARATOR}${modelId}`;
+}
+// Validation limits
+export const LLM_LIMITS = {
+    MAX_PROVIDER_NAME_LENGTH: 100,
+    MAX_MODEL_NAME_LENGTH: 500,
+    MAX_NICKNAME_LENGTH: 50,
+    MAX_BASE_URL_LENGTH: 500,
+    MAX_DESCRIPTION_LENGTH: 1000,
+};
+/**
+ * Error and validation messages for LLM service
+ */
+export const LLM_ERROR_MESSAGES = {
+    DESCRIPTION_TOO_LONG: "Description exceeds maximum length",
+    // User validation
+    USER_ID_REQUIRED: "User ID is required",
+    USER_ID_TOO_LONG: "User ID exceeds maximum length",
+    // Provider validation
+    PROVIDER_ID_REQUIRED: "Provider ID is required",
+    PROVIDER_ID_INVALID_FORMAT: "Provider ID must be a UUID",
+    PROVIDER_ID_TOO_LONG: "Provider ID exceeds maximum length",
+    PROVIDER_NOT_FOUND: "Provider not found",
+    PROVIDER_NOT_ENABLED: "Provider is not enabled",
+    PROVIDER_NAME_REQUIRED: "Provider name is required",
+    PROVIDER_NAME_TOO_LONG: "Provider name exceeds maximum length",
+    PROVIDER_TYPE_INVALID: "Invalid provider type",
+    // Model validation
+    MODEL_ID_REQUIRED: "Model ID is required",
+    MODEL_ID_TOO_LONG: "Model ID exceeds maximum length",
+    MODEL_NOT_FOUND: "Model not found",
+    MODEL_NAME_REQUIRED: "Model name is required",
+    MODEL_NAME_TOO_LONG: "Model name exceeds maximum length",
+    MODEL_NOT_AVAILABLE: "Model is not currently available",
+    MODEL_CAPABILITY_INVALID: "Invalid model capability",
+    // Basic Assistant validation
+    BASIC_ASSISTANT_DEFAULT_NOT_FOUND: "No Basic Assistant default model configured",
+    BASIC_ASSISTANT_MODEL_UNAVAILABLE: "Configured Basic Assistant default model is unavailable",
+    BASIC_ASSISTANT_PROVIDER_DISABLED: "Provider for Basic Assistant default model is disabled",
+    BASIC_ASSISTANT_NO_FALLBACK: "No available model found for Basic Assistant fallback",
+    // Base URL validation
+    BASE_URL_REQUIRED: "Base URL is required",
+    BASE_URL_TOO_LONG: "Base URL exceeds maximum length",
+    BASE_URL_INVALID: "Invalid URL format",
+    // Data structure validation
+    INVALID_PROVIDER_STRUCTURE: "Invalid provider data structure",
+    INVALID_MODEL_STRUCTURE: "Invalid model data structure",
+    INVALID_CONFIG_STRUCTURE: "Invalid user configuration data structure",
+    // Operations
+    STREAMING_FAILED: "Failed to stream response from model",
+    PROVIDER_API_ERROR: "Provider API error",
+};
+/**
+ * Success messages for LLM service
+ */
+export const LLM_SUCCESS_MESSAGES = {
+    PROVIDER_CREATED: "Provider created successfully",
+    PROVIDER_UPDATED: "Provider updated successfully",
+    PROVIDER_DELETED: "Provider deleted successfully",
+    MODEL_CREATED: "Model created successfully",
+    MODEL_UPDATED: "Model updated successfully",
+    MODEL_DELETED: "Model deleted successfully",
+    CONFIG_CREATED: "Configuration created successfully",
+    CONFIG_UPDATED: "Configuration updated successfully",
+    CONFIG_DELETED: "Configuration deleted successfully",
+    CONFIG_SET_DEFAULT: "Default model configuration updated",
+    BASIC_ASSISTANT_DEFAULT_SET: "Model set as Basic Assistant default",
+    BASIC_ASSISTANT_DEFAULT_CLEARED: "Basic Assistant default cleared",
+};
+//# sourceMappingURL=llm.constants.js.map

package/dist/services/llm/constants/llm.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.constants.js","sourceRoot":"","sources":["../../../../lib/services/llm/constants/llm.constants.ts"],"names":[],"mappings":"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"}

package/dist/services/llm/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./llm-errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/llm/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/services/llm/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/services/llm/errors/index.js

@@ -0,0 +1,2 @@
+export * from "./llm-errors";
+//# sourceMappingURL=index.js.map

package/dist/services/llm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/services/llm/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/services/llm/errors/llm-errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Custom error classes for LLM service
+ */
+import { NotFoundError, ValidationError } from "../../shared";
+/**
+ * Error thrown when a provider is not found
+ */
+export declare class ProviderNotFoundError extends NotFoundError {
+    constructor(providerId: string);
+}
+/**
+ * Error thrown when a model is not found
+ */
+export declare class ModelNotFoundError extends NotFoundError {
+    constructor(modelId: string);
+}
+/**
+ * Error thrown when a model is not available
+ */
+export declare class ModelNotAvailableError extends ValidationError {
+    constructor(providerId: string, modelId: string);
+}
+/**
+ * Error thrown when a provider type is invalid
+ */
+export declare class InvalidProviderTypeError extends ValidationError {
+    constructor(providerType: string);
+}
+/**
+ * Error thrown when a capability is invalid
+ */
+export declare class InvalidModelCapabilityError extends ValidationError {
+    constructor(capability: string);
+}
+/**
+ * Error thrown when a provider API error occurs
+ */
+export declare class ProviderAPIError extends Error {
+    constructor(providerId: string, message: string);
+}
+/**
+ * Error thrown when streaming a response fails
+ */
+export declare class StreamingError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=llm-errors.d.ts.map

package/dist/services/llm/errors/llm-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-errors.d.ts","sourceRoot":"","sources":["../../../../lib/services/llm/errors/llm-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEvE;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,UAAU,EAAE,MAAM;CAI/B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,eAAe;gBAC7C,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIhD;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,eAAe;gBAC/C,YAAY,EAAE,MAAM;CAIjC;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,eAAe;gBAClD,UAAU,EAAE,MAAM;CAI/B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIhD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/services/llm/errors/llm-errors.js

@@ -0,0 +1,69 @@
+/**
+ * Custom error classes for LLM service
+ */
+import { LLM_ERROR_MESSAGES } from "../constants";
+import { NotFoundError, ValidationError } from "../../shared";
+/**
+ * Error thrown when a provider is not found
+ */
+export class ProviderNotFoundError extends NotFoundError {
+    constructor(providerId) {
+        super(`${LLM_ERROR_MESSAGES.PROVIDER_NOT_FOUND}: ${providerId}`);
+        this.name = "ProviderNotFoundError";
+    }
+}
+/**
+ * Error thrown when a model is not found
+ */
+export class ModelNotFoundError extends NotFoundError {
+    constructor(modelId) {
+        super(`${LLM_ERROR_MESSAGES.MODEL_NOT_FOUND}: ${modelId}`);
+        this.name = "ModelNotFoundError";
+    }
+}
+/**
+ * Error thrown when a model is not available
+ */
+export class ModelNotAvailableError extends ValidationError {
+    constructor(providerId, modelId) {
+        super(`${LLM_ERROR_MESSAGES.MODEL_NOT_AVAILABLE}: ${providerId}/${modelId}`);
+        this.name = "ModelNotAvailableError";
+    }
+}
+/**
+ * Error thrown when a provider type is invalid
+ */
+export class InvalidProviderTypeError extends ValidationError {
+    constructor(providerType) {
+        super(`${LLM_ERROR_MESSAGES.PROVIDER_TYPE_INVALID}: ${providerType}`);
+        this.name = "InvalidProviderTypeError";
+    }
+}
+/**
+ * Error thrown when a capability is invalid
+ */
+export class InvalidModelCapabilityError extends ValidationError {
+    constructor(capability) {
+        super(`${LLM_ERROR_MESSAGES.MODEL_CAPABILITY_INVALID}: ${capability}`);
+        this.name = "InvalidModelCapabilityError";
+    }
+}
+/**
+ * Error thrown when a provider API error occurs
+ */
+export class ProviderAPIError extends Error {
+    constructor(providerId, message) {
+        super(`${LLM_ERROR_MESSAGES.PROVIDER_API_ERROR} (${providerId}): ${message}`);
+        this.name = "ProviderAPIError";
+    }
+}
+/**
+ * Error thrown when streaming a response fails
+ */
+export class StreamingError extends Error {
+    constructor(message) {
+        super(`${LLM_ERROR_MESSAGES.STREAMING_FAILED}: ${message}`);
+        this.name = "StreamingError";
+    }
+}
+//# sourceMappingURL=llm-errors.js.map

package/dist/services/llm/errors/llm-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-errors.js","sourceRoot":"","sources":["../../../../lib/services/llm/errors/llm-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEvE;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,UAAkB;QAC5B,KAAK,CAAC,GAAG,kBAAkB,CAAC,kBAAkB,KAAK,UAAU,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,GAAG,kBAAkB,CAAC,eAAe,KAAK,OAAO,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,eAAe;IACzD,YAAY,UAAkB,EAAE,OAAe;QAC7C,KAAK,CAAC,GAAG,kBAAkB,CAAC,mBAAmB,KAAK,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,eAAe;IAC3D,YAAY,YAAoB;QAC9B,KAAK,CAAC,GAAG,kBAAkB,CAAC,qBAAqB,KAAK,YAAY,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,eAAe;IAC9D,YAAY,UAAkB;QAC5B,KAAK,CAAC,GAAG,kBAAkB,CAAC,wBAAwB,KAAK,UAAU,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,UAAkB,EAAE,OAAe;QAC7C,KAAK,CAAC,GAAG,kBAAkB,CAAC,kBAAkB,KAAK,UAAU,MAAM,OAAO,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,GAAG,kBAAkB,CAAC,gBAAgB,KAAK,OAAO,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/services/llm/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./constants";
+export * from "./errors";
+export * from "./interfaces";
+export * from "./schemas";
+export * from "./services";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/services/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/services/llm/index.js

@@ -0,0 +1,6 @@
+export * from "./constants";
+export * from "./errors";
+export * from "./interfaces";
+export * from "./schemas";
+export * from "./services";
+//# sourceMappingURL=index.js.map

package/dist/services/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/services/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/services/llm/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./llm.interface";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/llm/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/services/llm/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/services/llm/interfaces/index.js

@@ -0,0 +1,2 @@
+export * from "./llm.interface";
+//# sourceMappingURL=index.js.map

package/dist/services/llm/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/services/llm/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/services/llm/interfaces/llm.interface.d.ts

@@ -0,0 +1,52 @@
+import type { DynamoDbService } from "../../dynamodb/services";
+import type { Logger } from "../../logger";
+import type { UserAwsCredentials } from "../../shared/interfaces";
+import type { Model, Provider } from "../schemas";
+/**
+ * Options for LLMService methods that support user-specific AWS credentials
+ * for governance compliance (IAM-based access control per user)
+ */
+export interface LLMServiceOptions {
+    /**
+     * User-specific AWS credentials for governance compliance
+     * When provided, operations use these credentials instead of service account
+     * This enables IAM-based access control per user with CloudTrail attribution
+     */
+    userCredentials?: UserAwsCredentials;
+}
+/**
+ * Dependencies for the LLMService
+ */
+export interface LLMServiceDeps {
+    logger: Logger;
+    db?: DynamoDbService;
+}
+/**
+ * Source of the effective Basic Assistant model
+ * - 'configured': Using the explicitly configured default model
+ * - 'fallback': Using a fallback model because configured default is unavailable
+ */
+export type BasicAssistantModelSource = "configured" | "fallback";
+/**
+ * Result of getting the Basic Assistant default model
+ * Returns the provider and model along with the source
+ */
+export interface BasicAssistantDefaultResult {
+    provider: Provider;
+    model: Model;
+}
+/**
+ * Result of getting the effective Basic Assistant model
+ * Used at runtime when processing basic assistant requests
+ */
+export interface EffectiveBasicAssistantModel {
+    /** The provider configuration */
+    provider: Provider;
+    /** The model configuration */
+    model: Model;
+    /** Whether this is the configured default or a fallback */
+    source: BasicAssistantModelSource;
+    /** Reason for using fallback (only present when source is 'fallback') */
+    fallbackReason?: string;
+}
+//# sourceMappingURL=llm.interface.d.ts.map

package/dist/services/llm/interfaces/llm.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.interface.d.ts","sourceRoot":"","sources":["../../../../lib/services/llm/interfaces/llm.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,eAAe,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,UAAU,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,iCAAiC;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,yBAAyB,CAAC;IAClC,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/services/llm/interfaces/llm.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=llm.interface.js.map

package/dist/services/llm/interfaces/llm.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.interface.js","sourceRoot":"","sources":["../../../../lib/services/llm/interfaces/llm.interface.ts"],"names":[],"mappings":""}

package/dist/services/llm/schemas/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./llm.schema";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/llm/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/services/llm/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/services/llm/schemas/index.js

@@ -0,0 +1,2 @@
+export * from "./llm.schema";
+//# sourceMappingURL=index.js.map

package/dist/services/llm/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/services/llm/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}