npm install @emadeus/shield-client

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

const shield = new ShieldClient({
  apiKey: "eshld_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 eshld_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-04-28T12:00:00.000Z",
    "scanDurationMs": 2,
    "detectorsRun": [
      "encoding", "injection", "correlation",
      "many_shot", "image_injection", "classifier"
    ],
    "contentLength": 52,
    "source": "api",
    "agentClassification": "human"
  }
}

{
  "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" } } }
}

curl -X POST https://api.emadeus.io/v1/canary \
  -H "Authorization: Bearer eshld_..." \
  -H "Content-Type: application/json" \
  -d '{"type": "url"}'

curl https://api.emadeus.io/v1/canary \
  -H "Authorization: Bearer eshld_..."

curl https://api.emadeus.io/v1/canary/ct_abc123/accesses \
  -H "Authorization: Bearer eshld_..."

curl -X POST https://api.emadeus.io/v1/intelligence/report \
  -H "Authorization: Bearer eshld_..." \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "your-internal-id",
    "threats": [{
      "type": "prompt_injection",
      "severity": "high",
      "pattern": "ignore previous instructions",
      "confidence": 0.9
    }]
  }'

curl https://api.emadeus.io/v1/intelligence/feed \
  -H "Authorization: Bearer eshld_..."

curl -X POST https://api.emadeus.io/v1/feedback/false-positive \
  -H "Authorization: Bearer eshld_..." \
  -H "Content-Type: application/json" \
  -d '{"scanId": "...", "reason": "legitimate medical question"}'

curl -X POST https://api.emadeus.io/v1/feedback/missed-attack \
  -H "Authorization: Bearer eshld_..." \
  -H "Content-Type: application/json" \
  -d '{"contentHash": "sha256:...", "attackType": "prompt_injection",
       "description": "attacker used base64-wrapped instruction override"}'

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

const shield = new ShieldClient({
  apiKey: "eshld_...",
  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
  }
}