@lssm/lib.communication-spec 3.1.1

package/dist/contracts/sequence-intent.d.ts

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+export declare const COMMUNICATION_SEQUENCE_INTENT_SCHEMA_VERSION: '1.0.0';
+export declare const COMMUNICATION_SEQUENCE_INTENT_SCHEMA_IDENTITY: 'communication.sequence-intent.v1|sequence,action-packet,recipient,content-proof,channel,side-effect,schedule,expiry,approval,policy|approval-bound,provider-neutral';
+export declare const COMMUNICATION_SEQUENCE_INTENT_SCHEMA_FINGERPRINT: 'sha256:7ef776396727b0e7ee015935d8f7d5f4605a08b815f6493aa737411490edc633';
+export declare const COMMUNICATION_SEQUENCE_APPROVAL_TARGET_VERSION: '1.0.0';
+export declare const COMMUNICATION_SEQUENCE_APPROVAL_TARGET_PAYLOAD_KEY: 'communicationSequenceApprovalTarget';
+export declare const COMMUNICATION_SEQUENCE_APPROVAL_FINGERPRINT_PAYLOAD_KEY: 'communicationSequenceApprovalFingerprint';
+export declare const COMMUNICATION_SEQUENCE_APPROVAL_EVIDENCE_PREFIX: 'communication-sequence-approval:';
+/** Exact content evidence approved for one scheduled communication sequence. */
+export declare const CommunicationSequenceContentProofSchema: z.ZodObject<{
+    contentRef: z.ZodString;
+    sha256: z.ZodString;
+}, z.core.$strip>;
+/** Canonical provider-neutral content bytes covered by the content proof. */
+export declare const CommunicationSequenceOutboundContentSchema: z.ZodObject<{
+    body: z.ZodString;
+    subject: z.ZodOptional<z.ZodString>;
+    htmlBody: z.ZodOptional<z.ZodString>;
+    replyToExternalMessageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Retry timing only; the runtime remains a pure state machine with no timer. */
+export declare const CommunicationSequenceSchedulePolicySchema: z.ZodObject<{
+    notBefore: z.ZodString;
+    maxAttempts: z.ZodNumber;
+    retryDelayMs: z.ZodNumber;
+}, z.core.$strip>;
+/** Governance refs that must be evaluated again before every claim or retry. */
+export declare const CommunicationSequencePolicySchema: z.ZodObject<{
+    policyRefs: z.ZodArray<z.ZodString>;
+    consentRef: z.ZodString;
+    killSwitchRef: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Canonical effect-bearing payload reviewed by a human for one sequence.
+ * Versions are explicit so an approval cannot silently authorize a later
+ * sequence, schedule, or policy revision.
+ */
+export declare const CommunicationSequenceApprovalTargetSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    sequenceRef: z.ZodString;
+    sequenceVersion: z.ZodString;
+    tenantRef: z.ZodString;
+    recipientRefs: z.ZodArray<z.ZodString>;
+    contentProof: z.ZodObject<{
+        contentRef: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strip>;
+    channel: z.ZodString;
+    sideEffect: z.ZodLiteral<"send_reply">;
+    schedulePolicyVersion: z.ZodString;
+    schedulePolicy: z.ZodObject<{
+        notBefore: z.ZodString;
+        maxAttempts: z.ZodNumber;
+        retryDelayMs: z.ZodNumber;
+    }, z.core.$strip>;
+    policyVersion: z.ZodString;
+    policy: z.ZodObject<{
+        policyRefs: z.ZodArray<z.ZodString>;
+        consentRef: z.ZodString;
+        killSwitchRef: z.ZodString;
+    }, z.core.$strip>;
+    expiresAt: z.ZodString;
+}, z.core.$strip>;
+/** Hash every effect-bearing content field, not only the plain-text body. */
+export declare function fingerprintCommunicationSequenceOutboundContent(content: CommunicationSequenceOutboundContent): Promise<string>;
+/** Compute the portable fingerprint stored on the approval and ActionPacket. */
+export declare function fingerprintCommunicationSequenceApprovalTarget(target: CommunicationSequenceApprovalTarget): Promise<string>;
+export declare function communicationSequenceApprovalEvidenceRef(fingerprint: string): string;
+/**
+ * Reusable, provider-neutral intent for a single approval-bound send sequence.
+ * Every effect-bearing field is explicit so a scheduler cannot substitute a
+ * recipient, content, channel, or side effect after human approval.
+ */
+export declare const CommunicationSequenceIntentSchema: z.ZodObject<{
+    sequenceRef: z.ZodString;
+    actionPacketRef: z.ZodString;
+    recipientRef: z.ZodString;
+    contentProof: z.ZodObject<{
+        contentRef: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strip>;
+    channel: z.ZodString;
+    sideEffect: z.ZodLiteral<"send_reply">;
+    schedulePolicy: z.ZodObject<{
+        notBefore: z.ZodString;
+        maxAttempts: z.ZodNumber;
+        retryDelayMs: z.ZodNumber;
+    }, z.core.$strip>;
+    expiresAt: z.ZodString;
+    approvalRequestId: z.ZodString;
+    approvalFingerprint: z.ZodString;
+    policy: z.ZodObject<{
+        policyRefs: z.ZodArray<z.ZodString>;
+        consentRef: z.ZodString;
+        killSwitchRef: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type CommunicationSequenceContentProof = z.infer<typeof CommunicationSequenceContentProofSchema>;
+export type CommunicationSequenceOutboundContent = z.infer<typeof CommunicationSequenceOutboundContentSchema>;
+export type CommunicationSequenceSchedulePolicy = z.infer<typeof CommunicationSequenceSchedulePolicySchema>;
+export type CommunicationSequencePolicy = z.infer<typeof CommunicationSequencePolicySchema>;
+export type CommunicationSequenceApprovalTarget = z.infer<typeof CommunicationSequenceApprovalTargetSchema>;
+export type CommunicationSequenceIntent = z.infer<typeof CommunicationSequenceIntentSchema>;

package/dist/contracts/sequence-intent.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as e}from"zod";var o=e.string().min(1),r=e.string().datetime({offset:!0}),C="1.0.0",y="communication.sequence-intent.v1|sequence,action-packet,recipient,content-proof,channel,side-effect,schedule,expiry,approval,policy|approval-bound,provider-neutral",E="sha256:7ef776396727b0e7ee015935d8f7d5f4605a08b815f6493aa737411490edc633",m="1.0.0",A="communicationSequenceApprovalTarget",h="communicationSequenceApprovalFingerprint",l="communication-sequence-approval:",s=e.object({contentRef:o,sha256:e.string().regex(/^[a-f0-9]{64}$/)}),f=e.object({body:e.string(),subject:e.string().optional(),htmlBody:e.string().optional(),replyToExternalMessageId:e.string().optional()}),a=e.object({notBefore:r,maxAttempts:e.number().int().positive(),retryDelayMs:e.number().int().nonnegative()}),p=e.object({policyRefs:e.array(o).min(1),consentRef:o,killSwitchRef:o}),S=e.object({schemaVersion:e.literal(m),sequenceRef:o,sequenceVersion:o,tenantRef:o,recipientRefs:e.array(o).min(1),contentProof:s,channel:o,sideEffect:e.literal("send_reply"),schedulePolicyVersion:o,schedulePolicy:a,policyVersion:o,policy:p,expiresAt:r}).superRefine((n,t)=>{if(new Set(n.recipientRefs).size!==n.recipientRefs.length)t.addIssue({code:e.ZodIssueCode.custom,message:"recipientRefs must be unique",path:["recipientRefs"]});if(Date.parse(n.expiresAt)<=Date.parse(n.schedulePolicy.notBefore))t.addIssue({code:e.ZodIssueCode.custom,message:"expiresAt must be later than schedulePolicy.notBefore",path:["expiresAt"]})});function i(n){if(Array.isArray(n))return`[${n.map(i).join(",")}]`;if(n&&typeof n==="object")return`{${Object.entries(n).sort(([t],[c])=>t.localeCompare(c)).map(([t,c])=>`${JSON.stringify(t)}:${i(c)}`).join(",")}}`;return JSON.stringify(n)}async function u(n){let t=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(i(n)));return Array.from(new Uint8Array(t),(c)=>c.toString(16).padStart(2,"0")).join("")}async function I(n){let t=f.parse(n);return u({body:t.body,htmlBody:t.htmlBody??null,replyToExternalMessageId:t.replyToExternalMessageId??null,subject:t.subject??null})}async function x(n){let t=S.parse(n);return`sha256:${await u(t)}`}function N(n){return`${l}${n}`}var P=e.object({sequenceRef:o,actionPacketRef:o,recipientRef:o,contentProof:s,channel:o,sideEffect:e.literal("send_reply"),schedulePolicy:a,expiresAt:r,approvalRequestId:o,approvalFingerprint:o,policy:p}).superRefine((n,t)=>{if(Date.parse(n.expiresAt)<=Date.parse(n.schedulePolicy.notBefore))t.addIssue({code:e.ZodIssueCode.custom,message:"expiresAt must be later than schedulePolicy.notBefore",path:["expiresAt"]})});export{l as COMMUNICATION_SEQUENCE_APPROVAL_EVIDENCE_PREFIX,h as COMMUNICATION_SEQUENCE_APPROVAL_FINGERPRINT_PAYLOAD_KEY,A as COMMUNICATION_SEQUENCE_APPROVAL_TARGET_PAYLOAD_KEY,m as COMMUNICATION_SEQUENCE_APPROVAL_TARGET_VERSION,E as COMMUNICATION_SEQUENCE_INTENT_SCHEMA_FINGERPRINT,y as COMMUNICATION_SEQUENCE_INTENT_SCHEMA_IDENTITY,C as COMMUNICATION_SEQUENCE_INTENT_SCHEMA_VERSION,S as CommunicationSequenceApprovalTargetSchema,s as CommunicationSequenceContentProofSchema,P as CommunicationSequenceIntentSchema,f as CommunicationSequenceOutboundContentSchema,p as CommunicationSequencePolicySchema,a as CommunicationSequenceSchedulePolicySchema,N as communicationSequenceApprovalEvidenceRef,x as fingerprintCommunicationSequenceApprovalTarget,I as fingerprintCommunicationSequenceOutboundContent};

package/dist/contracts/sequence-intent.test.d.ts

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

package/dist/contracts/sovereignty.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Data residency region in which CommunicationOS persistence and processing are
+ * permitted to run. EU is the default for the France vertical (AC0.5).
+ */
+export declare const ResidencyRegionEnum: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+/**
+ * Hosting / deployment posture for a CommunicationOS tenant. Drives the
+ * sovereignty guarantees a vertical can advertise.
+ */
+export declare const HostingModeEnum: import("@lssm/lib.schema").EnumType<[string, string, string]>;
+/**
+ * Data classes whose retention windows are governed independently. Used to
+ * resolve the documented retention window when a provider cannot recall data
+ * (the `erased_local_provider_retained_documented` erasure outcome).
+ */
+export declare const DataClassEnum: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string]>;
+/**
+ * Lawful basis for processing a subject's data under GDPR (RGPD) Article 6.
+ */
+export declare const ConsentBasisEnum: import("@lssm/lib.schema").EnumType<[string, string, string, string]>;
+/**
+ * Lifecycle status of a recorded subject consent decision.
+ */
+export declare const ConsentStatusEnum: import("@lssm/lib.schema").EnumType<[string, string, string, string]>;
+/**
+ * Per-data-class retention window. `retentionDays` is the documented maximum
+ * a provider may retain data when our local delete cannot force recall; this is
+ * the value surfaced by the `erased_local_provider_retained_documented` outcome.
+ */
+export declare const RetentionWindowModel: import("@lssm/lib.schema").SchemaModel<{
+    dataClass: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string]>;
+        isOptional: false;
+    };
+    retentionDays: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    basis: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string]>;
+        isOptional: false;
+    };
+    description: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>;
+/**
+ * Typed sovereignty profile for a CommunicationOS tenant. Documents data
+ * residency, per-data-class retention windows, the sovereign/EU LLM provider,
+ * and the hosting posture. This is the canonical source for the retention
+ * reference attached to a `provider_retained_documented` erasure outcome.
+ */
+export declare const SovereigntyProfileModel: import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    residencyRegion: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    hostingMode: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    llmProviderId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    retentionWindows: {
+        type: import("@lssm/lib.schema").SchemaModel<{
+            dataClass: {
+                type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string]>;
+                isOptional: false;
+            };
+            retentionDays: {
+                type: import("@lssm/lib.schema").FieldType<number, number>;
+                isOptional: false;
+            };
+            basis: {
+                type: import("@lssm/lib.schema").EnumType<[string, string, string, string]>;
+                isOptional: false;
+            };
+            description: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+        }>;
+        isArray: true;
+        isOptional: false;
+    };
+    dataResidencyEnforced: {
+        type: import("@lssm/lib.schema").FieldType<boolean, boolean>;
+        isOptional: false;
+        defaultValue: boolean;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    updatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>;
+/**
+ * RGPD consent record for a single data subject. Sufficient to record and check
+ * whether a subject's data may be processed and which lawful basis applies.
+ */
+export declare const SubjectConsentModel: import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    tenantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    subjectId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    basis: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string]>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    grantedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    withdrawnAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    expiresAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>;
+/**
+ * The THREE-STATE erasure outcome (pre-mortem #2, AC0.5):
+ * - `erased_local`: no channel record existed; only local data removed.
+ * - `erased_local_and_channel`: provider honored the erase (e.g. WhatsApp).
+ * - `erased_local_provider_retained_documented`: provider cannot recall the
+ *   data (e.g. SMTP/email already sent); local data removed and the documented
+ *   provider retention window is referenced — NOT a permanent open liability.
+ */
+export declare const ErasureOutcomeEnum: import("@lssm/lib.schema").EnumType<[string, string, string]>;

package/dist/contracts/sovereignty.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineEnum as t,defineSchemaModel as n,ScalarTypeEnum as e}from"@lssm/lib.schema";var a=t("ResidencyRegion",["eu","eu_fr","eu_de","us","uk","apac","self_managed"]),s=t("HostingMode",["saas","self_host","on_prem"]),o=t("DataClass",["message_body","participant_identity","channel_account","attachment","ai_derived","audit_evidence"]),i=t("ConsentBasis",["consent","contract","legal_obligation","legitimate_interest"]),r=t("ConsentStatus",["granted","withdrawn","expired","not_recorded"]),l=n({name:"RetentionWindow",description:"Documented retention window for a single governed data class.",fields:{dataClass:{type:o,isOptional:!1},retentionDays:{type:e.Int_unsecure(),isOptional:!1},basis:{type:i,isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0}}}),p=n({name:"SovereigntyProfile",description:"Residency, retention, sovereign LLM provider and hosting posture for a tenant.",fields:{id:{type:e.String_unsecure(),isOptional:!1},tenantId:{type:e.String_unsecure(),isOptional:!1},residencyRegion:{type:a,isOptional:!1,defaultValue:"eu"},hostingMode:{type:s,isOptional:!1,defaultValue:"saas"},llmProviderId:{type:e.String_unsecure(),isOptional:!1},retentionWindows:{type:l,isArray:!0,isOptional:!1},dataResidencyEnforced:{type:e.Boolean(),isOptional:!1,defaultValue:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),u=n({name:"SubjectConsent",description:"Recorded RGPD consent decision for a single data subject.",fields:{id:{type:e.String_unsecure(),isOptional:!1},tenantId:{type:e.String_unsecure(),isOptional:!1},subjectId:{type:e.String_unsecure(),isOptional:!1},basis:{type:i,isOptional:!1},status:{type:r,isOptional:!1,defaultValue:"not_recorded"},grantedAt:{type:e.DateTime(),isOptional:!0},withdrawnAt:{type:e.DateTime(),isOptional:!0},expiresAt:{type:e.DateTime(),isOptional:!0},evidenceRef:{type:e.String_unsecure(),isOptional:!0}}}),c=t("ErasureOutcome",["erased_local","erased_local_and_channel","erased_local_provider_retained_documented"]);export{i as ConsentBasisEnum,r as ConsentStatusEnum,o as DataClassEnum,c as ErasureOutcomeEnum,s as HostingModeEnum,a as ResidencyRegionEnum,l as RetentionWindowModel,p as SovereigntyProfileModel,u as SubjectConsentModel};

package/dist/contracts/support-internal-note.operations.d.ts

@@ -0,0 +1,309 @@
+import { type DocBlock } from '@lssm/lib.contracts-spec';
+export declare const CommunicationSupportInternalNoteDocBlock: DocBlock;
+export declare const CommunicationSupportInternalNoteVisibilityEnum: import("@lssm/lib.schema").EnumType<[string]>;
+export declare const CommunicationSupportInternalNoteCreateV1InputModel: import("@lssm/lib.schema").SchemaModel<{
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    body: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    idempotencyKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>;
+export declare const CommunicationSupportInternalNoteCreateForIntentV1InputModel: import("@lssm/lib.schema").SchemaModel<{
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    intentRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    body: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    idempotencyKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>;
+export declare const CommunicationSupportInternalNoteEvidenceV1Model: import("@lssm/lib.schema").SchemaModel<{
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    visibility: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>;
+export declare const CommunicationSupportInternalNoteIntentEvidenceV1Model: import("@lssm/lib.schema").SchemaModel<{
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    visibility: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    intentRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    deliveryRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    grantEvidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>;
+export declare const CommunicationSupportInternalNoteVerifyV1InputModel: import("@lssm/lib.schema").SchemaModel<{
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>;
+export declare const CommunicationSupportInternalNoteVerificationV1Model: import("@lssm/lib.schema").SchemaModel<{
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    visibility: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+}>;
+export declare const CreateCommunicationSupportInternalNoteV1Command: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    body: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    idempotencyKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    visibility: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const CreateCommunicationSupportInternalNoteForIntentV1Command: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    intentRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    body: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    idempotencyKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    visibility: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    intentRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    deliveryRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    grantEvidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const VerifyCommunicationSupportInternalNoteV1Query: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    visibility: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const CommunicationSupportInternalNoteCreatedV1Event: import("@lssm/lib.contracts-spec").EventSpec<import("@lssm/lib.schema").SchemaModel<{
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    visibility: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>>;
+export declare const CommunicationSupportInternalNoteReconciliationReadyV1Event: import("@lssm/lib.contracts-spec").EventSpec<import("@lssm/lib.schema").SchemaModel<{
+    noteRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    caseRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    visibility: {
+        type: import("@lssm/lib.schema").EnumType<[string]>;
+        isOptional: false;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    intentRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    deliveryRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    grantEvidenceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>>;
+export declare const COMMUNICATION_SUPPORT_INTERNAL_NOTE_CAPABILITIES: {
+    readonly create: 'communication.support.internal-note.create';
+    readonly createForIntent: 'communication.support.internal-note.create-for-intent';
+    readonly verify: 'communication.support.internal-note.verify';
+};

package/dist/contracts/support-internal-note.operations.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineCommand as a,defineEvent as r,defineQuery as u,docId as l}from"@lssm/lib.contracts-spec";import{defineEnum as p,defineSchemaModel as t,ScalarTypeEnum as e}from"@lssm/lib.schema";var n=["platform.communication-os","platform.support-os"],m={id:"communication-os.support-internal-note.v1",title:"CommunicationOS private Support note authority",body:"CommunicationOS owns private note content and immutable evidence. SupportOS stores only opaque note and evidence references. Service requests derive tenant, workspace, actor, audience, and capabilities from a short-lived AuthOS grant; verification is redacted and never returns note content.",kind:"reference",route:"/docs/communication-os/support-internal-notes-v1",visibility:"public"},o=[l(m.id)],c=p("CommunicationSupportInternalNoteVisibility",["internal"]),d=t({name:"CommunicationSupportInternalNoteCreateV1Input",fields:{caseRef:{type:e.String_unsecure(),isOptional:!1},body:{type:e.String_unsecure(),isOptional:!1},idempotencyKey:{type:e.String_unsecure(),isOptional:!1}}}),y=t({name:"CommunicationSupportInternalNoteCreateForIntentV1Input",fields:{caseRef:{type:e.String_unsecure(),isOptional:!1},intentRef:{type:e.String_unsecure(),isOptional:!1},body:{type:e.String_unsecure(),isOptional:!1},idempotencyKey:{type:e.String_unsecure(),isOptional:!1}}}),i=t({name:"CommunicationSupportInternalNoteEvidenceV1",fields:{noteRef:{type:e.String_unsecure(),isOptional:!1},caseRef:{type:e.String_unsecure(),isOptional:!1},evidenceRef:{type:e.String_unsecure(),isOptional:!1},visibility:{type:c,isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),s=t({name:"CommunicationSupportInternalNoteIntentEvidenceV1",fields:{...i.config.fields,intentRef:{type:e.String_unsecure(),isOptional:!1},deliveryRef:{type:e.String_unsecure(),isOptional:!1},grantEvidenceRef:{type:e.String_unsecure(),isOptional:!1}}}),f=t({name:"CommunicationSupportInternalNoteVerifyV1Input",fields:{caseRef:{type:e.String_unsecure(),isOptional:!1},noteRef:{type:e.String_unsecure(),isOptional:!1},evidenceRef:{type:e.String_unsecure(),isOptional:!1}}}),S=t({name:"CommunicationSupportInternalNoteVerificationV1",fields:{status:{type:p("CommunicationSupportInternalNoteVerificationStatus",["verified"]),isOptional:!1},caseRef:{type:e.String_unsecure(),isOptional:!1},noteRef:{type:e.String_unsecure(),isOptional:!1},evidenceRef:{type:e.String_unsecure(),isOptional:!1},visibility:{type:c,isOptional:!1}}}),C=a({meta:{key:"communication.support.internal-note.create",version:"1.0.0",stability:"experimental",owners:[...n],tags:["communication","support","internal-note","private"],description:"Create one encrypted private Support note in CommunicationOS",goal:"Keep note content in CommunicationOS while SupportOS stores opaque evidence",context:"Server scope and actor come only from a short-lived AuthOS downstream grant",docId:o},io:{input:d,output:i},policy:{auth:"admin"}}),O=a({meta:{key:"communication.support.internal-note.create-for-intent",version:"1.0.0",stability:"experimental",owners:[...n],tags:["communication","support","internal-note","private","reconciliation"],description:"Create an encrypted Support note bound to a body-free SupportOS intent",goal:"Make cross-service note attachment replayable without copying content",context:"The short-lived AuthOS grant binds scope and actor; the intent is opaque, redacted correlation metadata",docId:o},io:{input:y,output:s},policy:{auth:"admin"}}),g=u({meta:{key:"communication.support.internal-note.verify",version:"1.0.0",stability:"experimental",owners:[...n],tags:["communication","support","internal-note","verify"],description:"Verify exact private-note evidence without returning content",goal:"Let SupportOS validate its opaque note reference at the authority boundary",context:"The query requires exact tenant, workspace, case, note, evidence, audience, and capability binding",docId:o},io:{input:f,output:S},policy:{auth:"admin"}}),N=r({meta:{key:"communication.support.internal-note.created",version:"1.0.0",stability:"experimental",owners:[...n],tags:["communication","support","internal-note","event"],description:"Immutable redacted evidence that a private Support note was created",docId:o},payload:i}),V=r({meta:{key:"communication.support.internal-note.reconciliation-ready",version:"1.0.0",stability:"experimental",owners:[...n],tags:["communication","support","internal-note","reconciliation"],description:"Redacted durable delivery evidence for a SupportOS note intent",docId:o},payload:s}),b={create:"communication.support.internal-note.create",createForIntent:"communication.support.internal-note.create-for-intent",verify:"communication.support.internal-note.verify"};export{b as COMMUNICATION_SUPPORT_INTERNAL_NOTE_CAPABILITIES,y as CommunicationSupportInternalNoteCreateForIntentV1InputModel,d as CommunicationSupportInternalNoteCreateV1InputModel,N as CommunicationSupportInternalNoteCreatedV1Event,m as CommunicationSupportInternalNoteDocBlock,i as CommunicationSupportInternalNoteEvidenceV1Model,s as CommunicationSupportInternalNoteIntentEvidenceV1Model,V as CommunicationSupportInternalNoteReconciliationReadyV1Event,S as CommunicationSupportInternalNoteVerificationV1Model,f as CommunicationSupportInternalNoteVerifyV1InputModel,c as CommunicationSupportInternalNoteVisibilityEnum,O as CreateCommunicationSupportInternalNoteForIntentV1Command,C as CreateCommunicationSupportInternalNoteV1Command,g as VerifyCommunicationSupportInternalNoteV1Query};

package/dist/contracts/support-internal-note.operations.test.d.ts

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

package/dist/contracts/thread-link-kind.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+declare const ThreadLinkedObjectPayloadSchema: z.ZodObject<{
+    domain: z.ZodString;
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ThreadLinkedObjectPayload = z.infer<typeof ThreadLinkedObjectPayloadSchema>;
+/**
+ * Built-in kind for generic domain objects linked to communication threads.
+ *
+ * `domain` carries the former `objectType` value (e.g. `"order"`, `"project"`).
+ * `id` carries the former `objectId` value (e.g. `"order-99"`).
+ * `label` is optional human-readable name for display surfaces.
+ */
+export declare const threadLinkedObjectKind: import("@lssm/lib.contracts-spec/rich-reference/define-kind").ReferenceKindDefinition<{
+    domain: string;
+    id: string;
+    label?: string | undefined;
+}>;
+export {};

package/dist/contracts/thread-link-kind.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineReferenceKind as i}from"@lssm/lib.contracts-spec/rich-reference/define-kind";import{z as e}from"zod";var n=e.object({domain:e.string().min(1),id:e.string().min(1),label:e.string().optional()}),a=i({id:"communication.thread-linked-object",schema:n,sensitiveFields:[],defaultPreview:"inline-chip",defaultPanel:"popover",icon:"link"});export{a as threadLinkedObjectKind};