@agent-native/core 0.178.1 → 0.178.2-nightly-20260910195009

package/dist/client/index.js

@@ -13,6 +13,7 @@ export * from "./ui/index.js";
 export { cn } from "@agent-native/toolkit/utils";
 export { AgentNativeI18nProvider, LanguagePicker, getLocaleInitScript, isLocaleCode, isValidLocaleCode, localeDirection, localeMetadataFor, normalizeLocaleCode, normalizeLocalePreference, normalizeLocalizationPreference, resolveLocaleFromCandidates, resolveLocaleFromPreference, useFormatters, useLocale, useT, DEFAULT_LOCALE, LOCALE_HYDRATION_GLOBAL, LOCALE_METADATA, LOCALE_STORAGE_KEY, SUPPORTED_LOCALES, } from "./i18n.js";
 export { AgentNativeIcon } from "./components/icons/AgentNativeIcon.js";
+export { AppSidebar, AppSidebarHeader, AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, AppSidebarFooter, useAppSidebar, } from "./ui/AppSidebar.js";
 export { FeatureFlagsEditor, evaluatedFeatureFlagValues, featureFlagValue, useFeatureFlag, useFeatureFlags, } from "./feature-flags/index.js";
 export { ExperimentsSettings, useExperiment, useExperimentState, useExperiments, } from "./experiments/index.js";
 export { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";

package/dist/client/ui/AppSidebar.d.ts

@@ -0,0 +1,15 @@
+import { type AppSidebarProps as ToolkitAppSidebarProps, type AppSidebarHeaderProps as ToolkitAppSidebarHeaderProps, type AppSidebarFooterProps as ToolkitAppSidebarFooterProps } from "@agent-native/toolkit/app-shell";
+export interface AppSidebarHeaderProps extends ToolkitAppSidebarHeaderProps {
+    badgeText?: string;
+    showBadge?: boolean;
+}
+export declare const AppSidebarHeader: import("react").ForwardRefExoticComponent<AppSidebarHeaderProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AppSidebarFooterProps extends ToolkitAppSidebarFooterProps {
+}
+export declare const AppSidebarFooter: import("react").ForwardRefExoticComponent<AppSidebarFooterProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AppSidebarProps extends ToolkitAppSidebarProps {
+    badgeText?: string;
+    showBadge?: boolean;
+}
+export declare const AppSidebar: import("react").ForwardRefExoticComponent<AppSidebarProps & import("react").RefAttributes<HTMLElement>>;
+export { AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, useAppSidebar, type AppSidebarNavItemProps, type AppSidebarNavGroupProps, type AppSidebarSectionProps, type AppSidebarFeedbackButtonProps, type AppSidebarItemDefinition, type AppSidebarContextValue, type AppSidebarLinkComponent, } from "@agent-native/toolkit/app-shell";

package/dist/client/ui/AppSidebar.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AppSidebar as ToolkitAppSidebar, AppSidebarHeader as ToolkitAppSidebarHeader, AppSidebarFooter as ToolkitAppSidebarFooter, useAppSidebar, } from "@agent-native/toolkit/app-shell";
+import { forwardRef } from "react";
+import { Link } from "react-router";
+import { AgentNativeIcon } from "../components/icons/AgentNativeIcon.js";
+import { EnvironmentBadge } from "../EnvironmentBadge.js";
+import { FeedbackButton } from "../FeedbackButton.js";
+function RouterSidebarLink({ to, href, className, onClick, children, "aria-label": ariaLabel, }) {
+    return (_jsx(Link, { to: to ?? href ?? "/", className: className, onClick: onClick, "aria-label": ariaLabel, children: children }));
+}
+export const AppSidebarHeader = forwardRef(({ brandIcon, badge, badgeText, showBadge = true, brandLink, brandHref = "/", ...props }, ref) => {
+    const resolvedBrandIcon = brandIcon ?? (_jsx(AgentNativeIcon, { "aria-hidden": "true", className: "h-3.5 w-6 shrink-0 text-primary" }));
+    const resolvedBadge = badge ??
+        (showBadge ? (_jsx(EnvironmentBadge, { placement: "inline", badgeText: badgeText })) : undefined);
+    return (_jsx(ToolkitAppSidebarHeader, { ref: ref, brandIcon: resolvedBrandIcon, badge: resolvedBadge, brandHref: brandHref, ...props }));
+});
+AppSidebarHeader.displayName = "AppSidebarHeader";
+export const AppSidebarFooter = forwardRef(({ feedback, collapsed: propCollapsed, ...props }, ref) => {
+    const context = useAppSidebar();
+    const collapsed = propCollapsed ?? context.collapsed;
+    const resolvedFeedback = feedback !== undefined ? (feedback) : (_jsx(FeedbackButton, { variant: collapsed ? "icon" : "sidebar", side: "right" }));
+    return (_jsx(ToolkitAppSidebarFooter, { ref: ref, collapsed: collapsed, feedback: resolvedFeedback, ...props }));
+});
+AppSidebarFooter.displayName = "AppSidebarFooter";
+export const AppSidebar = forwardRef(({ brandIcon, badge, badgeText, showBadge = true, linkComponent, ...props }, ref) => {
+    const resolvedBrandIcon = brandIcon ?? (_jsx(AgentNativeIcon, { "aria-hidden": "true", className: "h-3.5 w-6 shrink-0 text-primary" }));
+    const resolvedBadge = badge ??
+        (showBadge ? (_jsx(EnvironmentBadge, { placement: "inline", badgeText: badgeText })) : undefined);
+    const resolvedLinkComponent = linkComponent ?? RouterSidebarLink;
+    const resolvedFeedback = props.feedback !== undefined ? (props.feedback) : (_jsx(FeedbackButton, { variant: props.collapsed ? "icon" : "sidebar" }));
+    return (_jsx(ToolkitAppSidebar, { ref: ref, brandIcon: resolvedBrandIcon, badge: resolvedBadge, linkComponent: resolvedLinkComponent, ...props, feedback: resolvedFeedback }));
+});
+AppSidebar.displayName = "AppSidebar";
+export { AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, useAppSidebar, } from "@agent-native/toolkit/app-shell";

package/dist/client/ui/index.d.ts

@@ -19,3 +19,4 @@ export { applyEmbeddedThemeUpdate, buildEmbeddedThemeUpdate, EMBEDDED_THEME_CHAN
 export { APPEARANCE_PRESETS, applyAppearance, getStoredAppearance, useAppearance, useAppearanceSync, type AppearancePresetId, } from "../appearance.js";
 export { AppearancePicker, type AppearancePickerProps, } from "../AppearancePicker.js";
 export { AgentNativeIcon } from "../components/icons/AgentNativeIcon.js";
+export { AppSidebar, AppSidebarHeader, AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, AppSidebarFooter, useAppSidebar, type AppSidebarProps, type AppSidebarHeaderProps, type AppSidebarNavItemProps, type AppSidebarNavGroupProps, type AppSidebarSectionProps, type AppSidebarFeedbackButtonProps, type AppSidebarFooterProps, type AppSidebarItemDefinition, type AppSidebarContextValue, } from "./AppSidebar.js";

package/dist/client/ui/index.js

@@ -19,3 +19,4 @@ export { applyEmbeddedThemeUpdate, buildEmbeddedThemeUpdate, EMBEDDED_THEME_CHAN
 export { APPEARANCE_PRESETS, applyAppearance, getStoredAppearance, useAppearance, useAppearanceSync, } from "../appearance.js";
 export { AppearancePicker, } from "../AppearancePicker.js";
 export { AgentNativeIcon } from "../components/icons/AgentNativeIcon.js";
+export { AppSidebar, AppSidebarHeader, AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, AppSidebarFooter, useAppSidebar, } from "./AppSidebar.js";

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
-    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
+    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
-    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
+    error?: undefined;
 }>>;

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/config.d.ts

@@ -42,6 +42,8 @@ export type AgentNativeDeploymentEnvironment = "local" | "beta" | "production" |
 export interface AgentNativeDeploymentConfig {
     /** The release lane that produced the currently running client bundle. */
     environment?: AgentNativeDeploymentEnvironment;
+    /** Badge text override shown in the top-left sidebar header badge (e.g. "alpha" or "beta"). Defaults to "alpha". */
+    badgeText?: string;
 }
 export interface AgentNativeDiagnosticsConfig {
     /** Fail a production Vite build when runtime configuration has issues. */
@@ -79,6 +81,8 @@ export interface AgentNativeConfig {
     onboarding?: AgentNativeOnboardingConfig;
     runtime?: AgentNativeRuntimeConfig;
     deployment?: AgentNativeDeploymentConfig;
+    /** Badge text override shown in the top-left sidebar header badge (e.g. "alpha" or "beta"). Defaults to "alpha". */
+    badgeText?: string;
     diagnostics?: AgentNativeDiagnosticsConfig;
     instructions?: AgentNativeInstructionsConfig;
     translations?: AgentNativeTranslationsConfig;

package/dist/config.js

@@ -275,6 +275,7 @@ export function normalizeAgentNativeConfig(input, source = "agent-native config"
     const onboardingValue = input.onboarding;
     const runtimeValue = input.runtime;
     const deploymentValue = input.deployment;
+    const badgeTextValue = input.badgeText;
     const diagnosticsValue = input.diagnostics;
     const instructionsValue = input.instructions;
     const translationsValue = input.translations;
@@ -285,6 +286,12 @@ export function normalizeAgentNativeConfig(input, source = "agent-native config"
             ? {}
             : { version: AGENT_NATIVE_CONFIG_VERSION }),
     };
+    if (badgeTextValue !== undefined) {
+        if (typeof badgeTextValue !== "string") {
+            throw new Error(`${source}.badgeText must be a string`);
+        }
+        normalized.badgeText = badgeTextValue;
+    }
     if (onboardingValue !== undefined) {
         if (!isRecord(onboardingValue)) {
             throw new Error(`${source}.onboarding must be an object`);
@@ -360,6 +367,7 @@ export function mergeAgentNativeConfigs(base, override, options = {}) {
                 ...override.deployment,
             }
             : undefined,
+        badgeText: override.badgeText ?? base.badgeText,
         diagnostics: base.diagnostics || override.diagnostics
             ? {
                 ...base.diagnostics,
@@ -469,12 +477,20 @@ function normalizeDeploymentConfig(value, source) {
         throw new Error(`${source} must be an object`);
     }
     const environment = value.environment;
-    if (environment === undefined)
-        return {};
+    const badgeText = value.badgeText;
+    if (badgeText !== undefined && typeof badgeText !== "string") {
+        throw new Error(`${source}.badgeText must be a string`);
+    }
+    if (environment === undefined) {
+        return badgeText === undefined ? {} : { badgeText };
+    }
     if (!isAgentNativeDeploymentEnvironment(environment)) {
         throw new Error(`${source}.environment must be "local", "beta", "production", or "preview"`);
     }
-    return { environment };
+    return {
+        environment,
+        ...(badgeText === undefined ? {} : { badgeText }),
+    };
 }
 function normalizeDiagnosticsConfig(value, source) {
     if (!isRecord(value)) {

package/dist/progress/routes.d.ts

@@ -15,6 +15,6 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -76,9 +76,7 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     }>>;
 }, z.core.$strip>>, {
     id?: undefined;
-    message?: undefined;
     deleted?: undefined;
-    provider?: undefined;
     providers: {
         id: string;
         label: string;
@@ -89,44 +87,46 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         updatedAt: number;
     }[];
     count: number;
+    provider?: undefined;
     found?: undefined;
     registered?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
     id?: undefined;
-    message?: undefined;
     deleted?: undefined;
-    count?: undefined;
     providers?: undefined;
+    count?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
     registered?: undefined;
     label?: undefined;
-} | {
     message?: undefined;
+} | {
     deleted?: undefined;
+    providers?: undefined;
     count?: undefined;
     provider?: undefined;
-    providers?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
-} | {
     message?: undefined;
+} | {
+    providers?: undefined;
     count?: undefined;
     provider?: undefined;
-    providers?: undefined;
     found?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
     deleted?: undefined;
+    providers?: undefined;
     count?: undefined;
     provider?: undefined;
-    providers?: undefined;
     found?: undefined;
     registered: boolean;
     id: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -311,6 +311,10 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         notes?: string | undefined;
         scope?: "org" | "user" | undefined;
     }, {
+        id?: undefined;
+        message?: undefined;
+        deleted?: undefined;
+        provider?: undefined;
         providers: {
             id: string;
             label: string;
@@ -321,49 +325,45 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
             updatedAt: number;
         }[];
         count: number;
-        provider?: undefined;
         found?: undefined;
-        deleted?: undefined;
         registered?: undefined;
-        id?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        providers?: undefined;
+        id?: undefined;
+        message?: undefined;
+        deleted?: undefined;
         count?: undefined;
+        providers?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
-        deleted?: undefined;
         registered?: undefined;
-        id?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        providers?: undefined;
+        message?: undefined;
+        deleted?: undefined;
         count?: undefined;
         provider?: undefined;
+        providers?: undefined;
         found: boolean;
         id: string;
-        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        providers?: undefined;
+        message?: undefined;
         count?: undefined;
         provider?: undefined;
+        providers?: undefined;
         found?: undefined;
         deleted: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-        message?: undefined;
     } | {
-        providers?: undefined;
+        deleted?: undefined;
         count?: undefined;
         provider?: undefined;
+        providers?: undefined;
         found?: undefined;
-        deleted?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/provider-api/corpus-jobs.d.ts

@@ -73,7 +73,6 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     offset?: unknown;
     limit?: unknown;
 }, {
-    deleted?: undefined;
     jobs: {
         id: string;
         name: string;
@@ -84,6 +83,7 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
         updatedAt: string;
     }[];
     total: number;
+    deleted?: undefined;
     jobId?: undefined;
 } | {
     jobs?: undefined;
@@ -91,9 +91,9 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     deleted: boolean;
     jobId: string;
 } | {
-    deleted?: undefined;
     jobs?: undefined;
     total?: undefined;
+    deleted?: undefined;
     jobId?: undefined;
     hits: Record<string, unknown>[];
     offset: number;

package/dist/resources/handlers.d.ts

@@ -48,8 +48,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/secrets/routes.d.ts

@@ -53,37 +53,37 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
 /** POST /_agent-native/secrets/:key — write a secret. */
 export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
-    status?: undefined;
     ok?: undefined;
+    status?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     status: string;
+    error?: undefined;
 } | {
+    ok?: undefined;
     error: string;
     removed?: undefined;
-    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 /**
  * POST /_agent-native/secrets/:key/test — validate an optional candidate value
  * or the current stored value without changing anything.
  */
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    ok?: undefined;
     error: string;
     note?: undefined;
-    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     note?: undefined;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     note: string;
+    error?: undefined;
 } | {
     note?: undefined;
     ok: boolean;
@@ -115,11 +115,11 @@ export interface AdHocSecretPayload {
 export declare function createAdHocSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<AdHocSecretPayload[] | {
     error: string;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;

package/dist/server/beta-opt-out-html.js

@@ -25,9 +25,9 @@ function betaRedirectBasePath(requestPath) {
         : configuredBasePath;
 }
 const environmentSwitcherMarkup = `<div class="environment-switcher" id="environment-switcher" ${ENVIRONMENT_SWITCHER_MARKER} hidden>
-  <button type="button" class="environment-badge" id="environment-badge" aria-expanded="false" aria-controls="environment-popover">beta</button>
+  <button type="button" class="environment-badge" id="environment-badge" aria-expanded="false" aria-controls="environment-popover">alpha</button>
   <div class="environment-popover" id="environment-popover" role="dialog" aria-labelledby="environment-popover-title" hidden>
-    <div class="environment-popover-title" id="environment-popover-title">You're on Agent-Native Beta</div>
+    <div class="environment-popover-title" id="environment-popover-title">You're on Agent-Native Alpha</div>
     <div class="environment-popover-copy">Choose where you want to continue.</div>
     <a class="environment-production-link" id="environment-production-link" href="">Switch to production</a>
     <button type="button" class="environment-hide-badge" id="environment-hide-badge">Hide badge</button>