@polpo-ai/core 0.15.47 → 0.15.49

package/dist/brain/reading.js

@@ -0,0 +1,96 @@
+import { normalizeBrainAccessDecision } from "./contracts.js";
+import { normalizeBrainScope } from "./scope.js";
+import { BrainIngestionError, BrainStoreValidationError, } from "./store-errors.js";
+function boundedInteger(value, fallback, name, min, max) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isSafeInteger(value) || value < min || value > max) {
+        throw new BrainStoreValidationError(`${name} must be an integer between ${min} and ${max}`);
+    }
+    return value;
+}
+async function authorizeRead(source, actor, policy) {
+    try {
+        const decision = normalizeBrainAccessDecision(await policy.authorize({
+            action: "read",
+            source,
+            actor,
+        }));
+        if (decision.allowed)
+            return;
+    }
+    catch {
+        // Policy failures deny access. The caller never receives policy internals.
+    }
+    throw new BrainIngestionError("Brain source read is not authorized", "access_denied");
+}
+function chunkTokens(chunk) {
+    return chunk.tokenCount
+        ?? Math.max(1, Math.ceil(chunk.content.length / 4));
+}
+export async function readBrainSource(input, deps) {
+    const scope = normalizeBrainScope(input.ref.scope);
+    const sourceId = typeof input.ref.sourceId === "string"
+        ? input.ref.sourceId.trim()
+        : "";
+    if (!sourceId) {
+        throw new BrainStoreValidationError("sourceId is required");
+    }
+    const offset = boundedInteger(input.offset, 0, "offset", 0, 1_000_000);
+    const limit = boundedInteger(input.limit, 20, "limit", 1, 1_000);
+    const tokenBudget = boundedInteger(input.tokenBudget, 8_000, "tokenBudget", 0, 1_000_000);
+    const ref = { scope, sourceId };
+    const initialSource = await deps.sourceStore.getSource(ref);
+    if (!initialSource || initialSource.status === "deleted") {
+        throw new BrainIngestionError("Brain source was not found", "source_not_found");
+    }
+    await authorizeRead(initialSource, input.actor, deps.accessPolicy);
+    const versionName = input.version?.trim() || initialSource.currentVersion;
+    if (!versionName) {
+        throw new BrainIngestionError("Brain source has no readable version", "version_not_found");
+    }
+    const versionRef = { ...ref, version: versionName };
+    const initialVersion = await deps.versionStore.getVersion(versionRef);
+    if (!initialVersion
+        || initialVersion.status === "deleted"
+        || initialVersion.status === "failed"
+        || initialVersion.status === "pending"
+        || initialVersion.status === "indexing") {
+        throw new BrainIngestionError("Brain source version was not found", "version_not_found");
+    }
+    const allChunks = [...await deps.chunkStore.listVersionChunks(versionRef)]
+        .sort((left, right) => left.index - right.index);
+    const selected = [];
+    let consumed = 0;
+    let cursor = offset;
+    while (cursor < allChunks.length && selected.length < limit) {
+        const chunk = allChunks[cursor];
+        const tokens = chunkTokens(chunk);
+        if (tokens <= tokenBudget - consumed) {
+            selected.push(chunk);
+            consumed += tokens;
+        }
+        cursor += 1;
+    }
+    // Re-read after policy evaluation and chunk loading. Deletion, replacement,
+    // or a concurrent version mutation must not leak a stale result.
+    const finalSource = await deps.sourceStore.getSource(ref);
+    const finalVersion = await deps.versionStore.getVersion(versionRef);
+    if (!finalSource
+        || finalSource.status === "deleted"
+        || !finalVersion
+        || finalVersion.status !== initialVersion.status
+        || finalVersion.updatedAt !== initialVersion.updatedAt
+        || (input.version === undefined
+            && finalSource.currentVersion !== versionName)) {
+        throw new BrainIngestionError("Brain source changed while it was being read", "source_not_found");
+    }
+    await authorizeRead(finalSource, input.actor, deps.accessPolicy);
+    return Object.freeze({
+        source: finalSource,
+        version: finalVersion,
+        chunks: Object.freeze(selected),
+        ...(cursor < allChunks.length ? { nextOffset: cursor } : {}),
+    });
+}
+//# sourceMappingURL=reading.js.map

package/dist/brain/reading.js.map

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

package/dist/brain/retrieval.d.ts

@@ -0,0 +1,19 @@
+import type { BrainAccessPolicy, BrainReranker } from "./ports.js";
+import type { BrainChunkStore, BrainSourceStore } from "./stores.js";
+import type { BrainActorContext, BrainRetrievalResult, BrainScope } from "./types.js";
+export interface RetrieveBrainInput {
+    readonly query: string;
+    readonly scopes: readonly BrainScope[];
+    readonly actor: BrainActorContext;
+    readonly limit?: number;
+    readonly tokenBudget?: number;
+}
+export interface RetrieveBrainDeps {
+    readonly sourceStore: BrainSourceStore;
+    readonly chunkStore: BrainChunkStore;
+    readonly accessPolicy: BrainAccessPolicy;
+    readonly reranker?: BrainReranker;
+    readonly failureMode?: "fallback" | "strict";
+}
+export declare function retrieveBrain(input: RetrieveBrainInput, deps: RetrieveBrainDeps): Promise<readonly BrainRetrievalResult[]>;
+//# sourceMappingURL=retrieval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/brain/retrieval.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EAEX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CAC9C;AA2FD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CA4E1C"}

package/dist/brain/retrieval.js

@@ -0,0 +1,134 @@
+import { normalizeBrainAccessDecision } from "./contracts.js";
+import { isBrainSourceRetrievable } from "./lifecycle.js";
+import { normalizeBrainScope } from "./scope.js";
+import { BrainStoreValidationError } from "./store-errors.js";
+function boundedInteger(value, fallback, name, min, max) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isSafeInteger(value) || value < min || value > max) {
+        throw new BrainStoreValidationError(`${name} must be an integer between ${min} and ${max}`);
+    }
+    return value;
+}
+async function isAuthorized(source, actor, policy) {
+    try {
+        return normalizeBrainAccessDecision(await policy.authorize({
+            action: "search",
+            source,
+            actor,
+        })).allowed;
+    }
+    catch {
+        return false;
+    }
+}
+function resultIdentity(result) {
+    return JSON.stringify([
+        result.scope.kind,
+        result.scope.subjectId,
+        result.chunk.id,
+        result.chunk.sourceId,
+        result.chunk.version,
+        result.chunk.citation.sourceId,
+        result.chunk.citation.version,
+        result.chunk.citation.chunkId,
+    ]);
+}
+function validateReranked(original, candidate) {
+    if (!Array.isArray(candidate)) {
+        throw new BrainStoreValidationError("Brain reranker returned an invalid result");
+    }
+    const allowed = new Set(original.map(resultIdentity));
+    const seen = new Set();
+    for (const result of candidate) {
+        const identity = resultIdentity(result);
+        if (!allowed.has(identity)
+            || seen.has(identity)
+            || !Number.isFinite(result.score)) {
+            throw new BrainStoreValidationError("Brain reranker changed result or citation identity");
+        }
+        seen.add(identity);
+    }
+    return candidate;
+}
+async function listAllSources(sourceStore, scopes) {
+    const sources = [];
+    let cursor;
+    do {
+        const page = await sourceStore.listSources({
+            scopes,
+            statuses: ["indexed", "indexing", "failed"],
+            limit: 1_000,
+            ...(cursor ? { cursor } : {}),
+        });
+        sources.push(...page.sources);
+        cursor = page.cursor;
+    } while (cursor);
+    return sources;
+}
+export async function retrieveBrain(input, deps) {
+    if (!Array.isArray(input.scopes) || input.scopes.length === 0) {
+        throw new BrainStoreValidationError("At least one explicit Brain scope is required");
+    }
+    const scopes = [...new Map(input.scopes.map((scope) => {
+            const normalized = normalizeBrainScope(scope);
+            return [`${normalized.kind}:${normalized.subjectId}`, normalized];
+        })).values()];
+    const query = typeof input.query === "string" ? input.query.trim() : "";
+    const limit = boundedInteger(input.limit, 10, "limit", 1, 1_000);
+    const tokenBudget = boundedInteger(input.tokenBudget, 4_000, "tokenBudget", 0, 1_000_000);
+    if (!query || tokenBudget === 0)
+        return Object.freeze([]);
+    const authorized = [];
+    for (const source of await listAllSources(deps.sourceStore, scopes)) {
+        if (source.currentVersion
+            && await isAuthorized(source, input.actor, deps.accessPolicy)) {
+            authorized.push(source);
+        }
+    }
+    if (authorized.length === 0)
+        return Object.freeze([]);
+    const candidates = await deps.chunkStore.searchCandidates({
+        sources: authorized.map((source) => ({
+            scope: source.scope,
+            sourceId: source.id,
+        })),
+        query,
+        limit: Math.min(1_000, Math.max(limit * 4, limit)),
+    });
+    let ranked = candidates;
+    if (deps.reranker && candidates.length > 0) {
+        try {
+            ranked = validateReranked(candidates, await deps.reranker.rerank({ query, results: candidates, limit }));
+        }
+        catch (error) {
+            if ((deps.failureMode ?? "fallback") === "strict")
+                throw error;
+            ranked = candidates;
+        }
+    }
+    const final = [];
+    let usedTokens = 0;
+    for (const result of ranked) {
+        if (final.length >= limit)
+            break;
+        const source = await deps.sourceStore.getSource({
+            scope: result.scope,
+            sourceId: result.chunk.sourceId,
+        });
+        const visible = Boolean(source
+            && isBrainSourceRetrievable(source)
+            && source.currentVersion === result.chunk.version
+            && await isAuthorized(source, input.actor, deps.accessPolicy));
+        if (!visible)
+            continue;
+        const tokens = result.chunk.tokenCount
+            ?? Math.max(1, Math.ceil(result.chunk.content.length / 4));
+        if (tokens > tokenBudget - usedTokens)
+            continue;
+        final.push(result);
+        usedTokens += tokens;
+    }
+    return Object.freeze(final);
+}
+//# sourceMappingURL=retrieval.js.map

package/dist/brain/retrieval.js.map

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

package/dist/brain/scope.d.ts

@@ -0,0 +1,5 @@
+import { type BrainScope, type BrainScopeAccess } from "./types.js";
+export declare function normalizeBrainScope(value: unknown): BrainScope;
+export declare function brainScopeKey(scope: BrainScope): string;
+export declare function canAccessBrainScope(scope: BrainScope, access: BrainScopeAccess): boolean;
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/brain/scope.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAyB9D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGvD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAKT"}

package/dist/brain/scope.js

@@ -0,0 +1,26 @@
+import { BrainContractError } from "./errors.js";
+import { BRAIN_SCOPE_KINDS, } from "./types.js";
+import { requiredText } from "./validation.js";
+const scopeKinds = new Set(BRAIN_SCOPE_KINDS);
+export function normalizeBrainScope(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new BrainContractError("Brain scope must be an object", "invalid_scope", "scope");
+    }
+    const candidate = value;
+    if (typeof candidate.kind !== "string" || !scopeKinds.has(candidate.kind)) {
+        throw new BrainContractError(`Unknown Brain scope kind: ${String(candidate.kind)}`, "invalid_scope", "scope.kind");
+    }
+    return Object.freeze({
+        kind: candidate.kind,
+        subjectId: requiredText(candidate.subjectId, "scope.subjectId", 512, "invalid_scope"),
+    });
+}
+export function brainScopeKey(scope) {
+    const normalized = normalizeBrainScope(scope);
+    return JSON.stringify([normalized.kind, normalized.subjectId]);
+}
+export function canAccessBrainScope(scope, access) {
+    const normalized = normalizeBrainScope(scope);
+    return normalized.subjectId === (normalized.kind === "org" ? access.orgId : access.projectId);
+}
+//# sourceMappingURL=scope.js.map

package/dist/brain/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/brain/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,iBAAiB,GAIlB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,iBAAiB,CAAC,CAAC;AAEtD,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,kBAAkB,CAC1B,+BAA+B,EAC/B,eAAe,EACf,OAAO,CACR,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,kBAAkB,CAC1B,6BAA6B,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EACrD,eAAe,EACf,YAAY,CACb,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,CAAC,IAAsB;QACtC,SAAS,EAAE,YAAY,CACrB,SAAS,CAAC,SAAS,EACnB,iBAAiB,EACjB,GAAG,EACH,eAAe,CAChB;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAiB,EACjB,MAAwB;IAExB,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,UAAU,CAAC,SAAS,KAAK,CAC9B,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAC5D,CAAC;AACJ,CAAC"}

package/dist/brain/service.d.ts

@@ -0,0 +1,68 @@
+import type { BrainActorContext, BrainRetrievalResult, BrainScope, BrainSource, BrainSourceListQuery, BrainSourceListResult, BrainSourceRef, BrainSourceVersion, BrainTrustLevel } from "./types.js";
+import type { ReadBrainSourceResult } from "./reading.js";
+export type BrainSourceContentInput = {
+    readonly kind: "paste";
+    readonly text: string;
+    readonly contentType?: string;
+} | {
+    readonly kind: "file";
+    readonly path: string;
+} | {
+    readonly kind: "url";
+    readonly url: string;
+} | {
+    readonly kind: "connection";
+    readonly connectionId: string;
+    readonly locator?: string;
+};
+export interface BrainServiceContext {
+    readonly actor: BrainActorContext;
+    readonly readScopes: readonly BrainScope[];
+    readonly writeScopes: readonly BrainScope[];
+    readonly defaultWriteScope?: BrainScope;
+}
+export interface BrainCreateSourceRequest {
+    readonly scope: BrainScope;
+    readonly id?: string;
+    readonly label: string;
+    readonly trust: BrainTrustLevel;
+    readonly metadata?: Record<string, unknown>;
+    readonly content: BrainSourceContentInput;
+}
+export interface BrainUpdateSourceRequest {
+    readonly label?: string;
+    readonly trust?: BrainTrustLevel;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface BrainReindexSourceRequest {
+    readonly content: BrainSourceContentInput;
+}
+export interface BrainSearchRequest {
+    readonly query: string;
+    readonly scopes?: readonly BrainScope[];
+    readonly limit?: number;
+    readonly tokenBudget?: number;
+}
+export interface BrainReadSourceRequest {
+    readonly ref: BrainSourceRef;
+    readonly version?: string;
+    readonly offset?: number;
+    readonly limit?: number;
+    readonly tokenBudget?: number;
+}
+export interface BrainReadService {
+    search(context: BrainServiceContext, request: BrainSearchRequest): Promise<readonly BrainRetrievalResult[]>;
+    readSource(context: BrainServiceContext, request: BrainReadSourceRequest): Promise<ReadBrainSourceResult>;
+}
+export interface BrainManagementService extends BrainReadService {
+    listSources(context: BrainServiceContext, query?: Omit<BrainSourceListQuery, "scopes"> & {
+        readonly scopes?: readonly BrainScope[];
+    }): Promise<BrainSourceListResult>;
+    createSource(context: BrainServiceContext, request: BrainCreateSourceRequest): Promise<BrainSource>;
+    getSource(context: BrainServiceContext, ref: BrainSourceRef): Promise<BrainSource | null>;
+    updateSource(context: BrainServiceContext, ref: BrainSourceRef, request: BrainUpdateSourceRequest): Promise<BrainSource>;
+    deleteSource(context: BrainServiceContext, ref: BrainSourceRef): Promise<void>;
+    reindexSource(context: BrainServiceContext, ref: BrainSourceRef, request: BrainReindexSourceRequest): Promise<BrainSource>;
+    listVersions(context: BrainServiceContext, ref: BrainSourceRef): Promise<readonly BrainSourceVersion[]>;
+}
+//# sourceMappingURL=service.d.ts.map

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

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

package/dist/brain/service.js

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

package/dist/brain/service.js.map

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

package/dist/brain/store-errors.d.ts

@@ -0,0 +1,17 @@
+export declare class BrainStoreError extends Error {
+    constructor(message: string);
+}
+export declare class BrainStoreValidationError extends BrainStoreError {
+    constructor(message: string);
+}
+export declare class BrainStoreConflictError extends BrainStoreError {
+    constructor(message: string);
+}
+export declare class BrainStoreAuthorizationError extends BrainStoreError {
+    constructor(message?: string);
+}
+export declare class BrainIngestionError extends BrainStoreError {
+    readonly code: "access_denied" | "source_not_found" | "version_not_found" | "parser_not_found" | "empty_content" | "ingestion_failed";
+    constructor(message: string, code?: BrainIngestionError["code"], options?: ErrorOptions);
+}
+//# sourceMappingURL=store-errors.d.ts.map

package/dist/brain/store-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-errors.d.ts","sourceRoot":"","sources":["../../src/brain/store-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,yBAA0B,SAAQ,eAAe;gBAChD,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,4BAA6B,SAAQ,eAAe;gBACnD,OAAO,SAAwB;CAI5C;AAED,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,QAAQ,CAAC,IAAI,EACT,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,kBAAkB,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,mBAAmB,CAAC,MAAM,CAAsB,EACtD,OAAO,CAAC,EAAE,YAAY;CAYzB"}

package/dist/brain/store-errors.js

@@ -0,0 +1,39 @@
+export class BrainStoreError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BrainStoreError";
+    }
+}
+export class BrainStoreValidationError extends BrainStoreError {
+    constructor(message) {
+        super(message);
+        this.name = "BrainStoreValidationError";
+    }
+}
+export class BrainStoreConflictError extends BrainStoreError {
+    constructor(message) {
+        super(message);
+        this.name = "BrainStoreConflictError";
+    }
+}
+export class BrainStoreAuthorizationError extends BrainStoreError {
+    constructor(message = "Brain access denied") {
+        super(message);
+        this.name = "BrainStoreAuthorizationError";
+    }
+}
+export class BrainIngestionError extends BrainStoreError {
+    code;
+    constructor(message, code = "ingestion_failed", options) {
+        super(message);
+        this.name = "BrainIngestionError";
+        this.code = code;
+        if (options?.cause !== undefined) {
+            Object.defineProperty(this, "cause", {
+                value: options.cause,
+                configurable: true,
+            });
+        }
+    }
+}
+//# sourceMappingURL=store-errors.js.map

package/dist/brain/store-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-errors.js","sourceRoot":"","sources":["../../src/brain/store-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IAC5D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,eAAe;IAC/D,YAAY,OAAO,GAAG,qBAAqB;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IAC7C,IAAI,CAMU;IAEvB,YACE,OAAe,EACf,OAAoC,kBAAkB,EACtD,OAAsB;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE;gBACnC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/brain/stores.d.ts

@@ -0,0 +1,44 @@
+import type { BrainCandidateSearchQuery, BrainChunk, BrainEnqueueResult, BrainIngestionJob, BrainJobClaimInput, BrainJobFailureInput, BrainJobMutationInput, BrainPublishVersionInput, BrainReplaceVersionChunksInput, BrainRetrievalResult, BrainSource, BrainSourceListQuery, BrainSourceListResult, BrainSourceRef, BrainSourceVersion, BrainScope, BrainVersionRef } from "./types.js";
+export interface BrainSourceStore {
+    createSource(source: BrainSource): Promise<BrainSource>;
+    getSource(ref: BrainSourceRef): Promise<BrainSource | null>;
+    listSources(query: BrainSourceListQuery): Promise<BrainSourceListResult>;
+    updateSource(source: BrainSource, options?: {
+        readonly expectedUpdatedAt?: string;
+    }): Promise<BrainSource>;
+    publishVersion(input: BrainPublishVersionInput): Promise<BrainSource>;
+    deleteSource(ref: BrainSourceRef): Promise<void>;
+}
+export interface BrainVersionStore {
+    createVersion(scope: BrainSourceRef["scope"], version: BrainSourceVersion): Promise<BrainSourceVersion>;
+    getVersion(ref: BrainVersionRef): Promise<BrainSourceVersion | null>;
+    listVersions(ref: BrainSourceRef): Promise<readonly BrainSourceVersion[]>;
+    updateVersion(scope: BrainSourceRef["scope"], version: BrainSourceVersion, options?: {
+        readonly expectedUpdatedAt?: string;
+    }): Promise<BrainSourceVersion>;
+    deleteVersion(ref: BrainVersionRef): Promise<void>;
+}
+export interface BrainChunkStore {
+    /**
+     * Atomically replaces all chunks for one unpublished source version.
+     * Implementations must expose either the complete new set or the prior set.
+     */
+    replaceVersionChunks(input: BrainReplaceVersionChunksInput): Promise<void>;
+    listVersionChunks(ref: BrainVersionRef): Promise<readonly BrainChunk[]>;
+    searchCandidates(query: BrainCandidateSearchQuery): Promise<readonly BrainRetrievalResult[]>;
+    deleteVersionChunks(ref: BrainVersionRef): Promise<void>;
+    deleteSourceChunks(ref: BrainSourceRef): Promise<void>;
+}
+export interface BrainIngestionJobStore {
+    /** Enqueues by dedupeKey and reports whether a new job was created. */
+    enqueueJob(job: BrainIngestionJob): Promise<BrainEnqueueResult>;
+    getJob(ref: {
+        readonly scope: BrainScope;
+        readonly jobId: string;
+    }): Promise<BrainIngestionJob | null>;
+    claimNextJob(input: BrainJobClaimInput): Promise<BrainIngestionJob | null>;
+    completeJob(input: BrainJobMutationInput): Promise<BrainIngestionJob>;
+    failJob(input: BrainJobFailureInput): Promise<BrainIngestionJob>;
+    cancelJob(input: BrainJobMutationInput): Promise<BrainIngestionJob>;
+}
+//# sourceMappingURL=stores.d.ts.map

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

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

package/dist/brain/stores.js

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

package/dist/brain/stores.js.map

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