Getting Started

// First, create a project (one-time — you become the owner)
// POST https://api.srag.simeonov.app/api/scopes  { "name": "my-project" }
// → { "id": "a3f2b1c4-...", "name": "my-project" }

const PROJECT_ID = "a3f2b1c4-..."; // UUID from project creation
const ACCESS_TOKEN = "eyJ...";   // Supabase access token (see Authentication)

// Combined search (both pipelines enabled by default)
const response = await fetch(`https://api.srag.simeonov.app/api/${PROJECT_ID}/search`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
  body: JSON.stringify({
    query: "How does authentication work?",
    limit: 10,
    // pipeline: null,            // uncomment to skip chunk retrieval (knowledge only)
    // cognitivePipeline: null,   // uncomment to skip cognitive search (chunks only)
    includeSuperseded: true,      // include outdated facts marked as superseded
  }),
});

const { results, knowledge, debug } = await response.json();
// knowledge.entities      — matched entities with descriptions
// knowledge.facts         — relevant facts (isCurrent: false = superseded)
// knowledge.relationships — connections between entities
// results                 — ranked source chunks (empty when pipeline is null)

const PROJECT_ID = "a3f2b1c4-..."; // UUID from project creation
const ACCESS_TOKEN = "eyJ...";   // Supabase access token (see Authentication)

const response = await fetch(`https://api.srag.simeonov.app/api/${PROJECT_ID}/ingest`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${ACCESS_TOKEN}`,
  },
  body: JSON.stringify({
    content: "Your document content here...",
    sourceType: "agent_memory",
    title: "My Document",
  }),
});

// Queued for background processing — worker picks it up automatically
const { queueId, sourceId, status } = await response.json();

const PROJECT_ID = "a3f2b1c4-...";
const ACCESS_TOKEN = "eyJ...";

// Step 1 — mint a one-time signed upload URL (authenticated)
const mint = await fetch(`https://api.srag.simeonov.app/api/${PROJECT_ID}/upload-token`, {
  method: "POST",
  headers: { Authorization: `Bearer ${ACCESS_TOKEN}` },
});
const { upload_url, curl_example, expires_in_seconds } = await mint.json();

// Step 2 — POST the file to the URL. NO auth header — the one-time
// token in the URL path is the only credential. Single-use, expires
// after ${expires_in_seconds}s (default 600).
const formData = new FormData();
formData.append("file", myFile); // File or Blob
const res = await fetch(upload_url, { method: "POST", body: formData });
const { queueId, sourceId, status } = await res.json();

// Or from a shell (this is what MCP agents do via rag_prepare_upload):
// curl -s -X POST -F 'file=@/path/to/report.pdf' '<upload_url>'