@fabric-harness/connectors 0.14.1 → 0.16.1

package/dist/vercel.d.ts

@@ -0,0 +1,74 @@
+import type { SandboxEnv, SandboxFactory } from '@fabric-harness/sdk';
+import type { RemoteAdapterOptions } from './index.js';
+/**
+ * Structural shape of `@vercel/sandbox`'s `Sandbox` instance, kept narrow so
+ * this package doesn't peer-dep on `@vercel/sandbox` directly. Pass any
+ * object satisfying this contract — the real `Sandbox` from
+ * `@vercel/sandbox` does.
+ *
+ * See https://vercel.com/docs/vercel-sandbox/sdk-reference for the upstream
+ * API. This adapter targets the post-GA shape (`runCommand`, `fs.*`).
+ */
+export interface VercelSandboxLike {
+    runCommand(input: {
+        cmd: string;
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): Promise<{
+        stdout?: string;
+        stderr?: string;
+        exitCode?: number;
+        status?: string;
+    }>;
+    fs: {
+        readFile(path: string, encoding?: 'utf8'): Promise<string>;
+        readFile(path: string): Promise<Uint8Array | Buffer>;
+        writeFile(path: string, content: string | Uint8Array): Promise<void>;
+        stat(path: string): Promise<{
+            isDirectory?: boolean;
+            size?: number;
+            mtime?: Date;
+        }>;
+        readdir(path: string): Promise<string[]>;
+        mkdir(path: string, options?: {
+            recursive?: boolean;
+        }): Promise<void>;
+        rm(path: string, options?: {
+            recursive?: boolean;
+            force?: boolean;
+        }): Promise<void>;
+    };
+    /** Optional: stop and tear down the sandbox. */
+    stop?(): Promise<void> | void;
+    /** Optional: extend the lifetime of the sandbox before its idle timeout. */
+    extendTimeout?(durationMs: number): Promise<void> | void;
+}
+export interface VercelSandboxOptions extends RemoteAdapterOptions {
+    /** Defaults to Vercel's container default `/vercel/sandbox`. */
+    cwd?: string;
+}
+/**
+ * Wrap a Vercel Sandbox instance as a Fabric Harness `SandboxEnv`. The
+ * sandbox's filesystem and shell exec are mapped to the fabric contract;
+ * `cleanup: true` calls `sandbox.stop()` when the Fabric session tears down.
+ *
+ * ```ts
+ * import { Sandbox } from '@vercel/sandbox';
+ * import { vercelSandbox } from '@fabric-harness/connectors/vercel';
+ *
+ * const remote = await Sandbox.create({ runtime: 'node24' });
+ * const fabric = await init({ sandbox: vercelSandbox(remote, { cleanup: true }) });
+ * ```
+ *
+ * Vercel's `runCommand` accepts a single command string with optional
+ * `cwd`/`env`/`timeout`; we pass each through and surface stdout/stderr/exit.
+ */
+export declare function vercelSandbox(sandbox: VercelSandboxLike, options?: VercelSandboxOptions): SandboxEnv;
+/**
+ * Convenience factory that returns a `SandboxFactory`, suitable for
+ * `init({ sandbox: vercelSandboxFactory(...) })`. Provisions a fresh sandbox
+ * on first use via the supplied `create()` callback.
+ */
+export declare function vercelSandboxFactory(create: () => Promise<VercelSandboxLike> | VercelSandboxLike, options?: VercelSandboxOptions): SandboxFactory;
+//# sourceMappingURL=vercel.d.ts.map

package/dist/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../src/vercel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,UAAU,EACV,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,KAAK,EAAE;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,EAAE,EAAE;QACF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC;QACrD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,WAAW,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACtE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACrF,CAAC;IACF,gDAAgD;IAChD,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,4EAA4E;IAC5E,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,oBAAyB,GACjC,UAAU,CA4EZ;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,EAC5D,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAKhB"}

package/dist/vercel.js

@@ -0,0 +1,111 @@
+import { createRemoteSandboxEnv } from '@fabric-harness/sdk';
+/**
+ * Wrap a Vercel Sandbox instance as a Fabric Harness `SandboxEnv`. The
+ * sandbox's filesystem and shell exec are mapped to the fabric contract;
+ * `cleanup: true` calls `sandbox.stop()` when the Fabric session tears down.
+ *
+ * ```ts
+ * import { Sandbox } from '@vercel/sandbox';
+ * import { vercelSandbox } from '@fabric-harness/connectors/vercel';
+ *
+ * const remote = await Sandbox.create({ runtime: 'node24' });
+ * const fabric = await init({ sandbox: vercelSandbox(remote, { cleanup: true }) });
+ * ```
+ *
+ * Vercel's `runCommand` accepts a single command string with optional
+ * `cwd`/`env`/`timeout`; we pass each through and surface stdout/stderr/exit.
+ */
+export function vercelSandbox(sandbox, options = {}) {
+    const api = {
+        async exec(command, execOptions) {
+            const input = {
+                cmd: command,
+            };
+            if (execOptions?.cwd !== undefined)
+                input.cwd = execOptions.cwd;
+            if (execOptions?.env !== undefined)
+                input.env = execOptions.env;
+            if (execOptions?.timeout !== undefined)
+                input.timeout = execOptions.timeout;
+            const result = await sandbox.runCommand(input);
+            return {
+                command,
+                exitCode: result.exitCode ?? (result.status === 'success' ? 0 : 1),
+                stdout: result.stdout ?? '',
+                stderr: result.stderr ?? '',
+            };
+        },
+        async readFile(path) {
+            const content = await sandbox.fs.readFile(path, 'utf8');
+            return content;
+        },
+        async readFileBuffer(path) {
+            // Vercel's fs.readFile is overloaded; calling without an encoding may
+            // return a Buffer (Node) or Uint8Array depending on runtime.
+            const data = (await sandbox.fs.readFile(path));
+            if (data instanceof Uint8Array)
+                return data;
+            if (typeof data === 'string')
+                return new TextEncoder().encode(data);
+            return new Uint8Array(data);
+        },
+        async writeFile(path, content) {
+            await sandbox.fs.writeFile(path, content);
+        },
+        async stat(path) {
+            const info = await sandbox.fs.stat(path);
+            return {
+                type: info.isDirectory ? 'directory' : 'file',
+                size: info.size ?? 0,
+                ...(info.mtime ? { mtime: info.mtime } : {}),
+            };
+        },
+        async readdir(path) {
+            return sandbox.fs.readdir(path);
+        },
+        async exists(path) {
+            try {
+                await sandbox.fs.stat(path);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async mkdir(path, mkdirOptions) {
+            await sandbox.fs.mkdir(path, mkdirOptions);
+        },
+        async rm(path, rmOptions) {
+            await sandbox.fs.rm(path, rmOptions);
+        },
+    };
+    const cleanup = options.cleanup === true && sandbox.stop
+        ? async () => {
+            const stop = sandbox.stop;
+            if (stop)
+                await stop.call(sandbox);
+        }
+        : typeof options.cleanup === 'function'
+            ? async () => {
+                await options.cleanup();
+            }
+            : undefined;
+    return createRemoteSandboxEnv(api, {
+        cwd: options.cwd ?? '/vercel/sandbox',
+        ...(options.capabilities ? { capabilities: options.capabilities } : {}),
+        ...(cleanup ? { cleanup } : {}),
+        ...(options.encodeRef ? { encodeRef: options.encodeRef } : {}),
+    });
+}
+/**
+ * Convenience factory that returns a `SandboxFactory`, suitable for
+ * `init({ sandbox: vercelSandboxFactory(...) })`. Provisions a fresh sandbox
+ * on first use via the supplied `create()` callback.
+ */
+export function vercelSandboxFactory(create, options = {}) {
+    return async () => {
+        const sandbox = await create();
+        return vercelSandbox(sandbox, options);
+    };
+}
+//# sourceMappingURL=vercel.js.map

package/dist/vercel.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabric-harness/connectors",
-  "version": "0.14.1",
+  "version": "0.16.1",
   "description": "Connector recipes (sandbox, mcp, data) for Fabric Harness — markdown-based provider integrations.",
   "license": "Apache-2.0",
   "author": "Fabric",
@@ -60,6 +60,10 @@
       "types": "./dist/k8s.d.ts",
       "import": "./dist/k8s.js"
     },
+    "./vercel": {
+      "types": "./dist/vercel.d.ts",
+      "import": "./dist/vercel.js"
+    },
     "./sandbox-refs": {
       "types": "./dist/sandbox-refs.d.ts",
       "import": "./dist/sandbox-refs.js"
@@ -71,13 +75,14 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@fabric-harness/sdk": "1.0.0"
+    "@fabric-harness/sdk": "^1.12.1"
   },
   "peerDependencies": {
     "@aws-sdk/client-s3": "^3.0.0",
     "@azure/storage-blob": "^12.0.0",
     "@google-cloud/storage": "^7.0.0",
     "@kubernetes/client-node": "^0.21.0",
+    "@vercel/sandbox": "*",
     "octokit": "^4.0.0"
   },
   "peerDependenciesMeta": {
@@ -93,6 +98,9 @@
     "@kubernetes/client-node": {
       "optional": true
     },
+    "@vercel/sandbox": {
+      "optional": true
+    },
     "octokit": {
       "optional": true
     }