@fungi.computer/oyster 0.2.0 → 0.3.1

package/dist/installation-execution.js

@@ -0,0 +1,184 @@
+import { WorkerEntrypoint } from "cloudflare:workers";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import { z } from "zod";
+import { emptyAppDeclaration } from "@fungi.computer/puffball/app";
+import { applyInstallationCommand, isCommittedInstallation, } from "./apps/installation.js";
+import { deriveDeclaredOperations } from "./apps/operations.js";
+import { pendingCapabilities } from "./apps/permissions.js";
+import { BootGateError } from "./boot-gate.js";
+import { guestLimits } from "./guest-policy.js";
+import { instanceSchema, selectionOf } from "./index.js";
+import { ReleaseError, verifyRelease } from "./release.js";
+import { tenantScope } from "./tenant.js";
+import { retainedInstallationCommandSchema, installationRequestIdSchema, InstallationOperationError, } from "./installation-operations.js";
+import { instanceRefusalStatus } from "./instance-refusal.js";
+const refused = (status, code) => ({
+    state: "refused",
+    status,
+    code,
+});
+const unconfirmed = {
+    state: "unconfirmed",
+    outcome: "outcome_unknown",
+};
+/** Ordinary Worker-side verification and lifecycle I/O for one retained intent. */
+export async function executeInstallation(host, input) {
+    let command = retainedInstallationCommandSchema.parse(input);
+    const operations = host.installations.operations;
+    if (operations === undefined)
+        return unconfirmed;
+    const principal = await host.auth.resolve(command.admission.actor);
+    if (principal === null ||
+        !("role" in principal) ||
+        principal.role !== "owner")
+        return refused(403, "install_authority_unavailable");
+    if ((await host.installations.generation()) !== command.generation)
+        return refused(409, "stale_authority");
+    let verified;
+    try {
+        // Default verification reads UI/artifact bytes HERE, never inside REGISTRY.
+        verified = await verifyRelease(host.artifacts, command.admission.release);
+    }
+    catch (cause) {
+        return cause instanceof ReleaseError
+            ? refused(422, cause.code)
+            : unconfirmed;
+    }
+    if (command.plan === null) {
+        const declaration = verified.declaration ?? emptyAppDeclaration;
+        const baseline = command.baseline;
+        const declaredOperations = await deriveDeclaredOperations(verified.release, declaration, host.capabilities ?? []);
+        // A Workflow reuses the owner's approval; any capability or anonymous
+        // method its baseline has not approved waits for the owner.
+        if (command.admission.origin === "workflow" &&
+            (pendingCapabilities(baseline?.authority ?? { approvedGrants: [] }, declaration, declaredOperations).length > 0 ||
+                declaredOperations.anonymousMethods.some((method) => !(baseline?.approvedAnonymousMethods ?? []).some((approved) => approved.name === method.name &&
+                    approved.digest === method.digest))))
+            return refused(409, "needs_consent");
+        const reduced = applyInstallationCommand(baseline, baseline === null
+            ? {
+                kind: "install",
+                release: command.admission.release,
+                releasePin: "pinned",
+            }
+            : {
+                kind: "select-release",
+                release: command.admission.release,
+                releasePin: "pinned",
+            }, {
+            by: principal.actor,
+            role: principal.role,
+            expectedVersion: baseline?.authority.authorityVersion ?? null,
+            declaration,
+            declaredOperations,
+            now: command.acceptedAt,
+            identity: {
+                installationId: command.installationId,
+                instanceId: command.instanceId,
+            },
+        });
+        if (Result.isFailure(reduced))
+            return refused(409, reduced.failure.code);
+        try {
+            command = await operations.plan(command.admission.requestId, reduced.success.next, verified.backend !== null);
+        }
+        catch (cause) {
+            // The owner's own approval rule is a definitive domain refusal.
+            if (cause instanceof InstallationOperationError &&
+                cause.code === "needs_consent")
+                return refused(409, "needs_consent");
+            throw cause;
+        }
+    }
+    const plan = command.plan;
+    if (plan === null)
+        return unconfirmed;
+    const next = plan.installation;
+    const state = { ...selectionOf(next), status: next.status };
+    const current = await host.installations.get(command.installationId);
+    const alreadyCommitted = isCommittedInstallation(current, state, next.release);
+    if (!alreadyCommitted &&
+        JSON.stringify(current) !== JSON.stringify(command.baseline))
+        return refused(409, "stale_authority");
+    // A matching row cannot substitute for retained preparation evidence.
+    if (alreadyCommitted && !plan.prepared)
+        return unconfirmed;
+    const instance = verified.backend === null
+        ? null
+        : host.instances.get(state.instanceId, guestLimits(host.guestLimits));
+    let uiCheck = plan.uiCheck;
+    if (!alreadyCommitted && !plan.prepared) {
+        if (instance === null) {
+            try {
+                uiCheck = await host.bootUi(verified.release);
+            }
+            catch (cause) {
+                return cause instanceof BootGateError
+                    ? refused(422, cause.code)
+                    : unconfirmed;
+            }
+        }
+        else {
+            const prepared = await instance.prepare(state, next.release);
+            if (!prepared.ok)
+                return prepared.code === "failed"
+                    ? unconfirmed
+                    : refused(instanceRefusalStatus(prepared.code), prepared.code);
+            uiCheck = prepared.value;
+        }
+    }
+    if (uiCheck === undefined || (next.status === "enabled" && uiCheck === null))
+        return unconfirmed;
+    const commit = await operations.commit(command.admission.requestId, uiCheck);
+    if (!commit.ok)
+        return refused(409, commit.code);
+    if (instance !== null) {
+        // Replay the pinned fact; NEVER derive version N+1 from a current row here.
+        const applied = await instance.apply(state, next.release);
+        if (!applied.ok)
+            // Native apply can return stale_authority from its POST-application
+            // owner check. That code does not establish that application never ran.
+            return applied.code === "failed" || applied.code === "stale_authority"
+                ? unconfirmed
+                : refused(instanceRefusalStatus(applied.code), applied.code);
+        const receipt = Schema.decodeUnknownSync(instanceSchema)(applied.value);
+        if (receipt.instanceId !== state.instanceId ||
+            receipt.owner.kind !== "installation" ||
+            receipt.owner.id !== state.owner.id ||
+            receipt.appId !== state.appId ||
+            receipt.releaseId !== state.releaseId ||
+            receipt.authorityVersion !== state.authorityVersion ||
+            receipt.status !== (next.status === "enabled" ? "active" : next.status))
+            return unconfirmed;
+    }
+    if ((await host.installations.generation()) !== command.generation ||
+        !isCommittedInstallation(await host.installations.get(command.installationId), state, next.release))
+        return unconfirmed;
+    return {
+        state: "succeeded",
+        installation: next,
+        creation: command.creation,
+        uiCheck,
+    };
+}
+const executionProps = z.strictObject({
+    requestId: installationRequestIdSchema,
+    scope: retainedInstallationCommandSchema.shape.scope,
+});
+/** A loopback export with ordinary Worker I/O, not another resource or HTTP API. */
+export function installationWorkerEntrypoint(hostFor) {
+    return class extends WorkerEntrypoint {
+        /** Execute the retained command these props name, in its tenant scope. */
+        async run() {
+            const props = executionProps.parse(this.ctx.props);
+            const scope = tenantScope(props.scope.tenantId, props.scope.origin);
+            const host = await hostFor(this.env, scope);
+            const command = await host.installations.operations?.load(props.requestId);
+            if (command?.scope.tenantId !== scope.tenantId ||
+                command.scope.origin !== scope.origin)
+                return unconfirmed;
+            return executeInstallation(host, command);
+        }
+    };
+}