@relkit/langchain 0.0.0-stage → 0.7.11

package/dist/deepagent-bucket-backend.js

@@ -0,0 +1,47 @@
+/** Adapts a configured RELKIT bucket to the DeepAgents file backend, sharing the invocation scope and preserving bucket failures at the native adapter. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { deepAgentBucketFailure } from "./deepagent-bucket-error.js";
+import { createBucketContext } from "./deepagent-bucket-files.js";
+import { readBucket, readBucketRaw } from "./deepagent-bucket-read.js";
+import { writeBucket, editBucket } from "./deepagent-bucket-write.js";
+import { uploadBucketFiles, downloadBucketFiles } from "./deepagent-bucket-transfer.js";
+import { listDirectory } from "./deepagent-bucket-search.js";
+import { globFiles } from "./deepagent-bucket-glob.js";
+import { grepFiles } from "./deepagent-bucket-grep.js";
+import { removeBucketPath } from "./deepagent-bucket-delete.js";
+/** Builds a DeepAgents backend from a RELKIT bucket client.
+ * @param bucket - Bucket client that owns the backend's files.
+ * @param options - Optional key prefix.
+ * @returns An Effect with a frozen backend or DeepAgentBucketFailure.
+ * @example Effect.runSync(createDeepAgentBucketBackendEffect(bucket));
+ */
+export const createDeepAgentBucketBackendEffect = Effect.fn("Agents.bucket.create")(function* (bucket, options = {}) {
+    const context = yield* Effect.try({
+        try: () => createBucketContext(bucket, options.prefix),
+        catch: deepAgentBucketFailure,
+    });
+    return Object.freeze({
+        ls: (path) => listDirectory(context, path),
+        read: (path, offset, limit) => readBucket(context, path, offset, limit),
+        readRaw: (path) => readBucketRaw(context, path),
+        write: (path, content) => writeBucket(context, path, content),
+        edit: (path, oldText, newText, replaceAll = false) => editBucket(context, path, oldText, newText, replaceAll),
+        grep: (pattern, path, glob, maxCount) => grepFiles(context, pattern, path, glob, maxCount),
+        glob: (pattern, path) => globFiles(context, pattern, path),
+        delete: (path) => removeBucketPath(context, path),
+        uploadFiles: (files) => uploadBucketFiles(context, files),
+        downloadFiles: (paths) => downloadBucketFiles(context, paths),
+    });
+}, (effect) => observeAgent("bucket.create", effect));
+/** Creates a backend for existing synchronous callers.
+ * @param bucket - Bucket client that owns the backend's files.
+ * @param options - Optional key prefix.
+ * @returns A frozen DeepAgents backend.
+ * @throws The original invalid bucket or prefix error.
+ * @example const backend = createDeepAgentBucketBackend(bucket);
+ */
+export function createDeepAgentBucketBackend(bucket, options = {}) {
+    return Effect.runSync(createDeepAgentBucketBackendEffect(bucket, options).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => Effect.fail(failure.cause))));
+}
+//# sourceMappingURL=deepagent-bucket-backend.js.map

package/dist/deepagent-bucket-backend.js.map

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

package/dist/deepagent-bucket-backend.types.d.ts

@@ -0,0 +1,6 @@
+/** Configuration for a DeepAgents backend bound to a RELKIT bucket. */
+export interface DeepAgentBucketBackendOptions {
+    /** Key prefix owned by this backend instance. */
+    readonly prefix?: string;
+}
+//# sourceMappingURL=deepagent-bucket-backend.types.d.ts.map

package/dist/deepagent-bucket-backend.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-backend.types.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-backend.types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,WAAW,6BAA6B;IAC5C,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/deepagent-bucket-backend.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deepagent-bucket-backend.types.js.map

package/dist/deepagent-bucket-backend.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-backend.types.js","sourceRoot":"","sources":["../src/deepagent-bucket-backend.types.ts"],"names":[],"mappings":""}

package/dist/deepagent-bucket-client.types.d.ts

@@ -0,0 +1,25 @@
+/** Defines the SDK-independent bucket IO boundary shared by ordinary runtime options and DeepAgents backends. */
+/** Bucket client and prefix bound to one DeepAgents backend. */
+export interface DeepAgentBucketContext {
+    readonly bucket: DeepAgentBucketClient;
+    readonly prefix: string;
+}
+/** Metadata needed to expose a bucket object as a virtual file. */
+export interface DeepAgentBucketMetadata {
+    readonly contentType?: string;
+    readonly size?: number;
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+/** IO operations required by the DeepAgents bucket bridge. */
+export interface DeepAgentBucketClient {
+    readonly put: (key: string, bytes: Uint8Array, options?: {
+        readonly contentType?: string;
+        readonly metadata?: Readonly<Record<string, string>>;
+    }) => Promise<void>;
+    readonly get: (key: string) => Promise<Uint8Array | undefined>;
+    readonly head: (key: string) => Promise<DeepAgentBucketMetadata | undefined>;
+    readonly delete: (key: string) => Promise<void>;
+    readonly exists: (key: string) => Promise<boolean>;
+    readonly list: (prefix?: string) => Promise<readonly string[]>;
+}
+//# sourceMappingURL=deepagent-bucket-client.types.d.ts.map

package/dist/deepagent-bucket-client.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-client.types.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-client.types.ts"],"names":[],"mappings":"AAAA,iHAAiH;AAEjH,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,CACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KACtD,KACE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;IAC7E,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CAChE"}

package/dist/deepagent-bucket-client.types.js

@@ -0,0 +1,3 @@
+/** Defines the SDK-independent bucket IO boundary shared by ordinary runtime options and DeepAgents backends. */
+export {};
+//# sourceMappingURL=deepagent-bucket-client.types.js.map

package/dist/deepagent-bucket-client.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-client.types.js","sourceRoot":"","sources":["../src/deepagent-bucket-client.types.ts"],"names":[],"mappings":"AAAA,iHAAiH"}

package/dist/deepagent-bucket-delete.d.ts

@@ -0,0 +1,28 @@
+/** Deletes normalized DeepAgents file paths through the selected bucket service and reports native file-operation results without changing unrelated keys. */
+import type { DeleteResult } from "deepagents";
+import { Effect } from "effect";
+import { DeepAgentBucket } from "./deepagent-bucket-service.js";
+import { type DeepAgentBucketContext } from "./deepagent-bucket-files.js";
+/** Removes a virtual file or directory with at most eight bucket requests in flight.
+ * @param path - Virtual path to remove; root removes every key in the backend prefix.
+ * @returns An Effect with the delete result or a tagged bucket failure.
+ * @example Effect.runPromise(Effect.provide(removeBucketPathEffect("/notes"), deepAgentBucketLayer(context)));
+ */
+export declare const removeBucketPathEffect: (path: string) => Effect.Effect<{
+    error: string;
+    path?: never;
+    filesUpdate?: never;
+} | {
+    path: string;
+    filesUpdate: null;
+    error?: never;
+}, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
+/** Removes a bucket path for existing DeepAgents Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param path - Virtual file or directory path.
+ * @returns The removed path or a legacy error result.
+ * @throws A cancellation or timeout failure from the bucket client.
+ * @example await removeBucketPath(context, "/notes");
+ */
+export declare function removeBucketPath(context: DeepAgentBucketContext, path: string): Promise<DeleteResult>;
+//# sourceMappingURL=deepagent-bucket-delete.d.ts.map

package/dist/deepagent-bucket-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-delete.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-delete.ts"],"names":[],"mappings":"AAAA,8JAA8J;AAE9J,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAwB,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAKL,KAAK,sBAAsB,EAC5B,MAAM,6BAA6B,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;iFAiClC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,CAWvB"}

package/dist/deepagent-bucket-delete.js

@@ -0,0 +1,64 @@
+/** Deletes normalized DeepAgents file paths through the selected bucket service and reports native file-operation results without changing unrelated keys. */
+import { Effect, Result } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { deepAgentBucketFailure } from "./deepagent-bucket-error.js";
+import { DeepAgentBucket, deepAgentBucketLayer } from "./deepagent-bucket-service.js";
+import { bucketKey, errorMessage, isControlFailure, virtualPath, } from "./deepagent-bucket-files.js";
+/** Removes a virtual file or directory with at most eight bucket requests in flight.
+ * @param path - Virtual path to remove; root removes every key in the backend prefix.
+ * @returns An Effect with the delete result or a tagged bucket failure.
+ * @example Effect.runPromise(Effect.provide(removeBucketPathEffect("/notes"), deepAgentBucketLayer(context)));
+ */
+export const removeBucketPathEffect = Effect.fn("Agents.bucket.delete")(function* (path) {
+    const context = yield* DeepAgentBucket;
+    const normalized = yield* Effect.try({
+        try: () => (path === "/" ? "/" : virtualPath(path)),
+        catch: deepAgentBucketFailure,
+    });
+    const keys = normalized === "/"
+        ? yield* Effect.tryPromise({
+            try: () => context.bucket.list(`${context.prefix}/`),
+            catch: deepAgentBucketFailure,
+        })
+        : yield* deletionKeys(context, normalized);
+    if (keys.length === 0) {
+        return { error: `Error: File '${normalized}' not found` };
+    }
+    const outcomes = yield* Effect.forEach(keys, (key) => Effect.result(Effect.tryPromise({
+        try: () => context.bucket.delete(key),
+        catch: deepAgentBucketFailure,
+    })), { concurrency: 8 });
+    const firstFailure = outcomes.find(Result.isFailure);
+    if (firstFailure !== undefined)
+        return yield* Effect.fail(firstFailure.failure);
+    return { path: normalized, filesUpdate: null };
+}, (effect) => observeAgent("bucket.delete", effect));
+/** Removes a bucket path for existing DeepAgents Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param path - Virtual file or directory path.
+ * @returns The removed path or a legacy error result.
+ * @throws A cancellation or timeout failure from the bucket client.
+ * @example await removeBucketPath(context, "/notes");
+ */
+export function removeBucketPath(context, path) {
+    return Effect.runPromise(removeBucketPathEffect(path).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => isControlFailure(failure.cause)
+        ? Effect.fail(failure.cause)
+        : Effect.succeed({ error: errorMessage(failure.cause) })), Effect.provide(deepAgentBucketLayer(context))));
+}
+function deletionKeys(context, path) {
+    return Effect.gen(function* () {
+        const exact = bucketKey(context, path);
+        const [exists, nested] = yield* Effect.all([
+            Effect.tryPromise({
+                try: () => context.bucket.exists(exact),
+                catch: deepAgentBucketFailure,
+            }),
+            Effect.tryPromise({
+                try: () => context.bucket.list(`${exact}/`),
+                catch: deepAgentBucketFailure,
+            }),
+        ]);
+        return exists ? [exact, ...nested] : nested;
+    });
+}
+//# sourceMappingURL=deepagent-bucket-delete.js.map

package/dist/deepagent-bucket-delete.js.map

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

package/dist/deepagent-bucket-error.d.ts

@@ -0,0 +1,17 @@
+/** Translates bucket operation failures into the DeepAgents backend error format while retaining the affected operation and path. */
+import { Schema } from "effect";
+declare const DeepAgentBucketFailure_base: Schema.Class<DeepAgentBucketFailure, Schema.TaggedStruct<"DeepAgentBucketFailure", {
+    readonly message: Schema.String;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError>;
+/** Typed bucket validation or IO failure for DeepAgents operations. */
+export declare class DeepAgentBucketFailure extends DeepAgentBucketFailure_base {
+}
+/** Captures a bucket error while preserving its original cause.
+ * @param cause - Bucket provider or virtual-path failure.
+ * @returns A tagged bucket failure.
+ * @example deepAgentBucketFailure(new Error("not found"));
+ */
+export declare function deepAgentBucketFailure(cause: unknown): DeepAgentBucketFailure;
+export {};
+//# sourceMappingURL=deepagent-bucket-error.d.ts.map

package/dist/deepagent-bucket-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-error.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-error.ts"],"names":[],"mappings":"AAAA,qIAAqI;AAErI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,uEAAuE;AACvE,qBAAa,sBAAuB,SAAQ,2BAG3C;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAK7E"}

package/dist/deepagent-bucket-error.js

@@ -0,0 +1,17 @@
+/** Translates bucket operation failures into the DeepAgents backend error format while retaining the affected operation and path. */
+import { Schema } from "effect";
+/** Typed bucket validation or IO failure for DeepAgents operations. */
+export class DeepAgentBucketFailure extends Schema.TaggedError()("DeepAgentBucketFailure", { message: Schema.String, cause: Schema.Unknown }) {
+}
+/** Captures a bucket error while preserving its original cause.
+ * @param cause - Bucket provider or virtual-path failure.
+ * @returns A tagged bucket failure.
+ * @example deepAgentBucketFailure(new Error("not found"));
+ */
+export function deepAgentBucketFailure(cause) {
+    return new DeepAgentBucketFailure({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    });
+}
+//# sourceMappingURL=deepagent-bucket-error.js.map

package/dist/deepagent-bucket-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-error.js","sourceRoot":"","sources":["../src/deepagent-bucket-error.ts"],"names":[],"mappings":"AAAA,qIAAqI;AAErI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,uEAAuE;AACvE,MAAM,OAAO,sBAAuB,SAAQ,MAAM,CAAC,WAAW,EAA0B,CACtF,wBAAwB,EACxB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAClD;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,IAAI,sBAAsB,CAAC;QAChC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/deepagent-bucket-file-data.d.ts

@@ -0,0 +1,40 @@
+/** Encodes and decodes DeepAgents file records stored in bucket objects, preserving file content and timestamps across backend operations. */
+import type { DeepAgentBucketFileData, DeepAgentBucketContext } from "./deepagent-bucket-files.types.js";
+import { Effect } from "effect";
+import { DeepAgentBucket } from "./deepagent-bucket-service.js";
+/** Reads bytes and metadata together from the current bucket service.
+ * @param path - Virtual file path.
+ * @returns An Effect with decoded file data, undefined, or DeepAgentBucketFailure.
+ * @example Effect.runPromise(Effect.provide(readFileDataEffect("/a.md"), deepAgentBucketLayer(context)));
+ */
+export declare const readFileDataEffect: (path: string) => Effect.Effect<{
+    content: string | Uint8Array<ArrayBufferLike>;
+    mimeType: string;
+    created_at: string;
+    modified_at: string;
+} | undefined, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
+/** Reads a file for existing Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param path - Virtual file path.
+ * @returns Decoded data or undefined when the file is absent.
+ * @throws The original bucket or path failure.
+ * @example await readFileData(context, "/a.md");
+ */
+export declare function readFileData(context: DeepAgentBucketContext, path: string): Promise<DeepAgentBucketFileData | undefined>;
+/** Writes file content with timestamps from the Effect clock.
+ * @param path - Virtual file path.
+ * @param content - Text or raw bytes to store.
+ * @returns An Effect with void or DeepAgentBucketFailure.
+ * @example Effect.runPromise(Effect.provide(putFileDataEffect("/a.md", "hi"), deepAgentBucketLayer(context)));
+ */
+export declare const putFileDataEffect: (path: string, content: string | Uint8Array<ArrayBufferLike>) => Effect.Effect<void, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
+/** Writes a file for existing Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param path - Virtual file path.
+ * @param content - Text or raw bytes to store.
+ * @returns A Promise that resolves when the bucket accepts the content.
+ * @throws The original bucket or path failure.
+ * @example await putFileData(context, "/a.md", "hi");
+ */
+export declare function putFileData(context: DeepAgentBucketContext, path: string, content: string | Uint8Array): Promise<void>;
+//# sourceMappingURL=deepagent-bucket-file-data.d.ts.map

package/dist/deepagent-bucket-file-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-file-data.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-file-data.ts"],"names":[],"mappings":"AAAA,8IAA8I;AAE9I,OAAO,KAAK,EACV,uBAAuB,EAEvB,sBAAsB,EACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGvC,OAAO,EAAE,eAAe,EAAwB,MAAM,+BAA+B,CAAC;AAGtF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;6FAsB9B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAO9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,qKA8B7B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,UAAU,GAC3B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/deepagent-bucket-file-data.js

@@ -0,0 +1,115 @@
+/** Encodes and decodes DeepAgents file records stored in bucket objects, preserving file content and timestamps across backend operations. */
+import { Clock, Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { deepAgentBucketFailure } from "./deepagent-bucket-error.js";
+import { DeepAgentBucket, deepAgentBucketLayer } from "./deepagent-bucket-service.js";
+import { bucketKey, isTextMimeType } from "./deepagent-bucket-files.js";
+/** Reads bytes and metadata together from the current bucket service.
+ * @param path - Virtual file path.
+ * @returns An Effect with decoded file data, undefined, or DeepAgentBucketFailure.
+ * @example Effect.runPromise(Effect.provide(readFileDataEffect("/a.md"), deepAgentBucketLayer(context)));
+ */
+export const readFileDataEffect = Effect.fn("Agents.bucket.readData")(function* (path) {
+    const context = yield* DeepAgentBucket;
+    const key = yield* Effect.try({
+        try: () => bucketKey(context, path),
+        catch: deepAgentBucketFailure,
+    });
+    const [bytes, metadata] = yield* Effect.all([
+        Effect.tryPromise({ try: () => context.bucket.get(key), catch: deepAgentBucketFailure }),
+        Effect.tryPromise({ try: () => context.bucket.head(key), catch: deepAgentBucketFailure }),
+    ]);
+    if (bytes === undefined)
+        return undefined;
+    const mimeType = metadata?.contentType ?? mimeTypeFor(path);
+    const content = isTextMimeType(mimeType) ? new TextDecoder().decode(bytes) : bytes;
+    return {
+        content,
+        mimeType,
+        created_at: timestamp(metadata, "deepagents-created-at"),
+        modified_at: timestamp(metadata, "deepagents-modified-at"),
+    };
+}, (effect) => observeAgent("bucket.read-data", effect));
+/** Reads a file for existing Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param path - Virtual file path.
+ * @returns Decoded data or undefined when the file is absent.
+ * @throws The original bucket or path failure.
+ * @example await readFileData(context, "/a.md");
+ */
+export function readFileData(context, path) {
+    return Effect.runPromise(readFileDataEffect(path).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(deepAgentBucketLayer(context))));
+}
+/** Writes file content with timestamps from the Effect clock.
+ * @param path - Virtual file path.
+ * @param content - Text or raw bytes to store.
+ * @returns An Effect with void or DeepAgentBucketFailure.
+ * @example Effect.runPromise(Effect.provide(putFileDataEffect("/a.md", "hi"), deepAgentBucketLayer(context)));
+ */
+export const putFileDataEffect = Effect.fn("Agents.bucket.writeData")(function* (path, content) {
+    const context = yield* DeepAgentBucket;
+    const key = yield* Effect.try({
+        try: () => bucketKey(context, path),
+        catch: deepAgentBucketFailure,
+    });
+    const previous = yield* Effect.tryPromise({
+        try: () => context.bucket.head(key),
+        catch: deepAgentBucketFailure,
+    });
+    const now = new Date(yield* Clock.currentTimeMillis).toISOString();
+    const mimeType = mimeTypeFor(path);
+    const bytes = yield* Effect.try({
+        try: () => (typeof content === "string" ? encodeContent(content, mimeType) : content),
+        catch: deepAgentBucketFailure,
+    });
+    yield* Effect.tryPromise({
+        try: () => context.bucket.put(key, bytes, {
+            contentType: mimeType,
+            metadata: {
+                "deepagents-created-at": timestamp(previous, "deepagents-created-at", now),
+                "deepagents-modified-at": now,
+            },
+        }),
+        catch: deepAgentBucketFailure,
+    });
+}, (effect) => observeAgent("bucket.write-data", effect));
+/** Writes a file for existing Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param path - Virtual file path.
+ * @param content - Text or raw bytes to store.
+ * @returns A Promise that resolves when the bucket accepts the content.
+ * @throws The original bucket or path failure.
+ * @example await putFileData(context, "/a.md", "hi");
+ */
+export function putFileData(context, path, content) {
+    return Effect.runPromise(putFileDataEffect(path, content).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(deepAgentBucketLayer(context))));
+}
+function encodeContent(content, mimeType) {
+    if (isTextMimeType(mimeType))
+        return new TextEncoder().encode(content);
+    const payload = content.trim().startsWith("data:")
+        ? content.slice(content.indexOf(",") + 1)
+        : content;
+    return Uint8Array.fromBase64(payload.replaceAll(/\s/g, ""));
+}
+function timestamp(metadata, key, fallback = new Date(0).toISOString()) {
+    return metadata?.metadata?.[key] ?? fallback;
+}
+function mimeTypeFor(path) {
+    const extension = path.slice(path.lastIndexOf(".")).toLowerCase();
+    if ([".png", ".jpg", ".jpeg", ".gif", ".webp"].includes(extension)) {
+        return `image/${extension === ".jpg" ? "jpeg" : extension.slice(1)}`;
+    }
+    if (extension === ".pdf")
+        return "application/pdf";
+    if (extension === ".json")
+        return "application/json";
+    if (extension === ".js" || extension === ".mjs" || extension === ".cjs")
+        return "application/javascript";
+    if (extension === ".svg")
+        return "image/svg+xml";
+    if (extension === ".md" || extension === ".markdown")
+        return "text/markdown";
+    return "text/plain";
+}
+//# sourceMappingURL=deepagent-bucket-file-data.js.map

package/dist/deepagent-bucket-file-data.js.map

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

package/dist/deepagent-bucket-file-index.d.ts

@@ -0,0 +1,34 @@
+/** Maintains the invocation file index used by bucket-backed listing and lookup; reads and mutations share the same backend state. */
+import type { FileInfo } from "deepagents";
+import type { DeepAgentBucketContext } from "./deepagent-bucket-files.types.js";
+import { Effect } from "effect";
+import { DeepAgentBucket } from "./deepagent-bucket-service.js";
+/** Lists sorted keys in a virtual file or directory.
+ * @param path - Virtual path, or null for the backend root.
+ * @returns An Effect with ordered keys or DeepAgentBucketFailure.
+ * @example Effect.runPromise(Effect.provide(scopedKeysEffect("/notes"), deepAgentBucketLayer(context)));
+ */
+export declare const scopedKeysEffect: (path: string | null | undefined) => Effect.Effect<string[], import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
+/** Lists keys for existing Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param path - Virtual path, or null for the backend root.
+ * @returns Ordered keys.
+ * @throws The original bucket or path failure.
+ * @example await scopedKeys(context, "/notes");
+ */
+export declare function scopedKeys(context: DeepAgentBucketContext, path: string | null | undefined): Promise<readonly string[]>;
+/** Reads metadata for one bucket key.
+ * @param key - Bucket key under the current prefix.
+ * @returns An Effect with file info, undefined, or DeepAgentBucketFailure.
+ * @example Effect.runPromise(Effect.provide(infoForEffect("deepagents/a.md"), deepAgentBucketLayer(context)));
+ */
+export declare const infoForEffect: (key: string) => Effect.Effect<FileInfo | undefined, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
+/** Reads metadata for existing Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param key - Bucket key under the current prefix.
+ * @returns File info or undefined.
+ * @throws The original bucket or path failure.
+ * @example await infoFor(context, "deepagents/a.md");
+ */
+export declare function infoFor(context: DeepAgentBucketContext, key: string): Promise<FileInfo | undefined>;
+//# sourceMappingURL=deepagent-bucket-file-index.d.ts.map

package/dist/deepagent-bucket-file-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-file-index.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-file-index.ts"],"names":[],"mappings":"AAAA,sIAAsI;AAEtI,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,eAAe,EAAwB,MAAM,+BAA+B,CAAC;AAGtF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,6IAuB5B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAO5B;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,qIAqBzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,sBAAsB,EAC/B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAO/B"}

package/dist/deepagent-bucket-file-index.js

@@ -0,0 +1,82 @@
+/** Maintains the invocation file index used by bucket-backed listing and lookup; reads and mutations share the same backend state. */
+import { Effect } from "effect";
+import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
+import { deepAgentBucketFailure } from "./deepagent-bucket-error.js";
+import { DeepAgentBucket, deepAgentBucketLayer } from "./deepagent-bucket-service.js";
+import { bucketKey, filePath, virtualPath } from "./deepagent-bucket-files.js";
+/** Lists sorted keys in a virtual file or directory.
+ * @param path - Virtual path, or null for the backend root.
+ * @returns An Effect with ordered keys or DeepAgentBucketFailure.
+ * @example Effect.runPromise(Effect.provide(scopedKeysEffect("/notes"), deepAgentBucketLayer(context)));
+ */
+export const scopedKeysEffect = Effect.fn("Agents.bucket.scopedKeys")(function* (path) {
+    const context = yield* DeepAgentBucket;
+    const base = yield* Effect.try({
+        try: () => virtualPath(path ?? "/", true),
+        catch: deepAgentBucketFailure,
+    });
+    if (base !== "/") {
+        const exact = bucketKey(context, base.slice(0, -1));
+        const exists = yield* Effect.tryPromise({
+            try: () => context.bucket.exists(exact),
+            catch: deepAgentBucketFailure,
+        });
+        if (exists)
+            return [exact];
+    }
+    const prefix = base === "/" ? `${context.prefix}/` : `${context.prefix}${base}`;
+    const keys = yield* Effect.tryPromise({
+        try: () => context.bucket.list(prefix),
+        catch: deepAgentBucketFailure,
+    });
+    return [...keys].sort();
+}, (effect) => observeAgent("bucket.scoped-keys", effect));
+/** Lists keys for existing Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param path - Virtual path, or null for the backend root.
+ * @returns Ordered keys.
+ * @throws The original bucket or path failure.
+ * @example await scopedKeys(context, "/notes");
+ */
+export function scopedKeys(context, path) {
+    return Effect.runPromise(scopedKeysEffect(path).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(deepAgentBucketLayer(context))));
+}
+/** Reads metadata for one bucket key.
+ * @param key - Bucket key under the current prefix.
+ * @returns An Effect with file info, undefined, or DeepAgentBucketFailure.
+ * @example Effect.runPromise(Effect.provide(infoForEffect("deepagents/a.md"), deepAgentBucketLayer(context)));
+ */
+export const infoForEffect = Effect.fn("Agents.bucket.info")(function* (key) {
+    const context = yield* DeepAgentBucket;
+    const metadata = yield* Effect.tryPromise({
+        try: () => context.bucket.head(key),
+        catch: deepAgentBucketFailure,
+    });
+    if (metadata === undefined)
+        return undefined;
+    const path = yield* Effect.try({
+        try: () => filePath(context, key),
+        catch: deepAgentBucketFailure,
+    });
+    const info = {
+        path,
+        is_dir: false,
+        ...(metadata.size === undefined ? {} : { size: metadata.size }),
+        modified_at: timestamp(metadata, "deepagents-modified-at"),
+    };
+    return info;
+}, (effect) => observeAgent("bucket.info", effect));
+/** Reads metadata for existing Promise callers.
+ * @param context - Bound bucket client and prefix.
+ * @param key - Bucket key under the current prefix.
+ * @returns File info or undefined.
+ * @throws The original bucket or path failure.
+ * @example await infoFor(context, "deepagents/a.md");
+ */
+export function infoFor(context, key) {
+    return Effect.runPromise(infoForEffect(key).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(deepAgentBucketLayer(context))));
+}
+function timestamp(metadata, key) {
+    return metadata.metadata?.[key] ?? new Date(0).toISOString();
+}
+//# sourceMappingURL=deepagent-bucket-file-index.js.map

package/dist/deepagent-bucket-file-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-file-index.js","sourceRoot":"","sources":["../src/deepagent-bucket-file-index.ts"],"names":[],"mappings":"AAAA,sIAAsI;AAOtI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CACnE,QAAQ,CAAC,EAAE,IAA+B;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,IAAI,CAAC;QACzC,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACtC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YACvC,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;QACH,IAAI,MAAM;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;IAChF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACpC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACtC,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CACvD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,OAA+B,EAC/B,IAA+B;IAE/B,OAAO,MAAM,CAAC,UAAU,CACtB,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,CACzB,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAClF,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAC9C,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAC1D,QAAQ,CAAC,EAAE,GAAW;IACpB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACxC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACnC,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;QACjC,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,MAAM,IAAI,GAAa;QACrB,IAAI;QACJ,MAAM,EAAE,KAAK;QACb,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/D,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC3D,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CACrB,OAA+B,EAC/B,GAAW;IAEX,OAAO,MAAM,CAAC,UAAU,CACtB,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,CACrB,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAClF,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAC9C,CACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,QAAiC,EAAE,GAAW;IAC/D,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC/D,CAAC"}

package/dist/deepagent-bucket-files.d.ts

@@ -0,0 +1,5 @@
+/** Collects bucket-backed file entries for native filesystem operations after path normalization, keeping metadata separate from fetched file content. */
+export type * from "./deepagent-bucket-files.types.js";
+export { bucketKey, bucketKeyEffect, createBucketContext, createBucketContextEffect, filePath, filePathEffect, virtualPath, virtualPathEffect, } from "./deepagent-bucket-path.js";
+export { errorMessage, errorMessageEffect, isControlFailure, isControlFailureEffect, isTextMimeType, isTextMimeTypeEffect, normalizedPage, normalizedPageEffect, } from "./deepagent-bucket-format.js";
+//# sourceMappingURL=deepagent-bucket-files.d.ts.map

package/dist/deepagent-bucket-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-files.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-files.ts"],"names":[],"mappings":"AAAA,0JAA0J;AAE1J,mBAAmB,mCAAmC,CAAC;AACvD,OAAO,EACL,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,QAAQ,EACR,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,MAAM,8BAA8B,CAAC"}

package/dist/deepagent-bucket-files.js

@@ -0,0 +1,4 @@
+/** Collects bucket-backed file entries for native filesystem operations after path normalization, keeping metadata separate from fetched file content. */
+export { bucketKey, bucketKeyEffect, createBucketContext, createBucketContextEffect, filePath, filePathEffect, virtualPath, virtualPathEffect, } from "./deepagent-bucket-path.js";
+export { errorMessage, errorMessageEffect, isControlFailure, isControlFailureEffect, isTextMimeType, isTextMimeTypeEffect, normalizedPage, normalizedPageEffect, } from "./deepagent-bucket-format.js";
+//# sourceMappingURL=deepagent-bucket-files.js.map

package/dist/deepagent-bucket-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-files.js","sourceRoot":"","sources":["../src/deepagent-bucket-files.ts"],"names":[],"mappings":"AAAA,0JAA0J;AAG1J,OAAO,EACL,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,QAAQ,EACR,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,MAAM,8BAA8B,CAAC"}

package/dist/deepagent-bucket-files.types.d.ts

@@ -0,0 +1,8 @@
+/** Collects bucket-backed file entries for native filesystem operations after path normalization, keeping metadata separate from fetched file content. This companion preserves the native input and output types without starting runtime work. */
+import type { FileData } from "deepagents";
+export type * from "./deepagent-bucket-client.types.js";
+/** DeepAgents file payload that carries a concrete MIME type. */
+export type DeepAgentBucketFileData = Extract<FileData, {
+    readonly mimeType: string;
+}>;
+//# sourceMappingURL=deepagent-bucket-files.types.d.ts.map

package/dist/deepagent-bucket-files.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-files.types.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-files.types.ts"],"names":[],"mappings":"AAAA,oPAAoP;AAEpP,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,mBAAmB,oCAAoC,CAAC;AAExD,iEAAiE;AACjE,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/dist/deepagent-bucket-files.types.js

@@ -0,0 +1,3 @@
+/** Collects bucket-backed file entries for native filesystem operations after path normalization, keeping metadata separate from fetched file content. This companion preserves the native input and output types without starting runtime work. */
+export {};
+//# sourceMappingURL=deepagent-bucket-files.types.js.map

package/dist/deepagent-bucket-files.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepagent-bucket-files.types.js","sourceRoot":"","sources":["../src/deepagent-bucket-files.types.ts"],"names":[],"mappings":"AAAA,oPAAoP"}