@nervekit/orchestrator 0.1.0

package/dist/domains/providers/provider-catalog.store.js

@@ -0,0 +1,109 @@
+import { defaultProviderCatalog, providerCatalogSchema, } from "@nervekit/shared";
+import { atomicWriteJson, pathExists, readJsonFile, } from "../../infrastructure/storage/json.js";
+/**
+ * File-first store for user-defined providers and models, persisted to
+ * `~/.nerve/providers.json`. Non-sensitive metadata only — API keys live in the
+ * encrypted secret store via `AuthManager`.
+ */
+export class ProviderCatalogStore {
+    path;
+    #catalog = defaultProviderCatalog;
+    #loaded = false;
+    constructor(path) {
+        this.path = path;
+    }
+    async load() {
+        if (await pathExists(this.path)) {
+            const raw = await readJsonFile(this.path).catch(() => undefined);
+            const parsed = providerCatalogSchema.safeParse(raw ?? {});
+            this.#catalog = parsed.success ? parsed.data : defaultProviderCatalog;
+        }
+        else {
+            this.#catalog = defaultProviderCatalog;
+        }
+        this.#loaded = true;
+        return this.#catalog;
+    }
+    async ensureLoaded() {
+        if (!this.#loaded)
+            await this.load();
+    }
+    get catalog() {
+        return this.#catalog;
+    }
+    async write(next) {
+        const validated = providerCatalogSchema.parse(next);
+        await atomicWriteJson(this.path, validated, 0o600);
+        this.#catalog = validated;
+        return validated;
+    }
+    async upsertProvider(provider) {
+        await this.ensureLoaded();
+        const providers = this.#catalog.providers.filter((existing) => existing.id !== provider.id);
+        providers.push(provider);
+        return this.write({ ...this.#catalog, providers });
+    }
+    async deleteProvider(id) {
+        await this.ensureLoaded();
+        return this.write({
+            ...this.#catalog,
+            providers: this.#catalog.providers.filter((provider) => provider.id !== id),
+            // Cascade: drop models that belonged to the removed provider.
+            models: this.#catalog.models.filter((model) => model.provider !== id),
+        });
+    }
+    async upsertModel(model) {
+        await this.ensureLoaded();
+        const models = this.#catalog.models.filter((existing) => !(existing.provider === model.provider &&
+            existing.modelId === model.modelId));
+        models.push(model);
+        return this.write({ ...this.#catalog, models });
+    }
+    async deleteModel(provider, modelId) {
+        await this.ensureLoaded();
+        return this.write({
+            ...this.#catalog,
+            models: this.#catalog.models.filter((model) => !(model.provider === provider && model.modelId === modelId)),
+        });
+    }
+    /** Display names keyed by custom provider id (for auth metadata). */
+    providerDisplayNames() {
+        return new Map(this.#catalog.providers.map((provider) => [
+            provider.id,
+            provider.displayName,
+        ]));
+    }
+    /**
+     * Flatten the catalog into runtime-ready model definitions, inheriting
+     * connection settings (api/baseUrl/headers/compat) from a model's custom
+     * provider when present. Built-in provider models may omit connection settings;
+     * the agent runtime resolves those from pi-ai's provider catalog.
+     */
+    resolvedModels() {
+        const providerById = new Map(this.#catalog.providers.map((provider) => [provider.id, provider]));
+        const resolved = [];
+        for (const model of this.#catalog.models) {
+            const provider = providerById.get(model.provider);
+            const api = model.api ?? provider?.api;
+            const baseUrl = model.baseUrl ?? provider?.baseUrl;
+            resolved.push({
+                provider: model.provider,
+                modelId: model.modelId,
+                name: model.name,
+                ...(api ? { api } : {}),
+                ...(baseUrl ? { baseUrl } : {}),
+                reasoning: model.reasoning,
+                supportedThinkingLevels: model.supportedThinkingLevels,
+                thinkingLevelMap: model.thinkingLevelMap,
+                input: model.input,
+                cost: model.cost,
+                contextWindow: model.contextWindow,
+                maxTokens: model.maxTokens,
+                headers: { ...(provider?.headers ?? {}), ...(model.headers ?? {}) },
+                compat: model.compat ?? provider?.compat,
+            });
+        }
+        return resolved;
+    }
+}
+//# sourceMappingURL=provider-catalog.store.js.map

package/dist/domains/providers/provider-catalog.store.js.map

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

package/dist/domains/runtime/python-runtime-service.d.ts

@@ -0,0 +1,15 @@
+import type { PythonRuntimeStatus as SharedPythonRuntimeStatus } from "@nervekit/shared";
+import { type PythonRuntime, type PythonRuntimeStatus } from "@nervekit/tools";
+import type { InitializedStorage } from "../../infrastructure/storage/index.js";
+export declare class PythonRuntimeService {
+    private readonly storage;
+    private readonly cache;
+    private lastStatus;
+    constructor(storage: InitializedStorage);
+    refresh(projectDir?: string): Promise<SharedPythonRuntimeStatus>;
+    statusSnapshot(): SharedPythonRuntimeStatus;
+    isAvailableForProject(projectDir: string): Promise<boolean>;
+    runtimeForProject(projectDir: string): Promise<PythonRuntime | undefined>;
+    statusForProject(projectDir: string): Promise<PythonRuntimeStatus>;
+}
+//# sourceMappingURL=python-runtime-service.d.ts.map

package/dist/domains/runtime/python-runtime-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-runtime-service.d.ts","sourceRoot":"","sources":["../../../src/domains/runtime/python-runtime-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAEzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmD;IACzE,OAAO,CAAC,UAAU,CAIhB;gBAE2B,OAAO,EAAE,kBAAkB;IAElD,OAAO,CACX,UAAU,SAAgB,GACzB,OAAO,CAAC,yBAAyB,CAAC;IAOrC,cAAc,IAAI,yBAAyB;IAIrC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,iBAAiB,CACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAY/B,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAYzE"}

package/dist/domains/runtime/python-runtime-service.js

@@ -0,0 +1,65 @@
+import { resolvePythonRuntime, } from "@nervekit/tools";
+export class PythonRuntimeService {
+    storage;
+    cache = new Map();
+    lastStatus = {
+        available: false,
+        source: "unavailable",
+        error: "Python runtime has not been resolved yet.",
+    };
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async refresh(projectDir = process.cwd()) {
+        this.cache.clear();
+        const status = await this.statusForProject(projectDir);
+        this.lastStatus = toSharedStatus(status);
+        return this.lastStatus;
+    }
+    statusSnapshot() {
+        return this.lastStatus;
+    }
+    async isAvailableForProject(projectDir) {
+        return (await this.statusForProject(projectDir)).available;
+    }
+    async runtimeForProject(projectDir) {
+        const status = await this.statusForProject(projectDir);
+        if (!status.available)
+            return undefined;
+        return {
+            command: status.command,
+            args: status.args,
+            displayPath: status.displayPath,
+            version: status.version,
+            source: status.source,
+        };
+    }
+    async statusForProject(projectDir) {
+        const manualPath = this.storage.settings.runtime.pythonExecutablePath;
+        const key = `${manualPath ?? "auto"}\0${projectDir}`;
+        let pending = this.cache.get(key);
+        if (!pending) {
+            pending = resolvePythonRuntime({ cwd: projectDir, manualPath });
+            this.cache.set(key, pending);
+        }
+        const status = await pending;
+        this.lastStatus = toSharedStatus(status);
+        return status;
+    }
+}
+function toSharedStatus(status) {
+    if (!status.available) {
+        return {
+            available: false,
+            source: "unavailable",
+            error: status.error,
+        };
+    }
+    return {
+        available: true,
+        source: status.source,
+        executable: status.displayPath,
+        version: status.version,
+    };
+}
+//# sourceMappingURL=python-runtime-service.js.map

package/dist/domains/runtime/python-runtime-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-runtime-service.js","sourceRoot":"","sources":["../../../src/domains/runtime/python-runtime-service.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,OAAO,oBAAoB;IAQF;IAPZ,KAAK,GAAG,IAAI,GAAG,EAAwC,CAAC;IACjE,UAAU,GAA8B;QAC9C,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,2CAA2C;KACnD,CAAC;IAEF,YAA6B,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAE5D,KAAK,CAAC,OAAO,CACX,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAE1B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,UAAkB;QAC5C,OAAO,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,UAAkB;QAElB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC;QACtE,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QACrD,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,oBAAoB,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,SAAS,cAAc,CACrB,MAA2B;IAE3B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,WAAW;QAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC"}

package/dist/domains/storage/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./storage-usage.service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domains/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domains/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/domains/storage/index.js

@@ -0,0 +1,2 @@
+export * from "./storage-usage.service.js";
+//# sourceMappingURL=index.js.map

package/dist/domains/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domains/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/domains/storage/storage-usage.service.d.ts

@@ -0,0 +1,39 @@
+import type { StorageCleanupRequest, StorageCleanupResponse, StorageUsageResponse } from "@nervekit/shared";
+import type { IndexStore } from "../../infrastructure/index-store/index.js";
+import type { StoragePaths } from "../../infrastructure/storage/index.js";
+/** Minimal registry surface needed for usage/cleanup (avoids an import cycle). */
+export interface StorageRegistryPort {
+    pruneConversationsAcrossProjects(request: {
+        strategy: "olderThanDays";
+        olderThanDays: number;
+    }): Promise<{
+        prunedConversationIds: string[];
+        skippedCount: number;
+    }>;
+    listConversations(): Array<{
+        id: string;
+        title: string | null;
+    }>;
+    tools: {
+        compactToolCallLog(): Promise<void>;
+        toolCallLogPath(): string;
+    };
+}
+export interface StorageUsageServiceDeps {
+    paths: StoragePaths;
+    index: IndexStore;
+    getRegistry: () => StorageRegistryPort;
+}
+export declare class StorageUsageService {
+    #private;
+    private readonly deps;
+    constructor(deps: StorageUsageServiceDeps);
+    computeUsage(force?: boolean): Promise<StorageUsageResponse>;
+    cleanup(request: StorageCleanupRequest): Promise<StorageCleanupResponse>;
+    private runTarget;
+    private conversationUsage;
+    private pruneDatedLogs;
+    private removeFile;
+    private clearDirContents;
+}
+//# sourceMappingURL=storage-usage.service.d.ts.map

package/dist/domains/storage/storage-usage.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-usage.service.d.ts","sourceRoot":"","sources":["../../../src/domains/storage/storage-usage.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,qBAAqB,EACrB,sBAAsB,EAEtB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,gCAAgC,CAAC,OAAO,EAAE;QACxC,QAAQ,EAAE,eAAe,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC;QAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,iBAAiB,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACjE,KAAK,EAAE;QACL,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,eAAe,IAAI,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,mBAAmB,CAAC;CACxC;AA4HD,qBAAa,mBAAmB;;IAGlB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,uBAAuB;IAEpD,YAAY,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoE1D,OAAO,CACX,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;YA2GpB,SAAS;YAiBT,iBAAiB;YA4BjB,cAAc;YAuBd,UAAU;YASV,gBAAgB;CAmB/B"}

package/dist/domains/storage/storage-usage.service.js

@@ -0,0 +1,394 @@
+import { mkdir, readdir, rm, stat, unlink } from "node:fs/promises";
+import { join } from "node:path";
+// Display order + metadata for known categories.
+const CATEGORY_META = {
+    conversations: {
+        label: "Conversations",
+        description: "Message history, harness state, and entries per conversation.",
+        cleanable: true,
+        protected: false,
+    },
+    logs: {
+        label: "Logs & events",
+        description: "Application logs, the global event log, and tool-call history.",
+        cleanable: true,
+        protected: false,
+    },
+    sqliteIndex: {
+        label: "Search index (SQLite)",
+        description: "Rebuildable query cache. Vacuum to reclaim freed pages.",
+        cleanable: true,
+        protected: false,
+    },
+    exploreReports: {
+        label: "Explore reports",
+        description: "Saved output from codebase explore sub-agents.",
+        cleanable: true,
+        protected: false,
+    },
+    plans: {
+        label: "Plans",
+        description: "Saved plan documents.",
+        cleanable: false,
+        protected: false,
+    },
+    agents: {
+        label: "Agents",
+        description: "Per-agent runtime state.",
+        cleanable: false,
+        protected: false,
+    },
+    tasks: {
+        label: "Tasks",
+        description: "Background task state and logs.",
+        cleanable: false,
+        protected: false,
+    },
+    workflowState: {
+        label: "Workflow state",
+        description: "Suspensions, approvals, user questions, and handovers.",
+        cleanable: false,
+        protected: false,
+    },
+    projects: {
+        label: "Projects",
+        description: "Project metadata.",
+        cleanable: false,
+        protected: false,
+    },
+    workers: {
+        label: "Workers",
+        description: "Worker registrations.",
+        cleanable: false,
+        protected: false,
+    },
+    cache: {
+        label: "Cache",
+        description: "Disposable cached data (e.g. usage snapshots).",
+        cleanable: true,
+        protected: false,
+    },
+    tmp: {
+        label: "Temporary files",
+        description: "Scratch files that can be safely removed.",
+        cleanable: true,
+        protected: false,
+    },
+    protected: {
+        label: "Credentials & config",
+        description: "Auth tokens, keys, TLS, and configuration. Never deleted.",
+        cleanable: false,
+        protected: true,
+    },
+    other: {
+        label: "Other",
+        description: "Uncategorized data under the Nerve home directory.",
+        cleanable: false,
+        protected: false,
+    },
+};
+const CATEGORY_ORDER = [
+    "conversations",
+    "logs",
+    "sqliteIndex",
+    "exploreReports",
+    "cache",
+    "tmp",
+    "plans",
+    "agents",
+    "tasks",
+    "workflowState",
+    "projects",
+    "workers",
+    "other",
+    "protected",
+];
+const USAGE_CACHE_TTL_MS = 15_000;
+const LARGEST_CONVERSATION_LIMIT = 5;
+export class StorageUsageService {
+    deps;
+    #cache;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async computeUsage(force = false) {
+        if (!force &&
+            this.#cache &&
+            Date.now() - this.#cache.at < USAGE_CACHE_TTL_MS) {
+            return this.#cache.value;
+        }
+        const home = this.deps.paths.home;
+        const totals = new Map();
+        const add = (key, tally) => {
+            const current = totals.get(key) ?? { bytes: 0, files: 0 };
+            current.bytes += tally.bytes;
+            current.files += tally.files;
+            totals.set(key, current);
+        };
+        const entries = await readdir(home, { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            if (entry.isSymbolicLink())
+                continue;
+            const key = categoryForEntry(entry.name);
+            const path = join(home, entry.name);
+            const tally = entry.isDirectory()
+                ? await dirSize(path)
+                : { bytes: await fileSize(path), files: 1 };
+            add(key, tally);
+        }
+        const categories = [];
+        let totalBytes = 0;
+        for (const key of CATEGORY_ORDER) {
+            const tally = totals.get(key);
+            if (!tally || tally.bytes === 0)
+                continue;
+            const meta = CATEGORY_META[key];
+            categories.push({
+                key,
+                label: meta.label,
+                description: meta.description,
+                bytes: tally.bytes,
+                fileCount: tally.files,
+                cleanable: meta.cleanable,
+                protected: meta.protected,
+            });
+            totalBytes += tally.bytes;
+        }
+        const sqlite = {
+            dbBytes: await fileSize(this.deps.paths.sqlitePath),
+            walBytes: await fileSize(`${this.deps.paths.sqlitePath}-wal`),
+            shmBytes: await fileSize(`${this.deps.paths.sqlitePath}-shm`),
+        };
+        const conversations = await this.conversationUsage();
+        const value = {
+            dataDir: home,
+            generatedAt: new Date().toISOString(),
+            totalBytes,
+            categories,
+            sqlite,
+            conversations,
+        };
+        this.#cache = { at: Date.now(), value };
+        return value;
+    }
+    async cleanup(request) {
+        const results = [];
+        if (request.conversationsOlderThanDays !== undefined) {
+            results.push(await this.runTarget("conversations", async () => {
+                const dir = join(this.deps.paths.home, "conversations");
+                const before = (await dirSize(dir)).bytes;
+                const pruned = await this.deps
+                    .getRegistry()
+                    .pruneConversationsAcrossProjects({
+                    strategy: "olderThanDays",
+                    olderThanDays: request.conversationsOlderThanDays,
+                });
+                const after = (await dirSize(dir)).bytes;
+                return {
+                    freedBytes: Math.max(0, before - after),
+                    removedItems: pruned.prunedConversationIds.length,
+                    skipped: pruned.skippedCount,
+                };
+            }));
+        }
+        if (request.logsOlderThanDays !== undefined) {
+            results.push(await this.runTarget("logs", () => this.pruneDatedLogs(request.logsOlderThanDays)));
+        }
+        if (request.truncateEventLog) {
+            results.push(await this.runTarget("rotatedEventLog", () => this.removeFile(join(this.deps.paths.home, "logs", "events.jsonl.1"))));
+        }
+        if (request.clearToolCallLog) {
+            results.push(await this.runTarget("toolCallLog", async () => {
+                const path = this.deps.getRegistry().tools.toolCallLogPath();
+                const before = await fileSize(path);
+                await this.deps.getRegistry().tools.compactToolCallLog();
+                const after = await fileSize(path);
+                return {
+                    freedBytes: Math.max(0, before - after),
+                    removedItems: 0,
+                    skipped: 0,
+                    note: "Compacted superseded tool-call rows.",
+                };
+            }));
+        }
+        if (request.clearExploreReports) {
+            results.push(await this.runTarget("exploreReports", () => this.clearDirContents(join(this.deps.paths.home, "explore-reports"))));
+        }
+        if (request.clearCache) {
+            results.push(await this.runTarget("cache", () => this.clearDirContents(join(this.deps.paths.home, "cache"))));
+        }
+        if (request.clearTmp) {
+            results.push(await this.runTarget("tmp", () => this.clearDirContents(join(this.deps.paths.home, "tmp"))));
+        }
+        if (request.vacuumSqlite) {
+            results.push(await this.runTarget("sqliteVacuum", async () => {
+                const before = (await fileSize(this.deps.paths.sqlitePath)) +
+                    (await fileSize(`${this.deps.paths.sqlitePath}-wal`));
+                const ok = this.deps.index.vacuum();
+                const after = (await fileSize(this.deps.paths.sqlitePath)) +
+                    (await fileSize(`${this.deps.paths.sqlitePath}-wal`));
+                return {
+                    freedBytes: Math.max(0, before - after),
+                    removedItems: 0,
+                    skipped: ok ? 0 : 1,
+                    note: ok ? undefined : "VACUUM failed (likely insufficient disk).",
+                };
+            }));
+        }
+        this.#cache = undefined;
+        const usage = await this.computeUsage(true);
+        const freedBytes = results.reduce((sum, r) => sum + r.freedBytes, 0);
+        return { freedBytes, results, usage };
+    }
+    async runTarget(target, run) {
+        try {
+            return { target, ...(await run()) };
+        }
+        catch (error) {
+            return {
+                target,
+                freedBytes: 0,
+                removedItems: 0,
+                skipped: 1,
+                note: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async conversationUsage() {
+        const dir = join(this.deps.paths.home, "conversations");
+        const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+        const sized = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const bytes = (await dirSize(join(dir, entry.name))).bytes;
+            sized.push({ id: entry.name, bytes });
+        }
+        sized.sort((a, b) => b.bytes - a.bytes);
+        const titleById = new Map(this.deps
+            .getRegistry()
+            .listConversations()
+            .map((c) => [c.id, c.title]));
+        const largest = sized
+            .slice(0, LARGEST_CONVERSATION_LIMIT)
+            .map((item) => ({
+            conversationId: item.id,
+            title: titleById.get(item.id) ?? null,
+            bytes: item.bytes,
+        }));
+        return { total: sized.length, largest };
+    }
+    async pruneDatedLogs(olderThanDays) {
+        const logsDir = join(this.deps.paths.home, "logs");
+        const cutoff = new Date(Date.now() - olderThanDays * 86_400_000)
+            .toISOString()
+            .slice(0, 10);
+        const datedLog = /^(application|desktop)-(\d{4}-\d{2}-\d{2})\.jsonl$/;
+        const files = await readdir(logsDir).catch(() => []);
+        let freedBytes = 0;
+        let removedItems = 0;
+        for (const file of files) {
+            const match = datedLog.exec(file);
+            if (!match)
+                continue;
+            if (match[2] >= cutoff)
+                continue; // keep recent + today's files
+            const path = join(logsDir, file);
+            freedBytes += await fileSize(path);
+            await unlink(path).catch(() => undefined);
+            removedItems += 1;
+        }
+        return { freedBytes, removedItems, skipped: 0 };
+    }
+    async removeFile(path) {
+        const bytes = await fileSize(path);
+        if (bytes === 0)
+            return { freedBytes: 0, removedItems: 0, skipped: 0 };
+        await unlink(path).catch(() => undefined);
+        return { freedBytes: bytes, removedItems: 1, skipped: 0 };
+    }
+    async clearDirContents(path) {
+        const entries = await readdir(path, { withFileTypes: true }).catch(() => []);
+        let freedBytes = 0;
+        let removedItems = 0;
+        for (const entry of entries) {
+            const child = join(path, entry.name);
+            freedBytes += entry.isDirectory()
+                ? (await dirSize(child)).bytes
+                : await fileSize(child);
+            await rm(child, { recursive: true, force: true }).catch(() => undefined);
+            removedItems += 1;
+        }
+        await mkdir(path, { recursive: true }).catch(() => undefined);
+        return { freedBytes, removedItems, skipped: 0 };
+    }
+}
+function categoryForEntry(name) {
+    switch (name) {
+        case "conversations":
+            return "conversations";
+        case "logs":
+            return "logs";
+        case "state.sqlite":
+        case "state.sqlite-wal":
+        case "state.sqlite-shm":
+            return "sqliteIndex";
+        case "explore-reports":
+            return "exploreReports";
+        case "plans":
+            return "plans";
+        case "agents":
+            return "agents";
+        case "tasks":
+            return "tasks";
+        case "suspensions":
+        case "approvals":
+        case "user-questions":
+        case "handover":
+        case "handovers":
+            return "workflowState";
+        case "projects":
+            return "projects";
+        case "workers":
+            return "workers";
+        case "cache":
+            return "cache";
+        case "tmp":
+            return "tmp";
+        case "auth":
+        case "keys":
+        case "tls":
+        case "config.json":
+        case "providers.json":
+        case "daemon.json":
+            return "protected";
+        default:
+            return "other";
+    }
+}
+async function dirSize(path) {
+    let bytes = 0;
+    let files = 0;
+    const entries = await readdir(path, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        if (entry.isSymbolicLink())
+            continue;
+        const child = join(path, entry.name);
+        if (entry.isDirectory()) {
+            const nested = await dirSize(child);
+            bytes += nested.bytes;
+            files += nested.files;
+        }
+        else if (entry.isFile()) {
+            bytes += await fileSize(child);
+            files += 1;
+        }
+    }
+    return { bytes, files };
+}
+async function fileSize(path) {
+    return stat(path)
+        .then((info) => info.size)
+        .catch(() => 0);
+}
+//# sourceMappingURL=storage-usage.service.js.map