@agent-native/toolkit 0.23.1 → 0.198.2

package/dist/app/settings/shell/registry.js

@@ -0,0 +1,80 @@
+/** Nav groups, top to bottom. */
+export const SETTINGS_PAGE_GROUPS = [
+    "account",
+    "app",
+    "connections",
+    "agent",
+    "organization",
+];
+// Page ids live with the redirect table so server code (the agent's
+// `open-settings-page`, template `navigate` actions) can name them too.
+export { SETTINGS_PAGE_IDS, } from "@agent-native/core/navigation/settings-redirects";
+/** Settings opens here unless a link names a page (spec §3.2). */
+export const DEFAULT_SETTINGS_PAGE_ID = "profile";
+const PAGE_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export function defineSettingsPage(definition) {
+    if (!PAGE_ID_PATTERN.test(definition.id)) {
+        throw new Error(`Settings page ids are lowercase and hyphenated: ${definition.id}`);
+    }
+    if (!definition.labelKey && !definition.label) {
+        throw new Error(`Settings page ${definition.id} needs a labelKey or label`);
+    }
+    return Object.freeze({ ...definition });
+}
+const registry = new Map();
+const listeners = new Set();
+let snapshot = [];
+function publish() {
+    snapshot = Object.freeze([...registry.values()]);
+    for (const listener of listeners)
+        listener();
+}
+/**
+ * Register pages with the shell. Registering an id again replaces it, which
+ * is how a page task swaps its bridged placeholder for the finished page and
+ * how HMR reloads stay idempotent.
+ */
+export function registerSettingsPages(definitions) {
+    for (const definition of definitions) {
+        registry.set(definition.id, defineSettingsPage(definition));
+    }
+    publish();
+}
+export function unregisterSettingsPage(id) {
+    if (registry.delete(id))
+        publish();
+}
+export function getSettingsPages() {
+    return snapshot;
+}
+export function subscribeSettingsPages(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+export function isSettingsPageVisible(page, context, bridge) {
+    return page.visible ? page.visible(context, bridge) : true;
+}
+/**
+ * Organization pages owners and admins manage. A viewer with no organization
+ * sees them only on a single-tenant self-hosted deployment, matching the
+ * actions behind them; on a shared deployment anyone who signs up starts with
+ * no organization.
+ */
+export function canManageOrganizationPages(context) {
+    return (context.isAdmin ||
+        (context.hasOrganization === false && context.soloDeploymentAdmin));
+}
+export function sortSettingsPages(pages) {
+    const groupIndex = new Map(SETTINGS_PAGE_GROUPS.map((group, index) => [group, index]));
+    return [...pages].sort((a, b) => (groupIndex.get(a.group) ?? 0) - (groupIndex.get(b.group) ?? 0) ||
+        a.order - b.order ||
+        a.id.localeCompare(b.id));
+}
+/** Test-only reset; not exported from the package entry. */
+export function _resetSettingsPagesForTests() {
+    registry.clear();
+    publish();
+}
+//# sourceMappingURL=registry.js.map

package/dist/app/settings/shell/registry.js.map

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

package/dist/app/settings/shell/return-path.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Remember the app route the viewer is on so Settings' "Back to {App}" can
+ * return there. Router-relative paths only; Settings routes are ignored.
+ */
+export declare function rememberSettingsReturnPath(pathname: string, search?: string): void;
+/** The last app route, or `null` when none was recorded (Back then goes home). */
+export declare function readSettingsReturnPath(): string | null;
+/** Test-only reset. */
+export declare function _resetSettingsReturnPathForTests(): void;
+//# sourceMappingURL=return-path.d.ts.map

package/dist/app/settings/shell/return-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-path.d.ts","sourceRoot":"","sources":["../../../../src/app/settings/shell/return-path.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAK,GACV,IAAI,CAUN;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAYtD;AAED,uBAAuB;AACvB,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/dist/app/settings/shell/return-path.js

@@ -0,0 +1,45 @@
+import { STANDARD_APP_ROUTES } from "@agent-native/core/navigation";
+const RETURN_PATH_KEY = "agent-native:settings-return-path";
+const SETTINGS_PREFIX = STANDARD_APP_ROUTES.settings;
+let memoryReturnPath = null;
+function isSettingsRoute(pathname) {
+    return (pathname === SETTINGS_PREFIX || pathname.startsWith(`${SETTINGS_PREFIX}/`));
+}
+/**
+ * Remember the app route the viewer is on so Settings' "Back to {App}" can
+ * return there. Router-relative paths only; Settings routes are ignored.
+ */
+export function rememberSettingsReturnPath(pathname, search = "") {
+    if (!pathname.startsWith("/") || isSettingsRoute(pathname))
+        return;
+    const path = `${pathname}${search}`;
+    memoryReturnPath = path;
+    try {
+        window.sessionStorage.setItem(RETURN_PATH_KEY, path);
+    }
+    catch {
+        // coercion-ok: the in-memory copy still serves this document; storage only
+        // carries the path across a reload.
+    }
+}
+/** The last app route, or `null` when none was recorded (Back then goes home). */
+export function readSettingsReturnPath() {
+    if (memoryReturnPath)
+        return memoryReturnPath;
+    try {
+        const stored = window.sessionStorage.getItem(RETURN_PATH_KEY);
+        return stored && stored.startsWith("/") && !isSettingsRoute(stored)
+            ? stored
+            : null;
+    }
+    catch {
+        // coercion-ok: unreadable storage is the same as nothing recorded; Back
+        // falls back to the app's home.
+        return null;
+    }
+}
+/** Test-only reset. */
+export function _resetSettingsReturnPathForTests() {
+    memoryReturnPath = null;
+}
+//# sourceMappingURL=return-path.js.map

package/dist/app/settings/shell/return-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-path.js","sourceRoot":"","sources":["../../../../src/app/settings/shell/return-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,eAAe,GAAG,mCAAmC,CAAC;AAC5D,MAAM,eAAe,GAAG,mBAAmB,CAAC,QAAQ,CAAC;AAErD,IAAI,gBAAgB,GAAkB,IAAI,CAAC;AAE3C,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,CACL,QAAQ,KAAK,eAAe,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,eAAe,GAAG,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAgB,EAChB,MAAM,GAAG,EAAE;IAEX,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC;QAAE,OAAO;IACnE,MAAM,IAAI,GAAG,GAAG,QAAQ,GAAG,MAAM,EAAE,CAAC;IACpC,gBAAgB,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,oCAAoC;IACtC,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,sBAAsB;IACpC,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9D,OAAO,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;YACjE,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,gCAAgC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,gCAAgC;IAC9C,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC"}

package/dist/app/settings/shell/routing.d.ts

@@ -0,0 +1,62 @@
+import type { SettingsPageDefinition } from "./registry.js";
+export interface SettingsLocation {
+    pathname: string;
+    hash: string;
+    /** The query string. `?section=` names a template tab (Mail, Brain). */
+    search?: string;
+    /** An `agent-panel:open-settings` section carried in history state. */
+    section?: string | null;
+}
+export interface SettingsRoute {
+    page: string | null;
+    sub: string | null;
+}
+export interface ResolvedSettingsRoute extends SettingsRoute {
+    /** In-page target to scroll to: a row or group id, a section id, or `secrets:KEY`. */
+    anchor: string | null;
+    /**
+     * The URL named the page through a legacy form, so the shell replaces it
+     * with the page's own path (keeping the query).
+     */
+    legacy: boolean;
+}
+export interface ResolveSettingsRouteOptions {
+    /** Tabs on the app's General page, routed `/settings/app/<id>`. */
+    appAreaIds?: readonly string[];
+    /**
+     * The tab a controlled template chose. A bare `/settings` opens it, which
+     * covers the moment between a template stripping `?section=` from the URL
+     * and the shell navigating to the page it named.
+     */
+    tabValue?: string | null;
+}
+/**
+ * `history.state` key for the section an `agent-panel:open-settings` request
+ * named. Today's Settings reads only the hash it navigates to; the shell reads
+ * this first because that hash can't tell API keys from Integrations.
+ */
+export declare const SETTINGS_SECTION_STATE_KEY = "agentNativeSettingsSection";
+/** Strips a workspace mount (`/dispatch/settings/…` → `/settings/…`). */
+export declare function settingsLocalPathname(pathname: string): string;
+export declare function isSettingsPathname(pathname: string): boolean;
+export declare function settingsPathSegments(pathname: string): string[];
+/** `/settings/:page` or `/settings/:page/:sub`. */
+export declare function settingsPagePath(page: string, sub?: string | null): string;
+/** The browser URL for a page, keeping a workspace mount prefix. */
+export declare function settingsPageHref(page: string, sub?: string | null): string;
+/** The `?section=` a Mail or Brain deep link carries, if any. */
+export declare function settingsSectionParam(search: string | undefined): string;
+/**
+ * The page a template's tab id opens. The template's own tabs win, because
+ * its id space is its own: Mail's inbox `automations` tab is not the core
+ * Automations page.
+ */
+export declare function resolveSettingsTabValue(value: string, pages: readonly SettingsPageDefinition[], appAreaIds?: readonly string[]): ResolvedSettingsRoute;
+/**
+ * Which page a Settings URL names, through the legacy redirect table
+ * (`settings-redirects.ts`) when it isn't a page's own path. `legacy` routes
+ * are rewritten by the shell; an unknown id comes back as named so the shell
+ * can send it to Profile.
+ */
+export declare function resolveSettingsRoute(location: SettingsLocation, pages: readonly SettingsPageDefinition[], options?: ResolveSettingsRouteOptions): ResolvedSettingsRoute;
+//# sourceMappingURL=routing.d.ts.map

package/dist/app/settings/shell/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../../src/app/settings/shell/routing.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,sFAAsF;IACtF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,mEAAmE;IACnE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAWvE,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG5D;AAWD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ/D;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE1E;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE1E;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGvE;AAyCD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,sBAAsB,EAAE,EACxC,UAAU,GAAE,SAAS,MAAM,EAAO,GACjC,qBAAqB,CAqBvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,SAAS,sBAAsB,EAAE,EACxC,OAAO,GAAE,2BAAgC,GACxC,qBAAqB,CAyEvB"}

package/dist/app/settings/shell/routing.js

@@ -0,0 +1,190 @@
+import { appMountedPath, appMountPath, } from "@agent-native/core/client/api-path";
+import { buildSettingsRoute, STANDARD_APP_ROUTES, } from "@agent-native/core/navigation";
+import { isCoreSettingsPageId, resolveLegacySettingsId, resolveSettingsIdPattern, resolveSettingsSectionRedirect, } from "@agent-native/core/navigation/settings-redirects";
+/**
+ * `history.state` key for the section an `agent-panel:open-settings` request
+ * named. Today's Settings reads only the hash it navigates to; the shell reads
+ * this first because that hash can't tell API keys from Integrations.
+ */
+export const SETTINGS_SECTION_STATE_KEY = "agentNativeSettingsSection";
+const SETTINGS_PREFIX = STANDARD_APP_ROUTES.settings;
+const NO_ROUTE = {
+    page: null,
+    sub: null,
+    anchor: null,
+    legacy: false,
+};
+/** Strips a workspace mount (`/dispatch/settings/…` → `/settings/…`). */
+export function settingsLocalPathname(pathname) {
+    const mountPath = appMountPath(SETTINGS_PREFIX);
+    if (mountPath &&
+        (pathname === mountPath || pathname.startsWith(`${mountPath}/`))) {
+        return pathname.slice(mountPath.length) || "/";
+    }
+    return pathname;
+}
+export function isSettingsPathname(pathname) {
+    const local = settingsLocalPathname(pathname);
+    return local === SETTINGS_PREFIX || local.startsWith(`${SETTINGS_PREFIX}/`);
+}
+function decodeSegment(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        // coercion-ok: a malformed external segment still routes by its raw text.
+        return segment;
+    }
+}
+export function settingsPathSegments(pathname) {
+    const local = settingsLocalPathname(pathname);
+    if (!local.startsWith(`${SETTINGS_PREFIX}/`))
+        return [];
+    return local
+        .slice(SETTINGS_PREFIX.length + 1)
+        .split("/")
+        .filter(Boolean)
+        .map(decodeSegment);
+}
+/** `/settings/:page` or `/settings/:page/:sub`. */
+export function settingsPagePath(page, sub) {
+    return buildSettingsRoute(page, sub ?? null);
+}
+/** The browser URL for a page, keeping a workspace mount prefix. */
+export function settingsPageHref(page, sub) {
+    return appMountedPath(settingsPagePath(page, sub), SETTINGS_PREFIX);
+}
+/** The `?section=` a Mail or Brain deep link carries, if any. */
+export function settingsSectionParam(search) {
+    if (!search)
+        return "";
+    return new URLSearchParams(search).get("section")?.trim() ?? "";
+}
+function redirectRoute(redirect, pages, fallbackAnchor) {
+    const exists = (id) => pages.some((page) => page.id === id);
+    const page = !exists(redirect.page) &&
+        redirect.fallbackPage &&
+        exists(redirect.fallbackPage)
+        ? redirect.fallbackPage
+        : redirect.page;
+    return {
+        page,
+        sub: page === redirect.page ? (redirect.sub ?? null) : null,
+        anchor: redirect.anchor ?? fallbackAnchor,
+        legacy: true,
+    };
+}
+/** Pages a template contributed (its own tabs), which own their tab ids. */
+function isAppPage(page) {
+    return !isCoreSettingsPageId(page.id);
+}
+function pageForTabIds(ids, pages) {
+    for (let length = ids.length; length > 0; length -= 1) {
+        const id = ids.slice(0, length).join(":");
+        const page = pages.find((candidate) => candidate.legacyTabIds?.includes(id));
+        if (page)
+            return page;
+    }
+    return undefined;
+}
+/**
+ * The page a template's tab id opens. The template's own tabs win, because
+ * its id space is its own: Mail's inbox `automations` tab is not the core
+ * Automations page.
+ */
+export function resolveSettingsTabValue(value, pages, appAreaIds = []) {
+    const tab = value.trim();
+    if (!tab)
+        return NO_ROUTE;
+    const appPage = pages.find((page) => isAppPage(page) && (page.id === tab || page.legacyTabIds?.includes(tab)));
+    if (appPage) {
+        return { page: appPage.id, sub: null, anchor: null, legacy: true };
+    }
+    if (appAreaIds.includes(tab)) {
+        return { page: "app", sub: tab, anchor: null, legacy: true };
+    }
+    const redirect = resolveLegacySettingsId(tab, "tab");
+    if (redirect)
+        return redirectRoute(redirect, pages, null);
+    const page = pages.find((candidate) => candidate.id === tab) ??
+        pageForTabIds(tab.split(":"), pages);
+    return page
+        ? { page: page.id, sub: null, anchor: null, legacy: true }
+        : NO_ROUTE;
+}
+/**
+ * Which page a Settings URL names, through the legacy redirect table
+ * (`settings-redirects.ts`) when it isn't a page's own path. `legacy` routes
+ * are rewritten by the shell; an unknown id comes back as named so the shell
+ * can send it to Profile.
+ */
+export function resolveSettingsRoute(location, pages, options = {}) {
+    const segments = settingsPathSegments(location.pathname);
+    const hash = decodeSegment(location.hash.replace(/^#/, ""));
+    if (segments.length > 0) {
+        const joined = segments.join(":");
+        const pageId = segments[0];
+        if (pages.some((page) => page.id === pageId)) {
+            const pattern = segments.length > 1 && resolveSettingsIdPattern(joined);
+            if (pattern)
+                return redirectRoute(pattern, pages, hash || null);
+            return {
+                page: pageId,
+                sub: segments[1] ?? null,
+                anchor: hash || null,
+                legacy: segments.length > 2,
+            };
+        }
+        // Today's tab link to an area that moved onto the app's General page
+        // (`/settings/alerts`). Checked before the redirect table, like
+        // `resolveSettingsTabValue`, because the area id is the template's own.
+        if (options.appAreaIds?.includes(pageId)) {
+            return { page: "app", sub: pageId, anchor: hash || null, legacy: true };
+        }
+        const redirect = resolveLegacySettingsId(joined, "tab");
+        if (redirect)
+            return redirectRoute(redirect, pages, hash || null);
+        const tabPage = pageForTabIds(segments, pages);
+        if (tabPage) {
+            return {
+                page: tabPage.id,
+                sub: null,
+                anchor: hash || null,
+                legacy: true,
+            };
+        }
+        return {
+            page: pageId,
+            sub: segments[1] ?? null,
+            anchor: null,
+            legacy: false,
+        };
+    }
+    if (location.section) {
+        return redirectRoute(resolveSettingsSectionRedirect(location.section, hash), pages, null);
+    }
+    if (hash) {
+        const redirect = resolveLegacySettingsId(hash, "section");
+        if (redirect)
+            return redirectRoute(redirect, pages, null);
+        const page = pages.find((candidate) => candidate.id === hash) ??
+            pageForTabIds(hash.split(":"), pages);
+        if (page)
+            return { page: page.id, sub: null, anchor: null, legacy: true };
+        const owner = pages.find((candidate) => candidate.searchEntries?.some((entry) => entry.anchor === hash || entry.id === hash));
+        if (owner) {
+            return { page: owner.id, sub: null, anchor: hash, legacy: true };
+        }
+    }
+    const section = settingsSectionParam(location.search);
+    if (section) {
+        const route = resolveSettingsTabValue(section, pages, options.appAreaIds);
+        if (route.page)
+            return route;
+    }
+    if (options.tabValue) {
+        return resolveSettingsTabValue(options.tabValue, pages, options.appAreaIds);
+    }
+    return NO_ROUTE;
+}
+//# sourceMappingURL=routing.js.map

package/dist/app/settings/shell/routing.js.map

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

package/dist/app/settings/shell/search.d.ts

@@ -0,0 +1,26 @@
+import type { SettingsPageDefinition, SettingsPageIcon, SettingsPageSearchEntry } from "./registry.js";
+export interface SettingsSearchResult {
+    id: string;
+    label: string;
+    /** "Group › Page", or the group alone for a page result. */
+    where: string;
+    page: string;
+    sub: string | null;
+    anchor: string | null;
+    icon: SettingsPageIcon;
+    haystack: string;
+}
+export interface SettingsSearchPage {
+    page: SettingsPageDefinition;
+    label: string;
+    groupLabel: string;
+    entries: readonly SettingsPageSearchEntry[];
+}
+/**
+ * The index is built from page declarations, never by rendering pages, so a
+ * result exists for a page the viewer has not opened yet. Only pass pages the
+ * viewer can see.
+ */
+export declare function buildSettingsSearchIndex(pages: readonly SettingsSearchPage[], translate: (key: string) => string): SettingsSearchResult[];
+export declare function searchSettings(index: readonly SettingsSearchResult[], query: string): SettingsSearchResult[];
+//# sourceMappingURL=search.d.ts.map

package/dist/app/settings/shell/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/app/settings/shell/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,kBAAkB,EAAE,EACpC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GACjC,oBAAoB,EAAE,CAgDxB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,oBAAoB,EAAE,EACtC,KAAK,EAAE,MAAM,GACZ,oBAAoB,EAAE,CAWxB"}

package/dist/app/settings/shell/search.js

@@ -0,0 +1,65 @@
+/**
+ * The index is built from page declarations, never by rendering pages, so a
+ * result exists for a page the viewer has not opened yet. Only pass pages the
+ * viewer can see.
+ */
+export function buildSettingsSearchIndex(pages, translate) {
+    const results = [];
+    const seen = new Set();
+    for (const { page, label, groupLabel, entries } of pages) {
+        const pageWhere = groupLabel ? `${groupLabel} › ${label}` : label;
+        const pageResultId = `page:${page.id}`;
+        seen.add(pageResultId);
+        results.push({
+            id: pageResultId,
+            label,
+            where: groupLabel || label,
+            page: page.id,
+            sub: null,
+            anchor: null,
+            icon: page.icon,
+            haystack: `${label} ${groupLabel} ${page.keywords ?? ""}`.toLowerCase(),
+        });
+        // Today's tabs often repeat their own name, or a row the page declares, as
+        // a section entry; the first result with that name on the page covers it.
+        const pageLabels = new Set([label.toLowerCase()]);
+        for (const entry of entries) {
+            const entryLabel = entry.labelKey
+                ? translate(entry.labelKey)
+                : (entry.label ?? "");
+            const id = `${page.id}:${entry.id}`;
+            if (!entryLabel ||
+                seen.has(id) ||
+                pageLabels.has(entryLabel.toLowerCase())) {
+                continue;
+            }
+            seen.add(id);
+            pageLabels.add(entryLabel.toLowerCase());
+            results.push({
+                id,
+                label: entryLabel,
+                where: pageWhere,
+                page: page.id,
+                sub: entry.sub ?? null,
+                anchor: entry.anchor ?? null,
+                icon: page.icon,
+                haystack: `${entryLabel} ${entry.keywords ?? ""} ${pageWhere}`.toLowerCase(),
+            });
+        }
+    }
+    return results;
+}
+export function searchSettings(index, query) {
+    const trimmed = query.trim().toLowerCase();
+    if (!trimmed)
+        return [];
+    const terms = trimmed.split(/\s+/).filter(Boolean);
+    return index
+        .filter((entry) => terms.every((term) => entry.haystack.includes(term)))
+        .sort((a, b) => {
+        const aStarts = a.label.toLowerCase().startsWith(trimmed) ? 0 : 1;
+        const bStarts = b.label.toLowerCase().startsWith(trimmed) ? 0 : 1;
+        return aStarts - bStarts || a.label.localeCompare(b.label);
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/app/settings/shell/search.js.map

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

package/dist/app/settings/usage/UsageAlerts.d.ts

@@ -0,0 +1,11 @@
+import { useFormatters, useT } from "@agent-native/core/client/i18n";
+type AlertUnit = "usd" | "builder-credits" | "tokens";
+type Translation = ReturnType<typeof useT>;
+type Formatters = ReturnType<typeof useFormatters>;
+export declare function formatAlertValue(t: Translation, format: Formatters, unit: AlertUnit, value: number): string;
+/** Your alert rules across every app, each edited in a dialog. */
+export declare function UsageAlertsGroup({ appName, }: {
+    appName: (key: string) => string;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=UsageAlerts.d.ts.map

package/dist/app/settings/usage/UsageAlerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageAlerts.d.ts","sourceRoot":"","sources":["../../../../src/app/settings/usage/UsageAlerts.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AAwBrE,KAAK,SAAS,GAAG,KAAK,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAmCtD,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AAC3C,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AAkBnD,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,WAAW,EACd,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,GACZ,MAAM,CAmBR;AAiCD,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,GACR,EAAE;IACD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAClC,+BAyGA"}