pulseed 0.4.19 → 0.5.0

package/dist/grounding/providers/agents-provider.js

@@ -0,0 +1,129 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { homedir } from "node:os";
+import { makeSection, makeSource } from "./helpers.js";
+const UNTRUSTED_SEGMENTS = new Set([
+    ".git",
+    "node_modules",
+    ".next",
+    ".turbo",
+    ".cache",
+    "vendor",
+    "dist",
+    "build",
+    "coverage",
+    "tmp",
+    "temp",
+]);
+function findProjectRoot(cwd) {
+    let cursor = resolve(cwd);
+    while (true) {
+        if (existsSync(join(cursor, ".git")))
+            return cursor;
+        const next = dirname(cursor);
+        if (next === cursor)
+            return resolve(cwd);
+        cursor = next;
+    }
+}
+function hasUntrustedSegment(filePath) {
+    return filePath.split(/[\\/]+/).some((segment) => UNTRUSTED_SEGMENTS.has(segment));
+}
+function hasUntrustedWorkspaceSegment(projectRoot, filePath) {
+    const relativePath = relative(projectRoot, filePath);
+    if (!relativePath || relativePath.startsWith("..")) {
+        return hasUntrustedSegment(filePath);
+    }
+    return relativePath.split(/[\\/]+/).some((segment) => UNTRUSTED_SEGMENTS.has(segment));
+}
+export async function discoverAgentInstructionCandidates(cwd, maxChars, options = {}) {
+    const root = findProjectRoot(cwd);
+    const dirs = [];
+    let cursor = resolve(cwd);
+    while (true) {
+        dirs.push(cursor);
+        if (cursor === root)
+            break;
+        const next = dirname(cursor);
+        if (next === cursor)
+            break;
+        cursor = next;
+    }
+    const candidates = [];
+    let remaining = maxChars;
+    const homeCandidates = [
+        join(homedir(), ".pulseed", "AGENTS.md"),
+        join(homedir(), ".pulseed", "AGENTS.override.md"),
+    ];
+    for (const filePath of homeCandidates) {
+        if (!existsSync(filePath) || remaining <= 0)
+            continue;
+        const content = (await readFile(filePath, "utf-8")).slice(0, remaining);
+        remaining -= content.length;
+        candidates.push({
+            filePath,
+            content,
+            priority: filePath.endsWith("override.md") ? 1 : 2,
+            trusted: true,
+            accepted: true,
+        });
+    }
+    for (const dir of dirs.reverse()) {
+        const projectCandidates = [join(dir, "AGENTS.md"), join(dir, "AGENTS.override.md")];
+        for (const filePath of projectCandidates) {
+            if (!existsSync(filePath) || remaining <= 0)
+                continue;
+            const trusted = options.trustProjectInstructions !== false && !hasUntrustedWorkspaceSegment(root, filePath);
+            const content = (await readFile(filePath, "utf-8")).slice(0, remaining);
+            remaining -= content.length;
+            candidates.push({
+                filePath,
+                content,
+                priority: filePath.endsWith("override.md") ? 3 : 5,
+                trusted,
+                accepted: trusted,
+                reason: trusted
+                    ? undefined
+                    : options.trustProjectInstructions === false
+                        ? "project instructions disabled by execution policy"
+                        : "untrusted path segment",
+            });
+        }
+    }
+    return candidates.sort((a, b) => a.priority - b.priority || a.filePath.localeCompare(b.filePath));
+}
+export const repoInstructionsProvider = {
+    key: "repo_instructions",
+    kind: "dynamic",
+    async build(context) {
+        const cwd = context.request.workspaceRoot ?? process.cwd();
+        const candidates = await discoverAgentInstructionCandidates(cwd, context.profile.budgets.maxRepoInstructionChars, { trustProjectInstructions: context.request.trustProjectInstructions });
+        const accepted = candidates.filter((candidate) => candidate.accepted);
+        const rejected = candidates.filter((candidate) => !candidate.accepted);
+        for (const candidate of rejected) {
+            context.warnings.push(`Rejected repo instructions from ${candidate.filePath}: ${candidate.reason ?? "untrusted"}`);
+        }
+        if (accepted.length > 1) {
+            context.warnings.push("Multiple repo instruction files accepted; higher-precedence entries appear first.");
+        }
+        const sources = candidates.map((candidate) => makeSource("repo_instructions", candidate.filePath, {
+            type: "file",
+            path: candidate.filePath,
+            trusted: candidate.trusted,
+            accepted: candidate.accepted,
+            metadata: candidate.reason ? { reason: candidate.reason } : undefined,
+        }));
+        const content = accepted.length > 0
+            ? accepted.map((candidate) => `[${candidate.filePath}]\n${candidate.content}`).join("\n\n")
+            : "No trusted repository instructions available.";
+        return makeSection("repo_instructions", content, sources.length > 0 ? sources : [
+            makeSource("repo_instructions", "repo instructions", {
+                type: "none",
+                trusted: true,
+                accepted: true,
+            }),
+        ]);
+    },
+};
+//# sourceMappingURL=agents-provider.js.map

package/dist/grounding/providers/agents-provider.js.map

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

package/dist/grounding/providers/goal-state-provider.d.ts

@@ -0,0 +1,3 @@
+import type { GroundingProvider } from "../contracts.js";
+export declare const goalStateProvider: GroundingProvider;
+//# sourceMappingURL=goal-state-provider.d.ts.map

package/dist/grounding/providers/goal-state-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-state-provider.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/goal-state-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAQzD,eAAO,MAAM,iBAAiB,EAAE,iBAkC/B,CAAC"}

package/dist/grounding/providers/goal-state-provider.js

@@ -0,0 +1,34 @@
+import { makeSection, makeSource } from "./helpers.js";
+function formatGoal(goalId, goal) {
+    const loopStatus = goal.loop_status && goal.loop_status !== "idle" ? ` [${goal.loop_status}]` : "";
+    return `- ${goal.title} (${goalId})${loopStatus} - status: ${goal.status}`;
+}
+export const goalStateProvider = {
+    key: "goal_state",
+    kind: "dynamic",
+    async build(context) {
+        const stateManager = context.deps.stateManager;
+        if (!stateManager) {
+            return null;
+        }
+        const ids = await stateManager.listGoalIds();
+        const focusedIds = context.request.goalId && ids.includes(context.request.goalId)
+            ? [context.request.goalId, ...ids.filter((id) => id !== context.request.goalId)]
+            : ids;
+        const limitedIds = focusedIds.slice(0, context.profile.budgets.maxGoalCount);
+        const goals = await Promise.all(limitedIds.map(async (id) => await stateManager.loadGoal(id)));
+        const lines = goals
+            .map((goal, index) => (goal ? formatGoal(limitedIds[index], goal) : null))
+            .filter((line) => Boolean(line));
+        const content = lines.length > 0 ? lines.join("\n") : "No goals configured yet.";
+        return makeSection("goal_state", content, [
+            makeSource("goal_state", "stateManager.listGoalIds", {
+                type: lines.length > 0 ? "state" : "none",
+                trusted: true,
+                accepted: true,
+                retrievalId: lines.length > 0 ? `goals:${limitedIds.join(",")}` : "none:goal_state",
+            }),
+        ], { title: "Current Goals" });
+    },
+};
+//# sourceMappingURL=goal-state-provider.js.map

package/dist/grounding/providers/goal-state-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-state-provider.js","sourceRoot":"","sources":["../../../src/grounding/providers/goal-state-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvD,SAAS,UAAU,CAAC,MAAc,EAAE,IAAU;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnG,OAAO,KAAK,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,UAAU,cAAc,IAAI,CAAC,MAAM,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QAC/C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YAC/E,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChF,CAAC,CAAC,GAAG,CAAC;QACR,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/F,MAAM,KAAK,GAAG,KAAK;aAChB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC1E,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC;QAEjF,OAAO,WAAW,CAChB,YAAY,EACZ,OAAO,EACP;YACE,UAAU,CAAC,YAAY,EAAE,0BAA0B,EAAE;gBACnD,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;gBACzC,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB;aACpF,CAAC;SACH,EACD,EAAE,KAAK,EAAE,eAAe,EAAE,CAC3B,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/grounding/providers/helpers.d.ts

@@ -0,0 +1,13 @@
+import type { GroundingSection, GroundingSectionKey, GroundingSourceRef } from "../contracts.js";
+export declare function estimateTokens(content: string): number;
+export declare function makeSection(key: GroundingSectionKey, content: string, sources: GroundingSourceRef[], overrides?: Partial<Pick<GroundingSection, "title" | "priority">>): GroundingSection;
+export declare function makeSource(sectionKey: GroundingSectionKey, label: string, overrides?: Partial<GroundingSourceRef>): GroundingSourceRef;
+export declare function sortSections<T extends GroundingSection>(sections: T[]): T[];
+export declare function resolveHomeDir(homeDir?: string): string;
+export declare function resolveStateManagerBaseDir(stateManager?: {
+    getBaseDir?: () => string;
+}): string | undefined;
+export declare function readJsonFile(filePath: string): Promise<Record<string, unknown> | null>;
+export declare function listDirectoryNames(dirPath: string): Promise<string[]>;
+export declare function soilRootFromHome(homeDir: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/grounding/providers/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAsCjG,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAAE,EAC7B,SAAS,GAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,CAAC,CAAM,GACpE,gBAAgB,CASlB;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,kBAAkB,CAWpB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAE3E;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,0BAA0B,CAAC,YAAY,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAE3G;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAO5F;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAO3E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/grounding/providers/helpers.js

@@ -0,0 +1,93 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { getPulseedDirPath } from "../../base/utils/paths.js";
+const SECTION_TITLES = {
+    identity: "Identity",
+    execution_policy: "Execution Policy",
+    approval_policy: "Approval Policy",
+    trust_state: "Trust State",
+    repo_instructions: "Repository Instructions",
+    goal_state: "Goal State",
+    task_state: "Task State",
+    progress_history: "Progress History",
+    session_history: "Session History",
+    soil_knowledge: "Soil Knowledge",
+    knowledge_query: "Knowledge Query",
+    lessons: "Lessons",
+    provider_state: "Provider State",
+    plugins: "Plugins",
+    workspace_facts: "Workspace Facts",
+};
+const SECTION_PRIORITIES = {
+    identity: 10,
+    execution_policy: 20,
+    approval_policy: 30,
+    repo_instructions: 40,
+    trust_state: 50,
+    provider_state: 60,
+    plugins: 70,
+    goal_state: 80,
+    task_state: 90,
+    session_history: 100,
+    progress_history: 110,
+    workspace_facts: 120,
+    soil_knowledge: 130,
+    knowledge_query: 140,
+    lessons: 150,
+};
+export function estimateTokens(content) {
+    return Math.max(1, Math.ceil(content.length / 4));
+}
+export function makeSection(key, content, sources, overrides = {}) {
+    return {
+        key,
+        title: overrides.title ?? SECTION_TITLES[key],
+        priority: overrides.priority ?? SECTION_PRIORITIES[key],
+        estimatedTokens: estimateTokens(content),
+        content,
+        sources,
+    };
+}
+export function makeSource(sectionKey, label, overrides = {}) {
+    return {
+        sectionKey,
+        type: overrides.type ?? "derived",
+        label,
+        ...(overrides.path ? { path: overrides.path } : {}),
+        ...(overrides.trusted !== undefined ? { trusted: overrides.trusted } : {}),
+        ...(overrides.accepted !== undefined ? { accepted: overrides.accepted } : {}),
+        ...(overrides.retrievalId ? { retrievalId: overrides.retrievalId } : {}),
+        ...(overrides.metadata ? { metadata: overrides.metadata } : {}),
+    };
+}
+export function sortSections(sections) {
+    return [...sections].sort((a, b) => a.priority - b.priority || a.title.localeCompare(b.title));
+}
+export function resolveHomeDir(homeDir) {
+    return homeDir ?? getPulseedDirPath();
+}
+export function resolveStateManagerBaseDir(stateManager) {
+    return typeof stateManager?.getBaseDir === "function" ? stateManager.getBaseDir() : undefined;
+}
+export async function readJsonFile(filePath) {
+    try {
+        const raw = await fsp.readFile(filePath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function listDirectoryNames(dirPath) {
+    try {
+        const entries = await fsp.readdir(dirPath, { withFileTypes: true });
+        return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+}
+export function soilRootFromHome(homeDir) {
+    return path.join(homeDir, "soil");
+}
+//# sourceMappingURL=helpers.js.map

package/dist/grounding/providers/helpers.js.map

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

package/dist/grounding/providers/knowledge-provider.d.ts

@@ -0,0 +1,3 @@
+import type { GroundingProvider } from "../contracts.js";
+export declare const knowledgeQueryProvider: GroundingProvider;
+//# sourceMappingURL=knowledge-provider.d.ts.map

package/dist/grounding/providers/knowledge-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-provider.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/knowledge-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGnF,eAAO,MAAM,sBAAsB,EAAE,iBAmDpC,CAAC"}

package/dist/grounding/providers/knowledge-provider.js

@@ -0,0 +1,49 @@
+import { makeSection, makeSource } from "./helpers.js";
+export const knowledgeQueryProvider = {
+    key: "knowledge_query",
+    kind: "dynamic",
+    async build(context) {
+        const query = context.request.query ?? context.request.userMessage;
+        if (!query?.trim()) {
+            return null;
+        }
+        const soilHitCount = Number(context.runtime.get("soil_hit_count") ?? 0);
+        if (soilHitCount > 0 && !context.request.knowledgeContext?.trim()) {
+            return null;
+        }
+        let result = null;
+        if (context.request.knowledgeContext?.trim()) {
+            result = {
+                retrievalId: "knowledge:prefetched",
+                items: [
+                    {
+                        id: "knowledge:prefetched",
+                        content: context.request.knowledgeContext.trim(),
+                        source: "request.knowledgeContext",
+                    },
+                ],
+            };
+        }
+        else if (context.request.knowledgeQuery) {
+            result = await context.request.knowledgeQuery({
+                query,
+                goalId: context.request.goalId,
+                limit: context.profile.budgets.maxKnowledgeHits,
+            });
+        }
+        const items = result?.items ?? [];
+        context.runtime.set("knowledge_hit_count", items.length);
+        return makeSection("knowledge_query", items.length > 0
+            ? items.slice(0, context.profile.budgets.maxKnowledgeHits).map((item) => `- ${item.content}`).join("\n")
+            : "No broader knowledge results.", [
+            makeSource("knowledge_query", "knowledge query", {
+                type: items.length > 0 ? "tool" : "none",
+                trusted: true,
+                accepted: true,
+                retrievalId: items.length > 0 ? result?.retrievalId ?? "knowledge:query" : "none:knowledge_query",
+                metadata: result?.warnings ? { warnings: result.warnings } : undefined,
+            }),
+        ]);
+    },
+};
+//# sourceMappingURL=knowledge-provider.js.map

package/dist/grounding/providers/knowledge-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-provider.js","sourceRoot":"","sources":["../../../src/grounding/providers/knowledge-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,GAAG,EAAE,iBAAiB;IACtB,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;QACnE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,IAAI,YAAY,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,GAAoC,IAAI,CAAC;QACnD,IAAI,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,GAAG;gBACP,WAAW,EAAE,sBAAsB;gBACnC,KAAK,EAAE;oBACL;wBACE,EAAE,EAAE,sBAAsB;wBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE;wBAChD,MAAM,EAAE,0BAA0B;qBACnC;iBACF;aACF,CAAC;QACJ,CAAC;aAAM,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC1C,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;gBAC5C,KAAK;gBACL,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;gBAC9B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB;aAChD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,WAAW,CAChB,iBAAiB,EACjB,KAAK,CAAC,MAAM,GAAG,CAAC;YACd,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACxG,CAAC,CAAC,+BAA+B,EACnC;YACE,UAAU,CAAC,iBAAiB,EAAE,iBAAiB,EAAE;gBAC/C,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBACxC,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,IAAI,iBAAiB,CAAC,CAAC,CAAC,sBAAsB;gBACjG,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;aACvE,CAAC;SACH,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/grounding/providers/lessons-provider.d.ts

@@ -0,0 +1,3 @@
+import type { GroundingProvider } from "../contracts.js";
+export declare const lessonsProvider: GroundingProvider;
+//# sourceMappingURL=lessons-provider.d.ts.map

package/dist/grounding/providers/lessons-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lessons-provider.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/lessons-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,eAAO,MAAM,eAAe,EAAE,iBAqC7B,CAAC"}

package/dist/grounding/providers/lessons-provider.js

@@ -0,0 +1,36 @@
+import { makeSection, makeSource } from "./helpers.js";
+export const lessonsProvider = {
+    key: "lessons",
+    kind: "dynamic",
+    async build(context) {
+        const query = context.request.query ?? context.request.userMessage;
+        if (!query?.trim() || !context.request.lessonsQuery) {
+            return null;
+        }
+        const result = await context.request.lessonsQuery({
+            query,
+            goalId: context.request.goalId,
+            limit: context.profile.budgets.maxKnowledgeHits,
+        });
+        const items = result?.items ?? [];
+        if (items.length === 0) {
+            return makeSection("lessons", "No lesson snippets matched.", [
+                makeSource("lessons", "lessons query", {
+                    type: "none",
+                    trusted: true,
+                    accepted: true,
+                    retrievalId: "none:lessons",
+                }),
+            ]);
+        }
+        return makeSection("lessons", items.map((item) => `- ${item.content}`).join("\n"), [
+            makeSource("lessons", "lessons query", {
+                type: "derived",
+                trusted: true,
+                accepted: true,
+                retrievalId: "lessons:query",
+            }),
+        ]);
+    },
+};
+//# sourceMappingURL=lessons-provider.js.map

package/dist/grounding/providers/lessons-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lessons-provider.js","sourceRoot":"","sources":["../../../src/grounding/providers/lessons-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;QACnE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;YAChD,KAAK;YACL,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;YAC9B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB;SAChD,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,WAAW,CAAC,SAAS,EAAE,6BAA6B,EAAE;gBAC3D,UAAU,CAAC,SAAS,EAAE,eAAe,EAAE;oBACrC,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,cAAc;iBAC5B,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,WAAW,CAChB,SAAS,EACT,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EACnD;YACE,UAAU,CAAC,SAAS,EAAE,eAAe,EAAE;gBACrC,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,eAAe;aAC7B,CAAC;SACH,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/grounding/providers/plugins-provider.d.ts

@@ -0,0 +1,3 @@
+import type { GroundingProvider } from "../contracts.js";
+export declare const pluginsProvider: GroundingProvider;
+//# sourceMappingURL=plugins-provider.d.ts.map

package/dist/grounding/providers/plugins-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins-provider.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/plugins-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,eAAO,MAAM,eAAe,EAAE,iBAsC7B,CAAC"}

package/dist/grounding/providers/plugins-provider.js

@@ -0,0 +1,35 @@
+import * as path from "node:path";
+import { listDirectoryNames, makeSection, makeSource, resolveHomeDir } from "./helpers.js";
+export const pluginsProvider = {
+    key: "plugins",
+    kind: "dynamic",
+    async build(context) {
+        let plugins = [];
+        const homeDir = resolveHomeDir(context.request.homeDir ?? context.deps.stateManager?.getBaseDir?.());
+        const pluginsDir = path.join(homeDir, "plugins");
+        if (context.deps.pluginLoader) {
+            try {
+                const loaded = await context.deps.pluginLoader.loadAll();
+                plugins = loaded
+                    .filter((plugin) => plugin.enabled !== false)
+                    .map((plugin) => plugin.name)
+                    .sort((a, b) => a.localeCompare(b));
+            }
+            catch (error) {
+                context.warnings.push(`plugins provider failed to load plugin metadata: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        if (plugins.length === 0) {
+            plugins = (await listDirectoryNames(pluginsDir)).sort((a, b) => a.localeCompare(b));
+        }
+        return makeSection("plugins", `Installed: ${plugins.length > 0 ? plugins.join(", ") : "none"}`, [
+            makeSource("plugins", "plugins directory", {
+                type: plugins.length > 0 ? "file" : "none",
+                path: pluginsDir,
+                trusted: true,
+                accepted: true,
+            }),
+        ], { title: "Installed Plugins" });
+    },
+};
+//# sourceMappingURL=plugins-provider.js.map

package/dist/grounding/providers/plugins-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins-provider.js","sourceRoot":"","sources":["../../../src/grounding/providers/plugins-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3F,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,GAAG,EAAE,SAAS;IACd,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,IAAI,OAAO,GAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QACrG,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAEjD,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBACzD,OAAO,GAAG,MAAM;qBACb,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC;qBAC5C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;qBAC5B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,oDAAoD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtI,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,CAAC;QAED,OAAO,WAAW,CAChB,SAAS,EACT,cAAc,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAChE;YACE,UAAU,CAAC,SAAS,EAAE,mBAAmB,EAAE;gBACzC,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBAC1C,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;aACf,CAAC;SACH,EACD,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAC/B,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/grounding/providers/progress-history-provider.d.ts

@@ -0,0 +1,3 @@
+import type { GroundingProvider } from "../contracts.js";
+export declare const progressHistoryProvider: GroundingProvider;
+//# sourceMappingURL=progress-history-provider.d.ts.map

package/dist/grounding/providers/progress-history-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-history-provider.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/progress-history-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,eAAO,MAAM,uBAAuB,EAAE,iBAiCrC,CAAC"}

package/dist/grounding/providers/progress-history-provider.js

@@ -0,0 +1,30 @@
+import { makeSection, makeSource } from "./helpers.js";
+export const progressHistoryProvider = {
+    key: "progress_history",
+    kind: "dynamic",
+    async build(context) {
+        const stateManager = context.deps.stateManager;
+        const goalId = context.request.goalId;
+        if (!stateManager || !goalId) {
+            return null;
+        }
+        const entries = await stateManager.loadGapHistory(goalId);
+        const limited = entries.slice(-context.profile.budgets.maxProgressEntries);
+        const lines = limited.map((entry) => {
+            const gaps = entry.gap_vector
+                .slice(0, 3)
+                .map((gap) => `${gap.dimension_name}=${gap.normalized_weighted_gap.toFixed(2)}`)
+                .join(", ");
+            return `- iteration ${entry.iteration} @ ${entry.timestamp}: ${gaps || "no dimensions"}`;
+        });
+        return makeSection("progress_history", lines.length > 0 ? lines.join("\n") : "No progress history available.", [
+            makeSource("progress_history", "gap history", {
+                type: lines.length > 0 ? "state" : "none",
+                trusted: true,
+                accepted: true,
+                retrievalId: lines.length > 0 ? `progress:${goalId}` : "none:progress_history",
+            }),
+        ]);
+    },
+};
+//# sourceMappingURL=progress-history-provider.js.map

package/dist/grounding/providers/progress-history-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-history-provider.js","sourceRoot":"","sources":["../../../src/grounding/providers/progress-history-provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,GAAG,EAAE,kBAAkB;IACvB,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QACtC,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAClC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU;iBAC1B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/E,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,eAAe,KAAK,CAAC,SAAS,MAAM,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,eAAe,EAAE,CAAC;QAC3F,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAChB,kBAAkB,EAClB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gCAAgC,EACtE;YACE,UAAU,CAAC,kBAAkB,EAAE,aAAa,EAAE;gBAC5C,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;gBACzC,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC,uBAAuB;aAC/E,CAAC;SACH,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/grounding/providers/provider-state-provider.d.ts

@@ -0,0 +1,3 @@
+import type { GroundingProvider } from "../contracts.js";
+export declare const providerStateProvider: GroundingProvider;
+//# sourceMappingURL=provider-state-provider.d.ts.map

package/dist/grounding/providers/provider-state-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-state-provider.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/provider-state-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAczD,eAAO,MAAM,qBAAqB,EAAE,iBAgBnC,CAAC"}

package/dist/grounding/providers/provider-state-provider.js

@@ -0,0 +1,32 @@
+import * as path from "node:path";
+import { makeSection, makeSource, readJsonFile, resolveHomeDir } from "./helpers.js";
+function summarizeProviderState(raw) {
+    if (!raw) {
+        return "not configured";
+    }
+    const llm = typeof raw["llm"] === "string" ? raw["llm"] : null;
+    const adapter = typeof raw["default_adapter"] === "string" ? raw["default_adapter"] : null;
+    if (llm && adapter)
+        return `${llm} / ${adapter}`;
+    if (llm)
+        return llm;
+    return "not configured";
+}
+export const providerStateProvider = {
+    key: "provider_state",
+    kind: "dynamic",
+    async build(context) {
+        const homeDir = resolveHomeDir(context.request.homeDir ?? context.deps.stateManager?.getBaseDir?.());
+        const providerPath = path.join(homeDir, "provider.json");
+        const raw = await readJsonFile(providerPath);
+        return makeSection("provider_state", summarizeProviderState(raw), [
+            makeSource("provider_state", "provider.json", {
+                type: raw ? "file" : "none",
+                path: providerPath,
+                trusted: true,
+                accepted: true,
+            }),
+        ], { title: "Provider" });
+    },
+};
+//# sourceMappingURL=provider-state-provider.js.map

package/dist/grounding/providers/provider-state-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-state-provider.js","sourceRoot":"","sources":["../../../src/grounding/providers/provider-state-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAErF,SAAS,sBAAsB,CAAC,GAAmC;IACjE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,iBAAiB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,IAAI,GAAG,IAAI,OAAO;QAAE,OAAO,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;IACjD,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,GAAG,EAAE,gBAAgB;IACrB,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QACrG,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;QAC7C,OAAO,WAAW,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,GAAG,CAAC,EAAE;YAChE,UAAU,CAAC,gBAAgB,EAAE,eAAe,EAAE;gBAC5C,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBAC3B,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;aACf,CAAC;SACH,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC"}

package/dist/grounding/providers/session-history-provider.d.ts

@@ -0,0 +1,3 @@
+import type { GroundingProvider } from "../contracts.js";
+export declare const sessionHistoryProvider: GroundingProvider;
+//# sourceMappingURL=session-history-provider.d.ts.map

package/dist/grounding/providers/session-history-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-history-provider.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/session-history-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAS3E,eAAO,MAAM,sBAAsB,EAAE,iBAwEpC,CAAC"}