@plurnk/plurnk-service 1.8.0 → 1.9.1

package/dist/server/WorkerCapabilities.js

@@ -0,0 +1,214 @@
+const COOLING_RETRY_MS = 5_000;
+const readBound = (env, name) => {
+    const raw = env[name];
+    const value = Number(raw);
+    if (raw === undefined || !Number.isSafeInteger(value) || value < -1) {
+        throw new Error(`${name} must be -1 or a non-negative safe integer; got ${JSON.stringify(raw)}.`);
+    }
+    return value;
+};
+export const workerCapabilityPolicy = (env = process.env) => ({
+    warmMs: readBound(env, "PLURNK_SERVICE_WORKER_WARM_MS"),
+    warmMax: readBound(env, "PLURNK_SERVICE_WORKER_WARM_MAX"),
+});
+// {§module-worker-residency} — one process-local owner separates durable
+// worker identity from optional Functionality residency. Leases represent
+// actual work; timers and the idle LRU are availability policy, not identity.
+export default class WorkerCapabilities {
+    #policy;
+    #activate;
+    #deactivate;
+    #report;
+    #states = new Map();
+    #idleSequence = 0;
+    #stopping = false;
+    constructor(policy, callbacks) {
+        this.#policy = policy;
+        this.#activate = callbacks.activate;
+        this.#deactivate = callbacks.deactivate;
+        this.#report = callbacks.report;
+    }
+    async acquire(workerId) {
+        WorkerCapabilities.#assertWorkerId(workerId);
+        if (this.#stopping)
+            throw new Error("Worker Functionality is stopping.");
+        for (;;) {
+            const current = this.#states.get(workerId);
+            if (current?.phase === "cooling") {
+                await current.transition;
+                if (this.#stopping)
+                    throw new Error("Worker Functionality is stopping.");
+                continue;
+            }
+            const state = current ?? this.#beginActivation(workerId);
+            this.#cancelIdle(state);
+            state.leases++;
+            try {
+                await state.transition;
+            }
+            catch (cause) {
+                this.#release(state);
+                throw cause;
+            }
+            if (this.#stopping) {
+                this.#release(state);
+                throw new Error("Worker Functionality is stopping.");
+            }
+            return this.#releaseOnce(state);
+        }
+    }
+    retain(workerId) {
+        WorkerCapabilities.#assertWorkerId(workerId);
+        if (this.#stopping)
+            throw new Error("Worker Functionality is stopping.");
+        const state = this.#states.get(workerId);
+        if (state === undefined || state.phase === "cooling") {
+            throw new Error(`Worker ${workerId} Functionality is not resident.`);
+        }
+        this.#cancelIdle(state);
+        state.leases++;
+        return this.#releaseOnce(state);
+    }
+    activeWorkerIds() {
+        return [...this.#states.values()]
+            .filter(({ phase }) => phase === "active")
+            .map(({ workerId }) => workerId)
+            .toSorted((left, right) => left - right);
+    }
+    isActive(workerId) {
+        return this.#states.get(workerId)?.phase === "active";
+    }
+    beginStop() {
+        if (this.#stopping)
+            return;
+        this.#stopping = true;
+        for (const state of this.#states.values())
+            this.#cancelIdle(state);
+    }
+    static #assertWorkerId(workerId) {
+        if (!Number.isSafeInteger(workerId) || workerId < 1) {
+            throw new Error("Worker Functionality residency requires a positive worker id.");
+        }
+    }
+    #beginActivation(workerId) {
+        const state = {
+            workerId,
+            phase: "activating",
+            leases: 0,
+            transition: null,
+            idleOrder: null,
+            timer: null,
+        };
+        this.#states.set(workerId, state);
+        state.transition = Promise.resolve()
+            .then(() => this.#activate(workerId))
+            .then(() => {
+            if (this.#states.get(workerId) !== state)
+                return;
+            state.phase = "active";
+            state.transition = null;
+            if (state.leases === 0)
+                this.#markIdle(state);
+        })
+            .catch((cause) => {
+            if (this.#states.get(workerId) === state) {
+                this.#cancelIdle(state);
+                this.#states.delete(workerId);
+            }
+            throw cause;
+        });
+        return state;
+    }
+    #releaseOnce(state) {
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            this.#release(state);
+        };
+    }
+    #release(state) {
+        if (state.leases === 0)
+            return;
+        state.leases--;
+        if (state.leases === 0
+            && state.phase === "active"
+            && this.#states.get(state.workerId) === state
+            && !this.#stopping) {
+            this.#markIdle(state);
+        }
+    }
+    #markIdle(state) {
+        if (state.phase !== "active" || state.leases !== 0 || this.#stopping)
+            return;
+        this.#cancelIdle(state);
+        state.idleOrder = ++this.#idleSequence;
+        this.#scheduleCooling(state, this.#policy.warmMs);
+        this.#enforceWarmMaximum();
+    }
+    #scheduleCooling(state, delayMs) {
+        if (delayMs < 0 || state.phase !== "active" || state.leases !== 0 || this.#stopping)
+            return;
+        if (delayMs === 0) {
+            queueMicrotask(() => { void this.#cool(state); });
+            return;
+        }
+        state.timer = setTimeout(() => {
+            state.timer = null;
+            void this.#cool(state);
+        }, delayMs);
+        state.timer.unref();
+    }
+    #enforceWarmMaximum() {
+        if (this.#policy.warmMax < 0 || this.#stopping)
+            return;
+        const idle = [...this.#states.values()]
+            .filter((state) => state.phase === "active" && state.leases === 0)
+            .toSorted((left, right) => (left.idleOrder ?? 0) - (right.idleOrder ?? 0));
+        for (const state of idle.slice(0, Math.max(0, idle.length - this.#policy.warmMax))) {
+            void this.#cool(state);
+        }
+    }
+    async #cool(state) {
+        if (this.#stopping
+            || state.phase !== "active"
+            || state.leases !== 0
+            || this.#states.get(state.workerId) !== state)
+            return;
+        this.#cancelIdle(state);
+        state.phase = "cooling";
+        const transition = Promise.resolve()
+            .then(() => this.#deactivate(state.workerId))
+            .then((cooled) => {
+            if (this.#states.get(state.workerId) !== state)
+                return;
+            if (cooled) {
+                this.#states.delete(state.workerId);
+                return;
+            }
+            state.phase = "active";
+            state.transition = null;
+            state.idleOrder = ++this.#idleSequence;
+            this.#scheduleCooling(state, COOLING_RETRY_MS);
+        })
+            .catch((cause) => {
+            if (this.#states.get(state.workerId) !== state)
+                return;
+            state.phase = "active";
+            state.transition = null;
+            state.idleOrder = ++this.#idleSequence;
+            this.#report(state.workerId, cause);
+            this.#scheduleCooling(state, COOLING_RETRY_MS);
+        });
+        state.transition = transition;
+        await transition;
+    }
+    #cancelIdle(state) {
+        if (state.timer !== null)
+            clearTimeout(state.timer);
+        state.timer = null;
+        state.idleOrder = null;
+    }
+}
+//# sourceMappingURL=WorkerCapabilities.js.map

package/dist/server/WorkerCapabilities.js.map

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

package/dist/server/WorkerResidency.d.ts

@@ -0,0 +1,40 @@
+import type Engine from "../core/Engine.ts";
+import type WorkspaceGate from "../core/WorkspaceGate.ts";
+import type { Db } from "../core/Db.ts";
+import type { RegistryEntry } from "../core/ExecutorRegistry.ts";
+import { type WorkerCapabilityRelease } from "./WorkerCapabilities.ts";
+import type { RuntimeRegistration, WorkerCapabilityGate, WorkerCapabilityProvider, WorkerCapabilityReplacement } from "./DaemonModule.ts";
+type NormalizedRuntime = {
+    tag: string;
+    entry: RegistryEntry;
+    scheme: RuntimeRegistration["scheme"];
+};
+export default class WorkerResidency {
+    #private;
+    constructor({ db, engine, workspaceGate, normalizeRuntime }: {
+        db: Db;
+        engine: () => Engine;
+        workspaceGate: WorkspaceGate;
+        normalizeRuntime: (registration: RuntimeRegistration) => NormalizedRuntime;
+    });
+    get published(): boolean;
+    publish(): void;
+    beginStop(): void;
+    activeWorkerIds(): number[];
+    isActive(workerId: number): boolean;
+    retain(workerId: number): WorkerCapabilityRelease;
+    registerProvider(namespaceOwner: string, provider: WorkerCapabilityProvider): void;
+    identity(workerId: number): Promise<{
+        workspaceId: number;
+        workerId: number;
+    }>;
+    acquire(workspaceId: number, workerId: number): Promise<WorkerCapabilityRelease>;
+    readModuleState(workerId: number, namespaceOwner: string): Promise<unknown | null>;
+    reconcile(workspaceId: number, workerId: number): Promise<void>;
+    rematerializeActive(): Promise<void>;
+    replace({ workspaceId, workerId, namespaceOwner, state, runtimes, }: WorkerCapabilityReplacement, options?: {
+        readonly gate?: WorkerCapabilityGate;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=WorkerResidency.d.ts.map

package/dist/server/WorkerResidency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerResidency.d.ts","sourceRoot":"","sources":["../../src/server/WorkerResidency.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAA2B,EAEvB,KAAK,uBAAuB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACR,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC9B,MAAM,mBAAmB,CAAC;AAW3B,KAAK,iBAAiB,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,eAAe;;IAUhC,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,EAAE;QACzD,EAAE,EAAE,EAAE,CAAC;QACP,MAAM,EAAE,MAAM,MAAM,CAAC;QACrB,aAAa,EAAE,aAAa,CAAC;QAC7B,gBAAgB,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,iBAAiB,CAAC;KAC9E,EAeA;IAID,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,IAAI,IAAI,CAEd;IAED,SAAS,IAAI,IAAI,CAEhB;IAED,eAAe,IAAI,MAAM,EAAE,CAE1B;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElC;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CAEhD;IAED,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAcjF;IAEK,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAWnF;IAIK,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAqBrF;IA0EK,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAevF;IAIK,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;IAIK,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzC;IAEK,OAAO,CAAC,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,KAAK,EACL,QAAQ,GACX,EAAE,2BAA2B,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiJrG;CACJ"}

package/dist/server/WorkerResidency.js

@@ -0,0 +1,283 @@
+import Results, { OperationFailureError } from "../core/results.js";
+import ClientInput from "./client-input.js";
+import LoopDocs from "./loopDocs.js";
+import WorkerCapabilities, { workerCapabilityPolicy, } from "./WorkerCapabilities.js";
+const residencyFailure = (code, status, detail, extensions = {}) => new OperationFailureError(Results.failure("daemon:worker-functionality", code, status, detail, {}, extensions));
+export default class WorkerResidency {
+    #db;
+    // Lazy: the composition root constructs the Engine after residency.
+    #engine;
+    #workspaceGate;
+    #normalizeRuntime;
+    #providers = new Map();
+    #capabilities;
+    #published = false;
+    constructor({ db, engine, workspaceGate, normalizeRuntime }) {
+        this.#db = db;
+        this.#engine = engine;
+        this.#workspaceGate = workspaceGate;
+        this.#normalizeRuntime = normalizeRuntime;
+        this.#capabilities = new WorkerCapabilities(workerCapabilityPolicy(), {
+            activate: (workerId) => this.#activate(workerId),
+            deactivate: (workerId) => this.#deactivate(workerId),
+            report: (workerId, error) => {
+                console.error(`Worker ${workerId} Functionality cooling failed:`, error);
+            },
+        });
+    }
+    // Publication marks the boot boundary after which registrations reconcile
+    // documents for already-active Workers.
+    get published() {
+        return this.#published;
+    }
+    publish() {
+        this.#published = true;
+    }
+    beginStop() {
+        this.#capabilities.beginStop();
+    }
+    activeWorkerIds() {
+        return this.#capabilities.activeWorkerIds();
+    }
+    isActive(workerId) {
+        return this.#capabilities.isActive(workerId);
+    }
+    retain(workerId) {
+        return this.#capabilities.retain(workerId);
+    }
+    registerProvider(namespaceOwner, provider) {
+        if (namespaceOwner.trim().length === 0) {
+            throw new Error("worker Functionality provider requires a non-empty namespace owner");
+        }
+        if (typeof provider?.activate !== "function"
+            || typeof provider?.deactivate !== "function") {
+            throw new Error("worker Functionality provider requires activate and deactivate functions");
+        }
+        if (this.#providers.has(namespaceOwner)) {
+            throw new Error(`worker Functionality provider '${namespaceOwner}' is already registered`);
+        }
+        this.#providers.set(namespaceOwner, provider);
+    }
+    async identity(workerId) {
+        const worker = await this.#db.envelope_get_worker_by_id.get({ id: workerId });
+        if (worker === undefined) {
+            throw residencyFailure("worker-not-found", 404, `Worker ${workerId} does not exist.`, { workerId, retryable: false });
+        }
+        return { workspaceId: worker.workspace_id, workerId };
+    }
+    // {§module-worker-residency} — demand acquires residency for the duration
+    // of one operation or action; idle residency cools by policy.
+    async acquire(workspaceId, workerId) {
+        const checkedWorkspaceId = ClientInput.assertId("worker Functionality residency", "workspaceId", workspaceId);
+        const checkedWorkerId = ClientInput.assertId("worker Functionality residency", "workerId", workerId);
+        const worker = await this.#db.envelope_get_worker_by_id.get({ id: checkedWorkerId });
+        if (worker?.workspace_id !== checkedWorkspaceId) {
+            throw residencyFailure("worker-not-found", 404, `Worker ${checkedWorkerId} does not exist in workspace ${checkedWorkspaceId}.`, { workspaceId: checkedWorkspaceId, workerId: checkedWorkerId, retryable: false });
+        }
+        return this.#capabilities.acquire(checkedWorkerId);
+    }
+    async #activate(workerId) {
+        const identity = await this.identity(workerId);
+        const { workspaceId } = identity;
+        try {
+            const context = {
+                ...identity,
+                retain: () => this.#capabilities.retain(workerId),
+            };
+            for (const provider of this.#providers.values()) {
+                await provider.activate(context);
+            }
+            await LoopDocs.materialize(this.#engine(), this.#db, workspaceId, workerId);
+        }
+        catch (cause) {
+            const cleanupErrors = [];
+            try {
+                await this.#deactivate(workerId, true);
+            }
+            catch (cleanupCause) {
+                cleanupErrors.push(cleanupCause);
+            }
+            if (cleanupErrors.length > 0) {
+                throw new AggregateError([cause, ...cleanupErrors], `Worker ${workerId} Functionality activation and cleanup failed`);
+            }
+            throw cause;
+        }
+    }
+    async #deactivate(workerId, waitForGate = false) {
+        const identity = await this.identity(workerId);
+        const { workspaceId } = identity;
+        const gate = waitForGate
+            ? this.#workspaceGate.requestExclusive(workspaceId)
+            : this.#workspaceGate.tryExclusive(workspaceId);
+        if (gate === null)
+            return false;
+        await gate.acquired;
+        try {
+            const prepared = [];
+            for (const namespaceOwner of this.#providers.keys()) {
+                prepared.push(await this.#engine().prepareWorkerRuntimes(workerId, namespaceOwner, []));
+            }
+            const deactivations = await Promise.allSettled([...this.#providers.values()]
+                .toReversed()
+                .map((provider) => Promise.resolve().then(() => provider.deactivate(identity))));
+            const errors = deactivations
+                .filter((result) => result.status === "rejected")
+                .map(({ reason }) => reason);
+            if (errors.length > 0) {
+                throw new AggregateError(errors, `Worker ${workerId} Functionality provider deactivation failed`);
+            }
+            for (const commit of prepared)
+                commit();
+            LoopDocs.evict(this.#db, workerId);
+            return true;
+        }
+        finally {
+            gate.release();
+        }
+    }
+    async readModuleState(workerId, namespaceOwner) {
+        const checkedWorkerId = ClientInput.assertId("worker module state", "workerId", workerId);
+        if (namespaceOwner.trim().length === 0) {
+            throw new Error("worker module state requires a non-empty namespace owner");
+        }
+        await this.identity(checkedWorkerId);
+        const row = await this.#db.worker_module_state_get.get({
+            worker_id: checkedWorkerId,
+            namespace_owner: namespaceOwner,
+        });
+        return row === undefined ? null : JSON.parse(row.state);
+    }
+    // Worker settings can change while Functionality remains resident; the
+    // pre-inference boundary reconciles one Worker's generated documents.
+    async reconcile(workspaceId, workerId) {
+        await LoopDocs.materialize(this.#engine(), this.#db, workspaceId, workerId);
+    }
+    // A global runtime or scheme registration after publication reconciles the
+    // generated documents of every resident Worker.
+    async rematerializeActive() {
+        if (!this.#published)
+            return;
+        for (const workerId of this.#capabilities.activeWorkerIds()) {
+            const { workspaceId } = await this.identity(workerId);
+            await LoopDocs.materialize(this.#engine(), this.#db, workspaceId, workerId);
+        }
+    }
+    async replace({ workspaceId, workerId, namespaceOwner, state, runtimes, }, options = {}) {
+        const checkedWorkspaceId = ClientInput.assertId("worker Functionality replacement", "workspaceId", workspaceId);
+        const checkedWorkerId = ClientInput.assertId("worker Functionality replacement", "workerId", workerId);
+        if (namespaceOwner.trim().length === 0) {
+            throw new Error("worker Functionality replacement requires a non-empty namespace owner");
+        }
+        const identity = await this.identity(checkedWorkerId);
+        if (identity.workspaceId !== checkedWorkspaceId) {
+            throw residencyFailure("workspace-mismatch", 409, `Worker ${checkedWorkerId} does not belong to workspace ${checkedWorkspaceId}.`, {
+                workspaceId: checkedWorkspaceId,
+                workerId: checkedWorkerId,
+                actualWorkspaceId: identity.workspaceId,
+                retryable: false,
+            });
+        }
+        const encoded = state === null ? null : JSON.stringify(state);
+        if (state !== null && encoded === undefined) {
+            throw residencyFailure("state-not-json", 400, "Worker module state is not JSON-serializable.", { namespaceOwner, retryable: false });
+        }
+        if (encoded !== null)
+            JSON.parse(encoded);
+        const normalized = runtimes.map((registration) => {
+            if (registration.namespaceOwner !== namespaceOwner) {
+                throw new Error(`worker runtime owner '${registration.namespaceOwner}' does not match '${namespaceOwner}'`);
+            }
+            return this.#normalizeRuntime(registration);
+        });
+        // {§module-worker-quiescence} — an explicit mutation (`try`) fails 409
+        // while the workspace is held; a Worker's own accepted mutation (`wait`)
+        // queues fairly behind its turn and publishes at that boundary; a
+        // demand-driven activation or turn-admission refresh (`none`) publishes
+        // inside whatever gate context its demand already holds.
+        const mode = options.gate ?? "try";
+        const gate = mode === "none"
+            ? undefined
+            : mode === "wait"
+                ? this.#workspaceGate.requestExclusive(checkedWorkspaceId)
+                : this.#workspaceGate.tryExclusive(checkedWorkspaceId);
+        if (gate === null) {
+            throw residencyFailure("workspace-busy", 409, `Workspace ${checkedWorkspaceId} is running an operation or another capability change.`, {
+                workspaceId: checkedWorkspaceId,
+                workerId: checkedWorkerId,
+                namespaceOwner,
+                recovery: "Settle the current operation and retry the capability change.",
+                retryable: true,
+            });
+        }
+        await gate?.acquired;
+        const prior = await this.#db.worker_module_state_get.get({
+            worker_id: checkedWorkerId,
+            namespace_owner: namespaceOwner,
+        });
+        let rollbackRuntimes;
+        let stateChanged = false;
+        try {
+            const commitRuntimes = await this.#engine().prepareWorkerRuntimes(checkedWorkerId, namespaceOwner, normalized);
+            if (encoded === null) {
+                await this.#db.worker_module_state_delete.run({
+                    worker_id: checkedWorkerId,
+                    namespace_owner: namespaceOwner,
+                });
+            }
+            else {
+                await this.#db.worker_module_state_put.run({
+                    worker_id: checkedWorkerId,
+                    namespace_owner: namespaceOwner,
+                    state: encoded,
+                });
+            }
+            stateChanged = true;
+            rollbackRuntimes = commitRuntimes();
+            if (this.#published
+                && this.#capabilities.isActive(checkedWorkerId)) {
+                await LoopDocs.materialize(this.#engine(), this.#db, checkedWorkspaceId, checkedWorkerId);
+            }
+        }
+        catch (cause) {
+            rollbackRuntimes?.();
+            const rollbackErrors = [];
+            if (stateChanged) {
+                try {
+                    if (prior === undefined) {
+                        await this.#db.worker_module_state_delete.run({
+                            worker_id: checkedWorkerId,
+                            namespace_owner: namespaceOwner,
+                        });
+                    }
+                    else {
+                        await this.#db.worker_module_state_put.run({
+                            worker_id: checkedWorkerId,
+                            namespace_owner: namespaceOwner,
+                            state: prior.state,
+                        });
+                    }
+                }
+                catch (rollbackCause) {
+                    rollbackErrors.push(rollbackCause);
+                }
+                if (this.#published
+                    && this.#capabilities.isActive(checkedWorkerId)) {
+                    try {
+                        await LoopDocs.materialize(this.#engine(), this.#db, checkedWorkspaceId, checkedWorkerId);
+                    }
+                    catch (rollbackCause) {
+                        rollbackErrors.push(rollbackCause);
+                    }
+                }
+            }
+            if (rollbackErrors.length > 0) {
+                throw new AggregateError([cause, ...rollbackErrors], "Worker Functionality replacement and rollback failed");
+            }
+            throw cause;
+        }
+        finally {
+            gate?.release();
+        }
+    }
+}
+//# sourceMappingURL=WorkerResidency.js.map

package/dist/server/WorkerResidency.js.map

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

package/dist/server/client-input.d.ts

@@ -12,6 +12,7 @@ export default class ClientInput {
     static assertOptionalChannel(context: string, channel: unknown): string | undefined;
     static assertId(context: string, field: string, value: unknown): number;
     static assertPrompt(context: string, prompt: unknown): string;
+    static assertOptionalSource(context: string, source: unknown): string | undefined;
     static assertMaxTurns(context: string, maxTurns: unknown): number | undefined;
     static assertOpenPaths(context: string, openPaths: unknown): string[] | undefined;
     static assertLimit(context: string, limit: unknown): number | undefined;

package/dist/server/client-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-input.d.ts","sourceRoot":"","sources":["../../src/server/client-input.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAEH,KAAK,2BAA2B,EACnC,MAAM,0BAA0B,CAAC;AAIlC,MAAM,CAAC,OAAO,OAAO,WAAW;;IAwB5B,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAoB7E;IAED,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAW5F;IAED,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAsBlG;IAED,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAYtH;IAED,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAYlG;IAED,MAAM,CAAC,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAG7F;IAED,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGzE;IAED,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAWlF;IAED,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtE;IAED,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAU5D;IAED,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAe5E;IAED,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAqBhF;IAED,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAWtE;IAED,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,kBAAkB,CA0DxF;IAED,MAAM,CAAC,iCAAiC,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,GACpB,2BAA2B,CAgB7B;IAED,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAqB7E;IAED,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAgD7E;IAID,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkD9F;IAKD,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CA+IzC;IAKD,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAoD/C;CACJ"}
+{"version":3,"file":"client-input.d.ts","sourceRoot":"","sources":["../../src/server/client-input.ts"],"names":[],"mappings":"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"}

package/dist/server/client-input.js

@@ -4,6 +4,7 @@
 import { isAbsolute } from "node:path";
 import { Policy } from "@plurnk/plurnk-execs";
 import Results, { OperationFailureError } from "../core/results.js";
+import FileCreationPolicy, { FILE_CREATE_SCOPES } from "../core/file-creation-policy.js";
 import WorkerName, { WorkerNameError } from "../core/WorkerName.js";
 import { Validator, } from "@plurnk/plurnk-contracts";
 const CONSTRAINT_EFFECTS = new Set(["pick", "hide", "view"]);
@@ -104,6 +105,14 @@ export default class ClientInput {
         }
         return prompt;
     }
+    static assertOptionalSource(context, source) {
+        if (source === undefined)
+            return undefined;
+        if (typeof source !== "string" || source.length === 0) {
+            ClientInput.#invalid(context, "source-invalid", "source is not a non-empty string.", { field: "source", recovery: "Provide a canonical actor address or omit source." });
+        }
+        return source;
+    }
     static assertMaxTurns(context, maxTurns) {
         if (maxTurns === undefined)
             return undefined;
@@ -277,7 +286,7 @@ export default class ClientInput {
             ClientInput.#invalid("workspace.create", "settings-invalid", "settings is not an object.", { field: "settings", recovery: "Provide a settings object." });
         }
         const r = parsed;
-        const supported = new Set(["filesItems", "maxCommands", "git", "client", "execs"]);
+        const supported = new Set(["filesItems", "maxCommands", "git", "fileCreateScope", "client", "execs"]);
         for (const key of Object.keys(r)) {
             if (!supported.has(key)) {
                 ClientInput.#invalid("workspace.create", "setting-not-supported", `settings.${key} is not supported.`, {
@@ -315,6 +324,18 @@ export default class ClientInput {
             }
             out.git = r.git;
         }
+        if (r.fileCreateScope !== undefined) {
+            try {
+                out.fileCreateScope = FileCreationPolicy.parse(r.fileCreateScope, "settings.fileCreateScope");
+            }
+            catch {
+                ClientInput.#invalid("workspace.create", "setting-invalid", `settings.fileCreateScope ${JSON.stringify(r.fileCreateScope)} is not supported.`, {
+                    field: "settings.fileCreateScope",
+                    allowedScopes: [...FILE_CREATE_SCOPES],
+                    recovery: `Use one of ${FILE_CREATE_SCOPES.join(", ")}.`,
+                });
+            }
+        }
         // {§client-metadata} — workspace-stable frontend id (e.g. "plurnk.nvim/1.4.0"), forwarded to the plurnk
         // provider as Plurnk-Client metadata; ignored by every other provider. Self-identified.
         if (r.client !== undefined) {