@polpo-ai/core 0.15.41 → 0.15.42

package/dist/memory/in-memory-store.js

@@ -0,0 +1,380 @@
+import { MemoryContractError } from "./errors.js";
+import { createMemoryDedupeIdentity } from "./dedupe.js";
+import { normalizeMemoryItem } from "./item.js";
+import { assertMemoryStatusTransition, isMemoryItemExpired, isMemoryItemRetrievable, } from "./lifecycle.js";
+import { evaluateMemoryWrite } from "./policy.js";
+import { rankMemoryItems, selectMemoryResultsWithinBudget } from "./ranking.js";
+import { canAccessMemoryScope, memoryScopeKey, normalizeMemoryScope, } from "./scope.js";
+import { MemoryAuthorizationError, MemoryConflictError, MemoryPolicyError, } from "./store-errors.js";
+import { MEMORY_KINDS, MEMORY_STATUSES, } from "./types.js";
+const memoryKinds = new Set(MEMORY_KINDS);
+const memoryStatuses = new Set(MEMORY_STATUSES);
+const usageTypes = new Set([
+    "retrieved",
+    "written",
+    "updated",
+    "superseded",
+    "forgotten",
+]);
+function text(value, path, max = 512) {
+    if (typeof value !== "string") {
+        throw new MemoryContractError(`${path} must be a string`, "invalid_item", path);
+    }
+    const normalized = value.trim();
+    if (normalized.length === 0 || normalized.length > max) {
+        throw new MemoryContractError(`${path} must contain between 1 and ${max} characters`, "invalid_item", path);
+    }
+    return normalized;
+}
+function timestamp(value, path) {
+    if (!(typeof value === "string" || value instanceof Date)) {
+        throw new MemoryContractError(`${path} must be a timestamp`, "invalid_item", path);
+    }
+    const parsed = value instanceof Date ? value : new Date(value);
+    if (!Number.isFinite(parsed.getTime())) {
+        throw new MemoryContractError(`${path} must be a timestamp`, "invalid_item", path);
+    }
+    return parsed.toISOString();
+}
+function normalizeContext(context) {
+    if (!context || typeof context !== "object") {
+        throw new MemoryContractError("Memory store context is required");
+    }
+    if (!context.access
+        || typeof context.access !== "object"
+        || Array.isArray(context.access)) {
+        throw new MemoryContractError("Memory store access context is required", "invalid_scope", "access");
+    }
+    return {
+        ...context,
+        namespace: text(context.namespace, "namespace"),
+        access: { ...context.access },
+        ...(context.now ? { now: timestamp(context.now, "now") } : {}),
+    };
+}
+function normalizeLimit(value) {
+    if (value === undefined)
+        return 1_000;
+    if (!Number.isInteger(value) || value < 0 || value > 10_000) {
+        throw new MemoryContractError("Memory list limit must be an integer between 0 and 10000", "invalid_item", "limit");
+    }
+    return value;
+}
+function normalizeUsageEvent(value) {
+    if (!value || typeof value !== "object" || !usageTypes.has(value.type)) {
+        throw new MemoryContractError("Invalid Memory usage event");
+    }
+    return Object.freeze({
+        id: text(value.id, "usage.id", 256),
+        memoryId: text(value.memoryId, "usage.memoryId", 256),
+        type: value.type,
+        at: timestamp(value.at, "usage.at"),
+        ...(value.runId ? { runId: text(value.runId, "usage.runId") } : {}),
+        ...(value.sessionId
+            ? { sessionId: text(value.sessionId, "usage.sessionId") }
+            : {}),
+        ...(value.requestId
+            ? { requestId: text(value.requestId, "usage.requestId") }
+            : {}),
+    });
+}
+function cloneItem(item) {
+    return normalizeMemoryItem(JSON.parse(JSON.stringify(item)));
+}
+function cloneUsage(event) {
+    return normalizeUsageEvent(JSON.parse(JSON.stringify(event)));
+}
+export class InMemoryMemoryItemStore {
+    writePolicy;
+    namespaces = new Map();
+    constructor(writePolicy = {}, snapshot) {
+        this.writePolicy = writePolicy;
+        if (snapshot)
+            this.replaceSnapshot(snapshot);
+    }
+    state(namespace) {
+        let state = this.namespaces.get(namespace);
+        if (!state) {
+            state = { items: new Map(), usage: [] };
+            this.namespaces.set(namespace, state);
+        }
+        return state;
+    }
+    existing(id, context) {
+        const normalized = normalizeContext(context);
+        const item = this.namespaces.get(normalized.namespace)?.items.get(text(id, "id", 256));
+        if (!item || !canAccessMemoryScope(item.scope, normalized.access)) {
+            return undefined;
+        }
+        return item;
+    }
+    async assertWriteAllowed(item, context) {
+        const decision = await evaluateMemoryWrite(item, context, this.writePolicy);
+        const unauthorized = decision.violations.some((violation) => violation.code === "unauthorized_scope");
+        if (unauthorized)
+            throw new MemoryAuthorizationError();
+        if (!decision.allowed) {
+            throw new MemoryPolicyError(`Memory write denied: ${decision.violations
+                .map((violation) => violation.code)
+                .join(", ")}`);
+        }
+    }
+    async create(value, context) {
+        const normalizedContext = normalizeContext(context);
+        const item = cloneItem(value);
+        if (item.status !== "active" && item.status !== "pending") {
+            throw new MemoryContractError("New Memory items may only be active or pending", "invalid_item", "status");
+        }
+        await this.assertWriteAllowed(item, normalizedContext);
+        const state = this.state(normalizedContext.namespace);
+        if (state.items.has(item.id)) {
+            throw new MemoryConflictError(`Memory item "${item.id}" already exists in this namespace`);
+        }
+        state.items.set(item.id, item);
+        return cloneItem(item);
+    }
+    async get(id, context, options = {}) {
+        const item = this.existing(id, context);
+        if (!item)
+            return undefined;
+        const now = options.now ?? context.now ?? new Date();
+        if (!options.includeInactive && item.status !== "active")
+            return undefined;
+        if (!options.includeExpired && isMemoryItemExpired(item, now))
+            return undefined;
+        return cloneItem(item);
+    }
+    async list(query, context) {
+        const normalized = normalizeContext(context);
+        const state = this.namespaces.get(normalized.namespace);
+        if (!state)
+            return [];
+        const statuses = query.statuses ?? ["active"];
+        for (const status of statuses) {
+            if (!memoryStatuses.has(status)) {
+                throw new MemoryContractError(`Unknown Memory status: ${status}`);
+            }
+        }
+        const kinds = query.kinds;
+        if (kinds) {
+            for (const kind of kinds) {
+                if (!memoryKinds.has(kind)) {
+                    throw new MemoryContractError(`Unknown Memory kind: ${kind}`);
+                }
+            }
+        }
+        const scopeKey = query.scope
+            ? memoryScopeKey(normalizeMemoryScope(query.scope))
+            : undefined;
+        const now = query.now ?? normalized.now ?? new Date();
+        const limit = normalizeLimit(query.limit);
+        return [...state.items.values()]
+            .filter((item) => canAccessMemoryScope(item.scope, normalized.access))
+            .filter((item) => statuses.includes(item.status))
+            .filter((item) => !kinds || kinds.includes(item.kind))
+            .filter((item) => !scopeKey || memoryScopeKey(item.scope) === scopeKey)
+            .filter((item) => query.includeExpired || !isMemoryItemExpired(item, now))
+            .sort((left, right) => (left.createdAt.localeCompare(right.createdAt)
+            || left.id.localeCompare(right.id)))
+            .slice(0, limit)
+            .map(cloneItem);
+    }
+    async update(id, patch, context) {
+        const normalized = normalizeContext(context);
+        const current = this.existing(id, normalized);
+        if (!current)
+            return undefined;
+        const status = patch.status ?? current.status;
+        assertMemoryStatusTransition(current.status, status);
+        const candidate = normalizeMemoryItem({
+            ...current,
+            ...(patch.content === undefined ? {} : { content: patch.content }),
+            ...(patch.summary === undefined
+                ? {}
+                : patch.summary === null
+                    ? { summary: undefined }
+                    : { summary: patch.summary }),
+            ...(patch.confidence === undefined
+                ? {}
+                : patch.confidence === null
+                    ? { confidence: undefined }
+                    : { confidence: patch.confidence }),
+            ...(patch.expiresAt === undefined
+                ? {}
+                : patch.expiresAt === null
+                    ? { expiresAt: undefined }
+                    : { expiresAt: patch.expiresAt }),
+            status,
+            updatedAt: timestamp(normalized.now ?? new Date(), "now"),
+        });
+        await this.assertWriteAllowed(candidate, normalized);
+        const state = this.state(normalized.namespace);
+        if (state.items.get(current.id) !== current) {
+            throw new MemoryConflictError(`Memory item "${current.id}" changed during update`);
+        }
+        state.items.set(candidate.id, candidate);
+        return cloneItem(candidate);
+    }
+    async supersede(id, replacementValue, context) {
+        const normalized = normalizeContext(context);
+        const current = this.existing(id, normalized);
+        if (!current)
+            return undefined;
+        assertMemoryStatusTransition(current.status, "superseded");
+        const replacement = cloneItem(replacementValue);
+        if (replacement.status !== "active") {
+            throw new MemoryContractError("A superseding Memory replacement must be active", "invalid_item", "status");
+        }
+        if (replacement.id === current.id) {
+            throw new MemoryConflictError("Replacement Memory id must be different");
+        }
+        const state = this.state(normalized.namespace);
+        if (state.items.has(replacement.id)) {
+            throw new MemoryConflictError(`Memory item "${replacement.id}" already exists in this namespace`);
+        }
+        await this.assertWriteAllowed(replacement, normalized);
+        if (state.items.get(current.id) !== current) {
+            throw new MemoryConflictError(`Memory item "${current.id}" changed during supersede`);
+        }
+        if (state.items.has(replacement.id)) {
+            throw new MemoryConflictError(`Memory item "${replacement.id}" was created during supersede`);
+        }
+        const updatedAt = timestamp(normalized.now ?? new Date(), "now");
+        const superseded = normalizeMemoryItem({
+            ...current,
+            status: "superseded",
+            updatedAt,
+        });
+        state.items.set(current.id, superseded);
+        state.items.set(replacement.id, replacement);
+        return {
+            superseded: cloneItem(superseded),
+            replacement: cloneItem(replacement),
+        };
+    }
+    async forget(id, context) {
+        const normalized = normalizeContext(context);
+        const current = this.existing(id, normalized);
+        if (!current)
+            return false;
+        assertMemoryStatusTransition(current.status, "deleted");
+        const deleted = normalizeMemoryItem({
+            ...current,
+            status: "deleted",
+            updatedAt: timestamp(normalized.now ?? new Date(), "now"),
+        });
+        this.state(normalized.namespace).items.set(deleted.id, deleted);
+        return true;
+    }
+    async search(query, context) {
+        const candidates = await this.list({
+            statuses: ["active"],
+            kinds: query.kinds,
+            scope: query.scope,
+            now: query.now,
+            limit: 10_000,
+        }, context);
+        const ranked = rankMemoryItems(candidates.filter((item) => isMemoryItemRetrievable(item, query.now ?? context.now ?? new Date())), query.query);
+        return selectMemoryResultsWithinBudget(ranked, {
+            tokenBudget: query.tokenBudget ?? Number.MAX_SAFE_INTEGER,
+            maxResults: query.maxResults ?? 20,
+        });
+    }
+    async findDedupeCandidate(input, context) {
+        const identity = createMemoryDedupeIdentity(input);
+        const normalized = normalizeContext(context);
+        const state = this.namespaces.get(normalized.namespace);
+        if (!state)
+            return undefined;
+        const now = normalized.now ?? new Date();
+        const candidate = [...state.items.values()]
+            .filter((item) => canAccessMemoryScope(item.scope, normalized.access))
+            .filter((item) => item.status === "active" || item.status === "pending")
+            .filter((item) => !isMemoryItemExpired(item, now))
+            .filter((item) => createMemoryDedupeIdentity(item) === identity)
+            .sort((left, right) => (left.createdAt.localeCompare(right.createdAt)
+            || left.id.localeCompare(right.id)))[0];
+        return candidate ? cloneItem(candidate) : undefined;
+    }
+    async appendUsage(value, context) {
+        const normalized = normalizeContext(context);
+        const item = this.existing(value.memoryId, normalized);
+        if (!item)
+            throw new MemoryAuthorizationError();
+        const event = normalizeUsageEvent(value);
+        const state = this.state(normalized.namespace);
+        if (state.usage.some((existing) => existing.id === event.id)) {
+            throw new MemoryConflictError(`Memory usage event "${event.id}" already exists`);
+        }
+        state.usage.push(event);
+    }
+    async listUsage(memoryId, context) {
+        const normalized = normalizeContext(context);
+        const item = this.existing(memoryId, normalized);
+        if (!item)
+            return [];
+        return (this.namespaces.get(normalized.namespace)?.usage ?? [])
+            .filter((event) => event.memoryId === item.id)
+            .slice()
+            .sort((left, right) => (left.at.localeCompare(right.at)
+            || left.id.localeCompare(right.id)))
+            .map(cloneUsage);
+    }
+    exportSnapshot() {
+        const namespaces = [...this.namespaces]
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([namespace, state]) => ({
+            namespace,
+            items: [...state.items.values()]
+                .sort((left, right) => left.id.localeCompare(right.id))
+                .map(cloneItem),
+            usage: state.usage
+                .slice()
+                .sort((left, right) => left.id.localeCompare(right.id))
+                .map(cloneUsage),
+        }));
+        return Object.freeze({
+            version: 1,
+            namespaces: Object.freeze(namespaces),
+        });
+    }
+    replaceSnapshot(value) {
+        if (!value || value.version !== 1 || !Array.isArray(value.namespaces)) {
+            throw new MemoryContractError("Invalid Memory item store snapshot");
+        }
+        const next = new Map();
+        for (const namespaceState of value.namespaces) {
+            const namespace = text(namespaceState.namespace, "snapshot.namespace");
+            if (next.has(namespace)) {
+                throw new MemoryConflictError(`Duplicate Memory namespace "${namespace}"`);
+            }
+            if (!Array.isArray(namespaceState.items)
+                || !Array.isArray(namespaceState.usage)) {
+                throw new MemoryContractError("Invalid Memory namespace snapshot");
+            }
+            const items = new Map();
+            for (const valueItem of namespaceState.items) {
+                const item = cloneItem(valueItem);
+                if (items.has(item.id)) {
+                    throw new MemoryConflictError(`Duplicate Memory item "${item.id}"`);
+                }
+                items.set(item.id, item);
+            }
+            const usage = namespaceState.usage.map((event) => cloneUsage(event));
+            if (new Set(usage.map((event) => event.id)).size !== usage.length) {
+                throw new MemoryConflictError("Duplicate Memory usage event");
+            }
+            for (const event of usage) {
+                if (!items.has(event.memoryId)) {
+                    throw new MemoryContractError(`Memory usage references missing item "${event.memoryId}"`);
+                }
+            }
+            next.set(namespace, { items, usage });
+        }
+        this.namespaces.clear();
+        for (const [namespace, state] of next) {
+            this.namespaces.set(namespace, state);
+        }
+    }
+}
+//# sourceMappingURL=in-memory-store.js.map

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

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

package/dist/memory/index.d.ts

@@ -0,0 +1,20 @@
+export { MAX_MEMORY_CONTENT_CHARACTERS, MAX_MEMORY_SUMMARY_CHARACTERS, createMemoryItem, normalizeMemoryItem, } from "./item.js";
+export { canAccessMemoryScope, memoryScopeKey, normalizeMemoryScope, } from "./scope.js";
+export { assertMemoryStatusTransition, isMemoryItemExpired, isMemoryItemRetrievable, } from "./lifecycle.js";
+export { createMemoryDedupeIdentity, normalizeMemoryDedupeContent, } from "./dedupe.js";
+export { renderMemoryItemsMarkdown } from "./compatibility.js";
+export { MemoryContractError } from "./errors.js";
+export type { MemoryContractErrorCode } from "./errors.js";
+export { MemoryAuthorizationError, MemoryConflictError, MemoryPolicyError, } from "./store-errors.js";
+export { detectSensitiveMemoryContent, evaluateMemoryWrite, } from "./policy.js";
+export type { MemoryPolicyViolation, MemorySensitiveContentFinding, MemorySensitiveContentHook, MemoryWriteDecision, MemoryWritePolicy, } from "./policy.js";
+export { estimateMemoryItemTokens, rankMemoryItems, selectMemoryResultsWithinBudget, } from "./ranking.js";
+export { InMemoryMemoryItemStore } from "./in-memory-store.js";
+export { MEMORY_EXTRACTION_AUDIT_TYPES, MEMORY_EXTRACTION_PROPOSAL_ACTIONS, MEMORY_EXTRACTION_STATUSES, createMemoryExtractionCandidate, createMemoryExtractionDecision, memoryExtractionCandidateIdentity, normalizeMemoryExtractionAuditEvent, normalizeMemoryExtractionCandidate, } from "./extraction.js";
+export type { CreateMemoryExtractionCandidateInput, MemoryExtractionApplyInput, MemoryExtractionAuditEvent, MemoryExtractionAuditType, MemoryExtractionCandidate, MemoryExtractionCandidateFactoryOptions, MemoryExtractionCandidateStore, MemoryExtractionDecision, MemoryExtractionDecisionInput, MemoryExtractionListQuery, MemoryExtractionMetadataValue, MemoryExtractionProposal, MemoryExtractionProposalAction, MemoryExtractionProposeResult, MemoryExtractionReviewer, MemoryExtractionSnapshotNamespace, MemoryExtractionSource, MemoryExtractionStatus, MemoryExtractionStoreContext, MemoryExtractionStoreSnapshot, } from "./extraction.js";
+export { InMemoryMemoryExtractionStore, } from "./in-memory-extraction-store.js";
+export type { InMemoryMemoryExtractionStoreOptions, } from "./in-memory-extraction-store.js";
+export { MEMORY_KINDS, MEMORY_PROVENANCE_SOURCES, MEMORY_SCOPE_KINDS, MEMORY_STATUSES, } from "./types.js";
+export type { CreateMemoryItemInput, MemoryDedupeInput, MemoryItem, MemoryItemFactoryOptions, MemoryKind, MemoryProvenance, MemoryProvenanceActor, MemoryProvenanceSource, MemoryScope, MemoryScopeAccess, MemoryScopeKind, MemoryStatus, RenderMemoryItemsOptions, } from "./types.js";
+export type { MemoryGetOptions, MemoryItemPatch, MemoryItemStore, MemoryItemStoreSnapshot, MemoryListQuery, MemorySearchQuery, MemorySearchResult, MemoryStoreContext, MemoryStoreSnapshotNamespace, MemorySupersedeResult, MemoryUsageEvent, MemoryUsageEventType, MemoryWriteSurface, } from "./store-types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,+BAA+B,GAChC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,0BAA0B,EAC1B,+BAA+B,EAC/B,8BAA8B,EAC9B,iCAAiC,EACjC,mCAAmC,EACnC,kCAAkC,GACnC,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,oCAAoC,EACpC,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,uCAAuC,EACvC,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC7B,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,8BAA8B,EAC9B,6BAA6B,EAC7B,wBAAwB,EACxB,iCAAiC,EACjC,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,oCAAoC,GACrC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,wBAAwB,EACxB,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,14 @@
+export { MAX_MEMORY_CONTENT_CHARACTERS, MAX_MEMORY_SUMMARY_CHARACTERS, createMemoryItem, normalizeMemoryItem, } from "./item.js";
+export { canAccessMemoryScope, memoryScopeKey, normalizeMemoryScope, } from "./scope.js";
+export { assertMemoryStatusTransition, isMemoryItemExpired, isMemoryItemRetrievable, } from "./lifecycle.js";
+export { createMemoryDedupeIdentity, normalizeMemoryDedupeContent, } from "./dedupe.js";
+export { renderMemoryItemsMarkdown } from "./compatibility.js";
+export { MemoryContractError } from "./errors.js";
+export { MemoryAuthorizationError, MemoryConflictError, MemoryPolicyError, } from "./store-errors.js";
+export { detectSensitiveMemoryContent, evaluateMemoryWrite, } from "./policy.js";
+export { estimateMemoryItemTokens, rankMemoryItems, selectMemoryResultsWithinBudget, } from "./ranking.js";
+export { InMemoryMemoryItemStore } from "./in-memory-store.js";
+export { MEMORY_EXTRACTION_AUDIT_TYPES, MEMORY_EXTRACTION_PROPOSAL_ACTIONS, MEMORY_EXTRACTION_STATUSES, createMemoryExtractionCandidate, createMemoryExtractionDecision, memoryExtractionCandidateIdentity, normalizeMemoryExtractionAuditEvent, normalizeMemoryExtractionCandidate, } from "./extraction.js";
+export { InMemoryMemoryExtractionStore, } from "./in-memory-extraction-store.js";
+export { MEMORY_KINDS, MEMORY_PROVENANCE_SOURCES, MEMORY_SCOPE_KINDS, MEMORY_STATUSES, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAQrB,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,+BAA+B,GAChC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,0BAA0B,EAC1B,+BAA+B,EAC/B,8BAA8B,EAC9B,iCAAiC,EACjC,mCAAmC,EACnC,kCAAkC,GACnC,MAAM,iBAAiB,CAAC;AAuBzB,OAAO,EACL,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/memory/item.d.ts

@@ -0,0 +1,6 @@
+import { type CreateMemoryItemInput, type MemoryItem, type MemoryItemFactoryOptions } from "./types.js";
+export declare const MAX_MEMORY_CONTENT_CHARACTERS = 32000;
+export declare const MAX_MEMORY_SUMMARY_CHARACTERS = 1000;
+export declare function createMemoryItem(input: CreateMemoryItemInput, factory?: MemoryItemFactoryOptions): MemoryItem;
+export declare function normalizeMemoryItem(value: unknown): MemoryItem;
+//# sourceMappingURL=item.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../src/memory/item.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,wBAAwB,EAM9B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,6BAA6B,QAAS,CAAC;AACpD,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AA+OnD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,EAC5B,OAAO,GAAE,wBAA6B,GACrC,UAAU,CA2BZ;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAK9D"}

package/dist/memory/item.js

@@ -0,0 +1,169 @@
+import { nanoid } from "nanoid";
+import { MemoryContractError } from "./errors.js";
+import { normalizeMemoryScope } from "./scope.js";
+import { MEMORY_KINDS, MEMORY_PROVENANCE_SOURCES, MEMORY_STATUSES, } from "./types.js";
+export const MAX_MEMORY_CONTENT_CHARACTERS = 32_000;
+export const MAX_MEMORY_SUMMARY_CHARACTERS = 1_000;
+const kinds = new Set(MEMORY_KINDS);
+const statuses = new Set(MEMORY_STATUSES);
+const provenanceSources = new Set(MEMORY_PROVENANCE_SOURCES);
+const provenanceActors = new Set(["user", "agent", "system"]);
+function text(value, path, max, required = true) {
+    if (value === undefined && !required)
+        return undefined;
+    if (typeof value !== "string") {
+        throw new MemoryContractError(`${path} must be a string`, "invalid_item", path);
+    }
+    const normalized = value.trim();
+    if ((required && normalized.length === 0)
+        || normalized.length > max) {
+        throw new MemoryContractError(`${path} must contain ${required ? "between 1 and" : "at most"} ${max} characters`, "invalid_item", path);
+    }
+    return normalized || undefined;
+}
+function isoTimestamp(value, path) {
+    if (!(typeof value === "string" || value instanceof Date)) {
+        throw new MemoryContractError(`${path} must be a valid timestamp`, "invalid_item", path);
+    }
+    const date = value instanceof Date ? value : new Date(value);
+    if (!Number.isFinite(date.getTime())) {
+        throw new MemoryContractError(`${path} must be a valid timestamp`, "invalid_item", path);
+    }
+    return date.toISOString();
+}
+function optionalReference(value, path) {
+    return text(value, path, 512, false);
+}
+function normalizeProvenance(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new MemoryContractError("Memory provenance must be an object", "invalid_provenance", "provenance");
+    }
+    const candidate = value;
+    if (typeof candidate.source !== "string"
+        || !provenanceSources.has(candidate.source)) {
+        throw new MemoryContractError(`Unknown Memory provenance source: ${String(candidate.source)}`, "invalid_provenance", "provenance.source");
+    }
+    const source = candidate.source;
+    let actor;
+    if (candidate.actor !== undefined) {
+        if (typeof candidate.actor !== "string"
+            || !provenanceActors.has(candidate.actor)) {
+            throw new MemoryContractError(`Unknown Memory provenance actor: ${String(candidate.actor)}`, "invalid_provenance", "provenance.actor");
+        }
+        actor = candidate.actor;
+    }
+    const sourceId = optionalReference(candidate.sourceId, "provenance.sourceId");
+    const runId = optionalReference(candidate.runId, "provenance.runId");
+    const sessionId = optionalReference(candidate.sessionId, "provenance.sessionId");
+    const messageId = optionalReference(candidate.messageId, "provenance.messageId");
+    const toolName = optionalReference(candidate.toolName, "provenance.toolName");
+    const provenance = {
+        source,
+        ...(actor ? { actor } : {}),
+        ...(sourceId ? { sourceId } : {}),
+        ...(runId ? { runId } : {}),
+        ...(sessionId ? { sessionId } : {}),
+        ...(messageId ? { messageId } : {}),
+        ...(toolName ? { toolName } : {}),
+    };
+    const hasReference = Boolean(provenance.sourceId
+        || provenance.runId
+        || provenance.sessionId
+        || provenance.messageId
+        || provenance.toolName);
+    if (source === "explicit" && !provenance.actor) {
+        throw new MemoryContractError("Explicit Memory provenance requires an actor", "invalid_provenance", "provenance.actor");
+    }
+    if (source === "run" && !provenance.runId) {
+        throw new MemoryContractError("Run Memory provenance requires runId", "invalid_provenance", "provenance.runId");
+    }
+    if (source === "session" && !provenance.sessionId) {
+        throw new MemoryContractError("Session Memory provenance requires sessionId", "invalid_provenance", "provenance.sessionId");
+    }
+    if (source === "tool" && !provenance.toolName) {
+        throw new MemoryContractError("Tool Memory provenance requires toolName", "invalid_provenance", "provenance.toolName");
+    }
+    if ((source === "import" || source === "extraction") && !hasReference) {
+        throw new MemoryContractError(`${source} Memory provenance requires a source reference`, "invalid_provenance", "provenance");
+    }
+    return Object.freeze(provenance);
+}
+function normalizeConfidence(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number"
+        || !Number.isFinite(value)
+        || value < 0
+        || value > 1) {
+        throw new MemoryContractError("Memory confidence must be a finite number between 0 and 1", "invalid_item", "confidence");
+    }
+    return value;
+}
+function normalizeKind(value) {
+    if (typeof value !== "string" || !kinds.has(value)) {
+        throw new MemoryContractError(`Unknown Memory kind: ${String(value)}`, "invalid_item", "kind");
+    }
+    return value;
+}
+function normalizeStatus(value) {
+    if (typeof value !== "string" || !statuses.has(value)) {
+        throw new MemoryContractError(`Unknown Memory status: ${String(value)}`, "invalid_item", "status");
+    }
+    return value;
+}
+function freezeItem(input) {
+    const createdAt = isoTimestamp(input.createdAt, "createdAt");
+    const updatedAt = isoTimestamp(input.updatedAt, "updatedAt");
+    if (Date.parse(updatedAt) < Date.parse(createdAt)) {
+        throw new MemoryContractError("Memory updatedAt cannot precede createdAt", "invalid_item", "updatedAt");
+    }
+    const confidence = normalizeConfidence(input.confidence);
+    const summary = text(input.summary, "summary", MAX_MEMORY_SUMMARY_CHARACTERS, false);
+    const expiresAt = input.expiresAt === undefined
+        ? undefined
+        : isoTimestamp(input.expiresAt, "expiresAt");
+    return Object.freeze({
+        id: text(input.id, "id", 256),
+        scope: normalizeMemoryScope(input.scope),
+        kind: normalizeKind(input.kind),
+        content: text(input.content, "content", MAX_MEMORY_CONTENT_CHARACTERS),
+        ...(summary ? { summary } : {}),
+        provenance: normalizeProvenance(input.provenance),
+        ...(confidence === undefined ? {} : { confidence }),
+        status: normalizeStatus(input.status),
+        ...(expiresAt ? { expiresAt } : {}),
+        createdAt,
+        updatedAt,
+    });
+}
+export function createMemoryItem(input, factory = {}) {
+    if (!input || typeof input !== "object") {
+        throw new MemoryContractError("Memory item input must be an object");
+    }
+    const status = input.status ?? "active";
+    if (status !== "active" && status !== "pending") {
+        throw new MemoryContractError("New Memory items may only be active or pending", "invalid_item", "status");
+    }
+    const nowValue = factory.now?.() ?? new Date();
+    const now = isoTimestamp(nowValue, "now");
+    return freezeItem({
+        id: input.id ?? factory.createId?.() ?? `memory-${nanoid(16)}`,
+        scope: input.scope,
+        kind: input.kind,
+        content: input.content,
+        summary: input.summary,
+        provenance: input.provenance,
+        confidence: input.confidence,
+        status,
+        expiresAt: input.expiresAt,
+        createdAt: now,
+        updatedAt: now,
+    });
+}
+export function normalizeMemoryItem(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new MemoryContractError("Memory item must be an object");
+    }
+    return freezeItem(value);
+}
+//# sourceMappingURL=item.js.map