@lssm/lib.communication-spec 3.1.1

package/dist/contracts/ecosystem-identity.operations.d.ts

@@ -0,0 +1,174 @@
+import { type DocBlock } from '@lssm/lib.contracts-spec';
+export declare const CommunicationIdentityDocBlock: DocBlock;
+export declare const CommunicationIdentityReviewStatusEnum: import("@lssm/lib.schema").EnumType<[string, string, string]>;
+export declare const CommunicationAccountV2Model: import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    network: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    externalAccountRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    placement: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    health: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    updatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>;
+export declare const CommunicationContactV2Model: import("@lssm/lib.schema").SchemaModel<{
+    principalId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    displayName: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    roomIds: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: false;
+    };
+    messageCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    lastSeenAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>;
+export declare const ListCommunicationAccountsV2Query: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    workspaceId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    spaceId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    accounts: {
+        type: import("@lssm/lib.schema").SchemaModel<{
+            id: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            network: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            externalAccountRef: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            placement: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            health: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            createdAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: false;
+            };
+            updatedAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: false;
+            };
+        }>;
+        isArray: true;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const ListCommunicationContactsV2Query: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    workspaceId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    spaceId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    contacts: {
+        type: import("@lssm/lib.schema").SchemaModel<{
+            principalId: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            displayName: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            roomIds: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isArray: true;
+                isOptional: false;
+            };
+            messageCount: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: false;
+            };
+            lastSeenAt: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: false;
+            };
+        }>;
+        isArray: true;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const DecideCommunicationIdentityV1Command: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    reviewId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    decision: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string]>;
+        isOptional: false;
+    };
+    reason: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    reviewId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string]>;
+        isOptional: false;
+    };
+    revision: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+}>, undefined>;

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

@@ -0,0 +1,2 @@
+// @bun
+import{defineCommand as O,defineQuery as p,docId as S}from"@lssm/lib.contracts-spec";import{defineEnum as _,defineSchemaModel as o,ScalarTypeEnum as t}from"@lssm/lib.schema";import{defineEnum as n,defineSchemaModel as i,ScalarTypeEnum as e}from"@lssm/lib.schema";var u=n("CommunicationSpaceKind",["personal","organization"]),l=n("CommunicationPrincipalKind",["human","agent","system"]),m=n("CommunicationConnectionPlacement",["device","managed_cloud","self_hosted"]),A=n("CommunicationConnectionNetwork",["email","sms","slack","teams","telegram","whatsapp","discord","matrix"]),d=n("CommunicationEncryptionMode",["client_encrypted","governed_server_indexable"]),y=n("CommunicationMembershipState",["active","revoked"]),k=n("CommunicationReceiptKind",["delivered","read"]),f=n("CommunicationConnectionHealth",["connecting","healthy","degraded","offline","revoked"]),V={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"},a=i({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}}}),D=i({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:u,isOptional:!1},encryptionMode:{type:d,isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),w=i({name:"CommunicationPrincipalV2",description:"Auditable human, agent, or system identity",fields:{id:{type:e.String_unsecure(),isOptional:!1},kind:{type:l,isOptional:!1},displayName:{type:e.String_unsecure(),isOptional:!1},ownerPrincipalId:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),M=i({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}}}),T=i({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:y,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}}}),E=i({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:m,isOptional:!1},externalAccountRef:{type:e.String_unsecure(),isOptional:!1},credentialRef:{type:e.String_unsecure(),isOptional:!1},health:{type:f,isOptional:!1},capabilities:{type:e.String_unsecure(),isArray:!0,isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),g=i({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=i({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:g,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}}}),P=i({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 s=["platform.communication-os"],C={id:"communication-os.identity-resolution.v1",title:"CommunicationOS identity resolution contracts",body:"Scope-isolated account and contact projections plus a human-reviewed identity merge or rejection lifecycle. Provider credentials and raw identity evidence never enter public outputs.",kind:"reference",route:"/docs/communication-os/identity-resolution-v1",visibility:"public"},r=[S(C.id)],c=_("CommunicationIdentityReviewStatus",["pending","merged","rejected"]),h=o({name:"CommunicationAccountV2",description:"Public-safe provider account projection in one authorized space",fields:{id:{type:t.String_unsecure(),isOptional:!1},network:{type:t.String_unsecure(),isOptional:!1},externalAccountRef:{type:t.String_unsecure(),isOptional:!1},placement:{type:t.String_unsecure(),isOptional:!1},health:{type:t.String_unsecure(),isOptional:!1},createdAt:{type:t.DateTime(),isOptional:!1},updatedAt:{type:t.DateTime(),isOptional:!1}}}),I=o({name:"CommunicationContactV2",description:"Participant projection derived from persisted scoped messages",fields:{principalId:{type:t.String_unsecure(),isOptional:!1},displayName:{type:t.String_unsecure(),isOptional:!0},roomIds:{type:t.String_unsecure(),isArray:!0,isOptional:!1},messageCount:{type:t.Int_unsecure(),isOptional:!1},lastSeenAt:{type:t.DateTime(),isOptional:!1}}}),v=o({name:"ListCommunicationAccountsV2Output",fields:{accounts:{type:h,isArray:!0,isOptional:!1}}}),x=o({name:"ListCommunicationContactsV2Output",fields:{contacts:{type:I,isArray:!0,isOptional:!1}}}),K=p({meta:{key:"communication.account.list",version:"2.0.0",stability:"experimental",owners:[...s],tags:["communication","account","identity"],description:"List public-safe provider accounts in one authorized space",goal:"Expose account readiness without leaking credential references",context:"Authority is derived by the server from the authenticated scope",docId:r},io:{input:a,output:v},policy:{auth:"user"}}),N=p({meta:{key:"communication.contact.list",version:"2.0.0",stability:"experimental",owners:[...s],tags:["communication","contact","identity"],description:"List persisted participant projections in one authorized space",goal:"Provide a real scoped contact index without provider identity leakage",context:"Contacts are replayable projections, never transient UI inference",docId:r},io:{input:a,output:x},policy:{auth:"user"}}),Q=O({meta:{key:"communication.identity.decide",version:"1.0.0",stability:"experimental",owners:[...s],tags:["communication","identity","review","governance"],description:"Merge or reject one pending identity review",goal:"Require an auditable human decision before cross-channel identity linkage",context:"Only authorized managers may decide and each review is single-transition",docId:r},io:{input:o({name:"DecideCommunicationIdentityV1Input",fields:{reviewId:{type:t.String_unsecure(),isOptional:!1},decision:{type:c,isOptional:!1},reason:{type:t.String_unsecure(),isOptional:!0}}}),output:o({name:"DecideCommunicationIdentityV1Output",fields:{reviewId:{type:t.String_unsecure(),isOptional:!1},status:{type:c,isOptional:!1},revision:{type:t.Int_unsecure(),isOptional:!1}}})},policy:{auth:"admin"}});export{h as CommunicationAccountV2Model,I as CommunicationContactV2Model,C as CommunicationIdentityDocBlock,c as CommunicationIdentityReviewStatusEnum,Q as DecideCommunicationIdentityV1Command,K as ListCommunicationAccountsV2Query,N as ListCommunicationContactsV2Query};

package/dist/contracts/ecosystem-identity.operations.test.d.ts

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