skedyul 1.2.44 → 1.2.48

package/dist/context/types.d.ts

@@ -9,7 +9,7 @@ export declare const CRMContextSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CRMContext = z.infer<typeof CRMContextSchema>;
 /**
- * Sender context - who sent the message
+ * Sender context - who sent the message (legacy, kept for backwards compatibility)
  */
 export declare const SenderContextSchema: z.ZodObject<{
     kind: z.ZodEnum<{
@@ -50,66 +50,189 @@ export declare const ThreadInfoSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ThreadInfo = z.infer<typeof ThreadInfoSchema>;
 /**
- * Full agent context - what the agent sees
+ * Subscription - channel identifier for the contact
+ */
+export declare const SubscriptionSchema: z.ZodObject<{
+    identifierValue: z.ZodString;
+    channelHandle: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Subscription = z.infer<typeof SubscriptionSchema>;
+/**
+ * Association - CRM instance linked to a contact
+ */
+export declare const AssociationSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export type Association = z.infer<typeof AssociationSchema>;
+/**
+ * Contact - mirrors production contact structure
+ */
+export declare const ContactSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    subscription: z.ZodOptional<z.ZodObject<{
+        identifierValue: z.ZodString;
+        channelHandle: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    associations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Contact = z.infer<typeof ContactSchema>;
+/**
+ * Agent sender context - who sent the message
+ */
+export declare const AgentSenderContextSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        contact: "contact";
+        member: "member";
+    }>;
+    displayName: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contact: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        subscription: z.ZodOptional<z.ZodObject<{
+            identifierValue: z.ZodString;
+            channelHandle: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        associations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentSenderContext = z.infer<typeof AgentSenderContextSchema>;
+/**
+ * Agent thread context item - a linked CRM instance
+ */
+export declare const AgentThreadContextSchema: z.ZodObject<{
+    handle: z.ZodString;
+    model: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export type AgentThreadContext = z.infer<typeof AgentThreadContextSchema>;
+/**
+ * Agent context - unified context for both sandbox and production
+ *
+ * This is the primary context shape used by agents. It can be:
+ * - Built from real thread data (production mode)
+ * - Loaded from agent YAML mockContext (sandbox mode)
  */
 export declare const AgentContextSchema: z.ZodObject<{
     sender: z.ZodObject<{
         kind: z.ZodEnum<{
-            CONTACT: "CONTACT";
-            MEMBER: "MEMBER";
-            AGENT: "AGENT";
-            WORKFLOW: "WORKFLOW";
+            contact: "contact";
+            member: "member";
         }>;
         displayName: z.ZodOptional<z.ZodString>;
-        email: z.ZodOptional<z.ZodString>;
         role: z.ZodOptional<z.ZodString>;
         permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        crm: z.ZodOptional<z.ZodObject<{
-            model: z.ZodString;
-            instanceId: z.ZodString;
-            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        contact: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            subscription: z.ZodOptional<z.ZodObject<{
+                identifierValue: z.ZodString;
+                channelHandle: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            associations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
     contexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
         handle: z.ZodString;
         model: z.ZodString;
-        instanceId: z.ZodString;
-        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, z.core.$strip>>>;
-    thread: z.ZodObject<{
-        id: z.ZodString;
-        title: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        kind: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    workplace: z.ZodOptional<z.ZodObject<{
-        id: z.ZodString;
-        name: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AgentContext = z.infer<typeof AgentContextSchema>;
 /**
- * Mock context for sandbox testing
+ * Severity level for context validation issues.
+ * - ERROR: Critical issue - agent cannot run (e.g., missing required field)
+ * - WARNING: Non-critical issue - agent runs degraded (e.g., missing recommended field)
  */
+export declare const ContextIssueSeveritySchema: z.ZodEnum<{
+    ERROR: "ERROR";
+    WARNING: "WARNING";
+}>;
+export type ContextIssueSeverity = z.infer<typeof ContextIssueSeveritySchema>;
 /**
- * Mock subscription - channel identifier for the contact
+ * Type of context validation issue.
  */
+export declare const ContextIssueTypeSchema: z.ZodEnum<{
+    MISSING_ROUTING_PARTICIPANT: "MISSING_ROUTING_PARTICIPANT";
+    MISSING_ASSOCIATION: "MISSING_ASSOCIATION";
+    MISSING_REQUIRED_FIELD: "MISSING_REQUIRED_FIELD";
+    MISSING_RECOMMENDED_FIELD: "MISSING_RECOMMENDED_FIELD";
+}>;
+export type ContextIssueType = z.infer<typeof ContextIssueTypeSchema>;
+/**
+ * A single validation issue found during context validation.
+ */
+export declare const ContextIssueSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        MISSING_ROUTING_PARTICIPANT: "MISSING_ROUTING_PARTICIPANT";
+        MISSING_ASSOCIATION: "MISSING_ASSOCIATION";
+        MISSING_REQUIRED_FIELD: "MISSING_REQUIRED_FIELD";
+        MISSING_RECOMMENDED_FIELD: "MISSING_RECOMMENDED_FIELD";
+    }>;
+    severity: z.ZodEnum<{
+        ERROR: "ERROR";
+        WARNING: "WARNING";
+    }>;
+    model: z.ZodOptional<z.ZodString>;
+    field: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ContextIssue = z.infer<typeof ContextIssueSchema>;
+/**
+ * Result of context validation.
+ * - valid: false if any ERROR-level issues exist (agent should not run)
+ * - degraded: true if any WARNING-level issues exist (agent runs with reduced performance)
+ * - issues: List of all validation issues found
+ */
+export declare const ContextValidationResultSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    degraded: z.ZodBoolean;
+    issues: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            MISSING_ROUTING_PARTICIPANT: "MISSING_ROUTING_PARTICIPANT";
+            MISSING_ASSOCIATION: "MISSING_ASSOCIATION";
+            MISSING_REQUIRED_FIELD: "MISSING_REQUIRED_FIELD";
+            MISSING_RECOMMENDED_FIELD: "MISSING_RECOMMENDED_FIELD";
+        }>;
+        severity: z.ZodEnum<{
+            ERROR: "ERROR";
+            WARNING: "WARNING";
+        }>;
+        model: z.ZodOptional<z.ZodString>;
+        field: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ContextValidationResult = z.infer<typeof ContextValidationResultSchema>;
+/** @deprecated Use SubscriptionSchema instead */
 export declare const MockSubscriptionSchema: z.ZodObject<{
     identifierValue: z.ZodString;
     channelHandle: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type MockSubscription = z.infer<typeof MockSubscriptionSchema>;
-/**
- * Mock association - CRM instance linked to a contact
- */
+/** @deprecated Use Subscription instead */
+export type MockSubscription = Subscription;
+/** @deprecated Use AssociationSchema instead */
 export declare const MockAssociationSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
-export type MockAssociation = z.infer<typeof MockAssociationSchema>;
-/**
- * Mock contact - mirrors production contact structure
- */
+/** @deprecated Use Association instead */
+export type MockAssociation = Association;
+/** @deprecated Use ContactSchema instead */
 export declare const MockContactSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
@@ -122,7 +245,9 @@ export declare const MockContactSchema: z.ZodObject<{
         data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
-export type MockContact = z.infer<typeof MockContactSchema>;
+/** @deprecated Use Contact instead */
+export type MockContact = Contact;
+/** @deprecated Use AgentSenderContextSchema instead */
 export declare const MockSenderContextSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         contact: "contact";
@@ -144,13 +269,17 @@ export declare const MockSenderContextSchema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export type MockSenderContext = z.infer<typeof MockSenderContextSchema>;
+/** @deprecated Use AgentSenderContext instead */
+export type MockSenderContext = AgentSenderContext;
+/** @deprecated Use AgentThreadContextSchema instead */
 export declare const MockThreadContextSchema: z.ZodObject<{
     handle: z.ZodString;
     model: z.ZodString;
     data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
-export type MockThreadContext = z.infer<typeof MockThreadContextSchema>;
+/** @deprecated Use AgentThreadContext instead */
+export type MockThreadContext = AgentThreadContext;
+/** @deprecated Use AgentContextSchema instead */
 export declare const MockContextSchema: z.ZodObject<{
     sender: z.ZodObject<{
         kind: z.ZodEnum<{
@@ -179,7 +308,8 @@ export declare const MockContextSchema: z.ZodObject<{
         data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
-export type MockContext = z.infer<typeof MockContextSchema>;
+/** @deprecated Use AgentContext instead */
+export type MockContext = AgentContext;
 /**
  * Sandbox configuration in agent YAML
  */
@@ -213,5 +343,33 @@ export declare const SandboxConfigSchema: z.ZodObject<{
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
+    context: z.ZodOptional<z.ZodObject<{
+        sender: z.ZodObject<{
+            kind: z.ZodEnum<{
+                contact: "contact";
+                member: "member";
+            }>;
+            displayName: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodString>;
+            permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            contact: z.ZodOptional<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                name: z.ZodOptional<z.ZodString>;
+                subscription: z.ZodOptional<z.ZodObject<{
+                    identifierValue: z.ZodString;
+                    channelHandle: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                associations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    id: z.ZodOptional<z.ZodString>;
+                    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        contexts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            handle: z.ZodString;
+            model: z.ZodString;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type SandboxConfig = z.infer<typeof SandboxConfigSchema>;