@ikenga/contract 0.18.0 → 0.19.0

package/dist/manifest.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export declare const IKENGA_API_VERSION: 4;
+export declare const IKENGA_API_VERSION: 5;
 export declare const IKENGA_API_MIN_SUPPORTED: 1;
 export declare const AuthorSchema: z.ZodObject<{
     name: z.ZodString;
@@ -193,7 +193,316 @@ export declare const ManifestUiSessionSchema: z.ZodObject<{
     persistence: "keep" | "clear-on-exit" | "ask";
 }>;
 export type ManifestUiSession = z.infer<typeof ManifestUiSessionSchema>;
-export declare const UiBlockSchema: z.ZodDefault<z.ZodObject<{
+export declare const ViewEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    /** A pkg UI namespace path, e.g. `/grid` → pane route `pkg://<id>/grid`.
+     *  Must match a declared `ui.routes[]` path (§6 Q3). */
+    route: z.ZodString;
+    /** Honoured ONCE, at first install (Round 2 Q1). Updates never re-pin;
+     *  unpin is permanent. Kernel "first install" = no prior install row. */
+    pin_on_install: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    route: string;
+    pin_on_install: boolean;
+    icon?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    route: string;
+    icon?: string | undefined;
+    pin_on_install?: boolean | undefined;
+}>;
+export type ViewEntry = z.infer<typeof ViewEntrySchema>;
+export declare const ExplorerSectionEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+    /** GET iyke route under `/pkg/<id>/` returning ExplorerSectionData. */
+    data_route: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    data_route: string;
+    icon?: string | undefined;
+    order?: number | undefined;
+}, {
+    id: string;
+    title: string;
+    data_route: string;
+    icon?: string | undefined;
+    order?: number | undefined;
+}>;
+export type ExplorerSectionEntry = z.infer<typeof ExplorerSectionEntrySchema>;
+/** The JSON a `data_route` returns. The shell renders it natively — the
+ *  section is data, never an embedded iframe (P4 fix, discussion §3.2). */
+export declare const ExplorerSectionDataSchema: z.ZodObject<{
+    rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        badge: z.ZodOptional<z.ZodObject<{
+            count: z.ZodOptional<z.ZodNumber>;
+            tooltip: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            count?: number | undefined;
+            tooltip?: string | undefined;
+        }, {
+            count?: number | undefined;
+            tooltip?: string | undefined;
+        }>>;
+        /** Pane target on click: a pkg route (`pkg://...`) or a shell route (`/...`). */
+        open: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        id: string;
+        badge?: {
+            count?: number | undefined;
+            tooltip?: string | undefined;
+        } | undefined;
+        open?: string | undefined;
+    }, {
+        label: string;
+        id: string;
+        badge?: {
+            count?: number | undefined;
+            tooltip?: string | undefined;
+        } | undefined;
+        open?: string | undefined;
+    }>, "many">>;
+    as_of_ms: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    rows: {
+        label: string;
+        id: string;
+        badge?: {
+            count?: number | undefined;
+            tooltip?: string | undefined;
+        } | undefined;
+        open?: string | undefined;
+    }[];
+    as_of_ms?: number | undefined;
+}, {
+    rows?: {
+        label: string;
+        id: string;
+        badge?: {
+            count?: number | undefined;
+            tooltip?: string | undefined;
+        } | undefined;
+        open?: string | undefined;
+    }[] | undefined;
+    as_of_ms?: number | undefined;
+}>;
+export type ExplorerSectionData = z.infer<typeof ExplorerSectionDataSchema>;
+export declare const CompanionPanelEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    /** Pane route rendered in the panel slot (an iframe view). Must render
+     *  state, never model prose — ADR-021 checklist applies. */
+    route: z.ZodString;
+    /** When true the shell threads `panelScopeSessionId` (the selected
+     *  Companion session tab) through the AppBridge hostContext. */
+    session_scoped: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    route: string;
+    session_scoped: boolean;
+    icon?: string | undefined;
+}, {
+    id: string;
+    title: string;
+    route: string;
+    icon?: string | undefined;
+    session_scoped?: boolean | undefined;
+}>;
+export type CompanionPanelEntry = z.infer<typeof CompanionPanelEntrySchema>;
+export declare const ContextSelectorSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"file">;
+    glob: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "file";
+    glob?: string | undefined;
+}, {
+    kind: "file";
+    glob?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"artifact">;
+}, "strip", z.ZodTypeAny, {
+    kind: "artifact";
+}, {
+    kind: "artifact";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"session">;
+}, "strip", z.ZodTypeAny, {
+    kind: "session";
+}, {
+    kind: "session";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"ngwa-item">;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    kind: "ngwa-item";
+    kinds?: string[] | undefined;
+}, {
+    kind: "ngwa-item";
+    kinds?: string[] | undefined;
+}>]>;
+export type ContextSelector = z.infer<typeof ContextSelectorSchema>;
+export declare const ContextActionRunSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"dispatch">;
+    prompt: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "dispatch";
+    prompt: string;
+    target?: string | undefined;
+}, {
+    kind: "dispatch";
+    prompt: string;
+    target?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"view">;
+    route: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "view";
+    route: string;
+}, {
+    kind: "view";
+    route: string;
+}>]>;
+export type ContextActionRun = z.infer<typeof ContextActionRunSchema>;
+export declare const ContextActionEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    when: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"file">;
+        glob: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "file";
+        glob?: string | undefined;
+    }, {
+        kind: "file";
+        glob?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"artifact">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "artifact";
+    }, {
+        kind: "artifact";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"session">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "session";
+    }, {
+        kind: "session";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"ngwa-item">;
+        kinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "ngwa-item";
+        kinds?: string[] | undefined;
+    }, {
+        kind: "ngwa-item";
+        kinds?: string[] | undefined;
+    }>]>;
+    run: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"dispatch">;
+        prompt: z.ZodString;
+        target: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "dispatch";
+        prompt: string;
+        target?: string | undefined;
+    }, {
+        kind: "dispatch";
+        prompt: string;
+        target?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"view">;
+        route: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "view";
+        route: string;
+    }, {
+        kind: "view";
+        route: string;
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    label: string;
+    run: {
+        kind: "dispatch";
+        prompt: string;
+        target?: string | undefined;
+    } | {
+        kind: "view";
+        route: string;
+    };
+    id: string;
+    when: {
+        kind: "file";
+        glob?: string | undefined;
+    } | {
+        kind: "artifact";
+    } | {
+        kind: "session";
+    } | {
+        kind: "ngwa-item";
+        kinds?: string[] | undefined;
+    };
+}, {
+    label: string;
+    run: {
+        kind: "dispatch";
+        prompt: string;
+        target?: string | undefined;
+    } | {
+        kind: "view";
+        route: string;
+    };
+    id: string;
+    when: {
+        kind: "file";
+        glob?: string | undefined;
+    } | {
+        kind: "artifact";
+    } | {
+        kind: "session";
+    } | {
+        kind: "ngwa-item";
+        kinds?: string[] | undefined;
+    };
+}>;
+export type ContextActionEntry = z.infer<typeof ContextActionEntrySchema>;
+export declare const WidgetEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    route: z.ZodString;
+    span: z.ZodDefault<z.ZodEnum<["small", "medium", "wide"]>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    route: string;
+    span: "small" | "medium" | "wide";
+}, {
+    id: string;
+    title: string;
+    route: string;
+    span?: "small" | "medium" | "wide" | undefined;
+}>;
+export type WidgetEntry = z.infer<typeof WidgetEntrySchema>;
+export declare const UiBlockSchema: z.ZodDefault<z.ZodEffects<z.ZodObject<{
+    /** @deprecated v5 alias (G-MANIFEST-V5 §4): the shell reads `nav[i]` as
+     *  `views[i]` = `{id, title: label, icon, route, pin_on_install: i === 0}`
+     *  for exactly one shell release, then deletes the mapping. Field and type
+     *  are unchanged; a manifest declaring both `nav` and `views` still parses
+     *  (`nav` is ignored with a shell-side warning). New manifests declare
+     *  `views` instead. */
     nav: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
@@ -247,18 +556,194 @@ export declare const UiBlockSchema: z.ZodDefault<z.ZodObject<{
         shortcut?: string | undefined;
         action?: unknown;
     }>, "many">>;
-    side_pane_viewers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    /** v5 hard-retire (G-MANIFEST-V5 §8 Q1 / DEC-34): `side_pane_viewers` was
+     *  removed from the block; declaring it fails validation outright.
+     *  `z.never()` is the contract-side mirror of the Rust canonical rejection
+     *  (skills/commands-bundling precedent). `SidePaneViewerSchema` stays
+     *  exported for tooling that reads historical manifests. */
+    side_pane_viewers: z.ZodOptional<z.ZodNever>;
+    views: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        label: z.ZodString;
+        title: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        /** A pkg UI namespace path, e.g. `/grid` → pane route `pkg://<id>/grid`.
+         *  Must match a declared `ui.routes[]` path (§6 Q3). */
         route: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        label: string;
+        /** Honoured ONCE, at first install (Round 2 Q1). Updates never re-pin;
+         *  unpin is permanent. Kernel "first install" = no prior install row. */
+        pin_on_install: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        route: string;
+        pin_on_install: boolean;
+        icon?: string | undefined;
+    }, {
         id: string;
+        title: string;
         route: string;
+        icon?: string | undefined;
+        pin_on_install?: boolean | undefined;
+    }>, "many">>;
+    explorer_sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodNumber>;
+        /** GET iyke route under `/pkg/<id>/` returning ExplorerSectionData. */
+        data_route: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        data_route: string;
+        icon?: string | undefined;
+        order?: number | undefined;
+    }, {
+        id: string;
+        title: string;
+        data_route: string;
+        icon?: string | undefined;
+        order?: number | undefined;
+    }>, "many">>;
+    companion_panels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        /** Pane route rendered in the panel slot (an iframe view). Must render
+         *  state, never model prose — ADR-021 checklist applies. */
+        route: z.ZodString;
+        /** When true the shell threads `panelScopeSessionId` (the selected
+         *  Companion session tab) through the AppBridge hostContext. */
+        session_scoped: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        route: string;
+        session_scoped: boolean;
+        icon?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        route: string;
+        icon?: string | undefined;
+        session_scoped?: boolean | undefined;
+    }>, "many">>;
+    context_actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        when: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"file">;
+            glob: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "file";
+            glob?: string | undefined;
+        }, {
+            kind: "file";
+            glob?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"artifact">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "artifact";
+        }, {
+            kind: "artifact";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"session">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "session";
+        }, {
+            kind: "session";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"ngwa-item">;
+            kinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "ngwa-item";
+            kinds?: string[] | undefined;
+        }, {
+            kind: "ngwa-item";
+            kinds?: string[] | undefined;
+        }>]>;
+        run: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"dispatch">;
+            prompt: z.ZodString;
+            target: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "dispatch";
+            prompt: string;
+            target?: string | undefined;
+        }, {
+            kind: "dispatch";
+            prompt: string;
+            target?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"view">;
+            route: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "view";
+            route: string;
+        }, {
+            kind: "view";
+            route: string;
+        }>]>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        run: {
+            kind: "dispatch";
+            prompt: string;
+            target?: string | undefined;
+        } | {
+            kind: "view";
+            route: string;
+        };
+        id: string;
+        when: {
+            kind: "file";
+            glob?: string | undefined;
+        } | {
+            kind: "artifact";
+        } | {
+            kind: "session";
+        } | {
+            kind: "ngwa-item";
+            kinds?: string[] | undefined;
+        };
     }, {
         label: string;
+        run: {
+            kind: "dispatch";
+            prompt: string;
+            target?: string | undefined;
+        } | {
+            kind: "view";
+            route: string;
+        };
         id: string;
+        when: {
+            kind: "file";
+            glob?: string | undefined;
+        } | {
+            kind: "artifact";
+        } | {
+            kind: "session";
+        } | {
+            kind: "ngwa-item";
+            kinds?: string[] | undefined;
+        };
+    }>, "many">>;
+    widgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        route: z.ZodString;
+        span: z.ZodDefault<z.ZodEnum<["small", "medium", "wide"]>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
         route: string;
+        span: "small" | "medium" | "wide";
+    }, {
+        id: string;
+        title: string;
+        route: string;
+        span?: "small" | "medium" | "wide" | undefined;
     }>, "many">>;
     /** Per-directive CSP overrides for the iframe content. */
     csp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
@@ -291,14 +776,60 @@ export declare const UiBlockSchema: z.ZodDefault<z.ZodObject<{
         shortcut?: string | undefined;
         action?: unknown;
     }[];
-    side_pane_viewers: {
+    views: {
+        id: string;
+        title: string;
+        route: string;
+        pin_on_install: boolean;
+        icon?: string | undefined;
+    }[];
+    explorer_sections: {
+        id: string;
+        title: string;
+        data_route: string;
+        icon?: string | undefined;
+        order?: number | undefined;
+    }[];
+    companion_panels: {
+        id: string;
+        title: string;
+        route: string;
+        session_scoped: boolean;
+        icon?: string | undefined;
+    }[];
+    context_actions: {
         label: string;
+        run: {
+            kind: "dispatch";
+            prompt: string;
+            target?: string | undefined;
+        } | {
+            kind: "view";
+            route: string;
+        };
+        id: string;
+        when: {
+            kind: "file";
+            glob?: string | undefined;
+        } | {
+            kind: "artifact";
+        } | {
+            kind: "session";
+        } | {
+            kind: "ngwa-item";
+            kinds?: string[] | undefined;
+        };
+    }[];
+    widgets: {
         id: string;
+        title: string;
         route: string;
+        span: "small" | "medium" | "wide";
     }[];
     session?: {
         persistence: "keep" | "clear-on-exit" | "ask";
     } | undefined;
+    side_pane_viewers?: undefined;
     csp?: Record<string, string[]> | undefined;
     permissions?: Record<string, string[]> | undefined;
 }, {
@@ -324,14 +855,213 @@ export declare const UiBlockSchema: z.ZodDefault<z.ZodObject<{
         shortcut?: string | undefined;
         action?: unknown;
     }[] | undefined;
-    side_pane_viewers?: {
+    side_pane_viewers?: undefined;
+    views?: {
+        id: string;
+        title: string;
+        route: string;
+        icon?: string | undefined;
+        pin_on_install?: boolean | undefined;
+    }[] | undefined;
+    explorer_sections?: {
+        id: string;
+        title: string;
+        data_route: string;
+        icon?: string | undefined;
+        order?: number | undefined;
+    }[] | undefined;
+    companion_panels?: {
+        id: string;
+        title: string;
+        route: string;
+        icon?: string | undefined;
+        session_scoped?: boolean | undefined;
+    }[] | undefined;
+    context_actions?: {
         label: string;
+        run: {
+            kind: "dispatch";
+            prompt: string;
+            target?: string | undefined;
+        } | {
+            kind: "view";
+            route: string;
+        };
+        id: string;
+        when: {
+            kind: "file";
+            glob?: string | undefined;
+        } | {
+            kind: "artifact";
+        } | {
+            kind: "session";
+        } | {
+            kind: "ngwa-item";
+            kinds?: string[] | undefined;
+        };
+    }[] | undefined;
+    widgets?: {
         id: string;
+        title: string;
         route: string;
+        span?: "small" | "medium" | "wide" | undefined;
+    }[] | undefined;
+    csp?: Record<string, string[]> | undefined;
+    permissions?: Record<string, string[]> | undefined;
+}>, {
+    nav: {
+        label: string;
+        id: string;
+        route: string;
+        section?: string | undefined;
+        icon?: string | undefined;
+    }[];
+    routes: {
+        path: string;
+        kind: "iframe" | "component" | "webview";
+        source: string;
+        partition?: string | undefined;
+    }[];
+    command_palette: {
+        label: string;
+        id: string;
+        shortcut?: string | undefined;
+        action?: unknown;
+    }[];
+    views: {
+        id: string;
+        title: string;
+        route: string;
+        pin_on_install: boolean;
+        icon?: string | undefined;
+    }[];
+    explorer_sections: {
+        id: string;
+        title: string;
+        data_route: string;
+        icon?: string | undefined;
+        order?: number | undefined;
+    }[];
+    companion_panels: {
+        id: string;
+        title: string;
+        route: string;
+        session_scoped: boolean;
+        icon?: string | undefined;
+    }[];
+    context_actions: {
+        label: string;
+        run: {
+            kind: "dispatch";
+            prompt: string;
+            target?: string | undefined;
+        } | {
+            kind: "view";
+            route: string;
+        };
+        id: string;
+        when: {
+            kind: "file";
+            glob?: string | undefined;
+        } | {
+            kind: "artifact";
+        } | {
+            kind: "session";
+        } | {
+            kind: "ngwa-item";
+            kinds?: string[] | undefined;
+        };
+    }[];
+    widgets: {
+        id: string;
+        title: string;
+        route: string;
+        span: "small" | "medium" | "wide";
+    }[];
+    session?: {
+        persistence: "keep" | "clear-on-exit" | "ask";
+    } | undefined;
+    side_pane_viewers?: undefined;
+    csp?: Record<string, string[]> | undefined;
+    permissions?: Record<string, string[]> | undefined;
+}, {
+    session?: {
+        persistence: "keep" | "clear-on-exit" | "ask";
+    } | undefined;
+    nav?: {
+        label: string;
+        id: string;
+        route: string;
+        section?: string | undefined;
+        icon?: string | undefined;
+    }[] | undefined;
+    routes?: {
+        path: string;
+        kind: "iframe" | "component" | "webview";
+        source: string;
+        partition?: string | undefined;
+    }[] | undefined;
+    command_palette?: {
+        label: string;
+        id: string;
+        shortcut?: string | undefined;
+        action?: unknown;
+    }[] | undefined;
+    side_pane_viewers?: undefined;
+    views?: {
+        id: string;
+        title: string;
+        route: string;
+        icon?: string | undefined;
+        pin_on_install?: boolean | undefined;
+    }[] | undefined;
+    explorer_sections?: {
+        id: string;
+        title: string;
+        data_route: string;
+        icon?: string | undefined;
+        order?: number | undefined;
+    }[] | undefined;
+    companion_panels?: {
+        id: string;
+        title: string;
+        route: string;
+        icon?: string | undefined;
+        session_scoped?: boolean | undefined;
+    }[] | undefined;
+    context_actions?: {
+        label: string;
+        run: {
+            kind: "dispatch";
+            prompt: string;
+            target?: string | undefined;
+        } | {
+            kind: "view";
+            route: string;
+        };
+        id: string;
+        when: {
+            kind: "file";
+            glob?: string | undefined;
+        } | {
+            kind: "artifact";
+        } | {
+            kind: "session";
+        } | {
+            kind: "ngwa-item";
+            kinds?: string[] | undefined;
+        };
+    }[] | undefined;
+    widgets?: {
+        id: string;
+        title: string;
+        route: string;
+        span?: "small" | "medium" | "wide" | undefined;
     }[] | undefined;
     csp?: Record<string, string[]> | undefined;
     permissions?: Record<string, string[]> | undefined;
 }>>;
+export type UiBlock = z.infer<typeof UiBlockSchema>;
 export declare const SettingsFieldSchema: z.ZodObject<{
     key: z.ZodString;
     type: z.ZodEnum<["string", "number", "boolean", "secret"]>;
@@ -905,7 +1635,13 @@ export declare const ManifestSchema: z.ZodObject<{
             env?: string | undefined;
         }[] | undefined;
     }>>;
-    ui: z.ZodDefault<z.ZodObject<{
+    ui: z.ZodDefault<z.ZodEffects<z.ZodObject<{
+        /** @deprecated v5 alias (G-MANIFEST-V5 §4): the shell reads `nav[i]` as
+         *  `views[i]` = `{id, title: label, icon, route, pin_on_install: i === 0}`
+         *  for exactly one shell release, then deletes the mapping. Field and type
+         *  are unchanged; a manifest declaring both `nav` and `views` still parses
+         *  (`nav` is ignored with a shell-side warning). New manifests declare
+         *  `views` instead. */
         nav: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
@@ -959,31 +1695,359 @@ export declare const ManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }>, "many">>;
-        side_pane_viewers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** v5 hard-retire (G-MANIFEST-V5 §8 Q1 / DEC-34): `side_pane_viewers` was
+         *  removed from the block; declaring it fails validation outright.
+         *  `z.never()` is the contract-side mirror of the Rust canonical rejection
+         *  (skills/commands-bundling precedent). `SidePaneViewerSchema` stays
+         *  exported for tooling that reads historical manifests. */
+        side_pane_viewers: z.ZodOptional<z.ZodNever>;
+        views: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            /** A pkg UI namespace path, e.g. `/grid` → pane route `pkg://<id>/grid`.
+             *  Must match a declared `ui.routes[]` path (§6 Q3). */
+            route: z.ZodString;
+            /** Honoured ONCE, at first install (Round 2 Q1). Updates never re-pin;
+             *  unpin is permanent. Kernel "first install" = no prior install row. */
+            pin_on_install: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            route: string;
+            pin_on_install: boolean;
+            icon?: string | undefined;
+        }, {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            pin_on_install?: boolean | undefined;
+        }>, "many">>;
+        explorer_sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodNumber>;
+            /** GET iyke route under `/pkg/<id>/` returning ExplorerSectionData. */
+            data_route: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }, {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }>, "many">>;
+        companion_panels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            /** Pane route rendered in the panel slot (an iframe view). Must render
+             *  state, never model prose — ADR-021 checklist applies. */
+            route: z.ZodString;
+            /** When true the shell threads `panelScopeSessionId` (the selected
+             *  Companion session tab) through the AppBridge hostContext. */
+            session_scoped: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            route: string;
+            session_scoped: boolean;
+            icon?: string | undefined;
+        }, {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            session_scoped?: boolean | undefined;
+        }>, "many">>;
+        context_actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
+            when: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"file">;
+                glob: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "file";
+                glob?: string | undefined;
+            }, {
+                kind: "file";
+                glob?: string | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"artifact">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "artifact";
+            }, {
+                kind: "artifact";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"session">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "session";
+            }, {
+                kind: "session";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"ngwa-item">;
+                kinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            }, {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            }>]>;
+            run: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"dispatch">;
+                prompt: z.ZodString;
+                target: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            }, {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"view">;
+                route: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "view";
+                route: string;
+            }, {
+                kind: "view";
+                route: string;
+            }>]>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }, {
+            label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }>, "many">>;
+        widgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
             route: z.ZodString;
+            span: z.ZodDefault<z.ZodEnum<["small", "medium", "wide"]>>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            route: string;
+            span: "small" | "medium" | "wide";
+        }, {
+            id: string;
+            title: string;
+            route: string;
+            span?: "small" | "medium" | "wide" | undefined;
+        }>, "many">>;
+        /** Per-directive CSP overrides for the iframe content. */
+        csp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        /** Per-directive Permission-Policy values. */
+        permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        session: z.ZodOptional<z.ZodObject<{
+            persistence: z.ZodEnum<["keep", "clear-on-exit", "ask"]>;
         }, "strip", z.ZodTypeAny, {
+            persistence: "keep" | "clear-on-exit" | "ask";
+        }, {
+            persistence: "keep" | "clear-on-exit" | "ask";
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        nav: {
             label: string;
             id: string;
             route: string;
-        }, {
+            section?: string | undefined;
+            icon?: string | undefined;
+        }[];
+        routes: {
+            path: string;
+            kind: "iframe" | "component" | "webview";
+            source: string;
+            partition?: string | undefined;
+        }[];
+        command_palette: {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }[];
+        views: {
+            id: string;
+            title: string;
+            route: string;
+            pin_on_install: boolean;
+            icon?: string | undefined;
+        }[];
+        explorer_sections: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[];
+        companion_panels: {
+            id: string;
+            title: string;
+            route: string;
+            session_scoped: boolean;
+            icon?: string | undefined;
+        }[];
+        context_actions: {
+            label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[];
+        widgets: {
+            id: string;
+            title: string;
+            route: string;
+            span: "small" | "medium" | "wide";
+        }[];
+        session?: {
+            persistence: "keep" | "clear-on-exit" | "ask";
+        } | undefined;
+        side_pane_viewers?: undefined;
+        csp?: Record<string, string[]> | undefined;
+        permissions?: Record<string, string[]> | undefined;
+    }, {
+        session?: {
+            persistence: "keep" | "clear-on-exit" | "ask";
+        } | undefined;
+        nav?: {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }[] | undefined;
+        routes?: {
+            path: string;
+            kind: "iframe" | "component" | "webview";
+            source: string;
+            partition?: string | undefined;
+        }[] | undefined;
+        command_palette?: {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }[] | undefined;
+        side_pane_viewers?: undefined;
+        views?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            pin_on_install?: boolean | undefined;
+        }[] | undefined;
+        explorer_sections?: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        companion_panels?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            session_scoped?: boolean | undefined;
+        }[] | undefined;
+        context_actions?: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
             id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[] | undefined;
+        widgets?: {
+            id: string;
+            title: string;
             route: string;
-        }>, "many">>;
-        /** Per-directive CSP overrides for the iframe content. */
-        csp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-        /** Per-directive Permission-Policy values. */
-        permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-        session: z.ZodOptional<z.ZodObject<{
-            persistence: z.ZodEnum<["keep", "clear-on-exit", "ask"]>;
-        }, "strip", z.ZodTypeAny, {
-            persistence: "keep" | "clear-on-exit" | "ask";
-        }, {
-            persistence: "keep" | "clear-on-exit" | "ask";
-        }>>;
-    }, "strip", z.ZodTypeAny, {
+            span?: "small" | "medium" | "wide" | undefined;
+        }[] | undefined;
+        csp?: Record<string, string[]> | undefined;
+        permissions?: Record<string, string[]> | undefined;
+    }>, {
         nav: {
             label: string;
             id: string;
@@ -1003,14 +2067,60 @@ export declare const ManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }[];
-        side_pane_viewers: {
+        views: {
+            id: string;
+            title: string;
+            route: string;
+            pin_on_install: boolean;
+            icon?: string | undefined;
+        }[];
+        explorer_sections: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[];
+        companion_panels: {
+            id: string;
+            title: string;
+            route: string;
+            session_scoped: boolean;
+            icon?: string | undefined;
+        }[];
+        context_actions: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[];
+        widgets: {
             id: string;
+            title: string;
             route: string;
+            span: "small" | "medium" | "wide";
         }[];
         session?: {
             persistence: "keep" | "clear-on-exit" | "ask";
         } | undefined;
+        side_pane_viewers?: undefined;
         csp?: Record<string, string[]> | undefined;
         permissions?: Record<string, string[]> | undefined;
     }, {
@@ -1036,10 +2146,56 @@ export declare const ManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }[] | undefined;
-        side_pane_viewers?: {
+        side_pane_viewers?: undefined;
+        views?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            pin_on_install?: boolean | undefined;
+        }[] | undefined;
+        explorer_sections?: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        companion_panels?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            session_scoped?: boolean | undefined;
+        }[] | undefined;
+        context_actions?: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[] | undefined;
+        widgets?: {
             id: string;
+            title: string;
             route: string;
+            span?: "small" | "medium" | "wide" | undefined;
         }[] | undefined;
         csp?: Record<string, string[]> | undefined;
         permissions?: Record<string, string[]> | undefined;
@@ -1522,14 +2678,60 @@ export declare const ManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }[];
-        side_pane_viewers: {
+        views: {
+            id: string;
+            title: string;
+            route: string;
+            pin_on_install: boolean;
+            icon?: string | undefined;
+        }[];
+        explorer_sections: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[];
+        companion_panels: {
+            id: string;
+            title: string;
+            route: string;
+            session_scoped: boolean;
+            icon?: string | undefined;
+        }[];
+        context_actions: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[];
+        widgets: {
             id: string;
+            title: string;
             route: string;
+            span: "small" | "medium" | "wide";
         }[];
         session?: {
             persistence: "keep" | "clear-on-exit" | "ask";
         } | undefined;
+        side_pane_viewers?: undefined;
         csp?: Record<string, string[]> | undefined;
         permissions?: Record<string, string[]> | undefined;
     };
@@ -1776,10 +2978,56 @@ export declare const ManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }[] | undefined;
-        side_pane_viewers?: {
+        side_pane_viewers?: undefined;
+        views?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            pin_on_install?: boolean | undefined;
+        }[] | undefined;
+        explorer_sections?: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        companion_panels?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            session_scoped?: boolean | undefined;
+        }[] | undefined;
+        context_actions?: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
             id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[] | undefined;
+        widgets?: {
+            id: string;
+            title: string;
             route: string;
+            span?: "small" | "medium" | "wide" | undefined;
         }[] | undefined;
         csp?: Record<string, string[]> | undefined;
         permissions?: Record<string, string[]> | undefined;
@@ -1984,7 +3232,13 @@ export declare const PkgManifestSchema: z.ZodObject<{
             env?: string | undefined;
         }[] | undefined;
     }>>;
-    ui: z.ZodDefault<z.ZodObject<{
+    ui: z.ZodDefault<z.ZodEffects<z.ZodObject<{
+        /** @deprecated v5 alias (G-MANIFEST-V5 §4): the shell reads `nav[i]` as
+         *  `views[i]` = `{id, title: label, icon, route, pin_on_install: i === 0}`
+         *  for exactly one shell release, then deletes the mapping. Field and type
+         *  are unchanged; a manifest declaring both `nav` and `views` still parses
+         *  (`nav` is ignored with a shell-side warning). New manifests declare
+         *  `views` instead. */
         nav: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
@@ -2038,18 +3292,194 @@ export declare const PkgManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }>, "many">>;
-        side_pane_viewers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** v5 hard-retire (G-MANIFEST-V5 §8 Q1 / DEC-34): `side_pane_viewers` was
+         *  removed from the block; declaring it fails validation outright.
+         *  `z.never()` is the contract-side mirror of the Rust canonical rejection
+         *  (skills/commands-bundling precedent). `SidePaneViewerSchema` stays
+         *  exported for tooling that reads historical manifests. */
+        side_pane_viewers: z.ZodOptional<z.ZodNever>;
+        views: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
-            label: z.ZodString;
+            title: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            /** A pkg UI namespace path, e.g. `/grid` → pane route `pkg://<id>/grid`.
+             *  Must match a declared `ui.routes[]` path (§6 Q3). */
             route: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            label: string;
+            /** Honoured ONCE, at first install (Round 2 Q1). Updates never re-pin;
+             *  unpin is permanent. Kernel "first install" = no prior install row. */
+            pin_on_install: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            route: string;
+            pin_on_install: boolean;
+            icon?: string | undefined;
+        }, {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            pin_on_install?: boolean | undefined;
+        }>, "many">>;
+        explorer_sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodNumber>;
+            /** GET iyke route under `/pkg/<id>/` returning ExplorerSectionData. */
+            data_route: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }, {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }>, "many">>;
+        companion_panels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            /** Pane route rendered in the panel slot (an iframe view). Must render
+             *  state, never model prose — ADR-021 checklist applies. */
+            route: z.ZodString;
+            /** When true the shell threads `panelScopeSessionId` (the selected
+             *  Companion session tab) through the AppBridge hostContext. */
+            session_scoped: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
             id: string;
+            title: string;
             route: string;
+            session_scoped: boolean;
+            icon?: string | undefined;
+        }, {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            session_scoped?: boolean | undefined;
+        }>, "many">>;
+        context_actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            when: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"file">;
+                glob: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "file";
+                glob?: string | undefined;
+            }, {
+                kind: "file";
+                glob?: string | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"artifact">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "artifact";
+            }, {
+                kind: "artifact";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"session">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "session";
+            }, {
+                kind: "session";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"ngwa-item">;
+                kinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            }, {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            }>]>;
+            run: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"dispatch">;
+                prompt: z.ZodString;
+                target: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            }, {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"view">;
+                route: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "view";
+                route: string;
+            }, {
+                kind: "view";
+                route: string;
+            }>]>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
         }, {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }>, "many">>;
+        widgets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            route: z.ZodString;
+            span: z.ZodDefault<z.ZodEnum<["small", "medium", "wide"]>>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            title: string;
+            route: string;
+            span: "small" | "medium" | "wide";
+        }, {
             id: string;
+            title: string;
             route: string;
+            span?: "small" | "medium" | "wide" | undefined;
         }>, "many">>;
         /** Per-directive CSP overrides for the iframe content. */
         csp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
@@ -2082,14 +3512,212 @@ export declare const PkgManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }[];
-        side_pane_viewers: {
+        views: {
+            id: string;
+            title: string;
+            route: string;
+            pin_on_install: boolean;
+            icon?: string | undefined;
+        }[];
+        explorer_sections: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[];
+        companion_panels: {
+            id: string;
+            title: string;
+            route: string;
+            session_scoped: boolean;
+            icon?: string | undefined;
+        }[];
+        context_actions: {
+            label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[];
+        widgets: {
+            id: string;
+            title: string;
+            route: string;
+            span: "small" | "medium" | "wide";
+        }[];
+        session?: {
+            persistence: "keep" | "clear-on-exit" | "ask";
+        } | undefined;
+        side_pane_viewers?: undefined;
+        csp?: Record<string, string[]> | undefined;
+        permissions?: Record<string, string[]> | undefined;
+    }, {
+        session?: {
+            persistence: "keep" | "clear-on-exit" | "ask";
+        } | undefined;
+        nav?: {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }[] | undefined;
+        routes?: {
+            path: string;
+            kind: "iframe" | "component" | "webview";
+            source: string;
+            partition?: string | undefined;
+        }[] | undefined;
+        command_palette?: {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }[] | undefined;
+        side_pane_viewers?: undefined;
+        views?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            pin_on_install?: boolean | undefined;
+        }[] | undefined;
+        explorer_sections?: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        companion_panels?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            session_scoped?: boolean | undefined;
+        }[] | undefined;
+        context_actions?: {
+            label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[] | undefined;
+        widgets?: {
+            id: string;
+            title: string;
+            route: string;
+            span?: "small" | "medium" | "wide" | undefined;
+        }[] | undefined;
+        csp?: Record<string, string[]> | undefined;
+        permissions?: Record<string, string[]> | undefined;
+    }>, {
+        nav: {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }[];
+        routes: {
+            path: string;
+            kind: "iframe" | "component" | "webview";
+            source: string;
+            partition?: string | undefined;
+        }[];
+        command_palette: {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }[];
+        views: {
+            id: string;
+            title: string;
+            route: string;
+            pin_on_install: boolean;
+            icon?: string | undefined;
+        }[];
+        explorer_sections: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[];
+        companion_panels: {
+            id: string;
+            title: string;
+            route: string;
+            session_scoped: boolean;
+            icon?: string | undefined;
+        }[];
+        context_actions: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[];
+        widgets: {
             id: string;
+            title: string;
             route: string;
+            span: "small" | "medium" | "wide";
         }[];
         session?: {
             persistence: "keep" | "clear-on-exit" | "ask";
         } | undefined;
+        side_pane_viewers?: undefined;
         csp?: Record<string, string[]> | undefined;
         permissions?: Record<string, string[]> | undefined;
     }, {
@@ -2115,10 +3743,56 @@ export declare const PkgManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }[] | undefined;
-        side_pane_viewers?: {
+        side_pane_viewers?: undefined;
+        views?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            pin_on_install?: boolean | undefined;
+        }[] | undefined;
+        explorer_sections?: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        companion_panels?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            session_scoped?: boolean | undefined;
+        }[] | undefined;
+        context_actions?: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
             id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[] | undefined;
+        widgets?: {
+            id: string;
+            title: string;
             route: string;
+            span?: "small" | "medium" | "wide" | undefined;
         }[] | undefined;
         csp?: Record<string, string[]> | undefined;
         permissions?: Record<string, string[]> | undefined;
@@ -2601,14 +4275,60 @@ export declare const PkgManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }[];
-        side_pane_viewers: {
+        views: {
+            id: string;
+            title: string;
+            route: string;
+            pin_on_install: boolean;
+            icon?: string | undefined;
+        }[];
+        explorer_sections: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[];
+        companion_panels: {
+            id: string;
+            title: string;
+            route: string;
+            session_scoped: boolean;
+            icon?: string | undefined;
+        }[];
+        context_actions: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[];
+        widgets: {
             id: string;
+            title: string;
             route: string;
+            span: "small" | "medium" | "wide";
         }[];
         session?: {
             persistence: "keep" | "clear-on-exit" | "ask";
         } | undefined;
+        side_pane_viewers?: undefined;
         csp?: Record<string, string[]> | undefined;
         permissions?: Record<string, string[]> | undefined;
     };
@@ -2855,10 +4575,56 @@ export declare const PkgManifestSchema: z.ZodObject<{
             shortcut?: string | undefined;
             action?: unknown;
         }[] | undefined;
-        side_pane_viewers?: {
+        side_pane_viewers?: undefined;
+        views?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            pin_on_install?: boolean | undefined;
+        }[] | undefined;
+        explorer_sections?: {
+            id: string;
+            title: string;
+            data_route: string;
+            icon?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+        companion_panels?: {
+            id: string;
+            title: string;
+            route: string;
+            icon?: string | undefined;
+            session_scoped?: boolean | undefined;
+        }[] | undefined;
+        context_actions?: {
             label: string;
+            run: {
+                kind: "dispatch";
+                prompt: string;
+                target?: string | undefined;
+            } | {
+                kind: "view";
+                route: string;
+            };
+            id: string;
+            when: {
+                kind: "file";
+                glob?: string | undefined;
+            } | {
+                kind: "artifact";
+            } | {
+                kind: "session";
+            } | {
+                kind: "ngwa-item";
+                kinds?: string[] | undefined;
+            };
+        }[] | undefined;
+        widgets?: {
             id: string;
+            title: string;
             route: string;
+            span?: "small" | "medium" | "wide" | undefined;
         }[] | undefined;
         csp?: Record<string, string[]> | undefined;
         permissions?: Record<string, string[]> | undefined;