@agimon-ai/doompi-session 0.0.1-alpha.1

package/dist/src/services/sessionDirectory/type.d.mts

@@ -0,0 +1,54 @@
+//#region src/services/sessionDirectory/type.d.ts
+export type SessionHostReachability = 'reachable' | 'unreachable' | 'unknown';
+export type SessionRuntimeState = 'starting' | 'ready' | 'dormant' | 'closing' | 'closed' | 'unknown';
+export type SessionActivityState = 'busy' | 'awaiting_input' | 'fully_idle' | 'unknown';
+export type SessionVoiceReadiness = 'ready' | 'not_ready' | 'unknown';
+export interface SessionPresenceFacts {
+  readonly reachability: SessionHostReachability;
+  readonly runtime: SessionRuntimeState;
+  readonly activity: SessionActivityState;
+  readonly voice: {
+    readonly eligible: boolean | 'unknown';
+    readonly readiness: SessionVoiceReadiness;
+  };
+}
+export interface SessionPresenceObservation extends SessionPresenceFacts {
+  readonly hostId: string;
+  readonly sessionId: string;
+  readonly hostIncarnation: string;
+  readonly sessionIncarnation: string;
+  readonly sequence: number;
+  readonly observedAt: number;
+  readonly staleAfterMs: number;
+  readonly label?: string;
+  readonly deliveryTarget: string;
+}
+export interface SessionDiscoveryGrant {
+  readonly label?: string;
+  readonly capabilities: readonly string[];
+}
+export interface DiscoveredSession extends SessionPresenceFacts {
+  readonly reference: string;
+  readonly label?: string;
+  readonly capabilities: readonly string[];
+  readonly hostIncarnation: string;
+  readonly sessionIncarnation: string;
+  readonly sequence: number;
+  readonly observedAt: number;
+  readonly freshUntil: number;
+  readonly fresh: boolean;
+}
+export interface SessionDirectoryOptions {
+  readonly now?: () => number;
+  readonly authorizeDiscovery: (callerReference: string, subject: Readonly<Pick<SessionPresenceObservation, 'hostId' | 'sessionId' | 'label'>>) => SessionDiscoveryGrant | undefined;
+}
+export interface SessionDirectory {
+  observe(observation: SessionPresenceObservation): boolean;
+  replaceHostSnapshot(hostId: string, hostIncarnation: string, observations: readonly SessionPresenceObservation[]): void;
+  hostDisconnected(hostId: string): void;
+  discover(callerReference: string, allowedReferences?: ReadonlySet<string>): readonly DiscoveredSession[];
+  resolveDeliveryTarget(callerReference: string, reference: string): string | undefined;
+  subscribe(callerReference: string, listener: (sessions: readonly DiscoveredSession[]) => void): () => void;
+}
+//#endregion
+//# sourceMappingURL=type.d.mts.map

package/dist/src/services/sessionDirectory/type.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.mts","names":[],"sources":["../../../../src/services/sessionDirectory/type.ts"],"mappings":";YAAY;YACA;YACA;YACA;iBAEK;WACN,cAAc;WACd,SAAS;WACT,UAAU;WACV;aACE;aACA,WAAW;;;iBAIP,mCAAmC;WACzC;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;;iBAGM,0BAA0B;WAChC;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA,qBACP,yBACA,SAAS,SAAS,KAAK,mEACpB;;iBAGU;EACf,QAAQ,aAAa;EACrB,oBACE,gBACA,yBACA,uBAAuB;EAEzB,iBAAiB;EACjB,SAAS,yBAAyB,oBAAoB,+BAA+B;EACrF,sBAAsB,yBAAyB;EAC/C,UAAU,yBAAyB,WAAW,mBAAmB"}

package/dist/src/services/sessionGroups/index.cjs

@@ -0,0 +1,105 @@
+const require_type = require("./type.cjs");
+let node_sqlite = require("node:sqlite");
+//#region src/services/sessionGroups/index.ts
+const ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;
+const REFERENCE_PATTERN = /^peer\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;
+function validateGroupId(value) {
+	if (!ID_PATTERN.test(value)) throw new TypeError("Session group IDs must be safe opaque IDs.");
+}
+function validateReference(value) {
+	if (!REFERENCE_PATTERN.test(value)) throw new TypeError(`Session group member '${value}' is not a qualified reference.`);
+}
+/** Opens a revisioned SQLite registry for communication-only group membership. */
+function createSessionGroupStore(options) {
+	const database = new node_sqlite.DatabaseSync(options.databasePath);
+	database.exec(`
+    PRAGMA journal_mode = WAL;
+    PRAGMA foreign_keys = ON;
+    CREATE TABLE IF NOT EXISTS session_groups (
+      group_id TEXT PRIMARY KEY,
+      owner_authority TEXT NOT NULL,
+      revision INTEGER NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS session_group_members (
+      group_id TEXT NOT NULL REFERENCES session_groups(group_id) ON DELETE CASCADE,
+      member_reference TEXT NOT NULL,
+      PRIMARY KEY (group_id, member_reference)
+    );
+  `);
+	const read = (groupId) => {
+		const row = database.prepare("SELECT * FROM session_groups WHERE group_id = ?").get(groupId);
+		if (!row) return void 0;
+		const members = database.prepare("SELECT member_reference FROM session_group_members WHERE group_id = ? ORDER BY member_reference").all(groupId);
+		return Object.freeze({
+			id: row.group_id,
+			ownerAuthority: row.owner_authority,
+			revision: row.revision,
+			members: Object.freeze(members.map((member) => member.member_reference))
+		});
+	};
+	const enroll = (groupId, members) => {
+		const insert = database.prepare("INSERT OR IGNORE INTO session_group_members (group_id, member_reference) VALUES (?, ?)");
+		for (const member of new Set(members)) {
+			validateReference(member);
+			if (options.validateEnrollment?.(groupId, member) === false) throw new Error(`Session group enrollment policy rejected '${member}'.`);
+			insert.run(groupId, member);
+		}
+	};
+	return {
+		create(groupId, ownerAuthority, members) {
+			validateGroupId(groupId);
+			if (!ownerAuthority.trim()) throw new TypeError("Session group owner authority is required.");
+			database.exec("BEGIN IMMEDIATE");
+			try {
+				database.prepare("INSERT INTO session_groups (group_id, owner_authority, revision) VALUES (?, ?, 1)").run(groupId, ownerAuthority);
+				enroll(groupId, members);
+				database.exec("COMMIT");
+			} catch (cause) {
+				database.exec("ROLLBACK");
+				throw cause;
+			}
+			return read(groupId);
+		},
+		mutate(mutation) {
+			database.exec("BEGIN IMMEDIATE");
+			try {
+				const current = read(mutation.groupId);
+				if (!current) throw new Error(`Session group '${mutation.groupId}' does not exist.`);
+				if (mutation.authority !== current.ownerAuthority && options.authorizeManagement?.(mutation.authority, current) !== true) throw new Error(`Authority '${mutation.authority}' cannot manage Session group '${mutation.groupId}'.`);
+				if (mutation.expectedRevision !== current.revision) throw new require_type.SessionGroupRevisionError(mutation.groupId, mutation.expectedRevision, current.revision);
+				enroll(mutation.groupId, mutation.add ?? []);
+				const remove = database.prepare("DELETE FROM session_group_members WHERE group_id = ? AND member_reference = ?");
+				for (const member of new Set(mutation.remove ?? [])) {
+					validateReference(member);
+					remove.run(mutation.groupId, member);
+				}
+				database.prepare("UPDATE session_groups SET revision = revision + 1 WHERE group_id = ? AND revision = ?").run(mutation.groupId, current.revision);
+				database.exec("COMMIT");
+			} catch (cause) {
+				database.exec("ROLLBACK");
+				throw cause;
+			}
+			return read(mutation.groupId);
+		},
+		get: read,
+		groupsFor(memberReference) {
+			validateReference(memberReference);
+			return database.prepare(`SELECT g.group_id FROM session_groups g
+           INNER JOIN session_group_members m ON m.group_id = g.group_id
+           WHERE m.member_reference = ? ORDER BY g.group_id`).all(memberReference).map((row) => read(row.group_id));
+		},
+		canMessage(groupId, sourceReference, targetReference) {
+			validateReference(sourceReference);
+			validateReference(targetReference);
+			const row = database.prepare(`SELECT COUNT(*) AS count FROM session_group_members
+           WHERE group_id = ? AND member_reference IN (?, ?)`).get(groupId, sourceReference, targetReference);
+			return Number(row.count) === (sourceReference === targetReference ? 1 : 2);
+		},
+		close: () => database.close()
+	};
+}
+//#endregion
+exports.SessionGroupRevisionError = require_type.SessionGroupRevisionError;
+exports.createSessionGroupStore = createSessionGroupStore;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/sessionGroups/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["DatabaseSync","SessionGroupRevisionError"],"sources":["../../../../src/services/sessionGroups/index.ts"],"sourcesContent":["import { DatabaseSync } from 'node:sqlite';\n\nimport {\n  SessionGroupRevisionError,\n  type SessionCommunicationGroup,\n  type SessionGroupMutation,\n  type SessionGroupStore,\n  type SessionGroupStoreOptions,\n} from './type';\n\ninterface GroupRow {\n  group_id: string;\n  owner_authority: string;\n  revision: number;\n}\n\nconst ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;\nconst REFERENCE_PATTERN = /^peer\\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;\n\nfunction validateGroupId(value: string): void {\n  if (!ID_PATTERN.test(value)) throw new TypeError('Session group IDs must be safe opaque IDs.');\n}\n\nfunction validateReference(value: string): void {\n  if (!REFERENCE_PATTERN.test(value))\n    throw new TypeError(`Session group member '${value}' is not a qualified reference.`);\n}\n\n/** Opens a revisioned SQLite registry for communication-only group membership. */\nexport function createSessionGroupStore(options: SessionGroupStoreOptions): SessionGroupStore {\n  const database = new DatabaseSync(options.databasePath);\n  database.exec(`\n    PRAGMA journal_mode = WAL;\n    PRAGMA foreign_keys = ON;\n    CREATE TABLE IF NOT EXISTS session_groups (\n      group_id TEXT PRIMARY KEY,\n      owner_authority TEXT NOT NULL,\n      revision INTEGER NOT NULL\n    );\n    CREATE TABLE IF NOT EXISTS session_group_members (\n      group_id TEXT NOT NULL REFERENCES session_groups(group_id) ON DELETE CASCADE,\n      member_reference TEXT NOT NULL,\n      PRIMARY KEY (group_id, member_reference)\n    );\n  `);\n\n  const read = (groupId: string): SessionCommunicationGroup | undefined => {\n    const row = database.prepare('SELECT * FROM session_groups WHERE group_id = ?').get(groupId) as\n      | GroupRow\n      | undefined;\n    if (!row) return undefined;\n    const members = database\n      .prepare('SELECT member_reference FROM session_group_members WHERE group_id = ? ORDER BY member_reference')\n      .all(groupId) as { member_reference: string }[];\n    return Object.freeze({\n      id: row.group_id,\n      ownerAuthority: row.owner_authority,\n      revision: row.revision,\n      members: Object.freeze(members.map((member) => member.member_reference)),\n    });\n  };\n\n  const enroll = (groupId: string, members: readonly string[]): void => {\n    const insert = database.prepare(\n      'INSERT OR IGNORE INTO session_group_members (group_id, member_reference) VALUES (?, ?)',\n    );\n    for (const member of new Set(members)) {\n      validateReference(member);\n      if (options.validateEnrollment?.(groupId, member) === false)\n        throw new Error(`Session group enrollment policy rejected '${member}'.`);\n      insert.run(groupId, member);\n    }\n  };\n\n  return {\n    create(groupId, ownerAuthority, members) {\n      validateGroupId(groupId);\n      if (!ownerAuthority.trim()) throw new TypeError('Session group owner authority is required.');\n      database.exec('BEGIN IMMEDIATE');\n      try {\n        database\n          .prepare('INSERT INTO session_groups (group_id, owner_authority, revision) VALUES (?, ?, 1)')\n          .run(groupId, ownerAuthority);\n        enroll(groupId, members);\n        database.exec('COMMIT');\n      } catch (cause) {\n        database.exec('ROLLBACK');\n        throw cause;\n      }\n      return read(groupId)!;\n    },\n    mutate(mutation: SessionGroupMutation) {\n      database.exec('BEGIN IMMEDIATE');\n      try {\n        const current = read(mutation.groupId);\n        if (!current) throw new Error(`Session group '${mutation.groupId}' does not exist.`);\n        if (\n          mutation.authority !== current.ownerAuthority &&\n          options.authorizeManagement?.(mutation.authority, current) !== true\n        ) {\n          throw new Error(`Authority '${mutation.authority}' cannot manage Session group '${mutation.groupId}'.`);\n        }\n        if (mutation.expectedRevision !== current.revision)\n          throw new SessionGroupRevisionError(mutation.groupId, mutation.expectedRevision, current.revision);\n        enroll(mutation.groupId, mutation.add ?? []);\n        const remove = database.prepare(\n          'DELETE FROM session_group_members WHERE group_id = ? AND member_reference = ?',\n        );\n        for (const member of new Set(mutation.remove ?? [])) {\n          validateReference(member);\n          remove.run(mutation.groupId, member);\n        }\n        database\n          .prepare('UPDATE session_groups SET revision = revision + 1 WHERE group_id = ? AND revision = ?')\n          .run(mutation.groupId, current.revision);\n        database.exec('COMMIT');\n      } catch (cause) {\n        database.exec('ROLLBACK');\n        throw cause;\n      }\n      return read(mutation.groupId)!;\n    },\n    get: read,\n    groupsFor(memberReference) {\n      validateReference(memberReference);\n      const rows = database\n        .prepare(\n          `SELECT g.group_id FROM session_groups g\n           INNER JOIN session_group_members m ON m.group_id = g.group_id\n           WHERE m.member_reference = ? ORDER BY g.group_id`,\n        )\n        .all(memberReference) as { group_id: string }[];\n      return rows.map((row) => read(row.group_id)!);\n    },\n    canMessage(groupId, sourceReference, targetReference) {\n      validateReference(sourceReference);\n      validateReference(targetReference);\n      const row = database\n        .prepare(\n          `SELECT COUNT(*) AS count FROM session_group_members\n           WHERE group_id = ? AND member_reference IN (?, ?)`,\n        )\n        .get(groupId, sourceReference, targetReference) as { count: number | bigint };\n      return Number(row.count) === (sourceReference === targetReference ? 1 : 2);\n    },\n    close: () => database.close(),\n  };\n}\n\nexport {\n  SessionGroupRevisionError,\n  type SessionCommunicationGroup,\n  type SessionGroupMutation,\n  type SessionGroupStore,\n  type SessionGroupStoreOptions,\n} from './type';\n"],"mappings":"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"}

package/dist/src/services/sessionGroups/index.d.cts

@@ -0,0 +1,7 @@
+import { SessionCommunicationGroup, SessionGroupMutation, SessionGroupRevisionError, SessionGroupStore, SessionGroupStoreOptions } from "./type.cjs";
+//#region src/services/sessionGroups/index.d.ts
+/** Opens a revisioned SQLite registry for communication-only group membership. */
+export declare function createSessionGroupStore(options: SessionGroupStoreOptions): SessionGroupStore;
+//#endregion
+export { type SessionCommunicationGroup, type SessionGroupMutation, SessionGroupRevisionError, type SessionGroupStore, type SessionGroupStoreOptions };
+//# sourceMappingURL=index.d.cts.map

package/dist/src/services/sessionGroups/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../../src/services/sessionGroups/index.ts"],"mappings":";;;wBA6BgB,wBAAwB,SAAS,2BAA2B"}

package/dist/src/services/sessionGroups/index.d.mts

@@ -0,0 +1,7 @@
+import { SessionCommunicationGroup, SessionGroupMutation, SessionGroupRevisionError, SessionGroupStore, SessionGroupStoreOptions } from "./type.mjs";
+//#region src/services/sessionGroups/index.d.ts
+/** Opens a revisioned SQLite registry for communication-only group membership. */
+export declare function createSessionGroupStore(options: SessionGroupStoreOptions): SessionGroupStore;
+//#endregion
+export { type SessionCommunicationGroup, type SessionGroupMutation, SessionGroupRevisionError, type SessionGroupStore, type SessionGroupStoreOptions };
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/sessionGroups/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/sessionGroups/index.ts"],"mappings":";;;wBA6BgB,wBAAwB,SAAS,2BAA2B"}

package/dist/src/services/sessionGroups/index.mjs

@@ -0,0 +1,104 @@
+import { SessionGroupRevisionError } from "./type.mjs";
+import { DatabaseSync } from "node:sqlite";
+//#region src/services/sessionGroups/index.ts
+const ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;
+const REFERENCE_PATTERN = /^peer\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;
+function validateGroupId(value) {
+	if (!ID_PATTERN.test(value)) throw new TypeError("Session group IDs must be safe opaque IDs.");
+}
+function validateReference(value) {
+	if (!REFERENCE_PATTERN.test(value)) throw new TypeError(`Session group member '${value}' is not a qualified reference.`);
+}
+/** Opens a revisioned SQLite registry for communication-only group membership. */
+function createSessionGroupStore(options) {
+	const database = new DatabaseSync(options.databasePath);
+	database.exec(`
+    PRAGMA journal_mode = WAL;
+    PRAGMA foreign_keys = ON;
+    CREATE TABLE IF NOT EXISTS session_groups (
+      group_id TEXT PRIMARY KEY,
+      owner_authority TEXT NOT NULL,
+      revision INTEGER NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS session_group_members (
+      group_id TEXT NOT NULL REFERENCES session_groups(group_id) ON DELETE CASCADE,
+      member_reference TEXT NOT NULL,
+      PRIMARY KEY (group_id, member_reference)
+    );
+  `);
+	const read = (groupId) => {
+		const row = database.prepare("SELECT * FROM session_groups WHERE group_id = ?").get(groupId);
+		if (!row) return void 0;
+		const members = database.prepare("SELECT member_reference FROM session_group_members WHERE group_id = ? ORDER BY member_reference").all(groupId);
+		return Object.freeze({
+			id: row.group_id,
+			ownerAuthority: row.owner_authority,
+			revision: row.revision,
+			members: Object.freeze(members.map((member) => member.member_reference))
+		});
+	};
+	const enroll = (groupId, members) => {
+		const insert = database.prepare("INSERT OR IGNORE INTO session_group_members (group_id, member_reference) VALUES (?, ?)");
+		for (const member of new Set(members)) {
+			validateReference(member);
+			if (options.validateEnrollment?.(groupId, member) === false) throw new Error(`Session group enrollment policy rejected '${member}'.`);
+			insert.run(groupId, member);
+		}
+	};
+	return {
+		create(groupId, ownerAuthority, members) {
+			validateGroupId(groupId);
+			if (!ownerAuthority.trim()) throw new TypeError("Session group owner authority is required.");
+			database.exec("BEGIN IMMEDIATE");
+			try {
+				database.prepare("INSERT INTO session_groups (group_id, owner_authority, revision) VALUES (?, ?, 1)").run(groupId, ownerAuthority);
+				enroll(groupId, members);
+				database.exec("COMMIT");
+			} catch (cause) {
+				database.exec("ROLLBACK");
+				throw cause;
+			}
+			return read(groupId);
+		},
+		mutate(mutation) {
+			database.exec("BEGIN IMMEDIATE");
+			try {
+				const current = read(mutation.groupId);
+				if (!current) throw new Error(`Session group '${mutation.groupId}' does not exist.`);
+				if (mutation.authority !== current.ownerAuthority && options.authorizeManagement?.(mutation.authority, current) !== true) throw new Error(`Authority '${mutation.authority}' cannot manage Session group '${mutation.groupId}'.`);
+				if (mutation.expectedRevision !== current.revision) throw new SessionGroupRevisionError(mutation.groupId, mutation.expectedRevision, current.revision);
+				enroll(mutation.groupId, mutation.add ?? []);
+				const remove = database.prepare("DELETE FROM session_group_members WHERE group_id = ? AND member_reference = ?");
+				for (const member of new Set(mutation.remove ?? [])) {
+					validateReference(member);
+					remove.run(mutation.groupId, member);
+				}
+				database.prepare("UPDATE session_groups SET revision = revision + 1 WHERE group_id = ? AND revision = ?").run(mutation.groupId, current.revision);
+				database.exec("COMMIT");
+			} catch (cause) {
+				database.exec("ROLLBACK");
+				throw cause;
+			}
+			return read(mutation.groupId);
+		},
+		get: read,
+		groupsFor(memberReference) {
+			validateReference(memberReference);
+			return database.prepare(`SELECT g.group_id FROM session_groups g
+           INNER JOIN session_group_members m ON m.group_id = g.group_id
+           WHERE m.member_reference = ? ORDER BY g.group_id`).all(memberReference).map((row) => read(row.group_id));
+		},
+		canMessage(groupId, sourceReference, targetReference) {
+			validateReference(sourceReference);
+			validateReference(targetReference);
+			const row = database.prepare(`SELECT COUNT(*) AS count FROM session_group_members
+           WHERE group_id = ? AND member_reference IN (?, ?)`).get(groupId, sourceReference, targetReference);
+			return Number(row.count) === (sourceReference === targetReference ? 1 : 2);
+		},
+		close: () => database.close()
+	};
+}
+//#endregion
+export { SessionGroupRevisionError, createSessionGroupStore };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/sessionGroups/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/sessionGroups/index.ts"],"sourcesContent":["import { DatabaseSync } from 'node:sqlite';\n\nimport {\n  SessionGroupRevisionError,\n  type SessionCommunicationGroup,\n  type SessionGroupMutation,\n  type SessionGroupStore,\n  type SessionGroupStoreOptions,\n} from './type';\n\ninterface GroupRow {\n  group_id: string;\n  owner_authority: string;\n  revision: number;\n}\n\nconst ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;\nconst REFERENCE_PATTERN = /^peer\\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u;\n\nfunction validateGroupId(value: string): void {\n  if (!ID_PATTERN.test(value)) throw new TypeError('Session group IDs must be safe opaque IDs.');\n}\n\nfunction validateReference(value: string): void {\n  if (!REFERENCE_PATTERN.test(value))\n    throw new TypeError(`Session group member '${value}' is not a qualified reference.`);\n}\n\n/** Opens a revisioned SQLite registry for communication-only group membership. */\nexport function createSessionGroupStore(options: SessionGroupStoreOptions): SessionGroupStore {\n  const database = new DatabaseSync(options.databasePath);\n  database.exec(`\n    PRAGMA journal_mode = WAL;\n    PRAGMA foreign_keys = ON;\n    CREATE TABLE IF NOT EXISTS session_groups (\n      group_id TEXT PRIMARY KEY,\n      owner_authority TEXT NOT NULL,\n      revision INTEGER NOT NULL\n    );\n    CREATE TABLE IF NOT EXISTS session_group_members (\n      group_id TEXT NOT NULL REFERENCES session_groups(group_id) ON DELETE CASCADE,\n      member_reference TEXT NOT NULL,\n      PRIMARY KEY (group_id, member_reference)\n    );\n  `);\n\n  const read = (groupId: string): SessionCommunicationGroup | undefined => {\n    const row = database.prepare('SELECT * FROM session_groups WHERE group_id = ?').get(groupId) as\n      | GroupRow\n      | undefined;\n    if (!row) return undefined;\n    const members = database\n      .prepare('SELECT member_reference FROM session_group_members WHERE group_id = ? ORDER BY member_reference')\n      .all(groupId) as { member_reference: string }[];\n    return Object.freeze({\n      id: row.group_id,\n      ownerAuthority: row.owner_authority,\n      revision: row.revision,\n      members: Object.freeze(members.map((member) => member.member_reference)),\n    });\n  };\n\n  const enroll = (groupId: string, members: readonly string[]): void => {\n    const insert = database.prepare(\n      'INSERT OR IGNORE INTO session_group_members (group_id, member_reference) VALUES (?, ?)',\n    );\n    for (const member of new Set(members)) {\n      validateReference(member);\n      if (options.validateEnrollment?.(groupId, member) === false)\n        throw new Error(`Session group enrollment policy rejected '${member}'.`);\n      insert.run(groupId, member);\n    }\n  };\n\n  return {\n    create(groupId, ownerAuthority, members) {\n      validateGroupId(groupId);\n      if (!ownerAuthority.trim()) throw new TypeError('Session group owner authority is required.');\n      database.exec('BEGIN IMMEDIATE');\n      try {\n        database\n          .prepare('INSERT INTO session_groups (group_id, owner_authority, revision) VALUES (?, ?, 1)')\n          .run(groupId, ownerAuthority);\n        enroll(groupId, members);\n        database.exec('COMMIT');\n      } catch (cause) {\n        database.exec('ROLLBACK');\n        throw cause;\n      }\n      return read(groupId)!;\n    },\n    mutate(mutation: SessionGroupMutation) {\n      database.exec('BEGIN IMMEDIATE');\n      try {\n        const current = read(mutation.groupId);\n        if (!current) throw new Error(`Session group '${mutation.groupId}' does not exist.`);\n        if (\n          mutation.authority !== current.ownerAuthority &&\n          options.authorizeManagement?.(mutation.authority, current) !== true\n        ) {\n          throw new Error(`Authority '${mutation.authority}' cannot manage Session group '${mutation.groupId}'.`);\n        }\n        if (mutation.expectedRevision !== current.revision)\n          throw new SessionGroupRevisionError(mutation.groupId, mutation.expectedRevision, current.revision);\n        enroll(mutation.groupId, mutation.add ?? []);\n        const remove = database.prepare(\n          'DELETE FROM session_group_members WHERE group_id = ? AND member_reference = ?',\n        );\n        for (const member of new Set(mutation.remove ?? [])) {\n          validateReference(member);\n          remove.run(mutation.groupId, member);\n        }\n        database\n          .prepare('UPDATE session_groups SET revision = revision + 1 WHERE group_id = ? AND revision = ?')\n          .run(mutation.groupId, current.revision);\n        database.exec('COMMIT');\n      } catch (cause) {\n        database.exec('ROLLBACK');\n        throw cause;\n      }\n      return read(mutation.groupId)!;\n    },\n    get: read,\n    groupsFor(memberReference) {\n      validateReference(memberReference);\n      const rows = database\n        .prepare(\n          `SELECT g.group_id FROM session_groups g\n           INNER JOIN session_group_members m ON m.group_id = g.group_id\n           WHERE m.member_reference = ? ORDER BY g.group_id`,\n        )\n        .all(memberReference) as { group_id: string }[];\n      return rows.map((row) => read(row.group_id)!);\n    },\n    canMessage(groupId, sourceReference, targetReference) {\n      validateReference(sourceReference);\n      validateReference(targetReference);\n      const row = database\n        .prepare(\n          `SELECT COUNT(*) AS count FROM session_group_members\n           WHERE group_id = ? AND member_reference IN (?, ?)`,\n        )\n        .get(groupId, sourceReference, targetReference) as { count: number | bigint };\n      return Number(row.count) === (sourceReference === targetReference ? 1 : 2);\n    },\n    close: () => database.close(),\n  };\n}\n\nexport {\n  SessionGroupRevisionError,\n  type SessionCommunicationGroup,\n  type SessionGroupMutation,\n  type SessionGroupStore,\n  type SessionGroupStoreOptions,\n} from './type';\n"],"mappings":"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"}

package/dist/src/services/sessionGroups/type.cjs

@@ -0,0 +1,11 @@
+//#region src/services/sessionGroups/type.ts
+var SessionGroupRevisionError = class extends Error {
+	constructor(groupId, expected, actual) {
+		super(`Session group '${groupId}' revision conflict: expected ${expected}, current ${actual}.`);
+		this.name = "SessionGroupRevisionError";
+	}
+};
+//#endregion
+exports.SessionGroupRevisionError = SessionGroupRevisionError;
+
+//# sourceMappingURL=type.cjs.map

package/dist/src/services/sessionGroups/type.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.cjs","names":[],"sources":["../../../../src/services/sessionGroups/type.ts"],"sourcesContent":["export interface SessionCommunicationGroup {\n  readonly id: string;\n  readonly ownerAuthority: string;\n  readonly revision: number;\n  readonly members: readonly string[];\n}\n\nexport interface SessionGroupMutation {\n  readonly groupId: string;\n  readonly authority: string;\n  readonly expectedRevision: number;\n  readonly add?: readonly string[];\n  readonly remove?: readonly string[];\n}\n\nexport interface SessionGroupStoreOptions {\n  readonly databasePath: string;\n  readonly authorizeManagement?: (authority: string, group: SessionCommunicationGroup) => boolean;\n  readonly validateEnrollment?: (groupId: string, memberReference: string) => boolean;\n}\n\nexport interface SessionGroupStore {\n  create(groupId: string, ownerAuthority: string, members: readonly string[]): SessionCommunicationGroup;\n  mutate(mutation: SessionGroupMutation): SessionCommunicationGroup;\n  get(groupId: string): SessionCommunicationGroup | undefined;\n  groupsFor(memberReference: string): readonly SessionCommunicationGroup[];\n  canMessage(groupId: string, sourceReference: string, targetReference: string): boolean;\n  close(): void;\n}\n\nexport class SessionGroupRevisionError extends Error {\n  constructor(groupId: string, expected: number, actual: number) {\n    super(`Session group '${groupId}' revision conflict: expected ${expected}, current ${actual}.`);\n    this.name = 'SessionGroupRevisionError';\n  }\n}\n"],"mappings":";AA8BA,IAAa,4BAAb,cAA+C,MAAM;CACnD,YAAY,SAAiB,UAAkB,QAAgB;EAC7D,MAAM,kBAAkB,QAAQ,gCAAgC,SAAS,YAAY,OAAO,EAAE;EAC9F,KAAK,OAAO;CACd;AACF"}

package/dist/src/services/sessionGroups/type.d.cts

@@ -0,0 +1,32 @@
+//#region src/services/sessionGroups/type.d.ts
+export interface SessionCommunicationGroup {
+  readonly id: string;
+  readonly ownerAuthority: string;
+  readonly revision: number;
+  readonly members: readonly string[];
+}
+export interface SessionGroupMutation {
+  readonly groupId: string;
+  readonly authority: string;
+  readonly expectedRevision: number;
+  readonly add?: readonly string[];
+  readonly remove?: readonly string[];
+}
+export interface SessionGroupStoreOptions {
+  readonly databasePath: string;
+  readonly authorizeManagement?: (authority: string, group: SessionCommunicationGroup) => boolean;
+  readonly validateEnrollment?: (groupId: string, memberReference: string) => boolean;
+}
+export interface SessionGroupStore {
+  create(groupId: string, ownerAuthority: string, members: readonly string[]): SessionCommunicationGroup;
+  mutate(mutation: SessionGroupMutation): SessionCommunicationGroup;
+  get(groupId: string): SessionCommunicationGroup | undefined;
+  groupsFor(memberReference: string): readonly SessionCommunicationGroup[];
+  canMessage(groupId: string, sourceReference: string, targetReference: string): boolean;
+  close(): void;
+}
+export declare class SessionGroupRevisionError extends Error {
+  constructor(groupId: string, expected: number, actual: number);
+}
+//#endregion
+//# sourceMappingURL=type.d.cts.map

package/dist/src/services/sessionGroups/type.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.cts","names":[],"sources":["../../../../src/services/sessionGroups/type.ts"],"mappings":";iBAAiB;WACN;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA,uBAAuB,mBAAmB,OAAO;WACjD,sBAAsB,iBAAiB;;iBAGjC;EACf,OAAO,iBAAiB,wBAAwB,6BAA6B;EAC7E,OAAO,UAAU,uBAAuB;EACxC,IAAI,kBAAkB;EACtB,UAAU,mCAAmC;EAC7C,WAAW,iBAAiB,yBAAyB;EACrD;;qBAGW,kCAAkC;EAC7C,YAAY,iBAAiB,kBAAkB"}

package/dist/src/services/sessionGroups/type.d.mts

@@ -0,0 +1,32 @@
+//#region src/services/sessionGroups/type.d.ts
+export interface SessionCommunicationGroup {
+  readonly id: string;
+  readonly ownerAuthority: string;
+  readonly revision: number;
+  readonly members: readonly string[];
+}
+export interface SessionGroupMutation {
+  readonly groupId: string;
+  readonly authority: string;
+  readonly expectedRevision: number;
+  readonly add?: readonly string[];
+  readonly remove?: readonly string[];
+}
+export interface SessionGroupStoreOptions {
+  readonly databasePath: string;
+  readonly authorizeManagement?: (authority: string, group: SessionCommunicationGroup) => boolean;
+  readonly validateEnrollment?: (groupId: string, memberReference: string) => boolean;
+}
+export interface SessionGroupStore {
+  create(groupId: string, ownerAuthority: string, members: readonly string[]): SessionCommunicationGroup;
+  mutate(mutation: SessionGroupMutation): SessionCommunicationGroup;
+  get(groupId: string): SessionCommunicationGroup | undefined;
+  groupsFor(memberReference: string): readonly SessionCommunicationGroup[];
+  canMessage(groupId: string, sourceReference: string, targetReference: string): boolean;
+  close(): void;
+}
+export declare class SessionGroupRevisionError extends Error {
+  constructor(groupId: string, expected: number, actual: number);
+}
+//#endregion
+//# sourceMappingURL=type.d.mts.map

package/dist/src/services/sessionGroups/type.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.mts","names":[],"sources":["../../../../src/services/sessionGroups/type.ts"],"mappings":";iBAAiB;WACN;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA,uBAAuB,mBAAmB,OAAO;WACjD,sBAAsB,iBAAiB;;iBAGjC;EACf,OAAO,iBAAiB,wBAAwB,6BAA6B;EAC7E,OAAO,UAAU,uBAAuB;EACxC,IAAI,kBAAkB;EACtB,UAAU,mCAAmC;EAC7C,WAAW,iBAAiB,yBAAyB;EACrD;;qBAGW,kCAAkC;EAC7C,YAAY,iBAAiB,kBAAkB"}

package/dist/src/services/sessionGroups/type.mjs

@@ -0,0 +1,11 @@
+//#region src/services/sessionGroups/type.ts
+var SessionGroupRevisionError = class extends Error {
+	constructor(groupId, expected, actual) {
+		super(`Session group '${groupId}' revision conflict: expected ${expected}, current ${actual}.`);
+		this.name = "SessionGroupRevisionError";
+	}
+};
+//#endregion
+export { SessionGroupRevisionError };
+
+//# sourceMappingURL=type.mjs.map

package/dist/src/services/sessionGroups/type.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.mjs","names":[],"sources":["../../../../src/services/sessionGroups/type.ts"],"sourcesContent":["export interface SessionCommunicationGroup {\n  readonly id: string;\n  readonly ownerAuthority: string;\n  readonly revision: number;\n  readonly members: readonly string[];\n}\n\nexport interface SessionGroupMutation {\n  readonly groupId: string;\n  readonly authority: string;\n  readonly expectedRevision: number;\n  readonly add?: readonly string[];\n  readonly remove?: readonly string[];\n}\n\nexport interface SessionGroupStoreOptions {\n  readonly databasePath: string;\n  readonly authorizeManagement?: (authority: string, group: SessionCommunicationGroup) => boolean;\n  readonly validateEnrollment?: (groupId: string, memberReference: string) => boolean;\n}\n\nexport interface SessionGroupStore {\n  create(groupId: string, ownerAuthority: string, members: readonly string[]): SessionCommunicationGroup;\n  mutate(mutation: SessionGroupMutation): SessionCommunicationGroup;\n  get(groupId: string): SessionCommunicationGroup | undefined;\n  groupsFor(memberReference: string): readonly SessionCommunicationGroup[];\n  canMessage(groupId: string, sourceReference: string, targetReference: string): boolean;\n  close(): void;\n}\n\nexport class SessionGroupRevisionError extends Error {\n  constructor(groupId: string, expected: number, actual: number) {\n    super(`Session group '${groupId}' revision conflict: expected ${expected}, current ${actual}.`);\n    this.name = 'SessionGroupRevisionError';\n  }\n}\n"],"mappings":";AA8BA,IAAa,4BAAb,cAA+C,MAAM;CACnD,YAAY,SAAiB,UAAkB,QAAgB;EAC7D,MAAM,kBAAkB,QAAQ,gCAAgC,SAAS,YAAY,OAAO,EAAE;EAC9F,KAAK,OAAO;CACd;AACF"}

package/dist/src/services/sessionIntercom/index.cjs

@@ -0,0 +1,89 @@
+const require_type = require("./type.cjs");
+//#region src/services/sessionIntercom/index.ts
+const MESSAGE_KIND = "session-message";
+const REPORT_KIND = "session-report";
+function metadataFor(options, request, reportStatus) {
+	const group = options.groups.get(request.groupId);
+	if (!group || !options.groups.canMessage(request.groupId, options.selfReference, request.targetReference)) throw new Error(`Session group '${request.groupId}' does not authorize this message.`);
+	return {
+		sourceReference: options.selfReference,
+		targetReference: request.targetReference,
+		groupId: request.groupId,
+		groupRevision: String(group.revision),
+		...request.correlationId === void 0 ? {} : { correlationId: request.correlationId },
+		...reportStatus === void 0 ? {} : { reportStatus }
+	};
+}
+/** Agent-facing intercom operations. A composition may acquire this service without gaining session controls. */
+function createSessionIntercom(options) {
+	const deliver = async (request, kind, status) => {
+		const recipientKey = options.directory.resolveDeliveryTarget(options.selfReference, request.targetReference);
+		if (!recipientKey) throw new Error(`Session '${request.targetReference}' is not discoverable.`);
+		const metadata = metadataFor(options, request, status);
+		return options.delivery.deliver({
+			...request.deliveryId === void 0 ? {} : { deliveryId: request.deliveryId },
+			recipientKey,
+			kind,
+			prompt: `[Session ${status === void 0 ? "message" : `report: ${status}`} from ${options.selfReference}] ${request.text}`,
+			metadata
+		});
+	};
+	return Object.freeze({
+		discover() {
+			const members = new Set(options.groups.groupsFor(options.selfReference).flatMap((group) => group.members).filter((reference) => reference !== options.selfReference));
+			return options.directory.discover(options.selfReference, members);
+		},
+		send: (request) => deliver(request, MESSAGE_KIND),
+		report: (request) => deliver(request, REPORT_KIND, request.status),
+		messages() {
+			return options.delivery.inbox().filter((entry) => entry.kind === MESSAGE_KIND || entry.kind === REPORT_KIND).filter((entry) => {
+				const groupId = entry.metadata.groupId;
+				return groupId !== void 0 && options.groups.get(groupId)?.members.includes(options.selfReference) === true;
+			}).flatMap((entry) => {
+				const sourceReference = entry.metadata.sourceReference;
+				const targetReference = entry.metadata.targetReference;
+				const groupId = entry.metadata.groupId;
+				if (!sourceReference || !targetReference || !groupId) return [];
+				const reportStatus = entry.metadata.reportStatus;
+				return [{
+					deliveryId: entry.deliveryId,
+					sourceReference,
+					targetReference,
+					groupId,
+					...entry.metadata.correlationId === void 0 ? {} : { correlationId: entry.metadata.correlationId },
+					text: entry.prompt,
+					...reportStatus === "done" || reportStatus === "blocked" || reportStatus === "failed" ? { reportStatus } : {},
+					state: entry.state,
+					consumed: entry.consumed
+				}];
+			});
+		},
+		delivery(deliveryId) {
+			const entry = options.delivery.outbox(deliveryId);
+			const groupId = entry?.metadata.groupId;
+			return entry && groupId !== void 0 && options.groups.get(groupId)?.members.includes(options.selfReference) === true ? entry : void 0;
+		}
+	});
+}
+/** Builds the dynamic delivery check used before every send, retry, and recipient acceptance. */
+function createSessionGroupDeliveryAuthorizer(options) {
+	return (peerKey, metadata) => {
+		const sourceReference = metadata?.sourceReference;
+		const targetReference = metadata?.targetReference;
+		const groupId = metadata?.groupId;
+		if (sourceReference && targetReference && groupId) {
+			const peerReference = options.peerReference(peerKey);
+			if (!peerReference) return false;
+			return (sourceReference === options.selfReference && targetReference === peerReference || targetReference === options.selfReference && sourceReference === peerReference) && options.groups.canMessage(groupId, sourceReference, targetReference);
+		}
+		return options.fallback?.(peerKey, metadata) === true;
+	};
+}
+//#endregion
+exports.DOOM_SESSION_INTERCOM_SERVICE = require_type.DOOM_SESSION_INTERCOM_SERVICE;
+exports.createSessionGroupDeliveryAuthorizer = createSessionGroupDeliveryAuthorizer;
+exports.createSessionIntercom = createSessionIntercom;
+exports.readSessionIntercom = require_type.readSessionIntercom;
+exports.requireSessionIntercom = require_type.requireSessionIntercom;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/sessionIntercom/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/sessionIntercom/index.ts"],"sourcesContent":["import type { DoomSessionDeliveryMetadata } from '../sessionDelivery';\nimport type { SessionIntercomMessage } from './type';\nimport type {\n  SessionGroupDeliveryAuthorizationOptions,\n  SessionIntercom,\n  SessionIntercomOptions,\n  SessionIntercomSendRequest,\n  SessionReportStatus,\n} from './type';\n\nconst MESSAGE_KIND = 'session-message';\nconst REPORT_KIND = 'session-report';\n\nfunction metadataFor(\n  options: SessionIntercomOptions,\n  request: SessionIntercomSendRequest,\n  reportStatus?: SessionReportStatus,\n): DoomSessionDeliveryMetadata {\n  const group = options.groups.get(request.groupId);\n  if (!group || !options.groups.canMessage(request.groupId, options.selfReference, request.targetReference))\n    throw new Error(`Session group '${request.groupId}' does not authorize this message.`);\n  return {\n    sourceReference: options.selfReference,\n    targetReference: request.targetReference,\n    groupId: request.groupId,\n    groupRevision: String(group.revision),\n    ...(request.correlationId === undefined ? {} : { correlationId: request.correlationId }),\n    ...(reportStatus === undefined ? {} : { reportStatus }),\n  };\n}\n\n/** Agent-facing intercom operations. A composition may acquire this service without gaining session controls. */\nexport function createSessionIntercom(options: SessionIntercomOptions): SessionIntercom {\n  const deliver = async (\n    request: SessionIntercomSendRequest,\n    kind: typeof MESSAGE_KIND | typeof REPORT_KIND,\n    status?: SessionReportStatus,\n  ): Promise<{ deliveryId: string }> => {\n    const recipientKey = options.directory.resolveDeliveryTarget(options.selfReference, request.targetReference);\n    if (!recipientKey) throw new Error(`Session '${request.targetReference}' is not discoverable.`);\n    const metadata = metadataFor(options, request, status);\n    return options.delivery.deliver({\n      ...(request.deliveryId === undefined ? {} : { deliveryId: request.deliveryId }),\n      recipientKey,\n      kind,\n      prompt: `[Session ${status === undefined ? 'message' : `report: ${status}`} from ${options.selfReference}] ${request.text}`,\n      metadata,\n    });\n  };\n\n  const intercom: SessionIntercom = {\n    discover() {\n      const members = new Set(\n        options.groups\n          .groupsFor(options.selfReference)\n          .flatMap((group) => group.members)\n          .filter((reference) => reference !== options.selfReference),\n      );\n      return options.directory.discover(options.selfReference, members);\n    },\n    send: (request) => deliver(request, MESSAGE_KIND),\n    report: (request) => deliver(request, REPORT_KIND, request.status),\n    messages() {\n      return options.delivery\n        .inbox()\n        .filter((entry) => entry.kind === MESSAGE_KIND || entry.kind === REPORT_KIND)\n        .filter((entry) => {\n          const groupId = entry.metadata.groupId;\n          return groupId !== undefined && options.groups.get(groupId)?.members.includes(options.selfReference) === true;\n        })\n        .flatMap((entry): SessionIntercomMessage[] => {\n          const sourceReference = entry.metadata.sourceReference;\n          const targetReference = entry.metadata.targetReference;\n          const groupId = entry.metadata.groupId;\n          if (!sourceReference || !targetReference || !groupId) return [];\n          const reportStatus = entry.metadata.reportStatus;\n          return [\n            {\n              deliveryId: entry.deliveryId,\n              sourceReference,\n              targetReference,\n              groupId,\n              ...(entry.metadata.correlationId === undefined ? {} : { correlationId: entry.metadata.correlationId }),\n              text: entry.prompt,\n              ...(reportStatus === 'done' || reportStatus === 'blocked' || reportStatus === 'failed'\n                ? { reportStatus }\n                : {}),\n              state: entry.state,\n              consumed: entry.consumed,\n            },\n          ];\n        });\n    },\n    delivery(deliveryId) {\n      const entry = options.delivery.outbox(deliveryId);\n      const groupId = entry?.metadata.groupId;\n      return entry &&\n        groupId !== undefined &&\n        options.groups.get(groupId)?.members.includes(options.selfReference) === true\n        ? entry\n        : undefined;\n    },\n  };\n  return Object.freeze(intercom);\n}\n\n/** Builds the dynamic delivery check used before every send, retry, and recipient acceptance. */\nexport function createSessionGroupDeliveryAuthorizer(\n  options: SessionGroupDeliveryAuthorizationOptions,\n): (peerKey: string, metadata: DoomSessionDeliveryMetadata | undefined) => boolean {\n  return (peerKey, metadata) => {\n    const sourceReference = metadata?.sourceReference;\n    const targetReference = metadata?.targetReference;\n    const groupId = metadata?.groupId;\n    if (sourceReference && targetReference && groupId) {\n      const peerReference = options.peerReference(peerKey);\n      if (!peerReference) return false;\n      const directionMatches =\n        (sourceReference === options.selfReference && targetReference === peerReference) ||\n        (targetReference === options.selfReference && sourceReference === peerReference);\n      return directionMatches && options.groups.canMessage(groupId, sourceReference, targetReference);\n    }\n    return options.fallback?.(peerKey, metadata) === true;\n  };\n}\n\nexport { DOOM_SESSION_INTERCOM_SERVICE, readSessionIntercom, requireSessionIntercom } from './type';\nexport type {\n  SessionGroupDeliveryAuthorizationOptions,\n  SessionIntercom,\n  SessionIntercomMessage,\n  SessionIntercomOptions,\n  SessionIntercomSendRequest,\n  SessionReportStatus,\n} from './type';\n"],"mappings":";;AAUA,MAAM,eAAe;AACrB,MAAM,cAAc;AAEpB,SAAS,YACP,SACA,SACA,cAC6B;CAC7B,MAAM,QAAQ,QAAQ,OAAO,IAAI,QAAQ,OAAO;CAChD,IAAI,CAAC,SAAS,CAAC,QAAQ,OAAO,WAAW,QAAQ,SAAS,QAAQ,eAAe,QAAQ,eAAe,GACtG,MAAM,IAAI,MAAM,kBAAkB,QAAQ,QAAQ,mCAAmC;CACvF,OAAO;EACL,iBAAiB,QAAQ;EACzB,iBAAiB,QAAQ;EACzB,SAAS,QAAQ;EACjB,eAAe,OAAO,MAAM,QAAQ;EACpC,GAAI,QAAQ,kBAAkB,KAAA,IAAY,CAAC,IAAI,EAAE,eAAe,QAAQ,cAAc;EACtF,GAAI,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa;CACvD;AACF;;AAGA,SAAgB,sBAAsB,SAAkD;CACtF,MAAM,UAAU,OACd,SACA,MACA,WACoC;EACpC,MAAM,eAAe,QAAQ,UAAU,sBAAsB,QAAQ,eAAe,QAAQ,eAAe;EAC3G,IAAI,CAAC,cAAc,MAAM,IAAI,MAAM,YAAY,QAAQ,gBAAgB,uBAAuB;EAC9F,MAAM,WAAW,YAAY,SAAS,SAAS,MAAM;EACrD,OAAO,QAAQ,SAAS,QAAQ;GAC9B,GAAI,QAAQ,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,QAAQ,WAAW;GAC7E;GACA;GACA,QAAQ,YAAY,WAAW,KAAA,IAAY,YAAY,WAAW,SAAS,QAAQ,QAAQ,cAAc,IAAI,QAAQ;GACrH;EACF,CAAC;CACH;CAuDA,OAAO,OAAO,OAAO;EApDnB,WAAW;GACT,MAAM,UAAU,IAAI,IAClB,QAAQ,OACL,UAAU,QAAQ,aAAa,CAAC,CAChC,SAAS,UAAU,MAAM,OAAO,CAAC,CACjC,QAAQ,cAAc,cAAc,QAAQ,aAAa,CAC9D;GACA,OAAO,QAAQ,UAAU,SAAS,QAAQ,eAAe,OAAO;EAClE;EACA,OAAO,YAAY,QAAQ,SAAS,YAAY;EAChD,SAAS,YAAY,QAAQ,SAAS,aAAa,QAAQ,MAAM;EACjE,WAAW;GACT,OAAO,QAAQ,SACZ,MAAM,CAAC,CACP,QAAQ,UAAU,MAAM,SAAS,gBAAgB,MAAM,SAAS,WAAW,CAAC,CAC5E,QAAQ,UAAU;IACjB,MAAM,UAAU,MAAM,SAAS;IAC/B,OAAO,YAAY,KAAA,KAAa,QAAQ,OAAO,IAAI,OAAO,CAAC,EAAE,QAAQ,SAAS,QAAQ,aAAa,MAAM;GAC3G,CAAC,CAAC,CACD,SAAS,UAAoC;IAC5C,MAAM,kBAAkB,MAAM,SAAS;IACvC,MAAM,kBAAkB,MAAM,SAAS;IACvC,MAAM,UAAU,MAAM,SAAS;IAC/B,IAAI,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,SAAS,OAAO,CAAC;IAC9D,MAAM,eAAe,MAAM,SAAS;IACpC,OAAO,CACL;KACE,YAAY,MAAM;KAClB;KACA;KACA;KACA,GAAI,MAAM,SAAS,kBAAkB,KAAA,IAAY,CAAC,IAAI,EAAE,eAAe,MAAM,SAAS,cAAc;KACpG,MAAM,MAAM;KACZ,GAAI,iBAAiB,UAAU,iBAAiB,aAAa,iBAAiB,WAC1E,EAAE,aAAa,IACf,CAAC;KACL,OAAO,MAAM;KACb,UAAU,MAAM;IAClB,CACF;GACF,CAAC;EACL;EACA,SAAS,YAAY;GACnB,MAAM,QAAQ,QAAQ,SAAS,OAAO,UAAU;GAChD,MAAM,UAAU,OAAO,SAAS;GAChC,OAAO,SACL,YAAY,KAAA,KACZ,QAAQ,OAAO,IAAI,OAAO,CAAC,EAAE,QAAQ,SAAS,QAAQ,aAAa,MAAM,OACvE,QACA,KAAA;EACN;CAE0B,CAAC;AAC/B;;AAGA,SAAgB,qCACd,SACiF;CACjF,QAAQ,SAAS,aAAa;EAC5B,MAAM,kBAAkB,UAAU;EAClC,MAAM,kBAAkB,UAAU;EAClC,MAAM,UAAU,UAAU;EAC1B,IAAI,mBAAmB,mBAAmB,SAAS;GACjD,MAAM,gBAAgB,QAAQ,cAAc,OAAO;GACnD,IAAI,CAAC,eAAe,OAAO;GAI3B,QAFG,oBAAoB,QAAQ,iBAAiB,oBAAoB,iBACjE,oBAAoB,QAAQ,iBAAiB,oBAAoB,kBACzC,QAAQ,OAAO,WAAW,SAAS,iBAAiB,eAAe;EAChG;EACA,OAAO,QAAQ,WAAW,SAAS,QAAQ,MAAM;CACnD;AACF"}

package/dist/src/services/sessionIntercom/index.d.cts

@@ -0,0 +1,11 @@
+import { DoomSessionDeliveryMetadata } from "../sessionDelivery/type.cjs";
+import "../sessionDelivery/index.cjs";
+import { DOOM_SESSION_INTERCOM_SERVICE, SessionGroupDeliveryAuthorizationOptions, SessionIntercom, SessionIntercomMessage, SessionIntercomOptions, SessionIntercomSendRequest, SessionReportStatus, readSessionIntercom, requireSessionIntercom } from "./type.cjs";
+//#region src/services/sessionIntercom/index.d.ts
+/** Agent-facing intercom operations. A composition may acquire this service without gaining session controls. */
+export declare function createSessionIntercom(options: SessionIntercomOptions): SessionIntercom;
+/** Builds the dynamic delivery check used before every send, retry, and recipient acceptance. */
+export declare function createSessionGroupDeliveryAuthorizer(options: SessionGroupDeliveryAuthorizationOptions): (peerKey: string, metadata: DoomSessionDeliveryMetadata | undefined) => boolean;
+//#endregion
+export { DOOM_SESSION_INTERCOM_SERVICE, type SessionGroupDeliveryAuthorizationOptions, type SessionIntercom, type SessionIntercomMessage, type SessionIntercomOptions, type SessionIntercomSendRequest, type SessionReportStatus, readSessionIntercom, requireSessionIntercom };
+//# sourceMappingURL=index.d.cts.map

package/dist/src/services/sessionIntercom/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../../src/services/sessionIntercom/index.ts"],"mappings":";;;;;wBAgCgB,sBAAsB,SAAS,yBAAyB;;wBA2ExD,qCACd,SAAS,4CACP,iBAAiB,UAAU"}

package/dist/src/services/sessionIntercom/index.d.mts

@@ -0,0 +1,11 @@
+import { DoomSessionDeliveryMetadata } from "../sessionDelivery/type.mjs";
+import "../sessionDelivery/index.mjs";
+import { DOOM_SESSION_INTERCOM_SERVICE, SessionGroupDeliveryAuthorizationOptions, SessionIntercom, SessionIntercomMessage, SessionIntercomOptions, SessionIntercomSendRequest, SessionReportStatus, readSessionIntercom, requireSessionIntercom } from "./type.mjs";
+//#region src/services/sessionIntercom/index.d.ts
+/** Agent-facing intercom operations. A composition may acquire this service without gaining session controls. */
+export declare function createSessionIntercom(options: SessionIntercomOptions): SessionIntercom;
+/** Builds the dynamic delivery check used before every send, retry, and recipient acceptance. */
+export declare function createSessionGroupDeliveryAuthorizer(options: SessionGroupDeliveryAuthorizationOptions): (peerKey: string, metadata: DoomSessionDeliveryMetadata | undefined) => boolean;
+//#endregion
+export { DOOM_SESSION_INTERCOM_SERVICE, type SessionGroupDeliveryAuthorizationOptions, type SessionIntercom, type SessionIntercomMessage, type SessionIntercomOptions, type SessionIntercomSendRequest, type SessionReportStatus, readSessionIntercom, requireSessionIntercom };
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/sessionIntercom/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/sessionIntercom/index.ts"],"mappings":";;;;;wBAgCgB,sBAAsB,SAAS,yBAAyB;;wBA2ExD,qCACd,SAAS,4CACP,iBAAiB,UAAU"}