@ragable/sdk 0.0.2 → 0.0.3

package/dist/index.d.mts

@@ -4,6 +4,30 @@ interface RagableClientOptions {
     fetch?: typeof fetch;
     headers?: HeadersInit;
 }
+type RequestOptions = Omit<RequestInit, "body"> & {
+    body?: unknown;
+};
+declare class RagableError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+declare function extractErrorMessage(payload: unknown, fallback: string): string;
+declare class RagableRequestClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly defaultHeaders;
+    constructor(options: RagableClientOptions);
+    toUrl(path: string): string;
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Low-level fetch with API key and JSON body encoding. Caller handles status and body.
+     */
+    rawFetch(path: string, options?: RequestOptions): Promise<Response>;
+    private parseResponseBody;
+}
+
 interface ShiftIndex {
     id: string;
     name: string;
@@ -70,24 +94,6 @@ interface ShiftListEntriesResponse {
     entries: ShiftEntry[];
     total: number;
 }
-declare class RagableError extends Error {
-    readonly status: number;
-    readonly body: unknown;
-    constructor(message: string, status: number, body: unknown);
-}
-type RequestOptions = Omit<RequestInit, "body"> & {
-    body?: unknown;
-};
-declare class RagableRequestClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly fetchImpl;
-    private readonly defaultHeaders;
-    constructor(options: RagableClientOptions);
-    request<T>(path: string, options?: RequestOptions): Promise<T>;
-    private toUrl;
-    private parseResponseBody;
-}
 declare class ShiftClient {
     private readonly client;
     readonly indexes: {
@@ -116,8 +122,104 @@ declare class ShiftClient {
         results: ShiftSearchResult[];
     }>;
 }
+
+interface AgentSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AgentChatMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+interface AgentChatParams {
+    message: string;
+    history?: AgentChatMessage[];
+}
+/** Mirrors backend ExecutionResult JSON shape (traces are opaque in the SDK). */
+interface AgentChatResult {
+    response: string;
+    traces: unknown[];
+    totalDurationMs: number;
+    httpResponse?: unknown;
+}
+/**
+ * Loose SSE event from POST /v1/agents/:id/chat/stream — narrows with `type` at runtime.
+ */
+type AgentStreamEvent = Record<string, unknown> & {
+    type: string;
+};
+declare class AgentsClient {
+    private readonly client;
+    constructor(client: RagableRequestClient);
+    list(): Promise<{
+        agents: AgentSummary[];
+    }>;
+    get(agentId: string): Promise<AgentSummary>;
+    chat(agentId: string, params: AgentChatParams): Promise<AgentChatResult>;
+    /**
+     * Stream agent execution as SSE (`data: {json}` lines). Yields parsed JSON objects.
+     */
+    chatStream(agentId: string, params: AgentChatParams): AsyncGenerator<AgentStreamEvent, void, undefined>;
+}
+
+/** Minimal client surface for {@link createRagPipeline} (implemented by {@link Ragable}). */
+interface RagClientForPipeline {
+    shift: {
+        documents: {
+            create: (indexId: string, params: ShiftAddDocumentParams) => Promise<ShiftIngestResponse>;
+            upload: (indexId: string, params: ShiftUploadFileParams) => Promise<ShiftIngestResponse>;
+        };
+        search: (indexId: string, params: ShiftSearchParams) => Promise<{
+            results: ShiftSearchResult[];
+        }>;
+    };
+}
+interface FormatContextOptions {
+    /** Prepended before numbered passages (default: "Relevant passages:\\n") */
+    header?: string;
+    /** Joiner between passages (default: "\\n\\n") */
+    separator?: string;
+    /** Omit results with similarity score below this (default: no filter) */
+    minScore?: number;
+    /** Truncate total context string to this UTF-16 length (default: no limit) */
+    maxChars?: number;
+    /** Include similarity score in each block (default: false) */
+    includeScores?: boolean;
+}
+interface RagPipelineOptions {
+    indexId: string;
+}
+type RetrieveParams = ShiftSearchParams & {
+    format?: FormatContextOptions;
+};
+interface RagPipeline {
+    readonly indexId: string;
+    ingestText(params: ShiftAddDocumentParams): Promise<ShiftIngestResponse>;
+    ingestFile(params: ShiftUploadFileParams): Promise<ShiftIngestResponse>;
+    search(params: ShiftSearchParams): Promise<{
+        results: ShiftSearchResult[];
+    }>;
+    retrieve(params: RetrieveParams): Promise<{
+        results: ShiftSearchResult[];
+        context: string;
+    }>;
+}
+/**
+ * Turn vector search hits into a single block of text for system prompts or RAG user messages.
+ */
+declare function formatRetrievalContext(results: ShiftSearchResult[], options?: FormatContextOptions): string;
+/**
+ * High-level RAG helpers bound to one Shift index: ingest, search, retrieve with prompt-ready context.
+ */
+declare function createRagPipeline(client: RagClientForPipeline, options: RagPipelineOptions): RagPipeline;
+
 declare class Ragable {
     readonly shift: ShiftClient;
+    readonly agents: AgentsClient;
     readonly infrastructure: {
         shift: ShiftClient;
     };
@@ -125,4 +227,4 @@ declare class Ragable {
 }
 declare function createClient(options: RagableClientOptions): Ragable;
 
-export { Ragable, type RagableClientOptions, RagableError, type ShiftAddDocumentParams, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, createClient };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentStreamEvent, type AgentSummary, AgentsClient, type FormatContextOptions, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, type RagableClientOptions, RagableError, RagableRequestClient, type RequestOptions, type RetrieveParams, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, createClient, createRagPipeline, extractErrorMessage, formatRetrievalContext };

package/dist/index.d.ts

@@ -4,6 +4,30 @@ interface RagableClientOptions {
     fetch?: typeof fetch;
     headers?: HeadersInit;
 }
+type RequestOptions = Omit<RequestInit, "body"> & {
+    body?: unknown;
+};
+declare class RagableError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+declare function extractErrorMessage(payload: unknown, fallback: string): string;
+declare class RagableRequestClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly defaultHeaders;
+    constructor(options: RagableClientOptions);
+    toUrl(path: string): string;
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Low-level fetch with API key and JSON body encoding. Caller handles status and body.
+     */
+    rawFetch(path: string, options?: RequestOptions): Promise<Response>;
+    private parseResponseBody;
+}
+
 interface ShiftIndex {
     id: string;
     name: string;
@@ -70,24 +94,6 @@ interface ShiftListEntriesResponse {
     entries: ShiftEntry[];
     total: number;
 }
-declare class RagableError extends Error {
-    readonly status: number;
-    readonly body: unknown;
-    constructor(message: string, status: number, body: unknown);
-}
-type RequestOptions = Omit<RequestInit, "body"> & {
-    body?: unknown;
-};
-declare class RagableRequestClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly fetchImpl;
-    private readonly defaultHeaders;
-    constructor(options: RagableClientOptions);
-    request<T>(path: string, options?: RequestOptions): Promise<T>;
-    private toUrl;
-    private parseResponseBody;
-}
 declare class ShiftClient {
     private readonly client;
     readonly indexes: {
@@ -116,8 +122,104 @@ declare class ShiftClient {
         results: ShiftSearchResult[];
     }>;
 }
+
+interface AgentSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AgentChatMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+interface AgentChatParams {
+    message: string;
+    history?: AgentChatMessage[];
+}
+/** Mirrors backend ExecutionResult JSON shape (traces are opaque in the SDK). */
+interface AgentChatResult {
+    response: string;
+    traces: unknown[];
+    totalDurationMs: number;
+    httpResponse?: unknown;
+}
+/**
+ * Loose SSE event from POST /v1/agents/:id/chat/stream — narrows with `type` at runtime.
+ */
+type AgentStreamEvent = Record<string, unknown> & {
+    type: string;
+};
+declare class AgentsClient {
+    private readonly client;
+    constructor(client: RagableRequestClient);
+    list(): Promise<{
+        agents: AgentSummary[];
+    }>;
+    get(agentId: string): Promise<AgentSummary>;
+    chat(agentId: string, params: AgentChatParams): Promise<AgentChatResult>;
+    /**
+     * Stream agent execution as SSE (`data: {json}` lines). Yields parsed JSON objects.
+     */
+    chatStream(agentId: string, params: AgentChatParams): AsyncGenerator<AgentStreamEvent, void, undefined>;
+}
+
+/** Minimal client surface for {@link createRagPipeline} (implemented by {@link Ragable}). */
+interface RagClientForPipeline {
+    shift: {
+        documents: {
+            create: (indexId: string, params: ShiftAddDocumentParams) => Promise<ShiftIngestResponse>;
+            upload: (indexId: string, params: ShiftUploadFileParams) => Promise<ShiftIngestResponse>;
+        };
+        search: (indexId: string, params: ShiftSearchParams) => Promise<{
+            results: ShiftSearchResult[];
+        }>;
+    };
+}
+interface FormatContextOptions {
+    /** Prepended before numbered passages (default: "Relevant passages:\\n") */
+    header?: string;
+    /** Joiner between passages (default: "\\n\\n") */
+    separator?: string;
+    /** Omit results with similarity score below this (default: no filter) */
+    minScore?: number;
+    /** Truncate total context string to this UTF-16 length (default: no limit) */
+    maxChars?: number;
+    /** Include similarity score in each block (default: false) */
+    includeScores?: boolean;
+}
+interface RagPipelineOptions {
+    indexId: string;
+}
+type RetrieveParams = ShiftSearchParams & {
+    format?: FormatContextOptions;
+};
+interface RagPipeline {
+    readonly indexId: string;
+    ingestText(params: ShiftAddDocumentParams): Promise<ShiftIngestResponse>;
+    ingestFile(params: ShiftUploadFileParams): Promise<ShiftIngestResponse>;
+    search(params: ShiftSearchParams): Promise<{
+        results: ShiftSearchResult[];
+    }>;
+    retrieve(params: RetrieveParams): Promise<{
+        results: ShiftSearchResult[];
+        context: string;
+    }>;
+}
+/**
+ * Turn vector search hits into a single block of text for system prompts or RAG user messages.
+ */
+declare function formatRetrievalContext(results: ShiftSearchResult[], options?: FormatContextOptions): string;
+/**
+ * High-level RAG helpers bound to one Shift index: ingest, search, retrieve with prompt-ready context.
+ */
+declare function createRagPipeline(client: RagClientForPipeline, options: RagPipelineOptions): RagPipeline;
+
 declare class Ragable {
     readonly shift: ShiftClient;
+    readonly agents: AgentsClient;
     readonly infrastructure: {
         shift: ShiftClient;
     };
@@ -125,4 +227,4 @@ declare class Ragable {
 }
 declare function createClient(options: RagableClientOptions): Ragable;
 
-export { Ragable, type RagableClientOptions, RagableError, type ShiftAddDocumentParams, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, createClient };
+export { type AgentChatMessage, type AgentChatParams, type AgentChatResult, type AgentStreamEvent, type AgentSummary, AgentsClient, type FormatContextOptions, type RagClientForPipeline, type RagPipeline, type RagPipelineOptions, Ragable, type RagableClientOptions, RagableError, RagableRequestClient, type RequestOptions, type RetrieveParams, type ShiftAddDocumentParams, ShiftClient, type ShiftCreateIndexParams, type ShiftEntry, type ShiftIndex, type ShiftIngestResponse, type ShiftListEntriesParams, type ShiftListEntriesResponse, type ShiftSearchParams, type ShiftSearchResult, type ShiftUpdateIndexParams, type ShiftUploadFileParams, type ShiftUploadableFile, createClient, createRagPipeline, extractErrorMessage, formatRetrievalContext };

package/dist/index.js

@@ -22,11 +22,19 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AgentsClient: () => AgentsClient,
   Ragable: () => Ragable,
   RagableError: () => RagableError,
-  createClient: () => createClient
+  RagableRequestClient: () => RagableRequestClient,
+  ShiftClient: () => ShiftClient,
+  createClient: () => createClient,
+  createRagPipeline: () => createRagPipeline,
+  extractErrorMessage: () => extractErrorMessage,
+  formatRetrievalContext: () => formatRetrievalContext
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/request-client.ts
 var RagableError = class extends Error {
   constructor(message, status, body) {
     super(message);
@@ -37,6 +45,20 @@ var RagableError = class extends Error {
     this.body = body;
   }
 };
+function extractErrorMessage(payload, fallback) {
+  if (payload && typeof payload === "object") {
+    if ("error" in payload && typeof payload.error === "string") {
+      return payload.error;
+    }
+    if ("message" in payload && typeof payload.message === "string") {
+      return payload.message;
+    }
+  }
+  if (typeof payload === "string" && payload.length > 0) {
+    return payload;
+  }
+  return fallback || "Request failed";
+}
 var RagableRequestClient = class {
   constructor(options) {
     __publicField(this, "apiKey");
@@ -48,7 +70,24 @@ var RagableRequestClient = class {
     this.fetchImpl = options.fetch ?? fetch;
     this.defaultHeaders = options.headers;
   }
+  toUrl(path) {
+    const normalizedBase = this.baseUrl.replace(/\/+$/, "");
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${normalizedBase}${normalizedPath}`;
+  }
   async request(path, options = {}) {
+    const response = await this.rawFetch(path, options);
+    const payload = await this.parseResponseBody(response);
+    if (!response.ok) {
+      const message = extractErrorMessage(payload, response.statusText);
+      throw new RagableError(message, response.status, payload);
+    }
+    return payload;
+  }
+  /**
+   * Low-level fetch with API key and JSON body encoding. Caller handles status and body.
+   */
+  async rawFetch(path, options = {}) {
     const headers = new Headers(this.defaultHeaders);
     headers.set("Authorization", `Bearer ${this.apiKey}`);
     let body = options.body;
@@ -56,22 +95,11 @@ var RagableRequestClient = class {
       headers.set("Content-Type", "application/json");
       body = JSON.stringify(body);
     }
-    const response = await this.fetchImpl(this.toUrl(path), {
+    return this.fetchImpl(this.toUrl(path), {
       ...options,
       headers,
       body
     });
-    const payload = await this.parseResponseBody(response);
-    if (!response.ok) {
-      const message = extractErrorMessage(payload, response.statusText);
-      throw new RagableError(message, response.status, payload);
-    }
-    return payload;
-  }
-  toUrl(path) {
-    const normalizedBase = this.baseUrl.replace(/\/+$/, "");
-    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
-    return `${normalizedBase}${normalizedPath}`;
   }
   async parseResponseBody(response) {
     if (response.status === 204) {
@@ -84,6 +112,11 @@ var RagableRequestClient = class {
     return response.text();
   }
 };
+function isBodyInit(value) {
+  return typeof value === "string" || value instanceof Blob || value instanceof FormData || value instanceof URLSearchParams || value instanceof ArrayBuffer || ArrayBuffer.isView(value);
+}
+
+// src/shift.ts
 var ShiftClient = class {
   constructor(client) {
     this.client = client;
@@ -186,34 +219,6 @@ var ShiftClient = class {
     );
   }
 };
-var Ragable = class {
-  constructor(options) {
-    __publicField(this, "shift");
-    __publicField(this, "infrastructure");
-    const client = new RagableRequestClient(options);
-    this.shift = new ShiftClient(client);
-    this.infrastructure = {
-      shift: this.shift
-    };
-  }
-};
-function createClient(options) {
-  return new Ragable(options);
-}
-function extractErrorMessage(payload, fallback) {
-  if (payload && typeof payload === "object") {
-    if ("error" in payload && typeof payload.error === "string") {
-      return payload.error;
-    }
-    if ("message" in payload && typeof payload.message === "string") {
-      return payload.message;
-    }
-  }
-  if (typeof payload === "string" && payload.length > 0) {
-    return payload;
-  }
-  return fallback || "Request failed";
-}
 function resolveUploadFileName(params) {
   if (params.fileName) {
     return params.fileName;
@@ -244,18 +249,191 @@ function normalizeUploadFile(file, contentType) {
 function isNamedBlob(value) {
   return value instanceof Blob && "name" in value && typeof value.name === "string";
 }
-function isBodyInit(value) {
-  return typeof value === "string" || value instanceof Blob || value instanceof FormData || value instanceof URLSearchParams || value instanceof ArrayBuffer || ArrayBuffer.isView(value);
-}
 function toArrayBuffer(value) {
   const copy = new Uint8Array(value.byteLength);
   copy.set(value);
   return copy.buffer;
 }
+
+// src/agents.ts
+var AgentsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("/v1/agents");
+  }
+  async get(agentId) {
+    return this.client.request(`/v1/agents/${agentId}`);
+  }
+  async chat(agentId, params) {
+    return this.client.request(`/v1/agents/${agentId}/chat`, {
+      method: "POST",
+      body: {
+        message: params.message,
+        ...params.history !== void 0 ? { history: params.history } : {}
+      }
+    });
+  }
+  /**
+   * Stream agent execution as SSE (`data: {json}` lines). Yields parsed JSON objects.
+   */
+  async *chatStream(agentId, params) {
+    const response = await this.client.rawFetch(
+      `/v1/agents/${agentId}/chat/stream`,
+      {
+        method: "POST",
+        body: {
+          message: params.message,
+          ...params.history !== void 0 ? { history: params.history } : {}
+        }
+      }
+    );
+    if (!response.ok) {
+      const payload = await parseMaybeJsonBody(response);
+      const message = extractErrorMessage(payload, response.statusText);
+      throw new RagableError(message, response.status, payload);
+    }
+    const body = response.body;
+    if (!body) {
+      return;
+    }
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+          break;
+        }
+        buffer += decoder.decode(value, { stream: true });
+        let boundary = buffer.indexOf("\n\n");
+        while (boundary !== -1) {
+          const block = buffer.slice(0, boundary);
+          buffer = buffer.slice(boundary + 2);
+          for (const line of block.split("\n")) {
+            const evt = parseSseDataLine(line);
+            if (evt) {
+              yield evt;
+            }
+          }
+          boundary = buffer.indexOf("\n\n");
+        }
+      }
+      if (buffer.trim().length > 0) {
+        for (const line of buffer.split("\n")) {
+          const evt = parseSseDataLine(line);
+          if (evt) {
+            yield evt;
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+};
+async function parseMaybeJsonBody(response) {
+  const contentType = response.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    try {
+      return await response.json();
+    } catch {
+      return null;
+    }
+  }
+  try {
+    return await response.text();
+  } catch {
+    return null;
+  }
+}
+function parseSseDataLine(line) {
+  const dataPrefix = "data: ";
+  if (!line.startsWith(dataPrefix)) {
+    return null;
+  }
+  const json = line.slice(dataPrefix.length).trim();
+  if (json.length === 0 || json === "[DONE]") {
+    return null;
+  }
+  try {
+    return JSON.parse(json);
+  } catch {
+    return null;
+  }
+}
+
+// src/rag.ts
+function formatRetrievalContext(results, options = {}) {
+  const header = options.header ?? "Relevant passages:\n";
+  const separator = options.separator ?? "\n\n";
+  const minScore = options.minScore;
+  let filtered = results;
+  if (typeof minScore === "number") {
+    filtered = results.filter((r) => r.score >= minScore);
+  }
+  const blocks = filtered.map((r, i) => {
+    const scoreSuffix = options.includeScores === true ? ` (score: ${r.score.toFixed(4)})` : "";
+    return `[${i + 1}]${scoreSuffix}
+${r.content.trim()}`;
+  });
+  let text = (blocks.length > 0 ? header : "") + blocks.join(separator);
+  if (typeof options.maxChars === "number" && text.length > options.maxChars) {
+    text = text.slice(0, options.maxChars).trimEnd() + "\n\u2026";
+  }
+  return text;
+}
+function createRagPipeline(client, options) {
+  const { indexId } = options;
+  return {
+    indexId,
+    ingestText(params) {
+      return client.shift.documents.create(indexId, params);
+    },
+    ingestFile(params) {
+      return client.shift.documents.upload(indexId, params);
+    },
+    search(params) {
+      return client.shift.search(indexId, params);
+    },
+    async retrieve(params) {
+      const { format: formatOpts, ...searchParams } = params;
+      const { results } = await client.shift.search(indexId, searchParams);
+      const context = formatRetrievalContext(results, formatOpts ?? {});
+      return { results, context };
+    }
+  };
+}
+
+// src/index.ts
+var Ragable = class {
+  constructor(options) {
+    __publicField(this, "shift");
+    __publicField(this, "agents");
+    __publicField(this, "infrastructure");
+    const client = new RagableRequestClient(options);
+    this.shift = new ShiftClient(client);
+    this.agents = new AgentsClient(client);
+    this.infrastructure = {
+      shift: this.shift
+    };
+  }
+};
+function createClient(options) {
+  return new Ragable(options);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AgentsClient,
   Ragable,
   RagableError,
-  createClient
+  RagableRequestClient,
+  ShiftClient,
+  createClient,
+  createRagPipeline,
+  extractErrorMessage,
+  formatRetrievalContext
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface RagableClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n}\n\nexport interface ShiftIndex {\n  id: string;\n  name: string;\n  description: string | null;\n  dimensions: number;\n  embeddingModel: string;\n  status: string;\n  entryCount?: number;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ShiftEntry {\n  id: string;\n  content: string;\n  metadata: unknown;\n  chunkIndex: number;\n  createdAt: string;\n}\n\nexport interface ShiftSearchResult {\n  content: string;\n  score: number;\n  metadata: unknown;\n}\n\nexport interface ShiftCreateIndexParams {\n  name: string;\n  description?: string;\n  dimensions?: number;\n  embeddingModel?: string;\n}\n\nexport interface ShiftUpdateIndexParams {\n  name?: string;\n  description?: string;\n}\n\nexport interface ShiftAddDocumentParams {\n  content: string;\n  metadata?: Record<string, unknown>;\n  chunkSize?: number;\n  chunkOverlap?: number;\n}\n\nexport type ShiftUploadableFile = Blob | ArrayBuffer | Uint8Array;\n\nexport interface ShiftUploadFileParams {\n  file: ShiftUploadableFile;\n  fileName?: string;\n  contentType?: string;\n  metadata?: Record<string, unknown>;\n  chunkSize?: number;\n  chunkOverlap?: number;\n}\n\nexport interface ShiftListEntriesParams {\n  take?: number;\n  skip?: number;\n}\n\nexport interface ShiftSearchParams {\n  query: string;\n  topK?: number;\n}\n\nexport interface ShiftIngestResponse {\n  chunksCreated: number;\n  entries: string[];\n  extractedText?: string;\n  message?: string;\n}\n\nexport interface ShiftListEntriesResponse {\n  entries: ShiftEntry[];\n  total: number;\n}\n\nexport class RagableError extends Error {\n  readonly status: number;\n  readonly body: unknown;\n\n  constructor(message: string, status: number, body: unknown) {\n    super(message);\n    this.name = \"RagableError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n\ntype RequestOptions = Omit<RequestInit, \"body\"> & {\n  body?: unknown;\n};\n\nclass RagableRequestClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n  private readonly defaultHeaders: HeadersInit | undefined;\n\n  constructor(options: RagableClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl ?? \"http://localhost:8080/api\";\n    this.fetchImpl = options.fetch ?? fetch;\n    this.defaultHeaders = options.headers;\n  }\n\n  async request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n    const headers = new Headers(this.defaultHeaders);\n    headers.set(\"Authorization\", `Bearer ${this.apiKey}`);\n\n    let body = options.body;\n    if (body !== undefined && !isBodyInit(body)) {\n      headers.set(\"Content-Type\", \"application/json\");\n      body = JSON.stringify(body);\n    }\n\n    const response = await this.fetchImpl(this.toUrl(path), {\n      ...options,\n      headers,\n      body: body as BodyInit | undefined,\n    });\n\n    const payload = await this.parseResponseBody(response);\n    if (!response.ok) {\n      const message = extractErrorMessage(payload, response.statusText);\n      throw new RagableError(message, response.status, payload);\n    }\n\n    return payload as T;\n  }\n\n  private toUrl(path: string) {\n    const normalizedBase = this.baseUrl.replace(/\\/+$/, \"\");\n    const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n    return `${normalizedBase}${normalizedPath}`;\n  }\n\n  private async parseResponseBody(response: Response): Promise<unknown> {\n    if (response.status === 204) {\n      return null;\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"application/json\")) {\n      return response.json();\n    }\n\n    return response.text();\n  }\n}\n\nclass ShiftClient {\n  readonly indexes: {\n    list: () => Promise<{ indexes: ShiftIndex[] }>;\n    create: (params: ShiftCreateIndexParams) => Promise<ShiftIndex>;\n    get: (indexId: string) => Promise<ShiftIndex>;\n    update: (indexId: string, params: ShiftUpdateIndexParams) => Promise<ShiftIndex>;\n    delete: (indexId: string) => Promise<{ success: true }>;\n  };\n\n  readonly documents: {\n    create: (\n      indexId: string,\n      params: ShiftAddDocumentParams,\n    ) => Promise<ShiftIngestResponse>;\n    upload: (\n      indexId: string,\n      params: ShiftUploadFileParams,\n    ) => Promise<ShiftIngestResponse>;\n  };\n\n  readonly entries: {\n    list: (\n      indexId: string,\n      params?: ShiftListEntriesParams,\n    ) => Promise<ShiftListEntriesResponse>;\n    delete: (indexId: string, entryId: string) => Promise<{ success: true }>;\n  };\n\n  constructor(private readonly client: RagableRequestClient) {\n    this.indexes = {\n      list: async () => {\n        return this.client.request<{ indexes: ShiftIndex[] }>(\"/v1/shift/indexes\");\n      },\n      create: async (params) => {\n        return this.client.request<ShiftIndex>(\"/v1/shift/indexes\", {\n          method: \"POST\",\n          body: params,\n        });\n      },\n      get: async (indexId) => {\n        return this.client.request<ShiftIndex>(`/v1/shift/indexes/${indexId}`);\n      },\n      update: async (indexId, params) => {\n        return this.client.request<ShiftIndex>(`/v1/shift/indexes/${indexId}`, {\n          method: \"PUT\",\n          body: params,\n        });\n      },\n      delete: async (indexId) => {\n        return this.client.request<{ success: true }>(\n          `/v1/shift/indexes/${indexId}`,\n          {\n            method: \"DELETE\",\n          },\n        );\n      },\n    };\n\n    this.documents = {\n      create: async (indexId, params) => {\n        return this.client.request<ShiftIngestResponse>(\n          `/v1/shift/indexes/${indexId}/documents`,\n          {\n            method: \"POST\",\n            body: params,\n          },\n        );\n      },\n      upload: async (indexId, params) => {\n        const formData = new FormData();\n        const fileName = resolveUploadFileName(params);\n        const contentType = resolveUploadContentType(params);\n        const file = normalizeUploadFile(params.file, contentType);\n\n        formData.set(\"file\", file, fileName);\n\n        if (params.metadata) {\n          formData.set(\"metadata\", JSON.stringify(params.metadata));\n        }\n        if (typeof params.chunkSize === \"number\") {\n          formData.set(\"chunkSize\", String(params.chunkSize));\n        }\n        if (typeof params.chunkOverlap === \"number\") {\n          formData.set(\"chunkOverlap\", String(params.chunkOverlap));\n        }\n\n        return this.client.request<ShiftIngestResponse>(\n          `/v1/shift/indexes/${indexId}/files`,\n          {\n            method: \"POST\",\n            body: formData,\n          },\n        );\n      },\n    };\n\n    this.entries = {\n      list: async (indexId, params = {}) => {\n        const search = new URLSearchParams();\n        if (typeof params.take === \"number\") {\n          search.set(\"take\", String(params.take));\n        }\n        if (typeof params.skip === \"number\") {\n          search.set(\"skip\", String(params.skip));\n        }\n\n        const suffix = search.size > 0 ? `?${search.toString()}` : \"\";\n        return this.client.request<ShiftListEntriesResponse>(\n          `/v1/shift/indexes/${indexId}/entries${suffix}`,\n        );\n      },\n      delete: async (indexId, entryId) => {\n        return this.client.request<{ success: true }>(\n          `/v1/shift/indexes/${indexId}/entries/${entryId}`,\n          {\n            method: \"DELETE\",\n          },\n        );\n      },\n    };\n  }\n\n  async search(indexId: string, params: ShiftSearchParams) {\n    return this.client.request<{ results: ShiftSearchResult[] }>(\n      `/v1/shift/indexes/${indexId}/search`,\n      {\n        method: \"POST\",\n        body: params,\n      },\n    );\n  }\n}\n\nexport class Ragable {\n  readonly shift: ShiftClient;\n  readonly infrastructure: {\n    shift: ShiftClient;\n  };\n\n  constructor(options: RagableClientOptions) {\n    const client = new RagableRequestClient(options);\n    this.shift = new ShiftClient(client);\n    this.infrastructure = {\n      shift: this.shift,\n    };\n  }\n}\n\nexport function createClient(options: RagableClientOptions) {\n  return new Ragable(options);\n}\n\nfunction extractErrorMessage(payload: unknown, fallback: string) {\n  if (payload && typeof payload === \"object\") {\n    if (\"error\" in payload && typeof payload.error === \"string\") {\n      return payload.error;\n    }\n    if (\"message\" in payload && typeof payload.message === \"string\") {\n      return payload.message;\n    }\n  }\n\n  if (typeof payload === \"string\" && payload.length > 0) {\n    return payload;\n  }\n\n  return fallback || \"Request failed\";\n}\n\nfunction resolveUploadFileName(params: ShiftUploadFileParams) {\n  if (params.fileName) {\n    return params.fileName;\n  }\n\n  if (isNamedBlob(params.file)) {\n    return params.file.name;\n  }\n\n  return \"upload.bin\";\n}\n\nfunction resolveUploadContentType(params: ShiftUploadFileParams) {\n  if (params.contentType) {\n    return params.contentType;\n  }\n\n  if (params.file instanceof Blob && params.file.type) {\n    return params.file.type;\n  }\n\n  return \"application/octet-stream\";\n}\n\nfunction normalizeUploadFile(file: ShiftUploadableFile, contentType: string) {\n  if (file instanceof Blob) {\n    return file;\n  }\n\n  if (file instanceof Uint8Array) {\n    return new Blob([toArrayBuffer(file)], { type: contentType });\n  }\n\n  return new Blob([file], { type: contentType });\n}\n\nfunction isNamedBlob(value: ShiftUploadableFile): value is Blob & { name: string } {\n  return value instanceof Blob && \"name\" in value && typeof value.name === \"string\";\n}\n\nfunction isBodyInit(value: unknown): value is BodyInit {\n  return (\n    typeof value === \"string\" ||\n    value instanceof Blob ||\n    value instanceof FormData ||\n    value instanceof URLSearchParams ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value)\n  );\n}\n\nfunction toArrayBuffer(value: Uint8Array) {\n  const copy = new Uint8Array(value.byteLength);\n  copy.set(value);\n  return copy.buffer;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/request-client.ts","../src/shift.ts","../src/agents.ts","../src/rag.ts"],"sourcesContent":["export type { RagableClientOptions, RequestOptions } from \"./request-client\";\nexport {\n  extractErrorMessage,\n  RagableError,\n  RagableRequestClient,\n} from \"./request-client\";\n\nexport type {\n  ShiftAddDocumentParams,\n  ShiftCreateIndexParams,\n  ShiftEntry,\n  ShiftIndex,\n  ShiftIngestResponse,\n  ShiftListEntriesParams,\n  ShiftListEntriesResponse,\n  ShiftSearchParams,\n  ShiftSearchResult,\n  ShiftUpdateIndexParams,\n  ShiftUploadableFile,\n  ShiftUploadFileParams,\n} from \"./shift\";\nexport { ShiftClient } from \"./shift\";\n\nexport type {\n  AgentChatMessage,\n  AgentChatParams,\n  AgentChatResult,\n  AgentStreamEvent,\n  AgentSummary,\n} from \"./agents\";\nexport { AgentsClient } from \"./agents\";\n\nexport type {\n  FormatContextOptions,\n  RagClientForPipeline,\n  RagPipeline,\n  RagPipelineOptions,\n  RetrieveParams,\n} from \"./rag\";\nexport { createRagPipeline, formatRetrievalContext } from \"./rag\";\n\nimport { AgentsClient } from \"./agents\";\nimport {\n  RagableRequestClient,\n  type RagableClientOptions,\n} from \"./request-client\";\nimport { ShiftClient } from \"./shift\";\n\nexport class Ragable {\n  readonly shift: ShiftClient;\n  readonly agents: AgentsClient;\n  readonly infrastructure: {\n    shift: ShiftClient;\n  };\n\n  constructor(options: RagableClientOptions) {\n    const client = new RagableRequestClient(options);\n    this.shift = new ShiftClient(client);\n    this.agents = new AgentsClient(client);\n    this.infrastructure = {\n      shift: this.shift,\n    };\n  }\n}\n\nexport function createClient(options: RagableClientOptions) {\n  return new Ragable(options);\n}\n","export interface RagableClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n}\n\nexport type RequestOptions = Omit<RequestInit, \"body\"> & {\n  body?: unknown;\n};\n\nexport class RagableError extends Error {\n  readonly status: number;\n  readonly body: unknown;\n\n  constructor(message: string, status: number, body: unknown) {\n    super(message);\n    this.name = \"RagableError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n\nexport function extractErrorMessage(payload: unknown, fallback: string) {\n  if (payload && typeof payload === \"object\") {\n    if (\"error\" in payload && typeof payload.error === \"string\") {\n      return payload.error;\n    }\n    if (\"message\" in payload && typeof payload.message === \"string\") {\n      return payload.message;\n    }\n  }\n\n  if (typeof payload === \"string\" && payload.length > 0) {\n    return payload;\n  }\n\n  return fallback || \"Request failed\";\n}\n\nexport class RagableRequestClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n  private readonly defaultHeaders: HeadersInit | undefined;\n\n  constructor(options: RagableClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl ?? \"http://localhost:8080/api\";\n    this.fetchImpl = options.fetch ?? fetch;\n    this.defaultHeaders = options.headers;\n  }\n\n  toUrl(path: string) {\n    const normalizedBase = this.baseUrl.replace(/\\/+$/, \"\");\n    const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n    return `${normalizedBase}${normalizedPath}`;\n  }\n\n  async request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n    const response = await this.rawFetch(path, options);\n    const payload = await this.parseResponseBody(response);\n    if (!response.ok) {\n      const message = extractErrorMessage(payload, response.statusText);\n      throw new RagableError(message, response.status, payload);\n    }\n\n    return payload as T;\n  }\n\n  /**\n   * Low-level fetch with API key and JSON body encoding. Caller handles status and body.\n   */\n  async rawFetch(path: string, options: RequestOptions = {}): Promise<Response> {\n    const headers = new Headers(this.defaultHeaders);\n    headers.set(\"Authorization\", `Bearer ${this.apiKey}`);\n\n    let body = options.body;\n    if (body !== undefined && !isBodyInit(body)) {\n      headers.set(\"Content-Type\", \"application/json\");\n      body = JSON.stringify(body);\n    }\n\n    return this.fetchImpl(this.toUrl(path), {\n      ...options,\n      headers,\n      body: body as BodyInit | undefined,\n    });\n  }\n\n  private async parseResponseBody(response: Response): Promise<unknown> {\n    if (response.status === 204) {\n      return null;\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"application/json\")) {\n      return response.json();\n    }\n\n    return response.text();\n  }\n}\n\nexport function isBodyInit(value: unknown): value is BodyInit {\n  return (\n    typeof value === \"string\" ||\n    value instanceof Blob ||\n    value instanceof FormData ||\n    value instanceof URLSearchParams ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value)\n  );\n}\n","import { RagableRequestClient } from \"./request-client\";\n\nexport interface ShiftIndex {\n  id: string;\n  name: string;\n  description: string | null;\n  dimensions: number;\n  embeddingModel: string;\n  status: string;\n  entryCount?: number;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ShiftEntry {\n  id: string;\n  content: string;\n  metadata: unknown;\n  chunkIndex: number;\n  createdAt: string;\n}\n\nexport interface ShiftSearchResult {\n  content: string;\n  score: number;\n  metadata: unknown;\n}\n\nexport interface ShiftCreateIndexParams {\n  name: string;\n  description?: string;\n  dimensions?: number;\n  embeddingModel?: string;\n}\n\nexport interface ShiftUpdateIndexParams {\n  name?: string;\n  description?: string;\n}\n\nexport interface ShiftAddDocumentParams {\n  content: string;\n  metadata?: Record<string, unknown>;\n  chunkSize?: number;\n  chunkOverlap?: number;\n}\n\nexport type ShiftUploadableFile = Blob | ArrayBuffer | Uint8Array;\n\nexport interface ShiftUploadFileParams {\n  file: ShiftUploadableFile;\n  fileName?: string;\n  contentType?: string;\n  metadata?: Record<string, unknown>;\n  chunkSize?: number;\n  chunkOverlap?: number;\n}\n\nexport interface ShiftListEntriesParams {\n  take?: number;\n  skip?: number;\n}\n\nexport interface ShiftSearchParams {\n  query: string;\n  topK?: number;\n}\n\nexport interface ShiftIngestResponse {\n  chunksCreated: number;\n  entries: string[];\n  extractedText?: string;\n  message?: string;\n}\n\nexport interface ShiftListEntriesResponse {\n  entries: ShiftEntry[];\n  total: number;\n}\n\nexport class ShiftClient {\n  readonly indexes: {\n    list: () => Promise<{ indexes: ShiftIndex[] }>;\n    create: (params: ShiftCreateIndexParams) => Promise<ShiftIndex>;\n    get: (indexId: string) => Promise<ShiftIndex>;\n    update: (indexId: string, params: ShiftUpdateIndexParams) => Promise<ShiftIndex>;\n    delete: (indexId: string) => Promise<{ success: true }>;\n  };\n\n  readonly documents: {\n    create: (\n      indexId: string,\n      params: ShiftAddDocumentParams,\n    ) => Promise<ShiftIngestResponse>;\n    upload: (\n      indexId: string,\n      params: ShiftUploadFileParams,\n    ) => Promise<ShiftIngestResponse>;\n  };\n\n  readonly entries: {\n    list: (\n      indexId: string,\n      params?: ShiftListEntriesParams,\n    ) => Promise<ShiftListEntriesResponse>;\n    delete: (indexId: string, entryId: string) => Promise<{ success: true }>;\n  };\n\n  constructor(private readonly client: RagableRequestClient) {\n    this.indexes = {\n      list: async () => {\n        return this.client.request<{ indexes: ShiftIndex[] }>(\"/v1/shift/indexes\");\n      },\n      create: async (params) => {\n        return this.client.request<ShiftIndex>(\"/v1/shift/indexes\", {\n          method: \"POST\",\n          body: params,\n        });\n      },\n      get: async (indexId) => {\n        return this.client.request<ShiftIndex>(`/v1/shift/indexes/${indexId}`);\n      },\n      update: async (indexId, params) => {\n        return this.client.request<ShiftIndex>(`/v1/shift/indexes/${indexId}`, {\n          method: \"PUT\",\n          body: params,\n        });\n      },\n      delete: async (indexId) => {\n        return this.client.request<{ success: true }>(\n          `/v1/shift/indexes/${indexId}`,\n          {\n            method: \"DELETE\",\n          },\n        );\n      },\n    };\n\n    this.documents = {\n      create: async (indexId, params) => {\n        return this.client.request<ShiftIngestResponse>(\n          `/v1/shift/indexes/${indexId}/documents`,\n          {\n            method: \"POST\",\n            body: params,\n          },\n        );\n      },\n      upload: async (indexId, params) => {\n        const formData = new FormData();\n        const fileName = resolveUploadFileName(params);\n        const contentType = resolveUploadContentType(params);\n        const file = normalizeUploadFile(params.file, contentType);\n\n        formData.set(\"file\", file, fileName);\n\n        if (params.metadata) {\n          formData.set(\"metadata\", JSON.stringify(params.metadata));\n        }\n        if (typeof params.chunkSize === \"number\") {\n          formData.set(\"chunkSize\", String(params.chunkSize));\n        }\n        if (typeof params.chunkOverlap === \"number\") {\n          formData.set(\"chunkOverlap\", String(params.chunkOverlap));\n        }\n\n        return this.client.request<ShiftIngestResponse>(\n          `/v1/shift/indexes/${indexId}/files`,\n          {\n            method: \"POST\",\n            body: formData,\n          },\n        );\n      },\n    };\n\n    this.entries = {\n      list: async (indexId, params = {}) => {\n        const search = new URLSearchParams();\n        if (typeof params.take === \"number\") {\n          search.set(\"take\", String(params.take));\n        }\n        if (typeof params.skip === \"number\") {\n          search.set(\"skip\", String(params.skip));\n        }\n\n        const suffix = search.size > 0 ? `?${search.toString()}` : \"\";\n        return this.client.request<ShiftListEntriesResponse>(\n          `/v1/shift/indexes/${indexId}/entries${suffix}`,\n        );\n      },\n      delete: async (indexId, entryId) => {\n        return this.client.request<{ success: true }>(\n          `/v1/shift/indexes/${indexId}/entries/${entryId}`,\n          {\n            method: \"DELETE\",\n          },\n        );\n      },\n    };\n  }\n\n  async search(indexId: string, params: ShiftSearchParams) {\n    return this.client.request<{ results: ShiftSearchResult[] }>(\n      `/v1/shift/indexes/${indexId}/search`,\n      {\n        method: \"POST\",\n        body: params,\n      },\n    );\n  }\n}\n\nfunction resolveUploadFileName(params: ShiftUploadFileParams) {\n  if (params.fileName) {\n    return params.fileName;\n  }\n\n  if (isNamedBlob(params.file)) {\n    return params.file.name;\n  }\n\n  return \"upload.bin\";\n}\n\nfunction resolveUploadContentType(params: ShiftUploadFileParams) {\n  if (params.contentType) {\n    return params.contentType;\n  }\n\n  if (params.file instanceof Blob && params.file.type) {\n    return params.file.type;\n  }\n\n  return \"application/octet-stream\";\n}\n\nfunction normalizeUploadFile(file: ShiftUploadableFile, contentType: string) {\n  if (file instanceof Blob) {\n    return file;\n  }\n\n  if (file instanceof Uint8Array) {\n    return new Blob([toArrayBuffer(file)], { type: contentType });\n  }\n\n  return new Blob([file], { type: contentType });\n}\n\nfunction isNamedBlob(value: ShiftUploadableFile): value is Blob & { name: string } {\n  return value instanceof Blob && \"name\" in value && typeof value.name === \"string\";\n}\n\nfunction toArrayBuffer(value: Uint8Array) {\n  const copy = new Uint8Array(value.byteLength);\n  copy.set(value);\n  return copy.buffer;\n}\n","import {\n  extractErrorMessage,\n  RagableError,\n  RagableRequestClient,\n} from \"./request-client\";\n\nexport interface AgentSummary {\n  id: string;\n  name: string;\n  description: string | null;\n  active: boolean;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface AgentChatMessage {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface AgentChatParams {\n  message: string;\n  history?: AgentChatMessage[];\n}\n\n/** Mirrors backend ExecutionResult JSON shape (traces are opaque in the SDK). */\nexport interface AgentChatResult {\n  response: string;\n  traces: unknown[];\n  totalDurationMs: number;\n  httpResponse?: unknown;\n}\n\n/**\n * Loose SSE event from POST /v1/agents/:id/chat/stream — narrows with `type` at runtime.\n */\nexport type AgentStreamEvent = Record<string, unknown> & { type: string };\n\nexport class AgentsClient {\n  constructor(private readonly client: RagableRequestClient) {}\n\n  async list(): Promise<{ agents: AgentSummary[] }> {\n    return this.client.request(\"/v1/agents\");\n  }\n\n  async get(agentId: string): Promise<AgentSummary> {\n    return this.client.request(`/v1/agents/${agentId}`);\n  }\n\n  async chat(\n    agentId: string,\n    params: AgentChatParams,\n  ): Promise<AgentChatResult> {\n    return this.client.request<AgentChatResult>(`/v1/agents/${agentId}/chat`, {\n      method: \"POST\",\n      body: {\n        message: params.message,\n        ...(params.history !== undefined ? { history: params.history } : {}),\n      },\n    });\n  }\n\n  /**\n   * Stream agent execution as SSE (`data: {json}` lines). Yields parsed JSON objects.\n   */\n  async *chatStream(\n    agentId: string,\n    params: AgentChatParams,\n  ): AsyncGenerator<AgentStreamEvent, void, undefined> {\n    const response = await this.client.rawFetch(\n      `/v1/agents/${agentId}/chat/stream`,\n      {\n        method: \"POST\",\n        body: {\n          message: params.message,\n          ...(params.history !== undefined ? { history: params.history } : {}),\n        },\n      },\n    );\n\n    if (!response.ok) {\n      const payload = await parseMaybeJsonBody(response);\n      const message = extractErrorMessage(payload, response.statusText);\n      throw new RagableError(message, response.status, payload);\n    }\n\n    const body = response.body;\n    if (!body) {\n      return;\n    }\n\n    const reader = body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) {\n          break;\n        }\n        buffer += decoder.decode(value, { stream: true });\n\n        let boundary = buffer.indexOf(\"\\n\\n\");\n        while (boundary !== -1) {\n          const block = buffer.slice(0, boundary);\n          buffer = buffer.slice(boundary + 2);\n          for (const line of block.split(\"\\n\")) {\n            const evt = parseSseDataLine(line);\n            if (evt) {\n              yield evt;\n            }\n          }\n          boundary = buffer.indexOf(\"\\n\\n\");\n        }\n      }\n\n      if (buffer.trim().length > 0) {\n        for (const line of buffer.split(\"\\n\")) {\n          const evt = parseSseDataLine(line);\n          if (evt) {\n            yield evt;\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n\nasync function parseMaybeJsonBody(response: Response): Promise<unknown> {\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    try {\n      return await response.json();\n    } catch {\n      return null;\n    }\n  }\n  try {\n    return await response.text();\n  } catch {\n    return null;\n  }\n}\n\nfunction parseSseDataLine(line: string): AgentStreamEvent | null {\n  const dataPrefix = \"data: \";\n  if (!line.startsWith(dataPrefix)) {\n    return null;\n  }\n  const json = line.slice(dataPrefix.length).trim();\n  if (json.length === 0 || json === \"[DONE]\") {\n    return null;\n  }\n  try {\n    return JSON.parse(json) as AgentStreamEvent;\n  } catch {\n    return null;\n  }\n}\n","import type {\n  ShiftAddDocumentParams,\n  ShiftIngestResponse,\n  ShiftSearchParams,\n  ShiftSearchResult,\n  ShiftUploadFileParams,\n} from \"./shift\";\n\n/** Minimal client surface for {@link createRagPipeline} (implemented by {@link Ragable}). */\nexport interface RagClientForPipeline {\n  shift: {\n    documents: {\n      create: (\n        indexId: string,\n        params: ShiftAddDocumentParams,\n      ) => Promise<ShiftIngestResponse>;\n      upload: (\n        indexId: string,\n        params: ShiftUploadFileParams,\n      ) => Promise<ShiftIngestResponse>;\n    };\n    search: (\n      indexId: string,\n      params: ShiftSearchParams,\n    ) => Promise<{ results: ShiftSearchResult[] }>;\n  };\n}\n\nexport interface FormatContextOptions {\n  /** Prepended before numbered passages (default: \"Relevant passages:\\\\n\") */\n  header?: string;\n  /** Joiner between passages (default: \"\\\\n\\\\n\") */\n  separator?: string;\n  /** Omit results with similarity score below this (default: no filter) */\n  minScore?: number;\n  /** Truncate total context string to this UTF-16 length (default: no limit) */\n  maxChars?: number;\n  /** Include similarity score in each block (default: false) */\n  includeScores?: boolean;\n}\n\nexport interface RagPipelineOptions {\n  indexId: string;\n}\n\nexport type RetrieveParams = ShiftSearchParams & {\n  format?: FormatContextOptions;\n};\n\nexport interface RagPipeline {\n  readonly indexId: string;\n  ingestText(params: ShiftAddDocumentParams): Promise<ShiftIngestResponse>;\n  ingestFile(params: ShiftUploadFileParams): Promise<ShiftIngestResponse>;\n  search(params: ShiftSearchParams): Promise<{ results: ShiftSearchResult[] }>;\n  retrieve(params: RetrieveParams): Promise<{\n    results: ShiftSearchResult[];\n    context: string;\n  }>;\n}\n\n/**\n * Turn vector search hits into a single block of text for system prompts or RAG user messages.\n */\nexport function formatRetrievalContext(\n  results: ShiftSearchResult[],\n  options: FormatContextOptions = {},\n): string {\n  const header = options.header ?? \"Relevant passages:\\n\";\n  const separator = options.separator ?? \"\\n\\n\";\n  const minScore = options.minScore;\n\n  let filtered = results;\n  if (typeof minScore === \"number\") {\n    filtered = results.filter((r) => r.score >= minScore);\n  }\n\n  const blocks = filtered.map((r, i) => {\n    const scoreSuffix =\n      options.includeScores === true ? ` (score: ${r.score.toFixed(4)})` : \"\";\n    return `[${i + 1}]${scoreSuffix}\\n${r.content.trim()}`;\n  });\n\n  let text = (blocks.length > 0 ? header : \"\") + blocks.join(separator);\n\n  if (typeof options.maxChars === \"number\" && text.length > options.maxChars) {\n    text = text.slice(0, options.maxChars).trimEnd() + \"\\n…\";\n  }\n\n  return text;\n}\n\n/**\n * High-level RAG helpers bound to one Shift index: ingest, search, retrieve with prompt-ready context.\n */\nexport function createRagPipeline(\n  client: RagClientForPipeline,\n  options: RagPipelineOptions,\n): RagPipeline {\n  const { indexId } = options;\n\n  return {\n    indexId,\n\n    ingestText(params) {\n      return client.shift.documents.create(indexId, params);\n    },\n\n    ingestFile(params) {\n      return client.shift.documents.upload(indexId, params);\n    },\n\n    search(params) {\n      return client.shift.search(indexId, params);\n    },\n\n    async retrieve(params) {\n      const { format: formatOpts, ...searchParams } = params;\n      const { results } = await client.shift.search(indexId, searchParams);\n      const context = formatRetrievalContext(results, formatOpts ?? {});\n      return { results, context };\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -2,7 +2,7 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
-// src/index.ts
+// src/request-client.ts
 var RagableError = class extends Error {
   constructor(message, status, body) {
     super(message);
@@ -13,6 +13,20 @@ var RagableError = class extends Error {
     this.body = body;
   }
 };
+function extractErrorMessage(payload, fallback) {
+  if (payload && typeof payload === "object") {
+    if ("error" in payload && typeof payload.error === "string") {
+      return payload.error;
+    }
+    if ("message" in payload && typeof payload.message === "string") {
+      return payload.message;
+    }
+  }
+  if (typeof payload === "string" && payload.length > 0) {
+    return payload;
+  }
+  return fallback || "Request failed";
+}
 var RagableRequestClient = class {
   constructor(options) {
     __publicField(this, "apiKey");
@@ -24,7 +38,24 @@ var RagableRequestClient = class {
     this.fetchImpl = options.fetch ?? fetch;
     this.defaultHeaders = options.headers;
   }
+  toUrl(path) {
+    const normalizedBase = this.baseUrl.replace(/\/+$/, "");
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${normalizedBase}${normalizedPath}`;
+  }
   async request(path, options = {}) {
+    const response = await this.rawFetch(path, options);
+    const payload = await this.parseResponseBody(response);
+    if (!response.ok) {
+      const message = extractErrorMessage(payload, response.statusText);
+      throw new RagableError(message, response.status, payload);
+    }
+    return payload;
+  }
+  /**
+   * Low-level fetch with API key and JSON body encoding. Caller handles status and body.
+   */
+  async rawFetch(path, options = {}) {
     const headers = new Headers(this.defaultHeaders);
     headers.set("Authorization", `Bearer ${this.apiKey}`);
     let body = options.body;
@@ -32,22 +63,11 @@ var RagableRequestClient = class {
       headers.set("Content-Type", "application/json");
       body = JSON.stringify(body);
     }
-    const response = await this.fetchImpl(this.toUrl(path), {
+    return this.fetchImpl(this.toUrl(path), {
       ...options,
       headers,
       body
     });
-    const payload = await this.parseResponseBody(response);
-    if (!response.ok) {
-      const message = extractErrorMessage(payload, response.statusText);
-      throw new RagableError(message, response.status, payload);
-    }
-    return payload;
-  }
-  toUrl(path) {
-    const normalizedBase = this.baseUrl.replace(/\/+$/, "");
-    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
-    return `${normalizedBase}${normalizedPath}`;
   }
   async parseResponseBody(response) {
     if (response.status === 204) {
@@ -60,6 +80,11 @@ var RagableRequestClient = class {
     return response.text();
   }
 };
+function isBodyInit(value) {
+  return typeof value === "string" || value instanceof Blob || value instanceof FormData || value instanceof URLSearchParams || value instanceof ArrayBuffer || ArrayBuffer.isView(value);
+}
+
+// src/shift.ts
 var ShiftClient = class {
   constructor(client) {
     this.client = client;
@@ -162,34 +187,6 @@ var ShiftClient = class {
     );
   }
 };
-var Ragable = class {
-  constructor(options) {
-    __publicField(this, "shift");
-    __publicField(this, "infrastructure");
-    const client = new RagableRequestClient(options);
-    this.shift = new ShiftClient(client);
-    this.infrastructure = {
-      shift: this.shift
-    };
-  }
-};
-function createClient(options) {
-  return new Ragable(options);
-}
-function extractErrorMessage(payload, fallback) {
-  if (payload && typeof payload === "object") {
-    if ("error" in payload && typeof payload.error === "string") {
-      return payload.error;
-    }
-    if ("message" in payload && typeof payload.message === "string") {
-      return payload.message;
-    }
-  }
-  if (typeof payload === "string" && payload.length > 0) {
-    return payload;
-  }
-  return fallback || "Request failed";
-}
 function resolveUploadFileName(params) {
   if (params.fileName) {
     return params.fileName;
@@ -220,17 +217,190 @@ function normalizeUploadFile(file, contentType) {
 function isNamedBlob(value) {
   return value instanceof Blob && "name" in value && typeof value.name === "string";
 }
-function isBodyInit(value) {
-  return typeof value === "string" || value instanceof Blob || value instanceof FormData || value instanceof URLSearchParams || value instanceof ArrayBuffer || ArrayBuffer.isView(value);
-}
 function toArrayBuffer(value) {
   const copy = new Uint8Array(value.byteLength);
   copy.set(value);
   return copy.buffer;
 }
+
+// src/agents.ts
+var AgentsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("/v1/agents");
+  }
+  async get(agentId) {
+    return this.client.request(`/v1/agents/${agentId}`);
+  }
+  async chat(agentId, params) {
+    return this.client.request(`/v1/agents/${agentId}/chat`, {
+      method: "POST",
+      body: {
+        message: params.message,
+        ...params.history !== void 0 ? { history: params.history } : {}
+      }
+    });
+  }
+  /**
+   * Stream agent execution as SSE (`data: {json}` lines). Yields parsed JSON objects.
+   */
+  async *chatStream(agentId, params) {
+    const response = await this.client.rawFetch(
+      `/v1/agents/${agentId}/chat/stream`,
+      {
+        method: "POST",
+        body: {
+          message: params.message,
+          ...params.history !== void 0 ? { history: params.history } : {}
+        }
+      }
+    );
+    if (!response.ok) {
+      const payload = await parseMaybeJsonBody(response);
+      const message = extractErrorMessage(payload, response.statusText);
+      throw new RagableError(message, response.status, payload);
+    }
+    const body = response.body;
+    if (!body) {
+      return;
+    }
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+          break;
+        }
+        buffer += decoder.decode(value, { stream: true });
+        let boundary = buffer.indexOf("\n\n");
+        while (boundary !== -1) {
+          const block = buffer.slice(0, boundary);
+          buffer = buffer.slice(boundary + 2);
+          for (const line of block.split("\n")) {
+            const evt = parseSseDataLine(line);
+            if (evt) {
+              yield evt;
+            }
+          }
+          boundary = buffer.indexOf("\n\n");
+        }
+      }
+      if (buffer.trim().length > 0) {
+        for (const line of buffer.split("\n")) {
+          const evt = parseSseDataLine(line);
+          if (evt) {
+            yield evt;
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+};
+async function parseMaybeJsonBody(response) {
+  const contentType = response.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    try {
+      return await response.json();
+    } catch {
+      return null;
+    }
+  }
+  try {
+    return await response.text();
+  } catch {
+    return null;
+  }
+}
+function parseSseDataLine(line) {
+  const dataPrefix = "data: ";
+  if (!line.startsWith(dataPrefix)) {
+    return null;
+  }
+  const json = line.slice(dataPrefix.length).trim();
+  if (json.length === 0 || json === "[DONE]") {
+    return null;
+  }
+  try {
+    return JSON.parse(json);
+  } catch {
+    return null;
+  }
+}
+
+// src/rag.ts
+function formatRetrievalContext(results, options = {}) {
+  const header = options.header ?? "Relevant passages:\n";
+  const separator = options.separator ?? "\n\n";
+  const minScore = options.minScore;
+  let filtered = results;
+  if (typeof minScore === "number") {
+    filtered = results.filter((r) => r.score >= minScore);
+  }
+  const blocks = filtered.map((r, i) => {
+    const scoreSuffix = options.includeScores === true ? ` (score: ${r.score.toFixed(4)})` : "";
+    return `[${i + 1}]${scoreSuffix}
+${r.content.trim()}`;
+  });
+  let text = (blocks.length > 0 ? header : "") + blocks.join(separator);
+  if (typeof options.maxChars === "number" && text.length > options.maxChars) {
+    text = text.slice(0, options.maxChars).trimEnd() + "\n\u2026";
+  }
+  return text;
+}
+function createRagPipeline(client, options) {
+  const { indexId } = options;
+  return {
+    indexId,
+    ingestText(params) {
+      return client.shift.documents.create(indexId, params);
+    },
+    ingestFile(params) {
+      return client.shift.documents.upload(indexId, params);
+    },
+    search(params) {
+      return client.shift.search(indexId, params);
+    },
+    async retrieve(params) {
+      const { format: formatOpts, ...searchParams } = params;
+      const { results } = await client.shift.search(indexId, searchParams);
+      const context = formatRetrievalContext(results, formatOpts ?? {});
+      return { results, context };
+    }
+  };
+}
+
+// src/index.ts
+var Ragable = class {
+  constructor(options) {
+    __publicField(this, "shift");
+    __publicField(this, "agents");
+    __publicField(this, "infrastructure");
+    const client = new RagableRequestClient(options);
+    this.shift = new ShiftClient(client);
+    this.agents = new AgentsClient(client);
+    this.infrastructure = {
+      shift: this.shift
+    };
+  }
+};
+function createClient(options) {
+  return new Ragable(options);
+}
 export {
+  AgentsClient,
   Ragable,
   RagableError,
-  createClient
+  RagableRequestClient,
+  ShiftClient,
+  createClient,
+  createRagPipeline,
+  extractErrorMessage,
+  formatRetrievalContext
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface RagableClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n}\n\nexport interface ShiftIndex {\n  id: string;\n  name: string;\n  description: string | null;\n  dimensions: number;\n  embeddingModel: string;\n  status: string;\n  entryCount?: number;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ShiftEntry {\n  id: string;\n  content: string;\n  metadata: unknown;\n  chunkIndex: number;\n  createdAt: string;\n}\n\nexport interface ShiftSearchResult {\n  content: string;\n  score: number;\n  metadata: unknown;\n}\n\nexport interface ShiftCreateIndexParams {\n  name: string;\n  description?: string;\n  dimensions?: number;\n  embeddingModel?: string;\n}\n\nexport interface ShiftUpdateIndexParams {\n  name?: string;\n  description?: string;\n}\n\nexport interface ShiftAddDocumentParams {\n  content: string;\n  metadata?: Record<string, unknown>;\n  chunkSize?: number;\n  chunkOverlap?: number;\n}\n\nexport type ShiftUploadableFile = Blob | ArrayBuffer | Uint8Array;\n\nexport interface ShiftUploadFileParams {\n  file: ShiftUploadableFile;\n  fileName?: string;\n  contentType?: string;\n  metadata?: Record<string, unknown>;\n  chunkSize?: number;\n  chunkOverlap?: number;\n}\n\nexport interface ShiftListEntriesParams {\n  take?: number;\n  skip?: number;\n}\n\nexport interface ShiftSearchParams {\n  query: string;\n  topK?: number;\n}\n\nexport interface ShiftIngestResponse {\n  chunksCreated: number;\n  entries: string[];\n  extractedText?: string;\n  message?: string;\n}\n\nexport interface ShiftListEntriesResponse {\n  entries: ShiftEntry[];\n  total: number;\n}\n\nexport class RagableError extends Error {\n  readonly status: number;\n  readonly body: unknown;\n\n  constructor(message: string, status: number, body: unknown) {\n    super(message);\n    this.name = \"RagableError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n\ntype RequestOptions = Omit<RequestInit, \"body\"> & {\n  body?: unknown;\n};\n\nclass RagableRequestClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n  private readonly defaultHeaders: HeadersInit | undefined;\n\n  constructor(options: RagableClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl ?? \"http://localhost:8080/api\";\n    this.fetchImpl = options.fetch ?? fetch;\n    this.defaultHeaders = options.headers;\n  }\n\n  async request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n    const headers = new Headers(this.defaultHeaders);\n    headers.set(\"Authorization\", `Bearer ${this.apiKey}`);\n\n    let body = options.body;\n    if (body !== undefined && !isBodyInit(body)) {\n      headers.set(\"Content-Type\", \"application/json\");\n      body = JSON.stringify(body);\n    }\n\n    const response = await this.fetchImpl(this.toUrl(path), {\n      ...options,\n      headers,\n      body: body as BodyInit | undefined,\n    });\n\n    const payload = await this.parseResponseBody(response);\n    if (!response.ok) {\n      const message = extractErrorMessage(payload, response.statusText);\n      throw new RagableError(message, response.status, payload);\n    }\n\n    return payload as T;\n  }\n\n  private toUrl(path: string) {\n    const normalizedBase = this.baseUrl.replace(/\\/+$/, \"\");\n    const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n    return `${normalizedBase}${normalizedPath}`;\n  }\n\n  private async parseResponseBody(response: Response): Promise<unknown> {\n    if (response.status === 204) {\n      return null;\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"application/json\")) {\n      return response.json();\n    }\n\n    return response.text();\n  }\n}\n\nclass ShiftClient {\n  readonly indexes: {\n    list: () => Promise<{ indexes: ShiftIndex[] }>;\n    create: (params: ShiftCreateIndexParams) => Promise<ShiftIndex>;\n    get: (indexId: string) => Promise<ShiftIndex>;\n    update: (indexId: string, params: ShiftUpdateIndexParams) => Promise<ShiftIndex>;\n    delete: (indexId: string) => Promise<{ success: true }>;\n  };\n\n  readonly documents: {\n    create: (\n      indexId: string,\n      params: ShiftAddDocumentParams,\n    ) => Promise<ShiftIngestResponse>;\n    upload: (\n      indexId: string,\n      params: ShiftUploadFileParams,\n    ) => Promise<ShiftIngestResponse>;\n  };\n\n  readonly entries: {\n    list: (\n      indexId: string,\n      params?: ShiftListEntriesParams,\n    ) => Promise<ShiftListEntriesResponse>;\n    delete: (indexId: string, entryId: string) => Promise<{ success: true }>;\n  };\n\n  constructor(private readonly client: RagableRequestClient) {\n    this.indexes = {\n      list: async () => {\n        return this.client.request<{ indexes: ShiftIndex[] }>(\"/v1/shift/indexes\");\n      },\n      create: async (params) => {\n        return this.client.request<ShiftIndex>(\"/v1/shift/indexes\", {\n          method: \"POST\",\n          body: params,\n        });\n      },\n      get: async (indexId) => {\n        return this.client.request<ShiftIndex>(`/v1/shift/indexes/${indexId}`);\n      },\n      update: async (indexId, params) => {\n        return this.client.request<ShiftIndex>(`/v1/shift/indexes/${indexId}`, {\n          method: \"PUT\",\n          body: params,\n        });\n      },\n      delete: async (indexId) => {\n        return this.client.request<{ success: true }>(\n          `/v1/shift/indexes/${indexId}`,\n          {\n            method: \"DELETE\",\n          },\n        );\n      },\n    };\n\n    this.documents = {\n      create: async (indexId, params) => {\n        return this.client.request<ShiftIngestResponse>(\n          `/v1/shift/indexes/${indexId}/documents`,\n          {\n            method: \"POST\",\n            body: params,\n          },\n        );\n      },\n      upload: async (indexId, params) => {\n        const formData = new FormData();\n        const fileName = resolveUploadFileName(params);\n        const contentType = resolveUploadContentType(params);\n        const file = normalizeUploadFile(params.file, contentType);\n\n        formData.set(\"file\", file, fileName);\n\n        if (params.metadata) {\n          formData.set(\"metadata\", JSON.stringify(params.metadata));\n        }\n        if (typeof params.chunkSize === \"number\") {\n          formData.set(\"chunkSize\", String(params.chunkSize));\n        }\n        if (typeof params.chunkOverlap === \"number\") {\n          formData.set(\"chunkOverlap\", String(params.chunkOverlap));\n        }\n\n        return this.client.request<ShiftIngestResponse>(\n          `/v1/shift/indexes/${indexId}/files`,\n          {\n            method: \"POST\",\n            body: formData,\n          },\n        );\n      },\n    };\n\n    this.entries = {\n      list: async (indexId, params = {}) => {\n        const search = new URLSearchParams();\n        if (typeof params.take === \"number\") {\n          search.set(\"take\", String(params.take));\n        }\n        if (typeof params.skip === \"number\") {\n          search.set(\"skip\", String(params.skip));\n        }\n\n        const suffix = search.size > 0 ? `?${search.toString()}` : \"\";\n        return this.client.request<ShiftListEntriesResponse>(\n          `/v1/shift/indexes/${indexId}/entries${suffix}`,\n        );\n      },\n      delete: async (indexId, entryId) => {\n        return this.client.request<{ success: true }>(\n          `/v1/shift/indexes/${indexId}/entries/${entryId}`,\n          {\n            method: \"DELETE\",\n          },\n        );\n      },\n    };\n  }\n\n  async search(indexId: string, params: ShiftSearchParams) {\n    return this.client.request<{ results: ShiftSearchResult[] }>(\n      `/v1/shift/indexes/${indexId}/search`,\n      {\n        method: \"POST\",\n        body: params,\n      },\n    );\n  }\n}\n\nexport class Ragable {\n  readonly shift: ShiftClient;\n  readonly infrastructure: {\n    shift: ShiftClient;\n  };\n\n  constructor(options: RagableClientOptions) {\n    const client = new RagableRequestClient(options);\n    this.shift = new ShiftClient(client);\n    this.infrastructure = {\n      shift: this.shift,\n    };\n  }\n}\n\nexport function createClient(options: RagableClientOptions) {\n  return new Ragable(options);\n}\n\nfunction extractErrorMessage(payload: unknown, fallback: string) {\n  if (payload && typeof payload === \"object\") {\n    if (\"error\" in payload && typeof payload.error === \"string\") {\n      return payload.error;\n    }\n    if (\"message\" in payload && typeof payload.message === \"string\") {\n      return payload.message;\n    }\n  }\n\n  if (typeof payload === \"string\" && payload.length > 0) {\n    return payload;\n  }\n\n  return fallback || \"Request failed\";\n}\n\nfunction resolveUploadFileName(params: ShiftUploadFileParams) {\n  if (params.fileName) {\n    return params.fileName;\n  }\n\n  if (isNamedBlob(params.file)) {\n    return params.file.name;\n  }\n\n  return \"upload.bin\";\n}\n\nfunction resolveUploadContentType(params: ShiftUploadFileParams) {\n  if (params.contentType) {\n    return params.contentType;\n  }\n\n  if (params.file instanceof Blob && params.file.type) {\n    return params.file.type;\n  }\n\n  return \"application/octet-stream\";\n}\n\nfunction normalizeUploadFile(file: ShiftUploadableFile, contentType: string) {\n  if (file instanceof Blob) {\n    return file;\n  }\n\n  if (file instanceof Uint8Array) {\n    return new Blob([toArrayBuffer(file)], { type: contentType });\n  }\n\n  return new Blob([file], { type: contentType });\n}\n\nfunction isNamedBlob(value: ShiftUploadableFile): value is Blob & { name: string } {\n  return value instanceof Blob && \"name\" in value && typeof value.name === \"string\";\n}\n\nfunction isBodyInit(value: unknown): value is BodyInit {\n  return (\n    typeof value === \"string\" ||\n    value instanceof Blob ||\n    value instanceof FormData ||\n    value instanceof URLSearchParams ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value)\n  );\n}\n\nfunction toArrayBuffer(value: Uint8Array) {\n  const copy = new Uint8Array(value.byteLength);\n  copy.set(value);\n  return copy.buffer;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/request-client.ts","../src/shift.ts","../src/agents.ts","../src/rag.ts","../src/index.ts"],"sourcesContent":["export interface RagableClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n}\n\nexport type RequestOptions = Omit<RequestInit, \"body\"> & {\n  body?: unknown;\n};\n\nexport class RagableError extends Error {\n  readonly status: number;\n  readonly body: unknown;\n\n  constructor(message: string, status: number, body: unknown) {\n    super(message);\n    this.name = \"RagableError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n\nexport function extractErrorMessage(payload: unknown, fallback: string) {\n  if (payload && typeof payload === \"object\") {\n    if (\"error\" in payload && typeof payload.error === \"string\") {\n      return payload.error;\n    }\n    if (\"message\" in payload && typeof payload.message === \"string\") {\n      return payload.message;\n    }\n  }\n\n  if (typeof payload === \"string\" && payload.length > 0) {\n    return payload;\n  }\n\n  return fallback || \"Request failed\";\n}\n\nexport class RagableRequestClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n  private readonly defaultHeaders: HeadersInit | undefined;\n\n  constructor(options: RagableClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl ?? \"http://localhost:8080/api\";\n    this.fetchImpl = options.fetch ?? fetch;\n    this.defaultHeaders = options.headers;\n  }\n\n  toUrl(path: string) {\n    const normalizedBase = this.baseUrl.replace(/\\/+$/, \"\");\n    const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n    return `${normalizedBase}${normalizedPath}`;\n  }\n\n  async request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n    const response = await this.rawFetch(path, options);\n    const payload = await this.parseResponseBody(response);\n    if (!response.ok) {\n      const message = extractErrorMessage(payload, response.statusText);\n      throw new RagableError(message, response.status, payload);\n    }\n\n    return payload as T;\n  }\n\n  /**\n   * Low-level fetch with API key and JSON body encoding. Caller handles status and body.\n   */\n  async rawFetch(path: string, options: RequestOptions = {}): Promise<Response> {\n    const headers = new Headers(this.defaultHeaders);\n    headers.set(\"Authorization\", `Bearer ${this.apiKey}`);\n\n    let body = options.body;\n    if (body !== undefined && !isBodyInit(body)) {\n      headers.set(\"Content-Type\", \"application/json\");\n      body = JSON.stringify(body);\n    }\n\n    return this.fetchImpl(this.toUrl(path), {\n      ...options,\n      headers,\n      body: body as BodyInit | undefined,\n    });\n  }\n\n  private async parseResponseBody(response: Response): Promise<unknown> {\n    if (response.status === 204) {\n      return null;\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"application/json\")) {\n      return response.json();\n    }\n\n    return response.text();\n  }\n}\n\nexport function isBodyInit(value: unknown): value is BodyInit {\n  return (\n    typeof value === \"string\" ||\n    value instanceof Blob ||\n    value instanceof FormData ||\n    value instanceof URLSearchParams ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value)\n  );\n}\n","import { RagableRequestClient } from \"./request-client\";\n\nexport interface ShiftIndex {\n  id: string;\n  name: string;\n  description: string | null;\n  dimensions: number;\n  embeddingModel: string;\n  status: string;\n  entryCount?: number;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ShiftEntry {\n  id: string;\n  content: string;\n  metadata: unknown;\n  chunkIndex: number;\n  createdAt: string;\n}\n\nexport interface ShiftSearchResult {\n  content: string;\n  score: number;\n  metadata: unknown;\n}\n\nexport interface ShiftCreateIndexParams {\n  name: string;\n  description?: string;\n  dimensions?: number;\n  embeddingModel?: string;\n}\n\nexport interface ShiftUpdateIndexParams {\n  name?: string;\n  description?: string;\n}\n\nexport interface ShiftAddDocumentParams {\n  content: string;\n  metadata?: Record<string, unknown>;\n  chunkSize?: number;\n  chunkOverlap?: number;\n}\n\nexport type ShiftUploadableFile = Blob | ArrayBuffer | Uint8Array;\n\nexport interface ShiftUploadFileParams {\n  file: ShiftUploadableFile;\n  fileName?: string;\n  contentType?: string;\n  metadata?: Record<string, unknown>;\n  chunkSize?: number;\n  chunkOverlap?: number;\n}\n\nexport interface ShiftListEntriesParams {\n  take?: number;\n  skip?: number;\n}\n\nexport interface ShiftSearchParams {\n  query: string;\n  topK?: number;\n}\n\nexport interface ShiftIngestResponse {\n  chunksCreated: number;\n  entries: string[];\n  extractedText?: string;\n  message?: string;\n}\n\nexport interface ShiftListEntriesResponse {\n  entries: ShiftEntry[];\n  total: number;\n}\n\nexport class ShiftClient {\n  readonly indexes: {\n    list: () => Promise<{ indexes: ShiftIndex[] }>;\n    create: (params: ShiftCreateIndexParams) => Promise<ShiftIndex>;\n    get: (indexId: string) => Promise<ShiftIndex>;\n    update: (indexId: string, params: ShiftUpdateIndexParams) => Promise<ShiftIndex>;\n    delete: (indexId: string) => Promise<{ success: true }>;\n  };\n\n  readonly documents: {\n    create: (\n      indexId: string,\n      params: ShiftAddDocumentParams,\n    ) => Promise<ShiftIngestResponse>;\n    upload: (\n      indexId: string,\n      params: ShiftUploadFileParams,\n    ) => Promise<ShiftIngestResponse>;\n  };\n\n  readonly entries: {\n    list: (\n      indexId: string,\n      params?: ShiftListEntriesParams,\n    ) => Promise<ShiftListEntriesResponse>;\n    delete: (indexId: string, entryId: string) => Promise<{ success: true }>;\n  };\n\n  constructor(private readonly client: RagableRequestClient) {\n    this.indexes = {\n      list: async () => {\n        return this.client.request<{ indexes: ShiftIndex[] }>(\"/v1/shift/indexes\");\n      },\n      create: async (params) => {\n        return this.client.request<ShiftIndex>(\"/v1/shift/indexes\", {\n          method: \"POST\",\n          body: params,\n        });\n      },\n      get: async (indexId) => {\n        return this.client.request<ShiftIndex>(`/v1/shift/indexes/${indexId}`);\n      },\n      update: async (indexId, params) => {\n        return this.client.request<ShiftIndex>(`/v1/shift/indexes/${indexId}`, {\n          method: \"PUT\",\n          body: params,\n        });\n      },\n      delete: async (indexId) => {\n        return this.client.request<{ success: true }>(\n          `/v1/shift/indexes/${indexId}`,\n          {\n            method: \"DELETE\",\n          },\n        );\n      },\n    };\n\n    this.documents = {\n      create: async (indexId, params) => {\n        return this.client.request<ShiftIngestResponse>(\n          `/v1/shift/indexes/${indexId}/documents`,\n          {\n            method: \"POST\",\n            body: params,\n          },\n        );\n      },\n      upload: async (indexId, params) => {\n        const formData = new FormData();\n        const fileName = resolveUploadFileName(params);\n        const contentType = resolveUploadContentType(params);\n        const file = normalizeUploadFile(params.file, contentType);\n\n        formData.set(\"file\", file, fileName);\n\n        if (params.metadata) {\n          formData.set(\"metadata\", JSON.stringify(params.metadata));\n        }\n        if (typeof params.chunkSize === \"number\") {\n          formData.set(\"chunkSize\", String(params.chunkSize));\n        }\n        if (typeof params.chunkOverlap === \"number\") {\n          formData.set(\"chunkOverlap\", String(params.chunkOverlap));\n        }\n\n        return this.client.request<ShiftIngestResponse>(\n          `/v1/shift/indexes/${indexId}/files`,\n          {\n            method: \"POST\",\n            body: formData,\n          },\n        );\n      },\n    };\n\n    this.entries = {\n      list: async (indexId, params = {}) => {\n        const search = new URLSearchParams();\n        if (typeof params.take === \"number\") {\n          search.set(\"take\", String(params.take));\n        }\n        if (typeof params.skip === \"number\") {\n          search.set(\"skip\", String(params.skip));\n        }\n\n        const suffix = search.size > 0 ? `?${search.toString()}` : \"\";\n        return this.client.request<ShiftListEntriesResponse>(\n          `/v1/shift/indexes/${indexId}/entries${suffix}`,\n        );\n      },\n      delete: async (indexId, entryId) => {\n        return this.client.request<{ success: true }>(\n          `/v1/shift/indexes/${indexId}/entries/${entryId}`,\n          {\n            method: \"DELETE\",\n          },\n        );\n      },\n    };\n  }\n\n  async search(indexId: string, params: ShiftSearchParams) {\n    return this.client.request<{ results: ShiftSearchResult[] }>(\n      `/v1/shift/indexes/${indexId}/search`,\n      {\n        method: \"POST\",\n        body: params,\n      },\n    );\n  }\n}\n\nfunction resolveUploadFileName(params: ShiftUploadFileParams) {\n  if (params.fileName) {\n    return params.fileName;\n  }\n\n  if (isNamedBlob(params.file)) {\n    return params.file.name;\n  }\n\n  return \"upload.bin\";\n}\n\nfunction resolveUploadContentType(params: ShiftUploadFileParams) {\n  if (params.contentType) {\n    return params.contentType;\n  }\n\n  if (params.file instanceof Blob && params.file.type) {\n    return params.file.type;\n  }\n\n  return \"application/octet-stream\";\n}\n\nfunction normalizeUploadFile(file: ShiftUploadableFile, contentType: string) {\n  if (file instanceof Blob) {\n    return file;\n  }\n\n  if (file instanceof Uint8Array) {\n    return new Blob([toArrayBuffer(file)], { type: contentType });\n  }\n\n  return new Blob([file], { type: contentType });\n}\n\nfunction isNamedBlob(value: ShiftUploadableFile): value is Blob & { name: string } {\n  return value instanceof Blob && \"name\" in value && typeof value.name === \"string\";\n}\n\nfunction toArrayBuffer(value: Uint8Array) {\n  const copy = new Uint8Array(value.byteLength);\n  copy.set(value);\n  return copy.buffer;\n}\n","import {\n  extractErrorMessage,\n  RagableError,\n  RagableRequestClient,\n} from \"./request-client\";\n\nexport interface AgentSummary {\n  id: string;\n  name: string;\n  description: string | null;\n  active: boolean;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface AgentChatMessage {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface AgentChatParams {\n  message: string;\n  history?: AgentChatMessage[];\n}\n\n/** Mirrors backend ExecutionResult JSON shape (traces are opaque in the SDK). */\nexport interface AgentChatResult {\n  response: string;\n  traces: unknown[];\n  totalDurationMs: number;\n  httpResponse?: unknown;\n}\n\n/**\n * Loose SSE event from POST /v1/agents/:id/chat/stream — narrows with `type` at runtime.\n */\nexport type AgentStreamEvent = Record<string, unknown> & { type: string };\n\nexport class AgentsClient {\n  constructor(private readonly client: RagableRequestClient) {}\n\n  async list(): Promise<{ agents: AgentSummary[] }> {\n    return this.client.request(\"/v1/agents\");\n  }\n\n  async get(agentId: string): Promise<AgentSummary> {\n    return this.client.request(`/v1/agents/${agentId}`);\n  }\n\n  async chat(\n    agentId: string,\n    params: AgentChatParams,\n  ): Promise<AgentChatResult> {\n    return this.client.request<AgentChatResult>(`/v1/agents/${agentId}/chat`, {\n      method: \"POST\",\n      body: {\n        message: params.message,\n        ...(params.history !== undefined ? { history: params.history } : {}),\n      },\n    });\n  }\n\n  /**\n   * Stream agent execution as SSE (`data: {json}` lines). Yields parsed JSON objects.\n   */\n  async *chatStream(\n    agentId: string,\n    params: AgentChatParams,\n  ): AsyncGenerator<AgentStreamEvent, void, undefined> {\n    const response = await this.client.rawFetch(\n      `/v1/agents/${agentId}/chat/stream`,\n      {\n        method: \"POST\",\n        body: {\n          message: params.message,\n          ...(params.history !== undefined ? { history: params.history } : {}),\n        },\n      },\n    );\n\n    if (!response.ok) {\n      const payload = await parseMaybeJsonBody(response);\n      const message = extractErrorMessage(payload, response.statusText);\n      throw new RagableError(message, response.status, payload);\n    }\n\n    const body = response.body;\n    if (!body) {\n      return;\n    }\n\n    const reader = body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) {\n          break;\n        }\n        buffer += decoder.decode(value, { stream: true });\n\n        let boundary = buffer.indexOf(\"\\n\\n\");\n        while (boundary !== -1) {\n          const block = buffer.slice(0, boundary);\n          buffer = buffer.slice(boundary + 2);\n          for (const line of block.split(\"\\n\")) {\n            const evt = parseSseDataLine(line);\n            if (evt) {\n              yield evt;\n            }\n          }\n          boundary = buffer.indexOf(\"\\n\\n\");\n        }\n      }\n\n      if (buffer.trim().length > 0) {\n        for (const line of buffer.split(\"\\n\")) {\n          const evt = parseSseDataLine(line);\n          if (evt) {\n            yield evt;\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n}\n\nasync function parseMaybeJsonBody(response: Response): Promise<unknown> {\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    try {\n      return await response.json();\n    } catch {\n      return null;\n    }\n  }\n  try {\n    return await response.text();\n  } catch {\n    return null;\n  }\n}\n\nfunction parseSseDataLine(line: string): AgentStreamEvent | null {\n  const dataPrefix = \"data: \";\n  if (!line.startsWith(dataPrefix)) {\n    return null;\n  }\n  const json = line.slice(dataPrefix.length).trim();\n  if (json.length === 0 || json === \"[DONE]\") {\n    return null;\n  }\n  try {\n    return JSON.parse(json) as AgentStreamEvent;\n  } catch {\n    return null;\n  }\n}\n","import type {\n  ShiftAddDocumentParams,\n  ShiftIngestResponse,\n  ShiftSearchParams,\n  ShiftSearchResult,\n  ShiftUploadFileParams,\n} from \"./shift\";\n\n/** Minimal client surface for {@link createRagPipeline} (implemented by {@link Ragable}). */\nexport interface RagClientForPipeline {\n  shift: {\n    documents: {\n      create: (\n        indexId: string,\n        params: ShiftAddDocumentParams,\n      ) => Promise<ShiftIngestResponse>;\n      upload: (\n        indexId: string,\n        params: ShiftUploadFileParams,\n      ) => Promise<ShiftIngestResponse>;\n    };\n    search: (\n      indexId: string,\n      params: ShiftSearchParams,\n    ) => Promise<{ results: ShiftSearchResult[] }>;\n  };\n}\n\nexport interface FormatContextOptions {\n  /** Prepended before numbered passages (default: \"Relevant passages:\\\\n\") */\n  header?: string;\n  /** Joiner between passages (default: \"\\\\n\\\\n\") */\n  separator?: string;\n  /** Omit results with similarity score below this (default: no filter) */\n  minScore?: number;\n  /** Truncate total context string to this UTF-16 length (default: no limit) */\n  maxChars?: number;\n  /** Include similarity score in each block (default: false) */\n  includeScores?: boolean;\n}\n\nexport interface RagPipelineOptions {\n  indexId: string;\n}\n\nexport type RetrieveParams = ShiftSearchParams & {\n  format?: FormatContextOptions;\n};\n\nexport interface RagPipeline {\n  readonly indexId: string;\n  ingestText(params: ShiftAddDocumentParams): Promise<ShiftIngestResponse>;\n  ingestFile(params: ShiftUploadFileParams): Promise<ShiftIngestResponse>;\n  search(params: ShiftSearchParams): Promise<{ results: ShiftSearchResult[] }>;\n  retrieve(params: RetrieveParams): Promise<{\n    results: ShiftSearchResult[];\n    context: string;\n  }>;\n}\n\n/**\n * Turn vector search hits into a single block of text for system prompts or RAG user messages.\n */\nexport function formatRetrievalContext(\n  results: ShiftSearchResult[],\n  options: FormatContextOptions = {},\n): string {\n  const header = options.header ?? \"Relevant passages:\\n\";\n  const separator = options.separator ?? \"\\n\\n\";\n  const minScore = options.minScore;\n\n  let filtered = results;\n  if (typeof minScore === \"number\") {\n    filtered = results.filter((r) => r.score >= minScore);\n  }\n\n  const blocks = filtered.map((r, i) => {\n    const scoreSuffix =\n      options.includeScores === true ? ` (score: ${r.score.toFixed(4)})` : \"\";\n    return `[${i + 1}]${scoreSuffix}\\n${r.content.trim()}`;\n  });\n\n  let text = (blocks.length > 0 ? header : \"\") + blocks.join(separator);\n\n  if (typeof options.maxChars === \"number\" && text.length > options.maxChars) {\n    text = text.slice(0, options.maxChars).trimEnd() + \"\\n…\";\n  }\n\n  return text;\n}\n\n/**\n * High-level RAG helpers bound to one Shift index: ingest, search, retrieve with prompt-ready context.\n */\nexport function createRagPipeline(\n  client: RagClientForPipeline,\n  options: RagPipelineOptions,\n): RagPipeline {\n  const { indexId } = options;\n\n  return {\n    indexId,\n\n    ingestText(params) {\n      return client.shift.documents.create(indexId, params);\n    },\n\n    ingestFile(params) {\n      return client.shift.documents.upload(indexId, params);\n    },\n\n    search(params) {\n      return client.shift.search(indexId, params);\n    },\n\n    async retrieve(params) {\n      const { format: formatOpts, ...searchParams } = params;\n      const { results } = await client.shift.search(indexId, searchParams);\n      const context = formatRetrievalContext(results, formatOpts ?? {});\n      return { results, context };\n    },\n  };\n}\n","export type { RagableClientOptions, RequestOptions } from \"./request-client\";\nexport {\n  extractErrorMessage,\n  RagableError,\n  RagableRequestClient,\n} from \"./request-client\";\n\nexport type {\n  ShiftAddDocumentParams,\n  ShiftCreateIndexParams,\n  ShiftEntry,\n  ShiftIndex,\n  ShiftIngestResponse,\n  ShiftListEntriesParams,\n  ShiftListEntriesResponse,\n  ShiftSearchParams,\n  ShiftSearchResult,\n  ShiftUpdateIndexParams,\n  ShiftUploadableFile,\n  ShiftUploadFileParams,\n} from \"./shift\";\nexport { ShiftClient } from \"./shift\";\n\nexport type {\n  AgentChatMessage,\n  AgentChatParams,\n  AgentChatResult,\n  AgentStreamEvent,\n  AgentSummary,\n} from \"./agents\";\nexport { AgentsClient } from \"./agents\";\n\nexport type {\n  FormatContextOptions,\n  RagClientForPipeline,\n  RagPipeline,\n  RagPipelineOptions,\n  RetrieveParams,\n} from \"./rag\";\nexport { createRagPipeline, formatRetrievalContext } from \"./rag\";\n\nimport { AgentsClient } from \"./agents\";\nimport {\n  RagableRequestClient,\n  type RagableClientOptions,\n} from \"./request-client\";\nimport { ShiftClient } from \"./shift\";\n\nexport class Ragable {\n  readonly shift: ShiftClient;\n  readonly agents: AgentsClient;\n  readonly infrastructure: {\n    shift: ShiftClient;\n  };\n\n  constructor(options: RagableClientOptions) {\n    const client = new RagableRequestClient(options);\n    this.shift = new ShiftClient(client);\n    this.agents = new AgentsClient(client);\n    this.infrastructure = {\n      shift: this.shift,\n    };\n  }\n}\n\nexport function createClient(options: RagableClientOptions) {\n  return new Ragable(options);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ragable/sdk",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "The official SDK for Ragable - The Operating System for AI Agents",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -22,6 +22,7 @@
     "test": "vitest run",
     "example:shift:smoke": "node ./examples/shift-smoke.mjs",
     "example:shift:file": "node ./examples/shift-file-upload.mjs",
+    "example:rag": "node ./examples/rag-pipeline.mjs",
     "prepublishOnly": "npm run build"
   },
   "keywords": [