@lssm/lib.communication-spec 3.1.1

package/dist/contracts/ecosystem-message.operations.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineCommand as c,defineQuery as y,docId as b}from"@lssm/lib.contracts-spec";import{defineSchemaModel as s,ScalarTypeEnum as t}from"@lssm/lib.schema";import{defineEnum as o,defineSchemaModel as n,ScalarTypeEnum as e}from"@lssm/lib.schema";var h=o("CommunicationSpaceKind",["personal","organization"]),S=o("CommunicationPrincipalKind",["human","agent","system"]),_=o("CommunicationConnectionPlacement",["device","managed_cloud","self_hosted"]),V=o("CommunicationConnectionNetwork",["email","sms","slack","teams","telegram","whatsapp","discord","matrix"]),I=o("CommunicationEncryptionMode",["client_encrypted","governed_server_indexable"]),C=o("CommunicationMembershipState",["active","revoked"]),p=o("CommunicationReceiptKind",["delivered","read"]),v=o("CommunicationConnectionHealth",["connecting","healthy","degraded","offline","revoked"]),u={id:"communication-os.ecosystem-messaging.v2",title:"CommunicationOS ecosystem messaging contracts",body:"Versioned, workspace-scoped contracts for personal and organization spaces, rooms, human and agent membership, hybrid channel connections, synchronized messages, and revocable outbound authority. CommunicationSpec remains canonical; provider protocols are adapters. V1 thread and draft-only operations remain unchanged.",kind:"reference",route:"/docs/communication-os/ecosystem-messaging-v2",visibility:"public"},T=n({name:"CommunicationScopeV2",description:"Strict tenant, workspace, and space boundary for messaging state",fields:{tenantId:{type:e.String_unsecure(),isOptional:!1},workspaceId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!1}}}),E=n({name:"CommunicationSpaceV2",description:"Personal or organization messaging boundary under one account",fields:{id:{type:e.String_unsecure(),isOptional:!1},tenantId:{type:e.String_unsecure(),isOptional:!1},workspaceId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},kind:{type:h,isOptional:!1},encryptionMode:{type:I,isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),R=n({name:"CommunicationPrincipalV2",description:"Auditable human, agent, or system identity",fields:{id:{type:e.String_unsecure(),isOptional:!1},kind:{type:S,isOptional:!1},displayName:{type:e.String_unsecure(),isOptional:!1},ownerPrincipalId:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),D=n({name:"CommunicationRoomV2",description:"Room or direct-message projection inside one space",fields:{id:{type:e.String_unsecure(),isOptional:!1},tenantId:{type:e.String_unsecure(),isOptional:!1},workspaceId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!0},roomKind:{type:e.String_unsecure(),isOptional:!1},connectionIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),N=n({name:"CommunicationRoomMembershipV2",description:"Revocable principal membership and room-scoped capabilities",fields:{id:{type:e.String_unsecure(),isOptional:!1},tenantId:{type:e.String_unsecure(),isOptional:!1},workspaceId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!1},roomId:{type:e.String_unsecure(),isOptional:!1},principalId:{type:e.String_unsecure(),isOptional:!1},role:{type:e.String_unsecure(),isOptional:!1},state:{type:C,isOptional:!1},capabilities:{type:e.String_unsecure(),isArray:!0,isOptional:!1},expiresAt:{type:e.DateTime(),isOptional:!0},revokedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),P=n({name:"CommunicationChannelConnectionV2",description:"Credential-reference-only local, managed, or self-hosted channel connection",fields:{id:{type:e.String_unsecure(),isOptional:!1},tenantId:{type:e.String_unsecure(),isOptional:!1},workspaceId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!1},network:{type:e.String_unsecure(),isOptional:!1},placement:{type:_,isOptional:!1},externalAccountRef:{type:e.String_unsecure(),isOptional:!1},credentialRef:{type:e.String_unsecure(),isOptional:!1},health:{type:v,isOptional:!1},capabilities:{type:e.String_unsecure(),isArray:!0,isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),x=n({name:"CommunicationAttachmentV2",description:"Public-safe metadata for an opaque, scope-bound message attachment",fields:{id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},mimeType:{type:e.String_unsecure(),isOptional:!1},sizeBytes:{type:e.Int_unsecure(),isOptional:!1},sha256:{type:e.String_unsecure(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),r=n({name:"CommunicationMessageV2",description:"Canonical room message with explicit author and encryption posture",fields:{id:{type:e.String_unsecure(),isOptional:!1},tenantId:{type:e.String_unsecure(),isOptional:!1},workspaceId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!1},roomId:{type:e.String_unsecure(),isOptional:!1},authorPrincipalId:{type:e.String_unsecure(),isOptional:!1},connectionId:{type:e.String_unsecure(),isOptional:!0},externalMessageId:{type:e.String_unsecure(),isOptional:!0},body:{type:e.String_unsecure(),isOptional:!0},encryptedEnvelope:{type:e.JSONObject(),isOptional:!0},attachments:{type:x,isArray:!0,isOptional:!0},replyToMessageId:{type:e.String_unsecure(),isOptional:!0},revision:{type:e.Int_unsecure(),isOptional:!1},deletedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),z=n({name:"CommunicationAuthorityGrantV2",description:"Explicit, revocable messaging authority granted to one principal",fields:{id:{type:e.String_unsecure(),isOptional:!1},tenantId:{type:e.String_unsecure(),isOptional:!1},workspaceId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!1},roomId:{type:e.String_unsecure(),isOptional:!0},connectionId:{type:e.String_unsecure(),isOptional:!0},principalId:{type:e.String_unsecure(),isOptional:!1},capabilities:{type:e.String_unsecure(),isArray:!0,isOptional:!1},grantedBy:{type:e.String_unsecure(),isOptional:!1},expiresAt:{type:e.DateTime(),isOptional:!0},revokedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}});var i=["platform.communication-os"],a=[b(u.id)],g={VALIDATION_FAILED:{description:"Message content, replay key, or attachment references are invalid.",http:422,when:"The request is malformed, empty, duplicated, or exceeds a declared limit."},FORBIDDEN:{description:"The authenticated principal cannot access or mutate the selected room.",http:403,when:"Workspace, space, room membership, connection binding, or send authority is absent."},SERVICE_UNAVAILABLE:{description:"The scoped messaging runtime or search projection is unavailable.",http:503,when:"A required durable runtime dependency cannot safely answer the operation."}},U=c({meta:{key:"communication.message.send",version:"2.1.0",stability:"experimental",owners:[...i],tags:["communication","message","send","authority"],description:"Send a canonical room message as an explicitly attributed principal",goal:"Give authorized humans and agents the same audited messaging path",context:"The runtime must re-evaluate membership, authority, consent, encryption posture, and connection policy immediately before dispatch",docId:a},io:{input:r,output:r},policy:{auth:"user"}}),k=s({name:"SendCommunicationMessageV3Input",fields:{workspaceId:{type:t.String_unsecure(),isOptional:!1},spaceId:{type:t.String_unsecure(),isOptional:!1},roomId:{type:t.String_unsecure(),isOptional:!1},connectionId:{type:t.String_unsecure(),isOptional:!0},idempotencyKey:{type:t.String_unsecure(),isOptional:!1},body:{type:t.String_unsecure(),isOptional:!0},encryptedEnvelope:{type:t.JSONObject(),isOptional:!0},attachmentIds:{type:t.String_unsecure(),isArray:!0,isOptional:!0},replyToMessageId:{type:t.String_unsecure(),isOptional:!0}}}),L=c({meta:{key:"communication.message.send",version:"3.0.0",stability:"experimental",owners:[...i],tags:["communication","message","send","authority","idempotency"],description:"Send a canonical room message from a JSON-safe, replay-safe client intent",goal:"Keep tenant, author, revision, identifiers, and timestamps server-owned",context:"The runtime derives tenant and author from the authenticated context, verifies workspace/space/room membership and attachment ownership, then applies the idempotency key before dispatch",docId:a},io:{input:k,output:r,errors:g},policy:{auth:"user"}}),f=s({name:"MutateCommunicationMessageV2Input",fields:{tenantId:{type:t.String_unsecure(),isOptional:!1},workspaceId:{type:t.String_unsecure(),isOptional:!1},spaceId:{type:t.String_unsecure(),isOptional:!1},roomId:{type:t.String_unsecure(),isOptional:!1},messageId:{type:t.String_unsecure(),isOptional:!1},actorPrincipalId:{type:t.String_unsecure(),isOptional:!1},body:{type:t.String_unsecure(),isOptional:!0},encryptedEnvelope:{type:t.JSONObject(),isOptional:!0},expectedRevision:{type:t.Int_unsecure(),isOptional:!1}}}),G=c({meta:{key:"communication.message.edit",version:"2.0.0",stability:"experimental",owners:[...i],tags:["communication","message","edit"],description:"Edit a message with optimistic revision protection",goal:"Preserve provider edits in the canonical event journal without rewriting history",context:"Unsupported provider edits must return an explicit capability error rather than silently diverge",docId:a},io:{input:f,output:r},policy:{auth:"user"}}),Q=c({meta:{key:"communication.message.delete",version:"2.0.0",stability:"experimental",owners:[...i],tags:["communication","message","delete"],description:"Append an auditable message deletion or provider-retention marker",goal:"Represent local and provider deletion honestly across heterogeneous networks",context:"The event journal retains non-content evidence even when message content is erased",docId:a},io:{input:f,output:r},policy:{auth:"user"}}),l=s({name:"CommunicationReactionV2Input",fields:{tenantId:{type:t.String_unsecure(),isOptional:!1},workspaceId:{type:t.String_unsecure(),isOptional:!1},spaceId:{type:t.String_unsecure(),isOptional:!1},roomId:{type:t.String_unsecure(),isOptional:!1},messageId:{type:t.String_unsecure(),isOptional:!1},principalId:{type:t.String_unsecure(),isOptional:!1},reaction:{type:t.String_unsecure(),isOptional:!1},active:{type:t.Boolean(),isOptional:!1}}}),J=c({meta:{key:"communication.reaction.set",version:"2.0.0",stability:"experimental",owners:[...i],tags:["communication","message","reaction"],description:"Add or remove a reaction on a canonical message",goal:"Normalize lightweight acknowledgement across supported networks",context:"Adapters report unsupported reactions explicitly",docId:a},io:{input:l,output:l},policy:{auth:"user"}}),m=s({name:"CommunicationReceiptV2Input",fields:{tenantId:{type:t.String_unsecure(),isOptional:!1},workspaceId:{type:t.String_unsecure(),isOptional:!1},spaceId:{type:t.String_unsecure(),isOptional:!1},roomId:{type:t.String_unsecure(),isOptional:!1},messageId:{type:t.String_unsecure(),isOptional:!1},principalId:{type:t.String_unsecure(),isOptional:!1},kind:{type:p,isOptional:!1},occurredAt:{type:t.DateTime(),isOptional:!1}}}),F=c({meta:{key:"communication.receipt.record",version:"2.0.0",stability:"experimental",owners:[...i],tags:["communication","message","receipt"],description:"Record a delivered or read receipt",goal:"Keep unread and delivery projections consistent across clients",context:"Privacy policy may suppress outbound read receipts per space or connection",docId:a},io:{input:m,output:m},policy:{auth:"user"}}),d=s({name:"CommunicationInboxStateV2Input",fields:{tenantId:{type:t.String_unsecure(),isOptional:!1},workspaceId:{type:t.String_unsecure(),isOptional:!1},spaceId:{type:t.String_unsecure(),isOptional:!1},roomId:{type:t.String_unsecure(),isOptional:!1},principalId:{type:t.String_unsecure(),isOptional:!1},pinned:{type:t.Boolean(),isOptional:!1},archived:{type:t.Boolean(),isOptional:!1},snoozedUntil:{type:t.DateTime(),isOptional:!0},reminderAt:{type:t.DateTime(),isOptional:!0}}}),H=c({meta:{key:"communication.inbox-state.set",version:"2.0.0",stability:"experimental",owners:[...i],tags:["communication","inbox","pin","archive","snooze","reminder"],description:"Set one principal's pin, archive, snooze, and reminder state",goal:"Synchronize inbox organization without leaking message content",context:"Personal inbox state is principal-private even inside organization workspaces",docId:a},io:{input:d,output:d},policy:{auth:"user"}}),M=s({name:"SearchCommunicationMessagesV2Input",fields:{tenantId:{type:t.String_unsecure(),isOptional:!1},workspaceId:{type:t.String_unsecure(),isOptional:!1},spaceId:{type:t.String_unsecure(),isOptional:!1},query:{type:t.String_unsecure(),isOptional:!1},roomIds:{type:t.String_unsecure(),isArray:!0,isOptional:!0},limit:{type:t.Int_unsecure(),isOptional:!0}}}),O=s({name:"SearchCommunicationMessagesV2Output",fields:{messages:{type:r,isArray:!0,isOptional:!1},nextCursor:{type:t.String_unsecure(),isOptional:!0}}}),Y=y({meta:{key:"communication.message.search",version:"2.0.0",stability:"experimental",owners:[...i],tags:["communication","message","search"],description:"Search messages within exactly one authorized space",goal:"Provide cross-network search without cross-space index leakage",context:"Client-encrypted spaces search a local decrypted projection; server-indexable spaces use governed indexes",docId:a},io:{input:M,output:O},policy:{auth:"user"}}),A=s({name:"SearchCommunicationMessagesV3Input",fields:{workspaceId:{type:t.String_unsecure(),isOptional:!1},spaceId:{type:t.String_unsecure(),isOptional:!1},query:{type:t.String_unsecure(),isOptional:!1},roomIds:{type:t.String_unsecure(),isArray:!0,isOptional:!0},limit:{type:t.Int_unsecure(),isOptional:!0}}}),W=y({meta:{key:"communication.message.search",version:"3.0.0",stability:"experimental",owners:[...i],tags:["communication","message","search","authority"],description:"Search messages inside the authenticated tenant and an authorized selected space",goal:"Remove client-supplied tenant authority from canonical search transport",context:"The runtime derives tenant from the authenticated context and verifies workspace, space, and optional room filters before querying any index",docId:a},io:{input:A,output:O,errors:g},policy:{auth:"user"}}),X={key:"communication.message.replay-authority",version:"1.0.0",invariants:["Recheck current room membership and connection authority before returning a prior send result.","A request key cannot substitute principal, room, connection, text, subject, HTML, metadata, encryption envelope, reply target or attachment IDs.","Queued acceptance is not provider delivery.","Requested attachments require a complete resolved manifest; missing attachment support must not silently send an incomplete message."]},Z={key:"communication.message.queue-custody",version:"1.0.0",invariants:["An external send requires a durable journal-and-outbox adapter before it can be accepted.","Queued acceptance requires an exact persisted delivery record for the accepted message, connection and scope.","Outbox-key conflicts cannot silently drop provider delivery or report false success.","Message delivery uses delivery:<send idempotency key>; alternate delivery keys cannot duplicate a prior accepted message.","Message identity allocated by an atomic journal replay remains the delivery target; retries do not refer to discarded candidate IDs."]},ee={key:"communication.delivery.context-reproof",version:"1.0.0",invariants:["Resolve the current delivery context before adapter access and again after provider health checks immediately before send.","Changed recipient, connection, credential binding, content, reply, attachment or routing metadata invalidates the pending send.","Missing or changed context yields a definitive rejection without invoking provider.send.","Journal delivery resolution requires current active sender membership and applicable agent grants; revoked or deleted messages cannot resolve for sending.","Context reproof supplements canonical Runtime Node authority and does not replace its approval or effect fence."]};export{ee as COMMUNICATION_DELIVERY_REPROOF_CONTRACT,Z as COMMUNICATION_MESSAGE_QUEUE_CUSTODY_CONTRACT,X as COMMUNICATION_MESSAGE_REPLAY_CONTRACT,Q as DeleteCommunicationMessageV2Command,G as EditCommunicationMessageV2Command,F as RecordCommunicationReceiptV2Command,Y as SearchCommunicationMessagesV2Query,W as SearchCommunicationMessagesV3Query,U as SendCommunicationMessageV2Command,L as SendCommunicationMessageV3Command,k as SendCommunicationMessageV3Input,H as SetCommunicationInboxStateV2Command,J as SetCommunicationReactionV2Command};

package/dist/contracts/ecosystem-messaging.dtos.d.ts

@@ -0,0 +1,68 @@
+/** JSON-safe value types shared by CommunicationOS public transports. */
+export type CommunicationJsonPrimitiveDto = string | number | boolean | null;
+export type CommunicationJsonValueDto = CommunicationJsonPrimitiveDto | CommunicationJsonObjectDto | readonly CommunicationJsonValueDto[];
+export interface CommunicationJsonObjectDto {
+    readonly [key: string]: CommunicationJsonValueDto;
+}
+export interface CommunicationScopeV2Dto {
+    readonly tenantId: string;
+    readonly workspaceId: string;
+    readonly spaceId: string;
+}
+export interface CommunicationCursorV2Dto {
+    readonly sequence: number;
+    readonly opaque?: string;
+}
+export interface CommunicationApiRequestV2Dto<TBody = CommunicationJsonObjectDto> {
+    readonly scope: CommunicationScopeV2Dto;
+    readonly body?: TBody;
+    readonly idempotencyKey?: string;
+    readonly cursor?: CommunicationCursorV2Dto;
+}
+export interface CommunicationApiResultV2Dto<TData = CommunicationJsonValueDto> {
+    readonly data: TData;
+    readonly requestId: string;
+    readonly cursor?: CommunicationCursorV2Dto;
+}
+export type CommunicationApiErrorCodeV2Dto = 'authentication_required' | 'authorization_denied' | 'conflict' | 'invalid_cursor' | 'invalid_request' | 'not_found' | 'rate_limited' | 'unsupported_feature' | 'temporarily_unavailable';
+export interface CommunicationApiErrorV2Dto {
+    readonly code: CommunicationApiErrorCodeV2Dto;
+    readonly message: string;
+    readonly requestId: string;
+    readonly retryable: boolean;
+    readonly unsupportedFeature?: string;
+    readonly evidenceRefs: readonly string[];
+}
+export interface CommunicationJournalEventV2Dto extends CommunicationScopeV2Dto {
+    readonly id: string;
+    readonly sequence: number;
+    readonly kind: string;
+    readonly entityId: string;
+    readonly roomId?: string;
+    readonly actorPrincipalId: string;
+    readonly idempotencyKey: string;
+    readonly occurredAt: string;
+    readonly payload: CommunicationJsonObjectDto;
+    readonly evidenceRefs: readonly string[];
+}
+export interface CommunicationProjectionEntityV2Dto extends CommunicationScopeV2Dto {
+    readonly id: string;
+    readonly createdAt?: string;
+    readonly updatedAt: string;
+    readonly revision: number;
+    readonly attributes: CommunicationJsonObjectDto;
+}
+export interface CommunicationMessagingProjectionV2Dto {
+    readonly cursor: CommunicationCursorV2Dto;
+    readonly spaces: readonly CommunicationProjectionEntityV2Dto[];
+    readonly rooms: readonly CommunicationProjectionEntityV2Dto[];
+    readonly messages: readonly CommunicationProjectionEntityV2Dto[];
+    readonly memberships: readonly CommunicationProjectionEntityV2Dto[];
+    readonly connections: readonly CommunicationProjectionEntityV2Dto[];
+    readonly inboxStates: readonly CommunicationProjectionEntityV2Dto[];
+}
+export interface CommunicationRealtimeEventV2Dto {
+    readonly topic: string;
+    readonly cursor: CommunicationCursorV2Dto;
+    readonly event: CommunicationJournalEventV2Dto;
+}

package/dist/contracts/ecosystem-messaging.dtos.js

@@ -0,0 +1 @@
+// @bun

package/dist/contracts/ecosystem-messaging.dtos.test.d.ts

@@ -0,0 +1 @@
+export {};