@michaelborck/honeyguide-core 0.6.0 → 0.7.0

package/dist/brief.js

@@ -0,0 +1,70 @@
+const PRIOR = {
+    none: 'Students have not encountered this topic yet.',
+    reading: 'Students have already done a reading on this topic.',
+    lecture: 'Students have already had a lecture on this topic.',
+    notes: 'Students have their own notes on this topic.',
+};
+const TIMING = {
+    'pre-class': 'This list is preparation before class.',
+    'in-class': 'This list will be used during class.',
+    'post-class': 'This list follows a class, for consolidation.',
+    assessment: 'This list is for assessment preparation.',
+};
+const STANCE = {
+    support: 'It should reinforce the current framing.',
+    challenge: 'It should challenge the current framing and surface disagreement.',
+    both: 'It should include both supporting material and counterpoints.',
+};
+/**
+ * Turn the interview answers into the fields the pipeline already understands:
+ * a counterpoint flag, search constraints and a teaching-context string.
+ */
+export function compileBrief(answers, currentYear = new Date().getFullYear()) {
+    const constraints = {};
+    if (answers.openAccessOnly)
+        constraints.openAccessOnly = true;
+    if (answers.noVideo)
+        constraints.excludeFormats = ['video'];
+    if (answers.recentOnly)
+        constraints.minYear = currentYear - 5;
+    const note = answers.priorNote?.trim();
+    const context = [
+        PRIOR[answers.priorKnowledge],
+        note || null,
+        TIMING[answers.timing],
+        STANCE[answers.stance],
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return {
+        counterpoint: answers.stance !== 'support',
+        constraints,
+        context,
+    };
+}
+/**
+ * Apply brief constraints to candidates before ranking. `openAccessOnly` is
+ * best-effort: only papers explicitly flagged as subscription are dropped;
+ * unknown access is kept (and labelled later).
+ */
+export function applyConstraints(candidates, constraints) {
+    if (!constraints)
+        return candidates;
+    const excluded = new Set(constraints.excludeFormats ?? []);
+    return candidates.filter((candidate) => {
+        if (excluded.has(candidate.format))
+            return false;
+        if (constraints.minYear !== undefined &&
+            candidate.year !== null &&
+            candidate.year < constraints.minYear) {
+            return false;
+        }
+        if (constraints.openAccessOnly &&
+            candidate.format === 'paper' &&
+            candidate.licensing === 'library-subscription') {
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=brief.js.map

package/dist/brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["../src/brief.ts"],"names":[],"mappings":"AAsBA,MAAM,KAAK,GAAmD;IAC5D,IAAI,EAAE,+CAA+C;IACrD,OAAO,EAAE,qDAAqD;IAC9D,OAAO,EAAE,oDAAoD;IAC7D,KAAK,EAAE,8CAA8C;CACtD,CAAC;AAEF,MAAM,MAAM,GAA2C;IACrD,WAAW,EAAE,wCAAwC;IACrD,UAAU,EAAE,sCAAsC;IAClD,YAAY,EAAE,+CAA+C;IAC7D,UAAU,EAAE,0CAA0C;CACvD,CAAC;AAEF,MAAM,MAAM,GAA2C;IACrD,OAAO,EAAE,0CAA0C;IACnD,SAAS,EAAE,mEAAmE;IAC9E,IAAI,EAAE,+DAA+D;CACtE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAqB,EACrB,cAAsB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAE9C,MAAM,WAAW,GAAsB,EAAE,CAAC;IAC1C,IAAI,OAAO,CAAC,cAAc;QAAE,WAAW,CAAC,cAAc,GAAG,IAAI,CAAC;IAC9D,IAAI,OAAO,CAAC,OAAO;QAAE,WAAW,CAAC,cAAc,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,UAAU;QAAE,WAAW,CAAC,OAAO,GAAG,WAAW,GAAG,CAAC,CAAC;IAE9D,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG;QACd,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;QAC7B,IAAI,IAAI,IAAI;QACZ,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QACtB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;KACvB;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS;QAC1C,WAAW;QACX,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAuB,EACvB,WAA+B;IAE/B,IAAI,CAAC,WAAW;QAAE,OAAO,UAAU,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IAC3D,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE;QACrC,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACjD,IACE,WAAW,CAAC,OAAO,KAAK,SAAS;YACjC,SAAS,CAAC,IAAI,KAAK,IAAI;YACvB,SAAS,CAAC,IAAI,GAAG,WAAW,CAAC,OAAO,EACpC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IACE,WAAW,CAAC,cAAc;YAC1B,SAAS,CAAC,MAAM,KAAK,OAAO;YAC5B,SAAS,CAAC,SAAS,KAAK,sBAAsB,EAC9C,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/collection.d.ts

@@ -0,0 +1,27 @@
+import type { Outcome, Resource, SuggestResult } from './types.js';
+/**
+ * Portable collection format (ADR-0014). A collection is a saved result list
+ * that can be reopened, rechecked and shared as a file — no server, accounts
+ * or permissions involved. The same document is what a future team backend
+ * would store, so the format is versioned from day one.
+ */
+export declare const COLLECTION_KIND = "honeyguide-collection";
+export declare const COLLECTION_SCHEMA_VERSION = 1;
+export interface CollectionFile {
+    kind: typeof COLLECTION_KIND;
+    schemaVersion: number;
+    topic: string;
+    /** ISO timestamp of when the list was generated. */
+    createdAt: string;
+    /** Unit outcomes the list was aligned to, when supplied (ADR-0017). */
+    outcomes?: Outcome[];
+    result: SuggestResult;
+}
+export declare function toCollectionFile(topic: string, result: SuggestResult, outcomes?: Outcome[], now?: Date): CollectionFile;
+/** Parse and validate a collection file; throws with a user-facing message. */
+export declare function parseCollectionFile(input: string | unknown): CollectionFile;
+/**
+ * Read resources from any saved Honeyguide JSON: a collection file, a legacy
+ * `suggest --json` result, or a batch output. Used by recheck.
+ */
+export declare function resourcesFromSaved(input: unknown): Resource[];

package/dist/collection.js

@@ -0,0 +1,98 @@
+/**
+ * Portable collection format (ADR-0014). A collection is a saved result list
+ * that can be reopened, rechecked and shared as a file — no server, accounts
+ * or permissions involved. The same document is what a future team backend
+ * would store, so the format is versioned from day one.
+ */
+export const COLLECTION_KIND = 'honeyguide-collection';
+export const COLLECTION_SCHEMA_VERSION = 1;
+export function toCollectionFile(topic, result, outcomes = [], now = new Date()) {
+    return {
+        kind: COLLECTION_KIND,
+        schemaVersion: COLLECTION_SCHEMA_VERSION,
+        topic: topic.trim(),
+        createdAt: now.toISOString(),
+        ...(outcomes.length ? { outcomes } : {}),
+        result: portable(result),
+    };
+}
+/**
+ * Collections are files people email to each other. Desktop screenshots are
+ * embedded data URLs and can be many megabytes, so they are dropped; ordinary
+ * http(s) thumbnail URLs are kept.
+ */
+function portable(result) {
+    return {
+        ...result,
+        resources: result.resources.map((resource) => ({
+            ...resource,
+            thumbnailUrl: resource.thumbnailUrl && !resource.thumbnailUrl.startsWith('data:')
+                ? resource.thumbnailUrl
+                : null,
+        })),
+    };
+}
+/** Parse and validate a collection file; throws with a user-facing message. */
+export function parseCollectionFile(input) {
+    let data = input;
+    if (typeof input === 'string') {
+        try {
+            data = JSON.parse(input);
+        }
+        catch {
+            throw new Error('Not valid JSON — expected a Honeyguide collection file.');
+        }
+    }
+    if (!data || typeof data !== 'object') {
+        throw new Error('Not a Honeyguide collection file.');
+    }
+    const obj = data;
+    if (obj.kind !== COLLECTION_KIND) {
+        throw new Error('Not a Honeyguide collection file.');
+    }
+    if (typeof obj.schemaVersion !== 'number') {
+        throw new Error('Collection file is missing its schema version.');
+    }
+    if (obj.schemaVersion > COLLECTION_SCHEMA_VERSION) {
+        throw new Error(`Collection schema v${obj.schemaVersion} is newer than this app supports (v${COLLECTION_SCHEMA_VERSION}). Update Honeyguide.`);
+    }
+    if (!obj.result || !Array.isArray(obj.result.resources)) {
+        throw new Error('Collection file is missing its resources.');
+    }
+    const outcomes = Array.isArray(obj.outcomes)
+        ? obj.outcomes
+            .filter((outcome) => Boolean(outcome) &&
+            typeof outcome.id === 'string' &&
+            typeof outcome.text === 'string')
+            .map((outcome) => ({ id: outcome.id, text: outcome.text }))
+        : [];
+    return {
+        kind: COLLECTION_KIND,
+        schemaVersion: obj.schemaVersion,
+        topic: typeof obj.topic === 'string' ? obj.topic : '',
+        createdAt: typeof obj.createdAt === 'string' ? obj.createdAt : nowIso(),
+        ...(outcomes.length ? { outcomes } : {}),
+        result: obj.result,
+    };
+}
+/**
+ * Read resources from any saved Honeyguide JSON: a collection file, a legacy
+ * `suggest --json` result, or a batch output. Used by recheck.
+ */
+export function resourcesFromSaved(input) {
+    const obj = input;
+    if (!obj || typeof obj !== 'object')
+        return [];
+    if (obj.kind === COLLECTION_KIND)
+        return parseCollectionFile(obj).result.resources;
+    if (Array.isArray(obj.resources))
+        return obj.resources;
+    if (Array.isArray(obj.entries)) {
+        return obj.entries.flatMap((entry) => entry?.result?.resources ?? []);
+    }
+    return [];
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAa3C,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,MAAqB,EACrB,WAAsB,EAAE,EACxB,MAAY,IAAI,IAAI,EAAE;IAEtB,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,aAAa,EAAE,yBAAyB;QACxC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;QAC5B,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;KACzB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,MAAqB;IACrC,OAAO;QACL,GAAG,MAAM;QACT,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7C,GAAG,QAAQ;YACX,YAAY,EACV,QAAQ,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;gBACjE,CAAC,CAAC,QAAQ,CAAC,YAAY;gBACvB,CAAC,CAAC,IAAI;SACX,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,IAAI,IAAI,GAAY,KAAK,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,GAAG,CAAC,aAAa,GAAG,yBAAyB,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,CAAC,aAAa,sCAAsC,yBAAyB,uBAAuB,CAC9H,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC1C,CAAC,CAAC,GAAG,CAAC,QAAQ;aACT,MAAM,CACL,CAAC,OAAO,EAAsB,EAAE,CAC9B,OAAO,CAAC,OAAO,CAAC;YAChB,OAAQ,OAAmB,CAAC,EAAE,KAAK,QAAQ;YAC3C,OAAQ,OAAmB,CAAC,IAAI,KAAK,QAAQ,CAChD;aACA,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,KAAK,EAAE,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACrD,SAAS,EAAE,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE;QACvE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,CAAC,MAAuB;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,GAAG,GAAG,KAIJ,CAAC;IACT,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/C,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;IACnF,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,GAAG,CAAC,SAAS,CAAC;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/dist/config.d.ts

@@ -12,8 +12,38 @@ export interface PipelineConfig {
     ollamaModel?: string;
     /** YouTube Data API v3 key; without it video retrieval is unavailable. */
     youtubeApiKey?: string;
-    /** SearXNG instance URL for general-web retrieval; optional. */
+    /**
+     * Web search providers (ADR-0013). SearXNG is preferred when an instance
+     * URL is set; otherwise a keyed provider is used. With none configured the
+     * web component reports unavailable (ADR-0006).
+     */
     searxngUrl?: string;
+    braveApiKey?: string;
+    serperApiKey?: string;
+    /** Semantic Scholar API key; lifts keyless throttling on paper search. */
+    semanticScholarApiKey?: string;
+    /**
+     * Optional semantic re-ranking (ADR-0015). Explicit opt-in: set an
+     * embeddings endpoint (usually Ollama) to reorder candidates by relevance
+     * before diversity balancing. With none set, ranking is unchanged.
+     */
+    embeddingUrl?: string;
+    embeddingModel?: string;
+    embeddingApiKey?: string;
+    /**
+     * Optional local System One decision model (Ollama >= 0.35,
+     * `/v1/systemone`). When set it is preferred over embeddings because it
+     * judges relevance directly (ADR-0016).
+     */
+    decisionUrl?: string;
+    decisionModel?: string;
+    decisionApiKey?: string;
+    /**
+     * Ask the local LLM for a one-line "why this outcome" reason per alignment.
+     * On by default when `ollamaUrl` is configured; set
+     * HONEYGUIDE_ALIGNMENT_REASONS=0 to disable.
+     */
+    alignmentReasons?: boolean;
     /** Contact email passed to polite-pool APIs (Crossref/OpenAlex). */
     mailto?: string;
     /**

package/dist/config.js

@@ -5,6 +5,16 @@ export function configFromEnv(env = process.env) {
         ollamaModel: env.OLLAMA_MODEL || undefined,
         youtubeApiKey: env.YOUTUBE_API_KEY || undefined,
         searxngUrl: env.SEARXNG_URL || undefined,
+        braveApiKey: env.BRAVE_API_KEY || undefined,
+        serperApiKey: env.SERPER_API_KEY || undefined,
+        semanticScholarApiKey: env.SEMANTIC_SCHOLAR_API_KEY || undefined,
+        embeddingUrl: env.EMBEDDING_URL || undefined,
+        embeddingModel: env.EMBEDDING_MODEL || 'nomic-embed-text',
+        embeddingApiKey: env.EMBEDDING_API_KEY || undefined,
+        decisionUrl: env.DECISION_URL || undefined,
+        decisionModel: env.DECISION_MODEL || 'tev1:0.8b',
+        decisionApiKey: env.DECISION_API_KEY || undefined,
+        alignmentReasons: env.HONEYGUIDE_ALIGNMENT_REASONS !== '0',
         mailto: env.HONEYGUIDE_MAILTO || undefined,
     };
 }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;QACtC,YAAY,EAAE,GAAG,CAAC,cAAc,IAAI,SAAS;QAC7C,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QAC1C,aAAa,EAAE,GAAG,CAAC,eAAe,IAAI,SAAS;QAC/C,UAAU,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;QACxC,MAAM,EAAE,GAAG,CAAC,iBAAiB,IAAI,SAAS;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA0DA,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;QACtC,YAAY,EAAE,GAAG,CAAC,cAAc,IAAI,SAAS;QAC7C,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QAC1C,aAAa,EAAE,GAAG,CAAC,eAAe,IAAI,SAAS;QAC/C,UAAU,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;QACxC,WAAW,EAAE,GAAG,CAAC,aAAa,IAAI,SAAS;QAC3C,YAAY,EAAE,GAAG,CAAC,cAAc,IAAI,SAAS;QAC7C,qBAAqB,EAAE,GAAG,CAAC,wBAAwB,IAAI,SAAS;QAChE,YAAY,EAAE,GAAG,CAAC,aAAa,IAAI,SAAS;QAC5C,cAAc,EAAE,GAAG,CAAC,eAAe,IAAI,kBAAkB;QACzD,eAAe,EAAE,GAAG,CAAC,iBAAiB,IAAI,SAAS;QACnD,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QAC1C,aAAa,EAAE,GAAG,CAAC,cAAc,IAAI,WAAW;QAChD,cAAc,EAAE,GAAG,CAAC,gBAAgB,IAAI,SAAS;QACjD,gBAAgB,EAAE,GAAG,CAAC,4BAA4B,KAAK,GAAG;QAC1D,MAAM,EAAE,GAAG,CAAC,iBAAiB,IAAI,SAAS;KAC3C,CAAC;AACJ,CAAC"}

package/dist/enrich/unpaywall.d.ts

@@ -0,0 +1,28 @@
+import type { AccessStatus } from '../types.js';
+export interface UnpaywallInfo {
+    access: AccessStatus;
+    /** Best free-to-read location, when Unpaywall reports one. */
+    oaUrl?: string;
+    license?: string;
+}
+interface UnpaywallResponse {
+    is_oa?: boolean;
+    best_oa_location?: {
+        url?: string;
+        license?: string;
+    } | null;
+}
+/**
+ * Map Unpaywall's response to Honeyguide's access status. Anything other
+ * than an explicit `is_oa: true` is treated as subscription, because
+ * Unpaywall only reports papers it knows about — an unknown DOI never gets
+ * here (the HTTP call fails first).
+ */
+export declare function mapUnpaywallResponse(data: UnpaywallResponse): UnpaywallInfo;
+/**
+ * Query Unpaywall for a DOI (spec §3 institutional plumbing). Free and
+ * keyless, but it requires a contact email; without `HONEYGUIDE_MAILTO` the
+ * caller should skip this. Failure is non-fatal (ADR-0006).
+ */
+export declare function lookupUnpaywall(doi: string, email: string): Promise<UnpaywallInfo | null>;
+export {};

package/dist/enrich/unpaywall.js

@@ -0,0 +1,36 @@
+const ENDPOINT = 'https://api.unpaywall.org/v2';
+const TIMEOUT_MS = 4000;
+/**
+ * Map Unpaywall's response to Honeyguide's access status. Anything other
+ * than an explicit `is_oa: true` is treated as subscription, because
+ * Unpaywall only reports papers it knows about — an unknown DOI never gets
+ * here (the HTTP call fails first).
+ */
+export function mapUnpaywallResponse(data) {
+    const oaUrl = data.best_oa_location?.url;
+    const license = data.best_oa_location?.license;
+    return {
+        access: data.is_oa ? 'open' : 'subscription',
+        oaUrl: typeof oaUrl === 'string' ? oaUrl : undefined,
+        license: typeof license === 'string' ? license : undefined,
+    };
+}
+/**
+ * Query Unpaywall for a DOI (spec §3 institutional plumbing). Free and
+ * keyless, but it requires a contact email; without `HONEYGUIDE_MAILTO` the
+ * caller should skip this. Failure is non-fatal (ADR-0006).
+ */
+export async function lookupUnpaywall(doi, email) {
+    if (!doi || !email)
+        return null;
+    const path = doi.split('/').map(encodeURIComponent).join('/');
+    const url = `${ENDPOINT}/${path}?email=${encodeURIComponent(email)}`;
+    const res = await fetch(url, {
+        headers: { accept: 'application/json', 'user-agent': 'Honeyguide/1.0' },
+        signal: AbortSignal.timeout(TIMEOUT_MS),
+    });
+    if (!res.ok)
+        return null;
+    return mapUnpaywallResponse((await res.json()));
+}
+//# sourceMappingURL=unpaywall.js.map

package/dist/enrich/unpaywall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpaywall.js","sourceRoot":"","sources":["../../src/enrich/unpaywall.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,8BAA8B,CAAC;AAChD,MAAM,UAAU,GAAG,IAAI,CAAC;AAiBxB;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAC/C,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc;QAC5C,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACpD,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAC3D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,KAAa;IAEb,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,IAAI,UAAU,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IACrE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE;QACvE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC;KACxC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,oBAAoB,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC,CAAC;AACvE,CAAC"}

package/dist/export/lmsHtml.js

@@ -1,3 +1,4 @@
+import { verificationText } from '../verify/verify.js';
 /**
  * LMS-ready HTML (spec §10): a single self-contained fragment with inline
  * styles only, because LMS rich-text editors (Canvas, Moodle, Blackboard)
@@ -8,15 +9,23 @@ export function toLmsHtml(topic, result) {
     return [
         `<div style="font-family:sans-serif;max-width:46em">`,
         `<h2 style="margin-bottom:4px">Supporting resources: ${escape(topic)}</h2>`,
-        `<p style="color:#555;font-size:0.9em">Every resource below was retrieved and verified — none are AI-generated citations.</p>`,
+        `<p style="color:#555;font-size:0.9em">Every resource below was retrieved from a real source and checked — none are AI-generated citations.</p>`,
         items,
         `</div>`,
     ].join('\n');
 }
 function resourceHtml(r) {
-    const meta = [r.format, r.sourceType];
+    const meta = [
+        r.format,
+        r.sourceType,
+        verificationText(r.verification, r.verificationBasis),
+    ];
     if (r.year)
         meta.push(String(r.year));
+    if (r.access !== 'unknown')
+        meta.push(`access: ${r.access}`);
+    if (r.alignment?.confirmed)
+        meta.push(`outcome: ${r.alignment.outcomeText}`);
     if (r.licensing !== 'unknown')
         meta.push(r.licensing.replace(/-/g, ' '));
     if (r.accessibilityNotes.length)
@@ -29,6 +38,10 @@ function resourceHtml(r) {
             (r.annotation.source === 'llm' ? 'Rationale (generated): ' : 'Description (extracted): ') +
             `</em>${escape(r.annotation.text)}</p>`
         : '';
+    const alignmentReason = r.alignment?.confirmed && r.alignment.reason
+        ? `<p style="margin:2px 0 0;font-size:0.9em;color:#666">` +
+            `<em>Outcome rationale (generated): </em>${escape(r.alignment.reason)}</p>`
+        : '';
     return (`<div style="border-top:1px solid #ddd;padding:10px 0">` +
         `<a href="${escape(r.url)}" style="font-weight:bold">${escape(r.title)}</a>` +
         (r.authors.length
@@ -36,6 +49,7 @@ function resourceHtml(r) {
             : '') +
         `<div style="color:#777;font-size:0.85em">${escape(meta.join(' · '))}</div>` +
         annotation +
+        alignmentReason +
         `</div>`);
 }
 function escape(s) {

package/dist/export/lmsHtml.js.map

@@ -1 +1 @@
-{"version":3,"file":"lmsHtml.js","sourceRoot":"","sources":["../../src/export/lmsHtml.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,MAAqB;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO;QACL,qDAAqD;QACrD,uDAAuD,MAAM,CAAC,KAAK,CAAC,OAAO;QAC3E,8HAA8H;QAC9H,KAAK;QACL,QAAQ;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,CAAW;IAC/B,MAAM,IAAI,GAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,kBAAkB,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,CAAC,sBAAsB;QAAE,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAErE,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI;QAClC,CAAC,CAAC,6CAA6C;YAC7C,0CAA0C;YAC1C,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACzF,QAAQ,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM;QACzC,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,CACL,wDAAwD;QACxD,YAAY,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM;QAC5E,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM;YACf,CAAC,CAAC,+BAA+B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS;YAClF,CAAC,CAAC,EAAE,CAAC;QACP,4CAA4C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ;QAC5E,UAAU;QACV,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"lmsHtml.js","sourceRoot":"","sources":["../../src/export/lmsHtml.ts"],"names":[],"mappings":"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"}

package/dist/export/markdown.js

@@ -1,10 +1,11 @@
+import { verificationText } from '../verify/verify.js';
 /** Markdown export (spec §10, the v1 export target). */
 export function toMarkdown(topic, result) {
     const lines = [
         `# Supporting resources: ${topic}`,
         '',
-        `> Generated by Honeyguide. Every resource below was retrieved and`,
-        `> verified — none are LLM-generated citations.`,
+        `> Generated by Honeyguide. Every resource below was retrieved from a`,
+        `> real source and checked — none are LLM-generated citations.`,
         '',
     ];
     const supporting = result.resources.filter((r) => r.stance !== 'counterpoint');
@@ -35,7 +36,11 @@ function resourceBlock(r) {
     if (r.venue)
         meta.push(r.venue);
     meta.push(`source: ${r.sourceType}`);
-    meta.push(`verification: ${r.verification}`);
+    meta.push(`verification: ${verificationText(r.verification, r.verificationBasis)}`);
+    if (r.access !== 'unknown')
+        meta.push(`access: ${r.access}`);
+    if (r.alignment?.confirmed)
+        meta.push(`outcome: ${r.alignment.outcomeText}`);
     if (r.licensing !== 'unknown')
         meta.push(`licensing: ${r.licensing}`);
     if (r.accessibilityNotes.length)
@@ -47,6 +52,9 @@ function resourceBlock(r) {
         const provenance = r.annotation.source === 'llm' ? 'Rationale (generated)' : 'Description (extracted)';
         lines.push('', `${provenance}: ${r.annotation.text}`);
     }
+    if (r.alignment?.confirmed && r.alignment.reason) {
+        lines.push('', `Outcome rationale (generated): ${r.alignment.reason}`);
+    }
     return lines;
 }
 function label(format) {

package/dist/export/markdown.js.map

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

package/dist/index.d.ts

@@ -11,15 +11,32 @@ export { suggestResources } from './pipeline.js';
 export { suggestBatch, toBatchMarkdown, type BatchEntry } from './batch.js';
 export { recheckResources, toRecheckMarkdown, type RecheckEntry } from './recheck.js';
 export { deriveCounterQueries, heuristicCounterQueries } from './retrieval/counterpoint.js';
+export { COLLECTION_KIND, COLLECTION_SCHEMA_VERSION, toCollectionFile, parseCollectionFile, resourcesFromSaved, type CollectionFile, } from './collection.js';
 export { configFromEnv, type PipelineConfig } from './config.js';
+export { compileBrief, applyConstraints, type BriefAnswers, type CompiledBrief, } from './brief.js';
+export { buildRationalePrompt } from './annotate/ollama.js';
 export { toMarkdown } from './export/markdown.js';
 export { toCitations, formatApa, formatHarvard } from './export/citations.js';
 export { toLmsHtml } from './export/lmsHtml.js';
 export { mapOpenAlexLicensing } from './retrieval/openalexTopical.js';
+export { createSearchProvider } from './retrieval/search/index.js';
+export type { SearchProvider, WebSearchResult, WebSearchProviderName, } from './retrieval/search/index.js';
+export { mergePaperCandidates, normalizeDoi, normalizeTitle } from './retrieval/paperMerge.js';
+export { parseArxivFeed, arxivEntriesToCandidates, buildArxivQuery } from './retrieval/arxiv.js';
+export { getCachedJson, setCachedJson, clearJsonCache } from './retrieval/cache.js';
+export { CircuitBreaker, defaultBreaker } from './retrieval/breaker.js';
+export { parseEuropePmcResults } from './retrieval/europePmc.js';
 export { diversify } from './rank/diversity.js';
+export { createEmbeddingProvider, OllamaEmbeddingProvider, CachedEmbeddingProvider, type EmbeddingProvider, } from './rank/embeddings.js';
+export { cosineSimilarity, candidateText, semanticScores, orderByScores, } from './rank/semantic.js';
+export { createReranker, EmbeddingReranker, type Reranker, } from './rank/reranker.js';
+export { parseOutcomes, createOutcomeAligner, buildAlignmentRequest, parseAlignmentResponse, OllamaOutcomeAligner, EmbeddingOutcomeAligner, MAX_ALIGN_RESOURCES, MAX_ALIGN_OUTCOMES, type OutcomeAligner, } from './align/outcomes.js';
+export { buildAlignmentReasonPrompt, generateAlignmentReason, addAlignmentReasons, } from './align/reasons.js';
+export { buildSystemOneRequest, parseSystemOneScores, balancedSubset, OllamaDecisionReranker, MAX_DECISION_CANDIDATES, } from './rank/decision.js';
 export { classifySource } from './enrich/sourceType.js';
 export { parsePageMeta, fetchPageMeta, type PageMeta } from './enrich/page.js';
-export { mapUrlStatus } from './verify/verify.js';
+export { mapUrlStatus, verifyCandidate, verificationText, type VerificationOutcome, } from './verify/verify.js';
+export { mapUnpaywallResponse, lookupUnpaywall } from './enrich/unpaywall.js';
 export { deriveQuery, heuristicKeywords, extractPhrases } from './retrieval/query.js';
 export { reconstructAbstract } from './retrieval/openalexTopical.js';
 export type { Candidate } from './retrieval/candidates.js';

package/dist/index.js

@@ -10,15 +10,31 @@ export { suggestResources } from './pipeline.js';
 export { suggestBatch, toBatchMarkdown } from './batch.js';
 export { recheckResources, toRecheckMarkdown } from './recheck.js';
 export { deriveCounterQueries, heuristicCounterQueries } from './retrieval/counterpoint.js';
+export { COLLECTION_KIND, COLLECTION_SCHEMA_VERSION, toCollectionFile, parseCollectionFile, resourcesFromSaved, } from './collection.js';
 export { configFromEnv } from './config.js';
+export { compileBrief, applyConstraints, } from './brief.js';
+export { buildRationalePrompt } from './annotate/ollama.js';
 export { toMarkdown } from './export/markdown.js';
 export { toCitations, formatApa, formatHarvard } from './export/citations.js';
 export { toLmsHtml } from './export/lmsHtml.js';
 export { mapOpenAlexLicensing } from './retrieval/openalexTopical.js';
+export { createSearchProvider } from './retrieval/search/index.js';
+export { mergePaperCandidates, normalizeDoi, normalizeTitle } from './retrieval/paperMerge.js';
+export { parseArxivFeed, arxivEntriesToCandidates, buildArxivQuery } from './retrieval/arxiv.js';
+export { getCachedJson, setCachedJson, clearJsonCache } from './retrieval/cache.js';
+export { CircuitBreaker, defaultBreaker } from './retrieval/breaker.js';
+export { parseEuropePmcResults } from './retrieval/europePmc.js';
 export { diversify } from './rank/diversity.js';
+export { createEmbeddingProvider, OllamaEmbeddingProvider, CachedEmbeddingProvider, } from './rank/embeddings.js';
+export { cosineSimilarity, candidateText, semanticScores, orderByScores, } from './rank/semantic.js';
+export { createReranker, EmbeddingReranker, } from './rank/reranker.js';
+export { parseOutcomes, createOutcomeAligner, buildAlignmentRequest, parseAlignmentResponse, OllamaOutcomeAligner, EmbeddingOutcomeAligner, MAX_ALIGN_RESOURCES, MAX_ALIGN_OUTCOMES, } from './align/outcomes.js';
+export { buildAlignmentReasonPrompt, generateAlignmentReason, addAlignmentReasons, } from './align/reasons.js';
+export { buildSystemOneRequest, parseSystemOneScores, balancedSubset, OllamaDecisionReranker, MAX_DECISION_CANDIDATES, } from './rank/decision.js';
 export { classifySource } from './enrich/sourceType.js';
 export { parsePageMeta, fetchPageMeta } from './enrich/page.js';
-export { mapUrlStatus } from './verify/verify.js';
+export { mapUrlStatus, verifyCandidate, verificationText, } from './verify/verify.js';
+export { mapUnpaywallResponse, lookupUnpaywall } from './enrich/unpaywall.js';
 export { deriveQuery, heuristicKeywords, extractPhrases } from './retrieval/query.js';
 export { reconstructAbstract } from './retrieval/openalexTopical.js';
 // Document input (PDF, DOCX, TXT, MD) comes straight from cite-sight-core.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAqB,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAiB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,2EAA2E;AAC3E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAqB,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GAEnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,gBAAgB,GAGjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAMnE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAiB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,2EAA2E;AAC3E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/pipeline.d.ts

@@ -1,4 +1,4 @@
-import type { SuggestRequest, SuggestResult } from './types.js';
+import type { ProgressListener, SuggestRequest, SuggestResult } from './types.js';
 import type { PipelineConfig } from './config.js';
 /**
  * List mode (spec §4): input goes in, a verified and annotated resource
@@ -7,4 +7,4 @@ import type { PipelineConfig } from './config.js';
  * (ADR-0011). Counterpoint mode adds a second retrieval pass that
  * deliberately hunts disagreeing material (spec §3 point 3).
  */
-export declare function suggestResources(request: SuggestRequest, config?: PipelineConfig): Promise<SuggestResult>;
+export declare function suggestResources(request: SuggestRequest, config?: PipelineConfig, onProgress?: ProgressListener): Promise<SuggestResult>;