crewly 1.0.6 → 1.0.8

package/dist/backend/backend/src/services/runtime-adapter.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Runtime Adapter Layer
+ *
+ * Provides a unified, pluggable interface for managing AI runtime sessions.
+ * Each adapter encapsulates the full lifecycle of a specific runtime (Claude Code,
+ * Gemini CLI, Codex): starting a session, writing input, reading output, and stopping.
+ *
+ * This replaces the need to coordinate between ISessionBackend, SessionCommandHelper,
+ * and RuntimeAgentService manually — the adapter handles it all.
+ *
+ * @module services/runtime-adapter
+ */
+import { type RuntimeType } from '../constants.js';
+import { RuntimeAgentService } from './agent/runtime-agent.service.abstract.js';
+import { type ISessionBackend, type SessionCommandHelper } from './session/index.js';
+/**
+ * Configuration for starting a new agent session via a runtime adapter.
+ *
+ * @example
+ * ```typescript
+ * const config: RuntimeAdapterConfig = {
+ *   sessionName: 'dev-agent-1',
+ *   projectPath: '/home/user/my-project',
+ *   runtimeFlags: ['--chrome'],
+ *   promptFilePath: '/tmp/prompt.md',
+ * };
+ * ```
+ */
+export interface RuntimeAdapterConfig {
+    /** Unique name for the PTY session */
+    sessionName: string;
+    /** Working directory for the agent */
+    projectPath: string;
+    /** Optional CLI flags injected before --dangerously-skip-permissions */
+    runtimeFlags?: string[];
+    /** Optional path to a system prompt file */
+    promptFilePath?: string;
+    /** Optional environment variables to set in the session shell */
+    env?: Record<string, string>;
+}
+/**
+ * Unified interface for AI runtime adapters.
+ *
+ * Each implementation wraps a specific runtime CLI (Claude Code, Gemini CLI, Codex)
+ * and provides a consistent API for managing agent sessions. Adapters handle the
+ * full lifecycle: session creation, runtime initialization, I/O, and teardown.
+ *
+ * @example
+ * ```typescript
+ * const adapter = getRuntimeAdapter('claude-code');
+ *
+ * await adapter.start({ sessionName: 'agent-1', projectPath: '/project' });
+ * await adapter.write('agent-1', 'Hello, build a REST API');
+ * const output = await adapter.getOutput('agent-1');
+ * await adapter.stop('agent-1');
+ * ```
+ */
+export interface RuntimeAdapter {
+    /** The runtime type this adapter handles */
+    readonly runtimeType: RuntimeType;
+    /** Human-readable display name for this runtime */
+    readonly displayName: string;
+    /**
+     * Start a new agent session.
+     *
+     * Creates a PTY session, sets environment variables, and launches the
+     * runtime CLI with the specified configuration.
+     *
+     * @param config - Session configuration
+     * @throws Error if session creation or runtime initialization fails
+     */
+    start(config: RuntimeAdapterConfig): Promise<void>;
+    /**
+     * Stop an agent session and clean up resources.
+     *
+     * @param sessionName - Name of the session to stop
+     * @throws Error if session does not exist
+     */
+    stop(sessionName: string): Promise<void>;
+    /**
+     * Write data to an agent session's stdin.
+     *
+     * @param sessionName - Name of the target session
+     * @param data - Data to write (sent via the session's shell)
+     * @throws Error if session does not exist
+     */
+    write(sessionName: string, data: string): Promise<void>;
+    /**
+     * Get recent output from an agent session.
+     *
+     * @param sessionName - Name of the target session
+     * @param lines - Number of recent lines to capture (default: 50)
+     * @returns Captured terminal output as a string
+     * @throws Error if session does not exist
+     */
+    getOutput(sessionName: string, lines?: number): Promise<string>;
+    /**
+     * Check if a session is currently running.
+     *
+     * @param sessionName - Name of the session to check
+     * @returns True if the session exists and is active
+     */
+    isRunning(sessionName: string): boolean;
+    /**
+     * Wait for the runtime CLI to become ready after initialization.
+     *
+     * Polls the session output for runtime-specific ready patterns.
+     *
+     * @param sessionName - Name of the session to monitor
+     * @param timeout - Maximum wait time in milliseconds (default: 60000)
+     * @returns True if runtime became ready within timeout, false otherwise
+     */
+    waitForReady(sessionName: string, timeout?: number): Promise<boolean>;
+    /**
+     * Detect if the runtime CLI is currently active in a session.
+     *
+     * Uses runtime-specific detection strategies (e.g., sending '/' to trigger
+     * a command palette and checking for output changes).
+     *
+     * @param sessionName - Name of the session to check
+     * @returns True if the runtime is detected as running
+     */
+    detectRuntime(sessionName: string): Promise<boolean>;
+}
+/**
+ * Base adapter that delegates to the existing RuntimeAgentService and ISessionBackend.
+ *
+ * Concrete adapters extend this class and provide their runtime type.
+ * The base handles all common operations — subclasses only need to override
+ * behavior that differs from the default.
+ */
+declare abstract class BaseRuntimeAdapter implements RuntimeAdapter {
+    abstract readonly runtimeType: RuntimeType;
+    abstract readonly displayName: string;
+    protected sessionBackend: ISessionBackend;
+    protected sessionHelper: SessionCommandHelper;
+    protected runtimeService: RuntimeAgentService;
+    constructor(sessionBackend: ISessionBackend, sessionHelper: SessionCommandHelper, runtimeService: RuntimeAgentService);
+    /**
+     * Start a new agent session with the runtime CLI.
+     *
+     * Creates a PTY shell, sets environment variables, and executes the
+     * runtime initialization script.
+     *
+     * @param config - Session start configuration
+     */
+    start(config: RuntimeAdapterConfig): Promise<void>;
+    /** @inheritdoc */
+    stop(sessionName: string): Promise<void>;
+    /** @inheritdoc */
+    write(sessionName: string, data: string): Promise<void>;
+    /** @inheritdoc */
+    getOutput(sessionName: string, lines?: number): Promise<string>;
+    /** @inheritdoc */
+    isRunning(sessionName: string): boolean;
+    /** @inheritdoc */
+    waitForReady(sessionName: string, timeout?: number): Promise<boolean>;
+    /** @inheritdoc */
+    detectRuntime(sessionName: string): Promise<boolean>;
+}
+/**
+ * Adapter for Anthropic's Claude Code CLI.
+ *
+ * Full implementation — Claude Code is the default runtime.
+ * Handles Claude-specific initialization, detection (slash command palette),
+ * and MCP configuration.
+ */
+export declare class ClaudeCodeAdapter extends BaseRuntimeAdapter {
+    readonly runtimeType: "claude-code";
+    readonly displayName = "Claude Code";
+    /**
+     * Start a Claude Code session.
+     *
+     * Extends the base start with Claude-specific post-initialization
+     * (MCP server configuration).
+     *
+     * @param config - Session start configuration
+     */
+    start(config: RuntimeAdapterConfig): Promise<void>;
+}
+/**
+ * Adapter for Google's Gemini CLI.
+ *
+ * Stub implementation — basic structure in place for future development.
+ * Uses the base adapter behavior which delegates to GeminiRuntimeService.
+ */
+export declare class GeminiCliAdapter extends BaseRuntimeAdapter {
+    readonly runtimeType: "gemini-cli";
+    readonly displayName = "Gemini CLI";
+}
+/**
+ * Adapter for OpenAI's Codex CLI.
+ *
+ * Stub implementation — basic structure in place for future development.
+ * Uses the base adapter behavior which delegates to CodexRuntimeService.
+ */
+export declare class CodexAdapter extends BaseRuntimeAdapter {
+    readonly runtimeType: "codex-cli";
+    readonly displayName = "OpenAI Codex";
+}
+/**
+ * Creates a RuntimeAdapter for the specified runtime type.
+ *
+ * Uses the existing RuntimeServiceFactory and session backend to construct
+ * the appropriate adapter. Requires the session backend to be initialized
+ * first (via createSessionBackend()).
+ *
+ * @param runtimeType - The runtime type ('claude-code', 'gemini-cli', 'codex-cli')
+ * @param projectRoot - The project root directory (for runtime config resolution)
+ * @returns A RuntimeAdapter instance for the specified runtime
+ * @throws Error if session backend is not initialized or runtime type is unknown
+ *
+ * @example
+ * ```typescript
+ * const adapter = getRuntimeAdapter('claude-code', '/home/user/project');
+ * await adapter.start({ sessionName: 'agent-1', projectPath: '/project' });
+ * ```
+ */
+export declare function getRuntimeAdapter(runtimeType: RuntimeType, projectRoot: string): RuntimeAdapter;
+/**
+ * Returns the list of all supported runtime types.
+ *
+ * @returns Array of RuntimeType values
+ */
+export declare function getSupportedRuntimeTypes(): RuntimeType[];
+/**
+ * Checks whether a given string is a supported runtime type.
+ *
+ * @param value - The string to check
+ * @returns True if the value is a valid RuntimeType
+ */
+export declare function isSupportedRuntime(value: string): value is RuntimeType;
+export {};
+//# sourceMappingURL=runtime-adapter.d.ts.map

package/dist/backend/backend/src/services/runtime-adapter.d.ts.map

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

package/dist/backend/backend/src/services/runtime-adapter.js

@@ -0,0 +1,180 @@
+/**
+ * Runtime Adapter Layer
+ *
+ * Provides a unified, pluggable interface for managing AI runtime sessions.
+ * Each adapter encapsulates the full lifecycle of a specific runtime (Claude Code,
+ * Gemini CLI, Codex): starting a session, writing input, reading output, and stopping.
+ *
+ * This replaces the need to coordinate between ISessionBackend, SessionCommandHelper,
+ * and RuntimeAgentService manually — the adapter handles it all.
+ *
+ * @module services/runtime-adapter
+ */
+import { RUNTIME_TYPES } from '../constants.js';
+import { RuntimeServiceFactory } from './agent/runtime-service.factory.js';
+import { getSessionBackendSync, createSessionCommandHelper, } from './session/index.js';
+// ========================= Base Adapter =========================
+/**
+ * Base adapter that delegates to the existing RuntimeAgentService and ISessionBackend.
+ *
+ * Concrete adapters extend this class and provide their runtime type.
+ * The base handles all common operations — subclasses only need to override
+ * behavior that differs from the default.
+ */
+class BaseRuntimeAdapter {
+    sessionBackend;
+    sessionHelper;
+    runtimeService;
+    constructor(sessionBackend, sessionHelper, runtimeService) {
+        this.sessionBackend = sessionBackend;
+        this.sessionHelper = sessionHelper;
+        this.runtimeService = runtimeService;
+    }
+    /**
+     * Start a new agent session with the runtime CLI.
+     *
+     * Creates a PTY shell, sets environment variables, and executes the
+     * runtime initialization script.
+     *
+     * @param config - Session start configuration
+     */
+    async start(config) {
+        const { sessionName, projectPath, runtimeFlags, promptFilePath, env } = config;
+        // Create PTY session
+        await this.sessionHelper.createSession(sessionName, projectPath);
+        // Set environment variables
+        if (env) {
+            for (const [key, value] of Object.entries(env)) {
+                await this.sessionHelper.setEnvironmentVariable(sessionName, key, value);
+            }
+        }
+        // Execute runtime-specific initialization
+        await this.runtimeService.executeRuntimeInitScript(sessionName, projectPath, runtimeFlags, promptFilePath);
+    }
+    /** @inheritdoc */
+    async stop(sessionName) {
+        await this.sessionBackend.killSession(sessionName);
+    }
+    /** @inheritdoc */
+    async write(sessionName, data) {
+        await this.sessionHelper.sendMessage(sessionName, data);
+    }
+    /** @inheritdoc */
+    async getOutput(sessionName, lines) {
+        return this.sessionHelper.capturePane(sessionName, lines);
+    }
+    /** @inheritdoc */
+    isRunning(sessionName) {
+        return this.sessionBackend.sessionExists(sessionName);
+    }
+    /** @inheritdoc */
+    async waitForReady(sessionName, timeout = 60000) {
+        return this.runtimeService.waitForRuntimeReady(sessionName, timeout);
+    }
+    /** @inheritdoc */
+    async detectRuntime(sessionName) {
+        return this.runtimeService.detectRuntimeWithCommand(sessionName, true);
+    }
+}
+// ========================= Concrete Adapters =========================
+/**
+ * Adapter for Anthropic's Claude Code CLI.
+ *
+ * Full implementation — Claude Code is the default runtime.
+ * Handles Claude-specific initialization, detection (slash command palette),
+ * and MCP configuration.
+ */
+export class ClaudeCodeAdapter extends BaseRuntimeAdapter {
+    runtimeType = RUNTIME_TYPES.CLAUDE_CODE;
+    displayName = 'Claude Code';
+    /**
+     * Start a Claude Code session.
+     *
+     * Extends the base start with Claude-specific post-initialization
+     * (MCP server configuration).
+     *
+     * @param config - Session start configuration
+     */
+    async start(config) {
+        await super.start(config);
+        await this.runtimeService.postInitialize(config.sessionName, config.projectPath);
+    }
+}
+/**
+ * Adapter for Google's Gemini CLI.
+ *
+ * Stub implementation — basic structure in place for future development.
+ * Uses the base adapter behavior which delegates to GeminiRuntimeService.
+ */
+export class GeminiCliAdapter extends BaseRuntimeAdapter {
+    runtimeType = RUNTIME_TYPES.GEMINI_CLI;
+    displayName = 'Gemini CLI';
+}
+/**
+ * Adapter for OpenAI's Codex CLI.
+ *
+ * Stub implementation — basic structure in place for future development.
+ * Uses the base adapter behavior which delegates to CodexRuntimeService.
+ */
+export class CodexAdapter extends BaseRuntimeAdapter {
+    runtimeType = RUNTIME_TYPES.CODEX_CLI;
+    displayName = 'OpenAI Codex';
+}
+// ========================= Factory =========================
+/**
+ * Creates a RuntimeAdapter for the specified runtime type.
+ *
+ * Uses the existing RuntimeServiceFactory and session backend to construct
+ * the appropriate adapter. Requires the session backend to be initialized
+ * first (via createSessionBackend()).
+ *
+ * @param runtimeType - The runtime type ('claude-code', 'gemini-cli', 'codex-cli')
+ * @param projectRoot - The project root directory (for runtime config resolution)
+ * @returns A RuntimeAdapter instance for the specified runtime
+ * @throws Error if session backend is not initialized or runtime type is unknown
+ *
+ * @example
+ * ```typescript
+ * const adapter = getRuntimeAdapter('claude-code', '/home/user/project');
+ * await adapter.start({ sessionName: 'agent-1', projectPath: '/project' });
+ * ```
+ */
+export function getRuntimeAdapter(runtimeType, projectRoot) {
+    const backend = getSessionBackendSync();
+    if (!backend) {
+        throw new Error('Session backend not initialized. Call createSessionBackend() before getRuntimeAdapter().');
+    }
+    const sessionHelper = createSessionCommandHelper(backend);
+    const runtimeService = RuntimeServiceFactory.createWithHelper(runtimeType, sessionHelper, projectRoot);
+    switch (runtimeType) {
+        case RUNTIME_TYPES.CLAUDE_CODE:
+            return new ClaudeCodeAdapter(backend, sessionHelper, runtimeService);
+        case RUNTIME_TYPES.GEMINI_CLI:
+            return new GeminiCliAdapter(backend, sessionHelper, runtimeService);
+        case RUNTIME_TYPES.CODEX_CLI:
+            return new CodexAdapter(backend, sessionHelper, runtimeService);
+        default: {
+            // Fallback to Claude Code for unrecognized types
+            const fallbackService = RuntimeServiceFactory.createWithHelper(RUNTIME_TYPES.CLAUDE_CODE, sessionHelper, projectRoot);
+            return new ClaudeCodeAdapter(backend, sessionHelper, fallbackService);
+        }
+    }
+}
+/**
+ * Returns the list of all supported runtime types.
+ *
+ * @returns Array of RuntimeType values
+ */
+export function getSupportedRuntimeTypes() {
+    return RuntimeServiceFactory.getAvailableRuntimeTypes();
+}
+/**
+ * Checks whether a given string is a supported runtime type.
+ *
+ * @param value - The string to check
+ * @returns True if the value is a valid RuntimeType
+ */
+export function isSupportedRuntime(value) {
+    return RuntimeServiceFactory.isRuntimeTypeSupported(value);
+}
+//# sourceMappingURL=runtime-adapter.js.map

package/dist/backend/backend/src/services/runtime-adapter.js.map

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

package/dist/backend/backend/src/services/slack/slack-credentials.service.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Slack Credentials Persistence Service
+ *
+ * Persists Slack tokens to ~/.crewly/slack-credentials.json so that
+ * tokens configured via the /settings UI survive server restarts.
+ * The file is written with 0600 permissions to protect secrets.
+ *
+ * @module services/slack/slack-credentials
+ */
+import { SlackConfig } from '../../types/slack.types.js';
+/**
+ * Save Slack credentials to disk with restricted file permissions (0600).
+ *
+ * @param config - The SlackConfig to persist.
+ */
+export declare function saveSlackCredentials(config: SlackConfig): Promise<void>;
+/**
+ * Load saved Slack credentials from disk.
+ *
+ * @returns SlackConfig if credentials file exists and is valid, null otherwise.
+ */
+export declare function loadSlackCredentials(): Promise<SlackConfig | null>;
+/**
+ * Delete saved Slack credentials from disk.
+ */
+export declare function deleteSlackCredentials(): Promise<void>;
+/**
+ * Check if saved Slack credentials exist on disk.
+ *
+ * @returns True if the credentials file exists.
+ */
+export declare function hasSavedCredentials(): Promise<boolean>;
+//# sourceMappingURL=slack-credentials.service.d.ts.map

package/dist/backend/backend/src/services/slack/slack-credentials.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-credentials.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/slack-credentials.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AA6BzD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7E;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqBxE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAa5D;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS5D"}

package/dist/backend/backend/src/services/slack/slack-credentials.service.js

@@ -0,0 +1,103 @@
+/**
+ * Slack Credentials Persistence Service
+ *
+ * Persists Slack tokens to ~/.crewly/slack-credentials.json so that
+ * tokens configured via the /settings UI survive server restarts.
+ * The file is written with 0600 permissions to protect secrets.
+ *
+ * @module services/slack/slack-credentials
+ */
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { atomicWriteJson, safeReadJson } from '../../utils/file-io.utils.js';
+import { LoggerService } from '../core/logger.service.js';
+const logger = LoggerService.getInstance().createComponentLogger('SlackCredentials');
+const CREDENTIALS_FILE = 'slack-credentials.json';
+/**
+ * Get the path to the Slack credentials file.
+ *
+ * @returns Absolute path to ~/.crewly/slack-credentials.json
+ */
+function getCredentialsPath() {
+    const crewlyHome = path.join(process.env.HOME || '~', '.crewly');
+    return path.join(crewlyHome, CREDENTIALS_FILE);
+}
+/**
+ * Save Slack credentials to disk with restricted file permissions (0600).
+ *
+ * @param config - The SlackConfig to persist.
+ */
+export async function saveSlackCredentials(config) {
+    const filePath = getCredentialsPath();
+    const credentials = {
+        botToken: config.botToken,
+        appToken: config.appToken,
+        signingSecret: config.signingSecret,
+        defaultChannelId: config.defaultChannelId,
+        allowedUserIds: config.allowedUserIds,
+    };
+    await atomicWriteJson(filePath, credentials);
+    // Restrict permissions to owner-only (0600)
+    try {
+        await fs.chmod(filePath, 0o600);
+    }
+    catch (error) {
+        logger.warn('Failed to set credentials file permissions', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    logger.info('Slack credentials saved to disk');
+}
+/**
+ * Load saved Slack credentials from disk.
+ *
+ * @returns SlackConfig if credentials file exists and is valid, null otherwise.
+ */
+export async function loadSlackCredentials() {
+    const filePath = getCredentialsPath();
+    const credentials = await safeReadJson(filePath, null, logger);
+    if (!credentials || !credentials.botToken || !credentials.appToken || !credentials.signingSecret) {
+        return null;
+    }
+    return {
+        botToken: credentials.botToken,
+        appToken: credentials.appToken,
+        signingSecret: credentials.signingSecret,
+        defaultChannelId: credentials.defaultChannelId,
+        allowedUserIds: credentials.allowedUserIds,
+        socketMode: true,
+    };
+}
+/**
+ * Delete saved Slack credentials from disk.
+ */
+export async function deleteSlackCredentials() {
+    const filePath = getCredentialsPath();
+    try {
+        await fs.unlink(filePath);
+        logger.info('Slack credentials removed from disk');
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            logger.warn('Failed to delete credentials file', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+}
+/**
+ * Check if saved Slack credentials exist on disk.
+ *
+ * @returns True if the credentials file exists.
+ */
+export async function hasSavedCredentials() {
+    const filePath = getCredentialsPath();
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=slack-credentials.service.js.map

package/dist/backend/backend/src/services/slack/slack-credentials.service.js.map

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

package/dist/backend/backend/src/services/slack/slack-initializer.d.ts

@@ -31,6 +31,13 @@ export declare function isSlackConfigured(): boolean;
  * @returns SlackConfig object or null if not configured
  */
 export declare function getSlackConfigFromEnv(): SlackConfig | null;
+/**
+ * Get Slack configuration from environment variables or saved credentials.
+ * Environment variables take priority over saved credentials.
+ *
+ * @returns SlackConfig object or null if not configured
+ */
+export declare function getSlackConfig(): Promise<SlackConfig | null>;
 /**
  * Options for Slack initialization
  */
@@ -39,7 +46,8 @@ export interface SlackInitOptions {
     messageQueueService?: MessageQueueService;
 }
 /**
- * Initialize Slack integration if environment variables are set
+ * Initialize Slack integration if configured via environment variables
+ * or saved credentials.
  *
  * This function is designed to be called during application startup.
  * It safely handles cases where Slack is not configured.

package/dist/backend/backend/src/services/slack/slack-initializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack-initializer.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/slack-initializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAKjF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,GAAG,IAAI,CAiB1D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAUnD"}
+{"version":3,"file":"slack-initializer.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/slack-initializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAKjF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,GAAG,IAAI,CAiB1D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqBlE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAUnD"}

package/dist/backend/backend/src/services/slack/slack-initializer.js

@@ -8,6 +8,7 @@
  */
 import { getSlackService } from './slack.service.js';
 import { getSlackOrchestratorBridge } from './slack-orchestrator-bridge.js';
+import { loadSlackCredentials } from './slack-credentials.service.js';
 import { LoggerService } from '../core/logger.service.js';
 const logger = LoggerService.getInstance().createComponentLogger('SlackInitializer');
 /**
@@ -42,7 +43,35 @@ export function getSlackConfigFromEnv() {
     };
 }
 /**
- * Initialize Slack integration if environment variables are set
+ * Get Slack configuration from environment variables or saved credentials.
+ * Environment variables take priority over saved credentials.
+ *
+ * @returns SlackConfig object or null if not configured
+ */
+export async function getSlackConfig() {
+    // Env vars take priority
+    const envConfig = getSlackConfigFromEnv();
+    if (envConfig) {
+        return envConfig;
+    }
+    // Fall back to saved credentials
+    try {
+        const savedConfig = await loadSlackCredentials();
+        if (savedConfig) {
+            logger.info('Loaded Slack credentials from saved config');
+            return savedConfig;
+        }
+    }
+    catch (error) {
+        logger.warn('Failed to load saved Slack credentials', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    return null;
+}
+/**
+ * Initialize Slack integration if configured via environment variables
+ * or saved credentials.
  *
  * This function is designed to be called during application startup.
  * It safely handles cases where Slack is not configured.
@@ -65,7 +94,7 @@ export function getSlackConfigFromEnv() {
  * ```
  */
 export async function initializeSlackIfConfigured(options) {
-    const config = getSlackConfigFromEnv();
+    const config = await getSlackConfig();
     if (!config) {
         logger.info('Not configured - skipping initialization');
         return { attempted: false, success: false };