@chainingintention/pi-web-cn 2.0.0 → 2.202610.0

package/dist/server/sessions/queuedMessageMutation.js

@@ -0,0 +1,170 @@
+import { UserFacingError, createTranslator } from "../../shared/i18n.js";
+const incompatibilityReason = "Queue message controls are unavailable because this Pi SDK queue interface is incompatible.";
+let inspectionSequence = 0;
+/** Fail closed for one runtime, without taking its public session operations down. */
+export class QueueCompatibilityGuard {
+    constructor(onFailure, t = createTranslator("en", {})) {
+        this.onFailure = onFailure;
+        this.t = t;
+        this.failures = new WeakMap();
+    }
+    reason(runtime) { return this.failures.get(runtime); }
+    assertAvailable(runtime) {
+        const reason = this.reason(runtime);
+        if (reason !== undefined)
+            throw new UserFacingError("queueControls.incompatible", incompatibilityReason);
+    }
+    run(runtime, operation) {
+        this.assertAvailable(runtime);
+        try {
+            return operation();
+        }
+        catch (error) {
+            this.failures.set(runtime, this.t("queueControls.incompatible", incompatibilityReason));
+            this.onFailure(runtime, error);
+            throw new UserFacingError("queueControls.incompatible", incompatibilityReason);
+        }
+    }
+    inspect(runtime, operation, fallback) {
+        if (this.reason(runtime) !== undefined)
+            return fallback();
+        try {
+            return this.run(runtime, operation);
+        }
+        catch {
+            return fallback();
+        }
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isQueuedMessage(value) {
+    return isRecord(value) && (value["kind"] === "steer" || value["kind"] === "followUp") && typeof value["text"] === "string"
+        && (value["hasAttachments"] === undefined || typeof value["hasAttachments"] === "boolean")
+        && (value["attachmentCount"] === undefined || (typeof value["attachmentCount"] === "number" && Number.isSafeInteger(value["attachmentCount"]) && value["attachmentCount"] >= 0));
+}
+export function parseQueueMessageMutation(value) {
+    if (!isRecord(value))
+        throw new UserFacingError("queueControls.mutationRequired", "Queue mutation is required");
+    const { action, index, expectedQueue } = value;
+    if (action !== "remove" && action !== "edit" && action !== "toggle")
+        throw new UserFacingError("queueControls.invalidAction", "Invalid queue action");
+    if (typeof index !== "number" || !Number.isSafeInteger(index) || index < 0)
+        throw new UserFacingError("queueControls.invalidIndex", "Invalid queue index");
+    if (!Array.isArray(expectedQueue) || !expectedQueue.every(isQueuedMessage))
+        throw new UserFacingError("queueControls.invalidExpected", "Invalid expected queue");
+    return { action, index, expectedQueue: expectedQueue.map(({ kind, text, hasAttachments, attachmentCount }) => ({ kind, text, ...(hasAttachments === undefined ? {} : { hasAttachments }), ...(attachmentCount === undefined ? {} : { attachmentCount }) })) };
+}
+function isQueueMessage(value) {
+    if (!isRecord(value) || typeof value["role"] !== "string")
+        return false;
+    if (value["role"] !== "user")
+        return true; // Opaque extension/tool messages are preserved, not interpreted.
+    const content = value["content"];
+    return typeof content === "string" || (Array.isArray(content) && content.every((part) => isRecord(part)
+        && typeof part["type"] === "string" && (part["type"] !== "text" || typeof part["text"] === "string")));
+}
+function queueModes(agent) {
+    return { steer: agent.steeringMode, followUp: agent.followUpMode };
+}
+function readQueue(agent) {
+    const value = agent.peekQueuedMessages();
+    if (!Array.isArray(value) || !value.every(isQueueMessage))
+        throw new Error("SDK queue inspection returned invalid messages");
+    return [...value];
+}
+/** No awaits: the agent loop cannot consume queues between snapshot and rebuild. */
+export function snapshotAgentQueues(agent) {
+    const steeringMode = agent.steeringMode;
+    const followUpMode = agent.followUpMode;
+    const sentinel = { role: "user", content: `pi-web-queue-inspection-${String(++inspectionSequence)}`, timestamp: 0 };
+    let steer;
+    try {
+        agent.steeringMode = "all";
+        agent.followUpMode = "all";
+        const modes = queueModes(agent);
+        if (modes.steer !== "all" || modes.followUp !== "all")
+            throw new Error("SDK queue modes are not writable");
+        // Validate the return signature before touching any queued messages.
+        if (readQueue(agent).length === 0)
+            return { steer: [], followUp: [] };
+        agent.steer(sentinel);
+        const selected = readQueue(agent);
+        const last = selected.at(-1);
+        if (last !== sentinel) {
+            // If inspection now returns copies, remove the recognizable probe during
+            // rollback, but still disable operations that assumed SDK object identity.
+            if (last?.role === "user" && last.content === sentinel.content && last.timestamp === 0)
+                steer = selected.slice(0, -1);
+            throw new Error("SDK queue inspection no longer preserves queued message identity");
+        }
+        steer = selected.slice(0, -1);
+        agent.clearSteeringQueue();
+        return { steer, followUp: readQueue(agent) };
+    }
+    finally {
+        // Never clear originals when inspection failed before a trustworthy snapshot.
+        try {
+            if (steer !== undefined) {
+                agent.clearSteeringQueue();
+                for (const message of steer)
+                    agent.steer(message);
+            }
+        }
+        finally {
+            try {
+                agent.steeringMode = steeringMode;
+            }
+            finally {
+                agent.followUpMode = followUpMode;
+            }
+        }
+    }
+}
+export function hasQueueApi(agent) {
+    return [agent.peekQueuedMessages, agent.clearSteeringQueue, agent.clearAllQueues, agent.steer, agent.followUp]
+        .every((method) => typeof method === "function" && method.constructor.name !== "AsyncFunction")
+        && (agent.steeringMode === "all" || agent.steeringMode === "one-at-a-time")
+        && (agent.followUpMode === "all" || agent.followUpMode === "one-at-a-time");
+}
+export function mutableQueueAgent(agent) {
+    if (!hasQueueApi(agent))
+        throw new Error("Runtime does not support synchronous queue message mutation");
+    return agent;
+}
+/** SDK getters expose mutable backing arrays despite our read-only session contract. */
+export function mutableTextMirror(texts) {
+    if (!Array.isArray(texts) || !texts.every((text) => typeof text === "string") || typeof texts.splice !== "function"
+        || !Object.isExtensible(texts) || Object.isSealed(texts) || Object.getOwnPropertyDescriptor(texts, "length")?.writable !== true
+        || Object.keys(texts).some((key) => /^\d+$/.test(key) && Object.getOwnPropertyDescriptor(texts, key)?.writable !== true)) {
+        throw new Error("SDK queue text mirrors are not mutable string arrays");
+    }
+    return texts;
+}
+export function queuedMessageAttachmentCount(message) {
+    return message.role === "user" && Array.isArray(message.content) ? message.content.filter((part) => part.type === "image").length : 0;
+}
+function matchQueueEntries(messages, texts) {
+    let start = 0;
+    return texts.map((text) => {
+        const index = messages.findIndex((message, index) => index >= start && message.role === "user"
+            && (typeof message.content === "string" ? message.content : message.content.filter((part) => part.type === "text").map((part) => part.text).join("")) === text);
+        const message = messages[index];
+        if (index >= 0)
+            start = index + 1;
+        return { text, message };
+    });
+}
+export function mirroredQueueEntries(messages, texts) {
+    return matchQueueEntries(messages, texts).map(({ text, message }) => {
+        if (message === undefined)
+            throw new Error("Runtime queue text mirrors are out of sync");
+        return { text, message };
+    });
+}
+/** Queue-update events can briefly precede the SDK's full-message enqueue. */
+export function queuedMessageAttachmentCounts(messages, texts) {
+    return matchQueueEntries(messages, texts).map(({ message }) => message === undefined ? 0 : queuedMessageAttachmentCount(message));
+}
+//# sourceMappingURL=queuedMessageMutation.js.map

package/dist/server/sessions/queuedMessageMutation.js.map

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

package/dist/server/sessions/relaySkill.js

@@ -0,0 +1,169 @@
+import { createHash, randomUUID } from "node:crypto";
+import { readFileSync, realpathSync, statSync } from "node:fs";
+import { lstat, mkdir, readFile, readdir, rename, rm, rmdir, unlink, writeFile } from "node:fs/promises";
+import { isAbsolute, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { withFileMutationQueue } from "../../piSdk.js";
+export const MANAGED_RELAY_SKILL_NAMES = ["relay", "relay-runner"];
+const BUNDLED_SKILLS_DIRECTORY = fileURLToPath(new URL("../../../skills/", import.meta.url));
+const PACKAGED_SKILLS_DIRECTORY = fileURLToPath(new URL("../../../dist/pi-packages/relays/skills/", import.meta.url));
+// Original relay-runner template shipped before d530ab1a; never match by name alone.
+const LEGACY_RUNNER_SHA256 = "27e453f521a63997fd391881b46be568d78e75e163a8e2a2e9f25ec9609b2237";
+const PRE_DISPATCH_SKILL_SHA256 = {
+    relay: "d75f91a850ae7ea8dc5ce72092887abc6a5ee036a2fec41d36571aed434e13ec",
+    "relay-runner": "26722ad125a2877e33fc5f7a3b83e5806b775cc70082de40f1b78f5daadd0954",
+};
+function normalizedSkill(content) {
+    return content.replace(/\r\n/g, "\n");
+}
+export async function ensureManagedRelaySkills(cwd, bundledSkillsDirectory = BUNDLED_SKILLS_DIRECTORY) {
+    const paths = [];
+    for (const name of MANAGED_RELAY_SKILL_NAMES) {
+        paths.push(await synchronizeManagedSkill(cwd, name, join(bundledSkillsDirectory, name, "SKILL.md")));
+    }
+    return paths;
+}
+/** Full privileges use the package skills, but user-modified copies stay authoritative. */
+export async function removeUnmodifiedManagedRelaySkills(cwd) {
+    const projectRoot = realpathSync(cwd);
+    const skillsDirectory = join(projectRoot, ".pi", "skills");
+    for (const directory of [join(projectRoot, ".pi"), skillsDirectory]) {
+        if (!await isPlainManagedPath(directory, "directory"))
+            return;
+    }
+    // Keep the queue key alive when removing a child skill directory.
+    await withFileMutationQueue(skillsDirectory, async () => {
+        for (const name of MANAGED_RELAY_SKILL_NAMES) {
+            const directory = join(skillsDirectory, name);
+            const skillPath = join(directory, "SKILL.md");
+            if (!await isPlainManagedPath(directory, "directory") || !await isPlainManagedPath(skillPath, "file"))
+                continue;
+            const files = await readdir(directory);
+            if (files.length !== 1 || files[0] !== "SKILL.md")
+                continue;
+            const content = normalizedSkill(await readFile(skillPath, "utf8"));
+            const current = normalizedSkill(await readFile(join(BUNDLED_SKILLS_DIRECTORY, name, "SKILL.md"), "utf8"));
+            const hash = createHash("sha256").update(content).digest("hex");
+            const isHistoricalCopy = hash === PRE_DISPATCH_SKILL_SHA256[name]
+                || (name === "relay-runner" && hash === LEGACY_RUNNER_SHA256);
+            if (content !== current && !isHistoricalCopy)
+                continue;
+            assertManagedSkillPath(projectRoot, skillPath, "file");
+            // No recursive removal: unexpected additions must not be deleted.
+            await unlink(skillPath);
+            await rmdir(directory);
+        }
+    });
+}
+async function isPlainManagedPath(path, expectedType) {
+    try {
+        const stats = await lstat(path);
+        return !stats.isSymbolicLink() && (expectedType === "directory" ? stats.isDirectory() : stats.isFile());
+    }
+    catch (error) {
+        if (isNodeError(error, "ENOENT"))
+            return false;
+        throw error;
+    }
+}
+async function synchronizeManagedSkill(cwd, name, bundledSkillPath) {
+    const projectRoot = realpathSync(cwd);
+    const piDirectory = join(projectRoot, ".pi");
+    const skillsDirectory = join(piDirectory, "skills");
+    const skillDirectory = join(skillsDirectory, name);
+    for (const directory of [piDirectory, skillsDirectory]) {
+        try {
+            await mkdir(directory);
+        }
+        catch (error) {
+            if (!isNodeError(error, "EEXIST"))
+                throw error;
+        }
+        assertManagedSkillPath(projectRoot, directory, "directory");
+    }
+    const skillPath = join(skillDirectory, "SKILL.md");
+    // Synchronization and cleanup share a stable parent-directory queue key.
+    return withFileMutationQueue(skillsDirectory, async () => {
+        await mkdir(skillDirectory, { recursive: true });
+        assertManagedSkillPath(projectRoot, skillDirectory, "directory");
+        try {
+            assertManagedSkillPath(projectRoot, skillPath, "file");
+        }
+        catch (error) {
+            if (!isNodeError(error, "ENOENT"))
+                throw error;
+        }
+        const current = await readFile(bundledSkillPath, "utf8");
+        try {
+            if (await readFile(skillPath, "utf8") === current)
+                return skillPath;
+        }
+        catch (error) {
+            if (!isNodeError(error, "ENOENT"))
+                throw error;
+        }
+        // Concurrent session starts must never read a partially overwritten template.
+        const temporaryPath = join(skillDirectory, `.relay-${randomUUID()}.tmp`);
+        try {
+            await writeFile(temporaryPath, current, { flag: "wx" });
+            await rename(temporaryPath, skillPath);
+        }
+        finally {
+            await rm(temporaryPath, { force: true });
+        }
+        return skillPath;
+    });
+}
+/** The SDK already selects one skill; omit only a proven identical bundled/project duplicate. */
+export function deduplicateBundledRelaySkills(cwd, base) {
+    return {
+        ...base,
+        diagnostics: base.diagnostics.filter((diagnostic) => {
+            const collision = diagnostic.collision;
+            if (diagnostic.type !== "collision" || collision?.resourceType !== "skill")
+                return true;
+            const name = MANAGED_RELAY_SKILL_NAMES.find((name) => name === collision.name);
+            if (name === undefined)
+                return true;
+            try {
+                const projectRoot = realpathSync(cwd);
+                const projectSkill = join(projectRoot, ".pi", "skills", name, "SKILL.md");
+                assertManagedSkillPath(projectRoot, projectSkill, "file");
+                const projectRealPath = realpathSync(projectSkill);
+                const winner = realpathSync(collision.winnerPath);
+                const loser = realpathSync(collision.loserPath);
+                const otherPath = winner === projectRealPath ? loser : loser === projectRealPath ? winner : undefined;
+                if (otherPath === undefined || !isBundledRelayPath(otherPath, name))
+                    return true;
+                return normalizedSkill(readFileSync(projectSkill, "utf8")) !== normalizedSkill(readFileSync(otherPath, "utf8"));
+            }
+            catch {
+                // Missing or unreadable resources must retain their diagnostics.
+                return true;
+            }
+        }),
+    };
+}
+function isBundledRelayPath(path, name) {
+    return [BUNDLED_SKILLS_DIRECTORY, PACKAGED_SKILLS_DIRECTORY].some((directory) => {
+        try {
+            return realpathSync(join(directory, name, "SKILL.md")) === path;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function assertManagedSkillPath(projectRoot, path, expectedType) {
+    const realPath = realpathSync(path);
+    const childRelativePath = relative(projectRoot, realPath);
+    const stats = statSync(realPath);
+    const hasExpectedType = expectedType === "directory" ? stats.isDirectory() : stats.isFile();
+    if (childRelativePath.startsWith("..") || isAbsolute(childRelativePath) || !hasExpectedType) {
+        throw new Error(`Managed skill path is invalid: ${path}`);
+    }
+}
+function isNodeError(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+//# sourceMappingURL=relaySkill.js.map

package/dist/server/sessions/relaySkill.js.map

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

package/dist/server/sessions/sessionActivityMarker.js

@@ -0,0 +1,105 @@
+import { randomUUID } from "node:crypto";
+import { readFile, stat, unlink, writeFile } from "node:fs/promises";
+const markerPath = (sessionFile) => `${sessionFile}.pi-web-activity.json`;
+const isMissing = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+/** Best-effort advisory presence, not a lock or an atomic ownership claim. */
+export class SessionActivityMarker {
+    constructor(options = {}) {
+        this.entries = new Map();
+        this.owner = options.owner ?? randomUUID();
+        this.now = options.now ?? Date.now;
+        this.onError = options.onError;
+    }
+    async refresh(sessionFile, busy) {
+        if (sessionFile === undefined || sessionFile === "" || this.disposal)
+            return;
+        let entry = this.entries.get(sessionFile);
+        if (!entry) {
+            entry = { pending: Promise.resolve(), activeElsewhere: false };
+            this.entries.set(sessionFile, entry);
+        }
+        const state = entry;
+        await this.enqueue(state, async () => {
+            const now = this.now();
+            if (state.busy === busy && state.refreshedAt !== undefined && now - state.refreshedAt < 2_000)
+                return;
+            state.busy = busy;
+            state.refreshedAt = now;
+            // Keep the last known activity visible until the filesystem read completes.
+            // Never create directories or sidecars for transcripts that do not exist.
+            await stat(sessionFile);
+            const marker = await this.readMarker(sessionFile);
+            state.activeElsewhere = marker !== undefined && marker.owner !== this.owner && now - marker.updatedAt <= 15_000;
+            if (state.activeElsewhere)
+                return;
+            if (busy) {
+                await writeFile(markerPath(sessionFile), JSON.stringify({ owner: this.owner, updatedAt: now }));
+            }
+            else if (marker?.owner === this.owner) {
+                await unlink(markerPath(sessionFile));
+            }
+        });
+    }
+    isActiveElsewhere(sessionFile) {
+        return sessionFile === undefined ? false : this.entries.get(sessionFile)?.activeElsewhere ?? false;
+    }
+    async release(sessionFile) {
+        if (sessionFile === undefined || sessionFile === "")
+            return;
+        const entry = this.entries.get(sessionFile);
+        if (!entry)
+            return;
+        const pending = this.enqueue(entry, async () => {
+            entry.activeElsewhere = false;
+            delete entry.refreshedAt;
+            delete entry.busy;
+            if ((await this.readMarker(sessionFile))?.owner === this.owner) {
+                await unlink(markerPath(sessionFile));
+            }
+        });
+        await pending;
+        if (entry.pending === pending)
+            this.entries.delete(sessionFile);
+    }
+    async dispose() {
+        this.disposal ??= Promise.all([...this.entries.keys()].map((file) => this.release(file))).then(() => undefined);
+        await this.disposal;
+    }
+    enqueue(entry, operation) {
+        entry.pending = entry.pending.then(operation).catch((error) => {
+            entry.activeElsewhere = false;
+            if (!isMissing(error)) {
+                // An error reporter must not turn advisory IO into a session failure.
+                try {
+                    this.onError?.(error);
+                }
+                catch { /* Best effort only. */ }
+            }
+        });
+        return entry.pending;
+    }
+    async readMarker(sessionFile) {
+        let text;
+        try {
+            text = await readFile(markerPath(sessionFile), "utf8");
+        }
+        catch (error) {
+            if (isMissing(error))
+                return undefined;
+            throw error;
+        }
+        let value;
+        try {
+            value = JSON.parse(text);
+        }
+        catch {
+            return undefined;
+        }
+        if (typeof value !== "object" || value === null || !("owner" in value) || !("updatedAt" in value))
+            return undefined;
+        if (typeof value.owner !== "string" || typeof value.updatedAt !== "number" || !Number.isFinite(value.updatedAt))
+            return undefined;
+        return { owner: value.owner, updatedAt: value.updatedAt };
+    }
+}
+//# sourceMappingURL=sessionActivityMarker.js.map

package/dist/server/sessions/sessionActivityMarker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionActivityMarker.js","sourceRoot":"","sources":["../../../src/server/sessions/sessionActivityMarker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAcrE,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAU,EAAE,CAAC,GAAG,WAAW,uBAAuB,CAAC;AAC1F,MAAM,SAAS,GAAG,CAAC,KAAc,EAAW,EAAE,CAC5C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAE5F,8EAA8E;AAC9E,MAAM,OAAO,qBAAqB;IAOhC,YAAY,UAAsF,EAAE;QAHnF,YAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;QAIlD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAA+B,EAAE,IAAa;QAC1D,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC7E,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;YAC/D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK;gBAAE,OAAO;YACtG,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;YAClB,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;YACxB,4EAA4E;YAC5E,0EAA0E;YAC1E,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAClD,KAAK,CAAC,eAAe,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;YAChH,IAAI,KAAK,CAAC,eAAe;gBAAE,OAAO;YAClC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAClG,CAAC;iBAAM,IAAI,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBACxC,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB,CAAC,WAA+B;QAC/C,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,eAAe,IAAI,KAAK,CAAC;IACrG,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAA+B;QAC3C,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,EAAE;YAAE,OAAO;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;YAC7C,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC;YAC9B,OAAO,KAAK,CAAC,WAAW,CAAC;YACzB,OAAO,KAAK,CAAC,IAAI,CAAC;YAClB,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC/D,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,CAAC;QACd,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAChH,MAAM,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAEO,OAAO,CAAC,KAAY,EAAE,SAA8B;QAC1D,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACrE,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,sEAAsE;gBACtE,IAAI,CAAC;oBAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;YAClE,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,WAAmB;QAC1C,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,CAAC,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,SAAS,CAAC;QAAC,CAAC;QAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACpH,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAClI,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAC5D,CAAC;CACF"}

package/dist/server/sessions/sessionArchiveMapping.js

@@ -1,3 +1,6 @@
+import { clientSessionFirstMessagePreview } from "./clientSessionPreview.js";
+import { loadNodeTranslator } from "../../localization.js";
+import { readSessionUiMetadata, requireSessionUiMetadata } from "./sessionMetadata.js";
 export function archiveInputFromListEntry(session) {
     return {
         sessionId: session.id,
@@ -7,15 +10,17 @@ export function archiveInputFromListEntry(session) {
         modified: session.modified.toISOString(),
         messageCount: session.messageCount,
         firstMessage: session.firstMessage,
+        ...(session.metadata === undefined ? {} : { metadata: session.metadata }),
         ...(session.name === undefined ? {} : { name: session.name }),
         ...(session.parentSessionPath === undefined ? {} : { parentSessionPath: session.parentSessionPath }),
     };
 }
-export function archiveInputFromActiveSession(session) {
+export function archiveInputFromActiveSession(session, t = loadNodeTranslator("server")) {
     const sessionFile = session.sessionFile;
     if (sessionFile === undefined || sessionFile === "")
-        throw new Error("会话尚未持久化");
+        throw new Error(t("session.notPersisted", "Session has not been persisted"));
     const parentSessionPath = session.sessionManager.getHeader?.()?.parentSession;
+    const metadata = readSessionUiMetadata(session.sessionManager.getEntries?.() ?? session.sessionManager.getBranch());
     return {
         sessionId: session.sessionId,
         cwd: session.sessionManager.getCwd(),
@@ -24,6 +29,7 @@ export function archiveInputFromActiveSession(session) {
         modified: new Date().toISOString(),
         messageCount: session.messages.length,
         firstMessage: "",
+        ...(metadata === undefined ? {} : { metadata }),
         ...(session.sessionName === undefined ? {} : { name: session.sessionName }),
         ...(parentSessionPath === undefined ? {} : { parentSessionPath }),
     };
@@ -52,10 +58,10 @@ export function archiveCandidateFromArchivedRecord(record, fallback) {
         ...(parentSessionPath === undefined ? {} : { parentSessionPath }),
     };
 }
-export function archiveCandidateFromActiveSession(session, archived) {
+export function archiveCandidateFromActiveSession(session, archived, t = loadNodeTranslator("server")) {
     const sessionFile = session.sessionFile;
     if (sessionFile === undefined || sessionFile === "")
-        throw new Error("会话尚未持久化");
+        throw new Error(t("session.notPersisted", "Session has not been persisted"));
     const parentSessionPath = session.sessionManager.getHeader?.()?.parentSession;
     return {
         id: session.sessionId,
@@ -66,12 +72,12 @@ export function archiveCandidateFromActiveSession(session, archived) {
         ...(parentSessionPath === undefined ? {} : { parentSessionPath }),
     };
 }
-export function archiveInputFromCandidate(candidate) {
+export function archiveInputFromCandidate(candidate, t = loadNodeTranslator("server")) {
     if (candidate.listEntry !== undefined)
         return archiveInputFromListEntry(candidate.listEntry);
     if (candidate.activeSession !== undefined)
-        return archiveInputFromActiveSession(candidate.activeSession);
-    throw new Error(`Session is not available for archiving: ${candidate.id}`);
+        return archiveInputFromActiveSession(candidate.activeSession, t);
+    throw new Error(t("session.archiveUnavailable", "Session is not available for archiving: {sessionId}", { sessionId: candidate.id }));
 }
 export function clientSessionFromArchivedRecord(record, fallback) {
     const path = record.originalPath ?? fallback?.path;
@@ -82,26 +88,21 @@ export function clientSessionFromArchivedRecord(record, fallback) {
     if (path === undefined || created === undefined || modified === undefined || messageCount === undefined || firstMessage === undefined)
         return undefined;
     const name = record.name ?? fallback?.name;
+    const metadata = record.metadata ?? fallback?.metadata;
     const parentSessionPath = record.parentSessionPath ?? fallback?.parentSessionPath;
     return {
         id: record.sessionId,
         path,
         cwd: record.cwd,
+        ...(metadata === undefined ? {} : { metadata: requireSessionUiMetadata(metadata) }),
         ...(name === undefined ? {} : { name }),
         created,
         modified,
         messageCount,
-        firstMessage,
+        firstMessage: clientSessionFirstMessagePreview(firstMessage),
         ...(parentSessionPath === undefined ? {} : { parentSessionPath }),
         archived: true,
         archivedAt: record.archivedAt,
     };
 }
-export function compareArchivedRecords(a, b) {
-    return archivedTimestamp(b) - archivedTimestamp(a);
-}
-function archivedTimestamp(record) {
-    const time = Date.parse(record.archivedAt);
-    return Number.isNaN(time) ? 0 : time;
-}
 //# sourceMappingURL=sessionArchiveMapping.js.map

package/dist/server/sessions/sessionArchiveMapping.js.map

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

package/dist/server/sessions/sessionArchiveStore.js

@@ -4,6 +4,7 @@ import { access, copyFile, mkdir, readFile, rename, unlink, writeFile } from "no
 import { basename, dirname, join } from "node:path";
 import { piWebDataDir } from "../../config.js";
 import { canonicalizeStoredCwd } from "../workingDirectory.js";
+import { requireSessionUiMetadata } from "./sessionMetadata.js";
 export function defaultSessionArchiveFilePath(env = process.env, cwd = process.cwd()) {
     return join(piWebDataDir(env, cwd), "archived-sessions.json");
 }
@@ -18,7 +19,7 @@ export class SessionArchiveStore {
     }
     async get(sessionId) {
         const sessions = (await this.read()).sessions;
-        return sessions.find((session) => session.sessionId === sessionId) ?? sessions.find((session) => session.sessionId.startsWith(sessionId));
+        return sessions.find((session) => session.sessionId === sessionId);
     }
     async archive(session) {
         const [record] = await this.archiveMany([session]);
@@ -147,6 +148,7 @@ function archiveRecordFromInput(session, archive) {
         modified: session.modified,
         messageCount: session.messageCount,
         firstMessage: session.firstMessage,
+        ...(session.metadata === undefined ? {} : { metadata: requireSessionUiMetadata(session.metadata) }),
         ...(session.name === undefined ? {} : { name: session.name }),
         ...(session.parentSessionPath === undefined ? {} : { parentSessionPath: session.parentSessionPath }),
     };
@@ -217,6 +219,7 @@ function parseArchivedSessionRecord(value) {
     const firstMessage = optionalString(value, "firstMessage");
     const name = optionalString(value, "name");
     const parentSessionPath = optionalString(value, "parentSessionPath");
+    const metadata = value["metadata"] === undefined ? undefined : requireSessionUiMetadata(value["metadata"]);
     return {
         sessionId,
         cwd: canonicalCwd,
@@ -227,6 +230,7 @@ function parseArchivedSessionRecord(value) {
         ...(modified === undefined ? {} : { modified }),
         ...(messageCount === undefined ? {} : { messageCount }),
         ...(firstMessage === undefined ? {} : { firstMessage }),
+        ...(metadata === undefined ? {} : { metadata }),
         ...(name === undefined ? {} : { name }),
         ...(parentSessionPath === undefined ? {} : { parentSessionPath }),
     };