@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/validators/plugin.d.ts

@@ -0,0 +1,1257 @@
+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.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const pluginJobDeclarationSchema: z.ZodObject<{
+    jobKey: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    schedule: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+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>;
+}, z.core.$strip>;
+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.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const pluginEnvironmentTemplateConfigBindingSchema: z.ZodObject<{
+    field: z.ZodString;
+    unsetFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const sandboxProviderCapabilitiesSchema: z.ZodObject<{
+    reusableLeases: z.ZodOptional<z.ZodBoolean>;
+    nativeSyncIn: z.ZodOptional<z.ZodBoolean>;
+    nativeSyncOut: z.ZodOptional<z.ZodBoolean>;
+    persistentProcessSessions: z.ZodOptional<z.ZodBoolean>;
+    independentControlCommands: z.ZodOptional<z.ZodBoolean>;
+    incrementalSessionOutput: z.ZodOptional<z.ZodBoolean>;
+    concurrentSyncOperations: z.ZodOptional<z.ZodBoolean>;
+    duplexCommandStream: z.ZodOptional<z.ZodBoolean>;
+    runnerWebSocketIngress: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type SandboxProviderCapabilitiesInput = z.infer<typeof sandboxProviderCapabilitiesSchema>;
+export declare const pluginEnvironmentDriverDeclarationSchema: z.ZodPipe<z.ZodObject<{
+    driverKey: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<{
+        environment_driver: "environment_driver";
+        sandbox_provider: "sandbox_provider";
+    }>>;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    supportsReusableLeases: z.ZodOptional<z.ZodBoolean>;
+    sandboxCapabilities: z.ZodOptional<z.ZodObject<{
+        reusableLeases: z.ZodOptional<z.ZodBoolean>;
+        nativeSyncIn: z.ZodOptional<z.ZodBoolean>;
+        nativeSyncOut: z.ZodOptional<z.ZodBoolean>;
+        persistentProcessSessions: z.ZodOptional<z.ZodBoolean>;
+        independentControlCommands: z.ZodOptional<z.ZodBoolean>;
+        incrementalSessionOutput: z.ZodOptional<z.ZodBoolean>;
+        concurrentSyncOperations: z.ZodOptional<z.ZodBoolean>;
+        duplexCommandStream: z.ZodOptional<z.ZodBoolean>;
+        runnerWebSocketIngress: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    supportsInteractiveSetup: z.ZodOptional<z.ZodBoolean>;
+    interactiveSetupConnectionTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supportsTemplateCapture: z.ZodOptional<z.ZodBoolean>;
+    templateRefKind: z.ZodOptional<z.ZodString>;
+    templateConfigBinding: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        unsetFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    templateIdentityPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supportsTemplateDelete: z.ZodOptional<z.ZodBoolean>;
+    supportsLoginPty: z.ZodOptional<z.ZodBoolean>;
+    supportsSetupTokenLogin: z.ZodOptional<z.ZodBoolean>;
+    configSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>, z.ZodTransform<{
+    driverKey: string;
+    kind?: "environment_driver" | "sandbox_provider" | undefined;
+    displayName: string;
+    description?: string | undefined;
+    supportsReusableLeases?: boolean | undefined;
+    sandboxCapabilities?: {
+        reusableLeases?: boolean | undefined;
+        nativeSyncIn?: boolean | undefined;
+        nativeSyncOut?: boolean | undefined;
+        persistentProcessSessions?: boolean | undefined;
+        independentControlCommands?: boolean | undefined;
+        incrementalSessionOutput?: boolean | undefined;
+        concurrentSyncOperations?: boolean | undefined;
+        duplexCommandStream?: boolean | undefined;
+        runnerWebSocketIngress?: boolean | undefined;
+    } | undefined;
+    supportsInteractiveSetup?: boolean | undefined;
+    interactiveSetupConnectionTypes?: string[] | undefined;
+    supportsTemplateCapture?: boolean | undefined;
+    templateRefKind?: string | undefined;
+    templateConfigBinding?: {
+        field: string;
+        unsetFields?: string[] | undefined;
+    } | undefined;
+    templateIdentityPaths?: string[] | undefined;
+    supportsTemplateDelete?: boolean | undefined;
+    configSchema: Record<string, unknown>;
+    supportsLoginPty: boolean | undefined;
+}, {
+    driverKey: string;
+    kind?: "environment_driver" | "sandbox_provider" | undefined;
+    displayName: string;
+    description?: string | undefined;
+    supportsReusableLeases?: boolean | undefined;
+    sandboxCapabilities?: {
+        reusableLeases?: boolean | undefined;
+        nativeSyncIn?: boolean | undefined;
+        nativeSyncOut?: boolean | undefined;
+        persistentProcessSessions?: boolean | undefined;
+        independentControlCommands?: boolean | undefined;
+        incrementalSessionOutput?: boolean | undefined;
+        concurrentSyncOperations?: boolean | undefined;
+        duplexCommandStream?: boolean | undefined;
+        runnerWebSocketIngress?: boolean | undefined;
+    } | undefined;
+    supportsInteractiveSetup?: boolean | undefined;
+    interactiveSetupConnectionTypes?: string[] | undefined;
+    supportsTemplateCapture?: boolean | undefined;
+    templateRefKind?: string | undefined;
+    templateConfigBinding?: {
+        field: string;
+        unsetFields?: string[] | undefined;
+    } | undefined;
+    templateIdentityPaths?: string[] | undefined;
+    supportsTemplateDelete?: boolean | undefined;
+    supportsLoginPty?: boolean | undefined;
+    supportsSetupTokenLogin?: boolean | undefined;
+    configSchema: Record<string, unknown>;
+}>>;
+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>>;
+    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: "idle";
+        paused: "paused";
+    }>>;
+    budgetMonthlyCents: z.ZodOptional<z.ZodNumber>;
+    instructions: z.ZodOptional<z.ZodObject<{
+        entryFile: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        assetPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+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: "backlog";
+        cancelled: "cancelled";
+        completed: "completed";
+        in_progress: "in_progress";
+        planned: "planned";
+    }>>;
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+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">;
+    }, z.core.$strip>>>;
+    projectRef: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        pluginKey: z.ZodOptional<z.ZodString>;
+        resourceKey: z.ZodString;
+        resourceKind: z.ZodLiteral<"project">;
+    }, z.core.$strip>>>;
+    goalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+        paused: "paused";
+    }>>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        critical: "critical";
+        high: "high";
+        low: "low";
+        medium: "medium";
+    }>>;
+    concurrencyPolicy: z.ZodOptional<z.ZodEnum<{
+        always_enqueue: "always_enqueue";
+        coalesce_if_active: "coalesce_if_active";
+        skip_if_active: "skip_if_active";
+    }>>;
+    catchUpPolicy: z.ZodOptional<z.ZodEnum<{
+        enqueue_missed_with_cap: "enqueue_missed_with_cap";
+        skip_missed: "skip_missed";
+    }>>;
+    activityGatePolicy: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        require_external_activity: "require_external_activity";
+    }>>;
+    activityGateScope: z.ZodOptional<z.ZodEnum<{
+        company: "company";
+        project: "project";
+    }>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            boolean: "boolean";
+            date: "date";
+            number: "number";
+            select: "select";
+            text: "text";
+            textarea: "textarea";
+        }>>>;
+        defaultValue: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        options: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>>;
+    triggers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            api: "api";
+            schedule: "schedule";
+            webhook: "webhook";
+        }>;
+        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<{
+            app_webhook: "app_webhook";
+            bearer: "bearer";
+            fireflies_hmac: "fireflies_hmac";
+            github_hmac: "github_hmac";
+            hmac_sha256: "hmac_sha256";
+            none: "none";
+        }>>>;
+        replayWindowSec: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    issueTemplate: z.ZodOptional<z.ZodObject<{
+        surfaceVisibility: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            plugin_operation: "plugin_operation";
+        }>>;
+        originId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        billingCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+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: "read";
+        readWrite: "readWrite";
+    }>>;
+    requiredDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PluginLocalFolderDeclarationInput = z.infer<typeof pluginLocalFolderDeclarationSchema>;
+export declare const pluginManagedSkillFileDeclarationSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type PluginManagedSkillFileDeclarationInput = z.infer<typeof pluginManagedSkillFileDeclarationSchema>;
+export declare const pluginManagedSkillDeclarationSchema: z.ZodObject<{
+    skillKey: z.ZodString;
+    displayName: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    markdown: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type PluginManagedSkillDeclarationInput = z.infer<typeof pluginManagedSkillDeclarationSchema>;
+/**
+ * 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.ZodObject<{
+    type: z.ZodEnum<{
+        appShellOverlay: "appShellOverlay";
+        commentAnnotation: "commentAnnotation";
+        commentContextMenuItem: "commentContextMenuItem";
+        companySettingsPage: "companySettingsPage";
+        contextMenuItem: "contextMenuItem";
+        dashboardWidget: "dashboardWidget";
+        detailTab: "detailTab";
+        globalToolbarButton: "globalToolbarButton";
+        organizationSwitcher: "organizationSwitcher";
+        page: "page";
+        projectSidebarItem: "projectSidebarItem";
+        routeSidebar: "routeSidebar";
+        settingsPage: "settingsPage";
+        sidebar: "sidebar";
+        sidebarPanel: "sidebarPanel";
+        taskDetailView: "taskDetailView";
+        toolbarButton: "toolbarButton";
+    }>;
+    id: z.ZodString;
+    displayName: z.ZodString;
+    exportName: z.ZodString;
+    entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        agent: "agent";
+        comment: "comment";
+        execution_workspace: "execution_workspace";
+        goal: "goal";
+        issue: "issue";
+        project: "project";
+        project_workspace: "project_workspace";
+        run: "run";
+    }>>>;
+    routePath: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginUiSlotDeclarationInput = z.infer<typeof pluginUiSlotDeclarationSchema>;
+/**
+ * Validates the action payload for a declarative plugin launcher.
+ */
+export declare const pluginLauncherActionDeclarationSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        deepLink: "deepLink";
+        navigate: "navigate";
+        openDrawer: "openDrawer";
+        openModal: "openModal";
+        openPopover: "openPopover";
+        performAction: "performAction";
+    }>;
+    target: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type PluginLauncherActionDeclarationInput = z.infer<typeof pluginLauncherActionDeclarationSchema>;
+/**
+ * Validates optional render hints for a plugin launcher destination.
+ */
+export declare const pluginLauncherRenderDeclarationSchema: z.ZodObject<{
+    environment: z.ZodEnum<{
+        external: "external";
+        hostInline: "hostInline";
+        hostOverlay: "hostOverlay";
+        hostRoute: "hostRoute";
+        iframe: "iframe";
+    }>;
+    bounds: z.ZodOptional<z.ZodEnum<{
+        compact: "compact";
+        default: "default";
+        full: "full";
+        inline: "inline";
+        wide: "wide";
+    }>>;
+}, z.core.$strip>;
+export type PluginLauncherRenderDeclarationInput = z.infer<typeof pluginLauncherRenderDeclarationSchema>;
+/**
+ * Validates declarative launcher metadata in a plugin manifest.
+ */
+export declare const pluginLauncherDeclarationSchema: z.ZodObject<{
+    id: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    placementZone: z.ZodEnum<{
+        commentAnnotation: "commentAnnotation";
+        commentContextMenuItem: "commentContextMenuItem";
+        contextMenuItem: "contextMenuItem";
+        dashboardWidget: "dashboardWidget";
+        detailTab: "detailTab";
+        globalToolbarButton: "globalToolbarButton";
+        page: "page";
+        projectSidebarItem: "projectSidebarItem";
+        settingsPage: "settingsPage";
+        sidebar: "sidebar";
+        sidebarPanel: "sidebarPanel";
+        taskDetailView: "taskDetailView";
+        toolbarButton: "toolbarButton";
+    }>;
+    exportName: z.ZodOptional<z.ZodString>;
+    entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        agent: "agent";
+        comment: "comment";
+        execution_workspace: "execution_workspace";
+        goal: "goal";
+        issue: "issue";
+        project: "project";
+        project_workspace: "project_workspace";
+        run: "run";
+    }>>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    action: z.ZodObject<{
+        type: z.ZodEnum<{
+            deepLink: "deepLink";
+            navigate: "navigate";
+            openDrawer: "openDrawer";
+            openModal: "openModal";
+            openPopover: "openPopover";
+            performAction: "performAction";
+        }>;
+        target: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    render: z.ZodOptional<z.ZodObject<{
+        environment: z.ZodEnum<{
+            external: "external";
+            hostInline: "hostInline";
+            hostOverlay: "hostOverlay";
+            hostRoute: "hostRoute";
+            iframe: "iframe";
+        }>;
+        bounds: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            default: "default";
+            full: "full";
+            inline: "inline";
+            wide: "wide";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginLauncherDeclarationInput = z.infer<typeof pluginLauncherDeclarationSchema>;
+export declare const pluginDatabaseDeclarationSchema: z.ZodObject<{
+    namespaceSlug: z.ZodOptional<z.ZodString>;
+    migrationsDir: z.ZodString;
+    coreReadTables: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        agents: "agents";
+        approvals: "approvals";
+        budget_incidents: "budget_incidents";
+        companies: "companies";
+        cost_events: "cost_events";
+        goals: "goals";
+        heartbeat_runs: "heartbeat_runs";
+        issue_approvals: "issue_approvals";
+        issue_comments: "issue_comments";
+        issue_documents: "issue_documents";
+        issue_relations: "issue_relations";
+        issues: "issues";
+        projects: "projects";
+    }>>>;
+}, z.core.$strip>;
+export type PluginDatabaseDeclarationInput = z.infer<typeof pluginDatabaseDeclarationSchema>;
+export declare const pluginApiRouteDeclarationSchema: z.ZodObject<{
+    routeKey: z.ZodString;
+    method: z.ZodEnum<{
+        DELETE: "DELETE";
+        GET: "GET";
+        PATCH: "PATCH";
+        POST: "POST";
+    }>;
+    path: z.ZodString;
+    auth: z.ZodEnum<{
+        agent: "agent";
+        board: "board";
+        "board-or-agent": "board-or-agent";
+        webhook: "webhook";
+    }>;
+    capability: z.ZodLiteral<"api.routes.register">;
+    checkoutPolicy: z.ZodOptional<z.ZodEnum<{
+        "always-for-agent": "always-for-agent";
+        none: "none";
+        "required-for-agent-in-progress": "required-for-agent-in-progress";
+    }>>;
+    companyResolution: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        from: z.ZodLiteral<"body">;
+        key: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        from: z.ZodLiteral<"query">;
+        key: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        from: z.ZodLiteral<"issue">;
+        param: z.ZodString;
+    }, z.core.$strip>], "from">>;
+}, z.core.$strip>;
+export type PluginApiRouteDeclarationInput = z.infer<typeof pluginApiRouteDeclarationSchema>;
+export declare const pluginObjectReferenceRefreshPolicySchema: z.ZodObject<{
+    defaultTtlSeconds: z.ZodOptional<z.ZodNumber>;
+    staleAfterSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const pluginObjectReferenceProviderDeclarationSchema: z.ZodObject<{
+    providerKey: z.ZodString;
+    displayName: z.ZodString;
+    objectTypes: z.ZodArray<z.ZodString>;
+    urlPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    refreshPolicy: z.ZodOptional<z.ZodObject<{
+        defaultTtlSeconds: z.ZodOptional<z.ZodNumber>;
+        staleAfterSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    webhookEndpointKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PluginObjectReferenceProviderDeclarationInput = z.infer<typeof pluginObjectReferenceProviderDeclarationSchema>;
+/**
+ * Zod schema for {@link PaperclipPluginManifestV1} — the complete runtime
+ * validator for plugin manifests read at install time.
+ *
+ * Field-level constraints (see PLUGIN_SPEC.md §10.1 for the normative rules):
+ *
+ * | Field                    | 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`|
+ * | `minimumPaperclipVersion`| 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 PaperclipPluginManifestV1} — the inferred TypeScript type
+ */
+export declare const pluginManifestV1Schema: 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<{
+        automation: "automation";
+        connector: "connector";
+        ui: "ui";
+        workspace: "workspace";
+    }>>;
+    minimumHostVersion: z.ZodOptional<z.ZodString>;
+    minimumPaperclipVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodArray<z.ZodEnum<{
+        "access.invites.read": "access.invites.read";
+        "access.invites.write": "access.invites.write";
+        "access.members.read": "access.members.read";
+        "access.members.write": "access.members.write";
+        "activity.log.write": "activity.log.write";
+        "activity.read": "activity.read";
+        "agent.sessions.close": "agent.sessions.close";
+        "agent.sessions.create": "agent.sessions.create";
+        "agent.sessions.list": "agent.sessions.list";
+        "agent.sessions.send": "agent.sessions.send";
+        "agent.tools.register": "agent.tools.register";
+        "agents.invoke": "agents.invoke";
+        "agents.managed": "agents.managed";
+        "agents.pause": "agents.pause";
+        "agents.read": "agents.read";
+        "agents.resume": "agents.resume";
+        "api.routes.register": "api.routes.register";
+        "approvals.read": "approvals.read";
+        "approvals.respond": "approvals.respond";
+        "authorization.audit.read": "authorization.audit.read";
+        "authorization.grants.read": "authorization.grants.read";
+        "authorization.grants.write": "authorization.grants.write";
+        "authorization.policies.read": "authorization.policies.read";
+        "authorization.policies.write": "authorization.policies.write";
+        "companies.read": "companies.read";
+        "costs.read": "costs.read";
+        "database.namespace.migrate": "database.namespace.migrate";
+        "database.namespace.read": "database.namespace.read";
+        "database.namespace.write": "database.namespace.write";
+        "environment.drivers.register": "environment.drivers.register";
+        "events.emit": "events.emit";
+        "events.subscribe": "events.subscribe";
+        "execution.workspaces.read": "execution.workspaces.read";
+        "external.objects.detect": "external.objects.detect";
+        "external.objects.read": "external.objects.read";
+        "external.objects.refresh": "external.objects.refresh";
+        "external.objects.write": "external.objects.write";
+        "goals.create": "goals.create";
+        "goals.read": "goals.read";
+        "goals.update": "goals.update";
+        "http.outbound": "http.outbound";
+        "instance.settings.register": "instance.settings.register";
+        "issue.attachments.read": "issue.attachments.read";
+        "issue.comments.create": "issue.comments.create";
+        "issue.comments.create_human_attributed": "issue.comments.create_human_attributed";
+        "issue.comments.read": "issue.comments.read";
+        "issue.documents.read": "issue.documents.read";
+        "issue.documents.write": "issue.documents.write";
+        "issue.interactions.create": "issue.interactions.create";
+        "issue.interactions.read": "issue.interactions.read";
+        "issue.interactions.respond": "issue.interactions.respond";
+        "issue.relations.read": "issue.relations.read";
+        "issue.relations.write": "issue.relations.write";
+        "issue.subtree.read": "issue.subtree.read";
+        "issues.checkout": "issues.checkout";
+        "issues.create": "issues.create";
+        "issues.orchestration.read": "issues.orchestration.read";
+        "issues.read": "issues.read";
+        "issues.update": "issues.update";
+        "issues.wakeup": "issues.wakeup";
+        "jobs.schedule": "jobs.schedule";
+        "local.folders": "local.folders";
+        "metrics.write": "metrics.write";
+        "plugin.state.read": "plugin.state.read";
+        "plugin.state.write": "plugin.state.write";
+        "project.workspaces.read": "project.workspaces.read";
+        "projects.managed": "projects.managed";
+        "projects.read": "projects.read";
+        "routines.managed": "routines.managed";
+        "secrets.read-ref": "secrets.read-ref";
+        "skills.managed": "skills.managed";
+        "telemetry.track": "telemetry.track";
+        "ui.action.register": "ui.action.register";
+        "ui.commentAnnotation.register": "ui.commentAnnotation.register";
+        "ui.dashboardWidget.register": "ui.dashboardWidget.register";
+        "ui.detailTab.register": "ui.detailTab.register";
+        "ui.page.register": "ui.page.register";
+        "ui.sidebar.register": "ui.sidebar.register";
+        "webhooks.receive": "webhooks.receive";
+    }>>;
+    entrypoints: z.ZodObject<{
+        worker: z.ZodString;
+        ui: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    instanceConfigSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    jobs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        jobKey: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        schedule: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    webhooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        endpointKey: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodString;
+        parametersSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    database: z.ZodOptional<z.ZodObject<{
+        namespaceSlug: z.ZodOptional<z.ZodString>;
+        migrationsDir: z.ZodString;
+        coreReadTables: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            agents: "agents";
+            approvals: "approvals";
+            budget_incidents: "budget_incidents";
+            companies: "companies";
+            cost_events: "cost_events";
+            goals: "goals";
+            heartbeat_runs: "heartbeat_runs";
+            issue_approvals: "issue_approvals";
+            issue_comments: "issue_comments";
+            issue_documents: "issue_documents";
+            issue_relations: "issue_relations";
+            issues: "issues";
+            projects: "projects";
+        }>>>;
+    }, z.core.$strip>>;
+    apiRoutes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        routeKey: z.ZodString;
+        method: z.ZodEnum<{
+            DELETE: "DELETE";
+            GET: "GET";
+            PATCH: "PATCH";
+            POST: "POST";
+        }>;
+        path: z.ZodString;
+        auth: z.ZodEnum<{
+            agent: "agent";
+            board: "board";
+            "board-or-agent": "board-or-agent";
+            webhook: "webhook";
+        }>;
+        capability: z.ZodLiteral<"api.routes.register">;
+        checkoutPolicy: z.ZodOptional<z.ZodEnum<{
+            "always-for-agent": "always-for-agent";
+            none: "none";
+            "required-for-agent-in-progress": "required-for-agent-in-progress";
+        }>>;
+        companyResolution: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            from: z.ZodLiteral<"body">;
+            key: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            from: z.ZodLiteral<"query">;
+            key: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            from: z.ZodLiteral<"issue">;
+            param: z.ZodString;
+        }, z.core.$strip>], "from">>;
+    }, z.core.$strip>>>;
+    environmentDrivers: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+        driverKey: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<{
+            environment_driver: "environment_driver";
+            sandbox_provider: "sandbox_provider";
+        }>>;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        supportsReusableLeases: z.ZodOptional<z.ZodBoolean>;
+        sandboxCapabilities: z.ZodOptional<z.ZodObject<{
+            reusableLeases: z.ZodOptional<z.ZodBoolean>;
+            nativeSyncIn: z.ZodOptional<z.ZodBoolean>;
+            nativeSyncOut: z.ZodOptional<z.ZodBoolean>;
+            persistentProcessSessions: z.ZodOptional<z.ZodBoolean>;
+            independentControlCommands: z.ZodOptional<z.ZodBoolean>;
+            incrementalSessionOutput: z.ZodOptional<z.ZodBoolean>;
+            concurrentSyncOperations: z.ZodOptional<z.ZodBoolean>;
+            duplexCommandStream: z.ZodOptional<z.ZodBoolean>;
+            runnerWebSocketIngress: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        supportsInteractiveSetup: z.ZodOptional<z.ZodBoolean>;
+        interactiveSetupConnectionTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        supportsTemplateCapture: z.ZodOptional<z.ZodBoolean>;
+        templateRefKind: z.ZodOptional<z.ZodString>;
+        templateConfigBinding: z.ZodOptional<z.ZodObject<{
+            field: z.ZodString;
+            unsetFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        templateIdentityPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        supportsTemplateDelete: z.ZodOptional<z.ZodBoolean>;
+        supportsLoginPty: z.ZodOptional<z.ZodBoolean>;
+        supportsSetupTokenLogin: z.ZodOptional<z.ZodBoolean>;
+        configSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodTransform<{
+        driverKey: string;
+        kind?: "environment_driver" | "sandbox_provider" | undefined;
+        displayName: string;
+        description?: string | undefined;
+        supportsReusableLeases?: boolean | undefined;
+        sandboxCapabilities?: {
+            reusableLeases?: boolean | undefined;
+            nativeSyncIn?: boolean | undefined;
+            nativeSyncOut?: boolean | undefined;
+            persistentProcessSessions?: boolean | undefined;
+            independentControlCommands?: boolean | undefined;
+            incrementalSessionOutput?: boolean | undefined;
+            concurrentSyncOperations?: boolean | undefined;
+            duplexCommandStream?: boolean | undefined;
+            runnerWebSocketIngress?: boolean | undefined;
+        } | undefined;
+        supportsInteractiveSetup?: boolean | undefined;
+        interactiveSetupConnectionTypes?: string[] | undefined;
+        supportsTemplateCapture?: boolean | undefined;
+        templateRefKind?: string | undefined;
+        templateConfigBinding?: {
+            field: string;
+            unsetFields?: string[] | undefined;
+        } | undefined;
+        templateIdentityPaths?: string[] | undefined;
+        supportsTemplateDelete?: boolean | undefined;
+        configSchema: Record<string, unknown>;
+        supportsLoginPty: boolean | undefined;
+    }, {
+        driverKey: string;
+        kind?: "environment_driver" | "sandbox_provider" | undefined;
+        displayName: string;
+        description?: string | undefined;
+        supportsReusableLeases?: boolean | undefined;
+        sandboxCapabilities?: {
+            reusableLeases?: boolean | undefined;
+            nativeSyncIn?: boolean | undefined;
+            nativeSyncOut?: boolean | undefined;
+            persistentProcessSessions?: boolean | undefined;
+            independentControlCommands?: boolean | undefined;
+            incrementalSessionOutput?: boolean | undefined;
+            concurrentSyncOperations?: boolean | undefined;
+            duplexCommandStream?: boolean | undefined;
+            runnerWebSocketIngress?: boolean | undefined;
+        } | undefined;
+        supportsInteractiveSetup?: boolean | undefined;
+        interactiveSetupConnectionTypes?: string[] | undefined;
+        supportsTemplateCapture?: boolean | undefined;
+        templateRefKind?: string | undefined;
+        templateConfigBinding?: {
+            field: string;
+            unsetFields?: string[] | undefined;
+        } | undefined;
+        templateIdentityPaths?: string[] | undefined;
+        supportsTemplateDelete?: boolean | undefined;
+        supportsLoginPty?: boolean | undefined;
+        supportsSetupTokenLogin?: boolean | undefined;
+        configSchema: Record<string, unknown>;
+    }>>>>;
+    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>>;
+        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: "idle";
+            paused: "paused";
+        }>>;
+        budgetMonthlyCents: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodObject<{
+            entryFile: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+            files: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            assetPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    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: "backlog";
+            cancelled: "cancelled";
+            completed: "completed";
+            in_progress: "in_progress";
+            planned: "planned";
+        }>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    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">;
+        }, z.core.$strip>>>;
+        projectRef: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            pluginKey: z.ZodOptional<z.ZodString>;
+            resourceKey: z.ZodString;
+            resourceKind: z.ZodLiteral<"project">;
+        }, z.core.$strip>>>;
+        goalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+            paused: "paused";
+        }>>;
+        priority: z.ZodOptional<z.ZodEnum<{
+            critical: "critical";
+            high: "high";
+            low: "low";
+            medium: "medium";
+        }>>;
+        concurrencyPolicy: z.ZodOptional<z.ZodEnum<{
+            always_enqueue: "always_enqueue";
+            coalesce_if_active: "coalesce_if_active";
+            skip_if_active: "skip_if_active";
+        }>>;
+        catchUpPolicy: z.ZodOptional<z.ZodEnum<{
+            enqueue_missed_with_cap: "enqueue_missed_with_cap";
+            skip_missed: "skip_missed";
+        }>>;
+        activityGatePolicy: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            require_external_activity: "require_external_activity";
+        }>>;
+        activityGateScope: z.ZodOptional<z.ZodEnum<{
+            company: "company";
+            project: "project";
+        }>>;
+        variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                boolean: "boolean";
+                date: "date";
+                number: "number";
+                select: "select";
+                text: "text";
+                textarea: "textarea";
+            }>>>;
+            defaultValue: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            options: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        }, z.core.$strip>>>;
+        triggers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                api: "api";
+                schedule: "schedule";
+                webhook: "webhook";
+            }>;
+            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<{
+                app_webhook: "app_webhook";
+                bearer: "bearer";
+                fireflies_hmac: "fireflies_hmac";
+                github_hmac: "github_hmac";
+                hmac_sha256: "hmac_sha256";
+                none: "none";
+            }>>>;
+            replayWindowSec: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        issueTemplate: z.ZodOptional<z.ZodObject<{
+            surfaceVisibility: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                plugin_operation: "plugin_operation";
+            }>>;
+            originId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            billingCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        skillKey: z.ZodString;
+        displayName: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        markdown: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    localFolders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        folderKey: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        access: z.ZodOptional<z.ZodEnum<{
+            read: "read";
+            readWrite: "readWrite";
+        }>>;
+        requiredDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requiredFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    objectReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        providerKey: z.ZodString;
+        displayName: z.ZodString;
+        objectTypes: z.ZodArray<z.ZodString>;
+        urlPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        refreshPolicy: z.ZodOptional<z.ZodObject<{
+            defaultTtlSeconds: z.ZodOptional<z.ZodNumber>;
+            staleAfterSeconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        webhookEndpointKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    launchers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        placementZone: z.ZodEnum<{
+            commentAnnotation: "commentAnnotation";
+            commentContextMenuItem: "commentContextMenuItem";
+            contextMenuItem: "contextMenuItem";
+            dashboardWidget: "dashboardWidget";
+            detailTab: "detailTab";
+            globalToolbarButton: "globalToolbarButton";
+            page: "page";
+            projectSidebarItem: "projectSidebarItem";
+            settingsPage: "settingsPage";
+            sidebar: "sidebar";
+            sidebarPanel: "sidebarPanel";
+            taskDetailView: "taskDetailView";
+            toolbarButton: "toolbarButton";
+        }>;
+        exportName: z.ZodOptional<z.ZodString>;
+        entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            agent: "agent";
+            comment: "comment";
+            execution_workspace: "execution_workspace";
+            goal: "goal";
+            issue: "issue";
+            project: "project";
+            project_workspace: "project_workspace";
+            run: "run";
+        }>>>;
+        order: z.ZodOptional<z.ZodNumber>;
+        action: z.ZodObject<{
+            type: z.ZodEnum<{
+                deepLink: "deepLink";
+                navigate: "navigate";
+                openDrawer: "openDrawer";
+                openModal: "openModal";
+                openPopover: "openPopover";
+                performAction: "performAction";
+            }>;
+            target: z.ZodString;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+        render: z.ZodOptional<z.ZodObject<{
+            environment: z.ZodEnum<{
+                external: "external";
+                hostInline: "hostInline";
+                hostOverlay: "hostOverlay";
+                hostRoute: "hostRoute";
+                iframe: "iframe";
+            }>;
+            bounds: z.ZodOptional<z.ZodEnum<{
+                compact: "compact";
+                default: "default";
+                full: "full";
+                inline: "inline";
+                wide: "wide";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    ui: z.ZodOptional<z.ZodObject<{
+        slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                appShellOverlay: "appShellOverlay";
+                commentAnnotation: "commentAnnotation";
+                commentContextMenuItem: "commentContextMenuItem";
+                companySettingsPage: "companySettingsPage";
+                contextMenuItem: "contextMenuItem";
+                dashboardWidget: "dashboardWidget";
+                detailTab: "detailTab";
+                globalToolbarButton: "globalToolbarButton";
+                organizationSwitcher: "organizationSwitcher";
+                page: "page";
+                projectSidebarItem: "projectSidebarItem";
+                routeSidebar: "routeSidebar";
+                settingsPage: "settingsPage";
+                sidebar: "sidebar";
+                sidebarPanel: "sidebarPanel";
+                taskDetailView: "taskDetailView";
+                toolbarButton: "toolbarButton";
+            }>;
+            id: z.ZodString;
+            displayName: z.ZodString;
+            exportName: z.ZodString;
+            entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                agent: "agent";
+                comment: "comment";
+                execution_workspace: "execution_workspace";
+                goal: "goal";
+                issue: "issue";
+                project: "project";
+                project_workspace: "project_workspace";
+                run: "run";
+            }>>>;
+            routePath: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        launchers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            displayName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            placementZone: z.ZodEnum<{
+                commentAnnotation: "commentAnnotation";
+                commentContextMenuItem: "commentContextMenuItem";
+                contextMenuItem: "contextMenuItem";
+                dashboardWidget: "dashboardWidget";
+                detailTab: "detailTab";
+                globalToolbarButton: "globalToolbarButton";
+                page: "page";
+                projectSidebarItem: "projectSidebarItem";
+                settingsPage: "settingsPage";
+                sidebar: "sidebar";
+                sidebarPanel: "sidebarPanel";
+                taskDetailView: "taskDetailView";
+                toolbarButton: "toolbarButton";
+            }>;
+            exportName: z.ZodOptional<z.ZodString>;
+            entityTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                agent: "agent";
+                comment: "comment";
+                execution_workspace: "execution_workspace";
+                goal: "goal";
+                issue: "issue";
+                project: "project";
+                project_workspace: "project_workspace";
+                run: "run";
+            }>>>;
+            order: z.ZodOptional<z.ZodNumber>;
+            action: z.ZodObject<{
+                type: z.ZodEnum<{
+                    deepLink: "deepLink";
+                    navigate: "navigate";
+                    openDrawer: "openDrawer";
+                    openModal: "openModal";
+                    openPopover: "openPopover";
+                    performAction: "performAction";
+                }>;
+                target: z.ZodString;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>;
+            render: z.ZodOptional<z.ZodObject<{
+                environment: z.ZodEnum<{
+                    external: "external";
+                    hostInline: "hostInline";
+                    hostOverlay: "hostOverlay";
+                    hostRoute: "hostRoute";
+                    iframe: "iframe";
+                }>;
+                bounds: z.ZodOptional<z.ZodEnum<{
+                    compact: "compact";
+                    default: "default";
+                    full: "full";
+                    inline: "inline";
+                    wide: "wide";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+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>;
+    packagePath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InstallPlugin = z.infer<typeof installPluginSchema>;
+/**
+ * Schema for creating or updating a plugin's company-scoped 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<{
+    companyId: z.ZodString;
+    configJson: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export type UpsertPluginConfig = z.infer<typeof upsertPluginConfigSchema>;
+/**
+ * Schema for partially updating a plugin's company-scoped configuration.
+ * Allows a partial merge of config values.
+ */
+export declare const patchPluginConfigSchema: z.ZodObject<{
+    companyId: z.ZodString;
+    configJson: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+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<{
+        disabled: "disabled";
+        error: "error";
+        installed: "installed";
+        ready: "ready";
+        uninstalled: "uninstalled";
+        upgrade_pending: "upgrade_pending";
+    }>;
+    lastError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+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>>;
+}, z.core.$strip>;
+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<{
+        agent: "agent";
+        company: "company";
+        goal: "goal";
+        instance: "instance";
+        issue: "issue";
+        project: "project";
+        project_workspace: "project_workspace";
+        run: "run";
+    }>;
+    scopeId: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    stateKey: z.ZodString;
+}, z.core.$strip>;
+export type PluginStateScopeKey = z.infer<typeof pluginStateScopeKeySchema>;
+/**
+ * Schema for setting a plugin state value.
+ */
+export declare const setPluginStateSchema: z.ZodObject<{
+    scopeKind: z.ZodEnum<{
+        agent: "agent";
+        company: "company";
+        goal: "goal";
+        instance: "instance";
+        issue: "issue";
+        project: "project";
+        project_workspace: "project_workspace";
+        run: "run";
+    }>;
+    scopeId: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    stateKey: z.ZodString;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+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<{
+        agent: "agent";
+        company: "company";
+        goal: "goal";
+        instance: "instance";
+        issue: "issue";
+        project: "project";
+        project_workspace: "project_workspace";
+        run: "run";
+    }>>;
+    scopeId: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ListPluginState = z.infer<typeof listPluginStateSchema>;
+//# sourceMappingURL=plugin.d.ts.map