advisor-pi 1.1.0 → 1.2.0

package/dist/preferences.d.ts

@@ -0,0 +1,40 @@
+export declare const PREFERENCES_VERSION = 1;
+/** Fixed allow-listed names within the extension-specific preferences directory. */
+export declare const PREFERENCE_FILE_NAMES: Readonly<{
+    enabled: "enabled.json";
+    model: "model.json";
+    thinkingLevel: "thinkingLevel.json";
+    maxUses: "maxUses.json";
+    cacheRetention: "cacheRetention.json";
+    maxTranscriptChars: "maxTranscriptChars.json";
+}>;
+export type AdvisorPreferencesPatch = {
+    enabled?: boolean;
+    provider?: string;
+    modelId?: string;
+    thinkingLevel?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+    maxUses?: number;
+    cacheRetention?: "none" | "short" | "long";
+    maxTranscriptChars?: number;
+};
+export type AdvisorPreferences = AdvisorPreferencesPatch & {
+    version: typeof PREFERENCES_VERSION;
+};
+/** Return the directory containing advisor-pi's per-setting files. */
+export declare function preferencesPath(agentDir?: string): string;
+/** Read and independently validate the durable advisor settings. */
+export declare function loadPreferences(agentDir?: string): AdvisorPreferencesPatch;
+/** Validate and persist supplied logical settings without any aggregate snapshot. */
+export declare function savePreferences(config: AdvisorPreferencesPatch, agentDir?: string): Promise<boolean>;
+/** Validate and persist one or more deliberate logical setting edits. */
+export declare function savePreferencesPatch(patch: AdvisorPreferencesPatch, agentDir?: string): Promise<boolean>;
+export type AdvisorPreferencesConfig = {
+    enabled: boolean;
+    provider: string;
+    modelId: string;
+    thinkingLevel: NonNullable<AdvisorPreferencesPatch["thinkingLevel"]>;
+    maxUses: number;
+    cacheRetention: NonNullable<AdvisorPreferencesPatch["cacheRetention"]>;
+    maxTranscriptChars: number;
+};
+//# sourceMappingURL=preferences.d.ts.map

package/dist/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../src/preferences.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oFAAoF;AACpF,eAAO,MAAM,qBAAqB;;;;;;;EAOhC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,GAAG;IAAE,OAAO,EAAE,OAAO,mBAAmB,CAAA;CAAE,CAAC;AAEnG,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAExE;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,uBAAuB,CAwBzF;AAED,qFAAqF;AACrF,wBAAsB,eAAe,CAAC,MAAM,EAAE,uBAAuB,EAAE,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzH;AAED,yEAAyE;AACzE,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,EAAE,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7H;AAyHD,MAAM,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,WAAW,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,WAAW,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvE,kBAAkB,EAAE,MAAM,CAAC;CAC3B,CAAC"}

package/dist/preferences.js

@@ -0,0 +1,198 @@
+import { randomUUID } from "node:crypto";
+import { closeSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+export const PREFERENCES_VERSION = 1;
+/** Fixed allow-listed names within the extension-specific preferences directory. */
+export const PREFERENCE_FILE_NAMES = Object.freeze({
+    enabled: "enabled.json",
+    model: "model.json",
+    thinkingLevel: "thinkingLevel.json",
+    maxUses: "maxUses.json",
+    cacheRetention: "cacheRetention.json",
+    maxTranscriptChars: "maxTranscriptChars.json",
+});
+/** Return the directory containing advisor-pi's per-setting files. */
+export function preferencesPath(agentDir = getAgentDir()) {
+    return join(agentDir, "advisor-pi-preferences");
+}
+/** Read and independently validate the durable advisor settings. */
+export function loadPreferences(agentDir = getAgentDir()) {
+    const patch = {};
+    const enabled = readPreference(agentDir, PREFERENCE_FILE_NAMES.enabled);
+    if (enabled && typeof enabled.enabled === "boolean")
+        patch.enabled = enabled.enabled;
+    const model = readPreference(agentDir, PREFERENCE_FILE_NAMES.model);
+    if (model && typeof model.provider === "string" && model.provider.trim() && typeof model.modelId === "string" && model.modelId.trim()) {
+        patch.provider = model.provider.trim();
+        patch.modelId = model.modelId.trim();
+    }
+    const thinkingLevel = parseThinkingLevel(readPreference(agentDir, PREFERENCE_FILE_NAMES.thinkingLevel)?.thinkingLevel);
+    if (thinkingLevel)
+        patch.thinkingLevel = thinkingLevel;
+    const maxUses = readPreference(agentDir, PREFERENCE_FILE_NAMES.maxUses)?.maxUses;
+    if (isPositiveSafeInteger(maxUses))
+        patch.maxUses = maxUses;
+    const cacheRetention = parseCacheRetention(readPreference(agentDir, PREFERENCE_FILE_NAMES.cacheRetention)?.cacheRetention);
+    if (cacheRetention)
+        patch.cacheRetention = cacheRetention;
+    const maxTranscriptChars = readPreference(agentDir, PREFERENCE_FILE_NAMES.maxTranscriptChars)?.maxTranscriptChars;
+    if (isPositiveSafeInteger(maxTranscriptChars))
+        patch.maxTranscriptChars = maxTranscriptChars;
+    return patch;
+}
+/** Validate and persist supplied logical settings without any aggregate snapshot. */
+export async function savePreferences(config, agentDir = getAgentDir()) {
+    return saveValidatedPreferences(config, agentDir);
+}
+/** Validate and persist one or more deliberate logical setting edits. */
+export async function savePreferencesPatch(patch, agentDir = getAgentDir()) {
+    return saveValidatedPreferences(patch, agentDir);
+}
+async function saveValidatedPreferences(input, agentDir) {
+    const writes = prepareWrites(input);
+    if (!writes)
+        return false;
+    try {
+        mkdirSync(preferencesPath(agentDir), { recursive: true, mode: 0o700 });
+    }
+    catch {
+        return false;
+    }
+    for (const write of writes) {
+        if (!writePreference(agentDir, write))
+            return false;
+    }
+    return true;
+}
+function prepareWrites(input) {
+    if (!isRecord(input))
+        return undefined;
+    if (input.version !== undefined && input.version !== PREFERENCES_VERSION)
+        return undefined;
+    const keys = Object.keys(input).filter((key) => key !== "version");
+    if (keys.length === 0)
+        return undefined;
+    const writes = [];
+    const hasProvider = keys.includes("provider");
+    const hasModelId = keys.includes("modelId");
+    if (hasProvider || hasModelId) {
+        if (!hasProvider || !hasModelId || typeof input.provider !== "string" || !input.provider.trim() || typeof input.modelId !== "string" || !input.modelId.trim()) {
+            return undefined;
+        }
+        writes.push({
+            fileName: PREFERENCE_FILE_NAMES.model,
+            payload: {
+                version: PREFERENCES_VERSION,
+                provider: input.provider.trim(),
+                modelId: input.modelId.trim(),
+            },
+        });
+    }
+    for (const key of keys) {
+        switch (key) {
+            case "provider":
+            case "modelId":
+                break;
+            case "enabled":
+                if (typeof input.enabled !== "boolean")
+                    return undefined;
+                writes.push({ fileName: PREFERENCE_FILE_NAMES.enabled, payload: { version: PREFERENCES_VERSION, enabled: input.enabled } });
+                break;
+            case "thinkingLevel": {
+                const thinkingLevel = parseThinkingLevel(input.thinkingLevel);
+                if (!thinkingLevel)
+                    return undefined;
+                writes.push({ fileName: PREFERENCE_FILE_NAMES.thinkingLevel, payload: { version: PREFERENCES_VERSION, thinkingLevel } });
+                break;
+            }
+            case "maxUses":
+                if (!isPositiveSafeInteger(input.maxUses))
+                    return undefined;
+                writes.push({ fileName: PREFERENCE_FILE_NAMES.maxUses, payload: { version: PREFERENCES_VERSION, maxUses: input.maxUses } });
+                break;
+            case "cacheRetention": {
+                const cacheRetention = parseCacheRetention(input.cacheRetention);
+                if (!cacheRetention)
+                    return undefined;
+                writes.push({ fileName: PREFERENCE_FILE_NAMES.cacheRetention, payload: { version: PREFERENCES_VERSION, cacheRetention } });
+                break;
+            }
+            case "maxTranscriptChars":
+                if (!isPositiveSafeInteger(input.maxTranscriptChars))
+                    return undefined;
+                writes.push({
+                    fileName: PREFERENCE_FILE_NAMES.maxTranscriptChars,
+                    payload: { version: PREFERENCES_VERSION, maxTranscriptChars: input.maxTranscriptChars },
+                });
+                break;
+            default:
+                return undefined;
+        }
+    }
+    return writes;
+}
+function readPreference(agentDir, fileName) {
+    try {
+        const parsed = JSON.parse(readFileSync(join(preferencesPath(agentDir), fileName), "utf8"));
+        if (!isRecord(parsed))
+            return undefined;
+        if (parsed.version !== undefined && parsed.version !== PREFERENCES_VERSION)
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+function writePreference(agentDir, write) {
+    const directory = preferencesPath(agentDir);
+    const temporaryPath = join(directory, `.${write.fileName}.${process.pid}.${randomUUID()}.tmp`);
+    let fileDescriptor;
+    try {
+        fileDescriptor = openSync(temporaryPath, "wx", 0o600);
+        writeFileSync(fileDescriptor, `${JSON.stringify(write.payload, null, 2)}\n`, "utf8");
+        fsyncSync(fileDescriptor);
+        closeSync(fileDescriptor);
+        fileDescriptor = undefined;
+        renameSync(temporaryPath, join(directory, write.fileName));
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        if (fileDescriptor !== undefined) {
+            try {
+                closeSync(fileDescriptor);
+            }
+            catch {
+                // Best-effort cleanup after a failed write.
+            }
+        }
+        try {
+            unlinkSync(temporaryPath);
+        }
+        catch {
+            // The rename succeeded, or the temporary file was never created.
+        }
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPositiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function parseCacheRetention(value) {
+    if (value === "none" || value === "short" || value === "long")
+        return value;
+    return undefined;
+}
+function parseThinkingLevel(value) {
+    if (value === "minimal" || value === "low" || value === "medium" || value === "high" || value === "xhigh" || value === "max") {
+        return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=preferences.js.map

package/dist/preferences.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "advisor-pi",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Advisor-style strategic model guidance for Pi Coding Agent workflows",
   "type": "module",
   "main": "./dist/index.js",

package/src/config-ui.ts

@@ -0,0 +1,40 @@
+import type { AdvisorConfig } from "./index.js";
+
+/** Rows used by the interactive advisor-pi settings menu. */
+export type MenuRow<TKey extends string = string> = { key: TKey; label: string };
+
+export type MenuKey =
+	| "enabled"
+	| "model"
+	| "thinking"
+	| "max-uses"
+	| "max-transcript-chars"
+	| "cache"
+	| "reset"
+	| "close";
+
+/** Build the top-level settings rows, including the current value for each setting. */
+export function buildMenuRows(config: AdvisorConfig, useCount = 0): MenuRow<MenuKey>[] {
+	const entries: Array<[MenuKey, string, string]> = [
+		["enabled", "Advisor enabled", config.enabled ? "enabled" : "disabled"],
+		["model", "Advisor model", "configured (use /advisor-pi status for ID)"],
+		["thinking", "Advisor thinking", config.thinkingLevel],
+		["max-uses", "Max advisor uses", String(config.maxUses)],
+		["max-transcript-chars", "Max transcript chars", String(config.maxTranscriptChars)],
+		["cache", "Cache retention", config.cacheRetention],
+	];
+	const width = Math.max(...entries.map(([, label]) => label.length));
+	const rows = entries.map(([key, label, value]) => ({
+		key,
+		label: `${label.padEnd(width)}  ${value}`,
+	}));
+	rows.push({ key: "reset", label: `Reset use count  (${useCount} used)` });
+	rows.push({ key: "close", label: "Close" });
+	return rows;
+}
+
+/** Maps a selected label back to its row; cancelled dialogs return undefined. */
+export function rowForLabel<TKey extends string>(rows: MenuRow<TKey>[], label: string | undefined): MenuRow<TKey> | undefined {
+	if (label === undefined) return undefined;
+	return rows.find((row) => row.label === label);
+}