@ck123pm/paseo-server 0.1.80

package/dist/server/server/agent/agent-storage.d.ts

@@ -0,0 +1,346 @@
+import { z } from "zod";
+import type { Logger } from "pino";
+import type { ManagedAgent } from "./agent-manager.js";
+import type { AgentSessionConfig } from "./agent-sdk-types.js";
+declare const STORED_AGENT_SCHEMA: z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodString;
+    cwd: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    lastActivityAt: z.ZodOptional<z.ZodString>;
+    lastUserMessageAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    labels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    lastStatus: z.ZodDefault<z.ZodEnum<["initializing", "idle", "running", "error", "closed"]>>;
+    lastModeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    config: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        modeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        thinkingOptionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        featureValues: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        extra: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+        systemPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        mcpServers: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    }, "strip", z.ZodTypeAny, {
+        title?: string | null | undefined;
+        modeId?: string | null | undefined;
+        model?: string | null | undefined;
+        thinkingOptionId?: string | null | undefined;
+        extra?: Record<string, any> | null | undefined;
+        systemPrompt?: string | null | undefined;
+        mcpServers?: Record<string, any> | null | undefined;
+        featureValues?: Record<string, unknown> | null | undefined;
+    }, {
+        title?: string | null | undefined;
+        modeId?: string | null | undefined;
+        model?: string | null | undefined;
+        thinkingOptionId?: string | null | undefined;
+        extra?: Record<string, any> | null | undefined;
+        systemPrompt?: string | null | undefined;
+        mcpServers?: Record<string, any> | null | undefined;
+        featureValues?: Record<string, unknown> | null | undefined;
+    }>>>;
+    runtimeInfo: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        sessionId: z.ZodNullable<z.ZodString>;
+        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        thinkingOptionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        modeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        sessionId: string | null;
+        modeId?: string | null | undefined;
+        model?: string | null | undefined;
+        thinkingOptionId?: string | null | undefined;
+        extra?: Record<string, unknown> | undefined;
+    }, {
+        provider: string;
+        sessionId: string | null;
+        modeId?: string | null | undefined;
+        model?: string | null | undefined;
+        thinkingOptionId?: string | null | undefined;
+        extra?: Record<string, unknown> | undefined;
+    }>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"toggle">;
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        tooltip: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        value: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        value: boolean;
+        type: "toggle";
+        id: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        tooltip?: string | undefined;
+    }, {
+        value: boolean;
+        type: "toggle";
+        id: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        tooltip?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        tooltip: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        value: z.ZodNullable<z.ZodString>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            isDefault: z.ZodOptional<z.ZodBoolean>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            label: string;
+            description?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            isDefault?: boolean | undefined;
+        }, {
+            id: string;
+            label: string;
+            description?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            isDefault?: boolean | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        value: string | null;
+        options: {
+            id: string;
+            label: string;
+            description?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            isDefault?: boolean | undefined;
+        }[];
+        type: "select";
+        id: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        tooltip?: string | undefined;
+    }, {
+        value: string | null;
+        options: {
+            id: string;
+            label: string;
+            description?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            isDefault?: boolean | undefined;
+        }[];
+        type: "select";
+        id: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        tooltip?: string | undefined;
+    }>]>, "many">>;
+    persistence: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        sessionId: z.ZodString;
+        nativeHandle: z.ZodOptional<z.ZodAny>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        sessionId: string;
+        metadata?: Record<string, any> | undefined;
+        nativeHandle?: any;
+    }, {
+        provider: string;
+        sessionId: string;
+        metadata?: Record<string, any> | undefined;
+        nativeHandle?: any;
+    }>>>;
+    lastError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    requiresAttention: z.ZodOptional<z.ZodBoolean>;
+    attentionReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<["finished", "error", "permission"]>>>;
+    attentionTimestamp: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    internal: z.ZodOptional<z.ZodBoolean>;
+    archivedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    cwd: string;
+    createdAt: string;
+    id: string;
+    updatedAt: string;
+    provider: string;
+    labels: Record<string, string>;
+    lastStatus: "error" | "initializing" | "idle" | "running" | "closed";
+    title?: string | null | undefined;
+    config?: {
+        title?: string | null | undefined;
+        modeId?: string | null | undefined;
+        model?: string | null | undefined;
+        thinkingOptionId?: string | null | undefined;
+        extra?: Record<string, any> | null | undefined;
+        systemPrompt?: string | null | undefined;
+        mcpServers?: Record<string, any> | null | undefined;
+        featureValues?: Record<string, unknown> | null | undefined;
+    } | null | undefined;
+    internal?: boolean | undefined;
+    features?: ({
+        value: boolean;
+        type: "toggle";
+        id: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        tooltip?: string | undefined;
+    } | {
+        value: string | null;
+        options: {
+            id: string;
+            label: string;
+            description?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            isDefault?: boolean | undefined;
+        }[];
+        type: "select";
+        id: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        tooltip?: string | undefined;
+    })[] | undefined;
+    lastUserMessageAt?: string | null | undefined;
+    persistence?: {
+        provider: string;
+        sessionId: string;
+        metadata?: Record<string, any> | undefined;
+        nativeHandle?: any;
+    } | null | undefined;
+    runtimeInfo?: {
+        provider: string;
+        sessionId: string | null;
+        modeId?: string | null | undefined;
+        model?: string | null | undefined;
+        thinkingOptionId?: string | null | undefined;
+        extra?: Record<string, unknown> | undefined;
+    } | undefined;
+    lastError?: string | null | undefined;
+    requiresAttention?: boolean | undefined;
+    attentionReason?: "finished" | "error" | "permission" | null | undefined;
+    attentionTimestamp?: string | null | undefined;
+    archivedAt?: string | null | undefined;
+    lastActivityAt?: string | undefined;
+    lastModeId?: string | null | undefined;
+}, {
+    cwd: string;
+    createdAt: string;
+    id: string;
+    updatedAt: string;
+    provider: string;
+    title?: string | null | undefined;
+    config?: {
+        title?: string | null | undefined;
+        modeId?: string | null | undefined;
+        model?: string | null | undefined;
+        thinkingOptionId?: string | null | undefined;
+        extra?: Record<string, any> | null | undefined;
+        systemPrompt?: string | null | undefined;
+        mcpServers?: Record<string, any> | null | undefined;
+        featureValues?: Record<string, unknown> | null | undefined;
+    } | null | undefined;
+    internal?: boolean | undefined;
+    features?: ({
+        value: boolean;
+        type: "toggle";
+        id: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        tooltip?: string | undefined;
+    } | {
+        value: string | null;
+        options: {
+            id: string;
+            label: string;
+            description?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            isDefault?: boolean | undefined;
+        }[];
+        type: "select";
+        id: string;
+        label: string;
+        description?: string | undefined;
+        icon?: string | undefined;
+        tooltip?: string | undefined;
+    })[] | undefined;
+    lastUserMessageAt?: string | null | undefined;
+    persistence?: {
+        provider: string;
+        sessionId: string;
+        metadata?: Record<string, any> | undefined;
+        nativeHandle?: any;
+    } | null | undefined;
+    runtimeInfo?: {
+        provider: string;
+        sessionId: string | null;
+        modeId?: string | null | undefined;
+        model?: string | null | undefined;
+        thinkingOptionId?: string | null | undefined;
+        extra?: Record<string, unknown> | undefined;
+    } | undefined;
+    lastError?: string | null | undefined;
+    labels?: Record<string, string> | undefined;
+    requiresAttention?: boolean | undefined;
+    attentionReason?: "finished" | "error" | "permission" | null | undefined;
+    attentionTimestamp?: string | null | undefined;
+    archivedAt?: string | null | undefined;
+    lastActivityAt?: string | undefined;
+    lastStatus?: "error" | "initializing" | "idle" | "running" | "closed" | undefined;
+    lastModeId?: string | null | undefined;
+}>;
+export type SerializableAgentConfig = Pick<AgentSessionConfig, "title" | "modeId" | "model" | "thinkingOptionId" | "featureValues" | "extra" | "systemPrompt" | "mcpServers">;
+export type StoredAgentRecord = z.infer<typeof STORED_AGENT_SCHEMA>;
+export declare function parseStoredAgentRecord(value: unknown): StoredAgentRecord;
+export declare class AgentStorage {
+    private cache;
+    private pathById;
+    private pathsById;
+    private pendingWrites;
+    private deleting;
+    private loaded;
+    private baseDir;
+    private loadPromise;
+    private logger;
+    constructor(baseDir: string, logger: Logger);
+    initialize(): Promise<void>;
+    list(): Promise<StoredAgentRecord[]>;
+    get(agentId: string): Promise<StoredAgentRecord | null>;
+    upsert(record: StoredAgentRecord): Promise<void>;
+    private queueRecordWrite;
+    private writeRecord;
+    beginDelete(agentId: string): void;
+    remove(agentId: string): Promise<void>;
+    applySnapshot(agent: ManagedAgent, workspaceIdOrOptions?: string | {
+        title?: string | null;
+        internal?: boolean;
+    }, options?: {
+        title?: string | null;
+        internal?: boolean;
+    }): Promise<void>;
+    setTitle(agentId: string, title: string): Promise<void>;
+    setGeneratedTitleIfUnset(agentId: string, title: string): Promise<StoredAgentRecord | null>;
+    flush(): Promise<void>;
+    private load;
+    private doLoad;
+    private scanDisk;
+    private readRecordFile;
+    private buildRecordPath;
+    private addIndexedPath;
+    private removeIndexedPath;
+    private waitForPendingWrite;
+}
+export {};
+//# sourceMappingURL=agent-storage.d.ts.map

package/dist/server/server/agent/agent-storage.d.ts.map

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

package/dist/server/server/agent/agent-storage.js

@@ -0,0 +1,340 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { AgentFeatureSchema, AgentStatusSchema } from "../messages.js";
+import { toStoredAgentRecord } from "./agent-projections.js";
+const SERIALIZABLE_CONFIG_SCHEMA = z
+    .object({
+    title: z.string().nullable().optional(),
+    modeId: z.string().nullable().optional(),
+    model: z.string().nullable().optional(),
+    thinkingOptionId: z.string().nullable().optional(),
+    featureValues: z.record(z.unknown()).nullable().optional(),
+    extra: z.record(z.any()).nullable().optional(),
+    systemPrompt: z.string().nullable().optional(),
+    mcpServers: z.record(z.any()).nullable().optional(),
+})
+    .nullable()
+    .optional();
+const PERSISTENCE_HANDLE_SCHEMA = z
+    .object({
+    provider: z.string(),
+    sessionId: z.string(),
+    nativeHandle: z.any().optional(),
+    metadata: z.record(z.any()).optional(),
+})
+    .nullable()
+    .optional();
+const STORED_AGENT_SCHEMA = z.object({
+    id: z.string(),
+    provider: z.string(),
+    cwd: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    lastActivityAt: z.string().optional(),
+    lastUserMessageAt: z.string().nullable().optional(),
+    title: z.string().nullable().optional(),
+    labels: z.record(z.string()).default({}),
+    lastStatus: AgentStatusSchema.default("closed"),
+    lastModeId: z.string().nullable().optional(),
+    config: SERIALIZABLE_CONFIG_SCHEMA,
+    runtimeInfo: z
+        .object({
+        provider: z.string(),
+        sessionId: z.string().nullable(),
+        model: z.string().nullable().optional(),
+        thinkingOptionId: z.string().nullable().optional(),
+        modeId: z.string().nullable().optional(),
+        extra: z.record(z.unknown()).optional(),
+    })
+        .optional(),
+    features: z.array(AgentFeatureSchema).optional(),
+    persistence: PERSISTENCE_HANDLE_SCHEMA,
+    lastError: z.string().nullable().optional(),
+    requiresAttention: z.boolean().optional(),
+    attentionReason: z.enum(["finished", "error", "permission"]).nullable().optional(),
+    attentionTimestamp: z.string().nullable().optional(),
+    internal: z.boolean().optional(),
+    archivedAt: z.string().nullable().optional(),
+});
+export function parseStoredAgentRecord(value) {
+    return STORED_AGENT_SCHEMA.parse(value);
+}
+export class AgentStorage {
+    constructor(baseDir, logger) {
+        this.cache = new Map();
+        this.pathById = new Map();
+        this.pathsById = new Map();
+        this.pendingWrites = new Map();
+        this.deleting = new Set();
+        this.loaded = false;
+        this.loadPromise = null;
+        this.baseDir = baseDir;
+        this.logger = logger.child({ module: "agent", component: "agent-storage" });
+    }
+    async initialize() {
+        await this.load();
+    }
+    async list() {
+        await this.load();
+        return Array.from(this.cache.values());
+    }
+    async get(agentId) {
+        await this.load();
+        return this.cache.get(agentId) ?? null;
+    }
+    async upsert(record) {
+        await this.load();
+        await this.queueRecordWrite(record);
+    }
+    queueRecordWrite(record) {
+        const agentId = record.id;
+        const prev = this.pendingWrites.get(agentId) ?? Promise.resolve();
+        const next = prev.then(async () => {
+            if (this.deleting.has(agentId)) {
+                return undefined;
+            }
+            await this.writeRecord(record);
+            return undefined;
+        });
+        const tracked = next.finally(() => {
+            if (this.pendingWrites.get(agentId) === tracked) {
+                this.pendingWrites.delete(agentId);
+            }
+        });
+        this.pendingWrites.set(agentId, tracked);
+        return tracked;
+    }
+    async writeRecord(record) {
+        const agentId = record.id;
+        const nextPath = this.buildRecordPath(record);
+        const previousPath = this.pathById.get(agentId);
+        await fs.mkdir(path.dirname(nextPath), { recursive: true });
+        await writeFileAtomically(nextPath, JSON.stringify(record, null, 2));
+        this.addIndexedPath(agentId, nextPath);
+        if (previousPath && previousPath !== nextPath) {
+            try {
+                await fs.unlink(previousPath);
+            }
+            catch {
+                // ignore cleanup errors
+            }
+            this.removeIndexedPath(agentId, previousPath);
+        }
+        this.cache.set(agentId, record);
+        this.pathById.set(agentId, nextPath);
+    }
+    beginDelete(agentId) {
+        this.deleting.add(agentId);
+    }
+    async remove(agentId) {
+        await this.load();
+        this.beginDelete(agentId);
+        await (this.pendingWrites.get(agentId) ?? Promise.resolve());
+        const paths = Array.from(this.pathsById.get(agentId) ?? []);
+        await Promise.all(paths.map(async (filePath) => {
+            try {
+                await fs.unlink(filePath);
+            }
+            catch (error) {
+                const code = error.code;
+                if (code && code !== "ENOENT") {
+                    this.logger.warn({ err: error, agentId, filePath }, "Failed to remove agent record file");
+                }
+            }
+        }));
+        this.cache.delete(agentId);
+        this.pathById.delete(agentId);
+        this.pathsById.delete(agentId);
+    }
+    async applySnapshot(agent, workspaceIdOrOptions, options) {
+        const nextOptions = typeof workspaceIdOrOptions === "string" ? options : workspaceIdOrOptions;
+        await this.load();
+        await this.waitForPendingWrite(agent.id);
+        const existing = (await this.get(agent.id)) ?? null;
+        const hasTitleOverride = nextOptions !== undefined && Object.prototype.hasOwnProperty.call(nextOptions, "title");
+        const hasInternalOverride = nextOptions !== undefined && Object.prototype.hasOwnProperty.call(nextOptions, "internal");
+        const record = toStoredAgentRecord(agent, {
+            title: hasTitleOverride ? (nextOptions?.title ?? null) : (existing?.title ?? null),
+            createdAt: existing?.createdAt,
+            internal: hasInternalOverride
+                ? nextOptions?.internal
+                : (agent.internal ?? existing?.internal),
+        });
+        // Preserve soft-delete/archive status across snapshot flushes.
+        // `archivedAt` is not part of the ManagedAgent snapshot, so a naive projection
+        // would wipe it during normal persistence (including on daemon restart).
+        if (existing && existing.archivedAt !== undefined) {
+            record.archivedAt = existing.archivedAt;
+        }
+        await this.upsert(record);
+    }
+    async setTitle(agentId, title) {
+        await this.load();
+        await this.waitForPendingWrite(agentId);
+        const record = await this.get(agentId);
+        if (!record) {
+            throw new Error(`Agent ${agentId} not found`);
+        }
+        await this.upsert({ ...record, title });
+    }
+    async setGeneratedTitleIfUnset(agentId, title) {
+        await this.load();
+        await this.waitForPendingWrite(agentId);
+        const record = this.cache.get(agentId) ?? null;
+        if (!record) {
+            throw new Error(`Agent ${agentId} not found`);
+        }
+        if (record.title) {
+            return null;
+        }
+        // Re-drain pending writes: a concurrent setTitle may have queued between the
+        // first drain and here. After waiting, re-read the cache before writing.
+        await this.waitForPendingWrite(agentId);
+        const latestRecord = this.cache.get(agentId) ?? null;
+        if (!latestRecord) {
+            throw new Error(`Agent ${agentId} not found`);
+        }
+        if (latestRecord.title) {
+            return null;
+        }
+        const nextRecord = {
+            ...latestRecord,
+            title,
+            updatedAt: new Date().toISOString(),
+        };
+        await this.queueRecordWrite(nextRecord);
+        return nextRecord;
+    }
+    async flush() {
+        await this.load().catch(() => undefined);
+        const writes = Array.from(this.pendingWrites.values());
+        await Promise.allSettled(writes);
+    }
+    async load() {
+        if (this.loaded) {
+            return Array.from(this.cache.values());
+        }
+        if (!this.loadPromise) {
+            this.loadPromise = this.doLoad();
+        }
+        return this.loadPromise;
+    }
+    async doLoad() {
+        this.cache.clear();
+        this.pathById.clear();
+        this.pathsById.clear();
+        try {
+            const records = await this.scanDisk();
+            this.loaded = true;
+            return records;
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                this.loaded = true;
+                return [];
+            }
+            this.logger.error({ err: error }, "Failed to load agents");
+            this.loaded = true;
+            return [];
+        }
+    }
+    async scanDisk() {
+        const records = [];
+        let entries = [];
+        try {
+            entries = await fs.readdir(this.baseDir, { withFileTypes: true });
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return [];
+            }
+            throw error;
+        }
+        const rootRecordPaths = entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+            .map((entry) => path.join(this.baseDir, entry.name));
+        const projectDirs = entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => path.join(this.baseDir, entry.name));
+        const projectFileLists = await Promise.all(projectDirs.map(async (projectDir) => {
+            try {
+                const files = await fs.readdir(projectDir, { withFileTypes: true });
+                return files
+                    .filter((file) => file.isFile() && file.name.endsWith(".json"))
+                    .map((file) => path.join(projectDir, file.name));
+            }
+            catch {
+                return [];
+            }
+        }));
+        const allFilePaths = [...rootRecordPaths, ...projectFileLists.flat()];
+        const loaded = await Promise.all(allFilePaths.map(async (filePath) => {
+            const record = await this.readRecordFile(filePath);
+            return record ? { record, filePath } : null;
+        }));
+        for (const item of loaded) {
+            if (!item)
+                continue;
+            const { record, filePath } = item;
+            records.push(record);
+            this.cache.set(record.id, record);
+            this.pathById.set(record.id, filePath);
+            this.addIndexedPath(record.id, filePath);
+        }
+        return records;
+    }
+    async readRecordFile(filePath) {
+        try {
+            const content = await fs.readFile(filePath, "utf8");
+            const parsed = JSON.parse(content);
+            return parseStoredAgentRecord(parsed);
+        }
+        catch (error) {
+            this.logger.error({ err: error, filePath }, "Skipping invalid agent record");
+            return null;
+        }
+    }
+    buildRecordPath(record) {
+        const projectDir = projectDirNameFromCwd(record.cwd);
+        return path.join(this.baseDir, projectDir, `${record.id}.json`);
+    }
+    addIndexedPath(agentId, filePath) {
+        const paths = this.pathsById.get(agentId) ?? new Set();
+        paths.add(filePath);
+        this.pathsById.set(agentId, paths);
+    }
+    removeIndexedPath(agentId, filePath) {
+        const paths = this.pathsById.get(agentId);
+        if (!paths) {
+            return;
+        }
+        paths.delete(filePath);
+        if (paths.size === 0) {
+            this.pathsById.delete(agentId);
+        }
+    }
+    async waitForPendingWrite(agentId) {
+        await (this.pendingWrites.get(agentId) ?? Promise.resolve()).catch(() => undefined);
+    }
+}
+function projectDirNameFromCwd(cwd) {
+    // path.win32.parse handles drive letters, UNC roots, and Unix roots on all platforms
+    const { root } = path.win32.parse(cwd);
+    const withoutRoot = cwd.slice(root.length).replace(/[\\/]+$/, "");
+    // Sanitize root: strip colons and separators, keep letters (e.g. "C:\" → "C", "\\server\share\" → "server-share")
+    const sanitizedRoot = root.replace(/[:\\/]+/g, "-").replace(/^-+|-+$/g, "");
+    const prefix = sanitizedRoot ? sanitizedRoot + "-" : "";
+    if (!withoutRoot) {
+        return sanitizedRoot || "root";
+    }
+    return prefix + withoutRoot.replace(/[\\/]+/g, "-");
+}
+async function writeFileAtomically(targetPath, payload) {
+    const directory = path.dirname(targetPath);
+    const tempPath = path.join(directory, `.agent.tmp-${process.pid}-${Date.now()}-${randomUUID()}`);
+    await fs.writeFile(tempPath, payload, "utf8");
+    await fs.rename(tempPath, targetPath);
+}
+//# sourceMappingURL=agent-storage.js.map