@andorra-labs/code 0.0.0-stage → 0.1.5

package/dist/vendor/engine/runtime/chord/facets/loader.d.ts

@@ -0,0 +1,2 @@
+import type { LoadedFacets } from "../types.js";
+export declare function andorraDisposeLoadedFacets(loaded: readonly LoadedFacets[]): Promise<unknown[]>;

package/dist/vendor/engine/runtime/chord/facets/loader.js

@@ -0,0 +1,4 @@
+export async function andorraDisposeLoadedFacets(loaded) {
+    const results = await Promise.allSettled(loaded.map((entry) => entry.dispose()));
+    return results.flatMap((result) => (result.status === "rejected" ? [result.reason] : []));
+}

package/dist/vendor/engine/runtime/chord/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Chord is a standalone application-composition runtime for agentic applications.
+ */
+export { andorraCombineFacetLoaders, andorraCreateFacetHost, andorraCreateRemoteServiceBinding, andorraCreateStaticFacetLoader, andorraDefineFacet, andorraDefineService, andorraReplicatedState, } from "./api.js";
+export { andorraIsJsonValue } from "./json.js";
+export { andorraIsRemoteServiceErrorCode, REMOTE_SERVICE_ERROR_CODES, AndorraRemoteServiceError, type RemoteServiceErrorCode, } from "./services/errors.js";
+export { andorraCreateRemoteServiceEndpoint, type RemoteServiceEndpoint, AndorraRemoteServiceProvider, type ServiceUpdatePublisher, } from "./services/provider.js";
+export { andorraCreateServiceStateDecoder, andorraCreateServiceStateEncoder, type ServiceStateDecoder, type ServiceStateEncoder, } from "./services/state-codec.js";
+export { andorraCreateServiceCatalogueCall, andorraCreateServiceSubscribeCall, andorraCreateServiceUnsubscribeCall, andorraDecodeServiceControlCall, andorraParseServiceCall, andorraParseServiceCatalogue, andorraParseServiceProviderUpdate, andorraParseServiceSubscriptionSnapshot, andorraParseWireServiceProviderUpdate, andorraParseWireServiceSubscriptionSnapshot, type ServiceControlCall, type WireServiceInstanceSnapshot, type WireServiceMemberSnapshot, type WireServiceProviderUpdate, type WireServiceSubscriptionSnapshot, } from "./services/wire.js";
+export type { Context, ContextKey, Facet, FacetEnvironment, FacetHost, FacetLoader, FacetOptions, JsonRepresentation, JsonValue, LoadedFacets, MutableReplicatedState, RemoteServiceBinding, RemoteServiceBindingOptions, RemoteServiceSource, RemoteServices, RemoteServiceTransport, ReplicatedState, ReplicatedStateDelivery, Service, ServiceCall, ServiceCatalogueEntry, ServiceInstanceAddress, ServiceInstanceSnapshot, ServiceMemberSnapshot, ServiceMode, ServiceProviderUpdate, ServiceSpawner, ServiceSubscription, ServiceSubscriptionSnapshot, } from "./types.js";

package/dist/vendor/engine/runtime/chord/index.js

@@ -0,0 +1,9 @@
+/**
+ * Chord is a standalone application-composition runtime for agentic applications.
+ */
+export { andorraCombineFacetLoaders, andorraCreateFacetHost, andorraCreateRemoteServiceBinding, andorraCreateStaticFacetLoader, andorraDefineFacet, andorraDefineService, andorraReplicatedState, } from "./api.js";
+export { andorraIsJsonValue } from "./json.js";
+export { andorraIsRemoteServiceErrorCode, REMOTE_SERVICE_ERROR_CODES, AndorraRemoteServiceError, } from "./services/errors.js";
+export { andorraCreateRemoteServiceEndpoint, AndorraRemoteServiceProvider, } from "./services/provider.js";
+export { andorraCreateServiceStateDecoder, andorraCreateServiceStateEncoder, } from "./services/state-codec.js";
+export { andorraCreateServiceCatalogueCall, andorraCreateServiceSubscribeCall, andorraCreateServiceUnsubscribeCall, andorraDecodeServiceControlCall, andorraParseServiceCall, andorraParseServiceCatalogue, andorraParseServiceProviderUpdate, andorraParseServiceSubscriptionSnapshot, andorraParseWireServiceProviderUpdate, andorraParseWireServiceSubscriptionSnapshot, } from "./services/wire.js";

package/dist/vendor/engine/runtime/chord/json.d.ts

@@ -0,0 +1,3 @@
+import type { JsonValue } from "./types.js";
+/** Return whether a value is finite strict JSON with plain objects and no cycles. */
+export declare function andorraIsJsonValue(value: unknown): value is JsonValue;

package/dist/vendor/engine/runtime/chord/json.js

@@ -0,0 +1,56 @@
+/** Return whether a value is finite strict JSON with plain objects and no cycles. */
+export function andorraIsJsonValue(value) {
+    return andorraCheck(value, new Set(), 0);
+}
+function andorraCheck(value, ancestors, depth) {
+    if (depth > 512)
+        return false;
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value)) {
+        const keys = Reflect.ownKeys(value);
+        if (keys.length !== value.length + 1 || keys.some((key) => typeof key !== "string"))
+            return false;
+        if (ancestors.has(value))
+            return false;
+        ancestors.add(value);
+        try {
+            for (let index = 0; index < value.length; index++) {
+                const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+                if (descriptor === undefined ||
+                    !descriptor.enumerable ||
+                    !("value" in descriptor) ||
+                    !andorraCheck(descriptor.value, ancestors, depth + 1)) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        finally {
+            ancestors.delete(value);
+        }
+    }
+    if (typeof value !== "object" || value === null)
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null)
+        return false;
+    if (Reflect.ownKeys(value).some((key) => typeof key !== "string"))
+        return false;
+    if (ancestors.has(value))
+        return false;
+    ancestors.add(value);
+    try {
+        for (const descriptor of Object.values(Object.getOwnPropertyDescriptors(value))) {
+            if (!descriptor.enumerable || !("value" in descriptor) || !andorraCheck(descriptor.value, ancestors, depth + 1)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}

package/dist/vendor/engine/runtime/chord/services/consumer.d.ts

@@ -0,0 +1,10 @@
+import type { Context, RemoteServiceBinding, RemoteServiceBindingOptions, Service } from "../types.js";
+export declare class AndorraRemoteServiceBindingImpl implements RemoteServiceBinding {
+    #private;
+    constructor(options: RemoteServiceBindingOptions);
+    use<T>(service: Service<T>): T;
+    observe<T>(service: Service<T>, handler: (service: T, context: Context) => void | Promise<void>): () => void;
+    ready(context: Context): Promise<void>;
+    rebind(bound: boolean, context: Context): Promise<void>;
+    dispose(context: Context): Promise<void>;
+}

package/dist/vendor/engine/runtime/chord/services/consumer.js

@@ -0,0 +1,536 @@
+import { andorraAwaitWithContext, BACKGROUND_CONTEXT } from "../context/index.js";
+import { AndorraRemoteServiceError } from "./errors.js";
+import { AndorraServiceSlot } from "./handle.js";
+import { AndorraInstanceDirectory } from "./instances.js";
+import { AndorraReplicatedStateReplica, andorraServiceDeliveryContext } from "./state.js";
+class AndorraMemberSlot {
+    #serviceId;
+    #member;
+    #invoke;
+    #state;
+    #isActive;
+    #assertAccess;
+    value;
+    #kind;
+    #expectedKind;
+    constructor(serviceId, member, invoke, isActive, assertAccess, reportError) {
+        this.#serviceId = serviceId;
+        this.#member = member;
+        this.#invoke = invoke;
+        this.#isActive = isActive;
+        this.#assertAccess = assertAccess;
+        this.#state = new AndorraReplicatedStateReplica(reportError);
+        const andorraCallable = () => { };
+        this.value = new Proxy(andorraCallable, {
+            apply: (_target, _thisArg, args) => this.#call(args),
+            get: (_target, property) => {
+                if (property === "value") {
+                    this.#assertAccess();
+                    this.#expect("state");
+                    return this.#state.value;
+                }
+                if (property === "subscribe")
+                    return this.#subscribe.bind(this);
+                if (property === Symbol.toStringTag)
+                    return "RemoteServiceMember";
+                if (property === "then")
+                    return undefined;
+                return undefined;
+            },
+        });
+    }
+    setDescription(kind) {
+        if (this.#kind !== undefined && this.#kind !== kind) {
+            throw new Error(`Remote service member ${this.#serviceId}.${this.#member} changed kind`);
+        }
+        this.#kind = kind;
+        if (this.#expectedKind !== undefined && this.#expectedKind !== kind) {
+            throw new AndorraRemoteServiceError("service_member_mismatch", `Remote service member ${this.#serviceId}.${this.#member} is ${kind}, not ${this.#expectedKind}`);
+        }
+    }
+    hydrate(sequence, ops, context) {
+        this.setDescription("state");
+        this.#state.hydrate(sequence, ops, context);
+    }
+    update(sequence, ops, context) {
+        this.setDescription("state");
+        this.#state.update(sequence, ops, context);
+    }
+    clear() {
+        this.#state.clear();
+    }
+    #subscribe(listener) {
+        this.#assertAccess();
+        if (typeof listener !== "function") {
+            throw new TypeError("Replicated state subscription listener must be a function");
+        }
+        this.#expect("state");
+        return this.#state.subscribe(listener);
+    }
+    #expect(kind) {
+        if (this.#expectedKind !== undefined && this.#expectedKind !== kind) {
+            throw new AndorraRemoteServiceError("service_member_mismatch", `Remote service member ${this.#serviceId}.${this.#member} was used as two different kinds`);
+        }
+        this.#expectedKind = kind;
+        if (this.#kind !== undefined && this.#kind !== kind) {
+            throw new AndorraRemoteServiceError("service_member_mismatch", `Remote service member ${this.#serviceId}.${this.#member} is ${this.#kind}, not ${kind}`);
+        }
+    }
+    #call(args) {
+        this.#assertAccess();
+        this.#expect("method");
+        if (!this.#isActive()) {
+            return Promise.reject(new AndorraRemoteServiceError("service_stale_instance", `Remote service ${this.#serviceId} binding is closed`));
+        }
+        const context = args.at(-1);
+        if (!andorraIsContext(context)) {
+            return Promise.reject(new AndorraRemoteServiceError("service_invalid_value", `Remote service method ${this.#serviceId}.${this.#member} requires a trailing Context`));
+        }
+        const businessArgs = args.slice(0, -1);
+        return this.#invoke(businessArgs, context);
+    }
+}
+class AndorraServiceFacade {
+    #serviceId;
+    #address;
+    #transport;
+    #reportError;
+    #slots = new Map();
+    #descriptions = new Map();
+    #isActive;
+    #assertAccess;
+    proxy;
+    constructor(serviceId, address, transport, isActive, assertAccess, reportError) {
+        this.#serviceId = serviceId;
+        this.#address = address;
+        this.#transport = transport;
+        this.#isActive = isActive;
+        this.#assertAccess = assertAccess;
+        this.#reportError = reportError;
+        this.proxy = new Proxy(Object.create(null), {
+            get: (_target, property) => {
+                if (typeof property !== "string")
+                    return undefined;
+                return this.#slot(property).value;
+            },
+        });
+    }
+    install(snapshot, context) {
+        if (!andorraSameAddress(snapshot.instance, this.#address))
+            throw new Error("Remote service snapshot has the wrong address");
+        const members = andorraValidateMembers(snapshot.members);
+        for (const name of this.#slots.keys()) {
+            if (!members.has(name)) {
+                throw new AndorraRemoteServiceError("service_member_not_found", `Unknown remote service member ${this.#serviceId}.${name}`);
+            }
+        }
+        this.#descriptions.clear();
+        for (const [name, member] of members)
+            this.#descriptions.set(name, member.kind);
+        for (const member of members.values()) {
+            const slot = this.#slots.get(member.name);
+            if (member.kind === "state") {
+                (slot ?? this.#slot(member.name)).hydrate(member.sequence, member.ops, context);
+            }
+            else {
+                slot?.setDescription(member.kind);
+            }
+        }
+    }
+    update(member, sequence, ops, context) {
+        if (this.#descriptions.get(member) !== "state") {
+            throw new Error(`Remote service update targets non-state member ${this.#serviceId}.${member}`);
+        }
+        this.#slot(member).update(sequence, ops, context);
+    }
+    clear() {
+        for (const slot of this.#slots.values())
+            slot.clear();
+    }
+    #slot(member) {
+        let slot = this.#slots.get(member);
+        if (slot !== undefined)
+            return slot;
+        slot = new AndorraMemberSlot(this.#serviceId, member, (args, context) => this.#transport.invoke({
+            serviceId: this.#serviceId,
+            ...(this.#address === undefined ? {} : { instance: this.#address }),
+            member,
+            args,
+        }, context), this.#isActive, this.#assertAccess, this.#reportError);
+        const kind = this.#descriptions.get(member);
+        if (kind !== undefined)
+            slot.setDescription(kind);
+        this.#slots.set(member, slot);
+        return slot;
+    }
+}
+class AndorraKeyedBinding {
+    #service;
+    #transport;
+    #reportError;
+    #assertAccess;
+    #onEmpty;
+    #instances;
+    #subscription;
+    #starting;
+    #closed = false;
+    #bound;
+    #revision = 0;
+    constructor(service, transport, reportError, assertAccess, onEmpty, bound) {
+        this.#service = service;
+        this.#transport = transport;
+        this.#reportError = reportError;
+        this.#assertAccess = assertAccess;
+        this.#onEmpty = onEmpty;
+        this.#bound = bound;
+        this.#instances = new AndorraInstanceDirectory({ ready: false, onError: reportError });
+    }
+    observe(handler) {
+        if (this.#closed)
+            throw new Error("Remote keyed service binding is closed");
+        let stopped = false;
+        const stop = this.#instances.observe((service, context) => {
+            const slot = new AndorraServiceSlot(this.#service.id, true);
+            void slot.bind(service);
+            return handler(slot.view(() => {
+                this.#assertAccess();
+                if (stopped || context.abortSignal?.aborted) {
+                    throw new AndorraRemoteServiceError("service_stale_instance", `Remote service ${this.#service.id} observation is closed`);
+                }
+            }), context);
+        });
+        if (this.#bound && this.#starting === undefined) {
+            const revision = this.#revision;
+            const starting = this.#start(revision);
+            this.#starting = starting;
+            void starting.catch((error) => {
+                if (!this.#closed && this.#revision === revision && this.#bound)
+                    this.#reportError(andorraToError(error));
+            });
+        }
+        return () => {
+            if (stopped)
+                return;
+            stopped = true;
+            stop();
+            if (this.#instances.observerCount === 0)
+                this.#onEmpty();
+        };
+    }
+    async rebind(bound, context) {
+        if (this.#closed)
+            return;
+        this.#bound = bound;
+        const revision = ++this.#revision;
+        await this.#reset(context, false);
+        if (this.#closed || this.#revision !== revision || this.#bound !== bound)
+            return;
+        if (bound && this.#instances.observerCount > 0) {
+            const starting = this.#start(revision);
+            this.#starting = starting;
+            await starting;
+        }
+    }
+    ready() {
+        return this.#starting ?? Promise.resolve();
+    }
+    async close(context) {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#revision += 1;
+        await this.#reset(context, true);
+        this.#instances.dispose();
+    }
+    async #reset(context, waitForStarting) {
+        this.#instances.reset();
+        const starting = this.#starting;
+        this.#starting = undefined;
+        const subscription = this.#subscription;
+        this.#subscription = undefined;
+        await Promise.all([
+            waitForStarting ? starting?.catch(() => { }) : undefined,
+            subscription === undefined ? undefined : subscription.close(context),
+        ]);
+    }
+    async #start(revision) {
+        const subscription = await this.#transport.subscribe(this.#service.id, "keyed", (update, context) => {
+            if (this.#revision === revision)
+                this.#update(update, context);
+        }, BACKGROUND_CONTEXT);
+        if (this.#closed || !this.#bound || this.#revision !== revision) {
+            await subscription.close(BACKGROUND_CONTEXT);
+            return;
+        }
+        this.#subscription = subscription;
+        if (subscription.snapshot.mode !== "keyed" || subscription.snapshot.serviceId !== this.#service.id) {
+            throw new Error(`Remote service ${this.#service.id} returned the wrong keyed snapshot`);
+        }
+        for (const snapshot of subscription.snapshot.instances)
+            this.#spawn(snapshot, andorraServiceDeliveryContext());
+        subscription.activate();
+        this.#instances.ready();
+    }
+    #update(update, context) {
+        if (this.#closed)
+            return;
+        try {
+            switch (update.type) {
+                case "unavailable":
+                case "replaced":
+                    throw new Error("Keyed service received a singleton lifecycle update");
+                case "spawned":
+                    this.#spawn(update.instance, context);
+                    break;
+                case "closed": {
+                    const instance = this.#instances.get(update.instance.key);
+                    if (instance?.generation === update.instance.generation)
+                        this.#instances.remove(instance);
+                    break;
+                }
+                case "state": {
+                    if (update.instance === undefined)
+                        throw new Error("Keyed state update has no instance address");
+                    const instance = this.#instances.get(update.instance.key);
+                    if (instance?.generation !== update.instance.generation)
+                        return;
+                    instance.facade.update(update.member, update.sequence, update.ops, context);
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            this.#reportError(andorraToError(error));
+        }
+    }
+    #spawn(snapshot, context) {
+        const address = snapshot.instance;
+        if (address === undefined)
+            throw new Error("Keyed service instance snapshot has no address");
+        let active = true;
+        const facade = new AndorraServiceFacade(this.#service.id, address, this.#transport, () => active && !this.#closed, this.#assertAccess, this.#reportError);
+        facade.install(snapshot, context);
+        this.#instances.replace({
+            key: address.key,
+            generation: address.generation,
+            service: facade.proxy,
+            facade,
+            deactivate: () => {
+                active = false;
+                facade.clear();
+            },
+        });
+    }
+}
+export class AndorraRemoteServiceBindingImpl {
+    #transport;
+    #allowlist = new Set();
+    #reportError;
+    #modes = new Map();
+    #assertAccess;
+    #singletons = new Map();
+    #keyed = new Map();
+    #bound;
+    #readinessRevision = 0;
+    #bindingTransition = Promise.resolve();
+    #disposed = false;
+    constructor(options) {
+        this.#transport = options.transport;
+        const ids = options.services.map(({ id }) => id);
+        if (new Set(ids).size !== ids.length)
+            throw new TypeError("Remote service binding has duplicate service IDs");
+        for (const id of ids)
+            this.#allowlist.add(id);
+        this.#reportError = options.onError ?? (() => { });
+        this.#assertAccess = options.assertAccess ?? (() => { });
+        this.#bound = options.bound ?? true;
+    }
+    use(service) {
+        this.#assertRemotable(service);
+        this.#assertAvailable(service.id, "singleton");
+        let binding = this.#singletons.get(service.id);
+        if (binding !== undefined)
+            return binding.facade.proxy;
+        binding = { facade: undefined, active: true, revision: 0 };
+        binding.facade = new AndorraServiceFacade(service.id, undefined, this.#transport, () => binding.active && !this.#disposed && this.#bound, () => this.#assertHandleAccess(), this.#reportError);
+        this.#singletons.set(service.id, binding);
+        this.#readinessRevision += 1;
+        if (this.#bound) {
+            const revision = binding.revision;
+            const starting = this.#startSingleton(service.id, binding, revision);
+            binding.starting = starting;
+            void starting.catch((error) => {
+                if (binding.active && binding.revision === revision && !this.#disposed && this.#bound) {
+                    this.#reportError(andorraToError(error));
+                }
+            });
+        }
+        return binding.facade.proxy;
+    }
+    observe(service, handler) {
+        this.#assertRemotable(service);
+        this.#assertAvailable(service.id, "keyed");
+        let binding = this.#keyed.get(service.id);
+        if (binding === undefined) {
+            binding = new AndorraKeyedBinding(service, this.#transport, this.#reportError, () => this.#assertHandleAccess(), () => {
+                if (this.#keyed.get(service.id) !== binding)
+                    return;
+                this.#keyed.delete(service.id);
+                this.#readinessRevision += 1;
+                void binding.close(BACKGROUND_CONTEXT).catch(this.#reportError);
+            }, this.#bound);
+            this.#keyed.set(service.id, binding);
+            this.#readinessRevision += 1;
+        }
+        return binding.observe(handler);
+    }
+    async ready(context) {
+        if (this.#disposed)
+            throw new Error("Remote service binding is disposed");
+        while (true) {
+            const revision = this.#readinessRevision;
+            const starts = [
+                this.#bindingTransition,
+                ...[...this.#singletons.values()].flatMap((binding) => binding.starting === undefined ? [] : [binding.starting]),
+                ...[...this.#keyed.values()].map((binding) => binding.ready()),
+            ];
+            await andorraAwaitWithContext(Promise.all(starts).then(() => undefined), context);
+            if (this.#disposed)
+                throw new Error("Remote service binding is disposed");
+            if (revision === this.#readinessRevision)
+                return;
+        }
+    }
+    async rebind(bound, context) {
+        if (this.#disposed)
+            throw new Error("Remote service binding is disposed");
+        this.#bound = bound;
+        this.#readinessRevision += 1;
+        const transitions = [];
+        for (const [serviceId, binding] of this.#singletons) {
+            binding.revision += 1;
+            binding.facade.clear();
+            const subscription = binding.subscription;
+            delete binding.subscription;
+            const revision = binding.revision;
+            const starting = (async () => {
+                await subscription?.close(context);
+                if (bound)
+                    await this.#startSingleton(serviceId, binding, revision);
+            })();
+            binding.starting = starting;
+            transitions.push(starting);
+        }
+        for (const binding of this.#keyed.values())
+            transitions.push(binding.rebind(bound, context));
+        const completion = (async () => {
+            const results = await Promise.allSettled(transitions);
+            const errors = results.filter((result) => result.status === "rejected");
+            if (errors.length > 0)
+                throw new AggregateError(errors.map(({ reason }) => reason), "Failed to rebind services");
+        })();
+        this.#bindingTransition = completion;
+        await completion;
+    }
+    async dispose(context) {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        const closes = [];
+        for (const binding of this.#singletons.values()) {
+            binding.active = false;
+            binding.facade.clear();
+            if (binding.starting)
+                closes.push(binding.starting.catch(() => { }));
+            if (binding.subscription)
+                closes.push(Promise.resolve(binding.subscription.close(context)));
+        }
+        for (const binding of this.#keyed.values())
+            closes.push(binding.close(context));
+        this.#singletons.clear();
+        this.#keyed.clear();
+        const results = await Promise.allSettled(closes);
+        const errors = results.filter((result) => result.status === "rejected");
+        if (errors.length > 0)
+            throw new AggregateError(errors.map(({ reason }) => reason), "Failed to dispose services");
+    }
+    async #startSingleton(serviceId, binding, revision) {
+        const subscription = await this.#transport.subscribe(serviceId, "singleton", (update, context) => {
+            if (!binding.active || binding.revision !== revision)
+                return;
+            try {
+                if (update.type === "unavailable") {
+                    binding.facade.clear();
+                }
+                else if (update.type === "replaced") {
+                    if (update.snapshot.instance !== undefined) {
+                        throw new Error("Singleton replacement has an instance address");
+                    }
+                    binding.facade.install(update.snapshot, context);
+                }
+                else if (update.type === "state" && update.instance === undefined) {
+                    binding.facade.update(update.member, update.sequence, update.ops, context);
+                }
+            }
+            catch (error) {
+                this.#reportError(andorraToError(error));
+            }
+        }, BACKGROUND_CONTEXT);
+        if (!binding.active || this.#disposed || !this.#bound || binding.revision !== revision) {
+            await subscription.close(BACKGROUND_CONTEXT);
+            return;
+        }
+        binding.subscription = subscription;
+        const snapshot = subscription.snapshot;
+        if (snapshot.mode !== "singleton" || snapshot.serviceId !== serviceId || snapshot.instances.length !== 1) {
+            throw new Error(`Remote service ${serviceId} returned an invalid singleton snapshot`);
+        }
+        binding.facade.install(snapshot.instances[0], andorraServiceDeliveryContext());
+        subscription.activate();
+    }
+    #assertHandleAccess() {
+        if (this.#disposed)
+            throw new Error("Remote service binding is disposed");
+        this.#assertAccess();
+    }
+    #assertRemotable(service) {
+        if (service.local)
+            throw new AndorraRemoteServiceError("service_not_allowed", `Service ${service.id} is process-local`);
+    }
+    #assertAvailable(serviceId, mode) {
+        if (this.#disposed)
+            throw new Error("Remote service binding is disposed");
+        if (!this.#allowlist.has(serviceId)) {
+            throw new AndorraRemoteServiceError("service_not_allowed", `Remote service ${serviceId} is not allowlisted`);
+        }
+        const existing = this.#modes.get(serviceId);
+        if (existing !== undefined && existing !== mode) {
+            throw new AndorraRemoteServiceError("service_mode_mismatch", `Remote service ${serviceId} is already used as ${existing}`);
+        }
+        this.#modes.set(serviceId, mode);
+    }
+}
+function andorraValidateMembers(members) {
+    const result = new Map();
+    for (const member of members) {
+        if (member.name.length === 0 || result.has(member.name)) {
+            throw new Error("Remote service has invalid member descriptions");
+        }
+        result.set(member.name, member);
+    }
+    return result;
+}
+function andorraSameAddress(left, right) {
+    if (left === undefined || right === undefined)
+        return left === right;
+    return left.key === right.key && left.generation === right.generation;
+}
+function andorraIsContext(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.value === "function" && typeof candidate.toString === "function";
+}
+function andorraToError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}

package/dist/vendor/engine/runtime/chord/services/errors.d.ts

@@ -0,0 +1,7 @@
+export declare const REMOTE_SERVICE_ERROR_CODES: readonly ["service_not_allowed", "service_not_found", "service_mode_mismatch", "service_member_not_found", "service_member_mismatch", "service_instance_not_found", "service_stale_instance", "service_invalid_value"];
+export type RemoteServiceErrorCode = (typeof REMOTE_SERVICE_ERROR_CODES)[number];
+export declare function andorraIsRemoteServiceErrorCode(value: unknown): value is RemoteServiceErrorCode;
+export declare class AndorraRemoteServiceError extends Error {
+    readonly code: RemoteServiceErrorCode;
+    constructor(code: RemoteServiceErrorCode, message: string);
+}

package/dist/vendor/engine/runtime/chord/services/errors.js

@@ -0,0 +1,21 @@
+export const REMOTE_SERVICE_ERROR_CODES = [
+    "service_not_allowed",
+    "service_not_found",
+    "service_mode_mismatch",
+    "service_member_not_found",
+    "service_member_mismatch",
+    "service_instance_not_found",
+    "service_stale_instance",
+    "service_invalid_value",
+];
+export function andorraIsRemoteServiceErrorCode(value) {
+    return typeof value === "string" && REMOTE_SERVICE_ERROR_CODES.includes(value);
+}
+export class AndorraRemoteServiceError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "RemoteServiceError";
+        this.code = code;
+    }
+}