pi-para 0.6.0 → 0.6.2

package/dist/scripts/bulk-link-fix.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env tsx
+/**
+ * One-time bulk fix: auto-link slugs, normalize tags, sync frontmatter.links
+ * across all wiki pages.
+ *
+ * Usage: npx tsx src/scripts/bulk-link-fix.ts [--dry-run]
+ */
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { listPages, readPage, writePage, } from "../wiki.js";
+import { autoLinkSlugs, syncFrontmatterLinks } from "../link-utils.js";
+import { normalizeTags, normalizeScopes } from "../tag-registry.js";
+const WIKI_DIR = join(homedir(), ".pi", "wiki");
+const dryRun = process.argv.includes("--dry-run");
+async function main() {
+    console.log(`\n📚 Bulk Wiki Fix — ${dryRun ? "DRY RUN" : "LIVE"}`);
+    console.log(`   Wiki: ${WIKI_DIR}\n`);
+    // Load all pages
+    const refs = await listPages(WIKI_DIR);
+    const pages = [];
+    for (const ref of refs) {
+        const page = await readPage(WIKI_DIR, ref.category, ref.slug);
+        if (page)
+            pages.push(page);
+    }
+    const allSlugs = new Set(pages.map(p => p.slug));
+    console.log(`   Found ${pages.length} pages, ${allSlugs.size} unique slugs\n`);
+    let linksAdded = 0;
+    let tagsNormalized = 0;
+    let frontmatterSynced = 0;
+    let pagesChanged = 0;
+    for (const page of pages) {
+        const originalBody = page.body;
+        const originalTags = [...page.frontmatter.tags];
+        const originalLinks = [...page.frontmatter.links];
+        const originalScope = [...page.frontmatter.scope];
+        // 1. Normalize scopes first (tags depend on scope)
+        const newScope = normalizeScopes(page.frontmatter.scope);
+        // 2. Auto-link slug mentions in body
+        let newBody = autoLinkSlugs(originalBody, allSlugs, page.slug);
+        // 3. Sync frontmatter.links from body [[wikilinks]]
+        const newLinks = syncFrontmatterLinks(newBody);
+        // 4. Normalize tags (using normalized scope for dedup)
+        const newTags = normalizeTags(page.frontmatter.tags, newScope);
+        // Check what changed
+        const bodyChanged = newBody !== originalBody;
+        const linksChanged = JSON.stringify(newLinks.sort()) !== JSON.stringify(originalLinks.sort());
+        const tagsChanged = JSON.stringify(newTags) !== JSON.stringify(originalTags.sort());
+        const scopeChanged = JSON.stringify(newScope) !== JSON.stringify(originalScope.sort());
+        if (!bodyChanged && !linksChanged && !tagsChanged && !scopeChanged)
+            continue;
+        pagesChanged++;
+        const addedLinksCount = newLinks.filter(l => !originalLinks.includes(l)).length;
+        linksAdded += addedLinksCount;
+        if (tagsChanged)
+            tagsNormalized++;
+        if (linksChanged)
+            frontmatterSynced++;
+        // Report
+        const changes = [];
+        if (scopeChanged) {
+            changes.push(`scope: [${originalScope.join(", ")}] → [${newScope.join(", ")}]`);
+        }
+        if (bodyChanged) {
+            const addedLinks = newLinks.filter(l => !originalLinks.includes(l));
+            changes.push(`+${addedLinks.length} wikilinks: ${addedLinks.join(", ")}`);
+        }
+        if (tagsChanged) {
+            changes.push(`tags: [${originalTags.join(", ")}] → [${newTags.join(", ")}]`);
+        }
+        if (linksChanged && !bodyChanged) {
+            changes.push(`frontmatter.links synced`);
+        }
+        console.log(`  ${dryRun ? "WOULD FIX" : "FIXED"} ${page.category}/${page.slug}`);
+        for (const c of changes) {
+            console.log(`    → ${c}`);
+        }
+        if (!dryRun) {
+            const updatedPage = {
+                ...page,
+                body: newBody,
+                frontmatter: {
+                    ...page.frontmatter,
+                    scope: newScope,
+                    tags: newTags,
+                    links: newLinks,
+                    updated: new Date().toISOString(),
+                },
+            };
+            await writePage(WIKI_DIR, updatedPage);
+        }
+    }
+    console.log(`\n━━━ Summary ━━━`);
+    console.log(`  Pages changed:      ${pagesChanged} / ${pages.length}`);
+    console.log(`  Wikilinks added:    ${linksAdded}`);
+    console.log(`  Tags normalized:    ${tagsNormalized}`);
+    console.log(`  Frontmatter synced: ${frontmatterSynced}`);
+    if (dryRun)
+        console.log(`\n  (dry run — no files modified, re-run without --dry-run to apply)`);
+    console.log();
+}
+main().catch(err => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=bulk-link-fix.js.map

package/dist/scripts/bulk-link-fix.js.map

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

package/dist/session-tools.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Session exploration tools for the Agent.
+ *
+ * These tools give the Agent the ability to explore a session file
+ * without loading the entire thing into the prompt — the TypeScript
+ * equivalent of RLM's REPL-based exploration.
+ */
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+interface SessionMessage {
+    role: string;
+    text: string;
+    toolCalls: string[];
+    charOffset: number;
+}
+export interface LoadedSession {
+    messages: SessionMessage[];
+    serialized: string;
+    stats: {
+        totalMessages: number;
+        userMessages: number;
+        assistantMessages: number;
+        toolResults: number;
+        toolCalls: number;
+        totalChars: number;
+        compactionSummaries: number;
+    };
+}
+/** Load and pre-process a session JSONL file. */
+export declare function loadSession(sessionPath: string): LoadedSession;
+/** Create session exploration tools bound to a loaded session. */
+export declare function createSessionTools(session: LoadedSession): AgentTool[];
+export {};
+//# sourceMappingURL=session-tools.d.ts.map

package/dist/session-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tools.d.ts","sourceRoot":"","sources":["../src/session-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,+BAA+B,CAAC;AAIhF,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAyF9D;AAgBD,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,CAqHtE"}

package/dist/session-tools.js

@@ -0,0 +1,211 @@
+/**
+ * Session exploration tools for the Agent.
+ *
+ * These tools give the Agent the ability to explore a session file
+ * without loading the entire thing into the prompt — the TypeScript
+ * equivalent of RLM's REPL-based exploration.
+ */
+import { readFileSync } from "node:fs";
+import { Type } from "typebox";
+/** Load and pre-process a session JSONL file. */
+export function loadSession(sessionPath) {
+    const raw = readFileSync(sessionPath, "utf-8");
+    const lines = raw.split("\n").filter((l) => l.trim());
+    const messages = [];
+    const parts = [];
+    let charOffset = 0;
+    let compactionSummaries = 0;
+    let toolCallCount = 0;
+    for (const line of lines) {
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry.type === "compaction" && typeof entry.summary === "string") {
+            const text = `[Compaction Summary]:\n${entry.summary}`;
+            parts.push(text);
+            messages.push({ role: "compaction", text, toolCalls: [], charOffset });
+            charOffset += text.length + 2;
+            compactionSummaries++;
+            continue;
+        }
+        if (entry.type !== "message")
+            continue;
+        const msg = entry.message;
+        if (!msg)
+            continue;
+        const role = msg.role;
+        if (!["user", "assistant", "toolResult"].includes(role))
+            continue;
+        const content = msg.content;
+        let text = "";
+        const toolCalls = [];
+        if (typeof content === "string") {
+            text = content;
+        }
+        else if (Array.isArray(content)) {
+            const textParts = [];
+            for (const block of content) {
+                if (typeof block !== "object" || block === null)
+                    continue;
+                const b = block;
+                if (b.type === "text" && typeof b.text === "string") {
+                    textParts.push(b.text);
+                }
+                else if (b.type === "toolCall" && typeof b.name === "string") {
+                    const argsStr = JSON.stringify(b.arguments ?? {});
+                    toolCalls.push(`${b.name}(${argsStr.length > 300 ? argsStr.slice(0, 300) + "..." : argsStr})`);
+                    toolCallCount++;
+                }
+            }
+            text = textParts.join("\n");
+            if (toolCalls.length > 0) {
+                text += `\n[Tools]: ${toolCalls.join("; ")}`;
+            }
+        }
+        if (!text.trim())
+            continue;
+        // Truncate tool results
+        if (role === "toolResult" && text.length > 1000) {
+            text = text.slice(0, 1000) + "\n[truncated]";
+        }
+        const label = { user: "User", assistant: "Assistant", toolResult: "Tool" }[role] ?? role;
+        const formatted = `[${label}]: ${text}`;
+        parts.push(formatted);
+        messages.push({ role, text: formatted, toolCalls, charOffset });
+        charOffset += formatted.length + 2;
+    }
+    const serialized = parts.join("\n\n");
+    return {
+        messages,
+        serialized,
+        stats: {
+            totalMessages: messages.length,
+            userMessages: messages.filter((m) => m.role === "user").length,
+            assistantMessages: messages.filter((m) => m.role === "assistant").length,
+            toolResults: messages.filter((m) => m.role === "toolResult").length,
+            toolCalls: toolCallCount,
+            totalChars: serialized.length,
+            compactionSummaries,
+        },
+    };
+}
+// -- Tool definitions --------------------------------------------------------
+const SliceParams = Type.Object({
+    start: Type.Number({ description: "Start character offset" }),
+    end: Type.Number({ description: "End character offset" }),
+});
+const SearchParams = Type.Object({
+    query: Type.String({ description: "Text to search for (case-insensitive)" }),
+    maxResults: Type.Optional(Type.Number({ description: "Max results (default 10)" })),
+});
+const StatsParams = Type.Object({});
+/** Create session exploration tools bound to a loaded session. */
+export function createSessionTools(session) {
+    const sessionSlice = {
+        name: "session_slice",
+        label: "Session Slice",
+        description: `Read a slice of the session text (${session.stats.totalChars} chars total). Use to explore specific sections.`,
+        parameters: SliceParams,
+        execute: async (_id, params) => {
+            const start = Math.max(0, params.start);
+            const end = Math.min(session.serialized.length, params.end);
+            const slice = session.serialized.slice(start, end);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `[chars ${start}-${end} of ${session.serialized.length}]\n\n${slice}`,
+                    },
+                ],
+                details: { start, end, length: slice.length },
+            };
+        },
+    };
+    const sessionSearch = {
+        name: "session_search",
+        label: "Session Search",
+        description: "Search the session for a keyword. Returns matching sections with character offsets.",
+        parameters: SearchParams,
+        execute: async (_id, params) => {
+            const query = params.query.toLowerCase();
+            const maxResults = params.maxResults ?? 10;
+            const matches = [];
+            const text = session.serialized.toLowerCase();
+            let pos = 0;
+            while (matches.length < maxResults) {
+                const idx = text.indexOf(query, pos);
+                if (idx === -1)
+                    break;
+                // Extract context around match
+                const contextStart = Math.max(0, idx - 200);
+                const contextEnd = Math.min(session.serialized.length, idx + query.length + 200);
+                matches.push({
+                    offset: idx,
+                    context: session.serialized.slice(contextStart, contextEnd),
+                });
+                pos = idx + query.length;
+            }
+            if (matches.length === 0) {
+                return {
+                    content: [{ type: "text", text: `No matches for "${params.query}"` }],
+                    details: { matchCount: 0 },
+                };
+            }
+            const resultText = matches
+                .map((m, i) => `Match ${i + 1} (offset ${m.offset}):\n${m.context}\n`)
+                .join("\n---\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${matches.length} match(es) for "${params.query}":\n\n${resultText}`,
+                    },
+                ],
+                details: { matchCount: matches.length },
+            };
+        },
+    };
+    const sessionStats = {
+        name: "session_stats",
+        label: "Session Stats",
+        description: "Get session overview: message counts, size, topics.",
+        parameters: StatsParams,
+        execute: async () => {
+            const s = session.stats;
+            // Extract user message topics (first 100 chars of each, cap at 50)
+            const allUserMsgs = session.messages.filter((m) => m.role === "user");
+            const displayLimit = 50;
+            const userTopics = allUserMsgs
+                .slice(0, displayLimit)
+                .map((m) => m.text.replace(/^\[User\]: /, "").slice(0, 100))
+                .map((t, i) => `  ${i + 1}. ${t}`);
+            if (allUserMsgs.length > displayLimit) {
+                userTopics.push(`  ... and ${allUserMsgs.length - displayLimit} more user messages. Use session_search to find specific topics.`);
+            }
+            const sizeLabel = s.totalChars > 1_000_000 ? `${(s.totalChars / 1_000_000).toFixed(1)}M`
+                : s.totalChars > 1_000 ? `${(s.totalChars / 1_000).toFixed(0)}K`
+                    : `${s.totalChars}`;
+            const text = [
+                `Session: ${sizeLabel} chars, ${s.totalMessages} messages`,
+                `  User: ${s.userMessages}, Assistant: ${s.assistantMessages}, Tool results: ${s.toolResults}`,
+                `  Tool calls: ${s.toolCalls}, Compaction summaries: ${s.compactionSummaries}`,
+                "",
+                "Strategy: Use session_search to find topics, then session_slice to read details.",
+                `Valid slice range: 0 to ${s.totalChars}`,
+                "",
+                "User messages (topics):",
+                ...userTopics,
+            ].join("\n");
+            return {
+                content: [{ type: "text", text }],
+                details: s,
+            };
+        },
+    };
+    return [sessionSlice, sessionSearch, sessionStats];
+}
+//# sourceMappingURL=session-tools.js.map

package/dist/session-tools.js.map

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

package/dist/settings.d.ts

@@ -0,0 +1,37 @@
+import type { ParaUserConfig, ProviderCredentialRef } from "./config.js";
+export declare function modelSelectionLabel(selection: ParaUserConfig["models"]["capture"]): string;
+export declare function providerProfileLabel(profile: ProviderCredentialRef | null | undefined): string;
+export declare function setContextMaxTokens(config: ParaUserConfig, value: string): number;
+export declare function setSearchLimit(config: ParaUserConfig, value: string): number;
+export declare function setLintStaleDays(config: ParaUserConfig, value: string): number;
+export declare function toggleSearchGraphBoost(config: ParaUserConfig): boolean;
+export declare function toggleLintAutoFix(config: ParaUserConfig): boolean;
+export declare function setCaptureModelAuto(config: ParaUserConfig): void;
+export declare function setCaptureModel(config: ParaUserConfig, provider: string, model: string): ProviderCredentialRef;
+export declare function setWebWikiEnabled(config: ParaUserConfig, enabled: boolean): void;
+export declare function setWebWikiHost(config: ParaUserConfig, host: string): void;
+export declare function setWebWikiPort(config: ParaUserConfig, value: string): number;
+export declare function setProviderProfileField(profile: ProviderCredentialRef, field: "provider" | "baseUrl" | "model" | "apiFormat" | "credentialRef", value: string): void;
+export declare function setProviderDims(profile: ProviderCredentialRef, value: string): number;
+export declare function ensureEmbeddingProfile(config: ParaUserConfig): ProviderCredentialRef;
+export declare function ensureRerankProfile(config: ParaUserConfig): ProviderCredentialRef;
+export declare function disableRerank(config: ParaUserConfig): void;
+/** Known API providers selectable in /wiki-settings (baseUrl + format prefilled). */
+export interface ProviderPreset {
+    id: string;
+    label: string;
+    baseUrl: string;
+    apiFormat: "openai" | "anthropic";
+    defaultEmbedModel?: string;
+    defaultRerankModel?: string;
+}
+export declare const PROVIDER_PRESETS: ProviderPreset[];
+export declare function findProviderPreset(id: string): ProviderPreset | undefined;
+/**
+ * Apply a provider preset to an embedding/rerank profile: sets provider,
+ * baseUrl, apiFormat, and the preset's default model for the profile kind.
+ * Leaves credentialRef and dims untouched (dims must match any existing
+ * vector index; credential wiring is a separate explicit step).
+ */
+export declare function applyProviderPreset(profile: ProviderCredentialRef, preset: ProviderPreset, kind: "embedding" | "rerank"): void;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CAG1F;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAK9F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAGtE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAGjE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAEhE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAQ9G;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAEhF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,eAAe,EACvE,KAAK,EAAE,MAAM,GACZ,IAAI,CAgBN;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAQpF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAQjF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE1D;AAID,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAoD5C,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,WAAW,GAAG,QAAQ,GAC3B,IAAI,CAMN"}

package/dist/settings.js

@@ -0,0 +1,176 @@
+export function modelSelectionLabel(selection) {
+    if (selection === "auto")
+        return "auto";
+    return `${selection.provider}/${selection.model ?? "auto"} via ${selection.credentialRef}`;
+}
+export function providerProfileLabel(profile) {
+    if (!profile)
+        return "not configured";
+    const model = profile.model ?? "model not set";
+    const location = profile.baseUrl ? ` at ${profile.baseUrl}` : "";
+    return `${profile.provider}/${model}${location} via ${profile.credentialRef}`;
+}
+export function setContextMaxTokens(config, value) {
+    const parsed = parsePositiveInteger(value, config.context.maxTokens);
+    config.context.maxTokens = parsed;
+    return parsed;
+}
+export function setSearchLimit(config, value) {
+    const parsed = parsePositiveInteger(value, config.context.searchLimit);
+    config.context.searchLimit = parsed;
+    return parsed;
+}
+export function setLintStaleDays(config, value) {
+    const parsed = parsePositiveInteger(value, config.lint.staleDays);
+    config.lint.staleDays = parsed;
+    return parsed;
+}
+export function toggleSearchGraphBoost(config) {
+    config.context.searchGraphBoost = !config.context.searchGraphBoost;
+    return config.context.searchGraphBoost;
+}
+export function toggleLintAutoFix(config) {
+    config.lint.autoFix = !config.lint.autoFix;
+    return config.lint.autoFix;
+}
+export function setCaptureModelAuto(config) {
+    config.models.capture = "auto";
+}
+export function setCaptureModel(config, provider, model) {
+    const profile = {
+        provider,
+        model,
+        credentialRef: `pi-auth:${provider}`,
+    };
+    config.models.capture = profile;
+    return profile;
+}
+export function setWebWikiEnabled(config, enabled) {
+    config.webWiki.enabled = enabled;
+}
+export function setWebWikiHost(config, host) {
+    config.webWiki.host = host.trim() || config.webWiki.host;
+}
+export function setWebWikiPort(config, value) {
+    const parsed = parsePositiveInteger(value, config.webWiki.port);
+    config.webWiki.port = parsed;
+    return parsed;
+}
+export function setProviderProfileField(profile, field, value) {
+    if (field === "apiFormat") {
+        if (value !== "openai" && value !== "anthropic" && value !== "custom") {
+            throw new Error("apiFormat must be openai, anthropic, or custom");
+        }
+        profile.apiFormat = value;
+        return;
+    }
+    if (field === "credentialRef") {
+        if (value !== "none" && !value.startsWith("pi-auth:") && !value.startsWith("secret:")) {
+            throw new Error("credentialRef must be pi-auth:<provider>, secret:<name>, or none");
+        }
+        profile.credentialRef = value;
+        return;
+    }
+    profile[field] = value;
+}
+export function setProviderDims(profile, value) {
+    const parsed = parsePositiveInteger(value, profile.dims ?? 0);
+    profile.dims = parsed;
+    return parsed;
+}
+export function ensureEmbeddingProfile(config) {
+    config.qmd.embedding ??= {
+        provider: "openai",
+        model: "text-embedding-3-small",
+        apiFormat: "openai",
+        credentialRef: "secret:embedding",
+    };
+    return config.qmd.embedding;
+}
+export function ensureRerankProfile(config) {
+    config.qmd.rerank ??= {
+        provider: "jina",
+        model: "jina-reranker-v2-base-multilingual",
+        apiFormat: "openai",
+        credentialRef: "secret:rerank",
+    };
+    return config.qmd.rerank;
+}
+export function disableRerank(config) {
+    config.qmd.rerank = null;
+}
+export const PROVIDER_PRESETS = [
+    {
+        id: "openai",
+        label: "OpenAI",
+        baseUrl: "https://api.openai.com/v1",
+        apiFormat: "openai",
+        defaultEmbedModel: "text-embedding-3-small",
+    },
+    {
+        id: "openrouter",
+        label: "OpenRouter",
+        baseUrl: "https://openrouter.ai/api/v1",
+        apiFormat: "openai",
+        defaultEmbedModel: "openai/text-embedding-3-small",
+    },
+    {
+        id: "gemini",
+        label: "Google Gemini (OpenAI-compatible)",
+        baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+        apiFormat: "openai",
+        defaultEmbedModel: "text-embedding-004",
+    },
+    {
+        id: "mistral",
+        label: "Mistral",
+        baseUrl: "https://api.mistral.ai/v1",
+        apiFormat: "openai",
+        defaultEmbedModel: "mistral-embed",
+    },
+    {
+        id: "voyage",
+        label: "Voyage AI",
+        baseUrl: "https://api.voyageai.com/v1",
+        apiFormat: "openai",
+        defaultEmbedModel: "voyage-3-lite",
+        defaultRerankModel: "rerank-2-lite",
+    },
+    {
+        id: "jina",
+        label: "Jina AI",
+        baseUrl: "https://api.jina.ai/v1",
+        apiFormat: "openai",
+        defaultEmbedModel: "jina-embeddings-v3",
+        defaultRerankModel: "jina-reranker-v2-base-multilingual",
+    },
+    {
+        id: "ollama",
+        label: "Ollama (local server)",
+        baseUrl: "http://127.0.0.1:11434/v1",
+        apiFormat: "openai",
+        defaultEmbedModel: "nomic-embed-text",
+    },
+];
+export function findProviderPreset(id) {
+    return PROVIDER_PRESETS.find((p) => p.id === id);
+}
+/**
+ * Apply a provider preset to an embedding/rerank profile: sets provider,
+ * baseUrl, apiFormat, and the preset's default model for the profile kind.
+ * Leaves credentialRef and dims untouched (dims must match any existing
+ * vector index; credential wiring is a separate explicit step).
+ */
+export function applyProviderPreset(profile, preset, kind) {
+    profile.provider = preset.id;
+    profile.baseUrl = preset.baseUrl;
+    profile.apiFormat = preset.apiFormat;
+    const model = kind === "embedding" ? preset.defaultEmbedModel : preset.defaultRerankModel;
+    if (model)
+        profile.model = model;
+}
+function parsePositiveInteger(value, fallback) {
+    const parsed = parseInt(value, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,29 @@
+import { type LoadedParaConfig } from "./config.js";
+export interface SetupOptions {
+    homeDir?: string;
+    yes?: boolean;
+    dryRun?: boolean;
+    localPath?: string;
+    validateQmd?: boolean;
+    initWiki?: boolean;
+}
+export interface SetupResult {
+    dryRun: boolean;
+    extensionRef: string;
+    configPath: string;
+    wikiDir: string;
+    changes: string[];
+    warnings: string[];
+    migratedFromLegacy: boolean;
+}
+export declare function runSetup(options?: SetupOptions): Promise<SetupResult>;
+export declare function formatSetupResult(result: SetupResult): string;
+export declare function resolveExtensionRef(localPath?: string): string;
+export declare function ensurePiExtensionRegistration(settingsPath: string, extensionRef: string, opts?: {
+    dryRun?: boolean;
+}): Promise<{
+    changed: boolean;
+    packages: string[];
+}>;
+export declare function summarizeSetupConfig(loaded: LoadedParaConfig): string;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpE,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CA+C/E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAM7D;AAED,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAYnD;AAOD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAErE"}