@zyntax/extension-sdk 1.0.0 → 1.0.2

package/dist/runtimeLimits.js

@@ -0,0 +1,155 @@
+/** Canonical UTF-8 JSON message limit for one managed-tool protocol frame. */
+export const EXTENSION_MANAGED_TOOL_MAX_FRAME_BYTES = 4 * 1024 * 1024;
+const EXTENSION_RPC_ENVELOPE_BYTES = 4 * 1024;
+/**
+ * Managed-tool payload limits reserve four KiB for the JSON-RPC envelope carried
+ * inside the full protocol frame.
+ */
+export const EXTENSION_MANAGED_TOOL_MAX_REQUEST_BYTES = EXTENSION_MANAGED_TOOL_MAX_FRAME_BYTES - EXTENSION_RPC_ENVELOPE_BYTES;
+export const EXTENSION_MANAGED_TOOL_MAX_RESULT_BYTES = EXTENSION_MANAGED_TOOL_MAX_FRAME_BYTES - EXTENSION_RPC_ENVELOPE_BYTES;
+/** Maximum diagnostics returned by one pull provider or one publish request. */
+export const EXTENSION_DIAGNOSTICS_MAX_ITEMS = 16_384;
+export const EXTENSION_DIAGNOSTICS_MAX_BYTES = EXTENSION_MANAGED_TOOL_MAX_FRAME_BYTES - EXTENSION_RPC_ENVELOPE_BYTES;
+/** Aggregate diagnostics budget for one document across selected providers. */
+export const EXTENSION_DIAGNOSTICS_MAX_TOTAL_ITEMS = 65_536;
+export const EXTENSION_DIAGNOSTICS_MAX_TOTAL_BYTES = 16 * 1024 * 1024;
+/** Maximum task descriptors returned by one task provider invocation. */
+export const EXTENSION_TASK_PROVIDER_MAX_ITEMS = 4_096;
+/** Canonical UTF-8 budgets for one text-preview request and validated result. */
+export const EXTENSION_PREVIEW_MAX_INPUT_BYTES = 10 * 1024 * 1024;
+/** Maximum decoded source bytes for one binary preview document. */
+export const EXTENSION_PREVIEW_MAX_BINARY_INPUT_BYTES = 24 * 1024 * 1024;
+export const EXTENSION_PREVIEW_MAX_RESULT_BYTES = 16 * 1024 * 1024;
+/** Structural payload limits reserve room for host protocol envelopes. */
+export const EXTENSION_JSON_MAX_DEPTH = 60;
+export const EXTENSION_JSON_MAX_NODES = 1_000_000 - 16;
+export const EXTENSION_JSON_MAX_KEY_CODE_UNITS = 256;
+function utf8ByteLength(value) {
+    let bytes = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code <= 0x7f) {
+            bytes += 1;
+        }
+        else if (code <= 0x7ff) {
+            bytes += 2;
+        }
+        else if (code >= 0xd800
+            && code <= 0xdbff
+            && index + 1 < value.length
+            && value.charCodeAt(index + 1) >= 0xdc00
+            && value.charCodeAt(index + 1) <= 0xdfff) {
+            bytes += 4;
+            index += 1;
+        }
+        else {
+            bytes += 3;
+        }
+    }
+    return bytes;
+}
+function jsonStringByteLength(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code >= 0xd800 && code <= 0xdbff) {
+            if (index + 1 >= value.length
+                || value.charCodeAt(index + 1) < 0xdc00
+                || value.charCodeAt(index + 1) > 0xdfff) {
+                throw new TypeError("Extension JSON string contains invalid Unicode.");
+            }
+            index += 1;
+        }
+        else if (code >= 0xdc00 && code <= 0xdfff) {
+            throw new TypeError("Extension JSON string contains invalid Unicode.");
+        }
+    }
+    return utf8ByteLength(JSON.stringify(value));
+}
+/** Returns the exact UTF-8 byte length of a valid extension JSON value. */
+export function extensionJsonUtf8ByteLength(value) {
+    let bytes = 0;
+    let nodes = 0;
+    const active = new Set();
+    const tasks = [{ kind: "value", value, containerDepth: 0 }];
+    while (tasks.length) {
+        const task = tasks.pop();
+        if (task.kind === "leave") {
+            active.delete(task.value);
+            continue;
+        }
+        nodes += 1;
+        if (nodes > EXTENSION_JSON_MAX_NODES) {
+            throw new RangeError("Extension JSON value exceeds its structural limit.");
+        }
+        const candidate = task.value;
+        if (candidate === null) {
+            bytes += 4;
+            continue;
+        }
+        if (typeof candidate === "string") {
+            bytes += jsonStringByteLength(candidate);
+            continue;
+        }
+        if (typeof candidate === "boolean") {
+            bytes += candidate ? 4 : 5;
+            continue;
+        }
+        if (typeof candidate === "number") {
+            if (!Number.isFinite(candidate)) {
+                throw new TypeError("Extension JSON value is not serializable.");
+            }
+            bytes += String(candidate).length;
+            continue;
+        }
+        if (!candidate || typeof candidate !== "object") {
+            throw new TypeError("Extension JSON value is not serializable.");
+        }
+        if (active.has(candidate)) {
+            throw new TypeError("Extension JSON value is not serializable.");
+        }
+        const containerDepth = task.containerDepth + 1;
+        if (containerDepth > EXTENSION_JSON_MAX_DEPTH) {
+            throw new RangeError("Extension JSON value exceeds its structural limit.");
+        }
+        active.add(candidate);
+        tasks.push({ kind: "leave", value: candidate });
+        if (Array.isArray(candidate)) {
+            bytes += 2;
+            if (candidate.length > 1)
+                bytes += candidate.length - 1;
+            for (let index = candidate.length - 1; index >= 0; index -= 1) {
+                if (!Object.prototype.hasOwnProperty.call(candidate, index)) {
+                    throw new TypeError("Extension JSON value is not serializable.");
+                }
+                tasks.push({
+                    kind: "value",
+                    value: candidate[index],
+                    containerDepth,
+                });
+            }
+            continue;
+        }
+        const prototype = Object.getPrototypeOf(candidate);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError("Extension JSON value is not serializable.");
+        }
+        const keys = Object.keys(candidate);
+        bytes += 2;
+        if (keys.length > 1)
+            bytes += keys.length - 1;
+        for (let index = keys.length - 1; index >= 0; index -= 1) {
+            const key = keys[index];
+            if (key.length > EXTENSION_JSON_MAX_KEY_CODE_UNITS) {
+                throw new RangeError("Extension JSON object key exceeds its length limit.");
+            }
+            bytes += jsonStringByteLength(key) + 1;
+            tasks.push({
+                kind: "value",
+                value: candidate[key],
+                containerDepth,
+            });
+        }
+    }
+    return bytes;
+}
+//# sourceMappingURL=runtimeLimits.js.map

package/dist/runtimeLimits.js.map

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