@wowok/agent-mcp 3.3.7 → 3.3.9

package/dist/schemas/messenger_operation.output.json

@@ -1152,13 +1152,37 @@
                   ],
                   "additionalProperties": false,
                   "description": "Time range"
+                },
+                "sealed_available": {
+                  "anyOf": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "KB-03 evidence-tier PRE-CHECK (fail-open, never interrupts generation): whether the third-party-verifiable evidence tier is reachable in this environment. Probed by running the guarded verifier against the freshly generated packet and reading its on-chain key-book anchor verdict (serverKeyAnchor.verified). true = after sign_wts the packet can verify as third-party-verifiable evidence. false = the key book does NOT match its on-chain anchor — a WTS is a private conversation record, NOT third-party-verifiable evidence; promise it only as a private record and use proof_message for anything that must hold chain-side. null = the probe could not score the anchor (probe failed, or the packet carried no server-attested messages) — the tier is UNVERIFIED, not denied; re-probe with verify_wts after sign_wts."
+                },
+                "sealed_available_note": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Human-readable consequence of sealed_available: the tier-available confirmation when true; the 'WTS is a private conversation record, NOT third-party-verifiable evidence' warning when false; the unverified-tier caveat when null."
                 }
               },
               "required": [
                 "files",
                 "htmlFiles",
                 "totalMessageCount",
-                "timeRange"
+                "timeRange",
+                "sealed_available",
+                "sealed_available_note"
               ],
               "additionalProperties": false,
               "description": "Generate WTS result"
@@ -1959,6 +1983,107 @@
           ],
           "additionalProperties": false
         },
+        {
+          "type": "object",
+          "properties": {
+            "operation": {
+              "type": "string",
+              "const": "mark_conversation_read"
+            },
+            "result": {
+              "type": "object",
+              "properties": {
+                "account": {
+                  "type": "string",
+                  "description": "Account the watermark belongs to"
+                },
+                "peer": {
+                  "type": "string",
+                  "description": "Conversation peer"
+                },
+                "read_through_seq": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Highest conversation sequence (leafIndex) this account has marked read locally. null = nothing marked read yet"
+                },
+                "read_at": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Local timestamp (ms) of the last watermark advance; null when no watermark exists"
+                },
+                "peer_read_through_seq": {
+                  "type": "null",
+                  "description": "ALWAYS null: the network exposes no peer read-receipt primitive. Do NOT read this as 'not read' — it is UNKNOWN, never reported as delivered or read"
+                },
+                "peer_receipt_available": {
+                  "type": "boolean",
+                  "const": false,
+                  "description": "ALWAYS false: no peer read-receipt primitive exists on the messenger network"
+                },
+                "scope": {
+                  "type": "string",
+                  "const": "local-session",
+                  "description": "Scope of the local watermark: this MCP server session only"
+                },
+                "disclosure": {
+                  "type": "string",
+                  "description": "Honest statement of why the peer side is unknown (server confirmation != read; viewedAt is local-only)"
+                },
+                "marked_count": {
+                  "type": "number",
+                  "description": "Received messages locally marked as viewed by this call (viewedAt update)"
+                },
+                "capped": {
+                  "type": "boolean",
+                  "description": "True when through_seq exceeded the highest received seq retained locally and the watermark was capped to it"
+                },
+                "requested_through_seq": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "through_seq the caller asked for; null when it was omitted"
+                }
+              },
+              "required": [
+                "account",
+                "peer",
+                "read_through_seq",
+                "read_at",
+                "peer_read_through_seq",
+                "peer_receipt_available",
+                "scope",
+                "disclosure",
+                "marked_count",
+                "capped",
+                "requested_through_seq"
+              ],
+              "additionalProperties": false,
+              "description": "Local read watermark result (peer watermark unavailable by design)"
+            }
+          },
+          "required": [
+            "operation",
+            "result"
+          ],
+          "additionalProperties": false
+        },
         {
           "type": "object",
           "properties": {
@@ -2607,6 +2732,489 @@
                     "description": "Per-account fan-out pull result"
                   },
                   "description": "Fan-out mode (allAccounts/accounts set): one entry per account with isolated errors"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "mode": {
+                      "type": "string",
+                      "const": "incremental",
+                      "description": "Incremental (cursor) read, as opposed to the legacy bare-array pull"
+                    },
+                    "account": {
+                      "type": "string",
+                      "description": "Account read from (resolved address)"
+                    },
+                    "peer": {
+                      "type": "string",
+                      "description": "Conversation peer this cursor is scoped to"
+                    },
+                    "after": {
+                      "type": "number",
+                      "description": "Cursor supplied by the caller; returned messages all have seq > after"
+                    },
+                    "messages": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "messageId": {
+                            "type": "string",
+                            "description": "Message ID"
+                          },
+                          "fromAddress": {
+                            "type": "string",
+                            "description": "Sender address"
+                          },
+                          "toAddress": {
+                            "type": "string",
+                            "description": "Recipient address"
+                          },
+                          "plaintextHash": {
+                            "type": "string",
+                            "description": "Plaintext hash"
+                          },
+                          "plaintext": {
+                            "description": "Decrypted plaintext text. UNDEFINED for attachment messages (zipMetadata present) — their base64 envelope is stripped at the read boundary; read msg.attachment for metadata and use save_attachment for bytes",
+                            "type": "string"
+                          },
+                          "attachment": {
+                            "description": "Present when this message is an attachment (zipMetadata present). Byte-free descriptor; payload never embedded",
+                            "type": "object",
+                            "properties": {
+                              "kind": {
+                                "type": "string",
+                                "enum": [
+                                  "image",
+                                  "video",
+                                  "audio",
+                                  "voice",
+                                  "file",
+                                  "wts",
+                                  "wip"
+                                ],
+                                "description": "Attachment business type: image/video/audio are inline-renderable media; 'voice' is an explicit voice message (webm cannot be auto-distinguished from video); 'file' is a generic document; wts/wip are evidence files"
+                              },
+                              "fileName": {
+                                "type": "string",
+                                "description": "Original file name (transport .zip suffix stripped)"
+                              },
+                              "mimeType": {
+                                "type": "string",
+                                "description": "MIME type inferred from extension or sender-provided"
+                              },
+                              "size": {
+                                "type": "number",
+                                "description": "Payload size in bytes (uncompressed)"
+                              },
+                              "caption": {
+                                "description": "Sender-provided caption (E2EE, inside the encrypted envelope)",
+                                "type": "string"
+                              },
+                              "durationMs": {
+                                "description": "Audio/video duration in milliseconds",
+                                "type": "number"
+                              },
+                              "width": {
+                                "description": "Media width in pixels",
+                                "type": "number"
+                              },
+                              "height": {
+                                "description": "Media height in pixels",
+                                "type": "number"
+                              }
+                            },
+                            "required": [
+                              "kind",
+                              "fileName",
+                              "mimeType",
+                              "size"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "replyTo": {
+                            "description": "Quoted (replied-to) message reference, if this message replies to a previous one",
+                            "type": "object",
+                            "properties": {
+                              "messageId": {
+                                "type": "string",
+                                "description": "Replied-to message ID (unique within the conversation)"
+                              }
+                            },
+                            "required": [
+                              "messageId"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "guardAddress": {
+                            "description": "Guard address",
+                            "type": "string"
+                          },
+                          "passportAddress": {
+                            "description": "Passport address",
+                            "type": "string"
+                          },
+                          "lastReceivedLeafIndex": {
+                            "description": "Last received leaf index",
+                            "type": "number"
+                          },
+                          "direction": {
+                            "type": "string",
+                            "enum": [
+                              "sent",
+                              "received"
+                            ],
+                            "description": "Message direction"
+                          },
+                          "status": {
+                            "type": "string",
+                            "enum": [
+                              "pending",
+                              "confirmed",
+                              "read",
+                              "failed",
+                              "rejected",
+                              "decrypted",
+                              "decrypt_failed"
+                            ],
+                            "description": "Message status"
+                          },
+                          "msgType": {
+                            "anyOf": [
+                              {
+                                "type": "number",
+                                "const": 1
+                              },
+                              {
+                                "type": "number",
+                                "const": 3
+                              }
+                            ],
+                            "description": "Message type"
+                          },
+                          "leafIndex": {
+                            "description": "Leaf index",
+                            "type": "number"
+                          },
+                          "prevRoot": {
+                            "description": "Previous Merkle Root",
+                            "type": "string"
+                          },
+                          "newRoot": {
+                            "description": "Current Merkle Root",
+                            "type": "string"
+                          },
+                          "serverSignature": {
+                            "description": "Server signature",
+                            "type": "string"
+                          },
+                          "serverTimestamp": {
+                            "description": "Server confirmation timestamp",
+                            "type": "number"
+                          },
+                          "serverPublicKey": {
+                            "description": "Server public key",
+                            "type": "string"
+                          },
+                          "arkConfirmed": {
+                            "description": "ARK confirmation",
+                            "type": "object",
+                            "properties": {
+                              "recipient": {
+                                "type": "string",
+                                "description": "Recipient address"
+                              },
+                              "recipientPublicKey": {
+                                "type": "string",
+                                "description": "Recipient public key"
+                              },
+                              "signature": {
+                                "type": "string",
+                                "description": "Recipient signature"
+                              },
+                              "timestamp": {
+                                "type": "number",
+                                "description": "ARK confirmation time"
+                              }
+                            },
+                            "required": [
+                              "recipient",
+                              "recipientPublicKey",
+                              "signature",
+                              "timestamp"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "createdAt": {
+                            "type": "number",
+                            "description": "Message creation time (client)"
+                          },
+                          "receivedAt": {
+                            "description": "Local reception time",
+                            "type": "number"
+                          },
+                          "zipMetadata": {
+                            "description": "ZIP file metadata",
+                            "type": "object",
+                            "properties": {
+                              "fileName": {
+                                "type": "string",
+                                "description": "ZIP filename"
+                              },
+                              "fileSize": {
+                                "type": "number",
+                                "description": "File size in bytes"
+                              },
+                              "fileHash": {
+                                "type": "string",
+                                "description": "File SHA256 hash"
+                              },
+                              "contentType": {
+                                "type": "string",
+                                "enum": [
+                                  "text",
+                                  "zip",
+                                  "wts",
+                                  "wip"
+                                ],
+                                "description": "Content type"
+                              },
+                              "localCachePath": {
+                                "description": "Local cache path",
+                                "type": "string"
+                              },
+                              "downloadedAt": {
+                                "description": "Download timestamp",
+                                "type": "number"
+                              }
+                            },
+                            "required": [
+                              "fileName",
+                              "fileSize",
+                              "fileHash",
+                              "contentType"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "proof": {
+                            "description": "Latest on-chain proof object address (projection of the last entry in proofs; derived at the read boundary for single-value consumers)",
+                            "type": "string"
+                          },
+                          "proofs": {
+                            "description": "All on-chain proofs anchored for this message, ascending by publish time (one-to-many; a message may be proofed multiple times)",
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "address": {
+                                  "type": "string",
+                                  "description": "On-chain Proof object address"
+                                },
+                                "network": {
+                                  "description": "Network the proof was published on (testnet/mainnet/localnet); absent in legacy local records",
+                                  "type": "string"
+                                },
+                                "createdAt": {
+                                  "type": "number",
+                                  "description": "Local record time (ms)"
+                                }
+                              },
+                              "required": [
+                                "address",
+                                "createdAt"
+                              ],
+                              "additionalProperties": false,
+                              "description": "One on-chain proof anchored for this message"
+                            }
+                          },
+                          "decryptError": {
+                            "description": "Decryption failure reason",
+                            "type": "string"
+                          },
+                          "decryptAttempts": {
+                            "description": "Number of decryption attempts",
+                            "type": "number"
+                          },
+                          "lastDecryptAttemptAt": {
+                            "description": "Last decryption attempt timestamp",
+                            "type": "number"
+                          },
+                          "viewedAt": {
+                            "description": "Timestamp when the current user viewed this message (local storage). If present, indicates the message has been viewed by the user. Only applicable to received messages (direction === 'received')",
+                            "type": "number"
+                          }
+                        },
+                        "required": [
+                          "messageId",
+                          "fromAddress",
+                          "toAddress",
+                          "plaintextHash",
+                          "direction",
+                          "status",
+                          "msgType",
+                          "createdAt"
+                        ],
+                        "additionalProperties": false,
+                        "description": "Message object"
+                      },
+                      "description": "Messages with seq > after, ascending, at most `limit` of them"
+                    },
+                    "highest_seq": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Highest seq returned in this page — persist it and pass it as `after` for the next page. null = no new messages"
+                    },
+                    "latest_seq": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Highest seq retained locally for this conversation (compare with after to see what is pending)"
+                    },
+                    "has_more": {
+                      "type": "boolean",
+                      "description": "True when further messages beyond highest_seq are already available locally"
+                    },
+                    "gap": {
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "from_seq": {
+                              "type": "number",
+                              "description": "First missing conversation sequence number"
+                            },
+                            "to_seq": {
+                              "type": "number",
+                              "description": "Last missing conversation sequence number"
+                            },
+                            "missing_count": {
+                              "type": "number",
+                              "description": "Total missing sequence numbers inside the scanned window"
+                            },
+                            "reason": {
+                              "type": "string",
+                              "description": "Why continuity cannot be assumed"
+                            }
+                          },
+                          "required": [
+                            "from_seq",
+                            "to_seq",
+                            "missing_count",
+                            "reason"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Detected message-sequence gap. A result carrying a gap is DEGRADED — do not treat it as a continuous stream"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "First detected sequence gap, or null when this page is continuous"
+                    },
+                    "degraded": {
+                      "type": "boolean",
+                      "description": "True when the result is discontinuous or incomplete in any way — never present a degraded page as complete"
+                    },
+                    "degraded_reasons": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Every reason the result is marked degraded (empty when degraded=false)"
+                    },
+                    "read_receipt": {
+                      "type": "object",
+                      "properties": {
+                        "account": {
+                          "type": "string",
+                          "description": "Account the watermark belongs to"
+                        },
+                        "peer": {
+                          "type": "string",
+                          "description": "Conversation peer"
+                        },
+                        "read_through_seq": {
+                          "anyOf": [
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Highest conversation sequence (leafIndex) this account has marked read locally. null = nothing marked read yet"
+                        },
+                        "read_at": {
+                          "anyOf": [
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Local timestamp (ms) of the last watermark advance; null when no watermark exists"
+                        },
+                        "peer_read_through_seq": {
+                          "type": "null",
+                          "description": "ALWAYS null: the network exposes no peer read-receipt primitive. Do NOT read this as 'not read' — it is UNKNOWN, never reported as delivered or read"
+                        },
+                        "peer_receipt_available": {
+                          "type": "boolean",
+                          "const": false,
+                          "description": "ALWAYS false: no peer read-receipt primitive exists on the messenger network"
+                        },
+                        "scope": {
+                          "type": "string",
+                          "const": "local-session",
+                          "description": "Scope of the local watermark: this MCP server session only"
+                        },
+                        "disclosure": {
+                          "type": "string",
+                          "description": "Honest statement of why the peer side is unknown (server confirmation != read; viewedAt is local-only)"
+                        }
+                      },
+                      "required": [
+                        "account",
+                        "peer",
+                        "read_through_seq",
+                        "read_at",
+                        "peer_read_through_seq",
+                        "peer_receipt_available",
+                        "scope",
+                        "disclosure"
+                      ],
+                      "additionalProperties": false,
+                      "description": "Local read watermark for this conversation (peer watermark unavailable by design)"
+                    }
+                  },
+                  "required": [
+                    "mode",
+                    "account",
+                    "peer",
+                    "after",
+                    "messages",
+                    "highest_seq",
+                    "latest_seq",
+                    "has_more",
+                    "gap",
+                    "degraded",
+                    "degraded_reasons",
+                    "read_receipt"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Incremental mode (`after` set): cursor page with highest_seq/has_more/gap/read watermark"
                 }
               ]
             }