@rudderhq/shared 0.3.6-canary.9 → 0.4.0

package/dist/validators/plugin.d.ts

@@ -7,7 +7,7 @@ import { z } from "zod";
  * Used to validate `instanceConfigSchema` and `parametersSchema` fields in the
  * plugin manifest without fully parsing JSON Schema.
  *
- * @see PLUGIN_SPEC.md §10.1 — Manifest shape
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Manifest shape
  */
 export declare const jsonSchemaSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
 export declare const pluginJobDeclarationSchema: z.ZodObject<{
@@ -31,7 +31,7 @@ export type PluginJobDeclarationInput = z.infer<typeof pluginJobDeclarationSchem
  * Validates a {@link PluginWebhookDeclaration} — a webhook endpoint declared
  * in the plugin manifest. Requires `endpointKey` and `displayName`.
  *
- * @see PLUGIN_SPEC.md §18 — Webhooks
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Webhooks
  */
 export declare const pluginWebhookDeclarationSchema: z.ZodObject<{
     endpointKey: z.ZodString;
@@ -52,7 +52,7 @@ export type PluginWebhookDeclarationInput = z.infer<typeof pluginWebhookDeclarat
  * plugin. Requires `name`, `displayName`, `description`, and a valid
  * `parametersSchema`. Requires the `agent.tools.register` capability.
  *
- * @see PLUGIN_SPEC.md §11 — Agent Tools
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Agent Tools
  */
 export declare const pluginToolDeclarationSchema: z.ZodObject<{
     name: z.ZodString;
@@ -76,7 +76,7 @@ export type PluginToolDeclarationInput = z.infer<typeof pluginToolDeclarationSch
  * fills with a React component. Includes `superRefine` checks for slot-specific
  * requirements such as `entityTypes` for context-sensitive slots.
  *
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — UI Extension Model
  */
 export declare const pluginUiSlotDeclarationSchema: z.ZodEffects<z.ZodObject<{
     type: z.ZodEnum<["page", "detailTab", "taskDetailView", "dashboardWidget", "sidebar", "sidebarPanel", "projectSidebarItem", "globalToolbarButton", "toolbarButton", "contextMenuItem", "commentAnnotation", "commentContextMenuItem", "settingsPage"]>;
@@ -87,35 +87,35 @@ export declare const pluginUiSlotDeclarationSchema: z.ZodEffects<z.ZodObject<{
     routePath: z.ZodOptional<z.ZodString>;
     order: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     id: string;
+    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     displayName: string;
     exportName: string;
-    entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+    entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
     routePath?: string | undefined;
     order?: number | undefined;
 }, {
-    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     id: string;
+    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     displayName: string;
     exportName: string;
-    entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+    entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
     routePath?: string | undefined;
     order?: number | undefined;
 }>, {
-    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     id: string;
+    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     displayName: string;
     exportName: string;
-    entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+    entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
     routePath?: string | undefined;
     order?: number | undefined;
 }, {
-    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     id: string;
+    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     displayName: string;
     exportName: string;
-    entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+    entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
     routePath?: string | undefined;
     order?: number | undefined;
 }>;
@@ -224,7 +224,7 @@ export declare const pluginLauncherDeclarationSchema: z.ZodEffects<z.ZodObject<{
     placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     description?: string | undefined;
     exportName?: string | undefined;
-    entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+    entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
     order?: number | undefined;
     render?: {
         environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -241,7 +241,7 @@ export declare const pluginLauncherDeclarationSchema: z.ZodEffects<z.ZodObject<{
     placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     description?: string | undefined;
     exportName?: string | undefined;
-    entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+    entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
     order?: number | undefined;
     render?: {
         environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -258,7 +258,7 @@ export declare const pluginLauncherDeclarationSchema: z.ZodEffects<z.ZodObject<{
     placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     description?: string | undefined;
     exportName?: string | undefined;
-    entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+    entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
     order?: number | undefined;
     render?: {
         environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -275,7 +275,7 @@ export declare const pluginLauncherDeclarationSchema: z.ZodEffects<z.ZodObject<{
     placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
     description?: string | undefined;
     exportName?: string | undefined;
-    entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+    entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
     order?: number | undefined;
     render?: {
         environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -287,7 +287,7 @@ export type PluginLauncherDeclarationInput = z.infer<typeof pluginLauncherDeclar
  * Zod schema for {@link PaperclipPluginManifestV1} — the complete runtime
  * validator for plugin manifests read at install time.
  *
- * Field-level constraints (see PLUGIN_SPEC.md §10.1 for the normative rules):
+ * Field-level constraints (see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md for the normative rules):
  *
  * | Field                    | Type       | Constraints                                  |
  * |--------------------------|------------|----------------------------------------------|
@@ -314,7 +314,7 @@ export type PluginLauncherDeclarationInput = z.infer<typeof pluginLauncherDeclar
  * - duplicate `tools[].name` values are rejected
  * - duplicate `ui.slots[].id` values are rejected
  *
- * @see PLUGIN_SPEC.md §10.1 — Manifest shape
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Manifest shape
  * @see {@link PaperclipPluginManifestV1} — the inferred TypeScript type
  */
 export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
@@ -440,7 +440,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
         description?: string | undefined;
         exportName?: string | undefined;
-        entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+        entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
         order?: number | undefined;
         render?: {
             environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -457,7 +457,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
         description?: string | undefined;
         exportName?: string | undefined;
-        entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+        entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
         order?: number | undefined;
         render?: {
             environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -474,7 +474,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
         description?: string | undefined;
         exportName?: string | undefined;
-        entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+        entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
         order?: number | undefined;
         render?: {
             environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -491,7 +491,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
         description?: string | undefined;
         exportName?: string | undefined;
-        entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+        entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
         order?: number | undefined;
         render?: {
             environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -508,35 +508,35 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             routePath: z.ZodOptional<z.ZodString>;
             order: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }, {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }>, {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }, {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }>, "many">>;
@@ -596,7 +596,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -613,7 +613,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -630,7 +630,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -647,7 +647,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -666,7 +666,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -674,11 +674,11 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             } | undefined;
         }[] | undefined;
         slots?: {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }[] | undefined;
@@ -694,7 +694,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -702,19 +702,19 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             } | undefined;
         }[] | undefined;
         slots?: {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    version: string;
     id: string;
     description: string;
+    version: string;
     capabilities: ("organizations.read" | "projects.read" | "project.workspaces.read" | "issues.read" | "issue.comments.read" | "agents.read" | "goals.read" | "goals.create" | "goals.update" | "activity.read" | "costs.read" | "issues.create" | "issues.update" | "issue.comments.create" | "agents.pause" | "agents.resume" | "agents.invoke" | "agent.sessions.create" | "agent.sessions.list" | "agent.sessions.send" | "agent.sessions.close" | "activity.log.write" | "metrics.write" | "plugin.state.read" | "plugin.state.write" | "events.subscribe" | "events.emit" | "jobs.schedule" | "webhooks.receive" | "http.outbound" | "secrets.read-ref" | "agent.tools.register" | "instance.settings.register" | "ui.sidebar.register" | "ui.page.register" | "ui.detailTab.register" | "ui.dashboardWidget.register" | "ui.commentAnnotation.register" | "ui.action.register")[];
     displayName: string;
     apiVersion: 1;
@@ -736,7 +736,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -744,11 +744,11 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             } | undefined;
         }[] | undefined;
         slots?: {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }[] | undefined;
@@ -784,7 +784,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
         description?: string | undefined;
         exportName?: string | undefined;
-        entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+        entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
         order?: number | undefined;
         render?: {
             environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -792,9 +792,9 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }[] | undefined;
 }, {
-    version: string;
     id: string;
     description: string;
+    version: string;
     capabilities: ("organizations.read" | "projects.read" | "project.workspaces.read" | "issues.read" | "issue.comments.read" | "agents.read" | "goals.read" | "goals.create" | "goals.update" | "activity.read" | "costs.read" | "issues.create" | "issues.update" | "issue.comments.create" | "agents.pause" | "agents.resume" | "agents.invoke" | "agent.sessions.create" | "agent.sessions.list" | "agent.sessions.send" | "agent.sessions.close" | "activity.log.write" | "metrics.write" | "plugin.state.read" | "plugin.state.write" | "events.subscribe" | "events.emit" | "jobs.schedule" | "webhooks.receive" | "http.outbound" | "secrets.read-ref" | "agent.tools.register" | "instance.settings.register" | "ui.sidebar.register" | "ui.page.register" | "ui.detailTab.register" | "ui.dashboardWidget.register" | "ui.commentAnnotation.register" | "ui.action.register")[];
     displayName: string;
     apiVersion: 1;
@@ -816,7 +816,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -824,11 +824,11 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             } | undefined;
         }[] | undefined;
         slots?: {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }[] | undefined;
@@ -864,7 +864,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
         description?: string | undefined;
         exportName?: string | undefined;
-        entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+        entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
         order?: number | undefined;
         render?: {
             environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -872,9 +872,9 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }[] | undefined;
 }>, {
-    version: string;
     id: string;
     description: string;
+    version: string;
     capabilities: ("organizations.read" | "projects.read" | "project.workspaces.read" | "issues.read" | "issue.comments.read" | "agents.read" | "goals.read" | "goals.create" | "goals.update" | "activity.read" | "costs.read" | "issues.create" | "issues.update" | "issue.comments.create" | "agents.pause" | "agents.resume" | "agents.invoke" | "agent.sessions.create" | "agent.sessions.list" | "agent.sessions.send" | "agent.sessions.close" | "activity.log.write" | "metrics.write" | "plugin.state.read" | "plugin.state.write" | "events.subscribe" | "events.emit" | "jobs.schedule" | "webhooks.receive" | "http.outbound" | "secrets.read-ref" | "agent.tools.register" | "instance.settings.register" | "ui.sidebar.register" | "ui.page.register" | "ui.detailTab.register" | "ui.dashboardWidget.register" | "ui.commentAnnotation.register" | "ui.action.register")[];
     displayName: string;
     apiVersion: 1;
@@ -896,7 +896,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -904,11 +904,11 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             } | undefined;
         }[] | undefined;
         slots?: {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }[] | undefined;
@@ -944,7 +944,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
         description?: string | undefined;
         exportName?: string | undefined;
-        entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+        entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
         order?: number | undefined;
         render?: {
             environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -952,9 +952,9 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }[] | undefined;
 }, {
-    version: string;
     id: string;
     description: string;
+    version: string;
     capabilities: ("organizations.read" | "projects.read" | "project.workspaces.read" | "issues.read" | "issue.comments.read" | "agents.read" | "goals.read" | "goals.create" | "goals.update" | "activity.read" | "costs.read" | "issues.create" | "issues.update" | "issue.comments.create" | "agents.pause" | "agents.resume" | "agents.invoke" | "agent.sessions.create" | "agent.sessions.list" | "agent.sessions.send" | "agent.sessions.close" | "activity.log.write" | "metrics.write" | "plugin.state.read" | "plugin.state.write" | "events.subscribe" | "events.emit" | "jobs.schedule" | "webhooks.receive" | "http.outbound" | "secrets.read-ref" | "agent.tools.register" | "instance.settings.register" | "ui.sidebar.register" | "ui.page.register" | "ui.detailTab.register" | "ui.dashboardWidget.register" | "ui.commentAnnotation.register" | "ui.action.register")[];
     displayName: string;
     apiVersion: 1;
@@ -976,7 +976,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             description?: string | undefined;
             exportName?: string | undefined;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             order?: number | undefined;
             render?: {
                 environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -984,11 +984,11 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
             } | undefined;
         }[] | undefined;
         slots?: {
-            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
             displayName: string;
             exportName: string;
-            entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+            entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
             routePath?: string | undefined;
             order?: number | undefined;
         }[] | undefined;
@@ -1024,7 +1024,7 @@ export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
         placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
         description?: string | undefined;
         exportName?: string | undefined;
-        entityTypes?: ("agent" | "issue" | "project" | "goal" | "run" | "comment")[] | undefined;
+        entityTypes?: ("issue" | "agent" | "project" | "goal" | "run" | "comment")[] | undefined;
         order?: number | undefined;
         render?: {
             environment: "external" | "hostInline" | "hostOverlay" | "hostRoute" | "iframe";
@@ -1109,7 +1109,7 @@ export type UninstallPlugin = z.infer<typeof uninstallPluginSchema>;
  * state is stored. Used by the `ctx.state.get()`, `ctx.state.set()`, and
  * `ctx.state.delete()` SDK methods.
  *
- * @see PLUGIN_SPEC.md §21.3 `plugin_state`
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md `plugin_state`
  */
 export declare const pluginStateScopeKeySchema: z.ZodObject<{
     scopeKind: z.ZodEnum<["instance", "organization", "project", "project_workspace", "agent", "issue", "goal", "run"]>;
@@ -1117,12 +1117,12 @@ export declare const pluginStateScopeKeySchema: z.ZodObject<{
     namespace: z.ZodOptional<z.ZodString>;
     stateKey: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    scopeKind: "agent" | "issue" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace";
+    scopeKind: "issue" | "agent" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace";
     stateKey: string;
     scopeId?: string | undefined;
     namespace?: string | undefined;
 }, {
-    scopeKind: "agent" | "issue" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace";
+    scopeKind: "issue" | "agent" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace";
     stateKey: string;
     scopeId?: string | undefined;
     namespace?: string | undefined;
@@ -1139,13 +1139,13 @@ export declare const setPluginStateSchema: z.ZodObject<{
     /** JSON-serializable value to store. */
     value: z.ZodUnknown;
 }, "strip", z.ZodTypeAny, {
-    scopeKind: "agent" | "issue" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace";
+    scopeKind: "issue" | "agent" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace";
     stateKey: string;
     value?: unknown;
     scopeId?: string | undefined;
     namespace?: string | undefined;
 }, {
-    scopeKind: "agent" | "issue" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace";
+    scopeKind: "issue" | "agent" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace";
     stateKey: string;
     value?: unknown;
     scopeId?: string | undefined;
@@ -1163,11 +1163,11 @@ export declare const listPluginStateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     scopeId?: string | undefined;
     namespace?: string | undefined;
-    scopeKind?: "agent" | "issue" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace" | undefined;
+    scopeKind?: "issue" | "agent" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace" | undefined;
 }, {
     scopeId?: string | undefined;
     namespace?: string | undefined;
-    scopeKind?: "agent" | "issue" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace" | undefined;
+    scopeKind?: "issue" | "agent" | "project" | "organization" | "goal" | "run" | "instance" | "project_workspace" | undefined;
 }>;
 export type ListPluginState = z.infer<typeof listPluginStateSchema>;
 //# sourceMappingURL=plugin.d.ts.map