replicas-engine 0.1.623 → 0.1.624

package/dist/src/index.js

@@ -2100,6 +2100,7 @@ Use this when:
 - The user asks to read or change Google Ads, Docs, Drive, Search Console, or Sheets data
 - The user asks for ClickHouse analytics or PostHog product data
 - The user asks to invoke a connected Modal function
+- The user asks to query or update a connected turbopuffer namespace
 - The user asks for Stripe customers, payments, invoices, subscriptions, or balances`;
 var REFERENCE9 = `# Plugins
 
@@ -2168,6 +2169,20 @@ const result = await replicas.modal.call({
 \`\`\`
 
 Function calls execute with the connected Modal token and may mutate external state. Confirm the requested action before invoking a function with side effects.
+
+## turbopuffer
+
+turbopuffer is a native integration backed by its official TypeScript SDK. Use the provider-shaped helpers:
+
+\`\`\`ts
+const namespaces = await replicas.turbopuffer.namespaces({ prefix: 'products' });
+const results = await replicas.turbopuffer.query('products', {
+  rank_by: ['text', 'BM25', 'wireless headphones'],
+  top_k: 10,
+});
+\`\`\`
+
+\`write\` mutates namespace data. Confirm the requested change before calling it.
 `;
 var PLUGINS_ABILITY = {
   label: "Plugins",
@@ -10933,7 +10948,7 @@ var DEFAULT_CODEX_ARGS = [
 var MIN_CODEX_CLI_VERSION = "0.144.6";
 var CODEX_UPGRADE_TIMEOUT_MS = 12e4;
 var codexCliVersionEnsured = null;
-var ENGINE_PACKAGE_VERSION = "0.1.623";
+var ENGINE_PACKAGE_VERSION = "0.1.624";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.623",
+  "version": "0.1.624",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",

package/workspace-sdk/index.js

@@ -108,5 +108,14 @@ const modal = {
   call: (input) => request('/v1/engine/modal/call', { method: 'POST', body: input }),
 };
 
-export const replicas = { integrations, plugins, linear, slack, github, gitlab, sentry, modal };
+const turbopufferRequest = (operation, namespace, params) =>
+  request('/v1/engine/turbopuffer', { method: 'POST', body: { operation, namespace, params } });
+const turbopuffer = {
+  namespaces: (params) => turbopufferRequest('namespaces', undefined, params),
+  metadata: (namespace, params) => turbopufferRequest('metadata', namespace, params),
+  query: (namespace, params) => turbopufferRequest('query', namespace, params),
+  write: (namespace, params) => turbopufferRequest('write', namespace, params),
+};
+
+export const replicas = { integrations, plugins, linear, slack, github, gitlab, sentry, modal, turbopuffer };
 export default replicas;

package/workspace-sdk/index.test.ts

@@ -114,4 +114,27 @@ describe('@replicas/sdk', () => {
     process.env.REPLICAS_WORKSPACE_ID = 'workspace-1';
     expect(() => replicas.github.request('//attacker.example/path')).toThrow('relative');
   });
+
+  test('queries turbopuffer through the workspace gateway', async () => {
+    let observed: { path: string; body: unknown } | null = null;
+    const server = Bun.serve({
+      port: 0,
+      async fetch(request) {
+        observed = { path: new URL(request.url).pathname, body: await request.json() };
+        return Response.json({ rows: [] });
+      },
+    });
+    process.env.REPLICAS_MONOLITH_URL = server.url.toString().replace(/\/$/, '');
+    process.env.REPLICAS_ENGINE_SECRET = 'engine-secret';
+    process.env.REPLICAS_WORKSPACE_ID = 'workspace-1';
+    try {
+      await replicas.turbopuffer.query('products', { top_k: 10 });
+      expect(observed).toEqual({
+        path: '/v1/engine/turbopuffer',
+        body: { operation: 'query', namespace: 'products', params: { top_k: 10 } },
+      });
+    } finally {
+      server.stop(true);
+    }
+  });
 });

package/workspace-sdk/shared/routes/plugins.d.ts

@@ -105,6 +105,13 @@ export declare const PLUGIN_CATALOG: readonly [{
     readonly category: "data";
     readonly name: "Vercel";
     readonly description: "Manage projects, deployments, logs, domains, and infrastructure.";
+}, {
+    readonly id: "turbopuffer";
+    readonly toolkit: "turbopuffer";
+    readonly authType: "api_key";
+    readonly category: "data";
+    readonly name: "turbopuffer";
+    readonly description: "Query and manage turbopuffer namespaces.";
 }];
 export type PluginId = (typeof PLUGIN_CATALOG)[number]['id'];
 export type PluginScope = 'organization' | 'personal';
@@ -156,7 +163,13 @@ export interface PluginConnectModalRequest {
     tokenId: string;
     tokenSecret: string;
 }
-export type PluginConnectRequest = PluginConnectPostHogRequest | PluginConnectClickHouseRequest | PluginConnectApiKeyRequest | PluginConnectModalRequest;
+export declare const TURBOPUFFER_REGIONS: readonly ["aws-us-east-1", "aws-us-west-2", "gcp-us-central1", "gcp-europe-west3"];
+export type TurbopufferRegion = (typeof TURBOPUFFER_REGIONS)[number];
+export interface PluginConnectTurbopufferRequest {
+    apiKey: string;
+    region: TurbopufferRegion;
+}
+export type PluginConnectRequest = PluginConnectPostHogRequest | PluginConnectClickHouseRequest | PluginConnectApiKeyRequest | PluginConnectModalRequest | PluginConnectTurbopufferRequest;
 export interface ModalCallRequest {
     app: string;
     function: string;
@@ -164,6 +177,11 @@ export interface ModalCallRequest {
     kwargs?: Record<string, unknown>;
     environment?: string;
 }
+export interface TurbopufferOperationRequest {
+    operation: 'namespaces' | 'metadata' | 'query' | 'write';
+    namespace?: string;
+    params?: Record<string, unknown>;
+}
 export interface PluginConnectResponse {
     success: true;
 }

package/workspace-sdk/shared/workspace-sdk.d.ts

@@ -51,4 +51,10 @@ export interface ReplicasSdk {
     modal: {
         call<T = unknown>(input: import('./routes/plugins').ModalCallRequest): Promise<T>;
     };
+    turbopuffer: {
+        namespaces<T = unknown>(params?: Record<string, unknown>): Promise<T>;
+        metadata<T = unknown>(namespace: string, params?: Record<string, unknown>): Promise<T>;
+        query<T = unknown>(namespace: string, params: Record<string, unknown>): Promise<T>;
+        write<T = unknown>(namespace: string, params: Record<string, unknown>): Promise<T>;
+    };
 }