@polpo-ai/core 0.15.41 → 0.15.42

package/dist/memory/item.js.map

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

package/dist/memory/lifecycle.d.ts

@@ -0,0 +1,5 @@
+import type { MemoryItem, MemoryStatus } from "./types.js";
+export declare function assertMemoryStatusTransition(from: MemoryStatus, to: MemoryStatus): void;
+export declare function isMemoryItemExpired(item: Pick<MemoryItem, "expiresAt">, now?: Date | string): boolean;
+export declare function isMemoryItemRetrievable(item: Pick<MemoryItem, "status" | "expiresAt">, now?: Date | string): boolean;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/memory/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/memory/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS3D,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,YAAY,GACf,IAAI,CAQN;AAcD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EACnC,GAAG,GAAE,IAAI,GAAG,MAAmB,GAC9B,OAAO,CAWT;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,WAAW,CAAC,EAC9C,GAAG,GAAE,IAAI,GAAG,MAAmB,GAC9B,OAAO,CAET"}

package/dist/memory/lifecycle.js

@@ -0,0 +1,32 @@
+import { MemoryContractError } from "./errors.js";
+const allowedTransitions = {
+    pending: new Set(["pending", "active", "deleted"]),
+    active: new Set(["active", "superseded", "deleted"]),
+    superseded: new Set(["superseded", "deleted"]),
+    deleted: new Set(["deleted"]),
+};
+export function assertMemoryStatusTransition(from, to) {
+    if (!allowedTransitions[from]?.has(to)) {
+        throw new MemoryContractError(`Invalid Memory status transition: ${String(from)} -> ${String(to)}`, "invalid_transition", "status");
+    }
+}
+function timestamp(value) {
+    const time = value instanceof Date ? value.getTime() : Date.parse(value);
+    if (!Number.isFinite(time)) {
+        throw new MemoryContractError("Memory comparison time must be a valid date", "invalid_item", "now");
+    }
+    return time;
+}
+export function isMemoryItemExpired(item, now = new Date()) {
+    if (!item.expiresAt)
+        return false;
+    const expiresAt = Date.parse(item.expiresAt);
+    if (!Number.isFinite(expiresAt)) {
+        throw new MemoryContractError("Memory expiresAt must be a valid date", "invalid_item", "expiresAt");
+    }
+    return expiresAt <= timestamp(now);
+}
+export function isMemoryItemRetrievable(item, now = new Date()) {
+    return item.status === "active" && !isMemoryItemExpired(item, now);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/memory/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/memory/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,kBAAkB,GAA8D;IACpF,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACpD,UAAU,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC9C,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAC1C,IAAkB,EAClB,EAAgB;IAEhB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,mBAAmB,CAC3B,qCAAqC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,EACpE,oBAAoB,EACpB,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAoB;IACrC,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,mBAAmB,CAC3B,6CAA6C,EAC7C,cAAc,EACd,KAAK,CACN,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAmC,EACnC,MAAqB,IAAI,IAAI,EAAE;IAE/B,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,mBAAmB,CAC3B,uCAAuC,EACvC,cAAc,EACd,WAAW,CACZ,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAA8C,EAC9C,MAAqB,IAAI,IAAI,EAAE;IAE/B,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACrE,CAAC"}

package/dist/memory/policy.d.ts

@@ -0,0 +1,27 @@
+import type { MemoryItem, MemoryKind, MemoryScopeKind } from "./types.js";
+import type { MemoryStoreContext } from "./store-types.js";
+export interface MemorySensitiveContentFinding {
+    readonly code: string;
+    readonly start: number;
+    readonly length: number;
+}
+export type MemorySensitiveContentHook = (content: string) => readonly MemorySensitiveContentFinding[] | Promise<readonly MemorySensitiveContentFinding[]>;
+export interface MemoryWritePolicy {
+    readonly allowedScopeKinds?: readonly MemoryScopeKind[];
+    readonly allowedKinds?: readonly MemoryKind[];
+    readonly allowSensitiveContent?: boolean;
+    readonly allowPublicChannelBroadScopeWrites?: boolean;
+    readonly sensitiveContentHook?: MemorySensitiveContentHook;
+}
+export interface MemoryPolicyViolation {
+    readonly code: "unauthorized_scope" | "scope_kind_denied" | "memory_kind_denied" | "public_channel_broad_scope" | "sensitive_content";
+    readonly message: string;
+    readonly findingCodes?: readonly string[];
+}
+export interface MemoryWriteDecision {
+    readonly allowed: boolean;
+    readonly violations: readonly MemoryPolicyViolation[];
+}
+export declare function detectSensitiveMemoryContent(content: string): MemorySensitiveContentFinding[];
+export declare function evaluateMemoryWrite(item: MemoryItem, context: MemoryStoreContext, policy?: MemoryWritePolicy): Promise<MemoryWriteDecision>;
+//# sourceMappingURL=policy.d.ts.map

package/dist/memory/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/memory/policy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,0BAA0B,GAAG,CACvC,OAAO,EAAE,MAAM,KAEb,SAAS,6BAA6B,EAAE,GACxC,OAAO,CAAC,SAAS,6BAA6B,EAAE,CAAC,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,kCAAkC,CAAC,EAAE,OAAO,CAAC;IACtD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;CAC5D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EACT,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,4BAA4B,GAC5B,mBAAmB,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACvD;AAgDD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,6BAA6B,EAAE,CAejC;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,kBAAkB,EAC3B,MAAM,GAAE,iBAAsB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAqE9B"}

package/dist/memory/policy.js

@@ -0,0 +1,114 @@
+import { canAccessMemoryScope } from "./scope.js";
+import { MemoryPolicyError } from "./store-errors.js";
+const SENSITIVE_PATTERNS = [
+    {
+        code: "private_key",
+        expression: /-----BEGIN (?:[A-Z0-9 ]+ )?PRIVATE KEY-----/gu,
+    },
+    {
+        code: "bearer_token",
+        expression: /\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/giu,
+    },
+    {
+        code: "credential_assignment",
+        expression: /\b(?:api[_-]?key|access[_-]?token|password|secret|client[_-]?secret)\s*[:=]\s*["']?[^\s"',;]{12,}/giu,
+    },
+    {
+        code: "known_token_prefix",
+        expression: /\b(?:sk[-_]|ghp_|github_pat_|xox[baprs]-|AKIA)[A-Za-z0-9_=-]{16,}\b/gu,
+    },
+];
+const BROAD_SCOPE_KINDS = new Set([
+    "org",
+    "project",
+    "agent",
+]);
+function normalizeFinding(finding) {
+    const code = typeof finding.code === "string"
+        && /^[a-z0-9][a-z0-9_-]{0,63}$/u.test(finding.code)
+        ? finding.code
+        : "custom_sensitive_content";
+    const start = Number.isInteger(finding.start) && finding.start >= 0
+        ? finding.start
+        : 0;
+    const length = Number.isInteger(finding.length) && finding.length >= 0
+        ? finding.length
+        : 0;
+    return Object.freeze({ code, start, length });
+}
+export function detectSensitiveMemoryContent(content) {
+    const findings = [];
+    for (const pattern of SENSITIVE_PATTERNS) {
+        for (const match of content.matchAll(pattern.expression)) {
+            findings.push(Object.freeze({
+                code: pattern.code,
+                start: match.index,
+                length: match[0].length,
+            }));
+        }
+    }
+    return findings.sort((left, right) => (left.start - right.start
+        || left.code.localeCompare(right.code)));
+}
+export async function evaluateMemoryWrite(item, context, policy = {}) {
+    const violations = [];
+    if (!canAccessMemoryScope(item.scope, context.access)) {
+        violations.push({
+            code: "unauthorized_scope",
+            message: "The caller cannot write this Memory scope.",
+        });
+    }
+    if (policy.allowedScopeKinds
+        && !policy.allowedScopeKinds.includes(item.scope.kind)) {
+        violations.push({
+            code: "scope_kind_denied",
+            message: `Memory scope kind "${item.scope.kind}" is denied by policy.`,
+        });
+    }
+    if (policy.allowedKinds && !policy.allowedKinds.includes(item.kind)) {
+        violations.push({
+            code: "memory_kind_denied",
+            message: `Memory kind "${item.kind}" is denied by policy.`,
+        });
+    }
+    if (context.surface === "channel"
+        && context.channelVisibility === "public"
+        && BROAD_SCOPE_KINDS.has(item.scope.kind)
+        && !policy.allowPublicChannelBroadScopeWrites) {
+        violations.push({
+            code: "public_channel_broad_scope",
+            message: "Public channels cannot write broad Memory scopes.",
+        });
+    }
+    if (!policy.allowSensitiveContent) {
+        const values = [
+            item.content,
+            ...(item.summary ? [item.summary] : []),
+        ];
+        const findings = [];
+        for (const value of values) {
+            findings.push(...detectSensitiveMemoryContent(value));
+            if (policy.sensitiveContentHook) {
+                try {
+                    const custom = await policy.sensitiveContentHook(value);
+                    findings.push(...custom.map(normalizeFinding));
+                }
+                catch (error) {
+                    throw new MemoryPolicyError("Memory sensitive-content policy failed closed", { cause: error });
+                }
+            }
+        }
+        if (findings.length > 0) {
+            violations.push({
+                code: "sensitive_content",
+                message: "Memory content contains sensitive credential material.",
+                findingCodes: [...new Set(findings.map((finding) => finding.code))],
+            });
+        }
+    }
+    return Object.freeze({
+        allowed: violations.length === 0,
+        violations: Object.freeze(violations),
+    });
+}
+//# sourceMappingURL=policy.js.map

package/dist/memory/policy.js.map

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

package/dist/memory/ranking.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryItem } from "./types.js";
+import type { MemorySearchResult } from "./store-types.js";
+export declare function estimateMemoryItemTokens(item: MemoryItem): number;
+export declare function rankMemoryItems(items: readonly MemoryItem[], query: string): MemorySearchResult[];
+export declare function selectMemoryResultsWithinBudget(results: readonly MemorySearchResult[], options: {
+    readonly tokenBudget: number;
+    readonly maxResults?: number;
+}): MemorySearchResult[];
+//# sourceMappingURL=ranking.d.ts.map

package/dist/memory/ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../../src/memory/ranking.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAa3D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGjE;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,KAAK,EAAE,MAAM,GACZ,kBAAkB,EAAE,CAqCtB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,OAAO,EAAE;IACP,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GACA,kBAAkB,EAAE,CA6BtB"}

package/dist/memory/ranking.js

@@ -0,0 +1,65 @@
+import { MemoryContractError } from "./errors.js";
+const TOKEN_PATTERN = /[\p{L}\p{N}]+/gu;
+function terms(value) {
+    return [
+        ...new Set((value.normalize("NFKC").toLowerCase().match(TOKEN_PATTERN) ?? [])
+            .filter(Boolean)),
+    ];
+}
+export function estimateMemoryItemTokens(item) {
+    const characters = item.content.length + (item.summary?.length ?? 0);
+    return Math.max(1, Math.ceil(characters / 4));
+}
+export function rankMemoryItems(items, query) {
+    const queryTerms = terms(query);
+    if (queryTerms.length === 0) {
+        throw new MemoryContractError("Memory search query must contain searchable terms", "invalid_item", "query");
+    }
+    const normalizedQuery = query.normalize("NFKC").trim().toLowerCase();
+    return items
+        .map((item) => {
+        const searchable = `${item.summary ?? ""}\n${item.content}`
+            .normalize("NFKC")
+            .toLowerCase();
+        const searchableTerms = new Set(terms(searchable));
+        const matchedTerms = queryTerms.filter((term) => searchableTerms.has(term));
+        if (matchedTerms.length === 0)
+            return undefined;
+        const coverage = matchedTerms.length / queryTerms.length;
+        const density = matchedTerms.length / Math.max(1, searchableTerms.size);
+        const exactPhrase = searchable.includes(normalizedQuery) ? 1 : 0;
+        const score = exactPhrase * 2 + coverage + density;
+        return Object.freeze({
+            item,
+            score,
+            matchedTerms: Object.freeze(matchedTerms),
+            estimatedTokens: estimateMemoryItemTokens(item),
+        });
+    })
+        .filter((result) => result !== undefined)
+        .sort((left, right) => (right.score - left.score
+        || right.item.updatedAt.localeCompare(left.item.updatedAt)
+        || left.item.id.localeCompare(right.item.id)));
+}
+export function selectMemoryResultsWithinBudget(results, options) {
+    if (!Number.isInteger(options.tokenBudget)
+        || options.tokenBudget < 0) {
+        throw new MemoryContractError("Memory token budget must be a non-negative integer", "invalid_item", "tokenBudget");
+    }
+    const maxResults = options.maxResults ?? results.length;
+    if (!Number.isInteger(maxResults) || maxResults < 0) {
+        throw new MemoryContractError("Memory maxResults must be a non-negative integer", "invalid_item", "maxResults");
+    }
+    const selected = [];
+    let usedTokens = 0;
+    for (const result of results) {
+        if (selected.length >= maxResults)
+            break;
+        if (usedTokens + result.estimatedTokens > options.tokenBudget)
+            continue;
+        selected.push(result);
+        usedTokens += result.estimatedTokens;
+    }
+    return selected;
+}
+//# sourceMappingURL=ranking.js.map

package/dist/memory/ranking.js.map

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

package/dist/memory/scope.d.ts

@@ -0,0 +1,5 @@
+import { type MemoryScope, type MemoryScopeAccess } from "./types.js";
+export declare function normalizeMemoryScope(value: unknown): MemoryScope;
+export declare function memoryScopeKey(scope: MemoryScope): string;
+export declare function canAccessMemoryScope(scope: MemoryScope, access: MemoryScopeAccess): boolean;
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/memory/scope.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AA6BpB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CA0ChE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAOzD;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAsBT"}

package/dist/memory/scope.js

@@ -0,0 +1,68 @@
+import { MemoryContractError } from "./errors.js";
+import { MEMORY_SCOPE_KINDS, } from "./types.js";
+const scopeKinds = new Set(MEMORY_SCOPE_KINDS);
+const MAX_SCOPE_IDENTIFIER_CHARACTERS = 512;
+const MAX_AGENT_NAME_CHARACTERS = 128;
+function requiredIdentifier(value, path, max = MAX_SCOPE_IDENTIFIER_CHARACTERS) {
+    if (typeof value !== "string") {
+        throw new MemoryContractError(`${path} must be a non-empty string`, "invalid_scope", path);
+    }
+    const normalized = value.trim();
+    if (normalized.length === 0 || normalized.length > max) {
+        throw new MemoryContractError(`${path} must contain between 1 and ${max} characters`, "invalid_scope", path);
+    }
+    return normalized;
+}
+export function normalizeMemoryScope(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new MemoryContractError("Memory scope must be an object", "invalid_scope", "scope");
+    }
+    const candidate = value;
+    if (typeof candidate.kind !== "string" || !scopeKinds.has(candidate.kind)) {
+        throw new MemoryContractError(`Unknown Memory scope kind: ${String(candidate.kind)}`, "invalid_scope", "scope.kind");
+    }
+    const kind = candidate.kind;
+    if (kind === "agent") {
+        return Object.freeze({
+            kind,
+            agentName: requiredIdentifier(candidate.agentName, "scope.agentName", MAX_AGENT_NAME_CHARACTERS),
+        });
+    }
+    const subjectId = requiredIdentifier(candidate.subjectId, "scope.subjectId");
+    if (kind === "user" && candidate.agentName !== undefined) {
+        return Object.freeze({
+            kind,
+            subjectId,
+            agentName: requiredIdentifier(candidate.agentName, "scope.agentName", MAX_AGENT_NAME_CHARACTERS),
+        });
+    }
+    return Object.freeze({ kind, subjectId });
+}
+export function memoryScopeKey(scope) {
+    const normalized = normalizeMemoryScope(scope);
+    return JSON.stringify([
+        normalized.kind,
+        normalized.subjectId ?? "",
+        normalized.agentName ?? "",
+    ]);
+}
+export function canAccessMemoryScope(scope, access) {
+    const normalized = normalizeMemoryScope(scope);
+    switch (normalized.kind) {
+        case "org":
+            return normalized.subjectId === access.orgId;
+        case "project":
+            return normalized.subjectId === access.projectId;
+        case "agent":
+            return normalized.agentName === access.agentName;
+        case "user":
+            return (normalized.subjectId === access.externalUserId
+                && (normalized.agentName === undefined
+                    || normalized.agentName === access.agentName));
+        case "channel":
+            return normalized.subjectId === access.channelId;
+        case "session":
+            return normalized.subjectId === access.sessionId;
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/memory/scope.js.map

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

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

@@ -0,0 +1,10 @@
+export declare class MemoryAuthorizationError extends Error {
+    constructor(message?: string);
+}
+export declare class MemoryConflictError extends Error {
+    constructor(message: string);
+}
+export declare class MemoryPolicyError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=store-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-errors.d.ts","sourceRoot":"","sources":["../../src/memory/store-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,SAAmC;CAIvD;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD"}

package/dist/memory/store-errors.js

@@ -0,0 +1,19 @@
+export class MemoryAuthorizationError extends Error {
+    constructor(message = "Memory scope is not authorized") {
+        super(message);
+        this.name = "MemoryAuthorizationError";
+    }
+}
+export class MemoryConflictError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MemoryConflictError";
+    }
+}
+export class MemoryPolicyError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "MemoryPolicyError";
+    }
+}
+//# sourceMappingURL=store-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-errors.js","sourceRoot":"","sources":["../../src/memory/store-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAO,GAAG,gCAAgC;QACpD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/memory/store-types.d.ts

@@ -0,0 +1,81 @@
+import type { MemoryDedupeInput, MemoryItem, MemoryKind, MemoryScope, MemoryScopeAccess, MemoryStatus } from "./types.js";
+export type MemoryWriteSurface = "api" | "chat" | "task" | "loop" | "schedule" | "channel" | "system";
+export interface MemoryStoreContext {
+    /** Host-owned hard isolation boundary, normally a project id. */
+    readonly namespace: string;
+    readonly access: MemoryScopeAccess;
+    readonly surface?: MemoryWriteSurface;
+    readonly channelVisibility?: "public" | "private";
+    readonly now?: Date | string;
+}
+export interface MemoryItemPatch {
+    readonly content?: string;
+    readonly summary?: string | null;
+    readonly confidence?: number | null;
+    readonly status?: MemoryStatus;
+    readonly expiresAt?: string | null;
+}
+export interface MemoryGetOptions {
+    readonly includeInactive?: boolean;
+    readonly includeExpired?: boolean;
+    readonly now?: Date | string;
+}
+export interface MemoryListQuery {
+    readonly kinds?: readonly MemoryKind[];
+    readonly statuses?: readonly MemoryStatus[];
+    readonly scope?: MemoryScope;
+    readonly includeExpired?: boolean;
+    readonly now?: Date | string;
+    readonly limit?: number;
+}
+export interface MemorySearchQuery {
+    readonly query: string;
+    readonly kinds?: readonly MemoryKind[];
+    readonly scope?: MemoryScope;
+    readonly tokenBudget?: number;
+    readonly maxResults?: number;
+    readonly now?: Date | string;
+}
+export interface MemorySearchResult {
+    readonly item: MemoryItem;
+    readonly score: number;
+    readonly matchedTerms: readonly string[];
+    readonly estimatedTokens: number;
+}
+export type MemoryUsageEventType = "retrieved" | "written" | "updated" | "superseded" | "forgotten";
+export interface MemoryUsageEvent {
+    readonly id: string;
+    readonly memoryId: string;
+    readonly type: MemoryUsageEventType;
+    readonly at: string;
+    readonly runId?: string;
+    readonly sessionId?: string;
+    readonly requestId?: string;
+}
+export interface MemorySupersedeResult {
+    readonly superseded: MemoryItem;
+    readonly replacement: MemoryItem;
+}
+export interface MemoryItemStore {
+    create(item: MemoryItem, context: MemoryStoreContext): Promise<MemoryItem>;
+    get(id: string, context: MemoryStoreContext, options?: MemoryGetOptions): Promise<MemoryItem | undefined>;
+    list(query: MemoryListQuery, context: MemoryStoreContext): Promise<MemoryItem[]>;
+    update(id: string, patch: MemoryItemPatch, context: MemoryStoreContext): Promise<MemoryItem | undefined>;
+    supersede(id: string, replacement: MemoryItem, context: MemoryStoreContext): Promise<MemorySupersedeResult | undefined>;
+    forget(id: string, context: MemoryStoreContext): Promise<boolean>;
+    search(query: MemorySearchQuery, context: MemoryStoreContext): Promise<MemorySearchResult[]>;
+    findDedupeCandidate(input: MemoryDedupeInput, context: MemoryStoreContext): Promise<MemoryItem | undefined>;
+    appendUsage(event: MemoryUsageEvent, context: MemoryStoreContext): Promise<void>;
+    listUsage(memoryId: string, context: MemoryStoreContext): Promise<MemoryUsageEvent[]>;
+    close?(): Promise<void> | void;
+}
+export interface MemoryStoreSnapshotNamespace {
+    readonly namespace: string;
+    readonly items: readonly MemoryItem[];
+    readonly usage: readonly MemoryUsageEvent[];
+}
+export interface MemoryItemStoreSnapshot {
+    readonly version: 1;
+    readonly namespaces: readonly MemoryStoreSnapshotNamespace[];
+}
+//# sourceMappingURL=store-types.d.ts.map

package/dist/memory/store-types.d.ts.map

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

package/dist/memory/store-types.js

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

package/dist/memory/store-types.js.map

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

package/dist/memory/types.d.ts

@@ -0,0 +1,70 @@
+export declare const MEMORY_SCOPE_KINDS: readonly ["org", "project", "agent", "user", "channel", "session"];
+export type MemoryScopeKind = (typeof MEMORY_SCOPE_KINDS)[number];
+export interface MemoryScope {
+    readonly kind: MemoryScopeKind;
+    readonly subjectId?: string;
+    readonly agentName?: string;
+}
+export declare const MEMORY_KINDS: readonly ["fact", "preference", "open_thread", "style", "failure_pattern", "successful_episode", "procedure_hint"];
+export type MemoryKind = (typeof MEMORY_KINDS)[number];
+export declare const MEMORY_STATUSES: readonly ["pending", "active", "superseded", "deleted"];
+export type MemoryStatus = (typeof MEMORY_STATUSES)[number];
+export declare const MEMORY_PROVENANCE_SOURCES: readonly ["explicit", "run", "session", "tool", "import", "extraction"];
+export type MemoryProvenanceSource = (typeof MEMORY_PROVENANCE_SOURCES)[number];
+export type MemoryProvenanceActor = "user" | "agent" | "system";
+export interface MemoryProvenance {
+    readonly source: MemoryProvenanceSource;
+    readonly actor?: MemoryProvenanceActor;
+    readonly sourceId?: string;
+    readonly runId?: string;
+    readonly sessionId?: string;
+    readonly messageId?: string;
+    readonly toolName?: string;
+}
+export interface MemoryItem {
+    readonly id: string;
+    readonly scope: MemoryScope;
+    readonly kind: MemoryKind;
+    readonly content: string;
+    readonly summary?: string;
+    readonly provenance: MemoryProvenance;
+    readonly confidence?: number;
+    readonly status: MemoryStatus;
+    readonly expiresAt?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface CreateMemoryItemInput {
+    readonly id?: string;
+    readonly scope: MemoryScope;
+    readonly kind: MemoryKind;
+    readonly content: string;
+    readonly summary?: string;
+    readonly provenance: MemoryProvenance;
+    readonly confidence?: number;
+    readonly status?: Extract<MemoryStatus, "pending" | "active">;
+    readonly expiresAt?: string;
+}
+export interface MemoryItemFactoryOptions {
+    readonly createId?: () => string;
+    readonly now?: () => Date | string;
+}
+export interface MemoryScopeAccess {
+    readonly orgId?: string;
+    readonly projectId?: string;
+    readonly agentName?: string;
+    /** Hosted application's end user, never the Polpo account/member id. */
+    readonly externalUserId?: string;
+    readonly channelId?: string;
+    readonly sessionId?: string;
+}
+export interface MemoryDedupeInput {
+    readonly scope: MemoryScope;
+    readonly kind: MemoryKind;
+    readonly content: string;
+}
+export interface RenderMemoryItemsOptions {
+    readonly now?: Date | string;
+    readonly includePending?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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