@calliopelabs/cli 3.2.0 → 3.3.0

package/dist/brain/kg-claims.js

@@ -0,0 +1,156 @@
+/** Preserve rich foreign claims without extending the closed native journal schema. */
+import { digest } from '../approvals/index.js';
+import { sanitizeBrainValue, hasBrainSecrets } from './access.js';
+import { canonicalExchangeJson } from './exchange-json.js';
+import { knowledgeGraphDigest, } from './kg.js';
+import { BrainError, ENTITY_KINDS, } from './types.js';
+import { obj, text, identifier, entity, edge, source } from './validation.js';
+export function graphOrigin(graph, archive, explicit) {
+    const claims = [...graph.nodes, ...graph.edges].map((record) => record.props.origin);
+    const embedded = claims.filter((value) => value !== undefined);
+    if (embedded.some((value) => !obj(value) || typeof value.id !== 'string' || typeof value.revision !== 'string'))
+        throw new BrainError('invalid', 'Graph origin claims require an ID and revision.');
+    const ids = new Set(embedded.map((value) => value.id));
+    const revisions = new Set(embedded.map((value) => value.revision));
+    if (ids.size > 1 || revisions.size > 1)
+        throw new BrainError('invalid', 'Graph origin claims disagree.');
+    const claimedId = ids.values().next().value;
+    const id = archive?.origin.id ?? explicit ?? claimedId;
+    if (!id)
+        throw new BrainError('invalid', 'A bare graph needs --origin or consistent embedded origin claims.');
+    if ((explicit && explicit !== id) || (claimedId && claimedId !== id))
+        throw new BrainError('invalid', 'Explicit, archive and graph origin IDs must agree.');
+    const claimedRevision = revisions.values().next().value;
+    if (archive && claimedRevision && archive.origin.revision !== claimedRevision)
+        throw new BrainError('invalid', 'Archive and graph origin revisions disagree.');
+    const revision = archive?.origin.revision ?? claimedRevision ?? knowledgeGraphDigest(graph);
+    text(id, 512);
+    text(revision, 512);
+    if (hasBrainSecrets({ id, revision }))
+        throw new BrainError('policy-denied', 'Origin identifiers contain secret material.');
+    return { id, revision };
+}
+export const graphNamespace = (origin, kind, id) => 'import:kg:' + digest(canonicalExchangeJson([origin, kind, id]));
+export function edgeIdentities(graph) {
+    const triples = graph.edges.map((record) => canonicalExchangeJson([record.source, record.type, record.target]));
+    const counts = new Map();
+    for (const triple of triples)
+        counts.set(triple, (counts.get(triple) ?? 0) + 1);
+    const ids = graph.edges.map((record, index) => {
+        if (Object.hasOwn(record.props, 'id')) {
+            text(record.props.id, 512);
+            return record.props.id;
+        }
+        if (counts.get(triples[index]) !== 1)
+            throw new BrainError('invalid', 'Parallel relationships require distinct explicit props.id values.');
+        return 'derived:' + digest(triples[index]);
+    });
+    if (new Set(ids).size !== ids.length)
+        throw new BrainError('invalid', 'Duplicate relationship IDs.');
+    return ids;
+}
+export function claimSource(value, locator, losses) {
+    const original = canonicalExchangeJson(value), clean = sanitizeBrainValue(value);
+    if (hasBrainSecrets(clean))
+        throw new BrainError('policy-denied', 'Transfer metadata contains secret keys that cannot be safely retained.');
+    const content = canonicalExchangeJson(clean), originalHash = digest(original), contentHash = digest(content);
+    if (content !== original)
+        losses.push({
+            code: 'redaction',
+            message: 'Recognized secrets are redacted from retained source claims.',
+        });
+    return source({
+        id: 'source:kg:' + digest(originalHash + ':' + contentHash),
+        kind: 'import',
+        name: 'Portable graph source claim',
+        content,
+        originalHash,
+        contentHash,
+        redacted: content !== original,
+        locator,
+    });
+}
+export function projectClaim(kind, externalId, record, origin, sourceIds, losses) {
+    const clean = sanitizeBrainValue(record), props = clean.props;
+    const loss = (code, message, fields) => losses.push({
+        code,
+        record: { kind, id: externalId },
+        message,
+        ...(fields ? { fields } : {}),
+    });
+    if (hasBrainSecrets(externalId))
+        throw new BrainError('policy-denied', 'Record identifiers contain secret material.');
+    let confidence = props.confidence;
+    if (confidence === undefined || confidence === null || confidence === 'unknown') {
+        loss('unknown-confidence', 'Native projection uses zero for unknown confidence; the original claim remains in its source.');
+        confidence = 0;
+    }
+    if (typeof confidence !== 'number' || confidence < 0 || confidence > 1)
+        throw new BrainError('invalid', 'Confidence must be in [0,1] or explicitly unknown; values are never clamped.');
+    const sourceOnly = Object.keys(props).filter((key) => !['summary', 'state', 'confidence', 'attributes', 'id'].includes(key));
+    if (sourceOnly.length)
+        loss('source-only-metadata', 'Evidence, origin and other metadata remain source claims; native queries do not interpret them.', sourceOnly);
+    if (props.state !== undefined && props.state !== 'proposed')
+        loss('local-review', 'Imported status remains a source claim; the local projection starts proposed.', ['state']);
+    const common = {
+        id: graphNamespace(origin, kind, externalId),
+        state: 'proposed',
+        confidence,
+        provenance: sourceIds.map((sourceId) => ({
+            sourceId,
+            basis: 'inferred',
+        })),
+    };
+    if (kind === 'edge') {
+        const relation = clean;
+        if (Object.hasOwn(props, 'summary') || Object.hasOwn(props, 'attributes'))
+            loss('source-only-edge-properties', 'Relationship summary and attributes remain source claims.', ['summary', 'attributes']);
+        if (!identifier(relation.type))
+            throw new BrainError('invalid', 'Relationship type cannot be represented by the native identifier grammar.');
+        return edge({
+            ...common,
+            from: graphNamespace(origin, 'entity', relation.source),
+            to: graphNamespace(origin, 'entity', relation.target),
+            type: relation.type,
+        });
+    }
+    const node = clean;
+    const nativeKind = ENTITY_KINDS.includes(node.type)
+        ? node.type
+        : 'artifact';
+    if (nativeKind !== node.type)
+        loss('unsupported-kind', 'Native projection uses artifact for this foreign kind; the original kind is retained.');
+    const attributes = {
+        externalId,
+        externalType: node.type,
+    };
+    if (props.attributes !== undefined && !obj(props.attributes))
+        loss('source-only-attributes', 'Non-object attributes remain source claims.', ['attributes']);
+    if (obj(props.attributes)) {
+        const omitted = [];
+        for (const [key, value] of Object.entries(props.attributes)) {
+            if (['externalId', 'externalType'].includes(key) ||
+                (value !== null && !['string', 'number', 'boolean'].includes(typeof value)))
+                omitted.push(key);
+            else
+                Object.defineProperty(attributes, key, {
+                    value,
+                    enumerable: true,
+                    writable: true,
+                    configurable: true,
+                });
+        }
+        if (omitted.length)
+            loss('source-only-attributes', 'Nested or reserved attributes remain source claims.', omitted);
+    }
+    if (props.summary !== undefined && typeof props.summary !== 'string')
+        loss('source-only-summary', 'Non-text summary remains a source claim; the projection uses the name.', ['summary']);
+    return entity({
+        ...common,
+        kind: nativeKind,
+        name: node.name,
+        summary: typeof props.summary === 'string' ? props.summary : node.name,
+        attributes,
+    });
+}
+//# sourceMappingURL=kg-claims.js.map

package/dist/brain/kg-claims.js.map

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

package/dist/brain/kg-export.d.ts

@@ -0,0 +1,13 @@
+import { type BrainTransferOptions } from './exchange.js';
+import { type TransferReport } from './transfer-report.js';
+/** Explicit graph projection, with source snapshots but without journal history. */
+export declare function exportKnowledgeGraphFile(cwd: string, path: string, options?: BrainTransferOptions): Promise<{
+    path: string;
+    format: "brain-exchange/v2" | "calliope-kg/v1" | "conflict-kg/v1";
+    nodes: number;
+    edges: number;
+    revision: string;
+    report: TransferReport;
+    preview: boolean;
+}>;
+//# sourceMappingURL=kg-export.d.ts.map

package/dist/brain/kg-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kg-export.d.ts","sourceRoot":"","sources":["../../src/brain/kg-export.ts"],"names":[],"mappings":"AAQA,OAAO,EAAgB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI/E,oFAAoF;AACpF,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB;;;;;;;;GAsHnC"}

package/dist/brain/kg-export.js

@@ -0,0 +1,116 @@
+import * as fs from 'node:fs';
+import { dirname, basename, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { digest } from '../approvals/index.js';
+import { authorizeSessionAction } from '../session-management/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { brainStore, BrainAccess, readBrainFile, projectFile, hasBrainSecrets } from './access.js';
+import { parseExchangeJson, canonicalExchangeJson } from './exchange-json.js';
+import { makeExchange } from './exchange.js';
+import { exportKnowledgeGraph } from './kg.js';
+import { BrainTransferError } from './transfer-report.js';
+import { BrainError } from './types.js';
+import { obj } from './validation.js';
+/** Explicit graph projection, with source snapshots but without journal history. */
+export async function exportKnowledgeGraphFile(cwd, path, options = {}) {
+    if (options.manifestPath && !options.exchange)
+        throw new BrainError('invalid', 'A manifest requires --exchange so it can be retained in the archive.');
+    const store = brainStore(cwd, options), view = store.read(options.signal);
+    await new BrainAccess(cwd, view.state.sources, options).all();
+    const manifestFile = options.manifestPath
+        ? await readBrainFile(cwd, options.manifestPath, options)
+        : undefined;
+    const manifest = manifestFile ? parseExchangeJson(manifestFile.original) : null;
+    if (manifest !== null && !obj(manifest))
+        throw new BrainError('invalid', 'Manifest must be an object.');
+    const graph = exportKnowledgeGraph(view), origin = { id: view.state.header.id, revision: view.state.revision };
+    const report = {
+        format: 'calliope-brain-transfer-report/v1',
+        operation: 'export',
+        representation: 'graph-projection',
+        origin,
+        manifestHash: manifest ? digest(canonicalExchangeJson(manifest)) : null,
+        losses: [
+            {
+                code: 'graph-history',
+                message: 'Graph export omits journal events, tombstones, reversals and unreferenced historical sources. Use native brain export to preserve full history.',
+            },
+        ],
+        mappings: [],
+        conflicts: 0,
+        changes: 0,
+    };
+    const value = options.exchange
+        ? makeExchange(graph, origin, manifest)
+        : graph;
+    if (hasBrainSecrets(value))
+        throw new BrainError('policy-denied', 'Transfer matches current secret material; preserve it privately and export a reviewed sanitized scope.');
+    const content = JSON.stringify(value), target = projectFile(cwd, path);
+    const receipt = {
+        path: target.file,
+        format: value.format,
+        nodes: graph.nodes.length,
+        edges: graph.edges.length,
+        revision: view.state.revision,
+        report,
+    };
+    if (options.preview)
+        return { ...receipt, preview: true };
+    if (!options.allowLoss)
+        throw new BrainTransferError('invalid', 'Review the graph export report and pass --allow-loss to acknowledge its projection limits.', report);
+    await authorizeSessionAction(cwd, 'write_file', {
+        path: target.file,
+        operation: 'brain-kg-export',
+        format: value.format,
+        digest: digest(content),
+        bytes: Buffer.byteLength(content),
+    }, { ...options, confirmation: options.confirmation ?? 'mutating' });
+    // Re-evaluate retained-source scope after approval; foreign locators are never fetched.
+    await new BrainAccess(cwd, view.state.sources, options).all();
+    if (manifestFile) {
+        await readBrainFile(cwd, options.manifestPath, options);
+        manifestFile.assertUnchanged();
+    }
+    if (hasBrainSecrets(value))
+        throw new BrainError('policy-denied', 'Transfer now matches secret material; preview again.');
+    target.recheck();
+    throwIfCancelled(options.signal);
+    const temp = join(dirname(target.file), '.' + basename(target.file) + '-' + randomUUID() + '.tmp');
+    let created = false;
+    try {
+        const fd = fs.openSync(temp, 'wx', 0o600);
+        created = true;
+        try {
+            fs.writeFileSync(fd, content);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        target.recheck();
+        throwIfCancelled(options.signal);
+        fs.linkSync(temp, target.file);
+        // POSIX-only: Windows denies FlushFileBuffers on a directory handle opened via 'r' (#382, #384, #388).
+        if (process.platform !== 'win32') {
+            const parent = fs.openSync(dirname(target.file), 'r');
+            try {
+                fs.fsyncSync(parent);
+            }
+            finally {
+                fs.closeSync(parent);
+            }
+        }
+        return { ...receipt, preview: false };
+    }
+    finally {
+        if (created)
+            try {
+                target.recheck();
+                fs.unlinkSync(temp);
+            }
+            catch {
+                /* Preserve replaced directories. */
+            }
+    }
+}
+//# sourceMappingURL=kg-export.js.map

package/dist/brain/kg-export.js.map

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

package/dist/brain/kg-transfer.d.ts

@@ -0,0 +1,29 @@
+import { type BrainTransferOptions } from './exchange.js';
+import { type TransferReport } from './transfer-report.js';
+/** Normal journal transaction; a transfer's metadata never authorizes a write. */
+export declare function importKnowledgeGraph(cwd: string, path: string, options?: BrainTransferOptions): Promise<{
+    journal: import("./types.js").BrainJournal;
+    state: import("./types.js").BrainState;
+    index: 'unchanged';
+    preview: boolean;
+    imported: number;
+    unchanged: boolean;
+    report: TransferReport;
+} | {
+    journal: import("./types.js").BrainJournal;
+    state: import("./types.js").BrainState;
+    index: 'current';
+    preview: boolean;
+    imported: number;
+    unchanged: boolean;
+    report: TransferReport;
+} | {
+    journal: import("./types.js").BrainJournal;
+    state: import("./types.js").BrainState;
+    index: 'rebuild-required';
+    preview: boolean;
+    imported: number;
+    unchanged: boolean;
+    report: TransferReport;
+}>;
+//# sourceMappingURL=kg-transfer.d.ts.map

package/dist/brain/kg-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kg-transfer.d.ts","sourceRoot":"","sources":["../../src/brain/kg-transfer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAU9F,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW/E,kFAAkF;AAClF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB;;;WAuIvB,WAAW;;;;;;;;;;;;;;;;;;;;;GA6DvB"}

package/dist/brain/kg-transfer.js

@@ -0,0 +1,156 @@
+import { digest } from '../approvals/index.js';
+import { brainStore, BrainAccess, readBrainFile, hasBrainSecrets } from './access.js';
+import { commitBrain } from './actions.js';
+import { parseExchangeJson, canonicalExchangeJson } from './exchange-json.js';
+import { archiveGraph, parseExchangeArchive } from './exchange.js';
+import { parseKnowledgeGraph } from './kg.js';
+import { graphOrigin, edgeIdentities, graphNamespace, claimSource, projectClaim, } from './kg-claims.js';
+import { recordInput } from './journal.js';
+import { BrainTransferError } from './transfer-report.js';
+import { BrainError, BRAIN_LIMITS, } from './types.js';
+import { obj, text } from './validation.js';
+/** Normal journal transaction; a transfer's metadata never authorizes a write. */
+export async function importKnowledgeGraph(cwd, path, options = {}) {
+    const input = await readBrainFile(cwd, path, options, BRAIN_LIMITS.journalBytes);
+    const parsed = parseExchangeJson(input.original);
+    const archive = obj(parsed) && typeof parsed.format === 'string' && parsed.format.startsWith('brain-exchange/')
+        ? parseExchangeArchive(parsed)
+        : undefined;
+    const graph = archive ? archiveGraph(archive) : parseKnowledgeGraph(parsed);
+    const origin = graphOrigin(graph, archive, options.origin), edgeIds = edgeIdentities(graph);
+    const prior = brainStore(cwd, options).read(options.signal);
+    const report = {
+        format: 'calliope-brain-transfer-report/v1',
+        operation: 'import',
+        representation: 'graph-projection',
+        origin,
+        destinationRevision: prior.state.revision,
+        manifestHash: archive?.manifest ? digest(canonicalExchangeJson(archive.manifest)) : null,
+        losses: [
+            {
+                code: 'graph-history',
+                message: 'A graph snapshot cannot restore journal history, tombstones or reversals. Use a native bundle to preserve history.',
+            },
+        ],
+        mappings: [],
+        conflicts: 0,
+        changes: 0,
+    };
+    const locator = {
+        projectKey: input.project.projectKey,
+        path: input.relative,
+        importedFrom: origin.id,
+    };
+    const envelope = archive?.sourceFormat === 'compiled-brain/v1'
+        ? Object.fromEntries(Object.entries(archive.payload).filter(([key]) => !['nodes', 'edges'].includes(key)))
+        : null;
+    const metadata = claimSource({
+        format: 'calliope-kg-transfer/v1',
+        origin,
+        sourceFormat: archive?.sourceFormat === 'compiled-brain/v1' ? archive.sourceFormat : 'conflict-kg/v1',
+        manifest: archive?.manifest ?? null,
+        envelope,
+    }, locator, report.losses);
+    report.metadataSourceId = metadata.id;
+    const changes = [], retainedIds = new Set(), plannedSources = new Set();
+    const records = [];
+    const access = new BrainAccess(cwd, prior.state.sources, options);
+    const addSource = async (source) => {
+        const old = prior.state.sources[source.id];
+        if (old) {
+            await access.source(old.id);
+            retainedIds.add(old.id);
+            if (old.content !== source.content || old.originalHash !== source.originalHash)
+                throw new BrainError('conflict', 'Retained transfer source differs from its content identity.');
+        }
+        else if (!plannedSources.has(source.id)) {
+            plannedSources.add(source.id);
+            if (Object.keys(prior.state.sources).length + plannedSources.size > BRAIN_LIMITS.sources)
+                throw new BrainError('limit', 'Import would exceed native source retention; preserve history before continuing.');
+            changes.push({ kind: 'source', value: source });
+        }
+    };
+    await addSource(metadata);
+    for (const [kind, externalId, record] of [
+        ...graph.nodes.map((node) => ['entity', node.id, node]),
+        ...graph.edges.map((edge, index) => ['edge', edgeIds[index], edge]),
+    ]) {
+        text(externalId, 512);
+        const source = claimSource({
+            format: 'calliope-kg-claim/v1',
+            originId: origin.id,
+            kind,
+            externalId,
+            record,
+        }, locator, report.losses);
+        const value = projectClaim(kind, externalId, record, origin.id, [source.id, metadata.id], report.losses);
+        const id = graphNamespace(origin.id, kind, externalId);
+        const old = kind === 'entity' ? prior.state.entities[id] : prior.state.edges[id];
+        const expected = prior.state.revisions[kind + ':' + id] ?? null;
+        if (old) {
+            await access.record(old);
+            records.push(old);
+        }
+        const equal = old && canonicalExchangeJson(recordInput(old)) === canonicalExchangeJson(value);
+        const status = equal ? 'unchanged' : old ? 'conflict' : expected ? 'deleted' : 'new';
+        report.mappings.push({ kind, externalId, localId: id, status });
+        if (status === 'conflict' || status === 'deleted')
+            report.conflicts++;
+        await addSource(source);
+        if (!equal)
+            changes.push({ kind, id, expected, value });
+    }
+    report.changes = changes.length;
+    if (hasBrainSecrets(report))
+        throw new BrainError('policy-denied', 'Transfer report identifiers contain secret material.');
+    for (const kind of ['entity', 'edge']) {
+        const table = kind === 'entity' ? 'entities' : 'edges';
+        const added = report.mappings.filter((mapping) => mapping.kind === kind && ['new', 'deleted'].includes(mapping.status)).length;
+        if (Object.keys(prior.state[table]).length + added > BRAIN_LIMITS[table])
+            throw new BrainError('limit', 'Import would exceed native graph retention; preserve history before continuing.');
+    }
+    if (options.preview)
+        return {
+            ...prior,
+            index: 'unchanged',
+            preview: true,
+            imported: 0,
+            unchanged: !changes.length,
+            report,
+        };
+    if (options.reconcileRevision !== undefined && options.reconcileRevision !== prior.state.revision)
+        throw new BrainTransferError('conflict', 'The reviewed destination revision is stale; preview the transfer again.', report);
+    if (report.conflicts && !options.reconcileRevision)
+        throw new BrainTransferError('conflict', 'Existing source claims, local corrections or deletions differ; preview and explicitly reconcile the destination revision.', report);
+    if (!changes.length)
+        return {
+            ...prior,
+            index: 'unchanged',
+            preview: false,
+            imported: 0,
+            unchanged: true,
+            report,
+        };
+    if (report.losses.length && !options.allowLoss)
+        throw new BrainTransferError('invalid', 'Review the transfer report and pass --allow-loss to acknowledge the projection limits.', report);
+    const result = await commitBrain(cwd, changes, 'import', 'Imported foreign source claims as inferred proposals; metadata grants no authority.', prior, options, async () => {
+        // Approval may have waited while source policy, secrets or the input changed.
+        const currentAccess = new BrainAccess(cwd, prior.state.sources, options);
+        for (const id of retainedIds)
+            await currentAccess.source(id);
+        for (const record of records)
+            await currentAccess.record(record);
+        await readBrainFile(cwd, path, options, BRAIN_LIMITS.journalBytes);
+        if (hasBrainSecrets(changes))
+            throw new BrainError('policy-denied', 'Transfer claims now match secret material; preview again.');
+        input.assertUnchanged();
+    });
+    return {
+        ...result,
+        preview: false,
+        imported: changes.length,
+        unchanged: false,
+        report,
+    };
+}
+//# sourceMappingURL=kg-transfer.js.map

package/dist/brain/kg-transfer.js.map

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

package/dist/brain/kg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kg.d.ts","sourceRoot":"","sources":["../../src/brain/kg.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,WAAW,cAAc;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAC1G,MAAM,WAAW,cAAc;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAChH,MAAM,WAAW,sBAAsB;IAAG,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE;AAEzI,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,GAAE,sBAAsB,CAAC,QAAQ,CAAoB,GAAG,sBAAsB,CAc/I;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAQ1E;AAED,eAAO,MAAM,oBAAoB,UAAW,sBAAsB,WAAiC,CAAC"}
+{"version":3,"file":"kg.d.ts","sourceRoot":"","sources":["../../src/brain/kg.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AACD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AACD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;IAC5C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,MAAM,GAAE,sBAAsB,CAAC,QAAQ,CAAoB,GAC1D,sBAAsB,CAgDxB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAoD1E;AAED,eAAO,MAAM,oBAAoB,UAAW,sBAAsB,WAM/D,CAAC"}