@ikenga/contract 0.3.0 → 0.5.0

package/dist/manifest.d.ts

@@ -717,6 +717,118 @@ export declare const ManifestSchema: z.ZodObject<{
     }, {
         key_prefixes?: string[] | undefined;
     }>>;
+    /**
+     * Engine-adapter manifest block. Present iff this pkg is an engine-*
+     * adapter. Declares the agent id, display name, capability snapshot,
+     * and onboarding hints surfaced by the first-run wizard.
+     * See `@ikenga/contract/engine` for the source-of-truth schema.
+     */
+    engine: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodObject<{
+            streaming: z.ZodBoolean;
+            toolUse: z.ZodBoolean;
+            thinking: z.ZodBoolean;
+            artifacts: z.ZodBoolean;
+            fileAttachments: z.ZodBoolean;
+            imageInput: z.ZodBoolean;
+            slashCommands: z.ZodBoolean;
+            modelSwitching: z.ZodBoolean;
+            promptCaching: z.ZodBoolean;
+            agenticTools: z.ZodBoolean;
+            mcp: z.ZodBoolean;
+            sessionResume: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        }, {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        }>;
+        onboarding: z.ZodDefault<z.ZodObject<{
+            requiredVaultKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            requiredEnvVars: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            authCommand: z.ZodOptional<z.ZodString>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            requiredVaultKeys: string[];
+            requiredEnvVars: string[];
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        }, {
+            requiredVaultKeys?: string[] | undefined;
+            requiredEnvVars?: string[] | undefined;
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        capabilities: {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        };
+        agentId: string;
+        onboarding: {
+            requiredVaultKeys: string[];
+            requiredEnvVars: string[];
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        };
+        display?: string | undefined;
+    }, {
+        capabilities: {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        };
+        agentId: string;
+        display?: string | undefined;
+        onboarding?: {
+            requiredVaultKeys?: string[] | undefined;
+            requiredEnvVars?: string[] | undefined;
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        } | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     mcp: {
         args: string[];
@@ -812,6 +924,30 @@ export declare const ManifestSchema: z.ZodObject<{
         decorations?: boolean | undefined;
         menu?: string | undefined;
     } | undefined;
+    engine?: {
+        capabilities: {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        };
+        agentId: string;
+        onboarding: {
+            requiredVaultKeys: string[];
+            requiredEnvVars: string[];
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        };
+        display?: string | undefined;
+    } | undefined;
 }, {
     id: string;
     name: string;
@@ -907,8 +1043,701 @@ export declare const ManifestSchema: z.ZodObject<{
         decorations?: boolean | undefined;
         menu?: string | undefined;
     } | undefined;
+    engine?: {
+        capabilities: {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        };
+        agentId: string;
+        display?: string | undefined;
+        onboarding?: {
+            requiredVaultKeys?: string[] | undefined;
+            requiredEnvVars?: string[] | undefined;
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        } | undefined;
+    } | undefined;
 }>;
 export type Manifest = z.infer<typeof ManifestSchema>;
+/** Alias retained for symmetry with the Rust side / external consumers. */
+export declare const PkgManifestSchema: z.ZodObject<{
+    /** Reverse-DNS, e.g. `com.ikenga.studio`. */
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    /** Numeric string — host accepts versions in [MIN, CURRENT]. */
+    ikenga_api: z.ZodString;
+    /** Hint, not enforced: "skill" | "embedded" | "windowed" | "engine". */
+    kind: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        key: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        key?: string | undefined;
+    }, {
+        name: string;
+        key?: string | undefined;
+    }>>;
+    /** Rust target triples; empty = host-agnostic. */
+    targets: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    skills: z.ZodOptional<z.ZodString>;
+    commands: z.ZodOptional<z.ZodString>;
+    agents: z.ZodOptional<z.ZodString>;
+    mcp: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** "per-call" (default) | "long-lived" */
+        lifecycle: z.ZodOptional<z.ZodEnum<["per-call", "long-lived"]>>;
+    }, "strip", z.ZodTypeAny, {
+        args: string[];
+        name: string;
+        command: string;
+        env: Record<string, string>;
+        lifecycle?: "per-call" | "long-lived" | undefined;
+    }, {
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+        lifecycle?: "per-call" | "long-lived" | undefined;
+    }>, "many">>;
+    sidecars: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** Must start with `pa-<pkg-slug>-` (slug = id with `.` → `-`). */
+        name: z.ZodString;
+        /** Path inside pkg dir; may contain `{target}` (host triple). */
+        bin: z.ZodString;
+        /** "json" (default) | "raw" */
+        stdio: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        bin: string;
+        stdio: string;
+    }, {
+        name: string;
+        bin: string;
+        stdio?: string | undefined;
+    }>, "many">>;
+    permissions: z.ZodDefault<z.ZodObject<{
+        'shell.execute': z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        'fs.read': z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        'fs.write': z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        net: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        'supabase.tables': z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        'vault.keys': z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        'shell.execute': string[];
+        'fs.read': string[];
+        'fs.write': string[];
+        net: string[];
+        'supabase.tables': string[];
+        'vault.keys': string[];
+    }, {
+        'shell.execute'?: string[] | undefined;
+        'fs.read'?: string[] | undefined;
+        'fs.write'?: string[] | undefined;
+        net?: string[] | undefined;
+        'supabase.tables'?: string[] | undefined;
+        'vault.keys'?: string[] | undefined;
+    }>>;
+    migrations: z.ZodOptional<z.ZodString>;
+    settings: z.ZodOptional<z.ZodObject<{
+        schema: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            type: z.ZodEnum<["string", "number", "boolean", "secret"]>;
+            label: z.ZodString;
+            default: z.ZodOptional<z.ZodUnknown>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "string" | "number" | "boolean" | "secret";
+            label: string;
+            key: string;
+            description?: string | undefined;
+            default?: unknown;
+        }, {
+            type: "string" | "number" | "boolean" | "secret";
+            label: string;
+            key: string;
+            description?: string | undefined;
+            default?: unknown;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        schema: {
+            type: "string" | "number" | "boolean" | "secret";
+            label: string;
+            key: string;
+            description?: string | undefined;
+            default?: unknown;
+        }[];
+    }, {
+        schema?: {
+            type: "string" | "number" | "boolean" | "secret";
+            label: string;
+            key: string;
+            description?: string | undefined;
+            default?: unknown;
+        }[] | undefined;
+    }>>;
+    ui: z.ZodDefault<z.ZodObject<{
+        nav: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            section: z.ZodOptional<z.ZodString>;
+            route: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }, {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }>, "many">>;
+        routes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            /** "iframe" | "component" (component is builtin-only) */
+            kind: z.ZodEnum<["iframe", "component"]>;
+            /** iframe: URL or pkg-relative html path. component: identifier. */
+            source: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            kind: "iframe" | "component";
+            source: string;
+        }, {
+            path: string;
+            kind: "iframe" | "component";
+            source: string;
+        }>, "many">>;
+        command_palette: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            shortcut: z.ZodOptional<z.ZodString>;
+            action: z.ZodUnknown;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }, {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }>, "many">>;
+        side_pane_viewers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            route: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            route: string;
+        }, {
+            label: string;
+            id: string;
+            route: string;
+        }>, "many">>;
+        /** Per-directive CSP overrides for the iframe content. */
+        csp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        /** Per-directive Permission-Policy values. */
+        permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        nav: {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }[];
+        routes: {
+            path: string;
+            kind: "iframe" | "component";
+            source: string;
+        }[];
+        command_palette: {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }[];
+        side_pane_viewers: {
+            label: string;
+            id: string;
+            route: string;
+        }[];
+        csp?: Record<string, string[]> | undefined;
+        permissions?: Record<string, string[]> | undefined;
+    }, {
+        nav?: {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }[] | undefined;
+        routes?: {
+            path: string;
+            kind: "iframe" | "component";
+            source: string;
+        }[] | undefined;
+        command_palette?: {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }[] | undefined;
+        side_pane_viewers?: {
+            label: string;
+            id: string;
+            route: string;
+        }[] | undefined;
+        csp?: Record<string, string[]> | undefined;
+        permissions?: Record<string, string[]> | undefined;
+    }>>;
+    iyke: z.ZodOptional<z.ZodObject<{
+        routes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            method: z.ZodEnum<["GET", "POST"]>;
+            /** Must start with `/pkg/<id>/`. */
+            path: z.ZodString;
+            /** `sidecar:<name> <sub>` | `event:<name>` */
+            handler: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            method: "GET" | "POST";
+            handler: string;
+        }, {
+            path: string;
+            method: "GET" | "POST";
+            handler: string;
+        }>, "many">>;
+        events: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        routes: {
+            path: string;
+            method: "GET" | "POST";
+            handler: string;
+        }[];
+        events: string[];
+    }, {
+        routes?: {
+            path: string;
+            method: "GET" | "POST";
+            handler: string;
+        }[] | undefined;
+        events?: string[] | undefined;
+    }>>;
+    cron: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        /** 6-field cron expression: sec min hour day month dow */
+        expr: z.ZodString;
+        handler: z.ZodString;
+        env_from_settings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        handler: string;
+        expr: string;
+        env_from_settings: string[];
+    }, {
+        id: string;
+        handler: string;
+        expr: string;
+        env_from_settings?: string[] | undefined;
+    }>, "many">>;
+    window: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+        size: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        decorations: z.ZodOptional<z.ZodBoolean>;
+        menu: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        label: string;
+        size?: [number, number] | undefined;
+        decorations?: boolean | undefined;
+        menu?: string | undefined;
+    }, {
+        url: string;
+        label: string;
+        size?: [number, number] | undefined;
+        decorations?: boolean | undefined;
+        menu?: string | undefined;
+    }>>;
+    queries: z.ZodOptional<z.ZodObject<{
+        key_prefixes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        key_prefixes: string[];
+    }, {
+        key_prefixes?: string[] | undefined;
+    }>>;
+    /**
+     * Engine-adapter manifest block. Present iff this pkg is an engine-*
+     * adapter. Declares the agent id, display name, capability snapshot,
+     * and onboarding hints surfaced by the first-run wizard.
+     * See `@ikenga/contract/engine` for the source-of-truth schema.
+     */
+    engine: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodString;
+        display: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodObject<{
+            streaming: z.ZodBoolean;
+            toolUse: z.ZodBoolean;
+            thinking: z.ZodBoolean;
+            artifacts: z.ZodBoolean;
+            fileAttachments: z.ZodBoolean;
+            imageInput: z.ZodBoolean;
+            slashCommands: z.ZodBoolean;
+            modelSwitching: z.ZodBoolean;
+            promptCaching: z.ZodBoolean;
+            agenticTools: z.ZodBoolean;
+            mcp: z.ZodBoolean;
+            sessionResume: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        }, {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        }>;
+        onboarding: z.ZodDefault<z.ZodObject<{
+            requiredVaultKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            requiredEnvVars: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            authCommand: z.ZodOptional<z.ZodString>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            requiredVaultKeys: string[];
+            requiredEnvVars: string[];
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        }, {
+            requiredVaultKeys?: string[] | undefined;
+            requiredEnvVars?: string[] | undefined;
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        capabilities: {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        };
+        agentId: string;
+        onboarding: {
+            requiredVaultKeys: string[];
+            requiredEnvVars: string[];
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        };
+        display?: string | undefined;
+    }, {
+        capabilities: {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        };
+        agentId: string;
+        display?: string | undefined;
+        onboarding?: {
+            requiredVaultKeys?: string[] | undefined;
+            requiredEnvVars?: string[] | undefined;
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    mcp: {
+        args: string[];
+        name: string;
+        command: string;
+        env: Record<string, string>;
+        lifecycle?: "per-call" | "long-lived" | undefined;
+    }[];
+    id: string;
+    name: string;
+    version: string;
+    permissions: {
+        'shell.execute': string[];
+        'fs.read': string[];
+        'fs.write': string[];
+        net: string[];
+        'supabase.tables': string[];
+        'vault.keys': string[];
+    };
+    ikenga_api: string;
+    targets: string[];
+    sidecars: {
+        name: string;
+        bin: string;
+        stdio: string;
+    }[];
+    ui: {
+        nav: {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }[];
+        routes: {
+            path: string;
+            kind: "iframe" | "component";
+            source: string;
+        }[];
+        command_palette: {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }[];
+        side_pane_viewers: {
+            label: string;
+            id: string;
+            route: string;
+        }[];
+        csp?: Record<string, string[]> | undefined;
+        permissions?: Record<string, string[]> | undefined;
+    };
+    cron: {
+        id: string;
+        handler: string;
+        expr: string;
+        env_from_settings: string[];
+    }[];
+    queries?: {
+        key_prefixes: string[];
+    } | undefined;
+    author?: {
+        name: string;
+        key?: string | undefined;
+    } | undefined;
+    kind?: string | undefined;
+    skills?: string | undefined;
+    commands?: string | undefined;
+    agents?: string | undefined;
+    migrations?: string | undefined;
+    settings?: {
+        schema: {
+            type: "string" | "number" | "boolean" | "secret";
+            label: string;
+            key: string;
+            description?: string | undefined;
+            default?: unknown;
+        }[];
+    } | undefined;
+    iyke?: {
+        routes: {
+            path: string;
+            method: "GET" | "POST";
+            handler: string;
+        }[];
+        events: string[];
+    } | undefined;
+    window?: {
+        url: string;
+        label: string;
+        size?: [number, number] | undefined;
+        decorations?: boolean | undefined;
+        menu?: string | undefined;
+    } | undefined;
+    engine?: {
+        capabilities: {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        };
+        agentId: string;
+        onboarding: {
+            requiredVaultKeys: string[];
+            requiredEnvVars: string[];
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        };
+        display?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    name: string;
+    version: string;
+    ikenga_api: string;
+    mcp?: {
+        name: string;
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+        lifecycle?: "per-call" | "long-lived" | undefined;
+    }[] | undefined;
+    queries?: {
+        key_prefixes?: string[] | undefined;
+    } | undefined;
+    author?: {
+        name: string;
+        key?: string | undefined;
+    } | undefined;
+    kind?: string | undefined;
+    permissions?: {
+        'shell.execute'?: string[] | undefined;
+        'fs.read'?: string[] | undefined;
+        'fs.write'?: string[] | undefined;
+        net?: string[] | undefined;
+        'supabase.tables'?: string[] | undefined;
+        'vault.keys'?: string[] | undefined;
+    } | undefined;
+    targets?: string[] | undefined;
+    skills?: string | undefined;
+    commands?: string | undefined;
+    agents?: string | undefined;
+    sidecars?: {
+        name: string;
+        bin: string;
+        stdio?: string | undefined;
+    }[] | undefined;
+    migrations?: string | undefined;
+    settings?: {
+        schema?: {
+            type: "string" | "number" | "boolean" | "secret";
+            label: string;
+            key: string;
+            description?: string | undefined;
+            default?: unknown;
+        }[] | undefined;
+    } | undefined;
+    ui?: {
+        nav?: {
+            label: string;
+            id: string;
+            route: string;
+            section?: string | undefined;
+            icon?: string | undefined;
+        }[] | undefined;
+        routes?: {
+            path: string;
+            kind: "iframe" | "component";
+            source: string;
+        }[] | undefined;
+        command_palette?: {
+            label: string;
+            id: string;
+            shortcut?: string | undefined;
+            action?: unknown;
+        }[] | undefined;
+        side_pane_viewers?: {
+            label: string;
+            id: string;
+            route: string;
+        }[] | undefined;
+        csp?: Record<string, string[]> | undefined;
+        permissions?: Record<string, string[]> | undefined;
+    } | undefined;
+    iyke?: {
+        routes?: {
+            path: string;
+            method: "GET" | "POST";
+            handler: string;
+        }[] | undefined;
+        events?: string[] | undefined;
+    } | undefined;
+    cron?: {
+        id: string;
+        handler: string;
+        expr: string;
+        env_from_settings?: string[] | undefined;
+    }[] | undefined;
+    window?: {
+        url: string;
+        label: string;
+        size?: [number, number] | undefined;
+        decorations?: boolean | undefined;
+        menu?: string | undefined;
+    } | undefined;
+    engine?: {
+        capabilities: {
+            mcp: boolean;
+            streaming: boolean;
+            toolUse: boolean;
+            thinking: boolean;
+            artifacts: boolean;
+            fileAttachments: boolean;
+            imageInput: boolean;
+            slashCommands: boolean;
+            modelSwitching: boolean;
+            promptCaching: boolean;
+            agenticTools: boolean;
+            sessionResume: boolean;
+        };
+        agentId: string;
+        display?: string | undefined;
+        onboarding?: {
+            requiredVaultKeys?: string[] | undefined;
+            requiredEnvVars?: string[] | undefined;
+            authCommand?: string | undefined;
+            docsUrl?: string | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+export type PkgManifest = Manifest;
 /** Convert a reverse-DNS id to a slug: `com.ikenga.studio` → `com-ikenga-studio`. */
 export declare function pkgSlug(id: string): string;
 /** Sidecar names must start with `pa-<pkg-slug>-`. */