agl 1.0.17 → 21.0.2

package/dist_ts/classes.controllermanagement.d.ts

@@ -0,0 +1,32 @@
+import { type IControllerStatus, type IReq_ControllerUpgradeLaunch, type IReq_ControllerUpgradePrepareBegin, type IReq_ControllerUpgradeFinalize } from '../dist_ts_interfaces/index.js';
+export interface IControllerStatusExpectation {
+    packageName: string;
+    packageVersion: string;
+    protocolVersion?: number;
+    upgradeManagementVersion: number;
+}
+export declare const controllerUpgradePrepareBeginRequestTimeoutMs = 30000;
+export declare const assertControllerStatus: (statusArg: unknown, expectationArg: IControllerStatusExpectation) => IControllerStatus;
+export declare const requestControllerUpgradePrepareBegin: (portArg: number, tokenArg: string, targetVersionArg: string, gracePeriodMsArg: number) => Promise<IReq_ControllerUpgradePrepareBegin["response"]>;
+export declare const requestControllerUpgradeFinalize: (portArg: number, tokenArg: string, modeArg: IReq_ControllerUpgradeFinalize["request"]["mode"], timeoutMsArg?: number) => Promise<IReq_ControllerUpgradeFinalize["response"]>;
+export declare const queryControllerStatus: (portArg: number, expectationArg: IControllerStatusExpectation, timeoutMsArg?: number) => Promise<IControllerStatus>;
+export declare const tryQueryControllerStatus: (portArg: number, expectationArg: IControllerStatusExpectation) => Promise<IControllerStatus | undefined>;
+export declare const isLoopbackPortListening: (portArg: number, timeoutMsArg?: number) => Promise<boolean>;
+export declare const requestControllerUpgradeLaunch: (portArg: number, tokenArg: string, timeoutMsArg?: number) => Promise<IReq_ControllerUpgradeLaunch["response"]>;
+export declare const waitUntilControllerExited: (optionsArg: {
+    pid: number;
+    cliPath: string;
+    port: number;
+    expectedProcessGroupId: number;
+    expectedFingerprint: string;
+    command: "__serve" | "foreground";
+}, timeoutMsArg: number) => Promise<boolean>;
+export declare const resolveControllerStopSignal: (statusArg: IControllerStatus, phaseArg: "cooperative" | "hard") => {
+    signal: NodeJS.Signals;
+    signalProcessGroup: boolean;
+};
+export declare const stopVerifiedController: (optionsArg: {
+    status: IControllerStatus;
+    cliPath: string;
+    port: number;
+}) => Promise<void>;

package/dist_ts/classes.controllermanagement.js

@@ -0,0 +1,222 @@
+import * as plugins from './plugins.js';
+import { controllerPackageName, } from '../dist_ts_interfaces/index.js';
+import { inspectControllerProcess, signalVerifiedControllerProcess, } from './classes.processinspection.js';
+const currentCliName = String(controllerPackageName) === 'agl' ? 'agl' : 'hcon';
+const currentRuntimeName = currentCliName === 'agl' ? 'AGL' : currentCliName;
+const harnessStates = ['starting', 'ready', 'stopping', 'stopped', 'failed'];
+export const controllerUpgradePrepareBeginRequestTimeoutMs = 30_000;
+const isControllerHarnessStatus = (statusArg) => {
+    if (typeof statusArg !== 'object' || statusArg === null)
+        return false;
+    const status = statusArg;
+    return ((status.harnessId === 'opencode' || status.harnessId === 'flex')
+        && harnessStates.some((stateArg) => status.state === stateArg)
+        && typeof status.healthy === 'boolean'
+        && (status.pid === undefined || Number.isSafeInteger(status.pid))
+        && (status.version === undefined || typeof status.version === 'string'));
+};
+const isControllerUpgradeStatus = (statusArg) => {
+    if (!statusArg || typeof statusArg !== 'object' || Array.isArray(statusArg))
+        return false;
+    const status = statusArg;
+    return Object.keys(status).length === 3
+        && typeof status.fromVersion === 'string'
+        && status.fromVersion.length > 0
+        && Buffer.byteLength(status.fromVersion, 'utf8') <= 128
+        && typeof status.toVersion === 'string'
+        && status.toVersion.length > 0
+        && Buffer.byteLength(status.toVersion, 'utf8') <= 128
+        && typeof status.phase === 'string'
+        && ['preparing', 'pausing', 'installing', 'restarting', 'continuing', 'completed', 'failed']
+            .includes(status.phase);
+};
+export const assertControllerStatus = (statusArg, expectationArg) => {
+    if (typeof statusArg !== 'object' || statusArg === null) {
+        throw new Error(`The service on the management port is not an ${currentRuntimeName} endpoint.`);
+    }
+    const status = statusArg;
+    const harnesses = Array.isArray(status.harnesses) ? status.harnesses : [];
+    const openCode = harnesses.find((entryArg) => entryArg?.harnessId === 'opencode');
+    const flex = harnesses.find((entryArg) => entryArg?.harnessId === 'flex');
+    if (status.packageName !== expectationArg.packageName
+        || status.packageVersion !== expectationArg.packageVersion
+        || (expectationArg.protocolVersion !== undefined
+            && status.protocolVersion !== expectationArg.protocolVersion)
+        || status.upgradeManagementVersion !== expectationArg.upgradeManagementVersion
+        || !Number.isSafeInteger(status.controllerPid)
+        || !Number.isSafeInteger(status.processGroupId)
+        || typeof status.processFingerprint !== 'string'
+        || status.processFingerprint.length < 8
+        || status.processFingerprint.length > 256
+        || (status.processMode !== 'detached' && status.processMode !== 'foreground')
+        || (status.lifecycleState !== 'starting'
+            && status.lifecycleState !== 'ready'
+            && status.lifecycleState !== 'stopping'
+            && status.lifecycleState !== 'stopped')
+        || typeof status.startedAt !== 'number'
+        || typeof status.setupRequired !== 'boolean'
+        || (status.upgrade !== undefined && !isControllerUpgradeStatus(status.upgrade))
+        || harnesses.length !== 2
+        || !openCode
+        || !flex
+        || !harnesses.every((entryArg) => isControllerHarnessStatus(entryArg))) {
+        throw new Error('The service on the management port has an incompatible controller identity.');
+    }
+    return status;
+};
+export const requestControllerUpgradePrepareBegin = async (portArg, tokenArg, targetVersionArg, gracePeriodMsArg) => {
+    const abortController = new AbortController();
+    const timeout = setTimeout(() => abortController.abort(), controllerUpgradePrepareBeginRequestTimeoutMs);
+    let socket;
+    try {
+        socket = await plugins.typedsocket.TypedSocket.createClient(new plugins.typedrequest.TypedRouter(), `http://127.0.0.1:${portArg}`, {
+            autoReconnect: false,
+            maxRetries: 0,
+            abortSignal: abortController.signal,
+        });
+        const response = await socket.createTypedRequest('controller.upgrade.prepare.begin', undefined, {
+            timeoutMs: controllerUpgradePrepareBeginRequestTimeoutMs,
+            abortSignal: abortController.signal,
+        }).fire({ token: tokenArg, targetVersion: targetVersionArg, gracePeriodMs: gracePeriodMsArg });
+        if (!response
+            || typeof response !== 'object'
+            || Array.isArray(response)
+            || Object.keys(response).length !== 1
+            || response.accepted !== true)
+            throw new Error('The controller returned an invalid upgrade preparation response.');
+        return response;
+    }
+    finally {
+        clearTimeout(timeout);
+        await socket?.stop();
+    }
+};
+export const requestControllerUpgradeFinalize = async (portArg, tokenArg, modeArg, timeoutMsArg = 60_000) => {
+    const socket = await plugins.typedsocket.TypedSocket.createClient(new plugins.typedrequest.TypedRouter(), `http://127.0.0.1:${portArg}`, { autoReconnect: false, maxRetries: 0 });
+    try {
+        return await socket.createTypedRequest('controller.upgrade.finalize', undefined, { timeoutMs: timeoutMsArg }).fire({ token: tokenArg, mode: modeArg });
+    }
+    finally {
+        await socket.stop();
+    }
+};
+export const queryControllerStatus = async (portArg, expectationArg, timeoutMsArg = 2_500) => {
+    const abortController = new AbortController();
+    const timeout = setTimeout(() => abortController.abort(), timeoutMsArg);
+    let socket;
+    try {
+        const router = new plugins.typedrequest.TypedRouter();
+        socket = await plugins.typedsocket.TypedSocket.createClient(router, `http://127.0.0.1:${portArg}`, {
+            autoReconnect: false,
+            maxRetries: 0,
+            abortSignal: abortController.signal,
+        });
+        const request = socket.createTypedRequest('controller.status', undefined, { timeoutMs: timeoutMsArg, abortSignal: abortController.signal });
+        return assertControllerStatus(await request.fire({}), expectationArg);
+    }
+    finally {
+        clearTimeout(timeout);
+        await socket?.stop();
+    }
+};
+export const tryQueryControllerStatus = async (portArg, expectationArg) => {
+    try {
+        return await queryControllerStatus(portArg, expectationArg);
+    }
+    catch {
+        return undefined;
+    }
+};
+export const isLoopbackPortListening = async (portArg, timeoutMsArg = 500) => {
+    return await new Promise((resolve) => {
+        const socket = plugins.net.createConnection({ host: '127.0.0.1', port: portArg });
+        let settled = false;
+        const finish = (resultArg) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            socket.destroy();
+            resolve(resultArg);
+        };
+        const timeout = setTimeout(() => finish(false), timeoutMsArg);
+        socket.once('connect', () => finish(true));
+        socket.once('error', () => finish(false));
+    });
+};
+export const requestControllerUpgradeLaunch = async (portArg, tokenArg, timeoutMsArg = 15_000) => {
+    const abortController = new AbortController();
+    const timeout = setTimeout(() => abortController.abort(), timeoutMsArg);
+    let socket;
+    try {
+        const router = new plugins.typedrequest.TypedRouter();
+        socket = await plugins.typedsocket.TypedSocket.createClient(router, `http://127.0.0.1:${portArg}`, {
+            autoReconnect: false,
+            maxRetries: 0,
+            abortSignal: abortController.signal,
+        });
+        const response = await socket.createTypedRequest('controller.upgrade.launch', undefined, { timeoutMs: timeoutMsArg, abortSignal: abortController.signal }).fire({ token: tokenArg });
+        if (!response
+            || typeof response !== 'object'
+            || response.accepted !== true
+            || !Number.isSafeInteger(response.workerPid)
+            || response.workerPid < 2
+            || typeof response.logFilePath !== 'string'
+            || !plugins.path.isAbsolute(response.logFilePath)) {
+            throw new Error(`The controller returned an invalid ${currentCliName} upgrade launch response.`);
+        }
+        return response;
+    }
+    finally {
+        clearTimeout(timeout);
+        await socket?.stop();
+    }
+};
+export const waitUntilControllerExited = async (optionsArg, timeoutMsArg) => {
+    const deadline = Date.now() + timeoutMsArg;
+    while (Date.now() < deadline) {
+        if (!await inspectControllerProcess(optionsArg))
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, 150));
+    }
+    return !await inspectControllerProcess(optionsArg);
+};
+export const resolveControllerStopSignal = (statusArg, phaseArg) => {
+    if (phaseArg === 'cooperative') {
+        return { signal: 'SIGTERM', signalProcessGroup: false };
+    }
+    const signalProcessGroup = statusArg.processMode === 'detached';
+    if (signalProcessGroup && statusArg.processGroupId !== statusArg.controllerPid) {
+        throw new Error('The detached controller is not the verified leader of its process group.');
+    }
+    return { signal: 'SIGKILL', signalProcessGroup };
+};
+export const stopVerifiedController = async (optionsArg) => {
+    const command = optionsArg.status.processMode === 'detached'
+        ? '__serve'
+        : 'foreground';
+    const processIdentity = {
+        pid: optionsArg.status.controllerPid,
+        cliPath: optionsArg.cliPath,
+        port: optionsArg.port,
+        expectedProcessGroupId: optionsArg.status.processGroupId,
+        expectedFingerprint: optionsArg.status.processFingerprint,
+        command,
+    };
+    const cooperativeSignal = resolveControllerStopSignal(optionsArg.status, 'cooperative');
+    await signalVerifiedControllerProcess({
+        ...processIdentity,
+        ...cooperativeSignal,
+    });
+    if (await waitUntilControllerExited(processIdentity, 30_000))
+        return;
+    const hardSignal = resolveControllerStopSignal(optionsArg.status, 'hard');
+    await signalVerifiedControllerProcess({
+        ...processIdentity,
+        ...hardSignal,
+    });
+    if (!await waitUntilControllerExited(processIdentity, 15_000)) {
+        throw new Error('The exact controller process survived verified hard-stop escalation.');
+    }
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jb250cm9sbGVybWFuYWdlbWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2NsYXNzZXMuY29udHJvbGxlcm1hbmFnZW1lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFDeEMsT0FBTyxFQUNMLHFCQUFxQixHQU10QixNQUFNLDJCQUEyQixDQUFDO0FBQ25DLE9BQU8sRUFDTCx3QkFBd0IsRUFDeEIsK0JBQStCLEdBQ2hDLE1BQU0sZ0NBQWdDLENBQUM7QUFFeEMsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDLHFCQUFxQixDQUFDLEtBQUssS0FBSyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQztBQUNoRixNQUFNLGtCQUFrQixHQUFHLGNBQWMsS0FBSyxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsY0FBYyxDQUFDO0FBUzdFLE1BQU0sYUFBYSxHQUFHLENBQUMsVUFBVSxFQUFFLE9BQU8sRUFBRSxVQUFVLEVBQUUsU0FBUyxFQUFFLFFBQVEsQ0FBVSxDQUFDO0FBQ3RGLE1BQU0sQ0FBQyxNQUFNLDZDQUE2QyxHQUFHLE1BQU0sQ0FBQztBQUVwRSxNQUFNLHlCQUF5QixHQUFHLENBQUMsU0FBa0IsRUFBVyxFQUFFO0lBQ2hFLElBQUksT0FBTyxTQUFTLEtBQUssUUFBUSxJQUFJLFNBQVMsS0FBSyxJQUFJO1FBQUUsT0FBTyxLQUFLLENBQUM7SUFDdEUsTUFBTSxNQUFNLEdBQUcsU0FBb0MsQ0FBQztJQUNwRCxPQUFPLENBQ0wsQ0FBQyxNQUFNLENBQUMsU0FBUyxLQUFLLFVBQVUsSUFBSSxNQUFNLENBQUMsU0FBUyxLQUFLLE1BQU0sQ0FBQztXQUM3RCxhQUFhLENBQUMsSUFBSSxDQUFDLENBQUMsUUFBUSxFQUFFLEVBQUUsQ0FBQyxNQUFNLENBQUMsS0FBSyxLQUFLLFFBQVEsQ0FB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

package/dist_ts/classes.draftmanager.d.ts

@@ -0,0 +1,30 @@
+import { type IControllerDraftAttachment, type IControllerSessionDraft, type IControllerSessionDraftUpdate } from '../dist_ts_interfaces/interfaces.js';
+export declare class ControllerDraftConflictError extends Error {
+    readonly draft: IControllerSessionDraft;
+    constructor(draft: IControllerSessionDraft);
+}
+export declare class ControllerDraftLimitError extends Error {
+    constructor(messageArg: string);
+}
+export interface IControllerDraftMutationResult {
+    draft: IControllerSessionDraft;
+    update?: IControllerSessionDraftUpdate;
+}
+export declare class ControllerDraftManager {
+    private readonly drafts;
+    private nonEmptyDrafts;
+    private aggregateAttachmentBytes;
+    get(keyArg: string): IControllerSessionDraft;
+    update(keyArg: string, expectedRevisionArg: number, patchArg: {
+        text?: string;
+        attachments?: readonly IControllerDraftAttachment[];
+    }): IControllerDraftMutationResult;
+    snapshot(keyArg: string, revisionArg: number): IControllerSessionDraft;
+    clearExact(keyArg: string, revisionArg: number): IControllerDraftMutationResult;
+    purge(keyArg: string): void;
+    purgePrefix(prefixArg: string): void;
+    clear(): void;
+    private assertDraftFields;
+    private assertAdmission;
+    private store;
+}

package/dist_ts/classes.draftmanager.js

@@ -0,0 +1,179 @@
+import { controllerMaxDraftAttachmentBytes, controllerMaxDraftAttachmentTotalBytes, controllerMaxDraftAttachments, controllerMaxDraftTextBytes, } from '../dist_ts_interfaces/interfaces.js';
+const maximumDraftIdentities = 4_096;
+const maximumNonEmptyDrafts = 512;
+const maximumAggregateAttachmentBytes = 64 * 1024 * 1024;
+export class ControllerDraftConflictError extends Error {
+    draft;
+    constructor(draft) {
+        super('The composer draft changed concurrently.');
+        this.draft = draft;
+        this.name = 'ControllerDraftConflictError';
+    }
+}
+export class ControllerDraftLimitError extends Error {
+    constructor(messageArg) {
+        super(messageArg);
+        this.name = 'ControllerDraftLimitError';
+    }
+}
+const cloneAttachment = (attachmentArg) => ({ ...attachmentArg });
+const cloneDraft = (draftArg) => ({
+    text: draftArg.text,
+    attachments: draftArg.attachments.map(cloneAttachment),
+    revision: draftArg.revision,
+});
+const emptyDraft = () => ({ text: '', attachments: [], revision: 0 });
+const attachmentBytes = (draftArg) => (draftArg.attachments.reduce((sum, attachment) => sum + attachment.size, 0));
+const isNonEmpty = (draftArg) => (draftArg.text.length > 0 || draftArg.attachments.length > 0);
+const attachmentsEqual = (leftArg, rightArg) => leftArg.length === rightArg.length && leftArg.every((left, index) => {
+    const right = rightArg[index];
+    return right !== undefined
+        && left.id === right.id
+        && left.name === right.name
+        && left.mediaType === right.mediaType
+        && left.size === right.size
+        && left.kind === right.kind
+        && left.dataBase64 === right.dataBase64;
+});
+export class ControllerDraftManager {
+    drafts = new Map();
+    nonEmptyDrafts = 0;
+    aggregateAttachmentBytes = 0;
+    get(keyArg) {
+        return cloneDraft(this.drafts.get(keyArg) ?? emptyDraft());
+    }
+    update(keyArg, expectedRevisionArg, patchArg) {
+        const current = this.drafts.get(keyArg) ?? emptyDraft();
+        if (current.revision !== expectedRevisionArg) {
+            throw new ControllerDraftConflictError(cloneDraft(current));
+        }
+        if (patchArg.text === undefined && patchArg.attachments === undefined) {
+            throw new Error('A draft update must replace text, attachments, or both.');
+        }
+        const nextText = patchArg.text ?? current.text;
+        const nextAttachments = patchArg.attachments === undefined
+            ? current.attachments
+            : patchArg.attachments.map(cloneAttachment);
+        this.assertDraftFields(nextText, nextAttachments);
+        const textChanged = nextText !== current.text;
+        const attachmentsChanged = !attachmentsEqual(nextAttachments, current.attachments);
+        if (!textChanged && !attachmentsChanged)
+            return { draft: cloneDraft(current) };
+        if (current.revision >= Number.MAX_SAFE_INTEGER) {
+            throw new ControllerDraftLimitError('The draft revision limit was reached.');
+        }
+        const next = {
+            text: nextText,
+            attachments: nextAttachments,
+            revision: current.revision + 1,
+        };
+        this.assertAdmission(keyArg, current, next);
+        this.store(keyArg, current, next);
+        return {
+            draft: cloneDraft(next),
+            update: {
+                revision: next.revision,
+                ...(textChanged ? { text: next.text } : {}),
+                ...(attachmentsChanged
+                    ? { attachments: next.attachments.map(cloneAttachment) }
+                    : {}),
+            },
+        };
+    }
+    snapshot(keyArg, revisionArg) {
+        const current = this.drafts.get(keyArg) ?? emptyDraft();
+        if (current.revision !== revisionArg) {
+            throw new ControllerDraftConflictError(cloneDraft(current));
+        }
+        if (current.revision >= Number.MAX_SAFE_INTEGER) {
+            throw new ControllerDraftLimitError('The draft revision limit was reached.');
+        }
+        if (!current.text.trim())
+            throw new Error('The composer draft text must not be blank.');
+        return cloneDraft(current);
+    }
+    clearExact(keyArg, revisionArg) {
+        const current = this.drafts.get(keyArg);
+        if (!current || current.revision !== revisionArg) {
+            return { draft: cloneDraft(current ?? emptyDraft()) };
+        }
+        if (current.revision >= Number.MAX_SAFE_INTEGER) {
+            throw new ControllerDraftLimitError('The draft revision limit was reached.');
+        }
+        const next = {
+            text: '',
+            attachments: [],
+            revision: current.revision + 1,
+        };
+        this.store(keyArg, current, next);
+        return {
+            draft: cloneDraft(next),
+            update: { revision: next.revision, text: '', attachments: [] },
+        };
+    }
+    purge(keyArg) {
+        const current = this.drafts.get(keyArg);
+        if (!current)
+            return;
+        this.drafts.delete(keyArg);
+        if (isNonEmpty(current))
+            this.nonEmptyDrafts -= 1;
+        this.aggregateAttachmentBytes -= attachmentBytes(current);
+    }
+    purgePrefix(prefixArg) {
+        for (const key of this.drafts.keys()) {
+            if (key.startsWith(prefixArg))
+                this.purge(key);
+        }
+    }
+    clear() {
+        this.drafts.clear();
+        this.nonEmptyDrafts = 0;
+        this.aggregateAttachmentBytes = 0;
+    }
+    assertDraftFields(textArg, attachmentsArg) {
+        if (Buffer.byteLength(textArg, 'utf8') > controllerMaxDraftTextBytes) {
+            throw new ControllerDraftLimitError('The draft text exceeds the controller byte limit.');
+        }
+        if (attachmentsArg.length > controllerMaxDraftAttachments) {
+            throw new ControllerDraftLimitError('The draft attachment count exceeds the controller limit.');
+        }
+        const ids = new Set();
+        let bytes = 0;
+        for (const attachment of attachmentsArg) {
+            if (ids.has(attachment.id))
+                throw new Error('Draft attachment IDs must be unique.');
+            ids.add(attachment.id);
+            if (attachment.size > controllerMaxDraftAttachmentBytes) {
+                throw new ControllerDraftLimitError('A draft attachment exceeds the controller byte limit.');
+            }
+            bytes += attachment.size;
+        }
+        if (bytes > controllerMaxDraftAttachmentTotalBytes) {
+            throw new ControllerDraftLimitError('The draft attachments exceed the controller total byte limit.');
+        }
+    }
+    assertAdmission(keyArg, currentArg, nextArg) {
+        if (!this.drafts.has(keyArg) && this.drafts.size >= maximumDraftIdentities) {
+            throw new ControllerDraftLimitError('The controller draft identity limit is exhausted.');
+        }
+        const nextNonEmptyCount = this.nonEmptyDrafts
+            - (isNonEmpty(currentArg) ? 1 : 0)
+            + (isNonEmpty(nextArg) ? 1 : 0);
+        if (nextNonEmptyCount > maximumNonEmptyDrafts) {
+            throw new ControllerDraftLimitError('The controller non-empty draft limit is exhausted.');
+        }
+        const nextAttachmentBytes = this.aggregateAttachmentBytes
+            - attachmentBytes(currentArg)
+            + attachmentBytes(nextArg);
+        if (nextAttachmentBytes > maximumAggregateAttachmentBytes) {
+            throw new ControllerDraftLimitError('The controller draft attachment memory limit is exhausted.');
+        }
+    }
+    store(keyArg, currentArg, nextArg) {
+        this.nonEmptyDrafts += (isNonEmpty(nextArg) ? 1 : 0) - (isNonEmpty(currentArg) ? 1 : 0);
+        this.aggregateAttachmentBytes += attachmentBytes(nextArg) - attachmentBytes(currentArg);
+        this.drafts.set(keyArg, nextArg);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kcmFmdG1hbmFnZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGFzc2VzLmRyYWZ0bWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQ0wsaUNBQWlDLEVBQ2pDLHNDQUFzQyxFQUN0Qyw2QkFBNkIsRUFDN0IsMkJBQTJCLEdBSTVCLE1BQU0sZ0NBQWdDLENBQUM7QUFFeEMsTUFBTSxzQkFBc0IsR0FBRyxLQUFLLENBQUM7QUFDckMsTUFBTSxxQkFBcUIsR0FBRyxHQUFHLENBQUM7QUFDbEMsTUFBTSwrQkFBK0IsR0FBRyxFQUFFLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztBQUV6RCxNQUFNLE9BQU8sNEJBQTZCLFNBQVEsS0FBSztJQUN6QjtJQUE1QixZQUE0QixLQUE4QjtRQUN4RCxLQUFLLENBQUMsMENBQTBDLENBQUMsQ0FBQztRQUR4QixVQUFLLEdBQUwsS0FBSyxDQUF5QjtRQUV4RCxJQUFJLENBQUMsSUFBSSxHQUFHLDhCQUE4QixDQUFDO0lBQzdDLENBQUM7Q0FDRjtBQUVELE1BQU0sT0FBTyx5QkFBMEIsU0FBUSxLQUFLO0lBQ2xELFlBQVksVUFBa0I7UUFDNUIsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQ2xCLElBQUksQ0FBQyxJQUFJLEdBQUcsMkJBQTJCLENBQUM7SUFDMUMsQ0FBQztDQUNGO0FBT0QsTUFBTSxlQUFlLEdBQUcsQ0FDdEIsYUFBeUMsRUFDYixFQUFFLENBQUMsQ0FBQyxFQUFFLEdBQUcsYUFBYSxFQUFFLENBQUMsQ0FBQztBQUV4RCxNQUFNLFVBQVUsR0FBRyxDQUFDLFFBQWlDLEVBQTJCLEVBQUUsQ0FBQyxDQUFDO0lBQ2xGLElBQUksRUFBRSxRQUFRLENBQUMsSUFBSTtJQUNuQixXQUFXLEVBQUUsUUFBUSxDQUFDLFdBQVcsQ0FBQyxHQUFHLENBQUMsZUFBZSxDQUFDO0lBQ3RELFFBQVEsRUFBRSxRQUFRLENBQUMsUUFBUTtDQUM1QixD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

package/dist_ts/classes.embeddeddb.d.ts

@@ -0,0 +1,30 @@
+export { embeddedDatabaseSocketPath } from './functions.embeddeddb.js';
+export interface IEmbeddedControllerDatabaseOptions {
+    /** directory holding the smartdb storage files and its unix socket */
+    dataDirectory: string;
+    /** previous installed default, logically migrated only while its engine is stopped */
+    legacyDataDirectory?: string;
+}
+/**
+ * The controller's embedded database engine: a @push.rocks/smartdb
+ * LocalSmartDb over a unix socket inside the data directory. The socket
+ * path is deterministic so a second controller process (e.g. the
+ * temp-password CLI) attaches to the running daemon's engine instead of
+ * opening the storage files a second time; only the process that booted
+ * the engine stops it.
+ */
+export declare class EmbeddedControllerDatabase {
+    private readonly options;
+    private localDb?;
+    private connectionUri?;
+    private startPromise?;
+    private migrationRunner?;
+    constructor(options: IEmbeddedControllerDatabaseOptions);
+    get socketPath(): string;
+    get ownsEngine(): boolean;
+    /** Starts (or attaches to) the engine and returns the smartdata-ready URI. */
+    start(): Promise<string>;
+    private startOnce;
+    stop(): Promise<void>;
+    private isSocketListening;
+}