@evermore.work/shared 2026.509.0-canary.0

package/dist/validators/plugin.d.ts

@@ -0,0 +1,2426 @@
+import { z } from "zod";
+/**
+ * Permissive validator for JSON Schema objects. Accepts any `Record<string, unknown>`
+ * that contains at least a `type`, `$ref`, or composition keyword (`oneOf`/`anyOf`/`allOf`).
+ * Empty objects are also accepted.
+ *
+ * Used to validate `instanceConfigSchema` and `parametersSchema` fields in the
+ * plugin manifest without fully parsing JSON Schema.
+ *
+ * @see PLUGIN_SPEC.md §10.1 — 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<{
+    jobKey: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    schedule: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    jobKey: string;
+    displayName: string;
+    description?: string | undefined;
+    schedule?: string | undefined;
+}, {
+    jobKey: string;
+    displayName: string;
+    description?: string | undefined;
+    schedule?: string | undefined;
+}>;
+export type PluginJobDeclarationInput = z.infer<typeof pluginJobDeclarationSchema>;
+/**
+ * Validates a {@link PluginWebhookDeclaration} — a webhook endpoint declared
+ * in the plugin manifest. Requires `endpointKey` and `displayName`.
+ *
+ * @see PLUGIN_SPEC.md §18 — Webhooks
+ */
+export declare const pluginWebhookDeclarationSchema: z.ZodObject<{
+    endpointKey: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    endpointKey: string;
+    description?: string | undefined;
+}, {
+    displayName: string;
+    endpointKey: string;
+    description?: string | undefined;
+}>;
+export type PluginWebhookDeclarationInput = z.infer<typeof pluginWebhookDeclarationSchema>;
+/**
+ * Validates a {@link PluginToolDeclaration} — an agent tool contributed by the
+ * plugin. Requires `name`, `displayName`, `description`, and a valid
+ * `parametersSchema`. Requires the `agent.tools.register` capability.
+ *
+ * @see PLUGIN_SPEC.md §11 — Agent Tools
+ */
+export declare const pluginToolDeclarationSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodString;
+    parametersSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    name: string;
+    displayName: string;
+    parametersSchema: Record<string, unknown>;
+}, {
+    description: string;
+    name: string;
+    displayName: string;
+    parametersSchema: Record<string, unknown>;
+}>;
+export declare const pluginEnvironmentDriverDeclarationSchema: z.ZodObject<{
+    driverKey: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<["environment_driver", "sandbox_provider"]>>;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    configSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    driverKey: string;
+    configSchema: Record<string, unknown>;
+    description?: string | undefined;
+    kind?: "environment_driver" | "sandbox_provider" | undefined;
+}, {
+    displayName: string;
+    driverKey: string;
+    configSchema: Record<string, unknown>;
+    description?: string | undefined;
+    kind?: "environment_driver" | "sandbox_provider" | undefined;
+}>;
+export type PluginEnvironmentDriverDeclarationInput = z.infer<typeof pluginEnvironmentDriverDeclarationSchema>;
+export type PluginToolDeclarationInput = z.infer<typeof pluginToolDeclarationSchema>;
+export declare const pluginManagedAgentDeclarationSchema: z.ZodObject<{
+    agentKey: z.ZodString;
+    displayName: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    adapterType: z.ZodOptional<z.ZodString>;
+    adapterPreference: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    adapterConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    runtimeConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    status: z.ZodOptional<z.ZodEnum<["idle", "paused"]>>;
+    budgetMonthlyCents: z.ZodOptional<z.ZodNumber>;
+    instructions: z.ZodOptional<z.ZodObject<{
+        entryFile: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        assetPath: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        content?: string | undefined;
+        entryFile?: string | undefined;
+        assetPath?: string | undefined;
+    }, {
+        content?: string | undefined;
+        entryFile?: string | undefined;
+        assetPath?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    agentKey: string;
+    title?: string | null | undefined;
+    status?: "paused" | "idle" | undefined;
+    budgetMonthlyCents?: number | undefined;
+    adapterType?: string | undefined;
+    adapterConfig?: Record<string, unknown> | undefined;
+    instructions?: {
+        content?: string | undefined;
+        entryFile?: string | undefined;
+        assetPath?: string | undefined;
+    } | undefined;
+    role?: string | undefined;
+    icon?: string | null | undefined;
+    capabilities?: string | null | undefined;
+    runtimeConfig?: Record<string, unknown> | undefined;
+    permissions?: Record<string, unknown> | undefined;
+    adapterPreference?: string[] | undefined;
+}, {
+    displayName: string;
+    agentKey: string;
+    title?: string | null | undefined;
+    status?: "paused" | "idle" | undefined;
+    budgetMonthlyCents?: number | undefined;
+    adapterType?: string | undefined;
+    adapterConfig?: Record<string, unknown> | undefined;
+    instructions?: {
+        content?: string | undefined;
+        entryFile?: string | undefined;
+        assetPath?: string | undefined;
+    } | undefined;
+    role?: string | undefined;
+    icon?: string | null | undefined;
+    capabilities?: string | null | undefined;
+    runtimeConfig?: Record<string, unknown> | undefined;
+    permissions?: Record<string, unknown> | undefined;
+    adapterPreference?: string[] | undefined;
+}>;
+export type PluginManagedAgentDeclarationInput = z.infer<typeof pluginManagedAgentDeclarationSchema>;
+export declare const pluginManagedProjectDeclarationSchema: z.ZodObject<{
+    projectKey: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<["backlog", "planned", "in_progress", "completed", "cancelled"]>>;
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    projectKey: string;
+    description?: string | null | undefined;
+    settings?: Record<string, unknown> | undefined;
+    status?: "backlog" | "in_progress" | "cancelled" | "completed" | "planned" | undefined;
+    color?: string | null | undefined;
+}, {
+    displayName: string;
+    projectKey: string;
+    description?: string | null | undefined;
+    settings?: Record<string, unknown> | undefined;
+    status?: "backlog" | "in_progress" | "cancelled" | "completed" | "planned" | undefined;
+    color?: string | null | undefined;
+}>;
+export type PluginManagedProjectDeclarationInput = z.infer<typeof pluginManagedProjectDeclarationSchema>;
+export declare const pluginManagedRoutineDeclarationSchema: z.ZodObject<{
+    routineKey: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    assigneeRef: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        pluginKey: z.ZodOptional<z.ZodString>;
+        resourceKey: z.ZodString;
+    } & {
+        resourceKind: z.ZodLiteral<"agent">;
+    }, "strip", z.ZodTypeAny, {
+        resourceKind: "agent";
+        resourceKey: string;
+        pluginKey?: string | undefined;
+    }, {
+        resourceKind: "agent";
+        resourceKey: string;
+        pluginKey?: string | undefined;
+    }>>>;
+    projectRef: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        pluginKey: z.ZodOptional<z.ZodString>;
+        resourceKey: z.ZodString;
+    } & {
+        resourceKind: z.ZodLiteral<"project">;
+    }, "strip", z.ZodTypeAny, {
+        resourceKind: "project";
+        resourceKey: string;
+        pluginKey?: string | undefined;
+    }, {
+        resourceKind: "project";
+        resourceKey: string;
+        pluginKey?: string | undefined;
+    }>>>;
+    goalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<["active", "paused", "archived"]>>;
+    priority: z.ZodOptional<z.ZodEnum<["critical", "high", "medium", "low"]>>;
+    concurrencyPolicy: z.ZodOptional<z.ZodEnum<["coalesce_if_active", "always_enqueue", "skip_if_active"]>>;
+    catchUpPolicy: z.ZodOptional<z.ZodEnum<["skip_missed", "enqueue_missed_with_cap"]>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["text", "textarea", "number", "boolean", "select"]>>>;
+        defaultValue: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        options: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        required: boolean;
+        options: string[];
+        type: "number" | "boolean" | "text" | "textarea" | "select";
+        name: string;
+        label?: string | null | undefined;
+        defaultValue?: string | number | boolean | null | undefined;
+    }, {
+        name: string;
+        required?: boolean | undefined;
+        label?: string | null | undefined;
+        options?: string[] | undefined;
+        type?: "number" | "boolean" | "text" | "textarea" | "select" | undefined;
+        defaultValue?: string | number | boolean | null | undefined;
+    }>, {
+        required: boolean;
+        options: string[];
+        type: "number" | "boolean" | "text" | "textarea" | "select";
+        name: string;
+        label?: string | null | undefined;
+        defaultValue?: string | number | boolean | null | undefined;
+    }, {
+        name: string;
+        required?: boolean | undefined;
+        label?: string | null | undefined;
+        options?: string[] | undefined;
+        type?: "number" | "boolean" | "text" | "textarea" | "select" | undefined;
+        defaultValue?: string | number | boolean | null | undefined;
+    }>, "many">>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["schedule", "webhook", "api"]>;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        cronExpression: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        timezone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        signingMode: z.ZodNullable<z.ZodOptional<z.ZodEnum<["bearer", "hmac_sha256", "github_hmac", "none"]>>>;
+        replayWindowSec: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "schedule" | "webhook" | "api";
+        label?: string | null | undefined;
+        enabled?: boolean | undefined;
+        cronExpression?: string | null | undefined;
+        timezone?: string | null | undefined;
+        signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+        replayWindowSec?: number | null | undefined;
+    }, {
+        kind: "schedule" | "webhook" | "api";
+        label?: string | null | undefined;
+        enabled?: boolean | undefined;
+        cronExpression?: string | null | undefined;
+        timezone?: string | null | undefined;
+        signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+        replayWindowSec?: number | null | undefined;
+    }>, "many">>;
+    issueTemplate: z.ZodOptional<z.ZodObject<{
+        surfaceVisibility: z.ZodOptional<z.ZodEnum<["default", "plugin_operation"]>>;
+        originId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        billingCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        billingCode?: string | null | undefined;
+        surfaceVisibility?: "default" | "plugin_operation" | undefined;
+        originId?: string | null | undefined;
+    }, {
+        billingCode?: string | null | undefined;
+        surfaceVisibility?: "default" | "plugin_operation" | undefined;
+        originId?: string | null | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    routineKey: string;
+    description?: string | null | undefined;
+    status?: "active" | "paused" | "archived" | undefined;
+    goalId?: string | null | undefined;
+    priority?: "critical" | "high" | "medium" | "low" | undefined;
+    concurrencyPolicy?: "coalesce_if_active" | "always_enqueue" | "skip_if_active" | undefined;
+    catchUpPolicy?: "skip_missed" | "enqueue_missed_with_cap" | undefined;
+    variables?: {
+        required: boolean;
+        options: string[];
+        type: "number" | "boolean" | "text" | "textarea" | "select";
+        name: string;
+        label?: string | null | undefined;
+        defaultValue?: string | number | boolean | null | undefined;
+    }[] | undefined;
+    triggers?: {
+        kind: "schedule" | "webhook" | "api";
+        label?: string | null | undefined;
+        enabled?: boolean | undefined;
+        cronExpression?: string | null | undefined;
+        timezone?: string | null | undefined;
+        signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+        replayWindowSec?: number | null | undefined;
+    }[] | undefined;
+    assigneeRef?: {
+        resourceKind: "agent";
+        resourceKey: string;
+        pluginKey?: string | undefined;
+    } | null | undefined;
+    projectRef?: {
+        resourceKind: "project";
+        resourceKey: string;
+        pluginKey?: string | undefined;
+    } | null | undefined;
+    issueTemplate?: {
+        billingCode?: string | null | undefined;
+        surfaceVisibility?: "default" | "plugin_operation" | undefined;
+        originId?: string | null | undefined;
+    } | undefined;
+}, {
+    title: string;
+    routineKey: string;
+    description?: string | null | undefined;
+    status?: "active" | "paused" | "archived" | undefined;
+    goalId?: string | null | undefined;
+    priority?: "critical" | "high" | "medium" | "low" | undefined;
+    concurrencyPolicy?: "coalesce_if_active" | "always_enqueue" | "skip_if_active" | undefined;
+    catchUpPolicy?: "skip_missed" | "enqueue_missed_with_cap" | undefined;
+    variables?: {
+        name: string;
+        required?: boolean | undefined;
+        label?: string | null | undefined;
+        options?: string[] | undefined;
+        type?: "number" | "boolean" | "text" | "textarea" | "select" | undefined;
+        defaultValue?: string | number | boolean | null | undefined;
+    }[] | undefined;
+    triggers?: {
+        kind: "schedule" | "webhook" | "api";
+        label?: string | null | undefined;
+        enabled?: boolean | undefined;
+        cronExpression?: string | null | undefined;
+        timezone?: string | null | undefined;
+        signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+        replayWindowSec?: number | null | undefined;
+    }[] | undefined;
+    assigneeRef?: {
+        resourceKind: "agent";
+        resourceKey: string;
+        pluginKey?: string | undefined;
+    } | null | undefined;
+    projectRef?: {
+        resourceKind: "project";
+        resourceKey: string;
+        pluginKey?: string | undefined;
+    } | null | undefined;
+    issueTemplate?: {
+        billingCode?: string | null | undefined;
+        surfaceVisibility?: "default" | "plugin_operation" | undefined;
+        originId?: string | null | undefined;
+    } | undefined;
+}>;
+export type PluginManagedRoutineDeclarationInput = z.infer<typeof pluginManagedRoutineDeclarationSchema>;
+export declare const pluginLocalFolderDeclarationSchema: z.ZodObject<{
+    folderKey: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    access: z.ZodOptional<z.ZodEnum<["read", "readWrite"]>>;
+    requiredDirectories: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    requiredFiles: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    folderKey: string;
+    description?: string | undefined;
+    access?: "read" | "readWrite" | undefined;
+    requiredDirectories?: string[] | undefined;
+    requiredFiles?: string[] | undefined;
+}, {
+    displayName: string;
+    folderKey: string;
+    description?: string | undefined;
+    access?: "read" | "readWrite" | undefined;
+    requiredDirectories?: string[] | undefined;
+    requiredFiles?: string[] | undefined;
+}>;
+export type PluginLocalFolderDeclarationInput = z.infer<typeof pluginLocalFolderDeclarationSchema>;
+/**
+ * Validates a {@link PluginUiSlotDeclaration} — a UI extension slot the plugin
+ * 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
+ */
+export declare const pluginUiSlotDeclarationSchema: z.ZodEffects<z.ZodObject<{
+    type: z.ZodEnum<["page", "detailTab", "taskDetailView", "dashboardWidget", "sidebar", "routeSidebar", "sidebarPanel", "projectSidebarItem", "globalToolbarButton", "toolbarButton", "contextMenuItem", "commentAnnotation", "commentContextMenuItem", "settingsPage"]>;
+    id: z.ZodString;
+    displayName: z.ZodString;
+    exportName: z.ZodString;
+    entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["project", "issue", "agent", "goal", "run", "comment"]>, "many">>;
+    routePath: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+    displayName: string;
+    exportName: string;
+    entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+    routePath?: string | undefined;
+    order?: number | undefined;
+}, {
+    id: string;
+    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+    displayName: string;
+    exportName: string;
+    entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+    routePath?: string | undefined;
+    order?: number | undefined;
+}>, {
+    id: string;
+    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+    displayName: string;
+    exportName: string;
+    entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+    routePath?: string | undefined;
+    order?: number | undefined;
+}, {
+    id: string;
+    type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+    displayName: string;
+    exportName: string;
+    entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+    routePath?: string | undefined;
+    order?: number | undefined;
+}>;
+export type PluginUiSlotDeclarationInput = z.infer<typeof pluginUiSlotDeclarationSchema>;
+/**
+ * Validates the action payload for a declarative plugin launcher.
+ */
+export declare const pluginLauncherActionDeclarationSchema: z.ZodEffects<z.ZodObject<{
+    type: z.ZodEnum<["navigate", "openModal", "openDrawer", "openPopover", "performAction", "deepLink"]>;
+    target: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    target: string;
+    type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+    params?: Record<string, unknown> | undefined;
+}, {
+    target: string;
+    type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+    params?: Record<string, unknown> | undefined;
+}>, {
+    target: string;
+    type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+    params?: Record<string, unknown> | undefined;
+}, {
+    target: string;
+    type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+    params?: Record<string, unknown> | undefined;
+}>;
+export type PluginLauncherActionDeclarationInput = z.infer<typeof pluginLauncherActionDeclarationSchema>;
+/**
+ * Validates optional render hints for a plugin launcher destination.
+ */
+export declare const pluginLauncherRenderDeclarationSchema: z.ZodEffects<z.ZodObject<{
+    environment: z.ZodEnum<["hostInline", "hostOverlay", "hostRoute", "external", "iframe"]>;
+    bounds: z.ZodOptional<z.ZodEnum<["inline", "compact", "default", "wide", "full"]>>;
+}, "strip", z.ZodTypeAny, {
+    environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+    bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+}, {
+    environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+    bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+}>, {
+    environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+    bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+}, {
+    environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+    bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+}>;
+export type PluginLauncherRenderDeclarationInput = z.infer<typeof pluginLauncherRenderDeclarationSchema>;
+/**
+ * Validates declarative launcher metadata in a plugin manifest.
+ */
+export declare const pluginLauncherDeclarationSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    placementZone: z.ZodEnum<["page", "detailTab", "taskDetailView", "dashboardWidget", "sidebar", "sidebarPanel", "projectSidebarItem", "globalToolbarButton", "toolbarButton", "contextMenuItem", "commentAnnotation", "commentContextMenuItem", "settingsPage"]>;
+    exportName: z.ZodOptional<z.ZodString>;
+    entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["project", "issue", "agent", "goal", "run", "comment"]>, "many">>;
+    order: z.ZodOptional<z.ZodNumber>;
+    action: z.ZodEffects<z.ZodObject<{
+        type: z.ZodEnum<["navigate", "openModal", "openDrawer", "openPopover", "performAction", "deepLink"]>;
+        target: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        target: string;
+        type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+        params?: Record<string, unknown> | undefined;
+    }, {
+        target: string;
+        type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+        params?: Record<string, unknown> | undefined;
+    }>, {
+        target: string;
+        type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+        params?: Record<string, unknown> | undefined;
+    }, {
+        target: string;
+        type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+        params?: Record<string, unknown> | undefined;
+    }>;
+    render: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        environment: z.ZodEnum<["hostInline", "hostOverlay", "hostRoute", "external", "iframe"]>;
+        bounds: z.ZodOptional<z.ZodEnum<["inline", "compact", "default", "wide", "full"]>>;
+    }, "strip", z.ZodTypeAny, {
+        environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+        bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+    }, {
+        environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+        bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+    }>, {
+        environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+        bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+    }, {
+        environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+        bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    action: {
+        target: string;
+        type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+        params?: Record<string, unknown> | undefined;
+    };
+    displayName: string;
+    placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+    description?: string | undefined;
+    exportName?: string | undefined;
+    entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+    order?: number | undefined;
+    render?: {
+        environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+        bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+    } | undefined;
+}, {
+    id: string;
+    action: {
+        target: string;
+        type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+        params?: Record<string, unknown> | undefined;
+    };
+    displayName: string;
+    placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+    description?: string | undefined;
+    exportName?: string | undefined;
+    entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+    order?: number | undefined;
+    render?: {
+        environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+        bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+    } | undefined;
+}>, {
+    id: string;
+    action: {
+        target: string;
+        type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+        params?: Record<string, unknown> | undefined;
+    };
+    displayName: string;
+    placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+    description?: string | undefined;
+    exportName?: string | undefined;
+    entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+    order?: number | undefined;
+    render?: {
+        environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+        bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+    } | undefined;
+}, {
+    id: string;
+    action: {
+        target: string;
+        type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+        params?: Record<string, unknown> | undefined;
+    };
+    displayName: string;
+    placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+    description?: string | undefined;
+    exportName?: string | undefined;
+    entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+    order?: number | undefined;
+    render?: {
+        environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+        bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+    } | undefined;
+}>;
+export type PluginLauncherDeclarationInput = z.infer<typeof pluginLauncherDeclarationSchema>;
+export declare const pluginDatabaseDeclarationSchema: z.ZodObject<{
+    namespaceSlug: z.ZodOptional<z.ZodString>;
+    migrationsDir: z.ZodEffects<z.ZodString, string, string>;
+    coreReadTables: z.ZodOptional<z.ZodArray<z.ZodEnum<["companies", "projects", "goals", "agents", "issues", "issue_documents", "issue_relations", "issue_comments", "heartbeat_runs", "cost_events", "approvals", "issue_approvals", "budget_incidents"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    migrationsDir: string;
+    namespaceSlug?: string | undefined;
+    coreReadTables?: ("companies" | "projects" | "goals" | "agents" | "issues" | "issue_documents" | "issue_relations" | "issue_comments" | "heartbeat_runs" | "cost_events" | "approvals" | "issue_approvals" | "budget_incidents")[] | undefined;
+}, {
+    migrationsDir: string;
+    namespaceSlug?: string | undefined;
+    coreReadTables?: ("companies" | "projects" | "goals" | "agents" | "issues" | "issue_documents" | "issue_relations" | "issue_comments" | "heartbeat_runs" | "cost_events" | "approvals" | "issue_approvals" | "budget_incidents")[] | undefined;
+}>;
+export type PluginDatabaseDeclarationInput = z.infer<typeof pluginDatabaseDeclarationSchema>;
+export declare const pluginApiRouteDeclarationSchema: z.ZodObject<{
+    routeKey: z.ZodString;
+    method: z.ZodEnum<["GET", "POST", "PATCH", "DELETE"]>;
+    path: z.ZodEffects<z.ZodString, string, string>;
+    auth: z.ZodEnum<["board", "agent", "board-or-agent", "webhook"]>;
+    capability: z.ZodLiteral<"api.routes.register">;
+    checkoutPolicy: z.ZodOptional<z.ZodEnum<["none", "required-for-agent-in-progress", "always-for-agent"]>>;
+    companyResolution: z.ZodOptional<z.ZodDiscriminatedUnion<"from", [z.ZodObject<{
+        from: z.ZodLiteral<"body">;
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        from: "body";
+    }, {
+        key: string;
+        from: "body";
+    }>, z.ZodObject<{
+        from: z.ZodLiteral<"query">;
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        from: "query";
+    }, {
+        key: string;
+        from: "query";
+    }>, z.ZodObject<{
+        from: z.ZodLiteral<"issue">;
+        param: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: "issue";
+        param: string;
+    }, {
+        from: "issue";
+        param: string;
+    }>]>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    routeKey: string;
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    auth: "agent" | "board" | "webhook" | "board-or-agent";
+    capability: "api.routes.register";
+    checkoutPolicy?: "none" | "required-for-agent-in-progress" | "always-for-agent" | undefined;
+    companyResolution?: {
+        key: string;
+        from: "body";
+    } | {
+        key: string;
+        from: "query";
+    } | {
+        from: "issue";
+        param: string;
+    } | undefined;
+}, {
+    path: string;
+    routeKey: string;
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    auth: "agent" | "board" | "webhook" | "board-or-agent";
+    capability: "api.routes.register";
+    checkoutPolicy?: "none" | "required-for-agent-in-progress" | "always-for-agent" | undefined;
+    companyResolution?: {
+        key: string;
+        from: "body";
+    } | {
+        key: string;
+        from: "query";
+    } | {
+        from: "issue";
+        param: string;
+    } | undefined;
+}>;
+export type PluginApiRouteDeclarationInput = z.infer<typeof pluginApiRouteDeclarationSchema>;
+/**
+ * Zod schema for {@link EvermorePluginManifestV1} — 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                    | Type       | Constraints                                  |
+ * |--------------------------|------------|----------------------------------------------|
+ * | `id`                     | string     | `^[a-z0-9][a-z0-9._-]*$`                    |
+ * | `apiVersion`             | literal 1  | must equal `PLUGIN_API_VERSION`              |
+ * | `version`                | string     | semver (`\d+\.\d+\.\d+`)                    |
+ * | `displayName`            | string     | 1–100 chars                                  |
+ * | `description`            | string     | 1–500 chars                                  |
+ * | `author`                 | string     | 1–200 chars                                  |
+ * | `categories`             | enum[]     | at least one; values from PLUGIN_CATEGORIES  |
+ * | `minimumHostVersion`     | string?    | semver lower bound if present, no leading `v`|
+ * | `minimumEvermoreVersion`| string?    | legacy alias of `minimumHostVersion`         |
+ * | `capabilities`           | enum[]     | at least one; values from PLUGIN_CAPABILITIES|
+ * | `entrypoints.worker`     | string     | min 1 char                                   |
+ * | `entrypoints.ui`         | string?    | required when `ui.slots` is declared         |
+ *
+ * Cross-field rules enforced via `superRefine`:
+ * - `entrypoints.ui` required when `ui.slots` declared
+ * - `agent.tools.register` capability required when `tools` declared
+ * - `environment.drivers.register` capability required when `environmentDrivers` declared
+ * - `jobs.schedule` capability required when `jobs` declared
+ * - `webhooks.receive` capability required when `webhooks` declared
+ * - duplicate `jobs[].jobKey` values are rejected
+ * - duplicate `webhooks[].endpointKey` values are rejected
+ * - duplicate `tools[].name` values are rejected
+ * - duplicate `environmentDrivers[].driverKey` values are rejected
+ * - duplicate `ui.slots[].id` values are rejected
+ *
+ * @see PLUGIN_SPEC.md §10.1 — Manifest shape
+ * @see {@link EvermorePluginManifestV1} — the inferred TypeScript type
+ */
+export declare const pluginManifestV1Schema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    apiVersion: z.ZodLiteral<1>;
+    version: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodString;
+    categories: z.ZodArray<z.ZodEnum<["connector", "workspace", "automation", "ui"]>, "many">;
+    minimumHostVersion: z.ZodOptional<z.ZodString>;
+    minimumEvermoreVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodArray<z.ZodEnum<["companies.read", "projects.read", "project.workspaces.read", "issues.read", "issue.relations.read", "issue.subtree.read", "issue.comments.read", "issue.documents.read", "agents.read", "goals.read", "goals.create", "goals.update", "activity.read", "costs.read", "issues.orchestration.read", "database.namespace.read", "issues.create", "issues.update", "issue.relations.write", "issues.checkout", "issues.wakeup", "issue.comments.create", "issue.interactions.create", "issue.documents.write", "projects.managed", "routines.managed", "agents.pause", "agents.resume", "agents.invoke", "agents.managed", "agent.sessions.create", "agent.sessions.list", "agent.sessions.send", "agent.sessions.close", "activity.log.write", "metrics.write", "telemetry.track", "database.namespace.migrate", "database.namespace.write", "plugin.state.read", "plugin.state.write", "events.subscribe", "events.emit", "jobs.schedule", "webhooks.receive", "api.routes.register", "http.outbound", "secrets.read-ref", "environment.drivers.register", "local.folders", "agent.tools.register", "instance.settings.register", "ui.sidebar.register", "ui.page.register", "ui.detailTab.register", "ui.dashboardWidget.register", "ui.commentAnnotation.register", "ui.action.register"]>, "many">;
+    entrypoints: z.ZodObject<{
+        worker: z.ZodString;
+        ui: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        worker: string;
+        ui?: string | undefined;
+    }, {
+        worker: string;
+        ui?: string | undefined;
+    }>;
+    instanceConfigSchema: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>>;
+    jobs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        jobKey: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        schedule: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strip", z.ZodTypeAny, {
+        jobKey: string;
+        displayName: string;
+        description?: string | undefined;
+        schedule?: string | undefined;
+    }, {
+        jobKey: string;
+        displayName: string;
+        description?: string | undefined;
+        schedule?: string | undefined;
+    }>, "many">>;
+    webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        endpointKey: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        endpointKey: string;
+        description?: string | undefined;
+    }, {
+        displayName: string;
+        endpointKey: string;
+        description?: string | undefined;
+    }>, "many">>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodString;
+        parametersSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        name: string;
+        displayName: string;
+        parametersSchema: Record<string, unknown>;
+    }, {
+        description: string;
+        name: string;
+        displayName: string;
+        parametersSchema: Record<string, unknown>;
+    }>, "many">>;
+    database: z.ZodOptional<z.ZodObject<{
+        namespaceSlug: z.ZodOptional<z.ZodString>;
+        migrationsDir: z.ZodEffects<z.ZodString, string, string>;
+        coreReadTables: z.ZodOptional<z.ZodArray<z.ZodEnum<["companies", "projects", "goals", "agents", "issues", "issue_documents", "issue_relations", "issue_comments", "heartbeat_runs", "cost_events", "approvals", "issue_approvals", "budget_incidents"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        migrationsDir: string;
+        namespaceSlug?: string | undefined;
+        coreReadTables?: ("companies" | "projects" | "goals" | "agents" | "issues" | "issue_documents" | "issue_relations" | "issue_comments" | "heartbeat_runs" | "cost_events" | "approvals" | "issue_approvals" | "budget_incidents")[] | undefined;
+    }, {
+        migrationsDir: string;
+        namespaceSlug?: string | undefined;
+        coreReadTables?: ("companies" | "projects" | "goals" | "agents" | "issues" | "issue_documents" | "issue_relations" | "issue_comments" | "heartbeat_runs" | "cost_events" | "approvals" | "issue_approvals" | "budget_incidents")[] | undefined;
+    }>>;
+    apiRoutes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        routeKey: z.ZodString;
+        method: z.ZodEnum<["GET", "POST", "PATCH", "DELETE"]>;
+        path: z.ZodEffects<z.ZodString, string, string>;
+        auth: z.ZodEnum<["board", "agent", "board-or-agent", "webhook"]>;
+        capability: z.ZodLiteral<"api.routes.register">;
+        checkoutPolicy: z.ZodOptional<z.ZodEnum<["none", "required-for-agent-in-progress", "always-for-agent"]>>;
+        companyResolution: z.ZodOptional<z.ZodDiscriminatedUnion<"from", [z.ZodObject<{
+            from: z.ZodLiteral<"body">;
+            key: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            from: "body";
+        }, {
+            key: string;
+            from: "body";
+        }>, z.ZodObject<{
+            from: z.ZodLiteral<"query">;
+            key: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            from: "query";
+        }, {
+            key: string;
+            from: "query";
+        }>, z.ZodObject<{
+            from: z.ZodLiteral<"issue">;
+            param: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            from: "issue";
+            param: string;
+        }, {
+            from: "issue";
+            param: string;
+        }>]>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        routeKey: string;
+        method: "GET" | "POST" | "PATCH" | "DELETE";
+        auth: "agent" | "board" | "webhook" | "board-or-agent";
+        capability: "api.routes.register";
+        checkoutPolicy?: "none" | "required-for-agent-in-progress" | "always-for-agent" | undefined;
+        companyResolution?: {
+            key: string;
+            from: "body";
+        } | {
+            key: string;
+            from: "query";
+        } | {
+            from: "issue";
+            param: string;
+        } | undefined;
+    }, {
+        path: string;
+        routeKey: string;
+        method: "GET" | "POST" | "PATCH" | "DELETE";
+        auth: "agent" | "board" | "webhook" | "board-or-agent";
+        capability: "api.routes.register";
+        checkoutPolicy?: "none" | "required-for-agent-in-progress" | "always-for-agent" | undefined;
+        companyResolution?: {
+            key: string;
+            from: "body";
+        } | {
+            key: string;
+            from: "query";
+        } | {
+            from: "issue";
+            param: string;
+        } | undefined;
+    }>, "many">>;
+    environmentDrivers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        driverKey: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<["environment_driver", "sandbox_provider"]>>;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        configSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnknown>, Record<string, unknown>, Record<string, unknown>>;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        driverKey: string;
+        configSchema: Record<string, unknown>;
+        description?: string | undefined;
+        kind?: "environment_driver" | "sandbox_provider" | undefined;
+    }, {
+        displayName: string;
+        driverKey: string;
+        configSchema: Record<string, unknown>;
+        description?: string | undefined;
+        kind?: "environment_driver" | "sandbox_provider" | undefined;
+    }>, "many">>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agentKey: z.ZodString;
+        displayName: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        capabilities: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        adapterType: z.ZodOptional<z.ZodString>;
+        adapterPreference: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        adapterConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        runtimeConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        status: z.ZodOptional<z.ZodEnum<["idle", "paused"]>>;
+        budgetMonthlyCents: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodObject<{
+            entryFile: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+            assetPath: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content?: string | undefined;
+            entryFile?: string | undefined;
+            assetPath?: string | undefined;
+        }, {
+            content?: string | undefined;
+            entryFile?: string | undefined;
+            assetPath?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        agentKey: string;
+        title?: string | null | undefined;
+        status?: "paused" | "idle" | undefined;
+        budgetMonthlyCents?: number | undefined;
+        adapterType?: string | undefined;
+        adapterConfig?: Record<string, unknown> | undefined;
+        instructions?: {
+            content?: string | undefined;
+            entryFile?: string | undefined;
+            assetPath?: string | undefined;
+        } | undefined;
+        role?: string | undefined;
+        icon?: string | null | undefined;
+        capabilities?: string | null | undefined;
+        runtimeConfig?: Record<string, unknown> | undefined;
+        permissions?: Record<string, unknown> | undefined;
+        adapterPreference?: string[] | undefined;
+    }, {
+        displayName: string;
+        agentKey: string;
+        title?: string | null | undefined;
+        status?: "paused" | "idle" | undefined;
+        budgetMonthlyCents?: number | undefined;
+        adapterType?: string | undefined;
+        adapterConfig?: Record<string, unknown> | undefined;
+        instructions?: {
+            content?: string | undefined;
+            entryFile?: string | undefined;
+            assetPath?: string | undefined;
+        } | undefined;
+        role?: string | undefined;
+        icon?: string | null | undefined;
+        capabilities?: string | null | undefined;
+        runtimeConfig?: Record<string, unknown> | undefined;
+        permissions?: Record<string, unknown> | undefined;
+        adapterPreference?: string[] | undefined;
+    }>, "many">>;
+    projects: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        projectKey: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodEnum<["backlog", "planned", "in_progress", "completed", "cancelled"]>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        projectKey: string;
+        description?: string | null | undefined;
+        settings?: Record<string, unknown> | undefined;
+        status?: "backlog" | "in_progress" | "cancelled" | "completed" | "planned" | undefined;
+        color?: string | null | undefined;
+    }, {
+        displayName: string;
+        projectKey: string;
+        description?: string | null | undefined;
+        settings?: Record<string, unknown> | undefined;
+        status?: "backlog" | "in_progress" | "cancelled" | "completed" | "planned" | undefined;
+        color?: string | null | undefined;
+    }>, "many">>;
+    routines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        routineKey: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        assigneeRef: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            pluginKey: z.ZodOptional<z.ZodString>;
+            resourceKey: z.ZodString;
+        } & {
+            resourceKind: z.ZodLiteral<"agent">;
+        }, "strip", z.ZodTypeAny, {
+            resourceKind: "agent";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        }, {
+            resourceKind: "agent";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        }>>>;
+        projectRef: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            pluginKey: z.ZodOptional<z.ZodString>;
+            resourceKey: z.ZodString;
+        } & {
+            resourceKind: z.ZodLiteral<"project">;
+        }, "strip", z.ZodTypeAny, {
+            resourceKind: "project";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        }, {
+            resourceKind: "project";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        }>>>;
+        goalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodEnum<["active", "paused", "archived"]>>;
+        priority: z.ZodOptional<z.ZodEnum<["critical", "high", "medium", "low"]>>;
+        concurrencyPolicy: z.ZodOptional<z.ZodEnum<["coalesce_if_active", "always_enqueue", "skip_if_active"]>>;
+        catchUpPolicy: z.ZodOptional<z.ZodEnum<["skip_missed", "enqueue_missed_with_cap"]>>;
+        variables: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["text", "textarea", "number", "boolean", "select"]>>>;
+            defaultValue: z.ZodNullable<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            options: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        }, "strip", z.ZodTypeAny, {
+            required: boolean;
+            options: string[];
+            type: "number" | "boolean" | "text" | "textarea" | "select";
+            name: string;
+            label?: string | null | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }, {
+            name: string;
+            required?: boolean | undefined;
+            label?: string | null | undefined;
+            options?: string[] | undefined;
+            type?: "number" | "boolean" | "text" | "textarea" | "select" | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }>, {
+            required: boolean;
+            options: string[];
+            type: "number" | "boolean" | "text" | "textarea" | "select";
+            name: string;
+            label?: string | null | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }, {
+            name: string;
+            required?: boolean | undefined;
+            label?: string | null | undefined;
+            options?: string[] | undefined;
+            type?: "number" | "boolean" | "text" | "textarea" | "select" | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }>, "many">>;
+        triggers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["schedule", "webhook", "api"]>;
+            label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            cronExpression: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            timezone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            signingMode: z.ZodNullable<z.ZodOptional<z.ZodEnum<["bearer", "hmac_sha256", "github_hmac", "none"]>>>;
+            replayWindowSec: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "schedule" | "webhook" | "api";
+            label?: string | null | undefined;
+            enabled?: boolean | undefined;
+            cronExpression?: string | null | undefined;
+            timezone?: string | null | undefined;
+            signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+            replayWindowSec?: number | null | undefined;
+        }, {
+            kind: "schedule" | "webhook" | "api";
+            label?: string | null | undefined;
+            enabled?: boolean | undefined;
+            cronExpression?: string | null | undefined;
+            timezone?: string | null | undefined;
+            signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+            replayWindowSec?: number | null | undefined;
+        }>, "many">>;
+        issueTemplate: z.ZodOptional<z.ZodObject<{
+            surfaceVisibility: z.ZodOptional<z.ZodEnum<["default", "plugin_operation"]>>;
+            originId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            billingCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            billingCode?: string | null | undefined;
+            surfaceVisibility?: "default" | "plugin_operation" | undefined;
+            originId?: string | null | undefined;
+        }, {
+            billingCode?: string | null | undefined;
+            surfaceVisibility?: "default" | "plugin_operation" | undefined;
+            originId?: string | null | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        routineKey: string;
+        description?: string | null | undefined;
+        status?: "active" | "paused" | "archived" | undefined;
+        goalId?: string | null | undefined;
+        priority?: "critical" | "high" | "medium" | "low" | undefined;
+        concurrencyPolicy?: "coalesce_if_active" | "always_enqueue" | "skip_if_active" | undefined;
+        catchUpPolicy?: "skip_missed" | "enqueue_missed_with_cap" | undefined;
+        variables?: {
+            required: boolean;
+            options: string[];
+            type: "number" | "boolean" | "text" | "textarea" | "select";
+            name: string;
+            label?: string | null | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }[] | undefined;
+        triggers?: {
+            kind: "schedule" | "webhook" | "api";
+            label?: string | null | undefined;
+            enabled?: boolean | undefined;
+            cronExpression?: string | null | undefined;
+            timezone?: string | null | undefined;
+            signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+            replayWindowSec?: number | null | undefined;
+        }[] | undefined;
+        assigneeRef?: {
+            resourceKind: "agent";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        projectRef?: {
+            resourceKind: "project";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        issueTemplate?: {
+            billingCode?: string | null | undefined;
+            surfaceVisibility?: "default" | "plugin_operation" | undefined;
+            originId?: string | null | undefined;
+        } | undefined;
+    }, {
+        title: string;
+        routineKey: string;
+        description?: string | null | undefined;
+        status?: "active" | "paused" | "archived" | undefined;
+        goalId?: string | null | undefined;
+        priority?: "critical" | "high" | "medium" | "low" | undefined;
+        concurrencyPolicy?: "coalesce_if_active" | "always_enqueue" | "skip_if_active" | undefined;
+        catchUpPolicy?: "skip_missed" | "enqueue_missed_with_cap" | undefined;
+        variables?: {
+            name: string;
+            required?: boolean | undefined;
+            label?: string | null | undefined;
+            options?: string[] | undefined;
+            type?: "number" | "boolean" | "text" | "textarea" | "select" | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }[] | undefined;
+        triggers?: {
+            kind: "schedule" | "webhook" | "api";
+            label?: string | null | undefined;
+            enabled?: boolean | undefined;
+            cronExpression?: string | null | undefined;
+            timezone?: string | null | undefined;
+            signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+            replayWindowSec?: number | null | undefined;
+        }[] | undefined;
+        assigneeRef?: {
+            resourceKind: "agent";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        projectRef?: {
+            resourceKind: "project";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        issueTemplate?: {
+            billingCode?: string | null | undefined;
+            surfaceVisibility?: "default" | "plugin_operation" | undefined;
+            originId?: string | null | undefined;
+        } | undefined;
+    }>, "many">>;
+    localFolders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        folderKey: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        access: z.ZodOptional<z.ZodEnum<["read", "readWrite"]>>;
+        requiredDirectories: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        requiredFiles: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        folderKey: string;
+        description?: string | undefined;
+        access?: "read" | "readWrite" | undefined;
+        requiredDirectories?: string[] | undefined;
+        requiredFiles?: string[] | undefined;
+    }, {
+        displayName: string;
+        folderKey: string;
+        description?: string | undefined;
+        access?: "read" | "readWrite" | undefined;
+        requiredDirectories?: string[] | undefined;
+        requiredFiles?: string[] | undefined;
+    }>, "many">>;
+    launchers: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        placementZone: z.ZodEnum<["page", "detailTab", "taskDetailView", "dashboardWidget", "sidebar", "sidebarPanel", "projectSidebarItem", "globalToolbarButton", "toolbarButton", "contextMenuItem", "commentAnnotation", "commentContextMenuItem", "settingsPage"]>;
+        exportName: z.ZodOptional<z.ZodString>;
+        entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["project", "issue", "agent", "goal", "run", "comment"]>, "many">>;
+        order: z.ZodOptional<z.ZodNumber>;
+        action: z.ZodEffects<z.ZodObject<{
+            type: z.ZodEnum<["navigate", "openModal", "openDrawer", "openPopover", "performAction", "deepLink"]>;
+            target: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        }, {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        }>, {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        }, {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        }>;
+        render: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            environment: z.ZodEnum<["hostInline", "hostOverlay", "hostRoute", "external", "iframe"]>;
+            bounds: z.ZodOptional<z.ZodEnum<["inline", "compact", "default", "wide", "full"]>>;
+        }, "strip", z.ZodTypeAny, {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        }, {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        }>, {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        }, {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        action: {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        };
+        displayName: string;
+        placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+        description?: string | undefined;
+        exportName?: string | undefined;
+        entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+        order?: number | undefined;
+        render?: {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        action: {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        };
+        displayName: string;
+        placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+        description?: string | undefined;
+        exportName?: string | undefined;
+        entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+        order?: number | undefined;
+        render?: {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        } | undefined;
+    }>, {
+        id: string;
+        action: {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        };
+        displayName: string;
+        placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+        description?: string | undefined;
+        exportName?: string | undefined;
+        entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+        order?: number | undefined;
+        render?: {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        action: {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        };
+        displayName: string;
+        placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+        description?: string | undefined;
+        exportName?: string | undefined;
+        entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+        order?: number | undefined;
+        render?: {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        } | undefined;
+    }>, "many">>;
+    ui: z.ZodOptional<z.ZodObject<{
+        slots: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+            type: z.ZodEnum<["page", "detailTab", "taskDetailView", "dashboardWidget", "sidebar", "routeSidebar", "sidebarPanel", "projectSidebarItem", "globalToolbarButton", "toolbarButton", "contextMenuItem", "commentAnnotation", "commentContextMenuItem", "settingsPage"]>;
+            id: z.ZodString;
+            displayName: z.ZodString;
+            exportName: z.ZodString;
+            entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["project", "issue", "agent", "goal", "run", "comment"]>, "many">>;
+            routePath: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }, {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }>, {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }, {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }>, "many">>;
+        launchers: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+            id: z.ZodString;
+            displayName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            placementZone: z.ZodEnum<["page", "detailTab", "taskDetailView", "dashboardWidget", "sidebar", "sidebarPanel", "projectSidebarItem", "globalToolbarButton", "toolbarButton", "contextMenuItem", "commentAnnotation", "commentContextMenuItem", "settingsPage"]>;
+            exportName: z.ZodOptional<z.ZodString>;
+            entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["project", "issue", "agent", "goal", "run", "comment"]>, "many">>;
+            order: z.ZodOptional<z.ZodNumber>;
+            action: z.ZodEffects<z.ZodObject<{
+                type: z.ZodEnum<["navigate", "openModal", "openDrawer", "openPopover", "performAction", "deepLink"]>;
+                target: z.ZodString;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, "strip", z.ZodTypeAny, {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            }, {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            }>, {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            }, {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            }>;
+            render: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+                environment: z.ZodEnum<["hostInline", "hostOverlay", "hostRoute", "external", "iframe"]>;
+                bounds: z.ZodOptional<z.ZodEnum<["inline", "compact", "default", "wide", "full"]>>;
+            }, "strip", z.ZodTypeAny, {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            }, {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            }>, {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            }, {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }, {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }>, {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }, {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        launchers?: {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }[] | undefined;
+        slots?: {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+    }, {
+        launchers?: {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }[] | undefined;
+        slots?: {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    id: string;
+    version: string;
+    capabilities: ("companies.read" | "projects.read" | "project.workspaces.read" | "issues.read" | "issue.relations.read" | "issue.subtree.read" | "issue.comments.read" | "issue.documents.read" | "agents.read" | "goals.read" | "goals.create" | "goals.update" | "activity.read" | "costs.read" | "issues.orchestration.read" | "database.namespace.read" | "issues.create" | "issues.update" | "issue.relations.write" | "issues.checkout" | "issues.wakeup" | "issue.comments.create" | "issue.interactions.create" | "issue.documents.write" | "projects.managed" | "routines.managed" | "agents.pause" | "agents.resume" | "agents.invoke" | "agents.managed" | "agent.sessions.create" | "agent.sessions.list" | "agent.sessions.send" | "agent.sessions.close" | "activity.log.write" | "metrics.write" | "telemetry.track" | "database.namespace.migrate" | "database.namespace.write" | "plugin.state.read" | "plugin.state.write" | "events.subscribe" | "events.emit" | "jobs.schedule" | "webhooks.receive" | "api.routes.register" | "http.outbound" | "secrets.read-ref" | "environment.drivers.register" | "local.folders" | "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;
+    author: string;
+    categories: ("automation" | "connector" | "workspace" | "ui")[];
+    entrypoints: {
+        worker: string;
+        ui?: string | undefined;
+    };
+    database?: {
+        migrationsDir: string;
+        namespaceSlug?: string | undefined;
+        coreReadTables?: ("companies" | "projects" | "goals" | "agents" | "issues" | "issue_documents" | "issue_relations" | "issue_comments" | "heartbeat_runs" | "cost_events" | "approvals" | "issue_approvals" | "budget_incidents")[] | undefined;
+    } | undefined;
+    ui?: {
+        launchers?: {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }[] | undefined;
+        slots?: {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+    } | undefined;
+    projects?: {
+        displayName: string;
+        projectKey: string;
+        description?: string | null | undefined;
+        settings?: Record<string, unknown> | undefined;
+        status?: "backlog" | "in_progress" | "cancelled" | "completed" | "planned" | undefined;
+        color?: string | null | undefined;
+    }[] | undefined;
+    agents?: {
+        displayName: string;
+        agentKey: string;
+        title?: string | null | undefined;
+        status?: "paused" | "idle" | undefined;
+        budgetMonthlyCents?: number | undefined;
+        adapterType?: string | undefined;
+        adapterConfig?: Record<string, unknown> | undefined;
+        instructions?: {
+            content?: string | undefined;
+            entryFile?: string | undefined;
+            assetPath?: string | undefined;
+        } | undefined;
+        role?: string | undefined;
+        icon?: string | null | undefined;
+        capabilities?: string | null | undefined;
+        runtimeConfig?: Record<string, unknown> | undefined;
+        permissions?: Record<string, unknown> | undefined;
+        adapterPreference?: string[] | undefined;
+    }[] | undefined;
+    jobs?: {
+        jobKey: string;
+        displayName: string;
+        description?: string | undefined;
+        schedule?: string | undefined;
+    }[] | undefined;
+    minimumHostVersion?: string | undefined;
+    minimumEvermoreVersion?: string | undefined;
+    instanceConfigSchema?: Record<string, unknown> | undefined;
+    webhooks?: {
+        displayName: string;
+        endpointKey: string;
+        description?: string | undefined;
+    }[] | undefined;
+    tools?: {
+        description: string;
+        name: string;
+        displayName: string;
+        parametersSchema: Record<string, unknown>;
+    }[] | undefined;
+    apiRoutes?: {
+        path: string;
+        routeKey: string;
+        method: "GET" | "POST" | "PATCH" | "DELETE";
+        auth: "agent" | "board" | "webhook" | "board-or-agent";
+        capability: "api.routes.register";
+        checkoutPolicy?: "none" | "required-for-agent-in-progress" | "always-for-agent" | undefined;
+        companyResolution?: {
+            key: string;
+            from: "body";
+        } | {
+            key: string;
+            from: "query";
+        } | {
+            from: "issue";
+            param: string;
+        } | undefined;
+    }[] | undefined;
+    environmentDrivers?: {
+        displayName: string;
+        driverKey: string;
+        configSchema: Record<string, unknown>;
+        description?: string | undefined;
+        kind?: "environment_driver" | "sandbox_provider" | undefined;
+    }[] | undefined;
+    routines?: {
+        title: string;
+        routineKey: string;
+        description?: string | null | undefined;
+        status?: "active" | "paused" | "archived" | undefined;
+        goalId?: string | null | undefined;
+        priority?: "critical" | "high" | "medium" | "low" | undefined;
+        concurrencyPolicy?: "coalesce_if_active" | "always_enqueue" | "skip_if_active" | undefined;
+        catchUpPolicy?: "skip_missed" | "enqueue_missed_with_cap" | undefined;
+        variables?: {
+            required: boolean;
+            options: string[];
+            type: "number" | "boolean" | "text" | "textarea" | "select";
+            name: string;
+            label?: string | null | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }[] | undefined;
+        triggers?: {
+            kind: "schedule" | "webhook" | "api";
+            label?: string | null | undefined;
+            enabled?: boolean | undefined;
+            cronExpression?: string | null | undefined;
+            timezone?: string | null | undefined;
+            signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+            replayWindowSec?: number | null | undefined;
+        }[] | undefined;
+        assigneeRef?: {
+            resourceKind: "agent";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        projectRef?: {
+            resourceKind: "project";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        issueTemplate?: {
+            billingCode?: string | null | undefined;
+            surfaceVisibility?: "default" | "plugin_operation" | undefined;
+            originId?: string | null | undefined;
+        } | undefined;
+    }[] | undefined;
+    localFolders?: {
+        displayName: string;
+        folderKey: string;
+        description?: string | undefined;
+        access?: "read" | "readWrite" | undefined;
+        requiredDirectories?: string[] | undefined;
+        requiredFiles?: string[] | undefined;
+    }[] | undefined;
+    launchers?: {
+        id: string;
+        action: {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        };
+        displayName: string;
+        placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+        description?: string | undefined;
+        exportName?: string | undefined;
+        entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+        order?: number | undefined;
+        render?: {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        } | undefined;
+    }[] | undefined;
+}, {
+    description: string;
+    id: string;
+    version: string;
+    capabilities: ("companies.read" | "projects.read" | "project.workspaces.read" | "issues.read" | "issue.relations.read" | "issue.subtree.read" | "issue.comments.read" | "issue.documents.read" | "agents.read" | "goals.read" | "goals.create" | "goals.update" | "activity.read" | "costs.read" | "issues.orchestration.read" | "database.namespace.read" | "issues.create" | "issues.update" | "issue.relations.write" | "issues.checkout" | "issues.wakeup" | "issue.comments.create" | "issue.interactions.create" | "issue.documents.write" | "projects.managed" | "routines.managed" | "agents.pause" | "agents.resume" | "agents.invoke" | "agents.managed" | "agent.sessions.create" | "agent.sessions.list" | "agent.sessions.send" | "agent.sessions.close" | "activity.log.write" | "metrics.write" | "telemetry.track" | "database.namespace.migrate" | "database.namespace.write" | "plugin.state.read" | "plugin.state.write" | "events.subscribe" | "events.emit" | "jobs.schedule" | "webhooks.receive" | "api.routes.register" | "http.outbound" | "secrets.read-ref" | "environment.drivers.register" | "local.folders" | "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;
+    author: string;
+    categories: ("automation" | "connector" | "workspace" | "ui")[];
+    entrypoints: {
+        worker: string;
+        ui?: string | undefined;
+    };
+    database?: {
+        migrationsDir: string;
+        namespaceSlug?: string | undefined;
+        coreReadTables?: ("companies" | "projects" | "goals" | "agents" | "issues" | "issue_documents" | "issue_relations" | "issue_comments" | "heartbeat_runs" | "cost_events" | "approvals" | "issue_approvals" | "budget_incidents")[] | undefined;
+    } | undefined;
+    ui?: {
+        launchers?: {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }[] | undefined;
+        slots?: {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+    } | undefined;
+    projects?: {
+        displayName: string;
+        projectKey: string;
+        description?: string | null | undefined;
+        settings?: Record<string, unknown> | undefined;
+        status?: "backlog" | "in_progress" | "cancelled" | "completed" | "planned" | undefined;
+        color?: string | null | undefined;
+    }[] | undefined;
+    agents?: {
+        displayName: string;
+        agentKey: string;
+        title?: string | null | undefined;
+        status?: "paused" | "idle" | undefined;
+        budgetMonthlyCents?: number | undefined;
+        adapterType?: string | undefined;
+        adapterConfig?: Record<string, unknown> | undefined;
+        instructions?: {
+            content?: string | undefined;
+            entryFile?: string | undefined;
+            assetPath?: string | undefined;
+        } | undefined;
+        role?: string | undefined;
+        icon?: string | null | undefined;
+        capabilities?: string | null | undefined;
+        runtimeConfig?: Record<string, unknown> | undefined;
+        permissions?: Record<string, unknown> | undefined;
+        adapterPreference?: string[] | undefined;
+    }[] | undefined;
+    jobs?: {
+        jobKey: string;
+        displayName: string;
+        description?: string | undefined;
+        schedule?: string | undefined;
+    }[] | undefined;
+    minimumHostVersion?: string | undefined;
+    minimumEvermoreVersion?: string | undefined;
+    instanceConfigSchema?: Record<string, unknown> | undefined;
+    webhooks?: {
+        displayName: string;
+        endpointKey: string;
+        description?: string | undefined;
+    }[] | undefined;
+    tools?: {
+        description: string;
+        name: string;
+        displayName: string;
+        parametersSchema: Record<string, unknown>;
+    }[] | undefined;
+    apiRoutes?: {
+        path: string;
+        routeKey: string;
+        method: "GET" | "POST" | "PATCH" | "DELETE";
+        auth: "agent" | "board" | "webhook" | "board-or-agent";
+        capability: "api.routes.register";
+        checkoutPolicy?: "none" | "required-for-agent-in-progress" | "always-for-agent" | undefined;
+        companyResolution?: {
+            key: string;
+            from: "body";
+        } | {
+            key: string;
+            from: "query";
+        } | {
+            from: "issue";
+            param: string;
+        } | undefined;
+    }[] | undefined;
+    environmentDrivers?: {
+        displayName: string;
+        driverKey: string;
+        configSchema: Record<string, unknown>;
+        description?: string | undefined;
+        kind?: "environment_driver" | "sandbox_provider" | undefined;
+    }[] | undefined;
+    routines?: {
+        title: string;
+        routineKey: string;
+        description?: string | null | undefined;
+        status?: "active" | "paused" | "archived" | undefined;
+        goalId?: string | null | undefined;
+        priority?: "critical" | "high" | "medium" | "low" | undefined;
+        concurrencyPolicy?: "coalesce_if_active" | "always_enqueue" | "skip_if_active" | undefined;
+        catchUpPolicy?: "skip_missed" | "enqueue_missed_with_cap" | undefined;
+        variables?: {
+            name: string;
+            required?: boolean | undefined;
+            label?: string | null | undefined;
+            options?: string[] | undefined;
+            type?: "number" | "boolean" | "text" | "textarea" | "select" | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }[] | undefined;
+        triggers?: {
+            kind: "schedule" | "webhook" | "api";
+            label?: string | null | undefined;
+            enabled?: boolean | undefined;
+            cronExpression?: string | null | undefined;
+            timezone?: string | null | undefined;
+            signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+            replayWindowSec?: number | null | undefined;
+        }[] | undefined;
+        assigneeRef?: {
+            resourceKind: "agent";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        projectRef?: {
+            resourceKind: "project";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        issueTemplate?: {
+            billingCode?: string | null | undefined;
+            surfaceVisibility?: "default" | "plugin_operation" | undefined;
+            originId?: string | null | undefined;
+        } | undefined;
+    }[] | undefined;
+    localFolders?: {
+        displayName: string;
+        folderKey: string;
+        description?: string | undefined;
+        access?: "read" | "readWrite" | undefined;
+        requiredDirectories?: string[] | undefined;
+        requiredFiles?: string[] | undefined;
+    }[] | undefined;
+    launchers?: {
+        id: string;
+        action: {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        };
+        displayName: string;
+        placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+        description?: string | undefined;
+        exportName?: string | undefined;
+        entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+        order?: number | undefined;
+        render?: {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        } | undefined;
+    }[] | undefined;
+}>, {
+    description: string;
+    id: string;
+    version: string;
+    capabilities: ("companies.read" | "projects.read" | "project.workspaces.read" | "issues.read" | "issue.relations.read" | "issue.subtree.read" | "issue.comments.read" | "issue.documents.read" | "agents.read" | "goals.read" | "goals.create" | "goals.update" | "activity.read" | "costs.read" | "issues.orchestration.read" | "database.namespace.read" | "issues.create" | "issues.update" | "issue.relations.write" | "issues.checkout" | "issues.wakeup" | "issue.comments.create" | "issue.interactions.create" | "issue.documents.write" | "projects.managed" | "routines.managed" | "agents.pause" | "agents.resume" | "agents.invoke" | "agents.managed" | "agent.sessions.create" | "agent.sessions.list" | "agent.sessions.send" | "agent.sessions.close" | "activity.log.write" | "metrics.write" | "telemetry.track" | "database.namespace.migrate" | "database.namespace.write" | "plugin.state.read" | "plugin.state.write" | "events.subscribe" | "events.emit" | "jobs.schedule" | "webhooks.receive" | "api.routes.register" | "http.outbound" | "secrets.read-ref" | "environment.drivers.register" | "local.folders" | "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;
+    author: string;
+    categories: ("automation" | "connector" | "workspace" | "ui")[];
+    entrypoints: {
+        worker: string;
+        ui?: string | undefined;
+    };
+    database?: {
+        migrationsDir: string;
+        namespaceSlug?: string | undefined;
+        coreReadTables?: ("companies" | "projects" | "goals" | "agents" | "issues" | "issue_documents" | "issue_relations" | "issue_comments" | "heartbeat_runs" | "cost_events" | "approvals" | "issue_approvals" | "budget_incidents")[] | undefined;
+    } | undefined;
+    ui?: {
+        launchers?: {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }[] | undefined;
+        slots?: {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+    } | undefined;
+    projects?: {
+        displayName: string;
+        projectKey: string;
+        description?: string | null | undefined;
+        settings?: Record<string, unknown> | undefined;
+        status?: "backlog" | "in_progress" | "cancelled" | "completed" | "planned" | undefined;
+        color?: string | null | undefined;
+    }[] | undefined;
+    agents?: {
+        displayName: string;
+        agentKey: string;
+        title?: string | null | undefined;
+        status?: "paused" | "idle" | undefined;
+        budgetMonthlyCents?: number | undefined;
+        adapterType?: string | undefined;
+        adapterConfig?: Record<string, unknown> | undefined;
+        instructions?: {
+            content?: string | undefined;
+            entryFile?: string | undefined;
+            assetPath?: string | undefined;
+        } | undefined;
+        role?: string | undefined;
+        icon?: string | null | undefined;
+        capabilities?: string | null | undefined;
+        runtimeConfig?: Record<string, unknown> | undefined;
+        permissions?: Record<string, unknown> | undefined;
+        adapterPreference?: string[] | undefined;
+    }[] | undefined;
+    jobs?: {
+        jobKey: string;
+        displayName: string;
+        description?: string | undefined;
+        schedule?: string | undefined;
+    }[] | undefined;
+    minimumHostVersion?: string | undefined;
+    minimumEvermoreVersion?: string | undefined;
+    instanceConfigSchema?: Record<string, unknown> | undefined;
+    webhooks?: {
+        displayName: string;
+        endpointKey: string;
+        description?: string | undefined;
+    }[] | undefined;
+    tools?: {
+        description: string;
+        name: string;
+        displayName: string;
+        parametersSchema: Record<string, unknown>;
+    }[] | undefined;
+    apiRoutes?: {
+        path: string;
+        routeKey: string;
+        method: "GET" | "POST" | "PATCH" | "DELETE";
+        auth: "agent" | "board" | "webhook" | "board-or-agent";
+        capability: "api.routes.register";
+        checkoutPolicy?: "none" | "required-for-agent-in-progress" | "always-for-agent" | undefined;
+        companyResolution?: {
+            key: string;
+            from: "body";
+        } | {
+            key: string;
+            from: "query";
+        } | {
+            from: "issue";
+            param: string;
+        } | undefined;
+    }[] | undefined;
+    environmentDrivers?: {
+        displayName: string;
+        driverKey: string;
+        configSchema: Record<string, unknown>;
+        description?: string | undefined;
+        kind?: "environment_driver" | "sandbox_provider" | undefined;
+    }[] | undefined;
+    routines?: {
+        title: string;
+        routineKey: string;
+        description?: string | null | undefined;
+        status?: "active" | "paused" | "archived" | undefined;
+        goalId?: string | null | undefined;
+        priority?: "critical" | "high" | "medium" | "low" | undefined;
+        concurrencyPolicy?: "coalesce_if_active" | "always_enqueue" | "skip_if_active" | undefined;
+        catchUpPolicy?: "skip_missed" | "enqueue_missed_with_cap" | undefined;
+        variables?: {
+            required: boolean;
+            options: string[];
+            type: "number" | "boolean" | "text" | "textarea" | "select";
+            name: string;
+            label?: string | null | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }[] | undefined;
+        triggers?: {
+            kind: "schedule" | "webhook" | "api";
+            label?: string | null | undefined;
+            enabled?: boolean | undefined;
+            cronExpression?: string | null | undefined;
+            timezone?: string | null | undefined;
+            signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+            replayWindowSec?: number | null | undefined;
+        }[] | undefined;
+        assigneeRef?: {
+            resourceKind: "agent";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        projectRef?: {
+            resourceKind: "project";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        issueTemplate?: {
+            billingCode?: string | null | undefined;
+            surfaceVisibility?: "default" | "plugin_operation" | undefined;
+            originId?: string | null | undefined;
+        } | undefined;
+    }[] | undefined;
+    localFolders?: {
+        displayName: string;
+        folderKey: string;
+        description?: string | undefined;
+        access?: "read" | "readWrite" | undefined;
+        requiredDirectories?: string[] | undefined;
+        requiredFiles?: string[] | undefined;
+    }[] | undefined;
+    launchers?: {
+        id: string;
+        action: {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        };
+        displayName: string;
+        placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+        description?: string | undefined;
+        exportName?: string | undefined;
+        entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+        order?: number | undefined;
+        render?: {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        } | undefined;
+    }[] | undefined;
+}, {
+    description: string;
+    id: string;
+    version: string;
+    capabilities: ("companies.read" | "projects.read" | "project.workspaces.read" | "issues.read" | "issue.relations.read" | "issue.subtree.read" | "issue.comments.read" | "issue.documents.read" | "agents.read" | "goals.read" | "goals.create" | "goals.update" | "activity.read" | "costs.read" | "issues.orchestration.read" | "database.namespace.read" | "issues.create" | "issues.update" | "issue.relations.write" | "issues.checkout" | "issues.wakeup" | "issue.comments.create" | "issue.interactions.create" | "issue.documents.write" | "projects.managed" | "routines.managed" | "agents.pause" | "agents.resume" | "agents.invoke" | "agents.managed" | "agent.sessions.create" | "agent.sessions.list" | "agent.sessions.send" | "agent.sessions.close" | "activity.log.write" | "metrics.write" | "telemetry.track" | "database.namespace.migrate" | "database.namespace.write" | "plugin.state.read" | "plugin.state.write" | "events.subscribe" | "events.emit" | "jobs.schedule" | "webhooks.receive" | "api.routes.register" | "http.outbound" | "secrets.read-ref" | "environment.drivers.register" | "local.folders" | "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;
+    author: string;
+    categories: ("automation" | "connector" | "workspace" | "ui")[];
+    entrypoints: {
+        worker: string;
+        ui?: string | undefined;
+    };
+    database?: {
+        migrationsDir: string;
+        namespaceSlug?: string | undefined;
+        coreReadTables?: ("companies" | "projects" | "goals" | "agents" | "issues" | "issue_documents" | "issue_relations" | "issue_comments" | "heartbeat_runs" | "cost_events" | "approvals" | "issue_approvals" | "budget_incidents")[] | undefined;
+    } | undefined;
+    ui?: {
+        launchers?: {
+            id: string;
+            action: {
+                target: string;
+                type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+                params?: Record<string, unknown> | undefined;
+            };
+            displayName: string;
+            placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            description?: string | undefined;
+            exportName?: string | undefined;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            order?: number | undefined;
+            render?: {
+                environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+                bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+            } | undefined;
+        }[] | undefined;
+        slots?: {
+            id: string;
+            type: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "routeSidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+            displayName: string;
+            exportName: string;
+            entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+            routePath?: string | undefined;
+            order?: number | undefined;
+        }[] | undefined;
+    } | undefined;
+    projects?: {
+        displayName: string;
+        projectKey: string;
+        description?: string | null | undefined;
+        settings?: Record<string, unknown> | undefined;
+        status?: "backlog" | "in_progress" | "cancelled" | "completed" | "planned" | undefined;
+        color?: string | null | undefined;
+    }[] | undefined;
+    agents?: {
+        displayName: string;
+        agentKey: string;
+        title?: string | null | undefined;
+        status?: "paused" | "idle" | undefined;
+        budgetMonthlyCents?: number | undefined;
+        adapterType?: string | undefined;
+        adapterConfig?: Record<string, unknown> | undefined;
+        instructions?: {
+            content?: string | undefined;
+            entryFile?: string | undefined;
+            assetPath?: string | undefined;
+        } | undefined;
+        role?: string | undefined;
+        icon?: string | null | undefined;
+        capabilities?: string | null | undefined;
+        runtimeConfig?: Record<string, unknown> | undefined;
+        permissions?: Record<string, unknown> | undefined;
+        adapterPreference?: string[] | undefined;
+    }[] | undefined;
+    jobs?: {
+        jobKey: string;
+        displayName: string;
+        description?: string | undefined;
+        schedule?: string | undefined;
+    }[] | undefined;
+    minimumHostVersion?: string | undefined;
+    minimumEvermoreVersion?: string | undefined;
+    instanceConfigSchema?: Record<string, unknown> | undefined;
+    webhooks?: {
+        displayName: string;
+        endpointKey: string;
+        description?: string | undefined;
+    }[] | undefined;
+    tools?: {
+        description: string;
+        name: string;
+        displayName: string;
+        parametersSchema: Record<string, unknown>;
+    }[] | undefined;
+    apiRoutes?: {
+        path: string;
+        routeKey: string;
+        method: "GET" | "POST" | "PATCH" | "DELETE";
+        auth: "agent" | "board" | "webhook" | "board-or-agent";
+        capability: "api.routes.register";
+        checkoutPolicy?: "none" | "required-for-agent-in-progress" | "always-for-agent" | undefined;
+        companyResolution?: {
+            key: string;
+            from: "body";
+        } | {
+            key: string;
+            from: "query";
+        } | {
+            from: "issue";
+            param: string;
+        } | undefined;
+    }[] | undefined;
+    environmentDrivers?: {
+        displayName: string;
+        driverKey: string;
+        configSchema: Record<string, unknown>;
+        description?: string | undefined;
+        kind?: "environment_driver" | "sandbox_provider" | undefined;
+    }[] | undefined;
+    routines?: {
+        title: string;
+        routineKey: string;
+        description?: string | null | undefined;
+        status?: "active" | "paused" | "archived" | undefined;
+        goalId?: string | null | undefined;
+        priority?: "critical" | "high" | "medium" | "low" | undefined;
+        concurrencyPolicy?: "coalesce_if_active" | "always_enqueue" | "skip_if_active" | undefined;
+        catchUpPolicy?: "skip_missed" | "enqueue_missed_with_cap" | undefined;
+        variables?: {
+            name: string;
+            required?: boolean | undefined;
+            label?: string | null | undefined;
+            options?: string[] | undefined;
+            type?: "number" | "boolean" | "text" | "textarea" | "select" | undefined;
+            defaultValue?: string | number | boolean | null | undefined;
+        }[] | undefined;
+        triggers?: {
+            kind: "schedule" | "webhook" | "api";
+            label?: string | null | undefined;
+            enabled?: boolean | undefined;
+            cronExpression?: string | null | undefined;
+            timezone?: string | null | undefined;
+            signingMode?: "none" | "bearer" | "hmac_sha256" | "github_hmac" | null | undefined;
+            replayWindowSec?: number | null | undefined;
+        }[] | undefined;
+        assigneeRef?: {
+            resourceKind: "agent";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        projectRef?: {
+            resourceKind: "project";
+            resourceKey: string;
+            pluginKey?: string | undefined;
+        } | null | undefined;
+        issueTemplate?: {
+            billingCode?: string | null | undefined;
+            surfaceVisibility?: "default" | "plugin_operation" | undefined;
+            originId?: string | null | undefined;
+        } | undefined;
+    }[] | undefined;
+    localFolders?: {
+        displayName: string;
+        folderKey: string;
+        description?: string | undefined;
+        access?: "read" | "readWrite" | undefined;
+        requiredDirectories?: string[] | undefined;
+        requiredFiles?: string[] | undefined;
+    }[] | undefined;
+    launchers?: {
+        id: string;
+        action: {
+            target: string;
+            type: "navigate" | "openModal" | "openDrawer" | "openPopover" | "performAction" | "deepLink";
+            params?: Record<string, unknown> | undefined;
+        };
+        displayName: string;
+        placementZone: "page" | "detailTab" | "taskDetailView" | "dashboardWidget" | "sidebar" | "sidebarPanel" | "projectSidebarItem" | "globalToolbarButton" | "toolbarButton" | "contextMenuItem" | "commentAnnotation" | "commentContextMenuItem" | "settingsPage";
+        description?: string | undefined;
+        exportName?: string | undefined;
+        entityTypes?: ("agent" | "comment" | "project" | "issue" | "goal" | "run")[] | undefined;
+        order?: number | undefined;
+        render?: {
+            environment: "hostInline" | "hostOverlay" | "hostRoute" | "external" | "iframe";
+            bounds?: "default" | "inline" | "compact" | "wide" | "full" | undefined;
+        } | undefined;
+    }[] | undefined;
+}>;
+export type PluginManifestV1Input = z.infer<typeof pluginManifestV1Schema>;
+/**
+ * Schema for installing (registering) a plugin.
+ * The server receives the packageName and resolves the manifest from the
+ * installed package.
+ */
+export declare const installPluginSchema: z.ZodObject<{
+    packageName: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    /** Set by loader for local-path installs so the worker can be resolved. */
+    packagePath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    packageName: string;
+    version?: string | undefined;
+    packagePath?: string | undefined;
+}, {
+    packageName: string;
+    version?: string | undefined;
+    packagePath?: string | undefined;
+}>;
+export type InstallPlugin = z.infer<typeof installPluginSchema>;
+/**
+ * Schema for creating or updating a plugin's instance configuration.
+ * configJson is validated permissively here; runtime validation against
+ * the plugin's instanceConfigSchema is done at the service layer.
+ */
+export declare const upsertPluginConfigSchema: z.ZodObject<{
+    configJson: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    configJson: Record<string, unknown>;
+}, {
+    configJson: Record<string, unknown>;
+}>;
+export type UpsertPluginConfig = z.infer<typeof upsertPluginConfigSchema>;
+/**
+ * Schema for partially updating a plugin's instance configuration.
+ * Allows a partial merge of config values.
+ */
+export declare const patchPluginConfigSchema: z.ZodObject<{
+    configJson: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    configJson: Record<string, unknown>;
+}, {
+    configJson: Record<string, unknown>;
+}>;
+export type PatchPluginConfig = z.infer<typeof patchPluginConfigSchema>;
+/**
+ * Schema for updating a plugin's lifecycle status. Used by the lifecycle
+ * manager to persist state transitions.
+ *
+ * @see {@link PLUGIN_STATUSES} for the valid status values
+ */
+export declare const updatePluginStatusSchema: z.ZodObject<{
+    status: z.ZodEnum<["installed", "ready", "disabled", "error", "upgrade_pending", "uninstalled"]>;
+    lastError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "error" | "installed" | "ready" | "disabled" | "upgrade_pending" | "uninstalled";
+    lastError?: string | null | undefined;
+}, {
+    status: "error" | "installed" | "ready" | "disabled" | "upgrade_pending" | "uninstalled";
+    lastError?: string | null | undefined;
+}>;
+export type UpdatePluginStatus = z.infer<typeof updatePluginStatusSchema>;
+/** Schema for the uninstall request. `removeData` controls hard vs soft delete. */
+export declare const uninstallPluginSchema: z.ZodObject<{
+    removeData: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    removeData: boolean;
+}, {
+    removeData?: boolean | undefined;
+}>;
+export type UninstallPlugin = z.infer<typeof uninstallPluginSchema>;
+/**
+ * Schema for a plugin state scope key — identifies the exact location where
+ * 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`
+ */
+export declare const pluginStateScopeKeySchema: z.ZodObject<{
+    scopeKind: z.ZodEnum<["instance", "company", "project", "project_workspace", "agent", "issue", "goal", "run"]>;
+    scopeId: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    stateKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    scopeKind: "agent" | "company" | "project" | "issue" | "goal" | "run" | "instance" | "project_workspace";
+    stateKey: string;
+    scopeId?: string | undefined;
+    namespace?: string | undefined;
+}, {
+    scopeKind: "agent" | "company" | "project" | "issue" | "goal" | "run" | "instance" | "project_workspace";
+    stateKey: string;
+    scopeId?: string | undefined;
+    namespace?: string | undefined;
+}>;
+export type PluginStateScopeKey = z.infer<typeof pluginStateScopeKeySchema>;
+/**
+ * Schema for setting a plugin state value.
+ */
+export declare const setPluginStateSchema: z.ZodObject<{
+    scopeKind: z.ZodEnum<["instance", "company", "project", "project_workspace", "agent", "issue", "goal", "run"]>;
+    scopeId: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    stateKey: z.ZodString;
+    /** JSON-serializable value to store. */
+    value: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    scopeKind: "agent" | "company" | "project" | "issue" | "goal" | "run" | "instance" | "project_workspace";
+    stateKey: string;
+    value?: unknown;
+    scopeId?: string | undefined;
+    namespace?: string | undefined;
+}, {
+    scopeKind: "agent" | "company" | "project" | "issue" | "goal" | "run" | "instance" | "project_workspace";
+    stateKey: string;
+    value?: unknown;
+    scopeId?: string | undefined;
+    namespace?: string | undefined;
+}>;
+export type SetPluginState = z.infer<typeof setPluginStateSchema>;
+/**
+ * Schema for querying plugin state entries. All fields are optional to allow
+ * flexible list queries (e.g. all state for a plugin within a scope).
+ */
+export declare const listPluginStateSchema: z.ZodObject<{
+    scopeKind: z.ZodOptional<z.ZodEnum<["instance", "company", "project", "project_workspace", "agent", "issue", "goal", "run"]>>;
+    scopeId: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scopeId?: string | undefined;
+    namespace?: string | undefined;
+    scopeKind?: "agent" | "company" | "project" | "issue" | "goal" | "run" | "instance" | "project_workspace" | undefined;
+}, {
+    scopeId?: string | undefined;
+    namespace?: string | undefined;
+    scopeKind?: "agent" | "company" | "project" | "issue" | "goal" | "run" | "instance" | "project_workspace" | undefined;
+}>;
+export type ListPluginState = z.infer<typeof listPluginStateSchema>;
+//# sourceMappingURL=plugin.d.ts.map