@compresr/sdk 1.0.0

package/dist/esm/schemas/search.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Agentic Search schemas
+ *
+ * Schemas for agentic search endpoints (macchiato_v1).
+ */
+import { z } from 'zod';
+/**
+ * Search request schema
+ */
+export declare const SearchRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    index_name: z.ZodString;
+    compression_model_name: z.ZodString;
+    max_time_s: z.ZodDefault<z.ZodNumber>;
+    source: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    compression_model_name: string;
+    query: string;
+    source: string;
+    index_name: string;
+    max_time_s: number;
+}, {
+    compression_model_name: string;
+    query: string;
+    index_name: string;
+    source?: string | undefined;
+    max_time_s?: number | undefined;
+}>;
+export type SearchRequest = z.infer<typeof SearchRequestSchema>;
+/**
+ * Index creation payload
+ */
+export declare const IndexCreatePayloadSchema: z.ZodObject<{
+    chunks: z.ZodArray<z.ZodString, "many">;
+    candidate_questions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    source_docs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    chunks: string[];
+    candidate_questions?: string[] | undefined;
+    source_docs?: Record<string, unknown> | undefined;
+}, {
+    chunks: string[];
+    candidate_questions?: string[] | undefined;
+    source_docs?: Record<string, unknown> | undefined;
+}>;
+export type IndexCreatePayload = z.infer<typeof IndexCreatePayloadSchema>;
+/**
+ * Search result
+ */
+export declare const SearchResultSchema: z.ZodObject<{
+    chunks: z.ZodArray<z.ZodString, "many">;
+    chunk_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    chunks_count: z.ZodNumber;
+    original_tokens: z.ZodNumber;
+    compressed_tokens: z.ZodNumber;
+    compression_ratio: z.ZodNumber;
+    duration_ms: z.ZodDefault<z.ZodNumber>;
+    index_name: z.ZodString;
+    cost: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    original_tokens: number;
+    compressed_tokens: number;
+    duration_ms: number;
+    index_name: string;
+    chunks: string[];
+    chunk_ids: string[];
+    chunks_count: number;
+    compression_ratio: number;
+    cost?: Record<string, unknown> | undefined;
+}, {
+    original_tokens: number;
+    compressed_tokens: number;
+    index_name: string;
+    chunks: string[];
+    chunks_count: number;
+    compression_ratio: number;
+    duration_ms?: number | undefined;
+    chunk_ids?: string[] | undefined;
+    cost?: Record<string, unknown> | undefined;
+}>;
+export type SearchResult = z.infer<typeof SearchResultSchema>;
+/**
+ * Index task status
+ */
+export declare const IndexTaskStatusSchema: z.ZodObject<{
+    status: z.ZodEnum<["pending", "processing", "completed", "failed"]>;
+    task_id: z.ZodString;
+    index_name: z.ZodOptional<z.ZodString>;
+    num_chunks: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "processing" | "completed" | "failed";
+    task_id: string;
+    error?: string | undefined;
+    index_name?: string | undefined;
+    num_chunks?: number | undefined;
+}, {
+    status: "pending" | "processing" | "completed" | "failed";
+    task_id: string;
+    error?: string | undefined;
+    index_name?: string | undefined;
+    num_chunks?: number | undefined;
+}>;
+export type IndexTaskStatus = z.infer<typeof IndexTaskStatusSchema>;
+/**
+ * Search response
+ */
+export declare const SearchResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+} & {
+    data: z.ZodNullable<z.ZodObject<{
+        chunks: z.ZodArray<z.ZodString, "many">;
+        chunk_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        chunks_count: z.ZodNumber;
+        original_tokens: z.ZodNumber;
+        compressed_tokens: z.ZodNumber;
+        compression_ratio: z.ZodNumber;
+        duration_ms: z.ZodDefault<z.ZodNumber>;
+        index_name: z.ZodString;
+        cost: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        original_tokens: number;
+        compressed_tokens: number;
+        duration_ms: number;
+        index_name: string;
+        chunks: string[];
+        chunk_ids: string[];
+        chunks_count: number;
+        compression_ratio: number;
+        cost?: Record<string, unknown> | undefined;
+    }, {
+        original_tokens: number;
+        compressed_tokens: number;
+        index_name: string;
+        chunks: string[];
+        chunks_count: number;
+        compression_ratio: number;
+        duration_ms?: number | undefined;
+        chunk_ids?: string[] | undefined;
+        cost?: Record<string, unknown> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    data: {
+        original_tokens: number;
+        compressed_tokens: number;
+        duration_ms: number;
+        index_name: string;
+        chunks: string[];
+        chunk_ids: string[];
+        chunks_count: number;
+        compression_ratio: number;
+        cost?: Record<string, unknown> | undefined;
+    } | null;
+}, {
+    success: boolean;
+    data: {
+        original_tokens: number;
+        compressed_tokens: number;
+        index_name: string;
+        chunks: string[];
+        chunks_count: number;
+        compression_ratio: number;
+        duration_ms?: number | undefined;
+        chunk_ids?: string[] | undefined;
+        cost?: Record<string, unknown> | undefined;
+    } | null;
+}>;
+export type SearchResponse = z.infer<typeof SearchResponseSchema>;
+/**
+ * Index creation response
+ */
+export declare const IndexCreateResponseSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    status: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    task_id: string;
+}, {
+    status: string;
+    task_id: string;
+}>;
+export type IndexCreateResponse = z.infer<typeof IndexCreateResponseSchema>;
+//# sourceMappingURL=search.d.ts.map

package/dist/esm/schemas/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/schemas/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1E;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/esm/schemas/search.js

@@ -0,0 +1,72 @@
+/**
+ * Agentic Search schemas
+ *
+ * Schemas for agentic search endpoints (macchiato_v1).
+ */
+import { z } from 'zod';
+import { BaseResponseSchema } from './common.js';
+// =============================================================================
+// Request Schemas
+// =============================================================================
+/**
+ * Search request schema
+ */
+export const SearchRequestSchema = z.object({
+    query: z.string().min(1, 'query must not be empty'),
+    index_name: z.string().min(1, 'index_name must not be empty'),
+    compression_model_name: z.string(),
+    max_time_s: z.number().min(0.1).max(30).default(4.5),
+    source: z.string().default('sdk:typescript'),
+});
+/**
+ * Index creation payload
+ */
+export const IndexCreatePayloadSchema = z.object({
+    chunks: z.array(z.string()),
+    candidate_questions: z.array(z.string()).optional(),
+    source_docs: z.record(z.string(), z.unknown()).optional(),
+});
+// =============================================================================
+// Result Schemas
+// =============================================================================
+/**
+ * Search result
+ */
+export const SearchResultSchema = z.object({
+    chunks: z.array(z.string()),
+    chunk_ids: z.array(z.string()).default([]),
+    chunks_count: z.number(),
+    original_tokens: z.number(),
+    compressed_tokens: z.number(),
+    compression_ratio: z.number(),
+    duration_ms: z.number().default(0),
+    index_name: z.string(),
+    cost: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Index task status
+ */
+export const IndexTaskStatusSchema = z.object({
+    status: z.enum(['pending', 'processing', 'completed', 'failed']),
+    task_id: z.string(),
+    index_name: z.string().optional(),
+    num_chunks: z.number().optional(),
+    error: z.string().optional(),
+});
+// =============================================================================
+// Response Schemas
+// =============================================================================
+/**
+ * Search response
+ */
+export const SearchResponseSchema = BaseResponseSchema.extend({
+    data: SearchResultSchema.nullable(),
+});
+/**
+ * Index creation response
+ */
+export const IndexCreateResponseSchema = z.object({
+    task_id: z.string(),
+    status: z.string(),
+});
+//# sourceMappingURL=search.js.map

package/dist/esm/schemas/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/schemas/search.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@compresr/sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for Compresr - Intelligent context compression to reduce LLM API costs by 30-70%",
+  "author": "Compresr Team <founders@compresr.ai>",
+  "license": "Apache-2.0",
+  "homepage": "https://compresr.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/compresr/sdk.git",
+    "directory": "typescript"
+  },
+  "bugs": {
+    "url": "https://github.com/compresr/sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "llm",
+    "compression",
+    "ai",
+    "openai",
+    "gpt",
+    "tokens",
+    "cost-optimization",
+    "context-compression",
+    "rag",
+    "anthropic",
+    "claude"
+  ],
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:cjs:fixup",
+    "build:esm": "tsc -p tsconfig.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:cjs:fixup": "echo '{\"type\": \"commonjs\"}' > dist/cjs/package.json",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "lint": "eslint src tests --ext .ts",
+    "lint:fix": "eslint src tests --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run clean && npm run build && npm run test"
+  },
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "@vitest/coverage-v8": "^1.4.0",
+    "dotenv": "^16.4.0",
+    "eslint": "^8.57.0",
+    "msw": "^2.2.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.4.0"
+  }
+}