p-spore 0.1.4 → 0.1.43

package/dist/sessions/session-catalog.js

@@ -0,0 +1,270 @@
+import { readFile, readdir, realpath, rm, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { atomicWriteJson } from "../storage/atomic.js";
+import { resolveSessionFile } from "./session-file.js";
+export class SessionCatalog {
+    #path;
+    #sessionsRoot;
+    #workspaceId;
+    #cwd;
+    #clock;
+    #records = new Map();
+    #tail = Promise.resolve();
+    constructor(options, sessionsRoot, cwd) {
+        this.#path = options.path;
+        this.#sessionsRoot = sessionsRoot;
+        this.#workspaceId = options.workspaceId;
+        this.#cwd = cwd;
+        this.#clock = options.clock ?? (() => new Date());
+    }
+    static async open(options) {
+        const catalog = new SessionCatalog(options, await realpath(options.sessionsRoot), await realpath(options.cwd));
+        await catalog.#initialize();
+        return catalog;
+    }
+    list() {
+        return [...this.#records.values()]
+            .sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.id.localeCompare(right.id))
+            .map((record) => structuredClone(record));
+    }
+    get(id) {
+        const record = this.#records.get(id);
+        return record ? structuredClone(record) : undefined;
+    }
+    async idle() {
+        await this.#tail;
+    }
+    async add(input) {
+        const id = sessionId(input.id, "session.id");
+        const sessionFile = await this.#sessionFile(input.sessionFile);
+        const cwd = await realpath(input.cwd);
+        const now = this.#clock().toISOString();
+        const suppliedTitle = input.title?.trim();
+        const record = {
+            id,
+            sessionFile,
+            cwd,
+            title: suppliedTitle ? boundedTitle(suppliedTitle) : defaultTitle(id),
+            titleSource: suppliedTitle ? "user" : "default",
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.#mutate((next) => {
+            if (next.has(id))
+                throw new Error(`Root session already exists: ${id}`);
+            next.set(id, record);
+        });
+        return structuredClone(record);
+    }
+    /**
+     * Forgets a root session and deletes the transcript it owns.
+     *
+     * The stored path is re-resolved against the sessions root before anything is
+     * unlinked, so a catalog entry that points outside the root loses its record
+     * without the filesystem being touched. Deleting is the point of the command,
+     * so a transcript that is already gone is not an error.
+     */
+    async remove(id) {
+        const existing = this.#records.get(id);
+        if (!existing)
+            return undefined;
+        const record = structuredClone(existing);
+        await this.#mutate((records) => {
+            records.delete(id);
+        });
+        let transcriptRemoved = false;
+        try {
+            const path = await this.#sessionFile(record.sessionFile);
+            await rm(path, { force: true });
+            transcriptRemoved = true;
+        }
+        catch {
+            // The record is gone either way; an unreachable or out-of-root transcript
+            // is left on disk rather than resolved through an unchecked path.
+        }
+        return { record, transcriptRemoved };
+    }
+    async touch(id, options = {}) {
+        const existing = this.#records.get(id);
+        if (!existing)
+            return undefined;
+        const nextSessionFile = options.sessionFile === undefined ? undefined : await this.#sessionFile(options.sessionFile);
+        let updated;
+        await this.#mutate((records) => {
+            const current = records.get(id);
+            if (!current)
+                return;
+            const promptTitle = current.titleSource === "default" && options.prompt
+                ? titleFromPrompt(options.prompt)
+                : undefined;
+            updated = {
+                ...current,
+                sessionFile: nextSessionFile ?? current.sessionFile,
+                updatedAt: this.#clock().toISOString(),
+                ...(promptTitle ? { title: promptTitle, titleSource: "prompt" } : {}),
+            };
+            records.set(id, updated);
+        });
+        return updated ? structuredClone(updated) : undefined;
+    }
+    async #initialize() {
+        let value;
+        try {
+            value = JSON.parse(await readFile(this.#path, "utf8"));
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "ENOENT")
+                throw error;
+            const legacy = await this.#discoverLegacy();
+            if (legacy)
+                this.#records.set(legacy.id, legacy);
+            await this.#write(this.#records);
+            return;
+        }
+        const parsed = parseCatalog(value);
+        const records = new Map();
+        for (const record of parsed.sessions) {
+            const sessionFile = await this.#sessionFile(record.sessionFile);
+            const cwd = await realpath(record.cwd);
+            if (records.has(record.id))
+                throw new Error(`Session catalog contains duplicate id: ${record.id}`);
+            records.set(record.id, { ...record, sessionFile, cwd });
+        }
+        this.#records = records;
+    }
+    async #discoverLegacy() {
+        const directory = join(this.#sessionsRoot, this.#workspaceId);
+        let entries;
+        try {
+            entries = await readdir(directory, { withFileTypes: true });
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                return undefined;
+            throw error;
+        }
+        const candidates = await Promise.all(entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl"))
+            .map(async (entry) => {
+            const path = await this.#sessionFile(join(directory, entry.name));
+            return { path, stats: await stat(path) };
+        }));
+        candidates.sort((left, right) => right.stats.mtimeMs - left.stats.mtimeMs || left.path.localeCompare(right.path));
+        const latest = candidates[0];
+        if (!latest)
+            return undefined;
+        const created = latest.stats.birthtimeMs > 0 ? latest.stats.birthtime : latest.stats.mtime;
+        return {
+            id: "main",
+            sessionFile: latest.path,
+            cwd: this.#cwd,
+            title: defaultTitle("main"),
+            titleSource: "default",
+            createdAt: created.toISOString(),
+            updatedAt: latest.stats.mtime.toISOString(),
+        };
+    }
+    async #sessionFile(path) {
+        return resolveSessionFile(path, { root: this.#sessionsRoot, allowMissing: true });
+    }
+    #mutate(operation) {
+        const task = this.#tail.then(async () => {
+            const next = new Map([...this.#records].map(([id, record]) => [id, structuredClone(record)]));
+            operation(next);
+            await this.#write(next);
+            this.#records = next;
+        });
+        this.#tail = task.catch(() => undefined);
+        return task;
+    }
+    async #write(records) {
+        const file = {
+            version: 1,
+            sessions: [...records.values()]
+                .sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.id.localeCompare(right.id)),
+        };
+        await atomicWriteJson(this.#path, file, 0o600);
+    }
+}
+function parseCatalog(value) {
+    const file = object(value, "session catalog");
+    exactKeys(file, ["version", "sessions"], "session catalog");
+    if (file["version"] !== 1)
+        throw new Error("Session catalog version must be 1");
+    if (!Array.isArray(file["sessions"]) || file["sessions"].length > 1_000) {
+        throw new Error("Session catalog sessions must be an array of at most 1000 entries");
+    }
+    return {
+        version: 1,
+        sessions: file["sessions"].map((value, index) => parseRecord(value, `session catalog.sessions[${index}]`)),
+    };
+}
+function parseRecord(value, path) {
+    const record = object(value, path);
+    exactKeys(record, ["id", "sessionFile", "cwd", "title", "titleSource", "createdAt", "updatedAt"], path);
+    const titleSource = record["titleSource"];
+    if (titleSource !== "default" && titleSource !== "user" && titleSource !== "prompt") {
+        throw new Error(`${path}.titleSource is invalid`);
+    }
+    return {
+        id: sessionId(record["id"], `${path}.id`),
+        sessionFile: boundedString(record["sessionFile"], `${path}.sessionFile`, 4_096),
+        cwd: boundedString(record["cwd"], `${path}.cwd`, 4_096),
+        title: boundedTitle(boundedString(record["title"], `${path}.title`, 120)),
+        titleSource,
+        createdAt: timestamp(record["createdAt"], `${path}.createdAt`),
+        updatedAt: timestamp(record["updatedAt"], `${path}.updatedAt`),
+    };
+}
+function object(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        throw new Error(`${path} must be an object`);
+    return value;
+}
+function exactKeys(value, expectedKeys, path) {
+    const expected = new Set(expectedKeys);
+    const actual = Object.keys(value);
+    const unknown = actual.filter((key) => !expected.has(key));
+    const missing = expectedKeys.filter((key) => !(key in value));
+    if (unknown.length > 0)
+        throw new Error(`${path} contains unknown fields: ${unknown.join(", ")}`);
+    if (missing.length > 0)
+        throw new Error(`${path} is missing fields: ${missing.join(", ")}`);
+}
+function sessionId(value, path) {
+    const id = boundedString(value, path, 128);
+    if (!/^[A-Za-z0-9][A-Za-z0-9._:-]*$/.test(id))
+        throw new Error(`${path} contains unsupported characters`);
+    return id;
+}
+function boundedString(value, path, maximum) {
+    if (typeof value !== "string" || !value || value.length > maximum || /[\u0000-\u001f]/.test(value)) {
+        throw new Error(`${path} must be a non-empty string of at most ${maximum} characters without controls`);
+    }
+    return value;
+}
+function boundedTitle(value) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    if (!normalized || normalized.length > 120)
+        throw new Error("Session title must contain 1-120 characters");
+    return normalized;
+}
+function titleFromPrompt(value) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    const chars = [...normalized];
+    return boundedTitle(chars.length > 72 ? `${chars.slice(0, 71).join("")}…` : normalized);
+}
+function defaultTitle(id) {
+    return id === "main" ? "Main session" : "New session";
+}
+function timestamp(value, path) {
+    const text = boundedString(value, path, 64);
+    const date = new Date(text);
+    if (Number.isNaN(date.valueOf()) || date.toISOString() !== text)
+        throw new Error(`${path} must be an ISO timestamp`);
+    return text;
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=session-catalog.js.map

package/dist/sessions/session-catalog.js.map

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

package/dist/sessions/session-file.d.ts

@@ -0,0 +1,12 @@
+export interface ResolveSessionFileOptions {
+    root?: string;
+    allowMissing?: boolean;
+}
+/**
+ * Canonicalize a Pi JSONL session path without requiring the leaf file to
+ * exist. Pi intentionally defers creating a new file until persistence starts,
+ * so callers may validate the existing canonical parent first and materialize
+ * the leaf afterwards.
+ */
+export declare function resolveSessionFile(path: string, options?: ResolveSessionFileOptions): Promise<string>;
+//# sourceMappingURL=session-file.d.ts.map

package/dist/sessions/session-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file.d.ts","sourceRoot":"","sources":["../../src/sessions/session-file.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/sessions/session-file.js

@@ -0,0 +1,47 @@
+import { realpath, stat } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+/**
+ * Canonicalize a Pi JSONL session path without requiring the leaf file to
+ * exist. Pi intentionally defers creating a new file until persistence starts,
+ * so callers may validate the existing canonical parent first and materialize
+ * the leaf afterwards.
+ */
+export async function resolveSessionFile(path, options = {}) {
+    const requested = resolve(path);
+    if (!requested.endsWith(".jsonl"))
+        throw invalidSessionFile(path);
+    const root = options.root === undefined ? undefined : await realpath(options.root);
+    let canonical;
+    try {
+        canonical = await realpath(requested);
+    }
+    catch (error) {
+        if (!options.allowMissing || !isNodeError(error) || error.code !== "ENOENT")
+            throw error;
+        const parent = await realpath(dirname(requested));
+        assertInsideRoot(parent, root, path);
+        canonical = join(parent, basename(requested));
+        return canonical;
+    }
+    assertInsideRoot(canonical, root, path);
+    if (!canonical.endsWith(".jsonl"))
+        throw invalidSessionFile(path);
+    const info = await stat(canonical);
+    if (!info.isFile())
+        throw new Error(`Session file is not a regular file: ${path}`);
+    return canonical;
+}
+function assertInsideRoot(path, root, input) {
+    if (root === undefined)
+        return;
+    const rel = relative(root, path);
+    if (!rel || rel.startsWith("..") || isAbsolute(rel))
+        throw invalidSessionFile(input);
+}
+function invalidSessionFile(path) {
+    return new Error(`Session file must be a JSONL file inside the session root: ${path}`);
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=session-file.js.map

package/dist/sessions/session-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file.js","sourceRoot":"","sources":["../../src/sessions/session-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOnF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,UAAqC,EAAE;IAEvC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;QACzF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAClD,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;IACnF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,IAAwB,EAAE,KAAa;IAC7E,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,IAAI,KAAK,CAAC,8DAA8D,IAAI,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD,CAAC"}

package/dist/settings/compaction-settings.d.ts

@@ -0,0 +1,10 @@
+export interface AutoCompactionConfig {
+    enabled: boolean;
+    /** Compact after the active model context grows beyond this many tokens. */
+    triggerTokens: number;
+    reserveTokens: number;
+    keepRecentTokens: number;
+}
+export declare const DEFAULT_AUTO_COMPACTION: Readonly<AutoCompactionConfig>;
+export declare const MAX_COMPACTION_TOKENS = 1000000;
+//# sourceMappingURL=compaction-settings.d.ts.map

package/dist/settings/compaction-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-settings.d.ts","sourceRoot":"","sources":["../../src/settings/compaction-settings.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,oBAAoB,CAKlE,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAAY,CAAC"}

package/dist/settings/compaction-settings.js

@@ -0,0 +1,8 @@
+export const DEFAULT_AUTO_COMPACTION = {
+    enabled: true,
+    triggerTokens: 100_000,
+    reserveTokens: 16_384,
+    keepRecentTokens: 20_000,
+};
+export const MAX_COMPACTION_TOKENS = 1_000_000;
+//# sourceMappingURL=compaction-settings.js.map

package/dist/settings/compaction-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-settings.js","sourceRoot":"","sources":["../../src/settings/compaction-settings.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,uBAAuB,GAAmC;IACrE,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,OAAO;IACtB,aAAa,EAAE,MAAM;IACrB,gBAAgB,EAAE,MAAM;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC"}

package/dist/settings/indexing-settings-service.d.ts

@@ -0,0 +1,16 @@
+import { type PsporePaths } from "../storage/home.js";
+import { type IndexingSettings, type IndexingSettingsUpdate } from "./indexing-settings.js";
+/**
+ * Reads and writes `config.indexing` on behalf of a client.
+ *
+ * Every write is re-parsed with the daemon's own `parseConfig` before it is
+ * persisted, so a client cannot leave behind a file the daemon will refuse to
+ * load.
+ */
+export declare class IndexingSettingsService {
+    #private;
+    constructor(home: string, paths: PsporePaths);
+    get(): Promise<IndexingSettings>;
+    save(update: IndexingSettingsUpdate): Promise<IndexingSettings>;
+}
+//# sourceMappingURL=indexing-settings-service.d.ts.map

package/dist/settings/indexing-settings-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing-settings-service.d.ts","sourceRoot":"","sources":["../../src/settings/indexing-settings-service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC;;;;;;GAMG;AACH,qBAAa,uBAAuB;;gBAItB,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAKtC,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAehC,IAAI,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAYtE"}

package/dist/settings/indexing-settings-service.js

@@ -0,0 +1,57 @@
+import { access, constants } from "node:fs/promises";
+import { join } from "node:path";
+import { parseConfig } from "../config/config.js";
+import { bundledIndexerPath } from "../indexing/index-service.js";
+import { atomicWriteJson } from "../storage/atomic.js";
+import { loadConfig } from "../storage/home.js";
+import { decodeIndexingSettingsUpdate, } from "./indexing-settings.js";
+/**
+ * Reads and writes `config.indexing` on behalf of a client.
+ *
+ * Every write is re-parsed with the daemon's own `parseConfig` before it is
+ * persisted, so a client cannot leave behind a file the daemon will refuse to
+ * load.
+ */
+export class IndexingSettingsService {
+    #home;
+    #paths;
+    constructor(home, paths) {
+        this.#home = home;
+        this.#paths = paths;
+    }
+    async get() {
+        const config = await loadConfig(this.#home);
+        const indexerPath = this.#indexerPath();
+        return {
+            version: 1,
+            enabled: config.indexing.enabled,
+            directories: [...config.indexing.directories],
+            intervalMinutes: config.indexing.intervalMinutes,
+            extensions: [...config.indexing.extensions],
+            configPath: this.#paths.config,
+            indexerAvailable: await exists(indexerPath),
+            indexerPath,
+        };
+    }
+    async save(update) {
+        const decoded = decodeIndexingSettingsUpdate(update);
+        const current = await loadConfig(this.#home);
+        const next = parseConfig({ ...current, indexing: { ...decoded } }, this.#home);
+        await atomicWriteJson(this.#paths.config, next, 0o600);
+        return this.get();
+    }
+    /** Path of the indexer inside the bundled skill's workspace link. */
+    #indexerPath() {
+        return bundledIndexerPath(join(this.#paths.workspace, "skills", "aegis-search"));
+    }
+}
+async function exists(path) {
+    try {
+        await access(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=indexing-settings-service.js.map

package/dist/settings/indexing-settings-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing-settings-service.js","sourceRoot":"","sources":["../../src/settings/indexing-settings-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAoB,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,4BAA4B,GAG7B,MAAM,wBAAwB,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IACzB,KAAK,CAAS;IACd,MAAM,CAAc;IAE7B,YAAY,IAAY,EAAE,KAAkB;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACxC,OAAO;YACL,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;YAChC,WAAW,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7C,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,eAAe;YAChD,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC3C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC9B,gBAAgB,EAAE,MAAM,MAAM,CAAC,WAAW,CAAC;YAC3C,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA8B;QACvC,MAAM,OAAO,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/E,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,qEAAqE;IACrE,YAAY;QACV,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;IACnF,CAAC;CACF;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/settings/indexing-settings.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Continuous indexing settings as edited by a client.
+ *
+ * Kept separate from the LLM settings because it is a different config section
+ * with different validation, and mixing them would make one decoder responsible
+ * for two unrelated shapes.
+ */
+export interface IndexingSettings {
+    version: 1;
+    enabled: boolean;
+    directories: string[];
+    intervalMinutes: number;
+    extensions: string[];
+    /** Absolute path of the file these values are stored in, shown to the user. */
+    configPath: string;
+    /** True when the release shipped an indexer binary the daemon can run. */
+    indexerAvailable: boolean;
+    /** Absolute path of the indexer, whether or not it is present. */
+    indexerPath: string;
+}
+export interface IndexingSettingsUpdate {
+    enabled: boolean;
+    directories: string[];
+    intervalMinutes: number;
+    extensions: string[];
+}
+export declare const MAX_INDEX_DIRECTORIES = 64;
+export declare const MAX_INDEX_INTERVAL_MINUTES = 10080;
+export declare function decodeIndexingSettingsUpdate(value: unknown, label?: string): IndexingSettingsUpdate;
+//# sourceMappingURL=indexing-settings.d.ts.map

package/dist/settings/indexing-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing-settings.d.ts","sourceRoot":"","sources":["../../src/settings/indexing-settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,KAAK,SAAsB,GAC1B,sBAAsB,CA4CxB"}

package/dist/settings/indexing-settings.js

@@ -0,0 +1,58 @@
+export const MAX_INDEX_DIRECTORIES = 64;
+export const MAX_INDEX_INTERVAL_MINUTES = 10_080;
+export function decodeIndexingSettingsUpdate(value, label = "indexing settings") {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const input = value;
+    const allowed = new Set(["enabled", "directories", "intervalMinutes", "extensions"]);
+    const unknown = Object.keys(input).filter((key) => !allowed.has(key));
+    if (unknown.length > 0)
+        throw new Error(`${label} contains unknown fields: ${unknown.join(", ")}`);
+    if (typeof input["enabled"] !== "boolean")
+        throw new Error(`${label}.enabled must be boolean`);
+    const intervalMinutes = input["intervalMinutes"];
+    if (!Number.isSafeInteger(intervalMinutes)
+        || Number(intervalMinutes) < 1
+        || Number(intervalMinutes) > MAX_INDEX_INTERVAL_MINUTES) {
+        throw new Error(`${label}.intervalMinutes must be between 1 and ${MAX_INDEX_INTERVAL_MINUTES}`);
+    }
+    const directories = stringArray(input["directories"], `${label}.directories`, MAX_INDEX_DIRECTORIES);
+    for (const [index, directory] of directories.entries()) {
+        // Only absolute paths: the daemon resolves nothing on the client's behalf,
+        // and a relative path would silently mean a different directory to each.
+        if (!directory.startsWith("/")) {
+            throw new Error(`${label}.directories[${index}] must be an absolute path`);
+        }
+    }
+    const extensions = stringArray(input["extensions"], `${label}.extensions`, 64);
+    if (extensions.length === 0)
+        throw new Error(`${label}.extensions requires at least one extension`);
+    const normalized = extensions.map((extension, index) => {
+        const value = (extension.startsWith(".") ? extension.slice(1) : extension).toLowerCase();
+        if (!/^[a-z0-9]{1,16}$/.test(value)) {
+            throw new Error(`${label}.extensions[${index}] must be a short alphanumeric extension`);
+        }
+        return value;
+    });
+    return {
+        enabled: input["enabled"],
+        directories: [...new Set(directories)].sort(),
+        intervalMinutes: Number(intervalMinutes),
+        extensions: [...new Set(normalized)],
+    };
+}
+function stringArray(value, path, maximum) {
+    if (!Array.isArray(value))
+        throw new Error(`${path} must be an array`);
+    if (value.length > maximum)
+        throw new Error(`${path} cannot contain more than ${maximum} entries`);
+    return value.map((item, index) => {
+        // Control characters only: real paths routinely contain spaces and hyphens.
+        if (typeof item !== "string" || !item.trim() || /[\u0000-\u001f]/.test(item)) {
+            throw new Error(`${path}[${index}] must be a non-empty single-line string`);
+        }
+        return item.trim();
+    });
+}
+//# sourceMappingURL=indexing-settings.js.map

package/dist/settings/indexing-settings.js.map

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

package/dist/settings/llm-settings-service.d.ts

@@ -8,6 +8,12 @@ export declare class LlmSettingsService {
      * with `model_not_configured`, so this is what "not configured yet" means to a client.
      */
     isModelConfigured(): Promise<boolean>;
+    /**
+     * `config.json` is authoritative for every field the settings panel edits.
+     * `state/pi/models.json` is a derived catalog for the Pi runtime, so it is only
+     * consulted to recover endpoint values written by a pre-0.1.15 build that had
+     * nowhere else to store them.
+     */
     get(): Promise<LlmSettings>;
     save(update: LlmSettingsUpdate): Promise<LlmSettings>;
 }

package/dist/settings/llm-settings-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-settings-service.d.ts","sourceRoot":"","sources":["../../src/settings/llm-settings-service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAGvB,MAAM,mBAAmB,CAAC;AAgB3B,qBAAa,kBAAkB;;gBAIjB,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAK5C;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKrC,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;IAqB3B,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;CAgG5D"}
+{"version":3,"file":"llm-settings-service.d.ts","sourceRoot":"","sources":["../../src/settings/llm-settings-service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAGvB,MAAM,mBAAmB,CAAC;AAgB3B,qBAAa,kBAAkB;;gBAIjB,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAK5C;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAK3C;;;;;OAKG;IACG,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;IAwD3B,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;CA8K5D"}