@lssm/lib.communication-spec 3.1.1

package/dist/contracts/channel-preferences.d.ts

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+export declare const COMMUNICATION_PREFERENCE_SET_SCHEMA_VERSION: '1.0.0';
+export declare const CommunicationQuietHoursV1Schema: z.ZodObject<{
+    start: z.ZodString;
+    end: z.ZodString;
+    timezone: z.ZodString;
+}, z.core.$strict>;
+export declare const CommunicationDigestPreferenceV1Schema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    frequency: z.ZodEnum<{
+        daily: "daily";
+        immediate: "immediate";
+        weekly: "weekly";
+    }>;
+    deliveryTime: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const CommunicationRoutePreferenceV1Schema: z.ZodObject<{
+    routeRef: z.ZodString;
+    channel: z.ZodString;
+    enabled: z.ZodBoolean;
+    priority: z.ZodNumber;
+    consentRef: z.ZodOptional<z.ZodString>;
+    quietHours: z.ZodOptional<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        timezone: z.ZodString;
+    }, z.core.$strict>>;
+    digest: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        frequency: z.ZodEnum<{
+            daily: "daily";
+            immediate: "immediate";
+            weekly: "weekly";
+        }>;
+        deliveryTime: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const CommunicationFallbackPreferenceV1Schema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    orderedRouteRefs: z.ZodArray<z.ZodString>;
+    terminalRouteRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const CommunicationPreferenceSetV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    preferenceSetRef: z.ZodString;
+    revision: z.ZodNumber;
+    scope: z.ZodObject<{
+        tenantRef: z.ZodString;
+        workspaceRef: z.ZodOptional<z.ZodString>;
+        spaceRef: z.ZodOptional<z.ZodString>;
+        subjectRef: z.ZodString;
+    }, z.core.$strict>;
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"event">;
+        ref: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"automation">;
+        ref: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"feature">;
+        ref: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"application">;
+        ref: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"product">;
+        ref: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"space">;
+        ref: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"person">;
+        ref: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"platform_default">;
+        ref: z.ZodLiteral<"communication:preference-target:platform-default">;
+    }, z.core.$strict>], "kind">;
+    parentPreferenceSetRefs: z.ZodArray<z.ZodString>;
+    authority: z.ZodLiteral<"preference_only">;
+    globalEnabled: z.ZodBoolean;
+    routePreferences: z.ZodArray<z.ZodObject<{
+        routeRef: z.ZodString;
+        channel: z.ZodString;
+        enabled: z.ZodBoolean;
+        priority: z.ZodNumber;
+        consentRef: z.ZodOptional<z.ZodString>;
+        quietHours: z.ZodOptional<z.ZodObject<{
+            start: z.ZodString;
+            end: z.ZodString;
+            timezone: z.ZodString;
+        }, z.core.$strict>>;
+        digest: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            frequency: z.ZodEnum<{
+                daily: "daily";
+                immediate: "immediate";
+                weekly: "weekly";
+            }>;
+            deliveryTime: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    fallback: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        orderedRouteRefs: z.ZodArray<z.ZodString>;
+        terminalRouteRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    updatedAt: z.ZodString;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    preferenceSetDigest: z.ZodString;
+}, z.core.$strict>;
+export type CommunicationQuietHoursV1 = z.infer<typeof CommunicationQuietHoursV1Schema>;
+export type CommunicationDigestPreferenceV1 = z.infer<typeof CommunicationDigestPreferenceV1Schema>;
+export type CommunicationRoutePreferenceV1 = z.infer<typeof CommunicationRoutePreferenceV1Schema>;
+export type CommunicationFallbackPreferenceV1 = z.infer<typeof CommunicationFallbackPreferenceV1Schema>;
+export type CommunicationPreferenceSetV1 = z.infer<typeof CommunicationPreferenceSetV1Schema>;

package/dist/contracts/channel-preferences.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as o}from"zod";import{z as a}from"zod";var E="1.0.0",_="1.0.0",K={id:"communication-os.agent-omnichannel.v1",title:"CommunicationOS agent omnichannel contracts",body:"Provider-neutral agent profiles and lifecycle links bind applications, runs, tasks, help requests, background results, routes, preferences, policies, and evidence through opaque references. They grant no provider access or effect authority.",kind:"reference",route:"/docs/communication-os/agent-omnichannel-v1",visibility:"public"},r=a.string().trim().min(1),V=a.string().datetime({offset:!0}),u=a.string().regex(/^sha256:[a-f0-9]{64}$/),I=a.object({ref:r,digest:u}).strict(),S=I.extend({revision:a.number().int().positive()}).strict(),d=a.object({tenantRef:r,workspaceRef:r.optional(),spaceRef:r.optional(),subjectRef:r}).strict(),Z=a.object({schemaVersion:a.literal(E),profileRef:r,revision:a.number().int().positive(),agentRef:r,applicationRef:r,scope:d,routeBindings:a.array(S),connectionRefs:a.array(r),preferenceSet:S,policyRefs:a.array(r).min(1),evidenceRefs:a.array(r).min(1),createdAt:V,updatedAt:V,profileDigest:u}).strict().superRefine((e,t)=>{for(let i of["connectionRefs","policyRefs","evidenceRefs"])if(new Set(e[i]).size!==e[i].length)t.addIssue({code:a.ZodIssueCode.custom,path:[i],message:`${i} must be unique`});let n=e.routeBindings.map((i)=>i.ref);if(new Set(n).size!==n.length)t.addIssue({code:a.ZodIssueCode.custom,path:["routeBindings"],message:"route bindings must be unique"})}),U=a.object({schemaVersion:a.literal(_),linkRef:r,profile:S,agentRef:r,applicationRef:r,scope:d,runRef:r.optional(),taskRef:r.optional(),helpRequestRef:r.optional(),approvalRequestRef:r.optional(),backgroundResultRef:r.optional(),canonicalConversation:I.optional(),session:S.optional(),correlationRef:r,evidenceRefs:a.array(r).min(1)}).strict().superRefine((e,t)=>{if(new Set(e.evidenceRefs).size!==e.evidenceRefs.length)t.addIssue({code:a.ZodIssueCode.custom,path:["evidenceRefs"],message:"evidenceRefs must be unique"});if(!e.runRef&&!e.taskRef&&!e.helpRequestRef&&!e.approvalRequestRef&&!e.backgroundResultRef)t.addIssue({code:a.ZodIssueCode.custom,path:["runRef"],message:"at least one run, task, help request, approval request, or background result ref is required"})});function C(e,t){return e.tenantRef===t.tenantRef&&e.workspaceRef===t.workspaceRef&&e.spaceRef===t.spaceRef&&e.subjectRef===t.subjectRef}function F(e){let t=[];for(let n of["agentRef","applicationRef"])if(e.profile[n]!==e.lifecycleLink[n])t.push(`Lifecycle ${n} does not match the agent profile`);if(e.lifecycleLink.profile.ref!==e.profile.profileRef||e.lifecycleLink.profile.revision!==e.profile.revision||e.lifecycleLink.profile.digest!==e.profile.profileDigest)t.push("Lifecycle profile binding does not match the agent profile");if(!C(e.profile.scope,e.lifecycleLink.scope))t.push("Lifecycle scope does not match the agent profile");return t}function H(e){let{intent:t,progress:n}=e,i=[];if(n.deliveryRef!==t.deliveryRef||n.intent.ref!==t.deliveryRef||n.intent.digest!==t.deliveryDigest)i.push("Progress delivery does not match the intent");if(!C(n.scope,t.scope))i.push("Progress scope does not match the intent");if(n.recipientRef!==t.recipientRefs[0])i.push("Progress recipient does not match the intent");let s=t.requestedRoutes.find((m)=>m.ref===n.route.ref);if(!s||s.revision!==n.route.revision||s.digest!==n.route.digest)i.push("Progress route was not requested by the intent");if(Date.parse(n.occurredAt)<Date.parse(t.createdAt)||Date.parse(n.occurredAt)>Date.parse(t.expiresAt))i.push("Progress occurred outside the intent validity window");return i}import{z as f}from"zod";var w="1.0.0",A=["email","calendar","sms","slack","teams","discord","telegram","whatsapp","matrix","in_app","push","webhook","web_chat","internal_chat"],v=f.string().trim().min(1),Y=f.enum(A),T=f.enum(["communication","calendar_event"]),h=f.string().trim().min(1),J=f.object({schemaVersion:f.literal(w),routeRef:h,revision:f.number().int().positive(),scope:d,channel:v,destinationRef:h,connectionRef:h.optional(),semantic:T,deliveryMode:f.enum(["direct","durable_in_app"]),capabilityRefs:f.array(h),evidenceRefs:f.array(h).min(1),routeDigest:u}).strict().superRefine((e,t)=>{if(e.channel==="calendar"!==(e.semantic==="calendar_event"))t.addIssue({code:f.ZodIssueCode.custom,path:["semantic"],message:"calendar routes require calendar_event semantics and calendar_event routes require the calendar channel"});for(let n of["capabilityRefs","evidenceRefs"])if(new Set(e[n]).size!==e[n].length)t.addIssue({code:f.ZodIssueCode.custom,path:[n],message:`${n} must be unique`})});import{z as c}from"zod";var x="1.0.0",N="communication:preference-target:platform-default",ne=[["event","automation"],["feature","application"],["product"],["space","person"],["platform_default"]],oe=c.enum(["event","automation","feature","application","product","space","person","platform_default"]),g=c.string().trim().min(1);function p(e){return c.object({kind:c.literal(e),ref:g}).strict()}var y=c.discriminatedUnion("kind",[p("event"),p("automation"),p("feature"),p("application"),p("product"),p("space"),p("person"),c.object({kind:c.literal("platform_default"),ref:c.literal(N)}).strict()]),z=c.object({preferenceSetRef:g,revision:c.number().int().positive(),digest:u,target:y}).strict(),ie=c.object({schemaVersion:c.literal(x),resolutionRef:g,scope:d,subjectRef:g,evaluatedPreferenceSets:c.array(z).min(1),winningPreferenceSetRef:g,winningTarget:y,authority:c.literal("preference_only"),effectAuthority:c.literal("none"),resolvedAt:c.string().datetime({offset:!0}),evidenceRefs:c.array(g).min(1),resolutionDigest:u}).strict().superRefine((e,t)=>{let n=e.evaluatedPreferenceSets.map((s)=>s.preferenceSetRef);if(new Set(n).size!==n.length)R(t,"evaluatedPreferenceSets","evaluated sets must be unique");if(new Set(e.evidenceRefs).size!==e.evidenceRefs.length)R(t,"evidenceRefs","evidenceRefs must be unique");for(let s=1;s<e.evaluatedPreferenceSets.length;s+=1){let m=e.evaluatedPreferenceSets[s-1],P=e.evaluatedPreferenceSets[s];if(m&&P&&k(m.target.kind)>k(P.target.kind)){R(t,"evaluatedPreferenceSets","evaluated sets must follow the preference resolution hierarchy");break}}let i=e.evaluatedPreferenceSets.find((s)=>s.preferenceSetRef===e.winningPreferenceSetRef);if(!i)R(t,"winningPreferenceSetRef","winning preference set must have been evaluated");else if(i.preferenceSetRef!==e.evaluatedPreferenceSets[0]?.preferenceSetRef)R(t,"winningPreferenceSetRef","winning preference set must be the most specific evaluated set");else if(i.target.kind!==e.winningTarget.kind||i.target.ref!==e.winningTarget.ref)R(t,"winningTarget","winning target must match the winning preference set")});function k(e){switch(e){case"event":case"automation":return 0;case"feature":case"application":return 1;case"product":return 2;case"space":case"person":return 3;case"platform_default":return 4}}function R(e,t,n){e.addIssue({code:c.ZodIssueCode.custom,path:[t],message:n})}function re(e){let{preferenceResolution:t,preferenceSet:n}=e,i=[];if(t.subjectRef!==n.scope.subjectRef||t.winningPreferenceSetRef!==n.preferenceSetRef)i.push("Preference resolution does not match its subject and set");if(!C(t.scope,n.scope))i.push("Preference resolution scope does not match its preference set");let s=t.evaluatedPreferenceSets.find((m)=>m.preferenceSetRef===n.preferenceSetRef);if(!s||s.revision!==n.revision||s.digest!==n.preferenceSetDigest)i.push("Preference resolution binding is stale");if(t.winningTarget.kind!==n.target.kind||t.winningTarget.ref!==n.target.ref)i.push("Preference resolution target does not match its preference set");return i}var q="1.0.0",l=o.string().trim().min(1),D=o.string().datetime({offset:!0}),b=o.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/),L=o.object({start:b,end:b,timezone:o.string().trim().min(1)}).strict(),O=o.object({enabled:o.boolean(),frequency:o.enum(["immediate","daily","weekly"]),deliveryTime:b.optional()}).strict().superRefine((e,t)=>{if(e.frequency==="immediate"&&e.deliveryTime)t.addIssue({code:o.ZodIssueCode.custom,path:["deliveryTime"],message:"immediate digest frequency cannot carry a delivery time"});if(e.enabled&&e.frequency!=="immediate"&&!e.deliveryTime)t.addIssue({code:o.ZodIssueCode.custom,path:["deliveryTime"],message:"enabled daily or weekly digest requires a delivery time"})}),B=o.object({routeRef:l,channel:v,enabled:o.boolean(),priority:o.number().int().positive(),consentRef:l.optional(),quietHours:L.optional(),digest:O.optional()}).strict(),M=o.object({enabled:o.boolean(),orderedRouteRefs:o.array(l),terminalRouteRef:l.optional()}).strict().superRefine((e,t)=>{if(new Set(e.orderedRouteRefs).size!==e.orderedRouteRefs.length)t.addIssue({code:o.ZodIssueCode.custom,path:["orderedRouteRefs"],message:"fallback routes must be unique"});if(e.enabled&&e.orderedRouteRefs.length===0)t.addIssue({code:o.ZodIssueCode.custom,path:["orderedRouteRefs"],message:"enabled fallback requires at least one route"})}),ue=o.object({schemaVersion:o.literal(q),preferenceSetRef:l,revision:o.number().int().positive(),scope:d,target:y,parentPreferenceSetRefs:o.array(l),authority:o.literal("preference_only"),globalEnabled:o.boolean(),routePreferences:o.array(B),fallback:M,updatedAt:D,evidenceRefs:o.array(l).min(1),preferenceSetDigest:u}).strict().superRefine((e,t)=>{if(new Set(e.evidenceRefs).size!==e.evidenceRefs.length)t.addIssue({code:o.ZodIssueCode.custom,path:["evidenceRefs"],message:"evidenceRefs must be unique"});if(new Set(e.parentPreferenceSetRefs).size!==e.parentPreferenceSetRefs.length)t.addIssue({code:o.ZodIssueCode.custom,path:["parentPreferenceSetRefs"],message:"parent preference sets must be unique"});if(e.parentPreferenceSetRefs.includes(e.preferenceSetRef))t.addIssue({code:o.ZodIssueCode.custom,path:["parentPreferenceSetRefs"],message:"a preference set cannot inherit from itself"});let n=e.routePreferences.map((m)=>m.routeRef);if(new Set(n).size!==n.length)t.addIssue({code:o.ZodIssueCode.custom,path:["routePreferences"],message:"route preferences must be unique"});let i=e.routePreferences.map((m)=>m.priority);if(new Set(i).size!==i.length)t.addIssue({code:o.ZodIssueCode.custom,path:["routePreferences"],message:"route preference priorities must be unique"});let s=new Set(n);for(let m of e.fallback.orderedRouteRefs)if(!s.has(m))t.addIssue({code:o.ZodIssueCode.custom,path:["fallback","orderedRouteRefs"],message:`fallback route ${m} has no route preference`});if(e.fallback.terminalRouteRef&&!s.has(e.fallback.terminalRouteRef))t.addIssue({code:o.ZodIssueCode.custom,path:["fallback","terminalRouteRef"],message:"terminal route has no route preference"});if(e.fallback.enabled&&e.fallback.terminalRouteRef&&!e.fallback.orderedRouteRefs.includes(e.fallback.terminalRouteRef))t.addIssue({code:o.ZodIssueCode.custom,path:["fallback","terminalRouteRef"],message:"terminal route must be part of the fallback order"})});export{q as COMMUNICATION_PREFERENCE_SET_SCHEMA_VERSION,O as CommunicationDigestPreferenceV1Schema,M as CommunicationFallbackPreferenceV1Schema,ue as CommunicationPreferenceSetV1Schema,L as CommunicationQuietHoursV1Schema,B as CommunicationRoutePreferenceV1Schema};

package/dist/contracts/channel-routing.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+export declare const COMMUNICATION_CHANNEL_ROUTING_SCHEMA_VERSION: '1.0.0';
+export declare const COMMUNICATION_WELL_KNOWN_CHANNEL_KEYS: readonly ['email', 'calendar', 'sms', 'slack', 'teams', 'discord', 'telegram', 'whatsapp', 'matrix', 'in_app', 'push', 'webhook', 'web_chat', 'internal_chat'];
+/** Open channel keys allow namespaced vertical and provider extensions. */
+export declare const CommunicationChannelKeySchema: z.ZodString;
+export declare const CommunicationWellKnownChannelKeySchema: z.ZodEnum<{
+    calendar: "calendar";
+    discord: "discord";
+    email: "email";
+    in_app: "in_app";
+    internal_chat: "internal_chat";
+    matrix: "matrix";
+    push: "push";
+    slack: "slack";
+    sms: "sms";
+    teams: "teams";
+    telegram: "telegram";
+    web_chat: "web_chat";
+    webhook: "webhook";
+    whatsapp: "whatsapp";
+}>;
+export declare const CommunicationDeliverySemanticSchema: z.ZodEnum<{
+    calendar_event: "calendar_event";
+    communication: "communication";
+}>;
+/**
+ * A provider-neutral route to an opaque destination. A route may reference a
+ * connection, but never embeds provider configuration or credentials.
+ */
+export declare const CommunicationDeliveryRouteV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    routeRef: z.ZodString;
+    revision: z.ZodNumber;
+    scope: z.ZodObject<{
+        tenantRef: z.ZodString;
+        workspaceRef: z.ZodOptional<z.ZodString>;
+        spaceRef: z.ZodOptional<z.ZodString>;
+        subjectRef: z.ZodString;
+    }, z.core.$strict>;
+    channel: z.ZodString;
+    destinationRef: z.ZodString;
+    connectionRef: z.ZodOptional<z.ZodString>;
+    semantic: z.ZodEnum<{
+        calendar_event: "calendar_event";
+        communication: "communication";
+    }>;
+    deliveryMode: z.ZodEnum<{
+        direct: "direct";
+        durable_in_app: "durable_in_app";
+    }>;
+    capabilityRefs: z.ZodArray<z.ZodString>;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    routeDigest: z.ZodString;
+}, z.core.$strict>;
+export type CommunicationChannelKey = z.infer<typeof CommunicationChannelKeySchema>;
+export type CommunicationWellKnownChannelKey = z.infer<typeof CommunicationWellKnownChannelKeySchema>;
+export type CommunicationDeliverySemantic = z.infer<typeof CommunicationDeliverySemanticSchema>;
+export type CommunicationDeliveryRouteV1 = z.infer<typeof CommunicationDeliveryRouteV1Schema>;

package/dist/contracts/channel-routing.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as c}from"zod";import{z as o}from"zod";var h="1.0.0",y="1.0.0",b={id:"communication-os.agent-omnichannel.v1",title:"CommunicationOS agent omnichannel contracts",body:"Provider-neutral agent profiles and lifecycle links bind applications, runs, tasks, help requests, background results, routes, preferences, policies, and evidence through opaque references. They grant no provider access or effect authority.",kind:"reference",route:"/docs/communication-os/agent-omnichannel-v1",visibility:"public"},t=o.string().trim().min(1),u=o.string().datetime({offset:!0}),m=o.string().regex(/^sha256:[a-f0-9]{64}$/),l=o.object({ref:t,digest:m}).strict(),a=l.extend({revision:o.number().int().positive()}).strict(),f=o.object({tenantRef:t,workspaceRef:t.optional(),spaceRef:t.optional(),subjectRef:t}).strict(),A=o.object({schemaVersion:o.literal(h),profileRef:t,revision:o.number().int().positive(),agentRef:t,applicationRef:t,scope:f,routeBindings:o.array(a),connectionRefs:o.array(t),preferenceSet:a,policyRefs:o.array(t).min(1),evidenceRefs:o.array(t).min(1),createdAt:u,updatedAt:u,profileDigest:m}).strict().superRefine((e,n)=>{for(let s of["connectionRefs","policyRefs","evidenceRefs"])if(new Set(e[s]).size!==e[s].length)n.addIssue({code:o.ZodIssueCode.custom,path:[s],message:`${s} must be unique`});let i=e.routeBindings.map((s)=>s.ref);if(new Set(i).size!==i.length)n.addIssue({code:o.ZodIssueCode.custom,path:["routeBindings"],message:"route bindings must be unique"})}),I=o.object({schemaVersion:o.literal(y),linkRef:t,profile:a,agentRef:t,applicationRef:t,scope:f,runRef:t.optional(),taskRef:t.optional(),helpRequestRef:t.optional(),approvalRequestRef:t.optional(),backgroundResultRef:t.optional(),canonicalConversation:l.optional(),session:a.optional(),correlationRef:t,evidenceRefs:o.array(t).min(1)}).strict().superRefine((e,n)=>{if(new Set(e.evidenceRefs).size!==e.evidenceRefs.length)n.addIssue({code:o.ZodIssueCode.custom,path:["evidenceRefs"],message:"evidenceRefs must be unique"});if(!e.runRef&&!e.taskRef&&!e.helpRequestRef&&!e.approvalRequestRef&&!e.backgroundResultRef)n.addIssue({code:o.ZodIssueCode.custom,path:["runRef"],message:"at least one run, task, help request, approval request, or background result ref is required"})});function d(e,n){return e.tenantRef===n.tenantRef&&e.workspaceRef===n.workspaceRef&&e.spaceRef===n.spaceRef&&e.subjectRef===n.subjectRef}function x(e){let n=[];for(let i of["agentRef","applicationRef"])if(e.profile[i]!==e.lifecycleLink[i])n.push(`Lifecycle ${i} does not match the agent profile`);if(e.lifecycleLink.profile.ref!==e.profile.profileRef||e.lifecycleLink.profile.revision!==e.profile.revision||e.lifecycleLink.profile.digest!==e.profile.profileDigest)n.push("Lifecycle profile binding does not match the agent profile");if(!d(e.profile.scope,e.lifecycleLink.scope))n.push("Lifecycle scope does not match the agent profile");return n}function k(e){let{intent:n,progress:i}=e,s=[];if(i.deliveryRef!==n.deliveryRef||i.intent.ref!==n.deliveryRef||i.intent.digest!==n.deliveryDigest)s.push("Progress delivery does not match the intent");if(!d(i.scope,n.scope))s.push("Progress scope does not match the intent");if(i.recipientRef!==n.recipientRefs[0])s.push("Progress recipient does not match the intent");let p=n.requestedRoutes.find((g)=>g.ref===i.route.ref);if(!p||p.revision!==i.route.revision||p.digest!==i.route.digest)s.push("Progress route was not requested by the intent");if(Date.parse(i.occurredAt)<Date.parse(n.createdAt)||Date.parse(i.occurredAt)>Date.parse(n.expiresAt))s.push("Progress occurred outside the intent validity window");return s}var R="1.0.0",C=["email","calendar","sms","slack","teams","discord","telegram","whatsapp","matrix","in_app","push","webhook","web_chat","internal_chat"],v=c.string().trim().min(1),N=c.enum(C),S=c.enum(["communication","calendar_event"]),r=c.string().trim().min(1),B=c.object({schemaVersion:c.literal(R),routeRef:r,revision:c.number().int().positive(),scope:f,channel:v,destinationRef:r,connectionRef:r.optional(),semantic:S,deliveryMode:c.enum(["direct","durable_in_app"]),capabilityRefs:c.array(r),evidenceRefs:c.array(r).min(1),routeDigest:m}).strict().superRefine((e,n)=>{if(e.channel==="calendar"!==(e.semantic==="calendar_event"))n.addIssue({code:c.ZodIssueCode.custom,path:["semantic"],message:"calendar routes require calendar_event semantics and calendar_event routes require the calendar channel"});for(let i of["capabilityRefs","evidenceRefs"])if(new Set(e[i]).size!==e[i].length)n.addIssue({code:c.ZodIssueCode.custom,path:[i],message:`${i} must be unique`})});export{R as COMMUNICATION_CHANNEL_ROUTING_SCHEMA_VERSION,C as COMMUNICATION_WELL_KNOWN_CHANNEL_KEYS,v as CommunicationChannelKeySchema,B as CommunicationDeliveryRouteV1Schema,S as CommunicationDeliverySemanticSchema,N as CommunicationWellKnownChannelKeySchema};

package/dist/contracts/channel-routing.test.d.ts

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

package/dist/contracts/collaboration.operations.d.ts

@@ -0,0 +1,315 @@
+export declare const CreateHandoffCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    fromOwner: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    toOwner: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    reason: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    fromOwner: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    toOwner: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    summary: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    keyFacts: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: true;
+    };
+    openQuestions: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: true;
+    };
+    requiredActions: {
+        type: import("@lssm/lib.schema").SchemaModel<{
+            id: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            threadId: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            title: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: false;
+            };
+            owner: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isOptional: true;
+            };
+            deadline: {
+                type: import("@lssm/lib.schema").FieldType<Date, string>;
+                isOptional: true;
+            };
+            blockers: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isArray: true;
+                isOptional: true;
+            };
+            sourceMessageIds: {
+                type: import("@lssm/lib.schema").FieldType<string, string>;
+                isArray: true;
+                isOptional: false;
+            };
+            safetyMode: {
+                type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string]>;
+                isOptional: false;
+                defaultValue: string;
+            };
+        }>;
+        isArray: true;
+        isOptional: true;
+    };
+    evidenceLinks: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    updatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const ProposeThreadLinkCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    objectRef: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+    };
+    relation: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    confidence: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    objectRef: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isOptional: false;
+    };
+    relation: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    confidence: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const ProposeIdentityLinkCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    participantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    candidateParticipantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    confidence: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    reasoning: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    reviewedBy: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    participantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    candidateParticipantId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    confidence: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    reasoning: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    reviewedBy: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const EscalateToHumanCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    reason: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    targetOwner: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    id: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    messageId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    suggestionType: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    content: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    modelName: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    confidence: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: true;
+    };
+    policyVersion: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    createdAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+    updatedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const RecordHumanFeedbackCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    targetId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    targetType: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    outcome: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string]>;
+        isOptional: false;
+    };
+    notes: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    feedbackId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    safetyMode: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string]>;
+        isOptional: false;
+    };
+}>, undefined>;

package/dist/contracts/collaboration.operations.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineCommand as s}from"@lssm/lib.contracts-spec";import{defineSchemaModel as l,ScalarTypeEnum as i}from"@lssm/lib.schema";import{defineEnum as n}from"@lssm/lib.schema";var a=n("ChannelType",["email","sms","whatsapp","telegram","matrix","web_chat","voice","internal_chat","custom_adapter","future_bridge","unknown"]),d=n("ThreadStatus",["open","waiting_on_human","waiting_on_external_party","action_required","resolved","archived"]),y=n("MessageStatus",["received","normalized","classified","linked","triaged","replied","archived"]),m=n("ReplyStatus",["drafted","requires_review","approved","sent","failed","blocked_by_policy"]),f=n("HandoffStatus",["created","assigned","acknowledged","completed","reopened"]),c=n("SuggestionStatus",["generated","shown","accepted","edited","rejected","applied","expired"]),g=n("IntentCategory",["support","sales","bug_report","feature_request","billing","onboarding","coordination","general","spam","escalation"]),o=n("ActionSafetyMode",["read_only","draft_only","requires_review","policy_executable","blocked"]),O=n("FeedbackOutcome",["accepted","edited","rejected","unsafe","incomplete"]);import{defineSchemaModel as t,ScalarTypeEnum as e}from"@lssm/lib.schema";var A=t({name:"ChannelAccount",description:"A channel account belonging to a participant",fields:{id:{type:e.String_unsecure(),isOptional:!1},participantId:{type:e.String_unsecure(),isOptional:!1},channelType:{type:a,isOptional:!1},externalId:{type:e.String_unsecure(),isOptional:!1},displayName:{type:e.String_unsecure(),isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0},isPrimary:{type:e.Boolean(),isOptional:!1,defaultValue:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),p=t({name:"IdentityLink",description:"Proposed or confirmed relationship between participant identities",fields:{id:{type:e.String_unsecure(),isOptional:!1},participantId:{type:e.String_unsecure(),isOptional:!1},candidateParticipantId:{type:e.String_unsecure(),isOptional:!1},status:{type:c,isOptional:!1,defaultValue:"generated"},confidence:{type:e.Float_unsecure(),isOptional:!1},reasoning:{type:e.String_unsecure(),isOptional:!0},reviewedBy:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),M=t({name:"CommunicationParticipant",description:"A person or system that participates in conversations",fields:{id:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!0},email:{type:e.EmailAddress(),isOptional:!0},accounts:{type:A,isArray:!0,isOptional:!1},identityLinks:{type:p,isArray:!0,isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),b=t({name:"Attachment",description:"A file or media attachment on a message",fields:{id:{type:e.String_unsecure(),isOptional:!1},messageId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},mimeType:{type:e.String_unsecure(),isOptional:!0},sizeBytes:{type:e.Int_unsecure(),isOptional:!0},url:{type:e.URL(),isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0}}}),u=t({name:"ThreadLink",description:"Link between a thread and an external business object (V2: rich-reference objectRef replaces V1 objectType/objectId)",fields:{id:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},objectRef:{type:e.JSONObject(),isOptional:!1},relation:{type:e.String_unsecure(),isOptional:!0},confidence:{type:e.Float_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),k=t({name:"MessageIntent",description:"Classified message or thread intent with confidence and evidence",fields:{id:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},messageId:{type:e.String_unsecure(),isOptional:!0},category:{type:g,isOptional:!1},confidence:{type:e.Float_unsecure(),isOptional:!1},reasoning:{type:e.String_unsecure(),isOptional:!0},evidenceMessageIds:{type:e.String_unsecure(),isArray:!0,isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),v=t({name:"CommunicationMessage",description:"A single message within a communication thread",fields:{id:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},channelType:{type:a,isOptional:!1},channelAccountId:{type:e.String_unsecure(),isOptional:!1},participantId:{type:e.String_unsecure(),isOptional:!0},externalMessageId:{type:e.String_unsecure(),isOptional:!0},body:{type:e.String_unsecure(),isOptional:!1},bodyNormalized:{type:e.String_unsecure(),isOptional:!0},status:{type:y,isOptional:!1,defaultValue:"received"},intent:{type:k,isOptional:!0},attachments:{type:b,isArray:!0,isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),C=t({name:"CommunicationFormIntake",description:"Declarative source reference for a communication message mapped into an entity-bound form intake result",fields:{id:{type:e.String_unsecure(),isOptional:!1},messageId:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},channelType:{type:a,isOptional:!1},channelAccountId:{type:e.String_unsecure(),isOptional:!1},participantId:{type:e.String_unsecure(),isOptional:!0},entityKey:{type:e.String_unsecure(),isOptional:!1},projectionKind:{type:e.String_unsecure(),isOptional:!1},formKey:{type:e.String_unsecure(),isOptional:!0},formVersion:{type:e.String_unsecure(),isOptional:!0},completionProfileKey:{type:e.String_unsecure(),isOptional:!0},acceptedValues:{type:e.JSONObject(),isOptional:!1},completionDebt:{type:e.JSONObject(),isArray:!0,isOptional:!1},captureStatus:{type:e.String_unsecure(),isOptional:!1,defaultValue:"accepted"},completionStatus:{type:e.String_unsecure(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),D=t({name:"CommunicationThread",description:"A conversation thread spanning one or more channels",fields:{id:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!0},status:{type:d,isOptional:!1,defaultValue:"open"},participantIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},channelTypes:{type:a,isArray:!0,isOptional:!1},links:{type:u,isArray:!0,isOptional:!0},assignedTo:{type:e.String_unsecure(),isOptional:!0},priority:{type:e.String_unsecure(),isOptional:!0},tags:{type:e.String_unsecure(),isArray:!0,isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),S=t({name:"CommunicationAction",description:"Structured action extracted from a conversation",fields:{id:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},owner:{type:e.String_unsecure(),isOptional:!0},deadline:{type:e.DateTime(),isOptional:!0},blockers:{type:e.String_unsecure(),isArray:!0,isOptional:!0},sourceMessageIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},safetyMode:{type:o,isOptional:!1,defaultValue:"draft_only"}}}),E=t({name:"ReplyDraft",description:"An AI-generated or human-authored reply draft",fields:{id:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},messageId:{type:e.String_unsecure(),isOptional:!0},body:{type:e.String_unsecure(),isOptional:!1},status:{type:m,isOptional:!1,defaultValue:"drafted"},generatedBy:{type:e.String_unsecure(),isOptional:!0},modelName:{type:e.String_unsecure(),isOptional:!0},promptVersion:{type:e.String_unsecure(),isOptional:!0},policyVersion:{type:e.String_unsecure(),isOptional:!0},reviewedBy:{type:e.String_unsecure(),isOptional:!0},reviewedAt:{type:e.DateTime(),isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),_=t({name:"HandoffPacket",description:"A structured handoff between owners, teams, or systems",fields:{id:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},status:{type:f,isOptional:!1,defaultValue:"created"},fromOwner:{type:e.String_unsecure(),isOptional:!1},toOwner:{type:e.String_unsecure(),isOptional:!1},summary:{type:e.String_unsecure(),isOptional:!1},keyFacts:{type:e.String_unsecure(),isArray:!0,isOptional:!0},openQuestions:{type:e.String_unsecure(),isArray:!0,isOptional:!0},requiredActions:{type:S,isArray:!0,isOptional:!0},evidenceLinks:{type:e.String_unsecure(),isArray:!0,isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),j=t({name:"CommunicationSummary",description:"AI-generated summary of a thread or message range",fields:{id:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},messageIds:{type:e.String_unsecure(),isArray:!0,isOptional:!0},content:{type:e.String_unsecure(),isOptional:!1},facts:{type:e.JSONObject(),isArray:!0,isOptional:!0},actions:{type:S,isArray:!0,isOptional:!0},decisions:{type:e.JSONObject(),isArray:!0,isOptional:!0},risks:{type:e.JSONObject(),isArray:!0,isOptional:!0},modelName:{type:e.String_unsecure(),isOptional:!0},generatedAt:{type:e.DateTime(),isOptional:!1}}}),h=t({name:"AgentSuggestion",description:"An AI-generated suggestion attached to a thread or message",fields:{id:{type:e.String_unsecure(),isOptional:!1},threadId:{type:e.String_unsecure(),isOptional:!1},messageId:{type:e.String_unsecure(),isOptional:!0},suggestionType:{type:e.String_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},status:{type:c,isOptional:!1,defaultValue:"generated"},modelName:{type:e.String_unsecure(),isOptional:!0},confidence:{type:e.Float_unsecure(),isOptional:!0},policyVersion:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}});var r=["platform.communication-os"],F=s({meta:{key:"communication.handoff.create",version:"1.0.0",stability:"experimental",owners:[...r],tags:["communication","handoff"],description:"Create a handoff packet for a thread",goal:"Transfer context safely between owners or systems",context:"Requires evidence links and does not close source thread automatically"},io:{input:l({name:"CreateHandoffInput",fields:{threadId:{type:i.String_unsecure(),isOptional:!1},fromOwner:{type:i.String_unsecure(),isOptional:!1},toOwner:{type:i.String_unsecure(),isOptional:!1},reason:{type:i.String_unsecure(),isOptional:!0}}}),output:_},policy:{auth:"user"}}),H=s({meta:{key:"communication.threadLink.propose",version:"1.0.0",stability:"experimental",owners:[...r],tags:["communication","thread-link","propose"],description:"Propose a link between a thread and a business object",goal:"Let future vertical consumers bind domain objects without changing the core",context:"Draft-only operation; domain packs own object semantics"},io:{input:u,output:u},policy:{auth:"user"}}),J=s({meta:{key:"communication.identityLink.propose",version:"1.0.0",stability:"experimental",owners:[...r],tags:["communication","identity","propose"],description:"Propose a participant identity link",goal:"Resolve cross-channel identities without reckless auto-merge",context:"Draft-only operation; high-impact merges require human review"},io:{input:p,output:p},policy:{auth:"user"}}),q=s({meta:{key:"communication.escalation.request",version:"1.0.0",stability:"experimental",owners:[...r],tags:["communication","escalation"],description:"Request human escalation for a thread",goal:"Surface high-risk, blocked, or unresolved conversations to a human owner",context:"Policy-executable operation that emits escalation evidence"},io:{input:l({name:"EscalateToHumanInput",fields:{threadId:{type:i.String_unsecure(),isOptional:!1},reason:{type:i.String_unsecure(),isOptional:!1},targetOwner:{type:i.String_unsecure(),isOptional:!0}}}),output:h},policy:{auth:"user"}}),B=s({meta:{key:"communication.feedback.record",version:"1.0.0",stability:"experimental",owners:[...r],tags:["communication","feedback"],description:"Record human feedback on a suggestion, draft, or extraction",goal:"Make AI correction signals auditable and replayable",context:"Used by review surfaces and future evaluation runs"},io:{input:l({name:"RecordHumanFeedbackInput",fields:{targetId:{type:i.String_unsecure(),isOptional:!1},targetType:{type:i.String_unsecure(),isOptional:!1},outcome:{type:O,isOptional:!1},notes:{type:i.String_unsecure(),isOptional:!0}}}),output:l({name:"RecordHumanFeedbackOutput",fields:{feedbackId:{type:i.String_unsecure(),isOptional:!1},safetyMode:{type:o,isOptional:!1}}})},policy:{auth:"user"}});export{F as CreateHandoffCommand,q as EscalateToHumanCommand,J as ProposeIdentityLinkCommand,H as ProposeThreadLinkCommand,B as RecordHumanFeedbackCommand};