@camstack/addon-import-alexa 0.2.190 → 0.2.191

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.191] - 2026-11-06
+
+### Changed
+
+- Echo notification targets pick their Amazon account through the shared instance picker
+
 ## [0.2.190] - 2026-11-06
 
 ### Changed

package/dist/addon.js

@@ -13577,6 +13577,39 @@ function buildCapturingReply(envelope) {
 	return wrapper;
 }
 /**
+* The link primitive's declaration half (D1013 rule 5): what a link field names and how a kind
+* records it. Split from `instance-link.ts` so `RecordIntegrationInstances` can read the links of
+* its kind without importing the builders that import it.
+*/
+/** The body field of a link: the id of the instance it names; the target rides in the field meta. */
+function linkField(target) {
+	return string().meta({ link: target });
+}
+function linkTargetOf(meta) {
+	if (typeof meta !== "object" || meta === null) return void 0;
+	const link = Reflect.get(meta, "link");
+	const parsed = LinkTargetSchema.safeParse(link);
+	return parsed.success ? parsed.data : void 0;
+}
+var LinkTargetSchema = object({
+	cap: string().min(1),
+	kind: string().min(1).optional()
+});
+/** The links a kind declares, read from the meta of its body fields. */
+function linksOfKind(kind) {
+	const schema = kind.schema;
+	if (!(schema instanceof ZodObject)) return [];
+	const links = [];
+	for (const [field, fieldSchema] of Object.entries(schema.shape)) {
+		const to = linkTargetOf(globalRegistry.get(fieldSchema));
+		if (to !== void 0) links.push({
+			field,
+			to
+		});
+	}
+	return links;
+}
+/**
 * `RecordIntegrationInstances` - the `integration-instances` provider over ONE
 * entry kind, so an addon that holds a connection serves it in ~30 lines.
 *
@@ -13697,9 +13730,18 @@ var RecordIntegrationInstances = class {
 			...health?.lastCheckedAt !== void 0 ? { lastCheckedAt: health.lastCheckedAt } : {}
 		};
 	}
-	describe = async () => this.hooks.mintId === void 0 ? this.hooks.description : {
-		...this.hooks.description,
-		mintsId: true
+	describe = async () => {
+		const declared = linksOfKind(this.kind);
+		const links = this.hooks.description.links !== void 0 || declared.length === 0 ? {} : { links: declared.map((link) => ({
+			kind: this.kind.name,
+			field: link.field,
+			to: link.to
+		})) };
+		return {
+			...this.hooks.description,
+			...links,
+			...this.hooks.mintId === void 0 ? {} : { mintsId: true }
+		};
 	};
 	instanceFormSchema = async ({ id }) => this.hooks.formSchema(id);
 	listInstances = async () => {
@@ -13820,10 +13862,14 @@ function composeInstanceKinds(parts, base) {
 		kind: part.kind.id
 	});
 	return {
-		describe: async () => ({
-			...base,
-			kinds: parts.map((part) => part.kind)
-		}),
+		describe: async () => {
+			const links = (await Promise.all(parts.map(async (part) => (await part.provider.describe()).links ?? []))).flat();
+			return {
+				...base,
+				kinds: parts.map((part) => part.kind),
+				...links.length > 0 ? { links } : {}
+			};
+		},
 		instanceFormSchema: async ({ id, kind }) => {
 			return (id === null ? byKind(kind) : await holderOf(id)).provider.instanceFormSchema({ id });
 		},
@@ -56524,18 +56570,38 @@ var IntegrationInstanceKindSchema = object({
 	/** Relative hub path to disconnect that account. */
 	disconnectPath: string().min(1).optional()
 });
+/**
+* How devices of an instance are found. `none`: the operator adds them by hand; `lan`: the addon
+* scans the network before any instance exists (the wizard offers the candidates); `account`: the
+* devices appear after the instance signs in. `scopedToInstance`: a discovery run belongs to ONE
+* instance and its candidates are claimed by it.
+*/
+var IntegrationInstanceDiscoverySchema = object({
+	mode: _enum([
+		"none",
+		"lan",
+		"account"
+	]),
+	scopedToInstance: boolean()
+});
+/**
+* One link a kind of this provider declares (D1013 rule 5): the body `field` of an instance of
+* `kind` holds the id of an instance of the function cap `to.cap` (of kind `to.kind`, when set).
+* The hub indexes these so the target's delete is refused while a link names it.
+*/
+var IntegrationInstanceLinkSchema = object({
+	kind: string().min(1),
+	field: string().min(1),
+	to: object({
+		cap: string().min(1),
+		kind: string().min(1).optional()
+	})
+});
 var IntegrationInstanceDescriptionSchema = object({
 	/** What the instances are for the Integrations page; see {@link IntegrationInstanceRoleSchema}. */
 	role: IntegrationInstanceRoleSchema,
 	/** How the devices of an instance are found; absent means `{ mode: 'none' }`. */
-	discovery: object({
-		mode: _enum([
-			"none",
-			"lan",
-			"account"
-		]),
-		scopedToInstance: boolean()
-	}).optional(),
+	discovery: IntegrationInstanceDiscoverySchema.optional(),
 	/** `single`: at most one instance can exist (Loki). `multiple`: an account each. */
 	instanceMode: IntegrationInstanceModeSchema,
 	/** What the instance is, for the UI (`destination`, `relay`, `account`). */
@@ -56556,7 +56622,9 @@ var IntegrationInstanceDescriptionSchema = object({
 	* `createInstance` without an `id` works: the provider mints it. Absent means the caller must
 	* send an id (the UI then mints an opaque one).
 	*/
-	mintsId: boolean().optional()
+	mintsId: boolean().optional(),
+	/** The links to other instances the provider's kinds declare; absent means none. */
+	links: array(IntegrationInstanceLinkSchema).optional()
 });
 var IntegrationInstanceStatusSchema = object({
 	state: _enum([
@@ -98442,27 +98510,51 @@ object({
 	delay: number$1().nonnegative().optional(),
 	commands: record(string(), unknown())
 });
-var BrokerInUseError = class extends Error {
-	brokerId;
+var InstanceInUseError = class extends Error {
+	instanceId;
 	users;
-	name = "BrokerInUseError";
-	constructor(brokerId, users) {
-		super(`broker '${brokerId}' is still in use by ${users.map((u) => `${u.kind} '${u.name ?? u.id}' (${u.id})`).join(", ")}; unlink them first`);
-		this.brokerId = brokerId;
+	name = "InstanceInUseError";
+	constructor(instanceId, users) {
+		super(`instance '${instanceId}' is still in use by ${users.map((u) => `${u.kind} '${u.name ?? u.id}' (${u.id})`).join(", ")}; unlink them first`);
+		this.instanceId = instanceId;
 		this.users = users;
 	}
 };
-/** Throw {@link BrokerInUseError} when any finder names a user of `brokerId`. */
-async function assertBrokerUnused(brokerId, finders) {
+/** Throw {@link InstanceInUseError} when any finder names a user of `instanceId`. */
+async function assertInstanceUnused(instanceId, finders) {
 	const users = [];
-	for (const finder of finders) users.push(...await finder.find(brokerId));
-	if (users.length > 0) throw new BrokerInUseError(brokerId, users);
+	for (const finder of finders) users.push(...await finder.find(instanceId));
+	if (users.length > 0) throw new InstanceInUseError(instanceId, users);
 }
-/**
-* An account provider whose `deleteInstance` is refused while anything still uses the account
-* (D1012). The account is an `integration-instances` kind (D1013), so the refusal lives on the
-* delete the instances page calls, not on a separate broker cap.
-*/
+/** The `instance-select` field of a link, keyed like the body field it fills. */
+function linkFieldDescriptor(key, target, labels) {
+	return {
+		type: "instance-select",
+		key,
+		label: labels.label,
+		...labels.description !== void 0 ? { description: labels.description } : {},
+		required: labels.required ?? true,
+		...labels.noneLabel !== void 0 ? { noneLabel: labels.noneLabel } : {},
+		functionCap: target.cap,
+		...target.kind !== void 0 ? { kind: target.kind } : {}
+	};
+}
+/** @deprecated use {@link InstanceInUseError}; this one only adds the old `brokerId` name. */
+var BrokerInUseError = class extends InstanceInUseError {
+	get brokerId() {
+		return this.instanceId;
+	}
+};
+/** @deprecated use {@link assertInstanceUnused}. */
+async function assertBrokerUnused(brokerId, finders) {
+	try {
+		await assertInstanceUnused(brokerId, finders);
+	} catch (err) {
+		if (err instanceof InstanceInUseError) throw new BrokerInUseError(err.instanceId, err.users);
+		throw err;
+	}
+}
+/** @deprecated use `guardInstanceDelete`. */
 function guardBrokerDelete(base, users) {
 	return {
 		...base,
@@ -98616,6 +98708,35 @@ function brokerLinkPortsOver(deps) {
 	};
 }
 //#endregion
+//#region src/speak/constants.ts
+/** Echo speech limits and the worker restart bound (same window as CrashSupervisor). */
+var ALEXA_SPEAK_ADDON_ID = "import-alexa";
+var ALEXA_SPEAK_KIND = "alexa-echo";
+/** The kind of the Amazon-account broker the Echoes are read from. */
+var ALEXA_BROKER_KIND = "alexa";
+/** The Amazon account an Echo target speaks through. */
+var ALEXA_ACCOUNT_LINK = {
+	cap: "broker",
+	kind: ALEXA_BROKER_KIND
+};
+var DEVICE_REFRESH_MS = 5 * 6e4;
+/** Where the addon serves the Alexa mark; `listTargetKinds` stamps it as `iconUrl`. */
+var ALEXA_SPEAK_ICON_URL = `/addon/${ALEXA_SPEAK_ADDON_ID}/icons/${ALEXA_SPEAK_KIND}`;
+/** How often an adopted Echo's player state is read (a push channel is a later phase). */
+var ECHO_POLL_MS = 3e4;
+/** One more read after a command, once Amazon has had time to apply it. */
+var ECHO_REREAD_MS = 1500;
+/** After a 429 the account is left alone for this long, doubling up to the cap. */
+var ECHO_RATE_BACKOFF_BASE_MS = 3e4;
+var ECHO_RATE_BACKOFF_MAX_MS = 5 * 6e4;
+/**
+* A command (volume, play, Do Not Disturb) that has not started within this, or not
+* finished, is answered with an error instead of running minutes late.
+*/
+var ECHO_COMMAND_DEADLINE_MS = 12e3;
+/** A poll read is stale after this; it is dropped from the queue rather than sent late. */
+var ECHO_READ_DEADLINE_MS = 25e3;
+//#endregion
 //#region src/config.ts
 /**
 * Alexa account connection settings for ONE broker (= one Amazon account).
@@ -98672,7 +98793,7 @@ var alexaEchoTargetSchema = object({
 	name: string(),
 	enabled: boolean(),
 	/** The broker (Amazon account) the Echo belongs to; '' until one is chosen. */
-	brokerId: string().default(""),
+	brokerId: linkField(ALEXA_ACCOUNT_LINK).default(""),
 	echoId: string(),
 	respectDnd: boolean()
 });
@@ -144037,30 +144158,6 @@ function withListedVolume(status, listed) {
 	};
 }
 //#endregion
-//#region src/speak/constants.ts
-/** Echo speech limits and the worker restart bound (same window as CrashSupervisor). */
-var ALEXA_SPEAK_ADDON_ID = "import-alexa";
-var ALEXA_SPEAK_KIND = "alexa-echo";
-/** The kind of the Amazon-account broker the Echoes are read from. */
-var ALEXA_BROKER_KIND = "alexa";
-var DEVICE_REFRESH_MS = 5 * 6e4;
-/** Where the addon serves the Alexa mark; `listTargetKinds` stamps it as `iconUrl`. */
-var ALEXA_SPEAK_ICON_URL = `/addon/${ALEXA_SPEAK_ADDON_ID}/icons/${ALEXA_SPEAK_KIND}`;
-/** How often an adopted Echo's player state is read (a push channel is a later phase). */
-var ECHO_POLL_MS = 3e4;
-/** One more read after a command, once Amazon has had time to apply it. */
-var ECHO_REREAD_MS = 1500;
-/** After a 429 the account is left alone for this long, doubling up to the cap. */
-var ECHO_RATE_BACKOFF_BASE_MS = 3e4;
-var ECHO_RATE_BACKOFF_MAX_MS = 5 * 6e4;
-/**
-* A command (volume, play, Do Not Disturb) that has not started within this, or not
-* finished, is answered with an error instead of running minutes late.
-*/
-var ECHO_COMMAND_DEADLINE_MS = 12e3;
-/** A poll read is stale after this; it is dropped from the queue rather than sent late. */
-var ECHO_READ_DEADLINE_MS = 25e3;
-//#endregion
 //#region src/speak/worker-protocol.ts
 /** Line-delimited JSON the long-lived Python worker speaks. One object per line. */
 var EchoDeviceSchema = object({
@@ -145138,6 +145235,13 @@ function speechFromNotification(notification) {
 }
 //#endregion
 //#region src/speak/provider.ts
+/**
+* `notification-output` provider for Echo devices. Text is the rule template
+* as plain speech. A burst collapses or waits; it is not queued. A transport
+* failure is `success: false` so the notification outbox retries. A collapse,
+* a rate limit, or Do Not Disturb is a recorded skip (`success: true`) so the
+* outbox does not speak the same sentence again later.
+*/
 function quietLogger$1() {
 	const logger = {
 		debug() {},
@@ -145193,11 +145297,8 @@ function configSchema() {
 		title: "Echo",
 		titleKey: "import-alexa:echoTarget.s_echo.title",
 		fields: [...[{
-			type: "broker-select",
-			key: "brokerId",
-			label: "Amazon account",
-			labelKey: "import-alexa:echoTarget.s_echo.brokerId.label",
-			brokerKind: ALEXA_BROKER_KIND
+			...linkFieldDescriptor("brokerId", ALEXA_ACCOUNT_LINK, { label: "Amazon account" }),
+			labelKey: "import-alexa:echoTarget.s_echo.brokerId.label"
 		}, {
 			type: "select",
 			key: "echoId",

package/dist/addon.mjs

@@ -13575,6 +13575,39 @@ function buildCapturingReply(envelope) {
 	return wrapper;
 }
 /**
+* The link primitive's declaration half (D1013 rule 5): what a link field names and how a kind
+* records it. Split from `instance-link.ts` so `RecordIntegrationInstances` can read the links of
+* its kind without importing the builders that import it.
+*/
+/** The body field of a link: the id of the instance it names; the target rides in the field meta. */
+function linkField(target) {
+	return string().meta({ link: target });
+}
+function linkTargetOf(meta) {
+	if (typeof meta !== "object" || meta === null) return void 0;
+	const link = Reflect.get(meta, "link");
+	const parsed = LinkTargetSchema.safeParse(link);
+	return parsed.success ? parsed.data : void 0;
+}
+var LinkTargetSchema = object({
+	cap: string().min(1),
+	kind: string().min(1).optional()
+});
+/** The links a kind declares, read from the meta of its body fields. */
+function linksOfKind(kind) {
+	const schema = kind.schema;
+	if (!(schema instanceof ZodObject)) return [];
+	const links = [];
+	for (const [field, fieldSchema] of Object.entries(schema.shape)) {
+		const to = linkTargetOf(globalRegistry.get(fieldSchema));
+		if (to !== void 0) links.push({
+			field,
+			to
+		});
+	}
+	return links;
+}
+/**
 * `RecordIntegrationInstances` - the `integration-instances` provider over ONE
 * entry kind, so an addon that holds a connection serves it in ~30 lines.
 *
@@ -13695,9 +13728,18 @@ var RecordIntegrationInstances = class {
 			...health?.lastCheckedAt !== void 0 ? { lastCheckedAt: health.lastCheckedAt } : {}
 		};
 	}
-	describe = async () => this.hooks.mintId === void 0 ? this.hooks.description : {
-		...this.hooks.description,
-		mintsId: true
+	describe = async () => {
+		const declared = linksOfKind(this.kind);
+		const links = this.hooks.description.links !== void 0 || declared.length === 0 ? {} : { links: declared.map((link) => ({
+			kind: this.kind.name,
+			field: link.field,
+			to: link.to
+		})) };
+		return {
+			...this.hooks.description,
+			...links,
+			...this.hooks.mintId === void 0 ? {} : { mintsId: true }
+		};
 	};
 	instanceFormSchema = async ({ id }) => this.hooks.formSchema(id);
 	listInstances = async () => {
@@ -13818,10 +13860,14 @@ function composeInstanceKinds(parts, base) {
 		kind: part.kind.id
 	});
 	return {
-		describe: async () => ({
-			...base,
-			kinds: parts.map((part) => part.kind)
-		}),
+		describe: async () => {
+			const links = (await Promise.all(parts.map(async (part) => (await part.provider.describe()).links ?? []))).flat();
+			return {
+				...base,
+				kinds: parts.map((part) => part.kind),
+				...links.length > 0 ? { links } : {}
+			};
+		},
 		instanceFormSchema: async ({ id, kind }) => {
 			return (id === null ? byKind(kind) : await holderOf(id)).provider.instanceFormSchema({ id });
 		},
@@ -56522,18 +56568,38 @@ var IntegrationInstanceKindSchema = object({
 	/** Relative hub path to disconnect that account. */
 	disconnectPath: string().min(1).optional()
 });
+/**
+* How devices of an instance are found. `none`: the operator adds them by hand; `lan`: the addon
+* scans the network before any instance exists (the wizard offers the candidates); `account`: the
+* devices appear after the instance signs in. `scopedToInstance`: a discovery run belongs to ONE
+* instance and its candidates are claimed by it.
+*/
+var IntegrationInstanceDiscoverySchema = object({
+	mode: _enum([
+		"none",
+		"lan",
+		"account"
+	]),
+	scopedToInstance: boolean()
+});
+/**
+* One link a kind of this provider declares (D1013 rule 5): the body `field` of an instance of
+* `kind` holds the id of an instance of the function cap `to.cap` (of kind `to.kind`, when set).
+* The hub indexes these so the target's delete is refused while a link names it.
+*/
+var IntegrationInstanceLinkSchema = object({
+	kind: string().min(1),
+	field: string().min(1),
+	to: object({
+		cap: string().min(1),
+		kind: string().min(1).optional()
+	})
+});
 var IntegrationInstanceDescriptionSchema = object({
 	/** What the instances are for the Integrations page; see {@link IntegrationInstanceRoleSchema}. */
 	role: IntegrationInstanceRoleSchema,
 	/** How the devices of an instance are found; absent means `{ mode: 'none' }`. */
-	discovery: object({
-		mode: _enum([
-			"none",
-			"lan",
-			"account"
-		]),
-		scopedToInstance: boolean()
-	}).optional(),
+	discovery: IntegrationInstanceDiscoverySchema.optional(),
 	/** `single`: at most one instance can exist (Loki). `multiple`: an account each. */
 	instanceMode: IntegrationInstanceModeSchema,
 	/** What the instance is, for the UI (`destination`, `relay`, `account`). */
@@ -56554,7 +56620,9 @@ var IntegrationInstanceDescriptionSchema = object({
 	* `createInstance` without an `id` works: the provider mints it. Absent means the caller must
 	* send an id (the UI then mints an opaque one).
 	*/
-	mintsId: boolean().optional()
+	mintsId: boolean().optional(),
+	/** The links to other instances the provider's kinds declare; absent means none. */
+	links: array(IntegrationInstanceLinkSchema).optional()
 });
 var IntegrationInstanceStatusSchema = object({
 	state: _enum([
@@ -98440,27 +98508,51 @@ object({
 	delay: number$1().nonnegative().optional(),
 	commands: record(string(), unknown())
 });
-var BrokerInUseError = class extends Error {
-	brokerId;
+var InstanceInUseError = class extends Error {
+	instanceId;
 	users;
-	name = "BrokerInUseError";
-	constructor(brokerId, users) {
-		super(`broker '${brokerId}' is still in use by ${users.map((u) => `${u.kind} '${u.name ?? u.id}' (${u.id})`).join(", ")}; unlink them first`);
-		this.brokerId = brokerId;
+	name = "InstanceInUseError";
+	constructor(instanceId, users) {
+		super(`instance '${instanceId}' is still in use by ${users.map((u) => `${u.kind} '${u.name ?? u.id}' (${u.id})`).join(", ")}; unlink them first`);
+		this.instanceId = instanceId;
 		this.users = users;
 	}
 };
-/** Throw {@link BrokerInUseError} when any finder names a user of `brokerId`. */
-async function assertBrokerUnused(brokerId, finders) {
+/** Throw {@link InstanceInUseError} when any finder names a user of `instanceId`. */
+async function assertInstanceUnused(instanceId, finders) {
 	const users = [];
-	for (const finder of finders) users.push(...await finder.find(brokerId));
-	if (users.length > 0) throw new BrokerInUseError(brokerId, users);
+	for (const finder of finders) users.push(...await finder.find(instanceId));
+	if (users.length > 0) throw new InstanceInUseError(instanceId, users);
 }
-/**
-* An account provider whose `deleteInstance` is refused while anything still uses the account
-* (D1012). The account is an `integration-instances` kind (D1013), so the refusal lives on the
-* delete the instances page calls, not on a separate broker cap.
-*/
+/** The `instance-select` field of a link, keyed like the body field it fills. */
+function linkFieldDescriptor(key, target, labels) {
+	return {
+		type: "instance-select",
+		key,
+		label: labels.label,
+		...labels.description !== void 0 ? { description: labels.description } : {},
+		required: labels.required ?? true,
+		...labels.noneLabel !== void 0 ? { noneLabel: labels.noneLabel } : {},
+		functionCap: target.cap,
+		...target.kind !== void 0 ? { kind: target.kind } : {}
+	};
+}
+/** @deprecated use {@link InstanceInUseError}; this one only adds the old `brokerId` name. */
+var BrokerInUseError = class extends InstanceInUseError {
+	get brokerId() {
+		return this.instanceId;
+	}
+};
+/** @deprecated use {@link assertInstanceUnused}. */
+async function assertBrokerUnused(brokerId, finders) {
+	try {
+		await assertInstanceUnused(brokerId, finders);
+	} catch (err) {
+		if (err instanceof InstanceInUseError) throw new BrokerInUseError(err.instanceId, err.users);
+		throw err;
+	}
+}
+/** @deprecated use `guardInstanceDelete`. */
 function guardBrokerDelete(base, users) {
 	return {
 		...base,
@@ -98614,6 +98706,35 @@ function brokerLinkPortsOver(deps) {
 	};
 }
 //#endregion
+//#region src/speak/constants.ts
+/** Echo speech limits and the worker restart bound (same window as CrashSupervisor). */
+var ALEXA_SPEAK_ADDON_ID = "import-alexa";
+var ALEXA_SPEAK_KIND = "alexa-echo";
+/** The kind of the Amazon-account broker the Echoes are read from. */
+var ALEXA_BROKER_KIND = "alexa";
+/** The Amazon account an Echo target speaks through. */
+var ALEXA_ACCOUNT_LINK = {
+	cap: "broker",
+	kind: ALEXA_BROKER_KIND
+};
+var DEVICE_REFRESH_MS = 5 * 6e4;
+/** Where the addon serves the Alexa mark; `listTargetKinds` stamps it as `iconUrl`. */
+var ALEXA_SPEAK_ICON_URL = `/addon/${ALEXA_SPEAK_ADDON_ID}/icons/${ALEXA_SPEAK_KIND}`;
+/** How often an adopted Echo's player state is read (a push channel is a later phase). */
+var ECHO_POLL_MS = 3e4;
+/** One more read after a command, once Amazon has had time to apply it. */
+var ECHO_REREAD_MS = 1500;
+/** After a 429 the account is left alone for this long, doubling up to the cap. */
+var ECHO_RATE_BACKOFF_BASE_MS = 3e4;
+var ECHO_RATE_BACKOFF_MAX_MS = 5 * 6e4;
+/**
+* A command (volume, play, Do Not Disturb) that has not started within this, or not
+* finished, is answered with an error instead of running minutes late.
+*/
+var ECHO_COMMAND_DEADLINE_MS = 12e3;
+/** A poll read is stale after this; it is dropped from the queue rather than sent late. */
+var ECHO_READ_DEADLINE_MS = 25e3;
+//#endregion
 //#region src/config.ts
 /**
 * Alexa account connection settings for ONE broker (= one Amazon account).
@@ -98670,7 +98791,7 @@ var alexaEchoTargetSchema = object({
 	name: string(),
 	enabled: boolean(),
 	/** The broker (Amazon account) the Echo belongs to; '' until one is chosen. */
-	brokerId: string().default(""),
+	brokerId: linkField(ALEXA_ACCOUNT_LINK).default(""),
 	echoId: string(),
 	respectDnd: boolean()
 });
@@ -144035,30 +144156,6 @@ function withListedVolume(status, listed) {
 	};
 }
 //#endregion
-//#region src/speak/constants.ts
-/** Echo speech limits and the worker restart bound (same window as CrashSupervisor). */
-var ALEXA_SPEAK_ADDON_ID = "import-alexa";
-var ALEXA_SPEAK_KIND = "alexa-echo";
-/** The kind of the Amazon-account broker the Echoes are read from. */
-var ALEXA_BROKER_KIND = "alexa";
-var DEVICE_REFRESH_MS = 5 * 6e4;
-/** Where the addon serves the Alexa mark; `listTargetKinds` stamps it as `iconUrl`. */
-var ALEXA_SPEAK_ICON_URL = `/addon/${ALEXA_SPEAK_ADDON_ID}/icons/${ALEXA_SPEAK_KIND}`;
-/** How often an adopted Echo's player state is read (a push channel is a later phase). */
-var ECHO_POLL_MS = 3e4;
-/** One more read after a command, once Amazon has had time to apply it. */
-var ECHO_REREAD_MS = 1500;
-/** After a 429 the account is left alone for this long, doubling up to the cap. */
-var ECHO_RATE_BACKOFF_BASE_MS = 3e4;
-var ECHO_RATE_BACKOFF_MAX_MS = 5 * 6e4;
-/**
-* A command (volume, play, Do Not Disturb) that has not started within this, or not
-* finished, is answered with an error instead of running minutes late.
-*/
-var ECHO_COMMAND_DEADLINE_MS = 12e3;
-/** A poll read is stale after this; it is dropped from the queue rather than sent late. */
-var ECHO_READ_DEADLINE_MS = 25e3;
-//#endregion
 //#region src/speak/worker-protocol.ts
 /** Line-delimited JSON the long-lived Python worker speaks. One object per line. */
 var EchoDeviceSchema = object({
@@ -145136,6 +145233,13 @@ function speechFromNotification(notification) {
 }
 //#endregion
 //#region src/speak/provider.ts
+/**
+* `notification-output` provider for Echo devices. Text is the rule template
+* as plain speech. A burst collapses or waits; it is not queued. A transport
+* failure is `success: false` so the notification outbox retries. A collapse,
+* a rate limit, or Do Not Disturb is a recorded skip (`success: true`) so the
+* outbox does not speak the same sentence again later.
+*/
 function quietLogger$1() {
 	const logger = {
 		debug() {},
@@ -145191,11 +145295,8 @@ function configSchema() {
 		title: "Echo",
 		titleKey: "import-alexa:echoTarget.s_echo.title",
 		fields: [...[{
-			type: "broker-select",
-			key: "brokerId",
-			label: "Amazon account",
-			labelKey: "import-alexa:echoTarget.s_echo.brokerId.label",
-			brokerKind: ALEXA_BROKER_KIND
+			...linkFieldDescriptor("brokerId", ALEXA_ACCOUNT_LINK, { label: "Amazon account" }),
+			labelKey: "import-alexa:echoTarget.s_echo.brokerId.label"
 		}, {
 			type: "select",
 			key: "echoId",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-import-alexa",
-  "version": "0.2.190",
+  "version": "0.2.191",
   "description": "Alexa device-import provider for CamStack — imports the smart-home devices in a user's Alexa account via the unofficial alexa-remote2 cookie/token client (the inverse of the Alexa exporter)",
   "keywords": [
     "camstack",
@@ -72,7 +72,7 @@
       }
     ],
     "requires": {
-      "server": ">=1.2.780"
+      "server": ">=1.2.784"
     }
   },
   "files": [