@yaklabs-ai/plugin-protocol 0.45.0 → 0.47.0

package/dist/index.d.ts

@@ -11,6 +11,60 @@ export declare const AccessApprovalReview: z.ZodObject<{
 
 export declare type AccessApprovalReview = z.infer<typeof AccessApprovalReview>;
 
+/**
+ * Action binding — maps an event to an action invocation.
+ *
+ * Used inside the `on` field of a UIElement:
+ * ```json
+ * { "on": { "press": { "action": "setState", "params": { "statePath": "/x", "value": 1 } } } }
+ * ```
+ */
+declare interface ActionBinding {
+    /** Action name (must be in catalog) */
+    action: string;
+    /** Parameters to pass to the action handler */
+    params?: Record<string, DynamicValue>;
+    /** Confirmation dialog before execution */
+    confirm?: ActionConfirm;
+    /** Handler after successful execution */
+    onSuccess?: ActionOnSuccess;
+    /** Handler after failed execution */
+    onError?: ActionOnError;
+    /** Whether to prevent default browser behavior (e.g. navigation on links) */
+    preventDefault?: boolean;
+}
+
+/**
+ * Confirmation dialog configuration
+ */
+declare interface ActionConfirm {
+    title: string;
+    message: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    variant?: "default" | "danger";
+}
+
+/**
+ * Action error handler
+ */
+declare type ActionOnError = {
+    set: Record<string, unknown>;
+} | {
+    action: string;
+};
+
+/**
+ * Action success handler
+ */
+declare type ActionOnSuccess = {
+    navigate: string;
+} | {
+    set: Record<string, unknown>;
+} | {
+    action: string;
+};
+
 export declare const AdapterPlacement: z.ZodEnum<{
     "local-only": "local-only";
     anywhere: "anywhere";
@@ -76,6 +130,15 @@ export declare const AgentToolContribution: z.ZodObject<{
 
 export declare type AgentToolContribution = z.infer<typeof AgentToolContribution>;
 
+/**
+ * AND wrapper — all child conditions must be true.
+ * This is the explicit form of the implicit array AND (`SingleCondition[]`).
+ * Unlike the implicit form, `$and` supports nested `$or` and `$and` conditions.
+ */
+declare type AndCondition = {
+    $and: VisibilityCondition[];
+};
+
 export declare const AppDataMaterializerContribution: z.ZodObject<{
     source: z.ZodString;
 }, z.core.$strict>;
@@ -1642,6 +1705,8 @@ declare namespace authoringCommonSchemas {
 
 declare namespace authoringContributionSchemas {
     export {
+        isUiAppSourceModule,
+        uiAppSourceStylePath,
         MCP_SIGN_IN_SCHEME_KIND,
         PLUGIN_NOTIFICATION_RULE_HOST_KEYS,
         ApprovalCardForm,
@@ -1685,8 +1750,6 @@ declare namespace authoringContributionSchemas {
         SessionReaderContribution,
         UiCommandContribution,
         UiSlotContribution,
-        SettingsPanelContribution,
-        ResultRendererContribution,
         ReferenceOpenBehavior,
         ReferencePresentationVariant,
         ReferencePresentationVariants,
@@ -1694,9 +1757,9 @@ declare namespace authoringContributionSchemas {
         ReferencePresentationUrlClaim,
         ReferencePresentationTooltip,
         ReferencePresentationAddress,
+        ReferencePresentationAccountLinks,
         ReferencePresentationWords,
         ReferencePresentationContribution,
-        RichViewContribution,
         KayUiAppHostCapability,
         UiAppCapabilities,
         UiRailEntryContribution,
@@ -1708,7 +1771,9 @@ declare namespace authoringContributionSchemas {
         CommandContribution,
         PluginContributionKind,
         canonicalContributionSchemas,
-        PluginCardResult
+        PluginCardResult,
+        PluginCardReadResult,
+        PluginCardSubmitResult
     }
 }
 
@@ -2095,6 +2160,7 @@ declare const canonicalContributionSchemas: {
         authScheme: z.ZodOptional<z.ZodString>;
         knownResources: z.ZodOptional<z.ZodLiteral<true>>;
         describesOperations: z.ZodOptional<z.ZodLiteral<true>>;
+        looksUpWebLinks: z.ZodOptional<z.ZodLiteral<true>>;
         claims: z.ZodExactOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"scheme">;
             scheme: z.ZodString;
@@ -2445,9 +2511,6 @@ declare const canonicalContributionSchemas: {
             bodyField: z.ZodString;
         }, z.core.$strict>], "kind">;
         valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
-        presentation: z.ZodOptional<z.ZodObject<{
-            app: z.ZodString;
-        }, z.core.$strict>>;
     }, z.core.$strict>;
     AppDataMaterializerContribution: z.ZodObject<{
         source: z.ZodString;
@@ -2608,7 +2671,7 @@ declare const canonicalContributionSchemas: {
     PluginNotificationRuleContribution: z.ZodObject<{
         localId: z.ZodString;
         event: z.ZodString;
-        where: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
+        where: z.ZodOptional<z.ZodString>;
         rule: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
     }, z.core.$strict>;
     PluginProductEventContribution: z.ZodUnion<readonly [z.ZodObject<{
@@ -2659,15 +2722,6 @@ declare const canonicalContributionSchemas: {
         slot: z.ZodString;
         title: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
-    SettingsPanelContribution: z.ZodObject<{
-        localId: z.ZodString;
-        title: z.ZodString;
-        configSection: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-    ResultRendererContribution: z.ZodObject<{
-        localId: z.ZodString;
-        resultKinds: z.ZodArray<z.ZodString>;
-    }, z.core.$strict>;
     ReferenceOpenBehavior: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"working-document">;
     }, z.core.$strict>, z.ZodObject<{
@@ -2675,6 +2729,9 @@ declare const canonicalContributionSchemas: {
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"page">;
         pageId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"local-app">;
+        schemes: z.ZodArray<z.ZodString>;
     }, z.core.$strict>], "kind">;
     ReferencePresentationVariant: z.ZodObject<{
         resourceKind: z.ZodString;
@@ -2724,6 +2781,28 @@ declare const canonicalContributionSchemas: {
             kind: z.ZodLiteral<"none">;
         }, z.core.$strict>>;
     }, z.core.$strict>;
+    ReferencePresentationAccountLinks: z.ZodObject<{
+        label: z.ZodOptional<z.ZodEnum<{
+            email: "email";
+            name: "name";
+        }>>;
+        pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            hostname: z.ZodString;
+            pathname: z.ZodOptional<z.ZodString>;
+            unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            setPathname: z.ZodOptional<z.ZodString>;
+            addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>>;
+        addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pattern: z.ZodObject<{
+                protocol: z.ZodString;
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                search: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            url: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
     ReferencePresentationWords: z.ZodObject<{
         glyph: z.ZodOptional<z.ZodEnum<{
             file: "file";
@@ -2788,6 +2867,9 @@ declare const canonicalContributionSchemas: {
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"page">;
             pageId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"local-app">;
+            schemes: z.ZodArray<z.ZodString>;
         }, z.core.$strict>], "kind">>;
         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             resourceKind: z.ZodString;
@@ -2855,11 +2937,28 @@ declare const canonicalContributionSchemas: {
             target: z.ZodOptional<z.ZodString>;
             kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strict>>;
-    }, z.core.$strict>;
-    RichViewContribution: z.ZodObject<{
-        localId: z.ZodString;
-        title: z.ZodString;
-        route: z.ZodOptional<z.ZodString>;
+        accountLinks: z.ZodOptional<z.ZodObject<{
+            label: z.ZodOptional<z.ZodEnum<{
+                email: "email";
+                name: "name";
+            }>>;
+            pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                setPathname: z.ZodOptional<z.ZodString>;
+                addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>>;
+            addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pattern: z.ZodObject<{
+                    protocol: z.ZodString;
+                    hostname: z.ZodString;
+                    pathname: z.ZodOptional<z.ZodString>;
+                    search: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                url: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     KayUiAppHostCapability: z.ZodEnum<{
         "navigation.open-session": "navigation.open-session";
@@ -3047,9 +3146,8 @@ declare const canonicalContributionSchemas: {
         storage: "storage";
         uriModule: "uriModule";
         authService: "authService";
-        app: "app";
         command: "command";
-        configSection: "configSection";
+        app: "app";
         skill: "skill";
         converter: "converter";
         artifactUriModule: "artifactUriModule";
@@ -3072,11 +3170,9 @@ declare const canonicalContributionSchemas: {
         mcpServer: "mcpServer";
         uiCommand: "uiCommand";
         uiSlot: "uiSlot";
-        settingsPanel: "settingsPanel";
-        resultRenderer: "resultRenderer";
         referencePresentation: "referencePresentation";
-        view: "view";
         theme: "theme";
+        configSection: "configSection";
     }>;
 };
 
@@ -3208,6 +3304,34 @@ export declare function compareClaims(a: PluginCapabilityClaimV1, b: PluginCapab
  */
 export declare function compareSemver(a: string, b: string): number | undefined;
 
+/**
+ * Shared comparison operators for visibility conditions.
+ *
+ * Use at most ONE comparison operator per condition. If multiple are
+ * provided, only the first matching one is evaluated (precedence:
+ * eq > neq > gt > gte > lt > lte). With no operator, truthiness is checked.
+ *
+ * `not` inverts the final result of whichever operator (or truthiness
+ * check) is used.
+ */
+declare type ComparisonOperators = {
+    eq?: unknown;
+    neq?: unknown;
+    gt?: number | {
+        $state: string;
+    };
+    gte?: number | {
+        $state: string;
+    };
+    lt?: number | {
+        $state: string;
+    };
+    lte?: number | {
+        $state: string;
+    };
+    not?: true;
+};
+
 /**
  * The section-key convention for every declared plugin config section.
  */
@@ -3353,6 +3477,11 @@ export declare interface DeclaredKayPluginCompatibility {
     readonly sdk?: string | undefined;
 }
 
+/** The address schemes whose items an app on this machine opens, rather than a page on the web. */
+export declare function declaredLocalAppSchemes<TPlugin extends {
+    readonly contributes: Readonly<Record<string, unknown>>;
+}>(plugins: readonly TPlugin[]): ReadonlySet<string>;
+
 /**
  * Every plugin's reference presentations. The daemon delivers this one kind from the resolved
  * contract rather than the manifest, so its rows carry `schemes`.
@@ -3423,6 +3552,16 @@ export declare const DeviceDelegationContribution: z.ZodObject<{
 
 export declare type DeviceDelegationContribution = z.infer<typeof DeviceDelegationContribution>;
 
+/**
+ * Dynamic value - can be a literal or a `{ $state }` reference to the state model.
+ *
+ * Used in action params and validation args where values can either be
+ * hardcoded or resolved from state at runtime.
+ */
+declare type DynamicValue<T = unknown> = T | {
+    $state: string;
+};
+
 export declare const EndpointContribution: z.ZodObject<{
     localId: z.ZodString;
     displayName: z.ZodOptional<z.ZodString>;
@@ -3478,6 +3617,12 @@ export declare const EventGrantRequest: z.ZodObject<{
 
 export declare type EventGrantRequest = z.infer<typeof EventGrantRequest>;
 
+/**
+ * {@link whereProblem}, for a `where` a plugin event is matched against: every key must also be a
+ * safe path, at most 10 identifier segments and 256 bytes.
+ */
+export declare function eventWhereProblem(value: unknown): string | undefined;
+
 export declare const FileExtensionToken: z.ZodString;
 
 export declare type FileExtensionToken = z.infer<typeof FileExtensionToken>;
@@ -3499,6 +3644,9 @@ export declare function finalizeArtifactProvenanceEnvelope(capture: ArtifactProv
 
 export declare function findSkillSuggestionCitations(text: string, options?: SkillSuggestionEvidenceOptions): readonly SkillSuggestionCitation[];
 
+/** One literal as an expression writes it: single-quoted strings, JSON-form numbers. */
+export declare function formatWhereLiteral(value: WhereLiteral): string;
+
 export declare const GitBasicAuthUser: z.ZodString;
 
 export declare type GitBasicAuthUser = z.infer<typeof GitBasicAuthUser>;
@@ -3540,6 +3688,14 @@ export declare const HttpsUrl: z.ZodURL;
 
 export declare type HttpsUrl = z.infer<typeof HttpsUrl>;
 
+/**
+ * A condition that resolves `$index` to the current repeat array index.
+ * Only meaningful inside a `repeat` scope.
+ */
+declare type IndexCondition = {
+    $index: true;
+} & ComparisonOperators;
+
 export declare const InteractionDriverContribution: z.ZodObject<{
     localId: z.ZodString;
     displayName: z.ZodOptional<z.ZodString>;
@@ -3570,6 +3726,11 @@ export declare function isCompatible(report: KayPluginCompatibilityReport): bool
  */
 export declare function isCredentialShapedText(value: unknown): boolean;
 
+/** Whether `url` uses a link scheme a loaded plugin declared for an app on this machine. */
+export declare function isDeclaredLocalAppLink<TPlugin extends {
+    readonly contributes: Readonly<Record<string, unknown>>;
+}>(url: string, plugins: readonly TPlugin[]): boolean;
+
 /**
  * Whether a refusal `code` came from the compatibility check: the plugin was written for another
  * SDK or protocol, as opposed to being malformed.
@@ -3601,6 +3762,22 @@ export declare function isQualifiedAuthServiceRef(ref: string): boolean;
 /** Whether a range is one {@link satisfiesSemverRange} can answer for at all. */
 export declare function isSupportedSemverRange(range: string): boolean;
 
+/**
+ * An app entry naming source rather than built JavaScript. Bonsai compiles it when it loads the
+ * plugin, so a plugin in `~/.kay/plugins` needs no build tool for a page.
+ */
+export declare function isUiAppSourceModule(module: string): boolean;
+
+/**
+ * A condition that resolves `$item` to a field on the current repeat item.
+ * Only meaningful inside a `repeat` scope.
+ *
+ * Use `""` to reference the whole item, or `"field"` for a specific field.
+ */
+declare type ItemCondition = {
+    $item: string;
+} & ComparisonOperators;
+
 export declare const JsonObject: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
 
 export declare type JsonObject = z.infer<typeof JsonObject>;
@@ -4327,9 +4504,21 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 0.44.0 adds `words.kinds` to a reference presentation (#15905): an ordered list of address patterns
  * and the kind each one names. Additive: a plugin that lists them declares ^0.44.0.
  *
- * 0.45.0 adds declared plugin cards and app.implementCard for their read/submit endpoints.
+ * 0.45.0 adds declared plugin cards and app.implementCard for their read/submit endpoints. It also
+ * lets a plugin declare what the window hardcoded about it (#15906). A reference presentation gains
+ * `accountLinks`, how a page opens under the account an address means, and a `local-app` open, for
+ * an item an app on this machine shows; a plugin the person installed can't declare that open. A
+ * `webSession` gains `signInFirst`. A URI module defines `lookupWebLink` and sets `looksUpWebLinks`
+ * to find a page when someone opens the address, and a preview field marks which `part` of a message
+ * it is. A claim's `brandIcon` is a file path and no longer inline markup, which only this repo's
+ * Microsoft plugin used. Otherwise additive: a plugin using any of these declares ^0.45.0.
+ *
+ * 0.46.0 adds `@bonsai/plugin-sdk/artifact-provenance`, so a plugin shipped as files can finalize
+ * and read the provenance the host captured. Additive: a plugin that imports it declares ^0.46.0.
+ *
+ * 0.47.0 adds card layouts and builders; successful card submits now require a summary.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.45.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.47.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -4392,6 +4581,7 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
             authScheme: z.ZodOptional<z.ZodString>;
             knownResources: z.ZodOptional<z.ZodLiteral<true>>;
             describesOperations: z.ZodOptional<z.ZodLiteral<true>>;
+            looksUpWebLinks: z.ZodOptional<z.ZodLiteral<true>>;
             claims: z.ZodExactOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"scheme">;
                 scheme: z.ZodString;
@@ -4871,9 +5061,6 @@ export declare const KayAppTargetManifest: z.ZodObject<{
                 bodyField: z.ZodString;
             }, z.core.$strict>], "kind">;
             valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
-            presentation: z.ZodOptional<z.ZodObject<{
-                app: z.ZodString;
-            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         approvalTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
@@ -4973,7 +5160,7 @@ export declare const KayAppTargetManifest: z.ZodObject<{
         notificationRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
             event: z.ZodString;
-            where: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
+            where: z.ZodOptional<z.ZodString>;
             rule: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
         }, z.core.$strict>>>;
         productEvents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -5196,6 +5383,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         authScheme: z.ZodOptional<z.ZodString>;
                         knownResources: z.ZodOptional<z.ZodLiteral<true>>;
                         describesOperations: z.ZodOptional<z.ZodLiteral<true>>;
+                        looksUpWebLinks: z.ZodOptional<z.ZodLiteral<true>>;
                         claims: z.ZodExactOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             kind: z.ZodLiteral<"scheme">;
                             scheme: z.ZodString;
@@ -5672,9 +5860,6 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                             bodyField: z.ZodString;
                         }, z.core.$strict>], "kind">;
                         valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
-                        presentation: z.ZodOptional<z.ZodObject<{
-                            app: z.ZodString;
-                        }, z.core.$strict>>;
                     }, z.core.$strict>>>;
                     approvalTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
@@ -5774,7 +5959,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                     notificationRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
                         event: z.ZodString;
-                        where: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
+                        where: z.ZodOptional<z.ZodString>;
                         rule: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
                     }, z.core.$strict>>>;
                     productEvents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -5866,15 +6051,6 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         slot: z.ZodString;
                         title: z.ZodOptional<z.ZodString>;
                     }, z.core.$strict>>>;
-                    settingsPanels: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                        localId: z.ZodString;
-                        title: z.ZodString;
-                        configSection: z.ZodOptional<z.ZodString>;
-                    }, z.core.$strict>>>;
-                    resultRenderers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                        localId: z.ZodString;
-                        resultKinds: z.ZodArray<z.ZodString>;
-                    }, z.core.$strict>>>;
                     referencePresentations: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
                         uriModule: z.ZodOptional<z.ZodString>;
@@ -5899,6 +6075,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         }, z.core.$strict>, z.ZodObject<{
                             kind: z.ZodLiteral<"page">;
                             pageId: z.ZodString;
+                        }, z.core.$strict>, z.ZodObject<{
+                            kind: z.ZodLiteral<"local-app">;
+                            schemes: z.ZodArray<z.ZodString>;
                         }, z.core.$strict>], "kind">>;
                         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                             resourceKind: z.ZodString;
@@ -5966,11 +6145,28 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                             target: z.ZodOptional<z.ZodString>;
                             kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
                         }, z.core.$strict>>;
-                    }, z.core.$strict>>>;
-                    views: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                        localId: z.ZodString;
-                        title: z.ZodString;
-                        route: z.ZodOptional<z.ZodString>;
+                        accountLinks: z.ZodOptional<z.ZodObject<{
+                            label: z.ZodOptional<z.ZodEnum<{
+                                email: "email";
+                                name: "name";
+                            }>>;
+                            pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                hostname: z.ZodString;
+                                pathname: z.ZodOptional<z.ZodString>;
+                                unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                                setPathname: z.ZodOptional<z.ZodString>;
+                                addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+                            }, z.core.$strict>>>;
+                            addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                pattern: z.ZodObject<{
+                                    protocol: z.ZodString;
+                                    hostname: z.ZodString;
+                                    pathname: z.ZodOptional<z.ZodString>;
+                                    search: z.ZodOptional<z.ZodString>;
+                                }, z.core.$strict>;
+                                url: z.ZodString;
+                            }, z.core.$strict>>>;
+                        }, z.core.$strict>>;
                     }, z.core.$strict>>>;
                     apps: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
@@ -6274,6 +6470,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                     external: "external";
                     embedded: "embedded";
                 }>;
+                signInFirst: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
@@ -7032,15 +7229,6 @@ export declare const KayUiTargetManifest: z.ZodObject<{
             slot: z.ZodString;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
-        settingsPanels: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            localId: z.ZodString;
-            title: z.ZodString;
-            configSection: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>>;
-        resultRenderers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            localId: z.ZodString;
-            resultKinds: z.ZodArray<z.ZodString>;
-        }, z.core.$strict>>>;
         referencePresentations: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
             uriModule: z.ZodOptional<z.ZodString>;
@@ -7065,6 +7253,9 @@ export declare const KayUiTargetManifest: z.ZodObject<{
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"page">;
                 pageId: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"local-app">;
+                schemes: z.ZodArray<z.ZodString>;
             }, z.core.$strict>], "kind">>;
             variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                 resourceKind: z.ZodString;
@@ -7132,11 +7323,28 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                 target: z.ZodOptional<z.ZodString>;
                 kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
             }, z.core.$strict>>;
-        }, z.core.$strict>>>;
-        views: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            localId: z.ZodString;
-            title: z.ZodString;
-            route: z.ZodOptional<z.ZodString>;
+            accountLinks: z.ZodOptional<z.ZodObject<{
+                label: z.ZodOptional<z.ZodEnum<{
+                    email: "email";
+                    name: "name";
+                }>>;
+                pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    hostname: z.ZodString;
+                    pathname: z.ZodOptional<z.ZodString>;
+                    unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    setPathname: z.ZodOptional<z.ZodString>;
+                    addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+                }, z.core.$strict>>>;
+                addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    pattern: z.ZodObject<{
+                        protocol: z.ZodString;
+                        hostname: z.ZodString;
+                        pathname: z.ZodOptional<z.ZodString>;
+                        search: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                    url: z.ZodString;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         apps: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
@@ -7397,6 +7605,13 @@ export declare interface OperationCaptureInput {
     readonly causes?: readonly ArtifactProvenanceCause[];
 }
 
+/**
+ * OR wrapper — at least one child condition must be true.
+ */
+declare type OrCondition = {
+    $or: VisibilityCondition[];
+};
+
 export declare const PackageAssetPath: z.ZodString;
 
 export declare type PackageAssetPath = z.infer<typeof PackageAssetPath>;
@@ -7443,9 +7658,12 @@ export declare function parseResolvedPluginContractV1(value: unknown): ResolvedP
 export declare function parseSemver(value: string): ParsedSemver | undefined;
 
 /**
- * Parses a `where` expression: `||`, `&&`, `!`, parentheses, `==`, `!=`, strings, `true`, `false`
- * and dotted keys, for example `markedForRetirement || proposedRewrite.stale == false`. A bare key
- * means "is set". With `keyTypes`, only those keys parse, and each is checked against its type.
+ * Parses a `where` expression: `||`, `&&`, `!`, parentheses, `==`, `!=`, `contains`, strings,
+ * numbers, `true`, `false` and dotted keys, for example
+ * `markedForRetirement || proposedRewrite.stale == false`. A bare key means "is set". `==` and `!=`
+ * compare a whole value, so a list never equals a scalar; `labels contains 'urgent'` looks inside a
+ * list. With `keyTypes`, only those keys parse, each is checked against its type, and `contains` is
+ * refused, because those keys are scalars.
  */
 export declare function parseWhere(source: string, keyTypes?: WhereKeyTypes): WhereParseResult;
 
@@ -7664,6 +7882,7 @@ export declare const PluginAuthManifest: z.ZodObject<{
                 external: "external";
                 embedded: "embedded";
             }>;
+            signInFirst: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
@@ -7955,6 +8174,7 @@ export declare const PluginAuthService: z.ZodObject<{
             external: "external";
             embedded: "embedded";
         }>;
+        signInFirst: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 
@@ -9755,6 +9975,12 @@ export declare const PluginCardContribution: z.ZodObject<{
 
 export declare type PluginCardContribution = z.infer<typeof PluginCardContribution>;
 
+export declare type PluginCardReadResult<T> = PluginCardResult<T> | {
+    readonly ok: true;
+    readonly presentation: "layout";
+    readonly layout: Spec;
+};
+
 export declare type PluginCardResult<T> = {
     readonly ok: true;
     readonly data: T;
@@ -9764,6 +9990,14 @@ export declare type PluginCardResult<T> = {
     readonly message: string;
 };
 
+export declare type PluginCardSubmitResult<T> = {
+    readonly ok: true;
+    readonly data: T;
+    readonly summary: string;
+} | Extract<PluginCardResult<T>, {
+    readonly ok: false;
+}>;
+
 export declare const PluginCompatibilityManifest: z.ZodObject<{
     supportedProtocols: z.ZodOptional<z.ZodArray<z.ZodLiteral<"kay.plugin.v1">>>;
     minKayVersion: z.ZodOptional<z.ZodString>;
@@ -9817,9 +10051,8 @@ export declare const PluginContributionKind: z.ZodEnum<{
     storage: "storage";
     uriModule: "uriModule";
     authService: "authService";
-    app: "app";
     command: "command";
-    configSection: "configSection";
+    app: "app";
     skill: "skill";
     converter: "converter";
     artifactUriModule: "artifactUriModule";
@@ -9842,11 +10075,9 @@ export declare const PluginContributionKind: z.ZodEnum<{
     mcpServer: "mcpServer";
     uiCommand: "uiCommand";
     uiSlot: "uiSlot";
-    settingsPanel: "settingsPanel";
-    resultRenderer: "resultRenderer";
     referencePresentation: "referencePresentation";
-    view: "view";
     theme: "theme";
+    configSection: "configSection";
 }>;
 
 export declare type PluginContributionKind = z.infer<typeof PluginContributionKind>;
@@ -10053,7 +10284,7 @@ export declare type PluginNamespace = z.infer<typeof PluginNamespace>;
 export declare const PluginNotificationRuleContribution: z.ZodObject<{
     localId: z.ZodString;
     event: z.ZodString;
-    where: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
+    where: z.ZodOptional<z.ZodString>;
     rule: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
 }, z.core.$strict>;
 
@@ -10880,6 +11111,7 @@ export declare const PluginWebSessionDeclaration: z.ZodObject<{
         external: "external";
         embedded: "embedded";
     }>;
+    signInFirst: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 
 export declare type PluginWebSessionDeclaration = z.infer<typeof PluginWebSessionDeclaration>;
@@ -10930,10 +11162,38 @@ export declare const ReferenceOpenBehavior: z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"page">;
     pageId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"local-app">;
+    schemes: z.ZodArray<z.ZodString>;
 }, z.core.$strict>], "kind">;
 
 export declare type ReferenceOpenBehavior = z.infer<typeof ReferenceOpenBehavior>;
 
+export declare const ReferencePresentationAccountLinks: z.ZodObject<{
+    label: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        name: "name";
+    }>>;
+    pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        hostname: z.ZodString;
+        pathname: z.ZodOptional<z.ZodString>;
+        unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        setPathname: z.ZodOptional<z.ZodString>;
+        addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>>;
+    addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pattern: z.ZodObject<{
+            protocol: z.ZodString;
+            hostname: z.ZodString;
+            pathname: z.ZodOptional<z.ZodString>;
+            search: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        url: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+
+export declare type ReferencePresentationAccountLinks = z.infer<typeof ReferencePresentationAccountLinks>;
+
 export declare const ReferencePresentationAddress: z.ZodObject<{
     pattern: z.ZodObject<{
         protocol: z.ZodString;
@@ -10973,6 +11233,9 @@ export declare const ReferencePresentationContribution: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"page">;
         pageId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"local-app">;
+        schemes: z.ZodArray<z.ZodString>;
     }, z.core.$strict>], "kind">>;
     variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         resourceKind: z.ZodString;
@@ -11040,6 +11303,28 @@ export declare const ReferencePresentationContribution: z.ZodObject<{
         target: z.ZodOptional<z.ZodString>;
         kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strict>>;
+    accountLinks: z.ZodOptional<z.ZodObject<{
+        label: z.ZodOptional<z.ZodEnum<{
+            email: "email";
+            name: "name";
+        }>>;
+        pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            hostname: z.ZodString;
+            pathname: z.ZodOptional<z.ZodString>;
+            unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            setPathname: z.ZodOptional<z.ZodString>;
+            addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>>;
+        addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pattern: z.ZodObject<{
+                protocol: z.ZodString;
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                search: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            url: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type ReferencePresentationContribution = z.infer<typeof ReferencePresentationContribution>;
@@ -11155,6 +11440,7 @@ export declare function refineWebSessionScopeConfined(webSession: {
     readonly probe: {
         readonly url: string;
     };
+    readonly signInFirst?: string | undefined;
 }, ctx: z.RefinementCtx): void;
 
 export declare const RegistrableDomain: z.ZodString;
@@ -11510,6 +11796,7 @@ export declare const ResolvedKayAgentUriModule: z.ZodObject<{
     authSchemeId: z.ZodOptional<z.ZodString>;
     knownResources: z.ZodOptional<z.ZodLiteral<true>>;
     describesOperations: z.ZodOptional<z.ZodLiteral<true>>;
+    looksUpWebLinks: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strict>;
 
 export declare type ResolvedKayAgentUriModule = z.infer<typeof ResolvedKayAgentUriModule>;
@@ -11673,9 +11960,6 @@ export declare const ResolvedKayAppWhiteboardType: z.ZodObject<{
         bodyField: z.ZodString;
     }, z.core.$strict>], "kind">;
     valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
-    presentation: z.ZodOptional<z.ZodObject<{
-        app: z.ZodString;
-    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type ResolvedKayAppWhiteboardType = z.infer<typeof ResolvedKayAppWhiteboardType>;
@@ -12047,6 +12331,7 @@ export declare const ResolvedPluginAuthService: z.ZodObject<{
             external: "external";
             embedded: "embedded";
         }>;
+        signInFirst: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 
@@ -12088,9 +12373,8 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
             storage: "storage";
             uriModule: "uriModule";
             authService: "authService";
-            app: "app";
             command: "command";
-            configSection: "configSection";
+            app: "app";
             skill: "skill";
             converter: "converter";
             artifactUriModule: "artifactUriModule";
@@ -12113,11 +12397,9 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
             mcpServer: "mcpServer";
             uiCommand: "uiCommand";
             uiSlot: "uiSlot";
-            settingsPanel: "settingsPanel";
-            resultRenderer: "resultRenderer";
             referencePresentation: "referencePresentation";
-            view: "view";
             theme: "theme";
+            configSection: "configSection";
         }>;
         localId: z.ZodString;
         globalId: z.ZodString;
@@ -12286,6 +12568,7 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 external: "external";
                 embedded: "embedded";
             }>;
+            signInFirst: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     grants: z.ZodOptional<z.ZodObject<{
@@ -12745,6 +13028,7 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
         authSchemeId: z.ZodOptional<z.ZodString>;
         knownResources: z.ZodOptional<z.ZodLiteral<true>>;
         describesOperations: z.ZodOptional<z.ZodLiteral<true>>;
+        looksUpWebLinks: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strict>>>;
     kayAgentArtifactUriModules: z.ZodOptional<z.ZodArray<z.ZodObject<{
         localId: z.ZodString;
@@ -12968,9 +13252,6 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
             bodyField: z.ZodString;
         }, z.core.$strict>], "kind">;
         valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
-        presentation: z.ZodOptional<z.ZodObject<{
-            app: z.ZodString;
-        }, z.core.$strict>>;
     }, z.core.$strict>>>;
     kayAppMcpServers: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -12996,6 +13277,29 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
         uriModule: z.ZodOptional<z.ZodString>;
         schemes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         displayName: z.ZodOptional<z.ZodString>;
+        authService: z.ZodOptional<z.ZodString>;
+        accountLinks: z.ZodOptional<z.ZodObject<{
+            label: z.ZodOptional<z.ZodEnum<{
+                email: "email";
+                name: "name";
+            }>>;
+            pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                setPathname: z.ZodOptional<z.ZodString>;
+                addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>>;
+            addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pattern: z.ZodObject<{
+                    protocol: z.ZodString;
+                    hostname: z.ZodString;
+                    pathname: z.ZodOptional<z.ZodString>;
+                    search: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                url: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
         addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
             pattern: z.ZodObject<{
                 protocol: z.ZodString;
@@ -13016,6 +13320,9 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"page">;
             pageId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"local-app">;
+            schemes: z.ZodArray<z.ZodString>;
         }, z.core.$strict>], "kind">>;
         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             resourceKind: z.ZodString;
@@ -13141,9 +13448,8 @@ export declare const ResolvedPluginContributionId: z.ZodObject<{
         storage: "storage";
         uriModule: "uriModule";
         authService: "authService";
-        app: "app";
         command: "command";
-        configSection: "configSection";
+        app: "app";
         skill: "skill";
         converter: "converter";
         artifactUriModule: "artifactUriModule";
@@ -13166,11 +13472,9 @@ export declare const ResolvedPluginContributionId: z.ZodObject<{
         mcpServer: "mcpServer";
         uiCommand: "uiCommand";
         uiSlot: "uiSlot";
-        settingsPanel: "settingsPanel";
-        resultRenderer: "resultRenderer";
         referencePresentation: "referencePresentation";
-        view: "view";
         theme: "theme";
+        configSection: "configSection";
     }>;
     localId: z.ZodString;
     globalId: z.ZodString;
@@ -13506,6 +13810,7 @@ export declare const ResolvedPluginWebSession: z.ZodObject<{
         external: "external";
         embedded: "embedded";
     }>;
+    signInFirst: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 
 export declare type ResolvedPluginWebSession = z.infer<typeof ResolvedPluginWebSession>;
@@ -13516,6 +13821,29 @@ export declare const ResolvedReferencePresentation: z.ZodObject<{
     uriModule: z.ZodOptional<z.ZodString>;
     schemes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     displayName: z.ZodOptional<z.ZodString>;
+    authService: z.ZodOptional<z.ZodString>;
+    accountLinks: z.ZodOptional<z.ZodObject<{
+        label: z.ZodOptional<z.ZodEnum<{
+            email: "email";
+            name: "name";
+        }>>;
+        pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            hostname: z.ZodString;
+            pathname: z.ZodOptional<z.ZodString>;
+            unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            setPathname: z.ZodOptional<z.ZodString>;
+            addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>>>;
+        addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pattern: z.ZodObject<{
+                protocol: z.ZodString;
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                search: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            url: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
     addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
         pattern: z.ZodObject<{
             protocol: z.ZodString;
@@ -13536,6 +13864,9 @@ export declare const ResolvedReferencePresentation: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"page">;
         pageId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"local-app">;
+        schemes: z.ZodArray<z.ZodString>;
     }, z.core.$strict>], "kind">>;
     variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         resourceKind: z.ZodString;
@@ -13742,13 +14073,6 @@ export declare const ResourceContribution: z.ZodObject<{
 
 export declare type ResourceContribution = z.infer<typeof ResourceContribution>;
 
-export declare const ResultRendererContribution: z.ZodObject<{
-    localId: z.ZodString;
-    resultKinds: z.ZodArray<z.ZodString>;
-}, z.core.$strict>;
-
-export declare type ResultRendererContribution = z.infer<typeof ResultRendererContribution>;
-
 /**
  * What a plugin declares about the host it can run under.
  *
@@ -13815,14 +14139,6 @@ export declare interface RetiredPermissionAsks {
  */
 export declare function retiredPermissionAsksIn(rawManifest: unknown): readonly RetiredPermissionAsks[];
 
-export declare const RichViewContribution: z.ZodObject<{
-    localId: z.ZodString;
-    title: z.ZodString;
-    route: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-
-export declare type RichViewContribution = z.infer<typeof RichViewContribution>;
-
 /** Whether a `where` holds for one row. A field the row doesn't have is absent, not unknown. */
 export declare function rowMatchesWhere(where: Where, row: Readonly<Record<string, unknown>>): boolean;
 
@@ -14263,18 +14579,13 @@ export declare const SessionRelationship: z.ZodDiscriminatedUnion<[z.ZodObject<{
 
 export declare type SessionRelationship = z.infer<typeof SessionRelationship>;
 
-export declare const SettingsPanelContribution: z.ZodObject<{
-    localId: z.ZodString;
-    title: z.ZodString;
-    configSection: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-
-export declare type SettingsPanelContribution = z.infer<typeof SettingsPanelContribution>;
-
 export declare const SignedInStatusCode: z.ZodNumber;
 
 export declare type SignedInStatusCode = z.infer<typeof SignedInStatusCode>;
 
+/** A single visibility condition (state, item, or index). */
+declare type SingleCondition = StateCondition | ItemCondition | IndexCondition;
+
 export declare const SkillContribution: z.ZodObject<{
     localId: z.ZodString;
     displayName: z.ZodOptional<z.ZodString>;
@@ -14322,6 +14633,31 @@ export declare type SkillSuggestionEvidenceRef = {
     readonly raw: string;
 };
 
+/**
+ * Flat UI tree structure (optimized for LLM generation)
+ */
+declare interface Spec {
+    /** Root element key */
+    root: string;
+    /** Flat map of elements by key */
+    elements: Record<string, UIElement>;
+    /** Optional initial state to seed the state model.
+     *  Components using statePath will read from / write to this state. */
+    state?: Record<string, unknown>;
+}
+
+/**
+ * A single state-based condition.
+ * Resolves `$state` to a value from the state model, then applies the operator.
+ * Without an operator, checks truthiness.
+ *
+ * When `not` is `true`, the result of the entire condition is inverted.
+ * For example `{ $state: "/count", gt: 5, not: true }` means "NOT greater than 5".
+ */
+declare type StateCondition = {
+    $state: string;
+} & ComparisonOperators;
+
 export declare const StorageGrantRequest: z.ZodObject<{
     kind: z.ZodEnum<{
         sqlite: "sqlite";
@@ -14849,6 +15185,9 @@ export declare const UiAppContribution: z.ZodObject<{
 
 export declare type UiAppContribution = z.infer<typeof UiAppContribution>;
 
+/** Where a source entry's compiled stylesheet sits in its package, beside the entry. */
+export declare function uiAppSourceStylePath(module: string): string;
+
 export declare const UiCommandContribution: z.ZodObject<{
     localId: z.ZodString;
     title: z.ZodString;
@@ -14866,6 +15205,33 @@ export declare type UiCommandContribution = z.infer<typeof UiCommandContribution
 
 declare type UiContributes = NonNullable<KayUiTargetManifest["contributes"]>;
 
+/**
+ * Base UI element structure for v2
+ */
+declare interface UIElement<T extends string = string, P = Record<string, unknown>> {
+    /** Component type from the catalog */
+    type: T;
+    /** Component props */
+    props: P;
+    /** Child element keys (flat structure) */
+    children?: string[];
+    /** Visibility condition */
+    visible?: VisibilityCondition;
+    /** Event bindings — maps event names to action bindings */
+    on?: Record<string, ActionBinding | ActionBinding[]>;
+    /** Repeat children once per item in a state array */
+    repeat?: {
+        statePath: string;
+        key?: string;
+    };
+    /**
+     * State watchers — maps JSON Pointer state paths to action bindings.
+     * When the value at a watched path changes, the bound actions fire.
+     * Useful for cascading dependencies (e.g. country → city option loading).
+     */
+    watch?: Record<string, ActionBinding | ActionBinding[]>;
+}
+
 export declare const UiEventSubscriptionContribution: z.ZodObject<{
     localId: z.ZodString;
     event: z.ZodString;
@@ -14931,6 +15297,7 @@ export declare const UriModuleContribution: z.ZodObject<{
     authScheme: z.ZodOptional<z.ZodString>;
     knownResources: z.ZodOptional<z.ZodLiteral<true>>;
     describesOperations: z.ZodOptional<z.ZodLiteral<true>>;
+    looksUpWebLinks: z.ZodOptional<z.ZodLiteral<true>>;
     claims: z.ZodExactOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"scheme">;
         scheme: z.ZodString;
@@ -15275,6 +15642,16 @@ export declare function validateKayUiEventSubscription(event: string, definedPlu
     readonly message: string;
 };
 
+/**
+ * Visibility condition types.
+ * - `boolean` — always/never
+ * - `SingleCondition` — single condition (`$state`, `$item`, or `$index`)
+ * - `SingleCondition[]` — implicit AND (all must be true)
+ * - `AndCondition` — `{ $and: [...] }`, explicit AND (all must be true)
+ * - `OrCondition` — `{ $or: [...] }`, at least one must be true
+ */
+declare type VisibilityCondition = boolean | SingleCondition | SingleCondition[] | AndCondition | OrCondition;
+
 /**
  * The one element a CSRF token is read from, as a COMPOUND SIMPLE selector: an optional tag
  * followed by any number of `#id` and `[attr]` / `[attr=value]` predicates, all on that one
@@ -15324,8 +15701,12 @@ export declare type Where = {
 } | {
     readonly kind: "equals";
     readonly key: string;
-    readonly value: boolean | string;
+    readonly value: WhereLiteral;
     readonly negated: boolean;
+} | {
+    readonly kind: "contains";
+    readonly key: string;
+    readonly value: WhereLiteral;
 } | {
     readonly kind: "not";
     readonly operand: Where;
@@ -15341,9 +15722,33 @@ declare const WHERE_KEY_TYPES: {
     readonly "app.channel": "string";
 };
 
+/** The longest `where`: the largest a rule file can be, so anything that loaded still loads. */
+export declare const WHERE_MAX_BYTES: number;
+
+/**
+ * The old list form of `where`, written as an expression: each clause is
+ * `path == value`, or `(path == value || path contains value)` where `looksInsideLists` says so, and
+ * all must hold. A path spelled `true`, `false` or as a number never resolved to anything, so its
+ * clause is `false`. Undefined when the list isn't a non-empty list of `{ path, equals }`.
+ */
+export declare function whereClausesAsExpression(clauses: unknown, looksInsideLists?: (path: string) => boolean): string | undefined;
+
 /** What a caller's keys are, when it has a fixed set. A bare string key must be compared. */
 export declare type WhereKeyTypes = Readonly<Record<string, "boolean" | "string">>;
 
+export declare type WhereKeyUse = "bare" | "compared" | "contained";
+
+/** Every key an expression reads, each with how that read uses it. */
+export declare function whereKeyUses(where: Where): readonly {
+    readonly key: string;
+    readonly use: WhereKeyUse;
+}[];
+
+export declare type WhereLiteral = boolean | number | string;
+
+/** Why a value that isn't a string can't be a `where`, showing an old list in its new form. */
+export declare function whereNotAStringMessage(value: unknown): string;
+
 export declare type WhereParseResult = {
     readonly ok: true;
     readonly where: Where;
@@ -15352,6 +15757,9 @@ export declare type WhereParseResult = {
     readonly message: string;
 };
 
+/** Why a value can't be a saved `where`, or undefined when it can. */
+export declare function whereProblem(value: unknown): string | undefined;
+
 /** Construct the exact claim row for one Whiteboard scope and operation. */
 export declare function whiteboardCapabilityClaim(operation: WhiteboardCapabilityOperation, scope: WhiteboardCapabilityScope, target?: "kay.agent"): WhiteboardCapabilityClaimV1;
 
@@ -15510,9 +15918,6 @@ export declare const WhiteboardTypeContribution: z.ZodObject<{
         bodyField: z.ZodString;
     }, z.core.$strict>], "kind">;
     valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
-    presentation: z.ZodOptional<z.ZodObject<{
-        app: z.ZodString;
-    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type WhiteboardTypeContribution = z.infer<typeof WhiteboardTypeContribution>;
@@ -15522,9 +15927,6 @@ export declare const WhiteboardTypeInfo: z.ZodObject<{
     displayName: z.ZodString;
     schemaVersion: z.ZodNumber;
     available: z.ZodBoolean;
-    presentation: z.ZodOptional<z.ZodObject<{
-        app: z.ZodString;
-    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type WhiteboardTypeInfo = Readonly<z.infer<typeof WhiteboardTypeInfo>>;