@fabric-harness/connectors 0.5.0 → 0.6.0

package/README.md

@@ -2,10 +2,11 @@
 
 > Modular connector helpers and recipes for [Fabric Harness](https://github.com/Fabric-Pro/fabric-harness).
 
-Use this package in two ways:
+Three ways to use this package:
 
-1. Import provider-neutral helpers such as `remoteSandbox`, `daytonaSandbox`, `e2bSandbox`, `modalSandbox`, `s3FilesystemSource`, and `azureBlobFilesystemSource`.
-2. Use `fh add` to print markdown connector recipes that your coding agent can adapt into project-local files.
+1. **Concrete data sources** on dedicated subpath exports (`@fabric-harness/connectors/s3`, `/azure-blob`, `/gcs`, `/github`, `/databricks-volume`, `/k8s`). Each peer-deps the vendor SDK so you only install what you use.
+2. **Sandbox adapters** for Daytona, E2B, Modal, plus the structural `remoteSandbox` for any provider-owned remote sandbox (`s3FilesystemSource`, `azureBlobFilesystemSource` from the root export are the older structural sources for advanced cases).
+3. **Markdown recipes** via `fh add <name>` that you pipe into your coding agent to scaffold a project-local adapter.
 
 ## Install
 
@@ -13,6 +14,36 @@ Use this package in two ways:
 npm install @fabric-harness/connectors
 ```
 
+## Data sources
+
+Mount external services as files inside the sandbox. The agent's built-in
+`read`, `glob`, `grep`, and `bash` tools then operate over the mounted prefix.
+
+```ts
+import { s3Source } from '@fabric-harness/connectors/s3';
+
+const fabric = await init({ sandbox: 'local' });
+const session = await fabric.session();
+
+// `@aws-sdk/client-s3` is a peer dependency — install it explicitly.
+await session.mount('/mnt/logs', s3Source({ bucket: 'my-logs', prefix: '2026/' }));
+```
+
+Each source is a `FilesystemSource` that yields `(path, content)` pairs;
+`session.mount(mountAt, source)` writes them into the sandbox at the given
+path. Absolute mount paths outside the sandbox cwd are rerooted under it.
+
+Available subpath exports (peer-dep'd vendor SDKs):
+
+| Export | Functions | Peer dependency |
+|---|---|---|
+| `@fabric-harness/connectors/s3`                | `s3Source`, `s3Writer`                   | `@aws-sdk/client-s3` |
+| `@fabric-harness/connectors/azure-blob`        | `azureBlobSource`, `azureBlobWriter`     | `@azure/storage-blob` |
+| `@fabric-harness/connectors/gcs`               | `gcsSource`, `gcsWriter`                 | `@google-cloud/storage` |
+| `@fabric-harness/connectors/github`            | `githubSource`                           | `octokit` |
+| `@fabric-harness/connectors/databricks-volume` | `databricksVolumeSource`, `databricksVolumeWriter` | _(none — uses `fetch`)_ |
+| `@fabric-harness/connectors/k8s`               | `kubernetesSandbox`, `createKubernetesPod` | `@kubernetes/client-node` |
+
 ## Sandbox adapters
 
 ```ts

package/dist/azure-blob.d.ts

@@ -0,0 +1,49 @@
+import type { FilesystemSource } from '@fabric-harness/sdk';
+/**
+ * Concrete Azure Blob connector backed by `@azure/storage-blob`.
+ *
+ * Install peer deps:
+ * ```sh
+ * npm install @azure/storage-blob
+ * # optional, for managed identity:
+ * npm install @azure/identity
+ * ```
+ */
+export interface AzureBlobSourceOptions {
+    /** Storage account URL, e.g. `https://acct.blob.core.windows.net`. */
+    accountUrl?: string;
+    /** Container name. Required. */
+    container: string;
+    /** Optional blob name prefix. */
+    prefix?: string;
+    /** Override prefix-stripping in mounted paths. Defaults to `prefix`. */
+    stripPrefix?: string;
+    /** Filter applied to each blob name. */
+    include?: (name: string) => boolean;
+    /** Page size for listings. */
+    pageSize?: number;
+    /** Stable name for telemetry / logs. */
+    name?: string;
+    /** Account-level connection string. Mutually exclusive with `accountUrl` + credential. */
+    connectionString?: string;
+    /** SAS or storage-shared-key credential, or `@azure/identity` credential. */
+    credential?: unknown;
+    /** Pre-built ContainerClient. Overrides accountUrl/container/credential. */
+    containerClient?: unknown;
+}
+export declare function azureBlobSource(options: AzureBlobSourceOptions): FilesystemSource;
+export interface AzureBlobWriterOptions extends Omit<AzureBlobSourceOptions, 'prefix' | 'stripPrefix' | 'include' | 'pageSize' | 'name'> {
+    prefix?: string;
+}
+export interface AzureBlobWriter {
+    put(name: string, content: string | Uint8Array, options?: {
+        contentType?: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        name: string;
+        container: string;
+    }>;
+    delete(name: string): Promise<void>;
+}
+export declare function azureBlobWriter(options: AzureBlobWriterOptions): AzureBlobWriter;
+//# sourceMappingURL=azure-blob.d.ts.map

package/dist/azure-blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-blob.d.ts","sourceRoot":"","sources":["../src/azure-blob.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAQD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CAgCjF;AAED,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACtI,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAyBhF"}

package/dist/azure-blob.js

@@ -0,0 +1,117 @@
+import { createRequire } from 'node:module';
+import { azureBlobFilesystemSource } from './index.js';
+const requireFromHere = createRequire(import.meta.url);
+export function azureBlobSource(options) {
+    const container = createContainerClient(options);
+    return azureBlobFilesystemSource({
+        async listBlobs(listOpts) {
+            const blobs = [];
+            const iterable = container.listBlobsFlat(listOpts?.prefix ? { prefix: listOpts.prefix } : {});
+            for await (const blob of iterable) {
+                blobs.push(blob);
+                if (listOpts?.maxPageSize && blobs.length >= listOpts.maxPageSize)
+                    break;
+            }
+            return { blobs };
+        },
+        async downloadBlob(name) {
+            const blobClient = container.getBlobClient?.(name) ?? container.getBlockBlobClient?.(name);
+            if (!blobClient)
+                return null;
+            const response = await blobClient.download();
+            const bytes = await streamToBytes(response.readableStreamBody, response.blobBody);
+            return {
+                body: bytes,
+                ...(response.contentType ? { contentType: response.contentType } : {}),
+            };
+        },
+    }, {
+        ...(options.prefix !== undefined ? { prefix: options.prefix } : {}),
+        ...(options.stripPrefix !== undefined ? { stripPrefix: options.stripPrefix } : {}),
+        ...(options.include !== undefined ? { include: options.include } : {}),
+        ...(options.pageSize !== undefined ? { pageSize: options.pageSize } : {}),
+        name: options.name ?? `azure-blob:${options.container}/${options.prefix ?? ''}`,
+    });
+}
+export function azureBlobWriter(options) {
+    const container = createContainerClient(options);
+    const prefix = options.prefix ?? '';
+    const fullName = (name) => `${prefix}${name.replace(/^\/+/, '')}`;
+    return {
+        async put(name, content, putOptions) {
+            const blob = container.getBlockBlobClient?.(fullName(name));
+            if (!blob || typeof blob.uploadData !== 'function') {
+                throw new Error('azureBlobWriter: container client does not expose getBlockBlobClient(name).uploadData()');
+            }
+            const data = typeof content === 'string' ? new TextEncoder().encode(content) : content;
+            const uploadOptions = {};
+            if (putOptions?.contentType)
+                uploadOptions.blobHTTPHeaders = { blobContentType: putOptions.contentType };
+            if (putOptions?.metadata)
+                uploadOptions.metadata = putOptions.metadata;
+            await blob.uploadData(data, uploadOptions);
+            return { name: fullName(name), container: options.container };
+        },
+        async delete(name) {
+            const blob = container.getBlockBlobClient?.(fullName(name));
+            if (!blob || typeof blob.deleteIfExists !== 'function') {
+                throw new Error('azureBlobWriter: container client does not expose getBlockBlobClient(name).deleteIfExists()');
+            }
+            await blob.deleteIfExists();
+        },
+    };
+}
+function createContainerClient(options) {
+    if (options.containerClient) {
+        if (typeof options.containerClient.listBlobsFlat !== 'function') {
+            throw new Error('azureBlobSource: provided `containerClient` does not implement listBlobsFlat().');
+        }
+        return options.containerClient;
+    }
+    const mod = loadAzureBlobModule();
+    if (options.connectionString) {
+        const service = mod.BlobServiceClient.fromConnectionString(options.connectionString);
+        return service.getContainerClient(options.container);
+    }
+    if (!options.accountUrl) {
+        throw new Error('azureBlobSource: provide `containerClient`, `connectionString`, or `accountUrl`.');
+    }
+    const service = new mod.BlobServiceClient(options.accountUrl, options.credential);
+    return service.getContainerClient(options.container);
+}
+let cachedModule;
+function loadAzureBlobModule() {
+    if (cachedModule)
+        return cachedModule;
+    try {
+        const mod = requireFromHere('@azure/storage-blob');
+        cachedModule = mod;
+        return mod;
+    }
+    catch {
+        throw new Error('azureBlobSource/azureBlobWriter requires the `@azure/storage-blob` peer dependency. Install it with: npm install @azure/storage-blob');
+    }
+}
+async function streamToBytes(stream, blobBody) {
+    if (blobBody) {
+        const blob = await blobBody;
+        return new Uint8Array(await blob.arrayBuffer());
+    }
+    if (!stream)
+        return new Uint8Array();
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(typeof chunk === 'string' ? new TextEncoder().encode(chunk) : chunk);
+    }
+    let total = 0;
+    for (const c of chunks)
+        total += c.byteLength;
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const c of chunks) {
+        out.set(c, offset);
+        offset += c.byteLength;
+    }
+    return out;
+}
+//# sourceMappingURL=azure-blob.js.map

package/dist/azure-blob.js.map

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

package/dist/databricks-volume.d.ts

@@ -0,0 +1,53 @@
+import type { FilesystemSource } from '@fabric-harness/sdk';
+/**
+ * Databricks Unity Catalog Volume connector backed by the Files API
+ * (`/api/2.0/fs/files/...`). No SDK dependency — uses `fetch` directly.
+ *
+ * Volume paths are addressed as `/Volumes/<catalog>/<schema>/<volume>/<path>`.
+ *
+ * Usage:
+ * ```ts
+ * import { databricksVolumeSource } from '@fabric-harness/connectors/databricks-volume';
+ *
+ * const source = databricksVolumeSource({
+ *   host: process.env.DATABRICKS_HOST!,
+ *   token: process.env.DATABRICKS_TOKEN!,
+ *   volumePath: '/Volumes/main/landing/raw',
+ * });
+ * await session.mount('/mnt/dbx', source);
+ * ```
+ */
+export interface DatabricksVolumeSourceOptions {
+    /** Databricks workspace host, e.g. `https://adb-123.azuredatabricks.net`. */
+    host: string;
+    /** Personal access token or `() => Promise<string>` for short-lived tokens. */
+    token: string | (() => string | Promise<string>);
+    /** Volume path, e.g. `/Volumes/<catalog>/<schema>/<volume>/<subpath>`. */
+    volumePath: string;
+    /** Filter applied to each file's relative path. */
+    include?: (path: string) => boolean;
+    /** Stable name for telemetry / logs. */
+    name?: string;
+    /** Page size for directory listings. */
+    pageSize?: number;
+    /** Custom fetch implementation (defaults to global `fetch`). */
+    fetchImpl?: typeof fetch;
+}
+export declare function databricksVolumeSource(options: DatabricksVolumeSourceOptions): FilesystemSource;
+export interface DatabricksVolumeWriterOptions {
+    host: string;
+    token: string | (() => string | Promise<string>);
+    /** Volume path that all writes are scoped under. */
+    volumePath: string;
+    fetchImpl?: typeof fetch;
+}
+export interface DatabricksVolumeWriter {
+    put(name: string, content: string | Uint8Array, options?: {
+        overwrite?: boolean;
+    }): Promise<{
+        path: string;
+    }>;
+    delete(name: string): Promise<void>;
+}
+export declare function databricksVolumeWriter(options: DatabricksVolumeWriterOptions): DatabricksVolumeWriter;
+//# sourceMappingURL=databricks-volume.d.ts.map

package/dist/databricks-volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databricks-volume.d.ts","sourceRoot":"","sources":["../src/databricks-volume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE7E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAeD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,gBAAgB,CAS/F;AAiCD,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9G,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,sBAAsB,CAgBrG"}

package/dist/databricks-volume.js

@@ -0,0 +1,107 @@
+export function databricksVolumeSource(options) {
+    const include = options.include ?? (() => true);
+    const root = normalizeVolumePath(options.volumePath);
+    return {
+        name: options.name ?? `databricks-volume:${root}`,
+        async *entries() {
+            yield* walkVolume(options, root, root, include);
+        },
+    };
+}
+async function* walkVolume(options, root, dir, include) {
+    let pageToken;
+    do {
+        const params = new URLSearchParams();
+        if (options.pageSize)
+            params.set('page_size', String(options.pageSize));
+        if (pageToken)
+            params.set('page_token', pageToken);
+        const listing = await dbxRequest(options, 'GET', `/api/2.0/fs/directories${dir}`, params);
+        for (const entry of listing.contents ?? []) {
+            if (!entry.path)
+                continue;
+            if (entry.is_directory) {
+                yield* walkVolume(options, root, entry.path, include);
+                continue;
+            }
+            const relative = entry.path.startsWith(root) ? entry.path.slice(root.length).replace(/^\/+/, '') : entry.path.replace(/^\/+/, '');
+            if (!relative)
+                continue;
+            if (!include(relative))
+                continue;
+            const bytes = await dbxRequestBytes(options, 'GET', `/api/2.0/fs/files${entry.path}`);
+            yield {
+                path: relative,
+                content: bytes,
+                metadata: {
+                    key: entry.path,
+                    ...(entry.file_size !== undefined ? { size: entry.file_size } : {}),
+                    ...(entry.modification_time !== undefined ? { lastModified: new Date(entry.modification_time).toISOString() } : {}),
+                },
+            };
+        }
+        pageToken = listing.next_page_token;
+    } while (pageToken);
+}
+export function databricksVolumeWriter(options) {
+    const root = normalizeVolumePath(options.volumePath);
+    return {
+        async put(name, content, putOptions) {
+            const path = `${root}/${name.replace(/^\/+/, '')}`;
+            const params = new URLSearchParams();
+            if (putOptions?.overwrite)
+                params.set('overwrite', 'true');
+            const body = typeof content === 'string' ? new TextEncoder().encode(content) : content;
+            await dbxRequest(options, 'PUT', `/api/2.0/fs/files${path}`, params, body);
+            return { path };
+        },
+        async delete(name) {
+            const path = `${root}/${name.replace(/^\/+/, '')}`;
+            await dbxRequest(options, 'DELETE', `/api/2.0/fs/files${path}`);
+        },
+    };
+}
+function normalizeVolumePath(volumePath) {
+    if (!volumePath.startsWith('/Volumes/')) {
+        throw new Error(`databricks-volume: volumePath must start with /Volumes/, got: ${volumePath}`);
+    }
+    return volumePath.replace(/\/+$/, '');
+}
+async function dbxRequest(options, method, path, params, body) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const token = typeof options.token === 'function' ? await options.token() : options.token;
+    const url = new URL(`${options.host.replace(/\/$/, '')}${path}`);
+    if (params)
+        for (const [key, value] of params)
+            url.searchParams.set(key, value);
+    const headers = { authorization: `Bearer ${token}` };
+    const init = { method, headers };
+    if (body !== undefined) {
+        init.body = body;
+        if (typeof body !== 'string')
+            headers['content-type'] = 'application/octet-stream';
+    }
+    const response = await fetchImpl(url, init);
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`databricks-volume: ${method} ${path} -> ${response.status} ${response.statusText}: ${text.slice(0, 500)}`);
+    }
+    if (response.status === 204)
+        return undefined;
+    const contentType = response.headers.get('content-type') ?? '';
+    if (contentType.includes('application/json'))
+        return await response.json();
+    return undefined;
+}
+async function dbxRequestBytes(options, method, path) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const token = typeof options.token === 'function' ? await options.token() : options.token;
+    const url = new URL(`${options.host.replace(/\/$/, '')}${path}`);
+    const response = await fetchImpl(url, { method, headers: { authorization: `Bearer ${token}` } });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`databricks-volume: ${method} ${path} -> ${response.status} ${response.statusText}: ${text.slice(0, 500)}`);
+    }
+    return new Uint8Array(await response.arrayBuffer());
+}
+//# sourceMappingURL=databricks-volume.js.map

package/dist/databricks-volume.js.map

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

package/dist/gcs.d.ts

@@ -0,0 +1,38 @@
+import type { FilesystemSource } from '@fabric-harness/sdk';
+/**
+ * Concrete Google Cloud Storage connector backed by `@google-cloud/storage`.
+ *
+ * Install peer dep:
+ * ```sh
+ * npm install @google-cloud/storage
+ * ```
+ */
+export interface GcsSourceOptions {
+    bucket: string;
+    prefix?: string;
+    stripPrefix?: string;
+    include?: (name: string) => boolean;
+    name?: string;
+    /** GCP project id. Falls back to ADC. */
+    projectId?: string;
+    /** Path to service account key JSON. */
+    keyFilename?: string;
+    /** Pre-built `Storage` instance. Overrides projectId/keyFilename. */
+    client?: unknown;
+}
+export declare function gcsSource(options: GcsSourceOptions): FilesystemSource;
+export interface GcsWriterOptions extends Omit<GcsSourceOptions, 'prefix' | 'stripPrefix' | 'include' | 'name'> {
+    prefix?: string;
+}
+export interface GcsWriter {
+    put(name: string, content: string | Uint8Array, options?: {
+        contentType?: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        name: string;
+        bucket: string;
+    }>;
+    delete(name: string): Promise<void>;
+}
+export declare function gcsWriter(options: GcsWriterOptions): GcsWriter;
+//# sourceMappingURL=gcs.d.ts.map

package/dist/gcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../src/gcs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI7E;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAWD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CA+BrE;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAkB9D"}

package/dist/gcs.js

@@ -0,0 +1,86 @@
+import { createRequire } from 'node:module';
+const requireFromHere = createRequire(import.meta.url);
+export function gcsSource(options) {
+    const bucket = createBucket(options);
+    const prefix = options.prefix ?? '';
+    const stripPrefix = options.stripPrefix ?? prefix;
+    const include = options.include ?? (() => true);
+    return {
+        name: options.name ?? `gcs:${options.bucket}/${prefix}`,
+        async *entries() {
+            let pageToken;
+            do {
+                const [files, query] = await bucket.getFiles({ ...(prefix ? { prefix } : {}), ...(pageToken ? { pageToken } : {}) });
+                for (const file of files) {
+                    if (!include(file.name))
+                        continue;
+                    const relative = file.name.startsWith(stripPrefix) ? file.name.slice(stripPrefix.length) : file.name;
+                    if (!relative)
+                        continue;
+                    const [buffer] = await file.download();
+                    yield {
+                        path: relative.replace(/^\/+/, ''),
+                        content: new Uint8Array(buffer),
+                        metadata: {
+                            key: file.name,
+                            ...(file.metadata?.size !== undefined ? { size: Number(file.metadata.size) } : {}),
+                            ...(file.metadata?.contentType ? { contentType: file.metadata.contentType } : {}),
+                            ...(file.metadata?.updated ? { lastModified: file.metadata.updated } : {}),
+                        },
+                    };
+                }
+                pageToken = query?.pageToken;
+            } while (pageToken);
+        },
+    };
+}
+export function gcsWriter(options) {
+    const bucket = createBucket(options);
+    const prefix = options.prefix ?? '';
+    const fullName = (name) => `${prefix}${name.replace(/^\/+/, '')}`;
+    return {
+        async put(name, content, putOptions) {
+            const file = bucket.file(fullName(name));
+            const data = typeof content === 'string' ? new TextEncoder().encode(content) : content;
+            const saveOptions = {};
+            if (putOptions?.contentType)
+                saveOptions.contentType = putOptions.contentType;
+            if (putOptions?.metadata)
+                saveOptions.metadata = { metadata: putOptions.metadata };
+            await file.save(data, saveOptions);
+            return { name: fullName(name), bucket: options.bucket };
+        },
+        async delete(name) {
+            await bucket.file(fullName(name)).delete();
+        },
+    };
+}
+function createBucket(options) {
+    if (options.client) {
+        const client = options.client;
+        if (typeof client.bucket !== 'function')
+            throw new Error('gcsSource: provided `client` does not implement bucket(name).');
+        return client.bucket(options.bucket);
+    }
+    const mod = loadGcsModule();
+    const config = {};
+    if (options.projectId)
+        config.projectId = options.projectId;
+    if (options.keyFilename)
+        config.keyFilename = options.keyFilename;
+    return new mod.Storage(config).bucket(options.bucket);
+}
+let cachedModule;
+function loadGcsModule() {
+    if (cachedModule)
+        return cachedModule;
+    try {
+        const mod = requireFromHere('@google-cloud/storage');
+        cachedModule = mod;
+        return mod;
+    }
+    catch {
+        throw new Error('gcsSource/gcsWriter requires the `@google-cloud/storage` peer dependency. Install it with: npm install @google-cloud/storage');
+    }
+}
+//# sourceMappingURL=gcs.js.map

package/dist/gcs.js.map

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

package/dist/github.d.ts

@@ -0,0 +1,30 @@
+import type { FilesystemSource } from '@fabric-harness/sdk';
+/**
+ * Read-only GitHub repository connector backed by `octokit`.
+ *
+ * Mounts a repository (at a given ref) as files inside the sandbox.
+ * Uses the Git Trees API in recursive mode for efficient enumeration.
+ *
+ * Install peer dep:
+ * ```sh
+ * npm install octokit
+ * ```
+ */
+export interface GithubSourceOptions {
+    owner: string;
+    repo: string;
+    /** Branch name, tag, or commit SHA. Defaults to the repo's default branch. */
+    ref?: string;
+    /** Path within the repo to mount. Defaults to repo root. */
+    path?: string;
+    /** Filter applied to each repo-relative path. */
+    include?: (path: string) => boolean;
+    /** Stable name for telemetry / logs. */
+    name?: string;
+    /** Personal access token. Falls back to `GITHUB_TOKEN` env. */
+    token?: string;
+    /** Pre-built Octokit instance. Overrides `token`. */
+    client?: unknown;
+}
+export declare function githubSource(options: GithubSourceOptions): FilesystemSource;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI7E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CA2C3E"}

package/dist/github.js

@@ -0,0 +1,100 @@
+import { createRequire } from 'node:module';
+const requireFromHere = createRequire(import.meta.url);
+export function githubSource(options) {
+    const octokit = createOctokit(options);
+    const include = options.include ?? (() => true);
+    const subpath = (options.path ?? '').replace(/^\/+|\/+$/g, '');
+    const ref = options.ref;
+    return {
+        name: options.name ?? `github:${options.owner}/${options.repo}@${ref ?? 'default'}/${subpath}`,
+        async *entries() {
+            const resolvedSha = await resolveTreeSha(octokit, options.owner, options.repo, ref);
+            const treeResponse = await octokit.request('GET /repos/{owner}/{repo}/git/trees/{tree_sha}', {
+                owner: options.owner,
+                repo: options.repo,
+                tree_sha: resolvedSha,
+                recursive: '1',
+            });
+            const tree = treeResponse.data.tree ?? [];
+            for (const entry of tree) {
+                if (entry.type !== 'blob' || !entry.path || !entry.sha)
+                    continue;
+                if (subpath && !entry.path.startsWith(`${subpath}/`) && entry.path !== subpath)
+                    continue;
+                const relative = subpath ? entry.path.slice(subpath.length).replace(/^\/+/, '') : entry.path;
+                if (!relative)
+                    continue;
+                if (!include(relative))
+                    continue;
+                const blob = await octokit.request('GET /repos/{owner}/{repo}/git/blobs/{file_sha}', {
+                    owner: options.owner,
+                    repo: options.repo,
+                    file_sha: entry.sha,
+                });
+                const data = blob.data;
+                if (typeof data.content !== 'string')
+                    continue;
+                const content = data.encoding === 'base64' ? new Uint8Array(Buffer.from(data.content, 'base64')) : new TextEncoder().encode(data.content);
+                yield {
+                    path: relative,
+                    content,
+                    metadata: {
+                        key: entry.path,
+                        sha: entry.sha,
+                        ...(entry.size !== undefined ? { size: entry.size } : {}),
+                        ...(ref ? { ref } : {}),
+                    },
+                };
+            }
+        },
+    };
+}
+async function resolveTreeSha(octokit, owner, repo, ref) {
+    if (ref && /^[0-9a-f]{40}$/i.test(ref))
+        return ref;
+    const branch = ref ?? await defaultBranch(octokit, owner, repo);
+    const refResponse = await octokit.request('GET /repos/{owner}/{repo}/commits/{ref}', { owner, repo, ref: branch });
+    const sha = refResponse.data.commit?.tree?.sha;
+    if (!sha)
+        throw new Error(`githubSource: could not resolve tree sha for ${owner}/${repo}@${branch}`);
+    return sha;
+}
+async function defaultBranch(octokit, owner, repo) {
+    const response = await octokit.request('GET /repos/{owner}/{repo}', { owner, repo });
+    const branch = response.data.default_branch;
+    if (!branch)
+        throw new Error(`githubSource: ${owner}/${repo} has no default_branch`);
+    return branch;
+}
+function createOctokit(options) {
+    if (options.client) {
+        const client = options.client;
+        if (typeof client.request !== 'function')
+            throw new Error('githubSource: provided `client` does not implement request().');
+        return client;
+    }
+    const mod = loadOctokitModule();
+    const token = options.token ?? process.env.GITHUB_TOKEN;
+    return new mod.Octokit(token ? { auth: token } : {});
+}
+let cachedModule;
+function loadOctokitModule() {
+    if (cachedModule)
+        return cachedModule;
+    try {
+        const mod = requireFromHere('octokit');
+        cachedModule = mod;
+        return mod;
+    }
+    catch {
+        try {
+            const rest = requireFromHere('@octokit/rest');
+            cachedModule = rest;
+            return rest;
+        }
+        catch {
+            throw new Error('githubSource requires the `octokit` (or `@octokit/rest`) peer dependency. Install it with: npm install octokit');
+        }
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

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

package/dist/k8s.d.ts

@@ -0,0 +1,62 @@
+import type { FileStat, SandboxEnv } from '@fabric-harness/sdk';
+import type { RemoteAdapterOptions } from './index.js';
+/**
+ * Structural Kubernetes pod adapter. The caller wires up
+ * `@kubernetes/client-node` (or any SPDY/exec-capable client) and supplies
+ * an object that satisfies `KubernetesPodLike`.
+ *
+ * Why structural: cluster auth, RBAC, and the exec wire format vary too
+ * much across environments (in-cluster, kubeconfig, AKS managed identity,
+ * GKE Workload Identity, EKS IRSA, …) for a single concrete adapter to be
+ * sensible. Pattern matches `daytonaSandbox` / `e2bSandbox`.
+ *
+ * For Azure-hosted clusters use the higher-level `aksSandbox()` from
+ * `@fabric-harness/azure`, which wires this adapter to Azure-managed
+ * credentials.
+ */
+export interface KubernetesPodLike {
+    /** Run a shell command inside the pod. */
+    exec(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeoutMs?: number;
+    }): Promise<{
+        stdout?: string;
+        stderr?: string;
+        exitCode?: number;
+    }>;
+    /** Read a file's bytes. May implement via `kubectl cp` or `cat`+base64. */
+    readFile(path: string): Promise<Uint8Array>;
+    /** Write content to a file. */
+    writeFile(path: string, content: Uint8Array): Promise<void>;
+    /** Optional: implement stat (default falls back to `stat -c` via exec). */
+    stat?(path: string): Promise<FileStat | null>;
+    /** Optional: delete the pod when the sandbox is cleaned up. */
+    delete?(): Promise<void> | void;
+}
+export interface KubernetesSandboxOptions extends RemoteAdapterOptions {
+    /** Working directory inside the pod. Defaults to `/workspace`. */
+    cwd?: string;
+}
+export declare function kubernetesSandbox(pod: KubernetesPodLike, options?: KubernetesSandboxOptions): SandboxEnv;
+/**
+ * Convenience helper: build a `KubernetesPodLike` from a `@kubernetes/client-node`
+ * `KubeConfig` plus pod identity. Suitable when `kubectl` already gets you in
+ * the door — for AKS, prefer `aksSandbox()` from `@fabric-harness/azure`.
+ *
+ * Files are transferred over `exec` using base64-encoded `cat` / `tee`. Works
+ * for text and small binaries; for large objects mount external storage via
+ * `s3Source` / `gcsSource` / `azureBlobSource` instead.
+ */
+export interface CreateKubernetesPodOptions {
+    /** A `KubeConfig` instance from `@kubernetes/client-node`. */
+    kubeConfig: unknown;
+    namespace: string;
+    podName: string;
+    /** Container name inside the pod. Defaults to the first container. */
+    container?: string;
+    /** If true, delete the pod when `cleanup()` runs. */
+    ownsPod?: boolean;
+}
+export declare function createKubernetesPod(options: CreateKubernetesPodOptions): KubernetesPodLike;
+//# sourceMappingURL=k8s.d.ts.map

package/dist/k8s.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s.d.ts","sourceRoot":"","sources":["../src/k8s.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAoB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtK,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,+BAA+B;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,2EAA2E;IAC3E,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC9C,+DAA+D;IAC/D,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,GAAE,wBAA6B,GAAG,UAAU,CAmE5G;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,0BAA0B;IACzC,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,iBAAiB,CAsD1F"}

package/dist/k8s.js

@@ -0,0 +1,155 @@
+import { createRequire } from 'node:module';
+import { createRemoteSandboxEnv } from '@fabric-harness/sdk';
+const requireFromHere = createRequire(import.meta.url);
+export function kubernetesSandbox(pod, options = {}) {
+    const api = {
+        async exec(command, execOptions) {
+            const runOptions = {};
+            if (execOptions?.cwd !== undefined)
+                runOptions.cwd = execOptions.cwd;
+            if (execOptions?.env !== undefined)
+                runOptions.env = execOptions.env;
+            if (execOptions?.timeout !== undefined)
+                runOptions.timeoutMs = execOptions.timeout;
+            const result = await pod.exec(command, runOptions);
+            return { command, exitCode: result.exitCode ?? 0, stdout: result.stdout ?? '', stderr: result.stderr ?? '' };
+        },
+        async readFile(path) {
+            return new TextDecoder().decode(await pod.readFile(path));
+        },
+        async readFileBuffer(path) {
+            return pod.readFile(path);
+        },
+        async writeFile(path, content) {
+            const data = typeof content === 'string' ? new TextEncoder().encode(content) : content;
+            await pod.writeFile(path, data);
+        },
+        async stat(path) {
+            if (pod.stat) {
+                const result = await pod.stat(path);
+                if (result)
+                    return result;
+            }
+            const result = await pod.exec(`stat -c '%F %s' ${shellQuote(path)} 2>/dev/null || echo MISSING`);
+            const stdout = (result.stdout ?? '').trim();
+            if (stdout === 'MISSING' || result.exitCode !== 0)
+                throw new Error(`No such file or directory: ${path}`);
+            const [type, sizeRaw] = stdout.split(' ');
+            const size = Number.parseInt(sizeRaw ?? '0', 10);
+            return {
+                type: type?.includes('directory') ? 'directory' : type?.includes('symbolic') ? 'symlink' : 'file',
+                size: Number.isFinite(size) ? size : 0,
+            };
+        },
+        async readdir(path) {
+            const result = await pod.exec(`ls -1 ${shellQuote(path)}`);
+            if (result.exitCode !== 0)
+                throw new Error(result.stderr ?? `readdir failed: ${path}`);
+            return (result.stdout ?? '').split('\n').filter((line) => line.length > 0);
+        },
+        async exists(path) {
+            const result = await pod.exec(`test -e ${shellQuote(path)}`);
+            return result.exitCode === 0;
+        },
+        async mkdir(path, mkdirOptions) {
+            const flag = mkdirOptions?.recursive ? '-p' : '';
+            const result = await pod.exec(`mkdir ${flag} ${shellQuote(path)}`.trim());
+            if (result.exitCode !== 0)
+                throw new Error(result.stderr ?? `mkdir failed: ${path}`);
+        },
+        async rm(path, rmOptions) {
+            const flagChars = `${rmOptions?.recursive ? 'r' : ''}${rmOptions?.force ? 'f' : ''}`;
+            const flag = flagChars ? `-${flagChars} ` : '';
+            const result = await pod.exec(`rm ${flag}${shellQuote(path)}`.replace(/\s+/g, ' '));
+            if (result.exitCode !== 0 && !rmOptions?.force)
+                throw new Error(result.stderr ?? `rm failed: ${path}`);
+        },
+    };
+    const podDelete = pod.delete;
+    const cleanup = options.cleanup === true && podDelete
+        ? async () => { await podDelete.call(pod); }
+        : typeof options.cleanup === 'function'
+            ? async () => { await options.cleanup(); }
+            : undefined;
+    return createRemoteSandboxEnv(api, {
+        cwd: options.cwd ?? '/workspace',
+        ...(options.capabilities ? { capabilities: options.capabilities } : {}),
+        ...(cleanup ? { cleanup } : {}),
+    });
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+export function createKubernetesPod(options) {
+    const { Exec, CoreV1Api } = loadK8sModule();
+    const kc = options.kubeConfig;
+    const exec = new Exec(kc);
+    const core = kc.makeApiClient(CoreV1Api);
+    async function runExec(command) {
+        let stdout = '';
+        let stderr = '';
+        const stdoutStream = makeWritable((chunk) => { stdout += chunk.toString('utf8'); });
+        const stderrStream = makeWritable((chunk) => { stderr += chunk.toString('utf8'); });
+        const status = await new Promise((resolve, reject) => {
+            void exec.exec(options.namespace, options.podName, options.container ?? '', command, stdoutStream, stderrStream, null, false, (s) => resolve(s)).catch(reject);
+        });
+        const exitCode = status?.status === 'Success' ? 0 : (status?.code ?? 1);
+        return { stdout, stderr, exitCode };
+    }
+    return {
+        async exec(command, runOptions) {
+            const wrapped = runOptions?.cwd
+                ? `cd ${shellQuote(runOptions.cwd)} && ${envPrefix(runOptions.env)}${command}`
+                : `${envPrefix(runOptions?.env)}${command}`;
+            return runExec(['sh', '-c', wrapped]);
+        },
+        async readFile(path) {
+            const { stdout, exitCode, stderr } = await runExec(['sh', '-c', `base64 -w0 ${shellQuote(path)} 2>/dev/null || base64 ${shellQuote(path)}`]);
+            if (exitCode !== 0)
+                throw new Error(stderr || `readFile failed: ${path}`);
+            return new Uint8Array(Buffer.from(stdout.trim(), 'base64'));
+        },
+        async writeFile(path, content) {
+            const encoded = Buffer.from(content).toString('base64');
+            const { exitCode, stderr } = await runExec(['sh', '-c', `mkdir -p "$(dirname ${shellQuote(path)})" && printf '%s' ${shellQuote(encoded)} | base64 -d > ${shellQuote(path)}`]);
+            if (exitCode !== 0)
+                throw new Error(stderr || `writeFile failed: ${path}`);
+        },
+        async delete() {
+            if (!options.ownsPod)
+                return;
+            try {
+                await core.deleteNamespacedPod(options.podName, options.namespace);
+            }
+            catch {
+                /* best-effort cleanup */
+            }
+        },
+    };
+}
+function envPrefix(env) {
+    if (!env)
+        return '';
+    return Object.entries(env).map(([k, v]) => `${k}=${shellQuote(v)} `).join('');
+}
+function makeWritable(onChunk) {
+    return {
+        write(chunk) { onChunk(typeof chunk === 'string' ? Buffer.from(chunk) : chunk); return true; },
+        end() { },
+        on() { },
+    };
+}
+let cachedK8sModule;
+function loadK8sModule() {
+    if (cachedK8sModule)
+        return cachedK8sModule;
+    try {
+        const mod = requireFromHere('@kubernetes/client-node');
+        cachedK8sModule = mod;
+        return mod;
+    }
+    catch {
+        throw new Error('createKubernetesPod requires the `@kubernetes/client-node` peer dependency. Install it with: npm install @kubernetes/client-node');
+    }
+}
+//# sourceMappingURL=k8s.js.map

package/dist/k8s.js.map

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

package/dist/s3.d.ts

@@ -0,0 +1,78 @@
+import type { FilesystemSource } from '@fabric-harness/sdk';
+/**
+ * Concrete S3 connector backed by `@aws-sdk/client-s3`. Users pass bucket
+ * config; this module constructs the SDK client internally and adapts it to
+ * Fabric Harness's `FilesystemSource` contract.
+ *
+ * Install peer dep:
+ * ```sh
+ * npm install @aws-sdk/client-s3
+ * ```
+ *
+ * Usage:
+ * ```ts
+ * import { s3Source } from '@fabric-harness/connectors/s3';
+ *
+ * const source = s3Source({ bucket: 'my-logs', prefix: '2026/' });
+ * await session.mount('/mnt/logs', source);
+ * ```
+ */
+export interface S3SourceOptions {
+    /** Bucket name. Required. */
+    bucket: string;
+    /** Optional key prefix to scope listing. */
+    prefix?: string;
+    /** Override prefix-stripping behavior in mounted paths. Defaults to `prefix`. */
+    stripPrefix?: string;
+    /** Filter applied to each listed key. Return false to skip. */
+    include?: (key: string) => boolean;
+    /** Page size for ListObjectsV2 (defaults to AWS SDK default). */
+    pageSize?: number;
+    /** Stable name for telemetry / logs. */
+    name?: string;
+    /** AWS region. Falls back to AWS SDK default chain. */
+    region?: string;
+    /** Custom endpoint (e.g. for LocalStack, MinIO, s3mock). */
+    endpoint?: string;
+    /** Force path-style addressing. Required for most S3-compatible services. */
+    forcePathStyle?: boolean;
+    /** Static credentials. Falls back to AWS SDK default credential chain. */
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+        sessionToken?: string;
+    };
+    /** Pre-built S3Client. Overrides region/endpoint/credentials when provided. */
+    client?: unknown;
+}
+/**
+ * Read-only S3 connector. Mount with `session.mount(mountAt, s3Source(...))`.
+ *
+ * The agent's built-in `read`, `grep`, `glob`, and `bash` tools then operate
+ * over the mounted prefix as if it were a local directory.
+ */
+export declare function s3Source(options: S3SourceOptions): FilesystemSource;
+/**
+ * Write-side helper for S3. Use to publish artifacts or mount a writable view.
+ *
+ * ```ts
+ * const writer = s3Writer({ bucket: 'reports' });
+ * await writer.put('2026/05/06/summary.md', summary);
+ * ```
+ */
+export interface S3WriterOptions extends Omit<S3SourceOptions, 'prefix' | 'stripPrefix' | 'include' | 'pageSize' | 'name'> {
+    /** Default prefix prepended to every put/delete key. */
+    prefix?: string;
+}
+export interface S3Writer {
+    put(key: string, content: string | Uint8Array, options?: {
+        contentType?: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        key: string;
+        bucket: string;
+    }>;
+    delete(key: string): Promise<void>;
+}
+export declare function s3Writer(options: S3WriterOptions): S3Writer;
+//# sourceMappingURL=s3.d.ts.map

package/dist/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../src/s3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK5D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,WAAW,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAkBD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAyCnE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACxH,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAmB3D"}

package/dist/s3.js

@@ -0,0 +1,114 @@
+import { createRequire } from 'node:module';
+import { s3FilesystemSource } from './index.js';
+const requireFromHere = createRequire(import.meta.url);
+/**
+ * Read-only S3 connector. Mount with `session.mount(mountAt, s3Source(...))`.
+ *
+ * The agent's built-in `read`, `grep`, `glob`, and `bash` tools then operate
+ * over the mounted prefix as if it were a local directory.
+ */
+export function s3Source(options) {
+    const client = createS3Client(options);
+    return s3FilesystemSource({
+        async listObjects(listOpts) {
+            const input = { Bucket: options.bucket };
+            if (listOpts?.prefix)
+                input.Prefix = listOpts.prefix;
+            if (listOpts?.continuationToken)
+                input.ContinuationToken = listOpts.continuationToken;
+            if (listOpts?.maxKeys)
+                input.MaxKeys = listOpts.maxKeys;
+            const command = await buildCommand('ListObjectsV2Command', input);
+            const response = await client.send(command);
+            return {
+                objects: (response.Contents ?? [])
+                    .filter((c) => typeof c.Key === 'string')
+                    .map((c) => ({
+                    key: c.Key,
+                    ...(c.Size !== undefined ? { size: c.Size } : {}),
+                    ...(c.LastModified !== undefined ? { lastModified: c.LastModified } : {}),
+                })),
+                ...(response.NextContinuationToken ? { nextContinuationToken: response.NextContinuationToken } : {}),
+            };
+        },
+        async getObject(key) {
+            const command = await buildCommand('GetObjectCommand', { Bucket: options.bucket, Key: key });
+            const response = await client.send(command);
+            if (!response.Body)
+                return null;
+            return {
+                body: response.Body,
+                ...(response.ContentType ? { contentType: response.ContentType } : {}),
+                ...(response.Metadata ? { metadata: response.Metadata } : {}),
+            };
+        },
+    }, {
+        ...(options.prefix !== undefined ? { prefix: options.prefix } : {}),
+        ...(options.stripPrefix !== undefined ? { stripPrefix: options.stripPrefix } : {}),
+        ...(options.include !== undefined ? { include: options.include } : {}),
+        ...(options.pageSize !== undefined ? { pageSize: options.pageSize } : {}),
+        name: options.name ?? `s3:${options.bucket}/${options.prefix ?? ''}`,
+    });
+}
+export function s3Writer(options) {
+    const client = createS3Client(options);
+    const prefix = options.prefix ?? '';
+    const fullKey = (key) => `${prefix}${key.replace(/^\/+/, '')}`;
+    return {
+        async put(key, content, putOptions) {
+            const Body = typeof content === 'string' ? new TextEncoder().encode(content) : content;
+            const input = { Bucket: options.bucket, Key: fullKey(key), Body };
+            if (putOptions?.contentType)
+                input.ContentType = putOptions.contentType;
+            if (putOptions?.metadata)
+                input.Metadata = putOptions.metadata;
+            const command = await buildCommand('PutObjectCommand', input);
+            await client.send(command);
+            return { key: fullKey(key), bucket: options.bucket };
+        },
+        async delete(key) {
+            const command = await buildCommand('DeleteObjectCommand', { Bucket: options.bucket, Key: fullKey(key) });
+            await client.send(command);
+        },
+    };
+}
+function createS3Client(options) {
+    if (options.client) {
+        if (typeof options.client.send !== 'function') {
+            throw new Error('s3Source: provided `client` does not implement `send()`. Pass an `@aws-sdk/client-s3` `S3Client` instance.');
+        }
+        return options.client;
+    }
+    const { S3Client } = loadS3Module();
+    const config = {};
+    if (options.region)
+        config.region = options.region;
+    if (options.endpoint)
+        config.endpoint = options.endpoint;
+    if (options.forcePathStyle !== undefined)
+        config.forcePathStyle = options.forcePathStyle;
+    if (options.credentials)
+        config.credentials = options.credentials;
+    return new S3Client(config);
+}
+async function buildCommand(name, input) {
+    const mod = loadS3Module();
+    const Ctor = mod[name];
+    if (!Ctor)
+        throw new Error(`s3Source: @aws-sdk/client-s3 is missing ${name}. Update the peer dependency.`);
+    return new Ctor(input);
+}
+let cachedS3Module;
+function loadS3Module() {
+    if (cachedS3Module)
+        return cachedS3Module;
+    try {
+        const mod = requireFromHere('@aws-sdk/client-s3');
+        cachedS3Module = mod;
+        return mod;
+    }
+    catch {
+        throw new Error('s3Source/s3Writer requires the `@aws-sdk/client-s3` peer dependency. Install it with: npm install @aws-sdk/client-s3');
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/s3.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabric-harness/connectors",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Connector recipes (sandbox, mcp, data) for Fabric Harness — markdown-based provider integrations.",
   "license": "Apache-2.0",
   "author": "Fabric",
@@ -31,15 +31,74 @@
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./s3": {
+      "types": "./dist/s3.d.ts",
+      "import": "./dist/s3.js"
+    },
+    "./azure-blob": {
+      "types": "./dist/azure-blob.d.ts",
+      "import": "./dist/azure-blob.js"
+    },
+    "./gcs": {
+      "types": "./dist/gcs.d.ts",
+      "import": "./dist/gcs.js"
+    },
+    "./github": {
+      "types": "./dist/github.d.ts",
+      "import": "./dist/github.js"
+    },
+    "./databricks-volume": {
+      "types": "./dist/databricks-volume.d.ts",
+      "import": "./dist/databricks-volume.js"
+    },
+    "./k8s": {
+      "types": "./dist/k8s.d.ts",
+      "import": "./dist/k8s.js"
+    }
+  },
   "files": [
     "dist",
     "README.md",
     "LICENSE"
   ],
   "dependencies": {
-    "@fabric-harness/sdk": "0.5.0"
+    "@fabric-harness/sdk": "0.6.0"
+  },
+  "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",
+    "octokit": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@azure/storage-blob": {
+      "optional": true
+    },
+    "@google-cloud/storage": {
+      "optional": true
+    },
+    "@kubernetes/client-node": {
+      "optional": true
+    },
+    "octokit": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@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",
+    "octokit": "^4.0.0",
     "typescript": "^5.8.3",
     "vitest": "^4.1.5"
   },