@caltra/backend-sdk 0.2.0 → 0.2.2

package/README.md

@@ -15,7 +15,7 @@ npm install --save-dev typescript tsx @types/node
 cp node_modules/@caltra/backend-sdk/examples/quickstart.ts quickstart.ts
 ```
 
-In Caltra, open **Backends → Add backend**. Restrict its workspace availability, then save the backend ID and one-time credential. All replicas share those credentials.
+In Caltra, open **Backends → Add backend**. Select its environment, then save the backend ID and one-time credential. All replicas share those credentials.
 
 Create `backend.config.json` using your backend ID and credential:
 
@@ -49,6 +49,7 @@ import { BackendTool, CaltraBackendClient, type ToolContext } from "@caltra/back
 
 - `BackendTool` takes a name, description, Zod input/output schemas, and `handler(context, inputs)`. Use JSON-Schema-compatible Zod schemas. Input and output validation happens locally and on Caltra.
 - `new CaltraBackendClient({ url, backendId, credential, label, tools, maxConcurrency? })` creates a client. Default concurrency is 1; supported values are 1–100.
+- Manifests support up to 1,000 uniquely named tools. SDK 0.2.2 and its matching Caltra API support encoded RPC frames up to 4 MiB, including document project data and HTML. Earlier SDKs and servers have a 1 MiB limit. Upgrade both endpoints together. SDK 0.2.1 also raises the tool-count bound from 100 to 1,000; older endpoints reject larger catalogs.
 - `publish()` explicitly publishes definitions and returns `{ id, version, hash }`. It opens and closes its own connection. Identical current definitions reuse the version.
 - `connect()` registers one replica against matching, already-published definitions. It returns `{ instanceId, manifest, heartbeatMs }` and starts transport heartbeats.
 - `waitForDisconnect()` waits for that serving connection to close. The SDK does not reconnect automatically.

package/dist/protocol.js

@@ -6,7 +6,7 @@ export const ToolManifestSchema = z.object({
     inputSchema: z.record(z.string(), z.unknown()),
     outputSchema: z.record(z.string(), z.unknown()),
 }).strict();
-export const ManifestSchema = z.array(ToolManifestSchema).max(100).superRefine((tools, context) => {
+export const ManifestSchema = z.array(ToolManifestSchema).max(1000).superRefine((tools, context) => {
     if (new Set(tools.map(tool => tool.name)).size !== tools.length)
         context.addIssue({ code: "custom", message: "Duplicate tool names." });
 });
@@ -54,7 +54,8 @@ export class BackendProtocol {
         return { ...call, context: LegacyCallContextSchema.parse(context) };
     }
     static path = "/backends/v1/connect";
-    static maxBytes = 1024 * 1024;
+    // A document operation can carry both editor project data and rendered HTML.
+    static maxBytes = 4 * 1024 * 1024;
     static heartbeatMs = 10000;
     static leaseMs = 35000;
     static callTimeoutMs = 15000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caltra/backend-sdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "exports": {
     ".": {