replicas-engine 0.1.625 → 0.1.626

package/dist/src/index.js

@@ -2101,6 +2101,7 @@ Use this when:
 - 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 PlanetScale organizations, databases, branches, or Insights data
 - The user asks to analyze text with Pangram
 - The user asks for Stripe customers, payments, invoices, subscriptions, or balances`;
 var REFERENCE9 = `# Plugins
@@ -2156,6 +2157,17 @@ const results = await Promise.all(customerIds.map((customer) =>
 
 Never attempt to import Composio, create a session, manage a connection, or call a provider with raw credentials. Those operations are intentionally unavailable inside the workspace.
 
+## PlanetScale
+
+PlanetScale is a native OAuth integration. Pass a relative path from the PlanetScale v1 API; Replicas refreshes access tokens server-side:
+
+\`\`\`ts
+const organizations = await replicas.planetscale.request('/organizations');
+const databases = await replicas.planetscale.request('/organizations/acme/databases');
+\`\`\`
+
+OAuth scopes control permitted operations. Confirm mutations before using POST, PUT, PATCH, or DELETE.
+
 ## Modal
 
 Modal is a native integration and uses its official JavaScript SDK behind the Replicas gateway. Invoke a deployed function by name:
@@ -10960,7 +10972,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.625";
+var ENGINE_PACKAGE_VERSION = "0.1.626";
 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.625",
+  "version": "0.1.626",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",

package/workspace-sdk/index.js

@@ -45,6 +45,20 @@ function providerPath(path) {
   return path;
 }
 
+function providerClient(endpoint, extraOptions = () => ({})) {
+  return {
+    request: (path, options = {}) => request(endpoint, {
+      method: 'POST',
+      body: {
+        path: providerPath(path),
+        method: options.method,
+        body: options.body,
+        ...extraOptions(options),
+      },
+    }),
+  };
+}
+
 const integrations = {
   list: () => request('/v1/engine/integrations'),
 };
@@ -79,26 +93,9 @@ const slack = {
     }),
 };
 
-const github = {
-  request: (path, options = {}) =>
-    request('/v1/engine/github/api', {
-      method: 'POST',
-      body: { path: providerPath(path), method: options.method, body: options.body },
-    }),
-};
+const github = providerClient('/v1/engine/github/api');
 
-const gitlab = {
-  request: (path, options = {}) =>
-    request('/v1/engine/gitlab/api', {
-      method: 'POST',
-      body: {
-        path: providerPath(path),
-        method: options.method,
-        body: options.body,
-        host: options.host,
-      },
-    }),
-};
+const gitlab = providerClient('/v1/engine/gitlab/api', (options) => ({ host: options.host }));
 
 const sentry = {
   request: (path) => request('/v1/engine/sentry/api', { method: 'POST', body: { path } }),
@@ -117,6 +114,8 @@ const turbopuffer = {
   write: (namespace, params) => turbopufferRequest('write', namespace, params),
 };
 
+const planetscale = providerClient('/v1/engine/planetscale/api');
+
 const pangramRequest = (operation, input) =>
   request('/v1/engine/pangram', { method: 'POST', body: { operation, ...input } });
 const pangram = {
@@ -124,5 +123,5 @@ const pangram = {
   plagiarism: (text) => pangramRequest('plagiarism', { text }),
 };
 
-export const replicas = { integrations, plugins, linear, slack, github, gitlab, sentry, modal, turbopuffer, pangram };
+export const replicas = { integrations, plugins, linear, slack, github, gitlab, sentry, modal, pangram, planetscale, turbopuffer };
 export default replicas;

package/workspace-sdk/index.test.ts

@@ -137,6 +137,29 @@ describe('@replicas/sdk', () => {
       server.stop(true);
     }
   });
+
+  test('calls PlanetScale 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({ data: [] });
+      },
+    });
+    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.planetscale.request('/organizations');
+      expect(observed).toEqual({
+        path: '/v1/engine/planetscale/api',
+        body: { path: '/organizations' },
+      });
+    } finally {
+      server.stop(true);
+    }
+  });
 });
 
   test('analyzes text with Pangram through the workspace gateway', async () => {

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

@@ -91,6 +91,14 @@ export declare const PLUGIN_CATALOG: readonly [{
     readonly category: "data";
     readonly name: "PostHog";
     readonly description: "Manage projects, events, insights, dashboards, flags, and recordings.";
+}, {
+    readonly id: "planetscale";
+    readonly toolkit: "planetscale";
+    readonly source: "native";
+    readonly authType: "oauth";
+    readonly category: "data";
+    readonly name: "PlanetScale";
+    readonly description: "Manage organizations, databases, branches, deploy requests, and Insights.";
 }, {
     readonly id: "stripe";
     readonly toolkit: "stripe";
@@ -121,6 +129,10 @@ export declare const PLUGIN_CATALOG: readonly [{
     readonly description: "Query and manage turbopuffer namespaces.";
 }];
 export type PluginId = (typeof PLUGIN_CATALOG)[number]['id'];
+export type NativePluginId = Extract<(typeof PLUGIN_CATALOG)[number], {
+    source: 'native';
+}>['id'];
+export type ComposioPluginId = Exclude<PluginId, NativePluginId>;
 export type PluginScope = 'organization' | 'personal';
 export type PluginAuthType = (typeof PLUGIN_CATALOG)[number]['authType'];
 export type PluginCategory = (typeof PLUGIN_CATALOG)[number]['category'];
@@ -133,6 +145,7 @@ export interface PluginCatalogItem {
     category: PluginCategory;
     name: string;
     description: string;
+    source?: 'native';
 }
 export interface PluginConnectionSummary {
     id: string;
@@ -210,7 +223,7 @@ export interface WorkspaceIntegrationsResponse {
     native: WorkspaceNativeIntegrationStatus;
 }
 export interface PluginSearchRequest {
-    plugin: PluginId;
+    plugin: ComposioPluginId;
     query: string;
 }
 export interface PluginToolSchema {
@@ -224,14 +237,14 @@ export interface PluginSearchResponse {
     tools: PluginToolSchema[];
 }
 export interface PluginDescribeRequest {
-    plugin: PluginId;
+    plugin: ComposioPluginId;
     tools: string[];
 }
 export interface PluginDescribeResponse {
     tools: PluginToolSchema[];
 }
 export interface PluginExecuteRequest {
-    plugin: PluginId;
+    plugin: ComposioPluginId;
     tool: string;
     arguments?: Record<string, unknown>;
 }
@@ -240,4 +253,5 @@ export interface PluginExecuteResponse {
     logId: string;
 }
 export declare function isPluginId(value: string): value is PluginId;
+export declare function isComposioPluginId(value: string): value is ComposioPluginId;
 export declare function isPluginConnectionStatus(value: string): value is PluginConnectionStatus;

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

@@ -57,6 +57,9 @@ export interface ReplicasSdk {
         query<T = unknown>(namespace: string, params: Record<string, unknown>): Promise<T>;
         write<T = unknown>(namespace: string, params: Record<string, unknown>): Promise<T>;
     };
+    planetscale: {
+        request<T = unknown>(path: string, options?: ProviderRequestOptions): Promise<T>;
+    };
     pangram: {
         detect<T = unknown>(input: import('./routes/plugins').PangramAnalyzeRequest): Promise<T>;
         plagiarism<T = unknown>(text: string): Promise<T>;