npm install @emadeus/shield-client

import { ShieldClient } from "@emadeus/shield-client"

const shield = new ShieldClient({
  apiKey: "sk_live_your_key_here",
  baseUrl: "https://api.emadeus.io",
})

const result = await shield.scanInput({
  content: "User message to your AI agent",
})

console.log(result.action)    // "allow" | "sanitize" | "block"
console.log(result.riskScore) // 0-100
console.log(result.threats)   // Array of detected threats

curl -X POST https://api.emadeus.io/v1/scan/input \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello, can you help me?"}'

{
  "action": "sanitize",
  "threats": [{
    "type": "prompt_injection",
    "severity": "high",
    "confidence": 0.95,
    "detail": "Instruction override: ignore previous instructions"
  }],
  "sanitizedContent": "Can you help me with my project?",
  "riskScore": 38,
  "metadata": {
    "scannedAt": "2026-03-16T12:00:00.000Z",
    "scanDurationMs": 2,
    "detectorsRun": ["encoding", "injection", "correlation", "many_shot"],
    "contentLength": 52,
    "source": "api"
  }
}

{
  "chunks": [
    { "content": "Document text chunk 1", "source": "policy.pdf" },
    { "content": "Document text chunk 2", "source": "policy.pdf" }
  ]
}

{
  "tools": [{
    "name": "web_search",
    "description": "Search the web for information",
    "inputSchema": { "type": "object", "properties": { "query": { "type": "string" } } }
  }]
}

{
  "toolName": "query_database",
  "args": { "sql": "SELECT * FROM users WHERE id = 1" },
  "schema": { "properties": { "sql": { "type": "string" } } }
}

import { ShieldClient } from "@emadeus/shield-client"

const shield = new ShieldClient({
  apiKey: "sk_live_...",
  baseUrl: "https://api.emadeus.io",
  timeout: 10000,    // 10s timeout (default)
  maxRetries: 2,     // Retry on 5xx errors (default)
})

// Scan input
const input = await shield.scanInput({ content, conversationId })

// Scan output
const output = await shield.scanOutput({ response: agentReply })

// Scan RAG documents
const rag = await shield.scanRAG([{ content: docChunk, source: "file.pdf" }])

// Scan MCP tools
const mcp = await shield.scanMCP([{ name: "tool", description: "..." }])

// Validate tool call
const valid = await shield.validateToolCall({
  toolName: "search",
  args: { query: "..." },
})

import { ShieldApiError } from "@emadeus/shield-client"

try {
  await shield.scanInput({ content })
} catch (e) {
  if (e instanceof ShieldApiError) {
    console.log(e.status) // HTTP status code
    console.log(e.body)   // Error response body
  }
}