@withbuddi/buddi 0.1.0-pre.28 → 0.1.0-pre.29

package/packages/core/dist/places.js

@@ -0,0 +1,239 @@
+export const GEOCODER_HOST = 'geocoding-api.open-meteo.com';
+export const GEOCODER_URL = `https://${GEOCODER_HOST}/v1/search`;
+export const GEOCODE_TIMEOUT_MS = 8_000;
+/** The labels the Profile page suggests before the owner has them. */
+export const SUGGESTED_PLACES = ['Home', 'Work'];
+export const PLACE_LABEL_MAX = 40;
+export const PLACE_ADDRESS_MAX = 200;
+export const PLACES_MAX = 20;
+export class PlaceRefusal extends Error {
+    name = 'PlaceRefusal';
+}
+const COLUMNS = 'id, label, address, place_name, latitude, longitude, timezone';
+function toPlace(row) {
+    return {
+        id: String(row.id),
+        label: String(row.label),
+        address: row.address === null || row.address === undefined ? null : String(row.address),
+        name: String(row.place_name),
+        latitude: Number(row.latitude),
+        longitude: Number(row.longitude),
+        timezone: row.timezone === null || row.timezone === undefined ? null : String(row.timezone),
+    };
+}
+/** Every place, in the owner's order. A database without the table answers none. */
+export async function listOwnerPlaces(db) {
+    const { rows } = await db.query(`select ${COLUMNS} from core.owner_places order by position, created_at, lower(label)`);
+    return rows.map((row) => toPlace(row));
+}
+/** `Home` → `home`, `Mum's` → `mum-s`. */
+export function placeSlug(label) {
+    const slug = label
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+    return slug.slice(0, 40) || 'place';
+}
+/** "Lyon, Auvergne-Rhône-Alpes, France", without saying a part twice. */
+export function foundPlaceName(place) {
+    const parts = [place.name, place.admin1, place.country].filter((p) => typeof p === 'string' && p.trim() !== '');
+    return parts.filter((p, i) => parts.indexOf(p) === i).join(', ');
+}
+const clean = (text, max) => text.trim().replace(/\s+/g, ' ').slice(0, max);
+/**
+ * Add a place or change one. The label is the owner's own word and unique
+ * whatever its case; the id is made from it once and kept through renames.
+ */
+export async function saveOwnerPlace(db, input) {
+    const label = clean(input.label ?? '', PLACE_LABEL_MAX);
+    if (label === '')
+        throw new PlaceRefusal('Give the place a name, like Home or Work.');
+    const name = clean(input.name ?? '', 200);
+    if (name === '')
+        throw new PlaceRefusal('Find the place first, so buddi knows where it is.');
+    const { latitude, longitude } = input;
+    if (!Number.isFinite(latitude) || latitude < -90 || latitude > 90 || !Number.isFinite(longitude) || longitude < -180 || longitude > 180) {
+        throw new PlaceRefusal('Those coordinates are not on Earth.');
+    }
+    const address = input.address === undefined || input.address === null ? null : clean(input.address, PLACE_ADDRESS_MAX) || null;
+    const timezone = input.timezone === undefined || input.timezone === null || input.timezone.trim() === '' ? null : input.timezone.trim();
+    const places = await listOwnerPlaces(db);
+    const clash = places.find((p) => p.label.toLowerCase() === label.toLowerCase() && p.id !== input.id);
+    if (clash)
+        throw new PlaceRefusal(`You already have a place called ${clash.label}.`);
+    if (input.id !== undefined) {
+        const { rows } = await db.query(`update core.owner_places
+          set label = $2, address = $3, place_name = $4, latitude = $5, longitude = $6, timezone = $7, updated_at = now()
+        where id = $1
+        returning ${COLUMNS}`, [input.id, label, address, name, latitude, longitude, timezone]);
+        if (!rows[0])
+            throw new PlaceRefusal('That place is not saved any more.');
+        return toPlace(rows[0]);
+    }
+    if (places.length >= PLACES_MAX)
+        throw new PlaceRefusal(`${PLACES_MAX} places is the most buddi keeps.`);
+    let id = placeSlug(label);
+    for (let n = 2; places.some((p) => p.id === id); n += 1)
+        id = `${placeSlug(label)}-${n}`;
+    // Home first, then Work, then the rest in the order they were added.
+    const suggested = SUGGESTED_PLACES.findIndex((s) => s.toLowerCase() === label.toLowerCase());
+    const position = suggested >= 0 ? suggested : SUGGESTED_PLACES.length + places.length;
+    const { rows } = await db.query(`insert into core.owner_places (id, label, address, place_name, latitude, longitude, timezone, position)
+     values ($1, $2, $3, $4, $5, $6, $7, $8)
+     returning ${COLUMNS}`, [id, label, address, name, latitude, longitude, timezone, position]);
+    return toPlace(rows[0]);
+}
+export async function removeOwnerPlace(db, id) {
+    const { rows } = await db.query(`delete from core.owner_places where id = $1 returning ${COLUMNS}`, [id]);
+    return rows[0] ? toPlace(rows[0]) : null;
+}
+/* ------------------------------------------------------------------ *
+ * Finding a place
+ * ------------------------------------------------------------------ */
+const fold = (text) => text.normalize('NFKD').replace(/[̀-ͯ]/g, '').toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+/**
+ * The parts of an address worth asking a place-name geocoder about: split at
+ * commas and new lines, each without its numbers (a street number, a postcode),
+ * at most four, nothing said twice.
+ */
+export function addressParts(address) {
+    const parts = address
+        .split(/[,\n;]+/)
+        .map((part) => part.replace(/\S*\d\S*/g, ' ').replace(/\s+/g, ' ').trim())
+        .filter((part) => part.length >= 2);
+    return parts.filter((p, i) => parts.findIndex((q) => fold(q) === fold(p)) === i).slice(0, 4);
+}
+/** The geocoder's answer, shaped. Pure. */
+export function toFoundPlaces(payload) {
+    const results = payload?.results;
+    if (!Array.isArray(results))
+        return [];
+    return results.flatMap((raw) => {
+        const r = raw;
+        const latitude = typeof r.latitude === 'number' ? r.latitude : Number.NaN;
+        const longitude = typeof r.longitude === 'number' ? r.longitude : Number.NaN;
+        if (typeof r.name !== 'string' || !Number.isFinite(latitude) || !Number.isFinite(longitude))
+            return [];
+        return [{
+                name: r.name,
+                latitude,
+                longitude,
+                ...(typeof r.timezone === 'string' ? { timezone: r.timezone } : {}),
+                ...(typeof r.admin1 === 'string' ? { admin1: r.admin1 } : {}),
+                ...(typeof r.country === 'string' ? { country: r.country } : {}),
+            }];
+    });
+}
+async function searchName(http, name, signal) {
+    const url = new URL(GEOCODER_URL);
+    url.searchParams.set('name', name);
+    url.searchParams.set('count', '10');
+    url.searchParams.set('language', 'en');
+    url.searchParams.set('format', 'json');
+    const response = await http.request({
+        url: url.toString(),
+        headers: { accept: 'application/json' },
+        signal: signal ?? AbortSignal.timeout(GEOCODE_TIMEOUT_MS),
+        idleTimeoutMs: GEOCODE_TIMEOUT_MS,
+        maxBytes: 1_000_000,
+    });
+    if (!response.ok)
+        throw new Error(`The place finder answered ${response.status}; try again in a while.`);
+    return toFoundPlaces(await response.json());
+}
+/**
+ * Up to five towns an address may mean, best first. Each part of the address
+ * is asked for; an answer scores for being named exactly what was asked and
+ * for each other part its region or country agrees with, and keeps the
+ * geocoder's own order (which favours bigger places) between equals.
+ */
+export async function findPlaces(http, address, signal) {
+    const parts = addressParts(address);
+    if (parts.length === 0)
+        return [];
+    const answers = await Promise.all(parts.map((part) => searchName(http, part, signal).catch((err) => err)));
+    if (answers.every((a) => a instanceof Error))
+        throw answers[0];
+    const folded = parts.map(fold);
+    const scored = [];
+    answers.forEach((answer, which) => {
+        if (answer instanceof Error || !Array.isArray(answer))
+            return;
+        answer.forEach((place, index) => {
+            const context = [place.admin1, place.country].filter((x) => typeof x === 'string').map(fold);
+            let score = fold(place.name) === folded[which] ? 3 : 0;
+            for (let other = 0; other < folded.length; other += 1) {
+                if (other !== which && context.some((c) => c === folded[other] || c.startsWith(`${folded[other]} `)))
+                    score += 2;
+            }
+            scored.push({ place, score, order: which * 100 + index });
+        });
+    });
+    scored.sort((a, b) => b.score - a.score || a.order - b.order);
+    const seen = new Set();
+    const out = [];
+    for (const { place } of scored) {
+        const key = `${place.latitude.toFixed(3)},${place.longitude.toFixed(3)}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(place);
+        if (out.length === 5)
+            break;
+    }
+    return out;
+}
+/* ------------------------------------------------------------------ *
+ * Places that used to live in the weather plugin
+ * ------------------------------------------------------------------ */
+/**
+ * Bring the weather plugin's Home and Work into core, once.
+ *
+ * Before 1.18 the weather plugin kept the owner's places in `weather.place`.
+ * Its place marked home (as Home, whatever it was called) and its places
+ * called Home or Work move here, keeping a place the owner already has under
+ * that label. The import is recorded, so it runs once per installation: a
+ * place removed afterwards is not brought back. A database without the
+ * weather schema records nothing, so a weather plugin restored later is still
+ * read. Answers how many places came in, or null when it had already run or
+ * there was nothing to read. The one place core reads a plugin's table, and
+ * only this once.
+ */
+export async function importWeatherPlaces(pool) {
+    const { rows: exists } = await pool.query(`select to_regclass('weather.place') is not null as present`);
+    if (exists[0]?.present !== true)
+        return null;
+    const { rows: done } = await pool.query(`select 1 from core.owner_place_imports where source = 'weather'`);
+    if (done.length > 0)
+        return null;
+    const { rows } = await pool.query(`select label, name, latitude, longitude, timezone, is_home from weather.place order by is_home desc, created_at`);
+    const wanted = [];
+    for (const row of rows) {
+        const label = String(row.label ?? '').trim();
+        const lower = label.toLowerCase();
+        const as = lower === 'home' || lower === 'work' ? (lower === 'home' ? 'Home' : 'Work') : row.is_home === true ? 'Home' : undefined;
+        if (as === undefined || wanted.some((w) => w.label === as))
+            continue;
+        wanted.push({ label: as, row });
+    }
+    const { rows: claimed } = await pool.query(`insert into core.owner_place_imports (source, imported) values ('weather', $1)
+     on conflict (source) do nothing returning source`, [wanted.length]);
+    if (claimed.length === 0)
+        return null;
+    let imported = 0;
+    for (const { label, row } of wanted) {
+        const id = placeSlug(label);
+        const { rows: inserted } = await pool.query(`insert into core.owner_places (id, label, address, place_name, latitude, longitude, timezone, position)
+       select $1, $2, $3, $3, $4, $5, $6, $7
+        where not exists (select 1 from core.owner_places where lower(label) = lower($2) or id = $1)
+       returning id`, [id, label, String(row.name), Number(row.latitude), Number(row.longitude), row.timezone ?? null, label === 'Home' ? 0 : 1]);
+        imported += inserted.length;
+    }
+    if (imported !== wanted.length) {
+        await pool.query(`update core.owner_place_imports set imported = $1 where source = 'weather'`, [imported]);
+    }
+    return imported;
+}
+//# sourceMappingURL=places.js.map

package/packages/core/dist/places.js.map

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

package/packages/core/dist/plugin/index.d.ts

@@ -21,6 +21,8 @@ export { PLUGIN_USES, PLUGIN_USE_WORDS, isPluginUse, parsePluginUses, pluginUses
 export type { AddressPolicy, BlockReason, CheckedUrl } from './url.js';
 export type { PageFile } from './page-file.js';
 export type { PluginUse } from './uses.js';
+export type { PluginExport, PluginReadiness, PluginSetup } from './requires.js';
+export { PluginCallRefusal } from './requires.js';
 export type { PluginAuthor } from './author.js';
 export type { NativeSearchEvent, NativeSearchRecord, SearchBackendChoice } from './search.js';
 export type { CarryOverContributor, CarryOverRequest, EffectDescription, GroupContext, NetworkUse, OwnerChoice, PluginManifest, PreviewProvider, Source, SourceContext, SourceWatch, SuggestedAgent, SuggestedAgentMission, SuggestedMission, SuggestedSkill, Tier, ToolContext, ToolDefinition, ZodToolDefinition, JsonSchemaToolDefinition, } from '../tools.js';
@@ -33,6 +35,10 @@ export type { CalendarMap, ChartSeries, Component, Field, FieldAction, OptionsFr
 export type { HomeBlock, HomeBlockContribution, HomeContribution, HomeGlance, HomeGlanceCard, HomeGlanceContribution, HomeRow, HomeStat } from '../home.js';
 export { HOME_CARD_LINE_MAX, HOME_CARD_TREND_MAX, HOME_CARD_VALUE_MAX, HOME_GLANCE_MAX } from '../home.js';
 export type { MetricDefinition, MetricDirection, MetricReading, MetricUnit } from '../metrics.js';
+export type { WidgetBody, WidgetBodyKind, WidgetDefinition, WidgetList, WidgetListRow, WidgetProgress, WidgetRequest, WidgetSize, WidgetStat, WidgetStrip, WidgetStripItem, WidgetText, WidgetSurface, } from '../widgets.js';
+export type { WidgetMultiselectField, WidgetPlace, WidgetPlaceField, WidgetSelectField, WidgetSettingField, WidgetSettingKind, WidgetSettingOption, WidgetSettingOptions, WidgetSettings, WidgetTextField, WidgetTimeFormatField, WidgetToggleField, } from '../widget-settings.js';
+export { WIDGET_OPTIONS_MAX, WIDGET_PLACES_MAX, WIDGET_SETTING_KINDS, WIDGET_SETTINGS_MAX } from '../widget-settings.js';
+export { WIDGET_BODY_KINDS, WIDGET_ITEMS_MAX, WIDGET_LINE_MAX, WIDGET_ROWS_MAX, WIDGET_SIZES, WIDGET_TEXT_MAX, WIDGET_TITLE_MAX, WIDGET_TREND_MAX, WIDGET_VALUE_MAX } from '../widgets.js';
 export type { PolicyApplyResult, PolicyHandler, PolicyHandlerContext, Proposal, ProposalDecider, RunProvenance, UntrustedKind, UntrustedSource, } from '../learning/types.js';
 export type { ProposePolicyInput } from '../learning/policies.js';
 export type { CreateProposalResult, TrackRecord } from '../learning/store.js';
@@ -42,5 +48,6 @@ export type { SurfaceProfile } from '../surfaces.js';
 export type { ArtifactKind, ArtifactSource } from '../artifacts/store.js';
 export type { ToolPermission } from '../actions/permissions.js';
 export type { MisfirePolicy } from '../scheduler/types.js';
-export type { AccountsArea, ApprovalsArea, ConversationDecision, BuddiHost, ChannelsArea, ClockArea, DbArea, DbResult, DbTransaction, DirArea, EnqueueRunInput, FileRow, FilesArea, HttpArea, HttpRequest, HttpResponse, MemoryArea, MemoryNote, OwnerArea, PluginChannel, PluginChannelMessage, PluginOwnerMessage, PagesArea, ProposalsArea, RegisterHost, ScheduleArea, SecretBinding, SecretDeliveryContext, SecretDestination, SecretListing, SecretRule, SecretUseOutcome, SecretUseResult, SecretsArea, ToolsArea, NetworkArea, } from '../host/types.js';
+export type { AccountsArea, ApprovalsArea, ConversationDecision, BuddiHost, ChannelsArea, ClockArea, DbArea, DbResult, DbTransaction, DirArea, EnqueueRunInput, FileRow, FilesArea, HttpArea, HttpRequest, HttpResponse, MemoryArea, MemoryNote, OwnerArea, PluginChannel, PluginChannelMessage, PluginOwnerMessage, PagesArea, PluginsArea, ProposalsArea, RegisterHost, ScheduleArea, SecretBinding, SecretDeliveryContext, SecretDestination, SecretListing, SecretRule, SecretUseOutcome, SecretUseResult, SecretsArea, ToolsArea, NetworkArea, } from '../host/types.js';
+export type { OwnerPlace } from '../places.js';
 //# sourceMappingURL=index.d.ts.map

package/packages/core/dist/plugin/index.d.ts.map

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

package/packages/core/dist/plugin/index.js

@@ -19,6 +19,9 @@ export { HOST_API_VERSION, hostApiProblem } from './version.js';
 export { NATIVE_BACKEND_ID, SEARCH_BACKEND_VAR, parseSearchBackend } from './search.js';
 export { AUTHOR_NAME_MAX, authorOfPackageJson, parsePluginAuthor, pluginAuthorMismatch } from './author.js';
 export { PLUGIN_USES, PLUGIN_USE_WORDS, isPluginUse, parsePluginUses, pluginUsesChange, pluginUsesMismatch, } from './uses.js';
+export { PluginCallRefusal } from './requires.js';
 export { TILE_ICONS } from '../views.js';
 export { HOME_CARD_LINE_MAX, HOME_CARD_TREND_MAX, HOME_CARD_VALUE_MAX, HOME_GLANCE_MAX } from '../home.js';
+export { WIDGET_OPTIONS_MAX, WIDGET_PLACES_MAX, WIDGET_SETTING_KINDS, WIDGET_SETTINGS_MAX } from '../widget-settings.js';
+export { WIDGET_BODY_KINDS, WIDGET_ITEMS_MAX, WIDGET_LINE_MAX, WIDGET_ROWS_MAX, WIDGET_SIZES, WIDGET_TEXT_MAX, WIDGET_TITLE_MAX, WIDGET_TREND_MAX, WIDGET_VALUE_MAX } from '../widgets.js';
 //# sourceMappingURL=index.js.map

package/packages/core/dist/plugin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC5G,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAyCnB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuBzC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC5G,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAOnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAoClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuBzC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA+B3G,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/packages/core/dist/plugin/requires.d.ts

@@ -0,0 +1,75 @@
+/**
+ * What one plugin needs of another, whether it is set up, and the narrow road
+ * between them (docs/plugins.md §2.9, §2.10; host API 1.18).
+ *
+ *  - **setup**: one read-only answer, `{ ready, note?, page? }`. A plugin that
+ *    is installed but cannot do anything yet ("Pick a place", "Link a
+ *    calendar") says so, and the Plugins row shows "Needs setup" instead of
+ *    "loaded". A plugin without it is simply loaded.
+ *  - **requires**: `{ "<plugin>": "<semver range>" }`, declared twice like
+ *    `uses` (the manifest, and `package.json`'s `buddi.requires` for the
+ *    install card). A plugin whose requirement is missing, disabled, outside
+ *    the range or not set up does not load its tools or widgets; its data
+ *    stays.
+ *  - **exports**: named read-only queries another plugin may call through
+ *    `ctx.buddi.plugins.call`, and only one that requires this plugin.
+ *
+ * Pure: shapes, the parse, the comparison. No state and no I/O.
+ */
+import type { ZodTypeAny } from 'zod';
+import type { ToolContext } from '../tools.js';
+/** A plugin's answer to "can you do anything yet?". */
+export interface PluginReadiness {
+    ready: boolean;
+    /** What to do first, one short sentence: "Pick a place for the forecast." */
+    note?: string;
+    /** One of the plugin's own pages, by id, where that is done. */
+    page?: string;
+}
+/**
+ * `setup`: read-only, like a page query — `produce` runs on the read-only
+ * pool, bounded in time, and an answer that throws counts as no answer (the
+ * plugin is shown as loaded, and the failure is logged).
+ */
+export interface PluginSetup {
+    produce(ctx: ToolContext): Promise<PluginReadiness>;
+}
+/**
+ * One export: a named read-only query another plugin may call. `params`
+ * validates what the caller sends; `produce` runs with this plugin's own
+ * `ctx.buddi` over the read-only pool.
+ */
+export interface PluginExport {
+    description?: string;
+    params: ZodTypeAny;
+    produce(params: any, ctx: ToolContext): Promise<unknown>;
+}
+/** A call another plugin made that core refused, with the sentence why. */
+export declare class PluginCallRefusal extends Error {
+    readonly name = "PluginCallRefusal";
+}
+/** At most this many requirements; a name is a plugin name. */
+export declare const REQUIRES_MAX = 8;
+export declare const READINESS_NOTE_MAX = 120;
+/**
+ * Read a declared `requires`: the manifest's or `package.json`'s
+ * `buddi.requires`. Absent is none. Names sorted, so two that say the same
+ * thing compare equal however they were written.
+ */
+export declare function parsePluginRequires(value: unknown, where: string, self?: string): {
+    ok: true;
+    requires: Record<string, string>;
+} | {
+    ok: false;
+    message: string;
+};
+/** The sentence a plugin whose two `requires` disagree is refused with, or undefined. */
+export declare function pluginRequiresMismatch(plugin: string, manifest: Readonly<Record<string, string>>, pkg: Readonly<Record<string, string>>): string | undefined;
+/** Why a manifest's `exports` cannot register, or undefined. */
+export declare function exportsProblem(plugin: string, value: unknown): string | undefined;
+/**
+ * A readiness answer made sound: `ready` a boolean, the note one short line,
+ * the page one of the plugin's own. Undefined when it is not an answer.
+ */
+export declare function readinessOf(raw: unknown, pages: readonly string[]): PluginReadiness | undefined;
+//# sourceMappingURL=requires.d.ts.map

package/packages/core/dist/plugin/requires.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requires.d.ts","sourceRoot":"","sources":["../../src/plugin/requires.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED,2EAA2E;AAC3E,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAkB,IAAI,uBAAuB;CAC9C;AAED,+DAA+D;AAC/D,eAAO,MAAM,YAAY,IAAI,CAAC;AAG9B,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiBjF;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC1C,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACpC,MAAM,GAAG,SAAS,CAQpB;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAWjF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,GAAG,SAAS,CAS/F"}

package/packages/core/dist/plugin/requires.js

@@ -0,0 +1,77 @@
+import { isSemverRange } from '../semver.js';
+/** A call another plugin made that core refused, with the sentence why. */
+export class PluginCallRefusal extends Error {
+    name = 'PluginCallRefusal';
+}
+/** At most this many requirements; a name is a plugin name. */
+export const REQUIRES_MAX = 8;
+const PLUGIN_NAME = /^[a-z][a-z0-9_-]{0,63}$/;
+const EXPORT_NAME = /^[a-z][a-zA-Z0-9_]{0,63}$/;
+export const READINESS_NOTE_MAX = 120;
+/**
+ * Read a declared `requires`: the manifest's or `package.json`'s
+ * `buddi.requires`. Absent is none. Names sorted, so two that say the same
+ * thing compare equal however they were written.
+ */
+export function parsePluginRequires(value, where, self) {
+    if (value === undefined || value === null)
+        return { ok: true, requires: {} };
+    if (typeof value !== 'object' || Array.isArray(value)) {
+        return { ok: false, message: `${where} is not a map of plugin names to version ranges (expected e.g. { "weather": "^0.2.0" })` };
+    }
+    const entries = Object.entries(value);
+    if (entries.length > REQUIRES_MAX)
+        return { ok: false, message: `${where} names ${entries.length} plugins; at most ${REQUIRES_MAX}` };
+    const out = {};
+    for (const [name, range] of entries.sort(([a], [b]) => a.localeCompare(b))) {
+        if (!PLUGIN_NAME.test(name))
+            return { ok: false, message: `${where} names ${JSON.stringify(name)}, which is not a plugin name` };
+        if (name === self)
+            return { ok: false, message: `${where} names the plugin itself` };
+        if (typeof range !== 'string' || !isSemverRange(range)) {
+            return { ok: false, message: `${where} asks for ${name} ${JSON.stringify(range)}, which is not a version range (write e.g. "^0.2.0")` };
+        }
+        out[name] = range.trim() === '' ? '*' : range.trim();
+    }
+    return { ok: true, requires: out };
+}
+/** The sentence a plugin whose two `requires` disagree is refused with, or undefined. */
+export function pluginRequiresMismatch(plugin, manifest, pkg) {
+    const words = (r) => Object.keys(r).length === 0 ? 'nothing' : Object.entries(r).map(([n, v]) => `${n} ${v}`).join(', ');
+    if (words(manifest) === words(pkg))
+        return undefined;
+    return (`plugin "${plugin}" requires ${words(manifest)} in its manifest, and ${words(pkg)} in package.json's ` +
+        'buddi.requires; the install card was drawn from the second, so the two must match');
+}
+/** Why a manifest's `exports` cannot register, or undefined. */
+export function exportsProblem(plugin, value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return `plugin ${plugin}: exports is not a map of names to queries`;
+    for (const [name, entry] of Object.entries(value)) {
+        if (!EXPORT_NAME.test(name))
+            return `plugin ${plugin}: export ${JSON.stringify(name)} is not a name (letters, digits and _, starting with a letter)`;
+        const e = entry;
+        if (!e || typeof e.produce !== 'function' || typeof e.params?.safeParse !== 'function') {
+            return `plugin ${plugin}: export ${name} needs a zod \`params\` and a \`produce\``;
+        }
+    }
+    return undefined;
+}
+/**
+ * A readiness answer made sound: `ready` a boolean, the note one short line,
+ * the page one of the plugin's own. Undefined when it is not an answer.
+ */
+export function readinessOf(raw, pages) {
+    const r = raw;
+    if (!r || typeof r !== 'object' || typeof r.ready !== 'boolean')
+        return undefined;
+    const note = typeof r.note === 'string' ? r.note.replace(/\s+/g, ' ').trim() : '';
+    return {
+        ready: r.ready,
+        ...(note === '' ? {} : { note: note.length > READINESS_NOTE_MAX ? `${note.slice(0, READINESS_NOTE_MAX - 1)}…` : note }),
+        ...(typeof r.page === 'string' && pages.includes(r.page) ? { page: r.page } : {}),
+    };
+}
+//# sourceMappingURL=requires.js.map

package/packages/core/dist/plugin/requires.js.map

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

package/packages/core/dist/plugin/uses.d.ts

@@ -11,7 +11,7 @@
  * Pure: names, the owner's words for each, and the comparisons.
  */
 /** Every area a plugin may declare. `files:library` is `files`, over the whole library. */
-export declare const PLUGIN_USES: readonly ["http", "accounts", "files", "files:library", "memory", "proposals", "schedule", "secrets", "owner:notify", "owner:channel"];
+export declare const PLUGIN_USES: readonly ["http", "accounts", "files", "files:library", "memory", "proposals", "schedule", "secrets", "owner:notify", "owner:channel", "owner:places"];
 export type PluginUse = (typeof PLUGIN_USES)[number];
 /**
  * The line the owner reads on the install card for each area, in the spec's

package/packages/core/dist/plugin/uses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uses.d.ts","sourceRoot":"","sources":["../../src/plugin/uses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,WAAW,wIAWd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAWhE,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiBlE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,KAAK,EAAE,SAAS,SAAS,EAAE,GAC1B;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAK9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,GAAG,EAAE,SAAS,SAAS,EAAE,GACxB,MAAM,GAAG,SAAS,CAQpB"}
+{"version":3,"file":"uses.d.ts","sourceRoot":"","sources":["../../src/plugin/uses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,WAAW,wJAYd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAYhE,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiBlE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,KAAK,EAAE,SAAS,SAAS,EAAE,GAC1B;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAK9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,GAAG,EAAE,SAAS,SAAS,EAAE,GACxB,MAAM,GAAG,SAAS,CAQpB"}

package/packages/core/dist/plugin/uses.js

@@ -22,6 +22,7 @@ export const PLUGIN_USES = [
     'secrets',
     'owner:notify',
     'owner:channel',
+    'owner:places',
 ];
 /**
  * The line the owner reads on the install card for each area, in the spec's
@@ -39,6 +40,7 @@ export const PLUGIN_USE_WORDS = {
     secrets: 'fills secrets you bind to it',
     'owner:notify': 'can send you messages when you are away',
     'owner:channel': 'adds a way for buddi to reach you',
+    'owner:places': 'reads your places (Home, Work…) and their addresses',
 };
 export function isPluginUse(value) {
     return typeof value === 'string' && PLUGIN_USES.includes(value);

package/packages/core/dist/plugin/uses.js.map

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

package/packages/core/dist/plugin/version.d.ts

@@ -8,7 +8,7 @@
  * than this buddi has is refused when it is staged, before anything of it runs.
  */
 /** What this build's `ctx.buddi.version` says. */
-export declare const HOST_API_VERSION = "1.16";
+export declare const HOST_API_VERSION = "1.21";
 /**
  * Why a plugin asking for `range` cannot run on a host at `have`, or undefined
  * when it can.

package/packages/core/dist/plugin/version.js

@@ -8,7 +8,7 @@
  * than this buddi has is refused when it is staged, before anything of it runs.
  */
 /** What this build's `ctx.buddi.version` says. */
-export const HOST_API_VERSION = '1.16';
+export const HOST_API_VERSION = '1.21';
 function parseVersion(text) {
     const match = /^(\d+)(?:\.(\d+))?(?:\.\d+)?$/.exec(text.trim());
     if (match === null)

package/packages/core/dist/queue/retry-policy.d.ts

@@ -121,6 +121,11 @@ export interface RetryDecision {
     /** One line, for the failure event and the owner-facing message. */
     reason: string;
 }
+/**
+ * How long the provider asked to wait, from the error's `retryAt` (a 429's
+ * window, or a spent daily quota's reset). Undefined when it named none.
+ */
+export declare function hintedWaitMs(err: unknown, now: Date): number | undefined;
 /**
  * Should this failed attempt be tried again, and when?
  *

package/packages/core/dist/queue/retry-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../src/queue/retry-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAIH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIzD;AAoGD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAkD5D;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,YAKvC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,YAKtC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAiC,CAAC;AAEpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAE1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKjF;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,EAAE,IAAI,CAAC;IACV,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CA+BpE"}
+{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../src/queue/retry-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAIH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIzD;AAoGD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAkD5D;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,YAKvC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,YAKtC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAiC,CAAC;AAEpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAE1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKjF;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,EAAE,IAAI,CAAC;IACV,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAKxE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAqCpE"}