Files
isphere-ai-bridge/docs/design.md
2026-07-05 00:44:28 +08:00

1.9 KiB

iSphere AI Bridge Design

Objective

Make iSphere messages usable by AI digital employees without rebuilding the full communication platform.

First POC

The first POC reads recent authorized messages, converts them into a normalized JSON model, generates draft replies, and records evidence. It does not automatically send messages.

Architecture

iSphere / MockCloud / existing bridge
  -> source connector
  -> message adapter
  -> AI draft worker
  -> human review
  -> evidence log

Source Connectors

  1. Local data connector: reads local databases, logs, or caches in read-only mode.
  2. Existing bridge connector: talks to OpenClawBridge or XmppBridgeService when available.
  3. UI/RPA connector: wraps the desktop client with limited actions.
  4. Network connector: wraps discovered HTTP/SOAP/XMPP/WebSocket APIs when validated.

Normalized Message Model

{
  "message_id": "string",
  "conversation_id": "string",
  "conversation_name": "string",
  "conversation_type": "direct|group|system",
  "sender_id": "string",
  "sender_name": "string",
  "content_type": "text|image|file|rich|notify",
  "content_text": "string",
  "attachments": [],
  "created_at": "ISO-8601 or Unix ms",
  "received_at": "ISO-8601 or Unix ms",
  "source": "local-db|log|plugin|xmpp|http|rpa|mock",
  "raw_ref": "path/table/packet/window reference"
}

Approval Policy

  • Read access can be automated in test scope.
  • Draft generation can be automated.
  • Sending messages requires human approval in the first implementation.
  • Every send action must log target, content hash, timestamp, approver, and connector.

Verification

The project is successful when it can:

  1. Find at least one stable authorized message source.
  2. Extract recent messages into normalized JSON.
  3. Generate a reply draft.
  4. Produce an evidence report with exact paths, commands, and limits.