captify 0.1.15

package/dist/actions/auth/logout.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Signs out the user from both NextAuth session and AWS Cognito.
+ *
+ * Performs a two-step logout process:
+ * 1. Terminates the NextAuth session (clears local session state)
+ * 2. Redirects to Cognito's logout endpoint to clear the Cognito session
+ *
+ * @param postLogoutRedirectUri - Optional URI to redirect after logout.
+ *                                Defaults to AUTH_URL environment variable or current host.
+ *
+ * @throws {Error} If authentication configuration is missing or invalid
+ * @throws {NEXT_REDIRECT} Next.js internal redirect error (expected behavior for redirect())
+ *
+ * @example
+ * // Basic usage
+ * await cognitoSignOut();
+ *
+ * @example
+ * // With custom redirect
+ * await cognitoSignOut('https://example.com/goodbye');
+ */
+export declare function cognitoSignOut(postLogoutRedirectUri?: string): Promise<never>;
+//# sourceMappingURL=logout.d.ts.map

package/dist/actions/auth/logout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../../lib/actions/auth/logout.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CA2FnF"}

package/dist/actions/auth/logout.js

@@ -0,0 +1,106 @@
+"use server";
+import { auth, signOut } from "../../auth";
+import { createLoggerFromSession } from "../../services/logger";
+import { headers } from "next/headers";
+import { redirect } from "next/navigation";
+/**
+ * Signs out the user from both NextAuth session and AWS Cognito.
+ *
+ * Performs a two-step logout process:
+ * 1. Terminates the NextAuth session (clears local session state)
+ * 2. Redirects to Cognito's logout endpoint to clear the Cognito session
+ *
+ * @param postLogoutRedirectUri - Optional URI to redirect after logout.
+ *                                Defaults to AUTH_URL environment variable or current host.
+ *
+ * @throws {Error} If authentication configuration is missing or invalid
+ * @throws {NEXT_REDIRECT} Next.js internal redirect error (expected behavior for redirect())
+ *
+ * @example
+ * // Basic usage
+ * await cognitoSignOut();
+ *
+ * @example
+ * // With custom redirect
+ * await cognitoSignOut('https://example.com/goodbye');
+ */
+export async function cognitoSignOut(postLogoutRedirectUri) {
+    const isDev = process.env.NODE_ENV === "development";
+    // Get user session for audit logging
+    const session = await auth();
+    const logger = createLoggerFromSession(session, "Auth");
+    // Step 1: Sign out from NextAuth (with error handling)
+    try {
+        await signOut({ redirect: false });
+    }
+    catch (error) {
+        // Log the error but continue with Cognito logout to ensure complete session termination
+        logger.error("NextAuth signOut failed", { error });
+    }
+    // Step 2: Gather environment configuration with consistent naming
+    // Note: For logout, we need the Cognito hosted UI domain, not the OIDC issuer
+    const cognitoDomain = process.env.COGNITO_DOMAIN;
+    const clientId = process.env.COGNITO_CLIENT_ID;
+    // Attempt to get NEXTAUTH_URL with fallback to current host
+    let authUrl = postLogoutRedirectUri || process.env.NEXTAUTH_URL;
+    if (!authUrl) {
+        try {
+            const headersList = await headers();
+            const host = headersList.get("host");
+            if (host) {
+                // Use https in production, http in development
+                const protocol = isDev ? "http" : "https";
+                authUrl = `${protocol}://${host}`;
+                logger.warn("NEXTAUTH_URL not set, using inferred URL", { authUrl });
+            }
+        }
+        catch (error) {
+            logger.error("Failed to infer NEXTAUTH_URL from headers", { error });
+        }
+    }
+    // Validate all required configuration
+    if (!cognitoDomain || !clientId || !authUrl) {
+        const missingVars = [
+            !cognitoDomain && "COGNITO_DOMAIN",
+            !clientId && "COGNITO_CLIENT_ID",
+            !authUrl && "NEXTAUTH_URL",
+        ].filter(Boolean);
+        // Always log configuration errors for diagnostics
+        logger.error("Logout configuration error", {
+            missingVariables: missingVars,
+            hasCognitoDomain: !!cognitoDomain,
+            hasClientId: !!clientId,
+            hasAuthUrl: !!authUrl,
+        });
+        // User-facing error message varies by environment
+        const errorMsg = isDev
+            ? `Missing authentication configuration. Required: ${missingVars.join(", ")}`
+            : "Authentication configuration error. Please contact support.";
+        throw new Error(errorMsg);
+    }
+    // Validate Cognito domain is a valid URL
+    try {
+        new URL(cognitoDomain);
+    }
+    catch (_a) {
+        const errorMsg = isDev
+            ? `Invalid COGNITO_DOMAIN format: ${cognitoDomain}`
+            : "Authentication configuration error. Please contact support.";
+        throw new Error(errorMsg);
+    }
+    // Log logout for audit trail (always log for compliance)
+    logger.info("User logout initiated", {
+        timestamp: new Date().toISOString(),
+    });
+    // Step 3: Build Cognito logout URL and redirect
+    // Cognito expects the logout_uri to exactly match a configured sign-out URL
+    // Ensure no trailing slash if the configured URL doesn't have one
+    const normalizedAuthUrl = authUrl.endsWith("/") ? authUrl.slice(0, -1) : authUrl;
+    const COGNITO_LOGOUT_PATH = "/logout";
+    const logoutUrl = `${cognitoDomain}${COGNITO_LOGOUT_PATH}?client_id=${clientId}&logout_uri=${encodeURIComponent(normalizedAuthUrl)}`;
+    if (isDev) {
+        logger.info("Cognito logout URL", { logoutUrl });
+    }
+    redirect(logoutUrl);
+}
+//# sourceMappingURL=logout.js.map

package/dist/actions/auth/logout.js.map

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

package/dist/actions/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Server actions
+ *
+ * Note: Module-specific actions are in their respective modules:
+ * - Auth (logout, terms): ../auth/actions
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/actions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/actions/index.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Server actions
+ *
+ * Note: Module-specific actions are in their respective modules:
+ * - Auth (logout, terms): ../auth/actions
+ */
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/actions/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/actions/terms-and-conditions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Mark terms and conditions as accepted by setting a secure cookie
+ */
+export declare function acceptTermsAndConditions(): Promise<void>;
+/**
+ * Check if terms and conditions have been accepted
+ */
+export declare function hasAcceptedTerms(): Promise<boolean>;
+/**
+ * Clear terms acceptance (for testing or user logout)
+ */
+export declare function clearTermsAcceptance(): Promise<void>;
+//# sourceMappingURL=terms-and-conditions.d.ts.map

package/dist/actions/terms-and-conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terms-and-conditions.d.ts","sourceRoot":"","sources":["../../lib/actions/terms-and-conditions.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAsB,wBAAwB,kBAU7C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAIzD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,kBAGzC"}

package/dist/actions/terms-and-conditions.js

@@ -0,0 +1,33 @@
+"use server";
+import { cookies } from "next/headers";
+const TERMS_COOKIE_NAME = "captify_terms_accepted";
+const TERMS_COOKIE_MAX_AGE = 365 * 24 * 60 * 60; // 1 year in seconds
+/**
+ * Mark terms and conditions as accepted by setting a secure cookie
+ */
+export async function acceptTermsAndConditions() {
+    const cookieStore = await cookies();
+    cookieStore.set(TERMS_COOKIE_NAME, "true", {
+        httpOnly: true,
+        secure: process.env.NODE_ENV === "production",
+        sameSite: "lax",
+        maxAge: TERMS_COOKIE_MAX_AGE,
+        path: "/",
+    });
+}
+/**
+ * Check if terms and conditions have been accepted
+ */
+export async function hasAcceptedTerms() {
+    const cookieStore = await cookies();
+    const termsAccepted = cookieStore.get(TERMS_COOKIE_NAME);
+    return (termsAccepted === null || termsAccepted === void 0 ? void 0 : termsAccepted.value) === "true";
+}
+/**
+ * Clear terms acceptance (for testing or user logout)
+ */
+export async function clearTermsAcceptance() {
+    const cookieStore = await cookies();
+    cookieStore.delete(TERMS_COOKIE_NAME);
+}
+//# sourceMappingURL=terms-and-conditions.js.map

package/dist/actions/terms-and-conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terms-and-conditions.js","sourceRoot":"","sources":["../../lib/actions/terms-and-conditions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AACnD,MAAM,oBAAoB,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,oBAAoB;AAErE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;IAEpC,WAAW,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,EAAE;QACzC,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAC7C,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,GAAG;KACV,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACzD,OAAO,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,KAAK,MAAK,MAAM,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;IACpC,WAAW,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACxC,CAAC"}

package/dist/agents/agents.constants.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Constants for AI Agents service
+ */
+/**
+ * API base URL
+ */
+export declare const API_BASE_URL = "/api";
+/**
+ * Agents API endpoint
+ */
+export declare const AGENTS_ENDPOINT = "/api/agents";
+/**
+ * Agent module route paths
+ */
+export declare const AGENT_ROUTES: {
+    /** Base path for agents list */
+    readonly LIST: "/agents";
+    /** Path for creating new agent */
+    readonly NEW: "/agents/new";
+    /** Build path for viewing/editing specific agent */
+    readonly detail: (agentId: string) => string;
+    /** Build path for new agent with auto-generate flag */
+    readonly newWithAutoGenerate: () => string;
+};
+/**
+ * URL query parameter names used in agent routes
+ */
+export declare const AGENT_URL_PARAMS: {
+    /** Flag to trigger automatic AI generation on page load */
+    readonly AUTO_GENERATE: "autoGenerate";
+};
+export declare const AGENT_KEYS: {
+    readonly SEPARATOR: "#";
+    readonly PARTITION_KEY_PREFIX: {
+        readonly TENANT: "TENANT#";
+    };
+    readonly SORT_KEY: {
+        readonly AGENT_PREFIX: "AGENT#";
+        readonly METADATA: "METADATA";
+    };
+};
+export declare function buildTenantPK(tenantId: string): string;
+export declare function buildAgentSK(agentId: string): string;
+export declare const AGENT_STATUS: readonly ["active", "inactive"];
+export type AgentStatus = (typeof AGENT_STATUS)[number];
+export declare const RESPONSE_TYPES: readonly ["text", "json", "markdown"];
+export type ResponseType = (typeof RESPONSE_TYPES)[number];
+export declare const TOOL_CHOICE: readonly ["auto", "required", "none"];
+export type ToolChoice = (typeof TOOL_CHOICE)[number];
+export declare const AGENT_LIMITS: {
+    readonly MAX_NAME_LENGTH: 100;
+    readonly MAX_DESCRIPTION_LENGTH: 500;
+    readonly MAX_INSTRUCTIONS_LENGTH: 10000;
+    readonly MAX_MODEL_ID_LENGTH: 500;
+    readonly MAX_PROVIDER_ID_LENGTH: 50;
+    readonly MIN_TEMPERATURE: 0;
+    readonly MAX_TEMPERATURE: 2;
+    readonly MIN_MAX_TOKENS: 1;
+    readonly MAX_MAX_TOKENS: 100000;
+    readonly MIN_TOP_P: 0;
+    readonly MAX_TOP_P: 1;
+    readonly MIN_PENALTY: -2;
+    readonly MAX_PENALTY: 2;
+    readonly MIN_MAX_STEPS: 1;
+    readonly MAX_MAX_STEPS: 50;
+};
+export declare const AGENT_DEFAULTS: {
+    readonly TEMPERATURE: 0.7;
+    readonly MAX_TOKENS: 4096;
+    readonly MAX_STEPS: 20;
+    readonly TOOL_CHOICE: ToolChoice;
+    readonly RESPONSE_TYPE: ResponseType;
+    readonly STATUS: AgentStatus;
+    readonly TOP_P: 1;
+    readonly PRESENCE_PENALTY: 0;
+    readonly FREQUENCY_PENALTY: 0;
+};
+/**
+ * Error messages for agent validation and operations
+ */
+export declare const AGENT_ERROR_MESSAGES: {
+    readonly AGENT_ID_REQUIRED: "Agent ID is required";
+    readonly AGENT_ID_INVALID_FORMAT: "Agent ID must be a valid UUID";
+    readonly AGENT_NOT_FOUND: "Agent not found";
+    readonly NAME_REQUIRED: "Agent name is required";
+    readonly NAME_TOO_LONG: "Agent name exceeds maximum length";
+    readonly DESCRIPTION_TOO_LONG: "Agent description exceeds maximum length";
+    readonly INSTRUCTIONS_REQUIRED: "Agent instructions are required";
+    readonly INSTRUCTIONS_TOO_LONG: "Agent instructions exceed maximum length";
+    readonly MODEL_ID_REQUIRED: "Model ID is required";
+    readonly MODEL_ID_TOO_LONG: "Model ID exceeds maximum length";
+    readonly PROVIDER_ID_REQUIRED: "Provider ID must be a valid UUID";
+    readonly TEMPERATURE_OUT_OF_RANGE: "Temperature must be between 0 and 2";
+    readonly MAX_TOKENS_OUT_OF_RANGE: "Max tokens must be a positive integer";
+    readonly TOP_P_OUT_OF_RANGE: "Top P must be between 0 and 1";
+    readonly PRESENCE_PENALTY_OUT_OF_RANGE: "Presence penalty must be between -2 and 2";
+    readonly FREQUENCY_PENALTY_OUT_OF_RANGE: "Frequency penalty must be between -2 and 2";
+    readonly RESPONSE_TYPE_INVALID: "Invalid response type";
+    readonly STATUS_INVALID: "Invalid agent status";
+    readonly TENANT_ID_REQUIRED: "Tenant ID is required";
+    readonly CREATE_FAILED: "Failed to create agent";
+    readonly UPDATE_FAILED: "Failed to update agent";
+    readonly DELETE_FAILED: "Failed to delete agent";
+    readonly LIST_FAILED: "Failed to list agents";
+    readonly STREAM_FAILED: "Failed to stream AI response";
+    readonly GENERATE_FAILED: "Failed to generate AI response";
+};
+/**
+ * Success messages for agent operations
+ */
+export declare const AGENT_SUCCESS_MESSAGES: {
+    readonly CREATED: "Agent created successfully";
+    readonly UPDATED: "Agent updated successfully";
+    readonly DELETED: "Agent deleted successfully";
+};
+/**
+ * Cognito group name for users who can create, edit, and delete agents
+ */
+export declare const AGENT_ADMIN_GROUP = "Agent_Admin";
+/**
+ * Session storage key for generation input data during navigation
+ */
+export declare const GENERATION_INPUT_STORAGE_KEY = "agent-generation-input";
+/**
+ * View modes for agents list display
+ */
+export declare const VIEW_MODES: {
+    readonly CARD: "card";
+    readonly TABLE: "table";
+};
+/**
+ * View mode type - Card or Table
+ */
+export type ViewMode = (typeof VIEW_MODES)[keyof typeof VIEW_MODES];
+/**
+ * Default view mode when no preference is stored
+ */
+export declare const DEFAULT_VIEW_MODE: ViewMode;
+/**
+ * Session storage key for view mode preference
+ */
+export declare const VIEW_PREFERENCE_STORAGE_KEY = "agents-view-preference";
+/**
+ * Sort direction type
+ */
+export type SortDirection = "asc" | "desc";
+/**
+ * Sort option configuration
+ */
+export interface SortOption {
+    field: string;
+    direction: SortDirection;
+    label: string;
+}
+/**
+ * Available sort options for agents list
+ */
+export declare const SORT_OPTIONS: {
+    readonly NEWEST: {
+        readonly field: "createdAt";
+        readonly direction: "desc";
+        readonly label: "Newest";
+    };
+    readonly OLDEST: {
+        readonly field: "createdAt";
+        readonly direction: "asc";
+        readonly label: "Oldest";
+    };
+    readonly NAME_ASC: {
+        readonly field: "name";
+        readonly direction: "asc";
+        readonly label: "Name (A-Z)";
+    };
+    readonly NAME_DESC: {
+        readonly field: "name";
+        readonly direction: "desc";
+        readonly label: "Name (Z-A)";
+    };
+};
+/**
+ * Sort option key type
+ */
+export type SortOptionKey = keyof typeof SORT_OPTIONS;
+/**
+ * Default sort option when no preference is set
+ */
+export declare const DEFAULT_SORT_OPTION: SortOptionKey;
+/**
+ * Available tool names for agents.
+ * This is the single source of truth - tools.ts implements these, schemas.ts validates against these.
+ * Adding a new tool requires:
+ * 1. Add the name here
+ * 2. Implement the tool in services/tools.ts
+ */
+export declare const TOOL_NAMES: readonly ["calculator", "getCurrentTime", "stringManipulator", "randomNumber", "jsonValidator", "urlParser", "arrayOperations"];
+/**
+ * Tool name type derived from TOOL_NAMES constant
+ */
+export type ToolName = (typeof TOOL_NAMES)[number];
+//# sourceMappingURL=agents.constants.d.ts.map

package/dist/agents/agents.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.constants.d.ts","sourceRoot":"","sources":["../../lib/agents/agents.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,eAAe,gBAA2B,CAAC;AAMxD;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,gCAAgC;;IAEhC,kCAAkC;;IAElC,oDAAoD;+BAClC,MAAM;IACxB,uDAAuD;;CAE/C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,2DAA2D;;CAEnD,CAAC;AAOX,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAIX,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAGD,eAAO,MAAM,YAAY,iCAAkC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAGxD,eAAO,MAAM,cAAc,uCAAwC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAG3D,eAAO,MAAM,WAAW,uCAAwC,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAGtD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;CAgBf,CAAC;AAGX,eAAO,MAAM,cAAc;;;;0BAIF,UAAU;4BACR,YAAY;qBACjB,WAAW;;;;CAIvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AAMrE;;GAEG;AACH,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAA0B,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AAMpE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;CAKsB,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,YAAY,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAwB,CAAC;AAM3D;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,iIAQb,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/agents/agents.constants.js

@@ -0,0 +1,206 @@
+/**
+ * Constants for AI Agents service
+ */
+// ============================================================================
+// API Constants
+// ============================================================================
+/**
+ * API base URL
+ */
+export const API_BASE_URL = "/api";
+/**
+ * Agents API endpoint
+ */
+export const AGENTS_ENDPOINT = `${API_BASE_URL}/agents`;
+// ============================================================================
+// Route Constants
+// ============================================================================
+/**
+ * Agent module route paths
+ */
+export const AGENT_ROUTES = {
+    /** Base path for agents list */
+    LIST: "/agents",
+    /** Path for creating new agent */
+    NEW: "/agents/new",
+    /** Build path for viewing/editing specific agent */
+    detail: (agentId) => `/agents/${agentId}`,
+    /** Build path for new agent with auto-generate flag */
+    newWithAutoGenerate: () => `/agents/new?autoGenerate=true`,
+};
+/**
+ * URL query parameter names used in agent routes
+ */
+export const AGENT_URL_PARAMS = {
+    /** Flag to trigger automatic AI generation on page load */
+    AUTO_GENERATE: "autoGenerate",
+};
+// ============================================================================
+// Key Structure Constants
+// ============================================================================
+// Key structure constants for DynamoDB
+export const AGENT_KEYS = {
+    SEPARATOR: "#",
+    PARTITION_KEY_PREFIX: {
+        TENANT: "TENANT#",
+    },
+    SORT_KEY: {
+        AGENT_PREFIX: "AGENT#",
+        METADATA: "METADATA",
+    },
+};
+// Build partition key for tenant
+// Format: TENANT#{tenantId}
+export function buildTenantPK(tenantId) {
+    return `${AGENT_KEYS.PARTITION_KEY_PREFIX.TENANT}${tenantId}`;
+}
+// Build sort key for agent metadata
+// Format: METADATA#AGENT#{agentId}
+export function buildAgentSK(agentId) {
+    return `${AGENT_KEYS.SORT_KEY.METADATA}${AGENT_KEYS.SEPARATOR}${AGENT_KEYS.SORT_KEY.AGENT_PREFIX}${agentId}`;
+}
+// Agent status types
+export const AGENT_STATUS = ["active", "inactive"];
+// Response types for agent outputs
+export const RESPONSE_TYPES = ["text", "json", "markdown"];
+// Tool choice strategies
+export const TOOL_CHOICE = ["auto", "required", "none"];
+// Validation limits
+export const AGENT_LIMITS = {
+    MAX_NAME_LENGTH: 100,
+    MAX_DESCRIPTION_LENGTH: 500,
+    MAX_INSTRUCTIONS_LENGTH: 10000,
+    MAX_MODEL_ID_LENGTH: 500,
+    MAX_PROVIDER_ID_LENGTH: 50,
+    MIN_TEMPERATURE: 0,
+    MAX_TEMPERATURE: 2,
+    MIN_MAX_TOKENS: 1,
+    MAX_MAX_TOKENS: 100000,
+    MIN_TOP_P: 0,
+    MAX_TOP_P: 1,
+    MIN_PENALTY: -2,
+    MAX_PENALTY: 2,
+    MIN_MAX_STEPS: 1,
+    MAX_MAX_STEPS: 50,
+};
+// Default values for agent configuration
+export const AGENT_DEFAULTS = {
+    TEMPERATURE: 0.7,
+    MAX_TOKENS: 4096,
+    MAX_STEPS: 20,
+    TOOL_CHOICE: "auto",
+    RESPONSE_TYPE: "text",
+    STATUS: "active",
+    TOP_P: 1,
+    PRESENCE_PENALTY: 0,
+    FREQUENCY_PENALTY: 0,
+};
+/**
+ * Error messages for agent validation and operations
+ */
+export const AGENT_ERROR_MESSAGES = {
+    // Agent ID validation
+    AGENT_ID_REQUIRED: "Agent ID is required",
+    AGENT_ID_INVALID_FORMAT: "Agent ID must be a valid UUID",
+    AGENT_NOT_FOUND: "Agent not found",
+    // Name validation
+    NAME_REQUIRED: "Agent name is required",
+    NAME_TOO_LONG: "Agent name exceeds maximum length",
+    // Description validation
+    DESCRIPTION_TOO_LONG: "Agent description exceeds maximum length",
+    // Instructions validation
+    INSTRUCTIONS_REQUIRED: "Agent instructions are required",
+    INSTRUCTIONS_TOO_LONG: "Agent instructions exceed maximum length",
+    // Model validation
+    MODEL_ID_REQUIRED: "Model ID is required",
+    MODEL_ID_TOO_LONG: "Model ID exceeds maximum length",
+    // Provider validation
+    PROVIDER_ID_REQUIRED: "Provider ID must be a valid UUID",
+    // Configuration validation
+    TEMPERATURE_OUT_OF_RANGE: "Temperature must be between 0 and 2",
+    MAX_TOKENS_OUT_OF_RANGE: "Max tokens must be a positive integer",
+    TOP_P_OUT_OF_RANGE: "Top P must be between 0 and 1",
+    PRESENCE_PENALTY_OUT_OF_RANGE: "Presence penalty must be between -2 and 2",
+    FREQUENCY_PENALTY_OUT_OF_RANGE: "Frequency penalty must be between -2 and 2",
+    RESPONSE_TYPE_INVALID: "Invalid response type",
+    STATUS_INVALID: "Invalid agent status",
+    // Tenant validation
+    TENANT_ID_REQUIRED: "Tenant ID is required",
+    // Operations
+    CREATE_FAILED: "Failed to create agent",
+    UPDATE_FAILED: "Failed to update agent",
+    DELETE_FAILED: "Failed to delete agent",
+    LIST_FAILED: "Failed to list agents",
+    STREAM_FAILED: "Failed to stream AI response",
+    GENERATE_FAILED: "Failed to generate AI response",
+};
+/**
+ * Success messages for agent operations
+ */
+export const AGENT_SUCCESS_MESSAGES = {
+    CREATED: "Agent created successfully",
+    UPDATED: "Agent updated successfully",
+    DELETED: "Agent deleted successfully",
+};
+// ============================================================================
+// Permission Constants
+// ============================================================================
+/**
+ * Cognito group name for users who can create, edit, and delete agents
+ */
+export const AGENT_ADMIN_GROUP = "Agent_Admin";
+/**
+ * Session storage key for generation input data during navigation
+ */
+export const GENERATION_INPUT_STORAGE_KEY = "agent-generation-input";
+// ============================================================================
+// View Mode Constants (for Card/Table view switching)
+// ============================================================================
+/**
+ * View modes for agents list display
+ */
+export const VIEW_MODES = {
+    CARD: "card",
+    TABLE: "table",
+};
+/**
+ * Default view mode when no preference is stored
+ */
+export const DEFAULT_VIEW_MODE = VIEW_MODES.CARD;
+/**
+ * Session storage key for view mode preference
+ */
+export const VIEW_PREFERENCE_STORAGE_KEY = "agents-view-preference";
+/**
+ * Available sort options for agents list
+ */
+export const SORT_OPTIONS = {
+    NEWEST: { field: "createdAt", direction: "desc", label: "Newest" },
+    OLDEST: { field: "createdAt", direction: "asc", label: "Oldest" },
+    NAME_ASC: { field: "name", direction: "asc", label: "Name (A-Z)" },
+    NAME_DESC: { field: "name", direction: "desc", label: "Name (Z-A)" },
+};
+/**
+ * Default sort option when no preference is set
+ */
+export const DEFAULT_SORT_OPTION = "NEWEST";
+// ============================================================================
+// Tool Names (Single source of truth for available tools)
+// ============================================================================
+/**
+ * Available tool names for agents.
+ * This is the single source of truth - tools.ts implements these, schemas.ts validates against these.
+ * Adding a new tool requires:
+ * 1. Add the name here
+ * 2. Implement the tool in services/tools.ts
+ */
+export const TOOL_NAMES = [
+    "calculator",
+    "getCurrentTime",
+    "stringManipulator",
+    "randomNumber",
+    "jsonValidator",
+    "urlParser",
+    "arrayOperations",
+];
+//# sourceMappingURL=agents.constants.js.map

package/dist/agents/agents.constants.js.map

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