Implementation-ready skeletons plus minimal working examples for request, degraded, observability, and structured failure outcomes.

<form id="clarixo-assistant-form">
  <textarea id="clarixo-message" placeholder="Ask CLARIXO..."></textarea>
  <button type="submit">Send</button>
</form>

<script>
  document.getElementById('clarixo-assistant-form').addEventListener('submit', async function (event) {
    event.preventDefault();

    const payload = {
      action: 'message',
      message: document.getElementById('clarixo-message').value,
      integration: {
        source: 'example_app',
        module: 'assistant',
        scene: 'customer_chat',
        version: 'v1',
        environment: 'production'
      },
      context: {
        lang: 'en',
        session_id: 'host-session-id',
        page: 'assistant_page',
        is_logged_in: true,
        client: {
          channel: 'admin_web',
          surface: 'assistant_surface'
        }
      }
    };

    const response = await fetch('/ai_chat.php', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      credentials: 'same-origin',
      body: JSON.stringify(payload)
    });

    const data = await response.json();
    console.log('CLARIXO_REPLY', data);
  });
</script>

<?php
declare(strict_types=1);

header('Content-Type: application/json; charset=utf-8');

$raw = file_get_contents('php://input');
$data = json_decode($raw ?: '{}', true);

$action = (string)($data['action'] ?? '');
$message = (string)($data['message'] ?? '');
$integration = is_array($data['integration'] ?? null) ? $data['integration'] : [];
$context = is_array($data['context'] ?? null) ? $data['context'] : [];

if ($action !== 'message' || $message === '') {
    http_response_code(400);
    echo json_encode([
        'ok' => false,
        'error' => [
            'type' => 'integration_error',
            'code' => 'invalid_request',
            'message' => 'The request is missing a valid action or message.',
            'retryable' => false
        ]
    ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    exit;
}

$integrationSource = (string)($integration['source'] ?? '');
$integrationModule = (string)($integration['module'] ?? '');
$integrationScene = (string)($integration['scene'] ?? '');

if ($integrationSource === '' || $integrationModule === '' || $integrationScene === '') {
    http_response_code(400);
    echo json_encode([
        'ok' => false,
        'error' => [
            'type' => 'integration_error',
            'code' => 'missing_integration_identity',
            'message' => 'source, module, and scene are required.',
            'retryable' => false
        ]
    ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    exit;
}

$response = [
    'ok' => true,
    'reply' => 'Example CLARIXO response placeholder.',
    'actions' => [],
    'meta' => [
        'source' => 'clarixo',
        'provider' => 'clarixo-native',
        'integration_source' => $integrationSource,
        'integration_module' => $integrationModule,
        'integration_scene' => $integrationScene,
        'ops_final_status' => 'healthy',
        'ops_needs_review' => 0
    ]
];

echo json_encode($response, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

<?php
declare(strict_types=1);

header('Content-Type: application/json; charset=utf-8');

$payload = [
    'ok' => true,
    'window' => ['range' => '24h'],
    'summary' => [
        'total_conversations' => 12,
        'healthy_count' => 9,
        'healthy_rate' => 0.75,
        'fallback_count' => 2,
        'fallback_rate' => 0.1667,
        'low_confidence_count' => 1,
        'low_confidence_rate' => 0.0833,
        'manual_review_count' => 0,
        'manual_review_rate' => 0.0,
        'contract_issue_count' => 0,
        'contract_issue_rate' => 0.0
    ],
    'queues' => [
        'manual_review_pending' => 0,
        'fallback' => 2,
        'low_confidence' => 1
    ],
    'breakdowns' => [
        'by_module' => [
            ['key' => 'assistant', 'label' => 'assistant', 'count' => 12]
        ],
        'by_scene' => [
            ['key' => 'customer_chat', 'label' => 'customer_chat', 'count' => 12]
        ],
        'by_status' => [
            ['key' => 'healthy', 'label' => 'healthy', 'count' => 9, 'rate' => 0.75],
            ['key' => 'fallback', 'label' => 'fallback', 'count' => 2, 'rate' => 0.1667],
            ['key' => 'low_confidence', 'label' => 'low_confidence', 'count' => 1, 'rate' => 0.0833]
        ]
    ]
];

echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

<section class="clarixo-runtime-detail">
  <h2>Latest CLARIXO Runtime</h2>
  <dl>
    <dt>Integration Source</dt>
    <dd>tgtracing</dd>
    <dt>Integration Module</dt>
    <dd>assistant</dd>
    <dt>Integration Scene</dt>
    <dd>customer_chat</dd>
    <dt>Provider</dt>
    <dd>clarixo-native</dd>
    <dt>Final Status</dt>
    <dd>healthy</dd>
    <dt>Needs Review</dt>
    <dd>0</dd>
  </dl>
</section>