ai-memory-layer 2.0.0 → 3.0.0

package/dist/contracts/cognitive.d.ts

@@ -0,0 +1,37 @@
+import type { KnowledgeClass } from './types.js';
+/**
+ * External cognitive memory taxonomy.
+ * Maps the richer internal KnowledgeClass model to a simpler public-facing
+ * four-type cognitive taxonomy (episodic, semantic, procedural, working).
+ */
+export type CognitiveMemoryType = 'episodic' | 'semantic' | 'procedural' | 'working';
+export interface CognitiveMemoryItem {
+    id: number;
+    type: CognitiveMemoryType;
+    fact: string;
+    createdAt: number;
+    lastAccessedAt: number;
+    metadata: {
+        trustScore: number;
+        knowledgeClass: KnowledgeClass;
+        knowledgeState?: string;
+    };
+}
+export interface CognitiveSearchOptions {
+    query: string;
+    types?: CognitiveMemoryType[];
+    limit?: number;
+    minimumTrustScore?: number;
+    activeOnly?: boolean;
+}
+export interface CognitiveSearchHit {
+    item: CognitiveMemoryItem;
+    rank: number;
+}
+export interface CognitiveSearchResult {
+    byType: Record<CognitiveMemoryType, CognitiveSearchHit[]>;
+    all: CognitiveSearchHit[];
+}
+export declare function mapKnowledgeClassToCognitive(knowledgeClass: KnowledgeClass): CognitiveMemoryType;
+export declare function mapCognitiveToKnowledgeClasses(type: CognitiveMemoryType): KnowledgeClass[];
+//# sourceMappingURL=cognitive.d.ts.map

package/dist/contracts/cognitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive.d.ts","sourceRoot":"","sources":["../../src/contracts/cognitive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;GAIG;AAEH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;AAErF,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,cAAc,CAAC;QAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC1D,GAAG,EAAE,kBAAkB,EAAE,CAAC;CAC3B;AAsBD,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,cAAc,GAAG,mBAAmB,CAEhG;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,mBAAmB,GAAG,cAAc,EAAE,CAE1F"}

package/dist/contracts/cognitive.js

@@ -0,0 +1,24 @@
+// -- Mapping functions --
+const knowledgeClassToCognitive = {
+    identity: 'semantic',
+    preference: 'semantic',
+    constraint: 'semantic',
+    project_fact: 'semantic',
+    episodic_fact: 'semantic',
+    strategy: 'semantic',
+    anti_pattern: 'semantic',
+    procedure: 'procedural',
+};
+const cognitiveToKnowledgeClasses = {
+    episodic: [],
+    semantic: ['identity', 'preference', 'constraint', 'project_fact', 'episodic_fact', 'strategy', 'anti_pattern'],
+    procedural: ['procedure'],
+    working: [],
+};
+export function mapKnowledgeClassToCognitive(knowledgeClass) {
+    return knowledgeClassToCognitive[knowledgeClass];
+}
+export function mapCognitiveToKnowledgeClasses(type) {
+    return cognitiveToKnowledgeClasses[type];
+}
+//# sourceMappingURL=cognitive.js.map

package/dist/contracts/cognitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive.js","sourceRoot":"","sources":["../../src/contracts/cognitive.ts"],"names":[],"mappings":"AAyCA,0BAA0B;AAE1B,MAAM,yBAAyB,GAAgD;IAC7E,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,UAAU;IACxB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,UAAU;IACxB,SAAS,EAAE,YAAY;CACxB,CAAC;AAEF,MAAM,2BAA2B,GAAkD;IACjF,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,CAAC;IAC/G,UAAU,EAAE,CAAC,WAAW,CAAC;IACzB,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,cAA8B;IACzE,OAAO,yBAAyB,CAAC,cAAc,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,IAAyB;IACtE,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/contracts/coordination.d.ts

@@ -0,0 +1,101 @@
+import type { NormalizedMemoryScope } from './identity.js';
+import type { TemporalId } from './temporal.js';
+import type { WorkItem } from './types.js';
+export type ActorKind = 'agent' | 'human' | 'system' | 'service';
+export type MemoryVisibilityClass = 'private' | 'shared_collaboration' | 'workspace' | 'tenant';
+export type ContextViewPolicy = 'local_only' | 'local_plus_shared_collaboration' | 'operator_supervisor' | 'workspace_shared';
+export type WorkClaimStatus = 'active' | 'released' | 'expired';
+export type HandoffStatus = 'pending' | 'accepted' | 'rejected' | 'canceled' | 'expired';
+export declare const ACTOR_KINDS: readonly ActorKind[];
+export declare const MEMORY_VISIBILITY_CLASSES: readonly MemoryVisibilityClass[];
+export declare const CONTEXT_VIEW_POLICIES: readonly ContextViewPolicy[];
+export declare const WORK_CLAIM_STATUSES: readonly WorkClaimStatus[];
+export declare const HANDOFF_STATUSES: readonly HandoffStatus[];
+export interface ActorRef {
+    actor_kind: ActorKind;
+    actor_id: string;
+    system_id: string | null;
+    display_name: string | null;
+    metadata: Record<string, unknown> | null;
+}
+export interface WorkClaim extends NormalizedMemoryScope {
+    id: number;
+    work_item_id: number;
+    actor: ActorRef;
+    session_id: string | null;
+    claim_token: string;
+    status: WorkClaimStatus;
+    claimed_at: number;
+    expires_at: number;
+    released_at: number | null;
+    release_reason: string | null;
+    source_event_id: TemporalId | null;
+    visibility_class: MemoryVisibilityClass;
+    version: number;
+}
+export interface NewWorkClaimInput extends NormalizedMemoryScope {
+    work_item_id: number;
+    actor: ActorRef;
+    session_id?: string | null;
+    lease_seconds?: number;
+    visibility_class: MemoryVisibilityClass;
+    claimed_at?: number;
+}
+export interface WorkClaimQuery {
+    actor?: Pick<ActorRef, 'actor_kind' | 'actor_id'>;
+    includeExpired?: boolean;
+    includeReleased?: boolean;
+    sessionId?: string;
+    visibilityClass?: MemoryVisibilityClass;
+    limit?: number;
+}
+export interface HandoffRecord extends NormalizedMemoryScope {
+    id: number;
+    work_item_id: number;
+    from_actor: ActorRef;
+    to_actor: ActorRef;
+    session_id: string | null;
+    summary: string;
+    context_bundle_ref: string | null;
+    status: HandoffStatus;
+    created_at: number;
+    accepted_at: number | null;
+    rejected_at: number | null;
+    canceled_at: number | null;
+    expires_at: number | null;
+    decision_reason: string | null;
+    source_event_id: TemporalId | null;
+    visibility_class: MemoryVisibilityClass;
+    version: number;
+}
+export interface NewHandoffInput extends NormalizedMemoryScope {
+    work_item_id: number;
+    from_actor: ActorRef;
+    to_actor: ActorRef;
+    session_id?: string | null;
+    summary: string;
+    context_bundle_ref?: string | null;
+    expires_at?: number | null;
+    visibility_class: MemoryVisibilityClass;
+    created_at?: number;
+}
+export interface HandoffQuery {
+    actor?: Pick<ActorRef, 'actor_kind' | 'actor_id'>;
+    direction?: 'inbound' | 'outbound' | 'all';
+    statuses?: HandoffStatus[];
+    sessionId?: string;
+    limit?: number;
+}
+export interface WorkItemPatch {
+    title?: string;
+    detail?: string | null;
+    status?: WorkItem['status'];
+    visibility_class?: MemoryVisibilityClass;
+}
+export interface CoordinationState {
+    ownedClaims: WorkClaim[];
+    pendingInboundHandoffs: HandoffRecord[];
+    pendingOutboundHandoffs: HandoffRecord[];
+    sharedWorkItems: WorkItem[];
+}
+//# sourceMappingURL=coordination.d.ts.map

package/dist/contracts/coordination.d.ts.map

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

package/dist/contracts/coordination.js

@@ -0,0 +1,26 @@
+export const ACTOR_KINDS = ['agent', 'human', 'system', 'service'];
+export const MEMORY_VISIBILITY_CLASSES = [
+    'private',
+    'shared_collaboration',
+    'workspace',
+    'tenant',
+];
+export const CONTEXT_VIEW_POLICIES = [
+    'local_only',
+    'local_plus_shared_collaboration',
+    'operator_supervisor',
+    'workspace_shared',
+];
+export const WORK_CLAIM_STATUSES = [
+    'active',
+    'released',
+    'expired',
+];
+export const HANDOFF_STATUSES = [
+    'pending',
+    'accepted',
+    'rejected',
+    'canceled',
+    'expired',
+];
+//# sourceMappingURL=coordination.js.map

package/dist/contracts/coordination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.js","sourceRoot":"","sources":["../../src/contracts/coordination.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AACzF,MAAM,CAAC,MAAM,yBAAyB,GAAqC;IACzE,SAAS;IACT,sBAAsB;IACtB,WAAW;IACX,QAAQ;CACT,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAiC;IACjE,YAAY;IACZ,iCAAiC;IACjC,qBAAqB;IACrB,kBAAkB;CACnB,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,QAAQ;IACR,UAAU;IACV,SAAS;CACV,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,SAAS;IACT,UAAU;IACV,UAAU;IACV,UAAU;IACV,SAAS;CACV,CAAC"}

package/dist/contracts/embedding.d.ts

@@ -17,6 +17,6 @@ export interface EmbeddingAdapter {
         limit?: number;
         minSimilarity?: number;
     }): MaybePromise<SimilarEmbeddingResult[]>;
-    deleteEmbedding(knowledgeMemoryId: number): MaybePromise<void>;
+    deleteEmbedding(knowledgeMemoryId: number, scope?: MemoryScope): MaybePromise<void>;
 }
 //# sourceMappingURL=embedding.d.ts.map

package/dist/contracts/embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/contracts/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAC3C,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AACjF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACvF,YAAY,CAAC,iBAAiB,EAAE,MAAM,GAAG,YAAY,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC9E,WAAW,CACT,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,eAAe,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC1C,qBAAqB,CACnB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,eAAe,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC1C,eAAe,CAAC,iBAAiB,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CAChE"}
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/contracts/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAC3C,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AACjF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACvF,YAAY,CAAC,iBAAiB,EAAE,MAAM,GAAG,YAAY,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC9E,WAAW,CACT,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,eAAe,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC1C,qBAAqB,CACnB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,eAAe,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC1C,eAAe,CAAC,iBAAiB,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CACrF"}

package/dist/contracts/errors.d.ts

@@ -0,0 +1,28 @@
+export type MemoryErrorCode = 'validation_error' | 'resource_not_found' | 'scope_mismatch' | 'conflict' | 'provider_unavailable';
+export interface MemoryErrorOptions {
+    cause?: unknown;
+    details?: Record<string, unknown>;
+}
+export declare class MemoryDomainError extends Error {
+    readonly code: MemoryErrorCode;
+    readonly status: number;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code: MemoryErrorCode, status: number, options?: MemoryErrorOptions);
+}
+export declare class ValidationError extends MemoryDomainError {
+    constructor(message: string, options?: MemoryErrorOptions);
+}
+export declare class ResourceNotFoundError extends MemoryDomainError {
+    constructor(message: string, options?: MemoryErrorOptions);
+}
+export declare class ScopeMismatchError extends MemoryDomainError {
+    constructor(message: string, options?: MemoryErrorOptions);
+}
+export declare class ConflictError extends MemoryDomainError {
+    constructor(message: string, options?: MemoryErrorOptions);
+}
+export declare class ProviderUnavailableError extends MemoryDomainError {
+    constructor(message: string, options?: MemoryErrorOptions);
+}
+export declare function isMemoryDomainError(error: unknown): error is MemoryDomainError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/contracts/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/contracts/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAChB,UAAU,GACV,sBAAsB,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB;CAQnC;AAED,qBAAa,eAAgB,SAAQ,iBAAiB;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAG9D;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;gBAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAG9D;AAED,qBAAa,kBAAmB,SAAQ,iBAAiB;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAG9D;AAED,qBAAa,aAAc,SAAQ,iBAAiB;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAG9D;AAED,qBAAa,wBAAyB,SAAQ,iBAAiB;gBACjD,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAG9D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E"}

package/dist/contracts/errors.js

@@ -0,0 +1,41 @@
+export class MemoryDomainError extends Error {
+    code;
+    status;
+    details;
+    constructor(message, code, status, options = {}) {
+        super(message, options.cause ? { cause: options.cause } : undefined);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.status = status;
+        this.details = options.details;
+    }
+}
+export class ValidationError extends MemoryDomainError {
+    constructor(message, options = {}) {
+        super(message, 'validation_error', 400, options);
+    }
+}
+export class ResourceNotFoundError extends MemoryDomainError {
+    constructor(message, options = {}) {
+        super(message, 'resource_not_found', 404, options);
+    }
+}
+export class ScopeMismatchError extends MemoryDomainError {
+    constructor(message, options = {}) {
+        super(message, 'scope_mismatch', 404, options);
+    }
+}
+export class ConflictError extends MemoryDomainError {
+    constructor(message, options = {}) {
+        super(message, 'conflict', 409, options);
+    }
+}
+export class ProviderUnavailableError extends MemoryDomainError {
+    constructor(message, options = {}) {
+        super(message, 'provider_unavailable', 503, options);
+    }
+}
+export function isMemoryDomainError(error) {
+    return error instanceof MemoryDomainError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/contracts/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/contracts/errors.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAkB;IACtB,MAAM,CAAS;IACf,OAAO,CAA2B;IAE3C,YACE,OAAe,EACf,IAAqB,EACrB,MAAc,EACd,UAA8B,EAAE;QAEhC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,iBAAiB;IACpD,YAAY,OAAe,EAAE,UAA8B,EAAE;QAC3D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAC1D,YAAY,OAAe,EAAE,UAA8B,EAAE;QAC3D,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD,YAAY,OAAe,EAAE,UAA8B,EAAE;QAC3D,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAClD,YAAY,OAAe,EAAE,UAA8B,EAAE;QAC3D,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAC7D,YAAY,OAAe,EAAE,UAA8B,EAAE;QAC3D,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC5C,CAAC"}

package/dist/contracts/identity.d.ts

@@ -25,5 +25,7 @@ export interface ScopeQuery {
 }
 export declare function normalizeScope(scope: MemoryScope): NormalizedMemoryScope;
 export declare function scopeValues(scope: MemoryScope): [string, string, string, string, string];
+export declare function matchesScope(leftScope: MemoryScope, rightScope: MemoryScope): boolean;
+export declare function matchesScopeLevel(itemScope: MemoryScope, targetScope: MemoryScope, level: ScopeLevel): boolean;
 export declare function widenScope(scope: MemoryScope, level: ScopeLevel): ScopeQuery;
 //# sourceMappingURL=identity.d.ts.map

package/dist/contracts/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/contracts/identity.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;CACnB;AASD,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CASxE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CASxF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAK5E"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/contracts/identity.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;CACnB;AASD,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CASxE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CASxF;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,GAAG,OAAO,CAUrF;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EACtB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,UAAU,GAChB,OAAO,CAST;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAK5E"}

package/dist/contracts/identity.js

@@ -1,7 +1,8 @@
+import { ValidationError } from './errors.js';
 export const DEFAULT_WORKSPACE_ID = 'default';
 function assertScopeValue(value, name) {
     if (!value || value.trim().length === 0) {
-        throw new Error(`Memory validation: '${name}' must not be empty`);
+        throw new ValidationError(`Memory validation: '${name}' must not be empty`);
     }
     return value.trim();
 }
@@ -25,6 +26,30 @@ export function scopeValues(scope) {
         normalized.scope_id,
     ];
 }
+export function matchesScope(leftScope, rightScope) {
+    const left = normalizeScope(leftScope);
+    const right = normalizeScope(rightScope);
+    return (left.tenant_id === right.tenant_id &&
+        left.system_id === right.system_id &&
+        left.workspace_id === right.workspace_id &&
+        left.collaboration_id === right.collaboration_id &&
+        left.scope_id === right.scope_id);
+}
+export function matchesScopeLevel(itemScope, targetScope, level) {
+    const item = normalizeScope(itemScope);
+    const target = normalizeScope(targetScope);
+    if (item.tenant_id !== target.tenant_id)
+        return false;
+    if (level === 'tenant')
+        return true;
+    if (level === 'workspace')
+        return item.workspace_id === target.workspace_id;
+    if (item.system_id !== target.system_id)
+        return false;
+    if (level === 'system')
+        return true;
+    return matchesScope(item, target);
+}
 export function widenScope(scope, level) {
     return {
         scope: normalizeScope(scope),

package/dist/contracts/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/contracts/identity.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AA6B9C,SAAS,gBAAgB,CAAC,KAAyB,EAAE,IAAuB;IAC1E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,qBAAqB,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,oBAAoB,CAAC;IACvE,OAAO;QACL,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;QACzD,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;QACzD,YAAY,EAAE,WAAW;QACzB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE;QACtD,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO;QACL,UAAU,CAAC,SAAS;QACpB,UAAU,CAAC,SAAS;QACpB,UAAU,CAAC,YAAY;QACvB,UAAU,CAAC,gBAAgB;QAC3B,UAAU,CAAC,QAAQ;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAkB,EAAE,KAAiB;IAC9D,OAAO;QACL,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;QAC5B,KAAK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/contracts/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AA6B9C,SAAS,gBAAgB,CAAC,KAAyB,EAAE,IAAuB;IAC1E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,eAAe,CAAC,uBAAuB,IAAI,qBAAqB,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,oBAAoB,CAAC;IACvE,OAAO;QACL,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;QACzD,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;QACzD,YAAY,EAAE,WAAW;QACzB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE;QACtD,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO;QACL,UAAU,CAAC,SAAS;QACpB,UAAU,CAAC,SAAS;QACpB,UAAU,CAAC,YAAY;QACvB,UAAU,CAAC,gBAAgB;QAC3B,UAAU,CAAC,QAAQ;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAsB,EAAE,UAAuB;IAC1E,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACzC,OAAO,CACL,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAClC,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAClC,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY;QACxC,IAAI,CAAC,gBAAgB,KAAK,KAAK,CAAC,gBAAgB;QAChD,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAAsB,EACtB,WAAwB,EACxB,KAAiB;IAEjB,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY,CAAC;IAC5E,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAkB,EAAE,KAAiB;IAC9D,OAAO;QACL,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;QAC5B,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/contracts/observability.d.ts

@@ -6,7 +6,8 @@ export interface Logger {
     error(msg: string, meta?: Record<string, unknown>): void;
 }
 export declare const noopLogger: Logger;
-export type MemoryEventType = 'capability' | 'compaction' | 'promotion' | 'extraction' | 'knowledge_change' | 'search' | 'context_assembly' | 'semantic_search' | 'manager';
+export declare const MEMORY_EVENT_TYPES: readonly ["capability", "compaction", "promotion", "extraction", "knowledge_change", "search", "context_assembly", "semantic_search", "manager"];
+export type MemoryEventType = (typeof MEMORY_EVENT_TYPES)[number];
 export interface MemoryEvent {
     type: MemoryEventType;
     scope: NormalizedMemoryScope;

package/dist/contracts/observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/contracts/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,QAAQ,GACR,kBAAkB,GAClB,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC"}
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/contracts/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAC;AAEF,eAAO,MAAM,kBAAkB,kJAUrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC"}

package/dist/contracts/observability.js

@@ -4,4 +4,15 @@ export const noopLogger = {
     warn() { },
     error() { },
 };
+export const MEMORY_EVENT_TYPES = [
+    'capability',
+    'compaction',
+    'promotion',
+    'extraction',
+    'knowledge_change',
+    'search',
+    'context_assembly',
+    'semantic_search',
+    'manager',
+];
 //# sourceMappingURL=observability.js.map

package/dist/contracts/observability.js.map

@@ -1 +1 @@
-{"version":3,"file":"observability.js","sourceRoot":"","sources":["../../src/contracts/observability.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;CACX,CAAC"}
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../../src/contracts/observability.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,kBAAkB;IAClB,QAAQ;IACR,kBAAkB;IAClB,iBAAiB;IACjB,SAAS;CACD,CAAC"}

package/dist/contracts/profile.d.ts

@@ -0,0 +1,29 @@
+import type { FactConfidence, KnowledgeState } from './types.js';
+export type ProfileView = 'user' | 'operator' | 'workspace';
+export type ProfileSection = 'identity' | 'preferences' | 'communication' | 'constraints' | 'workflows';
+export interface ProfileEntry {
+    knowledgeId: number;
+    fact: string;
+    trustScore: number;
+    knowledgeState: KnowledgeState;
+    confidence: FactConfidence;
+    lastConfirmedAt: number | null;
+}
+export interface Profile {
+    view: ProfileView;
+    sections: Record<ProfileSection, ProfileEntry[]>;
+    generatedAt: number;
+}
+export interface ProfileOptions {
+    view?: ProfileView;
+    minimumTrustScore?: number;
+    /**
+     * When true, include provisional-state knowledge in the profile.
+     * Default: false — profiles only surface trusted knowledge so agents
+     * cannot over-trust low-confidence entries and personalize incorrectly.
+     */
+    includeProvisional?: boolean;
+    includeDisputed?: boolean;
+    sections?: ProfileSection[];
+}
+//# sourceMappingURL=profile.d.ts.map

package/dist/contracts/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/contracts/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAE5D,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,aAAa,GACb,eAAe,GACf,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,cAAc,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B"}

package/dist/contracts/profile.js

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

package/dist/contracts/profile.js.map

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

package/dist/contracts/session-state.d.ts

@@ -0,0 +1,10 @@
+export interface SessionState {
+    currentObjective: string | null;
+    blockers: string[];
+    assumptions: string[];
+    pendingDecisions: string[];
+    activeTools: string[];
+    recentOutputs: string[];
+    updatedAt: number;
+}
+//# sourceMappingURL=session-state.d.ts.map

package/dist/contracts/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/contracts/session-state.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/contracts/session-state.js

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

package/dist/contracts/session-state.js.map

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

package/dist/contracts/storage.d.ts

@@ -1,5 +1,19 @@
 import type { MemoryScope, ScopeLevel } from './identity.js';
-import type { CompactionLog, ContextMonitor, ContextMonitorUpsert, KnowledgeCandidate, KnowledgeEvidence, KnowledgeMemory, KnowledgeMemoryAudit, NewCompactionLog, NewKnowledgeCandidate, NewKnowledgeEvidence, NewKnowledgeMemory, NewKnowledgeMemoryAudit, NewWorkItem, NewTurn, NewWorkingMemory, PaginationOptions, PaginatedResult, SearchOptions, SearchResult, TimeRange, Turn, WorkItem, WorkingMemory } from './types.js';
+import type { ActorRef, HandoffQuery, HandoffRecord, NewHandoffInput, NewWorkClaimInput, WorkClaim, WorkClaimQuery, WorkItemPatch } from './coordination.js';
+import type { MemoryEventEntityKind, MemoryEventQuery, MemoryEventRecord, NewMemoryEventRecord, NewSessionStateProjection, NewTemporalProjectionWatermark, SessionStateProjection, TemporalProjectionWatermark, TimelineResult } from './temporal.js';
+/**
+ * Thrown by storage adapters when an insert violates a unique constraint.
+ *
+ * Callers that expect duplicate-key collisions (e.g. autoDetectAssociations
+ * attempting to insert an already-present edge) should catch this exact
+ * class rather than sniffing error codes or messages across adapters.
+ */
+export declare class UniqueConstraintError extends Error {
+    readonly cause?: unknown | undefined;
+    readonly kind: "UniqueConstraintError";
+    constructor(message: string, cause?: unknown | undefined);
+}
+import type { Association, AssociationTargetKind, CompactionLog, ContextMonitor, ContextMonitorUpsert, KnowledgeCandidate, KnowledgeEvidence, KnowledgeMemory, KnowledgeMemoryAudit, NewAssociation, NewCompactionLog, NewKnowledgeCandidate, NewKnowledgeEvidence, NewKnowledgeMemory, NewKnowledgeMemoryAudit, NewPlaybook, NewPlaybookRevision, NewWorkItem, NewTurn, NewWorkingMemory, PaginationOptions, PaginatedResult, Playbook, PlaybookRevision, SearchOptions, SearchResult, TimeRange, Turn, WorkItem, WorkingMemory } from './types.js';
 export interface StorageAdapter {
     insertTurn(input: NewTurn): Turn;
     insertTurns(inputs: NewTurn[]): Turn[];
@@ -12,6 +26,7 @@ export interface StorageAdapter {
     getArchivedTurnRange(sessionId: string, startId: number, endId: number, scope: MemoryScope): Turn[];
     insertWorkingMemory(input: NewWorkingMemory): WorkingMemory;
     getWorkingMemoryById(id: number): WorkingMemory | null;
+    getExistingWorkingMemoryIds?(ids: number[]): number[];
     getWorkingMemoryBySession(sessionId: string, scope: MemoryScope): WorkingMemory[];
     getActiveWorkingMemory(scope: MemoryScope, sessionId?: string): WorkingMemory[];
     getLatestWorkingMemory(scope: MemoryScope, sessionId?: string): WorkingMemory | null;
@@ -32,6 +47,7 @@ export interface StorageAdapter {
     listKnowledgeEvidenceForCandidate(candidateId: number): KnowledgeEvidence[];
     promoteKnowledgeCandidate(candidateId: number, input: NewKnowledgeMemory): KnowledgeMemory;
     getKnowledgeMemoryById(id: number): KnowledgeMemory | null;
+    getExistingKnowledgeMemoryIds?(ids: number[]): number[];
     getActiveKnowledgeMemory(scope: MemoryScope): KnowledgeMemory[];
     getActiveKnowledgeMemoryPaginated(scope: MemoryScope, options?: PaginationOptions): PaginatedResult<KnowledgeMemory>;
     getActiveKnowledgeCrossScope(scope: MemoryScope, level: ScopeLevel): KnowledgeMemory[];
@@ -60,18 +76,74 @@ export interface StorageAdapter {
         failed_use_count?: number;
     }): KnowledgeMemory | null;
     touchKnowledgeMemory(id: number): void;
+    touchKnowledgeMemories(ids: number[]): void;
     retireKnowledgeMemory(id: number, retiredAt?: number): void;
     supersedeKnowledgeMemory(oldId: number, newId: number): void;
     insertWorkItem(input: NewWorkItem): WorkItem;
+    getWorkItemById(id: number): WorkItem | null;
+    getExistingWorkItemIds?(ids: number[]): number[];
     getActiveWorkItems(scope: MemoryScope): WorkItem[];
+    getActiveWorkItemsCrossScope(scope: MemoryScope, level: ScopeLevel): WorkItem[];
     getWorkItemsByTimeRange(scope: MemoryScope, range: TimeRange): WorkItem[];
+    getWorkItemsByTimeRangeCrossScope(scope: MemoryScope, level: ScopeLevel, range: TimeRange): WorkItem[];
     updateWorkItemStatus(id: number, status: WorkItem['status']): void;
+    updateWorkItem(id: number, patch: WorkItemPatch, options?: {
+        expectedVersion?: number;
+    }): WorkItem | null;
     deleteWorkItem(id: number): void;
+    claimWorkItem(input: NewWorkClaimInput): WorkClaim;
+    renewWorkClaim(claimId: number, actor: ActorRef, leaseSeconds?: number): WorkClaim | null;
+    releaseWorkClaim(claimId: number, actor: ActorRef, reason?: string): WorkClaim | null;
+    getActiveWorkClaim(workItemId: number): WorkClaim | null;
+    listWorkClaims(scope: MemoryScope, options?: WorkClaimQuery): WorkClaim[];
+    listWorkClaimsCrossScope(scope: MemoryScope, level: ScopeLevel, options?: WorkClaimQuery): WorkClaim[];
+    createHandoff(input: NewHandoffInput): HandoffRecord;
+    acceptHandoff(handoffId: number, actor: ActorRef, reason?: string): HandoffRecord | null;
+    rejectHandoff(handoffId: number, actor: ActorRef, reason?: string): HandoffRecord | null;
+    cancelHandoff(handoffId: number, actor: ActorRef, reason?: string): HandoffRecord | null;
+    listHandoffs(scope: MemoryScope, options?: HandoffQuery): HandoffRecord[];
+    listHandoffsCrossScope(scope: MemoryScope, level: ScopeLevel, options?: HandoffQuery): HandoffRecord[];
     upsertContextMonitor(input: ContextMonitorUpsert): ContextMonitor;
     getContextMonitor(scope: MemoryScope): ContextMonitor | null;
     insertCompactionLog(input: NewCompactionLog): CompactionLog;
     getCompactionLogById(id: number): CompactionLog | null;
     getRecentCompactionLogs(scope: MemoryScope, limit?: number): CompactionLog[];
+    insertPlaybook(input: NewPlaybook): Playbook;
+    getPlaybookById(id: number): Playbook | null;
+    getExistingPlaybookIds?(ids: number[]): number[];
+    getActivePlaybooks(scope: MemoryScope): Playbook[];
+    getActivePlaybooksCrossScope(scope: MemoryScope, level: ScopeLevel): Playbook[];
+    searchPlaybooks(scope: MemoryScope, query: string, options?: SearchOptions): SearchResult<Playbook>[];
+    searchPlaybooksCrossScope(scope: MemoryScope, level: ScopeLevel, query: string, options?: SearchOptions): SearchResult<Playbook>[];
+    updatePlaybook(id: number, patch: {
+        title?: string;
+        description?: string;
+        instructions?: string;
+        references?: string[];
+        templates?: string[];
+        scripts?: string[];
+        assets?: string[];
+        tags?: string[];
+        status?: Playbook['status'];
+    }): Playbook | null;
+    recordPlaybookUse(id: number): void;
+    insertPlaybookRevision(input: NewPlaybookRevision): PlaybookRevision;
+    getPlaybookRevisions(playbookId: number): PlaybookRevision[];
+    insertAssociation(input: NewAssociation): Association;
+    getAssociationById(id: number): Association | null;
+    getAssociationsFrom(kind: AssociationTargetKind, id: number, scope: MemoryScope): Association[];
+    getAssociationsTo(kind: AssociationTargetKind, id: number, scope: MemoryScope): Association[];
+    listAssociations(scope: MemoryScope): Association[];
+    deleteAssociation(id: number): void;
+    insertMemoryEvent(input: NewMemoryEventRecord): MemoryEventRecord;
+    listMemoryEvents(scope: MemoryScope, query?: MemoryEventQuery): TimelineResult;
+    listMemoryEventsCrossScope(scope: MemoryScope, level: ScopeLevel, query?: MemoryEventQuery): TimelineResult;
+    getMemoryEventsByEntity(scope: MemoryScope, entityKind: MemoryEventEntityKind, entityId: string, query?: Omit<MemoryEventQuery, 'entityKind' | 'entityId'>): TimelineResult;
+    getMemoryEventsBySession(scope: MemoryScope, sessionId: string, query?: Omit<MemoryEventQuery, 'sessionId'>): TimelineResult;
+    getSessionState(scope: MemoryScope, sessionId: string): SessionStateProjection | null;
+    upsertSessionState(input: NewSessionStateProjection): SessionStateProjection;
+    getTemporalWatermark(projectionName?: string): TemporalProjectionWatermark | null;
+    upsertTemporalWatermark(input: NewTemporalProjectionWatermark): TemporalProjectionWatermark;
     transaction<T>(fn: () => T): T;
     close(): void;
 }