@agenticprimitives/fabric 0.0.0-alpha.1

package/dist/messaging/envelope.d.ts

@@ -0,0 +1,14 @@
+import type { ConversationId, MessageEnvelopeV1, MessageId, ThreadId } from './types.js';
+export declare function generateMessageId(): MessageId;
+export declare function generateConversationId(): ConversationId;
+export declare function generateThreadId(): ThreadId;
+export type EnvelopeValidationError = 'bad_version' | 'bad_id' | 'bad_conversation_id' | 'missing_from' | 'empty_recipients' | 'bad_created_at' | 'bad_expires_at' | 'expired_before_created' | 'bad_body_hash' | 'missing_body_content_type' | 'bad_attachment_hash' | 'too_many_context_refs' | 'bad_context_ref';
+/** Envelope context refs are bounded so refs stay metadata, not payload. */
+export declare const MAX_CONTEXT_REFS = 8;
+/**
+ * Structural validation only — signature verification, sender authority, and
+ * recipient admission policy are the recipient runtime's job (spec 309 §4.4).
+ * Returns an empty array iff the envelope is structurally admissible.
+ */
+export declare function validateMessageEnvelope(env: MessageEnvelopeV1): EnvelopeValidationError[];
+//# sourceMappingURL=envelope.d.ts.map

package/dist/messaging/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/messaging/envelope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAUzF,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C;AAED,wBAAgB,sBAAsB,IAAI,cAAc,CAEvD;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,MAAM,MAAM,uBAAuB,GAC/B,aAAa,GACb,QAAQ,GACR,qBAAqB,GACrB,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,wBAAwB,GACxB,eAAe,GACf,2BAA2B,GAC3B,qBAAqB,GACrB,uBAAuB,GACvB,iBAAiB,CAAC;AAEtB,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAQlC;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,uBAAuB,EAAE,CA+BzF"}

package/dist/messaging/envelope.js

@@ -0,0 +1,71 @@
+// Envelope construction + structural validation (fail-closed, spec 309 §8).
+function randomSuffix() {
+    const bytes = new Uint8Array(16);
+    globalThis.crypto.getRandomValues(bytes);
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+export function generateMessageId() {
+    return `msg_${randomSuffix()}`;
+}
+export function generateConversationId() {
+    return `conv_${randomSuffix()}`;
+}
+export function generateThreadId() {
+    return `thr_${randomSuffix()}`;
+}
+/** Envelope context refs are bounded so refs stay metadata, not payload. */
+export const MAX_CONTEXT_REFS = 8;
+const HEX32_RE = /^0x[0-9a-f]{64}$/;
+function isIsoDate(s) {
+    return !Number.isNaN(Date.parse(s));
+}
+/**
+ * Structural validation only — signature verification, sender authority, and
+ * recipient admission policy are the recipient runtime's job (spec 309 §4.4).
+ * Returns an empty array iff the envelope is structurally admissible.
+ */
+export function validateMessageEnvelope(env) {
+    const errors = [];
+    if (env.version !== 'ap.message.v1')
+        errors.push('bad_version');
+    if (!env.id?.startsWith('msg_'))
+        errors.push('bad_id');
+    if (!env.conversationId?.startsWith('conv_'))
+        errors.push('bad_conversation_id');
+    if (!env.from)
+        errors.push('missing_from');
+    if (!Array.isArray(env.to) || env.to.length === 0)
+        errors.push('empty_recipients');
+    if (!env.createdAt || !isIsoDate(env.createdAt))
+        errors.push('bad_created_at');
+    if (env.expiresAt !== undefined) {
+        if (!isIsoDate(env.expiresAt))
+            errors.push('bad_expires_at');
+        else if (isIsoDate(env.createdAt) && Date.parse(env.expiresAt) <= Date.parse(env.createdAt))
+            errors.push('expired_before_created');
+    }
+    if (!HEX32_RE.test(env.bodyHash ?? ''))
+        errors.push('bad_body_hash');
+    if (!env.bodyContentType)
+        errors.push('missing_body_content_type');
+    for (const att of env.attachments ?? []) {
+        if (!HEX32_RE.test(att.hash ?? '')) {
+            errors.push('bad_attachment_hash');
+            break;
+        }
+    }
+    if (env.contextRefs !== undefined) {
+        if (env.contextRefs.length > MAX_CONTEXT_REFS)
+            errors.push('too_many_context_refs');
+        for (const ref of env.contextRefs) {
+            if (!ref.kind?.trim() || !ref.id?.trim() || (ref.hash !== undefined && !HEX32_RE.test(ref.hash))) {
+                errors.push('bad_context_ref');
+                break;
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=envelope.js.map

package/dist/messaging/envelope.js.map

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

package/dist/messaging/hash.d.ts

@@ -0,0 +1,19 @@
+import type { Hex32, MessageEnvelopeV1 } from './types.js';
+import { canonicalizeJson } from '@agenticprimitives/types';
+/** Deterministic JSON: sorted keys, `undefined` members dropped. Hoisted to `@agenticprimitives/types` as
+ *  `canonicalizeJson` (spec 316 Open Decision F); kept here as an alias for back-compat. */
+export declare const canonicalizeMessage: typeof canonicalizeJson;
+export declare function sha256Hex32(input: string | Uint8Array): Promise<Hex32>;
+/**
+ * Hash of the canonical envelope EXCLUDING `signature` — this is the payload a
+ * sender signs and a recipient verifies (spec 309 §8.1). Deterministic across
+ * key order and undefined optional fields.
+ */
+export declare function hashMessageEnvelope(envelope: MessageEnvelopeV1): Promise<Hex32>;
+/**
+ * Body-hash binding (spec 309 §8.4): the envelope's `bodyHash` MUST equal the
+ * digest of the vault-resident body bytes. Recipients enforce this BEFORE
+ * admitting a message; a mismatch is a delivery failure, not a warning.
+ */
+export declare function verifyBodyHash(envelope: Pick<MessageEnvelopeV1, 'bodyHash'>, bodyBytes: Uint8Array): Promise<boolean>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/messaging/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/messaging/hash.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D;4FAC4F;AAC5F,eAAO,MAAM,mBAAmB,yBAAmB,CAAC;AAEpD,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAO5E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,CAGrF;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,EAC7C,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/dist/messaging/hash.js

@@ -0,0 +1,36 @@
+// Canonical hashing for message envelopes + vault-resident bodies.
+//
+// Same deterministic-JSON convention as verification-receipts / key-authorization
+// (sorted keys, undefined dropped) so cross-package tooling produces identical
+// digests. Web Crypto only — runs in Node, Workers, and browsers.
+import { canonicalizeJson } from '@agenticprimitives/types';
+const enc = new TextEncoder();
+/** Deterministic JSON: sorted keys, `undefined` members dropped. Hoisted to `@agenticprimitives/types` as
+ *  `canonicalizeJson` (spec 316 Open Decision F); kept here as an alias for back-compat. */
+export const canonicalizeMessage = canonicalizeJson;
+export async function sha256Hex32(input) {
+    const bytes = typeof input === 'string' ? enc.encode(input) : input;
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', bytes);
+    const hex = Array.from(new Uint8Array(digest))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+    return `0x${hex}`;
+}
+/**
+ * Hash of the canonical envelope EXCLUDING `signature` — this is the payload a
+ * sender signs and a recipient verifies (spec 309 §8.1). Deterministic across
+ * key order and undefined optional fields.
+ */
+export async function hashMessageEnvelope(envelope) {
+    const { signature: _signature, ...unsigned } = envelope;
+    return sha256Hex32(canonicalizeMessage(unsigned));
+}
+/**
+ * Body-hash binding (spec 309 §8.4): the envelope's `bodyHash` MUST equal the
+ * digest of the vault-resident body bytes. Recipients enforce this BEFORE
+ * admitting a message; a mismatch is a delivery failure, not a warning.
+ */
+export async function verifyBodyHash(envelope, bodyBytes) {
+    return (await sha256Hex32(bodyBytes)) === envelope.bodyHash;
+}
+//# sourceMappingURL=hash.js.map

package/dist/messaging/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/messaging/hash.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAC/E,kEAAkE;AAGlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;AAE9B;4FAC4F;AAC5F,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAA0B;IAC1D,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAA+B,CAAC,CAAC;IACjG,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,KAAK,GAAG,EAAW,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAA2B;IACnE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC;IACxD,OAAO,WAAW,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAA6C,EAC7C,SAAqB;IAErB,OAAO,CAAC,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC;AAC9D,CAAC"}

package/dist/messaging/index.d.ts

@@ -0,0 +1,16 @@
+export declare const PACKAGE_NAME = "@agenticprimitives/fabric/messaging";
+export declare const PACKAGE_STATUS: "w5-context";
+export declare const SPEC_REF = "specs/309-messaging-and-interactions.md";
+export { type Hex32, type MessageId, type ConversationId, type ThreadId, type FolderKind, type MessagePriority, type MessageKind, type ContextRefV1, type SignatureProof, type MessageAttachmentRef, type RetentionPolicyRef, type MessageEnvelopeV1, type MessageEventType, type MessageEventV1, type InboxItemV1, type ConversationDescriptorV1, type ConversationProfile, type DiscussionTopicV1, type MessageThreadV1, } from './types.js';
+export { canonicalizeMessage, sha256Hex32, hashMessageEnvelope, verifyBodyHash, } from './hash.js';
+export { generateMessageId, generateConversationId, generateThreadId, type EnvelopeValidationError, validateMessageEnvelope, MAX_CONTEXT_REFS, } from './envelope.js';
+export { type ConversationValidationError, validateConversationDescriptor, type ConversationSummaryV1, summarizeConversations, } from './conversation.js';
+export { applyMessageEvent, type MessageStore, createInMemoryMessageStore, } from './store.js';
+export { type InboxRulePredicateV1, type InboxRuleActionV1, type InboxRuleV1, type NotificationEventV1, type NotificationSink, matchesRulePredicate, matchesContextRef, type RuleApplication, applyInboxRules, } from './rules.js';
+export { type FolderSummaryV1, summarizeFolders, type InboxDeltaCursorV1, type InboxDeltaV1, type DeltaCursorStore, type MessageDeliveryPort, type InboxProjector, type CreateInboxProjectorOpts, createInMemoryInboxProjector, } from './projector.js';
+export { buildDeliveryReceipt, buildReadReceipt } from './receipts.js';
+export { MESSAGE_BODY_RECORD_TYPE, MESSAGE_ATTACHMENT_RECORD_TYPE, messageBodyResource, topicBodyResource, messageAttachmentResource, type PutBodyResult, type MessageBodyStore, createVaultMessageBodyStore, } from './vault-store.js';
+export { type AuditedInboxDelivery, createAuditedInboxDelivery } from './delivery.js';
+export { BOARD_HISTORY_LIMIT, createBoardChannel, canSeeChannel, appendBoardPost, type BoardResult, type ChannelMessageEntryV1, type ChannelV1, } from './board.js';
+export { validateDirectoryListing, isListingCurrent, type DirectoryListingV1, type ListingValidationError, } from './directory.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,YAAY,wCAAwC,CAAC;AAClE,eAAO,MAAM,cAAc,EAAG,YAAqB,CAAC;AACpD,eAAO,MAAM,QAAQ,4CAA4C,CAAC;AAElE,OAAO,EACL,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,2BAA2B,EAChC,8BAA8B,EAC9B,KAAK,qBAAqB,EAC1B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,KAAK,YAAY,EACjB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,eAAe,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAItF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC"}

package/dist/messaging/index.js

@@ -0,0 +1,29 @@
+// @agenticprimitives/messaging — signed, vault-resident Smart Agent messaging
+// (spec 309). W2 slice: W1's envelope + hash binding + validation + reducer +
+// MessageStore, PLUS the deterministic inbox-rule DSL (projection-only actions),
+// the InboxProjector with folder counters + delta cursors, receipt builders, and
+// the transport/notification/cursor ports.
+//
+// Doctrine (spec 309 §4): a message is NEVER authority — it carries requests,
+// evidence, and credential REFERENCES; delegation / entitlements / VC packages
+// remain the authority layer. Bodies live in the vault; envelopes carry
+// hashes + VaultRefs only. Transport (A2A, direct endpoint, relay) is the
+// caller's choice — this package owns no I/O.
+export const PACKAGE_NAME = '@agenticprimitives/fabric/messaging';
+export const PACKAGE_STATUS = 'w5-context';
+export const SPEC_REF = 'specs/309-messaging-and-interactions.md';
+export { canonicalizeMessage, sha256Hex32, hashMessageEnvelope, verifyBodyHash, } from './hash.js';
+export { generateMessageId, generateConversationId, generateThreadId, validateMessageEnvelope, MAX_CONTEXT_REFS, } from './envelope.js';
+export { validateConversationDescriptor, summarizeConversations, } from './conversation.js';
+export { applyMessageEvent, createInMemoryMessageStore, } from './store.js';
+export { matchesRulePredicate, matchesContextRef, applyInboxRules, } from './rules.js';
+export { summarizeFolders, createInMemoryInboxProjector, } from './projector.js';
+export { buildDeliveryReceipt, buildReadReceipt } from './receipts.js';
+export { MESSAGE_BODY_RECORD_TYPE, MESSAGE_ATTACHMENT_RECORD_TYPE, messageBodyResource, topicBodyResource, messageAttachmentResource, createVaultMessageBodyStore, } from './vault-store.js';
+export { createAuditedInboxDelivery } from './delivery.js';
+// Community channel board (spec 322 W1) — shape + validated pure mutations; gating/audit/residency
+// stay with the execution point.
+export { BOARD_HISTORY_LIMIT, createBoardChannel, canSeeChannel, appendBoardPost, } from './board.js';
+// Directory listing (spec 322 W1; moved from @agenticprimitives/home — a listing is substrate).
+export { validateDirectoryListing, isListingCurrent, } from './directory.js';
+//# sourceMappingURL=index.js.map

package/dist/messaging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,iFAAiF;AACjF,iFAAiF;AACjF,2CAA2C;AAC3C,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,wEAAwE;AACxE,0EAA0E;AAC1E,8CAA8C;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAG,qCAAqC,CAAC;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,YAAqB,CAAC;AACpD,MAAM,CAAC,MAAM,QAAQ,GAAG,yCAAyC,CAAC;AAwBlE,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,cAAc,GACf,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAEhB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,8BAA8B,EAE9B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EAEjB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAML,oBAAoB,EACpB,iBAAiB,EAEjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,gBAAgB,EAOhB,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EAGzB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAA6B,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAEtF,mGAAmG;AACnG,iCAAiC;AACjC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,GAIhB,MAAM,YAAY,CAAC;AAEpB,gGAAgG;AAChG,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GAGjB,MAAM,gBAAgB,CAAC"}

package/dist/messaging/projector.d.ts

@@ -0,0 +1,58 @@
+import type { FolderKind, InboxItemV1, MessageEnvelopeV1, MessageEventV1, MessageId } from './types.js';
+import { type MessageStore } from './store.js';
+import { type InboxRuleV1, type RuleApplication } from './rules.js';
+export interface FolderSummaryV1 {
+    folder: FolderKind;
+    total: number;
+    unread: number;
+}
+export declare function summarizeFolders(items: InboxItemV1[]): FolderSummaryV1[];
+/** Opaque sync position for one projection stream (AT-proto-style logical clock). */
+export interface InboxDeltaCursorV1 {
+    version: 'ap.inbox.cursor.v1';
+    streamId: string;
+    revision: number;
+}
+export interface InboxDeltaV1 {
+    cursor: InboxDeltaCursorV1;
+    /** Items whose projection changed after the given cursor (upserts). */
+    changed: InboxItemV1[];
+    /** Messages tombstoned after the given cursor — consumers purge local copies. */
+    removed: MessageId[];
+}
+/** Port for persisting a consumer's cursor — adapters live in apps/runtimes. */
+export interface DeltaCursorStore {
+    get(streamId: string): InboxDeltaCursorV1 | null | Promise<InboxDeltaCursorV1 | null>;
+    put(cursor: InboxDeltaCursorV1): void | Promise<void>;
+}
+/** Port a transport adapter (A2A, direct endpoint, relay) implements to move
+ *  envelopes. Resolves to the delivery event the recipient runtime emitted. */
+export interface MessageDeliveryPort {
+    deliver(envelope: MessageEnvelopeV1): Promise<MessageEventV1>;
+}
+export interface InboxProjector {
+    putMessage(envelope: MessageEnvelopeV1): void;
+    /** Reducer + rules. Rules run only on first admission (admitted/delivered),
+     *  mirroring Outlook: user actions afterwards are not re-filed. */
+    appendEvent(event: MessageEventV1): RuleApplication;
+    getInboxItem(id: MessageId): InboxItemV1 | null;
+    listInbox(folder?: FolderKind): InboxItemV1[];
+    /** THE related-messages read path (spec 312 §8.2): items about a context.
+     *  `id` omitted ⇒ every item carrying any ref of that kind. */
+    listByContext(ref: {
+        kind: string;
+        id?: string;
+    }): InboxItemV1[];
+    unreadCount(folder?: FolderKind): number;
+    summarize(): FolderSummaryV1[];
+    revision(): number;
+    /** Pass `null` for initial sync. Fail-closed: a cursor from another stream throws. */
+    deltaSince(cursor: InboxDeltaCursorV1 | null): InboxDeltaV1;
+}
+export interface CreateInboxProjectorOpts {
+    streamId: string;
+    rules?: InboxRuleV1[];
+    store?: MessageStore;
+}
+export declare function createInMemoryInboxProjector(opts: CreateInboxProjectorOpts): InboxProjector;
+//# sourceMappingURL=projector.d.ts.map

package/dist/messaging/projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projector.d.ts","sourceRoot":"","sources":["../../src/messaging/projector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAsC,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAExG,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CASxE;AAED,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,uEAAuE;IACvE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,iFAAiF;IACjF,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACtF,GAAG,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;+EAC+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9C;uEACmE;IACnE,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAAC;IACpD,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,WAAW,GAAG,IAAI,CAAC;IAChD,SAAS,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,EAAE,CAAC;IAC9C;mEAC+D;IAC/D,aAAa,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,EAAE,CAAC;IACjE,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACzC,SAAS,IAAI,eAAe,EAAE,CAAC;IAC/B,QAAQ,IAAI,MAAM,CAAC;IACnB,sFAAsF;IACtF,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,YAAY,CAAC;CAC7D;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,wBAAwB,GAAG,cAAc,CA4F3F"}

package/dist/messaging/projector.js

@@ -0,0 +1,103 @@
+// Inbox projector (spec 309 §5): the deterministic pipeline
+// envelope + events → reducer → rules → InboxItemV1, plus folder counters and
+// delta cursors so apps can do Outlook/Graph-style initial + incremental sync.
+import { createInMemoryMessageStore } from './store.js';
+import { applyInboxRules, matchesContextRef } from './rules.js';
+export function summarizeFolders(items) {
+    const byFolder = new Map();
+    for (const item of items) {
+        const s = byFolder.get(item.folder) ?? { folder: item.folder, total: 0, unread: 0 };
+        s.total += 1;
+        if (item.unread)
+            s.unread += 1;
+        byFolder.set(item.folder, s);
+    }
+    return [...byFolder.values()].sort((a, b) => a.folder.localeCompare(b.folder));
+}
+export function createInMemoryInboxProjector(opts) {
+    const store = opts.store ?? createInMemoryMessageStore();
+    const rules = opts.rules ?? [];
+    let revision = 0;
+    const itemRevisions = new Map();
+    const removedAt = new Map();
+    // Rule outcomes overlay the store's reducer output (labels/categories/moves).
+    const overlay = new Map();
+    function currentItems() {
+        return store.listInbox().map((i) => overlay.get(i.messageId) ?? i);
+    }
+    return {
+        putMessage(envelope) {
+            store.putMessage(envelope);
+        },
+        appendEvent(event) {
+            const envelope = store.getMessage(event.messageId);
+            if (!envelope)
+                throw new Error(`unknown message ${event.messageId}`);
+            const prevOverlay = overlay.get(event.messageId);
+            const reduced = store.appendEvent(event);
+            revision += 1;
+            itemRevisions.set(event.messageId, revision);
+            if (event.eventType === 'tombstoned')
+                removedAt.set(event.messageId, revision);
+            const isAdmission = prevOverlay === undefined &&
+                (event.eventType === 'admitted' || event.eventType === 'delivered');
+            let application;
+            if (isAdmission) {
+                application = applyInboxRules(reduced, envelope, rules);
+            }
+            else {
+                // Preserve rule-applied labels/categories/priority across later events;
+                // folder + unread always follow the reducer (user actions win).
+                const merged = prevOverlay
+                    ? {
+                        ...reduced,
+                        labels: [...new Set([...reduced.labels, ...prevOverlay.labels])],
+                        categories: [...prevOverlay.categories],
+                        priority: prevOverlay.priority,
+                    }
+                    : reduced;
+                application = { item: merged, notifications: [], suppressed: false, appliedRuleIds: [] };
+            }
+            overlay.set(event.messageId, application.item);
+            return application;
+        },
+        getInboxItem(id) {
+            return overlay.get(id) ?? store.getInboxItem(id);
+        },
+        listInbox(folder) {
+            return currentItems()
+                .filter((i) => (folder ? i.folder === folder : true))
+                .sort((a, b) => b.lastEventAt.localeCompare(a.lastEventAt));
+        },
+        listByContext(ref) {
+            return currentItems()
+                .filter((i) => i.folder !== 'trash' && matchesContextRef(i.contextRefs, ref))
+                .sort((a, b) => b.lastEventAt.localeCompare(a.lastEventAt));
+        },
+        unreadCount(folder) {
+            return currentItems().filter((i) => i.unread && (folder ? i.folder === folder : true)).length;
+        },
+        summarize() {
+            return summarizeFolders(currentItems());
+        },
+        revision() {
+            return revision;
+        },
+        deltaSince(cursor) {
+            if (cursor && cursor.streamId !== opts.streamId) {
+                throw new Error(`cursor stream ${cursor.streamId} does not match projector stream ${opts.streamId}`);
+            }
+            const since = cursor?.revision ?? 0;
+            const changed = currentItems().filter((i) => (itemRevisions.get(i.messageId) ?? 0) > since && !removedAt.has(i.messageId));
+            const removed = [...removedAt.entries()]
+                .filter(([, rev]) => rev > since)
+                .map(([id]) => id);
+            return {
+                cursor: { version: 'ap.inbox.cursor.v1', streamId: opts.streamId, revision },
+                changed,
+                removed,
+            };
+        },
+    };
+}
+//# sourceMappingURL=projector.js.map

package/dist/messaging/projector.js.map

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

package/dist/messaging/receipts.d.ts

@@ -0,0 +1,5 @@
+import type { CanonicalAgentId } from '@agenticprimitives/types';
+import type { MessageEnvelopeV1, MessageEventV1 } from './types.js';
+export declare function buildDeliveryReceipt(envelope: MessageEnvelopeV1, actor: CanonicalAgentId, at: string): MessageEventV1;
+export declare function buildReadReceipt(envelope: MessageEnvelopeV1, actor: CanonicalAgentId, at: string): MessageEventV1;
+//# sourceMappingURL=receipts.d.ts.map

package/dist/messaging/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../../src/messaging/receipts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAkBpE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,gBAAgB,EACvB,EAAE,EAAE,MAAM,GACT,cAAc,CAEhB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,gBAAgB,EACvB,EAAE,EAAE,MAAM,GACT,cAAc,CAEhB"}

package/dist/messaging/receipts.js

@@ -0,0 +1,19 @@
+// Delivery/read receipt builders (spec 309 §5). A receipt is a MessageEventV1
+// the RECIPIENT emits back to the sender; fail-closed — only an addressed
+// recipient may emit one. Signing the event is the caller's job.
+function isRecipient(envelope, actor) {
+    return envelope.to.includes(actor) || (envelope.cc ?? []).includes(actor);
+}
+function buildReceipt(envelope, actor, eventType, at) {
+    if (!isRecipient(envelope, actor)) {
+        throw new Error(`${actor} is not a recipient of ${envelope.id}; cannot emit ${eventType} receipt`);
+    }
+    return { version: 'ap.message.event.v1', messageId: envelope.id, actor, eventType, at };
+}
+export function buildDeliveryReceipt(envelope, actor, at) {
+    return buildReceipt(envelope, actor, 'delivered', at);
+}
+export function buildReadReceipt(envelope, actor, at) {
+    return buildReceipt(envelope, actor, 'read', at);
+}
+//# sourceMappingURL=receipts.js.map

package/dist/messaging/receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.js","sourceRoot":"","sources":["../../src/messaging/receipts.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,iEAAiE;AAKjE,SAAS,WAAW,CAAC,QAA2B,EAAE,KAAuB;IACvE,OAAO,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,YAAY,CACnB,QAA2B,EAC3B,KAAuB,EACvB,SAA+B,EAC/B,EAAU;IAEV,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,QAAQ,CAAC,EAAE,iBAAiB,SAAS,UAAU,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAA2B,EAC3B,KAAuB,EACvB,EAAU;IAEV,OAAO,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAA2B,EAC3B,KAAuB,EACvB,EAAU;IAEV,OAAO,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/messaging/rules.d.ts

@@ -0,0 +1,84 @@
+import type { CanonicalAgentId } from '@agenticprimitives/types';
+import type { VaultClassification } from '@agenticprimitives/vault';
+import type { ContextRefV1, FolderKind, InboxItemV1, MessageEnvelopeV1, MessageId, MessageKind, MessagePriority } from './types.js';
+/** AND across specified members; any-of within each list. Empty predicate matches all. */
+export interface InboxRulePredicateV1 {
+    fromAnyOf?: CanonicalAgentId[];
+    kindAnyOf?: MessageKind[];
+    /** Case-insensitive substring match, any-of. */
+    subjectContainsAnyOf?: string[];
+    labelAnyOf?: string[];
+    priorityAtLeast?: MessagePriority;
+    hasAttachments?: boolean;
+    classificationAnyOf?: VaultClassification[];
+    hasInteraction?: boolean;
+    /** Matches messages ABOUT any of these contexts (spec 312). `id` omitted ⇒
+     *  any ref of that kind matches ("everything about any org"). */
+    contextRefAnyOf?: Pick<ContextRefV1, 'kind' | 'id'>[];
+}
+/** Shared context-match used by rules and `listByContext` — ONE mechanism (ADR-0013). */
+export declare function matchesContextRef(refs: readonly ContextRefV1[], query: {
+    kind: string;
+    id?: string;
+}): boolean;
+export type InboxRuleActionV1 = {
+    type: 'move';
+    folder: FolderKind;
+} | {
+    type: 'label';
+    label: string;
+} | {
+    type: 'category';
+    category: string;
+} | {
+    type: 'mark-read';
+} | {
+    type: 'mark-unread';
+} | {
+    type: 'set-priority';
+    priority: MessagePriority;
+} | {
+    type: 'notify';
+    channel?: string;
+} | {
+    type: 'suppress-notification';
+};
+export interface InboxRuleV1 {
+    version: 'ap.inbox.rule.v1';
+    id: string;
+    name?: string;
+    /** Rules evaluate sorted by (order, id) — same input always yields same output. */
+    order: number;
+    enabled: boolean;
+    when: InboxRulePredicateV1;
+    except?: InboxRulePredicateV1;
+    actions: InboxRuleActionV1[];
+    /** Outlook-style: matching this rule stops evaluation of later rules. */
+    stopProcessing?: boolean;
+}
+export interface NotificationEventV1 {
+    version: 'ap.message.notification.v1';
+    messageId: MessageId;
+    ruleId: string;
+    channel?: string;
+    at: string;
+}
+/** Port for push/email/UI toast fan-out — implementations live in apps/runtimes. */
+export interface NotificationSink {
+    notify(event: NotificationEventV1): void | Promise<void>;
+}
+export declare function matchesRulePredicate(predicate: InboxRulePredicateV1, envelope: MessageEnvelopeV1, item: InboxItemV1): boolean;
+export interface RuleApplication {
+    item: InboxItemV1;
+    /** Empty when suppressed — a matching suppress-notification wins over notify. */
+    notifications: NotificationEventV1[];
+    suppressed: boolean;
+    appliedRuleIds: string[];
+}
+/**
+ * Pure, deterministic rule pass over a freshly projected inbox item.
+ * Rules run in (order, id) order; disabled rules skip; `except` vetoes `when`;
+ * `stopProcessing` halts later rules after the current one's actions apply.
+ */
+export declare function applyInboxRules(item: InboxItemV1, envelope: MessageEnvelopeV1, rules: InboxRuleV1[]): RuleApplication;
+//# sourceMappingURL=rules.d.ts.map

package/dist/messaging/rules.d.ts.map

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