crewly 1.5.18 → 1.5.20

package/dist/backend/backend/src/types/v2/workspace.types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * V2 Shared Workspace Type Definitions
+ *
+ * A Workspace is a structured, versioned JSON document that agents can
+ * read and write. Optimistic locking (CAS — Compare-And-Swap) ensures
+ * consistency: writes must include the expectedVersion, and fail with
+ * a conflict if another writer has updated the document since the read.
+ *
+ * Usage discipline (CEO requirement):
+ * - Each workspace has an owner (agent/team/system)
+ * - Schema defines allowed structure
+ * - Access mode controls append vs overwrite
+ * - Ownership prevents unauthorized writes
+ *
+ * @module types/v2/workspace.types
+ */
+/**
+ * Access mode for workspace writes.
+ * - overwrite: Replace entire data on write
+ * - append: Merge/append new data to existing
+ * - structured: Write to specific paths within the document
+ */
+export type WorkspaceAccessMode = 'overwrite' | 'append' | 'structured';
+/** All valid access modes. */
+export declare const WORKSPACE_ACCESS_MODES: readonly WorkspaceAccessMode[];
+/**
+ * Who owns the workspace.
+ */
+export type WorkspaceOwnerType = 'agent' | 'team' | 'mission' | 'system';
+/** All valid owner types. */
+export declare const WORKSPACE_OWNER_TYPES: readonly WorkspaceOwnerType[];
+/**
+ * A versioned, structured JSON workspace.
+ *
+ * Each write increments the version counter. Reads return the current
+ * version, which must be passed back on writes for CAS validation.
+ */
+export interface Workspace {
+    /** UUID v4 */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Who owns this workspace */
+    ownerType: WorkspaceOwnerType;
+    /** Owner identifier (agent session, team ID, mission ID, or 'system') */
+    ownerId: string;
+    /** Access mode — how data can be modified */
+    accessMode: WorkspaceAccessMode;
+    /** The actual workspace data (arbitrary JSON-serializable object) */
+    data: Record<string, unknown>;
+    /** Monotonically increasing version number (starts at 1) */
+    version: number;
+    /** Which sessions are allowed to write (empty = owner only) */
+    allowedWriters: string[];
+    /** ISO8601 timestamps */
+    createdAt: string;
+    updatedAt: string;
+    /** Who last wrote to this workspace */
+    lastWrittenBy?: string;
+}
+/**
+ * Input for creating a new Workspace.
+ */
+export interface CreateWorkspaceInput {
+    name: string;
+    description?: string;
+    ownerType: WorkspaceOwnerType;
+    ownerId: string;
+    accessMode?: WorkspaceAccessMode;
+    data?: Record<string, unknown>;
+    allowedWriters?: string[];
+}
+/**
+ * Input for writing to a workspace.
+ * Requires expectedVersion for CAS validation.
+ */
+export interface WriteWorkspaceInput {
+    /** The version the client believes is current — CAS check */
+    expectedVersion: number;
+    /** New data to write (interpretation depends on accessMode) */
+    data: Record<string, unknown>;
+    /** Who is performing the write */
+    writerId: string;
+}
+/**
+ * Input for a structured write to a specific path.
+ */
+export interface StructuredWriteInput {
+    /** The version the client believes is current */
+    expectedVersion: number;
+    /** Dot-notation path to write to (e.g., "results.phase1") */
+    path: string;
+    /** Value to set at the path */
+    value: unknown;
+    /** Who is performing the write */
+    writerId: string;
+}
+/**
+ * Error thrown when a CAS conflict occurs.
+ * The client's expectedVersion doesn't match the current version.
+ */
+export declare class WorkspaceConflictError extends Error {
+    readonly workspaceId: string;
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    constructor(workspaceId: string, expectedVersion: number, actualVersion: number);
+}
+/**
+ * Error thrown when a writer is not authorized.
+ */
+export declare class WorkspaceAccessError extends Error {
+    readonly workspaceId: string;
+    readonly writerId: string;
+    constructor(workspaceId: string, writerId: string);
+}
+/**
+ * Checks whether a string is a valid WorkspaceAccessMode.
+ */
+export declare function isValidWorkspaceAccessMode(value: string): value is WorkspaceAccessMode;
+/**
+ * Checks whether a string is a valid WorkspaceOwnerType.
+ */
+export declare function isValidWorkspaceOwnerType(value: string): value is WorkspaceOwnerType;
+/**
+ * Validates that an unknown value is structurally a valid Workspace.
+ */
+export declare function isWorkspace(value: unknown): value is Workspace;
+/**
+ * Validates CreateWorkspaceInput.
+ *
+ * @param input - The creation input to validate
+ * @returns Array of validation error strings (empty = valid)
+ */
+export declare function validateCreateWorkspaceInput(input: CreateWorkspaceInput): string[];
+/**
+ * Validates WriteWorkspaceInput.
+ */
+export declare function validateWriteWorkspaceInput(input: WriteWorkspaceInput): string[];
+/**
+ * Creates a new Workspace with sensible defaults.
+ *
+ * @param input - Required and optional creation fields
+ * @returns A fully populated Workspace at version 1
+ *
+ * @example
+ * ```typescript
+ * const ws = createWorkspace({
+ *   name: 'Sprint 1 Results',
+ *   ownerType: 'team',
+ *   ownerId: 'team-product',
+ * });
+ * ```
+ */
+export declare function createWorkspace(input: CreateWorkspaceInput): Workspace;
+//# sourceMappingURL=workspace.types.d.ts.map

package/dist/backend/backend/src/types/v2/workspace.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/types/v2/workspace.types.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/types/v2/workspace.types.js

@@ -0,0 +1,173 @@
+/**
+ * V2 Shared Workspace Type Definitions
+ *
+ * A Workspace is a structured, versioned JSON document that agents can
+ * read and write. Optimistic locking (CAS — Compare-And-Swap) ensures
+ * consistency: writes must include the expectedVersion, and fail with
+ * a conflict if another writer has updated the document since the read.
+ *
+ * Usage discipline (CEO requirement):
+ * - Each workspace has an owner (agent/team/system)
+ * - Schema defines allowed structure
+ * - Access mode controls append vs overwrite
+ * - Ownership prevents unauthorized writes
+ *
+ * @module types/v2/workspace.types
+ */
+import { v4 as uuidv4 } from 'uuid';
+/** All valid access modes. */
+export const WORKSPACE_ACCESS_MODES = [
+    'overwrite',
+    'append',
+    'structured',
+];
+/** All valid owner types. */
+export const WORKSPACE_OWNER_TYPES = [
+    'agent',
+    'team',
+    'mission',
+    'system',
+];
+// ---------------------------------------------------------------------------
+// CAS Error
+// ---------------------------------------------------------------------------
+/**
+ * Error thrown when a CAS conflict occurs.
+ * The client's expectedVersion doesn't match the current version.
+ */
+export class WorkspaceConflictError extends Error {
+    workspaceId;
+    expectedVersion;
+    actualVersion;
+    constructor(workspaceId, expectedVersion, actualVersion) {
+        super(`Workspace conflict: expected version ${expectedVersion} but current is ${actualVersion}`);
+        this.name = 'WorkspaceConflictError';
+        this.workspaceId = workspaceId;
+        this.expectedVersion = expectedVersion;
+        this.actualVersion = actualVersion;
+    }
+}
+/**
+ * Error thrown when a writer is not authorized.
+ */
+export class WorkspaceAccessError extends Error {
+    workspaceId;
+    writerId;
+    constructor(workspaceId, writerId) {
+        super(`Access denied: '${writerId}' is not authorized to write to workspace '${workspaceId}'`);
+        this.name = 'WorkspaceAccessError';
+        this.workspaceId = workspaceId;
+        this.writerId = writerId;
+    }
+}
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether a string is a valid WorkspaceAccessMode.
+ */
+export function isValidWorkspaceAccessMode(value) {
+    return WORKSPACE_ACCESS_MODES.includes(value);
+}
+/**
+ * Checks whether a string is a valid WorkspaceOwnerType.
+ */
+export function isValidWorkspaceOwnerType(value) {
+    return WORKSPACE_OWNER_TYPES.includes(value);
+}
+/**
+ * Validates that an unknown value is structurally a valid Workspace.
+ */
+export function isWorkspace(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (typeof obj.id === 'string' &&
+        typeof obj.name === 'string' &&
+        typeof obj.ownerType === 'string' &&
+        isValidWorkspaceOwnerType(obj.ownerType) &&
+        typeof obj.ownerId === 'string' &&
+        typeof obj.accessMode === 'string' &&
+        isValidWorkspaceAccessMode(obj.accessMode) &&
+        typeof obj.data === 'object' && obj.data !== null &&
+        typeof obj.version === 'number' && obj.version >= 1 &&
+        Array.isArray(obj.allowedWriters) &&
+        typeof obj.createdAt === 'string' &&
+        typeof obj.updatedAt === 'string');
+}
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+/**
+ * Validates CreateWorkspaceInput.
+ *
+ * @param input - The creation input to validate
+ * @returns Array of validation error strings (empty = valid)
+ */
+export function validateCreateWorkspaceInput(input) {
+    const errors = [];
+    if (!input.name || typeof input.name !== 'string') {
+        errors.push('name is required and must be a non-empty string');
+    }
+    if (!input.ownerType || !isValidWorkspaceOwnerType(input.ownerType)) {
+        errors.push(`ownerType must be one of: ${WORKSPACE_OWNER_TYPES.join(', ')}`);
+    }
+    if (!input.ownerId || typeof input.ownerId !== 'string') {
+        errors.push('ownerId is required and must be a non-empty string');
+    }
+    if (input.accessMode && !isValidWorkspaceAccessMode(input.accessMode)) {
+        errors.push(`accessMode must be one of: ${WORKSPACE_ACCESS_MODES.join(', ')}`);
+    }
+    return errors;
+}
+/**
+ * Validates WriteWorkspaceInput.
+ */
+export function validateWriteWorkspaceInput(input) {
+    const errors = [];
+    if (typeof input.expectedVersion !== 'number' || input.expectedVersion < 1) {
+        errors.push('expectedVersion must be a positive integer');
+    }
+    if (typeof input.data !== 'object' || input.data === null) {
+        errors.push('data must be a non-null object');
+    }
+    if (!input.writerId || typeof input.writerId !== 'string') {
+        errors.push('writerId is required and must be a non-empty string');
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a new Workspace with sensible defaults.
+ *
+ * @param input - Required and optional creation fields
+ * @returns A fully populated Workspace at version 1
+ *
+ * @example
+ * ```typescript
+ * const ws = createWorkspace({
+ *   name: 'Sprint 1 Results',
+ *   ownerType: 'team',
+ *   ownerId: 'team-product',
+ * });
+ * ```
+ */
+export function createWorkspace(input) {
+    const now = new Date().toISOString();
+    return {
+        id: uuidv4(),
+        name: input.name,
+        description: input.description,
+        ownerType: input.ownerType,
+        ownerId: input.ownerId,
+        accessMode: input.accessMode ?? 'overwrite',
+        data: input.data ?? {},
+        version: 1,
+        allowedWriters: input.allowedWriters ?? [],
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=workspace.types.js.map

package/dist/backend/backend/src/types/v2/workspace.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.types.js","sourceRoot":"","sources":["../../../../../../backend/src/types/v2/workspace.types.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/types/v3/task-record.types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * V3.1 Task Record Types
+ *
+ * TaskRecord = projection of agent behavior into a structured execution step.
+ * Created automatically by the system, not by agents directly.
+ *
+ * Three-layer model:
+ *   Request → TaskRecord → TaskEvent
+ *
+ * @module types/v3/task-record.types
+ */
+/** How the task was originated — determines projection behavior. */
+export type TaskRecordType = 'self_execution' | 'delegation' | 'skill_call' | 'reconcile' | 'trigger_action';
+/** Lifecycle status of a TaskRecord. */
+export type TaskRecordStatus = 'created' | 'assigned' | 'running' | 'blocked' | 'done' | 'failed';
+/** Discrete event types emitted during task execution. */
+export type TaskEventType = 'task_created' | 'task_assigned' | 'task_started' | 'task_blocked' | 'task_completed' | 'task_failed' | 'skill_called' | 'skill_succeeded' | 'skill_failed' | 'agent_resumed' | 'agent_failed' | 'token_recorded';
+export interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    model?: string;
+    estimatedCostUsd?: number;
+}
+export interface TaskRecord {
+    id: string;
+    /** Parent Request this task belongs to */
+    requestId?: string;
+    /** Parent WorkItem ID if this was spawned from task-pool */
+    workItemId?: string;
+    /** Hierarchical parent TaskRecord (delegation chain) */
+    parentTaskId?: string;
+    title: string;
+    type: TaskRecordType;
+    ownerAgent: string;
+    status: TaskRecordStatus;
+    assignedBy?: string;
+    assignedAt?: string;
+    startedAt?: string;
+    completedAt?: string;
+    blockedReason?: string;
+    /** Aggregated token usage for this task */
+    tokenUsage?: TokenUsage;
+    /** ID of the trigger that spawned this task (if any) */
+    triggerId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TaskEvent {
+    id: string;
+    taskId: string;
+    eventType: TaskEventType;
+    agentId: string;
+    timestamp: string;
+    payload: Record<string, unknown>;
+}
+/** Input for creating a new TaskRecord. */
+export interface CreateTaskRecordInput {
+    title: string;
+    type: TaskRecordType;
+    ownerAgent: string;
+    requestId?: string;
+    workItemId?: string;
+    parentTaskId?: string;
+    assignedBy?: string;
+    triggerId?: string;
+}
+/** Partial update fields for an existing TaskRecord. */
+export interface UpdateTaskRecordInput {
+    status?: TaskRecordStatus;
+    assignedAt?: string;
+    startedAt?: string;
+    completedAt?: string;
+    blockedReason?: string;
+    tokenUsage?: TokenUsage;
+}
+/** Input for recording a TaskEvent. */
+export interface RecordTaskEventInput {
+    taskId: string;
+    eventType: TaskEventType;
+    agentId: string;
+    payload?: Record<string, unknown>;
+}
+/**
+ * Creates a new TaskRecord with generated ID and timestamps.
+ *
+ * @param input - Creation parameters
+ * @returns A new TaskRecord in 'created' status
+ */
+export declare function createTaskRecord(input: CreateTaskRecordInput): TaskRecord;
+/**
+ * Creates a new TaskEvent with generated ID and timestamp.
+ *
+ * @param input - Event parameters
+ * @returns A new TaskEvent
+ */
+export declare function createTaskEvent(input: RecordTaskEventInput): TaskEvent;
+//# sourceMappingURL=task-record.types.d.ts.map

package/dist/backend/backend/src/types/v3/task-record.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-record.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/types/v3/task-record.types.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/types/v3/task-record.types.js

@@ -0,0 +1,55 @@
+/**
+ * V3.1 Task Record Types
+ *
+ * TaskRecord = projection of agent behavior into a structured execution step.
+ * Created automatically by the system, not by agents directly.
+ *
+ * Three-layer model:
+ *   Request → TaskRecord → TaskEvent
+ *
+ * @module types/v3/task-record.types
+ */
+import { v4 as uuidv4 } from 'uuid';
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a new TaskRecord with generated ID and timestamps.
+ *
+ * @param input - Creation parameters
+ * @returns A new TaskRecord in 'created' status
+ */
+export function createTaskRecord(input) {
+    const now = new Date().toISOString();
+    return {
+        id: uuidv4(),
+        title: input.title,
+        type: input.type,
+        ownerAgent: input.ownerAgent,
+        status: 'created',
+        requestId: input.requestId,
+        workItemId: input.workItemId,
+        parentTaskId: input.parentTaskId,
+        assignedBy: input.assignedBy,
+        triggerId: input.triggerId,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Creates a new TaskEvent with generated ID and timestamp.
+ *
+ * @param input - Event parameters
+ * @returns A new TaskEvent
+ */
+export function createTaskEvent(input) {
+    return {
+        id: uuidv4(),
+        taskId: input.taskId,
+        eventType: input.eventType,
+        agentId: input.agentId,
+        timestamp: new Date().toISOString(),
+        payload: input.payload ?? {},
+    };
+}
+//# sourceMappingURL=task-record.types.js.map

package/dist/backend/backend/src/types/v3/task-record.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-record.types.js","sourceRoot":"","sources":["../../../../../../backend/src/types/v3/task-record.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAmIpC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,EAAE,EAAE,MAAM,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,OAAO;QACL,EAAE,EAAE,MAAM,EAAE;QACZ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;KAC7B,CAAC;AACJ,CAAC"}

package/dist/backend/config/constants.d.ts

@@ -925,6 +925,53 @@ export declare const ADDON_CONSTANTS: {
 };
 /** Shorthand for debounce value */
 export declare const EVENT_DEBOUNCE_MS: 5000;
+/**
+ * Redis connection and caching configuration
+ */
+export declare const REDIS_CONSTANTS: {
+    /** Redis connection settings */
+    readonly CONNECTION: {
+        /** Default Redis host */
+        readonly HOST: "127.0.0.1";
+        /** Default Redis port */
+        readonly PORT: 6379;
+        /** Connection timeout in milliseconds (5 seconds) */
+        readonly CONNECT_TIMEOUT: 5000;
+        /** Maximum number of reconnect retries before giving up */
+        readonly MAX_RETRIES: 3;
+        /** Delay between reconnect attempts in milliseconds */
+        readonly RETRY_DELAY: 1000;
+        /** Key prefix to namespace all Crewly cache entries */
+        readonly KEY_PREFIX: "crewly:";
+    };
+    /** Cache TTL (time-to-live) settings in seconds */
+    readonly TTL: {
+        /** TTL for GET /api/teams list (60 seconds) */
+        readonly TEAMS_LIST: 60;
+        /** TTL for GET /api/projects list (60 seconds) */
+        readonly PROJECTS_LIST: 60;
+        /** Default TTL for unspecified cache entries (60 seconds) */
+        readonly DEFAULT: 60;
+    };
+    /** Cache key patterns */
+    readonly KEYS: {
+        /** Cache key for the teams list endpoint */
+        readonly TEAMS_LIST: "api:teams";
+        /** Cache key for the projects list endpoint */
+        readonly PROJECTS_LIST: "api:projects";
+    };
+    /** Environment variable names for Redis configuration */
+    readonly ENV: {
+        /** Redis host override */
+        readonly REDIS_HOST: "CREWLY_REDIS_HOST";
+        /** Redis port override */
+        readonly REDIS_PORT: "CREWLY_REDIS_PORT";
+        /** Redis password */
+        readonly REDIS_PASSWORD: "CREWLY_REDIS_PASSWORD";
+        /** Redis URL (takes precedence over host/port) */
+        readonly REDIS_URL: "CREWLY_REDIS_URL";
+    };
+};
 /**
  * Type helpers for extracting literal types from constants
  */

package/dist/backend/config/constants.d.ts.map

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

package/dist/backend/config/constants.js

@@ -986,4 +986,53 @@ export const ADDON_CONSTANTS = {
 };
 /** Shorthand for debounce value */
 export const EVENT_DEBOUNCE_MS = CONTINUATION_CONSTANTS.EVENTS.DEBOUNCE_MS;
+// ========================= TYPE HELPERS =========================
+// ========================= REDIS CACHE CONSTANTS =========================
+/**
+ * Redis connection and caching configuration
+ */
+export const REDIS_CONSTANTS = {
+    /** Redis connection settings */
+    CONNECTION: {
+        /** Default Redis host */
+        HOST: '127.0.0.1',
+        /** Default Redis port */
+        PORT: 6379,
+        /** Connection timeout in milliseconds (5 seconds) */
+        CONNECT_TIMEOUT: 5000,
+        /** Maximum number of reconnect retries before giving up */
+        MAX_RETRIES: 3,
+        /** Delay between reconnect attempts in milliseconds */
+        RETRY_DELAY: 1000,
+        /** Key prefix to namespace all Crewly cache entries */
+        KEY_PREFIX: 'crewly:',
+    },
+    /** Cache TTL (time-to-live) settings in seconds */
+    TTL: {
+        /** TTL for GET /api/teams list (60 seconds) */
+        TEAMS_LIST: 60,
+        /** TTL for GET /api/projects list (60 seconds) */
+        PROJECTS_LIST: 60,
+        /** Default TTL for unspecified cache entries (60 seconds) */
+        DEFAULT: 60,
+    },
+    /** Cache key patterns */
+    KEYS: {
+        /** Cache key for the teams list endpoint */
+        TEAMS_LIST: 'api:teams',
+        /** Cache key for the projects list endpoint */
+        PROJECTS_LIST: 'api:projects',
+    },
+    /** Environment variable names for Redis configuration */
+    ENV: {
+        /** Redis host override */
+        REDIS_HOST: 'CREWLY_REDIS_HOST',
+        /** Redis port override */
+        REDIS_PORT: 'CREWLY_REDIS_PORT',
+        /** Redis password */
+        REDIS_PASSWORD: 'CREWLY_REDIS_PASSWORD',
+        /** Redis URL (takes precedence over host/port) */
+        REDIS_URL: 'CREWLY_REDIS_URL',
+    },
+};
 //# sourceMappingURL=constants.js.map