@proteos/sdk 0.49.0 → 0.51.0

package/dist/{types-COxVBT4w.d.cts → types-C9flkAj-.d.cts}

@@ -554,6 +554,40 @@ declare class PageIterator<T, O extends ListOptions> implements AsyncIterable<T>
  */
 declare function createIterator<T, O extends ListOptions>(listFn: ListFn<T, O>, options: O): PageIterator<T, O>;
 
+/**
+ * Service for app configurations — the typed (app × profile) binding rows
+ * that say how an app presents itself: home, menu, agents, record pages.
+ * `profile_slug: ''` is the app's base configuration for everyone; a row with
+ * a profile is that profile's override (merged field-wise over the base).
+ */
+interface AppConfigurationService {
+    /** Lists app configurations (auto-paginating iterator). */
+    list(options?: ListAppConfigurationsOptions): PageIterator<AppConfiguration, ListAppConfigurationsOptions>;
+    /** Fetches a single page of app configurations. */
+    listPage(options?: ListAppConfigurationsOptions): Promise<ListResult<AppConfiguration>>;
+    /** Gets an app configuration by slug (404 when unknown). */
+    get(slug: string): Promise<AppConfiguration>;
+    /**
+     * Creates an app configuration. Every reference (app, home list/page, menu,
+     * record pages) must exist; `profile_slug` and agent keys are other
+     * services' and are not validated.
+     * @throws {ProteosError} 409 `app_configuration_already_exists` when the
+     *   (app_slug, profile_slug) pair is already bound.
+     */
+    create(request: CreateAppConfigurationRequest): Promise<AppConfiguration>;
+    /**
+     * Creates or replaces an app configuration idempotently by slug
+     * (`PUT /meta/v1/app-configurations/:slug`). Replaces the whole
+     * configuration; the (app_slug, profile_slug) binding of an existing slug
+     * is immutable.
+     */
+    upsert(slug: string, request: CreateAppConfigurationRequest): Promise<AppConfiguration>;
+    /** Partially updates an app configuration (`home: null` clears the home). */
+    update(slug: string, request: UpdateAppConfigurationRequest): Promise<AppConfiguration>;
+    /** Deletes an app configuration. */
+    delete(slug: string): Promise<void>;
+}
+
 /**
  * Service for managing apps.
  * Apps group menu configurations and other org-scoped metadata under a
@@ -1851,6 +1885,11 @@ declare class MetaClient {
      * Service for managing apps.
      */
     readonly apps: AppService;
+    /**
+     * Service for managing app configurations — the typed (app × profile)
+     * bindings: home, menu, agents, record pages.
+     */
+    readonly appConfigurations: AppConfigurationService;
     /**
      * Service for managing design references (stored DESIGN.md documents).
      */
@@ -3264,7 +3303,6 @@ interface List extends AuditFields {
     /** Row-selection affordance; absent normalizes to `on_demand`. */
     selection_mode?: SelectionMode;
     /** Record page to open from this list; empty/absent = org default for the entity. */
-    default_page_slug?: string;
     sorting: SortConfig[];
     filters: FilterGroup[];
 }
@@ -3361,7 +3399,6 @@ declare const ListSchema: z.ZodObject<{
         kind?: "workflow" | "action" | undefined;
     }>, "many">>;
     selection_mode: z.ZodOptional<z.ZodEnum<["on_demand", "always", "off"]>>;
-    default_page_slug: z.ZodOptional<z.ZodString>;
     sorting: z.ZodArray<z.ZodObject<{
         attribute: z.ZodString;
         direction: z.ZodEnum<["asc", "desc"]>;
@@ -3409,7 +3446,6 @@ declare const ListSchema: z.ZodObject<{
         kind?: "workflow" | "action" | undefined;
     }[] | undefined;
     selection_mode?: "on_demand" | "always" | "off" | undefined;
-    default_page_slug?: string | undefined;
 }, {
     name: string;
     created_at: string;
@@ -3446,7 +3482,6 @@ declare const ListSchema: z.ZodObject<{
         kind?: "workflow" | "action" | undefined;
     }[] | undefined;
     selection_mode?: "on_demand" | "always" | "off" | undefined;
-    default_page_slug?: string | undefined;
 }>;
 /**
  * Options for listing lists.
@@ -3468,7 +3503,6 @@ interface CreateListRequest {
     columns: Column[];
     actions?: PageAction[];
     selection_mode?: SelectionMode;
-    default_page_slug?: string;
     sorting: SortConfig[];
     filters: FilterGroup[];
 }
@@ -3482,7 +3516,6 @@ interface UpdateListRequest {
     actions?: PageAction[];
     selection_mode?: SelectionMode;
     /** Set to '' to clear back to the org default. */
-    default_page_slug?: string;
     sorting?: SortConfig[];
     filters?: FilterGroup[];
 }
@@ -4049,6 +4082,174 @@ interface UpdateMenuConfigurationRequest {
     items?: MenuItem[];
     is_default?: boolean;
 }
+/** What an app opens on: a list (records table) or a platform page. */
+type AppHomeType = 'list' | 'page';
+interface AppHome {
+    type: AppHomeType;
+    reference: string;
+}
+declare const AppHomeSchema: z.ZodObject<{
+    type: z.ZodEnum<["list", "page"]>;
+    reference: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "page" | "list";
+    reference: string;
+}, {
+    type: "page" | "list";
+    reference: string;
+}>;
+/**
+ * AppConfiguration — a TYPED binding row: "how app X presents itself" to
+ * everyone (`profile_slug: ''` = the app's default configuration) or to one
+ * profile (an override). One row per (app, profile). The web merges
+ * override ⊕ default field-wise and falls through to structural defaults (menu
+ * `is_default`, first menu leaf, org-default agent, first page) for anything
+ * still unset.
+ */
+interface AppConfiguration extends AuditFields {
+    slug: string;
+    org_id: string;
+    module_slug: string;
+    app_slug: string;
+    /** Bound profile; `''` = the default configuration for everyone. */
+    profile_slug: string;
+    /** Home; absent = the first list/page leaf of the resolved menu. */
+    home?: AppHome | null;
+    /** Menu to show; `''` = the app's `is_default` menu. */
+    menu_slug?: string;
+    /** Agent Ask Proteos preselects in this app; `''` = the org default. */
+    default_agent_key?: string;
+    /** Agents offered in this app; empty = every org agent. */
+    agent_keys?: string[];
+    /** entity_slug → record page slug opened from this app. */
+    record_pages?: Record<string, string>;
+}
+declare const AppConfigurationSchema: z.ZodObject<{
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodObject<{
+        type: z.ZodEnum<["person", "agent", "api"]>;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }>;
+    updated_by: z.ZodObject<{
+        type: z.ZodEnum<["person", "agent", "api"]>;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }>;
+} & {
+    slug: z.ZodString;
+    org_id: z.ZodString;
+    module_slug: z.ZodString;
+    app_slug: z.ZodString;
+    profile_slug: z.ZodString;
+    home: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        type: z.ZodEnum<["list", "page"]>;
+        reference: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "page" | "list";
+        reference: string;
+    }, {
+        type: "page" | "list";
+        reference: string;
+    }>>>;
+    menu_slug: z.ZodOptional<z.ZodString>;
+    default_agent_key: z.ZodOptional<z.ZodString>;
+    agent_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    record_pages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    slug: string;
+    module_slug: string;
+    app_slug: string;
+    org_id: string;
+    profile_slug: string;
+    home?: {
+        type: "page" | "list";
+        reference: string;
+    } | null | undefined;
+    menu_slug?: string | undefined;
+    default_agent_key?: string | undefined;
+    agent_keys?: string[] | undefined;
+    record_pages?: Record<string, string> | undefined;
+}, {
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    slug: string;
+    module_slug: string;
+    app_slug: string;
+    org_id: string;
+    profile_slug: string;
+    home?: {
+        type: "page" | "list";
+        reference: string;
+    } | null | undefined;
+    menu_slug?: string | undefined;
+    default_agent_key?: string | undefined;
+    agent_keys?: string[] | undefined;
+    record_pages?: Record<string, string> | undefined;
+}>;
+interface ListAppConfigurationsOptions extends MetaListOptions {
+    slug?: string;
+    module_slug?: string;
+    app_slug?: string;
+    profile_slug?: string;
+    /** `true` = only default rows (no profile), `false` = only profile overrides.
+     *  An empty `profile_slug` is never sent, so this is how default rows are
+     *  selected. */
+    is_default?: boolean;
+    menu_slug?: string;
+}
+interface CreateAppConfigurationRequest {
+    slug: string;
+    module_slug?: string;
+    app_slug: string;
+    profile_slug?: string;
+    home?: AppHome | null;
+    menu_slug?: string;
+    default_agent_key?: string;
+    agent_keys?: string[];
+    record_pages?: Record<string, string>;
+}
+/**
+ * Partial update. `home` is tri-state: absent = unchanged, `null` = clear,
+ * object = set. The (app_slug, profile_slug) binding is immutable.
+ */
+interface UpdateAppConfigurationRequest {
+    module_slug?: string;
+    home?: AppHome | null;
+    menu_slug?: string;
+    default_agent_key?: string;
+    agent_keys?: string[];
+    record_pages?: Record<string, string>;
+}
 /**
  * App definition. Apps group menu configurations and other org-scoped
  * metadata under a stable slug. Slug is unique per org (composite key
@@ -4286,4 +4487,4 @@ declare function isCurrentUserDefault(value: unknown): value is CurrentUserDefau
 /** Only the identity-valued attribute types can carry the sentinel. */
 declare function acceptsCurrentUserDefault(type: AttributeType): boolean;
 
-export { type EntityWithSchema as $, type AuditFields as A, type CreateListViewRequest as B, CURRENT_USER_DEFAULT as C, type CreateMenuConfigurationRequest as D, type CreatePageRequest as E, type FileRef as F, type CreateVariableRequest as G, type CurrencyAttributeMeta as H, CurrencyAttributeMetaSchema as I, type CurrencySymbolSide as J, type CurrencyValue as K, type ListOptions as L, type CurrentUserDefault as M, DEFAULT_OPTIONS as N, DEFAULT_PAGE_SIZE as O, PageIterator as P, DONE as Q, type DeployModuleRequest as R, type DesignReference as S, type DesignReferenceContent as T, type UserRef as U, DesignReferenceSchema as V, type DesignReferenceService as W, type Done as X, type Entity as Y, EntitySchema as Z, type EntityService as _, type Attribute as a, type Timestamps as a$, EntityWithSchemaSchema as a0, type EnumAttributeMeta as a1, type EnumValue as a2, type FileAttributeMeta as a3, FileRefSchema as a4, type FilterElement as a5, FilterElementSchema as a6, type FilterGroup as a7, FilterGroupSchema as a8, type List as a9, ModuleSchema as aA, type ModuleService as aB, type ModuleStatus as aC, type OnDeleteAction as aD, OnDeleteActionSchema as aE, PLATFORM_ATTRIBUTE_NAMES as aF, PLATFORM_USER_ID as aG, type Page as aH, type PageAction as aI, type PageActionKind as aJ, PageActionSchema as aK, type PageLayout as aL, PageLayoutSchema as aM, PageSchema as aN, type PageService as aO, type PageType as aP, type PublicPageComponent as aQ, type PublicPageResponse as aR, type RelationAttributeMeta as aS, RelationAttributeMetaSchema as aT, type RequestOptions as aU, type ResolvedClientOptions as aV, type ResponseMeta as aW, ResponseMetaSchema as aX, type SortConfig as aY, SortConfigSchema as aZ, type SortDirection as a_, type ListAppsOptions as aa, type ListComponentsOptions as ab, type ListDesignReferencesOptions as ac, type ListEntitiesOptions as ad, type ListFn as ae, type ListListViewsOptions as af, type ListListsOptions as ag, type ListMenuConfigurationsOptions as ah, type ListModulesOptions as ai, type ListPagesOptions as aj, ListSchema as ak, type ListService as al, type ListVariablesOptions as am, type ListView as an, ListViewSchema as ao, type ListViewService as ap, type LogicalOperator as aq, type MenuConfiguration as ar, MenuConfigurationSchema as as, type MenuConfigurationService as at, type MenuItem as au, MenuItemSchema as av, MenuItemType as aw, MetaClient as ax, type MetaListOptions as ay, type Module as az, type ListResult as b, type PrincipalAttributeMeta as b$, type TokenProvider as b0, type UpdateAppRequest as b1, type UpdateComponentRequest as b2, type UpdateDesignReferenceRequest as b3, type UpdateEntityRequest as b4, type UpdateListRequest as b5, type UpdateListViewRequest as b6, type UpdateMenuConfigurationRequest as b7, type UpdatePageRequest as b8, type UpdateVariableRequest as b9, type BuiltInControlSlug as bA, type CardElement as bB, type ColumnElement as bC, type CommonProps as bD, type ComponentElement as bE, type ControlBucket as bF, type DatetimeAttributeMeta as bG, type DatetimeFormat as bH, type DividerElement as bI, type FieldElement as bJ, FileAttributeMetaSchema as bK, type LayoutAlign as bL, type LayoutElement as bM, LayoutElementSchema as bN, LayoutElementType as bO, type LayoutGap as bP, type LayoutJustify as bQ, type LayoutTab as bR, type ListElement as bS, type NumberAttributeMeta as bT, type ObjectAttributeMeta as bU, PAGE_BACKGROUND_TOKENS as bV, type PageBackgroundToken as bW, type PageLayoutSidePanel as bX, PageLayoutSidePanelSchema as bY, type PageStyle as bZ, PageStyleSchema as b_, UserRefSchema as ba, type UserType as bb, type Variable as bc, VariableSchema as bd, type VariableService as be, acceptsCurrentUserDefault as bf, allCurrencyCodes as bg, createIterator as bh, createListResultSchema as bi, currencyLabel as bj, currencySymbol as bk, currencySymbolSide as bl, formatAmount as bm, formatMoney as bn, isCurrentUserDefault as bo, isPlatformAttributeName as bp, localeNumberSeparators as bq, parseAmount as br, parseCurrencyMeta as bs, parseFileMeta as bt, parseRelationMeta as bu, platformAttributes as bv, resolveOptions as bw, type AttributeForLookup as bx, type AttributeMeta as by, BUILT_IN_CONTROLS as bz, ProteosClient as c, type PrincipalType as c0, type RecordFilterElement as c1, type RelatedListElement as c2, type RelatedRecordElement as c3, type ResponsiveSizing as c4, type RowElement as c5, type SectionElement as c6, type SizeValue as c7, SizeValueSchema as c8, type SizingProps as c9, type StringAttributeMeta as ca, type StringFormat as cb, type TabsElement as cc, type TextElement as cd, type TextVariant as ce, type UserAttributeMeta as cf, UserAttributeMetaSchema as cg, type WorkflowTriggerElement as ch, isBuiltInControl as ci, lookupCompatibleControls as cj, lookupControls as ck, lookupPrimaryControl as cl, parsePrincipalMeta as cm, parseUserMeta as cn, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, AppSchema as g, type AppService as h, type ArrayAttributeMeta as i, type AttributeAccessRule as j, type AttributeRestrictions as k, AttributeSchema as l, type AttributeType as m, AuditFieldsSchema as n, type ClientOptions as o, type Column as p, ColumnSchema as q, type ComparisonOperator as r, type Component as s, ComponentSchema as t, type ComponentService as u, type CreateAppRequest as v, type CreateComponentRequest as w, type CreateDesignReferenceRequest as x, type CreateEntityRequest as y, type CreateListRequest as z };
+export { type DesignReferenceContent as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type CreateAppConfigurationRequest as D, type CreateAppRequest as E, type FileRef as F, type CreateComponentRequest as G, type CreateDesignReferenceRequest as H, type CreateEntityRequest as I, type CreateListRequest as J, type CreateListViewRequest as K, type ListOptions as L, type CreateMenuConfigurationRequest as M, type CreatePageRequest as N, type CreateVariableRequest as O, PageIterator as P, type CurrencyAttributeMeta as Q, CurrencyAttributeMetaSchema as R, type CurrencySymbolSide as S, type CurrencyValue as T, type UserRef as U, type CurrentUserDefault as V, DEFAULT_OPTIONS as W, DEFAULT_PAGE_SIZE as X, DONE as Y, type DeployModuleRequest as Z, type DesignReference as _, type Attribute as a, RelationAttributeMetaSchema as a$, DesignReferenceSchema as a0, type DesignReferenceService as a1, type Done as a2, type Entity as a3, EntitySchema as a4, type EntityService as a5, type EntityWithSchema as a6, EntityWithSchemaSchema as a7, type EnumAttributeMeta as a8, type EnumValue as a9, MenuConfigurationSchema as aA, type MenuConfigurationService as aB, type MenuItem as aC, MenuItemSchema as aD, MenuItemType as aE, MetaClient as aF, type MetaListOptions as aG, type Module as aH, ModuleSchema as aI, type ModuleService as aJ, type ModuleStatus as aK, type OnDeleteAction as aL, OnDeleteActionSchema as aM, PLATFORM_ATTRIBUTE_NAMES as aN, PLATFORM_USER_ID as aO, type Page as aP, type PageAction as aQ, type PageActionKind as aR, PageActionSchema as aS, type PageLayout as aT, PageLayoutSchema as aU, PageSchema as aV, type PageService as aW, type PageType as aX, type PublicPageComponent as aY, type PublicPageResponse as aZ, type RelationAttributeMeta as a_, type FileAttributeMeta as aa, FileRefSchema as ab, type FilterElement as ac, FilterElementSchema as ad, type FilterGroup as ae, FilterGroupSchema as af, type List as ag, type ListAppConfigurationsOptions as ah, type ListAppsOptions as ai, type ListComponentsOptions as aj, type ListDesignReferencesOptions as ak, type ListEntitiesOptions as al, type ListFn as am, type ListListViewsOptions as an, type ListListsOptions as ao, type ListMenuConfigurationsOptions as ap, type ListModulesOptions as aq, type ListPagesOptions as ar, ListSchema as as, type ListService as at, type ListVariablesOptions as au, type ListView as av, ListViewSchema as aw, type ListViewService as ax, type LogicalOperator as ay, type MenuConfiguration as az, type ListResult as b, type ListElement as b$, type RequestOptions as b0, type ResolvedClientOptions as b1, type ResponseMeta as b2, ResponseMetaSchema as b3, type SortConfig as b4, SortConfigSchema as b5, type SortDirection as b6, type Timestamps as b7, type TokenProvider as b8, type UpdateAppConfigurationRequest as b9, parseAmount as bA, parseCurrencyMeta as bB, parseFileMeta as bC, parseRelationMeta as bD, platformAttributes as bE, resolveOptions as bF, type AttributeForLookup as bG, type AttributeMeta as bH, BUILT_IN_CONTROLS as bI, type BuiltInControlSlug as bJ, type CardElement as bK, type ColumnElement as bL, type CommonProps as bM, type ComponentElement as bN, type ControlBucket as bO, type DatetimeAttributeMeta as bP, type DatetimeFormat as bQ, type DividerElement as bR, type FieldElement as bS, FileAttributeMetaSchema as bT, type LayoutAlign as bU, type LayoutElement as bV, LayoutElementSchema as bW, LayoutElementType as bX, type LayoutGap as bY, type LayoutJustify as bZ, type LayoutTab as b_, type UpdateAppRequest as ba, type UpdateComponentRequest as bb, type UpdateDesignReferenceRequest as bc, type UpdateEntityRequest as bd, type UpdateListRequest as be, type UpdateListViewRequest as bf, type UpdateMenuConfigurationRequest as bg, type UpdatePageRequest as bh, type UpdateVariableRequest as bi, UserRefSchema as bj, type UserType as bk, type Variable as bl, VariableSchema as bm, type VariableService as bn, acceptsCurrentUserDefault as bo, allCurrencyCodes as bp, createIterator as bq, createListResultSchema as br, currencyLabel as bs, currencySymbol as bt, currencySymbolSide as bu, formatAmount as bv, formatMoney as bw, isCurrentUserDefault as bx, isPlatformAttributeName as by, localeNumberSeparators as bz, ProteosClient as c, type NumberAttributeMeta as c0, type ObjectAttributeMeta as c1, PAGE_BACKGROUND_TOKENS as c2, type PageBackgroundToken as c3, type PageLayoutSidePanel as c4, PageLayoutSidePanelSchema as c5, type PageStyle as c6, PageStyleSchema as c7, type PrincipalAttributeMeta as c8, type PrincipalType as c9, type RecordFilterElement as ca, type RelatedListElement as cb, type RelatedRecordElement as cc, type ResponsiveSizing as cd, type RowElement as ce, type SectionElement as cf, type SizeValue as cg, SizeValueSchema as ch, type SizingProps as ci, type StringAttributeMeta as cj, type StringFormat as ck, type TabsElement as cl, type TextElement as cm, type TextVariant as cn, type UserAttributeMeta as co, UserAttributeMetaSchema as cp, type WorkflowTriggerElement as cq, isBuiltInControl as cr, lookupCompatibleControls as cs, lookupControls as ct, lookupPrimaryControl as cu, parsePrincipalMeta as cv, parseUserMeta as cw, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };

package/dist/{types-COxVBT4w.d.ts → types-C9flkAj-.d.ts}

@@ -554,6 +554,40 @@ declare class PageIterator<T, O extends ListOptions> implements AsyncIterable<T>
  */
 declare function createIterator<T, O extends ListOptions>(listFn: ListFn<T, O>, options: O): PageIterator<T, O>;
 
+/**
+ * Service for app configurations — the typed (app × profile) binding rows
+ * that say how an app presents itself: home, menu, agents, record pages.
+ * `profile_slug: ''` is the app's base configuration for everyone; a row with
+ * a profile is that profile's override (merged field-wise over the base).
+ */
+interface AppConfigurationService {
+    /** Lists app configurations (auto-paginating iterator). */
+    list(options?: ListAppConfigurationsOptions): PageIterator<AppConfiguration, ListAppConfigurationsOptions>;
+    /** Fetches a single page of app configurations. */
+    listPage(options?: ListAppConfigurationsOptions): Promise<ListResult<AppConfiguration>>;
+    /** Gets an app configuration by slug (404 when unknown). */
+    get(slug: string): Promise<AppConfiguration>;
+    /**
+     * Creates an app configuration. Every reference (app, home list/page, menu,
+     * record pages) must exist; `profile_slug` and agent keys are other
+     * services' and are not validated.
+     * @throws {ProteosError} 409 `app_configuration_already_exists` when the
+     *   (app_slug, profile_slug) pair is already bound.
+     */
+    create(request: CreateAppConfigurationRequest): Promise<AppConfiguration>;
+    /**
+     * Creates or replaces an app configuration idempotently by slug
+     * (`PUT /meta/v1/app-configurations/:slug`). Replaces the whole
+     * configuration; the (app_slug, profile_slug) binding of an existing slug
+     * is immutable.
+     */
+    upsert(slug: string, request: CreateAppConfigurationRequest): Promise<AppConfiguration>;
+    /** Partially updates an app configuration (`home: null` clears the home). */
+    update(slug: string, request: UpdateAppConfigurationRequest): Promise<AppConfiguration>;
+    /** Deletes an app configuration. */
+    delete(slug: string): Promise<void>;
+}
+
 /**
  * Service for managing apps.
  * Apps group menu configurations and other org-scoped metadata under a
@@ -1851,6 +1885,11 @@ declare class MetaClient {
      * Service for managing apps.
      */
     readonly apps: AppService;
+    /**
+     * Service for managing app configurations — the typed (app × profile)
+     * bindings: home, menu, agents, record pages.
+     */
+    readonly appConfigurations: AppConfigurationService;
     /**
      * Service for managing design references (stored DESIGN.md documents).
      */
@@ -3264,7 +3303,6 @@ interface List extends AuditFields {
     /** Row-selection affordance; absent normalizes to `on_demand`. */
     selection_mode?: SelectionMode;
     /** Record page to open from this list; empty/absent = org default for the entity. */
-    default_page_slug?: string;
     sorting: SortConfig[];
     filters: FilterGroup[];
 }
@@ -3361,7 +3399,6 @@ declare const ListSchema: z.ZodObject<{
         kind?: "workflow" | "action" | undefined;
     }>, "many">>;
     selection_mode: z.ZodOptional<z.ZodEnum<["on_demand", "always", "off"]>>;
-    default_page_slug: z.ZodOptional<z.ZodString>;
     sorting: z.ZodArray<z.ZodObject<{
         attribute: z.ZodString;
         direction: z.ZodEnum<["asc", "desc"]>;
@@ -3409,7 +3446,6 @@ declare const ListSchema: z.ZodObject<{
         kind?: "workflow" | "action" | undefined;
     }[] | undefined;
     selection_mode?: "on_demand" | "always" | "off" | undefined;
-    default_page_slug?: string | undefined;
 }, {
     name: string;
     created_at: string;
@@ -3446,7 +3482,6 @@ declare const ListSchema: z.ZodObject<{
         kind?: "workflow" | "action" | undefined;
     }[] | undefined;
     selection_mode?: "on_demand" | "always" | "off" | undefined;
-    default_page_slug?: string | undefined;
 }>;
 /**
  * Options for listing lists.
@@ -3468,7 +3503,6 @@ interface CreateListRequest {
     columns: Column[];
     actions?: PageAction[];
     selection_mode?: SelectionMode;
-    default_page_slug?: string;
     sorting: SortConfig[];
     filters: FilterGroup[];
 }
@@ -3482,7 +3516,6 @@ interface UpdateListRequest {
     actions?: PageAction[];
     selection_mode?: SelectionMode;
     /** Set to '' to clear back to the org default. */
-    default_page_slug?: string;
     sorting?: SortConfig[];
     filters?: FilterGroup[];
 }
@@ -4049,6 +4082,174 @@ interface UpdateMenuConfigurationRequest {
     items?: MenuItem[];
     is_default?: boolean;
 }
+/** What an app opens on: a list (records table) or a platform page. */
+type AppHomeType = 'list' | 'page';
+interface AppHome {
+    type: AppHomeType;
+    reference: string;
+}
+declare const AppHomeSchema: z.ZodObject<{
+    type: z.ZodEnum<["list", "page"]>;
+    reference: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "page" | "list";
+    reference: string;
+}, {
+    type: "page" | "list";
+    reference: string;
+}>;
+/**
+ * AppConfiguration — a TYPED binding row: "how app X presents itself" to
+ * everyone (`profile_slug: ''` = the app's default configuration) or to one
+ * profile (an override). One row per (app, profile). The web merges
+ * override ⊕ default field-wise and falls through to structural defaults (menu
+ * `is_default`, first menu leaf, org-default agent, first page) for anything
+ * still unset.
+ */
+interface AppConfiguration extends AuditFields {
+    slug: string;
+    org_id: string;
+    module_slug: string;
+    app_slug: string;
+    /** Bound profile; `''` = the default configuration for everyone. */
+    profile_slug: string;
+    /** Home; absent = the first list/page leaf of the resolved menu. */
+    home?: AppHome | null;
+    /** Menu to show; `''` = the app's `is_default` menu. */
+    menu_slug?: string;
+    /** Agent Ask Proteos preselects in this app; `''` = the org default. */
+    default_agent_key?: string;
+    /** Agents offered in this app; empty = every org agent. */
+    agent_keys?: string[];
+    /** entity_slug → record page slug opened from this app. */
+    record_pages?: Record<string, string>;
+}
+declare const AppConfigurationSchema: z.ZodObject<{
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodObject<{
+        type: z.ZodEnum<["person", "agent", "api"]>;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }>;
+    updated_by: z.ZodObject<{
+        type: z.ZodEnum<["person", "agent", "api"]>;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }>;
+} & {
+    slug: z.ZodString;
+    org_id: z.ZodString;
+    module_slug: z.ZodString;
+    app_slug: z.ZodString;
+    profile_slug: z.ZodString;
+    home: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        type: z.ZodEnum<["list", "page"]>;
+        reference: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "page" | "list";
+        reference: string;
+    }, {
+        type: "page" | "list";
+        reference: string;
+    }>>>;
+    menu_slug: z.ZodOptional<z.ZodString>;
+    default_agent_key: z.ZodOptional<z.ZodString>;
+    agent_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    record_pages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    slug: string;
+    module_slug: string;
+    app_slug: string;
+    org_id: string;
+    profile_slug: string;
+    home?: {
+        type: "page" | "list";
+        reference: string;
+    } | null | undefined;
+    menu_slug?: string | undefined;
+    default_agent_key?: string | undefined;
+    agent_keys?: string[] | undefined;
+    record_pages?: Record<string, string> | undefined;
+}, {
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    slug: string;
+    module_slug: string;
+    app_slug: string;
+    org_id: string;
+    profile_slug: string;
+    home?: {
+        type: "page" | "list";
+        reference: string;
+    } | null | undefined;
+    menu_slug?: string | undefined;
+    default_agent_key?: string | undefined;
+    agent_keys?: string[] | undefined;
+    record_pages?: Record<string, string> | undefined;
+}>;
+interface ListAppConfigurationsOptions extends MetaListOptions {
+    slug?: string;
+    module_slug?: string;
+    app_slug?: string;
+    profile_slug?: string;
+    /** `true` = only default rows (no profile), `false` = only profile overrides.
+     *  An empty `profile_slug` is never sent, so this is how default rows are
+     *  selected. */
+    is_default?: boolean;
+    menu_slug?: string;
+}
+interface CreateAppConfigurationRequest {
+    slug: string;
+    module_slug?: string;
+    app_slug: string;
+    profile_slug?: string;
+    home?: AppHome | null;
+    menu_slug?: string;
+    default_agent_key?: string;
+    agent_keys?: string[];
+    record_pages?: Record<string, string>;
+}
+/**
+ * Partial update. `home` is tri-state: absent = unchanged, `null` = clear,
+ * object = set. The (app_slug, profile_slug) binding is immutable.
+ */
+interface UpdateAppConfigurationRequest {
+    module_slug?: string;
+    home?: AppHome | null;
+    menu_slug?: string;
+    default_agent_key?: string;
+    agent_keys?: string[];
+    record_pages?: Record<string, string>;
+}
 /**
  * App definition. Apps group menu configurations and other org-scoped
  * metadata under a stable slug. Slug is unique per org (composite key
@@ -4286,4 +4487,4 @@ declare function isCurrentUserDefault(value: unknown): value is CurrentUserDefau
 /** Only the identity-valued attribute types can carry the sentinel. */
 declare function acceptsCurrentUserDefault(type: AttributeType): boolean;
 
-export { type EntityWithSchema as $, type AuditFields as A, type CreateListViewRequest as B, CURRENT_USER_DEFAULT as C, type CreateMenuConfigurationRequest as D, type CreatePageRequest as E, type FileRef as F, type CreateVariableRequest as G, type CurrencyAttributeMeta as H, CurrencyAttributeMetaSchema as I, type CurrencySymbolSide as J, type CurrencyValue as K, type ListOptions as L, type CurrentUserDefault as M, DEFAULT_OPTIONS as N, DEFAULT_PAGE_SIZE as O, PageIterator as P, DONE as Q, type DeployModuleRequest as R, type DesignReference as S, type DesignReferenceContent as T, type UserRef as U, DesignReferenceSchema as V, type DesignReferenceService as W, type Done as X, type Entity as Y, EntitySchema as Z, type EntityService as _, type Attribute as a, type Timestamps as a$, EntityWithSchemaSchema as a0, type EnumAttributeMeta as a1, type EnumValue as a2, type FileAttributeMeta as a3, FileRefSchema as a4, type FilterElement as a5, FilterElementSchema as a6, type FilterGroup as a7, FilterGroupSchema as a8, type List as a9, ModuleSchema as aA, type ModuleService as aB, type ModuleStatus as aC, type OnDeleteAction as aD, OnDeleteActionSchema as aE, PLATFORM_ATTRIBUTE_NAMES as aF, PLATFORM_USER_ID as aG, type Page as aH, type PageAction as aI, type PageActionKind as aJ, PageActionSchema as aK, type PageLayout as aL, PageLayoutSchema as aM, PageSchema as aN, type PageService as aO, type PageType as aP, type PublicPageComponent as aQ, type PublicPageResponse as aR, type RelationAttributeMeta as aS, RelationAttributeMetaSchema as aT, type RequestOptions as aU, type ResolvedClientOptions as aV, type ResponseMeta as aW, ResponseMetaSchema as aX, type SortConfig as aY, SortConfigSchema as aZ, type SortDirection as a_, type ListAppsOptions as aa, type ListComponentsOptions as ab, type ListDesignReferencesOptions as ac, type ListEntitiesOptions as ad, type ListFn as ae, type ListListViewsOptions as af, type ListListsOptions as ag, type ListMenuConfigurationsOptions as ah, type ListModulesOptions as ai, type ListPagesOptions as aj, ListSchema as ak, type ListService as al, type ListVariablesOptions as am, type ListView as an, ListViewSchema as ao, type ListViewService as ap, type LogicalOperator as aq, type MenuConfiguration as ar, MenuConfigurationSchema as as, type MenuConfigurationService as at, type MenuItem as au, MenuItemSchema as av, MenuItemType as aw, MetaClient as ax, type MetaListOptions as ay, type Module as az, type ListResult as b, type PrincipalAttributeMeta as b$, type TokenProvider as b0, type UpdateAppRequest as b1, type UpdateComponentRequest as b2, type UpdateDesignReferenceRequest as b3, type UpdateEntityRequest as b4, type UpdateListRequest as b5, type UpdateListViewRequest as b6, type UpdateMenuConfigurationRequest as b7, type UpdatePageRequest as b8, type UpdateVariableRequest as b9, type BuiltInControlSlug as bA, type CardElement as bB, type ColumnElement as bC, type CommonProps as bD, type ComponentElement as bE, type ControlBucket as bF, type DatetimeAttributeMeta as bG, type DatetimeFormat as bH, type DividerElement as bI, type FieldElement as bJ, FileAttributeMetaSchema as bK, type LayoutAlign as bL, type LayoutElement as bM, LayoutElementSchema as bN, LayoutElementType as bO, type LayoutGap as bP, type LayoutJustify as bQ, type LayoutTab as bR, type ListElement as bS, type NumberAttributeMeta as bT, type ObjectAttributeMeta as bU, PAGE_BACKGROUND_TOKENS as bV, type PageBackgroundToken as bW, type PageLayoutSidePanel as bX, PageLayoutSidePanelSchema as bY, type PageStyle as bZ, PageStyleSchema as b_, UserRefSchema as ba, type UserType as bb, type Variable as bc, VariableSchema as bd, type VariableService as be, acceptsCurrentUserDefault as bf, allCurrencyCodes as bg, createIterator as bh, createListResultSchema as bi, currencyLabel as bj, currencySymbol as bk, currencySymbolSide as bl, formatAmount as bm, formatMoney as bn, isCurrentUserDefault as bo, isPlatformAttributeName as bp, localeNumberSeparators as bq, parseAmount as br, parseCurrencyMeta as bs, parseFileMeta as bt, parseRelationMeta as bu, platformAttributes as bv, resolveOptions as bw, type AttributeForLookup as bx, type AttributeMeta as by, BUILT_IN_CONTROLS as bz, ProteosClient as c, type PrincipalType as c0, type RecordFilterElement as c1, type RelatedListElement as c2, type RelatedRecordElement as c3, type ResponsiveSizing as c4, type RowElement as c5, type SectionElement as c6, type SizeValue as c7, SizeValueSchema as c8, type SizingProps as c9, type StringAttributeMeta as ca, type StringFormat as cb, type TabsElement as cc, type TextElement as cd, type TextVariant as ce, type UserAttributeMeta as cf, UserAttributeMetaSchema as cg, type WorkflowTriggerElement as ch, isBuiltInControl as ci, lookupCompatibleControls as cj, lookupControls as ck, lookupPrimaryControl as cl, parsePrincipalMeta as cm, parseUserMeta as cn, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, AppSchema as g, type AppService as h, type ArrayAttributeMeta as i, type AttributeAccessRule as j, type AttributeRestrictions as k, AttributeSchema as l, type AttributeType as m, AuditFieldsSchema as n, type ClientOptions as o, type Column as p, ColumnSchema as q, type ComparisonOperator as r, type Component as s, ComponentSchema as t, type ComponentService as u, type CreateAppRequest as v, type CreateComponentRequest as w, type CreateDesignReferenceRequest as x, type CreateEntityRequest as y, type CreateListRequest as z };
+export { type DesignReferenceContent as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type CreateAppConfigurationRequest as D, type CreateAppRequest as E, type FileRef as F, type CreateComponentRequest as G, type CreateDesignReferenceRequest as H, type CreateEntityRequest as I, type CreateListRequest as J, type CreateListViewRequest as K, type ListOptions as L, type CreateMenuConfigurationRequest as M, type CreatePageRequest as N, type CreateVariableRequest as O, PageIterator as P, type CurrencyAttributeMeta as Q, CurrencyAttributeMetaSchema as R, type CurrencySymbolSide as S, type CurrencyValue as T, type UserRef as U, type CurrentUserDefault as V, DEFAULT_OPTIONS as W, DEFAULT_PAGE_SIZE as X, DONE as Y, type DeployModuleRequest as Z, type DesignReference as _, type Attribute as a, RelationAttributeMetaSchema as a$, DesignReferenceSchema as a0, type DesignReferenceService as a1, type Done as a2, type Entity as a3, EntitySchema as a4, type EntityService as a5, type EntityWithSchema as a6, EntityWithSchemaSchema as a7, type EnumAttributeMeta as a8, type EnumValue as a9, MenuConfigurationSchema as aA, type MenuConfigurationService as aB, type MenuItem as aC, MenuItemSchema as aD, MenuItemType as aE, MetaClient as aF, type MetaListOptions as aG, type Module as aH, ModuleSchema as aI, type ModuleService as aJ, type ModuleStatus as aK, type OnDeleteAction as aL, OnDeleteActionSchema as aM, PLATFORM_ATTRIBUTE_NAMES as aN, PLATFORM_USER_ID as aO, type Page as aP, type PageAction as aQ, type PageActionKind as aR, PageActionSchema as aS, type PageLayout as aT, PageLayoutSchema as aU, PageSchema as aV, type PageService as aW, type PageType as aX, type PublicPageComponent as aY, type PublicPageResponse as aZ, type RelationAttributeMeta as a_, type FileAttributeMeta as aa, FileRefSchema as ab, type FilterElement as ac, FilterElementSchema as ad, type FilterGroup as ae, FilterGroupSchema as af, type List as ag, type ListAppConfigurationsOptions as ah, type ListAppsOptions as ai, type ListComponentsOptions as aj, type ListDesignReferencesOptions as ak, type ListEntitiesOptions as al, type ListFn as am, type ListListViewsOptions as an, type ListListsOptions as ao, type ListMenuConfigurationsOptions as ap, type ListModulesOptions as aq, type ListPagesOptions as ar, ListSchema as as, type ListService as at, type ListVariablesOptions as au, type ListView as av, ListViewSchema as aw, type ListViewService as ax, type LogicalOperator as ay, type MenuConfiguration as az, type ListResult as b, type ListElement as b$, type RequestOptions as b0, type ResolvedClientOptions as b1, type ResponseMeta as b2, ResponseMetaSchema as b3, type SortConfig as b4, SortConfigSchema as b5, type SortDirection as b6, type Timestamps as b7, type TokenProvider as b8, type UpdateAppConfigurationRequest as b9, parseAmount as bA, parseCurrencyMeta as bB, parseFileMeta as bC, parseRelationMeta as bD, platformAttributes as bE, resolveOptions as bF, type AttributeForLookup as bG, type AttributeMeta as bH, BUILT_IN_CONTROLS as bI, type BuiltInControlSlug as bJ, type CardElement as bK, type ColumnElement as bL, type CommonProps as bM, type ComponentElement as bN, type ControlBucket as bO, type DatetimeAttributeMeta as bP, type DatetimeFormat as bQ, type DividerElement as bR, type FieldElement as bS, FileAttributeMetaSchema as bT, type LayoutAlign as bU, type LayoutElement as bV, LayoutElementSchema as bW, LayoutElementType as bX, type LayoutGap as bY, type LayoutJustify as bZ, type LayoutTab as b_, type UpdateAppRequest as ba, type UpdateComponentRequest as bb, type UpdateDesignReferenceRequest as bc, type UpdateEntityRequest as bd, type UpdateListRequest as be, type UpdateListViewRequest as bf, type UpdateMenuConfigurationRequest as bg, type UpdatePageRequest as bh, type UpdateVariableRequest as bi, UserRefSchema as bj, type UserType as bk, type Variable as bl, VariableSchema as bm, type VariableService as bn, acceptsCurrentUserDefault as bo, allCurrencyCodes as bp, createIterator as bq, createListResultSchema as br, currencyLabel as bs, currencySymbol as bt, currencySymbolSide as bu, formatAmount as bv, formatMoney as bw, isCurrentUserDefault as bx, isPlatformAttributeName as by, localeNumberSeparators as bz, ProteosClient as c, type NumberAttributeMeta as c0, type ObjectAttributeMeta as c1, PAGE_BACKGROUND_TOKENS as c2, type PageBackgroundToken as c3, type PageLayoutSidePanel as c4, PageLayoutSidePanelSchema as c5, type PageStyle as c6, PageStyleSchema as c7, type PrincipalAttributeMeta as c8, type PrincipalType as c9, type RecordFilterElement as ca, type RelatedListElement as cb, type RelatedRecordElement as cc, type ResponsiveSizing as cd, type RowElement as ce, type SectionElement as cf, type SizeValue as cg, SizeValueSchema as ch, type SizingProps as ci, type StringAttributeMeta as cj, type StringFormat as ck, type TabsElement as cl, type TextElement as cm, type TextVariant as cn, type UserAttributeMeta as co, UserAttributeMetaSchema as cp, type WorkflowTriggerElement as cq, isBuiltInControl as cr, lookupCompatibleControls as cs, lookupControls as ct, lookupPrimaryControl as cu, parsePrincipalMeta as cv, parseUserMeta as cw, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.49.0",
+  "version": "0.51.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {