@pellux/goodvibes-sdk 0.18.13 → 0.18.15

package/dist/_internal/platform/knowledge/knowledge-api.d.ts

@@ -0,0 +1,160 @@
+import type { KnowledgeService } from './service.js';
+import type { ArtifactFetchMode } from '@pellux/goodvibes-sdk/platform/artifacts/types';
+import { type KnowledgeInjection } from '../state/knowledge-injection.js';
+import type { MemoryAddOptions, MemoryBundle, MemoryDoctorReport, MemoryImportResult, MemoryLink, MemoryRecord, MemoryReviewPatch, MemoryScope, MemorySearchFilter, MemorySemanticSearchResult } from '../state/memory-store.js';
+import type { MemoryVectorStats } from '../state/memory-vector-store.js';
+import type { MemoryRegistry } from '../state/memory-registry.js';
+export type { ArtifactFetchMode } from '@pellux/goodvibes-sdk/platform/artifacts/types';
+export type { KnowledgeInjection, } from '../state/knowledge-injection.js';
+export type { KnowledgeInjectionIngestMode, KnowledgeInjectionProvenance, KnowledgeInjectionRetention, KnowledgeInjectionTrustTier, KnowledgeInjectionUseAs, } from './internal.js';
+type UsageListInput = Parameters<KnowledgeService['listUsageRecords']>[1];
+type SourceQueryInput = Parameters<KnowledgeService['querySources']>[0];
+type NodeQueryInput = Parameters<KnowledgeService['queryNodes']>[0];
+type IssueQueryInput = Parameters<KnowledgeService['queryIssues']>[0];
+type NeighborInput = Parameters<KnowledgeService['getNeighbors']>[2];
+type RecordUsageInput = Parameters<KnowledgeService['recordUsage']>[0];
+type IngestUrlInput = Parameters<KnowledgeService['ingestUrl']>[0];
+type IngestArtifactInput = Parameters<KnowledgeService['ingestArtifact']>[0];
+type ImportBookmarksInput = Parameters<KnowledgeService['importBookmarksFromFile']>[0];
+type ImportUrlsInput = Parameters<KnowledgeService['importUrlsFromFile']>[0];
+type BookmarkSeedsInput = Parameters<KnowledgeService['ingestBookmarkSeeds']>[0];
+type ConnectorInput = Parameters<KnowledgeService['ingestConnectorInput']>[0];
+type ProjectionRenderInput = Parameters<KnowledgeService['renderProjection']>[0];
+type ProjectionMaterializeInput = Parameters<KnowledgeService['materializeProjection']>[0];
+type PacketTask = Parameters<KnowledgeService['buildPacket']>[0];
+type PacketWriteScope = Parameters<KnowledgeService['buildPacket']>[1];
+type PacketLimit = Parameters<KnowledgeService['buildPacket']>[2];
+type PacketOptions = Parameters<KnowledgeService['buildPacket']>[3];
+type ScheduleSaveInput = Parameters<KnowledgeService['saveSchedule']>[0];
+type ConsolidationDecision = Parameters<KnowledgeService['decideConsolidationCandidate']>[1];
+type ConsolidationDecisionInput = Parameters<KnowledgeService['decideConsolidationCandidate']>[2];
+type RunJobInput = Parameters<KnowledgeService['runJob']>[1];
+type CandidateListInput = Parameters<KnowledgeService['listConsolidationCandidates']>[1];
+type RemoteKnowledgeFetchMode = Extract<ArtifactFetchMode, 'public-only' | 'allow-private-hosts'>;
+export interface KnowledgeApiUrlIngestInput extends Omit<IngestUrlInput, 'allowPrivateHosts' | 'metadata'> {
+    readonly fetchMode?: RemoteKnowledgeFetchMode;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface KnowledgeApiArtifactIngestInput extends Omit<IngestArtifactInput, 'allowPrivateHosts' | 'metadata'> {
+    readonly fetchMode?: RemoteKnowledgeFetchMode;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface MemoryExplainResult {
+    readonly injections: readonly KnowledgeInjection[];
+    readonly prompt: string | null;
+}
+export interface MemoryApi {
+    add(input: MemoryAddOptions): Promise<MemoryRecord>;
+    search(filter?: MemorySearchFilter): readonly MemoryRecord[];
+    searchSemantic(filter?: MemorySearchFilter): readonly MemorySemanticSearchResult[];
+    vectorStats(): MemoryVectorStats;
+    rebuildVectors(): MemoryVectorStats;
+    rebuildVectorsAsync(): Promise<MemoryVectorStats>;
+    doctor(): Promise<MemoryDoctorReport>;
+    reviewQueue(limit?: number): readonly MemoryRecord[];
+    exportBundle(filter?: MemorySearchFilter): MemoryBundle;
+    importBundle(bundle: MemoryBundle): Promise<MemoryImportResult>;
+    get(id: string): MemoryRecord | null;
+    getAll(): readonly MemoryRecord[];
+    link(fromId: string, toId: string, relation: string): Promise<MemoryLink | null>;
+    linksFor(id: string): readonly MemoryLink[];
+    update(id: string, patch: {
+        scope?: MemoryScope;
+        summary?: string;
+        detail?: string;
+        tags?: string[];
+    }): MemoryRecord | null;
+    review(id: string, patch: MemoryReviewPatch): MemoryRecord | null;
+    delete(id: string): boolean;
+    explain(task: string, writeScope?: readonly string[], limit?: number): MemoryExplainResult;
+}
+export type MemoryApiRegistry = Pick<MemoryRegistry, 'add' | 'doctor' | 'delete' | 'exportBundle' | 'get' | 'getAll' | 'importBundle' | 'link' | 'linksFor' | 'rebuildVectors' | 'rebuildVectorsAsync' | 'review' | 'reviewQueue' | 'search' | 'searchSemantic' | 'update' | 'vectorStats'>;
+export interface CreateKnowledgeApiOptions {
+    readonly memoryRegistry?: MemoryApiRegistry;
+}
+export interface KnowledgeApi {
+    readonly status: {
+        get(): ReturnType<KnowledgeService['getStatus']>;
+        lint(): ReturnType<KnowledgeService['lint']>;
+        reindex(): ReturnType<KnowledgeService['reindex']>;
+    };
+    readonly sources: {
+        list(limit?: number): ReturnType<KnowledgeService['listSources']>;
+        query(input?: SourceQueryInput): ReturnType<KnowledgeService['querySources']>;
+    };
+    readonly graph: {
+        nodes: {
+            list(limit?: number): ReturnType<KnowledgeService['listNodes']>;
+            query(input?: NodeQueryInput): ReturnType<KnowledgeService['queryNodes']>;
+        };
+        issues: {
+            list(limit?: number): ReturnType<KnowledgeService['listIssues']>;
+            query(input?: IssueQueryInput): ReturnType<KnowledgeService['queryIssues']>;
+        };
+        extractions: {
+            list(limit?: number, sourceId?: string): ReturnType<KnowledgeService['listExtractions']>;
+            get(id: string): ReturnType<KnowledgeService['getExtraction']>;
+            getBySourceId(sourceId: string): ReturnType<KnowledgeService['getSourceExtraction']>;
+        };
+        items: {
+            get(id: string): ReturnType<KnowledgeService['getItem']>;
+            getMany(ids: readonly string[]): ReturnType<KnowledgeService['getItems']>;
+            neighbors(kind: Parameters<KnowledgeService['getNeighbors']>[0], id: string, input?: NeighborInput): ReturnType<KnowledgeService['getNeighbors']>;
+            search(query: string, limit?: number): ReturnType<KnowledgeService['search']>;
+        };
+    };
+    readonly usage: {
+        list(limit?: number, input?: UsageListInput): ReturnType<KnowledgeService['listUsageRecords']>;
+        record(input: RecordUsageInput): ReturnType<KnowledgeService['recordUsage']>;
+    };
+    readonly connectors: {
+        list(): ReturnType<KnowledgeService['listConnectors']>;
+        get(id: string): ReturnType<KnowledgeService['getConnector']>;
+        doctor(id: string): ReturnType<KnowledgeService['doctorConnector']>;
+        register(connector: Parameters<KnowledgeService['registerConnector']>[0], options?: Parameters<KnowledgeService['registerConnector']>[1]): void;
+    };
+    readonly ingest: {
+        url(input: KnowledgeApiUrlIngestInput): ReturnType<KnowledgeService['ingestUrl']>;
+        artifact(input: KnowledgeApiArtifactIngestInput): ReturnType<KnowledgeService['ingestArtifact']>;
+        bookmarksFile(input: ImportBookmarksInput): ReturnType<KnowledgeService['importBookmarksFromFile']>;
+        urlsFile(input: ImportUrlsInput): ReturnType<KnowledgeService['importUrlsFromFile']>;
+        bookmarkSeeds(input: BookmarkSeedsInput): ReturnType<KnowledgeService['ingestBookmarkSeeds']>;
+        withConnector(connectorId: Parameters<KnowledgeService['ingestWithConnector']>[0], input: Parameters<KnowledgeService['ingestWithConnector']>[1], sessionId?: Parameters<KnowledgeService['ingestWithConnector']>[2]): ReturnType<KnowledgeService['ingestWithConnector']>;
+        connectorInput(input: ConnectorInput): ReturnType<KnowledgeService['ingestConnectorInput']>;
+    };
+    readonly packets: {
+        build(task: PacketTask, writeScope?: PacketWriteScope, limit?: PacketLimit, options?: PacketOptions): ReturnType<KnowledgeService['buildPacket']>;
+        buildSync(task: PacketTask, writeScope?: PacketWriteScope, limit?: PacketLimit, options?: PacketOptions): ReturnType<KnowledgeService['buildPacketSync']>;
+        buildPrompt(task: PacketTask, writeScope?: PacketWriteScope, limit?: PacketLimit, options?: PacketOptions): ReturnType<KnowledgeService['buildPromptPacket']>;
+        buildPromptSync(task: PacketTask, writeScope?: PacketWriteScope, limit?: PacketLimit, options?: PacketOptions): ReturnType<KnowledgeService['buildPromptPacketSync']>;
+    };
+    readonly projections: {
+        listTargets(limit?: number): ReturnType<KnowledgeService['listProjectionTargets']>;
+        render(input: ProjectionRenderInput): ReturnType<KnowledgeService['renderProjection']>;
+        materialize(input: ProjectionMaterializeInput): ReturnType<KnowledgeService['materializeProjection']>;
+    };
+    readonly jobs: {
+        list(): ReturnType<KnowledgeService['listJobs']>;
+        get(id: string): ReturnType<KnowledgeService['getJob']>;
+        runs(limit?: number, jobId?: string): ReturnType<KnowledgeService['listJobRuns']>;
+        run(id: string, input?: RunJobInput): ReturnType<KnowledgeService['runJob']>;
+        schedules: {
+            list(limit?: number): ReturnType<KnowledgeService['listSchedules']>;
+            get(id: string): ReturnType<KnowledgeService['getSchedule']>;
+            save(input: ScheduleSaveInput): ReturnType<KnowledgeService['saveSchedule']>;
+            delete(id: string): ReturnType<KnowledgeService['deleteSchedule']>;
+            setEnabled(id: string, enabled: boolean): ReturnType<KnowledgeService['setScheduleEnabled']>;
+        };
+    };
+    readonly consolidation: {
+        candidates(limit?: number, input?: CandidateListInput): ReturnType<KnowledgeService['listConsolidationCandidates']>;
+        getCandidate(id: string): ReturnType<KnowledgeService['getConsolidationCandidate']>;
+        reports(limit?: number): ReturnType<KnowledgeService['listConsolidationReports']>;
+        getReport(id: string): ReturnType<KnowledgeService['getConsolidationReport']>;
+        decide(candidateId: string, decision: ConsolidationDecision, input?: ConsolidationDecisionInput): ReturnType<KnowledgeService['decideConsolidationCandidate']>;
+    };
+    readonly memory?: MemoryApi;
+}
+export declare function createMemoryApi(memoryRegistry: MemoryApiRegistry): MemoryApi;
+export declare function createKnowledgeApi(knowledgeService: KnowledgeService, options?: CreateKnowledgeApiOptions): KnowledgeApi;
+//# sourceMappingURL=knowledge-api.d.ts.map

package/dist/_internal/platform/knowledge/knowledge-api.d.ts.map

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

package/dist/_internal/platform/knowledge/knowledge-api.js

@@ -0,0 +1,145 @@
+import { buildKnowledgeInjectionPrompt, selectKnowledgeForTask, } from '../state/knowledge-injection.js';
+function normalizeKnowledgeFetchMode(fetchMode) {
+    if (!fetchMode)
+        return {};
+    return {
+        fetchMode,
+        allowPrivateHosts: fetchMode === 'allow-private-hosts',
+    };
+}
+function appendKnowledgeIntentMetadata(metadata, fetchMode, ingestMode) {
+    if (!metadata && !fetchMode)
+        return {
+            knowledgeIntent: {
+                ingestMode,
+            },
+        };
+    return {
+        ...(metadata ?? {}),
+        knowledgeIntent: {
+            ingestMode,
+            ...(fetchMode ? { remoteFetchMode: fetchMode } : {}),
+        },
+    };
+}
+export function createMemoryApi(memoryRegistry) {
+    return Object.freeze({
+        add: (input) => memoryRegistry.add(input),
+        search: (filter = {}) => memoryRegistry.search(filter),
+        searchSemantic: (filter = {}) => memoryRegistry.searchSemantic(filter),
+        vectorStats: () => memoryRegistry.vectorStats(),
+        rebuildVectors: () => memoryRegistry.rebuildVectors(),
+        rebuildVectorsAsync: () => memoryRegistry.rebuildVectorsAsync(),
+        doctor: () => memoryRegistry.doctor(),
+        reviewQueue: (limit = 10) => memoryRegistry.reviewQueue(limit),
+        exportBundle: (filter = {}) => memoryRegistry.exportBundle(filter),
+        importBundle: (bundle) => memoryRegistry.importBundle(bundle),
+        get: (id) => memoryRegistry.get(id),
+        getAll: () => memoryRegistry.getAll(),
+        link: (fromId, toId, relation) => memoryRegistry.link(fromId, toId, relation),
+        linksFor: (id) => memoryRegistry.linksFor(id),
+        update: (id, patch) => (memoryRegistry.update(id, patch)),
+        review: (id, patch) => memoryRegistry.review(id, patch),
+        delete: (id) => memoryRegistry.delete(id),
+        explain: (task, writeScope = [], limit = 3) => {
+            const injections = selectKnowledgeForTask(memoryRegistry, task, writeScope, limit);
+            return {
+                injections,
+                prompt: buildKnowledgeInjectionPrompt(injections),
+            };
+        },
+    });
+}
+export function createKnowledgeApi(knowledgeService, options = {}) {
+    return Object.freeze({
+        status: Object.freeze({
+            get: () => knowledgeService.getStatus(),
+            lint: () => knowledgeService.lint(),
+            reindex: () => knowledgeService.reindex(),
+        }),
+        sources: Object.freeze({
+            list: (limit = 100) => knowledgeService.listSources(limit),
+            query: (input = {}) => knowledgeService.querySources(input),
+        }),
+        graph: Object.freeze({
+            nodes: Object.freeze({
+                list: (limit = 100) => knowledgeService.listNodes(limit),
+                query: (input = {}) => knowledgeService.queryNodes(input),
+            }),
+            issues: Object.freeze({
+                list: (limit = 100) => knowledgeService.listIssues(limit),
+                query: (input = {}) => knowledgeService.queryIssues(input),
+            }),
+            extractions: Object.freeze({
+                list: (limit = 100, sourceId) => knowledgeService.listExtractions(limit, sourceId),
+                get: (id) => knowledgeService.getExtraction(id),
+                getBySourceId: (sourceId) => knowledgeService.getSourceExtraction(sourceId),
+            }),
+            items: Object.freeze({
+                get: (id) => knowledgeService.getItem(id),
+                getMany: (ids) => knowledgeService.getItems(ids),
+                neighbors: (kind, id, input = {}) => knowledgeService.getNeighbors(kind, id, input),
+                search: (query, limit = 10) => knowledgeService.search(query, limit),
+            }),
+        }),
+        usage: Object.freeze({
+            list: (limit = 100, input = {}) => knowledgeService.listUsageRecords(limit, input),
+            record: (input) => knowledgeService.recordUsage(input),
+        }),
+        connectors: Object.freeze({
+            list: () => knowledgeService.listConnectors(),
+            get: (id) => knowledgeService.getConnector(id),
+            doctor: (id) => knowledgeService.doctorConnector(id),
+            register: (connector, options = {}) => knowledgeService.registerConnector(connector, options),
+        }),
+        ingest: Object.freeze({
+            url: (input) => knowledgeService.ingestUrl({
+                ...input,
+                ...normalizeKnowledgeFetchMode(input.fetchMode),
+                metadata: appendKnowledgeIntentMetadata(input.metadata, input.fetchMode, 'url'),
+            }),
+            artifact: (input) => knowledgeService.ingestArtifact({
+                ...input,
+                ...normalizeKnowledgeFetchMode(input.fetchMode),
+                metadata: appendKnowledgeIntentMetadata(input.metadata, input.fetchMode, 'artifact'),
+            }),
+            bookmarksFile: (input) => knowledgeService.importBookmarksFromFile(input),
+            urlsFile: (input) => knowledgeService.importUrlsFromFile(input),
+            bookmarkSeeds: (seeds, sessionId, sourceType, connectorId) => knowledgeService.ingestBookmarkSeeds(seeds, sessionId, sourceType, connectorId),
+            withConnector: (connectorId, input, sessionId) => knowledgeService.ingestWithConnector(connectorId, input, sessionId),
+            connectorInput: (input) => knowledgeService.ingestConnectorInput(input),
+        }),
+        packets: Object.freeze({
+            build: (task, writeScope = [], limit = 10, options = {}) => knowledgeService.buildPacket(task, writeScope, limit, options),
+            buildSync: (task, writeScope = [], limit = 10, options = {}) => knowledgeService.buildPacketSync(task, writeScope, limit, options),
+            buildPrompt: (task, writeScope = [], limit = 10, options = {}) => knowledgeService.buildPromptPacket(task, writeScope, limit, options),
+            buildPromptSync: (task, writeScope = [], limit = 10, options = {}) => knowledgeService.buildPromptPacketSync(task, writeScope, limit, options),
+        }),
+        projections: Object.freeze({
+            listTargets: (limit = 25) => knowledgeService.listProjectionTargets(limit),
+            render: (input) => knowledgeService.renderProjection(input),
+            materialize: (input) => knowledgeService.materializeProjection(input),
+        }),
+        jobs: Object.freeze({
+            list: () => knowledgeService.listJobs(),
+            get: (id) => knowledgeService.getJob(id),
+            runs: (limit = 100, jobId) => knowledgeService.listJobRuns(limit, jobId),
+            run: (id, input = {}) => knowledgeService.runJob(id, input),
+            schedules: Object.freeze({
+                list: (limit = 100) => knowledgeService.listSchedules(limit),
+                get: (id) => knowledgeService.getSchedule(id),
+                save: (input) => knowledgeService.saveSchedule(input),
+                delete: (id) => knowledgeService.deleteSchedule(id),
+                setEnabled: (id, enabled) => knowledgeService.setScheduleEnabled(id, enabled),
+            }),
+        }),
+        consolidation: Object.freeze({
+            candidates: (limit = 100, input = {}) => knowledgeService.listConsolidationCandidates(limit, input),
+            getCandidate: (id) => knowledgeService.getConsolidationCandidate(id),
+            reports: (limit = 100) => knowledgeService.listConsolidationReports(limit),
+            getReport: (id) => knowledgeService.getConsolidationReport(id),
+            decide: (candidateId, decision, input = {}) => knowledgeService.decideConsolidationCandidate(candidateId, decision, input),
+        }),
+        ...(options.memoryRegistry ? { memory: createMemoryApi(options.memoryRegistry) } : {}),
+    });
+}

package/dist/_internal/platform/knowledge/lint.d.ts

@@ -0,0 +1,13 @@
+import type { KnowledgeStore } from '@pellux/goodvibes-sdk/platform/knowledge/store';
+import type { KnowledgeIssueRecord } from '@pellux/goodvibes-sdk/platform/knowledge/types';
+import type { RuntimeEventBus } from '../runtime/events/index.js';
+export interface KnowledgeLintContext {
+    readonly store: KnowledgeStore;
+    readonly emitIfReady: (fn: (bus: RuntimeEventBus, ctx: {
+        readonly traceId: string;
+        readonly sessionId: string;
+        readonly source: string;
+    }) => void, sessionId?: string) => void;
+}
+export declare function lintKnowledgeStore(context: KnowledgeLintContext): Promise<readonly KnowledgeIssueRecord[]>;
+//# sourceMappingURL=lint.d.ts.map

package/dist/_internal/platform/knowledge/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/lint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAyB,MAAM,gDAAgD,CAAC;AAElH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CACpB,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,EAC1H,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;CACX;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAuEhH"}

package/dist/_internal/platform/knowledge/lint.js

@@ -0,0 +1,94 @@
+import { emitKnowledgeLintCompleted } from '../runtime/emitters/index.js';
+import { isSourcePastRefreshWindow, LINT_NAMESPACE } from './internal.js';
+export async function lintKnowledgeStore(context) {
+    await context.store.init();
+    const issues = [];
+    const sources = context.store.listSources(10_000);
+    const edges = context.store.listEdges();
+    const byCanonical = new Map();
+    for (const source of sources) {
+        const extraction = context.store.getExtractionBySourceId(source.id);
+        if (source.canonicalUri) {
+            const bucket = byCanonical.get(source.canonicalUri) ?? [];
+            bucket.push(source);
+            byCanonical.set(source.canonicalUri, bucket);
+        }
+        if (source.status === 'failed' || source.crawlError) {
+            issues.push(issueForSource(source, 'error', 'crawl-failed', source.crawlError ? `Source crawl failed: ${source.crawlError}` : 'Source crawl failed.'));
+        }
+        if (source.status === 'indexed' && (!source.title || !source.summary)) {
+            issues.push(issueForSource(source, 'warning', 'metadata-incomplete', 'Indexed source is missing a title or summary.'));
+        }
+        if (!extraction && source.status === 'indexed') {
+            issues.push(issueForSource(source, 'warning', 'missing-extraction', 'Indexed source is missing a structured extraction record.'));
+        }
+        if (isSourcePastRefreshWindow(source)) {
+            const refreshWindowDays = Math.max(1, Math.round(getSourceRefreshWindowMs(source) / (24 * 60 * 60 * 1000)));
+            issues.push(issueForSource(source, 'info', 'stale-source', `Source is older than its ${refreshWindowDays}-day refresh window and should be recrawled.`));
+        }
+        const linked = edges.some((edge) => edge.fromKind === 'source' && edge.fromId === source.id);
+        if (!linked) {
+            issues.push(issueForSource(source, 'warning', 'source-unlinked', 'Source has no compiled knowledge links yet.'));
+        }
+        if (extraction && extraction.sections.length === 0 && !extraction.summary) {
+            issues.push(issueForSource(source, 'warning', 'weak-extraction', 'Structured extraction produced almost no usable sections or summary.'));
+        }
+    }
+    for (const bucket of byCanonical.values()) {
+        if (bucket.length <= 1)
+            continue;
+        for (const source of bucket) {
+            issues.push(issueForSource(source, 'warning', 'duplicate-canonical-uri', `Duplicate canonical URL detected: ${source.canonicalUri}`));
+        }
+    }
+    const staleMemoryNodes = context.store.listNodes(10_000).filter((node) => node.kind === 'memory' && node.status === 'stale');
+    for (const node of staleMemoryNodes) {
+        issues.push({
+            id: `issue-stale-memory-${node.id}`,
+            severity: 'info',
+            code: 'stale-memory',
+            message: 'Mirrored memory record is stale and should be reviewed before being trusted heavily.',
+            status: 'open',
+            nodeId: node.id,
+            metadata: { namespace: LINT_NAMESPACE },
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+        });
+    }
+    const replaced = await context.store.replaceIssues(issues.map((issue) => ({
+        ...issue,
+        metadata: { ...issue.metadata, namespace: LINT_NAMESPACE },
+    })), LINT_NAMESPACE);
+    context.emitIfReady((bus, ctx) => emitKnowledgeLintCompleted(bus, ctx, {
+        issueCount: replaced.length,
+    }));
+    return replaced;
+}
+function issueForSource(source, severity, code, message) {
+    return {
+        id: `issue-${code}-${source.id}`,
+        severity,
+        code,
+        message,
+        status: 'open',
+        sourceId: source.id,
+        metadata: { namespace: LINT_NAMESPACE },
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+    };
+}
+function getSourceRefreshWindowMs(source) {
+    const connectorKey = source.connectorId === 'url-list' ? 'url-list' : source.connectorId;
+    return {
+        bookmark: 7 * 24 * 60 * 60 * 1000,
+        'bookmark-list': 7 * 24 * 60 * 60 * 1000,
+        'url-list': 7 * 24 * 60 * 60 * 1000,
+        url: 14 * 24 * 60 * 60 * 1000,
+        repo: 14 * 24 * 60 * 60 * 1000,
+        document: 21 * 24 * 60 * 60 * 1000,
+        image: 21 * 24 * 60 * 60 * 1000,
+        dataset: 30 * 24 * 60 * 60 * 1000,
+        manual: 45 * 24 * 60 * 60 * 1000,
+        other: 30 * 24 * 60 * 60 * 1000,
+    }[connectorKey] ?? 30 * 24 * 60 * 60 * 1000;
+}

package/dist/_internal/platform/knowledge/memory-sync.d.ts

@@ -0,0 +1,4 @@
+import type { MemoryRegistry } from '../state/index.js';
+import type { KnowledgeStore } from '@pellux/goodvibes-sdk/platform/knowledge/store';
+export declare function syncKnowledgeMemoryNodes(store: KnowledgeStore, registry: Pick<MemoryRegistry, 'getAll' | 'getStore'>): Promise<void>;
+//# sourceMappingURL=memory-sync.d.ts.map

package/dist/_internal/platform/knowledge/memory-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-sync.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/memory-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAGrF,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,UAAU,CAAC,GACpD,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/_internal/platform/knowledge/memory-sync.js

@@ -0,0 +1,54 @@
+import { slugify } from './internal.js';
+export async function syncKnowledgeMemoryNodes(store, registry) {
+    await registry.getStore().init();
+    const memoryRecords = registry.getAll().filter((record) => record.reviewState !== 'contradicted');
+    for (const record of memoryRecords) {
+        await upsertKnowledgeMemoryNode(store, record);
+    }
+}
+async function upsertKnowledgeMemoryNode(store, record) {
+    const node = await store.upsertNode({
+        id: `memory-${record.id}`,
+        kind: 'memory',
+        slug: slugify(record.id),
+        title: record.summary,
+        summary: record.detail ?? record.summary,
+        aliases: record.tags,
+        status: record.reviewState === 'stale' ? 'stale' : 'active',
+        confidence: record.confidence,
+        metadata: {
+            memoryId: record.id,
+            scope: record.scope,
+            cls: record.cls,
+            reviewState: record.reviewState,
+        },
+    });
+    for (const tag of record.tags) {
+        const topicNode = await store.upsertNode({
+            kind: 'topic',
+            slug: slugify(tag),
+            title: tag,
+            summary: `Topic tag ${tag}.`,
+            aliases: [tag],
+            metadata: { tag },
+        });
+        await store.upsertEdge({
+            fromKind: 'node',
+            fromId: node.id,
+            toKind: 'node',
+            toId: topicNode.id,
+            relation: 'memory_tagged_with',
+        });
+    }
+    for (const provenance of record.provenance) {
+        if (provenance.kind !== 'session')
+            continue;
+        await store.upsertEdge({
+            fromKind: 'node',
+            fromId: node.id,
+            toKind: 'session',
+            toId: provenance.ref,
+            relation: 'derived_from_session',
+        });
+    }
+}

package/dist/_internal/platform/knowledge/packet.d.ts

@@ -0,0 +1,38 @@
+import type { KnowledgeStore } from '@pellux/goodvibes-sdk/platform/knowledge/store';
+import type { KnowledgePacket, KnowledgePacketDetail, KnowledgeSearchResult, KnowledgeUsageRecord } from '@pellux/goodvibes-sdk/platform/knowledge/types';
+import type { RuntimeEventBus } from '../runtime/events/index.js';
+export interface KnowledgePacketContext {
+    readonly store: KnowledgeStore;
+    readonly deferUsage: (input: {
+        readonly targetKind: KnowledgeUsageRecord['targetKind'];
+        readonly targetId: string;
+        readonly usageKind: KnowledgeUsageRecord['usageKind'];
+        readonly task?: string;
+        readonly sessionId?: string;
+        readonly score?: number;
+        readonly metadata?: Record<string, unknown>;
+    }) => void;
+    readonly emitIfReady: (fn: (bus: RuntimeEventBus, ctx: {
+        readonly traceId: string;
+        readonly sessionId: string;
+        readonly source: string;
+    }) => void, sessionId?: string) => void;
+}
+export declare function searchKnowledge(context: KnowledgePacketContext, query: string, limit?: number): KnowledgeSearchResult[];
+export declare function buildKnowledgePacket(context: KnowledgePacketContext, task: string, writeScope?: readonly string[], limit?: number, options?: {
+    readonly detail?: KnowledgePacketDetail;
+    readonly budgetLimit?: number;
+}): Promise<KnowledgePacket>;
+export declare function buildKnowledgePacketSync(context: KnowledgePacketContext, task: string, writeScope?: readonly string[], limit?: number, options?: {
+    readonly detail?: KnowledgePacketDetail;
+    readonly budgetLimit?: number;
+}): KnowledgePacket | null;
+export declare function buildKnowledgePromptPacketSync(context: KnowledgePacketContext, task: string, writeScope?: readonly string[], limit?: number, options?: {
+    readonly detail?: KnowledgePacketDetail;
+    readonly budgetLimit?: number;
+}): string | null;
+export declare function buildKnowledgePromptPacket(context: KnowledgePacketContext, task: string, writeScope?: readonly string[], limit?: number, options?: {
+    readonly detail?: KnowledgePacketDetail;
+    readonly budgetLimit?: number;
+}): Promise<string | null>;
+//# sourceMappingURL=packet.d.ts.map

package/dist/_internal/platform/knowledge/packet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/knowledge/packet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAErB,qBAAqB,EAGrB,oBAAoB,EACrB,MAAM,gDAAgD,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAalE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE;QAC3B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC7C,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,WAAW,EAAE,CACpB,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,EAC1H,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;CACX;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,qBAAqB,EAAE,CAyDzB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAuB,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAuB,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,eAAe,GAAG,IAAI,CAExB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAuB,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,MAAM,GAAG,IAAI,CAGf;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAuB,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}