@polpo-ai/core 0.15.131 → 0.15.133

package/dist/semantic-retrieval.d.ts

@@ -0,0 +1,128 @@
+export declare const TEXT_EMBEDDING_TASKS: readonly ["document", "query"];
+export type TextEmbeddingTask = (typeof TEXT_EMBEDDING_TASKS)[number];
+export interface TextEmbeddingIdentity {
+    readonly provider: string;
+    readonly model: string;
+    readonly dimensions: number;
+    readonly revision: string;
+}
+export interface TextEmbeddingRequest {
+    readonly texts: readonly string[];
+    readonly task: TextEmbeddingTask;
+    readonly signal?: AbortSignal;
+}
+export interface TextEmbeddingResult {
+    readonly vectors: readonly (readonly number[])[];
+    readonly identity: TextEmbeddingIdentity;
+    readonly usage?: unknown;
+}
+export interface TextEmbeddingProvider {
+    identity(): TextEmbeddingIdentity | Promise<TextEmbeddingIdentity>;
+    embed(request: TextEmbeddingRequest): Promise<TextEmbeddingResult>;
+}
+export interface DerivedTextEmbedding {
+    readonly corpus: string;
+    readonly recordId: string;
+    readonly contentHash: string;
+    readonly identity: TextEmbeddingIdentity;
+    readonly vector: readonly number[];
+    readonly createdAt: string;
+}
+export interface SemanticCandidateQuery {
+    readonly corpus: string;
+    readonly vector: readonly number[];
+    readonly identity: TextEmbeddingIdentity;
+    readonly authorizedRecordIds: readonly string[];
+    readonly limit: number;
+    readonly signal?: AbortSignal;
+}
+export interface SemanticCandidate {
+    readonly id: string;
+    readonly score: number;
+}
+export interface DerivedTextEmbeddingIndex {
+    upsert(records: readonly DerivedTextEmbedding[], options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<void>;
+    delete(input: {
+        readonly corpus: string;
+        readonly recordIds: readonly string[];
+        readonly signal?: AbortSignal;
+    }): Promise<void>;
+    search(query: SemanticCandidateQuery): Promise<readonly SemanticCandidate[]>;
+    health(input: {
+        readonly corpus: string;
+        readonly identity: TextEmbeddingIdentity;
+        readonly signal?: AbortSignal;
+    }): Promise<"ready" | "degraded" | "unavailable">;
+    listMissing(input: {
+        readonly corpus: string;
+        readonly identity: TextEmbeddingIdentity;
+        readonly canonical: readonly {
+            readonly recordId: string;
+            readonly contentHash: string;
+        }[];
+        readonly signal?: AbortSignal;
+    }): Promise<readonly string[]>;
+}
+export type HybridRetrievalMode = "lexical" | "semantic" | "hybrid";
+export interface RankedCandidate {
+    readonly id: string;
+    readonly score: number;
+}
+export interface HybridRankingResult {
+    readonly id: string;
+    readonly score: number;
+    readonly mode: HybridRetrievalMode;
+    readonly ranks: {
+        readonly lexical?: number;
+        readonly semantic?: number;
+    };
+    readonly scores: {
+        readonly lexical?: number;
+        readonly semantic?: number;
+    };
+}
+export interface HybridRetrievalPolicy {
+    readonly candidateLimit?: number;
+    readonly resultLimit?: number;
+    readonly rrfConstant?: number;
+    readonly rerankLimit?: number;
+    readonly timeoutMs?: number;
+    readonly failureMode?: "fallback" | "strict";
+}
+export interface NormalizedHybridRetrievalPolicy {
+    readonly candidateLimit: number;
+    readonly resultLimit: number;
+    readonly rrfConstant: number;
+    readonly rerankLimit: number;
+    readonly timeoutMs: number;
+    readonly failureMode: "fallback" | "strict";
+}
+export interface SemanticRetrievalEvalCase {
+    readonly id: string;
+    readonly query: string;
+    readonly relevantIds: readonly string[];
+}
+export interface SemanticRetrievalEvalReport {
+    readonly cases: number;
+    readonly hits: number;
+    readonly recallAtK: number;
+    readonly missedCaseIds: readonly string[];
+}
+export declare function normalizeHybridRetrievalPolicy(value?: HybridRetrievalPolicy): NormalizedHybridRetrievalPolicy;
+export declare function runSemanticRetrievalEval(cases: readonly SemanticRetrievalEvalCase[], retrieve: (value: SemanticRetrievalEvalCase) => Promise<readonly string[]>): Promise<SemanticRetrievalEvalReport>;
+export declare function normalizeTextEmbeddingIdentity(value: TextEmbeddingIdentity): TextEmbeddingIdentity;
+export declare function textEmbeddingIdentitiesEqual(left: TextEmbeddingIdentity, right: TextEmbeddingIdentity): boolean;
+export declare function assertTextEmbeddingResult(value: TextEmbeddingResult, options: {
+    readonly expectedCount: number;
+    readonly expectedIdentity?: TextEmbeddingIdentity;
+}): TextEmbeddingResult;
+export declare function cosineSimilarity(left: readonly number[], right: readonly number[]): number;
+export declare function fuseHybridRankings(input: {
+    readonly lexical: readonly RankedCandidate[];
+    readonly semantic: readonly RankedCandidate[];
+    readonly rrfConstant?: number;
+    readonly limit?: number;
+}): HybridRankingResult[];
+//# sourceMappingURL=semantic-retrieval.d.ts.map

package/dist/semantic-retrieval.d.ts.map

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

package/dist/semantic-retrieval.js

@@ -0,0 +1,201 @@
+export const TEXT_EMBEDDING_TASKS = ["document", "query"];
+const MAX_IDENTITY_TEXT = 512;
+const DEFAULT_RRF_CONSTANT = 60;
+function boundedInteger(value, fallback, path, min, max) {
+    const resolved = value ?? fallback;
+    if (!Number.isSafeInteger(resolved) || resolved < min || resolved > max) {
+        throw new TypeError(`${path} must be an integer between ${min} and ${max}`);
+    }
+    return resolved;
+}
+export function normalizeHybridRetrievalPolicy(value = {}) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError("hybrid retrieval policy must be an object");
+    }
+    const candidateLimit = boundedInteger(value.candidateLimit, 80, "candidateLimit", 1, 10_000);
+    const resultLimit = boundedInteger(value.resultLimit, 20, "resultLimit", 1, 1_000);
+    const rerankLimit = boundedInteger(value.rerankLimit, 0, "rerankLimit", 0, candidateLimit);
+    const failureMode = value.failureMode ?? "fallback";
+    if (failureMode !== "fallback" && failureMode !== "strict") {
+        throw new TypeError("failureMode must be fallback or strict");
+    }
+    return Object.freeze({
+        candidateLimit,
+        resultLimit,
+        rrfConstant: boundedInteger(value.rrfConstant, 60, "rrfConstant", 1, 10_000),
+        rerankLimit,
+        timeoutMs: boundedInteger(value.timeoutMs, 1_500, "timeoutMs", 1, 120_000),
+        failureMode,
+    });
+}
+export async function runSemanticRetrievalEval(cases, retrieve) {
+    if (!Array.isArray(cases) || typeof retrieve !== "function") {
+        throw new TypeError("semantic retrieval eval cases and retriever are required");
+    }
+    let hits = 0;
+    const missedCaseIds = [];
+    for (const [index, value] of cases.entries()) {
+        const id = requiredText(value?.id, `cases[${index}].id`);
+        requiredText(value?.query, `cases[${index}].query`);
+        if (!Array.isArray(value.relevantIds) || value.relevantIds.length === 0) {
+            throw new TypeError(`cases[${index}].relevantIds must not be empty`);
+        }
+        const relevant = new Set(value.relevantIds.map((candidate, candidateIndex) => requiredText(candidate, `cases[${index}].relevantIds[${candidateIndex}]`)));
+        const returned = await retrieve(value);
+        if (returned.some((candidate) => relevant.has(candidate)))
+            hits += 1;
+        else
+            missedCaseIds.push(id);
+    }
+    return Object.freeze({
+        cases: cases.length,
+        hits,
+        recallAtK: cases.length === 0 ? 1 : hits / cases.length,
+        missedCaseIds: Object.freeze(missedCaseIds),
+    });
+}
+function requiredText(value, path) {
+    if (typeof value !== "string")
+        throw new TypeError(`${path} must be a string`);
+    const normalized = value.trim();
+    if (!normalized || normalized.length > MAX_IDENTITY_TEXT) {
+        throw new TypeError(`${path} must contain between 1 and ${MAX_IDENTITY_TEXT} characters`);
+    }
+    return normalized;
+}
+export function normalizeTextEmbeddingIdentity(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError("embedding identity must be an object");
+    }
+    if (!Number.isSafeInteger(value.dimensions) || value.dimensions < 1) {
+        throw new TypeError("embedding identity dimensions must be a positive integer");
+    }
+    return Object.freeze({
+        provider: requiredText(value.provider, "embedding identity provider"),
+        model: requiredText(value.model, "embedding identity model"),
+        dimensions: value.dimensions,
+        revision: requiredText(value.revision, "embedding identity revision"),
+    });
+}
+export function textEmbeddingIdentitiesEqual(left, right) {
+    return left.provider === right.provider
+        && left.model === right.model
+        && left.dimensions === right.dimensions
+        && left.revision === right.revision;
+}
+export function assertTextEmbeddingResult(value, options) {
+    if (!Number.isSafeInteger(options.expectedCount) || options.expectedCount < 0) {
+        throw new TypeError("expected embedding count must be a non-negative integer");
+    }
+    if (!value || typeof value !== "object" || !Array.isArray(value.vectors)) {
+        throw new TypeError("embedding result vectors must be an array");
+    }
+    const identity = normalizeTextEmbeddingIdentity(value.identity);
+    if (options.expectedIdentity
+        && !textEmbeddingIdentitiesEqual(identity, normalizeTextEmbeddingIdentity(options.expectedIdentity))) {
+        throw new TypeError("embedding result identity is incompatible");
+    }
+    if (value.vectors.length !== options.expectedCount) {
+        throw new TypeError("embedding result vector count is invalid");
+    }
+    const vectors = value.vectors.map((vector, index) => {
+        if (!Array.isArray(vector) || vector.length !== identity.dimensions) {
+            throw new TypeError(`embedding vector ${index} dimensions are invalid`);
+        }
+        if (!vector.every(Number.isFinite)) {
+            throw new TypeError(`embedding vector ${index} must contain finite numbers`);
+        }
+        return Object.freeze([...vector]);
+    });
+    return Object.freeze({
+        vectors: Object.freeze(vectors),
+        identity,
+        ...(value.usage === undefined ? {} : { usage: value.usage }),
+    });
+}
+export function cosineSimilarity(left, right) {
+    if (left.length === 0 || left.length !== right.length)
+        return 0;
+    let dot = 0;
+    let leftMagnitude = 0;
+    let rightMagnitude = 0;
+    for (let index = 0; index < left.length; index += 1) {
+        const l = left[index];
+        const r = right[index];
+        if (!Number.isFinite(l) || !Number.isFinite(r))
+            return 0;
+        dot += l * r;
+        leftMagnitude += l * l;
+        rightMagnitude += r * r;
+    }
+    if (leftMagnitude === 0 || rightMagnitude === 0)
+        return 0;
+    const result = dot / Math.sqrt(leftMagnitude * rightMagnitude);
+    return Number.isFinite(result) ? Math.max(-1, Math.min(1, result)) : 0;
+}
+function normalizeRanking(value, name) {
+    if (!Array.isArray(value))
+        throw new TypeError(`${name} must be an array`);
+    const strongest = new Map();
+    for (const [index, candidate] of value.entries()) {
+        const id = requiredText(candidate?.id, `${name}[${index}].id`);
+        if (!Number.isFinite(candidate.score)) {
+            throw new TypeError(`${name}[${index}].score must be finite`);
+        }
+        const current = strongest.get(id);
+        if (current === undefined || candidate.score > current) {
+            strongest.set(id, candidate.score);
+        }
+    }
+    return [...strongest].map(([id, score]) => ({ id, score })).sort((left, right) => right.score - left.score || left.id.localeCompare(right.id));
+}
+export function fuseHybridRankings(input) {
+    const rrfConstant = input.rrfConstant ?? DEFAULT_RRF_CONSTANT;
+    if (!Number.isSafeInteger(rrfConstant) || rrfConstant < 1 || rrfConstant > 10_000) {
+        throw new TypeError("rrfConstant must be an integer between 1 and 10000");
+    }
+    const limit = input.limit ?? Number.MAX_SAFE_INTEGER;
+    if (!Number.isSafeInteger(limit) || limit < 0) {
+        throw new TypeError("limit must be a non-negative integer");
+    }
+    const lexical = normalizeRanking(input.lexical, "lexical");
+    const semantic = normalizeRanking(input.semantic, "semantic");
+    const values = new Map();
+    const add = (candidate, rank, kind) => {
+        const current = values.get(candidate.id) ?? { score: 0 };
+        current.score += 1 / (rrfConstant + rank);
+        if (kind === "lexical") {
+            current.lexicalRank = rank;
+            current.lexicalScore = candidate.score;
+        }
+        else {
+            current.semanticRank = rank;
+            current.semanticScore = candidate.score;
+        }
+        values.set(candidate.id, current);
+    };
+    lexical.forEach((candidate, index) => add(candidate, index + 1, "lexical"));
+    semantic.forEach((candidate, index) => add(candidate, index + 1, "semantic"));
+    return [...values].map(([id, value]) => {
+        const mode = value.lexicalRank !== undefined && value.semanticRank !== undefined
+            ? "hybrid"
+            : value.semanticRank !== undefined
+                ? "semantic"
+                : "lexical";
+        return Object.freeze({
+            id,
+            score: value.score,
+            mode,
+            ranks: Object.freeze({
+                ...(value.lexicalRank === undefined ? {} : { lexical: value.lexicalRank }),
+                ...(value.semanticRank === undefined ? {} : { semantic: value.semanticRank }),
+            }),
+            scores: Object.freeze({
+                ...(value.lexicalScore === undefined ? {} : { lexical: value.lexicalScore }),
+                ...(value.semanticScore === undefined ? {} : { semantic: value.semanticScore }),
+            }),
+        });
+    }).sort((left, right) => right.score - left.score || left.id.localeCompare(right.id))
+        .slice(0, limit);
+}
+//# sourceMappingURL=semantic-retrieval.js.map

package/dist/semantic-retrieval.js.map

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

package/dist/semantic-retrieval.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=semantic-retrieval.test.d.ts.map

package/dist/semantic-retrieval.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-retrieval.test.d.ts","sourceRoot":"","sources":["../src/semantic-retrieval.test.ts"],"names":[],"mappings":""}

package/dist/semantic-retrieval.test.js

@@ -0,0 +1,138 @@
+import { describe, expect, it } from "vitest";
+import { assertTextEmbeddingResult, cosineSimilarity, fuseHybridRankings, normalizeHybridRetrievalPolicy, normalizeTextEmbeddingIdentity, textEmbeddingIdentitiesEqual, runSemanticRetrievalEval, } from "./semantic-retrieval.js";
+const identity = {
+    provider: "test",
+    model: "embed-v1",
+    dimensions: 3,
+    revision: "2026-08-30",
+};
+describe("semantic retrieval contracts", () => {
+    it("normalizes immutable embedding identity and compares every compatibility field", () => {
+        const normalized = normalizeTextEmbeddingIdentity(identity);
+        expect(normalized).toEqual(identity);
+        expect(Object.isFrozen(normalized)).toBe(true);
+        expect(textEmbeddingIdentitiesEqual(normalized, identity)).toBe(true);
+        expect(textEmbeddingIdentitiesEqual(normalized, {
+            ...identity,
+            revision: "next",
+        })).toBe(false);
+        expect(textEmbeddingIdentitiesEqual(normalized, {
+            ...identity,
+            dimensions: 2,
+        })).toBe(false);
+    });
+    it.each([
+        [{ ...identity, dimensions: 0 }, "dimensions"],
+        [{ ...identity, provider: "" }, "provider"],
+        [{ ...identity, model: " " }, "model"],
+        [{ ...identity, revision: "" }, "revision"],
+    ])("rejects invalid embedding identity %#", (value, field) => {
+        expect(() => normalizeTextEmbeddingIdentity(value)).toThrow(field);
+    });
+    it("validates vector count, dimensions, finite values, and identity", () => {
+        const result = assertTextEmbeddingResult({
+            vectors: [[1, 0, 0], [0, 1, 0]],
+            identity,
+            usage: { tokens: 4 },
+        }, {
+            expectedCount: 2,
+            expectedIdentity: identity,
+        });
+        expect(result.vectors).toEqual([[1, 0, 0], [0, 1, 0]]);
+        expect(Object.isFrozen(result.vectors[0])).toBe(true);
+        expect(() => assertTextEmbeddingResult({
+            vectors: [[1, 0, 0]], identity,
+        }, { expectedCount: 2, expectedIdentity: identity })).toThrow("count");
+        expect(() => assertTextEmbeddingResult({
+            vectors: [[1, 0]], identity,
+        }, { expectedCount: 1, expectedIdentity: identity })).toThrow("dimensions");
+        expect(() => assertTextEmbeddingResult({
+            vectors: [[1, Number.NaN, 0]], identity,
+        }, { expectedCount: 1, expectedIdentity: identity })).toThrow("finite");
+        expect(() => assertTextEmbeddingResult({
+            vectors: [[1, 0, 0]], identity: { ...identity, revision: "other" },
+        }, { expectedCount: 1, expectedIdentity: identity })).toThrow("identity");
+    });
+    it("calculates bounded cosine similarity without accepting malformed vectors", () => {
+        expect(cosineSimilarity([1, 0], [1, 0])).toBe(1);
+        expect(cosineSimilarity([1, 0], [-1, 0])).toBe(-1);
+        expect(cosineSimilarity([0, 0], [1, 0])).toBe(0);
+        expect(cosineSimilarity([1], [1, 0])).toBe(0);
+        expect(cosineSimilarity([Number.POSITIVE_INFINITY], [1])).toBe(0);
+    });
+    it("fuses independent rankings with RRF instead of adding incomparable scores", () => {
+        const fused = fuseHybridRankings({
+            lexical: [
+                { id: "exact", score: 100 },
+                { id: "both", score: 1 },
+            ],
+            semantic: [
+                { id: "paraphrase", score: 0.99 },
+                { id: "both", score: 0.9 },
+            ],
+            rrfConstant: 60,
+        });
+        expect(fused.map((result) => result.id)).toEqual([
+            "both",
+            "exact",
+            "paraphrase",
+        ]);
+        expect(fused[0]).toMatchObject({
+            ranks: { lexical: 2, semantic: 2 },
+            scores: { lexical: 1, semantic: 0.9 },
+            mode: "hybrid",
+        });
+        expect(fused[1]?.score).not.toBe(100 + 0);
+    });
+    it("deduplicates candidates, uses strongest duplicate score, and orders ties by id", () => {
+        const fused = fuseHybridRankings({
+            lexical: [
+                { id: "z", score: 1 },
+                { id: "a", score: 1 },
+                { id: "a", score: 4 },
+            ],
+            semantic: [],
+        });
+        expect(fused.map((result) => result.id)).toEqual(["a", "z"]);
+        expect(fused[0]?.scores.lexical).toBe(4);
+        expect(fused.every((result) => result.mode === "lexical")).toBe(true);
+    });
+    it("rejects invalid ranker policy instead of producing unstable output", () => {
+        expect(() => fuseHybridRankings({
+            lexical: [],
+            semantic: [],
+            rrfConstant: 0,
+        })).toThrow("rrfConstant");
+        expect(() => fuseHybridRankings({
+            lexical: [{ id: "a", score: Number.NaN }],
+            semantic: [],
+        })).toThrow("score");
+    });
+    it("normalizes bounded hybrid policy and rejects impossible rerank limits", () => {
+        expect(normalizeHybridRetrievalPolicy()).toEqual({
+            candidateLimit: 80,
+            resultLimit: 20,
+            rrfConstant: 60,
+            rerankLimit: 0,
+            timeoutMs: 1_500,
+            failureMode: "fallback",
+        });
+        expect(() => normalizeHybridRetrievalPolicy({
+            candidateLimit: 2,
+            rerankLimit: 3,
+        })).toThrow("rerankLimit");
+    });
+    it("produces machine-readable eval metrics without source content", async () => {
+        const report = await runSemanticRetrievalEval([
+            { id: "paraphrase", query: "money back", relevantIds: ["refund"] },
+            { id: "missing", query: "shipping", relevantIds: ["delivery"] },
+        ], async ({ id }) => id === "paraphrase" ? ["refund"] : ["other"]);
+        expect(report).toEqual({
+            cases: 2,
+            hits: 1,
+            recallAtK: 0.5,
+            missedCaseIds: ["missing"],
+        });
+    });
+});
+//# sourceMappingURL=semantic-retrieval.test.js.map

package/dist/semantic-retrieval.test.js.map

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

package/dist/types/agent.d.ts

@@ -11,6 +11,7 @@ import type { BillingOwner, CostSource, CredentialType, ModelInvocationStatus, M
 import type { RuntimeGuardrailAuditEvent } from "../guardrails/types.js";
 import type { ChatInteractionSettings } from "../chat-interactions.js";
 import type { AllowedToolsSettings } from "../tool-policy.js";
+import type { AgentMemorySettings } from "../memory/tool-settings.js";
 /** Reasoning level for LLM calls (maps to the provider's thinking/reasoning level). */
 export type ReasoningLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
 /** Agent identity — who this agent is and how it behaves */
@@ -142,6 +143,8 @@ export interface AgentConfig {
     chat?: ChatInteractionSettings;
     /** Tool capability restriction for provider Channels such as WhatsApp or Telegram. */
     channels?: AllowedToolsSettings;
+    /** Portable typed Memory tool capability. Omitted exposes no new Memory tools. */
+    memory?: AgentMemorySettings;
     /** Installed skill names (e.g. "find-skills", "frontend-design") */
     skills?: string[];
     /** MCP servers available to this agent. */

package/dist/types/agent.d.ts.map

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

package/dist/types/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyTH,6BAA6B;AAE7B,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,SAAiB;IACxD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QACvD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,SAAiB;IAC5D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4TH,6BAA6B;AAE7B,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,SAAiB;IACxD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QACvD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,SAAiB;IAC5D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polpo-ai/core",
-  "version": "0.15.131",
+  "version": "0.15.133",
   "description": "Pure business logic, types, schemas, and store interfaces for the Polpo AI agent orchestration platform",
   "type": "module",
   "main": "dist/index.js",
@@ -70,6 +70,10 @@
       "types": "./dist/runtime-context/index.d.ts",
       "import": "./dist/runtime-context/index.js"
     },
+    "./semantic-retrieval": {
+      "types": "./dist/semantic-retrieval.d.ts",
+      "import": "./dist/semantic-retrieval.js"
+    },
     "./steering": {
       "types": "./dist/steering.d.ts",
       "import": "./dist/steering.js"