@helmisatria/mcp-chrome-bridge 1.0.30

package/dist/agent/project-service.js

@@ -0,0 +1,254 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateRootPath = validateRootPath;
+exports.createProjectDirectory = createProjectDirectory;
+exports.listProjects = listProjects;
+exports.getProject = getProject;
+exports.upsertProject = upsertProject;
+exports.deleteProject = deleteProject;
+exports.touchProjectActivity = touchProjectActivity;
+exports.updateProjectClaudeSessionId = updateProjectClaudeSessionId;
+/**
+ * Project Service - Database-backed implementation using Drizzle ORM.
+ *
+ * Provides CRUD operations for agent projects with:
+ * - Type-safe database queries
+ * - Path validation with security checks
+ * - Consistent with AgentProject interface from shared types
+ */
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const drizzle_orm_1 = require("drizzle-orm");
+const db_1 = require("./db");
+// ============================================================
+// Security Configuration
+// ============================================================
+/**
+ * Allowed base directories for project roots.
+ * Only paths under these directories are considered safe.
+ */
+const ALLOWED_BASE_DIRS = [
+    node_os_1.default.homedir(),
+    process.env.USERPROFILE,
+    process.env.MCP_ALLOWED_WORKSPACE_BASE,
+].filter((dir) => typeof dir === 'string' && dir.length > 0);
+/**
+ * Validate a root path without creating it.
+ * Returns validation result including whether directory needs creation.
+ */
+async function validateRootPath(rootPath) {
+    const trimmed = rootPath.trim();
+    if (!trimmed) {
+        return {
+            valid: false,
+            absolute: '',
+            exists: false,
+            needsCreation: false,
+            error: 'Project rootPath must not be empty',
+        };
+    }
+    const absolute = node_path_1.default.isAbsolute(trimmed)
+        ? node_path_1.default.resolve(trimmed)
+        : node_path_1.default.resolve(process.cwd(), trimmed);
+    // Security check: ensure path is under allowed base directories
+    const isAllowed = ALLOWED_BASE_DIRS.some((base) => absolute.startsWith(node_path_1.default.resolve(base)));
+    if (!isAllowed) {
+        return {
+            valid: false,
+            absolute,
+            exists: false,
+            needsCreation: false,
+            error: `Project rootPath must be under allowed directories: ${ALLOWED_BASE_DIRS.join(', ')}`,
+        };
+    }
+    // Check if path exists
+    try {
+        const s = await (0, promises_1.stat)(absolute);
+        if (!s.isDirectory()) {
+            return {
+                valid: false,
+                absolute,
+                exists: true,
+                needsCreation: false,
+                error: `Path exists but is not a directory: ${absolute}`,
+            };
+        }
+        return { valid: true, absolute, exists: true, needsCreation: false };
+    }
+    catch (err) {
+        const error = err;
+        if (error.code === 'ENOENT') {
+            // Path doesn't exist but is valid - can be created
+            return { valid: true, absolute, exists: false, needsCreation: true };
+        }
+        return {
+            valid: false,
+            absolute,
+            exists: false,
+            needsCreation: false,
+            error: error.message || 'Unknown error validating path',
+        };
+    }
+}
+/**
+ * Create a project directory after user confirmation.
+ * This should only be called after validateRootPath returns needsCreation: true.
+ */
+async function createProjectDirectory(absolutePath) {
+    // Re-validate for safety
+    const validation = await validateRootPath(absolutePath);
+    if (!validation.valid) {
+        throw new Error(validation.error || 'Invalid path');
+    }
+    if (validation.exists) {
+        throw new Error('Directory already exists');
+    }
+    await (0, promises_1.mkdir)(absolutePath, { recursive: true });
+}
+/**
+ * Normalize and validate root path.
+ * @param rootPath - The path to normalize
+ * @param allowCreate - If true, create directory if it doesn't exist
+ */
+async function normalizeRootPath(rootPath, allowCreate = false) {
+    const result = await validateRootPath(rootPath);
+    if (!result.valid) {
+        throw new Error(result.error || 'Invalid path');
+    }
+    if (result.needsCreation) {
+        if (allowCreate) {
+            await (0, promises_1.mkdir)(result.absolute, { recursive: true });
+        }
+        else {
+            throw new Error(`Directory does not exist: ${result.absolute}. Use the validate-path API first and confirm creation with the user.`);
+        }
+    }
+    return result.absolute;
+}
+// ============================================================
+// Type Conversion
+// ============================================================
+/**
+ * Convert database row to AgentProject interface.
+ */
+function rowToProject(row) {
+    var _a, _b, _c, _d;
+    return {
+        id: row.id,
+        name: row.name,
+        description: (_a = row.description) !== null && _a !== void 0 ? _a : undefined,
+        rootPath: row.rootPath,
+        preferredCli: row.preferredCli,
+        selectedModel: (_b = row.selectedModel) !== null && _b !== void 0 ? _b : undefined,
+        activeClaudeSessionId: (_c = row.activeClaudeSessionId) !== null && _c !== void 0 ? _c : undefined,
+        useCcr: row.useCcr === '1',
+        enableChromeMcp: row.enableChromeMcp !== '0',
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+        lastActiveAt: (_d = row.lastActiveAt) !== null && _d !== void 0 ? _d : undefined,
+    };
+}
+// ============================================================
+// Public API
+// ============================================================
+/**
+ * List all projects, sorted by last activity (most recent first).
+ */
+async function listProjects() {
+    const db = (0, db_1.getDb)();
+    const rows = await db.select().from(db_1.projects).orderBy((0, drizzle_orm_1.desc)(db_1.projects.lastActiveAt));
+    return rows.map(rowToProject);
+}
+/**
+ * Get a single project by ID.
+ */
+async function getProject(id) {
+    const db = (0, db_1.getDb)();
+    const rows = await db.select().from(db_1.projects).where((0, drizzle_orm_1.eq)(db_1.projects.id, id)).limit(1);
+    return rows.length > 0 ? rowToProject(rows[0]) : undefined;
+}
+/**
+ * Create or update a project.
+ */
+async function upsertProject(input) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    const db = (0, db_1.getDb)();
+    const now = new Date().toISOString();
+    const rootPath = await normalizeRootPath(input.rootPath, (_a = input.allowCreate) !== null && _a !== void 0 ? _a : false);
+    const id = ((_b = input.id) === null || _b === void 0 ? void 0 : _b.trim()) || (0, node_crypto_1.randomUUID)();
+    const existing = await getProject(id);
+    // Convert booleans to strings for SQLite storage:
+    // - useCcr: '1' or null (legacy)
+    // - enableChromeMcp: '1' or '0' (non-null; defaults to enabled)
+    const useCcrValue = input.useCcr !== undefined ? (input.useCcr ? '1' : null) : (existing === null || existing === void 0 ? void 0 : existing.useCcr) ? '1' : null;
+    let enableChromeMcpValue;
+    if (typeof input.enableChromeMcp === 'boolean') {
+        enableChromeMcpValue = input.enableChromeMcp ? '1' : '0';
+    }
+    else {
+        enableChromeMcpValue = (existing === null || existing === void 0 ? void 0 : existing.enableChromeMcp) === false ? '0' : '1';
+    }
+    const projectData = {
+        id,
+        name: input.name.trim(),
+        description: ((_c = input.description) === null || _c === void 0 ? void 0 : _c.trim()) || (existing === null || existing === void 0 ? void 0 : existing.description) || null,
+        rootPath,
+        preferredCli: (_e = (_d = input.preferredCli) !== null && _d !== void 0 ? _d : existing === null || existing === void 0 ? void 0 : existing.preferredCli) !== null && _e !== void 0 ? _e : null,
+        selectedModel: (_g = (_f = input.selectedModel) !== null && _f !== void 0 ? _f : existing === null || existing === void 0 ? void 0 : existing.selectedModel) !== null && _g !== void 0 ? _g : null,
+        // Preserve activeClaudeSessionId from existing project (not settable via upsert)
+        activeClaudeSessionId: (_h = existing === null || existing === void 0 ? void 0 : existing.activeClaudeSessionId) !== null && _h !== void 0 ? _h : null,
+        useCcr: useCcrValue,
+        enableChromeMcp: enableChromeMcpValue,
+        createdAt: (existing === null || existing === void 0 ? void 0 : existing.createdAt) || now,
+        updatedAt: now,
+        lastActiveAt: now,
+    };
+    if (existing) {
+        // Update existing project
+        await db.update(db_1.projects).set(projectData).where((0, drizzle_orm_1.eq)(db_1.projects.id, id));
+    }
+    else {
+        // Insert new project
+        await db.insert(db_1.projects).values(projectData);
+    }
+    return rowToProject(projectData);
+}
+/**
+ * Delete a project by ID.
+ * Messages are automatically deleted via cascade.
+ */
+async function deleteProject(id) {
+    const db = (0, db_1.getDb)();
+    await db.delete(db_1.projects).where((0, drizzle_orm_1.eq)(db_1.projects.id, id));
+}
+/**
+ * Update the last activity timestamp for a project.
+ */
+async function touchProjectActivity(id) {
+    const db = (0, db_1.getDb)();
+    const now = new Date().toISOString();
+    await db.update(db_1.projects).set({ lastActiveAt: now, updatedAt: now }).where((0, drizzle_orm_1.eq)(db_1.projects.id, id));
+}
+/**
+ * Update the active Claude session ID for a project.
+ * This is called when the SDK returns a system/init message with a new session_id.
+ * Pass empty string or null to clear the session ID.
+ */
+async function updateProjectClaudeSessionId(id, claudeSessionId) {
+    const db = (0, db_1.getDb)();
+    const now = new Date().toISOString();
+    await db
+        .update(db_1.projects)
+        .set({
+        // Store null if empty string is passed (to clear the session)
+        activeClaudeSessionId: (claudeSessionId === null || claudeSessionId === void 0 ? void 0 : claudeSessionId.trim()) || null,
+        updatedAt: now,
+    })
+        .where((0, drizzle_orm_1.eq)(db_1.projects.id, id));
+}
+//# sourceMappingURL=project-service.js.map

package/dist/agent/project-service.js.map

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

package/dist/agent/project-types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Re-export AgentProject from shared package and define local input types.
+ */
+import type { AgentCliPreference, AgentProject } from 'chrome-mcp-shared';
+export type { AgentProject };
+export interface CreateOrUpdateProjectInput {
+    id?: string;
+    name: string;
+    description?: string;
+    rootPath: string;
+    preferredCli?: AgentCliPreference;
+    selectedModel?: string;
+    /**
+     * Whether to use Claude Code Router (CCR) for this project.
+     */
+    useCcr?: boolean;
+    /**
+     * Whether to enable the local Chrome MCP server integration for this project.
+     * Defaults to true when omitted.
+     */
+    enableChromeMcp?: boolean;
+    /**
+     * If true, create the directory if it doesn't exist.
+     * Should only be set after user confirmation.
+     */
+    allowCreate?: boolean;
+}

package/dist/agent/project-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=project-types.js.map

package/dist/agent/project-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-types.js","sourceRoot":"","sources":["../../src/agent/project-types.ts"],"names":[],"mappings":""}

package/dist/agent/session-service.d.ts

@@ -0,0 +1,198 @@
+import type { EngineName } from './engines/types';
+/**
+ * System prompt configuration options.
+ */
+export type SystemPromptConfig = {
+    type: 'custom';
+    text: string;
+} | {
+    type: 'preset';
+    preset: 'claude_code';
+    append?: string;
+};
+/**
+ * Tools configuration - can be a list of tool names or a preset.
+ */
+export type ToolsConfig = string[] | {
+    type: 'preset';
+    preset: 'claude_code';
+};
+/**
+ * Session options configuration (stored as JSON).
+ */
+export interface SessionOptionsConfig {
+    settingSources?: string[];
+    allowedTools?: string[];
+    disallowedTools?: string[];
+    tools?: ToolsConfig;
+    betas?: string[];
+    maxThinkingTokens?: number;
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    mcpServers?: Record<string, unknown>;
+    outputFormat?: Record<string, unknown>;
+    enableFileCheckpointing?: boolean;
+    sandbox?: Record<string, unknown>;
+    env?: Record<string, string>;
+    /**
+     * Optional Codex-specific configuration overrides.
+     * Only applicable when using CodexEngine.
+     */
+    codexConfig?: Partial<import('chrome-mcp-shared').CodexEngineConfig>;
+}
+/**
+ * Cached management information from Claude SDK.
+ */
+export interface ManagementInfo {
+    models?: Array<{
+        value: string;
+        displayName: string;
+        description: string;
+    }>;
+    commands?: Array<{
+        name: string;
+        description: string;
+        argumentHint: string;
+    }>;
+    account?: {
+        email?: string;
+        organization?: string;
+        subscriptionType?: string;
+    };
+    mcpServers?: Array<{
+        name: string;
+        status: string;
+    }>;
+    tools?: string[];
+    agents?: string[];
+    /** Plugins with name and path (SDK returns { name, path }[]) */
+    plugins?: Array<{
+        name: string;
+        path?: string;
+    }>;
+    skills?: string[];
+    slashCommands?: string[];
+    model?: string;
+    permissionMode?: string;
+    cwd?: string;
+    outputStyle?: string;
+    betas?: string[];
+    claudeCodeVersion?: string;
+    apiKeySource?: string;
+    lastUpdated?: string;
+}
+/**
+ * Structured preview metadata for session list display.
+ * When present, allows rendering special styles (e.g., chip for web editor apply).
+ */
+export interface AgentSessionPreviewMeta {
+    /** Compact display text (e.g., user's message or "Apply changes") */
+    displayText?: string;
+    /** Client metadata for special rendering */
+    clientMeta?: {
+        kind?: 'web_editor_apply_batch' | 'web_editor_apply_single';
+        pageUrl?: string;
+        elementCount?: number;
+        elementLabels?: string[];
+    };
+    /** Full content for tooltip preview (truncated to avoid payload bloat) */
+    fullContent?: string;
+}
+/**
+ * Agent session representation.
+ */
+export interface AgentSession {
+    id: string;
+    projectId: string;
+    engineName: string;
+    engineSessionId?: string;
+    name?: string;
+    /** Preview text from first user message, for display in session list */
+    preview?: string;
+    /** Structured preview metadata for special rendering (e.g., web editor apply chip) */
+    previewMeta?: AgentSessionPreviewMeta;
+    model?: string;
+    permissionMode: string;
+    allowDangerouslySkipPermissions: boolean;
+    systemPromptConfig?: SystemPromptConfig;
+    optionsConfig?: SessionOptionsConfig;
+    managementInfo?: ManagementInfo;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Options for creating a new session.
+ */
+export interface CreateSessionOptions {
+    id?: string;
+    engineSessionId?: string;
+    name?: string;
+    model?: string;
+    permissionMode?: string;
+    allowDangerouslySkipPermissions?: boolean;
+    systemPromptConfig?: SystemPromptConfig;
+    optionsConfig?: SessionOptionsConfig;
+}
+/**
+ * Options for updating an existing session.
+ */
+export interface UpdateSessionInput {
+    engineSessionId?: string | null;
+    name?: string | null;
+    model?: string | null;
+    permissionMode?: string | null;
+    allowDangerouslySkipPermissions?: boolean | null;
+    systemPromptConfig?: SystemPromptConfig | null;
+    optionsConfig?: SessionOptionsConfig | null;
+    managementInfo?: ManagementInfo | null;
+}
+/**
+ * Create a new session for a project.
+ */
+export declare function createSession(projectId: string, engineName: EngineName, options?: CreateSessionOptions): Promise<AgentSession>;
+/**
+ * Get a session by ID.
+ */
+export declare function getSession(sessionId: string): Promise<AgentSession | undefined>;
+/**
+ * Get all sessions for a project, sorted by most recently updated.
+ * Includes preview from first user message for each session.
+ */
+export declare function getSessionsByProject(projectId: string): Promise<AgentSession[]>;
+/**
+ * Get all sessions across all projects, sorted by most recently updated.
+ * Includes preview from first user message for each session.
+ */
+export declare function getAllSessions(): Promise<AgentSession[]>;
+/**
+ * Get sessions for a project filtered by engine name.
+ */
+export declare function getSessionsByProjectAndEngine(projectId: string, engineName: EngineName): Promise<AgentSession[]>;
+/**
+ * Update an existing session.
+ */
+export declare function updateSession(sessionId: string, updates: UpdateSessionInput): Promise<void>;
+/**
+ * Delete a session by ID.
+ * Note: Messages associated with this session are NOT automatically deleted.
+ * The caller should handle message cleanup if needed.
+ */
+export declare function deleteSession(sessionId: string): Promise<void>;
+/**
+ * Update the engine session ID (e.g., Claude SDK session_id).
+ */
+export declare function updateEngineSessionId(sessionId: string, engineSessionId: string | null): Promise<void>;
+/**
+ * Touch session activity - updates the updatedAt timestamp.
+ * Used when a message is sent to move the session to the top of the list.
+ */
+export declare function touchSessionActivity(sessionId: string): Promise<void>;
+/**
+ * Update the cached management information.
+ */
+export declare function updateManagementInfo(sessionId: string, info: ManagementInfo | null): Promise<void>;
+/**
+ * Get or create a default session for a project and engine.
+ * Useful for backwards compatibility - creates a session if none exists.
+ */
+export declare function getOrCreateDefaultSession(projectId: string, engineName: EngineName, options?: CreateSessionOptions): Promise<AgentSession>;