vectra 0.12.3 → 0.14.0

package/lib/storage/VirtualFileStorage.spec.js

@@ -0,0 +1,302 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const path = __importStar(require("path"));
+const VirtualFileStorage_1 = require("./VirtualFileStorage");
+const FileStorageUtilities_1 = require("./FileStorageUtilities");
+describe('VirtualFileStorage', () => {
+    let storage;
+    beforeEach(() => {
+        storage = new VirtualFileStorage_1.VirtualFileStorage();
+    });
+    describe('createFile', () => {
+        it('creates a new file with string content', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'hello');
+            const details = yield storage.getDetails('file.txt');
+            node_assert_1.default.strictEqual(details.name, 'file.txt');
+            node_assert_1.default.strictEqual(details.path, path.normalize('file.txt'));
+            node_assert_1.default.strictEqual(details.isFolder, false);
+            node_assert_1.default.strictEqual(details.fileType, FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('file.txt')));
+            const content = yield storage.readFile('file.txt');
+            node_assert_1.default.deepStrictEqual(content, Buffer.from('hello', 'utf8'));
+        }));
+        it('creates a new file with Buffer content', () => __awaiter(void 0, void 0, void 0, function* () {
+            const buf = Buffer.from('buffer content');
+            yield storage.createFile('bufferfile.bin', buf);
+            const content = yield storage.readFile('bufferfile.bin');
+            node_assert_1.default.deepStrictEqual(content, buf);
+        }));
+        it('throws when file already exists (including folder at path)', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('dup.txt', 'content');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFile('dup.txt', 'new content');
+            }), /File already exists/);
+            yield storage.createFolder('folder');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFile('folder', 'content');
+            }), /File already exists/);
+        }));
+        it('throws when creating file with normalized duplicate path', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('a/../b/file.txt', 'content');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFile('b/file.txt', 'content');
+            }), /File already exists/);
+        }));
+    });
+    describe('createFolder', () => {
+        it('creates a new folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('myfolder');
+            const details = yield storage.getDetails('myfolder');
+            node_assert_1.default.strictEqual(details.name, 'myfolder');
+            node_assert_1.default.strictEqual(details.isFolder, true);
+            node_assert_1.default.strictEqual(details.fileType, undefined);
+        }));
+        it('is idempotent when folder already exists', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('myfolder');
+            yield storage.createFolder('myfolder'); // no error
+        }));
+        it('throws when a file exists at that path', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.createFolder('file.txt');
+            }), /Cannot create folder/);
+        }));
+        it('does not create parent folders automatically', () => __awaiter(void 0, void 0, void 0, function* () {
+            // Implementation creates only the explicit folder entry
+            yield storage.createFolder('parent/child');
+            // Only 'parent/child' exists, not 'parent'
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.getDetails('parent');
+            }), /Path not found/);
+            const details = yield storage.getDetails('parent/child');
+            node_assert_1.default.strictEqual(details.isFolder, true);
+        }));
+    });
+    describe('deleteFile', () => {
+        it('deletes an existing file', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            yield storage.deleteFile('file.txt');
+            const exists = yield storage.pathExists('file.txt');
+            node_assert_1.default.strictEqual(exists, false);
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.readFile('file.txt');
+            }), /File not found/);
+        }));
+        it('throws when deleting a folder as file', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.deleteFile('folder');
+            }), /Cannot delete file/);
+        }));
+        it('no error when deleting non-existent file', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.deleteFile('nonexistent');
+        }));
+    });
+    describe('deleteFolder', () => {
+        it('deletes an existing folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            yield storage.deleteFolder('folder');
+            const exists = yield storage.pathExists('folder');
+            node_assert_1.default.strictEqual(exists, false);
+        }));
+        it('throws when deleting a file as folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.deleteFolder('file.txt');
+            }), /Cannot delete folder/);
+        }));
+        it('no error when deleting non-existent folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.deleteFolder('nonexistent');
+        }));
+        it('does not delete children when deleting folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('parent');
+            yield storage.createFile('parent/child.txt', 'content');
+            yield storage.deleteFolder('parent');
+            // Parent deleted
+            const parentExists = yield storage.pathExists('parent');
+            node_assert_1.default.strictEqual(parentExists, false);
+            // Child still exists
+            const childExists = yield storage.pathExists('parent/child.txt');
+            node_assert_1.default.strictEqual(childExists, true);
+        }));
+    });
+    describe('getDetails', () => {
+        it('returns details for existing file', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            const details = yield storage.getDetails('file.txt');
+            node_assert_1.default.strictEqual(details.name, 'file.txt');
+            node_assert_1.default.strictEqual(details.path, path.normalize('file.txt'));
+            node_assert_1.default.strictEqual(details.isFolder, false);
+            node_assert_1.default.strictEqual(details.fileType, FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('file.txt')));
+        }));
+        it('returns details for existing folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            const details = yield storage.getDetails('folder');
+            node_assert_1.default.strictEqual(details.name, 'folder');
+            node_assert_1.default.strictEqual(details.path, path.normalize('folder'));
+            node_assert_1.default.strictEqual(details.isFolder, true);
+            node_assert_1.default.strictEqual(details.fileType, undefined);
+        }));
+        it('throws for non-existent path', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.getDetails('missing');
+            }), /Path not found/);
+        }));
+    });
+    describe('listFiles', () => {
+        beforeEach(() => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('a');
+            yield storage.createFolder('a/b');
+            yield storage.createFile('a/file1.txt', 'content1');
+            yield storage.createFile('a/b/file2.txt', 'content2');
+            yield storage.createFolder('c');
+            yield storage.createFile('fileRoot.txt', 'root');
+        }));
+        it('returns immediate children only', () => __awaiter(void 0, void 0, void 0, function* () {
+            const listA = yield storage.listFiles('a');
+            (0, node_assert_1.default)(listA.some(e => e.name === 'file1.txt'));
+            (0, node_assert_1.default)(listA.some(e => e.name === 'b'));
+            (0, node_assert_1.default)(!listA.some(e => e.name === 'file2.txt'));
+            const listRoot = yield storage.listFiles('');
+            (0, node_assert_1.default)(listRoot.some(e => e.name === 'a'));
+            (0, node_assert_1.default)(listRoot.some(e => e.name === 'c'));
+            (0, node_assert_1.default)(listRoot.some(e => e.name === 'fileRoot.txt'));
+        }));
+        it('respects filter "all"', () => __awaiter(void 0, void 0, void 0, function* () {
+            const all = yield storage.listFiles('a', 'all');
+            (0, node_assert_1.default)(all.some(e => e.isFolder));
+            (0, node_assert_1.default)(all.some(e => !e.isFolder));
+        }));
+        it('respects filter "files"', () => __awaiter(void 0, void 0, void 0, function* () {
+            const files = yield storage.listFiles('a', 'files');
+            (0, node_assert_1.default)(files.every(e => !e.isFolder));
+            (0, node_assert_1.default)(files.some(e => e.name === 'file1.txt'));
+            (0, node_assert_1.default)(!files.some(e => e.name === 'b'));
+        }));
+        it('respects filter "folders"', () => __awaiter(void 0, void 0, void 0, function* () {
+            const folders = yield storage.listFiles('a', 'folders');
+            (0, node_assert_1.default)(folders.every(e => e.isFolder));
+            (0, node_assert_1.default)(folders.some(e => e.name === 'b'));
+            (0, node_assert_1.default)(!folders.some(e => e.name === 'file1.txt'));
+        }));
+        it('normalizes folderPath', () => __awaiter(void 0, void 0, void 0, function* () {
+            const list1 = yield storage.listFiles('a/');
+            const list2 = yield storage.listFiles('a');
+            node_assert_1.default.deepStrictEqual(list1, list2);
+        }));
+    });
+    describe('pathExists', () => {
+        it('returns true for existing file and folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'content');
+            yield storage.createFolder('folder');
+            node_assert_1.default.strictEqual(yield storage.pathExists('file.txt'), true);
+            node_assert_1.default.strictEqual(yield storage.pathExists('folder'), true);
+        }));
+        it('returns false for missing path', () => __awaiter(void 0, void 0, void 0, function* () {
+            node_assert_1.default.strictEqual(yield storage.pathExists('missing'), false);
+        }));
+    });
+    describe('readFile', () => {
+        it('returns exact Buffer written', () => __awaiter(void 0, void 0, void 0, function* () {
+            const buf = Buffer.from('data');
+            yield storage.createFile('file.txt', buf);
+            const read = yield storage.readFile('file.txt');
+            node_assert_1.default.deepStrictEqual(read, buf);
+        }));
+        it('throws when path does not exist', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.readFile('missing.txt');
+            }), /File not found/);
+        }));
+        it('throws when path is a folder', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.readFile('folder');
+            }), /Cannot read file/);
+        }));
+        it('returns empty buffer if content is undefined (forced)', () => __awaiter(void 0, void 0, void 0, function* () {
+            // Force an entry with undefined content to hit the fallback branch
+            storage._entries.set('emptyfile.txt', {
+                details: {
+                    name: 'emptyfile.txt',
+                    path: path.normalize('emptyfile.txt'),
+                    isFolder: false,
+                    fileType: FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('emptyfile.txt')),
+                },
+                content: undefined,
+            });
+            const content = yield storage.readFile('emptyfile.txt');
+            node_assert_1.default.deepStrictEqual(content, Buffer.from('', 'utf8'));
+        }));
+    });
+    describe('upsertFile', () => {
+        it('creates new file when missing with string content', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.upsertFile('newfile.txt', 'content');
+            const details = yield storage.getDetails('newfile.txt');
+            node_assert_1.default.strictEqual(details.isFolder, false);
+            node_assert_1.default.strictEqual(details.fileType, FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('newfile.txt')));
+            const content = yield storage.readFile('newfile.txt');
+            node_assert_1.default.deepStrictEqual(content, Buffer.from('content', 'utf8'));
+        }));
+        it('replaces content of existing file and keeps correct fileType', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFile('file.txt', 'old');
+            yield storage.upsertFile('file.txt', Buffer.from('new'));
+            const content = yield storage.readFile('file.txt');
+            node_assert_1.default.deepStrictEqual(content, Buffer.from('new'));
+            const details = yield storage.getDetails('file.txt');
+            node_assert_1.default.strictEqual(details.fileType, FileStorageUtilities_1.FileStorageUtilities.getFileType(path.normalize('file.txt')));
+        }));
+        it('throws when a folder exists at that path', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield storage.createFolder('folder');
+            yield node_assert_1.default.rejects(() => __awaiter(void 0, void 0, void 0, function* () {
+                yield storage.upsertFile('folder', 'content');
+            }), /Cannot write file/);
+        }));
+    });
+});
+//# sourceMappingURL=VirtualFileStorage.spec.js.map

package/lib/storage/VirtualFileStorage.spec.js.map

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

package/lib/storage/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./FileStorage";
+export * from "./FileStorageUtilities";
+export * from "./FileType";
+export * from "./LocalFileStorage";
+export * from "./VirtualFileStorage";
+//# sourceMappingURL=index.d.ts.map

package/lib/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/lib/storage/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./FileStorage"), exports);
+__exportStar(require("./FileStorageUtilities"), exports);
+__exportStar(require("./FileType"), exports);
+__exportStar(require("./LocalFileStorage"), exports);
+__exportStar(require("./VirtualFileStorage"), exports);
+//# sourceMappingURL=index.js.map

package/lib/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,yDAAuC;AACvC,6CAA2B;AAC3B,qDAAmC;AACnC,uDAAqC"}

package/lib/templates/templates/csharp/README.md

@@ -0,0 +1,48 @@
+# Vectra C# Client
+
+Thin idiomatic C# wrapper over the Vectra gRPC service.
+
+## Prerequisites
+
+Add these NuGet packages to your project:
+
+```bash
+dotnet add package Grpc.Net.Client
+dotnet add package Google.Protobuf
+dotnet add package Grpc.Tools
+```
+
+## Generate gRPC stubs
+
+Add to your `.csproj`:
+
+```xml
+<ItemGroup>
+  <Protobuf Include="vectra_service.proto" GrpcServices="Client" />
+</ItemGroup>
+```
+
+The stubs are generated automatically at build time by `Grpc.Tools`.
+
+## Usage
+
+```csharp
+using Vectra.Client;
+
+using var client = new VectraClient();
+
+// Create a document index
+await client.CreateIndexAsync("my-index", isDocumentIndex: true);
+
+// Add a document
+await client.UpsertDocumentAsync("my-index", "doc1.txt", "Hello world...");
+
+// Query
+var results = await client.QueryDocumentsAsync("my-index", "hello");
+foreach (var doc in results)
+{
+    Console.WriteLine($"{doc.Uri} (score: {doc.Score:F3})");
+    foreach (var chunk in doc.Chunks)
+        Console.WriteLine($"  {chunk.Text[..Math.Min(80, chunk.Text.Length)]}...");
+}
+```

package/lib/templates/templates/csharp/VectraClient.cs

@@ -0,0 +1,234 @@
+// Vectra gRPC client — thin idiomatic wrapper over generated stubs.
+//
+// Usage:
+//   using var client = new VectraClient();
+//   var results = await client.QueryDocumentsAsync("my-index", "search query");
+//
+// Generate stubs first (see README.md).
+
+using System.Text.Json;
+using Grpc.Net.Client;
+using Vectra;
+
+namespace Vectra.Client;
+
+/// <summary>Idiomatic C# client for the Vectra gRPC server.</summary>
+public sealed class VectraClient : IDisposable
+{
+    private readonly GrpcChannel _channel;
+    private readonly VectraService.VectraServiceClient _stub;
+
+    public VectraClient(string host = "127.0.0.1", int port = 50051)
+    {
+        _channel = GrpcChannel.ForAddress($"http://{host}:{port}");
+        _stub = new VectraService.VectraServiceClient(_channel);
+    }
+
+    public void Dispose() => _channel.Dispose();
+
+    // ── Index Management ──────────────────────────────────
+
+    public async Task CreateIndexAsync(
+        string name,
+        string format = "json",
+        bool isDocumentIndex = false,
+        uint chunkSize = 512,
+        uint chunkOverlap = 0)
+    {
+        var req = new CreateIndexRequest
+        {
+            IndexName = name,
+            Format = format,
+            IsDocumentIndex = isDocumentIndex,
+        };
+        if (isDocumentIndex)
+        {
+            req.DocumentConfig = new DocumentIndexConfig
+            {
+                Version = 1,
+                ChunkSize = chunkSize,
+                ChunkOverlap = chunkOverlap,
+            };
+        }
+        await _stub.CreateIndexAsync(req);
+    }
+
+    public async Task DeleteIndexAsync(string name)
+        => await _stub.DeleteIndexAsync(new DeleteIndexRequest { IndexName = name });
+
+    public async Task<List<IndexInfo>> ListIndexesAsync()
+    {
+        var resp = await _stub.ListIndexesAsync(new ListIndexesRequest());
+        return resp.Indexes.ToList();
+    }
+
+    // ── Item Operations ───────────────────────────────────
+
+    public async Task<string> InsertItemAsync(
+        string index,
+        string text = "",
+        IEnumerable<float>? vector = null,
+        Dictionary<string, object>? metadata = null,
+        string id = "")
+    {
+        var req = new InsertItemRequest
+        {
+            IndexName = index,
+            Text = text,
+            Id = id,
+        };
+        if (vector != null) req.Vector.AddRange(vector);
+        if (metadata != null) SetMetadata(req.Metadata, metadata);
+        var resp = await _stub.InsertItemAsync(req);
+        return resp.Id;
+    }
+
+    public async Task<string> UpsertItemAsync(
+        string index,
+        string id,
+        string text = "",
+        IEnumerable<float>? vector = null,
+        Dictionary<string, object>? metadata = null)
+    {
+        var req = new UpsertItemRequest
+        {
+            IndexName = index,
+            Id = id,
+            Text = text,
+        };
+        if (vector != null) req.Vector.AddRange(vector);
+        if (metadata != null) SetMetadata(req.Metadata, metadata);
+        var resp = await _stub.UpsertItemAsync(req);
+        return resp.Id;
+    }
+
+    public async Task<ItemResult?> GetItemAsync(string index, string id)
+    {
+        var resp = await _stub.GetItemAsync(new GetItemRequest { IndexName = index, Id = id });
+        return resp.Item;
+    }
+
+    public async Task DeleteItemAsync(string index, string id)
+        => await _stub.DeleteItemAsync(new DeleteItemRequest { IndexName = index, Id = id });
+
+    public async Task<List<ItemResult>> ListItemsAsync(
+        string index,
+        Dictionary<string, object>? filter = null)
+    {
+        var req = new ListItemsRequest { IndexName = index };
+        if (filter != null)
+            req.Filter = new MetadataFilter { FilterJson = JsonSerializer.Serialize(filter) };
+        var resp = await _stub.ListItemsAsync(req);
+        return resp.Items.ToList();
+    }
+
+    // ── Query ─────────────────────────────────────────────
+
+    public async Task<List<ItemResult>> QueryItemsAsync(
+        string index,
+        string text = "",
+        IEnumerable<float>? vector = null,
+        uint topK = 10,
+        Dictionary<string, object>? filter = null)
+    {
+        var req = new QueryItemsRequest
+        {
+            IndexName = index,
+            Text = text,
+            TopK = topK,
+        };
+        if (vector != null) req.Vector.AddRange(vector);
+        if (filter != null)
+            req.Filter = new MetadataFilter { FilterJson = JsonSerializer.Serialize(filter) };
+        var resp = await _stub.QueryItemsAsync(req);
+        return resp.Results.ToList();
+    }
+
+    public async Task<List<DocumentResult>> QueryDocumentsAsync(
+        string index,
+        string query,
+        uint maxDocuments = 10,
+        uint maxChunks = 50,
+        Dictionary<string, object>? filter = null,
+        bool useBm25 = false)
+    {
+        var req = new QueryDocumentsRequest
+        {
+            IndexName = index,
+            Query = query,
+            MaxDocuments = maxDocuments,
+            MaxChunks = maxChunks,
+            UseBm25 = useBm25,
+        };
+        if (filter != null)
+            req.Filter = new MetadataFilter { FilterJson = JsonSerializer.Serialize(filter) };
+        var resp = await _stub.QueryDocumentsAsync(req);
+        return resp.Results.ToList();
+    }
+
+    // ── Document Operations ───────────────────────────────
+
+    public async Task<string> UpsertDocumentAsync(
+        string index,
+        string uri,
+        string text,
+        string docType = "",
+        Dictionary<string, object>? metadata = null)
+    {
+        var req = new UpsertDocumentRequest
+        {
+            IndexName = index,
+            Uri = uri,
+            Text = text,
+            DocType = docType,
+        };
+        if (metadata != null) SetMetadata(req.Metadata, metadata);
+        var resp = await _stub.UpsertDocumentAsync(req);
+        return resp.DocumentId;
+    }
+
+    public async Task DeleteDocumentAsync(string index, string uri)
+        => await _stub.DeleteDocumentAsync(new DeleteDocumentRequest { IndexName = index, Uri = uri });
+
+    public async Task<List<DocumentInfo>> ListDocumentsAsync(string index)
+    {
+        var resp = await _stub.ListDocumentsAsync(new ListDocumentsRequest { IndexName = index });
+        return resp.Documents.ToList();
+    }
+
+    // ── Stats ─────────────────────────────────────────────
+
+    public async Task<GetIndexStatsResponse> GetIndexStatsAsync(string index)
+        => await _stub.GetIndexStatsAsync(new GetIndexStatsRequest { IndexName = index });
+
+    public async Task<GetCatalogStatsResponse> GetCatalogStatsAsync(string index)
+        => await _stub.GetCatalogStatsAsync(new GetCatalogStatsRequest { IndexName = index });
+
+    // ── Lifecycle ─────────────────────────────────────────
+
+    public async Task<HealthcheckResponse> HealthcheckAsync()
+        => await _stub.HealthcheckAsync(new HealthcheckRequest());
+
+    public async Task ShutdownAsync()
+        => await _stub.ShutdownAsync(new ShutdownRequest());
+
+    // ── Helpers ───────────────────────────────────────────
+
+    private static void SetMetadata(
+        Google.Protobuf.Collections.MapField<string, MetadataValue> protoMap,
+        Dictionary<string, object> metadata)
+    {
+        foreach (var (key, value) in metadata)
+        {
+            protoMap[key] = value switch
+            {
+                bool b => new MetadataValue { BoolValue = b },
+                int i => new MetadataValue { NumberValue = i },
+                long l => new MetadataValue { NumberValue = l },
+                float f => new MetadataValue { NumberValue = f },
+                double d => new MetadataValue { NumberValue = d },
+                _ => new MetadataValue { StringValue = value?.ToString() ?? "" },
+            };
+        }
+    }
+}