@modelprofile.com/flexharness 1.0.0

package/dist_ts/classes.stores.d.ts

@@ -0,0 +1,26 @@
+import type { IFlexHarnessSnapshot, IFlexHarnessStore } from './interfaces.js';
+export declare class InMemoryFlexHarnessStore implements IFlexHarnessStore {
+    private readonly snapshots;
+    load(storageKey: string): Promise<IFlexHarnessSnapshot | undefined>;
+    save(storageKey: string, snapshot: IFlexHarnessSnapshot, expectedRevision: number): Promise<void>;
+}
+export interface IJsonFileFlexHarnessStoreOptions {
+    directory: string;
+}
+/**
+ * Atomic and CAS-safe across instances in this process. It intentionally does not
+ * claim cross-process safety because no operating-system lock is held.
+ */
+export declare class JsonFileFlexHarnessStore implements IFlexHarnessStore {
+    private static readonly fileQueues;
+    private readonly directory;
+    constructor(options: IJsonFileFlexHarnessStoreOptions);
+    load(storageKey: string): Promise<IFlexHarnessSnapshot | undefined>;
+    save(storageKey: string, snapshot: IFlexHarnessSnapshot, expectedRevision: number): Promise<void>;
+    private static inFileQueue;
+    private filePath;
+    private preparePath;
+    private cleanupTemps;
+    private readSnapshot;
+    private writeSnapshot;
+}

package/dist_ts/classes.stores.js

@@ -0,0 +1,156 @@
+import * as plugins from './plugins.js';
+import { FlexHarnessStoreConflictError, FlexHarnessStoreFormatError, FlexHarnessValidationError, } from './errors.js';
+import { assertFlexHarnessSnapshot, cloneSerializable } from './utils.json.js';
+function validateSave(snapshot, expectedRevision) {
+    assertFlexHarnessSnapshot(snapshot);
+    if (!Number.isSafeInteger(expectedRevision) || expectedRevision < 0) {
+        throw new FlexHarnessValidationError('expectedRevision must be a non-negative integer.');
+    }
+    if (snapshot.revision !== expectedRevision + 1) {
+        throw new FlexHarnessStoreFormatError(`Snapshot revision ${snapshot.revision} must equal expected revision ${expectedRevision} plus one.`);
+    }
+    return cloneSerializable(snapshot);
+}
+export class InMemoryFlexHarnessStore {
+    snapshots = new Map();
+    async load(storageKey) {
+        const snapshot = this.snapshots.get(storageKey);
+        return snapshot ? cloneSerializable(snapshot) : undefined;
+    }
+    async save(storageKey, snapshot, expectedRevision) {
+        const validated = validateSave(snapshot, expectedRevision);
+        const actualRevision = this.snapshots.get(storageKey)?.revision ?? 0;
+        if (actualRevision !== expectedRevision) {
+            throw new FlexHarnessStoreConflictError(storageKey, expectedRevision, actualRevision);
+        }
+        this.snapshots.set(storageKey, validated);
+    }
+}
+/**
+ * Atomic and CAS-safe across instances in this process. It intentionally does not
+ * claim cross-process safety because no operating-system lock is held.
+ */
+export class JsonFileFlexHarnessStore {
+    static fileQueues = new Map();
+    directory;
+    constructor(options) {
+        if (!options.directory) {
+            throw new FlexHarnessValidationError('JsonFileFlexHarnessStore requires a directory.');
+        }
+        this.directory = plugins.path.resolve(options.directory);
+    }
+    async load(storageKey) {
+        const filePath = this.filePath(storageKey);
+        return JsonFileFlexHarnessStore.inFileQueue(filePath, async () => {
+            await this.preparePath(filePath);
+            return this.readSnapshot(filePath);
+        });
+    }
+    async save(storageKey, snapshot, expectedRevision) {
+        const validated = validateSave(snapshot, expectedRevision);
+        const filePath = this.filePath(storageKey);
+        await JsonFileFlexHarnessStore.inFileQueue(filePath, async () => {
+            await this.preparePath(filePath);
+            const current = await this.readSnapshot(filePath);
+            const actualRevision = current?.revision ?? 0;
+            if (actualRevision !== expectedRevision) {
+                throw new FlexHarnessStoreConflictError(storageKey, expectedRevision, actualRevision);
+            }
+            await this.writeSnapshot(filePath, validated);
+        });
+    }
+    static inFileQueue(filePath, operation) {
+        const previous = JsonFileFlexHarnessStore.fileQueues.get(filePath) ?? Promise.resolve();
+        const result = previous.catch(() => undefined).then(operation);
+        const barrier = result.then(() => undefined, () => undefined);
+        JsonFileFlexHarnessStore.fileQueues.set(filePath, barrier);
+        void barrier.then(() => {
+            if (JsonFileFlexHarnessStore.fileQueues.get(filePath) === barrier) {
+                JsonFileFlexHarnessStore.fileQueues.delete(filePath);
+            }
+        });
+        return result;
+    }
+    filePath(storageKey) {
+        const digest = plugins.crypto.createHash('sha256').update(storageKey).digest('hex');
+        return plugins.path.join(this.directory, `${digest}.json`);
+    }
+    async preparePath(filePath) {
+        await plugins.fs.mkdir(this.directory, { recursive: true, mode: 0o700 });
+        await plugins.fs.chmod(this.directory, 0o700);
+        await this.cleanupTemps(filePath);
+    }
+    async cleanupTemps(filePath) {
+        const prefix = `${plugins.path.basename(filePath)}.`;
+        const entries = await plugins.fs.readdir(this.directory, { withFileTypes: true });
+        await Promise.all(entries
+            .filter((entry) => entry.isFile() && entry.name.startsWith(prefix) && entry.name.endsWith('.tmp'))
+            .map(async (entry) => {
+            try {
+                await plugins.fs.unlink(plugins.path.join(this.directory, entry.name));
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT') {
+                    throw error;
+                }
+            }
+        }));
+    }
+    async readSnapshot(filePath) {
+        let serialized;
+        try {
+            await plugins.fs.chmod(filePath, 0o600);
+            serialized = await plugins.fs.readFile(filePath, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return undefined;
+            }
+            throw error;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(serialized);
+        }
+        catch (error) {
+            throw new FlexHarnessStoreFormatError(`Malformed JSON snapshot at ${filePath}.`, {
+                cause: error,
+            });
+        }
+        try {
+            assertFlexHarnessSnapshot(parsed);
+        }
+        catch (error) {
+            if (error instanceof FlexHarnessStoreFormatError) {
+                throw new FlexHarnessStoreFormatError(`Invalid snapshot at ${filePath}: ${error.message}`, {
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+        return cloneSerializable(parsed);
+    }
+    async writeSnapshot(filePath, snapshot) {
+        const tempPath = `${filePath}.${process.pid}.${plugins.crypto.randomUUID()}.tmp`;
+        let fileHandle;
+        try {
+            fileHandle = await plugins.fs.open(tempPath, 'wx', 0o600);
+            await fileHandle.writeFile(`${JSON.stringify(snapshot, null, 2)}\n`, 'utf8');
+            await fileHandle.sync();
+            await fileHandle.close();
+            fileHandle = undefined;
+            await plugins.fs.chmod(tempPath, 0o600);
+            await plugins.fs.rename(tempPath, filePath);
+            await plugins.fs.chmod(filePath, 0o600);
+        }
+        finally {
+            await fileHandle?.close().catch(() => undefined);
+            await plugins.fs.unlink(tempPath).catch((error) => {
+                if (error.code !== 'ENOENT') {
+                    throw error;
+                }
+            });
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5zdG9yZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9jbGFzc2VzLnN0b3Jlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQ0wsNkJBQTZCLEVBQzdCLDJCQUEyQixFQUMzQiwwQkFBMEIsR0FDM0IsTUFBTSxhQUFhLENBQUM7QUFFckIsT0FBTyxFQUFFLHlCQUF5QixFQUFFLGlCQUFpQixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFFL0UsU0FBUyxZQUFZLENBQ25CLFFBQThCLEVBQzlCLGdCQUF3QjtJQUV4Qix5QkFBeUIsQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUNwQyxJQUFJLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxnQkFBZ0IsQ0FBQyxJQUFJLGdCQUFnQixHQUFHLENBQUMsRUFBRSxDQUFDO1FBQ3BFLE1BQU0sSUFBSSwwQkFBMEIsQ0FBQyxrREFBa0QsQ0FBQyxDQUFDO0lBQzNGLENBQUM7SUFDRCxJQUFJLFFBQVEsQ0FBQyxRQUFRLEtBQUssZ0JBQWdCLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDL0MsTUFBTSxJQUFJLDJCQUEyQixDQUNuQyxxQkFBcUIsUUFBUSxDQUFDLFFBQVEsaUNBQWlDLGdCQUFnQixZQUFZLENBQ3BHLENBQUM7SUFDSixDQUFDO0lBQ0QsT0FBTyxpQkFBaUIsQ0FBQyxRQUFRLENBQUMsQ0FBQztBQUNyQyxDQUFDO0FBRUQsTUFBTSxPQUFPLHdCQUF3QjtJQUNsQixTQUFTLEdBQUcsSUFBSSxHQUFHLEVBQWdDLENBQUM7SUFFOUQsS0FBSyxDQUFDLElBQUksQ0FBQyxVQUFrQjtRQUNsQyxNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUNoRCxPQUFPLFFBQVEsQ0FBQyxDQUFDLENBQUMsaUJBQWlCLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztJQUM1RCxDQUFDO0lBRU0sS0FBSyxDQUFDLElBQUksQ0FDZixVQUFrQixFQUNsQixRQUE4QixFQUM5QixnQkFBd0I7UUFFeEIsTUFBTSxTQUFTLEdBQUcsWUFBWSxDQUFDLFFBQVEsRUFBRSxnQkFBZ0IsQ0FBQyxDQUFDO1FBQzNELE1BQU0sY0FBYyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxFQUFFLFFBQVEsSUFBSSxDQUFDLENBQUM7UUFDckUsSUFBSSxjQUFjLEtBQUssZ0JBQWdCLEVBQUUsQ0FBQztZQUN4QyxNQUFNLElBQUksNkJBQTZCLENBQUMsVUFBVSxFQUFFLGdCQUFnQixFQUFFLGNBQWMsQ0FBQyxDQUFDO1FBQ3hGLENBQUM7UUFDRCxJQUFJLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxVQUFVLEVBQUUsU0FBUyxDQUFDLENBQUM7SUFDNUMsQ0FBQztDQUNGO0FBTUQ7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLHdCQUF3QjtJQUMzQixNQUFNLENBQVUsVUFBVSxHQUFHLElBQUksR0FBRyxFQUF5QixDQUFDO0lBQ3JELFNBQVMsQ0FBUztJQUVuQyxZQUFZLE9BQXlDO1FBQ25ELElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLENBQUM7WUFDdkIsTUFBTSxJQUFJLDBCQUEwQixDQUFDLGdEQUFnRCxDQUFDLENBQUM7UUFDekYsQ0FBQztRQUNELElBQUksQ0FBQyxTQUFTLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzNELENBQUM7SUFFTSxLQUFLLENBQUMsSUFBSSxDQUFDLFVBQWtCO1FBQ2xDLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxRQUFRLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDM0MsT0FBTyx3QkFBd0IsQ0FBQyxXQUFXLENBQUMsUUFBUSxFQUFFLEtBQUssSUFBSSxFQUFFO1lBQy9ELE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxRQUFRLENBQUMsQ0FBQztZQUNqQyxPQUFPLElBQUksQ0FBQyxZQUFZLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDckMsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRU0sS0FBSyxDQUFDLElBQUksQ0FDZixVQUFrQixFQUNsQixRQUE4QixFQUM5QixnQkFBd0I7UUFFeEIsTUFBTSxTQUFTLEdBQUcsWUFBWSxDQUFDLFFBQVEsRUFBRSxnQkFBZ0IsQ0FBQyxDQUFDO1FBQzNELE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxRQUFRLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDM0MsTUFBTSx3QkFBd0IsQ0FBQyxXQUFXLENBQUMsUUFBUSxFQUFFLEtBQUssSUFBSSxFQUFFO1lBQzlELE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxRQUFRLENBQUMsQ0FBQztZQUNqQyxNQUFNLE9BQU8sR0FBRyxNQUFNLElBQUksQ0FBQyxZQUFZLENBQUMsUUFBUSxDQUFDLENBQUM7WUFDbEQsTUFBTSxjQUFjLEdBQUcsT0FBTyxFQUFFLFFBQVEsSUFBSSxDQUFDLENBQUM7WUFDOUMsSUFBSSxjQUFjLEtBQUssZ0JBQWdCLEVBQUUsQ0FBQztnQkFDeEMsTUFBTSxJQUFJLDZCQUE2QixDQUFDLFVBQVUsRUFBRSxnQkFBZ0IsRUFBRSxjQUFjLENBQUMsQ0FBQztZQUN4RixDQUFDO1lBQ0QsTUFBTSxJQUFJLENBQUMsYUFBYSxDQUFDLFFBQVEsRUFBRSxTQUFTLENBQUMsQ0FBQztRQUNoRCxDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7SUFFTyxNQUFNLENBQUMsV0FBVyxDQUFJLFFBQWdCLEVBQUUsU0FBMkI7UUFDekUsTUFBTSxRQUFRLEdBQUcsd0JBQXdCLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsSUFBSSxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDeEYsTUFBTSxNQUFNLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyxHQUFHLEVBQUUsQ0FBQyxTQUFTLENBQUMsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDL0QsTUFBTSxPQUFPLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FDekIsR0FBRyxFQUFFLENBQUMsU0FBUyxFQUNmLEdBQUcsRUFBRSxDQUFDLFNBQVMsQ0FDaEIsQ0FBQztRQUNGLHdCQUF3QixDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsUUFBUSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQzNELEtBQUssT0FBTyxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUU7WUFDckIsSUFBSSx3QkFBd0IsQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxLQUFLLE9BQU8sRUFBRSxDQUFDO2dCQUNsRSx3QkFBd0IsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxDQUFDO1lBQ3ZELENBQUM7UUFDSCxDQUFDLENBQUMsQ0FBQztRQUNILE9BQU8sTUFBTSxDQUFDO0lBQ2hCLENBQUM7SUFFTyxRQUFRLENBQUMsVUFBa0I7UUFDakMsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDLENBQUMsTUFBTSxDQUFDLFVBQVUsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUNwRixPQUFPLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsR0FBRyxNQUFNLE9BQU8sQ0FBQyxDQUFDO0lBQzdELENBQUM7SUFFTyxLQUFLLENBQUMsV0FBVyxDQUFDLFFBQWdCO1FBQ3hDLE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxFQUFFLFNBQVMsRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRSxDQUFDLENBQUM7UUFDekUsTUFBTSxPQUFPLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQzlDLE1BQU0sSUFBSSxDQUFDLFlBQVksQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUNwQyxDQUFDO0lBRU8sS0FBSyxDQUFDLFlBQVksQ0FBQyxRQUFnQjtRQUN6QyxNQUFNLE1BQU0sR0FBRyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUM7UUFDckQsTUFBTSxPQUFPLEdBQUcsTUFBTSxPQUFPLENBQUMsRUFBRSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLEVBQUUsYUFBYSxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7UUFDbEYsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUNmLE9BQU87YUFDSixNQUFNLENBQUMsQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLEtBQUssQ0FBQyxNQUFNLEVBQUUsSUFBSSxLQUFLLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUMsSUFBSSxLQUFLLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQzthQUNqRyxHQUFHLENBQUMsS0FBSyxFQUFFLEtBQUssRUFBRSxFQUFFO1lBQ25CLElBQUksQ0FBQztnQkFDSCxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUM7WUFDekUsQ0FBQztZQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7Z0JBQ2YsSUFBSyxLQUErQixDQUFDLElBQUksS0FBSyxRQUFRLEVBQUUsQ0FBQztvQkFDdkQsTUFBTSxLQUFLLENBQUM7Z0JBQ2QsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDLENBQUMsQ0FDTCxDQUFDO0lBQ0osQ0FBQztJQUVPLEtBQUssQ0FBQyxZQUFZLENBQUMsUUFBZ0I7UUFDekMsSUFBSSxVQUFrQixDQUFDO1FBQ3ZCLElBQUksQ0FBQztZQUNILE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxLQUFLLENBQUMsUUFBUSxFQUFFLEtBQUssQ0FBQyxDQUFDO1lBQ3hDLFVBQVUsR0FBRyxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLFFBQVEsRUFBRSxNQUFNLENBQUMsQ0FBQztRQUMzRCxDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLElBQUssS0FBK0IsQ0FBQyxJQUFJLEtBQUssUUFBUSxFQUFFLENBQUM7Z0JBQ3ZELE9BQU8sU0FBUyxDQUFDO1lBQ25CLENBQUM7WUFDRCxNQUFNLEtBQUssQ0FBQztRQUNkLENBQUM7UUFFRCxJQUFJLE1BQWUsQ0FBQztRQUNwQixJQUFJLENBQUM7WUFDSCxNQUFNLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUNsQyxDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLE1BQU0sSUFBSSwyQkFBMkIsQ0FBQyw4QkFBOEIsUUFBUSxHQUFHLEVBQUU7Z0JBQy9FLEtBQUssRUFBRSxLQUFLO2FBQ2IsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUNELElBQUksQ0FBQztZQUNILHlCQUF5QixDQUFDLE1BQU0sQ0FBQyxDQUFDO1FBQ3BDLENBQUM7UUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1lBQ2YsSUFBSSxLQUFLLFlBQVksMkJBQTJCLEVBQUUsQ0FBQztnQkFDakQsTUFBTSxJQUFJLDJCQUEyQixDQUFDLHVCQUF1QixRQUFRLEtBQUssS0FBSyxDQUFDLE9BQU8sRUFBRSxFQUFFO29CQUN6RixLQUFLLEVBQUUsS0FBSztpQkFDYixDQUFDLENBQUM7WUFDTCxDQUFDO1lBQ0QsTUFBTSxLQUFLLENBQUM7UUFDZCxDQUFDO1FBQ0QsT0FBTyxpQkFBaUIsQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUNuQyxDQUFDO0lBRU8sS0FBSyxDQUFDLGFBQWEsQ0FDekIsUUFBZ0IsRUFDaEIsUUFBOEI7UUFFOUIsTUFBTSxRQUFRLEdBQUcsR0FBRyxRQUFRLElBQUksT0FBTyxDQUFDLEdBQUcsSUFBSSxPQUFPLENBQUMsTUFBTSxDQUFDLFVBQVUsRUFBRSxNQUFNLENBQUM7UUFDakYsSUFBSSxVQUE2QyxDQUFDO1FBQ2xELElBQUksQ0FBQztZQUNILFVBQVUsR0FBRyxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxJQUFJLEVBQUUsS0FBSyxDQUFDLENBQUM7WUFDMUQsTUFBTSxVQUFVLENBQUMsU0FBUyxDQUFDLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxRQUFRLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQyxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7WUFDN0UsTUFBTSxVQUFVLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDeEIsTUFBTSxVQUFVLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDekIsVUFBVSxHQUFHLFNBQVMsQ0FBQztZQUN2QixNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsS0FBSyxDQUFDLFFBQVEsRUFBRSxLQUFLLENBQUMsQ0FBQztZQUN4QyxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsTUFBTSxDQUFDLFFBQVEsRUFBRSxRQUFRLENBQUMsQ0FBQztZQUM1QyxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsS0FBSyxDQUFDLFFBQVEsRUFBRSxLQUFLLENBQUMsQ0FBQztRQUMxQyxDQUFDO2dCQUFTLENBQUM7WUFDVCxNQUFNLFVBQVUsRUFBRSxLQUFLLEVBQUUsQ0FBQyxLQUFLLENBQUMsR0FBRyxFQUFFLENBQUMsU0FBUyxDQUFDLENBQUM7WUFDakQsTUFBTSxPQUFPLENBQUMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxLQUE0QixFQUFFLEVBQUU7Z0JBQ3ZFLElBQUksS0FBSyxDQUFDLElBQUksS0FBSyxRQUFRLEVBQUUsQ0FBQztvQkFDNUIsTUFBTSxLQUFLLENBQUM7Z0JBQ2QsQ0FBQztZQUNILENBQUMsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztJQUNILENBQUMifQ==

package/dist_ts/errors.d.ts

@@ -0,0 +1,44 @@
+import type { IFlexErrorInfo } from './interfaces.js';
+export declare class FlexHarnessError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: ErrorOptions);
+}
+export declare class FlexHarnessValidationError extends FlexHarnessError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class FlexHarnessClosedError extends FlexHarnessError {
+    constructor();
+}
+export declare class FlexHarnessNotFoundError extends FlexHarnessError {
+    constructor(resource: string, id: string);
+}
+export declare class FlexHarnessSessionBusyError extends FlexHarnessError {
+    constructor(sessionId: string, reason?: string);
+}
+export declare class FlexHarnessAbortError extends FlexHarnessError {
+    constructor(message?: string, options?: ErrorOptions);
+}
+export declare class FlexHarnessCallbackOverflowError extends FlexHarnessError {
+    constructor(message: string);
+}
+export declare class FlexHarnessPermissionRejectedError extends FlexHarnessError {
+    constructor(permissionId: string, options?: ErrorOptions);
+}
+export declare class FlexHarnessPermissionStateError extends FlexHarnessError {
+    constructor(message: string);
+}
+export declare class FlexHarnessStoreConflictError extends FlexHarnessError {
+    readonly storageKey: string;
+    readonly expectedRevision: number;
+    readonly actualRevision: number;
+    constructor(storageKey: string, expectedRevision: number, actualRevision: number);
+}
+export declare class FlexHarnessStoreFormatError extends FlexHarnessError {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class FlexHarnessRunError extends AggregateError {
+    readonly code = "FLEX_RUN_FAILED";
+    constructor(errors: unknown[]);
+}
+export declare function errorToInfo(error: unknown): IFlexErrorInfo;
+export declare function errorMessage(error: unknown): string;

package/dist_ts/errors.js

@@ -0,0 +1,105 @@
+export class FlexHarnessError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = 'FlexHarnessError';
+        this.code = code;
+    }
+}
+export class FlexHarnessValidationError extends FlexHarnessError {
+    constructor(message, options) {
+        super('FLEX_VALIDATION', message, options);
+        this.name = 'FlexHarnessValidationError';
+    }
+}
+export class FlexHarnessClosedError extends FlexHarnessError {
+    constructor() {
+        super('FLEX_CLOSED', 'FlexHarness is disposed.');
+        this.name = 'FlexHarnessClosedError';
+    }
+}
+export class FlexHarnessNotFoundError extends FlexHarnessError {
+    constructor(resource, id) {
+        super('FLEX_NOT_FOUND', `${resource} "${id}" was not found.`);
+        this.name = 'FlexHarnessNotFoundError';
+    }
+}
+export class FlexHarnessSessionBusyError extends FlexHarnessError {
+    constructor(sessionId, reason = 'already has an active run') {
+        super('FLEX_SESSION_BUSY', `Session "${sessionId}" ${reason}.`);
+        this.name = 'FlexHarnessSessionBusyError';
+    }
+}
+export class FlexHarnessAbortError extends FlexHarnessError {
+    constructor(message = 'The run was aborted.', options) {
+        super('FLEX_ABORTED', message, options);
+        this.name = 'FlexHarnessAbortError';
+    }
+}
+export class FlexHarnessCallbackOverflowError extends FlexHarnessError {
+    constructor(message) {
+        super('FLEX_CALLBACK_OVERFLOW', message);
+        this.name = 'FlexHarnessCallbackOverflowError';
+    }
+}
+export class FlexHarnessPermissionRejectedError extends FlexHarnessError {
+    constructor(permissionId, options) {
+        super('FLEX_PERMISSION_REJECTED', `Permission "${permissionId}" was rejected.`, options);
+        this.name = 'FlexHarnessPermissionRejectedError';
+    }
+}
+export class FlexHarnessPermissionStateError extends FlexHarnessError {
+    constructor(message) {
+        super('FLEX_PERMISSION_STATE', message);
+        this.name = 'FlexHarnessPermissionStateError';
+    }
+}
+export class FlexHarnessStoreConflictError extends FlexHarnessError {
+    storageKey;
+    expectedRevision;
+    actualRevision;
+    constructor(storageKey, expectedRevision, actualRevision) {
+        super('FLEX_STORE_CONFLICT', `Snapshot conflict for storage key "${storageKey}": expected revision ${expectedRevision}, found ${actualRevision}.`);
+        this.name = 'FlexHarnessStoreConflictError';
+        this.storageKey = storageKey;
+        this.expectedRevision = expectedRevision;
+        this.actualRevision = actualRevision;
+    }
+}
+export class FlexHarnessStoreFormatError extends FlexHarnessError {
+    constructor(message, options) {
+        super('FLEX_STORE_FORMAT', message, options);
+        this.name = 'FlexHarnessStoreFormatError';
+    }
+}
+export class FlexHarnessRunError extends AggregateError {
+    code = 'FLEX_RUN_FAILED';
+    constructor(errors) {
+        super(errors, 'Multiple FlexHarness run or cleanup operations failed.');
+        this.name = 'FlexHarnessRunError';
+    }
+}
+export function errorToInfo(error) {
+    if (error instanceof FlexHarnessError) {
+        return {
+            name: error.name,
+            message: error.message,
+            code: error.code,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            ...('code' in error && typeof error.code === 'string' ? { code: error.code } : {}),
+        };
+    }
+    return {
+        name: 'Error',
+        message: String(error),
+    };
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE1BQU0sT0FBTyxnQkFBaUIsU0FBUSxLQUFLO0lBQ3pCLElBQUksQ0FBUztJQUU3QixZQUFZLElBQVksRUFBRSxPQUFlLEVBQUUsT0FBc0I7UUFDL0QsS0FBSyxDQUFDLE9BQU8sRUFBRSxPQUFPLENBQUMsQ0FBQztRQUN4QixJQUFJLENBQUMsSUFBSSxHQUFHLGtCQUFrQixDQUFDO1FBQy9CLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDO0lBQ25CLENBQUM7Q0FDRjtBQUVELE1BQU0sT0FBTywwQkFBMkIsU0FBUSxnQkFBZ0I7SUFDOUQsWUFBWSxPQUFlLEVBQUUsT0FBc0I7UUFDakQsS0FBSyxDQUFDLGlCQUFpQixFQUFFLE9BQU8sRUFBRSxPQUFPLENBQUMsQ0FBQztRQUMzQyxJQUFJLENBQUMsSUFBSSxHQUFHLDRCQUE0QixDQUFDO0lBQzNDLENBQUM7Q0FDRjtBQUVELE1BQU0sT0FBTyxzQkFBdUIsU0FBUSxnQkFBZ0I7SUFDMUQ7UUFDRSxLQUFLLENBQUMsYUFBYSxFQUFFLDBCQUEwQixDQUFDLENBQUM7UUFDakQsSUFBSSxDQUFDLElBQUksR0FBRyx3QkFBd0IsQ0FBQztJQUN2QyxDQUFDO0NBQ0Y7QUFFRCxNQUFNLE9BQU8sd0JBQXlCLFNBQVEsZ0JBQWdCO0lBQzVELFlBQVksUUFBZ0IsRUFBRSxFQUFVO1FBQ3RDLEtBQUssQ0FBQyxnQkFBZ0IsRUFBRSxHQUFHLFFBQVEsS0FBSyxFQUFFLGtCQUFrQixDQUFDLENBQUM7UUFDOUQsSUFBSSxDQUFDLElBQUksR0FBRywwQkFBMEIsQ0FBQztJQUN6QyxDQUFDO0NBQ0Y7QUFFRCxNQUFNLE9BQU8sMkJBQTRCLFNBQVEsZ0JBQWdCO0lBQy9ELFlBQVksU0FBaUIsRUFBRSxNQUFNLEdBQUcsMkJBQTJCO1FBQ2pFLEtBQUssQ0FBQyxtQkFBbUIsRUFB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

package/dist_ts/index.d.ts

@@ -0,0 +1,5 @@
+export * from './classes.flexharness.js';
+export * from './classes.stores.js';
+export * from './errors.js';
+export * from './interfaces.js';
+export { normalizeJsonValue } from './utils.json.js';

package/dist_ts/index.js

@@ -0,0 +1,6 @@
+export * from './classes.flexharness.js';
+export * from './classes.stores.js';
+export * from './errors.js';
+export * from './interfaces.js';
+export { normalizeJsonValue } from './utils.json.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQyJ9

package/dist_ts/interfaces.d.ts

@@ -0,0 +1,288 @@
+import type * as plugins from './plugins.js';
+export type TJsonPrimitive = string | number | boolean | null;
+export interface IJsonObject {
+    [key: string]: TJsonValue;
+}
+export type TJsonValue = TJsonPrimitive | IJsonObject | TJsonValue[];
+export type TFlexAgentRunOptions = plugins.IAgentRunOptions;
+export type TFlexAgentRunResult = plugins.IAgentRunResult;
+export type TFlexAgentRunner = (options: TFlexAgentRunOptions) => Promise<TFlexAgentRunResult>;
+export type TFlexAgentModel = TFlexAgentRunOptions['model'];
+export type TFlexAgentPrompt = TFlexAgentRunOptions['prompt'];
+export type TFlexAgentModelMessage = NonNullable<TFlexAgentRunOptions['messages']>[number];
+export type TFlexAgentToolSet = NonNullable<TFlexAgentRunOptions['tools']>;
+export type TFlexAgentProviderOptions = TFlexAgentRunOptions['providerOptions'];
+export type TFlexAgentCacheSetting = TFlexAgentRunOptions['cache'];
+export type TFlexAgentToolCallFinishEvent = Parameters<NonNullable<TFlexAgentRunOptions['onToolCallFinish']>>[0];
+export interface IFlexTextPromptPart {
+    type: 'text';
+    text: string;
+}
+export interface IFlexImagePromptPart {
+    type: 'image';
+    data: string;
+    mediaType?: string;
+    name?: string;
+}
+export interface IFlexFilePromptPart {
+    type: 'file';
+    data: string;
+    mediaType: string;
+    name?: string;
+}
+export type TFlexPromptPart = IFlexTextPromptPart | IFlexImagePromptPart | IFlexFilePromptPart;
+export type TFlexPrompt = string | TFlexPromptPart[];
+export interface IFlexUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+}
+export interface IFlexModelIdentity {
+    provider: string;
+    model: string;
+    displayName?: string;
+}
+export type TFlexActivityStatus = 'idle' | 'running' | 'waiting_permission' | 'failed' | 'cancelled';
+export type TFlexMessageStatus = 'streaming' | 'completed' | 'failed' | 'cancelled';
+export type TFlexToolPartStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+export type TFlexAttachmentSource = 'inline-base64' | 'data-url' | 'remote-url';
+export interface IFlexTextMessagePart {
+    partId: string;
+    type: 'text';
+    text: string;
+}
+export interface IFlexReasoningMessagePart {
+    partId: string;
+    type: 'reasoning';
+    text: string;
+    status: 'running' | 'completed' | 'cancelled';
+}
+export interface IFlexToolMessagePart {
+    partId: string;
+    type: 'tool';
+    toolCallId: string;
+    toolName: string;
+    status: TFlexToolPartStatus;
+    input: TJsonValue;
+    output?: TJsonValue;
+    error?: string;
+}
+export interface IFlexAttachmentMessagePart {
+    partId: string;
+    type: 'attachment';
+    attachmentType: 'image' | 'file';
+    source: TFlexAttachmentSource;
+    sizeBytes?: number;
+    mediaType?: string;
+    name?: string;
+}
+export type TFlexMessagePart = IFlexTextMessagePart | IFlexReasoningMessagePart | IFlexToolMessagePart | IFlexAttachmentMessagePart;
+export interface IFlexMessage {
+    messageId: string;
+    sessionId: string;
+    runId: string;
+    role: 'user' | 'assistant';
+    status: TFlexMessageStatus;
+    createdAt: string;
+    completedAt?: string;
+    parts: TFlexMessagePart[];
+    model?: IFlexModelIdentity;
+    usage?: IFlexUsage;
+    error?: string;
+}
+export interface IFlexSessionActivity {
+    runId?: string;
+    status: TFlexActivityStatus;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+}
+export interface IFlexSession {
+    scopeId: string;
+    sessionId: string;
+    title?: string;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt?: string;
+    status: TFlexActivityStatus;
+    activity: IFlexSessionActivity;
+}
+export interface IFlexCreateSessionOptions {
+    sessionId?: string;
+    title?: string;
+}
+export interface IFlexUpdateSessionOptions {
+    title?: string | null;
+    archived?: boolean;
+}
+export interface IFlexPromptOptions {
+    modelHint?: string;
+    system?: string;
+    maxSteps?: number;
+}
+export interface IFlexPromptResult {
+    runId: string;
+    sessionId: string;
+    userMessage: IFlexMessage;
+    assistantMessage: IFlexMessage;
+    model: IFlexModelIdentity;
+    usage: IFlexUsage;
+    finishReason: string;
+    steps: number;
+}
+export interface IFlexResolvedScope<TScope> {
+    storageKey: string;
+    scope: TScope;
+}
+export interface IFlexScopeResolver<TScope> {
+    resolveScope(scopeId: string): Promise<IFlexResolvedScope<TScope>> | IFlexResolvedScope<TScope>;
+}
+export interface IFlexModelResolverContext<TScope> {
+    scopeId: string;
+    scope: TScope;
+    sessionId: string;
+    runId: string;
+    modelHint?: string;
+    signal: AbortSignal;
+}
+export interface IFlexResolvedModel {
+    model: TFlexAgentModel;
+    identity: IFlexModelIdentity;
+    system?: string;
+    providerOptions?: TFlexAgentProviderOptions;
+    cache?: TFlexAgentCacheSetting;
+    maxSteps?: number;
+}
+export interface IFlexModelResolver<TScope> {
+    resolveModel(context: IFlexModelResolverContext<TScope>): Promise<IFlexResolvedModel> | IFlexResolvedModel;
+}
+export interface IFlexPermissionRequestInput {
+    kind: string;
+    description: string;
+    toolCallId?: string;
+    rememberKey?: string;
+    metadata?: TJsonValue;
+}
+export interface IFlexPermissionRequest extends IFlexPermissionRequestInput {
+    permissionId: string;
+    scopeId: string;
+    sessionId: string;
+    runId: string;
+    createdAt: string;
+}
+export type TFlexPermissionDecision = 'once' | 'always' | 'reject';
+export interface IFlexToolProviderContext<TScope> {
+    scopeId: string;
+    scope: TScope;
+    sessionId: string;
+    runId: string;
+    signal: AbortSignal;
+    requestPermission(request: IFlexPermissionRequestInput): Promise<void>;
+}
+export interface IFlexToolHandle {
+    tools: TFlexAgentToolSet;
+    close?(): Promise<void> | void;
+}
+export interface IFlexToolProvider<TScope> {
+    provideTools(context: IFlexToolProviderContext<TScope>): Promise<IFlexToolHandle | undefined> | IFlexToolHandle | undefined;
+}
+export interface IFlexStoredSessionSnapshot {
+    session: IFlexSession;
+    messages: IFlexMessage[];
+    modelHistory: TJsonValue[];
+    rememberedPermissionKeys: string[];
+}
+export interface IFlexHarnessSnapshot {
+    schemaVersion: 1;
+    revision: number;
+    sessions: IFlexStoredSessionSnapshot[];
+}
+export interface IFlexHarnessStore {
+    load(storageKey: string): Promise<IFlexHarnessSnapshot | undefined>;
+    save(storageKey: string, snapshot: IFlexHarnessSnapshot, expectedRevision: number): Promise<void>;
+}
+export interface IFlexJsonLimits {
+    maxDepth?: number;
+    maxBytes?: number;
+}
+export interface IFlexCallbackLimits {
+    maxEvents?: number;
+    maxOutputBytes?: number;
+    maxParts?: number;
+}
+export interface IFlexHarnessOptions<TScope> {
+    scopeResolver: IFlexScopeResolver<TScope>;
+    modelResolver: IFlexModelResolver<TScope>;
+    toolProvider?: IFlexToolProvider<TScope>;
+    store?: IFlexHarnessStore;
+    runner?: TFlexAgentRunner;
+    toolOutputLimits?: IFlexJsonLimits;
+    callbackLimits?: IFlexCallbackLimits;
+}
+export interface IFlexEventBase {
+    readonly eventId: string;
+    readonly sequence: number;
+    readonly timestamp: string;
+    readonly scopeId: string;
+    readonly sessionId: string;
+}
+export interface IFlexSessionCreatedEvent extends IFlexEventBase {
+    readonly type: 'session.created';
+    readonly session: IFlexSession;
+}
+export interface IFlexSessionUpdatedEvent extends IFlexEventBase {
+    readonly type: 'session.updated';
+    readonly session: IFlexSession;
+}
+export interface IFlexSessionDeletedEvent extends IFlexEventBase {
+    readonly type: 'session.deleted';
+    readonly session: IFlexSession;
+}
+export interface IFlexRunStartedEvent extends IFlexEventBase {
+    readonly type: 'run.started';
+    readonly runId: string;
+    readonly messageId: string;
+    readonly session: IFlexSession;
+}
+export interface IFlexMessageChangedEvent extends IFlexEventBase {
+    readonly type: 'message.created' | 'message.updated';
+    readonly runId: string;
+    readonly messageId: string;
+    readonly message: IFlexMessage;
+}
+export interface IFlexPartChangedEvent extends IFlexEventBase {
+    readonly type: 'part.started' | 'part.delta' | 'part.completed';
+    readonly runId: string;
+    readonly messageId: string;
+    readonly partId: string;
+    readonly part: TFlexMessagePart;
+    readonly delta?: string;
+}
+export interface IFlexPermissionRequestedEvent extends IFlexEventBase {
+    readonly type: 'permission.requested';
+    readonly runId: string;
+    readonly request: IFlexPermissionRequest;
+}
+export interface IFlexPermissionResolvedEvent extends IFlexEventBase {
+    readonly type: 'permission.resolved';
+    readonly runId: string;
+    readonly request: IFlexPermissionRequest;
+    readonly decision: TFlexPermissionDecision;
+}
+export interface IFlexRunFinishedEvent extends IFlexEventBase {
+    readonly type: 'run.finished';
+    readonly runId: string;
+    readonly messageId: string;
+    readonly status: 'completed' | 'failed' | 'cancelled';
+    readonly message: IFlexMessage;
+    readonly error?: IFlexErrorInfo;
+}
+export interface IFlexErrorInfo {
+    name: string;
+    message: string;
+    code?: string;
+}
+export type TFlexHarnessEvent = IFlexSessionCreatedEvent | IFlexSessionUpdatedEvent | IFlexSessionDeletedEvent | IFlexRunStartedEvent | IFlexMessageChangedEvent | IFlexPartChangedEvent | IFlexPermissionRequestedEvent | IFlexPermissionResolvedEvent | IFlexRunFinishedEvent;
+export type TFlexHarnessEventListener = (event: TFlexHarnessEvent) => void;

package/dist_ts/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist_ts/plugins.d.ts

@@ -0,0 +1,7 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export { crypto, fs, path };
+import { runAgent } from '@push.rocks/smartagent';
+export { runAgent };
+export type { IAgentRunOptions, IAgentRunResult, } from '@push.rocks/smartagent';

package/dist_ts/plugins.js

@@ -0,0 +1,9 @@
+// node native scope
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export { crypto, fs, path };
+// @push.rocks scope
+import { runAgent } from '@push.rocks/smartagent';
+export { runAgent };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBQ3RDLE9BQU8sS0FBSyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDdkMsT0FBTyxLQUFLLElBQUksTUFBTSxXQUFXLENBQUM7QUFFbEMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUM7QUFFNUIsb0JBQW9CO0FBQ3BCLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUVsRCxPQUFPLEVBQUUsUUFBUSxFQUFFLENBQUMifQ==