@finalai/agent-provider 0.1.0

package/dist/modules/sandbox/bytes.mjs

@@ -0,0 +1,154 @@
+const encoder = new TextEncoder();
+const utf8Encode = (text) => encoder.encode(text);
+const utf8Decode = (bytes) => new TextDecoder().decode(bytes);
+const concatBytes = (chunks) => {
+  let total = 0;
+  for (const chunk of chunks) total += chunk.byteLength;
+  const out = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    out.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return out;
+};
+const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+const LOOKUP = new Uint8Array(256).fill(255);
+for (let i = 0; i < ALPHABET.length; i += 1) LOOKUP[ALPHABET.charCodeAt(i)] = i;
+LOOKUP["-".charCodeAt(0)] = 62;
+LOOKUP["_".charCodeAt(0)] = 63;
+const bytesToBase64 = (bytes) => {
+  const parts = [];
+  let line = "";
+  for (let i = 0; i < bytes.length; i += 3) {
+    const a = bytes[i] ?? 0;
+    const b = bytes[i + 1] ?? 0;
+    const c = bytes[i + 2] ?? 0;
+    const triple = a << 16 | b << 8 | c;
+    line += ALPHABET[triple >> 18 & 63];
+    line += ALPHABET[triple >> 12 & 63];
+    line += i + 1 < bytes.length ? ALPHABET[triple >> 6 & 63] : "=";
+    line += i + 2 < bytes.length ? ALPHABET[triple & 63] : "=";
+    if (line.length >= 8192) {
+      parts.push(line);
+      line = "";
+    }
+  }
+  parts.push(line);
+  return parts.join("");
+};
+const base64ToBytes = (text) => {
+  const clean = text.replace(/[\s=]/g, "");
+  const out = new Uint8Array(Math.floor(clean.length * 3 / 4));
+  let buffer = 0;
+  let bits = 0;
+  let index = 0;
+  for (let i = 0; i < clean.length; i += 1) {
+    const value = LOOKUP[clean.charCodeAt(i)] ?? 255;
+    if (value === 255) throw new Error("invalid base64 input");
+    buffer = buffer << 6 | value;
+    bits += 6;
+    if (bits >= 8) {
+      bits -= 8;
+      out[index] = buffer >> bits & 255;
+      index += 1;
+    }
+  }
+  return out.subarray(0, index);
+};
+const bytesToStream = (bytes, chunkBytes = 256 * 1024) => {
+  let offset = 0;
+  return new ReadableStream({
+    pull: (controller) => {
+      if (offset >= bytes.byteLength) {
+        controller.close();
+        return;
+      }
+      const end = Math.min(bytes.byteLength, offset + chunkBytes);
+      controller.enqueue(bytes.subarray(offset, end));
+      offset = end;
+    }
+  });
+};
+const readAllBytes = async (stream, abortSignal) => {
+  const reader = stream.getReader();
+  const chunks = [];
+  const cancel = () => {
+    void reader.cancel().catch(() => void 0);
+  };
+  abortSignal?.addEventListener("abort", cancel, { once: true });
+  if (abortSignal?.aborted === true) cancel();
+  let finished = false;
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      abortSignal?.throwIfAborted();
+      if (done) {
+        finished = true;
+        break;
+      }
+      chunks.push(value);
+    }
+    return concatBytes(chunks);
+  } finally {
+    abortSignal?.removeEventListener("abort", cancel);
+    if (!finished) await reader.cancel().catch(() => void 0);
+    reader.releaseLock();
+  }
+};
+const encodeSandboxText = (text, encoding = "utf-8") => {
+  const name = encoding.toLowerCase().replaceAll("-", "");
+  if (name === "utf8") return utf8Encode(text);
+  if (name === "base64" || name === "base64url") return base64ToBytes(text);
+  if (name === "hex") {
+    if (text.length % 2 !== 0 || !/^[0-9a-f]*$/i.test(text)) throw new Error("Invalid hex text");
+    return Uint8Array.from(text.match(/.{2}/g) ?? [], (pair) => Number.parseInt(pair, 16));
+  }
+  if (name === "utf16le" || name === "utf16be" || name === "ucs2") {
+    const bytes = new Uint8Array(text.length * 2);
+    const view = new DataView(bytes.buffer);
+    for (let index = 0; index < text.length; index++)
+      view.setUint16(index * 2, text.charCodeAt(index), name !== "utf16be");
+    return bytes;
+  }
+  if (name === "latin1" || name === "binary" || name === "ascii") {
+    return Uint8Array.from(
+      { length: text.length },
+      (_value, index) => text.charCodeAt(index) & 255
+    );
+  }
+  throw new Error(`Unsupported text-file write encoding: ${encoding}`);
+};
+const decodeSandboxText = (bytes, encoding = "utf-8") => {
+  const name = encoding.toLowerCase().replaceAll("-", "");
+  if (name === "base64" || name === "base64url") {
+    const text = bytesToBase64(bytes);
+    return name === "base64" ? text : text.replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+  }
+  if (name === "hex") return [...bytes].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+  if (name === "latin1" || name === "binary" || name === "ascii") {
+    const pieces = [];
+    for (let offset = 0; offset < bytes.length; offset += 8192) {
+      pieces.push(
+        String.fromCharCode(
+          ...bytes.subarray(offset, offset + 8192).map((byte) => name === "ascii" ? byte & 127 : byte)
+        )
+      );
+    }
+    return pieces.join("");
+  }
+  const decoderName = name === "utf8" ? "utf-8" : name === "ucs2" || name === "utf16le" ? "utf-16le" : name === "utf16be" ? "utf-16be" : encoding;
+  return new TextDecoder(decoderName).decode(bytes);
+};
+export {
+  base64ToBytes,
+  bytesToBase64,
+  bytesToStream,
+  concatBytes,
+  decodeSandboxText,
+  encodeSandboxText,
+  readAllBytes,
+  utf8Decode,
+  utf8Encode
+};
+//# sourceMappingURL=bytes.mjs.map

package/dist/modules/sandbox/bytes.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/sandbox/bytes.ts"],
+  "sourcesContent": ["// Byte helpers that work in Workers, browsers and Node (no Buffer).\n\nconst encoder = new TextEncoder();\n\nexport const utf8Encode = (text: string): Uint8Array => encoder.encode(text);\n\nexport const utf8Decode = (bytes: Uint8Array): string => new TextDecoder().decode(bytes);\n\nexport const concatBytes = (chunks: readonly Uint8Array[]): Uint8Array => {\n  let total = 0;\n  for (const chunk of chunks) total += chunk.byteLength;\n  const out = new Uint8Array(total);\n  let offset = 0;\n  for (const chunk of chunks) {\n    out.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return out;\n};\n\nconst ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\nconst LOOKUP = new Uint8Array(256).fill(255);\nfor (let i = 0; i < ALPHABET.length; i += 1) LOOKUP[ALPHABET.charCodeAt(i)] = i;\nLOOKUP['-'.charCodeAt(0)] = 62;\nLOOKUP['_'.charCodeAt(0)] = 63;\n\nexport const bytesToBase64 = (bytes: Uint8Array): string => {\n  const parts: string[] = [];\n  let line = '';\n  for (let i = 0; i < bytes.length; i += 3) {\n    const a = bytes[i] ?? 0;\n    const b = bytes[i + 1] ?? 0;\n    const c = bytes[i + 2] ?? 0;\n    const triple = (a << 16) | (b << 8) | c;\n    line += ALPHABET[(triple >> 18) & 63];\n    line += ALPHABET[(triple >> 12) & 63];\n    line += i + 1 < bytes.length ? ALPHABET[(triple >> 6) & 63] : '=';\n    line += i + 2 < bytes.length ? ALPHABET[triple & 63] : '=';\n    if (line.length >= 8192) {\n      parts.push(line);\n      line = '';\n    }\n  }\n  parts.push(line);\n  return parts.join('');\n};\n\n// Accepts standard and URL-safe alphabets, with or without padding.\nexport const base64ToBytes = (text: string): Uint8Array => {\n  const clean = text.replace(/[\\s=]/g, '');\n  const out = new Uint8Array(Math.floor((clean.length * 3) / 4));\n  let buffer = 0;\n  let bits = 0;\n  let index = 0;\n  for (let i = 0; i < clean.length; i += 1) {\n    const value = LOOKUP[clean.charCodeAt(i)] ?? 255;\n    if (value === 255) throw new Error('invalid base64 input');\n    buffer = (buffer << 6) | value;\n    bits += 6;\n    if (bits >= 8) {\n      bits -= 8;\n      out[index] = (buffer >> bits) & 0xff;\n      index += 1;\n    }\n  }\n  return out.subarray(0, index);\n};\n\nexport const bytesToStream = (\n  bytes: Uint8Array,\n  chunkBytes = 256 * 1024,\n): ReadableStream<Uint8Array> => {\n  let offset = 0;\n  return new ReadableStream<Uint8Array>({\n    pull: (controller) => {\n      if (offset >= bytes.byteLength) {\n        controller.close();\n        return;\n      }\n      const end = Math.min(bytes.byteLength, offset + chunkBytes);\n      controller.enqueue(bytes.subarray(offset, end));\n      offset = end;\n    },\n  });\n};\n\nexport const readAllBytes = async (\n  stream: ReadableStream<Uint8Array>,\n  abortSignal?: AbortSignal,\n): Promise<Uint8Array> => {\n  const reader = stream.getReader();\n  const chunks: Uint8Array[] = [];\n  const cancel = () => {\n    void reader.cancel().catch(() => undefined);\n  };\n  abortSignal?.addEventListener('abort', cancel, { once: true });\n  if (abortSignal?.aborted === true) cancel();\n  let finished = false;\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      abortSignal?.throwIfAborted();\n      if (done) {\n        finished = true;\n        break;\n      }\n      chunks.push(value);\n    }\n    return concatBytes(chunks);\n  } finally {\n    abortSignal?.removeEventListener('abort', cancel);\n    if (!finished) await reader.cancel().catch(() => undefined);\n    reader.releaseLock();\n  }\n};\n\n// Portable text-file codecs shared by handles and their wire client.\nexport const encodeSandboxText = (text: string, encoding = 'utf-8'): Uint8Array => {\n  const name = encoding.toLowerCase().replaceAll('-', '');\n  if (name === 'utf8') return utf8Encode(text);\n  if (name === 'base64' || name === 'base64url') return base64ToBytes(text);\n  if (name === 'hex') {\n    if (text.length % 2 !== 0 || !/^[0-9a-f]*$/i.test(text)) throw new Error('Invalid hex text');\n    return Uint8Array.from(text.match(/.{2}/g) ?? [], (pair) => Number.parseInt(pair, 16));\n  }\n  if (name === 'utf16le' || name === 'utf16be' || name === 'ucs2') {\n    const bytes = new Uint8Array(text.length * 2);\n    const view = new DataView(bytes.buffer);\n    for (let index = 0; index < text.length; index++)\n      view.setUint16(index * 2, text.charCodeAt(index), name !== 'utf16be');\n    return bytes;\n  }\n  if (name === 'latin1' || name === 'binary' || name === 'ascii') {\n    return Uint8Array.from(\n      { length: text.length },\n      (_value, index) => text.charCodeAt(index) & 0xff,\n    );\n  }\n  throw new Error(`Unsupported text-file write encoding: ${encoding}`);\n};\n\nexport const decodeSandboxText = (bytes: Uint8Array, encoding = 'utf-8'): string => {\n  const name = encoding.toLowerCase().replaceAll('-', '');\n  if (name === 'base64' || name === 'base64url') {\n    const text = bytesToBase64(bytes);\n    return name === 'base64'\n      ? text\n      : text.replaceAll('+', '-').replaceAll('/', '_').replace(/=+$/, '');\n  }\n  if (name === 'hex') return [...bytes].map((byte) => byte.toString(16).padStart(2, '0')).join('');\n  if (name === 'latin1' || name === 'binary' || name === 'ascii') {\n    const pieces: string[] = [];\n    for (let offset = 0; offset < bytes.length; offset += 8192) {\n      pieces.push(\n        String.fromCharCode(\n          ...bytes\n            .subarray(offset, offset + 8192)\n            .map((byte) => (name === 'ascii' ? byte & 0x7f : byte)),\n        ),\n      );\n    }\n    return pieces.join('');\n  }\n  const decoderName =\n    name === 'utf8'\n      ? 'utf-8'\n      : name === 'ucs2' || name === 'utf16le'\n        ? 'utf-16le'\n        : name === 'utf16be'\n          ? 'utf-16be'\n          : encoding;\n  return new TextDecoder(decoderName).decode(bytes);\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/sandbox/client.d.mts

@@ -0,0 +1,51 @@
+import { SandboxCapability, type NetworkSandboxSessionIface } from "./types.mjs";
+import { type FrameChannelIface, type WebSocketConstructorIface } from "./wire.mjs";
+export interface SandboxClientIface extends NetworkSandboxSessionIface {
+    readonly confinedFiles: boolean;
+    readonly providerHooks: boolean;
+    onSandboxStop(): Promise<void>;
+    onSandboxDelete(options?: {
+        reason?: string;
+    }): Promise<void>;
+    onRuntimeShutdown(): Promise<void>;
+    readonly capabilities: readonly SandboxCapability[];
+    readFileRange(options: {
+        path: string;
+        root?: string;
+        offset: number;
+        length?: number;
+        abortSignal?: AbortSignal;
+    }): Promise<ReadableStream<Uint8Array> | null>;
+    close(): void;
+}
+export interface SandboxClientCredentialIface {
+    token: string;
+    expiresAt: string | null;
+    url?: string;
+}
+export interface ConnectSandboxClientArgsIface {
+    url: string;
+    token: string;
+    expiresAt?: string | null;
+    WebSocket?: WebSocketConstructorIface;
+    openChannel?: (target: {
+        url: string;
+        token: string;
+    }) => Promise<FrameChannelIface>;
+    refreshToken?: () => Promise<SandboxClientCredentialIface>;
+    binary?: boolean;
+    reconnect?: {
+        attempts?: number;
+        baseDelayMs?: number;
+        maxDelayMs?: number;
+    };
+    refreshMarginMs?: number;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+    randomId?: () => string;
+}
+export declare const connectSandboxClient: (args: ConnectSandboxClientArgsIface) => Promise<SandboxClientIface>;