@proteos/sdk 0.18.1

package/dist/types-BNsjfU8N.d.ts

@@ -0,0 +1,3299 @@
+import { z } from 'zod';
+
+/**
+ * Token provider function for dynamic authentication.
+ * Can return a token synchronously or asynchronously.
+ */
+type TokenProvider = () => string | Promise<string>;
+/**
+ * Configuration options for the ProteosClient.
+ */
+interface ClientOptions {
+    /**
+     * Base URL for API requests.
+     * Example: 'https://api.proteos.ai'
+     */
+    baseUrl: string;
+    /**
+     * Static bearer token for authentication.
+     * Use this for simple authentication scenarios.
+     */
+    token?: string;
+    /**
+     * Dynamic token provider function.
+     * Called before each request to get the current token.
+     * Takes precedence over static token if both are provided.
+     * Useful for token refresh scenarios.
+     */
+    tokenProvider?: TokenProvider;
+    /**
+     * Request timeout in milliseconds.
+     * Default: 30000 (30 seconds)
+     */
+    timeout?: number;
+    /**
+     * Custom fetch implementation.
+     * Useful for testing or environments without native fetch.
+     * Default: global fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Custom headers to include in all requests.
+     * Authorization header is set automatically from token/tokenProvider.
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Internal resolved options with defaults applied.
+ */
+interface ResolvedClientOptions {
+    baseUrl: string;
+    token?: string;
+    tokenProvider?: TokenProvider;
+    timeout: number;
+    fetch: typeof fetch;
+    headers: Record<string, string>;
+}
+/**
+ * Default client options.
+ */
+declare const DEFAULT_OPTIONS: {
+    readonly timeout: 30000;
+    readonly headers: {};
+};
+/**
+ * Resolves client options by applying defaults.
+ */
+declare function resolveOptions(options: ClientOptions): ResolvedClientOptions;
+/**
+ * Options for individual requests.
+ */
+interface RequestOptions {
+    /** Request timeout in milliseconds (overrides client default) */
+    timeout?: number;
+    /** Additional headers for this request */
+    headers?: Record<string, string>;
+    /** AbortSignal for request cancellation */
+    signal?: AbortSignal;
+}
+
+/** One parsed Server-Sent-Events frame yielded by {@link ProteosClient.streamEvents}. */
+interface SseFrame {
+    /** The frame `id:` line — Proteos services use the per-stream monotonic seq. */
+    id?: string;
+    /** The frame `event:` line — the named event type. */
+    event?: string;
+    /** The frame `data:` line — the raw payload (typically JSON). */
+    data: string;
+}
+/** Options for opening an SSE stream. */
+interface StreamOptions {
+    /** Abort to tear the stream down (the normal stop path). */
+    signal?: AbortSignal;
+}
+/**
+ * Base HTTP client for all Proteos services.
+ * Handles authentication, request/response formatting, and error handling.
+ */
+declare class ProteosClient {
+    private readonly options;
+    /**
+     * Creates a new ProteosClient instance.
+     *
+     * @param options - Client configuration options
+     *
+     * @example
+     * ```ts
+     * // With static token
+     * const client = new ProteosClient({
+     *   baseUrl: 'https://api.proteos.ai',
+     *   token: 'your-api-token',
+     * });
+     *
+     * // With dynamic token provider
+     * const client = new ProteosClient({
+     *   baseUrl: 'https://api.proteos.ai',
+     *   tokenProvider: async () => {
+     *     return await authService.getAccessToken();
+     *   },
+     * });
+     * ```
+     */
+    constructor(options: ClientOptions);
+    /**
+     * Returns the base URL configured for this client.
+     */
+    get baseUrl(): string;
+    /**
+     * Gets the current authentication token.
+     * Calls tokenProvider if available, otherwise returns static token.
+     */
+    private getToken;
+    /**
+     * Builds the headers for a request.
+     */
+    private buildHeaders;
+    /**
+     * Creates an AbortSignal with timeout.
+     */
+    private createTimeoutSignal;
+    /**
+     * Performs an HTTP request and decodes the JSON response.
+     *
+     * @param method - HTTP method (GET, POST, PATCH, DELETE, etc.)
+     * @param path - Request path (appended to baseUrl)
+     * @param body - Request body (will be JSON-serialized)
+     * @param requestOptions - Optional request configuration
+     * @returns Decoded response body
+     * @throws {ProteosError} If the response status is >= 400
+     */
+    request<T>(method: string, path: string, body?: unknown, requestOptions?: RequestOptions): Promise<T>;
+    /**
+     * Performs an HTTP request with query parameters.
+     *
+     * @param method - HTTP method
+     * @param path - Request path
+     * @param query - Query parameters object
+     * @param body - Request body
+     * @param requestOptions - Optional request configuration
+     * @returns Decoded response body
+     * @throws {ProteosError} If the response status is >= 400
+     */
+    requestWithQuery<T, Q extends object = object>(method: string, path: string, query?: Q, body?: unknown, requestOptions?: RequestOptions): Promise<T>;
+    /**
+     * Performs a multipart form request (for file uploads).
+     *
+     * @param method - HTTP method
+     * @param path - Request path
+     * @param formData - FormData instance with files and fields
+     * @param requestOptions - Optional request configuration
+     * @returns Decoded response body
+     * @throws {ProteosError} If the response status is >= 400
+     */
+    requestMultipart<T>(method: string, path: string, formData: FormData, requestOptions?: RequestOptions): Promise<T>;
+    /**
+     * Performs an HTTP request and returns the raw response.
+     * Used for downloading files or streaming responses.
+     *
+     * @param method - HTTP method
+     * @param path - Request path
+     * @param body - Request body
+     * @param requestOptions - Optional request configuration
+     * @returns Object with response body stream and full Response object
+     * @throws {ProteosError} If the response status is >= 400
+     */
+    requestRaw(method: string, path: string, body?: unknown, requestOptions?: RequestOptions): Promise<{
+        body: ReadableStream<Uint8Array> | null;
+        response: Response;
+    }>;
+    /**
+     * Opens a Server-Sent-Events stream and yields each frame as it arrives.
+     *
+     * Built on `@microsoft/fetch-event-source` (not the browser-native
+     * `EventSource`, which can't set an `Authorization` header) so the bearer token
+     * is attached like any other request. The library tracks `Last-Event-ID` and
+     * reconnects with exponential backoff on transient errors; a 4xx is fatal and
+     * rejects. The stream runs until the caller's `AbortSignal` fires.
+     *
+     * The token is resolved once at stream start; teardown is the caller's signal.
+     *
+     * @param path - Request path (appended to baseUrl)
+     * @param requestOptions - Optional request configuration (signal)
+     * @returns Async generator of parsed {@link SseFrame}s
+     * @throws {ProteosError} On a non-retryable (4xx) response
+     */
+    streamEvents(path: string, requestOptions?: StreamOptions): AsyncGenerator<SseFrame, void, unknown>;
+    /**
+     * Opens an authenticated WebSocket to a service path and resolves once it is
+     * open.
+     *
+     * The browser-native `WebSocket` can't set an `Authorization` header, so the
+     * access token is passed via the `bearer` subprotocol (`["bearer", token]`),
+     * which the gateway lifts back into the auth header — the same token resolved
+     * for every other request. The `http(s)` base URL is rewritten to `ws(s)`.
+     *
+     * @param path - Request path (appended to baseUrl), including any query string
+     * @returns The open WebSocket
+     */
+    openWebSocket(path: string): Promise<WebSocket>;
+}
+
+/**
+ * Pagination metadata from list responses.
+ * Field names match the backend wire format exactly.
+ */
+interface ResponseMeta {
+    /** Current page number (0-indexed across all services). */
+    page: number;
+    /** Number of items per page */
+    page_size: number;
+    /** Total number of items across all pages */
+    items_total: number;
+    /** Total number of pages */
+    pages_total: number;
+}
+/**
+ * Zod schema for ResponseMeta validation.
+ */
+declare const ResponseMetaSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    items_total: z.ZodNumber;
+    pages_total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    page_size: number;
+    items_total: number;
+    pages_total: number;
+}, {
+    page: number;
+    page_size: number;
+    items_total: number;
+    pages_total: number;
+}>;
+/**
+ * Generic paginated response wrapper.
+ */
+interface ListResult<T> {
+    meta: ResponseMeta;
+    data: T[];
+}
+/**
+ * Creates a Zod schema for ListResult with a given item schema.
+ */
+declare function createListResultSchema<T>(itemSchema: z.ZodType<T>): z.ZodObject<{
+    meta: z.ZodObject<{
+        page: z.ZodNumber;
+        page_size: z.ZodNumber;
+        items_total: z.ZodNumber;
+        pages_total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        page: number;
+        page_size: number;
+        items_total: number;
+        pages_total: number;
+    }, {
+        page: number;
+        page_size: number;
+        items_total: number;
+        pages_total: number;
+    }>;
+    data: z.ZodArray<z.ZodType<T, z.ZodTypeDef, T>, "many">;
+}, "strip", z.ZodTypeAny, {
+    meta: {
+        page: number;
+        page_size: number;
+        items_total: number;
+        pages_total: number;
+    };
+    data: T[];
+}, {
+    meta: {
+        page: number;
+        page_size: number;
+        items_total: number;
+        pages_total: number;
+    };
+    data: T[];
+}>;
+/**
+ * Base list options with pagination and sorting.
+ */
+interface ListOptions {
+    /** Page number (0-indexed). First page is 0. */
+    page?: number;
+    /** Number of items per page (default: 100) */
+    page_size?: number;
+    /** Field to sort by */
+    sort_by?: string;
+    /** Sort direction */
+    sort_direction?: 'asc' | 'desc';
+}
+/**
+ * Common timestamp fields for entities.
+ */
+interface Timestamps {
+    /** ISO 8601 timestamp when the entity was created */
+    created_at: string;
+    /** ISO 8601 timestamp when the entity was last updated */
+    updated_at: string;
+}
+/**
+ * The kind of user a {@link UserRef} points at. `person` is a human; `agent`
+ * is an AI actor; `api` is a non-interactive client (reserved). The `"platform"`
+ * sentinel id (system/bootstrap writes) carries `person`.
+ */
+type UserType = 'person' | 'agent' | 'api';
+/**
+ * A reference to a platform user — the value stored by every `user` attribute
+ * (including `created_by`/`updated_by`). `id` is the platform user id (or the
+ * `"platform"` sentinel for system writes); `type` is the user kind. The people
+ * picker resolves and filters on `id`.
+ */
+interface UserRef {
+    type: UserType;
+    id: string;
+}
+/**
+ * Zod schema for a UserRef value.
+ */
+declare const UserRefSchema: 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;
+}>;
+/**
+ * Sentinel id stored in created_by/updated_by for writes that didn't originate
+ * from a real user (bootstrap / system). Mirrors the backend's
+ * `common.PlatformUserId`.
+ */
+declare const PLATFORM_USER_ID = "platform";
+/**
+ * A reference to a stored file — the value stored by every `file` attribute.
+ * `id` is the storage-service file id; `name` is the denormalised filename the
+ * record carries so it has a human label without a storage round-trip. Size and
+ * content type are resolved from the storage-service by `id` on read. Mirrors
+ * the backend's `common.FileRef`.
+ */
+interface FileRef {
+    id: string;
+    name: string;
+}
+/**
+ * Zod schema for a FileRef value.
+ */
+declare const FileRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+}, {
+    id: string;
+    name: string;
+}>;
+/**
+ * Common audit fields for entities. `created_by`/`updated_by` hold a
+ * {@link UserRef} for the user who made the change (the `"platform"` sentinel
+ * id for system writes).
+ */
+interface AuditFields extends Timestamps {
+    /** Who created the entity (the "platform" sentinel id for system writes). */
+    created_by: UserRef;
+    /** Who last updated the entity (the "platform" sentinel id for system writes). */
+    updated_by: UserRef;
+}
+/**
+ * Zod schema for audit fields validation.
+ */
+declare const AuditFieldsSchema: 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;
+    }>;
+}, "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;
+    };
+}, {
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+}>;
+
+/**
+ * Sentinel symbol indicating iteration is complete.
+ */
+declare const DONE: unique symbol;
+type Done = typeof DONE;
+/**
+ * Function type for fetching a page of results.
+ * @typeParam T - The type of items in the list
+ * @typeParam O - The type of options for the list request
+ */
+type ListFn<T, O extends ListOptions> = (options: O) => Promise<ListResult<T>>;
+/**
+ * Default page size for pagination.
+ */
+declare const DEFAULT_PAGE_SIZE = 100;
+/**
+ * Async iterator for paginated resources.
+ * Provides Google Cloud-style iteration with automatic page fetching.
+ *
+ * @typeParam T - The type of items being iterated
+ * @typeParam O - The type of options for list requests
+ *
+ * @example
+ * ```ts
+ * // Using for-await-of
+ * const iterator = new PageIterator(fetchEntities, { page_size: 50 });
+ * for await (const entity of iterator) {
+ *   console.log(entity);
+ * }
+ *
+ * // Using next() directly
+ * const item = await iterator.next();
+ * if (item !== DONE) {
+ *   console.log(item);
+ * }
+ *
+ * // Collecting all items
+ * const allItems = await iterator.all();
+ * ```
+ */
+declare class PageIterator<T, O extends ListOptions> implements AsyncIterable<T> {
+    private readonly listFn;
+    private readonly options;
+    private page;
+    private buffer;
+    private bufferIndex;
+    private pagesTotal;
+    /**
+     * Creates a new PageIterator.
+     *
+     * @param listFn - Function to fetch a page of results
+     * @param options - Options for list requests (including pagination)
+     */
+    constructor(listFn: ListFn<T, O>, options: O);
+    /**
+     * Returns the next item in the iterator.
+     * Returns DONE symbol when iteration is complete.
+     *
+     * @returns The next item or DONE
+     *
+     * @example
+     * ```ts
+     * const item = await iterator.next();
+     * if (item !== DONE) {
+     *   console.log(item);
+     * }
+     * ```
+     */
+    next(): Promise<T | Done>;
+    /**
+     * Collects all remaining items into an array.
+     * Useful when you need all items at once.
+     *
+     * @returns Array of all remaining items
+     *
+     * @example
+     * ```ts
+     * const allEntities = await iterator.all();
+     * console.log(`Found ${allEntities.length} entities`);
+     * ```
+     */
+    all(): Promise<T[]>;
+    /**
+     * Implements AsyncIterable for use with for-await-of loops.
+     *
+     * @example
+     * ```ts
+     * for await (const entity of iterator) {
+     *   console.log(entity.name);
+     * }
+     * ```
+     */
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+/**
+ * Creates a PageIterator with the given list function and options.
+ * Convenience function for creating iterators.
+ *
+ * @param listFn - Function to fetch a page of results
+ * @param options - Options for list requests
+ * @returns A new PageIterator instance
+ */
+declare function createIterator<T, O extends ListOptions>(listFn: ListFn<T, O>, options: O): PageIterator<T, O>;
+
+/**
+ * Service for managing apps.
+ * Apps group menu configurations and other org-scoped metadata under a
+ * stable slug. Slugs are unique per org.
+ */
+interface AppService {
+    /**
+     * Lists apps with optional filtering.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over apps
+     */
+    list(options?: ListAppsOptions): PageIterator<App, ListAppsOptions>;
+    /**
+     * Fetches a single page of apps.
+     */
+    listPage(options?: ListAppsOptions): Promise<ListResult<App>>;
+    /**
+     * Gets a single app by slug.
+     *
+     * @param slug - App slug (unique within the caller's org)
+     * @returns The app
+     * @throws {ProteosError} If app not found (404)
+     */
+    get(slug: string): Promise<App>;
+    /**
+     * Creates a new app.
+     *
+     * @param request - App creation request
+     * @returns The created app
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     */
+    create(request: CreateAppRequest): Promise<App>;
+    /**
+     * Creates or updates an app idempotently by slug. The URL slug wins on
+     * mismatch with the body's slug field (`PUT /meta/v1/apps/:slug`).
+     *
+     * @param slug - App slug
+     * @param request - Full app body
+     * @returns The created or updated app
+     */
+    upsert(slug: string, request: CreateAppRequest): Promise<App>;
+    /**
+     * Updates an existing app.
+     *
+     * @param slug - App slug
+     * @param request - Fields to update
+     * @returns The updated app
+     * @throws {ProteosError} If app not found (404) or validation fails (400)
+     */
+    update(slug: string, request: UpdateAppRequest): Promise<App>;
+    /**
+     * Deletes an app.
+     *
+     * @param slug - App slug
+     * @throws {ProteosError} If app not found (404)
+     */
+    delete(slug: string): Promise<void>;
+}
+
+/**
+ * Service for managing UI component definitions.
+ * Components define reusable UI elements in the system.
+ */
+interface ComponentService {
+    /**
+     * Lists components with optional filtering.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over components
+     */
+    list(options?: ListComponentsOptions): PageIterator<Component, ListComponentsOptions>;
+    /**
+     * Fetches a single page of components.
+     */
+    listPage(options?: ListComponentsOptions): Promise<ListResult<Component>>;
+    /**
+     * Gets a single component by ID.
+     *
+     * @param id - Component ID
+     * @returns The component
+     * @throws {ProteosError} If component not found (404)
+     */
+    get(id: string): Promise<Component>;
+    /**
+     * Creates a new component.
+     *
+     * @param request - Component creation request
+     * @returns The created component
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     */
+    create(request: CreateComponentRequest): Promise<Component>;
+    /**
+     * Creates or updates a component (upsert operation).
+     * If a component with the same slug exists, it is updated; otherwise, a new one is created.
+     *
+     * @param request - Component creation request
+     * @returns The created or updated component
+     */
+    upsert(request: CreateComponentRequest): Promise<Component>;
+    /**
+     * Updates an existing component.
+     *
+     * @param id - Component ID
+     * @param request - Fields to update
+     * @returns The updated component
+     * @throws {ProteosError} If component not found (404) or validation fails (400)
+     */
+    update(id: string, request: UpdateComponentRequest): Promise<Component>;
+    /**
+     * Deletes a component.
+     *
+     * @param id - Component ID
+     * @throws {ProteosError} If component not found (404)
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Returns the URL the component runtime imports to load a component's
+     * compiled ESM bundle (`GET /meta/v1/components/:slug/bundle`). The path is
+     * gateway-prefixed and relative; prepend the API origin to fetch it.
+     *
+     * @param slug - Component slug
+     * @returns The relative bundle URL
+     */
+    bundleUrl(slug: string): string;
+}
+
+/**
+ * Service for managing entity definitions.
+ * Entities define the structure of business objects in the system.
+ */
+interface EntityService {
+    /**
+     * Lists entities with optional filtering.
+     * Returns an async iterator that automatically handles pagination.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over entities
+     *
+     * @example
+     * ```ts
+     * // Iterate over all entities
+     * for await (const entity of service.list()) {
+     *   console.log(entity.slug);
+     * }
+     *
+     * // With filtering
+     * for await (const entity of service.list({ module_slug: 'my-module' })) {
+     *   console.log(entity.name);
+     * }
+     * ```
+     */
+    list(options?: ListEntitiesOptions): PageIterator<Entity, ListEntitiesOptions>;
+    /**
+     * Fetches a single page of entities.
+     *
+     * @param options - Filter and pagination options (including `page`)
+     * @returns A single page of entities with pagination metadata
+     */
+    listPage(options?: ListEntitiesOptions): Promise<ListResult<Entity>>;
+    /**
+     * Lists entities including their JSON Schema representation.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over entities with schema
+     */
+    listWithSchema(options?: ListEntitiesOptions): PageIterator<EntityWithSchema, ListEntitiesOptions>;
+    /**
+     * Fetches a single page of entities with their JSON Schema representation.
+     * Useful for integrating with paginated UI frameworks (e.g. React Query's
+     * useInfiniteQuery) that need direct access to a page's meta and data.
+     *
+     * @param options - Filter and pagination options
+     * @returns A single page of entities with schema
+     */
+    listPageWithSchema(options?: ListEntitiesOptions): Promise<ListResult<EntityWithSchema>>;
+    /**
+     * Gets a single entity by slug.
+     *
+     * @param slug - Entity slug
+     * @returns The entity
+     * @throws {ProteosError} If entity not found (404)
+     */
+    get(slug: string): Promise<Entity>;
+    /**
+     * Gets an entity with its JSON Schema representation.
+     *
+     * @param slug - Entity slug
+     * @returns The entity with schema
+     * @throws {ProteosError} If entity not found (404)
+     */
+    getWithSchema(slug: string): Promise<EntityWithSchema>;
+    /**
+     * Creates a new entity.
+     *
+     * @param request - Entity creation request
+     * @returns The created entity
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     *
+     * @example
+     * ```ts
+     * const entity = await service.create({
+     *   slug: 'customers',
+     *   name: 'Customer',
+     *   description: 'Customer records',
+     *   is_remote: false,
+     *   module_slug: 'crm',
+     *   attributes: [
+     *     { name: 'id', type: 'string', meta: { format: 'uuid' }, label: 'ID', is_required: true, is_unique: true },
+     *     { name: 'name', type: 'string', label: 'Name', is_required: true, is_unique: false },
+     *   ],
+     * });
+     * ```
+     */
+    create(request: CreateEntityRequest): Promise<Entity>;
+    /**
+     * Creates or updates an entity idempotently by slug. The URL slug wins on
+     * mismatch with the body's slug field. Backs the CLI/admin idempotent deploy
+     * path (`PUT /meta/v1/entities/:slug`).
+     *
+     * @param slug - Entity slug
+     * @param request - Full entity body
+     * @returns The created or updated entity
+     */
+    upsert(slug: string, request: CreateEntityRequest): Promise<Entity>;
+    /**
+     * Updates an existing entity.
+     *
+     * @param slug - Entity slug
+     * @param request - Fields to update
+     * @returns The updated entity
+     * @throws {ProteosError} If entity not found (404) or validation fails (400)
+     */
+    update(slug: string, request: UpdateEntityRequest): Promise<Entity>;
+    /**
+     * Deletes an entity.
+     *
+     * @param slug - Entity slug
+     * @throws {ProteosError} If entity not found (404)
+     */
+    delete(slug: string): Promise<void>;
+}
+
+/**
+ * Service for managing list view configurations.
+ * List views define filtered and sorted views of lists.
+ */
+interface ListViewService {
+    /**
+     * Lists list views with optional filtering.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over list views
+     */
+    list(options?: ListListViewsOptions): PageIterator<ListView, ListListViewsOptions>;
+    /**
+     * Fetches a single page of list views.
+     */
+    listPage(options?: ListListViewsOptions): Promise<ListResult<ListView>>;
+    /**
+     * Gets a single list view by slug.
+     *
+     * @param slug - List view slug
+     * @returns The list view
+     * @throws {ProteosError} If list view not found (404)
+     */
+    get(slug: string): Promise<ListView>;
+    /**
+     * Creates a new list view.
+     *
+     * @param request - List view creation request
+     * @returns The created list view
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     */
+    create(request: CreateListViewRequest): Promise<ListView>;
+    /**
+     * Creates or updates a list view (upsert operation).
+     *
+     * @param request - List view creation request
+     * @returns The created or updated list view
+     */
+    upsert(request: CreateListViewRequest): Promise<ListView>;
+    /**
+     * Updates an existing list view.
+     *
+     * @param slug - List view slug
+     * @param request - Fields to update
+     * @returns The updated list view
+     * @throws {ProteosError} If list view not found (404) or validation fails (400)
+     */
+    update(slug: string, request: UpdateListViewRequest): Promise<ListView>;
+    /**
+     * Deletes a list view.
+     *
+     * @param slug - List view slug
+     * @throws {ProteosError} If list view not found (404)
+     */
+    delete(slug: string): Promise<void>;
+}
+
+/**
+ * Service for managing list configurations.
+ * Lists define how data is displayed in tabular format.
+ */
+interface ListService {
+    /**
+     * Lists list configurations with optional filtering.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over lists
+     */
+    list(options?: ListListsOptions): PageIterator<List, ListListsOptions>;
+    /**
+     * Fetches a single page of lists.
+     */
+    listPage(options?: ListListsOptions): Promise<ListResult<List>>;
+    /**
+     * Gets a single list by slug.
+     *
+     * @param slug - List slug
+     * @returns The list
+     * @throws {ProteosError} If list not found (404)
+     */
+    get(slug: string): Promise<List>;
+    /**
+     * Creates a new list.
+     *
+     * @param request - List creation request
+     * @returns The created list
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     */
+    create(request: CreateListRequest): Promise<List>;
+    /**
+     * Creates or updates a list (upsert operation).
+     *
+     * @param request - List creation request
+     * @returns The created or updated list
+     */
+    upsert(request: CreateListRequest): Promise<List>;
+    /**
+     * Updates an existing list.
+     *
+     * @param slug - List slug
+     * @param request - Fields to update
+     * @returns The updated list
+     * @throws {ProteosError} If list not found (404) or validation fails (400)
+     */
+    update(slug: string, request: UpdateListRequest): Promise<List>;
+    /**
+     * Deletes a list.
+     *
+     * @param slug - List slug
+     * @throws {ProteosError} If list not found (404)
+     */
+    delete(slug: string): Promise<void>;
+}
+
+/**
+ * Service for managing menu configurations.
+ * Menu configurations define the navigation structure of applications.
+ */
+interface MenuConfigurationService {
+    /**
+     * Lists menu configurations with optional filtering.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over menu configurations
+     */
+    list(options?: ListMenuConfigurationsOptions): PageIterator<MenuConfiguration, ListMenuConfigurationsOptions>;
+    /**
+     * Fetches a single page of menu configurations.
+     */
+    listPage(options?: ListMenuConfigurationsOptions): Promise<ListResult<MenuConfiguration>>;
+    /**
+     * Gets a single menu configuration by slug.
+     *
+     * @param slug - Menu configuration slug (author-controlled, kebab-case)
+     * @returns The menu configuration
+     * @throws {ProteosError} If menu configuration not found (404)
+     */
+    get(slug: string): Promise<MenuConfiguration>;
+    /**
+     * Creates a new menu configuration.
+     *
+     * @param request - Menu configuration creation request
+     * @returns The created menu configuration
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     */
+    create(request: CreateMenuConfigurationRequest): Promise<MenuConfiguration>;
+    /**
+     * Creates or updates a menu configuration idempotently by slug.
+     *
+     * @param slug - Menu configuration slug
+     * @param request - Body
+     * @returns The created or updated menu configuration
+     */
+    upsert(slug: string, request: CreateMenuConfigurationRequest): Promise<MenuConfiguration>;
+    /**
+     * Updates an existing menu configuration.
+     *
+     * @param slug - Menu configuration slug
+     * @param request - Fields to update
+     * @returns The updated menu configuration
+     * @throws {ProteosError} If menu configuration not found (404) or validation fails (400)
+     */
+    update(slug: string, request: UpdateMenuConfigurationRequest): Promise<MenuConfiguration>;
+    /**
+     * Deletes a menu configuration.
+     *
+     * @param slug - Menu configuration slug
+     * @throws {ProteosError} If menu configuration not found (404)
+     */
+    delete(slug: string): Promise<void>;
+}
+
+/**
+ * Service for managing WebAssembly modules.
+ * Modules contain business logic that runs in the Proteos runtime.
+ */
+interface ModuleService {
+    /**
+     * Lists modules with optional filtering.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over modules
+     */
+    list(options?: ListModulesOptions): PageIterator<Module, ListModulesOptions>;
+    /**
+     * Fetches a single page of modules.
+     */
+    listPage(options?: ListModulesOptions): Promise<ListResult<Module>>;
+    /**
+     * Gets a single module by slug.
+     *
+     * @param slug - Module slug
+     * @returns The module
+     * @throws {ProteosError} If module not found (404)
+     */
+    get(slug: string): Promise<Module>;
+    /**
+     * Deploys a new module.
+     * Uploads a WASM file with metadata.
+     *
+     * @param request - Module metadata
+     * @param file - WASM file (File, Blob, or ArrayBuffer)
+     * @returns The deployed module
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     *
+     * @example
+     * ```ts
+     * const wasmFile = new File([wasmBytes], 'module.wasm');
+     * const module = await service.deploy(
+     *   {
+     *     slug: 'my-module',
+     *     version: '1.0.0',
+     *     name: 'My Module',
+     *     description: 'A custom module',
+     *   },
+     *   wasmFile
+     * );
+     * ```
+     */
+    deploy(request: DeployModuleRequest, file: File | Blob | ArrayBuffer): Promise<Module>;
+    /**
+     * Deletes a module.
+     *
+     * @param slug - Module slug
+     * @throws {ProteosError} If module not found (404)
+     */
+    delete(slug: string): Promise<void>;
+    /**
+     * Activates a deactivated module.
+     *
+     * @param slug - Module slug
+     * @throws {ProteosError} If module not found (404)
+     */
+    activate(slug: string): Promise<void>;
+    /**
+     * Deactivates an active module.
+     *
+     * @param slug - Module slug
+     * @throws {ProteosError} If module not found (404)
+     */
+    deactivate(slug: string): Promise<void>;
+    /**
+     * Downloads the module WASM file.
+     *
+     * @param slug - Module slug
+     * @returns Object containing the readable stream and module metadata
+     * @throws {ProteosError} If module not found (404)
+     *
+     * @example
+     * ```ts
+     * const { body, module } = await service.download('my-module');
+     * const reader = body.getReader();
+     * // Read the stream...
+     * ```
+     */
+    download(slug: string): Promise<{
+        body: ReadableStream<Uint8Array> | null;
+        module: Module;
+    }>;
+}
+
+/**
+ * Service for managing page configurations.
+ * Pages define the layout and content of entity detail views.
+ */
+interface PageService {
+    /**
+     * Lists pages with optional filtering.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over pages
+     */
+    list(options?: ListPagesOptions): PageIterator<Page, ListPagesOptions>;
+    /**
+     * Fetches a single page of page configurations.
+     */
+    listPage(options?: ListPagesOptions): Promise<ListResult<Page>>;
+    /**
+     * Gets a single page by slug.
+     *
+     * @param slug - Page slug (author-controlled, kebab-case, unique per org)
+     * @returns The page
+     * @throws {ProteosError} If page not found (404)
+     */
+    get(slug: string): Promise<Page>;
+    /**
+     * Creates a new page.
+     *
+     * @param request - Page creation request
+     * @returns The created page
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     */
+    create(request: CreatePageRequest): Promise<Page>;
+    /**
+     * Creates or updates a page idempotently by slug. The URL slug wins on
+     * mismatch with the body's slug field.
+     *
+     * @param slug - Page slug
+     * @param request - Page body
+     * @returns The created or updated page
+     */
+    upsert(slug: string, request: CreatePageRequest): Promise<Page>;
+    /**
+     * Updates an existing page.
+     *
+     * @param slug - Page slug
+     * @param request - Fields to update
+     * @returns The updated page
+     * @throws {ProteosError} If page not found (404) or validation fails (400)
+     */
+    update(slug: string, request: UpdatePageRequest): Promise<Page>;
+    /**
+     * Deletes a page.
+     *
+     * @param slug - Page slug
+     * @throws {ProteosError} If page not found (404)
+     */
+    delete(slug: string): Promise<void>;
+}
+
+/**
+ * Service for managing configuration and secret variables.
+ * Variables store key-value pairs scoped to modules.
+ */
+interface VariableService {
+    /**
+     * Lists variables with optional filtering.
+     *
+     * @param options - Filter and pagination options
+     * @returns Async iterator over variables
+     */
+    list(options?: ListVariablesOptions): PageIterator<Variable, ListVariablesOptions>;
+    /**
+     * Fetches a single page of variables.
+     * Useful for paginated UI frameworks (e.g. React Query's useInfiniteQuery).
+     */
+    listPage(options?: ListVariablesOptions): Promise<ListResult<Variable>>;
+    /**
+     * Gets a single variable by ID.
+     *
+     * @param id - Variable ID
+     * @returns The variable
+     * @throws {ProteosError} If variable not found (404)
+     */
+    get(id: string): Promise<Variable>;
+    /**
+     * Creates a new variable.
+     *
+     * @param request - Variable creation request
+     * @returns The created variable
+     * @throws {ProteosError} If validation fails (400) or conflict (409)
+     */
+    create(request: CreateVariableRequest): Promise<Variable>;
+    /**
+     * Updates an existing variable.
+     *
+     * @param id - Variable ID
+     * @param request - Fields to update
+     * @returns The updated variable
+     * @throws {ProteosError} If variable not found (404) or validation fails (400)
+     */
+    update(id: string, request: UpdateVariableRequest): Promise<Variable>;
+    /**
+     * Deletes a variable.
+     *
+     * @param id - Variable ID
+     * @throws {ProteosError} If variable not found (404)
+     */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * All currency codes the runtime knows, sorted and memoized. Sourced from
+ * `Intl.supportedValuesOf` (ES2022). When an attribute's
+ * `allowed_currency_codes` is unset, this is the full selectable set.
+ */
+declare function allCurrencyCodes(): string[];
+/**
+ * Localized display name for a currency code (e.g. `"US Dollar"`), via
+ * `Intl.DisplayNames`. Falls back to the code itself when unavailable.
+ */
+declare function currencyLabel(code: string, locale?: string): string;
+/**
+ * The narrow symbol for a currency code (e.g. `"$"`, `"€"`, `"¥"`), via
+ * `Intl.NumberFormat`'s `narrowSymbol` so it's the bare glyph rather than a
+ * disambiguated form like `"US$"`. Falls back to the code itself.
+ */
+declare function currencySymbol(code: string, locale?: string): string;
+type CurrencySymbolSide = 'prefix' | 'suffix';
+/**
+ * Which side of the amount a currency's symbol sits on. The well-defined rule:
+ * a currency in {@link SUFFIX_SYMBOL_CURRENCIES} suffixes (`"100 €"`), every
+ * other currency prefixes (`"$100"`). Pure and deterministic.
+ */
+declare function currencySymbolSide(code: string): CurrencySymbolSide;
+/**
+ * The grouping (thousands) and decimal separators for a locale — e.g. `de-DE`
+ * → `{ group: ".", decimal: "," }`, `en-US` → `{ group: ",", decimal: "." }`.
+ * Derived from `Intl.NumberFormat.formatToParts` and memoized per locale.
+ */
+declare function localeNumberSeparators(locale?: string): {
+    group: string;
+    decimal: string;
+};
+/**
+ * Render a canonical decimal string in a locale's notation — e.g. `"1234.56"`
+ * → `"1.234,56"` (de) / `"1,234.56"` (en). `grouped: false` omits the thousands
+ * separator (useful while a field is being edited). Precision-preserving: it
+ * splits the string and substitutes separators, never `Number()`.
+ */
+declare function formatAmount(canonical: string, locale?: string, options?: {
+    grouped?: boolean;
+}): string;
+/**
+ * Parse locale-formatted user input back to a canonical decimal string — e.g.
+ * `"1.234,56"` (de) → `"1234.56"`. Strips the locale group separator,
+ * normalizes the locale decimal to `.`, and drops stray characters (symbols,
+ * spaces). Returns `""` for empty/invalid input.
+ */
+declare function parseAmount(input: string, locale?: string): string;
+/**
+ * Format a currency value for read-only display: the symbol placed by currency
+ * convention ({@link currencySymbolSide}) around the amount grouped per the
+ * viewer's locale ({@link formatAmount}). E.g. USD → `"$1,234.56"`, EUR (de
+ * viewer) → `"1.234,56 €"`. Returns a plain `"amount code"` string when the
+ * value can't be formatted.
+ */
+declare function formatMoney(value: CurrencyValue, locale?: string): string;
+
+/**
+ * Logical operator used to combine filter elements/groups.
+ */
+type LogicalOperator = 'and' | 'or';
+/**
+ * Comparison operator for a single filter element. Mirrors
+ * `ComparisonOperator` in `packages/go/model/comparison-operator.go`.
+ */
+type ComparisonOperator = 'eq' | 'gt' | 'lt' | 'gte' | 'lte' | 'ne' | 'in' | 'not_in' | 'contains' | 'starts_with' | 'ends_with' | 'empty' | 'not_empty';
+/**
+ * Single filter element (atomic predicate).
+ *
+ * `value` is a string at the wire level — pipe-joined for `in` / `not_in`,
+ * ignored for `empty` / `not_empty`. This matches the data-service URL query
+ * convention so the same predicate flows through both the GET-with-filters
+ * path and the layout `visible_when` JSONB path without a translation layer.
+ */
+interface FilterElement {
+    field: string;
+    value: string;
+    operator: ComparisonOperator;
+}
+/**
+ * Filter group with logical operator. Groups can be nested.
+ */
+interface FilterGroup {
+    logical_operator: LogicalOperator;
+    elements?: FilterElement[];
+    groups?: FilterGroup[];
+}
+declare const FilterElementSchema: z.ZodObject<{
+    field: z.ZodString;
+    value: z.ZodString;
+    operator: z.ZodEnum<["eq", "gt", "lt", "gte", "lte", "ne", "in", "not_in", "contains", "starts_with", "ends_with", "empty", "not_empty"]>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    field: string;
+    operator: "eq" | "gt" | "lt" | "gte" | "lte" | "ne" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | "empty" | "not_empty";
+}, {
+    value: string;
+    field: string;
+    operator: "eq" | "gt" | "lt" | "gte" | "lte" | "ne" | "in" | "not_in" | "contains" | "starts_with" | "ends_with" | "empty" | "not_empty";
+}>;
+declare const FilterGroupSchema: z.ZodType<FilterGroup>;
+
+/**
+ * SizeValue is a polymorphic sizing value used by `width`, `height`, and the
+ * responsive overrides. Accepted forms:
+ *
+ *   - JSON number in [0, 1] for a fraction (0.5 → 50%)
+ *   - "n/m" fraction string ("1/2", "2/3", ...)
+ *   - "Npx" pixel string
+ *   - "N%" percent string
+ *   - "auto"  — size to content
+ *   - "fill"  — grow to fill remaining space
+ */
+type SizeValue = number | `${number}/${number}` | `${number}px` | `${number}%` | 'auto' | 'fill';
+declare const SizeValueSchema: z.ZodType<SizeValue>;
+
+/**
+ * Cross-axis alignment values. On Row / Column the same string also drives
+ * arrangement of children (cross-axis); on a leaf element it acts as
+ * align-self.
+ */
+type LayoutAlign = 'start' | 'center' | 'end' | 'stretch';
+type LayoutJustify = 'start' | 'center' | 'end' | 'between' | 'around';
+type LayoutGap = 'xs' | 'sm' | 'md' | 'lg';
+/**
+ * Partial sizing knobs reused by ResponsiveSizing.
+ */
+interface SizingProps {
+    width?: SizeValue;
+    height?: SizeValue;
+    grow?: number;
+    shrink?: number;
+    align?: LayoutAlign;
+}
+interface ResponsiveSizing {
+    sm?: SizingProps;
+    md?: SizingProps;
+    lg?: SizingProps;
+}
+/**
+ * Common properties present on every LayoutElement.
+ *
+ * `visible_when` and `read_only_when` reuse the `FilterGroup` predicate model
+ * already used by lists and the data-service URL query convention — same
+ * operators, same and/or composition, same `value: string` (pipe-joined for
+ * `in` / `not_in`).
+ *
+ * `align` here is align-self (override of the parent's cross-axis arrangement
+ * for this child). On Row / Column it is shadowed by an outer `align` whose
+ * semantic is the cross-axis arrangement applied to children.
+ */
+interface CommonProps {
+    id?: string;
+    visible_when?: FilterGroup;
+    read_only_when?: FilterGroup;
+    width?: SizeValue;
+    height?: SizeValue;
+    grow?: number;
+    shrink?: number;
+    align?: LayoutAlign;
+    responsive?: ResponsiveSizing;
+}
+
+declare const BUILT_IN_CONTROLS: readonly string[];
+type BuiltInControlSlug = (typeof BUILT_IN_CONTROLS)[number];
+interface ControlBucket {
+    readonly primary: string | null;
+    readonly compatible: readonly string[];
+}
+/** True when `slug` matches a built-in control. */
+declare function isBuiltInControl(slug: string): boolean;
+/**
+ * Minimal Attribute shape the lookup helpers need. The SDK's full
+ * `Attribute` type extends this; consumers can pass either.
+ */
+interface AttributeForLookup {
+    type: string;
+    meta?: {
+        format?: string;
+        items?: {
+            type?: string;
+        };
+    } | null;
+}
+/**
+ * Resolves the full ControlBucket for an attribute. Walks
+ * type → byFormat[meta.format] (string/datetime) or
+ * type → byItemsType[meta.items.type] (array), falling back to the
+ * type-level entry.
+ *
+ * Returns `{ primary: null, compatible: [] }` when neither the type
+ * nor any narrower bucket matches — including when the attribute type
+ * is unknown to the registry (e.g. legacy wire data).
+ */
+declare function lookupControls(attr: AttributeForLookup): ControlBucket;
+/** Convenience: the primary slug, or null for the read-only fallback. */
+declare function lookupPrimaryControl(attr: AttributeForLookup): string | null;
+/** Convenience: the compatible slug list (empty for the read-only fallback). */
+declare function lookupCompatibleControls(attr: AttributeForLookup): readonly string[];
+
+declare const LayoutElementType: {
+    readonly Row: "row";
+    readonly Column: "column";
+    readonly Section: "section";
+    readonly Tabs: "tabs";
+    readonly Field: "field";
+    readonly RelatedList: "related_list";
+    readonly Component: "component";
+    readonly Divider: "divider";
+    readonly Text: "text";
+};
+type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType];
+type RowElement = CommonProps & {
+    type: 'row';
+    gap?: 'xs' | 'sm' | 'md' | 'lg';
+    /** When true (default), children flow to the next line if they don't fit. */
+    allows_wrap?: boolean;
+    align?: 'start' | 'center' | 'end' | 'stretch';
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around';
+    children: LayoutElement[];
+};
+type ColumnElement = CommonProps & {
+    type: 'column';
+    gap?: 'xs' | 'sm' | 'md' | 'lg';
+    align?: 'start' | 'center' | 'end' | 'stretch';
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around';
+    children: LayoutElement[];
+};
+type SectionElement = CommonProps & {
+    type: 'section';
+    title?: string;
+    description?: string;
+    is_collapsible?: boolean;
+    default_collapsed?: boolean;
+    content: LayoutElement;
+};
+type LayoutTab = {
+    id: string;
+    label: string;
+    icon?: string;
+    visible_when?: FilterGroup;
+    content: LayoutElement;
+};
+type TabsElement = CommonProps & {
+    type: 'tabs';
+    tabs: LayoutTab[];
+    default_tab_id?: string;
+};
+type FieldElement = CommonProps & {
+    type: 'field';
+    attribute: string;
+    label?: string | null;
+    description?: string;
+    placeholder?: string;
+    is_read_only?: boolean;
+    is_required?: boolean;
+    empty_display?: 'dash' | 'hide' | string;
+    control?: string;
+    control_props?: Record<string, unknown>;
+};
+/**
+ * Lists records of `related_entity_slug` that reference the current record
+ * through the `via_attribute` relation attribute. Replaces the pre-LUM-20
+ * `relationshipId` reference — the relation is identified directly by the
+ * attribute on the host entity. `list_slug` optionally pins which list
+ * definition drives the column / sort / filter model; when omitted, the
+ * renderer falls back to the first list configured for the related entity.
+ */
+type RelatedListElement = CommonProps & {
+    type: 'related_list';
+    related_entity_slug: string;
+    via_attribute: string;
+    list_slug?: string;
+};
+type ComponentElement = CommonProps & {
+    type: 'component';
+    component_slug: string;
+    props?: Record<string, unknown>;
+};
+type DividerElement = CommonProps & {
+    type: 'divider';
+};
+type TextVariant = 'heading' | 'subheading' | 'body' | 'caption' | 'callout';
+type TextElement = CommonProps & {
+    type: 'text';
+    variant: TextVariant;
+    content: string;
+};
+type LayoutElement = RowElement | ColumnElement | SectionElement | TabsElement | FieldElement | RelatedListElement | ComponentElement | DividerElement | TextElement;
+declare const LayoutElementSchema: z.ZodType<LayoutElement>;
+
+/**
+ * Side panel slot. Rendered as a sticky-by-default right rail; collapses
+ * below the main column on narrow viewports.
+ */
+interface PageLayoutSidePanel {
+    width?: SizeValue;
+    is_sticky?: boolean;
+    content: LayoutElement;
+}
+declare const PageLayoutSidePanelSchema: z.ZodObject<{
+    width: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
+    is_sticky: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodType<LayoutElement, z.ZodTypeDef, LayoutElement>;
+}, "strip", z.ZodTypeAny, {
+    content: LayoutElement;
+    width?: SizeValue | undefined;
+    is_sticky?: boolean | undefined;
+}, {
+    content: LayoutElement;
+    width?: SizeValue | undefined;
+    is_sticky?: boolean | undefined;
+}>;
+/**
+ * Top-level page layout. Replaces the legacy `mainContent` / `side_panel`
+ * arrays of `PageSection`s with a single typed element tree.
+ */
+interface PageLayout {
+    version: 1;
+    main: LayoutElement;
+    side_panel?: PageLayoutSidePanel;
+}
+declare const PageLayoutSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    main: z.ZodType<LayoutElement, z.ZodTypeDef, LayoutElement>;
+    side_panel: z.ZodOptional<z.ZodObject<{
+        width: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
+        is_sticky: z.ZodOptional<z.ZodBoolean>;
+        content: z.ZodType<LayoutElement, z.ZodTypeDef, LayoutElement>;
+    }, "strip", z.ZodTypeAny, {
+        content: LayoutElement;
+        width?: SizeValue | undefined;
+        is_sticky?: boolean | undefined;
+    }, {
+        content: LayoutElement;
+        width?: SizeValue | undefined;
+        is_sticky?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    main: LayoutElement;
+    side_panel?: {
+        content: LayoutElement;
+        width?: SizeValue | undefined;
+        is_sticky?: boolean | undefined;
+    } | undefined;
+}, {
+    version: 1;
+    main: LayoutElement;
+    side_panel?: {
+        content: LayoutElement;
+        width?: SizeValue | undefined;
+        is_sticky?: boolean | undefined;
+    } | undefined;
+}>;
+
+/**
+ * Client for the Proteos Metadata Service API.
+ * Provides access to all metadata management services.
+ *
+ * @example
+ * ```ts
+ * import { ProteosClient, MetaClient } from 'proteos-sdk';
+ *
+ * const client = new ProteosClient({
+ *   baseUrl: 'https://api.proteos.ai',
+ *   token: 'your-api-token',
+ * });
+ *
+ * const meta = new MetaClient(client);
+ *
+ * // Use services
+ * const entities = await meta.entities.list().all();
+ * const module = await meta.modules.get('my-module');
+ * ```
+ */
+declare class MetaClient {
+    /**
+     * Service for managing entity definitions.
+     */
+    readonly entities: EntityService;
+    /**
+     * Service for managing WebAssembly modules.
+     */
+    readonly modules: ModuleService;
+    /**
+     * Service for managing configuration and secret variables.
+     */
+    readonly variables: VariableService;
+    /**
+     * Service for managing UI component definitions.
+     */
+    readonly components: ComponentService;
+    /**
+     * Service for managing list configurations.
+     */
+    readonly lists: ListService;
+    /**
+     * Service for managing list view configurations.
+     */
+    readonly listViews: ListViewService;
+    /**
+     * Service for managing page configurations.
+     */
+    readonly pages: PageService;
+    /**
+     * Service for managing menu configurations.
+     */
+    readonly menuConfigurations: MenuConfigurationService;
+    /**
+     * Service for managing apps.
+     */
+    readonly apps: AppService;
+    /**
+     * Creates a new MetaClient instance.
+     *
+     * @param client - The base ProteosClient to use for API requests
+     */
+    constructor(client: ProteosClient);
+}
+
+/**
+ * Base list options with source filters for the meta namespace.
+ */
+interface MetaListOptions extends ListOptions {
+    created_by?: string;
+    updated_by?: string;
+}
+/**
+ * Attribute type — canonical to the Go `model.AttributeType` union
+ * (packages/go/model/meta/attribute.go). The members below are the
+ * full set; format/structural variation lives on `Attribute.meta` (see
+ * `AttributeMeta` below), not on the type discriminator.
+ */
+type AttributeType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'datetime' | 'enum' | 'relation' | 'user' | 'currency' | 'knowledge-text' | 'file';
+/** JSON-Schema string formats carried by `string` attributes. */
+type StringFormat = 'email' | 'uri' | 'uuid' | 'hostname' | 'ipv4' | 'ipv6';
+interface StringAttributeMeta {
+    format?: StringFormat;
+    min_length?: number;
+    max_length?: number;
+    pattern?: string;
+}
+interface NumberAttributeMeta {
+    minimum?: number;
+    maximum?: number;
+    exclusive_minimum?: number;
+    exclusive_maximum?: number;
+    multiple_of?: number;
+}
+/** Datetime storage/display behavior. `format` is required. */
+type DatetimeFormat = 'date-time' | 'date' | 'time' | 'duration';
+interface DatetimeAttributeMeta {
+    format: DatetimeFormat;
+    minimum?: string;
+    maximum?: string;
+}
+interface ArrayAttributeMeta {
+    items?: Attribute;
+    min_items?: number;
+    max_items?: number;
+    items_must_be_unique?: boolean;
+}
+interface ObjectAttributeMeta {
+    attributes?: Attribute[];
+}
+interface EnumValue {
+    value: string;
+    label?: string;
+    description?: string;
+}
+interface EnumAttributeMeta {
+    values: EnumValue[];
+}
+/**
+ * Policy applied to the host row when the related row is deleted. Mirror
+ * of `model.OnDeleteAction`. The runtime semantic is enforced at the
+ * data-service level; this metadata declares the intent.
+ */
+type OnDeleteAction = 'cascade' | 'restrict' | 'set-null';
+declare const OnDeleteActionSchema: z.ZodEnum<["cascade", "restrict", "set-null"]>;
+/**
+ * Metadata for a `relation`-typed attribute. The attribute is a foreign-key
+ * column on the host entity pointing at `related_attribute` on
+ * `related_entity_slug`. `predicate` reads from the host outward (e.g. on
+ * `Order.customerId` with `predicate: "is placed by"`, the sentence is
+ * "Order is placed by Customer").
+ */
+interface RelationAttributeMeta {
+    related_entity_slug: string;
+    related_attribute: string;
+    predicate: string;
+    description?: string;
+    on_delete: OnDeleteAction;
+}
+declare const RelationAttributeMetaSchema: z.ZodObject<{
+    related_entity_slug: z.ZodString;
+    related_attribute: z.ZodString;
+    predicate: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    on_delete: z.ZodEnum<["cascade", "restrict", "set-null"]>;
+}, "strip", z.ZodTypeAny, {
+    related_entity_slug: string;
+    related_attribute: string;
+    predicate: string;
+    on_delete: "cascade" | "restrict" | "set-null";
+    description?: string | undefined;
+}, {
+    related_entity_slug: string;
+    related_attribute: string;
+    predicate: string;
+    on_delete: "cascade" | "restrict" | "set-null";
+    description?: string | undefined;
+}>;
+/**
+ * Metadata for a `user`-typed attribute. A user attribute stores a
+ * {@link UserRef} `{ type, id }` (the account-service identity plus its
+ * kind), rendered as a people picker that resolves and filters on `id`. Mirror
+ * of the Go `metamodel.UserAttributeMeta`.
+ *
+ * It carries no required configuration today; the shape exists for parity
+ * with the other metas and reserves room for future options (e.g.
+ * multi-user selection).
+ */
+interface UserAttributeMeta {
+    description?: string;
+}
+declare const UserAttributeMetaSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    description?: string | undefined;
+}, {
+    description?: string | undefined;
+}>;
+/**
+ * The stored value of a `currency`-typed attribute: an exact decimal `amount`
+ * (a STRING, never a JS number — preserves financial-system precision and
+ * trailing zeros) paired with an ISO-4217 `currency_code`. This is the wire
+ * shape; the `@proteos/ui` `CurrencyInput` and the web control both read/write
+ * it directly to avoid an adapter.
+ */
+interface CurrencyValue {
+    amount: string;
+    currency_code: string;
+}
+/**
+ * Metadata for a `currency`-typed attribute. Both fields are optional: when
+ * `allowed_currency_codes` is empty/absent, any ISO-4217 code is accepted;
+ * `default_currency_code` seeds the picker for new values and must be a member
+ * of `allowed_currency_codes` when that allow-list is set. Mirror of the Go
+ * `metamodel.CurrencyAttributeMeta`.
+ */
+interface CurrencyAttributeMeta {
+    default_currency_code?: string;
+    allowed_currency_codes?: string[];
+}
+declare const CurrencyAttributeMetaSchema: z.ZodObject<{
+    default_currency_code: z.ZodOptional<z.ZodString>;
+    allowed_currency_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    default_currency_code?: string | undefined;
+    allowed_currency_codes?: string[] | undefined;
+}, {
+    default_currency_code?: string | undefined;
+    allowed_currency_codes?: string[] | undefined;
+}>;
+/**
+ * Metadata for a `knowledge-text`-typed attribute. The value is a
+ * {@link KnowledgeNodeRef}; the data-service materializes client-sent text
+ * into a knowledge node before persisting. Mirror of the Go
+ * `metamodel.KnowledgeTextAttributeMeta`.
+ *
+ * It carries no required configuration today; the shape exists for parity
+ * with the other metas and reserves room for future options (e.g. node
+ * labels, status overrides).
+ */
+interface KnowledgeTextAttributeMeta {
+    description?: string;
+}
+/**
+ * Metadata for a `file`-typed attribute. The value is a {@link FileRef}
+ * `{ id, name }` referencing a storage-service file; the frontend uploads to
+ * the storage-service and writes the resulting id + name. Mirror of the Go
+ * `metamodel.FileAttributeMeta`.
+ *
+ * It carries no required configuration today; the shape exists for parity with
+ * the other metas and reserves room for future options (e.g. accepted content
+ * types, max size).
+ */
+interface FileAttributeMeta {
+    description?: string;
+}
+declare const FileAttributeMetaSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    description?: string | undefined;
+}, {
+    description?: string | undefined;
+}>;
+/**
+ * Discriminated union of attribute metas. The wire JSON carries the
+ * appropriate shape based on `Attribute.type`; runtime consumers can
+ * narrow via the `type` field.
+ */
+type AttributeMeta = StringAttributeMeta | NumberAttributeMeta | DatetimeAttributeMeta | ArrayAttributeMeta | ObjectAttributeMeta | EnumAttributeMeta | RelationAttributeMeta | UserAttributeMeta | CurrencyAttributeMeta | KnowledgeTextAttributeMeta | FileAttributeMeta;
+/**
+ * Entity attribute definition. Mirrors `model.Attribute` in the Go SDK.
+ */
+interface Attribute {
+    name: string;
+    type: AttributeType;
+    label: string;
+    description?: string;
+    is_required: boolean;
+    is_nullable?: boolean;
+    is_unique: boolean;
+    is_read_only?: boolean;
+    /**
+     * Platform-managed flag. Marks the canonical platform attributes (id,
+     * created_at, updated_at, created_by, updated_by) — auto-added to every
+     * entity, locked in the designer, and rejected from client redefinition.
+     * Mirrors `IsPlatformManaged` in the Go `metamodel.Attribute`.
+     */
+    is_platform_managed?: boolean;
+    default_value?: unknown;
+    /**
+     * Type-specific metadata. The concrete shape is determined by `type`
+     * — e.g. `type: 'string'` carries `StringAttributeMeta`. The wire
+     * field name is `meta`; `options` is an older alias still emitted by
+     * some service paths and accepted for backwards compatibility.
+     */
+    meta?: AttributeMeta;
+    /** @deprecated Older wire alias for `meta`. Prefer `meta`. */
+    options?: Record<string, unknown>;
+}
+/**
+ * Canonical platform attribute names — the system-managed set every entity
+ * carries. Mirrors `metamodel.PlatformAttribute*` constants in the Go model.
+ */
+declare const PLATFORM_ATTRIBUTE_NAMES: readonly ["id", "created_at", "updated_at", "created_by", "updated_by"];
+/** True when `name` is one of the canonical platform attributes. */
+declare function isPlatformAttributeName(name: string): boolean;
+/**
+ * The canonical platform attributes, in display order. Mirror of the Go
+ * `metamodel.PlatformAttributes()`. Used by the entity designer to seed new
+ * entities; the backend re-asserts these on save regardless.
+ */
+declare function platformAttributes(): Attribute[];
+declare const AttributeSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    is_required: z.ZodBoolean;
+    is_nullable: z.ZodOptional<z.ZodBoolean>;
+    is_unique: z.ZodBoolean;
+    is_read_only: z.ZodOptional<z.ZodBoolean>;
+    default_value: z.ZodOptional<z.ZodUnknown>;
+    meta: z.ZodOptional<z.ZodUnknown>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    label: string;
+    is_required: boolean;
+    is_unique: boolean;
+    options?: Record<string, unknown> | undefined;
+    meta?: unknown;
+    description?: string | undefined;
+    is_read_only?: boolean | undefined;
+    is_nullable?: boolean | undefined;
+    default_value?: unknown;
+}, {
+    type: string;
+    name: string;
+    label: string;
+    is_required: boolean;
+    is_unique: boolean;
+    options?: Record<string, unknown> | undefined;
+    meta?: unknown;
+    description?: string | undefined;
+    is_read_only?: boolean | undefined;
+    is_nullable?: boolean | undefined;
+    default_value?: unknown;
+}>;
+/**
+ * Returns the typed `RelationAttributeMeta` when `attr` is a relation
+ * attribute with a valid meta shape; null otherwise. The `AttributeSchema`
+ * intentionally keeps `meta` lax, so callers that need the relation fields
+ * narrowed should go through this helper rather than casting.
+ */
+declare function parseRelationMeta(attr: Attribute): RelationAttributeMeta | null;
+/**
+ * Returns the typed `UserAttributeMeta` when `attr` is a user attribute;
+ * null otherwise. User meta is optional (and usually absent), so a user
+ * attribute with no meta still resolves to an empty `{}` rather than null.
+ */
+declare function parseCurrencyMeta(attr: Attribute): CurrencyAttributeMeta | null;
+declare function parseUserMeta(attr: Attribute): UserAttributeMeta | null;
+/**
+ * Returns the typed `FileAttributeMeta` when `attr` is a file attribute; null
+ * otherwise. File meta is optional (and usually absent), so a file attribute
+ * with no meta still resolves to an empty `{}` rather than null.
+ */
+declare function parseFileMeta(attr: Attribute): FileAttributeMeta | null;
+/**
+ * Entity definition.
+ * Note: Entity uses `slug` as its primary identifier, not `id`.
+ */
+interface Entity extends AuditFields {
+    slug: string;
+    name: string;
+    description: string;
+    is_remote: boolean;
+    module_slug: string;
+    /**
+     * Liquid template that renders a human-readable title for an instance
+     * (record) of this entity — e.g. `{{ first_name }} {{ last_name }}` for a
+     * Customer, `{{ number }}` for an Order. Empty string means "no template
+     * configured"; consumers fall back to the record id.
+     *
+     * Render via `renderRecordTitle(entity, record)` rather than evaluating
+     * the template directly, so the fallback chain stays consistent.
+     */
+    title_template: string;
+    attributes: Attribute[];
+}
+declare const EntitySchema: 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;
+    name: z.ZodString;
+    description: z.ZodString;
+    is_remote: z.ZodBoolean;
+    module_slug: z.ZodString;
+    title_template: z.ZodDefault<z.ZodString>;
+    attributes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        is_required: z.ZodBoolean;
+        is_nullable: z.ZodOptional<z.ZodBoolean>;
+        is_unique: z.ZodBoolean;
+        is_read_only: z.ZodOptional<z.ZodBoolean>;
+        default_value: z.ZodOptional<z.ZodUnknown>;
+        meta: z.ZodOptional<z.ZodUnknown>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        label: string;
+        is_required: boolean;
+        is_unique: boolean;
+        options?: Record<string, unknown> | undefined;
+        meta?: unknown;
+        description?: string | undefined;
+        is_read_only?: boolean | undefined;
+        is_nullable?: boolean | undefined;
+        default_value?: unknown;
+    }, {
+        type: string;
+        name: string;
+        label: string;
+        is_required: boolean;
+        is_unique: boolean;
+        options?: Record<string, unknown> | undefined;
+        meta?: unknown;
+        description?: string | undefined;
+        is_read_only?: boolean | undefined;
+        is_nullable?: boolean | undefined;
+        default_value?: unknown;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    attributes: {
+        type: string;
+        name: string;
+        label: string;
+        is_required: boolean;
+        is_unique: boolean;
+        options?: Record<string, unknown> | undefined;
+        meta?: unknown;
+        description?: string | undefined;
+        is_read_only?: boolean | undefined;
+        is_nullable?: boolean | undefined;
+        default_value?: unknown;
+    }[];
+    slug: string;
+    is_remote: boolean;
+    module_slug: string;
+    title_template: string;
+}, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    attributes: {
+        type: string;
+        name: string;
+        label: string;
+        is_required: boolean;
+        is_unique: boolean;
+        options?: Record<string, unknown> | undefined;
+        meta?: unknown;
+        description?: string | undefined;
+        is_read_only?: boolean | undefined;
+        is_nullable?: boolean | undefined;
+        default_value?: unknown;
+    }[];
+    slug: string;
+    is_remote: boolean;
+    module_slug: string;
+    title_template?: string | undefined;
+}>;
+/**
+ * Entity with JSON Schema representation.
+ */
+interface EntityWithSchema extends Entity {
+    schema: Record<string, unknown>;
+}
+declare const EntityWithSchemaSchema: 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;
+    name: z.ZodString;
+    description: z.ZodString;
+    is_remote: z.ZodBoolean;
+    module_slug: z.ZodString;
+    title_template: z.ZodDefault<z.ZodString>;
+    attributes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        is_required: z.ZodBoolean;
+        is_nullable: z.ZodOptional<z.ZodBoolean>;
+        is_unique: z.ZodBoolean;
+        is_read_only: z.ZodOptional<z.ZodBoolean>;
+        default_value: z.ZodOptional<z.ZodUnknown>;
+        meta: z.ZodOptional<z.ZodUnknown>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        label: string;
+        is_required: boolean;
+        is_unique: boolean;
+        options?: Record<string, unknown> | undefined;
+        meta?: unknown;
+        description?: string | undefined;
+        is_read_only?: boolean | undefined;
+        is_nullable?: boolean | undefined;
+        default_value?: unknown;
+    }, {
+        type: string;
+        name: string;
+        label: string;
+        is_required: boolean;
+        is_unique: boolean;
+        options?: Record<string, unknown> | undefined;
+        meta?: unknown;
+        description?: string | undefined;
+        is_read_only?: boolean | undefined;
+        is_nullable?: boolean | undefined;
+        default_value?: unknown;
+    }>, "many">;
+} & {
+    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    attributes: {
+        type: string;
+        name: string;
+        label: string;
+        is_required: boolean;
+        is_unique: boolean;
+        options?: Record<string, unknown> | undefined;
+        meta?: unknown;
+        description?: string | undefined;
+        is_read_only?: boolean | undefined;
+        is_nullable?: boolean | undefined;
+        default_value?: unknown;
+    }[];
+    slug: string;
+    is_remote: boolean;
+    module_slug: string;
+    title_template: string;
+    schema: Record<string, unknown>;
+}, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    attributes: {
+        type: string;
+        name: string;
+        label: string;
+        is_required: boolean;
+        is_unique: boolean;
+        options?: Record<string, unknown> | undefined;
+        meta?: unknown;
+        description?: string | undefined;
+        is_read_only?: boolean | undefined;
+        is_nullable?: boolean | undefined;
+        default_value?: unknown;
+    }[];
+    slug: string;
+    is_remote: boolean;
+    module_slug: string;
+    schema: Record<string, unknown>;
+    title_template?: string | undefined;
+}>;
+/**
+ * Options for listing entities.
+ */
+interface ListEntitiesOptions extends MetaListOptions {
+    slug?: string;
+    name?: string;
+    is_remote?: boolean;
+    module_slug?: string;
+}
+/**
+ * Request to create an entity.
+ */
+interface CreateEntityRequest {
+    slug: string;
+    name: string;
+    is_remote: boolean;
+    module_slug: string;
+    description: string;
+    title_template?: string;
+    attributes: Attribute[];
+}
+/**
+ * Request to update an entity.
+ */
+interface UpdateEntityRequest {
+    name?: string;
+    is_remote?: boolean;
+    module_slug?: string;
+    description?: string;
+    title_template?: string;
+    attributes?: Attribute[];
+}
+/**
+ * Module deployment status.
+ */
+type ModuleStatus = 'pending' | 'deploying' | 'active' | 'failed' | 'deactivating' | 'inactive';
+/**
+ * Module definition.
+ */
+interface Module extends AuditFields {
+    slug: string;
+    org_id: string;
+    name: string;
+    description: string;
+    version: string;
+    file_id: string;
+    status: ModuleStatus;
+    status_details: string;
+    is_deactivated: boolean;
+}
+declare const ModuleSchema: 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;
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    file_id: z.ZodString;
+    status: z.ZodEnum<["pending", "deploying", "active", "failed", "deactivating", "inactive"]>;
+    status_details: z.ZodString;
+    is_deactivated: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "deploying" | "active" | "failed" | "deactivating" | "inactive";
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    version: string;
+    slug: string;
+    file_id: string;
+    status_details: string;
+    is_deactivated: boolean;
+}, {
+    status: "pending" | "deploying" | "active" | "failed" | "deactivating" | "inactive";
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    version: string;
+    slug: string;
+    file_id: string;
+    status_details: string;
+    is_deactivated: boolean;
+}>;
+/**
+ * Options for listing modules.
+ */
+interface ListModulesOptions extends MetaListOptions {
+    slug?: string;
+    name?: string;
+    is_deactivated?: boolean;
+    file_id?: string;
+    status?: ModuleStatus;
+    version?: string;
+}
+/**
+ * Request to deploy a module.
+ */
+interface DeployModuleRequest {
+    slug: string;
+    version: string;
+    name: string;
+    description: string;
+}
+/**
+ * Configuration/secret variable.
+ */
+interface Variable extends AuditFields {
+    id: string;
+    org_id: string;
+    key: string;
+    value: string;
+    is_secret: boolean;
+    module: string;
+}
+declare const VariableSchema: 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;
+    }>;
+} & {
+    id: z.ZodString;
+    key: z.ZodString;
+    value: z.ZodString;
+    is_secret: z.ZodBoolean;
+    module: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    value: string;
+    id: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    is_secret: boolean;
+    module: string;
+}, {
+    key: string;
+    value: string;
+    id: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    is_secret: boolean;
+    module: string;
+}>;
+/**
+ * Options for listing variables.
+ */
+interface ListVariablesOptions extends MetaListOptions {
+    id?: string;
+    key?: string;
+    is_secret?: boolean;
+    module?: string;
+}
+/**
+ * Request to create a variable.
+ */
+interface CreateVariableRequest {
+    key: string;
+    value: string;
+    is_secret: boolean;
+    module: string;
+}
+/**
+ * Request to update a variable.
+ */
+interface UpdateVariableRequest {
+    value?: string;
+}
+/**
+ * UI component definition.
+ * Note: Component uses `slug` as its primary identifier, not `id`.
+ */
+interface Component extends AuditFields {
+    slug: string;
+    org_id: string;
+    name: string;
+    description: string;
+    module_slug: string;
+    /** FK to the compiled, single-file ESM bundle in storage. Empty until deployed. Served via {@link ComponentService.bundleUrl}. */
+    bundle_file_id: string;
+    /** FK to a tar.gz of the component source directory in storage (provenance / rebuild). Empty until deployed. */
+    source_file_id: string;
+    /** The component's JSON Schema, driving the page-designer props editor + runtime validation. `null` until set. */
+    props_schema: Record<string, unknown> | null;
+}
+declare const ComponentSchema: 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;
+    name: z.ZodString;
+    description: z.ZodString;
+    module_slug: z.ZodString;
+    bundle_file_id: z.ZodString;
+    source_file_id: z.ZodString;
+    props_schema: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    slug: string;
+    module_slug: string;
+    bundle_file_id: string;
+    source_file_id: string;
+    props_schema: Record<string, unknown> | null;
+}, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    slug: string;
+    module_slug: string;
+    bundle_file_id: string;
+    source_file_id: string;
+    props_schema: Record<string, unknown> | null;
+}>;
+/**
+ * Options for listing components.
+ */
+interface ListComponentsOptions extends MetaListOptions {
+    slug?: string;
+    name?: string;
+    module_slug?: string;
+}
+/**
+ * Request to create a component.
+ */
+interface CreateComponentRequest {
+    slug: string;
+    name: string;
+    module_slug: string;
+    description: string;
+    bundle_file_id?: string;
+    source_file_id?: string;
+    props_schema?: Record<string, unknown>;
+}
+/**
+ * Request to update a component.
+ */
+interface UpdateComponentRequest {
+    name?: string;
+    description?: string;
+    bundle_file_id?: string;
+    source_file_id?: string;
+    props_schema?: Record<string, unknown>;
+}
+/**
+ * List column definition.
+ */
+interface Column {
+    attribute: string;
+    label: string;
+    width: number;
+}
+/**
+ * Sort direction.
+ */
+type SortDirection = 'asc' | 'desc';
+/**
+ * Sort configuration.
+ */
+interface SortConfig {
+    attribute: string;
+    direction: SortDirection;
+}
+
+/**
+ * List configuration.
+ * Note: List uses `slug` as its primary identifier, not `id`.
+ */
+interface List extends AuditFields {
+    slug: string;
+    org_id: string;
+    module_slug: string;
+    name: string;
+    entity_slug: string;
+    columns: Column[];
+    sorting: SortConfig[];
+    filters: FilterGroup[];
+}
+declare const ColumnSchema: z.ZodObject<{
+    attribute: z.ZodString;
+    label: z.ZodString;
+    width: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    width: number;
+    label: string;
+    attribute: string;
+}, {
+    width: number;
+    label: string;
+    attribute: string;
+}>;
+declare const SortConfigSchema: z.ZodObject<{
+    attribute: z.ZodString;
+    direction: z.ZodEnum<["asc", "desc"]>;
+}, "strip", z.ZodTypeAny, {
+    attribute: string;
+    direction: "asc" | "desc";
+}, {
+    attribute: string;
+    direction: "asc" | "desc";
+}>;
+declare const ListSchema: 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;
+    module_slug: z.ZodString;
+    name: z.ZodString;
+    entity_slug: z.ZodString;
+    columns: z.ZodArray<z.ZodObject<{
+        attribute: z.ZodString;
+        label: z.ZodString;
+        width: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        label: string;
+        attribute: string;
+    }, {
+        width: number;
+        label: string;
+        attribute: string;
+    }>, "many">;
+    sorting: z.ZodArray<z.ZodObject<{
+        attribute: z.ZodString;
+        direction: z.ZodEnum<["asc", "desc"]>;
+    }, "strip", z.ZodTypeAny, {
+        attribute: string;
+        direction: "asc" | "desc";
+    }, {
+        attribute: string;
+        direction: "asc" | "desc";
+    }>, "many">;
+    filters: z.ZodArray<z.ZodType<FilterGroup, z.ZodTypeDef, FilterGroup>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    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;
+    entity_slug: string;
+    columns: {
+        width: number;
+        label: string;
+        attribute: string;
+    }[];
+    sorting: {
+        attribute: string;
+        direction: "asc" | "desc";
+    }[];
+    filters: FilterGroup[];
+}, {
+    name: string;
+    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;
+    entity_slug: string;
+    columns: {
+        width: number;
+        label: string;
+        attribute: string;
+    }[];
+    sorting: {
+        attribute: string;
+        direction: "asc" | "desc";
+    }[];
+    filters: FilterGroup[];
+}>;
+/**
+ * Options for listing lists.
+ */
+interface ListListsOptions extends MetaListOptions {
+    slug?: string;
+    name?: string;
+    module_slug?: string;
+    entity_slug?: string;
+}
+/**
+ * Request to create a list.
+ */
+interface CreateListRequest {
+    slug: string;
+    module_slug?: string;
+    entity_slug: string;
+    name: string;
+    columns: Column[];
+    sorting: SortConfig[];
+    filters: FilterGroup[];
+}
+/**
+ * Request to update a list.
+ */
+interface UpdateListRequest {
+    name?: string;
+    module_slug?: string;
+    columns?: Column[];
+    sorting?: SortConfig[];
+    filters?: FilterGroup[];
+}
+/**
+ * List view configuration.
+ * Note: ListView uses `slug` as its primary identifier, not `id`.
+ */
+interface ListView extends AuditFields {
+    slug: string;
+    org_id: string;
+    module_slug: string;
+    list_slug: string;
+    name: string;
+    columns: Column[];
+    sorting: SortConfig[];
+    filters: FilterGroup[];
+}
+declare const ListViewSchema: 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;
+    module_slug: z.ZodString;
+    list_slug: z.ZodString;
+    name: z.ZodString;
+    columns: z.ZodArray<z.ZodObject<{
+        attribute: z.ZodString;
+        label: z.ZodString;
+        width: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        label: string;
+        attribute: string;
+    }, {
+        width: number;
+        label: string;
+        attribute: string;
+    }>, "many">;
+    sorting: z.ZodArray<z.ZodObject<{
+        attribute: z.ZodString;
+        direction: z.ZodEnum<["asc", "desc"]>;
+    }, "strip", z.ZodTypeAny, {
+        attribute: string;
+        direction: "asc" | "desc";
+    }, {
+        attribute: string;
+        direction: "asc" | "desc";
+    }>, "many">;
+    filters: z.ZodArray<z.ZodType<FilterGroup, z.ZodTypeDef, FilterGroup>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    list_slug: string;
+    slug: string;
+    module_slug: string;
+    columns: {
+        width: number;
+        label: string;
+        attribute: string;
+    }[];
+    sorting: {
+        attribute: string;
+        direction: "asc" | "desc";
+    }[];
+    filters: FilterGroup[];
+}, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    list_slug: string;
+    slug: string;
+    module_slug: string;
+    columns: {
+        width: number;
+        label: string;
+        attribute: string;
+    }[];
+    sorting: {
+        attribute: string;
+        direction: "asc" | "desc";
+    }[];
+    filters: FilterGroup[];
+}>;
+/**
+ * Options for listing list views.
+ */
+interface ListListViewsOptions extends MetaListOptions {
+    slug?: string;
+    name?: string;
+    module_slug?: string;
+    list_slug?: string;
+}
+/**
+ * Request to create a list view.
+ */
+interface CreateListViewRequest {
+    slug: string;
+    module_slug?: string;
+    list_slug: string;
+    name: string;
+    columns: Column[];
+    sorting?: SortConfig[];
+    filters?: FilterGroup[];
+}
+/**
+ * Request to update a list view.
+ */
+interface UpdateListViewRequest {
+    name?: string;
+    module_slug?: string;
+    columns?: Column[];
+    sorting?: SortConfig[];
+    filters?: FilterGroup[];
+}
+/**
+ * Page action definition. Page-level toolbar item; addressed by permissions
+ * and shortcuts systems.
+ */
+interface PageAction {
+    label: string;
+    icon: string;
+    action: string;
+}
+declare const PageActionSchema: z.ZodObject<{
+    label: z.ZodString;
+    icon: z.ZodString;
+    action: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    icon: string;
+    action: string;
+}, {
+    label: string;
+    icon: string;
+    action: string;
+}>;
+/**
+ * Page type. `record` pages render against a single record of `entity_slug`;
+ * `platform` pages are standalone (no record context — e.g. a dashboard
+ * launched from a menu item). `external` is reserved for a future chromeless
+ * variant and is not yet accepted by the API.
+ */
+type PageType = 'record' | 'platform';
+/**
+ * Page configuration. A `record` page is the detail-page shape for a single
+ * entity; a `platform` page is standalone (no entity, no record).
+ *
+ * `layout` is a typed tree of LayoutElements (see `./layout`). The legacy
+ * `mainContent` / `side_panel` / `formLayout` shape was replaced in the
+ * v1 PageLayout design.
+ */
+interface Page extends AuditFields {
+    slug: string;
+    name: string;
+    module_slug: string;
+    type: PageType;
+    /** Required for `record` pages; absent on `platform` pages. */
+    entity_slug?: string;
+    actions: PageAction[];
+    layout: PageLayout;
+}
+declare const PageSchema: 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;
+    name: z.ZodString;
+    module_slug: z.ZodString;
+    type: z.ZodEnum<["record", "platform"]>;
+    entity_slug: z.ZodOptional<z.ZodString>;
+    actions: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        icon: z.ZodString;
+        action: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        icon: string;
+        action: string;
+    }, {
+        label: string;
+        icon: string;
+        action: string;
+    }>, "many">;
+    layout: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        main: z.ZodType<LayoutElement, z.ZodTypeDef, LayoutElement>;
+        side_panel: z.ZodOptional<z.ZodObject<{
+            width: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
+            is_sticky: z.ZodOptional<z.ZodBoolean>;
+            content: z.ZodType<LayoutElement, z.ZodTypeDef, LayoutElement>;
+        }, "strip", z.ZodTypeAny, {
+            content: LayoutElement;
+            width?: SizeValue | undefined;
+            is_sticky?: boolean | undefined;
+        }, {
+            content: LayoutElement;
+            width?: SizeValue | undefined;
+            is_sticky?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        version: 1;
+        main: LayoutElement;
+        side_panel?: {
+            content: LayoutElement;
+            width?: SizeValue | undefined;
+            is_sticky?: boolean | undefined;
+        } | undefined;
+    }, {
+        version: 1;
+        main: LayoutElement;
+        side_panel?: {
+            content: LayoutElement;
+            width?: SizeValue | undefined;
+            is_sticky?: boolean | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "platform" | "record";
+    name: string;
+    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;
+    actions: {
+        label: string;
+        icon: string;
+        action: string;
+    }[];
+    layout: {
+        version: 1;
+        main: LayoutElement;
+        side_panel?: {
+            content: LayoutElement;
+            width?: SizeValue | undefined;
+            is_sticky?: boolean | undefined;
+        } | undefined;
+    };
+    entity_slug?: string | undefined;
+}, {
+    type: "platform" | "record";
+    name: string;
+    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;
+    actions: {
+        label: string;
+        icon: string;
+        action: string;
+    }[];
+    layout: {
+        version: 1;
+        main: LayoutElement;
+        side_panel?: {
+            content: LayoutElement;
+            width?: SizeValue | undefined;
+            is_sticky?: boolean | undefined;
+        } | undefined;
+    };
+    entity_slug?: string | undefined;
+}>;
+/**
+ * Options for listing pages.
+ */
+interface ListPagesOptions extends MetaListOptions {
+    slug?: string;
+    name?: string;
+    module_slug?: string;
+    type?: PageType;
+    entity_slug?: string;
+}
+/**
+ * Request to create a page. `type` defaults to `record` when omitted.
+ * `entity_slug` is required for record pages and must be absent for platform
+ * pages.
+ */
+interface CreatePageRequest {
+    slug: string;
+    name: string;
+    module_slug?: string;
+    type?: PageType;
+    entity_slug?: string;
+    actions: PageAction[];
+    layout: PageLayout;
+}
+/**
+ * Request to update a page. Layout, when present, must be a complete valid
+ * tree — partial / element-level patches are not supported.
+ */
+interface UpdatePageRequest {
+    name?: string;
+    module_slug?: string;
+    actions?: PageAction[];
+    layout?: PageLayout;
+}
+/**
+ * Menu item type values. Use as both enum-like constant and type union.
+ */
+declare const MenuItemType: {
+    readonly Link: "link";
+    readonly Group: "group";
+    readonly Entity: "entity";
+    readonly Page: "page";
+    readonly List: "list";
+};
+type MenuItemType = (typeof MenuItemType)[keyof typeof MenuItemType];
+/**
+ * Menu item definition. Matches the backend JSON shape for nested menus.
+ */
+interface MenuItem {
+    id: string;
+    order: number;
+    label: string;
+    type: MenuItemType;
+    icon: string;
+    reference?: string;
+    children: MenuItem[] | null;
+}
+/**
+ * Menu configuration.
+ */
+interface MenuConfiguration extends AuditFields {
+    slug: string;
+    name: string;
+    module_slug: string;
+    app_slug: string;
+    items: MenuItem[];
+    is_default: boolean;
+}
+declare const MenuItemSchema: z.ZodType<MenuItem>;
+declare const MenuConfigurationSchema: 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;
+    name: z.ZodString;
+    module_slug: z.ZodString;
+    app_slug: z.ZodString;
+    items: z.ZodArray<z.ZodType<MenuItem, z.ZodTypeDef, MenuItem>, "many">;
+    is_default: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    items: MenuItem[];
+    slug: string;
+    module_slug: string;
+    app_slug: string;
+    is_default: boolean;
+}, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    items: MenuItem[];
+    slug: string;
+    module_slug: string;
+    app_slug: string;
+    is_default: boolean;
+}>;
+/**
+ * Options for listing menu configurations.
+ */
+interface ListMenuConfigurationsOptions extends MetaListOptions {
+    slug?: string;
+    name?: string;
+    module_slug?: string;
+    app_slug?: string;
+    is_default?: boolean;
+}
+/**
+ * Request to create a menu configuration.
+ */
+interface CreateMenuConfigurationRequest {
+    slug: string;
+    module_slug?: string;
+    name: string;
+    app_slug: string;
+    items: MenuItem[];
+    is_default: boolean;
+}
+/**
+ * Request to update a menu configuration.
+ */
+interface UpdateMenuConfigurationRequest {
+    name?: string;
+    module_slug?: string;
+    items?: MenuItem[];
+    is_default?: boolean;
+}
+/**
+ * App definition. Apps group menu configurations and other org-scoped
+ * metadata under a stable slug. Slug is unique per org (composite key
+ * `(org_id, slug)`).
+ */
+interface App extends AuditFields {
+    slug: string;
+    org_id: string;
+    module_slug: string;
+    name: string;
+    description: string;
+    icon_slug: string;
+}
+declare const AppSchema: 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;
+    name: z.ZodString;
+    description: z.ZodString;
+    icon_slug: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    slug: string;
+    module_slug: string;
+    org_id: string;
+    icon_slug: string;
+}, {
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    slug: string;
+    module_slug: string;
+    org_id: string;
+    icon_slug: string;
+}>;
+/**
+ * Options for listing apps.
+ */
+interface ListAppsOptions extends MetaListOptions {
+    slug?: string;
+    name?: string;
+    module_slug?: string;
+    icon_slug?: string;
+}
+/**
+ * Request to create an app.
+ */
+interface CreateAppRequest {
+    slug: string;
+    module_slug?: string;
+    name: string;
+    icon_slug: string;
+    description?: string;
+}
+/**
+ * Request to update an app. Slug and org_id are immutable.
+ */
+interface UpdateAppRequest {
+    name?: string;
+    module_slug?: string;
+    description?: string;
+    icon_slug?: string;
+}
+
+export { type ListFn as $, type AuditFields as A, type CurrencyValue as B, type ClientOptions as C, DEFAULT_OPTIONS as D, DEFAULT_PAGE_SIZE as E, type FileRef as F, DONE as G, type DeployModuleRequest as H, type Done as I, type Entity as J, EntitySchema as K, type ListOptions as L, type EntityService as M, type EntityWithSchema as N, EntityWithSchemaSchema as O, PageIterator as P, type FileAttributeMeta as Q, FileRefSchema as R, type FilterElement as S, FilterElementSchema as T, type UserRef as U, type FilterGroup as V, FilterGroupSchema as W, type List as X, type ListAppsOptions as Y, type ListComponentsOptions as Z, type ListEntitiesOptions as _, type Attribute as a, currencySymbol as a$, type ListListViewsOptions as a0, type ListListsOptions as a1, type ListMenuConfigurationsOptions as a2, type ListModulesOptions as a3, type ListPagesOptions as a4, ListSchema as a5, type ListService as a6, type ListVariablesOptions as a7, type ListView as a8, ListViewSchema as a9, RelationAttributeMetaSchema as aA, type RequestOptions as aB, type ResolvedClientOptions as aC, type ResponseMeta as aD, ResponseMetaSchema as aE, type SortConfig as aF, SortConfigSchema as aG, type SortDirection as aH, type Timestamps as aI, type TokenProvider as aJ, type UpdateAppRequest as aK, type UpdateComponentRequest as aL, type UpdateEntityRequest as aM, type UpdateListRequest as aN, type UpdateListViewRequest as aO, type UpdateMenuConfigurationRequest as aP, type UpdatePageRequest as aQ, type UpdateVariableRequest as aR, UserRefSchema as aS, type UserType as aT, type Variable as aU, VariableSchema as aV, type VariableService as aW, allCurrencyCodes as aX, createIterator as aY, createListResultSchema as aZ, currencyLabel as a_, type ListViewService as aa, type LogicalOperator as ab, type MenuConfiguration as ac, MenuConfigurationSchema as ad, type MenuConfigurationService as ae, type MenuItem as af, MenuItemSchema as ag, MenuItemType as ah, MetaClient as ai, type MetaListOptions as aj, type Module as ak, ModuleSchema as al, type ModuleService as am, type ModuleStatus as an, type OnDeleteAction as ao, OnDeleteActionSchema as ap, PLATFORM_ATTRIBUTE_NAMES as aq, PLATFORM_USER_ID as ar, type Page as as, type PageAction as at, PageActionSchema as au, type PageLayout as av, PageLayoutSchema as aw, PageSchema as ax, type PageService as ay, type RelationAttributeMeta as az, type ListResult as b, currencySymbolSide as b0, formatAmount as b1, formatMoney as b2, isPlatformAttributeName as b3, localeNumberSeparators as b4, parseAmount as b5, parseCurrencyMeta as b6, parseFileMeta as b7, parseRelationMeta as b8, platformAttributes as b9, type PageLayoutSidePanel as bA, PageLayoutSidePanelSchema as bB, type RelatedListElement as bC, type ResponsiveSizing as bD, type RowElement as bE, type SectionElement as bF, type SizeValue as bG, SizeValueSchema as bH, type SizingProps as bI, type StringAttributeMeta as bJ, type StringFormat as bK, type TabsElement as bL, type TextElement as bM, type TextVariant as bN, type UserAttributeMeta as bO, UserAttributeMetaSchema as bP, isBuiltInControl as bQ, lookupCompatibleControls as bR, lookupControls as bS, lookupPrimaryControl as bT, parseUserMeta as bU, resolveOptions as ba, type ArrayAttributeMeta as bb, type AttributeForLookup as bc, type AttributeMeta as bd, BUILT_IN_CONTROLS as be, type BuiltInControlSlug as bf, type ColumnElement as bg, type CommonProps as bh, type ComponentElement as bi, type ControlBucket as bj, type DatetimeAttributeMeta as bk, type DatetimeFormat as bl, type DividerElement as bm, type EnumAttributeMeta as bn, type EnumValue as bo, type FieldElement as bp, FileAttributeMetaSchema as bq, type LayoutAlign as br, type LayoutElement as bs, LayoutElementSchema as bt, LayoutElementType as bu, type LayoutGap as bv, type LayoutJustify as bw, type LayoutTab as bx, type NumberAttributeMeta as by, type ObjectAttributeMeta as bz, ProteosClient as c, type App as d, AppSchema as e, type AppService as f, AttributeSchema as g, type AttributeType as h, AuditFieldsSchema as i, type Column as j, ColumnSchema as k, type ComparisonOperator as l, type Component as m, ComponentSchema as n, type ComponentService as o, type CreateAppRequest as p, type CreateComponentRequest as q, type CreateEntityRequest as r, type CreateListRequest as s, type CreateListViewRequest as t, type CreateMenuConfigurationRequest as u, type CreatePageRequest as v, type CreateVariableRequest as w, type CurrencyAttributeMeta as x, CurrencyAttributeMetaSchema as y, type CurrencySymbolSide as z };