@canonmsg/backend-contracts 1.7.1 → 1.8.0

package/dist/schemas/control-session-node.schema.json

@@ -0,0 +1,11 @@
+{
+  "$id": "canon:ControlSessionNodeSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "updatedAt": {
+      "type": "number"
+    }
+  },
+  "additionalProperties": {}
+}

package/dist/schemas/control-signal-event.schema.json

@@ -0,0 +1,35 @@
+{
+  "$id": "canon:ControlSignalEventSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "conversationId": {
+      "type": "string"
+    },
+    "type": {
+      "type": "string",
+      "enum": [
+        "interrupt",
+        "stop_and_drop",
+        "new_session"
+      ]
+    },
+    "updatedAt": {
+      "type": "number"
+    },
+    "raw": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    }
+  },
+  "required": [
+    "conversationId",
+    "type",
+    "updatedAt",
+    "raw"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/control-signal-node.schema.json

@@ -0,0 +1,22 @@
+{
+  "$id": "canon:ControlSignalNodeSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "enum": [
+        "interrupt",
+        "stop_and_drop",
+        "new_session"
+      ]
+    },
+    "updatedAt": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "type"
+  ],
+  "additionalProperties": {}
+}

package/dist/schemas/control-signal-type.schema.json

@@ -0,0 +1,10 @@
+{
+  "$id": "canon:ControlSignalTypeSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "interrupt",
+    "stop_and_drop",
+    "new_session"
+  ]
+}

package/dist/schemas/conversations-response.schema.json

@@ -0,0 +1,127 @@
+{
+  "$id": "canon:ConversationsResponseSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "conversations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "direct",
+              "group"
+            ]
+          },
+          "name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "topic": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "memberIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "isAgentChat": {
+            "type": "boolean"
+          },
+          "behavior": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          },
+          "hasUnread": {
+            "type": "boolean"
+          },
+          "lastMessage": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "text": {
+                    "type": "string"
+                  },
+                  "messageId": {
+                    "type": "string"
+                  },
+                  "senderId": {
+                    "type": "string"
+                  },
+                  "senderType": {
+                    "type": "string",
+                    "enum": [
+                      "human",
+                      "ai_agent"
+                    ]
+                  },
+                  "contentType": {
+                    "type": "string",
+                    "enum": [
+                      "text",
+                      "image",
+                      "audio",
+                      "video",
+                      "file",
+                      "contact_card"
+                    ]
+                  },
+                  "timestamp": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "text",
+                  "senderId",
+                  "senderType",
+                  "timestamp"
+                ],
+                "additionalProperties": {}
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "createdAt": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "type",
+          "memberIds",
+          "lastMessage"
+        ],
+        "additionalProperties": {}
+      }
+    }
+  },
+  "required": [
+    "conversations"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/create-contact-request-request.schema.json

@@ -0,0 +1,17 @@
+{
+  "$id": "canon:CreateContactRequestRequestSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "targetId": {
+      "type": "string"
+    },
+    "message": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "targetId"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/create-contact-request-response.schema.json

@@ -0,0 +1,51 @@
+{
+  "$id": "canon:CreateContactRequestResponseSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "anyOf": [
+    {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "const": "open"
+        }
+      },
+      "required": [
+        "status"
+      ],
+      "additionalProperties": {}
+    },
+    {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "created",
+            "duplicate"
+          ]
+        },
+        "requestId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "status",
+        "requestId"
+      ],
+      "additionalProperties": {}
+    },
+    {
+      "type": "object",
+      "properties": {
+        "message": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "additionalProperties": {}
+    }
+  ]
+}

package/dist/schemas/create-conversation-request.schema.json

@@ -0,0 +1,82 @@
+{
+  "$id": "canon:CreateConversationRequestSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "enum": [
+        "direct",
+        "group"
+      ]
+    },
+    "targetUserId": {
+      "type": "string"
+    },
+    "memberIds": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "name": {
+      "type": "string"
+    },
+    "sessionConfig": {
+      "anyOf": [
+        {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "sessionSelection": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": [
+                "new",
+                "continue_latest",
+                "continue_or_create"
+              ]
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "const": "specific"
+            },
+            "conversationId": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "mode",
+            "conversationId"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "required": [
+    "type"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/create-conversation-response.schema.json

@@ -0,0 +1,29 @@
+{
+  "$id": "canon:CreateConversationResponseSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "conversationId": {
+      "type": "string"
+    },
+    "created": {
+      "type": "boolean"
+    },
+    "reused": {
+      "type": "boolean"
+    },
+    "sessionSelection": {
+      "type": "string",
+      "enum": [
+        "new",
+        "continue_latest",
+        "continue_or_create",
+        "specific"
+      ]
+    }
+  },
+  "required": [
+    "conversationId"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/delete-message-response.schema.json

@@ -0,0 +1,11 @@
+{
+  "$id": "canon:DeleteMessageResponseSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "success": {
+      "type": "boolean"
+    }
+  },
+  "additionalProperties": {}
+}

package/dist/schemas/delivery-intent.schema.json

@@ -0,0 +1,11 @@
+{
+  "$id": "canon:DeliveryIntentSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "queue",
+    "interrupt",
+    "interleave",
+    "stop"
+  ]
+}

package/dist/schemas/forward-message-request.schema.json

@@ -0,0 +1,25 @@
+{
+  "$id": "canon:ForwardMessageRequestSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "sourceConversationId": {
+      "type": "string"
+    },
+    "targetConversationId": {
+      "type": "string"
+    },
+    "messageId": {
+      "type": "string"
+    },
+    "text": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "sourceConversationId",
+    "targetConversationId",
+    "messageId"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/forward-message-response.schema.json

@@ -0,0 +1,35 @@
+{
+  "$id": "canon:ForwardMessageResponseSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "messageId": {
+      "type": "string"
+    },
+    "targetConversationId": {
+      "type": "string"
+    },
+    "forwardedFrom": {
+      "type": "object",
+      "properties": {
+        "sourceConversationId": {
+          "type": "string"
+        },
+        "messageId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "sourceConversationId",
+        "messageId"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "messageId",
+    "targetConversationId",
+    "forwardedFrom"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/forwarded-from.schema.json

@@ -0,0 +1,18 @@
+{
+  "$id": "canon:ForwardedFromSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "sourceConversationId": {
+      "type": "string"
+    },
+    "messageId": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "sourceConversationId",
+    "messageId"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/get-messages-query.schema.json

@@ -0,0 +1,17 @@
+{
+  "$id": "canon:GetMessagesQuerySchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "limit": {
+      "type": "string"
+    },
+    "before": {
+      "type": "string"
+    },
+    "includeBehavior": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/dist/schemas/hitl-approval-category.schema.json

@@ -0,0 +1,15 @@
+{
+  "$id": "canon:HitlApprovalCategorySchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "string",
+  "enum": [
+    "command",
+    "file",
+    "network",
+    "browser",
+    "mcp",
+    "plugin",
+    "canon",
+    "tool"
+  ]
+}

package/dist/schemas/hitl-approval-detail.schema.json

@@ -0,0 +1,21 @@
+{
+  "$id": "canon:HitlApprovalDetailSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "label": {
+      "type": "string"
+    },
+    "value": {
+      "type": "string"
+    },
+    "monospace": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "label",
+    "value"
+  ],
+  "additionalProperties": false
+}

package/dist/schemas/hitl-approval-outcome-record.schema.json

@@ -0,0 +1,33 @@
+{
+  "$id": "canon:HitlApprovalOutcomeRecordSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "approval_outcome"
+    },
+    "approvalId": {
+      "type": "string"
+    },
+    "decision": {
+      "type": "string",
+      "enum": [
+        "allow",
+        "deny"
+      ]
+    },
+    "reason": {
+      "type": "string",
+      "enum": [
+        "replied",
+        "timeout",
+        "session-rule"
+      ]
+    }
+  },
+  "required": [
+    "type"
+  ],
+  "additionalProperties": {}
+}

package/dist/schemas/hitl-approval-reply-record.schema.json

@@ -0,0 +1,57 @@
+{
+  "$id": "canon:HitlApprovalReplyRecordSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "approval_reply"
+    },
+    "approvalId": {
+      "type": "string"
+    },
+    "decision": {
+      "type": "string",
+      "enum": [
+        "allow",
+        "deny"
+      ]
+    },
+    "sessionRule": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "approve-all",
+            "approve-tool",
+            "deny-tool"
+          ]
+        },
+        "toolPattern": {
+          "type": "string"
+        },
+        "expiresAt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "type",
+    "approvalId",
+    "decision"
+  ],
+  "additionalProperties": {}
+}