@aigne/did-space-memory 1.0.0

package/lib/cjs/readme-manager.d.ts

@@ -0,0 +1,21 @@
+import { type SpaceClientOptionsAuth } from "@blocklet/did-space-js";
+/**
+ * Manages README files for DID Spaces Memory
+ */
+export declare class ReadmeManager {
+    private client;
+    private rootDir;
+    constructor(url: string, auth: SpaceClientOptionsAuth, rootDir: string);
+    /**
+     * Check if a file exists in DID Spaces
+     */
+    private exists;
+    /**
+     * Create README file if it doesn't exist
+     */
+    private createReadmeIfNotExists;
+    /**
+     * Initialize all README files
+     */
+    initializeReadmeFiles(): Promise<void>;
+}

package/lib/cjs/readme-manager.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadmeManager = void 0;
+const node_path_1 = require("node:path");
+const did_space_js_1 = require("@blocklet/did-space-js");
+const readme_contents_js_1 = require("./readme-contents.js");
+/**
+ * Manages README files for DID Spaces Memory
+ */
+class ReadmeManager {
+    client;
+    rootDir;
+    constructor(url, auth, rootDir) {
+        this.client = new did_space_js_1.SpaceClient({ url, auth });
+        this.rootDir = rootDir;
+    }
+    /**
+     * Check if a file exists in DID Spaces
+     */
+    async exists(key) {
+        try {
+            const output = await this.client.send(new did_space_js_1.ListObjectCommand({ key }));
+            return output.statusCode === 200;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Create README file if it doesn't exist
+     */
+    async createReadmeIfNotExists(filename, content) {
+        const filePath = (0, node_path_1.join)(this.rootDir, filename);
+        if (!(await this.exists(filePath))) {
+            await this.client.send(new did_space_js_1.PutObjectCommand({
+                key: filePath,
+                data: content,
+            }));
+        }
+    }
+    /**
+     * Initialize all README files
+     */
+    async initializeReadmeFiles() {
+        await this.createReadmeIfNotExists("README.md", readme_contents_js_1.README_EN_CONTENT);
+    }
+}
+exports.ReadmeManager = ReadmeManager;

package/lib/cjs/utils/fs.d.ts

@@ -0,0 +1 @@
+export declare function streamToString(stream: ReadableStream | NodeJS.ReadableStream, encoding?: BufferEncoding): Promise<string>;

package/lib/cjs/utils/fs.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamToString = streamToString;
+async function streamToString(stream, encoding = "utf-8") {
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString(encoding);
+}

package/lib/cjs/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./fs.js";

package/lib/cjs/utils/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./fs.js"), exports);

package/lib/dts/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./memory.js";
+export * from "./readme-contents.js";
+export * from "./readme-manager.js";

package/lib/dts/memory.d.ts

@@ -0,0 +1,88 @@
+import { type AIAgentOptions, type Message } from "@aigne/core";
+import { MemoryAgent, type MemoryAgentOptions, type MemoryRecorderInput, type MemoryRetrieverInput } from "@aigne/core/memory/index.js";
+import { type SpaceClientOptionsAuth } from "@blocklet/did-space-js";
+export declare const MEMORY_FILE_NAME = "memory.yaml";
+/**
+ * Configuration options for the DIDSpacesMemory class.
+ */
+export interface DIDSpacesMemoryOptions extends Partial<MemoryAgentOptions> {
+    /**
+     * The URL of the DIDSpaces.
+     */
+    url: string;
+    /**
+     * The authentication method for the DIDSpaces.
+     */
+    auth: SpaceClientOptionsAuth;
+    /**
+     * Optional configuration for the memory retriever agent.
+     * Controls how memories are retrieved from the file system.
+     */
+    retrieverOptions?: Partial<DIDSpacesMemoryRetrieverOptions>;
+    /**
+     * Optional configuration for the memory recorder agent.
+     * Controls how memories are recorded to the file system.
+     */
+    recorderOptions?: Partial<DIDSpacesMemoryRecorderOptions>;
+}
+/**
+ * A memory implementation that stores and retrieves memories using the file system.
+ * DIDSpacesMemory provides persistent storage of agent memories as files in a specified directory.
+ *
+ * @example
+ * Here is an example of how to use the DIDSpacesMemory class:
+ * {@includeCode ../../test/did-spaces-memory/did-spaces-memory.test.ts#example-did-spaces-memory-simple}
+ */
+export declare class DIDSpacesMemory extends MemoryAgent {
+    /**
+     * Creates a new DIDSpacesMemory instance.
+     */
+    constructor(options: DIDSpacesMemoryOptions);
+    /**
+     * Initialize README files in the memory directory
+     */
+    private initializeReadmeFiles;
+}
+interface DIDSpacesMemoryRetrieverOptions extends AIAgentOptions<DIDSpacesMemoryRetrieverAgentInput, DIDSpacesMemoryRetrieverAgentOutput> {
+    /**
+     * The URL of the DIDSpaces.
+     */
+    url: string;
+    /**
+     * The authentication method for the DIDSpaces.
+     */
+    auth: SpaceClientOptionsAuth;
+    /**
+     * The name of the memory file.
+     */
+    memoryFileName: string;
+}
+interface DIDSpacesMemoryRetrieverAgentInput extends MemoryRetrieverInput {
+    allMemory: string;
+}
+interface DIDSpacesMemoryRetrieverAgentOutput extends Message {
+    memories: {
+        content: string;
+    }[];
+}
+interface DIDSpacesMemoryRecorderOptions extends AIAgentOptions<DIDSpacesMemoryRecorderAgentInput, DIDSpacesMemoryRecorderAgentOutput> {
+    /**
+     * The URL of the DIDSpaces.
+     */
+    url: string;
+    /**
+     * The authentication method for the DIDSpaces.
+     */
+    auth: SpaceClientOptionsAuth;
+    /**
+     * The name of the memory file.
+     */
+    memoryFileName: string;
+}
+type DIDSpacesMemoryRecorderAgentInput = MemoryRecorderInput;
+interface DIDSpacesMemoryRecorderAgentOutput extends Message {
+    memories: {
+        content: string;
+    }[];
+}
+export {};

package/lib/dts/readme-contents.d.ts

@@ -0,0 +1,4 @@
+/**
+ * README content for DID Spaces Memory
+ */
+export declare const README_EN_CONTENT = "# AIGNE Memory Directory\n\nThis directory is used to store agent context and conversation memories.\n\n## Files\n\n- `memory.yaml` - Contains the conversation history and context that the AI agent remembers across sessions\n- `README.md` - This file (English documentation)\n- `README.zh.md` - Chinese documentation\n\n## Purpose\n\nThe memory system allows AI agents to maintain context and remember important information from previous conversations, enabling more personalized and coherent interactions.\n\n## Privacy\n\nThe memory files are stored in your personal DID Space and are only accessible to you and the agents you authorize.";

package/lib/dts/readme-manager.d.ts

@@ -0,0 +1,21 @@
+import { type SpaceClientOptionsAuth } from "@blocklet/did-space-js";
+/**
+ * Manages README files for DID Spaces Memory
+ */
+export declare class ReadmeManager {
+    private client;
+    private rootDir;
+    constructor(url: string, auth: SpaceClientOptionsAuth, rootDir: string);
+    /**
+     * Check if a file exists in DID Spaces
+     */
+    private exists;
+    /**
+     * Create README file if it doesn't exist
+     */
+    private createReadmeIfNotExists;
+    /**
+     * Initialize all README files
+     */
+    initializeReadmeFiles(): Promise<void>;
+}

package/lib/dts/utils/fs.d.ts

@@ -0,0 +1 @@
+export declare function streamToString(stream: ReadableStream | NodeJS.ReadableStream, encoding?: BufferEncoding): Promise<string>;

package/lib/dts/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./fs.js";

package/lib/esm/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./memory.js";
+export * from "./readme-contents.js";
+export * from "./readme-manager.js";

package/lib/esm/index.js

@@ -0,0 +1,3 @@
+export * from "./memory.js";
+export * from "./readme-contents.js";
+export * from "./readme-manager.js";

package/lib/esm/memory.d.ts

@@ -0,0 +1,88 @@
+import { type AIAgentOptions, type Message } from "@aigne/core";
+import { MemoryAgent, type MemoryAgentOptions, type MemoryRecorderInput, type MemoryRetrieverInput } from "@aigne/core/memory/index.js";
+import { type SpaceClientOptionsAuth } from "@blocklet/did-space-js";
+export declare const MEMORY_FILE_NAME = "memory.yaml";
+/**
+ * Configuration options for the DIDSpacesMemory class.
+ */
+export interface DIDSpacesMemoryOptions extends Partial<MemoryAgentOptions> {
+    /**
+     * The URL of the DIDSpaces.
+     */
+    url: string;
+    /**
+     * The authentication method for the DIDSpaces.
+     */
+    auth: SpaceClientOptionsAuth;
+    /**
+     * Optional configuration for the memory retriever agent.
+     * Controls how memories are retrieved from the file system.
+     */
+    retrieverOptions?: Partial<DIDSpacesMemoryRetrieverOptions>;
+    /**
+     * Optional configuration for the memory recorder agent.
+     * Controls how memories are recorded to the file system.
+     */
+    recorderOptions?: Partial<DIDSpacesMemoryRecorderOptions>;
+}
+/**
+ * A memory implementation that stores and retrieves memories using the file system.
+ * DIDSpacesMemory provides persistent storage of agent memories as files in a specified directory.
+ *
+ * @example
+ * Here is an example of how to use the DIDSpacesMemory class:
+ * {@includeCode ../../test/did-spaces-memory/did-spaces-memory.test.ts#example-did-spaces-memory-simple}
+ */
+export declare class DIDSpacesMemory extends MemoryAgent {
+    /**
+     * Creates a new DIDSpacesMemory instance.
+     */
+    constructor(options: DIDSpacesMemoryOptions);
+    /**
+     * Initialize README files in the memory directory
+     */
+    private initializeReadmeFiles;
+}
+interface DIDSpacesMemoryRetrieverOptions extends AIAgentOptions<DIDSpacesMemoryRetrieverAgentInput, DIDSpacesMemoryRetrieverAgentOutput> {
+    /**
+     * The URL of the DIDSpaces.
+     */
+    url: string;
+    /**
+     * The authentication method for the DIDSpaces.
+     */
+    auth: SpaceClientOptionsAuth;
+    /**
+     * The name of the memory file.
+     */
+    memoryFileName: string;
+}
+interface DIDSpacesMemoryRetrieverAgentInput extends MemoryRetrieverInput {
+    allMemory: string;
+}
+interface DIDSpacesMemoryRetrieverAgentOutput extends Message {
+    memories: {
+        content: string;
+    }[];
+}
+interface DIDSpacesMemoryRecorderOptions extends AIAgentOptions<DIDSpacesMemoryRecorderAgentInput, DIDSpacesMemoryRecorderAgentOutput> {
+    /**
+     * The URL of the DIDSpaces.
+     */
+    url: string;
+    /**
+     * The authentication method for the DIDSpaces.
+     */
+    auth: SpaceClientOptionsAuth;
+    /**
+     * The name of the memory file.
+     */
+    memoryFileName: string;
+}
+type DIDSpacesMemoryRecorderAgentInput = MemoryRecorderInput;
+interface DIDSpacesMemoryRecorderAgentOutput extends Message {
+    memories: {
+        content: string;
+    }[];
+}
+export {};

package/lib/esm/memory.js

@@ -0,0 +1,241 @@
+import { join } from "node:path";
+import { AIAgent } from "@aigne/core";
+import { MemoryAgent, MemoryRecorder, MemoryRetriever, newMemoryId, } from "@aigne/core/memory/index.js";
+import { logger } from "@aigne/core/utils/logger.js";
+import { GetObjectCommand, ListObjectCommand, PutObjectCommand, SpaceClient, } from "@blocklet/did-space-js";
+import { stringify } from "yaml";
+import { z } from "zod";
+import { ReadmeManager } from "./readme-manager.js";
+import { streamToString } from "./utils/fs.js";
+export const MEMORY_FILE_NAME = "memory.yaml";
+/**
+ * A memory implementation that stores and retrieves memories using the file system.
+ * DIDSpacesMemory provides persistent storage of agent memories as files in a specified directory.
+ *
+ * @example
+ * Here is an example of how to use the DIDSpacesMemory class:
+ * {@includeCode ../../test/did-spaces-memory/did-spaces-memory.test.ts#example-did-spaces-memory-simple}
+ */
+export class DIDSpacesMemory extends MemoryAgent {
+    /**
+     * Creates a new DIDSpacesMemory instance.
+     */
+    constructor(options) {
+        const rootDir = "/.aigne/";
+        const memoryFileName = join(rootDir, MEMORY_FILE_NAME);
+        super({
+            ...options,
+            recorder: options.recorder ??
+                new DIDSpacesMemoryRecorder({
+                    url: options.url,
+                    auth: options.auth,
+                    memoryFileName,
+                    ...options.recorderOptions,
+                }),
+            retriever: options.retriever ??
+                new DIDSpacesMemoryRetriever({
+                    url: options.url,
+                    auth: options.auth,
+                    memoryFileName,
+                    ...options.retrieverOptions,
+                }),
+            autoUpdate: options.autoUpdate ?? true,
+        });
+        // Initialize README files asynchronously
+        this.initializeReadmeFiles(options.url, options.auth, rootDir).catch((error) => {
+            logger.warn("Failed to initialize README files:", error);
+        });
+    }
+    /**
+     * Initialize README files in the memory directory
+     */
+    async initializeReadmeFiles(url, auth, rootDir) {
+        const readmeManager = new ReadmeManager(url, auth, rootDir);
+        await readmeManager.initializeReadmeFiles();
+    }
+}
+class DIDSpacesMemoryRetriever extends MemoryRetriever {
+    options;
+    constructor(options) {
+        super({});
+        this.options = options;
+        this.agent = AIAgent.from({
+            name: "did_spaces_memory_retriever",
+            description: "Retrieves memories from the file or directory.",
+            ...options,
+            instructions: options.instructions || DEFAULT_DID_SPACES_MEMORY_RETRIEVER_INSTRUCTIONS,
+            outputSchema: z.object({
+                memories: z
+                    .array(z.object({
+                    content: z.string().describe("Content of the memory"),
+                }))
+                    .describe("List of memories"),
+            }),
+        });
+    }
+    agent;
+    async exists() {
+        const client = new SpaceClient({
+            url: this.options.url,
+            auth: this.options.auth,
+        });
+        const listObjectCommandOutput = await client.send(new ListObjectCommand({
+            key: this.options.memoryFileName,
+        }));
+        return listObjectCommandOutput.statusCode === 200;
+    }
+    async read(input, options) {
+        const client = new SpaceClient({
+            url: this.options.url,
+            auth: this.options.auth,
+        });
+        const getObjectCommandOutput = await client.send(new GetObjectCommand({
+            key: this.options.memoryFileName,
+        }));
+        if (getObjectCommandOutput.statusCode !== 200) {
+            logger.warn(`statusCode: ${getObjectCommandOutput.statusCode}, statusMessage: ${getObjectCommandOutput.statusMessage}`);
+            throw new Error(getObjectCommandOutput.statusMessage);
+        }
+        const allMemory = await streamToString(getObjectCommandOutput.data);
+        const { memories } = await options.context.invoke(this.agent, {
+            ...input,
+            allMemory,
+        });
+        const results = memories.map((memory) => ({
+            id: newMemoryId(),
+            content: memory.content,
+            createdAt: new Date().toISOString(),
+        }));
+        return results;
+    }
+    async process(input, options) {
+        if (!(await this.exists())) {
+            return { memories: [] };
+        }
+        const memories = await this.read(input, options);
+        return { memories };
+    }
+}
+class DIDSpacesMemoryRecorder extends MemoryRecorder {
+    options;
+    constructor(options) {
+        super({});
+        this.options = options;
+        this.agent = AIAgent.from({
+            name: "did_spaces_memory_recorder",
+            description: "Records memories in files by AI agent",
+            ...options,
+            instructions: options.instructions || DEFAULT_FS_MEMORY_RECORDER_INSTRUCTIONS,
+            outputSchema: z.object({
+                memories: z
+                    .array(z.object({
+                    content: z.string().describe("Content of the memory"),
+                }))
+                    .describe("List of memories"),
+            }),
+        });
+    }
+    agent;
+    async write(input, options) {
+        const client = new SpaceClient({
+            url: this.options.url,
+            auth: this.options.auth,
+        });
+        const output = await client.send(new GetObjectCommand({
+            key: this.options.memoryFileName,
+        }));
+        const allMemory = output.statusCode === 200 ? await streamToString(output.data) : "";
+        const { memories } = await options.context.invoke(this.agent, {
+            ...input,
+            allMemory,
+        });
+        const raws = stringify(memories.map((i) => ({
+            content: i.content,
+        })));
+        const putObjectCommandOutput = await client.send(new PutObjectCommand({
+            key: this.options.memoryFileName,
+            data: raws,
+        }));
+        if (putObjectCommandOutput.statusCode !== 200) {
+            logger.warn(`statusCode: ${putObjectCommandOutput.statusCode}, statusMessage: ${putObjectCommandOutput.statusMessage}`);
+            throw new Error(putObjectCommandOutput.statusMessage);
+        }
+        const results = memories.map((memory) => ({
+            id: newMemoryId(),
+            content: memory.content,
+            createdAt: new Date().toISOString(),
+        }));
+        return { memories: results };
+    }
+    async process(input, options) {
+        return this.write(input, options);
+    }
+}
+const DEFAULT_FS_MEMORY_RECORDER_INSTRUCTIONS = `You manage memory based on conversation analysis and the existing memories.
+
+## IMPORTANT: All existing memories are available in the allMemory variable. DO NOT call any tools.
+
+## FIRST: Determine If Memory Updates Needed
+- Analyze if the conversation contains ANY information worth remembering
+- Examples of content NOT worth storing:
+  * General questions ("What's the weather?", "How do I do X?")
+  * Greetings and small talk ("Hello", "How are you?", "Thanks")
+  * System instructions or commands ("Show me", "Find", "Save")
+  * General facts not specific to the user
+  * Duplicate information already stored
+- If conversation lacks meaningful personal information to store:
+  * Return the existing memories unchanged
+
+## Your Workflow:
+1. Read the existing memories from the allMemory variable
+2. Extract key topics from the conversation
+3. DECIDE whether to create/update/delete memories based on the conversation
+4. Return ALL memories including your updates (remove any duplicates)
+
+## Memory Handling:
+- CREATE: Add new memory objects for new topics
+- UPDATE: Modify existing memories if substantial new information is available
+- DELETE: Remove obsolete memories when appropriate
+
+## Memory Structure:
+- Each memory has an id, content, and createdAt fields
+- Keep the existing structure when returning updated memories
+
+## Operation Decision Rules:
+- CREATE only for truly new topics not covered in any existing memory
+- UPDATE only when new information is meaningfully different
+- NEVER update for just rephrasing or minor differences
+- DELETE only when information becomes obsolete
+
+## IMPORTANT: Your job is to return the complete updated memory collection.
+Return ALL memories (existing and new) in your response.
+
+## Existing Memories:
+<existing-memory>
+{{allMemory}}
+</existing-memory>
+
+## Conversation:
+<conversation>
+{{content}}
+</conversation>
+`;
+const DEFAULT_DID_SPACES_MEMORY_RETRIEVER_INSTRUCTIONS = `You retrieve only the most relevant memories for the current conversation.
+
+## IMPORTANT: All existing memories are available in the allMemory variable
+
+## Process:
+1. Read the existing memories from the allMemory variable
+2. Extract key topics from the conversation or search query
+3. Match memory contents against these topics
+
+## Existing Memories:
+<existing-memory>
+{{allMemory}}
+</existing-memory>
+
+## Search Query:
+<search-query>
+{{search}}
+</search-query>
+`;

package/lib/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/lib/esm/readme-contents.d.ts

@@ -0,0 +1,4 @@
+/**
+ * README content for DID Spaces Memory
+ */
+export declare const README_EN_CONTENT = "# AIGNE Memory Directory\n\nThis directory is used to store agent context and conversation memories.\n\n## Files\n\n- `memory.yaml` - Contains the conversation history and context that the AI agent remembers across sessions\n- `README.md` - This file (English documentation)\n- `README.zh.md` - Chinese documentation\n\n## Purpose\n\nThe memory system allows AI agents to maintain context and remember important information from previous conversations, enabling more personalized and coherent interactions.\n\n## Privacy\n\nThe memory files are stored in your personal DID Space and are only accessible to you and the agents you authorize.";

package/lib/esm/readme-contents.js

@@ -0,0 +1,20 @@
+/**
+ * README content for DID Spaces Memory
+ */
+export const README_EN_CONTENT = `# AIGNE Memory Directory
+
+This directory is used to store agent context and conversation memories.
+
+## Files
+
+- \`memory.yaml\` - Contains the conversation history and context that the AI agent remembers across sessions
+- \`README.md\` - This file (English documentation)
+- \`README.zh.md\` - Chinese documentation
+
+## Purpose
+
+The memory system allows AI agents to maintain context and remember important information from previous conversations, enabling more personalized and coherent interactions.
+
+## Privacy
+
+The memory files are stored in your personal DID Space and are only accessible to you and the agents you authorize.`;

package/lib/esm/readme-manager.d.ts

@@ -0,0 +1,21 @@
+import { type SpaceClientOptionsAuth } from "@blocklet/did-space-js";
+/**
+ * Manages README files for DID Spaces Memory
+ */
+export declare class ReadmeManager {
+    private client;
+    private rootDir;
+    constructor(url: string, auth: SpaceClientOptionsAuth, rootDir: string);
+    /**
+     * Check if a file exists in DID Spaces
+     */
+    private exists;
+    /**
+     * Create README file if it doesn't exist
+     */
+    private createReadmeIfNotExists;
+    /**
+     * Initialize all README files
+     */
+    initializeReadmeFiles(): Promise<void>;
+}

package/lib/esm/readme-manager.js

@@ -0,0 +1,44 @@
+import { join } from "node:path";
+import { ListObjectCommand, PutObjectCommand, SpaceClient, } from "@blocklet/did-space-js";
+import { README_EN_CONTENT } from "./readme-contents.js";
+/**
+ * Manages README files for DID Spaces Memory
+ */
+export class ReadmeManager {
+    client;
+    rootDir;
+    constructor(url, auth, rootDir) {
+        this.client = new SpaceClient({ url, auth });
+        this.rootDir = rootDir;
+    }
+    /**
+     * Check if a file exists in DID Spaces
+     */
+    async exists(key) {
+        try {
+            const output = await this.client.send(new ListObjectCommand({ key }));
+            return output.statusCode === 200;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Create README file if it doesn't exist
+     */
+    async createReadmeIfNotExists(filename, content) {
+        const filePath = join(this.rootDir, filename);
+        if (!(await this.exists(filePath))) {
+            await this.client.send(new PutObjectCommand({
+                key: filePath,
+                data: content,
+            }));
+        }
+    }
+    /**
+     * Initialize all README files
+     */
+    async initializeReadmeFiles() {
+        await this.createReadmeIfNotExists("README.md", README_EN_CONTENT);
+    }
+}

package/lib/esm/utils/fs.d.ts

@@ -0,0 +1 @@
+export declare function streamToString(stream: ReadableStream | NodeJS.ReadableStream, encoding?: BufferEncoding): Promise<string>;