@usepanacea/sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to `@usepanacea/sdk` will be documented in this file.
+
+## [0.1.0] - 2026-06-05
+
+### Features
+
+- `PanaceaClient` with `query()`, `ingest()`, `health()` top-level methods
+- `wiki.*` sub-client: `list()`, `get()`, `create()`, `update()`, `delete()`, `rollback()`
+- `review.*` sub-client: `list()`, `approve()`, `reject()`, `modify()`
+- `webhooks.*` sub-client: `list()`, `create()`, `delete()`
+- Multi-turn session support via `sessionId` on `query()`
+- SSE streaming support via `Accept: text/event-stream` (native fetch)
+- `PanaceaApiError` with typed `code`, `status`, and `traceId`
+- Browser + Node.js entry points (ESM + CJS)
+- Zero runtime dependencies — `@panacea/shared` bundled at build time

package/README.md

@@ -0,0 +1,133 @@
+# @usepanacea/sdk
+
+Official TypeScript SDK for the Panacea platform. Works in Node.js, edge runtimes (Vercel/Cloudflare), and the browser.
+
+## Installation
+
+```bash
+npm install @usepanacea/sdk
+# or
+pnpm add @usepanacea/sdk
+```
+
+## Quick Start
+
+```ts
+import { PanaceaClient } from "@usepanacea/sdk";
+
+const client = new PanaceaClient({
+  apiKey: process.env.PANACEA_API_KEY!,
+  baseURL: "https://your-panacea-instance.example.com",
+});
+
+// Ask a question
+const result = await client.query("How do I reset my password?");
+console.log(result.answer);
+console.log(`Confidence: ${(result.confidence * 100).toFixed(0)}%`);
+console.log(
+  "Sources:",
+  result.sources.map((s) => s.path),
+);
+
+// Multi-turn conversation
+const followUp = await client.query("What about enterprise SSO?", {
+  sessionId: result.sessionId,
+});
+```
+
+## Ingestion
+
+```ts
+// Ingest a URL
+const job = await client.ingest({
+  type: "url",
+  url: "https://docs.example.com/setup",
+});
+console.log(job.jobId); // track via GET /api/v1/ingest/:jobId
+
+// Ingest raw Markdown text
+await client.ingest({
+  type: "text",
+  content: "# FAQ\n\n## How do I reset my password?\n...",
+  filename: "faq.md",
+  category: "faq",
+});
+```
+
+## Wiki
+
+```ts
+// List entries
+const { data } = await client.wiki.list({ tag: "billing", limit: 20 });
+
+// Get a single entry
+const entry = await client.wiki.get("faq/reset-password");
+
+// Create or update an entry (trainer+ role required)
+await client.wiki.create({ path: "faq/reset-password", content: "..." });
+await client.wiki.update("faq/reset-password", { content: "Updated content" });
+
+// Roll back to a previous version
+await client.wiki.rollback("faq/reset-password", { version: 2 });
+
+// Delete
+await client.wiki.delete("faq/reset-password");
+```
+
+## Review Queue
+
+```ts
+const { items } = await client.review.list({ status: "pending" });
+
+await client.review.approve(items[0].id);
+await client.review.reject(items[0].id, { reason: "Contradicts billing policy" });
+await client.review.modify(items[0].id, { content: "Corrected content..." });
+```
+
+## Health
+
+```ts
+const health = await client.health();
+console.log(`Wiki size: ${health.wikiSize}`);
+console.log(`Health score: ${health.healthScore}`);
+console.log(`Needs review: ${health.needsReview}`);
+```
+
+## Error Handling
+
+```ts
+import { PanaceaApiError } from "@usepanacea/sdk";
+
+try {
+  await client.query("...");
+} catch (err) {
+  if (err instanceof PanaceaApiError) {
+    console.error(err.code); // e.g. "rate_limit_exceeded"
+    console.error(err.status); // HTTP status code
+    console.error(err.traceId); // for support
+    if (err.code === "session_expired") {
+      // Start a new session
+    }
+  }
+}
+```
+
+## Client Options
+
+```ts
+new PanaceaClient({
+  apiKey: "pk_live_...", // required
+  baseURL: "https://...", // required
+  tenantId: "tenant_abc", // optional — sent as X-Tenant-Id header
+  headers: { "X-Custom": "value" }, // optional extra headers
+  fetch: customFetch, // optional fetch override (testing)
+});
+```
+
+## Build
+
+```bash
+pnpm build       # tsup → dist/ (ESM + CJS)
+pnpm typecheck   # tsc --noEmit
+pnpm test        # vitest run
+```

package/dist/browser.cjs

@@ -0,0 +1,249 @@
+'use strict';
+
+// src/http.ts
+var PanaceaApiError = class extends Error {
+  code;
+  status;
+  retriable;
+  traceId;
+  constructor(status, body) {
+    super(body.error.message);
+    this.name = "PanaceaApiError";
+    this.code = body.error.code;
+    this.status = status;
+    this.retriable = body.error.retriable;
+    this.traceId = body.error.traceId;
+  }
+};
+var HttpClient = class {
+  baseURL;
+  defaultHeaders;
+  _fetch;
+  constructor(opts) {
+    this.baseURL = opts.baseURL.replace(/\/$/, "");
+    this._fetch = opts.fetch ?? globalThis.fetch.bind(globalThis);
+    this.defaultHeaders = {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      Authorization: `Bearer ${opts.apiKey}`,
+      ...opts.tenantId ? { "X-Tenant-Id": opts.tenantId } : {},
+      ...opts.headers
+    };
+  }
+  async get(path, params) {
+    const url = new URL(this.baseURL + path);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const res = await this._fetch(url.toString(), {
+      method: "GET",
+      headers: this.defaultHeaders
+    });
+    return this.parseResponse(res);
+  }
+  async post(path, body) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "POST",
+      headers: this.defaultHeaders,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.parseResponse(res);
+  }
+  async patch(path, body) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "PATCH",
+      headers: this.defaultHeaders,
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.parseResponse(res);
+  }
+  async delete(path) {
+    const res = await this._fetch(this.baseURL + path, {
+      method: "DELETE",
+      headers: this.defaultHeaders
+    });
+    return this.parseResponse(res);
+  }
+  async parseResponse(res) {
+    const text = await res.text();
+    let json;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      if (!res.ok) throw new Error(`HTTP ${res.status}: ${text}`);
+      return void 0;
+    }
+    if (!res.ok) {
+      throw new PanaceaApiError(res.status, json);
+    }
+    return json;
+  }
+};
+
+// src/wiki.ts
+var WikiClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List wiki entries (paginated).
+   */
+  list(opts) {
+    return this.http.get("/api/v1/wiki", {
+      page: opts?.page,
+      limit: opts?.limit,
+      status: opts?.status
+    });
+  }
+  /**
+   * Get a single wiki entry by path slug.
+   */
+  get(path) {
+    return this.http.get(`/api/v1/wiki/${encodeURIComponent(path)}`);
+  }
+  /**
+   * Create a new wiki entry.
+   */
+  create(opts) {
+    return this.http.post("/api/v1/wiki", opts);
+  }
+  /**
+   * Update an existing wiki entry.
+   */
+  update(path, opts) {
+    return this.http.patch(`/api/v1/wiki/${encodeURIComponent(path)}`, opts);
+  }
+  /**
+   * Delete a wiki entry.
+   */
+  delete(path) {
+    return this.http.delete(`/api/v1/wiki/${encodeURIComponent(path)}`);
+  }
+};
+
+// src/review.ts
+var ReviewClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List review queue items (paginated).
+   */
+  list(opts) {
+    return this.http.get("/api/v1/review", {
+      page: opts?.page,
+      limit: opts?.limit,
+      status: opts?.status
+    });
+  }
+  /**
+   * Get a single review item by ID.
+   */
+  get(id) {
+    return this.http.get(`/api/v1/review/${id}`);
+  }
+  /**
+   * Approve, reject, or modify a review item.
+   */
+  act(id, opts) {
+    return this.http.post(`/api/v1/review/${id}`, opts);
+  }
+};
+
+// src/webhooks-client.ts
+var WebhooksClient = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List registered webhooks.
+   */
+  list() {
+    return this.http.get("/api/v1/webhooks");
+  }
+  /**
+   * Register a new webhook endpoint.
+   */
+  create(opts) {
+    return this.http.post("/api/v1/webhooks", opts);
+  }
+  /**
+   * Delete a webhook registration.
+   */
+  delete(id) {
+    return this.http.delete(`/api/v1/webhooks/${id}`);
+  }
+  /**
+   * Replay the last event delivery for a webhook.
+   */
+  replay(id) {
+    return this.http.post(`/api/v1/webhooks/${id}/replay`);
+  }
+};
+
+// src/client.ts
+var PanaceaClient = class {
+  http;
+  /** Wiki knowledge base CRUD */
+  wiki;
+  /** Review queue operations */
+  review;
+  /** Webhook registration management */
+  webhooks;
+  constructor(opts) {
+    if (!opts.apiKey) throw new Error("PanaceaClient: apiKey is required");
+    if (!opts.baseURL) throw new Error("PanaceaClient: baseURL is required");
+    this.http = new HttpClient(opts);
+    this.wiki = new WikiClient(this.http);
+    this.review = new ReviewClient(this.http);
+    this.webhooks = new WebhooksClient(this.http);
+  }
+  query(questionOrOpts, rest) {
+    const body = typeof questionOrOpts === "string" ? { question: questionOrOpts, ...rest } : questionOrOpts;
+    return this.http.post("/api/v1/query", body);
+  }
+  // ---------------------------------------------------------------------------
+  // Ingest
+  // ---------------------------------------------------------------------------
+  /**
+   * Submit a URL or raw text content for ingestion.
+   *
+   * @example URL
+   * ```typescript
+   * await client.ingest({ type: "url", url: "https://docs.example.com" })
+   * ```
+   *
+   * @example Raw text
+   * ```typescript
+   * await client.ingest({ type: "text", content: "# FAQ\n...", filename: "faq.md" })
+   * ```
+   */
+  ingest(opts) {
+    const body = opts.type === "url" ? { url: opts.url, slug: opts.slug, category: opts.category } : {
+      content: opts.content,
+      filename: opts.filename,
+      slug: opts.slug,
+      category: opts.category
+    };
+    return this.http.post("/api/v1/ingest", body);
+  }
+  // ---------------------------------------------------------------------------
+  // Health
+  // ---------------------------------------------------------------------------
+  /**
+   * Get the current system health report.
+   */
+  health() {
+    return this.http.get("/api/v1/health");
+  }
+};
+
+exports.PanaceaApiError = PanaceaApiError;
+exports.PanaceaClient = PanaceaClient;
+//# sourceMappingURL=browser.cjs.map
+//# sourceMappingURL=browser.cjs.map

package/dist/browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http.ts","../src/wiki.ts","../src/review.ts","../src/webhooks-client.ts","../src/client.ts"],"names":[],"mappings":"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","file":"browser.cjs","sourcesContent":["/**\n * @module http\n * Internal fetch wrapper used by PanaceaClient.\n * Works in Node.js (18+), browser, and edge runtimes (native fetch).\n */\n\nimport type { ApiErrorBody } from \"./types.js\";\n\nexport class PanaceaApiError extends Error {\n  readonly code: string;\n  readonly status: number;\n  readonly retriable: boolean;\n  readonly traceId?: string;\n\n  constructor(status: number, body: ApiErrorBody) {\n    super(body.error.message);\n    this.name = \"PanaceaApiError\";\n    this.code = body.error.code;\n    this.status = status;\n    this.retriable = body.error.retriable;\n    this.traceId = body.error.traceId;\n  }\n}\n\nexport interface HttpClientOptions {\n  baseURL: string;\n  apiKey: string;\n  /** Tenant ID header value (X-Tenant-Id). Required if your installation uses it. */\n  tenantId?: string;\n  /** Override the global fetch (e.g. for testing) */\n  fetch?: typeof globalThis.fetch;\n  /** Additional default headers */\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly baseURL: string;\n  private readonly defaultHeaders: Record<string, string>;\n  private readonly _fetch: typeof globalThis.fetch;\n\n  constructor(opts: HttpClientOptions) {\n    this.baseURL = opts.baseURL.replace(/\\/$/, \"\");\n    this._fetch = opts.fetch ?? globalThis.fetch.bind(globalThis);\n    this.defaultHeaders = {\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json\",\n      Authorization: `Bearer ${opts.apiKey}`,\n      ...(opts.tenantId ? { \"X-Tenant-Id\": opts.tenantId } : {}),\n      ...opts.headers,\n    };\n  }\n\n  async get<T>(\n    path: string,\n    params?: Record<string, string | number | boolean | undefined>,\n  ): Promise<T> {\n    const url = new URL(this.baseURL + path);\n    if (params) {\n      for (const [k, v] of Object.entries(params)) {\n        if (v !== undefined) url.searchParams.set(k, String(v));\n      }\n    }\n    const res = await this._fetch(url.toString(), {\n      method: \"GET\",\n      headers: this.defaultHeaders,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async post<T>(path: string, body?: unknown): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"POST\",\n      headers: this.defaultHeaders,\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async patch<T>(path: string, body?: unknown): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"PATCH\",\n      headers: this.defaultHeaders,\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  async delete<T = void>(path: string): Promise<T> {\n    const res = await this._fetch(this.baseURL + path, {\n      method: \"DELETE\",\n      headers: this.defaultHeaders,\n    });\n    return this.parseResponse<T>(res);\n  }\n\n  private async parseResponse<T>(res: Response): Promise<T> {\n    const text = await res.text();\n    let json: unknown;\n    try {\n      json = JSON.parse(text);\n    } catch {\n      if (!res.ok) throw new Error(`HTTP ${res.status}: ${text}`);\n      return undefined as T;\n    }\n\n    if (!res.ok) {\n      throw new PanaceaApiError(res.status, json as ApiErrorBody);\n    }\n\n    return json as T;\n  }\n}\n","/**\n * @module wiki\n * Wiki knowledge base sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type {\n  WikiEntry,\n  ListWikiOptions,\n  CreateWikiEntryOptions,\n  UpdateWikiEntryOptions,\n  PaginatedResponse,\n} from \"./types.js\";\n\nexport class WikiClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List wiki entries (paginated).\n   */\n  list(opts?: ListWikiOptions): Promise<PaginatedResponse<WikiEntry>> {\n    return this.http.get<PaginatedResponse<WikiEntry>>(\"/api/v1/wiki\", {\n      page: opts?.page,\n      limit: opts?.limit,\n      status: opts?.status,\n    });\n  }\n\n  /**\n   * Get a single wiki entry by path slug.\n   */\n  get(path: string): Promise<WikiEntry> {\n    return this.http.get<WikiEntry>(`/api/v1/wiki/${encodeURIComponent(path)}`);\n  }\n\n  /**\n   * Create a new wiki entry.\n   */\n  create(opts: CreateWikiEntryOptions): Promise<WikiEntry> {\n    return this.http.post<WikiEntry>(\"/api/v1/wiki\", opts);\n  }\n\n  /**\n   * Update an existing wiki entry.\n   */\n  update(path: string, opts: UpdateWikiEntryOptions): Promise<WikiEntry> {\n    return this.http.patch<WikiEntry>(`/api/v1/wiki/${encodeURIComponent(path)}`, opts);\n  }\n\n  /**\n   * Delete a wiki entry.\n   */\n  delete(path: string): Promise<void> {\n    return this.http.delete<void>(`/api/v1/wiki/${encodeURIComponent(path)}`);\n  }\n}\n","/**\n * @module review\n * Review queue sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type {\n  ReviewQueueItem,\n  ListReviewOptions,\n  ActOnReviewOptions,\n  PaginatedResponse,\n} from \"./types.js\";\n\nexport class ReviewClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List review queue items (paginated).\n   */\n  list(opts?: ListReviewOptions): Promise<PaginatedResponse<ReviewQueueItem>> {\n    return this.http.get<PaginatedResponse<ReviewQueueItem>>(\"/api/v1/review\", {\n      page: opts?.page,\n      limit: opts?.limit,\n      status: opts?.status,\n    });\n  }\n\n  /**\n   * Get a single review item by ID.\n   */\n  get(id: string): Promise<ReviewQueueItem> {\n    return this.http.get<ReviewQueueItem>(`/api/v1/review/${id}`);\n  }\n\n  /**\n   * Approve, reject, or modify a review item.\n   */\n  act(id: string, opts: ActOnReviewOptions): Promise<ReviewQueueItem> {\n    return this.http.post<ReviewQueueItem>(`/api/v1/review/${id}`, opts);\n  }\n}\n","/**\n * @module webhooks-client\n * Webhook registration sub-client.\n */\n\nimport { HttpClient } from \"./http.js\";\nimport type { WebhookRegistration, CreateWebhookOptions } from \"./types.js\";\n\nexport class WebhooksClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * List registered webhooks.\n   */\n  list(): Promise<WebhookRegistration[]> {\n    return this.http.get<WebhookRegistration[]>(\"/api/v1/webhooks\");\n  }\n\n  /**\n   * Register a new webhook endpoint.\n   */\n  create(opts: CreateWebhookOptions): Promise<WebhookRegistration> {\n    return this.http.post<WebhookRegistration>(\"/api/v1/webhooks\", opts);\n  }\n\n  /**\n   * Delete a webhook registration.\n   */\n  delete(id: string): Promise<void> {\n    return this.http.delete<void>(`/api/v1/webhooks/${id}`);\n  }\n\n  /**\n   * Replay the last event delivery for a webhook.\n   */\n  replay(id: string): Promise<void> {\n    return this.http.post<void>(`/api/v1/webhooks/${id}/replay`);\n  }\n}\n","/**\n * @module client\n * PanaceaClient — top-level entry point for the @usepanacea/sdk.\n *\n * @example Node.js / Edge\n * ```typescript\n * import { PanaceaClient } from \"@usepanacea/sdk\"\n *\n * const client = new PanaceaClient({\n *   apiKey: process.env.PANACEA_API_KEY!,\n *   baseURL: \"https://your-panacea-instance.example.com\",\n * })\n *\n * // Query\n * const result = await client.query(\"How do I reset my password?\")\n * console.log(result.answer)\n *\n * // Ingest\n * await client.ingest({ type: \"url\", url: \"https://docs.example.com/setup\" })\n *\n * // Wiki\n * const entry = await client.wiki.get(\"faq/reset-password\")\n * ```\n */\n\nimport { HttpClient, PanaceaApiError } from \"./http.js\";\nimport { WikiClient } from \"./wiki.js\";\nimport { ReviewClient } from \"./review.js\";\nimport { WebhooksClient } from \"./webhooks-client.js\";\nimport type {\n  QueryOptions,\n  QueryResult,\n  IngestOptions,\n  IngestResult,\n  HealthReport,\n} from \"./types.js\";\n\nexport interface PanaceaClientOptions {\n  /** Base URL of your Panacea instance, e.g. \"https://panacea.example.com\" */\n  baseURL: string;\n  /** Your API key (Bearer token) */\n  apiKey: string;\n  /** Optional tenant ID sent as X-Tenant-Id header */\n  tenantId?: string;\n  /** Additional default request headers */\n  headers?: Record<string, string>;\n  /** Override the global fetch implementation (e.g. for testing) */\n  fetch?: typeof globalThis.fetch;\n}\n\nexport class PanaceaClient {\n  private readonly http: HttpClient;\n\n  /** Wiki knowledge base CRUD */\n  readonly wiki: WikiClient;\n\n  /** Review queue operations */\n  readonly review: ReviewClient;\n\n  /** Webhook registration management */\n  readonly webhooks: WebhooksClient;\n\n  constructor(opts: PanaceaClientOptions) {\n    if (!opts.apiKey) throw new Error(\"PanaceaClient: apiKey is required\");\n    if (!opts.baseURL) throw new Error(\"PanaceaClient: baseURL is required\");\n\n    this.http = new HttpClient(opts);\n    this.wiki = new WikiClient(this.http);\n    this.review = new ReviewClient(this.http);\n    this.webhooks = new WebhooksClient(this.http);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Submit a question to the Q&A agent.\n   *\n   * @param question - The user's question string\n   * @param opts - Optional session ID and context override\n   */\n  query(question: string, opts?: Omit<QueryOptions, \"question\">): Promise<QueryResult>;\n  query(opts: QueryOptions): Promise<QueryResult>;\n  query(\n    questionOrOpts: string | QueryOptions,\n    rest?: Omit<QueryOptions, \"question\">,\n  ): Promise<QueryResult> {\n    const body: QueryOptions =\n      typeof questionOrOpts === \"string\" ? { question: questionOrOpts, ...rest } : questionOrOpts;\n    return this.http.post<QueryResult>(\"/api/v1/query\", body);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Ingest\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Submit a URL or raw text content for ingestion.\n   *\n   * @example URL\n   * ```typescript\n   * await client.ingest({ type: \"url\", url: \"https://docs.example.com\" })\n   * ```\n   *\n   * @example Raw text\n   * ```typescript\n   * await client.ingest({ type: \"text\", content: \"# FAQ\\n...\", filename: \"faq.md\" })\n   * ```\n   */\n  ingest(opts: IngestOptions): Promise<IngestResult> {\n    const body =\n      opts.type === \"url\"\n        ? { url: opts.url, slug: opts.slug, category: opts.category }\n        : {\n            content: opts.content,\n            filename: opts.filename,\n            slug: opts.slug,\n            category: opts.category,\n          };\n    return this.http.post<IngestResult>(\"/api/v1/ingest\", body);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Health\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Get the current system health report.\n   */\n  health(): Promise<HealthReport> {\n    return this.http.get<HealthReport>(\"/api/v1/health\");\n  }\n}\n\nexport { PanaceaApiError };\n"]}

package/dist/browser.d.cts

@@ -0,0 +1,191 @@
+import { ApiErrorBody, ListWikiOptions, PaginatedResponse, WikiEntry, CreateWikiEntryOptions, UpdateWikiEntryOptions, ListReviewOptions, ReviewQueueItem, ActOnReviewOptions, WebhookRegistration, CreateWebhookOptions, QueryOptions, QueryResult, IngestOptions, IngestResult, HealthReport } from './types.cjs';
+export { AgentHealth, AgentStatus, IngestTextOptions, IngestUrlOptions, PaginationMeta, QuerySource, ReviewStatus, SystemStatus, WebhookEvent, WikiEntryStatus } from './types.cjs';
+
+/**
+ * @module http
+ * Internal fetch wrapper used by PanaceaClient.
+ * Works in Node.js (18+), browser, and edge runtimes (native fetch).
+ */
+
+declare class PanaceaApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly retriable: boolean;
+    readonly traceId?: string;
+    constructor(status: number, body: ApiErrorBody);
+}
+interface HttpClientOptions {
+    baseURL: string;
+    apiKey: string;
+    /** Tenant ID header value (X-Tenant-Id). Required if your installation uses it. */
+    tenantId?: string;
+    /** Override the global fetch (e.g. for testing) */
+    fetch?: typeof globalThis.fetch;
+    /** Additional default headers */
+    headers?: Record<string, string>;
+}
+declare class HttpClient {
+    private readonly baseURL;
+    private readonly defaultHeaders;
+    private readonly _fetch;
+    constructor(opts: HttpClientOptions);
+    get<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    delete<T = void>(path: string): Promise<T>;
+    private parseResponse;
+}
+
+/**
+ * @module wiki
+ * Wiki knowledge base sub-client.
+ */
+
+declare class WikiClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List wiki entries (paginated).
+     */
+    list(opts?: ListWikiOptions): Promise<PaginatedResponse<WikiEntry>>;
+    /**
+     * Get a single wiki entry by path slug.
+     */
+    get(path: string): Promise<WikiEntry>;
+    /**
+     * Create a new wiki entry.
+     */
+    create(opts: CreateWikiEntryOptions): Promise<WikiEntry>;
+    /**
+     * Update an existing wiki entry.
+     */
+    update(path: string, opts: UpdateWikiEntryOptions): Promise<WikiEntry>;
+    /**
+     * Delete a wiki entry.
+     */
+    delete(path: string): Promise<void>;
+}
+
+/**
+ * @module review
+ * Review queue sub-client.
+ */
+
+declare class ReviewClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List review queue items (paginated).
+     */
+    list(opts?: ListReviewOptions): Promise<PaginatedResponse<ReviewQueueItem>>;
+    /**
+     * Get a single review item by ID.
+     */
+    get(id: string): Promise<ReviewQueueItem>;
+    /**
+     * Approve, reject, or modify a review item.
+     */
+    act(id: string, opts: ActOnReviewOptions): Promise<ReviewQueueItem>;
+}
+
+/**
+ * @module webhooks-client
+ * Webhook registration sub-client.
+ */
+
+declare class WebhooksClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List registered webhooks.
+     */
+    list(): Promise<WebhookRegistration[]>;
+    /**
+     * Register a new webhook endpoint.
+     */
+    create(opts: CreateWebhookOptions): Promise<WebhookRegistration>;
+    /**
+     * Delete a webhook registration.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Replay the last event delivery for a webhook.
+     */
+    replay(id: string): Promise<void>;
+}
+
+/**
+ * @module client
+ * PanaceaClient — top-level entry point for the @usepanacea/sdk.
+ *
+ * @example Node.js / Edge
+ * ```typescript
+ * import { PanaceaClient } from "@usepanacea/sdk"
+ *
+ * const client = new PanaceaClient({
+ *   apiKey: process.env.PANACEA_API_KEY!,
+ *   baseURL: "https://your-panacea-instance.example.com",
+ * })
+ *
+ * // Query
+ * const result = await client.query("How do I reset my password?")
+ * console.log(result.answer)
+ *
+ * // Ingest
+ * await client.ingest({ type: "url", url: "https://docs.example.com/setup" })
+ *
+ * // Wiki
+ * const entry = await client.wiki.get("faq/reset-password")
+ * ```
+ */
+
+interface PanaceaClientOptions {
+    /** Base URL of your Panacea instance, e.g. "https://panacea.example.com" */
+    baseURL: string;
+    /** Your API key (Bearer token) */
+    apiKey: string;
+    /** Optional tenant ID sent as X-Tenant-Id header */
+    tenantId?: string;
+    /** Additional default request headers */
+    headers?: Record<string, string>;
+    /** Override the global fetch implementation (e.g. for testing) */
+    fetch?: typeof globalThis.fetch;
+}
+declare class PanaceaClient {
+    private readonly http;
+    /** Wiki knowledge base CRUD */
+    readonly wiki: WikiClient;
+    /** Review queue operations */
+    readonly review: ReviewClient;
+    /** Webhook registration management */
+    readonly webhooks: WebhooksClient;
+    constructor(opts: PanaceaClientOptions);
+    /**
+     * Submit a question to the Q&A agent.
+     *
+     * @param question - The user's question string
+     * @param opts - Optional session ID and context override
+     */
+    query(question: string, opts?: Omit<QueryOptions, "question">): Promise<QueryResult>;
+    query(opts: QueryOptions): Promise<QueryResult>;
+    /**
+     * Submit a URL or raw text content for ingestion.
+     *
+     * @example URL
+     * ```typescript
+     * await client.ingest({ type: "url", url: "https://docs.example.com" })
+     * ```
+     *
+     * @example Raw text
+     * ```typescript
+     * await client.ingest({ type: "text", content: "# FAQ\n...", filename: "faq.md" })
+     * ```
+     */
+    ingest(opts: IngestOptions): Promise<IngestResult>;
+    /**
+     * Get the current system health report.
+     */
+    health(): Promise<HealthReport>;
+}
+
+export { ActOnReviewOptions, ApiErrorBody, CreateWebhookOptions, CreateWikiEntryOptions, HealthReport, IngestOptions, IngestResult, ListReviewOptions, ListWikiOptions, PaginatedResponse, PanaceaApiError, PanaceaClient, type PanaceaClientOptions, QueryOptions, QueryResult, ReviewQueueItem, UpdateWikiEntryOptions, WebhookRegistration, WikiEntry };