agl 1.0.17 → 21.0.2

package/dist_ts/classes.uploadmanager.d.ts

@@ -0,0 +1,24 @@
+import { type IControllerDraftAttachment } from '../dist_ts_interfaces/interfaces.js';
+export interface IControllerUploadHandle {
+    id: string;
+    directory: string;
+    paths: string[];
+    promptSuffix: string;
+    bytes: number;
+    cleanup(): Promise<void>;
+}
+export declare class ControllerUploadManager {
+    private rootPromise?;
+    private readonly activeUploads;
+    private readonly pendingCreates;
+    private activeUploadCount;
+    private activeBytes;
+    private closed;
+    private closePromise?;
+    create(attachmentsArg: readonly IControllerDraftAttachment[]): Promise<IControllerUploadHandle | undefined>;
+    close(): Promise<void>;
+    private createReserved;
+    private closeInternal;
+    private ensureRoot;
+    private cleanup;
+}

package/dist_ts/classes.uploadmanager.js

@@ -0,0 +1,210 @@
+import * as plugins from './plugins.js';
+import { controllerMaxAttachmentPromptSuffixBytes, controllerMaxDraftAttachmentBytes, controllerMaxDraftAttachmentTotalBytes, controllerMaxDraftAttachments, } from '../dist_ts_interfaces/interfaces.js';
+const maximumActiveUploads = 64;
+const maximumActiveUploadBytes = 64 * 1024 * 1024;
+export class ControllerUploadManager {
+    rootPromise;
+    activeUploads = new Map();
+    pendingCreates = new Set();
+    activeUploadCount = 0;
+    activeBytes = 0;
+    closed = false;
+    closePromise;
+    create(attachmentsArg) {
+        if (attachmentsArg.length === 0)
+            return Promise.resolve(undefined);
+        if (this.closed)
+            throw new Error('The controller upload manager is closed.');
+        if (attachmentsArg.length > controllerMaxDraftAttachments) {
+            throw new Error('The attachment count exceeds the controller limit.');
+        }
+        if (this.activeUploadCount >= maximumActiveUploads) {
+            throw new Error('The controller has too many active uploads.');
+        }
+        const decoded = attachmentsArg.map((attachment, index) => {
+            if (attachment.name.length === 0
+                || attachment.name !== plugins.path.basename(attachment.name)
+                || Buffer.byteLength(attachment.name, 'utf8') > 255
+                // eslint-disable-next-line no-control-regex
+                || /[\x00-\x1f\x7f/\\]/.test(attachment.name)) {
+                throw new Error(`Attachment ${index + 1} has an unsafe file name.`);
+            }
+            if (attachment.mediaType.length === 0
+                || Buffer.byteLength(attachment.mediaType, 'utf8') > 129
+                // eslint-disable-next-line no-control-regex
+                || /[\x00-\x20\x7f]/.test(attachment.mediaType))
+                throw new Error(`Attachment ${index + 1} has an unsafe media type.`);
+            const data = Buffer.from(attachment.dataBase64, 'base64');
+            if (data.toString('base64') !== attachment.dataBase64) {
+                throw new Error(`Attachment ${index + 1} is not canonical base64.`);
+            }
+            if (data.byteLength !== attachment.size) {
+                throw new Error(`Attachment ${index + 1} size does not match its content.`);
+            }
+            if (data.byteLength > controllerMaxDraftAttachmentBytes) {
+                throw new Error(`Attachment ${index + 1} exceeds the controller byte limit.`);
+            }
+            return { attachment, data };
+        });
+        const bytes = decoded.reduce((sum, entry) => sum + entry.data.byteLength, 0);
+        if (bytes > controllerMaxDraftAttachmentTotalBytes) {
+            throw new Error('The attachments exceed the controller total byte limit.');
+        }
+        if (this.activeBytes + bytes > maximumActiveUploadBytes) {
+            throw new Error('The controller active upload byte limit is exhausted.');
+        }
+        this.activeUploadCount += 1;
+        this.activeBytes += bytes;
+        const createPromise = this.createReserved(decoded, bytes);
+        this.pendingCreates.add(createPromise);
+        void createPromise.finally(() => this.pendingCreates.delete(createPromise)).catch(() => undefined);
+        return createPromise;
+    }
+    async close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.closed = true;
+        const closePromise = this.closeInternal();
+        this.closePromise = closePromise;
+        try {
+            await closePromise;
+        }
+        catch (errorArg) {
+            if (this.closePromise === closePromise)
+                this.closePromise = undefined;
+            throw errorArg;
+        }
+    }
+    async createReserved(decodedArg, bytesArg) {
+        const id = plugins.crypto.randomBytes(16).toString('base64url');
+        let directory;
+        let admitted = false;
+        try {
+            const root = await this.ensureRoot();
+            directory = await plugins.fs.promises.mkdtemp(plugins.path.join(root, 'message-'));
+            await plugins.fs.promises.chmod(directory, 0o700);
+            const paths = [];
+            for (const [index, entry] of decodedArg.entries()) {
+                const filePath = plugins.path.join(directory, `${index + 1}-${entry.attachment.name}`);
+                const relative = plugins.path.relative(directory, filePath);
+                if (relative === '..'
+                    || relative.startsWith(`..${plugins.path.sep}`)
+                    || plugins.path.isAbsolute(relative))
+                    throw new Error('An attachment path escaped its upload directory.');
+                const flags = plugins.fs.constants.O_WRONLY
+                    | plugins.fs.constants.O_CREAT
+                    | plugins.fs.constants.O_EXCL
+                    | (plugins.fs.constants.O_NOFOLLOW ?? 0);
+                const file = await plugins.fs.promises.open(filePath, flags, 0o600);
+                try {
+                    await file.writeFile(entry.data);
+                }
+                finally {
+                    await file.close();
+                }
+                paths.push(filePath);
+            }
+            const promptSuffix = `\n\n[Attached files - stored on disk; read them with filesystem tools]\n${decodedArg
+                .map((entry, index) => `- ${paths[index]} (${entry.attachment.mediaType}, ${entry.data.byteLength} bytes)`)
+                .join('\n')}`;
+            if (Buffer.byteLength(promptSuffix, 'utf8') > controllerMaxAttachmentPromptSuffixBytes) {
+                throw new Error('The generated attachment prompt suffix exceeds its byte limit.');
+            }
+            const handle = {
+                id,
+                directory,
+                paths,
+                promptSuffix,
+                bytes: bytesArg,
+                cleanup: () => this.cleanup(id),
+            };
+            this.activeUploads.set(id, { handle });
+            admitted = true;
+            return handle;
+        }
+        finally {
+            if (!admitted) {
+                if (directory) {
+                    await plugins.fs.promises.rm(directory, { recursive: true, force: true }).catch(() => undefined);
+                }
+                this.activeUploadCount -= 1;
+                this.activeBytes -= bytesArg;
+            }
+        }
+    }
+    async closeInternal() {
+        await Promise.allSettled([...this.pendingCreates]);
+        const results = await Promise.allSettled([...this.activeUploads.values()].map((entry) => entry.handle.cleanup()));
+        const errors = results
+            .filter((result) => result.status === 'rejected')
+            .map((result) => result.reason);
+        if (this.rootPromise) {
+            try {
+                const root = await this.rootPromise;
+                await plugins.fs.promises.rm(root, { recursive: true, force: true });
+                this.activeUploads.clear();
+                this.activeUploadCount = 0;
+                this.activeBytes = 0;
+                errors.length = 0;
+            }
+            catch (errorArg) {
+                errors.push(errorArg);
+            }
+        }
+        if (errors.length > 0)
+            throw new AggregateError(errors, 'Controller upload cleanup failed.');
+    }
+    async ensureRoot() {
+        if (!this.rootPromise) {
+            this.rootPromise = (async () => {
+                let root;
+                try {
+                    root = await plugins.fs.promises.mkdtemp(plugins.path.join(plugins.os.tmpdir(), 'harness-controller-uploads-'));
+                    await plugins.fs.promises.chmod(root, 0o700);
+                    return await plugins.fs.promises.realpath(root);
+                }
+                catch (errorArg) {
+                    if (root) {
+                        await plugins.fs.promises.rm(root, { recursive: true, force: true })
+                            .catch(() => undefined);
+                    }
+                    throw errorArg;
+                }
+            })();
+        }
+        const rootPromise = this.rootPromise;
+        try {
+            return await rootPromise;
+        }
+        catch (errorArg) {
+            if (this.rootPromise === rootPromise)
+                this.rootPromise = undefined;
+            throw errorArg;
+        }
+    }
+    async cleanup(idArg) {
+        const active = this.activeUploads.get(idArg);
+        if (!active)
+            return;
+        if (active.cleanupPromise)
+            return active.cleanupPromise;
+        const cleanupPromise = (async () => {
+            await plugins.fs.promises.rm(active.handle.directory, { recursive: true, force: true });
+            if (this.activeUploads.get(idArg) === active) {
+                this.activeUploads.delete(idArg);
+                this.activeUploadCount -= 1;
+                this.activeBytes -= active.handle.bytes;
+            }
+        })();
+        active.cleanupPromise = cleanupPromise;
+        try {
+            await cleanupPromise;
+        }
+        finally {
+            if (this.activeUploads.get(idArg) === active && active.cleanupPromise === cleanupPromise) {
+                active.cleanupPromise = undefined;
+            }
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy51cGxvYWRtYW5hZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY2xhc3Nlcy51cGxvYWRtYW5hZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFDTCx3Q0FBd0MsRUFDeEMsaUNBQWlDLEVBQ2pDLHNDQUFzQyxFQUN0Qyw2QkFBNkIsR0FFOUIsTUFBTSxnQ0FBZ0MsQ0FBQztBQUV4QyxNQUFNLG9CQUFvQixHQUFHLEVBQUUsQ0FBQztBQUNoQyxNQUFNLHdCQUF3QixHQUFHLEVBQUUsR0FBRyxJQUFJLEdBQUcsSUFBSSxDQUFDO0FBZ0JsRCxNQUFNLE9BQU8sdUJBQXVCO0lBQzFCLFdBQVcsQ0FBbUI7SUFDckIsYUFBYSxHQUFHLElBQUksR0FBRyxFQUF5QixDQUFDO0lBQ2pELGNBQWMsR0FBRyxJQUFJLEdBQUcsRUFBb0MsQ0FBQztJQUN0RSxpQkFBaUIsR0FBRyxDQUFDLENBQUM7SUFDdEIsV0FBVyxHQUFHLENBQUMsQ0FBQztJQUNoQixNQUFNLEdBQUcsS0FBSyxDQUFDO0lBQ2YsWUFBWSxDQUFpQjtJQUU5QixNQUFNLENBQ1gsY0FBcUQ7UUFFckQsSUFBSSxjQUFjLENBQUMsTUFBTSxLQUFLLENBQUM7WUFBRSxPQUFPLE9BQU8sQ0FBQyxPQUFPLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDbkUsSUFBSSxJQUFJLENBQUMsTUFBTTtZQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsMENBQTBDLENBQUMsQ0FBQztRQUM3RSxJQUFJLGNBQWMsQ0FBQyxNQUFNLEdBQUcsNkJBQTZCLEVBQUUsQ0FBQztZQUMxRCxNQUFNLElBQUksS0FBSyxDQUFDLG9EQUFvRCxDQUFDLENBQUM7UUFDeEUsQ0FBQztRQUNELElBQUksSUFBSSxDQUFDLGlCQUFpQixJQUFJLG9CQUFvQixFQUFFLENBQUM7WUFDbkQsTUFBTSxJQUFJLEtBQUssQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFDO1FBQ2pFLENBQUM7UUFFRCxNQUFNLE9BQU8sR0FBRyxjQUFjLENBQUMsR0FBRyxDQUFDLENBQUMsVUFBVSxFQUFFLEtBQUssRUFBRSxFQUFFO1lBQ3ZELElBQ0UsVUFBVSxDQUFDLElBQUksQ0FBQyxNQUFNLEtBQUssQ0FBQzttQkFDekIsVUFBVSxDQUFDLElBQUksS0FBSyxPQUFPLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDO21CQUMxRCxNQUFNLENBQUMsVUFBVSxDQUFDLFVBQVUsQ0FBQyxJQUFJLEVBQUUsTUFBTSxDQUFDLEdBQUcsR0FBRztnQkFDbkQsNENBQTRDO21CQUN6QyxvQkFBb0IsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxFQUM3QyxDQUFDO2dCQUNELE1BQU0sSUFBSSxLQUFLLENBQUMsY0FBYyxLQUFLLEdBQUcsQ0FBQywyQkFBMkIsQ0FBQyxDQUFDO1lBQ3RFLENBQUM7WUFDRCxJQUNFLFVBQVUsQ0FBQyxTQUFTLENBQUMsTUFBTSxLQUFLLENBQUM7bUJBQzlCLE1BQU0sQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLFNBQVMsRUFBRSxNQUFNLENBQUMsR0FBRyxHQUFHO2dCQUN4RCw0Q0FBNEM7bUJBQ3pDLGlCQUFpQixDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsU0FBUyxDQUFDO2dCQUMvQyxNQUFNLElBQUksS0FBSyxDQUFDLGNBQWMsS0FBSyxHQUFHLENBQUMsNEJBQTRCLENBQUMsQ0FBQztZQUN2RSxNQUFNLElBQUksR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxVQUFVLEVBQUUsUUFBUSxDQUFDLENBQUM7WUFDMUQsSUFBSSxJQUFJLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxLQUFLLFVBQVUsQ0FBQyxVQUFVLEVBQUUsQ0FBQztnQkFDdEQsTUFBTSxJQUFJLEtBQUssQ0FBQyxjQUFjLEtBQUssR0FBRyxDQUFDLDJCQUEyQixDQUFDLENBQUM7WUFDdEUsQ0FBQztZQUNELElBQUksSUFBSSxDQUFDLFVBQVUsS0FBSyxVQUFVLENBQUMsSUFBSSxFQUFFLENBQUM7Z0JBQ3hDLE1BQU0sSUFBSSxLQUFLLENBQUMsY0FBYyxLQUFLLEdBQUcsQ0FBQyxtQ0FBbUMsQ0FBQyxDQUFDO1lBQzlFLENBQUM7WUFDRCxJQUFJLElBQUksQ0FBQyxVQUFVLEdBQUcsaUNBQWlDLEVBQUUsQ0FBQztnQkFDeEQsTUFBTSxJQUFJLEtBQUssQ0FBQyxjQUFjLEtBQUssR0FBRyxDQUFDLHFDQUFxQyxDQUFDLENBQUM7WUFDaEYsQ0FBQztZQUNELE9BQU8sRUFBRSxVQUFVLEVBQUUsSUFBSSxFQUFFLENBQUM7UUFDOUIsQ0FBQyxDQUFDLENBQUM7UUFDSCxNQUFNLEtBQUssR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUMsR0FBRyxFQUFFLEtBQUssRUFBRSxFQUFFLENBQUMsR0FBRyxHQUFHLEtBQUssQ0FBQyxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQzdFLElBQUksS0FBSyxHQUFHLHNDQUFzQyxFQUFFLENBQUM7WUFDbkQsTUFBTSxJQUFJLEtBQUssQ0FBQyx5REFBeUQsQ0FBQyxDQUFDO1FBQzdFLENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxXQUFXLEdBQUcsS0FBSyxHQUFHLHdCQUF3QixFQUFFLENBQUM7WUFDeEQsTUFBTSxJQUFJLEtBQUssQ0FBQyx1REFBdUQsQ0FBQyxDQUFDO1FBQzNFLENBQUM7UUFFRCxJQUFJLENBQUMsaUJBQWlCLElBQUksQ0FBQyxDQUFDO1FBQzVCLElBQUksQ0FBQyxXQUFXLElBQUksS0FBSyxDQUFDO1FBQzFCLE1BQU0sYUFBYSxHQUFHLElBQUksQ0FBQyxjQUFjLENBQUMsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQzFELElBQUksQ0FBQyxjQUFjLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxDQUFDO1FBQ3ZDLEtBQUssYUFBYSxDQUFDLE9BQU8sQ0FBQyxHQUFHLEVBQUUsQ0FBQyxJQUFJLENBQUMsY0FBYyxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxHQUFHLEVBQUUsQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUNuRyxPQUFPLGFBQWEsQ0FBQztJQUN2QixDQUFDO0lBRU0sS0FBSyxDQUFDLEtBQUs7UUFDaEIsSUFBSSxJQUFJLENBQUMsWUFBWTtZQUFFLE9BQU8sSUFBSSxDQUFDLFlBQVksQ0FBQztRQUNoRCxJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksQ0FBQztRQUNuQixNQUFNLFlBQVksR0FBRyxJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7UUFDMUMsSUFBSSxDQUFDLFlBQVksR0FBRyxZQUFZLENBQUM7UUFDakMsSUFBSSxDQUFDO1lBQ0gsTUFBTSxZQUFZLENBQUM7UUFDckIsQ0FBQztRQUFDLE9BQU8sUUFBUSxFQUFFLENBQUM7WUFDbEIsSUFBSSxJQUFJLENBQUMsWUFBWSxLQUFLLFlBQVk7Z0JBQUUsSUFBSSxDQUFDLFlBQVksR0FBRyxTQUFTLENBQUM7WUFDdEUsTUFBTSxRQUFRLENBQUM7UUFDakIsQ0FBQztJQUNILENBQUM7SUFFTyxLQUFLLENBQUMsY0FBYyxDQUMxQixVQUdFLEVBQ0YsUUFBZ0I7UUFFaEIsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxXQUFXLENBQUMsRUFBRSxDQUFDLENBQUMsUUFBUSxDQUFDLFdBQVcsQ0FBQyxDQUFDO1FBQ2hFLElBQUksU0FBNkIsQ0FBQztRQUNsQyxJQUFJLFFBQVEsR0FBRyxLQUFLLENBQUM7UUFDckIsSUFBSSxDQUFDO1lBQ0gsTUFBTSxJQUFJLEdBQUcsTUFBTSxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDckMsU0FBUyxHQUFHLE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRSxVQUFVLENBQUMsQ0FBQyxDQUFDO1lBQ25GLE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsQ0FBQztZQUNsRCxNQUFNLEtBQUssR0FBYSxFQUFFLENBQUM7WUFDM0IsS0FBSyxNQUFNLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxJQUFJLFVBQVUsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDO2dCQUNsRCxNQUFNLFFBQVEsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsR0FBRyxLQUFLLEdBQUcsQ0FBQyxJQUFJLEtBQUssQ0FBQyxVQUFVLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQztnQkFDdkYsTUFBTSxRQUFRLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsU0FBUyxFQUFFLFFBQVEsQ0FBQyxDQUFDO2dCQUM1RCxJQUNFLFFBQVEsS0FBSyxJQUFJO3VCQUNkLFFBQVEsQ0FBQyxVQUFVLENBQUMsS0FBSyxPQUFPLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO3VCQUM1QyxPQUFPLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUM7b0JBQ3BDLE1BQU0sSUFBSSxLQUFLLENBQUMsa0RBQWtELENBQUMsQ0FBQztnQkFDdEUsTUFBTSxLQUFLLEdBQUcsT0FBTyxDQUFDLEVBQUUsQ0FBQyxTQUFTLENBQUMsUUFBUTtzQkFDdkMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxTQUFTLENBQUMsT0FBTztzQkFDNUIsT0FBTyxDQUFDLEVBQUUsQ0FBQyxTQUFTLENBQUMsTUFBTTtzQkFDM0IsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLFNBQVMsQ0FBQyxVQUFVLElBQUksQ0FBQyxDQUFDLENBQUM7Z0JBQzNDLE1BQU0sSUFBSSxHQUFHLE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUM7Z0JBQ3BFLElBQUksQ0FBQztvQkFDSCxNQUFNLElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDO2dCQUNuQyxDQUFDO3dCQUFTLENBQUM7b0JBQ1QsTUFBTSxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7Z0JBQ3JCLENBQUM7Z0JBQ0QsS0FBSyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQztZQUN2QixDQUFDO1lBQ0QsTUFBTSxZQUFZLEdBQUcsMkVBQTJFLFVBQVU7aUJBQ3ZHLEdBQUcsQ0FBQyxDQUFDLEtBQUssRUFBRSxLQUFLLEVBQUUsRUFBRSxDQUFDLEtBQUssS0FBSyxDQUFDLEtBQUssQ0FBQyxLQUFLLEtBQUssQ0FBQyxVQUFVLENBQUMsU0FBUyxLQUFLLEtBQUssQ0FBQyxJQUFJLENBQUMsVUFBVSxTQUFTLENBQUM7aUJBQzFHLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO1lBQ2hCLElBQUksTUFBTSxDQUFDLFVBQVUsQ0FBQyxZQUFZLEVBQUUsTUFBTSxDQUFDLEdBQUcsd0NBQXdDLEVBQUUsQ0FBQztnQkFDdkYsTUFBTSxJQUFJLEtBQUssQ0FBQyxnRUFBZ0UsQ0FBQyxDQUFDO1lBQ3BGLENBQUM7WUFDRCxNQUFNLE1BQU0sR0FBNEI7Z0JBQ3RDLEVBQUU7Z0JBQ0YsU0FBUztnQkFDVCxLQUFLO2dCQUNMLFlBQVk7Z0JBQ1osS0FBSyxFQUFFLFFBQVE7Z0JBQ2YsT0FBTyxFQUFFLEdBQUcsRUFBRSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO2FBQ2hDLENBQUM7WUFDRixJQUFJLENBQUMsYUFBYSxDQUFDLEdBQUcsQ0FBQyxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsQ0FBQyxDQUFDO1lBQ3ZDLFFBQVEsR0FBRyxJQUFJLENBQUM7WUFDaEIsT0FBTyxNQUFNLENBQUM7UUFDaEIsQ0FBQztnQkFBUyxDQUFDO1lBQ1QsSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFDO2dCQUNkLElBQUksU0FBUyxFQUFFLENBQUM7b0JBQ2QsTUFBTSxPQUFPLENBQUMsRUFBRSxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUMsU0FBUyxFQUFFLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsR0FBRyxFQUFFLENBQUMsU0FBUyxDQUFDLENBQUM7Z0JBQ25HLENBQUM7Z0JBQ0QsSUFBSSxDQUFDLGlCQUFpQixJQUFJLENBQUMsQ0FBQztnQkFDNUIsSUFBSSxDQUFDLFdBQVcsSUFBSSxRQUFRLENBQUM7WUFDL0IsQ0FBQztRQUNILENBQUM7SUFDSCxDQUFDO0lBRU8sS0FBSyxDQUFDLGFBQWE7UUFDekIsTUFBTSxPQUFPLENBQUMsVUFBVSxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUMsY0FBYyxDQUFDLENBQUMsQ0FBQztRQUNuRCxNQUFNLE9BQU8sR0FBRyxNQUFNLE9BQU8sQ0FBQyxVQUFVLENBQ3RDLENBQUMsR0FBRyxJQUFJLENBQUMsYUFBYSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQ3hFLENBQUM7UUFDRixNQUFNLE1BQU0sR0FBRyxPQUFPO2FBQ25CLE1BQU0sQ0FBQyxDQUFDLE1BQU0sRUFBbUMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxNQUFNLEtBQUssVUFBVSxDQUFDO2FBQ2pGLEdBQUcsQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1FBQ2xDLElBQUksSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDO1lBQ3JCLElBQUksQ0FBQztnQkFDSCxNQUFNLElBQUksR0FBRyxNQUFNLElBQUksQ0FBQyxXQUFXLENBQUM7Z0JBQ3BDLE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDLElBQUksRUFBRSxFQUFFLFNBQVMsRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7Z0JBQ3JFLElBQUksQ0FBQyxhQUFhLENBQUMsS0FBSyxFQUFFLENBQUM7Z0JBQzNCLElBQUksQ0FBQyxpQkFBaUIsR0FBRyxDQUFDLENBQUM7Z0JBQzNCLElBQUksQ0FBQyxXQUFXLEdBQUcsQ0FBQyxDQUFDO2dCQUNyQixNQUFNLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQztZQUNwQixDQUFDO1lBQUMsT0FBTyxRQUFRLEVBQUUsQ0FBQztnQkFDbEIsTUFBTSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQztZQUN4QixDQUFDO1FBQ0gsQ0FBQztRQUNELElBQUksTUFBTSxDQUFDLE1BQU0sR0FBRyxDQUFDO1lBQUUsTUFBTSxJQUFJLGNBQWMsQ0FBQyxNQUFNLEVBQUUsbUNBQW1DLENBQUMsQ0FBQztJQUMvRixDQUFDO0lBRU8sS0FBSyxDQUFDLFVBQVU7UUFDdEIsSUFBSSxDQUFDLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUN0QixJQUFJLENBQUMsV0FBVyxHQUFHLENBQUMsS0FBSyxJQUFJLEVBQUU7Z0JBQzdCLElBQUksSUFBd0IsQ0FBQztnQkFDN0IsSUFBSSxDQUFDO29CQUNILElBQUksR0FBRyxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FDdEMsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxNQUFNLEVBQUUsRUFBRSw2QkFBNkIsQ0FBQyxDQUN0RSxDQUFDO29CQUNGLE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxLQUFLLENBQUMsQ0FBQztvQkFDN0MsT0FBTyxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsQ0FBQztnQkFDbEQsQ0FBQztnQkFBQyxPQUFPLFFBQVEsRUFBRSxDQUFDO29CQUNsQixJQUFJLElBQUksRUFBRSxDQUFDO3dCQUNULE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDLElBQUksRUFBRSxFQUFFLFNBQVMsRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLElBQUksRUFBRSxDQUFDOzZCQUNqRSxLQUFLLENBQUMsR0FBRyxFQUFFLENBQUMsU0FBUyxDQUFDLENBQUM7b0JBQzVCLENBQUM7b0JBQ0QsTUFBTSxRQUFRLENBQUM7Z0JBQ2pCLENBQUM7WUFDSCxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ1AsQ0FBQztRQUNELE1BQU0sV0FBVyxHQUFHLElBQUksQ0FBQyxXQUFXLENBQUM7UUFDckMsSUFBSSxDQUFDO1lBQ0gsT0FBTyxNQUFNLFdBQVcsQ0FBQztRQUMzQixDQUFDO1FBQUMsT0FBTyxRQUFRLEVBQUUsQ0FBQztZQUNsQixJQUFJLElBQUksQ0FBQyxXQUFXLEtBQUssV0FBVztnQkFBRSxJQUFJLENBQUMsV0FBVyxHQUFHLFNBQVMsQ0FBQztZQUNuRSxNQUFNLFFBQVEsQ0FBQztRQUNqQixDQUFDO0lBQ0gsQ0FBQztJQUVPLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBYTtRQUNqQyxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUMsYUFBYSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUM3QyxJQUFJLENBQUMsTUFBTTtZQUFFLE9BQU87UUFDcEIsSUFBSSxNQUFNLENBQUMsY0FBYztZQUFFLE9BQU8sTUFBTSxDQUFDLGNBQWMsQ0FBQztRQUN4RCxNQUFNLGNBQWMsR0FBRyxDQUFDLEtBQUssSUFBSSxFQUFFO1lBQ2pDLE1BQU0sT0FBTyxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsU0FBUyxFQUFFLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztZQUN4RixJQUFJLElBQUksQ0FBQyxhQUFhLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxLQUFLLE1BQU0sRUFBRSxDQUFDO2dCQUM3QyxJQUFJLENBQUMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQztnQkFDakMsSUFBSSxDQUFDLGlCQUFpQixJQUFJLENBQUMsQ0FBQztnQkFDNUIsSUFBSSxDQUFDLFdBQVcsSUFBSSxNQUFNLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQztZQUMxQyxDQUFDO1FBQ0gsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUNMLE1BQU0sQ0FBQyxjQUFjLEdBQUcsY0FBYyxDQUFDO1FBQ3ZDLElBQUksQ0FBQztZQUNILE1BQU0sY0FBYyxDQUFDO1FBQ3ZCLENBQUM7Z0JBQVMsQ0FBQztZQUNULElBQUksSUFBSSxDQUFDLGFBQWEsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLEtBQUssTUFBTSxJQUFJLE1BQU0sQ0FBQyxjQUFjLEtBQUssY0FBYyxFQUFFLENBQUM7Z0JBQ3pGLE1BQU0sQ0FBQyxjQUFjLEdBQUcsU0FBUyxDQUFDO1lBQ3BDLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztDQUNGIn0=

package/dist_ts/classes.validation.d.ts

@@ -0,0 +1,91 @@
+import type * as interfaces from '../dist_ts_interfaces/index.js';
+export declare const assertEmptyRequest: (valueArg: unknown) => Record<string, never>;
+export declare const assertIdentifier: (valueArg: unknown, nameArg: string) => string;
+export declare function assertControllerRuntimeId<THarnessId extends interfaces.TControllerHarnessId>(valueArg: unknown, nameArg: string, allowedHarnessIdsArg: readonly THarnessId[]): interfaces.IControllerRuntimeId & {
+    harnessId: THarnessId;
+};
+export declare function assertControllerRuntimeId(valueArg: unknown, nameArg: string, allowedHarnessIdsArg?: readonly interfaces.TControllerHarnessId[]): interfaces.IControllerRuntimeId;
+export declare const assertSetupBeginRequest: (valueArg: unknown) => interfaces.IReq_ControllerSetupBegin["request"];
+export declare const assertSetupFinishRequest: (valueArg: unknown) => interfaces.IReq_ControllerSetupFinish["request"];
+export declare const assertAuthenticationFinishRequest: (valueArg: unknown) => interfaces.IReq_ControllerAuthenticationFinish["request"];
+export declare const assertProjectListRequest: (valueArg: unknown) => Record<string, never>;
+export declare const assertProjectRelativePath: (valueArg: unknown, nameArg: string) => string;
+export declare const assertProjectCreateRequest: (valueArg: unknown) => interfaces.IReq_ControllerProjectCreate["request"];
+export declare const assertAbsoluteProjectPath: (valueArg: unknown, nameArg: string) => string;
+/**
+ * Accepts what a human types and returns the absolute directory to register:
+ * an absolute path is taken as-is (any location on disk), a relative path is
+ * resolved against the projects root.
+ */
+export declare const resolveProjectPathInput: (pathArg: string, projectsRootArg: string) => string;
+export interface IProjectSuggestParse {
+    /**
+     * Directory whose entries are being completed: absolute when the query was
+     * absolute, else relative to the projects root ('' meaning the root).
+     */
+    directoryPath: string;
+    prefix: string;
+    unmatchable: boolean;
+    /** The query was an absolute path; suggestions should be returned absolute. */
+    absolute: boolean;
+}
+export declare const assertProjectSuggestRequest: (valueArg: unknown) => IProjectSuggestParse;
+export declare const assertProjectRemoveRequest: (valueArg: unknown) => interfaces.IReq_ControllerProjectRemove["request"];
+export declare const assertProviderListRequest: (valueArg: unknown) => Record<string, never>;
+export declare const assertProviderConnectionListRequest: (valueArg: unknown) => Record<string, never>;
+export declare const assertProviderLoginBeginRequest: (valueArg: unknown) => interfaces.IReq_ControllerProviderLoginBegin["request"];
+export declare const assertProviderLoginGetRequest: (valueArg: unknown) => interfaces.IReq_ControllerProviderLoginGet["request"];
+export declare const assertProviderLoginCancelRequest: (valueArg: unknown) => interfaces.IReq_ControllerProviderLoginCancel["request"];
+export declare const assertProviderConnectionLogoutRequest: (valueArg: unknown) => interfaces.IReq_ControllerProviderConnectionLogout["request"];
+export declare const assertProviderConnectionRateLimitsGetRequest: (valueArg: unknown) => interfaces.IReq_ControllerProviderConnectionRateLimitsGet["request"];
+export declare const assertProviderConnectionActivateOpenCodeRequest: (valueArg: unknown) => interfaces.IReq_ControllerProviderConnectionActivateOpenCode["request"];
+export declare const assertProviderModelRefreshBeginRequest: (valueArg: unknown) => interfaces.IReq_ControllerProviderModelRefreshBegin["request"];
+export declare const assertProviderModelRefreshGetRequest: (valueArg: unknown) => interfaces.IReq_ControllerProviderModelRefreshGet["request"];
+export declare const assertSettingsUpdateRequest: (valueArg: unknown) => interfaces.IReq_ControllerSettingsUpdate["request"];
+export declare const assertSessionListRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionList["request"];
+export declare const assertSlashListRequest: (valueArg: unknown) => interfaces.IReq_ControllerSlashList["request"];
+export declare const assertSessionGetRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionGet["request"];
+export declare const assertSessionAuxiliaryGetRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionAuxiliaryGet["request"];
+export declare const assertSessionModelUpdateRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionModelUpdate["request"];
+export declare const assertSessionScratchpadSaveRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionScratchpadSave["request"];
+export declare const assertSessionIntelligenceAskRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionIntelligenceAsk["request"];
+export declare const assertSessionMessagesPageRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionMessagesPage["request"];
+export declare const assertSessionMessageGetRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionMessageGet["request"];
+export declare const assertSessionCreateRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionCreate["request"];
+export declare const assertTempPasswordLoginRequest: (valueArg: unknown) => interfaces.IReq_ControllerTempPasswordLogin["request"];
+export declare const assertAuthResumeRequest: (valueArg: unknown) => interfaces.IReq_ControllerAuthResume["request"];
+export declare const assertVariantName: (valueArg: unknown) => string;
+export declare function assertModelChoice(valueArg: unknown, nameArg?: string): interfaces.TControllerModelChoice;
+export declare const assertSessionDraftUpdateRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionDraftUpdate["request"];
+export declare const assertSessionSendRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionSend["request"];
+export declare const assertSlashExecuteRequest: (valueArg: unknown) => interfaces.IReq_ControllerSlashExecute["request"];
+export declare const assertPermissionReplyRequest: (valueArg: unknown) => interfaces.IReq_ControllerPermissionReply["request"];
+export declare const assertSessionGroupsGetRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionGroupsGet["request"];
+export declare const assertSessionGroupsUpdateRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionGroupsUpdate["request"];
+export declare const assertSessionYoloRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionYolo["request"];
+export declare const assertControllerSessionTitle: (valueArg: unknown) => string;
+export declare const assertSessionRenameRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionRename["request"];
+export declare const assertSessionArchiveRequest: (valueArg: unknown) => interfaces.IReq_ControllerSessionArchive["request"];
+export declare const assertTerminalListRequest: (valueArg: unknown) => interfaces.IReq_ControllerTerminalList["request"];
+export declare const assertResourceListRequest: (valueArg: unknown) => interfaces.IReq_ControllerResourceList["request"];
+export declare const assertResourceCreateRequest: (valueArg: unknown) => interfaces.IReq_ControllerResourceCreate["request"];
+export declare const assertResourceRenameRequest: (valueArg: unknown) => interfaces.IReq_ControllerResourceRename["request"];
+export declare const assertResourceAttachRequest: (valueArg: unknown) => interfaces.IReq_ControllerResourceAttach["request"];
+export declare const assertResourceDetachRequest: (valueArg: unknown) => interfaces.IReq_ControllerResourceDetach["request"];
+export declare const assertResourceTargetRequest: (valueArg: unknown, nameArg: string) => {
+    projectId: string;
+    resourceId: string;
+};
+export declare const assertBrowserViewOpenRequest: (valueArg: unknown) => interfaces.IReq_ControllerBrowserViewOpen["request"];
+export declare const assertBrowserViewCloseRequest: (valueArg: unknown) => interfaces.IReq_ControllerBrowserViewClose["request"];
+export declare const assertBrowserViewActivateRequest: (valueArg: unknown) => interfaces.IReq_ControllerBrowserViewActivate["request"];
+export declare const assertBrowserViewOperateRequest: (valueArg: unknown) => interfaces.IReq_ControllerBrowserViewOperate["request"];
+export declare const assertTerminalCreateRequest: (valueArg: unknown) => interfaces.IReq_ControllerTerminalCreate["request"];
+export declare const assertTerminalRenameRequest: (valueArg: unknown) => interfaces.IReq_ControllerTerminalRename["request"];
+export declare const assertTerminalTargetRequest: (valueArg: unknown, nameArg: string) => {
+    projectId: string;
+    terminalId: interfaces.TControllerTerminalId;
+};
+export declare const assertTerminalInputRequest: (valueArg: unknown) => interfaces.IReq_ControllerTerminalInput["request"];
+export declare const assertTerminalResizeRequest: (valueArg: unknown) => interfaces.IReq_ControllerTerminalResize["request"];
+export declare const assertQuestionReplyRequest: (valueArg: unknown) => interfaces.IReq_ControllerQuestionReply["request"];