@lssm/lib.communication-spec 3.1.1

package/dist/contracts/agent-lifecycle-projection.d.ts

@@ -0,0 +1,98 @@
+import type { AgentHelpRequestV1 } from '@lssm/lib.contracts-spec/agent/protocol/help';
+import { z } from 'zod';
+export declare const COMMUNICATION_AGENT_LIFECYCLE_PROJECTION_SCHEMA_VERSION: '1.0.0';
+export declare const CommunicationAgentLifecycleProjectionStatusV1Schema: z.ZodEnum<{
+    blocked: "blocked";
+    cancelled: "cancelled";
+    completed: "completed";
+    failed: "failed";
+    queued: "queued";
+    running: "running";
+    waiting_for_approval: "waiting_for_approval";
+    waiting_for_help: "waiting_for_help";
+}>;
+/** Immutable communication view of durable agent state; never an effect command. */
+export declare const CommunicationAgentLifecycleProjectionV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    projectionRef: z.ZodString;
+    projectionDigest: z.ZodString;
+    scope: z.ZodObject<{
+        tenantRef: z.ZodString;
+        workspaceRef: z.ZodOptional<z.ZodString>;
+        spaceRef: z.ZodOptional<z.ZodString>;
+        subjectRef: z.ZodString;
+    }, z.core.$strict>;
+    lifecycleLink: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0.0">;
+        linkRef: z.ZodString;
+        profile: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+            revision: z.ZodNumber;
+        }, z.core.$strict>;
+        agentRef: z.ZodString;
+        applicationRef: z.ZodString;
+        scope: z.ZodObject<{
+            tenantRef: z.ZodString;
+            workspaceRef: z.ZodOptional<z.ZodString>;
+            spaceRef: z.ZodOptional<z.ZodString>;
+            subjectRef: z.ZodString;
+        }, z.core.$strict>;
+        runRef: z.ZodOptional<z.ZodString>;
+        taskRef: z.ZodOptional<z.ZodString>;
+        helpRequestRef: z.ZodOptional<z.ZodString>;
+        approvalRequestRef: z.ZodOptional<z.ZodString>;
+        backgroundResultRef: z.ZodOptional<z.ZodString>;
+        canonicalConversation: z.ZodOptional<z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>>;
+        session: z.ZodOptional<z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+            revision: z.ZodNumber;
+        }, z.core.$strict>>;
+        correlationRef: z.ZodString;
+        evidenceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        waiting_for_approval: "waiting_for_approval";
+        waiting_for_help: "waiting_for_help";
+    }>;
+    checkpoint: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    canonicalConversation: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    helpRequest: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    approvalRequest: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    progressSummaryRef: z.ZodString;
+    occurredAt: z.ZodString;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    effectAuthority: z.ZodLiteral<"none">;
+}, z.core.$strict>;
+export type CommunicationAgentLifecycleProjectionV1 = z.infer<typeof CommunicationAgentLifecycleProjectionV1Schema>;
+export declare function validateCommunicationAgentLifecycleProjectionV1(input: {
+    projection: CommunicationAgentLifecycleProjectionV1;
+    helpRequest?: AgentHelpRequestV1;
+}): string[];
+/** Strict G012 binding used by canonical-conversation persistence paths. */
+export declare function validateCanonicalAgentLifecycleProjectionV1(input: {
+    projection: CommunicationAgentLifecycleProjectionV1;
+    helpRequest?: AgentHelpRequestV1;
+}): string[];

package/dist/contracts/agent-lifecycle-projection.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as s}from"zod";import{z as c}from"zod";var R="1.0.0",y="1.0.0",q={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=c.string().trim().min(1),d=c.string().datetime({offset:!0}),p=c.string().regex(/^sha256:[a-f0-9]{64}$/),r=c.object({ref:t,digest:p}).strict(),a=r.extend({revision:c.number().int().positive()}).strict(),f=c.object({tenantRef:t,workspaceRef:t.optional(),spaceRef:t.optional(),subjectRef:t}).strict(),S=c.object({schemaVersion:c.literal(R),profileRef:t,revision:c.number().int().positive(),agentRef:t,applicationRef:t,scope:f,routeBindings:c.array(a),connectionRefs:c.array(t),preferenceSet:a,policyRefs:c.array(t).min(1),evidenceRefs:c.array(t).min(1),createdAt:d,updatedAt:d,profileDigest:p}).strict().superRefine((e,i)=>{for(let n of["connectionRefs","policyRefs","evidenceRefs"])if(new Set(e[n]).size!==e[n].length)i.addIssue({code:c.ZodIssueCode.custom,path:[n],message:`${n} must be unique`});let o=e.routeBindings.map((n)=>n.ref);if(new Set(o).size!==o.length)i.addIssue({code:c.ZodIssueCode.custom,path:["routeBindings"],message:"route bindings must be unique"})}),g=c.object({schemaVersion:c.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:r.optional(),session:a.optional(),correlationRef:t,evidenceRefs:c.array(t).min(1)}).strict().superRefine((e,i)=>{if(new Set(e.evidenceRefs).size!==e.evidenceRefs.length)i.addIssue({code:c.ZodIssueCode.custom,path:["evidenceRefs"],message:"evidenceRefs must be unique"});if(!e.runRef&&!e.taskRef&&!e.helpRequestRef&&!e.approvalRequestRef&&!e.backgroundResultRef)i.addIssue({code:c.ZodIssueCode.custom,path:["runRef"],message:"at least one run, task, help request, approval request, or background result ref is required"})});function l(e,i){return e.tenantRef===i.tenantRef&&e.workspaceRef===i.workspaceRef&&e.spaceRef===i.spaceRef&&e.subjectRef===i.subjectRef}function k(e){let i=[];for(let o of["agentRef","applicationRef"])if(e.profile[o]!==e.lifecycleLink[o])i.push(`Lifecycle ${o} 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)i.push("Lifecycle profile binding does not match the agent profile");if(!l(e.profile.scope,e.lifecycleLink.scope))i.push("Lifecycle scope does not match the agent profile");return i}function b(e){let{intent:i,progress:o}=e,n=[];if(o.deliveryRef!==i.deliveryRef||o.intent.ref!==i.deliveryRef||o.intent.digest!==i.deliveryDigest)n.push("Progress delivery does not match the intent");if(!l(o.scope,i.scope))n.push("Progress scope does not match the intent");if(o.recipientRef!==i.recipientRefs[0])n.push("Progress recipient does not match the intent");let u=i.requestedRoutes.find((h)=>h.ref===o.route.ref);if(!u||u.revision!==o.route.revision||u.digest!==o.route.digest)n.push("Progress route was not requested by the intent");if(Date.parse(o.occurredAt)<Date.parse(i.createdAt)||Date.parse(o.occurredAt)>Date.parse(i.expiresAt))n.push("Progress occurred outside the intent validity window");return n}var C="1.0.0",m=s.string().trim().min(1),v=s.string().datetime({offset:!0}),V=s.enum(["queued","running","waiting_for_help","waiting_for_approval","blocked","completed","failed","cancelled"]),B=s.object({schemaVersion:s.literal(C),projectionRef:m,projectionDigest:p,scope:f,lifecycleLink:g,status:V,checkpoint:r,canonicalConversation:r.optional(),helpRequest:r.optional(),approvalRequest:r.optional(),progressSummaryRef:m,occurredAt:v,evidenceRefs:s.array(m).min(1),effectAuthority:s.literal("none")}).strict().superRefine((e,i)=>{if(new Set(e.evidenceRefs).size!==e.evidenceRefs.length)i.addIssue({code:s.ZodIssueCode.custom,path:["evidenceRefs"],message:"evidenceRefs must be unique"});if(e.status==="waiting_for_help"!==Boolean(e.helpRequest))i.addIssue({code:s.ZodIssueCode.custom,path:["helpRequest"],message:"help binding is required only while waiting for help"});if(e.status==="waiting_for_approval"!==Boolean(e.approvalRequest))i.addIssue({code:s.ZodIssueCode.custom,path:["approvalRequest"],message:"approval binding is required only while waiting for approval"})});function A(e){let i=[],{projection:o,helpRequest:n}=e;if(o.canonicalConversation&&(o.canonicalConversation.ref!==o.lifecycleLink.canonicalConversation?.ref||o.canonicalConversation.digest!==o.lifecycleLink.canonicalConversation?.digest))i.push("Lifecycle projection conversation does not match its link");if(o.status==="waiting_for_help"&&!n)i.push("Waiting-for-help projection requires the durable help request");if(!l(o.scope,o.lifecycleLink.scope))i.push("Projection scope does not match the lifecycle link");if(n&&(o.lifecycleLink.runRef!==n.runRef||o.lifecycleLink.helpRequestRef!==n.id))i.push("Help request does not match the lifecycle link");if(n&&o.helpRequest?.ref!==n.id)i.push("Projection help binding does not match the help request");if(n&&o.checkpoint.ref!==n.checkpointRef)i.push("Projection checkpoint does not match the help request");if(o.approvalRequest?.ref!==o.lifecycleLink.approvalRequestRef)i.push("Projection approval binding does not match the lifecycle link");return i}function _(e){let{projection:i}=e;if(!i.canonicalConversation)return["Lifecycle projection requires a canonical conversation"];if(!i.lifecycleLink.session)return["Lifecycle projection requires a canonical session"];return A(e)}export{C as COMMUNICATION_AGENT_LIFECYCLE_PROJECTION_SCHEMA_VERSION,V as CommunicationAgentLifecycleProjectionStatusV1Schema,B as CommunicationAgentLifecycleProjectionV1Schema,_ as validateCanonicalAgentLifecycleProjectionV1,A as validateCommunicationAgentLifecycleProjectionV1};

package/dist/contracts/agent-lifecycle-projection.test.d.ts

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

package/dist/contracts/agent-surface-control.d.ts

@@ -0,0 +1,210 @@
+import { z } from 'zod';
+export declare const COMMUNICATION_AGENT_SURFACE_CONTROL_V1: 'communication.agent-surface-control.v1';
+export declare const COMMUNICATION_AGENT_SURFACE_CONTROL_RESULT_V1: 'communication.agent-surface-control-result.v1';
+export declare const CommunicationAgentSurfaceControlPayloadV1Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"help_response">;
+    helpRequest: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    response: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"approval_decision">;
+    approvalRequest: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    decision: z.ZodEnum<{
+        approved: "approved";
+        rejected: "rejected";
+    }>;
+    effect: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"steer">;
+    instruction: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"queue">;
+    instruction: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"pause">;
+    reasonRef: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"cancel">;
+    reasonRef: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"branch">;
+    branchRequest: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>], "kind">;
+/** Origin-neutral control request; the injected authority remains decisive. */
+export declare const CommunicationAgentSurfaceControlV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"communication.agent-surface-control.v1">;
+    controlRef: z.ZodString;
+    controlDigest: z.ZodString;
+    scope: z.ZodObject<{
+        tenantRef: z.ZodString;
+        workspaceRef: z.ZodOptional<z.ZodString>;
+        spaceRef: z.ZodOptional<z.ZodString>;
+        subjectRef: z.ZodString;
+    }, z.core.$strict>;
+    canonicalConversation: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    lifecycleLink: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"1.0.0">;
+        linkRef: z.ZodString;
+        profile: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+            revision: z.ZodNumber;
+        }, z.core.$strict>;
+        agentRef: z.ZodString;
+        applicationRef: z.ZodString;
+        scope: z.ZodObject<{
+            tenantRef: z.ZodString;
+            workspaceRef: z.ZodOptional<z.ZodString>;
+            spaceRef: z.ZodOptional<z.ZodString>;
+            subjectRef: z.ZodString;
+        }, z.core.$strict>;
+        runRef: z.ZodOptional<z.ZodString>;
+        taskRef: z.ZodOptional<z.ZodString>;
+        helpRequestRef: z.ZodOptional<z.ZodString>;
+        approvalRequestRef: z.ZodOptional<z.ZodString>;
+        backgroundResultRef: z.ZodOptional<z.ZodString>;
+        canonicalConversation: z.ZodOptional<z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>>;
+        session: z.ZodOptional<z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+            revision: z.ZodNumber;
+        }, z.core.$strict>>;
+        correlationRef: z.ZodString;
+        evidenceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    actorPrincipalRef: z.ZodString;
+    actorIdentityEvidence: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    authorityDecision: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"help_response">;
+        helpRequest: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>;
+        response: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"approval_decision">;
+        approvalRequest: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>;
+        decision: z.ZodEnum<{
+            approved: "approved";
+            rejected: "rejected";
+        }>;
+        effect: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"steer">;
+        instruction: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"queue">;
+        instruction: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"pause">;
+        reasonRef: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cancel">;
+        reasonRef: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"branch">;
+        branchRequest: z.ZodObject<{
+            ref: z.ZodString;
+            digest: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "kind">;
+    idempotencyKey: z.ZodString;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodString;
+    effectAuthority: z.ZodLiteral<"none">;
+}, z.core.$strict>;
+export type CommunicationAgentSurfaceControlV1 = z.infer<typeof CommunicationAgentSurfaceControlV1Schema>;
+export declare const CommunicationAgentSurfaceControlResultV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"communication.agent-surface-control-result.v1">;
+    resultRef: z.ZodString;
+    resultDigest: z.ZodString;
+    control: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    scope: z.ZodObject<{
+        tenantRef: z.ZodString;
+        workspaceRef: z.ZodOptional<z.ZodString>;
+        spaceRef: z.ZodOptional<z.ZodString>;
+        subjectRef: z.ZodString;
+    }, z.core.$strict>;
+    canonicalConversation: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    authorityDecision: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>;
+    outcome: z.ZodEnum<{
+        applied: "applied";
+        denied: "denied";
+        duplicate: "duplicate";
+        expired: "expired";
+    }>;
+    executionReceipt: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    decidedAt: z.ZodString;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    effectAuthority: z.ZodLiteral<"none">;
+}, z.core.$strict>;
+export type CommunicationAgentSurfaceControlResultV1 = z.infer<typeof CommunicationAgentSurfaceControlResultV1Schema>;
+export declare function digestCommunicationAgentSurfaceControlV1(control: Omit<CommunicationAgentSurfaceControlV1, 'controlDigest'>): Promise<`sha256:${string}`>;
+export declare function verifyCommunicationAgentSurfaceControlV1(control: CommunicationAgentSurfaceControlV1): Promise<boolean>;
+export declare function digestCommunicationAgentSurfaceControlResultV1(result: Omit<CommunicationAgentSurfaceControlResultV1, 'resultDigest'>): Promise<`sha256:${string}`>;
+export declare function verifyCommunicationAgentSurfaceControlResultV1(result: CommunicationAgentSurfaceControlResultV1): Promise<boolean>;
+export declare function validateCommunicationAgentSurfaceControlBindingV1(control: CommunicationAgentSurfaceControlV1): string[];
+export declare function validateCommunicationAgentSurfaceControlResultBindingV1(input: {
+    control: CommunicationAgentSurfaceControlV1;
+    result: CommunicationAgentSurfaceControlResultV1;
+}): string[];

package/dist/contracts/agent-surface-control.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as o}from"zod";import{z as r}from"zod";var A="1.0.0",V="1.0.0",L={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"},i=r.string().trim().min(1),h=r.string().datetime({offset:!0}),a=r.string().regex(/^sha256:[a-f0-9]{64}$/),l=r.object({ref:i,digest:a}).strict(),d=l.extend({revision:r.number().int().positive()}).strict(),m=r.object({tenantRef:i,workspaceRef:i.optional(),spaceRef:i.optional(),subjectRef:i}).strict(),q=r.object({schemaVersion:r.literal(A),profileRef:i,revision:r.number().int().positive(),agentRef:i,applicationRef:i,scope:m,routeBindings:r.array(d),connectionRefs:r.array(i),preferenceSet:d,policyRefs:r.array(i).min(1),evidenceRefs:r.array(i).min(1),createdAt:h,updatedAt:h,profileDigest:a}).strict().superRefine((e,t)=>{for(let c of["connectionRefs","policyRefs","evidenceRefs"])if(new Set(e[c]).size!==e[c].length)t.addIssue({code:r.ZodIssueCode.custom,path:[c],message:`${c} must be unique`});let n=e.routeBindings.map((c)=>c.ref);if(new Set(n).size!==n.length)t.addIssue({code:r.ZodIssueCode.custom,path:["routeBindings"],message:"route bindings must be unique"})}),R=r.object({schemaVersion:r.literal(V),linkRef:i,profile:d,agentRef:i,applicationRef:i,scope:m,runRef:i.optional(),taskRef:i.optional(),helpRequestRef:i.optional(),approvalRequestRef:i.optional(),backgroundResultRef:i.optional(),canonicalConversation:l.optional(),session:d.optional(),correlationRef:i,evidenceRefs:r.array(i).min(1)}).strict().superRefine((e,t)=>{if(new Set(e.evidenceRefs).size!==e.evidenceRefs.length)t.addIssue({code:r.ZodIssueCode.custom,path:["evidenceRefs"],message:"evidenceRefs must be unique"});if(!e.runRef&&!e.taskRef&&!e.helpRequestRef&&!e.approvalRequestRef&&!e.backgroundResultRef)t.addIssue({code:r.ZodIssueCode.custom,path:["runRef"],message:"at least one run, task, help request, approval request, or background result ref is required"})});function p(e,t){return e.tenantRef===t.tenantRef&&e.workspaceRef===t.workspaceRef&&e.spaceRef===t.spaceRef&&e.subjectRef===t.subjectRef}function I(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(!p(e.profile.scope,e.lifecycleLink.scope))t.push("Lifecycle scope does not match the agent profile");return t}function B(e){let{intent:t,progress:n}=e,c=[];if(n.deliveryRef!==t.deliveryRef||n.intent.ref!==t.deliveryRef||n.intent.digest!==t.deliveryDigest)c.push("Progress delivery does not match the intent");if(!p(n.scope,t.scope))c.push("Progress scope does not match the intent");if(n.recipientRef!==t.recipientRefs[0])c.push("Progress recipient does not match the intent");let f=t.requestedRoutes.find((g)=>g.ref===n.route.ref);if(!f||f.revision!==n.route.revision||f.digest!==n.route.digest)c.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))c.push("Progress occurred outside the intent validity window");return c}async function C(e){let t=new TextEncoder().encode(y(e)),n=new Uint8Array(t.byteLength);n.set(t);let c=await crypto.subtle.digest("SHA-256",n.buffer),f=Array.from(new Uint8Array(c),(g)=>g.toString(16).padStart(2,"0")).join("");return a.parse(`sha256:${f}`)}function y(e){if(Array.isArray(e))return`[${e.map(y).join(",")}]`;if(e&&typeof e==="object")return`{${Object.entries(e).sort(([t],[n])=>t.localeCompare(n)).map(([t,n])=>`${JSON.stringify(t)}:${y(n)}`).join(",")}}`;return JSON.stringify(e)}var S="communication.agent-surface-control.v1",v="communication.agent-surface-control-result.v1",u=o.string().trim().min(1),s=l,x=o.discriminatedUnion("kind",[o.object({kind:o.literal("help_response"),helpRequest:s,response:s}).strict(),o.object({kind:o.literal("approval_decision"),approvalRequest:s,decision:o.enum(["approved","rejected"]),effect:s}).strict(),o.object({kind:o.literal("steer"),instruction:s}).strict(),o.object({kind:o.literal("queue"),instruction:s}).strict(),o.object({kind:o.literal("pause"),reasonRef:u}).strict(),o.object({kind:o.literal("cancel"),reasonRef:u}).strict(),o.object({kind:o.literal("branch"),branchRequest:s}).strict()]),w=o.object({schemaVersion:o.literal(S),controlRef:u,controlDigest:a,scope:m,canonicalConversation:l,lifecycleLink:R,actorPrincipalRef:u,actorIdentityEvidence:s,authorityDecision:s,payload:x,idempotencyKey:u,createdAt:o.string().datetime({offset:!0}),expiresAt:o.string().datetime({offset:!0}),effectAuthority:o.literal("none")}).strict().superRefine((e,t)=>{if(Date.parse(e.expiresAt)<=Date.parse(e.createdAt))t.addIssue({code:o.ZodIssueCode.custom,path:["expiresAt"],message:"control expiry must follow creation"})}),T=o.object({schemaVersion:o.literal(v),resultRef:u,resultDigest:a,control:s,scope:m,canonicalConversation:s,authorityDecision:s,outcome:o.enum(["applied","duplicate","denied","expired"]),executionReceipt:s.optional(),decidedAt:o.string().datetime({offset:!0}),evidenceRefs:o.array(u).min(1),effectAuthority:o.literal("none")}).strict().superRefine((e,t)=>{if((e.outcome==="applied"||e.outcome==="duplicate")!==Boolean(e.executionReceipt))t.addIssue({code:o.ZodIssueCode.custom,path:["executionReceipt"],message:"executed controls require an execution receipt"})});async function b(e){return C(e)}async function z(e){let{controlDigest:t,...n}=e;return t===await b(n)}async function k(e){return C(e)}async function M(e){let{resultDigest:t,...n}=e;return t===await k(n)}function U(e){let t=[];if(!p(e.scope,e.lifecycleLink.scope))t.push("Agent surface control scope does not match lifecycle scope");if(e.lifecycleLink.canonicalConversation?.ref!==e.canonicalConversation.ref||e.lifecycleLink.canonicalConversation?.digest!==e.canonicalConversation.digest)t.push("Agent surface control conversation does not match lifecycle link");if(!e.lifecycleLink.runRef)t.push("Agent surface control requires a run-bound lifecycle link");if(e.payload.kind==="help_response"&&e.payload.helpRequest.ref!==e.lifecycleLink.helpRequestRef)t.push("Help response does not match the lifecycle help request");if(e.payload.kind==="approval_decision"&&e.payload.approvalRequest.ref!==e.lifecycleLink.approvalRequestRef)t.push("Approval decision does not match the lifecycle approval request");return t}function Z(e){let t=[];if(e.result.control.ref!==e.control.controlRef||e.result.control.digest!==e.control.controlDigest)t.push("Agent surface result control binding does not match");if(!p(e.result.scope,e.control.scope))t.push("Agent surface result scope does not match");if(e.result.canonicalConversation.ref!==e.control.canonicalConversation.ref||e.result.canonicalConversation.digest!==e.control.canonicalConversation.digest)t.push("Agent surface result conversation does not match");if(e.result.authorityDecision.ref!==e.control.authorityDecision.ref||e.result.authorityDecision.digest!==e.control.authorityDecision.digest)t.push("Agent surface result authority decision does not match");return t}export{v as COMMUNICATION_AGENT_SURFACE_CONTROL_RESULT_V1,S as COMMUNICATION_AGENT_SURFACE_CONTROL_V1,x as CommunicationAgentSurfaceControlPayloadV1Schema,T as CommunicationAgentSurfaceControlResultV1Schema,w as CommunicationAgentSurfaceControlV1Schema,k as digestCommunicationAgentSurfaceControlResultV1,b as digestCommunicationAgentSurfaceControlV1,U as validateCommunicationAgentSurfaceControlBindingV1,Z as validateCommunicationAgentSurfaceControlResultBindingV1,M as verifyCommunicationAgentSurfaceControlResultV1,z as verifyCommunicationAgentSurfaceControlV1};

package/dist/contracts/agent-surface-control.test.d.ts

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

package/dist/contracts/ai-assistance.operations.d.ts

@@ -0,0 +1,187 @@
+export declare const ExtractDecisionsCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    decisions: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isArray: true;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const ExtractRisksCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    risks: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        isArray: true;
+        isOptional: false;
+    };
+}>, undefined>;
+export declare const DraftReplyCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    threadId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    messageId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    instruction: {
+        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;
+    };
+    body: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    generatedBy: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    modelName: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    promptVersion: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    policyVersion: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    reviewedBy: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    reviewedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    metadata: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        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 SendReplyCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    draftId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+}>, import("@lssm/lib.schema").SchemaModel<{
+    draftId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string]>;
+        isOptional: false;
+    };
+    sentAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+}>, undefined>;
+export declare const BlockReplyByPolicyCommand: import("@lssm/lib.contracts-spec").OperationSpec<import("@lssm/lib.schema").SchemaModel<{
+    draftId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    policyRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    reason: {
+        type: import("@lssm/lib.schema").FieldType<string, 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;
+    };
+    messageId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    body: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    status: {
+        type: import("@lssm/lib.schema").EnumType<[string, string, string, string, string, string]>;
+        isOptional: false;
+        defaultValue: string;
+    };
+    generatedBy: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    modelName: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    promptVersion: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    policyVersion: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    reviewedBy: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    reviewedAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: true;
+    };
+    metadata: {
+        type: import("@lssm/lib.schema").FieldType<Record<string, unknown>, Record<string, unknown>>;
+        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>;

package/dist/contracts/ai-assistance.operations.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineCommand as r}from"@lssm/lib.contracts-spec";import{defineSchemaModel as a,ScalarTypeEnum as i}from"@lssm/lib.schema";import{defineEnum as n}from"@lssm/lib.schema";var s=n("ChannelType",["email","sms","whatsapp","telegram","matrix","web_chat","voice","internal_chat","custom_adapter","future_bridge","unknown"]),c=n("ThreadStatus",["open","waiting_on_human","waiting_on_external_party","action_required","resolved","archived"]),d=n("MessageStatus",["received","normalized","classified","linked","triaged","replied","archived"]),p=n("ReplyStatus",["drafted","requires_review","approved","sent","failed","blocked_by_policy"]),y=n("HandoffStatus",["created","assigned","acknowledged","completed","reopened"]),l=n("SuggestionStatus",["generated","shown","accepted","edited","rejected","applied","expired"]),m=n("IntentCategory",["support","sales","bug_report","feature_request","billing","onboarding","coordination","general","spam","escalation"]),f=n("ActionSafetyMode",["read_only","draft_only","requires_review","policy_executable","blocked"]),x=n("FeedbackOutcome",["accepted","edited","rejected","unsafe","incomplete"]);import{defineSchemaModel as t,ScalarTypeEnum as e}from"@lssm/lib.schema";var g=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:s,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}}}),S=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:l,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}}}),D=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:g,isArray:!0,isOptional:!1},identityLinks:{type:S,isArray:!0,isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),_=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}}}),h=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}}}),A=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:m,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}}}),w=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:s,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:d,isOptional:!1,defaultValue:"received"},intent:{type:A,isOptional:!0},attachments:{type:_,isArray:!0,isOptional:!0},metadata:{type:e.JSONObject(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),M=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:s,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}}}),E=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:c,isOptional:!1,defaultValue:"open"},participantIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},channelTypes:{type:s,isArray:!0,isOptional:!1},links:{type:h,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}}}),O=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:f,isOptional:!1,defaultValue:"draft_only"}}}),u=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:p,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}}}),v=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:y,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:O,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}}}),C=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:O,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}}}),R=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:l,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 o=["platform.communication-os"],B=r({meta:{key:"communication.decision.extract",version:"1.0.0",stability:"experimental",owners:[...o],tags:["communication","decision","extract"],description:"Extract decisions and open questions from a thread",goal:"Make buried decisions reviewable with source references",context:"Read-only/draft-only operation for summaries and handoffs"},io:{input:a({name:"ExtractDecisionsInput",fields:{threadId:{type:i.String_unsecure(),isOptional:!1}}}),output:a({name:"ExtractDecisionsOutput",fields:{decisions:{type:i.JSONObject(),isArray:!0,isOptional:!1}}})},policy:{auth:"user"}}),F=r({meta:{key:"communication.risk.extract",version:"1.0.0",stability:"experimental",owners:[...o],tags:["communication","risk","blocker"],description:"Extract risks and blockers from a thread",goal:"Surface blockers, policy risks, and unresolved dependencies",context:"Read-only/draft-only operation for triage and escalation"},io:{input:a({name:"ExtractRisksInput",fields:{threadId:{type:i.String_unsecure(),isOptional:!1}}}),output:a({name:"ExtractRisksOutput",fields:{risks:{type:i.JSONObject(),isArray:!0,isOptional:!1}}})},policy:{auth:"user"}}),L=r({meta:{key:"communication.reply.draft",version:"1.0.0",stability:"experimental",owners:[...o],tags:["communication","reply","draft"],description:"Draft a reply using thread context and policy",goal:"Generate a safe, context-aware reply draft",context:"Draft-only operation; policy may require review or block the draft"},io:{input:a({name:"DraftReplyInput",fields:{threadId:{type:i.String_unsecure(),isOptional:!1},messageId:{type:i.String_unsecure(),isOptional:!0},instruction:{type:i.String_unsecure(),isOptional:!0}}}),output:u},policy:{auth:"user"}}),q=r({meta:{key:"communication.reply.send",version:"1.0.0",stability:"experimental",owners:[...o],tags:["communication","reply","send"],description:"Send an approved reply through its channel",goal:"Deliver a reply only when policy allows",context:"Policy-executable operation; every sent reply must be auditable"},io:{input:a({name:"SendReplyInput",fields:{draftId:{type:i.String_unsecure(),isOptional:!1}}}),output:a({name:"SendReplyOutput",fields:{draftId:{type:i.String_unsecure(),isOptional:!1},status:{type:p,isOptional:!1},sentAt:{type:i.DateTime(),isOptional:!0}}})},policy:{auth:"user"}}),H=r({meta:{key:"communication.reply.blockByPolicy",version:"1.0.0",stability:"experimental",owners:[...o],tags:["communication","reply","policy","blocked"],description:"Record that a reply was blocked by policy",goal:"Keep blocked reply decisions explicit and auditable",context:"Used by reply policy gates before any outbound side effect"},io:{input:a({name:"BlockReplyByPolicyInput",fields:{draftId:{type:i.String_unsecure(),isOptional:!1},policyRef:{type:i.String_unsecure(),isOptional:!1},reason:{type:i.String_unsecure(),isOptional:!1}}}),output:u},policy:{auth:"admin"}});export{H as BlockReplyByPolicyCommand,L as DraftReplyCommand,B as ExtractDecisionsCommand,F as ExtractRisksCommand,q as SendReplyCommand};

package/dist/contracts/artifact-digest.d.ts

@@ -0,0 +1,3 @@
+export type CommunicationDigestV1 = `sha256:${string}`;
+/** Browser-safe canonical digest for immutable CommunicationOS artifacts. */
+export declare function digestCommunicationArtifactV1(value: unknown): Promise<CommunicationDigestV1>;

package/dist/contracts/artifact-digest.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as o}from"zod";var g="1.0.0",y="1.0.0",h={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"},n=o.string().trim().min(1),m=o.string().datetime({offset:!0}),a=o.string().regex(/^sha256:[a-f0-9]{64}$/),u=o.object({ref:n,digest:a}).strict(),c=u.extend({revision:o.number().int().positive()}).strict(),d=o.object({tenantRef:n,workspaceRef:n.optional(),spaceRef:n.optional(),subjectRef:n}).strict(),C=o.object({schemaVersion:o.literal(g),profileRef:n,revision:o.number().int().positive(),agentRef:n,applicationRef:n,scope:d,routeBindings:o.array(c),connectionRefs:o.array(n),preferenceSet:c,policyRefs:o.array(n).min(1),evidenceRefs:o.array(n).min(1),createdAt:m,updatedAt:m,profileDigest:a}).strict().superRefine((e,t)=>{for(let s of["connectionRefs","policyRefs","evidenceRefs"])if(new Set(e[s]).size!==e[s].length)t.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)t.addIssue({code:o.ZodIssueCode.custom,path:["routeBindings"],message:"route bindings must be unique"})}),V=o.object({schemaVersion:o.literal(y),linkRef:n,profile:c,agentRef:n,applicationRef:n,scope:d,runRef:n.optional(),taskRef:n.optional(),helpRequestRef:n.optional(),approvalRequestRef:n.optional(),backgroundResultRef:n.optional(),canonicalConversation:u.optional(),session:c.optional(),correlationRef:n,evidenceRefs:o.array(n).min(1)}).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(!e.runRef&&!e.taskRef&&!e.helpRequestRef&&!e.approvalRequestRef&&!e.backgroundResultRef)t.addIssue({code:o.ZodIssueCode.custom,path:["runRef"],message:"at least one run, task, help request, approval request, or background result ref is required"})});function l(e,t){return e.tenantRef===t.tenantRef&&e.workspaceRef===t.workspaceRef&&e.spaceRef===t.spaceRef&&e.subjectRef===t.subjectRef}function v(e){let t=[];for(let i of["agentRef","applicationRef"])if(e.profile[i]!==e.lifecycleLink[i])t.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)t.push("Lifecycle profile binding does not match the agent profile");if(!l(e.profile.scope,e.lifecycleLink.scope))t.push("Lifecycle scope does not match the agent profile");return t}function A(e){let{intent:t,progress:i}=e,s=[];if(i.deliveryRef!==t.deliveryRef||i.intent.ref!==t.deliveryRef||i.intent.digest!==t.deliveryDigest)s.push("Progress delivery does not match the intent");if(!l(i.scope,t.scope))s.push("Progress scope does not match the intent");if(i.recipientRef!==t.recipientRefs[0])s.push("Progress recipient does not match the intent");let r=t.requestedRoutes.find((f)=>f.ref===i.route.ref);if(!r||r.revision!==i.route.revision||r.digest!==i.route.digest)s.push("Progress route was not requested by the intent");if(Date.parse(i.occurredAt)<Date.parse(t.createdAt)||Date.parse(i.occurredAt)>Date.parse(t.expiresAt))s.push("Progress occurred outside the intent validity window");return s}async function k(e){let t=new TextEncoder().encode(p(e)),i=new Uint8Array(t.byteLength);i.set(t);let s=await crypto.subtle.digest("SHA-256",i.buffer),r=Array.from(new Uint8Array(s),(f)=>f.toString(16).padStart(2,"0")).join("");return a.parse(`sha256:${r}`)}function p(e){if(Array.isArray(e))return`[${e.map(p).join(",")}]`;if(e&&typeof e==="object")return`{${Object.entries(e).sort(([t],[i])=>t.localeCompare(i)).map(([t,i])=>`${JSON.stringify(t)}:${p(i)}`).join(",")}}`;return JSON.stringify(e)}export{k as digestCommunicationArtifactV1};

package/dist/contracts/canonical-agent-conversation.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { CommunicationScopeBindingV1Schema } from './agent-communication.js';
+export declare const COMMUNICATION_CANONICAL_AGENT_CONVERSATION_V1: 'communication.canonical-agent-conversation.v1';
+/** Durable conversation identity shared by every authorized surface. */
+export declare const CommunicationCanonicalAgentConversationV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"communication.canonical-agent-conversation.v1">;
+    conversationRef: z.ZodString;
+    conversationDigest: 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>;
+    roomRef: z.ZodString;
+    session: z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+        revision: z.ZodNumber;
+    }, z.core.$strict>;
+    origin: z.ZodEnum<{
+        background: "background";
+        branch: "branch";
+        interactive: "interactive";
+        recovery: "recovery";
+        replay: "replay";
+        scheduled: "scheduled";
+    }>;
+    parentConversation: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strict>>;
+    participantRefs: z.ZodArray<z.ZodString>;
+    channelIdentityRefs: z.ZodArray<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    effectAuthority: z.ZodLiteral<"none">;
+}, z.core.$strict>;
+export type CommunicationCanonicalAgentConversationV1 = z.infer<typeof CommunicationCanonicalAgentConversationV1Schema>;
+export declare function digestCommunicationCanonicalAgentConversationV1(conversation: Omit<CommunicationCanonicalAgentConversationV1, 'conversationDigest'>): Promise<`sha256:${string}`>;
+export declare function verifyCommunicationCanonicalAgentConversationV1(conversation: CommunicationCanonicalAgentConversationV1): Promise<boolean>;
+export declare function validateCanonicalConversationScopeV1(input: {
+    conversation: CommunicationCanonicalAgentConversationV1;
+    scope: z.infer<typeof CommunicationScopeBindingV1Schema>;
+}): string[];

package/dist/contracts/canonical-agent-conversation.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as r}from"zod";import{z as i}from"zod";var h="1.0.0",R="1.0.0",S={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"},o=i.string().trim().min(1),C=i.string().datetime({offset:!0}),c=i.string().regex(/^sha256:[a-f0-9]{64}$/),f=i.object({ref:o,digest:c}).strict(),a=f.extend({revision:i.number().int().positive()}).strict(),p=i.object({tenantRef:o,workspaceRef:o.optional(),spaceRef:o.optional(),subjectRef:o}).strict(),b=i.object({schemaVersion:i.literal(h),profileRef:o,revision:i.number().int().positive(),agentRef:o,applicationRef:o,scope:p,routeBindings:i.array(a),connectionRefs:i.array(o),preferenceSet:a,policyRefs:i.array(o).min(1),evidenceRefs:i.array(o).min(1),createdAt:C,updatedAt:C,profileDigest:c}).strict().superRefine((e,n)=>{for(let s of["connectionRefs","policyRefs","evidenceRefs"])if(new Set(e[s]).size!==e[s].length)n.addIssue({code:i.ZodIssueCode.custom,path:[s],message:`${s} must be unique`});let t=e.routeBindings.map((s)=>s.ref);if(new Set(t).size!==t.length)n.addIssue({code:i.ZodIssueCode.custom,path:["routeBindings"],message:"route bindings must be unique"})}),I=i.object({schemaVersion:i.literal(R),linkRef:o,profile:a,agentRef:o,applicationRef:o,scope:p,runRef:o.optional(),taskRef:o.optional(),helpRequestRef:o.optional(),approvalRequestRef:o.optional(),backgroundResultRef:o.optional(),canonicalConversation:f.optional(),session:a.optional(),correlationRef:o,evidenceRefs:i.array(o).min(1)}).strict().superRefine((e,n)=>{if(new Set(e.evidenceRefs).size!==e.evidenceRefs.length)n.addIssue({code:i.ZodIssueCode.custom,path:["evidenceRefs"],message:"evidenceRefs must be unique"});if(!e.runRef&&!e.taskRef&&!e.helpRequestRef&&!e.approvalRequestRef&&!e.backgroundResultRef)n.addIssue({code:i.ZodIssueCode.custom,path:["runRef"],message:"at least one run, task, help request, approval request, or background result ref is required"})});function u(e,n){return e.tenantRef===n.tenantRef&&e.workspaceRef===n.workspaceRef&&e.spaceRef===n.spaceRef&&e.subjectRef===n.subjectRef}function k(e){let n=[];for(let t of["agentRef","applicationRef"])if(e.profile[t]!==e.lifecycleLink[t])n.push(`Lifecycle ${t} 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(!u(e.profile.scope,e.lifecycleLink.scope))n.push("Lifecycle scope does not match the agent profile");return n}function x(e){let{intent:n,progress:t}=e,s=[];if(t.deliveryRef!==n.deliveryRef||t.intent.ref!==n.deliveryRef||t.intent.digest!==n.deliveryDigest)s.push("Progress delivery does not match the intent");if(!u(t.scope,n.scope))s.push("Progress scope does not match the intent");if(t.recipientRef!==n.recipientRefs[0])s.push("Progress recipient does not match the intent");let m=n.requestedRoutes.find((l)=>l.ref===t.route.ref);if(!m||m.revision!==t.route.revision||m.digest!==t.route.digest)s.push("Progress route was not requested by the intent");if(Date.parse(t.occurredAt)<Date.parse(n.createdAt)||Date.parse(t.occurredAt)>Date.parse(n.expiresAt))s.push("Progress occurred outside the intent validity window");return s}async function y(e){let n=new TextEncoder().encode(g(e)),t=new Uint8Array(n.byteLength);t.set(n);let s=await crypto.subtle.digest("SHA-256",t.buffer),m=Array.from(new Uint8Array(s),(l)=>l.toString(16).padStart(2,"0")).join("");return c.parse(`sha256:${m}`)}function g(e){if(Array.isArray(e))return`[${e.map(g).join(",")}]`;if(e&&typeof e==="object")return`{${Object.entries(e).sort(([n],[t])=>n.localeCompare(t)).map(([n,t])=>`${JSON.stringify(n)}:${g(t)}`).join(",")}}`;return JSON.stringify(e)}var A="communication.canonical-agent-conversation.v1",d=r.string().trim().min(1),w=r.object({schemaVersion:r.literal(A),conversationRef:d,conversationDigest:c,revision:r.number().int().positive(),scope:p,roomRef:d,session:a,origin:r.enum(["interactive","scheduled","background","recovery","replay","branch"]),parentConversation:f.optional(),participantRefs:r.array(d).min(1),channelIdentityRefs:r.array(d),createdAt:r.string().datetime({offset:!0}),updatedAt:r.string().datetime({offset:!0}),effectAuthority:r.literal("none")}).strict().superRefine((e,n)=>{for(let t of["participantRefs","channelIdentityRefs"])if(new Set(e[t]).size!==e[t].length)n.addIssue({code:r.ZodIssueCode.custom,path:[t],message:`${t} must be unique`});if(e.origin==="branch"!==Boolean(e.parentConversation))n.addIssue({code:r.ZodIssueCode.custom,path:["parentConversation"],message:"parentConversation is required only for branch origin"});if(Date.parse(e.updatedAt)<Date.parse(e.createdAt))n.addIssue({code:r.ZodIssueCode.custom,path:["updatedAt"],message:"updatedAt cannot precede createdAt"})});async function V(e){return y(e)}async function P(e){let{conversationDigest:n,...t}=e;return n===await V(t)}function E(e){return u(e.conversation.scope,e.scope)?[]:["Canonical conversation scope does not match"]}export{A as COMMUNICATION_CANONICAL_AGENT_CONVERSATION_V1,w as CommunicationCanonicalAgentConversationV1Schema,V as digestCommunicationCanonicalAgentConversationV1,E as validateCanonicalConversationScopeV1,P as verifyCommunicationCanonicalAgentConversationV1};

package/dist/contracts/canonical-agent-conversation.test.d.ts

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