@cjhyy/code-shell-core 0.7.1 → 0.8.0

package/dist/plugins/installer/types.d.ts

@@ -1,4 +1,378 @@
 import { z } from "zod";
+export declare const PluginAutomationTemplate: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodObject<{
+        default: z.ZodString;
+        en: z.ZodOptional<z.ZodString>;
+        "zh-CN": z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    }, {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    schedule: z.ZodString;
+    prompt: z.ZodString;
+    timezone: z.ZodOptional<z.ZodString>;
+    permissionLevel: z.ZodDefault<z.ZodEnum<["read-only", "workspace-write", "full"]>>;
+    workspace: z.ZodDefault<z.ZodEnum<["current", "none"]>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    prompt: string;
+    workspace: "none" | "current";
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    permissionLevel: "full" | "read-only" | "workspace-write";
+    schedule: string;
+    description?: string | undefined;
+    timezone?: string | undefined;
+}, {
+    id: string;
+    prompt: string;
+    title: {
+        default: string;
+        en?: string | undefined;
+        "zh-CN"?: string | undefined;
+    };
+    schedule: string;
+    description?: string | undefined;
+    workspace?: "none" | "current" | undefined;
+    timezone?: string | undefined;
+    permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+}>;
+export declare const PluginAutomationsManifest: z.ZodEffects<z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    templates: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodObject<{
+            default: z.ZodString;
+            en: z.ZodOptional<z.ZodString>;
+            "zh-CN": z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            default: string;
+            en?: string | undefined;
+            "zh-CN"?: string | undefined;
+        }, {
+            default: string;
+            en?: string | undefined;
+            "zh-CN"?: string | undefined;
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        schedule: z.ZodString;
+        prompt: z.ZodString;
+        timezone: z.ZodOptional<z.ZodString>;
+        permissionLevel: z.ZodDefault<z.ZodEnum<["read-only", "workspace-write", "full"]>>;
+        workspace: z.ZodDefault<z.ZodEnum<["current", "none"]>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        prompt: string;
+        workspace: "none" | "current";
+        title: {
+            default: string;
+            en?: string | undefined;
+            "zh-CN"?: string | undefined;
+        };
+        permissionLevel: "full" | "read-only" | "workspace-write";
+        schedule: string;
+        description?: string | undefined;
+        timezone?: string | undefined;
+    }, {
+        id: string;
+        prompt: string;
+        title: {
+            default: string;
+            en?: string | undefined;
+            "zh-CN"?: string | undefined;
+        };
+        schedule: string;
+        description?: string | undefined;
+        workspace?: "none" | "current" | undefined;
+        timezone?: string | undefined;
+        permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    templates: {
+        id: string;
+        prompt: string;
+        workspace: "none" | "current";
+        title: {
+            default: string;
+            en?: string | undefined;
+            "zh-CN"?: string | undefined;
+        };
+        permissionLevel: "full" | "read-only" | "workspace-write";
+        schedule: string;
+        description?: string | undefined;
+        timezone?: string | undefined;
+    }[];
+}, {
+    version: 1;
+    templates: {
+        id: string;
+        prompt: string;
+        title: {
+            default: string;
+            en?: string | undefined;
+            "zh-CN"?: string | undefined;
+        };
+        schedule: string;
+        description?: string | undefined;
+        workspace?: "none" | "current" | undefined;
+        timezone?: string | undefined;
+        permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+    }[];
+}>, {
+    version: 1;
+    templates: {
+        id: string;
+        prompt: string;
+        workspace: "none" | "current";
+        title: {
+            default: string;
+            en?: string | undefined;
+            "zh-CN"?: string | undefined;
+        };
+        permissionLevel: "full" | "read-only" | "workspace-write";
+        schedule: string;
+        description?: string | undefined;
+        timezone?: string | undefined;
+    }[];
+}, {
+    version: 1;
+    templates: {
+        id: string;
+        prompt: string;
+        title: {
+            default: string;
+            en?: string | undefined;
+            "zh-CN"?: string | undefined;
+        };
+        schedule: string;
+        description?: string | undefined;
+        workspace?: "none" | "current" | undefined;
+        timezone?: string | undefined;
+        permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+    }[];
+}>;
+export type PluginAutomationTemplate = z.infer<typeof PluginAutomationTemplate>;
+export type PluginAutomationsManifest = z.infer<typeof PluginAutomationsManifest>;
+export declare const PluginInterfaceMetadata: z.ZodObject<{
+    displayName: z.ZodOptional<z.ZodString>;
+    shortDescription: z.ZodOptional<z.ZodString>;
+    longDescription: z.ZodOptional<z.ZodString>;
+    developerName: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    brandColor: z.ZodOptional<z.ZodString>;
+    composerIcon: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodString>;
+    logoDark: z.ZodOptional<z.ZodString>;
+    screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    displayName?: string | undefined;
+    capabilities?: string[] | undefined;
+    category?: string | undefined;
+    shortDescription?: string | undefined;
+    longDescription?: string | undefined;
+    developerName?: string | undefined;
+    websiteURL?: string | undefined;
+    privacyPolicyURL?: string | undefined;
+    termsOfServiceURL?: string | undefined;
+    defaultPrompt?: string[] | undefined;
+    brandColor?: string | undefined;
+    composerIcon?: string | undefined;
+    logo?: string | undefined;
+    logoDark?: string | undefined;
+    screenshots?: string[] | undefined;
+}, {
+    displayName?: string | undefined;
+    capabilities?: string[] | undefined;
+    category?: string | undefined;
+    shortDescription?: string | undefined;
+    longDescription?: string | undefined;
+    developerName?: string | undefined;
+    websiteURL?: string | undefined;
+    privacyPolicyURL?: string | undefined;
+    termsOfServiceURL?: string | undefined;
+    defaultPrompt?: string[] | undefined;
+    brandColor?: string | undefined;
+    composerIcon?: string | undefined;
+    logo?: string | undefined;
+    logoDark?: string | undefined;
+    screenshots?: string[] | undefined;
+}>;
+export type PluginInterfaceMetadata = z.infer<typeof PluginInterfaceMetadata>;
+/** CodeShell-only manifest overlay kept outside `.codex-plugin/plugin.json`. */
+export declare const CodeShellPluginOverlay: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    automations: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        templates: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodObject<{
+                default: z.ZodString;
+                en: z.ZodOptional<z.ZodString>;
+                "zh-CN": z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            }, {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            schedule: z.ZodString;
+            prompt: z.ZodString;
+            timezone: z.ZodOptional<z.ZodString>;
+            permissionLevel: z.ZodDefault<z.ZodEnum<["read-only", "workspace-write", "full"]>>;
+            workspace: z.ZodDefault<z.ZodEnum<["current", "none"]>>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            prompt: string;
+            workspace: "none" | "current";
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            permissionLevel: "full" | "read-only" | "workspace-write";
+            schedule: string;
+            description?: string | undefined;
+            timezone?: string | undefined;
+        }, {
+            id: string;
+            prompt: string;
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            schedule: string;
+            description?: string | undefined;
+            workspace?: "none" | "current" | undefined;
+            timezone?: string | undefined;
+            permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            workspace: "none" | "current";
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            permissionLevel: "full" | "read-only" | "workspace-write";
+            schedule: string;
+            description?: string | undefined;
+            timezone?: string | undefined;
+        }[];
+    }, {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            schedule: string;
+            description?: string | undefined;
+            workspace?: "none" | "current" | undefined;
+            timezone?: string | undefined;
+            permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+        }[];
+    }>, {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            workspace: "none" | "current";
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            permissionLevel: "full" | "read-only" | "workspace-write";
+            schedule: string;
+            description?: string | undefined;
+            timezone?: string | undefined;
+        }[];
+    }, {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            schedule: string;
+            description?: string | undefined;
+            workspace?: "none" | "current" | undefined;
+            timezone?: string | undefined;
+            permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+        }[];
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: 1;
+    automations?: {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            workspace: "none" | "current";
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            permissionLevel: "full" | "read-only" | "workspace-write";
+            schedule: string;
+            description?: string | undefined;
+            timezone?: string | undefined;
+        }[];
+    } | undefined;
+}, {
+    schemaVersion: 1;
+    automations?: {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            schedule: string;
+            description?: string | undefined;
+            workspace?: "none" | "current" | undefined;
+            timezone?: string | undefined;
+            permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+        }[];
+    } | undefined;
+}>;
+export type CodeShellPluginOverlay = z.infer<typeof CodeShellPluginOverlay>;
+export declare const CODESHELL_PLUGIN_OVERLAY_FILE = ".codeshell-plugin/plugin.json";
 /** Codex `.codex-plugin/plugin.json`. v1 reads required fields; unknowns pass through. */
 export declare const CodexPluginManifest: z.ZodObject<{
     name: z.ZodString;
@@ -7,6 +381,56 @@ export declare const CodexPluginManifest: z.ZodObject<{
     mcpServers: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
     skills: z.ZodOptional<z.ZodString>;
     agents: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>, "many">]>>;
+    interface: z.ZodOptional<z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     name: z.ZodString;
     version: z.ZodString;
@@ -14,6 +438,56 @@ export declare const CodexPluginManifest: z.ZodObject<{
     mcpServers: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
     skills: z.ZodOptional<z.ZodString>;
     agents: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>, "many">]>>;
+    interface: z.ZodOptional<z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     name: z.ZodString;
     version: z.ZodString;
@@ -21,8 +495,309 @@ export declare const CodexPluginManifest: z.ZodObject<{
     mcpServers: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
     skills: z.ZodOptional<z.ZodString>;
     agents: z.ZodOptional<z.ZodString>;
+    hooks: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>, "many">]>>;
+    interface: z.ZodOptional<z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>>;
 }, z.ZodTypeAny, "passthrough">>;
 export type CodexPluginManifest = z.infer<typeof CodexPluginManifest>;
+/** Trusted, normalized manifest written into an installed plugin directory. */
+export declare const CanonicalPluginManifest: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    interface: z.ZodOptional<z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodString>;
+        shortDescription: z.ZodOptional<z.ZodString>;
+        longDescription: z.ZodOptional<z.ZodString>;
+        developerName: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        websiteURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        privacyPolicyURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        termsOfServiceURL: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        defaultPrompt: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        brandColor: z.ZodOptional<z.ZodString>;
+        composerIcon: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        logoDark: z.ZodOptional<z.ZodString>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        displayName?: string | undefined;
+        capabilities?: string[] | undefined;
+        category?: string | undefined;
+        shortDescription?: string | undefined;
+        longDescription?: string | undefined;
+        developerName?: string | undefined;
+        websiteURL?: string | undefined;
+        privacyPolicyURL?: string | undefined;
+        termsOfServiceURL?: string | undefined;
+        defaultPrompt?: string[] | undefined;
+        brandColor?: string | undefined;
+        composerIcon?: string | undefined;
+        logo?: string | undefined;
+        logoDark?: string | undefined;
+        screenshots?: string[] | undefined;
+    }, {
+        displayName?: string | undefined;
+        capabilities?: string[] | undefined;
+        category?: string | undefined;
+        shortDescription?: string | undefined;
+        longDescription?: string | undefined;
+        developerName?: string | undefined;
+        websiteURL?: string | undefined;
+        privacyPolicyURL?: string | undefined;
+        termsOfServiceURL?: string | undefined;
+        defaultPrompt?: string[] | undefined;
+        brandColor?: string | undefined;
+        composerIcon?: string | undefined;
+        logo?: string | undefined;
+        logoDark?: string | undefined;
+        screenshots?: string[] | undefined;
+    }>>;
+    automations: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        templates: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodObject<{
+                default: z.ZodString;
+                en: z.ZodOptional<z.ZodString>;
+                "zh-CN": z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            }, {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            schedule: z.ZodString;
+            prompt: z.ZodString;
+            timezone: z.ZodOptional<z.ZodString>;
+            permissionLevel: z.ZodDefault<z.ZodEnum<["read-only", "workspace-write", "full"]>>;
+            workspace: z.ZodDefault<z.ZodEnum<["current", "none"]>>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            prompt: string;
+            workspace: "none" | "current";
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            permissionLevel: "full" | "read-only" | "workspace-write";
+            schedule: string;
+            description?: string | undefined;
+            timezone?: string | undefined;
+        }, {
+            id: string;
+            prompt: string;
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            schedule: string;
+            description?: string | undefined;
+            workspace?: "none" | "current" | undefined;
+            timezone?: string | undefined;
+            permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            workspace: "none" | "current";
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            permissionLevel: "full" | "read-only" | "workspace-write";
+            schedule: string;
+            description?: string | undefined;
+            timezone?: string | undefined;
+        }[];
+    }, {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            schedule: string;
+            description?: string | undefined;
+            workspace?: "none" | "current" | undefined;
+            timezone?: string | undefined;
+            permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+        }[];
+    }>, {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            workspace: "none" | "current";
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            permissionLevel: "full" | "read-only" | "workspace-write";
+            schedule: string;
+            description?: string | undefined;
+            timezone?: string | undefined;
+        }[];
+    }, {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            schedule: string;
+            description?: string | undefined;
+            workspace?: "none" | "current" | undefined;
+            timezone?: string | undefined;
+            permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+        }[];
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    schemaVersion: 1;
+    version?: string | undefined;
+    description?: string | undefined;
+    interface?: {
+        displayName?: string | undefined;
+        capabilities?: string[] | undefined;
+        category?: string | undefined;
+        shortDescription?: string | undefined;
+        longDescription?: string | undefined;
+        developerName?: string | undefined;
+        websiteURL?: string | undefined;
+        privacyPolicyURL?: string | undefined;
+        termsOfServiceURL?: string | undefined;
+        defaultPrompt?: string[] | undefined;
+        brandColor?: string | undefined;
+        composerIcon?: string | undefined;
+        logo?: string | undefined;
+        logoDark?: string | undefined;
+        screenshots?: string[] | undefined;
+    } | undefined;
+    automations?: {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            workspace: "none" | "current";
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            permissionLevel: "full" | "read-only" | "workspace-write";
+            schedule: string;
+            description?: string | undefined;
+            timezone?: string | undefined;
+        }[];
+    } | undefined;
+}, {
+    name: string;
+    schemaVersion: 1;
+    version?: string | undefined;
+    description?: string | undefined;
+    interface?: {
+        displayName?: string | undefined;
+        capabilities?: string[] | undefined;
+        category?: string | undefined;
+        shortDescription?: string | undefined;
+        longDescription?: string | undefined;
+        developerName?: string | undefined;
+        websiteURL?: string | undefined;
+        privacyPolicyURL?: string | undefined;
+        termsOfServiceURL?: string | undefined;
+        defaultPrompt?: string[] | undefined;
+        brandColor?: string | undefined;
+        composerIcon?: string | undefined;
+        logo?: string | undefined;
+        logoDark?: string | undefined;
+        screenshots?: string[] | undefined;
+    } | undefined;
+    automations?: {
+        version: 1;
+        templates: {
+            id: string;
+            prompt: string;
+            title: {
+                default: string;
+                en?: string | undefined;
+                "zh-CN"?: string | undefined;
+            };
+            schedule: string;
+            description?: string | undefined;
+            workspace?: "none" | "current" | undefined;
+            timezone?: string | undefined;
+            permissionLevel?: "full" | "read-only" | "workspace-write" | undefined;
+        }[];
+    } | undefined;
+}>;
+export type CanonicalPluginManifest = z.infer<typeof CanonicalPluginManifest>;
+export declare const CANONICAL_PLUGIN_MANIFEST_FILE = ".cs-plugin-manifest.json";
 /** `.cs-meta.json` written into every installed plugin dir. */
 export declare const CSMeta: z.ZodObject<{
     name: z.ZodString;