pulseed 0.4.20 → 0.5.1

package/dist/grounding/contracts.d.ts

@@ -0,0 +1,160 @@
+import type { StateManager } from "../base/state/state-manager.js";
+export type GroundingSurface = "chat" | "agent_loop" | "core_loop";
+export type GroundingPurpose = "general_turn" | "task_execution" | "replanning" | "verification" | "knowledge_refresh" | "handoff";
+export type GroundingProfileId = "chat/general_turn" | "chat/handoff" | "agent_loop/task_execution" | "core_loop/verification";
+export type GroundingSectionKey = "identity" | "execution_policy" | "approval_policy" | "trust_state" | "repo_instructions" | "goal_state" | "task_state" | "progress_history" | "session_history" | "soil_knowledge" | "knowledge_query" | "lessons" | "provider_state" | "plugins" | "workspace_facts";
+export interface GroundingSection {
+    key: GroundingSectionKey;
+    title: string;
+    priority: number;
+    estimatedTokens: number;
+    content: string;
+    sources: GroundingSourceRef[];
+}
+export interface GroundingSourceRef {
+    sectionKey: GroundingSectionKey;
+    type: "file" | "state" | "tool" | "derived" | "none";
+    label: string;
+    path?: string;
+    trusted?: boolean;
+    accepted?: boolean;
+    retrievalId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface GroundingBundleMetrics {
+    totalEstimatedTokens: number;
+    buildMs: number;
+    cacheHits: number;
+}
+export interface GroundingBundleTraces {
+    source: GroundingSourceRef[];
+    retrievalIds: string[];
+}
+export interface GroundingBundle {
+    profile: GroundingProfileId;
+    staticSections: GroundingSection[];
+    dynamicSections: GroundingSection[];
+    warnings: string[];
+    metrics: GroundingBundleMetrics;
+    traces: GroundingBundleTraces;
+    render(format?: "prompt" | "debug-json"): string | Record<string, unknown>;
+}
+export interface GroundingInclusionPolicy {
+    identity: boolean;
+    execution_policy: boolean;
+    approval_policy: boolean;
+    trust_state: boolean;
+    repo_instructions: boolean;
+    goal_state: boolean;
+    task_state: boolean;
+    progress_history: boolean;
+    session_history: boolean;
+    soil_knowledge: boolean;
+    knowledge_query: boolean;
+    lessons: boolean;
+    provider_state: boolean;
+    plugins: boolean;
+    workspace_facts: boolean;
+}
+export interface GroundingProfileBudgets {
+    maxTokens: number;
+    maxGoalCount: number;
+    maxTaskCount: number;
+    maxHistoryMessages: number;
+    maxProgressEntries: number;
+    maxKnowledgeHits: number;
+    maxRepoInstructionChars: number;
+}
+export interface GroundingProfile {
+    id: GroundingProfileId;
+    surface: GroundingSurface;
+    purpose: GroundingPurpose;
+    include: GroundingInclusionPolicy;
+    budgets: GroundingProfileBudgets;
+}
+export interface GroundingMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export interface GroundingSoilHit {
+    soilId: string;
+    title: string;
+    summary?: string | null;
+    snippet?: string;
+    score?: number;
+}
+export interface GroundingSoilResult {
+    retrievalSource: "sqlite" | "index" | "manifest" | "prefetch";
+    warnings: string[];
+    hits: GroundingSoilHit[];
+}
+export interface GroundingKnowledgeItem {
+    id: string;
+    content: string;
+    source: string;
+    confidence?: number;
+    relevance?: number;
+}
+export interface GroundingKnowledgeResult {
+    retrievalId?: string;
+    warnings?: string[];
+    items: GroundingKnowledgeItem[];
+}
+export interface GroundingLessonResult {
+    items: GroundingKnowledgeItem[];
+}
+export interface GroundingRequest {
+    surface: GroundingSurface;
+    purpose: GroundingPurpose;
+    workspaceRoot?: string;
+    goalId?: string;
+    taskId?: string;
+    query?: string;
+    userMessage?: string;
+    maxTokens?: number;
+    include?: Partial<GroundingInclusionPolicy>;
+    homeDir?: string;
+    trustProjectInstructions?: boolean;
+    workspaceContext?: string;
+    knowledgeContext?: string;
+    recentMessages?: GroundingMessage[];
+    compactionSummary?: string;
+    soilQuery?: (input: {
+        query: string;
+        rootDir: string;
+        limit: number;
+    }) => Promise<GroundingSoilResult | null>;
+    knowledgeQuery?: (input: {
+        query: string;
+        goalId?: string;
+        limit: number;
+    }) => Promise<GroundingKnowledgeResult | null>;
+    lessonsQuery?: (input: {
+        query: string;
+        goalId?: string;
+        limit: number;
+    }) => Promise<GroundingLessonResult | null>;
+}
+export interface GroundingGatewayDeps {
+    stateManager?: StateManager;
+    pluginLoader?: {
+        loadAll(): Promise<Array<{
+            name: string;
+            enabled?: boolean;
+            error?: string | null;
+        }>>;
+    };
+}
+export interface GroundingProviderContext {
+    deps: GroundingGatewayDeps;
+    profile: GroundingProfile;
+    request: GroundingRequest;
+    warnings: string[];
+    runtime: Map<string, unknown>;
+}
+export interface GroundingProvider {
+    key: GroundingSectionKey;
+    kind: "static" | "dynamic";
+    build(context: GroundingProviderContext): Promise<GroundingSection | null>;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/grounding/contracts.d.ts.map

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

package/dist/grounding/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/grounding/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/grounding/contracts.ts"],"names":[],"mappings":""}

package/dist/grounding/gateway.d.ts

@@ -0,0 +1,12 @@
+import type { GroundingBundle, GroundingGatewayDeps, GroundingRequest } from "./contracts.js";
+export interface GroundingGateway {
+    build(request: GroundingRequest): Promise<GroundingBundle>;
+}
+export declare class DefaultGroundingGateway implements GroundingGateway {
+    private readonly deps;
+    private readonly staticCache;
+    constructor(deps?: GroundingGatewayDeps);
+    build(request: GroundingRequest): Promise<GroundingBundle>;
+}
+export declare function createGroundingGateway(deps?: GroundingGatewayDeps): GroundingGateway;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/grounding/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/grounding/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAEpB,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AAqCxB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D;AAMD,qBAAa,uBAAwB,YAAW,gBAAgB;IAGlD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;gBAExC,IAAI,GAAE,oBAAyB;IAEtD,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAwEjE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,oBAAyB,GAAG,gBAAgB,CAExF"}

package/dist/grounding/gateway.js

@@ -0,0 +1,116 @@
+import { resolveGroundingProfile } from "./profiles.js";
+import { renderDebugBundle } from "./renderers/debug-renderer.js";
+import { renderPromptBundle } from "./renderers/prompt-renderer.js";
+import { approvalPolicyProvider, executionPolicyProvider, identityProvider } from "./providers/static-policy-provider.js";
+import { providerStateProvider } from "./providers/provider-state-provider.js";
+import { pluginsProvider } from "./providers/plugins-provider.js";
+import { goalStateProvider } from "./providers/goal-state-provider.js";
+import { taskStateProvider } from "./providers/task-state-provider.js";
+import { trustStateProvider } from "./providers/trust-state-provider.js";
+import { sessionHistoryProvider } from "./providers/session-history-provider.js";
+import { progressHistoryProvider } from "./providers/progress-history-provider.js";
+import { soilKnowledgeProvider } from "./providers/soil-provider.js";
+import { knowledgeQueryProvider } from "./providers/knowledge-provider.js";
+import { lessonsProvider } from "./providers/lessons-provider.js";
+import { repoInstructionsProvider } from "./providers/agents-provider.js";
+import { workspaceFactsProvider } from "./providers/workspace-facts-provider.js";
+import { sortSections } from "./providers/helpers.js";
+const PROVIDERS = [
+    identityProvider,
+    executionPolicyProvider,
+    approvalPolicyProvider,
+    trustStateProvider,
+    repoInstructionsProvider,
+    goalStateProvider,
+    taskStateProvider,
+    progressHistoryProvider,
+    sessionHistoryProvider,
+    soilKnowledgeProvider,
+    knowledgeQueryProvider,
+    lessonsProvider,
+    providerStateProvider,
+    pluginsProvider,
+    workspaceFactsProvider,
+];
+function cloneSections(sections) {
+    return sections.map((section) => ({ ...section, sources: section.sources.map((source) => ({ ...source })) }));
+}
+export class DefaultGroundingGateway {
+    deps;
+    staticCache = new Map();
+    constructor(deps = {}) {
+        this.deps = deps;
+    }
+    async build(request) {
+        const started = Date.now();
+        const profile = resolveGroundingProfile(request);
+        const warnings = [];
+        const runtime = new Map();
+        let cacheHits = 0;
+        const staticCacheKey = JSON.stringify({
+            profile: profile.id,
+            include: {
+                identity: profile.include.identity,
+                execution_policy: profile.include.execution_policy,
+                approval_policy: profile.include.approval_policy,
+            },
+        });
+        let staticSections = this.staticCache.get(staticCacheKey);
+        if (staticSections) {
+            cacheHits += 1;
+            staticSections = cloneSections(staticSections);
+        }
+        else {
+            const context = { deps: this.deps, profile, request, warnings, runtime };
+            staticSections = [];
+            for (const provider of PROVIDERS.filter((candidate) => candidate.kind === "static")) {
+                if (!profile.include[provider.key])
+                    continue;
+                const section = await provider.build(context);
+                if (section)
+                    staticSections.push(section);
+            }
+            this.staticCache.set(staticCacheKey, cloneSections(staticSections));
+        }
+        const context = { deps: this.deps, profile, request, warnings, runtime };
+        const dynamicSections = [];
+        for (const provider of PROVIDERS.filter((candidate) => candidate.kind === "dynamic")) {
+            if (!profile.include[provider.key])
+                continue;
+            const section = await provider.build(context);
+            if (section) {
+                dynamicSections.push(section);
+            }
+        }
+        const orderedStatic = sortSections(staticSections);
+        const orderedDynamic = sortSections(dynamicSections);
+        const allSections = [...orderedStatic, ...orderedDynamic];
+        const totalEstimatedTokens = allSections.reduce((sum, section) => sum + section.estimatedTokens, 0);
+        const retrievalIds = allSections.flatMap((section) => section.sources
+            .map((source) => source.retrievalId)
+            .filter((retrievalId) => typeof retrievalId === "string"));
+        const bundle = {
+            profile: profile.id,
+            staticSections: orderedStatic,
+            dynamicSections: orderedDynamic,
+            warnings,
+            metrics: {
+                totalEstimatedTokens,
+                buildMs: Date.now() - started,
+                cacheHits,
+            },
+            traces: {
+                source: allSections.flatMap((section) => section.sources),
+                retrievalIds,
+            },
+            render(format = "prompt") {
+                return format === "debug-json" ? renderDebugBundle(bundle) : renderPromptBundle(bundle);
+            },
+        };
+        return bundle;
+    }
+}
+export function createGroundingGateway(deps = {}) {
+    return new DefaultGroundingGateway(deps);
+}
+//# sourceMappingURL=gateway.js.map

package/dist/grounding/gateway.js.map

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

package/dist/grounding/profiles.d.ts

@@ -0,0 +1,4 @@
+import type { GroundingProfile, GroundingProfileId, GroundingRequest } from "./contracts.js";
+export declare function profileIdForRequest(request: GroundingRequest): GroundingProfileId;
+export declare function resolveGroundingProfile(request: GroundingRequest): GroundingProfile;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/grounding/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/grounding/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAwIxB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,kBAAkB,CAWjF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAanF"}

package/dist/grounding/profiles.js

@@ -0,0 +1,159 @@
+const allOff = () => ({
+    identity: false,
+    execution_policy: false,
+    approval_policy: false,
+    trust_state: false,
+    repo_instructions: false,
+    goal_state: false,
+    task_state: false,
+    progress_history: false,
+    session_history: false,
+    soil_knowledge: false,
+    knowledge_query: false,
+    lessons: false,
+    provider_state: false,
+    plugins: false,
+    workspace_facts: false,
+});
+const PROFILES = {
+    "chat/general_turn": {
+        id: "chat/general_turn",
+        surface: "chat",
+        purpose: "general_turn",
+        include: {
+            ...allOff(),
+            identity: true,
+            execution_policy: true,
+            approval_policy: true,
+            trust_state: true,
+            repo_instructions: true,
+            goal_state: true,
+            provider_state: true,
+            plugins: true,
+            soil_knowledge: true,
+        },
+        budgets: {
+            maxTokens: 2200,
+            maxGoalCount: 8,
+            maxTaskCount: 8,
+            maxHistoryMessages: 6,
+            maxProgressEntries: 5,
+            maxKnowledgeHits: 4,
+            maxRepoInstructionChars: 20_000,
+        },
+    },
+    "chat/handoff": {
+        id: "chat/handoff",
+        surface: "chat",
+        purpose: "handoff",
+        include: {
+            ...allOff(),
+            identity: true,
+            execution_policy: true,
+            approval_policy: true,
+            trust_state: true,
+            repo_instructions: true,
+            goal_state: true,
+            task_state: true,
+            progress_history: true,
+            session_history: true,
+            soil_knowledge: true,
+            knowledge_query: true,
+            lessons: true,
+            provider_state: true,
+            plugins: true,
+            workspace_facts: true,
+        },
+        budgets: {
+            maxTokens: 3200,
+            maxGoalCount: 8,
+            maxTaskCount: 10,
+            maxHistoryMessages: 10,
+            maxProgressEntries: 8,
+            maxKnowledgeHits: 5,
+            maxRepoInstructionChars: 24_000,
+        },
+    },
+    "agent_loop/task_execution": {
+        id: "agent_loop/task_execution",
+        surface: "agent_loop",
+        purpose: "task_execution",
+        include: {
+            ...allOff(),
+            identity: true,
+            execution_policy: true,
+            approval_policy: true,
+            repo_instructions: true,
+            soil_knowledge: true,
+            knowledge_query: true,
+            lessons: true,
+            workspace_facts: true,
+            task_state: true,
+            goal_state: true,
+        },
+        budgets: {
+            maxTokens: 2600,
+            maxGoalCount: 4,
+            maxTaskCount: 8,
+            maxHistoryMessages: 4,
+            maxProgressEntries: 4,
+            maxKnowledgeHits: 4,
+            maxRepoInstructionChars: 20_000,
+        },
+    },
+    "core_loop/verification": {
+        id: "core_loop/verification",
+        surface: "core_loop",
+        purpose: "verification",
+        include: {
+            ...allOff(),
+            identity: true,
+            execution_policy: true,
+            approval_policy: true,
+            trust_state: true,
+            repo_instructions: true,
+            goal_state: true,
+            task_state: true,
+            progress_history: true,
+            soil_knowledge: true,
+            knowledge_query: true,
+            workspace_facts: true,
+        },
+        budgets: {
+            maxTokens: 2600,
+            maxGoalCount: 4,
+            maxTaskCount: 8,
+            maxHistoryMessages: 4,
+            maxProgressEntries: 6,
+            maxKnowledgeHits: 4,
+            maxRepoInstructionChars: 16_000,
+        },
+    },
+};
+export function profileIdForRequest(request) {
+    if (request.surface === "chat" && request.purpose === "handoff") {
+        return "chat/handoff";
+    }
+    if (request.surface === "agent_loop" && request.purpose === "task_execution") {
+        return "agent_loop/task_execution";
+    }
+    if (request.surface === "core_loop" && request.purpose === "verification") {
+        return "core_loop/verification";
+    }
+    return "chat/general_turn";
+}
+export function resolveGroundingProfile(request) {
+    const base = PROFILES[profileIdForRequest(request)];
+    return {
+        ...base,
+        include: {
+            ...base.include,
+            ...(request.include ?? {}),
+        },
+        budgets: {
+            ...base.budgets,
+            ...(request.maxTokens ? { maxTokens: request.maxTokens } : {}),
+        },
+    };
+}
+//# sourceMappingURL=profiles.js.map

package/dist/grounding/profiles.js.map

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

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

@@ -0,0 +1,14 @@
+import type { GroundingProvider } from "../contracts.js";
+export interface AgentInstructionCandidate {
+    filePath: string;
+    content: string;
+    priority: number;
+    trusted: boolean;
+    accepted: boolean;
+    reason?: string;
+}
+export declare function discoverAgentInstructionCandidates(cwd: string, maxChars: number, options?: {
+    trustProjectInstructions?: boolean;
+}): Promise<AgentInstructionCandidate[]>;
+export declare const repoInstructionsProvider: GroundingProvider;
+//# sourceMappingURL=agents-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents-provider.d.ts","sourceRoot":"","sources":["../../../src/grounding/providers/agents-provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAsCD,wBAAsB,kCAAkC,CACtD,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAsDtC;AAED,eAAO,MAAM,wBAAwB,EAAE,iBA0CtC,CAAC"}

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