@ccpocket/bridge 1.48.1 → 1.49.0

package/dist/prompt-history-store.js

@@ -0,0 +1,322 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const DEFAULT_STORE_FILE = join(homedir(), ".ccpocket", "prompt-history-v2.json");
+const DEFAULT_BRIDGE_PORT = 8765;
+export function promptHistoryStoreFileForPort(port, explicitFile) {
+    if (explicitFile?.trim())
+        return explicitFile.trim();
+    const parsedPort = typeof port === "number" ? port : Number.parseInt(port ?? "", 10);
+    if (!Number.isInteger(parsedPort) || parsedPort === DEFAULT_BRIDGE_PORT) {
+        return DEFAULT_STORE_FILE;
+    }
+    return join(homedir(), ".ccpocket", `prompt-history-v2-${parsedPort}.json`);
+}
+function isoNow() {
+    return new Date().toISOString();
+}
+function maxIso(left, right) {
+    if (!left)
+        return right ?? isoNow();
+    if (!right)
+        return left;
+    return left >= right ? left : right;
+}
+function minIso(left, right) {
+    if (!left)
+        return right ?? isoNow();
+    if (!right)
+        return left;
+    return left <= right ? left : right;
+}
+function normalizeText(text) {
+    return text.trim().replace(/\r\n/g, "\n");
+}
+function normalizeProjectPath(projectPath) {
+    return (projectPath ?? "").trim();
+}
+export function promptHistoryId(text, projectPath = "") {
+    const stableKey = `${normalizeProjectPath(projectPath)}\u0000${normalizeText(text)}`;
+    const digest = createHash("sha256").update(stableKey).digest("hex");
+    return `ph_${digest.slice(0, 24)}`;
+}
+export function detectPromptCommandKind(text) {
+    const trimmed = text.trimStart();
+    if (trimmed.startsWith("$"))
+        return "skill";
+    if (trimmed.startsWith("/"))
+        return "slash";
+    const commandMatch = /<command-name>\s*(.*?)\s*<\/command-name>/s.exec(text);
+    const commandName = commandMatch?.[1]?.trim();
+    if (commandName?.startsWith("$"))
+        return "skill";
+    if (commandName?.startsWith("/"))
+        return "slash";
+    return "none";
+}
+function cloneEntry(entry) {
+    return {
+        ...entry,
+        clientStats: { ...entry.clientStats },
+        sessionStats: { ...entry.sessionStats },
+    };
+}
+export class PromptHistoryStore {
+    data = {
+        version: 2,
+        bridgeInstanceId: randomUUID(),
+        revision: 0,
+        entries: [],
+    };
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath ?? DEFAULT_STORE_FILE;
+    }
+    async init() {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        try {
+            const raw = await readFile(this.filePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (parsed.version === 2 && Array.isArray(parsed.entries)) {
+                this.data = {
+                    version: 2,
+                    bridgeInstanceId: typeof parsed.bridgeInstanceId === "string" &&
+                        parsed.bridgeInstanceId.length > 0
+                        ? parsed.bridgeInstanceId
+                        : randomUUID(),
+                    revision: Number.isInteger(parsed.revision) ? parsed.revision : 0,
+                    entries: parsed.entries.map((entry) => ({
+                        ...entry,
+                        clientStats: entry.clientStats ?? {},
+                        sessionStats: entry.sessionStats ?? {},
+                        commandKind: entry.commandKind ?? detectPromptCommandKind(entry.text),
+                    })),
+                };
+                if (!parsed.bridgeInstanceId)
+                    await this.save();
+            }
+        }
+        catch {
+            this.data = {
+                version: 2,
+                bridgeInstanceId: randomUUID(),
+                revision: 0,
+                entries: [],
+            };
+            await this.save();
+        }
+    }
+    get revision() {
+        return this.data.revision;
+    }
+    get bridgeInstanceId() {
+        return this.data.bridgeInstanceId;
+    }
+    list(includeDeleted = false) {
+        return this.data.entries
+            .filter((entry) => includeDeleted || !entry.deletedAt)
+            .map(cloneEntry);
+    }
+    async record(input) {
+        const text = normalizeText(input.text);
+        if (!text)
+            throw new Error("Prompt text is required");
+        const projectPath = normalizeProjectPath(input.projectPath);
+        const id = promptHistoryId(text, projectPath);
+        const usedAt = input.usedAt ?? isoNow();
+        const existing = this.findMutable(id);
+        if (existing) {
+            existing.totalUseCount += 1;
+            existing.lastUsedAt = maxIso(existing.lastUsedAt, usedAt);
+            existing.updatedAt = maxIso(existing.updatedAt, usedAt);
+            existing.deletedAt = undefined;
+            this.incrementClientStat(existing, input.clientId, input.clientName, usedAt, 1);
+            if (input.sessionId)
+                this.incrementSessionStat(existing, input.sessionId, usedAt, 1);
+            await this.saveBumped();
+            return cloneEntry(existing);
+        }
+        const entry = {
+            id,
+            text,
+            projectPath,
+            totalUseCount: 1,
+            isFavorite: false,
+            createdAt: usedAt,
+            lastUsedAt: usedAt,
+            updatedAt: usedAt,
+            commandKind: detectPromptCommandKind(text),
+            clientStats: {},
+            sessionStats: {},
+        };
+        this.incrementClientStat(entry, input.clientId, input.clientName, usedAt, 1);
+        if (input.sessionId)
+            this.incrementSessionStat(entry, input.sessionId, usedAt, 1);
+        this.data.entries.push(entry);
+        await this.saveBumped();
+        return cloneEntry(entry);
+    }
+    async mutate(input) {
+        const id = input.id ?? (input.text ? promptHistoryId(input.text, input.projectPath ?? "") : undefined);
+        if (!id)
+            return null;
+        const entry = this.findMutable(id);
+        if (!entry)
+            return null;
+        const updatedAt = input.updatedAt ?? isoNow();
+        switch (input.action) {
+            case "favorite":
+                entry.isFavorite = input.isFavorite ?? !entry.isFavorite;
+                entry.favoriteUpdatedAt = updatedAt;
+                entry.updatedAt = maxIso(entry.updatedAt, updatedAt);
+                break;
+            case "delete":
+                entry.deletedAt = updatedAt;
+                entry.updatedAt = maxIso(entry.updatedAt, updatedAt);
+                break;
+            case "restore":
+                entry.deletedAt = undefined;
+                entry.updatedAt = maxIso(entry.updatedAt, updatedAt);
+                break;
+        }
+        await this.saveBumped();
+        return cloneEntry(entry);
+    }
+    async importEntries(entries, clientId, clientName) {
+        this.data.entries = [];
+        let imported = 0;
+        for (const raw of entries) {
+            const text = normalizeText(raw.text);
+            if (!text)
+                continue;
+            const projectPath = normalizeProjectPath(raw.projectPath);
+            const id = raw.id ?? promptHistoryId(text, projectPath);
+            const now = isoNow();
+            const useCount = Math.max(1, raw.totalUseCount ?? raw.useCount ?? 1);
+            const createdAt = raw.createdAt ?? now;
+            const lastUsedAt = raw.lastUsedAt ?? raw.updatedAt ?? now;
+            const updatedAt = raw.updatedAt ?? lastUsedAt;
+            const incoming = {
+                id,
+                text,
+                projectPath,
+                totalUseCount: useCount,
+                isFavorite: raw.isFavorite ?? false,
+                createdAt,
+                lastUsedAt,
+                updatedAt,
+                favoriteUpdatedAt: raw.favoriteUpdatedAt ?? (raw.isFavorite ? updatedAt : undefined),
+                deletedAt: raw.deletedAt,
+                commandKind: raw.commandKind ?? detectPromptCommandKind(text),
+                clientStats: raw.clientStats ?? {},
+                sessionStats: raw.sessionStats ?? {},
+            };
+            this.incrementClientStat(incoming, clientId, clientName, lastUsedAt, useCount);
+            this.mergeEntry(incoming);
+            imported += 1;
+        }
+        await this.saveBumped();
+        return { imported, entries: this.list() };
+    }
+    async mergeClientEntries(entries) {
+        if (entries.length === 0)
+            return;
+        for (const raw of entries) {
+            const text = normalizeText(raw.text);
+            if (!text)
+                continue;
+            const projectPath = normalizeProjectPath(raw.projectPath);
+            this.mergeEntry({
+                id: raw.id ?? promptHistoryId(text, projectPath),
+                text,
+                projectPath,
+                totalUseCount: Math.max(1, raw.totalUseCount ?? raw.useCount ?? 1),
+                isFavorite: raw.isFavorite ?? false,
+                createdAt: raw.createdAt ?? isoNow(),
+                lastUsedAt: raw.lastUsedAt ?? raw.updatedAt ?? isoNow(),
+                updatedAt: raw.updatedAt ?? raw.lastUsedAt ?? isoNow(),
+                favoriteUpdatedAt: raw.favoriteUpdatedAt,
+                deletedAt: raw.deletedAt,
+                commandKind: raw.commandKind ?? detectPromptCommandKind(text),
+                clientStats: raw.clientStats ?? {},
+                sessionStats: raw.sessionStats ?? {},
+            });
+        }
+        await this.saveBumped();
+    }
+    findMutable(id) {
+        return this.data.entries.find((entry) => entry.id === id);
+    }
+    incrementClientStat(entry, clientId, clientName, lastUsedAt, increment) {
+        const current = entry.clientStats[clientId] ?? { useCount: 0, lastUsedAt };
+        entry.clientStats[clientId] = {
+            useCount: current.useCount + increment,
+            lastUsedAt: maxIso(current.lastUsedAt, lastUsedAt),
+            clientName: clientName ?? current.clientName,
+        };
+    }
+    incrementSessionStat(entry, sessionId, lastUsedAt, increment) {
+        const current = entry.sessionStats[sessionId] ?? { useCount: 0, lastUsedAt };
+        entry.sessionStats[sessionId] = {
+            useCount: current.useCount + increment,
+            lastUsedAt: maxIso(current.lastUsedAt, lastUsedAt),
+        };
+    }
+    mergeEntry(incoming) {
+        const existing = this.findMutable(incoming.id);
+        if (!existing) {
+            this.data.entries.push(cloneEntry(incoming));
+            return;
+        }
+        existing.totalUseCount += incoming.totalUseCount;
+        existing.createdAt = minIso(existing.createdAt, incoming.createdAt);
+        existing.lastUsedAt = maxIso(existing.lastUsedAt, incoming.lastUsedAt);
+        existing.updatedAt = maxIso(existing.updatedAt, incoming.updatedAt);
+        existing.commandKind =
+            existing.commandKind === "none" ? incoming.commandKind : existing.commandKind;
+        if (incoming.favoriteUpdatedAt &&
+            (!existing.favoriteUpdatedAt ||
+                incoming.favoriteUpdatedAt >= existing.favoriteUpdatedAt)) {
+            existing.isFavorite = incoming.isFavorite;
+            existing.favoriteUpdatedAt = incoming.favoriteUpdatedAt;
+        }
+        else if (incoming.isFavorite && !existing.favoriteUpdatedAt) {
+            existing.isFavorite = true;
+            existing.favoriteUpdatedAt = incoming.updatedAt;
+        }
+        if (incoming.deletedAt && (!existing.deletedAt || incoming.deletedAt >= existing.deletedAt)) {
+            existing.deletedAt = incoming.deletedAt;
+        }
+        for (const [clientId, stat] of Object.entries(incoming.clientStats)) {
+            const current = existing.clientStats[clientId];
+            existing.clientStats[clientId] = current
+                ? {
+                    useCount: current.useCount + stat.useCount,
+                    lastUsedAt: maxIso(current.lastUsedAt, stat.lastUsedAt),
+                    clientName: stat.clientName ?? current.clientName,
+                }
+                : { ...stat };
+        }
+        for (const [sessionId, stat] of Object.entries(incoming.sessionStats)) {
+            const current = existing.sessionStats[sessionId];
+            existing.sessionStats[sessionId] = current
+                ? {
+                    useCount: current.useCount + stat.useCount,
+                    lastUsedAt: maxIso(current.lastUsedAt, stat.lastUsedAt),
+                }
+                : { ...stat };
+        }
+    }
+    async saveBumped() {
+        this.data.revision += 1;
+        await this.save();
+    }
+    async save() {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        const tmp = `${this.filePath}.${randomUUID()}.tmp`;
+        await writeFile(tmp, JSON.stringify(this.data, null, 2), "utf-8");
+        await rename(tmp, this.filePath);
+    }
+}
+//# sourceMappingURL=prompt-history-store.js.map

package/dist/prompt-history-store.js.map

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

package/dist/websocket.d.ts

@@ -6,6 +6,7 @@ import { DebugTraceStore } from "./debug-trace-store.js";
 import { RecordingStore } from "./recording-store.js";
 import type { FirebaseAuthClient } from "./firebase-auth.js";
 import type { PromptHistoryBackupStore } from "./prompt-history-backup.js";
+import type { PromptHistoryStore } from "./prompt-history-store.js";
 export interface BridgeServerOptions {
     server: HttpServer;
     apiKey?: string;
@@ -17,6 +18,7 @@ export interface BridgeServerOptions {
     recordingStore?: RecordingStore;
     firebaseAuth?: FirebaseAuthClient;
     promptHistoryBackup?: PromptHistoryBackupStore;
+    promptHistoryStore?: PromptHistoryStore;
     platform?: NodeJS.Platform;
 }
 export declare class BridgeWebSocketServer {
@@ -34,6 +36,7 @@ export declare class BridgeWebSocketServer {
     private worktreeStore;
     private pushRelay;
     private promptHistoryBackup;
+    private promptHistoryStore;
     private recentSessionsRequestId;
     private debugEvents;
     private notifiedPermissionToolUses;
@@ -83,8 +86,10 @@ export declare class BridgeWebSocketServer {
     private resolveSession;
     private getFirstSession;
     private sendSessionList;
+    private sendPromptHistoryStatus;
     /** Broadcast session list to all connected clients. */
     private broadcastSessionList;
+    private broadcastPromptHistoryStatus;
     private broadcastSessionMessage;
     private listRecentSessions;
     private refreshCodexProfiles;

package/dist/websocket.js

@@ -38,6 +38,10 @@ const CODEX_MODELS = [
     "gpt-5.3-codex",
     "gpt-5.3-codex-spark",
 ];
+const OPT_IN_SERVER_MESSAGES = new Set([
+    "conversation_queue",
+    "prompt_history_status",
+]);
 // ---- Codex mode mapping helpers ----
 /** Map unified PermissionMode to Codex approval_policy.
  *  Only "bypassPermissions" maps to "never"; all others use "on-request". */
@@ -166,6 +170,7 @@ export class BridgeWebSocketServer {
     worktreeStore;
     pushRelay;
     promptHistoryBackup;
+    promptHistoryStore;
     recentSessionsRequestId = 0;
     debugEvents = new Map();
     notifiedPermissionToolUses = new Map();
@@ -181,7 +186,7 @@ export class BridgeWebSocketServer {
     platform;
     clientSupportedServerMessages = new WeakMap();
     constructor(options) {
-        const { server, apiKey, allowedDirs, imageStore, galleryStore, projectHistory, debugTraceStore, recordingStore, firebaseAuth, promptHistoryBackup, platform, } = options;
+        const { server, apiKey, allowedDirs, imageStore, galleryStore, projectHistory, debugTraceStore, recordingStore, firebaseAuth, promptHistoryBackup, promptHistoryStore, platform, } = options;
         this.apiKey = apiKey ?? null;
         this.allowedDirs = allowedDirs ?? [];
         this.imageStore = imageStore ?? null;
@@ -192,6 +197,7 @@ export class BridgeWebSocketServer {
         this.worktreeStore = new WorktreeStore();
         this.pushRelay = new PushRelayClient({ firebaseAuth });
         this.promptHistoryBackup = promptHistoryBackup ?? null;
+        this.promptHistoryStore = promptHistoryStore ?? null;
         this.platform = platform ?? process.platform;
         this.archiveStore = new ArchiveStore();
         void this.debugTraceStore.init().catch((err) => {
@@ -544,6 +550,7 @@ export class BridgeWebSocketServer {
     async handleClientMessage(msg, ws) {
         if (msg.type === "client_capabilities") {
             this.clientSupportedServerMessages.set(ws, new Set(msg.supportedServerMessages ?? []));
+            this.sendPromptHistoryStatus(ws);
             return;
         }
         const incomingSessionId = this.extractSessionIdFromClientMessage(msg);
@@ -3205,6 +3212,144 @@ export class BridgeWebSocketServer {
                 });
                 break;
             }
+            case "record_prompt_history": {
+                if (!this.promptHistoryStore) {
+                    this.send(ws, {
+                        type: "prompt_history_mutation_result",
+                        success: false,
+                        error: "Prompt history store not available",
+                    });
+                    break;
+                }
+                try {
+                    const entry = await this.promptHistoryStore.record({
+                        text: msg.text,
+                        projectPath: msg.projectPath,
+                        clientId: msg.clientId,
+                        clientName: msg.clientName,
+                        sessionId: msg.sessionId,
+                        usedAt: msg.usedAt,
+                    });
+                    this.send(ws, {
+                        type: "prompt_history_mutation_result",
+                        success: true,
+                        bridgeInstanceId: this.promptHistoryStore.bridgeInstanceId,
+                        revision: this.promptHistoryStore.revision,
+                        entry,
+                    });
+                    this.broadcastPromptHistoryStatus();
+                }
+                catch (err) {
+                    this.send(ws, {
+                        type: "prompt_history_mutation_result",
+                        success: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                break;
+            }
+            case "sync_prompt_history": {
+                if (!this.promptHistoryStore) {
+                    this.send(ws, {
+                        type: "prompt_history_sync_result",
+                        success: false,
+                        error: "Prompt history store not available",
+                    });
+                    break;
+                }
+                try {
+                    if (msg.entries?.length) {
+                        await this.promptHistoryStore.mergeClientEntries(msg.entries);
+                    }
+                    this.send(ws, {
+                        type: "prompt_history_sync_result",
+                        success: true,
+                        bridgeInstanceId: this.promptHistoryStore.bridgeInstanceId,
+                        revision: this.promptHistoryStore.revision,
+                        syncedAt: new Date().toISOString(),
+                        fullSnapshot: true,
+                        entries: this.promptHistoryStore.list(msg.includeDeleted ?? true),
+                    });
+                    this.broadcastPromptHistoryStatus();
+                }
+                catch (err) {
+                    this.send(ws, {
+                        type: "prompt_history_sync_result",
+                        success: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                break;
+            }
+            case "mutate_prompt_history": {
+                if (!this.promptHistoryStore) {
+                    this.send(ws, {
+                        type: "prompt_history_mutation_result",
+                        success: false,
+                        error: "Prompt history store not available",
+                    });
+                    break;
+                }
+                try {
+                    const entry = await this.promptHistoryStore.mutate({
+                        id: msg.id,
+                        text: msg.text,
+                        projectPath: msg.projectPath,
+                        action: msg.action,
+                        isFavorite: msg.isFavorite,
+                        updatedAt: msg.updatedAt,
+                    });
+                    this.send(ws, {
+                        type: "prompt_history_mutation_result",
+                        success: entry != null,
+                        bridgeInstanceId: this.promptHistoryStore.bridgeInstanceId,
+                        revision: this.promptHistoryStore.revision,
+                        entry: entry ?? undefined,
+                        error: entry == null ? "Prompt not found" : undefined,
+                    });
+                    if (entry)
+                        this.broadcastPromptHistoryStatus();
+                }
+                catch (err) {
+                    this.send(ws, {
+                        type: "prompt_history_mutation_result",
+                        success: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                break;
+            }
+            case "import_prompt_history_v1": {
+                if (!this.promptHistoryStore) {
+                    this.send(ws, {
+                        type: "prompt_history_sync_result",
+                        success: false,
+                        error: "Prompt history store not available",
+                    });
+                    break;
+                }
+                try {
+                    const result = await this.promptHistoryStore.importEntries(msg.entries, msg.clientId, msg.clientName);
+                    this.send(ws, {
+                        type: "prompt_history_sync_result",
+                        success: true,
+                        bridgeInstanceId: this.promptHistoryStore.bridgeInstanceId,
+                        revision: this.promptHistoryStore.revision,
+                        syncedAt: new Date().toISOString(),
+                        fullSnapshot: true,
+                        entries: result.entries,
+                    });
+                    this.broadcastPromptHistoryStatus();
+                }
+                catch (err) {
+                    this.send(ws, {
+                        type: "prompt_history_sync_result",
+                        success: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                break;
+            }
             case "rename_session": {
                 const name = msg.name || null;
                 await this.handleRenameSession(ws, msg.sessionId, name, msg);
@@ -3308,6 +3453,19 @@ export class BridgeWebSocketServer {
             bridgeVersion: getPackageVersion(),
         });
     }
+    sendPromptHistoryStatus(ws) {
+        if (!this.promptHistoryStore)
+            return;
+        const entries = this.promptHistoryStore.list(true);
+        const updatedAt = entries.reduce((latest, entry) => !latest || entry.updatedAt > latest ? entry.updatedAt : latest, undefined);
+        this.send(ws, {
+            type: "prompt_history_status",
+            bridgeInstanceId: this.promptHistoryStore.bridgeInstanceId,
+            revision: this.promptHistoryStore.revision,
+            entryCount: entries.filter((entry) => !entry.deletedAt).length,
+            updatedAt,
+        });
+    }
     /** Broadcast session list to all connected clients. */
     broadcastSessionList() {
         this.pruneDebugEvents();
@@ -3323,6 +3481,19 @@ export class BridgeWebSocketServer {
             bridgeVersion: getPackageVersion(),
         });
     }
+    broadcastPromptHistoryStatus() {
+        if (!this.promptHistoryStore)
+            return;
+        const entries = this.promptHistoryStore.list(true);
+        const updatedAt = entries.reduce((latest, entry) => !latest || entry.updatedAt > latest ? entry.updatedAt : latest, undefined);
+        this.broadcast({
+            type: "prompt_history_status",
+            bridgeInstanceId: this.promptHistoryStore.bridgeInstanceId,
+            revision: this.promptHistoryStore.revision,
+            entryCount: entries.filter((entry) => !entry.deletedAt).length,
+            updatedAt,
+        });
+    }
     broadcastSessionMessage(sessionId, msg) {
         this.maybeSendPushNotification(sessionId, msg);
         this.recordDebugEvent(sessionId, {
@@ -3681,11 +3852,10 @@ export class BridgeWebSocketServer {
         }
     }
     shouldSendToClient(ws, msg) {
-        if (msg.type !== "conversation_queue")
+        const type = typeof msg.type === "string" ? msg.type : "";
+        if (!OPT_IN_SERVER_MESSAGES.has(type))
             return true;
-        return (this.clientSupportedServerMessages
-            .get(ws)
-            ?.has("conversation_queue") ?? false);
+        return (this.clientSupportedServerMessages.get(ws)?.has(type) ?? false);
     }
     hasInputConflictSince(sessionId, baseSeq) {
         const delta = this.sessionManager.getHistorySince(sessionId, baseSeq);