Your documents.
Your next API call.

npm install @docslurp/sdk
export DOCSLURP_API_KEY='your-server-api-key'
# Save the example below as quickstart.mjs, then:
node quickstart.mjs ./handbook.pdf "What is the leave policy?"

import { createReadStream } from "node:fs";
import { createDocSlurpClient } from "@docslurp/sdk";

// Usage: node quickstart.mjs ./handbook.pdf "What is the leave policy?"
const [filename, q = "What are the key points in this document?"] = process.argv.slice(2);
if (!filename) throw new Error("Pass a document path: node quickstart.mjs ./handbook.pdf");
if (!process.env.DOCSLURP_API_KEY) throw new Error("Set DOCSLURP_API_KEY first.");

const client = createDocSlurpClient();
const { workspace, run, warnings } = await client.upload(createReadStream(filename));
// Save these IDs before waiting: processing can outlive this process.
console.error(JSON.stringify({ workspaceId: workspace.id, runId: run.id }));
for (const warning of warnings ?? []) console.error(warning);
await client.waitForRun(run.id, { timeoutMs: 600_000 });

const evidence = await client.search({ workspaceId: workspace.id, q, limit: 5 });
if (evidence.availability?.status !== "complete") {
  console.error("Check corpus availability:", evidence.availability);
}
// Keep the complete response: citations, availability, and search session ID.
console.log(JSON.stringify(evidence, null, 2));

npm install --global @docslurp/cli
export DOCSLURP_API_KEY='your-server-api-key'
docslurp upload ./handbook.pdf --watch

# Copy the workspace ID printed by the upload:
export DOCSLURP_WORKSPACE_ID='returned-workspace-id'
docslurp search 'What is the leave policy?'
docslurp search 'What is the leave policy?' --context > evidence.txt
docslurp search 'What is the leave policy?' --json > evidence.json

import { createDocSlurpClient, formatSearchContext } from '@docslurp/sdk';

// Set DOCSLURP_API_KEY and DOCSLURP_WORKSPACE_ID first.
const client = createDocSlurpClient();
const evidence = await client.search({ q: 'How do retries work?', limit: 5 });
if (evidence.availability?.status !== 'complete') {
  throw new Error('Wait for the corpus to finish indexing.');
}
if (!evidence.results.length) throw new Error('No supporting evidence.');

const context = formatSearchContext(evidence);
console.log(context);
console.log(evidence.usage); // Tokens + recorded AI cost.
// Pass context to your LLM as untrusted source evidence.
// Keep evidence.results to map citations back to their documents.

const first = await client.chat({ q: 'Explain the retry policy with sources.' });
console.log(first.answer, first.citations, first.availability);
console.log(first.usage, first.runtime);

const next = await client.chat({
  q: 'Which failures should never be retried?',
  sessionId: first.sessionId,
});
console.log(next.answer);