@pellux/goodvibes-sdk 0.18.13 → 0.18.15

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

@@ -0,0 +1,230 @@
+import { type AutomationScheduleDefinition } from '@pellux/goodvibes-sdk/platform/automation/schedules';
+import { ArtifactStore } from '@pellux/goodvibes-sdk/platform/artifacts/index';
+import type { MemoryRegistry } from '../state/index.js';
+import type { RuntimeEventBus } from '../runtime/events/index.js';
+import { KnowledgeConnectorRegistry } from '@pellux/goodvibes-sdk/platform/knowledge/connectors';
+import { KnowledgeStore } from '@pellux/goodvibes-sdk/platform/knowledge/store';
+import type { KnowledgeBatchIngestResult, KnowledgeBookmarkSeed, KnowledgeConnector, KnowledgeConnectorDoctorReport, KnowledgeConsolidationCandidateRecord, KnowledgeConsolidationReportRecord, KnowledgeEdgeRecord, KnowledgeExtractionRecord, KnowledgeIssueRecord, KnowledgeJobMode, KnowledgeJobRecord, KnowledgeJobRunRecord, KnowledgeMaterializedProjection, KnowledgeItemView, KnowledgeNodeRecord, KnowledgePacket, KnowledgePacketDetail, KnowledgeProjectionBundle, KnowledgeProjectionTarget, KnowledgeProjectionTargetKind, KnowledgeScheduleRecord, KnowledgeSearchResult, KnowledgeSourceRecord, KnowledgeSourceType, KnowledgeStatus, KnowledgeUsageRecord } from '@pellux/goodvibes-sdk/platform/knowledge/types';
+export interface KnowledgeServiceConfig {
+    readonly configManager?: {
+        getControlPlaneConfigDir?: () => string;
+    };
+    readonly memoryRegistry: Pick<MemoryRegistry, 'add' | 'getAll' | 'getStore'>;
+    readonly runtimeBus?: RuntimeEventBus | null;
+}
+export interface KnowledgeServiceStatus extends KnowledgeStatus {
+    readonly note: string;
+}
+export declare class KnowledgeService {
+    private readonly store;
+    private readonly artifactStore;
+    private readonly connectorRegistry;
+    private readonly options;
+    private readonly projectionService;
+    private readonly scheduleService;
+    private runtimeBus;
+    constructor(store: KnowledgeStore, artifactStore: ArtifactStore, connectorRegistry: KnowledgeConnectorRegistry | undefined, options: KnowledgeServiceConfig);
+    private getIngestContext;
+    private getPacketContext;
+    private getConsolidationContext;
+    attachRuntimeBus(runtimeBus: RuntimeEventBus | null | undefined): void;
+    getStatus(): Promise<KnowledgeServiceStatus>;
+    listUsageRecords(limit?: number, input?: {
+        readonly targetKind?: KnowledgeUsageRecord['targetKind'];
+        readonly targetId?: string;
+        readonly usageKind?: KnowledgeUsageRecord['usageKind'];
+    }): readonly KnowledgeUsageRecord[];
+    listConsolidationCandidates(limit?: number, input?: {
+        readonly status?: KnowledgeConsolidationCandidateRecord['status'];
+        readonly subjectKind?: KnowledgeConsolidationCandidateRecord['subjectKind'];
+        readonly subjectId?: string;
+    }): readonly KnowledgeConsolidationCandidateRecord[];
+    getConsolidationCandidate(id: string): KnowledgeConsolidationCandidateRecord | null;
+    listConsolidationReports(limit?: number): readonly KnowledgeConsolidationReportRecord[];
+    getConsolidationReport(id: string): KnowledgeConsolidationReportRecord | null;
+    listSchedules(limit?: number): readonly KnowledgeScheduleRecord[];
+    getSchedule(id: string): KnowledgeScheduleRecord | null;
+    listSources(limit?: number): KnowledgeSourceRecord[];
+    querySources(input?: {
+        readonly limit?: number;
+        readonly offset?: number;
+        readonly status?: string;
+        readonly connectorId?: string;
+        readonly sourceType?: string;
+        readonly tag?: string;
+        readonly query?: string;
+    }): {
+        total: number;
+        items: KnowledgeSourceRecord[];
+    };
+    listNodes(limit?: number): KnowledgeNodeRecord[];
+    queryNodes(input?: {
+        readonly limit?: number;
+        readonly offset?: number;
+        readonly kind?: string;
+        readonly status?: string;
+        readonly query?: string;
+    }): {
+        total: number;
+        items: KnowledgeNodeRecord[];
+    };
+    listIssues(limit?: number): KnowledgeIssueRecord[];
+    queryIssues(input?: {
+        readonly limit?: number;
+        readonly offset?: number;
+        readonly severity?: string;
+        readonly status?: string;
+        readonly code?: string;
+        readonly query?: string;
+    }): {
+        total: number;
+        items: KnowledgeIssueRecord[];
+    };
+    listExtractions(limit?: number, sourceId?: string): KnowledgeExtractionRecord[];
+    getExtraction(id: string): KnowledgeExtractionRecord | null;
+    getSourceExtraction(sourceId: string): KnowledgeExtractionRecord | null;
+    listConnectors(): readonly KnowledgeConnector[];
+    getConnector(id: string): KnowledgeConnector | null;
+    doctorConnector(id: string): Promise<KnowledgeConnectorDoctorReport | null>;
+    registerConnector(connector: KnowledgeConnector, options?: {
+        replace?: boolean;
+    }): void;
+    getItem(id: string): KnowledgeItemView | null;
+    getItems(ids: readonly string[]): KnowledgeItemView[];
+    recordUsage(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>;
+    }): Promise<KnowledgeUsageRecord>;
+    getNeighbors(kind: 'source' | 'node', id: string, input?: {
+        readonly relation?: string;
+        readonly limit?: number;
+    }): {
+        readonly edges: readonly KnowledgeEdgeRecord[];
+        readonly sources: readonly KnowledgeSourceRecord[];
+        readonly nodes: readonly KnowledgeNodeRecord[];
+    };
+    ingestUrl(input: {
+        readonly url: string;
+        readonly title?: string;
+        readonly tags?: readonly string[];
+        readonly folderPath?: string;
+        readonly sessionId?: string;
+        readonly sourceType?: KnowledgeSourceType;
+        readonly connectorId?: string;
+        readonly allowPrivateHosts?: boolean;
+        readonly metadata?: Record<string, unknown>;
+    }): Promise<{
+        source: KnowledgeSourceRecord;
+        artifactId?: string;
+        extraction?: KnowledgeExtractionRecord;
+        issues: readonly KnowledgeIssueRecord[];
+    }>;
+    ingestArtifact(input: {
+        readonly artifactId?: string;
+        readonly path?: string;
+        readonly uri?: string;
+        readonly title?: string;
+        readonly tags?: readonly string[];
+        readonly folderPath?: string;
+        readonly sessionId?: string;
+        readonly sourceType?: KnowledgeSourceType;
+        readonly connectorId?: string;
+        readonly allowPrivateHosts?: boolean;
+        readonly metadata?: Record<string, unknown>;
+    }): Promise<{
+        source: KnowledgeSourceRecord;
+        artifactId?: string;
+        extraction?: KnowledgeExtractionRecord;
+        issues: readonly KnowledgeIssueRecord[];
+    }>;
+    importBookmarksFromFile(input: {
+        readonly path: string;
+        readonly sessionId?: string;
+        readonly allowPrivateHosts?: boolean;
+    }): Promise<KnowledgeBatchIngestResult>;
+    importUrlsFromFile(input: {
+        readonly path: string;
+        readonly sessionId?: string;
+        readonly allowPrivateHosts?: boolean;
+    }): Promise<KnowledgeBatchIngestResult>;
+    ingestBookmarkSeeds(seeds: readonly KnowledgeBookmarkSeed[], sessionId?: string, sourceType?: KnowledgeSourceType, connectorId?: string, allowPrivateHosts?: boolean): Promise<KnowledgeBatchIngestResult>;
+    ingestWithConnector(connectorId: string, input: unknown, sessionId?: string, allowPrivateHosts?: boolean): Promise<KnowledgeBatchIngestResult>;
+    ingestConnectorInput(input: {
+        readonly connectorId: string;
+        readonly input?: unknown;
+        readonly content?: string;
+        readonly path?: string;
+        readonly sessionId?: string;
+        readonly allowPrivateHosts?: boolean;
+    }): Promise<KnowledgeBatchIngestResult>;
+    listProjectionTargets(limit?: number): Promise<KnowledgeProjectionTarget[]>;
+    renderProjection(input: {
+        readonly kind: KnowledgeProjectionTargetKind;
+        readonly id?: string;
+        readonly limit?: number;
+    }): Promise<KnowledgeProjectionBundle>;
+    materializeProjection(input: {
+        readonly kind: KnowledgeProjectionTargetKind;
+        readonly id?: string;
+        readonly limit?: number;
+        readonly filename?: string;
+    }): Promise<KnowledgeMaterializedProjection>;
+    reindex(): Promise<{
+        status: KnowledgeStatus;
+        issues: readonly KnowledgeIssueRecord[];
+    }>;
+    search(query: string, limit?: number): KnowledgeSearchResult[];
+    buildPacket(task: string, writeScope?: readonly string[], limit?: number, options?: {
+        readonly detail?: KnowledgePacketDetail;
+        readonly budgetLimit?: number;
+    }): Promise<KnowledgePacket>;
+    buildPacketSync(task: string, writeScope?: readonly string[], limit?: number, options?: {
+        readonly detail?: KnowledgePacketDetail;
+        readonly budgetLimit?: number;
+    }): KnowledgePacket | null;
+    buildPromptPacketSync(task: string, writeScope?: readonly string[], limit?: number, options?: {
+        readonly detail?: KnowledgePacketDetail;
+        readonly budgetLimit?: number;
+    }): string | null;
+    buildPromptPacket(task: string, writeScope?: readonly string[], limit?: number, options?: {
+        readonly detail?: KnowledgePacketDetail;
+        readonly budgetLimit?: number;
+    }): Promise<string | null>;
+    listJobs(): readonly KnowledgeJobRecord[];
+    getJob(id: string): KnowledgeJobRecord | null;
+    saveSchedule(input: {
+        readonly id?: string;
+        readonly jobId: string;
+        readonly label?: string;
+        readonly enabled?: boolean;
+        readonly schedule: AutomationScheduleDefinition;
+        readonly metadata?: Record<string, unknown>;
+    }): Promise<KnowledgeScheduleRecord>;
+    deleteSchedule(id: string): Promise<boolean>;
+    setScheduleEnabled(id: string, enabled: boolean): Promise<KnowledgeScheduleRecord | null>;
+    decideConsolidationCandidate(id: string, decision: 'accept' | 'reject' | 'supersede', input?: {
+        readonly decidedBy?: string;
+        readonly memoryClass?: string;
+        readonly scope?: string;
+        readonly detail?: string;
+    }): Promise<KnowledgeConsolidationCandidateRecord>;
+    listJobRuns(limit?: number, jobId?: string): readonly KnowledgeJobRunRecord[];
+    runJob(id: string, input?: {
+        readonly mode?: KnowledgeJobMode;
+        readonly sourceIds?: readonly string[];
+        readonly limit?: number;
+    }): Promise<KnowledgeJobRunRecord>;
+    private runJobByKind;
+    private deferUsage;
+    private syncReviewedMemory;
+    private dispose;
+    lint(): Promise<readonly KnowledgeIssueRecord[]>;
+    private emitIfReady;
+}
+export declare function buildCuratedKnowledgePromptSync(service: Pick<KnowledgeService, 'buildPromptPacketSync'>, task: string, writeScope?: readonly string[]): string | null;
+//# sourceMappingURL=service.d.ts.map

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

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

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

@@ -0,0 +1,420 @@
+import { randomUUID } from 'node:crypto';
+import {} from '@pellux/goodvibes-sdk/platform/automation/schedules';
+import { ArtifactStore } from '@pellux/goodvibes-sdk/platform/artifacts/index';
+import { createDefaultKnowledgeConnectorRegistry, KnowledgeConnectorRegistry } from '@pellux/goodvibes-sdk/platform/knowledge/connectors';
+import { KnowledgeProjectionService } from '@pellux/goodvibes-sdk/platform/knowledge/projections';
+import { KnowledgeStore } from '@pellux/goodvibes-sdk/platform/knowledge/store';
+import { buildKnowledgePacket, buildKnowledgePacketSync, buildKnowledgePromptPacket, buildKnowledgePromptPacketSync, searchKnowledge, } from './packet.js';
+import { ingestKnowledgeArtifact, ingestKnowledgeBookmarkSeeds, ingestKnowledgeConnectorInput, ingestKnowledgeUrl, ingestKnowledgeWithConnector, importKnowledgeBookmarksFromFile, importKnowledgeUrlsFromFile, refreshKnowledgeSources, pickKnowledgeRefreshCandidates, recompileKnowledgeSource, } from './ingest.js';
+import { decideKnowledgeConsolidationCandidate, runKnowledgeConsolidation, } from './consolidation.js';
+import { KnowledgeScheduleService } from './scheduling.js';
+import { lintKnowledgeStore } from './lint.js';
+import { syncKnowledgeMemoryNodes } from './memory-sync.js';
+import { emitKnowledgeExtractionCompleted, emitKnowledgeExtractionFailed, emitKnowledgeIngestCompleted, emitKnowledgeIngestFailed, emitKnowledgeIngestStarted, emitKnowledgePacketBuilt, emitKnowledgeProjectionMaterialized, emitKnowledgeProjectionRendered, } from '../runtime/emitters/index.js';
+import { extractKnowledgeArtifact } from '@pellux/goodvibes-sdk/platform/knowledge/extractors';
+import { canonicalizeUri as internalCanonicalizeUri, DEFAULT_PACKET_BUDGET as internalDefaultPacketBudget, DEFAULT_PACKET_LIMIT as internalDefaultPacketLimit, isHttpUri as internalIsHttpUri, isSourcePastRefreshWindow as internalIsSourcePastRefreshWindow, tokenize as internalTokenize, } from './internal.js';
+const DEFAULT_PACKET_LIMIT = internalDefaultPacketLimit;
+const DEFAULT_PACKET_BUDGET = internalDefaultPacketBudget;
+const tokenize = internalTokenize;
+const canonicalizeUri = internalCanonicalizeUri;
+const isHttpUri = internalIsHttpUri;
+export class KnowledgeService {
+    store;
+    artifactStore;
+    connectorRegistry;
+    options;
+    projectionService;
+    scheduleService;
+    runtimeBus;
+    constructor(store, artifactStore, connectorRegistry = createDefaultKnowledgeConnectorRegistry(), options) {
+        this.store = store;
+        this.artifactStore = artifactStore;
+        this.connectorRegistry = connectorRegistry;
+        this.options = options;
+        this.runtimeBus = options.runtimeBus ?? null;
+        void this.store.init();
+        this.projectionService = new KnowledgeProjectionService(this.store, this.artifactStore, {
+            connectors: () => this.listConnectors(),
+        });
+        this.scheduleService = new KnowledgeScheduleService({
+            store: this.store,
+            emitIfReady: this.emitIfReady.bind(this),
+            runJobByKind: this.runJobByKind.bind(this),
+        });
+    }
+    getIngestContext() {
+        return {
+            store: this.store,
+            artifactStore: this.artifactStore,
+            connectorRegistry: this.connectorRegistry,
+            emitIfReady: this.emitIfReady.bind(this),
+            syncReviewedMemory: this.syncReviewedMemory.bind(this),
+            lint: this.lint.bind(this),
+            listConnectors: () => this.listConnectors(),
+        };
+    }
+    getPacketContext() {
+        return {
+            store: this.store,
+            deferUsage: this.deferUsage.bind(this),
+            emitIfReady: this.emitIfReady.bind(this),
+        };
+    }
+    getConsolidationContext() {
+        return {
+            store: this.store,
+            memoryRegistry: this.options.memoryRegistry,
+            syncReviewedMemory: this.syncReviewedMemory.bind(this),
+        };
+    }
+    attachRuntimeBus(runtimeBus) {
+        if (runtimeBus)
+            this.runtimeBus = runtimeBus;
+    }
+    async getStatus() {
+        await this.store.init();
+        return {
+            ...this.store.status(),
+            note: 'Structured knowledge uses SQL-backed sources, nodes, edges, issues, extractions, and job runs. Markdown is an optional projection, not the source of truth.',
+        };
+    }
+    listUsageRecords(limit = 100, input = {}) {
+        return this.store.listUsageRecords(limit, input);
+    }
+    listConsolidationCandidates(limit = 100, input = {}) {
+        return this.store.listConsolidationCandidates(limit, input);
+    }
+    getConsolidationCandidate(id) {
+        return this.store.getConsolidationCandidate(id);
+    }
+    listConsolidationReports(limit = 100) {
+        return this.store.listConsolidationReports(limit);
+    }
+    getConsolidationReport(id) {
+        return this.store.getConsolidationReport(id);
+    }
+    listSchedules(limit = 100) {
+        return this.store.listSchedules(limit);
+    }
+    getSchedule(id) {
+        return this.store.getSchedule(id);
+    }
+    listSources(limit = 100) {
+        return this.store.listSources(limit);
+    }
+    querySources(input = {}) {
+        const limit = Math.max(1, input.limit ?? 100);
+        const offset = Math.max(0, input.offset ?? 0);
+        const queryTokens = tokenize(input.query ?? '');
+        const items = this.store.listSources(10_000).filter((source) => {
+            if (input.status && source.status !== input.status)
+                return false;
+            if (input.connectorId && source.connectorId !== input.connectorId)
+                return false;
+            if (input.sourceType && source.sourceType !== input.sourceType)
+                return false;
+            if (input.tag && !source.tags.includes(input.tag))
+                return false;
+            if (queryTokens.length === 0)
+                return true;
+            const extraction = this.store.getExtractionBySourceId(source.id);
+            const haystack = [
+                source.title ?? '',
+                source.summary ?? '',
+                source.description ?? '',
+                source.sourceUri ?? '',
+                source.canonicalUri ?? '',
+                source.folderPath ?? '',
+                source.tags.join(' '),
+                extraction?.summary ?? '',
+                extraction?.excerpt ?? '',
+                extraction?.sections.join(' ') ?? '',
+            ].join(' ').toLowerCase();
+            return queryTokens.every((token) => haystack.includes(token));
+        });
+        return {
+            total: items.length,
+            items: items.slice(offset, offset + limit),
+        };
+    }
+    listNodes(limit = 100) {
+        return this.store.listNodes(limit);
+    }
+    queryNodes(input = {}) {
+        const limit = Math.max(1, input.limit ?? 100);
+        const offset = Math.max(0, input.offset ?? 0);
+        const queryTokens = tokenize(input.query ?? '');
+        const items = this.store.listNodes(10_000).filter((node) => {
+            if (input.kind && node.kind !== input.kind)
+                return false;
+            if (input.status && node.status !== input.status)
+                return false;
+            if (queryTokens.length === 0)
+                return true;
+            const haystack = [
+                node.title,
+                node.summary ?? '',
+                node.aliases.join(' '),
+                JSON.stringify(node.metadata),
+            ].join(' ').toLowerCase();
+            return queryTokens.every((token) => haystack.includes(token));
+        });
+        return {
+            total: items.length,
+            items: items.slice(offset, offset + limit),
+        };
+    }
+    listIssues(limit = 100) {
+        return this.store.listIssues(limit);
+    }
+    queryIssues(input = {}) {
+        const limit = Math.max(1, input.limit ?? 100);
+        const offset = Math.max(0, input.offset ?? 0);
+        const queryTokens = tokenize(input.query ?? '');
+        const items = this.store.listIssues(10_000).filter((issue) => {
+            if (input.severity && issue.severity !== input.severity)
+                return false;
+            if (input.status && issue.status !== input.status)
+                return false;
+            if (input.code && issue.code !== input.code)
+                return false;
+            if (queryTokens.length === 0)
+                return true;
+            const haystack = [issue.message, issue.code, JSON.stringify(issue.metadata)].join(' ').toLowerCase();
+            return queryTokens.every((token) => haystack.includes(token));
+        });
+        return {
+            total: items.length,
+            items: items.slice(offset, offset + limit),
+        };
+    }
+    listExtractions(limit = 100, sourceId) {
+        const records = this.store.listExtractions(sourceId ? 10_000 : limit);
+        return sourceId ? records.filter((entry) => entry.sourceId === sourceId).slice(0, Math.max(1, limit)) : records;
+    }
+    getExtraction(id) {
+        return this.store.getExtraction(id);
+    }
+    getSourceExtraction(sourceId) {
+        return this.store.getExtractionBySourceId(sourceId);
+    }
+    listConnectors() {
+        return this.connectorRegistry.list();
+    }
+    getConnector(id) {
+        return this.connectorRegistry.get(id) ?? null;
+    }
+    async doctorConnector(id) {
+        return this.connectorRegistry.doctor(id);
+    }
+    registerConnector(connector, options = {}) {
+        this.connectorRegistry.register(connector, options);
+    }
+    getItem(id) {
+        const item = this.store.getItem(id);
+        if (item?.source)
+            this.deferUsage({ targetKind: 'source', targetId: item.source.id, usageKind: 'item-open' });
+        if (item?.node)
+            this.deferUsage({ targetKind: 'node', targetId: item.node.id, usageKind: 'item-open' });
+        if (item?.issue)
+            this.deferUsage({ targetKind: 'issue', targetId: item.issue.id, usageKind: 'item-open' });
+        return item;
+    }
+    getItems(ids) {
+        return ids.map((id) => this.getItem(id)).filter((item) => Boolean(item));
+    }
+    async recordUsage(input) {
+        await this.store.init();
+        return this.store.upsertUsageRecord(input);
+    }
+    getNeighbors(kind, id, input = {}) {
+        const limit = Math.max(1, input.limit ?? 20);
+        const edges = this.store.edgesFor(kind, id)
+            .filter((edge) => !input.relation || edge.relation === input.relation)
+            .slice(0, limit);
+        this.deferUsage({
+            targetKind: kind,
+            targetId: id,
+            usageKind: 'neighbor-open',
+            metadata: input.relation ? { relation: input.relation } : {},
+        });
+        const sources = [];
+        const nodes = [];
+        for (const edge of edges) {
+            const otherKind = edge.fromKind === kind && edge.fromId === id ? edge.toKind : edge.fromKind;
+            const otherId = edge.fromKind === kind && edge.fromId === id ? edge.toId : edge.fromId;
+            if (otherKind === 'source') {
+                const source = this.store.getSource(otherId);
+                if (source)
+                    sources.push(source);
+            }
+            else if (otherKind === 'node') {
+                const node = this.store.getNode(otherId);
+                if (node)
+                    nodes.push(node);
+            }
+        }
+        return { edges, sources, nodes };
+    }
+    async ingestUrl(input) {
+        return ingestKnowledgeUrl(this.getIngestContext(), input);
+    }
+    async ingestArtifact(input) {
+        return ingestKnowledgeArtifact(this.getIngestContext(), input);
+    }
+    async importBookmarksFromFile(input) {
+        return importKnowledgeBookmarksFromFile(this.getIngestContext(), input);
+    }
+    async importUrlsFromFile(input) {
+        return importKnowledgeUrlsFromFile(this.getIngestContext(), input);
+    }
+    async ingestBookmarkSeeds(seeds, sessionId, sourceType = 'bookmark', connectorId = 'bookmark', allowPrivateHosts) {
+        return ingestKnowledgeBookmarkSeeds(this.getIngestContext(), seeds, sessionId, sourceType, connectorId, allowPrivateHosts);
+    }
+    async ingestWithConnector(connectorId, input, sessionId, allowPrivateHosts) {
+        return ingestKnowledgeWithConnector(this.getIngestContext(), connectorId, input, sessionId, allowPrivateHosts);
+    }
+    async ingestConnectorInput(input) {
+        return ingestKnowledgeConnectorInput(this.getIngestContext(), input);
+    }
+    async listProjectionTargets(limit = 25) {
+        return this.projectionService.listTargets(limit);
+    }
+    async renderProjection(input) {
+        const bundle = await this.projectionService.render(input);
+        this.emitIfReady((bus, ctx) => emitKnowledgeProjectionRendered(bus, ctx, {
+            targetId: bundle.target.targetId,
+            pageCount: bundle.pageCount,
+        }));
+        return bundle;
+    }
+    async materializeProjection(input) {
+        const materialized = await this.projectionService.materialize(input);
+        this.emitIfReady((bus, ctx) => emitKnowledgeProjectionMaterialized(bus, ctx, {
+            targetId: materialized.bundle.target.targetId,
+            artifactId: materialized.artifact.id,
+            pageCount: materialized.bundle.pageCount,
+        }));
+        return materialized;
+    }
+    async reindex() {
+        await this.store.init();
+        for (const source of this.store.listSources(10_000)) {
+            await recompileKnowledgeSource(this.getIngestContext(), source);
+        }
+        await this.syncReviewedMemory();
+        const issues = await lintKnowledgeStore({ store: this.store, emitIfReady: this.emitIfReady.bind(this) });
+        return { status: this.store.status(), issues };
+    }
+    search(query, limit = 10) {
+        return searchKnowledge(this.getPacketContext(), query, limit);
+    }
+    async buildPacket(task, writeScope = [], limit = DEFAULT_PACKET_LIMIT, options = {}) {
+        return buildKnowledgePacket(this.getPacketContext(), task, writeScope, limit, options);
+    }
+    buildPacketSync(task, writeScope = [], limit = DEFAULT_PACKET_LIMIT, options = {}) {
+        return buildKnowledgePacketSync(this.getPacketContext(), task, writeScope, limit, options);
+    }
+    buildPromptPacketSync(task, writeScope = [], limit = DEFAULT_PACKET_LIMIT, options = {}) {
+        return buildKnowledgePromptPacketSync(this.getPacketContext(), task, writeScope, limit, options);
+    }
+    async buildPromptPacket(task, writeScope = [], limit = DEFAULT_PACKET_LIMIT, options = {}) {
+        return buildKnowledgePromptPacket(this.getPacketContext(), task, writeScope, limit, options);
+    }
+    listJobs() {
+        return this.scheduleService.listJobs();
+    }
+    getJob(id) {
+        return this.scheduleService.getJob(id);
+    }
+    async saveSchedule(input) {
+        return this.scheduleService.saveSchedule(input);
+    }
+    async deleteSchedule(id) {
+        return this.scheduleService.deleteSchedule(id);
+    }
+    async setScheduleEnabled(id, enabled) {
+        return this.scheduleService.setScheduleEnabled(id, enabled);
+    }
+    async decideConsolidationCandidate(id, decision, input = {}) {
+        return decideKnowledgeConsolidationCandidate(this.getConsolidationContext(), id, decision, input);
+    }
+    listJobRuns(limit = 100, jobId) {
+        return this.scheduleService.listJobRuns(limit, jobId);
+    }
+    async runJob(id, input = {}) {
+        return this.scheduleService.runJob(id, input);
+    }
+    async runJobByKind(kind, input) {
+        switch (kind) {
+            case 'lint': {
+                const issues = await lintKnowledgeStore({ store: this.store, emitIfReady: this.emitIfReady.bind(this) });
+                return { issueCount: issues.length };
+            }
+            case 'reindex': {
+                const result = await this.reindex();
+                return { sourceCount: result.status.sourceCount, issueCount: result.issues.length };
+            }
+            case 'refresh-stale': {
+                const refreshed = await refreshKnowledgeSources(this.getIngestContext(), pickKnowledgeRefreshCandidates({ store: this.store }, 'stale', input.sourceIds, input.limit));
+                return { refreshed };
+            }
+            case 'refresh-bookmarks': {
+                const refreshed = await refreshKnowledgeSources(this.getIngestContext(), pickKnowledgeRefreshCandidates({ store: this.store }, 'bookmark', input.sourceIds, input.limit));
+                return { refreshed };
+            }
+            case 'rebuild-projections': {
+                const overview = await this.materializeProjection({ kind: 'overview', limit: Math.max(8, input.limit ?? 12) });
+                const bundle = await this.materializeProjection({ kind: 'bundle', limit: Math.max(12, input.limit ?? 18) });
+                return {
+                    projections: [
+                        { targetId: overview.bundle.target.targetId, artifactId: overview.artifact.id },
+                        { targetId: bundle.bundle.target.targetId, artifactId: bundle.artifact.id },
+                    ],
+                };
+            }
+            case 'light-consolidation': {
+                const report = await runKnowledgeConsolidation(this.getConsolidationContext(), 'light-consolidation', {
+                    limit: input.limit,
+                    autoPromote: false,
+                });
+                return { reportId: report.id, metrics: report.metrics };
+            }
+            case 'deep-consolidation': {
+                const report = await runKnowledgeConsolidation(this.getConsolidationContext(), 'deep-consolidation', {
+                    limit: input.limit,
+                    autoPromote: true,
+                });
+                return { reportId: report.id, metrics: report.metrics };
+            }
+            default:
+                return {};
+        }
+    }
+    deferUsage(input) {
+        queueMicrotask(() => {
+            void this.recordUsage(input).catch(() => { });
+        });
+    }
+    async syncReviewedMemory() {
+        await syncKnowledgeMemoryNodes(this.store, this.options.memoryRegistry);
+    }
+    dispose() {
+        this.scheduleService.dispose();
+    }
+    async lint() {
+        return lintKnowledgeStore({ store: this.store, emitIfReady: this.emitIfReady.bind(this) });
+    }
+    emitIfReady(fn, sessionId) {
+        if (!this.runtimeBus)
+            return;
+        fn(this.runtimeBus, {
+            traceId: randomUUID(),
+            sessionId: sessionId ?? 'knowledge-runtime',
+            source: 'knowledge.service',
+        });
+    }
+}
+export function buildCuratedKnowledgePromptSync(service, task, writeScope = []) {
+    return service.buildPromptPacketSync(task, writeScope);
+}